LearnNewsExamplesServices
Frontmatter
id9993
titleAI Target: Deprecate Legacy DOC_GAP Inference in DreamService
stateClosed
labels
bugai
assigneestobiu
createdAtApr 14, 2026, 10:19 AM
updatedAtApr 14, 2026, 12:34 PM
githubUrlhttps://github.com/neomjs/neo/issues/9993
authortobiu
commentsCount0
parentIssuenull
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtApr 14, 2026, 12:22 PM

AI Target: Deprecate Legacy DOC_GAP Inference in DreamService

Closedbugai
tobiu
tobiu commented on Apr 14, 2026, 10:19 AM

Architectural Paradox

The DreamService REM pipeline historically used jsdocx output (structure.json / all.json) to score [DOC_GAP] penalties against Graph Nodes.

However, we identified a critical structural flaw during the evaluation of Swarm Intelligence heuristics:

  • jsdocx is fundamentally a human-centric format that inherently omits undocumented codebase entities. Consequently, attempting to map missing entities by joining against it creates a paradox (verifying an Abstract Syntax entity against a manifest that dropped it).
  • Negative ROI: Agentic SLMs and LLMs natively parse source code AST. Training the Swarm to focus processing power on closing JSDoc syntax gaps generates unhelpful noise that obscures high-value test ([TEST_GAP]) and systemic component ([TOPOLOGY_GAP]) priorities.

Resolution

Instead of patching the deterministic verification loop on a flawed documentation JSON file, we have evaluated and executed a hard pivot:

  1. Deprecated Logic: Eradicated the legacy [DOC_GAP] routine from DreamService.mjs and related capability inference.
  2. Shifted Weighting: Re-centered the processing capacity strictly toward code maturity ([TEST_GAP]) and strategic architectural context ([GUIDE_GAP]).
  3. Paving the Way: This resolves the operational noise blocking the future [TOPOLOGY_GAP] Swarm architectural mapping.

Handoff Context

Pull Request #9996 handles the removal and unit test rectifications.

tobiu added the bug label on Apr 14, 2026, 10:19 AM
tobiu added the ai label on Apr 14, 2026, 10:19 AM
tobiu assigned to @tobiu on Apr 14, 2026, 11:32 AM
tobiu referenced in commit 30402c3 - "fix(ai): remove low-ROI DOC_GAP detection from DreamService (#9993)" on Apr 14, 2026, 12:01 PM
tobiu cross-referenced by PR #9996 on Apr 14, 2026, 12:01 PM
tobiu changed title from Refactor Doc Gap Detection to Properly Parse JSDoc Content to AI Target: Deprecate Legacy DOC_GAP Inference in DreamService on Apr 14, 2026, 12:03 PM
tobiu referenced in commit 2948ed0 - "fix(ai): remove low-ROI DOC_GAP detection from DreamService (#9993)" on Apr 14, 2026, 12:09 PM
tobiu referenced in commit b3ec954 - "fix(ai): remove low-ROI DOC_GAP detection from DreamService (#9993) (#9996) on Apr 14, 2026, 12:22 PM
tobiu closed this issue on Apr 14, 2026, 12:22 PM