plugsuits 1.0.0

package/dist/tools/utils/hashline/validation.js

@@ -0,0 +1,161 @@
+import { HASHLINE_REF_PATTERN } from "./constants";
+import { computeLineHash } from "./hash-computation";
+const MISMATCH_CONTEXT = 2;
+const LINE_REF_EXTRACT_PATTERN = /([0-9]+#[ZPMQVRWSNKTXJBYH]{2})/;
+const DIFF_PREFIX_REGEX = /^(?:>>>|[+-])\s*/;
+const HASH_SPACE_REGEX = /\s*#\s*/;
+const PIPE_SUFFIX_REGEX = /\|.*$/;
+const DIGITS_ONLY_REGEX = /^\d+$/;
+const HASH_ID_REGEX = /^[ZPMQVRWSNKTXJBYH]{2}$/;
+const TRAILING_HASH_REGEX = /#([ZPMQVRWSNKTXJBYH]{2})$/;
+function normalizeLineRef(ref) {
+    const originalTrimmed = ref.trim();
+    let trimmed = originalTrimmed;
+    trimmed = trimmed.replace(DIFF_PREFIX_REGEX, "");
+    trimmed = trimmed.replace(HASH_SPACE_REGEX, "#");
+    trimmed = trimmed.replace(PIPE_SUFFIX_REGEX, "");
+    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],
+        };
+    }
+    // normalized equals ref.trim() in all error paths — extraction only succeeds for valid refs
+    const hashIdx = normalized.indexOf("#");
+    if (hashIdx > 0) {
+        const prefix = normalized.slice(0, hashIdx);
+        const suffix = normalized.slice(hashIdx + 1);
+        if (!DIGITS_ONLY_REGEX.test(prefix) && HASH_ID_REGEX.test(suffix)) {
+            throw new Error(`Invalid line reference: "${ref}". "${prefix}" is not a line number. ` +
+                "Use the actual line number from the read output.");
+        }
+    }
+    throw new Error(`Invalid line reference format: "${ref}". Expected format: "{line_number}#{hash_id}"`);
+}
+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];
+    const currentHash = computeLineHash(line, content);
+    if (currentHash !== hash) {
+        throw new HashlineMismatchError([{ line, expected: hash }], lines);
+    }
+}
+export class HashlineMismatchError extends Error {
+    remaps;
+    constructor(mismatches, fileLines) {
+        super(HashlineMismatchError.formatMessage(mismatches, 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++) {
+                displayLines.add(line);
+            }
+        }
+        const sortedLines = [...displayLines].sort((a, b) => a - b);
+        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 prefix = `${line}#${hash}|${content}`;
+            if (mismatchByLine.has(line)) {
+                output.push(`>>> ${prefix}`);
+            }
+            else {
+                output.push(`    ${prefix}`);
+            }
+        }
+        return output.join("\n");
+    }
+}
+function suggestLineForHash(ref, lines) {
+    const hashMatch = ref.trim().match(TRAILING_HASH_REGEX);
+    if (!hashMatch) {
+        return null;
+    }
+    const hash = hashMatch[1];
+    for (let i = 0; i < lines.length; i++) {
+        if (computeLineHash(i + 1, lines[i]) === hash) {
+            return `Did you mean "${i + 1}#${hash}"?`;
+        }
+    }
+    return null;
+}
+function parseLineRefWithHint(ref, lines) {
+    try {
+        return parseLineRef(ref);
+    }
+    catch (parseError) {
+        const hint = suggestLineForHash(ref, lines);
+        if (hint && parseError instanceof Error) {
+            throw new Error(`${parseError.message} ${hint}`);
+        }
+        throw parseError;
+    }
+}
+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];
+        const currentHash = computeLineHash(line, content);
+        if (currentHash !== hash) {
+            mismatches.push({ line, expected: hash });
+        }
+    }
+    if (mismatches.length > 0) {
+        throw new HashlineMismatchError(mismatches, lines);
+    }
+}
+export function tryParseLineTag(tag) {
+    if (!tag) {
+        return undefined;
+    }
+    try {
+        return parseLineRef(tag);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/tools/utils/hashline/validation.js.map

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

package/dist/tools/utils/hashline/validation.test.d.ts

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

package/dist/tools/utils/hashline/validation.test.d.ts.map

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

package/dist/tools/utils/hashline/validation.test.js

@@ -0,0 +1,86 @@
+import { describe, expect, it } from "bun:test";
+import { computeLineHash, HashlineMismatchError, parseHashlineText, parseLineRef, parseLineTag, tryParseLineTag, validateLineRef, validateLineRefs, } from ".";
+describe("hashline - validation", () => {
+    it("parses line refs with noisy prefixes", () => {
+        expect(parseLineRef(">>> 12#ZP")).toEqual({
+            line: 12,
+            hash: "ZP",
+        });
+    });
+    it("parses line tags via alias", () => {
+        expect(parseLineTag("42#VK")).toEqual({
+            line: 42,
+            hash: "VK",
+        });
+    });
+    it("parses anchors with diff marker prefix", () => {
+        expect(parseLineRef(">>> 42#VK")).toEqual({ line: 42, hash: "VK" });
+    });
+    it("parses anchors with spaces around #", () => {
+        expect(parseLineRef("42 # VK")).toEqual({ line: 42, hash: "VK" });
+    });
+    it("strips pipe-delimited content from refs", () => {
+        expect(parseLineRef("12#ZP|some content")).toEqual({
+            line: 12,
+            hash: "ZP",
+        });
+    });
+    it("parses first ref from multiline input (ignores rest)", () => {
+        const result = parseLineRef("1#HK|alpha\n2#KM|bravo");
+        expect(result).toEqual({ line: 1, hash: "HK" });
+    });
+    it("returns undefined for invalid tags via tryParseLineTag", () => {
+        expect(tryParseLineTag("invalid")).toBeUndefined();
+        expect(tryParseLineTag(undefined)).toBeUndefined();
+    });
+    it("strips copied hashline prefixes from string inputs", () => {
+        const parsed = parseHashlineText("1#ZP|foo\n2#MQ|bar\n");
+        expect(parsed).toEqual(["foo", "bar", ""]);
+    });
+    it("preserves markdown list lines starting with '-'", () => {
+        const parsed = parseHashlineText("- item one\n- item two\n");
+        expect(parsed).toEqual(["- item one", "- item two", ""]);
+    });
+    it("preserves checkbox list lines", () => {
+        const parsed = parseHashlineText("- [ ] task one\n- [x] task two\n");
+        expect(parsed).toEqual(["- [ ] task one", "- [x] task two", ""]);
+    });
+    it("keeps lines that start with '++' intact", () => {
+        const parsed = parseHashlineText("++conflict marker\n++another\n");
+        expect(parsed).toEqual(["++conflict marker", "++another", ""]);
+    });
+    it("validates a matching line reference", () => {
+        const lines = ["a", "b", "c"];
+        const ref = `2#${computeLineHash(2, "b")}`;
+        expect(() => validateLineRef(lines, ref)).not.toThrow();
+    });
+    it("throws mismatch error from validateLineRef", () => {
+        const lines = ["a", "b", "c"];
+        const ref = `2#${computeLineHash(2, "B")}`;
+        expect(() => validateLineRef(lines, ref)).toThrow(HashlineMismatchError);
+    });
+    it("batch validates multiple refs", () => {
+        const lines = ["a", "b", "c"];
+        const refs = [
+            `1#${computeLineHash(1, "a")}`,
+            `2#${computeLineHash(2, "b")}`,
+        ];
+        expect(() => validateLineRefs(lines, refs)).not.toThrow();
+    });
+    it("batch validates collecting multiple mismatches", () => {
+        const lines = ["a", "b", "c"];
+        const staleB = computeLineHash(2, "B");
+        const staleC = computeLineHash(3, "C");
+        const refs = [`2#${staleB}`, `3#${staleC}`];
+        try {
+            validateLineRefs(lines, refs);
+            throw new Error("Expected error");
+        }
+        catch (error) {
+            expect(error).toBeInstanceOf(HashlineMismatchError);
+            const e = error;
+            expect(e.remaps.size).toBe(2);
+        }
+    });
+});
+//# sourceMappingURL=validation.test.js.map

package/dist/tools/utils/hashline/validation.test.js.map

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

package/dist/tools/utils/safety-utils.d.ts

@@ -0,0 +1,66 @@
+export interface IgnoreFilter {
+    ignores: (pathFromBaseDir: string) => boolean;
+}
+export declare function getIgnoreFilter(baseDir?: string): Promise<IgnoreFilter>;
+export interface ReadFileOptions {
+    limit?: number;
+    offset?: number;
+}
+export declare function formatNumberedLines(lines: string[], startLine1: number): string;
+export declare function formatBlock(title: string, body: string): string;
+export interface LineWindow {
+    endLine1: number;
+    startLine1: number;
+}
+export declare function computeLineWindow(params: {
+    aroundLine1: number;
+    before: number;
+    after: number;
+    totalLines: number;
+}): LineWindow;
+export interface ReadFileResultEnhanced {
+    bytes: number;
+    content: string;
+    endLine1: number;
+    fileHash: string;
+    lastModified: string;
+    numberedContent: string;
+    startLine1: number;
+    totalLines: number;
+    truncated: boolean;
+}
+export declare function safeReadFileEnhanced(path: string, options?: ReadFileOptions & {
+    around_line?: number;
+    before?: number;
+    after?: number;
+    respect_git_ignore?: boolean;
+}): Promise<ReadFileResultEnhanced>;
+/**
+ * Assert that a file path is safe for write/edit/delete operations.
+ *
+ * Runs the path through all write safety guards:
+ *   C-1: Path traversal protection (rejects paths that escape project root)
+ *   C-2: Symlink resolution via fs.realpath() (rejects symlink targets
+ *        and intermediate directory symlinks escaping project root)
+ *
+ * @param filePath - The user-supplied file path
+ * @param rootDir  - Project root directory (defaults to process.cwd())
+ * @returns The resolved absolute path, guaranteed to be within rootDir
+ * @throws Error if any safety guard rejects the path
+ */
+export declare function assertWriteSafety(filePath: string, rootDir?: string): Promise<string>;
+/**
+ * H-1: Atomic file write using temp-file + rename.
+ *
+ * Uses O_EXCL to prevent symlink pre-creation attacks on the temp file,
+ * crypto.randomBytes for unpredictable temp names, and POSIX rename()
+ * which atomically replaces the directory entry (does not follow symlinks).
+ *
+ * @param targetPath - The final destination path (must be safe-validated)
+ * @param content - The content to write
+ * @returns Whether the file previously existed (for reporting purposes)
+ */
+export declare function safeAtomicWriteFile(targetPath: string, content: string): Promise<{
+    existed: boolean;
+}>;
+//# sourceMappingURL=safety-utils.d.ts.map

package/dist/tools/utils/safety-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety-utils.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/safety-utils.ts"],"names":[],"mappings":"AA2EA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC;CAC/C;AA4PD,wBAAsB,eAAe,CACnC,OAAO,SAAgB,GACtB,OAAO,CAAC,YAAY,CAAC,CAevB;AA4KD,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,UAAU,CAKb;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,eAAe,GAAG;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,GACA,OAAO,CAAC,sBAAsB,CAAC,CAuDjC;AA2LD;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,MAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA4D/B"}