@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.
- package/assets/agents/oat-phase-implementer.md +9 -1
- package/assets/agents/oat-reviewer.md +8 -1
- package/assets/docs/cli-utilities/configuration.md +29 -0
- package/assets/docs/cli-utilities/tool-packs.md +29 -1
- package/assets/docs/contributing/skills.md +22 -0
- package/assets/docs/workflows/projects/artifacts.md +30 -0
- package/assets/docs/workflows/projects/autonomy.md +154 -0
- package/assets/docs/workflows/projects/cursor-cloud.md +151 -0
- package/assets/docs/workflows/projects/dispatch-ceiling.md +13 -0
- package/assets/docs/workflows/projects/index.md +6 -0
- package/assets/public-package-versions.json +4 -4
- package/assets/skills/oat-cursor-cloud-projects/SKILL.md +318 -0
- package/assets/skills/oat-cursor-cloud-projects/references/cursor-cloud-mechanics.md +173 -0
- package/assets/skills/oat-project-autonomous/SKILL.md +439 -0
- package/assets/skills/oat-project-autonomous/references/gate-inventory.md +294 -0
- package/assets/skills/oat-project-design/SKILL.md +79 -1
- package/assets/skills/oat-project-discover/SKILL.md +76 -1
- package/assets/skills/oat-project-document/SKILL.md +24 -1
- package/assets/skills/oat-project-document/references/docs/autonomy-contract.md +294 -0
- package/assets/skills/oat-project-implement/SKILL.md +18 -1
- package/assets/skills/oat-project-implement/references/completion-and-closeout.md +72 -7
- package/assets/skills/oat-project-implement/references/dispatch-and-dry-run.md +17 -9
- package/assets/skills/oat-project-implement/references/docs/autonomy-contract.md +294 -0
- package/assets/skills/oat-project-implement/references/plan-and-resume.md +56 -0
- package/assets/skills/oat-project-plan-writing/SKILL.md +48 -12
- package/assets/skills/oat-project-pr-final/SKILL.md +31 -4
- package/assets/skills/oat-project-pr-final/references/docs/autonomy-contract.md +294 -0
- package/assets/skills/oat-project-quick-start/SKILL.md +50 -2
- package/assets/skills/oat-project-quick-start/references/docs/autonomy-contract.md +294 -0
- package/assets/skills/oat-project-review-provide/SKILL.md +9 -1
- package/assets/skills/oat-project-review-receive/SKILL.md +9 -1
- package/assets/skills/oat-project-summary/SKILL.md +76 -14
- package/assets/templates/summary.md +24 -0
- package/dist/commands/gate/index.d.ts.map +1 -1
- package/dist/commands/gate/index.js +4 -1
- package/dist/commands/init/tools/index.d.ts.map +1 -1
- package/dist/commands/init/tools/index.js +67 -45
- package/dist/commands/init/tools/shared/skill-manifest.d.ts +1 -1
- package/dist/commands/init/tools/shared/skill-manifest.d.ts.map +1 -1
- package/dist/commands/init/tools/shared/skill-manifest.js +2 -0
- package/dist/commands/init/tools/workflows/index.d.ts +2 -1
- package/dist/commands/init/tools/workflows/index.d.ts.map +1 -1
- package/dist/commands/init/tools/workflows/index.js +13 -11
- package/dist/commands/init/tools/workflows/install-workflows.d.ts +2 -0
- package/dist/commands/init/tools/workflows/install-workflows.d.ts.map +1 -1
- package/dist/commands/init/tools/workflows/install-workflows.js +4 -0
- package/dist/commands/project/new/scaffold.d.ts +1 -0
- package/dist/commands/project/new/scaffold.d.ts.map +1 -1
- package/dist/commands/project/new/scaffold.js +23 -4
- package/dist/commands/tools/remove/index.js +2 -2
- package/dist/commands/tools/remove/remove-tools.d.ts.map +1 -1
- package/dist/commands/tools/remove/remove-tools.js +23 -0
- package/dist/commands/tools/update/index.d.ts.map +1 -1
- package/dist/commands/tools/update/index.js +7 -1
- package/dist/commands/tools/update/update-tools.d.ts +9 -0
- package/dist/commands/tools/update/update-tools.d.ts.map +1 -1
- package/dist/commands/tools/update/update-tools.js +25 -5
- package/dist/providers/identity/family.d.ts +1 -1
- package/dist/providers/identity/family.d.ts.map +1 -1
- package/dist/providers/identity/family.js +2 -0
- 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.
|
|
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
|
-
|
|
329
|
-
|
|
330
|
-
|
|
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
|
|
53
|
-
|
|
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
|
-
|
|
62
|
+
```
|
|
63
|
+
This OAT implementation skill normally delegates phase implementation and review to subagents. Authorize subagent delegation for this run?
|
|
57
64
|
|
|
58
|
-
|
|
59
|
-
|
|
65
|
+
Yes authorizes both oat-phase-implementer and oat-reviewer across every phase in this run.
|
|
66
|
+
```
|
|
60
67
|
|
|
61
|
-
|
|
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,
|
|
73
|
-
|
|
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
|