@open-agent-toolkit/cli 0.0.43 → 0.0.51

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/assets/agents/oat-phase-implementer.md +230 -0
  2. package/assets/agents/oat-reviewer.md +3 -3
  3. package/assets/docs/cli-utilities/configuration.md +15 -3
  4. package/assets/docs/reference/cli-reference.md +17 -14
  5. package/assets/docs/reference/oat-directory-structure.md +17 -17
  6. package/assets/docs/workflows/projects/artifacts.md +34 -0
  7. package/assets/docs/workflows/projects/implementation-execution.md +161 -0
  8. package/assets/docs/workflows/projects/lifecycle.md +22 -29
  9. package/assets/docs/workflows/projects/reviews.md +4 -2
  10. package/assets/docs/workflows/skills/index.md +0 -1
  11. package/assets/public-package-versions.json +4 -4
  12. package/assets/skills/oat-doctor/SKILL.md +3 -3
  13. package/assets/skills/oat-project-implement/SKILL.md +363 -126
  14. package/assets/skills/oat-project-import-plan/SKILL.md +2 -3
  15. package/assets/skills/oat-project-next/SKILL.md +11 -12
  16. package/assets/skills/oat-project-plan/SKILL.md +23 -5
  17. package/assets/skills/oat-project-plan-writing/SKILL.md +2 -2
  18. package/assets/skills/oat-project-progress/SKILL.md +29 -35
  19. package/assets/skills/oat-project-quick-start/SKILL.md +13 -3
  20. package/assets/skills/oat-worktree-bootstrap-auto/SKILL.md +2 -2
  21. package/assets/templates/implementation.md +8 -3
  22. package/assets/templates/plan.md +24 -3
  23. package/assets/templates/state.md +1 -1
  24. package/dist/commands/config/index.d.ts.map +1 -1
  25. package/dist/commands/config/index.js +17 -4
  26. package/dist/commands/init/tools/index.js +1 -1
  27. package/dist/commands/init/tools/shared/skill-manifest.d.ts +2 -2
  28. package/dist/commands/init/tools/shared/skill-manifest.d.ts.map +1 -1
  29. package/dist/commands/init/tools/shared/skill-manifest.js +1 -1
  30. package/dist/commands/project/index.d.ts.map +1 -1
  31. package/dist/commands/project/index.js +3 -1
  32. package/dist/commands/project/set-mode/index.d.ts +0 -6
  33. package/dist/commands/project/set-mode/index.d.ts.map +1 -1
  34. package/dist/commands/project/set-mode/index.js +16 -96
  35. package/dist/commands/project/validate-plan/index.d.ts +3 -0
  36. package/dist/commands/project/validate-plan/index.d.ts.map +1 -0
  37. package/dist/commands/project/validate-plan/index.js +44 -0
  38. package/dist/commands/project/validate-plan/validate-plan.d.ts +20 -0
  39. package/dist/commands/project/validate-plan/validate-plan.d.ts.map +1 -0
  40. package/dist/commands/project/validate-plan/validate-plan.js +77 -0
  41. package/dist/commands/tools/update/index.d.ts +4 -0
  42. package/dist/commands/tools/update/index.d.ts.map +1 -1
  43. package/dist/commands/tools/update/index.js +17 -1
  44. package/dist/commands/tools/update/update-tools.d.ts +1 -0
  45. package/dist/commands/tools/update/update-tools.d.ts.map +1 -1
  46. package/dist/commands/tools/update/update-tools.js +80 -1
  47. package/dist/config/oat-config.d.ts +1 -0
  48. package/dist/config/oat-config.d.ts.map +1 -1
  49. package/dist/config/oat-config.js +3 -0
  50. package/dist/config/resolve.d.ts.map +1 -1
  51. package/dist/config/resolve.js +9 -0
  52. package/package.json +2 -2
  53. package/assets/skills/oat-project-subagent-implement/SKILL.md +0 -549
  54. package/assets/skills/oat-project-subagent-implement/examples/pattern-hill-checkpoint.md +0 -110
  55. package/assets/skills/oat-project-subagent-implement/examples/pattern-parallel-phases.md +0 -118
  56. package/assets/skills/oat-project-subagent-implement/scripts/dispatch.sh +0 -133
  57. package/assets/skills/oat-project-subagent-implement/scripts/reconcile.sh +0 -182
  58. package/assets/skills/oat-project-subagent-implement/scripts/review-gate.sh +0 -187
  59. package/assets/skills/oat-project-subagent-implement/tests/fixtures/sample-plan.md +0 -234
  60. package/assets/skills/oat-project-subagent-implement/tests/test-dry-run.sh +0 -126
  61. package/assets/skills/oat-project-subagent-implement/tests/test-hill-checkpoint.sh +0 -127
  62. package/assets/skills/oat-project-subagent-implement/tests/test-reconcile.sh +0 -254
  63. package/assets/skills/oat-project-subagent-implement/tests/test-review-gate.sh +0 -220
