@open-agent-toolkit/cli 0.0.43 → 0.0.50

package/assets/skills/oat-project-import-plan/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-project-import-plan
-version: 1.2.0
+version: 1.2.1
 description: Use when you have an external markdown plan to execute with OAT. Preserves the source plan and normalizes it into canonical plan.md format.
 argument-hint: '<path-to-plan.md> [--provider codex|cursor|claude] [--project <name>]'
 disable-model-invocation: true
@@ -212,8 +212,7 @@ Report:
 - active project pointer path
 - dashboard refresh status
 - next options:
-  - `oat-project-implement` (sequential, default)
-  - `oat-project-subagent-implement` (parallel with autonomous review gates)
+  - `oat-project-implement` (sequential by default; parallel when `oat_plan_parallel_groups` is declared)
 
 ## Success Criteria
 

package/assets/skills/oat-project-next/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-project-next
-version: 1.0.1
+version: 1.0.3
 description: Use when continuing work on the active OAT project. Reads project state, determines the next lifecycle action, and invokes the appropriate skill automatically.
 disable-model-invocation: true
 user-invocable: true
@@ -101,15 +101,14 @@ ls -d "$PROJECTS_ROOT"/*/ 2>/dev/null
 
 Read `"$PROJECT_PATH/state.md"` frontmatter and extract:
 
-| Field                  | Used For                                                                                |
-| ---------------------- | --------------------------------------------------------------------------------------- |
-| `oat_phase`            | Current lifecycle position (discovery, spec, design, plan, implement)                   |
-| `oat_phase_status`     | Phase completion state (in_progress, complete, pr_open)                                 |
-| `oat_workflow_mode`    | Routing table selection (spec-driven, quick, import). Default: `spec-driven`            |
-| `oat_execution_mode`   | Implementation skill variant (single-thread, subagent-driven). Default: `single-thread` |
-| `oat_hill_checkpoints` | Which phases require HiLL approval                                                      |
-| `oat_hill_completed`   | Which HiLL gates have been passed                                                       |
-| `oat_blockers`         | Informational warnings (not routing gates)                                              |
+| Field                  | Used For                                                                     |
+| ---------------------- | ---------------------------------------------------------------------------- |
+| `oat_phase`            | Current lifecycle position (discovery, spec, design, plan, implement)        |
+| `oat_phase_status`     | Phase completion state (in_progress, complete, pr_open)                      |
+| `oat_workflow_mode`    | Routing table selection (spec-driven, quick, import). Default: `spec-driven` |
+| `oat_hill_checkpoints` | Which phases require HiLL approval                                           |
+| `oat_hill_completed`   | Which HiLL gates have been passed                                            |
+| `oat_blockers`         | Informational warnings (not routing gates)                                   |
 
 **If state.md is missing or unreadable:** Report error and suggest running the relevant phase skill directly. STOP.
 
@@ -231,7 +230,7 @@ Otherwise, look up the target skill from the routing table for the current `oat_
 | plan          | complete     | tier 1        | `oat-project-implement` \* |
 | implement     | in_progress  | —             | `oat-project-implement` \* |
 
-\* When `oat_execution_mode: subagent-driven`, use `oat-project-subagent-implement` instead.
+\* `oat-project-implement` handles both sequential and parallel execution.
 
 ### Step 4: Check for Unprocessed Reviews (Review Safety Check)
 
@@ -261,7 +260,7 @@ Apply the following checks in priority order. Stop at the first match:
 **5.1: Incomplete revision tasks**
 
 Grep plan.md for `p-revN` phases. If any `p-revN` tasks exist with status != completed in implementation.md:
-→ Route to `oat-project-implement` (or `oat-project-subagent-implement` if subagent-driven)
+→ Route to `oat-project-implement`
 → Announce: "Revision tasks pending — continuing implementation"
 
 **5.2: Unprocessed reviews**

package/assets/skills/oat-project-plan/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-project-plan
-version: 1.2.0
+version: 1.3.1
 description: Use when design.md is complete and executable implementation tasks are needed. Breaks design into bite-sized TDD tasks in canonical plan.md format.
 disable-model-invocation: true
 user-invocable: true
@@ -271,12 +271,13 @@ For each task, include:
 - **Files:** Exact paths for create/modify/delete
 - **Signatures:** Interface definitions, function signatures, type declarations
 - **Test cases:** Test file paths and test descriptions (pseudocode OK for test bodies)
-- **Commands:** Exact verification commands
+- **Commands:** Exact verification commands that match the claimed scope. If the task says "run this file" or "run this test target," use the real runner invocation that actually scopes to that target rather than a shortcut that may execute the full package suite.
 - **Commit:** Conventional commit message with task ID (e.g., `feat(p01-t03): ...`)
 
 **Avoid:**
 - Vague instructions ("update the file")
 - Missing verification steps
+- Verification shortcuts that claim file-scoped coverage but actually run a broader suite
 - Bundled unrelated changes
 - Full implementation code (leave that for oat-project-implement)
 
@@ -342,6 +343,25 @@ oat_last_updated: {today}
 ---
 ````
 
+### Step 14.5: Propose Parallel Groups (Optional)
+
+After all phases are drafted, evaluate whether any phases have non-overlapping file boundaries:
+
+1. For each pair of adjacent phases in the plan, check the `Files:` section of all tasks in each phase.
+2. If no file appears in both phases' task files sections, they are candidates for a parallel group.
+3. Propose to the user:
+
+   ```
+   I noticed phases p02 and p03 have disjoint file boundaries (no overlap).
+   Declare them as a parallel group? This lets oat-project-implement run them
+   concurrently in worktrees, cutting wall-clock time.
+   ```
+
+4. If the user confirms, update `oat_plan_parallel_groups` in the plan frontmatter.
+5. If no phases are obviously independent, skip this step silently — do not invent parallelism.
+
+Never silently infer parallelism without explicit user confirmation.
+
 ### Step 14: Update Project State
 
 Update `"$PROJECT_PATH/state.md"`:
@@ -400,9 +420,7 @@ Phases:
 
 Total: {N} tasks
 
-Next: Choose your implementation approach:
-- oat-project-implement — Sequential task execution (default)
-- oat-project-subagent-implement — Parallel worktree execution with autonomous review gates
+Next: Run oat-project-implement to begin execution.
 ```
 
 ## Success Criteria

package/assets/skills/oat-project-plan-writing/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-project-plan-writing
-version: 1.2.0
+version: 1.2.1
 description: Use when authoring or mutating plan.md in any OAT workflow. Defines canonical format invariants — stable task IDs, required sections, review table rules, and resume guardrails.
 disable-model-invocation: true
 user-invocable: false
@@ -47,7 +47,7 @@ Planning-time default:
 Runtime routing note:
 
 - Keep `oat_ready_for` canonical as `oat-project-implement`.
-- Use `oat_execution_mode` in `state.md` (`single-thread` or `subagent-driven`) to choose sequential vs subagent implementation flow at runtime.
+- Declare parallelism via `oat_plan_parallel_groups` in plan.md frontmatter (empty = sequential; nested arrays of phase IDs = parallel groups). `oat-project-implement` reads this field to choose sequential vs worktree-isolated parallel execution.
 
 Additional frontmatter keys (`oat_phase`, `oat_phase_status`, `oat_blockers`, `oat_last_updated`, `oat_generated`, `oat_template`, `oat_import_reference`, `oat_import_source_path`, `oat_import_provider`) are set by calling skills as needed.
 

package/assets/skills/oat-project-progress/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-project-progress
-version: 1.2.0
+version: 1.2.2
 description: Use when resuming work, checking status, or unsure which OAT skill to run next. Evaluates project progress and routes to the appropriate next step.
 disable-model-invocation: true
 user-invocable: true
@@ -180,11 +180,6 @@ Read `oat_workflow_mode` from `state.md` frontmatter:
 - `quick`
 - `import`
 
-Read `oat_execution_mode` from `state.md` frontmatter:
-
-- `single-thread` (default if missing)
-- `subagent-driven`
-
 **HiLL override (apply before phase routing):**
 
 - If current `oat_phase` is listed in `oat_hill_checkpoints` **and** not listed in `oat_hill_completed`, the phase's HiLL gate is still pending.
@@ -228,38 +223,38 @@ Routing matrix by mode:
 
 **Spec-Driven mode (`oat_workflow_mode: spec-driven`):**
 
-| oat_phase | oat_phase_status | Next Skill                                                                                                                                                                                                                                                                                                  |
-| --------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| discovery | in_progress      | Continue `oat-project-discover`                                                                                                                                                                                                                                                                             |
-| discovery | complete         | `oat-project-spec`                                                                                                                                                                                                                                                                                          |
-| spec      | in_progress      | Continue `oat-project-spec`                                                                                                                                                                                                                                                                                 |
-| spec      | complete         | `oat-project-design`                                                                                                                                                                                                                                                                                        |
-| design    | in_progress      | Continue `oat-project-design`                                                                                                                                                                                                                                                                               |
-| design    | complete         | `oat-project-plan`                                                                                                                                                                                                                                                                                          |
-| plan      | in_progress      | Continue `oat-project-plan`                                                                                                                                                                                                                                                                                 |
-| plan      | complete         | `oat-project-subagent-implement` when `oat_execution_mode: subagent-driven`, otherwise `oat-project-implement`                                                                                                                                                                                              |
-| implement | in_progress      | Continue `oat-project-subagent-implement` when `oat_execution_mode: subagent-driven`, otherwise `oat-project-implement`. If artifacts appear out of sync with recent commits (e.g., `implementation.md` has fewer completed tasks than commits suggest), also mention `oat-project-reconcile` as an option. |
-| implement | complete         | Ready for final review / PR                                                                                                                                                                                                                                                                                 |
+| oat_phase | oat_phase_status | Next Skill                                                                                                                                                                                                           |
+| --------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| discovery | in_progress      | Continue `oat-project-discover`                                                                                                                                                                                      |
+| discovery | complete         | `oat-project-spec`                                                                                                                                                                                                   |
+| spec      | in_progress      | Continue `oat-project-spec`                                                                                                                                                                                          |
+| spec      | complete         | `oat-project-design`                                                                                                                                                                                                 |
+| design    | in_progress      | Continue `oat-project-design`                                                                                                                                                                                        |
+| design    | complete         | `oat-project-plan`                                                                                                                                                                                                   |
+| plan      | in_progress      | Continue `oat-project-plan`                                                                                                                                                                                          |
+| plan      | complete         | `oat-project-implement`                                                                                                                                                                                              |
+| implement | in_progress      | Continue `oat-project-implement`. If artifacts appear out of sync with recent commits (e.g., `implementation.md` has fewer completed tasks than commits suggest), also mention `oat-project-reconcile` as an option. |
+| implement | complete         | Ready for final review / PR                                                                                                                                                                                          |
 
 **Quick mode (`oat_workflow_mode: quick`):**
 
-| oat_phase | oat_phase_status | Next Skill                                                                                                                                                                                                                 |
-| --------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| discovery | in_progress      | Continue `oat-project-discover`                                                                                                                                                                                            |
-| discovery | complete         | `oat-project-plan`                                                                                                                                                                                                         |
-| plan      | in_progress      | Continue `oat-project-plan`                                                                                                                                                                                                |
-| plan      | complete         | `oat-project-subagent-implement` when `oat_execution_mode: subagent-driven`, otherwise `oat-project-implement`                                                                                                             |
-| implement | in_progress      | Continue `oat-project-subagent-implement` when `oat_execution_mode: subagent-driven`, otherwise `oat-project-implement`. If drift detected (see drift detection above), also mention `oat-project-reconcile` as an option. |
-| implement | complete         | Ready for final review / PR                                                                                                                                                                                                |
+| oat_phase | oat_phase_status | Next Skill                                                                                                                          |
+| --------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
+| discovery | in_progress      | Continue `oat-project-discover`                                                                                                     |
+| discovery | complete         | `oat-project-plan`                                                                                                                  |
+| plan      | in_progress      | Continue `oat-project-plan`                                                                                                         |
+| plan      | complete         | `oat-project-implement`                                                                                                             |
+| implement | in_progress      | Continue `oat-project-implement`. If drift detected (see drift detection above), also mention `oat-project-reconcile` as an option. |
+| implement | complete         | Ready for final review / PR                                                                                                         |
 
 **Import mode (`oat_workflow_mode: import`):**
 
-| oat_phase | oat_phase_status | Next Skill                                                                                                                                                                                                                 |
-| --------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| plan      | in_progress      | Continue `oat-project-import-plan`                                                                                                                                                                                         |
-| plan      | complete         | `oat-project-subagent-implement` when `oat_execution_mode: subagent-driven`, otherwise `oat-project-implement`                                                                                                             |
-| implement | in_progress      | Continue `oat-project-subagent-implement` when `oat_execution_mode: subagent-driven`, otherwise `oat-project-implement`. If drift detected (see drift detection above), also mention `oat-project-reconcile` as an option. |
-| implement | complete         | Ready for final review / PR                                                                                                                                                                                                |
+| oat_phase | oat_phase_status | Next Skill                                                                                                                          |
+| --------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
+| plan      | in_progress      | Continue `oat-project-import-plan`                                                                                                  |
+| plan      | complete         | `oat-project-implement`                                                                                                             |
+| implement | in_progress      | Continue `oat-project-implement`. If drift detected (see drift detection above), also mention `oat-project-reconcile` as an option. |
+| implement | complete         | Ready for final review / PR                                                                                                         |
 
 **If blockers exist:**
 
@@ -272,7 +267,7 @@ Address blocker before continuing.
 Execution-mode note:
 
 - Keep `oat_ready_for` in `plan.md` canonical (`oat-project-implement`).
-- Runtime routing at plan completion is controlled by `oat_execution_mode` in `state.md`.
+- Runtime execution is handled by `oat-project-implement`; parallelism is declared in plan.md via `oat_plan_parallel_groups`.
 
 ### Step 6: Show Available Skills
 
@@ -290,8 +285,7 @@ Workflow:
   oat-project-spec              - Create specification from discovery
   oat-project-design            - Create technical design from spec
   oat-project-plan              - Create implementation plan from design (spec-driven mode)
-  oat-project-implement         - Execute implementation plan
-  oat-project-subagent-implement - Execute implementation plan with subagent orchestration
+  oat-project-implement         - Execute implementation plan (sequential or parallel)
   oat-project-reconcile         - Reconcile manual/human commits with plan tasks
 
 Status:

package/assets/skills/oat-project-quick-start/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-project-quick-start
-version: 1.3.4
+version: 1.3.6
 description: Use when a task is small enough for quick mode or rapid iteration is preferred. Scaffolds a lightweight OAT project from discovery directly to a runnable plan, with optional brainstorming and lightweight design.
 argument-hint: '<project-name> ["project description"]'
 disable-model-invocation: true
@@ -301,6 +301,16 @@ Plan requirements — apply `oat-project-plan-writing` canonical format invarian
 - Required sections: `## Reviews`, `## Implementation Complete`, `## References`
 - Review table preservation rules (never delete existing rows)
 
+Required parallelism pass before finalizing the plan:
+
+- Evaluate adjacent phases for phase-level parallelism before treating the plan as complete.
+- Set `oat_plan_parallel_groups` whenever phases can run independently in isolated worktrees with disjoint write boundaries and independent verification.
+- Keep dependent tasks in the same phase when they must run sequentially.
+- Do not declare parallel groups when phases share a fragile migration, require the same generated artifact, or one phase's tests depend on another phase's behavior.
+- Add a short `## Parallelism` section to `plan.md` explaining the dependency and write-set reasoning, including why groups were declared or why the plan remains sequential.
+- Quick mode is not "sequential by default." A quick-start plan is sequential only when the dependency and write-set analysis says it should be.
+- When a task claims scoped verification, prefer the exact runner invocation that truly scopes to the intended file, test, or target instead of package-level shortcuts that may execute the full suite.
+
 ### Step 4: Sync Project State
 
 Update `"$PROJECT_PATH/state.md"`:
@@ -355,9 +365,9 @@ Report:
 - workflow mode (`quick`)
 - total phases/tasks generated
 - first task ID
+- execution shape summary (sequential or declared parallel groups)
 - next options:
-  - `oat-project-implement` (sequential, default)
-  - `oat-project-subagent-implement` (parallel with autonomous review gates)
+  - `oat-project-implement`
 - dashboard location: `.oat/state.md` (confirm it was regenerated)
 
 ## Success Criteria

package/assets/skills/oat-worktree-bootstrap-auto/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-worktree-bootstrap-auto
-version: 1.2.0
+version: 1.2.1
 description: Use when an orchestrator/subagent needs autonomous worktree bootstrap. Non-interactive companion to oat-worktree-bootstrap.
 argument-hint: '<branch-name> [--base <ref>] [--path <root>] [--baseline-policy <strict|allow-failing>]'
 disable-model-invocation: true
@@ -226,7 +226,7 @@ Append to `implementation.md` under `## Implementation Log`:
 
 **Orchestrator integration:**
 
-- When invoked by `oat-project-subagent-implement`, the baseline policy is passed through from the orchestration run policy.
+- When invoked by `oat-project-implement` in parallel mode, the baseline policy is passed through from the orchestration run policy.
 - The orchestrator may set `--baseline-policy allow-failing` for exploratory runs and `strict` for production-quality execution.
 - The bootstrap skill does not interpret HiLL checkpoints — that responsibility belongs to the orchestrator.
 

package/assets/templates/implementation.md

@@ -112,11 +112,16 @@ oat_template_name: implementation
 
 ## Orchestration Runs
 
-> This section is used by `oat-project-subagent-implement` to log parallel execution runs.
-> Each run appends a new subsection — never overwrite prior entries.
-> For single-thread execution (via `oat-project-implement`), this section remains empty.
+_Each run from `oat-project-implement` appends an entry below with:_
+_- Run header (number, timestamp, branch, tier, policy, phase counts)_
+_- Phase Outcomes table_
+_- Parallel Groups list_
+_- Outstanding Items_
 
 <!-- orchestration-runs-start -->
+
+_Orchestration runs from `oat-project-implement` are appended here, most-recent-first within the file but append-only at the bottom of the log._
+
 <!-- orchestration-runs-end -->
 
 ---

package/assets/templates/plan.md

@@ -6,6 +6,7 @@ oat_last_updated: YYYY-MM-DD
 oat_phase: plan
 oat_phase_status: in_progress
 oat_plan_hill_phases: [] # phases to pause AFTER completing (empty = every phase)
+oat_plan_parallel_groups: [] # groups of phases that run concurrently in worktrees; [] = fully sequential
 oat_plan_source: spec-driven # spec-driven | quick | imported
 oat_import_reference: null # e.g., references/imported-plan.md
 oat_import_source_path: null # original source path provided by user
@@ -17,7 +18,7 @@ oat_template_name: plan
 
 # Implementation Plan: {Project Name}
 
-> Execute this plan using `oat-project-implement` (sequential) or `oat-project-subagent-implement` (parallel), with phase checkpoints and review gates.
+> Execute this plan using `oat-project-implement` — sequential by default, parallel when `oat_plan_parallel_groups` is declared.
 
 **Goal:** {Brief goal statement from spec}
 
@@ -31,6 +32,22 @@ oat_template_name: plan
 
 - [ ] Confirmed HiLL checkpoints with user
 - [ ] Set `oat_plan_hill_phases` in frontmatter
+- [ ] Evaluated phases for parallelism opportunities
+- [ ] Set `oat_plan_parallel_groups` in frontmatter
+
+---
+
+## Parallelism
+
+Phases that have no overlapping file modifications may run concurrently. To declare parallelism:
+
+```yaml
+oat_plan_parallel_groups: [['p02', 'p03']]
+```
+
+Each inner array is a group of phases that execute in parallel (each in its own worktree) and merge back in plan order after all pass. Groups themselves run sequentially.
+
+Default is `[]` (fully sequential, no worktrees). Only declare parallelism when phases are genuinely file-disjoint — overlap will produce merge conflicts that stop the run.
 
 ---
 
@@ -54,7 +71,7 @@ describe('{feature}', () => {
 });
 ```
 
-Run: `pnpm test {path/to/file.test.ts}`
+Run: `pnpm --filter {package-name} exec vitest run {path/to/file.test.ts}`
 Expected: Test fails (RED)
 
 **Step 2: Implement (GREEN)**
@@ -64,9 +81,11 @@ Expected: Test fails (RED)
 // Implementation code or interface signatures
 ```
 
-Run: `pnpm test {path/to/file.test.ts}`
+Run: `pnpm --filter {package-name} exec vitest run {path/to/file.test.ts}`
 Expected: Test passes (GREEN)
 
+Use the actual runner command that scopes to the intended file or test target. Do not write a package-level shortcut unless it truly executes only the scope the task claims.
+
 **Step 3: Refactor**
 
 {Any cleanup or improvements while tests stay green}
@@ -108,6 +127,8 @@ git commit -m "feat(p01-t01): {description}"
 Run: `{verification command}`
 Expected: {output}
 
+Verification commands should be behaviorally accurate. If the task claims a file-scoped or test-scoped check, use the concrete runner invocation that really scopes to that target.
+
 **Step 5: Commit**
 
 ```bash

package/assets/templates/state.md

@@ -8,7 +8,7 @@ oat_hill_completed: [] # Progress: which HiLL checkpoints have been completed
 oat_parallel_execution: false
 oat_phase: { OAT_PHASE } # Current phase: discovery | spec | design | plan | implement
 oat_phase_status: in_progress # Status: in_progress | complete | pr_open
-oat_execution_mode: single-thread # single-thread | subagent-driven
+# oat_orchestration_retry_limit: 2  # optional; override fix-loop retry limit (range 0-5)
 oat_workflow_mode: { OAT_WORKFLOW_MODE } # spec-driven | quick | import
 oat_workflow_origin: native # native | imported
 oat_docs_updated: null # null | skipped | complete — documentation sync status

package/dist/commands/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/config/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGhF,OAAO,EACL,KAAK,SAAS,EACd,KAAK,cAAc,EAGnB,KAAK,UAAU,EAOhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoDpC,UAAU,yBAAyB;IACjC,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,KACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/D,eAAe,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,sBAAsB,EAAE,CACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAyiCD,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CA0GT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/config/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGhF,OAAO,EACL,KAAK,SAAS,EACd,KAAK,cAAc,EAGnB,KAAK,UAAU,EAOhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqDpC,UAAU,yBAAyB;IACjC,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,KACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/D,eAAe,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,sBAAsB,EAAE,CACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAwjCD,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CA0GT"}

package/dist/commands/config/index.js

@@ -34,6 +34,7 @@ const KEY_ORDER = [
     'workflow.createPrOnComplete',
     'workflow.postImplementSequence',
     'workflow.reviewExecutionModel',
+    'workflow.autoReviewAtHillCheckpoints',
     'workflow.autoNarrowReReviewScope',
     'worktrees.root',
 ];
@@ -80,7 +81,7 @@ const CONFIG_CATALOG = [
         defaultValue: 'false',
         mutability: 'read/write',
         owningCommand: 'oat config set autoReviewAtCheckpoints <true|false>',
-        description: 'Controls whether OAT automatically runs review gates at configured phase checkpoints.',
+        description: 'Deprecated compatibility alias for workflow.autoReviewAtHillCheckpoints. Prefer `oat config set workflow.autoReviewAtHillCheckpoints <true|false>`.',
     },
     {
         key: 'documentation.root',
@@ -346,6 +347,17 @@ const CONFIG_CATALOG = [
         owningCommand: 'oat config set workflow.reviewExecutionModel <value>',
         description: 'Default execution model for the final review step in oat-project-implement: "subagent" dispatches a review subagent, "inline" runs the review in-context, "fresh-session" prints guidance for running the review in a separate session (with an escape hatch to subagent/inline). When unset, the skill prompts. Resolution: env > local > shared > user > default.',
     },
+    {
+        key: 'workflow.autoReviewAtHillCheckpoints',
+        group: 'Workflow Preferences (3-layer: local > shared > user)',
+        file: '.oat/config.local.json | .oat/config.json | ~/.oat/config.json',
+        scope: 'workflow',
+        type: 'boolean',
+        defaultValue: 'unset',
+        mutability: 'read/write',
+        owningCommand: 'oat config set workflow.autoReviewAtHillCheckpoints <true|false>',
+        description: 'Automatically run the extra lifecycle review when a HiLL checkpoint is reached. This does not control Tier 1 per-phase oat-reviewer gates. When unset, the skill prompts. Resolution: env > local > shared > user > legacy autoReviewAtCheckpoints > default.',
+    },
     {
         key: 'workflow.autoNarrowReReviewScope',
         group: 'Workflow Preferences (3-layer: local > shared > user)',
@@ -422,6 +434,7 @@ const WORKFLOW_ENUM_VALUES = {
 const WORKFLOW_BOOLEAN_KEYS = new Set([
     'workflow.archiveOnComplete',
     'workflow.createPrOnComplete',
+    'workflow.autoReviewAtHillCheckpoints',
     'workflow.autoNarrowReReviewScope',
 ]);
 function isWorkflowKey(key) {
@@ -467,10 +480,10 @@ function validateSurfaceForKey(key, surface) {
         }
         return;
     }
-    // autoReviewAtCheckpoints is currently shared-only. Multi-surface support
-    // for behavioral keys is out of scope for p01-t04 (workflow.* keys only).
+    // Legacy alias remains shared-only. The preferred multi-surface key is
+    // workflow.autoReviewAtHillCheckpoints.
     if (key === 'autoReviewAtCheckpoints' && surface !== 'shared') {
-        throw new Error(`Cannot set 'autoReviewAtCheckpoints' at '${surface}' scope. This key is currently shared-only.`);
+        throw new Error(`Cannot set 'autoReviewAtCheckpoints' at '${surface}' scope. This legacy key is shared-only; use workflow.autoReviewAtHillCheckpoints for local/user overrides.`);
     }
     // Workflow keys accept any non-auto surface.
 }

package/dist/commands/init/tools/index.js

@@ -349,7 +349,7 @@ export function buildToolPacksSectionBody(packs) {
         lines.push(`- **${pack}** — ${PACK_DESCRIPTIONS[pack]}${suffix}`);
     }
     if (hasWorkflows) {
-        lines.push('', '### Workflow Execution Continuation', '', '- This guidance applies only to OAT project lifecycle execution, such as `oat-project-implement`, `oat-project-subagent-implement`, and OAT project review/receive flows. It does not apply to non-OAT tasks or ad-hoc work outside the OAT project workflow.', '- When executing an OAT project implementation or OAT project review workflow, do not stop at task boundaries, phase boundaries, or other clean checkpoints unless the configured HiLL checkpoint has been reached, a real blocker exists, or explicit user input is required.', '- Status summaries, completed bookkeeping, and "clean boundary" pauses are not valid stop reasons. After updating tracking artifacts, continue execution until an allowed stop condition applies.');
+        lines.push('', '### Workflow Execution Continuation', '', '- This guidance applies only to OAT project lifecycle execution, such as `oat-project-implement`, and OAT project review/receive flows. It does not apply to non-OAT tasks or ad-hoc work outside the OAT project workflow.', '- When executing an OAT project implementation or OAT project review workflow, do not stop at task boundaries, phase boundaries, or other clean checkpoints unless the configured HiLL checkpoint has been reached, a real blocker exists, or explicit user input is required.', '- Status summaries, completed bookkeeping, and "clean boundary" pauses are not valid stop reasons. After updating tracking artifacts, continue execution until an allowed stop condition applies.');
     }
     return lines.join('\n');
 }

package/dist/commands/init/tools/shared/skill-manifest.d.ts

@@ -5,8 +5,8 @@
  * `bundle-assets.sh` maintains its own bash array — `bundle-consistency.test.ts`
  * validates that it stays in sync with these lists.
  */
