@open-agent-toolkit/cli 0.1.62 → 0.1.64

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 (61) hide show
  1. package/assets/agents/oat-phase-implementer.md +9 -1
  2. package/assets/agents/oat-reviewer.md +8 -1
  3. package/assets/docs/cli-utilities/configuration.md +29 -0
  4. package/assets/docs/cli-utilities/tool-packs.md +29 -1
  5. package/assets/docs/contributing/skills.md +22 -0
  6. package/assets/docs/workflows/projects/artifacts.md +30 -0
  7. package/assets/docs/workflows/projects/autonomy.md +154 -0
  8. package/assets/docs/workflows/projects/cursor-cloud.md +151 -0
  9. package/assets/docs/workflows/projects/dispatch-ceiling.md +13 -0
  10. package/assets/docs/workflows/projects/index.md +6 -0
  11. package/assets/public-package-versions.json +4 -4
  12. package/assets/skills/oat-cursor-cloud-projects/SKILL.md +318 -0
  13. package/assets/skills/oat-cursor-cloud-projects/references/cursor-cloud-mechanics.md +173 -0
  14. package/assets/skills/oat-project-autonomous/SKILL.md +439 -0
  15. package/assets/skills/oat-project-autonomous/references/gate-inventory.md +294 -0
  16. package/assets/skills/oat-project-design/SKILL.md +79 -1
  17. package/assets/skills/oat-project-discover/SKILL.md +76 -1
  18. package/assets/skills/oat-project-document/SKILL.md +24 -1
  19. package/assets/skills/oat-project-document/references/docs/autonomy-contract.md +294 -0
  20. package/assets/skills/oat-project-implement/SKILL.md +18 -1
  21. package/assets/skills/oat-project-implement/references/completion-and-closeout.md +72 -7
  22. package/assets/skills/oat-project-implement/references/dispatch-and-dry-run.md +17 -9
  23. package/assets/skills/oat-project-implement/references/docs/autonomy-contract.md +294 -0
  24. package/assets/skills/oat-project-implement/references/plan-and-resume.md +56 -0
  25. package/assets/skills/oat-project-plan-writing/SKILL.md +48 -12
  26. package/assets/skills/oat-project-pr-final/SKILL.md +31 -4
  27. package/assets/skills/oat-project-pr-final/references/docs/autonomy-contract.md +294 -0
  28. package/assets/skills/oat-project-quick-start/SKILL.md +50 -2
  29. package/assets/skills/oat-project-quick-start/references/docs/autonomy-contract.md +294 -0
  30. package/assets/skills/oat-project-review-provide/SKILL.md +9 -1
  31. package/assets/skills/oat-project-review-receive/SKILL.md +9 -1
  32. package/assets/skills/oat-project-summary/SKILL.md +76 -14
  33. package/assets/templates/summary.md +24 -0
  34. package/dist/commands/gate/index.d.ts.map +1 -1
  35. package/dist/commands/gate/index.js +4 -1
  36. package/dist/commands/init/tools/index.d.ts.map +1 -1
  37. package/dist/commands/init/tools/index.js +67 -45
  38. package/dist/commands/init/tools/shared/skill-manifest.d.ts +1 -1
  39. package/dist/commands/init/tools/shared/skill-manifest.d.ts.map +1 -1
  40. package/dist/commands/init/tools/shared/skill-manifest.js +2 -0
  41. package/dist/commands/init/tools/workflows/index.d.ts +2 -1
  42. package/dist/commands/init/tools/workflows/index.d.ts.map +1 -1
  43. package/dist/commands/init/tools/workflows/index.js +13 -11
  44. package/dist/commands/init/tools/workflows/install-workflows.d.ts +2 -0
  45. package/dist/commands/init/tools/workflows/install-workflows.d.ts.map +1 -1
  46. package/dist/commands/init/tools/workflows/install-workflows.js +4 -0
  47. package/dist/commands/project/new/scaffold.d.ts +1 -0
  48. package/dist/commands/project/new/scaffold.d.ts.map +1 -1
  49. package/dist/commands/project/new/scaffold.js +23 -4
  50. package/dist/commands/tools/remove/index.js +2 -2
  51. package/dist/commands/tools/remove/remove-tools.d.ts.map +1 -1
  52. package/dist/commands/tools/remove/remove-tools.js +23 -0
  53. package/dist/commands/tools/update/index.d.ts.map +1 -1
  54. package/dist/commands/tools/update/index.js +7 -1
  55. package/dist/commands/tools/update/update-tools.d.ts +9 -0
  56. package/dist/commands/tools/update/update-tools.d.ts.map +1 -1
  57. package/dist/commands/tools/update/update-tools.js +25 -5
  58. package/dist/providers/identity/family.d.ts +1 -1
  59. package/dist/providers/identity/family.d.ts.map +1 -1
  60. package/dist/providers/identity/family.js +2 -0
  61. package/package.json +2 -2
