reasonix 0.12.20 → 0.12.21

package/dist/cli/index.js

@@ -181,8 +181,8 @@ function computeWait(attempt, initial, cap, retryAfter) {
 }
 function sleep(ms, signal) {
   if (ms <= 0) return Promise.resolve();
-  return new Promise((resolve13, reject) => {
-    const timer = setTimeout(resolve13, ms);
+  return new Promise((resolve14, reject) => {
+    const timer = setTimeout(resolve14, ms);
     if (signal) {
       const onAbort = () => {
         clearTimeout(timer);
@@ -668,7 +668,7 @@ function matchesTool(hook, toolName) {
 }
 var HOOK_OUTPUT_CAP_BYTES = 256 * 1024;
 function defaultSpawner(input) {
-  return new Promise((resolve13) => {
+  return new Promise((resolve14) => {
     const child = spawn(input.command, {
       cwd: input.cwd,
       shell: true,
@@ -713,7 +713,7 @@ function defaultSpawner(input) {
     child.stderr.on("data", (chunk) => onChunk("stderr", chunk));
     child.once("error", (err) => {
       clearTimeout(timer);
-      resolve13({
+      resolve14({
         exitCode: null,
         stdout: Buffer.concat(stdoutChunks).toString("utf8"),
         stderr: Buffer.concat(stderrChunks).toString("utf8"),
@@ -724,7 +724,7 @@ function defaultSpawner(input) {
     });
     child.once("close", (code) => {
       clearTimeout(timer);
-      resolve13({
+      resolve14({
         exitCode: code,
         stdout: Buffer.concat(stdoutChunks).toString("utf8").trim(),
         stderr: Buffer.concat(stderrChunks).toString("utf8").trim(),
@@ -2646,8 +2646,8 @@ var CacheFirstLoop = class {
             }
           );
           for (let k = 0; k < budget2; k++) {
-            const sample = queue.shift() ?? await new Promise((resolve13) => {
-              waiter = resolve13;
+            const sample = queue.shift() ?? await new Promise((resolve14) => {
+              waiter = resolve14;
             });
             yield {
               turn: this._turn,
@@ -5444,7 +5444,7 @@ async function runCommand(cmd, opts) {
   };
   const { bin, args, spawnOverrides } = prepareSpawn(argv);
   const effectiveSpawnOpts = { ...spawnOpts, ...spawnOverrides };
-  return await new Promise((resolve13, reject) => {
+  return await new Promise((resolve14, reject) => {
     let child;
     try {
       child = spawn3(bin, args, effectiveSpawnOpts);
@@ -5489,7 +5489,7 @@ async function runCommand(cmd, opts) {
       const output = buf.length > maxChars ? `${buf.slice(0, maxChars)}
 
 [\u2026 truncated ${buf.length - maxChars} chars \u2026]` : buf;
-      resolve13({ exitCode: code, output, timedOut });
+      resolve14({ exitCode: code, output, timedOut });
     });
   });
 }
@@ -6832,7 +6832,7 @@ var McpClient = class {
     const id = this.nextId++;
     const frame = { jsonrpc: "2.0", id, method, params };
     let abortHandler = null;
-    const promise = new Promise((resolve13, reject) => {
+    const promise = new Promise((resolve14, reject) => {
       const timeout = setTimeout(() => {
         this.pending.delete(id);
         if (abortHandler && signal) signal.removeEventListener("abort", abortHandler);
@@ -6841,7 +6841,7 @@ var McpClient = class {
         );
       }, this.requestTimeoutMs);
       this.pending.set(id, {
-        resolve: resolve13,
+        resolve: resolve14,
         reject,
         timeout
       });
@@ -6964,12 +6964,12 @@ var StdioTransport = class {
   }
   async send(message) {
     if (this.closed) throw new Error("MCP transport is closed");
-    return new Promise((resolve13, reject) => {
+    return new Promise((resolve14, reject) => {
       const line = `${JSON.stringify(message)}
 `;
       this.child.stdin.write(line, "utf8", (err) => {
         if (err) reject(err);
-        else resolve13();
+        else resolve14();
       });
     });
   }
@@ -6980,8 +6980,8 @@ var StdioTransport = class {
         continue;
       }
       if (this.closed) return;
-      const next = await new Promise((resolve13) => {
-        this.waiters.push(resolve13);
+      const next = await new Promise((resolve14) => {
+        this.waiters.push(resolve14);
       });
       if (next === null) return;
       yield next;
@@ -7047,8 +7047,8 @@ var SseTransport = class {
   constructor(opts) {
     this.url = opts.url;
     this.headers = opts.headers ?? {};
-    this.endpointReady = new Promise((resolve13, reject) => {
-      this.resolveEndpoint = resolve13;
+    this.endpointReady = new Promise((resolve14, reject) => {
+      this.resolveEndpoint = resolve14;
       this.rejectEndpoint = reject;
     });
     this.endpointReady.catch(() => void 0);
@@ -7075,8 +7075,8 @@ var SseTransport = class {
         continue;
       }
       if (this.closed) return;
-      const next = await new Promise((resolve13) => {
-        this.waiters.push(resolve13);
+      const next = await new Promise((resolve14) => {
+        this.waiters.push(resolve14);
       });
       if (next === null) return;
       yield next;
@@ -7263,8 +7263,8 @@ var StreamableHttpTransport = class {
         continue;
       }
       if (this.closed) return;
-      const next = await new Promise((resolve13) => {
-        this.waiters.push(resolve13);
+      const next = await new Promise((resolve14) => {
+        this.waiters.push(resolve14);
       });
       if (next === null) return;
       yield next;
@@ -9732,7 +9732,7 @@ async function startOllamaDaemon(opts = {}) {
   return { ready: false, pid };
 }
 async function pullOllamaModel(modelName, opts = {}) {
-  return new Promise((resolve13) => {
+  return new Promise((resolve14) => {
     const child = spawn5("ollama", ["pull", modelName], {
       stdio: ["ignore", "pipe", "pipe"],
       windowsHide: true
@@ -9744,8 +9744,8 @@ async function pullOllamaModel(modelName, opts = {}) {
     }
     streamLines(child.stdout, (l) => opts.onLine?.(l, "stdout"));
     streamLines(child.stderr, (l) => opts.onLine?.(l, "stderr"));
-    child.once("exit", (code) => resolve13(code ?? -1));
-    child.once("error", () => resolve13(-1));
+    child.once("exit", (code) => resolve14(code ?? -1));
+    child.once("error", () => resolve14(-1));
   });
 }
 function streamLines(stream, cb) {
@@ -10590,7 +10590,7 @@ var MAX_BODY_BYTES = 256 * 1024;
 async function readBody(req) {
   let total = 0;
   const chunks = [];
-  return new Promise((resolve13, reject) => {
+  return new Promise((resolve14, reject) => {
     req.on("data", (chunk) => {
       total += chunk.length;
       if (total > MAX_BODY_BYTES) {
@@ -10600,7 +10600,7 @@ async function readBody(req) {
       }
       chunks.push(chunk);
     });
-    req.on("end", () => resolve13(Buffer.concat(chunks).toString("utf8")));
+    req.on("end", () => resolve14(Buffer.concat(chunks).toString("utf8")));
     req.on("error", reject);
   });
 }
@@ -10677,7 +10677,7 @@ function startDashboardServer(ctx, opts = {}) {
   const token = opts.token ?? mintToken();
   const host = opts.host ?? "127.0.0.1";
   const port = opts.port ?? 0;
-  return new Promise((resolve13, reject) => {
+  return new Promise((resolve14, reject) => {
     const server = createServer((req, res) => {
       dispatch(req, res, ctx, token).catch((err) => {
         if (!res.headersSent) {
@@ -10698,7 +10698,7 @@ function startDashboardServer(ctx, opts = {}) {
         server.close(() => doneResolve());
         setTimeout(() => server.closeAllConnections?.(), 1e3).unref();
       });
-      resolve13({ url, token, port: finalPort, close });
+      resolve14({ url, token, port: finalPort, close });
     });
   });
 }
@@ -11314,8 +11314,8 @@ function SelectRow({
   active,
   marker
 }) {
-  const color = item.disabled ? "gray" : active ? "cyan" : void 0;
-  return /* @__PURE__ */ React4.createElement(Box3, { flexDirection: "column" }, /* @__PURE__ */ React4.createElement(Box3, null, /* @__PURE__ */ React4.createElement(Text3, { color }, marker, " ", item.label)), item.hint ? /* @__PURE__ */ React4.createElement(Box3, { paddingLeft: marker.length + 1 }, /* @__PURE__ */ React4.createElement(Text3, { dimColor: true }, item.hint)) : null);
+  const color2 = item.disabled ? "gray" : active ? "cyan" : void 0;
+  return /* @__PURE__ */ React4.createElement(Box3, { flexDirection: "column" }, /* @__PURE__ */ React4.createElement(Box3, null, /* @__PURE__ */ React4.createElement(Text3, { color: color2 }, marker, " ", item.label)), item.hint ? /* @__PURE__ */ React4.createElement(Box3, { paddingLeft: marker.length + 1 }, /* @__PURE__ */ React4.createElement(Text3, { dimColor: true }, item.hint)) : null);
 }
 function findNextEnabled(items, from, step) {
   if (items.length === 0) return 0;
@@ -11530,13 +11530,13 @@ function EditConfirm({ block, onChoose }) {
     ) : null,
     /* @__PURE__ */ React6.createElement(Box5, { flexDirection: "column" }, visibleLines.map((line, i) => {
       const trimmed = line.trimStart();
-      const color = trimmed.startsWith("+") ? "#4ade80" : trimmed.startsWith("-") ? "#f87171" : void 0;
-      const dim = !color;
+      const color2 = trimmed.startsWith("+") ? "#4ade80" : trimmed.startsWith("-") ? "#f87171" : void 0;
+      const dim = !color2;
       return /* @__PURE__ */ React6.createElement(
         Text4,
         {
           key: `diff-${effectiveScroll}-${i}`,
-          color,
+          color: color2,
           dimColor: dim
         },
         line
@@ -11570,7 +11570,7 @@ function PlanStateBlock({ planState }) {
   if (planState.rejectedPaths.length)
     fields.push(["rejected", planState.rejectedPaths, "#94a3b8", true]);
   if (fields.length === 0) return null;
-  return /* @__PURE__ */ React7.createElement(Box6, { flexDirection: "column", marginBottom: 1 }, fields.map(([label, items, color, dim]) => /* @__PURE__ */ React7.createElement(Box6, { key: label }, /* @__PURE__ */ React7.createElement(Text5, { backgroundColor: color, color: "black", bold: true, dimColor: dim }, ` ${label} ${items.length} `), /* @__PURE__ */ React7.createElement(Text5, null, "  "), /* @__PURE__ */ React7.createElement(Text5, { dimColor: dim }, items.join(" \xB7 ")))));
+  return /* @__PURE__ */ React7.createElement(Box6, { flexDirection: "column", marginBottom: 1 }, fields.map(([label, items, color2, dim]) => /* @__PURE__ */ React7.createElement(Box6, { key: label }, /* @__PURE__ */ React7.createElement(Text5, { backgroundColor: color2, color: "black", bold: true, dimColor: dim }, ` ${label} ${items.length} `), /* @__PURE__ */ React7.createElement(Text5, null, "  "), /* @__PURE__ */ React7.createElement(Text5, { dimColor: dim }, items.join(" \xB7 ")))));
 }
 
 // src/cli/ui/PlanStepList.tsx
@@ -12481,8 +12481,8 @@ function gradientCells(width, glyph = GLYPH.block) {
     const t2 = width === 1 ? 0 : i * last / (width - 1);
     const lo = Math.floor(t2);
     const hi = Math.min(last, lo + 1);
-    const color = t2 - lo < 0.5 ? GRADIENT[lo] : GRADIENT[hi];
-    cells.push({ ch: glyph, color });
+    const color2 = t2 - lo < 0.5 ? GRADIENT[lo] : GRADIENT[hi];
+    cells.push({ ch: glyph, color: color2 });
   }
   return cells;
 }
@@ -12659,9 +12659,9 @@ var ROLE_GLYPH = {
 };
 function RoleGlyph({
   glyph,
-  color
+  color: color2
 }) {
-  return /* @__PURE__ */ React11.createElement(Text8, { color, bold: true }, glyph);
+  return /* @__PURE__ */ React11.createElement(Text8, { color: color2, bold: true }, glyph);
 }
 function ToolPill({ label, status: status2 }) {
   const bg = status2 === "err" ? "red" : "yellow";
@@ -14175,8 +14175,8 @@ function StatsPanel({
 }
 function BudgetRow({ spent, cap }) {
   const pct2 = Math.max(0, spent / cap * 100);
-  const color = pct2 >= 100 ? "#f87171" : pct2 >= 80 ? "#fbbf24" : "#94a3b8";
-  return /* @__PURE__ */ React21.createElement(Box19, null, /* @__PURE__ */ React21.createElement(Text17, { dimColor: true }, "  budget  "), /* @__PURE__ */ React21.createElement(Text17, { color }, `$${spent.toFixed(4)} / $${cap.toFixed(2)}`, /* @__PURE__ */ React21.createElement(Text17, { dimColor: true }, `  (${pct2.toFixed(0)}%)`)));
+  const color2 = pct2 >= 100 ? "#f87171" : pct2 >= 80 ? "#fbbf24" : "#94a3b8";
+  return /* @__PURE__ */ React21.createElement(Box19, null, /* @__PURE__ */ React21.createElement(Text17, { dimColor: true }, "  budget  "), /* @__PURE__ */ React21.createElement(Text17, { color: color2 }, `$${spent.toFixed(4)} / $${cap.toFixed(2)}`, /* @__PURE__ */ React21.createElement(Text17, { dimColor: true }, `  (${pct2.toFixed(0)}%)`)));
 }
 function Header({
   model: model2,
@@ -14246,9 +14246,9 @@ function ContextCell({
   if (promptTokens === 0) {
     return /* @__PURE__ */ React21.createElement(Text17, null, /* @__PURE__ */ React21.createElement(Text17, { color: COLOR.info, dimColor: true }, "\u25A3 ctx "), /* @__PURE__ */ React21.createElement(Text17, { dimColor: true }, "\u2014 (no turns yet)"));
   }
-  const color = ratio >= 0.8 ? COLOR.err : ratio >= 0.6 ? COLOR.warn : COLOR.ok;
+  const color2 = ratio >= 0.8 ? COLOR.err : ratio >= 0.6 ? COLOR.warn : COLOR.ok;
   const pct2 = Math.round(ratio * 100);
-  return /* @__PURE__ */ React21.createElement(Text17, null, /* @__PURE__ */ React21.createElement(Text17, { color: COLOR.info }, "\u25A3 ctx  "), /* @__PURE__ */ React21.createElement(Bar, { ratio, color, cells: showBar ? 14 : 10 }), /* @__PURE__ */ React21.createElement(Text17, null, " "), /* @__PURE__ */ React21.createElement(Text17, { color, bold: true }, formatTokens(promptTokens), "/", formatTokens(ctxMax)), /* @__PURE__ */ React21.createElement(Text17, { dimColor: true }, " (", pct2, "%)"), ratio >= 0.8 ? /* @__PURE__ */ React21.createElement(Text17, { color: COLOR.err, bold: true }, "  \xB7  /compact") : null);
+  return /* @__PURE__ */ React21.createElement(Text17, null, /* @__PURE__ */ React21.createElement(Text17, { color: COLOR.info }, "\u25A3 ctx  "), /* @__PURE__ */ React21.createElement(Bar, { ratio, color: color2, cells: showBar ? 14 : 10 }), /* @__PURE__ */ React21.createElement(Text17, null, " "), /* @__PURE__ */ React21.createElement(Text17, { color: color2, bold: true }, formatTokens(promptTokens), "/", formatTokens(ctxMax)), /* @__PURE__ */ React21.createElement(Text17, { dimColor: true }, " (", pct2, "%)"), ratio >= 0.8 ? /* @__PURE__ */ React21.createElement(Text17, { color: COLOR.err, bold: true }, "  \xB7  /compact") : null);
 }
 function CacheCell({
   hitRatio,
@@ -14262,8 +14262,8 @@ function CacheCell({
   if (coldStart) {
     return /* @__PURE__ */ React21.createElement(Text17, null, /* @__PURE__ */ React21.createElement(Text17, { color: COLOR.info, dimColor: true }, "\u232C cache "), /* @__PURE__ */ React21.createElement(Text17, { dimColor: true }, pct2, "% "), /* @__PURE__ */ React21.createElement(Text17, { dimColor: true, italic: true }, "(cold start)"));
   }
-  const color = hitRatio >= 0.7 ? COLOR.ok : hitRatio >= 0.4 ? COLOR.warn : COLOR.err;
-  return /* @__PURE__ */ React21.createElement(Text17, null, /* @__PURE__ */ React21.createElement(Text17, { color: COLOR.info }, "\u232C cache  "), /* @__PURE__ */ React21.createElement(Text17, { color, bold: true }, pct2, "%"));
+  const color2 = hitRatio >= 0.7 ? COLOR.ok : hitRatio >= 0.4 ? COLOR.warn : COLOR.err;
+  return /* @__PURE__ */ React21.createElement(Text17, null, /* @__PURE__ */ React21.createElement(Text17, { color: COLOR.info }, "\u232C cache  "), /* @__PURE__ */ React21.createElement(Text17, { color: color2, bold: true }, pct2, "%"));
 }
 function turnCostColor(cost) {
   if (cost <= 0) return void 0;
@@ -14289,16 +14289,16 @@ function CostCell({
   return /* @__PURE__ */ React21.createElement(Text17, null, /* @__PURE__ */ React21.createElement(Text17, { color: COLOR.info }, "\u25F4 turn  "), /* @__PURE__ */ React21.createElement(Text17, { color: turnColor, bold: !coldStart, dimColor: coldStart }, "$", summary.lastTurnCostUsd.toFixed(4)), /* @__PURE__ */ React21.createElement(Text17, { dimColor: true }, " \xB7 session "), /* @__PURE__ */ React21.createElement(Text17, { color: sessionColor, bold: !coldStart, dimColor: coldStart }, "$", summary.totalCostUsd.toFixed(4)));
 }
 function BalanceCell({ balance }) {
-  const color = balance.total < 1 ? COLOR.err : balance.total < 5 ? COLOR.warn : COLOR.ok;
-  return /* @__PURE__ */ React21.createElement(Text17, null, /* @__PURE__ */ React21.createElement(Text17, { color: COLOR.info }, "\u25D0 balance  "), /* @__PURE__ */ React21.createElement(Text17, { color, bold: true }, balance.currency === "USD" ? "$" : "", balance.total.toFixed(2), balance.currency !== "USD" ? ` ${balance.currency}` : ""));
+  const color2 = balance.total < 1 ? COLOR.err : balance.total < 5 ? COLOR.warn : COLOR.ok;
+  return /* @__PURE__ */ React21.createElement(Text17, null, /* @__PURE__ */ React21.createElement(Text17, { color: COLOR.info }, "\u25D0 balance  "), /* @__PURE__ */ React21.createElement(Text17, { color: color2, bold: true }, balance.currency === "USD" ? "$" : "", balance.total.toFixed(2), balance.currency !== "USD" ? ` ${balance.currency}` : ""));
 }
 function Bar({
   ratio,
-  color,
+  color: color2,
   cells = 14
 }) {
   const filled = Math.max(0, Math.min(cells, Math.round(ratio * cells)));
-  return /* @__PURE__ */ React21.createElement(Text17, null, /* @__PURE__ */ React21.createElement(Text17, { color }, "\u25B0".repeat(filled)), /* @__PURE__ */ React21.createElement(Text17, { dimColor: true }, "\u25B1".repeat(cells - filled)));
+  return /* @__PURE__ */ React21.createElement(Text17, null, /* @__PURE__ */ React21.createElement(Text17, { color: color2 }, "\u25B0".repeat(filled)), /* @__PURE__ */ React21.createElement(Text17, { dimColor: true }, "\u25B1".repeat(cells - filled)));
 }
 function formatTokens(n) {
   if (n < 1024) return String(n);
@@ -18224,11 +18224,11 @@ function App({
     if (key.escape && busy) {
       if (abortedThisTurn.current) return;
       abortedThisTurn.current = true;
-      const resolve13 = editReviewResolveRef.current;
-      if (resolve13) {
+      const resolve14 = editReviewResolveRef.current;
+      if (resolve14) {
         editReviewResolveRef.current = null;
         setPendingEditReview(null);
-        resolve13("reject");
+        resolve14("reject");
       }
       if (activeLoopRef.current) stopLoop();
       loop2.abort();
@@ -18694,11 +18694,11 @@ function App({
         handleStagedInputSubmitRef.current(text ?? "", { plan: plan2, mode: choice }).catch(() => void 0);
       },
       resolveEditReview: (choice) => {
-        const resolve13 = editReviewResolveRef.current;
-        if (resolve13) {
+        const resolve14 = editReviewResolveRef.current;
+        if (resolve14) {
           editReviewResolveRef.current = null;
           setPendingEditReview(null);
-          resolve13(choice);
+          resolve14(choice);
         }
       },
       resolveWorkspaceConfirm: (choice) => {
@@ -20224,10 +20224,10 @@ Continue executing from the next pending step. Call mark_step_complete after eac
       {
         block: pendingEditReview,
         onChoose: (choice) => {
-          const resolve13 = editReviewResolveRef.current;
-          if (resolve13) {
+          const resolve14 = editReviewResolveRef.current;
+          if (resolve14) {
             editReviewResolveRef.current = null;
-            resolve13(choice);
+            resolve14(choice);
           }
         }
       }
@@ -20626,8 +20626,8 @@ function CacheBadge({ usage }) {
   const total = hit + miss;
   if (total === 0) return null;
   const pct2 = hit / total * 100;
-  const color = pct2 >= 70 ? "green" : pct2 >= 40 ? "yellow" : "red";
-  return /* @__PURE__ */ React28.createElement(Text23, null, /* @__PURE__ */ React28.createElement(Text23, { dimColor: true }, "  \xB7 cache "), /* @__PURE__ */ React28.createElement(Text23, { color }, pct2.toFixed(1), "%"));
+  const color2 = pct2 >= 70 ? "green" : pct2 >= 40 ? "yellow" : "red";
+  return /* @__PURE__ */ React28.createElement(Text23, null, /* @__PURE__ */ React28.createElement(Text23, { dimColor: true }, "  \xB7 cache "), /* @__PURE__ */ React28.createElement(Text23, { color: color2 }, pct2.toFixed(1), "%"));
 }
 function truncate2(s, max) {
   return s.length <= max ? s : `${s.slice(0, max)}\u2026 (+${s.length - max} chars)`;
@@ -20750,8 +20750,313 @@ markdown report written to ${opts.mdPath}`);
   console.log(renderSummaryTable(report));
 }
 
+// src/cli/commands/doctor.ts
+import { existsSync as existsSync23, statSync as statSync14 } from "fs";
+import { homedir as homedir10 } from "os";
+import { dirname as dirname16, join as join21, resolve as resolve12 } from "path";
+var TTY = process.stdout.isTTY && process.env.TERM !== "dumb";
+function color(text, code) {
+  if (!TTY) return text;
+  return `\x1B[${code}m${text}\x1B[0m`;
+}
+function badge(level) {
+  if (level === "ok") return color("\u2713", "32");
+  if (level === "warn") return color("\u26A0", "33");
+  return color("\u2717", "31");
+}
+function tail4(s) {
+  return s.length <= 4 ? s : `\u2026${s.slice(-4)}`;
+}
+function fmtBytes(n) {
+  if (n < 1024) return `${n} B`;
+  if (n < 1024 * 1024) return `${(n / 1024).toFixed(1)} KB`;
+  return `${(n / 1024 / 1024).toFixed(1)} MB`;
+}
+async function checkApiKey() {
+  const fromEnv = process.env.DEEPSEEK_API_KEY;
+  if (fromEnv) {
+    return {
+      label: "api key      ",
+      level: "ok",
+      detail: `set via env DEEPSEEK_API_KEY (${tail4(fromEnv)})`
+    };
+  }
+  try {
+    const cfg = readConfig();
+    if (cfg.apiKey) {
+      return {
+        label: "api key      ",
+        level: "ok",
+        detail: `from ${defaultConfigPath()} (${tail4(cfg.apiKey)})`
+      };
+    }
+  } catch {
+  }
+  return {
+    label: "api key      ",
+    level: "fail",
+    detail: "not set \u2014 `reasonix setup` to save one, or export DEEPSEEK_API_KEY. Get a key at https://platform.deepseek.com/api_keys"
+  };
+}
+async function checkConfig() {
+  const path5 = defaultConfigPath();
+  if (!existsSync23(path5)) {
+    return {
+      label: "config       ",
+      level: "warn",
+      detail: "missing \u2014 running with library defaults. `reasonix setup` writes one."
+    };
+  }
+  try {
+    const cfg = readConfig(path5);
+    const parts = [];
+    if (cfg.preset) parts.push(`preset=${cfg.preset}`);
+    if (cfg.editMode) parts.push(`editMode=${cfg.editMode}`);
+    if (cfg.mcp && cfg.mcp.length > 0) parts.push(`mcp=${cfg.mcp.length}`);
+    return {
+      label: "config       ",
+      level: "ok",
+      detail: `${path5}${parts.length ? ` (${parts.join(", ")})` : ""}`
+    };
+  } catch (err) {
+    return {
+      label: "config       ",
+      level: "fail",
+      detail: `${path5} unreadable \u2014 ${err.message}`
+    };
+  }
+}
+async function checkApiReach() {
+  const key = process.env.DEEPSEEK_API_KEY ?? readConfig().apiKey;
+  if (!key) {
+    return {
+      label: "api reach    ",
+      level: "warn",
+      detail: "skipped \u2014 no api key to test with"
+    };
+  }
+  try {
+    const client = new DeepSeekClient({ apiKey: key });
+    const ctl = new AbortController();
+    const timer = setTimeout(() => ctl.abort(), 8e3);
+    let balance;
+    try {
+      balance = await client.getBalance({ signal: ctl.signal });
+    } finally {
+      clearTimeout(timer);
+    }
+    if (!balance) {
+      return {
+        label: "api reach    ",
+        level: "fail",
+        detail: "/user/balance returned null \u2014 auth failed or network blocked"
+      };
+    }
+    if (!balance.is_available) {
+      const info2 = balance.balance_infos[0];
+      return {
+        label: "api reach    ",
+        level: "warn",
+        detail: `account flagged not-available${info2 ? ` (${info2.total_balance} ${info2.currency})` : ""} \u2014 top up or check your dashboard`
+      };
+    }
+    const info = balance.balance_infos[0];
+    return {
+      label: "api reach    ",
+      level: "ok",
+      detail: info ? `/user/balance ok \u2014 ${info.total_balance} ${info.currency}` : "/user/balance ok"
+    };
+  } catch (err) {
+    return {
+      label: "api reach    ",
+      level: "fail",
+      detail: `${err.message}`
+    };
+  }
+}
+async function checkTokenizer() {
+  const candidates = [
+    join21(
+      dirname16(new URL(import.meta.url).pathname.replace(/^\/([A-Za-z]:)/, "$1")),
+      "..",
+      "..",
+      "..",
+      "data",
+      "deepseek-tokenizer.json.gz"
+    ),
+    join21(process.cwd(), "data", "deepseek-tokenizer.json.gz")
+  ];
+  for (const p of candidates) {
+    if (existsSync23(p)) {
+      try {
+        const stat2 = statSync14(p);
+        return {
+          label: "tokenizer    ",
+          level: "ok",
+          detail: `${p} (${fmtBytes(stat2.size)})`
+        };
+      } catch {
+      }
+    }
+  }
+  return {
+    label: "tokenizer    ",
+    level: "warn",
+    detail: "data/deepseek-tokenizer.json.gz not found \u2014 token counts will fall back to char heuristics"
+  };
+}
+async function checkSessions() {
+  try {
+    const list = listSessions();
+    if (list.length === 0) {
+      return {
+        label: "sessions     ",
+        level: "ok",
+        detail: "0 saved"
+      };
+    }
+    const totalBytes = list.reduce((s, e) => s + e.size, 0);
+    const oldest = list[list.length - 1];
+    const ageDays = Math.floor((Date.now() - oldest.mtime.getTime()) / (24 * 60 * 60 * 1e3));
+    const stale = list.filter(
+      (e) => Date.now() - e.mtime.getTime() >= 90 * 24 * 60 * 60 * 1e3
+    ).length;
+    const detail = `${list.length} saved \xB7 ${fmtBytes(totalBytes)} \xB7 oldest ${ageDays}d`;
+    if (stale > 0) {
+      return {
+        label: "sessions     ",
+        level: "warn",
+        detail: `${detail} \xB7 ${stale} idle \u226590d (run /prune-sessions)`
+      };
+    }
+    return { label: "sessions     ", level: "ok", detail };
+  } catch (err) {
+    return {
+      label: "sessions     ",
+      level: "warn",
+      detail: `cannot list \u2014 ${err.message}`
+    };
+  }
+}
+async function checkHooks(projectRoot) {
+  try {
+    const all = loadHooks({ projectRoot });
+    const global = all.filter((h) => h.scope === "global").length;
+    const project = all.filter((h) => h.scope === "project").length;
+    return {
+      label: "hooks        ",
+      level: "ok",
+      detail: `${global} global, ${project} project`
+    };
+  } catch (err) {
+    return {
+      label: "hooks        ",
+      level: "warn",
+      detail: `couldn't parse settings.json \u2014 ${err.message}`
+    };
+  }
+}
+async function checkOllama(projectRoot) {
+  let exists = false;
+  try {
+    exists = await indexExists(projectRoot);
+  } catch {
+  }
+  if (!exists) {
+    return {
+      label: "ollama       ",
+      level: "ok",
+      detail: "not in use (no semantic index built; `reasonix index` to enable)"
+    };
+  }
+  try {
+    const status2 = await checkOllamaStatus(process.env.REASONIX_EMBED_MODEL ?? "nomic-embed-text");
+    if (!status2.binaryFound) {
+      return {
+        label: "ollama       ",
+        level: "warn",
+        detail: "binary not on PATH \u2014 semantic_search will fail; install from https://ollama.com"
+      };
+    }
+    if (!status2.daemonRunning) {
+      return {
+        label: "ollama       ",
+        level: "warn",
+        detail: "daemon not running \u2014 `ollama serve` (or just call /semantic in TUI to auto-start)"
+      };
+    }
+    if (!status2.modelPulled) {
+      return {
+        label: "ollama       ",
+        level: "warn",
+        detail: `model ${status2.modelName} not pulled \u2014 \`ollama pull ${status2.modelName}\``
+      };
+    }
+    return {
+      label: "ollama       ",
+      level: "ok",
+      detail: `daemon up \xB7 model ${status2.modelName} ready`
+    };
+  } catch (err) {
+    return {
+      label: "ollama       ",
+      level: "warn",
+      detail: `probe failed \u2014 ${err.message}`
+    };
+  }
+}
+async function checkProject(projectRoot) {
+  const markers = [".git", "REASONIX.md", "package.json", "pyproject.toml", "Cargo.toml", "go.mod"];
+  const found = markers.filter((m) => existsSync23(join21(projectRoot, m)));
+  if (found.length === 0) {
+    return {
+      label: "project      ",
+      level: "warn",
+      detail: `${projectRoot} has none of: ${markers.slice(0, 3).join(", ")} \u2026 \u2014 \`reasonix code\` will still run, but @-mentions and project memory have nothing to anchor`
+    };
+  }
+  return {
+    label: "project      ",
+    level: "ok",
+    detail: `${projectRoot} (${found.join(", ")})`
+  };
+}
+async function doctorCommand() {
+  loadDotenv();
+  const projectRoot = resolve12(process.cwd());
+  console.log(`${color(`reasonix ${VERSION}  \xB7  doctor`, "1")}  (cwd: ${projectRoot})`);
+  console.log(`  home: ${homedir10()}`);
+  console.log("");
+  const checks = await Promise.all([
+    checkApiKey(),
+    checkConfig(),
+    checkApiReach(),
+    checkTokenizer(),
+    checkSessions(),
+    checkHooks(projectRoot),
+    checkOllama(projectRoot),
+    checkProject(projectRoot)
+  ]);
+  for (const c of checks) {
+    console.log(`  ${badge(c.level)}  ${c.label}  ${c.detail}`);
+  }
+  const ok = checks.filter((c) => c.level === "ok").length;
+  const warn = checks.filter((c) => c.level === "warn").length;
+  const fail = checks.filter((c) => c.level === "fail").length;
+  console.log("");
+  const summary = `${ok} ok \xB7 ${warn} warn \xB7 ${fail} fail`;
+  if (fail > 0) {
+    console.log(color(summary, "31"));
+    process.exit(1);
+  } else if (warn > 0) {
+    console.log(color(summary, "33"));
+  } else {
+    console.log(color(summary, "32"));
+  }
+}
+
 // src/cli/commands/index.ts
-import { resolve as resolve12 } from "path";
+import { resolve as resolve13 } from "path";
 
 // src/index/semantic/preflight.ts
 import { stdin as stdin2, stdout } from "process";
@@ -20825,7 +21130,7 @@ async function confirm(question, defaultYes) {
 
 // src/cli/commands/index.ts
 async function indexCommand(opts = {}) {
-  const root = resolve12(opts.dir ?? process.cwd());
+  const root = resolve13(opts.dir ?? process.cwd());
   const tty = process.stderr.isTTY === true && process.stdin.isTTY === true;
   const model2 = opts.model ?? process.env.REASONIX_EMBED_MODEL ?? "nomic-embed-text";
   const preflightOk = await ollamaPreflight({
@@ -21747,13 +22052,13 @@ function planUpdate(input) {
   };
 }
 function defaultSpawn(argv) {
-  return new Promise((resolve13, reject) => {
+  return new Promise((resolve14, reject) => {
     const child = spawn6(argv[0], argv.slice(1), {
       stdio: "inherit",
       shell: process.platform === "win32"
     });
     child.once("error", reject);
-    child.once("exit", (code) => resolve13(code ?? 1));
+    child.once("exit", (code) => resolve14(code ?? 1));
   });
 }
 async function updateCommand(opts = {}) {
@@ -22038,6 +22343,11 @@ program.command("stats [transcript]").description(
 ).action((transcript) => {
   statsCommand({ transcript });
 });
+program.command("doctor").description(
+  "One-command health check \u2014 API key, config, /user/balance reachability, tokenizer, sessions, hooks, Ollama (if used), project markers. Exit 1 on any fail; 0 on warn / clean."
+).action(async () => {
+  await doctorCommand();
+});
 program.command("sessions [name]").description("List saved chat sessions, or inspect one by name.").option("-v, --verbose", "Include system prompts + tool-call metadata when inspecting").action((name, opts) => {
   sessionsCommand({ name, verbose: !!opts.verbose });
 });