@shepai/cli 1.15.1 → 1.16.0

package/README.md

@@ -23,27 +23,183 @@ _Manage Claude Code, Cursor CLI, or any coding agent across the full development
 
 <img src="docs/poc/imgs/00-control-center-hero.png" alt="Shep AI Control Center — manage all features across repos from a single canvas" width="100%" />
 
-<br />
+[![Live Demo](https://img.shields.io/badge/Live_Demo-shep--ai.github.io-blue?style=for-the-badge)](https://shep-ai.github.io/cli/poc/)
 
 </div>
 
----
-
-Running AI agents is easy. **Managing many of them through a full SDLC is the hard part.** Shep gives you a control center that handles the entire lifecycle — requirements gathering, planning, implementation, QA, and deployment — across multiple agent sessions running in parallel. See what each agent is doing, jump into any session's web preview, code editor, or terminal, approve plans when agents need your input, and let them keep working while you move on. Plug in Claude Code, Cursor CLI, Gemini CLI, or any coding agent. Each feature gets its own isolated worktree and dev environment. You manage the lifecycle, agents do the work.
+### Install
 
 ```bash
 npm i -g @shepai/cli
-cd your-repo/
-shep feat new "Implement SSO with SAML 2.0"
-# Agent starts working in a dedicated worktree.
-# Open the control center to watch progress, intervene, or switch context.
-shep ui
 ```
 
+### Try it
+
+```bash
+cd your-project/
+shep feat new "Add unit tests for all source files"
+```
+
+<details>
+<summary><b>List features</b> &mdash; <code>shep feat ls</code></summary>
+<br />
+
+```
+  Features for /home/user/projects/my-app
+
+  ID        Name             Status          Branch               Created
+  1b0a7969  Add Unit Tests   ✓ Completed     feat/add-unit-tests  2/13/2026
+```
+
+</details>
+
+<details>
+<summary><b>Show feature detail</b> &mdash; <code>shep feat show 1b0a7969</code></summary>
+<br />
+
+```
+  Feature: Add Unit Tests
+
+  ID           1b0a7969-b420-4754-832f-5c38801b4852
+  Slug         add-unit-tests
+  Description  Add comprehensive unit tests for all existing source files
+               in the project to ensure code correctness and improve test coverage.
+  Repository   /home/user/projects/my-app
+  Branch       feat/add-unit-tests
+  Status       ✓ Completed
+  Worktree     ~/.shep/repos/9bbd30de/wt/feat-add-unit-tests
+  Spec Dir     ~/.shep/repos/9bbd30de/wt/feat-add-unit-tests/specs/001-add-unit-tests
+  Agent Run    732a1fc2-a346-4052-a028-dcb1a46b6f2c
+
+  Timestamps
+  Created  2/13/2026, 12:15:08 AM
+  Updated  2/13/2026, 12:15:08 AM
+```
+
+</details>
+
+<details>
+<summary><b>Isolated worktree per feature</b> &mdash; no stashing, no branch switching</summary>
+<br />
+
+Each feature gets its own git worktree — fully isolated from your main branch.
+
+```
+~/.shep/repos/9bbd30de/wt/feat-add-unit-tests/
+├── .git                    # linked worktree (not a clone)
+├── src/
+├── tests/
+├── specs/
+│   └── 001-add-unit-tests/
+│       ├── feature.yaml    # status tracking
+│       ├── spec.yaml       # requirements & scope
+│       ├── research.yaml   # technical decisions
+│       ├── plan.yaml       # implementation strategy
+│       └── tasks.yaml      # task breakdown
+├── pyproject.toml
+└── README.md
+```
+
+</details>
+
+<details>
+<summary><b>Auto-generated spec files</b> &mdash; real output from a single <code>shep feat new</code></summary>
+<br />
+
+> **`spec.yaml`** — requirements & scope
+
+```yaml
+name: add-unit-tests
+oneLiner: Add comprehensive unit tests for all source modules
+summary: >
+  Add unit tests for every module in the package. The project currently has
+  minimal test coverage (only 7 tests total). This feature adds tests for
+  config, agents, flows, tools, observability, and CLI — using pytest with
+  mocking to avoid external dependencies.
+sizeEstimate: M
+openQuestions:
+  - question: 'Should we set a minimum coverage threshold and enforce it in CI?'
+    resolved: true
+    answer: >
+      Set 70% minimum via --cov-fail-under=70. Achievable and prevents regression.
+```
+
+> **`research.yaml`** — technical decisions with rationale
+
+```yaml
+decisions:
+  - title: 'Test Framework'
+    chosen: 'pytest (already configured)'
+    rejected:
+      - 'unittest — More verbose, no fixture system'
+      - 'nose2 — Unmaintained, no advantage'
+    rationale: >
+      Already a dev dependency with asyncio and coverage plugins configured.
+
+  - title: 'Mocking Library'
+    chosen: 'unittest.mock (stdlib)'
+    rejected:
+      - 'pytest-mock — Adds a dependency for marginal convenience'
+    rationale: >
+      patch() for module-level replacement, MagicMock for spec objects,
+      assert_called_with for verification. No new dependency needed.
+```
+
+> **`tasks.yaml`** — TDD task breakdown
+
+```yaml
+tasks:
+  - id: task-1
+    title: 'Create conftest.py with shared fixtures'
+    dependencies: []
+    acceptanceCriteria:
+      - 'mock_settings returns a Settings instance with known values'
+      - 'mock_llm returns MagicMock(spec=LLM) for agent tests'
+      - 'tmp_repo creates a temp dir with git init and one commit'
+    tdd:
+      red: ['Write test_smoke.py that imports fixtures and asserts properties']
+      green: ['Implement conftest.py with all three fixtures']
+      refactor: ['Remove smoke test — subsumed by real test files']
+
+  - id: task-3
+    title: 'Test config/llm.py'
+    dependencies: [task-1]
+    acceptanceCriteria:
+      - 'test_create_llm_with_openai_provider: verifies model, temperature, api_key'
+      - 'test_create_llm_with_cursor_provider: verifies base_url included'
+      - 'test_get_fast_llm: calls create_llm with settings.fast_model'
+    tdd:
+      red: ['Patch LLM and get_settings, assert constructor kwargs']
+      green: ['Tests pass — they verify existing code with mocks']
+      refactor: ['Extract common patch decorators if repetitive']
+```
+
+> **`feature.yaml`** — machine-readable progress (updated continuously)
+
+```yaml
+feature:
+  id: '001-add-unit-tests'
+  branch: 'feat/001-add-unit-tests'
+  lifecycle: 'research'
+
+status:
+  phase: 'research'
+  progress: { completed: 0, total: 12, percentage: 0 }
+  lastUpdatedBy: 'feature-agent'
+```
+
+</details>
+
+---
+
+Running AI agents is easy. **Managing many of them through a full SDLC is the hard part.** Shep gives you a control center that handles the entire lifecycle — requirements gathering, planning, implementation, QA, and deployment — across multiple agent sessions running in parallel. See what each agent is doing, jump into any session's web preview, code editor, or terminal, approve plans when agents need your input, and let them keep working while you move on. Plug in Claude Code, Cursor CLI, Gemini CLI, or any coding agent. Each feature gets its own isolated worktree and dev environment. You manage the lifecycle, agents do the work.
+
 ---
 
 ## Features
 
+> 🚧 **Under active development** — Web UI screenshots are from the design spec. Core CLI (`feat new`, `feat ls`, `feat show`, `settings`, `ui`) works today. Some commands (`mem`, `start`) are still WIP.
+
 <table>
 <tr>
 <td width="55%"><img src="docs/poc/imgs/01-features-control-center-overview.png" alt="Feature properties with attachments and metadata" /></td>
@@ -182,21 +338,11 @@ shep ui
 ## Quick Start
 
 ```bash
-# Install
-npm i -g @shepai/cli
-
-# Start the background service
-shep start
-#  ➜  Local:   http://localhost:5173/
-#  Shep service is running in background, have fun!
-
-# Navigate to any repo
-cd ~/repos/your-project
-
-# Create your first feature
+# Navigate to any repo and create a feature
+cd ~/projects/your-app
 shep feat new "Add user authentication with OAuth 2.0"
 
-# Open the control center
+# Open the control center to watch progress
 shep ui
 ```
 

package/dist/src/application/ports/output/agents/agent-executor.interface.d.ts

@@ -68,6 +68,8 @@ export interface AgentExecutionOptions {
     outputSchema?: object;
     /** Execution timeout in milliseconds */
     timeout?: number;
+    /** Suppress executor debug logging (e.g. for quick foreground calls) */
+    silent?: boolean;
 }
 /**
  * Port interface for executing prompts against an AI agent.

package/dist/src/application/ports/output/agents/agent-executor.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-executor.interface.d.ts","sourceRoot":"","sources":["../../../../../../src/application/ports/output/agents/agent-executor.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,KAAK,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,2DAA2D;IAC3D,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtC,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAExF;;;;;;OAMG;IACH,aAAa,CACX,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;CACjD"}
+{"version":3,"file":"agent-executor.interface.d.ts","sourceRoot":"","sources":["../../../../../../src/application/ports/output/agents/agent-executor.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,KAAK,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,2DAA2D;IAC3D,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtC,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAExF;;;;;;OAMG;IACH,aAAa,CACX,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;CACjD"}

package/dist/src/application/use-cases/features/create-feature.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/features/create-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAClG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2DAA2D,CAAC;AACzG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+DAA+D,CAAC;AAO3G,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAQD,qBACa,oBAAoB;IAG7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAVf,WAAW,EAAE,kBAAkB,EAE/B,eAAe,EAAE,gBAAgB,EAEjC,YAAY,EAAE,2BAA2B,EAEzC,aAAa,EAAE,mBAAmB,EAElC,eAAe,EAAE,uBAAuB,EAExC,eAAe,EAAE,qBAAqB;IAGnD,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;YA8E5C,gBAAgB;IA6C9B,OAAO,CAAC,MAAM;CAQf"}
+{"version":3,"file":"create-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/features/create-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAClG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2DAA2D,CAAC;AACzG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+DAA+D,CAAC;AAO3G,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAQD,qBACa,oBAAoB;IAG7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAVf,WAAW,EAAE,kBAAkB,EAE/B,eAAe,EAAE,gBAAgB,EAEjC,YAAY,EAAE,2BAA2B,EAEzC,aAAa,EAAE,mBAAmB,EAElC,eAAe,EAAE,uBAAuB,EAExC,eAAe,EAAE,qBAAqB;IAGnD,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;YA8E5C,gBAAgB;IA8C9B,OAAO,CAAC,MAAM;CAQf"}

package/dist/src/application/use-cases/features/create-feature.use-case.js

@@ -124,6 +124,7 @@ JSON only, no markdown fences.`;
             const result = await executor.execute(prompt, {
                 maxTurns: 1,
                 allowedTools: [],
+                silent: true,
             });
             const parsed = JSON.parse(result.result);
             if (!parsed.slug || !parsed.name || !parsed.description) {

package/dist/src/infrastructure/services/agents/common/executors/claude-code-executor.service.d.ts

@@ -24,6 +24,8 @@ export type SpawnFunction = (command: string, args: string[], options?: object)
 export declare class ClaudeCodeExecutorService implements IAgentExecutor {
     private readonly spawn;
     readonly agentType: AgentType;
+    /** When true, suppresses debug logging (set per-call via options.silent) */
+    private silent;
     constructor(spawn: SpawnFunction);
     /** Debug logging — writes to stdout so it appears in the worker log file */
     private log;

package/dist/src/infrastructure/services/agents/common/executors/claude-code-executor.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-code-executor.service.d.ts","sourceRoot":"","sources":["../../../../../../../src/infrastructure/services/agents/common/executors/claude-code-executor.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACzF,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,4EAA4E,CAAC;AAEpF;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,YAAY,CAAC;AAUhG;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,cAAc;IAGlD,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAA8B;gBAE9B,KAAK,EAAE,aAAa;IAEjD,4EAA4E;IAC5E,OAAO,CAAC,GAAG;IAKL,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAkHtF,aAAa,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAAC,yBAAyB,CAAC;IA+F3C;;;OAGG;IACH,OAAO,CAAC,cAAc;IAmCtB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI/C,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,eAAe;CAkExB"}
+{"version":3,"file":"claude-code-executor.service.d.ts","sourceRoot":"","sources":["../../../../../../../src/infrastructure/services/agents/common/executors/claude-code-executor.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACzF,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,4EAA4E,CAAC;AAEpF;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,YAAY,CAAC;AAUhG;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,cAAc;IAMlD,OAAO,CAAC,QAAQ,CAAC,KAAK;IALlC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAA8B;IAE3D,4EAA4E;IAC5E,OAAO,CAAC,MAAM,CAAS;gBAEM,KAAK,EAAE,aAAa;IAEjD,4EAA4E;IAC5E,OAAO,CAAC,GAAG;IAML,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAmHtF,aAAa,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAAC,yBAAyB,CAAC;IA+F3C;;;OAGG;IACH,OAAO,CAAC,cAAc;IAmCtB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI/C,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,eAAe;CAkExB"}

package/dist/src/infrastructure/services/agents/common/executors/claude-code-executor.service.js

@@ -22,15 +22,20 @@ const SUPPORTED_FEATURES = new Set([
 export class ClaudeCodeExecutorService {
     spawn;
     agentType = 'claude-code';
+    /** When true, suppresses debug logging (set per-call via options.silent) */
+    silent = false;
     constructor(spawn) {
         this.spawn = spawn;
     }
     /** Debug logging — writes to stdout so it appears in the worker log file */
     log(message) {
+        if (this.silent)
+            return;
         const ts = new Date().toISOString();
         process.stdout.write(`[${ts}] [claude-executor] ${message}\n`);
     }
     async execute(prompt, options) {
+        this.silent = options?.silent ?? false;
         // Use stream-json so we get real-time events in the worker log
         // instead of zero output for minutes with --output-format json
         const args = this.buildStreamArgs(prompt, options);

package/dist/src/infrastructure/services/agents/feature-agent/nodes/implement.node.d.ts

@@ -1,11 +1,12 @@
-import type { IAgentExecutor } from '../../../../../application/ports/output/agents/agent-executor.interface.js';
-import type { FeatureAgentState } from '../state.js';
 /**
- * Creates the implement node — PLACEHOLDER.
+ * Implement Node — Phase-Level Orchestrator
  *
- * Implementation execution is not yet wired up.
- * Returns a programming joke to clearly signal this is a placeholder
- * while keeping the graph pipeline intact.
+ * Reads plan.yaml and tasks.yaml, then executes each phase by building
+ * a focused implementation prompt and calling the executor. Parallel
+ * phases spawn concurrent executor calls. Progress is tracked in
+ * feature.yaml between phases.
  */
-export declare function createImplementNode(_executor: IAgentExecutor): (_state: FeatureAgentState) => Promise<Partial<FeatureAgentState>>;
+import type { IAgentExecutor } from '../../../../../application/ports/output/agents/agent-executor.interface.js';
+import type { FeatureAgentState } from '../state.js';
+export declare function createImplementNode(executor: IAgentExecutor): (state: FeatureAgentState) => Promise<Partial<FeatureAgentState>>;
 //# sourceMappingURL=implement.node.d.ts.map

package/dist/src/infrastructure/services/agents/feature-agent/nodes/implement.node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"implement.node.d.ts","sourceRoot":"","sources":["../../../../../../../src/infrastructure/services/agents/feature-agent/nodes/implement.node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+DAA+D,CAAC;AACpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAKrD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,cAAc,IAG7C,QAAQ,iBAAiB,KAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAY9E"}
+{"version":3,"file":"implement.node.d.ts","sourceRoot":"","sources":["../../../../../../../src/infrastructure/services/agents/feature-agent/nodes/implement.node.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+DAA+D,CAAC;AACpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA2DrD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,IAG5C,OAAO,iBAAiB,KAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAqJ7E"}

package/dist/src/infrastructure/services/agents/feature-agent/nodes/implement.node.js

@@ -1,23 +1,147 @@
-import { createNodeLogger } from './node-helpers.js';
-import { reportNodeStart } from '../heartbeat.js';
-import { getImplementPlaceholderJoke } from './prompts/implement.prompt.js';
 /**
- * Creates the implement node — PLACEHOLDER.
+ * Implement Node — Phase-Level Orchestrator
  *
- * Implementation execution is not yet wired up.
- * Returns a programming joke to clearly signal this is a placeholder
- * while keeping the graph pipeline intact.
+ * Reads plan.yaml and tasks.yaml, then executes each phase by building
+ * a focused implementation prompt and calling the executor. Parallel
+ * phases spawn concurrent executor calls. Progress is tracked in
+ * feature.yaml between phases.
+ */
+import yaml from 'js-yaml';
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { interrupt, isGraphBubbleUp } from '@langchain/langgraph';
+import { createNodeLogger, readSpecFile, buildExecutorOptions, shouldInterrupt, } from './node-helpers.js';
+import { reportNodeStart } from '../heartbeat.js';
+import { buildImplementPhasePrompt, } from './prompts/implement.prompt.js';
+/**
+ * Update feature.yaml with current implementation progress.
+ * Silently no-ops if the file is missing or unparseable.
  */
-export function createImplementNode(_executor) {
+function updateFeatureProgress(specDir, completedCount, totalCount, currentPhase, currentTaskId, log) {
+    try {
+        const content = readSpecFile(specDir, 'feature.yaml');
+        if (!content)
+            return;
+        const data = yaml.load(content);
+        if (!data || typeof data !== 'object')
+            return;
+        const status = (data.status ?? {});
+        data.status = {
+            ...status,
+            phase: currentPhase,
+            progress: {
+                completed: completedCount,
+                total: totalCount,
+                percentage: totalCount > 0 ? Math.round((completedCount / totalCount) * 100) : 0,
+            },
+            currentTask: currentTaskId,
+            lastUpdated: new Date().toISOString(),
+            lastUpdatedBy: 'feature-agent:implement',
+        };
+        writeFileSync(join(specDir, 'feature.yaml'), yaml.dump(data, { indent: 2, lineWidth: -1 }), 'utf-8');
+    }
+    catch (err) {
+        log.error(`Failed to update feature.yaml: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+export function createImplementNode(executor) {
     const log = createNodeLogger('implement');
-    return async (_state) => {
-        log.info('Starting... (placeholder — implementation not yet wired)');
+    return async (state) => {
+        log.info('Starting implementation phase orchestration');
         reportNodeStart('implement');
-        const joke = getImplementPlaceholderJoke();
-        log.info(`Placeholder complete. ${joke}`);
-        return {
-            currentNode: 'implement',
-            messages: [`[implement] Placeholder — ${joke}`],
-        };
+        const startTime = Date.now();
+        const messages = [];
+        try {
+            // --- Parse plan & tasks ---
+            const planContent = readSpecFile(state.specDir, 'plan.yaml');
+            const tasksContent = readSpecFile(state.specDir, 'tasks.yaml');
+            if (!planContent || !tasksContent) {
+                const msg = 'Missing plan.yaml or tasks.yaml — cannot implement';
+                log.error(msg);
+                return { currentNode: 'implement', error: msg, messages: [`[implement] Error: ${msg}`] };
+            }
+            const planData = yaml.load(planContent);
+            const tasksData = yaml.load(tasksContent);
+            if (!planData?.phases?.length || !tasksData?.tasks?.length) {
+                const msg = 'Empty phases or tasks — nothing to implement';
+                log.error(msg);
+                return { currentNode: 'implement', error: msg, messages: [`[implement] Error: ${msg}`] };
+            }
+            const taskMap = new Map(tasksData.tasks.map((t) => [t.id, t]));
+            const totalTasks = tasksData.tasks.length;
+            let completedTasks = 0;
+            const totalPhases = planData.phases.length;
+            // --- Execute phases in order ---
+            for (let i = 0; i < totalPhases; i++) {
+                const phase = planData.phases[i];
+                const isLastPhase = i === totalPhases - 1;
+                // Resolve tasks: use explicit taskIds if present, otherwise match by phaseId
+                const phaseTasks = phase.taskIds?.length
+                    ? phase.taskIds
+                        .map((id) => taskMap.get(id))
+                        .filter((t) => t !== undefined)
+                    : tasksData.tasks.filter((t) => t.phaseId === phase.id);
+                if (phaseTasks.length === 0) {
+                    log.info(`Phase ${phase.id} "${phase.name}" — no tasks, skipping`);
+                    continue;
+                }
+                log.info(`Phase ${phase.id} "${phase.name}" — ${phaseTasks.length} task(s), parallel: ${phase.parallel}`);
+                updateFeatureProgress(state.specDir, completedTasks, totalTasks, `implementing-${phase.id}`, phaseTasks[0].id, log);
+                const options = buildExecutorOptions(state);
+                const promptContext = { isLastPhase, phaseIndex: i, totalPhases };
+                if (phase.parallel && phaseTasks.length > 1) {
+                    // Parallel: one executor call per task
+                    log.info(`Spawning ${phaseTasks.length} parallel executor calls`);
+                    const results = await Promise.all(phaseTasks.map((task) => {
+                        const singleTaskPhase = {
+                            ...phase,
+                            taskIds: [task.id],
+                        };
+                        const prompt = buildImplementPhasePrompt(state, singleTaskPhase, [task], promptContext);
+                        log.info(`  [parallel] Task ${task.id}: "${task.title}" — ${prompt.length} chars`);
+                        return executor.execute(prompt, options);
+                    }));
+                    for (let j = 0; j < results.length; j++) {
+                        log.info(`  [parallel] Task ${phaseTasks[j].id} complete (${results[j].result.length} chars)`);
+                    }
+                }
+                else {
+                    // Sequential: single executor call with all phase tasks
+                    const prompt = buildImplementPhasePrompt(state, phase, phaseTasks, promptContext);
+                    log.info(`Executing phase prompt — ${prompt.length} chars`);
+                    const result = await executor.execute(prompt, options);
+                    log.info(`Phase complete (${result.result.length} chars)`);
+                }
+                completedTasks += phaseTasks.length;
+                const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+                messages.push(`[implement] Phase ${phase.id} "${phase.name}" — ${phaseTasks.length} task(s) done (${elapsed}s)`);
+                updateFeatureProgress(state.specDir, completedTasks, totalTasks, `implementing-${phase.id}`, null, log);
+            }
+            // --- Final ---
+            const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+            log.info(`All phases complete — ${completedTasks}/${totalTasks} tasks (${elapsed}s)`);
+            updateFeatureProgress(state.specDir, totalTasks, totalTasks, 'implementation-complete', null, log);
+            messages.push(`[implement] Complete: ${totalTasks} tasks across ${totalPhases} phases (${elapsed}s)`);
+            if (shouldInterrupt('implement', state.approvalMode)) {
+                log.info('Interrupting for human approval');
+                interrupt({
+                    node: 'implement',
+                    message: `Implementation complete: ${totalTasks} tasks across ${totalPhases} phases. Approve to finish.`,
+                });
+            }
+            return { currentNode: 'implement', messages };
+        }
+        catch (err) {
+            if (isGraphBubbleUp(err))
+                throw err;
+            const message = err instanceof Error ? err.message : String(err);
+            const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+            log.error(`${message} (after ${elapsed}s)`);
+            return {
+                currentNode: 'implement',
+                error: message,
+                messages: [...messages, `[implement] Error: ${message}`],
+            };
+        }
     };
 }

package/dist/src/infrastructure/services/agents/feature-agent/nodes/prompts/implement.prompt.d.ts

@@ -1,8 +1,48 @@
 /**
- * Implement Phase Prompt — PLACEHOLDER
+ * Implement Phase Prompt
  *
- * The implement phase is not yet wired up. This returns a programming joke
- * to clearly signal it's a placeholder while keeping the graph pipeline intact.
+ * Builds per-phase implementation prompts that include full spec/research/plan
+ * context plus the specific tasks for the current phase, with TDD guidance
+ * and verification instructions.
  */
-export declare function getImplementPlaceholderJoke(): string;
+import type { FeatureAgentState } from '../../state.js';
+export interface PhaseTask {
+    id: string;
+    phaseId?: string;
+    title: string;
+    description: string;
+    state: string;
+    dependencies: string[];
+    acceptanceCriteria: string[];
+    tdd: {
+        red: string[];
+        green: string[];
+        refactor: string[];
+    } | null;
+    estimatedEffort: string;
+}
+export interface PlanPhase {
+    id: string;
+    name: string;
+    description?: string;
+    parallel: boolean;
+    /** Optional — if absent, tasks are matched via their phaseId field */
+    taskIds?: string[];
+}
+export interface PlanYaml {
+    phases: PlanPhase[];
+}
+export interface TasksYaml {
+    tasks: PhaseTask[];
+}
+/**
+ * Build the implementation prompt for a single phase (or a single task
+ * within a parallel phase). Includes full project context so each
+ * executor session is self-contained.
+ */
+export declare function buildImplementPhasePrompt(state: FeatureAgentState, phase: PlanPhase, tasks: PhaseTask[], context: {
+    isLastPhase: boolean;
+    phaseIndex: number;
+    totalPhases: number;
+}): string;
 //# sourceMappingURL=implement.prompt.d.ts.map

package/dist/src/infrastructure/services/agents/feature-agent/nodes/prompts/implement.prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"implement.prompt.d.ts","sourceRoot":"","sources":["../../../../../../../../src/infrastructure/services/agents/feature-agent/nodes/prompts/implement.prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD"}
+{"version":3,"file":"implement.prompt.d.ts","sourceRoot":"","sources":["../../../../../../../../src/infrastructure/services/agents/feature-agent/nodes/prompts/implement.prompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,GAAG,EAAE;QAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IACnE,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAwBD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAAE,EAClB,OAAO,EAAE;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACzE,MAAM,CA8DR"}

package/dist/src/infrastructure/services/agents/feature-agent/nodes/prompts/implement.prompt.js

@@ -1,18 +1,90 @@
 /**
- * Implement Phase Prompt — PLACEHOLDER
+ * Implement Phase Prompt
  *
- * The implement phase is not yet wired up. This returns a programming joke
- * to clearly signal it's a placeholder while keeping the graph pipeline intact.
+ * Builds per-phase implementation prompts that include full spec/research/plan
+ * context plus the specific tasks for the current phase, with TDD guidance
+ * and verification instructions.
  */
-const JOKES = [
-    'Why do programmers prefer dark mode? Because light attracts bugs.',
-    'A SQL query walks into a bar, walks up to two tables and asks... "Can I JOIN you?"',
-    "There are only 10 types of people: those who understand binary, and those who don't.",
-    "Why was the JavaScript developer sad? Because he didn't Node how to Express himself.",
-    "What's a programmer's favorite hangout place? Foo Bar.",
-    'To understand recursion, you must first understand recursion.',
-    "!false — it's funny because it's true.",
-];
-export function getImplementPlaceholderJoke() {
-    return JOKES[Math.floor(Math.random() * JOKES.length)];
+import { readSpecFile } from '../node-helpers.js';
+function formatTaskSection(task) {
+    let section = `### Task ${task.id}: ${task.title}\n${task.description}\n`;
+    section += `\n**Acceptance Criteria:**\n`;
+    for (const criterion of task.acceptanceCriteria) {
+        section += `- ${criterion}\n`;
+    }
+    if (task.tdd) {
+        section += `\n**TDD Guidance:**\n`;
+        section += `- Write tests for: ${task.tdd.red.join('; ')}\n`;
+        section += `- Implement: ${task.tdd.green.join('; ')}\n`;
+        section += `- Then consider: ${task.tdd.refactor.join('; ')}\n`;
+    }
+    if (task.dependencies.length > 0) {
+        section += `\nDepends on: ${task.dependencies.join(', ')}\n`;
+    }
+    return section;
+}
+/**
+ * Build the implementation prompt for a single phase (or a single task
+ * within a parallel phase). Includes full project context so each
+ * executor session is self-contained.
+ */
+export function buildImplementPhasePrompt(state, phase, tasks, context) {
+    const specContent = readSpecFile(state.specDir, 'spec.yaml');
+    const researchContent = readSpecFile(state.specDir, 'research.yaml');
+    const planContent = readSpecFile(state.specDir, 'plan.yaml');
+    const cwd = state.worktreePath || state.repositoryPath;
+    const taskSections = tasks.map(formatTaskSection).join('\n');
+    const verificationBlock = context.isLastPhase
+        ? `4. Run full project validation:
+   - \`pnpm test\` (all tests must pass)
+   - \`pnpm lint\` (no lint errors)
+   - \`pnpm typecheck\` (no type errors)
+   - Fix any issues before finishing`
+        : `4. Run tests relevant to what you changed:
+   - Run targeted tests for modified files (e.g. \`pnpm test:single <test-file>\`)
+   - Fix any test failures before moving on`;
+    return `You are a senior software engineer performing autonomous implementation.
+You are executing phase ${context.phaseIndex + 1} of ${context.totalPhases}: "${phase.name}".
+
+## Feature Specification
+
+\`\`\`yaml
+${specContent}
+\`\`\`
+
+## Research Decisions
+
+\`\`\`yaml
+${researchContent}
+\`\`\`
+
+## Implementation Plan
+
+\`\`\`yaml
+${planContent}
+\`\`\`
+
+## Your Tasks for This Phase: "${phase.name}"
+
+${taskSections}
+
+## Implementation Instructions
+
+1. Work through each task in dependency order
+2. For tasks with TDD guidance: write tests alongside implementation following the hints provided — use them as guidance, not rigid steps
+3. Follow existing codebase conventions for file placement, naming patterns, and architecture layers
+${verificationBlock}
+5. Commit your work with descriptive conventional commit messages (e.g. \`feat(scope): description\`)
+
+## Working Directory
+
+${cwd}
+
+## Constraints
+
+- Implement ONLY the tasks listed above — do not work ahead to future phases
+- Follow existing codebase conventions and architecture patterns
+- Do NOT modify any spec YAML files (spec.yaml, research.yaml, plan.yaml, tasks.yaml, feature.yaml)
+- Do NOT skip writing tests for tasks that have TDD guidance
+- Keep changes focused and minimal — avoid unnecessary refactoring beyond what the tasks specify`;
 }