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.
Files changed (265) hide show
  1. package/README.md +19 -271
  2. package/dist/cli-registry.mjs +14 -1
  3. package/dist/cli-registry.mjs.map +1 -1
  4. package/dist/commands/execute/render-bundle.d.mts +6 -1
  5. package/dist/commands/execute/render-bundle.mjs +139 -32
  6. package/dist/commands/execute/render-bundle.mjs.map +1 -1
  7. package/dist/commands/lifecycle/config.mjs +6 -74
  8. package/dist/commands/lifecycle/config.mjs.map +1 -1
  9. package/dist/commands/memory/memory.mjs +9 -55
  10. package/dist/commands/memory/memory.mjs.map +1 -1
  11. package/dist/commands/trace/capacity.d.mts +12 -0
  12. package/dist/commands/trace/capacity.mjs +21 -0
  13. package/dist/commands/trace/capacity.mjs.map +1 -0
  14. package/dist/commands/trace/model.d.mts +89 -0
  15. package/dist/commands/trace/model.mjs +251 -0
  16. package/dist/commands/trace/model.mjs.map +1 -0
  17. package/dist/commands/trace/progression.d.mts +11 -0
  18. package/dist/commands/trace/progression.mjs +194 -0
  19. package/dist/commands/trace/progression.mjs.map +1 -0
  20. package/dist/commands/trace/review.d.mts +7 -0
  21. package/dist/commands/trace/review.mjs +51 -0
  22. package/dist/commands/trace/review.mjs.map +1 -0
  23. package/dist/commands/trace/task-link.d.mts +18 -0
  24. package/dist/commands/trace/task-link.mjs +72 -0
  25. package/dist/commands/trace/task-link.mjs.map +1 -0
  26. package/dist/commands/trace/trace.d.mts +1 -0
  27. package/dist/commands/trace/trace.mjs +293 -0
  28. package/dist/commands/trace/trace.mjs.map +1 -0
  29. package/dist/lib/bounded-file.d.mts +1 -0
  30. package/dist/lib/bounded-file.mjs +36 -0
  31. package/dist/lib/bounded-file.mjs.map +1 -0
  32. package/dist/lib/config-store.d.mts +34 -0
  33. package/dist/lib/config-store.mjs +70 -0
  34. package/dist/lib/config-store.mjs.map +1 -0
  35. package/dist/lib/file-lock.mjs +4 -5
  36. package/dist/lib/file-lock.mjs.map +1 -1
  37. package/dist/lib/input-limit.d.mts +4 -0
  38. package/dist/lib/input-limit.mjs +8 -0
  39. package/dist/lib/input-limit.mjs.map +1 -0
  40. package/dist/lib/memory-auto-register.d.mts +1 -0
  41. package/dist/lib/memory-auto-register.mjs +98 -0
  42. package/dist/lib/memory-auto-register.mjs.map +1 -0
  43. package/dist/lib/memory-entry-contract.d.mts +12 -0
  44. package/dist/lib/memory-entry-contract.mjs +46 -0
  45. package/dist/lib/memory-entry-contract.mjs.map +1 -0
  46. package/dist/lib/python-helper.d.mts +1 -1
  47. package/dist/lib/python-helper.mjs +3 -2
  48. package/dist/lib/python-helper.mjs.map +1 -1
  49. package/dist/lib/record-secrets.d.mts +1 -0
  50. package/dist/lib/record-secrets.mjs +28 -0
  51. package/dist/lib/record-secrets.mjs.map +1 -0
  52. package/dist/lib/report-language-tag.d.mts +1 -0
  53. package/dist/lib/report-language-tag.mjs +4 -0
  54. package/dist/lib/report-language-tag.mjs.map +1 -0
  55. package/dist/lib/report-language.d.mts +1 -0
  56. package/dist/lib/report-language.mjs +50 -0
  57. package/dist/lib/report-language.mjs.map +1 -0
  58. package/dist/lib/skill-catalog.mjs +3 -0
  59. package/dist/lib/skill-catalog.mjs.map +1 -1
  60. package/dist/lib/types.d.mts +2 -1
  61. package/docs/architecture/storage-model.md +163 -5
  62. package/docs/architecture.md +17 -4
  63. package/docs/cli.md +511 -0
  64. package/docs/contributor-change-matrix.md +1 -2
  65. package/docs/project-structure-overview.md +33 -42
  66. package/package.json +1 -1
  67. package/runtime/BUILD.json +2 -2
  68. package/runtime/agents/common.json +8 -8
  69. package/runtime/agents/operations/trace-interface-review.json +6 -0
  70. package/runtime/agents/operations/trace-scope-review.json +6 -0
  71. package/runtime/agents/roles/verifier.json +2 -4
  72. package/runtime/bin/okstra-provider-exec.py +10 -4
  73. package/runtime/prompts/coding-preflight/architectures/hexagonal.md +23 -30
  74. package/runtime/prompts/coding-preflight/authoring-checks.md +17 -0
  75. package/runtime/prompts/coding-preflight/clean-code.md +88 -286
  76. package/runtime/prompts/coding-preflight/frameworks/node-server.md +2 -3
  77. package/runtime/prompts/coding-preflight/languages/java.md +3 -5
  78. package/runtime/prompts/coding-preflight/languages/javascript-typescript.md +5 -12
  79. package/runtime/prompts/coding-preflight/languages/kotlin.md +2 -4
  80. package/runtime/prompts/coding-preflight/languages/python.md +2 -7
  81. package/runtime/prompts/coding-preflight/languages/rust.md +2 -8
  82. package/runtime/prompts/coding-preflight/languages/sql.md +2 -4
  83. package/runtime/prompts/coding-preflight/overview.md +25 -38
  84. package/runtime/prompts/coding-preflight/review-rules.json +30 -0
  85. package/runtime/prompts/duties/code-reviewer.json +15 -18
  86. package/runtime/prompts/duties/implementation-verifier.json +1 -0
  87. package/runtime/prompts/duties/interface-reviewer.json +32 -0
  88. package/runtime/prompts/host-orchestration/README.md +18 -9
  89. package/runtime/prompts/launch.template.md +3 -2
  90. package/runtime/prompts/lead/context-loader.md +2 -0
  91. package/runtime/prompts/lead/okstra-lead-contract.md +7 -7
  92. package/runtime/prompts/lead/report-writer.md +6 -6
  93. package/runtime/prompts/profiles/_coding-conventions-preflight.md +41 -6
  94. package/runtime/prompts/profiles/_common-contract.md +1 -1
  95. package/runtime/python/okstra_ctl/agent/invocation.py +122 -36
  96. package/runtime/python/okstra_ctl/agent/prompt_cli/cli.py +72 -26
  97. package/runtime/python/okstra_ctl/agent/prompt_cli/corrections.py +23 -8
  98. package/runtime/python/okstra_ctl/agent/prompt_cli/materialize.py +58 -14
  99. package/runtime/python/okstra_ctl/agent/prompt_cli/results.py +8 -11
  100. package/runtime/python/okstra_ctl/agent/standalone.py +15 -0
  101. package/runtime/python/okstra_ctl/analysis_packet.py +24 -30
  102. package/runtime/python/okstra_ctl/attempt_evidence.py +10 -0
  103. package/runtime/python/okstra_ctl/code_review_census.py +162 -7
  104. package/runtime/python/okstra_ctl/code_review_coverage.py +4 -274
  105. package/runtime/python/okstra_ctl/code_review_integrity.py +154 -0
  106. package/runtime/python/okstra_ctl/code_review_invocation.py +212 -0
  107. package/runtime/python/okstra_ctl/code_review_prepare.py +381 -0
  108. package/runtime/python/okstra_ctl/code_review_run.py +384 -0
  109. package/runtime/python/okstra_ctl/code_review_scope.py +49 -9
  110. package/runtime/python/okstra_ctl/code_review_supervisor.py +41 -0
  111. package/runtime/python/okstra_ctl/code_review_target.py +212 -13
  112. package/runtime/python/okstra_ctl/consumers.py +12 -9
  113. package/runtime/python/okstra_ctl/coverage_census.py +11 -2
  114. package/runtime/python/okstra_ctl/design_review.py +207 -0
  115. package/runtime/python/okstra_ctl/design_review_evidence.py +297 -0
  116. package/runtime/python/okstra_ctl/design_snapshot.py +16 -9
  117. package/runtime/python/okstra_ctl/direct_work.py +45 -3
  118. package/runtime/python/okstra_ctl/dispatch_core.py +31 -15
  119. package/runtime/python/okstra_ctl/dispatch_state.py +9 -2
  120. package/runtime/python/okstra_ctl/doctor.py +8 -25
  121. package/runtime/python/okstra_ctl/domain/role.py +1 -0
  122. package/runtime/python/okstra_ctl/doyouknow/__init__.py +9 -0
  123. package/runtime/python/okstra_ctl/doyouknow/cli.py +91 -0
  124. package/runtime/python/okstra_ctl/doyouknow/config.py +58 -0
  125. package/runtime/python/okstra_ctl/doyouknow/contracts.py +184 -0
  126. package/runtime/python/okstra_ctl/doyouknow/identity.py +22 -0
  127. package/runtime/python/okstra_ctl/doyouknow/paths.py +22 -0
  128. package/runtime/python/okstra_ctl/doyouknow/pending.py +72 -0
  129. package/runtime/python/okstra_ctl/doyouknow/registration.py +260 -0
  130. package/runtime/python/okstra_ctl/doyouknow/source_contracts.py +128 -0
  131. package/runtime/python/okstra_ctl/doyouknow/source_store.py +172 -0
  132. package/runtime/python/okstra_ctl/doyouknow/sources/io.py +36 -0
  133. package/runtime/python/okstra_ctl/doyouknow/sources/manager.py +300 -0
  134. package/runtime/python/okstra_ctl/doyouknow/sources/memory.py +179 -0
  135. package/runtime/python/okstra_ctl/doyouknow/sources/task.py +95 -0
  136. package/runtime/python/okstra_ctl/doyouknow/store.py +260 -0
  137. package/runtime/python/okstra_ctl/doyouknow/sync.py +58 -0
  138. package/runtime/python/okstra_ctl/execution_mutation_audit.py +18 -2
  139. package/runtime/python/okstra_ctl/file_size_cap.py +3 -4
  140. package/runtime/python/okstra_ctl/final_report_schema.py +37 -34
  141. package/runtime/python/okstra_ctl/incremental_carry.py +6 -7
  142. package/runtime/python/okstra_ctl/initial_prompt_materialization.py +9 -2
  143. package/runtime/python/okstra_ctl/json_boundary.py +51 -5
  144. package/runtime/python/okstra_ctl/jsonl.py +21 -0
  145. package/runtime/python/okstra_ctl/manager_cli.py +148 -1
  146. package/runtime/python/okstra_ctl/manager_journal.py +126 -0
  147. package/runtime/python/okstra_ctl/manager_launch.py +3 -3
  148. package/runtime/python/okstra_ctl/manager_log.py +221 -0
  149. package/runtime/python/okstra_ctl/manager_paths.py +8 -0
  150. package/runtime/python/okstra_ctl/manager_registration.py +29 -0
  151. package/runtime/python/okstra_ctl/manager_resume.py +59 -0
  152. package/runtime/python/okstra_ctl/manager_split.py +2 -2
  153. package/runtime/python/okstra_ctl/manager_store.py +116 -17
  154. package/runtime/python/okstra_ctl/manager_sync.py +45 -25
  155. package/runtime/python/okstra_ctl/manager_view.py +35 -2
  156. package/runtime/python/okstra_ctl/material.py +2 -0
  157. package/runtime/python/okstra_ctl/model_cli.py +64 -14
  158. package/runtime/python/okstra_ctl/model_defaults.py +22 -0
  159. package/runtime/python/okstra_ctl/model_io/renderers.py +16 -2
  160. package/runtime/python/okstra_ctl/model_io_cli.py +7 -1
  161. package/runtime/python/okstra_ctl/operation_invocation.py +207 -28
  162. package/runtime/python/okstra_ctl/path_hints.py +14 -3
  163. package/runtime/python/okstra_ctl/paths.py +6 -1
  164. package/runtime/python/okstra_ctl/phases/catalog.py +24 -7
  165. package/runtime/python/okstra_ctl/phases/final_verification/validation.py +20 -0
  166. package/runtime/python/okstra_ctl/phases/implementation/host-rules.md +3 -3
  167. package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-deliverable.md +10 -0
  168. package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-diff-review.md +23 -8
  169. package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-self-check.md +6 -4
  170. package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-verifier.md +38 -10
  171. package/runtime/python/okstra_ctl/phases/implementation/report_assets/implementation.template.html +13 -0
  172. package/runtime/python/okstra_ctl/phases/implementation/spec.md +25 -0
  173. package/runtime/python/okstra_ctl/phases/implementation/validation.py +6 -0
  174. package/runtime/python/okstra_ctl/phases/implementation_option_selection/profile.md +1 -1
  175. package/runtime/python/okstra_ctl/phases/implementation_option_selection/votes.py +11 -11
  176. package/runtime/python/okstra_ctl/phases/implementation_planning/authoring.py +16 -9
  177. package/runtime/python/okstra_ctl/phases/implementation_planning/host-rules.md +3 -6
  178. package/runtime/python/okstra_ctl/phases/implementation_planning/instructions/plan-body-verification.md +12 -10
  179. package/runtime/python/okstra_ctl/phases/implementation_planning/profile.md +6 -6
  180. package/runtime/python/okstra_ctl/phases/improvement_discovery/lenses.py +12 -0
  181. package/runtime/python/okstra_ctl/phases/improvement_discovery/profile.md +7 -6
  182. package/runtime/python/okstra_ctl/phases/improvement_discovery/resolved_census.py +159 -0
  183. package/runtime/python/okstra_ctl/phases/improvement_discovery/spec.md +5 -2
  184. package/runtime/python/okstra_ctl/phases/improvement_discovery/validation.py +21 -7
  185. package/runtime/python/okstra_ctl/phases/release_handoff/boundary.json +1 -1
  186. package/runtime/python/okstra_ctl/phases/release_handoff/profile.md +4 -1
  187. package/runtime/python/okstra_ctl/plan_verify_cli.py +6 -4
  188. package/runtime/python/okstra_ctl/render.py +28 -2
  189. package/runtime/python/okstra_ctl/report_assembly.py +53 -11
  190. package/runtime/python/okstra_ctl/report_contract.py +26 -0
  191. package/runtime/python/okstra_ctl/report_corrections.py +36 -20
  192. package/runtime/python/okstra_ctl/report_inputs.py +1 -0
  193. package/runtime/python/okstra_ctl/report_language.py +4 -1
  194. package/runtime/python/okstra_ctl/report_narrative.py +182 -7
  195. package/runtime/python/okstra_ctl/report_projections.py +64 -18
  196. package/runtime/python/okstra_ctl/report_synthesis_packet.py +97 -38
  197. package/runtime/python/okstra_ctl/review_policy.py +359 -0
  198. package/runtime/python/okstra_ctl/review_verdicts.py +291 -0
  199. package/runtime/python/okstra_ctl/run.py +67 -36
  200. package/runtime/python/okstra_ctl/run_context.py +10 -1
  201. package/runtime/python/okstra_ctl/set_work_status.py +4 -15
  202. package/runtime/python/okstra_ctl/stage_done.py +11 -0
  203. package/runtime/python/okstra_ctl/standalone_review_audit.py +28 -0
  204. package/runtime/python/okstra_ctl/task_list_cli.py +34 -8
  205. package/runtime/python/okstra_ctl/task_query.py +239 -0
  206. package/runtime/python/okstra_ctl/trace_review.py +264 -0
  207. package/runtime/python/okstra_ctl/trace_tasks.py +197 -0
  208. package/runtime/python/okstra_ctl/user_authorization.py +14 -0
  209. package/runtime/python/okstra_ctl/verification_generation.py +23 -1
  210. package/runtime/python/okstra_ctl/verification_input_types.py +15 -1
  211. package/runtime/python/okstra_ctl/verification_inputs.py +28 -6
  212. package/runtime/python/okstra_ctl/verification_invocation.py +7 -1
  213. package/runtime/python/okstra_ctl/verification_target.py +2 -0
  214. package/runtime/python/okstra_ctl/wizard/confirmation.py +7 -3
  215. package/runtime/python/okstra_ctl/wizard/launch.py +52 -0
  216. package/runtime/python/okstra_ctl/wizard/launch_cli.py +39 -0
  217. package/runtime/python/okstra_ctl/wizard/outcome.py +17 -16
  218. package/runtime/python/okstra_ctl/wizard/registry.py +1 -1
  219. package/runtime/python/okstra_ctl/wizard/render.py +8 -0
  220. package/runtime/python/okstra_ctl/wizard/state.py +2 -1
  221. package/runtime/python/okstra_ctl/worker_prompt_headers.py +24 -9
  222. package/runtime/python/okstra_ctl/worker_runner.py +66 -10
  223. package/runtime/python/okstra_ctl/write_policy.py +34 -1
  224. package/runtime/python/okstra_project/__init__.py +2 -0
  225. package/runtime/python/okstra_project/dirs.py +18 -0
  226. package/runtime/python/okstra_project/state.py +45 -20
  227. package/runtime/python/okstra_token_usage/blocks.py +74 -0
  228. package/runtime/python/okstra_token_usage/cli.py +23 -10
  229. package/runtime/python/okstra_token_usage/collect.py +25 -22
  230. package/runtime/python/okstra_token_usage/policy.py +193 -0
  231. package/runtime/schemas/doyouknow-config-v1.schema.json +20 -0
  232. package/runtime/schemas/doyouknow-v1.schema.json +65 -0
  233. package/runtime/schemas/final-report-v2.0.schema.json +157 -0
  234. package/runtime/schemas/final-report-v3.0.schema.json +157 -0
  235. package/runtime/schemas/memory-entry-contract-v1.json +11 -0
  236. package/runtime/schemas/record-secret-patterns.json +41 -0
  237. package/runtime/schemas/report-synthesis-packet-v1.0.schema.json +1 -1
  238. package/runtime/skills/_fragments/wizard-confirm-step.md +1 -1
  239. package/runtime/skills/_fragments/wizard-preflight.md +1 -1
  240. package/runtime/skills/_fragments/wizard-prompt-loop.md +3 -5
  241. package/runtime/skills/_fragments/wizard-relay-protocol.md +1 -1
  242. package/runtime/skills/_fragments/wizard-render-bundle.md +15 -29
  243. package/runtime/skills/okstra-brief-gen/SKILL.md +7 -7
  244. package/runtime/skills/okstra-brief-gen/references/tracker-recursion.md +1 -1
  245. package/runtime/skills/okstra-code-review/SKILL.md +92 -136
  246. package/runtime/skills/okstra-code-review/references/census-rules.md +29 -105
  247. package/runtime/skills/okstra-code-review/references/review-calibration.md +37 -61
  248. package/runtime/skills/okstra-discussion/SKILL.md +22 -38
  249. package/runtime/skills/okstra-explain-flow/SKILL.md +6 -2
  250. package/runtime/skills/okstra-manager/SKILL.md +31 -0
  251. package/runtime/skills/okstra-memory/SKILL.md +8 -1
  252. package/runtime/skills/okstra-pr-gen/SKILL.md +1 -1
  253. package/runtime/skills/okstra-run/SKILL.md +55 -183
  254. package/runtime/skills/okstra-schedule-gen/SKILL.md +9 -13
  255. package/runtime/skills/okstra-setup/SKILL.md +3 -2
  256. package/runtime/skills/okstra-setup/references/project-config.md +2 -4
  257. package/runtime/skills/okstra-tdd/SKILL.md +187 -0
  258. package/runtime/skills/okstra-user-response/SKILL.md +4 -2
  259. package/runtime/templates/implementation-worker-preamble.md +4 -9
  260. package/runtime/templates/manager/view.template.html +4 -0
  261. package/runtime/templates/report-writer-prompt-preamble.md +15 -3
  262. package/runtime/templates/trace/trace.template.md +42 -0
  263. package/runtime/templates/worker-prompt-preamble.md +4 -12
  264. package/runtime/validators/checks/fixtures-02.py +25 -33
  265. 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
