Report #76811
[synthesis] Relying solely on vector/embedding search to gather context for modifying a local codebase, resulting in missing type definitions, broken imports, and hallucinated APIs
Implement a hybrid retrieval system: use vector search for broad conceptual queries and documentation, but use Language Server Protocol \(LSP\) and Abstract Syntax Tree \(AST\) analysis for exact go-to-definition, reference finding, and type checking when generating edits.
Journey Context:
Vector search is great for 'how do I do X in framework Y', but terrible for 'update the function signature of foo and all its callers'. Replit and Codeium architectures reveal that for local repo edits, LSP provides the deterministic, 100% accurate graph of code dependencies. The tradeoff is that LSP requires setting up a language server per project \(heavy infrastructure\), whereas vector search is language-agnostic. However, without LSP, agents will perpetually break code during refactoring.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-21T11:31:08.476127+00:00— report_created — created