reasonix 0.50.1 → 0.51.0

package/dist/cli/{chunk-I6FBSTTR.js → chunk-HGK57NBN.js}

@@ -2,353 +2,13 @@
 import { createRequire as __cr } from 'node:module'; if (typeof globalThis.require === 'undefined') { globalThis.require = __cr(import.meta.url); }
 import {
   TUI_FORMATTING_RULES,
-  applyProjectMemory,
-  applySkillsIndex,
-  escalationContract,
-  memoryEnabled,
-  parseFrontmatter
-} from "./chunk-ENFBF6HI.js";
-import {
-  loadResolvedSkillPaths,
-  memoryTypeDefaults,
-  resolveSkillPaths
-} from "./chunk-MXWPAPZW.js";
-
-// src/code/prompt.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
-import { join as join2 } from "path";
-
-// src/memory/user.ts
-import { createHash } from "crypto";
-import {
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  readdirSync,
-  unlinkSync,
-  writeFileSync
-} from "fs";
-import { homedir } from "os";
-import { join, resolve } from "path";
-var USER_MEMORY_DIR = "memory";
-var MEMORY_INDEX_FILE = "MEMORY.md";
-var MEMORY_INDEX_MAX_CHARS = 4e3;
-var VALID_NAME = /^[a-zA-Z0-9_-][a-zA-Z0-9_.-]{1,38}[a-zA-Z0-9]$/;
-function sanitizeMemoryName(raw) {
-  const trimmed = String(raw ?? "").trim();
-  if (!VALID_NAME.test(trimmed)) {
-    throw new Error(
-      `invalid memory name: ${JSON.stringify(raw)} \u2014 must be 3-40 chars, alnum/_/-, no path separators`
-    );
-  }
-  return trimmed;
-}
-function projectHash(rootDir) {
-  const abs = resolve(rootDir);
-  return createHash("sha1").update(abs).digest("hex").slice(0, 16);
-}
-function scopeDir(opts) {
-  if (opts.scope === "global") {
-    return join(opts.homeDir, USER_MEMORY_DIR, "global");
-  }
-  if (!opts.projectRoot) {
-    throw new Error("scope=project requires a projectRoot on MemoryStore");
-  }
-  return join(opts.homeDir, USER_MEMORY_DIR, projectHash(opts.projectRoot));
-}
-function ensureDir(p) {
-  if (!existsSync(p)) mkdirSync(p, { recursive: true });
-}
-function formatFrontmatter(e) {
-  const lines = [
-    "---",
-    `name: ${e.name}`,
-    `description: ${e.description.replace(/\n/g, " ")}`,
-    `type: ${e.type}`,
-    `scope: ${e.scope}`,
-    `created: ${e.createdAt}`
-  ];
-  if (e.priority) lines.push(`priority: ${e.priority}`);
-  if (e.expires) lines.push(`expires: ${e.expires}`);
-  lines.push("---", "");
-  return lines.join("\n");
-}
-function coercePriority(v) {
-  return v === "low" || v === "medium" || v === "high" ? v : void 0;
-}
-function coerceExpires(v) {
-  return v === "project_end" ? v : void 0;
-}
-function todayIso() {
-  const d = /* @__PURE__ */ new Date();
-  return d.toISOString().slice(0, 10);
-}
-function indexLine(e) {
-  const safeDesc = e.description.replace(/\n/g, " ").trim();
-  const max = 130 - e.name.length;
-  const clipped = safeDesc.length > max ? `${safeDesc.slice(0, Math.max(1, max - 1))}\u2026` : safeDesc;
-  return `- [${e.name}](${e.name}.md) \u2014 ${clipped}`;
-}
-var MemoryStore = class {
-  homeDir;
-  projectRoot;
-  constructor(opts = {}) {
-    this.homeDir = opts.homeDir ?? join(homedir(), ".reasonix");
-    this.projectRoot = opts.projectRoot ? resolve(opts.projectRoot) : void 0;
-  }
-  /** Directory this store writes `scope` files into, creating it if needed. */
-  dir(scope) {
-    const d = scopeDir({ homeDir: this.homeDir, scope, projectRoot: this.projectRoot });
-    ensureDir(d);
-    return d;
-  }
-  /** Absolute path to a memory file (no existence check). */
-  pathFor(scope, name) {
-    return join(this.dir(scope), `${sanitizeMemoryName(name)}.md`);
-  }
-  /** True iff this store is configured with a project scope available. */
-  hasProjectScope() {
-    return this.projectRoot !== void 0;
-  }
-  loadIndex(scope) {
-    if (scope === "project" && !this.projectRoot) return null;
-    const file = join(
-      scopeDir({ homeDir: this.homeDir, scope, projectRoot: this.projectRoot }),
-      MEMORY_INDEX_FILE
-    );
-    if (!existsSync(file)) return null;
-    let raw;
-    try {
-      raw = readFileSync(file, "utf8");
-    } catch {
-      return null;
-    }
-    const trimmed = raw.trim();
-    if (!trimmed) return null;
-    const originalChars = trimmed.length;
-    const truncated = originalChars > MEMORY_INDEX_MAX_CHARS;
-    const content = truncated ? `${trimmed.slice(0, MEMORY_INDEX_MAX_CHARS)}
-\u2026 (truncated ${originalChars - MEMORY_INDEX_MAX_CHARS} chars)` : trimmed;
-    return { content, originalChars, truncated };
-  }
-  /** Read one memory file's body (frontmatter stripped). Throws if missing. */
-  read(scope, name) {
-    const file = this.pathFor(scope, name);
-    if (!existsSync(file)) {
-      throw new Error(`memory not found: scope=${scope} name=${name}`);
-    }
-    const raw = readFileSync(file, "utf8");
-    const { data, body } = parseFrontmatter(raw);
-    const entry = {
-      name: data.name ?? name,
-      type: data.type ?? "project",
-      scope: data.scope ?? scope,
-      description: data.description ?? "",
-      body: body.trim(),
-      createdAt: data.created ?? ""
-    };
-    const priority = coercePriority(data.priority);
-    if (priority) entry.priority = priority;
-    const expires = coerceExpires(data.expires);
-    if (expires) entry.expires = expires;
-    return entry;
-  }
-  /** Skips malformed files — index stays queryable even if one file is hand-edited into nonsense. */
-  list() {
-    const out = [];
-    const scopes = this.projectRoot ? ["global", "project"] : ["global"];
-    for (const scope of scopes) {
-      const dir = scopeDir({ homeDir: this.homeDir, scope, projectRoot: this.projectRoot });
-      if (!existsSync(dir)) continue;
-      let entries;
-      try {
-        entries = readdirSync(dir);
-      } catch {
-        continue;
-      }
-      for (const entry of entries) {
-        if (entry === MEMORY_INDEX_FILE) continue;
-        if (!entry.endsWith(".md")) continue;
-        const name = entry.slice(0, -3);
-        try {
-          out.push(this.read(scope, name));
-        } catch {
-        }
-      }
-    }
-    return out;
-  }
-  write(input) {
-    if (input.scope === "project" && !this.projectRoot) {
-      throw new Error("cannot write project-scoped memory: no projectRoot configured");
-    }
-    const name = sanitizeMemoryName(input.name);
-    const desc = String(input.description ?? "").trim();
-    if (!desc) throw new Error("memory description cannot be empty");
-    const body = String(input.body ?? "").trim();
-    if (!body) throw new Error("memory body cannot be empty");
-    const entry = {
-      ...input,
-      name,
-      description: desc,
-      body,
-      createdAt: todayIso()
-    };
-    if (input.priority) entry.priority = input.priority;
-    if (input.expires) entry.expires = input.expires;
-    const dir = this.dir(input.scope);
-    const file = join(dir, `${name}.md`);
-    const content = `${formatFrontmatter(entry)}${body}
-`;
-    writeFileSync(file, content, "utf8");
-    this.regenerateIndex(input.scope);
-    return file;
-  }
-  /** Delete one memory + its index line. No-op if the file is already gone. */
-  delete(scope, rawName) {
-    if (scope === "project" && !this.projectRoot) {
-      throw new Error("cannot delete project-scoped memory: no projectRoot configured");
-    }
-    const file = this.pathFor(scope, rawName);
-    if (!existsSync(file)) return false;
-    unlinkSync(file);
-    this.regenerateIndex(scope);
-    return true;
-  }
-  /** Sorted by name — same file set must produce byte-identical MEMORY.md for stable prefix hashing. */
-  regenerateIndex(scope) {
-    const dir = scopeDir({ homeDir: this.homeDir, scope, projectRoot: this.projectRoot });
-    if (!existsSync(dir)) return;
-    let files;
-    try {
-      files = readdirSync(dir);
-    } catch {
-      return;
-    }
-    const mdFiles = files.filter((f) => f !== MEMORY_INDEX_FILE && f.endsWith(".md")).sort((a, b) => a.localeCompare(b));
-    const indexPath = join(dir, MEMORY_INDEX_FILE);
-    if (mdFiles.length === 0) {
-      if (existsSync(indexPath)) unlinkSync(indexPath);
-      return;
-    }
-    const lines = [];
-    for (const f of mdFiles) {
-      const name = f.slice(0, -3);
-      try {
-        const entry = this.read(scope, name);
-        lines.push(indexLine({ name: entry.name || name, description: entry.description }));
-      } catch {
-        lines.push(`- [${name}](${name}.md) \u2014 (malformed, check frontmatter)`);
-      }
-    }
-    writeFileSync(indexPath, `${lines.join("\n")}
-`, "utf8");
-  }
-};
-function readGlobalReasonixMemory(homeDir = join(homedir(), ".reasonix")) {
-  const path = join(homeDir, "REASONIX.md");
-  if (!existsSync(path)) return null;
-  let raw;
-  try {
-    raw = readFileSync(path, "utf8");
-  } catch {
-    return null;
-  }
-  const trimmed = raw.trim();
-  if (!trimmed) return null;
-  const originalChars = trimmed.length;
-  const truncated = originalChars > 8e3;
-  const content = truncated ? `${trimmed.slice(0, 8e3)}
-\u2026 (truncated ${originalChars - 8e3} chars)` : trimmed;
-  return { path, content, originalChars, truncated };
-}
-function applyGlobalReasonixMemory(basePrompt, homeDir) {
-  if (!memoryEnabled()) return basePrompt;
-  const dir = homeDir ?? join(homedir(), ".reasonix");
-  const mem = readGlobalReasonixMemory(dir);
-  if (!mem) return basePrompt;
-  return [
-    basePrompt,
-    "",
-    "# Global memory (~/.reasonix/REASONIX.md)",
-    "",
-    "Cross-project notes the user pinned via the `#g` prompt prefix. Treat as authoritative \u2014 same level of trust as project memory.",
-    "",
-    "```",
-    mem.content,
-    "```"
-  ].join("\n");
-}
-function effectivePriority(entry, cfg) {
-  if (entry.priority) return entry.priority;
-  return memoryTypeDefaults(entry.type, cfg).priority;
-}
-function highPriorityBlock(entries, cfg) {
-  const high = entries.filter((e) => effectivePriority(e, cfg) === "high");
-  if (high.length === 0) return null;
-  const lines = [
-    "# HIGH PRIORITY constraints (must observe)",
-    "",
-    "These memories were declared `priority: high` (via config.memory.customTypes or the memory file itself). Treat them as hard rules \u2014 violations override any other guidance below.",
-    ""
-  ];
-  for (const e of high) {
-    const head = `!!! [${e.scope}/${e.type}/${e.name}] ${e.description || "(no description)"}`;
-    lines.push(head);
-    if (e.body) lines.push("", e.body);
-    lines.push("");
-  }
-  return lines.join("\n").trimEnd();
-}
-function applyUserMemory(basePrompt, opts = {}) {
-  if (!memoryEnabled()) return basePrompt;
-  const store = new MemoryStore(opts);
-  const global = store.loadIndex("global");
-  const project = store.hasProjectScope() ? store.loadIndex("project") : null;
-  const high = highPriorityBlock(store.list(), opts.cfg);
-  if (!global && !project && !high) return basePrompt;
-  const parts = [basePrompt];
-  if (high) parts.push("", high);
-  if (global) {
-    parts.push(
-      "",
-      "# User memory \u2014 global (~/.reasonix/memory/global/MEMORY.md)",
-      "",
-      "Cross-project facts and preferences the user has told you in prior sessions. TREAT AS AUTHORITATIVE \u2014 don't re-verify via filesystem or web. One-liners index detail files; call `recall_memory` for full bodies only when the one-liner isn't enough.",
-      "",
-      "```",
-      global.content,
-      "```"
-    );
-  }
-  if (project) {
-    parts.push(
-      "",
-      "# User memory \u2014 this project",
-      "",
-      "Per-project facts the user established in prior sessions (not committed to the repo). TREAT AS AUTHORITATIVE. Same recall pattern as global memory.",
-      "",
-      "```",
-      project.content,
-      "```"
-    );
-  }
-  return parts.join("\n");
-}
-function applyMemoryStack(basePrompt, rootDir, opts = {}) {
-  const homeDir = opts.homeDir;
-  const cfg = opts.cfg;
-  const withProject = applyProjectMemory(basePrompt, rootDir);
-  const withGlobal = applyGlobalReasonixMemory(
-    withProject,
-    homeDir ? join(homeDir, ".reasonix") : void 0
-  );
-  const withMemory = applyUserMemory(withGlobal, { projectRoot: rootDir, homeDir, cfg });
-  const customSkillPaths = cfg?.skills?.paths ? resolveSkillPaths(cfg.skills.paths, rootDir) : loadResolvedSkillPaths(rootDir);
-  return applySkillsIndex(withMemory, { projectRoot: rootDir, homeDir, customSkillPaths });
-}
+  applyMemoryStack,
+  escalationContract
+} from "./chunk-N4SEBLU4.js";
 
 // src/code/prompt.ts
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
 var DEFAULT_CODE_MODEL = "deepseek-v4-flash";
 function codeSystemBase(modelId) {
   return CODE_SYSTEM_TEMPLATE.replace("__ESCALATION_CONTRACT__", escalationContract(modelId));
@@ -477,12 +137,12 @@ function codeSystemPrompt(rootDir, opts = {}) {
   const codeBase = codeSystemBase(opts.modelId ?? DEFAULT_CODE_MODEL);
   const base = opts.hasSemanticSearch ? `${codeBase}${SEMANTIC_SEARCH_ROUTING}` : codeBase;
   const withMemory = applyMemoryStack(base, rootDir);
-  const gitignorePath = join2(rootDir, ".gitignore");
+  const gitignorePath = join(rootDir, ".gitignore");
   let result = withMemory;
-  if (existsSync2(gitignorePath)) {
+  if (existsSync(gitignorePath)) {
     let content;
     try {
-      content = readFileSync2(gitignorePath, "utf8");
+      content = readFileSync(gitignorePath, "utf8");
     } catch {
     }
     if (content !== void 0) {
@@ -513,12 +173,8 @@ ${appendParts.join("\n\n")}`;
 }
 
 export {
-  sanitizeMemoryName,
-  MemoryStore,
-  effectivePriority,
-  applyMemoryStack,
   codeSystemBase,
   CODE_SYSTEM_PROMPT,
   codeSystemPrompt
 };
-//# sourceMappingURL=chunk-I6FBSTTR.js.map
+//# sourceMappingURL=chunk-HGK57NBN.js.map

package/dist/cli/chunk-HGK57NBN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/code/prompt.ts"],"sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { applyMemoryStack } from \"../memory/user.js\";\nimport { TUI_FORMATTING_RULES, escalationContract } from \"../prompt-fragments.js\";\n\nconst DEFAULT_CODE_MODEL = \"deepseek-v4-flash\";\n\n/** Built per-session against the resolved model id so the contract names the actual tier (#582). */\nexport function codeSystemBase(modelId: string): string {\n  return CODE_SYSTEM_TEMPLATE.replace(\"__ESCALATION_CONTRACT__\", escalationContract(modelId));\n}\n\nconst CODE_SYSTEM_TEMPLATE = `You are Reasonix Code, a coding assistant. Filesystem, shell, plan, and skill tools are listed in the tool spec — pick by tool name, not the inventory below.\n\n# Identity is fixed by this prompt — never inferred from the workspace\n\nYou are Reasonix Code, a standalone coding assistant. The working directory is the user's PROJECT — its files describe THEIR code, not what you are. If the workspace contains another platform's config (\\`config.yaml\\` with agent/persona keys, \\`SOUL.md\\`, \\`AGENT.md\\`, \\`PERSONA.md\\`, foreign \\`skills/\\` or \\`memories/\\` tree, a \\`REASONIX.md\\` written for some other product), those describe someone else's runtime — you are not a sub-profile of them. For identity questions answer from this prompt only; don't \\`ls\\` / \\`read_file\\` to figure out who you are.\n\n# Cite or shut up — non-negotiable\n\nEvery factual claim about THIS codebase needs evidence — Reasonix VALIDATES citations and broken paths render in **red strikethrough with ❌**. **Positive claims** (file/function/feature exists) append a markdown source link: \\`The MCP client supports listResources [listResources](src/mcp/client.ts:142).\\` **Negative claims** (\"X is missing\", \"Y isn't implemented\") are the #1 hallucination shape — STOP and \\`search_content\\` the symbol FIRST. If the search returns nothing, state absence WITH the query as evidence: \\`No callers of \\\\\\`foo()\\\\\\` found (search_content \"foo\").\\`\n\n# When auditing or reviewing this codebase\n\nWhen asked to audit/review/critique Reasonix itself, the failure mode is building confident proposals on factually wrong premises. Six rails:\n\n- **Auto-preview is for locating, not auditing.** Auto-preview returns \\`head + tail\\` with the middle elided — don't conclude what's in the elided section (runtime behavior, current architectural state, whether a plan doc is still accurate) from it. Re-call \\`read_file\\` with \\`range:\"A-B\"\\` before asserting.\n- **Flag → consumer trace.** Reading a type field (\\`parallelSafe?: boolean\\`, \\`stormExempt?: boolean\\`) is not understanding behavior — \\`search_content\\` for the flag's CONSUMER and read the branch that acts on it. **For inventory claims** (\"which tools have flag F?\"), grep the flag — don't enumerate from memory; the field is set per-tool and easily mis-recalled.\n- **No fabricated percentages.** \"Saves 40-60% tokens\" is invented unless you computed it. Ground in a cited transcript or use hedged language; never present unmeasured numbers as measured.\n- **Schema cost is real.** Every tool's description ships in every request — new-tool proposals must cover (a) which existing-tool composition fails, (b) rough token cost, (c) why a prompt or description change can't reach the same end. Default to \"tighten prompt / existing tool\".\n- **MEMORY.md is part of the design space.** Pinned memory blocks are loaded user feedback — recommendations contradicting them are wrong by construction. Cross-check before proposing.\n- **User-facing ≠ model-facing ≠ library-facing.** Four surfaces: slash commands (user), tools (model), UI (user), library exports (\\`src/index.ts\\`). Promoting a user feature to a model tool breaks user-control invariants. Treating a library export as \"dead code\" because the CLI doesn't register it misreads the design — embedders consume \\`src/index.ts\\` directly.\n\n# Picking the right tool: submit_plan / ask_choice / todo_write\n\n- **submit_plan** — review-gate for multi-file refactors, architecture changes, anything expensive to undo. Markdown body + structured \\`steps\\`. After calling, STOP and wait. Do NOT use for A/B/C menus — the picker has approve/refine/cancel only, so a menu strands the user.\n- **ask_choice** — when the user is supposed to pick between alternatives, the TOOL picks; never enumerate choices as prose. Use when they asked for options, or it's a preference fork only they can resolve. Skip when one option is clearly correct (just do it). After calling, STOP.\n- **todo_write** — in-session tracker for 3+ step work. NOT a plan (no approval gate, no files touched). One \\`in_progress\\` at a time; flip to \\`completed\\` immediately. For approval gates use submit_plan; for branching use ask_choice.\n\n# Plan mode (/plan)\n\nStronger constraint than submit_plan: writes + non-allowlisted run_command are bounced at dispatch (\"unavailable in plan mode\" — don't retry). Read tools and allowlisted shell commands still work. You MUST call submit_plan before anything will execute.\n\n# Delegating to subagents via Skills\n\nThe pinned Skills index below lists every available playbook (built-ins + user-installed). Entries tagged \\`[🧬 subagent]\\` spawn an isolated child loop and return only the final answer — their tool calls never enter your context. Pass \\`name\\` as the BARE identifier (e.g. \\`\"explore\"\\`), not the \\`[🧬 subagent]\\` tag.\n\n**Default: don't delegate.** Direct tools are cheaper and keep evidence in your context. Spawn ONLY for (a) true parallelism — 2+ independent investigations in one batch — or (b) context blow-up — >10 file reads where you only need the conclusion. Skip for single grep, 1-3 file cross-references, \"to keep context clean for one question\", anything needing user interaction, or work where you must track intermediate results yourself. Always pass clear, self-contained \\`arguments\\` — the subagent gets no other context.\n\n# When to edit vs. when to explore\n\nOnly propose edits when the user explicitly says change / fix / add / remove / refactor / write. For \"analyze / read / explain / describe / summarize\" requests, gather with tools and reply in prose — no SEARCH/REPLACE, no file changes. If unclear, ask.\n\nThe **edit gate** routes \\`edit_file\\` / \\`write_file\\` based on the user's mode (\\`review\\` or \\`auto\\`) — you don't see which is active, write the same way in both. Responses:\n- \\`\"edit blocks: 1/1 applied\"\\` — proceed.\n- \\`\"User rejected this edit to <path>. Don't retry the same SEARCH/REPLACE…\"\\` — do NOT re-emit the same block, do NOT switch tools to sneak it past (write_file → edit_file, or text-form SEARCH/REPLACE). Take a clearly different approach or ask.\n- Esc mid-prompt aborts the whole turn — don't keep calling tools after.\n\n# Editing files\n\nOutput one or more SEARCH/REPLACE blocks in this exact format:\n\npath/to/file.ext\n<<<<<<< SEARCH\nexact existing lines from the file, including whitespace\n=======\nthe new lines\n>>>>>>> REPLACE\n\nRules:\n- **Read before edit (enforced).** You MUST call \\`read_file\\` on the target this session before \\`edit_file\\` / \\`multi_edit\\` will accept it — the tool refuses unread targets up front, so SEARCH text is grounded in on-disk bytes, not a guess. A fold / mechanical truncate clears the tracker, so re-read after one of those before mutating. \\`write_file\\` counts as a read for that path (the content is what you just wrote).\n- One edit per block; multiple blocks per response are fine.\n- Create a new file with empty SEARCH:\n    path/to/new.ts\n    <<<<<<< SEARCH\n    =======\n    (whole file content here)\n    >>>>>>> REPLACE\n- Don't use write_file to change existing files — the user reviews edits as SEARCH/REPLACE. write_file is for wholesale overwrites only.\n- Paths are relative to the working directory.\n- For multi-site changes use \\`multi_edit\\` — validation runs before any write; validation failures leave all files untouched. Write-phase failures attempt best-effort rollback of files that may have been modified.\n\n# Trust what you already know\n\nBefore exploring to answer a factual question, check context first: the user's message, prior turns (including \\`remember\\` results), the pinned memory blocks above. User-stated facts outrank what the files say — don't re-derive what the user just told you.\n\n# Exploration\n\nSkip dependency, build, and VCS directories unless asked (the pinned .gitignore below is your denylist). \\`search_files\\` matches FILE NAMES; \\`search_content\\` matches CONTENTS — pick accordingly. Use \\`glob\\` for \"what changed lately\" / \"all *.ts under src/\", \\`search_content\\` with \\`context:N\\` for grep -C around hits.\n\n# Path conventions\n\n- **Filesystem tools** (\\`read_file\\`, \\`list_directory\\`, \\`edit_file\\`, etc.): paths resolve against the sandbox root. Relative, POSIX-absolute (\\`/\\` = project root), and OS-absolute (e.g. \\`D:\\\\\\\\path\\\\\\\\foo.cpp\\`) all work as long as they resolve INSIDE the sandbox. Don't refuse on path shape — the tool returns a clear sandbox-escape error if it's actually out of scope.\n- **\\`run_command\\`**: cwd pinned to project root. Never use a leading \\`/\\` in arguments — Windows reads it as drive root, POSIX as filesystem root. Use relative paths.\n\n# Workspace is pinned\n\nYou can't switch project / working directory mid-session — tell the user to quit and relaunch (e.g. \\`cd ../other-project && reasonix code\\`). Don't try \\`cd\\` via \\`run_command\\` either; the sandbox is pinned and \\`cd\\` doesn't carry between calls.\n\n# Foreground vs background\n\n\\`run_command\\` blocks until exit — use for tests / builds / lints / typechecks / git / one-shot scripts under a minute. \\`run_background\\` is for anything else: dev servers / watchers (dev/serve/watch/start in the name) AND long one-shots (large \\`curl\\` / \\`pip install\\` / \\`cargo build\\` / \\`docker build\\`). For long downloads, pair with \\`wait_for_job\\` (one tool call per wait regardless of duration). Don't restart a running dev server — \\`list_jobs\\` first.\n\n# Scope discipline on \"run it\" / \"start it\" requests\n\nWhen the user says run / start / launch / serve / boot up: start it, verify it came up, report what's running and STOP. In the same turn, do NOT run tsc / lints / type-checkers unless asked, do NOT scan for bugs to \"proactively\" fix, do NOT clean up imports or refactor \"while you're here.\" If you notice an issue, mention in one sentence and wait. \"It works\" is the end state — resist the urge to polish.\n\n# Style\n\n- Show edits; don't narrate them in prose. \"Here's the fix:\" is enough.\n- One short paragraph explaining *why*, then the blocks.\n- Silence during exploration is fine — tool calls first, prose after.\n\n# Task integrity — non-negotiable\n\nThe user's original objective and ALL constraints (especially \"do NOT do X\", \"avoid Y\", \"never Z\") remain in force for the entire session. You may NOT unilaterally simplify, narrow, or change the objective to save tokens, time, or steps. If you believe the objective needs adjustment, ask the user — do NOT decide on your own.\n\n__ESCALATION_CONTRACT__\n\n${TUI_FORMATTING_RULES}\n`;\n\n/** Backward-compat — public-API const, frozen at the historical flash phrasing. Internal callers use codeSystemPrompt(rootDir, { modelId }) so the contract names the real tier (#582). */\nexport const CODE_SYSTEM_PROMPT = codeSystemBase(DEFAULT_CODE_MODEL);\n\n/** Stack order (stable for cache prefix): base → REASONIX.md → global → project → .gitignore. */\nconst SEMANTIC_SEARCH_ROUTING = `\n\n# Search routing\n\nYou have BOTH \\`semantic_search\\` (vector index) and \\`search_content\\` (literal grep).\n\n- **Descriptive queries** (\"where do we handle X\", \"which file owns Y\", \"how does Z work\", \"find the logic that does …\", \"the code responsible for …\") → call \\`semantic_search\\` FIRST. It indexes the project by meaning, so it finds the right file even when your phrasing shares no tokens with the code.\n- **Exact-token queries** (a specific identifier, regex, or \"find every call to foo\") → call \\`search_content\\`.\n\nIf \\`semantic_search\\` returns nothing useful (low scores, off-topic), THEN fall back to \\`search_content\\`. Don't go the other way — grepping a paraphrased question wastes turns.`;\n\nexport interface CodeSystemPromptOptions {\n  /** True when semantic_search is registered for this run. Adds an\n   *  explicit routing fragment so the model picks it for intent-style\n   *  queries instead of defaulting to grep. */\n  hasSemanticSearch?: boolean;\n  /** Inline string appended after the generated code system prompt.\n   *  Preserves the default prompt — this is append-only, not a replacement. */\n  systemAppend?: string;\n  /** UTF-8 file contents appended after the generated code system prompt.\n   *  Preserves the default prompt — this is append-only, not a replacement. */\n  systemAppendFile?: string;\n  /** Model the loop will run on — interpolated into the escalation contract so the model can name itself correctly when asked (#582). */\n  modelId?: string;\n  /** Back-compat no-op: lifecycle is runtime-only so strict/off do not change the cache prefix. */\n  engineeringLifecycleMode?: \"off\" | \"strict\";\n}\n\nexport function codeSystemPrompt(rootDir: string, opts: CodeSystemPromptOptions = {}): string {\n  const codeBase = codeSystemBase(opts.modelId ?? DEFAULT_CODE_MODEL);\n  const base = opts.hasSemanticSearch ? `${codeBase}${SEMANTIC_SEARCH_ROUTING}` : codeBase;\n  const withMemory = applyMemoryStack(base, rootDir);\n  const gitignorePath = join(rootDir, \".gitignore\");\n  let result = withMemory;\n  if (existsSync(gitignorePath)) {\n    let content: string | undefined;\n    try {\n      content = readFileSync(gitignorePath, \"utf8\");\n    } catch {}\n    if (content !== undefined) {\n      const MAX = 2000;\n      const truncated =\n        content.length > MAX\n          ? `${content.slice(0, MAX)}\\n… (truncated ${content.length - MAX} chars)`\n          : content;\n      result = `${result}\\n\\n# Project .gitignore\\n\\nThe user's repo ships this .gitignore — treat every pattern as \"don't traverse or edit inside these paths unless explicitly asked\":\\n\\n\\`\\`\\`\\n${truncated}\\n\\`\\`\\`\\n`;\n    }\n  }\n  const appendParts = [opts.systemAppend, opts.systemAppendFile].filter(Boolean);\n  if (appendParts.length > 0) {\n    result = `${result}\\n\\n# User System Append\\n\\n${appendParts.join(\"\\n\\n\")}`;\n  }\n  return result;\n}\n"],"mappings":";;;;;;;;;AAAA,SAAS,YAAY,oBAAoB;AACzC,SAAS,YAAY;AAIrB,IAAM,qBAAqB;AAGpB,SAAS,eAAe,SAAyB;AACtD,SAAO,qBAAqB,QAAQ,2BAA2B,mBAAmB,OAAO,CAAC;AAC5F;AAEA,IAAM,uBAAuB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA2G3B,oBAAoB;AAAA;AAIf,IAAM,qBAAqB,eAAe,kBAAkB;AAGnE,IAAM,0BAA0B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA4BzB,SAAS,iBAAiB,SAAiB,OAAgC,CAAC,GAAW;AAC5F,QAAM,WAAW,eAAe,KAAK,WAAW,kBAAkB;AAClE,QAAM,OAAO,KAAK,oBAAoB,GAAG,QAAQ,GAAG,uBAAuB,KAAK;AAChF,QAAM,aAAa,iBAAiB,MAAM,OAAO;AACjD,QAAM,gBAAgB,KAAK,SAAS,YAAY;AAChD,MAAI,SAAS;AACb,MAAI,WAAW,aAAa,GAAG;AAC7B,QAAI;AACJ,QAAI;AACF,gBAAU,aAAa,eAAe,MAAM;AAAA,IAC9C,QAAQ;AAAA,IAAC;AACT,QAAI,YAAY,QAAW;AACzB,YAAM,MAAM;AACZ,YAAM,YACJ,QAAQ,SAAS,MACb,GAAG,QAAQ,MAAM,GAAG,GAAG,CAAC;AAAA,oBAAkB,QAAQ,SAAS,GAAG,YAC9D;AACN,eAAS,GAAG,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAA8K,SAAS;AAAA;AAAA;AAAA,IAC3M;AAAA,EACF;AACA,QAAM,cAAc,CAAC,KAAK,cAAc,KAAK,gBAAgB,EAAE,OAAO,OAAO;AAC7E,MAAI,YAAY,SAAS,GAAG;AAC1B,aAAS,GAAG,MAAM;AAAA;AAAA;AAAA;AAAA,EAA+B,YAAY,KAAK,MAAM,CAAC;AAAA,EAC3E;AACA,SAAO;AACT;","names":[]}

package/dist/cli/chunk-JHWQDJZA.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+import { createRequire as __cr } from 'node:module'; if (typeof globalThis.require === 'undefined') { globalThis.require = __cr(import.meta.url); }
+import {
+  MemoryStore,
+  readGlobalReasonixMemory,
+  readProjectMemory
+} from "./chunk-N4SEBLU4.js";
+
+// src/desktop/memory-browser.ts
+import { existsSync, readFileSync } from "fs";
+import { basename, resolve } from "path";
+function collectMemoryEntriesForWorkspace(projectRoot, opts = {}) {
+  const out = [];
+  const project = readProjectMemory(projectRoot);
+  if (project) {
+    out.push({
+      kind: "project_file",
+      scope: "project",
+      name: basename(project.path),
+      path: project.path,
+      description: "Project memory file",
+      type: "freeform"
+    });
+  }
+  const global = readGlobalReasonixMemory(opts.reasonixHome);
+  if (global) {
+    out.push({
+      kind: "global_file",
+      scope: "global",
+      name: basename(global.path),
+      path: global.path,
+      description: "Global memory file",
+      type: "freeform"
+    });
+  }
+  const store = new MemoryStore({ homeDir: opts.reasonixHome, projectRoot });
+  for (const entry of store.list()) {
+    out.push(structuredInfo(store, entry));
+  }
+  return out;
+}
+function readMemoryEntryDetail(request, projectRoot, opts = {}) {
+  const requested = resolve(request.path);
+  const entry = collectMemoryEntriesForWorkspace(projectRoot, opts).find(
+    (candidate) => resolve(candidate.path) === requested
+  );
+  if (!entry) throw new Error(`memory path not available: ${request.path}`);
+  if (entry.kind === "structured") {
+    const store = new MemoryStore({ homeDir: opts.reasonixHome, projectRoot });
+    const structured = store.read(entry.scope, entry.name);
+    return {
+      ...entry,
+      description: structured.description,
+      type: structured.type,
+      body: structured.body,
+      createdAt: structured.createdAt
+    };
+  }
+  if (!existsSync(entry.path)) throw new Error(`memory file missing: ${entry.path}`);
+  return {
+    ...entry,
+    body: readFileSync(entry.path, "utf8").trim()
+  };
+}
+function structuredInfo(store, entry) {
+  return {
+    kind: "structured",
+    scope: entry.scope,
+    name: entry.name,
+    path: store.pathFor(entry.scope, entry.name),
+    description: entry.description,
+    type: entry.type
+  };
+}
+
+export {
+  collectMemoryEntriesForWorkspace,
+  readMemoryEntryDetail
+};
+//# sourceMappingURL=chunk-JHWQDJZA.js.map

package/dist/cli/chunk-JHWQDJZA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/desktop/memory-browser.ts"],"sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport { basename, resolve } from \"node:path\";\nimport { readProjectMemory } from \"../memory/project.js\";\nimport {\n  type MemoryEntry,\n  type MemoryScope,\n  MemoryStore,\n  readGlobalReasonixMemory,\n} from \"../memory/user.js\";\n\nexport type MemoryEntryKind = \"project_file\" | \"global_file\" | \"structured\";\n\nexport interface MemoryEntryInfo {\n  kind: MemoryEntryKind;\n  scope: MemoryScope;\n  name: string;\n  path: string;\n  description: string;\n  type?: string;\n}\n\nexport interface MemoryEntryDetail extends MemoryEntryInfo {\n  body: string;\n  createdAt?: string;\n}\n\nexport interface MemoryBrowserOptions {\n  /** Absolute ~/.reasonix directory. Tests override this; production uses homedir(). */\n  reasonixHome?: string;\n}\n\nexport function collectMemoryEntriesForWorkspace(\n  projectRoot: string,\n  opts: MemoryBrowserOptions = {},\n): MemoryEntryInfo[] {\n  const out: MemoryEntryInfo[] = [];\n  const project = readProjectMemory(projectRoot);\n  if (project) {\n    out.push({\n      kind: \"project_file\",\n      scope: \"project\",\n      name: basename(project.path),\n      path: project.path,\n      description: \"Project memory file\",\n      type: \"freeform\",\n    });\n  }\n\n  const global = readGlobalReasonixMemory(opts.reasonixHome);\n  if (global) {\n    out.push({\n      kind: \"global_file\",\n      scope: \"global\",\n      name: basename(global.path),\n      path: global.path,\n      description: \"Global memory file\",\n      type: \"freeform\",\n    });\n  }\n\n  const store = new MemoryStore({ homeDir: opts.reasonixHome, projectRoot });\n  for (const entry of store.list()) {\n    out.push(structuredInfo(store, entry));\n  }\n  return out;\n}\n\nexport function readMemoryEntryDetail(\n  request: { path: string },\n  projectRoot: string,\n  opts: MemoryBrowserOptions = {},\n): MemoryEntryDetail {\n  const requested = resolve(request.path);\n  const entry = collectMemoryEntriesForWorkspace(projectRoot, opts).find(\n    (candidate) => resolve(candidate.path) === requested,\n  );\n  if (!entry) throw new Error(`memory path not available: ${request.path}`);\n\n  if (entry.kind === \"structured\") {\n    const store = new MemoryStore({ homeDir: opts.reasonixHome, projectRoot });\n    const structured = store.read(entry.scope, entry.name);\n    return {\n      ...entry,\n      description: structured.description,\n      type: structured.type,\n      body: structured.body,\n      createdAt: structured.createdAt,\n    };\n  }\n\n  if (!existsSync(entry.path)) throw new Error(`memory file missing: ${entry.path}`);\n  return {\n    ...entry,\n    body: readFileSync(entry.path, \"utf8\").trim(),\n  };\n}\n\nfunction structuredInfo(store: MemoryStore, entry: MemoryEntry): MemoryEntryInfo {\n  return {\n    kind: \"structured\",\n    scope: entry.scope,\n    name: entry.name,\n    path: store.pathFor(entry.scope, entry.name),\n    description: entry.description,\n    type: entry.type,\n  };\n}\n"],"mappings":";;;;;;;;;AAAA,SAAS,YAAY,oBAAoB;AACzC,SAAS,UAAU,eAAe;AA8B3B,SAAS,iCACd,aACA,OAA6B,CAAC,GACX;AACnB,QAAM,MAAyB,CAAC;AAChC,QAAM,UAAU,kBAAkB,WAAW;AAC7C,MAAI,SAAS;AACX,QAAI,KAAK;AAAA,MACP,MAAM;AAAA,MACN,OAAO;AAAA,MACP,MAAM,SAAS,QAAQ,IAAI;AAAA,MAC3B,MAAM,QAAQ;AAAA,MACd,aAAa;AAAA,MACb,MAAM;AAAA,IACR,CAAC;AAAA,EACH;AAEA,QAAM,SAAS,yBAAyB,KAAK,YAAY;AACzD,MAAI,QAAQ;AACV,QAAI,KAAK;AAAA,MACP,MAAM;AAAA,MACN,OAAO;AAAA,MACP,MAAM,SAAS,OAAO,IAAI;AAAA,MAC1B,MAAM,OAAO;AAAA,MACb,aAAa;AAAA,MACb,MAAM;AAAA,IACR,CAAC;AAAA,EACH;AAEA,QAAM,QAAQ,IAAI,YAAY,EAAE,SAAS,KAAK,cAAc,YAAY,CAAC;AACzE,aAAW,SAAS,MAAM,KAAK,GAAG;AAChC,QAAI,KAAK,eAAe,OAAO,KAAK,CAAC;AAAA,EACvC;AACA,SAAO;AACT;AAEO,SAAS,sBACd,SACA,aACA,OAA6B,CAAC,GACX;AACnB,QAAM,YAAY,QAAQ,QAAQ,IAAI;AACtC,QAAM,QAAQ,iCAAiC,aAAa,IAAI,EAAE;AAAA,IAChE,CAAC,cAAc,QAAQ,UAAU,IAAI,MAAM;AAAA,EAC7C;AACA,MAAI,CAAC,MAAO,OAAM,IAAI,MAAM,8BAA8B,QAAQ,IAAI,EAAE;AAExE,MAAI,MAAM,SAAS,cAAc;AAC/B,UAAM,QAAQ,IAAI,YAAY,EAAE,SAAS,KAAK,cAAc,YAAY,CAAC;AACzE,UAAM,aAAa,MAAM,KAAK,MAAM,OAAO,MAAM,IAAI;AACrD,WAAO;AAAA,MACL,GAAG;AAAA,MACH,aAAa,WAAW;AAAA,MACxB,MAAM,WAAW;AAAA,MACjB,MAAM,WAAW;AAAA,MACjB,WAAW,WAAW;AAAA,IACxB;AAAA,EACF;AAEA,MAAI,CAAC,WAAW,MAAM,IAAI,EAAG,OAAM,IAAI,MAAM,wBAAwB,MAAM,IAAI,EAAE;AACjF,SAAO;AAAA,IACL,GAAG;AAAA,IACH,MAAM,aAAa,MAAM,MAAM,MAAM,EAAE,KAAK;AAAA,EAC9C;AACF;AAEA,SAAS,eAAe,OAAoB,OAAqC;AAC/E,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO,MAAM;AAAA,IACb,MAAM,MAAM;AAAA,IACZ,MAAM,MAAM,QAAQ,MAAM,OAAO,MAAM,IAAI;AAAA,IAC3C,aAAa,MAAM;AAAA,IACnB,MAAM,MAAM;AAAA,EACd;AACF;","names":[]}

package/dist/cli/{chunk-X2BQZQEE.js → chunk-K3QJ3GKI.js}

@@ -7,10 +7,10 @@ import {
   defaultUsageLogPath,
   formatLogSize,
   readUsageLog
-} from "./chunk-GMSAB2TC.js";
+} from "./chunk-3YRTIWFX.js";
 import {
   t
-} from "./chunk-PYIZZAVQ.js";
+} from "./chunk-DVD67FXQ.js";
 
 // src/cli/commands/stats.ts
 import { existsSync, readFileSync } from "fs";
@@ -150,4 +150,4 @@ export {
   statsCommand,
   renderDashboard
 };
-//# sourceMappingURL=chunk-X2BQZQEE.js.map
+//# sourceMappingURL=chunk-K3QJ3GKI.js.map