@reposkein/mcp 0.1.0

package/dist/store/jsonlGraph.js

@@ -0,0 +1,176 @@
+/** Parses committed RepoSkein JSONL into in-memory records + lookup indices.
+ *  Pure (no I/O) so it is trivially testable. Committed JSONL has no repo_id
+ *  property — the repo is supplied by the caller (which .reposkein/ was loaded). */
+function parseNodeLine(line, repoId) {
+    const obj = JSON.parse(line);
+    const id = obj.id;
+    const labels = obj.labels;
+    if (typeof id !== "string" || !Array.isArray(labels))
+        return null;
+    const props = { ...obj };
+    delete props.id;
+    delete props.labels;
+    return { id, repoId, labels: labels.filter((l) => typeof l === "string"), props };
+}
+function parseEdgeLine(line) {
+    const obj = JSON.parse(line);
+    const from = obj.from;
+    const type = obj.type;
+    const to = obj.to;
+    if (typeof from !== "string" || typeof type !== "string" || typeof to !== "string")
+        return null;
+    const props = { ...obj };
+    delete props.from;
+    delete props.type;
+    delete props.to;
+    return { from, type, to, props };
+}
+export function parseNodes(text, repoId) {
+    const out = [];
+    for (const line of text.split("\n")) {
+        if (line.trim() === "")
+            continue;
+        const n = parseNodeLine(line, repoId);
+        if (n)
+            out.push(n);
+    }
+    return out;
+}
+export function parseEdges(text) {
+    const out = [];
+    for (const line of text.split("\n")) {
+        if (line.trim() === "")
+            continue;
+        const e = parseEdgeLine(line);
+        if (e)
+            out.push(e);
+    }
+    return out;
+}
+/** Builds lookup indices from parsed node/edge text. */
+export function buildGraph(nodesText, edgesText, repoId) {
+    const nodes = parseNodes(nodesText, repoId);
+    const edges = parseEdges(edgesText);
+    const byId = new Map();
+    for (const n of nodes)
+        byId.set(n.id, n);
+    const callsFrom = new Map();
+    const callsTo = new Map();
+    for (const e of edges) {
+        if (e.type !== "CALLS")
+            continue;
+        (callsFrom.get(e.from) ?? callsFrom.set(e.from, []).get(e.from)).push(e);
+        (callsTo.get(e.to) ?? callsTo.set(e.to, []).get(e.to)).push(e);
+    }
+    return { byId, callsFrom, callsTo, nodes, edges };
+}
+/** An empty graph (used when .reposkein files are missing). */
+export function emptyGraph() {
+    return { byId: new Map(), callsFrom: new Map(), callsTo: new Map(), nodes: [], edges: [] };
+}
+const isFunction = (n) => n.labels.includes("Function");
+/** Builds one merged graph from several repos' committed JSONL, then injects
+ *  DB-only-style cross-repo edges (M3 + M4):
+ *  - IMPORTS edges (File→File) from external_import_targets (parity with Neo4j
+ *    stitch_cross_repo_imports).
+ *  - CALLS edges (Function→Function) from external_calls, import-scoped first
+ *    (confidence 0.6) with federation-wide unique fallback (0.5); ambiguous
+ *    skipped. Per-name (mirrors Neo4j stitch_cross_repo_calls). */
+export function buildFederatedGraph(repos) {
+    const byId = new Map();
+    const callsFrom = new Map();
+    const callsTo = new Map();
+    const nodes = [];
+    const edges = [];
+    const pushCall = (e) => {
+        (callsFrom.get(e.from) ?? callsFrom.set(e.from, []).get(e.from)).push(e);
+        (callsTo.get(e.to) ?? callsTo.set(e.to, []).get(e.to)).push(e);
+    };
+    // 1) Parse + merge every repo.
+    for (const r of repos) {
+        const g = buildGraph(r.nodesText, r.edgesText, r.repoId);
+        for (const n of g.nodes) {
+            if (!byId.has(n.id)) {
+                byId.set(n.id, n);
+                nodes.push(n);
+            }
+        }
+        for (const e of g.edges)
+            edges.push(e);
+        for (const [, list] of g.callsFrom)
+            for (const e of list)
+                pushCall(e);
+    }
+    // 2) Cross-repo name index: function name -> [{id, repoId, fileId}] (sorted by id).
+    const byName = new Map();
+    for (const n of nodes) {
+        if (!isFunction(n))
+            continue;
+        const nm = typeof n.props.name === "string" ? n.props.name : null;
+        if (!nm)
+            continue;
+        const fp = typeof n.props.file_path === "string" ? n.props.file_path : "";
+        const fileId = `rs1:${n.repoId}:file:${fp}`;
+        (byName.get(nm) ?? byName.set(nm, []).get(nm)).push({ id: n.id, repoId: n.repoId, fileId });
+    }
+    for (const arr of byName.values())
+        arr.sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+    // File id -> set of external_import_targets (the child Files it imports from).
+    const importTargets = new Map();
+    for (const n of nodes) {
+        const t = n.props.external_import_targets;
+        if (Array.isArray(t)) {
+            importTargets.set(n.id, new Set(t.filter((x) => typeof x === "string")));
+        }
+    }
+    // M3: cross-repo IMPORTS edges (File -> child File) from external_import_targets,
+    // for backend parity with Neo4j's stitch_cross_repo_imports. Added to `edges`
+    // (no dedicated reader yet — the committed property already carries the data).
+    for (const n of nodes) {
+        const targets = n.props.external_import_targets;
+        if (!Array.isArray(targets))
+            continue;
+        for (const t of targets) {
+            if (typeof t === "string" && byId.has(t)) {
+                edges.push({ from: n.id, type: "IMPORTS", to: t, props: { cross_repo: true, stitched: true } });
+            }
+        }
+    }
+    // 3) Inject cross-repo CALLS. Prefer an import-scoped match (the called name
+    //    in a file the caller's file imports from — precise); fall back to a
+    //    federation-wide unique match. Per name; ambiguous skipped.
+    for (const n of nodes) {
+        const ext = n.props.external_calls;
+        if (!Array.isArray(ext))
+            continue;
+        const callerFp = typeof n.props.file_path === "string" ? n.props.file_path : "";
+        const callerFileId = `rs1:${n.repoId}:file:${callerFp}`;
+        const targets = importTargets.get(callerFileId);
+        const names = [...new Set(ext.filter((x) => typeof x === "string"))].sort();
+        for (const name of names) {
+            const all = (byName.get(name) ?? []).filter((m) => m.repoId !== n.repoId);
+            let chosen;
+            let confidence = 0.5;
+            if (targets) {
+                const scoped = all.filter((m) => targets.has(m.fileId));
+                if (scoped.length === 1) {
+                    chosen = scoped[0];
+                    confidence = 0.6; // import-scoped → more precise
+                }
+            }
+            if (!chosen && all.length === 1) {
+                chosen = all[0]; // federation-wide fallback
+            }
+            if (!chosen)
+                continue; // ambiguous / unresolved
+            pushCall({
+                from: n.id,
+                type: "CALLS",
+                to: chosen.id,
+                props: { resolution: "name_match", confidence, cross_repo: true, stitched: true, call_sites: 1 },
+            });
+        }
+    }
+    return { byId, callsFrom, callsTo, nodes, edges };
+}
+//# sourceMappingURL=jsonlGraph.js.map

package/dist/store/jsonlGraph.js.map

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

package/dist/store/repoId.d.ts

@@ -0,0 +1,3 @@
+/** repo_id resolution: REPOSKEIN_REPO_ID env override, else
+ *  <repoPath>/.reposkein/meta.json's repo_id. Returns undefined if neither. */
+export declare function resolveRepoId(repoPath: string | undefined, envRepoId: string | undefined): string | undefined;

package/dist/store/repoId.js

@@ -0,0 +1,18 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+/** repo_id resolution: REPOSKEIN_REPO_ID env override, else
+ *  <repoPath>/.reposkein/meta.json's repo_id. Returns undefined if neither. */
+export function resolveRepoId(repoPath, envRepoId) {
+    if (envRepoId)
+        return envRepoId;
+    if (!repoPath)
+        return undefined;
+    try {
+        const meta = JSON.parse(readFileSync(join(repoPath, ".reposkein", "meta.json"), "utf8"));
+        return typeof meta.repo_id === "string" ? meta.repo_id : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=repoId.js.map

package/dist/store/repoId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repoId.js","sourceRoot":"","sources":["../../src/store/repoId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;+EAC+E;AAC/E,MAAM,UAAU,aAAa,CAAC,QAA4B,EAAE,SAA6B;IACvF,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACzF,OAAO,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/store/sidecar.d.ts

@@ -0,0 +1,16 @@
+/** A persisted summary record (git-ignored .reposkein/local/summaries.jsonl). */
+export interface SidecarSummary {
+    id: string;
+    semantic_summary: string;
+    summary_of_hash: string;
+    summary_model: string;
+    summary_at: string;
+    summary_by: string;
+}
+export declare function sidecarPath(repoPath: string): string;
+/** Reads the sidecar into a map keyed by node id. Missing file → empty map.
+ *  Best-effort: malformed lines / read errors are skipped. */
+export declare function readSidecar(path: string): Map<string, SidecarSummary>;
+/** Upserts one record and rewrites the sidecar sorted by id (deterministic, no
+ *  duplicate lines). Creates the local/ dir if needed. Best-effort. */
+export declare function upsertSidecar(path: string, rec: SidecarSummary): void;

package/dist/store/sidecar.js

@@ -0,0 +1,65 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+export function sidecarPath(repoPath) {
+    return join(repoPath, ".reposkein", "local", "summaries.jsonl");
+}
+/** Reads the sidecar into a map keyed by node id. Missing file → empty map.
+ *  Best-effort: malformed lines / read errors are skipped. */
+export function readSidecar(path) {
+    const map = new Map();
+    if (!existsSync(path))
+        return map;
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch {
+        return map;
+    }
+    for (const line of text.split("\n")) {
+        if (line.trim() === "")
+            continue;
+        try {
+            const o = JSON.parse(line);
+            if (typeof o.id === "string" && typeof o.semantic_summary === "string") {
+                map.set(o.id, {
+                    id: o.id,
+                    semantic_summary: o.semantic_summary,
+                    summary_of_hash: typeof o.summary_of_hash === "string" ? o.summary_of_hash : "",
+                    summary_model: typeof o.summary_model === "string" ? o.summary_model : "",
+                    summary_at: typeof o.summary_at === "string" ? o.summary_at : "",
+                    summary_by: typeof o.summary_by === "string" ? o.summary_by : "",
+                });
+            }
+        }
+        catch {
+            // skip malformed line
+        }
+    }
+    return map;
+}
+/** Upserts one record and rewrites the sidecar sorted by id (deterministic, no
+ *  duplicate lines). Creates the local/ dir if needed. Best-effort. */
+export function upsertSidecar(path, rec) {
+    const map = readSidecar(path);
+    map.set(rec.id, rec);
+    const lines = [...map.keys()].sort().map((id) => {
+        const r = map.get(id);
+        return JSON.stringify({
+            id: r.id,
+            semantic_summary: r.semantic_summary,
+            summary_at: r.summary_at,
+            summary_by: r.summary_by,
+            summary_model: r.summary_model,
+            summary_of_hash: r.summary_of_hash,
+        });
+    });
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, lines.length ? lines.join("\n") + "\n" : "");
+    }
+    catch {
+        // best-effort; a write failure must not break the tool call
+    }
+}
+//# sourceMappingURL=sidecar.js.map

