seer-mcp 0.1.0

package/dist/indexer/risk.d.ts

@@ -0,0 +1,115 @@
+import { Store } from '../db/store.js';
+/**
+ * Deterministic edit-risk profile for a symbol.
+ *
+ * Risk is decomposed: every signal that contributes is returned alongside
+ * the score so an agent can see WHY the verdict is "high" instead of
+ * trusting the number. The exit criteria for Track-E explicitly call this
+ * out: "seer_risk returns decomposed deterministic signals, not unexplained
+ * vibes."
+ *
+ * Signals (with deterministic weights):
+ *   directCallers           +1 per caller up to 30
+ *   transitiveCallers       +ln(1 + transitive) * 4   (bounded BFS, depth 3)
+ *   routeExposed            +20 if symbol is a route handler
+ *   directTests             -10 per direct test, capped at -30 (good coverage
+ *                                                                 reduces risk)
+ *   indirectTests           -2 per indirect test, capped at -8
+ *   assertionCount          -2 per assertion across direct tests, capped at -10
+ *   recentCommits           +ln(1 + history.length) * 4
+ *   distinctAuthors         +3 per distinct author beyond 1, capped at +15
+ *   cyclomatic              max(0, cyclomatic - 8) * 1
+ *   cognitive               max(0, cognitive - 12) * 0.5
+ *   configKeys              +3 per distinct config key, capped at +15
+ *   moduleBoundaryCrossings +2 per distinct neighboring module, capped at +20
+ *
+ * The score is bucketed into `low` (<20), `medium` (<50), or `high` (>=50).
+ * The thresholds are conservative — easy to bias toward "high" — so the
+ * agent gets shown evidence even when the verdict is in doubt.
+ */
+export interface RiskSignals {
+    directCallers: number;
+    transitiveCallers: number;
+    routeExposed: boolean;
+    routes: Array<{
+        method: string;
+        path: string;
+        framework: string;
+    }>;
+    directTests: number;
+    indirectTests: number;
+    assertionCount: number;
+    recentCommits: number;
+    distinctAuthors: number;
+    cyclomatic: number | null;
+    cognitive: number | null;
+    configKeys: number;
+    moduleBoundaryCrossings: number;
+    /**
+     * v8 Track-G — number of distinct outbound service calls this symbol makes
+     * (e.g. fetch/axios.get calls). Higher = symbol depends on more external
+     * services, which is a real risk surface for edits.
+     */
+    outboundServiceCalls: number;
+    /**
+     * v8 Track-G — number of inbound service_links pointing at this symbol as
+     * the handler. Higher = changes here likely affect other services.
+     */
+    inboundServiceLinks: number;
+    /**
+     * v8 Track-G — number of service_links whose handler lives in a different
+     * module than the caller. Cross-module client/handler dependency is a sign
+     * of architectural distance and risk.
+     */
+    crossModuleServiceLinks: number;
+    /**
+     * v8 Track-G — service_links involving this symbol whose match_kind is
+     * route_pattern (not literal_path). Pattern-only matches carry residual
+     * ambiguity and are worth surfacing as a soft signal.
+     */
+    ambiguousServiceLinks: number;
+    /**
+     * v10 — number of distinct neighboring boundaries this symbol's call graph
+     * reaches OUT of its own boundary. Advisory; never raises the verdict by
+     * itself.
+     */
+    boundaryCrossings: number;
+}
+export interface RiskResult {
+    symbol: {
+        id: number;
+        name: string;
+        qualifiedName: string | null;
+        kind: string;
+        file: string;
+        lineStart: number;
+        lineEnd: number;
+    };
+    risk: 'low' | 'medium' | 'high';
+    score: number;
+    signals: RiskSignals;
+    signalContributions: Array<{
+        signal: string;
+        value: number;
+        contribution: number;
+    }>;
+    /** Module the symbol's file belongs to, when clustering has run. */
+    module: {
+        id: number;
+        label: string;
+    } | null;
+    /** v10 boundary the symbol's file belongs to. NULL when none detected. */
+    boundary: {
+        id: number;
+        label: string;
+        kind: string;
+        rootRelPath: string;
+    } | null;
+    source: 'tree-sitter';
+}
+interface RiskOptions {
+    callerDepth?: number;
+}
+export declare function computeRisk(store: Store, nameOrId: string | number, options?: RiskOptions): RiskResult | null;
+export {};
+//# sourceMappingURL=risk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"risk.d.ts","sourceRoot":"","sources":["../../src/indexer/risk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAIvC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB,EAAE,MAAM,CAAC;IAChC;;;;OAIG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,uBAAuB,EAAE,MAAM,CAAC;IAChC;;;;OAIG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,mBAAmB,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpF,oEAAoE;IACpE,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7C,0EAA0E;IAC1E,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClF,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,UAAU,WAAW;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,OAAO,GAAE,WAAgB,GACxB,UAAU,GAAG,IAAI,CA0InB"}

