@open-agent-toolkit/cli 0.2.54 → 0.2.55

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 (17) hide show
  1. package/assets/bundle-metadata.json +1 -1
  2. package/assets/docs/workflows/skills/recon.md +28 -12
  3. package/assets/public-package-versions.json +4 -4
  4. package/assets/skills/oat-dispatch-subagents/SKILL.md +4 -105
  5. package/assets/skills/oat-dispatch-subagents/references/record-schema.md +0 -226
  6. package/assets/skills/oat-project-autonomous/references/gate-inventory.md +2 -2
  7. package/assets/skills/oat-project-document/references/docs/autonomy-contract.md +2 -2
  8. package/assets/skills/oat-project-implement/references/docs/autonomy-contract.md +2 -2
  9. package/assets/skills/oat-project-pr-final/references/docs/autonomy-contract.md +2 -2
  10. package/assets/skills/oat-project-quick-start/references/docs/autonomy-contract.md +2 -2
  11. package/assets/skills/recon/SKILL.md +76 -38
  12. package/assets/skills/recon/references/packet-contract.md +138 -105
  13. package/assets/skills/recon/scripts/lib/contracts.mjs +181 -674
  14. package/assets/skills/recon/scripts/lib/validated-run.mjs +10 -16
  15. package/assets/skills/recon/scripts/render-packet.mjs +7 -20
  16. package/assets/skills/recon/scripts/validate-packet.mjs +177 -344
  17. package/package.json +2 -2
package/assets/skills/oat-project-document/references/docs/autonomy-contract.md CHANGED
@@ -252,11 +252,11 @@ remains immutable baseline evidence for the original p01-t01 verification.
252
252
  | `oat-project-implement/references/phase-execution.md` | `b31a9a4e6f75 -> NG` |
253
253
  | `oat-dispatch-subagents/SKILL.md` | `49987359dc09 -> NG` |
254
254
  | `oat-dispatch-subagents/references/provider-claude.md` | `06f64bd01ba6 -> NG` |
255
- | `oat-dispatch-subagents/SKILL.md` | `cb4f86157fd6 -> DISPATCH-01`; `f165b1626192 -> DISPATCH-01`; `7ed5e2b1eb71 -> PDISPATCH-01`; `11c72bcdebad -> DISPATCH-02`; `0834ee701e12 -> DISPATCH-02`; `7fda54e1d519 -> PDISPATCH-01`; `061f76074399 -> NG`; `5ae9e0e4ac47 -> NG`; `a2664ca9acf1 -> DISPATCH-01`; `12793022a2a4 -> DISPATCH-01`; `4a31444d4369 -> NG`; `68abaecc3e94 -> NG`; `7053910e10ef -> NG`; `a25ba09f5945 -> DISPATCH-01`; `9cdb9a679938 -> NG`; `2bc7c4717fd3 -> NG`; `0c7341966904 -> NG`; `e17d0f753630 -> NG`; `9fb0dd804b14 -> NG`; `2bab3a57a985 -> DISPATCH-01`; `63bdef0459e0 -> NG`; `e1936c17fece -> NG`; `e8e18fc1154a -> NG` |
255
+ | `oat-dispatch-subagents/SKILL.md` | `cb4f86157fd6 -> DISPATCH-01`; `f165b1626192 -> DISPATCH-01`; `7ed5e2b1eb71 -> PDISPATCH-01`; `11c72bcdebad -> DISPATCH-02`; `0834ee701e12 -> DISPATCH-02`; `7fda54e1d519 -> PDISPATCH-01` |
256
256
  | `oat-dispatch-subagents/references/provider-claude.md` | `fbe3a21e9533 -> NG` |
257
257
  | `oat-dispatch-subagents/references/provider-codex.md` | `95b0f82018c7 -> NG` |
258
258
  | `oat-dispatch-subagents/references/provider-cursor.md` | `f781555295a9 -> NG`; `55ccfef14fd6 -> NG` |
