docs: prepare 0.3.0 release notes

- Update CHANGELOG.md with [Unreleased] section
- Add 0.3.0 versionChanges to info.go
This commit is contained in:
gastown/crew/max
2026-01-17 02:09:01 -08:00
committed by Steve Yegge
parent cd67eae044
commit 265239d4a1
2 changed files with 112 additions and 0 deletions

View File

@@ -7,6 +7,92 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [Unreleased]
### Added
#### Release Automation
- **`gastown-release` molecule formula** - Workflow for releases with preflight checks, CHANGELOG/info.go updates, local install, and daemon restart
#### New Commands
- **`gt show`** - Inspect bead contents and metadata
- **`gt cat`** - Display bead content directly
- **`gt orphans list/kill`** - Detect and clean up orphaned Claude processes
- **`gt convoy close`** - Manual convoy closure command
- **`gt commit`** - Wrapper for git commit with bead awareness
- **`gt trail`** - View commit trail for current work
- **`gt mail ack`** - Alias for mark-read command
#### Plugin System
- **Plugin discovery and management** - `gt plugin run`, `gt plugin history`
- **`gt dispatch --plugin`** - Execute plugins via dispatch command
#### Messaging Infrastructure (Beads-Native)
- **Queue beads** - New bead type for message queues
- **Channel beads** - Pub/sub messaging with retention
- **Group beads** - Group management for messaging
- **Address resolution** - Resolve agent addresses for mail routing
- **`gt mail claim`** - Claim messages from queues
#### Agent Identity
- **`gt polecat identity show`** - Display CV summary for agents
- **Worktree setup hooks** - Inject local configurations into worktrees
#### Performance & Reliability
- **Parallel agent startup** - Faster boot with concurrency limit
- **Event-driven convoy completion** - Deacon checks convoy status on events
- **Automatic orphan cleanup** - Detect and kill orphaned Claude processes
- **Namepool auto-theming** - Themes selected per rig based on name hash
### Changed
- **MR tracking via beads** - Removed mrqueue package, MRs now stored as beads
- **Desire-path commands** - Added agent ergonomics shortcuts
- **Explicit escalation in templates** - Polecat templates include escalation instructions
- **NamePool state is transient** - InUse state no longer persisted to config
### Fixed
#### Process Management
- **Kill process tree on shutdown** - Prevents orphaned Claude processes
- **Explicit pane process kill** - Prevents setsid orphans in tmux
- **Session survival verification** - Verify session survives startup before returning
- **Batch session queries** - Improved performance in `gt down`
- **Prevent tmux server exit** - `gt down` no longer kills tmux server
#### Beads & Routing
- **Agent bead prefix alignment** - Force multi-hyphen IDs for consistency
- **hq- prefix for town-level beads** - Groups, channels use correct prefix
- **CreatedAt for group/channel beads** - Proper timestamps on creation
- **Routes.jsonl protection** - Doctor check for rig-level routing issues
- **Clear BEADS_DIR in auto-convoys** - Prevent prefix inheritance issues
#### Mail & Communication
- **Channel routing in router.Send()** - Mail correctly routes to channels
- **Filter unread in beads mode** - Correct unread message filtering
- **Town root detection** - Use workspace.Find for consistent detection
#### Session & Lifecycle
- **Idle Polecat Heresy warnings** - Templates warn against idle waiting
- **Direct push prohibition for polecats** - Explicit in templates
- **Handoff working directory** - Use correct witness directory
- **Dead polecat handling in sling** - Detect and handle dead polecats
- **gt done self-cleaning** - Kill tmux session on completion
#### Doctor & Diagnostics
- **Zombie session detection** - Detect dead Claude processes in tmux
- **sqlite3 availability check** - Verify sqlite3 is installed
- **Clone divergence check** - Remove blocking git fetch
#### Build & Platform
- **Windows build support** - Platform-specific process/signal handling
- **macOS codesigning** - Sign binary after install
### Documentation
- **Idle Polecat Heresy** - Document the anti-pattern of waiting for work
- **Bead ID vs Issue ID** - Clarify terminology in README
- **Explicit escalation** - Add escalation guidance to polecat templates
- **Getting Started placement** - Fix README section ordering
## [0.2.6] - 2026-01-12
### Added

View File

@@ -74,6 +74,32 @@ type VersionChange struct {
// versionChanges contains agent-actionable changes for recent versions
var versionChanges = []VersionChange{
{
Version: "0.3.0",
Date: "2026-01-17",
Changes: []string{
"NEW: gt show/cat - Inspect bead contents and metadata",
"NEW: gt orphans list/kill - Detect and clean up orphaned Claude processes",
"NEW: gt convoy close - Manual convoy closure command",
"NEW: gt commit/trail - Git wrappers with bead awareness",
"NEW: Plugin system - gt plugin run/history, gt dispatch --plugin",
"NEW: Beads-native messaging - Queue, channel, and group beads",
"NEW: gt mail claim - Claim messages from queues",
"NEW: gt polecat identity show - Display CV summary",
"NEW: gastown-release molecule formula - Automated release workflow",
"NEW: Parallel agent startup - Faster boot with concurrency limit",
"NEW: Automatic orphan cleanup - Detect and kill orphaned processes",
"NEW: Worktree setup hooks - Inject local configurations",
"CHANGED: MR tracking via beads - Removed mrqueue package",
"CHANGED: Desire-path commands - Agent ergonomics shortcuts",
"CHANGED: Explicit escalation in polecat templates",
"FIX: Kill process tree on shutdown - Prevents orphaned Claude processes",
"FIX: Agent bead prefix alignment - Multi-hyphen IDs for consistency",
"FIX: Idle Polecat Heresy warnings in templates",
"FIX: Zombie session detection in doctor",
"FIX: Windows build support with platform-specific handling",
},
},
{
Version: "0.2.0",
Date: "2026-01-04",