@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-capture
3
- version: 1.0.1
3
+ version: 1.0.2
4
4
  description: Use when work happened outside the OAT project workflow and needs retroactive project tracking. Creates a full project from an existing branch and conversation context.
5
5
  disable-model-invocation: true
6
6
  user-invocable: true
@@ -24,7 +24,7 @@ Use when:
24
24
  Don't use when:
25
25
 
26
26
  - A project already exists for the current branch — use `oat-project-reconcile` instead
27
- - You haven't started any work yet — use `oat-project-quick-start` or `oat-project-new`
27
+ - You haven't started any work yet — use `oat-project-lite` for single-sitting work, `oat-project-quick-start` for quick work, or `oat-project-new` for spec-driven work
28
28
  - You only need to map new commits to an existing plan — use `oat-project-reconcile`
29
29
 
30
30
  ## Prerequisites
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-design
3
- version: 2.3.3
3
+ version: 2.3.4
4
4
  description: Use when discovery is complete and implementation-ready decisions are needed. Runs a collaborative, selective collaborative, or draft-and-review design flow, confirms requirements and produces both `spec.md` and `design.md`, and commits artifacts before the user-review gate.
5
5
  disable-model-invocation: true
6
6
  user-invocable: true
@@ -656,14 +656,19 @@ Wait for user response:
656
656
  After artifact finalization and any configured HiLL approval, run the configured
657
657
  gate as the last check before the completion boundary:
658
658
 
659
- 1. Resolve the gate for this skill:
659
+ 1. Resolve the gate for this skill with project context:
660
660
 
661
661
  ```bash
662
- oat gate resolve <this-skill> --json
662
+ oat gate resolve <this-skill> --project "$PROJECT_PATH" --json
663
663
  ```
664
664
 
665
- If the command returns JSON `null`, no gate is configured; proceed directly
666
- to the completion steps in Step 8 below.
665
+ Handle all three `resolution` values explicitly:
666
+ - `not_configured`: no gate is configured; proceed directly to the completion steps in Step 8 below.
667
+ - `configured`: continue with the steps below, executing `effectiveGate` exactly as configured.
668
+ - `configured_disabled_by_project`: unreachable for this skill. Per-project override keys are accepted only for `oat_gateable` skills, and this skill is not one, so a configured gate here applies to every project and no project override can disable it. Treat this value as an unexpected result and fail closed as unresolved.
669
+
670
+ A null, missing, malformed, or unrecognized result is an operational failure
671
+ that fails closed as unresolved. Never treat it as "no gate configured."
667
672
 
668
673
  2. Export the resolved project path into the command shell:
669
674
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: oat-project-discover
3
- version: 2.2.3
4
- description: Use when the user explicitly asks to continue discovery for an active spec-driven OAT project — e.g. "continue discovery", "run discovery", or confirms a previously offered discovery step. Do NOT auto-invoke for new ideas or quick-mode projects. Gathers requirements and context before spec/design.
3
+ version: 2.2.5
4
+ description: Use when the user explicitly asks to continue discovery for an active spec-driven OAT project — e.g. "continue discovery", "run discovery", or confirms a previously offered discovery step. Do NOT auto-invoke for new ideas or quick/lite-mode projects. Gathers requirements and context before spec/design.
5
5
  disable-model-invocation: false
6
6
  user-invocable: true
7
7
  allowed-tools: Read, Write, Bash(git:*), Bash(oat:*), Bash(pnpm:*), Glob, Grep, AskUserQuestion
@@ -15,11 +15,11 @@ Gather requirements and understand the problem space through natural collaborati
15
15
 
16
16
  **Required:** Knowledge base must exist. If missing, run the `oat-repo-knowledge-index` skill first.
17
17
 
18
- **Required for model invocation:** An active spec-driven OAT project must already exist. If no active project exists, route to `oat-project-new` for spec-driven setup or `oat-project-quick-start` for quick workflow. If the active project is quick or import mode, decline this skill and route to the current mode's next step instead.
18
+ **Required for model invocation:** An active spec-driven OAT project must already exist. If no active project exists, route to `oat-project-new` for spec-driven setup, `oat-project-quick-start` for quick workflow, or `oat-project-lite` for single-sitting lite work. If the active project is quick, import, or lite mode, decline this skill and route to the current mode's next step instead.
19
19
 
20
20
  ## Model Invocation Gate
21
21
 
22
- This skill is model-invokable only for explicit discovery-continuation asks on an active spec-driven project. Do NOT auto-invoke when the user mentions a new idea, asks for a quick workflow, or has an active quick/import project.
22
+ This skill is model-invokable only for explicit discovery-continuation asks on an active spec-driven project. Do NOT auto-invoke when the user mentions a new idea, asks for a quick or lite workflow, or has an active quick/import/lite project.
23
23
 
