okstra 0.174.0 → 0.175.1

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 (374) hide show
  1. package/README.md +18 -9
  2. package/bin/okstra +8 -4
  3. package/dist/cli-registry.d.mts +16 -0
  4. package/dist/cli-registry.mjs +560 -0
  5. package/dist/cli-registry.mjs.map +1 -0
  6. package/dist/commands/execute/agent-prompt.d.mts +1 -0
  7. package/{src → dist}/commands/execute/agent-prompt.mjs +10 -11
  8. package/dist/commands/execute/agent-prompt.mjs.map +1 -0
  9. package/dist/commands/execute/codex-dispatch.d.mts +3 -0
  10. package/dist/commands/execute/codex-dispatch.mjs +6 -0
  11. package/dist/commands/execute/codex-dispatch.mjs.map +1 -0
  12. package/dist/commands/execute/codex-run.d.mts +3 -0
  13. package/{src → dist}/commands/execute/codex-run.mjs +30 -37
  14. package/dist/commands/execute/codex-run.mjs.map +1 -0
  15. package/dist/commands/execute/convergence.d.mts +1 -0
  16. package/{src → dist}/commands/execute/convergence.mjs +15 -16
  17. package/dist/commands/execute/convergence.mjs.map +1 -0
  18. package/dist/commands/execute/error-log.d.mts +1 -0
  19. package/{src → dist}/commands/execute/error-log.mjs +2 -3
  20. package/dist/commands/execute/error-log.mjs.map +1 -0
  21. package/dist/commands/execute/git-reconcile.d.mts +1 -0
  22. package/{src → dist}/commands/execute/git-reconcile.mjs +10 -11
  23. package/dist/commands/execute/git-reconcile.mjs.map +1 -0
  24. package/dist/commands/execute/handoff.d.mts +1 -0
  25. package/{src → dist}/commands/execute/handoff.mjs +10 -11
  26. package/dist/commands/execute/handoff.mjs.map +1 -0
  27. package/dist/commands/execute/incremental-carry.d.mts +1 -0
  28. package/{src → dist}/commands/execute/incremental-carry.mjs +2 -3
  29. package/dist/commands/execute/incremental-carry.mjs.map +1 -0
  30. package/dist/commands/execute/incremental-scope.d.mts +1 -0
  31. package/{src → dist}/commands/execute/incremental-scope.mjs +2 -3
  32. package/dist/commands/execute/incremental-scope.mjs.map +1 -0
  33. package/dist/commands/execute/integrate-stages.d.mts +1 -0
  34. package/{src → dist}/commands/execute/integrate-stages.mjs +10 -11
  35. package/dist/commands/execute/integrate-stages.mjs.map +1 -0
  36. package/dist/commands/execute/pane-title.d.mts +1 -0
  37. package/dist/commands/execute/pane-title.mjs +20 -0
  38. package/dist/commands/execute/pane-title.mjs.map +1 -0
  39. package/dist/commands/execute/plan-items.d.mts +1 -0
  40. package/dist/commands/execute/plan-items.mjs +9 -0
  41. package/dist/commands/execute/plan-items.mjs.map +1 -0
  42. package/dist/commands/execute/plan-validate.d.mts +1 -0
  43. package/dist/commands/execute/plan-validate.mjs +68 -0
  44. package/dist/commands/execute/plan-validate.mjs.map +1 -0
  45. package/dist/commands/execute/plan-verify.d.mts +1 -0
  46. package/{src → dist}/commands/execute/plan-verify.mjs +13 -16
  47. package/dist/commands/execute/plan-verify.mjs.map +1 -0
  48. package/dist/commands/execute/render-bundle.d.mts +3 -0
  49. package/{src → dist}/commands/execute/render-bundle.mjs +65 -61
  50. package/dist/commands/execute/render-bundle.mjs.map +1 -0
  51. package/dist/commands/execute/run.d.mts +24 -0
  52. package/dist/commands/execute/run.mjs +196 -0
  53. package/dist/commands/execute/run.mjs.map +1 -0
  54. package/dist/commands/execute/spawn-followups.d.mts +1 -0
  55. package/{src → dist}/commands/execute/spawn-followups.mjs +6 -7
  56. package/dist/commands/execute/spawn-followups.mjs.map +1 -0
  57. package/dist/commands/execute/team.d.mts +3 -0
  58. package/{src → dist}/commands/execute/team.mjs +29 -36
  59. package/dist/commands/execute/team.mjs.map +1 -0
  60. package/dist/commands/execute/token-usage.d.mts +1 -0
  61. package/{src → dist}/commands/execute/token-usage.mjs +2 -3
  62. package/dist/commands/execute/token-usage.mjs.map +1 -0
  63. package/dist/commands/execute/wizard.d.mts +8 -0
  64. package/dist/commands/execute/wizard.mjs +191 -0
  65. package/dist/commands/execute/wizard.mjs.map +1 -0
  66. package/dist/commands/execute/worker-audit-check.d.mts +1 -0
  67. package/{src → dist}/commands/execute/worker-audit-check.mjs +11 -12
  68. package/dist/commands/execute/worker-audit-check.mjs.map +1 -0
  69. package/dist/commands/execute/worker-dispatch.d.mts +7 -0
  70. package/{src → dist}/commands/execute/worker-dispatch.mjs +34 -46
  71. package/dist/commands/execute/worker-dispatch.mjs.map +1 -0
  72. package/dist/commands/execute/worker-state.d.mts +1 -0
  73. package/{src → dist}/commands/execute/worker-state.mjs +15 -16
  74. package/dist/commands/execute/worker-state.mjs.map +1 -0
  75. package/dist/commands/execute/worktree-lookup.d.mts +1 -0
  76. package/{src → dist}/commands/execute/worktree-lookup.mjs +38 -37
  77. package/dist/commands/execute/worktree-lookup.mjs.map +1 -0
  78. package/dist/commands/execute/worktree-status.d.mts +1 -0
  79. package/{src → dist}/commands/execute/worktree-status.mjs +52 -46
  80. package/dist/commands/execute/worktree-status.mjs.map +1 -0
  81. package/dist/commands/inspect/code-review.d.mts +1 -0
  82. package/{src → dist}/commands/inspect/code-review.mjs +16 -19
  83. package/dist/commands/inspect/code-review.mjs.map +1 -0
  84. package/dist/commands/inspect/container.d.mts +1 -0
  85. package/{src → dist}/commands/inspect/container.mjs +11 -13
  86. package/dist/commands/inspect/container.mjs.map +1 -0
  87. package/dist/commands/inspect/context-cost.d.mts +1 -0
  88. package/{src → dist}/commands/inspect/context-cost.mjs +11 -13
  89. package/dist/commands/inspect/context-cost.mjs.map +1 -0
  90. package/dist/commands/inspect/design-prep.d.mts +1 -0
  91. package/{src → dist}/commands/inspect/design-prep.mjs +10 -11
  92. package/dist/commands/inspect/design-prep.mjs.map +1 -0
  93. package/dist/commands/inspect/error-report.d.mts +1 -0
  94. package/{src → dist}/commands/inspect/error-report.mjs +11 -13
  95. package/dist/commands/inspect/error-report.mjs.map +1 -0
  96. package/dist/commands/inspect/error-zip.d.mts +1 -0
  97. package/{src → dist}/commands/inspect/error-zip.mjs +11 -12
  98. package/dist/commands/inspect/error-zip.mjs.map +1 -0
  99. package/dist/commands/inspect/log-report.d.mts +1 -0
  100. package/{src → dist}/commands/inspect/log-report.mjs +11 -13
  101. package/dist/commands/inspect/log-report.mjs.map +1 -0
  102. package/dist/commands/inspect/profile-show.d.mts +1 -0
  103. package/{src → dist}/commands/inspect/profile-show.mjs +10 -11
  104. package/dist/commands/inspect/profile-show.mjs.map +1 -0
  105. package/dist/commands/inspect/recap.d.mts +1 -0
  106. package/{src → dist}/commands/inspect/recap.mjs +11 -13
  107. package/dist/commands/inspect/recap.mjs.map +1 -0
  108. package/dist/commands/inspect/resolve-task-key.d.mts +1 -0
  109. package/{src → dist}/commands/inspect/resolve-task-key.mjs +11 -13
  110. package/dist/commands/inspect/resolve-task-key.mjs.map +1 -0
  111. package/dist/commands/inspect/rollup.d.mts +1 -0
  112. package/{src → dist}/commands/inspect/rollup.mjs +11 -13
  113. package/dist/commands/inspect/rollup.mjs.map +1 -0
  114. package/dist/commands/inspect/run-audit.d.mts +1 -0
  115. package/{src → dist}/commands/inspect/run-audit.mjs +11 -12
  116. package/dist/commands/inspect/run-audit.mjs.map +1 -0
  117. package/dist/commands/inspect/set-work-status.d.mts +1 -0
  118. package/{src → dist}/commands/inspect/set-work-status.mjs +11 -13
  119. package/dist/commands/inspect/set-work-status.mjs.map +1 -0
  120. package/dist/commands/inspect/stage-map.d.mts +1 -0
  121. package/dist/commands/inspect/stage-map.mjs +110 -0
  122. package/dist/commands/inspect/stage-map.mjs.map +1 -0
  123. package/dist/commands/inspect/task-list.d.mts +1 -0
  124. package/dist/commands/inspect/task-list.mjs +103 -0
  125. package/dist/commands/inspect/task-list.mjs.map +1 -0
  126. package/dist/commands/inspect/task-show.d.mts +1 -0
  127. package/dist/commands/inspect/task-show.mjs +108 -0
  128. package/dist/commands/inspect/task-show.mjs.map +1 -0
  129. package/dist/commands/inspect/time-report.d.mts +1 -0
  130. package/{src → dist}/commands/inspect/time-report.mjs +11 -13
  131. package/dist/commands/inspect/time-report.mjs.map +1 -0
  132. package/dist/commands/inspect/usage-report.d.mts +1 -0
  133. package/{src → dist}/commands/inspect/usage-report.mjs +11 -13
  134. package/dist/commands/inspect/usage-report.mjs.map +1 -0
  135. package/dist/commands/inspect/user-response.d.mts +1 -0
  136. package/{src → dist}/commands/inspect/user-response.mjs +10 -11
  137. package/dist/commands/inspect/user-response.mjs.map +1 -0
  138. package/dist/commands/inspect/worker-liveness.d.mts +1 -0
  139. package/{src → dist}/commands/inspect/worker-liveness.mjs +11 -13
  140. package/dist/commands/inspect/worker-liveness.mjs.map +1 -0
  141. package/dist/commands/lifecycle/check-project.d.mts +21 -0
  142. package/dist/commands/lifecycle/check-project.mjs +175 -0
  143. package/dist/commands/lifecycle/check-project.mjs.map +1 -0
  144. package/dist/commands/lifecycle/config.d.mts +1 -0
  145. package/dist/commands/lifecycle/config.mjs +369 -0
  146. package/dist/commands/lifecycle/config.mjs.map +1 -0
  147. package/dist/commands/lifecycle/doctor.d.mts +10 -0
  148. package/dist/commands/lifecycle/doctor.mjs +317 -0
  149. package/dist/commands/lifecycle/doctor.mjs.map +1 -0
  150. package/dist/commands/lifecycle/install.d.mts +17 -0
  151. package/dist/commands/lifecycle/install.mjs +1077 -0
  152. package/dist/commands/lifecycle/install.mjs.map +1 -0
  153. package/dist/commands/lifecycle/migrate.d.mts +1 -0
  154. package/{src → dist}/commands/lifecycle/migrate.mjs +10 -11
  155. package/dist/commands/lifecycle/migrate.mjs.map +1 -0
  156. package/dist/commands/lifecycle/model.d.mts +1 -0
  157. package/dist/commands/lifecycle/model.mjs +22 -0
  158. package/dist/commands/lifecycle/model.mjs.map +1 -0
  159. package/dist/commands/lifecycle/paths.d.mts +1 -0
  160. package/dist/commands/lifecycle/paths.mjs +102 -0
  161. package/dist/commands/lifecycle/paths.mjs.map +1 -0
  162. package/dist/commands/lifecycle/preflight.d.mts +1 -0
  163. package/dist/commands/lifecycle/preflight.mjs +124 -0
  164. package/dist/commands/lifecycle/preflight.mjs.map +1 -0
  165. package/dist/commands/lifecycle/setup.d.mts +1 -0
  166. package/dist/commands/lifecycle/setup.mjs +297 -0
  167. package/dist/commands/lifecycle/setup.mjs.map +1 -0
  168. package/dist/commands/lifecycle/uninstall.d.mts +4 -0
  169. package/dist/commands/lifecycle/uninstall.mjs +262 -0
  170. package/dist/commands/lifecycle/uninstall.mjs.map +1 -0
  171. package/dist/commands/manager.d.mts +3 -0
  172. package/{src → dist}/commands/manager.mjs +25 -32
  173. package/dist/commands/manager.mjs.map +1 -0
  174. package/dist/commands/memory/memory.d.mts +1 -0
  175. package/dist/commands/memory/memory.mjs +569 -0
  176. package/dist/commands/memory/memory.mjs.map +1 -0
  177. package/dist/commands/pr/pr.d.mts +33 -0
  178. package/dist/commands/pr/pr.mjs +296 -0
  179. package/dist/commands/pr/pr.mjs.map +1 -0
  180. package/dist/commands/report/agent-activity.d.mts +1 -0
  181. package/{src → dist}/commands/report/agent-activity.mjs +11 -12
  182. package/dist/commands/report/agent-activity.mjs.map +1 -0
  183. package/dist/commands/report/finalize.d.mts +4 -0
  184. package/{src → dist}/commands/report/finalize.mjs +25 -32
  185. package/dist/commands/report/finalize.mjs.map +1 -0
  186. package/dist/commands/report/inject-report-index.d.mts +1 -0
  187. package/{src → dist}/commands/report/inject-report-index.mjs +6 -7
  188. package/dist/commands/report/inject-report-index.mjs.map +1 -0
  189. package/dist/commands/report/render-final-report.d.mts +1 -0
  190. package/{src → dist}/commands/report/render-final-report.mjs +6 -7
  191. package/dist/commands/report/render-final-report.mjs.map +1 -0
  192. package/dist/commands/report/render-views.d.mts +1 -0
  193. package/{src → dist}/commands/report/render-views.mjs +6 -7
  194. package/dist/commands/report/render-views.mjs.map +1 -0
  195. package/dist/commands/report/translate.d.mts +1 -0
  196. package/{src → dist}/commands/report/translate.mjs +6 -7
  197. package/dist/commands/report/translate.mjs.map +1 -0
  198. package/dist/lib/helper-scripts.d.mts +3 -0
  199. package/{src → dist}/lib/helper-scripts.mjs +11 -14
  200. package/dist/lib/helper-scripts.mjs.map +1 -0
  201. package/dist/lib/host-registry-client.d.mts +25 -0
  202. package/dist/lib/host-registry-client.mjs +152 -0
  203. package/dist/lib/host-registry-client.mjs.map +1 -0
  204. package/dist/lib/install-assets.d.mts +8 -0
  205. package/{src → dist}/lib/install-assets.mjs +17 -20
  206. package/dist/lib/install-assets.mjs.map +1 -0
  207. package/dist/lib/okstra-dirs.d.mts +4 -0
  208. package/{src → dist}/lib/okstra-dirs.mjs +3 -6
  209. package/dist/lib/okstra-dirs.mjs.map +1 -0
  210. package/dist/lib/paths.d.mts +4 -0
  211. package/dist/lib/paths.mjs +78 -0
  212. package/dist/lib/paths.mjs.map +1 -0
  213. package/dist/lib/proc.d.mts +3 -0
  214. package/dist/lib/proc.mjs +31 -0
  215. package/dist/lib/proc.mjs.map +1 -0
  216. package/dist/lib/python-helper.d.mts +8 -0
  217. package/dist/lib/python-helper.mjs +123 -0
  218. package/dist/lib/python-helper.mjs.map +1 -0
  219. package/dist/lib/runtime-manifest.d.mts +7 -0
  220. package/dist/lib/runtime-manifest.mjs +73 -0
  221. package/dist/lib/runtime-manifest.mjs.map +1 -0
  222. package/dist/lib/skill-catalog.d.mts +4 -0
  223. package/dist/lib/skill-catalog.mjs +50 -0
  224. package/dist/lib/skill-catalog.mjs.map +1 -0
  225. package/dist/lib/types.d.mts +129 -0
  226. package/dist/lib/types.mjs +2 -0
  227. package/dist/lib/types.mjs.map +1 -0
  228. package/dist/lib/version.d.mts +2 -0
  229. package/dist/lib/version.mjs +27 -0
  230. package/dist/lib/version.mjs.map +1 -0
  231. package/docs/architecture/storage-model.md +4 -0
  232. package/docs/architecture.md +7 -1
  233. package/docs/cli.md +26 -6
  234. package/docs/contributor-change-matrix.md +2 -2
  235. package/docs/project-structure-overview.md +16 -7
  236. package/docs/task-process/README.md +2 -0
  237. package/docs/task-process/implementation-planning.md +1 -1
  238. package/docs/task-process/implementation.md +1 -1
  239. package/package.json +11 -5
  240. package/runtime/BUILD.json +2 -2
  241. package/runtime/agents/workers/claude-worker.md +2 -1
  242. package/runtime/agents/workers/report-writer-worker.md +3 -1
  243. package/runtime/agents/workers/translator-worker.md +3 -1
  244. package/runtime/bin/lib/okstra/cli.sh +12 -0
  245. package/runtime/bin/lib/okstra/globals.sh +3 -0
  246. package/runtime/bin/lib/okstra/usage.sh +4 -4
  247. package/runtime/bin/okstra-error-log.py +27 -0
  248. package/runtime/bin/okstra-provider-exec.py +217 -5
  249. package/runtime/bin/okstra.sh +10 -0
  250. package/runtime/prompts/lead/convergence.md +27 -18
  251. package/runtime/prompts/lead/okstra-lead-contract.md +3 -1
  252. package/runtime/prompts/lead/plan-body-verification.md +10 -3
  253. package/runtime/prompts/lead/team-contract.md +1 -1
  254. package/runtime/prompts/profiles/change-impact-analysis.md +16 -0
  255. package/runtime/prompts/profiles/error-analysis.md +20 -0
  256. package/runtime/prompts/profiles/feature-analysis.md +16 -0
  257. package/runtime/prompts/profiles/final-verification.md +16 -0
  258. package/runtime/prompts/profiles/implementation-option-selection.md +16 -0
  259. package/runtime/prompts/profiles/implementation-planning.md +20 -0
  260. package/runtime/prompts/profiles/implementation.md +15 -0
  261. package/runtime/prompts/profiles/improvement-discovery.md +16 -0
  262. package/runtime/prompts/profiles/project-analysis.md +16 -0
  263. package/runtime/prompts/profiles/release-handoff.md +4 -0
  264. package/runtime/prompts/profiles/requirements-discovery.md +20 -0
  265. package/runtime/prompts/wizard/prompts.ko.json +18 -0
  266. package/runtime/python/okstra_ctl/adapters/dispatch/cli_wrapper.py +8 -0
  267. package/runtime/python/okstra_ctl/adapters/dispatch/cmux.py +8 -0
  268. package/runtime/python/okstra_ctl/adapters/dispatch/native_team.py +13 -0
  269. package/runtime/python/okstra_ctl/adapters/hosts/antigravity/adapter.py +2 -2
  270. package/runtime/python/okstra_ctl/adapters/hosts/claude-code/adapter.py +25 -5
  271. package/runtime/python/okstra_ctl/adapters/hosts/codex/adapter.py +2 -2
  272. package/runtime/python/okstra_ctl/adapters/hosts/external/adapter.py +4 -1
  273. package/runtime/python/okstra_ctl/adapters/hosts/grok/adapter.py +2 -2
  274. package/runtime/python/okstra_ctl/adapters/hosts/kimi/adapter.py +2 -2
  275. package/runtime/python/okstra_ctl/adapters/providers/antigravity/adapter.py +79 -11
  276. package/runtime/python/okstra_ctl/adapters/providers/claude/adapter.py +95 -25
  277. package/runtime/python/okstra_ctl/adapters/providers/codex/adapter.py +59 -14
  278. package/runtime/python/okstra_ctl/adapters/providers/grok/adapter.py +55 -9
  279. package/runtime/python/okstra_ctl/adapters/providers/kimi/adapter.py +51 -12
  280. package/runtime/python/okstra_ctl/agent_activity.py +5 -1
  281. package/runtime/python/okstra_ctl/agent_invocation.py +608 -14
  282. package/runtime/python/okstra_ctl/agent_prompt_cli.py +249 -50
  283. package/runtime/python/okstra_ctl/application/resolve_assignment.py +53 -12
  284. package/runtime/python/okstra_ctl/assignment_environment.py +102 -0
  285. package/runtime/python/okstra_ctl/assignment_resolver.py +790 -0
  286. package/runtime/python/okstra_ctl/attempt_evidence.py +342 -0
  287. package/runtime/python/okstra_ctl/convergence.py +409 -3
  288. package/runtime/python/okstra_ctl/convergence_engine.py +248 -15
  289. package/runtime/python/okstra_ctl/convergence_store.py +170 -1
  290. package/runtime/python/okstra_ctl/dispatch_core.py +1092 -63
  291. package/runtime/python/okstra_ctl/dispatch_state.py +696 -11
  292. package/runtime/python/okstra_ctl/doctor.py +14 -0
  293. package/runtime/python/okstra_ctl/domain/host.py +32 -1
  294. package/runtime/python/okstra_ctl/domain/provider.py +212 -6
  295. package/runtime/python/okstra_ctl/domain/role.py +125 -0
  296. package/runtime/python/okstra_ctl/domain/wizard/interaction.py +13 -0
  297. package/runtime/python/okstra_ctl/domain/worker_exec.py +34 -1
  298. package/runtime/python/okstra_ctl/domain/worker_role.py +13 -3
  299. package/runtime/python/okstra_ctl/domain/worker_stream.py +24 -0
  300. package/runtime/python/okstra_ctl/error_log_write.py +9 -0
  301. package/runtime/python/okstra_ctl/error_report.py +21 -1
  302. package/runtime/python/okstra_ctl/execution_identity.py +529 -0
  303. package/runtime/python/okstra_ctl/execution_manifest.py +1281 -0
  304. package/runtime/python/okstra_ctl/execution_mutation_audit.py +619 -0
  305. package/runtime/python/okstra_ctl/index.py +6 -2
  306. package/runtime/python/okstra_ctl/initial_prompt_materialization.py +43 -3
  307. package/runtime/python/okstra_ctl/legacy_model_selection.py +490 -0
  308. package/runtime/python/okstra_ctl/model_cli.py +278 -0
  309. package/runtime/python/okstra_ctl/model_defaults.py +46 -0
  310. package/runtime/python/okstra_ctl/model_discovery.py +26 -7
  311. package/runtime/python/okstra_ctl/model_pool.py +501 -0
  312. package/runtime/python/okstra_ctl/models.py +47 -27
  313. package/runtime/python/okstra_ctl/mutation_recovery.py +293 -0
  314. package/runtime/python/okstra_ctl/pane_title.py +151 -0
  315. package/runtime/python/okstra_ctl/ports/host_model.py +48 -17
  316. package/runtime/python/okstra_ctl/ports/worker_dispatch.py +4 -0
  317. package/runtime/python/okstra_ctl/registry/provider_registry.py +8 -4
  318. package/runtime/python/okstra_ctl/render.py +78 -10
  319. package/runtime/python/okstra_ctl/render_final_report.py +19 -0
  320. package/runtime/python/okstra_ctl/report_contract.py +39 -0
  321. package/runtime/python/okstra_ctl/report_finalize.py +16 -0
  322. package/runtime/python/okstra_ctl/report_html/render.py +1 -0
  323. package/runtime/python/okstra_ctl/role_requirements.py +217 -0
  324. package/runtime/python/okstra_ctl/run.py +1207 -258
  325. package/runtime/python/okstra_ctl/run_index_row.py +7 -1
  326. package/runtime/python/okstra_ctl/time_report.py +38 -4
  327. package/runtime/python/okstra_ctl/usage_identity.py +86 -0
  328. package/runtime/python/okstra_ctl/usage_report.py +15 -3
  329. package/runtime/python/okstra_ctl/wizard.py +1253 -62
  330. package/runtime/python/okstra_ctl/worker_audit_ledger.py +68 -65
  331. package/runtime/python/okstra_ctl/worker_request.py +7 -1
  332. package/runtime/python/okstra_ctl/worker_runner.py +130 -5
  333. package/runtime/python/okstra_ctl/workers.py +7 -5
  334. package/runtime/python/okstra_ctl/write_policy.py +571 -0
  335. package/runtime/schemas/convergence-groups-v2.0.schema.json +128 -0
  336. package/runtime/schemas/execution-manifest-v2.schema.json +340 -0
  337. package/runtime/schemas/final-report-v2.0.schema.json +25 -0
  338. package/runtime/skills/okstra-run/SKILL.md +9 -9
  339. package/runtime/templates/report-writer-prompt-preamble.md +2 -0
  340. package/runtime/templates/reports/final-report-v2.template.md +7 -1
  341. package/runtime/templates/reports/html/base.template.html +21 -0
  342. package/runtime/templates/reports/html/i18n/en.json +4 -0
  343. package/runtime/templates/reports/html/i18n/ko.json +4 -0
  344. package/runtime/templates/worker-prompt-preamble.md +6 -2
  345. package/runtime/validators/lib/fixtures.sh +49 -16
  346. package/runtime/validators/validate-run.py +429 -35
  347. package/runtime/validators/validate_session_conformance.py +25 -7
  348. package/src/cli-registry.mjs +0 -539
  349. package/src/commands/execute/codex-dispatch.mjs +0 -10
  350. package/src/commands/execute/plan-items.mjs +0 -9
  351. package/src/commands/execute/plan-validate.mjs +0 -68
  352. package/src/commands/execute/run.mjs +0 -208
  353. package/src/commands/execute/wizard.mjs +0 -167
  354. package/src/commands/inspect/stage-map.mjs +0 -98
  355. package/src/commands/inspect/task-list.mjs +0 -97
  356. package/src/commands/inspect/task-show.mjs +0 -100
  357. package/src/commands/lifecycle/check-project.mjs +0 -187
  358. package/src/commands/lifecycle/config.mjs +0 -385
  359. package/src/commands/lifecycle/doctor.mjs +0 -308
  360. package/src/commands/lifecycle/install.mjs +0 -1170
  361. package/src/commands/lifecycle/paths.mjs +0 -104
  362. package/src/commands/lifecycle/preflight.mjs +0 -125
  363. package/src/commands/lifecycle/setup.mjs +0 -333
  364. package/src/commands/lifecycle/uninstall.mjs +0 -279
  365. package/src/commands/memory/memory.mjs +0 -524
  366. package/src/commands/pr/pr.mjs +0 -261
  367. package/src/lib/host-registry-client.mjs +0 -176
  368. package/src/lib/paths.mjs +0 -86
  369. package/src/lib/proc.mjs +0 -31
  370. package/src/lib/python-helper.mjs +0 -142
  371. package/src/lib/runtime-manifest.mjs +0 -70
  372. package/src/lib/skill-catalog.mjs +0 -53
  373. package/src/lib/version.mjs +0 -20
  374. /package/{src → dist}/commands/pr/default.md +0 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "okstra",
