seer-mcp 0.1.0

package/dist/indexer/context.d.ts

@@ -0,0 +1,176 @@
+import { Store } from '../db/store.js';
+import { RiskResult } from './risk.js';
+/**
+ * One compact, structured pre-edit packet for a symbol.
+ *
+ * The aim is workflow compression: an agent that's about to edit a symbol
+ * should be able to call ONE tool and get back the deterministic evidence
+ * it needs — definition, callers, callees, routes, config reads, behavioral
+ * tests, recent history, complexity, module, blast radius, and the
+ * decomposed risk score. The agent then decides which slices to expand
+ * (`seer_history` for full chain, `seer_callers` for everyone, etc.).
+ *
+ * This is intentionally NOT an explanation layer. Seer-Core stays
+ * deterministic facts only; any narrative about "why this matters" belongs
+ * outside Core.
+ */
+export interface ContextPacket {
+    symbol: {
+        id: number;
+        name: string;
+        qualifiedName: string | null;
+        kind: string;
+        file: string;
+        lineStart: number;
+        lineEnd: number;
+        signature: string | null;
+        pagerank: number;
+        symbolRole: string | null;
+    };
+    module: {
+        id: number;
+        label: string;
+    } | null;
+    /** v10 — monorepo boundary the symbol's file belongs to (null when none). */
+    boundary: {
+        id: number;
+        label: string;
+        kind: string;
+        rootRelPath: string;
+    } | null;
+    complexity: {
+        loc: number | null;
+        cyclomatic: number | null;
+        cognitive: number | null;
+        maxNesting: number | null;
+    };
+    callers: {
+        total: number;
+        preview: Array<{
+            name: string;
+            qualifiedName: string | null;
+            kind: string;
+            file: string;
+            line: number;
+        }>;
+    };
+    callees: {
+        total: number;
+        preview: Array<{
+            name: string;
+            kind: string | null;
+            file: string | null;
+            line: number | null;
+        }>;
+    };
+    blastRadius: {
+        directCallers: number;
+        transitiveCallers: number;
+        /** Sample of the highest-PageRank reverse-reachable callers (capped). */
+        topAffected: Array<{
+            id: number;
+            name: string;
+            qualifiedName: string | null;
+            file: string;
+            pagerank: number;
+        }>;
+        maxDepth: number;
+    };
+    routes: Array<{
+        method: string;
+        path: string;
+        framework: string;
+    }>;
+    configKeys: Array<{
+        key: string;
+        source: string;
+        line: number;
+    }>;
+    /**
+     * v8 Track-G — outbound service calls this symbol makes (preview, capped).
+     * Empty array on Pre-Track-G DBs or symbols with no outgoing client calls.
+     */
+    serviceCalls: Array<{
+        method: string | null;
+        path: string | null;
+        framework: string;
+        rawTarget: string;
+        line: number;
+        envKey: string | null;
+        hostHint: string | null;
+        confidence: number;
+    }>;
+    /**
+     * v8 Track-G — service-link evidence pointing at this symbol as the handler
+     * (inbound) and as the caller (outbound). Capped previews.
+     */
+    serviceLinksInbound: Array<{
+        routePath: string | null;
+        method: string | null;
+        matchKind: string;
+        confidence: number;
+        callerName: string | null;
+        callerFile: string | null;
+    }>;
+    serviceLinksOutbound: Array<{
+        routePath: string | null;
+        method: string | null;
+        matchKind: string;
+        confidence: number;
+        handlerName: string | null;
+        handlerFile: string | null;
+    }>;
+    behavior: {
+        direct: number;
+        indirect: number;
+        namingMatches: number;
+        sameFileMatches: number;
+        preview: Array<{
+            name: string;
+            qualifiedName: string | null;
+            file: string;
+            lineStart: number;
+            relationship: string;
+            assertionCount: number;
+            specificity: number;
+        }>;
+    };
+    recentHistory: {
+        total: number;
+        preview: Array<{
+            sha: string;
+            author: string | null;
+            email: string | null;
+            committedAt: number;
+            message: string | null;
+            linesAdded: number;
+            linesRemoved: number;
+            prNumber: number | null;
+            prUrl: string | null;
+            confidence: number;
+        }>;
+    };
+    fileChurn: {
+        commitCount: number;
+        lastCommitAt: number | null;
+        topAuthor: string | null;
+    } | null;
+    risk: {
+        risk: 'low' | 'medium' | 'high';
+        score: number;
+        signals: RiskResult['signals'];
+        signalContributions: RiskResult['signalContributions'];
+    };
+    source: 'tree-sitter';
+}
+export interface ContextOptions {
+    filePath?: string;
+    callerLimit?: number;
+    calleeLimit?: number;
+    testLimit?: number;
+    historyLimit?: number;
+    callerDepth?: number;
+    affectedLimit?: number;
+}
+export declare function buildContext(store: Store, nameOrId: string | number, options?: ContextOptions): ContextPacket | null;
+//# sourceMappingURL=context.d.ts.map

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

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

