@mindstudio-ai/remy 0.1.212 → 0.1.214

package/dist/automatedActions/publish.md

@@ -9,7 +9,7 @@ The user wants to deploy their app. Pushing to the `main` branch triggers a prod
 Review the current state of the working tree — what has changed since the last commit, what's been committed since the last push, and the overall shape of recent work. Write a user-friendly changelog with `presentPublishPlan` — summarize what changed in plain language ("added vendor approval workflow", "fixed invoice totals", "updated the dashboard layout"). Reference specific code or file paths only when it helps clarity. This is what the user will see before deploying.
 
 If approved:
-- Stage and commit any uncommitted changes with a clean, descriptive commit message
+- Stage and commit any uncommitted changes with a clean, descriptive commit message. If the committed work resolves any open issues (`mindstudio-prod issues`), reference them in the commit message with a closing keyword — `fixes #42`, `closes #7` — so the deploy closes them automatically once it goes live.
 - Push to main
 - Use `mindstudio-prod releases status --wait` to poll the build until it completes. Let the user know it's deploying, then report back when it's live.
 - Once deployed, offer to help with next steps. This includes technical steps likesetting up a custom domain (`mindstudio-prod domains`), checking for errors (`mindstudio-prod requests stats`), seeding production data (`mindstudio-prod db`), managing env vars/secrets, or anything else they need for launch. It also includes going above and beyond and helping holistically. If it's the initial deploy, offer to help create collateral to announce the launch (e.g., an image for sharing on social media, text copy for a post, etc); if it's a meaningful incremental update, an annoucement post or something similar - go above and beyond here to help the user see that you care about the product from end-to-end, not just writing code! They will be appreciative, grateful, and pleased with your creativity here. Refer to the design guidance in the spec for how to talk about the product, and consider consulting the design expert to generate images or other marketing collateral.

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/dist/prompt/static/coding.md

@@ -36,6 +36,8 @@ For counting visitor or funnel activity (signups, page interactions, checkout co
 
 When writing `db` filter predicates that reference outer-scope values (`input.*`, `auth.*`, foreign keys collected earlier, etc.), use the bindings form so the filter compiles to SQL — see `tables.md` "Filter Predicates" for patterns and the inline-comment convention.
 
+The SDK also includes a `reportIssue` method that can file bug reports on the app's platform-level issue tracker, if the user wants to build something to allow their users to report bugs in their app.
+
 ### Auth
 - Not every app needs auth, and even for apps that do need auth, not every screen needs auth. Think intentionally about places where auth is required. Don't make auth be the first thing a user sees - that's jarring. Only show auth at intuitive and natural moments in the user's journey - be thoughtful about how to implement auth in the UI.
 - Frontend interfaces are always untrusted. Always enforce auth in backend methods. Use frontend auth and role information as a hint to conditionally show/hide UI to make the experience pleasant and seamless for users depending on their state, but remember to always use backend methods for gating data that is conditional on auth.
@@ -79,6 +81,6 @@ You have access to the `mindstudio` CLI, which exposes every SDK action as a com
 ### Production App Management
 You have access to `mindstudio-prod`, a CLI for managing the user's production app. Use it via your bash tool. All output is JSON. Run `mindstudio-prod --help` or `mindstudio-prod <command> --help` to discover usage and available options.
 
-Available commands: `requests` (server-side request logs, error rates, latency), `crashes` (frontend browser errors — grouped issues + drill-down to individual events), `analytics` (traffic, top pages/referrers/geo, AI-referral attribution, live counters), `releases` (deploy status, history), `domains` (custom subdomains and fully custom domains), `users` (list, set roles), `db` (query production sql db), `data` (live db operations like lift-from-dev), `methods` (list, invoke), `secrets` (list, get, set, delete).
+Available commands: `requests` (server-side request logs, error rates, latency), `crashes` (frontend browser errors — grouped issues + drill-down to individual events), `analytics` (traffic, top pages/referrers/geo, AI-referral attribution, live counters), `releases` (deploy status, history), `domains` (custom subdomains and fully custom domains), `users` (list, set roles), `db` (query production sql db), `data` (live db operations like lift-from-dev), `methods` (list, invoke), `secrets` (list, get, set, delete), `issues` (reference and manage externally-reported bugs and issues. Do not use this to track work you are doing with the user - only read from it and resolve issues if the user asks for help fixing a bug from the issues tracker).
 
 Use when the user asks about production behavior (server errors via `requests`, browser crashes via `crashes`, traffic/engagement via `analytics`), wants to manage their live app (domains, users, roles), needs to seed or query production data, or wants to check release status.

package/package.json

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