comprehende 0.1.0

package/dist/git/diff.js

@@ -0,0 +1,332 @@
+import { git } from "./exec.js";
+import { rangeLabel, resolveCommit } from "./repo.js";
+const HUNK_HEADER = /^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@/;
+export async function resolveSource(cwd, baseRef, headRef) {
+    const baseSha = await resolveCommit(cwd, baseRef);
+    const headSha = await resolveCommit(cwd, headRef);
+    return {
+        source: { baseRef, headRef, range: rangeLabel(baseRef, headRef) },
+        baseSha,
+        headSha,
+    };
+}
+export async function readDiff(cwd, baseRef, headRef) {
+    await resolveCommit(cwd, baseRef);
+    await resolveCommit(cwd, headRef);
+    const stdout = await git(cwd, [
+        "diff",
+        "--find-renames",
+        "--find-copies",
+        "-U3",
+        "--no-color",
+        "--no-ext-diff",
+        "--end-of-options",
+        `${baseRef}...${headRef}`,
+    ]);
+    return parseUnifiedDiff(stdout);
+}
+export async function readHunkIndex(cwd, baseRef, headRef) {
+    const { source } = await resolveSource(cwd, baseRef, headRef);
+    const files = await readDiff(cwd, baseRef, headRef);
+    const hunks = [];
+    const skipped = [];
+    for (const file of files) {
+        if (file.binary) {
+            skipped.push({ path: file.path, reason: "binary" });
+            continue;
+        }
+        for (const hunk of file.hunks) {
+            hunks.push(toHunkRef(hunk));
+        }
+    }
+    return { source, hunks, skipped };
+}
+export function toHunkRef(hunk) {
+    const ref = {
+        path: hunk.path,
+        oldStart: hunk.oldStart,
+        oldLines: hunk.oldLines,
+        newStart: hunk.newStart,
+        newLines: hunk.newLines,
+    };
+    if (hunk.oldPath !== undefined) {
+        ref.oldPath = hunk.oldPath;
+    }
+    return ref;
+}
+export function parseUnifiedDiff(text) {
+    const files = [];
+    let current;
+    let offset = 0;
+    while (offset < text.length) {
+        const newline = text.indexOf("\n", offset);
+        const lineEnd = newline === -1 ? text.length : newline;
+        const line = text.slice(offset, lineEnd);
+        const rawLine = text.slice(offset, newline === -1 ? text.length : newline + 1);
+        if (line.startsWith("diff --git ")) {
+            if (current !== undefined) {
+                files.push(current.finish());
+            }
+            current = new FileBuilder(line, rawLine);
+        }
+        else if (current !== undefined) {
+            current.consume(line, rawLine);
+        }
+        offset = newline === -1 ? text.length : newline + 1;
+    }
+    if (current !== undefined) {
+        files.push(current.finish());
+    }
+    return files;
+}
+export function filePatchFromGit(file, hunks) {
+    if (hunks.length === 0) {
+        return "";
+    }
+    const selected = new Set(hunks);
+    if (file.hunks.length === selected.size && file.hunks.every((hunk) => selected.has(hunk))) {
+        return file.patch;
+    }
+    return `${file.headerPatch}${hunks.map((hunk) => hunk.patch).join("")}`;
+}
+class FileBuilder {
+    path = "";
+    oldPath;
+    status = "modified";
+    binary = false;
+    hunks = [];
+    oldFile;
+    newFile;
+    renameFrom;
+    renameTo;
+    activeHunk;
+    hunkRaw = "";
+    headerPatch;
+    patch;
+    oldCursor = 0;
+    newCursor = 0;
+    constructor(diffGitLine, rawLine) {
+        const parsed = parseDiffGitLine(diffGitLine);
+        this.oldPath = parsed.oldPath;
+        this.path = parsed.newPath;
+        this.headerPatch = rawLine;
+        this.patch = rawLine;
+    }
+    consume(line, rawLine) {
+        this.patch += rawLine;
+        const hunkMatch = HUNK_HEADER.exec(line);
+        if (hunkMatch) {
+            this.closeHunk();
+            this.startHunk(line, hunkMatch, rawLine);
+            return;
+        }
+        if (this.activeHunk !== undefined) {
+            this.hunkRaw += rawLine;
+            if (!line.startsWith("\\")) {
+                this.pushHunkLine(line);
+            }
+            return;
+        }
+        this.headerPatch += rawLine;
+        if (line.startsWith("rename from ")) {
+            this.renameFrom = line.slice("rename from ".length);
+            return;
+        }
+        if (line.startsWith("copy from ")) {
+            this.renameFrom = line.slice("copy from ".length);
+            return;
+        }
+        if (line.startsWith("rename to ")) {
+            this.renameTo = line.slice("rename to ".length);
+            this.status = "renamed";
+            return;
+        }
+        if (line.startsWith("copy to ")) {
+            this.renameTo = line.slice("copy to ".length);
+            this.status = "renamed";
+            return;
+        }
+        if (line.startsWith("new file mode")) {
+            this.status = "added";
+            return;
+        }
+        if (line.startsWith("deleted file mode")) {
+            this.status = "deleted";
+            return;
+        }
+        if (line.startsWith("Binary files ") || line.startsWith("GIT binary patch")) {
+            this.binary = true;
+            return;
+        }
+        if (line.startsWith("--- ")) {
+            this.oldFile = stripDiffPath(line.slice(4));
+            return;
+        }
+        if (line.startsWith("+++ ")) {
+            this.newFile = stripDiffPath(line.slice(4));
+        }
+    }
+    finish() {
+        this.closeHunk();
+        const path = this.renameTo ?? this.newFile ?? this.path;
+        const oldCandidate = this.renameFrom ?? this.oldFile;
+        const oldPath = oldCandidate !== undefined && oldCandidate !== path ? oldCandidate : undefined;
+        let status = this.status;
+        if (status === "modified") {
+            if (this.oldFile === undefined && this.newFile !== undefined) {
+                status = "added";
+            }
+            else if (this.newFile === undefined && this.oldFile !== undefined) {
+                status = "deleted";
+            }
+            else if (oldPath !== undefined) {
+                status = "renamed";
+            }
+        }
+        const hunks = this.binary
+            ? []
+            : this.hunks.map((hunk) => {
+                const next = { ...hunk, path };
+                if (oldPath !== undefined) {
+                    next.oldPath = oldPath;
+                }
+                return next;
+            });
+        const file = {
+            path,
+            status,
+            binary: this.binary,
+            headerPatch: this.headerPatch,
+            patch: this.patch,
+            hunks,
+        };
+        if (oldPath !== undefined) {
+            file.oldPath = oldPath;
+        }
+        return file;
+    }
+    startHunk(header, match, rawLine) {
+        const oldStart = Number(match[1]);
+        const oldLines = match[2] === undefined ? 1 : Number(match[2]);
+        const newStart = Number(match[3]);
+        const newLines = match[4] === undefined ? 1 : Number(match[4]);
+        this.oldCursor = oldStart;
+        this.newCursor = newStart;
+        this.hunkRaw = rawLine;
+        this.activeHunk = {
+            path: this.path,
+            oldStart,
+            oldLines,
+            newStart,
+            newLines,
+            header,
+            lines: [],
+            patch: "",
+        };
+    }
+    pushHunkLine(line) {
+        const hunk = this.activeHunk;
+        if (hunk === undefined) {
+            return;
+        }
+        const prefix = line[0];
+        const text = prefix === "+" || prefix === "-" || prefix === " " ? line.slice(1) : line;
+        if (prefix === "+") {
+            hunk.lines.push({ kind: "add", oldNumber: null, newNumber: this.newCursor, text });
+            this.newCursor += 1;
+            return;
+        }
+        if (prefix === "-") {
+            hunk.lines.push({ kind: "del", oldNumber: this.oldCursor, newNumber: null, text });
+            this.oldCursor += 1;
+            return;
+        }
+        hunk.lines.push({ kind: "ctx", oldNumber: this.oldCursor, newNumber: this.newCursor, text });
+        this.oldCursor += 1;
+        this.newCursor += 1;
+    }
+    closeHunk() {
+        if (this.activeHunk !== undefined) {
+            this.activeHunk.patch = this.hunkRaw;
+            this.hunks.push(this.activeHunk);
+            this.activeHunk = undefined;
+            this.hunkRaw = "";
+        }
+    }
+}
+function parseDiffGitLine(line) {
+    const rest = line.slice("diff --git ".length);
+    const match = /^a\/(.*) b\/(.*)$/.exec(rest);
+    if (!match || match[1] === undefined || match[2] === undefined) {
+        return { oldPath: rest, newPath: rest };
+    }
+    if (match[1] === match[2]) {
+        return { oldPath: match[1], newPath: match[2] };
+    }
+    const equal = /^a\/(.*) b\/\1$/.exec(rest);
+    if (equal && equal[1] !== undefined) {
+        return { oldPath: equal[1], newPath: equal[1] };
+    }
+    return { oldPath: match[1], newPath: match[2] };
+}
+function stripDiffPath(raw) {
+    const withoutTab = raw.split("\t")[0] ?? raw;
+    if (withoutTab === "/dev/null") {
+        return undefined;
+    }
+    if (withoutTab.startsWith("a/") || withoutTab.startsWith("b/")) {
+        return withoutTab.slice(2);
+    }
+    return withoutTab;
+}
+export function flattenHunks(files) {
+    const hunks = [];
+    for (const file of files) {
+        if (file.binary) {
+            continue;
+        }
+        hunks.push(...file.hunks);
+    }
+    return hunks;
+}
+export function fileLanguage(path) {
+    const ext = path.split(".").pop()?.toLowerCase();
+    switch (ext) {
+        case "ts":
+        case "mts":
+        case "cts":
+            return "typescript";
+        case "tsx":
+            return "tsx";
+        case "js":
+        case "mjs":
+        case "cjs":
+            return "javascript";
+        case "jsx":
+            return "jsx";
+        case "json":
+            return "json";
+        case "css":
+            return "css";
+        case "html":
+        case "htm":
+            return "html";
+        case "md":
+        case "mdx":
+            return "markdown";
+        case "yml":
+        case "yaml":
+            return "yaml";
+        case "py":
+            return "python";
+        case "go":
+            return "go";
+        case "rs":
+            return "rust";
+        case "sh":
+        case "bash":
+            return "bash";
+        default:
+            return "plaintext";
+    }
+}

