@reposkein/mcp 0.1.0

package/dist/store/JsonlGraphStore.js

@@ -0,0 +1,275 @@
+import { statSync, readFileSync, existsSync } from "node:fs";
+import { join, resolve, isAbsolute, sep } from "node:path";
+import { CypherUnsupportedError, } from "./GraphStore.js";
+import { buildFederatedGraph, emptyGraph, } from "./jsonlGraph.js";
+import { readSidecar, upsertSidecar, sidecarPath } from "./sidecar.js";
+function str(v) {
+    return typeof v === "string" ? v : null;
+}
+function num(v) {
+    return typeof v === "number" ? v : 0;
+}
+/** Resolves a federated child dir from an untrusted committed root_path,
+ *  rejecting absolute paths, `..`, and anything escaping `base`. */
+function safeChildDir(base, rootPath) {
+    if (isAbsolute(rootPath))
+        return null;
+    if (rootPath.split(/[\\/]/).includes(".."))
+        return null;
+    const baseAbs = resolve(base);
+    const childAbs = resolve(baseAbs, rootPath);
+    if (childAbs === baseAbs || childAbs.startsWith(baseAbs + sep))
+        return childAbs;
+    return null;
+}
+function toTargetRow(n) {
+    const name = str(n.props.name) ?? "";
+    return {
+        id: n.id,
+        repo_id: n.repoId,
+        name,
+        qualified_name: str(n.props.qualified_name) ?? name,
+        file_path: str(n.props.file_path) ?? "",
+        start_line: num(n.props.start_line),
+        end_line: num(n.props.end_line),
+        semantic_summary: str(n.props.semantic_summary),
+        summary_of_hash: str(n.props.summary_of_hash),
+        content_hash: str(n.props.content_hash),
+        labels: n.labels.filter((l) => l !== "Rs"),
+    };
+}
+function toNeighborRow(n, edgeProps) {
+    const row = {
+        id: n.id,
+        repo_id: n.repoId,
+        name: str(n.props.qualified_name) ?? str(n.props.name) ?? "",
+        semantic_summary: str(n.props.semantic_summary),
+        summary_of_hash: str(n.props.summary_of_hash),
+        content_hash: str(n.props.content_hash),
+    };
+    if (edgeProps) {
+        if (typeof edgeProps.resolution === "string")
+            row.resolution = edgeProps.resolution;
+        if (typeof edgeProps.confidence === "number")
+            row.confidence = edgeProps.confidence;
+        if (edgeProps.cross_repo === true)
+            row.cross_repo = true;
+    }
+    return row;
+}
+const hasLabel = (n, l) => n.labels.includes(l);
+/** A GraphStore over a repo's committed .reposkein JSONL.  In single-repo mode
+ *  it loads only the root; in federated mode it also loads nested children
+ *  (guarded, cycle-safe) and merges them into one graph.  All read methods
+ *  scope per-node by repoIds — so non-federated reads (repoIds=[root]) see
+ *  exactly the root (children invisible).
+ *
+ *  Reloads when either ROOT JSONL file's mtime changes (v1: a child-only
+ *  change without a root change won't trigger reload — acceptable).
+ *  writeSummary persists to the durable sidecar (.reposkein/local/summaries.jsonl). */
+export class JsonlGraphStore {
+    repoId;
+    graph = emptyGraph();
+    mtime = -1;
+    repoPath;
+    nodesPath;
+    edgesPath;
+    sidecarFile;
+    constructor(repoPath, repoId) {
+        this.repoId = repoId;
+        this.repoPath = repoPath;
+        const dir = join(repoPath, ".reposkein");
+        this.nodesPath = join(dir, "nodes.jsonl");
+        this.edgesPath = join(dir, "edges.jsonl");
+        this.sidecarFile = sidecarPath(repoPath);
+        this.ensureFresh();
+    }
+    /** Gathers committed JSONL for the root + all transitively federated
+     *  children (guarded, cycle-safe). Each child's repo_id comes from the proxy
+     *  Repository node's federated_repo_id in the parent's nodes.jsonl. */
+    collectRepos() {
+        const repos = [];
+        const seen = new Set();
+        const visit = (dir, repoId) => {
+            if (seen.has(repoId))
+                return;
+            seen.add(repoId);
+            const nodesPath = join(dir, ".reposkein", "nodes.jsonl");
+            const edgesPath = join(dir, ".reposkein", "edges.jsonl");
+            let nodesText = "";
+            let edgesText = "";
+            try {
+                if (existsSync(nodesPath))
+                    nodesText = readFileSync(nodesPath, "utf8");
+                if (existsSync(edgesPath))
+                    edgesText = readFileSync(edgesPath, "utf8");
+            }
+            catch {
+                return;
+            }
+            repos.push({ repoId, nodesText, edgesText });
+            // Discover children from this repo's Repository proxy nodes.
+            for (const line of nodesText.split("\n")) {
+                if (line.trim() === "")
+                    continue;
+                let obj;
+                try {
+                    obj = JSON.parse(line);
+                }
+                catch {
+                    continue;
+                }
+                const labels = Array.isArray(obj.labels) ? obj.labels : [];
+                if (!labels.includes("Repository"))
+                    continue;
+                const fid = obj.federated_repo_id;
+                const rp = obj.root_path;
+                if (typeof fid === "string" && typeof rp === "string" && rp !== ".") {
+                    const childDir = safeChildDir(dir, rp);
+                    if (childDir)
+                        visit(childDir, fid);
+                }
+            }
+        };
+        visit(this.repoPath, this.repoId);
+        return repos;
+    }
+    /** Reloads the graph if either ROOT file's mtime changed since last load. */
+    ensureFresh() {
+        let m = 0;
+        try {
+            if (existsSync(this.nodesPath))
+                m = Math.max(m, statSync(this.nodesPath).mtimeMs);
+            if (existsSync(this.edgesPath))
+                m = Math.max(m, statSync(this.edgesPath).mtimeMs);
+        }
+        catch {
+            m = 0;
+        }
+        if (m === this.mtime)
+            return;
+        this.mtime = m;
+        try {
+            this.graph = buildFederatedGraph(this.collectRepos());
+            // Overlay the ROOT's durable sidecar summaries (child sidecars are their
+            // own concern; v1 overlays the active repo only).
+            for (const [id, rec] of readSidecar(this.sidecarFile)) {
+                const n = this.graph.byId.get(id);
+                if (n) {
+                    n.props.semantic_summary = rec.semantic_summary;
+                    n.props.summary_of_hash = rec.summary_of_hash;
+                    n.props.summary_model = rec.summary_model;
+                    n.props.summary_at = rec.summary_at;
+                    n.props.summary_by = rec.summary_by;
+                }
+            }
+        }
+        catch {
+            this.graph = emptyGraph();
+        }
+    }
+    async getNode(repoIds, id) {
+        this.ensureFresh();
+        const n = this.graph.byId.get(id);
+        return n && repoIds.includes(n.repoId) ? toTargetRow(n) : null;
+    }
+    async resolveByPathAndName(repoIds, filePath, name) {
+        this.ensureFresh();
+        return this.graph.nodes
+            .filter((n) => repoIds.includes(n.repoId) &&
+            str(n.props.file_path) === filePath &&
+            (hasLabel(n, "Function") || hasLabel(n, "Class")) &&
+            (str(n.props.name) === name || str(n.props.qualified_name) === name))
+            .map(toTargetRow);
+    }
+    async resolveByName(repoIds, name) {
+        this.ensureFresh();
+        return this.graph.nodes
+            .filter((n) => repoIds.includes(n.repoId) && hasLabel(n, "Function") && str(n.props.name) === name)
+            .map(toTargetRow);
+    }
+    async callers(repoIds, id, limit) {
+        this.ensureFresh();
+        const rows = [];
+        for (const e of this.graph.callsTo.get(id) ?? []) {
+            const x = this.graph.byId.get(e.from);
+            if (x && hasLabel(x, "Function") && repoIds.includes(x.repoId))
+                rows.push(toNeighborRow(x, e.props));
+        }
+        rows.sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+        return rows.slice(0, limit);
+    }
+    async callees(repoIds, id, limit) {
+        this.ensureFresh();
+        const rows = [];
+        for (const e of this.graph.callsFrom.get(id) ?? []) {
+            const x = this.graph.byId.get(e.to);
+            if (x && hasLabel(x, "Function") && repoIds.includes(x.repoId))
+                rows.push(toNeighborRow(x, e.props));
+        }
+        rows.sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+        return rows.slice(0, limit);
+    }
+    async calleesAt2Hops(repoIds, id, limit) {
+        this.ensureFresh();
+        const seen = new Map();
+        for (const e1 of this.graph.callsFrom.get(id) ?? []) {
+            for (const e2 of this.graph.callsFrom.get(e1.to) ?? []) {
+                const x = this.graph.byId.get(e2.to);
+                if (x && hasLabel(x, "Function") && repoIds.includes(x.repoId) && !seen.has(x.id)) {
+                    seen.set(x.id, toNeighborRow(x));
+                }
+            }
+        }
+        return [...seen.values()].sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)).slice(0, limit);
+    }
+    async writeSummary(repoId, id, fields) {
+        this.ensureFresh();
+        if (repoId !== this.repoId)
+            return { kind: "not_found" };
+        const n = this.graph.byId.get(id);
+        if (!n || n.repoId !== this.repoId)
+            return { kind: "not_found" };
+        const chash = str(n.props.content_hash);
+        if (chash === null)
+            return { kind: "no_content_hash" };
+        const oldSummary = str(n.props.semantic_summary);
+        const oldHash = str(n.props.summary_of_hash);
+        const stale_replaced = oldSummary !== null && oldHash !== chash;
+        n.props.semantic_summary = fields.summary;
+        n.props.summary_of_hash = chash;
+        n.props.summary_model = fields.model;
+        n.props.summary_at = fields.at;
+        n.props.summary_by = fields.by;
+        upsertSidecar(this.sidecarFile, {
+            id,
+            semantic_summary: fields.summary,
+            summary_of_hash: chash,
+            summary_model: fields.model,
+            summary_at: fields.at,
+            summary_by: fields.by,
+        });
+        return { kind: "ok", stale_replaced };
+    }
+    async federatedRepoIds(repoId) {
+        this.ensureFresh();
+        if (repoId !== this.repoId)
+            return [];
+        const ids = [];
+        for (const n of this.graph.nodes) {
+            if (n.repoId === this.repoId && hasLabel(n, "Repository")) {
+                const fid = str(n.props.federated_repo_id);
+                if (fid)
+                    ids.push(fid);
+            }
+        }
+        return ids;
+    }
+    async runRead() {
+        throw new CypherUnsupportedError();
+    }
+    async close() {
+        // nothing to close
+    }
+}
+//# sourceMappingURL=JsonlGraphStore.js.map

