@mindstudio-ai/remy 0.1.268 → 0.1.270

package/dist/headless.js

@@ -618,7 +618,6 @@ function readJsonAsset(fallback, ...segments) {
 
 // src/prompt/static/projectContext.ts
 import fs4 from "fs";
-import path3 from "path";
 
 // src/projectRoot.ts
 var PROJECT_ROOT = process.cwd();
@@ -629,80 +628,25 @@ function loadProjectRoot() {
 ## Project Root
 \`${PROJECT_ROOT}\`
 
-File paths are relative to this directory. Every tool operates here and bash commands run it it.`;
-}
-function loadProjectManifest() {
-  try {
-    const manifest = fs4.readFileSync("mindstudio.json", "utf-8");
-    return `
-## Project Manifest (mindstudio.json)
-\`\`\`json
-${manifest}
-\`\`\``;
-  } catch {
-    return "";
-  }
+File paths are relative to this directory. Every tool operates here and bash commands run in it.`;
 }
-function loadSpecFileMetadata() {
+function loadAppIdentity() {
   try {
-    const files = walkMdFiles("src");
-    if (files.length === 0) {
+    const manifest = JSON.parse(fs4.readFileSync("mindstudio.json", "utf-8"));
+    const name = typeof manifest.name === "string" ? manifest.name.trim() : "";
+    if (!name) {
       return "";
     }
-    const entries = [];
-    for (const filePath of files) {
-      const { name, description, type } = parseFrontmatter(filePath);
-      let line = `- ${filePath}`;
-      if (name) {
-        line += ` \u2014 "${name}"`;
-      }
-      if (type) {
-        line += ` (${type})`;
-      }
-      if (description) {
-        line += ` \u2014 ${description}`;
-      }
-      entries.push(line);
-    }
+    const description = typeof manifest.description === "string" ? manifest.description.trim() : "";
     return `
-## Spec Files
-${entries.join("\n")}`;
+## App
+"${name}"${description ? ` \u2014 ${description}` : ""}
+
+Full manifest: \`mindstudio.json\` (read it when you need the app's structure, tables, methods, roles, auth settings, interfaces, and everything else).`;
   } catch {
     return "";
   }
 }
-function walkMdFiles(dir) {
-  const results = [];
-  try {
-    const entries = fs4.readdirSync(dir, { withFileTypes: true });
-    for (const entry of entries) {
-      const full = path3.join(dir, entry.name);
-      if (entry.isDirectory()) {
-        results.push(...walkMdFiles(full));
-      } else if (entry.name.endsWith(".md")) {
-        results.push(full);
-      }
-    }
-  } catch {
-  }
-  return results.sort();
-}
-function parseFrontmatter(filePath) {
-  try {
-    const content = fs4.readFileSync(filePath, "utf-8");
-    const match = content.match(/^---\n([\s\S]*?)\n---/);
-    if (!match) {
-      return { name: "", description: "", type: "" };
-    }
-    const fm = match[1];
-    const name = fm.match(/^name:\s*(.+)$/m)?.[1]?.trim() ?? "";
-    const description = fm.match(/^description:\s*(.+)$/m)?.[1]?.trim() ?? "";
-    const type = fm.match(/^type:\s*(.+)$/m)?.[1]?.trim() ?? "";
-    return { name, description, type };
-  } catch {
-    return { name: "", description: "", type: "" };
-  }
-}
 function loadPlanStatus(onboardingState) {
   try {
     const content = fs4.readFileSync(".remy-plan.md", "utf-8");
@@ -731,33 +675,12 @@ The user has approved your implementation plan in .remy-plan.md. You may referen
     return "";
   }
 }
-function loadProjectFileListing() {
-  try {
-    const entries = fs4.readdirSync(".", { withFileTypes: true });
-    const listing = entries.filter((e) => e.name !== ".git" && e.name !== "node_modules").sort((a, b) => {
-      if (a.isDirectory() && !b.isDirectory()) {
-        return -1;
-      }
-      if (!a.isDirectory() && b.isDirectory()) {
-        return 1;
-      }
-      return a.name.localeCompare(b.name);
-    }).map((e) => e.isDirectory() ? `${e.name}/` : e.name).join("\n");
-    return `
-## Project Files
-\`\`\`
-${listing}
-\`\`\``;
-  } catch {
-    return "";
-  }
-}
 
 // src/prompt/skills/catalog.ts
 import fs5 from "fs";
-import path4 from "path";
+import path3 from "path";
 var SKILLS_DIR = assetPath("prompt", "skills");
