reasonix 0.4.21 → 0.4.23

package/dist/cli/index.js

@@ -506,6 +506,174 @@ function resolveTemperatures(budget, custom) {
   return out;
 }
 
+// src/hooks.ts
+import { spawn } from "child_process";
+import { existsSync, readFileSync as readFileSync2 } from "fs";
+import { homedir as homedir2 } from "os";
+import { join as join2 } from "path";
+var HOOK_EVENTS = [
+  "PreToolUse",
+  "PostToolUse",
+  "UserPromptSubmit",
+  "Stop"
+];
+var BLOCKING_EVENTS = /* @__PURE__ */ new Set(["PreToolUse", "UserPromptSubmit"]);
+var DEFAULT_TIMEOUTS_MS = {
+  PreToolUse: 5e3,
+  UserPromptSubmit: 5e3,
+  PostToolUse: 3e4,
+  Stop: 3e4
+};
+var HOOK_SETTINGS_FILENAME = "settings.json";
+var HOOK_SETTINGS_DIRNAME = ".reasonix";
+function globalSettingsPath(homeDirOverride) {
+  return join2(homeDirOverride ?? homedir2(), HOOK_SETTINGS_DIRNAME, HOOK_SETTINGS_FILENAME);
+}
+function projectSettingsPath(projectRoot) {
+  return join2(projectRoot, HOOK_SETTINGS_DIRNAME, HOOK_SETTINGS_FILENAME);
+}
+function readSettingsFile(path) {
+  if (!existsSync(path)) return null;
+  try {
+    const raw = readFileSync2(path, "utf8");
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object") return parsed;
+  } catch {
+  }
+  return null;
+}
+function loadHooks(opts = {}) {
+  const out = [];
+  if (opts.projectRoot) {
+    const projPath = projectSettingsPath(opts.projectRoot);
+    const settings2 = readSettingsFile(projPath);
+    if (settings2) appendResolved(out, settings2, "project", projPath);
+  }
+  const globalPath = globalSettingsPath(opts.homeDir);
+  const settings = readSettingsFile(globalPath);
+  if (settings) appendResolved(out, settings, "global", globalPath);
+  return out;
+}
+function appendResolved(out, settings, scope, source) {
+  if (!settings.hooks) return;
+  for (const event of HOOK_EVENTS) {
+    const list = settings.hooks[event];
+    if (!Array.isArray(list)) continue;
+    for (const cfg of list) {
+      if (!cfg || typeof cfg.command !== "string" || cfg.command.trim() === "") continue;
+      out.push({ ...cfg, event, scope, source });
+    }
+  }
+}
+function matchesTool(hook, toolName) {
+  if (hook.event !== "PreToolUse" && hook.event !== "PostToolUse") return true;
+  const m = hook.match;
+  if (!m || m === "*") return true;
+  try {
+    const re = new RegExp(`^(?:${m})$`);
+    return re.test(toolName);
+  } catch {
+    return false;
+  }
+}
+function defaultSpawner(input) {
+  return new Promise((resolve6) => {
+    const child = spawn(input.command, {
+      cwd: input.cwd,
+      shell: true,
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    let stdout2 = "";
+    let stderr = "";
+    let timedOut = false;
+    const timer = setTimeout(() => {
+      timedOut = true;
+      child.kill("SIGTERM");
+      setTimeout(() => {
+        try {
+          child.kill("SIGKILL");
+        } catch {
+        }
+      }, 500);
+    }, input.timeoutMs);
+    child.stdout.on("data", (chunk) => {
+      stdout2 += chunk.toString("utf8");
+    });
+    child.stderr.on("data", (chunk) => {
+      stderr += chunk.toString("utf8");
+    });
+    child.once("error", (err) => {
+      clearTimeout(timer);
+      resolve6({
+        exitCode: null,
+        stdout: stdout2,
+        stderr,
+        timedOut: false,
+        spawnError: err
+      });
+    });
+    child.once("close", (code) => {
+      clearTimeout(timer);
+      resolve6({
+        exitCode: code,
+        stdout: stdout2.trim(),
+        stderr: stderr.trim(),
+        timedOut
+      });
+    });
+    try {
+      child.stdin.write(input.stdin);
+      child.stdin.end();
+    } catch {
+    }
+  });
+}
+function formatHookOutcomeMessage(outcome) {
+  if (outcome.decision === "pass") return "";
+  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}`;
+  return detail ? `${head}: ${detail}` : head;
+}
+function decideOutcome(event, raw) {
+  if (raw.spawnError) return "error";
+  if (raw.timedOut) return BLOCKING_EVENTS.has(event) ? "block" : "warn";
+  if (raw.exitCode === 0) return "pass";
+  if (raw.exitCode === 2 && BLOCKING_EVENTS.has(event)) return "block";
+  return "warn";
+}
+async function runHooks(opts) {
+  const spawner = opts.spawner ?? defaultSpawner;
+  const event = opts.payload.event;
+  const toolName = opts.payload.toolName ?? "";
+  const matching = opts.hooks.filter((h) => h.event === event && matchesTool(h, toolName));
+  const outcomes = [];
+  let blocked = false;
+  const stdin2 = `${JSON.stringify(opts.payload)}
+`;
+  for (const hook of matching) {
+    const start = Date.now();
+    const timeoutMs = hook.timeout ?? DEFAULT_TIMEOUTS_MS[event];
+    const cwd = hook.cwd ?? opts.payload.cwd;
+    const raw = await spawner({ command: hook.command, cwd, stdin: stdin2, timeoutMs });
+    const decision = decideOutcome(event, raw);
+    outcomes.push({
+      hook,
+      decision,
+      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
+    });
+    if (decision === "block") {
+      blocked = true;
+      break;
+    }
+  }
+  return { event, outcomes, blocked };
+}
+
 // src/repair/flatten.ts
 function analyzeSchema(schema) {
   if (!schema) return { shouldFlatten: false, leafCount: 0, maxDepth: 0 };
@@ -1128,21 +1296,21 @@ function signature2(call) {
 import {
   appendFileSync,
   chmodSync as chmodSync2,
-  existsSync,
+  existsSync as existsSync2,
   mkdirSync as mkdirSync2,
-  readFileSync as readFileSync2,
+  readFileSync as readFileSync3,
   readdirSync,
   statSync,
   unlinkSync,
   writeFileSync as writeFileSync2
 } from "fs";
-import { homedir as homedir2 } from "os";
-import { dirname as dirname2, join as join2 } from "path";
+import { homedir as homedir3 } from "os";
+import { dirname as dirname2, join as join3 } from "path";
 function sessionsDir() {
-  return join2(homedir2(), ".reasonix", "sessions");
+  return join3(homedir3(), ".reasonix", "sessions");
 }
 function sessionPath(name) {
-  return join2(sessionsDir(), `${sanitizeName(name)}.jsonl`);
+  return join3(sessionsDir(), `${sanitizeName(name)}.jsonl`);
 }
 function sanitizeName(name) {
   const cleaned = name.replace(/[^\w\-\u4e00-\u9fa5]/g, "_").slice(0, 64);
@@ -1150,9 +1318,9 @@ function sanitizeName(name) {
 }
 function loadSessionMessages(name) {
   const path = sessionPath(name);
-  if (!existsSync(path)) return [];
+  if (!existsSync2(path)) return [];
   try {
-    const raw = readFileSync2(path, "utf8");
+    const raw = readFileSync3(path, "utf8");
     const out = [];
     for (const line of raw.split(/\r?\n/)) {
       const trimmed = line.trim();
@@ -1180,11 +1348,11 @@ function appendSessionMessage(name, message) {
 }
 function listSessions() {
   const dir = sessionsDir();
-  if (!existsSync(dir)) return [];
+  if (!existsSync2(dir)) return [];
   try {
     const files = readdirSync(dir).filter((f) => f.endsWith(".jsonl"));
     return files.map((file) => {
-      const path = join2(dir, file);
+      const path = join3(dir, file);
       const stat = statSync(path);
       const name = file.replace(/\.jsonl$/, "");
       const messageCount = countLines(path);
@@ -1216,7 +1384,7 @@ function rewriteSession(name, messages) {
 }
 function countLines(path) {
   try {
-    const raw = readFileSync2(path, "utf8");
+    const raw = readFileSync3(path, "utf8");
     return raw.split(/\r?\n/).filter((l) => l.trim()).length;
   } catch {
     return 0;
@@ -1330,6 +1498,14 @@ var CacheFirstLoop = class {
   branchEnabled;
   branchOptions;
   sessionName;
+  /**
+   * Hook list, mutable so `/hooks reload` can swap it without
+   * reconstructing the loop. Default empty — the filter cost on a
+   * tool call is one array length check.
+   */
+  hooks;
+  /** `cwd` reported to hook stdin. Resolved once at construction. */
+  hookCwd;
   /** Number of messages that were pre-loaded from the session file. */
   resumedMessageCount;
   _turn = 0;
@@ -1348,6 +1524,8 @@ var CacheFirstLoop = class {
     this.tools = opts.tools ?? new ToolRegistry();
     this.model = opts.model ?? "deepseek-chat";
     this.maxToolIters = opts.maxToolIters ?? 64;
+    this.hooks = opts.hooks ?? [];
+    this.hookCwd = opts.hookCwd ?? process.cwd();
     if (typeof opts.branch === "number") {
       this.branchOptions = { budget: opts.branch };
     } else if (opts.branch && typeof opts.branch === "object") {
@@ -1811,7 +1989,37 @@ var CacheFirstLoop = class {
           toolName: name,
           toolArgs: args
         };
-        const result = await this.tools.dispatch(name, args, { signal });
+        const parsedArgs = safeParseToolArgs(args);
+        const preReport = await runHooks({
+          hooks: this.hooks,
+          payload: {
+            event: "PreToolUse",
+            cwd: this.hookCwd,
+            toolName: name,
+            toolArgs: parsedArgs
+          }
+        });
+        for (const w of hookWarnings(preReport.outcomes, this._turn)) yield w;
+        let result;
+        if (preReport.blocked) {
+          const blocking = preReport.outcomes[preReport.outcomes.length - 1];
+          const reason = (blocking?.stderr || blocking?.stdout || "blocked by PreToolUse hook").trim();
+          result = `[hook block] ${blocking?.hook.command ?? "<unknown>"}
+${reason}`;
+        } else {
+          result = await this.tools.dispatch(name, args, { signal });
+          const postReport = await runHooks({
+            hooks: this.hooks,
+            payload: {
+              event: "PostToolUse",
+              cwd: this.hookCwd,
+              toolName: name,
+              toolArgs: parsedArgs,
+              toolResult: result
+            }
+          });
+          for (const w of hookWarnings(postReport.outcomes, this._turn)) yield w;
+        }
         this.appendAndPersist({
           role: "tool",
           tool_call_id: call.id ?? "",
@@ -1898,6 +2106,19 @@ function stripHallucinatedToolMarkup(s) {
   out = out.replace(/<｜DSML｜[\s\S]*$/g, "");
   return out.trim();
 }
+function safeParseToolArgs(raw) {
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return raw;
+  }
+}
+function* hookWarnings(outcomes, turn) {
+  for (const o of outcomes) {
+    if (o.decision === "pass") continue;
+    yield { turn, role: "warning", content: formatHookOutcomeMessage(o) };
+  }
+}
 function reasonPrefixFor(reason, iterCap) {
   if (reason === "aborted") return "[aborted by user (Esc) \u2014 summarizing what I found so far]";
   if (reason === "context-guard") {
@@ -2493,8 +2714,8 @@ function registerPlanTool(registry, opts = {}) {
 }
 
 // src/tools/shell.ts
-import { spawn } from "child_process";
-import { existsSync as existsSync2, statSync as statSync2 } from "fs";
+import { spawn as spawn2 } from "child_process";
+import { existsSync as existsSync3, statSync as statSync2 } from "fs";
 import * as pathMod2 from "path";
 var DEFAULT_TIMEOUT_SEC = 60;
 var DEFAULT_MAX_OUTPUT_CHARS = 32e3;
@@ -2617,7 +2838,7 @@ async function runCommand(cmd, opts) {
   return await new Promise((resolve6, reject) => {
     let child;
     try {
-      child = spawn(bin, args, effectiveSpawnOpts);
+      child = spawn2(bin, args, effectiveSpawnOpts);
     } catch (err) {
       reject(err);
       return;
@@ -2672,7 +2893,7 @@ function resolveExecutable(cmd, opts = {}) {
 }
 function defaultIsFile(full) {
   try {
-    return existsSync2(full) && statSync2(full).isFile();
+    return existsSync3(full) && statSync2(full).isFile();
   } catch {
     return false;
   }
@@ -2975,12 +3196,12 @@ ${i + 1}. ${r.title}`);
 }
 
 // src/env.ts