package/dist/store/JsonlGraphStore.js.map

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

package/dist/store/Neo4jGraphStore.d.ts

@@ -0,0 +1,27 @@
+import type { GraphStore, NeighborRow, SummaryFields, WriteSummaryResult } from "./GraphStore.js";
+import type { TargetRow } from "../profile/types.js";
+export declare class Neo4jGraphStore implements GraphStore {
+    private driver;
+    constructor(uri: string, user: string, password: string);
+    /** Connect using env: NEO4J_URI / NEO4J_USER / NEO4J_PASSWORD. */
+    static fromEnv(): Neo4jGraphStore;
+    private static TARGET_RETURN;
+    private static NEIGHBOR_RETURN;
+    private static toTargetRow;
+    private static toNeighborRow;
+    getNode(repoIds: string[], id: string): Promise<TargetRow | null>;
+    resolveByPathAndName(repoIds: string[], filePath: string, name: string): Promise<TargetRow[]>;
+    resolveByName(repoIds: string[], name: string): Promise<TargetRow[]>;
+    callers(repoIds: string[], id: string, limit: number): Promise<NeighborRow[]>;
+    callees(repoIds: string[], id: string, limit: number): Promise<NeighborRow[]>;
+    calleesAt2Hops(repoIds: string[], id: string, limit: number): Promise<NeighborRow[]>;
+    writeSummary(repoId: string, id: string, fields: SummaryFields): Promise<WriteSummaryResult>;
+    federatedRepoIds(repoId: string): Promise<string[]>;
+    runRead(query: string, params?: Record<string, unknown>, opts?: {
+        timeoutMs?: number;
+    }): Promise<Record<string, unknown>[]>;
+    runWrite(query: string, params?: Record<string, unknown>, opts?: {
+        timeoutMs?: number;
+    }): Promise<Record<string, unknown>[]>;
+    close(): Promise<void>;
+}

