mergestorm 0.3.13 → 0.3.15

package/README.md

@@ -41,18 +41,16 @@ node dist/cli.js --help
 
 ## Interactive shell
 
-On a TTY, bare `mergestorm` (or `mergestorm shell`) opens a branded REPL: a **full-width** welcome panel (logo + status on the left, tips / what's new on the right) and a **full-width** bordered input box with a live `/` slash-command dropdown. Non-TTY (CI/pipes) prints usage instead — no hanging prompt.
+On a TTY, bare `mergestorm` (or `mergestorm shell`) opens a branded REPL: a compact **full-width** welcome panel (mark, version, status, usage bar) and a **full-width** bordered input box with a live `/` slash-command dropdown. The welcome panel reflows on terminal resize instead of wrapping or smearing. Non-TTY (CI/pipes) prints usage instead — no hanging prompt.
 
 ```
-╭─ mergestorm v0.3.13 ─────────────────────────────────────────────────────────╮
-│      ▟██████████▛       Tips for getting started                             │
-│       ▜████████▛          review      review origin/HEAD or main             │
-│        ▝▜████▛▘           stack       create → submit → restack → land       │
-│          ▜██▛             /help       list all commands                      │
-│           ██                                                                 │
-│           ▝▘            What's new in v0.3.13                                │
-│  ● msk…  ·  maelstrom     • MIT license + public source (mergestorm-cli)       │
-│  [████░░░░░░░░░░] 12% used                                                   │
+╭──────────────────────────────────────────────────────────────────────────────╮
+│ ▟██▛  mergestorm v0.3.15                                                     │
+│  ▜▙   ● msk_live_…  · maelstrom                                              │
+│       [████████░░░░░░░░░░░░░░░░░░░░░░] 25% used · Resets Sep 5, 10:53am (UTC)│
+│                                                                              │
+│       review a diff · usage for tabs · /help for all commands                │
+│       New in v0.3.15: PR wait + settings + both skills in the npm tarball    │
 ╰──────────────────────────────────────────────────────────────────────────────╯
 mergestorm
 ╭──────────────────────────────────────────────────────────────────────────────╮
@@ -60,7 +58,7 @@ mergestorm
 ╰──────────────────────────────────────────────────────────────────────────────╯
   /review       Review git diff (default origin/HEAD or main or master)
 
-mergestorm> credits
+mergestorm> usage
 mergestorm> branches
 mergestorm> chain
 mergestorm> exit
@@ -68,7 +66,7 @@ mergestorm> exit
 
 Bare command names still work exactly as before (`review`, `help`, `exit`, …) — typing `/` at the start of a line opens a compact autocomplete overlay (aliases folded onto the primary name, Up/Down scroll a viewport, Esc dismisses, Tab completes, Enter accepts a prefix or submits an exact name as typed, Left/Right move the cursor). Arrow-key history, Ctrl+A/E, Ctrl+U/K work as in a regular shell. At the idle prompt, **Ctrl+C twice** (within ~1.5s) exits the shell; a single Ctrl+C clears the line and shows a confirm hint. While `review` / `status` is waiting, Ctrl+C detaches or aborts that wait (job may keep running) — it does not exit the shell. Ctrl+D on an empty line, or `exit` / `quit`, also leave the shell. On a dumb terminal, without color, or when piped, the box falls back to plain ASCII borders (or no shell at all for non-TTY input).
 
-`credits` / `usage` print one static panel: key · plan, a credit bar sized to the terminal, `Resets … (UTC)`, then the last five jobs. `--json` adds `recent_jobs`. `branches` (alias `chains`) lists recently reviewed branches; on a TTY you arrow-select one to open its review-chain timeline. `chain [slug]` shows that timeline directly (defaults to `local/<current-git-branch>`).
+`credits` / `usage` on a TTY open a tabbed **Status / Usage / Jobs** browser (Usage selected): Left/Right switch tabs, Up/Down scroll or select, Enter on a job opens its `status` detail in place, Esc backs out, `q` closes. `status` with no job id opens the same browser on the Status tab. Piped / non-TTY output keeps the static panel: key · plan, a credit bar sized to the terminal, `Resets … (UTC)`, then the last five jobs; `--json` adds `recent_jobs` and is unchanged. `branches` (alias `chains`) lists recently reviewed branches; on a TTY you arrow-select one to open its review-chain timeline. `chain [slug]` shows that timeline directly (defaults to `local/<current-git-branch>`).
 
 ## Commands
 
@@ -82,11 +80,13 @@ mergestorm login --key          Paste an existing API key instead (headless/CI)
 mergestorm logout               Remove the stored API key
 mergestorm review [base] [head] Review git diff base...head (default: origin/HEAD or main or master)
 mergestorm status <job_id>      Fetch a review job (envelope; --json --wait --timeout)
-mergestorm credits [--json]     Usage panel (bar + last 5 jobs)
+mergestorm status               Tabbed Status / Usage / Jobs browser (TTY)
+mergestorm credits [--json]     Usage panel (bar + last 5 jobs); tabbed browser on a TTY
 mergestorm jobs [n] [--json]    Recent review jobs (default 10, max 50)
 mergestorm branches [n]         Recently reviewed branches (arrow-pick on TTY)
 mergestorm chain [slug]         Branch review-chain timeline (default: current branch)
 mergestorm whoami [--json]      Key prefix, plan, API base, config path
+mergestorm skill install --claude|--cursor  Copy the mergestorm-review and mergestorm-pr-loop skills into this repo
 mergestorm thread <slug>        Jobs in a review thread
 mergestorm stack create [name]  New local stack layer (optional `--onto` / `--trunk` / `--extend`)
 mergestorm stack submit         Push layers, open PRs (`gh`), register via adopt (optional `--extend`)
@@ -94,11 +94,10 @@ mergestorm stack list [--json]  List registered stacks
 mergestorm stack adopt <owner/repo>#<pr>  Import an existing open PR chain
 mergestorm stack restack <stack-id>  Restack descendants
 mergestorm stack land <stack-id>     Land / promote (into review unit when present)
-mergestorm stack auto-promote on|off <stack-id>  Toggle auto-promote when green
 mergestorm stack reset --force  Clear local authoring state (not branches/PRs)
 ```
 
-`mg` is a short alias for `mergestorm` (same binary), e.g. `mg stack create`. Happy path: **create → commit → submit → restack → land**. On review-unit stacks, `stack land` **promotes** the tip into the unit (same gates as the dashboard); otherwise it lands the bottom open PR. `stack auto-promote` turns on land-when-green for a registered stack (`auto-land` remains a deprecated alias). `stack adopt` is for importing a chain that already exists on GitHub (legacy / Graphite). Restack/land use the same login key (`/api/v1/stacks`).
+`mg` is a short alias for `mergestorm` (same binary), e.g. `mg stack create`. Happy path: **create → commit → submit → restack → land**. On review-unit stacks, `stack land` **promotes** the tip into the unit (same gates as the dashboard); otherwise it lands the bottom open PR. `stack adopt` is for importing a chain that already exists on GitHub (legacy / Graphite). Restack/land use the same login key (`/api/v1/stacks`). Unattended landing is `mg queue add`.
 
 `stack create` checks out a new branch from the current tip (or `--onto <branch>`), discovers trunk (`main` / `master` / `origin/HEAD`, overridable with `--trunk`), and records `{ branch, parentBranch }` in CLI-managed state under **`~/.mergestorm/stacks/<repo-id>/stack.json`**. The CLI updates this automatically; never edit it. Linked worktrees share state, while independent clones remain isolated. Creating onto trunk with a non-empty active stack starts a new one. `--trunk` only sets trunk metadata — it does **not** change the parent; use `--onto main` (etc.) for a fresh stack from trunk.
 

package/dist/api.d.ts

@@ -1,6 +1,6 @@
 import { type Config } from "./config.js";
-import type { StackDto } from "./stack-dto.js";
-export type { StackBranchState, StackCiStatus, StackDto, StackLayerChecks, StackLayerDto, StackReviewStatus, StackTempestStatus, StackUnitDto, StackUnitMemberDto, } from "./stack-dto.js";
+import type { MergeQueueEntryDto, StackDto } from "./stack-dto.js";
+export type { MergeQueueBounceDetail, MergeQueueBounceKind, MergeQueueEnqueuedBy, MergeQueueEnqueuedVia, MergeQueueEntryDto, MergeQueueEntryState, StackBranchState, StackCiStatus, StackDto, StackLayerChecks, StackLayerDto, StackReviewStatus, StackTempestStatus, StackUnitDto, StackUnitMemberDto, } from "./stack-dto.js";
 /** Default per-request timeout so a hung API cannot stall the shell/CI forever. */
 export declare const DEFAULT_API_TIMEOUT_MS = 30000;
 /** Message prefix of the CommandError thrown when a request exceeds its timeout. */
@@ -94,19 +94,92 @@ export type ThreadDetail = {
         finished_at?: string | null;
     }[];
 };
