@open-agent-toolkit/cli 0.2.58 → 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 (114) 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/configuration.md +16 -0
  5. package/assets/docs/cli-utilities/workflow-gates.md +91 -6
  6. package/assets/docs/contributing/skills.md +27 -5
  7. package/assets/docs/provider-sync/commands.md +23 -0
  8. package/assets/docs/reference/cli-reference.md +10 -3
  9. package/assets/docs/reference/oat-directory-structure.md +1 -0
  10. package/assets/docs/workflows/ideas/index.md +1 -1
  11. package/assets/docs/workflows/index.md +1 -0
  12. package/assets/docs/workflows/projects/artifacts.md +24 -3
  13. package/assets/docs/workflows/projects/autonomy.md +5 -2
  14. package/assets/docs/workflows/projects/dispatch-ceiling.md +43 -7
  15. package/assets/docs/workflows/projects/hill-checkpoints.md +21 -0
  16. package/assets/docs/workflows/projects/implementation-execution.md +10 -2
  17. package/assets/docs/workflows/projects/lifecycle.md +128 -10
  18. package/assets/docs/workflows/projects/pr-flow.md +2 -0
  19. package/assets/docs/workflows/projects/reviews.md +1 -1
  20. package/assets/docs/workflows/projects/state-machine.md +20 -0
  21. package/assets/docs/workflows/skills/index.md +2 -1
  22. package/assets/public-package-versions.json +4 -4
  23. package/assets/skills/oat-brainstorm/SKILL.md +61 -12
  24. package/assets/skills/oat-docs/SKILL.md +13 -8
  25. package/assets/skills/oat-doctor/SKILL.md +3 -3
  26. package/assets/skills/oat-pjm-review-backlog/SKILL.md +2 -2
  27. package/assets/skills/oat-project-autonomous/SKILL.md +14 -9
  28. package/assets/skills/oat-project-autonomous/references/gate-inventory.md +59 -38
  29. package/assets/skills/oat-project-capture/SKILL.md +2 -2
  30. package/assets/skills/oat-project-design/SKILL.md +10 -5
  31. package/assets/skills/oat-project-discover/SKILL.md +15 -9
  32. package/assets/skills/oat-project-document/SKILL.md +11 -1
  33. package/assets/skills/oat-project-document/references/docs/autonomy-contract.md +59 -38
  34. package/assets/skills/oat-project-implement/SKILL.md +3 -3
  35. package/assets/skills/oat-project-implement/references/completion-and-closeout.md +149 -24
  36. package/assets/skills/oat-project-implement/references/dispatch-and-dry-run.md +14 -8
  37. package/assets/skills/oat-project-implement/references/docs/autonomy-contract.md +59 -38
  38. package/assets/skills/oat-project-implement/references/phase-execution.md +16 -1
  39. package/assets/skills/oat-project-implement/references/plan-and-resume.md +19 -1
  40. package/assets/skills/oat-project-import-plan/SKILL.md +75 -6
  41. package/assets/skills/oat-project-lite/SKILL.md +467 -0
  42. package/assets/skills/oat-project-lite/references/docs/autonomy-contract.md +331 -0
  43. package/assets/skills/oat-project-next/SKILL.md +54 -11
  44. package/assets/skills/oat-project-plan/SKILL.md +42 -5
  45. package/assets/skills/oat-project-plan-writing/SKILL.md +100 -3
  46. package/assets/skills/oat-project-pr-final/SKILL.md +33 -7
  47. package/assets/skills/oat-project-pr-final/references/docs/autonomy-contract.md +59 -38
  48. package/assets/skills/oat-project-pr-progress/SKILL.md +3 -3
  49. package/assets/skills/oat-project-progress/SKILL.md +27 -3
  50. package/assets/skills/oat-project-promote-spec-driven/SKILL.md +3 -1
  51. package/assets/skills/oat-project-quick-start/SKILL.md +29 -4
  52. package/assets/skills/oat-project-quick-start/references/docs/autonomy-contract.md +59 -38
  53. package/assets/skills/oat-project-review-provide/SKILL.md +37 -11
  54. package/assets/skills/oat-project-review-provide-remote/SKILL.md +12 -5
  55. package/assets/skills/oat-project-summary/SKILL.md +27 -3
  56. package/assets/templates/plan-lite.md +165 -0
  57. package/assets/templates/plan.md +1 -1
  58. package/assets/templates/state.md +5 -2
  59. package/dist/commands/gate/index.d.ts.map +1 -1
  60. package/dist/commands/gate/index.js +102 -8
  61. package/dist/commands/init/index.d.ts.map +1 -1
  62. package/dist/commands/init/index.js +16 -1
  63. package/dist/commands/project/dispatch-ceiling/index.d.ts.map +1 -1
  64. package/dist/commands/project/dispatch-ceiling/index.js +10 -1
  65. package/dist/commands/project/index.d.ts.map +1 -1
  66. package/dist/commands/project/index.js +2 -0
  67. package/dist/commands/project/new/index.d.ts +3 -2
  68. package/dist/commands/project/new/index.d.ts.map +1 -1
  69. package/dist/commands/project/new/index.js +2 -1
  70. package/dist/commands/project/new/scaffold.d.ts +5 -3
  71. package/dist/commands/project/new/scaffold.d.ts.map +1 -1
  72. package/dist/commands/project/new/scaffold.js +38 -10
  73. package/dist/commands/project/promote/index.d.ts +2 -0
  74. package/dist/commands/project/promote/index.d.ts.map +1 -0
  75. package/dist/commands/project/promote/index.js +1 -0
  76. package/dist/commands/project/promote/promote.d.ts +47 -0
  77. package/dist/commands/project/promote/promote.d.ts.map +1 -0
  78. package/dist/commands/project/promote/promote.js +322 -0
  79. package/dist/commands/project/split/run.d.ts.map +1 -1
  80. package/dist/commands/project/split/run.js +8 -1
  81. package/dist/commands/project/validate-plan/index.d.ts.map +1 -1
  82. package/dist/commands/project/validate-plan/index.js +25 -1
  83. package/dist/commands/project/validate-plan/validate-plan.d.ts +8 -0
  84. package/dist/commands/project/validate-plan/validate-plan.d.ts.map +1 -1
  85. package/dist/commands/project/validate-plan/validate-plan.js +49 -0
  86. package/dist/commands/remove/skill/remove-skill.d.ts.map +1 -1
  87. package/dist/commands/remove/skill/remove-skill.js +10 -1
  88. package/dist/commands/shared/frontmatter.d.ts +32 -1
  89. package/dist/commands/shared/frontmatter.d.ts.map +1 -1
  90. package/dist/commands/shared/frontmatter.js +93 -0
  91. package/dist/commands/state/generate.d.ts.map +1 -1
  92. package/dist/commands/state/generate.js +23 -0
  93. package/dist/commands/status/index.d.ts.map +1 -1
  94. package/dist/commands/status/index.js +8 -1
  95. package/dist/commands/sync/apply.d.ts.map +1 -1
  96. package/dist/commands/sync/apply.js +40 -6
  97. package/dist/commands/sync/index.d.ts.map +1 -1
  98. package/dist/commands/sync/index.js +11 -17
  99. package/dist/commands/sync/sync.types.d.ts +6 -6
  100. package/dist/commands/sync/sync.types.d.ts.map +1 -1
  101. package/dist/commands/tools/shared/pack-manifest.d.ts.map +1 -1
  102. package/dist/commands/tools/shared/pack-manifest.js +2 -0
  103. package/dist/config/resolve.d.ts +16 -0
  104. package/dist/config/resolve.d.ts.map +1 -1
  105. package/dist/config/resolve.js +16 -8
  106. package/dist/engine/execute-plan.d.ts.map +1 -1
  107. package/dist/engine/execute-plan.js +6 -0
  108. package/dist/manifest/index.d.ts +2 -1
  109. package/dist/manifest/index.d.ts.map +1 -1
  110. package/dist/manifest/index.js +1 -1
  111. package/dist/manifest/manager.d.ts +40 -0
  112. package/dist/manifest/manager.d.ts.map +1 -1
  113. package/dist/manifest/manager.js +35 -0
  114. package/package.json +2 -2
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-pr-progress
3
- version: 1.3.0
3
+ version: 1.3.1
4
4
  description: Use when an active OAT project needs a mid-project PR for a completed phase (pNN). Generates a phase-scoped progress PR description from OAT artifacts and commit history, with optional PR creation.
5
5
  disable-model-invocation: true
6
6
  user-invocable: true
@@ -15,7 +15,7 @@ Create a progress PR description (typically at a plan phase boundary) and write
15
15
 
16
16
  Generate a PR-ready summary that is:
17
17
 
18
- - grounded in OAT artifacts (mode-aware: spec-driven uses spec/design; quick/import may use discovery/import reference)
18
+ - grounded in OAT artifacts (mode-aware: spec-driven uses spec/design; quick/import may use discovery/import reference; lite uses the five plan.md contract sections)
19
19
  - scoped to a specific phase (pNN) or an explicit git range
20
20
  - easy to paste into GitHub (or used with `gh pr create` if desired)
21
21
 
@@ -285,7 +285,7 @@ oat_project: { PROJECT_PATH }
285
285
 
286
286
  ## Goals / Non-Goals
287
287
 
288
- {goals addressed by this phase, from available requirement artifacts: spec in spec-driven mode, discovery/import reference in quick/import mode}
288
+ {goals addressed by this phase, from available requirement artifacts: spec in spec-driven mode; discovery/import reference in quick/import mode; Summary, Decisions, Assumptions, Out of Scope, and Validation Criteria in plan.md for lite}
289
289
 
290
290
  ## Changes
291
291
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-progress
3
- version: 1.3.0
3
+ version: 1.4.0
4
4
  description: Use when the user explicitly asks to check OAT project progress — e.g. "check progress", "what's next", "where are we", or confirms a previously offered progress check. Do NOT auto-invoke just because a workflow step completed. Reads project status and offers the next route.
