Skip to content

doc: document revised nightly toolchains#787

Open
kim-em wants to merge 1 commit intolean4from
doc-revised-nightlies
Open

doc: document revised nightly toolchains#787
kim-em wants to merge 1 commit intolean4from
doc-revised-nightlies

Conversation

@kim-em
Copy link
Collaborator

@kim-em kim-em commented Feb 13, 2026

This PR documents the revised nightly toolchain mechanism (nightly-YYYY-MM-DD-revK tags) in the tags and branches guide. Revised nightlies are produced by manually re-triggering the nightly release workflow when the base nightly already exists, and are ordered between the base nightly and the next day's nightly.

Companion to leanprover/lean4#12461

🤖 Prepared with Claude Code

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
github-merge-queue bot pushed a commit to leanprover/lean4 that referenced this pull request Feb 13, 2026
…12461)

This PR adds support for manually re-releasing nightlies when a build
issue or critical fix requires it. When a `workflow_dispatch` triggers
the nightly release job and a `nightly-YYYY-MM-DD` tag already exists,
the CI now creates `nightly-YYYY-MM-DD-rev1` (then `-rev2`, etc.)
instead of silently skipping.

### Lake `ToolchainVer`

- Extend `ToolchainVer.nightly` with an optional `rev : Option Nat`
field
- Parse `-revK` suffixes from nightly tags in `ofString`
- Ordering: `nightly-YYYY-MM-DD` < `nightly-YYYY-MM-DD-rev1` < `-rev2` <
`nightly-YYYY-MM-DD+1`
- Round-trip: `toString (ofString s) == s` for both variants

### CI workflow

- "Set Nightly" step probes existing tags on `workflow_dispatch` to find
next available `-revK`
- Scheduled nightlies retain existing behavior (skip if commit already
tagged)
- Changelog grep updated from `nightly-[-0-9]*` to `nightly-[^ ,)]*` to
match `-revK` suffixes

### `lean-bisect`

- Updated `NIGHTLY_PATTERN` regex, sort key, error messages, and help
text

### Companion PRs

- leanprover-community/mathlib4#35220: update
`nightly_bump_and_merge.yml` tag grep and `nightly_detect_failure.yml`
warning message
-
leanprover-community/leanprover-community.github.io#787:
update `tags_and_branches.md` documentation

🤖 Prepared with Claude Code

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant