ctx-release-notes

name	_ctx-release-notes
description	Generate release notes for dist/RELEASE_NOTES.md. Use when preparing a release or when hack/release.sh needs release notes.

Generate release notes for the next release of Context CLI.

Before Writing

1. "Are there commits since the last tag?" If HEAD equals the last tag, there is nothing to release.
2. "Does VERSION match the intended release?" If VERSION still shows the previous version, ask the user to update it first.

When to Use

• Before running hack/release.sh (it requires dist/RELEASE_NOTES.md)
• When the user asks to prepare or draft release notes

When NOT to Use

• For blog posts about a release (use the blog changelog skill if installed)
• When no commits exist since the last tag

Process

1. Read version and find baseline:

cat VERSION
# Use the latest tag globally, not ancestry-based git describe
# (git describe follows reachability and misses tags on other branches)
git tag --sort=-v:refname | head -1

2. Gather commits since last tag (filter out noise):

# Substantive commits (skip "docs." and "minor" one-liners)
git log <tag>..HEAD --oneline --no-merges \
  | grep -v "^[a-f0-9]* docs\.$" \
  | grep -v "^[a-f0-9]* Doc update\.$" \
  | grep -v "^[a-f0-9]* minor"


git diff -- <tag>..HEAD |  -5


git  <tag>..HEAD --oneline --no-merges -- 


git  <tag>..HEAD --oneline --no-merges -- 


git  <tag>..HEAD --oneline --no-merges --