package/dist/store/Neo4jGraphStore.js

@@ -0,0 +1,148 @@
+import neo4j from "neo4j-driver";
+export class Neo4jGraphStore {
+    driver;
+    constructor(uri, user, password) {
+        this.driver = neo4j.driver(uri, neo4j.auth.basic(user, password), {
+            disableLosslessIntegers: true,
+        });
+    }
+    /** Connect using env: NEO4J_URI / NEO4J_USER / NEO4J_PASSWORD. */
+    static fromEnv() {
+        const uri = process.env.NEO4J_URI ?? "neo4j://localhost:7687";
+        const user = process.env.NEO4J_USER ?? "neo4j";
+        const password = process.env.NEO4J_PASSWORD;
+        if (!password)
+            throw new Error("NEO4J_PASSWORD must be set");
+        return new Neo4jGraphStore(uri, user, password);
+    }
+    // Projection for a resolved target node (was resolve.ts TARGET_RETURN).
+    static TARGET_RETURN = "t.id AS id, t.name AS name, t.qualified_name AS qualified_name, t.file_path AS file_path, " +
+        "t.start_line AS start_line, t.end_line AS end_line, t.semantic_summary AS semantic_summary, " +
+        "t.summary_of_hash AS summary_of_hash, t.content_hash AS content_hash, " +
+        "[l IN labels(t) WHERE l <> 'Rs'] AS labels, t.repo_id AS repo_id";
+    // Projection for a neighbor node (was assemble.ts NEIGHBOR_RETURN). Caller
+    // prefixes `x.id ` and may append edge props.
+    static NEIGHBOR_RETURN = "AS id, x.qualified_name AS name, x.semantic_summary AS semantic_summary, " +
+        "x.summary_of_hash AS summary_of_hash, x.content_hash AS content_hash, x.repo_id AS repo_id";
+    static toTargetRow(r) {
+        return {
+            id: r.id,
+            repo_id: r.repo_id ?? "",
+            name: r.name,
+            qualified_name: r.qualified_name ?? r.name,
+            file_path: r.file_path ?? "",
+            start_line: r.start_line ?? 0,
+            end_line: r.end_line ?? 0,
+            semantic_summary: r.semantic_summary ?? null,
+            summary_of_hash: r.summary_of_hash ?? null,
+            content_hash: r.content_hash ?? null,
+            labels: r.labels ?? [],
+        };
+    }
+    static toNeighborRow(r) {
+        const row = {
+            id: r.id,
+            name: r.name ?? "",
+            semantic_summary: r.semantic_summary ?? null,
+            summary_of_hash: r.summary_of_hash ?? null,
+            content_hash: r.content_hash ?? null,
+        };
+        if (r.resolution !== undefined && r.resolution !== null)
+            row.resolution = r.resolution;
+        if (r.confidence !== undefined && r.confidence !== null)
+            row.confidence = r.confidence;
+        if (typeof r.repo_id === "string")
+            row.repo_id = r.repo_id;
+        if (r.cross_repo === true)
+            row.cross_repo = true;
+        return row;
+    }
+    async getNode(repoIds, id) {
+        const rows = await this.runRead(`MATCH (t:Rs {id:$id}) WHERE t.repo_id IN $repo_ids RETURN ${Neo4jGraphStore.TARGET_RETURN}`, { id, repo_ids: repoIds });
+        return rows.length === 1 ? Neo4jGraphStore.toTargetRow(rows[0]) : null;
+    }
+    async resolveByPathAndName(repoIds, filePath, name) {
+        const rows = await this.runRead(`MATCH (t:Rs {file_path:$path}) ` +
+            `WHERE t.repo_id IN $repo_ids AND (t.name = $name OR t.qualified_name = $name) AND (t:Function OR t:Class) ` +
+            `RETURN ${Neo4jGraphStore.TARGET_RETURN}`, { repo_ids: repoIds, path: filePath, name });
+        return rows.map(Neo4jGraphStore.toTargetRow);
+    }
+    async resolveByName(repoIds, name) {
+        const rows = await this.runRead(`MATCH (t:Function {name:$name}) WHERE t.repo_id IN $repo_ids RETURN ${Neo4jGraphStore.TARGET_RETURN}`, { repo_ids: repoIds, name });
+        return rows.map(Neo4jGraphStore.toTargetRow);
+    }
+    async callers(repoIds, id, limit) {
+        const rows = await this.runRead(`MATCH (x:Function)-[r:CALLS]->(t:Rs {id:$id}) WHERE x.repo_id IN $repo_ids ` +
+            `RETURN x.id ${Neo4jGraphStore.NEIGHBOR_RETURN}, r.resolution AS resolution, r.confidence AS confidence, r.cross_repo AS cross_repo ` +
+            `ORDER BY x.id LIMIT $limit`, { id, repo_ids: repoIds, limit: neo4j.int(limit) });
+        return rows.map(Neo4jGraphStore.toNeighborRow);
+    }
+    async callees(repoIds, id, limit) {
+        const rows = await this.runRead(`MATCH (t:Rs {id:$id})-[r:CALLS]->(x:Function) WHERE x.repo_id IN $repo_ids ` +
+            `RETURN x.id ${Neo4jGraphStore.NEIGHBOR_RETURN}, r.resolution AS resolution, r.confidence AS confidence, r.cross_repo AS cross_repo ` +
+            `ORDER BY x.id LIMIT $limit`, { id, repo_ids: repoIds, limit: neo4j.int(limit) });
+        return rows.map(Neo4jGraphStore.toNeighborRow);
+    }
+    async calleesAt2Hops(repoIds, id, limit) {
+        const rows = await this.runRead(`MATCH (t:Rs {id:$id})-[:CALLS*2..2]->(x:Function) WHERE x.repo_id IN $repo_ids ` +
+            `RETURN DISTINCT x.id ${Neo4jGraphStore.NEIGHBOR_RETURN} ` +
+            `ORDER BY x.id LIMIT $limit`, { id, repo_ids: repoIds, limit: neo4j.int(limit) });
+        return rows.map(Neo4jGraphStore.toNeighborRow);
+    }
+    async writeSummary(repoId, id, fields) {
+        const rows = await this.runRead("MATCH (n:Rs {id:$id, repo_id:$repo}) " +
+            "RETURN n.content_hash AS chash, n.semantic_summary AS old, n.summary_of_hash AS oldhash", { id, repo: repoId });
+        if (rows.length === 0)
+            return { kind: "not_found" };
+        const row = rows[0];
+        if (row.chash === null || row.chash === undefined) {
+            return { kind: "no_content_hash" };
+        }
+        const stale_replaced = row.old != null && (row.oldhash ?? null) !== (row.chash ?? null);
+        await this.runWrite("MATCH (n:Rs {id:$id, repo_id:$repo}) " +
+            "SET n.semantic_summary=$s, n.summary_of_hash=n.content_hash, " +
+            "n.summary_model=$m, n.summary_at=$at, n.summary_by=$by", { id, repo: repoId, s: fields.summary, m: fields.model, at: fields.at, by: fields.by });
+        return { kind: "ok", stale_replaced };
+    }
+    async federatedRepoIds(repoId) {
+        const rows = await this.runRead("MATCH (r:Repository {repo_id: $repo_id, root_path: '.'})-[:FEDERATES_TO*1..8]->(x:Repository) " +
+            "WHERE x.federated_repo_id IS NOT NULL RETURN DISTINCT x.federated_repo_id AS id", { repo_id: repoId }, { timeoutMs: 5000 });
+        const ids = [];
+        for (const r of rows)
+            if (typeof r.id === "string")
+                ids.push(r.id);
+        return ids;
+    }
+    async runRead(query, params = {}, opts = {}) {
+        const session = this.driver.session({
+            defaultAccessMode: neo4j.session.READ,
+        });
+        try {
+            const result = await session.run(query, params, {
+                timeout: opts.timeoutMs ?? 10_000,
+            });
+            return result.records.map((r) => r.toObject());
+        }
+        finally {
+            await session.close();
+        }
+    }
+    async runWrite(query, params = {}, opts = {}) {
+        const session = this.driver.session({
+            defaultAccessMode: neo4j.session.WRITE,
+        });
+        try {
+            const result = await session.run(query, params, {
+                timeout: opts.timeoutMs ?? 10_000,
+            });
+            return result.records.map((r) => r.toObject());
+        }
+        finally {
+            await session.close();
+        }
+    }
+    async close() {
+        await this.driver.close();
+    }
+}
+//# sourceMappingURL=Neo4jGraphStore.js.map

