Sync Main To Next

Sync Main To Next

Handle $ARGUMENTS by loading .agents/rules/release-lanes.mdc and running only its Sync Main To Next lane.

This is a convenience wrapper, not a second release system. release-lanes owns the release architecture, script contract, hard stops, and handoff shape.

Default Mode

Default to the real sync when the user says sync-main-to-next without arguments.

Use this sequence:

node tooling/scripts/release-branch-prs.mjs sync-main-to-next --dry-run
node tooling/scripts/release-branch-prs.mjs sync-main-to-next --push
node tooling/scripts/release-branch-prs.mjs verify-main-to-next-sync

Then watch only the workflows created by the pushed sync commit:

gh run list --branch next --limit 10 \
  --json databaseId,name,workflowName,headSha,status,conclusion,displayTitle,url
gh run watch <release-run-id> --exit-status
gh run watch <ci-run-id> --exit-status

Read back:

npm view platejs dist-tags --json
npm view platejs@latest version
npm view platejs@beta version
gh release list --limit 5
gh pr list --base next --head sync/main-to-next --state open --json number,url

Close stale sync/main-to-next PRs only after the direct sync and release verification pass.

Keep It Fast

• Do not create or update a plan unless the user explicitly asks for an autogoal artifact.
• Do not run autoreview.
• Do not create a main -> next PR.
• Do not touch promotion; this shortcut is not next -> main.
• Do not re-run broad release status commands once the pushed SHA is known.
• Do not wait on unrelated old workflow runs.

Hard Stops

Use the release-lanes hard stops. In practice, stop only for:

• dirty checkout rejected by the direct sync script
• real source conflicts outside known release metadata
• branch protection rejecting the required push
• release or CI failure after one clear repair attempt
• npm/GitHub readback mismatch for the expected latest or beta

Handoff

Report in five lines or fewer:

• pushed sync commit
• release and CI run URLs
• npm latest and beta
• stale PR cleanup result
• residual risk