3
- "version": "0.174.0",
3
+ "version": "0.175.1",
4
4
  "description": "Host-aware multi-provider cross-verification orchestrator runtime and agent skills.",
5
5
  "license": "MIT",
6
6
  "author": "devonshin",
@@ -14,7 +14,7 @@
14
14
  },
15
15
  "files": [
16
16
  "bin/",
17
- "src/",
17
+ "dist/",
18
18
  "runtime/",
19
19
  "docs/architecture.md",
20
20
  "docs/architecture/",
@@ -30,15 +30,21 @@
30
30
  "README.md"
31
31
  ],
32
32
  "engines": {
33
- "node": ">=18"
33
+ "node": ">=22"
34
34
  },
35
35
  "scripts": {
36
- "build": "node tools/build.mjs",
37
- "prepack": "node tools/build.mjs",
36
+ "build:ts": "tsc --project tsconfig.json",
37
+ "typecheck": "tsc --project tsconfig.json --noEmit",
38
+ "build": "npm run build:ts && node tools/build.mjs",
39
+ "prepack": "npm run build",
38
40
  "test:js": "node --test tests-js/*.test.mjs",
39
41
  "test:py": "python3 -m pytest tests/",
40
42
  "test:workflow": "bash validators/validate-workflow.sh",
41
43
  "test:e2e": "bash tests-e2e/run-all.sh",
42
44
  "check": "npm run build && npm run test:js && npm run test:py && npm run test:workflow && npm run test:e2e"
45
+ },
46
+ "devDependencies": {
47
+ "@types/node": "^26.2.0",
48
+ "typescript": "^7.0.2"
43
49
  }
