@jafreck/lore 0.3.4 → 0.3.6

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

@@ -0,0 +1,43 @@
+/**
+ * @module indexer/stages/scip-enrichment
+ *
+ * Pipeline stage: enrich symbols, symbol_refs, type_refs, and
+ * symbol_relationships with SCIP-derived metadata.
+ *
+ * SCIP enrichment writes to the **same database columns** as LSP
+ * enrichment (`definition_path`, `definition_line`, `resolved_type_signature`,
+ * etc.) so the downstream resolution stage is agnostic to the data source.
+ *
+ * ## Pipeline ordering
+ *
+ * ```
+ * ... → DependencyApiStage → ScipEnrichmentStage → LspEnrichmentStage → ResolutionStage → ...
+ * ```
+ *
+ * SCIP runs **before** LSP.  The LSP stage then skips any languages that
+ * SCIP already enriched (communicated via `context.scipCoveredLanguages`).
+ *
+ * ## Data written
+ *
+ * Identical columns to LSP enrichment — see `lsp-enrichment.ts` for the
+ * full list.
+ */
+import type { PipelineContext, PipelineStage } from '../pipeline.js';
+import type { Database } from '../../db/schema.js';
+import { ScipEnrichmentCoordinator } from '../../scip/enrichment.js';
+/**
+ * Enriches indexed artefacts with SCIP-derived metadata.
+ *
+ * Manages the lifecycle of a `ScipEnrichmentCoordinator` per pipeline run.
+ */
+export declare class ScipEnrichmentStage implements PipelineStage {
+    readonly name = "scip-enrichment";
+    private coordinator;
+    execute(context: PipelineContext, _mode: 'build' | 'update'): Promise<void>;
+    dispose(): Promise<void>;
+}
+export declare function enrichProjectRefsWithScip(db: Database.Database, branch: string, files: Array<{
+    path: string;
+    language: string;
+}>, coordinator: ScipEnrichmentCoordinator): Promise<void>;
+//# sourceMappingURL=scip-enrichment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scip-enrichment.d.ts","sourceRoot":"","sources":["../../../src/indexer/stages/scip-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,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAGrE;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACvD,QAAQ,CAAC,IAAI,qBAAqB;IAElC,OAAO,CAAC,WAAW,CAA0C;IAEvD,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB3E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAM/B;AAID,wBAAsB,yBAAyB,CAC7C,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,yBAAyB,GACrC,OAAO,CAAC,IAAI,CAAC,CAoMf"}

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

