@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.
- package/assets/agents/oat-phase-implementer.md +230 -0
- package/assets/agents/oat-reviewer.md +3 -3
- package/assets/docs/cli-utilities/configuration.md +15 -3
- package/assets/docs/reference/cli-reference.md +17 -14
- package/assets/docs/reference/oat-directory-structure.md +17 -17
- package/assets/docs/workflows/projects/artifacts.md +34 -0
- package/assets/docs/workflows/projects/implementation-execution.md +161 -0
- package/assets/docs/workflows/projects/lifecycle.md +22 -29
- package/assets/docs/workflows/projects/reviews.md +4 -2
- package/assets/docs/workflows/skills/index.md +0 -1
- package/assets/public-package-versions.json +4 -4
- package/assets/skills/oat-doctor/SKILL.md +3 -3
- package/assets/skills/oat-project-implement/SKILL.md +363 -126
- package/assets/skills/oat-project-import-plan/SKILL.md +2 -3
- package/assets/skills/oat-project-next/SKILL.md +11 -12
- package/assets/skills/oat-project-plan/SKILL.md +23 -5
- package/assets/skills/oat-project-plan-writing/SKILL.md +2 -2
- package/assets/skills/oat-project-progress/SKILL.md +29 -35
- package/assets/skills/oat-project-quick-start/SKILL.md +13 -3
- package/assets/skills/oat-worktree-bootstrap-auto/SKILL.md +2 -2
- package/assets/templates/implementation.md +8 -3
- package/assets/templates/plan.md +24 -3
- package/assets/templates/state.md +1 -1
- package/dist/commands/config/index.d.ts.map +1 -1
- package/dist/commands/config/index.js +17 -4
- package/dist/commands/init/tools/index.js +1 -1
- package/dist/commands/init/tools/shared/skill-manifest.d.ts +2 -2
- package/dist/commands/init/tools/shared/skill-manifest.d.ts.map +1 -1
- package/dist/commands/init/tools/shared/skill-manifest.js +1 -1
- package/dist/commands/project/index.d.ts.map +1 -1
- package/dist/commands/project/index.js +3 -1
- package/dist/commands/project/set-mode/index.d.ts +0 -6
- package/dist/commands/project/set-mode/index.d.ts.map +1 -1
- package/dist/commands/project/set-mode/index.js +16 -96
- package/dist/commands/project/validate-plan/index.d.ts +3 -0
- package/dist/commands/project/validate-plan/index.d.ts.map +1 -0
- package/dist/commands/project/validate-plan/index.js +44 -0
- package/dist/commands/project/validate-plan/validate-plan.d.ts +20 -0
- package/dist/commands/project/validate-plan/validate-plan.d.ts.map +1 -0
- package/dist/commands/project/validate-plan/validate-plan.js +77 -0
- package/dist/commands/tools/update/index.d.ts +4 -0
- package/dist/commands/tools/update/index.d.ts.map +1 -1
- package/dist/commands/tools/update/index.js +17 -1
- package/dist/commands/tools/update/update-tools.d.ts +1 -0
- package/dist/commands/tools/update/update-tools.d.ts.map +1 -1
- package/dist/commands/tools/update/update-tools.js +80 -1
- package/dist/config/oat-config.d.ts +1 -0
- package/dist/config/oat-config.d.ts.map +1 -1
- package/dist/config/oat-config.js +3 -0
- package/dist/config/resolve.d.ts.map +1 -1
- package/dist/config/resolve.js +9 -0
- package/package.json +2 -2
- package/assets/skills/oat-project-subagent-implement/SKILL.md +0 -549
- package/assets/skills/oat-project-subagent-implement/examples/pattern-hill-checkpoint.md +0 -110
- package/assets/skills/oat-project-subagent-implement/examples/pattern-parallel-phases.md +0 -118
- package/assets/skills/oat-project-subagent-implement/scripts/dispatch.sh +0 -133
- package/assets/skills/oat-project-subagent-implement/scripts/reconcile.sh +0 -182
- package/assets/skills/oat-project-subagent-implement/scripts/review-gate.sh +0 -187
- package/assets/skills/oat-project-subagent-implement/tests/fixtures/sample-plan.md +0 -234
- package/assets/skills/oat-project-subagent-implement/tests/test-dry-run.sh +0 -126
- package/assets/skills/oat-project-subagent-implement/tests/test-hill-checkpoint.sh +0 -127
- package/assets/skills/oat-project-subagent-implement/tests/test-reconcile.sh +0 -254
- 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`
|
|
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 -->
|
|
38
|
-
|
|
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 `
|
|
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
|
-
|
|
93
|
-
|
|
94
|
-
-
|
|
95
|
-
-
|
|
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 -->
|
|
132
|
-
|
|
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 -->
|
|
146
|
-
|
|
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 `
|
|
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
2
|
name: oat-doctor
|
|
3
|
-
version: 1.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-
|
|
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
|
-
- **
|
|
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
|