reasonix 0.12.16 → 0.12.20

package/dist/cli/index.js

@@ -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;
 }
@@ -666,6 +666,7 @@ function matchesTool(hook, toolName) {
     return false;
   }
 }
+var HOOK_OUTPUT_CAP_BYTES = 256 * 1024;
 function defaultSpawner(input) {
   return new Promise((resolve13) => {
     const child = spawn(input.command, {
@@ -673,8 +674,11 @@ function defaultSpawner(input) {
       shell: true,
       stdio: ["pipe", "pipe", "pipe"]
     });
-    let stdout3 = "";
-    let stderr = "";
+    const stdoutChunks = [];
+    const stderrChunks = [];
+    let stdoutBytes = 0;
+    let stderrBytes = 0;
+    let truncated = false;
     let timedOut = false;
     const timer = setTimeout(() => {
       timedOut = true;
@@ -686,29 +690,46 @@ function defaultSpawner(input) {
         }
       }, 500);
     }, input.timeoutMs);
-    child.stdout.on("data", (chunk) => {
-      stdout3 += chunk.toString("utf8");
-    });
-    child.stderr.on("data", (chunk) => {
-      stderr += chunk.toString("utf8");
-    });
+    const onChunk = (kind, chunk) => {
+      const target = kind === "stdout" ? stdoutChunks : stderrChunks;
+      const seen = kind === "stdout" ? stdoutBytes : stderrBytes;
+      if (seen >= HOOK_OUTPUT_CAP_BYTES) {
+        truncated = true;
+        return;
+      }
+      const remaining = HOOK_OUTPUT_CAP_BYTES - seen;
+      if (chunk.length > remaining) {
+        target.push(chunk.subarray(0, remaining));
+        if (kind === "stdout") stdoutBytes = HOOK_OUTPUT_CAP_BYTES;
+        else stderrBytes = HOOK_OUTPUT_CAP_BYTES;
+        truncated = true;
+      } else {
+        target.push(chunk);
+        if (kind === "stdout") stdoutBytes += chunk.length;
+        else stderrBytes += chunk.length;
+      }
+    };
+    child.stdout.on("data", (chunk) => onChunk("stdout", chunk));
+    child.stderr.on("data", (chunk) => onChunk("stderr", chunk));
     child.once("error", (err) => {
       clearTimeout(timer);
       resolve13({
         exitCode: null,
-        stdout: stdout3,
-        stderr,
+        stdout: Buffer.concat(stdoutChunks).toString("utf8"),
+        stderr: Buffer.concat(stderrChunks).toString("utf8"),
         timedOut: false,
-        spawnError: err
+        spawnError: err,
+        truncated: truncated || void 0
       });
     });
     child.once("close", (code) => {
       clearTimeout(timer);
       resolve13({
         exitCode: code,
-        stdout: stdout3.trim(),
-        stderr: stderr.trim(),
-        timedOut
+        stdout: Buffer.concat(stdoutChunks).toString("utf8").trim(),
+        stderr: Buffer.concat(stderrChunks).toString("utf8").trim(),
+        timedOut,
+        truncated: truncated || void 0
       });
     });
     try {
@@ -723,7 +744,8 @@ function formatHookOutcomeMessage(outcome) {
   const detail = (outcome.stderr || outcome.stdout || "").trim();
   const tag = `${outcome.hook.scope}/${outcome.hook.event}`;
   const cmd = outcome.hook.command.length > 60 ? `${outcome.hook.command.slice(0, 60)}\u2026` : outcome.hook.command;
-  const head = `hook ${tag} \`${cmd}\` ${outcome.decision}`;
+  const truncTag = outcome.truncated ? " (output truncated at 256KB)" : "";
+  const head = `hook ${tag} \`${cmd}\` ${outcome.decision}${truncTag}`;
   return detail ? `${head}: ${detail}` : head;
 }
 function decideOutcome(event, raw) {
@@ -754,7 +776,8 @@ async function runHooks(opts) {
       exitCode: raw.exitCode,
       stdout: raw.stdout,
       stderr: raw.stderr || (raw.spawnError ? raw.spawnError.message : "") || (raw.timedOut ? `hook timed out after ${timeoutMs}ms` : ""),
-      durationMs: Date.now() - start
+      durationMs: Date.now() - start,
+      truncated: raw.truncated
     });
     if (decision === "block") {
       blocked = true;
@@ -1253,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;
   }
@@ -1302,6 +1325,23 @@ var ImmutablePrefix = class {
    */
   _toolSpecs;
   fewShots;
+  /**
+   * Cached SHA-256 of the prefix payload. Computed lazily on first
+   * `fingerprint` access, invalidated only by mutations that go
+   * through `addTool` (the one legitimate post-construction mutation
+   * path). The TUI reads `fingerprint` on every render — without the
+   * cache, that means a fresh `JSON.stringify` + sha256 over the
+   * full prefix (system prompt + tools list + few-shots, typically
+   * 5-10KB) on every keystroke.
+   *
+   * The lazy-init also acts as a cheap drift guard: if some future
+   * code path mutates `_toolSpecs` directly without going through
+   * `addTool`, `fingerprint` will return the stale cached value
+   * while the actual prefix sent to DeepSeek diverges — the cache
+   * miss would be the first symptom. {@link verifyFingerprint}
+   * lets dev / test code assert the cache matches reality.
+   */
+  _fingerprintCache = null;
   constructor(opts) {
     this.system = opts.system;
     this._toolSpecs = [...opts.toolSpecs ?? []];
@@ -1327,9 +1367,33 @@ var ImmutablePrefix = class {
     if (!name) return false;
     if (this._toolSpecs.some((t2) => t2.function?.name === name)) return false;
     this._toolSpecs.push(spec);
+    this._fingerprintCache = null;
     return true;
   }
   get fingerprint() {
+    if (this._fingerprintCache !== null) return this._fingerprintCache;
+    this._fingerprintCache = this.computeFingerprint();
+    return this._fingerprintCache;
+  }
+  /**
+   * Recompute the fingerprint from scratch and assert it matches the
+   * cached value. Returns the freshly-computed hash on success; throws
+   * with a diff if the cache drifted, which always indicates a bug —
+   * either a non-`addTool` mutation path was added, or `addTool`
+   * forgot to invalidate the cache. Dev / test only; the live loop
+   * doesn't call this on the hot path.
+   */
+  verifyFingerprint() {
+    const fresh = this.computeFingerprint();
+    if (this._fingerprintCache !== null && this._fingerprintCache !== fresh) {
+      throw new Error(
+        `ImmutablePrefix fingerprint drift: cached=${this._fingerprintCache}, fresh=${fresh}. A mutation path bypassed addTool's cache invalidation \u2014 DeepSeek will see prefix churn that the TUI / transcript log don't know about.`
+      );
+    }
+    this._fingerprintCache = fresh;
+    return fresh;
+  }
+  computeFingerprint() {
     const blob = JSON.stringify({
       system: this.system,
       tools: this._toolSpecs,
@@ -1748,15 +1812,25 @@ function listSessions() {
     const files = readdirSync(dir).filter((f) => f.endsWith(".jsonl"));
     return files.map((file) => {
       const path5 = join4(dir, file);
-      const stat = statSync(path5);
+      const stat2 = statSync(path5);
       const name = file.replace(/\.jsonl$/, "");
       const messageCount = countLines(path5);
-      return { name, path: path5, size: stat.size, messageCount, mtime: stat.mtime };
+      return { name, path: path5, size: stat2.size, messageCount, mtime: stat2.mtime };
     }).sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
   } catch {
     return [];
   }
 }
+function pruneStaleSessions(daysOld = 90) {
+  const cutoff = Date.now() - daysOld * 24 * 60 * 60 * 1e3;
+  const deleted = [];
+  for (const s of listSessions()) {
+    if (s.mtime.getTime() < cutoff) {
+      if (deleteSession(s.name)) deleted.push(s.name);
+    }
+  }
+  return deleted;
+}
 function deleteSession(name) {
   const path5 = sessionPath(name);
   try {
@@ -1925,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
@@ -1990,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();
@@ -2229,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()`
@@ -2390,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();
@@ -2486,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
@@ -2527,7 +2645,7 @@ var CacheFirstLoop = class {
               onSampleDone
             }
           );
-          for (let k = 0; k < budget; k++) {
+          for (let k = 0; k < budget2; k++) {
             const sample = queue.shift() ?? await new Promise((resolve13) => {
               waiter = resolve13;
             });
@@ -2537,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
@@ -3252,6 +3370,7 @@ function extractDeepSeekErrorMessage(body) {
 
 // src/at-mentions.ts
 import { existsSync as existsSync4, readFileSync as readFileSync5, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
+import { readdir, stat } from "fs/promises";
 import { isAbsolute, join as join5, relative, resolve } from "path";
 var DEFAULT_AT_MENTION_MAX_BYTES = 64 * 1024;
 var DEFAULT_PICKER_IGNORE_DIRS = [
@@ -3306,6 +3425,58 @@ function listFilesWithStatsSync(root, opts = {}) {
   walk3(rootAbs, "");
   return out;
 }
+async function listFilesWithStatsAsync(root, opts = {}) {
+  const maxResults = Math.max(1, opts.maxResults ?? 500);
+  const ignore = new Set(opts.ignoreDirs ?? DEFAULT_PICKER_IGNORE_DIRS);
+  const rootAbs = resolve(root);
+  const out = [];
+  const walk3 = async (dirAbs, dirRel) => {
+    if (out.length >= maxResults) return;
+    let entries;
+    try {
+      entries = await readdir(dirAbs, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    entries.sort((a, b) => a.name.localeCompare(b.name));
+    const fileEnts = [];
+    for (const ent of entries) {
+      if (out.length >= maxResults) break;
+      if (ent.isDirectory()) {
+        if (ent.name.startsWith(".") || ignore.has(ent.name)) continue;
+        if (fileEnts.length > 0) {
+          await statBatch(fileEnts, dirAbs, dirRel, out, maxResults);
+          fileEnts.length = 0;
+          if (out.length >= maxResults) return;
+        }
+        await walk3(join5(dirAbs, ent.name), dirRel ? `${dirRel}/${ent.name}` : ent.name);
+      } else if (ent.isFile()) {
+        fileEnts.push(ent);
+      }
+    }
+    if (fileEnts.length > 0 && out.length < maxResults) {
+      await statBatch(fileEnts, dirAbs, dirRel, out, maxResults);
+    }
+  };
+  await walk3(rootAbs, "");
+  return out;
+}
+async function statBatch(ents, dirAbs, dirRel, out, maxResults) {
+  const remaining = Math.max(0, maxResults - out.length);
+  const batch = ents.slice(0, remaining);
+  const stats2 = await Promise.all(
+    batch.map(
+      (e) => stat(join5(dirAbs, e.name)).then((s) => s.mtimeMs).catch(() => 0)
+    )
+  );
+  for (let i = 0; i < batch.length; i++) {
+    const ent = batch[i];
+    out.push({
+      path: dirRel ? `${dirRel}/${ent.name}` : ent.name,
+      mtimeMs: stats2[i] ?? 0
+    });
+  }
+}
 var AT_PICKER_PREFIX = /(?:^|\s)@([a-zA-Z0-9_./\\-]*)$/;
 function detectAtPicker(input) {
   const m = AT_PICKER_PREFIX.exec(input);
@@ -3666,8 +3837,8 @@ When none of these is given AND the file is longer than ${DEFAULT_AUTO_PREVIEW_L
     },
     fn: async (args) => {
       const abs = safePath(args.path);
-      const stat = await fs.stat(abs);
-      if (stat.isDirectory()) {
+      const stat2 = await fs.stat(abs);
+      if (stat2.isDirectory()) {
         throw new Error(`not a file: ${args.path} (it's a directory)`);
       }
       const raw = await fs.readFile(abs);
@@ -3936,13 +4107,13 @@ Prefer \`list_directory\` for a single-level view, \`search_files\` to find spec
           if (nameFilter && !e.name.toLowerCase().includes(nameFilter)) continue;
           if (isLikelyBinaryByName(e.name)) continue;
           const full = pathMod.join(dir, e.name);
-          let stat;
+          let stat2;
           try {
-            stat = await fs.stat(full);
+            stat2 = await fs.stat(full);
           } catch {
             continue;
           }
-          if (stat.size > 2 * 1024 * 1024) continue;
+          if (stat2.size > 2 * 1024 * 1024) continue;
           let raw;
           try {
             raw = await fs.readFile(full);
@@ -4923,6 +5094,8 @@ var JobRegistry = class {
     };
     this.jobs.set(id, job);
     let readyMatched = false;
+    let recentForReady = "";
+    const READY_WINDOW = 1024;
     const onData = (chunk) => {
       const s = chunk.toString();
       job.totalBytesWritten += s.length;
@@ -4935,8 +5108,9 @@ var JobRegistry = class {
 ${job.output.slice(start)}`;
       }
       if (!readyMatched) {
+        recentForReady = (recentForReady + s).slice(-READY_WINDOW);
         for (const re of READY_SIGNALS) {
-          if (re.test(s) || re.test(job.output)) {
+          if (re.test(recentForReady)) {
             readyMatched = true;
             job.signalReady();
             break;
@@ -5620,6 +5794,7 @@ ${r.output}` : header2;
 var DEFAULT_FETCH_MAX_CHARS = 32e3;
 var DEFAULT_FETCH_TIMEOUT_MS = 15e3;
 var DEFAULT_TOPK = 5;
+var FETCH_MAX_BYTES = 10 * 1024 * 1024;
 var USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36";
 var MOJEEK_ENDPOINT = "https://www.mojeek.com/search";
 async function webSearch(query, opts = {}) {
@@ -5699,7 +5874,13 @@ async function webFetch(url, opts = {}) {
   }
   if (!resp.ok) throw new Error(`web_fetch ${resp.status} for ${url}`);
   const contentType = resp.headers.get("content-type") ?? "";
-  const raw = await resp.text();
+  const declaredLen = Number(resp.headers.get("content-length") ?? "");
+  if (Number.isFinite(declaredLen) && declaredLen > FETCH_MAX_BYTES) {
+    throw new Error(
+      `web_fetch refused: content-length ${declaredLen} bytes exceeds ${FETCH_MAX_BYTES}-byte cap (${url})`
+    );
+  }
+  const raw = await readBodyCapped(resp, FETCH_MAX_BYTES);
   const title = extractTitle(raw);
   const text = contentType.includes("text/html") ? htmlToText(raw) : raw;
   const truncated = text.length > maxChars;
@@ -5708,6 +5889,37 @@ async function webFetch(url, opts = {}) {
 [\u2026 truncated ${text.length - maxChars} chars \u2026]` : text;
   return { url, title, text: finalText, truncated };
 }
+async function readBodyCapped(resp, maxBytes) {
+  if (!resp.body) return await resp.text();
+  const reader = resp.body.getReader();
+  const decoder = new TextDecoder("utf-8");
+  let total = 0;
+  let out = "";
+  try {
+    while (true) {
+      const { value, done } = await reader.read();
+      if (done) break;
+      total += value.byteLength;
+      if (total > maxBytes) {
+        try {
+          await reader.cancel();
+        } catch {
+        }
+        throw new Error(
+          `web_fetch refused: response body exceeded ${maxBytes}-byte cap (${total} bytes seen)`
+        );
+      }
+      out += decoder.decode(value, { stream: true });
+    }
+    out += decoder.decode();
+  } finally {
+    try {
+      reader.releaseLock();
+    } catch {
+    }
+  }
+  return out;
+}
 function htmlToText(html) {
   let s = html;
   s = s.replace(/<script[\s\S]*?<\/script>/gi, "");
@@ -6352,6 +6564,107 @@ function truncate(s, n) {
   return s.length > n ? `${s.slice(0, n)}\u2026` : s;
 }
 
+// src/version.ts
+import { existsSync as existsSync6, mkdirSync as mkdirSync3, readFileSync as readFileSync8, writeFileSync as writeFileSync3 } from "fs";
+import { homedir as homedir4 } from "os";
+import { dirname as dirname5, join as join7 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+var REGISTRY_URL = "https://registry.npmjs.org/reasonix/latest";
+var LATEST_CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
+var LATEST_FETCH_TIMEOUT_MS = 2e3;
+function readPackageVersion() {
+  try {
+    let dir = dirname5(fileURLToPath2(import.meta.url));
+    for (let i = 0; i < 6; i++) {
+      const p = join7(dir, "package.json");
+      if (existsSync6(p)) {
+        const pkg = JSON.parse(readFileSync8(p, "utf8"));
+        if (pkg?.name === "reasonix" && typeof pkg.version === "string") {
+          return pkg.version;
+        }
+      }
+      const parent = dirname5(dir);
+      if (parent === dir) break;
+      dir = parent;
+    }
+  } catch {
+  }
+  return "0.0.0-dev";
+}
+var VERSION = readPackageVersion();
+function cachePath(homeDirOverride) {
+  return join7(homeDirOverride ?? homedir4(), ".reasonix", "version-cache.json");
+}
+function readCache(homeDirOverride) {
+  try {
+    const raw = readFileSync8(cachePath(homeDirOverride), "utf8");
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed.version === "string" && typeof parsed.checkedAt === "number") {
+      return parsed;
+    }
+  } catch {
+  }
+  return null;
+}
+function writeCache(entry, homeDirOverride) {
+  try {
+    const p = cachePath(homeDirOverride);
+    mkdirSync3(dirname5(p), { recursive: true });
+    writeFileSync3(p, JSON.stringify(entry), "utf8");
+  } catch {
+  }
+}
+async function getLatestVersion(opts = {}) {
+  const ttl = opts.ttlMs ?? LATEST_CACHE_TTL_MS;
+  if (!opts.force) {
+    const cached2 = readCache(opts.homeDir);
+    if (cached2 && Date.now() - cached2.checkedAt < ttl) return cached2.version;
+  }
+  const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+  if (!fetchImpl) return null;
+  const url = opts.registryUrl ?? REGISTRY_URL;
+  const timeout = opts.timeoutMs ?? LATEST_FETCH_TIMEOUT_MS;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeout);
+  try {
+    const res = await fetchImpl(url, {
+      signal: controller.signal,
+      headers: { accept: "application/json" }
+    });
+    if (!res.ok) return null;
+    const body = await res.json();
+    if (typeof body.version !== "string") return null;
+    writeCache({ version: body.version, checkedAt: Date.now() }, opts.homeDir);
+    return body.version;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function compareVersions(a, b) {
+  const [aCore = "0", aPre = ""] = a.split("-", 2);
+  const [bCore = "0", bPre = ""] = b.split("-", 2);
+  const aParts = aCore.split(".").map((p) => Number.parseInt(p, 10) || 0);
+  const bParts = bCore.split(".").map((p) => Number.parseInt(p, 10) || 0);
+  for (let i = 0; i < 3; i++) {
+    const diff = (aParts[i] ?? 0) - (bParts[i] ?? 0);
+    if (diff !== 0) return diff;
+  }
+  if (!aPre && !bPre) return 0;
+  if (!aPre) return 1;
+  if (!bPre) return -1;
+  return aPre < bPre ? -1 : aPre > bPre ? 1 : 0;
+}
+function isNpxInstall() {
+  const bin = process.argv[1] ?? "";
+  if (/[/\\]_npx[/\\]/.test(bin)) return true;
+  if (/[/\\]\.pnpm[/\\]/.test(bin) && /dlx/i.test(bin)) return true;
+  const ua = process.env.npm_config_user_agent ?? "";
+  if (ua.includes("npx/")) return true;
+  return false;
+}
+
 // src/mcp/types.ts
 var MCP_PROTOCOL_VERSION = "2024-11-05";
 function isJsonRpcError(msg) {
@@ -6380,7 +6693,7 @@ var McpClient = class {
   nextProgressToken = 1;
   constructor(opts) {
     this.transport = opts.transport;
-    this.clientInfo = opts.clientInfo ?? { name: "reasonix", version: "0.3.0-dev" };
+    this.clientInfo = opts.clientInfo ?? { name: "reasonix", version: VERSION };
     this.requestTimeoutMs = opts.requestTimeoutMs ?? 6e4;
   }
   /** Server's advertised capabilities, available after initialize(). */
@@ -7120,8 +7433,8 @@ async function trySection(load) {
 }
 
 // src/code/edit-blocks.ts
-import { existsSync as existsSync6, mkdirSync as mkdirSync3, readFileSync as readFileSync8, unlinkSync as unlinkSync2, writeFileSync as writeFileSync3 } from "fs";
-import { dirname as dirname5, resolve as resolve6 } from "path";
+import { existsSync as existsSync7, mkdirSync as mkdirSync4, readFileSync as readFileSync9, unlinkSync as unlinkSync2, writeFileSync as writeFileSync4 } from "fs";
+import { dirname as dirname6, resolve as resolve6 } from "path";
 var BLOCK_RE = /^(\S[^\n]*)\n<{7} SEARCH\n([\s\S]*?)\n?={7}\n([\s\S]*?)\n?>{7} REPLACE/gm;
 function parseEditBlocks(text) {
   const out = [];
@@ -7149,7 +7462,7 @@ function applyEditBlock(block, rootDir) {
     };
   }
   const searchEmpty = block.search.length === 0;
-  const exists = existsSync6(absTarget);
+  const exists = existsSync7(absTarget);
   try {
     if (!exists) {
       if (!searchEmpty) {
@@ -7159,11 +7472,11 @@ function applyEditBlock(block, rootDir) {
           message: "file does not exist; to create it, use an empty SEARCH block"
         };
       }
-      mkdirSync3(dirname5(absTarget), { recursive: true });
-      writeFileSync3(absTarget, block.replace, "utf8");
+      mkdirSync4(dirname6(absTarget), { recursive: true });
+      writeFileSync4(absTarget, block.replace, "utf8");
       return { path: block.path, status: "created" };
     }
-    const content = readFileSync8(absTarget, "utf8");
+    const content = readFileSync9(absTarget, "utf8");
     if (searchEmpty) {
       return {
         path: block.path,
@@ -7180,7 +7493,7 @@ function applyEditBlock(block, rootDir) {
       };
     }
     const replaced = `${content.slice(0, idx)}${block.replace}${content.slice(idx + block.search.length)}`;
-    writeFileSync3(absTarget, replaced, "utf8");
+    writeFileSync4(absTarget, replaced, "utf8");
     return { path: block.path, status: "applied" };
   } catch (err) {
     return { path: block.path, status: "error", message: err.message };
@@ -7192,9 +7505,9 @@ function applyEditBlocks(blocks, rootDir) {
 function toWholeFileEditBlock(path5, content, rootDir) {
   const abs = resolve6(rootDir, path5);
   let search = "";
-  if (existsSync6(abs)) {
+  if (existsSync7(abs)) {
     try {
-      search = readFileSync8(abs, "utf8");
+      search = readFileSync9(abs, "utf8");
     } catch {
       search = "";
     }
@@ -7209,12 +7522,12 @@ function snapshotBeforeEdits(blocks, rootDir) {
     if (seen.has(b.path)) continue;
     seen.add(b.path);
     const abs = resolve6(absRoot, b.path);
-    if (!existsSync6(abs)) {
+    if (!existsSync7(abs)) {
       snapshots.push({ path: b.path, prevContent: null });
       continue;
     }
     try {
-      snapshots.push({ path: b.path, prevContent: readFileSync8(abs, "utf8") });
+      snapshots.push({ path: b.path, prevContent: readFileSync9(abs, "utf8") });
     } catch {
       snapshots.push({ path: b.path, prevContent: null });
     }
@@ -7234,14 +7547,14 @@ function restoreSnapshots(snapshots, rootDir) {
     }
     try {
       if (snap.prevContent === null) {
-        if (existsSync6(abs)) unlinkSync2(abs);
+        if (existsSync7(abs)) unlinkSync2(abs);
         return {
           path: snap.path,
           status: "applied",
           message: "removed (the edit had created it)"
         };
       }
-      writeFileSync3(abs, snap.prevContent, "utf8");
+      writeFileSync4(abs, snap.prevContent, "utf8");
       return {
         path: snap.path,
         status: "applied",
@@ -7256,114 +7569,54 @@ function sep() {
   return process.platform === "win32" ? "\\" : "/";
 }
 
-// src/version.ts
-import { existsSync as existsSync7, mkdirSync as mkdirSync4, readFileSync as readFileSync9, writeFileSync as writeFileSync4 } from "fs";
-import { homedir as homedir4 } from "os";
-import { dirname as dirname6, join as join7 } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
-var REGISTRY_URL = "https://registry.npmjs.org/reasonix/latest";
-var LATEST_CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
-var LATEST_FETCH_TIMEOUT_MS = 2e3;
-function readPackageVersion() {
-  try {
-    let dir = dirname6(fileURLToPath2(import.meta.url));
-    for (let i = 0; i < 6; i++) {
-      const p = join7(dir, "package.json");
-      if (existsSync7(p)) {
-        const pkg = JSON.parse(readFileSync9(p, "utf8"));
-        if (pkg?.name === "reasonix" && typeof pkg.version === "string") {
-          return pkg.version;
-        }
-      }
-      const parent = dirname6(dir);
-      if (parent === dir) break;
-      dir = parent;
-    }
-  } catch {
-  }
-  return "0.0.0-dev";
-}
-var VERSION = readPackageVersion();
-function cachePath(homeDirOverride) {
-  return join7(homeDirOverride ?? homedir4(), ".reasonix", "version-cache.json");
+// src/usage.ts
+import {
+  appendFileSync as appendFileSync2,
+  existsSync as existsSync8,
+  mkdirSync as mkdirSync5,
+  readFileSync as readFileSync10,
+  statSync as statSync4,
+  writeFileSync as writeFileSync5
+} from "fs";
+import { homedir as homedir5 } from "os";
+import { dirname as dirname7, join as join8 } from "path";
+function defaultUsageLogPath(homeDirOverride) {
+  return join8(homeDirOverride ?? homedir5(), ".reasonix", "usage.jsonl");
 }
-function readCache(homeDirOverride) {
+var USAGE_COMPACTION_THRESHOLD_BYTES = 5 * 1024 * 1024;
+var USAGE_RETENTION_DAYS = 365;
+function compactUsageLogIfLarge(path5, now) {
+  let size;
   try {
-    const raw = readFileSync9(cachePath(homeDirOverride), "utf8");
-    const parsed = JSON.parse(raw);
-    if (parsed && typeof parsed.version === "string" && typeof parsed.checkedAt === "number") {
-      return parsed;
-    }
+    size = statSync4(path5).size;
   } catch {
+    return;
   }
-  return null;
-}
-function writeCache(entry, homeDirOverride) {
+  if (size < USAGE_COMPACTION_THRESHOLD_BYTES) return;
+  const cutoff = now - USAGE_RETENTION_DAYS * 24 * 60 * 60 * 1e3;
+  let raw;
   try {
-    const p = cachePath(homeDirOverride);
-    mkdirSync4(dirname6(p), { recursive: true });
-    writeFileSync4(p, JSON.stringify(entry), "utf8");
+    raw = readFileSync10(path5, "utf8");
   } catch {
+    return;
   }
-}
-async function getLatestVersion(opts = {}) {
-  const ttl = opts.ttlMs ?? LATEST_CACHE_TTL_MS;
-  if (!opts.force) {
-    const cached2 = readCache(opts.homeDir);
-    if (cached2 && Date.now() - cached2.checkedAt < ttl) return cached2.version;
+  const lines = raw.split(/\r?\n/);
+  const kept = [];
+  for (const line of lines) {
+    if (!line.trim()) continue;
+    try {
+      const rec = JSON.parse(line);
+      if (isValidRecord(rec) && rec.ts >= cutoff) kept.push(line);
+    } catch {
+    }
   }
-  const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
-  if (!fetchImpl) return null;
-  const url = opts.registryUrl ?? REGISTRY_URL;
-  const timeout = opts.timeoutMs ?? LATEST_FETCH_TIMEOUT_MS;
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), timeout);
+  if (kept.length === lines.filter((l) => l.trim()).length) return;
   try {
-    const res = await fetchImpl(url, {
-      signal: controller.signal,
-      headers: { accept: "application/json" }
-    });
-    if (!res.ok) return null;
-    const body = await res.json();
-    if (typeof body.version !== "string") return null;
-    writeCache({ version: body.version, checkedAt: Date.now() }, opts.homeDir);
-    return body.version;
+    writeFileSync5(path5, kept.length > 0 ? `${kept.join("\n")}
+` : "", "utf8");
   } catch {
-    return null;
-  } finally {
-    clearTimeout(timer);
   }
 }
-function compareVersions(a, b) {
-  const [aCore = "0", aPre = ""] = a.split("-", 2);
-  const [bCore = "0", bPre = ""] = b.split("-", 2);
-  const aParts = aCore.split(".").map((p) => Number.parseInt(p, 10) || 0);
-  const bParts = bCore.split(".").map((p) => Number.parseInt(p, 10) || 0);
-  for (let i = 0; i < 3; i++) {
-    const diff = (aParts[i] ?? 0) - (bParts[i] ?? 0);
-    if (diff !== 0) return diff;
-  }
-  if (!aPre && !bPre) return 0;
-  if (!aPre) return 1;
-  if (!bPre) return -1;
-  return aPre < bPre ? -1 : aPre > bPre ? 1 : 0;
-}
-function isNpxInstall() {
-  const bin = process.argv[1] ?? "";
-  if (/[/\\]_npx[/\\]/.test(bin)) return true;
-  if (/[/\\]\.pnpm[/\\]/.test(bin) && /dlx/i.test(bin)) return true;
-  const ua = process.env.npm_config_user_agent ?? "";
-  if (ua.includes("npx/")) return true;
-  return false;
-}
-
-// src/usage.ts
-import { appendFileSync as appendFileSync2, existsSync as existsSync8, mkdirSync as mkdirSync5, readFileSync as readFileSync10, statSync as statSync4 } from "fs";
-import { homedir as homedir5 } from "os";
-import { dirname as dirname7, join as join8 } from "path";
-function defaultUsageLogPath(homeDirOverride) {
-  return join8(homeDirOverride ?? homedir5(), ".reasonix", "usage.jsonl");
-}
 function appendUsage(input) {
   const record = {
     ts: input.now ?? Date.now(),
@@ -7383,6 +7636,7 @@ function appendUsage(input) {
     mkdirSync5(dirname7(path5), { recursive: true });
     appendFileSync2(path5, `${JSON.stringify(record)}
 `, "utf8");
+    compactUsageLogIfLarge(path5, record.ts);
   } catch {
   }
   return record;
@@ -7521,7 +7775,7 @@ import { Box as Box22, Static, Text as Text20, useStdout as useStdout8 } from "i
 import React24, { useCallback as useCallback4, useEffect as useEffect6, useMemo as useMemo3, useRef as useRef6, useState as useState10 } from "react";
 
 // src/code/pending-edits.ts
-import { existsSync as existsSync9, mkdirSync as mkdirSync6, readFileSync as readFileSync11, unlinkSync as unlinkSync3, writeFileSync as writeFileSync5 } from "fs";
+import { existsSync as existsSync9, mkdirSync as mkdirSync6, readFileSync as readFileSync11, unlinkSync as unlinkSync3, writeFileSync as writeFileSync6 } from "fs";
 import { dirname as dirname8, join as join9 } from "path";
 function pendingEditsPath(sessionName) {
   return join9(sessionsDir(), `${sanitizeName(sessionName)}.pending.json`);
@@ -7535,7 +7789,7 @@ function savePendingEdits(sessionName, blocks) {
       return;
     }
     mkdirSync6(dirname8(path5), { recursive: true });
-    writeFileSync5(path5, JSON.stringify(blocks, null, 2), "utf8");
+    writeFileSync6(path5, JSON.stringify(blocks, null, 2), "utf8");
   } catch {
   }
 }
@@ -7581,7 +7835,7 @@ import {
   renameSync,
   statSync as statSync5,
   unlinkSync as unlinkSync4,
-  writeFileSync as writeFileSync6
+  writeFileSync as writeFileSync7
 } from "fs";
 import { dirname as dirname9, join as join10 } from "path";
 function planStatePath(sessionName) {
@@ -7638,7 +7892,7 @@ function savePlanState(sessionName, steps, completedStepIds, extras) {
     };
     if (extras?.body) state.body = extras.body;
     if (extras?.summary) state.summary = extras.summary;
-    writeFileSync6(path5, `${JSON.stringify(state, null, 2)}
+    writeFileSync7(path5, `${JSON.stringify(state, null, 2)}
 `, "utf8");
   } catch (err) {
     process.stderr.write(
@@ -7906,7 +8160,7 @@ import {
   readFileSync as readFileSync14,
   readSync,
   statSync as statSync6,
-  writeFileSync as writeFileSync7
+  writeFileSync as writeFileSync8
 } from "fs";
 import { dirname as dirname11, isAbsolute as isAbsolute4, resolve as resolve7, sep as sep2 } from "path";
 var MAX_BYTES = 4 * 1024 * 1024;
@@ -7986,14 +8240,14 @@ async function handleFile(method, rest, body, ctx) {
     if (!existsSync11(target)) {
       return { status: 404, body: { error: "file not found" } };
     }
-    const stat = statSync6(target);
-    if (stat.isDirectory()) {
+    const stat2 = statSync6(target);
+    if (stat2.isDirectory()) {
       return { status: 400, body: { error: "path is a directory" } };
     }
-    if (stat.size > MAX_BYTES) {
+    if (stat2.size > MAX_BYTES) {
       return {
         status: 413,
-        body: { error: `file too large (${stat.size} bytes; cap ${MAX_BYTES})` }
+        body: { error: `file too large (${stat2.size} bytes; cap ${MAX_BYTES})` }
       };
     }
     if (looksBinary(target)) {
@@ -8008,8 +8262,8 @@ async function handleFile(method, rest, body, ctx) {
       body: {
         path: requested,
         absolute: target,
-        size: stat.size,
-        mtime: stat.mtime.getTime(),
+        size: stat2.size,
+        mtime: stat2.mtime.getTime(),
         content
       }
     };
@@ -8029,20 +8283,20 @@ async function handleFile(method, rest, body, ctx) {
     if (!existsSync11(parent)) {
       mkdirSync8(parent, { recursive: true });
     }
-    writeFileSync7(target, content, "utf8");
+    writeFileSync8(target, content, "utf8");
     ctx.audit?.({
       ts: Date.now(),
       action: "save-file",
       payload: { path: requested, bytes: Buffer.byteLength(content, "utf8") }
     });
-    const stat = statSync6(target);
+    const stat2 = statSync6(target);
     return {
       status: 200,
       body: {
         saved: true,
         path: requested,
-        size: stat.size,
-        mtime: stat.mtime.getTime()
+        size: stat2.size,
+        mtime: stat2.mtime.getTime()
       }
     };
   }
@@ -8139,7 +8393,7 @@ async function handleHealth(method, _rest, _body, ctx) {
 }
 
 // src/server/api/hooks.ts
-import { existsSync as existsSync13, mkdirSync as mkdirSync9, readFileSync as readFileSync15, writeFileSync as writeFileSync8 } from "fs";
+import { existsSync as existsSync13, mkdirSync as mkdirSync9, readFileSync as readFileSync15, writeFileSync as writeFileSync9 } from "fs";
 import { dirname as dirname12 } from "path";
 function parseBody3(raw) {
   if (!raw) return {};
@@ -8164,7 +8418,7 @@ function writeSettingsFile(path5, hooksBlock) {
   const existing = readSettingsFile2(path5);
   existing.hooks = hooksBlock;
   mkdirSync9(dirname12(path5), { recursive: true });
-  writeFileSync8(path5, `${JSON.stringify(existing, null, 2)}
+  writeFileSync9(path5, `${JSON.stringify(existing, null, 2)}
 `, "utf8");
 }
 async function handleHooks(method, rest, body, ctx) {
@@ -8345,7 +8599,7 @@ import {
   readdirSync as readdirSync5,
   statSync as statSync8,
   unlinkSync as unlinkSync5,
-  writeFileSync as writeFileSync9
+  writeFileSync as writeFileSync10
 } from "fs";
 import { homedir as homedir7 } from "os";
 import { dirname as dirname13, join as join13, resolve as resolvePath } from "path";
@@ -8372,11 +8626,11 @@ function listMemoryFiles(dir) {
   if (!existsSync14(dir)) return [];
   try {
     return readdirSync5(dir).filter((f) => f.endsWith(".md")).map((f) => {
-      const stat = statSync8(join13(dir, f));
+      const stat2 = statSync8(join13(dir, f));
       return {
         name: f.replace(/\.md$/, ""),
-        size: stat.size,
-        mtime: stat.mtime.getTime()
+        size: stat2.size,
+        mtime: stat2.mtime.getTime()
       };
     }).sort((a, b) => b.mtime - a.mtime);
   } catch {
@@ -8436,7 +8690,7 @@ async function handleMemory(method, rest, body, ctx) {
       if (!cwd2) return { status: 503, body: { error: "no active project" } };
       const path5 = join13(cwd2, PROJECT_MEMORY_FILE);
       mkdirSync10(dirname13(path5), { recursive: true });
-      writeFileSync9(path5, contents, "utf8");
+      writeFileSync10(path5, contents, "utf8");
       ctx.audit?.({ ts: Date.now(), action: "save-memory", payload: { scope, path: path5 } });
       return { status: 200, body: { saved: true, path: path5 } };
     }
@@ -8445,7 +8699,7 @@ async function handleMemory(method, rest, body, ctx) {
       if (!dir) return { status: 503, body: { error: "no project root for project-mem" } };
       mkdirSync10(dir, { recursive: true });
       const path5 = join13(dir, `${name}.md`);
-      writeFileSync9(path5, contents, "utf8");
+      writeFileSync10(path5, contents, "utf8");
       ctx.audit?.({ ts: Date.now(), action: "save-memory", payload: { scope, name, path: path5 } });
       return { status: 200, body: { saved: true, path: path5 } };
     }
@@ -8783,13 +9037,13 @@ async function* walkChunks(root, opts = {}) {
       const ext = path.extname(name).toLowerCase();
       if (BINARY_EXTS.has(ext)) continue;
       const abs = path.join(dir, name);
-      let stat;
+      let stat2;
       try {
-        stat = await fs2.stat(abs);
+        stat2 = await fs2.stat(abs);
       } catch {
         continue;
       }
-      if (stat.size > maxFileBytes) continue;
+      if (stat2.size > maxFileBytes) continue;
       let text;
       try {
         text = await fs2.readFile(abs, "utf8");
@@ -9165,8 +9419,8 @@ async function buildIndex(root, opts = {}) {
       const abs = path3.join(root, chunk.path);
       let mtimeMs = 0;
       try {
-        const stat = await fs4.stat(abs);
-        mtimeMs = stat.mtimeMs;
+        const stat2 = await fs4.stat(abs);
+        mtimeMs = stat2.mtimeMs;
       } catch {
         continue;
       }
@@ -9969,7 +10223,7 @@ import {
   readdirSync as readdirSync6,
   rmSync,
   statSync as statSync9,
-  writeFileSync as writeFileSync10
+  writeFileSync as writeFileSync11
 } from "fs";
 import { homedir as homedir8 } from "os";
 import { dirname as dirname14, join as join14 } from "path";
@@ -10008,14 +10262,14 @@ function listSkills(dir, scope) {
       const skillPath = join14(dir, entry, SKILL_FILE);
       if (!existsSync16(skillPath)) continue;
       try {
-        const stat = statSync9(skillPath);
+        const stat2 = statSync9(skillPath);
         const raw = readFileSync18(skillPath, "utf8");
         const item = {
           name: entry,
           scope,
           path: skillPath,
-          size: stat.size,
-          mtime: stat.mtime.getTime()
+          size: stat2.size,
+          mtime: stat2.mtime.getTime()
         };
         const desc = parseFrontmatterDescription(raw);
         if (desc) item.description = desc;
@@ -10084,7 +10338,7 @@ async function handleSkills(method, rest, body, ctx) {
       return { status: 400, body: { error: "body (string) required" } };
     }
     mkdirSync11(dirname14(skillPath), { recursive: true });
-    writeFileSync10(skillPath, contents, "utf8");
+    writeFileSync11(skillPath, contents, "utf8");
     ctx.audit?.({
       ts: Date.now(),
       action: "save-skill",
@@ -11191,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;
@@ -11228,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") {
@@ -11248,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`];
@@ -11640,26 +11894,26 @@ function validateCitation(url, projectRoot) {
     ...siblings.map((ext) => baseFullPath.replace(/\.[^./\\]+$/, ext))
   ];
   let fullPath = baseFullPath;
-  let stat = null;
+  let stat2 = null;
   for (const candidate of candidates) {
     try {
-      stat = statSync11(candidate);
+      stat2 = statSync11(candidate);
       fullPath = candidate;
       break;
     } catch {
     }
   }
-  if (!stat) return { ok: false, reason: "file not found" };
-  if (!stat.isFile()) return { ok: false, reason: "not a file" };
+  if (!stat2) return { ok: false, reason: "file not found" };
+  if (!stat2.isFile()) return { ok: false, reason: "not a file" };
   if (parts.startLine === void 0) return { ok: true };
-  let lineCount = getCachedLineCount(fullPath, stat.mtimeMs);
+  let lineCount = getCachedLineCount(fullPath, stat2.mtimeMs);
   if (lineCount === null) {
     try {
       lineCount = readFileSync19(fullPath, "utf8").split("\n").length;
     } catch {
       return { ok: false, reason: "unreadable" };
     }
-    setCachedLineCount(fullPath, stat.mtimeMs, lineCount);
+    setCachedLineCount(fullPath, stat2.mtimeMs, lineCount);
   }
   if (parts.startLine < 1 || parts.startLine > lineCount) {
     return { ok: false, reason: `line ${parts.startLine} > ${lineCount}` };
@@ -12454,7 +12708,7 @@ var EventRow = React11.memo(function EventRow2({
       event.branch ? /* @__PURE__ */ React11.createElement(BranchBlock, { branch: event.branch }) : null,
       event.reasoning ? /* @__PURE__ */ React11.createElement(ReasoningBlock, { reasoning: event.reasoning }) : null,
       !isPlanStateEmpty(event.planState) ? /* @__PURE__ */ React11.createElement(PlanStateBlock, { planState: event.planState }) : null,
-      event.text ? /* @__PURE__ */ React11.createElement(Markdown, { text: event.text, projectRoot }) : /* @__PURE__ */ React11.createElement(Text8, { dimColor: true }, "(no content)"),
+      event.text ? /* @__PURE__ */ React11.createElement(Markdown, { text: event.text, projectRoot }) : /* @__PURE__ */ React11.createElement(Text8, { dimColor: true }, "(empty body \u2014 likely tool-call only)"),
       event.stats ? /* @__PURE__ */ React11.createElement(StatsLine, { stats: event.stats }) : null,
       event.repair ? /* @__PURE__ */ React11.createElement(Text8, { color: COLOR.accent }, event.repair) : null
     ));
@@ -13337,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++;
   }
@@ -13351,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) {
@@ -13363,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;
@@ -13870,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;
@@ -13916,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 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)}%)`)));
 }
 function Header({
   model: model2,
@@ -14195,7 +14455,7 @@ function describeRepair(repair) {
 }
 
 // src/cli/ui/hash-memory.ts
-import { appendFileSync as appendFileSync3, existsSync as existsSync18, mkdirSync as mkdirSync12, readFileSync as readFileSync20, writeFileSync as writeFileSync11 } from "fs";
+import { appendFileSync as appendFileSync3, existsSync as existsSync18, mkdirSync as mkdirSync12, readFileSync as readFileSync20, writeFileSync as writeFileSync12 } from "fs";
 import { homedir as homedir9 } from "os";
 import { dirname as dirname15, join as join17 } from "path";
 var PROJECT_HEADER = `# Reasonix project memory
@@ -14246,7 +14506,7 @@ function appendBulletToFile(path5, note, newFileHeader) {
 `;
   if (!existsSync18(path5)) {
     mkdirSync12(dirname15(path5), { recursive: true });
-    writeFileSync11(path5, `${newFileHeader}${bullet}`, "utf8");
+    writeFileSync12(path5, `${newFileHeader}${bullet}`, "utf8");
     return { path: path5, created: true };
   }
   let prefix = "";
@@ -14618,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",
@@ -14692,6 +14958,11 @@ var SLASH_COMMANDS = [
   },
   { cmd: "sessions", summary: "list saved sessions (current marked with \u25B8)" },
   { cmd: "forget", summary: "delete the current session from disk" },
+  {
+    cmd: "prune-sessions",
+    summary: "delete sessions idle \u2265N days (default 90) \u2014 frees disk on long-time installs",
+    argsHint: "[days]"
+  },
   { cmd: "setup", summary: "reminds you to exit and run `reasonix setup`" },
   {
     cmd: "semantic",
@@ -16102,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,
@@ -16109,7 +16416,8 @@ var handlers9 = {
   preset,
   branch,
   effort,
-  pro
+  pro,
+  budget
 };
 
 // src/cli/ui/slash/handlers/observability.ts
@@ -16661,9 +16969,9 @@ async function indexFileExists(rootDir) {
 async function readIndexMeta(rootDir) {
   const dataPath = path4.join(rootDir, ".reasonix", "semantic", "index.jsonl");
   try {
-    const stat = await fs5.stat(dataPath);
-    if (stat.size > 10 * 1024 * 1024) {
-      return { chunks: Math.round(stat.size / 500), files: 0 };
+    const stat2 = await fs5.stat(dataPath);
+    if (stat2.size > 10 * 1024 * 1024) {
+      return { chunks: Math.round(stat2.size / 500), files: 0 };
     }
     const raw = await fs5.readFile(dataPath, "utf8");
     const seenPaths = /* @__PURE__ */ new Set();
@@ -16687,6 +16995,7 @@ var handlers13 = {
 };
 
 // src/cli/ui/slash/handlers/sessions.ts
+var STALE_THRESHOLD_DAYS = 90;
 var sessions = (_args, loop2) => {
   const items = listSessions();
   if (items.length === 0) {
@@ -16694,17 +17003,28 @@ var sessions = (_args, loop2) => {
       info: "no saved sessions yet \u2014 chat normally and your messages will be saved automatically"
     };
   }
+  const now = Date.now();
   const lines = ["Saved sessions:"];
+  let staleCount = 0;
   for (const s of items) {
     const sizeKb = (s.size / 1024).toFixed(1);
     const when = s.mtime.toISOString().replace("T", " ").slice(0, 16);
     const marker = s.name === loop2.sessionName ? "\u25B8" : " ";
+    const ageDays = Math.floor((now - s.mtime.getTime()) / (24 * 60 * 60 * 1e3));
+    const isStale = ageDays >= STALE_THRESHOLD_DAYS;
+    const ageTag = isStale ? `  (${ageDays}d \u2014 stale)` : "";
+    if (isStale) staleCount++;
     lines.push(
-      `  ${marker} ${s.name.padEnd(22)} ${String(s.messageCount).padStart(5)} msgs  ${sizeKb.padStart(7)} KB  ${when}`
+      `  ${marker} ${s.name.padEnd(22)} ${String(s.messageCount).padStart(5)} msgs  ${sizeKb.padStart(7)} KB  ${when}${ageTag}`
     );
   }
   lines.push("");
   lines.push("Resume with: reasonix chat --session <name>");
+  if (staleCount > 0) {
+    lines.push(
+      `${staleCount} session${staleCount === 1 ? "" : "s"} idle \u2265${STALE_THRESHOLD_DAYS} days \u2014 /prune-sessions to remove`
+    );
+  }
   return { info: lines.join("\n") };
 };
 var forget = (_args, loop2) => {
@@ -16717,9 +17037,26 @@ var forget = (_args, loop2) => {
     info: ok ? `\u25B8 deleted session "${name}" \u2014 current screen still shows the conversation, but next launch starts fresh` : `could not delete session "${name}" (already gone?)`
   };
 };
+var pruneSessions = (args) => {
+  const raw = args?.[0];
+  const days = raw ? Number.parseInt(raw, 10) : STALE_THRESHOLD_DAYS;
+  if (!Number.isFinite(days) || days < 1) {
+    return {
+      info: `\u25B8 usage: /prune-sessions [days]   \u2014 defaults to ${STALE_THRESHOLD_DAYS}, must be \u22651`
+    };
+  }
+  const removed = pruneStaleSessions(days);
+  if (removed.length === 0) {
+    return { info: `\u25B8 nothing to prune \u2014 no sessions idle \u2265${days} days` };
+  }
+  return {
+    info: `\u25B8 pruned ${removed.length} session${removed.length === 1 ? "" : "s"} idle \u2265${days} days: ${removed.join(", ")}`
+  };
+};
 var handlers14 = {
   sessions,
-  forget
+  forget,
+  "prune-sessions": pruneSessions
 };
 
 // src/cli/ui/slash/handlers/skill.ts
@@ -16845,13 +17182,21 @@ function useCompletionPickers({
     });
   }, [slashMatches]);
   const [atSelected, setAtSelected] = useState6(0);
-  const atFiles = useMemo2(() => {
-    if (!codeMode) return [];
-    try {
-      return listFilesWithStatsSync(rootDir, { maxResults: 500 });
-    } catch {
-      return [];
+  const [atFiles, setAtFiles] = useState6([]);
+  useEffect3(() => {
+    if (!codeMode) {
+      setAtFiles([]);
+      return;
     }
+    let cancelled = false;
+    listFilesWithStatsAsync(rootDir, { maxResults: 500 }).then((files) => {
+      if (!cancelled) setAtFiles(files);
+    }).catch(() => {
+      if (!cancelled) setAtFiles([]);
+    });
+    return () => {
+      cancelled = true;
+    };
   }, [codeMode, rootDir]);
   const recentFilesRef = useRef3([]);
   const recordRecentFile = useCallback((p) => {
@@ -17325,6 +17670,7 @@ function App({
   transcript,
   harvest: harvest3,
   branch: branch2,
+  budgetUsd,
   session,
   tools,
   mcpSpecs,
@@ -17538,6 +17884,7 @@ function App({
       model: model2,
       harvest: harvest3,
       branch: branch2,
+      budgetUsd,
       session,
       hooks: hookList,
       hookCwd: currentRootDir,
@@ -17548,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]);
@@ -19793,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,
@@ -20064,6 +20412,7 @@ function Root({
       transcript: appProps.transcript,
       harvest: appProps.harvest,
       branch: appProps.branch,
+      budgetUsd: appProps.budgetUsd,
       session: appProps.session,
       tools,
       mcpSpecs,
@@ -20225,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,
@@ -20237,7 +20587,7 @@ async function codeCommand(opts = {}) {
 }
 
 // src/cli/commands/diff.ts
-import { writeFileSync as writeFileSync12 } from "fs";
+import { writeFileSync as writeFileSync13 } from "fs";
 import { basename as basename3 } from "path";
 import { render as render2 } from "ink";
 import React30 from "react";
@@ -20384,7 +20734,7 @@ async function diffCommand(opts) {
   if (wantMarkdown) {
     console.log(renderSummaryTable(report));
     const md = renderMarkdown(report);
-    writeFileSync12(opts.mdPath, md, "utf8");
+    writeFileSync13(opts.mdPath, md, "utf8");
     console.log(`
 markdown report written to ${opts.mdPath}`);
     return;
@@ -20961,7 +21311,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;
@@ -21517,6 +21868,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",
@@ -21554,6 +21916,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)."
@@ -21566,6 +21932,7 @@ program.command("code [dir]").description(
     forceResume: !!opts.resume,
     forceNew: !!opts.new,
     harvest: !!opts.harvest,
+    budgetUsd: parseBudgetFlag(opts.budget),
     noDashboard: opts.dashboard === false
   });
 });
@@ -21579,6 +21946,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."
@@ -21616,6 +21987,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,
@@ -21628,6 +22000,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).',
@@ -21651,6 +22027,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