5
5
  disable-model-invocation: false
6
6
  user-invocable: true
@@ -160,6 +160,7 @@ No active projects.
160
160
  Start a new project:
161
161
  oat-project-new - Create a spec-driven project scaffold
162
162
  oat-project-quick-start - Start a quick workflow project
163
+ oat-project-lite - Start a lite workflow (interview -> plan -> implement)
163
164
  oat-project-import-plan - Import an external markdown plan into OAT
164
165
  ```
165
166
 
@@ -171,10 +172,12 @@ Read `{project}/state.md` frontmatter:
171
172
 
172
173
  - `oat_phase` - Current phase
173
174
  - `oat_phase_status` - in_progress or complete
174
- - `oat_workflow_mode` - spec-driven | quick | import
175
+ - `oat_workflow_mode` - spec-driven | quick | import | lite
175
176
  - `oat_blockers` - Any blockers
176
177
  - `oat_hill_checkpoints` - Configured gates (e.g., `["discovery", "spec", "design"]`)
177
178
  - `oat_hill_completed` - Completed HiLL checkpoints
179
+ - `oat_skill_gate_overrides` - Configured lifecycle gates this project
180
+ deliberately disabled, keyed by gate-aware skill name
178
181
 
179
182
  **Display format:**
180
183
 
@@ -186,10 +189,19 @@ Read `{project}/state.md` frontmatter:
186
189
  HiLL Gates: {oat_hill_checkpoints}
187
190
  Completed: {oat_hill_completed as checkmarks}
188
191
  HiLL Pending: {yes/no for current phase}
192
+ Gate Overrides: {gate-aware skill keys from oat_skill_gate_overrides, or "None"}
189
193
  Blockers: {oat_blockers or "None"}
190
194
  Next: {recommended_skill}
191
195
  ```
192
196
 
197
+ Report every active override by its gate-aware skill key, so a deliberately
198
+ disabled lifecycle gate is visible to reviewers rather than silently absent.
199
+ An override is project posture recorded in `state.md`; it never changes shared,
200
+ local, or user configuration, and it is not a gate outcome. Show an override
201
+ even when no gate is currently configured for that skill, and never infer a
202
+ configured gate from an override alone. This is read-only reporting: never add,
203
+ remove, or repair the map here.
204
+
193
205
  ### Step 5: Determine Next Skill
194
206
 
195
207
  Based on project state, recommend next action.
@@ -199,6 +211,7 @@ Read `oat_workflow_mode` from `state.md` frontmatter:
199
211
  - `spec-driven` (default if missing)
200
212
  - `quick`
201
213
  - `import`
214
+ - `lite`
202
215
 
203
216
  **HiLL override (apply before phase routing):**
204
217
 
@@ -279,6 +292,16 @@ Routing matrix by mode:
279
292
  | implement | complete | Ready for final review / PR |
280
293
  | implement | pr_open | `oat-project-complete` |
281
294
 
295
+ **Lite mode (`oat_workflow_mode: lite`):**
296
+
297
+ | oat_phase | oat_phase_status | Next Skill |
298
+ | --------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
299
+ | plan | in_progress | Continue `oat-project-lite` when the plan is still tier 3; otherwise `oat-project-implement` |
300
+ | plan | complete | `oat-project-implement` |
301
+ | implement | in_progress | Continue `oat-project-implement`. If drift detected (see drift detection above), also mention `oat-project-reconcile` as an option. |
302
+ | implement | complete | Ready for final review / PR |
303
+ | implement | pr_open | `oat-project-complete` |
304
+
282
305
  **If blockers exist:**
283
306
 
