compound-agent 1.2.9 → 1.2.11

package/CHANGELOG.md

@@ -9,6 +9,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.11] - 2026-02-19
+
+### Added
+
+- **Git worktree integration** (`ca worktree`): Isolate epic work in separate git worktrees for parallel execution. Five subcommands:
+  - `ca worktree create <epic-id>` — Create worktree, install deps, copy lessons, create Merge beads task
+  - `ca worktree wire-deps <epic-id>` — Connect Review/Compound tasks as merge blockers (graceful no-op without worktree)
+  - `ca worktree merge <epic-id>` — Two-phase merge: resolve conflicts in worktree, then land clean on main
+  - `ca worktree list` — Show active worktrees with epic and merge task status
+  - `ca worktree cleanup <epic-id>` — Remove worktree, branch, and close Merge task (--force for dirty worktrees)
+- **`/compound:set-worktree` slash command**: Set up a worktree before running `/compound:lfg` for isolated epic execution
+- **Conditional Merge gate in `verify-gates`**: Worktree epics require the Merge task to be closed before epic closure. Non-worktree epics unaffected.
+- **Plan skill wire-deps step**: Plan phase now calls `ca worktree wire-deps` to connect merge dependencies when a worktree is active.
+
+### Changed
+
+- **Worktree merge safety hardening**: Added branch verification (asserts main repo is on `main`), worktree existence guard, structured error messages with worktree paths for conflict resolution and test failures
+- **JSONL reconciliation**: Switched from ID-based to line-based deduplication to preserve last-write-wins semantics for same-ID updates and deletes
+- **Worktree cleanup safety**: Branch deletion uses `-d` (safe) by default; `-D` (force) only with `--force` flag
+- **Shared beads utilities**: Extracted `validateEpicId`, `parseBdShowDeps`, and `shortId` to `cli-utils.ts`, eliminating duplication between `worktree.ts` and `verify-gates.ts`
+- **Sync API**: All worktree functions are now synchronous (removed misleading `async` wrapper around purely synchronous `execFileSync` calls)
+
+## [1.2.10] - 2026-02-19
+
+### Fixed
+
+- **pnpm native build auto-configuration**: `ca setup` and `ca init` now detect pnpm projects (via `pnpm-lock.yaml`) and automatically add `better-sqlite3` and `node-llama-cpp` to `pnpm.onlyBuiltDependencies` in the consumer's `package.json`. Prevents the "better-sqlite3 failed to load" error that pnpm v9+ users encountered when native addon builds were silently blocked.
+- **Improved error message**: `better-sqlite3` load failure now suggests running `npx ca setup` as the primary fix.
+
 ## [1.2.9] - 2026-02-19
 
 ### Added
@@ -527,7 +556,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Vitest test suite
   - tsup build configuration
 
-[Unreleased]: https://github.com/Nathandela/learning_agent/compare/v1.2.9...HEAD
+[Unreleased]: https://github.com/Nathandela/learning_agent/compare/v1.2.11...HEAD
+[1.2.11]: https://github.com/Nathandela/learning_agent/compare/v1.2.10...v1.2.11
+[1.2.10]: https://github.com/Nathandela/learning_agent/compare/v1.2.9...v1.2.10
 [1.2.9]: https://github.com/Nathandela/learning_agent/compare/v1.2.7...v1.2.9
 [1.2.7]: https://github.com/Nathandela/learning_agent/compare/v1.2.6...v1.2.7
 [1.2.6]: https://github.com/Nathandela/learning_agent/compare/v1.2.5...v1.2.6

package/README.md

@@ -81,7 +81,9 @@ npx ca setup --skip-model
 
 ### pnpm Users
 
-pnpm v9+ blocks native addon builds by default. Add to your `package.json`:
+pnpm v9+ blocks native addon builds by default. Running `npx ca setup` automatically detects pnpm and adds the required config to your `package.json`.
+
+If you prefer to configure manually, add to your `package.json`:
 
 ```json
 {
@@ -173,6 +175,16 @@ The CLI binary is `ca` (alias: `compound-agent`).
 | `ca rules check` | Run repository-defined rule checks |
 | `ca test-summary` | Run tests and output a compact summary |
 
+### Worktree
+
+| Command | Description |
+|---------|-------------|
+| `ca worktree create <epic-id>` | Create isolated worktree for an epic |
+| `ca worktree wire-deps <epic-id>` | Wire Review/Compound as merge blockers |
+| `ca worktree merge <epic-id>` | Two-phase merge back to main |
+| `ca worktree list` | List active worktrees with status |
+| `ca worktree cleanup <epic-id>` | Remove worktree and clean up (--force for dirty) |
+
 ### Automation
 
 | Command | Description |
@@ -211,6 +223,7 @@ Installed to `.claude/commands/compound/` during setup. Invoked as slash command
 | `/compound:review` | Review | Multi-agent review (security, architecture, performance, tests, simplicity) |
 | `/compound:compound` | Compound | Capture lessons, solutions, patterns into memory |
 | `/compound:lfg` | All | Chain all phases sequentially |
+| `/compound:set-worktree` | Setup | Create isolated git worktree for an epic |
 
 ## Memory Types