mindweave 2.2.1 → 2.3.0

package/dist/tools/editFile.js

@@ -1,183 +0,0 @@
-/**
- * editFile.ts — a surgical find-and-replace on one file.
- *
- * The workhorse mutating tool. It replaces an exact `old_string` with
- * `new_string`. Reliability comes from the tool REFUSING bad edits, not from the
- * model being careful — the three refusals below make the classic failure modes
- * (editing a file you never read, a stale/typo'd match, an ambiguous match)
- * structurally impossible:
- *
- *  - read-before-edit: the file must have been read this session, so the model's
- *    `old_string` is copied from real content, not imagined.
- *  - must-exist: zero matches errors instead of silently doing nothing, so the
- *    model learns its match was wrong.
- *  - unique-match: more than one match (without replace_all) errors and hands back
- *    WHERE the candidates are, so an edit never lands in the wrong place and the
- *    retry is informed rather than another guess.
- *
- * Matching is exact first, then line-trimmed — and stops there. It is deliberately not
- * a stack of ever-looser matchers: past a point, "looser" only means "more ways to edit
- * the wrong block", which is a corruption bug rather than a convenience. The reasoning,
- * and what is deliberately NOT implemented, lives in editCore.ts.
- * (Deciding *what* to change is the model's job; this tool only applies it.)
- */
-import { promises as fs } from "node:fs";
-import { recordWrite, relativize } from "./paths.js";
-import { editDetail, lineCount, magnitude, rangeLabel, withScope } from "./detail.js";
-import { applyEol } from "./eol.js";
-import { applyOneEdit } from "./editCore.js";
-import { prepareEditTarget, fail, failQuietly, errText } from "./editTarget.js";
-export const editFile = {
-    name: "edit_file",
-    readOnly: false,
-    // The old wording said `old_string` "must match the file's text", which undersold the
-    // matcher in a way that costs real work: matching is tiered, so indentation and line
-    // endings are already forgiven. A model told it needs the exact bytes re-reads whole
-    // files to get them and retries edits that would have applied. What the tiers do NOT
-    // forgive is stated just as plainly, because a matcher that sounds infinitely lenient
-    // invites the sloppy input that makes a wrong-place edit possible. See editCore.ts.
-    description: "Replace a string in a file with another. This is the DEFAULT editing tool: reach for " +
-        "it whenever you are changing one place in a file. Read the file first. " +
-        "`old_string` has to identify exactly ONE place, and it is matched on content rather " +
-        "than on formatting: if an exact match is not found, each line is compared with its " +
-        "leading and trailing whitespace ignored, and line endings are normalized on both " +
-        "sides. So you do not need to reproduce a file's exact indentation, and a CRLF file " +
-        "is not a problem. What is never forgiven is a skipped, reordered, or extra line. " +
-        "If `old_string` matches SEVERAL places the file is left untouched and you get the " +
-        "candidate locations back with surrounding context: pick one and include enough " +
-        "nearby lines to make it unique, or set `replace_all` to change every occurrence. " +
-        "If the SAME file needs changing in several separate places, use multi_edit instead " +
-        "of calling this repeatedly. Use write_file only to create a new file or replace one " +
-        "wholesale.",
-    parameters: {
-        type: "object",
-        additionalProperties: false,
-        required: ["path", "old_string", "new_string"],
-        properties: {
-            path: {
-                type: "string",
-                description: "Path to the file, absolute or relative to the working directory.",
-            },
-            old_string: {
-                type: "string",
-                description: "The exact text to replace. Include enough surrounding lines to make it unique.",
-            },
-            new_string: {
-                type: "string",
-                description: "The replacement text. Use an empty string to delete old_string.",
-            },
-            replace_all: {
-                type: "boolean",
-                description: "Replace every occurrence instead of requiring a unique match. Default false.",
-            },
-        },
-    },
-    async execute(args, ctx) {
-        const rawPath = typeof args.path === "string" ? args.path.trim() : "";
-        if (!rawPath)
-            return fail("`path` is required.");
-        if (typeof args.old_string !== "string" || args.old_string === "") {
-            return fail("`old_string` is required and must not be empty — it identifies the text to replace.");
-        }
-        if (typeof args.new_string !== "string") {
-            return fail("`new_string` is required (use an empty string to delete old_string).");
-        }
-        const oldString = args.old_string;
-        const newString = args.new_string;
-        const replaceAll = args.replace_all === true;
-        if (oldString === newString) {
-            return fail("`old_string` and `new_string` are identical — nothing to change.");
-        }
-        const target = await prepareEditTarget(ctx, rawPath, "editing");
-        if (!target.ok)
-            return target.error;
-        const { filePath, content, eol } = target;
-        // Match line-ending-agnostically. The file on disk may use CRLF (Windows)
-        // while the model's old_string — copied from text it was shown — uses LF; an
-        // exact byte match would then fail on every multi-line edit. Normalizing the
-        // CR the model can't see is a representation fix, not fuzzy matching: we still
-        // match whitespace and indentation exactly (handled in editCore). The file's
-        // own line endings are preserved on write.
-        const applied = applyOneEdit(content, { oldString, newString, replaceAll });
-        // A match that didn't land is the model's to correct — it gets the reason and the
-        // candidate locations, and retries. Not the user's business, so it stays off screen.
-        if (!applied.ok)
-            return failQuietly(`${applied.reason} (in ${rawPath}).`);
-        const { updated: updatedNorm, count, changeStart, changeEnd } = applied;
-        const updated = applyEol(updatedNorm, eol);
-        // Snapshot the pre-edit bytes for /undo before touching disk.
-        ctx.checkpoints?.backup(filePath, content, updated);
-        try {
-            await fs.writeFile(filePath, updated, "utf8");
-        }
-        catch (error) {
-            return fail(`could not write ${rawPath}: ${errText(error)}`);
-        }
-        // Still seen+touched this session — record the new state (with the edited region
-        // as this file's focus, so a large file localizes to it in the working set).
-        await recordWrite(ctx, filePath, {
-            start: charToLine(updatedNorm, Math.max(0, changeStart)) + 1,
-            end: charToLine(updatedNorm, changeEnd) + 1,
-        });
-        const shown = relativize(ctx, filePath);
-        const n = replaceAll ? count : 1;
-        const plural = n === 1 ? "" : "s";
-        // Hand back the changed region WITH fresh line numbers. This is what stops the
-        // model from re-reading the whole file after every edit (the loop that bloats a
-        // multi-edit task): it can target its next edit straight from this snippet.
-        const window = numberedWindow(updatedNorm, Math.max(0, changeStart), changeEnd);
-        const span = replaceAll && n > 1 ? ` (showing the first of ${n} sites)` : "";
-        // The scope of the change — WHERE and HOW MUCH — so the row shows more than a bare
-        // diff: the line range touched (or "N sites" for a spread replace_all) and ± lines.
-        const startLine = charToLine(updatedNorm, Math.max(0, changeStart)) + 1;
-        const endLine = charToLine(updatedNorm, changeEnd) + 1;
-        const removed = lineCount(oldString) * n;
-        const added = lineCount(newString) * n;
-        const scope = replaceAll && n > 1
-            ? `${n} sites · ${magnitude(removed, added)}`
-            : `${rangeLabel(startLine, endLine)} · ${magnitude(removed, added)}`;
-        return {
-            output: `Edited ${shown}: ${n} replacement${plural}.\n` +
-                `Updated region${span} — line-numbered so you can make further edits without re-reading:\n${window}`,
-            summary: `edited ${shown} · ${scope}`,
-            detail: withScope(scope, editDetail(oldString, newString)),
-        };
-    },
-};
-/**
- * Render the lines spanning [startChar, endChar] in `text`, plus `pad` lines of
- * context on each side, with 1-based right-aligned line numbers. Pure and indexed
- * on the normalized (LF) text, so it's independent of the file's real EOL. Bounded
- * by `maxLines` so a sweeping replace can't flood the result.
- */
-export function numberedWindow(text, startChar, endChar, pad = 4, maxLines = 30) {
-    const lines = text.split("\n");
-    const startLine = charToLine(text, startChar);
-    const endLine = charToLine(text, endChar);
-    const from = Math.max(0, startLine - pad);
-    let to = Math.min(lines.length - 1, endLine + pad);
-    let truncated = false;
-    if (to - from + 1 > maxLines) {
-        to = from + maxLines - 1;
-        truncated = true;
-    }
-    const width = String(to + 1).length;
-    const out = [];
-    for (let i = from; i <= to; i++) {
-        out.push(`${String(i + 1).padStart(width)}  ${lines[i] ?? ""}`);
-    }
-    if (truncated)
-        out.push("    … (region continues; re-read the file if you need the rest)");
-    return out.join("\n");
-}
-/** The 0-based line a character offset falls on (count of newlines before it). */
-export function charToLine(text, charIndex) {
-    let line = 0;
-    const limit = Math.min(charIndex, text.length);
-    for (let i = 0; i < limit; i++) {
-        if (text[i] === "\n")
-            line++;
-    }
-    return line;
-}
-//# sourceMappingURL=editFile.js.map

package/dist/tools/editFile.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"editFile.js","sourceRoot":"","sources":["../../src/tools/editFile.ts"],"names":[],"mappings":"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"}

package/dist/tools/multiEdit.js

@@ -1,168 +0,0 @@
-/**
- * multiEdit.ts — several edits to ONE file, in a single call, applied atomically.
- *
- * Why it exists: a real change to a file is often several small replacements in
- * different places. One call per replacement burns model turns and step budget and
- * re-invites the re-read-after-every-edit loop. multi_edit lands them together, and each
- * edit sees the result of the one before, so you can add a symbol and then edit around it.
- *
- * ── DELIBERATELY ONE FILE PER CALL ──────────────────────────────────────────────
- *
- * This tool briefly accepted edits across several files in one call, and that was
- * reverted on purpose. It worked, but the shape was wrong:
- *
- *  - BLAST RADIUS. Twelve edits across five files is one UI row, one merged diff, and
- *    one `/undo` unit. Per file, you get a row, a scoped diff and an undo point each,
- *    which is the difference between a change you can review and one you have to trust.
- *  - IT HID THE UNIT OF WORK. "Edit this file in three places" is a thing a person can
- *    check. "Edit the codebase" is not, and the tool should not encourage collapsing a
- *    whole task into one indivisible action.
- *
- * The cost is honest and worth stating: three files still mean three calls, so if the
- * second refuses, the first has already landed. What makes that acceptable is that the
- * refusals themselves became rare — matching now tolerates indentation drift, and an
- * ambiguous match reports WHERE the candidates are instead of leaving the model to guess
- * (see editCore.ts). The fix for half-applied refactors is fewer failures, not bigger
- * transactions.
- *
- * ATOMIC WITHIN THE FILE: edits are applied to an in-memory copy, and if any of them
- * fails to match, nothing is written and the offending edit is named. A file is never
- * left half-changed. It reuses the shared pre-edit gauntlet (read-before-edit, path
- * guards, forbidden-path approval) and the pure edit core, so its safety guarantees are
- * identical to edit_file's.
- */
-import { promises as fs } from "node:fs";
-import { recordWrite, relativize } from "./paths.js";
-import { applyEol } from "./eol.js";
-import { multiEditDetail, lineCount, magnitude, rangeLabel, withScope } from "./detail.js";
-import { applyEditSequence } from "./editCore.js";
-import { numberedWindow, charToLine } from "./editFile.js";
-import { prepareEditTarget, fail, failQuietly, errText } from "./editTarget.js";
-export const multiEdit = {
-    name: "multi_edit",
-    readOnly: false,
-    description: "Apply several string replacements to ONE file in a single call, in order. Use it when " +
-        "a single file needs changing in more than one place — say an import at the top, a call " +
-        "site in the middle, and a helper further down. For a single change to a file, use " +
-        "edit_file instead. For several files, make one multi_edit call PER FILE; do not try to " +
-        "cover more than one file in a call. Each `old_string` must match the file's text and be " +
-        "unique unless `replace_all` is set, and each edit sees the result of the previous ones. " +
-        "All-or-nothing: if any edit doesn't match, the file is left completely untouched. Read " +
-        "the file first.",
-    parameters: {
-        type: "object",
-        additionalProperties: false,
-        required: ["path", "edits"],
-        properties: {
-            path: {
-                type: "string",
-                description: "The one file every edit in this call applies to, absolute or relative to the working directory.",
-            },
-            edits: {
-                type: "array",
-                description: "The replacements to apply to that file, in order.",
-                items: {
-                    type: "object",
-                    additionalProperties: false,
-                    required: ["old_string", "new_string"],
-                    properties: {
-                        old_string: {
-                            type: "string",
-                            description: "The text to replace. Include enough surrounding lines to make it unique.",
-                        },
-                        new_string: {
-                            type: "string",
-                            description: "The replacement text. Use an empty string to delete old_string.",
-                        },
-                        replace_all: {
-                            type: "boolean",
-                            description: "Replace every occurrence instead of requiring a unique match. Use it when the same change applies " +
-                                "to all of them — e.g. deleting a duplicated helper that appears twice in this file. Default false.",
-                        },
-                    },
-                },
-            },
-        },
-    },
-    async execute(args, ctx) {
-        const rawPath = typeof args.path === "string" ? args.path.trim() : "";
-        if (!rawPath)
-            return fail("`path` is required — it names the one file this call edits.");
-        if (!Array.isArray(args.edits) || args.edits.length === 0) {
-            return fail("`edits` is required and must be a non-empty array of {old_string, new_string} edits.");
-        }
-        // Validate and normalize each edit up front, so a bad shape is reported before we
-        // touch the file.
-        const ops = [];
-        for (let i = 0; i < args.edits.length; i++) {
-            const e = args.edits[i];
-            if (!e || typeof e !== "object")
-                return fail(`edit #${i + 1} is not an object.`);
-            // A per-edit path is refused rather than ignored. Silently dropping it would apply
-            // the edit to the WRONG file — the top-level one — which is the worst outcome
-            // available here, so say what to do instead.
-            if (typeof e.path === "string" && e.path.trim() && e.path.trim() !== rawPath) {
-                return fail(`edit #${i + 1} names a different file (${e.path.trim()}). One multi_edit call edits one file: ` +
-                    `make a separate call for each file you need to change.`);
-            }
-            if (typeof e.old_string !== "string" || e.old_string === "") {
-                return fail(`edit #${i + 1}: \`old_string\` is required and must not be empty.`);
-            }
-            if (typeof e.new_string !== "string") {
-                return fail(`edit #${i + 1}: \`new_string\` is required (use an empty string to delete).`);
-            }
-            ops.push({ oldString: e.old_string, newString: e.new_string, replaceAll: e.replace_all === true });
-        }
-        const target = await prepareEditTarget(ctx, rawPath, "editing");
-        if (!target.ok)
-            return target.error;
-        const { filePath, content, eol } = target;
-        // Apply the whole sequence to an in-memory copy. Atomic: a failure names the
-        // offending edit and writes nothing.
-        const seq = applyEditSequence(content, ops);
-        if (!seq.ok) {
-            // The reason may already end in a sentence (the ambiguity report does), so don't
-            // staple a second full stop onto it.
-            const reason = /[.!?]$/.test(seq.reason) ? seq.reason : `${seq.reason}.`;
-            // Quiet: the model has the reason and the candidate locations and fixes its own
-            // aim. Nothing reached disk, so there is nothing for the user to act on.
-            return failQuietly(`edit #${seq.index + 1} could not be applied to ${rawPath}: ${reason} No changes were written.`);
-        }
-        const updated = applyEol(seq.updated, eol);
-        // Snapshot the pre-edit bytes for /undo before touching disk.
-        ctx.checkpoints?.backup(filePath, content, updated);
-        try {
-            await fs.writeFile(filePath, updated, "utf8");
-        }
-        catch (error) {
-            return fail(`could not write ${rawPath}: ${errText(error)}`);
-        }
-        await recordWrite(ctx, filePath, {
-            start: charToLine(seq.updated, seq.spanStart) + 1,
-            end: charToLine(seq.updated, seq.spanEnd) + 1,
-        });
-        const shown = relativize(ctx, filePath);
-        const nEdits = ops.length;
-        // One numbered window spanning from the first change to the last, so the model can
-        // keep working from the result without re-reading the file.
-        const window = numberedWindow(seq.updated, seq.spanStart, seq.spanEnd);
-        // Scope: how many edits, the line span they cover, and the ± lines across them — so a
-        // multi-part change reads as "3 edits · L120-420 · −18 +40", not just a diff.
-        const startLine = charToLine(seq.updated, seq.spanStart) + 1;
-        const endLine = charToLine(seq.updated, seq.spanEnd) + 1;
-        let removed = 0;
-        let added = 0;
-        for (const op of ops) {
-            removed += lineCount(op.oldString);
-            added += lineCount(op.newString);
-        }
-        const scope = `${nEdits} edits · ${rangeLabel(startLine, endLine)} · ${magnitude(removed, added)}`;
-        return {
-            output: `Edited ${shown}: ${nEdits} edits, ${seq.total} replacement${seq.total === 1 ? "" : "s"} total.\n` +
-                `Changed region — line-numbered so you can make further edits without re-reading:\n${window}`,
-            summary: `edited ${shown} · ${scope}`,
-            detail: withScope(scope, multiEditDetail(ops)),
-        };
-    },
-};
-//# sourceMappingURL=multiEdit.js.map

package/dist/tools/multiEdit.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"multiEdit.js","sourceRoot":"","sources":["../../src/tools/multiEdit.ts"],"names":[],"mappings":"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"}