@opencodehub/mcp 0.1.0

package/dist/resources/repo-process.js

@@ -0,0 +1,220 @@
+/**
+ * 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 { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { readRegistry } from "../repo-resolver.js";
+import { rankCandidates } from "./repo-cluster.js";
+import { withResourceStore } from "./store-helper.js";
+import { yamlScalar } from "./yaml.js";
+const PATTERN = "codehub://repo/{name}/process/{processName}";
+const CANDIDATES_CAP = 5;
+export function registerRepoProcessResource(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}/process/{processName}`,
+                    uri: `codehub://repo/${encodeURIComponent(name)}/process/{processName}`,
+                    mimeType: "text/yaml",
+                    description: `Ordered PROCESS_STEP trace for a named process in repo ${name}`,
+                })),
+            };
+        },
+    });
+    server.registerResource("repo-process", template, {
+        title: "Repo process trace",
+        description: "YAML ordered PROCESS_STEP trace for a named process (entry point first; step ASC).",
+        mimeType: "text/yaml",
+    }, async (uri, variables) => {
+        const nameRaw = variables["name"];
+        const processRaw = variables["processName"];
+        const nameVar = Array.isArray(nameRaw) ? nameRaw[0] : nameRaw;
+        const processVar = Array.isArray(processRaw) ? processRaw[0] : processRaw;
+        const repoName = nameVar ? decodeURIComponent(String(nameVar)) : undefined;
+        const processName = processVar ? decodeURIComponent(String(processVar)) : "";
+        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 processes = (await graph.listNodesByKind("Process"));
+            const hit = processes.find((p) => p.name === processName || p.inferredLabel === processName);
+            if (hit === undefined) {
+                return buildNotFound(uri.href, resolvedRepo, processName, processes);
+            }
+            const processId = hit.id;
+            const processRowName = hit.name;
+            const processLabel = typeof hit.inferredLabel === "string" && hit.inferredLabel.length > 0
+                ? hit.inferredLabel
+                : null;
+            const entryPointId = typeof hit.entryPointId === "string" && hit.entryPointId.length > 0
+                ? hit.entryPointId
+                : null;
+            const processFilePath = hit.filePath;
+            const traceRows = entryPointId ? await walkProcessTrace(graph, entryPointId) : [];
+            const lines = [];
+            lines.push(`repo: ${yamlScalar(resolvedRepo)}`);
+            lines.push("process:");
+            lines.push(`  id: ${yamlScalar(processId)}`);
+            lines.push(`  name: ${yamlScalar(processRowName)}`);
+            if (processLabel) {
+                lines.push(`  label: ${yamlScalar(processLabel)}`);
+            }
+            lines.push(`  processType: flow`);
+            if (entryPointId) {
+                lines.push(`  entryPointId: ${yamlScalar(entryPointId)}`);
+            }
+            if (processFilePath) {
+                lines.push(`  filePath: ${yamlScalar(processFilePath)}`);
+            }
+            lines.push("trace:");
+            if (traceRows.length === 0) {
+                lines.push("  []");
+            }
+            else {
+                for (const row of traceRows) {
+                    lines.push(`  - step: ${row.step}`);
+                    lines.push(`    id: ${yamlScalar(row.id)}`);
+                    lines.push(`    name: ${yamlScalar(row.name)}`);
+                    lines.push(`    kind: ${yamlScalar(row.kind)}`);
+                    lines.push(`    filePath: ${yamlScalar(row.filePath)}`);
+                }
+            }
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: "text/yaml",
+                        text: `${lines.join("\n")}\n`,
+                    },
+                ],
+            };
+        });
+    });
+}
+/**
+ * Walk PROCESS_STEP edges rooted at `entryPointId` and return an ordered
+ * (step ASC) list of participating symbols. The entry point itself is
+ * surfaced as step 0; PROCESS_STEP rows populate the subsequent steps.
+ */
+async function walkProcessTrace(graph, entryPointId) {
+    // Snapshot all nodes once for partner metadata lookup.
+    const allNodes = await graph.listNodes();
+    const byId = new Map();
+    for (const n of allNodes)
+        byId.set(n.id, n);
+    const allEdges = await graph.listEdgesByType("PROCESS_STEP");
+    const adj = new Map();
+    for (const e of allEdges) {
+        const list = adj.get(e.from) ?? [];
+        list.push({ toId: e.to, step: e.step ?? 0 });
+        adj.set(e.from, list);
+    }
+    for (const list of adj.values()) {
+        list.sort((a, b) => {
+            if (a.step !== b.step)
+                return a.step - b.step;
+            return a.toId < b.toId ? -1 : a.toId > b.toId ? 1 : 0;
+        });
+    }
+    const out = [];
+    const seen = new Set();
+    const entryNode = byId.get(entryPointId);
+    if (entryNode !== undefined) {
+        out.push({
+            step: 0,
+            id: entryNode.id,
+            name: entryNode.name,
+            kind: entryNode.kind,
+            filePath: entryNode.filePath,
+        });
+        seen.add(entryNode.id);
+    }
+    const queue = [entryPointId];
+    let guard = 0;
+    while (queue.length > 0 && guard < 100) {
+        guard += 1;
+        const current = queue.shift();
+        const outgoing = adj.get(current) ?? [];
+        for (const e of outgoing) {
+            if (seen.has(e.toId))
+                continue;
+            seen.add(e.toId);
+            const partner = byId.get(e.toId);
+            out.push({
+                step: e.step,
+                id: e.toId,
+                name: partner?.name ?? "",
+                kind: partner?.kind ?? "",
+                filePath: partner?.filePath ?? "",
+            });
+            queue.push(e.toId);
+        }
+    }
+    out.sort((a, b) => {
+        if (a.step !== b.step)
+            return a.step - b.step;
+        return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+    });
+    return out;
+}
+async function buildNotFound(uri, repoName, processName, processes) {
+    const ordered = [...processes].sort((a, b) => {
+        const ac = a.stepCount ?? 0;
+        const bc = b.stepCount ?? 0;
+        if (ac !== bc)
+            return bc - ac;
+        return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+    });
+    const candidates = rankCandidates(processName, ordered.flatMap((p) => {
+        const out = [];
+        const n = typeof p.name === "string" ? p.name : null;
+        const l = typeof p.inferredLabel === "string" ? p.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(`process: ${yamlScalar(processName)}`);
+    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`,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=repo-process.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * Resource template `codehub://repo/{name}/processes` — list process flows.
+ *
+ * Each row is a `Process` node emitted by the processes phase (BFS from
+ * scored entry points). Ranked by `stepCount DESC` so the longest /
+ * most consequential flows surface first; capped at 20. `processType`
+ * is always `"flow"` today; the field is kept shape-stable so future
+ * process flavours (route flows, tool flows) don't force a rev.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ResourceContext } from "./repos.js";
+export declare function registerRepoProcessesResource(server: McpServer, ctx: ResourceContext): void;
+//# sourceMappingURL=repo-processes.d.ts.map

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

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

package/dist/resources/repo-processes.js

@@ -0,0 +1,99 @@
+/**
+ * Resource template `codehub://repo/{name}/processes` — list process flows.
+ *
+ * Each row is a `Process` node emitted by the processes phase (BFS from
+ * scored entry points). Ranked by `stepCount DESC` so the longest /
+ * most consequential flows surface first; capped at 20. `processType`
+ * is always `"flow"` today; the field is kept shape-stable so future
+ * process flavours (route flows, tool flows) don't force a rev.
+ */
+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}/processes";
+const RESULT_CAP = 20;
+export function registerRepoProcessesResource(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}/processes`,
+                    uri: `codehub://repo/${encodeURIComponent(name)}/processes`,
+                    mimeType: "text/yaml",
+                    description: `Process flows for repo ${name}`,
+                })),
+            };
+        },
+    });
+    server.registerResource("repo-processes", template, {
+        title: "Repo processes",
+        description: "YAML list of Process nodes (BFS flows) ranked by stepCount. 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 processes = (await store.graph.listNodesByKind("Process"));
+            const rows = [...processes]
+                .sort((a, b) => {
+                const ac = a.stepCount ?? 0;
+                const bc = b.stepCount ?? 0;
+                if (ac !== bc)
+                    return bc - ac;
+                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("processes:");
+            if (rows.length === 0) {
+                lines.push("  []");
+            }
+            else {
+                for (const p of rows) {
+                    const label = typeof p.inferredLabel === "string" && p.inferredLabel.length > 0
+                        ? p.inferredLabel
+                        : null;
+                    const stepCount = p.stepCount ?? 0;
+                    const entryPointId = typeof p.entryPointId === "string" && p.entryPointId.length > 0
+                        ? p.entryPointId
+                        : null;
+                    lines.push(`  - id: ${yamlScalar(p.id)}`);
+                    lines.push(`    name: ${yamlScalar(p.name)}`);
+                    if (label) {
+                        lines.push(`    label: ${yamlScalar(label)}`);
+                    }
+                    lines.push(`    processType: flow`);
+                    lines.push(`    stepCount: ${stepCount}`);
+                    if (entryPointId) {
+                        lines.push(`    entryPointId: ${yamlScalar(entryPointId)}`);
+                    }
+                    if (p.filePath && p.filePath.length > 0) {
+                        lines.push(`    filePath: ${yamlScalar(p.filePath)}`);
+                    }
+                }
+            }
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: "text/yaml",
+                        text: `${lines.join("\n")}\n`,
+                    },
+                ],
+            };
+        });
+    });
+}
+//# sourceMappingURL=repo-processes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repo-processes.js","sourceRoot":"","sources":["../../src/resources/repo-processes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAG3E,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,OAAO,GAAG,iCAAiC,CAAC;AAClD,MAAM,UAAU,GAAG,EAAE,CAAC;AAEtB,MAAM,UAAU,6BAA6B,CAAC,MAAiB,EAAE,GAAoB;IACnF,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,OAAO,EAAE;QAC7C,IAAI,EAAE,KAAK,IAAkC,EAAE;YAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;YACrC,OAAO;gBACL,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;qBACxB,IAAI,EAAE;qBACN,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;oBACd,IAAI,EAAE,GAAG,IAAI,YAAY;oBACzB,GAAG,EAAE,kBAAkB,kBAAkB,CAAC,IAAI,CAAC,YAAY;oBAC3D,QAAQ,EAAE,WAAW;oBACrB,WAAW,EAAE,0BAA0B,IAAI,EAAE;iBAC9C,CAAC,CAAC;aACN,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IACH,MAAM,CAAC,gBAAgB,CACrB,gBAAgB,EAChB,QAAQ,EACR;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,qEAAqE;QAClF,QAAQ,EAAE,WAAW;KACtB,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAA+B,EAAE;QACpD,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAClD,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,MAAM,YAAY,GAA8C,EAAE,CAAC;QACnE,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;YAAE,YAAY,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACzD,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;YAAE,YAAY,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QAEzD,OAAO,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;YAClF,MAAM,SAAS,GAAG,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,SAAS,CAAC,CAA2B,CAAC;YAC3F,MAAM,IAAI,GAAG,CAAC,GAAG,SAAS,CAAC;iBACxB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACb,MAAM,EAAE,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;gBAC5B,MAAM,EAAE,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;gBAC5B,IAAI,EAAE,KAAK,EAAE;oBAAE,OAAO,EAAE,GAAG,EAAE,CAAC;gBAC9B,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAChD,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YAExB,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACzB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACN,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;oBACrB,MAAM,KAAK,GACT,OAAO,CAAC,CAAC,aAAa,KAAK,QAAQ,IAAI,CAAC,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;wBAC/D,CAAC,CAAC,CAAC,CAAC,aAAa;wBACjB,CAAC,CAAC,IAAI,CAAC;oBACX,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;oBACnC,MAAM,YAAY,GAChB,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,IAAI,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;wBAC7D,CAAC,CAAC,CAAC,CAAC,YAAY;wBAChB,CAAC,CAAC,IAAI,CAAC;oBACX,KAAK,CAAC,IAAI,CAAC,WAAW,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;oBAC1C,KAAK,CAAC,IAAI,CAAC,aAAa,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBAC9C,IAAI,KAAK,EAAE,CAAC;wBACV,KAAK,CAAC,IAAI,CAAC,cAAc,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;oBAChD,CAAC;oBACD,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;oBACpC,KAAK,CAAC,IAAI,CAAC,kBAAkB,SAAS,EAAE,CAAC,CAAC;oBAC1C,IAAI,YAAY,EAAE,CAAC;wBACjB,KAAK,CAAC,IAAI,CAAC,qBAAqB,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;oBAC9D,CAAC;oBACD,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACxC,KAAK,CAAC,IAAI,CAAC,iBAAiB,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;oBACxD,CAAC;gBACH,CAAC;YACH,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,WAAW;wBACrB,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;qBAC9B;iBACF;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Resource template `codehub://repo/{name}/schema` — node/edge vocabulary.
+ *
+ * Exposed as YAML so agents can author SQL (or reason about graph
+ * structure) without having to call `sql` with introspective queries.
+ * The payload is static — it reflects the compile-time vocabulary, not
+ * anything runtime-discovered — which is fine because every indexed
+ * repo shares the same schema version at MVP.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ResourceContext } from "./repos.js";
+export declare function registerRepoSchemaResource(server: McpServer, ctx: ResourceContext): void;
+//# sourceMappingURL=repo-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repo-schema.d.ts","sourceRoot":"","sources":["../../src/resources/repo-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA2ClD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,eAAe,GAAG,IAAI,CAiDxF"}

