feat(release): generate structured changelogs for all release types (gptme#1550)

* feat(release): generate structured changelogs for all release types

The scheduled-release CI workflow and Makefile release targets now use
build_changelog.py to produce categorized changelogs (Features, Fixes,
Contributors) instead of GitHub's flat auto-generated notes.

Range selection: dev releases use since-last-tag (incremental), stable
releases use since-last-stable (cumulative).

Closes gptme#1532

* fix(release): use stable-only range for stable release changelogs in Makefile

When generating changelogs for patch/minor releases, skip dev tags when
finding the previous version. This ensures stable release changelogs are
cumulative (e.g. v0.32.0 shows all changes since v0.31.0, not just since
the last dev release like v0.31.1.dev20260227).

Dev releases continue to use the immediately preceding tag (incremental behavior).

Addresses Greptile review finding on PR gptme#1550.

---------

Co-authored-by: TimeToBuildBob <TimeToBuildBob@users.noreply.github.com>

Author: TimeToBuildBob

.github/workflows/scheduled-release.yml

@@ -4,7 +4,8 @@ name: Scheduled Release
 # - Runs twice weekly (Mon + Thu at noon UTC) to create dev pre-releases
 # - Can be manually triggered for dev, patch, or minor releases
 # - Dev releases use `.devYYYYMMDD` suffix and are marked as pre-releases
-# - Stable releases (patch/minor) get full changelogs since last stable
+# - All releases get structured changelogs via build_changelog.py
+#   (dev: since last tag, stable: since last stable release)
 #
 # Scripts shared with `make release` / `make release-dev`:
 #   - scripts/bump_version.sh    — version bump, commit, tag
@@ -137,9 +138,39 @@ jobs:
           TYPE="${{ github.event.inputs.release_type || 'dev' }}"
           bash scripts/bump_version.sh --type "$TYPE"
 
+      - name: Generate changelog
+        run: |
+          # Download the shared changelog generator (same as `make dist/CHANGELOG.md`)
+          wget -q -O scripts/build_changelog.py \
+            https://raw.githubusercontent.com/ActivityWatch/activitywatch/master/scripts/build_changelog.py
+          chmod +x scripts/build_changelog.py
+          pip install -q requests
+
+          TAG="${{ steps.version.outputs.tag }}"
+          PRERELEASE="${{ steps.version.outputs.prerelease }}"
+
+          # Use appropriate range: dev→since last tag, stable→since last stable
+          if [ "$PRERELEASE" = "true" ]; then
+            SINCE="${{ steps.version.outputs.last_tag }}"
+          else
+            SINCE="${{ steps.version.outputs.last_stable }}"
+          fi
+
+          echo "Generating changelog: ${SINCE}...${TAG}"
+          python3 scripts/build_changelog.py \
+            --range "${SINCE}...${TAG}" \
+            --project-title gptme \
+            --org gptme \
+            --repo gptme \
+            --output /tmp/changelog.md \
+            --add-version-header
+
+          echo "--- Generated changelog preview ---"
+          head -50 /tmp/changelog.md
+
       - name: Publish release
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}
         run: |
-          bash scripts/publish_release.sh --publish-pypi
+          bash scripts/publish_release.sh --publish-pypi --notes-file /tmp/changelog.md

Makefile

@@ -141,15 +141,18 @@ version-auto:  ## Non-interactive version bump (TYPE=dev|patch|minor)
 
 release-dev:  ## Create a dev pre-release (.devYYYYMMDD) — same as CI scheduled release
 	@./scripts/bump_version.sh --type dev
-	@./scripts/publish_release.sh
+	@make dist/CHANGELOG.md
+	@./scripts/publish_release.sh --notes-file dist/CHANGELOG.md
 
 release-patch:  ## Create a stable patch release (x.y.Z+1)
 	@./scripts/bump_version.sh --type patch
-	@./scripts/publish_release.sh --publish-pypi
+	@make dist/CHANGELOG.md
+	@./scripts/publish_release.sh --publish-pypi --notes-file dist/CHANGELOG.md
 
 release-minor:  ## Create a stable minor release (x.Y+1.0)
 	@./scripts/bump_version.sh --type minor
-	@./scripts/publish_release.sh --publish-pypi
+	@make dist/CHANGELOG.md
+	@./scripts/publish_release.sh --publish-pypi --notes-file dist/CHANGELOG.md
 
 ./scripts/build_changelog.py:
 	wget -O $@ https://raw.githubusercontent.com/ActivityWatch/activitywatch/master/scripts/build_changelog.py
@@ -171,8 +174,14 @@ dist/CHANGELOG.md: ./scripts/build_changelog.py
 docs/releases/%.md: ./scripts/build_changelog.py
 	@mkdir -p docs/changelog
 	# version is the % in the target
+	# For stable releases (no .dev suffix), find the previous stable tag to get a cumulative changelog.
+	# For dev releases, use the immediately preceding tag (incremental).
 	VERSION=$* && \
-	PREV_VERSION=$$(./scripts/get-last-version.sh $${VERSION}) && \
+	if echo "$$VERSION" | grep -qE '\.dev[0-9]+'; then \
+		PREV_VERSION=$$(./scripts/get-last-version.sh $${VERSION}); \
+	else \
+		PREV_VERSION=$$(git tag --sort=-version:refname | grep -v '\.dev' | grep -A 1 "$$VERSION" | tail -n 1); \
+	fi && \
 		./scripts/build_changelog.py --range $${PREV_VERSION}...$${VERSION} --project-title gptme --org gptme --repo gptme --output $@ --add-version-header
 
 release: version dist/CHANGELOG.md  ## Release new version (interactive)