@jafreck/lore 0.3.6 → 0.3.8

package/dist/indexer/pipeline.d.ts

@@ -7,18 +7,19 @@
  * ## Stage ordering (data-dependency chain)
  *
  * ```
- * ScipSourceStage → SourceIndexStage → DocsIndexStage
+ * ScipIndexerStage → SourceIndexStage → DocsIndexStage
  *   → ImportResolutionStage → DependencyApiStage
  *   → LspEnrichmentStage → ResolutionStage
  *   → TestMapStage → HistoryStage → EmbeddingStage
  * ```
  *
- * `ScipSourceStage` runs first for SCIP-covered languages, populating
- * symbols AND refs directly with pre-resolved edges.  `SourceIndexStage`
- * then handles remaining languages via tree-sitter.
+ * `ScipIndexerStage` runs first for SCIP-covered languages, populating
+ * symbols AND refs directly with pre-resolved edges and enrichment
+ * metadata (type signatures, definition locations) in a single pass.
+ * `SourceIndexStage` then adds tree-sitter metrics (complexity, nesting)
+ * to SCIP-sourced files and handles remaining languages.
  *
- * LSP enrichment is optional for both paths (adds type signatures to
- * SCIP-sourced symbols, enriches non-SCIP refs with definition data).
+ * LSP enrichment is optional (enriches non-SCIP refs with definition data).
  *
  * The resolution stage only processes refs that are still `unresolved`
  * (i.e. non-SCIP languages without LSP enrichment).
@@ -67,8 +68,6 @@ export interface PipelineContext {
         depth?: number;
         all?: boolean;
     };
-    /** Whether to auto-seed documentation notes. */
-    docsAutoNotes: boolean;
     /**
      * Absolute paths of changed files supplied by the caller for incremental
      * updates.  Undefined in build mode.
@@ -91,21 +90,40 @@ export interface PipelineContext {
     changedDocPaths: string[];
     /**
      * Languages for which SCIP enrichment already provided data.
-     * Set by `ScipEnrichmentStage`; read by `LspEnrichmentStage` to skip
+     * Set by `ScipIndexerStage`; read by `LspEnrichmentStage` to skip
      * languages that don't need LSP fallback.
      */
     scipCoveredLanguages?: ReadonlySet<string>;
     /**
      * Languages fully sourced from SCIP (symbols + refs).
-     * Set by `ScipSourceStage`; read by `SourceIndexStage` to skip
+     * Set by `ScipIndexerStage`; read by `SourceIndexStage` to skip
      * tree-sitter extraction for these languages, and by `LspEnrichmentStage`.
      */
     scipSourcedLanguages?: ReadonlySet<string>;
     /**
      * Absolute file paths sourced from SCIP.
-     * Set by `ScipSourceStage`; read by `SourceIndexStage` to skip files.
+     * Set by `ScipIndexerStage`; read by `SourceIndexStage` to skip files.
      */
     scipSourcedFiles?: ReadonlySet<string>;
