@osovv/vv-opencode 0.19.0 → 0.24.0

package/dist/plugins/hashline-edit/index.js

@@ -0,0 +1,246 @@
+// FILE: src/plugins/hashline-edit/index.ts
+// VERSION: 0.1.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Override OpenCode's default `edit` tool with a hash-anchored edit implementation and hash-aware read output.
+//   SCOPE: Hashline-backed edit tool registration, read-output transformation, anchor validation, file mutation execution, and success metadata emission.
+//   DEPENDS: [@opencode-ai/plugin, src/plugins/hashline-edit/edit-operations.ts, src/plugins/hashline-edit/file-text-canonicalization.ts, src/plugins/hashline-edit/hash-computation.ts, src/plugins/hashline-edit/normalize-edits.ts, src/plugins/hashline-edit/tool-description.ts, src/plugins/hashline-edit/validation.ts]
+//   LINKS: [M-PLUGIN-HASHLINE-EDIT]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   HashlineEditPlugin - Registers the hash-anchored `edit` tool override and post-read output enhancer.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [v0.1.0 - Added a default-on hash-anchored edit override that rewrites Read output to `line#hash|content` and rejects stale anchors on edit.]
+// END_CHANGE_SUMMARY
+import { tool } from "@opencode-ai/plugin";
+import { applyHashlineEditsWithReport } from "./edit-operations.js";
+import { canonicalizeFileText, restoreFileText } from "./file-text-canonicalization.js";
+import { computeLineHash } from "./hash-computation.js";
+import { normalizeHashlineEdits } from "./normalize-edits.js";
+import { HASHLINE_EDIT_DESCRIPTION } from "./tool-description.js";
+import { HashlineMismatchError } from "./validation.js";
+const z = tool.schema;
+const CONTENT_OPEN_TAG = "<content>";
+const CONTENT_CLOSE_TAG = "</content>";
+const FILE_OPEN_TAG = "<file>";
+const FILE_CLOSE_TAG = "</file>";
+const OPENCODE_LINE_TRUNCATION_SUFFIX = "... (line truncated to 2000 chars)";
+const COLON_READ_LINE_PATTERN = /^\s*(\d+): ?(.*)$/;
+const PIPE_READ_LINE_PATTERN = /^\s*(\d+)\| ?(.*)$/;
+function canCreateFromMissingFile(edits) {
+    if (edits.length === 0) {
+        return false;
+    }
+    return edits.every((edit) => (edit.op === "append" || edit.op === "prepend") && edit.pos === undefined);
+}
+function findFirstChangedLine(beforeContent, afterContent) {
+    const beforeLines = beforeContent.split("\n");
+    const afterLines = afterContent.split("\n");
+    const maxLength = Math.max(beforeLines.length, afterLines.length);
+    for (let index = 0; index < maxLength; index += 1) {
+        if ((beforeLines[index] ?? "") !== (afterLines[index] ?? "")) {
+            return index + 1;
+        }
+    }
+    return undefined;
+}
+function publishSuccessMetadata(args) {
+    args.context.metadata({
+        title: args.filePath,
+        metadata: {
+            filePath: args.filePath,
+            path: args.filePath,
+            file: args.filePath,
+            noopEdits: args.noopEdits,
+            deduplicatedEdits: args.deduplicatedEdits,
+            firstChangedLine: findFirstChangedLine(args.beforeContent, args.afterContent),
+            filediff: {
+                file: args.filePath,
+                path: args.filePath,
+                filePath: args.filePath,
+                before: args.beforeContent,
+                after: args.afterContent,
+            },
+        },
+    });
+}
+function isReadTool(toolName) {
+    return toolName.toLowerCase() === "read";
+}
+function isTextFileOutput(output) {
+    const firstLine = output.split("\n")[0] ?? "";
+    return COLON_READ_LINE_PATTERN.test(firstLine) || PIPE_READ_LINE_PATTERN.test(firstLine);
+}
+function parseReadLine(line) {
+    const colonMatch = COLON_READ_LINE_PATTERN.exec(line);
+    if (colonMatch) {
+        return {
+            lineNumber: Number.parseInt(colonMatch[1] ?? "0", 10),
+            content: colonMatch[2] ?? "",
+        };
+    }
+    const pipeMatch = PIPE_READ_LINE_PATTERN.exec(line);
+    if (pipeMatch) {
+        return {
+            lineNumber: Number.parseInt(pipeMatch[1] ?? "0", 10),
+            content: pipeMatch[2] ?? "",
+        };
+    }
+    return null;
+}
+function transformReadLine(line) {
+    const parsed = parseReadLine(line);
+    if (!parsed) {
+        return line;
+    }
+    if (parsed.content.endsWith(OPENCODE_LINE_TRUNCATION_SUFFIX)) {
+        return line;
+    }
+    return `${parsed.lineNumber}#${computeLineHash(parsed.lineNumber, parsed.content)}|${parsed.content}`;
+}
+function transformReadOutput(output) {
+    if (!output) {
+        return output;
+    }
+    const lines = output.split("\n");
+    const contentStart = lines.findIndex((line) => line === CONTENT_OPEN_TAG || line.startsWith(CONTENT_OPEN_TAG));
+    const contentEnd = lines.indexOf(CONTENT_CLOSE_TAG);
+    const fileStart = lines.findIndex((line) => line === FILE_OPEN_TAG || line.startsWith(FILE_OPEN_TAG));
+    const fileEnd = lines.indexOf(FILE_CLOSE_TAG);
+    const blockStart = contentStart !== -1 ? contentStart : fileStart;
+    const blockEnd = contentStart !== -1 ? contentEnd : fileEnd;
+    const openTag = contentStart !== -1 ? CONTENT_OPEN_TAG : FILE_OPEN_TAG;
+    if (blockStart !== -1 && blockEnd !== -1 && blockEnd > blockStart) {
+        const openLine = lines[blockStart] ?? "";
+        const inlineFirst = openLine.startsWith(openTag) && openLine !== openTag ? openLine.slice(openTag.length) : null;
+        const fileLines = inlineFirst !== null
+            ? [inlineFirst, ...lines.slice(blockStart + 1, blockEnd)]
+            : lines.slice(blockStart + 1, blockEnd);
+        if (!isTextFileOutput(fileLines[0] ?? "")) {
+            return output;
+        }
+        const result = [];
+        for (const line of fileLines) {
+            if (!parseReadLine(line)) {
+                result.push(...fileLines.slice(result.length));
+                break;
+            }
+            result.push(transformReadLine(line));
+        }
+        const prefixLines = inlineFirst !== null
+            ? [...lines.slice(0, blockStart), openTag]
+            : lines.slice(0, blockStart + 1);
+        return [...prefixLines, ...result, ...lines.slice(blockEnd)].join("\n");
+    }
+    if (!isTextFileOutput(lines[0] ?? "")) {
+        return output;
+    }
+    const result = [];
+    for (const line of lines) {
+        if (!parseReadLine(line)) {
+            result.push(...lines.slice(result.length));
+            break;
+        }
+        result.push(transformReadLine(line));
+    }
+    return result.join("\n");
+}
+async function executeHashlineEdit(args, context) {
+    try {
+        const { filePath, rename, delete: deleteMode } = args;
+        if (deleteMode && rename) {
+            return "Error: delete and rename cannot be used together";
+        }
+        if (deleteMode && args.edits.length > 0) {
+            return "Error: delete mode requires edits to be an empty array";
+        }
+        if (!deleteMode && (!Array.isArray(args.edits) || args.edits.length === 0)) {
+            return "Error: edits parameter must be a non-empty array";
+        }
+        const edits = deleteMode ? [] : normalizeHashlineEdits(args.edits);
+        const file = Bun.file(filePath);
+        const exists = await file.exists();
+        if (!exists && !deleteMode && !canCreateFromMissingFile(edits)) {
+            return `Error: File not found: ${filePath}`;
+        }
+        if (deleteMode) {
+            if (!exists) {
+                return `Error: File not found: ${filePath}`;
+            }
+            await file.delete();
+            return `Successfully deleted ${filePath}`;
+        }
+        const rawOldContent = exists ? Buffer.from(await file.arrayBuffer()).toString("utf8") : "";
+        const oldEnvelope = canonicalizeFileText(rawOldContent);
+        const applyResult = applyHashlineEditsWithReport(oldEnvelope.content, edits);
+        const canonicalNewContent = applyResult.content;
+        if (canonicalNewContent === oldEnvelope.content && !rename) {
+            let diagnostic = `No changes made to ${filePath}. The edits produced identical content.`;
+            if (applyResult.noopEdits > 0) {
+                diagnostic += ` No-op edits: ${applyResult.noopEdits}. Re-read the file and provide content that differs from the current lines.`;
+            }
+            return `Error: ${diagnostic}`;
+        }
+        const writeContent = restoreFileText(canonicalNewContent, oldEnvelope);
+        await Bun.write(filePath, writeContent);
+        if (rename && rename !== filePath) {
+            await Bun.write(rename, writeContent);
+            await Bun.file(filePath).delete();
+        }
+        const effectivePath = rename && rename !== filePath ? rename : filePath;
+        publishSuccessMetadata({
+            context,
+            filePath: effectivePath,
+            beforeContent: oldEnvelope.content,
+            afterContent: canonicalNewContent,
+            noopEdits: applyResult.noopEdits,
+            deduplicatedEdits: applyResult.deduplicatedEdits,
+        });
+        return rename && rename !== filePath
+            ? `Moved ${filePath} to ${rename}`
+            : `Updated ${effectivePath}`;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (error instanceof HashlineMismatchError) {
+            return `Error: hash mismatch - ${message}\nTip: reuse LINE#ID entries from the latest read output or mismatch snippet, or batch related edits in one call.`;
+        }
+        return `Error: ${message}`;
+    }
+}
+export const HashlineEditPlugin = async () => {
+    return {
+        "tool.execute.after": async (input, output) => {
+            if (!isReadTool(input.tool) || typeof output.output !== "string") {
+                return;
+            }
+            output.output = transformReadOutput(output.output);
+        },
+        tool: {
+            edit: tool({
+                description: HASHLINE_EDIT_DESCRIPTION,
+                args: {
+                    filePath: z.string().describe("Absolute path to the file to edit"),
+                    delete: z.boolean().optional().describe("Delete the file instead of editing it"),
+                    rename: z.string().optional().describe("Rename the file after edits are applied"),
+                    edits: z
+                        .array(z.object({
+                        op: z.enum(["replace", "append", "prepend"]),
+                        pos: z.string().optional().describe("Primary anchor in LINE#HASH format"),
+                        end: z.string().optional().describe("Inclusive range end in LINE#HASH format"),
+                        lines: z
+                            .union([z.array(z.string()), z.string(), z.null()])
+                            .describe("Replacement or inserted lines as plain text content"),
+                    }))
+                        .describe("Hash-anchored edit operations to apply to the file"),
+                },
+                execute: (args, context) => executeHashlineEdit(args, context),
+            }),
+        },
+    };
+};
+//# sourceMappingURL=index.js.map

