@reposkein/mcp 0.1.0

package/dist/indexer/fetchBinary.js.map

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

package/dist/indexer/runIndexer.d.ts

@@ -0,0 +1,26 @@
+export interface SpawnResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+/** Path to the indexer binary: REPOSKEIN_INDEXER_BIN or `reposkein-indexer`.
+ * @deprecated Superseded by ensureIndexerBinary() in fetchBinary.ts (M4-D1).
+ *             Kept for back-compat; prefer ensureIndexerBinary() in new code. */
+export declare function indexerBinPath(): string;
+/** Repo root the indexer operates on: REPOSKEIN_REPO_PATH or cwd. */
+export declare function repoPath(): string;
+export declare function spawnIndexer(bin: string, args: string[]): Promise<SpawnResult>;
+export interface IndexJsonStats {
+    repo_id: string;
+    files: number;
+    nodes: number;
+    edges: number;
+    children: number;
+    warnings: string[];
+}
+/** Parse the JSON object emitted by `index --json`. Returns null on parse failure. */
+export declare function parseJsonStats(stdout: string): IndexJsonStats | null;
+/** Whether to load the indexed graph into Neo4j after (re)indexing.
+ *  False in explicit jsonl mode, or in auto mode without NEO4J_PASSWORD
+ *  (zero-infra). True for neo4j mode or auto-with-DB. */
+export declare function shouldLoadNeo4j(): boolean;

package/dist/indexer/runIndexer.js

