Replace git-cliff with Release-Notes.md changelog generation #6

Closed
opened 2026-07-10 01:59:06 +00:00 by coding-agent-marvin8 · 1 comment
coding-agent-marvin8 commented 2026-07-10 01:59:06 +00:00 (Migrated from codeberg.org)

The current release flow uses git-cliff and cliff.toml to generate CHANGELOG.md entries from commit messages. This should be replaced with a more user-friendly approach that extracts bullet points from Release-Notes.md (a taibai thread), matching the approach used in longwei.

Scope:

  • Add Release-Notes.md and Release-Notes.md.template (taibai thread format)
  • Update justfile: release recipe reads bullets from Release-Notes.md; new fediverse-post and fediverse-validate recipes
  • Remove git-cliff dev dependency and cliff.toml
  • Update CLAUDE.md with Release Process and Release Notes sections
The current release flow uses git-cliff and cliff.toml to generate CHANGELOG.md entries from commit messages. This should be replaced with a more user-friendly approach that extracts bullet points from Release-Notes.md (a taibai thread), matching the approach used in longwei. Scope: - Add Release-Notes.md and Release-Notes.md.template (taibai thread format) - Update justfile: release recipe reads bullets from Release-Notes.md; new fediverse-post and fediverse-validate recipes - Remove git-cliff dev dependency and cliff.toml - Update CLAUDE.md with Release Process and Release Notes sections
coding-agent-marvin8 commented 2026-07-10 01:59:27 +00:00 (Migrated from codeberg.org)

Plan of attack:

Key files:

  • Create: Release-Notes.md, Release-Notes.md.template
  • Modify: justfile (replace git-cliff release recipe; add fediverse-post, fediverse-validate)
  • Modify: pyproject.toml (remove git-cliff dev dep), run uv sync
  • Delete: cliff.toml
  • Modify: CLAUDE.md (add Release Process + Release Notes sections)

Approach:
Model the justfile release recipe on longwei: extract bullets from Release-Notes.md with awk, build CHANGELOG entry with bullets + ungrouped commit list (each commit links to https://codeberg.org/marvin8/kokopelli/commit/HASH). fediverse-post defaults to the 'announce' taibai profile and resets Release-Notes.md from template after posting.

Release-Notes.md.template uses the taibai thread format with kokopelli-specific footer (PyPI install, Codeberg link).

Commits:

  • 📝 add Release-Notes.md and template
  • 🔧 replace git-cliff with Release-Notes.md changelog generation
  • 📝 update CLAUDE.md with release process and notes format
Plan of attack: **Key files:** - Create: Release-Notes.md, Release-Notes.md.template - Modify: justfile (replace git-cliff release recipe; add fediverse-post, fediverse-validate) - Modify: pyproject.toml (remove git-cliff dev dep), run uv sync - Delete: cliff.toml - Modify: CLAUDE.md (add Release Process + Release Notes sections) **Approach:** Model the justfile release recipe on longwei: extract bullets from Release-Notes.md with awk, build CHANGELOG entry with bullets + ungrouped commit list (each commit links to https://codeberg.org/marvin8/kokopelli/commit/HASH). fediverse-post defaults to the 'announce' taibai profile and resets Release-Notes.md from template after posting. Release-Notes.md.template uses the taibai thread format with kokopelli-specific footer (PyPI install, Codeberg link). **Commits:** - :memo: add Release-Notes.md and template - :wrench: replace git-cliff with Release-Notes.md changelog generation - :memo: update CLAUDE.md with release process and notes format
Sign in to join this conversation.
No labels
No milestone
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
marvin8/kokopelli#6
No description provided.