284
307
  ```
@@ -301,9 +324,10 @@ Knowledge:
301
324
  oat-repo-knowledge-index - Generate/refresh codebase knowledge base
302
325
 
303
326
  Workflow:
327
+ oat-project-lite - Start a lite workflow (interview -> plan -> implement)
304
328
  oat-project-quick-start - Start a quick workflow (discover -> plan -> implement)
305
329
  oat-project-import-plan - Import an external markdown plan and normalize plan.md
306
- oat-project-promote-spec-driven - Promote quick/import project to spec-driven lifecycle
330
+ oat-project-promote-spec-driven - Promote quick/import/lite project to spec-driven lifecycle (lite promotes via quick)
307
331
  oat-project-discover - Start discovery phase (requirements gathering)
308
332
  oat-project-design - Confirm requirements + create technical design (folds spec authoring inline)
309
333
  oat-project-spec - Optional standalone specification (most projects skip this — design handles it)
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-promote-spec-driven
3
- version: 1.2.1
3
+ version: 1.2.2
4
4
  description: Use when a quick or imported project now needs Spec-Driven lifecycle rigor. Backfills missing discovery, spec, and design artifacts in place.
5
5
  argument-hint: '[--project <name>]'
6
6
  disable-model-invocation: true
@@ -12,6 +12,8 @@ allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
12
12
 
13
13
  Convert a quick/import workflow project into a Spec-Driven OAT lifecycle project without creating a new project directory.
14
14
 
15
+ Lite projects promote through quick first: run `oat project promote <path> --to quick`, then use this skill. This skill's direct eligibility remains quick/import only.
16
+
15
17
  ## Prerequisites
16
18
 
17
19
  - Active project exists.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-quick-start
3
- version: 2.3.8
3
+ version: 2.3.9
4
4
  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.
5
5
  argument-hint: '<project-name> ["project description"]'
6
6
  oat_gateable: true
@@ -651,6 +651,25 @@ This Phase gate review setup is independent from HiLL checkpoints. Do not read o
651
651
  change HiLL fields here, and do not add a provider/model `--target` to any
652
652
  lifecycle command.
653
653
 
654
+ ### Step 3.57: Configure Lifecycle Gate Posture
655
+
656
+ After the generated quick plan has stable phase IDs and before Step 3.6
657
+ starts the plan artifact review, invoke the `Shared Lifecycle Gate Posture Setup Contract` from
658
+ `oat-project-plan-writing`: load the current
659
+ `oat-project-plan-writing/SKILL.md` and follow that contract as written. This
660
+ runs adjacent to, but independently from, the phase gate review setup above.
661
+
662
+ If `"$PROJECT_PATH/state.md"` already contains an explicit
663
+ `oat_skill_gate_overrides` map, preserve it through the shared contract without
664
+ probing, prompting, or mutation. Otherwise let the contract probe the configured
665
+ gate-aware skills and offer a keep-or-disable choice for each configured gate
666
+ independently.
667
+
668
+ Persist only disabled choices, and only in `"$PROJECT_PATH/state.md"`. Keeping
669
+ every gate leaves the map absent. Never modify the shared, local, or user
670
+ configuration layers, and never prompt or write a new map in non-interactive
671
+ mode.
672
+
654
673
  ### Step 3.6: Run Plan Artifact Review Loop
655
674
 
656
675
  Before dispatching the artifact reviewer, invoke the `Managed Dispatch
@@ -726,13 +745,19 @@ artifact above that exists.
726
745
  After artifact finalization and plan artifact review, run the configured gate
727
746
  as the last check before plan and project completion:
728
747
 
729
- 1. Resolve the gate for this skill:
748
+ 1. Resolve the gate for this skill with project context:
730
749
 
731
750
  ```bash
732
- oat gate resolve <this-skill> --json
751
+ oat gate resolve <this-skill> --project "$PROJECT_PATH" --json
733
752
  ```
734
753
 
735
- If the command returns JSON `null`, no gate is configured; proceed directly to the completion steps in Step 3.7 below.
754
+ Handle all three `resolution` values explicitly:
755
+ - `not_configured`: no gate is configured; proceed directly to the completion steps in Step 3.7 below.
756
+ - `configured_disabled_by_project`: the operator disabled this configured gate for this project. Do not launch any process. Emit `configured but disabled by project override`, including the project path and the `projectOverride` source from the envelope, then proceed directly to the completion steps in Step 3.7 below. A project-disabled gate never enters the passed, missing, or failed branches, and its `configuredGate` is evidence only, never executed.
757
+ - `configured`: continue with the steps below, executing `effectiveGate` exactly as configured.
758
+
759
+ A null, missing, malformed, or unrecognized result is an operational failure
760
+ that fails closed as unresolved. Never treat it as "no gate configured."
736
761
 
737
762
  2. Export the resolved project path into the command shell:
738
763