@reposkein/mcp 0.3.0 → 0.4.0

package/README.md

@@ -57,6 +57,8 @@ Then ask your agent *"what calls this function?"* or *"what breaks if I change X
 
 | Tool | What it does |
 | --- | --- |
+| `list_repos` | enumerate the repos discovered by resolution — path, name, cheap node/edge counts. One entry in single-repo mode; workspace mode lists every sibling repo found |
+| `select_repo` | set the session-active repo (by `path` or `name` from `list_repos`) for every repo-scoped tool below — how workspace mode resolves ambiguity, and how you switch repos without restarting the server |
 | `get_context_profile` | resolve a function/class → its caller/callee neighborhood as ready-to-read prose |
 | `semantic_find` | find where to start — rank functions/classes by meaning (lexical BM25F; optional pluggable embeddings), seeding `get_context_profile` |
 | `impact` | transitive callers of a function/class — split into impacted code vs covering tests — with counts and truncated flag |
@@ -71,6 +73,7 @@ Then ask your agent *"what calls this function?"* or *"what breaks if I change X
 - `reposkein-mcp init` — set up a repo (downloads the indexer, installs git hooks + the skill, builds the graph, prints an MCP config block).
 - `reposkein-mcp doctor` — health check (binary → index → MCP reachability).
 - `reposkein-mcp index` — rebuild the committed graph after big changes.
