@mindstudio-ai/remy 0.1.250 → 0.1.252

package/dist/index.js

@@ -2755,16 +2755,17 @@ function isBinary(buffer) {
   }
   return false;
 }
-var DEFAULT_WINDOW, readFileTool;
+var DEFAULT_WINDOW, MAX_BYTES, readFileTool;
 var init_readFile = __esm({
   "src/tools/code/readFile.ts"() {
     "use strict";
     DEFAULT_WINDOW = 500;
+    MAX_BYTES = 64 * 1024;
     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: {
@@ -2821,12 +2822,35 @@ var init_readFile = __esm({
               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)`;
@@ -4479,11 +4503,34 @@ var init_runner = __esm({
   }
 });
 
+// src/subagents/common/tools.ts
+var COMMON_READ_TOOLS, COMMON_READ_TOOL_NAMES;
+var init_tools = __esm({
+  "src/subagents/common/tools.ts"() {
+    "use strict";
+    init_readFile();
+    init_listDir();
+    init_grep();
+    init_glob();
+    COMMON_READ_TOOLS = [
+      readFileTool.definition,
+      listDirTool.definition,
+      grepTool.definition,
+      globTool.definition
+    ];
+    COMMON_READ_TOOL_NAMES = new Set(
+      COMMON_READ_TOOLS.map((t) => t.name)
+    );
+  }
+});
+
 // src/subagents/browserAutomation/tools.ts
 var BROWSER_TOOLS, BROWSER_EXTERNAL_TOOLS;
-var init_tools = __esm({
+var init_tools2 = __esm({
   "src/subagents/browserAutomation/tools.ts"() {
     "use strict";
+    init_tools();
+    init_readSpec();
     BROWSER_TOOLS = [
       {
         clearable: false,
@@ -4626,24 +4673,199 @@ var init_tools = __esm({
             }
           }
         }
-      }
+      },
+      // 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
     ];
     BROWSER_EXTERNAL_TOOLS = /* @__PURE__ */ new Set(["browserCommand"]);
   }
 });
 
-// src/subagents/browserAutomation/prompt.ts
+// src/subagents/common/context.ts
 import fs15 from "fs";
-function getBrowserAutomationPrompt() {
+import path8 from "path";
+function walkMdFiles(dir, skip) {
+  const files = [];
+  try {
+    for (const entry of fs15.readdirSync(dir, { withFileTypes: true })) {
+      const full = path8.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        if (!skip?.has(entry.name)) {
+          files.push(...walkMdFiles(full, skip));
+        }
+      } else if (entry.name.endsWith(".md")) {
+        files.push(full);
+      }
+    }
+  } catch {
+  }
+  return files.sort();
+}
+function parseFrontmatter(filePath) {
   try {
-    const appSpec = fs15.readFileSync("src/app.md", "utf-8").trim();
-    return `${BASE_PROMPT}
+    const content = fs15.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 = walkMdFiles("src", /* @__PURE__ */ new Set(["roadmap"]));
+  if (files.length === 0) {
+    return "";
+  }
+  const lines = files.map((f) => {
+    const fm = parseFrontmatter(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(
+      fs15.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 = walkMdFiles("src/roadmap");
+  if (files.length > 0) {
+    const lines = files.map((f) => {
+      const fm = parseFrontmatter(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.
 
-<app_context>
-${appSpec}
-</app_context>`;
+- 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>`;
+}
+var init_context = __esm({
+  "src/subagents/common/context.ts"() {
+    "use strict";
+  }
+});
+
+// src/subagents/browserAutomation/prompt.ts
+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;
   }
@@ -4653,6 +4875,7 @@ var init_prompt = __esm({
   "src/subagents/browserAutomation/prompt.ts"() {
     "use strict";
     init_assets();
+    init_context();
     BASE_PROMPT = readAsset("subagents/browserAutomation", "prompt.md");
   }
 });
@@ -4707,6 +4930,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,
@@ -4794,8 +5020,11 @@ var log8, browserAutomationTool;
 var init_browserAutomation = __esm({
   "src/subagents/browserAutomation/index.ts"() {
     "use strict";
+    init_tools8();
     init_runner();
+    init_tools2();
     init_tools();
+    init_readSpec();
     init_prompt();
     init_sidecar();
     init_browserLock();
@@ -4941,27 +5170,6 @@ var init_screenshot2 = __esm({
   }
 });
 
-// src/subagents/common/tools.ts
-var COMMON_READ_TOOLS, COMMON_READ_TOOL_NAMES;
-var init_tools2 = __esm({
-  "src/subagents/common/tools.ts"() {
-    "use strict";
-    init_readFile();
-    init_listDir();
-    init_grep();
-    init_glob();
-    COMMON_READ_TOOLS = [
-      readFileTool.definition,
-      listDirTool.definition,
-      grepTool.definition,
-      globTool.definition
-    ];
-    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, {
@@ -5631,185 +5839,12 @@ var init_editImages = __esm({
   }
 });
 
-// src/subagents/common/context.ts
-import fs16 from "fs";
-import path8 from "path";
-function walkMdFiles(dir, skip) {
-  const files = [];
-  try {
-    for (const entry of fs16.readdirSync(dir, { withFileTypes: true })) {
-      const full = path8.join(dir, entry.name);
-      if (entry.isDirectory()) {
-        if (!skip?.has(entry.name)) {
-          files.push(...walkMdFiles(full, skip));
-        }
-      } else if (entry.name.endsWith(".md")) {
-        files.push(full);
-      }
-    }
-  } catch {
-  }
-  return files.sort();
-}
-function parseFrontmatter(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 = walkMdFiles("src", /* @__PURE__ */ new Set(["roadmap"]));
-  if (files.length === 0) {
-    return "";
-  }
-  const lines = files.map((f) => {
-    const fm = parseFrontmatter(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(
-      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 = walkMdFiles("src/roadmap");
-  if (files.length > 0) {
-    const lines = files.map((f) => {
-      const fm = parseFrontmatter(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>`;
-}
-var init_context = __esm({
-  "src/subagents/common/context.ts"() {
-    "use strict";
-  }
-});
-
 // src/subagents/copyEditor/tools.ts
 var COPY_EDITOR_TOOLS;
 var init_tools3 = __esm({
   "src/subagents/copyEditor/tools.ts"() {
     "use strict";
-    init_tools2();
+    init_tools();
     COPY_EDITOR_TOOLS = [...COMMON_READ_TOOLS];
   }
 });
@@ -5922,7 +5957,7 @@ var init_tools4 = __esm({
   "src/subagents/designExpert/tools/index.ts"() {
     "use strict";
     init_tools8();
-    init_tools2();
+    init_tools();
     init_searchGoogle2();
     init_scrapeWebUrl();
     init_analyzeDesign();
@@ -6012,7 +6047,7 @@ var init_orgContext = __esm({
 });
 
 // src/subagents/designExpert/data/sampleCache.ts
-import fs17 from "fs";
+import fs16 from "fs";
 function generateIndices(poolSize, sampleSize) {
   const n = Math.min(sampleSize, poolSize);
   const indices = Array.from({ length: poolSize }, (_, i) => i);
@@ -6024,14 +6059,14 @@ function generateIndices(poolSize, sampleSize) {
 }
 function load() {
   try {
-    return JSON.parse(fs17.readFileSync(SAMPLE_FILE, "utf-8"));
+    return JSON.parse(fs16.readFileSync(SAMPLE_FILE, "utf-8"));
   } catch {
     return null;
   }
 }
 function save(indices) {
   try {
-    fs17.writeFileSync(SAMPLE_FILE, JSON.stringify(indices));
+    fs16.writeFileSync(SAMPLE_FILE, JSON.stringify(indices));
   } catch {
   }
 }
@@ -6353,7 +6388,7 @@ var init_designExpert = __esm({
     init_tools8();
     init_runner();
     init_tools4();
-    init_tools2();
+    init_tools();
     init_prompt2();
     init_history();
     init_surfaces();
@@ -6411,7 +6446,7 @@ var VISION_TOOLS;
 var init_tools5 = __esm({
   "src/subagents/productVision/tools.ts"() {
     "use strict";
-    init_tools2();
+    init_tools();
     VISION_TOOLS = [
       ...COMMON_READ_TOOLS,
       {
@@ -6465,7 +6500,7 @@ var init_tools5 = __esm({
 });
 
 // src/subagents/productVision/executor.ts
-import fs18 from "fs";
+import fs17 from "fs";
 import path9 from "path";
 function resolve(filePath) {
   return path9.join(ROADMAP_DIR, filePath);
@@ -6475,13 +6510,13 @@ async function executeVisionTool(name, input, context) {
     case "writeFile": {
       const filePath = resolve(input.path);
       try {
-        fs18.mkdirSync(ROADMAP_DIR, { recursive: true });
+        fs17.mkdirSync(ROADMAP_DIR, { recursive: true });
         let oldContent = null;
         try {
-          oldContent = fs18.readFileSync(filePath, "utf-8");
+          oldContent = fs17.readFileSync(filePath, "utf-8");
         } catch {
         }
-        fs18.writeFileSync(filePath, input.content, "utf-8");
+        fs17.writeFileSync(filePath, input.content, "utf-8");
         const lineCount = input.content.split("\n").length;
         const label = oldContent !== null ? "Wrote" : "Created";
         return `${label} ${filePath} (${lineCount} lines)
@@ -6493,11 +6528,11 @@ ${unifiedDiff(filePath, oldContent ?? "", input.content)}`;
     case "deleteFile": {
       const filePath = resolve(input.path);
       try {
-        if (!fs18.existsSync(filePath)) {
+        if (!fs17.existsSync(filePath)) {
           return `Error: ${filePath} does not exist`;
         }
-        const oldContent = fs18.readFileSync(filePath, "utf-8");
-        fs18.unlinkSync(filePath);
+        const oldContent = fs17.readFileSync(filePath, "utf-8");
+        fs17.unlinkSync(filePath);
         return `Deleted ${filePath}
 ${unifiedDiff(filePath, oldContent, "")}`;
       } catch (err) {
@@ -6510,9 +6545,9 @@ ${unifiedDiff(filePath, oldContent, "")}`;
       }
       const filePath = resolve("pitch.html");
       try {
-        fs18.mkdirSync(ROADMAP_DIR, { recursive: true });
-        const exists = fs18.existsSync(filePath);
-        const before = exists ? fs18.statSync(filePath).mtimeMs : null;
+        fs17.mkdirSync(ROADMAP_DIR, { recursive: true });
+        const exists = fs17.existsSync(filePath);
+        const before = exists ? fs17.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.
 
@@ -6542,11 +6577,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 (!fs18.existsSync(filePath)) {
+        if (!fs17.existsSync(filePath)) {
           return `Error: the design expert did not write ${filePath}. Its reply was:
 ${result.text}`;
         }
-        if (before !== null && fs18.statSync(filePath).mtimeMs === before) {
+        if (before !== null && fs17.statSync(filePath).mtimeMs === before) {
           return `Error: the pitch deck at ${filePath} was not modified. The design expert's reply was:
 ${result.text}`;
         }
@@ -6566,7 +6601,6 @@ var init_executor = __esm({
     init_diff();
     init_designExpert();
     init_assets();
-    init_context();
     ROADMAP_DIR = "src/roadmap";
     PITCH_DECK_SHELL = readAsset(
       "subagents/productVision",
@@ -6594,7 +6628,6 @@ var init_prompt3 = __esm({
   "src/subagents/productVision/prompt.ts"() {
     "use strict";
     init_assets();
-    init_executor();
     init_context();
     BASE_PROMPT3 = readAsset("subagents/productVision", "prompt.md");
   }
@@ -6608,7 +6641,7 @@ var init_productVision = __esm({
     init_tools8();
     init_runner();
     init_tools5();
-    init_tools2();
+    init_tools();
     init_executor();
     init_prompt3();
     init_history();
@@ -6682,7 +6715,7 @@ var SANITY_CHECK_TOOLS;
 var init_tools6 = __esm({
   "src/subagents/codeSanityCheck/tools.ts"() {
     "use strict";
-    init_tools2();
+    init_tools();
     SANITY_CHECK_TOOLS = [
       ...COMMON_READ_TOOLS,
       {
@@ -6800,7 +6833,7 @@ var SPEC_SYNC_TOOLS;
 var init_tools7 = __esm({
   "src/subagents/specSync/tools.ts"() {
     "use strict";
-    init_tools2();
+    init_tools();
     init_readSpec();
     init_editSpec();
     init_writeSpec();
@@ -6974,7 +7007,7 @@ var init_scrapeWebUrl2 = __esm({
 });
 
 // src/tools/spec/writeBuildOverview.ts
-import fs19 from "fs";
+import fs18 from "fs";
 function initialDelivery() {
   return `### Your deliverable
 Write the complete Build Overview to \`${OVERVIEW_FILE}\`. The file does not exist yet \u2014 start from this scaffold, which carries the technical hygiene for the iframed render context (keep the viewport meta and the reset). Layout, sections, type, and styling are yours to compose.
@@ -7059,7 +7092,7 @@ The copy in <overview_copy> is final \u2014 it was authored and edited before it
         if (!content) {
           return "Error: writeBuildOverview requires non-empty `content` (the overview copy).";
         }
-        const exists = fs19.existsSync(OVERVIEW_FILE);
+        const exists = fs18.existsSync(OVERVIEW_FILE);
         const task = `<overview_copy>${content}</overview_copy>
 
 ${DESIGN_BRIEF}
@@ -7077,7 +7110,7 @@ ${exists ? refreshDelivery() : initialDelivery()}`;
           }
           const result = await runDesignExpertRender({ task }, context);
           context.subAgentMessages?.set(context.toolCallId, result.messages);
-          if (!fs19.existsSync(OVERVIEW_FILE)) {
+          if (!fs18.existsSync(OVERVIEW_FILE)) {
             return `Error: the design expert did not write ${OVERVIEW_FILE}. Its reply was:
 ${result.text}`;
           }
@@ -7416,7 +7449,7 @@ var init_errors = __esm({
 });
 
 // src/brandExtraction/index.ts
-import fs20 from "fs";
+import fs19 from "fs";
 import path10 from "path";
 import { createHash } from "crypto";
 async function runExtraction(apiConfig, model) {
@@ -7436,13 +7469,16 @@ async function runExtraction(apiConfig, model) {
   log10.info("Brand persisted", { inputHash });
   return brand;
 }
-function isBrandRelevant(filePath) {
-  if (filePath === path10.join("src", "app.md")) {
+function isDedicatedBrandFile(filePath) {
+  if (filePath.split(path10.sep).includes("@brand")) {
     return true;
   }
   const { type } = parseFrontmatter2(filePath);
   return type.startsWith("design/color") || type.startsWith("design/typography");
 }
+function isBrandRelevant(filePath) {
+  return filePath === path10.join("src", "app.md") || isDedicatedBrandFile(filePath);
+}
 function computeInputHash() {
   const entries = [];
   for (const filePath of walkMdFiles2("src")) {
@@ -7450,7 +7486,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 });
   }
@@ -7463,7 +7499,25 @@ function sha256(input) {
 }
 function readSafe(filePath) {
   try {
-    return fs20.readFileSync(filePath, "utf-8");
+    return fs19.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 "";
   }
@@ -7471,7 +7525,7 @@ function readSafe(filePath) {
 function walkMdFiles2(dir) {
   const results = [];
   try {
-    const entries = fs20.readdirSync(dir, { withFileTypes: true });
+    const entries = fs19.readdirSync(dir, { withFileTypes: true });
     for (const entry of entries) {
       const full = path10.join(dir, entry.name);
       if (entry.isDirectory()) {
@@ -7486,7 +7540,7 @@ function walkMdFiles2(dir) {
 }
 function parseFrontmatter2(filePath) {
   try {
-    const content = fs20.readFileSync(filePath, "utf-8");
+    const content = fs19.readFileSync(filePath, "utf-8");
     const match = content.match(/^---\n([\s\S]*?)\n---/);
     if (!match) {
       return { type: "" };
@@ -7556,14 +7610,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";
@@ -7585,6 +7642,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*$/);
@@ -7683,14 +7748,14 @@ function pickFont(raw) {
 }
 function persistBrand(brand, inputHash) {
   const tmp = `${BRAND_FILE}.tmp`;
-  fs20.writeFileSync(tmp, JSON.stringify(brand, null, 2), "utf-8");
-  fs20.renameSync(tmp, BRAND_FILE);
+  fs19.writeFileSync(tmp, JSON.stringify(brand, null, 2), "utf-8");
+  fs19.renameSync(tmp, BRAND_FILE);
   const cache = { inputHash, generatedAt: Date.now() };
-  fs20.writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2), "utf-8");
+  fs19.writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2), "utf-8");
 }
 function readCache() {
   try {
-    const raw = fs20.readFileSync(CACHE_FILE, "utf-8");
+    const raw = fs19.readFileSync(CACHE_FILE, "utf-8");
     const parsed = JSON.parse(raw);
     if (parsed && typeof parsed.inputHash === "string" && typeof parsed.generatedAt === "number") {
       return parsed;
@@ -7700,7 +7765,7 @@ function readCache() {
     return null;
   }
 }
-var log10, EXTRACT_PROMPT, BRAND_FILE, CACHE_FILE, BRAND_CORPUS_CHAR_LIMIT;
+var log10, EXTRACT_PROMPT, BRAND_FILE, CACHE_FILE, HEAD_SLICE_CHARS, BRAND_CORPUS_CHAR_LIMIT;
 var init_brandExtraction = __esm({
   "src/brandExtraction/index.ts"() {
     "use strict";
@@ -7712,6 +7777,7 @@ var init_brandExtraction = __esm({
     EXTRACT_PROMPT = readAsset("brandExtraction", "extract.md");
     BRAND_FILE = ".remy-brand.json";
     CACHE_FILE = ".remy-brand.cache.json";
+    HEAD_SLICE_CHARS = 2e3;
     BRAND_CORPUS_CHAR_LIMIT = 24e5;
   }
 });
@@ -8388,7 +8454,7 @@ var init_agent = __esm({
 });
 
 // src/prompt/static/projectContext.ts
-import fs21 from "fs";
+import fs20 from "fs";
 import path11 from "path";
 function loadProjectRoot() {
   return `
@@ -8399,7 +8465,7 @@ File paths are relative to this directory. Every tool operates here and bash com
 }
 function loadProjectManifest() {
   try {
-    const manifest = fs21.readFileSync("mindstudio.json", "utf-8");
+    const manifest = fs20.readFileSync("mindstudio.json", "utf-8");
     return `
 ## Project Manifest (mindstudio.json)
 \`\`\`json
@@ -8440,7 +8506,7 @@ ${entries.join("\n")}`;
 function walkMdFiles3(dir) {
   const results = [];
   try {
-    const entries = fs21.readdirSync(dir, { withFileTypes: true });
+    const entries = fs20.readdirSync(dir, { withFileTypes: true });
     for (const entry of entries) {
       const full = path11.join(dir, entry.name);
       if (entry.isDirectory()) {
@@ -8455,7 +8521,7 @@ function walkMdFiles3(dir) {
 }
 function parseFrontmatter3(filePath) {
   try {
-    const content = fs21.readFileSync(filePath, "utf-8");
+    const content = fs20.readFileSync(filePath, "utf-8");
     const match = content.match(/^---\n([\s\S]*?)\n---/);
     if (!match) {
       return { name: "", description: "", type: "" };
@@ -8471,7 +8537,7 @@ function parseFrontmatter3(filePath) {
 }
 function loadPlanStatus(onboardingState) {
   try {
-    const content = fs21.readFileSync(".remy-plan.md", "utf-8");
+    const content = fs20.readFileSync(".remy-plan.md", "utf-8");
     const match = content.match(/^---\n([\s\S]*?)\n---/);
     const status = match?.[1]?.match(/^status:\s*(.+)$/m)?.[1]?.trim();
     if (status === "pending" && onboardingState === "intake") {
@@ -8499,7 +8565,7 @@ The user has approved your implementation plan in .remy-plan.md. You may referen
 }
 function loadProjectFileListing() {
   try {
-    const entries = fs21.readdirSync(".", { withFileTypes: true });
+    const entries = fs20.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;
@@ -8591,6 +8657,10 @@ Current date: ${now}
   {{compiled/media-cdn.md}}
   </media_cdn>
 
+  <app_files>
+  {{compiled/files.md}}
+  </app_files>
+
   <interfaces>
   {{compiled/interfaces.md}}
   </interfaces>
@@ -8682,12 +8752,12 @@ var init_prompt4 = __esm({
 });
 
 // src/config.ts
-import fs22 from "fs";
+import fs21 from "fs";
 import path12 from "path";
 import os from "os";
 function loadConfigFile() {
   try {
-    const raw = fs22.readFileSync(CONFIG_PATH, "utf-8");
+    const raw = fs21.readFileSync(CONFIG_PATH, "utf-8");
     log13.debug("Loaded config file", { path: CONFIG_PATH });
     return JSON.parse(raw);
   } catch (err) {
@@ -10008,7 +10078,7 @@ var init_headless = __esm({
 // src/index.tsx
 import { render } from "ink";
 import os2 from "os";
-import fs23 from "fs";
+import fs22 from "fs";
 import path13 from "path";
 
 // src/tui/App.tsx
@@ -10330,7 +10400,7 @@ for (let i = 0; i < args.length; i++) {
 var startupLog = createLogger("startup");
 function printDebugInfo(config) {
   const pkg = JSON.parse(
-    fs23.readFileSync(
+    fs22.readFileSync(
       path13.join(import.meta.dirname, "..", "package.json"),
       "utf-8"
     )