@@ -162,6 +162,28 @@ echo "$FINAL_ROW"
162
162
 
163
163
  - Tell user: "All tasks complete. Final review required before PR."
164
164
 
165
+ **Autonomous final-review path (before prompting):**
166
+
167
+ If `OAT_AUTONOMOUS=1`, do not present a review-execution choice. Resolve the
168
+ exact reviewer target through the project dispatch substrate, select the
169
+ highest target-preserving route before launch, and run
170
+ `oat-project-review-provide code final` followed immediately by
171
+ `oat-project-review-receive`.
172
+
173
+ - If receive creates fix tasks, return through the normal bounded implement and
174
+ re-review loop.
175
+ - Continue to Step 15 only when the final Reviews row is `passed`.
176
+ - A failed blocking review, unresolved Critical finding, exhausted route, or
177
+ missing credential with no adequate fallback is an autonomy boundary. Persist
178
+ the review state and report the exact resume action instead of falling
179
+ through to the prompt.
180
+ - Record gate `IMPLEMENT-11`, the selected route, achieved independence, and
181
+ dispatch-record reference in `implementation.md`.
182
+
183
+ After this autonomous branch succeeds, skip the workflow preference,
184
+ fresh-session guidance, and standard prompt below. When `OAT_AUTONOMOUS` is not
185
+ exactly `1`, this branch is inert.
186
+
165
187
  **Workflow preference check (before prompting):**
166
188
 
167
189
  First resolve the final reviewer target with the same target-first contract as
@@ -273,20 +295,40 @@ legacy or structured preference, normalize legacy values before snapshotting:
273
295
  ["summary", "pr"], postApproval: [] }`, and `docs-pr` → `{ preApproval:
274
296
  ["summary", "document", "pr"], postApproval: [] }`.
275
297
 
298
+ If `OAT_AUTONOMOUS=1` and the preference is unset, use the inventory's
299
+ autonomous lifecycle-tail default:
300
+
301
+ ```yaml
302
+ preApproval: [summary, document, pr]
303
+ postApproval: []
304
+ ```
305
+
306
+ Treat this as an in-memory effective preference and create the same immutable
307
+ sequence snapshot as a configured structured value. Add
308
+ `source: autonomous-default` to that snapshot. A configured legacy or
309
+ structured preference remains authoritative and uses `source: configured`;
310
+ preserve its normalized arrays and stored order exactly.
311
+
276
312
  Persist this immutable state before dispatching a child:
277
313
 
278
314
  ```yaml
279
315
  oat_post_implement_sequence:
280
316
  status: pre_approval # pre_approval | awaiting_approval | post_approval | failed | complete
317
+ source: configured # configured | autonomous-default
281
318
  final_phase: pNN
282
319
  pre_approval: [summary, document, pr]
283
320
  pre_approval_completed: []
284
321
  approval: pending # pending | approved | not_required
322
+ approval_source: null # null | user | oat-autonomous
285
323
  post_approval: []
286
324
  post_approval_completed: []
287
325
  failure: null
288
326
  ```
289
327
 
328
+ `source` and `approval_source` are additive provenance fields. A resumable
329
+ snapshot created by an older skill version remains valid when either field is
330
+ absent; do not rewrite its stored pre/post arrays merely to backfill provenance.
331
+
290
332
  The snapshot is immutable for this closeout: never re-resolve
291
333
  `workflow.postImplementSequence` while it is incomplete. Iterate
292
334
  `pre_approval` and `post_approval` in their stored array order; do not sort or
@@ -313,8 +355,8 @@ exact resume command: `oat-project-implement`.
313
355
  awaiting_approval` with `approval: pending` before asking for final HiLL
314
356
  approval.
315
357
  3. Record explicit approval as `approval: approved` and `status: post_approval`
316
- before any post-approval dispatch. Then dispatch incomplete `post_approval`
317
- steps in stored order.
358
+ before any post-approval dispatch. Record `approval_source: user` in the same
359
+ commit. Then dispatch incomplete `post_approval` steps in stored order.
318
360
  4. A decline or defer keeps `status: awaiting_approval` and `approval: pending`;
319
361
  record neither approval nor failure and run no post-approval step. State the
320
362
  boundary and exact resume command: `oat-project-implement`.
