[skarim]

Defaults Stack CLI pushes to atomic updates so branch updates succeed or fail together.

• Related to send pull.stacked option on force push #562
• Replaces the opt-in approach in Add atomic push option to push and sync commands #402

Functionality and user impact

• Atomic by default. push, submit, sync, and link push branches together; submit now uses one batch. PR/API updates are not atomic.
• Explicit opt-out. Use --no-atomic or GH_STACK_NO_ATOMIC=1; --no-atomic=false overrides the environment. No automatic non-atomic retry.
• Safe reordered submits. For pending modify changes, at-risk PRs temporarily target the trunk before pushing. Final bases are restored afterward; failures retain the existing recovery journal.

Key areas to review

• Defaults and opt-outs: cmd/push.go, cmd/sync.go, and cmd/link.go. Existing force behavior stays unchanged.
• Submit ordering and recovery: prepareReorderedPRs in cmd/submit.go and cmd/submit_test.go. Protect reversed PR bases before the batch and preserve recovery on failure.
• Push safety: cmd/push_test.go and internal/git/gitops_test.go. Flag precedence, no downgrade, and all-or-nothing ref updates.

[Copilot]

🔵 Needs a closer look

Submit’s changed ordering risks prematurely marking reordered PRs as merged and needs human validation of a recovery-safe approach.

2 open issues

• Prevent PR merges during reordered batch publishing · New
• Clear GH_STACK_NO_ATOMIC before asserting atomic defaults · New

What changed in this PR

Makes Git pushes atomic by default across gh-stack’s publishing commands, replacing opt-in atomicity with explicit opt-outs.

Changes:

• Add --no-atomic and GH_STACK_NO_ATOMIC controls to push, submit, sync, and link.
• Batch submit’s branch pushes before PR creation and updates.
• Expand push-safety tests and document atomicity, override precedence, and recovery behavior.

File	Description
skills/​gh-stack/​references/​commands.md	Document atomic defaults, opt-outs, and submit ordering.
README.md	Update command descriptions and flag tables.
internal/​git/​gitops_test.go	Compare atomic and non-atomic behavior on lease rejection.
docs/​src/​content/​docs/​reference/​cli.md	Document flags, environment precedence, and atomicity limits.
docs/​src/​content/​docs/​guides/​workflows.md	Explain atomic pushes in the rebase workflow.
cmd/​sync.go	Add atomic opt-outs while preserving force-push selection.
cmd/​sync_test.go	Assert atomic pushes with and without rebasing.
cmd/​submit.go	Push active branches together before processing PRs.
cmd/​submit_test.go	Update batching, ordering, and pending-modify recovery coverage.
cmd/​push.go	Enable atomic pushes by default with explicit opt-outs.
cmd/​push_test.go	Cover defaults, override precedence, and no automatic downgrade.
cmd/​link.go	Make existing atomic push behavior configurable.
cmd/​link_test.go	Assert non-force, atomic branch pushes.

_{Review effort: Max}