259
- | `oat-dispatch-subagents/references/record-schema.md` | `78f8069274a8 -> NG`; `1c9a84c4d1e0 -> NG`; `12cdc1878e52 -> NG`; `af49d3dd297a -> NG`; `b6ec6e06e5b6 -> NG`; `a3a7ab0a05b4 -> NG`; `95820a0aced8 -> NG`; `273f5072954a -> NG`; `c6ab5ab1e06e -> NG`; `eb509ef89f26 -> NG`; `a014397a631c -> NG`; `d07c12e91bd8 -> NG`; `8fa5bb3f4105 -> NG`; `0ca0e55fce05 -> NG`; `f1cab0929f78 -> DISPATCH-01`; `25795e03a05a -> DISPATCH-01`; `c868f3b5ecc5 -> NG`; `f56113f1b003 -> NG`; `fca94abe381d -> DISPATCH-01`; `afc8d0aca7f0 -> NG`; `7119e48819d8 -> NG`; `62c4de81f4a6 -> NG`; `2524fbd4eb09 -> DISPATCH-01`; `af8a7cdd0523 -> NG`; `e22e8a0915e7 -> NG`; `2a63da6e3a96 -> NG`; `30762d53b043 -> NG` |
259
+ | `oat-dispatch-subagents/references/record-schema.md` | `78f8069274a8 -> NG`; `1c9a84c4d1e0 -> NG`; `2a63da6e3a96 -> NG`; `30762d53b043 -> NG` |
260
260
  | `oat-project-dispatch-subagents/SKILL.md` | `eca03ad1ca12 -> PDISPATCH-01`; `59fbcdc79cea -> PDISPATCH-01` |
261
261
  | `oat-project-plan/SKILL.md` | `f99e44b39932 -> PLAN-12`; `7e6a9854504b -> NG` |
262
262
  | `oat-project-implement/references/completion-and-closeout.md` | `6909a5a5a1fa -> IMPLEMENT-19`; `a7c02ef670fd -> IMPLEMENT-19`; `9dde56d89a71 -> IMPLEMENT-16`; `13c41b2b2590 -> IMPLEMENT-16` |
package/assets/skills/oat-project-implement/references/docs/autonomy-contract.md CHANGED
@@ -252,11 +252,11 @@ remains immutable baseline evidence for the original p01-t01 verification.
252
252
  | `oat-project-implement/references/phase-execution.md` | `b31a9a4e6f75 -> NG` |
253
253
  | `oat-dispatch-subagents/SKILL.md` | `49987359dc09 -> NG` |
254
254
  | `oat-dispatch-subagents/references/provider-claude.md` | `06f64bd01ba6 -> NG` |
255
- | `oat-dispatch-subagents/SKILL.md` | `cb4f86157fd6 -> DISPATCH-01`; `f165b1626192 -> DISPATCH-01`; `7ed5e2b1eb71 -> PDISPATCH-01`; `11c72bcdebad -> DISPATCH-02`; `0834ee701e12 -> DISPATCH-02`; `7fda54e1d519 -> PDISPATCH-01`; `061f76074399 -> NG`; `5ae9e0e4ac47 -> NG`; `a2664ca9acf1 -> DISPATCH-01`; `12793022a2a4 -> DISPATCH-01`; `4a31444d4369 -> NG`; `68abaecc3e94 -> NG`; `7053910e10ef -> NG`; `a25ba09f5945 -> DISPATCH-01`; `9cdb9a679938 -> NG`; `2bc7c4717fd3 -> NG`; `0c7341966904 -> NG`; `e17d0f753630 -> NG`; `9fb0dd804b14 -> NG`; `2bab3a57a985 -> DISPATCH-01`; `63bdef0459e0 -> NG`; `e1936c17fece -> NG`; `e8e18fc1154a -> NG` |
255
+ | `oat-dispatch-subagents/SKILL.md` | `cb4f86157fd6 -> DISPATCH-01`; `f165b1626192 -> DISPATCH-01`; `7ed5e2b1eb71 -> PDISPATCH-01`; `11c72bcdebad -> DISPATCH-02`; `0834ee701e12 -> DISPATCH-02`; `7fda54e1d519 -> PDISPATCH-01` |
256
256
  | `oat-dispatch-subagents/references/provider-claude.md` | `fbe3a21e9533 -> NG` |
257
257
  | `oat-dispatch-subagents/references/provider-codex.md` | `95b0f82018c7 -> NG` |
258
258
  | `oat-dispatch-subagents/references/provider-cursor.md` | `f781555295a9 -> NG`; `55ccfef14fd6 -> NG` |