package/dist/plugins/hashline-edit/index.js.map

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

package/dist/plugins/hashline-edit/normalize-edits.d.ts

@@ -0,0 +1,10 @@
+import type { HashlineEdit } from "./types.js";
+type HashlineToolOp = "replace" | "append" | "prepend";
+export interface RawHashlineEdit {
+    op?: HashlineToolOp;
+    pos?: string;
+    end?: string;
+    lines?: string | string[] | null;
+}
+export declare function normalizeHashlineEdits(rawEdits: RawHashlineEdit[]): HashlineEdit[];
+export {};

package/dist/plugins/hashline-edit/normalize-edits.js

@@ -0,0 +1,82 @@
+// FILE: src/plugins/hashline-edit/normalize-edits.ts
+// VERSION: 0.1.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Validate and normalize raw hashline tool arguments into strongly-typed edit operations.
+//   SCOPE: Raw edit input shape, anchor trimming, required-field validation, and replace/append/prepend normalization.
+//   DEPENDS: [src/plugins/hashline-edit/types.ts]
+//   LINKS: [M-PLUGIN-HASHLINE-EDIT]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   RawHashlineEdit - Tool-facing edit input before validation and normalization.
+//   normalizeHashlineEdits - Convert raw tool args into validated HashlineEdit operations.
+// END_MODULE_MAP
+function normalizeAnchor(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed === "" ? undefined : trimmed;
+}
+function requireLines(edit, index) {
+    if (edit.lines === undefined) {
+        throw new Error(`Edit ${index}: lines is required for ${edit.op ?? "unknown"}`);
+    }
+    return edit.lines;
+}
+function requireAnchor(anchor, index, op) {
+    if (!anchor) {
+        throw new Error(`Edit ${index}: ${op} requires at least one anchor line reference (pos or end)`);
+    }
+    return anchor;
+}
+function normalizeReplaceEdit(edit, index) {
+    const pos = normalizeAnchor(edit.pos);
+    const end = normalizeAnchor(edit.end);
+    const anchor = requireAnchor(pos ?? end, index, "replace");
+    const lines = requireLines(edit, index);
+    const normalized = {
+        op: "replace",
+        pos: anchor,
+        lines,
+    };
+    if (end) {
+        normalized.end = end;
+    }
+    return normalized;
+}
+function normalizeInsertEdit(edit, index, op) {
+    const pos = normalizeAnchor(edit.pos);
+    const end = normalizeAnchor(edit.end);
+    const anchor = pos ?? end;
+    const lines = requireLines(edit, index);
+    if (lines === null) {
+        throw new Error(`Edit ${index}: ${op} does not support lines=null`);
+    }
+    const normalized = {
+        op,
+        lines,
+    };
+    if (anchor) {
+        normalized.pos = anchor;
+    }
+    return normalized;
+}
+export function normalizeHashlineEdits(rawEdits) {
+    return rawEdits.map((rawEdit, index) => {
+        const edit = rawEdit ?? {};
+        switch (edit.op) {
+            case "replace":
+                return normalizeReplaceEdit(edit, index);
+            case "append":
+                return normalizeInsertEdit(edit, index, "append");
+            case "prepend":
+                return normalizeInsertEdit(edit, index, "prepend");
+            default:
+                throw new Error(`Edit ${index}: unsupported op "${String(edit.op)}". Use replace, append, or prepend.`);
+        }
+    });
+}
+//# sourceMappingURL=normalize-edits.js.map

