mergestorm 0.3.13 → 0.3.15

package/dist/commands/review.js

@@ -3,7 +3,8 @@ import { loadConfig } from "../config.js";
 import { CommandError, DetachedError, REVIEW_EXIT, isCommandErrorCode, rateLimitedMessage, } from "../errors.js";
 import { discoverTrunk } from "../git-stack.js";
 import { ansi } from "../ui/ansi.js";
-import { renderFindings } from "../ui/findings.js";
+import { formatFindingsLines } from "../ui/findings.js";
+import { present } from "../ui/present.js";
 import { toReviewJobEnvelope, } from "../ui/job-envelope.js";
 import { MAX_IDEMPOTENCY_KEY_CHARS, REVIEW_POLL_DEFAULT_TIMEOUT_MS, REVIEW_POLL_MAX_TRANSIENT_RETRIES, REVIEW_THREAD_SLUG_RE, ReviewPollTimeoutError, collectReviewInput, isTransientReviewPollError, isTransientReviewPollStatus, loadReviewContext, pollReview, submitReview, } from "./review-client.js";
 export { REVIEW_POLL_MAX_TRANSIENT_RETRIES, isTransientReviewPollError, isTransientReviewPollStatus, };
@@ -11,6 +12,12 @@ export { REVIEW_POLL_MAX_TRANSIENT_RETRIES, isTransientReviewPollError, isTransi
 export const VORTEX_ROUTER_MODES = ["off", "standard", "max", "manual"];
 /** Standard/Max fleet caps; Manual is capped at Max. */
 export const VORTEX_ROUTER_CAPS = { standard: 3, max: 5 };
+/**
+ * Pinnable L0 lanes only. Keep this list byte-identical to
+ * `pinnableVortexSpecialistIds(VORTEX_SPECIALIST_IDS)` in review-findings
+ * (`cli-lockstep.test.ts`). Do not add `governance` (round-gated) or `seam`
+ * (phase-gated). Those L1 lanes are not local pins.
+ */
 export const VORTEX_SPECIALIST_IDS = [
     "security",
     "performance",
@@ -394,14 +401,17 @@ export async function cmdReview(args, opts = {}) {
             printJson(row, { jobId });
             return;
         }
-        console.log(`\nVerdict: ${ansi.bold(row.verdict ?? "comment")}`);
         const ran = row.specialists_run ?? row.findings?.specialists_run ?? [];
+        const result = [
+            `Verdict: ${ansi.bold(row.verdict ?? "comment")}`,
+        ];
         if (ran.length > 0)
-            console.log(ansi.dim(`Specialists: ${ran.join(", ")}`));
-        console.log(row.summary ?? "");
-        renderFindings(row.findings, {
+            result.push(ansi.dim(`Specialists: ${ran.join(", ")}`));
+        if (row.summary)
+            result.push(row.summary);
+        result.push(...formatFindingsLines(row.findings, {
             emptyMessage: true,
-        });
+        }));
         if (interactive && meBefore) {
             const meAfter = await getMe(cfg);
             if (meAfter) {
@@ -409,10 +419,11 @@ export async function cmdReview(args, opts = {}) {
                 const afterLeft = meAfter.usage.standard.remaining ?? 0;
                 const used = Math.max(0, beforeLeft - afterLeft);
                 if (used > 0) {
-                    console.log(ansi.dim(`\n${used} credit${used === 1 ? "" : "s"} used · ${afterLeft} remaining`));
+                    result.push(ansi.dim(`${used} credit${used === 1 ? "" : "s"} used · ${afterLeft} remaining`));
                 }
             }
         }
+        await present("Review", result);
     }
     catch (err) {
         if (err instanceof DetachedError)

package/dist/commands/settings.d.ts

@@ -0,0 +1,17 @@
+import { type SettingsPatch, type SettingsResponse, type SettingsWritableKey } from "../api.js";
+/**
+ * CLI flag → Bearer settings key. on|off only. The connected flags are
+ * read-only on the API and deliberately have no flag here.
+ */
+export declare const SETTINGS_FLAGS: Record<string, SettingsWritableKey>;
+export type SettingsArgs = {
+    json: boolean;
+    patch: SettingsPatch;
+};
+/** Parse `settings` argv. Accepts `--flag on|off` and `--flag=on|off`. */
+export declare function parseSettingsArgs(args: string[]): SettingsArgs;
+/** Static printout of the GET/PATCH response shape (rows match the Config tab). */
+export declare function formatSettingsLines(settings: SettingsResponse): string[];
+export declare function cmdSettings(args: string[], opts?: {
+    mode?: "oneshot" | "shell";
+}): Promise<void>;

package/dist/commands/settings.js

@@ -0,0 +1,89 @@
+import { getSettings, patchSettings, } from "../api.js";
+import { loadConfig } from "../config.js";
+import { CommandError } from "../errors.js";
+import { present } from "../ui/present.js";
+import { buildConfigRows, canBrowse, openTabsBrowser } from "./browse.js";
+/**
+ * CLI flag → Bearer settings key. on|off only. The connected flags are
+ * read-only on the API and deliberately have no flag here.
+ */
+export const SETTINGS_FLAGS = {
+    "--auto-review": "auto_review_enabled",
+    "--auto-patch": "auto_patch_enabled",
+    "--vortex-thinking": "vortex_show_thinking_traces",
+    "--repo-overview": "repo_overview_enabled",
+    "--review-unit-land": "review_unit_land_prs_enabled",
+    "--cyclone-review-unit-land": "cyclone_review_unit_land_prs_enabled",
+    "--vortex-seam": "vortex_seam_specialist_enabled",
+};
+/** Parse `settings` argv. Accepts `--flag on|off` and `--flag=on|off`. */
+export function parseSettingsArgs(args) {
+    let json = false;
+    const patch = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--json") {
+            json = true;
+            continue;
+        }
+        const eq = arg.indexOf("=");
+        const flag = eq >= 0 ? arg.slice(0, eq) : arg;
+        const key = SETTINGS_FLAGS[flag];
+        if (!key) {
+            throw new CommandError(`Unknown settings flag: ${flag}. See \`mergestorm --help\`.`, 2, "usage");
+        }
+        const value = eq >= 0 ? arg.slice(eq + 1) : args[++i];
+        if (value !== "on" && value !== "off") {
+            throw new CommandError(`${flag} takes on or off.`, 2, "usage");
+        }
+        patch[key] = value === "on";
+    }
+    return { json, patch };
+}
+/** Static printout of the GET/PATCH response shape (rows match the Config tab). */
+export function formatSettingsLines(settings) {
+    const rows = buildConfigRows(settings);
+    const labelWidth = Math.max(...rows.map((r) => r.label.length));
+    return rows.map((row) => {
+        const value = row.writable
+            ? row.value
+                ? "on"
+                : "off"
+            : row.value
+                ? "connected"
+                : "not connected";
+        return `  ${row.label.padEnd(labelWidth + 2)}${value}`;
+    });
+}
+export async function cmdSettings(args, opts = {}) {
+    const { json, patch } = parseSettingsArgs(args);
+    const hasPatch = Object.keys(patch).length > 0;
+    // Bare `settings` on a TTY: the tabbed browser, opened on Config.
+    if (!hasPatch && !json && canBrowse()) {
+        await openTabsBrowser("config");
+        return;
+    }
+    const cfg = await loadConfig();
+    let settings;
+    if (hasPatch) {
+        settings = await patchSettings(patch, cfg);
+    }
+    else {
+        const got = await getSettings(cfg);
+        if (!got) {
+            throw new CommandError("Settings are not available (offline or API too old). " +
+                "Try again or open https://mergestorm.ai/settings");
+        }
+        settings = got;
+    }
+    if (json) {
+        const text = JSON.stringify(settings, null, 2);
+        if (opts.mode === "shell") {
+            await present("Settings", text.split("\n"));
+            return;
+        }
+        console.log(text);
+        return;
+    }
+    await present("Settings", formatSettingsLines(settings));
+}

package/dist/commands/skill.d.ts

@@ -0,0 +1,20 @@
+export declare const SKILL_NAME = "mergestorm-review";
+export declare const PR_LOOP_SKILL_NAME = "mergestorm-pr-loop";
+export declare const SKILL_NAMES: readonly ["mergestorm-review", "mergestorm-pr-loop"];
+export type SkillName = (typeof SKILL_NAMES)[number];
+export declare const SKILL_USAGE = "usage:\n  mergestorm skill install --claude|--cursor [--json]\n\n  Copies mergestorm-review and mergestorm-pr-loop into this repo (git toplevel, else cwd):\n    --claude  .claude/skills/<name>/SKILL.md\n    --cursor  .cursor/skills/<name>/SKILL.md\n  Pass both flags to write both trees. Overwrites existing copies.";
+export type SkillTarget = "claude" | "cursor";
+export type SkillInstallRequest = {
+    help: boolean;
+    json: boolean;
+    targets: SkillTarget[];
+};
+export declare function parseSkillArgs(args: string[]): SkillInstallRequest;
+/** Prefer the git repo root so `mg skill install` from a subdir still lands in-project. */
+export declare function skillInstallRoot(cwd?: string): string;
+export declare function skillDestination(root: string, target: SkillTarget, name?: SkillName): string;
+export declare function resolveBundledSkillPath(fromFile?: string, name?: SkillName): string;
+export declare function writeSkillCopies(sourcePath: string, destinations: string[]): Promise<string[]>;
+export declare function cmdSkill(args: string[], opts?: {
+    cwd?: string;
+}): Promise<void>;

package/dist/commands/skill.js

@@ -0,0 +1,145 @@
+import { existsSync, readFileSync } from "node:fs";
+import { lstat, mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { CommandError, isCommandErrorCode } from "../errors.js";
+import { gitTopLevel } from "../repo-identity.js";
+import { present } from "../ui/present.js";
+export const SKILL_NAME = "mergestorm-review";
+export const PR_LOOP_SKILL_NAME = "mergestorm-pr-loop";
+export const SKILL_NAMES = [SKILL_NAME, PR_LOOP_SKILL_NAME];
+export const SKILL_USAGE = `usage:
+  mergestorm skill install --claude|--cursor [--json]
+
+  Copies mergestorm-review and mergestorm-pr-loop into this repo (git toplevel, else cwd):
+    --claude  .claude/skills/<name>/SKILL.md
+    --cursor  .cursor/skills/<name>/SKILL.md
+  Pass both flags to write both trees. Overwrites existing copies.`;
+export function parseSkillArgs(args) {
+    const [sub, ...rest] = args;
+    if (!sub || sub === "-h" || sub === "--help" || sub === "help") {
+        return { help: true, json: false, targets: [] };
+    }
+    if (sub !== "install") {
+        throw new CommandError(`${SKILL_USAGE}\nunknown skill subcommand: ${sub}`, 1, "usage");
+    }
+    let json = false;
+    const targets = [];
+    for (const arg of rest) {
+        if (arg === "--json") {
+            json = true;
+            continue;
+        }
+        if (arg === "--claude") {
+            if (!targets.includes("claude"))
+                targets.push("claude");
+            continue;
+        }
+        if (arg === "--cursor") {
+            if (!targets.includes("cursor"))
+                targets.push("cursor");
+            continue;
+        }
+        if (arg === "-h" || arg === "--help" || arg === "help") {
+            return { help: true, json: false, targets: [] };
+        }
+        throw new CommandError(`${SKILL_USAGE}\nunknown flag: ${arg}`, 1, "usage");
+    }
+    if (targets.length === 0) {
+        throw new CommandError(`${SKILL_USAGE}\npass --claude and/or --cursor`, 1, "usage");
+    }
+    return { help: false, json, targets };
+}
+/** Prefer the git repo root so `mg skill install` from a subdir still lands in-project. */
+export function skillInstallRoot(cwd = process.cwd()) {
+    try {
+        return gitTopLevel(cwd);
+    }
+    catch (err) {
+        if (isCommandErrorCode(err, "not_a_repo"))
+            return path.resolve(cwd);
+        throw err;
+    }
+}
+export function skillDestination(root, target, name = SKILL_NAME) {
+    if (target === "claude") {
+        return path.join(root, ".claude", "skills", name, "SKILL.md");
+    }
+    return path.join(root, ".cursor", "skills", name, "SKILL.md");
+}
+export function resolveBundledSkillPath(fromFile = import.meta.url, name = SKILL_NAME) {
+    const here = path.dirname(fileURLToPath(fromFile));
+    const packageRoot = path.resolve(here, "..", "..");
+    // The published package ships the review skill at skill/SKILL.md; extra
+    // skills sit beside it in per-name directories. The monorepo keeps every
+    // skill under skills/<name>/SKILL.md.
+    const candidates = name === SKILL_NAME
+        ? [
+            path.join(packageRoot, "skill", "SKILL.md"),
+            path.join(packageRoot, "..", "..", "skills", name, "SKILL.md"),
+        ]
+        : [
+            path.join(packageRoot, "skill", name, "SKILL.md"),
+            path.join(packageRoot, "..", "..", "skills", name, "SKILL.md"),
+        ];
+    for (const candidate of candidates) {
+        if (existsSync(candidate))
+            return candidate;
+    }
+    throw new CommandError(`${name} skill is missing (looked in ${candidates.join(" and ")})`);
+}
+async function assertNoSymlink(dest) {
+    const parts = dest.split(path.sep);
+    const marker = parts.findIndex((p) => p === ".claude" || p === ".cursor");
+    const first = marker === -1 ? parts.length - 1 : marker;
+    for (let i = first; i < parts.length; i++) {
+        const candidate = parts.slice(0, i + 1).join(path.sep);
+        let stat;
+        try {
+            stat = await lstat(candidate);
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                continue;
+            throw err;
+        }
+        if (stat.isSymbolicLink()) {
+            throw new CommandError(`refusing to write skill through symlink: ${candidate}`);
+        }
+    }
+}
+export async function writeSkillCopies(sourcePath, destinations) {
+    const body = readFileSync(sourcePath, "utf8");
+    const written = [];
+    for (const dest of destinations) {
+        await assertNoSymlink(dest);
+        await mkdir(path.dirname(dest), { recursive: true });
+        await writeFile(dest, body, "utf8");
+        written.push(dest);
+    }
+    return written;
+}
+export async function cmdSkill(args, opts = {}) {
+    const req = parseSkillArgs(args);
+    if (req.help) {
+        await present("Skill", SKILL_USAGE.split("\n"));
+        return;
+    }
+    const root = skillInstallRoot(opts.cwd);
+    const sources = {};
+    const written = [];
+    for (const name of SKILL_NAMES) {
+        const source = resolveBundledSkillPath(undefined, name);
+        sources[name] = source;
+        const destinations = req.targets.map((t) => skillDestination(root, t, name));
+        written.push(...(await writeSkillCopies(source, destinations)));
+    }
+    if (req.json) {
+        await present("Skill", JSON.stringify({ names: SKILL_NAMES, sources, written }, null, 2).split("\n"));
+        return;
+    }
+    await present("Skill", [
+        `  Installed ${SKILL_NAMES.join(" and ")}`,
+        ...written.map((dest) => `  ${dest}`),
+    ]);
+}

package/dist/commands/stack.d.ts

@@ -28,6 +28,8 @@ export declare function parseAdoptTarget(args: string[]): {
     repo: string;
     prNumber: number;
 };
+/** Empty + populated bodies for the TTY `stack list` panel. */
+export declare function buildStackListLines(stacks: StackDto[]): string[];
 /** Parse `stack create` argv into options. Exported for tests. */
 export declare function parseStackCreateArgs(args: string[]): {
     name?: string;

package/dist/commands/stack.js

@@ -1,4 +1,4 @@
-import { adoptStack, ensureUpperPark, landNextStack, listStacks, restackStack, setStackAutoPromote, } from "../api.js";
+import { adoptStack, ensureUpperPark, landNextStack, listStacks, restackStack, } from "../api.js";
 import { loadConfig } from "../config.js";
 import { CommandError } from "../errors.js";
 import { createPr, findOpenPrNumber, requireGh } from "../gh.js";
@@ -9,6 +9,10 @@ import { gitTopLevel } from "../repo-identity.js";
 import { activeLayers, appendLayer, emptyStackMeta, loadStackMeta, removeActiveStack, resetStackMeta, saveStackMeta, selectStackForCreate, } from "../stack-meta.js";
 import { isMgParkBranch, planSubmitLayerBases } from "../submit-pr-base.js";
 import { ansi } from "../ui/ansi.js";
+import { runLineTabsBrowser } from "../ui/line-tabs.js";
+import { present } from "../ui/present.js";
+import { canBrowse } from "./browse.js";
+import { openHelpBrowser } from "./help.js";
 const STACK_USAGE = `usage:
   mergestorm stack create [name] [--onto <branch>] [--trunk <branch>] [--extend] [--json]
   mergestorm stack submit [--extend] [--json]
@@ -17,7 +21,6 @@ const STACK_USAGE = `usage:
   mergestorm stack adopt <owner/repo>#<pr>
   mergestorm stack restack <stack-id> [--json]
   mergestorm stack land <stack-id> [--json]
-  mergestorm stack auto-promote on|off <stack-id> [--json]
 
   stack submit opens PRs with a body generated from each layer tip commit.
   Layers 1–2 use the git parent as GitHub base. Layer 3+ opens onto the
@@ -97,10 +100,35 @@ export function parseAdoptTarget(args) {
     }
     throw new CommandError(`usage: mergestorm stack adopt <owner/repo>#<pr>`);
 }
+const stackCmd = (name, blurb) => `  ${ansi.brightGreen(name.padEnd(26))}${blurb}`;
+/** Empty + populated bodies for the TTY `stack list` panel. */
+export function buildStackListLines(stacks) {
+    if (stacks.length === 0) {
+        return [
+            `  ${ansi.bold("None yet")}`,
+            "  No registered stacks for this key.",
+            "",
+            `  ${ansi.bold("Author one")}`,
+            stackCmd("stack create", "new layer on this branch"),
+            "  commit, then  stack submit",
+            "",
+            `  ${ansi.bold("Or import")}`,
+            stackCmd("stack adopt org/repo#12", "open GitHub chain"),
+            "",
+            ansi.dim("  Dashboard: https://mergestorm.ai/dashboard"),
+        ];
+    }
+    const lines = [];
+    for (const s of stacks) {
+        lines.push(...formatStackHuman(s));
+        lines.push("");
+    }
+    lines.push(ansi.dim("  create · submit · land <id> · q to close"));
+    return lines;
+}
 function formatStackHuman(s) {
     const lines = [];
-    const auto = s.autoPromoteWhenGreen ? " · auto-promote" : "";
-    lines.push(`  ${ansi.bold(`${s.owner}/${s.repo}`)}  trunk=${s.trunkBranch}${auto}`);
+    lines.push(`  ${ansi.bold(`${s.owner}/${s.repo}`)}  trunk=${s.trunkBranch}`);
     lines.push(`  ${ansi.dim(s.id)}`);
     if (s.layers.length === 0) {
         lines.push(ansi.dim("    (no layers)"));
@@ -288,13 +316,16 @@ async function cmdStackCreate(args, deps = {}) {
         }, null, 2));
         return;
     }
-    console.log(ansi.green(`  Created ${branch} (onto ${parentBranch})`));
+    const created = [
+        ansi.brightGreen(`  Created ${branch} (onto ${parentBranch})`),
+    ];
     if (registeredHit) {
-        console.log(ansi.dim(`  extending registered stack ${registeredHit.stackId}` +
+        created.push(ansi.dim(`  extending registered stack ${registeredHit.stackId}` +
             (registeredHit.prNumber > 0 ? ` (from #${registeredHit.prNumber})` : "")));
     }
-    console.log(ansi.dim(`  trunk: ${meta.trunk} · local stacks: ${meta.stacks.length} · active layers: ${layers.length}`));
-    console.log(ansi.dim("  authoring state: managed automatically outside the repository"));
+    created.push(ansi.dim(`  trunk: ${meta.trunk} · local stacks: ${meta.stacks.length} · active layers: ${layers.length}`));
+    created.push(ansi.dim("  authoring state: managed automatically outside the repository"));
+    await present("Stack", created);
 }
 export async function cmdStackSubmit(args, deps = {}) {
     const { extend, asJson } = parseStackSubmitArgs(args);
@@ -495,22 +526,26 @@ export async function cmdStackSubmit(args, deps = {}) {
         }, null, 2));
         return;
     }