+    /**
+     * In-memory cache of source file contents (path → source text).
+     * Populated by SourceIndexStage / ScipIndexerStage during parsing.
+     * Later stages (LSP enrichment) read from here to
+     * avoid redundant `readFileSync` calls.
+     */
+    sourceCache: Map<string, string>;
+    /**
+     * The layer that stages should write to:
+     *  - `'baseline'` for full SCIP builds.
+     *  - `'overlay'` for tree-sitter + LSP incremental updates.
+     */
+    layer: 'baseline' | 'overlay';
+    /**
+     * Baseline generation counter produced by SCIP.
+     * Baseline rows are written with this value.
+     * Overlay rows always use `generation = 0`.
+     */
+    generation: number;
 }
 /**
  * A composable pipeline stage.
@@ -130,30 +148,35 @@ export interface PipelineStage {
     dispose?(): Promise<void>;
 }
 /**
- * Orchestrates a sequence of `PipelineStage` instances through a shared
+ * A pipeline entry is either a single stage or an array of stages to run
+ * concurrently.  Parallel stages must be independent (write to disjoint
+ * tables, read disjoint inputs).
+ */
+export type PipelineEntry = PipelineStage | PipelineStage[];
+/**
+ * Orchestrates a sequence of `PipelineEntry` instances through a shared
  * `PipelineContext`.
  *
- * Replaces the god-method `IndexBuilder.build()` with a declarative,
- * composable pipeline whose ordering is enforced structurally.
+ * Each entry is either a single stage or an array of stages that run
+ * concurrently.  Entries are executed in order; within a parallel group
+ * all stages start simultaneously and the group completes when all finish.
  *
  * @example
  * ```ts
  * const pipeline = new IndexPipeline([
- *   new SourceIndexStage(),
- *   new DocsIndexStage(),
+ *   new ScipIndexerStage(),
+ *   [new SourceIndexStage(), new DocsIndexStage()],  // run in parallel
  *   new ImportResolutionStage(),
- *   new LspEnrichmentStage(),
- *   new ResolutionStage(),
  *   new EmbeddingStage(),
  * ]);
  * await pipeline.run(context, 'build');
  * ```
  */
 export declare class IndexPipeline {
-    private readonly stages;
-    constructor(stages: PipelineStage[]);
+    private readonly entries;
+    constructor(entries: PipelineEntry[]);
     /**
-     * Execute all stages in order.  If any stage throws, the remaining stages
+     * Execute all entries in order.  If any stage throws, the remaining entries
      * are skipped but every stage's `dispose()` hook is still called.
      */
     run(context: PipelineContext, mode: 'build' | 'update'): Promise<void>;

package/dist/indexer/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/indexer/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK/C;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,YAAY,EAAE,YAAY,CAAC;IAC3B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,GAAG,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACjC,iDAAiD;IACjD,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACnC,mCAAmC;IACnC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,uBAAuB;IACvB,GAAG,EAAE,UAAU,CAAC;IAEhB;;;;;OAKG;IACH,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEjD,8DAA8D;IAC9D,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gCAAgC;IAChC,OAAO,EAAE,OAAO,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACrD,gDAAgD;IAChD,aAAa,EAAE,OAAO,CAAC;IAIvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB;;;OAGG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB;;;OAGG;IACH,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAE7B;;;OAGG;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;IAE1B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAE3C;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAE3C;;;OAGG;IACH,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACxC;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3E;;;OAGG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAID;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,MAAM,EAAE,aAAa,EAAE;IAInC;;;OAGG;IACG,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B5E,kFAAkF;IAClF,IAAI,UAAU,IAAI,MAAM,EAAE,CAEzB;CACF"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/indexer/pipeline.ts"],"names":[],"mappings":"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"}

package/dist/indexer/pipeline.js

@@ -7,18 +7,19 @@
  * ## Stage ordering (data-dependency chain)
  *
  * ```
- * ScipSourceStage → SourceIndexStage → DocsIndexStage
+ * ScipIndexerStage → SourceIndexStage → DocsIndexStage
  *   → ImportResolutionStage → DependencyApiStage
  *   → LspEnrichmentStage → ResolutionStage
  *   → TestMapStage → HistoryStage → EmbeddingStage
  * ```
  *
- * `ScipSourceStage` runs first for SCIP-covered languages, populating
- * symbols AND refs directly with pre-resolved edges.  `SourceIndexStage`
- * then handles remaining languages via tree-sitter.
+ * `ScipIndexerStage` runs first for SCIP-covered languages, populating
+ * symbols AND refs directly with pre-resolved edges and enrichment
+ * metadata (type signatures, definition locations) in a single pass.
+ * `SourceIndexStage` then adds tree-sitter metrics (complexity, nesting)
+ * to SCIP-sourced files and handles remaining languages.
  *
- * LSP enrichment is optional for both paths (adds type signatures to
- * SCIP-sourced symbols, enriches non-SCIP refs with definition data).
+ * LSP enrichment is optional (enriches non-SCIP refs with definition data).
  *
  * The resolution stage only processes refs that are still `unresolved`
  * (i.e. non-SCIP languages without LSP enrichment).
