@open-agent-toolkit/cli 0.2.57 → 0.2.59

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 (64) hide show
  1. package/assets/agents/oat-phase-implementer.md +44 -2
  2. package/assets/bundle-metadata.json +1 -1
  3. package/assets/docs/cli-utilities/configuration.md +16 -0
  4. package/assets/docs/cli-utilities/workflow-gates.md +88 -3
  5. package/assets/docs/contributing/skills.md +27 -5
  6. package/assets/docs/contributing/smoke-testing.md +44 -0
  7. package/assets/docs/provider-sync/commands.md +23 -0
  8. package/assets/docs/workflows/projects/autonomy.md +5 -2
  9. package/assets/docs/workflows/projects/dispatch-ceiling.md +43 -7
  10. package/assets/docs/workflows/projects/implementation-execution.md +6 -3
  11. package/assets/docs/workflows/projects/lifecycle.md +4 -3
  12. package/assets/public-package-versions.json +4 -4
  13. package/assets/skills/oat-project-autonomous/SKILL.md +1 -1
  14. package/assets/skills/oat-project-autonomous/references/gate-inventory.md +45 -38
  15. package/assets/skills/oat-project-design/SKILL.md +24 -5
  16. package/assets/skills/oat-project-discover/SKILL.md +10 -5
  17. package/assets/skills/oat-project-document/references/docs/autonomy-contract.md +45 -38
  18. package/assets/skills/oat-project-implement/SKILL.md +1 -1
  19. package/assets/skills/oat-project-implement/references/completion-and-closeout.md +43 -9
  20. package/assets/skills/oat-project-implement/references/dispatch-and-dry-run.md +14 -8
  21. package/assets/skills/oat-project-implement/references/docs/autonomy-contract.md +45 -38
  22. package/assets/skills/oat-project-implement/references/phase-execution.md +7 -3
  23. package/assets/skills/oat-project-import-plan/SKILL.md +29 -4
  24. package/assets/skills/oat-project-next/SKILL.md +29 -2
  25. package/assets/skills/oat-project-plan/SKILL.md +29 -4
  26. package/assets/skills/oat-project-plan-writing/SKILL.md +95 -1
  27. package/assets/skills/oat-project-pr-final/references/docs/autonomy-contract.md +45 -38
  28. package/assets/skills/oat-project-progress/SKILL.md +12 -1
  29. package/assets/skills/oat-project-quick-start/SKILL.md +29 -4
  30. package/assets/skills/oat-project-quick-start/references/docs/autonomy-contract.md +45 -38
  31. package/assets/skills/oat-project-review-provide/SKILL.md +13 -6
  32. package/assets/skills/oat-project-review-provide-remote/SKILL.md +12 -5
  33. package/assets/templates/state.md +4 -1
  34. package/dist/commands/gate/index.d.ts.map +1 -1
  35. package/dist/commands/gate/index.js +102 -8
  36. package/dist/commands/init/index.d.ts.map +1 -1
  37. package/dist/commands/init/index.js +16 -1
  38. package/dist/commands/project/dispatch-ceiling/index.d.ts.map +1 -1
  39. package/dist/commands/project/dispatch-ceiling/index.js +10 -1
  40. package/dist/commands/remove/skill/remove-skill.d.ts.map +1 -1
  41. package/dist/commands/remove/skill/remove-skill.js +10 -1
  42. package/dist/commands/shared/frontmatter.d.ts +32 -1
  43. package/dist/commands/shared/frontmatter.d.ts.map +1 -1
  44. package/dist/commands/shared/frontmatter.js +92 -0
  45. package/dist/commands/status/index.d.ts.map +1 -1
  46. package/dist/commands/status/index.js +8 -1
  47. package/dist/commands/sync/apply.d.ts.map +1 -1
  48. package/dist/commands/sync/apply.js +40 -6
  49. package/dist/commands/sync/index.d.ts.map +1 -1
  50. package/dist/commands/sync/index.js +11 -17
  51. package/dist/commands/sync/sync.types.d.ts +6 -6
  52. package/dist/commands/sync/sync.types.d.ts.map +1 -1
  53. package/dist/config/resolve.d.ts +16 -0
  54. package/dist/config/resolve.d.ts.map +1 -1
  55. package/dist/config/resolve.js +16 -8
  56. package/dist/engine/execute-plan.d.ts.map +1 -1
  57. package/dist/engine/execute-plan.js +6 -0
  58. package/dist/manifest/index.d.ts +2 -1
  59. package/dist/manifest/index.d.ts.map +1 -1
  60. package/dist/manifest/index.js +1 -1
  61. package/dist/manifest/manager.d.ts +40 -0
  62. package/dist/manifest/manager.d.ts.map +1 -1
  63. package/dist/manifest/manager.js +35 -0
  64. package/package.json +2 -2
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-design
3
- version: 2.3.2
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
@@ -402,6 +402,20 @@ Draft `design.md` section-by-section (Collaborative mode) or in a single pass (D
402
402
  11. **Implementation Phases** — Break work into manageable phases (1-3 days each). Per-phase structure: Goal, Tasks (high-level), Verification.
403
403
  12. **Risks and Mitigation** — For each significant risk: Probability | Impact; Mitigation; Contingency.
404
404
 
405
+ **Standing invariants (Error Handling and Testing Strategy):** when a section
406
+ states a standing invariant — an "every", "always", "only", ordering, or
407
+ completeness claim expected to hold for the life of the feature — name its
408
+ executable owner and its verification method in the same design: the specific
409
+ test or check that fails when the claim breaks, and how that failure surfaces.
410
+ Route a claim decidable from tracked files to a contract test, and a claim that
411
+ depends on execution state or ordering to the code that owns the operation and
412
+ emits a structured result. A point-in-time observation about today's codebase
413
+ needs a citation, not an owner. Record the owner beside the error category it
414
+ guards, or in the Requirement-to-Test Mapping row it belongs to. The full
415
+ taxonomy, stable-identity, and same-PR rules live in the `create-oat-skill`
416
+ skill; do not restate them here. Changing this paragraph means updating its
417
+ contract case in `packages/cli/src/validation/skills.test.ts` in the same PR.
418
+
405
419
  ### Step 4a: Selective Review Pass
406
420
 
407
421
  If `DESIGN_MODE == "selective"`, classify every section before drafting and present the Section Review Plan to the user. Use `.agents/skills/oat-project-design/references/selective-review-pass.md` for the full signal set, grounding rules, edge cases, and dogfood notes.
@@ -642,14 +656,19 @@ Wait for user response:
642
656
  After artifact finalization and any configured HiLL approval, run the configured
643
657
  gate as the last check before the completion boundary:
644
658
 
645
- 1. Resolve the gate for this skill:
659
+ 1. Resolve the gate for this skill with project context:
646
660
 
647
661
  ```bash
648
- oat gate resolve <this-skill> --json
662
+ oat gate resolve <this-skill> --project "$PROJECT_PATH" --json
649
663
  ```
650
664
 
651
- If the command returns JSON `null`, no gate is configured; proceed directly
652
- 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."
653
672
 
654
673
  2. Export the resolved project path into the command shell:
655
674
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-discover
3
- version: 2.2.3
3
+ version: 2.2.4
4
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.
5
5
  disable-model-invocation: false
6
6
  user-invocable: true
@@ -429,14 +429,19 @@ If discovery is not configured as a HiLL checkpoint, or user explicitly approves
429
429
  After artifact finalization and any configured HiLL approval, run the configured
430
430
  gate as the last check before the completion boundary:
431
431
 
432
- 1. Resolve the gate for this skill:
432
+ 1. Resolve the gate for this skill with project context:
433
433
 
434
434
  ```bash
435
- oat gate resolve <this-skill> --json
435
+ oat gate resolve <this-skill> --project "$PROJECT_PATH" --json
436
436
  ```
437
437
 
438
- If the command returns JSON `null`, no gate is configured; proceed directly
439
- to the completion steps in Step 13 below.
438
+ Handle all three `resolution` values explicitly:
439
+ - `not_configured`: no gate is configured; proceed directly to the completion steps in Step 13 below.
440
+ - `configured`: continue with the steps below, executing `effectiveGate` exactly as configured.
441
+ - `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.
442
+
443
+ A null, missing, malformed, or unrecognized result is an operational failure
444
+ that fails closed as unresolved. Never treat it as "no gate configured."
440
445
 
441
446
  2. Export the resolved project path into the command shell:
442
447