@mindstudio-ai/remy 0.1.158 → 0.1.159

package/dist/automatedActions/buildFromInitialSpec.md

@@ -6,9 +6,9 @@
 This is the code generation phase. The spec is written. Build everything now in three phases: planning, coding, and verifying. Execute each phase in order in a single turn.
 
 ## Planning
-Think about your approach and then get a quick sanity check from `codeSanityCheck` to make sure you aren't missing anything. 
+Get a quick architecture sanity check from `codeSanityCheck` to make sure your approach holds up.
 
-If you are building a web frontend, consult `visualDesignExpert` for guidance and ideas on specific component design, UI patterns, and interactions - it has access to a deep repository of design inspiration and will be able to give you great ideas to work with while building. Don't ask it to design full screens - focus on specific components, moments, and concepts where its ideas can be additive and transformative, you already have the basic design and layout guidance from the spec.
+Then bring in `visualDesignExpert` before writing any frontend code. Walk it through the screens and the key interactions — the moments where the user does something or sees something land — and ask for direction on the specifics that make a real product feel alive: motion, micro-interactions, hover and focus states, empty and loading states, the components and moments that need extra texture. The spec defines the brand and the rough layout. The designer fills in the texture between them, and that texture is what separates an app that lands from one that feels generic. This pass is the highest-leverage thing you do before writing code.
 
 Use your remy-notes.md file to make a checklist of the work that needs to be done. Don't store implementation details in it - it is soley for keeping track of tasks.
 

package/dist/brandExtraction/extract.md

@@ -0,0 +1,51 @@
+You extract a structured `AppBrand` JSON object from the spec files of a MindStudio app project.
+
+Your output is read by a frontend renderer that uses the brand to style internal documents (implementation plans, sync plans, publish plans) with a "letterhead" treatment — a wordmark, accent color, paper-tone background, and branded fonts. Every field is optional. The renderer falls back to generic styling when a field is missing or invalid.
+
+## Output format
+
+Reply with **exactly one** fenced ```json block. No prose before or after.
+
+The object must match this shape:
+
+```ts
+type AppBrand = {
+  version: 1;
+  name?: string;
+  tagline?: string;
+  logoUrl?: string;
+  colors?: {
+    background?: string;
+    text?: string;
+    heading?: string;
+    accent?: string;
+    muted?: string;
+  };
+  typography?: {
+    body?: { family: string; stylesheet?: string; fileUrl?: string };
+    heading?: { family: string; stylesheet?: string; fileUrl?: string };
+  };
+};
+```
+
+Hex (`#RRGGBB`, `#RGB`) is preferred for colors; any valid CSS color string is acceptable.
+
+## Rules
+
+- **Omit any field you can't extract confidently.** Partial output is correct. Do not invent.
+- **`version` is always `1`.**
+- **`name`**: the wordmark text — the app's display name as it would appear at the top of a document. Pull from the manifest, the main spec, or wherever the app's name is stated. Do NOT guess from the file paths.
+- **`tagline`**: a short subtitle if the spec has one. One sentence or a short phrase. Omit if there isn't one — do not invent a tagline from the description.
+- **`logoUrl`**: the app's logo image URL if the spec has one. Omit if there isn't one.
+- **`colors.background`** is **paper**, not brand. It tints the page behind body text. If the brand only defines saturated/vivid colors and no calm surface tone, **omit this field** so the renderer falls back to neutral. A 3-5% saturation tint of a brand color is acceptable; a fully saturated brand color is not.
+- **`colors.text`** is body text — usually near-black or near-white depending on background. **`colors.heading`** is often the same as text. **`colors.accent`** is for links and small flair. **`colors.muted`** is for captions and secondary text — omit if the spec doesn't define it; the renderer derives it from `text` automatically.
+- **`typography.body`**: applied to paragraphs, lists, tables. **Body type must stay readable.** If the brand font is decorative, display-only, or script (e.g., a hand-lettered logo font), **omit `body`** and only set `heading`.
+- **`typography.heading`**: applied to h1-h6 only. Decorative fonts are fine here.
+- **Do NOT include a `mono` field.** Code blocks stay generic mono for legibility.
+- For `BrandFont.stylesheet` and `BrandFont.fileUrl`: only emit a URL that **appears verbatim in the spec content** you were given. Do not fabricate Google Fonts URLs from a family name. If neither URL is present in the spec, omit both — the renderer assumes the family is a system font or already loaded.
+
+If the project has no spec files yet, or the spec contains no brand information, output:
+
+```json
+{ "version": 1 }
+```

package/dist/headless.js