@@ -13,7 +13,7 @@ OAT lifecycle order:
13
13
  2. Spec (`oat-project-spec`)
14
14
  3. Design (`oat-project-design`)
15
15
  4. Plan (`oat-project-plan`)
16
- 5. Implement (`oat-project-implement` or `oat-project-subagent-implement`)
16
+ 5. Implement (`oat-project-implement`)
17
17
  6. Review loop (`oat-project-review-provide` / `oat-project-review-receive`)
18
18
  7. Summary (`oat-project-summary`) — generates `summary.md` as institutional memory; `oat-project-pr-final` and `oat-project-complete` auto-refresh it when missing or stale
19
19
  8. PR (`oat-project-pr-progress` / `oat-project-pr-final`) — sets `pr_open` status
@@ -34,12 +34,8 @@ OAT lifecycle order:
34
34
  ```mermaid
35
35
  flowchart LR
36
36
  D["Discovery"] --> S["Spec"] --> G["Design"] --> P["Plan"]
37
- P --> M{"Implementation mode"}
38
- M --> I1["Sequential"]
39
- M --> I2["Subagent-driven"]
40
- I1 --> R["Review loop"]
41
- I2 --> R
42
- R --> PR["PR flow"]
37
+ P --> I["Implement (oat-project-implement)"]
38
+ I --> R["Review loop"] --> PR["PR flow"]
43
39
  PR --> DOC["Docs sync (optional)"]
44
40
  DOC --> C["Complete"]
45
41
  ```
@@ -83,16 +79,23 @@ Actual PR existence is tracked separately from `oat_phase_status`:
83
79
 
84
80
  This distinction matters during completion: `oat-project-complete` can skip the "Open a PR?" prompt when `oat_pr_status: open` is already present.
85
81
 
86
- ### Auto-review at checkpoints
82
+ ### Auto-review at HiLL checkpoints
87
83
 
88
- When `autoReviewAtCheckpoints` is enabled (via `.oat/config.json` or `plan.md` frontmatter `oat_auto_review_at_checkpoints`), completing a plan phase checkpoint automatically spawns a subagent code review scoped to every implementation phase not already covered by a passed whole-phase code review, through the just-completed checkpoint. Mid-implementation multi-phase reviews use inclusive phase-range scopes such as `p02-p03`; the final implementation checkpoint uses `code final`. The review uses auto-disposition mode (minors auto-converted to fix tasks, no user prompts). Disabled by default.
84
+ When `workflow.autoReviewAtHillCheckpoints` is enabled or `plan.md` frontmatter sets `oat_auto_review_at_hill_checkpoints`, completing a HiLL checkpoint automatically runs the extra lifecycle review scoped to every implementation phase not already covered by a passed whole-phase code review, through the just-completed checkpoint. Mid-implementation multi-phase reviews use inclusive phase-range scopes such as `p02-p03`; the final implementation checkpoint uses `code final`. The review uses auto-disposition mode (minors auto-converted to fix tasks, no user prompts). Disabled by default. Legacy `autoReviewAtCheckpoints` and `oat_auto_review_at_checkpoints` are still read as fallbacks. This does not control Tier 1 per-phase `oat-reviewer` gates.
89
85
 
90
86
  ## Implementation modes
91
87
 
92
- - **Sequential (default):** `oat-project-implement`
93
- - **Parallel/subagent-driven:** `oat-project-subagent-implement`
94
- - Use `oat project set-mode <single-thread|subagent-driven>` to persist mode in project state.
95
- - `oat-project-implement` remains the canonical consumer and redirects when mode is `subagent-driven`.
88
+ `oat-project-implement` v2.0 dispatches one subagent per phase (not per task). Capability detection at skill start selects a tier, locked for the run:
89
+
90
+ - **Tier 1 (subagents):** native subagent dispatch via Claude Code, Cursor, or Codex with spawn authorization.
91
+ - **Tier 2 (inline):** orchestrator reads the agent files and executes the process itself when subagents are unavailable or authorization is declined.
92
+
93
+ Within either tier, parallelism is expressed as plan metadata:
94
+
95
+ - **Sequential (default):** plans with no `oat_plan_parallel_groups` field, or with an empty array. Phases run in plan order on the orchestration branch.
96
+ - **Parallel groups:** phases listed together in `oat_plan_parallel_groups` run concurrently in worktrees (Tier 1 only) and merge back to the orchestration branch in plan order. Groups themselves execute sequentially.
97
+
98
+ See [Implementation Execution](implementation-execution.md) for the full execution model — tier detection, bounded fix loop, fan-in, merge-conflict handling, dry-run, and resumption.
96
99
 
