seer-mcp 0.1.0

package/dist/bundle/export.d.ts

@@ -0,0 +1,36 @@
+import { BundleManifest } from './format.js';
+export interface ExportOptions {
+    /** Where to write the bundle. Defaults to `<repoRoot>/.seer/index.seerbundle`. */
+    out?: string;
+    /** Gzip level (0-9). Defaults to 6 (zlib's standard balance). */
+    compressionLevel?: number;
+    /** Logger; defaults to no-op. */
+    log?: (msg: string) => void;
+    /** Override the gitHead recorded in the manifest (CI sometimes wants this). */
+    gitHead?: string;
+    /** Override the gitBranch recorded in the manifest. */
+    gitBranch?: string;
+    /**
+     * Pin the manifest's `builtAt` (Unix-millis). Defaults to `Date.now()`,
+     * which makes successive exports of the same DB byte-different. Override
+     * to a stable value (e.g. the source repo's HEAD commit time) when you
+     * need reproducible bundle bytes for build-cache keys.
+     */
+    builtAt?: number;
+}
+export interface ExportResult {
+    bundlePath: string;
+    bytes: number;
+    manifest: BundleManifest;
+    elapsedMs: number;
+}
+/**
+ * Bundle an existing `.seer/graph.db` into a portable single-file artifact.
+ *
+ * The DB is first VACUUM INTO'd to a temp file so we ship a tightly packed
+ * copy (no WAL, no free pages). The packed DB is hashed, then gzip-compressed
+ * and concatenated after the manifest header. The result is deterministic for
+ * a given DB content + manifest input.
+ */
+export declare function exportBundle(dbPath: string, repoRoot: string, options?: ExportOptions): Promise<ExportResult>;
+//# sourceMappingURL=export.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/bundle/export.ts"],"names":[],"mappings":"AAOA,OAAO,EACgC,cAAc,EACpD,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iCAAiC;IACjC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAC5D,OAAO,CAAC,YAAY,CAAC,CA4GvB"}

package/dist/bundle/export.js

