mergestorm 0.3.13 → 0.3.16

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, setStackPolicy, } from "../api.js";
 import { loadConfig } from "../config.js";
 import { CommandError } from "../errors.js";
 import { createPr, findOpenPrNumber, requireGh } from "../gh.js";
@@ -6,19 +6,26 @@ import { parseGithubOriginRepo } from "../git.js";
 import { branchExists, commitsAheadOf, createBranchFromHead, currentBranch, defaultLayerBranchName, deleteBranch, discoverTrunk, fetchRemoteBranch, pushBranch, tipCommitMessage, tipCommitSubject, worktreeDirty, } from "../git-stack.js";
 import { buildPrBodyFromCommit } from "../pr-body.js";
 import { gitTopLevel } from "../repo-identity.js";
-import { activeLayers, appendLayer, emptyStackMeta, loadStackMeta, removeActiveStack, resetStackMeta, saveStackMeta, selectStackForCreate, } from "../stack-meta.js";
+import { activeLayers, appendLayer, emptyStackMeta, loadStackMeta, removeActiveStack, resetStackMeta, saveStackMeta, selectStackForCreate, setActivePolicy, } 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]
+  mergestorm stack create [name] [--onto <branch>] [--trunk <branch>] [--extend] [--auto-land on|off] [--auto-review on|off] [--auto-patch on|off] [--json]
+  mergestorm stack submit [--extend] [--auto-land on|off] [--auto-review on|off] [--auto-patch on|off] [--json]
   mergestorm stack reset --force
   mergestorm stack list [--json]
-  mergestorm stack adopt <owner/repo>#<pr>
+  mergestorm stack set <stack-id> [--auto-land on|off] [--auto-review on|off|default] [--auto-patch on|off|default] [--json]
+  mergestorm stack adopt <owner/repo>#<pr> [--auto-land on|off] [--auto-review on|off] [--auto-patch on|off] [--json]
   mergestorm stack restack <stack-id> [--json]
   mergestorm stack land <stack-id> [--json]
-  mergestorm stack auto-promote on|off <stack-id> [--json]
 
+  --auto-review / --auto-patch pin Vortex auto-review / Cyclone auto-patch for
+  one stack in either direction. Absent, or \`default\` on stack set, follows
+  the account setting.
   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
   review-unit park freeze (mg-park-*) so adopt does not retarget after open.
@@ -97,10 +104,51 @@ 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;
+}
+/** Short per-stack policy suffixes: Auto land when on, overrides when pinned. */
+export function stackPolicyLabels(s) {
+    const labels = [];
+    if (s.autoEnqueueWhenReady)
+        labels.push("auto-land on");
+    if (typeof s.autoReviewOverride === "boolean") {
+        labels.push(`auto-review ${s.autoReviewOverride ? "on" : "off"}`);
+    }
+    if (typeof s.autoPatchOverride === "boolean") {
+        labels.push(`auto-patch ${s.autoPatchOverride ? "on" : "off"}`);
+    }
+    return labels;
+}
 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}` +
+        stackPolicyLabels(s)
+            .map((label) => `  ${label}`)
+            .join(""));
     lines.push(`  ${ansi.dim(s.id)}`);
     if (s.layers.length === 0) {
         lines.push(ansi.dim("    (no layers)"));
@@ -113,12 +161,45 @@ function formatStackHuman(s) {
     }
     return lines;
 }