package/dist/git/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/git/diff.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAEtD,MAAM,WAAW,GAAG,6CAA6C,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAW,EACX,OAAe,EACf,OAAe;IAEf,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO;QACL,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE;QACjE,OAAO;QACP,OAAO;KACR,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,OAAe,EAAE,OAAe;IAC1E,MAAM,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,EAAE;QAC5B,MAAM;QACN,gBAAgB;QAChB,eAAe;QACf,KAAK;QACL,YAAY;QACZ,eAAe;QACf,kBAAkB;QAClB,GAAG,OAAO,MAAM,OAAO,EAAE;KAC1B,CAAC,CAAC;IACH,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,OAAe,EAAE,OAAe;IAC/E,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;YACpD,SAAS;QACX,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,MAAM,GAAG,GAAY;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC;IACF,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,IAAI,OAAgC,CAAC;IACrC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QACvD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;QAC/E,IAAI,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YACnC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC/B,CAAC;YACD,OAAO,GAAG,IAAI,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjC,CAAC;QACD,MAAM,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAc,EAAE,KAAiB;IAChE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC1F,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AAC1E,CAAC;AAED,MAAM,WAAW;IACf,IAAI,GAAG,EAAE,CAAC;IACV,OAAO,CAAqB;IAC5B,MAAM,GAAe,UAAU,CAAC;IAChC,MAAM,GAAG,KAAK,CAAC;IACf,KAAK,GAAe,EAAE,CAAC;IACf,OAAO,CAAqB;IAC5B,OAAO,CAAqB;IAC5B,UAAU,CAAqB;IAC/B,QAAQ,CAAqB;IAC7B,UAAU,CAAuB;IACjC,OAAO,GAAG,EAAE,CAAC;IACb,WAAW,CAAS;IACpB,KAAK,CAAS;IACd,SAAS,GAAG,CAAC,CAAC;IACd,SAAS,GAAG,CAAC,CAAC;IAEtB,YAAY,WAAmB,EAAE,OAAe;QAC9C,MAAM,MAAM,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;IACvB,CAAC;IAED,OAAO,CAAC,IAAY,EAAE,OAAe;QACnC,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC;QACtB,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YACzC,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC;QAC5B,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YACpD,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAChD,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;YACxB,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;YACxB,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;YACtB,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;YACxB,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC5E,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC;QACxD,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC;QACrD,MAAM,OAAO,GAAG,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/F,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAC1B,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC7D,MAAM,GAAG,OAAO,CAAC;YACnB,CAAC;iBAAM,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBACpE,MAAM,GAAG,SAAS,CAAC;YACrB,CAAC;iBAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBACjC,MAAM,GAAG,SAAS,CAAC;YACrB,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM;YACvB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBACtB,MAAM,IAAI,GAAa,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC;gBACzC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;gBACzB,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;QACP,MAAM,IAAI,GAAa;YACrB,IAAI;YACJ,MAAM;YACN,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK;SACN,CAAC;QACF,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACzB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,SAAS,CAAC,MAAc,EAAE,KAAsB,EAAE,OAAe;QACvE,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG;YAChB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ;YACR,QAAQ;YACR,QAAQ;YACR,QAAQ;YACR,MAAM;YACN,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,EAAE;SACV,CAAC;IACJ,CAAC;IAEO,YAAY,CAAC,IAAY;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC;QAC7B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACvF,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACnF,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACnF,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7F,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QACpB,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;IACtB,CAAC;IAEO,SAAS;QACf,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;YACrC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACjC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;YAC5B,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;CACF;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC/D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;IACD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,CAAC;IACD,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IAC7C,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/D,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAiB;IAC5C,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC;IACjD,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,IAAI,CAAC;QACV,KAAK,KAAK,CAAC;QACX,KAAK,KAAK;YACR,OAAO,YAAY,CAAC;QACtB,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,IAAI,CAAC;QACV,KAAK,KAAK,CAAC;QACX,KAAK,KAAK;YACR,OAAO,YAAY,CAAC;QACtB,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK;YACR,OAAO,MAAM,CAAC;QAChB,KAAK,IAAI,CAAC;QACV,KAAK,KAAK;YACR,OAAO,UAAU,CAAC;QACpB,KAAK,KAAK,CAAC;QACX,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,IAAI;YACP,OAAO,QAAQ,CAAC;QAClB,KAAK,IAAI;YACP,OAAO,IAAI,CAAC;QACd,KAAK,IAAI;YACP,OAAO,MAAM,CAAC;QAChB,KAAK,IAAI,CAAC;QACV,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB;YACE,OAAO,WAAW,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/git/exec.d.ts

