plugsuits 1.0.0

package/dist/tools/modify/delete-file.test.js

@@ -0,0 +1,136 @@
+import { afterAll, beforeAll, describe, expect, it } from "bun:test";
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, symlinkSync, writeFileSync, } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { executeDeleteFile } from "./delete-file";
+describe("executeDeleteFile", () => {
+    let tempDir;
+    beforeAll(() => {
+        tempDir = mkdtempSync(join(tmpdir(), "delete-file-test-"));
+    });
+    afterAll(() => {
+        if (existsSync(tempDir)) {
+            rmSync(tempDir, { recursive: true });
+        }
+    });
+    describe("file deletion", () => {
+        it("deletes file and returns metadata", async () => {
+            const testFile = join(tempDir, "to-delete.txt");
+            writeFileSync(testFile, "content to delete");
+            const result = await executeDeleteFile({ path: testFile }, { rootDir: tempDir });
+            expect(result).toContain("OK - deleted file: to-delete.txt");
+            expect(result).toContain(`path: ${testFile}`);
+            expect(result).toContain("bytes:");
+            expect(result).toContain("last_modified:");
+            expect(existsSync(testFile)).toBe(false);
+        });
+        it("includes correct byte size in response", async () => {
+            const testFile = join(tempDir, "sized.txt");
+            const content = "12345";
+            writeFileSync(testFile, content);
+            const result = await executeDeleteFile({ path: testFile }, { rootDir: tempDir });
+            expect(result).toContain("bytes: 5");
+        });
+    });
+    describe("directory deletion", () => {
+        it("throws error for directory without recursive flag", async () => {
+            const testDir = join(tempDir, "dir-no-recursive");
+            mkdirSync(testDir);
+            await expect(executeDeleteFile({ path: testDir }, { rootDir: tempDir })).rejects.toThrow("recursive: true");
+            expect(existsSync(testDir)).toBe(true);
+        });
+        it("deletes empty directory with recursive flag", async () => {
+            const testDir = join(tempDir, "empty-dir");
+            mkdirSync(testDir);
+            const result = await executeDeleteFile({ path: testDir, recursive: true }, { rootDir: tempDir });
+            expect(result).toContain("OK - deleted directory: empty-dir");
+            expect(result).toContain(`path: ${testDir}`);
+            expect(result).toContain("last_modified:");
+            expect(existsSync(testDir)).toBe(false);
+        });
+        it("deletes non-empty directory with recursive flag", async () => {
+            const testDir = join(tempDir, "non-empty-dir");
+            mkdirSync(testDir);
+            writeFileSync(join(testDir, "file1.txt"), "content1");
+            writeFileSync(join(testDir, "file2.txt"), "content2");
+            mkdirSync(join(testDir, "subdir"));
+            writeFileSync(join(testDir, "subdir", "nested.txt"), "nested");
+            const result = await executeDeleteFile({ path: testDir, recursive: true }, { rootDir: tempDir });
+            expect(result).toContain("OK - deleted directory: non-empty-dir");
+            expect(existsSync(testDir)).toBe(false);
+        });
+    });
+    describe("ignore_missing option", () => {
+        it("throws error for non-existent file by default", async () => {
+            const nonExistent = join(tempDir, "does-not-exist.txt");
+            await expect(executeDeleteFile({ path: nonExistent }, { rootDir: tempDir })).rejects.toThrow();
+        });
+        it("returns skip message when ignore_missing is true", async () => {
+            const nonExistent = join(tempDir, "also-does-not-exist.txt");
+            const result = await executeDeleteFile({ path: nonExistent, ignore_missing: true }, { rootDir: tempDir });
+            expect(result).toContain("SKIPPED");
+            expect(result).toContain("file does not exist");
+            expect(result).toContain(nonExistent);
+        });
+    });
+    describe("edge cases", () => {
+        it("handles file with special characters in name", async () => {
+            const testFile = join(tempDir, "file with spaces.txt");
+            writeFileSync(testFile, "content");
+            const result = await executeDeleteFile({ path: testFile }, { rootDir: tempDir });
+            expect(result).toContain("OK - deleted file: file with spaces.txt");
+            expect(existsSync(testFile)).toBe(false);
+        });
+        it("handles empty file", async () => {
+            const testFile = join(tempDir, "empty-file.txt");
+            writeFileSync(testFile, "");
+            const result = await executeDeleteFile({ path: testFile }, { rootDir: tempDir });
+            expect(result).toContain("OK - deleted file: empty-file.txt");
+            expect(result).toContain("bytes: 0");
+            expect(existsSync(testFile)).toBe(false);
+        });
+    });
+    describe("file safety (C-1, C-2)", () => {
+        it("C-1: blocks path traversal via .. segments", async () => {
+            const traversalPath = join(tempDir, "..", "..", "etc", "passwd");
+            await expect(executeDeleteFile({ path: traversalPath }, { rootDir: tempDir })).rejects.toThrow(/[Pp]ath traversal blocked/);
+        });
+        it("C-1: blocks absolute paths outside project root", async () => {
+            await expect(executeDeleteFile({ path: "/tmp/outside-project.txt" }, { rootDir: tempDir })).rejects.toThrow(/[Pp]ath traversal blocked|outside/);
+        });
+        it("C-2: blocks deletion of symlinks", async () => {
+            const realFile = join(tempDir, "real-delete-target.txt");
+            writeFileSync(realFile, "real content");
+            const symlinkPath = join(tempDir, "symlink-to-delete.txt");
+            symlinkSync(realFile, symlinkPath);
+            await expect(executeDeleteFile({ path: symlinkPath }, { rootDir: tempDir })).rejects.toThrow(/symlink/i);
+            // Both the symlink and the real file should still exist
+            expect(existsSync(symlinkPath)).toBe(true);
+            expect(existsSync(realFile)).toBe(true);
+            expect(readFileSync(realFile, "utf-8")).toBe("real content");
+        });
+        it("C-2: blocks deletion of symlinks pointing outside root", async () => {
+            const outsideDir = mkdtempSync(join(tmpdir(), "outside-delete-"));
+            const outsideFile = join(outsideDir, "secret.txt");
+            writeFileSync(outsideFile, "secret data");
+            const symlinkPath = join(tempDir, "escape-delete-link.txt");
+            symlinkSync(outsideFile, symlinkPath);
+            try {
+                await expect(executeDeleteFile({ path: symlinkPath }, { rootDir: tempDir })).rejects.toThrow(/symlink/i);
+                expect(existsSync(outsideFile)).toBe(true);
+                expect(readFileSync(outsideFile, "utf-8")).toBe("secret data");
+            }
+            finally {
+                rmSync(outsideDir, { recursive: true });
+            }
+        });
+        it("allows deletion within project root (normal operation)", async () => {
+            const safeFile = join(tempDir, "safe-to-delete.txt");
+            writeFileSync(safeFile, "deletable content");
+            const result = await executeDeleteFile({ path: safeFile }, { rootDir: tempDir });
+            expect(result).toContain("OK - deleted file: safe-to-delete.txt");
+            expect(existsSync(safeFile)).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=delete-file.test.js.map

package/dist/tools/modify/delete-file.test.js.map

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

package/dist/tools/modify/edit-file-diagnostics.d.ts

@@ -0,0 +1,17 @@
+export declare const ESCALATION_THRESHOLD = 2;
+export declare const ESCALATION_EXAMPLE_THRESHOLD = 4;
+export declare const ESCALATION_BAIL_THRESHOLD = 6;
+export declare const FILE_BAIL_THRESHOLD = 10;
+export declare function trackMissingLinesFailure(pos: string | undefined, filePath?: string): number;
+export declare function resetMissingLinesFailures(): void;
+export declare function getMissingLinesFailureCount(pos: string): number;
+export declare function getFileFailureCount(filePath: string): number;
+export declare function suggestLineForHash(raw: string, fileLines: string[]): string | null;
+export declare function diagnoseAnchorFailure(raw: string, fieldName: string, fileLines?: string[]): string;
+export declare function diagnoseMissingLines(pos: string | undefined): string;
+export declare function getEscalatedHint(pos: string | undefined, fileLines: string[], failureCount: number): string | null;
+export declare function buildEscalationBailMessage(edits: Array<{
+    pos?: string;
+    end?: string;
+}>, filePath: string, fileLines: string[]): string | null;
+//# sourceMappingURL=edit-file-diagnostics.d.ts.map

package/dist/tools/modify/edit-file-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-file-diagnostics.d.ts","sourceRoot":"","sources":["../../../src/tools/modify/edit-file-diagnostics.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAYR;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EAAE,GAClB,MAAM,GAAG,IAAI,CAYf;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,MAAM,CA2BR;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CA+BpE;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,SAAS,EAAE,MAAM,EAAE,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,GAAG,IAAI,CAoBf;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,KAAK,CAAC;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAC5C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EAAE,GAClB,MAAM,GAAG,IAAI,CAgDf"}

package/dist/tools/modify/edit-file-diagnostics.js

@@ -0,0 +1,157 @@
+import { computeLineHash, tryParseLineTag } from "../utils/hashline";
+const ANCHOR_HASH_EXTRACT_REGEX = /#([ZPMQVRWSNKTXJBYH]{2})/i;
+const NUMERIC_LINE_PREFIX_REGEX = /^\d+$/;
+const HASHLINE_ALPHABET_PREFIX_REGEX = /^[ZPMQVRWSNKTXJBYH]{2}$/i;
+const ANCHOR_PREFIX_REGEX = /^\s*(\d+\s*#\s*[ZPMQVRWSNKTXJBYH]{2})/i;
+const HASH_SPACE_REGEX = /\s*#\s*/;
+const KEY_VALUE_IN_POS_REGEX = /['"]lines['"\s]*:/;
+const XML_MARKUP_IN_POS_REGEX = /<\/?parameter/;
+const POS_DISPLAY_MAX_LENGTH = 80;
+const missingLinesFailures = new Map();
+const missingLinesFileFailures = new Map();
+export const ESCALATION_THRESHOLD = 2;
+export const ESCALATION_EXAMPLE_THRESHOLD = 4;
+export const ESCALATION_BAIL_THRESHOLD = 6;
+export const FILE_BAIL_THRESHOLD = 10;
+export function trackMissingLinesFailure(pos, filePath) {
+    if (filePath) {
+        const fileCount = (missingLinesFileFailures.get(filePath) ?? 0) + 1;
+        missingLinesFileFailures.set(filePath, fileCount);
+    }
+    if (!pos) {
+        return 1;
+    }
+    const key = pos.trim();
+    const count = (missingLinesFailures.get(key) ?? 0) + 1;
+    missingLinesFailures.set(key, count);
+    return count;
+}
+export function resetMissingLinesFailures() {
+    missingLinesFailures.clear();
+    missingLinesFileFailures.clear();
+}
+export function getMissingLinesFailureCount(pos) {
+    return missingLinesFailures.get(pos) ?? 0;
+}
+export function getFileFailureCount(filePath) {
+    return missingLinesFileFailures.get(filePath) ?? 0;
+}
+export function suggestLineForHash(raw, fileLines) {
+    const hashMatch = raw.match(ANCHOR_HASH_EXTRACT_REGEX);
+    if (!hashMatch) {
+        return null;
+    }
+    const hash = hashMatch[1].toUpperCase();
+    for (let i = 0; i < fileLines.length; i += 1) {
+        if (computeLineHash(i + 1, fileLines[i] ?? "") === hash) {
+            return `Did you mean "${i + 1}#${hash}"?`;
+        }
+    }
+    return null;
+}
+export function diagnoseAnchorFailure(raw, fieldName, fileLines) {
+    const hashIdx = raw.indexOf("#");
+    let message;
+    if (hashIdx > 0) {
+        const prefix = raw.slice(0, hashIdx).trim();
+        const suffix = raw.slice(hashIdx + 1).trim();
+        if (!NUMERIC_LINE_PREFIX_REGEX.test(prefix)) {
+            message = `${fieldName} "${raw}": "${prefix}" is not a line number. Use the actual line number from read_file output.`;
+        }
+        else if (HASHLINE_ALPHABET_PREFIX_REGEX.test(suffix)) {
+            message = `${fieldName} "${raw}" is not a valid {line_number}#{hash_id} anchor.`;
+        }
+        else {
+            message = `${fieldName} "${raw}": hash portion "${suffix}" is not valid. Hash must be 2 characters from the hashline alphabet.`;
+        }
+    }
+    else {
+        message = `${fieldName} "${raw}" is not a valid {line_number}#{hash_id} anchor — missing # separator.`;
+    }
+    if (fileLines && fileLines.length > 0) {
+        const hint = suggestLineForHash(raw, fileLines);
+        if (hint) {
+            message += ` ${hint}`;
+        }
+    }
+    return message;
+}
+export function diagnoseMissingLines(pos) {
+    const base = "replace requires explicit 'lines' field.";
+    if (!pos || pos.trim().length === 0) {
+        return base;
+    }
+    const truncated = pos.length > POS_DISPLAY_MAX_LENGTH
+        ? `${pos.slice(0, POS_DISPLAY_MAX_LENGTH - 3)}...`
+        : pos;
+    if (KEY_VALUE_IN_POS_REGEX.test(pos)) {
+        return `${base} Detected key-value syntax in pos — 'pos' and 'lines' must be separate JSON fields.`;
+    }
+    if (XML_MARKUP_IN_POS_REGEX.test(pos)) {
+        return `${base} Detected XML markup in pos — use JSON fields: pos for anchor, lines for content.`;
+    }
+    const anchorMatch = pos.match(ANCHOR_PREFIX_REGEX);
+    if (anchorMatch) {
+        const anchorText = anchorMatch[1].replace(HASH_SPACE_REGEX, "#");
+        const rest = pos.slice(anchorMatch[0].length);
+        if (rest.trim().length > 0) {
+            return `${base} pos contains content after anchor '${anchorText}' — move replacement text to 'lines'.`;
+        }
+        return `${base} Add 'lines' with the replacement content for anchor '${anchorText}'.`;
+    }
+    return `${base} pos should contain only a {line_number}#{hash_id} anchor, not content. Got: "${truncated}".`;
+}
+export function getEscalatedHint(pos, fileLines, failureCount) {
+    if (!pos || fileLines.length === 0) {
+        return null;
+    }
+    const parsed = tryParseLineTag(pos);
+    if (!parsed) {
+        return null;
+    }
+    const lineIndex = parsed.line - 1;
+    if (lineIndex < 0 || lineIndex >= fileLines.length) {
+        return null;
+    }
+    const content = fileLines[lineIndex];
+    const anchor = `${parsed.line}#${parsed.hash}`;
+    if (failureCount >= ESCALATION_EXAMPLE_THRESHOLD) {
+        return `STOP REPEATING (attempt ${failureCount}). You MUST include 'lines' as a separate JSON field. Correct format: {"op":"replace","pos":"${anchor}","lines":["your replacement text"]}. Current line ${parsed.line} contains: '${content}'.`;
+    }
+    return `Line ${parsed.line} currently contains '${content}'. Set lines to the replacement content.`;
+}
+export function buildEscalationBailMessage(edits, filePath, fileLines) {
+    const anchorBail = edits.some((e) => {
+        const pos = e.pos?.trim();
+        return pos && getMissingLinesFailureCount(pos) >= ESCALATION_BAIL_THRESHOLD;
+    });
+    const fileBail = getFileFailureCount(filePath) >= FILE_BAIL_THRESHOLD;
+    if (!(anchorBail || fileBail)) {
+        return null;
+    }
+    const failingEdit = edits.find((e) => {
+        const pos = e.pos?.trim();
+        return (pos && getMissingLinesFailureCount(pos) >= ESCALATION_BAIL_THRESHOLD);
+    }) ?? edits.find((e) => e.pos?.trim());
+    const anchor = failingEdit?.pos?.trim() ?? "";
+    const parsedTag = tryParseLineTag(anchor);
+    const lineContent = parsedTag && fileLines[parsedTag.line - 1];
+    const anchorFailCount = getMissingLinesFailureCount(anchor);
+    const fileFailCount = getFileFailureCount(filePath);
+    const failCount = Math.max(anchorFailCount, fileFailCount);
+    const parts = [
+        `⚠️ edit_file: NOT APPLIED (attempt ${failCount}) — 'lines' field is missing.`,
+        "",
+        `Your input: {"op": "replace", "pos": "${anchor}"}`,
+        `The file ${filePath} was NOT changed.`,
+        "",
+        `To replace this line, you MUST include 'lines' as a separate JSON field:`,
+        `  {"op": "replace", "pos": "${anchor}", "lines": ["your new content here"]}`,
+    ];
+    if (lineContent !== undefined && lineContent !== null) {
+        parts.push("", `Line ${parsedTag?.line} currently contains: "${lineContent}"`);
+    }
+    parts.push("", `To delete this line: {"op": "replace", "pos": "${anchor}", "lines": []}`, "Alternatively, use write_file to replace the entire file content.");
+    return parts.join("\n");
+}
+//# sourceMappingURL=edit-file-diagnostics.js.map

package/dist/tools/modify/edit-file-diagnostics.js.map

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

package/dist/tools/modify/edit-file-repair.d.ts

@@ -0,0 +1,13 @@
+export interface HashlineToolEdit {
+    end?: string;
+    lines?: string[] | string | null;
+    op: "append" | "prepend" | "replace";
+    pos?: string;
+}
+export interface RepairResult {
+    edit: HashlineToolEdit;
+    warnings: string[];
+}
+export declare function assertSingleLineAnchor(anchor: string | undefined, fieldName: "pos" | "end"): void;
+export declare function repairMalformedEdit(edit: HashlineToolEdit): RepairResult;
+//# sourceMappingURL=edit-file-repair.d.ts.map

package/dist/tools/modify/edit-file-repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-file-repair.d.ts","sourceRoot":"","sources":["../../../src/tools/modify/edit-file-repair.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC;IACjC,EAAE,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,SAAS,EAAE,KAAK,GAAG,KAAK,GACvB,IAAI,CAUN;AA4ED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAkExE"}

package/dist/tools/modify/edit-file-repair.js

@@ -0,0 +1,135 @@
+const SINGLE_LINE_SPLIT_REGEX = /\r?\n/;
+const ANCHOR_PREFIX_REGEX = /^\s*(\d+\s*#\s*[ZPMQVRWSNKTXJBYH]{2})/i;
+const EMBEDDED_END_REGEX = /['"']?end['"']?\s*[:=]\s*['"']?(\d+\s*#\s*[ZPMQVRWSNKTXJBYH]{2})['"']?/i;
+const NULL_VALUE_REGEX = /^null\s*[})]?\s*$/;
+const ARRAY_VALUE_REGEX = /^\[([^\]]*)\]/;
+const COMMA_SPLIT_REGEX = /,\s*/;
+const QUOTE_STRIP_REGEX = /^['"]|['"]$/g;
+const STRING_VALUE_REGEX = /^['"](.*)['"]/;
+const KV_LINES_REGEX = /['"]?lines['"]?\s*[:=]\s*(.+?)\s*[})]?\s*$/;
+const QS_LINES_REGEX = /[&?]\s*lines\s*[:=]\s*(.+?)\s*$/;
+const HASH_NORMALIZE_REGEX = /\s*#\s*/;
+const LEADING_SEPARATOR_REGEX = /^[|=%:,;]\s*/;
+const GARBAGE_CONTENT_REGEX = /^['"]?[\]})>]|<\/|<\w+>|^\s*}/;
+export function assertSingleLineAnchor(anchor, fieldName) {
+    if (!anchor) {
+        return;
+    }
+    if (anchor.includes("\n") || anchor.includes("\r")) {
+        const lineCount = anchor.split(SINGLE_LINE_SPLIT_REGEX).length;
+        throw new Error(`${fieldName} contains ${lineCount} lines — must be a single-line {line_number}#{hash_id} anchor.`);
+    }
+}
+function tryParseEmbeddedValue(raw) {
+    const trimmed = raw.trim();
+    if (NULL_VALUE_REGEX.test(trimmed)) {
+        return null;
+    }
+    const arrayMatch = trimmed.match(ARRAY_VALUE_REGEX);
+    if (arrayMatch) {
+        const inner = arrayMatch[1].trim();
+        if (inner.length === 0) {
+            return [];
+        }
+        const elements = inner.split(COMMA_SPLIT_REGEX).map((el) => {
+            const s = el.trim();
+            const unquoted = s.replace(QUOTE_STRIP_REGEX, "");
+            return unquoted;
+        });
+        return elements;
+    }
+    const stringMatch = trimmed.match(STRING_VALUE_REGEX);
+    if (stringMatch) {
+        return [stringMatch[1]];
+    }
+    return undefined;
+}
+function tryExtractEmbeddedLines(posAfterAnchor) {
+    const kvMatch = posAfterAnchor.match(KV_LINES_REGEX);
+    if (kvMatch) {
+        return tryParseEmbeddedValue(kvMatch[1]);
+    }
+    const qsMatch = posAfterAnchor.match(QS_LINES_REGEX);
+    if (qsMatch) {
+        return tryParseEmbeddedValue(qsMatch[1]);
+    }
+    return undefined;
+}
+function tryExtractEmbeddedEnd(rest) {
+    const endMatch = rest.match(EMBEDDED_END_REGEX);
+    if (!endMatch) {
+        return undefined;
+    }
+    return endMatch[1].replace(HASH_NORMALIZE_REGEX, "#");
+}
+function repairAnchorField(raw) {
+    if (!raw) {
+        return null;
+    }
+    if (raw.includes("\n") || raw.includes("\r")) {
+        return null;
+    }
+    const anchorMatch = raw.match(ANCHOR_PREFIX_REGEX);
+    if (!anchorMatch) {
+        return null;
+    }
+    const cleanAnchor = anchorMatch[1].replace(HASH_NORMALIZE_REGEX, "#");
+    const rest = raw.slice(anchorMatch[0].length);
+    if (rest.trim().length === 0) {
+        return null;
+    }
+    return { cleanAnchor, rest };
+}
+export function repairMalformedEdit(edit) {
+    const warnings = [];
+    let repairedPos = edit.pos;
+    let repairedEnd = edit.end;
+    let repairedLines = edit.lines;
+    const posRepair = repairAnchorField(edit.pos);
+    if (posRepair) {
+        repairedPos = posRepair.cleanAnchor;
+        warnings.push(`Auto-repaired pos: extracted anchor '${posRepair.cleanAnchor}' from malformed value.`);
+        if (edit.lines === undefined) {
+            const extractedLines = tryExtractEmbeddedLines(posRepair.rest);
+            if (extractedLines !== undefined) {
+                repairedLines = extractedLines;
+                warnings.push("Auto-repaired lines: extracted embedded content from pos field.");
+            }
+            else {
+                const plainContent = posRepair.rest
+                    .replace(LEADING_SEPARATOR_REGEX, "")
+                    .trim();
+                const looksLikeGarbage = GARBAGE_CONTENT_REGEX.test(plainContent);
+                if (plainContent.length > 0 && !looksLikeGarbage) {
+                    repairedLines = plainContent.split("\n");
+                    warnings.push(`Auto-repaired lines: extracted trailing content '${plainContent.slice(0, 60)}' from pos as replacement text.`);
+                }
+            }
+        }
+    }
+    const endRepair = repairAnchorField(edit.end);
+    if (endRepair) {
+        repairedEnd = endRepair.cleanAnchor;
+        warnings.push(`Auto-repaired end: extracted anchor '${endRepair.cleanAnchor}' from malformed value.`);
+    }
+    if (repairedEnd === undefined && posRepair) {
+        const extractedEnd = tryExtractEmbeddedEnd(posRepair.rest);
+        if (extractedEnd) {
+            repairedEnd = extractedEnd;
+            warnings.push(`Auto-repaired end: extracted anchor '${extractedEnd}' from embedded content in pos.`);
+        }
+    }
+    if (warnings.length === 0) {
+        return { edit, warnings };
+    }
+    return {
+        edit: {
+            ...edit,
+            pos: repairedPos,
+            end: repairedEnd,
+            lines: repairedLines,
+        },
+        warnings,
+    };
+}
+//# sourceMappingURL=edit-file-repair.js.map

package/dist/tools/modify/edit-file-repair.js.map

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

package/dist/tools/modify/edit-file-stress.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=edit-file-stress.test.d.ts.map

package/dist/tools/modify/edit-file-stress.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-file-stress.test.d.ts","sourceRoot":"","sources":["../../../src/tools/modify/edit-file-stress.test.ts"],"names":[],"mappings":""}