@beads/bd 0.21.6 → 0.22.0

package/bin/CHANGELOG.md

@@ -7,6 +7,89 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- **Parent Resurrection** (bd-58c0): Automatic resurrection of deleted parent issues from JSONL history
+  - Prevents import failures when parent issues have been deleted
+  - Creates tombstone placeholders for missing hierarchical parents
+  - Best-effort dependency resurrection from JSONL
+
+### Changed
+
+- **Error Messages**: Improved error messages for missing parent issues
+  - Old: `"parent issue X does not exist"`
+  - New: `"parent issue X does not exist and could not be resurrected from JSONL history"`
+  - **Breaking**: Scripts parsing exact error messages may need updates
+
+### Fixed
+
+- **JSONL Resurrection Logic**: Fixed to use LAST occurrence instead of FIRST (append-only semantics)
+
+## [0.21.7] - 2025-11-04
+
+### Fixed
+
+- **Memory Database Connection Pool** (bd-b121): Fixed `:memory:` database handling to use single shared connection
+  - Prevents "no such table" errors when using in-memory databases
+  - Ensures connection pool reuses the same in-memory instance
+  - Critical fix for event-driven daemon mode tests
+
+- **Test Suite Stability**: Fixed event-driven test flakiness
+  - Added `waitFor` helper for event-driven testing
+  - Improved timing-dependent test reliability
+
+## [0.21.6] - 2025-11-04
+
+### Added
+
+- **npm Package** (bd-febc): Created `@beads/bd` npm package for Node.js/Claude Code for Web integration
+  - Native binary downloads from GitHub releases
+  - Integration tests and release documentation
+  - Postinstall script for platform-specific binary installation
+
+- **Template Support** (bd-164b): Issue creation from markdown templates
+  - Create multiple issues from a single file
+  - Structured format for bulk issue creation
+
+- **`bd comment` Alias** (bd-d3f0): Convenient shorthand for `bd comments add`
+
+### Changed
+
+- **Base36 Issue IDs** (GH #213): Switched from hex to Base36 encoding for shorter, more readable IDs
+  - Reduces ID length while maintaining uniqueness
+  - More human-friendly format
+
+### Fixed
+
+- **SQLite URI Handling** (bd-c54b): Fixed `file://` URI scheme to prevent query params in filename
+  - Prevents database corruption from malformed URIs
+  - Fixed `:memory:` database connection strings
+
+- **`bd init --no-db` Behavior** (GH #210): Now correctly creates `metadata.json` and `config.yaml`
+  - Previously failed to set `no-db: true` flag
+  - Improved metadata-only initialization workflow
+
+- **Symlink Path Resolution**: Fixed `findDatabaseInTree` to properly resolve symlinks
+- **Epic Hierarchy Display**: Fixed `bd show` command to correctly display epic child relationships
+- **CI Stability**: Fixed performance thresholds, test eligibility, and lint errors
+
+### Dependencies
+
+- Bumped `github.com/anthropics/anthropic-sdk-go` from 1.14.0 to 1.16.0
+- Bumped `fastmcp` from 2.13.0.1 to 2.13.0.2
+
+## [0.21.5] - 2025-11-02
+
+### Fixed
+
+- **Critical Double JSON Encoding Bug** (bd-1048, bd-4ec8): Fixed widespread bug in daemon RPC calls where `ResolveID` responses were incorrectly converted using `string(resp.Data)` instead of `json.Unmarshal`. This caused IDs to become double-quoted (`"\"bd-1048\""`) and database lookups to fail. Affected commands:
+  - `bd show` - nil pointer dereference and 3 instances of double encoding
+  - `bd dep add/remove/tree` - 5 instances
+  - `bd label add/remove/list` - 3 instances  
+  - `bd reopen` - 1 instance
+  
+  All 12 instances fixed with proper JSON unmarshaling.
+
 ## [0.21.4] - 2025-11-02
 
 ### Added

package/bin/README.md

@@ -2,6 +2,7 @@
 
 [![Go Version](https://img.shields.io/github/go-mod/go-version/steveyegge/beads)](https://go.dev/)
 [![Release](https://img.shields.io/github/v/release/steveyegge/beads)](https://github.com/steveyegge/beads/releases)
+[![npm version](https://img.shields.io/npm/v/@beads/bd)](https://www.npmjs.com/package/@beads/bd)
 [![CI](https://img.shields.io/github/actions/workflow/status/steveyegge/beads/ci.yml?branch=main&label=tests)](https://github.com/steveyegge/beads/actions/workflows/ci.yml)
 [![Go Report Card](https://goreportcard.com/badge/github.com/steveyegge/beads)](https://goreportcard.com/report/github.com/steveyegge/beads)
 [![License](https://img.shields.io/github/license/steveyegge/beads)](LICENSE)
@@ -68,6 +69,11 @@ Agents report that they enjoy working with Beads, and they will use it spontaneo
 
 ## Installation
 
+**npm (Node.js environments, Claude Code for Web):**
+```bash
+npm install -g @beads/bd
+```
+
 **Quick install (all platforms):**
 ```bash
 curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
@@ -83,6 +89,8 @@ brew install bd
 
 **IDE Integration:** See [INSTALLING.md](INSTALLING.md) for Claude Code plugin and MCP server setup.
 
+**Claude Code for Web:** See [npm-package/CLAUDE_CODE_WEB.md](npm-package/CLAUDE_CODE_WEB.md) for SessionStart hook setup.
+
 ## Quick Start
 
 ### For Humans
@@ -342,12 +350,21 @@ bd create "Task" -l "backend,urgent" --assignee alice
 # Get JSON output for programmatic use
 bd create "Fix bug" -d "Description" --json
 
+# Create from templates (built-in: epic, bug, feature)
+bd create --from-template epic "Q4 Platform Improvements"
+bd create --from-template bug "Auth token validation fails"
+bd create --from-template feature "Add OAuth support"
+
+# Override template defaults
+bd create --from-template bug "Critical issue" -p 0  # Override priority
+
 # Create multiple issues from a markdown file
 bd create -f feature-plan.md
 ```
 
 Options:
 - `-f, --file` - Create multiple issues from markdown file
+- `--from-template` - Use template (epic, bug, feature, or custom)
 - `-d, --description` - Issue description
 - `-p, --priority` - Priority (0-4, 0=highest, default=2)
 - `-t, --type` - Type (bug|feature|task|epic|chore, default=task)
@@ -356,6 +373,8 @@ Options:
 - `--id` - Explicit issue ID (e.g., `worker1-100` for ID space partitioning)
 - `--json` - Output in JSON format
 
+See `bd template list` for available templates and `bd help template` for managing custom templates.
+
 ### Viewing Issues
 
 ```bash
@@ -409,10 +428,12 @@ bd dep cycles
 - **blocks**: Hard blocker (default) - issue cannot start until blocker is resolved
 - **related**: Soft relationship - issues are connected but not blocking
 - **parent-child**: Hierarchical relationship (child depends on parent)
-- **discovered-from**: Issue discovered during work on another issue
+- **discovered-from**: Issue discovered during work on another issue (automatically inherits parent's `source_repo`)
 
 Only `blocks` dependencies affect ready work detection.
 
+> **Note:** Issues created with `discovered-from` dependencies automatically inherit the parent's `source_repo` field, ensuring discovered work stays in the same repository as the parent task.
+
 ### Finding Work
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beads/bd",
-  "version": "0.21.6",
+  "version": "0.22.0",
   "description": "Beads issue tracker - lightweight memory system for coding agents with native binary support",
   "main": "bin/bd.js",
   "bin": {