259
- | `oat-dispatch-subagents/references/record-schema.md` | `78f8069274a8 -> NG`; `1c9a84c4d1e0 -> NG`; `12cdc1878e52 -> NG`; `af49d3dd297a -> NG`; `b6ec6e06e5b6 -> NG`; `a3a7ab0a05b4 -> NG`; `95820a0aced8 -> NG`; `273f5072954a -> NG`; `c6ab5ab1e06e -> NG`; `eb509ef89f26 -> NG`; `a014397a631c -> NG`; `d07c12e91bd8 -> NG`; `8fa5bb3f4105 -> NG`; `0ca0e55fce05 -> NG`; `f1cab0929f78 -> DISPATCH-01`; `25795e03a05a -> DISPATCH-01`; `c868f3b5ecc5 -> NG`; `f56113f1b003 -> NG`; `fca94abe381d -> DISPATCH-01`; `afc8d0aca7f0 -> NG`; `7119e48819d8 -> NG`; `62c4de81f4a6 -> NG`; `2524fbd4eb09 -> DISPATCH-01`; `af8a7cdd0523 -> NG`; `e22e8a0915e7 -> NG`; `2a63da6e3a96 -> NG`; `30762d53b043 -> NG` |
259
+ | `oat-dispatch-subagents/references/record-schema.md` | `78f8069274a8 -> NG`; `1c9a84c4d1e0 -> NG`; `2a63da6e3a96 -> NG`; `30762d53b043 -> NG` |
260
260
  | `oat-project-dispatch-subagents/SKILL.md` | `eca03ad1ca12 -> PDISPATCH-01`; `59fbcdc79cea -> PDISPATCH-01` |
261
261
  | `oat-project-plan/SKILL.md` | `f99e44b39932 -> PLAN-12`; `7e6a9854504b -> NG` |
262
262
  | `oat-project-implement/references/completion-and-closeout.md` | `6909a5a5a1fa -> IMPLEMENT-19`; `a7c02ef670fd -> IMPLEMENT-19`; `9dde56d89a71 -> IMPLEMENT-16`; `13c41b2b2590 -> IMPLEMENT-16` |
package/assets/skills/oat-project-pr-final/references/docs/autonomy-contract.md CHANGED
@@ -252,11 +252,11 @@ remains immutable baseline evidence for the original p01-t01 verification.
252
252
  | `oat-project-implement/references/phase-execution.md` | `b31a9a4e6f75 -> NG` |
253
253
  | `oat-dispatch-subagents/SKILL.md` | `49987359dc09 -> NG` |
254
254
  | `oat-dispatch-subagents/references/provider-claude.md` | `06f64bd01ba6 -> NG` |
255
- | `oat-dispatch-subagents/SKILL.md` | `cb4f86157fd6 -> DISPATCH-01`; `f165b1626192 -> DISPATCH-01`; `7ed5e2b1eb71 -> PDISPATCH-01`; `11c72bcdebad -> DISPATCH-02`; `0834ee701e12 -> DISPATCH-02`; `7fda54e1d519 -> PDISPATCH-01`; `061f76074399 -> NG`; `5ae9e0e4ac47 -> NG`; `a2664ca9acf1 -> DISPATCH-01`; `12793022a2a4 -> DISPATCH-01`; `4a31444d4369 -> NG`; `68abaecc3e94 -> NG`; `7053910e10ef -> NG`; `a25ba09f5945 -> DISPATCH-01`; `9cdb9a679938 -> NG`; `2bc7c4717fd3 -> NG`; `0c7341966904 -> NG`; `e17d0f753630 -> NG`; `9fb0dd804b14 -> NG`; `2bab3a57a985 -> DISPATCH-01`; `63bdef0459e0 -> NG`; `e1936c17fece -> NG`; `e8e18fc1154a -> NG` |
255
+ | `oat-dispatch-subagents/SKILL.md` | `cb4f86157fd6 -> DISPATCH-01`; `f165b1626192 -> DISPATCH-01`; `7ed5e2b1eb71 -> PDISPATCH-01`; `11c72bcdebad -> DISPATCH-02`; `0834ee701e12 -> DISPATCH-02`; `7fda54e1d519 -> PDISPATCH-01` |
256
256
  | `oat-dispatch-subagents/references/provider-claude.md` | `fbe3a21e9533 -> NG` |
