docs: post-release sync — compatibility matrix, and a runbook that matches reality - #32
Merged
Conversation
Contributor
Signetry Reviewer — 🟡 Needs human reviewA human should decide — the required check is unknown. Deterministic gates (the authority)
FindingsNo issues found by the deterministic scanners. MergeA human should review and merge.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Brings the umbrella in line with the 2026-09-01 release train:
core v0.8.0,reviewer v0.3.0,eval v0.3.0,action v0.5.0,plugins v0.3.0,claude-code/codex/cursor/precommit v0.4.0,github-app v0.2.0.COMPATIBILITY.mdhad drifted four kernel releasesIt called 0.4.0 "(latest)" — the kernel is at
0.8.0, so0.5.x,0.6.0,0.7.0and
0.8.0were missing entirely from the table people read to learn what the platformcan do. The highlights for each are taken from
core's own changelog, not written frommemory.
The integration table had three separate problems:
github-appwas marked "(planned)" and has av0.2.0release.claude-code / -cursor / -codex / -precommitas "(planned)split from signetry-plugins" below the four rows describing the split that already
happened.
pluginswas marked "Superseded by the per-agent repos" — it is not; it shipstoday as
v0.3.0and is the bundle for people who want all four editors at once.It also only showed a minimum
signetry-core, which answers the wrong question. Everyintegration pins an exact tag, and a reader wanting to know what they get on install
could not find it. There are now two columns —
MinimumandPins— plus aReleasedcolumn, so a row whose pin lags is visible as a row to fix. That is the point of showing
it.
RELEASE.mdtold you to do an impossible stepsignetry-corewas removed from PyPI at0.5.4and has been installed from a git tagever since. Anyone following the runbook would look for a publish step that cannot
happen. It now says what actually happens (
release.ymlcuts the Release and attachesthe wheel) and why there is no PyPI step.
Three checklist items are added, each one a defect this release train actually hit:
install.sh's defaultVERSION— it had drifted to0.6.0, two releasesbehind, while the comment above it promised "the latest hardened tag". It escaped
every pin sweep because the version and the URL are on separate lines.
@vNtag —reviewer@v1was ten commits and two minorreleases stale, predating the rename, while the landing page advertises
@v1as theway to consume it.
@vNis validated for existence, never against the newest tag,so one that stops moving cannot be detected as stale.
check_versions.py— the landing page's install command is ahand-maintained claim, and a visitor who copies a stale pin installs a release behind.
Pins
core@v0.7.0→core@v0.8.0inINSTALL.md,INTEGRATIONS.md,LAUNCH.md, and the@v0.3.0exact-tag example inRELEASE.md→@v0.5.0, the action's actual release.