package/dist/store/sidecar.js.map

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

package/dist/tools/getContextProfile.d.ts

@@ -0,0 +1,10 @@
+import type { GraphStore } from "../store/GraphStore.js";
+import type { ToolResult } from "./readCypher.js";
+export interface GetContextProfileArgs {
+    node_id?: string;
+    file_path?: string;
+    name?: string;
+    hops?: number;
+    federated?: boolean;
+}
+export declare function makeGetContextProfile(store: GraphStore, repoId: string): (args: GetContextProfileArgs) => Promise<ToolResult>;

package/dist/tools/getContextProfile.js

@@ -0,0 +1,44 @@
+import { resolveTarget } from "../profile/resolve.js";
+import { assembleProfile } from "../profile/assemble.js";
+import { federationIds } from "../store/federation.js";
+export function makeGetContextProfile(store, repoId) {
+    return async (args) => {
+        const sel = { node_id: args.node_id, file_path: args.file_path, name: args.name };
+        if (!sel.node_id && !sel.name && !sel.file_path) {
+            return {
+                content: [{ type: "text", text: "provide one of: node_id, file_path+name, or name" }],
+                isError: true,
+            };
+        }
+        const hops = args.hops === 2 ? 2 : 1;
+        try {
+            const repoIds = args.federated ? await federationIds(store, repoId) : [repoId];
+            const resolved = await resolveTarget(store, repoIds, sel);
+            if (resolved.kind === "not_found") {
+                return { content: [{ type: "text", text: JSON.stringify({ error: "target not found" }) }], isError: true };
+            }
+            if (resolved.kind === "candidates") {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                ambiguous: true,
+                                candidates: resolved.candidates.map((c) => ({
+                                    id: c.id,
+                                    name: c.qualified_name,
+                                    file_path: c.file_path,
+                                    repo_id: c.repo_id,
+                                })),
+                            }),
+                        }],
+                };
+            }
+            const profile = await assembleProfile(store, repoIds, resolved.target, hops);
+            return { content: [{ type: "text", text: JSON.stringify(profile) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: e.message }], isError: true };
+        }
+    };
+}
+//# sourceMappingURL=getContextProfile.js.map

