@opencodehub/mcp 0.1.0

package/dist/repo-uri-for-entry.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `repoUriForEntry` — resolve a `repo_uri` for a registry entry,
+ * preferring the graph-backed `RepoNode.repoUri` when the repo's index
+ * carries one, otherwise falling back to `deriveRepoUri(entry)` from
+ * `repo-resolver.ts`.
+ *
+ * Used by the `group_*` MCP tools so that every repo-identified
+ * response row carries a stable `repo_uri` alongside its legacy `name`
+ * / `_repo` string. Lookups are best-effort — any DB-open / query
+ * failure falls back silently to the derived URI so a single unhealthy
+ * repo cannot break the whole response.
+ *
+ * Determinism: `deriveRepoUri` is pure; `RepoNode.repoUri` is byte-
+ * stable when present. Neither path depends on wall-clock.
+ */
+import type { ConnectionPool } from "./connection-pool.js";
+import { type RegistryEntry } from "./repo-resolver.js";
+/**
+ * Resolve a `repo_uri` for `entry`. Pass a `pool` when the caller already
+ * has one (every group-* tool does). Omit to fall back to the pure-derived
+ * URI without any DB access — useful for orphan rows that aren't in the
+ * registry.
+ */
+export declare function repoUriForEntry(entry: RegistryEntry, pool?: ConnectionPool): Promise<string>;
+//# sourceMappingURL=repo-uri-for-entry.d.ts.map

package/dist/repo-uri-for-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-uri-for-entry.d.ts","sourceRoot":"","sources":["../src/repo-uri-for-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAevE;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,aAAa,EACpB,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,MAAM,CAAC,CAoBjB"}

package/dist/repo-uri-for-entry.js

@@ -0,0 +1,64 @@
+/**
+ * `repoUriForEntry` — resolve a `repo_uri` for a registry entry,
+ * preferring the graph-backed `RepoNode.repoUri` when the repo's index
+ * carries one, otherwise falling back to `deriveRepoUri(entry)` from
+ * `repo-resolver.ts`.
+ *
+ * Used by the `group_*` MCP tools so that every repo-identified
+ * response row carries a stable `repo_uri` alongside its legacy `name`
+ * / `_repo` string. Lookups are best-effort — any DB-open / query
+ * failure falls back silently to the derived URI so a single unhealthy
+ * repo cannot break the whole response.
+ *
+ * Determinism: `deriveRepoUri` is pure; `RepoNode.repoUri` is byte-
+ * stable when present. Neither path depends on wall-clock.
+ */
+// biome-ignore-all lint/complexity/useLiteralKeys: dot-access disallowed on Record index signatures
+import { resolve } from "node:path";
+import { makeNodeId } from "@opencodehub/core-types";
+import { resolveDbPath } from "@opencodehub/storage";
+import { deriveRepoUri } from "./repo-resolver.js";
+/**
+ * Preferred: read `RepoNode.repoUri` from the persisted Repo row.
+ * Only repos that were indexed with the first-class Repo entity carry
+ * this row — earlier indexes fall back to the derived URI.
+ */
+async function readRepoNodeUri(graph) {
+    const repoId = makeNodeId("Repo", "", "repo");
+    const repo = await graph.getRepoNode(repoId);
+    if (repo === undefined)
+        return undefined;
+    const uri = repo.repoUri;
+    return typeof uri === "string" && uri.length > 0 ? uri : undefined;
+}
+/**
+ * Resolve a `repo_uri` for `entry`. Pass a `pool` when the caller already
+ * has one (every group-* tool does). Omit to fall back to the pure-derived
+ * URI without any DB access — useful for orphan rows that aren't in the
+ * registry.
+ */
+export async function repoUriForEntry(entry, pool) {
+    if (pool !== undefined) {
+        const repoPath = resolve(entry.path);
+        const dbPath = resolveDbPath(repoPath);
+        try {
+            const store = await pool.acquire(repoPath, dbPath);
+            try {
+                const uri = await readRepoNodeUri(store.graph);
+                if (uri !== undefined)
+                    return uri;
+            }
+            finally {
+                await pool.release(repoPath);
+            }
+        }
+        catch {
+            // Fall through to derived URI — a missing DB file, an unreadable
+            // nodes table, or any other transient failure must not break the
+            // group response. The repo_uri output is additive; legacy fields
+            // stay correct.
+        }
+    }
+    return deriveRepoUri(entry);
+}
+//# sourceMappingURL=repo-uri-for-entry.js.map