-export declare const WORKFLOW_SKILLS: readonly ["oat-project-capture", "oat-project-clear-active", "oat-project-complete", "oat-project-design", "oat-project-discover", "oat-project-document", "oat-project-implement", "oat-project-import-plan", "oat-project-new", "oat-project-next", "oat-project-open", "oat-project-plan", "oat-project-plan-writing", "oat-project-pr-final", "oat-project-pr-progress", "oat-project-progress", "oat-project-promote-spec-driven", "oat-project-quick-start", "oat-project-reconcile", "oat-project-revise", "oat-project-review-provide", "oat-project-review-receive", "oat-project-review-receive-remote", "oat-project-spec", "oat-project-subagent-implement", "oat-project-summary", "oat-repo-knowledge-index", "oat-worktree-bootstrap", "oat-worktree-bootstrap-auto", "oat-wrap-up"];
-export declare const WORKFLOW_AGENTS: readonly ["oat-codebase-mapper.md", "oat-reviewer.md"];
+export declare const WORKFLOW_SKILLS: readonly ["oat-project-capture", "oat-project-clear-active", "oat-project-complete", "oat-project-design", "oat-project-discover", "oat-project-document", "oat-project-implement", "oat-project-import-plan", "oat-project-new", "oat-project-next", "oat-project-open", "oat-project-plan", "oat-project-plan-writing", "oat-project-pr-final", "oat-project-pr-progress", "oat-project-progress", "oat-project-promote-spec-driven", "oat-project-quick-start", "oat-project-reconcile", "oat-project-revise", "oat-project-review-provide", "oat-project-review-receive", "oat-project-review-receive-remote", "oat-project-spec", "oat-project-summary", "oat-repo-knowledge-index", "oat-worktree-bootstrap", "oat-worktree-bootstrap-auto", "oat-wrap-up"];
+export declare const WORKFLOW_AGENTS: readonly ["oat-codebase-mapper.md", "oat-phase-implementer.md", "oat-reviewer.md"];
 export declare const WORKFLOW_TEMPLATES: readonly ["state.md", "discovery.md", "spec.md", "design.md", "plan.md", "implementation.md", "summary.md"];
 export declare const WORKFLOW_SCRIPTS: readonly ["generate-oat-state.sh", "generate-thin-index.sh", "resolve-tracking.sh"];
 export declare const IDEA_SKILLS: readonly ["oat-idea-new", "oat-idea-ideate", "oat-idea-summarize", "oat-idea-scratchpad"];

