Skip to content

Commit c634699

Browse files
anIcedAntFAanIcedAntFA
committed
🔖 chore(release): bump version to v1.3.0-beta.2
- Update CHANGELOG with beta.2 changes - Fix config command error handling and formatting - Add emojis to config list output - Improve documentation and testing scripts
1 parent 266ec1a commit c634699

File tree

4 files changed

+314
-1
lines changed

4 files changed

+314
-1
lines changed

‎.github/RELEASE_CHECKLIST_v1.3.0-beta.2.md‎

Lines changed: 132 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,132 @@
1+
# Release Checklist: v1.3.0-beta.2
2+
3+
**Date:** 2026-01-19
4+
**Type:** Pre-release (Beta)
5+
6+
---
7+
8+
## ✅ Completed Steps
9+
10+
- [x] Check changes since v1.3.0-beta.1
11+
- [x] Update CHANGELOG.md with beta.2 section
12+
- [x] Bump version in cmd/gohome/cmd/root.go to v1.3.0-beta.2
13+
- [x] Create release commit: `🔖 chore(release): bump version to v1.3.0-beta.2`
14+
- [x] Create annotated git tag: `v1.3.0-beta.2`
15+
- [x] Create release notes: `.github/RELEASE_NOTES_v1.3.0-beta.2.md`
16+
17+
---
18+
19+
## 🚀 Next Steps (To Deploy)
20+
21+
### 1. Push to GitHub
22+
23+
```bash
24+
# Push commits
25+
git push origin main
26+
27+
# Push tag
28+
git push origin v1.3.0-beta.2
29+
```
30+
31+
### 2. Create GitHub Pre-release
32+
33+
Go to: https://github.com/anIcedAntFA/gohome/releases/new
34+
35+
- **Tag:** `v1.3.0-beta.2`
36+
- **Title:** `v1.3.0-beta.2 - Bug Fixes & Documentation`
37+
- **Description:** Copy from `.github/RELEASE_NOTES_v1.3.0-beta.2.md`
38+
- **Pre-release:** ✅ Check "This is a pre-release"
39+
- **Publish**
40+
41+
### 3. Verify Build
42+
43+
- Wait for GitHub Actions to complete
44+
- Check release assets are built for all platforms:
45+
- Linux (amd64, arm64)
46+
- macOS (amd64, arm64)
47+
- Windows (amd64, arm64)
48+
49+
### 4. Test Installation
50+
51+
```bash
52+
# Test script installation
53+
curl -sSL https://raw.githubusercontent.com/anIcedAntFA/gohome/v1.3.0-beta.2/scripts/install.sh | bash -s -- --beta
54+
55+
# Verify version
56+
gohome version
57+
58+
# Run beta testing script
59+
bash scripts/test-beta-release.sh
60+
```
61+
62+
---
63+
64+
## 📋 Changes Summary
65+
66+
### Since v1.3.0-beta.1
67+
68+
**Commits:**
69+
- `266ec1a` - docs(docs,readme): update documents and assets
70+
- `7bef388` - fix(cmd): add emojis to config list output and fix error consistency
71+
- `1425904` - docs(changelog,scripts): update changelog, add script test beta version
72+
- `1fc3759` - chore(release): bump version to v1.3.0-beta.2 ← **Release commit**
73+
74+
**Key Improvements:**
75+
- ✅ Fixed config command error handling
76+
- ✅ Added emojis to config list output
77+
- ✅ Updated documentation
78+
- ✅ Added beta testing script
79+
80+
---
81+
82+
## 🔍 Pre-Push Verification
83+
84+
Run these checks before pushing:
85+
86+
```bash
87+
# Verify tag exists
88+
git tag | grep v1.3.0-beta.2
89+
90+
# Verify commit message
91+
git log -1 --pretty=format:"%s"
92+
93+
# Verify changelog updated
94+
git diff v1.3.0-beta.1 CHANGELOG.md
95+
96+
# Verify version bump
97+
grep -n "v1.3.0-beta.2" cmd/gohome/cmd/root.go
98+
99+
# Build locally
100+
make build
101+
./bin/gohome version
102+
```
103+
104+
---
105+
106+
## 📝 Notes
107+
108+
- Release notes template created at: `.github/RELEASE_NOTES_v1.3.0-beta.2.md`
109+
- This is a **maintenance release** with no breaking changes
110+
- Safe to deploy immediately after testing
111+
- Users can upgrade from beta.1 without migration
112+
113+
---
114+
115+
## 🎯 Success Criteria
116+
117+
- [ ] GitHub release published with pre-release flag
118+
- [ ] All platform binaries built successfully
119+
- [ ] Installation script works with `--beta` flag
120+
- [ ] Version command shows `v1.3.0-beta.2`
121+
- [ ] No breaking changes reported
122+
123+
---
124+
125+
## 🐛 Rollback Plan (If Needed)
126+
127+
If issues are discovered:
128+
129+
1. Do NOT delete the tag
130+
2. Create a new beta.3 with fixes
131+
3. Update release notes to mark beta.2 as deprecated
132+
4. Reference beta.2 issues in beta.3 changelog

