@opencodehub/mcp 0.1.0

package/dist/group-resolver.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Read-only accessors for `~/.codehub/groups/<name>.json`.
+ *
+ * The MCP package intentionally reimplements a tiny reader rather than
+ * depending on `@opencodehub/cli`: the CLI depends on `@opencodehub/mcp`
+ * (via the `mcp` command), and the reverse would be a cycle. The on-disk
+ * shape is stable — we parallel the invariants in
+ * `packages/cli/src/groups.ts` (`GROUPS_DIR_NAME`, name pattern, shape)
+ * and cover them in tests.
+ */
+export declare const GROUP_NAME_PATTERN: RegExp;
+export interface GroupRepo {
+    readonly name: string;
+    readonly path: string;
+}
+export interface GroupEntry {
+    readonly name: string;
+    readonly createdAt: string;
+    readonly repos: readonly GroupRepo[];
+    readonly description?: string;
+}
+export interface GroupsOptions {
+    readonly home?: string;
+}
+export declare function resolveGroupsDir(opts?: GroupsOptions): string;
+export declare function resolveGroupFile(name: string, opts?: GroupsOptions): string;
+export declare function readGroup(name: string, opts?: GroupsOptions): Promise<GroupEntry | null>;
+export declare function listGroups(opts?: GroupsOptions): Promise<readonly GroupEntry[]>;
+//# sourceMappingURL=group-resolver.d.ts.map

package/dist/group-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-resolver.d.ts","sourceRoot":"","sources":["../src/group-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,eAAO,MAAM,kBAAkB,QAAkB,CAAC;AAElD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,aAAkB,GAAG,MAAM,CAGjE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAK/E;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAW5B;AAED,wBAAsB,UAAU,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAwBzF"}

package/dist/group-resolver.js

