mergestorm 0.3.18 → 0.3.20

package/dist/commands/skill.js

@@ -7,14 +7,16 @@ 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 BOUNCE_WATCH_SKILL_NAME = "mergestorm-bounce-watch";
+export const SKILL_NAMES = [SKILL_NAME, PR_LOOP_SKILL_NAME, BOUNCE_WATCH_SKILL_NAME];
 export const SKILL_USAGE = `usage:
-  mergestorm skill install --claude|--cursor [--json]
+  mergestorm skill install --claude|--cursor|--agents [--json]
 
-  Copies mergestorm-review and mergestorm-pr-loop into this repo (git toplevel, else cwd):
+  Copies ${SKILL_NAMES.join(", ")} 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.`;
+    --agents  .agents/skills/<name>/SKILL.md
+  Pass multiple flags to write multiple trees. Overwrites existing copies.`;
 export function parseSkillArgs(args) {
     const [sub, ...rest] = args;
     if (!sub || sub === "-h" || sub === "--help" || sub === "help") {
@@ -40,13 +42,18 @@ export function parseSkillArgs(args) {
                 targets.push("cursor");
             continue;
         }
+        if (arg === "--agents") {
+            if (!targets.includes("agents"))
+                targets.push("agents");
+            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");
+        throw new CommandError(`${SKILL_USAGE}\npass --claude, --cursor, and/or --agents`, 1, "usage");
     }
     return { help: false, json, targets };
 }
@@ -65,6 +72,9 @@ export function skillDestination(root, target, name = SKILL_NAME) {
     if (target === "claude") {
         return path.join(root, ".claude", "skills", name, "SKILL.md");
     }
+    if (target === "agents") {
+        return path.join(root, ".agents", "skills", name, "SKILL.md");
+    }
     return path.join(root, ".cursor", "skills", name, "SKILL.md");
 }
 export function resolveBundledSkillPath(fromFile = import.meta.url, name = SKILL_NAME) {
@@ -90,7 +100,7 @@ export function resolveBundledSkillPath(fromFile = import.meta.url, name = SKILL
 }
 async function assertNoSymlink(dest) {
     const parts = dest.split(path.sep);
-    const marker = parts.findIndex((p) => p === ".claude" || p === ".cursor");
+    const marker = parts.findIndex((p) => p === ".claude" || p === ".cursor" || p === ".agents");
     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);

package/dist/commands/stack.d.ts

@@ -1,11 +1,12 @@
-import { adoptStack, ensureUpperPark, listStacks, setStackPolicy, type StackDto, type StackPolicyPatch } from "../api.js";
+import { adoptStack, ensureUpperPark, getEnrichedStack, listStacks, setStackPolicy, type StackDto, type StackPolicyPatch } from "../api.js";
 import { loadConfig } from "../config.js";
-import { createPr, findOpenPrNumber } from "../gh.js";
+import { createPrs, findOpenPrNumber } from "../gh.js";
 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 { loadStackMeta, saveStackMeta } from "../stack-meta.js";
+import { pollStackWatch } from "../stack-watch.js";
 /** A registered stack layer that would become the parent of a new layer. */
 export type RegisteredParentHit = {
     stackId: string;
@@ -58,6 +59,7 @@ export declare function parseStackSubmitArgs(args: string[]): {
     autoLand?: boolean;
     autoReview?: boolean;
     autoPatch?: boolean;
+    rest: boolean;
     asJson: boolean;
 };
 export declare function parseStackAdoptArgs(args: string[]): {
@@ -113,13 +115,23 @@ export type StackSubmitDeps = {
     tipCommitSubject?: typeof tipCommitSubject;
     tipCommitMessage?: typeof tipCommitMessage;
     buildPrBodyFromCommit?: typeof buildPrBodyFromCommit;
-    createPr?: typeof createPr;
+    createPrs?: typeof createPrs;
     loadConfig?: typeof loadConfig;
     listStacks?: typeof listStacks;
     adoptStack?: typeof adoptStack;
     ensureUpperPark?: typeof ensureUpperPark;
+    env?: NodeJS.ProcessEnv;
 };
 export declare function cmdStackSubmit(args: string[], deps?: StackSubmitDeps): Promise<void>;
+export declare function cmdStackWait(args: string[], deps?: {
+    loadConfig?: typeof loadConfig;
+    pollStackWatch?: typeof pollStackWatch;
+    signal?: AbortSignal;
+}): Promise<void>;
+export declare function cmdStackStatus(args: string[], deps?: {
+    loadConfig?: typeof loadConfig;
+    getEnrichedStack?: typeof getEnrichedStack;
+}): Promise<void>;
 export type StackSetDeps = {
     loadConfig?: typeof loadConfig;
     setStackPolicy?: typeof setStackPolicy;
@@ -127,4 +139,6 @@ export type StackSetDeps = {
 /** Human summary lines for a `stack set` write, one per flag. */
 export declare function stackSetSummary(parsed: StackSetArgs): string[];
 export declare function cmdStackSet(args: string[], deps?: StackSetDeps): Promise<void>;
-export declare function cmdStack(args: string[]): Promise<void>;
+export declare function cmdStack(args: string[], options?: {
+    signal?: AbortSignal;
+}): Promise<void>;

package/dist/commands/stack.js

@@ -1,12 +1,14 @@
-import { adoptStack, ensureUpperPark, landNextStack, listStacks, restackStack, setStackPolicy, } from "../api.js";
+import { stackBlockersSummary } from "../stack-blockers.js";
+import { adoptStack, ensureUpperPark, getEnrichedStack, landNextStack, listStacks, restackStack, setStackPolicy, } from "../api.js";
 import { loadConfig } from "../config.js";
-import { CommandError } from "../errors.js";
-import { createPr, findOpenPrNumber, requireGh } from "../gh.js";
+import { rateLimitedMessage, REVIEW_EXIT, CommandError } from "../errors.js";
+import { createPrs, findOpenPrNumber, githubApiFromEnv, requireGh, } from "../gh.js";
 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, setActivePolicy, } from "../stack-meta.js";
+import { pollStackWatch, StackWatchError, StackWatchTimeoutError, } from "../stack-watch.js";
 import { isMgParkBranch, planSubmitLayerBases } from "../submit-pr-base.js";
 import { ansi } from "../ui/ansi.js";
 import { runLineTabsBrowser } from "../ui/line-tabs.js";
@@ -15,9 +17,11 @@ import { canBrowse } from "./browse.js";
 import { openHelpBrowser } from "./help.js";
 const STACK_USAGE = `usage:
   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 submit [--extend] [--auto-land on|off] [--auto-review on|off] [--auto-patch on|off] [--rest] [--json]
   mergestorm stack reset --force
   mergestorm stack list [--json]
