@opencodehub/mcp 0.1.0

package/dist/resources/store-helper.js

@@ -0,0 +1,58 @@
+/**
+ * Shared repo-resolution + store-checkout helper for resource handlers.
+ *
+ * Mirrors the tool-side `withStore` but returns shape appropriate for
+ * resources: instead of `CallToolResult`, resource callbacks return
+ * `ReadResourceResult`, which carries a plain text body. Errors
+ * (missing pool, repo not found, DuckDB open failure) are surfaced as a
+ * YAML error envelope inside the resource body so the agent sees the
+ * problem inline rather than receiving a transport-level fault.
+ */
+import { RepoResolveError, resolveRepo } from "../repo-resolver.js";
+/**
+ * Acquire a read-only store handle for `repoName`, invoke `fn`, and
+ * release. When resolution fails, return a YAML error envelope the
+ * caller should pass straight through. The callback is responsible for
+ * building the happy-path result.
+ */
+export async function withResourceStore(uriHref, repoName, opts, fn) {
+    if (!opts.pool) {
+        return yamlError(uriHref, "pool unavailable", "Server was built without a connection pool.");
+    }
+    const resolveOpts = opts.home !== undefined ? { home: opts.home } : {};
+    try {
+        const resolved = await resolveRepo(repoName, resolveOpts);
+        const store = await opts.pool.acquire(resolved.repoPath, resolved.dbPath);
+        try {
+            return await fn(store, resolved.name);
+        }
+        finally {
+            await opts.pool.release(resolved.repoPath);
+        }
+    }
+    catch (err) {
+        if (err instanceof RepoResolveError) {
+            return yamlError(uriHref, err.code, err.hint);
+        }
+        const msg = err instanceof Error ? err.message : String(err);
+        return yamlError(uriHref, "internal error", msg);
+    }
+}
+function yamlError(uri, error, hint) {
+    const body = [`error: ${quote(error)}`, `hint: ${quote(hint)}`, ""].join("\n");
+    return {
+        contents: [
+            {
+                uri,
+                mimeType: "text/yaml",
+                text: body,
+            },
+        ],
+    };
+}
+function quote(value) {
+    if (/^[A-Za-z0-9._\-/]+$/.test(value))
+        return value;
+    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+//# sourceMappingURL=store-helper.js.map

package/dist/resources/store-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-helper.js","sourceRoot":"","sources":["../../src/resources/store-helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAWpE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,QAA4B,EAC5B,IAA0B,EAC1B,EAAmE;IAEnE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,SAAS,CAAC,OAAO,EAAE,kBAAkB,EAAE,6CAA6C,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC1E,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;gBAAS,CAAC;YACT,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,gBAAgB,EAAE,CAAC;YACpC,OAAO,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,GAAW,EAAE,KAAa,EAAE,IAAY;IACzD,MAAM,IAAI,GAAG,CAAC,UAAU,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/E,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,GAAG;gBACH,QAAQ,EAAE,WAAW;gBACrB,IAAI,EAAE,IAAI;aACX;SACF;KACF,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,KAAa;IAC1B,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACpD,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;AAClE,CAAC"}

package/dist/resources/yaml.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Minimal YAML scalar quoter shared across resource handlers.
+ *
+ * Resources emit YAML for agent readability (see `repo-context.ts`). The
+ * quoter is intentionally conservative: plain identifiers pass through
+ * unquoted, anything else is wrapped in double quotes with embedded
+ * quotes escaped. A loose parser will round-trip either form.
+ */
+export declare function yamlScalar(value: string | number | boolean): string;
+//# sourceMappingURL=yaml.d.ts.map

package/dist/resources/yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../src/resources/yaml.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAInE"}

package/dist/resources/yaml.js

@@ -0,0 +1,16 @@
+/**
+ * Minimal YAML scalar quoter shared across resource handlers.
+ *
+ * Resources emit YAML for agent readability (see `repo-context.ts`). The
+ * quoter is intentionally conservative: plain identifiers pass through
+ * unquoted, anything else is wrapped in double quotes with embedded
+ * quotes escaped. A loose parser will round-trip either form.
+ */
+export function yamlScalar(value) {
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    if (/^[A-Za-z0-9._\-/]+$/.test(value))
+        return value;
+    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+//# sourceMappingURL=yaml.js.map

package/dist/resources/yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../src/resources/yaml.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,UAAU,UAAU,CAAC,KAAgC;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IAClF,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACpD,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;AAClE,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,46 @@
+/**
+ * stdio MCP server for OpenCodeHub.
+ *
+ * Wires together the tool and resource registrations against a single
+ * shared `ConnectionPool`. The stdio transport reads JSON-RPC from stdin
+ * and writes responses to stdout; anything else the process emits (the
+ * connection pool, tool handlers) should go to stderr so it does not
+ * corrupt the transport.
+ *
+ * The `instructions` field is prose the model sees at session start. We
+ * use it to nudge agents toward `list_repos` first, and we advertise the
+ * staleness envelope so clients are primed to surface it.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ConnectionPool } from "./connection-pool.js";
+export interface StartServerOptions {
+    /** Override the home directory used to locate ~/.codehub/registry.json. */
+    readonly home?: string;
+    /** Override the connection-pool cap (default 8). */
+    readonly poolMax?: number;
+    /** Override the connection-pool idle TTL (default 15 minutes). */
+    readonly poolTtlMs?: number;
+    /**
+     * Suppress the one-time "embeddings weights not found" startup warning.
+     * Tests set this so stderr stays quiet; production callers should leave
+     * it unset.
+     */
+    readonly silentEmbedderProbe?: boolean;
+}
+export interface RunningServer {
+    readonly server: McpServer;
+    readonly pool: ConnectionPool;
+    shutdown(): Promise<void>;
+}
+/**
+ * Build a fully-wired `McpServer` (without connecting a transport). The
+ * CLI wrapper uses this to embed the server in-process; the stdio entry
+ * point in `index.ts` connects a stdio transport on top.
+ */
+export declare function buildServer(opts?: StartServerOptions): RunningServer;
+/**
+ * Entry point: build the server, connect stdio, and install a SIGINT /
+ * SIGTERM / stdin-close handler that drains the pool before exiting.
+ */
+export declare function startStdioServer(opts?: StartServerOptions): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAmDtD,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACxC;AAiCD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,GAAE,kBAAuB,GAAG,aAAa,CAuExE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBnF"}

package/dist/server.js

@@ -0,0 +1,194 @@
+/**
+ * stdio MCP server for OpenCodeHub.
+ *
+ * Wires together the tool and resource registrations against a single
+ * shared `ConnectionPool`. The stdio transport reads JSON-RPC from stdin
+ * and writes responses to stdout; anything else the process emits (the
+ * connection pool, tool handlers) should go to stderr so it does not
+ * corrupt the transport.
+ *
+ * The `instructions` field is prose the model sees at session start. We
+ * use it to nudge agents toward `list_repos` first, and we advertise the
+ * staleness envelope so clients are primed to surface it.
+ */
+import { access } from "node:fs/promises";
+import { join } from "node:path";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { getDefaultModelRoot, modelFileName, resolveModelDir } from "@opencodehub/embedder";
+import { ConnectionPool } from "./connection-pool.js";
+import { registerRepoClusterResource } from "./resources/repo-cluster.js";
+import { registerRepoClustersResource } from "./resources/repo-clusters.js";
+import { registerRepoContextResource } from "./resources/repo-context.js";
+import { registerRepoProcessResource } from "./resources/repo-process.js";
+import { registerRepoProcessesResource } from "./resources/repo-processes.js";
+import { registerRepoSchemaResource } from "./resources/repo-schema.js";
+import { registerReposResource } from "./resources/repos.js";
+import { registerApiImpactTool } from "./tools/api-impact.js";
+import { registerContextTool } from "./tools/context.js";
+import { registerDependenciesTool } from "./tools/dependencies.js";
+import { registerDetectChangesTool } from "./tools/detect-changes.js";
+import { registerGroupContractsTool } from "./tools/group-contracts.js";
+import { registerGroupCrossRepoLinksTool } from "./tools/group-cross-repo-links.js";
+import { registerGroupListTool } from "./tools/group-list.js";
+import { registerGroupQueryTool } from "./tools/group-query.js";
+import { registerGroupStatusTool } from "./tools/group-status.js";
+import { registerGroupSyncTool } from "./tools/group-sync.js";
+import { registerImpactTool } from "./tools/impact.js";
+import { registerLicenseAuditTool } from "./tools/license-audit.js";
+import { registerListDeadCodeTool } from "./tools/list-dead-code.js";
+import { registerListFindingsTool } from "./tools/list-findings.js";
+import { registerListFindingsDeltaTool } from "./tools/list-findings-delta.js";
+import { registerListReposTool } from "./tools/list-repos.js";
+import { registerOwnersTool } from "./tools/owners.js";
+import { registerPackCodebaseTool } from "./tools/pack-codebase.js";
+import { registerProjectProfileTool } from "./tools/project-profile.js";
+import { registerQueryTool } from "./tools/query.js";
+import { registerRemoveDeadCodeTool } from "./tools/remove-dead-code.js";
+import { registerRenameTool } from "./tools/rename.js";
+import { registerRiskTrendsTool } from "./tools/risk-trends.js";
+import { registerRouteMapTool } from "./tools/route-map.js";
+import { registerScanTool } from "./tools/scan.js";
+import { registerShapeCheckTool } from "./tools/shape-check.js";
+import { registerSqlTool } from "./tools/sql.js";
+import { registerToolMapTool } from "./tools/tool-map.js";
+import { registerVerdictTool } from "./tools/verdict.js";
+const SERVER_NAME = "opencodehub";
+const SERVER_VERSION = "0.0.0";
+const INSTRUCTIONS = [
+    "OpenCodeHub exposes indexed code graphs for MCP agents.",
+    "Typical flow: call `list_repos` first to discover indexed repos, then route subsequent calls through one of those repo names.",
+    "Every per-repo tool (`query`, `context`, `impact`, `detect_changes`, `rename`, `sql`, `scan`, `list_findings`, `list_findings_delta`, `list_dead_code`, `remove_dead_code`, `license_audit`, `project_profile`, `dependencies`, `owners`, `risk_trends`, `verdict`) accepts an optional `repo` argument (registry name) or a `repo_uri` alias (Sourcegraph-style URI like `github.com/org/repo`, or `local:<hash>` for unpublished repos; wins when both are provided). When exactly one repo is registered, both are optional and the tool defaults to that repo. When ≥ 2 repos are registered and neither is supplied, the tool returns `AMBIGUOUS_REPO` — the structured envelope carries `structuredContent.error.choices[]` (capped at 10, with `{repo_uri, default_branch, group}`) plus `total_matches`, so a caller can retry with one of `choices[].repo_uri`.",
+    "Every tool response includes a `next_steps` array under structuredContent and a `_meta.codehub/staleness` entry when the index may be behind HEAD.",
+    "Use `query` to locate symbols, `context` for a 360-degree view, `impact` for blast radius, `detect_changes` to map a diff to flows, `rename` for coordinated renames (dry-run by default), `dependencies` for the external package list, `license_audit` for a copyleft/unknown/proprietary tier check of dependencies, `list_findings` to browse SARIF findings, `list_findings_delta` to diff the latest scan against a frozen baseline (new/fixed/unchanged/updated buckets), `scan` to run Priority-1 scanners (openWorld — spawns processes), `verdict` for a 5-tier PR decision (exit codes 0/1/2), `risk_trends` for per-community trend lines and 30-day projections, and `sql` for bespoke queries.",
+    "For cross-repo work, call `group_list` to discover named repo groups, then `group_query`/`group_status` to fan out BM25 search and staleness across the group. `group_query` returns `{ group, query, results: [{ _repo, _rrf_score, ... }], per_repo, warnings }`; results are tagged with the source repo and per-repo errors surface in `per_repo[].error` + `warnings[]` (the fan-out never aborts on a single-repo failure). Use `group_sync` to materialize a cross-repo contract registry (HTTP / gRPC / topic) under `~/.codehub/groups/<name>/contracts.json`, then `group_contracts` to list the DuckDB-backed FETCHES↔Route edges together with the registry's signature-matched cross-links.",
+].join(" ");
+/**
+ * Probe for gte-modernbert-base weights on disk. Runs once at server startup
+ * and logs a single structured warning when the weights are absent so
+ * agents see the BM25-only fallback reason. Never throws: a missing or
+ * unreadable model directory is a supported deployment mode.
+ */
+async function probeEmbedderWeights(silent) {
+    if (silent)
+        return;
+    try {
+        for (const variant of ["fp32", "int8"]) {
+            const modelDir = resolveModelDir(undefined, variant);
+            const modelPath = join(modelDir, modelFileName(variant));
+            try {
+                await access(modelPath);
+                // At least one variant is installed — stay silent.
+                return;
+            }
+            catch {
+                // try the next variant
+            }
+        }
+        const root = getDefaultModelRoot();
+        console.warn(`[mcp] hybrid: embeddings weights not found at ${root}/models/gte-modernbert-base/; run \`codehub setup --embeddings\`. Falling back to BM25-only.`);
+    }
+    catch (err) {
+        // Probe failure is non-fatal; surface the reason but keep going.
+        const message = err instanceof Error ? err.message : String(err);
+        console.warn(`[mcp] hybrid: embedder probe failed: ${message}. Falling back to BM25-only.`);
+    }
+}
+/**
+ * Build a fully-wired `McpServer` (without connecting a transport). The
+ * CLI wrapper uses this to embed the server in-process; the stdio entry
+ * point in `index.ts` connects a stdio transport on top.
+ */
+export function buildServer(opts = {}) {
+    const poolOpts = {};
+    if (opts.poolMax !== undefined)
+        poolOpts.max = opts.poolMax;
+    if (opts.poolTtlMs !== undefined)
+        poolOpts.ttlMs = opts.poolTtlMs;
+    const pool = new ConnectionPool(poolOpts);
+    const ctx = opts.home !== undefined ? { pool, home: opts.home } : { pool };
+    // Fire-and-forget embedder availability probe so the one-time warning is
+    // emitted before the first `query` call. Never blocks startup; never
+    // affects tool registration.
+    void probeEmbedderWeights(opts.silentEmbedderProbe === true);
+    const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION }, {
+        capabilities: {
+            tools: { listChanged: false },
+            resources: { listChanged: false },
+        },
+        instructions: INSTRUCTIONS,
+    });
+    registerListReposTool(server, ctx);
+    registerPackCodebaseTool(server, ctx);
+    registerQueryTool(server, ctx);
+    registerContextTool(server, ctx);
+    registerImpactTool(server, ctx);
+    registerDetectChangesTool(server, ctx);
+    registerRenameTool(server, ctx);
+    registerSqlTool(server, ctx);
+    registerGroupListTool(server, ctx);
+    registerGroupQueryTool(server, ctx);
+    registerGroupStatusTool(server, ctx);
+    registerGroupContractsTool(server, ctx);
+    registerGroupCrossRepoLinksTool(server, ctx);
+    registerGroupSyncTool(server, ctx);
+    registerProjectProfileTool(server, ctx);
+    registerDependenciesTool(server, ctx);
+    registerLicenseAuditTool(server, ctx);
+    registerOwnersTool(server, ctx);
+    registerListFindingsTool(server, ctx);
+    registerListFindingsDeltaTool(server, ctx);
+    registerListDeadCodeTool(server, ctx);
+    registerRemoveDeadCodeTool(server, ctx);
+    registerScanTool(server, ctx);
+    registerVerdictTool(server, ctx);
+    registerRiskTrendsTool(server, ctx);
+    registerRouteMapTool(server, ctx);
+    registerApiImpactTool(server, ctx);
+    registerShapeCheckTool(server, ctx);
+    registerToolMapTool(server, ctx);
+    const resCtx = opts.home !== undefined ? { home: opts.home, pool } : { pool };
+    registerReposResource(server, resCtx);
+    registerRepoContextResource(server, resCtx);
+    registerRepoSchemaResource(server, resCtx);
+    registerRepoClustersResource(server, resCtx);
+    registerRepoClusterResource(server, resCtx);
+    registerRepoProcessesResource(server, resCtx);
+    registerRepoProcessResource(server, resCtx);
+    return {
+        server,
+        pool,
+        shutdown: async () => {
+            await server.close();
+            await pool.shutdown();
+        },
+    };
+}
+/**
+ * Entry point: build the server, connect stdio, and install a SIGINT /
+ * SIGTERM / stdin-close handler that drains the pool before exiting.
+ */
+export async function startStdioServer(opts = {}) {
+    const running = buildServer(opts);
+    const transport = new StdioServerTransport();
+    await running.server.connect(transport);
+    const bail = async (code) => {
+        try {
+            await running.shutdown();
+        }
+        finally {
+            process.exit(code);
+        }
+    };
+    process.on("SIGINT", () => {
+        void bail(130);
+    });
+    process.on("SIGTERM", () => {
+        void bail(143);
+    });
+    // Some clients signal disconnect via stdin close rather than a signal.
+    process.stdin.on("close", () => {
+        void bail(0);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/staleness.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Thin wrappers around `@opencodehub/analysis.computeStaleness`.
+ *
+ * Tool handlers want a simple `Promise<StalenessEnvelope | undefined>`;
+ * the analysis package returns a slightly wider shape. We adapt and, as
+ * a cheap optimization, fall back to a meta-only envelope when the
+ * caller explicitly asks to skip the git probe (resources/read, for
+ * example, fires many times and should not shell out each time).
+ */
+import type { StalenessEnvelope } from "@opencodehub/core-types";
+import type { StoreMeta } from "@opencodehub/storage";
+export declare function stalenessFor(repoPath: string, meta: StoreMeta | undefined): Promise<StalenessEnvelope | undefined>;
+/**
+ * Non-async fallback used in hot paths where we want to skip the git
+ * probe. Emits a 0-behind envelope carrying just the last-indexed commit
+ * from the sidecar.
+ */
+export declare function stalenessFromMeta(meta: StoreMeta | undefined): StalenessEnvelope | undefined;
+//# sourceMappingURL=staleness.d.ts.map

package/dist/staleness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staleness.d.ts","sourceRoot":"","sources":["../src/staleness.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,SAAS,GAAG,SAAS,GAC1B,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAaxC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAO5F"}

package/dist/staleness.js

@@ -0,0 +1,40 @@
+/**
+ * Thin wrappers around `@opencodehub/analysis.computeStaleness`.
+ *
+ * Tool handlers want a simple `Promise<StalenessEnvelope | undefined>`;
+ * the analysis package returns a slightly wider shape. We adapt and, as
+ * a cheap optimization, fall back to a meta-only envelope when the
+ * caller explicitly asks to skip the git probe (resources/read, for
+ * example, fires many times and should not shell out each time).
+ */
+import { computeStaleness } from "@opencodehub/analysis";
+export async function stalenessFor(repoPath, meta) {
+    if (!meta)
+        return undefined;
+    const result = await computeStaleness(repoPath, meta.lastCommit);
+    const envelope = {
+        isStale: result.isStale,
+        commitsBehind: result.commitsBehind,
+        ...(result.hint !== undefined ? { hint: result.hint } : {}),
+        ...(result.lastIndexedCommit !== undefined
+            ? { lastIndexedCommit: result.lastIndexedCommit }
+            : {}),
+        ...(result.currentCommit !== undefined ? { currentCommit: result.currentCommit } : {}),
+    };
+    return envelope;
+}
+/**
+ * Non-async fallback used in hot paths where we want to skip the git
+ * probe. Emits a 0-behind envelope carrying just the last-indexed commit
+ * from the sidecar.
+ */
+export function stalenessFromMeta(meta) {
+    if (!meta)
+        return undefined;
+    return {
+        isStale: false,
+        commitsBehind: 0,
+        ...(meta.lastCommit !== undefined ? { lastIndexedCommit: meta.lastCommit } : {}),
+    };
+}
+//# sourceMappingURL=staleness.js.map

package/dist/staleness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staleness.js","sourceRoot":"","sources":["../src/staleness.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAIzD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,IAA2B;IAE3B,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAsB;QAClC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,MAAM,CAAC,iBAAiB,KAAK,SAAS;YACxC,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE;YACjD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvF,CAAC;IACF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA2B;IAC3D,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,OAAO;QACL,OAAO,EAAE,KAAK;QACd,aAAa,EAAE,CAAC;QAChB,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjF,CAAC;AACJ,CAAC"}

package/dist/test-utils.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Shared MCP test fixtures.
+ *
+ * The production tools/resources call typed finders on `IGraphStore`
+ * (`listNodes`, `listNodesByKind`, `listEdges`,
+ * `listEdgesByType`, `listFindings`, `listRoutes`, `getRepoNode`,
+ * `traverseAncestors`, `listEmbeddingHashes`, etc.) rather than raw
+ * `query(<sql>)`. This file gives every mcp test a small, composable
+ * in-memory backing store so each test only needs to seed the data it
+ * cares about — nodes, edges, findings, routes — and supply
+ * test-specific overrides as needed.
+ *
+ * The module is intentionally tolerant: every typed finder has a sane
+ * default that filters the seeded arrays exactly the way the real
+ * `DuckDbStore` does. Tests can override a single finder via the
+ * `overrides` parameter when they need bespoke behaviour (e.g. cochanges,
+ * BM25 search, traversal).
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CallToolResult, ReadResourceResult } from "@modelcontextprotocol/sdk/types.js";
+import type { DuckDbStore, IGraphStore, ITemporalStore, Store } from "@opencodehub/storage";
+import { ConnectionPool } from "./connection-pool.js";
+/**
+ * Wrap an in-memory IGraphStore-shaped fake as the composed `Store`
+ * (`OpenStoreResult`) that the connection pool returns. The same
+ * instance backs both `graph` and `temporal` because DuckDbStore
+ * implements both interfaces over a single connection in production.
+ */
+export declare function wrapAsStore(fake: unknown): Store;
+export interface FakeNodeLike {
+    readonly id: string;
+    readonly kind: string;
+    readonly name?: string;
+    readonly filePath?: string;
+    readonly file_path?: string;
+    readonly [extra: string]: unknown;
+}
+export interface FakeEdgeLike {
+    readonly type: string;
+    readonly from?: string;
+    readonly to?: string;
+    readonly fromId?: string;
+    readonly toId?: string;
+    readonly from_id?: string;
+    readonly to_id?: string;
+    readonly confidence?: number;
+    readonly step?: number | null;
+    readonly reason?: string;
+    readonly [extra: string]: unknown;
+}
+/**
+ * Findings/routes/dependencies/repos are typed loosely on input — tests
+ * pass plain records and the helper coerces to the typed `*Node` shape on
+ * the way out of each finder. This sidesteps `NodeId`-branded ids while
+ * keeping the keys discoverable.
+ */
+export type FakeFinding = {
+    readonly id: string;
+    readonly kind?: "Finding" | undefined;
+    readonly name?: string | undefined;
+    readonly filePath?: string | undefined;
+    readonly scannerId?: string | undefined;
+    readonly ruleId?: string | undefined;
+    readonly severity?: "note" | "warning" | "error" | "none" | undefined;
+    readonly message?: string | undefined;
+    readonly propertiesBag?: Record<string, unknown> | undefined;
+    readonly startLine?: number | undefined;
+    readonly endLine?: number | undefined;
+    readonly partialFingerprint?: string | undefined;
+    readonly baselineState?: "new" | "unchanged" | "updated" | "absent" | undefined;
+    readonly suppressedJson?: string | undefined;
+};
+export type FakeRoute = {
+    readonly id: string;
+    readonly kind?: "Route" | undefined;
+    readonly name?: string | undefined;
+    readonly filePath?: string | undefined;
+    readonly url?: string | undefined;
+    readonly method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | string | undefined;
+    readonly responseKeys?: readonly string[] | undefined;
+    readonly httpMethod?: string | undefined;
+    readonly httpPath?: string | undefined;
+    readonly path?: string | undefined;
+};
+export type FakeDependency = {
+    readonly id: string;
+    readonly kind?: "Dependency" | undefined;
+    readonly name?: string | undefined;
+    readonly filePath?: string | undefined;
+    readonly ecosystem?: string | undefined;
+    readonly version?: string | undefined;
+    readonly license?: string | undefined;
+    readonly licenseTier?: "permissive" | "weak-copyleft" | "strong-copyleft" | "proprietary" | "unknown" | undefined;
+};
+export type FakeRepo = {
+    readonly id: string;
+    readonly kind?: "Repo" | undefined;
+    readonly name?: string | undefined;
+    readonly filePath?: string | undefined;
+    readonly originUrl?: string | null | undefined;
+    readonly defaultBranch?: string | null | undefined;
+    readonly group?: string | null | undefined;
+    readonly repoUri?: string | undefined;
+};
+export interface FakeData {
+    readonly nodes?: readonly FakeNodeLike[];
+    readonly edges?: readonly FakeEdgeLike[];
+    readonly findings?: readonly FakeFinding[];
+    readonly routes?: readonly FakeRoute[];
+    readonly dependencies?: readonly FakeDependency[];
+    readonly repoNodes?: readonly FakeRepo[];
+    readonly embeddingHashes?: ReadonlyMap<string, string>;
+}
+/**
+ * Per-finder override map. Any finder a test sets on this object replaces
+ * the default seed-filter implementation. Useful when a test needs custom
+ * BM25 results, cochange rows, or traversal output.
+ */
+export type StoreOverrides = Partial<{
+    [K in keyof IGraphStore]: IGraphStore[K];
+}> & Partial<{
+    lookupCochangesForFile: ITemporalStore["lookupCochangesForFile"];
+    lookupCochangesBetween: ITemporalStore["lookupCochangesBetween"];
+    lookupSymbolSummary: ITemporalStore["lookupSymbolSummary"];
+    lookupSymbolSummariesByNode: ITemporalStore["lookupSymbolSummariesByNode"];
+    bulkLoadCochanges: ITemporalStore["bulkLoadCochanges"];
+    bulkLoadSymbolSummaries: ITemporalStore["bulkLoadSymbolSummaries"];
+    exec: ITemporalStore["exec"];
+    execCypher: NonNullable<IGraphStore["execCypher"]>;
+    query: (sql: string, params?: readonly unknown[], opts?: {
+        readonly timeoutMs?: number;
+    }) => Promise<readonly Record<string, unknown>[]>;
+}>;
+export declare function makeFakeGraphStore(data?: FakeData, overrides?: StoreOverrides): DuckDbStore;
+export interface FakeRegistryEntry {
+    readonly name: string;
+    readonly path?: string;
+    readonly indexedAt?: string;
+    readonly nodeCount?: number;
+    readonly edgeCount?: number;
+    readonly lastCommit?: string;
+}
+export interface McpHarness {
+    readonly home: string;
+    readonly pool: ConnectionPool;
+    readonly server: McpServer;
+    readonly repoPath: string;
+    readonly repoName: string;
+}
+export interface MakeHarnessOptions {
+    readonly repoName?: string;
+    readonly registry?: Readonly<Record<string, FakeRegistryEntry>>;
+    readonly storeFactory: () => DuckDbStore | Promise<DuckDbStore>;
+    readonly serverCapabilities?: {
+        tools?: object;
+        resources?: object;
+    };
+    readonly tmpPrefix?: string;
+}
+/**
+ * Spin up a temp `home/.codehub/registry.json`, a `ConnectionPool` whose
+ * factory returns the supplied fake store, and a fresh `McpServer`. Hands
+ * everything back to the caller's `fn` and tears down on exit.
+ */
+export declare function withMcpHarness(opts: MakeHarnessOptions, fn: (h: McpHarness) => Promise<void>): Promise<void>;
+export type ToolHandler = (args: unknown, extra: unknown) => Promise<CallToolResult>;
+export declare function getToolHandler(server: McpServer, name: string): ToolHandler;
+export type ResourceReadHandler = (uri: URL, vars: Record<string, string | string[]>, extra: unknown) => Promise<ReadResourceResult>;
+export declare function getResourceHandler(server: McpServer, name: string): ResourceReadHandler;
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/test-utils.d.ts.map

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