package/dist/plugins/hashline-edit/normalize-edits.js.map

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

package/dist/plugins/hashline-edit/tool-description.d.ts

@@ -0,0 +1 @@
+export declare const HASHLINE_EDIT_DESCRIPTION = "Edit files using exact hash-anchored line references from the latest Read output.\n\nWorkflow:\n1. Read the file and copy anchors in `{line}#{hash}` form from rows like `42#VK|content`.\n2. Submit one `edit` call per file with the smallest possible set of replace/append/prepend operations.\n3. If the same file needs another call after a successful edit, re-read it first.\n\nRules:\n- Every anchored edit must use exact current `{line}#{hash}` values from the latest Read output.\n- All edits in one call target the ORIGINAL file snapshot; do not adjust line numbers for earlier edits in the same batch.\n- `replace` with `pos` only replaces one line.\n- `replace` with `pos` and `end` replaces the inclusive range `pos..end`.\n- `append` inserts after the anchor, or at EOF when no anchor is provided.\n- `prepend` inserts before the anchor, or at BOF when no anchor is provided.\n- `lines: null` or `lines: []` with `replace` deletes the targeted line or range.\n- `lines` must contain plain replacement content only, not copied `line#hash|content` rows.\n- Prefer one operation per logical mutation site instead of a single oversized replace.\n\nRecovery:\n- If you get a hash mismatch error, copy the updated anchors shown in that error or re-read the file before retrying.";

