Skip to content

Add cookbook release workflows and runbook#307

Open
benjibc wants to merge 2 commits intomainfrom
cursor/cookbook-release-process-cad6
Open

Add cookbook release workflows and runbook#307
benjibc wants to merge 2 commits intomainfrom
cursor/cookbook-release-process-cad6

Conversation

@benjibc
Copy link
Copy Markdown
Contributor

@benjibc benjibc commented Apr 7, 2026

Summary

  • add a structured cookbook release record issue form and a maintainer-facing RELEASING.md
  • add candidate and stable tag GitHub Actions workflows plus shared tag/version validation helpers
  • make training-ci.yml reusable and link the new release process from the main contributor docs
  • generate draft release notes from candidate-tag history and publish the stable release with those candidate-generated notes
  • require a matching open cookbook-release issue with machine-readable metadata and an explicit go-approved: true gate before stable publish

Validation

  • python3 .github/scripts/cookbook_release.py github-output --tag v0.1.0-alpha.1 --kind candidate --output-file /tmp/candidate.out
  • python3 .github/scripts/cookbook_release.py assert-pyproject-version --tag v0.1.0-alpha.1 --kind candidate --pyproject training/pyproject.toml
  • python3 .github/scripts/cookbook_release.py github-output --tag v0.1.0 --kind final --output-file /tmp/final.out
  • python3 .github/scripts/cookbook_release.py assert-pyproject-version --tag v0.1.0 --kind final --pyproject training/pyproject.toml
  • python3 .github/scripts/cookbook_release.py draft-release-notes --version 0.1.0 --candidate-tag v0.1.0-alpha.1 --notes-file /tmp/candidate-release-notes.md --github-output /tmp/candidate-notes.out
  • python3 .github/scripts/cookbook_release.py assert-release-record --issue-body-file /tmp/release-record.md --version 0.1.0 --candidate-tag v0.1.0-alpha.1 --candidate-sha 9041b03 --github-output /tmp/release-record.out
  • "$(go env GOPATH)/bin/actionlint" .github/workflows/training-ci.yml .github/workflows/cookbook-release-candidate.yml .github/workflows/cookbook-release-publish.yml
Open in Web Open in Cursor 

cursoragent and others added 2 commits April 7, 2026 01:02
Co-authored-by: Yufei (Benny) Chen <benjibc@users.noreply.github.com>
Co-authored-by: Yufei (Benny) Chen <benjibc@users.noreply.github.com>
@benjibc benjibc marked this pull request as ready for review April 7, 2026 04:39
@benjibc benjibc requested a review from Hecate0821 April 7, 2026 04:59
python .github/scripts/cookbook_release.py draft-release-notes \
--version "${{ steps.tag.outputs.version }}" \
--candidate-tag "${GITHUB_REF_NAME}" \
--notes-file /tmp/candidate-release-notes.md \
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It was draft-release-notes.md?

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.

3 participants