reasonix 0.4.20 → 0.4.22

package/dist/index.js

@@ -47,8 +47,8 @@ function computeWait(attempt, initial, cap, retryAfter) {
 }
 function sleep(ms, signal) {
   if (ms <= 0) return Promise.resolve();
-  return new Promise((resolve6, reject) => {
-    const timer = setTimeout(resolve6, ms);
+  return new Promise((resolve7, reject) => {
+    const timer = setTimeout(resolve7, ms);
     if (signal) {
       const onAbort = () => {
         clearTimeout(timer);
@@ -1537,8 +1537,8 @@ var CacheFirstLoop = class {
             }
           );
           for (let k = 0; k < budget; k++) {
-            const sample = queue.shift() ?? await new Promise((resolve6) => {
-              waiter = resolve6;
+            const sample = queue.shift() ?? await new Promise((resolve7) => {
+              waiter = resolve7;
             });
             yield {
               turn: this._turn,
@@ -1953,15 +1953,171 @@ ${mem.content}
 // src/user-memory.ts
 import { createHash as createHash2 } from "crypto";
 import {
-  existsSync as existsSync3,
+  existsSync as existsSync4,
   mkdirSync as mkdirSync2,
-  readFileSync as readFileSync3,
-  readdirSync as readdirSync2,
+  readFileSync as readFileSync4,
+  readdirSync as readdirSync3,
   unlinkSync as unlinkSync2,
   writeFileSync as writeFileSync2
 } from "fs";
+import { homedir as homedir3 } from "os";
+import { join as join4, resolve as resolve2 } from "path";
+
+// src/skills.ts
+import { existsSync as existsSync3, readFileSync as readFileSync3, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
 import { homedir as homedir2 } from "os";
 import { join as join3, resolve } from "path";
+var SKILLS_DIRNAME = "skills";
+var SKILL_FILE = "SKILL.md";
+var SKILLS_INDEX_MAX_CHARS = 4e3;
+var VALID_SKILL_NAME = /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,63}$/;
+function parseFrontmatter(raw) {
+  const lines = raw.split(/\r?\n/);
+  if (lines[0] !== "---") return { data: {}, body: raw };
+  const end = lines.indexOf("---", 1);
+  if (end < 0) return { data: {}, body: raw };
+  const data = {};
+  for (let i = 1; i < end; i++) {
+    const line = lines[i];
+    if (!line) continue;
+    const m = line.match(/^([a-zA-Z_][a-zA-Z0-9_-]*):\s*(.*)$/);
+    if (m?.[1]) data[m[1]] = (m[2] ?? "").trim();
+  }
+  return {
+    data,
+    body: lines.slice(end + 1).join("\n").replace(/^\n+/, "")
+  };
+}
+function isValidSkillName(name) {
+  return VALID_SKILL_NAME.test(name);
+}
+var SkillStore = class {
+  homeDir;
+  projectRoot;
+  constructor(opts = {}) {
+    this.homeDir = opts.homeDir ?? homedir2();
+    this.projectRoot = opts.projectRoot ? resolve(opts.projectRoot) : void 0;
+  }
+  /** True iff this store was configured with a project root. */
+  hasProjectScope() {
+    return this.projectRoot !== void 0;
+  }
+  /**
+   * Root directories scanned, in priority order. Project scope first
+   * so a per-repo skill overrides a global one with the same name —
+   * users expect the local copy to win when both exist.
+   */
+  roots() {
+    const out = [];
+    if (this.projectRoot) {
+      out.push({
+        dir: join3(this.projectRoot, ".reasonix", SKILLS_DIRNAME),
+        scope: "project"
+      });
+    }
+    out.push({ dir: join3(this.homeDir, ".reasonix", SKILLS_DIRNAME), scope: "global" });
+    return out;
+  }
+  /**
+   * List every skill visible to this store. On name collisions the
+   * higher-priority root (project over global) wins. Sorted by name
+   * for stable prefix hashing.
+   */
+  list() {
+    const byName = /* @__PURE__ */ new Map();
+    for (const { dir, scope } of this.roots()) {
+      if (!existsSync3(dir)) continue;
+      let entries;
+      try {
+        entries = readdirSync2(dir, { withFileTypes: true });
+      } catch {
+        continue;
+      }
+      for (const entry of entries) {
+        const skill = this.readEntry(dir, scope, entry);
+        if (!skill) continue;
+        if (!byName.has(skill.name)) byName.set(skill.name, skill);
+      }
+    }
+    return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
+  }
+  /** Resolve one skill by name. Returns `null` if not found or malformed. */
+  read(name) {
+    if (!isValidSkillName(name)) return null;
+    for (const { dir, scope } of this.roots()) {
+      if (!existsSync3(dir)) continue;
+      const dirCandidate = join3(dir, name, SKILL_FILE);
+      if (existsSync3(dirCandidate) && statSync2(dirCandidate).isFile()) {
+        return this.parse(dirCandidate, name, scope);
+      }
+      const flatCandidate = join3(dir, `${name}.md`);
+      if (existsSync3(flatCandidate) && statSync2(flatCandidate).isFile()) {
+        return this.parse(flatCandidate, name, scope);
+      }
+    }
+    return null;
+  }
+  readEntry(dir, scope, entry) {
+    if (entry.isDirectory()) {
+      if (!isValidSkillName(entry.name)) return null;
+      const file = join3(dir, entry.name, SKILL_FILE);
+      if (!existsSync3(file)) return null;
+      return this.parse(file, entry.name, scope);
+    }
+    if (entry.isFile() && entry.name.endsWith(".md")) {
+      const stem = entry.name.slice(0, -3);
+      if (!isValidSkillName(stem)) return null;
+      return this.parse(join3(dir, entry.name), stem, scope);
+    }
+    return null;
+  }
+  parse(path, stem, scope) {
+    let raw;
+    try {
+      raw = readFileSync3(path, "utf8");
+    } catch {
+      return null;
+    }
+    const { data, body } = parseFrontmatter(raw);
+    const name = data.name && isValidSkillName(data.name) ? data.name : stem;
+    return {
+      name,
+      description: (data.description ?? "").trim(),
+      body: body.trim(),
+      scope,
+      path,
+      allowedTools: data["allowed-tools"]
+    };
+  }
+};
+function skillIndexLine(s) {
+  const safeDesc = s.description.replace(/\n/g, " ").trim();
+  const max = 130 - s.name.length;
+  const clipped = safeDesc.length > max ? `${safeDesc.slice(0, Math.max(1, max - 1))}\u2026` : safeDesc;
+  return clipped ? `- ${s.name} \u2014 ${clipped}` : `- ${s.name}`;
+}
+function applySkillsIndex(basePrompt, opts = {}) {
+  const store = new SkillStore(opts);
+  const skills = store.list().filter((s) => s.description);
+  if (skills.length === 0) return basePrompt;
+  const lines = skills.map(skillIndexLine);
+  const joined = lines.join("\n");
+  const truncated = joined.length > SKILLS_INDEX_MAX_CHARS ? `${joined.slice(0, SKILLS_INDEX_MAX_CHARS)}
+\u2026 (truncated ${joined.length - SKILLS_INDEX_MAX_CHARS} chars)` : joined;
+  return [
+    basePrompt,
+    "",
+    "# Skills \u2014 user-defined prompt packs",
+    "",
+    'One-liner index. Each skill is a self-contained instruction block (plus optional tool hints) the user or an earlier session saved. To load the full body, call `run_skill({ name: "<skill-name>" })` \u2014 the body is NOT in this prompt, only the name and description are. The user can also invoke a skill directly as `/skill <name>`.',
+    "",
+    "```",
+    truncated,
+    "```"
+  ].join("\n");
+}
+
+// src/user-memory.ts
 var USER_MEMORY_DIR = "memory";
 var MEMORY_INDEX_FILE = "MEMORY.md";
 var MEMORY_INDEX_MAX_CHARS = 4e3;
@@ -1976,22 +2132,22 @@ function sanitizeMemoryName(raw) {
   return trimmed;
 }
 function projectHash(rootDir) {
-  const abs = resolve(rootDir);
+  const abs = resolve2(rootDir);
   return createHash2("sha1").update(abs).digest("hex").slice(0, 16);
 }
 function scopeDir(opts) {
   if (opts.scope === "global") {
-    return join3(opts.homeDir, USER_MEMORY_DIR, "global");
+    return join4(opts.homeDir, USER_MEMORY_DIR, "global");
   }
   if (!opts.projectRoot) {
     throw new Error("scope=project requires a projectRoot on MemoryStore");
   }
-  return join3(opts.homeDir, USER_MEMORY_DIR, projectHash(opts.projectRoot));
+  return join4(opts.homeDir, USER_MEMORY_DIR, projectHash(opts.projectRoot));
 }
 function ensureDir(p) {
-  if (!existsSync3(p)) mkdirSync2(p, { recursive: true });
+  if (!existsSync4(p)) mkdirSync2(p, { recursive: true });
 }
-function parseFrontmatter(raw) {
+function parseFrontmatter2(raw) {
   const lines = raw.split(/\r?\n/);
   if (lines[0] !== "---") return { data: {}, body: raw };
   const end = lines.indexOf("---", 1);
@@ -2034,8 +2190,8 @@ var MemoryStore = class {
   homeDir;
   projectRoot;
   constructor(opts = {}) {
-    this.homeDir = opts.homeDir ?? join3(homedir2(), ".reasonix");
-    this.projectRoot = opts.projectRoot ? resolve(opts.projectRoot) : void 0;
+    this.homeDir = opts.homeDir ?? join4(homedir3(), ".reasonix");
+    this.projectRoot = opts.projectRoot ? resolve2(opts.projectRoot) : void 0;
   }
   /** Directory this store writes `scope` files into, creating it if needed. */
   dir(scope) {
@@ -2045,7 +2201,7 @@ var MemoryStore = class {
   }
   /** Absolute path to a memory file (no existence check). */
   pathFor(scope, name) {
-    return join3(this.dir(scope), `${sanitizeMemoryName(name)}.md`);
+    return join4(this.dir(scope), `${sanitizeMemoryName(name)}.md`);
   }
   /** True iff this store is configured with a project scope available. */
   hasProjectScope() {
@@ -2057,14 +2213,14 @@ var MemoryStore = class {
    */
   loadIndex(scope) {
     if (scope === "project" && !this.projectRoot) return null;
-    const file = join3(
+    const file = join4(
       scopeDir({ homeDir: this.homeDir, scope, projectRoot: this.projectRoot }),
       MEMORY_INDEX_FILE
     );
-    if (!existsSync3(file)) return null;
+    if (!existsSync4(file)) return null;
     let raw;
     try {
-      raw = readFileSync3(file, "utf8");
+      raw = readFileSync4(file, "utf8");
     } catch {
       return null;
     }
@@ -2079,11 +2235,11 @@ var MemoryStore = class {
   /** Read one memory file's body (frontmatter stripped). Throws if missing. */
   read(scope, name) {
     const file = this.pathFor(scope, name);
-    if (!existsSync3(file)) {
+    if (!existsSync4(file)) {
       throw new Error(`memory not found: scope=${scope} name=${name}`);
     }
-    const raw = readFileSync3(file, "utf8");
-    const { data, body } = parseFrontmatter(raw);
+    const raw = readFileSync4(file, "utf8");
+    const { data, body } = parseFrontmatter2(raw);
     return {
       name: data.name ?? name,
       type: data.type ?? "project",
@@ -2103,10 +2259,10 @@ var MemoryStore = class {
     const scopes = this.projectRoot ? ["global", "project"] : ["global"];
     for (const scope of scopes) {
       const dir = scopeDir({ homeDir: this.homeDir, scope, projectRoot: this.projectRoot });
-      if (!existsSync3(dir)) continue;
+      if (!existsSync4(dir)) continue;
       let entries;
       try {
-        entries = readdirSync2(dir);
+        entries = readdirSync3(dir);
       } catch {
         continue;
       }
@@ -2144,7 +2300,7 @@ var MemoryStore = class {
       createdAt: todayIso()
     };
     const dir = this.dir(input.scope);
-    const file = join3(dir, `${name}.md`);
+    const file = join4(dir, `${name}.md`);
     const content = `${formatFrontmatter(entry)}${body}
 `;
     writeFileSync2(file, content, "utf8");
@@ -2157,7 +2313,7 @@ var MemoryStore = class {
       throw new Error("cannot delete project-scoped memory: no projectRoot configured");
     }
     const file = this.pathFor(scope, rawName);
-    if (!existsSync3(file)) return false;
+    if (!existsSync4(file)) return false;
     unlinkSync2(file);
     this.regenerateIndex(scope);
     return true;
@@ -2170,17 +2326,17 @@ var MemoryStore = class {
    */
   regenerateIndex(scope) {
     const dir = scopeDir({ homeDir: this.homeDir, scope, projectRoot: this.projectRoot });
-    if (!existsSync3(dir)) return;
+    if (!existsSync4(dir)) return;
     let files;
     try {
-      files = readdirSync2(dir);
+      files = readdirSync3(dir);
     } catch {
       return;
     }
     const mdFiles = files.filter((f) => f !== MEMORY_INDEX_FILE && f.endsWith(".md")).sort((a, b) => a.localeCompare(b));
-    const indexPath = join3(dir, MEMORY_INDEX_FILE);
+    const indexPath = join4(dir, MEMORY_INDEX_FILE);
     if (mdFiles.length === 0) {
-      if (existsSync3(indexPath)) unlinkSync2(indexPath);
+      if (existsSync4(indexPath)) unlinkSync2(indexPath);
       return;
     }
     const lines = [];
@@ -2232,7 +2388,8 @@ function applyUserMemory(basePrompt, opts = {}) {
 }
 function applyMemoryStack(basePrompt, rootDir) {
   const withProject = applyProjectMemory(basePrompt, rootDir);
-  return applyUserMemory(withProject, { projectRoot: rootDir });
+  const withMemory = applyUserMemory(withProject, { projectRoot: rootDir });
+  return applySkillsIndex(withMemory, { projectRoot: rootDir });
 }
 
 // src/tools/filesystem.ts
@@ -2743,7 +2900,7 @@ function registerPlanTool(registry, opts = {}) {
 
 // src/tools/shell.ts
 import { spawn } from "child_process";
-import { existsSync as existsSync4, statSync as statSync2 } from "fs";
+import { existsSync as existsSync5, statSync as statSync3 } from "fs";
 import * as pathMod2 from "path";
 var DEFAULT_TIMEOUT_SEC = 60;
 var DEFAULT_MAX_OUTPUT_CHARS = 32e3;
@@ -2863,7 +3020,7 @@ async function runCommand(cmd, opts) {
   };
   const { bin, args, spawnOverrides } = prepareSpawn(argv);
   const effectiveSpawnOpts = { ...spawnOpts, ...spawnOverrides };
-  return await new Promise((resolve6, reject) => {
+  return await new Promise((resolve7, reject) => {
     let child;
     try {
       child = spawn(bin, args, effectiveSpawnOpts);
@@ -2896,7 +3053,7 @@ async function runCommand(cmd, opts) {
       const output = buf.length > maxChars ? `${buf.slice(0, maxChars)}
 
 [\u2026 truncated ${buf.length - maxChars} chars \u2026]` : buf;
-      resolve6({ exitCode: code, output, timedOut });
+      resolve7({ exitCode: code, output, timedOut });
     });
   });
 }
@@ -2921,7 +3078,7 @@ function resolveExecutable(cmd, opts = {}) {
 }
 function defaultIsFile(full) {
   try {
-    return existsSync4(full) && statSync2(full).isFile();
+    return existsSync5(full) && statSync3(full).isFile();
   } catch {
     return false;
   }
@@ -2946,8 +3103,23 @@ function prepareSpawn(argv, opts = {}) {
       spawnOverrides: { windowsVerbatimArguments: true }
     };
   }
+  if (isBareWindowsName(resolved) && resolved === head) {
+    const cmdline = [head, ...tail].map(quoteForCmdExe).join(" ");
+    return {
+      bin: "cmd.exe",
+      args: ["/d", "/s", "/c", cmdline],
+      spawnOverrides: { windowsVerbatimArguments: true }
+    };
+  }
   return { bin: resolved, args: [...tail], spawnOverrides: {} };
 }
+function isBareWindowsName(s) {
+  if (!s) return false;
+  if (s.includes("/") || s.includes("\\")) return false;
+  if (pathMod2.isAbsolute(s)) return false;
+  if (pathMod2.extname(s)) return false;
+  return true;
+}
 function quoteForCmdExe(arg) {
   if (arg === "") return '""';
   if (!/[\s"&|<>^%(),;!]/.test(arg)) return arg;
@@ -2967,7 +3139,10 @@ function registerShellTools(registry, opts) {
   const rootDir = pathMod2.resolve(opts.rootDir);
   const timeoutSec = opts.timeoutSec ?? DEFAULT_TIMEOUT_SEC;
   const maxOutputChars = opts.maxOutputChars ?? DEFAULT_MAX_OUTPUT_CHARS;
-  const extraAllowed = opts.extraAllowed ?? [];
+  const getExtraAllowed = typeof opts.extraAllowed === "function" ? opts.extraAllowed : (() => {
+    const snapshot = opts.extraAllowed ?? [];
+    return () => snapshot;
+  })();
   const allowAll = opts.allowAll ?? false;
   registry.register({
     name: "run_command",
@@ -2980,7 +3155,7 @@ function registerShellTools(registry, opts) {
       if (allowAll) return true;
       const cmd = typeof args?.command === "string" ? args.command.trim() : "";
       if (!cmd) return false;
-      return isAllowed(cmd, extraAllowed);
+      return isAllowed(cmd, getExtraAllowed());
     },
     parameters: {
       type: "object",
@@ -2999,7 +3174,7 @@ function registerShellTools(registry, opts) {
     fn: async (args, ctx) => {
       const cmd = args.command.trim();
       if (!cmd) throw new Error("run_command: empty command");
-      if (!allowAll && !isAllowed(cmd, extraAllowed)) {
+      if (!allowAll && !isAllowed(cmd, getExtraAllowed())) {
         throw new NeedsConfirmationError(cmd);
       }
       const effectiveTimeout = Math.max(1, Math.min(600, args.timeoutSec ?? timeoutSec));
@@ -3206,12 +3381,12 @@ ${i + 1}. ${r.title}`);
 }
 
 // src/env.ts
-import { readFileSync as readFileSync4 } from "fs";
-import { resolve as resolve4 } from "path";
+import { readFileSync as readFileSync5 } from "fs";
+import { resolve as resolve5 } from "path";
 function loadDotenv(path = ".env") {
   let raw;
   try {
-    raw = readFileSync4(resolve4(process.cwd(), path), "utf8");
+    raw = readFileSync5(resolve5(process.cwd(), path), "utf8");
   } catch {
     return;
   }
@@ -3230,7 +3405,7 @@ function loadDotenv(path = ".env") {
 }
 
 // src/transcript.ts
-import { createWriteStream, readFileSync as readFileSync5 } from "fs";
+import { createWriteStream, readFileSync as readFileSync6 } from "fs";
 function recordFromLoopEvent(ev, extra) {
   const rec = {
     ts: (/* @__PURE__ */ new Date()).toISOString(),
@@ -3281,7 +3456,7 @@ function openTranscriptFile(path, meta) {
   return stream;
 }
 function readTranscript(path) {
-  const raw = readFileSync5(path, "utf8");
+  const raw = readFileSync6(path, "utf8");
   return parseTranscript(raw);
 }
 function isPlanStateEmptyShape(s) {
@@ -3893,7 +4068,7 @@ var McpClient = class {
     const id = this.nextId++;
     const frame = { jsonrpc: "2.0", id, method, params };
     let abortHandler = null;
-    const promise = new Promise((resolve6, reject) => {
+    const promise = new Promise((resolve7, reject) => {
       const timeout = setTimeout(() => {
         this.pending.delete(id);
         if (abortHandler && signal) signal.removeEventListener("abort", abortHandler);
@@ -3902,7 +4077,7 @@ var McpClient = class {
         );
       }, this.requestTimeoutMs);
       this.pending.set(id, {
-        resolve: resolve6,
+        resolve: resolve7,
         reject,
         timeout
       });
@@ -4025,12 +4200,12 @@ var StdioTransport = class {
   }
   async send(message) {
     if (this.closed) throw new Error("MCP transport is closed");
-    return new Promise((resolve6, reject) => {
+    return new Promise((resolve7, reject) => {
       const line = `${JSON.stringify(message)}
 `;
       this.child.stdin.write(line, "utf8", (err) => {
         if (err) reject(err);
-        else resolve6();
+        else resolve7();
       });
     });
   }
@@ -4041,8 +4216,8 @@ var StdioTransport = class {
         continue;
       }
       if (this.closed) return;
-      const next = await new Promise((resolve6) => {
-        this.waiters.push(resolve6);
+      const next = await new Promise((resolve7) => {
+        this.waiters.push(resolve7);
       });
       if (next === null) return;
       yield next;
@@ -4108,8 +4283,8 @@ var SseTransport = class {
   constructor(opts) {
     this.url = opts.url;
     this.headers = opts.headers ?? {};
-    this.endpointReady = new Promise((resolve6, reject) => {
-      this.resolveEndpoint = resolve6;
+    this.endpointReady = new Promise((resolve7, reject) => {
+      this.resolveEndpoint = resolve7;
       this.rejectEndpoint = reject;
     });
     this.endpointReady.catch(() => void 0);
@@ -4136,8 +4311,8 @@ var SseTransport = class {
         continue;
       }
       if (this.closed) return;
-      const next = await new Promise((resolve6) => {
-        this.waiters.push(resolve6);
+      const next = await new Promise((resolve7) => {
+        this.waiters.push(resolve7);
       });
       if (next === null) return;
       yield next;
@@ -4336,8 +4511,8 @@ async function trySection(load) {
 }
 
 // src/code/edit-blocks.ts
-import { existsSync as existsSync5, mkdirSync as mkdirSync3, readFileSync as readFileSync6, unlinkSync as unlinkSync3, writeFileSync as writeFileSync3 } from "fs";
-import { dirname as dirname3, resolve as resolve5 } from "path";
+import { existsSync as existsSync6, mkdirSync as mkdirSync3, readFileSync as readFileSync7, unlinkSync as unlinkSync3, writeFileSync as writeFileSync3 } from "fs";
+import { dirname as dirname3, 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 = [];
@@ -4355,8 +4530,8 @@ function parseEditBlocks(text) {
   return out;
 }
 function applyEditBlock(block, rootDir) {
-  const absRoot = resolve5(rootDir);
-  const absTarget = resolve5(absRoot, block.path);
+  const absRoot = resolve6(rootDir);
+  const absTarget = resolve6(absRoot, block.path);
   if (absTarget !== absRoot && !absTarget.startsWith(`${absRoot}${sep()}`)) {
     return {
       path: block.path,
@@ -4365,7 +4540,7 @@ function applyEditBlock(block, rootDir) {
     };
   }
   const searchEmpty = block.search.length === 0;
-  const exists = existsSync5(absTarget);
+  const exists = existsSync6(absTarget);
   try {
     if (!exists) {
       if (!searchEmpty) {
@@ -4379,7 +4554,7 @@ function applyEditBlock(block, rootDir) {
       writeFileSync3(absTarget, block.replace, "utf8");
       return { path: block.path, status: "created" };
     }
-    const content = readFileSync6(absTarget, "utf8");
+    const content = readFileSync7(absTarget, "utf8");
     if (searchEmpty) {
       return {
         path: block.path,
@@ -4406,19 +4581,19 @@ function applyEditBlocks(blocks, rootDir) {
   return blocks.map((b) => applyEditBlock(b, rootDir));
 }
 function snapshotBeforeEdits(blocks, rootDir) {
-  const absRoot = resolve5(rootDir);
+  const absRoot = resolve6(rootDir);
   const seen = /* @__PURE__ */ new Set();
   const snapshots = [];
   for (const b of blocks) {
     if (seen.has(b.path)) continue;
     seen.add(b.path);
-    const abs = resolve5(absRoot, b.path);
-    if (!existsSync5(abs)) {
+    const abs = resolve6(absRoot, b.path);
+    if (!existsSync6(abs)) {
       snapshots.push({ path: b.path, prevContent: null });
       continue;
     }
     try {
-      snapshots.push({ path: b.path, prevContent: readFileSync6(abs, "utf8") });
+      snapshots.push({ path: b.path, prevContent: readFileSync7(abs, "utf8") });
     } catch {
       snapshots.push({ path: b.path, prevContent: null });
     }
@@ -4426,9 +4601,9 @@ function snapshotBeforeEdits(blocks, rootDir) {
   return snapshots;
 }
 function restoreSnapshots(snapshots, rootDir) {
-  const absRoot = resolve5(rootDir);
+  const absRoot = resolve6(rootDir);
   return snapshots.map((snap) => {
-    const abs = resolve5(absRoot, snap.path);
+    const abs = resolve6(absRoot, snap.path);
     if (abs !== absRoot && !abs.startsWith(`${absRoot}${sep()}`)) {
       return {
         path: snap.path,
@@ -4438,7 +4613,7 @@ function restoreSnapshots(snapshots, rootDir) {
     }
     try {
       if (snap.prevContent === null) {
-        if (existsSync5(abs)) unlinkSync3(abs);
+        if (existsSync6(abs)) unlinkSync3(abs);
         return {
           path: snap.path,
           status: "applied",
@@ -4461,8 +4636,8 @@ function sep() {
 }
 
 // src/code/prompt.ts
-import { existsSync as existsSync6, readFileSync as readFileSync7 } from "fs";
-import { join as join5 } from "path";
+import { existsSync as existsSync7, readFileSync as readFileSync8 } from "fs";
+import { join as join6 } from "path";
 var CODE_SYSTEM_PROMPT = `You are Reasonix Code, a coding assistant. You have filesystem tools (read_file, write_file, list_directory, search_files, etc.) rooted at the user's working directory.
 
 # When to propose a plan (submit_plan)
@@ -4537,11 +4712,11 @@ Before exploring the filesystem to answer a factual question, check whether the
 `;
 function codeSystemPrompt(rootDir) {
   const withMemory = applyMemoryStack(CODE_SYSTEM_PROMPT, rootDir);
-  const gitignorePath = join5(rootDir, ".gitignore");
-  if (!existsSync6(gitignorePath)) return withMemory;
+  const gitignorePath = join6(rootDir, ".gitignore");
+  if (!existsSync7(gitignorePath)) return withMemory;
   let content;
   try {
-    content = readFileSync7(gitignorePath, "utf8");
+    content = readFileSync8(gitignorePath, "utf8");
   } catch {
     return withMemory;
   }
@@ -4561,15 +4736,15 @@ ${truncated}
 }
 
 // src/config.ts
-import { chmodSync as chmodSync2, mkdirSync as mkdirSync4, readFileSync as readFileSync8, writeFileSync as writeFileSync4 } from "fs";
-import { homedir as homedir3 } from "os";
-import { dirname as dirname4, join as join6 } from "path";
+import { chmodSync as chmodSync2, mkdirSync as mkdirSync4, readFileSync as readFileSync9, writeFileSync as writeFileSync4 } from "fs";
+import { homedir as homedir4 } from "os";
+import { dirname as dirname4, join as join7 } from "path";
 function defaultConfigPath() {
-  return join6(homedir3(), ".reasonix", "config.json");
+  return join7(homedir4(), ".reasonix", "config.json");
 }
 function readConfig(path = defaultConfigPath()) {
   try {
-    const raw = readFileSync8(path, "utf8");
+    const raw = readFileSync9(path, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed && typeof parsed === "object") return parsed;
   } catch {
@@ -4603,8 +4778,106 @@ function redactKey(key) {
   return `${key.slice(0, 6)}\u2026${key.slice(-4)}`;
 }
 
-// src/index.ts
-var VERSION = "0.4.20";
+// src/version.ts
+import { existsSync as existsSync8, mkdirSync as mkdirSync5, readFileSync as readFileSync10, writeFileSync as writeFileSync5 } from "fs";
+import { homedir as homedir5 } from "os";
+import { dirname as dirname5, join as join8 } 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 = join8(dir, "package.json");
+      if (existsSync8(p)) {
+        const pkg = JSON.parse(readFileSync10(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 join8(homeDirOverride ?? homedir5(), ".reasonix", "version-cache.json");
+}
+function readCache(homeDirOverride) {
+  try {
+    const raw = readFileSync10(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);
+    mkdirSync5(dirname5(p), { recursive: true });
+    writeFileSync5(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;
+}
 export {
   AppendOnlyLog,
   CODE_SYSTEM_PROMPT,
@@ -4612,6 +4885,8 @@ export {
   DEFAULT_MAX_RESULT_CHARS,
   DeepSeekClient,
   ImmutablePrefix,
+  LATEST_CACHE_TTL_MS,
+  LATEST_FETCH_TIMEOUT_MS,
   MCP_PROTOCOL_VERSION,
   MEMORY_INDEX_FILE,
   MEMORY_INDEX_MAX_CHARS,
@@ -4642,6 +4917,7 @@ export {
   bridgeMcpTools,
   claudeEquivalentCost,
   codeSystemPrompt,
+  compareVersions,
   computeReplayStats,
   costUsd,
   defaultConfigPath,
@@ -4655,6 +4931,7 @@ export {
   formatCommandResult,
   formatLoopError,
   formatSearchResults,
+  getLatestVersion,
   harvest,
   healLoadedMessages,
   htmlToText,
@@ -4662,6 +4939,7 @@ export {
   inspectMcpServer,
   isAllowed,
   isJsonRpcError,
+  isNpxInstall,
   isPlanStateEmpty,
   isPlausibleKey,
   listSessions,