package/dist/plugins/hashline-edit/tool-description.js

@@ -0,0 +1,35 @@
+// FILE: src/plugins/hashline-edit/tool-description.ts
+// VERSION: 0.1.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Provide the LLM-facing tool description for the hash-anchored edit override.
+//   SCOPE: Stable instructions for read-then-edit workflow, anchor usage, operation choice, and stale-anchor recovery.
+//   DEPENDS: []
+//   LINKS: [M-PLUGIN-HASHLINE-EDIT]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   HASHLINE_EDIT_DESCRIPTION - Canonical LLM-facing description for the hashline-backed `edit` tool.
+// END_MODULE_MAP
+export const HASHLINE_EDIT_DESCRIPTION = `Edit files using exact hash-anchored line references from the latest Read output.
+
+Workflow:
+1. Read the file and copy anchors in \`{line}#{hash}\` form from rows like \`42#VK|content\`.
+2. Submit one \`edit\` call per file with the smallest possible set of replace/append/prepend operations.
+3. If the same file needs another call after a successful edit, re-read it first.
+
+Rules:
+- Every anchored edit must use exact current \`{line}#{hash}\` values from the latest Read output.
+- All edits in one call target the ORIGINAL file snapshot; do not adjust line numbers for earlier edits in the same batch.
+- \`replace\` with \`pos\` only replaces one line.
+- \`replace\` with \`pos\` and \`end\` replaces the inclusive range \`pos..end\`.
+- \`append\` inserts after the anchor, or at EOF when no anchor is provided.
+- \`prepend\` inserts before the anchor, or at BOF when no anchor is provided.
+- \`lines: null\` or \`lines: []\` with \`replace\` deletes the targeted line or range.
+- \`lines\` must contain plain replacement content only, not copied \`line#hash|content\` rows.
+- Prefer one operation per logical mutation site instead of a single oversized replace.
+
+Recovery:
+- If you get a hash mismatch error, copy the updated anchors shown in that error or re-read the file before retrying.`;
+//# sourceMappingURL=tool-description.js.map

package/dist/plugins/hashline-edit/tool-description.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-description.js","sourceRoot":"","sources":["../../../src/plugins/hashline-edit/tool-description.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,iBAAiB;AACjB,wBAAwB;AACxB,0FAA0F;AAC1F,uHAAuH;AACvH,gBAAgB;AAChB,oCAAoC;AACpC,kBAAkB;AAClB,sBAAsB;AACtB,sBAAsB;AACtB,EAAE;AACF,mBAAmB;AACnB,sGAAsG;AACtG,iBAAiB;AAEjB,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;sHAmB6E,CAAC"}

package/dist/plugins/hashline-edit/types.d.ts

@@ -0,0 +1,17 @@
+export interface ReplaceEdit {
+    op: "replace";
+    pos: string;
+    end?: string;
+    lines: string | string[] | null;
+}
+export interface AppendEdit {
+    op: "append";
+    pos?: string;
+    lines: string | string[];
+}
+export interface PrependEdit {
+    op: "prepend";
+    pos?: string;
+    lines: string | string[];
+}
+export type HashlineEdit = ReplaceEdit | AppendEdit | PrependEdit;

package/dist/plugins/hashline-edit/types.js

@@ -0,0 +1,19 @@
+// FILE: src/plugins/hashline-edit/types.ts
+// VERSION: 0.1.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Define the normalized edit operation shapes accepted by the hash-anchored edit executor.
+//   SCOPE: Replace, append, and prepend operation contracts plus the shared HashlineEdit union.
+//   DEPENDS: []
+//   LINKS: [M-PLUGIN-HASHLINE-EDIT]
+//   ROLE: TYPES
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   ReplaceEdit - Replace or delete a single line or inclusive range anchored by hashline references.
+//   AppendEdit - Insert content after an optional anchor or at EOF when no anchor is provided.
+//   PrependEdit - Insert content before an optional anchor or at BOF when no anchor is provided.
+//   HashlineEdit - Union of all normalized hashline edit operations.
+// END_MODULE_MAP
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/hashline-edit/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/plugins/hashline-edit/types.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,iBAAiB;AACjB,wBAAwB;AACxB,sGAAsG;AACtG,gGAAgG;AAChG,gBAAgB;AAChB,oCAAoC;AACpC,gBAAgB;AAChB,sBAAsB;AACtB,sBAAsB;AACtB,EAAE;AACF,mBAAmB;AACnB,sGAAsG;AACtG,+FAA+F;AAC/F,iGAAiG;AACjG,qEAAqE;AACrE,iBAAiB"}

package/dist/plugins/hashline-edit/validation.d.ts

@@ -0,0 +1,20 @@
+export interface LineRef {
+    line: number;
+    hash: string;
+}
+interface HashMismatch {
+    line: number;
+    expected: string;
+}
+export declare function normalizeLineRef(ref: string): string;
+export declare function parseLineRef(ref: string): LineRef;
+export declare class HashlineMismatchError extends Error {
+    private readonly mismatches;
+    private readonly fileLines;
+    readonly remaps: ReadonlyMap<string, string>;
+    constructor(mismatches: HashMismatch[], fileLines: string[]);
+    static formatMessage(mismatches: HashMismatch[], fileLines: string[]): string;
+}
+export declare function validateLineRef(lines: string[], ref: string): void;
+export declare function validateLineRefs(lines: string[], refs: string[]): void;
+export {};

package/dist/plugins/hashline-edit/validation.js

@@ -0,0 +1,160 @@
+// FILE: src/plugins/hashline-edit/validation.ts
+// VERSION: 0.1.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Parse and validate hashline references against the current file snapshot before edits are applied.
+//   SCOPE: Anchor normalization, line reference parsing, full-batch validation, mismatch diagnostics, and compatibility fallback for legacy hashes.
+//   DEPENDS: [src/plugins/hashline-edit/constants.ts, src/plugins/hashline-edit/hash-computation.ts]
+//   LINKS: [M-PLUGIN-HASHLINE-EDIT]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   LineRef - Parsed `{ line, hash }` structure for a normalized hashline anchor.
+//   normalizeLineRef - Strip copied prefixes and inline content from a raw anchor string.
+//   parseLineRef - Parse a normalized hashline anchor and fail loudly on malformed references.
+//   validateLineRef - Validate a single anchor against the current file lines.
+//   validateLineRefs - Validate a batch of anchors and aggregate mismatches.
+//   HashlineMismatchError - Rich mismatch error that includes updated surrounding anchors.
+// END_MODULE_MAP
+import { HASHLINE_REF_PATTERN } from "./constants.js";
+import { computeLegacyLineHash, computeLineHash } from "./hash-computation.js";
+const MISMATCH_CONTEXT = 2;
+const LINE_REF_EXTRACT_PATTERN = /([0-9]+#[ZPMQVRWSNKTXJBYH]{2})/;
+function isCompatibleLineHash(line, content, hash) {
+    return computeLineHash(line, content) === hash || computeLegacyLineHash(line, content) === hash;
+}
+export function normalizeLineRef(ref) {
+    const originalTrimmed = ref.trim();
+    let trimmed = originalTrimmed;
+    trimmed = trimmed.replace(/^(?:>>>|[+-])\s*/, "");
+    trimmed = trimmed.replace(/\s*#\s*/, "#");
+    trimmed = trimmed.replace(/\|.*$/, "");
+    trimmed = trimmed.trim();
+    if (HASHLINE_REF_PATTERN.test(trimmed)) {
+        return trimmed;
+    }
+    const extracted = trimmed.match(LINE_REF_EXTRACT_PATTERN);
+    if (extracted) {
+        return extracted[1];
+    }
+    return originalTrimmed;
+}
+export function parseLineRef(ref) {
+    const normalized = normalizeLineRef(ref);
+    const match = normalized.match(HASHLINE_REF_PATTERN);
+    if (match) {
+        return {
+            line: Number.parseInt(match[1], 10),
+            hash: match[2],
+        };
+    }
+    const hashIndex = normalized.indexOf("#");
+    if (hashIndex > 0) {
+        const prefix = normalized.slice(0, hashIndex);
+        const suffix = normalized.slice(hashIndex + 1);
+        if (!/^\d+$/.test(prefix) && /^[ZPMQVRWSNKTXJBYH]{2}$/.test(suffix)) {
+            throw new Error(`Invalid line reference: "${ref}". "${prefix}" is not a line number. Use the exact line number from the latest read output.`);
+        }
+    }
+    throw new Error(`Invalid line reference format: "${ref}". Expected format: "{line_number}#{hash_id}"`);
+}
+export class HashlineMismatchError extends Error {
+    mismatches;
+    fileLines;
+    remaps;
+    constructor(mismatches, fileLines) {
+        super(HashlineMismatchError.formatMessage(mismatches, fileLines));
+        this.mismatches = mismatches;
+        this.fileLines = fileLines;
+        this.name = "HashlineMismatchError";
+        const remaps = new Map();
+        for (const mismatch of mismatches) {
+            const actual = computeLineHash(mismatch.line, fileLines[mismatch.line - 1] ?? "");
+            remaps.set(`${mismatch.line}#${mismatch.expected}`, `${mismatch.line}#${actual}`);
+        }
+        this.remaps = remaps;
+    }
+    static formatMessage(mismatches, fileLines) {
+        const mismatchByLine = new Map();
+        for (const mismatch of mismatches) {
+            mismatchByLine.set(mismatch.line, mismatch);
+        }
+        const displayLines = new Set();
+        for (const mismatch of mismatches) {
+            const low = Math.max(1, mismatch.line - MISMATCH_CONTEXT);
+            const high = Math.min(fileLines.length, mismatch.line + MISMATCH_CONTEXT);
+            for (let line = low; line <= high; line += 1) {
+                displayLines.add(line);
+            }
+        }
+        const sortedLines = [...displayLines].sort((left, right) => left - right);
+        const output = [];
+        output.push(`${mismatches.length} line${mismatches.length > 1 ? "s have" : " has"} changed since last read. Use updated {line_number}#{hash_id} references below (>>> marks changed lines).`);
+        output.push("");
+        let previousLine = -1;
+        for (const line of sortedLines) {
+            if (previousLine !== -1 && line > previousLine + 1) {
+                output.push("    ...");
+            }
+            previousLine = line;
+            const content = fileLines[line - 1] ?? "";
+            const hash = computeLineHash(line, content);
+            const formatted = `${line}#${hash}|${content}`;
+            output.push(mismatchByLine.has(line) ? `>>> ${formatted}` : `    ${formatted}`);
+        }
+        return output.join("\n");
+    }
+}
+function suggestLineForHash(ref, lines) {
+    const hashMatch = ref.trim().match(/#([ZPMQVRWSNKTXJBYH]{2})$/);
+    if (!hashMatch) {
+        return null;
+    }
+    const hash = hashMatch[1];
+    for (let index = 0; index < lines.length; index += 1) {
+        if (isCompatibleLineHash(index + 1, lines[index] ?? "", hash)) {
+            return `Did you mean "${index + 1}#${computeLineHash(index + 1, lines[index] ?? "")}"?`;
+        }
+    }
+    return null;
+}
+function parseLineRefWithHint(ref, lines) {
+    try {
+        return parseLineRef(ref);
+    }
+    catch (error) {
+        const hint = suggestLineForHash(ref, lines);
+        if (hint && error instanceof Error) {
+            throw new Error(`${error.message} ${hint}`);
+        }
+        throw error;
+    }
+}
+export function validateLineRef(lines, ref) {
+    const { line, hash } = parseLineRefWithHint(ref, lines);
+    if (line < 1 || line > lines.length) {
+        throw new Error(`Line number ${line} out of bounds. File has ${lines.length} lines.`);
+    }
+    const content = lines[line - 1] ?? "";
+    if (!isCompatibleLineHash(line, content, hash)) {
+        throw new HashlineMismatchError([{ line, expected: hash }], lines);
+    }
+}
+export function validateLineRefs(lines, refs) {
+    const mismatches = [];
+    for (const ref of refs) {
+        const { line, hash } = parseLineRefWithHint(ref, lines);
+        if (line < 1 || line > lines.length) {
+            throw new Error(`Line number ${line} out of bounds (file has ${lines.length} lines)`);
+        }
+        const content = lines[line - 1] ?? "";
+        if (!isCompatibleLineHash(line, content, hash)) {
+            mismatches.push({ line, expected: hash });
+        }
+    }
+    if (mismatches.length > 0) {
+        throw new HashlineMismatchError(mismatches, lines);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/plugins/hashline-edit/validation.js.map

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