package/dist/indexer/risk.js

@@ -0,0 +1,194 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeRisk = computeRisk;
+const behavior_js_1 = require("./behavior.js");
+function computeRisk(store, nameOrId, options = {}) {
+    const callerDepth = options.callerDepth ?? 3;
+    let target = null;
+    if (typeof nameOrId === 'number') {
+        target = store.getSymbolById(nameOrId);
+    }
+    else {
+        const defs = store.getDefinition(nameOrId);
+        if (defs.length === 0)
+            return null;
+        target = defs[0];
+    }
+    if (!target)
+        return null;
+    // Direct + transitive callers (call graph fan-in).
+    // ID-based count so short-name siblings (Alpha.run vs Beta.run) don't
+    // inflate this symbol's fan-in.
+    const directCallers = store.countCallersById(target.id);
+    const transitiveRows = store.reverseReachableWithDepth(target.id, callerDepth);
+    // Exclude direct callers from the transitive count so we don't double-count.
+    const transitiveCallers = transitiveRows.filter(r => r.depth > 1).length;
+    // Route exposure.
+    const routes = store.routesForHandler(target.id);
+    const routeExposed = routes.length > 0;
+    // Behavioral coverage — reuse the ranked behavior since it already does
+    // direct vs indirect deduplication and assertion counting.
+    const behavior = (0, behavior_js_1.rankedBehavior)(store, target.id, { limit: 200 });
+    const directTests = behavior?.direct ?? 0;
+    const indirectTests = behavior?.indirect ?? 0;
+    const assertionCount = sumAssertions(behavior);
+    // Symbol history.
+    const historyRows = store.getSymbolHistory(target.id, { limit: 200 });
+    const recentCommits = historyRows.length;
+    const distinctAuthors = new Set(historyRows.map(h => (h.authorEmail ?? h.authorName ?? '').toLowerCase()).filter(s => s)).size;
+    // Complexity.
+    const cyclomatic = target.cyclomatic ?? null;
+    const cognitive = target.cognitive ?? null;
+    // Config reads.
+    const configKeys = store.configKeysForSymbol(target.id).length;
+    // Module-boundary crossings: how many distinct neighbor modules this
+    // symbol's call graph reaches OUT of its own module.
+    const myFileModule = store.moduleForFile(target.fileId);
+    let moduleBoundaryCrossings = 0;
+    if (myFileModule) {
+        const neighborModules = new Set(store.calleeModulesOf(target.id)
+            .filter(m => m.moduleId !== myFileModule.id)
+            .map(m => m.moduleId));
+        moduleBoundaryCrossings = neighborModules.size;
+    }
+    // v8 Track-G service-link signals.
+    let outboundServiceCalls = 0;
+    let inboundServiceLinks = 0;
+    let crossModuleServiceLinks = 0;
+    let ambiguousServiceLinks = 0;
+    try {
+        outboundServiceCalls = store.listServiceCalls({ callerSymbolId: target.id, limit: 1000 }).length;
+    }
+    catch { /* */ }
+    try {
+        const inbound = store.serviceLinksForHandler(target.id, { limit: 1000 });
+        inboundServiceLinks = inbound.length;
+        ambiguousServiceLinks += inbound.filter(l => l.matchKind === 'route_pattern').length;
+        if (myFileModule) {
+            for (const link of inbound) {
+                if (link.callerSymbolId == null)
+                    continue;
+                const callerSym = store.getSymbolById(link.callerSymbolId);
+                if (!callerSym)
+                    continue;
+                const callerMod = store.moduleForFile(callerSym.fileId);
+                if (callerMod && callerMod.id !== myFileModule.id)
+                    crossModuleServiceLinks++;
+            }
+        }
+    }
+    catch { /* */ }
+    try {
+        const outbound = store.serviceLinksForCaller(target.id, { limit: 1000 });
+        ambiguousServiceLinks += outbound.filter(l => l.matchKind === 'route_pattern').length;
+        if (myFileModule) {
+            for (const link of outbound) {
+                if (link.handlerSymbolId == null)
+                    continue;
+                const handlerSym = store.getSymbolById(link.handlerSymbolId);
+                if (!handlerSym)
+                    continue;
+                const handlerMod = store.moduleForFile(handlerSym.fileId);
+                if (handlerMod && handlerMod.id !== myFileModule.id)
+                    crossModuleServiceLinks++;
+            }
+        }
+    }
+    catch { /* */ }
+    // v10 — boundary crossings (calls into another package/service boundary).
+    let boundaryCrossings = 0;
+    const myBoundary = store.boundaryForFile(target.fileId);
+    if (myBoundary) {
+        const neighborBoundaries = new Set(store.calleeBoundariesOf(target.id)
+            .filter(b => b.boundaryId !== myBoundary.id)
+            .map(b => b.boundaryId));
+        boundaryCrossings = neighborBoundaries.size;
+    }
+    const signals = {
+        directCallers, transitiveCallers, routeExposed, routes,
+        directTests, indirectTests, assertionCount,
+        recentCommits, distinctAuthors,
+        cyclomatic, cognitive,
+        configKeys, moduleBoundaryCrossings,
+        outboundServiceCalls, inboundServiceLinks,
+        crossModuleServiceLinks, ambiguousServiceLinks,
+        boundaryCrossings,
+    };
+    const contributions = scoreContributions(signals);
+    const score = contributions.reduce((acc, c) => acc + c.contribution, 0);
+    const risk = score >= 50 ? 'high' : score >= 20 ? 'medium' : 'low';
+    return {
+        symbol: {
+            id: target.id,
+            name: target.name,
+            qualifiedName: target.qualifiedName,
+            kind: target.kind,
+            file: target.filePath,
+            lineStart: target.lineStart,
+            lineEnd: target.lineEnd,
+        },
+        risk, score, signals,
+        signalContributions: contributions,
+        module: myFileModule,
+        boundary: myBoundary,
+        source: 'tree-sitter',
+    };
+}
+function sumAssertions(b) {
+    if (!b)
+        return 0;
+    let n = 0;
+    for (const t of b.tests) {
+        if (t.relationship === 'direct-call')
+            n += t.assertionCount;
+    }
+    return n;
+}
+function scoreContributions(s) {
+    const out = [];
+    out.push({ signal: 'directCallers', value: s.directCallers,
+        contribution: Math.min(30, s.directCallers) });
+    out.push({ signal: 'transitiveCallers', value: s.transitiveCallers,
+        contribution: Math.log1p(s.transitiveCallers) * 4 });
+    out.push({ signal: 'routeExposed', value: s.routeExposed ? 1 : 0,
+        contribution: s.routeExposed ? 20 : 0 });
+    // Coverage reduces risk (negative contribution).
+    out.push({ signal: 'directTests', value: s.directTests,
+        contribution: -Math.min(30, s.directTests * 10) });
+    out.push({ signal: 'indirectTests', value: s.indirectTests,
+        contribution: -Math.min(8, s.indirectTests * 2) });
+    out.push({ signal: 'assertionCount', value: s.assertionCount,
+        contribution: -Math.min(10, s.assertionCount * 2) });
+    out.push({ signal: 'recentCommits', value: s.recentCommits,
+        contribution: Math.log1p(s.recentCommits) * 4 });
+    out.push({ signal: 'distinctAuthors', value: s.distinctAuthors,
+        contribution: s.distinctAuthors <= 1 ? 0 : Math.min(15, (s.distinctAuthors - 1) * 3) });
+    out.push({ signal: 'cyclomatic', value: s.cyclomatic ?? 0,
+        contribution: s.cyclomatic == null ? 0 : Math.max(0, s.cyclomatic - 8) });
+    out.push({ signal: 'cognitive', value: s.cognitive ?? 0,
+        contribution: s.cognitive == null ? 0 : Math.max(0, s.cognitive - 12) * 0.5 });
+    out.push({ signal: 'configKeys', value: s.configKeys,
+        contribution: Math.min(15, s.configKeys * 3) });
+    out.push({ signal: 'moduleBoundaryCrossings', value: s.moduleBoundaryCrossings,
+        contribution: Math.min(20, s.moduleBoundaryCrossings * 2) });
+    // v8 Track-G — service-link contributions. Conservative weights so they
+    // surface as evidence without dominating the score on small fixtures.
+    out.push({ signal: 'outboundServiceCalls', value: s.outboundServiceCalls,
+        contribution: Math.min(10, s.outboundServiceCalls * 2) });
+    out.push({ signal: 'inboundServiceLinks', value: s.inboundServiceLinks,
+        contribution: Math.min(15, s.inboundServiceLinks * 3) });
+    out.push({ signal: 'crossModuleServiceLinks', value: s.crossModuleServiceLinks,
+        contribution: Math.min(10, s.crossModuleServiceLinks * 2) });
+    out.push({ signal: 'ambiguousServiceLinks', value: s.ambiguousServiceLinks,
+        contribution: Math.min(5, s.ambiguousServiceLinks * 1) });
+    // v10 boundary crossings — advisory weight: 1.5 per crossing, capped at 12.
+    out.push({ signal: 'boundaryCrossings', value: s.boundaryCrossings,
+        contribution: Math.min(12, s.boundaryCrossings * 1.5) });
+    // Round contributions for stable output.
+    return out.map(c => ({ ...c, contribution: roundTo(c.contribution, 2) }));
+}
+function roundTo(n, decimals) {
+    const f = Math.pow(10, decimals);
+    return Math.round(n * f) / f;
+}
+//# sourceMappingURL=risk.js.map

package/dist/indexer/risk.js.map

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

package/dist/indexer/serviceHostScanner.d.ts

@@ -0,0 +1,25 @@
+/**
+ * v9 Track-H — extract service hostnames from Kubernetes manifests and
+ * Docker Compose files.
+ *
+ * The result is a {hostname → file_path[]} map: e.g. "payment-service" was
+ * declared in `k8s/payment.yaml`. The resolver uses this to boost confidence
+ * on HTTP service_calls whose host_hint matches one of these names — it's
+ * evidence, not proof. We only emit a `service_host` link when the call's
+ * PATH also matches a route in the workspace (host alone is too noisy).
+ *
+ * The scanner is intentionally regex-based (no YAML parser dependency) and
+ * forgiving — it extracts top-level `name:` values from any document that
+ * looks like a `kind: Service` declaration, plus the keys of `services:` in
+ * Docker Compose. Unknown YAMLs are skipped silently.
+ */
+export interface ServiceHostMap {
+    /** lowercase hostname → list of file paths where it was declared */
+    hosts: Map<string, string[]>;
+}
+/**
+ * Scan a workspace for k8s/Docker service hostnames. Returns the empty map
+ * when none are found — callers should treat missing entries as "no boost".
+ */
+export declare function scanServiceHosts(absRoot: string): Promise<ServiceHostMap>;
+//# sourceMappingURL=serviceHostScanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serviceHostScanner.d.ts","sourceRoot":"","sources":["../../src/indexer/serviceHostScanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC9B;AAQD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAwD/E"}

