Release Audit

Generates a markdown audit of the upcoming Warp release for keep/defer decisions. Runs in two modes (auto-detected): a pre-release spot-check while work is still landing on main, or a release-candidate readiness review after the release branch is cut.

Output: a single markdown report, filed according to the destination chosen in Phase 1:

• Secret gist (default when gh is available and authenticated): stable filename warp-<version-string>-<prerelease|rc>-report.md, stable description Warp <version-string> <Pre-Release|Release Candidate> Report. Later runs against the same version revise the same gist in place; prior versions are preserved in the gist's git history.
• Local markdown file (fallback when gh unavailable, or opt-in when gh available): dated path at $(git rev-parse --show-toplevel)/warp-<version-string>-<prerelease|rc>-report-<YYYY-MM-DD>.md. Not auto-committed; user moves, shares, or deletes as desired.

Inputs inferred from repo state:

• Target version from warp/config.py / warp/__init__.py / VERSION.md.
• Base = latest tag matching previous minor's line (vX.Y-prev.*, latest patch).
• Head = upstream/release-<target> if it exists, else upstream/main.

Reference documents to load on demand (via Read):

• references/report-template.md — fill this in during Phase 6b (the {{HEADLINE_SUMMARY}} placeholder is drafted in Phase 6a).
• references/render-rules.md — URL shapes, signature/docstring code-block forms, table column specs, audit-appendix conditional, and output-style hard constraints. Loaded in Phase 6b.
• references/classification-rules.md — path/symbol rules used in Phases 3-5.
• references/language-review-examples.md — Phase 5a calibration for the CHANGELOG Review Notes appendix.
• scripts/diff_public_api.py — deterministic JSON fact extractor for Phase 4e public runtime/stub API diffs.