+const OPEN_POLICY_FLAGS = [
+    { flag: "--auto-land", key: "autoLand" },
+    { flag: "--auto-review", key: "autoReview" },
+    { flag: "--auto-patch", key: "autoPatch" },
+];
+/**
+ * Consume one `--auto-* on|off` flag at `args[i]` (space or `=` form). Returns
+ * the next index to scan, or null when `args[i]` is not a policy flag.
+ */
+function takeOpenPolicyFlag(args, i, into, verb) {
+    const a = args[i];
+    for (const { flag, key } of OPEN_POLICY_FLAGS) {
+        if (a === flag) {
+            into[key] = parseOnOff(args[i + 1], flag, verb);
+            return i + 2;
+        }
+        if (a.startsWith(`${flag}=`)) {
+            into[key] = parseOnOff(a.slice(flag.length + 1), flag, verb);
+            return i + 1;
+        }
+    }
+    return null;
+}
+/** Wire policy for adopt from the parsed `on|off` flags; absent keys stay off the body. */
+export function openPolicyPatch(flags) {
+    const patch = {
+        ...(typeof flags.autoLand === "boolean" ? { autoEnqueueWhenReady: flags.autoLand } : {}),
+        ...(typeof flags.autoReview === "boolean" ? { autoReviewOverride: flags.autoReview } : {}),
+        ...(typeof flags.autoPatch === "boolean" ? { autoPatchOverride: flags.autoPatch } : {}),
+    };
+    return Object.keys(patch).length > 0 ? patch : undefined;
+}
 /** Parse `stack create` argv into options. Exported for tests. */
 export function parseStackCreateArgs(args) {
     let name;
     let onto;
     let trunk;
     let extend = false;
+    const policy = {};
     let asJson = false;
     for (let i = 0; i < args.length; i++) {
         const a = args[i];
@@ -130,6 +211,11 @@ export function parseStackCreateArgs(args) {
             extend = true;
             continue;
         }
+        const next = takeOpenPolicyFlag(args, i, policy, "stack create");
+        if (next !== null) {
+            i = next - 1;
+            continue;
+        }
         if (a === "--onto") {
             const v = args[++i];
             if (!v) {
@@ -162,13 +248,24 @@ export function parseStackCreateArgs(args) {
         }
         name = a;
     }
-    return { name, onto, trunk, extend, asJson };
+    return {
+        name,
+        onto,
+        trunk,
+        extend,
+        autoLand: policy.autoLand,
+        autoReview: policy.autoReview,
+        autoPatch: policy.autoPatch,
+        asJson,
+    };
 }
 /** Parse `stack submit` argv. Exported for tests. */
 export function parseStackSubmitArgs(args) {
     let extend = false;
+    const policy = {};
     let asJson = false;
-    for (const a of args) {
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
         if (a === "--json") {
             asJson = true;
             continue;
@@ -177,43 +274,159 @@ export function parseStackSubmitArgs(args) {
             extend = true;
             continue;
         }
-        throw new CommandError("usage: mergestorm stack submit [--extend] [--json]");
+        const next = takeOpenPolicyFlag(args, i, policy, "stack submit");
+        if (next !== null) {
+            i = next - 1;
+            continue;
+        }
+        throw new CommandError("usage: mergestorm stack submit [--extend] [--auto-land on|off] [--auto-review on|off] [--auto-patch on|off] [--json]");
+    }
+    return {
+        extend,
+        autoLand: policy.autoLand,
+        autoReview: policy.autoReview,
+        autoPatch: policy.autoPatch,
+        asJson,
+    };
+}
+function parseOnOff(raw, flag, verb) {
+    if (raw === "on")
+        return true;
+    if (raw === "off")
+        return false;
+    throw new CommandError(`usage: mergestorm ${verb} [${flag} on|off]`);
+}
+/** `stack set` overrides are tri-state: `default` writes null (follow the account flag). */
+function parseOnOffDefault(raw, flag, verb) {
+    if (raw === "on")
+        return true;
+    if (raw === "off")
+        return false;
+    if (raw === "default")
+        return null;
+    throw new CommandError(`usage: mergestorm ${verb} [${flag} on|off|default]`);
+}
+export function parseStackAdoptArgs(args) {
+    const targetArgs = [];
+    const policy = {};
+    let asJson = false;
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "--json") {
+            asJson = true;
+            continue;
+        }
+        const next = takeOpenPolicyFlag(args, i, policy, "stack adopt <owner/repo>#<pr>");
+        if (next !== null) {
+            i = next - 1;
+            continue;
+        }
+        if (a.startsWith("-")) {
+            throw new CommandError(`${STACK_USAGE}\nunknown flag: ${a}`);
+        }
+        targetArgs.push(a);
+    }
+    const target = parseAdoptTarget(targetArgs);
+    return {
+        ...target,
+        autoLand: policy.autoLand,
+        autoReview: policy.autoReview,
+        autoPatch: policy.autoPatch,
+        asJson,
+    };
+}
+export function parseStackSetArgs(args) {
+    const usage = "usage: mergestorm stack set <stack-id> [--auto-land on|off] [--auto-review on|off|default] [--auto-patch on|off|default] [--json]";
+    const verb = "stack set <stack-id>";
+    let stackId;
+    let autoLand;
+    let autoReview;
+    let autoPatch;
+    let asJson = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--json") {
+            asJson = true;
+        }
+        else if (arg === "--auto-land") {
+            autoLand = parseOnOff(args[++i], "--auto-land", verb);
+        }
+        else if (arg.startsWith("--auto-land=")) {
+            autoLand = parseOnOff(arg.slice("--auto-land=".length), "--auto-land", verb);
+        }
+        else if (arg === "--auto-review") {
+            autoReview = parseOnOffDefault(args[++i], "--auto-review", verb);
+        }
+        else if (arg.startsWith("--auto-review=")) {
+            autoReview = parseOnOffDefault(arg.slice("--auto-review=".length), "--auto-review", verb);
+        }
+        else if (arg === "--auto-patch") {
+            autoPatch = parseOnOffDefault(args[++i], "--auto-patch", verb);
+        }
+        else if (arg.startsWith("--auto-patch=")) {
+            autoPatch = parseOnOffDefault(arg.slice("--auto-patch=".length), "--auto-patch", verb);
+        }
+        else if (arg.startsWith("-") || stackId !== undefined) {
+            throw new CommandError(usage);
+        }
+        else {
+            stackId = arg;
+        }
+    }
+    if (autoLand === undefined && autoReview === undefined && autoPatch === undefined) {
+        throw new CommandError(usage);
     }
