Release

Cut a release from the trunk and produce plain-English patch notes. Trunk-based flow: master/main is the source of truth, releases are tags cut from the trunk, no develop/staging promotion chain. Staging and production are environments driven by CI and tags.

Reads commit history, derives the next semantic version, writes patch notes, then — after confirmation — tags the trunk and publishes a GitHub release. Never rewrites history or tags a dirty or unsynced trunk.

Contract

Inputs:

• A git repository with a remote and a default/trunk branch (auto-detected)
• Optional bump: patch / minor / major, or an explicit version vX.Y.Z
• Optional mode: notes (generate patch notes only, cut nothing) or the default (notes + tag + GitHub release)
• Optional commit window for notes (since <tag>, 7d, from <date> to <date>); defaults to "since the last release tag"

Outputs: