feat: verbose make targets, separate bump from release, tag-triggered publish (#17)

- Remove @ prefix from convenience targets (version, bump-*, release)
  so commands are printed, teaching users the underlying operations
- Separate bump from release: make release no longer bumps, run
  make bump-patch/minor/major first
- Change publish workflow trigger from release:published to push:tags:v*
- Add release job to auto-create GitHub Release with generated notes
- Update RELEASE.md and README.md to reflect new workflow

Author: smorin

.github/workflows/publish.yml

@@ -1,11 +1,12 @@
 name: Publish to PyPI
 
 on:
-  release:
-    types: [published]
+  push:
+    tags:
+      - "v*"
 
 permissions:
-  contents: read
+  contents: write
   id-token: write
 
 jobs:
@@ -50,3 +51,14 @@ jobs:
 
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
+
+  release:
+    needs: publish
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Create GitHub Release
+        run: gh release create "${{ github.ref_name }}" --generate-notes
+        env:
+          GH_TOKEN: ${{ github.token }}

Makefile

@@ -29,28 +29,26 @@ clean: ## Remove build artifacts
 	find . -type f -name '*.pyc' -delete 2>/dev/null || true
 
 version: ## Show current version
-	@uv run python -c "from importlib.metadata import version; print(version('worktreeflow'))"
+	uv run python -c "from importlib.metadata import version; print(version('worktreeflow'))"
 
 bump-patch: ## Bump patch version (e.g. 0.3.0 → 0.3.1)
-	@uv run python scripts/bump_version.py patch
+	uv run python scripts/bump_version.py patch
 
 bump-minor: ## Bump minor version (e.g. 0.3.0 → 0.4.0)
-	@uv run python scripts/bump_version.py minor
+	uv run python scripts/bump_version.py minor
 
 bump-major: ## Bump major version (e.g. 0.3.0 → 1.0.0)
-	@uv run python scripts/bump_version.py major
-
-release: ## Bump, sync, commit, tag (usage: make release BUMP=patch)
-	@BUMP=$${BUMP:-patch}; \
-	$(MAKE) bump-$$BUMP; \
-	uv sync; \
-	VERSION=$$(uv run python -c "from importlib.metadata import version; print(version('worktreeflow'))"); \
-	git add pyproject.toml; \
-	git commit -m "chore: bump version to $$VERSION"; \
-	git tag "v$$VERSION"; \
-	echo ""; \
-	echo "Created tag v$$VERSION."; \
-	echo "Run 'git push && git push --tags' to publish."
+	uv run python scripts/bump_version.py major
+
+release: ## Sync, commit, tag (run make bump-* first)
+	uv sync
+	$(eval VERSION := $(shell uv run python -c "from importlib.metadata import version; print(version('worktreeflow'))"))
+	git add pyproject.toml
+	git commit -m "chore: bump version to $(VERSION)"
+	git tag "v$(VERSION)"
+	@echo ""
+	@echo "Created tag v$(VERSION)."
+	@echo "Run 'git push && git push --tags' to publish."
 
 completions-bash: ## Generate bash completions
 	_WTF_COMPLETE=bash_source uv run wtf

README.md

@@ -167,7 +167,7 @@ make version     # Show current version
 make bump-patch  # Bump patch version (0.3.0 → 0.3.1)
 make bump-minor  # Bump minor version (0.3.0 → 0.4.0)
 make bump-major  # Bump major version (0.3.0 → 1.0.0)
-make release     # Bump, commit, tag (usage: make release BUMP=minor)
+make release     # Sync, commit, tag (run make bump-* first)
 ```
 
 ### Shell Completions
@@ -196,7 +196,7 @@ Quick reference:
 ```bash
 make version       # Show current version
 make bump-patch    # Bump patch version
-make release       # Bump, commit, and tag (then push manually)
+make release       # Commit and tag (run bump-* first, then push)
 ```
 
 ### Dual Functionality

RELEASE.md

@@ -28,48 +28,47 @@ After bumping, run `uv sync` to refresh the editable install so `wtf version` re
 
 ## Full Release
 
-The `make release` target automates: bump → sync → commit → tag.
+First bump the version, then run `make release` to sync, commit, and tag:
 
 ```bash
-# Patch release (default)
-make release
+# 1. Bump version
+make bump-patch   # or bump-minor / bump-major
 
-# Minor release
-make release BUMP=minor
+# 2. Commit and tag
+make release
 
-# Major release
-make release BUMP=major
+# 3. Push (triggers CI → PyPI publish → GitHub Release)
+git push && git push --tags
 ```
 
-This will:
-1. Bump the version in `pyproject.toml`
-2. Run `uv sync` to update the local install
-3. Commit the version change
-4. Create a git tag (e.g., `v0.4.0`)
+`make release` will:
+1. Run `uv sync` to update the local install
+2. Commit the version change in `pyproject.toml`
+3. Create a git tag (e.g., `v0.4.0`)
 
-It does **not** push automatically. Review the commit and tag, then:
+It does **not** push automatically — review the commit and tag first.
 
-```bash
-git push && git push --tags
-```
+All make targets print the underlying commands they execute, so you can see exactly what's happening and learn the manual steps.
 
 ## Publishing to PyPI
 
 ### Automated (Recommended)
 
-Publishing is handled by GitHub Actions. The workflow (`.github/workflows/publish.yml`) triggers when a **GitHub Release** is published:
+Publishing is handled by GitHub Actions (`.github/workflows/publish.yml`). Pushing a version tag triggers the full pipeline automatically:
 
-1. Push the version bump and tag (see above)
-2. Go to [GitHub Releases](https://github.com/smorinlabs/worktreeflow/releases)
-3. Click **Draft a new release**
-4. Select the tag you just pushed (e.g., `v0.4.0`)
-5. Add release notes
-6. Click **Publish release**
+```bash
+make bump-patch              # bump version
+make release                 # sync, commit, tag
+git push && git push --tags  # triggers CI
+```
 
 The CI will automatically:
-- Run the test suite
-- Build the package with `uv build`
-- Publish to PyPI via OIDC (trusted publisher)
+1. Run the test suite
+2. Build the package with `uv build`
+3. Publish to PyPI via OIDC (trusted publisher)
+4. Create a GitHub Release with auto-generated notes
+
+No manual GitHub Release creation needed — it's all triggered by the tag push.
 
 ### Manual
 
@@ -90,4 +89,3 @@ uv publish  # requires PyPI API token
 - [ ] `wtf version` shows correct version
 - [ ] Changes committed and tagged (`make release`)
 - [ ] Pushed to remote (`git push && git push --tags`)
-- [ ] GitHub Release created