package/dist/tools/getContextProfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getContextProfile.js","sourceRoot":"","sources":["../../src/tools/getContextProfile.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAiB,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAWvD,MAAM,UAAU,qBAAqB,CAAC,KAAiB,EAAE,MAAc;IACrE,OAAO,KAAK,EAAE,IAA2B,EAAuB,EAAE;QAChE,MAAM,GAAG,GAAa,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5F,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;YAChD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kDAAkD,EAAE,CAAC;gBACrF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAU,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC/E,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;YAC1D,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAClC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC7G,CAAC;YACD,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACnC,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,SAAS,EAAE,IAAI;gCACf,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oCAC1C,EAAE,EAAE,CAAC,CAAC,EAAE;oCACR,IAAI,EAAE,CAAC,CAAC,cAAc;oCACtB,SAAS,EAAE,CAAC,CAAC,SAAS;oCACtB,OAAO,EAAE,CAAC,CAAC,OAAO;iCACnB,CAAC,CAAC;6BACJ,CAAC;yBACH,CAAC;iBACH,CAAC;YACJ,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC7E,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QACxE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAG,CAAW,CAAC,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACpF,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/indexerTools.d.ts

@@ -0,0 +1,27 @@
+import type { ToolResult } from "./readCypher.js";
+export type RunResult = {
+    ok: true;
+    nodes: number;
+    edges: number;
+    files: number;
+    warnings: string[];
+} | {
+    ok: false;
+    error: string;
+};
+export interface RunOpts {
+    verb?: "index" | "reindex";
+    file?: string;
+}
+export interface IndexerDeps {
+    run: (repoId: string, path: string, opts?: RunOpts) => Promise<RunResult>;
+}
+export interface InitArgs {
+    path?: string;
+    full?: boolean;
+}
+export declare function makeInitCpgSkeleton(repoId: string, deps?: Partial<IndexerDeps>): (args: InitArgs) => Promise<ToolResult>;
+export interface ReindexArgs {
+    path: string;
+}
+export declare function makeReindexFile(repoId: string, deps?: Partial<IndexerDeps>): (args: ReindexArgs) => Promise<ToolResult>;

package/dist/tools/indexerTools.js

