Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ Instead of managing git branches, commits, and PRs manually, SESS makes you thin

---

## Current Features (MVP1 - v0.2)
## Current Features (MVP1 - v0.2.1)

### Session Management

Expand Down
2 changes: 1 addition & 1 deletion docs/MVP1-SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## MVP1 Successfully Delivered

**Version:** 0.2.0 (MVP1)
**Version:** 0.2.1 (MVP1)
**Completion Date:** December 8, 2025
**Status:** All MVP1 features implemented and tested

Expand Down
16 changes: 16 additions & 0 deletions docs/RELEASING.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,7 @@ git push origin v0.2.0
```

**Tag Format:** `v<major>.<minor>.<patch>`

- Example: `v0.2.0`, `v1.0.0`, `v1.2.3`

### 4. Monitor the Release
Expand Down Expand Up @@ -91,16 +92,19 @@ We follow [Semantic Versioning](https://semver.org/):
### Format: `MAJOR.MINOR.PATCH`

**MAJOR (0.x.x → 1.x.x):**

- Incompatible API changes
- Breaking changes to command interface
- Database schema changes requiring migration

**MINOR (0.0.x → 0.1.x):**

- New features (backward compatible)
- New commands
- Major enhancements

**PATCH (0.0.0 → 0.0.1):**

- Bug fixes
- Performance improvements
- Documentation updates
Expand Down Expand Up @@ -132,22 +136,26 @@ Mark the release as "pre-release" in GitHub UI if needed.
For urgent bug fixes:

1. Create a hotfix branch from the tag:

```bash
git checkout -b hotfix/v0.2.1 v0.2.0
```

2. Fix the bug and commit:

```bash
git commit -m "Fix critical bug in pause command"
```

3. Create a new patch version tag:

```bash
git tag -a v0.2.1 -m "Hotfix: Fix pause command bug"
git push origin v0.2.1
```

4. Merge back to main:

```bash
git checkout main
git merge hotfix/v0.2.1
Expand All @@ -161,6 +169,7 @@ For urgent bug fixes:
Triggers on: Push to tags matching `v*.*.*`

**Steps:**

1. Checkout code
2. Setup Go 1.25
3. Build binaries for all platforms
Expand All @@ -169,6 +178,7 @@ Triggers on: Push to tags matching `v*.*.*`
6. Create GitHub Release with artifacts

**Build flags:**

```bash
go build -ldflags="-s -w"
```
Expand All @@ -183,6 +193,7 @@ Triggers on: Push to main/dev, Pull Requests
**Purpose:** Continuous integration - verify builds work

**Steps:**

1. Build on Linux, macOS, Windows
2. Run `go vet`
3. Run tests (if present)
Expand Down Expand Up @@ -278,10 +289,12 @@ Get-FileHash sess-windows-amd64.zip -Algorithm SHA256
### Build Fails

**Check Go version:**

- Workflow uses Go 1.25
- Ensure go.mod requires the correct version

**Check dependencies:**

```bash
go mod tidy
go mod verify
Expand All @@ -290,10 +303,12 @@ go mod verify
### Release Not Created

**Check tag format:**

- Must match `v*.*.*` (e.g., `v0.2.0`)
- Not `0.2.0` or `version-0.2.0`

**Check permissions:**

- Workflow needs `contents: write` permission
- This is already set in the workflow file

Expand All @@ -302,6 +317,7 @@ go mod verify
Binaries are ~15MB due to embedded SQLite. This is normal.

To reduce size further:

- Use UPX compression (risky, can trigger antivirus)
- Remove unused features (not recommended)

Expand Down