package/dist/repo-uri-for-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-uri-for-entry.js","sourceRoot":"","sources":["../src/repo-uri-for-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,oGAAoG;AAEpG,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAsB,MAAM,oBAAoB,CAAC;AAEvE;;;;GAIG;AACH,KAAK,UAAU,eAAe,CAAC,KAAkB;IAC/C,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;IACzB,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACrE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAoB,EACpB,IAAqB;IAErB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACnD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC/C,IAAI,GAAG,KAAK,SAAS;oBAAE,OAAO,GAAG,CAAC;YACpC,CAAC;oBAAS,CAAC;gBACT,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,iEAAiE;YACjE,iEAAiE;YACjE,iEAAiE;YACjE,gBAAgB;QAClB,CAAC;IACH,CAAC;IACD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC"}

package/dist/resources/repo-cluster.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Resource template `codehub://repo/{name}/cluster/{clusterName}` — cluster members.
+ *
+ * Resolves `clusterName` against the Community node's `name` (stable
+ * `community-<id>` token) first, then its `inferredLabel` as a fallback
+ * so agents can pass the human-readable label. Members are joined via
+ * `MEMBER_OF` edges and ranked by `kind, name`. Cap at 100. Unknown
+ * names produce a `{error, candidates}` envelope listing up to 5
+ * similar cluster names.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ResourceContext } from "./repos.js";
+export declare function registerRepoClusterResource(server: McpServer, ctx: ResourceContext): void;
+/**
+ * Deterministic substring-first, Levenshtein-tiebreak ranker. Simple
+ * enough to be obviously correct; good enough to offer 5 neighbours.
+ */
+export declare function rankCandidates(needle: string, haystack: readonly string[]): readonly string[];
+//# sourceMappingURL=repo-cluster.d.ts.map

package/dist/resources/repo-cluster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-cluster.d.ts","sourceRoot":"","sources":["../../src/resources/repo-cluster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQlD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,eAAe,GAAG,IAAI,CAiGzF;AAiDD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAuB7F"}

package/dist/resources/repo-cluster.js