@@ -0,0 +1,89 @@
+import { spawnIndexer, parseJsonStats, repoPath, shouldLoadNeo4j, } from "../indexer/runIndexer.js";
+import { ensureIndexerBinary } from "../indexer/fetchBinary.js";
+/** Default runner: run the index/reindex verb with --json, then load into Neo4j
+ *  unless we're in JSONL mode (shouldLoadNeo4j() === false). */
+function defaultRun(repoId, indexPath, opts) {
+    const verb = opts?.verb ?? "index";
+    return (async () => {
+        const bin = await ensureIndexerBinary();
+        const verbArgs = verb === "reindex"
+            ? ["reindex", "--json", "--repo-id", repoId, indexPath, ...(opts?.file ? ["--file", opts.file] : [])]
+            : ["index", "--json", "--repo-id", repoId, indexPath];
+        const idx = await spawnIndexer(bin, verbArgs);
+        if (idx.code !== 0)
+            return { ok: false, error: `${verb} failed: ${idx.stderr || idx.stdout}` };
+        const stats = parseJsonStats(idx.stdout);
+        if (!stats)
+            return { ok: false, error: `${verb} --json returned unparseable output: ${idx.stdout}` };
+        if (shouldLoadNeo4j()) {
+            const load = await spawnIndexer(bin, ["load", "--repo-id", repoId, indexPath]);
+            if (load.code !== 0)
+                return { ok: false, error: `load failed: ${load.stderr || load.stdout}` };
+        }
+        return {
+            ok: true,
+            nodes: stats.nodes,
+            edges: stats.edges,
+            files: stats.files,
+            warnings: stats.warnings ?? [],
+        };
+    })();
+}
+function makeRunner(repoId, deps) {
+    const run = deps?.run ?? ((id, path, opts) => defaultRun(id, path, opts));
+    return run;
+}
+export function makeInitCpgSkeleton(repoId, deps) {
+    const run = makeRunner(repoId, deps);
+    return async (args) => {
+        const indexPath = args?.path ?? repoPath();
+        const start = Date.now();
+        const r = await run(repoId, indexPath);
+        if (!r.ok) {
+            return { content: [{ type: "text", text: r.error }], isError: true };
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        ok: true,
+                        nodes: r.nodes,
+                        edges: r.edges,
+                        files: r.files,
+                        duration_ms: Date.now() - start,
+                        warnings: r.warnings,
+                    }),
+                }],
+        };
+    };
+}
+export function makeReindexFile(repoId, deps) {
+    const run = makeRunner(repoId, deps);
+    return async (args) => {
+        if (!args || !args.path) {
+            return { content: [{ type: "text", text: "reindex_file requires a 'path'" }], isError: true };
+        }
+        const indexPath = repoPath();
+        const start = Date.now();
+        const r = await run(repoId, indexPath, { verb: "reindex", file: args.path });
+        if (!r.ok) {
+            return { content: [{ type: "text", text: r.error }], isError: true };
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        ok: true,
+                        reindexed: args.path,
+                        nodes: r.nodes,
+                        edges: r.edges,
+                        files: r.files,
+                        duration_ms: Date.now() - start,
+                        loaded: shouldLoadNeo4j(),
+                        warnings: r.warnings,
+                    }),
+                }],
+        };
+    };
+}
+//# sourceMappingURL=indexerTools.js.map

package/dist/tools/indexerTools.js.map

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

package/dist/tools/readCypher.d.ts

@@ -0,0 +1,16 @@
+import type { GraphStore } from "../store/GraphStore.js";
+export interface ReadCypherArgs {
+    query: string;
+    params?: Record<string, unknown>;
+    federated?: boolean;
+}
+export interface ToolResult {
+    [key: string]: unknown;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: boolean;
+}
+/** Builds the read_cypher handler bound to a store and (optional) repo scope. */
+export declare function makeReadCypher(store: GraphStore, repoId?: string): (args: ReadCypherArgs) => Promise<ToolResult>;

package/dist/tools/readCypher.js