package/dist/commands/init/tools/shared/skill-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-manifest.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/shared/skill-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,eAAO,MAAM,eAAe,qwBA+BlB,CAAC;AAEX,eAAO,MAAM,eAAe,wDAGlB,CAAC;AAEX,eAAO,MAAM,kBAAkB,6GAQrB,CAAC;AAEX,eAAO,MAAM,gBAAgB,qFAInB,CAAC;AAIX,eAAO,MAAM,WAAW,2FAKd,CAAC;AAIX,eAAO,MAAM,WAAW,qCAAsC,CAAC;AAI/D,eAAO,MAAM,WAAW,yIAMd,CAAC;AAEX,eAAO,MAAM,YAAY,kCAAmC,CAAC;AAI7D,eAAO,MAAM,cAAc,gJAMjB,CAAC;AAIX,eAAO,MAAM,yBAAyB,kGAI5B,CAAC;AAEX,eAAO,MAAM,4BAA4B,4CAG/B,CAAC;AAEX,eAAO,MAAM,0BAA0B,aAAc,CAAC;AAItD,eAAO,MAAM,eAAe,2EAMlB,CAAC;AAEX,eAAO,MAAM,eAAe,qCAAsC,CAAC"}
+{"version":3,"file":"skill-manifest.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/shared/skill-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,eAAO,MAAM,eAAe,muBA8BlB,CAAC;AAEX,eAAO,MAAM,eAAe,oFAIlB,CAAC;AAEX,eAAO,MAAM,kBAAkB,6GAQrB,CAAC;AAEX,eAAO,MAAM,gBAAgB,qFAInB,CAAC;AAIX,eAAO,MAAM,WAAW,2FAKd,CAAC;AAIX,eAAO,MAAM,WAAW,qCAAsC,CAAC;AAI/D,eAAO,MAAM,WAAW,yIAMd,CAAC;AAEX,eAAO,MAAM,YAAY,kCAAmC,CAAC;AAI7D,eAAO,MAAM,cAAc,gJAMjB,CAAC;AAIX,eAAO,MAAM,yBAAyB,kGAI5B,CAAC;AAEX,eAAO,MAAM,4BAA4B,4CAG/B,CAAC;AAEX,eAAO,MAAM,0BAA0B,aAAc,CAAC;AAItD,eAAO,MAAM,eAAe,2EAMlB,CAAC;AAEX,eAAO,MAAM,eAAe,qCAAsC,CAAC"}

