@open-agent-toolkit/cli 0.2.59 → 0.2.62

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 (78) hide show
  1. package/assets/agents/oat-phase-implementer.md +27 -4
  2. package/assets/agents/oat-reviewer.md +25 -14
  3. package/assets/bundle-metadata.json +1 -1
  4. package/assets/docs/cli-utilities/workflow-gates.md +3 -3
  5. package/assets/docs/reference/cli-reference.md +10 -3
  6. package/assets/docs/reference/oat-directory-structure.md +1 -0
  7. package/assets/docs/workflows/ideas/index.md +1 -1
  8. package/assets/docs/workflows/index.md +1 -0
  9. package/assets/docs/workflows/projects/artifacts.md +24 -3
  10. package/assets/docs/workflows/projects/hill-checkpoints.md +21 -0
  11. package/assets/docs/workflows/projects/implementation-execution.md +5 -0
  12. package/assets/docs/workflows/projects/lifecycle.md +124 -7
  13. package/assets/docs/workflows/projects/pr-flow.md +2 -0
  14. package/assets/docs/workflows/projects/reviews.md +1 -1
  15. package/assets/docs/workflows/projects/state-machine.md +20 -0
  16. package/assets/docs/workflows/skills/index.md +2 -1
  17. package/assets/public-package-versions.json +4 -4
  18. package/assets/skills/oat-brainstorm/SKILL.md +61 -12
  19. package/assets/skills/oat-docs/SKILL.md +13 -8
  20. package/assets/skills/oat-doctor/SKILL.md +3 -3
  21. package/assets/skills/oat-pjm-review-backlog/SKILL.md +2 -2
  22. package/assets/skills/oat-project-autonomous/SKILL.md +14 -9
  23. package/assets/skills/oat-project-autonomous/references/gate-inventory.md +56 -42
  24. package/assets/skills/oat-project-capture/SKILL.md +2 -2
  25. package/assets/skills/oat-project-discover/SKILL.md +6 -5
  26. package/assets/skills/oat-project-document/SKILL.md +11 -1
  27. package/assets/skills/oat-project-document/references/docs/autonomy-contract.md +56 -42
  28. package/assets/skills/oat-project-implement/SKILL.md +3 -3
  29. package/assets/skills/oat-project-implement/references/completion-and-closeout.md +106 -15
  30. package/assets/skills/oat-project-implement/references/docs/autonomy-contract.md +56 -42
  31. package/assets/skills/oat-project-implement/references/phase-execution.md +16 -1
  32. package/assets/skills/oat-project-implement/references/plan-and-resume.md +19 -1
  33. package/assets/skills/oat-project-import-plan/SKILL.md +47 -3
  34. package/assets/skills/oat-project-lite/SKILL.md +467 -0
  35. package/assets/skills/oat-project-lite/references/docs/autonomy-contract.md +331 -0
  36. package/assets/skills/oat-project-next/SKILL.md +26 -10
  37. package/assets/skills/oat-project-plan/SKILL.md +14 -2
  38. package/assets/skills/oat-project-plan-writing/SKILL.md +6 -3
  39. package/assets/skills/oat-project-pr-final/SKILL.md +33 -7
  40. package/assets/skills/oat-project-pr-final/references/docs/autonomy-contract.md +56 -42
  41. package/assets/skills/oat-project-pr-progress/SKILL.md +3 -3
  42. package/assets/skills/oat-project-progress/SKILL.md +16 -3
  43. package/assets/skills/oat-project-promote-spec-driven/SKILL.md +3 -1
  44. package/assets/skills/oat-project-quick-start/references/docs/autonomy-contract.md +56 -42
  45. package/assets/skills/oat-project-review-provide/SKILL.md +25 -6
  46. package/assets/skills/oat-project-summary/SKILL.md +27 -3
  47. package/assets/templates/plan-lite.md +165 -0
  48. package/assets/templates/plan.md +1 -1
  49. package/assets/templates/state.md +1 -1
  50. package/dist/commands/project/index.d.ts.map +1 -1
  51. package/dist/commands/project/index.js +2 -0
  52. package/dist/commands/project/new/index.d.ts +3 -2
  53. package/dist/commands/project/new/index.d.ts.map +1 -1
  54. package/dist/commands/project/new/index.js +2 -1
  55. package/dist/commands/project/new/scaffold.d.ts +5 -3
  56. package/dist/commands/project/new/scaffold.d.ts.map +1 -1
  57. package/dist/commands/project/new/scaffold.js +38 -10
  58. package/dist/commands/project/promote/index.d.ts +2 -0
  59. package/dist/commands/project/promote/index.d.ts.map +1 -0
  60. package/dist/commands/project/promote/index.js +1 -0
  61. package/dist/commands/project/promote/promote.d.ts +47 -0
  62. package/dist/commands/project/promote/promote.d.ts.map +1 -0
  63. package/dist/commands/project/promote/promote.js +322 -0
  64. package/dist/commands/project/split/run.d.ts.map +1 -1
  65. package/dist/commands/project/split/run.js +8 -1
  66. package/dist/commands/project/validate-plan/index.d.ts.map +1 -1
  67. package/dist/commands/project/validate-plan/index.js +25 -1
  68. package/dist/commands/project/validate-plan/validate-plan.d.ts +8 -0
  69. package/dist/commands/project/validate-plan/validate-plan.d.ts.map +1 -1
  70. package/dist/commands/project/validate-plan/validate-plan.js +49 -0
  71. package/dist/commands/shared/frontmatter.d.ts +1 -1
  72. package/dist/commands/shared/frontmatter.d.ts.map +1 -1
  73. package/dist/commands/shared/frontmatter.js +1 -0
  74. package/dist/commands/state/generate.d.ts.map +1 -1
  75. package/dist/commands/state/generate.js +23 -0
  76. package/dist/commands/tools/shared/pack-manifest.d.ts.map +1 -1
  77. package/dist/commands/tools/shared/pack-manifest.js +2 -0
  78. package/package.json +2 -2
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-next
3
- version: 1.0.14
3
+ version: 1.1.0
4
4
  description: Use when continuing work on the active OAT project. Reads project state, determines the next lifecycle action, and invokes the appropriate skill automatically.
