compound-agent 1.2.11 → 1.3.1

package/CHANGELOG.md

@@ -9,6 +9,63 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.3.1] - 2026-02-21
+
+### Added
+
+- **`ca version-show` command**: Displays version with terminal animation (tendril growth) and recent changelog entries. Non-TTY environments get plain text output. Changelog is embedded at build time from CHANGELOG.md.
+- **3 new doctor checks**: Beads initialized (`.beads/` dir), beads healthy (`bd doctor`), codebase scope (user-scope detection)
+- **Beads + scope status in init/setup output**: Full beads health display (CLI available, initialized, healthy) and scope status shown after `ca init`, `ca setup`, and `ca setup --update`
+- **Banner on `--update`**: Terminal art animation now plays during `ca setup --update` and `ca init --update` (same TTY/quiet guards as fresh install)
+
+### Changed
+
+- **Split documentation**: `HOW_TO_COMPOUND.md` replaced by 5 focused documents in `docs/compound/`: `README.md`, `WORKFLOW.md`, `CLI_REFERENCE.md`, `SKILLS.md`, `INTEGRATION.md`
+- **Test-cleaner Phase 3 strengthened**: Adversarial review phase now mandates iteration loop until both reviewers give unconditional approval. Heading, emphasis, and quality criteria updated.
+- **Update hint on upgrade**: When `ca init` or `ca setup` detects an existing install, displays tip to run with `--update` to regenerate managed files
+- **HOW_TO_COMPOUND.md migration**: `ca setup --update` automatically removes old monolithic `HOW_TO_COMPOUND.md` if it has version frontmatter (generated by compound-agent)
+- **Doctor doc check**: Now checks for `docs/compound/README.md` instead of `HOW_TO_COMPOUND.md`
+
+## [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
@@ -556,7 +613,8 @@ 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.11...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

package/README.md

@@ -210,6 +210,8 @@ Generated scripts detect three markers: `EPIC_COMPLETE` (success), `EPIC_FAILED`
 | `ca setup claude --status` | Check Claude Code integration health |
 | `ca setup claude --uninstall` | Remove Claude hooks only |
 | `ca download-model` | Download the embedding model |
+| `ca version-show` | Show version with animation and recent changelog |
+| `ca doctor` | Verify external dependencies and project health |
 
 ## Workflow Commands