Release OpenSpec

Run the OpenSpec release workflow as a resumable state machine. Inspect live GitHub state on every invocation and take only the next safe action. Do not assume an earlier invocation completed.

Principles

• Treat Fission-AI/OpenSpec and origin/main as the release source of truth.
• Default to a read-only audit when the user asks for status, readiness, or advice.
• Treat a request to release, prepare a release, continue, or resume as authorization to perform the applicable release actions.
• Preserve the user's checkout. Never discard unrelated changes or switch their current branch just to prepare a changeset.
• Use a temporary worktree from current origin/main for release-authored commits when the checkout is dirty or not on main.
• Never approve your own PR. Human review is a deliberate gate.
• Treat merge-queue entry as an intermediate state, not a merge. Advance only after GitHub reports mergedAt and the commit is present on main.
• Never create the automated Version Packages PR manually. The Changesets action owns it.
• Never push an empty commit merely to retrigger CI. Diagnose the failed or missing run first.
• Report URLs, the state reached, and the exact human action needed whenever pausing.

Know the two PR types