@mindstudio-ai/remy 0.1.213 → 0.1.214

package/dist/headless.js

@@ -724,88 +724,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 +916,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 +1009,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 +1033,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 +1870,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: {

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();
         }
@@ -2485,90 +2490,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;

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.214",
   "description": "Remy coding agent",
   "repository": {
     "type": "git",