seer-mcp 0.1.0

package/dist/bundle/ci.d.ts

@@ -0,0 +1,47 @@
+import { ExportResult } from './export.js';
+import type { DiscoveryMode } from '../indexer/discovery.js';
+export interface CiBuildOptions {
+    /** Repo root to index. Required. */
+    repoRoot: string;
+    /** Where to write the bundle. Defaults to `<repoRoot>/.seer/index.seerbundle`. */
+    out?: string;
+    /** Discovery mode for the index pass. CI defaults to `'standard'`. */
+    mode?: DiscoveryMode;
+    /** Wipe any existing DB before the indexing pass. CI defaults to `true`. */
+    reset?: boolean;
+    /** Pass through to the indexer's `parallel` toggle. */
+    parallel?: boolean;
+    /** Optional gitHead/gitBranch overrides (CI runners frequently know them). */
+    gitHead?: string;
+    gitBranch?: string;
+    /** Pin manifest.builtAt for reproducible bundles (defaults to Date.now()). */
+    builtAt?: number;
+    /** Logger. */
+    log?: (msg: string) => void;
+}
+export interface CiBuildResult {
+    /** Result of the indexing pass (file/symbol counts). */
+    index: {
+        filesIndexed: number;
+        symbols: number;
+        edges: number;
+        elapsedMs: number;
+    };
+    /** Result of the bundle export. */
+    bundle: ExportResult;
+    totalElapsedMs: number;
+}
+/**
+ * One-call CI pipeline: fresh-index a repo, export the result as a portable
+ * bundle, and report both phases. Exits with a non-zero status if either
+ * phase fails — wired up in the CLI command's caller.
+ */
+export declare function buildCiBundle(options: CiBuildOptions): Promise<CiBuildResult>;
+/**
+ * Emit a ready-to-paste GitHub Actions workflow that runs the CI bundle
+ * pipeline on every push to main and uploads the resulting bundle as a
+ * build artifact. The workflow is self-contained — no per-repo edits
+ * required beyond dropping it at `.github/workflows/seer-bundle.yml`.
+ */
+export declare function workflowTemplate(): string;
+//# sourceMappingURL=ci.d.ts.map

package/dist/bundle/ci.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci.d.ts","sourceRoot":"","sources":["../../src/bundle/ci.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgB,YAAY,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,mCAAmC;IACnC,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAuDnF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAgCzC"}

package/dist/bundle/ci.js

