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.
- package/README.md +18 -9
- package/bin/okstra +8 -4
- package/dist/cli-registry.d.mts +16 -0
- package/dist/cli-registry.mjs +560 -0
- package/dist/cli-registry.mjs.map +1 -0
- package/dist/commands/execute/agent-prompt.d.mts +1 -0
- package/{src → dist}/commands/execute/agent-prompt.mjs +10 -11
- package/dist/commands/execute/agent-prompt.mjs.map +1 -0
- package/dist/commands/execute/codex-dispatch.d.mts +3 -0
- package/dist/commands/execute/codex-dispatch.mjs +6 -0
- package/dist/commands/execute/codex-dispatch.mjs.map +1 -0
- package/dist/commands/execute/codex-run.d.mts +3 -0
- package/{src → dist}/commands/execute/codex-run.mjs +30 -37
- package/dist/commands/execute/codex-run.mjs.map +1 -0
- package/dist/commands/execute/convergence.d.mts +1 -0
- package/{src → dist}/commands/execute/convergence.mjs +15 -16
- package/dist/commands/execute/convergence.mjs.map +1 -0
- package/dist/commands/execute/error-log.d.mts +1 -0
- package/{src → dist}/commands/execute/error-log.mjs +2 -3
- package/dist/commands/execute/error-log.mjs.map +1 -0
- package/dist/commands/execute/git-reconcile.d.mts +1 -0
- package/{src → dist}/commands/execute/git-reconcile.mjs +10 -11
- package/dist/commands/execute/git-reconcile.mjs.map +1 -0
- package/dist/commands/execute/handoff.d.mts +1 -0
- package/{src → dist}/commands/execute/handoff.mjs +10 -11
- package/dist/commands/execute/handoff.mjs.map +1 -0
- package/dist/commands/execute/incremental-carry.d.mts +1 -0
- package/{src → dist}/commands/execute/incremental-carry.mjs +2 -3
- package/dist/commands/execute/incremental-carry.mjs.map +1 -0
- package/dist/commands/execute/incremental-scope.d.mts +1 -0
- package/{src → dist}/commands/execute/incremental-scope.mjs +2 -3
- package/dist/commands/execute/incremental-scope.mjs.map +1 -0
- package/dist/commands/execute/integrate-stages.d.mts +1 -0
- package/{src → dist}/commands/execute/integrate-stages.mjs +10 -11
- package/dist/commands/execute/integrate-stages.mjs.map +1 -0
- package/dist/commands/execute/pane-title.d.mts +1 -0
- package/dist/commands/execute/pane-title.mjs +20 -0
- package/dist/commands/execute/pane-title.mjs.map +1 -0
- package/dist/commands/execute/plan-items.d.mts +1 -0
- package/dist/commands/execute/plan-items.mjs +9 -0
- package/dist/commands/execute/plan-items.mjs.map +1 -0
- package/dist/commands/execute/plan-validate.d.mts +1 -0
- package/dist/commands/execute/plan-validate.mjs +68 -0
- package/dist/commands/execute/plan-validate.mjs.map +1 -0
- package/dist/commands/execute/plan-verify.d.mts +1 -0
- package/{src → dist}/commands/execute/plan-verify.mjs +13 -16
- package/dist/commands/execute/plan-verify.mjs.map +1 -0
- package/dist/commands/execute/render-bundle.d.mts +3 -0
- package/{src → dist}/commands/execute/render-bundle.mjs +65 -61
- package/dist/commands/execute/render-bundle.mjs.map +1 -0
- package/dist/commands/execute/run.d.mts +24 -0
- package/dist/commands/execute/run.mjs +196 -0
- package/dist/commands/execute/run.mjs.map +1 -0
- package/dist/commands/execute/spawn-followups.d.mts +1 -0
- package/{src → dist}/commands/execute/spawn-followups.mjs +6 -7
- package/dist/commands/execute/spawn-followups.mjs.map +1 -0
- package/dist/commands/execute/team.d.mts +3 -0
- package/{src → dist}/commands/execute/team.mjs +29 -36
- package/dist/commands/execute/team.mjs.map +1 -0
- package/dist/commands/execute/token-usage.d.mts +1 -0
- package/{src → dist}/commands/execute/token-usage.mjs +2 -3
- package/dist/commands/execute/token-usage.mjs.map +1 -0
- package/dist/commands/execute/wizard.d.mts +8 -0
- package/dist/commands/execute/wizard.mjs +191 -0
- package/dist/commands/execute/wizard.mjs.map +1 -0
- package/dist/commands/execute/worker-audit-check.d.mts +1 -0
- package/{src → dist}/commands/execute/worker-audit-check.mjs +11 -12
- package/dist/commands/execute/worker-audit-check.mjs.map +1 -0
- package/dist/commands/execute/worker-dispatch.d.mts +7 -0
- package/{src → dist}/commands/execute/worker-dispatch.mjs +34 -46
- package/dist/commands/execute/worker-dispatch.mjs.map +1 -0
- package/dist/commands/execute/worker-state.d.mts +1 -0
- package/{src → dist}/commands/execute/worker-state.mjs +15 -16
- package/dist/commands/execute/worker-state.mjs.map +1 -0
- package/dist/commands/execute/worktree-lookup.d.mts +1 -0
- package/{src → dist}/commands/execute/worktree-lookup.mjs +38 -37
- package/dist/commands/execute/worktree-lookup.mjs.map +1 -0
- package/dist/commands/execute/worktree-status.d.mts +1 -0
- package/{src → dist}/commands/execute/worktree-status.mjs +52 -46
- package/dist/commands/execute/worktree-status.mjs.map +1 -0
- package/dist/commands/inspect/code-review.d.mts +1 -0
- package/{src → dist}/commands/inspect/code-review.mjs +16 -19
- package/dist/commands/inspect/code-review.mjs.map +1 -0
- package/dist/commands/inspect/container.d.mts +1 -0
- package/{src → dist}/commands/inspect/container.mjs +11 -13
- package/dist/commands/inspect/container.mjs.map +1 -0
- package/dist/commands/inspect/context-cost.d.mts +1 -0
- package/{src → dist}/commands/inspect/context-cost.mjs +11 -13
- package/dist/commands/inspect/context-cost.mjs.map +1 -0
- package/dist/commands/inspect/design-prep.d.mts +1 -0
- package/{src → dist}/commands/inspect/design-prep.mjs +10 -11
- package/dist/commands/inspect/design-prep.mjs.map +1 -0
- package/dist/commands/inspect/error-report.d.mts +1 -0
- package/{src → dist}/commands/inspect/error-report.mjs +11 -13
- package/dist/commands/inspect/error-report.mjs.map +1 -0
- package/dist/commands/inspect/error-zip.d.mts +1 -0
- package/{src → dist}/commands/inspect/error-zip.mjs +11 -12
- package/dist/commands/inspect/error-zip.mjs.map +1 -0
- package/dist/commands/inspect/log-report.d.mts +1 -0
- package/{src → dist}/commands/inspect/log-report.mjs +11 -13
- package/dist/commands/inspect/log-report.mjs.map +1 -0
- package/dist/commands/inspect/profile-show.d.mts +1 -0
- package/{src → dist}/commands/inspect/profile-show.mjs +10 -11
- package/dist/commands/inspect/profile-show.mjs.map +1 -0
- package/dist/commands/inspect/recap.d.mts +1 -0
- package/{src → dist}/commands/inspect/recap.mjs +11 -13
- package/dist/commands/inspect/recap.mjs.map +1 -0
- package/dist/commands/inspect/resolve-task-key.d.mts +1 -0
- package/{src → dist}/commands/inspect/resolve-task-key.mjs +11 -13
- package/dist/commands/inspect/resolve-task-key.mjs.map +1 -0
- package/dist/commands/inspect/rollup.d.mts +1 -0
- package/{src → dist}/commands/inspect/rollup.mjs +11 -13
- package/dist/commands/inspect/rollup.mjs.map +1 -0
- package/dist/commands/inspect/run-audit.d.mts +1 -0
- package/{src → dist}/commands/inspect/run-audit.mjs +11 -12
- package/dist/commands/inspect/run-audit.mjs.map +1 -0
- package/dist/commands/inspect/set-work-status.d.mts +1 -0
- package/{src → dist}/commands/inspect/set-work-status.mjs +11 -13
- package/dist/commands/inspect/set-work-status.mjs.map +1 -0
- package/dist/commands/inspect/stage-map.d.mts +1 -0
- package/dist/commands/inspect/stage-map.mjs +110 -0
- package/dist/commands/inspect/stage-map.mjs.map +1 -0
- package/dist/commands/inspect/task-list.d.mts +1 -0
- package/dist/commands/inspect/task-list.mjs +103 -0
- package/dist/commands/inspect/task-list.mjs.map +1 -0
- package/dist/commands/inspect/task-show.d.mts +1 -0
- package/dist/commands/inspect/task-show.mjs +108 -0
- package/dist/commands/inspect/task-show.mjs.map +1 -0
- package/dist/commands/inspect/time-report.d.mts +1 -0
- package/{src → dist}/commands/inspect/time-report.mjs +11 -13
- package/dist/commands/inspect/time-report.mjs.map +1 -0
- package/dist/commands/inspect/usage-report.d.mts +1 -0
- package/{src → dist}/commands/inspect/usage-report.mjs +11 -13
- package/dist/commands/inspect/usage-report.mjs.map +1 -0
- package/dist/commands/inspect/user-response.d.mts +1 -0
- package/{src → dist}/commands/inspect/user-response.mjs +10 -11
- package/dist/commands/inspect/user-response.mjs.map +1 -0
- package/dist/commands/inspect/worker-liveness.d.mts +1 -0
- package/{src → dist}/commands/inspect/worker-liveness.mjs +11 -13
- package/dist/commands/inspect/worker-liveness.mjs.map +1 -0
- package/dist/commands/lifecycle/check-project.d.mts +21 -0
- package/dist/commands/lifecycle/check-project.mjs +175 -0
- package/dist/commands/lifecycle/check-project.mjs.map +1 -0
- package/dist/commands/lifecycle/config.d.mts +1 -0
- package/dist/commands/lifecycle/config.mjs +369 -0
- package/dist/commands/lifecycle/config.mjs.map +1 -0
- package/dist/commands/lifecycle/doctor.d.mts +10 -0
- package/dist/commands/lifecycle/doctor.mjs +317 -0
- package/dist/commands/lifecycle/doctor.mjs.map +1 -0
- package/dist/commands/lifecycle/install.d.mts +17 -0
- package/dist/commands/lifecycle/install.mjs +1077 -0
- package/dist/commands/lifecycle/install.mjs.map +1 -0
- package/dist/commands/lifecycle/migrate.d.mts +1 -0
- package/{src → dist}/commands/lifecycle/migrate.mjs +10 -11
- package/dist/commands/lifecycle/migrate.mjs.map +1 -0
- package/dist/commands/lifecycle/model.d.mts +1 -0
- package/dist/commands/lifecycle/model.mjs +22 -0
- package/dist/commands/lifecycle/model.mjs.map +1 -0
- package/dist/commands/lifecycle/paths.d.mts +1 -0
- package/dist/commands/lifecycle/paths.mjs +102 -0
- package/dist/commands/lifecycle/paths.mjs.map +1 -0
- package/dist/commands/lifecycle/preflight.d.mts +1 -0
- package/dist/commands/lifecycle/preflight.mjs +124 -0
- package/dist/commands/lifecycle/preflight.mjs.map +1 -0
- package/dist/commands/lifecycle/setup.d.mts +1 -0
- package/dist/commands/lifecycle/setup.mjs +297 -0
- package/dist/commands/lifecycle/setup.mjs.map +1 -0
- package/dist/commands/lifecycle/uninstall.d.mts +4 -0
- package/dist/commands/lifecycle/uninstall.mjs +262 -0
- package/dist/commands/lifecycle/uninstall.mjs.map +1 -0
- package/dist/commands/manager.d.mts +3 -0
- package/{src → dist}/commands/manager.mjs +25 -32
- package/dist/commands/manager.mjs.map +1 -0
- package/dist/commands/memory/memory.d.mts +1 -0
- package/dist/commands/memory/memory.mjs +569 -0
- package/dist/commands/memory/memory.mjs.map +1 -0
- package/dist/commands/pr/pr.d.mts +33 -0
- package/dist/commands/pr/pr.mjs +296 -0
- package/dist/commands/pr/pr.mjs.map +1 -0
- package/dist/commands/report/agent-activity.d.mts +1 -0
- package/{src → dist}/commands/report/agent-activity.mjs +11 -12
- package/dist/commands/report/agent-activity.mjs.map +1 -0
- package/dist/commands/report/finalize.d.mts +4 -0
- package/{src → dist}/commands/report/finalize.mjs +25 -32
- package/dist/commands/report/finalize.mjs.map +1 -0
- package/dist/commands/report/inject-report-index.d.mts +1 -0
- package/{src → dist}/commands/report/inject-report-index.mjs +6 -7
- package/dist/commands/report/inject-report-index.mjs.map +1 -0
- package/dist/commands/report/render-final-report.d.mts +1 -0
- package/{src → dist}/commands/report/render-final-report.mjs +6 -7
- package/dist/commands/report/render-final-report.mjs.map +1 -0
- package/dist/commands/report/render-views.d.mts +1 -0
- package/{src → dist}/commands/report/render-views.mjs +6 -7
- package/dist/commands/report/render-views.mjs.map +1 -0
- package/dist/commands/report/translate.d.mts +1 -0
- package/{src → dist}/commands/report/translate.mjs +6 -7
- package/dist/commands/report/translate.mjs.map +1 -0
- package/dist/lib/helper-scripts.d.mts +3 -0
- package/{src → dist}/lib/helper-scripts.mjs +11 -14
- package/dist/lib/helper-scripts.mjs.map +1 -0
- package/dist/lib/host-registry-client.d.mts +25 -0
- package/dist/lib/host-registry-client.mjs +152 -0
- package/dist/lib/host-registry-client.mjs.map +1 -0
- package/dist/lib/install-assets.d.mts +8 -0
- package/{src → dist}/lib/install-assets.mjs +17 -20
- package/dist/lib/install-assets.mjs.map +1 -0
- package/dist/lib/okstra-dirs.d.mts +4 -0
- package/{src → dist}/lib/okstra-dirs.mjs +3 -6
- package/dist/lib/okstra-dirs.mjs.map +1 -0
- package/dist/lib/paths.d.mts +4 -0
- package/dist/lib/paths.mjs +78 -0
- package/dist/lib/paths.mjs.map +1 -0
- package/dist/lib/proc.d.mts +3 -0
- package/dist/lib/proc.mjs +31 -0
- package/dist/lib/proc.mjs.map +1 -0
- package/dist/lib/python-helper.d.mts +8 -0
- package/dist/lib/python-helper.mjs +123 -0
- package/dist/lib/python-helper.mjs.map +1 -0
- package/dist/lib/runtime-manifest.d.mts +7 -0
- package/dist/lib/runtime-manifest.mjs +73 -0
- package/dist/lib/runtime-manifest.mjs.map +1 -0
- package/dist/lib/skill-catalog.d.mts +4 -0
- package/dist/lib/skill-catalog.mjs +50 -0
- package/dist/lib/skill-catalog.mjs.map +1 -0
- package/dist/lib/types.d.mts +129 -0
- package/dist/lib/types.mjs +2 -0
- package/dist/lib/types.mjs.map +1 -0
- package/dist/lib/version.d.mts +2 -0
- package/dist/lib/version.mjs +27 -0
- package/dist/lib/version.mjs.map +1 -0
- package/docs/architecture/storage-model.md +4 -0
- package/docs/architecture.md +7 -1
- package/docs/cli.md +26 -6
- package/docs/contributor-change-matrix.md +2 -2
- package/docs/project-structure-overview.md +16 -7
- package/docs/task-process/README.md +2 -0
- package/docs/task-process/implementation-planning.md +1 -1
- package/docs/task-process/implementation.md +1 -1
- package/package.json +11 -5
- package/runtime/BUILD.json +2 -2
- package/runtime/agents/workers/claude-worker.md +2 -1
- package/runtime/agents/workers/report-writer-worker.md +3 -1
- package/runtime/agents/workers/translator-worker.md +3 -1
- package/runtime/bin/lib/okstra/cli.sh +12 -0
- package/runtime/bin/lib/okstra/globals.sh +3 -0
- package/runtime/bin/lib/okstra/usage.sh +4 -4
- package/runtime/bin/okstra-error-log.py +27 -0
- package/runtime/bin/okstra-provider-exec.py +217 -5
- package/runtime/bin/okstra.sh +10 -0
- package/runtime/prompts/lead/convergence.md +27 -18
- package/runtime/prompts/lead/okstra-lead-contract.md +3 -1
- package/runtime/prompts/lead/plan-body-verification.md +10 -3
- package/runtime/prompts/lead/team-contract.md +1 -1
- package/runtime/prompts/profiles/change-impact-analysis.md +16 -0
- package/runtime/prompts/profiles/error-analysis.md +20 -0
- package/runtime/prompts/profiles/feature-analysis.md +16 -0
- package/runtime/prompts/profiles/final-verification.md +16 -0
- package/runtime/prompts/profiles/implementation-option-selection.md +16 -0
- package/runtime/prompts/profiles/implementation-planning.md +20 -0
- package/runtime/prompts/profiles/implementation.md +15 -0
- package/runtime/prompts/profiles/improvement-discovery.md +16 -0
- package/runtime/prompts/profiles/project-analysis.md +16 -0
- package/runtime/prompts/profiles/release-handoff.md +4 -0
- package/runtime/prompts/profiles/requirements-discovery.md +20 -0
- package/runtime/prompts/wizard/prompts.ko.json +18 -0
- package/runtime/python/okstra_ctl/adapters/dispatch/cli_wrapper.py +8 -0
- package/runtime/python/okstra_ctl/adapters/dispatch/cmux.py +8 -0
- package/runtime/python/okstra_ctl/adapters/dispatch/native_team.py +13 -0
- package/runtime/python/okstra_ctl/adapters/hosts/antigravity/adapter.py +2 -2
- package/runtime/python/okstra_ctl/adapters/hosts/claude-code/adapter.py +25 -5
- package/runtime/python/okstra_ctl/adapters/hosts/codex/adapter.py +2 -2
- package/runtime/python/okstra_ctl/adapters/hosts/external/adapter.py +4 -1
- package/runtime/python/okstra_ctl/adapters/hosts/grok/adapter.py +2 -2
- package/runtime/python/okstra_ctl/adapters/hosts/kimi/adapter.py +2 -2
- package/runtime/python/okstra_ctl/adapters/providers/antigravity/adapter.py +79 -11
- package/runtime/python/okstra_ctl/adapters/providers/claude/adapter.py +95 -25
- package/runtime/python/okstra_ctl/adapters/providers/codex/adapter.py +59 -14
- package/runtime/python/okstra_ctl/adapters/providers/grok/adapter.py +55 -9
- package/runtime/python/okstra_ctl/adapters/providers/kimi/adapter.py +51 -12
- package/runtime/python/okstra_ctl/agent_activity.py +5 -1
- package/runtime/python/okstra_ctl/agent_invocation.py +608 -14
- package/runtime/python/okstra_ctl/agent_prompt_cli.py +249 -50
- package/runtime/python/okstra_ctl/application/resolve_assignment.py +53 -12
- package/runtime/python/okstra_ctl/assignment_environment.py +102 -0
- package/runtime/python/okstra_ctl/assignment_resolver.py +790 -0
- package/runtime/python/okstra_ctl/attempt_evidence.py +342 -0
- package/runtime/python/okstra_ctl/convergence.py +409 -3
- package/runtime/python/okstra_ctl/convergence_engine.py +248 -15
- package/runtime/python/okstra_ctl/convergence_store.py +170 -1
- package/runtime/python/okstra_ctl/dispatch_core.py +1092 -63
- package/runtime/python/okstra_ctl/dispatch_state.py +696 -11
- package/runtime/python/okstra_ctl/doctor.py +14 -0
- package/runtime/python/okstra_ctl/domain/host.py +32 -1
- package/runtime/python/okstra_ctl/domain/provider.py +212 -6
- package/runtime/python/okstra_ctl/domain/role.py +125 -0
- package/runtime/python/okstra_ctl/domain/wizard/interaction.py +13 -0
- package/runtime/python/okstra_ctl/domain/worker_exec.py +34 -1
- package/runtime/python/okstra_ctl/domain/worker_role.py +13 -3
- package/runtime/python/okstra_ctl/domain/worker_stream.py +24 -0
- package/runtime/python/okstra_ctl/error_log_write.py +9 -0
- package/runtime/python/okstra_ctl/error_report.py +21 -1
- package/runtime/python/okstra_ctl/execution_identity.py +529 -0
- package/runtime/python/okstra_ctl/execution_manifest.py +1281 -0
- package/runtime/python/okstra_ctl/execution_mutation_audit.py +619 -0
- package/runtime/python/okstra_ctl/index.py +6 -2
- package/runtime/python/okstra_ctl/initial_prompt_materialization.py +43 -3
- package/runtime/python/okstra_ctl/legacy_model_selection.py +490 -0
- package/runtime/python/okstra_ctl/model_cli.py +278 -0
- package/runtime/python/okstra_ctl/model_defaults.py +46 -0
- package/runtime/python/okstra_ctl/model_discovery.py +26 -7
- package/runtime/python/okstra_ctl/model_pool.py +501 -0
- package/runtime/python/okstra_ctl/models.py +47 -27
- package/runtime/python/okstra_ctl/mutation_recovery.py +293 -0
- package/runtime/python/okstra_ctl/pane_title.py +151 -0
- package/runtime/python/okstra_ctl/ports/host_model.py +48 -17
- package/runtime/python/okstra_ctl/ports/worker_dispatch.py +4 -0
- package/runtime/python/okstra_ctl/registry/provider_registry.py +8 -4
- package/runtime/python/okstra_ctl/render.py +78 -10
- package/runtime/python/okstra_ctl/render_final_report.py +19 -0
- package/runtime/python/okstra_ctl/report_contract.py +39 -0
- package/runtime/python/okstra_ctl/report_finalize.py +16 -0
- package/runtime/python/okstra_ctl/report_html/render.py +1 -0
- package/runtime/python/okstra_ctl/role_requirements.py +217 -0
- package/runtime/python/okstra_ctl/run.py +1207 -258
- package/runtime/python/okstra_ctl/run_index_row.py +7 -1
- package/runtime/python/okstra_ctl/time_report.py +38 -4
- package/runtime/python/okstra_ctl/usage_identity.py +86 -0
- package/runtime/python/okstra_ctl/usage_report.py +15 -3
- package/runtime/python/okstra_ctl/wizard.py +1253 -62
- package/runtime/python/okstra_ctl/worker_audit_ledger.py +68 -65
- package/runtime/python/okstra_ctl/worker_request.py +7 -1
- package/runtime/python/okstra_ctl/worker_runner.py +130 -5
- package/runtime/python/okstra_ctl/workers.py +7 -5
- package/runtime/python/okstra_ctl/write_policy.py +571 -0
- package/runtime/schemas/convergence-groups-v2.0.schema.json +128 -0
- package/runtime/schemas/execution-manifest-v2.schema.json +340 -0
- package/runtime/schemas/final-report-v2.0.schema.json +25 -0
- package/runtime/skills/okstra-run/SKILL.md +9 -9
- package/runtime/templates/report-writer-prompt-preamble.md +2 -0
- package/runtime/templates/reports/final-report-v2.template.md +7 -1
- package/runtime/templates/reports/html/base.template.html +21 -0
- package/runtime/templates/reports/html/i18n/en.json +4 -0
- package/runtime/templates/reports/html/i18n/ko.json +4 -0
- package/runtime/templates/worker-prompt-preamble.md +6 -2
- package/runtime/validators/lib/fixtures.sh +49 -16
- package/runtime/validators/validate-run.py +429 -35
- package/runtime/validators/validate_session_conformance.py +25 -7
- package/src/cli-registry.mjs +0 -539
- package/src/commands/execute/codex-dispatch.mjs +0 -10
- package/src/commands/execute/plan-items.mjs +0 -9
- package/src/commands/execute/plan-validate.mjs +0 -68
- package/src/commands/execute/run.mjs +0 -208
- package/src/commands/execute/wizard.mjs +0 -167
- package/src/commands/inspect/stage-map.mjs +0 -98
- package/src/commands/inspect/task-list.mjs +0 -97
- package/src/commands/inspect/task-show.mjs +0 -100
- package/src/commands/lifecycle/check-project.mjs +0 -187
- package/src/commands/lifecycle/config.mjs +0 -385
- package/src/commands/lifecycle/doctor.mjs +0 -308
- package/src/commands/lifecycle/install.mjs +0 -1170
- package/src/commands/lifecycle/paths.mjs +0 -104
- package/src/commands/lifecycle/preflight.mjs +0 -125
- package/src/commands/lifecycle/setup.mjs +0 -333
- package/src/commands/lifecycle/uninstall.mjs +0 -279
- package/src/commands/memory/memory.mjs +0 -524
- package/src/commands/pr/pr.mjs +0 -261
- package/src/lib/host-registry-client.mjs +0 -176
- package/src/lib/paths.mjs +0 -86
- package/src/lib/proc.mjs +0 -31
- package/src/lib/python-helper.mjs +0 -142
- package/src/lib/runtime-manifest.mjs +0 -70
- package/src/lib/skill-catalog.mjs +0 -53
- package/src/lib/version.mjs +0 -20
- /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.
|
|
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
|
-
"
|
|
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": ">=
|
|
33
|
+
"node": ">=22"
|
|
34
34
|
},
|
|
35
35
|
"scripts": {
|
|
36
|
-
"build": "
|
|
37
|
-
"
|
|
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
|
}
|
package/runtime/BUILD.json
CHANGED
|
@@ -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
|
|
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-
|
|
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
|
|
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=
|
|
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)
|
package/runtime/bin/okstra.sh
CHANGED
|
@@ -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
|
|
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.
|
|
110
|
-
1. Run `okstra convergence seed --groups <groups> --work-state <work> --final-state <final> --migration-dir <state/migrations
|
|
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.
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
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 `
|
|
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".
|