okstra 0.231.1 → 0.233.0
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 +19 -271
- package/dist/cli-registry.mjs +14 -1
- package/dist/cli-registry.mjs.map +1 -1
- package/dist/commands/execute/render-bundle.d.mts +6 -1
- package/dist/commands/execute/render-bundle.mjs +139 -32
- package/dist/commands/execute/render-bundle.mjs.map +1 -1
- package/dist/commands/lifecycle/config.mjs +6 -74
- package/dist/commands/lifecycle/config.mjs.map +1 -1
- package/dist/commands/memory/memory.mjs +9 -55
- package/dist/commands/memory/memory.mjs.map +1 -1
- package/dist/commands/trace/capacity.d.mts +12 -0
- package/dist/commands/trace/capacity.mjs +21 -0
- package/dist/commands/trace/capacity.mjs.map +1 -0
- package/dist/commands/trace/model.d.mts +89 -0
- package/dist/commands/trace/model.mjs +251 -0
- package/dist/commands/trace/model.mjs.map +1 -0
- package/dist/commands/trace/progression.d.mts +11 -0
- package/dist/commands/trace/progression.mjs +194 -0
- package/dist/commands/trace/progression.mjs.map +1 -0
- package/dist/commands/trace/review.d.mts +7 -0
- package/dist/commands/trace/review.mjs +51 -0
- package/dist/commands/trace/review.mjs.map +1 -0
- package/dist/commands/trace/task-link.d.mts +18 -0
- package/dist/commands/trace/task-link.mjs +72 -0
- package/dist/commands/trace/task-link.mjs.map +1 -0
- package/dist/commands/trace/trace.d.mts +1 -0
- package/dist/commands/trace/trace.mjs +293 -0
- package/dist/commands/trace/trace.mjs.map +1 -0
- package/dist/lib/bounded-file.d.mts +1 -0
- package/dist/lib/bounded-file.mjs +36 -0
- package/dist/lib/bounded-file.mjs.map +1 -0
- package/dist/lib/config-store.d.mts +34 -0
- package/dist/lib/config-store.mjs +70 -0
- package/dist/lib/config-store.mjs.map +1 -0
- package/dist/lib/file-lock.mjs +4 -5
- package/dist/lib/file-lock.mjs.map +1 -1
- package/dist/lib/input-limit.d.mts +4 -0
- package/dist/lib/input-limit.mjs +8 -0
- package/dist/lib/input-limit.mjs.map +1 -0
- package/dist/lib/memory-auto-register.d.mts +1 -0
- package/dist/lib/memory-auto-register.mjs +98 -0
- package/dist/lib/memory-auto-register.mjs.map +1 -0
- package/dist/lib/memory-entry-contract.d.mts +12 -0
- package/dist/lib/memory-entry-contract.mjs +46 -0
- package/dist/lib/memory-entry-contract.mjs.map +1 -0
- package/dist/lib/python-helper.d.mts +1 -1
- package/dist/lib/python-helper.mjs +3 -2
- package/dist/lib/python-helper.mjs.map +1 -1
- package/dist/lib/record-secrets.d.mts +1 -0
- package/dist/lib/record-secrets.mjs +28 -0
- package/dist/lib/record-secrets.mjs.map +1 -0
- package/dist/lib/report-language-tag.d.mts +1 -0
- package/dist/lib/report-language-tag.mjs +4 -0
- package/dist/lib/report-language-tag.mjs.map +1 -0
- package/dist/lib/report-language.d.mts +1 -0
- package/dist/lib/report-language.mjs +50 -0
- package/dist/lib/report-language.mjs.map +1 -0
- package/dist/lib/skill-catalog.mjs +3 -0
- package/dist/lib/skill-catalog.mjs.map +1 -1
- package/dist/lib/types.d.mts +2 -1
- package/docs/architecture/storage-model.md +163 -5
- package/docs/architecture.md +17 -4
- package/docs/cli.md +511 -0
- package/docs/contributor-change-matrix.md +1 -2
- package/docs/project-structure-overview.md +33 -42
- package/package.json +1 -1
- package/runtime/BUILD.json +2 -2
- package/runtime/agents/common.json +8 -8
- package/runtime/agents/operations/trace-interface-review.json +6 -0
- package/runtime/agents/operations/trace-scope-review.json +6 -0
- package/runtime/agents/roles/verifier.json +2 -4
- package/runtime/bin/okstra-provider-exec.py +10 -4
- package/runtime/prompts/coding-preflight/architectures/hexagonal.md +23 -30
- package/runtime/prompts/coding-preflight/authoring-checks.md +17 -0
- package/runtime/prompts/coding-preflight/clean-code.md +88 -286
- package/runtime/prompts/coding-preflight/frameworks/node-server.md +2 -3
- package/runtime/prompts/coding-preflight/languages/java.md +3 -5
- package/runtime/prompts/coding-preflight/languages/javascript-typescript.md +5 -12
- package/runtime/prompts/coding-preflight/languages/kotlin.md +2 -4
- package/runtime/prompts/coding-preflight/languages/python.md +2 -7
- package/runtime/prompts/coding-preflight/languages/rust.md +2 -8
- package/runtime/prompts/coding-preflight/languages/sql.md +2 -4
- package/runtime/prompts/coding-preflight/overview.md +25 -38
- package/runtime/prompts/coding-preflight/review-rules.json +30 -0
- package/runtime/prompts/duties/code-reviewer.json +15 -18
- package/runtime/prompts/duties/implementation-verifier.json +1 -0
- package/runtime/prompts/duties/interface-reviewer.json +32 -0
- package/runtime/prompts/host-orchestration/README.md +18 -9
- package/runtime/prompts/launch.template.md +3 -2
- package/runtime/prompts/lead/context-loader.md +2 -0
- package/runtime/prompts/lead/okstra-lead-contract.md +7 -7
- package/runtime/prompts/lead/report-writer.md +6 -6
- package/runtime/prompts/profiles/_coding-conventions-preflight.md +41 -6
- package/runtime/prompts/profiles/_common-contract.md +1 -1
- package/runtime/python/okstra_ctl/agent/invocation.py +122 -36
- package/runtime/python/okstra_ctl/agent/prompt_cli/cli.py +72 -26
- package/runtime/python/okstra_ctl/agent/prompt_cli/corrections.py +23 -8
- package/runtime/python/okstra_ctl/agent/prompt_cli/materialize.py +58 -14
- package/runtime/python/okstra_ctl/agent/prompt_cli/results.py +8 -11
- package/runtime/python/okstra_ctl/agent/standalone.py +15 -0
- package/runtime/python/okstra_ctl/analysis_packet.py +24 -30
- package/runtime/python/okstra_ctl/attempt_evidence.py +10 -0
- package/runtime/python/okstra_ctl/code_review_census.py +162 -7
- package/runtime/python/okstra_ctl/code_review_coverage.py +4 -274
- package/runtime/python/okstra_ctl/code_review_integrity.py +154 -0
- package/runtime/python/okstra_ctl/code_review_invocation.py +212 -0
- package/runtime/python/okstra_ctl/code_review_prepare.py +381 -0
- package/runtime/python/okstra_ctl/code_review_run.py +384 -0
- package/runtime/python/okstra_ctl/code_review_scope.py +49 -9
- package/runtime/python/okstra_ctl/code_review_supervisor.py +41 -0
- package/runtime/python/okstra_ctl/code_review_target.py +212 -13
- package/runtime/python/okstra_ctl/consumers.py +12 -9
- package/runtime/python/okstra_ctl/coverage_census.py +11 -2
- package/runtime/python/okstra_ctl/design_review.py +207 -0
- package/runtime/python/okstra_ctl/design_review_evidence.py +297 -0
- package/runtime/python/okstra_ctl/design_snapshot.py +16 -9
- package/runtime/python/okstra_ctl/direct_work.py +45 -3
- package/runtime/python/okstra_ctl/dispatch_core.py +31 -15
- package/runtime/python/okstra_ctl/dispatch_state.py +9 -2
- package/runtime/python/okstra_ctl/doctor.py +8 -25
- package/runtime/python/okstra_ctl/domain/role.py +1 -0
- package/runtime/python/okstra_ctl/doyouknow/__init__.py +9 -0
- package/runtime/python/okstra_ctl/doyouknow/cli.py +91 -0
- package/runtime/python/okstra_ctl/doyouknow/config.py +58 -0
- package/runtime/python/okstra_ctl/doyouknow/contracts.py +184 -0
- package/runtime/python/okstra_ctl/doyouknow/identity.py +22 -0
- package/runtime/python/okstra_ctl/doyouknow/paths.py +22 -0
- package/runtime/python/okstra_ctl/doyouknow/pending.py +72 -0
- package/runtime/python/okstra_ctl/doyouknow/registration.py +260 -0
- package/runtime/python/okstra_ctl/doyouknow/source_contracts.py +128 -0
- package/runtime/python/okstra_ctl/doyouknow/source_store.py +172 -0
- package/runtime/python/okstra_ctl/doyouknow/sources/io.py +36 -0
- package/runtime/python/okstra_ctl/doyouknow/sources/manager.py +300 -0
- package/runtime/python/okstra_ctl/doyouknow/sources/memory.py +179 -0
- package/runtime/python/okstra_ctl/doyouknow/sources/task.py +95 -0
- package/runtime/python/okstra_ctl/doyouknow/store.py +260 -0
- package/runtime/python/okstra_ctl/doyouknow/sync.py +58 -0
- package/runtime/python/okstra_ctl/execution_mutation_audit.py +18 -2
- package/runtime/python/okstra_ctl/file_size_cap.py +3 -4
- package/runtime/python/okstra_ctl/final_report_schema.py +37 -34
- package/runtime/python/okstra_ctl/incremental_carry.py +6 -7
- package/runtime/python/okstra_ctl/initial_prompt_materialization.py +9 -2
- package/runtime/python/okstra_ctl/json_boundary.py +51 -5
- package/runtime/python/okstra_ctl/jsonl.py +21 -0
- package/runtime/python/okstra_ctl/manager_cli.py +148 -1
- package/runtime/python/okstra_ctl/manager_journal.py +126 -0
- package/runtime/python/okstra_ctl/manager_launch.py +3 -3
- package/runtime/python/okstra_ctl/manager_log.py +221 -0
- package/runtime/python/okstra_ctl/manager_paths.py +8 -0
- package/runtime/python/okstra_ctl/manager_registration.py +29 -0
- package/runtime/python/okstra_ctl/manager_resume.py +59 -0
- package/runtime/python/okstra_ctl/manager_split.py +2 -2
- package/runtime/python/okstra_ctl/manager_store.py +116 -17
- package/runtime/python/okstra_ctl/manager_sync.py +45 -25
- package/runtime/python/okstra_ctl/manager_view.py +35 -2
- package/runtime/python/okstra_ctl/material.py +2 -0
- package/runtime/python/okstra_ctl/model_cli.py +64 -14
- package/runtime/python/okstra_ctl/model_defaults.py +22 -0
- package/runtime/python/okstra_ctl/model_io/renderers.py +16 -2
- package/runtime/python/okstra_ctl/model_io_cli.py +7 -1
- package/runtime/python/okstra_ctl/operation_invocation.py +207 -28
- package/runtime/python/okstra_ctl/path_hints.py +14 -3
- package/runtime/python/okstra_ctl/paths.py +6 -1
- package/runtime/python/okstra_ctl/phases/catalog.py +24 -7
- package/runtime/python/okstra_ctl/phases/final_verification/validation.py +20 -0
- package/runtime/python/okstra_ctl/phases/implementation/host-rules.md +3 -3
- package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-deliverable.md +10 -0
- package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-diff-review.md +23 -8
- package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-self-check.md +6 -4
- package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-verifier.md +38 -10
- package/runtime/python/okstra_ctl/phases/implementation/report_assets/implementation.template.html +13 -0
- package/runtime/python/okstra_ctl/phases/implementation/spec.md +25 -0
- package/runtime/python/okstra_ctl/phases/implementation/validation.py +6 -0
- package/runtime/python/okstra_ctl/phases/implementation_option_selection/profile.md +1 -1
- package/runtime/python/okstra_ctl/phases/implementation_option_selection/votes.py +11 -11
- package/runtime/python/okstra_ctl/phases/implementation_planning/authoring.py +16 -9
- package/runtime/python/okstra_ctl/phases/implementation_planning/host-rules.md +3 -6
- package/runtime/python/okstra_ctl/phases/implementation_planning/instructions/plan-body-verification.md +12 -10
- package/runtime/python/okstra_ctl/phases/implementation_planning/profile.md +6 -6
- package/runtime/python/okstra_ctl/phases/improvement_discovery/lenses.py +12 -0
- package/runtime/python/okstra_ctl/phases/improvement_discovery/profile.md +7 -6
- package/runtime/python/okstra_ctl/phases/improvement_discovery/resolved_census.py +159 -0
- package/runtime/python/okstra_ctl/phases/improvement_discovery/spec.md +5 -2
- package/runtime/python/okstra_ctl/phases/improvement_discovery/validation.py +21 -7
- package/runtime/python/okstra_ctl/phases/release_handoff/boundary.json +1 -1
- package/runtime/python/okstra_ctl/phases/release_handoff/profile.md +4 -1
- package/runtime/python/okstra_ctl/plan_verify_cli.py +6 -4
- package/runtime/python/okstra_ctl/render.py +28 -2
- package/runtime/python/okstra_ctl/report_assembly.py +53 -11
- package/runtime/python/okstra_ctl/report_contract.py +26 -0
- package/runtime/python/okstra_ctl/report_corrections.py +36 -20
- package/runtime/python/okstra_ctl/report_inputs.py +1 -0
- package/runtime/python/okstra_ctl/report_language.py +4 -1
- package/runtime/python/okstra_ctl/report_narrative.py +182 -7
- package/runtime/python/okstra_ctl/report_projections.py +64 -18
- package/runtime/python/okstra_ctl/report_synthesis_packet.py +97 -38
- package/runtime/python/okstra_ctl/review_policy.py +359 -0
- package/runtime/python/okstra_ctl/review_verdicts.py +291 -0
- package/runtime/python/okstra_ctl/run.py +67 -36
- package/runtime/python/okstra_ctl/run_context.py +10 -1
- package/runtime/python/okstra_ctl/set_work_status.py +4 -15
- package/runtime/python/okstra_ctl/stage_done.py +11 -0
- package/runtime/python/okstra_ctl/standalone_review_audit.py +28 -0
- package/runtime/python/okstra_ctl/task_list_cli.py +34 -8
- package/runtime/python/okstra_ctl/task_query.py +239 -0
- package/runtime/python/okstra_ctl/trace_review.py +264 -0
- package/runtime/python/okstra_ctl/trace_tasks.py +197 -0
- package/runtime/python/okstra_ctl/user_authorization.py +14 -0
- package/runtime/python/okstra_ctl/verification_generation.py +23 -1
- package/runtime/python/okstra_ctl/verification_input_types.py +15 -1
- package/runtime/python/okstra_ctl/verification_inputs.py +28 -6
- package/runtime/python/okstra_ctl/verification_invocation.py +7 -1
- package/runtime/python/okstra_ctl/verification_target.py +2 -0
- package/runtime/python/okstra_ctl/wizard/confirmation.py +7 -3
- package/runtime/python/okstra_ctl/wizard/launch.py +52 -0
- package/runtime/python/okstra_ctl/wizard/launch_cli.py +39 -0
- package/runtime/python/okstra_ctl/wizard/outcome.py +17 -16
- package/runtime/python/okstra_ctl/wizard/registry.py +1 -1
- package/runtime/python/okstra_ctl/wizard/render.py +8 -0
- package/runtime/python/okstra_ctl/wizard/state.py +2 -1
- package/runtime/python/okstra_ctl/worker_prompt_headers.py +24 -9
- package/runtime/python/okstra_ctl/worker_runner.py +66 -10
- package/runtime/python/okstra_ctl/write_policy.py +34 -1
- package/runtime/python/okstra_project/__init__.py +2 -0
- package/runtime/python/okstra_project/dirs.py +18 -0
- package/runtime/python/okstra_project/state.py +45 -20
- package/runtime/python/okstra_token_usage/blocks.py +74 -0
- package/runtime/python/okstra_token_usage/cli.py +23 -10
- package/runtime/python/okstra_token_usage/collect.py +25 -22
- package/runtime/python/okstra_token_usage/policy.py +193 -0
- package/runtime/schemas/doyouknow-config-v1.schema.json +20 -0
- package/runtime/schemas/doyouknow-v1.schema.json +65 -0
- package/runtime/schemas/final-report-v2.0.schema.json +157 -0
- package/runtime/schemas/final-report-v3.0.schema.json +157 -0
- package/runtime/schemas/memory-entry-contract-v1.json +11 -0
- package/runtime/schemas/record-secret-patterns.json +41 -0
- package/runtime/schemas/report-synthesis-packet-v1.0.schema.json +1 -1
- package/runtime/skills/_fragments/wizard-confirm-step.md +1 -1
- package/runtime/skills/_fragments/wizard-preflight.md +1 -1
- package/runtime/skills/_fragments/wizard-prompt-loop.md +3 -5
- package/runtime/skills/_fragments/wizard-relay-protocol.md +1 -1
- package/runtime/skills/_fragments/wizard-render-bundle.md +15 -29
- package/runtime/skills/okstra-brief-gen/SKILL.md +7 -7
- package/runtime/skills/okstra-brief-gen/references/tracker-recursion.md +1 -1
- package/runtime/skills/okstra-code-review/SKILL.md +92 -136
- package/runtime/skills/okstra-code-review/references/census-rules.md +29 -105
- package/runtime/skills/okstra-code-review/references/review-calibration.md +37 -61
- package/runtime/skills/okstra-discussion/SKILL.md +22 -38
- package/runtime/skills/okstra-explain-flow/SKILL.md +6 -2
- package/runtime/skills/okstra-manager/SKILL.md +31 -0
- package/runtime/skills/okstra-memory/SKILL.md +8 -1
- package/runtime/skills/okstra-pr-gen/SKILL.md +1 -1
- package/runtime/skills/okstra-run/SKILL.md +55 -183
- package/runtime/skills/okstra-schedule-gen/SKILL.md +9 -13
- package/runtime/skills/okstra-setup/SKILL.md +3 -2
- package/runtime/skills/okstra-setup/references/project-config.md +2 -4
- package/runtime/skills/okstra-tdd/SKILL.md +187 -0
- package/runtime/skills/okstra-user-response/SKILL.md +4 -2
- package/runtime/templates/implementation-worker-preamble.md +4 -9
- package/runtime/templates/manager/view.template.html +4 -0
- package/runtime/templates/report-writer-prompt-preamble.md +15 -3
- package/runtime/templates/trace/trace.template.md +42 -0
- package/runtime/templates/worker-prompt-preamble.md +4 -12
- package/runtime/validators/checks/fixtures-02.py +25 -33
- package/runtime/validators/validate-run.py +107 -38
|
@@ -9883,6 +9883,10 @@
|
|
|
9883
9883
|
"not-run"
|
|
9884
9884
|
]
|
|
9885
9885
|
},
|
|
9886
|
+
"designReview": {
|
|
9887
|
+
"$ref": "#/$defs/DesignReviewRecord",
|
|
9888
|
+
"description": "Assembly-owned independent design-review evidence from the current sealed verifier result."
|
|
9889
|
+
},
|
|
9886
9890
|
"readOnlyCommandLog": {
|
|
9887
9891
|
"type": "string"
|
|
9888
9892
|
},
|
|
@@ -10591,6 +10595,159 @@
|
|
|
10591
10595
|
"minimum": 1
|
|
10592
10596
|
}
|
|
10593
10597
|
}
|
|
10598
|
+
},
|
|
10599
|
+
"DesignReviewRecord": {
|
|
10600
|
+
"type": "object",
|
|
10601
|
+
"additionalProperties": false,
|
|
10602
|
+
"required": [
|
|
10603
|
+
"collection",
|
|
10604
|
+
"generationNumber",
|
|
10605
|
+
"verdict"
|
|
10606
|
+
],
|
|
10607
|
+
"properties": {
|
|
10608
|
+
"collection": {
|
|
10609
|
+
"enum": [
|
|
10610
|
+
"complete",
|
|
10611
|
+
"incomplete"
|
|
10612
|
+
]
|
|
10613
|
+
},
|
|
10614
|
+
"generationNumber": {
|
|
10615
|
+
"type": "integer",
|
|
10616
|
+
"minimum": 1
|
|
10617
|
+
},
|
|
10618
|
+
"verdict": {
|
|
10619
|
+
"enum": [
|
|
10620
|
+
"PASS",
|
|
10621
|
+
"CONCERNS",
|
|
10622
|
+
"FAIL",
|
|
10623
|
+
"not-run"
|
|
10624
|
+
]
|
|
10625
|
+
},
|
|
10626
|
+
"reason": {
|
|
10627
|
+
"type": "string"
|
|
10628
|
+
},
|
|
10629
|
+
"head": {
|
|
10630
|
+
"type": "string"
|
|
10631
|
+
},
|
|
10632
|
+
"base": {
|
|
10633
|
+
"type": "string"
|
|
10634
|
+
},
|
|
10635
|
+
"policyDigest": {
|
|
10636
|
+
"type": "string"
|
|
10637
|
+
},
|
|
10638
|
+
"censusDigest": {
|
|
10639
|
+
"type": "string"
|
|
10640
|
+
},
|
|
10641
|
+
"invocationRef": {
|
|
10642
|
+
"type": "string"
|
|
10643
|
+
},
|
|
10644
|
+
"resultPath": {
|
|
10645
|
+
"type": "string"
|
|
10646
|
+
},
|
|
10647
|
+
"resultDigest": {
|
|
10648
|
+
"type": "string"
|
|
10649
|
+
},
|
|
10650
|
+
"scope": {
|
|
10651
|
+
"type": "string"
|
|
10652
|
+
},
|
|
10653
|
+
"generation": {
|
|
10654
|
+
"type": "object",
|
|
10655
|
+
"required": [
|
|
10656
|
+
"path",
|
|
10657
|
+
"digest"
|
|
10658
|
+
],
|
|
10659
|
+
"additionalProperties": false,
|
|
10660
|
+
"properties": {
|
|
10661
|
+
"path": {
|
|
10662
|
+
"type": "string"
|
|
10663
|
+
},
|
|
10664
|
+
"digest": {
|
|
10665
|
+
"type": "string"
|
|
10666
|
+
}
|
|
10667
|
+
}
|
|
10668
|
+
},
|
|
10669
|
+
"attempt": {
|
|
10670
|
+
"type": "integer",
|
|
10671
|
+
"minimum": 1
|
|
10672
|
+
},
|
|
10673
|
+
"expectedCells": {
|
|
10674
|
+
"type": "integer",
|
|
10675
|
+
"minimum": 0
|
|
10676
|
+
},
|
|
10677
|
+
"coveredCells": {
|
|
10678
|
+
"type": "integer",
|
|
10679
|
+
"minimum": 0
|
|
10680
|
+
},
|
|
10681
|
+
"missing": {
|
|
10682
|
+
"type": "object",
|
|
10683
|
+
"additionalProperties": {
|
|
10684
|
+
"type": "string"
|
|
10685
|
+
}
|
|
10686
|
+
},
|
|
10687
|
+
"unknown": {
|
|
10688
|
+
"type": "array",
|
|
10689
|
+
"items": {
|
|
10690
|
+
"type": "string"
|
|
10691
|
+
}
|
|
10692
|
+
},
|
|
10693
|
+
"blockingFindings": {
|
|
10694
|
+
"type": "array",
|
|
10695
|
+
"items": {
|
|
10696
|
+
"type": "string"
|
|
10697
|
+
}
|
|
10698
|
+
},
|
|
10699
|
+
"findings": {
|
|
10700
|
+
"type": "array",
|
|
10701
|
+
"items": {
|
|
10702
|
+
"type": "object",
|
|
10703
|
+
"additionalProperties": {
|
|
10704
|
+
"type": "string"
|
|
10705
|
+
}
|
|
10706
|
+
}
|
|
10707
|
+
},
|
|
10708
|
+
"carry": {
|
|
10709
|
+
"type": "array",
|
|
10710
|
+
"items": {
|
|
10711
|
+
"type": "object",
|
|
10712
|
+
"additionalProperties": {
|
|
10713
|
+
"type": "string"
|
|
10714
|
+
}
|
|
10715
|
+
}
|
|
10716
|
+
},
|
|
10717
|
+
"history": {
|
|
10718
|
+
"type": "array",
|
|
10719
|
+
"items": {
|
|
10720
|
+
"$ref": "#/$defs/DesignReviewRecord"
|
|
10721
|
+
}
|
|
10722
|
+
}
|
|
10723
|
+
},
|
|
10724
|
+
"if": {
|
|
10725
|
+
"properties": {
|
|
10726
|
+
"collection": {
|
|
10727
|
+
"const": "complete"
|
|
10728
|
+
}
|
|
10729
|
+
}
|
|
10730
|
+
},
|
|
10731
|
+
"then": {
|
|
10732
|
+
"required": [
|
|
10733
|
+
"head",
|
|
10734
|
+
"base",
|
|
10735
|
+
"policyDigest",
|
|
10736
|
+
"censusDigest",
|
|
10737
|
+
"generation",
|
|
10738
|
+
"invocationRef",
|
|
10739
|
+
"attempt",
|
|
10740
|
+
"resultPath",
|
|
10741
|
+
"resultDigest",
|
|
10742
|
+
"expectedCells",
|
|
10743
|
+
"coveredCells",
|
|
10744
|
+
"missing",
|
|
10745
|
+
"unknown",
|
|
10746
|
+
"findings",
|
|
10747
|
+
"blockingFindings",
|
|
10748
|
+
"scope"
|
|
10749
|
+
]
|
|
10750
|
+
}
|
|
10594
10751
|
}
|
|
10595
10752
|
}
|
|
10596
10753
|
}
|
|
@@ -10216,6 +10216,10 @@
|
|
|
10216
10216
|
"not-run"
|
|
10217
10217
|
]
|
|
10218
10218
|
},
|
|
10219
|
+
"designReview": {
|
|
10220
|
+
"$ref": "#/$defs/DesignReviewRecord",
|
|
10221
|
+
"description": "Assembly-owned independent design-review evidence from the current sealed verifier result."
|
|
10222
|
+
},
|
|
10219
10223
|
"readOnlyCommandLog": {
|
|
10220
10224
|
"type": "string"
|
|
10221
10225
|
},
|
|
@@ -11296,6 +11300,159 @@
|
|
|
11296
11300
|
"minimum": 1
|
|
11297
11301
|
}
|
|
11298
11302
|
}
|
|
11303
|
+
},
|
|
11304
|
+
"DesignReviewRecord": {
|
|
11305
|
+
"type": "object",
|
|
11306
|
+
"additionalProperties": false,
|
|
11307
|
+
"required": [
|
|
11308
|
+
"collection",
|
|
11309
|
+
"generationNumber",
|
|
11310
|
+
"verdict"
|
|
11311
|
+
],
|
|
11312
|
+
"properties": {
|
|
11313
|
+
"collection": {
|
|
11314
|
+
"enum": [
|
|
11315
|
+
"complete",
|
|
11316
|
+
"incomplete"
|
|
11317
|
+
]
|
|
11318
|
+
},
|
|
11319
|
+
"generationNumber": {
|
|
11320
|
+
"type": "integer",
|
|
11321
|
+
"minimum": 1
|
|
11322
|
+
},
|
|
11323
|
+
"verdict": {
|
|
11324
|
+
"enum": [
|
|
11325
|
+
"PASS",
|
|
11326
|
+
"CONCERNS",
|
|
11327
|
+
"FAIL",
|
|
11328
|
+
"not-run"
|
|
11329
|
+
]
|
|
11330
|
+
},
|
|
11331
|
+
"reason": {
|
|
11332
|
+
"type": "string"
|
|
11333
|
+
},
|
|
11334
|
+
"head": {
|
|
11335
|
+
"type": "string"
|
|
11336
|
+
},
|
|
11337
|
+
"base": {
|
|
11338
|
+
"type": "string"
|
|
11339
|
+
},
|
|
11340
|
+
"policyDigest": {
|
|
11341
|
+
"type": "string"
|
|
11342
|
+
},
|
|
11343
|
+
"censusDigest": {
|
|
11344
|
+
"type": "string"
|
|
11345
|
+
},
|
|
11346
|
+
"invocationRef": {
|
|
11347
|
+
"type": "string"
|
|
11348
|
+
},
|
|
11349
|
+
"resultPath": {
|
|
11350
|
+
"type": "string"
|
|
11351
|
+
},
|
|
11352
|
+
"resultDigest": {
|
|
11353
|
+
"type": "string"
|
|
11354
|
+
},
|
|
11355
|
+
"scope": {
|
|
11356
|
+
"type": "string"
|
|
11357
|
+
},
|
|
11358
|
+
"generation": {
|
|
11359
|
+
"type": "object",
|
|
11360
|
+
"required": [
|
|
11361
|
+
"path",
|
|
11362
|
+
"digest"
|
|
11363
|
+
],
|
|
11364
|
+
"additionalProperties": false,
|
|
11365
|
+
"properties": {
|
|
11366
|
+
"path": {
|
|
11367
|
+
"type": "string"
|
|
11368
|
+
},
|
|
11369
|
+
"digest": {
|
|
11370
|
+
"type": "string"
|
|
11371
|
+
}
|
|
11372
|
+
}
|
|
11373
|
+
},
|
|
11374
|
+
"attempt": {
|
|
11375
|
+
"type": "integer",
|
|
11376
|
+
"minimum": 1
|
|
11377
|
+
},
|
|
11378
|
+
"expectedCells": {
|
|
11379
|
+
"type": "integer",
|
|
11380
|
+
"minimum": 0
|
|
11381
|
+
},
|
|
11382
|
+
"coveredCells": {
|
|
11383
|
+
"type": "integer",
|
|
11384
|
+
"minimum": 0
|
|
11385
|
+
},
|
|
11386
|
+
"missing": {
|
|
11387
|
+
"type": "object",
|
|
11388
|
+
"additionalProperties": {
|
|
11389
|
+
"type": "string"
|
|
11390
|
+
}
|
|
11391
|
+
},
|
|
11392
|
+
"unknown": {
|
|
11393
|
+
"type": "array",
|
|
11394
|
+
"items": {
|
|
11395
|
+
"type": "string"
|
|
11396
|
+
}
|
|
11397
|
+
},
|
|
11398
|
+
"blockingFindings": {
|
|
11399
|
+
"type": "array",
|
|
11400
|
+
"items": {
|
|
11401
|
+
"type": "string"
|
|
11402
|
+
}
|
|
11403
|
+
},
|
|
11404
|
+
"findings": {
|
|
11405
|
+
"type": "array",
|
|
11406
|
+
"items": {
|
|
11407
|
+
"type": "object",
|
|
11408
|
+
"additionalProperties": {
|
|
11409
|
+
"type": "string"
|
|
11410
|
+
}
|
|
11411
|
+
}
|
|
11412
|
+
},
|
|
11413
|
+
"carry": {
|
|
11414
|
+
"type": "array",
|
|
11415
|
+
"items": {
|
|
11416
|
+
"type": "object",
|
|
11417
|
+
"additionalProperties": {
|
|
11418
|
+
"type": "string"
|
|
11419
|
+
}
|
|
11420
|
+
}
|
|
11421
|
+
},
|
|
11422
|
+
"history": {
|
|
11423
|
+
"type": "array",
|
|
11424
|
+
"items": {
|
|
11425
|
+
"$ref": "#/$defs/DesignReviewRecord"
|
|
11426
|
+
}
|
|
11427
|
+
}
|
|
11428
|
+
},
|
|
11429
|
+
"if": {
|
|
11430
|
+
"properties": {
|
|
11431
|
+
"collection": {
|
|
11432
|
+
"const": "complete"
|
|
11433
|
+
}
|
|
11434
|
+
}
|
|
11435
|
+
},
|
|
11436
|
+
"then": {
|
|
11437
|
+
"required": [
|
|
11438
|
+
"head",
|
|
11439
|
+
"base",
|
|
11440
|
+
"policyDigest",
|
|
11441
|
+
"censusDigest",
|
|
11442
|
+
"generation",
|
|
11443
|
+
"invocationRef",
|
|
11444
|
+
"attempt",
|
|
11445
|
+
"resultPath",
|
|
11446
|
+
"resultDigest",
|
|
11447
|
+
"expectedCells",
|
|
11448
|
+
"coveredCells",
|
|
11449
|
+
"missing",
|
|
11450
|
+
"unknown",
|
|
11451
|
+
"findings",
|
|
11452
|
+
"blockingFindings",
|
|
11453
|
+
"scope"
|
|
11454
|
+
]
|
|
11455
|
+
}
|
|
11299
11456
|
}
|
|
11300
11457
|
}
|
|
11301
11458
|
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 1,
|
|
3
|
+
"requiredStrings": ["id", "title", "type", "projectGroup", "source", "createdAt", "path"],
|
|
4
|
+
"stringArrays": ["tags", "relatedProjects"],
|
|
5
|
+
"nullableStrings": ["archivedAt"],
|
|
6
|
+
"optionalStrings": ["sourceKey"],
|
|
7
|
+
"enums": {
|
|
8
|
+
"type": ["context", "decision", "preference", "requirement", "person", "project-hint", "follow-up"],
|
|
9
|
+
"status": ["active", "archived"]
|
|
10
|
+
}
|
|
11
|
+
}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 1,
|
|
3
|
+
"patterns": [
|
|
4
|
+
{
|
|
5
|
+
"pattern": "-----BEGIN (?:RSA |EC |OPENSSH |DSA |PGP )?PRIVATE KEY-----",
|
|
6
|
+
"label": "private key block"
|
|
7
|
+
},
|
|
8
|
+
{
|
|
9
|
+
"pattern": "\\bAKIA[0-9A-Z]{16}\\b",
|
|
10
|
+
"label": "AWS access key id"
|
|
11
|
+
},
|
|
12
|
+
{
|
|
13
|
+
"pattern": "\\bASIA[0-9A-Z]{16}\\b",
|
|
14
|
+
"label": "AWS temporary access key id"
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
"pattern": "\\bgh[posru]_[A-Za-z0-9]{36,}\\b",
|
|
18
|
+
"label": "GitHub token"
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"pattern": "\\bgithub_pat_[A-Za-z0-9_]{60,}\\b",
|
|
22
|
+
"label": "GitHub fine-grained token"
|
|
23
|
+
},
|
|
24
|
+
{
|
|
25
|
+
"pattern": "\\bxox[baprs]-[A-Za-z0-9-]{10,}\\b",
|
|
26
|
+
"label": "Slack token"
|
|
27
|
+
},
|
|
28
|
+
{
|
|
29
|
+
"pattern": "\\bAIza[0-9A-Za-z_-]{35}\\b",
|
|
30
|
+
"label": "Google API key"
|
|
31
|
+
},
|
|
32
|
+
{
|
|
33
|
+
"pattern": "\\bsk-[A-Za-z0-9]{20,}\\b",
|
|
34
|
+
"label": "OpenAI-style secret key"
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"pattern": "(?<![A-Za-z0-9_-])(?=[A-Za-z0-9_-]*\\.[A-Za-z0-9_-]{8,}\\.[A-Za-z0-9_-]{8,})(?:[A-Za-z0-9_-]*-)?eyJ[A-Za-z0-9_-]{8,}\\.",
|
|
38
|
+
"label": "JWT"
|
|
39
|
+
}
|
|
40
|
+
]
|
|
41
|
+
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
## Step 4: The confirm step's question text is the selection summary
|
|
2
2
|
|
|
3
|
-
When `next.step == "confirm"`, the prompt's `label` already carries the full selection summary (`선택 확인:` followed by one line per resolved input — task-type, task-key, brief, base-ref, worktree, every role slot, directive, related-tasks, clarification, stage, …) and ends with the question. Render that `label` **verbatim, every line, as the question text** of the `confirm` picker (Proceed / Edit / Abort) — the same way you render any other pick step's label. Do not re-author it as a table, do not summarise it into prose, do not drop a line because its value is `(none)`: the user confirms what is on screen, and a line you left out is a setting they never saw
|
|
3
|
+
When `next.step == "confirm"`, the prompt's `label` already carries the full selection summary (`선택 확인:` followed by one line per resolved input — task-type, task-key, brief, base-ref, worktree, every role slot, directive, related-tasks, clarification, stage, …) and ends with the question. Render that `label` **verbatim, every line, as the question text** of the `confirm` picker (Proceed / Edit / Abort) — the same way you render any other pick step's label. Do not re-author it as a table, do not summarise it into prose, do not drop a line because its value is `(none)`: the user confirms what is on screen, and a line you left out is a setting they never saw. Render the picker **as the final output of that turn** — emit nothing after the picker call.
|
|
4
4
|
|
|
5
5
|
`okstra wizard confirmation --state-file <path>` returns the same block as `{ok: true, text: ...}` for a text-only host or when the user asks to see the summary again; it is not a substitute for the label.
|
|
6
6
|
|
|
@@ -12,7 +12,7 @@ Run one shell-command tool call (Shell invocation rule from the top of this file
|
|
|
12
12
|
okstra preflight --runtime <host-runtime>
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
-
Read the fixed text lines. If the first line is `Okstra preflight: failed`, show `Runtime readiness` and every repeated `Readiness check`, `Readiness check status`, and `Readiness check action`, then stop before Step 2. Show `Reason` and `Recovery` for every failure. Do not relabel a host login, license, daemon, trust, or other readiness failure as missing Okstra setup. If the call fails with `unknown command: preflight`, the `okstra` binary on PATH predates this skill — tell the user to update it (`npm i -g okstra@latest`), then stop (`/okstra-setup` does not update the binary). Do **not** try to invoke `npx -y okstra@latest ...` as a fallback —
|
|
15
|
+
Read the fixed text lines. If the first line is `Okstra preflight: failed`, show `Runtime readiness` and every repeated `Readiness check`, `Readiness check status`, and `Readiness check action`, then stop before Step 2. Show `Reason` and `Recovery` for every failure. Do not relabel a host login, license, daemon, trust, or other readiness failure as missing Okstra setup. If the call fails with `unknown command: preflight`, the `okstra` binary on PATH predates this skill — tell the user to update it (`npm i -g okstra@latest`), then stop (`/okstra-setup` does not update the binary). Do **not** try to invoke `npx -y okstra@latest ...` as a fallback — every later wizard call still invokes the stale `okstra` on PATH, so an `npx` call does not recover the run. Every subsequent `okstra <subcmd>` call self-bootstraps its Python path, so never `export PYTHONPATH=...`.
|
|
16
16
|
|
|
17
17
|
On `Okstra preflight: ready`, require `Runtime readiness: ready` before Step 2. These checks come from the selected host adapter and are independent of worker-provider choices. Any other readiness value is unrecognized runtime output: show it and stop before Step 2 instead of guessing that the host is ready.
|
|
18
18
|
|
|
@@ -8,15 +8,13 @@ Repeat until `next.kind == "done"` (or `"aborted"` — terminal cancel, see "How
|
|
|
8
8
|
```
|
|
9
9
|
If the answer contains spaces or shell metacharacters, wrap it in double quotes around the literal string only — never inside `"$VAR"`.
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
Pass `--answer` even when the user's reply is empty:
|
|
12
12
|
```bash
|
|
13
13
|
okstra wizard step --state-file /var/folders/.../okstra-wizard.AbCd.json --answer ""
|
|
14
14
|
```
|
|
15
|
-
|
|
15
|
+
Without `--answer` or `--no-submit`, `wizard step` returns `ok: false` naming `--answer`, exits 2 and submits nothing, so `--answer ""` is the only way past an intentionally blank step (e.g. "use phase default"). If the literal answer contains `"`, escape each occurrence as `\"` inside the double-quoted argument.
|
|
16
16
|
|
|
17
|
-
**
|
|
18
|
-
|
|
19
|
-
**Enforced:** `tests-js/wizard.test.mjs` pins `parseFlags` on the empty literal (`--answer=` parses to the empty string, a value beginning with `--` is kept) and on the `--no-submit` peek that is the only sanctioned way to see the current prompt without submitting; the Node wrapper (`src/commands/execute/wizard.mts`) is what forwards them to Python.
|
|
17
|
+
**Not enforced:** no test pins the empty-literal parsing or the `--no-submit` peek; the Node wrapper (`src/commands/execute/wizard.mts`) forwards both flags to Python.
|
|
20
18
|
3. **Handle result**:
|
|
21
19
|
- `ok: true` → echo `result.echo` to the user on one short line, then loop with `result.next`.
|
|
22
20
|
- `ok: false` → show `result.error` to the user verbatim, then loop with `result.current` (re-prompt the same step). If `result.current` is `null`, do not loop — the current step cannot render (e.g. corrupt Stage Map); surface the error and stop so the user fixes the plan.
|
|
@@ -35,6 +35,6 @@ Submit the answer shape required by `interaction.answerProtocol`; do not add nor
|
|
|
35
35
|
|
|
36
36
|
The final `confirm` step is a normal `pick` step with three options — `Proceed` / `Edit` / `Abort`(abort) — and is rendered the same way (no special handling). `Edit` rewinds to any earlier step (including `base-ref`); `Abort` terminally cancels the wizard. The branch/worktree decision the run will actually use (for `implementation`, the **stage worktree** — not the task-key directory) is folded into the Step 4 confirmation summary block as a `worktree` line, so there is no separate branch-confirm prompt.
|
|
37
37
|
|
|
38
|
-
Never invent additional questions.
|
|
38
|
+
Never invent additional questions. Relay every `pick` / `pick_group` option the wizard sends, in order, including the flagged recommendation: the wizard's arrays are the complete choice set whatever the host UI's usual option limit, and the run-prompt recommendation rule (1–2 recommendations + Enter directly) applies only to prompts this skill authors itself. It does not excuse you from recommending: before relaying a wizard step whose answer turns on something readable (the carried report, the sidecar the user already wrote, the prior Stage Map), read it, put what you found in the question body, and name which of the wizard's own options you recommend and why. Relaying a step with no context and no recommendation hands the whole question back to the user — see the lifecycle core contract "Asking the user (BLOCKING)".
|
|
39
39
|
|
|
40
40
|
**One recommendation, shown in one place, and it is option 1.** Wizard labels carry no recommendation marker of their own. The option carrying `recommended: true` is what this run computed, and the wizard already placed it first — except on model-selection steps (`role-models:*`, `role-model:*`), which keep provider display order, so the flagged model may sit anywhere in the list. Append ` (추천)` to that option's label when you render it, and to no other. A checkbox step (`multi: true`) may flag several leading options: they are the recommended set, rendered the same way. Your prose recommendation names one of the flagged options. If you believe a different option is right, do not quietly recommend it in prose while the flagged one still reads as recommended on screen: say you disagree, name both, and let the user pick. When no option carries the flag, the run computed nothing for this step — recommend one from what you read and mark that one, and do not present the first option as a default just because it is first. **Enforced:** `scripts/okstra_ctl/wizard/state.py` `Prompt.__post_init__` refuses a step whose free-input option is not last, whose single-select recommendation is not exactly one option, whose recommendation is not placed first on a single-select step or is not the leading run on a checkbox step (both position checks are skipped on `role-models:*` / `role-model:*` steps), or that marks the free-input / abort escape as a recommendation.
|
|
@@ -6,51 +6,35 @@ When `next.kind == "done"`, fetch the public wizard outcome:
|
|
|
6
6
|
okstra wizard outcome --state-file /var/folders/.../okstra-wizard.AbCd.json
|
|
7
7
|
```
|
|
8
8
|
|
|
9
|
-
Output: `{ok: true, outcome: {renderArgv: ["--lead-runtime", "...", ...], renderArgs: {...}, orchestration: {chainStages: "..."}, persistActions: [...], confirmationText: "..."}}`.
|
|
9
|
+
Output: `{ok: true, outcome: {renderArgv: ["--lead-runtime", "...", ...], renderArgs: {...}, orchestration: {chainStages: "...", hostRulesPath: "..."}, persistActions: [...], confirmationText: "..."}}`.
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
Use the outcome to inspect the confirmed scope and `orchestration.chainStages`. `renderArgv` and `renderArgs` remain compatibility and inspection views; do not copy their tokens into a command. Bundle preparation reads the confirmed state file directly and preserves empty values and repeated role/model flags in code. `orchestration` holds signals this skill acts on itself — never pass its entries to `render-bundle`.
|
|
12
12
|
|
|
13
|
-
`
|
|
13
|
+
Before the first `render-bundle` invocation, read `outcome.orchestration.hostRulesPath` verbatim when it is non-empty. The wizard selects and checks this absolute runtime path; it contains the selected task's waiver, recovery, and chaining rules needed even when preparation fails. An empty string means this task declares no host rules. Use the emitted path rather than constructing one from the task type.
|
|
14
14
|
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
Run every `outcome.persistActions[]` entry BEFORE `render-bundle`. The only supported action is:
|
|
15
|
+
After successful preparation, use the frozen `instruction-set/host-orchestration-rules.md` identified by the rendered launch prompt for resumed work and stage chaining. Read that frozen copy within the run as the launch prompt requires: reading the canonical file before preparation does not satisfy the implementation session read gate. An already prepared legacy run without the new outcome field keeps its existing skill and prepared-instruction contract. If a fresh outcome omits `hostRulesPath` or its non-empty path cannot be read, stop and report a runtime/skill version mismatch; do not infer waiver or recovery rules.
|
|
18
16
|
|
|
19
|
-
|
|
20
|
-
{"command":"config.set","key":"pr-template-path","scope":"project|global","value":"<path>"}
|
|
21
|
-
```
|
|
17
|
+
`userAuthorization`, when present, preserves the confirmation prompt actually emitted by this wizard and the relayed `proceed` response. Preparation carries that record into the run manifest unchanged. Do not synthesize a receipt for older confirmed states. The record documents task scope; it does not grant host execution privileges.
|
|
22
18
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
okstra config set pr-template-path "<value>" --scope project
|
|
27
|
-
okstra config set pr-template-path "<value>" --scope global
|
|
28
|
-
```
|
|
19
|
+
Before retrying a worker in an existing run, inspect its last invocation attempt: await running work; append an attempt only after `failed-no-mutation` within the retry budget. Preserve every other terminal attempt. `okstra team dispatch` routes the legacy declaration-only implementer failure to a separate same-model evidence-recovery invocation; collect its result before independent verification. Other terminal failures need `okstra agent-prompt materialize` with a new `--invocation-id`, distinct `--prompt`/`--result` paths, and unchanged assignment/model for a bounded correction. Do not restart completed implementation or request renewed approval for unchanged scope. Enforcement: `dispatch_core._next_attempt` and `execution_manifest._validate_next_attempt`.
|
|
29
20
|
|
|
30
|
-
|
|
21
|
+
`render-bundle --wizard-state-file` applies the confirmed PR-template save action before preparing the bundle. Do not execute `outcome.persistActions[]` separately. An unknown action, missing save authorization, or changed save scope stops preparation before settings are written. If an older confirmation did not record the save scope, reopen that confirmation rather than inventing a receipt. A settings write failure stops preparation; a later preparation failure reports that the successful settings write remains saved.
|
|
31
22
|
|
|
32
23
|
Before rendering the next phase's bundle — and between worker rounds within a phase (reverify/critic/gapverify batches), after you have collected that round's results and token usage and before you dispatch the next round — close the panes of the dispatches that finished in the prior round so they do not accumulate: `okstra team reclaim --project-root <projectRoot> --run-manifest <RUN_MANIFEST_PATH>` closes them, records `phase-batch-cleanup panes=<n>` with the number it closed, and prints that `PROGRESS:` line last — emit it as printed and do not call `okstra lead-progress append` for it. The command reads each dispatch's recorded status, so an in-progress worker keeps its pane whichever moment you call it. It closes only the panes okstra opened and recorded — a pane the harness opened for its own teammate carries no recorded id and is not okstra's to close. After collecting results and token usage, apply the selected adapter's `shutdown_workers` operation only to confirmed-complete workers; preserve in-flight workers and the lead. A `cli-wrapper` run holds no pane at all and `team reclaim` refuses it, so record the checkpoint there with `okstra lead-progress append … --phase phase-batch-cleanup --field panes=0`.
|
|
33
24
|
|
|
34
25
|
Before you ask the user for any approval, clarification, or decision after workers have been dispatched, run `okstra team reclaim … --gate` first: it closes the finished panes and prints `PROGRESS: phase-gate-cleanup panes=<n>` for you to emit, without recording a batch cleanup. Then apply the selected adapter's `shutdown_workers` operation to confirmed-complete workers after collecting their results and token usage; preserve in-flight workers and the lead. This keeps a user gate from being shown while finished worker panes remain; in-progress dispatches keep their panes. Then follow `prompts/lead/okstra-lead-contract.md` "User confirmation before an approval blocker": read cited plan items, worker findings, and files before asking, and ask in the user's language with each option's outcome.
|
|
35
26
|
|
|
36
|
-
|
|
27
|
+
Prepare the bundle with the same literal absolute state-file path used by the wizard. Do not append scope inputs such as task type, role/model, directive, or lead runtime; the command rejects mixing those inputs with `--wizard-state-file`.
|
|
37
28
|
|
|
38
29
|
Before invoking it, follow the active host relay's execution-permission guidance. For Codex, read "Permission before bundle preparation" in the relay already selected at preflight: bundle preparation can write protected Git metadata while creating a branch and worktree, even with `--render-only`. Apply this guidance to the first invocation and each subsequent phase or stage preparation.
|
|
39
30
|
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
Step 3's empty-answer and escaping rules apply verbatim: every flag in `renderArgv` whose following value is the empty string MUST still be passed explicitly (e.g. `--related-tasks ""`, `--directive ""`) — the wizard's intent is always "flag present with empty value", even where prepare's default happens to be the same empty value.
|
|
43
|
-
|
|
44
|
-
`renderArgv` already contains exactly one `--lead-runtime <host-runtime>` pair. Do not add or replace it. Do not enumerate a fixed provider list in this skill because the wizard and role model pool own the ordered tokens.
|
|
31
|
+
The only preparation additions are `--summary-only`, a stage in the confirmed implementation chain, and the existing separately user-confirmed `--tdd-bypass` / `--qa-waiver` exceptions under their host orchestration rules. Never infer an exception grant from the original wizard confirmation.
|
|
45
32
|
|
|
46
33
|
```bash
|
|
47
|
-
okstra render-bundle --summary-only
|
|
48
|
-
<outcome.renderArgv token 1> \
|
|
49
|
-
<outcome.renderArgv token 2> \
|
|
50
|
-
<each remaining outcome.renderArgv token in order>
|
|
34
|
+
okstra render-bundle --wizard-state-file /var/folders/.../okstra-wizard.AbCd.json --summary-only
|
|
51
35
|
```
|
|
52
36
|
|
|
53
|
-
`render-bundle` auto-supplies `--workspace-root` and forces `--render-only`. Stdout prints `okstra task root:`, `okstra instruction-set:`, `okstra run manifest:`, and other preparation status. `--summary-only` omits the lead prompt body from stdout; Step 6 reads the verified saved prompt from the manifest path. Parse the labelled lines for `TASK_ROOT`, `INSTRUCTION_SET_PATH`, and `RUN_MANIFEST_PATH`. Also watch for an optional `okstra concurrent-run stages:` label line — present only when a concurrent run is detected (see "Concurrent-run detection branch"
|
|
37
|
+
`render-bundle` auto-supplies `--workspace-root` and forces `--render-only`. Stdout prints `okstra task root:`, `okstra instruction-set:`, `okstra run manifest:`, and other preparation status. `--summary-only` omits the lead prompt body from stdout; Step 6 reads the verified saved prompt from the manifest path. Parse the labelled lines for `TASK_ROOT`, `INSTRUCTION_SET_PATH`, and `RUN_MANIFEST_PATH`. Also watch for an optional `okstra concurrent-run stages:` label line — present only when a concurrent run is detected (see "Concurrent-run detection branch" in the selected host rules).
|
|
54
38
|
|
|
55
39
|
Before acting as the lead, read `resources.leadPromptMetadataPath` from the run
|
|
56
40
|
manifest and execute the host-native specification-link gate:
|
|
@@ -69,6 +53,8 @@ it does not claim that the host exposed or attested the delivered prompt bytes.
|
|
|
69
53
|
|
|
70
54
|
The python function underneath allocates the run sequence number and writes `run-context-*.json` under the per-task lock (`~/.okstra/.locks/<task-key>.lock`), then writes `run-inputs-*.json` + all manifests + discovery files outside that lock, and registers the run in `~/.okstra/recent.jsonl` with status `prepared` under the central `~/.okstra/.lock` (a registration failure is reported on stderr and does not fail prepare).
|
|
71
55
|
|
|
72
|
-
|
|
56
|
+
Enforcement: `wizard.launch.load_confirmed_launch` validates the confirmed snapshot and save receipt; `render-bundle.prepareRenderBundle` preserves ordered inputs and rejects scope overrides before writes. `tests/wizard/test_launch.py` and `tests-js/render-bundle.test.mjs` cover these contracts. Host execution permission remains a separate host decision.
|
|
57
|
+
|
|
58
|
+
After successful preparation of a single run, delete the literal state-file path. For an implementation chain with multiple stages, keep it until preparation of the last confirmed stage succeeds. Do not delete it after a failed preparation. Invoke `command rm` with the literal path (e.g. `command rm /var/folders/.../okstra-wizard.AbCd.json`), not a shell variable. `command` keeps an interactive `rm` alias from blocking cleanup. The preparation code never deletes this file.
|
|
73
59
|
|
|
74
|
-
|
|
60
|
+
If the file disappears before a remaining stage is prepared, stop that chain and report the completed and remaining stages. Reopen the wizard for the remaining scope; do not rebuild its inputs or approval receipt from a previous run. Already prepared runs resume from their run manifest without this file. After an interrupted or uncertain preparation, inspect the task's existing runs before retrying: this command does not promise exactly-once preparation.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: okstra-brief-gen
|
|
3
|
-
description: Use when the user wants to generate a task brief file for okstra from a requirements document, an existing markdown file, an issue-tracker ticket (Linear / Jira / GitHub / Notion), a link URL, conversation context, or short user input. Produces the markdown brief consumed by `okstra-run` Step 5 (task-brief).
|
|
3
|
+
description: Use when the user wants to generate a task brief file for okstra from a requirements document, an existing markdown file, an issue-tracker ticket (Linear / Jira / GitHub / Notion), a link URL, conversation context, or short user input. Produces the markdown brief consumed by `okstra-run` Step 5 (task-brief).
|
|
4
4
|
disable-model-invocation: true
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -155,7 +155,7 @@ Use the current host's native single-select mapping with every listed option in
|
|
|
155
155
|
### Capture contract (binds every sub-flow below)
|
|
156
156
|
|
|
157
157
|
`Source Material` is the one section a later phase can fall back to when a
|
|
158
|
-
derived section reads wrong, so it carries the source whole.
|
|
158
|
+
derived section reads wrong, so it carries the source whole. Four rules hold
|
|
159
159
|
for every variant and every source type below.
|
|
160
160
|
|
|
161
161
|
1. **Capture in full.** Length is never a reason to excerpt, summarize, or
|
|
@@ -1031,7 +1031,7 @@ If the list is non-empty, run **one** `prompt_user`:
|
|
|
1031
1031
|
|
|
1032
1032
|
When 6.5b answered "Yes — collect now", **read
|
|
1033
1033
|
`references/reporter-confirmations.md` next to this SKILL.md and follow it**:
|
|
1034
|
-
it defines
|
|
1034
|
+
it defines host-limited batching, the 12-question cap with
|
|
1035
1035
|
`conversion-block:`-first priority, the `## Reporter Confirmations` RC-N
|
|
1036
1036
|
record shape with `[CONFIRMED <date> → RC-N]` row markers and
|
|
1037
1037
|
`> confirmed-by-reporter:` blockquote lines, and the final
|
|
@@ -1041,7 +1041,8 @@ record shape with `[CONFIRMED <date> → RC-N]` row markers and
|
|
|
1041
1041
|
Step 6.5 ends here. The brief now has either zero pending reporter-only
|
|
1042
1042
|
rows (`complete` / `partial` with remainder in the same file) or an
|
|
1043
1043
|
explicit `skipped` signal that downstream phases consume per the
|
|
1044
|
-
"Brief
|
|
1044
|
+
"Brief handoff contract" in `_common-contract.md` and each phase profile's
|
|
1045
|
+
"Brief consumption" addendum.
|
|
1045
1046
|
|
|
1046
1047
|
## Step 6.6: Self-validate before hand-off
|
|
1047
1048
|
|
|
@@ -1121,9 +1122,8 @@ Before printing the hand-off block, check whether
|
|
|
1121
1122
|
file is the one document every task in the group shares — why the group
|
|
1122
1123
|
exists, how its result is measured (with the denominator named), group-wide
|
|
1123
1124
|
constraints, ticket relations — and no single brief can recover it
|
|
1124
|
-
(
|
|
1125
|
-
|
|
1126
|
-
per-page ratio instead of origin load). If the file is absent, ask once via
|
|
1125
|
+
(without it, the group's shared reason appears in no brief and option
|
|
1126
|
+
selection measures the wrong quantity). If the file is absent, ask once via
|
|
1127
1127
|
`prompt_user`:
|
|
1128
1128
|
|
|
1129
1129
|
- `Create the group context skeleton now (Recommended for a new task-group)`
|
|
@@ -53,7 +53,7 @@ brief's frontmatter `ticket-id` + `source-type`. Reseed precedence:
|
|
|
53
53
|
|
|
54
54
|
1. On-disk frontmatter (`ticket-id` ≠ "") populates visited entries as
|
|
55
55
|
`<source-type>:<ticket-id>` — these win.
|
|
56
|
-
2. Step 2c collision policy (`Skip` / `Append
|
|
56
|
+
2. Step 2c collision policy (`Skip` / `Append suffix` / `Overwrite`) applies
|
|
57
57
|
to any node whose path is already taken.
|
|
58
58
|
3. The fresh in-memory walk fills any gaps for tickets not yet on disk.
|
|
59
59
|
|