mergestorm 0.3.17 → 0.3.19

package/README.md

@@ -45,12 +45,12 @@ On a TTY, bare `mergestorm` (or `mergestorm shell`) opens a branded REPL: a comp
 
 ```
 ╭──────────────────────────────────────────────────────────────────────────────╮
-│ ▟██▛  mergestorm v0.3.17                                                     │
+│ ▟██▛  mergestorm v0.3.19                                                     │
 │  ▜▙   ● 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.17: nginx 413 names the upload limit instead of Failed: {} │
+│       New in v0.3.19: stack wait and held GET waits                          │
 ╰──────────────────────────────────────────────────────────────────────────────╯
 mergestorm
 ╭──────────────────────────────────────────────────────────────────────────────╮
@@ -86,7 +86,7 @@ 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 skill install --claude|--cursor|--agents  Copy the Mergestorm 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,6 +94,7 @@ 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 wait <stack-id>     Wait for stack attention (default 45s, max 300s)
 mergestorm stack reset --force  Clear local authoring state (not branches/PRs)
 ```
 

package/dist/api.d.ts

@@ -134,6 +134,11 @@ export type PrVortexReview = {
     finding_count: number;
     findings: PrReviewFindings | null;
     patch_policy: unknown | null;
+    /**
+     * MS-01: True when the returned row is a resting completion but a newer
+     * attempt is in flight (active lease). The CLI must continue polling.
+     */
+    newer_pass_pending?: boolean;
 };
 /**
  * Pass selection on the DB-only PR review read (#2027). `pass` names one row;
@@ -154,9 +159,9 @@ export declare function applyPrReviewQuery(query: URLSearchParams, opts: PrRevie
  */
 export { SETTINGS_WRITABLE_KEYS };
 export type { SettingsWritableKey };
-export type SettingsPatch = Partial<Record<SettingsWritableKey, boolean>>;
+export type SettingsPatch = Partial<import("./automation-catalog.js").BearerSettingsValues>;
 /** GET and PATCH `/api/v1/settings` both answer with this shape. */
-export type SettingsResponse = Record<SettingsWritableKey, boolean> & {
+export type SettingsResponse = import("./automation-catalog.js").BearerSettingsValues & {
     cyclone_connected: boolean;
     github_connected: boolean;
 };

package/dist/api.js

@@ -1,6 +1,6 @@
 import { apiBase, loadConfig, resolveApiKey } from "./config.js";
 import { BEARER_SETTINGS_KEYS as SETTINGS_WRITABLE_KEYS, } from "./automation-catalog.js";
-import { CommandError, REVIEW_EXIT, rateLimitedMessage } from "./errors.js";
+import { CommandError, REVIEW_EXIT, rateLimitedMessage, } from "./errors.js";
 /** Default per-request timeout so a hung API cannot stall the shell/CI forever. */
 export const DEFAULT_API_TIMEOUT_MS = 30_000;
 /** Message prefix of the CommandError thrown when a request exceeds its timeout. */
@@ -382,7 +382,43 @@ export async function adoptStack(owner, repo, prNumber, cfg, policy) {
         throw new CommandError(rateLimitedMessage(retryAfterSeconds), REVIEW_EXIT.rate_limited, "rate_limited", { retryAfterSeconds });
     }
     if (status !== 200) {
-        throw new CommandError(`Failed to import stack (HTTP ${status}): ${JSON.stringify(body)}`);
+        const error = body && typeof body === "object" && "error" in body && typeof body.error === "string"
+            ? body.error
+            : undefined;
+        const message = body && typeof body === "object" && "message" in body && typeof body.message === "string"
+            ? body.message
+            : undefined;
+        const code = error === "auth_invalid" ||
+            error === "api_timeout" ||
+            error === "not_a_repo" ||
+            error === "not_found" ||
+            error === "missing_api_key" ||
+            error === "registered_parent" ||
+            error === "usage" ||
+            error === "review_quota" ||
+            error === "review_failed" ||
+            error === "review_timeout" ||
+            error === "rate_limited" ||
+            error === "cyclone_not_installed" ||
+            error === "pr_merged" ||
+            error === "pr_closed" ||
+            error === "not_stacked" ||
+            error === "draft" ||
+            error === "reserved_branch" ||
+            error === "supabase_unconfigured" ||
+            error === "cyclone_not_connected" ||
+            error === "busy" ||
+            error === "adopt_failed"
+            ? error
+            : undefined;
+        const fallbackMessage = code === "not_stacked"
+            ? "This pull request is not part of a stack."
+            : code === "supabase_unconfigured"
+                ? "Stacks are not configured on this server."
+                : undefined;
+        throw new CommandError(message?.trim()
+            ? message
+            : fallbackMessage ?? `Failed to import stack (HTTP ${status}): ${JSON.stringify(body)}`, 1, code);
     }
     return body;
 }