5
5
  disable-model-invocation: true
6
6
  user-invocable: true
@@ -106,6 +106,7 @@ projects, and synced records whose detached checkout is absent.
106
106
  - **The `projects` array is empty:** Report error and suggest:
107
107
  - `oat-project-new` — Create a spec-driven project
108
108
  - `oat-project-quick-start` — Start a quick workflow project
109
+ - `oat-project-lite` — Start a lite workflow project
109
110
  - `oat-project-import-plan` — Import an external plan
110
111
  - **STOP.** Do not attempt routing.
111
112
 
@@ -124,15 +125,15 @@ projects, and synced records whose detached checkout is absent.
124
125
 
125
126
  Read `"$PROJECT_PATH/state.md"` frontmatter and extract:
126
127
 
127
- | Field | Used For |
128
- | ------------------------- | ---------------------------------------------------------------------------- |
129
- | `oat_phase` | Current lifecycle position (discovery, spec, design, plan, implement) |
130
- | `oat_phase_status` | Phase completion state (in_progress, complete, pr_open) |
131
- | `oat_workflow_mode` | Routing table selection (spec-driven, quick, import). Default: `spec-driven` |
132
- | `oat_hill_checkpoints` | Which phases require HiLL approval |
133
- | `oat_hill_completed` | Which HiLL gates have been passed |
134
- | `oat_blockers` | Informational warnings (not routing gates) |
135
- | `oat_implement_exit_gate` | Whether the implementation exit gate is allowed and fresh |
128
+ | Field | Used For |
129
+ | ------------------------- | ---------------------------------------------------------------------------------- |
130
+ | `oat_phase` | Current lifecycle position (discovery, spec, design, plan, implement) |
131
+ | `oat_phase_status` | Phase completion state (in_progress, complete, pr_open) |
132
+ | `oat_workflow_mode` | Routing table selection (spec-driven, quick, import, lite). Default: `spec-driven` |
133
+ | `oat_hill_checkpoints` | Which phases require HiLL approval |
134
+ | `oat_hill_completed` | Which HiLL gates have been passed |
135
+ | `oat_blockers` | Informational warnings (not routing gates) |
136
+ | `oat_implement_exit_gate` | Whether the implementation exit gate is allowed and fresh |
136
137
 