@@ -0,0 +1,113 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCiBundle = buildCiBundle;
+exports.workflowTemplate = workflowTemplate;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const store_js_1 = require("../db/store.js");
+const index_js_1 = require("../indexer/index.js");
+const export_js_1 = require("./export.js");
+/**
+ * One-call CI pipeline: fresh-index a repo, export the result as a portable
+ * bundle, and report both phases. Exits with a non-zero status if either
+ * phase fails — wired up in the CLI command's caller.
+ */
+async function buildCiBundle(options) {
+    const start = Date.now();
+    const log = options.log ?? ((msg) => process.stdout.write(`${msg}\n`));
+    const repoRoot = path_1.default.resolve(options.repoRoot);
+    if (!fs_1.default.existsSync(repoRoot)) {
+        throw new Error(`Repo not found: ${repoRoot}`);
+    }
+    const dbPath = path_1.default.join(repoRoot, '.seer', 'graph.db');
+    fs_1.default.mkdirSync(path_1.default.dirname(dbPath), { recursive: true });
+    // CI mode wipes the DB by default — every pipeline run should be a clean
+    // snapshot, not an incremental update over whatever junk was on the runner.
+    const reset = options.reset ?? true;
+    if (reset && fs_1.default.existsSync(dbPath)) {
+        fs_1.default.unlinkSync(dbPath);
+        for (const sfx of ['-wal', '-shm']) {
+            try {
+                fs_1.default.unlinkSync(dbPath + sfx);
+            }
+            catch { /* */ }
+        }
+    }
+    log(`[ci] Indexing ${repoRoot}...`);
+    const store = new store_js_1.Store(dbPath);
+    const indexer = new index_js_1.Indexer(store);
+    let indexResult;
+    try {
+        indexResult = await indexer.indexDirectory(repoRoot, {
+            mode: options.mode ?? 'standard',
+            parallel: options.parallel,
+            quiet: true,
+        });
+    }
+    finally {
+        store.close();
+    }
+    log(`[ci] Indexed ${indexResult.filesIndexed} files, ${indexResult.symbols} symbols, ${indexResult.edges} edges in ${indexResult.elapsedMs}ms`);
+    log(`[ci] Exporting bundle...`);
+    const bundle = await (0, export_js_1.exportBundle)(dbPath, repoRoot, {
+        out: options.out,
+        log: (m) => log(`  ${m}`),
+        gitHead: options.gitHead,
+        gitBranch: options.gitBranch,
+        builtAt: options.builtAt,
+    });
+    log(`[ci] Wrote ${bundle.bundlePath} (${bundle.bytes.toLocaleString()} bytes) in ${bundle.elapsedMs}ms`);
+    return {
+        index: {
+            filesIndexed: indexResult.filesIndexed,
+            symbols: indexResult.symbols,
+            edges: indexResult.edges,
+            elapsedMs: indexResult.elapsedMs,
+        },
+        bundle,
+        totalElapsedMs: Date.now() - start,
+    };
+}
+/**
+ * Emit a ready-to-paste GitHub Actions workflow that runs the CI bundle
+ * pipeline on every push to main and uploads the resulting bundle as a
+ * build artifact. The workflow is self-contained — no per-repo edits
+ * required beyond dropping it at `.github/workflows/seer-bundle.yml`.
+ */
+function workflowTemplate() {
+    return [
+        "name: Seer bundle",
+        "",
+        "on:",
+        "  push:",
+        "    branches: [main]",
+        "  workflow_dispatch:",
+        "",
+        "jobs:",
+        "  build:",
+        "    runs-on: ubuntu-latest",
+        "    permissions:",
+        "      contents: read",
+        "    steps:",
+        "      - uses: actions/checkout@v4",
+        "        with:",
+        "          fetch-depth: 0   # full history so symbol-history pass works",
+        "      - uses: actions/setup-node@v4",
+        "        with:",
+        "          node-version: '22'",
+        "      - run: npm ci",
+        "      - run: npm run build",
+        "      - name: Build Seer bundle",
+        "        run: node dist/cli/index.js ci bundle --workspace ${{ github.workspace }} --out seer-index.seerbundle",
+        "      - uses: actions/upload-artifact@v4",
+        "        with:",
+        "          name: seer-index",
+        "          path: seer-index.seerbundle",
+        "          if-no-files-found: error",
+        "",
+    ].join('\n');
+}
+//# sourceMappingURL=ci.js.map

package/dist/bundle/ci.js.map

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

package/dist/bundle/contract.d.ts