257
257
  | `oat-dispatch-subagents/references/provider-codex.md` | `95b0f82018c7 -> NG` |
258
258
  | `oat-dispatch-subagents/references/provider-cursor.md` | `f781555295a9 -> NG`; `55ccfef14fd6 -> NG` |
259
- | `oat-dispatch-subagents/references/record-schema.md` | `78f8069274a8 -> NG`; `1c9a84c4d1e0 -> NG`; `12cdc1878e52 -> NG`; `af49d3dd297a -> NG`; `b6ec6e06e5b6 -> NG`; `a3a7ab0a05b4 -> NG`; `95820a0aced8 -> NG`; `273f5072954a -> NG`; `c6ab5ab1e06e -> NG`; `eb509ef89f26 -> NG`; `a014397a631c -> NG`; `d07c12e91bd8 -> NG`; `8fa5bb3f4105 -> NG`; `0ca0e55fce05 -> NG`; `f1cab0929f78 -> DISPATCH-01`; `25795e03a05a -> DISPATCH-01`; `c868f3b5ecc5 -> NG`; `f56113f1b003 -> NG`; `fca94abe381d -> DISPATCH-01`; `afc8d0aca7f0 -> NG`; `7119e48819d8 -> NG`; `62c4de81f4a6 -> NG`; `2524fbd4eb09 -> DISPATCH-01`; `af8a7cdd0523 -> NG`; `e22e8a0915e7 -> NG`; `2a63da6e3a96 -> NG`; `30762d53b043 -> NG` |
259
+ | `oat-dispatch-subagents/references/record-schema.md` | `78f8069274a8 -> NG`; `1c9a84c4d1e0 -> NG`; `2a63da6e3a96 -> NG`; `30762d53b043 -> NG` |
260
260
  | `oat-project-dispatch-subagents/SKILL.md` | `eca03ad1ca12 -> PDISPATCH-01`; `59fbcdc79cea -> PDISPATCH-01` |
261
261
  | `oat-project-plan/SKILL.md` | `f99e44b39932 -> PLAN-12`; `7e6a9854504b -> NG` |
262
262
  | `oat-project-implement/references/completion-and-closeout.md` | `6909a5a5a1fa -> IMPLEMENT-19`; `a7c02ef670fd -> IMPLEMENT-19`; `9dde56d89a71 -> IMPLEMENT-16`; `13c41b2b2590 -> IMPLEMENT-16` |
package/assets/skills/oat-project-quick-start/references/docs/autonomy-contract.md CHANGED
@@ -252,11 +252,11 @@ remains immutable baseline evidence for the original p01-t01 verification.
252
252
  | `oat-project-implement/references/phase-execution.md` | `b31a9a4e6f75 -> NG` |
253
253
  | `oat-dispatch-subagents/SKILL.md` | `49987359dc09 -> NG` |
254
254
  | `oat-dispatch-subagents/references/provider-claude.md` | `06f64bd01ba6 -> NG` |
255
- | `oat-dispatch-subagents/SKILL.md` | `cb4f86157fd6 -> DISPATCH-01`; `f165b1626192 -> DISPATCH-01`; `7ed5e2b1eb71 -> PDISPATCH-01`; `11c72bcdebad -> DISPATCH-02`; `0834ee701e12 -> DISPATCH-02`; `7fda54e1d519 -> PDISPATCH-01`; `061f76074399 -> NG`; `5ae9e0e4ac47 -> NG`; `a2664ca9acf1 -> DISPATCH-01`; `12793022a2a4 -> DISPATCH-01`; `4a31444d4369 -> NG`; `68abaecc3e94 -> NG`; `7053910e10ef -> NG`; `a25ba09f5945 -> DISPATCH-01`; `9cdb9a679938 -> NG`; `2bc7c4717fd3 -> NG`; `0c7341966904 -> NG`; `e17d0f753630 -> NG`; `9fb0dd804b14 -> NG`; `2bab3a57a985 -> DISPATCH-01`; `63bdef0459e0 -> NG`; `e1936c17fece -> NG`; `e8e18fc1154a -> NG` |
255
+ | `oat-dispatch-subagents/SKILL.md` | `cb4f86157fd6 -> DISPATCH-01`; `f165b1626192 -> DISPATCH-01`; `7ed5e2b1eb71 -> PDISPATCH-01`; `11c72bcdebad -> DISPATCH-02`; `0834ee701e12 -> DISPATCH-02`; `7fda54e1d519 -> PDISPATCH-01` |
256
256
  | `oat-dispatch-subagents/references/provider-claude.md` | `fbe3a21e9533 -> NG` |
