mergestorm 0.3.54 → 0.3.56

package/README.md

@@ -45,12 +45,12 @@ On a TTY, bare `mergestorm` (or `mergestorm shell`) opens a branded REPL: a comp
 
 ```
 ╭──────────────────────────────────────────────────────────────────────────────╮
-│  ▀▀▀▀▀▀▀▀▀▀▘  mergestorm v0.3.54                                             │
+│  ▀▀▀▀▀▀▀▀▀▀▘  mergestorm v0.3.56                                             │
 │ ▀▀▀▀▀▀▀▀▀     ● 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.54: Publish without gh: stack submit --server-side │
+│       ▀       New in v0.3.56: Set automation per repository                  │
 ╰──────────────────────────────────────────────────────────────────────────────╯
 mergestorm
 ╭──────────────────────────────────────────────────────────────────────────────╮
@@ -164,13 +164,14 @@ mg stack publish --status               # absent | pushed | opened | registered
 - **Exact contents.** Every commit travels with its Git tree SHA and the whole content of each changed file, so binaries, deletions, renames, executable bits and symlinks arrive unchanged. Mergestorm moves the branch only when GitHub builds the same tree, and `mg` checks the returned tree against your local branch.
 - **Never overwrites surprises.** `mg` looks at the branch on GitHub first. If its files match one of your local commits, only the commits after that one are appended. If they match none (someone else pushed, or you rebased), `mg` stops with `head_changed`; `--replace-head <sha>` replaces exactly that head and nothing else. Mergestorm refuses `main`, `master`, the default branch, protected branches and its own `mg-stack-*`, `mg-park-*` and `mq-batch-*` branches.
 - **Safe to run again.** After a timeout or an error, run the same command again. It finds the branch, pull request and stack it already made and finishes the missing step; it does not create duplicates.
+- **Read-only home directory.** `mg` keeps the saved login and the local stack state of `stack create` / `stack submit` under `~/.mergestorm`. Where the home directory cannot be written, set `MERGESTORM_HOME` to a writable directory (outside the repository) and every command uses that instead. `MERGESTORM_API_KEY` supplies the key without `mg login`.
 - **Limits.** 20 commits, 500 changed paths, 2 MiB a file and 8 MiB in total per publication. Submodules and merge commits are refused with the path or the reason. `stack submit --server-side` publishes the first two layers of a stack; a third layer needs a park freeze, which this mode does not create, so add it once the first two are registered.
 
 Legacy repo-local `.mergestorm/stack.json` state migrates automatically on the next stack command. If local authoring state is stale or malformed, use `mg stack reset --force`; this clears only pre-submit CLI state and never deletes branches, PRs, or registered stacks.
 
 ### `login`
 
-Runs a browser device-authorization flow: prints a short code, opens `https://mergestorm.ai/cli/auth`, and — once you approve — mints and stores an API key in `~/.mergestorm/config.json` (mode `600`). No key copy/paste needed.
+Runs a browser device-authorization flow: prints a short code, opens `https://mergestorm.ai/cli/auth`, and — once you approve — mints and stores an API key in `~/.mergestorm/config.json` (mode `600`), or in `$MERGESTORM_HOME/config.json` when `MERGESTORM_HOME` is set. No key copy/paste needed.
 
 For headless or CI environments, use `mergestorm login --key` to paste an existing `msk_live_…` key (create one on the dashboard [Settings → API](https://mergestorm.ai/settings#api)). On a TTY the paste is hidden (not echoed); the CLI verifies the key with the API before saving.
 
@@ -178,7 +179,7 @@ For an agent, which cannot sit in a prompt while a person signs in, use two step
 
 ### `logout`
 
-Removes `~/.mergestorm/config.json` so the stored key is no longer used.
+Removes `~/.mergestorm/config.json` (or `$MERGESTORM_HOME/config.json` when `MERGESTORM_HOME` is set) so the stored key is no longer used.
 
 ### `review [base] [head]`
 
@@ -229,6 +230,7 @@ Require a logged-in key and API support for `GET /api/v1/me` and `GET /api/v1/re
 |----------|---------|---------|
 | `MERGESTORM_API_KEY` | API key (overrides the stored config) | — |
 | `MERGESTORM_API_URL` | API base URL | `https://api.mergestorm.ai` |
+| `MERGESTORM_HOME` | Directory for the saved login and local stack state, for machines whose home directory is read-only | `~/.mergestorm` |
 | `NO_COLOR` | Disable ANSI colors | — |
 
 ## Verify (public source vs npm)

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/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 });
@@ -331,6 +335,7 @@ export function formatUsageBody() {
 Env:
   MERGESTORM_API_KEY   API key (overrides config)
   MERGESTORM_API_URL   API base (default ${DEFAULT_API})
+  MERGESTORM_HOME      State directory for login and stack state (default ~/.mergestorm)
 `;
 }
 /**

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/config.d.ts

@@ -3,7 +3,7 @@ export type Config = {
     apiKey?: string;
     apiBase?: string;
 };
-export declare function mergestormHome(): string;
+export declare function mergestormHome(env?: NodeJS.ProcessEnv): string;
 export declare function configPath(): string;
 export declare function loadConfig(): Promise<Config>;
 export declare function saveConfig(cfg: Config): Promise<void>;

package/dist/config.js

@@ -2,8 +2,9 @@ import { mkdir, readFile, writeFile, rm } from "node:fs/promises";
 import { homedir } from "node:os";
 import path from "node:path";
 export const DEFAULT_API = "https://api.mergestorm.ai";
-export function mergestormHome() {
-    return path.join(homedir(), ".mergestorm");
+export function mergestormHome(env = process.env) {
+    const override = env.MERGESTORM_HOME?.trim();
+    return override ? path.resolve(override) : path.join(homedir(), ".mergestorm");
 }
 export function configPath() {
     return path.join(mergestormHome(), "config.json");

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

@@ -200,6 +200,12 @@ const WHATS_NEW = {
     "0.3.54": [
         "Publish without gh: stack submit --server-side",
     ],
+    "0.3.55": [
+        "MERGESTORM_HOME moves login and stack state",
+    ],
+    "0.3.56": [
+        "Set automation per repository",
+    ],
 };
 function densityFromVariant(variant) {
     if (variant === "mini" || variant === "nano")

package/package.json

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