@@ -325,14 +367,37 @@ awaiting_approval` with `approval: pending` before asking for final HiLL
325
367
  implementation state, append the configured final HiLL completion, and
326
368
  continue to the existing next-step behavior.
327
369
 
328
- If the preference is unset, do not create a sequence snapshot. When the
329
- preference is unset, retain the existing next-step prompt only after final
330
- approval when a final checkpoint is configured.
370
+ **Autonomous final HiLL approval:**
371
+
372
+ When `OAT_AUTONOMOUS=1`, gate `IMPLEMENT-16` replaces only the approval question
373
+ in steps 2-4:
374
+
375
+ 1. Require the final review row to be `passed` and verify its review artifact
376
+ and dispatch record. A failed blocking review or unresolved Critical finding
377
+ stops before approval.
378
+ 2. After all `pre_approval` steps succeed, commit `status: awaiting_approval`
379
+ with `approval: pending` exactly as above.
380
+ 3. Without waiting for input, commit `approval: approved`,
381
+ `approval_source: oat-autonomous`, and `status: post_approval`, referencing
382
+ the passing final review and dispatch record in `implementation.md`.
383
+ 4. Dispatch incomplete `post_approval` steps in stored order, then finish the
384
+ snapshot normally.
385
+
386
+ The policy approval occurs after pre-approval work and before any post-approval
387
+ work. It does not waive a failed review, child failure, repository-policy
388
+ approval, destructive-change risk, or missing-credential boundary. When
389
+ autonomy is inactive, the explicit user approval/decline/defer behavior above
390
+ is unchanged.
391
+
392
+ If the preference is unset and autonomy is inactive, do not create a sequence
393
+ snapshot. Retain the existing next-step prompt only after final approval when a
394
+ final checkpoint is configured. Under autonomy, the default snapshot above
395
+ always resolves the unset case.
331
396
 
332
397
  ### Step 16: Prompt for Next Steps
333
398
 
334
- Run the standard next-step prompt only when
335
- `workflow.postImplementSequence` was unset and no sequence snapshot was
399
+ Run the standard next-step prompt only when `OAT_AUTONOMOUS` is not `1`,
400
+ `workflow.postImplementSequence` was unset, and no sequence snapshot was
336
401
  created. It occurs after final approval when a final checkpoint is configured.
337
402
  A configured legacy or structured preference has already completed through
338
403
  **Final HiLL Closeout Sequence**; do not re-dispatch its steps here. When the
@@ -49,16 +49,23 @@ block on user-initiated fresh sessions mid-run):
49
49
  context; do not rely on forked full-thread context when pinning a
50
50
  specialized OAT role.
51
51
  - Available without auth → Tier 1.
52
- - Available with auth required → fail closed. Ask the user once at skill
53
- start before selecting Tier 2 or starting implementation work:
52
+ - Available with auth required:
53
+ - If `OAT_AUTONOMOUS=1`, gate `IMPLEMENT-08` authorizes delegation once
54
+ for this run, covering only `oat-phase-implementer` and `oat-reviewer`
55
+ within the plan's bounded phase/review scopes. Record the authorization
56
+ scope in the dispatch record, re-probe, and use Tier 1 when the host
57
+ accepts it. If the host requires an out-of-band grant that the current
58
+ run cannot supply, stop at a reported authorization boundary.
59
+ - Otherwise, fail closed and ask the user once at skill start before
60
+ selecting Tier 2 or starting implementation work:
54
61
 
55
- ```
56
- This OAT implementation skill normally delegates phase implementation and review to subagents. Authorize subagent delegation for this run?
62
+ ```
63
+ This OAT implementation skill normally delegates phase implementation and review to subagents. Authorize subagent delegation for this run?
57
64
 
58
- Yes authorizes both oat-phase-implementer and oat-reviewer across every phase in this run.
59
- ```
65
+ Yes authorizes both oat-phase-implementer and oat-reviewer across every phase in this run.
66
+ ```
60
67
 
61
- Approved → Tier 1. Declined → Tier 2.
68
+ Approved → Tier 1. Declined → Tier 2.
62
69
 
63
70
  - If the host does not resolve either generic agent, first attempt the exact
64
71
  registered role natively for any concrete managed target. Use the explicitly
@@ -69,8 +76,9 @@ block on user-initiated fresh sessions mid-run):
69
76
  **Approval scope rule:** this Tier selection applies to both phase
70
77
  implementation and checkpoint review. Do not infer a mixed mode from
71
78
  conversational emphasis on review checkpoints. If the user has not explicitly
72
- approved Tier 1 for the run, stay Tier 2 throughout. Mixed mode is only valid
73
- when the user explicitly requests it.
79
+ approved Tier 1 for the run, and gate `IMPLEMENT-08` has not supplied the
80
+ bounded autonomous run authorization above, stay Tier 2 throughout. Mixed mode
81
+ is only valid when the user explicitly requests it.
74
82
 
75
83
  **Codex fail-closed rule:** after this skill is invoked, "user did not
76
84
  separately ask for subagents" is not a valid Tier 2 reason. If Codex can spawn