@@ -414,6 +450,10 @@ async function stackMutation(stackId, pathSuffix, method, json, failLabel, cfg)
         throw new CommandError("Stacks API is not available on this server yet. Deploy the API update or use the dashboard.");
     }
     if (status !== 200) {
+        const rejection = body;
+        if (method === "PATCH" && rejection?.error === "cyclone_not_connected") {
+            throw new CommandError(typeof rejection.message === "string" ? rejection.message : rejection.error, 1, "cyclone_not_connected");
+        }
         throw new CommandError(`${failLabel} (HTTP ${status}): ${JSON.stringify(body)}`);
     }
     return body;

package/dist/automation-catalog.d.ts

@@ -22,6 +22,22 @@ export declare const BEARER_SETTINGS: readonly [{
     readonly key: "cyclone_review_unit_land_prs_enabled";
     readonly flag: "--cyclone-review-unit-land";
     readonly label: "Cyclone Review Unit land PRs";
+}, {
+    readonly key: "cyclone_skip_ci_enabled";
+    readonly flag: "--cyclone-skip-ci";
+    readonly label: "Skip CI on Cyclone commits";
+}, {
+    readonly key: "cyclone_patch_unverified_languages";
+    readonly flag: "--cyclone-patch-unverified";
+    readonly label: "Patch languages we cannot typecheck";
+}, {
+    readonly key: "vortex_auto_overflow_enabled";
+    readonly flag: "--vortex-auto-overflow";
+    readonly label: "Vortex auto overflow";
+}, {
+    readonly key: "vortex_skip_all_clear_comments";
+    readonly flag: "--vortex-skip-all-clear";
+    readonly label: "Vortex skip All-clear comments";
 }, {
     readonly key: "vortex_seam_specialist_enabled";
     readonly flag: "--vortex-seam";
@@ -30,8 +46,40 @@ export declare const BEARER_SETTINGS: readonly [{
     readonly key: "auto_land_default";
     readonly flag: "--auto-land";
     readonly label: "Auto land (new stacks)";
+}, {
+    readonly key: "ignored_bot_logins";
+    readonly flag: "--ignore-bot";
+    readonly label: "Ignored bot logins";
+    readonly kind: "logins";
+}, {
+    readonly key: "vortex_bot_skip_check";
+    readonly flag: "--vortex-skip-check";
+    readonly label: "Vortex bot skip check";
+    readonly kind: "enum";
+    readonly values: readonly ["none", "neutral"];
+}, {
+    readonly key: "vortex_findings_check";
+    readonly flag: "--vortex-findings";
+    readonly label: "Vortex findings check";
+    readonly kind: "enum";
+    readonly values: readonly ["failure", "neutral", "success"];
+}, {
+    readonly key: "cyclone_patch_failure_check";
+    readonly flag: "--cyclone-fail-check";
+    readonly label: "Cyclone patch failure check";
+    readonly kind: "enum";
+    readonly values: readonly ["failure", "neutral"];
 }];
 export type BearerSettingsKey = (typeof BEARER_SETTINGS)[number]["key"];
 export declare const BEARER_SETTINGS_KEYS: readonly BearerSettingsKey[];
 export declare const BEARER_SETTINGS_FLAGS: Record<string, BearerSettingsKey>;
 export declare const BEARER_SETTINGS_LABELS: Record<BearerSettingsKey, string>;
+/** Omitted kind means boolean for the original toggle rows. */
+export type BearerSettingsValues = {
+    [Row in (typeof BEARER_SETTINGS)[number] as Row["key"]]: Row extends {
+        kind: "logins";
+    } ? string[] : Row extends {
+        values: readonly (infer Value)[];
+    } ? Value : boolean;
+};
+export declare const BEARER_BOOLEAN_SETTINGS_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" | "cyclone_skip_ci_enabled" | "cyclone_patch_unverified_languages" | "vortex_auto_overflow_enabled" | "vortex_skip_all_clear_comments" | "vortex_seam_specialist_enabled" | "auto_land_default" | "ignored_bot_logins" | "vortex_bot_skip_check" | "vortex_findings_check" | "cyclone_patch_failure_check")[];

package/dist/automation-catalog.js

@@ -5,9 +5,20 @@ export const BEARER_SETTINGS = [
     { key: "repo_overview_enabled", flag: "--repo-overview", label: "Repo overview" },
     { key: "review_unit_land_prs_enabled", flag: "--review-unit-land", label: "Review Unit land PRs" },
     { key: "cyclone_review_unit_land_prs_enabled", flag: "--cyclone-review-unit-land", label: "Cyclone Review Unit land PRs" },
+    { key: "cyclone_skip_ci_enabled", flag: "--cyclone-skip-ci", label: "Skip CI on Cyclone commits" },
+    { key: "cyclone_patch_unverified_languages", flag: "--cyclone-patch-unverified", label: "Patch languages we cannot typecheck" },
+    { key: "vortex_auto_overflow_enabled", flag: "--vortex-auto-overflow", label: "Vortex auto overflow" },
+    { key: "vortex_skip_all_clear_comments", flag: "--vortex-skip-all-clear", label: "Vortex skip All-clear comments" },
     { key: "vortex_seam_specialist_enabled", flag: "--vortex-seam", label: "Vortex seam specialist" },
     { key: "auto_land_default", flag: "--auto-land", label: "Auto land (new stacks)" },
+    { key: "ignored_bot_logins", flag: "--ignore-bot", label: "Ignored bot logins", kind: "logins" },
+    { key: "vortex_bot_skip_check", flag: "--vortex-skip-check", label: "Vortex bot skip check", kind: "enum", values: ["none", "neutral"] },
+    { key: "vortex_findings_check", flag: "--vortex-findings", label: "Vortex findings check", kind: "enum", values: ["failure", "neutral", "success"] },
+    { key: "cyclone_patch_failure_check", flag: "--cyclone-fail-check", label: "Cyclone patch failure check", kind: "enum", values: ["failure", "neutral"] },
 ];
 export const BEARER_SETTINGS_KEYS = BEARER_SETTINGS.map((r) => r.key);
 export const BEARER_SETTINGS_FLAGS = Object.fromEntries(BEARER_SETTINGS.map((r) => [r.flag, r.key]));
 export const BEARER_SETTINGS_LABELS = Object.fromEntries(BEARER_SETTINGS.map((r) => [r.key, r.label]));
+export const BEARER_BOOLEAN_SETTINGS_KEYS = BEARER_SETTINGS
+    .filter((row) => !("kind" in row))
+    .map((row) => row.key);

package/dist/client/index.d.ts

@@ -1,7 +1,9 @@
 export { DEFAULT_API, apiBase, clearConfig, configPath, keyDisplay, loadConfig, mergestormHome, resolveApiKey, saveConfig, type Config, } from "../config.js";
-export { BEARER_SETTINGS, BEARER_SETTINGS_FLAGS, BEARER_SETTINGS_KEYS, BEARER_SETTINGS_LABELS, type BearerSettingsKey, } from "../automation-catalog.js";
+export { BEARER_SETTINGS, BEARER_BOOLEAN_SETTINGS_KEYS, BEARER_SETTINGS_FLAGS, BEARER_SETTINGS_KEYS, BEARER_SETTINGS_LABELS, type BearerSettingsKey, } from "../automation-catalog.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, setStackAutoLand, setStackPolicy, stackPolicyBody, 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 StackPolicyPatch, 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, PrReviewPollTimeoutError, ReviewPollTimeoutError, collectReviewInput, formatReviewSubmitError, 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";
 export { discoverTrunk } from "../git-stack.js";
+export { BOUNCE_KIND_LABELS, mergeQueueBounceLabel } from "../stack-dto.js";
+export { STACK_WATCH_SCHEMA, STACK_WATCH_DEFAULT_TIMEOUT_MS, StackWatchError, StackWatchTimeoutError, pollStackWatch, type PollStackWatchOptions, type StackWatchCursor, type StackWatchEnvelope, } from "../stack-watch.js";

package/dist/client/index.js

@@ -1,7 +1,9 @@
 export { DEFAULT_API, apiBase, clearConfig, configPath, keyDisplay, loadConfig, mergestormHome, resolveApiKey, saveConfig, } from "../config.js";
-export { BEARER_SETTINGS, BEARER_SETTINGS_FLAGS, BEARER_SETTINGS_KEYS, BEARER_SETTINGS_LABELS, } from "../automation-catalog.js";
+export { BEARER_SETTINGS, BEARER_BOOLEAN_SETTINGS_KEYS, BEARER_SETTINGS_FLAGS, BEARER_SETTINGS_KEYS, BEARER_SETTINGS_LABELS, } from "../automation-catalog.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, setStackAutoLand, setStackPolicy, stackPolicyBody, } 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, PrReviewPollTimeoutError, ReviewPollTimeoutError, collectReviewInput, formatReviewSubmitError, isTransientReviewPollError, isTransientReviewPollStatus, loadReviewContext, pollPrVortexReview, pollReview, stretchedPollIntervalMs, submitReview, transientRetryWaitMs, } from "../commands/review-client.js";
 export { REVIEW_JOB_ENVELOPE_SCHEMA, toReviewJobEnvelope, } from "../ui/job-envelope.js";
 export { discoverTrunk } from "../git-stack.js";
+export { BOUNCE_KIND_LABELS, mergeQueueBounceLabel } from "../stack-dto.js";
+export { STACK_WATCH_SCHEMA, STACK_WATCH_DEFAULT_TIMEOUT_MS, StackWatchError, StackWatchTimeoutError, pollStackWatch, } from "../stack-watch.js";

package/dist/commands/browse.d.ts

@@ -27,7 +27,7 @@ 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<"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" | "auto_land_default", string>;
+export declare const SETTINGS_LABELS: Record<"auto_review_enabled" | "auto_patch_enabled" | "vortex_show_thinking_traces" | "repo_overview_enabled" | "review_unit_land_prs_enabled" | "cyclone_review_unit_land_prs_enabled" | "cyclone_skip_ci_enabled" | "cyclone_patch_unverified_languages" | "vortex_auto_overflow_enabled" | "vortex_skip_all_clear_comments" | "vortex_seam_specialist_enabled" | "auto_land_default" | "ignored_bot_logins" | "vortex_bot_skip_check" | "vortex_findings_check" | "cyclone_patch_failure_check", string>;
 /** Config rows in a stable order: writable toggles, then connected flags. */
 export declare function buildConfigRows(settings: SettingsResponse): TabsConfigRow[];
 /**

package/dist/commands/browse.js

@@ -1,5 +1,5 @@
-import { getMe, getReview, getSettings, listJobs, patchSettings, SETTINGS_WRITABLE_KEYS, } from "../api.js";
-import { BEARER_SETTINGS_LABELS } from "../automation-catalog.js";
+import { getMe, getReview, getSettings, listJobs, patchSettings, } from "../api.js";
+import { BEARER_BOOLEAN_SETTINGS_KEYS, BEARER_SETTINGS_LABELS } from "../automation-catalog.js";
 import { apiBase, keyDisplay, loadConfig, resolveApiKey } from "../config.js";
 import { CommandError } from "../errors.js";
 import { ansi } from "../ui/ansi.js";
@@ -124,7 +124,7 @@ export const SETTINGS_LABELS = BEARER_SETTINGS_LABELS;
 /** Config rows in a stable order: writable toggles, then connected flags. */
 export function buildConfigRows(settings) {
     return [
-        ...SETTINGS_WRITABLE_KEYS.map((key) => ({
+        ...BEARER_BOOLEAN_SETTINGS_KEYS.map((key) => ({
             key,
             label: SETTINGS_LABELS[key],
             value: settings[key] === true,

package/dist/commands/help.js

@@ -58,7 +58,7 @@ export function buildHelpTabs() {
                 "",
                 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("stack list · wait <id>", "registered stacks · wait for attention"),
                 cmd("queue [add <stack-id>]", "list entries · queue verified landing"),
                 cmd("stack land <id>", "land now · skips queue verification"),
                 "",

package/dist/commands/queue.d.ts

@@ -5,7 +5,7 @@ export type QueueCmdDeps = {
     canBrowse?: () => boolean;
     runLineTabsBrowser?: typeof runLineTabsBrowser;
 };
-export declare const QUEUE_USAGE = "usage:\n  mergestorm queue [list] [--json]\n  mergestorm queue add <stack-id> [--json]\n  mergestorm queue rm <entry-id|stack-id> [--json]\n\n  queue lists your live merge-queue entries. rm prefers an entry id; a live\n  stack id is resolved to its queue entry before cancellation.";
+export declare const QUEUE_USAGE = "usage:\n  mergestorm queue [list] [--json]\n  mergestorm queue add <stack-id> [--json]\n  mergestorm queue rm <entry-id|stack-id> [--json]\n\n  queue lists live and recent bounced merge-queue entries. rm prefers an entry id; a live\n  stack id is resolved to its queue entry before cancellation.";
 /** Entry ids win; otherwise a live stack id resolves to its entry id. */
 export declare function resolveQueueEntryId(idOrStackId: string, entries: readonly MergeQueueEntryDto[]): string;
 export declare function buildQueueListLines(entries: readonly MergeQueueEntryDto[], fullStackId?: boolean): string[];

package/dist/commands/queue.js

@@ -1,6 +1,7 @@
 import { cancelMergeQueueEntry, enqueueStack, listMergeQueueEntries, } from "../api.js";
 import { loadConfig } from "../config.js";
 import { CommandError } from "../errors.js";
+import { mergeQueueBounceLabel } from "../stack-dto.js";
 import { ansi } from "../ui/ansi.js";
 import { runLineTabsBrowser } from "../ui/line-tabs.js";
 import { present } from "../ui/present.js";
@@ -31,7 +32,7 @@ export const QUEUE_USAGE = `usage:
   mergestorm queue add <stack-id> [--json]
   mergestorm queue rm <entry-id|stack-id> [--json]
 
-  queue lists your live merge-queue entries. rm prefers an entry id; a live
+  queue lists live and recent bounced merge-queue entries. rm prefers an entry id; a live
   stack id is resolved to its queue entry before cancellation.`;
 function positionalArgs(args) {
     const unknown = args.filter((arg) => arg.startsWith("-") &&
@@ -66,17 +67,31 @@ export function buildQueueListLines(entries, fullStackId = false) {
         ];
     }
     return entries.map((entry) => {
-        const reason = entry.waitReason ?? entry.bounceReason;
+        const reason = entry.bounceDetail
+            ? mergeQueueBounceLabel(entry)
+            : entry.waitReason ?? (entry.bounceReason ? mergeQueueBounceLabel(entry) : null);
+        const prNumber = entry.bounceDetail?.prNumber != null && entry.bounceDetail.prNumber > 0
+            ? entry.bounceDetail.prNumber
+            : entry.waitReason?.match(/#([1-9]\d*)\b/)?.[1];
+        const headSha = entry.bounceDetail?.headSha ?? entry.verifyHeadSha;
+        const pr = prNumber != null
+            ? `  #${prNumber}${headSha ? `@${headSha.slice(0, 7)}` : ""}`
+            : "";
         const glyph = colorQueueGlyph(entry.state, queueStateGlyph(entry.state));
         const id = fullStackId ? entry.stackId : entry.stackId.slice(0, 8);
-        const core = `  ${String(entry.position).padStart(2)}  ` +
-            `${glyph} ${entry.state.padEnd(8)}  ${entry.owner}/${entry.repo}  ${id}` +
-            (reason ? `  ${reason}` : "");
+        const coreWithoutReason = `  ${String(entry.position).padStart(2)}  ` +
+            `${glyph} ${entry.state.padEnd(8)}  ${entry.owner}/${entry.repo}  ${id}`;
+        const coreWithoutPr = coreWithoutReason + (reason ? `  ${reason}` : "");
+        const core = `${coreWithoutPr}${pr}`;
         const who = entry.enqueuedBy === "human" || entry.enqueuedBy === "agent"
             ? `  by ${entry.enqueuedBy}`
             : "";
         const withWho = `${core}${who}`;
-        return visibleWidth(withWho) <= 75 ? withWho : core;
+        if (visibleWidth(withWho) <= 80)
+            return withWho;
+        if (visibleWidth(core) <= 80)
+            return core;
+        return pr ? core : coreWithoutPr;
     });
 }
 async function listQueue(asJson, deps = {}) {

package/dist/commands/registry.js

@@ -52,6 +52,7 @@ export const COMMAND_REGISTRY = [
             "  [--context text] [--context-file path] [--thread slug]",
             "  [--idempotency-key k] [--webhook-url https://…]",
             "  HTTP 429 exits 7 (rate_limited) with retry_after_seconds",
+            "  Uploads over 1 MB / 1_000_000 are rejected with HTTP 413 and do not create a job",
         ],
         async run(args, ctx) {
             if (ctx.mode === "shell") {
@@ -164,8 +165,13 @@ export const COMMAND_REGISTRY = [
             "mergestorm settings [--json]    Read the automation toggles (Config tab on a TTY)",
             "  [--auto-review on|off] [--auto-patch on|off] [--vortex-thinking on|off]",
             "  [--repo-overview on|off] [--review-unit-land on|off]",
-            "  [--cyclone-review-unit-land on|off] [--vortex-seam on|off]",
-            "  [--auto-land on|off]            Auto land default for stacks opened after this",
+            "  [--cyclone-review-unit-land on|off] [--cyclone-skip-ci on|off]",
+            "  [--cyclone-patch-unverified on|off]  Patch languages we cannot typecheck",
+            "  [--vortex-seam on|off] [--vortex-skip-all-clear on|off]",
+            "  [--auto-land on|off]  Auto land default for new stacks",
+            "  [--ignore-bot add <login>|remove <login>|clear]",
+            "  [--vortex-skip-check none|neutral] [--vortex-findings failure|neutral|success]",
+            "  [--cyclone-fail-check failure|neutral]",
             "  With flags: PATCH those settings and print the stored result",
         ],
         async run(args, ctx) {
@@ -174,9 +180,9 @@ export const COMMAND_REGISTRY = [
     },
     {
         name: "skill",
-        summary: "Install mergestorm-review and mergestorm-pr-loop for Claude or Cursor",
+        summary: "Install Mergestorm skills for Claude, Cursor, or agents",
         usage: [
-            "mergestorm skill install --claude|--cursor  Copy the mergestorm-review and mergestorm-pr-loop skills into this repo",
+            "mergestorm skill install --claude|--cursor|--agents  Copy the Mergestorm skills into this repo",
             "  [--json]",
         ],
         async run(args) {
@@ -200,7 +206,7 @@ export const COMMAND_REGISTRY = [
         name: "queue",
         summary: "Merge queue: list, add a stack, or remove an entry",
         usage: [
-            "mergestorm queue [list] [--json]  List live merge-queue entries",
+            "mergestorm queue [list] [--json]  List live and recent bounced merge-queue entries",
             "mergestorm queue add <stack-id> [--json]  Queue a stack for verified landing",
             "mergestorm queue rm <entry-id|stack-id> [--json]  Remove a live queue entry",
         ],
@@ -216,13 +222,15 @@ export const COMMAND_REGISTRY = [
             "mergestorm stack submit         Push/open active stack ([--extend] [--auto-land on|off] [--auto-review on|off] [--auto-patch on|off])",
             "mergestorm stack reset --force  Clear this repo's pre-submit authoring state",
             "mergestorm stack list [--json]  List registered stacks",
+            "mergestorm stack status <stack-id> [--json]  Enriched stack status",
+            "mergestorm stack wait <stack-id> [--json] [--timeout <s>]  Wait for stack attention (default 45s, max 300s)",
             "mergestorm stack set <stack-id> [--auto-land on|off] [--auto-review on|off|default] [--auto-patch on|off|default] [--json]  Per-stack policy",
             "mergestorm stack adopt <owner/repo>#<pr> [--auto-land on|off] [--auto-review on|off] [--auto-patch on|off]  Import an open PR chain",
             "mergestorm stack restack <stack-id>   Restack stack descendants",
             "mergestorm stack land <stack-id>      Land bottom PR (or promote into unit)",
         ],
-        async run(args) {
-            await cmdStack(args);
+        async run(args, ctx) {
+            await cmdStack(args, { signal: ctx.signal });
         },
     },
     {

package/dist/commands/review-client.js

@@ -271,7 +271,6 @@ function shaMatches(actual, expected) {
 /** Poll the DB-only PR review endpoint until the requested pass is resting. */
 export async function pollPrVortexReview(cfg, owner, repo, prNumber, opts = {}) {
     const timeoutMs = opts.timeoutMs ?? REVIEW_POLL_DEFAULT_TIMEOUT_MS;
-    const intervalMs = opts.intervalMs ?? REVIEW_POLL_INTERVAL_MS;
     const now = opts.now ?? Date.now;
     const wait = opts.sleep ?? sleep;
     const startedAt = now();
@@ -296,17 +295,13 @@ export async function pollPrVortexReview(cfg, owner, repo, prNumber, opts = {})
         if (waitMs > 0)
             await wait(waitMs, opts.signal);
     };
-    const sleepBeforePoll = async () => {
-        const waitMs = Math.min(stretchedPollIntervalMs(now() - startedAt, intervalMs), Math.max(0, deadline - now()));
-        if (waitMs > 0)
-            await wait(waitMs, opts.signal);
-    };
     while (now() < deadline) {
+        query.set("wait", String(Math.min(45, Math.max(1, Math.ceil((deadline - now()) / 1000)))));
         let poll;
         try {
             poll = await apiFetch(cfg, `/api/v1/stacks/pr-review?${query.toString()}`, {
                 signal: opts.signal,
-                timeoutMs: Math.max(1, Math.min(30_000, deadline - now())),
+                timeoutMs: Number(query.get("wait")) * 1000 + 5_000,
             });
         }
         catch (err) {
@@ -331,7 +326,6 @@ export async function pollPrVortexReview(cfg, owner, repo, prNumber, opts = {})
         if (poll.status === 404) {
             transientFailures = 0;
             opts.onTick?.("progress");
-            await sleepBeforePoll();
             continue;
         }
         if (poll.status !== 200) {
@@ -358,16 +352,17 @@ export async function pollPrVortexReview(cfg, owner, repo, prNumber, opts = {})
             (!isPositiveInteger(envelope.pass) || (opts.pass !== undefined && envelope.pass !== opts.pass) ||
                 (opts.afterPass !== undefined && envelope.pass <= opts.afterPass))) {
             opts.onTick?.("progress");
-            await sleepBeforePoll();
             continue;
         }
         lastEnvelope = envelope;
         const resting = (lastEnvelope.raw_status ?? lastEnvelope.status) !== "in_progress";
         const matches = !opts.afterSha || shaMatches(lastEnvelope.head_sha, opts.afterSha);
-        if (resting && matches)
+        // MS-01: A resting completion with newer_pass_pending indicates a newer
+        // attempt is in flight. Do not satisfy the wait from this stale result.
+        const stale = lastEnvelope.newer_pass_pending === true;
+        if (resting && matches && !stale)
             return lastEnvelope;
         opts.onTick?.("progress");
-        await sleepBeforePoll();
     }
     throw new PrReviewPollTimeoutError(owner, repo, prNumber, lastEnvelope);
 }

package/dist/commands/review.js

@@ -40,7 +40,8 @@ function normalizeVortexSpecialistIds(value) {
     const selected = new Set(value.filter((id) => typeof id === "string" && VORTEX_SPECIALIST_IDS.includes(id)));
     return VORTEX_SPECIALIST_IDS.filter((id) => selected.has(id));
 }
-const REVIEW_USAGE = "usage: mergestorm review [base] [head] [--json] [--wait|--no-wait] [--timeout seconds] [--router off|standard|max|manual] [--specialists id,id] [--context text] [--context-file path] [--idempotency-key k] [--webhook-url https://…] [--thread slug]";
+const REVIEW_USAGE = "usage: mergestorm review [base] [head] [--json] [--wait|--no-wait] [--timeout seconds] [--router off|standard|max|manual] [--specialists id,id] [--context text] [--context-file path] [--idempotency-key k] [--webhook-url https://…] [--thread slug]\n" +
+    "Uploads over 1 MB / 1_000_000 are rejected with HTTP 413 and do not create a job.";
 function usageError(message = REVIEW_USAGE) {
     return new CommandError(message, REVIEW_EXIT.usage, "usage");
 }
@@ -164,6 +165,9 @@ export function parseReviewArgs(args) {
             thread = slug;
             continue;
         }
+        if (a === "-h" || a === "--help") {
+            throw usageError();
+        }
         if (a.startsWith("-")) {
             throw usageError(`unknown flag: ${a}`);
         }
@@ -227,6 +231,10 @@ function asPollCommandError(err, jobId) {
     return new CommandError(withReviewJobRecovery(`Poll failed: ${detail}`, jobId));
 }
 export async function cmdReview(args, opts = {}) {
+    if (args.includes("-h") || args.includes("--help")) {
+        console.log(REVIEW_USAGE);
+        return;
+    }
     const parsed = parseReviewArgs(args);
     const base = resolveReviewBase(parsed.base);
     const head = parsed.head || "HEAD";

package/dist/commands/settings.d.ts

@@ -1,17 +1,25 @@
 import { type SettingsPatch, type SettingsResponse } from "../api.js";
 /**
- * CLI flag → Bearer settings key. on|off only. The connected flags are
+ * CLI flag → Bearer settings key. Boolean flags take on|off. The connected flags are
  * read-only on the API and deliberately have no flag here.
  */
-export declare const SETTINGS_FLAGS: Record<string, "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" | "auto_land_default">;
+export declare const SETTINGS_FLAGS: Record<string, "auto_review_enabled" | "auto_patch_enabled" | "vortex_show_thinking_traces" | "repo_overview_enabled" | "review_unit_land_prs_enabled" | "cyclone_review_unit_land_prs_enabled" | "cyclone_skip_ci_enabled" | "cyclone_patch_unverified_languages" | "vortex_auto_overflow_enabled" | "vortex_skip_all_clear_comments" | "vortex_seam_specialist_enabled" | "auto_land_default" | "ignored_bot_logins" | "vortex_bot_skip_check" | "vortex_findings_check" | "cyclone_patch_failure_check">;
+type IgnoreBotOperation = {
+    action: "add" | "remove";
+    login: string;
+} | {
+    action: "clear";
+};
 export type SettingsArgs = {
     json: boolean;
     patch: SettingsPatch;
+    ignoreBots?: IgnoreBotOperation[];
 };
-/** Parse `settings` argv. Accepts `--flag on|off` and `--flag=on|off`. */
+/** Parse boolean and enum flags plus ordered ignore-list operations. */
 export declare function parseSettingsArgs(args: string[]): SettingsArgs;
-/** Static printout of the GET/PATCH response shape (rows match the Config tab). */
+/** Static printout includes the Config toggles plus enum and login settings. */
 export declare function formatSettingsLines(settings: SettingsResponse): string[];
 export declare function cmdSettings(args: string[], opts?: {
     mode?: "oneshot" | "shell";
 }): Promise<void>;
+export {};