LearnNewsExamplesServices
Frontmatter
id9879
titleDocs: Modernize CodebaseOverview scale metrics and AI infrastructure mappings
stateClosed
labels
documentationepicai
assigneestobiu
createdAtApr 11, 2026, 10:42 AM
updatedAtApr 12, 2026, 7:00 PM
githubUrlhttps://github.com/neomjs/neo/issues/9879
authortobiu
commentsCount0
parentIssuenull
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtApr 11, 2026, 10:57 AM

Docs: Modernize CodebaseOverview scale metrics and AI infrastructure mappings

Closed v13.0.0/archive-v13-0-0-chunk-3 documentationepicai
tobiu
tobiu commented on Apr 11, 2026, 10:42 AM

Architecture Documentation Sync

The Context

The CodebaseOverview.md is our primary architectural map, but it currently suffers from two major synchronization gaps:

  1. Outdated Scale Metrics: The total sloc metrics have not been updated since January 2026. The true scale has massively expanded.
  2. 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

  • Recalculate and update the statistical index to the State of April 2026 using cloc, reflecting roughly ~531,000 lines of knowledge.
  • Insert Agent OS Backend (/ai) namespace into the map.
  • Insert Swarm Skills & Workflows (/.agent/skills/) namespace into the map.
  • Separate and index Neo Theming Engine (/resources/scss/) and Neo Docs Parser (/docs/app/).
  • Establish Agent Knowledge Base (/resources/content/) as the reactive live context endpoint.
  • Extend Query Entry points to prompt for "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.

tobiu added the documentation label on Apr 11, 2026, 10:42 AM
tobiu added the epic label on Apr 11, 2026, 10:42 AM
tobiu added the ai label on Apr 11, 2026, 10:42 AM
tobiu referenced in commit 64a1217 - "docs: Modernize CodebaseOverview scale metrics and AI infrastructure mappings (#9879)" on Apr 11, 2026, 10:43 AM
tobiu cross-referenced by PR #9880 on Apr 11, 2026, 10:43 AM
tobiu referenced in commit 9590f0e - "docs: Refine scale metrics using accurate cloc logic excluding datasets (#9879)" on Apr 11, 2026, 10:51 AM
tobiu referenced in commit 1bbb3bb - "docs: Detail disjoint boundary between Agent OS and Frontend Engine (#9879)" on Apr 11, 2026, 10:55 AM
tobiu closed this issue on Apr 11, 2026, 10:57 AM
tobiu referenced in commit e7d943d - "Docs: Modernize CodebaseOverview scale metrics and AI infrastructure mappings (#9879) (#9880) on Apr 11, 2026, 10:57 AM
tobiu assigned to @tobiu on Apr 12, 2026, 7:00 PM