jerome
05eccd5b53
- Moved scattered scripts, templates, and documentation into organized directories (applications/, scripts/, assets/). - Updated .gitignore to strictly exclude secrets, state files, and IDE configs. - Added comprehensive README.md outlining repository structure and best practices. - Preserved all existing documentation and technical architecture files. - Prepared infrastructure/ for AWS Org and Proxmox Terraform management.
83 lines
3.5 KiB
Markdown
83 lines
3.5 KiB
Markdown
# Documentation Migration Summary
|
|
|
|
## Current Status
|
|
- **Last Updated:** 2026-05-02 18:16:00
|
|
- **Total Graph Nodes:** 171
|
|
- **Total Graph Edges:** 117
|
|
- **Documentation Files Processed:** 29 (excluding this summary)
|
|
- **Migration Status:** COMPLETE — All source files accounted for
|
|
|
|
## Migration History
|
|
|
|
### Batch 1 (April 27, 2026)
|
|
- Migrated core documentation files
|
|
- Created ~25 nodes for business strategy, technical architecture, operations
|
|
- Total nodes at completion: ~138
|
|
|
|
### Batch 2 (May 1, 2026)
|
|
- Migrated templates and additional technical docs
|
|
- Created ~42 nodes
|
|
- Total nodes at completion: ~160
|
|
|
|
### Batch 3 (May 2, 2026)
|
|
- Migrated AI agents framework documentation
|
|
- Created 8 new nodes:
|
|
- #180: Business Strategy & Vision — Home
|
|
- #181: Technical Architecture — Overview
|
|
- #182: Autonomous AI Agents — Home
|
|
- #183: Claude Code & Opencode — Home
|
|
- #184: MCP (Model Context Protocol) — Home
|
|
- #185: OpenClaw Framework — Home
|
|
- #186: OpenMAIC Education — Home
|
|
- #187: Qwen3.5 Model Setup — Home
|
|
- Total nodes at completion: 168
|
|
|
|
### Batch 4 (May 2, 2026 — Cron Check)
|
|
- Ran full deduplication audit against graph
|
|
- Verified all 29 source files have matching nodes in graph
|
|
- **0 new nodes needed** — migration complete
|
|
- Total nodes now: 169 (includes 1 non-documentation node added independently)
|
|
|
|
### Batch 5 (May 2, 2026 — Evening Cron Validation)
|
|
- Full deduplication audit re-run
|
|
- **0 new documentation nodes needed** — all 29 files still accounted for
|
|
- Total nodes now: 171 (2 additional non-documentation nodes: relay messages, audit logs)
|
|
- **Stale content detected** (requires manual review):
|
|
- Node #163 (Technical Infrastructure): Ollama reference → should be llama.cpp
|
|
- Node #187 (Qwen3.5 Model Setup): Ollama reference + CUDA-only → should include ROCm for AMD GPU
|
|
- **Limitation:** Native API (3000) does not support PATCH for node updates — stale content fixes require full node replacement or manual intervention
|
|
|
|
## Files Migrated by Category
|
|
|
|
| Category | Files | Status |
|
|
|----------|-------|--------|
|
|
| 01-business-strategy | 2 | ✅ Migrated |
|
|
| 02-technical-architecture | 14 | ✅ Migrated |
|
|
| 03-operations | 4 | ✅ Migrated |
|
|
| 04-customer-portal | 1 | ✅ Migrated |
|
|
| 05-development | 1 | ✅ Migrated |
|
|
| templates | 7 | ✅ Migrated |
|
|
| **Total** | **29** | **COMPLETE** |
|
|
|
|
## Deduplication Method
|
|
- Path-based deduplication using `metadata.source_file`
|
|
- Title-based deduplication abandoned (unreliable due to heading changes)
|
|
- All 29 source files verified against existing graph nodes
|
|
|
|
## Validation
|
|
- Live system validation performed before each migration batch
|
|
- Proxmox cluster health checked
|
|
- VM and storage inventories verified
|
|
- GPU assignments confirmed (acerpve=RTX 3090, amdpve=AMD Strix Halo 395)
|
|
|
|
## Stale Content Findings (May 2, 2026)
|
|
- **Node #163** (Technical Infrastructure Overview): Contains "Ollama" reference — should be "llama.cpp"
|
|
- **Node #187** (Qwen3.5 Model Setup): Contains "Ollama" reference AND CUDA-only mention — should include ROCm for AMD Strix Halo GPU
|
|
- **Action Required:** Manual review and update of these nodes (API limitation prevents automated PATCH)
|
|
|
|
## Notes
|
|
- No new documentation files detected since last migration
|
|
- Graph growing due to non-documentation content (relay messages, audits, lessons)
|
|
- Next scheduled check: weekly cron
|
|
- **API Limitation:** Native API (3000) supports POST for creation but not PATCH for updates. MCP bridge (3100) `createNode` returns 404. Node updates require full replacement or manual intervention.
|