@@ -0,0 +1,174 @@
+/**
+ * @module indexer/stages/scip-enrichment
+ *
+ * Pipeline stage: enrich symbols, symbol_refs, type_refs, and
+ * symbol_relationships with SCIP-derived metadata.
+ *
+ * SCIP enrichment writes to the **same database columns** as LSP
+ * enrichment (`definition_path`, `definition_line`, `resolved_type_signature`,
+ * etc.) so the downstream resolution stage is agnostic to the data source.
+ *
+ * ## Pipeline ordering
+ *
+ * ```
+ * ... → DependencyApiStage → ScipEnrichmentStage → LspEnrichmentStage → ResolutionStage → ...
+ * ```
+ *
+ * SCIP runs **before** LSP.  The LSP stage then skips any languages that
+ * SCIP already enriched (communicated via `context.scipCoveredLanguages`).
+ *
+ * ## Data written
+ *
+ * Identical columns to LSP enrichment — see `lsp-enrichment.ts` for the
+ * full list.
+ */
+import * as fs from 'node:fs';
+import { ScipEnrichmentCoordinator } from '../../scip/enrichment.js';
+import { buildStructuralEmbeddingText } from '../../embeddings/embedder.js';
+/**
+ * Enriches indexed artefacts with SCIP-derived metadata.
+ *
+ * Manages the lifecycle of a `ScipEnrichmentCoordinator` per pipeline run.
+ */
+export class ScipEnrichmentStage {
+    name = 'scip-enrichment';
+    coordinator = null;
+    async execute(context, _mode) {
+        if (!context.scip?.enabled || context.files.length === 0)
+            return;
+        this.coordinator = new ScipEnrichmentCoordinator(context.scip, context.walkerConfig.rootDir);
+        // Run SCIP indexers for all languages present in the file list.
+        const languages = new Set(context.files.map(f => f.language));
+        const coveredLanguages = await this.coordinator.start(languages);
+        if (coveredLanguages.size === 0)
+            return;
+        // Store which languages SCIP enriched so the LSP stage can skip them.
+        context.scipCoveredLanguages = coveredLanguages;
+        await enrichProjectRefsWithScip(context.db, context.branch, context.files, this.coordinator);
+    }
+    async dispose() {
+        if (this.coordinator) {
+            await this.coordinator.dispose();
+            this.coordinator = null;
+        }
+    }
+}
+// ─── Enrichment logic (mirrors lsp-enrichment.ts pattern) ─────────────────────
+export async function enrichProjectRefsWithScip(db, branch, files, coordinator) {
+    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
+     WHERE f.path = ? AND f.branch = ?
+     ORDER BY s.id`);
+    const selectCallRefs = db.prepare(`SELECT sr.id, sr.call_line, sr.call_character
+     FROM symbol_refs sr
+     JOIN symbols s ON s.id = sr.caller_id
+     JOIN files f ON f.id = s.file_id
+     WHERE f.path = ? AND f.branch = ?
+     ORDER BY sr.id`);
+    const selectTypeRefs = db.prepare(`SELECT tr.id, tr.ref_line, tr.ref_character
+     FROM type_refs tr
+     JOIN files f ON f.id = tr.file_id
+     WHERE f.path = ? AND f.branch = ?
+     ORDER BY tr.id`);
+    const selectRelationships = db.prepare(`SELECT sr.id, sr.line, sr.character
+     FROM symbol_relationships sr
+     JOIN files f ON f.id = sr.file_id
+     WHERE f.path = ? AND f.branch = ? AND sr.line IS NOT NULL
+     ORDER BY sr.id`);
+    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 = ?`);
+    const updateTypeRef = db.prepare(`UPDATE type_refs
+     SET resolved_type_signature = ?, definition_uri = ?, definition_path = ?, definition_line = ?, definition_character = ?
+     WHERE id = ?`);
+    const updateRelationship = db.prepare(`UPDATE symbol_relationships
+     SET definition_uri = ?, definition_path = ?, definition_line = ?, definition_character = ?
+     WHERE id = ?`);
+    const runInTransaction = db.transaction((updates) => {
+        for (const fn of updates)
+            fn();
+    });
+    for (const file of files) {
+        if (!file || !fs.existsSync(file.path))
+            continue;
+        // Only process files for languages covered by SCIP.
+        if (!coordinator.coveredLanguages.has(file.language))
+            continue;
+        let source;
+        try {
+            source = fs.readFileSync(file.path, 'utf8');
+        }
+        catch {
+            continue;
+        }
+        const tagged = [];
+        const symbols = selectSymbols.all(file.path, branch);
+        for (const s of symbols) {
+            tagged.push({ table: 'symbol', rowId: s.id, line: s.start_line, character: 0, name: s.name, signature: s.signature });
+        }
+        const callRefs = selectCallRefs.all(file.path, branch);
+        for (const cr of callRefs) {
+            tagged.push({ table: 'callRef', rowId: cr.id, line: cr.call_line, character: cr.call_character ?? 0 });
+        }
+        const typeRefs = selectTypeRefs.all(file.path, branch);
+        for (const tr of typeRefs) {
+            tagged.push({ table: 'typeRef', rowId: tr.id, line: tr.ref_line, character: tr.ref_character ?? 0 });
+        }
+        const relationships = selectRelationships.all(file.path, branch);
+        for (const r of relationships) {
+            tagged.push({ table: 'relationship', rowId: r.id, line: r.line, character: r.character ?? 0 });
+        }
+        if (tagged.length === 0)
+            continue;
+        // SCIP enrichment is synchronous (no network I/O).
+        const metadata = coordinator.enrich({
+            filePath: file.path,
+            language: file.language,
+            source,
+            targets: tagged.map(t => ({ line: t.line, character: t.character })),
+        });
+        const updates = [];
+        for (let i = 0; i < tagged.length; i++) {
+            const tag = tagged[i];
+            const m = metadata[i];
+            if (!m)
+                continue;
+            switch (tag.table) {
+                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':
+                    updates.push(() => {
+                        updateCallRef.run(m.resolvedTypeSignature, m.resolvedReturnType, m.definitionUri, m.definitionPath, m.definitionLine, m.definitionCharacter, tag.rowId);
+                    });
+                    break;
+                case 'typeRef':
+                    updates.push(() => {
+                        updateTypeRef.run(m.resolvedTypeSignature, m.definitionUri, m.definitionPath, m.definitionLine, m.definitionCharacter, tag.rowId);
+                    });
+                    break;
+                case 'relationship':
+                    updates.push(() => {
+                        updateRelationship.run(m.definitionUri, m.definitionPath, m.definitionLine, m.definitionCharacter, tag.rowId);
+                    });
+                    break;
+            }
+        }
+        if (updates.length > 0)
+            runInTransaction(updates);
+    }
+}
+//# sourceMappingURL=scip-enrichment.js.map

