@sealant/mend 0.4.0 → 0.6.0

package/dist/pair.js

@@ -0,0 +1,83 @@
+const paint = (code) => (text) => process.stdout.isTTY === true ? `[${code}m${text}` : text;
+const dim = paint("2");
+const green = paint("32");
+const say = (line) => process.stdout.write(`${line}\n`);
+const fail = (message) => {
+    process.stderr.write(`mend: ${message}\n`);
+    process.exit(1);
+};
+const takeFlagValue = (args, flag) => {
+    const at = args.indexOf(flag);
+    return at !== -1 && args[at + 1] !== undefined ? String(args[at + 1]) : null;
+};
+/**
+ * The code as a human reads it aloud: 8 Crockford characters in two groups. The
+ * server compares case-insensitively with dashes stripped, so the dash is purely
+ * for the eye and either form can be typed back.
+ */
+export const groupCode = (code) => {
+    const bare = code.replace(/[^0-9a-z]/gi, "").toUpperCase();
+    return bare.length <= 4 ? bare : `${bare.slice(0, 4)}-${bare.slice(4)}`;
+};
+/** The scanned string. The device reads the base URL and the code out of it, nothing else. */
+export const pairingLink = (url, code) => `mend://pair?u=${encodeURIComponent(url)}&c=${code}`;
+/**
+ * Tailscale hands every node an IPv4 in the CGNAT range 100.64.0.0/10 — the same
+ * observation packages/api/src/machine.ts makes. A tailnet URL is preferred because
+ * it keeps working when the phone leaves the LAN.
+ */
+const isTailnetUrl = (value) => {
+    let host;
+    try {
+        host = new URL(value).hostname;
+    }
+    catch {
+        return false;
+    }
+    const parts = host.split(".").map(Number);
+    const [first, second] = parts;
+    if (parts.length !== 4 || first === undefined || second === undefined)
+        return false;
+    return first === 100 && second >= 64 && second <= 127;
+};
+/** `--url` wins; otherwise the tailnet address, otherwise the first candidate the server offered. */
+export const chooseUrl = (urls, override) => override ?? urls.find(isTailnetUrl) ?? urls[0] ?? null;
+/** Whole minutes left, floored at 0; null when the server sent a date this CLI cannot read. */
+export const minutesUntil = (expiresAt, now = Date.now()) => {
+    const at = Date.parse(expiresAt);
+    if (Number.isNaN(at))
+        return null;
+    return Math.max(0, Math.round((at - now) / 60_000));
+};
+/** The QR as block characters. Deliberately not gated on isTTY — a piped QR still scans. */
+export const renderQr = async (text) => {
+    const { toString: toQrString } = await import("qrcode");
+    const options = { type: "terminal", small: true };
+    return (await toQrString(text, options)).trimEnd();
+};
+/**
+ * `mend pair [--url <base url>]`: mint a pairing code and show it. The device names
+ * itself when it claims the code, so this side sends nothing but the request.
+ */
+export const pairCommand = async (args, api) => {
+    const pairing = await api("POST", "/me/devices/pairings");
+    const url = chooseUrl(pairing.urls, takeFlagValue(args, "--url"));
+    if (url === null) {
+        return fail("no LAN or tailnet address to hand the device — pass one: mend pair --url http://<host>:<port>");
+    }
+    const minutes = minutesUntil(pairing.expiresAt);
+    say(await renderQr(pairingLink(url, pairing.code)));
+    say(`${green("✓")} pairing code ${groupCode(pairing.code)}`);
+    say(`  ${dim("url")}     ${url}`);
+    say(`  ${dim("expires")} ${minutes === null ? pairing.expiresAt : `in ${minutes} min`} ${dim("· one device, once")}`);
+    say("");
+    say(dim("  scan it in the Mend app, or enter the url and the code there by hand"));
+    say(dim("  the app is apps/mobile — build it yourself; it is not published yet"));
+};
+/** `mend qr <text>`: print a terminal QR of anything. Hidden from help; the installer uses it. */
+export const qrCommand = async (args) => {
+    const text = args.join(" ").trim();
+    if (text === "")
+        return fail("usage: mend qr <text>");
+    say(await renderQr(text));
+};

package/dist/review-workflow.js

@@ -1,15 +1,8 @@
-import { CONTINUE_COMMANDS } from "./shared.js";
 export const reviewTargetForSession = (session, annotation, projectName) => annotation?.changeId === null || annotation?.changeId === undefined
     ? null
     : { session, changeId: annotation.changeId, projectName };
 export const commentRange = (start, current) => start === null
     ? { line: current, endLine: null }
     : { line: Math.min(start, current), endLine: Math.max(start, current) };
-/** Close the review loop without changing session identity or worktree. */
-export const deliverReview = async (api, session, instruction) => {
-    const build = CONTINUE_COMMANDS[session.harness];
-    if (build === undefined)
-        throw new Error(`Harness “${session.harness}” has no known relaunch command`);
-    await api("POST", `/sessions/${session.id}/follow-up/deliver`, {});
-    await api("POST", `/sessions/${session.id}/launch`, { argv: build(instruction) });
-};
+/** One server-owned operation: persist intent, launch, correlate, finalize. */
+export const deliverReview = (api, sessionId, input) => api("POST", `/sessions/${sessionId}/follow-up/deliver`, input);

package/dist/review.js

@@ -1,12 +1,11 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "@opentui/react/jsx-runtime";
-import { createHash } from "node:crypto";
+import { createHash, randomUUID } 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];
@@ -27,7 +26,19 @@ const truncate = (text, width) => {
     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 opened = await ctx.api("POST", `/changes/${changeId}/reviews/open`, {
+        idempotencyKey: `cli-review:${changeId}`,
+    });
+    const pinned = await ctx.api("GET", `/changes/${changeId}/reviews/${opened.slice.id}/diff`);
+    const wire = {
+        change: pinned.change,
+        diff: pinned.patch,
+        files: pinned.files.map((file) => ({
+            path: file.newPath ?? file.oldPath ?? "unknown path",
+            additions: file.additions,
+            deletions: file.deletions,
+        })),
+    };
     const [comments, tour, passes, followUp, sessionDetail] = await Promise.all([
         ctx.api("GET", `/changes/${changeId}/comments`),
         ctx.api("GET", `/changes/${changeId}/tour`),
@@ -37,6 +48,11 @@ const fetchReview = async (ctx, changeId) => {
     ]);
     return {
         wire,
+        sliceId: pinned.slice.id,
+        checkpointAId: pinned.checkpointA.id,
+        checkpointBId: pinned.checkpointB.id,
+        diffDigest: pinned.slice.diffDigest,
+        anchorFiles: pinned.anchorFiles,
         files: buildReviewFiles(wire.diff, wire.files),
         comments,
         tour,
@@ -113,14 +129,13 @@ export function ReviewScreen({ ctx, projectName, session, changeId, onBack, onQu
     const [editor, setEditor] = useState(null);
     const [busy, setBusy] = useState(false);
     const [status, setStatus] = useState("");
-    const [checkpointState, setCheckpointState] = useState("recording");
+    const checkpointState = data === undefined ? (isFetching ? "recording" : "failed") : "recorded";
     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,
@@ -152,21 +167,6 @@ export function ReviewScreen({ ctx, projectName, session, changeId, onBack, onQu
     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]);
@@ -325,6 +325,8 @@ export function ReviewScreen({ ctx, projectName, session, changeId, onBack, onQu
         setEditor({
             kind: "send",
             instruction: assembleReviewInstruction(data.wire.change, sendable),
+            commentIds: sendable.map((comment) => comment.id),
+            idempotencyKey: `cli-follow-up:${data.sliceId}:${randomUUID()}`,
         });
     };
     const submitEditor = async () => {
@@ -338,17 +340,54 @@ export function ReviewScreen({ ctx, projectName, session, changeId, onBack, onQu
         setWorking(true);
         try {
             if (editor.kind === "comment") {
-                await ctx.api("POST", `/changes/${changeId}/comments`, {
-                    file: editor.file,
-                    line: editor.line,
-                    endLine: editor.endLine,
+                if (data === undefined)
+                    throw new Error("The pinned Review is not available.");
+                const anchorFile = data.anchorFiles.find((file) => (file.newPath ?? file.oldPath) === editor.file);
+                const endLine = editor.endLine ?? editor.line;
+                const hunk = editor.line === null || endLine === null
+                    ? null
+                    : (anchorFile?.hunks.find((candidate) => candidate.newLines > 0 &&
+                        editor.line !== null &&
+                        editor.line >= candidate.newStart &&
+                        endLine <= candidate.newStart + candidate.newLines - 1) ?? null);
+                if (editor.file !== null && (anchorFile === undefined || hunk === null)) {
+                    throw new Error("The selected line is outside the pinned Review anchor.");
+                }
+                await ctx.api("POST", `/changes/${changeId}/reviews/${data.sliceId}/comments`, {
+                    target: editor.file === null
+                        ? {
+                            oldPath: null,
+                            newPath: null,
+                            side: null,
+                            startLine: null,
+                            endLine: null,
+                            hunkContextHash: null,
+                        }
+                        : {
+                            oldPath: anchorFile?.oldPath ?? null,
+                            newPath: anchorFile?.newPath ?? null,
+                            side: "new",
+                            startLine: editor.line,
+                            endLine,
+                            hunkContextHash: hunk?.contextHash ?? null,
+                        },
                     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");
+                if (data === undefined)
+                    throw new Error("The pinned Review is not available.");
+                await deliverReview(ctx.api, session.id, {
+                    reviewSliceId: data.sliceId,
+                    checkpointAId: data.checkpointAId,
+                    checkpointBId: data.checkpointBId,
+                    diffDigest: data.diffDigest,
+                    commentIds: editor.commentIds,
+                    instruction: value,
+                    idempotencyKey: editor.idempotencyKey,
+                });
+                setStatus("Follow-up delivery requested · retry keeps the same run");
             }
             setEditor(null);
             refresh();
@@ -366,16 +405,29 @@ export function ReviewScreen({ ctx, projectName, session, changeId, onBack, onQu
         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");
+        const followUp = data?.followUp ?? null;
+        if (followUp === null || followUp.status === "delivered" || followUp.status === "superseded") {
+            setStatus("No retryable 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");
+        if (followUp.reviewSliceId === null ||
+            followUp.checkpointAId === null ||
+            followUp.checkpointBId === null ||
+            followUp.diffDigest === null ||
+            followUp.idempotencyKey === null) {
+            setStatus("Legacy follow-up · recreate it from a pinned Review before delivery");
             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 input = {
+            reviewSliceId: followUp.reviewSliceId,
+            checkpointAId: followUp.checkpointAId,
+            checkpointBId: followUp.checkpointBId,
+            diffDigest: followUp.diffDigest,
+            commentIds: followUp.commentIds,
+            instruction: followUp.instruction,
+            idempotencyKey: followUp.idempotencyKey,
+        };
+        void runAction("Delivering the persisted Review bundle", () => deliverReview(ctx.api, session.id, input), "Delivery reconciled · the same idempotency key names one run");
     };
     const focusOrder = wide
         ? ["files", "diff", "comments"]
@@ -410,12 +462,6 @@ export function ReviewScreen({ ctx, projectName, session, changeId, onBack, onQu
             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");
@@ -518,13 +564,13 @@ export function ReviewScreen({ ctx, projectName, session, changeId, onBack, onQu
     const displayPatch = selectedFile === null || !showWhitespace
         ? (selectedFile?.patch ?? "")
         : visibleWhitespace(selectedFile.patch);
-    const footer = editor !== null
-        ? " ctrl+enter save · esc cancel"
-        : focus === "files"
+    const footer = editor === null
+        ? 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`;
+                : ` diff · ↑↓/jk lines · n/p files · [/ ] hunks · v range${rangeStart === null ? "" : `:${rangeStart}`} · c inline · C change · d layout · w wrap · z whitespace`
+        : " ctrl+enter save · esc cancel";
     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 },
@@ -553,7 +599,7 @@ export function ReviewScreen({ ctx, projectName, session, changeId, onBack, onQu
                                         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 === ""
+                                            : { 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 ? null : (_jsx(EvidenceCard, { comment: detailComment, width: wide ? width - 38 : width }))] })] }), 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

@@ -18,17 +18,163 @@ export const CONTINUE_COMMANDS = {
     claude: (instruction) => ["claude", instruction],
     opencode: (instruction) => ["opencode", "run", instruction],
 };
+/** Mirror of @mend/domain/workbench harness-launch.ts — the CLI ships dependency-free. */
+export const EFFORT_LEVELS = ["low", "medium", "high", "xhigh", "max"];
+const LAUNCH_ERROR = {
+    project: null,
+    prompt: null,
+    model: null,
+    effort: null,
+    base: null,
+    ask: false,
+    fast: false,
+    custom: [],
+};
+/**
+ * `mend claude|codex|opencode ["prompt"] [--model <id>] [--effort <level>]
+ * [--base <ref>] [--ask] [--project <p>]`, plus `mend run … -- <command...>`.
+ * The first non-flag positional is the prompt; a second one is an error so a
+ * forgotten quote fails loudly instead of launching with half a sentence.
+ */
+export const parseLaunchArgs = (args) => {
+    const dashdash = args.indexOf("--");
+    const custom = dashdash === -1 ? [] : args.slice(dashdash + 1);
+    const flagArgs = dashdash === -1 ? args : args.slice(0, dashdash);
+    let project = null;
+    let prompt = null;
+    let model = null;
+    let effort = null;
+    let base = null;
+    let ask = false;
+    let fast = false;
+    for (let index = 0; index < flagArgs.length; index += 1) {
+        const arg = flagArgs[index] ?? "";
+        if (arg === "--ask") {
+            ask = true;
+            continue;
+        }
+        if (arg === "--fast") {
+            fast = true;
+            continue;
+        }
+        if (arg === "--project" || arg === "--model" || arg === "--effort" || arg === "--base") {
+            const value = flagArgs[index + 1];
+            if (value === undefined)
+                return { ...LAUNCH_ERROR, error: `${arg} needs a value` };
+            if (arg === "--project")
+                project = value;
+            else if (arg === "--model")
+                model = value;
+            else if (arg === "--effort")
+                effort = value;
+            else
+                base = value;
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("-")) {
+            // Also catches a prompt starting with "-", which the harness would
+            // otherwise read as a flag of its own.
+            return {
+                ...LAUNCH_ERROR,
+                error: `unknown flag ${arg} — quote the prompt if it starts with "-"`,
+            };
+        }
+        if (prompt !== null) {
+            return {
+                ...LAUNCH_ERROR,
+                error: 'one prompt only — quote it: mend claude "fix the auth test"',
+            };
+        }
+        prompt = arg;
+    }
+    if (effort !== null && !EFFORT_LEVELS.includes(effort)) {
+        return { ...LAUNCH_ERROR, error: `--effort must be one of ${EFFORT_LEVELS.join(", ")}` };
+    }
+    return { project, prompt, model, effort, base, ask, fast, custom, error: null };
+};
 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;
+/**
+ * Whether the session's AGENT is live. Session status is a fold over every process — a session
+ * reads `idle` while a shell holds the workspace after its agent ended — so the agent's own row
+ * answers when one exists; `starting` is a launch with no row yet.
+ */
+export const agentIsLive = (session, currentAgent) => currentAgent === null
+    ? LIVE_STATUSES.has(session.status)
+    : session.status === "starting" ||
+        (currentAgent.exitedAt === null &&
+            (currentAgent.status === "starting" || currentAgent.status === "running"));
+/** What an ended agent process's exit says about the work; null while it runs. */
+export const agentOutcome = (currentAgent) => {
+    if (currentAgent === null || currentAgent.exitedAt === null)
+        return null;
+    if (currentAgent.status === "stopped")
+        return "stopped";
+    if (currentAgent.harness === "shell")
+        return "completed";
+    return currentAgent.exitCode === null || currentAgent.exitCode === 0 ? "completed" : "failed";
+};
+/**
+ * A git remote URL reduced to `host/owner/name` so https, ssh, scp-style, and
+ * `.git` spellings of the same repository compare equal. Null for anything
+ * that is not a URL-ish remote (a local path stays a path).
+ */
+export const normalizeRemoteUrl = (raw) => {
+    if (raw === null)
+        return null;
+    const trimmed = raw.trim();
+    if (trimmed === "")
+        return null;
+    const scp = /^(?:[^@\s/]+@)?([^:/\s]+):(?!\/)(.+)$/.exec(trimmed);
+    const url = /^[a-z][a-z0-9+.-]*:\/\/(?:[^@/]+@)?([^/\s:]+)(?::\d+)?\/(.+)$/i.exec(trimmed);
+    const parts = url ?? scp;
+    if (parts === null)
+        return null;
+    const [, host, rest] = parts;
+    if (host === undefined || rest === undefined)
+        return null;
+    const repoPath = rest.replace(/\/+$/, "").replace(/\.git$/i, "");
+    return `${host.toLowerCase()}/${repoPath.toLowerCase()}`;
+};
+/**
+ * The cwd's adopted project, in order: a project adopted from this very
+ * path; a project whose origin is the same remote as the cwd repo's origin
+ * (normalized, so a GitHub-adopted project matches a clone of it anywhere);
+ * a project named like the repository root (through the same normalization
+ * adopt uses, so a checkout called "Mend" matches the project "mend").
+ */
+export const matchProjectByCwd = (projects, facts) => {
+    const root = facts.repoRoot ?? facts.cwd;
+    const byPath = projects.find((p) => p.originUrl !== null &&
+        !p.originUrl.includes("://") &&
+        (root === p.originUrl ||
+            facts.cwd === p.originUrl ||
+            facts.cwd.startsWith(`${p.originUrl}/`)));
+    if (byPath !== undefined)
+        return byPath;
+    const remote = normalizeRemoteUrl(facts.originUrl);
+    const byRemote = remote === null ? undefined : projects.find((p) => normalizeRemoteUrl(p.originUrl) === remote);
+    if (byRemote !== undefined)
+        return byRemote;
+    const name = normalizeProjectName(path.basename(root));
+    return projects.find((p) => p.name === name);
+};
+/** Read the cwd's facts from git once; callers pass them to the matcher. */
+export const cwdFacts = (cwd) => ({
+    cwd,
+    repoRoot: gitTopLevel(cwd),
+    originUrl: gitOriginUrl(cwd),
+});
+/** The cwd repo's origin remote, or null when there is no repo or no origin. */
+export const gitOriginUrl = (cwd) => {
+    const result = spawnSync("git", ["remote", "get-url", "origin"], { cwd, encoding: "utf8" });
+    const out = result.status === 0 ? result.stdout.trim() : "";
+    return out === "" ? null : out;
 };
 /** The repository root of `cwd`, or null when it is not inside a git repo. */
 export const gitTopLevel = (cwd) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sealant/mend",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "The mend CLI: adopt a repository into Mend's store, launch your coding agent in a recorded session worktree, detach and reattach from any terminal",
   "keywords": [
     "claude-code",
@@ -32,11 +32,13 @@
     "@opentui/core": "^0.5.1",
     "@opentui/react": "^0.5.1",
     "@tanstack/react-query": "^5.101.4",
+    "qrcode": "^1.5.4",
     "react": "19.2.3"
   },
   "devDependencies": {
     "@effect/vitest": "4.0.0-beta.98",
     "@types/node": "^22.10.2",
+    "@types/qrcode": "^1.5.5",
     "@types/react": "^19.2.0",
     "typescript": "^5.7.2",
     "vitest": "^3.0.5",