137
138
  **If state.md is missing or unreadable:** Report error and suggest running the relevant phase skill directly. STOP.
138
139
 
@@ -256,6 +257,15 @@ Otherwise, look up the target skill from the routing table for the current `oat_
256
257
  | plan | complete | tier 1 | `oat-project-implement` \* |
257
258
  | implement | in_progress | — | `oat-project-implement` \* |
258
259
 
260
+ **Lite Mode:**
261
+
262
+ | Current Phase | Phase Status | Boundary Tier | Target Skill |
263
+ | ------------- | ------------ | ------------- | -------------------------- |
264
+ | plan | in_progress | tier 3 | `oat-project-lite` |
265
+ | plan | in_progress | tier 2 | `oat-project-implement` \* |
266
+ | plan | complete | tier 1 | `oat-project-implement` \* |
267
+ | implement | in_progress | — | `oat-project-implement` \* |
268
+
259
269
  \* `oat-project-implement` handles both sequential and parallel execution.
260
270
 
261
271
  ### Step 4: Check for Unprocessed Reviews (Review Safety Check)
@@ -424,6 +434,12 @@ Ignore matching rows outside `REVIEWS_SECTION`; they are not review events.
424
434
  - If `FINAL_ROW` has `Status="passed"`:
425
435
  → Continue to 5.5
426
436
 
437
+ **Lite closeout route:** If `oat_workflow_mode: lite`, a passed final review
438
+ routes directly to `oat-project-pr-final` before the summary check below.
439
+ Announce: "Final review passed — creating final PR". Optional lite summary or
440
+ documentation work is owned by the immutable implementation closeout snapshot,
441
+ not this fallback router.
442
+
427
443
  **5.5: Summary not done**
428
444
 
429
445
  Read `{PROJECT_PATH}/summary.md`:
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-plan
3
- version: 1.4.8
3
+ version: 1.4.9
4
4
  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.
5
5
  oat_gateable: true
6
6
  disable-model-invocation: true
@@ -14,13 +14,16 @@ Transform detailed design into an executable implementation plan with bite-sized
14
14
 
15
15
  ## Prerequisites
16
16
 
17
- This skill is the plan authoring path for **spec-driven** projects only. Quick and import modes have dedicated entry skills that produce `plan.md` directly.
17
+ This skill is the plan authoring path for **spec-driven** projects only. Quick,
18
+ import, and lite modes have dedicated entry skills that produce `plan.md`
19
+ directly.
18
20
 
19
21
  Read `oat_workflow_mode` from `{PROJECT_PATH}/state.md` (default: `spec-driven`):
20
22
 
21
23
  - **`spec-driven`**: Complete design document required (`design.md` with `oat_status: complete`). If missing, **Stop.** Tell the user: "Run the `oat-project-design` skill first, then return to planning." Otherwise proceed with planning.
22
24
  - **`quick`**: **Stop.** Plan is already produced by the quick workflow. Tell the user: "Plan already produced by quick workflow. Run `oat-project-implement` to begin execution."
23
25
  - **`import`**: **Stop.** If a normalized `plan.md` exists, tell the user: "Imported plan is ready. Run `oat-project-implement` to begin execution." If no `plan.md` exists, tell the user: "Run `oat-project-import-plan` to import and normalize the external plan first."
26
+ - **`lite`**: **Stop.** Tell the user: "Lite planning is owned by `oat-project-lite`; run it to author or resume the combined plan contract."
24
27
 
25
28
  ## Plan Format Contract
26
29
 
@@ -119,6 +122,15 @@ WORKFLOW_MODE=$(oat project status --field project.workflowMode 2>/dev/null || e
119
122
 
120
123
  Exit skill.
121
124
 
125
+ **Mode: `lite`** — **STOP.** Print:
126
+
127
+ ```
128
+ ⚠️ This project uses lite mode. Run `oat-project-lite` to author or resume
129
+ its combined requirements and single-phase plan.
130
+ ```
131
+
132
+ Exit skill.
133
+
122
134
  **Mode: `import`** — **STOP.** Check if `"$PROJECT_PATH/plan.md"` exists:
123
135
 
124
136
  - If yes: Print: "Imported plan is ready. Run `oat-project-implement` to begin execution."
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-plan-writing
3
- version: 1.2.22
3
+ version: 1.2.23
4
4
  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.
5
5
  disable-model-invocation: true
6
6
  user-invocable: false
@@ -86,7 +86,8 @@ then continue without formatting.
86
86
  ## Managed Dispatch Readiness and Review Contract
87
87
 
88
88
  All plan-producing workflows and their artifact reviews use this contract:
89
- spec-driven planning, quick-start, imported plans, and provider-plan-via-import.
89
+ spec-driven planning, quick-start, lite planning, imported plans, and
90
+ provider-plan-via-import.
90
91
  The contract runs before a plan becomes implementation-ready and immediately
91
92
  before each artifact review dispatch.
92
93
 
@@ -549,7 +550,7 @@ Every `plan.md` produced or edited by any OAT skill **must** satisfy these invar
549
550
 
550
551
  ```yaml
551
552
  ---
552
- oat_plan_source: spec-driven | quick | imported # origin workflow mode
553
+ oat_plan_source: spec-driven | quick | imported | lite # origin workflow mode
553
554
  oat_status: in_progress | complete # plan lifecycle status
554
555
  oat_ready_for: null | oat-project-implement # downstream consumer
555
556
  # Optional after implementation confirmation:
@@ -653,10 +654,12 @@ Required inputs vary by workflow mode. The calling skill reads `oat_workflow_mod
653
654
  | `spec-driven` | Complete `design.md` (`oat_status: complete`) | Yes |
654
655
  | `quick` | `discovery.md` + repo knowledge context | No |
655
656
  | `import` | Preserved external source + normalized `plan.md` | No |
657
+ | `lite` | `plan.md` only | No |
656
658
 
657
659
  - **`spec-driven`**: Plan is derived from a complete design document. All design components must be covered by tasks.
658
660
  - **`quick`**: Plan is generated directly from discovery decisions and repo knowledge. No design artifact is required.
659
661
  - **`import`**: External plan is preserved in `references/imported-plan.md` and normalized into canonical format. Subsequent edits follow this contract.
662
+ - **`lite`**: `plan.md` is the sole requirements and implementation contract. It carries Summary, Decisions, Assumptions, Out of Scope, and Validation Criteria before one sequential phase; no discovery, spec, or design artifact is required.
660
663
 
661
664
  ## Resume and Edit Guardrails
662
665
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-pr-final
3
- version: 1.6.1
3
+ version: 1.6.2
4
4
  description: Use when the user requests or confirms opening the final PR for an active OAT project — e.g. "open the final PR", "ship it", "run oat-project-pr-final", or confirms a previously offered final-PR step. Do NOT auto-invoke when phases are marked complete. Generates the final lifecycle PR description from artifacts and creates the PR.
5
5
  disable-model-invocation: false
6
6
  user-invocable: true
@@ -26,7 +26,8 @@ Generate a PR-ready summary grounded in canonical OAT artifacts, including:
26
26
  - `activeProject` in `.oat/config.local.json` points at an active project directory (or you can provide project name when prompted)
27
27
  - `{PROJECT_PATH}/plan.md` exists
28
28
  - In `spec-driven` mode: `{PROJECT_PATH}/spec.md` and `{PROJECT_PATH}/design.md` are required
29
- - In `quick`/`import` mode: `spec.md`/`design.md` are optional
29
+ - In `quick`/`import`/`lite` mode: `spec.md`/`design.md` are optional; lite
30
+ proceeds with a reduced assurance note because plan.md is its full contract
30
31
 
31
32
  **Required (recommended to proceed):**
32
33
 
@@ -162,7 +163,7 @@ If `WORKFLOW_MODE=spec-driven`, also require:
162
163
  ls "$PROJECT_PATH/spec.md" "$PROJECT_PATH/design.md" 2>/dev/null
163
164
  ```