package/dist/store/Neo4jGraphStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Neo4jGraphStore.js","sourceRoot":"","sources":["../../src/store/Neo4jGraphStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAsB,MAAM,cAAc,CAAC;AASlD,MAAM,OAAO,eAAe;IAClB,MAAM,CAAS;IAEvB,YAAY,GAAW,EAAE,IAAY,EAAE,QAAgB;QACrD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE;YAChE,uBAAuB,EAAE,IAAI;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,kEAAkE;IAClE,MAAM,CAAC,OAAO;QACZ,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,wBAAwB,CAAC;QAC9D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC;QAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAC5C,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC7D,OAAO,IAAI,eAAe,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,wEAAwE;IAChE,MAAM,CAAC,aAAa,GAC1B,4FAA4F;QAC5F,8FAA8F;QAC9F,wEAAwE;QACxE,kEAAkE,CAAC;IAErE,2EAA2E;IAC3E,8CAA8C;IACtC,MAAM,CAAC,eAAe,GAC5B,2EAA2E;QAC3E,4FAA4F,CAAC;IAEvF,MAAM,CAAC,WAAW,CAAC,CAA0B;QACnD,OAAO;YACL,EAAE,EAAE,CAAC,CAAC,EAAY;YAClB,OAAO,EAAG,CAAC,CAAC,OAAkB,IAAI,EAAE;YACpC,IAAI,EAAE,CAAC,CAAC,IAAc;YACtB,cAAc,EAAG,CAAC,CAAC,cAAyB,IAAK,CAAC,CAAC,IAAe;YAClE,SAAS,EAAG,CAAC,CAAC,SAAoB,IAAI,EAAE;YACxC,UAAU,EAAG,CAAC,CAAC,UAAqB,IAAI,CAAC;YACzC,QAAQ,EAAG,CAAC,CAAC,QAAmB,IAAI,CAAC;YACrC,gBAAgB,EAAG,CAAC,CAAC,gBAA2B,IAAI,IAAI;YACxD,eAAe,EAAG,CAAC,CAAC,eAA0B,IAAI,IAAI;YACtD,YAAY,EAAG,CAAC,CAAC,YAAuB,IAAI,IAAI;YAChD,MAAM,EAAG,CAAC,CAAC,MAAmB,IAAI,EAAE;SACrC,CAAC;IACJ,CAAC;IAEO,MAAM,CAAC,aAAa,CAAC,CAA0B;QACrD,MAAM,GAAG,GAAgB;YACvB,EAAE,EAAE,CAAC,CAAC,EAAY;YAClB,IAAI,EAAG,CAAC,CAAC,IAAe,IAAI,EAAE;YAC9B,gBAAgB,EAAG,CAAC,CAAC,gBAA2B,IAAI,IAAI;YACxD,eAAe,EAAG,CAAC,CAAC,eAA0B,IAAI,IAAI;YACtD,YAAY,EAAG,CAAC,CAAC,YAAuB,IAAI,IAAI;SACjD,CAAC;QACF,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,IAAI;YACrD,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,UAAoB,CAAC;QAC1C,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,IAAI;YACrD,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,UAAoB,CAAC;QAC1C,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;YAAE,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;QAC3D,IAAI,CAAC,CAAC,UAAU,KAAK,IAAI;YAAE,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC;QACjD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAiB,EAAE,EAAU;QACzC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,6DAA6D,eAAe,CAAC,aAAa,EAAE,EAC5F,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAC1B,CAAC;QACF,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,oBAAoB,CACxB,OAAiB,EACjB,QAAgB,EAChB,IAAY;QAEZ,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,iCAAiC;YAC/B,4GAA4G;YAC5G,UAAU,eAAe,CAAC,aAAa,EAAE,EAC3C,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAC5C,CAAC;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAiB,EAAE,IAAY;QACjD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,uEAAuE,eAAe,CAAC,aAAa,EAAE,EACtG,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAC5B,CAAC;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAiB,EAAE,EAAU,EAAE,KAAa;QACxD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,6EAA6E;YAC3E,eAAe,eAAe,CAAC,eAAe,uFAAuF;YACrI,4BAA4B,EAC9B,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CACnD,CAAC;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAiB,EAAE,EAAU,EAAE,KAAa;QACxD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,6EAA6E;YAC3E,eAAe,eAAe,CAAC,eAAe,uFAAuF;YACrI,4BAA4B,EAC9B,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CACnD,CAAC;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAiB,EAAE,EAAU,EAAE,KAAa;QAC/D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,iFAAiF;YAC/E,wBAAwB,eAAe,CAAC,eAAe,GAAG;YAC1D,4BAA4B,EAC9B,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CACnD,CAAC;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,MAAc,EACd,EAAU,EACV,MAAqB;QAErB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,uCAAuC;YACrC,yFAAyF,EAC3F,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CACrB,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACrB,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAClD,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;QACrC,CAAC;QACD,MAAM,cAAc,GAClB,GAAG,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;QACnE,MAAM,IAAI,CAAC,QAAQ,CACjB,uCAAuC;YACrC,+DAA+D;YAC/D,wDAAwD,EAC1D,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CACvF,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,MAAc;QACnC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,gGAAgG;YAC9F,iFAAiF,EACnF,EAAE,OAAO,EAAE,MAAM,EAAE,EACnB,EAAE,SAAS,EAAE,IAAI,EAAE,CACpB,CAAC;QACF,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,IAAI;YAAE,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ;gBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACnE,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,OAAO,CACX,KAAa,EACb,SAAkC,EAAE,EACpC,OAA+B,EAAE;QAEjC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YAClC,iBAAiB,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI;SACtC,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE;gBAC9C,OAAO,EAAE,IAAI,CAAC,SAAS,IAAI,MAAM;aAClC,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAA6B,CAAC,CAAC;QAC5E,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,KAAa,EACb,SAAkC,EAAE,EACpC,OAA+B,EAAE;QAEjC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YAClC,iBAAiB,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK;SACvC,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE;gBAC9C,OAAO,EAAE,IAAI,CAAC,SAAS,IAAI,MAAM;aAClC,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAA6B,CAAC,CAAC;QAC5E,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC"}