44
50
  }
@@ -1,5 +1,5 @@
1
1
  {
2
- "package": "0.174.0",
3
- "builtAt": "2026-08-17T05:25:03.210Z",
2
+ "package": "0.175.1",
3
+ "builtAt": "2026-08-17T12:36:07.977Z",
4
4
  "repoRoot": "/home/runner/work/okstra/okstra"
5
5
  }
@@ -26,7 +26,8 @@ invocation. The final prompt's duty contract owns the role boundary,
26
26
  responsibility, and prohibited actions. This file owns Claude tool usage,
27
27
  artifact persistence, and liveness procedure only. Do not shell out to another
28
28
  model CLI, and refuse a dispatch whose prompt has no adjacent verified
29
- invocation metadata.
29
+ invocation metadata. Consume the stored `executionLabel`; do not infer a role
30
+ from the provider name. `lead` is a compatibility alias for `leader`.
30
31
 
31
32
  ## Execution Rules
32
33
 
@@ -18,7 +18,9 @@ This is the Claude host execution adapter for a materialized Okstra invocation.
18
18
  The final prompt's `report-writer` duty contract owns the role boundary,
19
19
  required responsibility, and prohibited actions. This file owns only how that
20
20
  contract is executed with Claude host tools. Refuse a dispatch whose prompt has
