mergestorm 0.3.55 → 0.3.57

package/README.md

@@ -45,12 +45,12 @@ On a TTY, bare `mergestorm` (or `mergestorm shell`) opens a branded REPL: a comp
 
 ```
 ╭──────────────────────────────────────────────────────────────────────────────╮
-│  ▀▀▀▀▀▀▀▀▀▀▘  mergestorm v0.3.55                                             │
+│  ▀▀▀▀▀▀▀▀▀▀▘  mergestorm v0.3.57                                             │
 │ ▀▀▀▀▀▀▀▀▀     ● msk_live_… · maelstrom                                       │
 │  ▀▀▀▀▀▀       [████████░░░░░░░░░░░░░░░░░░░░░░] 25% used                      │
 │   ▝▀▀▀▀▀      local reviews + stacked PRs · mergestorm.ai                    │
 │     ▝▀▀▘      review a diff · usage for tabs · /help for all commands        │
-│       ▀       New in v0.3.55: MERGESTORM_HOME moves login and stack state    │
+│       ▀       New in v0.3.57: issue create --help shows the usage            │
 ╰──────────────────────────────────────────────────────────────────────────────╯
 mergestorm
 ╭──────────────────────────────────────────────────────────────────────────────╮

package/dist/api.d.ts

@@ -175,6 +175,19 @@ export type SettingsResponse = import("./automation-catalog.js").BearerSettingsV
     github_connected: boolean;
     stacks_ready?: boolean;
 };
+export declare const REPO_SETTINGS_KEYS: readonly ["auto_patch_enabled", "auto_review_enabled", "auto_land_default"];
+export type RepoSettingsKey = (typeof REPO_SETTINGS_KEYS)[number];
+export type RepoSettings = {
+    owner: string;
+    repo: string;
+} & Record<RepoSettingsKey, boolean | null>;
+export type RepoSettingsPatch = Partial<Record<RepoSettingsKey, boolean | null>>;
+export declare function listRepoSettings(cfg?: Config, opts?: {
+    timeoutMs?: number;
+}): Promise<RepoSettings[]>;
+export declare function patchRepoSettings(owner: string, repo: string, patch: RepoSettingsPatch, cfg?: Config, opts?: {
+    timeoutMs?: number;
+}): Promise<RepoSettings>;
 /**
  * Fetch Bearer /api/v1/settings; null on 404/network/timeouts so panels can
  * degrade (same contract as {@link getMe}), while 401 still surfaces.

package/dist/api.js

@@ -172,6 +172,44 @@ export function applyPrReviewQuery(query, opts) {
  * The connected flags are read-only there and deliberately absent here.
  */
 export { SETTINGS_WRITABLE_KEYS };
+export const REPO_SETTINGS_KEYS = ["auto_patch_enabled", "auto_review_enabled", "auto_land_default"];
+function repoSettingsFailure(status, body, retryAfterSeconds, action) {
+    if (status === 429) {
+        return new CommandError(rateLimitedMessage(retryAfterSeconds), REVIEW_EXIT.rate_limited, "rate_limited", {
+            retryAfterSeconds,
+        });
+    }
+    const message = body?.message;
+    if (typeof message === "string" && message.trim())
+        return new CommandError(message);
+    if (status === 404) {
+        return new CommandError("Repository settings are not available on this server yet. Deploy the API update or use the dashboard.");
+    }
+    return new CommandError(`Failed to ${action} repository settings (HTTP ${status}): ${JSON.stringify(body)}`);
+}
+export async function listRepoSettings(cfg, opts) {
+    const resolved = cfg ?? (await loadConfig());
+    const { status, body, retryAfterSeconds } = await apiFetch(resolved, "/api/v1/settings/repos", {
+        timeoutMs: opts?.timeoutMs,
+    });
+    if (status !== 200)
+        throw repoSettingsFailure(status, body, retryAfterSeconds, "load");
+    const repos = body?.repos;
+    if (!Array.isArray(repos)) {
+        throw new CommandError(`Repository settings came back in an unexpected shape: ${JSON.stringify(body)}`);
+    }
+    return repos;
+}
+export async function patchRepoSettings(owner, repo, patch, cfg, opts) {
+    const resolved = cfg ?? (await loadConfig());
+    if (Object.keys(patch).length === 0) {
+        throw new CommandError("No repository settings to update.", 2, "usage");
+    }
+    const { status, body, retryAfterSeconds } = await apiFetch(resolved, `/api/v1/settings/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}`, { method: "PATCH", json: patch, timeoutMs: opts?.timeoutMs });
+    if (status !== 200)
+        throw repoSettingsFailure(status, body, retryAfterSeconds, "update");
+    return body;
+}
 /**
  * Fetch Bearer /api/v1/settings; null on 404/network/timeouts so panels can
  * degrade (same contract as {@link getMe}), while 401 still surfaces.

package/dist/client/index.d.ts

@@ -1,6 +1,6 @@
 export { DEFAULT_API, apiBase, clearConfig, configPath, keyDisplay, loadConfig, mergestormHome, resolveApiKey, saveConfig, type Config, } from "../config.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, dismissPrFindings, enqueueStack, ensureUpperPark, getEnrichedStack, getMe, getPrVortexReview, getReview, getSettings, getStackPublication, landNextStack, listJobs, listMergeQueueEntries, listStacks, listThreads, openStackIssue, parseRetryAfterSeconds, patchSettings, restackStack, setStackAutoLand, setStackPolicy, stackPolicyBody, submitStackPublication, type ApiFetchInit, type ApiFetchResult, type JobListItem, type MeResponse, type MergeQueueBounceDetail, type MergeQueueBounceKind, type MergeQueueEnqueuedBy, type MergeQueueEnqueuedVia, type MergeQueueEntryDto, type MergeQueueEntryState, type PrDismissedFinding, type PrFindingDismissInput, type PrFindingDismissOutcome, type PrFindingDismissResult, type PrReviewFinding, type PrReviewFindings, type PrVortexReview, type SettingsPatch, type SettingsResponse, type SettingsWritableKey, type StackDto, type StackPolicyPatch, type StackPublication, type StackPublicationRequest, type StackPublicationStatus, type ThreadDetail, type ThreadListItem, } from "../api.js";
+export { API_TIMEOUT_PREFIX, DEFAULT_API_TIMEOUT_MS, SETTINGS_WRITABLE_KEYS, adoptStack, apiFetch, cancelMergeQueueEntry, devicePost, dismissPrFindings, enqueueStack, ensureUpperPark, getEnrichedStack, getMe, getPrVortexReview, getReview, getSettings, listRepoSettings, patchRepoSettings, REPO_SETTINGS_KEYS, getStackPublication, landNextStack, listJobs, listMergeQueueEntries, listStacks, listThreads, openStackIssue, parseRetryAfterSeconds, patchSettings, restackStack, setStackAutoLand, setStackPolicy, stackPolicyBody, submitStackPublication, type ApiFetchInit, type ApiFetchResult, type JobListItem, type MeResponse, type MergeQueueBounceDetail, type MergeQueueBounceKind, type MergeQueueEnqueuedBy, type MergeQueueEnqueuedVia, type MergeQueueEntryDto, type MergeQueueEntryState, type PrDismissedFinding, type PrFindingDismissInput, type PrFindingDismissOutcome, type PrFindingDismissResult, type PrReviewFinding, type PrReviewFindings, type PrVortexReview, type SettingsPatch, type RepoSettings, type RepoSettingsKey, type RepoSettingsPatch, type SettingsResponse, type SettingsWritableKey, type StackDto, type StackPolicyPatch, type StackPublication, type StackPublicationRequest, type StackPublicationStatus, 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, noPrReviewYetMessage, 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";

package/dist/client/index.js

@@ -1,6 +1,6 @@
 export { DEFAULT_API, apiBase, clearConfig, configPath, keyDisplay, loadConfig, mergestormHome, resolveApiKey, saveConfig, } from "../config.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, dismissPrFindings, enqueueStack, ensureUpperPark, getEnrichedStack, getMe, getPrVortexReview, getReview, getSettings, getStackPublication, landNextStack, listJobs, listMergeQueueEntries, listStacks, listThreads, openStackIssue, parseRetryAfterSeconds, patchSettings, restackStack, setStackAutoLand, setStackPolicy, stackPolicyBody, submitStackPublication, } from "../api.js";
+export { API_TIMEOUT_PREFIX, DEFAULT_API_TIMEOUT_MS, SETTINGS_WRITABLE_KEYS, adoptStack, apiFetch, cancelMergeQueueEntry, devicePost, dismissPrFindings, enqueueStack, ensureUpperPark, getEnrichedStack, getMe, getPrVortexReview, getReview, getSettings, listRepoSettings, patchRepoSettings, REPO_SETTINGS_KEYS, getStackPublication, landNextStack, listJobs, listMergeQueueEntries, listStacks, listThreads, openStackIssue, parseRetryAfterSeconds, patchSettings, restackStack, setStackAutoLand, setStackPolicy, stackPolicyBody, submitStackPublication, } 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, noPrReviewYetMessage, 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";

package/dist/commands/issue.js

@@ -9,6 +9,7 @@ export const ISSUE_USAGE = [
     "  Opens a GitHub issue through Mergestorm as the Surge App. Needs no gh and no GitHub login.",
     "  Uses existing labels only. Running it again with the same title returns the open issue it already made when that issue is among the newest 100 open issues; an older one, or two calls at once, can still create a duplicate.",
 ].join("\n");
+const VALUE_FLAGS = new Set(["--title", "--body", "--body-file", "--label", "--repo"]);
 function usage(message) {
     return new CommandError(message ? `${message}\n${ISSUE_USAGE}` : ISSUE_USAGE, REVIEW_EXIT.usage, "usage");
 }
@@ -65,7 +66,18 @@ export function parseIssueCreateArgs(args, readBody = (path) => readFileSync(pat
 }
 export async function cmdIssue(args, deps = {}) {
     const sub = args[0]?.toLowerCase();
-    if (!sub || sub === "-h" || sub === "--help" || sub === "help") {
+    const asksForHelp = (arg) => arg === "-h" || arg === "--help" || arg === "help";
+    const createAsksForHelp = (rest) => {
+        for (let i = 0; i < rest.length; i++) {
+            const arg = rest[i];
+            if (asksForHelp(arg))
+                return true;
+            if (VALUE_FLAGS.has(arg))
+                i++;
+        }
+        return false;
+    };
+    if (!sub || asksForHelp(sub) || (sub === "create" && createAsksForHelp(args.slice(1)))) {
         console.log(ISSUE_USAGE);
         return;
     }

package/dist/commands/registry.js

@@ -208,6 +208,10 @@ export const COMMAND_REGISTRY = [
             "  [--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",
+            "mergestorm settings --repos [--json]    Repository-level Auto patch, Auto review and Auto land for every connected repository",
+            "mergestorm settings --repo <owner>/<repo> [--auto-patch on|off|inherit] [--auto-review on|off|inherit] [--auto-land on|off|inherit] [--json]",
+            "  A repository value beats the account setting; a stack override (mergestorm stack set) beats the repository.",
+            "  inherit clears the repository value so the account setting applies. --auto-land seeds new stacks only.",
         ],
         async run(args, ctx) {
             await cmdSettings(args, { mode: ctx.mode });

package/dist/commands/settings.d.ts

@@ -1,4 +1,4 @@
-import { type SettingsPatch, type SettingsResponse } from "../api.js";
+import { type RepoSettings, type RepoSettingsPatch, type SettingsPatch, type SettingsResponse } from "../api.js";
 /**
  * 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.
@@ -10,13 +10,21 @@ type IgnoreBotOperation = {
 } | {
     action: "clear";
 };
+export type RepoSettingsScope = {
+    owner: string;
+    repo: string;
+    patch: RepoSettingsPatch;
+};
 export type SettingsArgs = {
     json: boolean;
     patch: SettingsPatch;
     ignoreBots?: IgnoreBotOperation[];
+    repo?: RepoSettingsScope;
+    listRepos?: boolean;
 };
+export declare function formatRepoSettingsLines(repos: readonly RepoSettings[]): string[];
 /** Parse boolean and enum flags plus ordered ignore-list operations. */
-export declare function parseSettingsArgs(args: string[]): SettingsArgs;
+export declare function parseSettingsArgs(rawArgs: string[]): SettingsArgs;
 /** 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?: {

package/dist/commands/settings.js

@@ -1,4 +1,4 @@
-import { getSettings, patchSettings, } from "../api.js";
+import { getSettings, listRepoSettings, patchRepoSettings, patchSettings, REPO_SETTINGS_KEYS, } from "../api.js";
 import { BEARER_SETTINGS, BEARER_SETTINGS_FLAGS } from "../automation-catalog.js";
 import { loadConfig } from "../config.js";
 import { CommandError } from "../errors.js";
@@ -10,6 +10,107 @@ import { buildConfigRows, canBrowse, openTabsBrowser } from "./browse.js";
  * read-only on the API and deliberately have no flag here.
  */
 export const SETTINGS_FLAGS = BEARER_SETTINGS_FLAGS;
+const REPO_FLAG_LABELS = {
+    auto_patch_enabled: "Auto patch",
+    auto_review_enabled: "Auto review",
+    auto_land_default: "Auto land (new stacks)",
+};
+function parseRepoSlug(raw) {
+    const match = /^([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)$/.exec(raw ?? "");
+    if (!match)
+        throw new CommandError("--repo takes <owner>/<repo>.", 2, "usage");
+    return { owner: match[1], repo: match[2] };
+}
+function repoArg(args) {
+    const rest = [];
+    let slug;
+    let found = false;
+    let listRepos = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--repos")
+            listRepos = true;
+        else if (arg === "--repo") {
+            found = true;
+            slug = args[++i];
+        }
+        else if (arg.startsWith("--repo=")) {
+            found = true;
+            slug = arg.slice("--repo=".length);
+        }
+        else
+            rest.push(arg);
+    }
+    if (found && slug === undefined)
+        slug = "";
+    return { slug, rest, listRepos };
+}
+function parseRepoSettingsArgs(slug, args) {
+    const scope = { ...parseRepoSlug(slug), patch: {} };
+    let json = false;
+    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");
+        }
+        if (!REPO_SETTINGS_KEYS.includes(key)) {
+            throw new CommandError(`${flag} is an account setting. With --repo only --auto-patch, --auto-review and --auto-land can be set.`, 2, "usage");
+        }
+        const value = eq >= 0 ? arg.slice(eq + 1) : args[++i];
+        if (value !== "on" && value !== "off" && value !== "inherit") {
+            throw new CommandError(`${flag} takes on, off or inherit with --repo.`, 2, "usage");
+        }
+        scope.patch[key] = value === "inherit" ? null : value === "on";
+    }
+    return { json, patch: {}, repo: scope };
+}
+function repoSettingWords(value) {
+    return value === null ? "inherit (follows the account)" : value ? "on" : "off";
+}
+export function formatRepoSettingsLines(repos) {
+    if (repos.length === 0)
+        return ["  No repositories are connected to this account."];
+    const width = Math.max(...Object.values(REPO_FLAG_LABELS).map((label) => label.length));
+    return repos.flatMap((entry) => [
+        `  ${entry.owner}/${entry.repo}`,
+        ...REPO_SETTINGS_KEYS.map((key) => `    ${REPO_FLAG_LABELS[key].padEnd(width + 2)}${repoSettingWords(entry[key])}`),
+    ]);
+}
+async function cmdRepoSettings(parsed, opts) {
+    const cfg = await loadConfig();
+    let repos;
+    const scope = parsed.repo;
+    if (scope && Object.keys(scope.patch).length > 0) {
+        repos = [await patchRepoSettings(scope.owner, scope.repo, scope.patch, cfg)];
+    }
+    else {
+        repos = await listRepoSettings(cfg);
+        if (scope) {
+            const wanted = `${scope.owner}/${scope.repo}`.toLowerCase();
+            repos = repos.filter((entry) => `${entry.owner}/${entry.repo}`.toLowerCase() === wanted);
+            if (repos.length === 0) {
+                throw new CommandError(`${scope.owner}/${scope.repo} is not connected to this account.`);
+            }
+        }
+    }
+    if (parsed.json) {
+        const text = JSON.stringify(scope ? repos[0] : { repos }, null, 2);
+        if (opts.mode === "shell") {
+            await present("Repository settings", text.split("\n"));
+            return;
+        }
+        console.log(text);
+        return;
+    }
+    await present("Repository settings", formatRepoSettingsLines(repos));
+}
 function canonicalLogin(raw) {
     const login = raw.trim().toLowerCase().replace(/\[bot\]$/, "");
     if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(login)) {
@@ -18,7 +119,19 @@ function canonicalLogin(raw) {
     return login;
 }
 /** Parse boolean and enum flags plus ordered ignore-list operations. */
-export function parseSettingsArgs(args) {
+export function parseSettingsArgs(rawArgs) {
+    const { slug, rest: args, listRepos } = repoArg(rawArgs);
+    if (slug !== undefined) {
+        if (listRepos)
+            throw new CommandError("--repos and --repo cannot be combined.", 2, "usage");
+        return parseRepoSettingsArgs(slug, args);
+    }
+    if (listRepos) {
+        const other = args.find((arg) => arg !== "--json");
+        if (other)
+            throw new CommandError(`--repos lists repository settings and takes only --json, not ${other}.`, 2, "usage");
+        return { json: args.includes("--json"), patch: {}, listRepos: true };
+    }
     let json = false;
     const ignoreBots = [];
     const patch = {};
@@ -97,7 +210,12 @@ export function formatSettingsLines(settings) {
     });
 }
 export async function cmdSettings(args, opts = {}) {
-    const { json, patch, ignoreBots } = parseSettingsArgs(args);
+    const parsed = parseSettingsArgs(args);
+    if (parsed.repo || parsed.listRepos) {
+        await cmdRepoSettings(parsed, opts);
+        return;
+    }
+    const { json, patch, ignoreBots } = parsed;
     const hasPatch = Object.keys(patch).length > 0 || Boolean(ignoreBots?.length);
     // Bare `settings` on a TTY: the tabbed browser, opened on Config.
     if (!hasPatch && !json && canBrowse()) {

package/dist/stack-blockers.js

@@ -81,6 +81,8 @@ const CYCLONE_HANDOFF_WORDS = {
     failed: "Cyclone's patch failed, so it pushed nothing",
     auto_patch_off: "auto-patch is off for this stack",
     stack_auto_patch_off: "auto-patch is off for this stack",
+    repo_auto_patch_off: "auto-patch is off for this repository and this stack does not turn it on",
+    repo_setting_unavailable: "the repository's auto-patch setting could not be read, so Cyclone will not patch until it can",
     account_auto_patch_off: "auto-patch is off for the account and this stack does not turn it on",
     cyclone_not_connected: "Cyclone is not connected to this repo",
     infra_failure: "Cyclone could not start the patch: GitHub sign-in, comment load or checkout kept failing",
@@ -220,7 +222,22 @@ function vortexSkippedSteps(stack, layer, skipReason) {
     const head = layer.headSha ?? "its live head";
     const mention = `comment @mergestorm-vortex review on #${layer.prNumber}`;
     if (skipReason === "auto_review_off") {
-        return `Vortex auto-review is off for ${stack.owner}/${stack.repo} or for this stack, so it skipped #${layer.prNumber} at ${head} and Auto land waits for a review that will not come. Do not patch or push for this. Tell the human: turning auto-review on (mg stack set ${stack.id} --auto-review on, or the account setting in the dashboard) queues a review of this head by itself. To review only this head and leave auto-review off, ${mention}.`;
+        const slug = `${stack.owner}/${stack.repo}`;
+        const where = stack.vortexReviewOff === "stack_auto_review_off"
+            ? "for this stack"
+            : stack.vortexReviewOff === "repo_auto_review_off"
+                ? `for the repository ${slug}`
+                : stack.vortexReviewOff === "account_auto_review_off"
+                    ? "for the account"
+                    : `for ${slug} or for this stack`;
+        const lead = `Vortex auto-review is off ${where}, so it skipped #${layer.prNumber} at ${head} and Auto land waits for a review that will not come. Do not patch or push for this.`;
+        if (stack.vortexReviewOff === "repo_auto_review_off") {
+            return `${lead} Tell the human: turning auto-review on for this stack only (mg stack set ${stack.id} --auto-review on) queues a review of this head by itself. Turning it on for the repository (mg settings --repo ${slug} --auto-review on) applies from the next push and queues nothing, so this head still needs a mention. To review only this head and leave auto-review off, ${mention}.`;
+        }
+        const sinceTurnedOn = stack.vortexReviewOff
+            ? ""
+            : ` If auto-review has been turned back on since this head was pushed, the skip is from before that and nothing re-queues it: ${mention}.`;
+        return `${lead} Tell the human: turning auto-review on (mg stack set ${stack.id} --auto-review on, or the account setting in the dashboard) queues a review of this head by itself. To review only this head and leave auto-review off, ${mention}.${sinceTurnedOn}`;
     }
     if (skipReason === "ignored_author") {
         return `Vortex skipped #${layer.prNumber} at ${head} because the PR's author is on the account's ignored authors list, so Auto land waits for a review that will not come. Do not patch or push for this. To review this head once, ${mention}. To have this author's PRs reviewed by themselves, tell the human to remove the author from the ignored authors list in the Mergestorm dashboard settings.`;

package/dist/stack-dto.d.ts

@@ -313,7 +313,8 @@ export type StackUnitDto = {
     landPr: StackLayerDto | null;
 };
 export type CycloneOwnerMatch = "same" | "different" | "none" | "lookup_failed";
-export type CyclonePatchOffReason = "stack_auto_patch_off" | "account_auto_patch_off" | "cyclone_not_connected";
+export type CyclonePatchOffReason = "stack_auto_patch_off" | "repo_auto_patch_off" | "repo_setting_unavailable" | "account_auto_patch_off" | "cyclone_not_connected";
+export type VortexReviewOffReason = "stack_auto_review_off" | "repo_auto_review_off" | "account_auto_review_off";
 export type CycloneConflictOffReason = "stack_auto_resolve_off" | "account_auto_resolve_off" | "cyclone_not_connected";
 export type CycloneCiOffReason = "stack_auto_fix_ci_off" | "account_auto_fix_ci_off" | "cyclone_not_connected";
 export type StackDto = {
@@ -364,12 +365,14 @@ export type StackDto = {
     } | null;
     /**
      * Per-stack Vortex auto-review override. `null` (or missing) follows the
-     * account `auto_review_enabled` flag; a boolean wins in both directions.
+     * repository setting and then the account `auto_review_enabled` flag; a
+     * boolean wins in both directions.
      */
     autoReviewOverride?: boolean | null;
     /**
      * Per-stack Cyclone auto-patch override. `null` (or missing) follows the
-     * account `auto_patch_enabled` flag; a boolean wins in both directions.
+     * repository setting and then the account `auto_patch_enabled` flag; a
+     * boolean wins in both directions.
      */
     autoPatchOverride?: boolean | null;
     autoResolveConflictsOverride?: boolean | null;
@@ -395,6 +398,11 @@ export type StackDto = {
      */
     cycloneOwnerMatch?: CycloneOwnerMatch;
     cyclonePatchOff?: CyclonePatchOffReason;
+    /**
+     * Which level turned Auto review off for this stack: its own override, the
+     * repository setting, or the account. Absent while Auto review is on.
+     */
+    vortexReviewOff?: VortexReviewOffReason;
     cycloneConflictOff?: CycloneConflictOffReason;
     cycloneCiOff?: CycloneCiOffReason;
     infrastructureInstallUserId?: string | null;

package/dist/ui/banner.js

@@ -203,6 +203,12 @@ const WHATS_NEW = {
     "0.3.55": [
         "MERGESTORM_HOME moves login and stack state",
     ],
+    "0.3.56": [
+        "Set automation per repository",
+    ],
+    "0.3.57": [
+        "issue create --help shows the usage",
+    ],
 };
 function densityFromVariant(variant) {
     if (variant === "mini" || variant === "nano")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mergestorm",
-  "version": "0.3.55",
+  "version": "0.3.57",
   "description": "Mergestorm CLI (mg) — local reviews & stacked PRs. MIT; build from source: https://github.com/marginsystems/mergestorm-cli",
   "license": "MIT",
   "type": "module",