@@ -0,0 +1,111 @@
+/**
+ * v10 — Contract Diff between two `.seerbundle` artifacts.
+ *
+ * Goal: deterministically compute the change set in the API/service surface
+ * exposed by an indexed repo, treating the bundle as the source of truth.
+ * The diff is ADVISORY — exit code is always 0 even when breaking changes
+ * appear. Seer-Core does not gate CI.
+ *
+ * Comparison happens at the protocol-aware "endpoint" level:
+ *   - HTTP: key = `${method}|${path}`, framework recorded
+ *   - tRPC: key = `trpc|${operation}` (method = 'query' / 'mutation' / 'subscription')
+ *   - GraphQL: key = `graphql|${operation}`
+ *   - gRPC: key = `grpc|${service}.${operation}`
+ *   - Messaging (kafka/sqs/sns/rabbitmq/nats/redis_pubsub):
+ *       key = `${protocol}|${topic|queue|exchange}`
+ *
+ * Output:
+ *   - added[]
+ *   - removed[]
+ *   - changed[] (key matched; surfaced field differs — handler, framework,
+ *     metadata, service)
+ *   - optionally affectedCallers[] when both bundles include service-link
+ *     evidence (caller symbol qualifiedName / file).
+ *
+ * Deterministic ordering: every list is sorted by (protocol, key) ASC.
+ */
+import { Store } from '../db/store.js';
+export interface ContractEndpoint {
+    protocol: string;
+    /** Stable identity key for this endpoint within its protocol. */
+    key: string;
+    method: string | null;
+    path: string | null;
+    framework: string | null;
+    handlerName: string | null;
+    operation: string | null;
+    topic: string | null;
+    queue: string | null;
+    exchange: string | null;
+    service: string | null;
+}
+export interface AffectedCaller {
+    callerQualifiedName: string | null;
+    callerFile: string | null;
+    callerLine: number | null;
+    /** Where the caller is referenced — either 'old' or 'new' bundle. */
+    source: 'old' | 'new';
+}
+export interface ContractChange {
+    protocol: string;
+    key: string;
+    before: ContractEndpoint;
+    after: ContractEndpoint;
+    /** Field names whose value differs between before/after. */
+    changedFields: string[];
+}
+export interface ContractDiff {
+    oldBundle: {
+        path: string;
+        gitHead: string | null;
+        rosterHash: string;
+    };
+    newBundle: {
+        path: string;
+        gitHead: string | null;
+        rosterHash: string;
+    };
+    /** Per-protocol totals on both sides, for sanity. */
+    totals: {
+        old: number;
+        new: number;
+        added: number;
+        removed: number;
+        changed: number;
+    };
+    added: Array<ContractEndpoint & {
+        affectedCallers?: AffectedCaller[];
+    }>;
+    removed: Array<ContractEndpoint & {
+        affectedCallers?: AffectedCaller[];
+    }>;
+    changed: Array<ContractChange & {
+        affectedCallers?: AffectedCaller[];
+    }>;
+    /** True when the affected-callers section is non-empty for at least one row. */
+    affectedCallersAvailable: boolean;
+}
+/**
+ * Build the "contract surface" — one entry per route — from a bundle Store.
+ * Stable key:
+ *   - HTTP    → `http|${method}|${path}`
+ *   - tRPC    → `trpc|${operation}`
+ *   - GraphQL → `graphql|${operation}`
+ *   - gRPC    → `grpc|${service}.${operation}`
+ *   - Messaging → `${protocol}|${topic|queue|exchange}`
+ */
+export declare function collectContractSurface(store: Store): Map<string, ContractEndpoint>;
+/**
+ * Diff two bundles' contract surfaces. Both bundles are opened read-only,
+ * the surfaces are collected, and the diff is computed without importing
+ * either bundle into a workspace.
+ */
+export declare function contractDiff(oldBundlePath: string, newBundlePath: string, options?: {
+    includeAffectedCallers?: boolean;
+}): Promise<ContractDiff>;
+/**
+ * Convenience: format the diff as a compact human-readable table.
+ * Deterministic ordering by protocol + key.
+ */
+export declare function formatContractDiffTable(diff: ContractDiff): string;
+//# sourceMappingURL=contract.d.ts.map

package/dist/bundle/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/bundle/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAOH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qEAAqE;IACrE,MAAM,EAAE,KAAK,GAAG,KAAK,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,gBAAgB,CAAC;IACxB,4DAA4D;IAC5D,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,qDAAqD;IACrD,MAAM,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,KAAK,EAAE,KAAK,CAAC,gBAAgB,GAAG;QAAE,eAAe,CAAC,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAAC;IACxE,OAAO,EAAE,KAAK,CAAC,gBAAgB,GAAG;QAAE,eAAe,CAAC,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAAC;IAC1E,OAAO,EAAE,KAAK,CAAC,cAAc,GAAG;QAAE,eAAe,CAAC,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAAC;IACxE,gFAAgF;IAChF,wBAAwB,EAAE,OAAO,CAAC;CACnC;AAwCD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAsBlF;AAqCD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IAAE,sBAAsB,CAAC,EAAE,OAAO,CAAA;CAAO,GACjD,OAAO,CAAC,YAAY,CAAC,CA0FvB;AA8DD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAuBlE"}

package/dist/bundle/contract.js