21
- no adjacent verified invocation metadata.
21
+ no adjacent verified invocation metadata. Consume the stored `executionLabel`.
22
+ The final-report `executionRoles[]` set must equal the execution-manifest
23
+ `roleExecutions[]` set.
22
24
 
23
25
  - The `**Report Language:**` header in your dispatch prompt is already
24
26
  resolved to `en` or `ko` by the lead. Copy it verbatim into
@@ -18,7 +18,9 @@ This is the Claude host execution adapter for a materialized Okstra invocation.
18
18
  The final prompt's `translator` duty contract owns the role boundary,
19
19
  responsibility, and prohibited actions. This file owns only the extraction,
20
20
  translation-sidecar, and verification tool procedure. Refuse a dispatch whose
21
- prompt has no adjacent verified invocation metadata.
21
+ prompt has no adjacent verified invocation metadata. Consume the stored
22
+ `executionLabel`; the translator role remains `translator` even without a team
23
+ roster.
22
24
 
23
25
  ## Procedure
24
26
 
@@ -67,6 +67,18 @@ while [[ $# -gt 0 ]]; do
67
67
  WORKERS_OVERRIDE="$(require_option_value --workers "${2-}")"
68
68
  shift 2
69
69
  ;;
70
+ --role-count)
71
+ ROLE_COUNTS+=("$(require_option_value --role-count "${2-}")")
72
+ shift 2
73
+ ;;
74
+ --role-model)
75
+ ROLE_MODELS+=("$(require_option_value --role-model "${2-}")")
76
+ shift 2
77
+ ;;
78
+ --host-session-context-json)
79
+ HOST_SESSION_CONTEXT_JSON="$(require_option_value --host-session-context-json "${2-}")"
80
+ shift 2
81
+ ;;
70
82
  --lead-model)
71
83
  LEAD_MODEL_OVERRIDE="$(require_option_value --lead-model "${2-}")"
72
84
  shift 2
@@ -19,6 +19,9 @@ RESUME_CLARIFICATION_MODE="false"
19
19
  RESUME_SESSION_MODE="false"
20
20
  RESUME_SESSION_ID=""
21
21
  WORKERS_OVERRIDE=""
22
+ ROLE_COUNTS=()
23
+ ROLE_MODELS=()
24
+ HOST_SESSION_CONTEXT_JSON=""
22
25
  LEAD_MODEL_OVERRIDE=""
23
26
  LEAD_PROVIDER_OVERRIDE=""