+    const summary = [];
     for (const row of opened) {
         const verb = row.created ? "opened" : "exists";
-        console.log(ansi.green(`  #${row.prNumber}  ${row.branch} → ${row.base}  (${verb})`));
+        summary.push(ansi.brightGreen(`  #${row.prNumber}  ${row.branch} → ${row.base}  (${verb})`));
     }
     if (stackId) {
-        console.log(ansi.green(`  Registered stack ${stackId}`));
+        summary.push(ansi.brightGreen(`  Registered stack ${stackId}`));
     }
     else {
-        console.log(ansi.dim("  Stack registration returned no stack ID"));
+        summary.push(ansi.dim("  Stack registration returned no stack ID"));
     }
-    console.log(ansi.dim("  Dashboard: https://mergestorm.ai/dashboard"));
+    summary.push(ansi.dim("  Dashboard: https://mergestorm.ai/dashboard"));
+    await present("Stack", summary);
 }
 async function cmdStackReset(args) {
     parseStackResetArgs(args);
     await resetStackMeta(process.cwd());
-    console.log(ansi.green("  Cleared CLI-managed pre-submit stack state. Branches, PRs, and registered stacks were not changed."));
+    await present("Stack", [
+        ansi.brightGreen("  Cleared CLI-managed pre-submit stack state. Branches, PRs, and registered stacks were not changed."),
+    ]);
 }
 async function cmdStackList(args) {
     const asJson = args.includes("--json");
@@ -520,18 +555,26 @@ async function cmdStackList(args) {
         console.log(JSON.stringify({ stacks }, null, 2));
         return;
     }
+    if (canBrowse()) {
+        await runLineTabsBrowser({
+            tabs: [{ id: "yours", label: "Stacks", lines: buildStackListLines(stacks) }],
+        });
+        return;
+    }
     if (stacks.length === 0) {
-        console.log(ansi.dim("  No stacks yet. Author with `stack create` → commit → `stack submit`."));
-        console.log(ansi.dim("  Import an existing chain only: `stack adopt owner/repo#pr`"));
-        console.log(ansi.dim("  Dashboard: https://mergestorm.ai/dashboard"));
+        await present("Stacks", [
+            ansi.dim("  No stacks yet. Author with `stack create` → commit → `stack submit`."),
+            ansi.dim("  Import an existing chain only: `stack adopt owner/repo#pr`"),
+            ansi.dim("  Dashboard: https://mergestorm.ai/dashboard"),
+        ]);
         return;
     }
+    const listed = [];
     for (const s of stacks) {
-        for (const line of formatStackHuman(s))
-            console.log(line);
-        console.log("");
+        listed.push(...formatStackHuman(s), "");
     }
-    console.log(ansi.dim("  Dashboard: https://mergestorm.ai/dashboard"));
+    listed.push(ansi.dim("  Dashboard: https://mergestorm.ai/dashboard"));
+    await present("Stacks", listed);
 }
 async function cmdStackAdopt(args) {
     const asJson = args.includes("--json");
@@ -552,13 +595,16 @@ async function cmdStackAdopt(args) {
     const data = body;
     const stack = data.stack;
     const chain = data.chain;
-    console.log(ansi.green(`  Imported ${owner}/${repo}#${prNumber}` +
-        (stack?.id ? ` → ${stack.id}` : "") +
-        (Array.isArray(chain) ? ` (${chain.length} layer(s))` : "")));
+    const imported = [
+        ansi.brightGreen(`  Imported ${owner}/${repo}#${prNumber}` +
+            (stack?.id ? ` → ${stack.id}` : "") +
+            (Array.isArray(chain) ? ` (${chain.length} layer(s))` : "")),
+    ];
     if (stack?.trunkBranch) {
-        console.log(ansi.dim(`  trunk: ${stack.trunkBranch}`));
+        imported.push(ansi.dim(`  trunk: ${stack.trunkBranch}`));
     }
-    console.log(ansi.dim("  Dashboard: https://mergestorm.ai/dashboard"));
+    imported.push(ansi.dim("  Dashboard: https://mergestorm.ai/dashboard"));
+    await present("Stack", imported);
 }
 async function cmdStackRestack(args) {
     const asJson = args.includes("--json");
@@ -570,7 +616,9 @@ async function cmdStackRestack(args) {
         return;
     }
     const fromBranch = body.fromBranch;
-    console.log(ansi.green(`  Restack started` + (fromBranch ? ` from ${fromBranch}` : "") + ` (${id})`));
+    await present("Stack", [
+        ansi.brightGreen(`  Restack started` + (fromBranch ? ` from ${fromBranch}` : "") + ` (${id})`),
+    ]);
 }
 async function cmdStackLand(args) {
     const asJson = args.includes("--json");
@@ -586,39 +634,31 @@ async function cmdStackLand(args) {
     const branch = body.mergedBranch;
     const uNumber = body.uNumber;
     if (typeof uNumber === "number" && uNumber > 0) {
-        console.log(ansi.green(`  Promoted` +
-            (pr != null ? ` #${pr}` : "") +
-            ` into U${uNumber}` +
-            (branch ? ` (${branch})` : "") +
-            ` on ${id}`));
+        await present("Stack", [
+            ansi.brightGreen(`  Promoted` +
+                (pr != null ? ` #${pr}` : "") +
+                ` into U${uNumber}` +
+                (branch ? ` (${branch})` : "") +
+                ` on ${id}`),
+        ]);
         return;
     }
-    console.log(ansi.green(`  Landed` +
-        (pr != null ? ` #${pr}` : "") +
-        (branch ? ` (${branch})` : "") +
-        ` on ${id}`));
-}
-async function cmdStackAutoLand(args) {
-    const asJson = args.includes("--json");
-    const filtered = args.filter((a) => a !== "--json");
-    const mode = filtered[0]?.toLowerCase();
-    const id = requireStackId(filtered[1], "usage: mergestorm stack auto-promote on|off <stack-id>");
-    if (mode !== "on" && mode !== "off") {
-        throw new CommandError("usage: mergestorm stack auto-promote on|off <stack-id>");
-    }
-    const cfg = await loadConfig();
-    const body = await setStackAutoPromote(id, mode === "on", cfg);
-    if (asJson) {
-        console.log(JSON.stringify(body, null, 2));
-        return;
-    }
-    console.log(ansi.green(`  Auto-promote ${mode} for ${id}`));
+    await present("Stack", [
+        ansi.brightGreen(`  Landed` +
+            (pr != null ? ` #${pr}` : "") +
+            (branch ? ` (${branch})` : "") +
+            ` on ${id}`),
+    ]);
 }
 export async function cmdStack(args) {
     const sub = args[0]?.toLowerCase();
     const rest = args.slice(1);
     // Help must exit 0 — print usage, do not throw CommandError.
     if (!sub || sub === "-h" || sub === "--help" || sub === "help") {
+        if (canBrowse()) {
+            await openHelpBrowser("stacks");
+            return;
+        }
         console.log(STACK_USAGE);
         return;
     }
@@ -636,11 +676,5 @@ export async function cmdStack(args) {
         return cmdStackRestack(rest);
     if (sub === "land" || sub === "land-next")
         return cmdStackLand(rest);
-    if (sub === "auto-promote" ||
-        sub === "autopromote" ||
-        sub === "auto-land" ||
-        sub === "autoland") {
-        return cmdStackAutoLand(rest);
-    }
     throw new CommandError(`${STACK_USAGE}\nunknown stack subcommand: ${sub}`);
 }

package/dist/commands/status.d.ts

@@ -12,6 +12,8 @@ export type StatusOptions = {
     interactive?: boolean;
     /** Test seam; production uses the two-second poll interval. */
     pollIntervalMs?: number;
+    /** Shell: route --json through the hold-to-read panel instead of console.log. */
+    mode?: "oneshot" | "shell";
 };
 export declare function parseStatusArgs(args: string[], defaults?: {
     format: "json" | "pretty";