+export type PrReviewFinding = {
+    path?: string;
+    line?: number;
+    severity: string;
+    body: string;
+    title?: string;
+    specialist?: string;
+};
+export type PrReviewFindings = {
+    specialists_run?: string[];
+    inline?: PrReviewFinding[];
+    off_diff?: PrReviewFinding[];
+    offDiff?: PrReviewFinding[];
+    patchPolicy?: unknown;
+};
+export type PrVortexReview = {
+    schema: "mergestorm.pr_review/v1";
+    id: string;
+    owner: string;
+    repo: string;
+    pr_number: number;
+    status: string;
+    raw_status?: string;
+    phase: string | null;
+    verdict: string | null;
+    summary?: string | null;
+    head_sha: string | null;
+    review_count: number;
+    skip_reason: string | null;
+    reviewed_at: string | null;
+    finding_count: number;
+    findings: PrReviewFindings | null;
+    patch_policy: unknown | null;
+};
+/**
+ * Bearer-writable settings keys, mirroring the `/api/v1/settings` allowlist.
+ * The connected flags are read-only there and deliberately absent here.
+ */
+export declare const SETTINGS_WRITABLE_KEYS: readonly ["auto_review_enabled", "auto_patch_enabled", "vortex_show_thinking_traces", "repo_overview_enabled", "review_unit_land_prs_enabled", "cyclone_review_unit_land_prs_enabled", "vortex_seam_specialist_enabled"];
+export type SettingsWritableKey = (typeof SETTINGS_WRITABLE_KEYS)[number];
+export type SettingsPatch = Partial<Record<SettingsWritableKey, boolean>>;
+/** GET and PATCH `/api/v1/settings` both answer with this shape. */
+export type SettingsResponse = Record<SettingsWritableKey, boolean> & {
+    cyclone_connected: boolean;
+    github_connected: boolean;
+};
+/**
+ * Fetch Bearer /api/v1/settings; null on 404/network/timeouts so panels can
+ * degrade (same contract as {@link getMe}), while 401 still surfaces.
+ */
+export declare function getSettings(cfg?: Config, opts?: {
+    timeoutMs?: number;
+}): Promise<SettingsResponse | null>;
+/**
+ * PATCH Bearer /api/v1/settings and return the stored result. Rejections
+ * (unknown key, cyclone_not_connected, …) surface the API's own `message`
+ * so the CLI never invents a reason.
+ */
+export declare function patchSettings(patch: SettingsPatch, cfg?: Config, opts?: {
+    timeoutMs?: number;
+}): Promise<SettingsResponse>;
 /** Fetch /api/v1/me; returns null on 404/network so callers can degrade. */
 export declare function getMe(cfg?: Config, opts?: {
     timeoutMs?: number;
 }): Promise<MeResponse | null>;