-function parseFrontmatter2(content) {
+function parseFrontmatter(content) {
   const match = content.match(/^---\n([\s\S]*?)\n---/);
   if (!match) {
     return {};
@@ -780,9 +703,9 @@ function loadCatalog() {
   }
   const skills = [];
   for (const file of files.sort()) {
-    const full = path4.join(SKILLS_DIR, file);
+    const full = path3.join(SKILLS_DIR, file);
     const id = file.replace(/\.md$/, "");
-    const fields = parseFrontmatter2(fs5.readFileSync(full, "utf-8"));
+    const fields = parseFrontmatter(fs5.readFileSync(full, "utf-8"));
     if (!fields.name || !fields.what || !fields.when) {
       continue;
     }
@@ -836,13 +759,7 @@ function resolveIncludes(template) {
   );
   return result.replace(/\n{3,}/g, "\n\n").trim();
 }
-function buildSystemPrompt(onboardingState, viewContext) {
-  const projectContext = [
-    loadProjectRoot(),
-    loadProjectManifest(),
-    loadSpecFileMetadata(),
-    loadProjectFileListing()
-  ].filter(Boolean).join("\n");
+function buildSystemPrompt(onboardingState) {
   const now = (/* @__PURE__ */ new Date()).toLocaleDateString("en-US", {
     month: "long",
     day: "numeric",
@@ -851,8 +768,6 @@ function buildSystemPrompt(onboardingState, viewContext) {
   const template = `
 {{static/identity.md}}
 
-Current date: ${now}
-
 <platform_docs>
   <platform>
   {{compiled/platform.md}}
@@ -882,21 +797,9 @@ Current date: ${now}
   {{compiled/design.md}}
   </design>
 
-  <app_files>
-  {{compiled/files.md}}
-  </app_files>
-
   <interfaces>
   {{compiled/interfaces.md}}
   </interfaces>
-
-  <scenarios>
-  {{compiled/scenarios.md}}
-  </scenarios>
-
-  <secrets>
-  {{compiled/secrets.md}}
-  </secrets>
 </platform_docs>
 
 ${loadSkillsCatalog()}
@@ -909,12 +812,12 @@ ${loadSkillsCatalog()}
   {{compiled/msfm.md}}
 </mindstudio_flavored_markdown_spec_docs>
 
-<intake_mode_instructions>
+${onboardingState === "intake" ? `<intake_mode_instructions>
   {{static/intake.md}}
-</intake_mode_instructions>
+</intake_mode_instructions>` : ""}
 
 <spec_authoring_instructions>
-  {{static/authoring.md}}
+  ${onboardingState !== void 0 && onboardingState !== "onboardingFinished" ? "{{static/authoring.md}}" : "{{static/spec-maintenance.md}}"}
 </spec_authoring_instructions>
 
 <team>
@@ -932,11 +835,11 @@ ${loadSkillsCatalog()}
 <conversation_summaries>
 Your conversation history may include <prior_conversation_summary> blocks in the user's messages. These are automated summaries of earlier messages that have been compacted to save context space. The user does not see this summary, they see the full conversation history in their UI. Treat the summary as ground truth for what happened before, but do not reference it directly to the user ("as mentioned in the summary..."). Just continue naturally as if you remember the prior work.
 
-Old tool results are periodically cleared from the conversation to save context space. This is automatic and expected \u2014 you don't need to note down or preserve information from tool results. If you need to reference something from an earlier tool call, just re-read the file or re-run the query.
+Tool results generally persist in the conversation until a compaction summarizes them. In rare cases very old tool results may be trimmed when the conversation nears the context limit. Either way, if you need something from an earlier tool call and can't see it anymore, just re-read the file or re-run the query.
 </conversation_summaries>
 
 <project_onboarding>
-New projects progress through three onboarding states. The user might skip this entirely and jump straight into working on the existing scaffold (which defaults to onboardingFinished), but ideally new projects move through each phase:
+New projects progress through four onboarding states. The user might skip this entirely and jump straight into working on the existing scaffold (which defaults to onboardingFinished), but ideally new projects move through each phase:
 
 - **intake**: Gathering requirements. The project has scaffold code (a "hello world" starter) but it's not the user's app yet. Focus on understanding what they want to build, not on the existing code. Intake ends with a plan proposal via writePlan.
 - **building**: The user approved the initial plan. The agent is writing the spec and building the app. This can take a while and involves heavy tool use (spec authoring, design expert consultation, code generation, verification, polishing).
@@ -944,24 +847,21 @@ New projects progress through three onboarding states. The user might skip this
 - **onboardingFinished**: The project is built and ready. Full development mode with all tools available. From here on, keep spec and code in sync as changes are made.
 </project_onboarding>
 
+${loadProjectRoot()}
+
+${renderOrgContextBlock()}
+
 {{static/instructions.md}}
 
 <!-- cache_breakpoint -->
 
+Current date: ${now}
+
 <current_project_onboarding_state>
   ${onboardingState ?? "onboardingFinished"}
 </current_project_onboarding_state>
 
-<project_context>
-${projectContext}
-</project_context>
-
-${renderOrgContextBlock()}
-
-<view_context>
-The user is currently in ${viewContext?.mode ?? "code"} mode.
-${viewContext?.activeFile ? `Active file: ${viewContext.activeFile}` : ""}
-</view_context>
+${loadAppIdentity()}
 
 ${loadPlanStatus(onboardingState)}
 `;
@@ -1100,7 +1000,7 @@ var readSpecTool = {
 
 // src/tools/spec/writeSpec.ts
 import fs7 from "fs/promises";
-import path5 from "path";
+import path4 from "path";
 
 // src/tools/_helpers/diff.ts
 var CONTEXT_LINES = 3;
@@ -1189,7 +1089,7 @@ ${unifiedDiff(partial.path, oldContent, partial.content)}`;
     }
     const release = await acquireFileLock(input.path);
     try {
-      await fs7.mkdir(path5.dirname(input.path), { recursive: true });
+      await fs7.mkdir(path4.dirname(input.path), { recursive: true });
       let oldContent = null;
       try {
         oldContent = await fs7.readFile(input.path, "utf-8");
@@ -1394,7 +1294,7 @@ var editSpecTool = {
 
 // src/tools/spec/listSpecFiles.ts
 import fs9 from "fs/promises";
-import path6 from "path";
+import path5 from "path";
 var listSpecFilesTool = {
   definition: {
     name: "listSpecFiles",
@@ -1433,7 +1333,7 @@ async function listRecursive(dir) {
     return a.name.localeCompare(b.name);
   });
   for (const entry of entries) {
-    const fullPath = path6.join(dir, entry.name);
+    const fullPath = path5.join(dir, entry.name);
     if (entry.isDirectory()) {
       results.push(`${fullPath}/`);
       results.push(...await listRecursive(fullPath));
@@ -1466,8 +1366,33 @@ var presentPublishPlanTool = {
   }
 };
 
+// src/atomicWrite.ts
+import fs10 from "fs";
+import fsp from "fs/promises";
+var writeFileAtomicSync = (file, data) => {
+  const tmp = `${file}.${process.pid}.tmp`;
+  const fd2 = fs10.openSync(tmp, "w");
+  try {
+    fs10.writeSync(fd2, data);
+    fs10.fsyncSync(fd2);
+  } finally {
+    fs10.closeSync(fd2);
+  }
+  fs10.renameSync(tmp, file);
+};
+var writeFileAtomic = async (file, data) => {
+  const tmp = `${file}.${process.pid}.tmp`;
+  const handle = await fsp.open(tmp, "w");
+  try {
+    await handle.writeFile(data);
+    await handle.sync();
+  } finally {
+    await handle.close();
+  }
+  await fsp.rename(tmp, file);
+};
+
 // src/tools/spec/writePlan.ts
-import fs10 from "fs/promises";
 var PLAN_FILE = ".remy-plan.md";
 var writePlanTool = {
   definition: {
@@ -1491,7 +1416,7 @@ status: pending
 ---
 
 ${content}`;
-    await fs10.writeFile(PLAN_FILE, file, "utf-8");
+    await writeFileAtomic(PLAN_FILE, file);
     return "Plan written to .remy-plan.md. Waiting for user approval.";
   }
 };
@@ -1527,13 +1452,13 @@ var updatePlanStatusTool = {
       return "No plan file found.";
     }
     if (status === "rejected") {
-      await fs11.unlink(PLAN_FILE2);
+      await fs11.unlink(PLAN_FILE2).catch(() => {
+      });
       return "Plan rejected and removed.";
     }
-    await fs11.writeFile(
+    await writeFileAtomic(
       PLAN_FILE2,
-      content.replace(/^status:\s*\w+/m, `status: ${status}`),
-      "utf-8"
+      content.replace(/^status:\s*\w+/m, `status: ${status}`)
     );
     return "Plan approved. Proceeding with implementation.";
   }
@@ -2271,7 +2196,7 @@ var readFileTool = {
 
 // src/tools/code/writeFile.ts
 import fs14 from "fs/promises";
-import path7 from "path";
+import path6 from "path";
 var writeFileTool = {
   definition: {
     name: "writeFile",
@@ -2316,7 +2241,7 @@ ${unifiedDiff(partial.path, oldContent, completeContent)}`;
   async execute(input) {
     const release = await acquireFileLock(input.path);
     try {
-      await fs14.mkdir(path7.dirname(input.path), { recursive: true });
+      await fs14.mkdir(path6.dirname(input.path), { recursive: true });
       let oldContent = null;
       try {
         oldContent = await fs14.readFile(input.path, "utf-8");
@@ -2425,7 +2350,7 @@ ${unifiedDiff(input.path, content, updated)}`;
 
 // src/tools/code/bash.ts
 import { spawn as spawn2 } from "child_process";
-import path8 from "path";
+import path7 from "path";
 var DEFAULT_TIMEOUT_MS = 12e4;
 var DEFAULT_MAX_LINES2 = 500;
 var MAX_OUTPUT_BYTES = 3e4;
@@ -2463,7 +2388,7 @@ var bashTool = {
       const child = spawn2("sh", ["-c", input.command], {
         // Pinned rather than inherited. `undefined` here means "wherever the
         // process happens to be", which is the project root only by luck.
-        cwd: input.cwd ? path8.resolve(PROJECT_ROOT, input.cwd) : PROJECT_ROOT,
+        cwd: input.cwd ? path7.resolve(PROJECT_ROOT, input.cwd) : PROJECT_ROOT,
         env: { ...process.env, FORCE_COLOR: "1" }
       });
       let output = "";
@@ -2707,7 +2632,7 @@ var globTool = {
 
 // src/tools/code/listDir.ts
 import fs16 from "fs/promises";
-import path9 from "path";
+import path8 from "path";
 var EXCLUDE = /* @__PURE__ */ new Set([".git", "node_modules"]);
 var MAX_CHILDREN = 15;
 async function readAndSort(dirPath) {
@@ -2724,7 +2649,7 @@ async function readAndSort(dirPath) {
 }
 async function collapsePath(basePath, name) {
   let display = name;
-  let current = path9.join(basePath, name);
+  let current = path8.join(basePath, name);
   for (; ; ) {
     let children;
     try {
@@ -2734,7 +2659,7 @@ async function collapsePath(basePath, name) {
     }
     if (children.length === 1 && children[0].isDirectory()) {
       display += "/" + children[0].name;
-      current = path9.join(current, children[0].name);
+      current = path8.join(current, children[0].name);
     } else {
       break;
     }
@@ -2752,7 +2677,7 @@ function formatSize(bytes) {
 }
 async function formatFile(dirPath, name, indent) {
   try {
-    const stat2 = await fs16.stat(path9.join(dirPath, name));
+    const stat2 = await fs16.stat(path8.join(dirPath, name));
     return `${indent}${name}${" ".repeat(Math.max(1, 30 - indent.length - name.length))}${formatSize(stat2.size)}`;
   } catch {
     return `${indent}${name}`;
@@ -3063,7 +2988,8 @@ var CONTENT_TYPES = {
   ".jpg": "image/jpeg",
   ".jpeg": "image/jpeg",
   ".gif": "image/gif",
-  ".webp": "image/webp"
+  ".webp": "image/webp",
+  ".svg": "image/svg+xml"
 };
 var hosted = /* @__PURE__ */ new Map();
 function isFetchableUrl(ref) {
@@ -3215,7 +3141,7 @@ async function captureAndAnalyzeScreenshot(promptOrOptions) {
   let onLog;
   let model;
   let apiConfig;
-  let path14;
+  let path13;
   let fullPage = true;
   let width;
   let height;
@@ -3223,7 +3149,7 @@ async function captureAndAnalyzeScreenshot(promptOrOptions) {
   if (typeof promptOrOptions === "object" && promptOrOptions !== null) {
     prompt = promptOrOptions.prompt;
     existingImage = promptOrOptions.image;
-    path14 = promptOrOptions.path;
+    path13 = promptOrOptions.path;
     if (promptOrOptions.fullPage !== void 0) {
       fullPage = promptOrOptions.fullPage;
     }
@@ -3247,7 +3173,7 @@ async function captureAndAnalyzeScreenshot(promptOrOptions) {
     const ssResult = await sidecarRequest(
       fullPage ? "/screenshot-full-page" : "/screenshot-viewport",
       {
-        ...path14 ? { path: path14 } : {},
+        ...path13 ? { path: path13 } : {},
         ...width != null ? { width } : {},
         ...height != null ? { height } : {},
         ...format ? { format } : {}
@@ -3670,7 +3596,8 @@ async function runSubAgent(config) {
     background,
     acquireLock,
     onBackgroundComplete,
-    captureArtifacts
+    captureArtifacts,
+    cachePolicy = "run"
   } = config;
   const artifacts = {};
   const bgAbort = background ? new AbortController() : null;
@@ -3765,6 +3692,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
               system: fullSystem,
               messages: cleanMessagesForApi(messages),
               tools: tools2,
+              cachePolicy,
               signal
             },
             {
@@ -4250,15 +4178,15 @@ var BROWSER_EXTERNAL_TOOLS = /* @__PURE__ */ new Set(["browserCommand"]);
 
 // src/subagents/common/context.ts
 import fs17 from "fs";
-import path10 from "path";
-function walkMdFiles2(dir, skip) {
+import path9 from "path";
+function walkMdFiles(dir, skip) {
   const files = [];
   try {
     for (const entry of fs17.readdirSync(dir, { withFileTypes: true })) {
-      const full = path10.join(dir, entry.name);
+      const full = path9.join(dir, entry.name);
       if (entry.isDirectory()) {
         if (!skip?.has(entry.name)) {
-          files.push(...walkMdFiles2(full, skip));
+          files.push(...walkMdFiles(full, skip));
         }
       } else if (entry.name.endsWith(".md")) {
         files.push(full);
@@ -4268,7 +4196,7 @@ function walkMdFiles2(dir, skip) {
   }
   return files.sort();
 }
-function parseFrontmatter3(filePath) {
+function parseFrontmatter2(filePath) {
   try {
     const content = fs17.readFileSync(filePath, "utf-8");
     const match = content.match(/^---\n([\s\S]*?)\n---/);
@@ -4290,12 +4218,12 @@ function parseFrontmatter3(filePath) {
   }
 }
 function loadSpecIndex() {
-  const files = walkMdFiles2("src", /* @__PURE__ */ new Set(["roadmap"]));
+  const files = walkMdFiles("src", /* @__PURE__ */ new Set(["roadmap"]));
   if (files.length === 0) {
     return "";
   }
   const lines = files.map((f) => {
-    const fm = parseFrontmatter3(f);
+    const fm = parseFrontmatter2(f);
     let line = `- ${f}`;
     if (fm.name) {
       line += ` \u2014 "${fm.name}"`;
@@ -4333,10 +4261,10 @@ ${indexJson.standalone.map((s) => `- ${s}`).join("\n")}`
     }
   } catch {
   }
-  const files = walkMdFiles2("src/roadmap");
+  const files = walkMdFiles("src/roadmap");
   if (files.length > 0) {
     const lines = files.map((f) => {
-      const fm = parseFrontmatter3(f);
+      const fm = parseFrontmatter2(f);
       let line = `- ${f}`;
       if (fm.name) {
         line += ` \u2014 "${fm.name}"`;
@@ -5331,7 +5259,7 @@ function load() {
 }
 function save(indices) {
   try {
-    fs18.writeFileSync(SAMPLE_FILE, JSON.stringify(indices));
+    writeFileAtomicSync(SAMPLE_FILE, JSON.stringify(indices));
   } catch {
   }
 }
@@ -5582,6 +5510,8 @@ async function runDesignExpert(opts, context) {
     }),
     task: opts.task,
     history: history.length > 0 ? history : void 0,
+    // History-carrying thread re-sent across parent turns — 1h-TTL profile.
+    cachePolicy: "conversation",
     tools: opts.render ? DESIGN_EXPERT_RENDER_TOOLS : DESIGN_EXPERT_TOOLS,
     externalTools: /* @__PURE__ */ new Set(),
     executeTool: (name, input, toolCallId, onLog, sams) => {
@@ -5705,14 +5635,14 @@ var VISION_TOOLS = [
 
 // src/subagents/productVision/executor.ts
 import fs19 from "fs";
-import path11 from "path";
+import path10 from "path";
 var ROADMAP_DIR = "src/roadmap";
 var PITCH_DECK_SHELL = readAsset(
   "subagents/productVision",
   "pitch-deck-shell.html"
 );
 function resolve2(filePath) {
-  return path11.join(ROADMAP_DIR, filePath);
+  return path10.join(ROADMAP_DIR, filePath);
 }
 async function executeVisionTool(name, input, context) {
   switch (name) {
@@ -5849,6 +5779,8 @@ var productVisionTool = {
       system: getProductVisionPrompt(),
       task: input.task,
       history: history.length > 0 ? history : void 0,
+      // History-carrying thread re-sent across parent turns — 1h-TTL profile.
+      cachePolicy: "conversation",
       tools: VISION_TOOLS,
       externalTools: /* @__PURE__ */ new Set(),
       executeTool: (name, input2, toolCallId, _onLog, sams) => {
@@ -6316,7 +6248,7 @@ var SUBAGENT_TOOL_NAMES = /* @__PURE__ */ new Set([
   "runAutomatedBrowserTest",
   "askMindStudioSdk"
 ]);
-function getToolDefinitions(_onboardingState) {
+function getToolDefinitions() {
   return ALL_TOOLS.map((t) => t.definition);
 }
 function getToolByName(name) {
@@ -6700,7 +6632,11 @@ Write the summary of the conversation above, following your instructions.`;
     messages: [{ role: "user", content: userContent }],
     // Always empty. With a toolset available the model picks `tool_use` over
     // producing a summary, leaving summaryText empty.
-    tools: []
+    tools: [],
+    // Each summary call carries a unique 100-200KB chunk that is never
+    // re-read (parallel siblings can't read each other's in-flight writes
+    // either) — a cache write here is pure waste.
+    cachePolicy: "oneshot"
   })) {
     if (event.type === "text") {
       summaryText += event.text;
@@ -6732,15 +6668,10 @@ Write the summary of the conversation above, following your instructions.`;
 
 // src/session.ts
 import fs21 from "fs";
-import path12 from "path";
+import path11 from "path";
 var log10 = createLogger("session");
 var SESSION_FILE = ".remy-session.json";
 var ARCHIVE_DIR = ".logs/sessions";
-function writeFileAtomicSync(file, data) {
-  const tmp = `${file}.tmp`;
-  fs21.writeFileSync(tmp, data, "utf-8");
-  fs21.renameSync(tmp, file);
-}
 var ROTATE_THRESHOLD_BYTES = 32 * 1024 * 1024;
 var RETAIN_TAIL_BYTES = 16 * 1024 * 1024;
 var ARCHIVE_RETENTION_BYTES = 64 * 1024 * 1024;
@@ -6769,6 +6700,12 @@ function loadSession(state) {
       return true;
     }
   } catch {
+    try {
+      const quarantine = `${SESSION_FILE}.corrupt-${Date.now()}`;
+      fs21.renameSync(SESSION_FILE, quarantine);
+      log10.warn(`Session file unreadable \u2014 quarantined to ${quarantine}`);
+    } catch {
+    }
   }
   return false;
 }
@@ -6831,17 +6768,17 @@ function archiveMessages(messages, label, models) {
   fs21.mkdirSync(ARCHIVE_DIR, { recursive: true });
   const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
   const count = messages.length;
-  let dest = path12.join(ARCHIVE_DIR, `${label}-${ts}.c${count}.json`);
+  let dest = path11.join(ARCHIVE_DIR, `${label}-${ts}.c${count}.json`);
   let n = 1;
   while (fs21.existsSync(dest)) {
-    dest = path12.join(ARCHIVE_DIR, `${label}-${ts}-${n++}.c${count}.json`);
+    dest = path11.join(ARCHIVE_DIR, `${label}-${ts}-${n++}.c${count}.json`);
   }
   const payload = { messages };
   if (models && Object.keys(models).length > 0) {
     payload.models = models;
   }
   writeFileAtomicSync(dest, JSON.stringify(payload));
-  archiveCountCache.set(path12.basename(dest), count);
+  archiveCountCache.set(path11.basename(dest), count);
   log10.info("Session archived", { label, dest, messageCount: count });
   pruneArchives();
   return dest;
@@ -6854,7 +6791,7 @@ function pruneArchives() {
     }
     const archives = entries.map((name) => ({
       name,
-      size: fs21.statSync(path12.join(ARCHIVE_DIR, name)).size
+      size: fs21.statSync(path11.join(ARCHIVE_DIR, name)).size
     })).sort(
       (a, b) => archiveSortKey(b.name).localeCompare(archiveSortKey(a.name))
     );
@@ -6872,7 +6809,7 @@ function pruneArchives() {
     let freed = 0;
     for (let i = cut; i < archives.length; i++) {
       try {
-        fs21.unlinkSync(path12.join(ARCHIVE_DIR, archives[i].name));
+        fs21.unlinkSync(path11.join(ARCHIVE_DIR, archives[i].name));
         freed += archives[i].size;
         removed++;
       } catch {
@@ -6896,7 +6833,7 @@ function parseArchive(name) {
     return cached3;
   }
   try {
-    const raw = fs21.readFileSync(path12.join(ARCHIVE_DIR, name), "utf-8");
+    const raw = fs21.readFileSync(path11.join(ARCHIVE_DIR, name), "utf-8");
     const data = JSON.parse(raw);
     const messages = Array.isArray(data?.messages) ? data.messages : [];
     archiveCountCache.set(name, messages.length);
@@ -7177,7 +7114,7 @@ function triggerCompaction(state, apiConfig, opts = {}) {
 
 // src/brandExtraction/index.ts
 import fs22 from "fs";
-import path13 from "path";
+import path12 from "path";
 import { createHash } from "crypto";
 var log12 = createLogger("brandExtraction");
 var EXTRACT_PROMPT = readAsset("brandExtraction", "extract.md");
@@ -7201,18 +7138,18 @@ async function runExtraction(apiConfig, model) {
   return brand;
 }
 function isDedicatedBrandFile(filePath) {
-  if (filePath.split(path13.sep).includes("@brand")) {
+  if (filePath.split(path12.sep).includes("@brand")) {
     return true;
   }
-  const { type } = parseFrontmatter4(filePath);
+  const { type } = parseFrontmatter3(filePath);
   return type.startsWith("design/color") || type.startsWith("design/typography");
 }
 function isBrandRelevant(filePath) {
-  return filePath === path13.join("src", "app.md") || isDedicatedBrandFile(filePath);
+  return filePath === path12.join("src", "app.md") || isDedicatedBrandFile(filePath);
 }
 function computeInputHash() {
   const entries = [];
-  for (const filePath of walkMdFiles3("src")) {
+  for (const filePath of walkMdFiles2("src")) {
     if (isBrandRelevant(filePath)) {
       entries.push({ path: filePath, content: readSafe(filePath) });
     }
@@ -7253,14 +7190,14 @@ function readBrandManifest() {
     return "";
   }
 }
-function walkMdFiles3(dir) {
+function walkMdFiles2(dir) {
   const results = [];
   try {
     const entries = fs22.readdirSync(dir, { withFileTypes: true });
     for (const entry of entries) {
-      const full = path13.join(dir, entry.name);
+      const full = path12.join(dir, entry.name);
       if (entry.isDirectory()) {
-        results.push(...walkMdFiles3(full));
+        results.push(...walkMdFiles2(full));
       } else if (entry.name.endsWith(".md")) {
         results.push(full);
       }
@@ -7269,7 +7206,7 @@ function walkMdFiles3(dir) {
   }
   return results.sort();
 }
-function parseFrontmatter4(filePath) {
+function parseFrontmatter3(filePath) {
   try {
     const content = fs22.readFileSync(filePath, "utf-8");
     const match = content.match(/^---\n([\s\S]*?)\n---/);
@@ -7298,7 +7235,10 @@ async function extractBrand(apiConfig, model) {
       subAgentId: "brandExtractor",
       system: EXTRACT_PROMPT,
       messages: [{ role: "user", content: corpus }],
-      tools: []
+      tools: [],
+      // One call per extraction over a corpus that changes with every spec
+      // edit — never re-read, so a cache write is pure waste.
+      cachePolicy: "oneshot"
     })) {
       if (event.type === "text") {
         responseText += event.text;
@@ -7337,7 +7277,7 @@ async function extractBrand(apiConfig, model) {
 var HEAD_SLICE_CHARS = 2e3;
 var BRAND_CORPUS_CHAR_LIMIT = 24e5;
 function buildCorpus() {
-  const all = walkMdFiles3("src");
+  const all = walkMdFiles2("src");
   const ordered = [
     ...all.filter(isBrandRelevant),
     ...all.filter((f) => !isBrandRelevant(f))
@@ -7480,11 +7420,9 @@ function pickFont(raw) {
   return out;
 }
 function persistBrand(brand, inputHash) {
-  const tmp = `${BRAND_FILE}.tmp`;
-  fs22.writeFileSync(tmp, JSON.stringify(brand, null, 2), "utf-8");
-  fs22.renameSync(tmp, BRAND_FILE);
+  writeFileAtomicSync(BRAND_FILE, JSON.stringify(brand, null, 2));
   const cache = { inputHash, generatedAt: Date.now() };
-  fs22.writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2), "utf-8");
+  writeFileAtomicSync(CACHE_FILE, JSON.stringify(cache, null, 2));
 }
 function readCache() {
   try {
@@ -7825,7 +7763,7 @@ async function runTurn(params) {
     toolRegistry,
     onBackgroundComplete
   } = params;
-  const tools2 = getToolDefinitions(onboardingState);
+  const tools2 = getToolDefinitions();
   const buildModelOverride = buildModel ? filterModelPicks({ parent: buildModel }).parent : void 0;
   const baseline = resolveModel("parent", state.models, model);
   const parentModel = buildModelOverride ?? baseline;
@@ -8033,6 +7971,9 @@ async function runTurn(params) {
             system,
             messages: cleanMessagesForApi(state.messages),
             tools: tools2,
+            // The parent is one long-lived conversation re-read across turns
+            // with multi-minute gaps — the 1h-TTL profile.
+            cachePolicy: "conversation",
             signal
           },
           {
@@ -8569,16 +8510,15 @@ ${lines.join("\n")}`;
 }
 
 // src/headless/planFile.ts
-import { readFileSync, writeFileSync, unlinkSync } from "fs";
+import { readFileSync, unlinkSync } from "fs";
 var PLAN_FILE3 = ".remy-plan.md";
 function applyPlanFileSideEffect(rawText) {
   if (hasSentinel(rawText, "approvePlan") || hasSentinel(rawText, "approveInitialPlan")) {
     try {
       const plan = readFileSync(PLAN_FILE3, "utf-8");
-      writeFileSync(
+      writeFileAtomicSync(
         PLAN_FILE3,
-        plan.replace(/^status:\s*pending/m, "status: approved"),
-        "utf-8"
+        plan.replace(/^status:\s*pending/m, "status: approved")
       );
     } catch {
     }
@@ -8591,7 +8531,7 @@ function applyPlanFileSideEffect(rawText) {
 }
 
 // src/headless/stats.ts
-import { readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { readFileSync as readFileSync2 } from "fs";
 var STATS_FILE = ".remy-stats.json";
 function createSessionStats() {
   return {
@@ -8628,7 +8568,7 @@ function loadPassiveResults() {
 }
 function writeStats(stats, queue, passiveResults) {
   try {
-    writeFileSync2(
+    writeFileAtomicSync(
       STATS_FILE,
       JSON.stringify({
         ...stats,
@@ -8857,9 +8797,7 @@ var HeadlessSession = class {
                 name: "compactConversation",
                 input: {},
                 startedAt: Date.now(),
-                background: true,
-                uiOnly: true,
-                result: "Compaction started in the background."
+                uiOnly: true
               }
             ]
           });
@@ -8868,15 +8806,7 @@ var HeadlessSession = class {
             type: "tool_start",
             id,
             name: "compactConversation",
-            input: {},
-            background: true
-          });
-          this.onEvent({
-            type: "tool_done",
-            id,
-            name: "compactConversation",
-            result: "Compaction started in the background.",
-            isError: false
+            input: {}
           });
         }
       } else {
@@ -8885,11 +8815,31 @@ var HeadlessSession = class {
         if (this.syntheticCompactionId) {
           const id = this.syntheticCompactionId;
           this.syntheticCompactionId = null;
-          this.onBackgroundComplete(
+          const result = event.error ? `Error: ${event.error}` : formatSummariesResult(event.summaries ?? []);
+          const isError = !!event.error;
+          for (let i = this.state.messages.length - 1; i >= 0; i--) {
+            const msg = this.state.messages[i];
+            if (msg.role !== "assistant" || !Array.isArray(msg.content)) {
+              continue;
+            }
+            const block = msg.content.find(
+              (b) => b.type === "tool" && b.id === id
+            );
+            if (block && block.type === "tool") {
+              block.result = result;
+              block.isError = isError;
+              block.completedAt = Date.now();
+              saveSession(this.state);
+              break;
+            }
+          }
+          this.onEvent({
+            type: "tool_done",
             id,
-            "compactConversation",
-            event.error ? `Error: ${event.error}` : formatSummariesResult(event.summaries ?? [])
-          );
+            name: "compactConversation",
+            result,
+            isError
+          });
         }
         this.sessionStats.compactionInProgress = false;
         if (!event.error) {
@@ -9350,10 +9300,7 @@ var HeadlessSession = class {
     const buildModel = hasSentinel(rawText, "approvePlan") ? parsed.buildModel : void 0;
     const onboardingState = parsed.onboardingState ?? "onboardingFinished";
     this.currentOnboardingState = onboardingState;
-    const system = buildSystemPrompt(
-      onboardingState,
-      parsed.viewContext
-    );
+    const system = buildSystemPrompt(onboardingState);
     if (resolved?.next && !fromChain) {
       for (const step of getActionChain(resolved.next)) {
         this.queue.push({
@@ -9430,13 +9377,12 @@ var HeadlessSession = class {
     }
     const onboardingState = batch.find((b) => b.command.onboardingState !== void 0)?.command.onboardingState ?? this.currentOnboardingState ?? "onboardingFinished";
     this.currentOnboardingState = onboardingState;
-    const viewContext = [...batch].reverse().find((b) => b.command.viewContext !== void 0)?.command.viewContext;
     await this.executeTurn({
       entries,
       requestId: primaryRid,
       absorbedRids,
       onboardingState,
-      system: buildSystemPrompt(onboardingState, viewContext)
+      system: buildSystemPrompt(onboardingState)
     });
   }
   /**