97
100
  ## Review receive behavior
98
101
 
@@ -106,18 +109,14 @@ When `autoReviewAtCheckpoints` is enabled (via `.oat/config.json` or `plan.md` f
106
109
 
107
110
  1. `oat-project-quick-start` (adaptive discovery — provide a project name and optional description; if only the name is provided, quick-start asks for the missing description before discovery. Well-understood requests synthesize quickly, exploratory requests invest in solution space exploration)
108
111
  2. Decision point: straight to plan, optional lightweight `design.md`, or promote to spec-driven
109
- 3. Implement:
110
- - `oat-project-implement` (sequential)
111
- - `oat-project-subagent-implement` (parallel/subagent-driven)
112
+ 3. Implement: `oat-project-implement` (sequential by default; parallel when `oat_plan_parallel_groups` is declared)
112
113
  4. `oat-project-review-provide` / `oat-project-pr-final`
113
114
  5. Optional `oat-project-promote-spec-driven` to backfill spec-driven lifecycle artifacts in-place
114
115
 
115
116
  ### Import lane diagram
116
117
 
117
118
  1. `oat-project-import-plan`
118
- 2. Implement:
119
- - `oat-project-implement` (sequential)
120
- - `oat-project-subagent-implement` (parallel/subagent-driven)
119
+ 2. Implement: `oat-project-implement` (sequential by default; parallel when `oat_plan_parallel_groups` is declared)
121
120
  3. `oat-project-review-provide` / `oat-project-pr-final`
122
121
  4. Optional `oat-project-promote-spec-driven` to switch project mode to spec-driven lifecycle
123
122
 
@@ -128,10 +127,8 @@ When `autoReviewAtCheckpoints` is enabled (via `.oat/config.json` or `plan.md` f
128
127
  ```mermaid
129
128
  flowchart LR
130
129
  D["Discover"] --> S["Spec"] --> G["Design"] --> P["Plan"]
131
- P --> I1["Implement (oat-project-implement)"]
132
- P --> I2["Implement (oat-project-subagent-implement)"]
133
- I1 --> R["Review"] --> PR["PR"] --> Doc["Docs (optional)"] --> C["Complete"]
134
- I2 --> R
130
+ P --> I["Implement (oat-project-implement)"]
131
+ I --> R["Review"] --> PR["PR"] --> Doc["Docs (optional)"] --> C["Complete"]
135
132
  ```
136
133
 
137
134
  ### Quick lane
@@ -142,10 +139,8 @@ flowchart LR
142
139
  D -->|Straight to plan| P["Plan"]
143
140
  D -->|Lightweight design| LD["Design (quick)"] --> P
144
141
  D -->|Promote| SD["→ Spec-Driven lane"]
145
- P --> QI1["Implement (oat-project-implement)"]
146
- P --> QI2["Implement (oat-project-subagent-implement)"]
147
- QI1 --> QR["Review / PR"]
148
- QI2 --> QR
142
+ P --> QI["Implement (oat-project-implement)"]
143
+ QI --> QR["Review / PR"]
149
144
  ```
150
145
 
151
146
  ### Import lane
@@ -153,9 +148,7 @@ flowchart LR
153
148
  ```mermaid
154
149
  flowchart LR
155
150
  I["Import Plan"] --> II1["Implement (oat-project-implement)"]
156
- I --> II2["Implement (oat-project-subagent-implement)"]
157
151
  II1 --> IR["Review / PR"]
158
- II2 --> IR
159
152
  ```
160
153
 
161
154
  ### Capture lane
@@ -56,9 +56,11 @@ Status progression in `plan.md` Reviews table:
56
56
  - Minor (non-final scopes): do not auto-defer by default. Convert when likely future cleanup or when the fix is trivial; defer only with recorded rationale.
57
57
  - Minor (final scope): not auto-deferred; require explicit user disposition (defer vs convert), and recommend convert when likely future cleanup or trivial to fix.
58
58
 
59
- ## Auto-review at checkpoints
59
+ ## Auto-review at HiLL checkpoints
60
60
 
61
- When `autoReviewAtCheckpoints` is enabled (via `oat config set autoReviewAtCheckpoints true` or per-project in `plan.md` frontmatter), completing a plan phase checkpoint automatically spawns a subagent review. The review scope covers every implementation phase not already covered by a passed whole-phase code review, through the just-completed checkpoint. Mid-implementation multi-phase checkpoint reviews use inclusive phase-range scopes such as `p02-p03`. The final phase checkpoint triggers a `code final` review.
61
+ When `workflow.autoReviewAtHillCheckpoints` is enabled (for example, `oat config set workflow.autoReviewAtHillCheckpoints true --user`) or per-project `plan.md` frontmatter sets `oat_auto_review_at_hill_checkpoints`, completing a HiLL checkpoint automatically runs the extra lifecycle review. The review scope covers every implementation phase not already covered by a passed whole-phase code review, through the just-completed checkpoint. Mid-implementation multi-phase checkpoint reviews use inclusive phase-range scopes such as `p02-p03`. The final phase checkpoint triggers a `code final` review.
62
+
63
+ This is separate from Tier 1 phase gate reviews. Tier 1 implementation always runs `oat-reviewer` after each phase; `workflow.autoReviewAtHillCheckpoints` only controls the additional lifecycle review when a HiLL checkpoint is reached. Legacy `autoReviewAtCheckpoints` and `oat_auto_review_at_checkpoints` are still read as fallbacks.
62
64
 
63
65
  Auto-triggered reviews use `oat_review_invocation: auto` in the review artifact frontmatter. In auto mode, `oat-project-review-receive` auto-converts all findings to fix tasks without user prompts (Minor findings that are clearly out of scope are deferred with a note).
64
66
 
@@ -52,7 +52,6 @@ Use this section when you want to choose the right OAT skill for a task. If you
52
52
  - `oat-project-plan`
53
53
  - `oat-project-plan-writing`
54
54
  - `oat-project-implement`
55
- - `oat-project-subagent-implement`
56
55
  - `oat-project-progress`
57
56
  - `oat-project-next`
58
57
  - `oat-project-capture`
@@ -1,6 +1,6 @@
1
1
  {
2
- "cli": "0.0.43",
3
- "docs-config": "0.0.43",
4
- "docs-theme": "0.0.43",
5
- "docs-transforms": "0.0.43"
2
+ "cli": "0.0.51",
3
+ "docs-config": "0.0.51",
4
+ "docs-theme": "0.0.51",
5
+ "docs-transforms": "0.0.51"
6
6
  }
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-doctor
3
- version: 1.0.0
3
+ version: 1.0.2
4
4
  description: Use when you need to diagnose your OAT setup, check for outdated skills, identify misconfigurations, or get a summary of installed tools and config. Runs health checks and recommends corrective actions.
5
5
  argument-hint: '[--summary]'
6
6
  disable-model-invocation: true
@@ -160,7 +160,7 @@ Workflow pack skills:
160
160
  - oat-project-promote-spec-driven, oat-project-quick-start
161
161
  - oat-project-reconcile, oat-project-revise, oat-project-review-provide
162
162
  - oat-project-review-receive, oat-project-review-receive-remote
163
- - oat-project-spec, oat-project-subagent-implement, oat-project-summary
163
+ - oat-project-spec, oat-project-summary
164
164
  - oat-repo-knowledge-index, oat-worktree-bootstrap, oat-worktree-bootstrap-auto
165
165
 
166
166
  Ideas pack skills:
@@ -263,7 +263,7 @@ Read config key descriptions from `~/.oat/docs/reference/file-locations.md` and
263
263
  - **documentation.config:** Path to docs config file (e.g., mkdocs.yml).
264
264
  - **documentation.tooling:** Docs tooling in use (e.g., mkdocs, fumadocs).
265
265
  - **documentation.requireForProjectCompletion:** Whether docs update is required before project completion.
266
- - **autoReviewAtCheckpoints:** When true, completing a plan phase checkpoint auto-triggers a subagent code review. Default false. Can be overridden per-project via `oat_auto_review_at_checkpoints` in plan.md frontmatter.
266
+ - **workflow.autoReviewAtHillCheckpoints:** When true, completing a HiLL checkpoint auto-triggers the lifecycle review. Default unset. This does not control Tier 1 per-phase `oat-reviewer` gates. Can be overridden per-project via `oat_auto_review_at_hill_checkpoints` in plan.md frontmatter. Legacy `autoReviewAtCheckpoints` and `oat_auto_review_at_checkpoints` are still read as fallbacks.
267
267
  - **worktrees.root:** Base directory for git worktrees. Used by worktree-bootstrap skills.
268
268
 
269
269
  ## Sync Status