@@ -0,0 +1,10 @@
+export declare class GitError extends Error {
+    readonly args: string[];
+    readonly stderr: string;
+    readonly code: number | null;
+    constructor(message: string, args: string[], stderr: string, code: number | null);
+}
+export declare function git(cwd: string, args: string[], opts?: {
+    allowFail?: boolean;
+}): Promise<string>;
+export declare function gitOk(cwd: string, args: string[]): Promise<boolean>;

package/dist/git/exec.js

@@ -0,0 +1,53 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export class GitError extends Error {
+    args;
+    stderr;
+    code;
+    constructor(message, args, stderr, code) {
+        super(message);
+        this.name = "GitError";
+        this.args = args;
+        this.stderr = stderr;
+        this.code = code;
+    }
+}
+export async function git(cwd, args, opts) {
+    try {
+        const { stdout } = await execFileAsync("git", ["-c", "core.quotepath=false", ...args], {
+            cwd,
+            encoding: "utf8",
+            maxBuffer: 64 * 1024 * 1024,
+        });
+        return stdout;
+    }
+    catch (error) {
+        const failure = asExecFailure(error);
+        if (opts?.allowFail) {
+            return failure.stdout;
+        }
+        throw new GitError(`git ${args.join(" ")} failed: ${failure.stderr.trim() || failure.message}`, args, failure.stderr, failure.code);
+    }
+}
+export async function gitOk(cwd, args) {
+    try {
+        await git(cwd, args);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function asExecFailure(error) {
+    if (typeof error === "object" && error !== null) {
+        const record = error;
+        return {
+            message: typeof record.message === "string" ? record.message : "git failed",
+            stdout: typeof record.stdout === "string" ? record.stdout : "",
+            stderr: typeof record.stderr === "string" ? record.stderr : "",
+            code: typeof record.code === "number" ? record.code : null,
+        };
+    }
+    return { message: "git failed", stdout: "", stderr: "", code: null };
+}

package/dist/git/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/git/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAW;IACf,MAAM,CAAS;IACf,IAAI,CAAgB;IAE7B,YAAY,OAAe,EAAE,IAAc,EAAE,MAAc,EAAE,IAAmB;QAC9E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,GAAW,EAAE,IAAc,EAAE,IAA8B;IACnF,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,sBAAsB,EAAE,GAAG,IAAI,CAAC,EAAE;YACrF,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;SAC5B,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,IAAI,EAAE,SAAS,EAAE,CAAC;YACpB,OAAO,OAAO,CAAC,MAAM,CAAC;QACxB,CAAC;QACD,MAAM,IAAI,QAAQ,CAChB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,EAC3E,IAAI,EACJ,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,IAAI,CACb,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,GAAW,EAAE,IAAc;IACrD,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AASD,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,KAKd,CAAC;QACF,OAAO;YACL,OAAO,EAAE,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY;YAC3E,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YAC9D,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YAC9D,IAAI,EAAE,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;SAC3D,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC"}

package/dist/git/log.d.ts

@@ -0,0 +1,8 @@
+export type CommitInfo = {
+    sha: string;
+    shortSha: string;
+    subject: string;
+    author: string;
+    date: string;
+};
+export declare function listCommits(cwd: string, baseRef: string, headRef: string): Promise<CommitInfo[]>;

package/dist/git/log.js

@@ -0,0 +1,26 @@
+import { git } from "./exec.js";
+export async function listCommits(cwd, baseRef, headRef) {
+    const stdout = await git(cwd, [
+        "log",
+        "--format=%H%x00%h%x00%s%x00%an%x00%ad",
+        "--date=short",
+        "--end-of-options",
+        `${baseRef}...${headRef}`,
+    ]);
+    if (stdout.trim() === "") {
+        return [];
+    }
+    return stdout
+        .split("\n")
+        .filter((line) => line.length > 0)
+        .map((line) => {
+        const [sha, shortSha, subject, author, date] = line.split("\0");
+        return {
+            sha: sha ?? "",
+            shortSha: shortSha ?? "",
+            subject: subject ?? "",
+            author: author ?? "",
+            date: date ?? "",
+        };
+    });
+}

package/dist/git/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/git/log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAUhC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,OAAe,EAAE,OAAe;IAC7E,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,EAAE;QAC5B,KAAK;QACL,uCAAuC;QACvC,cAAc;QACd,kBAAkB;QAClB,GAAG,OAAO,MAAM,OAAO,EAAE;KAC1B,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,MAAM;SACV,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChE,OAAO;YACL,GAAG,EAAE,GAAG,IAAI,EAAE;YACd,QAAQ,EAAE,QAAQ,IAAI,EAAE;YACxB,OAAO,EAAE,OAAO,IAAI,EAAE;YACtB,MAAM,EAAE,MAAM,IAAI,EAAE;YACpB,IAAI,EAAE,IAAI,IAAI,EAAE;SACjB,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/git/repo.d.ts

@@ -0,0 +1,7 @@
+export declare function assertWorkTree(cwd: string): Promise<void>;
+export declare function resolveCommit(cwd: string, ref: string): Promise<string>;
+export declare function mergeBase(cwd: string, baseRef: string, headRef: string): Promise<string>;
+export declare function defaultBaseRef(cwd: string): Promise<string>;
+export declare function rangeLabel(baseRef: string, headRef: string): string;
+export declare function assertSafeRef(ref: string): void;
+export declare function assertSafePath(path: string): void;

package/dist/git/repo.js

@@ -0,0 +1,45 @@
+import { git, gitOk } from "./exec.js";
+export async function assertWorkTree(cwd) {
+    const inside = await git(cwd, ["rev-parse", "--is-inside-work-tree"], { allowFail: true });
+    if (inside.trim() !== "true") {
+        throw new Error("cwd is not a git work tree. Run comprehende inside the repository under review.");
+    }
+}
+export async function resolveCommit(cwd, ref) {
+    assertSafeRef(ref);
+    const sha = await git(cwd, ["rev-parse", "--verify", "--end-of-options", `${ref}^{commit}`]);
+    return sha.trim();
+}
+export async function mergeBase(cwd, baseRef, headRef) {
+    const sha = await git(cwd, ["merge-base", baseRef, headRef]);
+    return sha.trim();
+}
+export async function defaultBaseRef(cwd) {
+    const remoteHead = await git(cwd, ["symbolic-ref", "--quiet", "refs/remotes/origin/HEAD"], { allowFail: true });
+    const trimmed = remoteHead.trim();
+    if (trimmed.startsWith("refs/remotes/")) {
+        return trimmed.slice("refs/remotes/".length);
+    }
+    for (const candidate of ["main", "master", "trunk"]) {
+        if (await gitOk(cwd, ["rev-parse", "--verify", "--end-of-options", `${candidate}^{commit}`])) {
+            return candidate;
+        }
+    }
+    throw new Error("could not detect a default base branch; pass --base <ref>");
+}
+export function rangeLabel(baseRef, headRef) {
+    return `${baseRef}...${headRef}`;
+}
+export function assertSafeRef(ref) {
+    if (ref.trim() === "") {
+        throw new Error("git ref must be a non-empty string");
+    }
+    if (ref.startsWith("-") || ref.includes("\0")) {
+        throw new Error(`invalid git ref: ${ref}`);
+    }
+}
+export function assertSafePath(path) {
+    if (path.trim() === "" || path.startsWith("/") || path.includes("\0") || path.split("/").includes("..")) {
+        throw new Error(`invalid path: ${path}`);
+    }
+}

package/dist/git/repo.js.map

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

package/dist/git/show.d.ts

@@ -0,0 +1,2 @@
+export declare function showFile(cwd: string, ref: string, path: string): Promise<string>;
+export declare function fileExistsAt(cwd: string, ref: string, path: string): Promise<boolean>;

package/dist/git/show.js

@@ -0,0 +1,18 @@
+import { assertSafePath, assertSafeRef } from "./repo.js";
+import { git } from "./exec.js";
+export async function showFile(cwd, ref, path) {
+    assertSafeRef(ref);
+    assertSafePath(path);
+    return git(cwd, ["show", "--end-of-options", `${ref}:${path}`]);
+}
+export async function fileExistsAt(cwd, ref, path) {
+    assertSafeRef(ref);
+    assertSafePath(path);
+    try {
+        await git(cwd, ["cat-file", "-e", `${ref}:${path}`]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/git/show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../src/git/show.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,GAAW,EAAE,IAAY;IACnE,aAAa,CAAC,GAAG,CAAC,CAAC;IACnB,cAAc,CAAC,IAAI,CAAC,CAAC;IACrB,OAAO,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,GAAW,EAAE,IAAY;IACvE,aAAa,CAAC,GAAG,CAAC,CAAC;IACnB,cAAc,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/package-root.d.ts

@@ -0,0 +1,2 @@
+export declare function findPackageRoot(from?: string): string;
+export declare function readPackageVersion(): string;

package/dist/package-root.js

@@ -0,0 +1,25 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+export function findPackageRoot(from = import.meta.url) {
+    let dir = dirname(fileURLToPath(from));
+    for (;;) {
+        const pkgPath = join(dir, "package.json");
+        if (existsSync(pkgPath)) {
+            const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+            if (pkg.name === "comprehende") {
+                return dir;
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            throw new Error("could not find the comprehende package root");
+        }
+        dir = parent;
+    }
+}
+export function readPackageVersion() {
+    const pkgPath = join(findPackageRoot(), "package.json");
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    return pkg.version;
+}

package/dist/package-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-root.js","sourceRoot":"","sources":["../src/package-root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,eAAe,CAAC,IAAI,GAAG,OAAO,IAAI,CAAC,GAAG;IACpD,IAAI,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IACvC,SAAS,CAAC;QACR,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC1C,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAsB,CAAC;YAC3E,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBAC/B,OAAO,GAAG,CAAC;YACb,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,EAAE,cAAc,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAwB,CAAC;IAC7E,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC"}

package/dist/review/coverage.d.ts

@@ -0,0 +1,20 @@
+import { readDiff } from "../git/diff.ts";
+import type { HunkRef, LiveHunk, ReviewDocument, ReviewGroup } from "../schema/types.ts";
+export type GroupCoverage = {
+    group: ReviewGroup;
+    hunks: LiveHunk[];
+    stale: HunkRef[];
+};
+export type ReviewCoverage = {
+    groups: GroupCoverage[];
+    unassigned: LiveHunk[];
+    stale: HunkRef[];
+    totalHunks: number;
+    assignedHunks: number;
+};
+export declare function coverReview(cwd: string, document: ReviewDocument): Promise<{
+    files: Awaited<ReturnType<typeof readDiff>>;
+    coverage: ReviewCoverage;
+}>;
+export declare function joinCoverage(document: ReviewDocument, live: LiveHunk[]): ReviewCoverage;
+export declare function coverageErrors(coverage: ReviewCoverage): string[];

package/dist/review/coverage.js

@@ -0,0 +1,56 @@
+import { flattenHunks, readDiff, toHunkRef } from "../git/diff.js";
+import { hunkKey } from "../schema/identity.js";
+export async function coverReview(cwd, document) {
+    const files = await readDiff(cwd, document.source.baseRef, document.source.headRef);
+    const live = flattenHunks(files);
+    return { files, coverage: joinCoverage(document, live) };
+}
+export function joinCoverage(document, live) {
+    const liveByKey = new Map();
+    for (const hunk of live) {
+        liveByKey.set(hunkKey(hunk), hunk);
+    }
+    const assignedKeys = new Set();
+    const allStale = [];
+    const groups = document.groups.map((group) => {
+        const hunks = [];
+        const stale = [];
+        for (const ref of group.hunkRefs) {
+            const match = liveByKey.get(hunkKey(ref));
+            if (match === undefined) {
+                stale.push(ref);
+                allStale.push(ref);
+                continue;
+            }
+            hunks.push(match);
+            assignedKeys.add(hunkKey(ref));
+        }
+        return { group, hunks, stale };
+    });
+    const unassigned = live.filter((hunk) => !assignedKeys.has(hunkKey(hunk)));
+    return {
+        groups,
+        unassigned,
+        stale: allStale,
+        totalHunks: live.length,
+        assignedHunks: assignedKeys.size,
+    };
+}
+export function coverageErrors(coverage) {
+    const errors = [];
+    if (coverage.unassigned.length > 0) {
+        errors.push(`coverage: ${coverage.unassigned.length} hunk(s) are not referenced by any group:\n${formatRefs(coverage.unassigned.map(toHunkRef))}`);
+    }
+    if (coverage.stale.length > 0) {
+        errors.push(`stale: ${coverage.stale.length} hunk ref(s) do not match the live git diff:\n${formatRefs(coverage.stale)}`);
+    }
+    return errors;
+}
+function formatRefs(refs) {
+    return refs
+        .map((ref) => {
+        const rename = ref.oldPath !== undefined ? `${ref.oldPath} -> ` : "";
+        return `  ${rename}${ref.path} @@ -${ref.oldStart},${ref.oldLines} +${ref.newStart},${ref.newLines} @@`;
+    })
+        .join("\n");
+}