package/dist/indexer/serviceHostScanner.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * v9 Track-H — extract service hostnames from Kubernetes manifests and
+ * Docker Compose files.
+ *
+ * The result is a {hostname → file_path[]} map: e.g. "payment-service" was
+ * declared in `k8s/payment.yaml`. The resolver uses this to boost confidence
+ * on HTTP service_calls whose host_hint matches one of these names — it's
+ * evidence, not proof. We only emit a `service_host` link when the call's
+ * PATH also matches a route in the workspace (host alone is too noisy).
+ *
+ * The scanner is intentionally regex-based (no YAML parser dependency) and
+ * forgiving — it extracts top-level `name:` values from any document that
+ * looks like a `kind: Service` declaration, plus the keys of `services:` in
+ * Docker Compose. Unknown YAMLs are skipped silently.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanServiceHosts = scanServiceHosts;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const K8S_SERVICE_RE = /(?:^|\n)\s*kind\s*:\s*Service[\s\S]*?(?:^|\n)\s*metadata\s*:[\s\S]*?(?:^|\n)\s*name\s*:\s*["']?([A-Za-z0-9_-]+)["']?/g;
+const COMPOSE_SERVICES_RE = /(?:^|\n)services\s*:\s*\n((?:[ \t]+[A-Za-z0-9_-][^\n]*\n?)+)/g;
+/**
+ * Scan a workspace for k8s/Docker service hostnames. Returns the empty map
+ * when none are found — callers should treat missing entries as "no boost".
+ */
+async function scanServiceHosts(absRoot) {
+    const entries = await (0, fast_glob_1.default)([
+        '**/*.yaml', '**/*.yml',
+        '**/docker-compose*.yml', '**/docker-compose*.yaml',
+    ], {
+        cwd: absRoot,
+        ignore: [
+            'node_modules/**', '.git/**', 'dist/**', 'build/**', 'out/**',
+            'vendor/**', '**/vendor/**', '**/__pycache__/**', '.next/**',
+        ],
+        onlyFiles: true, followSymbolicLinks: false, dot: false,
+    });
+    entries.sort();
+    const hosts = new Map();
+    const record = (name, filePath) => {
+        if (!name)
+            return;
+        const key = name.toLowerCase();
+        const list = hosts.get(key);
+        if (list) {
+            if (!list.includes(filePath))
+                list.push(filePath);
+        }
+        else
+            hosts.set(key, [filePath]);
+    };
+    for (const rel of entries) {
+        const abs = path_1.default.join(absRoot, rel);
+        let src;
+        try {
+            src = fs_1.default.readFileSync(abs, 'utf8');
+        }
+        catch {
+            continue;
+        }
+        // ── Kubernetes `kind: Service` ──────────────────────────────────────
+        K8S_SERVICE_RE.lastIndex = 0;
+        let m;
+        while ((m = K8S_SERVICE_RE.exec(src)) !== null)
+            record(m[1], rel);
+        // ── Docker Compose `services:` ─────────────────────────────────────
+        const isCompose = /(?:^|[/\\])docker-compose[^/\\]*\.ya?ml$/i.test(rel) ||
+            /(?:^|\n)version\s*:/m.test(src) && /(?:^|\n)services\s*:/m.test(src);
+        if (isCompose) {
+            COMPOSE_SERVICES_RE.lastIndex = 0;
+            let s;
+            while ((s = COMPOSE_SERVICES_RE.exec(src)) !== null) {
+                const block = s[1];
+                // Pull top-level service keys: lines like "  name:" with 2-4 space indent.
+                const lines = block.split('\n');
+                for (const line of lines) {
+                    const km = line.match(/^([ \t]+)([A-Za-z0-9_-]+)\s*:/);
+                    if (!km)
+                        continue;
+                    // Only first-level keys (consistent indent across the services block).
+                    // We accept indent ≤ 4 spaces / 1 tab.
+                    if (km[1].length <= 4)
+                        record(km[2], rel);
+                }
+            }
+        }
+    }
+    return { hosts };
+}
+//# sourceMappingURL=serviceHostScanner.js.map

package/dist/indexer/serviceHostScanner.js.map

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

package/dist/indexer/serviceLinks.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Track G — service-link resolver and helpers.
+ *
+ * Two concerns live here, kept independent so they can be unit-tested in
+ * isolation:
+ *
+ *   1. `normalizeHttpTarget(raw)` — turn a string captured at a client call
+ *      site (literal URL, template path, env-prefixed concat) into a
+ *      `{ path, hostHint, envKey }` triple where each field is undefined when
+ *      it can't be confidently recovered. Pure function; no DB access.
+ *
+ *   2. `routePatternsMatch(callPath, routePath)` — decide whether a literal
+ *      caller path matches a (possibly parameterised) framework route.
+ *      Returns a `{ matched, confidence, reason }` result so the resolver
+ *      can ranke evidence without recomputing it.
+ *
+ *   3. `resolveServiceLinks(store)` — the actual post-index resolver.
+ *      Wipes prior service_links, scans service_calls + routes, and inserts
+ *      one row per confident rendezvous.
+ *
+ * Deterministic by construction: the resolver runs candidates in id order
+ * and only emits a top match (with ambiguity recorded as evidence) so two
+ * runs of the same DB produce the same service_links rows.
+ */
+import type { Store } from '../db/store.js';
+import type { ServiceHostMap } from './serviceHostScanner.js';
+export type MatchKind = 'literal_path' | 'env_base' | 'service_host' | 'route_pattern' | 'trpc_procedure' | 'graphql_operation' | 'grpc_method' | 'topic_match' | 'queue_match' | 'exchange_match';
+export interface NormalizedTarget {
+    /** /api/users — leading slash, no scheme, no query, no fragment, no trailing slash (except "/"). */
+    path?: string;
+    /** payment-service / billing.svc.cluster.local / etc. */
+    hostHint?: string;
+    /** PAYMENT_URL — populated by the extractor when it saw env reference. */
+    envKey?: string;
+}
+/**
+ * Normalize an HTTP target captured at a client call site.
+ *
+ * Rules:
+ *   - strip scheme + host when literal (`https://payment/api/charge` → `/api/charge`, host = `payment`)
+ *   - keep route paths starting with '/'
+ *   - drop query string and fragment
+ *   - normalize trailing slash (but keep root '/'): '/api/users/' → '/api/users'
+ *   - drop empty paths
+ *   - do NOT collapse dynamic segments — that's the route-pattern matcher's job.
+ */
+export declare function normalizeHttpTarget(raw: string): NormalizedTarget;
+export interface PatternMatch {
+    matched: boolean;
+    /** 1.0 for exact path+method, 0.95 path only, 0.85 parameterised */
+    confidence: number;
+    /** Human-readable why; surfaced in evidence_json. */
+    reason: string;
+}
+/**
+ * Decide whether `callPath` (literal) satisfies a (possibly parameterised)
+ * `routePath` like `/users/:id`, `/users/{id}`, `/items/<int:n>`.
+ *
+ * No method check here — the resolver applies method comparison around this
+ * with method-mismatch falling back to a lower confidence.
+ *
+ * Returns matched=false when the segment count differs OR a literal segment
+ * differs. Parameter segments (`:x`, `{x}`, `<...:x>`) match any one segment.
+ */
+export declare function routePatternsMatch(callPath: string, routePath: string): PatternMatch;
+/**
+ * Compare two HTTP methods, treating 'ANY' (client unknown method) and route's
+ * absence of method as wildcards. Returns:
+ *   1.0 — methods match exactly (including both 'ANY')
+ *   0.9 — caller method known + route is ANY (or vice versa)
+ *   0.0 — explicit mismatch (e.g. POST vs GET)
+ */
+export declare function methodMatchScore(callMethod: string | null | undefined, routeMethod: string | null | undefined): number;
+/** Result returned by resolveServiceLinks. */
+export interface ResolveResult {
+    /** Total service_calls considered (after dropping ones with no path). */
+    callsConsidered: number;
+    /** New service_links rows inserted. */
+    linksInserted: number;
+    /** Counts by match_kind. */
+    byKind: Record<MatchKind, number>;
+    /** v9 Track-H — number of calls whose candidate set was truncated at the
+     *  ambiguity cap. Surfaced for telemetry / debug. */
+    truncated?: number;
+}
+/**
+ * Wipe service_links and rebuild from current service_calls + routes.
+ * Deterministic: orders candidates by id ascending and ties are broken by id.
+ *
+ * Match strategy:
+ *   1. literal_path  — call.path == route.path, method compatible
+ *   2. route_pattern — call.path matches a parameterised route, method compatible
+ *   3. env_base      — call carried an env key; we record the link only when
+ *                      the path *also* matches a route (env alone is not enough).
+ *
+ * S3 (service_host) — k8s/Docker host resolution — is provided by
+ * `scanServiceHosts()` and passed in as optional evidence.
+ */
+export declare function resolveServiceLinks(store: Store, options?: {
+    hostMap?: ServiceHostMap;
+}): ResolveResult;
+/** Apply the same normalization to a route path as to a call path so the
+ *  byExactPath comparison is symmetric (strip trailing slash, etc). */
+export declare function normalizeRoutePath(p: string): string;
+//# sourceMappingURL=serviceLinks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serviceLinks.d.ts","sourceRoot":"","sources":["../../src/indexer/serviceLinks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,MAAM,SAAS,GACjB,cAAc,GACd,UAAU,GACV,cAAc,GACd,eAAe,GAEf,gBAAgB,GAChB,mBAAmB,GACnB,aAAa,GACb,aAAa,GACb,aAAa,GACb,gBAAgB,CAAC;AAErB,MAAM,WAAW,gBAAgB;IAC/B,oGAAoG;IACpG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAqCjE;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAyBpF;AAUD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACrC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAM/E;AAID,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,eAAe,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAClC;yDACqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAYD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,cAAc,CAAA;CAAO,GAAG,aAAa,CA6T3G;AAWD;uEACuE;AACvE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAKpD"}