24
24
  Before acting:
25
25
 
@@ -27,7 +27,7 @@ Before acting:
27
27
  2. Confirm `{PROJECT_PATH}/state.md` exists.
28
28
  3. Confirm `oat_workflow_mode` is `spec-driven` or absent only in a legacy spec-driven project.
29
29
 
30
- If any check fails, decline this skill. Offer `oat-project-new` for a new spec-driven project, `oat-project-quick-start` for a quick project, or `oat-project-open` for switching to an existing project. When the gate passes, summarize the active project and ask before continuing discovery.
30
+ If any check fails, decline this skill. Offer `oat-project-new` for a new spec-driven project, `oat-project-quick-start` for a quick project, `oat-project-lite` for single-sitting work, or `oat-project-open` for switching to an existing project. When the gate passes, summarize the active project and ask before continuing discovery.
31
31
 
32
32
  ## Mode Assertion
33
33
 
@@ -101,6 +101,7 @@ PROJECTS_ROOT="${PROJECTS_ROOT%/}"
101
101
  - Read `oat_workflow_mode` from `{PROJECT_PATH}/state.md`
102
102
  - If `oat_workflow_mode` is present and not `spec-driven`, stop and route:
103
103
  - quick project: continue with `oat-project-quick-start` / `oat-project-progress`
104
+ - lite project: continue with `oat-project-lite` / `oat-project-progress`
104
105
  - import project: continue with `oat-project-import-plan` / `oat-project-progress`
105
106
  - Ask user:
106
107
  - **Continue** with active project, or
@@ -429,14 +430,19 @@ If discovery is not configured as a HiLL checkpoint, or user explicitly approves
429
430
  After artifact finalization and any configured HiLL approval, run the configured
430
431
  gate as the last check before the completion boundary:
431
432
 
432
- 1. Resolve the gate for this skill:
433
+ 1. Resolve the gate for this skill with project context:
433
434
 
434
435
  ```bash
435
- oat gate resolve <this-skill> --json
436
+ oat gate resolve <this-skill> --project "$PROJECT_PATH" --json
436
437
  ```
437
438
 
438
- If the command returns JSON `null`, no gate is configured; proceed directly
439
- to the completion steps in Step 13 below.
439
+ Handle all three `resolution` values explicitly:
440
+ - `not_configured`: no gate is configured; proceed directly to the completion steps in Step 13 below.
441
+ - `configured`: continue with the steps below, executing `effectiveGate` exactly as configured.
442
+ - `configured_disabled_by_project`: unreachable for this skill. Per-project override keys are accepted only for `oat_gateable` skills, and this skill is not one, so a configured gate here applies to every project and no project override can disable it. Treat this value as an unexpected result and fail closed as unresolved.
443
+
444
+ A null, missing, malformed, or unrecognized result is an operational failure
445
+ that fails closed as unresolved. Never treat it as "no gate configured."
440
446
 
441
447
  2. Export the resolved project path into the command shell:
442
448
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-document
3
- version: 1.8.1
3
+ version: 1.8.2
4
4
  description: Use when the user requests or confirms documenting an active OAT project — e.g. "document the project", "update the docs", "run oat-project-document", or confirms a previously offered documentation run. Do NOT auto-invoke when implementation completes. Analyzes project artifacts, presents a documentation delta plan, and applies approved changes.
5
5
  argument-hint: '[project-path] [--auto]'
6
6
  disable-model-invocation: false
@@ -196,6 +196,16 @@ adoption could not be determined — the usual causes are `jq` missing from
196
196
 
197
197
  Read all available project artifacts to build an understanding of what was built.
198
198
 
199
+ For `oat_workflow_mode: lite`, use the reduced artifact contract instead of
200
+ the numbered artifact list below. Read the five `plan.md` sections `Summary`,
201
+ `Decisions`, `Assumptions`, `Out of Scope`, and `Validation Criteria`, then read
202
+ `implementation.md` task outcomes and `Final Summary (for PR/docs)` as the
203
+ shipped results. A lite project accepts `discovery.md`, `spec.md`, and
204
+ `design.md` as absent; do not read or require them. Build the documentation
205
+ delta from what actually shipped and continue with code verification.
206
+
207
+ For every other workflow mode, read the numbered artifact list below.
208
+
199
209
  **Read in order:**
200
210
 
201
211
  1. `$PROJECT_PATH/discovery.md` — initial requirements, key decisions, constraints