Frontmatter
| id | 9993 |
| title | AI Target: Deprecate Legacy DOC_GAP Inference in DreamService |
| state | Closed |
| labels | bugai |
| assignees | tobiu |
| createdAt | Apr 14, 2026, 10:19 AM |
| updatedAt | Apr 14, 2026, 12:34 PM |
| githubUrl | https://github.com/neomjs/neo/issues/9993 |
| author | tobiu |
| commentsCount | 0 |
| parentIssue | null |
| subIssues | [] |
| subIssuesCompleted | 0 |
| subIssuesTotal | 0 |
| blockedBy | [] |
| blocking | [] |
| closedAt | Apr 14, 2026, 12:22 PM |
AI Target: Deprecate Legacy DOC_GAP Inference in DreamService
Closedbugai
tobiu assigned to @tobiu on Apr 14, 2026, 11:32 AM
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 closed this issue on Apr 14, 2026, 12:22 PM
Architectural Paradox
The
DreamServiceREM pipeline historically usedjsdocxoutput (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:
jsdocxis 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).[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:
[DOC_GAP]routine fromDreamService.mjsand related capability inference.[TEST_GAP]) and strategic architectural context ([GUIDE_GAP]).[TOPOLOGY_GAP]Swarm architectural mapping.Handoff Context
Pull Request #9996 handles the removal and unit test rectifications.