release: v0.7.0 (#492)

Add structured release process with organized release notes and automation:
- Update GoReleaser config to v2 format
- Add release and release-dry-run targets to Makefile
- Create docs/release-notes directory structure
- Update CLAUDE.md with comprehensive release documentation
- Create v0.7.0 release notes highlighting public Go API
- Update VERSION to v0.7.0

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-authored-by: Claude <noreply@anthropic.com>

Author: busser

.goreleaser.yaml

@@ -1,19 +1,29 @@
+version: 2
+
 before:
   hooks:
     - go mod tidy
 
 builds:
   - id: murmur
     binary: murmur
-    env: [CGO_ENABLED=0]
-    goos: [linux, windows, darwin]
+    env:
+      - CGO_ENABLED=0
+    goos:
+      - linux
+      - windows
+      - darwin
     main: ./
   # The project was renamed "murmur" in May 2023. For backwards compatibility,
   # we continue to publish artifacts named "whisper".
   - id: whisper
     binary: whisper
-    env: [CGO_ENABLED=0]
-    goos: [linux, windows, darwin]
+    env:
+      - CGO_ENABLED=0
+    goos:
+      - linux
+      - windows
+      - darwin
     main: ./
 
 archives:
@@ -29,6 +39,9 @@ archives:
     format_overrides:
       - goos: windows
         format: zip
+    files:
+      - LICENSE
+      - README.md
   # The project was renamed "murmur" in May 2023. For backwards compatibility,
   # we continue to publish artifacts named "whisper".
   - id: whisper
@@ -43,6 +56,9 @@ archives:
     format_overrides:
       - goos: windows
         format: zip
+    files:
+      - LICENSE
+      - README.md
 
 dockers:
   - id: murmur
@@ -70,15 +86,16 @@ dockers:
 
 checksum:
   name_template: "checksums.txt"
+
 snapshot:
-  name_template: "{{ .Tag }}-next"
+  version_template: "{{ .Tag }}-next"
+
 changelog:
   sort: asc
   filters:
     exclude:
-      - "^chore:"
-      - '^chore\(deps\):'
       - "^docs:"
-      - '^fix\(deps\):'
-      - "^refactor:"
       - "^test:"
+
+release:
+  prerelease: auto

CLAUDE.md

@@ -52,4 +52,43 @@ Murmur is a secrets injection tool that fetches secrets from various cloud provi
 - Unit tests alongside source files (`*_test.go`)
 - E2E tests require `-tags=e2e` flag and real cloud credentials
 - Mock providers available for testing (`providers/mock/`, `providers/jsonmock/`)
-- Test data in `pkg/murmur/testdata/`
+- Test data in `pkg/murmur/testdata/`
+
+## Release Process
+
+Murmur uses a structured release process with organized release notes and automated tooling.
+
+### Release Commands
+
+- **Release Dry Run**: `make release-dry-run` - Test the complete release process without publishing
+- **Release**: `make release` - Create and publish a new release (requires `gh` CLI authentication)
+
+### Release Workflow
+
+1. **Prepare Release Notes**: Create `docs/release-notes/vX.Y.Z.md` with comprehensive release notes
+2. **Create Release Branch**: `git checkout -b release/vX.Y.Z`
+3. **Update VERSION**: Change `VERSION` file to target version (e.g., `v0.7.0`)
+4. **Commit and PR**: `git commit -m "release vX.Y.Z"` and open PR
+5. **Merge and Release**: After PR merge, checkout main, pull, and run `make release`
+
+### Release Notes Format
+
+Release notes in `docs/release-notes/` follow this structure:
+- **Emoji-prefixed sections** (🔥, 📋, 📚, 🔧)
+- **Brief descriptions** with **code examples**
+- **Links to documentation** for detailed information
+- **User-focused language** highlighting benefits
+
+### Automated Release Features
+
+- **Multi-platform binaries**: Linux, macOS, Windows (amd64, arm64, 386)
+- **Container images**: Automatic Docker image publishing to GitHub Container Registry
+- **GitHub integration**: Automated release creation with binaries and checksums
+- **Release notes**: Automatically included from `docs/release-notes/$(VERSION).md`
+- **Backward compatibility**: Continues publishing both `murmur` and `whisper` binaries
+
+### Dependencies
+
+- **GoReleaser v2**: Handles cross-compilation and publishing
+- **GitHub CLI (`gh`)**: Provides authentication token for releases
+- **Git tags**: Version tags trigger GoReleaser's release process

Makefile

@@ -56,4 +56,8 @@ build: fmt vet ## Build murmur binary.
 release: test ## Release a new version.
 	git tag -a "$(VERSION)" -m "$(VERSION)"
 	git push origin "$(VERSION)"
-	goreleaser release --clean
+	GITHUB_TOKEN=$$(gh auth token) goreleaser release --clean --release-notes=docs/release-notes/$(VERSION).md
+
+.PHONY: release-dry-run
+release-dry-run: ## Test the release process without publishing.
+	goreleaser release --snapshot --clean --skip=publish --release-notes=docs/release-notes/$(VERSION).md

VERSION

@@ -1 +1 @@
-v0.6.1
+v0.7.0

docs/release-notes/v0.7.0.md

@@ -0,0 +1,42 @@
+## 🔥 Public Go API Available
+
+Murmur's internals are now publicly accessible for Go library usage! All packages have been moved from `internal/` to `pkg/`, enabling other Go programs to import and use Murmur's components directly:
+
+```go
+import "github.com/busser/murmur/pkg/murmur"
+
+// Use the provider system directly
+providers := murmur.ProviderFactories
+awsProvider, _ := providers["awssm"]()
+
+// Access the secret resolution pipeline
+secrets := map[string]string{
+    "DB_PASSWORD": "awssm:my-database-secret",
+}
+resolved, _ := murmur.ResolveAll(secrets)
+```
+
+This enables powerful use cases like:
+- **Configuration-based secret resolution** instead of environment variables
+- **Custom secret injection workflows** in Go applications  
+- **Testing with mock providers** for unit tests
+- **Building custom secret management tools** on top of Murmur's provider system
+
+All providers (AWS, Azure, GCP, Scaleway), filters (JSONPath), and core resolution logic are now available for library usage.
+
+More details here: https://github.com/busser/murmur#go-library-usage
+
+## 📚 Enhanced release process
+
+Major improvements to Murmur's release tooling and documentation:
+
+- **Structured release notes** - Organized release notes in `docs/release-notes/`
+- **GoReleaser v2** - Updated configuration for modern release tooling  
+- **Release automation** - New `make release` and `make release-dry-run` targets
+- **Comprehensive documentation** - Detailed release process in CLAUDE.md
+
+This establishes a robust foundation for future Murmur releases with better organization and automation.
+
+## 🔧 Community contributions
+
+Special thanks to @christianking-gitlab for identifying the need for library usage and contributing the initial implementation approach. This release addresses that need comprehensively while providing maximum flexibility for Go developers.