@@ -2695,11 +2695,11 @@ async function captureAndAnalyzeScreenshot(promptOrOptions) {
   let prompt;
   let existingUrl;
   let onLog;
-  let path10;
+  let path11;
   if (typeof promptOrOptions === "object" && promptOrOptions !== null) {
     prompt = promptOrOptions.prompt;
     existingUrl = promptOrOptions.imageUrl;
-    path10 = promptOrOptions.path;
+    path11 = promptOrOptions.path;
     onLog = promptOrOptions.onLog;
   } else {
     prompt = promptOrOptions;
@@ -2711,7 +2711,7 @@ async function captureAndAnalyzeScreenshot(promptOrOptions) {
   } else {
     const ssResult = await sidecarRequest(
       "/screenshot-full-page",
-      path10 ? { path: path10 } : void 0,
+      path11 ? { path: path11 } : void 0,
       { timeout: 12e4 }
     );
     url = ssResult?.url || ssResult?.screenshotUrl;
@@ -2748,15 +2748,15 @@ function acquireBrowserLock() {
 // src/statusWatcher.ts
 function startStatusWatcher(config) {
   const { apiConfig, getContext, onStatus, interval = 5e3, signal } = config;
-  let inflight = false;
+  let inflight2 = false;
   let stopped = false;
   let pauseCount = 0;
   const url = `${apiConfig.baseUrl}/_internal/v2/agent/remy/generate-status`;
   async function tick() {
-    if (stopped || signal?.aborted || inflight || pauseCount > 0) {
+    if (stopped || signal?.aborted || inflight2 || pauseCount > 0) {
       return;
     }
-    inflight = true;
+    inflight2 = true;
     try {
       const context = getContext();
       if (!context) {
@@ -2784,7 +2784,7 @@ function startStatusWatcher(config) {
       onStatus(data.label);
     } catch {
     } finally {
-      inflight = false;
+      inflight2 = false;
     }
   }
   const timer = setInterval(tick, interval);
@@ -4497,15 +4497,15 @@ function getSampleIndices(pools, sizes) {
   }
   const loaded = load();
   if (loaded) {
-    let dirty = false;
+    let dirty2 = false;
     for (const key of ["uiInspiration", "designReferences", "fonts"]) {
       const before = loaded[key].length;
       loaded[key] = loaded[key].filter((i) => i < pools[key]);
       if (loaded[key].length < before) {
-        dirty = true;
+        dirty2 = true;
       }
     }
-    if (dirty) {
+    if (dirty2) {
       save(loaded);
     }
     cached = loaded;
@@ -5199,17 +5199,292 @@ function triggerCompaction(state, apiConfig, callbacks) {
   });
 }
 
-// src/session.ts
+// src/brandExtraction/index.ts
 import fs19 from "fs";
-var log8 = createLogger("session");
+import path10 from "path";
+import { createHash } from "crypto";
+var log8 = createLogger("brandExtraction");
+var EXTRACT_PROMPT = readAsset("brandExtraction", "extract.md");
+var BRAND_FILE = ".remy-brand.json";
+var CACHE_FILE = ".remy-brand.cache.json";
+async function runExtraction(apiConfig) {
+  const inputHash = computeInputHash();
+  const cached2 = readCache();
+  if (cached2 && cached2.inputHash === inputHash) {
+    log8.debug("Brand inputs unchanged \u2014 skipping extraction", { inputHash });
+    return null;
+  }
+  log8.info("Extracting brand", { inputHash });
+  const brand = await extractBrand(apiConfig);
+  if (!brand) {
+    log8.warn("Brand extraction failed \u2014 leaving cache untouched");
+    return null;
+  }
+  persistBrand(brand, inputHash);
+  log8.info("Brand persisted", { inputHash });
+  return brand;
+}
+function computeInputHash() {
+  const entries = [];
+  for (const filePath of walkMdFiles3("src")) {
+    if (filePath === path10.join("src", "app.md")) {
+      entries.push({ path: filePath, content: readSafe(filePath) });
+      continue;
+    }
+    const fm = parseFrontmatter3(filePath);
+    if (fm.type.startsWith("design/color") || fm.type.startsWith("design/typography")) {
+      entries.push({ path: filePath, content: readSafe(filePath) });
+    }
+  }
+  const manifest = readSafe("mindstudio.json");
+  if (manifest) {
+    entries.push({ path: "mindstudio.json", content: manifest });
+  }
+  entries.sort((a, b) => a.path.localeCompare(b.path));
+  const fingerprint = entries.map((e) => `${e.path}:${sha256(e.content)}`).join("\n");
+  return sha256(fingerprint);
+}
+function sha256(input) {
+  return createHash("sha256").update(input).digest("hex");
+}
+function readSafe(filePath) {
+  try {
+    return fs19.readFileSync(filePath, "utf-8");
+  } catch {
+    return "";
+  }
+}
+function walkMdFiles3(dir) {
+  const results = [];
+  try {
+    const entries = fs19.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const full = path10.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        results.push(...walkMdFiles3(full));
+      } else if (entry.name.endsWith(".md")) {
+        results.push(full);
+      }
+    }
+  } catch {
+  }
+  return results.sort();
+}
+function parseFrontmatter3(filePath) {
+  try {
+    const content = fs19.readFileSync(filePath, "utf-8");
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match) {
+      return { type: "" };
+    }
+    const fm = match[1];
+    const type = fm.match(/^type:\s*(.+)$/m)?.[1]?.trim() ?? "";
+    return { type };
+  } catch {
+    return { type: "" };
+  }
+}
+async function extractBrand(apiConfig) {
+  const corpus = buildCorpus();
+  if (!corpus.trim()) {
+    log8.debug("No spec corpus \u2014 emitting empty brand");
+    return { version: 1 };
+  }
+  let responseText = "";
+  try {
+    for await (const event of streamChat({
+      ...apiConfig,
+      subAgentId: "brandExtractor",
+      system: EXTRACT_PROMPT,
+      messages: [{ role: "user", content: corpus }],
+      tools: []
+    })) {
+      if (event.type === "text") {
+        responseText += event.text;
+      } else if (event.type === "error") {
+        log8.error("Brand extraction stream error", { error: event.error });
+        return null;
+      }
+    }
+  } catch (err) {
+    log8.error("Brand extraction threw", { error: err?.message });
+    return null;
+  }
+  const parsed = parseJsonResponse(responseText);
+  if (!parsed) {
+    log8.warn("Brand extraction returned unparseable JSON", {
+      preview: responseText.slice(0, 200)
+    });
+    return null;
+  }
+  return validateBrand(parsed);
+}
+function buildCorpus() {
+  const sections = [];
+  const manifest = readSafe("mindstudio.json");
+  if (manifest) {
+    sections.push(`## File: mindstudio.json
+
+${manifest}`);
+  }
+  for (const filePath of walkMdFiles3("src")) {
+    const content = readSafe(filePath);
+    if (content) {
+      sections.push(`## File: ${filePath}
+
+${content}`);
+    }
+  }
+  return sections.join("\n\n---\n\n");
+}
+function parseJsonResponse(text) {
+  const trimmed = text.trim();
+  const fenceMatch = trimmed.match(/^```(?:json)?\s*\n([\s\S]*?)\n```\s*$/);
+  const candidate = fenceMatch ? fenceMatch[1] : trimmed;
+  try {
+    return JSON.parse(candidate);
+  } catch {
+    const braceMatch = candidate.match(/\{[\s\S]*\}/);
+    if (braceMatch) {
+      try {
+        return JSON.parse(braceMatch[0]);
+      } catch {
+        return null;
+      }
+    }
+    return null;
+  }
+}
+function validateBrand(raw) {
+  if (!raw || typeof raw !== "object") {
+    return null;
+  }
+  const obj = raw;
+  const out = { version: 1 };
+  if (typeof obj.name === "string" && obj.name.trim()) {
+    out.name = obj.name.trim();
+  }
+  if (typeof obj.tagline === "string" && obj.tagline.trim()) {
+    out.tagline = obj.tagline.trim();
+  }
+  if (typeof obj.logoUrl === "string" && obj.logoUrl.trim()) {
+    out.logoUrl = obj.logoUrl.trim();
+  }
+  const colors = pickColors(obj.colors);
+  if (colors) {
+    out.colors = colors;
+  }
+  const typography = pickTypography(obj.typography);
+  if (typography) {
+    out.typography = typography;
+  }
+  return out;
+}
+function pickColors(raw) {
+  if (!raw || typeof raw !== "object") {
+    return void 0;
+  }
+  const c = raw;
+  const out = {};
+  for (const key of [
+    "background",
+    "text",
+    "heading",
+    "accent",
+    "muted"
+  ]) {
+    const v = c[key];
+    if (typeof v === "string" && v.trim()) {
+      out[key] = v.trim();
+    }
+  }
+  return Object.keys(out).length > 0 ? out : void 0;
+}
+function pickTypography(raw) {
+  if (!raw || typeof raw !== "object") {
+    return void 0;
+  }
+  const t = raw;
+  const out = {};
+  const body = pickFont(t.body);
+  if (body) {
+    out.body = body;
+  }
+  const heading = pickFont(t.heading);
+  if (heading) {
+    out.heading = heading;
+  }
+  return Object.keys(out).length > 0 ? out : void 0;
+}
+function pickFont(raw) {
+  if (!raw || typeof raw !== "object") {
+    return void 0;
+  }
+  const f = raw;
+  if (typeof f.family !== "string" || !f.family.trim()) {
+    return void 0;
+  }
+  const out = { family: f.family.trim() };
+  if (typeof f.stylesheet === "string" && f.stylesheet.trim()) {
+    out.stylesheet = f.stylesheet.trim();
+  }
+  if (typeof f.fileUrl === "string" && f.fileUrl.trim()) {
+    out.fileUrl = f.fileUrl.trim();
+  }
+  return out;
+}
+function persistBrand(brand, inputHash) {
+  const tmp = `${BRAND_FILE}.tmp`;
+  fs19.writeFileSync(tmp, JSON.stringify(brand, null, 2), "utf-8");
+  fs19.renameSync(tmp, BRAND_FILE);
+  const cache = { inputHash, generatedAt: Date.now() };
+  fs19.writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2), "utf-8");
+}
+function readCache() {
+  try {
+    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;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+// src/brandExtraction/trigger.ts
+var log9 = createLogger("brandExtraction:trigger");
+var inflight = false;
+var dirty = false;
+function triggerBrandExtraction(apiConfig) {
+  if (inflight) {
+    dirty = true;
+    return;
+  }
+  inflight = true;
+  void runExtraction(apiConfig).catch((err) => {
+    log9.error("Brand extraction failed", { error: err?.message });
+  }).finally(() => {
+    inflight = false;
+    if (dirty) {
+      dirty = false;
+      triggerBrandExtraction(apiConfig);
+    }
+  });
+}
+
+// src/session.ts
+import fs20 from "fs";
+var log10 = createLogger("session");
 var SESSION_FILE = ".remy-session.json";
 function loadSession(state) {
   try {
-    const raw = fs19.readFileSync(SESSION_FILE, "utf-8");
+    const raw = fs20.readFileSync(SESSION_FILE, "utf-8");
     const data = JSON.parse(raw);
     if (Array.isArray(data.messages) && data.messages.length > 0) {
       state.messages = sanitizeMessages(data.messages);
-      log8.info("Session loaded", { messageCount: state.messages.length });
+      log10.info("Session loaded", { messageCount: state.messages.length });
       return true;
     }
   } catch {
@@ -5254,20 +5529,20 @@ function sanitizeMessages(messages) {
 }
 function saveSession(state) {
   try {
-    fs19.writeFileSync(
+    fs20.writeFileSync(
       SESSION_FILE,
       JSON.stringify({ messages: state.messages }, null, 2),
       "utf-8"
     );
-    log8.info("Session saved", { messageCount: state.messages.length });
+    log10.info("Session saved", { messageCount: state.messages.length });
   } catch (err) {
-    log8.warn("Session save failed", { error: err.message });
+    log10.warn("Session save failed", { error: err.message });
   }
 }
 function clearSession(state) {
   state.messages = [];
   try {
-    fs19.unlinkSync(SESSION_FILE);
+    fs20.unlinkSync(SESSION_FILE);
   } catch {
   }
 }
@@ -5462,7 +5737,8 @@ function friendlyError(raw) {
 }
 
 // src/agent.ts
-var log9 = createLogger("agent");
+var log11 = createLogger("agent");
+var BRAND_TRIGGERING_TOOLS = /* @__PURE__ */ new Set(["writeSpec", "editSpec"]);
 function getTextContent(blocks) {
   return blocks.filter((b) => b.type === "text").map((b) => b.text).join("");
 }
@@ -5509,7 +5785,7 @@ async function runTurn(params) {
   } = params;
   const tools2 = getToolDefinitions(onboardingState);
   const excludeToolsFromClearing = tools2.filter((t) => !CLEARABLE_TOOLS.has(t.name)).map((t) => t.name);
-  log9.info("Turn started", {
+  log11.info("Turn started", {
     requestId,
     model,
     toolCount: tools2.length,
@@ -5738,7 +6014,7 @@ async function runTurn(params) {
             const tool = getToolByName(event.name);
             const wasStreamed = acc?.started ?? false;
             const isInputStreaming = !!tool?.streaming?.partialInput;
-            log9.info("Tool received", {
+            log11.info("Tool received", {
               requestId,
               toolCallId: event.id,
               name: event.name
@@ -5831,7 +6107,7 @@ async function runTurn(params) {
       });
       return;
     }
-    log9.info("Tools executing", {
+    log11.info("Tools executing", {
       requestId,
       count: toolCalls.length,
       tools: toolCalls.map((tc) => tc.name)
@@ -5878,7 +6154,7 @@ async function runTurn(params) {
             let result;
             if (EXTERNAL_TOOLS.has(tc.name) && resolveExternalTool) {
               saveSession(state);
-              log9.info("Waiting for external tool result", {
+              log11.info("Waiting for external tool result", {
                 requestId,
                 toolCallId: tc.id,
                 name: tc.name
@@ -5945,7 +6221,7 @@ async function runTurn(params) {
         if (!tc.input.background) {
           toolRegistry?.unregister(tc.id);
         }
-        log9.info("Tool completed", {
+        log11.info("Tool completed", {
           requestId,
           toolCallId: tc.id,
           name: tc.name,
@@ -5959,6 +6235,9 @@ async function runTurn(params) {
           result: r.result,
           isError: r.isError
         });
+        if (!r.isError && BRAND_TRIGGERING_TOOLS.has(tc.name)) {
+          triggerBrandExtraction(apiConfig);
+        }
         return r;
       })
     );
@@ -6000,7 +6279,7 @@ async function runTurn(params) {
 }
 
 // src/toolRegistry.ts
-var log10 = createLogger("tool-registry");
+var log12 = createLogger("tool-registry");
 var ToolRegistry = class {
   entries = /* @__PURE__ */ new Map();
   onEvent;
@@ -6026,7 +6305,7 @@ var ToolRegistry = class {
     if (!entry) {
       return false;
     }
-    log10.info("Tool stopped", { toolCallId: id, name: entry.name, mode });
+    log12.info("Tool stopped", { toolCallId: id, name: entry.name, mode });
     entry.abortController.abort(mode);
     if (mode === "graceful") {
       const partial = entry.getPartialResult?.() ?? "";
@@ -6059,7 +6338,7 @@ ${partial}` : "[INTERRUPTED] Tool execution was stopped.";
     if (!entry) {
       return false;
     }
-    log10.info("Tool restarted", { toolCallId: id, name: entry.name });
+    log12.info("Tool restarted", { toolCallId: id, name: entry.name });
     entry.abortController.abort("restart");
     const newInput = patchedInput ? { ...entry.input, ...patchedInput } : entry.input;
     this.onEvent?.({
@@ -6078,7 +6357,7 @@ ${partial}` : "[INTERRUPTED] Tool execution was stopped.";
 import { mkdirSync, existsSync } from "fs";
 import { writeFile } from "fs/promises";
 import { basename, join, extname } from "path";
-var log11 = createLogger("headless:attachments");
+var log13 = createLogger("headless:attachments");
 var UPLOADS_DIR = "src/.user-uploads";
 function filenameFromUrl(url) {
   try {
@@ -6126,7 +6405,7 @@ async function persistAttachments(attachments) {
       }
       const buffer = Buffer.from(await res.arrayBuffer());
       await writeFile(localPath, buffer);
-      log11.info("Attachment saved", {
+      log13.info("Attachment saved", {
         filename: name,
         path: localPath,
         bytes: buffer.length
@@ -6140,7 +6419,7 @@ async function persistAttachments(attachments) {
           if (textRes.ok) {
             extractedTextPath = `${localPath}.txt`;
             await writeFile(extractedTextPath, await textRes.text(), "utf-8");
-            log11.info("Extracted text saved", { path: extractedTextPath });
+            log13.info("Extracted text saved", { path: extractedTextPath });
           }
         } catch {
         }
@@ -6327,7 +6606,7 @@ function resolveAction(text) {
 }
 
 // src/headless/index.ts
-var log12 = createLogger("headless");
+var log14 = createLogger("headless");
 var EXTERNAL_TOOL_TIMEOUT_MS = 3e5;
 var USER_FACING_TOOLS = /* @__PURE__ */ new Set([
   "promptUser",
@@ -6399,6 +6678,7 @@ var HeadlessSession = class {
         ...this.queueFields()
       });
     }
+    triggerBrandExtraction(this.config);
     this.toolRegistry.onEvent = this.onEvent;
     this.readline = createInterface({ input: process.stdin });
     this.readline.on("line", this.handleStdinLine);
@@ -6498,7 +6778,7 @@ var HeadlessSession = class {
   }
   onBackgroundComplete = (toolCallId, name, result, subAgentMessages) => {
     this.pendingBlockUpdates.push({ toolCallId, result, subAgentMessages });
-    log12.info("Background complete", {
+    log14.info("Background complete", {
       toolCallId,
       name,
       requestId: this.currentRequestId
@@ -6719,7 +6999,7 @@ var HeadlessSession = class {
     this.turnStart = Date.now();
     const attachments = parsed.attachments;
     if (attachments?.length) {
-      log12.info("Message has attachments", {
+      log14.info("Message has attachments", {
         count: attachments.length,
         urls: attachments.map((a) => a.url)
       });
@@ -6736,7 +7016,7 @@ var HeadlessSession = class {
 ${userMessage}` : header;
         }
       } catch (err) {
-        log12.warn("Attachment persistence failed", { error: err.message });
+        log14.warn("Attachment persistence failed", { error: err.message });
       }
     }
     let resolved = null;
@@ -6794,7 +7074,7 @@ ${userMessage}` : header;
           error: "Turn ended unexpectedly"
         });
       }
-      log12.info("Turn complete", {
+      log14.info("Turn complete", {
         requestId,
         durationMs: Date.now() - this.turnStart
       });
@@ -6806,7 +7086,7 @@ ${userMessage}` : header;
           error: err.message
         });
       }
-      log12.warn("Command failed", {
+      log14.warn("Command failed", {
         action: "message",
         requestId,
         error: err.message
@@ -6941,7 +7221,7 @@ ${userMessage}` : header;
       return;
     }
     const { action, requestId } = parsed;
-    log12.info("Command received", { action, requestId });
+    log14.info("Command received", { action, requestId });
     if (action === "tool_result" && parsed.id) {
       const id = parsed.id;
       const result = parsed.result ?? "";
@@ -6950,7 +7230,7 @@ ${userMessage}` : header;
         this.pendingTools.delete(id);
         pending.resolve(result);
       } else if (!this.running) {
-        log12.info("Late tool_result while idle, dismissing", { id });
+        log14.info("Late tool_result while idle, dismissing", { id });
         this.emit("completed", { success: true }, requestId);
       } else {
         this.earlyResults.set(id, result);

package/dist/index.js

@@ -2962,11 +2962,11 @@ async function captureAndAnalyzeScreenshot(promptOrOptions) {
   let prompt;
   let existingUrl;
   let onLog;
-  let path11;
+  let path12;
   if (typeof promptOrOptions === "object" && promptOrOptions !== null) {
     prompt = promptOrOptions.prompt;
     existingUrl = promptOrOptions.imageUrl;
-    path11 = promptOrOptions.path;
+    path12 = promptOrOptions.path;
     onLog = promptOrOptions.onLog;
   } else {
     prompt = promptOrOptions;
@@ -2978,7 +2978,7 @@ async function captureAndAnalyzeScreenshot(promptOrOptions) {
   } else {
     const ssResult = await sidecarRequest(
       "/screenshot-full-page",
-      path11 ? { path: path11 } : void 0,
+      path12 ? { path: path12 } : void 0,
       { timeout: 12e4 }
     );
     url = ssResult?.url || ssResult?.screenshotUrl;
@@ -3033,15 +3033,15 @@ var init_browserLock = __esm({
 // src/statusWatcher.ts
 function startStatusWatcher(config) {
   const { apiConfig, getContext, onStatus, interval = 5e3, signal } = config;
-  let inflight = false;
+  let inflight2 = false;
   let stopped = false;
   let pauseCount = 0;
   const url = `${apiConfig.baseUrl}/_internal/v2/agent/remy/generate-status`;
   async function tick() {
-    if (stopped || signal?.aborted || inflight || pauseCount > 0) {
+    if (stopped || signal?.aborted || inflight2 || pauseCount > 0) {
       return;
     }
-    inflight = true;
+    inflight2 = true;
     try {
       const context = getContext();
       if (!context) {
@@ -3069,7 +3069,7 @@ function startStatusWatcher(config) {
       onStatus(data.label);
     } catch {
     } finally {
-      inflight = false;
+      inflight2 = false;
     }
   }
   const timer = setInterval(tick, interval);
@@ -4936,15 +4936,15 @@ function getSampleIndices(pools, sizes) {
   }
   const loaded = load();
   if (loaded) {
-    let dirty = false;
+    let dirty2 = false;
     for (const key of ["uiInspiration", "designReferences", "fonts"]) {
       const before = loaded[key].length;
       loaded[key] = loaded[key].filter((i) => i < pools[key]);
       if (loaded[key].length < before) {
-        dirty = true;
+        dirty2 = true;
       }
     }
-    if (dirty) {
+    if (dirty2) {
       save(loaded);
     }
     cached = loaded;
@@ -6061,6 +6061,298 @@ var init_errors = __esm({
   }
 });
 
+// src/brandExtraction/index.ts
+import fs19 from "fs";
+import path9 from "path";
+import { createHash } from "crypto";
+async function runExtraction(apiConfig) {
+  const inputHash = computeInputHash();
+  const cached2 = readCache();
+  if (cached2 && cached2.inputHash === inputHash) {
+    log8.debug("Brand inputs unchanged \u2014 skipping extraction", { inputHash });
+    return null;
+  }
+  log8.info("Extracting brand", { inputHash });
+  const brand = await extractBrand(apiConfig);
+  if (!brand) {
+    log8.warn("Brand extraction failed \u2014 leaving cache untouched");
+    return null;
+  }
+  persistBrand(brand, inputHash);
+  log8.info("Brand persisted", { inputHash });
+  return brand;
+}
+function computeInputHash() {
+  const entries = [];
+  for (const filePath of walkMdFiles3("src")) {
+    if (filePath === path9.join("src", "app.md")) {
+      entries.push({ path: filePath, content: readSafe(filePath) });
+      continue;
+    }
+    const fm = parseFrontmatter3(filePath);
+    if (fm.type.startsWith("design/color") || fm.type.startsWith("design/typography")) {
+      entries.push({ path: filePath, content: readSafe(filePath) });
+    }
+  }
+  const manifest = readSafe("mindstudio.json");
+  if (manifest) {
+    entries.push({ path: "mindstudio.json", content: manifest });
+  }
+  entries.sort((a, b) => a.path.localeCompare(b.path));
+  const fingerprint = entries.map((e) => `${e.path}:${sha256(e.content)}`).join("\n");
+  return sha256(fingerprint);
+}
+function sha256(input) {
+  return createHash("sha256").update(input).digest("hex");
+}
+function readSafe(filePath) {
+  try {
+    return fs19.readFileSync(filePath, "utf-8");
+  } catch {
+    return "";
+  }
+}
+function walkMdFiles3(dir) {
+  const results = [];
+  try {
+    const entries = fs19.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const full = path9.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        results.push(...walkMdFiles3(full));
+      } else if (entry.name.endsWith(".md")) {
+        results.push(full);
+      }
+    }
+  } catch {
+  }
+  return results.sort();
+}
+function parseFrontmatter3(filePath) {
+  try {
+    const content = fs19.readFileSync(filePath, "utf-8");
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match) {
+      return { type: "" };
+    }
+    const fm = match[1];
+    const type = fm.match(/^type:\s*(.+)$/m)?.[1]?.trim() ?? "";
+    return { type };
+  } catch {
+    return { type: "" };
+  }
+}
+async function extractBrand(apiConfig) {
+  const corpus = buildCorpus();
+  if (!corpus.trim()) {
+    log8.debug("No spec corpus \u2014 emitting empty brand");
+    return { version: 1 };
+  }
+  let responseText = "";
+  try {
+    for await (const event of streamChat({
+      ...apiConfig,
+      subAgentId: "brandExtractor",
+      system: EXTRACT_PROMPT,
+      messages: [{ role: "user", content: corpus }],
+      tools: []
+    })) {
+      if (event.type === "text") {
+        responseText += event.text;
+      } else if (event.type === "error") {
+        log8.error("Brand extraction stream error", { error: event.error });
+        return null;
+      }
+    }
+  } catch (err) {
+    log8.error("Brand extraction threw", { error: err?.message });
+    return null;
+  }
+  const parsed = parseJsonResponse(responseText);
+  if (!parsed) {
+    log8.warn("Brand extraction returned unparseable JSON", {
+      preview: responseText.slice(0, 200)
+    });
+    return null;
+  }
+  return validateBrand(parsed);
+}
+function buildCorpus() {
+  const sections = [];
+  const manifest = readSafe("mindstudio.json");
+  if (manifest) {
+    sections.push(`## File: mindstudio.json
+
+${manifest}`);
+  }
+  for (const filePath of walkMdFiles3("src")) {
+    const content = readSafe(filePath);
+    if (content) {
+      sections.push(`## File: ${filePath}
+
+${content}`);
+    }
+  }
+  return sections.join("\n\n---\n\n");
+}
+function parseJsonResponse(text) {
+  const trimmed = text.trim();
+  const fenceMatch = trimmed.match(/^```(?:json)?\s*\n([\s\S]*?)\n```\s*$/);
+  const candidate = fenceMatch ? fenceMatch[1] : trimmed;
+  try {
+    return JSON.parse(candidate);
+  } catch {
+    const braceMatch = candidate.match(/\{[\s\S]*\}/);
+    if (braceMatch) {
+      try {
+        return JSON.parse(braceMatch[0]);
+      } catch {
+        return null;
+      }
+    }
+    return null;
+  }
+}
+function validateBrand(raw) {
+  if (!raw || typeof raw !== "object") {
+    return null;
+  }
+  const obj = raw;
+  const out = { version: 1 };
+  if (typeof obj.name === "string" && obj.name.trim()) {
+    out.name = obj.name.trim();
+  }
+  if (typeof obj.tagline === "string" && obj.tagline.trim()) {
+    out.tagline = obj.tagline.trim();
+  }
+  if (typeof obj.logoUrl === "string" && obj.logoUrl.trim()) {
+    out.logoUrl = obj.logoUrl.trim();
+  }
+  const colors = pickColors(obj.colors);
+  if (colors) {
+    out.colors = colors;
+  }
+  const typography = pickTypography(obj.typography);
+  if (typography) {
+    out.typography = typography;
+  }
+  return out;
+}
+function pickColors(raw) {
+  if (!raw || typeof raw !== "object") {
+    return void 0;
+  }
+  const c = raw;
+  const out = {};
+  for (const key of [
+    "background",
+    "text",
+    "heading",
+    "accent",
+    "muted"
+  ]) {
+    const v = c[key];
+    if (typeof v === "string" && v.trim()) {
+      out[key] = v.trim();
+    }
+  }
+  return Object.keys(out).length > 0 ? out : void 0;
+}
+function pickTypography(raw) {
+  if (!raw || typeof raw !== "object") {
+    return void 0;
+  }
+  const t = raw;
+  const out = {};
+  const body = pickFont(t.body);
+  if (body) {
+    out.body = body;
+  }
+  const heading = pickFont(t.heading);
+  if (heading) {
+    out.heading = heading;
+  }
+  return Object.keys(out).length > 0 ? out : void 0;
+}
+function pickFont(raw) {
+  if (!raw || typeof raw !== "object") {
+    return void 0;
+  }
+  const f = raw;
+  if (typeof f.family !== "string" || !f.family.trim()) {
+    return void 0;
+  }
+  const out = { family: f.family.trim() };
+  if (typeof f.stylesheet === "string" && f.stylesheet.trim()) {
+    out.stylesheet = f.stylesheet.trim();
+  }
+  if (typeof f.fileUrl === "string" && f.fileUrl.trim()) {
+    out.fileUrl = f.fileUrl.trim();
+  }
+  return out;
+}
+function persistBrand(brand, inputHash) {
+  const tmp = `${BRAND_FILE}.tmp`;
+  fs19.writeFileSync(tmp, JSON.stringify(brand, null, 2), "utf-8");
+  fs19.renameSync(tmp, BRAND_FILE);
+  const cache = { inputHash, generatedAt: Date.now() };
+  fs19.writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2), "utf-8");
+}
+function readCache() {
+  try {
+    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;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+var log8, EXTRACT_PROMPT, BRAND_FILE, CACHE_FILE;
+var init_brandExtraction = __esm({
+  "src/brandExtraction/index.ts"() {
+    "use strict";
+    init_api();
+    init_assets();
+    init_logger();
+    log8 = createLogger("brandExtraction");
+    EXTRACT_PROMPT = readAsset("brandExtraction", "extract.md");
+    BRAND_FILE = ".remy-brand.json";
+    CACHE_FILE = ".remy-brand.cache.json";
+  }
+});
+
+// src/brandExtraction/trigger.ts
+function triggerBrandExtraction(apiConfig) {
+  if (inflight) {
+    dirty = true;
+    return;
+  }
+  inflight = true;
+  void runExtraction(apiConfig).catch((err) => {
+    log9.error("Brand extraction failed", { error: err?.message });
+  }).finally(() => {
+    inflight = false;
+    if (dirty) {
+      dirty = false;
+      triggerBrandExtraction(apiConfig);
+    }
+  });
+}
+var log9, inflight, dirty;
+var init_trigger2 = __esm({
+  "src/brandExtraction/trigger.ts"() {
+    "use strict";
+    init_brandExtraction();
+    init_logger();
+    log9 = createLogger("brandExtraction:trigger");
+    inflight = false;
+    dirty = false;
+  }
+});
+
 // src/agent.ts
 function getTextContent(blocks) {
   return blocks.filter((b) => b.type === "text").map((b) => b.text).join("");
@@ -6092,7 +6384,7 @@ async function runTurn(params) {
   } = params;
   const tools2 = getToolDefinitions(onboardingState);
   const excludeToolsFromClearing = tools2.filter((t) => !CLEARABLE_TOOLS.has(t.name)).map((t) => t.name);
-  log8.info("Turn started", {
+  log10.info("Turn started", {
     requestId,
     model,
     toolCount: tools2.length,
@@ -6321,7 +6613,7 @@ async function runTurn(params) {
             const tool = getToolByName(event.name);
             const wasStreamed = acc?.started ?? false;
             const isInputStreaming = !!tool?.streaming?.partialInput;
-            log8.info("Tool received", {
+            log10.info("Tool received", {
               requestId,
               toolCallId: event.id,
               name: event.name
@@ -6414,7 +6706,7 @@ async function runTurn(params) {
       });
       return;
     }
-    log8.info("Tools executing", {
+    log10.info("Tools executing", {
       requestId,
       count: toolCalls.length,
       tools: toolCalls.map((tc) => tc.name)
@@ -6461,7 +6753,7 @@ async function runTurn(params) {
             let result;
             if (EXTERNAL_TOOLS.has(tc.name) && resolveExternalTool) {
               saveSession(state);
-              log8.info("Waiting for external tool result", {
+              log10.info("Waiting for external tool result", {
                 requestId,
                 toolCallId: tc.id,
                 name: tc.name
@@ -6528,7 +6820,7 @@ async function runTurn(params) {
         if (!tc.input.background) {
           toolRegistry?.unregister(tc.id);
         }
-        log8.info("Tool completed", {
+        log10.info("Tool completed", {
           requestId,
           toolCallId: tc.id,
           name: tc.name,
@@ -6542,6 +6834,9 @@ async function runTurn(params) {
           result: r.result,
           isError: r.isError
         });
+        if (!r.isError && BRAND_TRIGGERING_TOOLS.has(tc.name)) {
+          triggerBrandExtraction(apiConfig);
+        }
         return r;
       })
     );
@@ -6581,7 +6876,7 @@ async function runTurn(params) {
     }
   }
 }
-var log8, EXTERNAL_TOOLS, USER_BLOCKING_EXTERNAL_TOOLS;
+var log10, BRAND_TRIGGERING_TOOLS, EXTERNAL_TOOLS, USER_BLOCKING_EXTERNAL_TOOLS;
 var init_agent = __esm({
   "src/agent.ts"() {
     "use strict";
@@ -6595,7 +6890,9 @@ var init_agent = __esm({
     init_cleanMessages();
     init_tools6();
     init_sentinel();
-    log8 = createLogger("agent");
+    init_trigger2();
+    log10 = createLogger("agent");
+    BRAND_TRIGGERING_TOOLS = /* @__PURE__ */ new Set(["writeSpec", "editSpec"]);
     EXTERNAL_TOOLS = /* @__PURE__ */ new Set([
       "promptUser",
       "setProjectOnboardingState",
@@ -6616,16 +6913,16 @@ var init_agent = __esm({
 });
 
 // src/config.ts
-import fs19 from "fs";
-import path9 from "path";
+import fs20 from "fs";
+import path10 from "path";
 import os from "os";
 function loadConfigFile() {
   try {
-    const raw = fs19.readFileSync(CONFIG_PATH, "utf-8");
-    log9.debug("Loaded config file", { path: CONFIG_PATH });
+    const raw = fs20.readFileSync(CONFIG_PATH, "utf-8");
+    log11.debug("Loaded config file", { path: CONFIG_PATH });
     return JSON.parse(raw);
   } catch (err) {
-    log9.debug("No config file found", {
+    log11.debug("No config file found", {
       path: CONFIG_PATH,
       error: err.message
     });
@@ -6639,26 +6936,26 @@ function resolveConfig(flags2) {
   const apiKey = flags2?.apiKey || process.env.MINDSTUDIO_API_KEY || env?.apiKey || "";
   const baseUrl2 = flags2?.baseUrl || process.env.MINDSTUDIO_BASE_URL || env?.apiBaseUrl || DEFAULT_BASE_URL;
   if (!apiKey) {
-    log9.error("No API key found");
+    log11.error("No API key found");
     throw new Error(
       "No API key found. Set MINDSTUDIO_API_KEY or configure ~/.mindstudio-local-tunnel/config.json."
     );
   }
   const keySource = flags2?.apiKey ? "cli flag" : process.env.MINDSTUDIO_API_KEY ? "env var" : "config file";
-  log9.info("Config resolved", {
+  log11.info("Config resolved", {
     baseUrl: baseUrl2,
     keySource,
     environment: activeEnv
   });
   return { apiKey, baseUrl: baseUrl2 };
 }
-var log9, CONFIG_PATH, DEFAULT_BASE_URL;
+var log11, CONFIG_PATH, DEFAULT_BASE_URL;
 var init_config = __esm({
   "src/config.ts"() {
     "use strict";
     init_logger();
-    log9 = createLogger("config");
-    CONFIG_PATH = path9.join(
+    log11 = createLogger("config");
+    CONFIG_PATH = path10.join(
       os.homedir(),
       ".mindstudio-local-tunnel",
       "config.json"
@@ -6668,12 +6965,12 @@ var init_config = __esm({
 });
 
 // src/toolRegistry.ts
-var log10, ToolRegistry;
+var log12, ToolRegistry;
 var init_toolRegistry = __esm({
   "src/toolRegistry.ts"() {
     "use strict";
     init_logger();
-    log10 = createLogger("tool-registry");
+    log12 = createLogger("tool-registry");
     ToolRegistry = class {
       entries = /* @__PURE__ */ new Map();
       onEvent;
@@ -6699,7 +6996,7 @@ var init_toolRegistry = __esm({
         if (!entry) {
           return false;
         }
-        log10.info("Tool stopped", { toolCallId: id, name: entry.name, mode });
+        log12.info("Tool stopped", { toolCallId: id, name: entry.name, mode });
         entry.abortController.abort(mode);
         if (mode === "graceful") {
           const partial = entry.getPartialResult?.() ?? "";
@@ -6732,7 +7029,7 @@ ${partial}` : "[INTERRUPTED] Tool execution was stopped.";
         if (!entry) {
           return false;
         }
-        log10.info("Tool restarted", { toolCallId: id, name: entry.name });
+        log12.info("Tool restarted", { toolCallId: id, name: entry.name });
         entry.abortController.abort("restart");
         const newInput = patchedInput ? { ...entry.input, ...patchedInput } : entry.input;
         this.onEvent?.({
@@ -6798,7 +7095,7 @@ async function persistAttachments(attachments) {
       }
       const buffer = Buffer.from(await res.arrayBuffer());
       await writeFile(localPath, buffer);
-      log11.info("Attachment saved", {
+      log13.info("Attachment saved", {
         filename: name,
         path: localPath,
         bytes: buffer.length
@@ -6812,7 +7109,7 @@ async function persistAttachments(attachments) {
           if (textRes.ok) {
             extractedTextPath = `${localPath}.txt`;
             await writeFile(extractedTextPath, await textRes.text(), "utf-8");
-            log11.info("Extracted text saved", { path: extractedTextPath });
+            log13.info("Extracted text saved", { path: extractedTextPath });
           }
         } catch {
         }
@@ -6857,12 +7154,12 @@ function buildUploadHeader(results) {
   return `[Uploaded files]
 ${lines.join("\n")}`;
 }
-var log11, UPLOADS_DIR, IMAGE_EXTENSIONS;
+var log13, UPLOADS_DIR, IMAGE_EXTENSIONS;
 var init_attachments = __esm({
   "src/headless/attachments.ts"() {
     "use strict";
     init_logger();
-    log11 = createLogger("headless:attachments");
+    log13 = createLogger("headless:attachments");
     UPLOADS_DIR = "src/.user-uploads";
     IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([".png", ".jpg", ".jpeg", ".gif", ".webp"]);
   }
@@ -7041,7 +7338,7 @@ __export(headless_exports, {
   HeadlessSession: () => HeadlessSession
 });
 import { createInterface } from "readline";
-var log12, EXTERNAL_TOOL_TIMEOUT_MS, USER_FACING_TOOLS, HeadlessSession;
+var log14, EXTERNAL_TOOL_TIMEOUT_MS, USER_FACING_TOOLS, HeadlessSession;
 var init_headless = __esm({
   "src/headless/index.ts"() {
     "use strict";
@@ -7050,6 +7347,7 @@ var init_headless = __esm({
     init_prompt();
     init_trigger();
     init_compaction();
+    init_trigger2();
     init_lsp();
     init_agent();
     init_session();
@@ -7060,7 +7358,7 @@ var init_headless = __esm({
     init_messageQueue();
     init_resolve();
     init_sentinel();
-    log12 = createLogger("headless");
+    log14 = createLogger("headless");
     EXTERNAL_TOOL_TIMEOUT_MS = 3e5;
     USER_FACING_TOOLS = /* @__PURE__ */ new Set([
       "promptUser",
@@ -7132,6 +7430,7 @@ var init_headless = __esm({
             ...this.queueFields()
           });
         }
+        triggerBrandExtraction(this.config);
         this.toolRegistry.onEvent = this.onEvent;
         this.readline = createInterface({ input: process.stdin });
         this.readline.on("line", this.handleStdinLine);
@@ -7231,7 +7530,7 @@ var init_headless = __esm({
       }
       onBackgroundComplete = (toolCallId, name, result, subAgentMessages) => {
         this.pendingBlockUpdates.push({ toolCallId, result, subAgentMessages });
-        log12.info("Background complete", {
+        log14.info("Background complete", {
           toolCallId,
           name,
           requestId: this.currentRequestId
@@ -7452,7 +7751,7 @@ var init_headless = __esm({
         this.turnStart = Date.now();
         const attachments = parsed.attachments;
         if (attachments?.length) {
-          log12.info("Message has attachments", {
+          log14.info("Message has attachments", {
             count: attachments.length,
             urls: attachments.map((a) => a.url)
           });
@@ -7469,7 +7768,7 @@ var init_headless = __esm({
 ${userMessage}` : header;
             }
           } catch (err) {
-            log12.warn("Attachment persistence failed", { error: err.message });
+            log14.warn("Attachment persistence failed", { error: err.message });
           }
         }
         let resolved = null;
@@ -7527,7 +7826,7 @@ ${userMessage}` : header;
               error: "Turn ended unexpectedly"
             });
           }
-          log12.info("Turn complete", {
+          log14.info("Turn complete", {
             requestId,
             durationMs: Date.now() - this.turnStart
           });
@@ -7539,7 +7838,7 @@ ${userMessage}` : header;
               error: err.message
             });
           }
-          log12.warn("Command failed", {
+          log14.warn("Command failed", {
             action: "message",
             requestId,
             error: err.message
@@ -7674,7 +7973,7 @@ ${userMessage}` : header;
           return;
         }
         const { action, requestId } = parsed;
-        log12.info("Command received", { action, requestId });
+        log14.info("Command received", { action, requestId });
         if (action === "tool_result" && parsed.id) {
           const id = parsed.id;
           const result = parsed.result ?? "";
@@ -7683,7 +7982,7 @@ ${userMessage}` : header;
             this.pendingTools.delete(id);
             pending.resolve(result);
           } else if (!this.running) {
-            log12.info("Late tool_result while idle, dismissing", { id });
+            log14.info("Late tool_result while idle, dismissing", { id });
             this.emit("completed", { success: true }, requestId);
           } else {
             this.earlyResults.set(id, result);
@@ -7811,8 +8110,8 @@ ${userMessage}` : header;
 // src/index.tsx
 import { render } from "ink";
 import os2 from "os";
-import fs20 from "fs";
-import path10 from "path";
+import fs21 from "fs";
+import path11 from "path";
 
 // src/tui/App.tsx
 import { useState as useState2, useCallback, useRef } from "react";
@@ -8130,8 +8429,8 @@ for (let i = 0; i < args.length; i++) {
 var startupLog = createLogger("startup");
 function printDebugInfo(config) {
   const pkg = JSON.parse(
-    fs20.readFileSync(
-      path10.join(import.meta.dirname, "..", "package.json"),
+    fs21.readFileSync(
+      path11.join(import.meta.dirname, "..", "package.json"),
       "utf-8"
     )
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindstudio-ai/remy",
-  "version": "0.1.158",
+  "version": "0.1.159",
   "description": "MindStudio coding agent",
   "repository": {
     "type": "git",