gh-stack 0.2.2 → 0.3.0

package/README.md

@@ -78,12 +78,14 @@ create <branch-name> [--description <desc>]
     Create a new git branch off the current branch and add it to
     the stack. The current branch must already be tracked.
 
-submit [-d|--draft] [-n|--no-edit] [--dry-run]
+submit [-d|--draft] [-n|--no-edit] [-t|--title <t>] [-b|--body <b>] [--body-file <f>] [--dry-run]
     Push all downstack branches to GitHub, create PRs for branches
     that don't have them, and update all PR descriptions with stack
     visualization. Idempotent — safe to run repeatedly.
 
-    In --yes mode, auto-generates PR titles from branch names.
+    --title/-t and --body/-b provide PR details directly (skips prompts).
+    --body-file reads body from a file. In --yes mode without --title,
+    auto-generates PR titles from branch names.
 ```
 
 ### Stack Navigation
@@ -127,10 +129,11 @@ sync [--dry-run]
     Fetch main, rebase the base branch onto main, then restack all
     children. Creates tags for ALL branches before any rebasing starts.
 
-merge [--dry-run]
-    Squash-merge the stack top-down locally (PR3 → PR2 → PR1),
-    then optionally rebase onto main. Closes intermediate PRs and
-    archives the stack on completion.
+merge [--dry-run] [-d|--delete-branch]
+    Squash-merge the stack top-down via GitHub (PR3 → PR2 → PR1),
+    then enables auto-merge for the base PR into main. All merges
+    happen on GitHub so PRs show as "Merged", Linear tickets close
+    automatically, and GitHub Actions fire normally.
 
 delete [<branch>]
     Remove a branch from the stack and re-parent its children.
@@ -251,7 +254,7 @@ gh-stack top         # jump to tip
 gh-stack status
 
 # When PRs are approved, merge the stack
-gh-stack merge
+gh-stack merge       # squash-merges down, pushes, enables auto-merge
 ```
 
 ## Agent/CI Usage
@@ -263,7 +266,8 @@ gh-stack is designed to be used by AI agents and CI pipelines:
 export GH_STACK_YES=1
 
 gh-stack init                    # No confirmations
-gh-stack submit                  # Auto-generates PR titles
+gh-stack submit -t "Title [WEB-1234]" -b "Description"  # Explicit PR details
+gh-stack submit -n               # Or auto-generate titles
 gh-stack sync
 gh-stack restack
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gh-stack",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Stacked PR manager for squash-merge workflows",
   "author": "Kiliman <kiliman@gmail.com>",
   "license": "MIT",

package/src/commands/merge.ts

@@ -1,34 +1,37 @@
-// gh-stack merge — Local squash-merge top-down
-// From reference/gh-stack-merge-design.md
+// gh-stack merge — Squash-merge stack top-down via GitHub
 import * as p from "@clack/prompts";
 import pc from "picocolors";
+import { $ } from "bun";
 import * as git from "../lib/git.ts";
 import { findStackForBranch, getOrderedBranches, writeMetadata } from "../lib/metadata.ts";
-import { ensureMetadata, ensureCleanWorkingTree, ensureValidStack } from "../lib/safety.ts";
+import { ensureMetadata, ensureValidStack } from "../lib/safety.ts";
 import { takeSnapshot } from "../lib/snapshot.ts";
-import { closePr } from "../lib/github.ts";
 import { confirmAction } from "../lib/ui.ts";
 
 export default async function merge(args: string[]): Promise<void> {
   const dryRun = args.includes("--dry-run");
+  const deleteFlag = args.includes("--delete-branch") || args.includes("-d");
 
   if (args.includes("--help")) {
     console.log(`
-gh-stack merge — Local squash-merge top-down
+gh-stack merge — Squash-merge stack via GitHub
 
 USAGE
-  gh-stack merge [--dry-run]
+  gh-stack merge [--dry-run] [-d|--delete-branch]
 
-Squash-merges the stack from top to bottom locally:
-  PR3 → PR2 → PR1, then optionally rebases PR1 onto main.
+Squash-merges the stack from top to bottom via GitHub:
+  PR3 → squash into PR2, PR2 → squash into PR1, PR1 → auto-merge into main.
 
-This keeps all commits local (avoiding orphaned squash commits).
+All merges happen on GitHub, so PRs show as "Merged", Linear tickets
+close automatically, and all GitHub Actions/webhooks fire normally.
+
+OPTIONS
+  -d, --delete-branch  Delete remote branches after merging
+      --dry-run        Show what would happen without doing anything
 `);
     return;
   }
 
-  await ensureCleanWorkingTree();
-
   const meta = await ensureMetadata();
   const currentBranch = await git.currentBranch();
   const stackName = findStackForBranch(meta, currentBranch);
@@ -43,12 +46,25 @@ This keeps all commits local (avoiding orphaned squash commits).
   const ordered = getOrderedBranches(stack);
 
   if (ordered.length <= 1) {
-    p.log.info("Single branch stack — nothing to merge down.");
-    p.log.info("Just merge via GitHub as normal.");
+    // Single branch — just enable auto-merge
+    const basePr = stack.branches[ordered[0]!]?.pr;
+    if (basePr) {
+      p.log.info("Single branch stack — enabling auto-merge on GitHub.");
+      if (!dryRun) {
+        try {
+          await $`gh pr merge ${basePr} --squash --auto`.quiet();
+          p.log.success(`Auto-merge enabled for PR #${basePr}`);
+        } catch {
+          p.log.info(`Enable manually: ${pc.dim(`gh pr merge ${basePr} --squash --auto`)}`);
+        }
+      }
+    } else {
+      p.log.info("Single branch stack — merge via GitHub as normal.");
+    }
     return;
   }
 
-  p.intro(pc.cyan("Git Stack Merge (Top-Down)"));
+  p.intro(pc.cyan("Stack Merge (via GitHub)"));
 
   p.log.info(`Stack: ${pc.yellow(stackName)}`);
   console.log();
@@ -60,9 +76,15 @@ This keeps all commits local (avoiding orphaned squash commits).
     const child = reversed[i]!;
     const parent = stack.branches[child]?.parent || "???";
     const childPr = stack.branches[child]?.pr;
-    console.log(`    ${pc.yellow(child)}${childPr ? ` (#${childPr})` : ""} → ${pc.blue(parent)}`);
+    console.log(
+      `    ${pc.yellow(child)}${childPr ? ` (#${childPr})` : ""} → squash into ${pc.blue(parent)}`,
+    );
   }
-  console.log(`    ${pc.blue(ordered[0]!)} → ${pc.green("main")} (via GitHub)`);
+  const baseBranch = ordered[0]!;
+  const basePr = stack.branches[baseBranch]?.pr;
+  console.log(
+    `    ${pc.blue(baseBranch)}${basePr ? ` (#${basePr})` : ""} → ${pc.green("main")} (auto-merge)`,
+  );
   console.log();
 
   if (dryRun) {
@@ -70,7 +92,16 @@ This keeps all commits local (avoiding orphaned squash commits).
     return;
   }
 
-  const confirmed = await confirmAction("Merge stack top-down?");
+  // Check all PRs in stack have PR numbers
+  const missingPrs = ordered.filter((b) => !stack.branches[b]?.pr);
+  if (missingPrs.length > 0) {
+    p.cancel(
+      `Missing PR numbers for: ${missingPrs.join(", ")}\n\n  Run ${pc.green("gh-stack submit")} first to create PRs.`,
+    );
+    process.exit(1);
+  }
+
+  const confirmed = await confirmAction("Squash-merge stack top-down via GitHub?");
   if (!confirmed) {
     p.cancel("Cancelled");
     process.exit(0);
@@ -79,82 +110,77 @@ This keeps all commits local (avoiding orphaned squash commits).
   // Take snapshot
   await takeSnapshot(meta, stackName, "merge");
 
-  // Merge top-down: for each branch from top to bottom (skip the base)
+  // Merge top-down via GitHub: for each PR from top, squash-merge into parent
   for (let i = 0; i < reversed.length - 1; i++) {
     const childBranch = reversed[i]!;
-    const parentBranch = stack.branches[childBranch]?.parent;
-    if (!parentBranch || parentBranch === "main") continue;
+    const childPrNum = stack.branches[childBranch]!.pr!;
+    const parentBranch = stack.branches[childBranch]!.parent;
 
-    const childPr = stack.branches[childBranch]?.pr;
-    const childTitle = stack.branches[childBranch]?.description || childBranch;
+    if (parentBranch === "main" || parentBranch === "master") continue;
 
     console.log();
     console.log(pc.cyan("━".repeat(40)));
-    console.log(`${pc.blue("Merge:")} ${pc.yellow(childBranch)} → ${pc.blue(parentBranch)}`);
+    console.log(
+      `${pc.blue("Merge:")} PR #${childPrNum} ${pc.yellow(childBranch)} → ${pc.blue(parentBranch)}`,
+    );
     console.log(pc.cyan("━".repeat(40)));
-    console.log();
-
-    // Checkout parent
-    p.log.info(`Checking out ${pc.yellow(parentBranch)}...`);
-    await git.checkout(parentBranch);
-
-    // Squash merge child
-    p.log.info(`Squash-merging ${pc.yellow(childBranch)}...`);
-    const success = await git.mergeSquash(childBranch);
-
-    if (!success) {
-      p.log.error("Merge conflict — resolve and try again");
-      process.exit(2);
-    }
-
-    // Commit
-    const commitMsg = childPr ? `squash: ${childTitle} (#${childPr})` : `squash: ${childTitle}`;
-
-    await git.commit(commitMsg);
-    p.log.success(`Merged ${childBranch} into ${parentBranch}`);
-  }
 
-  // Optionally rebase base onto main
-  console.log();
-  const baseBranch = ordered[0]!;
-  const rebaseConfirmed = await confirmAction(`Rebase ${pc.yellow(baseBranch)} onto latest main?`);
+    const s = p.spinner();
+    s.start(`Squash-merging PR #${childPrNum} via GitHub...`);
 
-  if (rebaseConfirmed) {
-    p.log.info("Fetching latest main...");
-    await git.fetchMain();
+    const ghArgs = ["pr", "merge", String(childPrNum), "--squash"];
+    if (deleteFlag) ghArgs.push("--delete-branch");
 
-    p.log.info(`Checking out ${pc.yellow(baseBranch)}...`);
-    await git.checkout(baseBranch);
+    const proc = Bun.spawn(["gh", ...ghArgs], {
+      stdout: "pipe",
+      stderr: "pipe",
+    });
+    const stderr = await new Response(proc.stderr).text();
+    const exitCode = await proc.exited;
 
-    const success = await git.rebase("origin/main");
-    if (success) {
-      p.log.success("Rebased onto main");
+    if (exitCode === 0) {
+      s.stop(`Merged PR #${childPrNum} into ${pc.blue(parentBranch)}`);
     } else {
-      p.log.error("Rebase conflict — resolve manually");
+      s.stop(pc.red(`Failed to merge PR #${childPrNum}`));
+      p.log.error(stderr.trim());
+      p.log.info("Resolve the issue on GitHub, then re-run merge to continue.");
       process.exit(2);
     }
   }
 
-  // Close intermediate PRs
+  // Base PR → enable auto-merge into main
   console.log();
-  const closePrs = await confirmAction("Close intermediate PRs on GitHub?");
+  console.log(pc.cyan("━".repeat(40)));
+  console.log(
+    `${pc.blue("Auto-merge:")} PR #${basePr} ${pc.yellow(baseBranch)} → ${pc.green("main")}`,
+  );
+  console.log(pc.cyan("━".repeat(40)));
+
+  const autoSpinner = p.spinner();
+  autoSpinner.start(`Enabling auto-merge for PR #${basePr}...`);
+
+  try {
+    const ghArgs = ["pr", "merge", String(basePr), "--squash", "--auto"];
+    if (deleteFlag) ghArgs.push("--delete-branch");
+    await $`gh pr merge ${basePr} --squash --auto ${deleteFlag ? "--delete-branch" : ""}`.quiet();
+    autoSpinner.stop(`Auto-merge enabled for PR #${basePr} — will merge into main when CI passes`);
+  } catch {
+    autoSpinner.stop(pc.yellow(`Could not enable auto-merge for PR #${basePr}`));
+    p.log.info(`Enable manually: ${pc.dim(`gh pr merge ${basePr} --squash --auto`)}`);
+  }
 
-  if (closePrs) {
-    const basePr = stack.branches[ordered[0]!]?.pr;
-    for (let i = 1; i < ordered.length; i++) {
-      const prNum = stack.branches[ordered[i]!]?.pr;
-      if (prNum) {
-        const comment = basePr
-          ? `Merged locally into base PR #${basePr}. See the base PR for the full stack.`
-          : "Merged locally into base PR.";
-        const ok = await closePr(prNum, comment);
-        if (ok) {
-          p.log.success(`Closed PR #${prNum}`);
-        } else {
-          p.log.warn(`Could not close PR #${prNum}`);
-        }
-      }
-    }
+  // Update local main and clean up
+  console.log();
+  const pullSpinner = p.spinner();
+  pullSpinner.start("Syncing local branches...");
+  try {
+    await $`git fetch origin`.quiet();
+    // Checkout main and pull so local is up to date
+    await git.checkout("main");
+    await $`git pull origin main`.quiet();
+    pullSpinner.stop("Local branches synced");
+  } catch {
+    pullSpinner.stop(pc.dim("Could not sync local branches — run git pull manually"));
   }
 
   // Archive the stack
@@ -168,9 +194,4 @@ This keeps all commits local (avoiding orphaned squash commits).
   await writeMetadata(meta);
 
   p.outro(pc.green("Stack merge complete! Stack archived."));
-
-  console.log();
-  console.log("  Next steps:");
-  console.log(`    1. Push ${pc.yellow(baseBranch)} and let CI run`);
-  console.log(`    2. Squash-merge ${pc.yellow(baseBranch)} into main via GitHub`);
 }