164
165
 
165
- If `WORKFLOW_MODE` is `quick` or `import`, proceed without spec/design and include a reduced-assurance note in the PR body.
166
+ If `WORKFLOW_MODE` is `quick`, `import`, or `lite`, proceed without spec/design and include a reduced assurance note in the PR body. For lite, explicitly note that plan.md is the reduced artifact contract and the absence of discovery/spec/design is intentional.
166
167
 
167
168
  ### Step 2: Check Final Review Status
168
169
 
@@ -214,7 +215,32 @@ sequence step.
214
215
 
215
216
  **Step 3.0: Check for summary.md**
216
217
 
217
- Check if `{PROJECT_PATH}/summary.md` exists:
218
+ Resolve the structurally exclusive route first:
219
+
220
+ ```bash
221
+ # BEGIN LITE PR SUMMARY ROUTE CONTRACT
222
+ if [ "$WORKFLOW_MODE" = "lite" ]; then
223
+ PR_SUMMARY_STRATEGY="lite-artifacts"
224
+ GENERIC_SUMMARY_REACHABLE="false"
225
+ else
226
+ PR_SUMMARY_STRATEGY="summary-md"
227
+ GENERIC_SUMMARY_REACHABLE="true"
228
+ fi
229
+ # END LITE PR SUMMARY ROUTE CONTRACT
230
+ ```
231
+
232
+ For `oat_workflow_mode: lite`, do not generate, refresh, or require
233
+ `summary.md`. Synthesize the PR summary directly from the `plan.md` `Summary`,
234
+ `Decisions`, and `Validation Criteria` sections plus the
235
+ `implementation.md` `Final Summary (for PR/docs)` shipped results. This is the
236
+ explicit reduced assurance path: absent `discovery.md`, `spec.md`, and
237
+ `design.md` are valid and must not block PR creation. Then continue to Step 3.1
238
+ only for the remaining available artifacts; do not invoke
239
+ `oat-project-summary` for lite. This branch ends Step 3.0 and jumps directly to
240
+ Step 3.1.
241
+
242
+ **Non-lite branch only:** If the route contract sets
243
+ `GENERIC_SUMMARY_REACHABLE=true`, check if `{PROJECT_PATH}/summary.md` exists:
218
244
 
219
245
  - If `summary.md` is missing or stale, refresh it automatically before proceeding.
220
246
  - When skill-to-skill invocation is available in the current host/runtime, load the current `oat-project-summary/SKILL.md` and follow it; never synthesize the summary from a remembered version of that skill.
@@ -229,8 +255,8 @@ Check if `{PROJECT_PATH}/summary.md` exists:
229
255
 
230
256
  Read:
231
257
 
232
- - `{PROJECT_PATH}/spec.md` (goals, priorities, verification; optional in quick/import)
233
- - `{PROJECT_PATH}/design.md` (architecture + testing strategy; optional in quick/import)
258
+ - `{PROJECT_PATH}/spec.md` (goals, priorities, verification; optional in quick/import/lite)
259
+ - `{PROJECT_PATH}/design.md` (architecture + testing strategy; optional in quick/import/lite)
234
260
  - `{PROJECT_PATH}/plan.md` (phases/tasks + reviews table)
235
261
  - `{PROJECT_PATH}/implementation.md` (if exists; preferred for “what actually happened”)
236
262
  - `{PROJECT_PATH}/discovery.md` (recommended for quick mode)
@@ -339,7 +365,7 @@ oat_project: { PROJECT_PATH }
339
365
 
340
366
  ## Goals / Non-Goals
341
367
 
342
- {brief bullets from available requirement artifacts: spec in spec-driven mode; discovery/import source in quick/import}
368
+ {brief bullets from available requirement artifacts: spec in spec-driven mode; discovery/import source in quick/import; plan contract in lite}
343
369
 
344
370
  ## Changes
345
371