mergestorm 0.3.13 → 0.3.15

package/dist/commands/browse.js

@@ -0,0 +1,259 @@
+import { getMe, getReview, getSettings, listJobs, patchSettings, SETTINGS_WRITABLE_KEYS, } from "../api.js";
+import { apiBase, keyDisplay, loadConfig, resolveApiKey } from "../config.js";
+import { CommandError } from "../errors.js";
+import { ansi } from "../ui/ansi.js";
+import { toReviewJobEnvelope, } from "../ui/job-envelope.js";
+import { runTabsBrowser, } from "../ui/tabs.js";
+import { formatDaysLeft, formatResetLabel } from "../ui/usage.js";
+import { relativeWhen } from "./jobs.js";
+/** The tabbed browser needs a real terminal on both ends. */
+export function canBrowse() {
+    return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+/** Shared job row mapper for the Usage tab and the static `credits` panel. */
+export function toPanelJob(job) {
+    return {
+        job: job.job_id.slice(0, 8),
+        verdict: job.verdict ?? job.status ?? "-",
+        thread: job.thread_slug ?? "-",
+        credits: job.credits ? String(job.credits.standard) : "-",
+        when: relativeWhen(job.created_at),
+    };
+}
+/** Short chrome note — lives on the hint row, not in the Status body. */
+export function statusReachabilityNote(input) {
+    if (input.keyInvalid)
+        return "key revoked";
+    if (!input.reachable)
+        return "API offline";
+    return "API reachable";
+}
+function field(label, value) {
+    return `  ${label.padEnd(8)}${value}`;
+}
+function creditsValue(input) {
+    if (input.keyInvalid)
+        return "unavailable (invalid or revoked key)";
+    if (!input.reachable)
+        return "unavailable";
+    if (input.limit == null && input.used == null)
+        return "unavailable";
+    if (input.limit == null)
+        return "unlimited";
+    if (input.limit === 0)
+        return "not included";
+    const used = input.used ?? 0;
+    const left = input.remaining != null ? input.remaining : Math.max(0, input.limit - used);
+    return `${used} / ${input.limit} used · ${left} left`;
+}
+/** Status tab body: whoami + credits from `/me`. Reachability is the footer. */
+export function buildStatusTabLines(input) {
+    const lines = [
+        field("Key", `${ansi.bold(input.keyPrefix)}${input.keyName ? ` (${input.keyName})` : ""}`),
+    ];
+    if (input.plan)
+        lines.push(field("Plan", input.plan));
+    lines.push(field("API", input.apiBase));
+    lines.push(field("Credits", creditsValue(input)));
+    if (input.reachable && !input.keyInvalid && (input.resetsAt || input.limit != null)) {
+        const when = formatResetLabel(input.resetsAt, input.now);
+        const left = formatDaysLeft(input.resetsAt, input.now);
+        lines.push(field("Resets", left ? `${when} · ${left}` : when));
+    }
+    if (input.keyInvalid) {
+        lines.push(`  ${ansi.dim("run")} ${ansi.brightGreen("login")} ${ansi.dim("to sign in again")}`);
+    }
+    return lines;
+}
+/** In-place job detail for the Jobs tab (same envelope as `status <id>`). */
+export function formatJobDetailLines(row) {
+    const e = toReviewJobEnvelope(row);
+    const lines = [];
+    lines.push(`  Job      ${e.job_id ?? "?"}`);
+    lines.push(`  Status   ${e.status}`);
+    if (e.verdict)
+        lines.push(`  Verdict  ${ansi.bold(e.verdict)}`);
+    if (e.thread) {
+        const n = e.thread.job_number != null ? ` · #${e.thread.job_number}` : "";
+        lines.push(`  Thread   ${e.thread.slug}${n}`);
+    }
+    if (e.router_mode)
+        lines.push(`  Router   ${e.router_mode}`);
+    if (e.specialists_requested.length > 0) {
+        lines.push(`  Asked    ${e.specialists_requested.join(", ")}`);
+    }
+    if (e.specialists_run.length > 0) {
+        lines.push(`  Run      ${e.specialists_run.join(", ")}`);
+    }
+    if (e.credits)
+        lines.push(`  Credits  ${e.credits.standard} standard`);
+    if (e.error)
+        lines.push(ansi.red(`  Error    ${e.error}`));
+    if (e.summary) {
+        lines.push("");
+        for (const l of e.summary.split("\n"))
+            lines.push(`  ${l}`);
+    }
+    const inline = e.findings?.inline ?? [];
+    const off = e.findings?.off_diff ?? e.findings?.offDiff ?? [];
+    for (const c of inline) {
+        lines.push("");
+        const lane = c.specialist ? `[${c.specialist}]` : "";
+        const title = c.title ? ` · ${c.title}` : "";
+        lines.push(`  [${c.severity}]${lane} ${c.path}:${c.line}${title}`);
+        for (const l of c.body.split("\n"))
+            lines.push(`  ${l}`);
+    }
+    for (const c of off) {
+        lines.push("");
+        lines.push(`  [${c.severity}] off-diff ${c.path ?? ""}`);
+        for (const l of c.body.split("\n"))
+            lines.push(`  ${l}`);
+    }
+    if (inline.length === 0 && off.length === 0 && e.status === "completed") {
+        lines.push("");
+        lines.push("  No findings.");
+    }
+    return lines;
+}
+/** Human labels for the Config tab and the static `settings` printout. */
+export const SETTINGS_LABELS = {
+    auto_review_enabled: "Auto review",
+    auto_patch_enabled: "Auto patch",
+    vortex_show_thinking_traces: "Vortex thinking traces",
+    repo_overview_enabled: "Repo overview",
+    review_unit_land_prs_enabled: "Review Unit land PRs",
+    cyclone_review_unit_land_prs_enabled: "Cyclone Review Unit land PRs",
+    vortex_seam_specialist_enabled: "Vortex seam specialist",
+};
+/** Config rows in a stable order: writable toggles, then connected flags. */
+export function buildConfigRows(settings) {
+    return [
+        ...SETTINGS_WRITABLE_KEYS.map((key) => ({
+            key,
+            label: SETTINGS_LABELS[key],
+            value: settings[key] === true,
+            writable: true,
+        })),
+        {
+            key: "cyclone_connected",
+            label: "Cyclone",
+            value: settings.cyclone_connected === true,
+            writable: false,
+        },
+        {
+            key: "github_connected",
+            label: "GitHub",
+            value: settings.github_connected === true,
+            writable: false,
+        },
+    ];
+}
+function toTabsJob(job) {
+    return {
+        id: job.job_id,
+        cells: {
+            job: job.job_id.slice(0, 8),
+            status: job.status,
+            verdict: job.verdict ?? "-",
+            thread: (job.thread_slug ?? "-").slice(0, 24),
+            when: relativeWhen(job.created_at),
+        },
+    };
+}
+/**
+ * Data + entry for the tabbed Status / Usage / Jobs / Config browser (F-9).
+ * Degrades honestly: a null `/me` marks the API unreachable and the Usage
+ * tab says so, and a failed settings GET leaves the Config tab reporting
+ * itself unavailable instead of drawing toggles we do not have.
+ */
+export async function openTabsBrowser(initial) {
+    const cfg = await loadConfig();
+    const key = resolveApiKey(cfg);
+    if (!key) {
+        throw new CommandError("Not logged in. Run `mergestorm login`.");
+    }
+    let me = null;
+    let keyInvalid = false;
+    try {
+        me = await getMe(cfg, { timeoutMs: 8_000 });
+    }
+    catch (err) {
+        if (err instanceof CommandError) {
+            keyInvalid = true;
+        }
+        else {
+            throw err;
+        }
+    }
+    let jobs = [];
+    let jobsError = null;
+    try {
+        jobs = await listJobs(10, cfg, { timeoutMs: 8_000 });
+    }
+    catch (err) {
+        jobsError = err instanceof Error ? err.message : String(err);
+    }
+    // Bearer /api/v1/settings for the Config tab. A revoked key already threw
+    // above; anything else degrades to an honest "unavailable" body.
+    let settings = null;
+    if (!keyInvalid) {
+        try {
+            settings = await getSettings(cfg, { timeoutMs: 8_000 });
+        }
+        catch {
+            settings = null;
+        }
+    }
+    const data = {
+        statusLines: buildStatusTabLines({
+            keyPrefix: me?.key.prefix ?? keyDisplay(key) ?? "msk_live_…",
+            keyName: me?.key.name ?? null,
+            plan: me ? (me.plan_label_key ?? me.plan_key) : null,
+            apiBase: apiBase(cfg),
+            reachable: me !== null,
+            keyInvalid,
+            used: me?.usage.standard.used,
+            limit: me?.usage.standard.limit,
+            remaining: me?.usage.standard.remaining,
+            resetsAt: me?.resets_at,
+        }),
+        footerNote: statusReachabilityNote({ reachable: me !== null, keyInvalid }),
+        usage: me
+            ? {
+                keyPrefix: me.key.prefix,
+                plan: me.plan_label_key ?? me.plan_key,
+                used: me.usage.standard.used,
+                limit: me.usage.standard.limit,
+                resetsAt: me.resets_at,
+                jobs: jobs.slice(0, 5).map(toPanelJob),
+                jobsError: jobsError ?? undefined,
+            }
+            : null,
+        ...(keyInvalid
+            ? { usageEmptyText: "Usage unavailable (invalid or revoked key)." }
+            : {}),
+        jobs: jobs.map(toTabsJob),
+        ...(jobsError ? { jobsEmptyText: `Jobs unavailable: ${jobsError}` } : {}),
+        config: settings ? buildConfigRows(settings) : null,
+        ...(keyInvalid
+            ? { configEmptyText: "Settings unavailable (invalid or revoked key)." }
+            : {}),
+        color: ansi.enabled,
+    };
+    await runTabsBrowser({
+        initial,
+        data,
+        toggleSetting: async (key, value) => {
+            const next = await patchSettings({ [key]: value }, cfg, { timeoutMs: 8_000 });
+            return buildConfigRows(next);
+        },
+        loadJobDetail: async (jobId) => {
+            const body = await getReview(jobId, cfg, { timeoutMs: 8_000 });
+            const row = body && typeof body === "object"
+                ? { ...body, job_id: body.job_id ?? jobId }
+                : { job_id: jobId, status: "failed", error: "Invalid review response" };
+            return formatJobDetailLines(row);
+        },
+    });
+}

package/dist/commands/credits.js

@@ -3,18 +3,15 @@ import { loadConfig } from "../config.js";
 import { CommandError } from "../errors.js";
 import { ansi } from "../ui/ansi.js";
 import { formatUsagePanel } from "../ui/usage.js";
-import { relativeWhen } from "./jobs.js";
-function toPanelJob(job) {
-    return {
-        job: job.job_id.slice(0, 8),
-        verdict: job.verdict ?? job.status ?? "-",
-        thread: job.thread_slug ?? "-",
-        credits: job.credits ? String(job.credits.standard) : "-",
-        when: relativeWhen(job.created_at),
-    };
-}
+import { canBrowse, openTabsBrowser, toPanelJob } from "./browse.js";
 export async function cmdCredits(args) {
     const asJson = args.includes("--json");
+    // TTY: the tabbed Status / Usage / Jobs browser, opened on Usage.
+    // `--json` and pipes keep the machine/static output exactly as before.
+    if (!asJson && canBrowse()) {
+        await openTabsBrowser("usage");
+        return;
+    }
     const cfg = await loadConfig();
     const me = await getMe(cfg);
     if (!me) {

package/dist/commands/help.d.ts

@@ -0,0 +1,5 @@
+import { type LineTab } from "../ui/line-tabs.js";
+/** Tabbed `/help` pages. Short rows only — no paragraphs. */
+export declare function buildHelpTabs(): LineTab[];
+export declare function helpTabIndex(id: string): number;
+export declare function openHelpBrowser(initial?: string): Promise<void>;

package/dist/commands/help.js

@@ -0,0 +1,93 @@
+import { ansi } from "../ui/ansi.js";
+import { runLineTabsBrowser } from "../ui/line-tabs.js";
+import { canBrowse } from "./browse.js";
+const cmd = (name, blurb) => `  ${ansi.brightGreen(name.padEnd(26))}${blurb}`;
+const rule = (label) => `  ${ansi.bold(label)}`;
+/** Tabbed `/help` pages. Short rows only — no paragraphs. */
+export function buildHelpTabs() {
+    return [
+        {
+            id: "start",
+            label: "Start",
+            lines: [
+                rule("What this is"),
+                "  mg is the Mergestorm terminal — local reviews + stacked PRs.",
+                "  Same account as mergestorm.ai. The dashboard is the other half.",
+                "",
+                rule("The loop"),
+                cmd("review", "send a diff → job on the API"),
+                cmd("usage", "credits, jobs, who you are"),
+                cmd("stack create → submit", "author a stack, then open PRs"),
+                "",
+                rule("Now"),
+                cmd("/", "slash menu at the prompt"),
+                cmd("login", "if the header says not logged in"),
+            ],
+        },
+        {
+            id: "commands",
+            label: "Commands",
+            lines: [
+                rule("Every day"),
+                cmd("review [base] [head]", "diff vs origin/HEAD, main, or master"),
+                cmd("usage", "Status / Usage / Jobs tabs"),
+                cmd("status <job>", "one job, same as the Jobs tab"),
+                cmd("jobs", "recent reviews"),
+                "",
+                rule("Around a branch"),
+                cmd("branches", "pick a recently reviewed branch"),
+                cmd("chain [slug]", "timeline for that branch"),
+                cmd("thread <slug>", "jobs in a review thread"),
+                "",
+                rule("Account"),
+                cmd("login", "browser sign-in (or login --key)"),
+                cmd("whoami", "key · plan · API"),
+                cmd("settings", "automation toggles · Config tab"),
+                cmd("logout", "forget the stored key"),
+                cmd("clear / exit", "reprint home · leave the shell"),
+            ],
+        },
+        {
+            id: "stacks",
+            label: "Stacks",
+            lines: [
+                rule("New mg stack"),
+                cmd("stack create", "new layer on this branch"),
+                "  commit your work",
+                cmd("stack submit", "push + open PRs from tip commits"),
+                "",
+                rule("Single stack (from trunk)"),
+                cmd("stack create --onto main", "fresh stack, not on an existing one"),
+                cmd("stack list", "what's registered for this repo"),
+                cmd("queue [add <stack-id>]", "list entries · queue verified landing"),
+                cmd("stack land <id>", "land now · skips queue verification"),
+                "",
+                rule("Existing PR stack"),
+                cmd("stack adopt org/repo#12", "import an open GitHub chain"),
+                cmd("stack restack <id>", "rewrite descendants after a change"),
+                "",
+                rule("Notes"),
+                "  Happy path: create → submit → restack → land.",
+                "  Adopt is import-only. Growing a submitted stack needs --extend.",
+            ],
+        },
+    ];
+}
+export function helpTabIndex(id) {
+    const tabs = buildHelpTabs();
+    const i = tabs.findIndex((t) => t.id === id);
+    return i >= 0 ? i : 0;
+}
+export async function openHelpBrowser(initial) {
+    const tabs = buildHelpTabs();
+    if (!canBrowse()) {
+        for (const tab of tabs) {
+            console.log(`  ${tab.label}`);
+            for (const line of tab.lines)
+                console.log(line);
+            console.log("");
+        }
+        return;
+    }
+    await runLineTabsBrowser({ tabs, initial: initial ? helpTabIndex(initial) : 0 });
+}

package/dist/commands/jobs.d.ts

@@ -1,6 +1,15 @@
 import { type ThreadDetail } from "../api.js";
 export declare function relativeWhen(iso: string): string;
-export declare function cmdJobs(args: string[]): Promise<void>;
+export declare function cmdJobs(args: string[], opts?: {
+    mode?: "oneshot" | "shell";
+}): Promise<void>;
 /** Numbered chain timeline for a thread (branch/PR meta when present). */
 export declare function formatThreadTimeline(data: ThreadDetail): string[];
-export declare function cmdThread(slug: string, args?: string[]): Promise<void>;
+/** Empty / missing chain — shown in the TTY panel instead of a wiped error. */
+export declare function buildChainHelpLines(opts: {
+    slug?: string;
+    reason: "missing" | "empty" | "no-repo";
+}): string[];
+export declare function cmdThread(slug: string, args?: string[], opts?: {
+    mode?: "oneshot" | "shell";
+}): Promise<void>;

package/dist/commands/jobs.js

@@ -2,6 +2,8 @@ import { apiFetch, listJobs } from "../api.js";
 import { loadConfig } from "../config.js";
 import { CommandError } from "../errors.js";
 import { ansi } from "../ui/ansi.js";
+import { present } from "../ui/present.js";
+import { showLinePanel } from "../ui/line-tabs.js";
 export function relativeWhen(iso) {
     const t = new Date(iso).getTime();
     if (Number.isNaN(t))
@@ -18,18 +20,28 @@ export function relativeWhen(iso) {
     const days = Math.floor(hr / 24);
     return `${days}d ago`;
 }
-export async function cmdJobs(args) {
+export async function cmdJobs(args, opts = {}) {
     const asJson = args.includes("--json");
     const nArg = args.find((a) => /^\d+$/.test(a));
     const limit = nArg ? Number.parseInt(nArg, 10) : 10;
     const cfg = await loadConfig();
     const items = await listJobs(limit, cfg);
     if (asJson) {
-        console.log(JSON.stringify({ items }, null, 2));
+        const text = JSON.stringify({ items }, null, 2);
+        if (opts.mode === "shell") {
+            await present("Jobs", text.split("\n"));
+            return;
+        }
+        console.log(text);
         return;
     }
     if (items.length === 0) {
-        console.log(ansi.dim("  No review jobs yet. Run `review` to submit one."));
+        await present("Jobs", [
+            `  ${ansi.bold("No review jobs yet")}`,
+            "",
+            `  ${ansi.brightGreen("review")}  submit a diff`,
+            `  ${ansi.brightGreen("usage")}   Status / Usage / Jobs tabs`,
+        ]);
         return;
     }
     const header = ["JOB", "STATUS", "VERDICT", "THREAD", "WHEN"];
@@ -42,10 +54,11 @@ export async function cmdJobs(args) {
     ]);
     const widths = header.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i]?.length ?? 0)));
     const fmt = (cols) => "  " + cols.map((c, i) => c.padEnd(widths[i])).join("  ");
-    console.log(ansi.dim(fmt(header)));
-    for (const r of rows)
-        console.log(fmt(r));
-    console.log(ansi.dim("  branches: `branches` · full history: https://mergestorm.ai/settings#api"));
+    await present("Jobs", [
+        ansi.dim(fmt(header)),
+        ...rows.map((r) => fmt(r)),
+        ansi.dim("  branches: `branches` · full history: https://mergestorm.ai/settings#api"),
+    ]);
 }
 /** Numbered chain timeline for a thread (branch/PR meta when present). */
 export function formatThreadTimeline(data) {
@@ -68,7 +81,8 @@ export function formatThreadTimeline(data) {
         return new Date(a.created_at).getTime() - new Date(b.created_at).getTime();
     });
     if (jobs.length === 0) {
-        lines.push(ansi.dim("  (no jobs in this chain yet)"));
+        lines.push("");
+        lines.push(...buildChainHelpLines({ slug: data.slug, reason: "empty" }));
         return lines;
     }
     for (const j of jobs) {
@@ -77,22 +91,58 @@ export function formatThreadTimeline(data) {
     }
     return lines;
 }
