Architecture Documentation Sync
The Context
The CodebaseOverview.md is our primary architectural map, but it currently suffers from two major synchronization gaps:
- Outdated Scale Metrics: The total sloc metrics have not been updated since January 2026. The true scale has massively expanded.
- Missing AI Infrastructure: The entire
ai/ SDK layer (~20k lines), .agent/skills/ topology, resources/content/ context logic, testing layers, and JSDoc parsers are not formally indexed in the "Knowledge Landscape".
The Objective
This Epic tracks the holistic integration of these missing namespaces into the codebase overview to ensure agents and human contributors have a structurally complete map.
Required Actions
Design Rationale
Piecemeal ticket updates to this core markdown document are inefficient and prone to producing conflicting contexts (Session Amnesia). By aggregating all missing topographical metrics into a single "Fat Ticket", we guarantee the Native Edge Graph ingests a complete, coherent upgrade delta representing the April 2026 scale.
Architecture Documentation Sync
The Context
The
CodebaseOverview.mdis our primary architectural map, but it currently suffers from two major synchronization gaps:ai/SDK layer (~20k lines),.agent/skills/topology,resources/content/context logic, testing layers, and JSDoc parsers are not formally indexed in the "Knowledge Landscape".The Objective
This Epic tracks the holistic integration of these missing namespaces into the codebase overview to ensure agents and human contributors have a structurally complete map.
Required Actions
cloc, reflecting roughly ~531,000 lines of knowledge.Agent OS Backend(/ai) namespace into the map.Swarm Skills & Workflows(/.agent/skills/) namespace into the map.Neo Theming Engine(/resources/scss/) andNeo Docs Parser(/docs/app/).Agent Knowledge Base(/resources/content/) as the reactive live context endpoint."Agent OS","DreamService", and"Whitebox E2E".Design Rationale
Piecemeal ticket updates to this core markdown document are inefficient and prone to producing conflicting contexts (Session Amnesia). By aggregating all missing topographical metrics into a single "Fat Ticket", we guarantee the Native Edge Graph ingests a complete, coherent upgrade delta representing the April 2026 scale.