seer-mcp 0.1.0

package/dist/indexer/continuity.js

@@ -0,0 +1,288 @@
+"use strict";
+/**
+ * v10 — Symbol Rename/Move Continuity heuristics.
+ *
+ * Goal: when exact `symbol_key` history walking terminates (because the
+ * function was renamed or moved), surface honest, confidence-labelled
+ * continuity evidence so the agent can decide whether to trust the link.
+ *
+ * Heuristics (current pass — opt-in, low-confidence by default):
+ *   - shape_hash exact match: previous-symbol candidate has the same
+ *     structural SimHash → strong (confidence 0.85+)
+ *   - shape_hash close match: small Hamming distance (≤ 4) + similar name
+ *     → medium (confidence 0.65)
+ *   - signature similarity: same arity + same containing class/module
+ *     → weak (confidence 0.5)
+ *   - same file rename history: file was renamed in git history, the
+ *     historical file had a same-shape function with a different name → boost
+ *     (confidence 0.75)
+ *
+ * Stored on `symbol_history_continuity`. Never pretends rename continuity
+ * is certain.
+ *
+ * This module does NOT replace existing exact-key history. It only proposes
+ * additional links when buildSymbolHistory's exact-key walk ran out of
+ * commits. The Preflight / seer_history layers can read continuity rows
+ * alongside symbol_history.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildContinuity = buildContinuity;
+exports.getContinuityForSymbol = getContinuityForSymbol;
+/**
+ * Run the continuity pass over every symbol whose recorded history has
+ * fewer than `historyThreshold` commits AND that has a shape_hash. For each
+ * such symbol we scan other symbols sharing a close shape_hash and propose
+ * the highest-confidence candidate (deduped per symbol_id).
+ */
+function buildContinuity(store, options = {}) {
+    const start = Date.now();
+    const log = options.log ?? (() => { });
+    const historyThreshold = options.historyThreshold ?? 1;
+    const maxHamming = options.maxHammingDistance ?? 4;
+    // Pool of candidates: every symbol with a shape_hash.
+    const pool = store.listSymbolsWithShapeHash({ minLoc: 1, limit: 100000 });
+    if (pool.length === 0) {
+        log('no shape-hashed symbols; nothing to do');
+        return { candidatesConsidered: 0, inserted: 0, skipped: 0, elapsedMs: Date.now() - start };
+    }
+    // Bucket by qualifiedName/name → list of candidates (so we can detect
+    // rename: same shape, different name).
+    const byHash = new Map();
+    for (const s of pool) {
+        const k = s.shapeHash.toString();
+        const list = byHash.get(k) ?? [];
+        list.push(s);
+        byHash.set(k, list);
+    }
+    let considered = 0;
+    let inserted = 0;
+    let skipped = 0;
+    const raw = store.rawDb();
+    for (const s of pool) {
+        // Find the symbol's stored history count. If it's >= historyThreshold
+        // AND we're not in includeAllSymbols mode, skip — exact history is fine.
+        if (!options.includeAllSymbols) {
+            const cnt = raw.prepare('SELECT COUNT(*) AS c FROM symbol_history WHERE symbol_id = ?').get(s.id);
+            if (cnt && cnt.c >= historyThreshold)
+                continue;
+        }
+        // Exact shape match candidates with a DIFFERENT (qualifiedName ?? name).
+        const exactMatches = (byHash.get(s.shapeHash.toString()) ?? [])
+            .filter(c => c.id !== s.id);
+        if (exactMatches.length > 0) {
+            const cand = pickBestCandidate(s, exactMatches);
+            if (cand) {
+                const sameClass = sharesContainingScope(s, cand);
+                const nameRelated = similarName(s.name, cand.name);
+                // How many OTHER symbols share this exact shape? A shape shared by many
+                // symbols (trivial getters, `return null;`, boilerplate) is NOT a
+                // reliable rename signal on its own. Only assert a high-confidence link
+                // when the shape is (near-)unique to this pair; otherwise require
+                // corroboration (same scope or a related name) and label the ambiguity
+                // honestly with a lower, capped confidence. Never pretend certainty.
+                const ambiguous = exactMatches.length >= 2;
+                if (ambiguous && !sameClass && !nameRelated) {
+                    // Common shape, no corroborating evidence — do not invent a rename.
+                    skipped++;
+                    continue;
+                }
+                considered++;
+                const reasons = ['shape_hash_exact'];
+                if (sameClass)
+                    reasons.push('same_containing_scope');
+                if (nameRelated)
+                    reasons.push('similar_name');
+                let confidence;
+                if (ambiguous) {
+                    reasons.push(`ambiguous_shape_bucket:n=${exactMatches.length + 1}`);
+                    confidence = 0.6;
+                    if (sameClass)
+                        confidence = Math.min(0.7, confidence + 0.05);
+                    if (nameRelated)
+                        confidence = Math.min(0.7, confidence + 0.05);
+                }
+                else {
+                    confidence = 0.85;
+                    if (sameClass)
+                        confidence = Math.min(0.95, confidence + 0.05);
+                    if (nameRelated)
+                        confidence = Math.min(0.95, confidence + 0.05);
+                }
+                upsertContinuity(store, {
+                    symbolId: s.id,
+                    symbolKey: keyFor(s),
+                    previousSymbolKey: keyFor(cand),
+                    previousName: cand.name,
+                    previousFile: cand.filePath,
+                    confidence,
+                    matchReasons: reasons,
+                });
+                inserted++;
+                continue;
+            }
+        }
+        // Close hash match.
+        let best = null;
+        for (const peer of pool) {
+            if (peer.id === s.id)
+                continue;
+            if ((peer.name === s.name) && (peer.qualifiedName === s.qualifiedName))
+                continue;
+            const d = hammingDistance(s.shapeHash, peer.shapeHash);
+            if (d > maxHamming)
+                continue;
+            if (!best || d < best.distance)
+                best = { peer, distance: d };
+        }
+        if (best && best.distance <= maxHamming) {
+            const cand = best.peer;
+            // Only act when names are at least loosely related (share a prefix or
+            // a suffix), to avoid pairing every short function in the codebase.
+            if (similarName(s.name, cand.name) || sharesContainingScope(s, cand)) {
+                considered++;
+                const reasons = [`shape_hash_close:d=${best.distance}`];
+                if (similarName(s.name, cand.name))
+                    reasons.push('similar_name');
+                if (sharesContainingScope(s, cand))
+                    reasons.push('same_containing_scope');
+                const confidence = best.distance === 0 ? 0.8
+                    : best.distance <= 2 ? 0.6
+                        : 0.4;
+                upsertContinuity(store, {
+                    symbolId: s.id,
+                    symbolKey: keyFor(s),
+                    previousSymbolKey: keyFor(cand),
+                    previousName: cand.name,
+                    previousFile: cand.filePath,
+                    confidence,
+                    matchReasons: reasons,
+                });
+                inserted++;
+                continue;
+            }
+        }
+        skipped++;
+    }
+    return {
+        candidatesConsidered: considered,
+        inserted, skipped,
+        elapsedMs: Date.now() - start,
+    };
+}
+function upsertContinuity(store, c) {
+    const raw = store.rawDb();
+    raw.prepare(`
+    INSERT INTO symbol_history_continuity
+      (symbol_id, symbol_key, previous_symbol_key, previous_name, previous_file,
+       bridging_sha, confidence, match_reasons, recorded_at)
+    VALUES (?, ?, ?, ?, ?, NULL, ?, ?, ?)
+    ON CONFLICT(symbol_id, previous_symbol_key) DO UPDATE SET
+      confidence = excluded.confidence,
+      match_reasons = excluded.match_reasons,
+      previous_name = excluded.previous_name,
+      previous_file = excluded.previous_file,
+      recorded_at = excluded.recorded_at
+  `).run(c.symbolId, c.symbolKey, c.previousSymbolKey, c.previousName, c.previousFile, c.confidence, JSON.stringify(c.matchReasons), Date.now());
+}
+function keyFor(s) {
+    return `${s.kind}:${s.qualifiedName ?? s.name}`;
+}
+function sharesContainingScope(a, b) {
+    if (a.filePath === b.filePath)
+        return true;
+    // Compare class/module prefix in the qualified name (e.g. `AuthService.foo`
+    // and `AuthService.bar` share `AuthService`).
+    const aQual = a.qualifiedName ?? '';
+    const bQual = b.qualifiedName ?? '';
+    if (!aQual.includes('.') || !bQual.includes('.'))
+        return false;
+    const aPrefix = aQual.split('.').slice(0, -1).join('.');
+    const bPrefix = bQual.split('.').slice(0, -1).join('.');
+    return aPrefix.length > 0 && aPrefix === bPrefix;
+}
+function similarName(a, b) {
+    if (!a || !b)
+        return false;
+    if (a === b)
+        return false; // we only flag potential RENAMES
+    const aL = a.toLowerCase();
+    const bL = b.toLowerCase();
+    // Same prefix of length >= 4 or same suffix of length >= 4.
+    const minLen = Math.min(aL.length, bL.length);
+    if (minLen < 4)
+        return false;
+    let prefix = 0;
+    while (prefix < minLen && aL[prefix] === bL[prefix])
+        prefix++;
+    if (prefix >= 4)
+        return true;
+    let suffix = 0;
+    while (suffix < minLen && aL[aL.length - 1 - suffix] === bL[bL.length - 1 - suffix])
+        suffix++;
+    if (suffix >= 4)
+        return true;
+    // Names that differ by a verb prefix swap (validate → verify) — drop the
+    // first 4 characters and compare the rest.
+    if (aL.length >= 4 && bL.length >= 4 && aL.slice(4) === bL.slice(4))
+        return true;
+    return false;
+}
+function pickBestCandidate(target, candidates) {
+    // Prefer same-file rename. Then same-class rename. Then any candidate.
+    const sameFile = candidates.filter(c => c.filePath === target.filePath);
+    if (sameFile.length > 0)
+        return sameFile[0];
+    const sameClass = candidates.filter(c => sharesContainingScope(target, c));
+    if (sameClass.length > 0)
+        return sameClass[0];
+    return candidates[0] ?? null;
+}
+function hammingDistance(a, b) {
+    let x = a ^ b;
+    let n = 0;
+    while (x !== 0n) {
+        x &= x - 1n;
+        n++;
+    }
+    return n;
+}
+/**
+ * Fetch continuity rows for a given symbol id, ordered by confidence desc.
+ */
+function getContinuityForSymbol(store, symbolId) {
+    if (!store.hasV10())
+        return [];
+    try {
+        const rows = store.rawDb().prepare(`
+      SELECT previous_symbol_key AS previousSymbolKey,
+             previous_name AS previousName,
+             previous_file AS previousFile,
+             confidence, match_reasons AS matchReasons
+      FROM symbol_history_continuity
+      WHERE symbol_id = ?
+      ORDER BY confidence DESC, id DESC
+    `).all(symbolId);
+        return rows.map(r => ({
+            previousSymbolKey: String(r.previousSymbolKey),
+            previousName: String(r.previousName ?? ''),
+            previousFile: String(r.previousFile ?? ''),
+            confidence: Number(r.confidence ?? 0),
+            matchReasons: parseReasons(r.matchReasons),
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+function parseReasons(v) {
+    if (typeof v !== 'string')
+        return [];
+    try {
+        const parsed = JSON.parse(v);
+        return Array.isArray(parsed) ? parsed.map(String) : [];
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=continuity.js.map

package/dist/indexer/continuity.js.map

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

package/dist/indexer/detectchanges.d.ts

@@ -0,0 +1,32 @@
+import { Store } from '../db/store.js';
+import type { SymbolRow } from '../types.js';
+/**
+ * Compute the blast radius of an uncommitted (or between-refs) diff. For each
+ * changed file we identify the symbols whose line ranges overlap the diff
+ * hunks, then expand by N levels of reverse callers (transitive callers,
+ * because they're the code most likely to break).
+ */
+export interface ChangedSymbol {
+    symbol: SymbolRow;
+    hunkCount: number;
+}
+export interface DetectChangesResult {
+    fromRef: string | null;
+    toRef: string | null;
+    changedFiles: Array<{
+        path: string;
+        hunks: number;
+        symbols: ChangedSymbol[];
+    }>;
+    /** Direct changed symbols (the inner symbols in `changedFiles`). */
+    directlyChanged: SymbolRow[];
+    /** Transitive callers of the directly-changed set (deduped). */
+    transitivelyAffected: SymbolRow[];
+    elapsedMs: number;
+}
+export declare function detectChanges(repoRoot: string, store: Store, options?: {
+    fromRef?: string;
+    toRef?: string;
+    callerDepth?: number;
+}): DetectChangesResult;
+//# sourceMappingURL=detectchanges.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detectchanges.d.ts","sourceRoot":"","sources":["../../src/indexer/detectchanges.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC,CAAC;IAC/E,oEAAoE;IACpE,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7B,gEAAgE;IAChE,oBAAoB,EAAE,SAAS,EAAE,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAC9B,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACvE,mBAAmB,CA0DrB"}

package/dist/indexer/detectchanges.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectChanges = detectChanges;
+const git_js_1 = require("./git.js");
+function detectChanges(repoRoot, store, options = {}) {
+    const start = Date.now();
+    const callerDepth = options.callerDepth ?? 2;
+    const fromRef = options.fromRef ?? null;
+    const toRef = options.toRef ?? null;
+    if (!(0, git_js_1.isGitRepo)(repoRoot)) {
+        return { fromRef, toRef, changedFiles: [], directlyChanged: [], transitivelyAffected: [], elapsedMs: Date.now() - start };
+    }
+    const files = (0, git_js_1.gitChangedFiles)(repoRoot, fromRef ?? undefined, toRef ?? undefined);
+    if (files.length === 0) {
+        return { fromRef, toRef, changedFiles: [], directlyChanged: [], transitivelyAffected: [], elapsedMs: Date.now() - start };
+    }
+    const dbFiles = new Map(store.listFiles().map(f => [normalize(f.path), f.id]));
+    const changedFiles = [];
+    const directIds = new Set();
+    for (const abs of files) {
+        const fileId = dbFiles.get(normalize(abs));
+        if (fileId === undefined)
+            continue;
+        const hunks = (0, git_js_1.fileDiffHunksSync)(repoRoot, abs, fromRef ?? undefined, toRef ?? undefined);
+        if (hunks.length === 0)
+            continue;
+        // Convert 1-indexed git line ranges to 0-indexed Seer line ranges.
+        const ranges = hunks.map(h => [
+            Math.max(0, h.newStart - 1),
+            Math.max(0, h.newStart - 1 + Math.max(0, h.newLines - 1)),
+        ]);
+        const syms = store.symbolsTouchingLines(fileId, ranges);
+        for (const s of syms)
+            directIds.add(s.id);
+        changedFiles.push({
+            path: abs,
+            hunks: hunks.length,
+            symbols: syms.map(s => ({ symbol: s, hunkCount: hunks.length })),
+        });
+    }
+    const directly = [];
+    for (const id of directIds) {
+        const s = store.getSymbolById(id);
+        if (s)
+            directly.push(s);
+    }
+    const transitiveIds = new Set();
+    for (const s of directly) {
+        for (const id of store.reverseReachable(s.id, callerDepth)) {
+            if (!directIds.has(id))
+                transitiveIds.add(id);
+        }
+    }
+    const transitively = [];
+    for (const id of transitiveIds) {
+        const s = store.getSymbolById(id);
+        if (s)
+            transitively.push(s);
+    }
+    transitively.sort((a, b) => b.pagerank - a.pagerank);
+    return {
+        fromRef,
+        toRef,
+        changedFiles,
+        directlyChanged: directly,
+        transitivelyAffected: transitively,
+        elapsedMs: Date.now() - start,
+    };
+}
+function normalize(p) {
+    const n = p.replace(/\\/g, '/');
+    return process.platform === 'win32' ? n.toLowerCase() : n;
+}
+//# sourceMappingURL=detectchanges.js.map

package/dist/indexer/detectchanges.js.map

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

package/dist/indexer/discovery.d.ts

@@ -0,0 +1,37 @@
+export interface DiscoveredFile {
+    absolutePath: string;
+    relativePath: string;
+}
+/**
+ * Discovery mode controls how aggressively we filter directories/files before
+ * parsing. Modes are layered defaults — finer-grained `includeVendor` /
+ * `includeGenerated` toggles can still override the mode's vendor/generated
+ * decisions, and `.seerignore` rules apply on top of all of them.
+ *
+ *   - `full`     index everything we can parse (only build/meta and .git skipped)
+ *   - `standard` skip vendor + generated by default (current historical default)
+ *   - `fast`     standard + skip docs/examples/static/assets/migrations — aimed
+ *                at iterative agent loops where most non-source dirs are dead
+ *                weight
+ *
+ * Default is `standard`; `fast` is a deliberate opt-in for power users on
+ * very large repos where they want indexing as cheap as possible.
+ */
+export type DiscoveryMode = 'full' | 'standard' | 'fast';
+export interface DiscoveryOptions {
+    /**
+     * If true, vendored / generated directories that the default ignore list
+     * would skip are included in discovery. Vendored/generated classification
+     * still happens at index time — this just lets the user inspect what
+     * Seer would normally hide. Off by default; the README and master guide
+     * describe this as the "I really do want vendored code" escape hatch.
+     */
+    includeVendor?: boolean;
+    includeGenerated?: boolean;
+    /**
+     * Discovery aggressiveness. Defaults to 'standard'. See `DiscoveryMode`.
+     */
+    mode?: DiscoveryMode;
+}
+export declare function discoverFiles(repoRoot: string, options?: DiscoveryOptions): Promise<DiscoveredFile[]>;
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/indexer/discovery.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;OAEG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAoED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAkE/G"}

package/dist/indexer/discovery.js

@@ -0,0 +1,136 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverFiles = discoverFiles;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const ignore_1 = __importDefault(require("ignore"));
+const fast_glob_1 = __importDefault(require("fast-glob"));
+// Globally-skipped paths that are never source code (build outputs, IDE
+// state, VCS metadata). These are unconditional — `includeVendor` /
+// `includeGenerated` do NOT re-enable them. The user can override by adding
+// a `!pattern` line in `.seerignore`.
+const BUILD_AND_META_IGNORE = [
+    'node_modules', '.git', '.hg', '.svn',
+    'dist', 'build', 'out', '.next', '.nuxt', '__pycache__',
+    '*.min.js', '*.min.css', '*.bundle.js',
+    '*.lock', 'package-lock.json', 'yarn.lock', 'pnpm-lock.yaml',
+    // Build outputs across other ecosystems. `target/` is universally Rust
+    // (`cargo build`), `obj/` is .NET, `cmake-build-*` is JetBrains/CLion,
+    // `_build/` is Erlang/Elixir and some doc generators. Not adding `bin/`
+    // here — TypeScript-main and others keep entry scripts there.
+    'target/**', '**/target/**',
+    'obj/**', '**/obj/**',
+    'cmake-build-*/**', '**/cmake-build-*/**',
+    '_build/**', '**/_build/**',
+    '.gradle/**', '**/.gradle/**',
+    '.cache/**',
+    '.idea/**', '.vs/**',
+    // Unreal-specific build outputs (won't exist in a clean checkout but cheap
+    // to add defensively for users who built before indexing).
+    'Intermediate/**', '**/Intermediate/**',
+    'Saved/**', '**/Saved/**',
+    'DerivedDataCache/**',
+];
+// Vendored dependency roots — discovery-time skip by default, but classified
+// even when included. Match both the top level and any nested depth (Godot
+// uses `thirdparty/`, Unreal uses `Engine/Source/ThirdParty/`, etc.).
+const VENDOR_IGNORE = [
+    'vendor/**', '**/vendor/**',
+    'vendored/**', '**/vendored/**',
+    'Vendored/**', '**/Vendored/**',
+    'third_party/**', '**/third_party/**',
+    'thirdparty/**', '**/thirdparty/**',
+    'ThirdParty/**', '**/ThirdParty/**',
+];
+// Generated-code patterns that don't earn a place in default indexing. Same
+// "skip-by-default, classify-when-included" model as vendored code.
+const GENERATED_IGNORE = [
+    '*.pb.go', '*.pb.ts', '*.pb.h', '*.pb.cc',
+    '*.generated.h', '*.gen.cpp', '*.gen.h',
+];
+// Extra skips active only under `--mode fast`. These directories rarely
+// contain source code that contributes to the call graph — examples are
+// either demos that re-import from src, docs/static/assets are non-code, and
+// migrations are usually flat SQL or schema-only Python. Skipping them in
+// fast mode trims discovery and parse cost meaningfully on large monorepos.
+// Conservative on purpose: anything that might contain real call edges
+// (`tests/`, `src/`, `lib/`) stays indexed even in fast mode.
+const FAST_MODE_EXTRA_IGNORE = [
+    'docs/**', '**/docs/**',
+    'examples/**', '**/examples/**',
+    'example/**', '**/example/**',
+    'assets/**', '**/assets/**',
+    'static/**', '**/static/**',
+    'public/**', '**/public/**',
+    'media/**', '**/media/**',
+    'fixtures/**', '**/fixtures/**',
+    'testdata/**', '**/testdata/**',
+    'migrations/**', '**/migrations/**',
+];
+async function discoverFiles(repoRoot, options = {}) {
+    const absRoot = path_1.default.resolve(repoRoot);
+    const mode = options.mode ?? 'standard';
+    // `full` mode flips both include flags ON regardless of caller intent. We
+    // still honor explicit `includeVendor=false` from a caller, but the typical
+    // use of `--mode full` is "index literally everything", so the default
+    // there is to include them.
+    const includeVendor = options.includeVendor ?? (mode === 'full');
+    const includeGenerated = options.includeGenerated ?? (mode === 'full');
+    const skip = [...BUILD_AND_META_IGNORE];
+    if (!includeVendor)
+        skip.push(...VENDOR_IGNORE);
+    if (!includeGenerated)
+        skip.push(...GENERATED_IGNORE);
+    if (mode === 'fast')
+        skip.push(...FAST_MODE_EXTRA_IGNORE);
+    // Build ignore rules from .gitignore + optional .seerignore. The two are
+    // separate intentionally — .gitignore controls what's committed (often
+    // includes build outputs that we ALSO want hidden) while .seerignore is
+    // for repo-specific tweaks that don't belong in version control rules
+    // (e.g. "don't index our `examples/` folder").
+    const ig = (0, ignore_1.default)();
+    const gitignorePath = path_1.default.join(absRoot, '.gitignore');
+    if (fs_1.default.existsSync(gitignorePath)) {
+        ig.add(fs_1.default.readFileSync(gitignorePath, 'utf8'));
+    }
+    const seerignorePath = path_1.default.join(absRoot, '.seerignore');
+    if (fs_1.default.existsSync(seerignorePath)) {
+        ig.add(fs_1.default.readFileSync(seerignorePath, 'utf8'));
+    }
+    // Glob for source files in supported languages
+    const entries = await (0, fast_glob_1.default)([
+        '**/*.py', '**/*.pyw',
+        '**/*.ts', '**/*.tsx',
+        '**/*.js', '**/*.jsx', '**/*.mjs', '**/*.cjs',
+        '**/*.go',
+        '**/*.java',
+        '**/*.rs',
+        '**/*.c',
+        '**/*.cpp', '**/*.cc', '**/*.cxx', '**/*.c++',
+        '**/*.hpp', '**/*.hh', '**/*.h++', '**/*.h',
+        '**/*.cs',
+    ], {
+        cwd: absRoot,
+        ignore: skip,
+        onlyFiles: true,
+        followSymbolicLinks: false,
+        dot: false,
+    });
+    // Stable order across runs is a correctness requirement: file IDs are
+    // AUTOINCREMENT, and tests/scale invariants depend on the same input
+    // producing the same IDs. `fast-glob` on Windows returns files in MFT/
+    // FS-cache order, which is not stable run-to-run. Sort here so every
+    // downstream stage — the byte semaphore window, parser-worker dispatch,
+    // SQLite inserts — sees the same sequence on every invocation.
+    return entries
+        .filter(rel => !ig.ignores(rel))
+        .sort()
+        .map(rel => ({
+        absolutePath: path_1.default.join(absRoot, rel),
+        relativePath: rel,
+    }));
+}
+//# sourceMappingURL=discovery.js.map

package/dist/indexer/discovery.js.map

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

package/dist/indexer/externaldeps.d.ts

@@ -0,0 +1,18 @@
+import { Store } from '../db/store.js';
+/**
+ * Walk the repo for known package manifests and emit one row per declared
+ * dependency. Idempotent: clears `external_dependencies` and re-inserts every
+ * call, so deletions in package.json are reflected on the next index.
+ *
+ * Supported ecosystems:
+ *   npm    package.json / package-lock.json / pnpm-lock.yaml (deps only)
+ *   cargo  Cargo.toml (Cargo.lock not parsed — duplicates would be noisy)
+ *   pypi   requirements.txt, pyproject.toml (PEP 621 [project.dependencies])
+ *   go     go.mod
+ *
+ * Manifest discovery uses fast-glob with the same ignores as the rest of the
+ * indexer (no node_modules, no vendor) so monorepos can be picked up from
+ * `packages/foo/package.json`.
+ */
+export declare function extractExternalDependencies(repoRoot: string, store: Store): Promise<number>;
+//# sourceMappingURL=externaldeps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"externaldeps.d.ts","sourceRoot":"","sources":["../../src/indexer/externaldeps.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CA8CjG"}