@@ -0,0 +1,152 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exportBundle = exportBundle;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const crypto_1 = __importDefault(require("crypto"));
+const zlib_1 = __importDefault(require("zlib"));
+const child_process_1 = require("child_process");
+const store_js_1 = require("../db/store.js");
+const format_js_1 = require("./format.js");
+/**
+ * Bundle an existing `.seer/graph.db` into a portable single-file artifact.
+ *
+ * The DB is first VACUUM INTO'd to a temp file so we ship a tightly packed
+ * copy (no WAL, no free pages). The packed DB is hashed, then gzip-compressed
+ * and concatenated after the manifest header. The result is deterministic for
+ * a given DB content + manifest input.
+ */
+async function exportBundle(dbPath, repoRoot, options = {}) {
+    const start = Date.now();
+    const log = options.log ?? (() => { });
+    if (!fs_1.default.existsSync(dbPath)) {
+        throw new Error(`No index at ${dbPath} — run \`seer index\` first.`);
+    }
+    // Open the source DB read-only and harvest the manifest data BEFORE we
+    // start the vacuum (vacuum closes implicit locks on its own connection but
+    // the source connection stays compatible since we re-open it here).
+    const srcStore = store_js_1.Store.openReadOnly(dbPath);
+    let manifest;
+    try {
+        const stats = srcStore.getStats();
+        const scipImports = srcStore.listScipImports();
+        const files = srcStore.listFiles();
+        const roster = files
+            .map(f => ({ relPath: f.relPath, hash: f.hash }))
+            .sort((a, b) => a.relPath < b.relPath ? -1 : a.relPath > b.relPath ? 1 : 0);
+        const rosterHash = crypto_1.default.createHash('sha256')
+            .update(roster.map(r => `${r.relPath}\t${r.hash}`).join('\n'))
+            .digest('hex');
+        const schemaVersion = srcStore.schemaInfo().dbVersion;
+        manifest = {
+            bundleFormatVersion: format_js_1.BUNDLE_FORMAT_VERSION,
+            schemaVersion,
+            builtAt: options.builtAt ?? Date.now(),
+            builtBy: `seer/${format_js_1.BUNDLE_FORMAT_VERSION}`,
+            source: {
+                repoRoot: path_1.default.resolve(repoRoot),
+                gitHead: options.gitHead ?? detectGitHead(repoRoot),
+                gitBranch: options.gitBranch ?? detectGitBranch(repoRoot),
+                rosterHash,
+                fileCount: files.length,
+            },
+            index: {
+                symbols: stats.symbols,
+                edges: stats.edges,
+                resolvedEdges: stats.resolvedEdges,
+                modules: stats.modules ?? 0,
+                routes: stats.routes ?? 0,
+                externalDependencies: stats.externalDependencies ?? 0,
+                configKeys: stats.configKeys ?? 0,
+                languages: stats.languages,
+                provenance: stats.provenance,
+            },
+            scipImports: scipImports.map(s => ({
+                path: s.path, sha256: s.sha256, tool: s.tool,
+                symbolCount: s.symbolCount, refCount: s.refCount,
+            })),
+            dbSha256: '', // filled in after we hash the packed DB
+            dbBytes: 0,
+        };
+    }
+    finally {
+        srcStore.close();
+    }
+    // VACUUM INTO produces a fresh, tightly packed DB — fast on small repos,
+    // O(rows) on huge ones. We write to a temp file so the source DB stays
+    // untouched and aborted exports leave nothing behind.
+    const tmpDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'seer-bundle-'));
+    const packedDb = path_1.default.join(tmpDir, 'graph.packed.db');
+    log(`Vacuuming index into ${packedDb}...`);
+    const packStore = new store_js_1.Store(dbPath);
+    try {
+        packStore.rawDb().exec(`VACUUM INTO '${packedDb.replace(/'/g, "''")}'`);
+    }
+    finally {
+        packStore.close();
+    }
+    const dbBuf = fs_1.default.readFileSync(packedDb);
+    const dbSha = crypto_1.default.createHash('sha256').update(dbBuf).digest('hex');
+    manifest.dbSha256 = dbSha;
+    manifest.dbBytes = dbBuf.length;
+    log(`Packed DB: ${dbBuf.length} bytes, sha256 ${dbSha.slice(0, 12)}...`);
+    const manifestJson = Buffer.from(JSON.stringify(manifest, null, 2), 'utf-8');
+    // Gzip the DB. Level 6 is the zlib default; bumpable for CI artifacts.
+    const compressed = zlib_1.default.gzipSync(dbBuf, {
+        level: options.compressionLevel ?? 6,
+    });
+    log(`Compressed DB: ${compressed.length} bytes (${(compressed.length / dbBuf.length * 100).toFixed(1)}% of raw)`);
+    const header = Buffer.alloc(4 + 4 + 4);
+    format_js_1.BUNDLE_MAGIC.copy(header, 0);
+    header.writeUInt32BE(format_js_1.BUNDLE_FORMAT_VERSION, 4);
+    header.writeUInt32BE(manifestJson.length, 8);
+    const outPath = options.out ?? path_1.default.join(repoRoot, '.seer', 'index.seerbundle');
+    fs_1.default.mkdirSync(path_1.default.dirname(outPath), { recursive: true });
+    const fd = fs_1.default.openSync(outPath, 'w');
+    try {
+        fs_1.default.writeSync(fd, header);
+        fs_1.default.writeSync(fd, manifestJson);
+        fs_1.default.writeSync(fd, compressed);
+    }
+    finally {
+        fs_1.default.closeSync(fd);
+    }
+    try {
+        fs_1.default.unlinkSync(packedDb);
+        fs_1.default.rmdirSync(tmpDir);
+    }
+    catch { /* */ }
+    return {
+        bundlePath: outPath,
+        bytes: header.length + manifestJson.length + compressed.length,
+        manifest,
+        elapsedMs: Date.now() - start,
+    };
+}
+function detectGitHead(repoRoot) {
+    try {
+        const sha = (0, child_process_1.execFileSync)('git', ['-C', repoRoot, 'rev-parse', 'HEAD'], {
+            encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        return sha.length > 0 ? sha : null;
+    }
+    catch {
+        return null;
+    }
+}
+function detectGitBranch(repoRoot) {
+    try {
+        const branch = (0, child_process_1.execFileSync)('git', ['-C', repoRoot, 'rev-parse', '--abbrev-ref', 'HEAD'], {
+            encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        return branch.length > 0 && branch !== 'HEAD' ? branch : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=export.js.map

package/dist/bundle/export.js.map

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

package/dist/bundle/external.d.ts

@@ -0,0 +1,66 @@
+/**
+ * v10 External Bundle Layers — additive import of a peer repo's .seerbundle as
+ * read-only external evidence.
+ *
+ * The destructive bundle import (src/bundle/import.ts) replaces the local
+ * graph DB wholesale; this importer leaves local files/symbols untouched and
+ * only adds:
+ *   - one row in external_bundles (source identity + manifest hash)
+ *   - one phantom file per bundle (`__external_bundle__/<project>/<id>`)
+ *   - rows in routes (and where present, service_endpoints) marked
+ *     `external_bundle_id` so they participate in service-link resolution but
+ *     can be wiped as a single layer on re-import.
+ *
+ * Design rules:
+ *   - never touch local symbols / files / edges / pagerank
+ *   - never write rows whose external_bundle_id is NULL
+ *   - re-importing the same path with the same hash is a no-op
+ *   - re-importing with a NEW hash replaces only that layer (FK cascade)
+ *   - the bundle is read by spinning up a temp Store against the bundle's
+ *     SQLite payload — same code path that bundle/info uses to enumerate the
+ *     manifest, but with full row access scoped read-only
+ */
+import { Store } from '../db/store.js';
+export interface ExternalImportOptions {
+    /** Optional alias for the bundle (defaults to the manifest's gitBranch or basename). */
+    alias?: string;
+    /** When true, force re-import even if the same hash is already present. */
+    force?: boolean;
+    /**
+     * Skip the dbSha256 / dbBytes integrity check. Off by default — the manifest
+     * integrity guarantee is what lets us trust a peer-repo bundle. Use only for
+     * forensic inspection of a corrupted bundle whose header still parses.
+     */
+    skipIntegrityCheck?: boolean;
+    /**
+     * Skip the schema-version compatibility check. Off by default — a bundle
+     * whose schemaVersion is newer than this build can't be safely read.
+     */
+    skipSchemaCheck?: boolean;
+    /**
+     * Rebuild service_links after import so cross-repo links are visible to the
+     * next query without waiting for a re-index. Default true.
+     */
+    rebuildServiceLinks?: boolean;
+    /** Logger; defaults to no-op. */
+    log?: (msg: string) => void;
+}
+export interface ExternalImportResult {
+    bundlePath: string;
+    bundleId: number;
+    externalProject: string | null;
+    externalHash: string;
+    schemaVersion: number;
+    /** True when the same bundle path + hash was already imported and we skipped. */
+    alreadyImported: boolean;
+    routesImported: number;
+    serviceEndpointsImported: number;
+    elapsedMs: number;
+}
+/**
+ * Import a .seerbundle as an additive external layer into the given local
+ * Store. The local DB is NOT touched outside of the external_bundles row,
+ * the phantom file row, and the new external-marked routes/service_calls.
+ */
+export declare function importExternalBundle(bundlePath: string, localStore: Store, options?: ExternalImportOptions): Promise<ExternalImportResult>;
+//# sourceMappingURL=external.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../src/bundle/external.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AASH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC,MAAM,WAAW,qBAAqB;IACpC,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iCAAiC;IACjC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB,EAAE,MAAM,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,KAAK,EACjB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CA4M/B"}

package/dist/bundle/external.js

@@ -0,0 +1,238 @@
+"use strict";
+/**
+ * v10 External Bundle Layers — additive import of a peer repo's .seerbundle as
+ * read-only external evidence.
+ *
+ * The destructive bundle import (src/bundle/import.ts) replaces the local
+ * graph DB wholesale; this importer leaves local files/symbols untouched and
+ * only adds:
+ *   - one row in external_bundles (source identity + manifest hash)
+ *   - one phantom file per bundle (`__external_bundle__/<project>/<id>`)
+ *   - rows in routes (and where present, service_endpoints) marked
+ *     `external_bundle_id` so they participate in service-link resolution but
+ *     can be wiped as a single layer on re-import.
+ *
+ * Design rules:
+ *   - never touch local symbols / files / edges / pagerank
+ *   - never write rows whose external_bundle_id is NULL
+ *   - re-importing the same path with the same hash is a no-op
+ *   - re-importing with a NEW hash replaces only that layer (FK cascade)
+ *   - the bundle is read by spinning up a temp Store against the bundle's
+ *     SQLite payload — same code path that bundle/info uses to enumerate the
+ *     manifest, but with full row access scoped read-only
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.importExternalBundle = importExternalBundle;
+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 crypto_1 = __importDefault(require("crypto"));
+const format_js_1 = require("./format.js");
+const schema_js_1 = require("../db/schema.js");
+const store_js_1 = require("../db/store.js");
+const serviceLinks_js_1 = require("../indexer/serviceLinks.js");
+/**
+ * Import a .seerbundle as an additive external layer into the given local
+ * Store. The local DB is NOT touched outside of the external_bundles row,
+ * the phantom file row, and the new external-marked routes/service_calls.
+ */
+async function importExternalBundle(bundlePath, localStore, options = {}) {
+    const start = Date.now();
+    const log = options.log ?? (() => { });
+    if (localStore.isReadOnly()) {
+        throw new Error('Cannot import external bundle into a read-only Store');
+    }
+    if (!localStore.hasV10()) {
+        throw new Error('Local DB does not have v10 external_bundles tables — upgrade first');
+    }
+    if (!fs_1.default.existsSync(bundlePath)) {
+        throw new Error(`No bundle at ${bundlePath}`);
+    }
+    // Parse the manifest + payload up front. We need both: the manifest gives us
+    // identity + schema_version, the payload gives us the read source.
+    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; manifest length ${manifestLen} exceeds file size`);
+    }
+    const manifest = JSON.parse(fileBuf.slice(12, manifestEnd).toString('utf-8'));
+    // Schema compatibility: a bundle built against a NEWER schema may carry
+    // tables/columns we don't understand. Reject up front rather than reading
+    // partial data. Older bundles are fine — listRoutes tolerates older shapes.
+    if (!options.skipSchemaCheck) {
+        if (typeof manifest.schemaVersion !== 'number' || manifest.schemaVersion <= 0) {
+            throw new Error(`Bundle has invalid schemaVersion=${manifest.schemaVersion}.`);
+        }
+        if (manifest.schemaVersion > schema_js_1.CURRENT_SCHEMA_VERSION) {
+            throw new Error(`Bundle schemaVersion=${manifest.schemaVersion} is newer than this build's ` +
+                `CURRENT_SCHEMA_VERSION=${schema_js_1.CURRENT_SCHEMA_VERSION}. Upgrade Seer or pass skipSchemaCheck=true.`);
+        }
+    }
+    const externalHash = manifest.dbSha256;
+    const externalProject = options.alias
+        ?? manifest.source.gitBranch
+        ?? path_1.default.basename(bundlePath, path_1.default.extname(bundlePath));
+    const externalVersion = manifest.source.gitHead ?? null;
+    const absBundlePath = path_1.default.resolve(bundlePath);
+    // Idempotency check: same path + same hash → no-op.
+    const existing = localStore.findExternalBundleByPath(absBundlePath);
+    if (existing && existing.externalHash === externalHash && !options.force) {
+        log(`already imported with the same hash; skipping`);
+        return {
+            bundlePath: absBundlePath,
+            bundleId: existing.id,
+            externalProject: existing.externalProject,
+            externalHash,
+            schemaVersion: manifest.schemaVersion,
+            alreadyImported: true,
+            routesImported: 0,
+            serviceEndpointsImported: 0,
+            elapsedMs: Date.now() - start,
+        };
+    }
+    // Decompress the embedded DB so we can read its tables.
+    const compressed = fileBuf.slice(manifestEnd);
+    const dbBuf = zlib_1.default.gunzipSync(compressed);
+    // Integrity check: the decompressed payload must match the manifest's
+    // sha256 + byte length. A tampered or truncated bundle is rejected here.
+    if (!options.skipIntegrityCheck) {
+        const dbSha = crypto_1.default.createHash('sha256').update(dbBuf).digest('hex');
+        if (dbSha !== manifest.dbSha256) {
+            throw new Error(`Bundle integrity check FAILED. Expected ${manifest.dbSha256}, got ${dbSha}.`);
+        }
+        if (typeof manifest.dbBytes === 'number' && dbBuf.length !== manifest.dbBytes) {
+            throw new Error(`Bundle integrity check FAILED. Expected ${manifest.dbBytes} bytes, got ${dbBuf.length}.`);
+        }
+    }
+    const tmpDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'seer-extbundle-'));
+    const externalDbPath = path_1.default.join(tmpDir, 'external.db');
+    fs_1.default.writeFileSync(externalDbPath, dbBuf);
+    let bundleId = 0;
+    let routesImported = 0;
+    let serviceEndpointsImported = 0;
+    try {
+        const externalStore = store_js_1.Store.openReadOnly(externalDbPath);
+        try {
+            // If we already had this path but with a different hash, wipe the
+            // previous layer first so the new import is a clean replace.
+            if (existing) {
+                const wiped = localStore.clearExternalBundle(existing.id);
+                log(`re-import: wiped previous layer (routes=${wiped.routes}, serviceCalls=${wiped.serviceCalls})`);
+            }
+            // Create the bundle row first so we have a stable id for the phantom
+            // file + the imported route rows.
+            bundleId = localStore.upsertExternalBundle({
+                bundlePath: absBundlePath,
+                externalProject,
+                externalVersion,
+                externalHash,
+                schemaVersion: manifest.schemaVersion,
+                routesImported: 0,
+                serviceCallsImported: 0,
+                serviceLinksImported: 0,
+            });
+            const externalFileId = localStore.ensureExternalFile(bundleId, externalProject);
+            // Import routes from the external bundle. We use the public listRoutes
+            // API which transparently handles pre-v9 column shapes (older bundles
+            // won't carry protocol/operation/etc.).
+            const localRoutes = externalStore.listRoutes({ limit: 1_000_000 });
+            // Filter: we never want external-bundle rows from a nested bundle. If
+            // the source bundle has external_bundle_id, skip those (they're
+            // someone else's external layer).
+            const importableRoutes = localRoutes.filter(r => {
+                // Cannot easily detect external_bundle_id via the public API; raw
+                // probe the column. listRoutes doesn't surface it today, so accept
+                // everything; the bundle generator should not have exported external
+                // rows itself (round-tripping external layers would be misleading).
+                return r.method && r.path;
+            });
+            log(`importing ${importableRoutes.length} routes from external bundle`);
+            localStore.begin();
+            try {
+                for (const r of importableRoutes) {
+                    localStore.insertExternalRoute({
+                        bundleId,
+                        externalFileId,
+                        method: r.method,
+                        path: r.path,
+                        framework: r.framework,
+                        handlerName: r.handlerName,
+                        line: r.line,
+                        protocol: r.protocol ?? 'http',
+                        operation: r.operation ?? null,
+                        topic: r.topic ?? null,
+                        queue: r.queue ?? null,
+                        exchange: r.exchange ?? null,
+                        service: r.service ?? null,
+                        broker: r.broker ?? null,
+                        metadataJson: r.metadataJson ?? null,
+                    });
+                    routesImported++;
+                }
+                localStore.commit();
+            }
+            catch (err) {
+                localStore.rollback();
+                throw err;
+            }
+            // Rebuild service links so the freshly-imported external routes are
+            // visible to the next query immediately, without waiting for a re-index.
+            let serviceLinksImported = 0;
+            if (options.rebuildServiceLinks !== false) {
+                try {
+                    const sr = (0, serviceLinks_js_1.resolveServiceLinks)(localStore);
+                    serviceLinksImported = sr.linksInserted ?? 0;
+                    log(`rebuilt service links (linked=${serviceLinksImported})`);
+                }
+                catch (err) {
+                    log(`service-link rebuild skipped: ${err.message}`);
+                }
+            }
+            // Update final counts on the bundle row.
+            localStore.upsertExternalBundle({
+                bundlePath: absBundlePath,
+                externalProject,
+                externalVersion,
+                externalHash,
+                schemaVersion: manifest.schemaVersion,
+                routesImported,
+                serviceCallsImported: 0,
+                serviceLinksImported,
+            });
+        }
+        finally {
+            externalStore.close();
+        }
+    }
+    finally {
+        try {
+            fs_1.default.unlinkSync(externalDbPath);
+            fs_1.default.rmdirSync(tmpDir);
+        }
+        catch { /* */ }
+    }
+    return {
+        bundlePath: absBundlePath,
+        bundleId,
+        externalProject,
+        externalHash,
+        schemaVersion: manifest.schemaVersion,
+        alreadyImported: false,
+        routesImported,
+        serviceEndpointsImported,
+        elapsedMs: Date.now() - start,
+    };
+}
+//# sourceMappingURL=external.js.map

package/dist/bundle/external.js.map

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

package/dist/bundle/format.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Track-F portable .seer bundle format.
+ *
+ * A bundle is a single self-describing file that lets a team ship a fully
+ * built index without every developer having to re-run `seer index`. The
+ * format is deliberately tiny and dependency-free:
+ *
+ *   [4 bytes: magic 'SEER']
+ *   [4 bytes: bundle format version (uint32 BE)]
+ *   [4 bytes: manifest length (uint32 BE)]
+ *   [N bytes: manifest JSON (utf-8)]
+ *   [M bytes: gzip-compressed SQLite DB]
+ *
+ * Why not tar/zip? Both add a dependency or a hand-rolled archive writer for
+ * a single payload file. Our payload IS the DB; everything else is a few
+ * structured fields. One header + one gzip stream gets us:
+ *   - O(1) manifest read without decompressing the DB
+ *   - cross-platform, no native deps
+ *
+ * On determinism: the gzip stream and the VACUUM INTO'd DB ARE deterministic
+ * for fixed input. The manifest, however, defaults `builtAt = Date.now()` so
+ * out-of-the-box exports of the same DB at different wall-clock times
+ * produce different bytes. If you need bit-identical bundles (build-cache
+ * keys, reproducible-builds CI), pass an explicit `builtAt` to `exportBundle`
+ * to pin it.
+ *
+ * The manifest is the source of truth for:
+ *   - schema_version (so the consumer can refuse incompatible bundles)
+ *   - source signature (repo root, git head, file count + hash) so the
+ *     bundle's "shape" is auditable before the agent trusts it
+ *   - tool versions, build time, SCIP layers contributing precision
+ *
+ * Bundles are produced by `seer bundle export` and consumed by
+ * `seer bundle import`. CI mode (`seer ci bundle`) is a thin wrapper that
+ * runs `index` then `bundle export` and surfaces the resulting path.
+ */
+export declare const BUNDLE_MAGIC: Buffer<ArrayBuffer>;
+export declare const BUNDLE_FORMAT_VERSION = 1;
+export interface BundleManifest {
+    /**
+     * Bundle format version — bumped when the on-disk layout changes
+     * incompatibly. Distinct from the DB schema version, which can bump
+     * independently when only the SQL evolves.
+     */
+    bundleFormatVersion: number;
+    /** Schema version of the embedded DB. Consumers refuse on mismatch. */
+    schemaVersion: number;
+    /** Wall-clock millis the bundle was built. */
+    builtAt: number;
+    /** Tool that produced the bundle. */
+    builtBy: string;
+    /** Source identity. */
+    source: {
+        repoRoot: string;
+        gitHead: string | null;
+        gitBranch: string | null;
+        /** Stable hash over the source file roster — `(relPath, fileHash)` pairs. */
+        rosterHash: string;
+        /** Number of source files indexed. */
+        fileCount: number;
+    };
+    /** Index summary so a consumer can size-check without unpacking. */
+    index: {
+        symbols: number;
+        edges: number;
+        resolvedEdges: number;
+        modules: number;
+        routes: number;
+        externalDependencies: number;
+        configKeys: number;
+        languages: Record<string, number>;
+        /** v7: provenance counts. */
+        provenance?: {
+            symbols: Record<string, number>;
+            edges: Record<string, number>;
+        };
+    };
+    /** SCIP layers folded into the DB (if any). */
+    scipImports: Array<{
+        path: string;
+        sha256: string;
+        tool: string | null;
+        symbolCount: number;
+        refCount: number;
+    }>;
+    /**
+     * Sha-256 of the embedded DB (computed BEFORE compression). Lets the
+     * consumer verify a transferred bundle without trusting the gzip CRC alone.
+     */
+    dbSha256: string;
+    /** Uncompressed DB size in bytes. */
+    dbBytes: number;
+}
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/bundle/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,eAAO,MAAM,YAAY,qBAA+B,CAAC;AACzD,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uEAAuE;IACvE,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,6EAA6E;QAC7E,UAAU,EAAE,MAAM,CAAC;QACnB,sCAAsC;QACtC,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,oEAAoE;IACpE,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,oBAAoB,EAAE,MAAM,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,6BAA6B;QAC7B,UAAU,CAAC,EAAE;YACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SAC/B,CAAC;KACH,CAAC;IACF,+CAA+C;IAC/C,WAAW,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAClD,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;KACvC,CAAC,CAAC;IACH;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB"}