package/dist/resources/repo-schema.js

@@ -0,0 +1,99 @@
+/**
+ * Resource template `codehub://repo/{name}/schema` — node/edge vocabulary.
+ *
+ * Exposed as YAML so agents can author SQL (or reason about graph
+ * structure) without having to call `sql` with introspective queries.
+ * The payload is static — it reflects the compile-time vocabulary, not
+ * anything runtime-discovered — which is fine because every indexed
+ * repo shares the same schema version at MVP.
+ */
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { NODE_KINDS, RELATION_TYPES, SCHEMA_VERSION } from "@opencodehub/core-types";
+import { readRegistry } from "../repo-resolver.js";
+const PATTERN = "codehub://repo/{name}/schema";
+const NODE_COLUMNS = [
+    "id",
+    "kind",
+    "name",
+    "file_path",
+    "start_line",
+    "end_line",
+    "is_exported",
+    "signature",
+    "parameter_count",
+    "return_type",
+    "declared_type",
+    "owner",
+    "url",
+    "method",
+    "tool_name",
+    "content",
+    "content_hash",
+    "inferred_label",
+    "symbol_count",
+    "cohesion",
+    "keywords",
+    "entry_point_id",
+    "step_count",
+    "level",
+    "response_keys",
+    "description",
+];
+const RELATION_COLUMNS = [
+    "id",
+    "from_id",
+    "to_id",
+    "type",
+    "confidence",
+    "reason",
+    "step",
+];
+export function registerRepoSchemaResource(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}/schema`,
+                    uri: `codehub://repo/${encodeURIComponent(name)}/schema`,
+                    mimeType: "text/yaml",
+                    description: `Graph schema for repo ${name}`,
+                })),
+            };
+        },
+    });
+    server.registerResource("repo-schema", template, {
+        title: "Graph schema",
+        description: "YAML listing every NodeKind and RelationType with the table columns agents can filter on when authoring `sql` queries.",
+        mimeType: "text/yaml",
+    }, async (uri) => {
+        const lines = [];
+        lines.push(`schemaVersion: ${SCHEMA_VERSION}`);
+        lines.push("tables:");
+        lines.push("  nodes:");
+        for (const c of NODE_COLUMNS)
+            lines.push(`    - ${c}`);
+        lines.push("  relations:");
+        for (const c of RELATION_COLUMNS)
+            lines.push(`    - ${c}`);
+        lines.push("nodeKinds:");
+        for (const k of NODE_KINDS)
+            lines.push(`  - ${k}`);
+        lines.push("relationTypes:");
+        for (const t of RELATION_TYPES)
+            lines.push(`  - ${t}`);
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "text/yaml",
+                    text: `${lines.join("\n")}\n`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=repo-schema.js.map

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

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

package/dist/resources/repos.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Resource `codehub://repos` — lists every registered repo with stats.
+ *
+ * The payload is YAML for readability (agents tend to handle YAML well in
+ * resources that they render in their own context) and because it is
+ * what the `codehub://repo/{name}/context` resource also emits.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ConnectionPool } from "../connection-pool.js";
+export interface ResourceContext {
+    readonly home?: string;
+    /**
+     * Connection pool used by data-reading resource handlers (clusters,
+     * processes). `repos`, `repo-context`, and `repo-schema` don't need it
+     * because they only read the registry and static schema vocabulary.
+     */
+    readonly pool?: ConnectionPool;
+}
+export declare function registerReposResource(server: McpServer, ctx: ResourceContext): void;
+//# sourceMappingURL=repos.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repos.d.ts","sourceRoot":"","sources":["../../src/resources/repos.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;CAChC;AAID,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,eAAe,GAAG,IAAI,CAwCnF"}

package/dist/resources/repos.js

@@ -0,0 +1,58 @@
+/**
+ * Resource `codehub://repos` — lists every registered repo with stats.
+ *
+ * The payload is YAML for readability (agents tend to handle YAML well in
+ * resources that they render in their own context) and because it is
+ * what the `codehub://repo/{name}/context` resource also emits.
+ */
+import { readRegistry } from "../repo-resolver.js";
+const URI = "codehub://repos";
+export function registerReposResource(server, ctx) {
+    server.registerResource("repos", URI, {
+        title: "Indexed repos",
+        description: "YAML listing of every repo registered under ~/.codehub/registry.json with name, path, and stats.",
+        mimeType: "text/yaml",
+    }, async (uri) => {
+        const opts = ctx.home !== undefined ? { home: ctx.home } : {};
+        const reg = await readRegistry(opts);
+        const names = Object.keys(reg).sort();
+        const lines = ["repos:"];
+        if (names.length === 0) {
+            lines.push("  []");
+        }
+        else {
+            for (const name of names) {
+                const e = reg[name];
+                if (!e)
+                    continue;
+                lines.push(`  - name: ${yaml(name)}`);
+                lines.push(`    path: ${yaml(e.path)}`);
+                lines.push(`    indexedAt: ${yaml(e.indexedAt)}`);
+                if (e.lastCommit)
+                    lines.push(`    lastCommit: ${yaml(e.lastCommit)}`);
+                lines.push(`    nodeCount: ${e.nodeCount}`);
+                lines.push(`    edgeCount: ${e.edgeCount}`);
+            }
+        }
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "text/yaml",
+                    text: `${lines.join("\n")}\n`,
+                },
+            ],
+        };
+    });
+}
+function yaml(value) {
+    // Very small YAML scalar quoter: wrap in double quotes if the value
+    // contains characters that would confuse a loose YAML parser.
+    if (/^[A-Za-z0-9._\-/]+$/.test(value))
+        return value;
+    // Escape `\` first so a literal `\` in the value cannot pair with the
+    // following `"` to form an unintended `\"` escape sequence in the
+    // emitted YAML scalar (js/incomplete-sanitization).
+    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+//# sourceMappingURL=repos.js.map

package/dist/resources/repos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repos.js","sourceRoot":"","sources":["../../src/resources/repos.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAYnD,MAAM,GAAG,GAAG,iBAAiB,CAAC;AAE9B,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,GAAoB;IAC3E,MAAM,CAAC,gBAAgB,CACrB,OAAO,EACP,GAAG,EACH;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,kGAAkG;QACpG,QAAQ,EAAE,WAAW;KACtB,EACD,KAAK,EAAE,GAAG,EAA+B,EAAE;QACzC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,KAAK,GAAa,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;gBACpB,IAAI,CAAC,CAAC;oBAAE,SAAS;gBACjB,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACtC,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACxC,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBAClD,IAAI,CAAC,CAAC,UAAU;oBAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;gBACtE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;gBAC5C,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QACD,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,WAAW;oBACrB,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;iBAC9B;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,IAAI,CAAC,KAAa;IACzB,oEAAoE;IACpE,8DAA8D;IAC9D,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACpD,sEAAsE;IACtE,kEAAkE;IAClE,oDAAoD;IACpD,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;AAClE,CAAC"}

package/dist/resources/store-helper.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared repo-resolution + store-checkout helper for resource handlers.
+ *
+ * Mirrors the tool-side `withStore` but returns shape appropriate for
+ * resources: instead of `CallToolResult`, resource callbacks return
+ * `ReadResourceResult`, which carries a plain text body. Errors
+ * (missing pool, repo not found, DuckDB open failure) are surfaced as a
+ * YAML error envelope inside the resource body so the agent sees the
+ * problem inline rather than receiving a transport-level fault.
+ */
+import type { ReadResourceResult } from "@modelcontextprotocol/sdk/types.js";
+import type { Store } from "@opencodehub/storage";
+import type { ConnectionPool } from "../connection-pool.js";
+export interface ResourceStoreOptions {
+    readonly home?: string;
+    readonly pool?: ConnectionPool;
+}
+export interface ResourceStoreError {
+    readonly result: ReadResourceResult;
+}
+/**
+ * Acquire a read-only store handle for `repoName`, invoke `fn`, and
+ * release. When resolution fails, return a YAML error envelope the
+ * caller should pass straight through. The callback is responsible for
+ * building the happy-path result.
+ */
+export declare function withResourceStore(uriHref: string, repoName: string | undefined, opts: ResourceStoreOptions, fn: (store: Store, repoName: string) => Promise<ReadResourceResult>): Promise<ReadResourceResult>;
+//# sourceMappingURL=store-helper.d.ts.map

package/dist/resources/store-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-helper.d.ts","sourceRoot":"","sources":["../../src/resources/store-helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,IAAI,EAAE,oBAAoB,EAC1B,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,GAClE,OAAO,CAAC,kBAAkB,CAAC,CAoB7B"}