@mindstudio-ai/remy 0.1.250 → 0.1.252

package/dist/headless.js

@@ -828,6 +828,10 @@ Current date: ${now}
   {{compiled/media-cdn.md}}
   </media_cdn>
 
+  <app_files>
+  {{compiled/files.md}}
+  </app_files>
+
   <interfaces>
   {{compiled/interfaces.md}}
   </interfaces>
@@ -2002,6 +2006,7 @@ var compactConversationTool = {
 // src/tools/code/readFile.ts
 import fs12 from "fs/promises";
 var DEFAULT_WINDOW = 500;
+var MAX_BYTES = 64 * 1024;
 function isBinary(buffer) {
   const sample = buffer.subarray(0, 8192);
   for (let i = 0; i < sample.length; i++) {
@@ -2015,7 +2020,7 @@ var readFileTool = {
   clearable: true,
   definition: {
     name: "readFile",
-    description: "Read a file's contents with line numbers. Always read a file before editing it \u2014 never guess at contents. By default returns the first 500 lines. To read a specific range, pass startLine and endLine (1-indexed, inclusive) \u2014 e.g. to read lines 253\u2013343, pass startLine: 253, endLine: 343. To read the end of a file or log, pass tail (the number of lines from the end). Line numbers in the output correspond to what editFile expects. For a large file, locate the relevant section first (symbols or grep), then read just that range.",
+    description: "Read a file's contents with line numbers. Always read a file before editing it \u2014 never guess at contents. By default returns the first 500 lines, and at most 64KB \u2014 a file with very wide lines (a CSV, a minified bundle) comes back short of 500 lines, so read a narrower range or grep rather than paging through it. To read a specific range, pass startLine and endLine (1-indexed, inclusive) \u2014 e.g. to read lines 253\u2013343, pass startLine: 253, endLine: 343. To read the end of a file or log, pass tail (the number of lines from the end). Line numbers in the output correspond to what editFile expects. For a large file, locate the relevant section first (symbols or grep), then read just that range.",
     inputSchema: {
       type: "object",
       properties: {
@@ -2072,12 +2077,35 @@ var readFileTool = {
           endIdxExclusive = Math.min(startIdx + DEFAULT_WINDOW, totalLines);
         }
       }
-      const sliced = allLines.slice(startIdx, endIdxExclusive);
-      const numbered = sliced.map((line, i) => `${String(startIdx + i + 1).padStart(4)} ${line}`).join("\n");
-      let result = numbered;
+      const numberedLines = allLines.slice(startIdx, endIdxExclusive).map((line, i) => `${String(startIdx + i + 1).padStart(4)} ${line}`);
+      let kept = numberedLines;
+      let byteTruncated = false;
+      if (Buffer.byteLength(numberedLines.join("\n"), "utf-8") > MAX_BYTES) {
+        byteTruncated = true;
+        kept = [];
+        let used = 0;
+        for (const line of numberedLines) {
+          const cost = Buffer.byteLength(line, "utf-8") + (kept.length > 0 ? 1 : 0);
+          if (used + cost > MAX_BYTES) {
+            break;
+          }
+          kept.push(line);
+          used += cost;
+        }
+        if (kept.length === 0) {
+          kept = [
+            Buffer.from(numberedLines[0], "utf-8").subarray(0, MAX_BYTES).toString("utf-8")
+          ];
+        }
+      }
+      let result = kept.join("\n");
       const displayStart = startIdx + 1;
-      const displayEnd = startIdx + sliced.length;
-      if (displayStart > 1 || displayEnd < totalLines) {
+      const displayEnd = startIdx + kept.length;
+      if (byteTruncated) {
+        result += `
+
+(showing lines ${displayStart}\u2013${displayEnd} of ${totalLines}, truncated at ${(MAX_BYTES / 1024).toFixed(0)}KB \u2014 this file's lines are wide. Read a narrower range with startLine/endLine, or grep for what you need, instead of paging through it.)`;
+      } else if (displayStart > 1 || displayEnd < totalLines) {
         result += `
 
 (showing lines ${displayStart}\u2013${displayEnd} of ${totalLines} \u2014 pass startLine/endLine to read a different range)`;
@@ -3766,6 +3794,17 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
   return { text: ack, messages: [], backgrounded: true };
 }
 
+// src/subagents/common/tools.ts
+var COMMON_READ_TOOLS = [
+  readFileTool.definition,
+  listDirTool.definition,
+  grepTool.definition,
+  globTool.definition
+];
+var COMMON_READ_TOOL_NAMES = new Set(
+  COMMON_READ_TOOLS.map((t) => t.name)
+);
+
 // src/subagents/browserAutomation/tools.ts
 var BROWSER_TOOLS = [
   {
@@ -3909,23 +3948,193 @@ var BROWSER_TOOLS = [
         }
       }
     }
-  }
+  },
+  // Read tools so the QA agent can pull full spec detail on demand — the spec
+  // context in its prompt is a lightweight index (see prompt.ts) that points
+  // here. Routed to the global executeTool in index.ts, mirroring specSync.
+  ...COMMON_READ_TOOLS,
+  readSpecTool.definition
 ];
 var BROWSER_EXTERNAL_TOOLS = /* @__PURE__ */ new Set(["browserCommand"]);
 
-// src/subagents/browserAutomation/prompt.ts
+// src/subagents/common/context.ts
 import fs16 from "fs";
-var BASE_PROMPT = readAsset("subagents/browserAutomation", "prompt.md");
-function getBrowserAutomationPrompt() {
+import path9 from "path";
+function walkMdFiles2(dir, skip) {
+  const files = [];
   try {
-    const appSpec = fs16.readFileSync("src/app.md", "utf-8").trim();
-    return `${BASE_PROMPT}
+    for (const entry of fs16.readdirSync(dir, { withFileTypes: true })) {
+      const full = path9.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        if (!skip?.has(entry.name)) {
+          files.push(...walkMdFiles2(full, skip));
+        }
+      } else if (entry.name.endsWith(".md")) {
+        files.push(full);
+      }
+    }
+  } catch {
+  }
+  return files.sort();
+}
+function parseFrontmatter2(filePath) {
+  try {
+    const content = fs16.readFileSync(filePath, "utf-8");
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match) {
+      return {};
+    }
+    const fm = {};
+    for (const line of match[1].split("\n")) {
+      const sep = line.indexOf(":");
+      if (sep > 0) {
+        const key = line.slice(0, sep).trim();
+        const val = line.slice(sep + 1).trim();
+        fm[key] = val;
+      }
+    }
+    return fm;
+  } catch {
+    return {};
+  }
+}
+function loadSpecIndex() {
+  const files = walkMdFiles2("src", /* @__PURE__ */ new Set(["roadmap"]));
+  if (files.length === 0) {
+    return "";
+  }
+  const lines = files.map((f) => {
+    const fm = parseFrontmatter2(f);
+    let line = `- ${f}`;
+    if (fm.name) {
+      line += ` \u2014 "${fm.name}"`;
+    }
+    if (fm.description) {
+      line += ` \u2014 ${fm.description}`;
+    }
+    return line;
+  });
+  return `<spec_files>
+## Project Spec Files
+Use readFile to access full contents.
 
-<!-- cache_breakpoint -->
+${lines.join("\n")}
+</spec_files>`;
+}
+function loadRoadmapIndex() {
+  const parts = [];
+  try {
+    const indexJson = JSON.parse(
+      fs16.readFileSync("src/roadmap/index.json", "utf-8")
+    );
+    if (indexJson.lanes?.length > 0) {
+      const laneLines = indexJson.lanes.map(
+        (l) => `- **${l.name}**: ${l.narrative || ""} (${l.items?.length || 0} items)`
+      );
+      parts.push(`### Lanes
+${laneLines.join("\n")}`);
+    }
+    if (indexJson.standalone?.length > 0) {
+      parts.push(
+        `### Standalone
+${indexJson.standalone.map((s) => `- ${s}`).join("\n")}`
+      );
+    }
+  } catch {
+  }
+  const files = walkMdFiles2("src/roadmap");
+  if (files.length > 0) {
+    const lines = files.map((f) => {
+      const fm = parseFrontmatter2(f);
+      let line = `- ${f}`;
+      if (fm.name) {
+        line += ` \u2014 "${fm.name}"`;
+      }
+      if (fm.status) {
+        line += ` (${fm.status})`;
+      }
+      if (fm.description) {
+        line += ` \u2014 ${fm.description}`;
+      }
+      return line;
+    });
+    parts.push(`### Items
+${lines.join("\n")}`);
+  }
+  if (parts.length === 0) {
+    return "";
+  }
+  return `<current_roadmap>
+## Roadmap
+Use readFile to access full contents.
+
+${parts.join("\n\n")}
+</current_roadmap>`;
+}
+function loadPlatformBrief() {
+  return `<platform_brief>
+## What is a Remy app?
+
+A Remy app is a managed full-stack TypeScript project with three layers: a spec (natural language in src/), a backend contract (methods, tables, roles in dist/), and one or more interfaces (web, API, bots, cron, etc.). The spec is the source of truth; code is derived from it.
+
+This is a capable, stable platform used in production by 100k+ users. Build with confidence \u2014 you're building production-grade apps, not fragile prototypes.
+
+## What people build
+
+- Business tools \u2014 client portals, approval workflows, admin panels with role-based access
+- AI-powered apps \u2014 document processors, image/video tools, content generators, conversational agents that take actions
+- Full-stack web apps \u2014 social platforms, membership sites, marketplaces, booking systems, community hubs \u2014 multi-user apps with auth, data, UI
+- Automations with no UI \u2014 cron jobs, webhook handlers, email processors, data sync pipelines
+- Marketing & launch pages \u2014 landing pages, waitlist pages with referral mechanics, product sites with scroll animations
+- Agent tools \u2014 MCP tool servers for AI assistants
+- Creative/interactive projects \u2014 browser games with p5.js or Three.js, interactive visualizations, generative art, portfolio sites
+- API services \u2014 backend logic exposed as REST endpoints
+- Simple static sites \u2014 no backend needed, just a web interface with a build step
+
+An app can be any combination of these.
+
+## Interfaces
+
+Each interface type invokes the same backend methods. Methods don't know which interface called them.
+
+- Web \u2014 any TypeScript project with a build command. Framework-agnostic (React, Vue, Svelte, vanilla, anything). The frontend SDK provides typed RPC to backend methods.
+- API \u2014 auto-generated REST endpoints for every method
+- Cron \u2014 scheduled jobs on a configurable interval
+- Webhook \u2014 HTTP endpoints that trigger methods
+- Email \u2014 inbound email processing
+- MCP \u2014 tool servers for AI assistants
+- Agent \u2014 conversational LLM interface with tool access to backend methods
+
+## Backend
+
+TypeScript running in a sandboxed environment. Any npm package can be installed. Key capabilities:
+
+- Managed SQLite database with typed schemas and automatic migrations. Define a TypeScript interface, push, and the platform handles diffing and migrating.
+- Built-in app-managed auth. Opt-in via manifest \u2014 developer builds login UI, platform handles verification codes (email-code, sms-code) and cookie sessions. API key auth for programmatic access. No OAuth, no social login (no Apple, Google, Facebook, or GitHub sign-in). Backend methods use auth.requireRole() for access control.
+- Encrypted secrets with separate dev/prod values, injected as process.env. For third-party service credentials not covered by the SDK.
+- Git-native deployment. Push to default branch to deploy.
+
+## MindStudio SDK
+
+The first-party SDK (@mindstudio-ai/agent) provides access to 200+ AI models (OpenAI, Anthropic, Google, Meta, Mistral, and more) and 1000+ integrations (email, SMS, Slack, HubSpot, Google Workspace, web scraping, image/video generation, media processing, and much more) with zero configuration \u2014 credentials are handled automatically in the execution environment. No API keys needed. This SDK is robust and battle-tested in production.
 
-<app_context>
-${appSpec}
-</app_context>`;
+## What Remy apps are NOT good for
+
+- Native mobile apps (iOS/Android). Mobile-responsive web apps are fine.
+- Real-time multiplayer with persistent connections (no WebSocket support). Turn-based or async patterns work.
+</platform_brief>`;
+}
+
+// src/subagents/browserAutomation/prompt.ts
+var BASE_PROMPT = readAsset("subagents/browserAutomation", "prompt.md");
+function getBrowserAutomationPrompt() {
+  try {
+    const specIndex = loadSpecIndex();
+    const parts = [BASE_PROMPT, "<!-- cache_breakpoint -->"];
+    if (specIndex) {
+      parts.push(specIndex);
+    }
+    return parts.join("\n\n");
   } catch {
     return BASE_PROMPT;
   }
@@ -3982,6 +4191,9 @@ async function runBrowserAutomation(task, context, opts) {
             return `Error taking screenshot: ${err.message}`;
           }
         }
+        if (COMMON_READ_TOOL_NAMES.has(name) || name === readSpecTool.definition.name) {
+          return executeTool(name, _input, context);
+        }
         return `Error: unknown local tool "${name}"`;
       },
       apiConfig: context.apiConfig,
@@ -4190,17 +4402,6 @@ var screenshotTool = {
   }
 };
 
-// src/subagents/common/tools.ts
-var COMMON_READ_TOOLS = [
-  readFileTool.definition,
-  listDirTool.definition,
-  grepTool.definition,
-  globTool.definition
-];
-var COMMON_READ_TOOL_NAMES = new Set(
-  COMMON_READ_TOOLS.map((t) => t.name)
-);
-
 // src/subagents/designExpert/tools/searchGoogle.ts
 var searchGoogle_exports = {};
 __export(searchGoogle_exports, {
@@ -4802,174 +5003,6 @@ __export(polishCopy_exports, {
   execute: () => execute8
 });
 
-// src/subagents/common/context.ts
-import fs17 from "fs";
-import path9 from "path";
-function walkMdFiles2(dir, skip) {
-  const files = [];
-  try {
-    for (const entry of fs17.readdirSync(dir, { withFileTypes: true })) {
-      const full = path9.join(dir, entry.name);
-      if (entry.isDirectory()) {
-        if (!skip?.has(entry.name)) {
-          files.push(...walkMdFiles2(full, skip));
-        }
-      } else if (entry.name.endsWith(".md")) {
-        files.push(full);
-      }
-    }
-  } catch {
-  }
-  return files.sort();
-}
-function parseFrontmatter2(filePath) {
-  try {
-    const content = fs17.readFileSync(filePath, "utf-8");
-    const match = content.match(/^---\n([\s\S]*?)\n---/);
-    if (!match) {
-      return {};
-    }
-    const fm = {};
-    for (const line of match[1].split("\n")) {
-      const sep = line.indexOf(":");
-      if (sep > 0) {
-        const key = line.slice(0, sep).trim();
-        const val = line.slice(sep + 1).trim();
-        fm[key] = val;
-      }
-    }
-    return fm;
-  } catch {
-    return {};
-  }
-}
-function loadSpecIndex() {
-  const files = walkMdFiles2("src", /* @__PURE__ */ new Set(["roadmap"]));
-  if (files.length === 0) {
-    return "";
-  }
-  const lines = files.map((f) => {
-    const fm = parseFrontmatter2(f);
-    let line = `- ${f}`;
-    if (fm.name) {
-      line += ` \u2014 "${fm.name}"`;
-    }
-    if (fm.description) {
-      line += ` \u2014 ${fm.description}`;
-    }
-    return line;
-  });
-  return `<spec_files>
-## Project Spec Files
-Use readFile to access full contents.
-
-${lines.join("\n")}
-</spec_files>`;
-}
-function loadRoadmapIndex() {
-  const parts = [];
-  try {
-    const indexJson = JSON.parse(
-      fs17.readFileSync("src/roadmap/index.json", "utf-8")
-    );
-    if (indexJson.lanes?.length > 0) {
-      const laneLines = indexJson.lanes.map(
-        (l) => `- **${l.name}**: ${l.narrative || ""} (${l.items?.length || 0} items)`
-      );
-      parts.push(`### Lanes
-${laneLines.join("\n")}`);
-    }
-    if (indexJson.standalone?.length > 0) {
-      parts.push(
-        `### Standalone
-${indexJson.standalone.map((s) => `- ${s}`).join("\n")}`
-      );
-    }
-  } catch {
-  }
-  const files = walkMdFiles2("src/roadmap");
-  if (files.length > 0) {
-    const lines = files.map((f) => {
-      const fm = parseFrontmatter2(f);
-      let line = `- ${f}`;
-      if (fm.name) {
-        line += ` \u2014 "${fm.name}"`;
-      }
-      if (fm.status) {
-        line += ` (${fm.status})`;
-      }
-      if (fm.description) {
-        line += ` \u2014 ${fm.description}`;
-      }
-      return line;
-    });
-    parts.push(`### Items
-${lines.join("\n")}`);
-  }
-  if (parts.length === 0) {
-    return "";
-  }
-  return `<current_roadmap>
-## Roadmap
-Use readFile to access full contents.
-
-${parts.join("\n\n")}
-</current_roadmap>`;
-}
-function loadPlatformBrief() {
-  return `<platform_brief>
-## What is a Remy app?
-
-A Remy app is a managed full-stack TypeScript project with three layers: a spec (natural language in src/), a backend contract (methods, tables, roles in dist/), and one or more interfaces (web, API, bots, cron, etc.). The spec is the source of truth; code is derived from it.
-
-This is a capable, stable platform used in production by 100k+ users. Build with confidence \u2014 you're building production-grade apps, not fragile prototypes.
-
-## What people build
-
-- Business tools \u2014 client portals, approval workflows, admin panels with role-based access
-- AI-powered apps \u2014 document processors, image/video tools, content generators, conversational agents that take actions
-- Full-stack web apps \u2014 social platforms, membership sites, marketplaces, booking systems, community hubs \u2014 multi-user apps with auth, data, UI
-- Automations with no UI \u2014 cron jobs, webhook handlers, email processors, data sync pipelines
-- Marketing & launch pages \u2014 landing pages, waitlist pages with referral mechanics, product sites with scroll animations
-- Agent tools \u2014 MCP tool servers for AI assistants
-- Creative/interactive projects \u2014 browser games with p5.js or Three.js, interactive visualizations, generative art, portfolio sites
-- API services \u2014 backend logic exposed as REST endpoints
-- Simple static sites \u2014 no backend needed, just a web interface with a build step
-
-An app can be any combination of these.
-
-## Interfaces
-
-Each interface type invokes the same backend methods. Methods don't know which interface called them.
-
-- Web \u2014 any TypeScript project with a build command. Framework-agnostic (React, Vue, Svelte, vanilla, anything). The frontend SDK provides typed RPC to backend methods.
-- API \u2014 auto-generated REST endpoints for every method
-- Cron \u2014 scheduled jobs on a configurable interval
-- Webhook \u2014 HTTP endpoints that trigger methods
-- Email \u2014 inbound email processing
-- MCP \u2014 tool servers for AI assistants
-- Agent \u2014 conversational LLM interface with tool access to backend methods
-
-## Backend
-
-TypeScript running in a sandboxed environment. Any npm package can be installed. Key capabilities:
-
-- Managed SQLite database with typed schemas and automatic migrations. Define a TypeScript interface, push, and the platform handles diffing and migrating.
-- Built-in app-managed auth. Opt-in via manifest \u2014 developer builds login UI, platform handles verification codes (email-code, sms-code) and cookie sessions. API key auth for programmatic access. No OAuth, no social login (no Apple, Google, Facebook, or GitHub sign-in). Backend methods use auth.requireRole() for access control.
-- Encrypted secrets with separate dev/prod values, injected as process.env. For third-party service credentials not covered by the SDK.
-- Git-native deployment. Push to default branch to deploy.
-
-## MindStudio SDK
-
-The first-party SDK (@mindstudio-ai/agent) provides access to 200+ AI models (OpenAI, Anthropic, Google, Meta, Mistral, and more) and 1000+ integrations (email, SMS, Slack, HubSpot, Google Workspace, web scraping, image/video generation, media processing, and much more) with zero configuration \u2014 credentials are handled automatically in the execution environment. No API keys needed. This SDK is robust and battle-tested in production.
-
-## What Remy apps are NOT good for
-
-- Native mobile apps (iOS/Android). Mobile-responsive web apps are fine.
-- Real-time multiplayer with persistent connections (no WebSocket support). Turn-based or async patterns work.
-</platform_brief>`;
-}
-
 // src/subagents/copyEditor/tools.ts
 var COPY_EDITOR_TOOLS = [...COMMON_READ_TOOLS];
 
@@ -5068,7 +5101,7 @@ async function executeDesignExpertTool(name, input, context, toolCallId, onLog)
 }
 
 // src/subagents/designExpert/data/sampleCache.ts
-import fs18 from "fs";
+import fs17 from "fs";
 var SAMPLE_FILE = ".remy-design-sample.json";
 var cached2 = null;
 function generateIndices(poolSize, sampleSize) {
@@ -5082,14 +5115,14 @@ function generateIndices(poolSize, sampleSize) {
 }
 function load() {
   try {
-    return JSON.parse(fs18.readFileSync(SAMPLE_FILE, "utf-8"));
+    return JSON.parse(fs17.readFileSync(SAMPLE_FILE, "utf-8"));
   } catch {
     return null;
   }
 }
 function save(indices) {
   try {
-    fs18.writeFileSync(SAMPLE_FILE, JSON.stringify(indices));
+    fs17.writeFileSync(SAMPLE_FILE, JSON.stringify(indices));
   } catch {
   }
 }
@@ -5451,7 +5484,7 @@ var VISION_TOOLS = [
 ];
 
 // src/subagents/productVision/executor.ts
-import fs19 from "fs";
+import fs18 from "fs";
 import path10 from "path";
 var ROADMAP_DIR = "src/roadmap";
 var PITCH_DECK_SHELL = readAsset(
@@ -5466,13 +5499,13 @@ async function executeVisionTool(name, input, context) {
     case "writeFile": {
       const filePath = resolve(input.path);
       try {
-        fs19.mkdirSync(ROADMAP_DIR, { recursive: true });
+        fs18.mkdirSync(ROADMAP_DIR, { recursive: true });
         let oldContent = null;
         try {
-          oldContent = fs19.readFileSync(filePath, "utf-8");
+          oldContent = fs18.readFileSync(filePath, "utf-8");
         } catch {
         }
-        fs19.writeFileSync(filePath, input.content, "utf-8");
+        fs18.writeFileSync(filePath, input.content, "utf-8");
         const lineCount = input.content.split("\n").length;
         const label = oldContent !== null ? "Wrote" : "Created";
         return `${label} ${filePath} (${lineCount} lines)
@@ -5484,11 +5517,11 @@ ${unifiedDiff(filePath, oldContent ?? "", input.content)}`;
     case "deleteFile": {
       const filePath = resolve(input.path);
       try {
-        if (!fs19.existsSync(filePath)) {
+        if (!fs18.existsSync(filePath)) {
           return `Error: ${filePath} does not exist`;
         }
-        const oldContent = fs19.readFileSync(filePath, "utf-8");
-        fs19.unlinkSync(filePath);
+        const oldContent = fs18.readFileSync(filePath, "utf-8");
+        fs18.unlinkSync(filePath);
         return `Deleted ${filePath}
 ${unifiedDiff(filePath, oldContent, "")}`;
       } catch (err) {
@@ -5501,9 +5534,9 @@ ${unifiedDiff(filePath, oldContent, "")}`;
       }
       const filePath = resolve("pitch.html");
       try {
-        fs19.mkdirSync(ROADMAP_DIR, { recursive: true });
-        const exists = fs19.existsSync(filePath);
-        const before = exists ? fs19.statSync(filePath).mtimeMs : null;
+        fs18.mkdirSync(ROADMAP_DIR, { recursive: true });
+        const exists = fs18.existsSync(filePath);
+        const before = exists ? fs18.statSync(filePath).mtimeMs : null;
         const delivery = exists ? `### Your deliverable
 The pitch deck already exists at \`${filePath}\`. Read it, then update it for the new <pitch_content>, keeping the presentation scaffolding intact \u2014 change only what needs to change.
 
@@ -5533,11 +5566,11 @@ Maintain the bones of the presentation scaffolding. Always keep the progress bar
 ${delivery}`;
         const result = await runDesignExpertRender({ task }, context);
         context.subAgentMessages?.set(context.toolCallId, result.messages);
-        if (!fs19.existsSync(filePath)) {
+        if (!fs18.existsSync(filePath)) {
           return `Error: the design expert did not write ${filePath}. Its reply was:
 ${result.text}`;
         }
-        if (before !== null && fs19.statSync(filePath).mtimeMs === before) {
+        if (before !== null && fs18.statSync(filePath).mtimeMs === before) {
           return `Error: the pitch deck at ${filePath} was not modified. The design expert's reply was:
 ${result.text}`;
         }
@@ -5871,7 +5904,7 @@ var scrapeWebUrlTool = {
 };
 
 // src/tools/spec/writeBuildOverview.ts
-import fs20 from "fs";
+import fs19 from "fs";
 var OVERVIEW_FILE = "src/overview.html";
 var DESIGN_BRIEF = `We are building the Build Overview for this app \u2014 the home page of its Spec tab. It is a calm, dense, one-page reference of everything the app actually contains, including the parts the user can't see. It renders flush inside the Spec tab's content panel (the IDE supplies the surrounding nav).
 
@@ -5951,7 +5984,7 @@ var buildOverviewTool = {
     if (!content) {
       return "Error: writeBuildOverview requires non-empty `content` (the overview copy).";
     }
-    const exists = fs20.existsSync(OVERVIEW_FILE);
+    const exists = fs19.existsSync(OVERVIEW_FILE);
     const task = `<overview_copy>${content}</overview_copy>
 
 ${DESIGN_BRIEF}
@@ -5969,7 +6002,7 @@ ${exists ? refreshDelivery() : initialDelivery()}`;
       }
       const result = await runDesignExpertRender({ task }, context);
       context.subAgentMessages?.set(context.toolCallId, result.messages);
-      if (!fs20.existsSync(OVERVIEW_FILE)) {
+      if (!fs19.existsSync(OVERVIEW_FILE)) {
         return `Error: the design expert did not write ${OVERVIEW_FILE}. Its reply was:
 ${result.text}`;
       }
@@ -6393,7 +6426,7 @@ Write the summary of the conversation above, following your instructions.`;
 }
 
 // src/session.ts
-import fs21 from "fs";
+import fs20 from "fs";
 import path11 from "path";
 var log9 = createLogger("session");
 var SESSION_FILE = ".remy-session.json";
@@ -6412,7 +6445,7 @@ var ARCHIVE_MSG_CACHE_MAX = 3;
 function loadSession(state) {
   pruneArchives();
   try {
-    const raw = fs21.readFileSync(SESSION_FILE, "utf-8");
+    const raw = fs20.readFileSync(SESSION_FILE, "utf-8");
     const data = JSON.parse(raw);
     if (data.models && typeof data.models === "object") {
       state.models = data.models;
@@ -6485,19 +6518,19 @@ function buildPayload(state) {
   return payload;
 }
 function archiveMessages(messages, label, models) {
-  fs21.mkdirSync(ARCHIVE_DIR, { recursive: true });
+  fs20.mkdirSync(ARCHIVE_DIR, { recursive: true });
   const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
   const count = messages.length;
   let dest = path11.join(ARCHIVE_DIR, `${label}-${ts}.c${count}.json`);
   let n = 1;
-  while (fs21.existsSync(dest)) {
+  while (fs20.existsSync(dest)) {
     dest = path11.join(ARCHIVE_DIR, `${label}-${ts}-${n++}.c${count}.json`);
   }
   const payload = { messages };
   if (models && Object.keys(models).length > 0) {
     payload.models = models;
   }
-  fs21.writeFileSync(dest, JSON.stringify(payload), "utf-8");
+  fs20.writeFileSync(dest, JSON.stringify(payload), "utf-8");
   archiveCountCache.set(path11.basename(dest), count);
   log9.info("Session archived", { label, dest, messageCount: count });
   pruneArchives();
@@ -6505,13 +6538,13 @@ function archiveMessages(messages, label, models) {
 }
 function pruneArchives() {
   try {
-    const entries = fs21.readdirSync(ARCHIVE_DIR).filter((name) => ARCHIVE_NAME_RE.test(name));
+    const entries = fs20.readdirSync(ARCHIVE_DIR).filter((name) => ARCHIVE_NAME_RE.test(name));
     if (entries.length <= 1) {
       return;
     }
     const archives = entries.map((name) => ({
       name,
-      size: fs21.statSync(path11.join(ARCHIVE_DIR, name)).size
+      size: fs20.statSync(path11.join(ARCHIVE_DIR, name)).size
     })).sort(
       (a, b) => archiveSortKey(b.name).localeCompare(archiveSortKey(a.name))
     );
@@ -6529,7 +6562,7 @@ function pruneArchives() {
     let freed = 0;
     for (let i = cut; i < archives.length; i++) {
       try {
-        fs21.unlinkSync(path11.join(ARCHIVE_DIR, archives[i].name));
+        fs20.unlinkSync(path11.join(ARCHIVE_DIR, archives[i].name));
         freed += archives[i].size;
         removed++;
       } catch {
@@ -6553,7 +6586,7 @@ function parseArchive(name) {
     return cached3;
   }
   try {
-    const raw = fs21.readFileSync(path11.join(ARCHIVE_DIR, name), "utf-8");
+    const raw = fs20.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);
@@ -6591,7 +6624,7 @@ function readArchiveMessages(name) {
 function listConversationArchives() {
   let names;
   try {
-    names = fs21.readdirSync(ARCHIVE_DIR).filter((n) => ARCHIVE_NAME_RE.test(n));
+    names = fs20.readdirSync(ARCHIVE_DIR).filter((n) => ARCHIVE_NAME_RE.test(n));
   } catch {
     return { slots: [], archivedCount: 0 };
   }
@@ -6702,7 +6735,7 @@ function saveSession(state) {
     if (Buffer.byteLength(serialized, "utf-8") > ROTATE_THRESHOLD_BYTES && rotate(state)) {
       serialized = JSON.stringify(buildPayload(state));
     }
-    fs21.writeFileSync(SESSION_FILE, serialized, "utf-8");
+    fs20.writeFileSync(SESSION_FILE, serialized, "utf-8");
     log9.info("Session saved", { messageCount: state.messages.length });
   } catch (err) {
     log9.warn("Session save failed", { error: err.message });
@@ -6718,8 +6751,8 @@ function clearSession(state) {
   }
   state.messages = [];
   try {
-    if (fs21.existsSync(SESSION_FILE)) {
-      fs21.unlinkSync(SESSION_FILE);
+    if (fs20.existsSync(SESSION_FILE)) {
+      fs20.unlinkSync(SESSION_FILE);
     }
   } catch (err) {
     log9.warn("Session clear: could not remove live file", {
@@ -6771,7 +6804,7 @@ function triggerCompaction(state, apiConfig, opts = {}) {
 }
 
 // src/brandExtraction/index.ts
-import fs22 from "fs";
+import fs21 from "fs";
 import path12 from "path";
 import { createHash } from "crypto";
 var log11 = createLogger("brandExtraction");
@@ -6795,13 +6828,16 @@ async function runExtraction(apiConfig, model) {
   log11.info("Brand persisted", { inputHash });
   return brand;
 }
-function isBrandRelevant(filePath) {
-  if (filePath === path12.join("src", "app.md")) {
+function isDedicatedBrandFile(filePath) {
+  if (filePath.split(path12.sep).includes("@brand")) {
     return true;
   }
   const { type } = parseFrontmatter3(filePath);
   return type.startsWith("design/color") || type.startsWith("design/typography");
 }
+function isBrandRelevant(filePath) {
+  return filePath === path12.join("src", "app.md") || isDedicatedBrandFile(filePath);
+}
 function computeInputHash() {
   const entries = [];
   for (const filePath of walkMdFiles3("src")) {
@@ -6809,7 +6845,7 @@ function computeInputHash() {
       entries.push({ path: filePath, content: readSafe(filePath) });
     }
   }
-  const manifest = readSafe("mindstudio.json");
+  const manifest = readBrandManifest();
   if (manifest) {
     entries.push({ path: "mindstudio.json", content: manifest });
   }
@@ -6822,7 +6858,25 @@ function sha256(input) {
 }
 function readSafe(filePath) {
   try {
-    return fs22.readFileSync(filePath, "utf-8");
+    return fs21.readFileSync(filePath, "utf-8");
+  } catch {
+    return "";
+  }
+}
+function readBrandManifest() {
+  const raw = readSafe("mindstudio.json");
+  if (!raw) {
+    return "";
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    const projected = {};
+    for (const key of ["name", "description", "iconUrl"]) {
+      if (parsed[key] !== void 0) {
+        projected[key] = parsed[key];
+      }
+    }
+    return Object.keys(projected).length > 0 ? JSON.stringify(projected, null, 2) : "";
   } catch {
     return "";
   }
@@ -6830,7 +6884,7 @@ function readSafe(filePath) {
 function walkMdFiles3(dir) {
   const results = [];
   try {
-    const entries = fs22.readdirSync(dir, { withFileTypes: true });
+    const entries = fs21.readdirSync(dir, { withFileTypes: true });
     for (const entry of entries) {
       const full = path12.join(dir, entry.name);
       if (entry.isDirectory()) {
@@ -6845,7 +6899,7 @@ function walkMdFiles3(dir) {
 }
 function parseFrontmatter3(filePath) {
   try {
-    const content = fs22.readFileSync(filePath, "utf-8");
+    const content = fs21.readFileSync(filePath, "utf-8");
     const match = content.match(/^---\n([\s\S]*?)\n---/);
     if (!match) {
       return { type: "" };
@@ -6908,6 +6962,7 @@ async function extractBrand(apiConfig, model) {
   }
   return validateBrand(parsed);
 }
+var HEAD_SLICE_CHARS = 2e3;
 var BRAND_CORPUS_CHAR_LIMIT = 24e5;
 function buildCorpus() {
   const all = walkMdFiles3("src");
@@ -6916,14 +6971,17 @@ function buildCorpus() {
     ...all.filter((f) => !isBrandRelevant(f))
   ];
   const files = [];
-  const manifest = readSafe("mindstudio.json");
+  const manifest = readBrandManifest();
   if (manifest) {
     files.push({ path: "mindstudio.json", content: manifest });
   }
   for (const filePath of ordered) {
     const content = readSafe(filePath);
     if (content) {
-      files.push({ path: filePath, content });
+      files.push({
+        path: filePath,
+        content: isDedicatedBrandFile(filePath) ? content : headSlice(content)
+      });
     }
   }
   const sep = "\n\n---\n\n";
@@ -6945,6 +7003,14 @@ ${content}`;
   }
   return sections.join(sep);
 }
+function headSlice(content) {
+  if (content.length <= HEAD_SLICE_CHARS) {
+    return content;
+  }
+  return content.slice(0, HEAD_SLICE_CHARS) + `
+
+(head slice of a ${(content.length / 1024).toFixed(0)}KB spec \u2014 not a dedicated brand file, so only its opening is included)`;
+}
 function parseJsonResponse(text) {
   const trimmed = text.trim();
   const fenceMatch = trimmed.match(/^```(?:json)?\s*\n([\s\S]*?)\n```\s*$/);
@@ -7043,14 +7109,14 @@ function pickFont(raw) {
 }
 function persistBrand(brand, inputHash) {
   const tmp = `${BRAND_FILE}.tmp`;
-  fs22.writeFileSync(tmp, JSON.stringify(brand, null, 2), "utf-8");
-  fs22.renameSync(tmp, BRAND_FILE);
+  fs21.writeFileSync(tmp, JSON.stringify(brand, null, 2), "utf-8");
+  fs21.renameSync(tmp, BRAND_FILE);
   const cache = { inputHash, generatedAt: Date.now() };
-  fs22.writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2), "utf-8");
+  fs21.writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2), "utf-8");
 }
 function readCache() {
   try {
-    const raw = fs22.readFileSync(CACHE_FILE, "utf-8");
+    const raw = fs21.readFileSync(CACHE_FILE, "utf-8");
     const parsed = JSON.parse(raw);
     if (parsed && typeof parsed.inputHash === "string" && typeof parsed.generatedAt === "number") {
       return parsed;