docs: prepare v0.28.0 release notes

- Add v0.28.0 entry to CHANGELOG.md with all changes
- Add v0.28.0 to info.go whats-new section
- Trim old versions (0.21.0, 0.22.x) from whats-new

CHANGELOG.md

@@ -7,6 +7,68 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.28.0] - 2025-12-01
+
+### Added
+
+- **`bd daemon --local` flag (#433)** - Run daemon without git operations
+  - Ideal for multi-repo setups where git sync happens externally
+  - Prevents daemon from triggering git commits/pushes
+  - Use with worktrees or when beads sync is handled by another process
+
+- **`bd daemon --foreground` flag** - Run daemon in foreground mode
+  - For systemd/supervisord/launchd integration
+  - Logs to stdout instead of background file
+  - Process stays attached to terminal
+
+- **`bd migrate-sync` command (bd-epn)** - Migrate to sync.branch workflow
+  - Moves beads data to a dedicated sync branch
+  - Keeps main branch clean of .beads/ commits
+  - Automated setup of sync.branch configuration
+
+- **`--estimate` flag for `bd create` and `bd update`** - Add time estimates to issues
+  - Track estimated effort for planning
+  - Supports formats like "2h", "1d", "1w"
+
+### Fixed
+
+- **Database Migration: close_reason column (bd-uyu)**
+  - Added missing database column for close_reason field
+  - Fixes sync loops where close_reason was lost on import/export
+  - Automatic migration on first run
+
+- **Multi-repo Prefix Filtering (GH #437)**
+  - Issues now filtered by prefix when flushing from non-primary repos
+  - Prevents issues from other projects appearing in exports
+
+- **Parent-Child Dependency UX (GH #440)**
+  - Fixed backwards documentation in DEPENDENCIES.md
+  - `bd show` now displays epic children under "Children" not "Blocks"
+  - Clearer UI labels for dependency relationships
+
+- **sync.branch Workflow Fixes (bd-epn)**
+  - Fixed .beads/ restoration from branch after sync
+  - Prevents final flush after sync.branch restore
+  - `bd doctor` now detects when on sync branch
+
+- **Jira API Migration**
+  - Updated from deprecated Jira API v2 to v3
+  - Fixes authentication issues with newer Jira instances
+
+- **Redundant Database Queries (bd-bbh)**
+  - Removed extra GetCloseReason() calls after column migration
+  - Improves query performance for issue retrieval
+
+### Documentation
+
+- Added go install fallback instructions for Claude Code web (GH #439)
+- Added uninstall documentation (GH #445)
+
+### Internal
+
+- Refactored daemon sync functions to reduce ~200 lines of duplication (bd-73u)
+- Consolidated local-only sync functions into shared implementation
+
 ## [0.27.2] - 2025-11-30
 
 ### Fixed

cmd/bd/info.go

@@ -287,6 +287,21 @@ type VersionChange struct {
 
 // versionChanges contains agent-actionable changes for recent versions
 var versionChanges = []VersionChange{
+	{
+		Version: "0.28.0",
+		Date:    "2025-12-01",
+		Changes: []string{
+			"bd daemon --local flag (#433) - Run daemon without git operations for multi-repo/worktree setups",
+			"bd daemon --foreground flag - Run in foreground for systemd/supervisord integration",
+			"bd migrate-sync command (bd-epn) - Migrate to sync.branch workflow for cleaner main branch",
+			"--estimate flag for bd create/update - Add time estimates to issues",
+			"Database migration: close_reason column (bd-uyu) - Fixes sync loops with close_reason",
+			"Multi-repo prefix filtering (GH #437) - Issues filtered by prefix when flushing from non-primary repos",
+			"Parent-child dependency UX (GH #440) - Fixed documentation and UI labels for dependencies",
+			"sync.branch workflow fixes (bd-epn) - Fixed .beads/ restoration and doctor detection",
+			"Jira API migration - Updated from deprecated v2 to v3 API",
+		},
+	},
 	{
 		Version: "0.27.2",
 		Date:    "2025-11-30",
@@ -298,8 +313,8 @@ var versionChanges = []VersionChange{
 		},
 	},
 	{
-		Version: "0.27.1",
-		Date:    "2025-11-30",
+		Version: "0.27.0",
+		Date:    "2025-11-29",
 		Changes: []string{
 			"Git hooks now sync.branch aware - pre-commit/pre-push skip .beads checks when sync.branch configured",
 			"Custom Status States - Define project-specific statuses via config (testing, blocked, review)",
@@ -403,41 +418,6 @@ var versionChanges = []VersionChange{
 			"Stale database export prevention - ID-based staleness detection",
 		},
 	},
-	{
-		Version: "0.22.1",
-		Date:    "2025-11-06",
-		Changes: []string{
-			"Native `bd merge` command vendored from beads-merge - no external binary needed",
-			"`bd info` detects outdated git hooks - warns if version mismatch",
-			"Multi-workspace deletion tracking fixed - deletions now propagate correctly",
-			"Hash ID recognition improved - recognizes Base36 IDs without a-f letters",
-			"Import/export deadlock fixed - no hanging when daemon running",
-		},
-	},
-	{
-		Version: "0.22.0",
-		Date:    "2025-11-05",
-		Changes: []string{
-			"Intelligent merge driver auto-configured - eliminates most JSONL conflicts",
-			"Onboarding wizards: `bd init --contributor` and `bd init --team`",
-			"New `bd migrate-issues` command - migrate issues between repos with dependencies",
-			"`bd show` displays blocker status - 'Blocked by N open issues' or 'Ready to work'",
-			"SearchIssues N+1 query fixed - batch-loads labels for better performance",
-			"Sync validation prevents infinite dirty loop - verifies JSONL export",
-		},
-	},
-	{
-		Version: "0.21.0",
-		Date:    "2025-11-04",
-		Changes: []string{
-			"Hash-based IDs eliminate collisions - remove ID coordination workarounds",
-			"Event-driven daemon mode (opt-in) - set BEADS_DAEMON_MODE=events",
-			"Agent Mail integration - real-time multi-agent coordination (<100ms latency)",
-			"`bd duplicates --auto-merge` - automated duplicate detection and merging",
-			"Hierarchical children for epics - dotted IDs (bd-abc.1, bd-abc.2) up to 3 levels",
-			"`--discovered-from` inline syntax - create with dependency in one command",
-		},
-	},
 }
 
 // showWhatsNew displays agent-relevant changes from recent versions