package/dist/indexer/context.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildContext = buildContext;
+const behavior_js_1 = require("./behavior.js");
+const risk_js_1 = require("./risk.js");
+function buildContext(store, nameOrId, options = {}) {
+    const callerLimit = options.callerLimit ?? 10;
+    const calleeLimit = options.calleeLimit ?? 10;
+    const testLimit = options.testLimit ?? 10;
+    const historyLimit = options.historyLimit ?? 5;
+    const callerDepth = options.callerDepth ?? 3;
+    const affectedLimit = options.affectedLimit ?? 10;
+    let target = null;
+    if (typeof nameOrId === 'number') {
+        target = store.getSymbolById(nameOrId);
+    }
+    else {
+        const defs = store.getDefinition(nameOrId, { filePath: options.filePath });
+        if (defs.length === 0)
+            return null;
+        target = defs[0];
+    }
+    if (!target)
+        return null;
+    // Callers + callees use the id-based path so short-name siblings
+    // (Alpha.run vs Beta.run) don't share evidence. The legacy name-based
+    // APIs (findCallers / countCallers / findCallees) intentionally stay
+    // broad for the agent-facing CLI tools — Track E packets always have a
+    // resolved id and should never collapse.
+    const totalCallers = store.countCallersById(target.id);
+    const directCallers = store.findCallersById(target.id, callerLimit);
+    const allCallees = store.findCalleesById(target.id);
+    const calleesPreview = allCallees.slice(0, calleeLimit);
+    // Blast radius.
+    const reverseHits = store.reverseReachableWithDepth(target.id, callerDepth);
+    const directRows = store.rawDb().prepare("SELECT DISTINCT from_id FROM edges WHERE to_id = ? AND kind = 'call'").all(target.id);
+    const directSet = new Set(directRows.map(r => Number(r.from_id)));
+    const transitive = reverseHits.filter(h => !directSet.has(h.id));
+    let topAffected = [];
+    if (reverseHits.length > 0) {
+        const ids = reverseHits.map(h => h.id);
+        const ph = ids.map(() => '?').join(',');
+        const rows = store.rawDb().prepare(`
+      SELECT s.id, s.name, s.qualified_name AS qualifiedName, f.path AS file, s.pagerank
+      FROM symbols s JOIN files f ON f.id = s.file_id
+      WHERE s.id IN (${ph}) AND s.is_rankable = 1
+      ORDER BY s.pagerank DESC
+      LIMIT ?
+    `).all(...ids, affectedLimit);
+        topAffected = rows.map(r => ({
+            id: Number(r.id),
+            name: String(r.name),
+            qualifiedName: r.qualifiedName == null ? null : String(r.qualifiedName),
+            file: String(r.file),
+            pagerank: Number(r.pagerank),
+        }));
+    }
+    // Routes / config / behavior / history.
+    const routes = store.routesForHandler(target.id);
+    const configKeys = store.configKeysForSymbol(target.id);
+    const behavior = (0, behavior_js_1.rankedBehavior)(store, target.id, { limit: testLimit });
+    // v8 Track-G — service-link evidence. Capped previews so the packet stays
+    // compact even when the symbol is a hub.
+    const SERVICE_CALL_PREVIEW_CAP = 12;
+    const SERVICE_LINK_PREVIEW_CAP = 12;
+    const serviceCallsRows = store.listServiceCalls({
+        callerSymbolId: target.id, limit: SERVICE_CALL_PREVIEW_CAP,
+    });
+    const serviceLinksInbound = store.serviceLinksForHandler(target.id, { limit: SERVICE_LINK_PREVIEW_CAP });
+    const serviceLinksOutbound = store.serviceLinksForCaller(target.id, { limit: SERVICE_LINK_PREVIEW_CAP });
+    const history = store.getSymbolHistory(target.id, { limit: historyLimit });
+    const totalHistory = store.countSymbolHistory(target.id);
+    const fileChurn = (() => {
+        try {
+            const c = store.getFileChurn(target.filePath);
+            if (!c)
+                return null;
+            return { commitCount: c.commitCount, lastCommitAt: c.lastCommitAt, topAuthor: c.topAuthor };
+        }
+        catch {
+            return null;
+        }
+    })();
+    // Risk (reuses behavior + history + signals computed above; cheaper to
+    // recompute than to share through a back-channel.)
+    const risk = (0, risk_js_1.computeRisk)(store, target.id, { callerDepth });
+    const moduleRow = store.moduleForFile(target.fileId);
+    const boundaryRow = store.boundaryForFile(target.fileId);
+    return {
+        symbol: {
+            id: target.id, name: target.name, qualifiedName: target.qualifiedName,
+            kind: target.kind, file: target.filePath,
+            lineStart: target.lineStart, lineEnd: target.lineEnd,
+            signature: target.signature, pagerank: target.pagerank,
+            symbolRole: target.symbolRole ?? null,
+        },
+        module: moduleRow,
+        boundary: boundaryRow,
+        complexity: {
+            loc: target.loc ?? null,
+            cyclomatic: target.cyclomatic ?? null,
+            cognitive: target.cognitive ?? null,
+            maxNesting: target.maxNesting ?? null,
+        },
+        callers: {
+            total: totalCallers,
+            preview: directCallers.map(c => ({
+                name: c.callerName, qualifiedName: c.callerQualifiedName, kind: c.callerKind,
+                file: c.callerFile, line: c.callerLine,
+            })),
+        },
+        callees: {
+            total: allCallees.length,
+            preview: calleesPreview.map(c => ({
+                name: c.calleeName, kind: c.calleeKind,
+                file: c.calleeFile, line: c.calleeLineStart,
+            })),
+        },
+        blastRadius: {
+            directCallers: directSet.size,
+            transitiveCallers: transitive.length,
+            topAffected,
+            maxDepth: callerDepth,
+        },
+        routes,
+        configKeys,
+        serviceCalls: serviceCallsRows.map(sc => ({
+            method: sc.method,
+            path: sc.normalizedPath,
+            framework: sc.framework,
+            rawTarget: sc.rawTarget,
+            line: sc.line,
+            envKey: sc.envKey,
+            hostHint: sc.hostHint,
+            confidence: sc.confidence,
+        })),
+        serviceLinksInbound: serviceLinksInbound.map(l => ({
+            routePath: l.routePath,
+            method: l.routeMethod ?? l.callMethod,
+            matchKind: l.matchKind,
+            confidence: l.confidence,
+            callerName: l.callerQualifiedName ?? l.callerName,
+            callerFile: l.callerFile,
+        })),
+        serviceLinksOutbound: serviceLinksOutbound.map(l => ({
+            routePath: l.routePath,
+            method: l.routeMethod ?? l.callMethod,
+            matchKind: l.matchKind,
+            confidence: l.confidence,
+            handlerName: l.handlerQualifiedName ?? l.handlerName,
+            handlerFile: l.handlerFile,
+        })),
+        behavior: {
+            direct: behavior?.direct ?? 0,
+            indirect: behavior?.indirect ?? 0,
+            namingMatches: behavior?.namingMatches ?? 0,
+            sameFileMatches: behavior?.sameFileMatches ?? 0,
+            preview: (behavior?.tests ?? []).map(t => ({
+                name: t.testSymbol.name,
+                qualifiedName: t.testSymbol.qualifiedName,
+                file: t.testSymbol.file,
+                lineStart: t.testSymbol.lineStart,
+                relationship: t.relationship,
+                assertionCount: t.assertionCount,
+                specificity: t.specificity,
+            })),
+        },
+        recentHistory: {
+            total: totalHistory,
+            preview: history.map(h => ({
+                sha: h.commitSha,
+                author: h.authorName,
+                email: h.authorEmail,
+                committedAt: h.committedAt,
+                message: h.message,
+                linesAdded: h.linesAdded,
+                linesRemoved: h.linesRemoved,
+                prNumber: h.prNumber,
+                prUrl: h.prUrl,
+                confidence: h.confidence,
+            })),
+        },
+        fileChurn,
+        risk: {
+            risk: risk.risk,
+            score: risk.score,
+            signals: risk.signals,
+            signalContributions: risk.signalContributions,
+        },
+        source: 'tree-sitter',
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/indexer/context.js.map

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

package/dist/indexer/continuity.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 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.
+ */
+import { Store } from '../db/store.js';
+export interface ContinuityCandidate {
+    symbolId: number;
+    symbolKey: string;
+    previousSymbolKey: string;
+    previousName: string;
+    previousFile: string;
+    confidence: number;
+    matchReasons: string[];
+}
+export interface ContinuityResult {
+    candidatesConsidered: number;
+    inserted: number;
+    skipped: number;
+    elapsedMs: number;
+}
+/**
+ * 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).
+ */
+export declare function buildContinuity(store: Store, options?: {
+    historyThreshold?: number;
+    maxHammingDistance?: number;
+    log?: (msg: string) => void;
+    /** When true, also create candidate links for symbols that have full history
+     *  (useful for fixture tests and debugging). Default false. */
+    includeAllSymbols?: boolean;
+}): ContinuityResult;
+/**
+ * Fetch continuity rows for a given symbol id, ordered by confidence desc.
+ */
+export declare function getContinuityForSymbol(store: Store, symbolId: number): Array<{
+    previousSymbolKey: string;
+    previousName: string;
+    previousFile: string;
+    confidence: number;
+    matchReasons: string[];
+}>;
+//# sourceMappingURL=continuity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"continuity.d.ts","sourceRoot":"","sources":["../../src/indexer/continuity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE;IACP,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B;mEAC+D;IAC/D,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACxB,GACL,gBAAgB,CAmIlB;AAsFD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAC7B,KAAK,CAAC;IACP,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC,CAuBD"}