@@ -0,0 +1,352 @@
+"use strict";
+/**
+ * v10 — Contract Diff between two `.seerbundle` artifacts.
+ *
+ * Goal: deterministically compute the change set in the API/service surface
+ * exposed by an indexed repo, treating the bundle as the source of truth.
+ * The diff is ADVISORY — exit code is always 0 even when breaking changes
+ * appear. Seer-Core does not gate CI.
+ *
+ * Comparison happens at the protocol-aware "endpoint" level:
+ *   - HTTP: key = `${method}|${path}`, framework recorded
+ *   - tRPC: key = `trpc|${operation}` (method = 'query' / 'mutation' / 'subscription')
+ *   - GraphQL: key = `graphql|${operation}`
+ *   - gRPC: key = `grpc|${service}.${operation}`
+ *   - Messaging (kafka/sqs/sns/rabbitmq/nats/redis_pubsub):
+ *       key = `${protocol}|${topic|queue|exchange}`
+ *
+ * Output:
+ *   - added[]
+ *   - removed[]
+ *   - changed[] (key matched; surfaced field differs — handler, framework,
+ *     metadata, service)
+ *   - optionally affectedCallers[] when both bundles include service-link
+ *     evidence (caller symbol qualifiedName / file).
+ *
+ * Deterministic ordering: every list is sorted by (protocol, key) ASC.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectContractSurface = collectContractSurface;
+exports.contractDiff = contractDiff;
+exports.formatContractDiffTable = formatContractDiffTable;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const zlib_1 = __importDefault(require("zlib"));
+const format_js_1 = require("./format.js");
+const store_js_1 = require("../db/store.js");
+/**
+ * Open a bundle's payload as a read-only Store (decompressed to a temp file).
+ * Returns the Store plus a cleanup() function the caller MUST invoke.
+ */
+async function openBundleStore(bundlePath) {
+    if (!fs_1.default.existsSync(bundlePath)) {
+        throw new Error(`No bundle at ${bundlePath}`);
+    }
+    const fileBuf = fs_1.default.readFileSync(bundlePath);
+    if (fileBuf.length < 12 || !fileBuf.subarray(0, 4).equals(format_js_1.BUNDLE_MAGIC)) {
+        throw new Error(`Not a Seer bundle: ${bundlePath} (bad magic)`);
+    }
+    const formatVersion = fileBuf.readUInt32BE(4);
+    if (formatVersion > format_js_1.BUNDLE_FORMAT_VERSION) {
+        throw new Error(`Bundle format v${formatVersion} is newer than this build (v${format_js_1.BUNDLE_FORMAT_VERSION}). Upgrade Seer.`);
+    }
+    const manifestLen = fileBuf.readUInt32BE(8);
+    const manifestEnd = 12 + manifestLen;
+    if (manifestLen <= 0 || manifestEnd > fileBuf.length) {
+        throw new Error(`Bundle truncated: ${bundlePath} (manifest length ${manifestLen} exceeds file size)`);
+    }
+    const manifest = JSON.parse(fileBuf.slice(12, manifestEnd).toString('utf-8'));
+    const dbBuf = zlib_1.default.gunzipSync(fileBuf.slice(manifestEnd));
+    const tmpDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'seer-contractdiff-'));
+    const dbPath = path_1.default.join(tmpDir, 'bundle.db');
+    fs_1.default.writeFileSync(dbPath, dbBuf);
+    const store = store_js_1.Store.openReadOnly(dbPath);
+    return {
+        store, manifest,
+        cleanup: () => {
+            try {
+                store.close();
+            }
+            catch { /* */ }
+            try {
+                fs_1.default.unlinkSync(dbPath);
+                fs_1.default.rmdirSync(tmpDir);
+            }
+            catch { /* */ }
+        },
+    };
+}
+/**
+ * Build the "contract surface" — one entry per route — from a bundle Store.
+ * Stable key:
+ *   - HTTP    → `http|${method}|${path}`
+ *   - tRPC    → `trpc|${operation}`
+ *   - GraphQL → `graphql|${operation}`
+ *   - gRPC    → `grpc|${service}.${operation}`
+ *   - Messaging → `${protocol}|${topic|queue|exchange}`
+ */
+function collectContractSurface(store) {
+    const surface = new Map();
+    const rows = store.listRoutes({ limit: 1_000_000 });
+    for (const r of rows) {
+        const protocol = r.protocol ?? 'http';
+        const key = endpointKey(protocol, r);
+        if (key == null)
+            continue;
+        surface.set(key, {
+            protocol,
+            key,
+            method: r.method ?? null,
+            path: r.path ?? null,
+            framework: r.framework ?? null,
+            handlerName: r.handlerName ?? null,
+            operation: r.operation ?? null,
+            topic: r.topic ?? null,
+            queue: r.queue ?? null,
+            exchange: r.exchange ?? null,
+            service: r.service ?? null,
+        });
+    }
+    return surface;
+}
+function endpointKey(protocol, r) {
+    if (protocol === 'http') {
+        if (!r.path)
+            return null;
+        return `http|${(r.method ?? 'ANY').toUpperCase()}|${r.path}`;
+    }
+    if (protocol === 'trpc') {
+        if (!r.operation)
+            return null;
+        return `trpc|${r.operation}`;
+    }
+    if (protocol === 'graphql') {
+        if (!r.operation)
+            return null;
+        return `graphql|${r.operation}`;
+    }
+    if (protocol === 'grpc') {
+        if (!r.operation)
+            return null;
+        const svc = r.service ?? '';
+        return `grpc|${svc}.${r.operation}`;
+    }
+    if (protocol === 'kafka' || protocol === 'redis_pubsub' || protocol === 'nats' || protocol === 'sns') {
+        if (!r.topic)
+            return null;
+        return `${protocol}|${r.topic}`;
+    }
+    if (protocol === 'sqs' || protocol === 'rabbitmq') {
+        const key = r.queue ?? r.exchange;
+        if (!key)
+            return null;
+        return `${protocol}|${key}`;
+    }
+    return null;
+}
+/**
+ * Diff two bundles' contract surfaces. Both bundles are opened read-only,
+ * the surfaces are collected, and the diff is computed without importing
+ * either bundle into a workspace.
+ */
+async function contractDiff(oldBundlePath, newBundlePath, options = {}) {
+    const oldH = await openBundleStore(oldBundlePath);
+    const newH = await openBundleStore(newBundlePath);
+    try {
+        const oldSurface = collectContractSurface(oldH.store);
+        const newSurface = collectContractSurface(newH.store);
+        const added = [];
+        const removed = [];
+        const changed = [];
+        for (const [key, before] of oldSurface) {
+            const after = newSurface.get(key);
+            if (!after) {
+                removed.push(before);
+                continue;
+            }
+            const fields = diffEndpointFields(before, after);
+            if (fields.length > 0) {
+                changed.push({ protocol: before.protocol, key, before, after, changedFields: fields });
+            }
+        }
+        for (const [key, after] of newSurface) {
+            if (!oldSurface.has(key))
+                added.push(after);
+        }
+        sortByProtocolKey(added);
+        sortByProtocolKey(removed);
+        changed.sort((a, b) => a.protocol < b.protocol ? -1 :
+            a.protocol > b.protocol ? 1 :
+                a.key < b.key ? -1 :
+                    a.key > b.key ? 1 : 0);
+        let affectedCallersAvailable = false;
+        let augmented = false;
+        if (options.includeAffectedCallers) {
+            augmented = true;
+            const oldCallersByRouteKey = collectCallersByRouteKey(oldH.store);
+            const newCallersByRouteKey = collectCallersByRouteKey(newH.store);
+            const attach = (item, side) => {
+                const src = side === 'old' ? oldCallersByRouteKey : newCallersByRouteKey;
+                const callers = src.get(item.key);
+                if (callers && callers.length > 0) {
+                    item.affectedCallers = callers.map(c => ({ ...c, source: side }));
+                    affectedCallersAvailable = true;
+                }
+            };
+            for (const item of added)
+                attach(item, 'new');
+            for (const item of removed)
+                attach(item, 'old');
+            for (const item of changed) {
+                const sideOld = oldCallersByRouteKey.get(item.key);
+                const sideNew = newCallersByRouteKey.get(item.key);
+                const callers = [];
+                if (sideOld)
+                    for (const c of sideOld)
+                        callers.push({ ...c, source: 'old' });
+                if (sideNew)
+                    for (const c of sideNew)
+                        callers.push({ ...c, source: 'new' });
+                if (callers.length > 0) {
+                    item.affectedCallers = callers;
+                    affectedCallersAvailable = true;
+                }
+            }
+            void augmented;
+        }
+        return {
+            oldBundle: {
+                path: path_1.default.resolve(oldBundlePath),
+                gitHead: oldH.manifest.source.gitHead,
+                rosterHash: oldH.manifest.source.rosterHash,
+            },
+            newBundle: {
+                path: path_1.default.resolve(newBundlePath),
+                gitHead: newH.manifest.source.gitHead,
+                rosterHash: newH.manifest.source.rosterHash,
+            },
+            totals: {
+                old: oldSurface.size,
+                new: newSurface.size,
+                added: added.length,
+                removed: removed.length,
+                changed: changed.length,
+            },
+            added,
+            removed,
+            changed,
+            affectedCallersAvailable,
+        };
+    }
+    finally {
+        oldH.cleanup();
+        newH.cleanup();
+    }
+}
+function sortByProtocolKey(items) {
+    items.sort((a, b) => a.protocol < b.protocol ? -1 :
+        a.protocol > b.protocol ? 1 :
+            a.key < b.key ? -1 :
+                a.key > b.key ? 1 : 0);
+}
+function diffEndpointFields(a, b) {
+    const fields = [];
+    const keys = [
+        'method', 'path', 'framework', 'handlerName',
+        'operation', 'topic', 'queue', 'exchange', 'service',
+    ];
+    for (const k of keys) {
+        if (a[k] !== b[k])
+            fields.push(k);
+    }
+    return fields;
+}
+/**
+ * For each route in the bundle, build a list of caller previews using
+ * service_links + service_calls when present. Lets the diff report
+ * affectedCallers without importing the bundle.
+ */
+function collectCallersByRouteKey(store) {
+    const out = new Map();
+    try {
+        const links = store.listServiceLinks({ limit: 1_000_000 });
+        const routesById = new Map();
+        for (const r of store.listRoutes({ limit: 1_000_000 })) {
+            const protocol = r.protocol ?? 'http';
+            const key = endpointKey(protocol, r);
+            if (!key)
+                continue;
+            routesById.set(r.id, {
+                protocol, key,
+                method: r.method, path: r.path, framework: r.framework,
+                handlerName: r.handlerName,
+                operation: r.operation ?? null, topic: r.topic ?? null,
+                queue: r.queue ?? null, exchange: r.exchange ?? null,
+                service: r.service ?? null,
+            });
+        }
+        for (const l of links) {
+            if (l.routeId == null)
+                continue;
+            const ep = routesById.get(l.routeId);
+            if (!ep)
+                continue;
+            const list = out.get(ep.key) ?? [];
+            list.push({
+                callerQualifiedName: l.callerQualifiedName ?? l.callerName ?? null,
+                callerFile: l.callerFile,
+                callerLine: l.callerLine ?? null,
+                source: 'old',
+            });
+            out.set(ep.key, list);
+        }
+    }
+    catch { /* */ }
+    return out;
+}
+/**
+ * Convenience: format the diff as a compact human-readable table.
+ * Deterministic ordering by protocol + key.
+ */
+function formatContractDiffTable(diff) {
+    const lines = [];
+    lines.push(`Contract diff ${diff.oldBundle.path} → ${diff.newBundle.path}`);
+    lines.push(`  old endpoints: ${diff.totals.old}  new: ${diff.totals.new}  ` +
+        `added: ${diff.totals.added}  removed: ${diff.totals.removed}  changed: ${diff.totals.changed}`);
+    if (diff.added.length > 0) {
+        lines.push('');
+        lines.push('  Added:');
+        for (const a of diff.added)
+            lines.push(`    + [${a.protocol}] ${labelEndpoint(a)}`);
+    }
+    if (diff.removed.length > 0) {
+        lines.push('');
+        lines.push('  Removed:');
+        for (const r of diff.removed)
+            lines.push(`    - [${r.protocol}] ${labelEndpoint(r)}`);
+    }
+    if (diff.changed.length > 0) {
+        lines.push('');
+        lines.push('  Changed:');
+        for (const c of diff.changed) {
+            lines.push(`    ~ [${c.protocol}] ${labelEndpoint(c.before)} (${c.changedFields.join(', ')})`);
+        }
+    }
+    return lines.join('\n') + '\n';
+}
+function labelEndpoint(e) {
+    if (e.protocol === 'http')
+        return `${e.method ?? 'ANY'} ${e.path ?? ''} (${e.framework ?? '?'})`;
+    if (e.protocol === 'trpc')
+        return `${e.operation ?? ''}`;
+    if (e.protocol === 'graphql')
+        return `${e.operation ?? ''}`;
+    if (e.protocol === 'grpc')
+        return `${e.service ?? ''}.${e.operation ?? ''}`;
+    return e.topic ?? e.queue ?? e.exchange ?? '?';
+}
+//# sourceMappingURL=contract.js.map

package/dist/bundle/contract.js.map

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