+  mergestorm stack status <stack-id> [--json]
+  mergestorm stack wait <stack-id> [--json] [--timeout <s>]
   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]
@@ -29,6 +33,8 @@ const STACK_USAGE = `usage:
   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.
+  stack submit talks to GitHub GraphQL and falls back to the REST API when
+  GraphQL is blocked; --rest (or MERGESTORM_GITHUB_API=rest) forces REST.
   Parenting onto a branch that already belongs to a registered (submitted)
   stack requires --extend on create and submit — otherwise mg starts a new
   stack from trunk. stack land promotes into the review unit when one exists;
@@ -143,7 +149,7 @@ export function stackPolicyLabels(s) {
     }
     return labels;
 }
-function formatStackHuman(s) {
+function formatStackHuman(s, includeLayers = true) {
     const lines = [];
     lines.push(`  ${ansi.bold(`${s.owner}/${s.repo}`)}  trunk=${s.trunkBranch}` +
         stackPolicyLabels(s)
@@ -154,6 +160,8 @@ function formatStackHuman(s) {
         lines.push(ansi.dim("    (no layers)"));
         return lines;
     }
+    if (!includeLayers)
+        return lines;
     for (const layer of s.layers) {
         const title = layer.title ? ` ${layer.title}` : "";
         const pr = layer.prNumber > 0 ? `#${layer.prNumber}` : "—";