package/dist/store/UnconfiguredStore.d.ts

@@ -0,0 +1,16 @@
+import type { GraphStore, NeighborRow, SummaryFields, WriteSummaryResult } from "./GraphStore.js";
+import type { TargetRow } from "../profile/types.js";
+/** A no-op store used when NEO4J_PASSWORD is absent.
+ *  All operations reject with an instructive error. */
+export declare class UnconfiguredStore implements GraphStore {
+    getNode(_repoIds: string[], _id: string): Promise<TargetRow | null>;
+    resolveByPathAndName(): Promise<TargetRow[]>;
+    resolveByName(): Promise<TargetRow[]>;
+    callers(): Promise<NeighborRow[]>;
+    callees(): Promise<NeighborRow[]>;
+    calleesAt2Hops(): Promise<NeighborRow[]>;
+    writeSummary(_repoId: string, _id: string, _fields: SummaryFields): Promise<WriteSummaryResult>;
+    federatedRepoIds(): Promise<string[]>;
+    runRead(): Promise<Record<string, unknown>[]>;
+    close(): Promise<void>;
+}

package/dist/store/UnconfiguredStore.js

@@ -0,0 +1,36 @@
+const MSG = "Neo4j not configured: set NEO4J_PASSWORD and run `docker compose up` in indexer/";
+/** A no-op store used when NEO4J_PASSWORD is absent.
+ *  All operations reject with an instructive error. */
+export class UnconfiguredStore {
+    async getNode(_repoIds, _id) {
+        throw new Error(MSG);
+    }
+    async resolveByPathAndName() {
+        throw new Error(MSG);
+    }
+    async resolveByName() {
+        throw new Error(MSG);
+    }
+    async callers() {
+        throw new Error(MSG);
+    }
+    async callees() {
+        throw new Error(MSG);
+    }
+    async calleesAt2Hops() {
+        throw new Error(MSG);
+    }
+    async writeSummary(_repoId, _id, _fields) {
+        throw new Error(MSG);
+    }
+    async federatedRepoIds() {
+        throw new Error(MSG);
+    }
+    async runRead() {
+        throw new Error(MSG);
+    }
+    async close() {
+        // nothing to close
+    }
+}
+//# sourceMappingURL=UnconfiguredStore.js.map