@@ -0,0 +1,42 @@
+import { spawn } from "node:child_process";
+/** Path to the indexer binary: REPOSKEIN_INDEXER_BIN or `reposkein-indexer`.
+ * @deprecated Superseded by ensureIndexerBinary() in fetchBinary.ts (M4-D1).
+ *             Kept for back-compat; prefer ensureIndexerBinary() in new code. */
+export function indexerBinPath() {
+    return process.env.REPOSKEIN_INDEXER_BIN ?? "reposkein-indexer";
+}
+/** Repo root the indexer operates on: REPOSKEIN_REPO_PATH or cwd. */
+export function repoPath() {
+    return process.env.REPOSKEIN_REPO_PATH ?? process.cwd();
+}
+export function spawnIndexer(bin, args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(bin, args, { env: process.env });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (d) => (stdout += d.toString()));
+        child.stderr.on("data", (d) => (stderr += d.toString()));
+        child.on("error", reject);
+        child.on("close", (code) => resolve({ code: code ?? -1, stdout, stderr }));
+    });
+}
+/** Parse the JSON object emitted by `index --json`. Returns null on parse failure. */
+export function parseJsonStats(stdout) {
+    try {
+        const parsed = JSON.parse(stdout.trim());
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/** Whether to load the indexed graph into Neo4j after (re)indexing.
+ *  False in explicit jsonl mode, or in auto mode without NEO4J_PASSWORD
+ *  (zero-infra). True for neo4j mode or auto-with-DB. */
+export function shouldLoadNeo4j() {
+    const mode = (process.env.REPOSKEIN_STORE ?? "auto").toLowerCase();
+    if (mode === "jsonl")
+        return false;
+    return !!process.env.NEO4J_PASSWORD;
+}
+//# sourceMappingURL=runIndexer.js.map

package/dist/indexer/runIndexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runIndexer.js","sourceRoot":"","sources":["../../src/indexer/runIndexer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAQ3C;;iFAEiF;AACjF,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,mBAAmB,CAAC;AAClE,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,QAAQ;IACtB,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,IAAc;IACtD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACrD,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACzD,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACzD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACL,CAAC;AAWD,sFAAsF;AACtF,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACzC,OAAO,MAAwB,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;yDAEyD;AACzD,MAAM,UAAU,eAAe;IAC7B,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IACnE,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;AACtC,CAAC"}

package/dist/profile/assemble.d.ts

@@ -0,0 +1,5 @@
+import type { GraphStore } from "../store/GraphStore.js";
+import type { ContextProfile, TargetRow } from "./types.js";
+/** Builds the full context profile for an already-resolved target. Hops is
+ *  hard-capped at 2 (PRD §10.1). */
+export declare function assembleProfile(store: GraphStore, repos: string | string[], target: TargetRow, hops: 1 | 2): Promise<ContextProfile>;

package/dist/profile/assemble.js

@@ -0,0 +1,90 @@
+import { summaryState } from "./summary.js";
+import { buildInlinedContext } from "./inline.js";
+function neighborFromRow(r, distance) {
+    const st = summaryState({
+        semantic_summary: r.semantic_summary,
+        summary_of_hash: r.summary_of_hash,
+        content_hash: r.content_hash,
+    });
+    const entry = {
+        id: r.id,
+        name: r.name ?? "",
+        summary: st.summary,
+        stale: st.stale,
+        needs_enrichment: st.needsEnrichment,
+        distance,
+    };
+    if (r.resolution !== undefined)
+        entry.resolution = r.resolution;
+    if (r.confidence !== undefined)
+        entry.confidence = r.confidence;
+    if (r.repo_id !== undefined)
+        entry.repo_id = r.repo_id;
+    if (r.cross_repo)
+        entry.cross_repo = true;
+    return entry;
+}
+const MAX_NEIGHBORS = 25;
+/** Builds the full context profile for an already-resolved target. Hops is
+ *  hard-capped at 2 (PRD §10.1). */
+export async function assembleProfile(store, repos, target, hops) {
+    const repoIds = Array.isArray(repos) ? repos : [repos];
+    const id = target.id;
+    // Upstream: direct callers — fetch one extra to detect truncation.
+    const upRows = await store.callers(repoIds, id, MAX_NEIGHBORS + 1);
+    const upstreamRaw = upRows.map((r) => neighborFromRow(r, 1));
+    const upstreamTruncated = upstreamRaw.length > MAX_NEIGHBORS;
+    const upstream = upstreamRaw.slice(0, MAX_NEIGHBORS);
+    // Downstream: direct callees (distance 1, with edge props).
+    const downRows = await store.callees(repoIds, id, MAX_NEIGHBORS + 1);
+    const downstreamRaw = downRows.map((r) => neighborFromRow(r, 1));
+    let downstreamTruncated = downstreamRaw.length > MAX_NEIGHBORS;
+    const downstream = downstreamRaw.slice(0, MAX_NEIGHBORS);
+    if (hops === 2) {
+        const seen = new Set(downstream.map((d) => d.id));
+        seen.add(id);
+        const d2 = await store.calleesAt2Hops(repoIds, id, MAX_NEIGHBORS + 1);
+        for (const r of d2) {
+            const e = neighborFromRow(r, 2);
+            if (!seen.has(e.id)) {
+                if (downstream.length >= MAX_NEIGHBORS) {
+                    downstreamTruncated = true;
+                    break;
+                }
+                downstream.push(e);
+                seen.add(e.id);
+            }
+        }
+    }
+    const tState = summaryState(target);
+    const profTarget = {
+        id: target.id,
+        name: target.qualified_name,
+        file_path: target.file_path,
+        lines: [target.start_line, target.end_line],
+        summary: tState.summary,
+        stale: tState.stale,
+        repo_id: target.repo_id,
+    };
+    const enrichment_needed = [
+        ...(tState.needsEnrichment ? [target.id] : []),
+        ...downstream.filter((d) => d.needs_enrichment).map((d) => d.id),
+    ];
+    let inlined = buildInlinedContext(profTarget, upstream, downstream);
+    if (upstreamTruncated) {
+        const extra = upstreamRaw.length - MAX_NEIGHBORS;
+        inlined += ` (+${extra} more callers not shown — query read_cypher for the full set.)`;
+    }
+    if (downstreamTruncated) {
+        inlined += ` (downstream list truncated — query read_cypher for the full set.)`;
+    }
+    return {
+        target: profTarget,
+        upstream,
+        downstream,
+        inlined_context: inlined,
+        enrichment_needed,
+        truncated: { upstream: upstreamTruncated, downstream: downstreamTruncated },
+    };
+}
+//# sourceMappingURL=assemble.js.map

package/dist/profile/assemble.js.map

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

package/dist/profile/inline.d.ts

@@ -0,0 +1,4 @@
+import type { NeighborEntry, ProfileTarget } from "./types.js";
+/** Assembles the prose `inlined_context` an agent pastes into its reasoning
+ *  (PRD §7.4 / §10.3) so it doesn't burn turns reassembling the neighborhood. */
+export declare function buildInlinedContext(target: ProfileTarget, upstream: NeighborEntry[], downstream: NeighborEntry[]): string;

package/dist/profile/inline.js

@@ -0,0 +1,32 @@
+function neighborPhrase(n, withCaveat, homeRepo) {
+    let s = n.name;
+    if (n.summary) {
+        s += ` (${n.summary})`;
+    }
+    else {
+        s += " (no summary yet — read and enrich)";
+    }
+    if (homeRepo && n.repo_id && n.repo_id !== homeRepo) {
+        s += ` [repo: ${n.repo_id}]`;
+    }
+    if (withCaveat && n.resolution && n.resolution !== "exact") {
+        const conf = n.confidence != null ? `, confidence ${n.confidence}` : "";
+        s += ` [${n.resolution}${conf} — verify]`;
+    }
+    return s;
+}
+/** Assembles the prose `inlined_context` an agent pastes into its reasoning
+ *  (PRD §7.4 / §10.3) so it doesn't burn turns reassembling the neighborhood. */
+export function buildInlinedContext(target, upstream, downstream) {
+    const head = `${target.name} (${target.file_path}:${target.lines[0]}-${target.lines[1]})`;
+    const parts = [];
+    parts.push(target.summary ? `${head}: ${target.summary}.` : `${head} — no summary yet (read and enrich).`);
+    if (upstream.length > 0) {
+        parts.push("Called by " + upstream.map((u) => neighborPhrase(u, false, target.repo_id)).join(", ") + ".");
+    }
+    if (downstream.length > 0) {
+        parts.push("Calls " + downstream.map((d) => neighborPhrase(d, true, target.repo_id)).join("; ") + ".");
+    }
+    return parts.join(" ");
+}
+//# sourceMappingURL=inline.js.map

package/dist/profile/inline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline.js","sourceRoot":"","sources":["../../src/profile/inline.ts"],"names":[],"mappings":"AAEA,SAAS,cAAc,CAAC,CAAgB,EAAE,UAAmB,EAAE,QAAiB;IAC9E,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IACf,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACd,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,GAAG,CAAC;IACzB,CAAC;SAAM,CAAC;QACN,CAAC,IAAI,qCAAqC,CAAC;IAC7C,CAAC;IACD,IAAI,QAAQ,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACpD,CAAC,IAAI,WAAW,CAAC,CAAC,OAAO,GAAG,CAAC;IAC/B,CAAC;IACD,IAAI,UAAU,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC;QAC3D,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,CAAC,IAAI,KAAK,CAAC,CAAC,UAAU,GAAG,IAAI,YAAY,CAAC;IAC5C,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;iFACiF;AACjF,MAAM,UAAU,mBAAmB,CACjC,MAAqB,EACrB,QAAyB,EACzB,UAA2B;IAE3B,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1F,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,sCAAsC,CAAC,CAAC;IAC3G,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;IAC5G,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;IACzG,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/profile/resolve.d.ts

@@ -0,0 +1,10 @@
+import type { GraphStore } from "../store/GraphStore.js";
+import type { ResolveResult } from "./types.js";
+export interface Selector {
+    node_id?: string;
+    file_path?: string;
+    name?: string;
+}
+/** Resolves a target across one or more repos: id → exact path#name → fuzzy
+ *  name. Returns candidates (never guesses) when a name is ambiguous (§7.4). */
+export declare function resolveTarget(store: GraphStore, repos: string | string[], sel: Selector): Promise<ResolveResult>;

package/dist/profile/resolve.js

@@ -0,0 +1,24 @@
+function fromRows(rows) {
+    if (rows.length === 1)
+        return { kind: "found", target: rows[0] };
+    if (rows.length > 1)
+        return { kind: "candidates", candidates: rows };
+    return { kind: "not_found" };
+}
+/** Resolves a target across one or more repos: id → exact path#name → fuzzy
+ *  name. Returns candidates (never guesses) when a name is ambiguous (§7.4). */
+export async function resolveTarget(store, repos, sel) {
+    const repoIds = Array.isArray(repos) ? repos : [repos];
+    if (sel.node_id) {
+        const node = await store.getNode(repoIds, sel.node_id);
+        return node ? { kind: "found", target: node } : { kind: "not_found" };
+    }
+    if (sel.file_path && sel.name) {
+        return fromRows(await store.resolveByPathAndName(repoIds, sel.file_path, sel.name));
+    }
+    if (sel.name) {
+        return fromRows(await store.resolveByName(repoIds, sel.name));
+    }
+    return { kind: "not_found" };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/profile/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/profile/resolve.ts"],"names":[],"mappings":"AASA,SAAS,QAAQ,CAAC,IAAiB;IACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAE,EAAE,CAAC;IAClE,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IACrE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAC/B,CAAC;AAED;gFACgF;AAChF,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAiB,EACjB,KAAwB,EACxB,GAAa;IAEb,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAChB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IACxE,CAAC;IACD,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,oBAAoB,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAC/B,CAAC"}

package/dist/profile/summary.d.ts

@@ -0,0 +1,13 @@
+export interface SummaryInput {
+    semantic_summary: string | null;
+    summary_of_hash: string | null;
+    content_hash: string | null;
+}
+export interface SummaryState {
+    summary: string | null;
+    stale: boolean;
+    needsEnrichment: boolean;
+}
+/** Derives summary freshness (PRD §3.6): a summary is stale when the hash it
+ *  was written against no longer matches the node's current content_hash. */
+export declare function summaryState(props: SummaryInput): SummaryState;

package/dist/profile/summary.js

@@ -0,0 +1,12 @@
+import { neutralizeSummary } from "../guard/summaryValidation.js";
+/** Derives summary freshness (PRD §3.6): a summary is stale when the hash it
+ *  was written against no longer matches the node's current content_hash. */
+export function summaryState(props) {
+    const summary = neutralizeSummary(props.semantic_summary ?? null);
+    if (!summary) {
+        return { summary: null, stale: false, needsEnrichment: true };
+    }
+    const stale = props.summary_of_hash !== props.content_hash;
+    return { summary, stale, needsEnrichment: stale };
+}
+//# sourceMappingURL=summary.js.map

package/dist/profile/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../src/profile/summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAclE;6EAC6E;AAC7E,MAAM,UAAU,YAAY,CAAC,KAAmB;IAC9C,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,gBAAgB,IAAI,IAAI,CAAC,CAAC;IAClE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;IAChE,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,eAAe,KAAK,KAAK,CAAC,YAAY,CAAC;IAC3D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;AACpD,CAAC"}

package/dist/profile/types.d.ts

@@ -0,0 +1,55 @@
+export interface TargetRow {
+    id: string;
+    repo_id: string;
+    name: string;
+    qualified_name: string;
+    file_path: string;
+    start_line: number;
+    end_line: number;
+    semantic_summary: string | null;
+    summary_of_hash: string | null;
+    content_hash: string | null;
+    labels: string[];
+}
+export interface NeighborEntry {
+    id: string;
+    name: string;
+    summary: string | null;
+    stale: boolean;
+    needs_enrichment: boolean;
+    resolution?: string;
+    confidence?: number;
+    distance?: number;
+    repo_id?: string;
+    /** True for a cross-repo (federation-stitched) neighbor. */
+    cross_repo?: boolean;
+}
+export interface ProfileTarget {
+    id: string;
+    name: string;
+    file_path: string;
+    lines: [number, number];
+    summary: string | null;
+    stale: boolean;
+    repo_id?: string;
+}
+export interface ContextProfile {
+    target: ProfileTarget;
+    upstream: NeighborEntry[];
+    downstream: NeighborEntry[];
+    inlined_context: string;
+    enrichment_needed: string[];
+    truncated?: {
+        upstream: boolean;
+        downstream: boolean;
+    };
+}
+export type ResolveResult = {
+    kind: "found";
+    target: TargetRow;
+} | {
+    kind: "candidates";
+    candidates: TargetRow[];
+} | {
+    kind: "not_found";
+};

package/dist/profile/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/profile/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/profile/types.ts"],"names":[],"mappings":""}

package/dist/store/GraphStore.d.ts

@@ -0,0 +1,62 @@
+import type { TargetRow } from "../profile/types.js";
+/** Thrown by stores that cannot execute raw Cypher (e.g. the JSONL store).
+ *  read_cypher surfaces the message to the agent. */
+export declare class CypherUnsupportedError extends Error {
+    constructor(message?: string);
+}
+/** A single caller/callee row. resolution/confidence are present only for the
+ *  direct (1-hop) CALLS edges; absent for 2-hop callees. */
+export interface NeighborRow {
+    id: string;
+    repo_id?: string;
+    name: string;
+    semantic_summary: string | null;
+    summary_of_hash: string | null;
+    content_hash: string | null;
+    resolution?: string;
+    confidence?: number;
+    /** True for a federation-stitched cross-repo CALLS edge. */
+    cross_repo?: boolean;
+}
+/** Fields the caller computes (date/agent) and hands to the store to persist. */
+export interface SummaryFields {
+    summary: string;
+    model: string;
+    at: string;
+    by: string;
+}
+export type WriteSummaryResult = {
+    kind: "ok";
+    stale_replaced: boolean;
+} | {
+    kind: "not_found";
+} | {
+    kind: "no_content_hash";
+};
+/** Storage abstraction (PRD §4.2). All MCP read/write goes through these
+ *  semantic methods so the backend (Neo4j or JSONL) is swappable. Raw Cypher
+ *  is exposed only via runRead, used by the read_cypher tool. */
+export interface GraphStore {
+    /** Exact node by id within the given repos. null if not found. */
+    getNode(repoIds: string[], id: string): Promise<TargetRow | null>;
+    /** Function/Class nodes in a file matching name OR qualified_name, within the given repos. */
+    resolveByPathAndName(repoIds: string[], filePath: string, name: string): Promise<TargetRow[]>;
+    /** Function nodes anywhere in the given repos matching name. */
+    resolveByName(repoIds: string[], name: string): Promise<TargetRow[]>;
+    /** Direct callers of id whose repo_id is in repoIds, ordered by id, capped at limit. */
+    callers(repoIds: string[], id: string, limit: number): Promise<NeighborRow[]>;
+    /** Direct callees of id whose repo_id is in repoIds, ordered by id, capped at limit. */
+    callees(repoIds: string[], id: string, limit: number): Promise<NeighborRow[]>;
+    /** Callees exactly 2 hops out whose repo_id is in repoIds, distinct, ordered by id, capped at limit. */
+    calleesAt2Hops(repoIds: string[], id: string, limit: number): Promise<NeighborRow[]>;
+    /** Attach/refresh a summary; returns whether a stale one was replaced. */
+    writeSummary(repoId: string, id: string, fields: SummaryFields): Promise<WriteSummaryResult>;
+    /** Transitively federated repo_ids (NOT including repoId itself). */
+    federatedRepoIds(repoId: string): Promise<string[]>;
+    /** Raw read-only Cypher (read_cypher tool only). Stores without a Cypher
+     *  engine throw CypherUnsupportedError. */
+    runRead(query: string, params?: Record<string, unknown>, opts?: {
+        timeoutMs?: number;
+    }): Promise<Record<string, unknown>[]>;
+    close(): Promise<void>;
+}

package/dist/store/GraphStore.js

@@ -0,0 +1,9 @@
+/** Thrown by stores that cannot execute raw Cypher (e.g. the JSONL store).
+ *  read_cypher surfaces the message to the agent. */
+export class CypherUnsupportedError extends Error {
+    constructor(message = "read_cypher is not supported by this store (no Cypher engine). Use get_context_profile.") {
+        super(message);
+        this.name = "CypherUnsupportedError";
+    }
+}
+//# sourceMappingURL=GraphStore.js.map

package/dist/store/GraphStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphStore.js","sourceRoot":"","sources":["../../src/store/GraphStore.ts"],"names":[],"mappings":"AAEA;qDACqD;AACrD,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YACE,OAAO,GAAG,yFAAyF;QAEnG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF"}

package/dist/store/JsonlGraphStore.d.ts

@@ -0,0 +1,37 @@
+import { type GraphStore, type NeighborRow, type SummaryFields, type WriteSummaryResult } from "./GraphStore.js";
+import type { TargetRow } from "../profile/types.js";
+/** 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 declare class JsonlGraphStore implements GraphStore {
+    private readonly repoId;
+    private graph;
+    private mtime;
+    private readonly repoPath;
+    private readonly nodesPath;
+    private readonly edgesPath;
+    private readonly sidecarFile;
+    constructor(repoPath: string, repoId: string);
+    /** 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. */
+    private collectRepos;
+    /** Reloads the graph if either ROOT file's mtime changed since last load. */
+    private ensureFresh;
+    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(): Promise<Record<string, unknown>[]>;
+    close(): Promise<void>;
+}