-export async function cmdThread(slug, args = []) {
+const chainCmd = (name, blurb) => `  ${ansi.brightGreen(name.padEnd(22))}${blurb}`;
+/** Empty / missing chain — shown in the TTY panel instead of a wiped error. */
+export function buildChainHelpLines(opts) {
+    const title = opts.reason === "empty"
+        ? "No reviews on this chain yet"
+        : opts.reason === "no-repo"
+            ? "No git repo here"
+            : "No chain for this branch";
+    const lines = [`  ${ansi.bold(title)}`];
+    if (opts.slug)
+        lines.push(ansi.dim(`  Looked for  ${opts.slug}`));
+    lines.push("");
+    lines.push(`  ${ansi.bold("What this is")}`);
+    lines.push("  A chain is the review timeline for one branch.");
+    lines.push("");
+    lines.push(`  ${ansi.bold("Do this")}`);
+    if (opts.reason === "no-repo") {
+        lines.push(chainCmd("cd <repo>", "then run chain again"));
+        lines.push(chainCmd("chain <slug>", "open a known thread"));
+    }
+    else {
+        lines.push(chainCmd("review", "submit a diff on this branch"));
+        lines.push(chainCmd("branches", "pick a branch that already has reviews"));
+        lines.push(chainCmd("chain <slug>", "open a known thread slug"));
+    }
+    return lines;
+}
+export async function cmdThread(slug, args = [], opts = {}) {
     const asJson = args.includes("--json");
     const cfg = await loadConfig();
     const { status, body } = await apiFetch(cfg, `/api/v1/threads/${encodeURIComponent(slug)}`);
     if (status === 404) {
-        throw new CommandError(`Thread not found: ${slug}`);
+        if (asJson || !process.stdin.isTTY || !process.stdout.isTTY) {
+            throw new CommandError(`Thread not found: ${slug}`);
+        }
+        await showLinePanel("Chain", buildChainHelpLines({ slug, reason: "missing" }));
+        return;
     }
     if (status !== 200) {
         throw new CommandError(`Failed to load thread (HTTP ${status}): ${JSON.stringify(body)}`);
     }
     if (asJson) {
-        console.log(JSON.stringify(body, null, 2));
+        const text = JSON.stringify(body, null, 2);
+        if (opts.mode === "shell") {
+            await present("Thread", text.split("\n"));
+            return;
+        }
+        console.log(text);
         return;
     }
     const data = body;
-    for (const line of formatThreadTimeline({
+    const lines = formatThreadTimeline({
         ...data,
         branch: data.branch ?? null,
         owner: data.owner ?? null,
@@ -101,7 +151,6 @@ export async function cmdThread(slug, args = []) {
         status: data.status ?? "active",
         pr_linked_at: data.pr_linked_at ?? null,
         jobs: data.jobs ?? [],
-    })) {
-        console.log(line);
-    }
+    });
+    await showLinePanel("Chain", lines);
 }

package/dist/commands/login.js

@@ -4,6 +4,7 @@ import { apiBase, configPath, loadConfig, saveConfig } from "../config.js";
 import { devicePost, getMe } from "../api.js";
 import { CommandError } from "../errors.js";
 import { ansi } from "../ui/ansi.js";
+import { present } from "../ui/present.js";
 import { readSecretLine } from "../ui/secret-input.js";
 function openBrowser(url) {
     const os = platform();
@@ -49,7 +50,7 @@ async function loginWithKey() {
     const me = await validateApiKey(cfg);
     await saveConfig(cfg);
     const prefix = me.key?.prefix?.trim() || "msk_live_…";
-    console.log(`Verified ${prefix}… · saved to ${configPath()}`);
+    await present("Login", [`  Verified ${prefix}… · saved to ${configPath()}`]);
 }
 export async function cmdLogin(args) {
     if (args.includes("--key")) {
@@ -89,7 +90,7 @@ export async function cmdLogin(args) {
     const { device_code, user_code, verification_uri, verification_uri_complete, interval, expires_in, } = start.body;
     const openUrl = verification_uri_complete || verification_uri;
     console.log("To sign in, open this URL and confirm the code:\n");
-    console.log(`  ${ansi.green(openUrl)}`);
+    console.log(`  ${ansi.brightGreen(openUrl)}`);
     console.log(`\n  Code: ${ansi.bold(user_code)}\n`);
     openBrowser(openUrl);
     console.log("Waiting for approval…");
@@ -108,7 +109,7 @@ export async function cmdLogin(args) {
             const next = await loadConfig();
             next.apiKey = poll.body.api_key;
             await saveConfig(next);
-            console.log(`\nLogged in. Key saved to ${configPath()}`);
+            await present("Login", [`  Logged in. Key saved to ${configPath()}`]);
             return;
         }
         const err = poll.body?.error;

package/dist/commands/logout.js

@@ -1,9 +1,10 @@
 import { clearConfig } from "../config.js";
 import { CommandError } from "../errors.js";
+import { present } from "../ui/present.js";
 export async function cmdLogout() {
     try {
         await clearConfig();
-        console.log("Logged out. Removed stored API key.");
+        await present("Logout", ["  Logged out. Removed stored API key."]);
     }
     catch (err) {
         throw new CommandError(`Could not remove config: ${err instanceof Error ? err.message : String(err)}`);

package/dist/commands/pr.d.ts

@@ -0,0 +1,22 @@
+import { type PollPrVortexReviewOptions } from "./review-client.js";
+export type ParsedPrArgs = {
+    owner: string;
+    repo: string;
+    prNumber: number;
+    format: "json" | "pretty";
+    wait: boolean;
+    afterSha?: string;
+    timeoutMs: number;
+};
+export type PrOptions = {
+    defaultFormat?: "json" | "pretty";
+    signal?: AbortSignal;
+    pollIntervalMs?: number;
+    /** Test seams for deterministic polling. */
+    poll?: Pick<PollPrVortexReviewOptions, "sleep" | "now" | "random">;
+    mode?: "oneshot" | "shell";
+};
+export declare function parsePrArgs(args: string[], defaults?: {
+    format: "json" | "pretty";
+}): ParsedPrArgs;
+export declare function cmdPr(args: string[], opts?: PrOptions): Promise<void>;