@reposkein/mcp 0.2.7 → 0.4.0

package/dist/store/summaryShards.js

@@ -0,0 +1,291 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync, } from "node:fs";
+import { basename, join } from "node:path";
+export function summariesDir(repoPath) {
+    return join(repoPath, ".reposkein", "summaries");
+}
+/** The pre-sharding committed file. Still read (dual-read) for one release. */
+export function legacySummariesPath(repoPath) {
+    return join(repoPath, ".reposkein", "summaries.jsonl");
+}
+export function conflictsPath(repoPath) {
+    return join(repoPath, ".reposkein", "local", "conflicts.jsonl");
+}
+/** Mirrors the Rust `is_shard_file_name`: exactly two lowercase hex chars. */
+export function isShardFileName(name) {
+    return /^[0-9a-f]{2}\.jsonl$/.test(name);
+}
+/** A line git left behind from an unresolved textual merge. A canonical
+ *  summary line always starts with `{`, so a marker run is damage, not data. */
+export function isConflictMarker(line) {
+    return (line.startsWith("<<<<<<<") ||
+        line.startsWith("=======") ||
+        line.startsWith(">>>>>>>") ||
+        line.startsWith("|||||||"));
+}
+/** True for a value that is actually authored prose: a non-empty string.
+ *  `null`, a number, or `""` all mean "the field is present but says nothing". */
+function isProse(v) {
+    return typeof v === "string" && v !== "";
+}
+/** Whether these props carry an authored summary worth keeping.
+ *
+ *  Deliberately identical to the Rust `has_summary`. The two languages read the
+ *  same committed shards, so a record one accepts and the other rejects is a
+ *  divergence between what the server serves and what the indexer writes — and
+ *  a record with nothing in it must never displace one that has prose, in
+ *  either language. Pinned by the `null-valued`/`non-string` fixture vectors. */
+export function hasSummary(props) {
+    return isProse(props.semantic_summary) || isProse(props.purpose_summary);
+}
+function summaryAt(rec) {
+    const v = rec.props.summary_at;
+    return typeof v === "string" ? v : "";
+}
+/** Byte-lexicographic comparison. JavaScript's `<` compares UTF-16 code units,
+ *  which orders some astral/BMP pairs differently from the UTF-8 byte order
+ *  Rust uses. Comparing the encoded bytes is what makes the two languages
+ *  agree on every input, not just ASCII ones. */
+function lineIsSmaller(a, b) {
+    return Buffer.compare(Buffer.from(a, "utf8"), Buffer.from(b, "utf8")) < 0;
+}
+/** Deterministic winner between two records claiming the same node id, when
+ *  nothing is known about where either came from:
+ *  newer `summary_at`, then smaller raw line by UTF-8 byte order. Both are
+ *  pure functions of bytes on disk, so every machine — and the Rust indexer —
+ *  picks the same winner without coordinating. Kept in lockstep with the Rust
+ *  `beats` by the shared vectors in `fixtures/summary-shard-vectors.json`.
+ *
+ *  This is the rule for records found in the SAME source (two lines of one
+ *  merged shard, two agents' sidecars). Across sources of known provenance,
+ *  use `supersedes`. */
+export function beats(candidate, incumbent) {
+    const ca = summaryAt(candidate);
+    const ia = summaryAt(incumbent);
+    if (ca !== ia)
+        return ca > ia;
+    return lineIsSmaller(candidate.line, incumbent.line);
+}
+/** Whether a record from a strictly NEWER-provenance source displaces one
+ *  already held from an older source.
+ *
+ *  `summary_at` is day-precision (PRD §6.2.5 keeps wall-clock time out of
+ *  committed bytes), so re-summarising a node already summarised today TIES.
+ *  Resolving that tie by byte order would silently discard the rewrite. A
+ *  newer source therefore wins unless it is *strictly older* — which is the
+ *  case that matters, because that is a stale local record about to clobber a
+ *  teammate's newer one. Mirrors the Rust `supersedes`. */
+export function supersedes(candidate, incumbent) {
+    return summaryAt(candidate) >= summaryAt(incumbent);
+}
+export function emptyAccumulator() {
+    return { summaries: new Map(), conflicts: [], warnings: [] };
+}
+/** Folds one candidate in, keeping whichever record `wins` selects and
+ *  preserving the other. The single place a record can be displaced, so no
+ *  caller can bypass conflict recording by accident. */
+function offer(acc, rec, wins) {
+    const existing = acc.summaries.get(rec.id);
+    if (!existing) {
+        acc.summaries.set(rec.id, rec);
+        return;
+    }
+    // A union merge duplicating an unchanged line is not a conflict.
+    if (existing.line === rec.line)
+        return;
+    if (wins(rec, existing)) {
+        acc.summaries.set(rec.id, rec);
+        acc.conflicts.push(existing);
+    }
+    else {
+        acc.conflicts.push(rec);
+    }
+}
+/** Folds a whole source of strictly NEWER provenance into `acc`. Mirrors the
+ *  Rust `absorb_source`: displacement uses `supersedes`, and every displaced
+ *  record is preserved. */
+export function absorbSummarySource(acc, other) {
+    for (const rec of other.summaries.values())
+        offer(acc, rec, supersedes);
+    acc.conflicts.push(...other.conflicts);
+    acc.warnings.push(...other.warnings);
+}
+/** Folds one file's text in, resolving same-source records with `beats`.
+ *  Exported for the shared vectors. */
+export function absorbSummaryLines(acc, source, text) {
+    let markers = 0;
+    let malformed = 0;
+    for (const raw of text.split("\n")) {
+        const line = raw.endsWith("\r") ? raw.slice(0, -1) : raw;
+        if (line.trim() === "")
+            continue;
+        if (isConflictMarker(line)) {
+            markers++;
+            continue;
+        }
+        let obj;
+        try {
+            const parsed = JSON.parse(line);
+            if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+                malformed++;
+                continue;
+            }
+            obj = parsed;
+        }
+        catch {
+            malformed++;
+            continue;
+        }
+        const id = obj.id;
+        if (typeof id !== "string" || id === "") {
+            malformed++;
+            continue;
+        }
+        const { id: _drop, ...props } = obj;
+        // A line with no authored prose is not a summary. Letting it into the map
+        // would let it WIN a tiebreak against a real summary and evict it — see
+        // `hasSummary` for the null-valued case that did exactly that.
+        if (!hasSummary(props)) {
+            malformed++;
+            continue;
+        }
+        offer(acc, { id, props, line }, beats);
+    }
+    if (markers > 0) {
+        acc.warnings.push(`${source}: skipped ${markers} git conflict-marker line(s); run \`reposkein-indexer index\` to rewrite the shard cleanly`);
+    }
+    if (malformed > 0) {
+        acc.warnings.push(`${source}: skipped ${malformed} malformed line(s)`);
+    }
+}
+/** Reads every committed shard plus the pre-sharding file, tolerantly.
+ *  A missing directory is the normal state for a repo with no authored prose,
+ *  and returns an empty result rather than an error. */
+export function loadSummaryShards(repoPath) {
+    const acc = emptyAccumulator();
+    const dir = summariesDir(repoPath);
+    let names = [];
+    try {
+        names = readdirSync(dir).filter(isShardFileName).sort();
+    }
+    catch {
+        names = [];
+    }
+    for (const name of names) {
+        try {
+            absorbSummaryLines(acc, `summaries/${name}`, readFileSync(join(dir, name), "utf8"));
+        }
+        catch {
+            acc.warnings.push(`summaries/${name}: unreadable`);
+        }
+    }
+    const legacy = legacySummariesPath(repoPath);
+    const legacyFilePresent = existsSync(legacy);
+    if (legacyFilePresent) {
+        try {
+            absorbSummaryLines(acc, "summaries.jsonl", readFileSync(legacy, "utf8"));
+        }
+        catch {
+            acc.warnings.push("summaries.jsonl: unreadable");
+        }
+    }
+    // Sorted by id so callers iterate deterministically.
+    const summaries = new Map([...acc.summaries.entries()].sort((a, b) => (a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0)));
+    return { summaries, conflicts: acc.conflicts, warnings: acc.warnings, legacyFilePresent };
+}
+/** A cheap fingerprint of everything the summary overlay reads on disk.
+ *
+ *  The store keys its reload on this, so a `git pull` that brings in a
+ *  teammate's shards — or another agent's sidecar write on this machine — is
+ *  visible without restarting the process. Stat calls only, O(shards +
+ *  sidecars), no content read, because this runs on every read and not just on
+ *  change. mtime alone is not enough on filesystems with coarse timestamps, so
+ *  size rides along.
+ *
+ *  `sidecarFiles` is injected rather than imported to keep this module free of
+ *  a cycle with sidecar.ts, which imports the fold from here. */
+export function summaryShardsStamp(repoPath, sidecarFiles = () => []) {
+    const parts = [];
+    const dir = summariesDir(repoPath);
+    let names = [];
+    try {
+        names = readdirSync(dir).filter(isShardFileName).sort();
+    }
+    catch {
+        names = [];
+    }
+    for (const name of names) {
+        try {
+            const s = statSync(join(dir, name));
+            parts.push(`${name}:${s.mtimeMs}:${s.size}`);
+        }
+        catch {
+            parts.push(`${name}:?`);
+        }
+    }
+    try {
+        const s = statSync(legacySummariesPath(repoPath));
+        parts.push(`legacy:${s.mtimeMs}:${s.size}`);
+    }
+    catch {
+        // absent, which is the post-migration norm
+    }
+    // Sidecars too. Without them a second agent's write on the same checkout was
+    // invisible to an already-open server for the life of the process — which
+    // the overlay explicitly promises to surface.
+    for (const p of sidecarFiles(repoPath)) {
+        try {
+            const s = statSync(p);
+            parts.push(`sc/${basename(p)}:${s.mtimeMs}:${s.size}`);
+        }
+        catch {
+            parts.push(`sc/${basename(p)}:?`);
+        }
+    }
+    return parts.join("|");
+}
+/** Merges divergence losers into the git-ignored `local/conflicts.jsonl`.
+ *
+ *  Deduped and sorted, so repeated reads converge instead of growing the file,
+ *  and never truncating: a loser recorded by an earlier run (or by the indexer)
+ *  stays. Best-effort — failing to record a conflict must not break a tool
+ *  call. Mirrors the Rust `conflicts_to_jsonl`. */
+export function recordSummaryConflicts(repoPath, losers) {
+    if (losers.length === 0)
+        return;
+    const path = conflictsPath(repoPath);
+    const lines = new Set();
+    try {
+        for (const raw of readFileSync(path, "utf8").split("\n")) {
+            const line = raw.endsWith("\r") ? raw.slice(0, -1) : raw;
+            if (line.trim() !== "" && !isConflictMarker(line))
+                lines.add(line);
+        }
+    }
+    catch {
+        // no existing file
+    }
+    const before = lines.size;
+    for (const l of losers)
+        lines.add(l.line);
+    if (lines.size === before)
+        return;
+    try {
+        mkdirSync(join(repoPath, ".reposkein", "local"), { recursive: true });
+        writeFileSync(path, [...lines].sort().join("\n") + "\n");
+    }
+    catch {
+        // best-effort
+    }
+}
+/** How many divergence losers are on record. Doctor surfaces this. */
+export function countRecordedConflicts(repoPath) {
+    try {
+        return readFileSync(conflictsPath(repoPath), "utf8")
+            .split("\n")
+            .filter((l) => l.trim() !== "").length;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=summaryShards.js.map

package/dist/store/summaryShards.js.map

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

package/dist/store/teamConfig.d.ts

@@ -0,0 +1,13 @@
+/** Reads `pages_url` from the `[team]` section of `.reposkein/config.toml`,
+ *  or null when the file/section/key is absent (the common case — this is
+ *  an opt-in field a team adds after publishing a hosted constellation, see
+ *  docs/HOSTING.md). Points the viewer's header at wherever the team's
+ *  canonical/CI-published constellation lives (e.g. a GitHub Pages URL),
+ *  distinct from whatever ad-hoc `view`/`view --export` a given machine
+ *  happens to be looking at right now.
+ *
+ *  A deliberate ~20-line scanner rather than a TOML dependency — mirrors
+ *  `config_bool` in indexer/crates/cli/src/main.rs: this reads exactly one
+ *  setting, and its config is a file `reposkein-indexer init` writes.
+ *  Absent file, section, or key all mean `null`. */
+export declare function readTeamPagesUrl(repoPath: string): string | null;

package/dist/store/teamConfig.js

@@ -0,0 +1,49 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/** Reads `pages_url` from the `[team]` section of `.reposkein/config.toml`,
+ *  or null when the file/section/key is absent (the common case — this is
+ *  an opt-in field a team adds after publishing a hosted constellation, see
+ *  docs/HOSTING.md). Points the viewer's header at wherever the team's
+ *  canonical/CI-published constellation lives (e.g. a GitHub Pages URL),
+ *  distinct from whatever ad-hoc `view`/`view --export` a given machine
+ *  happens to be looking at right now.
+ *
+ *  A deliberate ~20-line scanner rather than a TOML dependency — mirrors
+ *  `config_bool` in indexer/crates/cli/src/main.rs: this reads exactly one
+ *  setting, and its config is a file `reposkein-indexer init` writes.
+ *  Absent file, section, or key all mean `null`. */
+export function readTeamPagesUrl(repoPath) {
+    const path = join(repoPath, ".reposkein", "config.toml");
+    if (!existsSync(path))
+        return null;
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    let inTeamSection = false;
+    for (const rawLine of text.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (line === "" || line.startsWith("#"))
+            continue;
+        if (line.startsWith("[")) {
+            inTeamSection = line === "[team]";
+            continue;
+        }
+        if (!inTeamSection)
+            continue;
+        const eq = line.indexOf("=");
+        if (eq === -1)
+            continue;
+        const key = line.slice(0, eq).trim();
+        if (key !== "pages_url")
+            continue;
+        const rawValue = line.slice(eq + 1).split("#")[0].trim();
+        const quoted = rawValue.match(/^"([^"]*)"$/) ?? rawValue.match(/^'([^']*)'$/);
+        return quoted ? quoted[1] : null;
+    }
+    return null;
+}
+//# sourceMappingURL=teamConfig.js.map

package/dist/store/teamConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teamConfig.js","sourceRoot":"","sources":["../../src/store/teamConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;;;oDAWoD;AACpD,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAClD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,aAAa,GAAG,IAAI,KAAK,QAAQ,CAAC;YAClC,SAAS;QACX,CAAC;QACD,IAAI,CAAC,aAAa;YAAE,SAAS;QAC7B,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,EAAE,KAAK,CAAC,CAAC;YAAE,SAAS;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,GAAG,KAAK,WAAW;YAAE,SAAS;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC9E,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/tools/getContextProfile.d.ts

@@ -7,4 +7,4 @@ export interface GetContextProfileArgs {
     hops?: number;
     federated?: boolean;
 }
-export declare function makeGetContextProfile(store: GraphStore, repoId: string): (args: GetContextProfileArgs) => Promise<ToolResult>;
+export declare function makeGetContextProfile(store: GraphStore, repoId: string, repoPath?: string): (args: GetContextProfileArgs) => Promise<ToolResult>;

package/dist/tools/getContextProfile.js

@@ -1,7 +1,8 @@
 import { resolveTarget } from "../profile/resolve.js";
 import { assembleProfile } from "../profile/assemble.js";
+import { governingDecisionsFor } from "../profile/decisions.js";
 import { federationIds } from "../store/federation.js";
-export function makeGetContextProfile(store, repoId) {
+export function makeGetContextProfile(store, repoId, repoPath) {
     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) {
@@ -34,6 +35,13 @@ export function makeGetContextProfile(store, repoId) {
                 };
             }
             const profile = await assembleProfile(store, repoIds, resolved.target, hops);
+            if (repoPath) {
+                const gov = governingDecisionsFor(repoPath, resolved.target, repoId);
+                if (gov.decisions.length > 0)
+                    profile.target.decisions = gov.decisions;
+                if (gov.needing_review.length > 0)
+                    profile.decisions_needing_review = gov.needing_review;
+            }
             return { content: [{ type: "text", text: JSON.stringify(profile) }] };
         }
         catch (e) {

package/dist/tools/getContextProfile.js.map

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

package/dist/tools/getDecision.d.ts

@@ -0,0 +1,6 @@
+import type { GraphStore } from "../store/GraphStore.js";
+import type { ToolResult } from "./readCypher.js";
+export interface GetDecisionArgs {
+    decision_id: string;
+}
+export declare function makeGetDecision(store: GraphStore, repoId: string, repoPath: string): (args: GetDecisionArgs) => Promise<ToolResult>;

package/dist/tools/getDecision.js

@@ -0,0 +1,59 @@
+import { neutralizeSummary } from "../guard/summaryValidation.js";
+import { anchorRepoIds, loadDecisions, resolveAnchorStates } from "../store/decisions.js";
+const err = (text) => ({ content: [{ type: "text", text }], isError: true });
+function neutralize(s) {
+    if (s === undefined)
+        return undefined;
+    return neutralizeSummary(s) ?? "";
+}
+export function makeGetDecision(store, repoId, repoPath) {
+    return async (args) => {
+        try {
+            const { decisions } = loadDecisions(repoPath);
+            const rec = decisions.find((d) => d.id === args.decision_id);
+            if (!rec)
+                return err(`unknown decision: ${args.decision_id}`);
+            const resolved = await resolveAnchorStates(store, await anchorRepoIds(store, repoId), rec.anchors);
+            // The chain in both directions: what this supersedes (recorded) and
+            // what supersedes it (recorded on flip, recovered from siblings if the
+            // flip was lost to merge damage).
+            const supersededBy = rec.superseded_by ??
+                decisions.find((d) => d.supersedes.includes(rec.id))?.id;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            id: rec.id,
+                            title: neutralize(rec.title),
+                            status: rec.status,
+                            context: neutralize(rec.context),
+                            decision: neutralize(rec.decision),
+                            ...(rec.consequences !== undefined ? { consequences: neutralize(rec.consequences) } : {}),
+                            ...(rec.alternatives !== undefined ? { alternatives: neutralize(rec.alternatives) } : {}),
+                            anchors: resolved.map((a) => ({
+                                node_id: a.node_id,
+                                path: a.path,
+                                kind: a.kind,
+                                state: a.state,
+                                ...(a.resolved_node_id && a.resolved_node_id !== a.node_id
+                                    ? { resolved_node_id: a.resolved_node_id }
+                                    : {}),
+                            })),
+                            paths: rec.paths,
+                            supersedes: rec.supersedes,
+                            ...(supersededBy ? { superseded_by: supersededBy } : {}),
+                            decided_at: rec.decided_at,
+                            decided_by: rec.decided_by,
+                            trigger: rec.trigger,
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (e) {
+            return err(e.message);
+        }
+    };
+}
+//# sourceMappingURL=getDecision.js.map

package/dist/tools/getDecision.js.map

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

package/dist/tools/impact.d.ts

@@ -13,4 +13,4 @@ export interface ImpactArgs {
  *  edges are captured in the committed graph for read_cypher/visualization but are
  *  intentionally NOT traversed here (recorded decision, matched across both
  *  backends) — instantiation sites are not treated as impact-bearing callers. */
-export declare function makeImpact(store: GraphStore, repoId: string): (args: ImpactArgs) => Promise<ToolResult>;
+export declare function makeImpact(store: GraphStore, repoId: string, repoPath?: string): (args: ImpactArgs) => Promise<ToolResult>;

package/dist/tools/impact.js

@@ -1,5 +1,6 @@
 import { resolveTarget } from "../profile/resolve.js";
 import { computeImpact } from "../profile/impact.js";
+import { governingDecisionsForNodes } from "../profile/decisions.js";
 import { federationIds } from "../store/federation.js";
 function clamp(val, min, max) {
     return Math.min(Math.max(val, min), max);
@@ -10,7 +11,7 @@ function clamp(val, min, max) {
  *  edges are captured in the committed graph for read_cypher/visualization but are
  *  intentionally NOT traversed here (recorded decision, matched across both
  *  backends) — instantiation sites are not treated as impact-bearing callers. */
-export function makeImpact(store, repoId) {
+export function makeImpact(store, repoId, repoPath) {
     return async (args) => {
         const sel = {
             node_id: args.node_id,
@@ -53,6 +54,17 @@ export function makeImpact(store, repoId) {
             const target = resolved.target;
             const depth = clamp(args.depth ?? 3, 1, 5);
             const result = await computeImpact(store, repoIds, target.id, target.qualified_name, target.file_path, { depth, maxNodes: 500 });
+            if (repoPath) {
+                const gov = governingDecisionsForNodes(repoPath, [
+                    { node_id: target.id, file_path: target.file_path, content_hash: target.content_hash },
+                    ...result.impacted.map((r) => ({ node_id: r.node_id, file_path: r.file_path })),
+                ], repoId);
+                if (gov.length > 0) {
+                    return {
+                        content: [{ type: "text", text: JSON.stringify({ ...result, governing_decisions: gov }) }],
+                    };
+                }
+            }
             return {
                 content: [{ type: "text", text: JSON.stringify(result) }],
             };

package/dist/tools/impact.js.map

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

package/dist/tools/indexerTools.d.ts

@@ -1,10 +1,12 @@
 import type { ToolResult } from "./readCypher.js";
+import { type GraphDeltaJson } from "../indexer/decisionsAffected.js";
 export type RunResult = {
     ok: true;
     nodes: number;
     edges: number;
     files: number;
     warnings: string[];
+    graph_delta?: GraphDeltaJson;
 } | {
     ok: false;
     error: string;
@@ -20,8 +22,20 @@ export interface InitArgs {
     path?: string;
     full?: boolean;
 }
-export declare function makeInitCpgSkeleton(repoId: string, deps?: Partial<IndexerDeps>): (args: InitArgs) => Promise<ToolResult>;
+/** `path` (the repo to index) MUST come from the caller's already-resolved
+ *  active repo (mcp/src/store/repoSession.ts), not re-derived here — this
+ *  tool used to default to REPOSKEIN_REPO_PATH/cwd internally via
+ *  runIndexer.js's `repoPath()`, which bypassed session.select_repo entirely
+ *  and could index the wrong repo in workspace mode. Args-supplied `path`
+ *  still wins, matching the original "explicit arg beats everything" rule. */
+export declare function makeInitCpgSkeleton(repoId: string, repoPath: 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>;
+/** `path` has no override — `reindex_file`'s args only carry the file being
+ *  reindexed, not a repo root — so this ALWAYS targets the caller's resolved
+ *  active repo. Same reasoning as `makeInitCpgSkeleton` above: previously
+ *  this read REPOSKEIN_REPO_PATH/cwd internally, independent of
+ *  session.select_repo — the exact "reindex the wrong repo" bug class this
+ *  parameter exists to close. */
+export declare function makeReindexFile(repoId: string, repoPath: string, deps?: Partial<IndexerDeps>): (args: ReindexArgs) => Promise<ToolResult>;