compound-agent 1.2.8 → 1.2.10

package/CHANGELOG.md

@@ -9,6 +9,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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
+
+- **`ca phase-check` command**: Manage LFG phase state with `init`, `status`, `clean`, and `gate <name>` subcommands. State persisted in `.claude/.ca-phase-state.json`.
+- **PreToolUse phase guard hook** (`ca hooks run phase-guard`): Warns when Edit or Write tools are used before the current phase's skill file has been read.
+- **PostToolUse read tracker hook** (`ca hooks run read-tracker`): Tracks skill file reads in `.ca-phase-state.json` so the phase guard can verify compliance.
+- **Stop audit hook** (`ca hooks run stop-audit`): Blocks Claude from stopping if no phase gate has been passed when `stop_hook_active` is set in phase state.
+- **Phase state persistence**: `.claude/.ca-phase-state.json` stores LFG phase tracking data across hook invocations.
+- **Failure state persistence**: `.claude/.ca-failure-state.json` persists PostToolUseFailure counters across process restarts.
+
+### Changed
+
+- **`ca init`** now installs all 5 Claude Code hooks: SessionStart, PreCompact, UserPromptSubmit, PostToolUseFailure, PostToolUse (previously only SessionStart).
+- **`ca setup claude`** now installs all 5 Claude Code hooks (previously only SessionStart).
+- **`ca setup`** now installs the git pre-commit hook in addition to Claude Code hooks.
+
+### Removed
+
+- **MCP server**: `compound-agent-mcp` binary and `@modelcontextprotocol/sdk` dependency removed. Use CLI commands instead.
+- **`.mcp.json`**: Configuration file is no longer generated or needed.
+
 ## [1.2.7] - 2026-02-17
 
 ### Changed
@@ -505,7 +534,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.7...HEAD
+[Unreleased]: https://github.com/Nathandela/learning_agent/compare/v1.2.10...HEAD
+[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
 [1.2.5]: https://github.com/Nathandela/learning_agent/compare/v1.2.4...v1.2.5

package/README.md

@@ -28,10 +28,11 @@ LAYER 1: BEADS (Foundation)
 
 ```
 project_root/
-+-- .mcp.json                    <- MCP server config
 +-- AGENTS.md                    <- Workflow instructions for Claude
 +-- .claude/
     +-- settings.json            <- Claude Code hooks
+    +-- .ca-phase-state.json     <- LFG phase tracking (generated)
+    +-- .ca-failure-state.json   <- Hook failure counters (generated)
     +-- lessons/
     |   +-- index.jsonl          <- Source of truth (git-tracked)
     |   +-- archive/             <- Compacted old items
@@ -65,7 +66,7 @@ Every cycle through the loop makes subsequent cycles smarter. A bug found in rev
 # Install as dev dependency
 pnpm add -D compound-agent
 
-# One-shot setup (creates dirs, hooks, MCP server, downloads model)
+# One-shot setup (creates dirs, hooks, downloads model)
 npx ca setup
 
 # Skip the ~278MB model download (do it later)
@@ -80,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
 {
@@ -98,8 +101,8 @@ Then run `pnpm install`.
 |--------|----------|---------|
 | Create lessons store | `.claude/lessons/` | JSONL + cache directory |
 | Install AGENTS.md | project root | Workflow instructions for Claude |
-| Configure hooks | `.claude/settings.json` | SessionStart, PreCompact, UserPromptSubmit, PostToolUse hooks |
-| Register MCP server | `.mcp.json` | `memory_search`, `memory_capture` tools |
+| Configure hooks | `.claude/settings.json` | SessionStart, PreCompact, UserPromptSubmit, PostToolUseFailure, PostToolUse hooks |
+| Install git pre-commit hook | `.git/hooks/pre-commit` | Lesson capture reminder before commits |
 | Install workflow commands | `.claude/commands/compound/` | Slash commands for each phase |
 | Install agent definitions | `.claude/agents/compound/` | Specialized agent roles |
 | Install phase skills | `.claude/skills/compound/` | Process instructions per phase |
@@ -167,6 +170,7 @@ The CLI binary is `ca` (alias: `compound-agent`).
 | `ca import <file>` | Import items from JSONL file |
 | `ca prime` | Load workflow context (used by hooks) |
 | `ca verify-gates <epic-id>` | Verify review + compound tasks exist and are closed |
+| `ca phase-check` | Manage LFG phase state (init/status/clean/gate) |
 | `ca audit` | Run audit checks against the codebase |
 | `ca rules check` | Run repository-defined rule checks |
 | `ca test-summary` | Run tests and output a compact summary |
@@ -187,7 +191,7 @@ Generated scripts detect three markers: `EPIC_COMPLETE` (success), `EPIC_FAILED`
 
 | Command | Description |
 |---------|-------------|
-| `ca setup` | One-shot setup (hooks + MCP + model) |
+| `ca setup` | One-shot setup (hooks + git pre-commit + model) |
 | `ca setup --skip-model` | Setup without model download |
 | `ca setup --uninstall` | Remove all generated files |
 | `ca setup --update` | Regenerate files (preserves user customizations) |
@@ -197,16 +201,6 @@ Generated scripts detect three markers: `EPIC_COMPLETE` (success), `EPIC_FAILED`
 | `ca setup claude --uninstall` | Remove Claude hooks only |
 | `ca download-model` | Download the embedding model |
 
-## MCP Tools
-
-Compound Agent exposes three MCP endpoints. These are the primary interface for Claude -- preferred over CLI commands.
-
-| Endpoint | Type | Purpose |
-|----------|------|---------|
-| `memory_search` | Tool | Search memory items by semantic similarity. Supports `query`, `maxResults`, and `type` filter. |
-| `memory_capture` | Tool | Capture a new memory item. Accepts `insight`, `trigger`, `tags`, `type`, `severity`, `pattern`, and relationship fields. |
-| `memory://prime` | Resource | Workflow context with high-severity memory items for session start. |
-
 ## Workflow Commands
 
 Installed to `.claude/commands/compound/` during setup. Invoked as slash commands in Claude Code.
@@ -326,7 +320,6 @@ pnpm lint             # Type check + ESLint
 | Embeddings | node-llama-cpp + EmbeddingGemma-300M |
 | CLI | Commander.js |
 | Schema | Zod |
-| MCP | @modelcontextprotocol/sdk |
 | Issue Tracking | Beads (bd) |
 
 ## Documentation