@mindstudio-ai/remy 0.1.213 → 0.1.215

package/dist/headless.js

@@ -393,6 +393,9 @@ async function initOrgContext(config) {
     log3.debug("org context init failed", { error: err.message });
   }
 }
+function getOrgContext() {
+  return cached;
+}
 function renderOrgContextBlock() {
   const ctx = cached;
   const auth = ctx?.auth;
@@ -724,88 +727,23 @@ ${loadPlanStatus()}
 import fs5 from "fs/promises";
 
 // src/tools/spec/_helpers.ts
-var HEADING_RE = /^(#{1,6})\s+(.+)$/;
-function parseHeadings(content) {
-  const lines = content.split("\n");
-  const headings = [];
-  for (let i = 0; i < lines.length; i++) {
-    const match = lines[i].match(HEADING_RE);
-    if (match) {
-      headings.push({
-        level: match[1].length,
-        text: match[2].trim(),
-        startLine: i,
-        contentStart: i + 1,
-        contentEnd: lines.length
-        // placeholder — resolved below
-      });
-    }
-  }
-  for (let i = 0; i < headings.length; i++) {
-    const current = headings[i];
-    let end = lines.length;
-    for (let j = i + 1; j < headings.length; j++) {
-      if (headings[j].level <= current.level) {
-        end = headings[j].startLine;
-        break;
-      }
-    }
-    current.contentEnd = end;
-  }
-  return headings;
-}
-function resolveHeadingPath(content, headingPath) {
-  const lines = content.split("\n");
-  const headings = parseHeadings(content);
-  if (headingPath === "") {
-    const firstHeadingLine = headings.length > 0 ? headings[0].startLine : lines.length;
-    return {
-      startLine: 0,
-      contentStart: 0,
-      contentEnd: firstHeadingLine
-    };
-  }
-  const segments = headingPath.split(">").map((s) => s.trim());
-  let searchStart = 0;
-  let searchEnd = lines.length;
-  let resolved = null;
-  for (let si = 0; si < segments.length; si++) {
-    const segment = segments[si].toLowerCase();
-    const candidates = headings.filter(
-      (h) => h.startLine >= searchStart && h.startLine < searchEnd && h.text.toLowerCase() === segment
-    );
-    if (candidates.length === 0) {
-      const available = headings.filter((h) => h.startLine >= searchStart && h.startLine < searchEnd).map((h) => `${"#".repeat(h.level)} ${h.text}`).join("\n");
-      const searchedPath = segments.slice(0, si + 1).join(" > ");
-      throw new Error(
-        `Heading not found: "${searchedPath}"
-
-Available headings:
-${available || "(none)"}`
-      );
-    }
-    resolved = candidates[0];
-    searchStart = resolved.contentStart;
-    searchEnd = resolved.contentEnd;
-  }
-  return {
-    startLine: resolved.startLine,
-    contentStart: resolved.contentStart,
-    contentEnd: resolved.contentEnd
-  };
-}
 function validateSpecPath(filePath) {
   if (!filePath.startsWith("src/")) {
     throw new Error(`Spec tool paths must start with src/. Got: "${filePath}"`);
   }
   return filePath;
 }
-function getHeadingTree(content) {
-  const headings = parseHeadings(content);
-  if (headings.length === 0) {
-    return "(no headings)";
+function extractFrontmatter(content) {
+  const lines = content.split("\n");
+  if (lines.length === 0 || lines[0].trim() !== "---") {
+    return null;
   }
-  return headings.map((h) => `${"#".repeat(h.level)} ${h.text}`).join("\n");
+  for (let i = 1; i < lines.length; i++) {
+    if (lines[i].trim() === "---") {
+      return lines.slice(0, i + 1).join("\n");
+    }
+  }
+  return null;
 }
 
 // src/tools/spec/readSpec.ts
@@ -981,11 +919,92 @@ ${unifiedDiff(input.path, oldContent ?? "", input.content)}`;
 
 // src/tools/spec/editSpec.ts
 import fs7 from "fs/promises";
+
+// src/tools/code/editFile/_helpers.ts
+function buildLineOffsets(content) {
+  const offsets = [0];
+  for (let i = 0; i < content.length; i++) {
+    if (content[i] === "\n") {
+      offsets.push(i + 1);
+    }
+  }
+  return offsets;
+}
+function lineAtOffset(offsets, charIndex) {
+  let lo = 0;
+  let hi = offsets.length - 1;
+  while (lo < hi) {
+    const mid = lo + hi + 1 >> 1;
+    if (offsets[mid] <= charIndex) {
+      lo = mid;
+    } else {
+      hi = mid - 1;
+    }
+  }
+  return lo + 1;
+}
+function findOccurrences(content, searchString) {
+  if (!searchString) {
+    return [];
+  }
+  const offsets = buildLineOffsets(content);
+  const results = [];
+  let pos = 0;
+  while (pos <= content.length - searchString.length) {
+    const idx = content.indexOf(searchString, pos);
+    if (idx === -1) {
+      break;
+    }
+    results.push({ index: idx, line: lineAtOffset(offsets, idx) });
+    pos = idx + 1;
+  }
+  return results;
+}
+function flexibleMatch(content, searchString) {
+  const contentLines = content.split("\n");
+  const searchLines = searchString.split("\n").map((l) => l.trimStart());
+  if (searchLines.length === 0) {
+    return null;
+  }
+  const matches = [];
+  for (let i = 0; i <= contentLines.length - searchLines.length; i++) {
+    let allMatch = true;
+    for (let j = 0; j < searchLines.length; j++) {
+      if (contentLines[i + j].trimStart() !== searchLines[j]) {
+        allMatch = false;
+        break;
+      }
+    }
+    if (allMatch) {
+      matches.push(i);
+    }
+  }
+  if (matches.length !== 1) {
+    return null;
+  }
+  const startIdx = matches[0];
+  const matchedText = contentLines.slice(startIdx, startIdx + searchLines.length).join("\n");
+  const offsets = buildLineOffsets(content);
+  return {
+    matchedText,
+    index: offsets[startIdx],
+    line: startIdx + 1
+    // 1-based
+  };
+}
+function replaceAt(content, index, oldLength, newString) {
+  return content.slice(0, index) + newString + content.slice(index + oldLength);
+}
+function formatOccurrenceError(count, lines, filePath) {
+  return `old_string found ${count} times in ${filePath} (at lines ${lines.join(", ")}) \u2014 must be unique. Include more surrounding context to disambiguate, or use replace_all to replace every occurrence.`;
+}
+
+// src/tools/spec/editSpec.ts
 var editSpecTool = {
   clearable: true,
   definition: {
     name: "editSpec",
-    description: 'Make targeted edits to a spec file by heading path. This is the primary tool for modifying existing specs. Each edit targets a section by its heading hierarchy (e.g., "Vendors > Approval Flow") and applies an operation. Multiple edits are applied in order.',
+    description: "Make a targeted find/replace edit to a spec file (src/*.md). old_string must appear exactly once (minor indentation differences are handled automatically); set replace_all to true to replace every occurrence. Read the file with readSpec first so you match the exact text, and include the full enclosing structure rather than an inner fragment. The file's YAML frontmatter (the leading --- \u2026 --- block, which holds required fields like name) is protected \u2014 an edit that would remove or malform it is refused. For a full rewrite, use writeSpec.",
     inputSchema: {
       type: "object",
       properties: {
@@ -993,31 +1012,20 @@ var editSpecTool = {
           type: "string",
           description: "File path relative to project root, must start with src/ (e.g., src/app.md)."
         },
-        edits: {
-          type: "array",
-          items: {
-            type: "object",
-            properties: {
-              heading: {
-                type: "string",
-                description: 'Heading path using " > " to separate nesting levels (e.g., "Vendors > Approval Flow"). Empty string targets the preamble (content before the first heading).'
-              },
-              operation: {
-                type: "string",
-                enum: ["replace", "insert_after", "insert_before", "delete"],
-                description: "replace: swap content under this heading (keeps the heading line). insert_after: add content after this section. insert_before: add content before this heading. delete: remove this heading and all its content."
-              },
-              content: {
-                type: "string",
-                description: "MSFM markdown content for replace/insert operations. Not needed for delete."
-              }
-            },
-            required: ["heading", "operation"]
-          },
-          description: "Array of edits to apply in order."
+        old_string: {
+          type: "string",
+          description: "The exact string to find and replace. Must be unique in the file unless replace_all is true."
+        },
+        new_string: {
+          type: "string",
+          description: "The replacement string."
+        },
+        replace_all: {
+          type: "boolean",
+          description: "If true, replace every occurrence of old_string in the file. Defaults to false."
         }
       },
-      required: ["path", "edits"]
+      required: ["path", "old_string", "new_string"]
     }
   },
   async execute(input) {
@@ -1028,69 +1036,66 @@ var editSpecTool = {
     }
     const release = await acquireFileLock(input.path);
     try {
-      let originalContent;
+      let content;
       try {
-        originalContent = await fs7.readFile(input.path, "utf-8");
+        content = await fs7.readFile(input.path, "utf-8");
       } catch (err) {
         return `Error reading file: ${err.message}`;
       }
-      let content = originalContent;
-      for (const edit of input.edits) {
-        let range;
-        try {
-          range = resolveHeadingPath(content, edit.heading);
-        } catch (err) {
-          const tree = getHeadingTree(content);
-          return `Error: ${err.message}
-
-Document structure:
-${tree}`;
+      const { old_string, new_string, replace_all } = input;
+      const occurrences = findOccurrences(content, old_string);
+      let updated;
+      let notePrefix;
+      if (replace_all) {
+        if (occurrences.length === 0) {
+          return `Error: old_string not found in ${input.path}.`;
         }
-        const lines = content.split("\n");
-        switch (edit.operation) {
-          case "replace": {
-            if (edit.content == null) {
-              return 'Error: "content" is required for replace operations.';
-            }
-            const contentLines = edit.content.split("\n");
-            lines.splice(
-              range.contentStart,
-              range.contentEnd - range.contentStart,
-              ...contentLines
-            );
-            break;
-          }
-          case "insert_after": {
-            if (edit.content == null) {
-              return 'Error: "content" is required for insert_after operations.';
-            }
-            const contentLines = edit.content.split("\n");
-            lines.splice(range.contentEnd, 0, ...contentLines);
-            break;
-          }
-          case "insert_before": {
-            if (edit.content == null) {
-              return 'Error: "content" is required for insert_before operations.';
-            }
-            const contentLines = edit.content.split("\n");
-            lines.splice(range.startLine, 0, ...contentLines);
-            break;
-          }
-          case "delete": {
-            lines.splice(range.startLine, range.contentEnd - range.startLine);
-            break;
-          }
-          default:
-            return `Error: Unknown operation "${edit.operation}". Use replace, insert_after, insert_before, or delete.`;
+        updated = content;
+        for (let i = occurrences.length - 1; i >= 0; i--) {
+          updated = replaceAt(
+            updated,
+            occurrences[i].index,
+            old_string.length,
+            new_string
+          );
+        }
+        notePrefix = `Replaced ${occurrences.length} occurrence${occurrences.length > 1 ? "s" : ""} in ${input.path}
+`;
+      } else if (occurrences.length === 1) {
+        updated = replaceAt(
+          content,
+          occurrences[0].index,
+          old_string.length,
+          new_string
+        );
+        notePrefix = `Updated ${input.path}
+`;
+      } else if (occurrences.length > 1) {
+        const lines = occurrences.map((o) => o.line);
+        return `Error: ${formatOccurrenceError(occurrences.length, lines, input.path)}`;
+      } else {
+        const flex = flexibleMatch(content, old_string);
+        if (!flex) {
+          return `Error: old_string not found in ${input.path}. Make sure you've read the file first and copied the exact text.`;
         }
-        content = lines.join("\n");
+        updated = replaceAt(
+          content,
+          flex.index,
+          flex.matchedText.length,
+          new_string
+        );
+        notePrefix = `Updated ${input.path} (matched with flexible whitespace at line ${flex.line})
+`;
+      }
+      if (extractFrontmatter(content) !== null && extractFrontmatter(updated) === null) {
+        return `Error: that edit would remove or malform the spec's YAML frontmatter (the leading \`--- \u2026 ---\` block, which holds required fields like \`name\`). Narrow old_string to the body content you meant to change and leave the frontmatter block intact.`;
       }
       try {
-        await fs7.writeFile(input.path, content, "utf-8");
+        await fs7.writeFile(input.path, updated, "utf-8");
       } catch (err) {
         return `Error writing file: ${err.message}`;
       }
-      return unifiedDiff(input.path, originalContent, content);
+      return `${notePrefix}${unifiedDiff(input.path, content, updated)}`;
     } finally {
       release();
     }
@@ -1868,87 +1873,6 @@ ${unifiedDiff(input.path, oldContent ?? "", input.content)}`;
 
 // src/tools/code/editFile/index.ts
 import fs14 from "fs/promises";
-
-// src/tools/code/editFile/_helpers.ts
-function buildLineOffsets(content) {
-  const offsets = [0];
-  for (let i = 0; i < content.length; i++) {
-    if (content[i] === "\n") {
-      offsets.push(i + 1);
-    }
-  }
-  return offsets;
-}
-function lineAtOffset(offsets, charIndex) {
-  let lo = 0;
-  let hi = offsets.length - 1;
-  while (lo < hi) {
-    const mid = lo + hi + 1 >> 1;
-    if (offsets[mid] <= charIndex) {
-      lo = mid;
-    } else {
-      hi = mid - 1;
-    }
-  }
-  return lo + 1;
-}
-function findOccurrences(content, searchString) {
-  if (!searchString) {
-    return [];
-  }
-  const offsets = buildLineOffsets(content);
-  const results = [];
-  let pos = 0;
-  while (pos <= content.length - searchString.length) {
-    const idx = content.indexOf(searchString, pos);
-    if (idx === -1) {
-      break;
-    }
-    results.push({ index: idx, line: lineAtOffset(offsets, idx) });
-    pos = idx + 1;
-  }
-  return results;
-}
-function flexibleMatch(content, searchString) {
-  const contentLines = content.split("\n");
-  const searchLines = searchString.split("\n").map((l) => l.trimStart());
-  if (searchLines.length === 0) {
-    return null;
-  }
-  const matches = [];
-  for (let i = 0; i <= contentLines.length - searchLines.length; i++) {
-    let allMatch = true;
-    for (let j = 0; j < searchLines.length; j++) {
-      if (contentLines[i + j].trimStart() !== searchLines[j]) {
-        allMatch = false;
-        break;
-      }
-    }
-    if (allMatch) {
-      matches.push(i);
-    }
-  }
-  if (matches.length !== 1) {
-    return null;
-  }
-  const startIdx = matches[0];
-  const matchedText = contentLines.slice(startIdx, startIdx + searchLines.length).join("\n");
-  const offsets = buildLineOffsets(content);
-  return {
-    matchedText,
-    index: offsets[startIdx],
-    line: startIdx + 1
-    // 1-based
-  };
-}
-function replaceAt(content, index, oldLength, newString) {
-  return content.slice(0, index) + newString + content.slice(index + oldLength);
-}
-function formatOccurrenceError(count, lines, filePath) {
-  return `old_string found ${count} times in ${filePath} (at lines ${lines.join(", ")}) \u2014 must be unique. Include more surrounding context to disambiguate, or use replace_all to replace every occurrence.`;
-}
-
-// src/tools/code/editFile/index.ts
 var editFileTool = {
   clearable: true,
   definition: {
@@ -5036,6 +4960,16 @@ var PROMPT_TEMPLATE = readAsset(SUBAGENT, "prompt.md").replace(/\{\{([^}]+)\}\}/
   const k = key.trim();
   return RUNTIME_PLACEHOLDERS.has(k) ? match : readAsset(SUBAGENT, k);
 }).replace(/\n{3,}/g, "\n\n");
+function renderDesignSystemBlock(designSystem) {
+  if (!designSystem) {
+    return "";
+  }
+  return [
+    "<design_system>",
+    `The organization that owns this app publishes a design system at ${designSystem}. Treat it as the primary reference for this app's foundational visual language \u2014 palette, type, spacing, and the core component patterns that should feel consistent with the org's other products. Consult it for foundational decisions and fetch it with scrapeWebUrl when you need specifics (it's usually a hosted doc such as an llms.txt). It's a resource to orient toward, not a rulebook: you don't need to ground every detail in it, and app-specific or expressive choices are still yours to make.`,
+    "</design_system>"
+  ].join("\n");
+}
 function getDesignExpertPrompt(onboardingState) {
   const specContext = loadSpecIndex();
   const indices = getSampleIndices(
@@ -5065,6 +4999,14 @@ function getDesignExpertPrompt(onboardingState) {
     prompt += `
 
 ${specContext}`;
+  }
+  const designSystemBlock = renderDesignSystemBlock(
+    getOrgContext()?.designSystem
+  );
+  if (designSystemBlock) {
+    prompt += `
+
+${designSystemBlock}`;
   }
   const state = onboardingState ?? "onboardingFinished";
   if (state !== "onboardingFinished") {

package/dist/index.js

@@ -369,93 +369,27 @@ var init_api = __esm({
 });
 
 // src/tools/spec/_helpers.ts
-function parseHeadings(content) {
-  const lines = content.split("\n");
-  const headings = [];
-  for (let i = 0; i < lines.length; i++) {
-    const match = lines[i].match(HEADING_RE);
-    if (match) {
-      headings.push({
-        level: match[1].length,
-        text: match[2].trim(),
-        startLine: i,
-        contentStart: i + 1,
-        contentEnd: lines.length
-        // placeholder — resolved below
-      });
-    }
-  }
-  for (let i = 0; i < headings.length; i++) {
-    const current = headings[i];
-    let end = lines.length;
-    for (let j = i + 1; j < headings.length; j++) {
-      if (headings[j].level <= current.level) {
-        end = headings[j].startLine;
-        break;
-      }
-    }
-    current.contentEnd = end;
-  }
-  return headings;
-}
-function resolveHeadingPath(content, headingPath) {
-  const lines = content.split("\n");
-  const headings = parseHeadings(content);
-  if (headingPath === "") {
-    const firstHeadingLine = headings.length > 0 ? headings[0].startLine : lines.length;
-    return {
-      startLine: 0,
-      contentStart: 0,
-      contentEnd: firstHeadingLine
-    };
-  }
-  const segments = headingPath.split(">").map((s) => s.trim());
-  let searchStart = 0;
-  let searchEnd = lines.length;
-  let resolved = null;
-  for (let si = 0; si < segments.length; si++) {
-    const segment = segments[si].toLowerCase();
-    const candidates = headings.filter(
-      (h) => h.startLine >= searchStart && h.startLine < searchEnd && h.text.toLowerCase() === segment
-    );
-    if (candidates.length === 0) {
-      const available = headings.filter((h) => h.startLine >= searchStart && h.startLine < searchEnd).map((h) => `${"#".repeat(h.level)} ${h.text}`).join("\n");
-      const searchedPath = segments.slice(0, si + 1).join(" > ");
-      throw new Error(
-        `Heading not found: "${searchedPath}"
-
-Available headings:
-${available || "(none)"}`
-      );
-    }
-    resolved = candidates[0];
-    searchStart = resolved.contentStart;
-    searchEnd = resolved.contentEnd;
-  }
-  return {
-    startLine: resolved.startLine,
-    contentStart: resolved.contentStart,
-    contentEnd: resolved.contentEnd
-  };
-}
 function validateSpecPath(filePath) {
   if (!filePath.startsWith("src/")) {
     throw new Error(`Spec tool paths must start with src/. Got: "${filePath}"`);
   }
   return filePath;
 }
-function getHeadingTree(content) {
-  const headings = parseHeadings(content);
-  if (headings.length === 0) {
-    return "(no headings)";
+function extractFrontmatter(content) {
+  const lines = content.split("\n");
+  if (lines.length === 0 || lines[0].trim() !== "---") {
+    return null;
+  }
+  for (let i = 1; i < lines.length; i++) {
+    if (lines[i].trim() === "---") {
+      return lines.slice(0, i + 1).join("\n");
+    }
   }
-  return headings.map((h) => `${"#".repeat(h.level)} ${h.text}`).join("\n");
+  return null;
 }
-var HEADING_RE;
 var init_helpers = __esm({
   "src/tools/spec/_helpers.ts"() {
     "use strict";
-    HEADING_RE = /^(#{1,6})\s+(.+)$/;
   }
 });
 
@@ -657,6 +591,90 @@ ${unifiedDiff(input.path, oldContent ?? "", input.content)}`;
   }
 });
 
+// src/tools/code/editFile/_helpers.ts
+function buildLineOffsets(content) {
+  const offsets = [0];
+  for (let i = 0; i < content.length; i++) {
+    if (content[i] === "\n") {
+      offsets.push(i + 1);
+    }
+  }
+  return offsets;
+}
+function lineAtOffset(offsets, charIndex) {
+  let lo = 0;
+  let hi = offsets.length - 1;
+  while (lo < hi) {
+    const mid = lo + hi + 1 >> 1;
+    if (offsets[mid] <= charIndex) {
+      lo = mid;
+    } else {
+      hi = mid - 1;
+    }
+  }
+  return lo + 1;
+}
+function findOccurrences(content, searchString) {
+  if (!searchString) {
+    return [];
+  }
+  const offsets = buildLineOffsets(content);
+  const results = [];
+  let pos = 0;
+  while (pos <= content.length - searchString.length) {
+    const idx = content.indexOf(searchString, pos);
+    if (idx === -1) {
+      break;
+    }
+    results.push({ index: idx, line: lineAtOffset(offsets, idx) });
+    pos = idx + 1;
+  }
+  return results;
+}
+function flexibleMatch(content, searchString) {
+  const contentLines = content.split("\n");
+  const searchLines = searchString.split("\n").map((l) => l.trimStart());
+  if (searchLines.length === 0) {
+    return null;
+  }
+  const matches = [];
+  for (let i = 0; i <= contentLines.length - searchLines.length; i++) {
+    let allMatch = true;
+    for (let j = 0; j < searchLines.length; j++) {
+      if (contentLines[i + j].trimStart() !== searchLines[j]) {
+        allMatch = false;
+        break;
+      }
+    }
+    if (allMatch) {
+      matches.push(i);
+    }
+  }
+  if (matches.length !== 1) {
+    return null;
+  }
+  const startIdx = matches[0];
+  const matchedText = contentLines.slice(startIdx, startIdx + searchLines.length).join("\n");
+  const offsets = buildLineOffsets(content);
+  return {
+    matchedText,
+    index: offsets[startIdx],
+    line: startIdx + 1
+    // 1-based
+  };
+}
+function replaceAt(content, index, oldLength, newString) {
+  return content.slice(0, index) + newString + content.slice(index + oldLength);
+}
+function formatOccurrenceError(count, lines, filePath) {
+  return `old_string found ${count} times in ${filePath} (at lines ${lines.join(", ")}) \u2014 must be unique. Include more surrounding context to disambiguate, or use replace_all to replace every occurrence.`;
+}
+var init_helpers2 = __esm({
+  "src/tools/code/editFile/_helpers.ts"() {
+    "use strict";
+  }
+});
+
 // src/tools/spec/editSpec.ts
 import fs4 from "fs/promises";
 var editSpecTool;
@@ -664,13 +682,14 @@ var init_editSpec = __esm({
   "src/tools/spec/editSpec.ts"() {
     "use strict";
     init_helpers();
+    init_helpers2();
     init_diff();
     init_fileLock();
     editSpecTool = {
       clearable: true,
       definition: {
         name: "editSpec",
-        description: 'Make targeted edits to a spec file by heading path. This is the primary tool for modifying existing specs. Each edit targets a section by its heading hierarchy (e.g., "Vendors > Approval Flow") and applies an operation. Multiple edits are applied in order.',
+        description: "Make a targeted find/replace edit to a spec file (src/*.md). old_string must appear exactly once (minor indentation differences are handled automatically); set replace_all to true to replace every occurrence. Read the file with readSpec first so you match the exact text, and include the full enclosing structure rather than an inner fragment. The file's YAML frontmatter (the leading --- \u2026 --- block, which holds required fields like name) is protected \u2014 an edit that would remove or malform it is refused. For a full rewrite, use writeSpec.",
         inputSchema: {
           type: "object",
           properties: {
@@ -678,31 +697,20 @@ var init_editSpec = __esm({
               type: "string",
               description: "File path relative to project root, must start with src/ (e.g., src/app.md)."
             },
-            edits: {
-              type: "array",
-              items: {
-                type: "object",
-                properties: {
-                  heading: {
-                    type: "string",
-                    description: 'Heading path using " > " to separate nesting levels (e.g., "Vendors > Approval Flow"). Empty string targets the preamble (content before the first heading).'
-                  },
-                  operation: {
-                    type: "string",
-                    enum: ["replace", "insert_after", "insert_before", "delete"],
-                    description: "replace: swap content under this heading (keeps the heading line). insert_after: add content after this section. insert_before: add content before this heading. delete: remove this heading and all its content."
-                  },
-                  content: {
-                    type: "string",
-                    description: "MSFM markdown content for replace/insert operations. Not needed for delete."
-                  }
-                },
-                required: ["heading", "operation"]
-              },
-              description: "Array of edits to apply in order."
+            old_string: {
+              type: "string",
+              description: "The exact string to find and replace. Must be unique in the file unless replace_all is true."
+            },
+            new_string: {
+              type: "string",
+              description: "The replacement string."
+            },
+            replace_all: {
+              type: "boolean",
+              description: "If true, replace every occurrence of old_string in the file. Defaults to false."
             }
           },
-          required: ["path", "edits"]
+          required: ["path", "old_string", "new_string"]
         }
       },
       async execute(input) {
@@ -713,69 +721,66 @@ var init_editSpec = __esm({
         }
         const release = await acquireFileLock(input.path);
         try {
-          let originalContent;
+          let content;
           try {
-            originalContent = await fs4.readFile(input.path, "utf-8");
+            content = await fs4.readFile(input.path, "utf-8");
           } catch (err) {
             return `Error reading file: ${err.message}`;
           }
-          let content = originalContent;
-          for (const edit of input.edits) {
-            let range;
-            try {
-              range = resolveHeadingPath(content, edit.heading);
-            } catch (err) {
-              const tree = getHeadingTree(content);
-              return `Error: ${err.message}
-
-Document structure:
-${tree}`;
+          const { old_string, new_string, replace_all } = input;
+          const occurrences = findOccurrences(content, old_string);
+          let updated;
+          let notePrefix;
+          if (replace_all) {
+            if (occurrences.length === 0) {
+              return `Error: old_string not found in ${input.path}.`;
             }
-            const lines = content.split("\n");
-            switch (edit.operation) {
-              case "replace": {
-                if (edit.content == null) {
-                  return 'Error: "content" is required for replace operations.';
-                }
-                const contentLines = edit.content.split("\n");
-                lines.splice(
-                  range.contentStart,
-                  range.contentEnd - range.contentStart,
-                  ...contentLines
-                );
-                break;
-              }
-              case "insert_after": {
-                if (edit.content == null) {
-                  return 'Error: "content" is required for insert_after operations.';
-                }
-                const contentLines = edit.content.split("\n");
-                lines.splice(range.contentEnd, 0, ...contentLines);
-                break;
-              }
-              case "insert_before": {
-                if (edit.content == null) {
-                  return 'Error: "content" is required for insert_before operations.';
-                }
-                const contentLines = edit.content.split("\n");
-                lines.splice(range.startLine, 0, ...contentLines);
-                break;
-              }
-              case "delete": {
-                lines.splice(range.startLine, range.contentEnd - range.startLine);
-                break;
-              }
-              default:
-                return `Error: Unknown operation "${edit.operation}". Use replace, insert_after, insert_before, or delete.`;
+            updated = content;
+            for (let i = occurrences.length - 1; i >= 0; i--) {
+              updated = replaceAt(
+                updated,
+                occurrences[i].index,
+                old_string.length,
+                new_string
+              );
+            }
+            notePrefix = `Replaced ${occurrences.length} occurrence${occurrences.length > 1 ? "s" : ""} in ${input.path}
+`;
+          } else if (occurrences.length === 1) {
+            updated = replaceAt(
+              content,
+              occurrences[0].index,
+              old_string.length,
+              new_string
+            );
+            notePrefix = `Updated ${input.path}
+`;
+          } else if (occurrences.length > 1) {
+            const lines = occurrences.map((o) => o.line);
+            return `Error: ${formatOccurrenceError(occurrences.length, lines, input.path)}`;
+          } else {
+            const flex = flexibleMatch(content, old_string);
+            if (!flex) {
+              return `Error: old_string not found in ${input.path}. Make sure you've read the file first and copied the exact text.`;
             }
-            content = lines.join("\n");
+            updated = replaceAt(
+              content,
+              flex.index,
+              flex.matchedText.length,
+              new_string
+            );
+            notePrefix = `Updated ${input.path} (matched with flexible whitespace at line ${flex.line})
+`;
+          }
+          if (extractFrontmatter(content) !== null && extractFrontmatter(updated) === null) {
+            return `Error: that edit would remove or malform the spec's YAML frontmatter (the leading \`--- \u2026 ---\` block, which holds required fields like \`name\`). Narrow old_string to the body content you meant to change and leave the frontmatter block intact.`;
           }
           try {
-            await fs4.writeFile(input.path, content, "utf-8");
+            await fs4.writeFile(input.path, updated, "utf-8");
           } catch (err) {
             return `Error writing file: ${err.message}`;
           }
-          return unifiedDiff(input.path, originalContent, content);
+          return `${notePrefix}${unifiedDiff(input.path, content, updated)}`;
         } finally {
           release();
         }
@@ -1951,6 +1956,9 @@ async function initOrgContext(config) {
     log3.debug("org context init failed", { error: err.message });
   }
 }
+function getOrgContext() {
+  return cached;
+}
 function renderOrgContextBlock() {
   const ctx = cached;
   const auth = ctx?.auth;
@@ -2485,90 +2493,6 @@ ${unifiedDiff(input.path, oldContent ?? "", input.content)}`;
   }
 });
 
-// src/tools/code/editFile/_helpers.ts
-function buildLineOffsets(content) {
-  const offsets = [0];
-  for (let i = 0; i < content.length; i++) {
-    if (content[i] === "\n") {
-      offsets.push(i + 1);
-    }
-  }
-  return offsets;
-}
-function lineAtOffset(offsets, charIndex) {
-  let lo = 0;
-  let hi = offsets.length - 1;
-  while (lo < hi) {
-    const mid = lo + hi + 1 >> 1;
-    if (offsets[mid] <= charIndex) {
-      lo = mid;
-    } else {
-      hi = mid - 1;
-    }
-  }
-  return lo + 1;
-}
-function findOccurrences(content, searchString) {
-  if (!searchString) {
-    return [];
-  }
-  const offsets = buildLineOffsets(content);
-  const results = [];
-  let pos = 0;
-  while (pos <= content.length - searchString.length) {
-    const idx = content.indexOf(searchString, pos);
-    if (idx === -1) {
-      break;
-    }
-    results.push({ index: idx, line: lineAtOffset(offsets, idx) });
-    pos = idx + 1;
-  }
-  return results;
-}
-function flexibleMatch(content, searchString) {
-  const contentLines = content.split("\n");
-  const searchLines = searchString.split("\n").map((l) => l.trimStart());
-  if (searchLines.length === 0) {
-    return null;
-  }
-  const matches = [];
-  for (let i = 0; i <= contentLines.length - searchLines.length; i++) {
-    let allMatch = true;
-    for (let j = 0; j < searchLines.length; j++) {
-      if (contentLines[i + j].trimStart() !== searchLines[j]) {
-        allMatch = false;
-        break;
-      }
-    }
-    if (allMatch) {
-      matches.push(i);
-    }
-  }
-  if (matches.length !== 1) {
-    return null;
-  }
-  const startIdx = matches[0];
-  const matchedText = contentLines.slice(startIdx, startIdx + searchLines.length).join("\n");
-  const offsets = buildLineOffsets(content);
-  return {
-    matchedText,
-    index: offsets[startIdx],
-    line: startIdx + 1
-    // 1-based
-  };
-}
-function replaceAt(content, index, oldLength, newString) {
-  return content.slice(0, index) + newString + content.slice(index + oldLength);
-}
-function formatOccurrenceError(count, lines, filePath) {
-  return `old_string found ${count} times in ${filePath} (at lines ${lines.join(", ")}) \u2014 must be unique. Include more surrounding context to disambiguate, or use replace_all to replace every occurrence.`;
-}
-var init_helpers2 = __esm({
-  "src/tools/code/editFile/_helpers.ts"() {
-    "use strict";
-  }
-});
-
 // src/tools/code/editFile/index.ts
 import fs13 from "fs/promises";
 var editFileTool;
@@ -5876,6 +5800,16 @@ var init_getUiInspirationSample = __esm({
 });
 
 // src/subagents/designExpert/prompt.ts
+function renderDesignSystemBlock(designSystem) {
+  if (!designSystem) {
+    return "";
+  }
+  return [
+    "<design_system>",
+    `The organization that owns this app publishes a design system at ${designSystem}. Treat it as the primary reference for this app's foundational visual language \u2014 palette, type, spacing, and the core component patterns that should feel consistent with the org's other products. Consult it for foundational decisions and fetch it with scrapeWebUrl when you need specifics (it's usually a hosted doc such as an llms.txt). It's a resource to orient toward, not a rulebook: you don't need to ground every detail in it, and app-specific or expressive choices are still yours to make.`,
+    "</design_system>"
+  ].join("\n");
+}
 function getDesignExpertPrompt(onboardingState) {
   const specContext = loadSpecIndex();
   const indices = getSampleIndices(
@@ -5905,6 +5839,14 @@ function getDesignExpertPrompt(onboardingState) {
     prompt += `
 
 ${specContext}`;
+  }
+  const designSystemBlock = renderDesignSystemBlock(
+    getOrgContext()?.designSystem
+  );
+  if (designSystemBlock) {
+    prompt += `
+
+${designSystemBlock}`;
   }
   const state = onboardingState ?? "onboardingFinished";
   if (state !== "onboardingFinished") {
@@ -5922,6 +5864,7 @@ var init_prompt3 = __esm({
     "use strict";
     init_assets();
     init_context();
+    init_orgContext();
     init_sampleCache();
     init_getFontLibrarySample();
     init_getDesignReferencesSample();

package/dist/prompt/static/authoring.md

@@ -90,5 +90,5 @@ When generated code exists in `dist/`, you have both spec tools and code tools.
 **Key principle: spec and code stay in sync.**
 - When editing the spec, also update the affected code in the same turn.
 - When the user asks for a code change that represents a behavioral change, also update the spec.
-- Spec tools (`readSpec`, `writeSpec`, `editSpec`, `listSpecFiles`) work on `src/` files.
+- Spec tools work on `src/` files: `readSpec` to read (do this before editing), `editSpec` for targeted find/replace edits (same `old_string`/`new_string` model as `editFile`), `writeSpec` for a full-file write, `listSpecFiles` to see what exists.
 - Code tools (`readFile`, `writeFile`, `editFile`, etc.) work on `dist/` and other project files.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindstudio-ai/remy",
-  "version": "0.1.213",
+  "version": "0.1.215",
   "description": "Remy coding agent",
   "repository": {
     "type": "git",