@opencodehub/mcp 0.1.0

package/dist/tools/dependencies.js

@@ -0,0 +1,110 @@
+/**
+ * `dependencies` — enumerate Dependency nodes for an indexed repo.
+ *
+ * A Dependency node is produced by the `dependencies` pipeline phase
+ * from per-ecosystem manifest parsers. Every node carries
+ * `ecosystem`, `name`, `version`, and a `lockfileSource` relpath.
+ *
+ * Filters:
+ *   - `ecosystem`   — restrict to one ecosystem (npm, pypi, go, cargo,
+ *                     maven, nuget). Server does no validation beyond
+ *                     string compare — an unknown value returns an
+ *                     empty list.
+ *   - `filePath`    — substring match against `file_path` (alias of the
+ *                     lockfile source). Useful when a repo has multiple
+ *                     workspaces with their own manifests.
+ */
+// biome-ignore-all lint/complexity/useLiteralKeys: dot-access disallowed on Record index signatures
+import { z } from "zod";
+import { toolErrorFromUnknown } from "../error-envelope.js";
+import { withNextSteps } from "../next-step-hints.js";
+import { stalenessFromMeta } from "../staleness.js";
+import { fromToolResult, repoArgShape, toToolResult, withStore, } from "./shared.js";
+const DependenciesInput = {
+    ...repoArgShape,
+    filePath: z
+        .string()
+        .optional()
+        .describe("Optional substring filter on the manifest path (e.g. 'apps/web/package.json')."),
+    ecosystem: z
+        .enum(["npm", "pypi", "go", "cargo", "maven", "nuget"])
+        .optional()
+        .describe("Restrict to a single ecosystem."),
+    limit: z
+        .number()
+        .int()
+        .positive()
+        .max(10_000)
+        .optional()
+        .describe("Maximum number of dependencies to return (default 500, max 10000)."),
+};
+export async function runDependencies(ctx, args) {
+    const limit = args.limit ?? 500;
+    const call = await withStore(ctx, args, async (store, resolved) => {
+        try {
+            // Typed `listDependencies` finder reads the Dependency rows directly,
+            // already rehydrated into the typed shape. The `filePath` substring
+            // filter is applied in TS because the finder doesn't expose a LIKE
+            // option — dependencies are bounded per repo so a TS filter is fine.
+            const opts = { limit };
+            if (args.ecosystem !== undefined)
+                opts.ecosystem = args.ecosystem;
+            const all = await store.graph.listDependencies(opts);
+            const filtered = args.filePath === undefined
+                ? all
+                : all.filter((d) => {
+                    const lf = d.lockfileSource ?? d.filePath;
+                    return lf.includes(args.filePath);
+                });
+            const rows = filtered.map((d) => ({
+                id: d.id,
+                name: d.name,
+                version: stringOr(d.version, "UNKNOWN"),
+                ecosystem: stringOr(d.ecosystem, "unknown"),
+                license: stringOr(d.license, "UNKNOWN"),
+                lockfileSource: stringOr(d.lockfileSource, d.filePath),
+            }));
+            const header = `Dependencies (${rows.length}) for ${resolved.name}${args.ecosystem ? ` · ecosystem=${args.ecosystem}` : ""}${args.filePath ? ` · filePath~${args.filePath}` : ""}:`;
+            const body = rows.length === 0
+                ? "(no dependencies found — index the repo with `codehub analyze` and verify the pipeline ran the `dependencies` phase)"
+                : rows
+                    .map((d) => `- [${d.ecosystem}] ${d.name}@${d.version}  (${d.lockfileSource}, license=${d.license})`)
+                    .join("\n");
+            const next = rows.length === 0
+                ? [
+                    "call `list_repos` to confirm the repo is indexed",
+                    "re-index with `codehub analyze` to populate Dependency nodes",
+                ]
+                : [
+                    "call `query` with one of the names above to find import sites",
+                    "call `sql` with 'SELECT * FROM relations WHERE type = ''DEPENDS_ON''' for the raw edges",
+                ];
+            return withNextSteps(`${header}\n${body}`, { dependencies: rows, total: rows.length }, next, stalenessFromMeta(resolved.meta));
+        }
+        catch (err) {
+            return toolErrorFromUnknown(err);
+        }
+    });
+    return toToolResult(call);
+}
+export function registerDependenciesTool(server, ctx) {
+    server.registerTool("dependencies", {
+        title: "List external dependencies",
+        description: "Enumerate external package dependencies of the indexed repo, sourced from lockfiles and manifests (package-lock.json, pnpm-lock.yaml, pyproject.toml, requirements.txt, uv.lock, go.mod, go.sum, Cargo.lock, Cargo.toml, pom.xml, *.csproj, packages.lock.json). Optionally filter by ecosystem or lockfile path substring. License field is 'UNKNOWN' at v1.0; real license detection lands in a later release.",
+        inputSchema: DependenciesInput,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+            idempotentHint: true,
+        },
+    }, async (args) => fromToolResult(await runDependencies(ctx, args)));
+}
+function stringOr(v, fallback) {
+    if (typeof v === "string")
+        return v;
+    if (typeof v === "number" || typeof v === "boolean")
+        return String(v);
+    return fallback;
+}
+//# sourceMappingURL=dependencies.js.map