+ }
@@ -41,7 +41,7 @@
41
41
  "minLength": 1
42
42
  },
43
43
  "format": {
44
- "const": "report-narrative-v3.0"
44
+ "enum": ["report-narrative-v3.0", "json-v1"]
45
45
  },
46
46
  "sourcePolicy": {
47
47
  "const": "read-only-synthesis-packet"
@@ -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 (observed: a lead's own table omitted `directive`, `base-ref` and `brief`). Render the picker **as the final output of that turn** — emit nothing after the picker call.
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 — `npx` is not on the literal-token allow-list and will force a confirmation prompt on every wizard call afterward. Every subsequent `okstra <subcmd>` call self-bootstraps its Python path, so never `export PYTHONPATH=...`.
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
- **MANDATORY: empty answers must pass `--answer ""` explicitly.** If the user's reply is the empty string, the call MUST still include the flag with an empty literal value:
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
- Omitting `--answer` entirely is forbidden. The wizard does not read a missing `--answer` flag as "submit empty": without `--answer` or `--no-submit`, `wizard step` returns `ok: false` naming `--answer` and exits 2, and the step is not submitted. Submitting `--answer ""` is the only way to advance past an intentionally-blank step (e.g. "use phase default").
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
- **Escaping rule**: if the literal answer contains `"`, escape each occurrence as `\"` inside the double-quoted argument. Empty values must still be `--answer ""` — the flag itself is mandatory, even when the value is empty.
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. **Never drop, hide, merge, reorder, or truncate** a `pick` / `pick_group` option — relay every `options[]` entry, including the flagged recommendation. Do not collapse a multi-option pick into a "recommended + Enter directly / Other" shortlist. The wizard's arrays are the complete authoritative choice sets, regardless of the current host UI's usual option limit. The run-prompt recommendation rule (1–2 recommendations + Enter directly) shapes the **option set** only for prompts this skill authors itself, never for wizard-provided options — you may not add, drop, or reorder a wizard option to produce a shortlist. 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)".
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
- `renderArgv` is the canonical ordered `okstra render-bundle` argument list. Pass its tokens verbatim and in order. Repeated `--role-count` and `--role-model` flags are intentional. `renderArgs` is a compatibility and inspection view only; do not reconstruct an invocation from it. `orchestration` holds signals this skill acts on itself — never pass its entries to `render-bundle`.
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
- `userAuthorization`, when present, preserves the confirmation prompt actually emitted by this wizard and the relayed `proceed` response. Its `--user-authorization-json` token carries that record into the run manifest; preserve it unchanged. Do not synthesize a receipt for older confirmed states. The record documents task scope; it does not grant host execution privileges.
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
- 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`.
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
- ```json
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
- Execute the matching command for `scope`:
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
- If an action has an unknown `command`, `key`, or `scope`, stop and report the wizard output instead of inventing a command.
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
- Build the `okstra render-bundle` invocation from `outcome.renderArgv`, passing every token verbatim and in order (including empty strings — they are intentional `use phase default` markers).
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
- Analysis sidetracks therefore forward wizard-owned tokens such as `--analysis-target "<value>"` and `--evidence-inputs "<value>"` when they are present. These are examples of the verbatim token rule, not a separate hard-coded argument list.
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" below).
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
- **Not enforced:** `tests-js/wizard.test.mjs` pins the argv the wizard produces (`orderedRenderArgv` preserves the Python role selection bytes and repeated role order), not the argv you pass. Prepare's parser defaults most flags to `""` (e.g. `--directive`), so a dropped empty value is indistinguishable from its default and nothing rejects it — passing every token verbatim is on you.
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
- You can delete the literal state-file path after this point — its job is done. Invoke `command rm` with the literal path (e.g. `command rm /var/folders/.../okstra-wizard.AbCd.json`), not a shell variable. `command` is what keeps a `rm='rm -i'` alias from turning this into a confirmation prompt nobody is there to answer.
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). Trigger words include "okstra brief", "make a brief", "generate a brief", "make a brief from requirements", "make an okstra input", "write a task brief", "brief from this ticket", "brief from this link".
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. Three rules hold
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 the ≤ 4-question batching, the 12-question cap with
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 consumption" addendum in `_common-contract.md`.
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
- (observed: a 15-brief group whose reason, "the origin keeps going down under
1125
- attack traffic", appeared in none of them, so option selection measured a
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 timestamp` / `Overwrite`) applies
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