package/dist/store/UnconfiguredStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnconfiguredStore.js","sourceRoot":"","sources":["../../src/store/UnconfiguredStore.ts"],"names":[],"mappings":"AAQA,MAAM,GAAG,GACP,kFAAkF,CAAC;AAErF;uDACuD;AACvD,MAAM,OAAO,iBAAiB;IAC5B,KAAK,CAAC,OAAO,CAAC,QAAkB,EAAE,GAAW;QAC3C,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,KAAK,CAAC,oBAAoB;QACxB,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,KAAK,CAAC,aAAa;QACjB,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,KAAK,CAAC,cAAc;QAClB,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,KAAK,CAAC,YAAY,CAChB,OAAe,EACf,GAAW,EACX,OAAsB;QAEtB,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,KAAK,CAAC,gBAAgB;QACpB,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,KAAK,CAAC,KAAK;QACT,mBAAmB;IACrB,CAAC;CACF"}

package/dist/store/federation.d.ts

@@ -0,0 +1,9 @@
+import type { GraphStore } from "./GraphStore.js";
+/** The active repo_id plus all transitively federated repo_ids (sorted, deduped).
+ *  Direct children resolve via committed root→proxy edges; grandchildren via the
+ *  stitch edges created at load. Cached ~30s per repo. */
+export declare function federationIds(store: GraphStore, repoId: string): Promise<string[]>;
+/** Clears the federation cache. Exported for test isolation (the cache is a
+ *  process-global with a 30s TTL; functionally fine for the single-store MCP
+ *  server, but tests that reuse a repo_id within the window need a reset). */
+export declare function clearFederationCache(): void;