@@ -262,6 +270,7 @@ export function parseStackCreateArgs(args) {
 /** Parse `stack submit` argv. Exported for tests. */
 export function parseStackSubmitArgs(args) {
     let extend = false;
+    let rest = false;
     const policy = {};
     let asJson = false;
     for (let i = 0; i < args.length; i++) {
@@ -274,18 +283,23 @@ export function parseStackSubmitArgs(args) {
             extend = true;
             continue;
         }
+        if (a === "--rest") {
+            rest = true;
+            continue;
+        }
         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]");
+        throw new CommandError("usage: mergestorm stack submit [--extend] [--auto-land on|off] [--auto-review on|off] [--auto-patch on|off] [--rest] [--json]");
     }
     return {
         extend,
         autoLand: policy.autoLand,
         autoReview: policy.autoReview,
         autoPatch: policy.autoPatch,
+        rest,
         asJson,
     };
 }
@@ -518,7 +532,8 @@ export async function cmdStackCreate(args, deps = {}) {
     await present("Stack", created);
 }
 export async function cmdStackSubmit(args, deps = {}) {
-    const { extend, autoLand, autoReview, autoPatch, asJson } = parseStackSubmitArgs(args);
+    const { extend, autoLand, autoReview, autoPatch, rest, asJson } = parseStackSubmitArgs(args);
+    const api = rest ? "rest" : githubApiFromEnv(deps.env ?? process.env);
     const progress = (message) => {
         if (asJson)
             console.error(message);
@@ -539,7 +554,7 @@ export async function cmdStackSubmit(args, deps = {}) {
     const tipCommitSubjectFn = deps.tipCommitSubject ?? tipCommitSubject;
     const tipCommitMessageFn = deps.tipCommitMessage ?? tipCommitMessage;
     const buildPrBodyFn = deps.buildPrBodyFromCommit ?? buildPrBodyFromCommit;
-    const createPrFn = deps.createPr ?? createPr;
+    const createPrsFn = deps.createPrs ?? createPrs;
     const loadConfigFn = deps.loadConfig ?? loadConfig;
     const listStacksFn = deps.listStacks ?? listStacks;
     const adoptStackFn = deps.adoptStack ?? adoptStack;
@@ -624,16 +639,11 @@ export async function cmdStackSubmit(args, deps = {}) {
     }
     const opened = [];
     const pendingPark = plans.filter((plan) => {
-        if (findOpenPrNumberFn(owner, repo, plan.branch, cwd) != null)
+        if (findOpenPrNumberFn(owner, repo, plan.branch, cwd, { api }) != null)
             return false;
         return plan.githubBase == null;
     });
-    const openLayerPr = (branch, base) => {
-        const existing = findOpenPrNumberFn(owner, repo, branch, cwd);
-        if (existing != null) {
-            progress(ansi.dim(`  PR #${existing} already open for ${branch}`));
-            return { prNumber: existing, created: false };
-        }
+    const prepareLayerPr = (branch, base) => {
         const aheadRef = isMgParkBranch(base) ? `origin/${base}` : base;
         if (isMgParkBranch(base)) {
             try {
@@ -657,30 +667,44 @@ export async function cmdStackSubmit(args, deps = {}) {
             throw new CommandError(`No commits on \`${branch}\` ahead of \`${base}\`. ` +
                 `Commit your changes, then retry \`mg stack submit\`.`);
         }
-        const title = tipCommitSubjectFn(branch, cwd);
-        const body = buildPrBodyFn(tipCommitMessageFn(branch, cwd));
-        progress(ansi.dim(`  Opening PR ${branch} → ${base} …`));
         return {
-            prNumber: createPrFn({
-                owner,
-                repo,
-                base,
-                head: branch,
-                title,
-                body,
-                cwd,
-            }),
-            created: true,
+            base,
+            head: branch,
+            title: tipCommitSubjectFn(branch, cwd),
+            body: buildPrBodyFn(tipCommitMessageFn(branch, cwd)),
         };
     };
-    for (const plan of plans) {
-        if (plan.githubBase == null && findOpenPrNumberFn(owner, repo, plan.branch, cwd) == null) {
-            continue;
+    const openLayerWave = (wave) => {
+        const rows = [];
+        const pending = [];
+        for (const { branch, base } of wave) {
+            const existing = findOpenPrNumberFn(owner, repo, branch, cwd, { api });
+            if (existing != null) {
+                progress(ansi.dim(`  PR #${existing} already open for ${branch}`));
+                rows.push({ branch, base, prNumber: existing, created: false });
+                continue;
+            }
+            pending.push({ index: rows.length, pr: prepareLayerPr(branch, base) });
+            rows.push({ branch, base, prNumber: 0, created: true });
         }
-        const base = plan.githubBase ?? plan.gitParent;
-        const { prNumber, created } = openLayerPr(plan.branch, base);
-        opened.push({ branch: plan.branch, base, prNumber, created });
-    }
+        if (pending.length === 0)
+            return rows;
+        for (const { pr } of pending) {
+            progress(ansi.dim(`  Opening PR ${pr.head} → ${pr.base} …`));
+        }
+        const numbers = createPrsFn({ owner, repo, prs: pending.map((p) => p.pr), cwd, api });
+        if (numbers.length !== pending.length) {
+            throw new CommandError(`GitHub returned ${numbers.length} PR numbers for ${pending.length} new pull requests.`);
+        }
+        pending.forEach(({ index }, i) => {
+            rows[index].prNumber = numbers[i];
+        });
+        return rows;
+    };
+    opened.push(...openLayerWave(plans
+        .filter((plan) => plan.githubBase != null ||
+        findOpenPrNumberFn(owner, repo, plan.branch, cwd, { api }) != null)
+        .map((plan) => ({ branch: plan.branch, base: plan.githubBase ?? plan.gitParent }))));
     const cfg = await loadConfigFn();
     let adoptData = null;
     let stackId = plans.find((plan) => plan.stackId)?.stackId ?? null;
@@ -711,10 +735,7 @@ export async function cmdStackSubmit(args, deps = {}) {
         }
         progress(ansi.dim(`  Ensuring upper-park freeze for stack ${stackId} …`));
         const park = await ensureUpperParkFn(stackId, cfg);
-        for (const plan of pendingPark) {
-            const { prNumber, created } = openLayerPr(plan.branch, park.freezeBranch);
-            opened.push({ branch: plan.branch, base: park.freezeBranch, prNumber, created });
-        }
+        opened.push(...openLayerWave(pendingPark.map((plan) => ({ branch: plan.branch, base: park.freezeBranch }))));
         await registerPr(opened[opened.length - 1].prNumber);
     }
     else {
@@ -787,6 +808,86 @@ async function cmdStackList(args) {
     listed.push(ansi.dim("  Dashboard: https://mergestorm.ai/dashboard"));
     await present("Stacks", listed);
 }
+export async function cmdStackWait(args, deps = {}) {
+    const usage = "usage: mergestorm stack wait <stack-id> [--json] [--timeout <s>]";
+    const positional = [];
+    let timeoutS = 45;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--json")
+            continue;
+        if (arg === "--timeout" || arg.startsWith("--timeout=")) {
+            const value = arg === "--timeout" ? args[++i] : arg.slice("--timeout=".length);
+            timeoutS = value?.trim() ? Number(value) : NaN;
+            if (!Number.isFinite(timeoutS) || timeoutS < 0 || timeoutS > 300) {
+                throw new CommandError(`${usage}\n--timeout must be between 0 and 300 seconds`, REVIEW_EXIT.usage, "usage");
+            }
+        }
+        else if (arg.startsWith("-")) {
+            throw new CommandError(usage, REVIEW_EXIT.usage, "usage");
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    if (positional.length !== 1)
+        throw new CommandError(usage, REVIEW_EXIT.usage, "usage");
+    const stackId = requireStackId(positional[0], usage);
+    const cfg = await (deps.loadConfig ?? loadConfig)();
+    const print = (envelope, retryAfterSeconds) => console.log(args.includes("--json")
+        ? JSON.stringify({
+            ...envelope,
+            ...(retryAfterSeconds !== undefined ? { retry_after_seconds: retryAfterSeconds } : {}),
+        }, null, 2)
+        : `Stack ${envelope.stackId} · ${envelope.status}${stackBlockersSummary(envelope.blocker && envelope.prNumber != null ? { prNumber: envelope.prNumber, blocker: envelope.blocker } : null, envelope.issues)}${envelope.assessment === "unavailable" ? " · assessment unavailable" : ""}`);
+    try {
+        print(await (deps.pollStackWatch ?? pollStackWatch)(cfg, stackId, {
+            timeoutMs: timeoutS * 1000,
+            signal: deps.signal,
+        }));
+    }
+    catch (err) {
+        if (err instanceof StackWatchError && err.lastEnvelope.status === "rate_limited") {
+            print(err.lastEnvelope, err.retryAfterSeconds);
+            throw new CommandError(rateLimitedMessage(err.retryAfterSeconds), REVIEW_EXIT.rate_limited, "rate_limited", { retryAfterSeconds: err.retryAfterSeconds });
+        }
+        if (err instanceof StackWatchError) {
+            print(err.lastEnvelope);
+            throw err;
+        }
+        if (!(err instanceof StackWatchTimeoutError))
+            throw err;
+        print(err.lastEnvelope);
+        throw new CommandError(err.message, REVIEW_EXIT.timeout, "review_timeout");
+    }
+}
+export async function cmdStackStatus(args, deps = {}) {
+    const usage = "usage: mergestorm stack status <stack-id> [--json]";
+    const positional = args.filter((arg) => arg !== "--json");
+    if (positional.length !== 1)
+        throw new CommandError(usage, 2, "usage");
+    const stackId = requireStackId(positional[0], usage);
+    const cfg = await (deps.loadConfig ?? loadConfig)();
+    const stack = await (deps.getEnrichedStack ?? getEnrichedStack)(stackId, cfg);
+    if (!stack) {
+        throw new CommandError(`Stack not found or not owned by the current user: ${stackId}`, 1, "not_found");
+    }
+    if (args.includes("--json")) {
+        console.log(JSON.stringify(stack, null, 2));
+        return;
+    }
+    const lines = formatStackHuman(stack, false);
+    for (const layer of stack.layers) {
+        const head = layer.headSha ? `@${layer.headSha.slice(0, 7)}` : "";
+        const pr = layer.prNumber > 0 ? `#${layer.prNumber}` : "—";
+        lines.push(`    ${String(layer.position).padStart(2)}  ${pr}${head}  ${layer.state.padEnd(14)}  ${layer.branch}` +
+            `  CI: ${layer.ciStatus ?? "unknown"}  review: ${layer.reviewStatus ?? "unknown"}` +
+            (layer.vortexStatus ? `  Vortex: ${layer.vortexStatus}` : "") +
+            (layer.cycloneStatus ? `  Cyclone: ${layer.cycloneStatus}` : "") +
+            (layer.tempestStatus ? `  Tempest: ${layer.tempestStatus}` : ""));
+    }
+    await present("Stack status", lines);
+}
 /** 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";
@@ -885,7 +986,7 @@ async function cmdStackLand(args) {
             ` on ${id}`),
     ]);
 }
-export async function cmdStack(args) {
+export async function cmdStack(args, options = {}) {
     const sub = args[0]?.toLowerCase();
     const rest = args.slice(1);
     // Help must exit 0 — print usage, do not throw CommandError.
@@ -905,6 +1006,10 @@ export async function cmdStack(args) {
         return cmdStackReset(rest);
     if (sub === "list" || sub === "ls")
         return cmdStackList(rest);
+    if (sub === "status")
+        return cmdStackStatus(rest);
+    if (sub === "wait")
+        return cmdStackWait(rest, { signal: options.signal });
     if (sub === "set")
         return cmdStackSet(rest);
     if (sub === "adopt")

package/dist/errors.d.ts

@@ -2,7 +2,7 @@
  * Stable machine codes for CommandError control flow.
  * UX copy in `message` may change freely; match on `code`, never on message text.
  */
-export type CommandErrorCode = "auth_invalid" | "api_timeout" | "not_a_repo" | "not_found" | "missing_api_key" | "registered_parent" | "usage" | "review_quota" | "review_failed" | "review_timeout" | "rate_limited";
+export type CommandErrorCode = "auth_invalid" | "api_timeout" | "not_a_repo" | "not_found" | "missing_api_key" | "registered_parent" | "usage" | "review_quota" | "review_failed" | "review_timeout" | "rate_limited" | "cyclone_not_installed" | "pr_merged" | "pr_closed" | "not_stacked" | "draft" | "reserved_branch" | "supabase_unconfigured" | "cyclone_not_connected" | "busy" | "adopt_failed";
 /** Stable one-shot exit codes for machine callers of `mergestorm review`. */
 export declare const REVIEW_EXIT: {
     readonly success: 0;

package/dist/gh.d.ts

@@ -1,20 +1,82 @@
-export declare function runGh(args: string[], cwd?: string): {
+import { CommandError } from "./errors.js";
+export type GhResult = {
     ok: true;
     stdout: string;
 } | {
     ok: false;
     stderr: string;
     status: number | null;
+    stdout?: string;
 };
+export type GhRunner = (args: string[], input?: string) => GhResult;
+export type GithubApi = "graphql" | "rest";
+export declare const GITHUB_API_ENV = "MERGESTORM_GITHUB_API";
+export declare function githubApiFromEnv(env?: NodeJS.ProcessEnv): GithubApi;
+export declare function isGraphqlEndpointBlocked(text: string): boolean;
+export declare class GraphqlBlockedError extends CommandError {
+    readonly opened: readonly number[];
+    constructor(message: string, opened?: readonly number[]);
+}
+type GhSpawn = (command: string, args: string[], options: {
+    cwd: string;
+    encoding: "utf8";
+    input?: string;
+}) => {
+    error?: Error;
+    stdout?: string | null;
+    stderr?: string | null;
+    status: number | null;
+};
+export declare function runGh(args: string[], cwd?: string, input?: string, spawn?: GhSpawn): GhResult;
 export declare function requireGh(cwd?: string): void;
 /** Open PR number for `head` branch in owner/repo, or null. */
-export declare function findOpenPrNumber(owner: string, repo: string, headBranch: string, cwd?: string): number | null;
-export declare function createPr(input: {
-    owner: string;
-    repo: string;
+export declare function findOpenPrNumber(owner: string, repo: string, headBranch: string, cwd?: string, options?: {
+    api?: GithubApi;
+    gh?: GhRunner;
+}): number | null;
+export declare function findOpenPrNumberViaRest(owner: string, repo: string, headBranch: string, gh: GhRunner): number | null;
+export type NewPr = {
     base: string;
     head: string;
     title: string;
-    body?: string;
+    body: string;
+};
+export type GraphqlRequest = {
+    query: string;
+    variables: Record<string, unknown>;
+};
+export type GraphqlResponse = {
+    data?: Record<string, unknown> | null;
+    errors?: {
+        message?: string;
+    }[];
+};
+export type GraphqlRunner = (request: GraphqlRequest) => GraphqlResponse;
+type GraphqlSpawnResult = {
+    error?: Error;
+    stdout?: string | null;
+    stderr?: string | null;
+    status: number | null;
+};
+type GraphqlSpawn = (command: string, args: string[], options: {
+    cwd: string;
+    encoding: "utf8";
+    input: string;
+}) => GraphqlSpawnResult;
+export declare const CREATE_PR_BATCH_SIZE = 5;
+export declare function ghGraphql(request: GraphqlRequest, cwd?: string, spawn?: GraphqlSpawn): GraphqlResponse;
+export declare function chunkCreatePrs<T>(items: readonly T[], size?: number): T[][];
+export declare function buildCreatePrsMutation(repositoryId: string, prs: readonly NewPr[]): GraphqlRequest;
+export declare function fetchRepositoryId(owner: string, repo: string, graphql: GraphqlRunner): string;
+export declare function createPrsOnRepository(repositoryId: string, prs: readonly NewPr[], graphql: GraphqlRunner): number[];
+export declare function createPrsViaRest(owner: string, repo: string, prs: readonly NewPr[], gh: GhRunner, opened?: readonly number[]): number[];
+export declare function createPrs(input: {
+    owner: string;
+    repo: string;
+    prs: readonly NewPr[];
     cwd?: string;
-}): number;
+    api?: GithubApi;
+    graphql?: GraphqlRunner;
+    gh?: GhRunner;
+}): number[];
+export {};