-export declare function listJobs(limit?: number, cfg?: Config): Promise<JobListItem[]>;
+export declare function listJobs(limit?: number, cfg?: Config, opts?: {
+    timeoutMs?: number;
+}): Promise<JobListItem[]>;
 /** Fetch one review job (Bearer GET /api/v1/reviews/:id). */
 export declare function getReview(jobId: string, cfg?: Config, opts?: {
     signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<unknown>;
+/** Fetch the latest Vortex pass for one GitHub PR. */
+export declare function getPrVortexReview(owner: string, repo: string, prNumber: number, cfg?: Config, opts?: {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): Promise<PrVortexReview>;
 /** List stacks (Bearer GET /api/v1/stacks). */
 export declare function listStacks(cfg?: Config, opts?: {
     timeoutMs?: number;
 }): Promise<StackDto[]>;
+/** Fetch one owned stack with enriched GitHub checks and agent state. */
+export declare function getEnrichedStack(stackId: string, cfg?: Config, opts?: {
+    timeoutMs?: number;
+}): Promise<StackDto | null>;
 /** Adopt an open PR chain (Bearer POST /api/v1/stacks/adopt). */
 export declare function adoptStack(owner: string, repo: string, prNumber: number, cfg?: Config): Promise<unknown>;
 /** Mint or reuse the PR3+ park freeze (Bearer POST /api/v1/stacks/:id/ensure-upper-park). */
@@ -120,7 +193,11 @@ export declare function restackStack(stackId: string, cfg?: Config): Promise<unk
 export declare function landNextStack(stackId: string, cfg?: Config, opts?: {
     prNumber?: number;
 }): Promise<unknown>;
-/** Toggle auto-promote when green (Bearer PATCH /api/v1/stacks/:id). */
-export declare function setStackAutoPromote(stackId: string, autoPromoteWhenGreen: boolean, cfg?: Config): Promise<unknown>;
+/** List the authenticated user's live merge-queue entries. */
+export declare function listMergeQueueEntries(cfg?: Config): Promise<MergeQueueEntryDto[]>;
+/** Enqueue a stack for verified landing. */
+export declare function enqueueStack(stackId: string, cfg?: Config): Promise<unknown>;
+/** Cancel a live merge-queue entry by entry id. */
+export declare function cancelMergeQueueEntry(entryId: string, cfg?: Config): Promise<unknown>;
 /** Recently reviewed branches/threads (Bearer GET /api/v1/threads). */
 export declare function listThreads(limit?: number, cfg?: Config): Promise<ThreadListItem[]>;

package/dist/api.js

@@ -154,6 +154,71 @@ export async function devicePost(base, route, json, opts = {}) {
     }
     return { status: res.status, body: parsed };
 }
+/**
+ * Bearer-writable settings keys, mirroring the `/api/v1/settings` allowlist.
+ * The connected flags are read-only there and deliberately absent here.
+ */
+export const SETTINGS_WRITABLE_KEYS = [
+    "auto_review_enabled",
+    "auto_patch_enabled",
+    "vortex_show_thinking_traces",
+    "repo_overview_enabled",
+    "review_unit_land_prs_enabled",
+    "cyclone_review_unit_land_prs_enabled",
+    "vortex_seam_specialist_enabled",
+];
+/**
+ * Fetch Bearer /api/v1/settings; null on 404/network/timeouts so panels can
+ * degrade (same contract as {@link getMe}), while 401 still surfaces.
+ */
+export async function getSettings(cfg, opts) {
+    const resolved = cfg ?? (await loadConfig());
+    try {
+        const { status, body } = await apiFetch(resolved, "/api/v1/settings", {
+            timeoutMs: opts?.timeoutMs,
+        });
+        if (status !== 200)
+            return null;
+        return body;
+    }
+    catch (err) {
+        if (err instanceof CommandError) {
+            if (err.code === "api_timeout")
+                return null;
+            throw err;
+        }
+        return null;
+    }
+}
+/**
+ * PATCH Bearer /api/v1/settings and return the stored result. Rejections
+ * (unknown key, cyclone_not_connected, …) surface the API's own `message`
+ * so the CLI never invents a reason.
+ */
+export async function patchSettings(patch, cfg, opts) {
+    const resolved = cfg ?? (await loadConfig());
+    if (Object.keys(patch).length === 0) {
+        throw new CommandError("No settings to update.", 2, "usage");
+    }
+    const { status, body, retryAfterSeconds } = await apiFetch(resolved, "/api/v1/settings", {
+        method: "PATCH",
+        json: patch,
+        timeoutMs: opts?.timeoutMs,
+    });
+    if (status === 404) {
+        throw new CommandError("Settings API is not available on this server yet. Deploy the API update or use the dashboard.");
+    }
+    if (status === 429) {
+        throw new CommandError(rateLimitedMessage(retryAfterSeconds), REVIEW_EXIT.rate_limited, "rate_limited", { retryAfterSeconds });
+    }
+    if (status !== 200) {
+        const message = body?.message;
+        throw new CommandError(typeof message === "string" && message.trim()
+            ? message
+            : `Failed to update settings (HTTP ${status}): ${JSON.stringify(body)}`);
+    }
+    return body;
+}
 /** Fetch /api/v1/me; returns null on 404/network so callers can degrade. */
 export async function getMe(cfg, opts) {
     const resolved = cfg ?? (await loadConfig());
@@ -178,10 +243,12 @@ export async function getMe(cfg, opts) {
         return null;
     }
 }
-export async function listJobs(limit = 10, cfg) {
+export async function listJobs(limit = 10, cfg, opts) {
     const resolved = cfg ?? (await loadConfig());
     const capped = Math.min(Math.max(limit, 1), 50);
-    const { status, body } = await apiFetch(resolved, `/api/v1/reviews?limit=${capped}`);
+    const { status, body } = await apiFetch(resolved, `/api/v1/reviews?limit=${capped}`, {
+        timeoutMs: opts?.timeoutMs,
+    });
     if (status === 404) {
         throw new CommandError("Job list is not available on this server yet. Update the API or use the dashboard.");
     }
@@ -198,7 +265,7 @@ export async function getReview(jobId, cfg, opts) {
     if (!id) {
         throw new CommandError("job_id is required", 2, "usage");
     }
-    const { status, body, retryAfterSeconds } = await apiFetch(resolved, `/api/v1/reviews/${encodeURIComponent(id)}`, { signal: opts?.signal });
+    const { status, body, retryAfterSeconds } = await apiFetch(resolved, `/api/v1/reviews/${encodeURIComponent(id)}`, { signal: opts?.signal, timeoutMs: opts?.timeoutMs });
     if (status === 404) {
         throw new CommandError(`Review not found: ${id}`);
     }
@@ -210,21 +277,72 @@ export async function getReview(jobId, cfg, opts) {
     }
     return body;
 }
+/** Fetch the latest Vortex pass for one GitHub PR. */
+export async function getPrVortexReview(owner, repo, prNumber, cfg, opts) {
+    const resolved = cfg ?? (await loadConfig());
+    const cleanOwner = owner.trim();
+    const cleanRepo = repo.trim();
+    if (!cleanOwner || !cleanRepo || !Number.isInteger(prNumber) || prNumber <= 0) {
+        throw new CommandError("owner, repo, and a positive pr_number are required", 2, "usage");
+    }
+    const query = new URLSearchParams({
+        owner: cleanOwner,
+        repo: cleanRepo,
+        pr_number: String(prNumber),
+    });
+    const { status, body, retryAfterSeconds } = await apiFetch(resolved, `/api/v1/stacks/pr-review?${query.toString()}`, { signal: opts?.signal, timeoutMs: opts?.timeoutMs });
+    if (status === 404) {
+        throw new CommandError(`Vortex review not found: ${cleanOwner}/${cleanRepo}#${prNumber}`, REVIEW_EXIT.failed, "not_found");
+    }
+    if (status === 429) {
+        throw new CommandError(rateLimitedMessage(retryAfterSeconds), REVIEW_EXIT.rate_limited, "rate_limited", { retryAfterSeconds });
+    }
+    if (status !== 200) {
+        throw new CommandError(`Failed to get PR review (HTTP ${status}): ${JSON.stringify(body)}`, REVIEW_EXIT.failed, "review_failed");
+    }
+    return body;
+}
 /** List stacks (Bearer GET /api/v1/stacks). */
 export async function listStacks(cfg, opts) {
     const resolved = cfg ?? (await loadConfig());
-    const { status, body } = await apiFetch(resolved, "/api/v1/stacks", {
+    const { status, body, retryAfterSeconds } = await apiFetch(resolved, "/api/v1/stacks", {
         timeoutMs: opts?.timeoutMs,
     });
     if (status === 404) {
         throw new CommandError("Stacks API is not available on this server yet. Deploy the API update or use the dashboard.");
     }
+    if (status === 429) {
+        throw new CommandError(rateLimitedMessage(retryAfterSeconds), REVIEW_EXIT.rate_limited, "rate_limited", { retryAfterSeconds });
+    }
     if (status !== 200) {
         throw new CommandError(`Failed to list stacks (HTTP ${status}): ${JSON.stringify(body)}`);
     }
     const stacks = body.stacks;
     return Array.isArray(stacks) ? stacks : [];
 }
+/** Fetch one owned stack with enriched GitHub checks and agent state. */
+export async function getEnrichedStack(stackId, cfg, opts) {
+    const resolved = cfg ?? (await loadConfig());
+    const id = stackId.trim();
+    if (!id) {
+        throw new CommandError("stack_id is required", 2, "usage");
+    }
+    const { status, body, retryAfterSeconds } = await apiFetch(resolved, `/api/v1/stacks/enrich?stackId=${encodeURIComponent(id)}`, { timeoutMs: opts?.timeoutMs });
+    if (status === 404) {
+        throw new CommandError("Stack enrichment is not available on this server yet. Deploy the API update or use the dashboard.");
+    }
+    if (status === 429) {
+        throw new CommandError(rateLimitedMessage(retryAfterSeconds), REVIEW_EXIT.rate_limited, "rate_limited", { retryAfterSeconds });
+    }
+    if (status !== 200) {
+        throw new CommandError(`Failed to get stack status (HTTP ${status}): ${JSON.stringify(body)}`);
+    }
+    const stacks = body.stacks;
+    if (!Array.isArray(stacks)) {
+        throw new CommandError(`Failed to get stack status (HTTP 200): ${JSON.stringify(body)}`);
+    }
+    return stacks.find((stack) => stack?.id === id) ?? null;
+}
 /** Adopt an open PR chain (Bearer POST /api/v1/stacks/adopt). */
 export async function adoptStack(owner, repo, prNumber, cfg) {
     const resolved = cfg ?? (await loadConfig());
@@ -283,9 +401,50 @@ export async function landNextStack(stackId, cfg, opts) {
         : {};
     return stackMutation(stackId, "/land-next", "POST", json, "Failed to land next", cfg);
 }
-/** Toggle auto-promote when green (Bearer PATCH /api/v1/stacks/:id). */
-export async function setStackAutoPromote(stackId, autoPromoteWhenGreen, cfg) {
-    return stackMutation(stackId, "", "PATCH", { autoPromoteWhenGreen }, "Failed to update auto-promote", cfg);
+/** List the authenticated user's live merge-queue entries. */
+export async function listMergeQueueEntries(cfg) {
+    const resolved = cfg ?? (await loadConfig());
+    const { status, body } = await apiFetch(resolved, "/api/v1/stacks/queue");
+    if (status === 404) {
+        throw new CommandError("Merge queue API is not available on this server yet. Deploy the API update or use the dashboard.");
+    }
+    if (status !== 200) {
+        throw new CommandError(`Failed to list merge queue (HTTP ${status}): ${JSON.stringify(body)}`);
+    }
+    const entries = body.entries;
+    if (!Array.isArray(entries)) {
+        throw new CommandError(`Failed to list merge queue (HTTP 200): ${JSON.stringify(body)}`);
+    }
+    return entries;
+}
+async function queueMutation(route, failLabel, cfg) {
+    const resolved = cfg ?? (await loadConfig());
+    const { status, body } = await apiFetch(resolved, route, {
+        method: "POST",
+        json: {},
+    });
+    if (status === 404) {
+        const error = body?.error;
+        if (error === "stack_not_found") {
+            throw new CommandError("Stack not found");
+        }
+        if (error === "entry_not_found") {
+            throw new CommandError("Merge queue entry not found");
+        }
+        throw new CommandError("Merge queue API is not available on this server yet. Deploy the API update or use the dashboard.");
+    }
+    if (status < 200 || status >= 300) {
+        throw new CommandError(`${failLabel} (HTTP ${status}): ${JSON.stringify(body)}`);
+    }
+    return body;
+}
+/** Enqueue a stack for verified landing. */
+export async function enqueueStack(stackId, cfg) {
+    return queueMutation(`/api/v1/stacks/${encodeURIComponent(stackId)}/enqueue`, "Failed to add stack to merge queue", cfg);
+}
+/** Cancel a live merge-queue entry by entry id. */
+export async function cancelMergeQueueEntry(entryId, cfg) {
+    return queueMutation(`/api/v1/stacks/queue/${encodeURIComponent(entryId)}/cancel`, "Failed to remove merge queue entry", cfg);
 }
 /** Recently reviewed branches/threads (Bearer GET /api/v1/threads). */
 export async function listThreads(limit = 20, cfg) {

package/dist/client/index.d.ts

@@ -1,5 +1,5 @@
 export { DEFAULT_API, apiBase, clearConfig, configPath, keyDisplay, loadConfig, mergestormHome, resolveApiKey, saveConfig, type Config, } from "../config.js";
-export { API_TIMEOUT_PREFIX, DEFAULT_API_TIMEOUT_MS, adoptStack, apiFetch, devicePost, ensureUpperPark, getMe, getReview, landNextStack, listJobs, listStacks, listThreads, parseRetryAfterSeconds, restackStack, setStackAutoPromote, type ApiFetchInit, type ApiFetchResult, type JobListItem, type MeResponse, type ThreadDetail, type ThreadListItem, } from "../api.js";
+export { API_TIMEOUT_PREFIX, DEFAULT_API_TIMEOUT_MS, SETTINGS_WRITABLE_KEYS, adoptStack, apiFetch, cancelMergeQueueEntry, devicePost, enqueueStack, ensureUpperPark, getEnrichedStack, getMe, getPrVortexReview, getReview, getSettings, landNextStack, listJobs, listMergeQueueEntries, listStacks, listThreads, parseRetryAfterSeconds, patchSettings, restackStack, type ApiFetchInit, type ApiFetchResult, type JobListItem, type MeResponse, type MergeQueueBounceDetail, type MergeQueueBounceKind, type MergeQueueEnqueuedBy, type MergeQueueEnqueuedVia, type MergeQueueEntryDto, type MergeQueueEntryState, type PrReviewFinding, type PrReviewFindings, type PrVortexReview, type SettingsPatch, type SettingsResponse, type SettingsWritableKey, type StackDto, type ThreadDetail, type ThreadListItem, } from "../api.js";
 export { CommandError, DetachedError, RATE_LIMITED_HINT, REVIEW_EXIT, isCommandErrorCode, rateLimitedMessage, type CommandErrorCode, type CommandErrorExtras, } from "../errors.js";
-export { REVIEW_POLL_BACKOFF_MS, REVIEW_POLL_DEFAULT_TIMEOUT_MS, REVIEW_POLL_INTERVAL_MS, REVIEW_POLL_MAX_INTERVAL_MS, REVIEW_POLL_MAX_TRANSIENT_RETRIES, REVIEW_POLL_STRETCH_AFTER_MS, REVIEW_POLL_STRETCH_SPAN_MS, REVIEW_THREAD_SLUG_RE, ReviewPollTimeoutError, collectReviewInput, isTransientReviewPollError, isTransientReviewPollStatus, loadReviewContext, pollReview, stretchedPollIntervalMs, submitReview, transientRetryWaitMs, type PollReviewOptions, type ReviewInput, type SubmitReviewOptions, } from "../commands/review-client.js";
+export { REVIEW_POLL_BACKOFF_MS, REVIEW_POLL_DEFAULT_TIMEOUT_MS, REVIEW_POLL_INTERVAL_MS, REVIEW_POLL_MAX_INTERVAL_MS, REVIEW_POLL_MAX_TRANSIENT_RETRIES, REVIEW_POLL_STRETCH_AFTER_MS, REVIEW_POLL_STRETCH_SPAN_MS, REVIEW_THREAD_SLUG_RE, PrReviewPollTimeoutError, ReviewPollTimeoutError, collectReviewInput, isTransientReviewPollError, isTransientReviewPollStatus, loadReviewContext, pollPrVortexReview, pollReview, stretchedPollIntervalMs, submitReview, transientRetryWaitMs, type PollReviewOptions, type PollPrVortexReviewOptions, type ReviewInput, type SubmitReviewOptions, } from "../commands/review-client.js";
 export { REVIEW_JOB_ENVELOPE_SCHEMA, toReviewJobEnvelope, type ReviewEnvelopeFallbacks, type ReviewJobEnvelope, type ReviewJobRow, } from "../ui/job-envelope.js";

package/dist/client/index.js

@@ -1,5 +1,5 @@
 export { DEFAULT_API, apiBase, clearConfig, configPath, keyDisplay, loadConfig, mergestormHome, resolveApiKey, saveConfig, } from "../config.js";
-export { API_TIMEOUT_PREFIX, DEFAULT_API_TIMEOUT_MS, adoptStack, apiFetch, devicePost, ensureUpperPark, getMe, getReview, landNextStack, listJobs, listStacks, listThreads, parseRetryAfterSeconds, restackStack, setStackAutoPromote, } from "../api.js";
+export { API_TIMEOUT_PREFIX, DEFAULT_API_TIMEOUT_MS, SETTINGS_WRITABLE_KEYS, adoptStack, apiFetch, cancelMergeQueueEntry, devicePost, enqueueStack, ensureUpperPark, getEnrichedStack, getMe, getPrVortexReview, getReview, getSettings, landNextStack, listJobs, listMergeQueueEntries, listStacks, listThreads, parseRetryAfterSeconds, patchSettings, restackStack, } from "../api.js";
 export { CommandError, DetachedError, RATE_LIMITED_HINT, REVIEW_EXIT, isCommandErrorCode, rateLimitedMessage, } from "../errors.js";
-export { REVIEW_POLL_BACKOFF_MS, REVIEW_POLL_DEFAULT_TIMEOUT_MS, REVIEW_POLL_INTERVAL_MS, REVIEW_POLL_MAX_INTERVAL_MS, REVIEW_POLL_MAX_TRANSIENT_RETRIES, REVIEW_POLL_STRETCH_AFTER_MS, REVIEW_POLL_STRETCH_SPAN_MS, REVIEW_THREAD_SLUG_RE, ReviewPollTimeoutError, collectReviewInput, isTransientReviewPollError, isTransientReviewPollStatus, loadReviewContext, pollReview, stretchedPollIntervalMs, submitReview, transientRetryWaitMs, } from "../commands/review-client.js";
+export { REVIEW_POLL_BACKOFF_MS, REVIEW_POLL_DEFAULT_TIMEOUT_MS, REVIEW_POLL_INTERVAL_MS, REVIEW_POLL_MAX_INTERVAL_MS, REVIEW_POLL_MAX_TRANSIENT_RETRIES, REVIEW_POLL_STRETCH_AFTER_MS, REVIEW_POLL_STRETCH_SPAN_MS, REVIEW_THREAD_SLUG_RE, PrReviewPollTimeoutError, ReviewPollTimeoutError, collectReviewInput, isTransientReviewPollError, isTransientReviewPollStatus, loadReviewContext, pollPrVortexReview, pollReview, stretchedPollIntervalMs, submitReview, transientRetryWaitMs, } from "../commands/review-client.js";
 export { REVIEW_JOB_ENVELOPE_SCHEMA, toReviewJobEnvelope, } from "../ui/job-envelope.js";

package/dist/commands/branches.d.ts

@@ -2,9 +2,13 @@ import { type ThreadListItem } from "../api.js";
 /** One-line label for a branch/thread row (also used by tests). */
 export declare function formatBranchRow(item: ThreadListItem): string;
 /** Interactive list of recently reviewed branches → open chain on select. */
-export declare function cmdBranches(args?: string[]): Promise<void>;
+export declare function cmdBranches(args?: string[], opts?: {
+    mode?: "oneshot" | "shell";
+}): Promise<void>;
 /**
  * Show the review-chain timeline for a branch/thread.
  * Defaults to `local/<current-git-branch>` when no slug is given.
  */
-export declare function cmdChain(args?: string[]): Promise<void>;
+export declare function cmdChain(args?: string[], opts?: {
+    mode?: "oneshot" | "shell";
+}): Promise<void>;

package/dist/commands/branches.js

@@ -4,8 +4,10 @@ import { loadConfig } from "../config.js";
 import { CommandError } from "../errors.js";
 import { git } from "../git.js";
 import { ansi } from "../ui/ansi.js";
+import { present } from "../ui/present.js";
 import { selectFromList } from "../ui/select.js";
-import { cmdThread, relativeWhen } from "./jobs.js";
+import { buildChainHelpLines, cmdThread, relativeWhen } from "./jobs.js";
+import { showLinePanel } from "../ui/line-tabs.js";
 /** One-line label for a branch/thread row (also used by tests). */
 export function formatBranchRow(item) {
     const name = (item.branch?.trim() || item.slug).slice(0, 36);
@@ -18,7 +20,7 @@ export function formatBranchRow(item) {
     const closed = item.status === "closed" ? "  closed" : "";
     return `${name.padEnd(36)}  ${jobs.padEnd(8)}  ${verdict.padEnd(12)}  ${when}${pr}${closed}`;
 }
-function printBranchTable(items) {
+function formatBranchTableLines(items) {
     const header = ["BRANCH / SLUG", "JOBS", "VERDICT", "WHEN", "PR"];
     const rows = items.map((t) => [
         (t.branch?.trim() || t.slug).slice(0, 36),
@@ -29,28 +31,38 @@ function printBranchTable(items) {
     ]);
     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("  open a chain:  chain <slug>   ·   or re-run on a TTY to pick"));
+    return [
+        ansi.dim(fmt(header)),
+        ...rows.map((r) => fmt(r)),
+        ansi.dim("  open a chain:  chain <slug>   ·   or re-run on a TTY to pick"),
+    ];
 }
 /** Interactive list of recently reviewed branches → open chain on select. */
-export async function cmdBranches(args = []) {
+export async function cmdBranches(args = [], opts = {}) {
     const asJson = args.includes("--json");
     const nArg = args.find((a) => /^\d+$/.test(a));
     const limit = nArg ? Number.parseInt(nArg, 10) : 20;
     const cfg = await loadConfig();
     const items = await listThreads(limit, cfg);
     if (asJson) {
-        console.log(JSON.stringify({ items }, null, 2));
+        const text = JSON.stringify({ items }, null, 2);
+        if (opts.mode === "shell") {
+            await present("Branches", text.split("\n"));
+            return;
+        }
+        console.log(text);
         return;
     }
     if (items.length === 0) {
-        console.log(ansi.dim("  No reviewed branches yet. Run `review` on a branch first."));
+        await present("Branches", [
+            `  ${ansi.bold("No reviewed branches yet")}`,
+            "",
+            `  ${ansi.brightGreen("review")}  submit a diff on this branch`,
+        ]);
         return;
     }
     if (!input.isTTY || !output.isTTY) {
-        printBranchTable(items);
+        await present("Branches", formatBranchTableLines(items));
         return;
     }
     const picked = await selectFromList({
@@ -59,7 +71,6 @@ export async function cmdBranches(args = []) {
         render: (item) => formatBranchRow(item),
     });
     if (!picked) {
-        console.log(ansi.dim("  cancelled"));
         return;
     }
     await cmdThread(picked.slug, []);
@@ -68,7 +79,7 @@ export async function cmdBranches(args = []) {
  * Show the review-chain timeline for a branch/thread.
  * Defaults to `local/<current-git-branch>` when no slug is given.
  */
-export async function cmdChain(args = []) {
+export async function cmdChain(args = [], opts = {}) {
     const asJson = args.includes("--json");
     const positional = args.filter((a) => a !== "--json");
     let slug = positional[0]?.trim() ?? "";
@@ -78,8 +89,12 @@ export async function cmdChain(args = []) {
             slug = `local/${branch}`.replace(/[^a-zA-Z0-9._/-]/g, "-").slice(0, 120);
         }
         catch {
-            throw new CommandError("usage: chain <slug>   (or run inside a git repo to use the current branch)");
+            if (asJson || !process.stdin.isTTY || !process.stdout.isTTY) {
+                throw new CommandError("usage: chain <slug>   (or run inside a git repo to use the current branch)");
+            }
+            await showLinePanel("Chain", buildChainHelpLines({ reason: "no-repo" }));
+            return;
         }
     }
-    await cmdThread(slug, asJson ? ["--json"] : []);
+    await cmdThread(slug, asJson ? ["--json"] : [], opts);
 }

package/dist/commands/browse.d.ts

@@ -0,0 +1,39 @@
+import { type JobListItem, type SettingsResponse, type SettingsWritableKey } from "../api.js";
+import { type ReviewJobRow } from "../ui/job-envelope.js";
+import { type TabId, type TabsConfigRow } from "../ui/tabs.js";
+import { type UsagePanelJob } from "../ui/usage.js";
+/** The tabbed browser needs a real terminal on both ends. */
+export declare function canBrowse(): boolean;
+/** Shared job row mapper for the Usage tab and the static `credits` panel. */
+export declare function toPanelJob(job: JobListItem): UsagePanelJob;
+export type StatusTabInput = {
+    keyPrefix: string;
+    keyName: string | null;
+    plan: string | null;
+    apiBase: string;
+    reachable: boolean;
+    /** getMe surfaced a 401: the key is invalid/revoked, not the API down. */
+    keyInvalid: boolean;
+    used?: number;
+    limit?: number | null;
+    remaining?: number | null;
+    resetsAt?: string | null;
+    now?: Date;
+};
+/** Short chrome note — lives on the hint row, not in the Status body. */
+export declare function statusReachabilityNote(input: Pick<StatusTabInput, "reachable" | "keyInvalid">): string;
+/** Status tab body: whoami + credits from `/me`. Reachability is the footer. */
+export declare function buildStatusTabLines(input: StatusTabInput): string[];
+/** In-place job detail for the Jobs tab (same envelope as `status <id>`). */
+export declare function formatJobDetailLines(row: ReviewJobRow): string[];
+/** Human labels for the Config tab and the static `settings` printout. */
+export declare const SETTINGS_LABELS: Record<SettingsWritableKey, string>;
+/** Config rows in a stable order: writable toggles, then connected flags. */
+export declare function buildConfigRows(settings: SettingsResponse): TabsConfigRow[];
+/**
+ * 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 declare function openTabsBrowser(initial: TabId): Promise<void>;