# 🚀 Release v0.3.0 — Creation Instructions
**Klaus Proxy Local v0.3.0 is ready for release.**
---
## ✅ Pre-Release Checklist
- ✅ All tests passing (465/465)
- ✅ Code reviewed and merged
- ✅ Documentation complete (6 guides, 50+ pages)
- ✅ Commits pushed to main
- ✅ Version bumped to 0.3.0 (pyproject.toml)
- ✅ Release notes prepared (RELEASE_v0.3.0_NOTES.md)
---
## 🎯 Two Ways to Create Release
### Option 1: Automated (using GitHub CLI)
```bash
# Make script executable (already done)
chmod +x CREATE_RELEASE.sh
# Run it
./CREATE_RELEASE.sh
# Or manually with gh:
gh release create v0.3.0 \
--title "Klaus Proxy Local v0.3.0 — Complete Audit & Auto-Fix System" \
--notes-file RELEASE_v0.3.0_NOTES.md
```
### Option 2: Manual (via GitHub Web UI)
**Steps:**
1. Go to: https://github.com/Ka0s-Klaus/klaus-proxy-local/releases
2. Click **"Draft a new release"** (top-right)
3. Fill in the form:
**Tag version:**
```
v0.3.0
```
**Release title:**
```
Klaus Proxy Local v0.3.0 — Complete Audit & Auto-Fix System
```
**Release notes:**
- Copy content from: `RELEASE_v0.3.0_NOTES.md` in this repo
4. **Optional:** Upload release artifacts (wheels, source tar.gz)
5. Click **"Publish release"**
---
## 📋 Release Notes Summary
```
✨ Major Features:
• Production-ready test suite (465/465 ✅)
• Multi-mode audit system (4 analysis modes)
• Automated report generation
• Automatic leak detection & fixing
• Complete documentation (6 guides)
📊 Audit Results:
• 9,053 payloads analyzed
• 260 vault entries (259 + 1 auto-fixed)
• 1 leak detected and corrected
• 100% pseudonymization working
🔒 Security:
• Auto-SALT generation
• Vault protection (0o600)
• Fail-closed design
• Zero-config setup
```
---
## 🔄 What to Do After Release
### 1. Verify Release Created
```bash
gh release list | head -5
# Should show: v0.3.0 | Klaus Proxy Local v0.3.0...
```
### 2. Publish to PyPI (Optional)
```bash
# Build distribution
python -m build
# Upload to PyPI
python -m twine upload dist/Klaus_proxy_local-0.3.0*
# Or let GitHub Actions handle it (if configured)
```
### 3. Update Channels
- Post to GitHub Discussions
- Update project website/blog
- Announce in Slack/Teams (if applicable)
### 4. Start v0.4.0 Planning
```bash
# Create branch for next version
git checkout -b feat/v0.4.0
# Update version in pyproject.toml
# Add to CHANGELOG
# Commit: "chore: bump version to 0.4.0-dev"
```
---
## 📝 Files Involved in Release
```
✅ pyproject.toml (version = "0.3.0")
✅ RELEASE_v0.3.0_NOTES.md (Detailed release notes)
✅ RELEASE_INSTRUCTIONS.md (This file)
✅ CREATE_RELEASE.sh (Automated script)
Generated artifacts (not in repo):
dist/Klaus_proxy_local-0.3.0-py3-none-any.whl
dist/Klaus_proxy_local-0.3.0.tar.gz
```
---
## 🎯 Release Highlights for Marketing
### For README/Website
```markdown
## Latest Release: v0.3.0
**Complete audit and automatic leak fixing system for Anthropic API payloads.**
- ✅ 465/465 tests passing
- ✅ 9,053 payloads audited
- ✅ 4 new audit modes
- ✅ Automated report generation
- ✅ Automatic leak detection & fixing
- ✅ 6 comprehensive guides
[Download v0.3.0](https://github.com/Ka0s-Klaus/klaus-proxy-local/releases/tag/v0.3.0)
```
### For Changelog
```
## [0.3.0] - 2026-09-05
### Added
- Multi-mode audit system (stats, find-leaks, patterns, review)
- Automated audit report generation with timestamping
- Automatic leak detection and vault updating
- Complete workflow orchestration (generate → detect → fix → verify)
- Auto-SALT generation in launcher
- 6 new comprehensive guides (50+ pages)
### Fixed
- Fixed 23 failing tests (442 → 465 passing)
- Fixed README version badge (0.2.0 → 0.3.0)
- Fixed test assertions and documentation references
### Security
- Deterministic hashing for pseudonyms
- Vault protection with 0o600 permissions
- SALT auto-generation and management
- Fail-closed design on pseudonymization failures
```
---
## ✅ Release Verification Steps
After release is live:
```bash
# Verify tag exists
git tag | grep v0.3.0
# Verify release on GitHub
gh release view v0.3.0
# Output should show: ✓ v0.3.0 | Klaus Proxy Local v0.3.0...
# Verify PyPI (if published)
pip index versions Klaus-proxy-local
# Should show: 0.3.0 as latest
# Verify GitHub release page
open https://github.com/Ka0s-Klaus/klaus-proxy-local/releases/tag/v0.3.0
```
---
## 🔗 Important Links
- **Release Page:** https://github.com/Ka0s-Klaus/klaus-proxy-local/releases/tag/v0.3.0
- **PyPI Package:** https://pypi.org/project/Klaus-proxy-local/
- **Repository:** https://github.com/Ka0s-Klaus/klaus-proxy-local
- **Issues:** https://github.com/Ka0s-Klaus/klaus-proxy-local/issues
- **Discussions:** https://github.com/Ka0s-Klaus/klaus-proxy-local/discussions
---
## 🎉 Summary
**v0.3.0 is production-ready with:**
- Complete audit system
- Automated leak detection & fixing
- Comprehensive documentation
- All tests passing
- Zero-config setup
**Ready to announce!** 🚀