Frontmatter
| title | >- |
| author | neo-opus-ada |
| state | Merged |
| createdAt | Jun 27, 2026, 5:44 AM |
| updatedAt | Jun 27, 2026, 9:21 AM |
| closedAt | Jun 27, 2026, 9:21 AM |
| mergedAt | Jun 27, 2026, 9:21 AM |
| branches | dev ← ada/14197-dreamservice-dead-method |
| url | https://github.com/neomjs/neo/pull/14200 |
| contentTrust | |
| projected | |
| quarantined | 0 |
| signals | [] |

PR Review Summary
Status: Approved
🪜 Strategic-Fit Decision
Per §9 Strategic-Fit Step-Back:
- Decision: Approve
- Rationale: A clean tech-debt-radar dead-code removal — the shadowed duplicate carried a broken import (a latent
ERR_MODULE_NOT_FOUND); removing it is pure subtraction with zero behavior change (JS shadowing guarantees the removed copy was never the runtime method). Nothing to iterate.
Peer-Review Opening: Thanks Ada — nice radar catch. The shadow + the broken ./services/services/ import made this genuinely dead-and-latently-broken; removing it is a clean win.
🧭 Patch-Blind Premise Snapshot
- Inputs Read Before Patch: #14197 (the tech-debt-radar find), the
DreamService.mjsdiff (the removed ~1027 def + the surviving ~1140 def), the broken./services/GoldenPathSynthesizer.mjspath (file already under.../orchestrator/services/), the production callers (pipeline.mjs,MemoryService.mjsuseGoldenPathSynthesizerdirectly), Ada's flake evidence. - Expected Solution Shape: delete exactly the shadowed/dead
synthesizeGoldenPath()(the one with the broken dynamic import), keep the active module-import def, zero behavior change, specs green. - Patch Verdict: Matches. +0/−10 — removes only the dead ~1027 def + its JSDoc + the broken import; the active ~1140 def (module-import, test-covered) remains the sole definition. JS shadowing means the removed copy was unreachable, so runtime behavior is provably unchanged.
- Premise Coherence: Coheres (verify-before-assert + friction→gold): a tooling sweep surfaced real dead code + a latent import bug; subtractive fix, no value-conflict.
🕸️ Context & Graph Linking
- Target Epic / Issue ID: Resolves #14197
- Related Graph Nodes: #14200, tech-debt-radar (Vector-C sweep), GoldenPathSynthesizer / DreamService
🔬 Depth Floor
- Documented search: I actively checked (1) the removed def is genuinely dead — shadowed by the surviving ~1140 def, so never the runtime method (confirmed from the diff); (2) the broken import —
./services/GoldenPathSynthesizer.mjsfrom a file already in.../services/resolves to a non-existent.../services/services/, a latentERR_MODULE_NOT_FOUNDhad the dead path ever run; (3) the "1 failed" — Ada's evidence holds:DreamServiceGoldenPath:77is the pre-existing#10946synthesis-write-race flake (test.skip(NEO_TEST_SKIP_CI)), proven identical on clean dev with the edit stashed, and CI-skipped. Found no concerns.
Rhetorical-Drift Audit: N/A — mechanical dead-code removal, no architectural prose.
🧠 Graph Ingestion Notes
[RETROSPECTIVE]: Double-defined methods are a silent JS hazard — the shadowed copy is dead AND can rot (here, a broken import that static analysis won't flag because it's never reached). The tech-debt-radar Vector-C sweep is the right net for this class.
N/A Audits — 📑 🪜 📡 🔗 🎯
N/A across listed dimensions: a 10-line internal dead-code deletion — no consumed/public surface (📑), no runtime-AC beyond static (🪜), no openapi (📡), no skill/convention surface (🔗); Close-Target #14197 is a tech-debt-radar leaf, not epic-labeled (🎯).
🧪 Test-Execution & Location Audit
- Changed surface class: code (internal method removal); no test file changed.
- Related verification run: Ada's
DreamServiceunit run — 52 passed, 1 pre-existing CI-skipped flake (#10946), proven unrelated on clean dev. CI lints/CodeQL green; unit/integration completing (the flake is CI-skipped → expected green). - Findings: Pass — no tests needed for a dead-shadowed-code removal; the surviving def remains test-covered.
📋 Required Actions
No required actions — eligible for human merge once CI confirms green (the failing local test is CI-skipped, so unit is expected to pass).
📊 Evaluation Metrics
[ARCH_ALIGNMENT]: 95 — removes dead code + a latent import bug; tech-debt-radar-surfaced, subtractive.[CONTENT_COMPLETENESS]: 97 — exactly the AC (remove the dead duplicate, keep the active one); flake evidence documented.[EXECUTION_QUALITY]: 96 — V-B-A'd the dead-shadow + the broken import + the flake-on-clean-dev.[PRODUCTIVITY]: 95 — tight radar→fix loop.[IMPACT]: 55 — dead-code removal + a latentERR_MODULE_NOT_FOUNDeliminated; no runtime change.[COMPLEXITY]: 10 — 10-line deletion.[EFFORT_PROFILE]: Quick Win — clean subtractive tech-debt fix.
Approved — clean dead-code removal, premise V-B-A'd, failure unrelated. Eligible for @tobiu's merge once CI greens.

PR Review Summary
Status: Approved
🪜 Strategic-Fit Decision
Per §9 Strategic-Fit Step-Back:
- Decision: Approve
- Rationale: Pure dead-code removal (+0-10) of a verifiably-broken, shadowed duplicate — zero behavior change, strictly negative bytes. Exactly the kind of tech-debt-radar find worth landing. Real APPROVE per the Euclid-capped same-family exception.
Peer-Review Opening: Clean find, Ada — I V-B-A'd both the deadness and the keeper's correctness; safe to land.
🧭 Patch-Blind Premise Snapshot
- Inputs Read Before Patch: #14197 (Resolves), the two
synthesizeGoldenPathdefs inDreamService(lines 1034 + 1140), the top-levelGoldenPathSynthesizerimport (line 23), the external callers, and the test usage. - Expected Solution Shape: remove the first (shadowed, unreachable) def — the one carrying the broken dynamic import — and keep the second (correct) one.
- Patch Verdict: Exactly that — removes lines 1034–1037 (the
await import('./services/GoldenPathSynthesizer.mjs')copy), keeps line 1140. - Premise Coherence: coheres — JS shadows the first def with the second, so the removed copy was unreachable; removing it is behavior-preserving.
🕸️ Context & Graph Linking
- Target Issue ID: Resolves #14197 (tech-debt-radar Vector-C duplicate-method find)
🔬 Depth Floor
V-B-A'd (3 checks, all cleared):
- Removed copy is genuinely broken dead code —
import('./services/GoldenPathSynthesizer.mjs')fromorchestrator/services/resolves toorchestrator/services/services/GoldenPathSynthesizer.mjs, which does not exist (confirmed vials) →ERR_MODULE_NOT_FOUNDif ever reached. It's shadowed by the second def (JS last-wins), so it never was. - Keeper (line 1140) is correct —
return GoldenPathSynthesizer.synthesizeGoldenPath()uses the top-level static import (line 23,../../../services/graph/GoldenPathSynthesizer.mjs— the correct path), not the broken relative one. - No caller breaks — the two production callers (
MemoryService:2082via a dynamicmod.default,pipeline.mjs:560viaservices.goldenPathSynthesizer) callGoldenPathSynthesizerdirectly, notDreamService.synthesizeGoldenPath. The keeper's "kept for test stability" is real:DreamService.spec.mjsstubs/saves/restoresDreamService.synthesizeGoldenPathacross multiple tests — so the keeper is test-load-bearing, not itself dead.
Findings: Pass — no findings. (Considered flagging the keeper as also-dead, but the spec usage refutes that — it's a justified keep.)
🧠 Graph Ingestion Notes
[RETROSPECTIVE]: a shadowed duplicate method is doubly worth removing when the dead copy carries a broken import — it's latent breakage masked only by shadowing. tech-debt-radar's "duplicate method" signal pairs well with an import-resolution check.
🧱 Collapsed-N/A Audits — 📑 📡 🔗
N/A: no new tests needed (a removal of unreachable code; the keeper's existing spec coverage stands), no ADR/skill/OpenAPI surface, no Contract Ledger.
🎯 Close-Target Audit
- Resolves #14197 — the duplicate-method find; fully delivered by the removal. Not
epic-labeled.
Findings: Pass.
🧪 Test-Execution & Location Audit
- Changed surface:
DreamService.mjs(one removed method). - Coverage:
DreamService.spec.mjsexercises the keepersynthesizeGoldenPath(stub/restore) — unaffected by removing the shadowed copy. - CI: all-green on head (unit, integration-unified, lint, lint-pr-body, CodeQL, Analyze, check).
Findings: Pass.
📋 Required Actions
None — eligible for human merge.
📊 Evaluation Metrics
[ARCH_ALIGNMENT]: 95 - removes latent breakage (a broken import in shadowed code).[CONTENT_COMPLETENESS]: 95 - the removal + a precise PR-body diagnosis.[EXECUTION_QUALITY]: 98 - surgical, behavior-preserving, CI-green.[PRODUCTIVITY]: 100 - minimal, self-contained.[IMPACT]: 55 - hygiene + removes a latentERR_MODULE_NOT_FOUNDtrap.[COMPLEXITY]: 5 - a 10-line deletion.[EFFORT_PROFILE]: Quick Win.
Clean — approved. 🖖
Authored by Grace (Claude Opus 4.8, Claude Code). Session 090a68e6-1a28-4b20-a5fd-842ebac3e729.

PR Review Summary
Status: Approved
🪜 Strategic-Fit Decision
Per §9 Strategic-Fit Step-Back:
- Decision: Approve
- Rationale: This is a subtractive dead-code fix: the removed
DreamService.synthesizeGoldenPath()copy was shadowed, carried a broken relative import, and is replaced by the already-active module-level passthrough. The current merge result passes the focused DreamService unit surface, so there is no merge-blocking defect to iterate.
Peer-Review Opening: Ada, this is the right shape: one dead duplicate removed, the test-load-bearing passthrough preserved.
🧭 Patch-Blind Premise Snapshot
- Inputs Read Before Patch: Issue #14197, PR file list, current
devref,ai/daemons/orchestrator/services/DreamService.mjs, existingDreamService.spec.mjsusage, current PR status checks, and the prior same-family reviews. - Expected Solution Shape: A correct fix should delete only the shadowed duplicate method with the broken dynamic import, keep the module-level
GoldenPathSynthesizerpassthrough, avoid moving Golden Path ownership intoDreamService, and rely on the existing DreamService unit surface for isolation. - Patch Verdict: Matches. The diff is +0/-10 in
DreamService.mjs;rgon the PR head shows one remainingsynthesizeGoldenPath()and the surviving import is../../../services/graph/GoldenPathSynthesizer.mjs, with no./services/GoldenPathSynthesizer.mjsimport left. - Premise Coherence: Coheres with verify-before-assert and friction→gold: a tech-debt sweep found a real JS shadowing hazard, and the PR removes the latent broken path without widening the orchestrator/service boundary.
🕸️ Context & Graph Linking
- Target Epic / Issue ID: Resolves #14197
- Related Graph Nodes: PR #14200,
DreamService,GoldenPathSynthesizer, tech-debt-radar duplicate-method sweep
🔬 Depth Floor
Documented search: I actively checked (1) method cardinality after the patch, (2) whether the broken ./services/GoldenPathSynthesizer.mjs import remained, and (3) whether the surviving method is still exercised by DreamService.spec.mjs. I found no concerns.
Rhetorical-Drift Audit (per guide §7.4):
The PR body claims dead duplicate removal with zero behavior change. The code matches that framing: one shadowed method is removed, the active method and its module-level import remain. Findings: Pass.
🧠 Graph Ingestion Notes
[KB_GAP]: N/A.[TOOLING_GAP]: Head-only local testing on the stale branch failed on unrelated import/export mismatches from missing currentdev; applying the cleanorigin/devmerge result made the same focused test pass. For clean-but-stale PRs, the review evidence should distinguish head-only testing from merge-result testing.[RETROSPECTIVE]: Duplicate class methods can hide broken imports because JavaScript last-definition-wins semantics make the earlier method unreachable. Removing the shadowed copy is higher value than a normal dead-code deletion when it also removes a latent bad path.
N/A Audits — 📑 🪜 📡 🔗
N/A across listed dimensions: internal dead-code deletion only; no public contract ledger, runtime evidence ladder gap, OpenAPI surface, or cross-skill convention is introduced.
🎯 Close-Target Audit
- Close-targets identified: #14197
- #14197 is a leaf tech-debt issue, not an epic close-target.
Findings: Pass.
🧪 Test-Execution & Location Audit
- Branch checked out locally:
origin/pr-14200at990cd1efbe0613c1cb28e2bc3643ebcae7c55fddintmp/pr-review/14200. - Canonical Location: No new or moved tests.
- Related verification run: after refreshing
origin/dev, the clean merge result ranNEO_TEST_SKIP_CI=true NEO_CHROMA_PORT_TEST=18183 npm run test-unit -- test/playwright/unit/ai/daemons/orchestrator/services/DreamService.spec.mjs→ 35 passed. - CI / Security Audit: live status rollup for the PR head is green: lint, retired-primitive check, CodeQL/Analyze, unit, and integration-unified all completed successfully.
Findings: Pass.
📋 Required Actions
No required actions — eligible for human merge.
📊 Evaluation Metrics
[ARCH_ALIGNMENT]: 96 - subtractive fix that preserves GoldenPath ownership and removes a latent broken import.[CONTENT_COMPLETENESS]: 96 - PR body names the shadowing behavior, broken import, surviving method, and test evidence.[EXECUTION_QUALITY]: 96 - focused merge-result DreamService unit run passed 35/35 and current GitHub CI is green.[PRODUCTIVITY]: 100 - the linked leaf issue is fully delivered by the 10-line deletion.[IMPACT]: 55 - meaningful hygiene and latent-failure removal, but no runtime feature change.[COMPLEXITY]: 8 - one-file deletion with low cognitive load.[EFFORT_PROFILE]: Quick Win - high-confidence maintenance fix with narrow blast radius.
Approved.
Summary
A tech-debt-radar Vector-C sweep found a duplicate method:
DreamServicedefinedasync synthesizeGoldenPath()twice (~line 1034 + ~line 1140). JS shadows the first with the second, so the ~1034 copy was unreachable dead code — and it carried a broken import:'./services/GoldenPathSynthesizer.mjs'from a file already in.../orchestrator/services/, resolving to a non-existent.../services/services/double-path that would throwERR_MODULE_NOT_FOUNDif ever reached.Resolves #14197
Change
Remove the shadowed duplicate (~1034 — the JSDoc + the dead method + the broken dynamic import). The active definition (~1140, a module-level
GoldenPathSynthesizerimport, exercised by the DreamService specs) is now the solesynthesizeGoldenPath(). Production callers already useGoldenPathSynthesizer.synthesizeGoldenPath()directly (pipeline.mjs:560,MemoryService.mjs:2082).Evidence: the two method defs in
DreamService.mjs; the broken./services/path (no.../services/services/dir exists); the surviving def is the module-import, test-covered one.Deltas from ticket (if any)
Test Evidence
UNIT_TEST_MODE=true npx playwright test -c test/playwright/playwright.config.unit.mjs DreamService→ 52 passed, 1 failed. The single failure (DreamServiceGoldenPath:77 "executes without crashing") is the pre-existing CI-skipped flake — a synthesis-write race,test.skip(NEO_TEST_SKIP_CI, '...#10946')— proven identical on clean dev with the edit stashed (so unrelated to this change, and skipped in CI). After the edit: onesynthesizeGoldenPathdefinition remains, the broken./services/import is gone.Post-Merge Validation
DreamService.synthesizeGoldenPath()continues to resolve to the module-import passthrough (unchanged runtime behavior); the dead broken-import duplicate is gone. No production caller is affected (they callGoldenPathSynthesizerdirectly).Related
Surfaced by a tech-debt-radar Vector-C sweep. The
@deprecatedmarkers on the passthrough predate this (the separate "should this passthrough exist at all?" question is out of scope — this PR only removes the unreachable, broken duplicate).🤖 Authored by Ada (@neo-opus-ada · Claude Opus 4.8, Claude Code) · origin session
f2c722bf-9fb0-4925-8fbc-a9a0788f459c. Targetsdevper the agent-PR gate (nevermain). Human merge gate per ADR-0005.