package/dist/store/federation.js

@@ -0,0 +1,29 @@
+const TTL_MS = 30_000;
+const cache = new Map();
+/** The active repo_id plus all transitively federated repo_ids (sorted, deduped).
+ *  Direct children resolve via committed root→proxy edges; grandchildren via the
+ *  stitch edges created at load. Cached ~30s per repo. */
+export async function federationIds(store, repoId) {
+    const hit = cache.get(repoId);
+    if (hit && Date.now() - hit.at < TTL_MS)
+        return hit.ids;
+    let ids = new Set([repoId]);
+    try {
+        for (const id of await store.federatedRepoIds(repoId))
+            ids.add(id);
+    }
+    catch {
+        // Degrade to the single repo on any error (never break a read).
+        ids = new Set([repoId]);
+    }
+    const sorted = [...ids].sort();
+    cache.set(repoId, { ids: sorted, at: Date.now() });
+    return sorted;
+}
+/** Clears the federation cache. Exported for test isolation (the cache is a
+ *  process-global with a 30s TTL; functionally fine for the single-store MCP
+ *  server, but tests that reuse a repo_id within the window need a reset). */
+export function clearFederationCache() {
+    cache.clear();
+}
+//# sourceMappingURL=federation.js.map

package/dist/store/federation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation.js","sourceRoot":"","sources":["../../src/store/federation.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAG,MAAM,CAAC;AACtB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyC,CAAC;AAE/D;;0DAE0D;AAC1D,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAiB,EAAE,MAAc;IACnE,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,EAAE,GAAG,MAAM;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC;IACxD,IAAI,GAAG,GAAG,IAAI,GAAG,CAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,KAAK,MAAM,EAAE,IAAI,MAAM,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,gEAAgE;QAChE,GAAG,GAAG,IAAI,GAAG,CAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/B,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;8EAE8E;AAC9E,MAAM,UAAU,oBAAoB;IAClC,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/store/jsonlGraph.d.ts

