@sealant/mend 0.1.0 → 0.1.1

package/dist/review.js

@@ -0,0 +1,559 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "@opentui/react/jsx-runtime";
+import { createHash } from "node:crypto";
+import { RGBA, SyntaxStyle, } from "@opentui/core";
+import { useKeyboard, useTerminalDimensions } from "@opentui/react";
+import { useQuery, useQueryClient } from "@tanstack/react-query";
+import { useEffect, useMemo, useRef, useState } from "react";
+import { assembleReviewInstruction, buildReviewFiles, visibleWhitespace, } from "./review-model.js";
+import { commentRange, deliverReview } from "./review-workflow.js";
+import { LIVE_STATUSES } from "./shared.js";
+import { openUrl } from "./terminal.js";
+import { ADD_WASH, AMBER, BG, COBALT, DELETE_WASH, FAINT, GREEN, INK, INK_2, MUTED, PANEL, RED, RULE, SYNTAX_FUNCTION, SYNTAX_KEYWORD, SYNTAX_NUMBER, SYNTAX_STRING, WASH, } from "./tui-theme.js";
+const REVIEW_KEY = (changeId) => ["review", changeId];
+const EDITOR_KEY_BINDINGS = [{ name: "return", ctrl: true, action: "submit" }];
+const syntaxStyle = SyntaxStyle.fromStyles({
+    keyword: { fg: RGBA.fromHex(SYNTAX_KEYWORD) },
+    string: { fg: RGBA.fromHex(SYNTAX_STRING) },
+    comment: { fg: RGBA.fromHex(FAINT), italic: true },
+    number: { fg: RGBA.fromHex(SYNTAX_NUMBER) },
+    function: { fg: RGBA.fromHex(SYNTAX_FUNCTION) },
+    variable: { fg: RGBA.fromHex(INK) },
+    default: { fg: RGBA.fromHex(INK) },
+});
+const truncate = (text, width) => {
+    const oneLine = text.replaceAll(/\s+/g, " ").trim();
+    if (width <= 1)
+        return "";
+    return oneLine.length <= width ? oneLine : `${oneLine.slice(0, width - 1)}…`;
+};
+const fetchReview = async (ctx, changeId) => {
+    const wire = await ctx.api("GET", `/changes/${changeId}/diff`);
+    const [comments, tour, passes, followUp, sessionDetail] = await Promise.all([
+        ctx.api("GET", `/changes/${changeId}/comments`),
+        ctx.api("GET", `/changes/${changeId}/tour`),
+        ctx.api("GET", `/changes/${changeId}/passes`),
+        ctx.api("GET", `/sessions/${wire.change.sessionId}/follow-up`),
+        ctx.api("GET", `/sessions/${wire.change.sessionId}`),
+    ]);
+    return {
+        wire,
+        files: buildReviewFiles(wire.diff, wire.files),
+        comments,
+        tour,
+        passes,
+        followUp,
+        sessionStatus: sessionDetail.session.status,
+    };
+};
+const commentPriority = (comment) => comment.state === "draft" ? 0 : comment.state === "open" ? 1 : 2;
+const orderedComments = (comments) => comments.toSorted((a, b) => {
+    const byState = commentPriority(a) - commentPriority(b);
+    return byState === 0 ? b.createdAt.localeCompare(a.createdAt) : byState;
+});
+const stateColor = (state) => state === "draft" || state === "open" ? AMBER : state === "addressed" ? INK_2 : FAINT;
+const stateGlyph = (state) => (state === "open" ? "●" : "○");
+const anchorOf = (comment) => comment.file === null
+    ? "change"
+    : `${comment.file}${comment.line === null ? "" : `:${comment.line}${comment.endLine === null || comment.endLine === comment.line ? "" : `-${comment.endLine}`}`}`;
+const passFact = (pass) => {
+    const label = pass.kind === "suggest" ? "suggestions" : pass.kind;
+    if (pass.status === "running")
+        return { text: `● ${label} running`, color: COBALT };
+    if (pass.status === "failed")
+        return { text: `● ${label} failed`, color: RED };
+    return {
+        text: `● ${label} observed · ${pass.findings ?? 0} ${pass.kind === "tour" ? "stops" : "drafts"}`,
+        color: GREEN,
+    };
+};
+const FileRow = ({ file, selected }) => (_jsxs("box", { height: 2, flexShrink: 0, backgroundColor: selected ? WASH : "transparent", children: [_jsxs("text", { height: 1, bg: "transparent", children: [_jsx("span", { fg: selected ? COBALT : FAINT, children: selected ? "▌ " : "  " }), _jsx("span", { fg: INK, children: file.path }), file.binary ? _jsx("span", { fg: AMBER, children: " \u00B7 binary" }) : null, file.likelyGenerated ? _jsx("span", { fg: FAINT, children: " \u00B7 inferred \u00B7 likely generated" }) : null] }), _jsxs("text", { height: 1, bg: "transparent", children: [_jsx("span", { children: "    " }), _jsxs("span", { fg: GREEN, children: ["+", file.additions] }), _jsx("span", { fg: FAINT, children: " " }), _jsxs("span", { fg: RED, children: ["\u2212", file.deletions] }), _jsxs("span", { fg: FAINT, children: [" ", "\u00B7 ", file.status, " \u00B7 ", file.hunks.length, " hunks"] })] })] }));
+const CommentRow = ({ comment, selected, }) => (_jsxs("box", { height: 2, flexShrink: 0, backgroundColor: selected ? WASH : "transparent", children: [_jsxs("text", { height: 1, bg: "transparent", children: [_jsx("span", { fg: selected ? COBALT : FAINT, children: selected ? "▌ " : "  " }), _jsxs("span", { fg: stateColor(comment.state), children: [stateGlyph(comment.state), " ", comment.state] }), _jsxs("span", { fg: FAINT, children: [" \u00B7 ", anchorOf(comment)] })] }), _jsxs("text", { height: 1, bg: "transparent", children: [_jsx("span", { children: "    " }), _jsx("span", { fg: comment.authorKind === "mend" ? COBALT : MUTED, children: comment.authorKind === "mend" ? "Mend · " : "You · " }), _jsx("span", { fg: INK, children: truncate(comment.body, 27) })] })] }));
+const Description = ({ data, tourIndex, stale, width, height, }) => {
+    const passFacts = data.passes.map(passFact);
+    const tourStop = data.tour?.stops[tourIndex] ?? null;
+    const stopEvidence = tourStop?.evidence[0] ?? null;
+    return (_jsxs("box", { height: height, border: true, borderStyle: "rounded", borderColor: stale ? AMBER : data.tour === null ? RULE : COBALT, title: " change description ", titleAlignment: "left", backgroundColor: PANEL, flexShrink: 0, flexDirection: "column", paddingX: 1, children: [_jsx("text", { height: 1, bg: "transparent", children: data.tour === null ? (_jsx("span", { fg: INK, children: "No description yet \u2014 t composes one from the diff and session record." })) : (_jsxs(_Fragment, { children: [_jsx("span", { fg: COBALT, children: "Mend uses inference \u00B7 " }), stale ? _jsx("span", { fg: AMBER, children: "diff changed since \u00B7 " }) : null, _jsx("span", { fg: INK, children: truncate(data.tour.summary, Math.max(20, width - 50)) })] })) }), height >= 5 && data.tour !== null ? (_jsx("text", { height: 1, bg: "transparent", children: tourStop === null ? (_jsxs("span", { fg: FAINT, children: ["inferred approach \u00B7 ", truncate(data.tour.approach ?? "No tour stops yet.", width - 24)] })) : (_jsxs(_Fragment, { children: [_jsxs("span", { fg: COBALT, children: ["stop ", tourIndex + 1, "/", data.tour.stops.length, " \u00B7 ", tourStop.title] }), _jsxs("span", { fg: FAINT, children: [tourStop.file === null
+                                    ? " · change"
+                                    : ` · ${tourStop.file}${tourStop.line === null ? "" : `:${tourStop.line}`}`, tourStop.grounded ? " · direct record" : " · inferred reading"] })] })) })) : null, height >= 6 && tourStop !== null ? (_jsxs("text", { height: 1, bg: "transparent", children: [_jsx("span", { fg: COBALT, children: tourStop.grounded ? "record-grounded narration · " : "inferred narration · " }), _jsx("span", { fg: MUTED, children: truncate(tourStop.narration, Math.max(20, width - 24)) })] })) : null, height >= 7 && tourStop !== null ? (_jsxs("text", { height: 1, bg: "transparent", children: [_jsx("span", { fg: stopEvidence === null ? AMBER : COBALT, children: stopEvidence === null
+                            ? "no direct evidence · "
+                            : `evidence seq ${stopEvidence.sequence} · ` }), _jsx("span", { fg: MUTED, children: truncate(stopEvidence?.excerpt ?? "this stop is labeled inferred", Math.max(20, width - 26)) })] })) : null, _jsxs("text", { height: 1, bg: "transparent", children: [passFacts.length === 0 ? (_jsx("span", { fg: FAINT, children: "Mend has not read this change." })) : (passFacts.map((fact, index) => (_jsxs("span", { children: [index > 0 ? _jsx("span", { fg: FAINT, children: " \u00B7 " }) : null, _jsx("span", { fg: fact.color, children: fact.text })] }, `${fact.text}-${index}`)))), data.followUp?.status === "pending" ? _jsx("span", { fg: AMBER, children: " \u00B7 follow-up pending" }) : null] })] }));
+};
+const CompactTourEvidence = ({ stop, index, total, width, }) => {
+    const evidence = stop.evidence[0] ?? null;
+    return (_jsxs("box", { height: 5, border: true, borderStyle: "rounded", borderColor: stop.grounded ? COBALT : RULE, title: ` tour stop ${index + 1}/${total} · ${stop.grounded ? "direct record" : "inferred reading"} `, titleAlignment: "left", backgroundColor: PANEL, flexShrink: 0, flexDirection: "column", paddingX: 1, children: [_jsx("text", { height: 1, fg: INK, bg: "transparent", children: truncate(stop.narration, Math.max(12, width - 6)) }), _jsxs("text", { height: 1, bg: "transparent", children: [_jsx("span", { fg: evidence === null ? AMBER : COBALT, children: evidence === null ? "no direct record link · " : `seq ${evidence.sequence} · ` }), _jsx("span", { fg: MUTED, children: truncate(evidence?.excerpt ?? "the narration is an inferred reading", Math.max(12, width - 26)) })] }), _jsx("text", { height: 1, fg: FAINT, bg: "transparent", children: ", previous stop \u00B7 . next stop" })] }));
+};
+const EvidenceCard = ({ comment, width, }) => (_jsxs("box", { height: Math.min(6, 4 + Math.min(2, comment.evidence.length)), border: true, borderStyle: "rounded", borderColor: comment.state === "draft" ? AMBER : RULE, title: ` ${anchorOf(comment)} · ${comment.authorKind === "mend" ? "Mend" : "You"} `, titleAlignment: "left", backgroundColor: PANEL, flexShrink: 0, flexDirection: "column", paddingX: 1, children: [_jsx("text", { height: 1, fg: INK, bg: "transparent", children: truncate(comment.body, Math.max(12, width - 6)) }), comment.suggestion === null ? null : (_jsxs("text", { height: 1, bg: "transparent", children: [_jsx("span", { fg: COBALT, children: "proposed \u00B7 " }), _jsx("span", { fg: MUTED, children: truncate(comment.suggestion, Math.max(12, width - 17)) })] })), comment.evidence.slice(0, 2).map((evidence) => (_jsxs("text", { height: 1, bg: "transparent", children: [_jsxs("span", { fg: FAINT, children: ["seq ", evidence.sequence, " \u00B7 "] }), _jsx("span", { fg: MUTED, children: truncate(evidence.excerpt, Math.max(12, width - 18)) })] }, `${evidence.sequence}-${evidence.excerpt}`)))] }));
+const EditorPanel = ({ editor, refValue, busy, onSubmit, }) => {
+    const title = editor.kind === "send"
+        ? " send review to session · edit before sending "
+        : ` comment · ${editor.file === null ? "change" : `${editor.file}:${editor.line ?? ""}`} `;
+    return (_jsxs("box", { border: true, borderStyle: "rounded", borderColor: COBALT, title: title, titleAlignment: "left", backgroundColor: BG, height: editor.kind === "send" ? 16 : 8, flexShrink: 0, flexDirection: "column", children: [_jsx("textarea", { ref: refValue, focused: true, initialValue: editor.kind === "send" ? editor.instruction : "", placeholder: editor.kind === "send" ? "Review instruction…" : "What should change, and why?", backgroundColor: BG, focusedBackgroundColor: BG, textColor: INK, focusedTextColor: INK, placeholderColor: FAINT, cursorColor: INK, keyBindings: [...EDITOR_KEY_BINDINGS], flexGrow: 1, onSubmit: onSubmit }), _jsx("text", { height: 1, bg: "transparent", children: _jsxs("span", { fg: FAINT, children: [" ctrl+enter ", busy ? "working…" : "save", " \u00B7 esc cancel"] }) })] }));
+};
+const errorMessage = (error) => error instanceof Error ? error.message : error === null ? "" : String(error);
+export function ReviewScreen({ ctx, projectName, session, changeId, onBack, onQuit, }) {
+    const queryClient = useQueryClient();
+    const { width, height } = useTerminalDimensions();
+    const wide = width >= 100;
+    const descriptionHeight = height >= 30 ? 7 : 5;
+    const { data, failureReason, isFetching } = useQuery({
+        queryKey: REVIEW_KEY(changeId),
+        queryFn: () => fetchReview(ctx, changeId),
+        retry: true,
+        retryDelay: 1000,
+    });
+    const [focus, setFocus] = useState("diff");
+    const [fileIndex, setFileIndex] = useState(0);
+    const [anchorIndex, setAnchorIndex] = useState(0);
+    const [commentIndex, setCommentIndex] = useState(0);
+    const [tourIndex, setTourIndex] = useState(0);
+    const [view, setView] = useState("unified");
+    const [wrap, setWrap] = useState(false);
+    const [showWhitespace, setShowWhitespace] = useState(false);
+    const [rangeStart, setRangeStart] = useState(null);
+    const [editor, setEditor] = useState(null);
+    const [busy, setBusy] = useState(false);
+    const [status, setStatus] = useState("");
+    const [checkpointState, setCheckpointState] = useState("recording");
+    const lockRef = useRef(false);
+    const editorRef = useRef(null);
+    const diffRef = useRef(null);
+    const diffScrollRef = useRef(null);
+    const fileScrollRef = useRef(null);
+    const commentScrollRef = useRef(null);
+    const checkpointedRef = useRef(false);
+    const files = useMemo(() => {
+        const order = {
+            added: 0,
+            modified: 1,
+            renamed: 2,
+            deleted: 3,
+        };
+        return (data?.files ?? []).toSorted((left, right) => order[left.status] - order[right.status] || left.path.localeCompare(right.path));
+    }, [data?.files]);
+    const selectedFile = files[Math.min(fileIndex, Math.max(0, files.length - 1))] ?? null;
+    const anchors = useMemo(() => selectedFile?.lines.filter((line) => line.commentable) ?? [], [selectedFile]);
+    const selectedAnchor = anchors[Math.min(anchorIndex, Math.max(0, anchors.length - 1))] ?? null;
+    const comments = useMemo(() => orderedComments(data?.comments ?? []), [data?.comments]);
+    const selectedComment = comments[Math.min(commentIndex, Math.max(0, comments.length - 1))] ?? null;
+    const lineComment = selectedFile === null || selectedAnchor === null
+        ? null
+        : (comments.find((comment) => comment.file === selectedFile.path &&
+            comment.line !== null &&
+            selectedAnchor.newLine !== null &&
+            comment.line <= selectedAnchor.newLine &&
+            (comment.endLine ?? comment.line) >= selectedAnchor.newLine) ?? null);
+    const detailComment = focus === "comments" ? selectedComment : lineComment;
+    const tourStops = data?.tour?.stops ?? [];
+    const activeTourIndex = Math.min(tourIndex, Math.max(0, tourStops.length - 1));
+    const activeTourStop = tourStops[activeTourIndex] ?? null;
+    const tourStale = useMemo(() => data?.tour === null || data?.tour === undefined
+        ? false
+        : createHash("sha256").update(data.wire.diff).digest("hex") !== data.tour.diffDigest, [data?.tour, data?.wire.diff]);
+    const refresh = () => {
+        void queryClient.invalidateQueries({ queryKey: REVIEW_KEY(changeId) });
+    };
+    const recordReviewCheckpoint = () => {
+        if (checkpointedRef.current)
+            return;
+        checkpointedRef.current = true;
+        setCheckpointState("recording");
+        void ctx
+            .api("POST", `/sessions/${session.id}/checkpoints`, { trigger: "review-open" })
+            .then(() => setCheckpointState("recorded"))
+            .catch((error) => {
+            checkpointedRef.current = false;
+            setCheckpointState("failed");
+            setStatus(`Checkpoint not recorded · ${errorMessage(error)} · K retries`);
+        });
+    };
+    useEffect(recordReviewCheckpoint, [ctx, session.id]);
+    useEffect(() => {
+        fileScrollRef.current?.scrollTo(Math.max(0, fileIndex * 2 - 2));
+    }, [fileIndex]);
+    useEffect(() => {
+        commentScrollRef.current?.scrollTo(Math.max(0, commentIndex * 2 - 2));
+    }, [commentIndex]);
+    useEffect(() => {
+        if (selectedAnchor === null)
+            return;
+        const row = view === "unified" ? selectedAnchor.unifiedRow : selectedAnchor.splitRow;
+        diffScrollRef.current?.scrollTo(Math.max(0, row - 3));
+    }, [selectedAnchor, view]);
+    useEffect(() => {
+        // Split can align a deletion and addition on one row; preserve their
+        // semantic colors there. Unified has one fact per row, so cobalt can mark
+        // the active comment anchor without lying about either side.
+        if (view !== "unified" || selectedAnchor === null || diffRef.current === null)
+            return;
+        const start = rangeStart === null ? selectedAnchor.newLine : rangeStart;
+        const selectedLine = selectedAnchor.newLine;
+        const highlighted = start === null || selectedLine === null
+            ? [selectedAnchor]
+            : anchors.filter((anchor) => anchor.newLine !== null &&
+                anchor.newLine >= Math.min(start, selectedLine) &&
+                anchor.newLine <= Math.max(start, selectedLine));
+        for (const anchor of highlighted) {
+            diffRef.current.setLineColor(anchor.unifiedRow, { gutter: COBALT, content: WASH });
+        }
+        return () => {
+            if (diffRef.current === null)
+                return;
+            for (const anchor of highlighted) {
+                const content = anchor.kind === "addition"
+                    ? ADD_WASH
+                    : anchor.kind === "deletion"
+                        ? DELETE_WASH
+                        : "transparent";
+                diffRef.current.setLineColor(anchor.unifiedRow, {
+                    gutter: "transparent",
+                    content,
+                });
+            }
+        };
+    }, [anchors, rangeStart, selectedAnchor, view]);
+    const moveFile = (delta) => {
+        if (files.length === 0)
+            return;
+        setFileIndex((current) => {
+            const next = Math.max(0, Math.min(files.length - 1, current + delta));
+            if (next !== current) {
+                setAnchorIndex(0);
+                setRangeStart(null);
+            }
+            return next;
+        });
+    };
+    const moveAnchor = (delta) => {
+        if (anchors.length === 0)
+            return;
+        setAnchorIndex((current) => Math.max(0, Math.min(anchors.length - 1, current + delta)));
+    };
+    const navigateToAnchor = (file, line) => {
+        if (file === null)
+            return;
+        const nextFileIndex = files.findIndex((candidate) => candidate.path === file);
+        if (nextFileIndex < 0)
+            return;
+        const nextFile = files[nextFileIndex];
+        const nextAnchorIndex = line === null
+            ? 0
+            : (nextFile?.lines.findIndex((candidate) => candidate.newLine !== null && candidate.newLine >= line) ?? -1);
+        setFileIndex(nextFileIndex);
+        setAnchorIndex(Math.max(0, nextAnchorIndex));
+        setRangeStart(null);
+    };
+    const selectComment = (index) => {
+        const next = comments[index];
+        if (next === undefined)
+            return;
+        setCommentIndex(index);
+        navigateToAnchor(next.file, next.line);
+    };
+    const moveComment = (delta) => {
+        if (comments.length === 0)
+            return;
+        const current = Math.min(commentIndex, comments.length - 1);
+        selectComment(Math.max(0, Math.min(comments.length - 1, current + delta)));
+    };
+    const moveTour = (delta) => {
+        if (tourStops.length === 0)
+            return;
+        const current = Math.min(tourIndex, tourStops.length - 1);
+        const nextIndex = Math.max(0, Math.min(tourStops.length - 1, current + delta));
+        const stop = tourStops[nextIndex];
+        setTourIndex(nextIndex);
+        if (stop !== undefined)
+            navigateToAnchor(stop.file, stop.line);
+    };
+    const moveHunk = (delta) => {
+        if (selectedFile === null || selectedAnchor === null)
+            return;
+        const target = Math.max(0, Math.min(selectedFile.hunks.length - 1, selectedAnchor.hunk + delta));
+        const next = anchors.findIndex((anchor) => anchor.hunk === target);
+        if (next >= 0)
+            setAnchorIndex(next);
+    };
+    const setWorking = (value) => {
+        lockRef.current = value;
+        setBusy(value);
+    };
+    const runAction = async (label, action, completed = `${label} · requested`) => {
+        setWorking(true);
+        setStatus(`${label}…`);
+        try {
+            await action();
+            setStatus(completed);
+            refresh();
+        }
+        catch (error) {
+            setStatus(errorMessage(error));
+        }
+        finally {
+            setWorking(false);
+        }
+    };
+    const openCommentEditor = (wholeChange) => {
+        if (wholeChange) {
+            setEditor({ kind: "comment", file: null, line: null, endLine: null });
+            return;
+        }
+        if (selectedFile?.status === "deleted" && selectedAnchor === null) {
+            setStatus("Deleted-side anchors are not persisted · use C for a change comment");
+            return;
+        }
+        if (selectedFile === null || selectedAnchor?.newLine === null || selectedAnchor === null) {
+            setStatus("No new-side line selected");
+            return;
+        }
+        const range = commentRange(rangeStart, selectedAnchor.newLine);
+        setEditor({
+            kind: "comment",
+            file: selectedFile.path,
+            line: range.line,
+            endLine: range.endLine === range.line ? null : range.endLine,
+        });
+        setRangeStart(null);
+    };
+    const openSendEditor = () => {
+        if (data === undefined)
+            return;
+        const sendable = data.comments.filter((comment) => comment.state === "open" && comment.sentToSessionId === null);
+        if (sendable.length === 0) {
+            setStatus("No unsent open comments — accept a draft or write a comment first");
+            return;
+        }
+        setEditor({
+            kind: "send",
+            instruction: assembleReviewInstruction(data.wire.change, sendable),
+        });
+    };
+    const submitEditor = async () => {
+        if (editor === null || lockRef.current)
+            return;
+        const value = editorRef.current?.plainText.trim() ?? "";
+        if (value === "") {
+            setStatus("Write something before saving");
+            return;
+        }
+        setWorking(true);
+        try {
+            if (editor.kind === "comment") {
+                await ctx.api("POST", `/changes/${changeId}/comments`, {
+                    file: editor.file,
+                    line: editor.line,
+                    endLine: editor.endLine,
+                    body: value,
+                });
+                setStatus(editor.file === null ? "Change comment saved" : "Inline comment saved");
+            }
+            else {
+                await ctx.api("POST", `/sessions/${session.id}/follow-up`, { instruction: value });
+                setStatus("Follow-up saved · y delivers it and relaunches the same session");
+            }
+            setEditor(null);
+            refresh();
+        }
+        catch (error) {
+            setStatus(errorMessage(error));
+        }
+        finally {
+            setWorking(false);
+        }
+    };
+    const updateComment = (state) => {
+        if (selectedComment === null)
+            return;
+        void runAction(`${state} ${anchorOf(selectedComment)}`, () => ctx.api("POST", `/changes/${changeId}/comments/${selectedComment.id}/state`, { state }));
+    };
+    const deliverAndRelaunch = () => {
+        if (data?.followUp?.status !== "pending") {
+            setStatus("No pending follow-up — s assembles the open review comments first");
+            return;
+        }
+        if (LIVE_STATUSES.has(data.sessionStatus)) {
+            setStatus("The session is live — deliver the pending follow-up once it settles");
+            return;
+        }
+        const instruction = data.followUp.instruction;
+        void runAction("Delivering review and relaunching the same session", () => deliverReview(ctx.api, session, instruction), "Review delivered · the same session is running · diff updates live");
+    };
+    const focusOrder = wide
+        ? ["files", "diff", "comments"]
+        : ["diff", "comments"];
+    const cycleFocus = (backwards) => {
+        const index = focusOrder.indexOf(focus);
+        const direction = backwards ? -1 : 1;
+        const next = (index + direction + focusOrder.length) % focusOrder.length;
+        const nextFocus = focusOrder[next] ?? "diff";
+        if (nextFocus === "comments" && selectedComment !== null) {
+            navigateToAnchor(selectedComment.file, selectedComment.line);
+        }
+        setFocus(nextFocus);
+    };
+    useKeyboard((key) => {
+        if (key.ctrl && key.name === "c")
+            return onQuit();
+        if (editor !== null) {
+            if (key.name === "escape" && !lockRef.current)
+                setEditor(null);
+            return;
+        }
+        if (lockRef.current)
+            return;
+        if (key.name === "q")
+            return onQuit();
+        if (key.name === "escape" || key.name === "backspace" || key.name === "h")
+            return onBack();
+        if (key.name === "tab")
+            return cycleFocus(key.shift);
+        if (key.name === "r") {
+            setStatus("Refreshing live change…");
+            return refresh();
+        }
+        if (key.name === "k" && key.shift) {
+            if (checkpointState !== "failed")
+                return;
+            recordReviewCheckpoint();
+            return;
+        }
+        if (key.name === "o") {
+            openUrl(`${ctx.config.url}/changes/${changeId}`);
+            setStatus("Opened web review");
+            return;
+        }
+        if (key.name === "c" && key.shift)
+            return openCommentEditor(true);
+        if (key.name === "s")
+            return openSendEditor();
+        if (key.name === "y")
+            return deliverAndRelaunch();
+        if (key.name === ",")
+            return moveTour(-1);
+        if (key.name === ".")
+            return moveTour(1);
+        if (key.name === "t") {
+            return void runAction(data?.tour === null ? "Compose description and tour" : "Recompose tour", () => ctx.api("POST", `/changes/${changeId}/tour`, {}));
+        }
+        if (key.name === "m") {
+            return void runAction("Mend reads the change", () => ctx.api("POST", `/changes/${changeId}/read`, {}));
+        }
+        if (key.name === "g") {
+            return void runAction("Draft concrete suggestions", () => ctx.api("POST", `/changes/${changeId}/suggest`, {}));
+        }
+        if (focus === "files") {
+            if (key.name === "j" || key.name === "down")
+                return moveFile(1);
+            if (key.name === "k" || key.name === "up")
+                return moveFile(-1);
+            if (key.name === "return" || key.name === "linefeed" || key.name === "l") {
+                return setFocus("diff");
+            }
+            return;
+        }
+        if (focus === "comments") {
+            if (key.name === "j" || key.name === "down")
+                return moveComment(1);
+            if (key.name === "k" || key.name === "up")
+                return moveComment(-1);
+            if (key.name === "a" && selectedComment?.state === "draft")
+                return updateComment("open");
+            if (key.name === "a" && selectedComment?.state === "open") {
+                return updateComment("addressed");
+            }
+            if (key.name === "x")
+                return updateComment("dismissed");
+            if (key.name === "u" && selectedComment !== null)
+                return updateComment("open");
+            if (key.name === "return" || key.name === "linefeed" || key.name === "l") {
+                if (selectedComment !== null)
+                    navigateToAnchor(selectedComment.file, selectedComment.line);
+                return setFocus("diff");
+            }
+            return;
+        }
+        if (key.name === "j" || key.name === "down")
+            return moveAnchor(1);
+        if (key.name === "k" || key.name === "up")
+            return moveAnchor(-1);
+        if (key.name === "n")
+            return moveFile(1);
+        if (key.name === "p")
+            return moveFile(-1);
+        if (key.name === "]")
+            return moveHunk(1);
+        if (key.name === "[")
+            return moveHunk(-1);
+        if (key.name === "c")
+            return openCommentEditor(false);
+        if (key.name === "v") {
+            if (selectedAnchor?.newLine === null || selectedAnchor === null) {
+                setStatus("Select a new-side line before starting a range");
+                return;
+            }
+            setRangeStart((current) => (current === null ? selectedAnchor.newLine : null));
+            setStatus(rangeStart === null ? `Range starts at line ${selectedAnchor.newLine}` : "Range cleared");
+            return;
+        }
+        if (key.name === "d" && wide)
+            return setView((current) => (current === "unified" ? "split" : "unified"));
+        if (key.name === "w")
+            return setWrap((current) => !current);
+        if (key.name === "z")
+            return setShowWhitespace((current) => !current);
+    });
+    if (data === undefined) {
+        return (_jsx("box", { flexGrow: 1, backgroundColor: BG, alignItems: "center", justifyContent: "center", children: _jsx("text", { bg: "transparent", children: _jsx("span", { fg: failureReason === null ? COBALT : AMBER, children: failureReason === null
+                        ? "Loading the live change…"
+                        : `${errorMessage(failureReason)} · retrying` }) }) }));
+    }
+    const additions = data.wire.files.reduce((sum, file) => sum + file.additions, 0);
+    const deletions = data.wire.files.reduce((sum, file) => sum + file.deletions, 0);
+    const openCount = data.comments.filter((comment) => comment.state === "open").length;
+    const draftCount = data.comments.filter((comment) => comment.state === "draft").length;
+    const displayRows = selectedFile === null
+        ? 1
+        : view === "unified"
+            ? Math.max(1, selectedFile.unifiedRows)
+            : Math.max(1, selectedFile.splitRows);
+    const displayPatch = selectedFile === null || !showWhitespace
+        ? (selectedFile?.patch ?? "")
+        : visibleWhitespace(selectedFile.patch);
+    const footer = editor !== null
+        ? " ctrl+enter save · esc cancel"
+        : focus === "files"
+            ? " files · ↑↓/jk move · enter review · tab pane · esc back · q quit"
+            : focus === "comments"
+                ? " comments · ↑↓/jk move · enter anchor · a accept/address · x dismiss · u reopen · tab pane"
+                : ` diff · ↑↓/jk lines · n/p files · [/ ] hunks · v range${rangeStart === null ? "" : `:${rangeStart}`} · c inline · C change · d layout · w wrap · z whitespace`;
+    const sidebar = wide ? (_jsxs("box", { width: 36, flexShrink: 0, flexDirection: "column", backgroundColor: BG, children: [_jsx("box", { border: true, borderStyle: "rounded", borderColor: focus === "files" ? COBALT : RULE, title: ` files · ${files.length} `, titleAlignment: "left", backgroundColor: PANEL, flexGrow: 1, minHeight: 6, children: _jsx("scrollbox", { ref: fileScrollRef, focused: focus === "files", flexGrow: 1, minHeight: 0, style: {
+                        rootOptions: { backgroundColor: PANEL, border: false },
+                        wrapperOptions: { backgroundColor: PANEL },
+                        viewportOptions: { backgroundColor: PANEL },
+                        contentOptions: { backgroundColor: PANEL },
+                    }, children: files.map((file, index) => (_jsxs("box", { flexShrink: 0, flexDirection: "column", children: [index === 0 || files[index - 1]?.status !== file.status ? (_jsx("text", { height: 1, fg: FAINT, bg: "transparent", children: `  ${file.status}` })) : null, _jsx(FileRow, { file: file, selected: index === fileIndex })] }, file.path))) }) }), _jsx("box", { border: true, borderStyle: "rounded", borderColor: focus === "comments" ? COBALT : RULE, title: ` comments · ${openCount} open${draftCount > 0 ? ` · ${draftCount} draft` : ""} `, titleAlignment: "left", backgroundColor: PANEL, flexGrow: 1, minHeight: 6, children: _jsx("scrollbox", { ref: commentScrollRef, focused: focus === "comments", flexGrow: 1, minHeight: 0, style: {
+                        rootOptions: { backgroundColor: PANEL, border: false },
+                        wrapperOptions: { backgroundColor: PANEL },
+                        viewportOptions: { backgroundColor: PANEL },
+                        contentOptions: { backgroundColor: PANEL },
+                    }, children: comments.length === 0 ? (_jsx("text", { height: 1, fg: FAINT, bg: "transparent", children: "  no review comments yet" })) : (comments.map((comment, index) => (_jsx(CommentRow, { comment: comment, selected: index === commentIndex }, comment.id)))) }) })] })) : null;
+    return (_jsxs("box", { flexGrow: 1, flexDirection: "column", backgroundColor: BG, children: [_jsxs("box", { height: 2, flexShrink: 0, flexDirection: "column", backgroundColor: BG, children: [_jsxs("text", { height: 1, bg: "transparent", children: [_jsx("span", { fg: INK, children: " mend" }), _jsx("span", { fg: FAINT, children: " / " }), _jsx("span", { fg: MUTED, children: projectName }), _jsx("span", { fg: FAINT, children: " / " }), _jsx("span", { fg: COBALT, children: "review" }), _jsxs("span", { fg: FAINT, children: [" ", "\u00B7 ", session.harness, " ", session.id.slice(0, 8)] }), isFetching ? _jsx("span", { fg: COBALT, children: " \u00B7 syncing" }) : null, _jsx("span", { fg: checkpointState === "failed" ? AMBER : FAINT, children: checkpointState === "recording"
+                                    ? " · checkpointing"
+                                    : checkpointState === "failed"
+                                        ? " · checkpoint incomplete"
+                                        : " · checkpoint recorded" })] }), _jsxs("text", { height: 1, bg: "transparent", children: [_jsxs("span", { fg: FAINT, children: [" ", data.wire.change.branch.replace(/^mend\/session\//, "session ")] }), _jsxs("span", { fg: FAINT, children: [" \u00B7 worktree vs ", data.wire.change.baseSha.slice(0, 12), " \u00B7 "] }), _jsxs("span", { fg: MUTED, children: [files.length, " files"] }), _jsxs("span", { fg: GREEN, children: [" +", additions] }), _jsxs("span", { fg: RED, children: [" \u2212", deletions] }), _jsxs("span", { fg: AMBER, children: [" \u00B7 ", openCount, " open"] })] })] }), _jsx(Description, { data: data, tourIndex: activeTourIndex, stale: tourStale, width: width, height: descriptionHeight }), _jsxs("box", { flexGrow: 1, minHeight: 0, flexDirection: "row", backgroundColor: BG, children: [sidebar, _jsxs("box", { flexGrow: 1, minWidth: 0, minHeight: 0, flexDirection: "column", backgroundColor: BG, children: [_jsx("box", { border: true, borderStyle: "rounded", borderColor: focus === "diff" ? COBALT : RULE, title: selectedFile === null
+                                    ? " diff "
+                                    : ` ${selectedFile.path} · ${view}${selectedFile.likelyGenerated ? " · inferred likely generated" : ""}${showWhitespace ? " · whitespace" : ""}${wrap ? " · wrapped" : ""} `, titleAlignment: "left", backgroundColor: PANEL, flexGrow: 1, minHeight: 0, children: selectedFile === null || selectedFile.patch === "" || selectedFile.binary ? (_jsx("box", { flexGrow: 1, alignItems: "center", justifyContent: "center", children: _jsx("text", { fg: FAINT, bg: "transparent", children: files.length === 0
+                                            ? "The worktree matches its base — nothing to review yet."
+                                            : selectedFile?.binary === true
+                                                ? "Binary change — text diff unavailable; statistics remain reviewable."
+                                                : "This file has no renderable text patch." }) })) : (_jsx("scrollbox", { ref: diffScrollRef, focused: focus === "diff", flexGrow: 1, minHeight: 0, scrollX: true, style: {
+                                        rootOptions: { backgroundColor: PANEL, border: false },
+                                        wrapperOptions: { backgroundColor: PANEL },
+                                        viewportOptions: { backgroundColor: PANEL },
+                                        contentOptions: { backgroundColor: PANEL },
+                                    }, children: _jsx("diff", { ref: diffRef, diff: displayPatch, view: view, syncScroll: true, ...(selectedFile.filetype === undefined
+                                            ? {}
+                                            : { filetype: selectedFile.filetype }), syntaxStyle: syntaxStyle, wrapMode: wrap ? "word" : "none", showLineNumbers: true, fg: INK, lineNumberFg: FAINT, lineNumberBg: "transparent", contextBg: "transparent", contextContentBg: "transparent", addedBg: ADD_WASH, addedContentBg: ADD_WASH, removedBg: DELETE_WASH, removedContentBg: DELETE_WASH, addedSignColor: GREEN, removedSignColor: RED, addedLineNumberBg: "transparent", removedLineNumberBg: "transparent", selectionBg: WASH, selectionFg: INK, width: "100%", height: displayRows, flexShrink: 0 }, `${selectedFile.path}-${view}-${wrap}-${showWhitespace}`) })) }), focus === "comments" && detailComment !== null ? (_jsx(EvidenceCard, { comment: detailComment, width: wide ? width - 38 : width })) : height < 30 && activeTourStop !== null ? (_jsx(CompactTourEvidence, { stop: activeTourStop, index: activeTourIndex, total: tourStops.length, width: width })) : detailComment !== null ? (_jsx(EvidenceCard, { comment: detailComment, width: wide ? width - 38 : width })) : null] })] }), editor === null ? null : (_jsx(EditorPanel, { editor: editor, refValue: editorRef, busy: busy, onSubmit: () => void submitEditor() })), _jsx("text", { height: 1, fg: status === "" ? FAINT : AMBER, bg: "transparent", children: status === ""
+                    ? ` m read · g suggest · t tour · ,/. tour stops · s draft review${data.followUp?.status === "pending" ? " · y deliver & relaunch" : ""} · o web · r refresh`
+                    : ` ${status}` }), _jsx("text", { height: 1, fg: FAINT, bg: "transparent", children: footer })] }));
+}

package/dist/shared.js

@@ -0,0 +1,48 @@
+import { spawnSync } from "node:child_process";
+import * as path from "node:path";
+/**
+ * Facts both entry points need: how each harness launches and resumes, which
+ * session statuses mean "live", and how a cwd resolves to an adopted project.
+ * Kept dependency-free so main.ts stays runnable on plain Node >= 22.
+ */
+export const HARNESS_COMMANDS = {
+    codex: ["codex"],
+    claude: ["claude"],
+    opencode: ["opencode"],
+};
+/** How each harness takes an instruction as its opening prompt. */
+export const CONTINUE_COMMANDS = {
+    codex: (instruction) => ["codex", instruction],
+    claude: (instruction) => ["claude", instruction],
+    opencode: (instruction) => ["opencode", "run", instruction],
+};
+export const LIVE_STATUSES = new Set([
+    "starting",
+    "running",
+    "waiting",
+    "idle",
+]);
+/** The cwd's adopted project: adopted-from-here first, then a basename match. */
+export const matchProjectByCwd = (projects, cwd) => {
+    const byOrigin = projects.find((p) => p.originUrl !== null && cwd.startsWith(p.originUrl));
+    const byName = projects.find((p) => p.name === path.basename(cwd));
+    return byOrigin ?? byName;
+};
+/** The repository root of `cwd`, or null when it is not inside a git repo. */
+export const gitTopLevel = (cwd) => {
+    const result = spawnSync("git", ["rev-parse", "--show-toplevel"], { cwd, encoding: "utf8" });
+    return result.status === 0 ? result.stdout.trim() : null;
+};
+/**
+ * The store's name charset is /^[a-z0-9][a-z0-9._-]{0,63}$/ (server-enforced).
+ * Derived defaults (a directory called "Mend") get normalized instead of
+ * bounced; an explicit --name is sent as typed so the server's rule teaches.
+ */
+export const normalizeProjectName = (raw) => {
+    const slug = raw
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/^[^a-z0-9]+/, "")
+        .replace(/-+$/, "");
+    return slug === "" ? "project" : slug.slice(0, 64);
+};

package/dist/terminal.js

@@ -0,0 +1,8 @@
+import { spawn } from "node:child_process";
+/** Open a Mend web surface without keeping the terminal process alive. */
+export const openUrl = (target) => {
+    const opener = process.platform === "darwin" ? "open" : "xdg-open";
+    const child = spawn(opener, [target], { detached: true, stdio: "ignore" });
+    child.on("error", () => undefined);
+    child.unref();
+};

package/dist/tui-theme.js

@@ -0,0 +1,25 @@
+/**
+ * Evidence Review's canonical dark tokens, transcribed from
+ * packages/ui/src/styles/globals.css because a terminal cannot consume CSS
+ * custom properties. Component code imports semantic names from here; this
+ * file is the CLI's single color authority.
+ */
+export const BG = "#1c1c1f";
+export const PANEL = "#232327";
+export const INK = "#eceae6";
+export const INK_2 = "#c2c0bd";
+export const MUTED = "#9a978f";
+export const FAINT = "#76746d";
+export const RULE = "#2e2c28";
+export const COBALT = "#5781ea";
+export const WASH = "#1a2238";
+export const AMBER = "#d9a93a";
+export const GREEN = "#5faf78";
+export const RED = "#e0726a";
+export const ADD_WASH = "#29312f";
+export const DELETE_WASH = "#342a2d";
+/** Syntax colors are centralized too; they are subordinate to semantic UI color. */
+export const SYNTAX_KEYWORD = "#c8a0e8";
+export const SYNTAX_STRING = "#8fc49f";
+export const SYNTAX_NUMBER = "#dfbd78";
+export const SYNTAX_FUNCTION = "#8eb7ef";