-import { readFileSync as readFileSync3 } from "fs";
+import { readFileSync as readFileSync4 } from "fs";
 import { resolve as resolve3 } from "path";
 function loadDotenv(path = ".env") {
   let raw;
   try {
-    raw = readFileSync3(resolve3(process.cwd(), path), "utf8");
+    raw = readFileSync4(resolve3(process.cwd(), path), "utf8");
   } catch {
     return;
   }
@@ -2999,7 +3220,7 @@ function loadDotenv(path = ".env") {
 }
 
 // src/transcript.ts
-import { createWriteStream, readFileSync as readFileSync4 } from "fs";
+import { createWriteStream, readFileSync as readFileSync5 } from "fs";
 function recordFromLoopEvent(ev, extra) {
   const rec = {
     ts: (/* @__PURE__ */ new Date()).toISOString(),
@@ -3050,7 +3271,7 @@ function openTranscriptFile(path, meta) {
   return stream;
 }
 function readTranscript(path) {
-  const raw = readFileSync4(path, "utf8");
+  const raw = readFileSync5(path, "utf8");
   return parseTranscript(raw);
 }
 function isPlanStateEmptyShape(s) {
@@ -3784,7 +4005,7 @@ var McpClient = class {
 };
 
 // src/mcp/stdio.ts
-import { spawn as spawn2 } from "child_process";
+import { spawn as spawn3 } from "child_process";
 var StdioTransport = class {
   child;
   queue = [];
@@ -3799,14 +4020,14 @@ var StdioTransport = class {
         opts.command,
         ...(opts.args ?? []).map((a) => quoteArg(a, process.platform === "win32"))
       ].join(" ");
-      this.child = spawn2(line, [], {
+      this.child = spawn3(line, [], {
         env,
         cwd: opts.cwd,
         stdio: ["pipe", "pipe", "inherit"],
         shell: true
       });
     } else {
-      this.child = spawn2(opts.command, opts.args ?? [], {
+      this.child = spawn3(opts.command, opts.args ?? [], {
         env,
         cwd: opts.cwd,
         stdio: ["pipe", "pipe", "inherit"]
@@ -4136,7 +4357,7 @@ async function trySection(load) {
 }
 
 // src/code/edit-blocks.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync5, unlinkSync as unlinkSync2, writeFileSync as writeFileSync3 } from "fs";
+import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync6, unlinkSync as unlinkSync2, writeFileSync as writeFileSync3 } from "fs";
 import { dirname as dirname4, resolve as resolve4 } 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) {
@@ -4165,7 +4386,7 @@ function applyEditBlock(block, rootDir) {
     };
   }
   const searchEmpty = block.search.length === 0;
-  const exists = existsSync3(absTarget);
+  const exists = existsSync4(absTarget);
   try {
     if (!exists) {
       if (!searchEmpty) {
@@ -4179,7 +4400,7 @@ function applyEditBlock(block, rootDir) {
       writeFileSync3(absTarget, block.replace, "utf8");
       return { path: block.path, status: "created" };
     }
-    const content = readFileSync5(absTarget, "utf8");
+    const content = readFileSync6(absTarget, "utf8");
     if (searchEmpty) {
       return {
         path: block.path,
@@ -4213,12 +4434,12 @@ function snapshotBeforeEdits(blocks, rootDir) {
     if (seen.has(b.path)) continue;
     seen.add(b.path);
     const abs = resolve4(absRoot, b.path);
-    if (!existsSync3(abs)) {
+    if (!existsSync4(abs)) {
       snapshots.push({ path: b.path, prevContent: null });
       continue;
     }
     try {
-      snapshots.push({ path: b.path, prevContent: readFileSync5(abs, "utf8") });
+      snapshots.push({ path: b.path, prevContent: readFileSync6(abs, "utf8") });
     } catch {
       snapshots.push({ path: b.path, prevContent: null });
     }
@@ -4238,7 +4459,7 @@ function restoreSnapshots(snapshots, rootDir) {
     }
     try {
       if (snap.prevContent === null) {
-        if (existsSync3(abs)) unlinkSync2(abs);
+        if (existsSync4(abs)) unlinkSync2(abs);
         return {
           path: snap.path,
           status: "applied",
@@ -4260,11 +4481,109 @@ function sep() {
   return process.platform === "win32" ? "\\" : "/";
 }
 
-// src/index.ts
-var VERSION = "0.4.20";
+// src/version.ts
+import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "fs";
+import { homedir as homedir4 } from "os";
+import { dirname as dirname5, join as join5 } from "path";
+import { fileURLToPath } 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(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 6; i++) {
+      const p = join5(dir, "package.json");
+      if (existsSync5(p)) {
+        const pkg = JSON.parse(readFileSync7(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 join5(homeDirOverride ?? homedir4(), ".reasonix", "version-cache.json");
+}
+function readCache(homeDirOverride) {
+  try {
+    const raw = readFileSync7(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);
+    mkdirSync4(dirname5(p), { recursive: true });
+    writeFileSync4(p, JSON.stringify(entry), "utf8");
+  } catch {
+  }
+}
+async function getLatestVersion(opts = {}) {
+  const ttl = opts.ttlMs ?? LATEST_CACHE_TTL_MS;
+  if (!opts.force) {
+    const cached = readCache(opts.homeDir);
+    if (cached && Date.now() - cached.checkedAt < ttl) return cached.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/cli/commands/chat.tsx
-import { existsSync as existsSync4, statSync as statSync3 } from "fs";
+import { existsSync as existsSync6, statSync as statSync3 } from "fs";
 import { render } from "ink";
 import React15, { useState as useState7 } from "react";
 
@@ -5255,7 +5574,8 @@ function StatsPanel({
   harvestOn,
   branchBudget,
   planMode,
-  balance
+  balance,
+  updateAvailable
 }) {
   const hitPct = (summary.cacheHitRatio * 100).toFixed(1);
   const hitColor = summary.cacheHitRatio >= 0.7 ? "green" : summary.cacheHitRatio >= 0.4 ? "yellow" : "red";
@@ -5263,7 +5583,7 @@ function StatsPanel({
   const ctxMax = DEEPSEEK_CONTEXT_TOKENS[model] ?? DEFAULT_CONTEXT_TOKENS;
   const ctxRatio = summary.lastPromptTokens / ctxMax;
   const ctxColor = ctxRatio >= 0.8 ? "red" : ctxRatio >= 0.5 ? "yellow" : void 0;
-  return /* @__PURE__ */ React11.createElement(Box10, { borderStyle: "round", borderColor: "cyan", flexDirection: "column", paddingX: 1 }, /* @__PURE__ */ React11.createElement(Box10, { justifyContent: "space-between" }, /* @__PURE__ */ React11.createElement(Text10, null, /* @__PURE__ */ React11.createElement(Text10, { color: "cyan", bold: true }, "Reasonix"), /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, " \xB7 model "), /* @__PURE__ */ React11.createElement(Text10, { color: "yellow" }, model), /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, " \xB7 prefix "), /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, prefixHash), harvestOn ? /* @__PURE__ */ React11.createElement(Text10, { color: "magenta" }, " \xB7 harvest") : null, branchOn ? /* @__PURE__ */ React11.createElement(Text10, { color: "blue" }, " \xB7 branch", branchBudget) : null, planMode ? /* @__PURE__ */ React11.createElement(Text10, { color: "red", bold: true }, " ", "\xB7 PLAN") : null), /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, "turns ", summary.turns, " \xB7 type /help")), /* @__PURE__ */ React11.createElement(Box10, { marginTop: 1, gap: 3 }, /* @__PURE__ */ React11.createElement(Text10, null, /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, "cache hit "), /* @__PURE__ */ React11.createElement(Text10, { color: hitColor, bold: true }, hitPct, "%")), /* @__PURE__ */ React11.createElement(Text10, null, /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, "cost "), /* @__PURE__ */ React11.createElement(Text10, { color: "green", bold: true }, "$", summary.totalCostUsd.toFixed(6)), /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, " (in ", "$", summary.totalInputCostUsd.toFixed(6), " \xB7 out ", "$", summary.totalOutputCostUsd.toFixed(6), ")")), summary.lastPromptTokens > 0 ? /* @__PURE__ */ React11.createElement(Text10, null, /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, "ctx "), /* @__PURE__ */ React11.createElement(Text10, { color: ctxColor, bold: ctxColor !== void 0 }, formatTokens(summary.lastPromptTokens), "/", formatTokens(ctxMax)), /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, " (", (ctxRatio * 100).toFixed(0), "%)"), ctxRatio >= 0.8 ? /* @__PURE__ */ React11.createElement(Text10, { color: "red", bold: true }, " ", "\xB7 /compact") : null) : null, balance ? /* @__PURE__ */ React11.createElement(Text10, null, /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, "balance "), /* @__PURE__ */ React11.createElement(Text10, { color: balance.total < 1 ? "red" : balance.total < 5 ? "yellow" : "green", bold: true }, balance.currency === "USD" ? "$" : "", balance.total.toFixed(2), balance.currency !== "USD" ? ` ${balance.currency}` : "")) : null));
+  return /* @__PURE__ */ React11.createElement(Box10, { borderStyle: "round", borderColor: "cyan", flexDirection: "column", paddingX: 1 }, /* @__PURE__ */ React11.createElement(Box10, { justifyContent: "space-between" }, /* @__PURE__ */ React11.createElement(Text10, null, /* @__PURE__ */ React11.createElement(Text10, { color: "cyan", bold: true }, "Reasonix"), /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, ` v${VERSION}`), /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, " \xB7 model "), /* @__PURE__ */ React11.createElement(Text10, { color: "yellow" }, model), /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, " \xB7 prefix "), /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, prefixHash), harvestOn ? /* @__PURE__ */ React11.createElement(Text10, { color: "magenta" }, " \xB7 harvest") : null, branchOn ? /* @__PURE__ */ React11.createElement(Text10, { color: "blue" }, " \xB7 branch", branchBudget) : null, planMode ? /* @__PURE__ */ React11.createElement(Text10, { color: "red", bold: true }, " ", "\xB7 PLAN") : null), /* @__PURE__ */ React11.createElement(Text10, null, updateAvailable ? /* @__PURE__ */ React11.createElement(Text10, { color: "yellow", bold: true }, `update: ${updateAvailable} \xB7 `) : null, /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, "turns ", summary.turns, " \xB7 type /help"))), /* @__PURE__ */ React11.createElement(Box10, { marginTop: 1, gap: 3 }, /* @__PURE__ */ React11.createElement(Text10, null, /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, "cache hit "), /* @__PURE__ */ React11.createElement(Text10, { color: hitColor, bold: true }, hitPct, "%")), /* @__PURE__ */ React11.createElement(Text10, null, /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, "cost "), /* @__PURE__ */ React11.createElement(Text10, { color: "green", bold: true }, "$", summary.totalCostUsd.toFixed(6)), /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, " (in ", "$", summary.totalInputCostUsd.toFixed(6), " \xB7 out ", "$", summary.totalOutputCostUsd.toFixed(6), ")")), summary.lastPromptTokens > 0 ? /* @__PURE__ */ React11.createElement(Text10, null, /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, "ctx "), /* @__PURE__ */ React11.createElement(Text10, { color: ctxColor, bold: ctxColor !== void 0 }, formatTokens(summary.lastPromptTokens), "/", formatTokens(ctxMax)), /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, " (", (ctxRatio * 100).toFixed(0), "%)"), ctxRatio >= 0.8 ? /* @__PURE__ */ React11.createElement(Text10, { color: "red", bold: true }, " ", "\xB7 /compact") : null) : null, balance ? /* @__PURE__ */ React11.createElement(Text10, null, /* @__PURE__ */ React11.createElement(Text10, { dimColor: true }, "balance "), /* @__PURE__ */ React11.createElement(Text10, { color: balance.total < 1 ? "red" : balance.total < 5 ? "yellow" : "green", bold: true }, balance.currency === "USD" ? "$" : "", balance.total.toFixed(2), balance.currency !== "USD" ? ` ${balance.currency}` : "")) : null));
 }
 function formatTokens(n) {
   if (n < 1e3) return String(n);
@@ -5296,6 +5616,15 @@ var SLASH_COMMANDS = [
     argsHint: "[list|show <name>|<name> [args]]",
     summary: "list / run user skills (<project>/.reasonix/skills + ~/.reasonix/skills)"
   },
+  {
+    cmd: "hooks",
+    argsHint: "[reload]",
+    summary: "list active hooks (settings.json under .reasonix/) \xB7 reload re-reads from disk"
+  },
+  {
+    cmd: "update",
+    summary: "show current vs latest version + the shell command to upgrade"
+  },
   { cmd: "think", summary: "dump the last turn's full R1 reasoning (reasoner only)" },
   { cmd: "retry", summary: "truncate & resend your last message (fresh sample)" },
   { cmd: "compact", argsHint: "[cap]", summary: "shrink oversized tool results in the log" },
@@ -5469,6 +5798,13 @@ function handleSlash(cmd, args, loop, ctx = {}) {
     case "skills": {
       return handleSkillSlash(args, ctx);
     }
+    case "hook":
+    case "hooks": {
+      return handleHooksSlash(args, loop, ctx);
+    }
+    case "update": {
+      return handleUpdateSlash(ctx);
+    }
     case "think":
     case "reasoning": {
       const raw = loop.scratch.reasoning;
@@ -5705,6 +6041,93 @@ ${entry.text}`
       return { unknown: true, info: `unknown command: /${cmd}  (try /help)` };
   }
 }
+function handleUpdateSlash(ctx) {
+  const latest = ctx.latestVersion ?? null;
+  const lines = [`current: reasonix ${VERSION}`];
+  if (latest === null) {
+    ctx.refreshLatestVersion?.();
+    lines.push(
+      "latest:  (not yet resolved \u2014 background check in flight or offline)",
+      "",
+      "triggered a fresh registry fetch \u2014 retry `/update` in a few seconds,",
+      "or run `reasonix update` in another terminal to force it synchronously."
+    );
+    return { info: lines.join("\n") };
+  }
+  lines.push(`latest:  reasonix ${latest}`);
+  const diff = compareVersions(VERSION, latest);
+  if (diff >= 0) {
+    lines.push("", "you're on the latest. nothing to do.");
+    return { info: lines.join("\n") };
+  }
+  if (isNpxInstall()) {
+    lines.push(
+      "",
+      "you're running via npx \u2014 the next `npx reasonix ...` launch will auto-fetch.",
+      "to force a refresh sooner: `npm cache clean --force`."
+    );
+  } else {
+    lines.push(
+      "",
+      "to upgrade, exit this session and run:",
+      "  reasonix update           (interactive, dry-run supported via --dry-run)",
+      "  npm install -g reasonix@latest   (direct)",
+      "",
+      "in-session install is deliberately disabled \u2014 the npm spawn would",
+      "corrupt this TUI's rendering and Windows can lock the running binary."
+    );
+  }
+  return { info: lines.join("\n") };
+}
+function handleHooksSlash(args, loop, ctx) {
+  const sub = (args[0] ?? "").toLowerCase();
+  if (sub === "reload") {
+    if (!ctx.reloadHooks) {
+      return {
+        info: "/hooks reload is not available in this context (no reload callback wired)."
+      };
+    }
+    const count = ctx.reloadHooks();
+    return { info: `\u25B8 reloaded hooks \xB7 ${count} active` };
+  }
+  if (sub !== "" && sub !== "list" && sub !== "ls") {
+    return {
+      info: "usage: /hooks            list active hooks\n       /hooks reload     re-read settings.json files"
+    };
+  }
+  const hooks = loop.hooks;
+  const projPath = ctx.codeRoot ? projectSettingsPath(ctx.codeRoot) : void 0;
+  const globPath = globalSettingsPath();
+  if (hooks.length === 0) {
+    const lines2 = [
+      "no hooks configured.",
+      "",
+      "drop a settings.json with a `hooks` key into either of:",
+      ctx.codeRoot ? `  \xB7 ${projPath} (project)` : "  \xB7 <project>/.reasonix/settings.json (project)",
+      `  \xB7 ${globPath} (global)`,
+      "",
+      "events: PreToolUse, PostToolUse, UserPromptSubmit, Stop",
+      "exit 0 = pass \xB7 exit 2 = block (Pre*) \xB7 other = warn"
+    ];
+    return { info: lines2.join("\n") };
+  }
+  const grouped = /* @__PURE__ */ new Map();
+  for (const event of HOOK_EVENTS) grouped.set(event, []);
+  for (const h of hooks) grouped.get(h.event)?.push(h);
+  const lines = [`\u25B8 ${hooks.length} hook(s) loaded`];
+  for (const event of HOOK_EVENTS) {
+    const list = grouped.get(event) ?? [];
+    if (list.length === 0) continue;
+    lines.push("", `${event}:`);
+    for (const h of list) {
+      const match = h.match && h.match !== "*" ? ` match=${h.match}` : "";
+      const desc = h.description ? `  \u2014 ${h.description}` : "";
+      lines.push(`  [${h.scope}]${match} ${h.command}${desc}`);
+    }
+  }
+  lines.push("", `sources: project=${projPath ?? "(none \u2014 chat mode)"} \xB7 global=${globPath}`);
+  return { info: lines.join("\n") };
+}
 function handleSkillSlash(args, ctx) {
   const store = new SkillStore({ projectRoot: ctx.codeRoot });
   const sub = (args[0] ?? "").toLowerCase();
@@ -6030,6 +6453,12 @@ function App({
   const [toolProgress, setToolProgress] = useState5(null);
   const [statusLine, setStatusLine] = useState5(null);
   const [balance, setBalance] = useState5(null);
+  const [latestVersion, setLatestVersion] = useState5(null);
+  const updateAvailable = latestVersion && compareVersions(VERSION, latestVersion) < 0 ? latestVersion : null;
+  const [hookList, setHookList] = useState5(
+    () => loadHooks({ projectRoot: codeMode?.rootDir })
+  );
+  const hookCwd = codeMode?.rootDir ?? process.cwd();
   const lastEditSnapshots = useRef2(null);
   const pendingEdits = useRef2([]);
   const [pendingShell, setPendingShell] = useState5(null);
@@ -6085,10 +6514,23 @@ function App({
       system,
       toolSpecs: tools?.specs()
     });
-    const l = new CacheFirstLoop({ client, prefix, tools, model, harvest: harvest2, branch, session });
+    const l = new CacheFirstLoop({
+      client,
+      prefix,
+      tools,
+      model,
+      harvest: harvest2,
+      branch,
+      session,
+      hooks: hookList,
+      hookCwd
+    });
     loopRef.current = l;
     return l;
   }, [model, system, harvest2, branch, session, tools]);
+  useEffect2(() => {
+    loop.hooks = hookList;
+  }, [loop, hookList]);
   useEffect2(() => {
     let cancelled = false;
     void (async () => {
@@ -6101,6 +6543,17 @@ function App({
       cancelled = true;
     };
   }, [loop]);
+  useEffect2(() => {
+    let cancelled = false;
+    void (async () => {
+      const latest = await getLatestVersion();
+      if (cancelled || !latest) return;
+      setLatestVersion(latest);
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, []);
   useEffect2(() => {
     if (!progressSink) return;
     progressSink.current = (info) => {
@@ -6272,7 +6725,19 @@ function App({
           memoryRoot: codeMode?.rootDir ?? process.cwd(),
           planMode,
           setPlanMode: codeMode ? togglePlanMode : void 0,
-          clearPendingPlan: codeMode ? clearPendingPlan : void 0
+          clearPendingPlan: codeMode ? clearPendingPlan : void 0,
+          reloadHooks: () => {
+            const fresh = loadHooks({ projectRoot: codeMode?.rootDir });
+            setHookList(fresh);
+            return fresh.length;
+          },
+          latestVersion,
+          refreshLatestVersion: () => {
+            void (async () => {
+              const fresh = await getLatestVersion({ force: true });
+              if (fresh) setLatestVersion(fresh);
+            })();
+          }
         });
         if (result.exit) {
           transcriptRef.current?.end();
@@ -6310,6 +6775,23 @@ function App({
           return;
         }
       }
+      if (hookList.some((h) => h.event === "UserPromptSubmit")) {
+        const promptReport = await runHooks({
+          hooks: hookList,
+          payload: { event: "UserPromptSubmit", cwd: hookCwd, prompt: text }
+        });
+        if (promptReport.outcomes.length > 0) {
+          setHistorical((prev) => [
+            ...prev,
+            ...promptReport.outcomes.filter((o) => o.decision !== "pass").map((o) => ({
+              id: `hp-${Date.now()}-${Math.random()}`,
+              role: "warning",
+              text: formatHookOutcomeMessage(o)
+            }))
+          ]);
+        }
+        if (promptReport.blocked) return;
+      }
       promptHistory.current.push(text);
       setHistorical((prev) => [...prev, { id: `u-${Date.now()}`, role: "user", text }]);
       const assistantId = `a-${Date.now()}`;
@@ -6470,6 +6952,28 @@ function App({
           }
         }
         flush();
+        if (hookList.some((h) => h.event === "Stop")) {
+          const stopReport = await runHooks({
+            hooks: hookList,
+            payload: {
+              event: "Stop",
+              cwd: hookCwd,
+              lastAssistantText: streamRef.text,
+              turn: loop.stats.summary().turns
+            }
+          });
+          for (const o of stopReport.outcomes) {
+            if (o.decision === "pass") continue;
+            setHistorical((prev) => [
+              ...prev,
+              {
+                id: `hs-${Date.now()}-${Math.random()}`,
+                role: "warning",
+                text: formatHookOutcomeMessage(o)
+              }
+            ]);
+          }
+        }
       } finally {
         if (timer) clearInterval(timer);
         setStreaming(null);
@@ -6495,7 +6999,10 @@ function App({
       codeMode,
       codeUndo,
       exit,
+      hookCwd,
+      hookList,
       loop,
+      latestVersion,
       mcpSpecs,
       mcpServers,
       planMode,
@@ -6659,7 +7166,8 @@ Stay in plan mode \u2014 address the feedback (explore more if needed), then sub
       harvestOn: loop.harvestEnabled,
       branchBudget: loop.branchOptions.budget,
       planMode,
-      balance
+      balance,
+      updateAvailable
     }
   ), /* @__PURE__ */ React12.createElement(Static, { items: historical }, (item) => /* @__PURE__ */ React12.createElement(EventRow, { key: item.id, event: item })), !PLAIN_UI && !pendingShell && !pendingPlan && !stagedInput && streaming ? /* @__PURE__ */ React12.createElement(Box11, { marginY: 1 }, /* @__PURE__ */ React12.createElement(EventRow, { event: streaming })) : null, !PLAIN_UI && !pendingShell && !pendingPlan && !stagedInput && ongoingTool ? /* @__PURE__ */ React12.createElement(OngoingToolRow, { tool: ongoingTool, progress: toolProgress }) : null, !PLAIN_UI && !pendingShell && !pendingPlan && !stagedInput && !ongoingTool && statusLine ? /* @__PURE__ */ React12.createElement(StatusRow, { text: statusLine }) : null, !PLAIN_UI && !pendingShell && !pendingPlan && !stagedInput && busy && !streaming && !ongoingTool && !statusLine ? /* @__PURE__ */ React12.createElement(StatusRow, { text: "processing\u2026" }) : null, stagedInput ? /* @__PURE__ */ React12.createElement(
     PlanRefineInput,
@@ -7016,7 +7524,7 @@ async function chatCommand(opts) {
     const prior = loadSessionMessages(opts.session);
     if (prior.length > 0) {
       const p = sessionPath(opts.session);
-      const mtime = existsSync4(p) ? statSync3(p).mtime : /* @__PURE__ */ new Date();
+      const mtime = existsSync6(p) ? statSync3(p).mtime : /* @__PURE__ */ new Date();
       sessionPreview = { messageCount: prior.length, lastActive: mtime };
     }
   } else if (opts.session && opts.forceNew) {
@@ -7085,7 +7593,7 @@ async function codeCommand(opts = {}) {
 }
 
 // src/cli/commands/diff.ts
-import { writeFileSync as writeFileSync4 } from "fs";
+import { writeFileSync as writeFileSync5 } from "fs";
 import { basename as basename2 } from "path";
 import { render as render2 } from "ink";
 import React18 from "react";
@@ -7231,7 +7739,7 @@ async function diffCommand(opts) {
   if (wantMarkdown) {
     console.log(renderSummaryTable(report));
     const md = renderMarkdown(report);
-    writeFileSync4(opts.mdPath, md, "utf8");
+    writeFileSync5(opts.mdPath, md, "utf8");
     console.log(`
 markdown report written to ${opts.mdPath}`);
     return;
@@ -8038,13 +8546,13 @@ async function setupCommand(_opts = {}) {
 }
 
 // src/cli/commands/stats.ts
-import { existsSync as existsSync5, readFileSync as readFileSync6 } from "fs";
+import { existsSync as existsSync7, readFileSync as readFileSync8 } from "fs";
 function statsCommand(opts) {
-  if (!existsSync5(opts.transcript)) {
+  if (!existsSync7(opts.transcript)) {
     console.error(`no such transcript: ${opts.transcript}`);
     process.exit(1);
   }
-  const lines = readFileSync6(opts.transcript, "utf8").split(/\r?\n/).filter(Boolean);
+  const lines = readFileSync8(opts.transcript, "utf8").split(/\r?\n/).filter(Boolean);
   let assistantTurns = 0;
   let toolCalls = 0;
   let lastTurn = 0;
@@ -8063,6 +8571,84 @@ function statsCommand(opts) {
   console.log(`last turn index:  ${lastTurn}`);
 }
 
+// src/cli/commands/update.ts
+import { spawn as spawn4 } from "child_process";
+function planUpdate(input) {
+  const diff = compareVersions(input.current, input.latest);
+  if (diff > 0) {
+    return {
+      action: "newer-local",
+      message: `current (${input.current}) is newer than the published ${input.latest} \u2014 nothing to do.`
+    };
+  }
+  if (diff === 0) {
+    return { action: "up-to-date", message: `reasonix ${input.current} is up to date.` };
+  }
+  if (input.npx) {
+    return {
+      action: "npx-hint",
+      message: [
+        `reasonix ${input.latest} is available.`,
+        "you're running via npx \u2014 the next `npx reasonix ...` launch will auto-fetch",
+        "the latest (npx caches packages for a short window). to force a refresh",
+        "sooner, clear the cache: `npm cache clean --force`."
+      ].join("\n")
+    };
+  }
+  return {
+    action: "run-npm-install",
+    message: `upgrading reasonix ${input.current} \u2192 ${input.latest}`,
+    command: ["npm", "install", "-g", "reasonix@latest"]
+  };
+}
+function defaultSpawn(argv) {
+  return new Promise((resolve6, reject) => {
+    const child = spawn4(argv[0], argv.slice(1), {
+      stdio: "inherit",
+      shell: process.platform === "win32"
+    });
+    child.once("error", reject);
+    child.once("exit", (code) => resolve6(code ?? 1));
+  });
+}
+async function updateCommand(opts = {}) {
+  const write = opts.write ?? ((m) => process.stdout.write(m));
+  const exit = opts.exit ?? ((c) => process.exit(c));
+  const fetchLatest = opts.fetchLatest ?? (() => getLatestVersion({ force: true }));
+  const isNpx = opts.isNpx ?? isNpxInstall;
+  const doSpawn = opts.spawnInstall ?? defaultSpawn;
+  write(`current: reasonix ${VERSION}
+`);
+  const latest = await fetchLatest();
+  if (!latest) {
+    write("could not reach registry.npmjs.org \u2014 check your network.\n");
+    exit(1);
+    return;
+  }
+  write(`latest:  reasonix ${latest}
+`);
+  const plan = planUpdate({ current: VERSION, latest, npx: isNpx() });
+  write(`
+${plan.message}
+`);
+  if (plan.action !== "run-npm-install" || !plan.command) return;
+  if (opts.dryRun) {
+    write(`(dry run) would run: ${plan.command.join(" ")}
+`);
+    return;
+  }
+  write(`
+running: ${plan.command.join(" ")}
+`);
+  const code = await doSpawn(plan.command);
+  if (code !== 0) {
+    write(`
+npm exited with code ${code}. upgrade did not complete.
+`);
+    exit(code);
+  }
+}
+
 // src/cli/commands/version.ts
 function versionCommand() {
   console.log(`reasonix ${VERSION}`);
@@ -8255,6 +8841,11 @@ mcp.command("inspect <spec>").description(
   }
 });
 program.command("version").description("Print Reasonix version.").action(versionCommand);
+program.command("update").description(
+  "Check the npm registry for a newer Reasonix and install it. Detects npx vs global install; for npx users, prints a cache-refresh hint instead of running `npm i -g`."
+).option("--dry-run", "Print the plan without executing the install").action(async (opts) => {
+  await updateCommand({ dryRun: !!opts.dryRun });
+});
 program.parseAsync(process.argv).catch((err) => {
   console.error(err);
   process.exit(1);