257
257
  | `oat-dispatch-subagents/references/provider-codex.md` | `95b0f82018c7 -> NG` |
258
258
  | `oat-dispatch-subagents/references/provider-cursor.md` | `f781555295a9 -> NG`; `55ccfef14fd6 -> NG` |
259
- | `oat-dispatch-subagents/references/record-schema.md` | `78f8069274a8 -> NG`; `1c9a84c4d1e0 -> NG`; `12cdc1878e52 -> NG`; `af49d3dd297a -> NG`; `b6ec6e06e5b6 -> NG`; `a3a7ab0a05b4 -> NG`; `95820a0aced8 -> NG`; `273f5072954a -> NG`; `c6ab5ab1e06e -> NG`; `eb509ef89f26 -> NG`; `a014397a631c -> NG`; `d07c12e91bd8 -> NG`; `8fa5bb3f4105 -> NG`; `0ca0e55fce05 -> NG`; `f1cab0929f78 -> DISPATCH-01`; `25795e03a05a -> DISPATCH-01`; `c868f3b5ecc5 -> NG`; `f56113f1b003 -> NG`; `fca94abe381d -> DISPATCH-01`; `afc8d0aca7f0 -> NG`; `7119e48819d8 -> NG`; `62c4de81f4a6 -> NG`; `2524fbd4eb09 -> DISPATCH-01`; `af8a7cdd0523 -> NG`; `e22e8a0915e7 -> NG`; `2a63da6e3a96 -> NG`; `30762d53b043 -> NG` |
259
+ | `oat-dispatch-subagents/references/record-schema.md` | `78f8069274a8 -> NG`; `1c9a84c4d1e0 -> NG`; `2a63da6e3a96 -> NG`; `30762d53b043 -> NG` |
260
260
  | `oat-project-dispatch-subagents/SKILL.md` | `eca03ad1ca12 -> PDISPATCH-01`; `59fbcdc79cea -> PDISPATCH-01` |
261
261
  | `oat-project-plan/SKILL.md` | `f99e44b39932 -> PLAN-12`; `7e6a9854504b -> NG` |
262
262
  | `oat-project-implement/references/completion-and-closeout.md` | `6909a5a5a1fa -> IMPLEMENT-19`; `a7c02ef670fd -> IMPLEMENT-19`; `9dde56d89a71 -> IMPLEMENT-16`; `13c41b2b2590 -> IMPLEMENT-16` |
package/assets/skills/recon/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: recon
3
- version: 1.0.1
3
+ version: 1.1.0
4
4
  description: Use when a bounded investigation needs source-grounded evidence before analysis or implementation. Produces a validated evidence-packet directory through approved provider-neutral worker waves.
5
5
  argument-hint: '<question-or-target> [--profile quick|standard|thorough] [--scope description] [--context path] [--output directory] [--strict]'
6
6
  disable-model-invocation: true
@@ -54,6 +54,21 @@ Report these compact stage transitions:
54
54
 
55
55
  Do not print worker transcripts or raw dossier content.
56
56
 
57
+ When a run stops early or publishes a partial, label every failure with one of
58
+ these categories so a controller problem is never reported as a worker
59
+ problem:
60
+
61
+ - `worker`: an accepted lane failed, was cancelled, or wrote an invalid
62
+ artifact;
63
+ - `provider/dispatch`: the launch surface could not satisfy the approved
64
+ envelope, or a launched axis drifted from approval;
65
+ - `contract validation`: artifacts were produced but the packet or a
66
+ candidate failed deterministic validation;
67
+ - `source availability`: a declared source was unavailable, stale, or lacked
68
+ a read-only boundary.
69
+
70
+ State whether every accepted lane reached a terminal result.
71
+
57
72
  ## Workflow