package/dist/tools/dependencies.js.map

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

package/dist/tools/detect-changes.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `detect_changes` — map a git diff to affected graph symbols & processes.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolContext, type ToolResult } from "./shared.js";
+interface DetectChangesArgs {
+    readonly scope: "unstaged" | "staged" | "all" | "compare";
+    readonly compareRef?: string | undefined;
+    readonly repo?: string | undefined;
+    readonly repo_uri?: string | undefined;
+}
+export declare function runDetectChanges(ctx: ToolContext, args: DetectChangesArgs): Promise<ToolResult>;
+export declare function registerDetectChangesTool(server: McpServer, ctx: ToolContext): void;
+export {};
+//# sourceMappingURL=detect-changes.d.ts.map

package/dist/tools/detect-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-changes.d.ts","sourceRoot":"","sources":["../../src/tools/detect-changes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,UAAU,EAGhB,MAAM,aAAa,CAAC;AAerB,UAAU,iBAAiB;IACzB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;IAC1D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,UAAU,CAAC,CAwDrB;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAiBnF"}

package/dist/tools/detect-changes.js

@@ -0,0 +1,78 @@
+/**
+ * `detect_changes` — map a git diff to affected graph symbols & processes.
+ */
+import { z } from "zod";
+import { callRunDetectChanges } from "../analysis-bridge.js";
+import { toolErrorFromUnknown } from "../error-envelope.js";
+import { withNextSteps } from "../next-step-hints.js";
+import { stalenessFromMeta } from "../staleness.js";
+import { fromToolResult, repoArgShape, toToolResult, withStore, } from "./shared.js";
+const DetectChangesInput = {
+    scope: z
+        .enum(["unstaged", "staged", "all", "compare"])
+        .describe("unstaged = working-tree diff, staged = index diff, all = union, compare = diff vs compareRef."),
+    compareRef: z
+        .string()
+        .optional()
+        .describe("Git ref to compare against (only used when scope='compare')."),
+    ...repoArgShape,
+};
+export async function runDetectChanges(ctx, args) {
+    const call = await withStore(ctx, args, async (store, resolved) => {
+        try {
+            const q = { scope: args.scope, repoPath: resolved.repoPath };
+            if (args.compareRef !== undefined)
+                q.compareRef = args.compareRef;
+            const result = await callRunDetectChanges(store.graph, q);
+            const lines = [];
+            lines.push(`${result.summary.fileCount} file(s), ${result.summary.symbolCount} symbol(s), ${result.summary.processCount} process(es) affected. Risk: ${result.summary.risk}.`);
+            if (result.changedFiles.length > 0) {
+                lines.push(`Changed files:`);
+                for (const f of result.changedFiles.slice(0, 30))
+                    lines.push(`  • ${f}`);
+            }
+            if (result.affectedSymbols.length > 0) {
+                lines.push(`Affected symbols (${result.affectedSymbols.length}):`);
+                for (const s of result.affectedSymbols.slice(0, 50)) {
+                    lines.push(`  • ${s.name} [${s.kind}] — ${s.filePath}`);
+                }
+            }
+            if (result.affectedProcesses.length > 0) {
+                lines.push(`Affected processes (${result.affectedProcesses.length}):`);
+                for (const p of result.affectedProcesses) {
+                    lines.push(`  ⊿ ${p.name}`);
+                }
+            }
+            const next = result.affectedSymbols.length > 0
+                ? [
+                    "call `impact` on each affected symbol for per-change risk",
+                    "call `query` with the feature name to confirm test coverage",
+                ]
+                : ["no indexed symbols touched — change may be to docs or tests only"];
+            return withNextSteps(lines.join("\n"), {
+                summary: result.summary,
+                changed_files: result.changedFiles,
+                affected_symbols: result.affectedSymbols,
+                affected_processes: result.affectedProcesses,
+            }, next, stalenessFromMeta(resolved.meta));
+        }
+        catch (err) {
+            return toolErrorFromUnknown(err);
+        }
+    });
+    return toToolResult(call);
+}
+export function registerDetectChangesTool(server, ctx) {
+    server.registerTool("detect_changes", {
+        title: "Map git diff to indexed symbols",
+        description: "Parse the repo's git diff for the requested scope (unstaged, staged, all, or compared to a ref) and map every changed line back to indexed symbols. Lists the affected processes so agents can spot flows impacted by a commit before pushing.",
+        inputSchema: DetectChangesInput,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (args) => fromToolResult(await runDetectChanges(ctx, args)));
+}
+//# sourceMappingURL=detect-changes.js.map

package/dist/tools/detect-changes.js.map

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

package/dist/tools/group-contracts.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `group_contracts` — cross-repo HTTP-contract discovery.
+ *
+ * For every repo in a named group, read the unresolved FETCHES edges
+ * stored by the `fetches` ingestion phase (target id prefixed with
+ * `fetches:unresolved:METHOD:URL`). Each unresolved edge is then matched
+ * against the `Route` nodes in every OTHER repo in the group. A match
+ * surfaces as a `contract` row mapping consumer → producer.
+ *
+ * Determinism:
+ *   - Repos iterate in alphabetical order.
+ *   - Contracts are sorted by (consumerRepo, consumerSymbol, method,
+ *     path, producerRepo) so repeated calls yield stable output.
+ *
+ * Annotations: readOnlyHint, idempotentHint, openWorldHint:false — the
+ * tool never reaches past the named group.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolContext, type ToolResult } from "./shared.js";
+interface GroupContractsArgs {
+    readonly groupName: string;
+}
+export declare function runGroupContracts(ctx: ToolContext, args: GroupContractsArgs): Promise<ToolResult>;
+export declare function registerGroupContractsTool(server: McpServer, ctx: ToolContext): void;
+export {};
+//# sourceMappingURL=group-contracts.d.ts.map

