Merge pull request #38 from codesoda/feat/setup-steps

feat: setup steps, optional test name, changelog (v0.4.0)

Author: codesoda

.github/workflows/release.yml

@@ -85,14 +85,35 @@ jobs:
           cd artifacts
           sha256sum *.tar.gz > checksums-sha256.txt
 
+      - name: Extract changelog for release
+        id: changelog
+        run: |
+          tag="${GITHUB_REF#refs/tags/}"
+          version="${tag#v}"
+          # Extract the section between this version's heading and the next heading
+          notes=$(awk -v ver="$version" '
+            /^## \[/ {
+              if (found) exit
+              if ($0 ~ "\\[" ver "\\]") found=1; next
+            }
+            found { print }
+          ' CHANGELOG.md)
+          # Fail if we got nothing — forces you to update CHANGELOG.md before tagging
+          if [ -z "$notes" ]; then
+            echo "::error::No CHANGELOG.md entry found for version ${version}"
+            exit 1
+          fi
+          # Write to file to avoid quoting issues
+          echo "$notes" > release-notes.md
+
       - name: Create GitHub Release
         env:
           GH_TOKEN: ${{ github.token }}
         run: |
           tag="${GITHUB_REF#refs/tags/}"
           gh release create "${tag}" \
             --title "${tag}" \
-            --generate-notes \
+            --notes-file release-notes.md \
             --draft \
             artifacts/*.tar.gz \
             artifacts/checksums-sha256.txt

CHANGELOG.md

@@ -0,0 +1,61 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.4.0] - 2026-04-08
+
+### Added
+
+- Self-update command with passive version checking
+- Setup steps (`setup = true`) that always run even when checkpoint-skipped and are not counted in pass/fail
+- Test file `name` field now defaults to the file stem when omitted (e.g. `login-flow.test.toml` defaults to "login-flow")
+- Changelog based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
+
+### Changed
+
+- Release workflow now extracts notes from CHANGELOG.md instead of auto-generating from commits
+
+## [0.3.1] - 2026-04-04
+
+### Added
+
+- Agent setup hint in CLI help output
+- Coding agent quick-start prompt in README and getting-started docs
+- Links to bugatti.dev in README and CLI help
+
+## [0.3.0] - 2026-04-04
+
+### Added
+
+- Documentation site, llms.txt, and docs CI workflow
+- Checkpoint save/restore and step skip with checkpoint support
+- `--from-checkpoint` CLI flag and timestamp-based run IDs
+- Checkpoint timeout configuration
+- Comprehensive docs for includes, shared test files, skip, and checkpoints
+- Node.js Express and Python Flask example projects
+- Release workflow and installer script
+- Readiness URL checks for long-lived services
+- CLI skip flags for harness commands (`--skip-setup`, `--skip-teardown`)
+- Long-lived subprocess management with readiness checks
+- Result marker parser, report generation, and run artifacts
+- Claude Code provider adapter
+- Test discovery, step expansion with cycle detection, and end-to-end pipeline
+- Config types and `bugatti.config.toml` parsing
+- Test file types and `*.test.toml` parsing
+- CLI scaffold with `bugatti test` subcommand
+
+### Fixed
+
+- Clippy warnings for release build
+- Docs deploy workflow triggers and Node version
+- Result marker parser handling of embedded markers
+
+[Unreleased]: https://github.com/codesoda/bugatti-cli/compare/v0.4.0...HEAD
+[0.4.0]: https://github.com/codesoda/bugatti-cli/compare/v0.3.1...v0.4.0
+[0.3.1]: https://github.com/codesoda/bugatti-cli/compare/v0.3.0...v0.3.1
+[0.3.0]: https://github.com/codesoda/bugatti-cli/releases/tag/v0.3.0

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "bugatti"
-version = "0.3.1"
+version = "0.4.0"
 edition = "2021"
 description = "A CLI for plain-English, agent-assisted local application verification using *.test.toml files"
 

Cargo.toml

@@ -373,6 +373,7 @@ readiness_url = "http://localhost:3000/health"
                 include_glob: None,
                 step_timeout_secs: None,
                 skip: false,
+                setup: false,
                 checkpoint: None,
             }],
         };