package/dist/indexer/stages/scip-enrichment.js.map

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

package/dist/indexer/stages/scip-source.d.ts

@@ -0,0 +1,117 @@
+/**
+ * @module indexer/stages/scip-source
+ *
+ * Pipeline stage: for SCIP-covered languages, populate `files`, `symbols`,
+ * `symbol_refs`, `type_refs`, `symbol_relationships`, and `file_imports`
+ * **directly from the SCIP index** — bypassing tree-sitter entirely.
+ *
+ * This is the SCIP-primary architecture.  SCIP is the source of truth for
+ * both the symbol table and the call graph.  For each SCIP document:
+ *
+ * 1. **Symbols**: Definition occurrences → `symbols` rows; kinds inferred
+ *    from SCIP descriptor suffixes; spans from `enclosing_range`.
+ * 2. **Refs**: Non-definition, non-local reference occurrences →
+ *    `symbol_refs` rows with both `caller_id` and `callee_id` resolved
+ *    using containment (which symbol's span encloses this ref?) and
+ *    definition lookup (where is the referenced SCIP symbol defined?).
+ *
+ * SCIP refs are inserted **pre-resolved** with `resolution_method =
+ * 'scip_definition'`.  The downstream resolution stage only processes
+ * refs from non-SCIP languages.
+ *
+ * ## Data written
+ *
+ * Same tables as `SourceIndexStage`: `files`, `symbols`, `symbols_fts`,
+ * `symbol_refs`, `type_refs`, `symbol_relationships`, `file_imports`.
+ *
+ * ## Pipeline ordering
+ *
+ * This stage runs **before** `SourceIndexStage`.  It stores which
+ * languages and files it handled in `context.scipSourcedLanguages` and
+ * `context.scipSourcedFiles` so the tree-sitter path can skip them.
+ */
+import type { PipelineContext, PipelineStage } from '../pipeline.js';
+/**
+ * Infer a Lore symbol `kind` from a SCIP symbol string.
+ *
+ * SCIP symbol syntax:  `<scheme> <package> (<descriptor>)+`
+ * Descriptor suffixes:
+ *   - `/`  → Namespace (module/package)
+ *   - `#`  → Type (class, interface, enum)
+ *   - `.`  → Term (variable, constant, property, enum member)
+ *   - `().` → Method/Function
+ *   - `(name)` → Parameter
+ *   - `[name]` → Type parameter
+ *   - `name:` → Meta (object property)
+ */
+declare function inferKindFromScipSymbol(scipSymbol: string, docHint: string): string;
+/**
+ * Extract a human-readable name from a SCIP symbol string.
+ *
+ * E.g. `scip-typescript npm pkg 1.0 src/\`file.ts\`/MyClass#myMethod().`
+ * → `myMethod`
+ */
+declare function extractNameFromScipSymbol(scipSymbol: string): string;
+/**
+ * Estimate the end line of a symbol whose `enclosing_range` was absent.
+ *
+ * Strategy: from the definition line, scan forward for curly-brace blocks
+ * (classes, functions, structs in C-family / Rust / Go / Java / etc.) or
+ * indentation-based blocks (Python).  If nothing works, scan to the next
+ * definition or EOF.
+ */
+declare function estimateSymbolEndLine(sourceLines: string[], defLine: number, nextDefLine: number | null): number;
+/**
+ * Infer a `ref_kind` for a type reference from its surrounding source context.
+ *
+ * Reads the source line at `refLine` and applies simple pattern matching to
+ * distinguish parameter, return, field, variable, generic_arg and bound usages.
+ * Falls back to `'other'` when the context is ambiguous.
+ */
+declare function inferTypeRefKind(sourceLines: string[], refLine: number, refChar: number): string;
+export declare class ScipSourceStage implements PipelineStage {
+    readonly name = "scip-source";
+    execute(context: PipelineContext, mode: 'build' | 'update'): Promise<void>;
+    dispose(): Promise<void>;
+    private loadScipIndex;
+}
+/**
+ * Classify a SCIP symbol reference into the graph edge type it represents.
+ *
+ * SCIP descriptor suffixes:
+ *   `().`  → Method/Function → call edge (symbol_refs)
+ *   `#`    → Type            → type edge (type_refs)
+ *   `.`    → Term (variable, property, constant, enum member) → skip
+ *   `/`    → Namespace (module) → skip
+ *   `:`    → Meta (object property) → skip
+ *   `)`    → Parameter → skip
+ *   `]`    → Type parameter → type edge (type_refs)
+ */
+declare function classifyScipReference(scipSymbol: string): 'call' | 'type' | 'skip';
+/**
+ * Extract the actual import/require path from a source line.
+ *
+ * Handles common patterns across languages:
+ * - JS/TS: `import ... from 'path'`, `require('path')`
+ * - Python: `import path`, `from path import ...`
+ * - Go: `"path"`  (inside import block)
+ * - Java/Kotlin/Scala: `import path.to.Class`
+ * - Rust: `use path::to::item`
+ * - C/C++: `#include "path"` or `#include <path>`
+ * - Ruby: `require 'path'`, `require_relative 'path'`
+ * - PHP: `use Path\\To\\Class`
+ * - C#: `using Namespace.Name`
+ * - Dart: `import 'path'`
+ *
+ * Returns `null` when no recognizable import pattern is found.
+ */
+declare function extractImportPathFromSource(line: string): string | null;
+/**
+ * Determine the Lore language for a SCIP document.
+ *
+ * Many SCIP indexers (including scip-typescript) leave the `language` field
+ * blank.  When that happens, infer from the file extension.
+ */
+declare function inferLoreLanguage(scipLanguage: string, relativePath: string): string | null;
+export { estimateSymbolEndLine as _estimateSymbolEndLine, inferTypeRefKind as _inferTypeRefKind, extractImportPathFromSource as _extractImportPathFromSource, inferKindFromScipSymbol as _inferKindFromScipSymbol, inferLoreLanguage as _inferLoreLanguage, classifyScipReference as _classifyScipReference, extractNameFromScipSymbol as _extractNameFromScipSymbol, };
+//# sourceMappingURL=scip-source.d.ts.map

package/dist/indexer/stages/scip-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scip-source.d.ts","sourceRoot":"","sources":["../../../src/indexer/stages/scip-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAaH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAarE;;;;;;;;;;;;GAYG;AACH,iBAAS,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAsC5E;AAED;;;;;GAKG;AACH,iBAAS,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAqB7D;AAkBD;;;;;;;GAOG;AACH,iBAAS,qBAAqB,CAC5B,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,MAAM,CA2CR;AAID;;;;;;GAMG;AACH,iBAAS,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAiCzF;AAID,qBAAa,eAAgB,YAAW,aAAa;IACnD,QAAQ,CAAC,IAAI,iBAAiB;IAExB,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAghB1E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAM9B,OAAO,CAAC,aAAa;CA4DtB;AAID;;;;;;;;;;;GAWG;AACH,iBAAS,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAgB3E;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,iBAAS,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA4ChE;AAqDD;;;;;GAKG;AACH,iBAAS,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAepF;AAKD,OAAO,EACL,qBAAqB,IAAI,sBAAsB,EAC/C,gBAAgB,IAAI,iBAAiB,EACrC,2BAA2B,IAAI,4BAA4B,EAC3D,uBAAuB,IAAI,wBAAwB,EACnD,iBAAiB,IAAI,kBAAkB,EACvC,qBAAqB,IAAI,sBAAsB,EAC/C,yBAAyB,IAAI,0BAA0B,GACxD,CAAC"}