@@ -0,0 +1,43 @@
+/** 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). */
+export interface ParsedNode {
+    id: string;
+    repoId: string;
+    labels: string[];
+    props: Record<string, unknown>;
+}
+export interface ParsedEdge {
+    from: string;
+    type: string;
+    to: string;
+    props: Record<string, unknown>;
+}
+export interface ParsedGraph {
+    byId: Map<string, ParsedNode>;
+    /** CALLS edges only, grouped by source id. */
+    callsFrom: Map<string, ParsedEdge[]>;
+    /** CALLS edges only, grouped by target id. */
+    callsTo: Map<string, ParsedEdge[]>;
+    nodes: ParsedNode[];
+    edges: ParsedEdge[];
+}
+export declare function parseNodes(text: string, repoId: string): ParsedNode[];
+export declare function parseEdges(text: string): ParsedEdge[];
+/** Builds lookup indices from parsed node/edge text. */
+export declare function buildGraph(nodesText: string, edgesText: string, repoId: string): ParsedGraph;
+/** An empty graph (used when .reposkein files are missing). */
+export declare function emptyGraph(): ParsedGraph;
+export interface RepoSource {
+    repoId: string;
+    nodesText: string;
+    edgesText: string;
+}
+/** 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 declare function buildFederatedGraph(repos: RepoSource[]): ParsedGraph;