@@ -0,0 +1,203 @@
+/**
+ * Resource template `codehub://repo/{name}/cluster/{clusterName}` — cluster members.
+ *
+ * Resolves `clusterName` against the Community node's `name` (stable
+ * `community-<id>` token) first, then its `inferredLabel` as a fallback
+ * so agents can pass the human-readable label. Members are joined via
+ * `MEMBER_OF` edges and ranked by `kind, name`. Cap at 100. Unknown
+ * names produce a `{error, candidates}` envelope listing up to 5
+ * similar cluster names.
+ */
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { readRegistry } from "../repo-resolver.js";
+import { withResourceStore } from "./store-helper.js";
+import { yamlScalar } from "./yaml.js";
+const PATTERN = "codehub://repo/{name}/cluster/{clusterName}";
+const MEMBERS_CAP = 100;
+const CANDIDATES_CAP = 5;
+export function registerRepoClusterResource(server, ctx) {
+    const template = new ResourceTemplate(PATTERN, {
+        list: async () => {
+            const opts = ctx.home !== undefined ? { home: ctx.home } : {};
+            const reg = await readRegistry(opts);
+            return {
+                resources: Object.keys(reg)
+                    .sort()
+                    .map((name) => ({
+                    name: `${name}/cluster/{clusterName}`,
+                    uri: `codehub://repo/${encodeURIComponent(name)}/cluster/{clusterName}`,
+                    mimeType: "text/yaml",
+                    description: `Members of a community cluster in repo ${name}`,
+                })),
+            };
+        },
+    });
+    server.registerResource("repo-cluster", template, {
+        title: "Repo cluster members",
+        description: "YAML list of symbols that MEMBER_OF a named community cluster. Cap 100. Ranked by kind, name.",
+        mimeType: "text/yaml",
+    }, async (uri, variables) => {
+        const nameRaw = variables["name"];
+        const clusterRaw = variables["clusterName"];
+        const nameVar = Array.isArray(nameRaw) ? nameRaw[0] : nameRaw;
+        const clusterVar = Array.isArray(clusterRaw) ? clusterRaw[0] : clusterRaw;
+        const repoName = nameVar ? decodeURIComponent(String(nameVar)) : undefined;
+        const clusterName = clusterVar ? decodeURIComponent(String(clusterVar)) : "";
+        const resourceOpts = {};
+        if (ctx.home !== undefined)
+            resourceOpts.home = ctx.home;
+        if (ctx.pool !== undefined)
+            resourceOpts.pool = ctx.pool;
+        return withResourceStore(uri.href, repoName, resourceOpts, async (store, resolvedRepo) => {
+            const graph = store.graph;
+            const communities = (await graph.listNodesByKind("Community"));
+            const hit = communities.find((c) => c.name === clusterName || c.inferredLabel === clusterName);
+            if (hit === undefined) {
+                return buildNotFound(uri.href, resolvedRepo, clusterName, communities);
+            }
+            const communityId = hit.id;
+            const communityLabel = typeof hit.inferredLabel === "string" && hit.inferredLabel.length > 0
+                ? hit.inferredLabel
+                : null;
+            const communityName = hit.name;
+            const memberEdges = await graph.listEdgesByType("MEMBER_OF", { toIds: [communityId] });
+            const memberIds = Array.from(new Set(memberEdges.map((e) => e.from)));
+            const members = memberIds.length > 0 ? [...(await graph.listNodes({ ids: memberIds }))] : [];
+            members.sort((a, b) => {
+                if (a.kind !== b.kind)
+                    return a.kind < b.kind ? -1 : 1;
+                if (a.name !== b.name)
+                    return a.name < b.name ? -1 : 1;
+                return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+            });
+            const cappedMembers = members.slice(0, MEMBERS_CAP);
+            const lines = [];
+            lines.push(`repo: ${yamlScalar(resolvedRepo)}`);
+            lines.push(`cluster:`);
+            lines.push(`  id: ${yamlScalar(communityId)}`);
+            lines.push(`  name: ${yamlScalar(communityName)}`);
+            if (communityLabel) {
+                lines.push(`  label: ${yamlScalar(communityLabel)}`);
+            }
+            lines.push("members:");
+            if (cappedMembers.length === 0) {
+                lines.push("  []");
+            }
+            else {
+                for (const m of cappedMembers) {
+                    lines.push(`  - id: ${yamlScalar(m.id)}`);
+                    lines.push(`    name: ${yamlScalar(m.name)}`);
+                    lines.push(`    kind: ${yamlScalar(m.kind)}`);
+                    lines.push(`    filePath: ${yamlScalar(m.filePath)}`);
+                }
+            }
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: "text/yaml",
+                        text: `${lines.join("\n")}\n`,
+                    },
+                ],
+            };
+        });
+    });
+}
+async function buildNotFound(uri, repoName, clusterName, communities) {
+    const ordered = [...communities].sort((a, b) => {
+        const ac = a.symbolCount ?? 0;
+        const bc = b.symbolCount ?? 0;
+        if (ac !== bc)
+            return bc - ac;
+        return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+    });
+    const candidates = rankCandidates(clusterName, ordered.flatMap((c) => {
+        const out = [];
+        const n = typeof c.name === "string" ? c.name : null;
+        const l = typeof c.inferredLabel === "string" ? c.inferredLabel : null;
+        if (n)
+            out.push(n);
+        if (l && l !== n)
+            out.push(l);
+        return out;
+    })).slice(0, CANDIDATES_CAP);
+    const lines = [];
+    lines.push(`repo: ${yamlScalar(repoName)}`);
+    lines.push(`cluster: ${yamlScalar(clusterName)}`);
+    lines.push('error: "not found"');
+    lines.push("candidates:");
+    if (candidates.length === 0) {
+        lines.push("  []");
+    }
+    else {
+        for (const c of candidates) {
+            lines.push(`  - ${yamlScalar(c)}`);
+        }
+    }
+    return {
+        contents: [
+            {
+                uri,
+                mimeType: "text/yaml",
+                text: `${lines.join("\n")}\n`,
+            },
+        ],
+    };
+}
+/**
+ * Deterministic substring-first, Levenshtein-tiebreak ranker. Simple
+ * enough to be obviously correct; good enough to offer 5 neighbours.
+ */
+export function rankCandidates(needle, haystack) {
+    const lower = needle.toLowerCase();
+    const scored = haystack.map((h) => {
+        const lh = h.toLowerCase();
+        let score = 0;
+        if (lh === lower)
+            score = 1000;
+        else if (lh.startsWith(lower))
+            score = 500 - Math.abs(lh.length - lower.length);
+        else if (lh.includes(lower))
+            score = 250 - Math.abs(lh.length - lower.length);
+        else
+            score = 100 - levenshtein(lh, lower);
+        return { value: h, score };
+    });
+    scored.sort((a, b) => {
+        if (b.score !== a.score)
+            return b.score - a.score;
+        return a.value < b.value ? -1 : a.value > b.value ? 1 : 0;
+    });
+    const seen = new Set();
+    const out = [];
+    for (const s of scored) {
+        if (seen.has(s.value))
+            continue;
+        seen.add(s.value);
+        out.push(s.value);
+    }
+    return out;
+}
+function levenshtein(a, b) {
+    if (a === b)
+        return 0;
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    const prev = new Array(b.length + 1);
+    const cur = new Array(b.length + 1);
+    for (let j = 0; j <= b.length; j += 1)
+        prev[j] = j;
+    for (let i = 1; i <= a.length; i += 1) {
+        cur[0] = i;
+        for (let j = 1; j <= b.length; j += 1) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            cur[j] = Math.min((cur[j - 1] ?? 0) + 1, (prev[j] ?? 0) + 1, (prev[j - 1] ?? 0) + cost);
+        }
+        for (let j = 0; j <= b.length; j += 1)
+            prev[j] = cur[j] ?? 0;
+    }
+    return prev[b.length] ?? 0;
+}
+//# sourceMappingURL=repo-cluster.js.map