24
27
  CLAUDE_MODEL_OVERRIDE=""
@@ -104,8 +104,8 @@ options:
104
104
  --lead-runtime Registered host ID or alias. Default: claude-code. In-host runs
105
105
  use current-session; terminal launch uses spawn-process readiness.
106
106
  --executor Provider that performs the Executor role during --task-type=implementation.
107
- One of: claude | codex | antigravity. Default: OKSTRA_DEFAULT_EXECUTOR or claude.
108
- The Executor is the only worker allowed to mutate project files; the other two
107
+ One of: claude | codex | antigravity | grok | kimi. Default: OKSTRA_DEFAULT_EXECUTOR or claude.
108
+ The Executor is the only worker allowed to mutate project files; the other
109
109
  providers are dispatched as read-only verifiers regardless of this selection.
110
110
  Has no effect on other task types.
111
111
  --critic Provider for the opt-in Phase 5.6 critic pass (coverage gaps /
@@ -132,9 +132,9 @@ model defaults:
132
132
  Claude worker: OKSTRA_DEFAULT_CLAUDE_MODEL or opus
133
133
  Codex worker: OKSTRA_DEFAULT_CODEX_MODEL or gpt-5.6-sol
134
134
  Antigravity worker: OKSTRA_DEFAULT_ANTIGRAVITY_MODEL or gemini-3.1-pro
135
- Grok worker: grok-build-0.1 (analyser) or grok-4.5 (critic)
135
+ Grok worker: grok-4.6
136
136
  Kimi worker: kimi-k2.7-code (analyser) or kimi-k3 (critic)
137
- Implementation executor: OKSTRA_DEFAULT_EXECUTOR or claude (one of: claude | codex | antigravity)
137
+ Implementation executor: OKSTRA_DEFAULT_EXECUTOR or claude (one of: claude | codex | antigravity | grok | kimi)
138
138
 
139
139
  output:
140
140
  Stable task bundles are stored under:
@@ -72,6 +72,7 @@ def _build_parser():
72
72
  grp.add_argument("--stderr-excerpt-file", default=None)
73
73
  obs.add_argument("--context-json", default=None,
74
74
  help="JSON object string for context")
75
+ _add_identity_flags(obs)
75
76
 
76
77
  dump = sub.add_parser("append-from-worker",
77
78
  help="Dump worker sidecar errors[] into errors.jsonl")
@@ -81,9 +82,33 @@ def _build_parser():
81
82
  dump.add_argument("--agent", required=True, choices=sorted(ALLOWED_AGENTS))
82
83
  dump.add_argument("--agent-role", required=True, choices=sorted(ALLOWED_AGENT_ROLES))
83
84
  dump.add_argument("--model", required=True)
85
+ _add_identity_flags(dump)
84
86
  return p
85
87
 
86
88
 
89
+ def _add_identity_flags(parser):
90
+ parser.add_argument("--participant-ref", default="")
91
+ parser.add_argument("--role-execution-ref", default="")
92
+ parser.add_argument("--invocation-ref", default="")
93
+ parser.add_argument("--attempt", type=int, default=None)
94
+ parser.add_argument("--execution-label", default="")
95
+
96
+
97
+ def _identity_from_args(args):
98
+ payload = {}
99
+ if args.participant_ref:
100
+ payload["participantRef"] = args.participant_ref
101
+ if args.role_execution_ref:
102
+ payload["roleExecutionRef"] = args.role_execution_ref
103
+ if args.invocation_ref:
104
+ payload["invocationRef"] = args.invocation_ref
105
+ if args.attempt is not None:
106
+ payload["attempt"] = args.attempt
107
+ if args.execution_label:
108
+ payload["executionLabel"] = args.execution_label
109
+ return payload or None
110
+
111
+
87
112
  def _read_stderr(args):
88
113
  if args.stderr_excerpt_file:
89
114
  return Path(args.stderr_excerpt_file).read_text()
@@ -114,6 +139,7 @@ def main(argv=None):
114
139
  message=args.message,
115
140
  stderr_excerpt=_read_stderr(args),
116
141
  context=_read_context(args),
142
+ identity=_identity_from_args(args),
117
143
  )
118
144
  return 0
119
145
  if args.cmd == "append-from-worker":
@@ -124,6 +150,7 @@ def main(argv=None):
124
150
  agent=args.agent,
125
151
  agent_role=args.agent_role,
126
152
  model=args.model,
153
+ identity=_identity_from_args(args),
127
154
  )
128
155
  print(n)
129
156
  return 0
