@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.
- package/assets/agents/oat-phase-implementer.md +27 -4
- package/assets/agents/oat-reviewer.md +25 -14
- package/assets/bundle-metadata.json +1 -1
- package/assets/docs/cli-utilities/configuration.md +16 -0
- package/assets/docs/cli-utilities/workflow-gates.md +91 -6
- package/assets/docs/contributing/skills.md +27 -5
- package/assets/docs/provider-sync/commands.md +23 -0
- package/assets/docs/reference/cli-reference.md +10 -3
- package/assets/docs/reference/oat-directory-structure.md +1 -0
- package/assets/docs/workflows/ideas/index.md +1 -1
- package/assets/docs/workflows/index.md +1 -0
- package/assets/docs/workflows/projects/artifacts.md +24 -3
- package/assets/docs/workflows/projects/autonomy.md +5 -2
- package/assets/docs/workflows/projects/dispatch-ceiling.md +43 -7
- package/assets/docs/workflows/projects/hill-checkpoints.md +21 -0
- package/assets/docs/workflows/projects/implementation-execution.md +10 -2
- package/assets/docs/workflows/projects/lifecycle.md +128 -10
- package/assets/docs/workflows/projects/pr-flow.md +2 -0
- package/assets/docs/workflows/projects/reviews.md +1 -1
- package/assets/docs/workflows/projects/state-machine.md +20 -0
- package/assets/docs/workflows/skills/index.md +2 -1
- package/assets/public-package-versions.json +4 -4
- package/assets/skills/oat-brainstorm/SKILL.md +61 -12
- package/assets/skills/oat-docs/SKILL.md +13 -8
- package/assets/skills/oat-doctor/SKILL.md +3 -3
- package/assets/skills/oat-pjm-review-backlog/SKILL.md +2 -2
- package/assets/skills/oat-project-autonomous/SKILL.md +14 -9
- package/assets/skills/oat-project-autonomous/references/gate-inventory.md +59 -38
- package/assets/skills/oat-project-capture/SKILL.md +2 -2
- package/assets/skills/oat-project-design/SKILL.md +10 -5
- package/assets/skills/oat-project-discover/SKILL.md +15 -9
- package/assets/skills/oat-project-document/SKILL.md +11 -1
- package/assets/skills/oat-project-document/references/docs/autonomy-contract.md +59 -38
- package/assets/skills/oat-project-implement/SKILL.md +3 -3
- package/assets/skills/oat-project-implement/references/completion-and-closeout.md +149 -24
- package/assets/skills/oat-project-implement/references/dispatch-and-dry-run.md +14 -8
- package/assets/skills/oat-project-implement/references/docs/autonomy-contract.md +59 -38
- package/assets/skills/oat-project-implement/references/phase-execution.md +16 -1
- package/assets/skills/oat-project-implement/references/plan-and-resume.md +19 -1
- package/assets/skills/oat-project-import-plan/SKILL.md +75 -6
- package/assets/skills/oat-project-lite/SKILL.md +467 -0
- package/assets/skills/oat-project-lite/references/docs/autonomy-contract.md +331 -0
- package/assets/skills/oat-project-next/SKILL.md +54 -11
- package/assets/skills/oat-project-plan/SKILL.md +42 -5
- package/assets/skills/oat-project-plan-writing/SKILL.md +100 -3
- package/assets/skills/oat-project-pr-final/SKILL.md +33 -7
- package/assets/skills/oat-project-pr-final/references/docs/autonomy-contract.md +59 -38
- package/assets/skills/oat-project-pr-progress/SKILL.md +3 -3
- package/assets/skills/oat-project-progress/SKILL.md +27 -3
- package/assets/skills/oat-project-promote-spec-driven/SKILL.md +3 -1
- package/assets/skills/oat-project-quick-start/SKILL.md +29 -4
- package/assets/skills/oat-project-quick-start/references/docs/autonomy-contract.md +59 -38
- package/assets/skills/oat-project-review-provide/SKILL.md +37 -11
- package/assets/skills/oat-project-review-provide-remote/SKILL.md +12 -5
- package/assets/skills/oat-project-summary/SKILL.md +27 -3
- package/assets/templates/plan-lite.md +165 -0
- package/assets/templates/plan.md +1 -1
- package/assets/templates/state.md +5 -2
- package/dist/commands/gate/index.d.ts.map +1 -1
- package/dist/commands/gate/index.js +102 -8
- package/dist/commands/init/index.d.ts.map +1 -1
- package/dist/commands/init/index.js +16 -1
- package/dist/commands/project/dispatch-ceiling/index.d.ts.map +1 -1
- package/dist/commands/project/dispatch-ceiling/index.js +10 -1
- package/dist/commands/project/index.d.ts.map +1 -1
- package/dist/commands/project/index.js +2 -0
- package/dist/commands/project/new/index.d.ts +3 -2
- package/dist/commands/project/new/index.d.ts.map +1 -1
- package/dist/commands/project/new/index.js +2 -1
- package/dist/commands/project/new/scaffold.d.ts +5 -3
- package/dist/commands/project/new/scaffold.d.ts.map +1 -1
- package/dist/commands/project/new/scaffold.js +38 -10
- package/dist/commands/project/promote/index.d.ts +2 -0
- package/dist/commands/project/promote/index.d.ts.map +1 -0
- package/dist/commands/project/promote/index.js +1 -0
- package/dist/commands/project/promote/promote.d.ts +47 -0
- package/dist/commands/project/promote/promote.d.ts.map +1 -0
- package/dist/commands/project/promote/promote.js +322 -0
- package/dist/commands/project/split/run.d.ts.map +1 -1
- package/dist/commands/project/split/run.js +8 -1
- package/dist/commands/project/validate-plan/index.d.ts.map +1 -1
- package/dist/commands/project/validate-plan/index.js +25 -1
- package/dist/commands/project/validate-plan/validate-plan.d.ts +8 -0
- package/dist/commands/project/validate-plan/validate-plan.d.ts.map +1 -1
- package/dist/commands/project/validate-plan/validate-plan.js +49 -0
- package/dist/commands/remove/skill/remove-skill.d.ts.map +1 -1
- package/dist/commands/remove/skill/remove-skill.js +10 -1
- package/dist/commands/shared/frontmatter.d.ts +32 -1
- package/dist/commands/shared/frontmatter.d.ts.map +1 -1
- package/dist/commands/shared/frontmatter.js +93 -0
- package/dist/commands/state/generate.d.ts.map +1 -1
- package/dist/commands/state/generate.js +23 -0
- package/dist/commands/status/index.d.ts.map +1 -1
- package/dist/commands/status/index.js +8 -1
- package/dist/commands/sync/apply.d.ts.map +1 -1
- package/dist/commands/sync/apply.js +40 -6
- package/dist/commands/sync/index.d.ts.map +1 -1
- package/dist/commands/sync/index.js +11 -17
- package/dist/commands/sync/sync.types.d.ts +6 -6
- package/dist/commands/sync/sync.types.d.ts.map +1 -1
- package/dist/commands/tools/shared/pack-manifest.d.ts.map +1 -1
- package/dist/commands/tools/shared/pack-manifest.js +2 -0
- package/dist/config/resolve.d.ts +16 -0
- package/dist/config/resolve.d.ts.map +1 -1
- package/dist/config/resolve.js +16 -8
- package/dist/engine/execute-plan.d.ts.map +1 -1
- package/dist/engine/execute-plan.js +6 -0
- package/dist/manifest/index.d.ts +2 -1
- package/dist/manifest/index.d.ts.map +1 -1
- package/dist/manifest/index.js +1 -1
- package/dist/manifest/manager.d.ts +40 -0
- package/dist/manifest/manager.d.ts.map +1 -1
- package/dist/manifest/manager.js +35 -0
- package/package.json +2 -2
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: oat-project-pr-progress
|
|
3
|
-
version: 1.3.
|
|
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
|
|
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
|
+
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.
|
|
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.
|
|
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
|
-
|
|
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
|
|