package/dist/tools/group-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-contracts.d.ts","sourceRoot":"","sources":["../../src/tools/group-contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWzE,OAAO,EAAkB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAgB,MAAM,aAAa,CAAC;AAmF9F,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,UAAU,CAAC,CA6JrB;AAsBD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAiBpF"}

package/dist/tools/group-contracts.js

@@ -0,0 +1,251 @@
+/**
+ * `group_contracts` — cross-repo HTTP-contract discovery.
+ *
+ * For every repo in a named group, read the unresolved FETCHES edges
+ * stored by the `fetches` ingestion phase (target id prefixed with
+ * `fetches:unresolved:METHOD:URL`). Each unresolved edge is then matched
+ * against the `Route` nodes in every OTHER repo in the group. A match
+ * surfaces as a `contract` row mapping consumer → producer.
+ *
+ * Determinism:
+ *   - Repos iterate in alphabetical order.
+ *   - Contracts are sorted by (consumerRepo, consumerSymbol, method,
+ *     path, producerRepo) so repeated calls yield stable output.
+ *
+ * Annotations: readOnlyHint, idempotentHint, openWorldHint:false — the
+ * tool never reaches past the named group.
+ */
+// biome-ignore-all lint/complexity/useLiteralKeys: dot-access disallowed on Record index signatures
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { resolveDbPath } from "@opencodehub/storage";
+import { z } from "zod";
+import { toolError, toolErrorFromUnknown } from "../error-envelope.js";
+import { readGroup } from "../group-resolver.js";
+import { withNextSteps } from "../next-step-hints.js";
+import { readRegistry } from "../repo-resolver.js";
+import { repoUriForEntry } from "../repo-uri-for-entry.js";
+import { resolveGroupContractsPath } from "./group-sync.js";
+import { fromToolResult, toToolResult } from "./shared.js";
+const UNRESOLVED_PREFIX = "fetches:unresolved:";
+const GroupContractsInput = {
+    groupName: z.string().min(1).describe("Name of the group to inspect."),
+};
+/** Canonicalize a URL template so `:id`, `{id}`, trailing-slash variants
+ *  collapse into a single key. */
+function normalizePath(raw) {
+    return raw
+        .replace(/:([A-Za-z_][A-Za-z0-9_]*)/g, "{$1}")
+        .replace(/\?.*$/, "")
+        .replace(/\/+$/, "");
+}
+function parseUnresolvedTarget(target) {
+    if (!target.startsWith(UNRESOLVED_PREFIX))
+        return undefined;
+    const rest = target.slice(UNRESOLVED_PREFIX.length);
+    const colon = rest.indexOf(":");
+    if (colon < 0)
+        return undefined;
+    const method = rest.slice(0, colon).toUpperCase();
+    const path = rest.slice(colon + 1);
+    return { method, path };
+}
+async function readConsumerEdges(graph) {
+    const fetches = await graph.listEdgesByType("FETCHES");
+    const sorted = [...fetches].sort((a, b) => {
+        if (a.from !== b.from)
+            return a.from < b.from ? -1 : 1;
+        return a.to < b.to ? -1 : a.to > b.to ? 1 : 0;
+    });
+    const out = [];
+    for (const e of sorted) {
+        const parsed = parseUnresolvedTarget(e.to);
+        if (parsed === undefined)
+            continue;
+        out.push({
+            consumerSymbol: e.from,
+            method: parsed.method,
+            path: normalizePath(parsed.path),
+        });
+    }
+    return out;
+}
+async function readProducerRoutes(graph) {
+    const routes = await graph.listRoutes();
+    const sorted = [...routes].sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+    const out = [];
+    for (const r of sorted) {
+        if (typeof r.url !== "string" || r.url.length === 0)
+            continue;
+        const method = (r.method ?? "GET").toUpperCase();
+        out.push({ nodeId: r.id, method, url: r.url });
+    }
+    return out;
+}
+export async function runGroupContracts(ctx, args) {
+    try {
+        const opts = ctx.home !== undefined ? { home: ctx.home } : {};
+        const group = await readGroup(args.groupName, opts);
+        if (!group) {
+            return toToolResult(toolError("NOT_FOUND", `Group ${args.groupName} is not defined.`, "Run `codehub group list` to see defined groups."));
+        }
+        const registry = await readRegistry(opts);
+        const sortedRepos = [...group.repos].sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+        const missing = [];
+        const consumersByRepo = new Map();
+        const producersByRepo = new Map();
+        // Resolve `repo_uri` for every registered member so every
+        // ContractRow carries `consumerRepoUri` / `producerRepoUri`.
+        const repoUriByName = new Map();
+        for (const repo of sortedRepos) {
+            const hit = registry[repo.name];
+            if (!hit) {
+                missing.push(repo.name);
+                continue;
+            }
+            repoUriByName.set(repo.name, await repoUriForEntry(hit, ctx.pool));
+            const repoPath = resolve(hit.path);
+            const dbPath = resolveDbPath(repoPath);
+            const store = await ctx.pool.acquire(repoPath, dbPath).catch((err) => {
+                const msg = err instanceof Error ? err.message : String(err);
+                throw new Error(`Failed to open DuckDB for ${repo.name}: ${msg}`);
+            });
+            try {
+                const [consumers, producers] = await Promise.all([
+                    readConsumerEdges(store.graph),
+                    readProducerRoutes(store.graph),
+                ]);
+                consumersByRepo.set(repo.name, consumers);
+                producersByRepo.set(repo.name, producers);
+            }
+            finally {
+                await ctx.pool.release(repoPath);
+            }
+        }
+        const contracts = [];
+        for (const [consumerRepo, consumers] of consumersByRepo) {
+            for (const consumer of consumers) {
+                // Search every OTHER repo in the group for a Route matching
+                // method + normalized path.
+                for (const [producerRepo, producers] of producersByRepo) {
+                    if (producerRepo === consumerRepo)
+                        continue;
+                    for (const route of producers) {
+                        if (route.method !== consumer.method)
+                            continue;
+                        if (normalizePath(route.url) !== consumer.path)
+                            continue;
+                        // Both sides must be registered members (consumers/producers
+                        // were only populated for registered repos), so the uri map
+                        // has a hit — but guard with an empty-string fallback to
+                        // keep the type `string` not `string | undefined`.
+                        const consumerRepoUri = repoUriByName.get(consumerRepo) ?? "";
+                        const producerRepoUri = repoUriByName.get(producerRepo) ?? "";
+                        contracts.push({
+                            consumerRepo,
+                            consumerRepoUri,
+                            consumerSymbol: consumer.consumerSymbol,
+                            producerRepo,
+                            producerRepoUri,
+                            producerRoute: route.nodeId,
+                            method: consumer.method,
+                            path: consumer.path,
+                        });
+                    }
+                }
+            }
+        }
+        contracts.sort((a, b) => {
+            if (a.consumerRepo !== b.consumerRepo)
+                return a.consumerRepo < b.consumerRepo ? -1 : 1;
+            if (a.consumerSymbol !== b.consumerSymbol)
+                return a.consumerSymbol < b.consumerSymbol ? -1 : 1;
+            if (a.method !== b.method)
+                return a.method < b.method ? -1 : 1;
+            if (a.path !== b.path)
+                return a.path < b.path ? -1 : 1;
+            if (a.producerRepo !== b.producerRepo)
+                return a.producerRepo < b.producerRepo ? -1 : 1;
+            return a.producerRoute < b.producerRoute ? -1 : 1;
+        });
+        // Secondary surface: the ContractRegistry persisted by `group_sync`.
+        // When the file exists we expose its cross-links + contract hashes so
+        // agents can browse HTTP, gRPC, and topic pairings without re-running
+        // the extractors themselves.
+        const persisted = await loadPersistedRegistry(group.name, ctx.home);
+        const crossLinks = persisted?.crossLinks ?? [];
+        const header = `Cross-repo contracts for group ${group.name}: ${contracts.length} DuckDB-backed HTTP edge(s), ${crossLinks.length} registry cross-link(s).`;
+        const body = contracts.length === 0
+            ? "(no FETCH-derived contracts — verify consumer repos ran the `fetches` phase and producer repos registered Route nodes)"
+            : contracts
+                .map((c) => `- [${c.consumerRepo}] ${c.consumerSymbol} → [${c.producerRepo}] ${c.method} ${c.path}`)
+                .join("\n");
+        const crossLinkBody = crossLinks.length === 0
+            ? ""
+            : `\n\nCross-links (from group_sync registry):\n${crossLinks
+                .slice(0, 50)
+                .map((l) => `- [${l.producer.repo}] ${l.producer.type} "${l.producer.signature}" (${l.producer.file}:${l.producer.line}) ↔ [${l.consumer.repo}] ${l.consumer.type} (${l.consumer.file}:${l.consumer.line}) [${l.matchReason}]`)
+                .join("\n")}${crossLinks.length > 50 ? `\n… and ${crossLinks.length - 50} more` : ""}`;
+        const warnLines = missing.length > 0
+            ? `\n\nWarning: ${missing.length} repo reference(s) missing from registry: ${missing.join(", ")}. Run \`codehub analyze\` for each.`
+            : "";
+        const registryHint = persisted
+            ? ""
+            : `\n\nHint: call \`group_sync\` with groupName="${group.name}" to materialize HTTP / gRPC / topic cross-links under ~/.codehub/groups/${group.name}/contracts.json`;
+        const next = contracts.length === 0 && crossLinks.length === 0
+            ? [
+                `call \`group_sync\` with groupName="${group.name}" to materialize cross-repo contracts`,
+                `call \`group_status\` with groupName="${group.name}" to confirm all repos are fresh`,
+            ]
+            : contracts.length > 0
+                ? [
+                    `call \`context\` with symbol="${contracts[0]?.consumerSymbol ?? ""}" and repo="${contracts[0]?.consumerRepo ?? ""}" to inspect the first contract`,
+                    `call \`group_sync\` with groupName="${group.name}" to refresh the cross-link registry`,
+                ]
+                : [
+                    `call \`group_sync\` with groupName="${group.name}" to refresh the cross-link registry`,
+                    `call \`group_query\` with groupName="${group.name}" to locate related code paths`,
+                ];
+        return toToolResult(withNextSteps(`${header}\n${body}${crossLinkBody}${warnLines}${registryHint}`, {
+            groupName: group.name,
+            contracts,
+            crossLinks,
+            registryComputedAt: persisted?.computedAt ?? null,
+            registryPath: persisted ? resolveGroupContractsPath(group.name, ctx.home) : null,
+        }, next));
+    }
+    catch (err) {
+        return toToolResult(toolErrorFromUnknown(err));
+    }
+}
+/**
+ * Load `<home>/.codehub/groups/<name>/contracts.json`. Returns `null`
+ * when the file does not exist or fails to parse — the tool still
+ * succeeds on the DuckDB-backed surface when the persisted file is
+ * missing.
+ */
+async function loadPersistedRegistry(groupName, home) {
+    const path = resolveGroupContractsPath(groupName, home);
+    try {
+        const raw = await readFile(path, "utf8");
+        const parsed = JSON.parse(raw);
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+export function registerGroupContractsTool(server, ctx) {
+    server.registerTool("group_contracts", {
+        title: "Cross-repo HTTP contracts + cross-links",
+        description: "Two-part surface for cross-repo contract discovery. (1) Match unresolved FETCHES edges (consumer) against Route nodes (producer) across every repo in the group — this is the DuckDB-backed HTTP surface. (2) When `group_sync` has written a contracts.json under `<home>/.codehub/groups/<name>/`, surface its cross-links with signature + file + line for HTTP, gRPC, and topic pairings. Use this to audit cross-repo coupling after a schema change in a shared API or proto.",
+        inputSchema: GroupContractsInput,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (args) => fromToolResult(await runGroupContracts(ctx, args)));
+}
+//# sourceMappingURL=group-contracts.js.map

package/dist/tools/group-contracts.js.map

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

package/dist/tools/group-cross-repo-links.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `group_cross_repo_links` — sourced cross-repo link graph for Phase E.
+ *
+ * The `codehub-document` skill calls this during its Phase E assembler
+ * (group mode) and embeds the returned `links[]` verbatim into the
+ * `.docmeta.json` v2 `cross_repo_links[]` field. The skill does the
+ * Markdown rendering; this tool only emits data.
+ *
+ * Data path: loads the persisted ContractRegistry written by `group_sync`
+ * (at `<home>/.codehub/groups/<name>/contracts.json`), maps each
+ * repo name to its stable `repo_uri` via `deriveRepoUri`, and hands off
+ * to the pure analysis helper `computeCrossRepoLinks`. The helper does
+ * the sort + dedup + relation inference; the tool only wires I/O.
+ *
+ * Annotations: readOnlyHint, idempotentHint, openWorldHint:false — the
+ * tool reads two files (group descriptor + persisted registry) and
+ * computes from them. Never writes.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolContext, type ToolResult } from "./shared.js";
+interface GroupCrossRepoLinksArgs {
+    readonly groupName: string;
+    readonly docPathScheme?: "default" | "per-repo-landing-only" | undefined;
+}
+export declare function runGroupCrossRepoLinks(ctx: ToolContext, args: GroupCrossRepoLinksArgs): Promise<ToolResult>;
+export declare function registerGroupCrossRepoLinksTool(server: McpServer, ctx: ToolContext): void;
+export {};
+//# sourceMappingURL=group-cross-repo-links.d.ts.map

package/dist/tools/group-cross-repo-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-cross-repo-links.d.ts","sourceRoot":"","sources":["../../src/tools/group-cross-repo-links.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,OAAO,EAAkB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAgB,MAAM,aAAa,CAAC;AAY9F,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,GAAG,uBAAuB,GAAG,SAAS,CAAC;CAC1E;AAoBD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,UAAU,CAAC,CA2FrB;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAiBzF"}