58
73
 
59
74
  ### Step 1: Complete the Request
@@ -123,58 +138,81 @@ intended scope: `oat tools install utility --scope <user|project>` or, when the
123
138
  pack is already installed, `oat tools update --pack utility --scope
124
139
  <user|project>`.
125
140
 
126
- Read `${UTILITY_SKILLS_ROOT}/oat-dispatch-subagents/SKILL.md` and use its
127
- selection-only `prepare` operation. From the same root, read
141
+ Read `${UTILITY_SKILLS_ROOT}/oat-dispatch-subagents/SKILL.md` and perform
142
+ only the selection steps of its Full-Information Selection: observe the
143
+ catalog, resolve one exact target, and record the selection. Stop before its
144
+ launch step; nothing launches until Step 5 runs after approval. From the same
145
+ root, read
128
146
  `subagent-orchestration/references/model-selection-principles.md`, exactly one
129
147
  active-provider selection reference, and the matching
130
148
  `oat-dispatch-subagents` provider mechanics reference. Do not copy provider
131
149
  catalogs or exact launch construction into this skill.
132
150
 
133
- Prepare every planned and conditional wave against one exact target satisfying
151
+ Resolve every planned and conditional wave against one exact target satisfying
134
152
  the run-wide floor. Prefer the canonical `recon-worker` role. If that role is
135
- unavailable, prepare the generic role with the complete worker contract as a
153
+ unavailable, plan the generic role with the complete worker contract as a
136
154
  visible generic role fallback before approval. A fallback after approval is
137
155
  forbidden.
138
156
 
139
- Assemble the exact approval envelope from the prepared records. It must bind:
140
-
141
- - provider, route, role selector, model, effort, reasoning mode, and service
142
- tier;
143
- - profile, wave classes and floors, lane identities, lane scopes, conditional
144
- lane caps, and concurrency;
145
- - per-lane authority, writable path, deadlines, and retry limits; and
146
- - live catalog observation identity and canonical approval fingerprint.
157
+ Write the approval envelope into `manifest.execution`. It binds:
147
158
 
148
- Present the exact provider, model and effort for explicit approval before any
149
- worker launch. Also present the full topology and hard execution limits. Named
150
- model examples are illustrative and non-normative; never route from an example.
151
- Declining approval leaves the run at `awaiting-approval` and launches nothing.
152
-
153
- ### Step 5: Execute the Approved Waves
159
+ - provider, route, role, model, effort, reasoning mode, and service tier;
160
+ - authority level, maximum concurrency, per-lane deadline, and retry limit; and
161
+ - every wave with its mode, task class, and conditional flag, and every lane
162
+ with its identity, read scope, and worker-owned write root.
154
163
 
155
- Submit only the approval-bound prepared records to the dispatch dependency's
156
- `execute` operation. Before each launch, compare every approved selection and
157
- execution axis plus relevant catalog identity. Any drift returns the complete
158
- manifest for renewed approval.
164
+ Its canonical fingerprint covers every field above.
159
165
 
160
- Store immutable prepared, approval, launch-acceptance, and terminal receipts
161
- under `raw/dispatch/`. Launch acceptance is distinct from worker completion.
162
- After acceptance there is no replacement child, alternate route, target
163
- substitution, or no silent retry. Continue the accepted handle only when the
164
- dispatch contract authorizes continuation; otherwise record the pass failure.
165
-
166
- Run the stages in this order:
166
+ Present the exact provider, model and effort for explicit approval before any
167
+ worker launch, together with the full topology and hard execution limits. Named model examples are
168
+ illustrative and non-normative; never route from an example. Declining approval
169
+ leaves the run at `awaiting-approval` and launches nothing. Approval records
170
+ `explicit-user-approval`, the approval time, and the fingerprint.
171
+
172
+ **Deadlines.** Choose the per-lane deadline from the expected task class and
173
+ scope, and show it in the approval envelope; it is an approved execution limit,
174
+ not a short watchdog. A deadline authorizes the provider to end a lane and
175
+ report a terminal timeout. It never authorizes the controller to interrupt an
176
+ accepted lane by hand: elapsed display time is not a failure. If the provider
177
+ cannot enforce the deadline, wait or poll and report elapsed time, or obtain
178
+ renewed approval before any cancellation.
179
+
180
+ ### Step 5: Preflight the Launch Surface, Then Execute
181
+
182
+ Before any worker launch, confirm that the live launch surface can run the
183
+ approved role, model, effort, and authority level, and can return each lane's
184
+ result. If any approved axis cannot be satisfied, stop with a
185
+ `provider/dispatch` diagnostic, leave the run at `awaiting-approval`, and
186
+ launch nothing. Never substitute a different axis to make the launch fit.
187
+
188
+ Launch each wave through the dispatch dependency with exactly the approved
189
+ axes. Immediately before each launch, compare the axes that will actually run
190
+ against the approval fingerprint. Any drift returns the complete manifest for
191
+ renewed approval. Launch acceptance is distinct from worker completion. After
192
+ acceptance there is no replacement child, alternate route, target
193
+ substitution, or no silent retry. If an accepted lane fails, is cancelled, or
194
+ times out, record that pass as failed with a material `PASS_FAILED` gap
195
+ naming the pass.
196
+
197
+ Run the passes in this order:
167
198
 
