@opencodehub/mcp 0.1.0

package/dist/tools/group-cross-repo-links.js

@@ -0,0 +1,128 @@
+/**
+ * `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 { readFile } from "node:fs/promises";
+import { computeCrossRepoLinks } from "@opencodehub/analysis";
+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 { deriveRepoUri, readRegistry } from "../repo-resolver.js";
+import { resolveGroupContractsPath } from "./group-sync.js";
+import { fromToolResult, toToolResult } from "./shared.js";
+const GroupCrossRepoLinksInput = {
+    groupName: z.string().min(1).describe("Name of the group to compute links for."),
+    docPathScheme: z
+        .enum(["default", "per-repo-landing-only"])
+        .optional()
+        .describe("Doc-path scheme. Defaults to `per-repo-landing-only` (one link per repo-pair pointing at the target repo's architecture landing page)."),
+};
+/**
+ * Load `<home>/.codehub/groups/<name>/contracts.json`. Returns `null`
+ * when the file does not exist or fails to parse. Callers surface a
+ * friendly hint to run `group_sync` in that case.
+ */
+async function loadPersistedRegistry(groupName, home) {
+    const path = resolveGroupContractsPath(groupName, home);
+    try {
+        const raw = await readFile(path, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export async function runGroupCrossRepoLinks(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 persisted = await loadPersistedRegistry(args.groupName, ctx.home);
+        if (!persisted) {
+            return toToolResult(withNextSteps(`No persisted contract registry for group ${args.groupName}. Run \`group_sync\` first — no cross-repo links can be computed until the registry materializes.`, {
+                groupName: args.groupName,
+                links: [],
+                registryPath: null,
+                registryComputedAt: null,
+            }, [
+                `call \`group_sync\` with groupName="${args.groupName}" to materialize the cross-link registry`,
+                `after \`group_sync\`, call \`group_cross_repo_links\` with groupName="${args.groupName}" again`,
+            ]));
+        }
+        // Build repo → repo_uri map from the registry. Repos that are in the
+        // group descriptor but not in the registry are silently skipped — the
+        // helper treats "unknown repo" as "drop from graph" so the output stays
+        // consistent even when a group member is not yet indexed.
+        const registry = await readRegistry(opts);
+        const repoUriByName = new Map();
+        for (const repo of group.repos) {
+            const entry = registry[repo.name];
+            if (!entry)
+                continue;
+            repoUriByName.set(repo.name, deriveRepoUri(entry));
+        }
+        const links = computeCrossRepoLinks({
+            groupName: args.groupName,
+            crossLinks: persisted.crossLinks,
+            repoUriByName,
+            ...(args.docPathScheme !== undefined ? { docPathScheme: args.docPathScheme } : {}),
+        });
+        const header = `group_cross_repo_links: ${links.length} sourced link(s) across ${group.repos.length} repo(s) in ${group.name}.`;
+        const body = links.length === 0
+            ? "(no cross-repo links — either no contracts matched or repos are unregistered)"
+            : links
+                .slice(0, 50)
+                .map((l) => `- [${l.source_repo_uri}] ${l.source_doc_path} → [${l.target_repo_uri}] ${l.target_doc_path} (${l.relation})`)
+                .join("\n");
+        const tail = links.length > 50 ? `\n… and ${links.length - 50} more` : "";
+        const next = links.length === 0
+            ? [
+                `call \`group_contracts\` with groupName="${group.name}" to inspect producer↔consumer pairs`,
+                `call \`group_sync\` with groupName="${group.name}" to refresh the cross-link registry`,
+            ]
+            : [
+                `embed the \`links\` array verbatim into .docmeta.json \`cross_repo_links[]\` (schema v2)`,
+                `call \`group_contracts\` with groupName="${group.name}" to see the underlying contract rows`,
+            ];
+        return toToolResult(withNextSteps(`${header}\n${body}${tail}`, {
+            groupName: group.name,
+            links,
+            registryPath: resolveGroupContractsPath(group.name, ctx.home),
+            registryComputedAt: persisted.computedAt,
+        }, next));
+    }
+    catch (err) {
+        return toToolResult(toolErrorFromUnknown(err));
+    }
+}
+export function registerGroupCrossRepoLinksTool(server, ctx) {
+    server.registerTool("group_cross_repo_links", {
+        title: "Sourced cross-repo link graph for `.docmeta.json` v2",
+        description: "Emit the sourced, alpha-sorted cross-repo link graph for a named group. Loads the persisted ContractRegistry from `group_sync` and emits a `CrossRepoLink[]` with `depends_on` (consumer → producer) and `consumer_of` (producer → consumer) relations per matched contract. The `codehub-document` skill embeds this array verbatim into `.docmeta.json` v2's `cross_repo_links[]` field during Phase E; the skill also renders the `## See also (other repos in group)` footer from it. If `group_sync` has not run, `links` is empty and the hint directs the caller to run it first.",
+        inputSchema: GroupCrossRepoLinksInput,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (args) => fromToolResult(await runGroupCrossRepoLinks(ctx, args)));
+}
+//# sourceMappingURL=group-cross-repo-links.js.map

package/dist/tools/group-cross-repo-links.js.map

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

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

@@ -0,0 +1,10 @@
+/**
+ * `group_list` — enumerate every cross-repo group under
+ * `~/.codehub/groups/*.json`. Read-only. Deterministic output (groups and
+ * repos both sorted by name).
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolContext, type ToolResult } from "./shared.js";
+export declare function runGroupList(ctx: ToolContext): Promise<ToolResult>;
+export declare function registerGroupListTool(server: McpServer, ctx: ToolContext): void;
+//# sourceMappingURL=group-list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"group-list.d.ts","sourceRoot":"","sources":["../../src/tools/group-list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,OAAO,EAAkB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAgB,MAAM,aAAa,CAAC;AAoB9F,wBAAsB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAqDxE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAgB/E"}

package/dist/tools/group-list.js

@@ -0,0 +1,74 @@
+/**
+ * `group_list` — enumerate every cross-repo group under
+ * `~/.codehub/groups/*.json`. Read-only. Deterministic output (groups and
+ * repos both sorted by name).
+ */
+import { toolErrorFromUnknown } from "../error-envelope.js";
+import { listGroups } from "../group-resolver.js";
+import { withNextSteps } from "../next-step-hints.js";
+import { deriveRepoUri, readRegistry } from "../repo-resolver.js";
+import { repoUriForEntry } from "../repo-uri-for-entry.js";
+import { fromToolResult, toToolResult } from "./shared.js";
+export async function runGroupList(ctx) {
+    try {
+        const opts = ctx.home !== undefined ? { home: ctx.home } : {};
+        const raw = await listGroups(opts);
+        const registry = await readRegistry(opts);
+        const groups = [];
+        for (const g of raw) {
+            const repos = [];
+            for (const r of g.repos) {
+                const entry = registry[r.name];
+                // Prefer the graph-backed RepoNode.repoUri when the repo
+                // is registered; otherwise fall back to deriveRepoUri against a
+                // synthetic entry built from the group record so orphan references
+                // still receive a stable `local:<hash>`.
+                const repo_uri = entry
+                    ? await repoUriForEntry(entry, ctx.pool)
+                    : deriveRepoUri({
+                        name: r.name,
+                        path: r.path,
+                        indexedAt: "",
+                        nodeCount: 0,
+                        edgeCount: 0,
+                    });
+                repos.push({ name: r.name, path: r.path, repo_uri });
+            }
+            groups.push({
+                name: g.name,
+                createdAt: g.createdAt,
+                repos,
+                ...(g.description !== undefined ? { description: g.description } : {}),
+            });
+        }
+        const header = `Groups (${groups.length}):`;
+        const body = groups.length === 0
+            ? "(none — create one with `codehub group create <name> <repo> <repo> ...`)"
+            : groups
+                .map((g) => `- ${g.name} (${g.repos.length} repo${g.repos.length === 1 ? "" : "s"}): ${g.repos.map((r) => r.name).join(", ")}`)
+                .join("\n");
+        const next = groups.length === 0
+            ? ["run `codehub group create <name> <repo1> <repo2>` to define a group"]
+            : [
+                `call \`group_status\` with groupName="${groups[0]?.name ?? ""}" to see per-repo freshness`,
+                `call \`group_query\` with groupName + query to fan out BM25 across the group`,
+            ];
+        return toToolResult(withNextSteps(`${header}\n${body}`, { groups }, next));
+    }
+    catch (err) {
+        return toToolResult(toolErrorFromUnknown(err));
+    }
+}
+export function registerGroupListTool(server, ctx) {
+    server.registerTool("group_list", {
+        title: "List cross-repo groups",
+        description: "Enumerate every cross-repo group defined under ~/.codehub/groups. Groups bundle already-indexed repos so an agent can run one query across a whole stack (web-client + api-server + shared libs). Returns each group's name, creation timestamp, optional description, and constituent repos.",
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async () => fromToolResult(await runGroupList(ctx)));
+}
+//# sourceMappingURL=group-list.js.map

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

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

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

@@ -0,0 +1,40 @@
+/**
+ * `group_query` — BM25 on each repo in a group, fused with RRF (k=60).
+ *
+ * Response contract:
+ *   {
+ *     group:    string,
+ *     query:    string,
+ *     results:  [{ _repo, _rrf_score, nodeId, name, kind, filePath }],
+ *     per_repo: [{ repo, count, error? }],
+ *     warnings: string[],
+ *   }
+ *
+ * Determinism:
+ *   - Repo iteration is the alphabetical sort of `group.repos[*].name`.
+ *   - BM25 ties are broken by `id ASC` in the DuckDB adapter.
+ *   - RRF tiebreak falls back to lex `(_repo, nodeId)` ordering (the
+ *     underlying `rrf()` breaks ties by first-run / first-rank; we do the
+ *     final lex pass ourselves to keep cross-run order stable).
+ *   - Per-repo BM25 limit scales with the outer `limit` so small groups
+ *     don't silently truncate and large groups don't pull unnecessarily.
+ *
+ * Graceful degradation:
+ *   - A repo missing from the registry, a missing DB file, or a DuckDB
+ *     open error all emit a `per_repo[]` row with an `error` string and a
+ *     human-readable entry in `warnings[]`. The fan-out continues; the
+ *     tool never aborts unless the group itself is unknown.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolContext, type ToolResult } from "./shared.js";
+interface GroupQueryArgs {
+    readonly groupName: string;
+    readonly query: string;
+    readonly limit?: number | undefined;
+    readonly subgroup?: readonly string[] | undefined;
+    readonly kinds?: readonly string[] | undefined;
+}
+export declare function runGroupQuery(ctx: ToolContext, args: GroupQueryArgs): Promise<ToolResult>;
+export declare function registerGroupQueryTool(server: McpServer, ctx: ToolContext): void;
+export {};
+//# sourceMappingURL=group-query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"group-query.d.ts","sourceRoot":"","sources":["../../src/tools/group-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,OAAO,EAAkB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAgB,MAAM,aAAa,CAAC;AAkE9F,UAAU,cAAc;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAChD;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAmJ/F;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAiBhF"}

package/dist/tools/group-query.js

@@ -0,0 +1,209 @@
+/**
+ * `group_query` — BM25 on each repo in a group, fused with RRF (k=60).
+ *
+ * Response contract:
+ *   {
+ *     group:    string,
+ *     query:    string,
+ *     results:  [{ _repo, _rrf_score, nodeId, name, kind, filePath }],
+ *     per_repo: [{ repo, count, error? }],
+ *     warnings: string[],
+ *   }
+ *
+ * Determinism:
+ *   - Repo iteration is the alphabetical sort of `group.repos[*].name`.
+ *   - BM25 ties are broken by `id ASC` in the DuckDB adapter.
+ *   - RRF tiebreak falls back to lex `(_repo, nodeId)` ordering (the
+ *     underlying `rrf()` breaks ties by first-run / first-rank; we do the
+ *     final lex pass ourselves to keep cross-run order stable).
+ *   - Per-repo BM25 limit scales with the outer `limit` so small groups
+ *     don't silently truncate and large groups don't pull unnecessarily.
+ *
+ * Graceful degradation:
+ *   - A repo missing from the registry, a missing DB file, or a DuckDB
+ *     open error all emit a `per_repo[]` row with an `error` string and a
+ *     human-readable entry in `warnings[]`. The fan-out continues; the
+ *     tool never aborts unless the group itself is unknown.
+ */
+// biome-ignore-all lint/complexity/useLiteralKeys: dot-access disallowed on Record index signatures
+import { resolve } from "node:path";
+import { bm25Search, DEFAULT_RRF_K, DEFAULT_RRF_TOP_K, rrf } from "@opencodehub/search";
+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 { fromToolResult, toToolResult } from "./shared.js";
+const GroupQueryInput = {
+    groupName: z.string().min(1).describe("Name of the group to query."),
+    query: z.string().min(1).describe("Free-text BM25 search phrase."),
+    limit: z
+        .number()
+        .int()
+        .positive()
+        .max(100)
+        .optional()
+        .describe("Maximum merged results to return (default 20, max 100)."),
+    subgroup: z
+        .array(z.string().min(1))
+        .optional()
+        .describe("Optional filter — only these repo names (by registry name) from the group are queried. Unknown names are silently ignored."),
+    kinds: z
+        .array(z.string().min(1))
+        .optional()
+        .describe('Optional node-kind filter passed through to BM25 on every member repo (e.g. ["Function", "Method"]).'),
+};
+/** Soft caps so the per-repo limit stays bounded regardless of caller input. */
+const PER_REPO_BM25_MIN = 20;
+const PER_REPO_BM25_MAX = 200;
+/**
+ * Scale per-repo BM25 limit with outer limit + group cardinality.
+ * Heuristic: each member contributes up to `2 * limit / numRepos` hits, floor
+ * at the outer limit (so a single-repo group still gets `limit` candidates),
+ * cap at 200 to protect the RRF merge loop.
+ */
+function perRepoBm25Limit(outerLimit, numRepos) {
+    if (numRepos <= 0)
+        return outerLimit;
+    const heuristic = Math.ceil((outerLimit * 2) / numRepos);
+    return Math.max(PER_REPO_BM25_MIN, Math.min(PER_REPO_BM25_MAX, Math.max(outerLimit, heuristic)));
+}
+export async function runGroupQuery(ctx, args) {
+    try {
+        const limit = args.limit ?? 20;
+        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);
+        // Stable iteration order: alphabetical by registry name.
+        const sortedRepos = [...group.repos].sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+        // Optional subgroup filter — skip members not in the subgroup set.
+        const subgroupFilter = args.subgroup && args.subgroup.length > 0 ? new Set(args.subgroup) : undefined;
+        const targetRepos = subgroupFilter
+            ? sortedRepos.filter((r) => subgroupFilter.has(r.name))
+            : sortedRepos;
+        const perRepoLimit = perRepoBm25Limit(limit, Math.max(targetRepos.length, 1));
+        const meta = new Map();
+        const runs = [];
+        const perRepo = [];
+        const warnings = [];
+        for (const repo of targetRepos) {
+            const hit = registry[repo.name];
+            if (!hit) {
+                perRepo.push({ repo: repo.name, count: 0, error: "not_in_registry" });
+                warnings.push(`${repo.name}: not in registry — run \`codehub analyze\` in that repo, then retry.`);
+                continue;
+            }
+            // Additive field — resolve once per repo so every result row from
+            // this repo receives the same `_repo_uri`. Best-effort: the
+            // helper falls back to `deriveRepoUri` on any DB failure.
+            const repoUri = await repoUriForEntry(hit, ctx.pool);
+            const repoPath = resolve(hit.path);
+            const dbPath = resolveDbPath(repoPath);
+            let store;
+            try {
+                store = await ctx.pool.acquire(repoPath, dbPath);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                perRepo.push({ repo: repo.name, count: 0, error: "open_failed" });
+                warnings.push(`${repo.name}: failed to open index (${msg}).`);
+                continue;
+            }
+            try {
+                const bm25Query = args.kinds && args.kinds.length > 0
+                    ? { text: args.query, kinds: args.kinds, limit: perRepoLimit }
+                    : { text: args.query, limit: perRepoLimit };
+                const results = await bm25Search(store.graph, bm25Query);
+                const ranked = [];
+                for (const r of results) {
+                    const id = `${repo.name}::${r.nodeId}`;
+                    ranked.push({ id });
+                    if (!meta.has(id)) {
+                        meta.set(id, {
+                            _repo: repo.name,
+                            _repo_uri: repoUri,
+                            _rrf_score: 0,
+                            nodeId: r.nodeId,
+                            name: r.name,
+                            kind: r.kind,
+                            filePath: r.filePath,
+                            score: r.score,
+                        });
+                    }
+                }
+                runs.push(ranked);
+                perRepo.push({ repo: repo.name, count: results.length });
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                perRepo.push({ repo: repo.name, count: 0, error: "query_failed" });
+                warnings.push(`${repo.name}: BM25 query failed (${msg}).`);
+            }
+            finally {
+                await ctx.pool.release(repoPath);
+            }
+        }
+        const fused = rrf(runs, DEFAULT_RRF_K, Math.max(limit, DEFAULT_RRF_TOP_K));
+        const rows = [];
+        for (const f of fused) {
+            const row = meta.get(f.id);
+            if (!row)
+                continue;
+            rows.push({ ...row, _rrf_score: f.score });
+        }
+        // Deterministic final ordering: _rrf_score desc, then (_repo, nodeId) lex asc.
+        rows.sort((a, b) => {
+            if (a._rrf_score !== b._rrf_score)
+                return b._rrf_score - a._rrf_score;
+            if (a._repo !== b._repo)
+                return a._repo < b._repo ? -1 : 1;
+            if (a.nodeId !== b.nodeId)
+                return a.nodeId < b.nodeId ? -1 : 1;
+            return 0;
+        });
+        const top = rows.slice(0, limit);
+        const reposQueried = perRepo.filter((r) => r.error === undefined).map((r) => r.repo);
+        const header = `Top ${top.length} match(es) for "${args.query}" in group ${group.name} (${reposQueried.length} repo${reposQueried.length === 1 ? "" : "s"} queried, ${warnings.length} warning${warnings.length === 1 ? "" : "s"}):`;
+        const body = top.length === 0
+            ? "(no matches — try a broader phrase)"
+            : top
+                .map((r, i) => `${i + 1}. [${r._repo}] ${r.name} [${r.kind}] — ${r.filePath} (rrf ${r._rrf_score.toFixed(4)})`)
+                .join("\n");
+        const warnLines = warnings.length > 0 ? `\n\nWarnings:\n- ${warnings.join("\n- ")}` : "";
+        const next = top.length === 0
+            ? ["broaden the query or review group composition with `group_status`"]
+            : [
+                `call \`context\` with symbol="${top[0]?.name ?? ""}" and repo="${top[0]?._repo ?? ""}" to inspect the top hit`,
+                `call \`group_status\` with groupName="${group.name}" if results look stale`,
+            ];
+        return toToolResult(withNextSteps(`${header}\n${body}${warnLines}`, {
+            group: group.name,
+            query: args.query,
+            results: top,
+            per_repo: perRepo,
+            warnings,
+        }, next));
+    }
+    catch (err) {
+        return toToolResult(toolErrorFromUnknown(err));
+    }
+}
+export function registerGroupQueryTool(server, ctx) {
+    server.registerTool("group_query", {
+        title: "Cross-repo search",
+        description: "Run BM25 against every repo in a named group and fuse the per-repo rankings with Reciprocal Rank Fusion (RRF, k=60). Useful when a concept spans client and server repos. Repos are visited in alphabetical order so ties are deterministic. Per-repo errors are reported in `per_repo[].error` and `warnings[]` — the fan-out never aborts on a single-repo failure.",
+        inputSchema: GroupQueryInput,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (args) => fromToolResult(await runGroupQuery(ctx, args)));
+}
+//# sourceMappingURL=group-query.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * `group_status` — per-repo index freshness within a named group.
+ *
+ * For each repo referenced by the group we emit:
+ *   - name, path
+ *   - nodeCount / edgeCount from the registry at group-create time
+ *   - indexedAt from the registry (ISO8601)
+ *   - staleness envelope via @opencodehub/analysis.computeStaleness when
+ *     the on-disk meta.json is readable
+ *   - `inRegistry: false` for orphan references (repo was removed but the
+ *     group still points at it)
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolContext, type ToolResult } from "./shared.js";
+interface GroupStatusArgs {
+    readonly groupName: string;
+}
+export declare function runGroupStatus(ctx: ToolContext, args: GroupStatusArgs): Promise<ToolResult>;
+export declare function registerGroupStatusTool(server: McpServer, ctx: ToolContext): void;
+export {};
+//# sourceMappingURL=group-status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"group-status.d.ts","sourceRoot":"","sources":["../../src/tools/group-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUzE,OAAO,EAAkB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAgB,MAAM,aAAa,CAAC;AAwB9F,UAAU,eAAe;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAgGjG;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAiBjF"}