@@ -0,0 +1,40 @@
+import { assertReadOnly } from "../guard/readonly.js";
+import { applyCaps } from "../guard/caps.js";
+import { federationIds } from "../store/federation.js";
+/** Builds the read_cypher handler bound to a store and (optional) repo scope. */
+export function makeReadCypher(store, repoId) {
+    return async (args) => {
+        const { query, params } = args;
+        try {
+            assertReadOnly(query);
+        }
+        catch (e) {
+            return {
+                content: [{ type: "text", text: e.message }],
+                isError: true,
+            };
+        }
+        const merged = { ...(params ?? {}) };
+        if (repoId !== undefined) {
+            merged.repo_id = repoId;
+            merged.repo_ids = args.federated ? await federationIds(store, repoId) : [repoId];
+        }
+        try {
+            const rows = await store.runRead(query, merged, { timeoutMs: 10_000 });
+            const { rows: capped, truncated } = applyCaps(rows);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify({ rows: capped, truncated }) },
+                ],
+            };
+        }
+        catch (e) {
+            // Verbatim Neo4j message so the agent can self-correct (PRD §7.2).
+            return {
+                content: [{ type: "text", text: e.message }],
+                isError: true,
+            };
+        }
+    };
+}
+//# sourceMappingURL=readCypher.js.map

package/dist/tools/readCypher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readCypher.js","sourceRoot":"","sources":["../../src/tools/readCypher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAcvD,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,KAAiB,EAAE,MAAe;IAC/D,OAAO,KAAK,EAAE,IAAoB,EAAuB,EAAE;QACzD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAC/B,IAAI,CAAC;YACH,cAAc,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAG,CAAW,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAA4B,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC;YACxB,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;YACvE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YACpD,OAAO;gBACL,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE;iBACpE;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,mEAAmE;YACnE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAG,CAAW,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/writeSemanticSummary.d.ts

@@ -0,0 +1,8 @@
+import type { GraphStore } from "../store/GraphStore.js";
+import type { ToolResult } from "./readCypher.js";
+export interface WriteSummaryArgs {
+    node_id: string;
+    summary: string;
+    model?: string;
+}
+export declare function makeWriteSemanticSummary(store: GraphStore, repoId: string): (args: WriteSummaryArgs) => Promise<ToolResult>;

package/dist/tools/writeSemanticSummary.js

@@ -0,0 +1,40 @@
+import { sanitizeSummary } from "../guard/summaryValidation.js";
+function today() {
+    // Day-precision ISO date (PRD §6.2.5: no wall-clock timestamps in output).
+    return new Date().toISOString().slice(0, 10);
+}
+export function makeWriteSemanticSummary(store, repoId) {
+    return async (args) => {
+        const v = sanitizeSummary(args.summary);
+        if (!v.ok) {
+            return { content: [{ type: "text", text: v.error }], isError: true };
+        }
+        try {
+            const res = await store.writeSummary(repoId, args.node_id, {
+                summary: v.value,
+                model: args.model ?? "unknown",
+                at: today(),
+                by: process.env.REPOSKEIN_AGENT ?? "agent",
+            });
+            if (res.kind === "not_found") {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({ error: "node not found" }) }],
+                    isError: true,
+                };
+            }
+            if (res.kind === "no_content_hash") {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({ error: "node has no content_hash; not summarizable" }) }],
+                    isError: true,
+                };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify({ ok: true, stale_replaced: res.stale_replaced }) }],
+            };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: e.message }], isError: true };
+        }
+    };
+}
+//# sourceMappingURL=writeSemanticSummary.js.map

package/dist/tools/writeSemanticSummary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeSemanticSummary.js","sourceRoot":"","sources":["../../src/tools/writeSemanticSummary.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAShE,SAAS,KAAK;IACZ,2EAA2E;IAC3E,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAiB,EAAE,MAAc;IACxE,OAAO,KAAK,EAAE,IAAsB,EAAuB,EAAE;QAC3D,MAAM,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACV,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACvE,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE;gBACzD,OAAO,EAAE,CAAC,CAAC,KAAK;gBAChB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,SAAS;gBAC9B,EAAE,EAAE,KAAK,EAAE;gBACX,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO;aAC3C,CAAC,CAAC;YACH,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC7B,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,EAAE,CAAC;oBAC9E,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YACD,IAAI,GAAG,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACnC,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC,EAAE,CAAC;oBAC1G,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC;aACpG,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAG,CAAW,CAAC,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACpF,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}