reasonix 0.12.19 → 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);
@@ -548,8 +548,8 @@ var defaultSelector = (samples) => {
   })[0];
 };
 async function runBranches(client, request, opts = {}) {
-  const budget = Math.max(1, opts.budget ?? 1);
-  const temperatures = resolveTemperatures(budget, opts.temperatures);
+  const budget2 = Math.max(1, opts.budget ?? 1);
+  const temperatures = resolveTemperatures(budget2, opts.temperatures);
   const selector = opts.selector ?? defaultSelector;
   const samples = await Promise.all(
     temperatures.map(async (temperature, index) => {
@@ -586,12 +586,12 @@ function aggregateBranchUsage(samples) {
     promptCacheMissTokens
   };
 }
-function resolveTemperatures(budget, custom) {
-  if (custom && custom.length >= budget) return [...custom.slice(0, budget)];
-  if (budget === 1) return [0];
+function resolveTemperatures(budget2, custom) {
+  if (custom && custom.length >= budget2) return [...custom.slice(0, budget2)];
+  if (budget2 === 1) return [0];
   const out = [];
-  for (let i = 0; i < budget; i++) {
-    out.push(Number((i / (budget - 1)).toFixed(2)));
+  for (let i = 0; i < budget2; i++) {
+    out.push(Number((i / (budget2 - 1)).toFixed(2)));
   }
   return out;
 }
@@ -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(),
@@ -1276,29 +1276,29 @@ function truncateForModelByTokens(s, maxTokens) {
 
 ${tail}`;
 }
-function sizePrefixToTokens(s, budget) {
-  if (budget <= 0 || s.length === 0) return "";
-  let size = Math.min(s.length, budget * 4);
+function sizePrefixToTokens(s, budget2) {
+  if (budget2 <= 0 || s.length === 0) return "";
+  let size = Math.min(s.length, budget2 * 4);
   for (let iter = 0; iter < 6; iter++) {
     if (size <= 0) return "";
     const slice = s.slice(0, size);
     const count = countTokens(slice);
-    if (count <= budget) return slice;
-    const next = Math.floor(size * (budget / count) * 0.95);
+    if (count <= budget2) return slice;
+    const next = Math.floor(size * (budget2 / count) * 0.95);
     if (next >= size) return s.slice(0, Math.max(0, size - 1));
     size = next;
   }
   return s.slice(0, Math.max(0, size));
 }
-function sizeSuffixToTokens(s, budget) {
-  if (budget <= 0 || s.length === 0) return "";
-  let size = Math.min(s.length, budget * 4);
+function sizeSuffixToTokens(s, budget2) {
+  if (budget2 <= 0 || s.length === 0) return "";
+  let size = Math.min(s.length, budget2 * 4);
   for (let iter = 0; iter < 6; iter++) {
     if (size <= 0) return "";
     const slice = s.slice(-size);
     const count = countTokens(slice);
-    if (count <= budget) return slice;
-    const next = Math.floor(size * (budget / count) * 0.95);
+    if (count <= budget2) return slice;
+    const next = Math.floor(size * (budget2 / count) * 0.95);
     if (next >= size) return s.slice(-Math.max(0, size - 1));
     size = next;
   }
@@ -1999,6 +1999,19 @@ var CacheFirstLoop = class {
    * flip it live alongside `model`.
    */
   autoEscalate = true;
+  /**
+   * Soft USD budget — see {@link CacheFirstLoopOptions.budgetUsd}.
+   * Mutable so `/budget` slash can set / change / clear it mid-session.
+   * `null` (the default) disables all budget checks.
+   */
+  budgetUsd;
+  /**
+   * Set the first time a turn crosses 80% of the budget so the warning
+   * doesn't repeat every turn afterwards. Cleared by `setBudget` (any
+   * change re-arms the warning, including raising the cap above the
+   * current spend).
+   */
+  _budgetWarned = false;
   sessionName;
   /**
    * Hook list, mutable so `/hooks reload` can swap it without
@@ -2064,6 +2077,7 @@ var CacheFirstLoop = class {
     this.model = opts.model ?? "deepseek-v4-flash";
     this.reasoningEffort = opts.reasoningEffort ?? "max";
     if (opts.autoEscalate !== void 0) this.autoEscalate = opts.autoEscalate;
+    this.budgetUsd = typeof opts.budgetUsd === "number" && opts.budgetUsd > 0 ? opts.budgetUsd : null;
     this.maxToolIters = opts.maxToolIters ?? 64;
     this.hooks = opts.hooks ?? [];
     this.hookCwd = opts.hookCwd ?? process.cwd();
@@ -2303,6 +2317,16 @@ var CacheFirstLoop = class {
     }
     this.stream = this.branchEnabled ? false : this._streamPreference;
   }
+  /**
+   * Set / change / clear the soft USD budget. `null` (or any non-
+   * positive number) disables the cap entirely. Re-arms the 80%
+   * warning so a user who bumps the cap mid-session sees a fresh
+   * threshold message at the new boundary.
+   */
+  setBudget(usd) {
+    this.budgetUsd = typeof usd === "number" && usd > 0 ? usd : null;
+    this._budgetWarned = false;
+  }
   /**
    * Arm pro for the next turn (consumed at turn start). Called by
    * `/pro`. Idempotent — repeated calls stay armed, `disarmPro()`
@@ -2464,6 +2488,26 @@ var CacheFirstLoop = class {
     return userText;
   }
   async *step(userInput) {
+    if (this.budgetUsd !== null) {
+      const spent = this.stats.totalCost;
+      if (spent >= this.budgetUsd) {
+        yield {
+          turn: this._turn,
+          role: "error",
+          content: "",
+          error: `session budget exhausted \u2014 spent $${spent.toFixed(4)} \u2265 cap $${this.budgetUsd.toFixed(2)}. Bump the cap with /budget <usd>, clear it with /budget off, or end the session.`
+        };
+        return;
+      }
+      if (!this._budgetWarned && spent >= this.budgetUsd * 0.8) {
+        this._budgetWarned = true;
+        yield {
+          turn: this._turn,
+          role: "warning",
+          content: `\u25B2 budget 80% used \u2014 $${spent.toFixed(4)} of $${this.budgetUsd.toFixed(2)}. Next turn or two likely trips the cap.`
+        };
+      }
+    }
     this._turn++;
     this.scratch.reset();
     this.repair.resetStorm();
@@ -2560,14 +2604,14 @@ var CacheFirstLoop = class {
       let preHarvestedPlanState;
       try {
         if (this.branchEnabled) {
-          const budget = this.branchOptions.budget ?? 1;
+          const budget2 = this.branchOptions.budget ?? 1;
           yield {
             turn: this._turn,
             role: "branch_start",
             content: "",
             branchProgress: {
               completed: 0,
-              total: budget,
+              total: budget2,
               latestIndex: -1,
               latestTemperature: -1,
               latestUncertainties: -1
@@ -2601,9 +2645,9 @@ var CacheFirstLoop = class {
               onSampleDone
             }
           );
-          for (let k = 0; k < budget; k++) {
-            const sample = queue.shift() ?? await new Promise((resolve13) => {
-              waiter = resolve13;
+          for (let k = 0; k < budget2; k++) {
+            const sample = queue.shift() ?? await new Promise((resolve14) => {
+              waiter = resolve14;
             });
             yield {
               turn: this._turn,
@@ -2611,7 +2655,7 @@ var CacheFirstLoop = class {
               content: "",
               branchProgress: {
                 completed: k + 1,
-                total: budget,
+                total: budget2,
                 latestIndex: sample.index,
                 latestTemperature: sample.temperature,
                 latestUncertainties: sample.planState.uncertainties.length
@@ -5400,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);
@@ -5445,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 });
     });
   });
 }
@@ -6788,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);
@@ -6797,7 +6841,7 @@ var McpClient = class {
         );
       }, this.requestTimeoutMs);
       this.pending.set(id, {
-        resolve: resolve13,
+        resolve: resolve14,
         reject,
         timeout
       });
@@ -6920,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();
       });
     });
   }
@@ -6936,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;
@@ -7003,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);
@@ -7031,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;
@@ -7219,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;
@@ -9688,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
@@ -9700,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) {
@@ -10546,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) {
@@ -10556,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);
   });
 }
@@ -10633,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) {
@@ -10654,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 });
     });
   });
 }
@@ -11270,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;
@@ -11401,13 +11445,13 @@ var MIN_DIFF_ROWS = 8;
 function EditConfirm({ block, onChoose }) {
   const { stdout: stdout3 } = useStdout2();
   const rows = stdout3?.rows ?? 40;
-  const budget = Math.max(MIN_DIFF_ROWS, rows - MODAL_OVERHEAD_ROWS);
+  const budget2 = Math.max(MIN_DIFF_ROWS, rows - MODAL_OVERHEAD_ROWS);
   const allLines = useMemo(
     () => formatEditBlockDiff(block, { contextLines: 2, maxLines: 1e5, indent: "  " }),
     [block]
   );
   const [scroll, setScroll] = useState2(0);
-  const maxScroll = Math.max(0, allLines.length - budget);
+  const maxScroll = Math.max(0, allLines.length - budget2);
   const effectiveScroll = Math.min(scroll, maxScroll);
   useKeystroke((ev) => {
     if (ev.paste) return;
@@ -11438,11 +11482,11 @@ function EditConfirm({ block, onChoose }) {
       return;
     }
     if (key.pageDown || input === " " || input === "f") {
-      setScroll((s) => Math.min(maxScroll, s + Math.max(1, budget - 2)));
+      setScroll((s) => Math.min(maxScroll, s + Math.max(1, budget2 - 2)));
       return;
     }
     if (key.pageUp || input === "b") {
-      setScroll((s) => Math.max(0, s - Math.max(1, budget - 2)));
+      setScroll((s) => Math.max(0, s - Math.max(1, budget2 - 2)));
       return;
     }
     if (input === "g") {
@@ -11458,9 +11502,9 @@ function EditConfirm({ block, onChoose }) {
   const removed = isNew ? 0 : (block.search.match(/\n/g)?.length ?? 0) + 1;
   const added = block.replace === "" ? 0 : (block.replace.match(/\n/g)?.length ?? 0) + 1;
   const tag = isNew ? "NEW" : "EDIT";
-  const visibleLines = allLines.slice(effectiveScroll, effectiveScroll + budget);
+  const visibleLines = allLines.slice(effectiveScroll, effectiveScroll + budget2);
   const hiddenAbove = effectiveScroll;
-  const hiddenBelow = Math.max(0, allLines.length - effectiveScroll - budget);
+  const hiddenBelow = Math.max(0, allLines.length - effectiveScroll - budget2);
   const totalLines = allLines.length;
   const showScrollHud = hiddenAbove + hiddenBelow > 0;
   const subtitleParts = [`-${removed} +${added} lines`];
@@ -11486,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
@@ -11526,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
@@ -12437,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;
 }
@@ -12615,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";
@@ -13547,13 +13591,13 @@ function buildViewport(line, cursorCol, visibleCells, pastes) {
   return clipAroundCursor(line, cursorCol, visibleCells, pastes);
 }
 function clipFromLeft(line, visibleCells, pastes) {
-  const budget = Math.max(1, visibleCells - 1);
+  const budget2 = Math.max(1, visibleCells - 1);
   let used = 0;
   let end = 0;
   while (end < line.length) {
     const ch = line[end];
     const cw = charCellsAt(line, end, pastes);
-    if (used + cw > budget) break;
+    if (used + cw > budget2) break;
     used += cw;
     end++;
   }
@@ -13561,10 +13605,10 @@ function clipFromLeft(line, visibleCells, pastes) {
   return { segments, cursorCell: null, hiddenLeft: false, hiddenRight: end < line.length };
 }
 function clipAroundCursor(line, cursorCol, visibleCells, pastes) {
-  let budget = visibleCells;
+  let budget2 = visibleCells;
   const reservedForMarkers = 2;
-  budget = Math.max(1, budget - reservedForMarkers);
-  const halfBudget = Math.floor(budget / 2);
+  budget2 = Math.max(1, budget2 - reservedForMarkers);
+  const halfBudget = Math.floor(budget2 / 2);
   let start = cursorCol;
   let leftCells = 0;
   while (start > 0 && leftCells < halfBudget) {
@@ -13573,7 +13617,7 @@ function clipAroundCursor(line, cursorCol, visibleCells, pastes) {
     start--;
     leftCells += cw;
   }
-  const rightBudget = budget - leftCells;
+  const rightBudget = budget2 - leftCells;
   let end = cursorCol;
   let rightCells = 0;
   const cursorChar = cursorCol < line.length ? charCellsAt(line, cursorCol, pastes) : 1;
@@ -14080,7 +14124,8 @@ function StatsPanel({
   busy,
   proArmed,
   escalated,
-  dashboardUrl
+  dashboardUrl,
+  budgetUsd
 }) {
   const branchOn = (branchBudget ?? 1) > 1;
   const ctxMax = DEEPSEEK_CONTEXT_TOKENS[model2] ?? DEFAULT_CONTEXT_TOKENS;
@@ -14126,7 +14171,12 @@ function StatsPanel({
       balance,
       coldStart
     }
-  ));
+  ), budgetUsd !== null && budgetUsd !== void 0 ? /* @__PURE__ */ React21.createElement(BudgetRow, { spent: summary.totalCostUsd, cap: budgetUsd }) : null);
+}
+function BudgetRow({ spent, cap }) {
+  const pct2 = Math.max(0, spent / cap * 100);
+  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,
@@ -14196,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,
@@ -14212,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;
@@ -14239,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);
@@ -14828,6 +14878,12 @@ var SLASH_COMMANDS = [
     summary: "arm v4-pro for the NEXT turn only (one-shot \xB7 auto-disarms after turn)",
     argCompleter: ["off"]
   },
+  {
+    cmd: "budget",
+    argsHint: "[usd|off]",
+    summary: "session USD cap \u2014 warns at 80%, refuses next turn at 100%. Off by default. /budget alone shows status",
+    argCompleter: ["off", "1", "5", "10", "20", "50"]
+  },
   { cmd: "mcp", summary: "list MCP servers + tools attached to this session" },
   {
     cmd: "resource",
@@ -16317,6 +16373,42 @@ var pro = (args, loop2, ctx) => {
   };
 };
 var ESCALATION_MODEL_ID = "deepseek-v4-pro";
+var budget = (args, loop2) => {
+  const arg = args[0]?.trim() ?? "";
+  if (arg === "") {
+    if (loop2.budgetUsd === null) {
+      return {
+        info: "no session budget set \u2014 Reasonix will keep going until you stop it. Set one with: /budget <usd>   (e.g. /budget 5)"
+      };
+    }
+    const spent2 = loop2.stats.totalCost;
+    const pct2 = spent2 / loop2.budgetUsd * 100;
+    return {
+      info: `budget: $${spent2.toFixed(4)} of $${loop2.budgetUsd.toFixed(2)} (${pct2.toFixed(1)}%) \xB7 /budget off to clear, /budget <usd> to change`
+    };
+  }
+  if (arg === "off" || arg === "none" || arg === "0") {
+    loop2.setBudget(null);
+    return { info: "budget \u2192 off (no cap)" };
+  }
+  const cleaned = arg.replace(/^\$/, "");
+  const usd = Number(cleaned);
+  if (!Number.isFinite(usd) || usd <= 0) {
+    return {
+      info: `usage: /budget <usd>   (got "${arg}" \u2014 must be a positive number, e.g. /budget 5 or /budget 12.50)`
+    };
+  }
+  loop2.setBudget(usd);
+  const spent = loop2.stats.totalCost;
+  if (spent >= usd) {
+    return {
+      info: `\u25B2 budget \u2192 $${usd.toFixed(2)} but already spent $${spent.toFixed(4)}. Next turn will be refused \u2014 bump the cap higher to keep going, or end the session.`
+    };
+  }
+  return {
+    info: `budget \u2192 $${usd.toFixed(2)}  (so far: $${spent.toFixed(4)} \xB7 warns at 80%, refuses next turn at 100% \xB7 /budget off to clear)`
+  };
+};
 var handlers9 = {
   model,
   models,
@@ -16324,7 +16416,8 @@ var handlers9 = {
   preset,
   branch,
   effort,
-  pro
+  pro,
+  budget
 };
 
 // src/cli/ui/slash/handlers/observability.ts
@@ -17577,6 +17670,7 @@ function App({
   transcript,
   harvest: harvest3,
   branch: branch2,
+  budgetUsd,
   session,
   tools,
   mcpSpecs,
@@ -17790,6 +17884,7 @@ function App({
       model: model2,
       harvest: harvest3,
       branch: branch2,
+      budgetUsd,
       session,
       hooks: hookList,
       hookCwd: currentRootDir,
@@ -17800,7 +17895,7 @@ function App({
     });
     loopRef.current = l;
     return l;
-  }, [model2, system, harvest3, branch2, session, tools, codeMode]);
+  }, [model2, system, harvest3, branch2, budgetUsd, session, tools, codeMode]);
   useEffect6(() => {
     loop2.hooks = hookList;
   }, [loop2, hookList]);
@@ -18129,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();
@@ -18599,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) => {
@@ -20045,7 +20140,8 @@ Continue executing from the next pending step. Call mark_step_complete after eac
         updateAvailable,
         proArmed,
         escalated: turnOnPro,
-        dashboardUrl
+        dashboardUrl,
+        budgetUsd: loop2.budgetUsd
       }
     ), /* @__PURE__ */ React24.createElement(Static, { items: historical }, (item) => /* @__PURE__ */ React24.createElement(EventRow, { key: item.id, event: item, projectRoot: currentRootDir })), !historical.some((e) => e.role === "user" || e.role === "assistant") && !busy && !streaming ? /* @__PURE__ */ React24.createElement(WelcomeBanner, { inCodeMode: !!codeMode }) : null, !PLAIN_UI && !pendingShell && !pendingWorkspace && !pendingPlan && !stagedInput && !pendingEditReview && !pendingCheckpoint && !stagedCheckpointRevise && streaming ? /* @__PURE__ */ React24.createElement(Box22, { marginY: 1 }, /* @__PURE__ */ React24.createElement(EventRow, { event: streaming, projectRoot: currentRootDir })) : null, !PLAIN_UI && !pendingShell && !pendingWorkspace && !pendingPlan && !stagedInput && !pendingEditReview && !pendingCheckpoint && !stagedCheckpointRevise && ongoingTool ? /* @__PURE__ */ React24.createElement(OngoingToolRow, { tool: ongoingTool, progress: toolProgress }) : null, !PLAIN_UI && !pendingShell && !pendingWorkspace && !pendingPlan && !stagedInput && !pendingEditReview && !pendingCheckpoint && !stagedCheckpointRevise && subagentActivity ? /* @__PURE__ */ React24.createElement(SubagentRow, { activity: subagentActivity }) : null, !PLAIN_UI && !pendingShell && !pendingWorkspace && !pendingPlan && !stagedInput && !pendingEditReview && !pendingCheckpoint && !stagedCheckpointRevise && !ongoingTool && statusLine ? /* @__PURE__ */ React24.createElement(StatusRow, { text: statusLine }) : null, !PLAIN_UI && undoBanner && !pendingShell && !pendingWorkspace && !pendingPlan && !stagedInput && !pendingEditReview && !pendingCheckpoint && !stagedCheckpointRevise && !pendingChoice && !stagedChoiceCustom && !pendingRevision ? /* @__PURE__ */ React24.createElement(UndoBanner, { banner: undoBanner }) : null, !PLAIN_UI && !pendingShell && !pendingWorkspace && !pendingPlan && !stagedInput && !pendingEditReview && !pendingCheckpoint && !stagedCheckpointRevise && busy && !streaming && !ongoingTool && !statusLine ? /* @__PURE__ */ React24.createElement(StatusRow, { text: "processing\u2026" }) : null, stagedInput ? /* @__PURE__ */ React24.createElement(
       PlanRefineInput,
@@ -20128,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);
           }
         }
       }
@@ -20316,6 +20412,7 @@ function Root({
       transcript: appProps.transcript,
       harvest: appProps.harvest,
       branch: appProps.branch,
+      budgetUsd: appProps.budgetUsd,
       session: appProps.session,
       tools,
       mcpSpecs,
@@ -20477,6 +20574,7 @@ async function codeCommand(opts = {}) {
   await chatCommand({
     model: opts.model ?? "deepseek-v4-flash",
     harvest: opts.harvest ?? false,
+    budgetUsd: opts.budgetUsd,
     system: codeSystemPrompt2(rootDir, { hasSemanticSearch: semantic2.enabled }),
     transcript: opts.transcript,
     session,
@@ -20528,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)`;
@@ -20652,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";
@@ -20727,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({
@@ -21213,7 +21616,8 @@ async function runCommand2(opts) {
     tools,
     model: opts.model,
     harvest: opts.harvest,
-    branch: opts.branch
+    branch: opts.branch,
+    budgetUsd: opts.budgetUsd
   });
   const prefixHash = prefix.fingerprint;
   let transcriptStream = null;
@@ -21648,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 = {}) {
@@ -21769,6 +22173,17 @@ Your training data has a cutoff. When an answer's correctness depends on somethi
 The signal isn't a topic list \u2014 it's: "if I'm wrong about this, is it because reality moved on?". If yes, ground the answer in fresh evidence; if no (definitions, mechanisms, well-established APIs), answer from memory.
 
 ${ESCALATION_CONTRACT}`;
+function parseBudgetFlag(raw) {
+  if (raw === void 0) return void 0;
+  if (!Number.isFinite(raw) || raw <= 0) {
+    process.stderr.write(
+      `\u25B2 ignoring --budget=${raw} (must be a positive number) \u2014 running with no cap
+`
+    );
+    return void 0;
+  }
+  return raw;
+}
 var program = new Command();
 program.name("reasonix").description("DeepSeek-native agent framework \u2014 built for cache hits and cheap tokens.").version(VERSION).option(
   "-c, --continue",
@@ -21806,6 +22221,10 @@ program.command("code [dir]").description(
 ).option("-m, --model <id>", "Override default model (v4-flash)").option("--no-session", "Disable session persistence for this run").option("-r, --resume", "Skip the session picker \u2014 always continue prior messages").option("-n, --new", "Skip the session picker \u2014 always wipe prior messages and start fresh").option("--transcript <path>", "Write a JSONL transcript to this path").option(
   "--harvest",
   "Opt-in Pillar-2 plan-state extraction. Adds one flash call per turn; off by default (no preset enables it)."
+).option(
+  "--budget <usd>",
+  "Soft USD cap on session spend. Off by default. Warns at 80%, refuses next turn at 100%. Mid-session: /budget <usd> or /budget off.",
+  (v) => Number.parseFloat(v)
 ).option(
   "--no-dashboard",
   "Suppress the auto-launched embedded web dashboard. Default behavior boots it on TUI mount and shows the URL in the status bar (clickable in OSC-8-aware terminals)."
@@ -21818,6 +22237,7 @@ program.command("code [dir]").description(
     forceResume: !!opts.resume,
     forceNew: !!opts.new,
     harvest: !!opts.harvest,
+    budgetUsd: parseBudgetFlag(opts.budget),
     noDashboard: opts.dashboard === false
   });
 });
@@ -21831,6 +22251,10 @@ program.command("chat").description("Interactive Ink TUI with live cache/cost pa
   "--branch <n>",
   "Self-consistency: run N parallel samples per turn (N\xD7 cost). Manual only \u2014 never auto-enabled.",
   (v) => Number.parseInt(v, 10)
+).option(
+  "--budget <usd>",
+  "Soft USD cap on session spend. Off by default. Warns at 80%, refuses next turn at 100%. Mid-session: /budget <usd> or /budget off.",
+  (v) => Number.parseFloat(v)
 ).option("--session <name>", "Use a named session (default: from config, usually 'default').").option("--no-session", "Disable session persistence for this run (ephemeral chat)").option("-r, --resume", "Skip the session picker \u2014 always continue prior messages").option(
   "-c, --continue",
   "Resume the most-recently-used session (any name) without showing the picker."
@@ -21868,6 +22292,7 @@ program.command("chat").description("Interactive Ink TUI with live cache/cost pa
     transcript: opts.transcript,
     harvest: defaults.harvest,
     branch: defaults.branch,
+    budgetUsd: parseBudgetFlag(opts.budget),
     session: continueOpts.session,
     mcp: defaults.mcp,
     mcpPrefix: opts.mcpPrefix,
@@ -21880,6 +22305,10 @@ program.command("run <task>").description("Run a single task non-interactively,
   "--branch <n>",
   "Self-consistency: run N parallel samples per turn and pick the most confident",
   (v) => Number.parseInt(v, 10)
+).option(
+  "--budget <usd>",
+  "Soft USD cap on session spend. Off by default. Refuses to start a new turn once cumulative cost \u2265 cap.",
+  (v) => Number.parseFloat(v)
 ).option("--transcript <path>", "Write a JSONL transcript to this path for replay/diff").option(
   "--mcp <spec>",
   'MCP server spec; repeatable. "name=cmd args...", "cmd args...", or a URL (http/https \u2192 SSE).',
@@ -21903,6 +22332,7 @@ program.command("run <task>").description("Run a single task non-interactively,
     system: applyMemoryStack(opts.system, process.cwd()),
     harvest: defaults.harvest,
     branch: defaults.branch,
+    budgetUsd: parseBudgetFlag(opts.budget),
     transcript: opts.transcript,
     mcp: defaults.mcp,
     mcpPrefix: opts.mcpPrefix
@@ -21913,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 });
 });