@@ -8,12 +8,13 @@ write scope in the order the CLIs are told it, and the role's idle budget.
8
8
  """
9
9
  from __future__ import annotations
10
10
 
11
+ import json
11
12
  import os
12
13
  import shutil
13
14
  import sys
14
15
  from dataclasses import dataclass
15
16
  from pathlib import Path
16
- from typing import Any, Mapping
17
+ from typing import Any, Callable, Mapping
17
18
 
18
19
  _HERE = Path(__file__).resolve().parent
19
20
  # ``okstra_ctl`` sits beside this file in the repo (``scripts/``) but under
@@ -26,7 +27,13 @@ sys.path.insert(0, str(_HERE))
26
27
  if _HOME_LIB.is_dir() and str(_HOME_LIB) not in sys.path:
27
28
  sys.path.append(str(_HOME_LIB))
28
29
 
29
- from okstra_ctl.domain.provider import ProviderSpec, UnknownProviderError # noqa: E402
30
+ from okstra_ctl.domain.provider import ( # noqa: E402
31
+ ProviderSpec,
32
+ ServedModelAttestation,
33
+ ServedModelNormalizer,
34
+ UnknownProviderError,
35
+ )
36
+ from okstra_ctl.domain.role import normalize_role, role_for_duty # noqa: E402
30
37
  from okstra_ctl.domain.worker_exec import ( # noqa: E402
31
38
  ExecutionStrategy,
32
39
  WorkerExecRequest,
@@ -36,15 +43,32 @@ from okstra_ctl.registry.provider_registry import ( # noqa: E402
36
43
  )
37
44
  from okstra_ctl.worker_request import build_request, idle_timeout # noqa: E402
38
45
  from okstra_ctl.worker_runner import LIVE, QUIET, run_worker # noqa: E402
46
+ from okstra_ctl.dispatch_core import verify_served_model # noqa: E402
47
+ from okstra_ctl.dispatch_state import DispatchError # noqa: E402
48
+ from okstra_ctl.execution_manifest import read_execution_manifest # noqa: E402
49
+ from okstra_ctl.write_policy import ( # noqa: E402
50
+ WriteEnforcement,
51
+ WritePolicy,
52
+ write_enforcement_from_payload,
53
+ write_policy_from_payload,
54
+ )
55
+ from okstra_ctl.model_pool import ModelPool # noqa: E402
56
+ from okstra_ctl.agent_invocation import ( # noqa: E402
57
+ AgentInvocationError,
58
+ agent_model_assignment_from_payload,
59
+ invocation_metadata_identity,
60
+ )
39
61
 
40
62
  _USAGE = (
41
63
  "usage: okstra-provider-exec.py <provider> <project-root> "
42
64
  "<model-execution-value> <prompt-path> [worktree-path] [role] "
43
- "[idle-timeout-seconds] [--presentation live|quiet] [--session-id <uuid>]"
65
+ "[idle-timeout-seconds] [--presentation live|quiet] [--session-id <uuid>] "
66
+ "[--invocation-metadata path]"
44
67
  )
45
68
 
46
69
  _PRESENTATION_FLAG = "--presentation"
47
70
  _SESSION_ID_FLAG = "--session-id"
71
+ _INVOCATION_METADATA_FLAG = "--invocation-metadata"
48
72
  _PRESENTATIONS = (LIVE, QUIET)
49
73
 
50
74
 
@@ -62,6 +86,16 @@ class Invocation:
62
86
  log_path: Path
63
87
  status_path: Path
64
88
  status_extra: Mapping[str, Any]
89
+ served_model_normalizer: ServedModelNormalizer | None
90
+ served_model_verifier: Callable[[ServedModelAttestation], str] | None
91
+
92
+
93
+ @dataclass(frozen=True)
94
+ class _V2InvocationContext:
95
+ status_extra: Mapping[str, Any]
96
+ verify_attestation: Callable[[ServedModelAttestation], str]
97
+ write_policy: WritePolicy
98
+ write_enforcement: WriteEnforcement
65
99
 
66
100
 
67
101
  def parse_invocation(argv: list[str]) -> Invocation:
@@ -70,6 +104,7 @@ def parse_invocation(argv: list[str]) -> Invocation:
70
104
  # Empty unless the dispatcher issued one. Without it the CLI picks its own
71
105
  # id and nothing downstream can map that session back to this worker.
72
106
  positional, session_id = _take_flag(positional, _SESSION_ID_FLAG, "")
107
+ positional, metadata_raw = _take_flag(positional, _INVOCATION_METADATA_FLAG, "")
73
108
  if not 4 <= len(positional) <= 7:
74
109
  raise PreflightError(64, _USAGE)
75
110
  provider_id, project_root_raw, model, prompt_raw = positional[:4]
@@ -77,7 +112,6 @@ def parse_invocation(argv: list[str]) -> Invocation:
77
112
  role = positional[5] if len(positional) >= 6 and positional[5] else "worker"
78
113
  timeout_raw = positional[6] if len(positional) >= 7 and positional[6] else ""
79
114
 
80
- spec = _provider_spec(provider_id)
81
115
  project_root = _existing_dir(project_root_raw, 65, "project-root")
82
116
  if not model:
83
117
  raise PreflightError(66, "model-execution-value is empty")
@@ -86,6 +120,32 @@ def parse_invocation(argv: list[str]) -> Invocation:
86
120
  worktree = (
87
121
  _existing_dir(worktree_raw, 68, "worktree-path") if worktree_raw else None
88
122
  )
123
+ spec = _provider_spec(provider_id)
124
+ status_extra: dict[str, Any] = {"wrapper": spec.wrapper, "role": role}
125
+ served_model_normalizer: ServedModelNormalizer | None = None
126
+ served_model_verifier: Callable[[ServedModelAttestation], str] | None = None
127
+ write_policy: WritePolicy | None = None
128
+ write_enforcement: WriteEnforcement | None = None
129
+ if metadata_raw:
130
+ context = _v2_status_extra(
131
+ metadata_path=_existing_file(
132
+ metadata_raw, 64, "invocation-metadata"
133
+ ),
134
+ project_root=project_root,
135
+ prompt_path=prompt_path,
136
+ provider_id=provider_id,
137
+ model=model,
138
+ role=role,
139
+ )
140
+ status_extra.update(context.status_extra)
141
+ served_model_normalizer = spec.served_model_normalizer
142
+ served_model_verifier = context.verify_attestation
143
+ write_policy = context.write_policy
144
+ write_enforcement = context.write_enforcement
145
+ if not spec.supports_role(role):
146
+ raise PreflightError(
147
+ 64, f"provider {provider_id!r} does not support role {role!r}"
148
+ )
89
149
 
90
150
  request = build_request(
91
151
  prompt_text=prompt_path.read_text(encoding="utf-8"),
@@ -95,6 +155,8 @@ def parse_invocation(argv: list[str]) -> Invocation:
95
155
  role=role,
96
156
  idle_timeout_seconds=idle_timeout_seconds,
97
157
  session_id=session_id,
158
+ write_policy=write_policy,
159
+ write_enforcement=write_enforcement,
98
160
  )
99
161
  strategy = spec.exec_strategy
100
162
  _check_command(strategy, request)
@@ -104,7 +166,9 @@ def parse_invocation(argv: list[str]) -> Invocation:
104
166
  presentation=presentation,
105
167
  log_path=_log_path(prompt_path),
106
168
  status_path=Path(f"{prompt_path}.status.json"),
107
- status_extra={"wrapper": spec.wrapper, "role": role},
169
+ status_extra=status_extra,
170
+ served_model_normalizer=served_model_normalizer,
171
+ served_model_verifier=served_model_verifier,
108
172
  )
109
173
 
110
174
 
@@ -149,6 +213,152 @@ def _take_presentation(argv: list[str]) -> tuple[list[str], str]:
149
213
  return positional, presentation
150
214
 
151
215
 
216
+ def _v2_status_extra(
217
+ *,
218
+ metadata_path: Path,
219
+ project_root: Path,
220
+ prompt_path: Path,
221
+ provider_id: str,
222
+ model: str,
223
+ role: str,
224
+ ) -> _V2InvocationContext:
225
+ try:
226
+ metadata = json.loads(metadata_path.read_text(encoding="utf-8"))
227
+ except (OSError, UnicodeDecodeError, json.JSONDecodeError) as exc:
228
+ raise PreflightError(64, "invocation metadata is invalid") from exc
229
+ if not isinstance(metadata, dict):
230
+ raise PreflightError(64, "invocation metadata must be an object")
231
+ try:
232
+ identity = invocation_metadata_identity(metadata)
233
+ assignment = agent_model_assignment_from_payload(
234
+ metadata.get("modelAssignment")
235
+ )
236
+ except AgentInvocationError as exc:
237
+ raise PreflightError(64, str(exc)) from exc
238
+ if identity is None:
239
+ raise PreflightError(64, "new worker dispatch requires v2 invocation metadata")
240
+ if (
241
+ assignment.provider != provider_id
242
+ or assignment.model_execution_value != model
243
+ ):
244
+ raise PreflightError(64, "invocation metadata model assignment does not match wrapper")
245
+ try:
246
+ expected_role = role_for_duty(identity.duty_id)
247
+ actual_role = normalize_role(role)
248
+ except ValueError as exc:
249
+ raise PreflightError(64, f"invocation metadata role is invalid: {exc}") from exc
250
+ if expected_role != actual_role:
251
+ raise PreflightError(64, "invocation metadata duty does not match role")
252
+ prompt = metadata.get("prompt")
253
+ recorded_path = prompt.get("path") if isinstance(prompt, Mapping) else None
254
+ if not isinstance(recorded_path, str):
255
+ raise PreflightError(64, "invocation metadata prompt path is invalid")
256
+ recorded = Path(recorded_path)
257
+ if not recorded.is_absolute():
258
+ recorded = project_root / recorded
259
+ if recorded.resolve(strict=False) != prompt_path.resolve(strict=True):
260
+ raise PreflightError(64, "invocation metadata prompt does not match wrapper")
261
+ role_execution, invocation, pool = _execution_authority(
262
+ metadata=metadata,
263
+ project_root=project_root,
264
+ role_execution_ref=identity.role_execution_ref,
265
+ invocation_ref=identity.invocation_ref,
266
+ )
267
+ binding = role_execution.binding
268
+ if (
269
+ role_execution.participant_ref != identity.participant_ref
270
+ or role_execution.role != expected_role
271
+ or role_execution.provider != assignment.provider
272
+ or binding is None
273
+ or binding.runner != assignment.runner
274
+ or binding.resolved_execution_value != assignment.model_execution_value
275
+ ):
276
+ raise PreflightError(
277
+ 64, "invocation metadata role execution binding does not match run manifest"
278
+ )
279
+ if role_execution.execution_label != identity.execution_label:
280
+ raise PreflightError(
281
+ 64, "invocation metadata execution label does not match run manifest"
282
+ )
283
+
284
+ def verify_attestation(attestation: ServedModelAttestation) -> str:
285
+ try:
286
+ verify_served_model(role_execution, attestation, pool=pool)
287
+ except DispatchError as exc:
288
+ return str(exc)
289
+ return ""
290
+
291
+ try:
292
+ write_policy = write_policy_from_payload(invocation.write_policy)
293
+ write_enforcement = write_enforcement_from_payload(
294
+ invocation.write_enforcement
295
+ )
296
+ except ValueError as exc:
297
+ raise PreflightError(64, f"invocation write contract is invalid: {exc}") from exc
298
+
299
+ return _V2InvocationContext({
300
+ "schemaVersion": "2.0",
301
+ "executionIdentityVersion": 2,
302
+ "participantRef": identity.participant_ref,
303
+ "roleExecutionRef": identity.role_execution_ref,
304
+ "executionLabel": identity.execution_label,
305
+ "dutyId": identity.duty_id,
306
+ "invocationRef": identity.invocation_ref,
307
+ "attempt": identity.attempt,
308
+ "servedModelAttestation": {
309
+ "observedModel": None,
310
+ "normalizedModelRef": None,
311
+ "level": "unknown",
312
+ "source": "unavailable",
313
+ },
314
+ "writePolicyDigest": invocation.write_policy_digest,
315
+ "writeEnforcement": write_enforcement.to_payload(),
316
+ }, verify_attestation, write_policy, write_enforcement)
317
+
318
+
319
+ def _execution_authority(
320
+ *,
321
+ metadata: Mapping[str, Any],
322
+ project_root: Path,
323
+ role_execution_ref: str,
324
+ invocation_ref: str,
325
+ ):
326
+ source = metadata.get("contractSource")
327
+ manifest_raw = source.get("runManifestPath") if isinstance(source, Mapping) else None
328
+ if not isinstance(manifest_raw, str) or not manifest_raw:
329
+ raise PreflightError(64, "invocation metadata run manifest is invalid")
330
+ manifest_path = Path(manifest_raw)
331
+ if not manifest_path.is_absolute():
332
+ manifest_path = project_root / manifest_path
333
+ try:
334
+ manifest_path = manifest_path.resolve(strict=True)
335
+ manifest_path.relative_to(project_root.resolve(strict=True))
336
+ manifest = read_execution_manifest(manifest_path)
337
+ except (OSError, ValueError) as exc:
338
+ raise PreflightError(64, "invocation metadata run manifest is invalid") from exc
339
+ role_execution = next((
340
+ row for row in manifest.role_executions
341
+ if row.role_execution_ref == role_execution_ref
342
+ ), None)
343
+ if role_execution is None:
344
+ raise PreflightError(
345
+ 64, "invocation metadata role execution does not match run manifest"
346
+ )
347
+ invocation = next((
348
+ row for row in manifest.invocations
349
+ if row.invocation_ref == invocation_ref
350
+ ), None)
351
+ if invocation is None or invocation.role_execution_ref != role_execution_ref:
352
+ raise PreflightError(
353
+ 64, "invocation metadata invocation does not match run manifest"
354
+ )
355
+ return (
356
+ role_execution,
357
+ invocation,
358
+ ModelPool.from_registry(default_provider_registry()),
359
+ )
360
+
361
+
152
362
  def _provider_spec(provider_id: str) -> ProviderSpec:
153
363
  try:
154
364
  spec = default_provider_registry().resolve(provider_id)
@@ -214,6 +424,8 @@ def main(argv: list[str]) -> int:
214
424
  log_path=invocation.log_path,
215
425
  status_path=invocation.status_path,
216
426
  status_extra=invocation.status_extra,
427
+ served_model_normalizer=invocation.served_model_normalizer,
428
+ served_model_verifier=invocation.served_model_verifier,
217
429
  )
218
430
  except PreflightError as exc:
219
431
  print(f"okstra-provider-exec: {exc}", file=sys.stderr)
@@ -222,6 +222,16 @@ PY_ARGS=(
222
222
  [[ -n "${DIRECTIVE-}" ]] && PY_ARGS+=(--directive "$DIRECTIVE")
223
223
  [[ -n "${FIX_CYCLE-}" ]] && PY_ARGS+=(--fix-cycle "$FIX_CYCLE")
224
224
  [[ -n "${WORKERS_OVERRIDE-}" ]] && PY_ARGS+=(--workers "$WORKERS_OVERRIDE")
225
+ for role_count in "${ROLE_COUNTS[@]-}"; do
226
+ [[ -z "$role_count" ]] && continue
227
+ PY_ARGS+=(--role-count "$role_count")
228
+ done
229
+ for role_model in "${ROLE_MODELS[@]-}"; do
230
+ [[ -z "$role_model" ]] && continue
231
+ PY_ARGS+=(--role-model "$role_model")
232
+ done
233
+ [[ -n "${HOST_SESSION_CONTEXT_JSON-}" ]] && \
234
+ PY_ARGS+=(--host-session-context-json "$HOST_SESSION_CONTEXT_JSON")
225
235
  [[ -n "${LEAD_PROVIDER_OVERRIDE-}" ]] && PY_ARGS+=(--lead-provider "$LEAD_PROVIDER_OVERRIDE")
226
236
  [[ -n "${LEAD_MODEL_OVERRIDE-}" ]] && PY_ARGS+=(--lead-model "$LEAD_MODEL_OVERRIDE")
227
237
  [[ -n "${CLAUDE_MODEL_OVERRIDE-}" ]] && PY_ARGS+=(--claude-model "$CLAUDE_MODEL_OVERRIDE")
@@ -84,7 +84,7 @@ Read the worker result files generated in Phase 4/5 and extract individual findi
84
84
  - Same semantics but disjoint ticket sets → separate groups (do NOT over-merge across tickets).
85
85
  - Only one worker confirms a finding → one single-source group.
86
86
  4. When grouping is ambiguous, prefer splitting over merging (avoid over-merging). Semantic matching, ticket-set equality, and evidence interpretation remain lead judgments; the engine does not perform fuzzy matching or decide whether evidence is credible.
87
- 5. Write `runs/<task-type>/state/convergence-groups-<task-type>-<seq>.json`. Each group carries its `ticketIds`, `originWorker`, `originEvidence`, `discoveredBy`, and every `<worker>:<item-id>` source in `sourceItems`. For analysis sidetracks where ticket tagging is not required, `ticketIds: []` is the canonical value; never synthesize `"unknown"` or another placeholder. `scripts/okstra_ctl/convergence_engine.py` and `schemas/convergence-groups-v1.0.schema.json` enforce the required array field and reject non-string or blank entries while allowing the empty array. When a live command or external read produced reproducible evidence, also include `evidenceArtifacts[]` with its `.okstra/` path, SHA-256 digest, command, and environment. The field is optional because historical or inaccessible evidence may not have a captured artifact. The lead and verifier MUST NOT infer live or external evidence from wording or keyword matching; they use the finding's explicit claim, provenance, and supplied artifacts. Include the resolved worker roster in order with functional `audience` values; do not derive scope from provider or model identity. The `audience` enum is a convergence role, not a phase label: every finding-producing worker uses `analysis` — an `implementation` run's verifiers included — and only the report author uses `report-writer`. There is no `implementation-verifier` audience here; map the verifier roster to `analysis`.
87
+ 5. Write `runs/<task-type>/state/convergence-groups-<task-type>-<seq>.json`. Each group carries its `ticketIds`, `originWorker`, `originEvidence`, `discoveredBy`, and every `<worker>:<item-id>` source in `sourceItems`. For analysis sidetracks where ticket tagging is not required, `ticketIds: []` is the canonical value; never synthesize `"unknown"` or another placeholder. `scripts/okstra_ctl/convergence_engine.py` and the version-selected convergence-groups schema enforce the required array field and reject non-string or blank entries while allowing the empty array. When a live command or external read produced reproducible evidence, also include `evidenceArtifacts[]` with its `.okstra/` path, SHA-256 digest, command, and environment. The field is optional because historical or inaccessible evidence may not have a captured artifact. The lead and verifier MUST NOT infer live or external evidence from wording or keyword matching; they use the finding's explicit claim, provenance, and supplied artifacts. Include the resolved worker roster in order with functional `audience` values; do not derive scope from provider or model identity. In a v2 run, set top-level `schemaVersion: "2.0"`, `executionIdentityVersion: 2`, and `runManifestPath` to the current run manifest's exact canonical project-relative path. Write the groups artifact under that same resolved run directory's `state/` directory. Every v2 worker row also carries the paired `participantRef` and `sourceRoleExecutionRef` from that run manifest's canonical role state. Set `sourceRoleExecutionRef` to the selected source `RoleExecution` row's `roleExecutionRef`, not that row's `sourceRoleExecutionRef` field; a static source row has null in the latter field. Copy `participantRef` from that same selected row. Never derive those references from the worker name, provider, model, or execution label. A legacy v1 document keeps `schemaVersion: "1.0"` and omits `executionIdentityVersion`, `runManifestPath`, and both worker reference fields. The `audience` enum is a convergence role, not a phase label: every finding-producing worker uses `analysis` and selects an `analyser`, `designer`, `planner`, or `verifier` source role. Only the report author uses `report-writer`, paired with a `report-writer` source role. There is no `implementation-verifier` audience here; map an implementation verifier to `analysis`.
88
88
  6. Do not write a queue or classification in this grouped-input artifact. `okstra convergence seed` classifies Round 0 by mode:
89
89
  - Collaborative mode: multi-source groups become `full-consensus` immediately; only single-source groups enter the working queue.
90
90
  - Adversarial mode: every finding enters the working queue regardless of source count. Semantic grouping merges provenance only; it does not decide a finding is reliable.
@@ -106,8 +106,8 @@ convergence-<task-type>-<seq>.json
106
106
 
107
107
  Follow this protocol exactly:
108
108
 
109
- 0. Two schemas describe what the reducer reads: `schemas/convergence-groups-v1.0.schema.json` feeds step 1's `seed --groups`, and `schemas/convergence-round-results-v1.0.schema.json` feeds step 4's `apply-round --results`. `schemas/convergence-critic-results-v1.0.schema.json` is a third shape but **not** a reducer input — it describes the critic worker's own result document. Step 6's `apply-critic-gaps --results` takes the coverage batch you assemble from those candidates plus each analyser's vote (`{schemaVersion, taskKey, mode, provider, modelExecutionValue, dispatches[], gaps[]}`, spelled out in §"Coverage critic pass" §"State"); feeding the critic document straight in is rejected, by design. `okstra convergence example --kind <groups|round-results|critic-results>` prints a deterministic valid instance of each and writes only JSON to stdout.
110
- 1. Run `okstra convergence seed --groups <groups> --work-state <work> --final-state <final> --migration-dir <state/migrations>`. A `reuse-final` action means validate the existing final and continue to Phase 6. `create-work`, `resume-work`, and `restart-round0` continue with planning.
109
+ 0. Version-selected schemas describe what the reducer reads: `schemas/convergence-groups-v1.0.schema.json` accepts only legacy groups, `schemas/convergence-groups-v2.0.schema.json` accepts only explicit v2 execution identity, and `schemas/convergence-round-results-v1.0.schema.json` feeds step 4's `apply-round --results`. `schemas/convergence-critic-results-v1.0.schema.json` is a fourth shape but **not** a reducer input — it describes the critic worker's own result document. Step 6's `apply-critic-gaps --results` takes the coverage batch you assemble from those candidates plus each analyser's vote (`{schemaVersion, taskKey, mode, provider, modelExecutionValue, dispatches[], gaps[]}`, spelled out in §"Coverage critic pass" §"State"); feeding the critic document straight in is rejected, by design. `okstra convergence example --kind <groups|round-results|critic-results>` prints a deterministic valid v1 instance of each and writes only JSON to stdout.
110
+ 1. Run `okstra convergence seed --groups <groups> --run-manifest <current-run-manifest> --work-state <work> --final-state <final> --migration-dir <state/migrations>` for a v2 worker roster. `--run-manifest` must be the exact current manifest named by the groups document's `runManifestPath`; a previous run from the same task is not interchangeable. Omit the flag for a legacy v1 roster. A `reuse-final` action means validate the existing final and continue to Phase 6. `create-work`, `resume-work`, and `restart-round0` continue with planning.
111
111
  2. Run `okstra convergence plan-round --work-state <work> --plan <round-plan>`. This is read-only with respect to the working state.
112
112
  3. When the plan action is `dispatch`, create exactly one reverify prompt for each `dispatches[]` row and dispatch it through the selected runtime adapter. Its findings are exactly that row's `findingIds`.
113
113
  4. Convert parsed verdicts and every terminal dispatch outcome into `convergence-round-<N>-results-<task-type>-<seq>.json`; then run `okstra convergence apply-round --work-state <work> --plan <round-plan> --results <round-results>`.
@@ -228,21 +228,30 @@ Design intent: one `counter-evidence` refute denies a claim consensus (it cannot
228
228
 
229
229
  For every finding reverify row and critic-gap verification row, first write a
230
230
  call-specific task-instructions file under the current run's `state/`
231
- directory. Then run `okstra agent-prompt materialize` with `--audience
232
- reverification-worker`, `--assignment-ref reverify/<workerId>`, the exact
233
- `--worker-id`, `--dispatch-kind reverify-r<N>`, and the authorized
234
- prompt/result/audit paths. The returned `promptPath` is the only body that may
235
- be dispatched; do not append role prose or reconstruct model headers after
236
- materialization.
237
-
238
- If the dispatch gate then rejects that prompt, fix the task-instructions file
239
- and re-run the same `materialize` call with `--replace-undispatched` — keep the
240
- `--invocation-id`. A published prompt is otherwise immutable, so without that
241
- flag the retry fails as `existing_invocation_conflict`; do NOT delete the
242
- reservation under `prompts/.agent-invocations` and do NOT mint a second
243
- invocation id to get around it, because both detach the audit chain from the
244
- call it describes. The flag is checked: once any dispatch row names this
245
- invocation, the prompt is history and the replacement is refused.
231
+ directory. For a v2 run, take `participantRef` and
232
+ `sourceRoleExecutionRef` from the canonical round-plan dispatch row or the
233
+ matching canonical working-state worker row. That stored reference is the
234
+ selected source `RoleExecution` row's `roleExecutionRef`, not that row's
235
+ `sourceRoleExecutionRef` field. Then run `okstra agent-prompt
236
+ materialize` with `--audience
237
+ reverification-worker`, `--assignment-ref reverify/<workerId>`,
238
+ `--source-role-execution-ref
239
+ <sourceRoleExecutionRef>`, the exact `--worker-id`, `--dispatch-kind
240
+ reverify-r<N>`, and the authorized prompt/result/audit paths. Do not derive the
241
+ source role execution from `workerId`, provider, model, or execution-label
242
+ text. A legacy v1 run omits `--source-role-execution-ref`; the materializer
243
+ keeps its legacy read-only identity resolution for that schema version. The
244
+ returned `promptPath` is the only body that may be dispatched; do not append
245
+ role prose or reconstruct model headers after materialization.
246
+
247
+ If the dispatch gate then rejects that prompt, preserve its prompt, metadata,
248
+ reservation, and append-only Invocation bytes. A v2 reverify correction uses a
249
+ fresh `--invocation-id` and fresh prompt/metadata path; the materializer rejects
250
+ `--replace-undispatched` for this dynamic identity path. A legacy v1 correction
251
+ may fix the task-instructions file and re-run the same `materialize` call with
252
+ `--replace-undispatched` while keeping the `--invocation-id`. Once any dispatch
253
+ row names the invocation, replacement is rejected even for v1 and the prompt is
254
+ history. Do not delete prompt, metadata, or reservation files by hand.
246
255
 
247
256
  Run `okstra agent-prompt verify --run-manifest <path> --metadata
248
257
  <metadataPath> --json` immediately before dispatch. A failed verification is a
@@ -44,7 +44,9 @@ Read-side inspection (`/okstra-inspect`) and scheduling (`/okstra-schedule-gen`)
44
44
 
45
45
  ## Core operating contract
46
46
 
47
- - The `lead` owns orchestration, convergence supervision, and final-report review/approval. It does not author the final-report file when `Report writer worker` is in the roster.
47
+ - The `leader` owns orchestration, convergence supervision, and final-report review/approval. It does not author the final-report file when `Report writer worker` is in the roster. `lead` is a compatibility alias for `leader` and must not be written on new artifacts.
48
+ - Dispatch consumes stored role executions, not provider-named worker IDs. Canonical roles are `leader`, `analyser`, `critic`, `designer`, `planner`, `implementer`, `verifier`, `report-writer`, and `translator`. `executor` is a compatibility alias for `implementer`.
49
+ - Pane titles and operational rows use the stored `executionLabel`. Do not rebuild that label from a provider name or model string.
48
50
  - Standard worker roles remain `Claude worker`, `Codex worker`, `Antigravity worker`, and `Report writer worker`; these are provider/functional-role identities, not lead-runtime primitives.
49
51
  - `Report writer worker`, when in the roster, is the **author** of the final-report file. Lead reviews the draft and may request a revision via a follow-up dispatch, but MUST NOT write the report itself as a "shortcut". The only legal lead-authored fallback is when a Report writer worker dispatch was actually attempted and recorded a terminal status of `error`/`timeout`/`not-run` with an explicit reason in team-state — see [report-writer](./report-writer.md) "Lead-authored fallback".
50
52
  - "Session resume", "team is no longer alive", and similar are NOT valid reasons to skip Report writer worker dispatch — see [report-writer](./report-writer.md) "Resume-safe dispatch".