-    return { extend, asJson };
+    return {
+        stackId: requireStackId(stackId, usage),
+        ...(autoLand !== undefined ? { autoLand } : {}),
+        ...(autoReview !== undefined ? { autoReview } : {}),
+        ...(autoPatch !== undefined ? { autoPatch } : {}),
+        asJson,
+    };
 }
 export function parseStackResetArgs(args) {
     if (args.length !== 1 || args[0] !== "--force") {
         throw new CommandError("usage: mergestorm stack reset --force\nClears only CLI-managed pre-submit state; branches, PRs, and registered stacks are unchanged.");
     }
 }
-async function cmdStackCreate(args, deps = {}) {
-    const { name, onto, trunk: trunkFlag, extend, asJson } = parseStackCreateArgs(args);
+export async function cmdStackCreate(args, deps = {}) {
+    const { name, onto, trunk: trunkFlag, extend, autoLand, autoReview, autoPatch, asJson, } = parseStackCreateArgs(args);
     const cwd = deps.cwd ?? process.cwd();
+    const gitTopLevelFn = deps.gitTopLevel ?? gitTopLevel;
+    const worktreeDirtyFn = deps.worktreeDirty ?? worktreeDirty;
+    const currentBranchFn = deps.currentBranch ?? currentBranch;
+    const branchExistsFn = deps.branchExists ?? branchExists;
+    const createBranchFromHeadFn = deps.createBranchFromHead ?? createBranchFromHead;
+    const deleteBranchFn = deps.deleteBranch ?? deleteBranch;
+    const discoverTrunkFn = deps.discoverTrunk ?? discoverTrunk;
+    const defaultLayerBranchNameFn = deps.defaultLayerBranchName ?? defaultLayerBranchName;
+    const loadStackMetaFn = deps.loadStackMeta ?? loadStackMeta;
+    const saveStackMetaFn = deps.saveStackMeta ?? saveStackMeta;
     const listStacksFn = deps.listStacks ?? listStacks;
     const loadConfigFn = deps.loadConfig ?? loadConfig;
     const parseOriginFn = deps.parseGithubOriginRepo ?? parseGithubOriginRepo;
     try {
-        gitTopLevel(cwd);
+        gitTopLevelFn(cwd);
     }
     catch {
         throw new CommandError("Not in a git repository. Run `mg stack create` from inside the repository whose stack you want to author.");
     }
-    if (worktreeDirty(cwd)) {
+    if (worktreeDirtyFn(cwd)) {
         throw new CommandError("Working tree is dirty. Commit or stash changes before `stack create`.");
     }
-    const parentBranch = onto?.trim() || currentBranch(cwd);
+    const parentBranch = onto?.trim() || currentBranchFn(cwd);
     if (!parentBranch) {
         throw new CommandError("Detached HEAD. Check out a branch (or pass --onto <branch>) before `stack create`.");
     }
-    if (!branchExists(parentBranch, cwd)) {
+    if (!branchExistsFn(parentBranch, cwd)) {
         throw new CommandError(`Parent branch not found: ${parentBranch}`);
     }
-    const branch = defaultLayerBranchName(name);
-    if (branchExists(branch, cwd)) {
+    const branch = defaultLayerBranchNameFn(name);
+    if (branchExistsFn(branch, cwd)) {
         throw new CommandError(`Branch already exists: ${branch}`);
     }
-    let meta = await loadStackMeta(cwd);
-    const trunk = trunkFlag?.trim() || meta?.trunk || discoverTrunk(cwd);
+    let meta = await loadStackMetaFn(cwd);
+    const trunk = trunkFlag?.trim() || meta?.trunk || discoverTrunkFn(cwd);
     if (!meta) {
         meta = emptyStackMeta(trunk);
     }
@@ -253,23 +466,28 @@ async function cmdStackCreate(args, deps = {}) {
     }
     try {
         meta = selectStackForCreate(meta, parentBranch);
+        meta = setActivePolicy(meta, {
+            autoEnqueueWhenReady: autoLand,
+            autoReviewOverride: autoReview,
+            autoPatchOverride: autoPatch,
+        });
     }
     catch (err) {
         throw new CommandError(err instanceof Error ? err.message : String(err));
     }
     try {
-        createBranchFromHead(branch, cwd);
+        createBranchFromHeadFn(branch, cwd);
     }
     catch (err) {
         throw new CommandError(err instanceof Error ? err.message : String(err));
     }
     try {
         meta = appendLayer(meta, { branch, parentBranch });
-        await saveStackMeta(meta, cwd);
+        await saveStackMetaFn(meta, cwd);
     }
     catch (err) {
         try {
-            deleteBranch(branch, cwd);
+            deleteBranchFn(branch, cwd);
         }
         catch { /* rollback best-effort */ }
         throw new CommandError(err instanceof Error ? err.message : String(err));
@@ -288,16 +506,19 @@ 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);
+    const { extend, autoLand, autoReview, autoPatch, asJson } = parseStackSubmitArgs(args);
     const cwd = deps.cwd ?? process.cwd();
     const gitTopLevelFn = deps.gitTopLevel ?? gitTopLevel;
     const loadStackMetaFn = deps.loadStackMeta ?? loadStackMeta;
@@ -368,6 +589,21 @@ export async function cmdStackSubmit(args, deps = {}) {
         owner,
         repo,
     });
+    // Explicit submit flags win; otherwise a fresh (unregistered) stack carries
+    // the choices remembered at `stack create`. Joining a registered stack
+    // never replays stored create-time flags onto it.
+    const stored = meta.stacks[meta.active];
+    const freshStack = plans.every((plan) => plan.stackId === null);
+    const pick = (flag, remembered) => typeof flag === "boolean"
+        ? flag
+        : freshStack && typeof remembered === "boolean"
+            ? remembered
+            : undefined;
+    const policy = openPolicyPatch({
+        autoLand: pick(autoLand, stored?.autoEnqueueWhenReady),
+        autoReview: pick(autoReview, stored?.autoReviewOverride),
+        autoPatch: pick(autoPatch, stored?.autoPatchOverride),
+    });
     for (const layer of layers) {
         if (!branchExistsFn(layer.branch, cwd)) {
             throw new CommandError(`Stack layer branch missing locally: ${layer.branch}`);
@@ -444,7 +680,7 @@ export async function cmdStackSubmit(args, deps = {}) {
     let stackId = plans.find((plan) => plan.stackId)?.stackId ?? null;
     const registerPr = async (prNumber) => {
         console.log(ansi.dim(`  Registering stack via import (${owner}/${repo}#${prNumber}) …`));
-        const body = await adoptStackFn(owner, repo, prNumber, cfg);
+        const body = await adoptStackFn(owner, repo, prNumber, cfg, policy);
         if (typeof body !== "object" || body === null) {
             throw new CommandError("Unexpected response shape from adopt API");
         }
@@ -495,22 +731,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,28 +760,60 @@ 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");
-    const targetArgs = args.filter((a) => a !== "--json");
-    if (targetArgs.length === 0) {
-        throw new CommandError(`usage: mergestorm stack adopt <owner/repo>#<pr>`);
+/** Human summary lines for a `stack set` write, one per flag. */
+export function stackSetSummary(parsed) {
+    const tri = (value) => value === null ? "default (account setting)" : value ? "on" : "off";
+    const lines = [];
+    if (parsed.autoLand !== undefined) {
+        lines.push(`Auto land ${parsed.autoLand ? "on" : "off"}`);
     }
-    const { owner, repo, prNumber } = parseAdoptTarget(targetArgs);
+    if (parsed.autoReview !== undefined) {
+        lines.push(`Auto-review ${tri(parsed.autoReview)}`);
+    }
+    if (parsed.autoPatch !== undefined) {
+        lines.push(`Auto-patch ${tri(parsed.autoPatch)}`);
+    }
+    return lines;
+}
+export async function cmdStackSet(args, deps = {}) {
+    const parsed = parseStackSetArgs(args);
+    const cfg = await (deps.loadConfig ?? loadConfig)();
+    const body = await (deps.setStackPolicy ?? setStackPolicy)(parsed.stackId, {
+        ...(parsed.autoLand !== undefined ? { autoEnqueueWhenReady: parsed.autoLand } : {}),
+        ...(parsed.autoReview !== undefined ? { autoReviewOverride: parsed.autoReview } : {}),
+        ...(parsed.autoPatch !== undefined ? { autoPatchOverride: parsed.autoPatch } : {}),
+    }, cfg);
+    if (parsed.asJson) {
+        console.log(JSON.stringify(body, null, 2));
+        return;
+    }
+    await present("Stack", stackSetSummary(parsed).map((line) => ansi.brightGreen(`  ${line} for ${parsed.stackId}`)));
+}
+async function cmdStackAdopt(args) {
+    const { owner, repo, prNumber, autoLand, autoReview, autoPatch, asJson } = parseStackAdoptArgs(args);
     const cfg = await loadConfig();
-    const body = await adoptStack(owner, repo, prNumber, cfg);
+    const body = await adoptStack(owner, repo, prNumber, cfg, openPolicyPatch({ autoLand, autoReview, autoPatch }));
     if (asJson) {
         console.log(JSON.stringify(body, null, 2));
         return;
@@ -552,13 +824,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 +845,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 +863,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;
     }
@@ -630,17 +899,13 @@ export async function cmdStack(args) {
         return cmdStackReset(rest);
     if (sub === "list" || sub === "ls")
         return cmdStackList(rest);
+    if (sub === "set")
+        return cmdStackSet(rest);
     if (sub === "adopt")
         return cmdStackAdopt(rest);
     if (sub === "restack")
         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";