@reposkein/mcp 0.2.7 → 0.4.0

package/dist/cli/agentAdapters.js

@@ -0,0 +1,223 @@
+/** Per-agent MCP config adapters for `reposkein-mcp init`'s join mode
+ *  (REP-16 T5). A "join" is: someone cloned a repo that already has RepoSkein
+ *  set up (committed `.reposkein/meta.json`) — the one thing left to do is
+ *  wire the local agent(s) up, which today means hand-copying a JSON snippet
+ *  from docs/INSTALL.md §6. These adapters do that automatically.
+ *
+ *  Schemas match docs/INSTALL.md §6 exactly — that doc is the spec:
+ *   - Claude Code: `<repo>/.mcp.json`, `mcpServers` key. Prefers `claude mcp
+ *     add` (scope "project", which itself targets .mcp.json) when the CLI is
+ *     on PATH, so Claude's own approval/health-check flow sees the entry;
+ *     falls back to writing the file directly.
+ *   - OpenCode (+omo): `<repo>/opencode.json`, `mcp` key (NOT `mcpServers`).
+ *   - Cursor: `<repo>/.cursor/mcp.json`, `mcpServers` key.
+ *   - Unknown/no agent detected: falls back to `.mcp.json` (§6.6 "generic").
+ *
+ *  Every write is idempotent (re-run = no-op, byte-identical file), dry-run
+ *  aware (never touches disk when `dryRun: true`), and backs up any file it
+ *  actually modifies to a timestamped `.bak` sibling first. */
+import { existsSync, readFileSync, writeFileSync, copyFileSync, mkdirSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+import { dirname, join, resolve } from "node:path";
+export const ALL_AGENT_IDS = ["claude", "opencode", "cursor"];
+export const defaultExec = (cmd, args, opts) => {
+    try {
+        const stdout = execFileSync(cmd, args, { cwd: opts.cwd, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
+        return { status: 0, stdout, stderr: "" };
+    }
+    catch (err) {
+        const e = err;
+        return {
+            status: typeof e.status === "number" ? e.status : 1,
+            stdout: e.stdout ? e.stdout.toString() : "",
+            stderr: e.stderr ? e.stderr.toString() : String(e.message ?? err),
+        };
+    }
+};
+function commandAvailable(exec, cmd, cwd) {
+    return exec(cmd, ["--version"], { cwd }).status === 0;
+}
+/** Detects which agents are "present": their CLI is on PATH, or their config
+ *  file already exists (someone opted in previously — keep writing there).
+ *  Falls back to `["claude"]` (→ `.mcp.json`, the generic/broadest-compat
+ *  target) when nothing is detected at all, matching docs/INSTALL.md §6.6. */
+export function detectAgents(repoPath, exec = defaultExec) {
+    const present = [];
+    if (existsSync(join(repoPath, ".mcp.json")) || commandAvailable(exec, "claude", repoPath))
+        present.push("claude");
+    if (existsSync(join(repoPath, "opencode.json")) || commandAvailable(exec, "opencode", repoPath))
+        present.push("opencode");
+    if (existsSync(join(repoPath, ".cursor")))
+        present.push("cursor");
+    if (present.length === 0)
+        present.push("claude");
+    return present;
+}
+/** Parses a comma/space-separated `--agents` value into AgentId[], ignoring
+ *  unknown tokens (never throws — an unrecognized agent name just writes
+ *  nothing rather than crashing `init`). */
+export function parseAgentsFlag(value) {
+    const known = new Set(ALL_AGENT_IDS);
+    return value
+        .split(/[,\s]+/)
+        .map((s) => s.trim().toLowerCase())
+        .filter((s) => known.has(s));
+}
+function timestampSuffix(now) {
+    return now.toISOString().replace(/[:.]/g, "-");
+}
+/** Copies `path` to `<path>.<timestamp>.bak` before it's modified. */
+function backupFile(path, now) {
+    const backupPath = `${path}.${timestampSuffix(now)}.bak`;
+    copyFileSync(path, backupPath);
+    return backupPath;
+}
+const MCP_JSON_SPEC = {
+    relPath: ".mcp.json",
+    topKey: "mcpServers",
+    buildEntry: (absRepoPath) => ({ command: "reposkein-mcp", env: { REPOSKEIN_REPO_PATH: absRepoPath } }),
+};
+const OPENCODE_JSON_SPEC = {
+    relPath: "opencode.json",
+    topKey: "mcp",
+    buildEntry: (absRepoPath) => ({
+        type: "local",
+        command: ["reposkein-mcp"],
+        environment: { REPOSKEIN_REPO_PATH: absRepoPath },
+        enabled: true,
+    }),
+};
+const CURSOR_JSON_SPEC = {
+    relPath: join(".cursor", "mcp.json"),
+    topKey: "mcpServers",
+    buildEntry: (absRepoPath) => ({ command: "reposkein-mcp", env: { REPOSKEIN_REPO_PATH: absRepoPath } }),
+};
+/** Idempotently upserts `doc[topKey].reposkein = entry` in a JSON config
+ *  file, preserving every other key untouched (other MCP servers, `$schema`,
+ *  etc.). Never guesses at a corrupt/hand-edited existing file — see the
+ *  early return below: it backs the file up (real run only) and reports an
+ *  "error" result instead of overwriting it with a reposkein-only doc,
+ *  which would silently destroy whatever else was in there. */
+function upsertJsonAdapter(repoPath, spec, dryRun, now) {
+    const path = join(repoPath, spec.relPath);
+    const exists = existsSync(path);
+    let doc = {};
+    if (exists) {
+        let raw;
+        try {
+            raw = readFileSync(path, "utf8");
+        }
+        catch (err) {
+            return {
+                path,
+                action: "error",
+                message: `could not read ${spec.relPath}: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+        try {
+            doc = JSON.parse(raw);
+        }
+        catch (err) {
+            const parseMessage = err instanceof Error ? err.message : String(err);
+            if (dryRun) {
+                return {
+                    path,
+                    action: "error",
+                    message: `${spec.relPath} is not valid JSON (${parseMessage}) — left untouched. ` +
+                        "Fix the JSON and re-run, or delete the file.",
+                };
+            }
+            const backupPath = backupFile(path, now);
+            return {
+                path,
+                action: "error",
+                backupPath,
+                message: `${spec.relPath} is not valid JSON (${parseMessage}) — left untouched, backed up to ${backupPath}. ` +
+                    "Fix the JSON and re-run, or delete the file.",
+            };
+        }
+    }
+    const section = doc[spec.topKey] ?? {};
+    const entry = spec.buildEntry(resolve(repoPath));
+    if (JSON.stringify(section.reposkein ?? null) === JSON.stringify(entry)) {
+        return { path, action: "unchanged", message: `${spec.relPath} already has an up-to-date reposkein entry` };
+    }
+    if (dryRun) {
+        return {
+            path,
+            action: "dry-run",
+            message: `would ${exists ? "update" : "create"} ${spec.relPath} (${spec.topKey}.reposkein)`,
+        };
+    }
+    let backupPath;
+    if (exists)
+        backupPath = backupFile(path, now);
+    doc[spec.topKey] = { ...section, reposkein: entry };
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(doc, null, 2) + "\n", "utf8");
+    return { path, action: exists ? "updated" : "created", backupPath, message: `${exists ? "updated" : "created"} ${spec.relPath}` };
+}
+function claudeCliEntryExists(exec, repoPath) {
+    return exec("claude", ["mcp", "get", "reposkein"], { cwd: repoPath }).status === 0;
+}
+/** Writes the Claude Code entry via `claude mcp add -s project` (which
+ *  itself targets `.mcp.json`), so Claude's own health-check/approval UI
+ *  picks it up immediately. Idempotent via `claude mcp get` — a re-run
+ *  no-ops instead of erroring on a duplicate name. */
+function writeViaClaudeCli(repoPath, dryRun, exec) {
+    const path = join(repoPath, ".mcp.json");
+    if (claudeCliEntryExists(exec, repoPath)) {
+        return { agent: "claude", path, action: "unchanged", message: "`claude mcp get reposkein` already resolves — nothing to add" };
+    }
+    const args = ["mcp", "add", "reposkein", "-s", "project", "-e", `REPOSKEIN_REPO_PATH=${resolve(repoPath)}`, "--", "reposkein-mcp"];
+    if (dryRun) {
+        return { agent: "claude", path, action: "dry-run", message: `would run: claude ${args.join(" ")}` };
+    }
+    const r = exec("claude", args, { cwd: repoPath });
+    if (r.status !== 0) {
+        return { agent: "claude", path, action: "error", message: `claude mcp add failed: ${(r.stderr || r.stdout).trim()}` };
+    }
+    return { agent: "claude", path, action: "created", message: "added via `claude mcp add` (project scope → .mcp.json)" };
+}
+/** Writes (or plans, under `dryRun`) the local agent MCP config for every
+ *  detected/requested agent. Pure w.r.t. its inputs beyond `exec`/`now`/fs —
+ *  same repo state + same options always produces the same plan, which is
+ *  what makes idempotence and dry-run trustworthy. */
+export function writeAgentConfigs(repoPath, opts = {}) {
+    const exec = opts.exec ?? defaultExec;
+    const now = (opts.now ?? (() => new Date()))();
+    const dryRun = !!opts.dryRun;
+    const agents = opts.agents ?? detectAgents(repoPath, exec);
+    const results = [];
+    for (const agent of agents) {
+        if (agent === "claude") {
+            if (commandAvailable(exec, "claude", repoPath)) {
+                results.push(writeViaClaudeCli(repoPath, dryRun, exec));
+            }
+            else {
+                const r = upsertJsonAdapter(repoPath, MCP_JSON_SPEC, dryRun, now);
+                results.push({ agent: "claude", ...r });
+            }
+        }
+        else if (agent === "opencode") {
+            const r = upsertJsonAdapter(repoPath, OPENCODE_JSON_SPEC, dryRun, now);
+            results.push({ agent: "opencode", ...r });
+        }
+        else if (agent === "cursor") {
+            const r = upsertJsonAdapter(repoPath, CURSOR_JSON_SPEC, dryRun, now);
+            results.push({ agent: "cursor", ...r });
+        }
+    }
+    return results;
+}
+/** One line per adapter result, for `init`'s stderr summary. */
+export function formatAdapterResult(r) {
+    const verb = r.action === "created" ? "wrote" :
+        r.action === "updated" ? "updated" :
+            r.action === "unchanged" ? "unchanged" :
+                r.action === "dry-run" ? "[dry-run]" :
+                    "ERROR";
+    const backup = r.backupPath ? ` (backup: ${r.backupPath})` : "";
+    return `reposkein: [${r.agent}] ${verb} — ${r.message}${backup}`;
+}
+//# sourceMappingURL=agentAdapters.js.map

package/dist/cli/agentAdapters.js.map

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

package/dist/cli/ansi.d.ts

@@ -0,0 +1,24 @@
+/** Dependency-free ANSI styling for `reposkein-mcp stats` — raw escape codes,
+ *  no chalk/picocolors. Auto-disables when stdout isn't a TTY or `NO_COLOR`
+ *  is set (https://no-color.org), per the zero-infra/deterministic-tooling
+ *  convention: never assume a terminal, never require a dependency for a
+ *  cosmetic feature.
+ *
+ *  Colors: teal `#2DD4BF` ≈ ANSI 256 color 44 (`38;5;44`), amber ≈ 256 color
+ *  214 (`38;5;214`) — same palette as the project's README banners. Falls
+ *  back to the portable 16-color codes (36 cyan, 33 yellow) is intentionally
+ *  NOT done: 256-color support is effectively universal on anything that
+ *  reports `isTTY`, and matching the brand hex matters more here than
+ *  supporting truly ancient terminals for a purely cosmetic CLI report. */
+export declare function colorEnabled(stream?: {
+    isTTY?: boolean;
+}, env?: NodeJS.ProcessEnv): boolean;
+export interface Styler {
+    teal(s: string): string;
+    amber(s: string): string;
+    bold(s: string): string;
+    dim(s: string): string;
+}
+/** Returns the styling functions to use, given whether color is enabled —
+ *  callers pass `colorEnabled()`'s result so this stays pure/testable. */
+export declare function styler(enabled: boolean): Styler;

package/dist/cli/ansi.js

@@ -0,0 +1,40 @@
+/** Dependency-free ANSI styling for `reposkein-mcp stats` — raw escape codes,
+ *  no chalk/picocolors. Auto-disables when stdout isn't a TTY or `NO_COLOR`
+ *  is set (https://no-color.org), per the zero-infra/deterministic-tooling
+ *  convention: never assume a terminal, never require a dependency for a
+ *  cosmetic feature.
+ *
+ *  Colors: teal `#2DD4BF` ≈ ANSI 256 color 44 (`38;5;44`), amber ≈ 256 color
+ *  214 (`38;5;214`) — same palette as the project's README banners. Falls
+ *  back to the portable 16-color codes (36 cyan, 33 yellow) is intentionally
+ *  NOT done: 256-color support is effectively universal on anything that
+ *  reports `isTTY`, and matching the brand hex matters more here than
+ *  supporting truly ancient terminals for a purely cosmetic CLI report. */
+const RESET = "\x1b[0m";
+const BOLD = "\x1b[1m";
+const DIM = "\x1b[2m";
+const TEAL = "\x1b[38;5;44m";
+const AMBER = "\x1b[38;5;214m";
+export function colorEnabled(stream = process.stdout, env = process.env) {
+    if (env.NO_COLOR !== undefined)
+        return false;
+    return !!stream.isTTY;
+}
+const identity = {
+    teal: (s) => s,
+    amber: (s) => s,
+    bold: (s) => s,
+    dim: (s) => s,
+};
+const styled = {
+    teal: (s) => `${TEAL}${s}${RESET}`,
+    amber: (s) => `${AMBER}${s}${RESET}`,
+    bold: (s) => `${BOLD}${s}${RESET}`,
+    dim: (s) => `${DIM}${s}${RESET}`,
+};
+/** Returns the styling functions to use, given whether color is enabled —
+ *  callers pass `colorEnabled()`'s result so this stays pure/testable. */
+export function styler(enabled) {
+    return enabled ? styled : identity;
+}
+//# sourceMappingURL=ansi.js.map

package/dist/cli/ansi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.js","sourceRoot":"","sources":["../../src/cli/ansi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;2EAW2E;AAE3E,MAAM,KAAK,GAAG,SAAS,CAAC;AACxB,MAAM,IAAI,GAAG,SAAS,CAAC;AACvB,MAAM,GAAG,GAAG,SAAS,CAAC;AACtB,MAAM,IAAI,GAAG,eAAe,CAAC;AAC7B,MAAM,KAAK,GAAG,gBAAgB,CAAC;AAE/B,MAAM,UAAU,YAAY,CAAC,SAA8B,OAAO,CAAC,MAAM,EAAE,MAAyB,OAAO,CAAC,GAAG;IAC7G,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;AACxB,CAAC;AASD,MAAM,QAAQ,GAAW;IACvB,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACd,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACf,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACd,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,GAAW;IACrB,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,KAAK,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,KAAK,EAAE;IACpC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,KAAK,EAAE;IAClC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,KAAK,EAAE;CACjC,CAAC;AAEF;0EAC0E;AAC1E,MAAM,UAAU,MAAM,CAAC,OAAgB;IACrC,OAAO,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrC,CAAC"}

package/dist/cli/doctor.d.ts

@@ -1,3 +1,15 @@
+export interface DoctorPathResolution {
+    path: string;
+    /** Set when walk-down found 2+ candidate repos and neither an explicit
+     *  path nor REPOSKEIN_REPO_PATH picked one — `path` falls back to `cwd`
+     *  in this case so the caller can still print a real (failing) report. */
+    error?: string;
+}
+/** Resolves the repo path for `reposkein-mcp doctor [path]`: explicit arg >
+ *  REPOSKEIN_REPO_PATH > walk-up (nearest ancestor with .reposkein/) >
+ *  walk-down (workspace mode). Verifies doctor works from a subdirectory
+ *  cwd — the common case of running it somewhere other than the repo root. */
+export declare function resolveDoctorRepoPath(explicitPath: string | undefined, cwd: string, envRepoPath: string | undefined): DoctorPathResolution;
 export interface Check {
     id: string;
     label: string;
@@ -15,5 +27,25 @@ export interface DoctorReport {
  *  Does NOT check MCP host registration — a CLI can't see that; the
  *  reposkein-setup skill verifies reachability via a probe tool call. */
 export declare function runChecks(repoPath: string): Promise<DoctorReport>;
-/** Entry point for `reposkein-mcp doctor [path] [--json]`. Returns process exit code. */
-export declare function runDoctor(repoPath?: string, json?: boolean): Promise<number>;
+/** Check ids that `doctor --ci` treats as build-breaking even though they're
+ *  non-critical for interactive use (degrade gracefully for a human at the
+ *  keyboard, but should fail a CI job so drift gets caught before it's
+ *  merged): missing/foreign git hooks, a stale committed graph, and an
+ *  unsplit legacy `summaries.jsonl` (see docs/INSTALL.md §4.2 — every branch
+ *  that writes a summary would conflict on it). */
+export declare const CI_FAIL_IDS: Set<string>;
+/** Checks (by id) that `doctor --ci` additionally fails on, beyond the
+ *  normal critical-check gate. */
+export declare function ciFailingChecks(report: DoctorReport): Check[];
+export declare function renderDoctorReport(report: DoctorReport): string;
+export interface RunDoctorOptions {
+    json?: boolean;
+    /** `doctor --ci`: additionally fail (non-zero exit) when any CI_FAIL_IDS
+     *  check is non-ok, even though those checks are non-critical for
+     *  interactive use. Doesn't change what's printed — only the exit code. */
+    ci?: boolean;
+}
+/** Entry point for `reposkein-mcp doctor [path] [--json] [--ci]`. Returns the
+ *  process exit code. Accepts a bare boolean for `json` for backwards
+ *  compatibility with the pre-`--ci` call signature. */
+export declare function runDoctor(repoPath?: string, opts?: RunDoctorOptions | boolean): Promise<number>;

package/dist/cli/doctor.js

@@ -3,6 +3,27 @@ import { join } from "node:path";
 import { ensureIndexerBinary } from "../indexer/fetchBinary.js";
 import { spawnIndexer } from "../indexer/runIndexer.js";
 import { resolveRepoId } from "../store/repoId.js";
+import { resolveRepoPath } from "../store/resolveRepoPath.js";
+import { decisionChecks } from "./doctorDecisions.js";
+import { summaryChecks } from "./doctorSummaries.js";
+import { hooksCheck, graphStaleCheck } from "./doctorFreshness.js";
+/** Resolves the repo path for `reposkein-mcp doctor [path]`: explicit arg >
+ *  REPOSKEIN_REPO_PATH > walk-up (nearest ancestor with .reposkein/) >
+ *  walk-down (workspace mode). Verifies doctor works from a subdirectory
+ *  cwd — the common case of running it somewhere other than the repo root. */
+export function resolveDoctorRepoPath(explicitPath, cwd, envRepoPath) {
+    const resolution = resolveRepoPath({ cwd, envRepoPath, explicit: explicitPath });
+    if (resolution.repoPath)
+        return { path: resolution.repoPath };
+    if (resolution.candidates && resolution.candidates.length > 0) {
+        return {
+            path: cwd,
+            error: `multiple RepoSkein repos found under ${cwd}: ${resolution.candidates.join(", ")}. ` +
+                "Pass one explicitly: `reposkein-mcp doctor <path>` (or set REPOSKEIN_REPO_PATH).",
+        };
+    }
+    return { path: cwd };
+}
 /** Counts non-empty lines (≈ node count) without parsing every row. */
 function countLines(text) {
     let n = 0;
@@ -65,10 +86,30 @@ export async function runChecks(repoPath) {
         detail: repoId ?? "could not resolve a repo id",
         fix: repoId ? undefined : "set REPOSKEIN_REPO_PATH (or REPOSKEIN_REPO_ID) for the MCP server",
     });
+    // 4) Committed summary shards (all non-critical: degrade, don't block).
+    checks.push(...summaryChecks(repoPath));
+    // 5) Decision log validation (all non-critical: degrade, don't block).
+    checks.push(...decisionChecks(repoPath));
+    // 6) Git hooks installed + graph freshness (non-critical here; `doctor
+    //    --ci` promotes both to a failing exit code — see CI_FAIL_IDS below).
+    checks.push(hooksCheck(repoPath));
+    checks.push(graphStaleCheck(repoPath));
     const ok = checks.filter((c) => c.critical).every((c) => c.ok);
     return { repoPath, ok, checks };
 }
-function render(report) {
+/** Check ids that `doctor --ci` treats as build-breaking even though they're
+ *  non-critical for interactive use (degrade gracefully for a human at the
+ *  keyboard, but should fail a CI job so drift gets caught before it's
+ *  merged): missing/foreign git hooks, a stale committed graph, and an
+ *  unsplit legacy `summaries.jsonl` (see docs/INSTALL.md §4.2 — every branch
+ *  that writes a summary would conflict on it). */
+export const CI_FAIL_IDS = new Set(["hooks_installed", "graph_stale", "summaries_unsplit"]);
+/** Checks (by id) that `doctor --ci` additionally fails on, beyond the
+ *  normal critical-check gate. */
+export function ciFailingChecks(report) {
+    return report.checks.filter((c) => CI_FAIL_IDS.has(c.id) && !c.ok);
+}
+export function renderDoctorReport(report) {
     const lines = [`reposkein doctor — ${report.repoPath}`, ""];
     for (const c of report.checks) {
         lines.push(`${c.ok ? "✓" : "✗"} ${c.label}: ${c.detail}`);
@@ -80,13 +121,20 @@ function render(report) {
     lines.push("(Note: this checks prerequisites only. To confirm the MCP server is wired into your agent, ask it to call get_context_profile — see the reposkein-setup skill.)");
     return lines.join("\n");
 }
-/** Entry point for `reposkein-mcp doctor [path] [--json]`. Returns process exit code. */
-export async function runDoctor(repoPath = ".", json = false) {
+/** Entry point for `reposkein-mcp doctor [path] [--json] [--ci]`. Returns the
+ *  process exit code. Accepts a bare boolean for `json` for backwards
+ *  compatibility with the pre-`--ci` call signature. */
+export async function runDoctor(repoPath = ".", opts = {}) {
+    const { json = false, ci = false } = typeof opts === "boolean" ? { json: opts } : opts;
     const report = await runChecks(repoPath);
     if (json)
         console.log(JSON.stringify(report, null, 2));
     else
-        console.error(render(report));
-    return report.ok ? 0 : 1;
+        console.error(renderDoctorReport(report));
+    const ciFailures = ci ? ciFailingChecks(report) : [];
+    if (ci && ciFailures.length > 0 && !json) {
+        console.error(`\n--ci: failing on ${ciFailures.length} additional check(s): ${ciFailures.map((c) => c.id).join(", ")}`);
+    }
+    return report.ok && ciFailures.length === 0 ? 0 : 1;
 }
 //# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

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

package/dist/cli/doctorDecisions.d.ts

@@ -0,0 +1,5 @@
+import type { Check } from "./doctor.js";
+/** Decision-log validation for `reposkein-mcp doctor`. Every check is
+ *  non-critical (exit 0 with warnings): a damaged decision log must degrade,
+ *  not block the graph. Returns [] only when there is no decisions dir. */
+export declare function decisionChecks(repoPath: string): Check[];

package/dist/cli/doctorDecisions.js

@@ -0,0 +1,83 @@
+import { computeBodyHash, loadDecisionFiles, } from "../store/decisions.js";
+/** ~Zimmermann ceiling: past this many active records, recall quality and the
+ *  profile budget both degrade — time to deprecate/archive. */
+const ACTIVE_BUDGET = 100;
+const warn = (id, label, ok, detail, fix) => ({
+    id,
+    label,
+    ok,
+    critical: false, // decision-log problems degrade; they never block startup
+    detail,
+    fix: ok ? undefined : fix,
+});
+function findCycle(records) {
+    // DFS along supersedes edges, tracking the actual path so the report names
+    // exactly the cycle's members — not everything reachable along the way.
+    for (const start of records.keys()) {
+        const stack = [{ id: start, path: [start] }];
+        const visited = new Set();
+        while (stack.length > 0) {
+            const { id, path } = stack.pop();
+            for (const target of records.get(id)?.supersedes ?? []) {
+                if (target === start)
+                    return [...path, target];
+                if (!visited.has(target)) {
+                    visited.add(target);
+                    stack.push({ id: target, path: [...path, target] });
+                }
+            }
+        }
+    }
+    return null;
+}
+/** Decision-log validation for `reposkein-mcp doctor`. Every check is
+ *  non-critical (exit 0 with warnings): a damaged decision log must degrade,
+ *  not block the graph. Returns [] only when there is no decisions dir. */
+export function decisionChecks(repoPath) {
+    const entries = loadDecisionFiles(repoPath);
+    if (entries.length === 0)
+        return [];
+    const checks = [];
+    // 1) Every file parses.
+    const malformed = entries.filter((e) => e.record === null).map((e) => e.file);
+    checks.push(warn("decisions_parse", "decision files parse", malformed.length === 0, malformed.length === 0
+        ? `${entries.length} files`
+        : `malformed: ${malformed.join(", ")}`, "fix or remove the malformed files (git conflict markers are the usual cause)"));
+    const parsed = entries.filter((e) => e.record !== null);
+    // 2) No duplicate ids across files (cross-branch same-day same-slug merges).
+    const byId = new Map();
+    const dupes = new Set();
+    for (const { record } of parsed) {
+        if (byId.has(record.id))
+            dupes.add(record.id);
+        else
+            byId.set(record.id, record);
+    }
+    checks.push(warn("decisions_duplicates", "decision ids unique", dupes.size === 0, dupes.size === 0 ? `${byId.size} decisions` : `duplicate ids: ${[...dupes].join(", ")}`, "two branches minted the same id — keep one file per id (merge the bodies by hand if they differ)"));
+    // 3) Bodies unmodified since signing (immutability as invariant, not
+    //    convention — reaffirm/supersede re-sign, hand edits don't).
+    const tampered = parsed
+        .filter(({ record }) => record.body_hash !== computeBodyHash(record))
+        .map(({ record }) => record.id);
+    checks.push(warn("decisions_integrity", "decision bodies unmodified (body_hash)", tampered.length === 0, tampered.length === 0 ? "all bodies verify" : `hand-edited: ${tampered.join(", ")}`, "decision bodies are immutable — record a superseding decision instead of editing; revert the edit or re-record"));
+    // 4) Supersession references resolve, in both directions.
+    const dangling = [];
+    for (const rec of byId.values()) {
+        for (const sid of rec.supersedes) {
+            if (!byId.has(sid))
+                dangling.push(`${rec.id} → ${sid}`);
+        }
+        if (rec.superseded_by && !byId.has(rec.superseded_by)) {
+            dangling.push(`${rec.id} ← ${rec.superseded_by}`);
+        }
+    }
+    checks.push(warn("decisions_refs", "supersession references resolve", dangling.length === 0, dangling.length === 0 ? "no dangling references" : `dangling: ${dangling.join(", ")}`, "a referenced decision file is missing — restore it or correct the reference"));
+    // 5) No supersession cycles.
+    const cycle = findCycle(byId);
+    checks.push(warn("decisions_cycles", "supersession chain acyclic", cycle === null, cycle === null ? "no cycles" : `cycle: ${cycle.join(" → ")}`, "break the cycle — a decision cannot (transitively) supersede itself"));
+    // 6) Active-record budget.
+    const active = [...byId.values()].filter((r) => r.status === "accepted" || r.status === "proposed").length;
+    checks.push(warn("decisions_budget", `active decisions within budget (≤${ACTIVE_BUDGET})`, active <= ACTIVE_BUDGET, `${active} active records`, "the log is past the point where recall stays sharp — deprecate or supersede aged-out decisions"));
+    return checks;
+}
+//# sourceMappingURL=doctorDecisions.js.map

package/dist/cli/doctorDecisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctorDecisions.js","sourceRoot":"","sources":["../../src/cli/doctorDecisions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,iBAAiB,GAElB,MAAM,uBAAuB,CAAC;AAG/B;+DAC+D;AAC/D,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B,MAAM,IAAI,GAAG,CAAC,EAAU,EAAE,KAAa,EAAE,EAAW,EAAE,MAAc,EAAE,GAAY,EAAS,EAAE,CAAC,CAAC;IAC7F,EAAE;IACF,KAAK;IACL,EAAE;IACF,QAAQ,EAAE,KAAK,EAAE,0DAA0D;IAC3E,MAAM;IACN,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG;CAC1B,CAAC,CAAC;AAEH,SAAS,SAAS,CAAC,OAAoC;IACrD,2EAA2E;IAC3E,wEAAwE;IACxE,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACnC,MAAM,KAAK,GAAqC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/E,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;YAClC,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,UAAU,IAAI,EAAE,EAAE,CAAC;gBACvD,IAAI,MAAM,KAAK,KAAK;oBAAE,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;gBAC/C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;oBACzB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBACpB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;gBACtD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;2EAE2E;AAC3E,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,wBAAwB;IACxB,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9E,MAAM,CAAC,IAAI,CACT,IAAI,CACF,iBAAiB,EACjB,sBAAsB,EACtB,SAAS,CAAC,MAAM,KAAK,CAAC,EACtB,SAAS,CAAC,MAAM,KAAK,CAAC;QACpB,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,QAAQ;QAC3B,CAAC,CAAC,cAAc,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACxC,8EAA8E,CAC/E,CACF,CAAC;IAEF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAiD,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;IAEvG,6EAA6E;IAC7E,MAAM,IAAI,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC/C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;;YACzC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,CAAC,IAAI,CACT,IAAI,CACF,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,CAAC,IAAI,KAAK,CAAC,EAChB,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACvF,kGAAkG,CACnG,CACF,CAAC;IAEF,qEAAqE;IACrE,iEAAiE;IACjE,MAAM,QAAQ,GAAG,MAAM;SACpB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,KAAK,eAAe,CAAC,MAAM,CAAC,CAAC;SACpE,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,CAAC,IAAI,CACT,IAAI,CACF,qBAAqB,EACrB,wCAAwC,EACxC,QAAQ,CAAC,MAAM,KAAK,CAAC,EACrB,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,gBAAgB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACnF,gHAAgH,CACjH,CACF,CAAC;IAEF,0DAA0D;IAC1D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAChC,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,GAAG,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;YACtD,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IACD,MAAM,CAAC,IAAI,CACT,IAAI,CACF,gBAAgB,EAChB,iCAAiC,EACjC,QAAQ,CAAC,MAAM,KAAK,CAAC,EACrB,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,aAAa,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACrF,6EAA6E,CAC9E,CACF,CAAC;IAEF,6BAA6B;IAC7B,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,CAAC,IAAI,CACT,IAAI,CACF,kBAAkB,EAClB,4BAA4B,EAC5B,KAAK,KAAK,IAAI,EACd,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAC5D,qEAAqE,CACtE,CACF,CAAC;IAEF,2BAA2B;IAC3B,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CACtC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,CAC1D,CAAC,MAAM,CAAC;IACT,MAAM,CAAC,IAAI,CACT,IAAI,CACF,kBAAkB,EAClB,oCAAoC,aAAa,GAAG,EACpD,MAAM,IAAI,aAAa,EACvB,GAAG,MAAM,iBAAiB,EAC1B,gGAAgG,CACjG,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cli/doctorFreshness.d.ts

@@ -0,0 +1,43 @@
+import type { Check } from "./doctor.js";
+/** Non-critical by default: a repo can be perfectly usable without hooks
+ *  (an agent can always run `reposkein-mcp index` by hand). `doctor --ci`
+ *  promotes this id to a failing exit code — see CI_FAIL_IDS in doctor.ts. */
+export declare function hooksCheck(repoPath: string): Check;
+/** Content-based staleness: the committed graph is fresh iff the commit SHA
+ *  recorded the last time it was (re)built (`.reposkein/local/indexed-at` —
+ *  see mcp/src/store/indexedAt.ts) equals the current git HEAD. The marker
+ *  is kept current two ways: the installed git hooks maintain it on their
+ *  own (`post-commit` after every commit, `post-merge`/`post-checkout` —
+ *  which also re-index — after a merge/pull/branch switch), and
+ *  `reposkein-mcp index`/`init` write it directly. A mismatch therefore
+ *  means one of: the hooks were never installed (or were removed), or
+ *  nobody's indexed this repo at all yet.
+ *
+ *  Replaces an earlier mtime-based heuristic (mtime(nodes.jsonl) vs. the last
+ *  commit's timestamp) that turned out to be structurally blind after any
+ *  fresh checkout: `git clone`/`checkout` — or a CI cache restoring
+ *  `.reposkein/` from a prior run — stamps every file it writes with
+ *  "now", which is always ≥ any past commit's timestamp, so
+ *  `mtime < lastCommitMs` could never be true right when it mattered most.
+ *  A recorded SHA has no such blind spot: it's compared by value, not by
+ *  filesystem timestamp.
+ *
+ *  Deliberately a **plain SHA mismatch**, not a diff filtered to
+ *  indexed-language extensions: filtering would need to stay in sync with
+ *  `config.toml`'s `[languages] enabled` list and the indexer's own
+ *  extension→language table, which is one more thing to drift. The cost of
+ *  getting it wrong is asymmetric — a false "stale" just costs a redundant
+ *  `reposkein-mcp index` (cheap), while a false "fresh" is exactly the bug
+ *  being fixed — so the simpler, conservative rule wins here.
+ *
+ *  Two distinct failure shapes, both reported under the same check id:
+ *   - no recorded SHA at all → never indexed via a hook or the mcp-side path
+ *     (a fresh clone's local/ never carries over, since it's gitignored) —
+ *     FAIL.
+ *   - a recorded SHA that doesn't match HEAD → the hooks are missing (or
+ *     were bypassed, e.g. `git commit --no-verify`) and nobody's re-indexed
+ *     by hand either — FAIL.
+ *
+ *  Non-critical by default; `doctor --ci` promotes it (CI_FAIL_IDS in
+ *  doctor.ts). */
+export declare function graphStaleCheck(repoPath: string): Check;