‎.github/RELEASE_NOTES_v1.3.0-beta.2.md‎

Lines changed: 157 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,157 @@
1+
# Release Notes: v1.3.0-beta.2
2+
3+
**Release Date:** January 19, 2026
4+
**Type:** Pre-release (Beta)
5+
**Previous Version:** v1.3.0-beta.1
6+
7+
---
8+
9+
## 🐛 Bug Fixes & Improvements
10+
11+
### Config Command Error Handling
12+
13+
- **Consistent Error Formatting**: All commands now show errors with ❌ prefix for better UX
14+
- **Fixed**: `gohome config <unknown>` previously showed only help text, now displays proper error message
15+
- **Improved**: Added `SilenceErrors`/`SilenceUsage` flags for better error control
16+
- **Enhanced**: Args validation added to catch unknown subcommands early
17+
18+
**Before:**
19+
```bash
20+
gohome report 123 → ❌ Error: invalid argument "123"
21+
gohome config 123 → Shows help only (inconsistent)
22+
```
23+
24+
**After:**
25+
```bash
26+
gohome report 123 → ❌ Error: invalid argument "123"
27+
gohome config 123 → ❌ Error: invalid argument "123" (consistent!)
28+
```
29+
30+
### Config List Output Enhancement
31+
32+
- ⚙️ Added emoji to 'Current Configuration' header for better visibility
33+
- 📄 Added emoji to config file path display
34+
- 🧹 Removed unused table options (nature/tech type) to reduce clutter
35+
36+
---
37+
38+
## 📚 Documentation Updates
39+
40+
- ✅ Added comprehensive **release checklist template** (`.github/RELEASE_CHECKLIST_CURRENT.md`)
41+
- ✅ Added **release notes template** for v1.3.0-beta.1 as reference
42+
- ✅ Updated **README** with improved examples and clarity
43+
- ✅ Updated **CLI_GUIDE** with latest command usage patterns
44+
- ✅ Added **beta release testing script** (`scripts/test-beta-release.sh`) for QA automation
45+
- ✅ Refreshed **quickstart demo** with better visual presentation
46+
47+
---
48+
49+
## 🔄 What Changed Since v1.3.0-beta.1
50+
51+
### Commits in This Release
52+
53+
1. **📝 docs(docs,readme)**: Update documents and assets
54+
2. **🐛 fix(cmd)**: Add emojis to config list output and fix error consistency
55+
3. **📝 docs(changelog,scripts)**: Update changelog, add script test beta version
56+
57+
### Files Modified
58+
59+
- `.github/RELEASE_CHECKLIST_CURRENT.md` (new)
60+
- `.github/RELEASE_NOTES_v1.3.0-beta.1.md` (new)
61+
- `CHANGELOG.md`
62+
- `README.md`
63+
- `cmd/gohome/cmd/config.go`
64+
- `cmd/gohome/cmd/report.go`
65+
- `cmd/gohome/cmd/root.go`
66+
- `docs/CLI_GUIDE.md`
67+
- `scripts/test-beta-release.sh` (new)
68+
69+
---
70+
71+
## 🧪 Testing
72+
73+
### Manual Testing
74+
75+
Run the beta release testing script:
76+
77+
```bash
78+
bash scripts/test-beta-release.sh
79+
```
80+
81+
### Key Test Cases
82+
83+
1. ✅ Config command error handling consistency
84+
2. ✅ Config list output with emojis
85+
3. ✅ Report command error validation
86+
4. ✅ Version display: `gohome version`
87+
88+
---
89+
90+
## 📦 Installation
91+
92+
### Via Script (Recommended)
93+
94+
```bash
95+
curl -sSL https://raw.githubusercontent.com/anIcedAntFA/gohome/v1.3.0-beta.2/scripts/install.sh | bash -s -- --beta
96+
```
97+
98+
### Via Go Install
99+
100+
```bash
101+
go install github.com/anIcedAntFA/gohome/cmd/gohome@v1.3.0-beta.2
102+
```
103+
104+
### From Release Assets
105+
106+
Download the pre-built binary for your platform from the Assets section below.
107+
108+
---
109+
110+
## 🚨 Breaking Changes
111+
112+
**None.** This is a maintenance release with bug fixes and documentation improvements.
113+
114+
---
115+
116+
## 🐛 Known Issues
117+
118+
- None reported for this beta release
119+
120+
---
121+
122+
## 📝 Migration from v1.3.0-beta.1
123+
124+
No migration required. This is a drop-in replacement with:
125+
- ✅ Backward compatible CLI
126+
- ✅ Same config file format
127+
- ✅ Identical command structure
128+
129+
Simply update to beta.2 using any installation method above.
130+
131+
---
132+
133+
## 🤝 Feedback
134+
135+
This is a **pre-release** for testing purposes. Please report any issues:
136+
137+
- 🐛 [Report Bugs](https://github.com/anIcedAntFA/gohome/issues/new?labels=bug)
138+
- 💡 [Request Features](https://github.com/anIcedAntFA/gohome/issues/new?labels=enhancement)
139+
- 💬 [Discussions](https://github.com/anIcedAntFA/gohome/discussions)
140+
141+
---
142+
143+
## 📅 Roadmap to v1.3.0 Stable
144+
145+
- [x] Beta 1: Core Cobra/Viper migration
146+
- [x] **Beta 2: Bug fixes and documentation** ← **You are here**
147+
- [ ] Beta 3: Additional testing and polish (if needed)
148+
- [ ] RC1: Release candidate with final testing
149+
- [ ] v1.3.0: Stable release
150+
151+
---
152+
153+
## 🙏 Credits
154+
155+
Thanks to all contributors and testers helping to make gohome better!
156+
157+
**Full Changelog**: https://github.com/anIcedAntFA/gohome/compare/v1.3.0-beta.1...v1.3.0-beta.2

‎CHANGELOG.md‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
77

88
## [Unreleased]
99

10+
## [1.3.0-beta.2] - 2026-01-19
11+
12+
### Fixed
13+
14+
- **Config Command Error Handling**
15+
- Add consistent error formatting with ❌ prefix across all commands
16+
- `gohome config <unknown>` now shows proper error instead of just help
17+
- Add `SilenceErrors`/`SilenceUsage` to both config and report commands
18+
- Add Args validation to config command for unknown subcommands
19+
20+
- **Config List Output Enhancement**
21+
- Add ⚙️ emoji to 'Current Configuration' header
22+
- Add 📄 emoji to config file path display
23+
- Remove unused table options (nature and tech type)
24+
25+
### Documentation
26+
27+
- Add comprehensive release checklist template (`.github/RELEASE_CHECKLIST_CURRENT.md`)
28+
- Add release notes template for v1.3.0-beta.1
29+
- Update README with improved examples
30+
- Update CLI_GUIDE with latest command usage
31+
- Add beta release testing script (`scripts/test-beta-release.sh`)
32+
- Update quickstart demo with better visuals
33+
1034
## [1.3.0-beta.1] - 2026-01-18
1135

1236
### Added

‎cmd/gohome/cmd/root.go‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ var rootCmd = &cobra.Command{
3838
gohome -w 1 # Last week's commits
3939
gohome -f table # Table format
4040
gohome config list # View configuration`,
41-
Version: "v1.3.0-beta.1",
41+
Version: "v1.3.0-beta.2",
4242
SilenceErrors: true, // We handle error formatting ourselves
4343
SilenceUsage: false, // Show usage on errors (but only once)
4444
}

0 commit comments

Comments
 (0)