Skip to content

docs(release): align runbook with aggregator-reactor, guard, and release.yml#74

Merged
DemchaAV merged 1 commit into
developfrom
docs/release-runbook-reactor-align
May 29, 2026
Merged

docs(release): align runbook with aggregator-reactor, guard, and release.yml#74
DemchaAV merged 1 commit into
developfrom
docs/release-runbook-reactor-align

Conversation

@DemchaAV
Copy link
Copy Markdown
Owner

Summary

Aligns docs/contributing/release-process.md with the v1.6.5 release-plumbing changes (#69#73) so the runbook prose no longer contradicts the tooling.

What changed

  • README pinning (was a contradiction). The old "keep README at the previous tag, flip post-release" model now fails VersionConsistencyGuardTest. The runbook now states the README install snippets flip in the release commit (cut-release.ps1), enforced by the guard (README == pom).
  • Version sites. Documents the four lockstep sites (library pom, aggregator, inherited examples/benchmarks parents) instead of "3 POMs"; the script bumps all four + README in one pass.
  • GitHub Release. Now created automatically by release.yml on tag push; manual gh release create is the documented fallback.
  • Guard gate. Adds VersionConsistencyGuardTest to the §0.B pre-release guard suite; §0.D rewritten for the reactor.
  • Lessons. New v1.6.5 entry superseding the v1.6.0 <graphcompose.version> property note.

Skill sync (out of repo)

The graphcompose-release-engineer skill was aligned in lockstep in both local copies (~/.claude + ~/.codex), kept byte-identical. Not part of this PR — local config, not tracked.

Test plan

  • CanonicalSurfaceGuardTest + DocumentationCoverageTest green (doc edits introduce no legacy tokens)
  • Skill copies diff-clean (byte-identical)

…ase.yml

Updates the release runbook to match the v1.6.5 plumbing (#69 #70 #71 #72 #73):

- README install snippets now flip in the release commit (cut-release.ps1),
  enforced by VersionConsistencyGuardTest — replaces the old "stay pinned to
  the previous tag, flip post-release" model that contradicted the guard.
- Version lives in four sites (library pom, aggregator, inherited
  examples/benchmarks parents); the script bumps all four + README in one pass.
- GitHub Release is created automatically by release.yml on tag push; the
  manual gh release create is now the documented fallback.
- Adds VersionConsistencyGuardTest to the pre-release guard-suite gate, and a
  v1.6.5 lesson that supersedes the v1.6.0 graphcompose.version property note.

The graphcompose-release-engineer skill (local config, Claude + Codex copies)
was aligned in lockstep.
@DemchaAV DemchaAV merged commit 4fdf2cb into develop May 29, 2026
9 checks passed
@DemchaAV DemchaAV deleted the docs/release-runbook-reactor-align branch May 29, 2026 08:48
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