compound-agent 1.2.10 → 1.3.0

package/CHANGELOG.md

@@ -9,6 +9,68 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.3.0] - 2026-02-21
+
+### Added
+
+- **Setup hardening**: Four new pre-flight checks during `ca init` and `ca setup`:
+  - **Beads CLI check** (`beads-check.ts`): Detects if `bd` is available, shows install URL if missing (informational, non-blocking)
+  - **User-scope detection** (`scope-check.ts`): Warns when installing at home directory level where lessons are shared across projects
+  - **.gitignore injection** (`gitignore.ts`): Ensures `node_modules/` and `.claude/.cache/` patterns exist in `.gitignore`
+  - **Upgrade detection** (`upgrade.ts`): Detects existing installs and runs migration pipeline (deprecated command removal, header stripping, doc version update)
+- **Upgrade engine**: Automated migration from v1.2.x to v1.3.0:
+  - Removes 5 deprecated CLI wrapper commands (`search.md`, `list.md`, `show.md`, `stats.md`, `wrong.md`)
+  - Strips legacy `<!-- generated by compound-agent -->` headers from installed files
+  - Updates `HOW_TO_COMPOUND.md` version during upgrade
+- **`/compound:research` skill**: PhD-depth research producing structured survey documents following `TEMPLATE_FOR_RESEARCH.md` format
+- **`/compound:test-clean` skill**: 5-phase test suite optimization with adversarial review (audit, design, implement, verify, report)
+- **Documentation template**: `HOW_TO_COMPOUND.md` deployed to `docs/compound/` during setup with version and date placeholders
+- **Test scripts**: `test:segment` (run tests for specific module), `test:random` (seeded random subset), `test:critical` (*.critical.test.ts convention)
+- **3 new doctor checks**: Beads CLI availability, `.gitignore` health, usage documentation presence
+
+### Fixed
+
+- **`setup --update --dry-run` no longer mutates files**: `runUpgrade()` now accepts a `dryRun` parameter propagated to all sub-functions (removeDeprecatedCommands, stripGeneratedHeaders, upgradeDocVersion)
+- **`setup --uninstall` respects plugin.json ownership**: Checks `name === "compound-agent"` before deleting; user-owned plugin manifests are preserved
+- **Upgrade ownership guard**: `removeDeprecatedCommands` checks file content for compound-agent markers before deleting, preventing silent removal of user-authored files with the same name
+- **Malformed settings.json no longer silently clobbered**: On parse error, `configureClaudeSettings` warns and skips instead of overwriting with empty config
+
+### Changed
+
+- **`setup --update` overhaul**: Now uses path-based file detection (compound/ = managed) instead of marker-based. Runs upgrade pipeline and `.gitignore` remediation during update
+- **JSON-first `bd` parsing in loop**: `jq` primary with `python3` fallback via `parse_json()` helper
+- **CLI test helpers hardened**: Replaced shell string interpolation with `execFileSync` for safety and reliability
+- **Beads check portable**: Uses POSIX `command -v` instead of non-portable `which`
+- **Template expansion**: Brainstorm and plan skills now cross-reference researcher skill; 9 total skills, 11 total commands
+- **Code organization**: Extracted display utilities to `display-utils.ts`, uninstall logic to `uninstall.ts`
+
+### Removed
+
+- **5 deprecated CLI wrapper commands**: `search.md`, `list.md`, `show.md`, `stats.md`, `wrong.md` (redundant wrappers around `npx ca <cmd>`)
+- **`GENERATED_MARKER` on new installs**: New installs use path-based detection; marker retained only for backward-compatible `--update` detection
+
+## [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
@@ -534,7 +596,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.10...HEAD
+[Unreleased]: https://github.com/Nathandela/learning_agent/compare/v1.3.0...HEAD
+[1.3.0]: https://github.com/Nathandela/learning_agent/compare/v1.2.11...v1.3.0
+[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

package/README.md

@@ -175,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 |
@@ -213,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