package/dist/resources/repo-cluster.js.map

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

package/dist/resources/repo-clusters.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Resource template `codehub://repo/{name}/clusters` — list community clusters.
+ *
+ * Each row corresponds to a `Community` node emitted by the communities
+ * phase (Leiden over the CALLS + HAS_METHOD callable graph). The agent
+ * uses this as the entry point for behavioural navigation: pick a
+ * cluster, then read `codehub://repo/{name}/cluster/{clusterName}` for
+ * its members. Ranked by `symbolCount DESC, cohesion DESC` so the
+ * highest-impact clusters surface first; capped at 20.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ResourceContext } from "./repos.js";
+export declare function registerRepoClustersResource(server: McpServer, ctx: ResourceContext): void;
+//# sourceMappingURL=repo-clusters.d.ts.map

package/dist/resources/repo-clusters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-clusters.d.ts","sourceRoot":"","sources":["../../src/resources/repo-clusters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAOlD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,eAAe,GAAG,IAAI,CAmF1F"}

package/dist/resources/repo-clusters.js

@@ -0,0 +1,97 @@
+/**
+ * Resource template `codehub://repo/{name}/clusters` — list community clusters.
+ *
+ * Each row corresponds to a `Community` node emitted by the communities
+ * phase (Leiden over the CALLS + HAS_METHOD callable graph). The agent
+ * uses this as the entry point for behavioural navigation: pick a
+ * cluster, then read `codehub://repo/{name}/cluster/{clusterName}` for
+ * its members. Ranked by `symbolCount DESC, cohesion DESC` so the
+ * highest-impact clusters surface first; capped at 20.
+ */
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { readRegistry } from "../repo-resolver.js";
+import { withResourceStore } from "./store-helper.js";
+import { yamlScalar } from "./yaml.js";
+const PATTERN = "codehub://repo/{name}/clusters";
+const RESULT_CAP = 20;
+export function registerRepoClustersResource(server, ctx) {
+    const template = new ResourceTemplate(PATTERN, {
+        list: async () => {
+            const opts = ctx.home !== undefined ? { home: ctx.home } : {};
+            const reg = await readRegistry(opts);
+            return {
+                resources: Object.keys(reg)
+                    .sort()
+                    .map((name) => ({
+                    name: `${name}/clusters`,
+                    uri: `codehub://repo/${encodeURIComponent(name)}/clusters`,
+                    mimeType: "text/yaml",
+                    description: `Community clusters for repo ${name}`,
+                })),
+            };
+        },
+    });
+    server.registerResource("repo-clusters", template, {
+        title: "Repo clusters",
+        description: "YAML list of Community nodes (Leiden clusters) ranked by size and cohesion. Cap 20.",
+        mimeType: "text/yaml",
+    }, async (uri, variables) => {
+        const raw = variables["name"];
+        const nameVar = Array.isArray(raw) ? raw[0] : raw;
+        const decoded = nameVar ? decodeURIComponent(String(nameVar)) : undefined;
+        const resourceOpts = {};
+        if (ctx.home !== undefined)
+            resourceOpts.home = ctx.home;
+        if (ctx.pool !== undefined)
+            resourceOpts.pool = ctx.pool;
+        return withResourceStore(uri.href, decoded, resourceOpts, async (store, repoName) => {
+            const communities = (await store.graph.listNodesByKind("Community"));
+            const rows = [...communities]
+                .sort((a, b) => {
+                const ac = a.symbolCount ?? 0;
+                const bc = b.symbolCount ?? 0;
+                if (ac !== bc)
+                    return bc - ac;
+                const ah = a.cohesion ?? 0;
+                const bh = b.cohesion ?? 0;
+                if (ah !== bh)
+                    return bh - ah;
+                return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+            })
+                .slice(0, RESULT_CAP);
+            const lines = [];
+            lines.push(`repo: ${yamlScalar(repoName)}`);
+            lines.push("clusters:");
+            if (rows.length === 0) {
+                lines.push("  []");
+            }
+            else {
+                for (const c of rows) {
+                    lines.push(`  - id: ${yamlScalar(c.id)}`);
+                    lines.push(`    name: ${yamlScalar(c.name)}`);
+                    if (c.inferredLabel && c.inferredLabel.length > 0) {
+                        lines.push(`    label: ${yamlScalar(c.inferredLabel)}`);
+                    }
+                    lines.push(`    symbolCount: ${c.symbolCount ?? 0}`);
+                    lines.push(`    cohesion: ${c.cohesion ?? 0}`);
+                    if (c.keywords && c.keywords.length > 0) {
+                        lines.push("    keywords:");
+                        for (const kw of c.keywords) {
+                            lines.push(`      - ${yamlScalar(kw)}`);
+                        }
+                    }
+                }
+            }
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: "text/yaml",
+                        text: `${lines.join("\n")}\n`,
+                    },
+                ],
+            };
+        });
+    });
+}
+//# sourceMappingURL=repo-clusters.js.map