168
199
  1. `map` and `gather` workers write unique dossiers under `raw/dossiers/`.
169
200
  2. `compile` writes a candidate canonical claim ledger.
170
- 3. deterministic validation reopens sources and validates locators.
201
+ 3. Source preflight: run `scripts/validate-artifact.mjs` on the candidate
202
+ manifest and ledger, then reopen every declared source and evidence locator
203
+ with the checks in `scripts/validate-packet.mjs`. Resolve source roots to
204
+ canonical realpaths, pin one observation time per source, capture URLs or
205
+ mark them unavailable, and add a material gap for every ineligible source
206
+ and each affected claim. Do not create review briefs until the candidate
207
+ manifest and ledger pair validates.
171
208
  4. profile-required `verify`, `adversary`, and `coverage` workers consume only
172
209
  immutable selectively blind briefs created by
173
210
  `scripts/create-review-brief.mjs` at unique paths.
174
211
  5. `reconcile` writes a new candidate ledger without mutating the prior ledger.
175
212
 
176
213
  Use `references/worker-contract.md` for every assignment. Never allow two
177
- workers to share a write path.
214
+ workers to share a write path. Every dossier records its approved wave and lane;
215
+ every review result records its approved lane.
178
216
 
179
217
  Read `references/packet-contract.md` before creating any packet artifact. Run
180
218
  `scripts/validate-artifact.mjs` on each candidate and record its canonical
@@ -205,9 +243,9 @@ candidate failure separately. Only a publishable candidate proceeds to
205
243
  `scripts/render-packet.mjs`; failure leaves no consumer entry point that could
206
244
  refer to a different canonical generation.
207
245
 
208
- Derive the achieved profile from completed stages whose required typed,
209
- digest-bound artifacts validate. Do not accept a worker or manifest assertion
210
- of achievement. A `quick` run can reach `supported` but never `verified`.
246
+ Derive the achieved profile from complete, typed, digest-bound same-run
247
+ artifacts written by approved lanes. Do not accept a worker or manifest
248
+ assertion of achievement. A `quick` run can reach `supported` but never `verified`.
211
249
  `verified` claims require unique complete semantic, adversarial, and coverage
212
250
  results bound to immutable briefs and correct claim dispositions. Unresolved
213
251
  material challenge prevents verification. A run with contested claims may
@@ -231,9 +269,9 @@ diagnostics, and safe failure record for diagnosis.
231
269
  ### Step 8: Return the Directory-Only Handoff
232
270
 
233
271
  Return only the packet directory path plus a compact summary containing status,
234
- requested and achieved profile, claim-state counts, unresolved gaps, and failed
235
- or omitted passes. Do not inline raw dossiers, source bodies, or worker
236
- reasoning. The consumer may open `packet.md` and selectively follow compact
272
+ requested and achieved profile, claim-state counts, unresolved gaps, failed or
273
+ omitted passes, and each failure's category from the list above. Do not inline
274
+ raw dossiers, source bodies, or worker reasoning. The consumer may open `packet.md` and selectively follow compact
237
275
  references.
238
276
 
239
277
  ## Examples