docs: Add 0.37.0 release notes

- Gate commands: bd gate create/eval/approve for async coordination
- New features: --suggest-next, --parent flag, TOML formulas, fork detection
- Fixes: gate await fields, tombstone timestamps, git caching, Windows support
This commit is contained in:
Steve Yegge
2025-12-26 01:19:59 -08:00
parent 1fdd3538d2
commit efe8180078
2 changed files with 56 additions and 2 deletions

View File

@@ -5,10 +5,32 @@ All notable changes to the beads project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [Unreleased]
## [0.37.0] - 2025-12-26
### Added
- **Gate commands** (bd-udsi, gt-twjr5) - Async coordination for agent workflows
- `bd gate create` - Create gates with await conditions (gh:run, gh:pr, timer, human, mail)
- `bd gate eval` - Evaluate timer and GitHub gates (checks run completion, PR merge)
- `bd gate approve` - Approve human gates
- `bd gate show/list/close/wait` - Full gate lifecycle management
- **`bd close --suggest-next`** (GH#679) - Smart workflow continuation
- Shows newly unblocked issues after closing
- Helps agents find next actionable work
- **`bd ready/blocked --parent`** (GH#743) - Epic-scoped filtering
- Filter issues by parent bead or epic
- Enables focused work within a subtree
- **TOML support for formulas** (gt-xmyha) - Alternative format
- `.formula.toml` files alongside JSON support
- Human-friendly authoring option
- **Fork repo auto-detection** (GH#742) - Contributor workflow
- Detects fork repositories during init
- Offers to configure .git/info/exclude for stealth mode
- **Control flow operators** (gt-8tmz.4) - Advanced formula composition
- `loop` operator for iterating over collections
- `gate` operator for conditional execution
@@ -67,6 +89,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
### Fixed
- **Gate await fields preserved during upsert** (bd-gr4q) - Multirepo sync
- Gate fields no longer cleared during multi-repo sync operations
- Enables reliable gate coordination across clones
- **Tombstones retain closed_at timestamp** - Soft delete metadata
- Tombstones preserve the original close time
- Maintains accurate timeline for deleted issues
- **Git detection caching** (bd-7di) - Performance improvement
- Cache git worktree/repo detection results
- Eliminates repeated slowness on worktree checks
- **Windows MCP graceful fallback** (GH#387) - Platform compatibility
- Daemon mode falls back gracefully on Windows
- Prevents crashes when daemon unavailable
- **Windows npm postinstall file locking** (GH#670) - Install reliability
- Handles file lock errors during npm install
- Improves installation success on Windows
- **installed_plugins.json v2 format** (GH#741) - Claude Code compatibility
- `bd doctor` now handles both v1 and v2 plugin file formats
- Fixes "cannot unmarshal array" error on newer Claude Code versions

View File

@@ -290,8 +290,15 @@ type VersionChange struct {
var versionChanges = []VersionChange{
{
Version: "0.37.0",
Date: "2025-12-25",
Date: "2025-12-26",
Changes: []string{
"NEW: bd gate create/show/list/close/wait (bd-udsi) - Async coordination primitives for agent workflows",
"NEW: bd gate eval (gt-twjr5.2) - Evaluate timer gates and GitHub gates (gh:run, gh:pr, mail)",
"NEW: bd gate approve (gt-twjr5.4) - Human gate approval command",
"NEW: bd close --suggest-next (GH#679) - Show newly unblocked issues after close",
"NEW: bd ready/blocked --parent (GH#743) - Scope by epic or parent bead",
"NEW: TOML support for formulas (gt-xmyha) - .formula.toml files alongside JSON",
"NEW: Fork repo auto-detection (GH#742) - Offer to configure .git/info/exclude",
"NEW: Control flow operators (gt-8tmz.4) - loop and gate operators for formula composition",
"NEW: Aspect composition (gt-8tmz.5) - Cross-cutting concerns via aspects field in formulas",
"NEW: Runtime expansion (gt-8tmz.8) - on_complete and for-each dynamic step generation",
@@ -304,6 +311,9 @@ var versionChanges = []VersionChange{
"CHANGED: Formula format YAML→JSON - Formulas now use .formula.json extension",
"CHANGED: bd mol run removed - Orchestration moved to gt commands",
"CHANGED: Wisp architecture simplified (bd-bkul) - Single DB with Wisp=true flag",
"FIX: Gate await fields preserved during upsert (bd-gr4q) - Multirepo sync fix",
"FIX: Tombstones retain closed_at timestamp - Preserves close time in soft deletes",
"FIX: Git detection caching (bd-7di) - Eliminates worktree slowness",
"FIX: installed_plugins.json v2 format (GH#741) - bd doctor handles new Claude Code format",
"FIX: git.IsWorktree() hang on Windows (GH#727) - bd init no longer hangs outside git repos",
"FIX: Skill files deleted by bd sync (GH#738) - .claude/ files now preserved",
@@ -312,6 +322,8 @@ var versionChanges = []VersionChange{
"FIX: Aspect self-matching recursion (gt-8tmz.16) - Prevents infinite loops",
"FIX: Map expansion nested matching (gt-8tmz.33) - Correctly matches child steps",
"FIX: Content-level merge for divergence (bd-kpy) - Better conflict resolution",
"FIX: Windows MCP graceful fallback (GH#387) - Daemon mode on Windows",
"FIX: Windows npm postinstall file locking (GH#670) - Install reliability",
},
},
{