@@ -0,0 +1,100 @@
+/**
+ * Read-only accessors for `~/.codehub/groups/<name>.json`.
+ *
+ * The MCP package intentionally reimplements a tiny reader rather than
+ * depending on `@opencodehub/cli`: the CLI depends on `@opencodehub/mcp`
+ * (via the `mcp` command), and the reverse would be a cycle. The on-disk
+ * shape is stable — we parallel the invariants in
+ * `packages/cli/src/groups.ts` (`GROUPS_DIR_NAME`, name pattern, shape)
+ * and cover them in tests.
+ */
+// biome-ignore-all lint/complexity/useLiteralKeys: dot-access disallowed on Record index signatures
+import { readdir, readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, extname, join, resolve } from "node:path";
+const CODEHUB_HOME_DIR = ".codehub";
+const GROUPS_DIR_NAME = "groups";
+export const GROUP_NAME_PATTERN = /^[a-z0-9_-]+$/;
+export function resolveGroupsDir(opts = {}) {
+    const home = opts.home ?? homedir();
+    return resolve(home, CODEHUB_HOME_DIR, GROUPS_DIR_NAME);
+}
+export function resolveGroupFile(name, opts = {}) {
+    if (!GROUP_NAME_PATTERN.test(name)) {
+        throw new Error(`Invalid group name "${name}". Names must match ${GROUP_NAME_PATTERN}.`);
+    }
+    return join(resolveGroupsDir(opts), `${name}.json`);
+}
+export async function readGroup(name, opts = {}) {
+    if (!GROUP_NAME_PATTERN.test(name))
+        return null;
+    const file = resolveGroupFile(name, opts);
+    let raw;
+    try {
+        raw = await readFile(file, "utf8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return null;
+        throw err;
+    }
+    return normalizeGroup(JSON.parse(raw));
+}
+export async function listGroups(opts = {}) {
+    const dir = resolveGroupsDir(opts);
+    let dirents;
+    try {
+        dirents = await readdir(dir);
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return [];
+        throw err;
+    }
+    const names = dirents
+        .filter((f) => extname(f) === ".json")
+        .map((f) => basename(f, ".json"))
+        .filter((n) => GROUP_NAME_PATTERN.test(n))
+        .sort();
+    const out = [];
+    for (const name of names) {
+        try {
+            const group = await readGroup(name, opts);
+            if (group)
+                out.push(group);
+        }
+        catch {
+            // Skip unreadable files; callers surface them via empty returns.
+        }
+    }
+    return out;
+}
+function normalizeGroup(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return null;
+    const raw = value;
+    if (typeof raw["name"] !== "string")
+        return null;
+    if (typeof raw["createdAt"] !== "string")
+        return null;
+    if (!Array.isArray(raw["repos"]))
+        return null;
+    const repos = [];
+    for (const entry of raw["repos"]) {
+        if (typeof entry !== "object" || entry === null)
+            continue;
+        const r = entry;
+        if (typeof r["name"] !== "string" || typeof r["path"] !== "string")
+            continue;
+        repos.push({ name: r["name"], path: r["path"] });
+    }
+    repos.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+    const out = {
+        name: raw["name"],
+        createdAt: raw["createdAt"],
+        repos,
+        ...(typeof raw["description"] === "string" ? { description: raw["description"] } : {}),
+    };
+    return out;
+}
+//# sourceMappingURL=group-resolver.js.map

package/dist/group-resolver.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Barrel for `@opencodehub/mcp`.
+ *
+ * The CLI's `codehub mcp` subcommand imports `startStdioServer` to host
+ * the server in-process. Tests import `buildServer` directly so they
+ * can drive tool handlers without a stdio transport.
+ */
+export { ConnectionPool, type ConnectionPoolOptions, type StoreFactory, } from "./connection-pool.js";
+export { type ErrorCode, type ErrorDetail, toolError, toolErrorFromUnknown, } from "./error-envelope.js";
+export { withNextSteps } from "./next-step-hints.js";
+export { type RegistryEntry, RepoResolveError, type ResolvedRepo, readRegistry, resolveRepo, } from "./repo-resolver.js";
+export { buildServer, type RunningServer, type StartServerOptions, startStdioServer, } from "./server.js";
+export { stalenessFromMeta } from "./staleness.js";
+export { runApiImpact } from "./tools/api-impact.js";
+export { runContext } from "./tools/context.js";
+export { runDependencies } from "./tools/dependencies.js";
+export { runDetectChanges } from "./tools/detect-changes.js";
+export { runGroupContracts } from "./tools/group-contracts.js";
+export { runGroupList } from "./tools/group-list.js";
+export { runGroupQuery } from "./tools/group-query.js";
+export { runGroupStatus } from "./tools/group-status.js";
+export { runGroupSyncTool } from "./tools/group-sync.js";
+export { runImpact } from "./tools/impact.js";
+export { runLicenseAudit } from "./tools/license-audit.js";
+export { runListDeadCode } from "./tools/list-dead-code.js";
+export { runListFindings } from "./tools/list-findings.js";
+export { runListFindingsDelta } from "./tools/list-findings-delta.js";
+export { runListRepos } from "./tools/list-repos.js";
+export { runOwners } from "./tools/owners.js";
+export { runProjectProfile } from "./tools/project-profile.js";
+export { runQuery } from "./tools/query.js";
+export { runRemoveDeadCode } from "./tools/remove-dead-code.js";
+export { runRename } from "./tools/rename.js";
+export { runRiskTrends } from "./tools/risk-trends.js";
+export { runRouteMap } from "./tools/route-map.js";
+export { runScan } from "./tools/scan.js";
+export { runShapeCheck } from "./tools/shape-check.js";
+export { fromToolResult, type ToolContext, type ToolResult, toToolResult, } from "./tools/shared.js";
+export { runSignature } from "./tools/signature.js";
+export { runSql } from "./tools/sql.js";
+export { runToolMap } from "./tools/tool-map.js";
+export { runVerdict } from "./tools/verdict.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,YAAY,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,SAAS,EACT,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EACL,KAAK,aAAa,EAClB,gBAAgB,EAChB,KAAK,YAAY,EACjB,YAAY,EACZ,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAIvD,OAAO,EACL,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,54 @@
+/**
+ * Barrel for `@opencodehub/mcp`.
+ *
+ * The CLI's `codehub mcp` subcommand imports `startStdioServer` to host
+ * the server in-process. Tests import `buildServer` directly so they
+ * can drive tool handlers without a stdio transport.
+ */
+export { ConnectionPool, } from "./connection-pool.js";
+export { toolError, toolErrorFromUnknown, } from "./error-envelope.js";
+export { withNextSteps } from "./next-step-hints.js";
+export { RepoResolveError, readRegistry, resolveRepo, } from "./repo-resolver.js";
+export { buildServer, startStdioServer, } from "./server.js";
+export { stalenessFromMeta } from "./staleness.js";
+export { runApiImpact } from "./tools/api-impact.js";
+export { runContext } from "./tools/context.js";
+export { runDependencies } from "./tools/dependencies.js";
+export { runDetectChanges } from "./tools/detect-changes.js";
+export { runGroupContracts } from "./tools/group-contracts.js";
+export { runGroupList } from "./tools/group-list.js";
+export { runGroupQuery } from "./tools/group-query.js";
+export { runGroupStatus } from "./tools/group-status.js";
+export { runGroupSyncTool } from "./tools/group-sync.js";
+export { runImpact } from "./tools/impact.js";
+export { runLicenseAudit } from "./tools/license-audit.js";
+export { runListDeadCode } from "./tools/list-dead-code.js";
+export { runListFindings } from "./tools/list-findings.js";
+export { runListFindingsDelta } from "./tools/list-findings-delta.js";
+export { runListRepos } from "./tools/list-repos.js";
+export { runOwners } from "./tools/owners.js";
+export { runProjectProfile } from "./tools/project-profile.js";
+export { runQuery } from "./tools/query.js";
+export { runRemoveDeadCode } from "./tools/remove-dead-code.js";
+export { runRename } from "./tools/rename.js";
+export { runRiskTrends } from "./tools/risk-trends.js";
+export { runRouteMap } from "./tools/route-map.js";
+export { runScan } from "./tools/scan.js";
+export { runShapeCheck } from "./tools/shape-check.js";
+// Pure tool handlers for non-SDK callers. Every run function takes a
+// `ToolContext` and returns a transport-agnostic `ToolResult` with both
+// `text` and `structuredContent`.
+export { fromToolResult, toToolResult, } from "./tools/shared.js";
+export { runSignature } from "./tools/signature.js";
+export { runSql } from "./tools/sql.js";
+export { runToolMap } from "./tools/tool-map.js";
+export { runVerdict } from "./tools/verdict.js";
+// Allow `node dist/index.js` to boot the stdio server directly. The CLI
+// package's `codehub mcp` binary imports `startStdioServer` instead so
+// it can pre-parse its own flags before handing off to us.
+if (process.argv[1] &&
+    (process.argv[1].endsWith("/dist/index.js") || process.argv[1].endsWith("\\dist\\index.js"))) {
+    const { startStdioServer } = await import("./server.js");
+    await startStdioServer();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,cAAc,GAGf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,SAAS,EACT,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAEL,gBAAgB,EAEhB,YAAY,EACZ,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EAGX,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,qEAAqE;AACrE,wEAAwE;AACxE,kCAAkC;AAClC,OAAO,EACL,cAAc,EAGd,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,wEAAwE;AACxE,uEAAuE;AACvE,2DAA2D;AAC3D,IACE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACf,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,EAC5F,CAAC;IACD,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACzD,MAAM,gBAAgB,EAAE,CAAC;AAC3B,CAAC"}

package/dist/next-step-hints.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Next-step hint helper.
+ *
+ * The MCP spec (rev 2025-06-18) does not carve out a first-class "suggest
+ * what tool to call next" field. Research-mcp.yaml captures the three
+ * in-spec options; we combine two:
+ *   (a) a `next_steps: string[]` under `structuredContent` for clients that
+ *       consume the output schema, and
+ *   (b) a trailing "Suggested next tools:" text block in the primary
+ *       `content` array for clients that only ingest text.
+ *
+ * The `_meta` map under structuredContent carries staleness under a stable
+ * `codehub/staleness` namespace so non-aware clients simply ignore it.
+ */
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { StalenessEnvelope } from "@opencodehub/core-types";
+/**
+ * Wrap a tool's text + structured payload with next-step hints and an
+ * optional staleness envelope. `structured` must be a plain object; the
+ * result includes every key from `structured` plus `next_steps` and
+ * `_meta`.
+ */
+export declare function withNextSteps<T extends Record<string, unknown>>(content: string, structured: T, nextSteps: readonly string[], staleness?: StalenessEnvelope): CallToolResult;
+//# sourceMappingURL=next-step-hints.d.ts.map

package/dist/next-step-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-step-hints.d.ts","sourceRoot":"","sources":["../src/next-step-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAIjE;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,CAAC,EACb,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,SAAS,CAAC,EAAE,iBAAiB,GAC5B,cAAc,CAoBhB"}

package/dist/next-step-hints.js

@@ -0,0 +1,41 @@
+/**
+ * Next-step hint helper.
+ *
+ * The MCP spec (rev 2025-06-18) does not carve out a first-class "suggest
+ * what tool to call next" field. Research-mcp.yaml captures the three
+ * in-spec options; we combine two:
+ *   (a) a `next_steps: string[]` under `structuredContent` for clients that
+ *       consume the output schema, and
+ *   (b) a trailing "Suggested next tools:" text block in the primary
+ *       `content` array for clients that only ingest text.
+ *
+ * The `_meta` map under structuredContent carries staleness under a stable
+ * `codehub/staleness` namespace so non-aware clients simply ignore it.
+ */
+const STALENESS_META_KEY = "codehub/staleness";
+/**
+ * Wrap a tool's text + structured payload with next-step hints and an
+ * optional staleness envelope. `structured` must be a plain object; the
+ * result includes every key from `structured` plus `next_steps` and
+ * `_meta`.
+ */
+export function withNextSteps(content, structured, nextSteps, staleness) {
+    const hintBlock = nextSteps.length > 0
+        ? `\n\nSuggested next tools:\n${nextSteps.map((s) => `- ${s}`).join("\n")}`
+        : "";
+    const meta = {};
+    if (staleness)
+        meta[STALENESS_META_KEY] = staleness;
+    const structuredContent = {
+        ...structured,
+        next_steps: [...nextSteps],
+    };
+    if (Object.keys(meta).length > 0) {
+        structuredContent["_meta"] = meta;
+    }
+    return {
+        content: [{ type: "text", text: content + hintBlock }],
+        structuredContent,
+    };
+}
+//# sourceMappingURL=next-step-hints.js.map

package/dist/next-step-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-step-hints.js","sourceRoot":"","sources":["../src/next-step-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAe,EACf,UAAa,EACb,SAA4B,EAC5B,SAA6B;IAE7B,MAAM,SAAS,GACb,SAAS,CAAC,MAAM,GAAG,CAAC;QAClB,CAAC,CAAC,8BAA8B,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC3E,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,IAAI,SAAS;QAAE,IAAI,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAAC;IAEpD,MAAM,iBAAiB,GAA4B;QACjD,GAAG,UAAU;QACb,UAAU,EAAE,CAAC,GAAG,SAAS,CAAC;KAC3B,CAAC;IACF,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,iBAAiB,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACpC,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,CAAC;QAC/D,iBAAiB;KAClB,CAAC;AACJ,CAAC"}

package/dist/repo-resolver.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Resolve a user-supplied (or omitted) `repo` argument to a concrete repo
+ * path, DuckDB file path, and (optionally) cached store metadata.
+ *
+ * The authoritative mapping lives at `~/.codehub/registry.json`. Callers
+ * who pass a name look it up there. When `repo` is omitted:
+ *   - Exactly one registered repo: return it (friendly single-repo case).
+ *   - Zero registered repos: throw `NO_INDEX`.
+ *   - Two or more registered repos: throw `AMBIGUOUS_REPO` so the caller
+ *     picks explicitly. Silent alphabetical-first picks are a footgun
+ *     across a stdio MCP session where the server has no reliable cwd.
+ */
+import { type StoreMeta } from "@opencodehub/storage";
+import type { RepoChoice } from "./error-envelope.js";
+export interface RegistryEntry {
+    readonly name: string;
+    readonly path: string;
+    readonly lastCommit?: string;
+    readonly indexedAt: string;
+    readonly nodeCount: number;
+    readonly edgeCount: number;
+}
+export interface ResolvedRepo {
+    readonly name: string;
+    readonly repoPath: string;
+    readonly dbPath: string;
+    readonly entry: RegistryEntry;
+    readonly meta?: StoreMeta;
+}
+export type RepoResolveCode = "NO_INDEX" | "NOT_FOUND" | "AMBIGUOUS_REPO";
+/**
+ * Auxiliary payload attached to `RepoResolveError` instances whose
+ * `code === "AMBIGUOUS_REPO"`. `choices` is the full list (not capped);
+ * the envelope builder at `error-envelope.ts` applies the 10-entry cap.
+ */
+export interface AmbiguousRepoInfo {
+    readonly choices: readonly RepoChoice[];
+    readonly totalMatches: number;
+}
+export declare class RepoResolveError extends Error {
+    readonly code: RepoResolveCode;
+    readonly hint: string;
+    /** Populated only when `code === "AMBIGUOUS_REPO"`. */
+    readonly ambiguous?: AmbiguousRepoInfo;
+    constructor(code: RepoResolveCode, message: string, hint: string, ambiguous?: AmbiguousRepoInfo);
+}
+/**
+ * Inputs accepted by {@link resolveRepo}. Back-compat: a bare `string`
+ * (the registry name) or `undefined` (trigger single-repo fallback) still
+ * works. The object form allows callers to pass `repo_uri` as an alias —
+ * when both are provided, `repo_uri` wins.
+ *
+ * Fields permit explicit `undefined` so tool-handler arg types (which
+ * declare `?: T | undefined` under `exactOptionalPropertyTypes`) are
+ * structurally assignable without wrapping.
+ */
+export type ResolveRepoArg = string | undefined | {
+    readonly repo?: string | undefined;
+    readonly repo_uri?: string | undefined;
+};
+export interface ResolveRepoOptions {
+    /** Override the home directory (used by tests). */
+    readonly home?: string;
+    /** Skip the meta.json read (saves a syscall when caller does not need it). */
+    readonly skipMeta?: boolean;
+}
+export declare function readRegistry(opts?: ResolveRepoOptions): Promise<Record<string, RegistryEntry>>;
+export declare function resolveRepo(arg: ResolveRepoArg, opts?: ResolveRepoOptions): Promise<ResolvedRepo>;
+/**
+ * Derive a stable `repo_uri` from a registry entry.
+ *
+ *   - If `name` already looks URI-ish (contains `/`), use it as-is (e.g.
+ *     `github.com/org/repo`). This matches Sourcegraph / GitHub convention.
+ *   - Else, fall back to `local:<sha256(path)[:12]>` so two local repos
+ *     with colliding short names still have distinct URIs.
+ *
+ * Future work will replace this with the registry-backed
+ * RepoNode.repo_uri. Kept deterministic so tests can assert exact
+ * values.
+ */
+export declare function deriveRepoUri(entry: RegistryEntry): string;
+/**
+ * Normalize a caller-supplied `repo_uri` so it matches what
+ * {@link deriveRepoUri} produces. Strips protocol and trailing `.git`,
+ * lowercases the host segment but keeps path case.
+ */
+export declare function normalizeRepoUri(raw: string): string;
+//# sourceMappingURL=repo-resolver.d.ts.map

package/dist/repo-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-resolver.d.ts","sourceRoot":"","sources":["../src/repo-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;CAC3B;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAE1E;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,iBAAiB,CAAC;gBAC3B,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,iBAAiB;CAOhG;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,SAAS,GACT;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEnF,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAsB,YAAY,CAChC,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAWxC;AAED,wBAAsB,WAAW,CAC/B,GAAG,EAAE,cAAc,EACnB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,YAAY,CAAC,CA+DvB;AAkDD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAI1D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAoBpD"}

package/dist/repo-resolver.js

@@ -0,0 +1,211 @@
+/**
+ * Resolve a user-supplied (or omitted) `repo` argument to a concrete repo
+ * path, DuckDB file path, and (optionally) cached store metadata.
+ *
+ * The authoritative mapping lives at `~/.codehub/registry.json`. Callers
+ * who pass a name look it up there. When `repo` is omitted:
+ *   - Exactly one registered repo: return it (friendly single-repo case).
+ *   - Zero registered repos: throw `NO_INDEX`.
+ *   - Two or more registered repos: throw `AMBIGUOUS_REPO` so the caller
+ *     picks explicitly. Silent alphabetical-first picks are a footgun
+ *     across a stdio MCP session where the server has no reliable cwd.
+ */
+// biome-ignore-all lint/complexity/useLiteralKeys: dot-access disallowed on Record index signatures
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { readStoreMeta, resolveDbPath, resolveRegistryPath, } from "@opencodehub/storage";
+export class RepoResolveError extends Error {
+    code;
+    hint;
+    /** Populated only when `code === "AMBIGUOUS_REPO"`. */
+    ambiguous;
+    constructor(code, message, hint, ambiguous) {
+        super(message);
+        this.name = "RepoResolveError";
+        this.code = code;
+        this.hint = hint;
+        if (ambiguous !== undefined)
+            this.ambiguous = ambiguous;
+    }
+}
+export async function readRegistry(opts = {}) {
+    const path = opts.home ? resolveRegistryPath(opts.home) : resolveRegistryPath();
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return {};
+        throw err;
+    }
+    const parsed = JSON.parse(raw);
+    return normalizeRegistry(parsed);
+}
+export async function resolveRepo(arg, opts = {}) {
+    const { repo: repoName, repoUri } = normalizeResolveArg(arg);
+    const registry = await readRegistry(opts);
+    const names = Object.keys(registry).sort();
+    if (names.length === 0) {
+        throw new RepoResolveError("NO_INDEX", "No repos are indexed yet.", "Run `codehub analyze` in a repo root to create an index.");
+    }
+    let entry;
+    let resolvedName;
+    // `repo_uri` wins when both are provided.
+    if (repoUri !== undefined) {
+        const wanted = normalizeRepoUri(repoUri);
+        for (const key of names) {
+            const candidate = registry[key];
+            if (!candidate)
+                continue;
+            if (normalizeRepoUri(deriveRepoUri(candidate)) === wanted) {
+                entry = candidate;
+                resolvedName = key;
+                break;
+            }
+        }
+    }
+    else if (repoName !== undefined) {
+        entry = registry[repoName];
+        resolvedName = repoName;
+    }
+    else {
+        // Neither arg provided — single-repo defaulting, otherwise AMBIGUOUS.
+        if (names.length > 1) {
+            throw buildAmbiguousError(registry, names);
+        }
+        resolvedName = names[0];
+        entry = resolvedName ? registry[resolvedName] : undefined;
+    }
+    if (!entry || !resolvedName) {
+        const requested = repoUri ?? repoName ?? "<default>";
+        throw new RepoResolveError("NOT_FOUND", `Repo ${requested} is not in the registry.`, `Known repos: ${names.join(", ")}. Run \`codehub analyze\` in the target repo first.`);
+    }
+    const repoPath = resolve(entry.path);
+    const dbPath = resolveDbPath(repoPath);
+    let meta;
+    if (!opts.skipMeta) {
+        try {
+            meta = await readStoreMeta(repoPath);
+        }
+        catch {
+            meta = undefined;
+        }
+    }
+    return meta
+        ? { name: resolvedName, repoPath, dbPath, entry, meta }
+        : { name: resolvedName, repoPath, dbPath, entry };
+}
+/**
+ * Normalize a `ResolveRepoArg` to its object form so the resolver can key
+ * on both `repo` and `repo_uri` uniformly. Bare strings are treated as
+ * `{ repo: s }` for back-compat with pre-M6 callers.
+ */
+function normalizeResolveArg(arg) {
+    if (arg === undefined)
+        return { repo: undefined, repoUri: undefined };
+    if (typeof arg === "string")
+        return { repo: arg, repoUri: undefined };
+    return { repo: arg.repo, repoUri: arg.repo_uri };
+}
+/**
+ * Build the structured AMBIGUOUS_REPO error with a `choices[]` payload
+ * derived from registry entries.
+ *
+ * Once the registry is reshaped to expose `default_branch` + `group`
+ * from the persisted RepoNode, switch this to pull those fields from
+ * the node instead of defaulting to `null`. For now they're
+ * placeholders so the wire shape is stable.
+ */
+function buildAmbiguousError(registry, names) {
+    const choices = [];
+    for (const key of names) {
+        const entry = registry[key];
+        if (!entry)
+            continue;
+        choices.push({
+            repo_uri: deriveRepoUri(entry),
+            default_branch: null,
+            group: null,
+        });
+    }
+    const preview = names.slice(0, 5).join(", ");
+    const elided = names.length > 5 ? `, +${names.length - 5} more` : "";
+    const hint = `Pass \`repo_uri\` (or \`repo\`) to disambiguate. Registered repos: ${preview}${elided}.`;
+    return new RepoResolveError("AMBIGUOUS_REPO", `No \`repo\` argument provided but ${names.length} repos are registered.`, hint, { choices, totalMatches: names.length });
+}
+/**
+ * Derive a stable `repo_uri` from a registry entry.
+ *
+ *   - If `name` already looks URI-ish (contains `/`), use it as-is (e.g.
+ *     `github.com/org/repo`). This matches Sourcegraph / GitHub convention.
+ *   - Else, fall back to `local:<sha256(path)[:12]>` so two local repos
+ *     with colliding short names still have distinct URIs.
+ *
+ * Future work will replace this with the registry-backed
+ * RepoNode.repo_uri. Kept deterministic so tests can assert exact
+ * values.
+ */
+export function deriveRepoUri(entry) {
+    if (entry.name.includes("/"))
+        return entry.name;
+    const digest = createHash("sha256").update(entry.path).digest("hex").slice(0, 12);
+    return `local:${digest}`;
+}
+/**
+ * Normalize a caller-supplied `repo_uri` so it matches what
+ * {@link deriveRepoUri} produces. Strips protocol and trailing `.git`,
+ * lowercases the host segment but keeps path case.
+ */
+export function normalizeRepoUri(raw) {
+    let s = raw.trim();
+    // `git@host:org/repo.git` → `host/org/repo`
+    const scpMatch = /^git@([^:]+):(.+)$/.exec(s);
+    if (scpMatch) {
+        const host = (scpMatch[1] ?? "").toLowerCase();
+        s = `${host}/${scpMatch[2] ?? ""}`;
+    }
+    else if (/^https?:\/\//i.test(s)) {
+        // `https://host/path` → `host/path` (lowercase host, keep path case)
+        s = s.replace(/^https?:\/\//i, "");
+        const slash = s.indexOf("/");
+        if (slash !== -1) {
+            const host = s.slice(0, slash).toLowerCase();
+            s = `${host}${s.slice(slash)}`;
+        }
+        else {
+            s = s.toLowerCase();
+        }
+    }
+    if (s.endsWith(".git"))
+        s = s.slice(0, -".git".length);
+    return s;
+}
+function normalizeRegistry(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return {};
+    const out = {};
+    for (const [key, raw] of Object.entries(value)) {
+        if (typeof raw !== "object" || raw === null)
+            continue;
+        const r = raw;
+        if (typeof r["name"] !== "string" || typeof r["path"] !== "string")
+            continue;
+        if (typeof r["indexedAt"] !== "string")
+            continue;
+        if (typeof r["nodeCount"] !== "number" || typeof r["edgeCount"] !== "number")
+            continue;
+        const entry = {
+            name: r["name"],
+            path: r["path"],
+            indexedAt: r["indexedAt"],
+            nodeCount: r["nodeCount"],
+            edgeCount: r["edgeCount"],
+            ...(typeof r["lastCommit"] === "string" ? { lastCommit: r["lastCommit"] } : {}),
+        };
+        out[key] = entry;
+    }
+    return out;
+}
+//# sourceMappingURL=repo-resolver.js.map

package/dist/repo-resolver.js.map

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