package/dist/resources/repo-clusters.js.map

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

package/dist/resources/repo-context.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resource template `codehub://repo/{name}/context` — per-repo overview.
+ *
+ * Emits stats + staleness + a curated list of available tools so agents
+ * learn what they can do in a single `resources/read`. The `list`
+ * callback enumerates the same URI pattern for every registered repo so
+ * clients like Claude Code show them in the @-mention picker.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ResourceContext } from "./repos.js";
+export declare function registerRepoContextResource(server: McpServer, ctx: ResourceContext): void;
+//# sourceMappingURL=repo-context.d.ts.map

package/dist/resources/repo-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-context.d.ts","sourceRoot":"","sources":["../../src/resources/repo-context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAclD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,eAAe,GAAG,IAAI,CAmEzF"}

package/dist/resources/repo-context.js

@@ -0,0 +1,84 @@
+/**
+ * Resource template `codehub://repo/{name}/context` — per-repo overview.
+ *
+ * Emits stats + staleness + a curated list of available tools so agents
+ * learn what they can do in a single `resources/read`. The `list`
+ * callback enumerates the same URI pattern for every registered repo so
+ * clients like Claude Code show them in the @-mention picker.
+ */
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { resolveRepo } from "../repo-resolver.js";
+import { stalenessFromMeta } from "../staleness.js";
+const PATTERN = "codehub://repo/{name}/context";
+const AVAILABLE_TOOLS = [
+    "list_repos",
+    "query",
+    "context",
+    "impact",
+    "detect_changes",
+    "rename",
+    "sql",
+];
+export function registerRepoContextResource(server, ctx) {
+    const template = new ResourceTemplate(PATTERN, {
+        list: async () => {
+            const { readRegistry } = await import("../repo-resolver.js");
+            const opts = ctx.home !== undefined ? { home: ctx.home } : {};
+            const reg = await readRegistry(opts);
+            return {
+                resources: Object.keys(reg)
+                    .sort()
+                    .map((name) => ({
+                    name: `${name}/context`,
+                    uri: `codehub://repo/${encodeURIComponent(name)}/context`,
+                    mimeType: "text/yaml",
+                    description: `Context card for repo ${name}`,
+                })),
+            };
+        },
+    });
+    server.registerResource("repo-context", template, {
+        title: "Repo context card",
+        description: "YAML overview of a registered repo: stats, staleness, and the tools available to act on it.",
+        mimeType: "text/yaml",
+    }, async (uri, variables) => {
+        const raw = variables["name"];
+        const nameVar = Array.isArray(raw) ? raw[0] : raw;
+        const decoded = nameVar ? decodeURIComponent(String(nameVar)) : undefined;
+        const opts = ctx.home !== undefined ? { home: ctx.home } : {};
+        const resolved = await resolveRepo(decoded, opts);
+        const staleness = stalenessFromMeta(resolved.meta);
+        const lines = [];
+        lines.push(`repo: ${resolved.name}`);
+        lines.push(`path: ${resolved.repoPath}`);
+        lines.push("stats:");
+        lines.push(`  nodeCount: ${resolved.entry.nodeCount}`);
+        lines.push(`  edgeCount: ${resolved.entry.edgeCount}`);
+        lines.push(`  indexedAt: ${resolved.entry.indexedAt}`);
+        if (resolved.entry.lastCommit) {
+            lines.push(`  lastCommit: ${resolved.entry.lastCommit}`);
+        }
+        if (staleness) {
+            lines.push("staleness:");
+            lines.push(`  isStale: ${staleness.isStale}`);
+            lines.push(`  commitsBehind: ${staleness.commitsBehind}`);
+            if (staleness.lastIndexedCommit) {
+                lines.push(`  lastIndexedCommit: ${staleness.lastIndexedCommit}`);
+            }
+        }
+        lines.push("available_tools:");
+        for (const t of AVAILABLE_TOOLS) {
+            lines.push(`  - ${t}`);
+        }
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "text/yaml",
+                    text: `${lines.join("\n")}\n`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=repo-context.js.map

package/dist/resources/repo-context.js.map

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

package/dist/resources/repo-process.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Resource template `codehub://repo/{name}/process/{processName}` — process trace.
+ *
+ * Resolves `processName` against the Process node's `name` first (the
+ * synthesised `<entry>-flow` token), then its `inferredLabel` as a
+ * fallback. The ordered trace walks PROCESS_STEP edges starting from
+ * the entry point (step 0) through every BFS-reached symbol. Unknown
+ * names produce a `{error, candidates}` envelope listing up to 5 close
+ * matches.
+ *
+ * PROCESS_STEP edges live between callable symbols (not between the
+ * Process node and its members). The entry point itself is the
+ * `from_id` of the first step emitted by the phase; we surface it as
+ * step 0 with its own row so the trace is usable standalone.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ResourceContext } from "./repos.js";
+export declare function registerRepoProcessResource(server: McpServer, ctx: ResourceContext): void;
+//# sourceMappingURL=repo-process.d.ts.map

package/dist/resources/repo-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-process.d.ts","sourceRoot":"","sources":["../../src/resources/repo-process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAOlD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,eAAe,GAAG,IAAI,CAqGzF"}