package/dist/commands/init/tools/shared/skill-manifest.js

@@ -31,7 +31,6 @@ export const WORKFLOW_SKILLS = [
     'oat-project-review-receive',
     'oat-project-review-receive-remote',
     'oat-project-spec',
-    'oat-project-subagent-implement',
     'oat-project-summary',
     'oat-repo-knowledge-index',
     'oat-worktree-bootstrap',
@@ -40,6 +39,7 @@ export const WORKFLOW_SKILLS = [
 ];
 export const WORKFLOW_AGENTS = [
     'oat-codebase-mapper.md',
+    'oat-phase-implementer.md',
     'oat-reviewer.md',
 ];
 export const WORKFLOW_TEMPLATES = [

package/dist/commands/project/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,oBAAoB,IAAI,OAAO,CAW9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,wBAAgB,oBAAoB,IAAI,OAAO,CAY9C"}

package/dist/commands/project/index.js

@@ -7,6 +7,7 @@ import { createProjectOpenCommand } from './open/index.js';
 import { createProjectPauseCommand } from './pause/index.js';
 import { createProjectSetModeCommand } from './set-mode/index.js';
 import { createProjectStatusCommand } from './status.js';
+import { createProjectValidatePlanCommand } from './validate-plan/index.js';
 export function createProjectCommand() {
     return new Command('project')
         .description('Manage OAT project workflows')
@@ -17,5 +18,6 @@ export function createProjectCommand() {
         .addCommand(createProjectOpenCommand())
         .addCommand(createProjectPauseCommand())
         .addCommand(createProjectSetModeCommand())
-        .addCommand(createProjectStatusCommand());
+        .addCommand(createProjectStatusCommand())
+        .addCommand(createProjectValidatePlanCommand());
 }

package/dist/commands/project/set-mode/index.d.ts

@@ -1,13 +1,7 @@
-import { readFile as defaultReadFile, writeFile as defaultWriteFile } from 'node:fs/promises';
 import { buildCommandContext, type CommandContext } from '../../../app/command-context.js';
 import { Command } from 'commander';
-export type ExecutionMode = 'single-thread' | 'subagent-driven';
 interface SetModeDependencies {
     buildCommandContext: (options: Parameters<typeof buildCommandContext>[0]) => CommandContext;
-    resolveProjectRoot: (cwd: string) => Promise<string>;
-    readFile: typeof defaultReadFile;
-    writeFile: typeof defaultWriteFile;
-    now: () => Date;
 }
 export declare function createProjectSetModeCommand(overrides?: Partial<SetModeDependencies>): Command;
 export {};

package/dist/commands/project/set-mode/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/set-mode/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,IAAI,eAAe,EAC3B,SAAS,IAAI,gBAAgB,EAC9B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAYhF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAEhE,UAAU,mBAAmB;IAC3B,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,EAAE,OAAO,eAAe,CAAC;IACjC,SAAS,EAAE,OAAO,gBAAgB,CAAC;IACnC,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AAwID,wBAAgB,2BAA2B,CACzC,SAAS,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAC3C,OAAO,CAeT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/set-mode/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,UAAU,mBAAmB;IAC3B,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;CACrB;AA+BD,wBAAgB,2BAA2B,CACzC,SAAS,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAC3C,OAAO,CAeT"}