+- `reposkein-mcp stats [--last | --session <id> | --all] [--json]` — session usage report: calls by tool, top queried nodes/files, ADRs/summaries written, session duration, and an *estimated* context-tokens-saved-vs-grep number. See [Session usage stats](#session-usage-stats) below.
 - `reposkein-mcp view [path]` — open the **constellation viewer**: a local, read-only, zero-infra web app (bound to `127.0.0.1`) that renders the committed `.reposkein` graph as an interactive 3D astronomy-style map. `--export <dir>` instead writes a self-contained static site (works from `file://` or any static host). See the [viewer section in the main README](https://github.com/reposkein/reposkein#visualize-the-graph--the-constellation-viewer), or **[try the live demo](https://reposkein.github.io/reposkein/)** (RepoSkein viewing its own graph).
 
 ## How your agent uses it
@@ -92,11 +95,80 @@ npx skills add reposkein/reposkein --all
 
 (`reposkein-mcp init` already installs the navigation skill for Claude Code; this adds it to Cursor, Codex, and 70+ other agents.)
 
+## Session usage stats
+
+Every tool call is logged, server-side, as one JSONL line to
+`.reposkein/local/sessions/<session-id>.jsonl` under the repo the call
+touched — `{ts, tool, argsShape, resultBytes, nodeIds}`, never argument or
+result *values* (only argument key names — no code/user text ever lands on
+disk). Because logging happens in the server, this works for **any**
+MCP-capable agent (Claude Code, Cursor, Codex, …), not just one. It's
+zero-infra like everything else here: local-only, git-ignored (`local/`),
+never blocks or fails a tool call — a logging failure is always swallowed.
+Old sessions are pruned automatically (newest 50, or 30 days, whichever is
+stricter).
+
+```sh
+reposkein-mcp stats                 # last session, human-readable
+reposkein-mcp stats --all           # every retained session, combined
+reposkein-mcp stats --session <id>  # one specific session
+reposkein-mcp stats --json          # machine-readable
+```
+
+The report includes calls by tool, the top queried nodes/files, ADRs and
+semantic summaries written, session duration, and an **estimated**
+context-tokens-saved-vs-grep figure (using the ~8.4× mean token ratio
+measured in [`mcp/bench`](https://github.com/reposkein/reposkein/tree/main/mcp/bench) — always labeled an estimate, never claimed as measured).
+
+**Claude Code Stop-hook recipe** — print a session's stats the moment it ends, by adding to `.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          { "type": "command", "command": "reposkein-mcp stats --last" }
+        ]
+      }
+    ]
+  }
+}
+```
+
 ## Configuration
 
+### Repo resolution (zero-config)
+
+`REPOSKEIN_REPO_PATH` is optional — the server resolves the target repo from
+the process's working directory. Full precedence:
+
+1. **`select_repo`** — an MCP tool call that sets the session-active repo
+   (by `path` or `name` from `list_repos`) for every repo-scoped tool call
+   made afterward, for the rest of the connection. The only one of these
+   that's mutable at runtime — everything below it is fixed at server start.
+2. `REPOSKEIN_REPO_PATH`, if set.
+3. **Walk up:** the nearest ancestor of the cwd containing `.reposkein/`.
+4. **Walk down** (workspace mode, only tried when no ancestor has one): scans
+   the cwd's children and grandchildren (skipping `node_modules`, `.git`,
+   `target`, `dist`, `.worktrees`, `.claude`) for `.reposkein/` dirs. One hit
+   is used automatically; two or more leave the repo unresolved until a
+   `select_repo` call picks one — `list_repos` always enumerates every repo
+   the walk finds (plus a `REPOSKEIN_REPO_PATH` pin, if one is set and not
+   already among them), regardless of which one is currently active.
+
+If nothing resolves — or step 4 finds more than one repo and none has been
+`select_repo`'d — repo-scoped tools don't fail silently at startup: each call
+returns a structured error telling you what to run (`reposkein-mcp init`,
+`list_repos`/`select_repo`, or which `REPOSKEIN_REPO_PATH` to set — naming the
+candidates when ambiguous). `reposkein-mcp doctor` and `--help` never require
+a resolved repo. See `mcp/src/store/resolveRepoPath.ts` and
+`mcp/src/store/repoSession.ts`.
+
 | Env var | Purpose |
 | --- | --- |
-| `REPOSKEIN_REPO_PATH` | the repository the server operates on (required for repo-scoped tools) |
+| `REPOSKEIN_REPO_PATH` | pins the repository the server operates on — optional, see repo resolution above |
+| `REPOSKEIN_SESSION_ID` | override the session id used for `reposkein-mcp stats` logging (default: start-timestamp + pid) |
 | `REPOSKEIN_STORE` | `auto` (default) · `jsonl` (zero-infra) · `neo4j` |
 | `REPOSKEIN_INDEXER_BIN` | override the `reposkein-indexer` binary path (unsupported platforms) |
 | `NEO4J_URI` / `NEO4J_USER` / `NEO4J_PASSWORD` | optional Neo4j backend (large graphs / Cypher at scale) |

package/binary-digests.json

@@ -1,6 +1,6 @@
 {
-  "reposkein-indexer-darwin-arm64": "63426ed09bf4d530c7b76ee36c6740d7bd7a7be5cb97b5be6c629b4dbad2f68a",
-  "reposkein-indexer-linux-arm64": "5eafecd08c8e2b9b9969eb3d5ab50d818734fe7f121c18c91d7dd2662b93beb5",
-  "reposkein-indexer-linux-x64": "3d91beb9d43344065eb580c864ba894a361fb4ae3ec603999cb731af54adc6a5",
-  "reposkein-indexer-win32-x64.exe": "61ee6547ccac78f1fe648750835a88c7b457130d686992fcd9c49bfb2b1bddea"
+  "reposkein-indexer-darwin-arm64": "8d00be1abda687bb847b6bbd3340c1d53f20c69668d8b65029f0c52966e0b5e8",
+  "reposkein-indexer-linux-arm64": "19853d8d8fb9cf7530c1613ec5dc2e0c0b4036a3691f716fb67e055055dea4f7",
+  "reposkein-indexer-linux-x64": "d07e83f81da1c8668f17dfb12252199099ada5de9bc13c078a590f52abf3ca1e",
+  "reposkein-indexer-win32-x64.exe": "ccce3f03e6b50cec117ef9d33eb8040b9356e12dec0baf43d509bcc7fb63d0dd"
 }

package/dist/SKILL.md

@@ -14,8 +14,27 @@ calls — that you enrich with natural-language summaries just-in-time. Do NOT
 guess file dependencies, and do NOT explore the repo by directory listing or
 grep when the graph can answer structurally.
 
+The server resolves the target repo automatically from your working
+directory — no setup is required. If a tool call returns an error naming
+`list_repos`/`select_repo` or `REPOSKEIN_REPO_PATH`, do not abandon these
+tools and fall back to grep — the error is actionable:
+
+- **No repo found at all** — run `reposkein-mcp init` in the repo (if it has
+  no `.reposkein/` yet), or set `REPOSKEIN_REPO_PATH`.
+- **Multiple repos found (workspace mode)** — the error names the
+  candidates. Call `list_repos` to see them (path, name, node/edge counts),
+  then `select_repo` with one candidate's `path` or `name` — this sets the
+  active repo for the rest of the session, so you only do it once. Retry the
+  call that failed.
+
 ## Tools
 
+- **`list_repos`** / **`select_repo`** — only needed in workspace mode
+  (multiple sibling repos, no unambiguous default). `list_repos` enumerates
+  what was discovered; `select_repo` (a `path` or `name` from that list) sets
+  the active repo for every repo-scoped tool below, for the rest of the
+  session. Skip these in the common single-repo case — resolution just works.
+
 - **`semantic_find`** — **start here when you don't have a seed symbol.** Rank
   functions/classes/interfaces/enums by a lexical match (BM25F) over their
   qualified names, signatures, and committed summaries. Use for cold-start "where

package/dist/cli/agentAdapters.d.ts

@@ -0,0 +1,68 @@
+/** 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. */
+export type AgentId = "claude" | "opencode" | "cursor";
+export declare const ALL_AGENT_IDS: readonly AgentId[];
+export type AdapterAction = "created" | "updated" | "unchanged" | "dry-run" | "error";
+export interface AdapterResult {
+    agent: AgentId;
+    /** File this adapter wrote (or would write). For the "claude" adapter via
+     *  the CLI this is still `.mcp.json` — `claude mcp add -s project` writes
+     *  there under the hood. */
+    path: string;
+    action: AdapterAction;
+    /** Set only when an existing file was actually modified. */
+    backupPath?: string;
+    message: string;
+}
+export interface ExecResult {
+    status: number;
+    stdout: string;
+    stderr: string;
+}
+/** Injectable command runner — never throws (unlike execFileSync). Tests
+ *  inject a fake to avoid shelling out to a real `claude`/`opencode` CLI or
+ *  mutating a real project's MCP config. */
+export type Exec = (cmd: string, args: string[], opts: {
+    cwd: string;
+}) => ExecResult;
+export declare const defaultExec: Exec;
+/** 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 declare function detectAgents(repoPath: string, exec?: Exec): AgentId[];
+/** 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 declare function parseAgentsFlag(value: string): AgentId[];
+export interface WriteAgentConfigsOptions {
+    /** Explicit `--agents` override — write exactly these, skipping detection. */
+    agents?: AgentId[];
+    dryRun?: boolean;
+    /** Injectable for tests. */
+    exec?: Exec;
+    now?: () => Date;
+}
+/** 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 declare function writeAgentConfigs(repoPath: string, opts?: WriteAgentConfigsOptions): AdapterResult[];
+/** One line per adapter result, for `init`'s stderr summary. */
+export declare function formatAdapterResult(r: AdapterResult): string;

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,7 +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;
@@ -66,12 +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) Decision log validation (all non-critical: degrade, don't block).
+    // 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}`);
@@ -83,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