@@ -26,49 +27,69 @@
 import { getLogger } from '../logger.js';
 // ─── IndexPipeline ────────────────────────────────────────────────────────────
 /**
- * Orchestrates a sequence of `PipelineStage` instances through a shared
+ * Orchestrates a sequence of `PipelineEntry` instances through a shared
  * `PipelineContext`.
  *
- * Replaces the god-method `IndexBuilder.build()` with a declarative,
- * composable pipeline whose ordering is enforced structurally.
+ * Each entry is either a single stage or an array of stages that run
+ * concurrently.  Entries are executed in order; within a parallel group
+ * all stages start simultaneously and the group completes when all finish.
  *
  * @example
  * ```ts
  * const pipeline = new IndexPipeline([
- *   new SourceIndexStage(),
- *   new DocsIndexStage(),
+ *   new ScipIndexerStage(),
+ *   [new SourceIndexStage(), new DocsIndexStage()],  // run in parallel
  *   new ImportResolutionStage(),
- *   new LspEnrichmentStage(),
- *   new ResolutionStage(),
  *   new EmbeddingStage(),
  * ]);
  * await pipeline.run(context, 'build');
  * ```
  */
 export class IndexPipeline {
-    stages;
-    constructor(stages) {
-        this.stages = stages;
+    entries;
+    constructor(entries) {
+        this.entries = entries;
     }
     /**
-     * Execute all stages in order.  If any stage throws, the remaining stages
+     * Execute all entries in order.  If any stage throws, the remaining entries
      * are skipped but every stage's `dispose()` hook is still called.
      */
     async run(context, mode) {
         const log = context.log ?? getLogger();
         const startMs = performance.now();
         try {
-            for (const stage of this.stages) {
-                const stageStart = performance.now();
-                log.indexing(`stage:${stage.name} started`);
-                await stage.execute(context, mode);
-                const durationMs = Math.round(performance.now() - stageStart);
-                log.indexing(`stage:${stage.name} complete`, { durationMs });
+            for (const entry of this.entries) {
+                const stages = Array.isArray(entry) ? entry : [entry];
+                if (stages.length === 1) {
+                    // Single stage — run directly.
+                    const stage = stages[0];
+                    const stageStart = performance.now();
+                    log.indexing(`stage:${stage.name} started`);
+                    await stage.execute(context, mode);
+                    const durationMs = Math.round(performance.now() - stageStart);
+                    log.indexing(`stage:${stage.name} complete`, { durationMs });
+                }
+                else {
+                    // Parallel group — run all concurrently.
+                    const groupNames = stages.map(s => s.name).join(', ');
+                    log.indexing(`stage-group started: [${groupNames}]`);
+                    const groupStart = performance.now();
+                    await Promise.all(stages.map(async (stage) => {
+                        const stageStart = performance.now();
+                        log.indexing(`stage:${stage.name} started`);
+                        await stage.execute(context, mode);
+                        const durationMs = Math.round(performance.now() - stageStart);
+                        log.indexing(`stage:${stage.name} complete`, { durationMs });
+                    }));
+                    const groupMs = Math.round(performance.now() - groupStart);
+                    log.indexing(`stage-group complete: [${groupNames}]`, { durationMs: groupMs });
+                }
             }
         }
         finally {
             // Always clean up, even on failure.
-            for (const stage of this.stages) {
+            const allStages = this.entries.flatMap(e => Array.isArray(e) ? e : [e]);
+            for (const stage of allStages) {
                 if (stage.dispose) {
                     try {
                         await stage.dispose();
@@ -79,12 +100,13 @@ export class IndexPipeline {
                 }
             }
             const totalMs = Math.round(performance.now() - startMs);
-            log.indexing('pipeline complete', { mode, totalStages: this.stages.length, durationMs: totalMs });
+            const stageCount = this.entries.flatMap(e => Array.isArray(e) ? e : [e]).length;
+            log.indexing('pipeline complete', { mode, totalStages: stageCount, durationMs: totalMs });
         }
     }
     /** Returns the ordered list of stage names (useful for introspection / tests). */
     get stageNames() {
-        return this.stages.map(s => s.name);
+        return this.entries.flatMap(e => Array.isArray(e) ? e.map(s => s.name) : [e.name]);
     }
 }
 //# sourceMappingURL=pipeline.js.map

package/dist/indexer/pipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/indexer/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAQH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAiHzC,iFAAiF;AAEjF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,aAAa;IACP,MAAM,CAAkB;IAEzC,YAAY,MAAuB;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,OAAwB,EAAE,IAAwB;QAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,SAAS,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAElC,IAAI,CAAC;YACH,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChC,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;gBACrC,GAAG,CAAC,QAAQ,CAAC,SAAS,KAAK,CAAC,IAAI,UAAU,CAAC,CAAC;gBAC5C,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBACnC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,CAAC;gBAC9D,GAAG,CAAC,QAAQ,CAAC,SAAS,KAAK,CAAC,IAAI,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,oCAAoC;YACpC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;oBAClB,IAAI,CAAC;wBACH,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;oBACxB,CAAC;oBAAC,MAAM,CAAC;wBACP,yBAAyB;oBAC3B,CAAC;gBACH,CAAC;YACH,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC;YACxD,GAAG,CAAC,QAAQ,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;QACpG,CAAC;IACH,CAAC;IAED,kFAAkF;IAClF,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;CACF"}
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/indexer/pipeline.ts"],"names":[],"mappings":"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"}

package/dist/indexer/stages/docs-index.d.ts

@@ -2,19 +2,17 @@
  * @module indexer/stages/docs-index
  *
  * Pipeline stage: walk documentation files, chunk by headings, insert into
- * the database, and optionally seed notes from documentation content.
+ * the database.
  */
 import type { PipelineContext, PipelineStage } from '../pipeline.js';
 import type { Database } from '../../db/schema.js';
 import type { DocumentationFile } from '../../docs/docs.js';
 /**
  * Walk documentation files, chunk by headings, and persist to the database.
- * Optionally seeds notes from documentation content.
  */
 export declare class DocsIndexStage implements PipelineStage {
     readonly name = "docs-index";
     execute(context: PipelineContext, mode: 'build' | 'update'): Promise<void>;
 }
 export declare function processDocumentationFile(db: Database.Database, doc: DocumentationFile, branch: string): void;
-export declare function upsertSeededDocumentationNote(db: Database.Database, doc: DocumentationFile, branch: string): void;
 //# sourceMappingURL=docs-index.d.ts.map

package/dist/indexer/stages/docs-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs-index.d.ts","sourceRoot":"","sources":["../../../src/indexer/stages/docs-index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAiB5D;;;GAGG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,IAAI,gBAAgB;IAEvB,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAsCjF;AAID,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,MAAM,GACb,IAAI,CAsEN;AAED,wBAAgB,6BAA6B,CAC3C,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,MAAM,GACb,IAAI,CAsBN"}
+{"version":3,"file":"docs-index.d.ts","sourceRoot":"","sources":["../../../src/indexer/stages/docs-index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAW5D;;GAEG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,IAAI,gBAAgB;IAEvB,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAkCjF;AAID,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,MAAM,GACb,IAAI,CAsEN"}

package/dist/indexer/stages/docs-index.js

@@ -2,14 +2,12 @@
  * @module indexer/stages/docs-index
  *
  * Pipeline stage: walk documentation files, chunk by headings, insert into
- * the database, and optionally seed notes from documentation content.
+ * the database.
  */
 import { walkDocumentationFiles } from '../../discovery/walker.js';
-import { inferSeededDocNoteKey, buildDocNoteScope } from '../../docs/docs.js';
 // ─── Stage ────────────────────────────────────────────────────────────────────
 /**
  * Walk documentation files, chunk by headings, and persist to the database.
- * Optionally seeds notes from documentation content.
  */
 export class DocsIndexStage {
     name = 'docs-index';
@@ -23,9 +21,6 @@ export class DocsIndexStage {
                 for (const doc of docs) {
                     seenDocPaths.add(doc.path);
                     processDocumentationFile(db, doc, branch);
-                    if (context.docsAutoNotes) {
-                        upsertSeededDocumentationNote(db, doc, branch);
-                    }
                 }
                 removeStaleDocumentation(db, branch, seenDocPaths);
             })();
@@ -40,8 +35,6 @@ export class DocsIndexStage {
                     const changedDoc = docsByPath.get(filePath);
                     if (changedDoc) {
                         processDocumentationFile(db, changedDoc, branch);
-                        if (context.docsAutoNotes)
-                            upsertSeededDocumentationNote(db, changedDoc, branch);
                         context.changedDocPaths.push(filePath);
                     }
                     else {
@@ -96,23 +89,6 @@ export function processDocumentationFile(db, doc, branch) {
        WHERE id IN (${staleSectionIds.map(() => '?').join(', ')})`).run(...staleSectionIds);
     }
 }
-export function upsertSeededDocumentationNote(db, doc, branch) {
-    const key = inferSeededDocNoteKey(doc);
-    if (!key)
-        return;
-    const scope = buildDocNoteScope(doc.path, branch);
-    const existing = db.prepare('SELECT content, source_hash FROM notes WHERE key = ? AND scope = ?').get(key, scope);
-    if (existing?.content === doc.content && existing.source_hash === doc.hash) {
-        return;
-    }
-    db.prepare(`INSERT INTO notes (key, scope, content, model, source_hash, created_at, updated_at)
-     VALUES (?, ?, ?, ?, ?, unixepoch(), unixepoch())
-     ON CONFLICT(key, scope) DO UPDATE SET
-       content = excluded.content,
-       model = excluded.model,
-       source_hash = excluded.source_hash,
-       updated_at = unixepoch()`).run(key, scope, doc.content, 'system:auto-doc-seed', doc.hash);
-}
 function deleteDocumentationByPath(db, docPath, branch) {
     const row = db.prepare('SELECT id FROM docs WHERE path = ? AND branch = ?')
         .get(docPath, branch);

package/dist/indexer/stages/docs-index.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs-index.js","sourceRoot":"","sources":["../../../src/indexer/stages/docs-index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"docs-index.js","sourceRoot":"","sources":["../../../src/indexer/stages/docs-index.ts"],"names":[],"mappings":"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"}

package/dist/indexer/stages/index.d.ts

@@ -3,12 +3,14 @@
  *
  * Concrete pipeline stages with real implementations.
  */
-export { ScipSourceStage } from './scip-source.js';
+export { ScipIndexerStage } from './scip-indexer.js';
 export { SourceIndexStage } from './source-index.js';
 export { DocsIndexStage } from './docs-index.js';
 export { ImportResolutionStage } from './import-resolution.js';
 export { DependencyApiStage } from './dependency-api.js';
-export { ScipEnrichmentStage } from './scip-enrichment.js';
 export { LspEnrichmentStage } from './lsp-enrichment.js';
 export { EmbeddingStage } from './embedding.js';
+export { ReverseDepsStage } from './reverse-deps.js';
+export { OverlayCleanupStage } from './overlay-cleanup.js';
+export type { OverlayCleanupOptions } from './overlay-cleanup.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/indexer/stages/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/indexer/stages/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/indexer/stages/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/indexer/stages/index.js

@@ -3,12 +3,13 @@
  *
  * Concrete pipeline stages with real implementations.
  */
-export { ScipSourceStage } from './scip-source.js';
+export { ScipIndexerStage } from './scip-indexer.js';
 export { SourceIndexStage } from './source-index.js';
 export { DocsIndexStage } from './docs-index.js';
 export { ImportResolutionStage } from './import-resolution.js';
 export { DependencyApiStage } from './dependency-api.js';
-export { ScipEnrichmentStage } from './scip-enrichment.js';
 export { LspEnrichmentStage } from './lsp-enrichment.js';
 export { EmbeddingStage } from './embedding.js';
+export { ReverseDepsStage } from './reverse-deps.js';
+export { OverlayCleanupStage } from './overlay-cleanup.js';
 //# sourceMappingURL=index.js.map

package/dist/indexer/stages/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/indexer/stages/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/indexer/stages/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/indexer/stages/lsp-enrichment.d.ts

@@ -44,5 +44,5 @@ export declare class LspEnrichmentStage implements PipelineStage {
 export declare function enrichProjectRefs(db: Database.Database, branch: string, files: Array<{
     path: string;
     language: string;
-}>, coordinator: LspEnrichmentCoordinator): Promise<void>;
+}>, coordinator: LspEnrichmentCoordinator, sourceCache?: Map<string, string>): Promise<void>;
 //# sourceMappingURL=lsp-enrichment.d.ts.map

package/dist/indexer/stages/lsp-enrichment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lsp-enrichment.d.ts","sourceRoot":"","sources":["../../../src/indexer/stages/lsp-enrichment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAGnE;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACtD,QAAQ,CAAC,IAAI,oBAAoB;IAEjC,OAAO,CAAC,WAAW,CAAyC;IAEtD,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAiD3E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAM/B;AAID;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,EAChD,WAAW,EAAE,wBAAwB,GACpC,OAAO,CAAC,IAAI,CAAC,CAgMf"}
+{"version":3,"file":"lsp-enrichment.d.ts","sourceRoot":"","sources":["../../../src/indexer/stages/lsp-enrichment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACtD,QAAQ,CAAC,IAAI,oBAAoB;IAEjC,OAAO,CAAC,WAAW,CAAyC;IAEtD,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAwE3E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAM/B;AAID;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,EAChD,WAAW,EAAE,wBAAwB,EACrC,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CAyLf"}

package/dist/indexer/stages/lsp-enrichment.js

@@ -24,7 +24,6 @@
  */
 import * as fs from 'node:fs';
 import { LspEnrichmentCoordinator } from '../../lsp/enrichment.js';
-import { buildStructuralEmbeddingText } from '../../embeddings/embedder.js';
 /**
  * Enriches indexed artefacts with LSP-derived metadata.
  *
@@ -37,6 +36,25 @@ export class LspEnrichmentStage {
     async execute(context, _mode) {
         if (!context.lsp?.enabled || context.files.length === 0)
             return;
+        // In baseline builds, SCIP is the sole resolution authority.
+        // LSP enrichment is only used in overlay mode for cross-file resolution.
+        if (context.layer === 'baseline') {
+            // Still run for non-SCIP languages in baseline builds (legacy behavior)
+            const scipSourced = context.scipSourcedLanguages;
+            const scipCovered = context.scipCoveredLanguages;
+            const nonScipFiles = context.files.filter(f => !(scipSourced?.has(f.language) || scipCovered?.has(f.language)));
+            if (nonScipFiles.length === 0)
+                return;
+            const languages = new Set(nonScipFiles.map(f => f.language));
+            if (context.indexDependencies)
+                languages.add('typescript');
+            this.coordinator = new LspEnrichmentCoordinator(context.lsp, context.walkerConfig.rootDir);
+            await this.coordinator.start(languages);
+            if (nonScipFiles.length > 0) {
+                await enrichProjectRefs(context.db, context.branch, nonScipFiles, this.coordinator, context.sourceCache);
+            }
+            return;
+        }
         const scipSourced = context.scipSourcedLanguages;
         const scipCovered = context.scipCoveredLanguages;
         // Split files into two groups:
@@ -67,14 +85,14 @@ export class LspEnrichmentStage {
         await this.coordinator.start(languages);
         // Full enrichment for non-SCIP files (all targets).
         if (fullEnrichFiles.length > 0) {
-            await enrichProjectRefs(context.db, context.branch, fullEnrichFiles, this.coordinator);
+            await enrichProjectRefs(context.db, context.branch, fullEnrichFiles, this.coordinator, context.sourceCache);
         }
         // Targeted enrichment for SCIP-sourced files (only unresolved refs).
         if (scipFiles.length > 0) {
             context.log.indexing('lsp-enrichment: enriching unresolved SCIP refs', {
                 files: scipFiles.length,
             });
-            await enrichUnresolvedScipRefs(context.db, context.branch, scipFiles, this.coordinator);
+            await enrichUnresolvedScipRefs(context.db, context.branch, scipFiles, this.coordinator, context.sourceCache);
         }
     }
     async dispose() {
@@ -89,7 +107,7 @@ export class LspEnrichmentStage {
  * Enrich symbols, call refs, type refs, and relationships for every file in
  * the context with LSP-derived metadata.
  */
-export async function enrichProjectRefs(db, branch, files, coordinator) {
+export async function enrichProjectRefs(db, branch, files, coordinator, sourceCache) {
     const selectSymbols = db.prepare(`SELECT s.id, s.name, s.signature, s.start_line
      FROM symbols s
      JOIN files f ON f.id = s.file_id
@@ -114,7 +132,6 @@ export async function enrichProjectRefs(db, branch, files, coordinator) {
     const updateSymbol = db.prepare(`UPDATE symbols
      SET resolved_type_signature = ?, resolved_return_type = ?, definition_uri = ?, definition_path = ?
      WHERE id = ?`);
-    const updateSymbolFts = db.prepare('UPDATE symbols_fts SET signature = ? WHERE rowid = ?');
     const updateCallRef = db.prepare(`UPDATE symbol_refs
      SET resolved_type_signature = ?, resolved_return_type = ?, definition_uri = ?, definition_path = ?, definition_line = ?, definition_character = ?
      WHERE id = ?`);
@@ -132,11 +149,17 @@ export async function enrichProjectRefs(db, branch, files, coordinator) {
         if (!file || !fs.existsSync(file.path))
             continue;
         let source;
-        try {
-            source = fs.readFileSync(file.path, 'utf8');
+        const cached = sourceCache?.get(file.path);
+        if (cached !== undefined) {
+            source = cached;
         }
-        catch {
-            continue;
+        else {
+            try {
+                source = fs.readFileSync(file.path, 'utf8');
+            }
+            catch {
+                continue;
+            }
         }
         const tagged = [];
         const symbols = selectSymbols.all(file.path, branch);
@@ -174,12 +197,6 @@ export async function enrichProjectRefs(db, branch, files, coordinator) {
                 case 'symbol':
                     updates.push(() => {
                         updateSymbol.run(m.resolvedTypeSignature, m.resolvedReturnType, m.definitionUri, m.definitionPath, tag.rowId);
-                        updateSymbolFts.run(buildStructuralEmbeddingText({
-                            name: tag.name,
-                            signature: tag.signature ?? null,
-                            resolvedTypeSignature: m.resolvedTypeSignature,
-                            resolvedReturnType: m.resolvedReturnType,
-                        }), tag.rowId);
                     });
                     break;
                 case 'callRef':
@@ -207,7 +224,7 @@ export async function enrichProjectRefs(db, branch, files, coordinator) {
 /**
  * For SCIP-sourced files, only enrich refs that are still `unresolved`.
  *
- * SCIP pre-resolves most refs during `ScipSourceStage`, but some refs
+ * SCIP pre-resolves most refs during `ScipIndexerStage`, but some refs
  * (notably member-access calls like `db.prepare(...)`) remain unresolved
  * because SCIP tracks the receiver and method as separate occurrences.
  *
@@ -215,7 +232,7 @@ export async function enrichProjectRefs(db, branch, files, coordinator) {
  * call-site position.  We write `definition_path` / `definition_line`
  * so the downstream resolution stage can map them to a `callee_id`.
  */
-async function enrichUnresolvedScipRefs(db, branch, files, coordinator) {
+async function enrichUnresolvedScipRefs(db, branch, files, coordinator, sourceCache) {
     // Only select refs that SCIP left unresolved.
     const selectUnresolvedCallRefs = db.prepare(`SELECT sr.id, sr.call_line, sr.call_character
      FROM symbol_refs sr
@@ -250,11 +267,17 @@ async function enrichUnresolvedScipRefs(db, branch, files, coordinator) {
         if (!file || !fs.existsSync(file.path))
             continue;
         let source;
-        try {
-            source = fs.readFileSync(file.path, 'utf8');
+        const cached = sourceCache?.get(file.path);
+        if (cached !== undefined) {
+            source = cached;
         }
-        catch {
-            continue;
+        else {
+            try {
+                source = fs.readFileSync(file.path, 'utf8');
+            }
+            catch {
+                continue;
+            }
         }
         const tagged = [];
         const callRefs = selectUnresolvedCallRefs.all(file.path, branch);