okstra 0.234.1 → 0.236.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 (171) hide show
  1. package/dist/cli-registry.mjs +7 -0
  2. package/dist/cli-registry.mjs.map +1 -1
  3. package/dist/commands/implementation-report/implementation-report.d.mts +1 -0
  4. package/dist/commands/implementation-report/implementation-report.mjs +73 -0
  5. package/dist/commands/implementation-report/implementation-report.mjs.map +1 -0
  6. package/dist/commands/trace/comparison.d.mts +39 -0
  7. package/dist/commands/trace/comparison.mjs +138 -0
  8. package/dist/commands/trace/comparison.mjs.map +1 -0
  9. package/dist/commands/trace/document.d.mts +8 -0
  10. package/dist/commands/trace/document.mjs +37 -0
  11. package/dist/commands/trace/document.mjs.map +1 -0
  12. package/dist/commands/trace/line-counts.d.mts +15 -0
  13. package/dist/commands/trace/line-counts.mjs +107 -0
  14. package/dist/commands/trace/line-counts.mjs.map +1 -0
  15. package/dist/commands/trace/model.d.mts +2 -1
  16. package/dist/commands/trace/model.mjs +13 -1
  17. package/dist/commands/trace/model.mjs.map +1 -1
  18. package/dist/commands/trace/progression.mjs +7 -3
  19. package/dist/commands/trace/progression.mjs.map +1 -1
  20. package/dist/commands/trace/task-link.d.mts +3 -0
  21. package/dist/commands/trace/task-link.mjs.map +1 -1
  22. package/dist/commands/trace/trace.mjs +64 -44
  23. package/dist/commands/trace/trace.mjs.map +1 -1
  24. package/dist/lib/host-registry-client.d.mts +9 -2
  25. package/dist/lib/host-registry-client.mjs +29 -3
  26. package/dist/lib/host-registry-client.mjs.map +1 -1
  27. package/dist/lib/python-helper.d.mts +1 -1
  28. package/dist/lib/python-helper.mjs +11 -5
  29. package/dist/lib/python-helper.mjs.map +1 -1
  30. package/dist/lib/runtime-payload.mjs +1 -0
  31. package/dist/lib/runtime-payload.mjs.map +1 -1
  32. package/dist/lib/types.d.mts +1 -0
  33. package/docs/architecture/storage-model.md +50 -0
  34. package/docs/architecture.md +1 -1
  35. package/docs/cli.md +37 -15
  36. package/docs/project-structure-overview.md +6 -1
  37. package/package.json +1 -1
  38. package/runtime/BUILD.json +2 -2
  39. package/runtime/agents/operations/trace-tests-review.json +6 -0
  40. package/runtime/bin/lib/okstra/usage.sh +8 -8
  41. package/runtime/bin/okstra-qwen-exec.sh +5 -0
  42. package/runtime/prompts/duties/test-reviewer.json +32 -0
  43. package/runtime/prompts/lead/convergence.md +4 -1
  44. package/runtime/prompts/lead/okstra-lead-contract.md +3 -3
  45. package/runtime/prompts/lead/report-writer.md +13 -1
  46. package/runtime/prompts/profiles/_common-contract.md +10 -1
  47. package/runtime/prompts/wizard/prompts.ko.json +16 -4
  48. package/runtime/python/okstra_ctl/adapters/providers/antigravity/adapter.py +10 -2
  49. package/runtime/python/okstra_ctl/adapters/providers/claude/adapter.py +16 -1
  50. package/runtime/python/okstra_ctl/adapters/providers/codex/adapter.py +20 -5
  51. package/runtime/python/okstra_ctl/adapters/providers/kimi/adapter.py +17 -9
  52. package/runtime/python/okstra_ctl/adapters/providers/qwen/adapter.py +88 -0
  53. package/runtime/python/okstra_ctl/adapters/providers/qwen/manifest.json +1 -0
  54. package/runtime/python/okstra_ctl/adapters/providers/qwen/settings.json +12 -0
  55. package/runtime/python/okstra_ctl/adapters/providers/zai/adapter.py +8 -2
  56. package/runtime/python/okstra_ctl/agent/invocation.py +109 -56
  57. package/runtime/python/okstra_ctl/agent/prompt_cli/materialize.py +17 -0
  58. package/runtime/python/okstra_ctl/attempt_evidence.py +5 -2
  59. package/runtime/python/okstra_ctl/business_flow/contracts.py +11 -0
  60. package/runtime/python/okstra_ctl/business_flow/engine.py +90 -32
  61. package/runtime/python/okstra_ctl/business_flow/hooks.py +4 -2
  62. package/runtime/python/okstra_ctl/business_flow/source.py +39 -7
  63. package/runtime/python/okstra_ctl/business_flow/store.py +94 -28
  64. package/runtime/python/okstra_ctl/code_review_census.py +38 -0
  65. package/runtime/python/okstra_ctl/code_review_coverage.py +15 -4
  66. package/runtime/python/okstra_ctl/code_review_prepare.py +15 -3
  67. package/runtime/python/okstra_ctl/code_review_scope.py +3 -2
  68. package/runtime/python/okstra_ctl/code_review_target.py +16 -6
  69. package/runtime/python/okstra_ctl/conformance_evidence.py +44 -21
  70. package/runtime/python/okstra_ctl/consumers.py +6 -1
  71. package/runtime/python/okstra_ctl/convergence.py +95 -5
  72. package/runtime/python/okstra_ctl/convergence_critic_verify_prompt.py +11 -10
  73. package/runtime/python/okstra_ctl/convergence_engine.py +30 -15
  74. package/runtime/python/okstra_ctl/convergence_reverify_prompt.py +9 -2
  75. package/runtime/python/okstra_ctl/coverage_census.py +75 -12
  76. package/runtime/python/okstra_ctl/design_review.py +6 -26
  77. package/runtime/python/okstra_ctl/design_review_evidence.py +6 -26
  78. package/runtime/python/okstra_ctl/dispatch_core.py +9 -2
  79. package/runtime/python/okstra_ctl/dispatch_state.py +5 -0
  80. package/runtime/python/okstra_ctl/domain/role.py +1 -0
  81. package/runtime/python/okstra_ctl/entrypoints/hosts.py +1 -1
  82. package/runtime/python/okstra_ctl/execution_manifest.py +8 -0
  83. package/runtime/python/okstra_ctl/implementation_comparison/__init__.py +12 -0
  84. package/runtime/python/okstra_ctl/implementation_comparison/__main__.py +129 -0
  85. package/runtime/python/okstra_ctl/implementation_comparison/assembly.py +340 -0
  86. package/runtime/python/okstra_ctl/implementation_comparison/baseline.py +254 -0
  87. package/runtime/python/okstra_ctl/implementation_comparison/business_reuse.py +118 -0
  88. package/runtime/python/okstra_ctl/implementation_comparison/commit_source.py +113 -0
  89. package/runtime/python/okstra_ctl/implementation_comparison/html.py +49 -0
  90. package/runtime/python/okstra_ctl/implementation_comparison/inputs.py +348 -0
  91. package/runtime/python/okstra_ctl/implementation_comparison/model.py +47 -0
  92. package/runtime/python/okstra_ctl/implementation_comparison/preparation.py +195 -0
  93. package/runtime/python/okstra_ctl/implementation_comparison/publication.py +317 -0
  94. package/runtime/python/okstra_ctl/implementation_comparison/run_evidence.py +208 -0
  95. package/runtime/python/okstra_ctl/implementation_comparison/run_integration.py +198 -0
  96. package/runtime/python/okstra_ctl/implementation_comparison/source.py +342 -0
  97. package/runtime/python/okstra_ctl/implementation_comparison/target.py +144 -0
  98. package/runtime/python/okstra_ctl/implementation_comparison/task_assembly.py +333 -0
  99. package/runtime/python/okstra_ctl/implementation_comparison/task_selection.py +309 -0
  100. package/runtime/python/okstra_ctl/implementation_generation_evidence.py +134 -0
  101. package/runtime/python/okstra_ctl/implementation_outcome.py +2 -2
  102. package/runtime/python/okstra_ctl/initial_prompt_materialization.py +1 -0
  103. package/runtime/python/okstra_ctl/json_boundary.py +28 -8
  104. package/runtime/python/okstra_ctl/lead_progress.py +1 -1
  105. package/runtime/python/okstra_ctl/model_discovery.py +1 -1
  106. package/runtime/python/okstra_ctl/models.py +2 -2
  107. package/runtime/python/okstra_ctl/paths.py +7 -4
  108. package/runtime/python/okstra_ctl/phases/discussion/profile.md +2 -2
  109. package/runtime/python/okstra_ctl/phases/error_analysis/profile.md +1 -1
  110. package/runtime/python/okstra_ctl/phases/implementation_option_selection/profile.md +1 -1
  111. package/runtime/python/okstra_ctl/phases/implementation_planning/authoring.py +2 -1
  112. package/runtime/python/okstra_ctl/phases/implementation_planning/instructions/plan-body-verification.md +1 -1
  113. package/runtime/python/okstra_ctl/phases/implementation_planning/profile.md +3 -3
  114. package/runtime/python/okstra_ctl/phases/requirements_discovery/profile.md +5 -5
  115. package/runtime/python/okstra_ctl/plan_run_root.py +8 -4
  116. package/runtime/python/okstra_ctl/qa_procedures.py +33 -2
  117. package/runtime/python/okstra_ctl/registry/provider_registry.py +1 -1
  118. package/runtime/python/okstra_ctl/render.py +4 -0
  119. package/runtime/python/okstra_ctl/render_final_report.py +1 -1
  120. package/runtime/python/okstra_ctl/report_execution_evidence.py +88 -15
  121. package/runtime/python/okstra_ctl/report_finalize.py +18 -4
  122. package/runtime/python/okstra_ctl/report_html/render.py +46 -7
  123. package/runtime/python/okstra_ctl/report_html/validation.py +32 -0
  124. package/runtime/python/okstra_ctl/report_synthesis_packet.py +37 -3
  125. package/runtime/python/okstra_ctl/report_view_artifacts.py +12 -0
  126. package/runtime/python/okstra_ctl/review_verdicts.py +9 -0
  127. package/runtime/python/okstra_ctl/run.py +17 -1
  128. package/runtime/python/okstra_ctl/run_context.py +18 -3
  129. package/runtime/python/okstra_ctl/schema_excerpt.py +14 -9
  130. package/runtime/python/okstra_ctl/stage_done.py +11 -3
  131. package/runtime/python/okstra_ctl/stage_ledger.py +2 -2
  132. package/runtime/python/okstra_ctl/stage_map.py +3 -3
  133. package/runtime/python/okstra_ctl/trace_review.py +1 -0
  134. package/runtime/python/okstra_ctl/trace_tasks.py +22 -7
  135. package/runtime/python/okstra_ctl/verdict_blocks.py +7 -2
  136. package/runtime/python/okstra_ctl/verification_dispatch.py +32 -0
  137. package/runtime/python/okstra_ctl/verification_evidence.py +23 -3
  138. package/runtime/python/okstra_ctl/verification_generation.py +3 -2
  139. package/runtime/python/okstra_ctl/verification_inputs.py +3 -2
  140. package/runtime/python/okstra_ctl/verification_invocation.py +7 -3
  141. package/runtime/python/okstra_ctl/wizard/engine.py +28 -1
  142. package/runtime/python/okstra_ctl/wizard/ids.py +8 -0
  143. package/runtime/python/okstra_ctl/wizard/picker_navigation.py +64 -2
  144. package/runtime/python/okstra_ctl/wizard/roles.py +194 -45
  145. package/runtime/python/okstra_ctl/wizard/sources.py +10 -1
  146. package/runtime/python/okstra_ctl/wizard/state.py +67 -20
  147. package/runtime/python/okstra_ctl/wizard/steps_roles.py +6 -3
  148. package/runtime/python/okstra_ctl/wizard/worker_settings.py +129 -25
  149. package/runtime/python/okstra_ctl/worker_audit_ledger.py +44 -8
  150. package/runtime/python/okstra_ctl/worker_prompt_body.py +26 -2
  151. package/runtime/python/okstra_ctl/worker_prompt_headers.py +12 -9
  152. package/runtime/python/okstra_token_usage/claude.py +5 -1
  153. package/runtime/python/okstra_token_usage/collect.py +3 -3
  154. package/runtime/python/okstra_token_usage/pricing.py +1 -0
  155. package/runtime/schemas/report-synthesis-packet-v1.0.schema.json +17 -0
  156. package/runtime/skills/_fragments/wizard-relay-protocol.md +1 -1
  157. package/runtime/skills/okstra-code-review/SKILL.md +1 -1
  158. package/runtime/skills/okstra-code-review/references/census-rules.md +1 -1
  159. package/runtime/skills/okstra-code-review/references/review-calibration.md +1 -1
  160. package/runtime/skills/okstra-discussion/SKILL.md +1 -1
  161. package/runtime/skills/okstra-run/SKILL.md +33 -2
  162. package/runtime/skills/okstra-tdd/SKILL.md +74 -13
  163. package/runtime/templates/reports/html/assets/implementation-comparison.css +39 -0
  164. package/runtime/templates/reports/html/assets/implementation-comparison.js +55 -0
  165. package/runtime/templates/reports/html/i18n/en.json +113 -0
  166. package/runtime/templates/reports/html/i18n/ko.json +113 -0
  167. package/runtime/templates/reports/html/implementation-comparison.template.html +77 -0
  168. package/runtime/templates/reports/implementation-comparison-notes.md +72 -0
  169. package/runtime/templates/trace/trace.template.md +2 -0
  170. package/runtime/templates/worker-prompt-preamble.md +12 -2
  171. package/runtime/validators/validate-report-views.py +4 -36
@@ -1 +1 @@
1
- {"version":3,"file":"python-helper.mjs","sourceRoot":"","sources":["../../src/lib/python-helper.mts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"python-helper.mjs","sourceRoot":"","sources":["../../src/lib/python-helper.mts"],"names":[],"mappings":"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"}
@@ -16,6 +16,7 @@ export const RUNTIME_BIN_FILES = Object.freeze([
16
16
  { name: "okstra-grok-exec.sh" },
17
17
  { name: "okstra-kimi-exec.sh" },
18
18
  { name: "okstra-zai-exec.sh" },
19
+ { name: "okstra-qwen-exec.sh" },
19
20
  { name: "okstra-provider-exec.py" },
20
21
  // 진입 스크립트들이 import 하는 경로 부트스트랩. 이들과 같은
21
22
  // 디렉터리에 있어야 `sys.path` 를 고치기 전에 import 된다.
@@ -1 +1 @@
1
- {"version":3,"file":"runtime-payload.mjs","sourceRoot":"","sources":["../../src/lib/runtime-payload.mts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,EAAE;AACF,oCAAoC;AACpC,0DAA0D;AAC1D,iEAAiE;AACjE,+CAA+C;AAC/C,kDAAkD;AAClD,EAAE;AACF,kCAAkC;AAalC,yDAAyD;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAA8B,MAAM,CAAC,MAAM,CAAC;IACxE,EAAE,IAAI,EAAE,WAAW,EAAE;IACrB,EAAE,IAAI,EAAE,sBAAsB,EAAE;IAChC,EAAE,IAAI,EAAE,uBAAuB,EAAE;IACjC,EAAE,IAAI,EAAE,4BAA4B,EAAE;IACtC,EAAE,IAAI,EAAE,qBAAqB,EAAE;IAC/B,EAAE,IAAI,EAAE,qBAAqB,EAAE;IAC/B,EAAE,IAAI,EAAE,oBAAoB,EAAE;IAC9B,EAAE,IAAI,EAAE,yBAAyB,EAAE;IACnC,uCAAuC;IACvC,2CAA2C;IAC3C,EAAE,IAAI,EAAE,qBAAqB,EAAE;IAC/B,EAAE,IAAI,EAAE,wBAAwB,EAAE;IAClC,EAAE,IAAI,EAAE,4BAA4B,EAAE;IACtC,EAAE,IAAI,EAAE,0BAA0B,EAAE;IACpC,EAAE,IAAI,EAAE,qBAAqB,EAAE,MAAM,EAAE,IAAI,EAAE;IAC7C,EAAE,IAAI,EAAE,+BAA+B,EAAE,MAAM,EAAE,IAAI,EAAE;IACvD,EAAE,IAAI,EAAE,+BAA+B,EAAE,MAAM,EAAE,IAAI,EAAE;IACvD,EAAE,IAAI,EAAE,+BAA+B,EAAE,MAAM,EAAE,IAAI,EAAE;IACvD,EAAE,IAAI,EAAE,2BAA2B,EAAE,MAAM,EAAE,IAAI,EAAE;IACnD,EAAE,IAAI,EAAE,uBAAuB,EAAE,MAAM,EAAE,IAAI,EAAE;CAChD,CAAC,CAAC;AAEH,0DAA0D;AAC1D,MAAM,CAAC,MAAM,uBAAuB,GAAsB,MAAM,CAAC,MAAM,CAAC;IACtE,gBAAgB;IAChB,YAAY;IACZ,oBAAoB;IACpB,eAAe;CAChB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA2C,MAAM,CAAC,MAAM,CAAC;IACrF,CAAC,oBAAoB,EAAE,gBAAgB,CAAC;IACxC,CAAC,QAAQ,EAAE,QAAQ,CAAC;IACpB,CAAC,SAAS,EAAE,SAAS,CAAC;IACtB,CAAC,SAAS,EAAE,SAAS,CAAC;IACtB,CAAC,WAAW,EAAE,WAAW,CAAC;IAC1B,CAAC,YAAY,EAAE,YAAY,CAAC;IAC5B,CAAC,QAAQ,EAAE,QAAQ,CAAC;CACZ,CAAC,CAAC;AAEZ,uDAAuD;AACvD,MAAM,CAAC,MAAM,oBAAoB,GAAsB,MAAM,CAAC,MAAM,CAClE,iBAAiB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAC7C,CAAC;AAEF,uDAAuD;AACvD,MAAM,CAAC,MAAM,mBAAmB,GAAsB,MAAM,CAAC,MAAM,CACjE,iBAAiB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAC7E,CAAC"}
1
+ {"version":3,"file":"runtime-payload.mjs","sourceRoot":"","sources":["../../src/lib/runtime-payload.mts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,EAAE;AACF,oCAAoC;AACpC,0DAA0D;AAC1D,iEAAiE;AACjE,+CAA+C;AAC/C,kDAAkD;AAClD,EAAE;AACF,kCAAkC;AAalC,yDAAyD;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAA8B,MAAM,CAAC,MAAM,CAAC;IACxE,EAAE,IAAI,EAAE,WAAW,EAAE;IACrB,EAAE,IAAI,EAAE,sBAAsB,EAAE;IAChC,EAAE,IAAI,EAAE,uBAAuB,EAAE;IACjC,EAAE,IAAI,EAAE,4BAA4B,EAAE;IACtC,EAAE,IAAI,EAAE,qBAAqB,EAAE;IAC/B,EAAE,IAAI,EAAE,qBAAqB,EAAE;IAC/B,EAAE,IAAI,EAAE,oBAAoB,EAAE;IAC9B,EAAE,IAAI,EAAE,qBAAqB,EAAE;IAC/B,EAAE,IAAI,EAAE,yBAAyB,EAAE;IACnC,uCAAuC;IACvC,2CAA2C;IAC3C,EAAE,IAAI,EAAE,qBAAqB,EAAE;IAC/B,EAAE,IAAI,EAAE,wBAAwB,EAAE;IAClC,EAAE,IAAI,EAAE,4BAA4B,EAAE;IACtC,EAAE,IAAI,EAAE,0BAA0B,EAAE;IACpC,EAAE,IAAI,EAAE,qBAAqB,EAAE,MAAM,EAAE,IAAI,EAAE;IAC7C,EAAE,IAAI,EAAE,+BAA+B,EAAE,MAAM,EAAE,IAAI,EAAE;IACvD,EAAE,IAAI,EAAE,+BAA+B,EAAE,MAAM,EAAE,IAAI,EAAE;IACvD,EAAE,IAAI,EAAE,+BAA+B,EAAE,MAAM,EAAE,IAAI,EAAE;IACvD,EAAE,IAAI,EAAE,2BAA2B,EAAE,MAAM,EAAE,IAAI,EAAE;IACnD,EAAE,IAAI,EAAE,uBAAuB,EAAE,MAAM,EAAE,IAAI,EAAE;CAChD,CAAC,CAAC;AAEH,0DAA0D;AAC1D,MAAM,CAAC,MAAM,uBAAuB,GAAsB,MAAM,CAAC,MAAM,CAAC;IACtE,gBAAgB;IAChB,YAAY;IACZ,oBAAoB;IACpB,eAAe;CAChB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA2C,MAAM,CAAC,MAAM,CAAC;IACrF,CAAC,oBAAoB,EAAE,gBAAgB,CAAC;IACxC,CAAC,QAAQ,EAAE,QAAQ,CAAC;IACpB,CAAC,SAAS,EAAE,SAAS,CAAC;IACtB,CAAC,SAAS,EAAE,SAAS,CAAC;IACtB,CAAC,WAAW,EAAE,WAAW,CAAC;IAC1B,CAAC,YAAY,EAAE,YAAY,CAAC;IAC5B,CAAC,QAAQ,EAAE,QAAQ,CAAC;CACZ,CAAC,CAAC;AAEZ,uDAAuD;AACvD,MAAM,CAAC,MAAM,oBAAoB,GAAsB,MAAM,CAAC,MAAM,CAClE,iBAAiB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAC7C,CAAC;AAEF,uDAAuD;AACvD,MAAM,CAAC,MAAM,mBAAmB,GAAsB,MAAM,CAAC,MAAM,CACjE,iBAAiB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAC7E,CAAC"}
@@ -95,6 +95,7 @@ export interface PythonModuleOptions {
95
95
  readonly extraEnv?: Readonly<Record<string, string | undefined>>;
96
96
  readonly stdio?: "capture" | "inherit-stdout" | "ignore";
97
97
  readonly timeoutMs?: number;
98
+ readonly input?: string;
98
99
  }
99
100
  export interface InstalledScriptOptions {
100
101
  readonly scriptName: string;
@@ -19,6 +19,28 @@ Trace publication and task projection are separate recoverable operations;
19
19
  `trace_tasks.py` enforces these boundaries; `tests/run/test_trace_tasks.py` and
20
20
  `tests/run/test_prepare.py` verify retries, ownership and preservation.
21
21
 
22
+ 새 구현 실행은 첫 리더 지침 발행 전에 실제 단계 작업 공간의 시작 자료를 보존한다. 실행 매니페스트의 `implementationComparison`은 실행 소유 비교 디렉터리와 최초 작업 기준을 별도로 가리킨다. 비교 선언은 첫 전체 매니페스트에 기존 실행 계약과 함께 저장한다. 여러 신규 준비의 미발행 선언은 서로를 과거 실행으로 취급하지 않으며, 작업 소유 잠금 안에서 최초 수집 시도를 먼저 기록한다. 기존 참조·실패·이미 게시된 지침이 있으면 현재 소스를 새 작업 기준으로 수집하지 않는다. 새 추적 시도는 문서를 저장한 직후, 첫 구현 지시를 반환하기 전에 문서 옆 `<attempt-stem>.comparison/`에 같은 기준을 보존한다. 추적 문서의 frontmatter 버전과 기존 완료 기록은 변경하지 않는다.
23
+
24
+ 공통 `implementation_comparison` 모듈이 `baseline.json`, 한도 안의 텍스트 내용, Git 목록·상태·인덱스 출력을 소유한다. 기준 커밋과 실제 시작 작업 파일을 구분하며, 기존 스테이징·미추적 파일도 수집한다. 경로 10,000개, 파일당 실제 읽기 1 MiB·합계 64 MiB, Git 명령당 표준 출력·오류 합계 4 MiB·수집 합계 8 MiB를 적용한다. 링크 대상을 따라가지 않으며, 전체 내용을 읽지 못한 파일에 완전한 내용 해시를 부여하지 않는다. 누락·수집 중 변경·제외 범위는 기준의 제한으로 남긴다.
25
+
26
+ 내용 보존의 범위는 실제 시작 작업 파일의 텍스트다. 기준 커밋 전체 트리와 인덱스의 모든 파일 내용은 별도로 복제하지 않으며, 인덱스는 객체 식별자·모드·단계와 한도 안의 패치로 보존한다. 기준 자료의 `scope`가 이 차이를 기록한다. 객체 식별자만 남은 과거 파일의 전체 내용을 산출물에 보존했다고 해석하지 않는다.
27
+
28
+ 소유 비교 디렉터리의 잠금과 최초 실패 표식이 재개 중 기준 교체를 막는다. 상태 조회는 저장 자료의 정체성과 내용 해시를 검사하며 현재 소스를 다시 수집하지 않는다. 새 계약이 없는 과거 실행·시도에 기준을 소급 생성하지 않는다. 비교 자료 실패는 기존 준비·추적 상태를 되돌리지 않으며, 수집 결과와 제한을 별도로 반환한다. 전체 제한 사유는 기준 자료에 보존하고 명령 응답은 JSON·개행을 합쳐 64 KiB 이내의 요약과 전체 개수·생략 여부를 반환한다. Python이 비교 위치를 선택하며, 위치 계획과 실제 파일 접근의 링크 거부를 구분하므로 선택적 비교 경로 오류를 기존 준비 실패로 바꾸지 않는다. 수집 경계는 `implementation_comparison/source.py`와 `baseline.py`, 준비 선언·수집 정책은 `preparation.py`, 호출 연결은 `run.py`와 `src/commands/trace/comparison.mts`가 소유한다. 공통 경계는 `tests/report/test_implementation_comparison.py`, 준비 순서는 `tests/run/test_prepare.py`, 추적 명령은 `tests-js/trace.test.mjs`가 검증한다.
29
+
30
+ 공통 종료 대상은 비교 디렉터리의 `targets/<generation>/target.json`과 내용 파일에 보존하고 `target-current.json`으로 가리킨다. 세대는 확정된 입력의 SHA-256이며 같은 세대의 실패·중단도 다시 수집하지 않는다. 추적 시도는 최초 세대를 고정하고 실행의 수정 라운드만 새 세대를 사용할 수 있다. 추적 전용 수집 경계는 저장 원본 지문과 세대의 일치 및 통합 완료를 확인하며, 완료 판정은 기존 추적 이력과 공유한다. `assembly.py`는 원본 바이트 지문·소유 정체성에 결합한 정규화 자료와 `notes.json`의 주장별 근거 참조를 조립한다. 작성자가 명령 종료 코드나 검증 판정을 대체할 수 없으며, 세션 기록의 실행 대상 귀속을 자동으로 인정하지 않는다. 소스 발췌는 80줄·8 KiB, 합계 1 MiB, 파생 자료는 8 MiB로 제한한다. 원본이 읽는 도중 바뀌면 `stale`, 설명 누락·잘못된 연결·수집 누락은 부분 자료로 남긴다. `html.py`는 이 자료를 네트워크 자원이 없는 HTML 문자열로 표시하며 한국어 외 고정 문구는 영어로 대체한다. 원문 설명의 언어는 유지한다. 공통 자료 검사는 `tests/report/test_implementation_comparison.py`, 표시 검사는 `tests/report/test_implementation_comparison_html.py`가 소유한다.
31
+
32
+ `inputs.py`는 같은 실행 매니페스트 바이트에서 소유자·비교 위치·선택 원본을 해소한다. 원본 보고서와 매니페스트는 각각 16 MiB, 정규화 전달 자료는 공백 없는 ASCII JSON으로 1 MiB까지 읽는다. 검증 행은 변환 전에 개수를 제한하며, 큰 원본의 설명·행을 생략하면 그 사유를 부분 자료에 남긴다. 실행 원본은 해당 `RunRef.reports_dir`의 직속 파일만 허용한다. 과거 매니페스트에 카테고리 순번이 없으면 선언된 원본 파일명에서 보고서 순번을 읽으며 실행 순번으로 대체하지 않는다. 기존 보고서의 명령은 세션 기록으로 표시하고 근거 출처나 종료 대상 귀속을 자동 승격하지 않는다. 추적 기록의 단계·검사 종류·기록 시각·실패 원인도 유지하며, RED와 기존 사용자 동작의 결함 재현을 구분한다.
33
+
34
+ `publication.py`는 소유 범위의 `.report-publication.lock` 안에서 최신 원본을 읽고 판 번호를 결정한다. 같은 입력의 정상 판은 생성 시각까지 재사용한다. 추적 시도의 판은 비교 디렉터리의 `report-NNN.data.json`·`.html`, 실행의 판은 선택 원본과 나란한 `implementation-comparison-<report-seq>-rNNN.data.json`·`.html`이다. 실행 순번과 보고서 순번을 혼용하지 않는다. 새 자료·HTML을 검사하고 모든 입력 지문을 다시 대조한 뒤 `current.json`을 마지막에 교체한다. 실패하면 이전 포인터를 보존하고, 이미 저장된 고아 판의 번호도 재사용하지 않는다. 자료·HTML은 각각 8 MiB, 현재 포인터는 16 MiB로 제한한다. 상태 조회는 포인터·산출물·소비 입력을 검사하되 게시 잠금 파일을 만들지 않는다. 이 경계는 `tests/report/test_comparison_publication.py`가 검사한다.
35
+
36
+ 기존 구현 HTML의 선택적 링크 갱신은 같은 게시 잠금과 기존 HTML 지문을 대조한다. 최초 HTML 읽기는 8 MiB, 교체 직전 원본과 HTML의 재읽기는 각각 16 MiB로 제한한다. 독립 비교 판과 기존 HTML 링크는 별도 결과이며 링크 실패가 앞서 게시한 판을 삭제하지 않는다. 공개 `implementation-report render`는 저장 추적 원본 또는 실행 매니페스트를 읽어 같은 게시기를 사용한다. TDD는 통합 성공 저장 뒤 종료 대상을 보존하며 현재 세션이 설명을 쓴 다음 명시적으로 HTML을 생성한다. `status`·`sync`는 종료 대상을 다시 수집하지 않는다. 실행의 `run_integration.py`는 작성자 전달 전에 현재 완료 세대의 종료 대상을 보존하고 합성 자료에 정확한 선택적 설명 경로·공통 안내·실제 검사 기록을 전달한다. 권한 생산자 두 곳은 해당 실행의 보고서 작성자에게 그 파일 하나만 추가하며, 필수 완료 산출물에는 넣지 않는다. 정상 검증 뒤 자동 게시와 기존 HTML 링크 갱신을 각각 반환한다. 완전히 결합된 종료 대상 이후 실제 소스의 변경을 발견하면 자동 게시를 보류하고 이전 포인터를 유지한다. 공개 재생성과 상태 조회는 현재 작업 공간을 요구하지 않는다. 작업 전체는 `task_selection.py`와 `task_assembly.py`가 선택된 단계의 저장 자료를 조립하며 같은 게시기·소유 잠금을 사용한다. 기존 최종 보고서·추적 문서·작업 이력 포인터는 계속 각 원본이 소유한다.
37
+
38
+ 작업 전체 비교의 읽기 전용 기반은 `implementation_comparison/task_selection.py`의 `read_task_comparison_selection`이다. 최신 계획의 숫자 순번·활성 단계, 기존 소비 원장의 순수 상태 투영, 정본 이월의 성공 등급과 계획 재번호 대조를 재사용한다. 선택한 완료 보고서를 실행 매니페스트의 실제 선언과 결합하며 보고서 순번으로 실행 순번을 추측하지 않는다. 결과는 필수 단계·선택된 단계·기존 생명주기·저장된 `phaseOutcome.implementation`·선택 정체성·실제 입력 지문·한계를 포함한다. 반환된 선택 과정의 `complete`는 구현 완료 판정이 아니며 이 API는 완료 기록을 쓰거나 이월을 복구하지 않는다.
39
+
40
+ 파일별 16 MiB·공유 읽기 예산 192 MiB, 경로와 필터 전 원시 항목 10,000개, 확장 전 원장 행과 계획 단계 수의 한도, 선택 JSON 1 MiB를 적용한다. 실제 읽기·한도 오류에서 접두의 단계 집합을 완전한 선택으로 반환하지 않으며, 오류 결과에도 선택 JSON 한도를 적용한다. 파일 지문과 후보·선택 정체성은 분리한다. 뒤의 게시 소비자는 새 후보 파일도 다시 선택해야 하며 잠금·임시 파일을 가짜 입력 지문으로 넣지 않는다. 공통 철회 투영은 `failed` 뒤의 `started`가 과거 `done`을 복원하지 않게 하며 철회 없는 시작과 새 완료는 유지한다. 이 기반은 `tests/report/test_implementation_comparison.py`의 저장 자료·재개방·계획·후보·한도 사례와 `tests/run/test_prepare.py`의 공통 상태 회귀로 검사한다. `task_assembly.py`는 같은 예산을 단계별 원본·보존 내용 검증까지 전달하고 단계별 정체성을 붙인다. 기존 단계 게시 잠금을 추가로 얻지 않는다. 작업 전체 게시 잠금 안에서 선택하며 게시 직전에 새 계획·매니페스트 후보와 실행 시도·검사 선택을 다시 확인한다. 단계 완료 뒤의 자동 갱신과 `--scope task`가 같은 게시기를 사용하며 기존 완료·검증·인계 포인터는 바꾸지 않는다. 통합 증명에는 읽기 전용 Git 조회의 명령별 4 MiB·누적 8 MiB·조립 요청이 공유하는 Git 조회 마감 10초 한도를 적용한다. 이 수치는 초기 한도이며 실행 성능 보장이 아니다. 자료 조립의 공유 읽기 한도와 게시 전 입력·선택 재검사의 한도는 각각 별도 검증 구간이다.
41
+
42
+ 기존 최종 보고서 HTML은 `report_html/render.py`가 같은 디렉터리의 임시 파일에 완성·검사하고 원본 지문을 재확인한 뒤 교체한다. `report_html/validation.py`의 자원·앵커 검사는 기존 검증기와 공유한다. `tests/report/test_finalize.py`가 실제 생성기의 쓰기·검사·원본 변경·교체 실패에서 기존 파일 보존과 오류 전파를 검사한다.
43
+
22
44
  Verification inputs version `3.0` requires `reviewPolicy`: a versioned frozen
23
45
  architecture declaration and source bodies with SHA-256 digests. Preparation
24
46
  captures the coding-preflight pack, project-root `AGENTS.md` and `CLAUDE.md`,
@@ -407,6 +429,34 @@ observation and no applicability or skip disposition per frozen check, so the
407
429
  report neither distinguishes an unconfirmed server target nor checks that every
408
430
  applicable check ran. No automated test covers these rules.
409
431
 
432
+ 비교 보고서의 후속 소비자를 위해 `collect_report_evidence_snapshot`은 기존 근거 행과 함께
433
+ 실제로 읽은 입력의 지문 및 검증자별 호출·시도·세대·최신 검사 실행 선택을 반환한다.
434
+ 기록의 필드와 `recordDigest`는 한 번 읽어 검증한 같은 바이트에서 나온다. 선택적 바이트
435
+ 읽기 함수와 디렉터리 열거 함수를 주입하는 소비자는 읽기·열거 전에 한도를 적용할 수 있다.
436
+ 기존 `collect_report_evidence`의 반환 필드와 기본 선택은 유지한다. 새 검사 디렉터리의
437
+ 생성은 기존 파일 지문에 드러나지 않으므로, 후속 게시자는 지문과 선택 결과를 함께
438
+ 대조해야 한다.
439
+
440
+ `implementation_generation_evidence.read_settled_implementation_generation`은 기존 실행 정체성·예약·
441
+ 완료 반환 봉인·검증 세대 결합을 재사용해 현재 구현 세대를 읽는다. 최신 구현자나 검증자의
442
+ 시도가 미완료이거나 실패했거나 같은 세대를 입증하지 못하면 과거 완료 세대를 선택하지
443
+ 않고 제한을 반환한다. 명령의 종료 코드나 검증자의 FAIL 판정에 PASS를 요구하는 새
444
+ 승인 조건을 추가하지 않는다. 고정 입력 3.0의 실행에도 적용하고, 4.0에서는 기존 설계
445
+ 기준 결합을 재사용한다. 같은 구현자 호출의 재시도와 세대 사이에 명시적 시도 결합이
446
+ 없으면 그 순서를 입증할 수 없다고 표시한다. `implementation_comparison/run_evidence.py`가
447
+ 이 권위와 실제 명령 기록의 같은 바이트를 재사용해 보존 대상 귀속을 판정한다. 작성자가
448
+ 기입한 검증 상태나 출처는 귀속 근거가 아니다. 게시·재사용·상태·링크 확인은 알려진 파일
449
+ 지문과 현재 세대·시도·최신 검사 선택을 함께 다시 대조한다. 새 검사 디렉터리만 생겨도
450
+ 이전 판을 현재로 반환하지 않는다. 관련 연결은 `tests/verification/test_report_execution_evidence.py`가 검사한다.
451
+
452
+ 두 읽기 경로는 `qa_procedures.read_fingerprinted_artifact`의 지문 기록과 재읽기 판정을
453
+ 공유한다. 처음 읽을 수 없는 입력은 지문에 `None`을 남기며, 앞서 읽은 입력의 재읽기가
454
+ 실패하거나 내용이 바뀌면 앞선 지문을 유지하고 거부한다. 실제 읽기 실패는 원인을 연결해
455
+ 전달한다. 전체 기록·출력 객체의 보관은 새 스냅샷 호출이 명시적으로 요청할 때만
456
+ 수행하고, 기존 수집기는 요약과 같은 바이트 지문을 만든 뒤 검사별 원본을 해제한다.
457
+ 이 경계는 기존 `tests/verification/test_report_execution_evidence.py`와
458
+ `tests/verification/test_design_review.py`가 실제 재읽기·객체 수명·별칭·한도를 검사한다.
459
+
410
460
  `okstra model-io run-input --run-manifest <path>` projects the recorded
411
461
  `verificationInputsPath` and `verificationInputsDigest` as fixed scalar lines.
412
462
  Absent or non-scalar values display `-`, including older manifests without a
@@ -333,7 +333,7 @@ The standard `okstra` workflow applies the following team contract consistently
333
333
  - The current host-native provider owns the synthesis-only lead session: Claude on Claude Code, Codex on Codex.
334
334
  - Every selected worker comes from the profile roster and provider capability registry. The default analysis policy remains Claude + Codex + a report writer; Antigravity, Grok, and Kimi are attempted only when the profile and resolved roster include them.
335
335
  - `Report writer worker` focuses on report structure and evidence organization, while the host-native lead remains the final synthesis owner. Claude is the default report-writer provider; Codex may be selected explicitly.
336
- - Model defaults are provider and functional-role policy. Fallbacks include Claude lead/analyser=`opus`, Codex lead/analyser=`gpt-6.1-sol`, Claude report writer=`sonnet`, Antigravity=`gemini-3.1-pro`, Grok analyser=`grok-4.7`, and Kimi analyser=`kimi-k3`. Selectable catalog models may be assigned to every role.
336
+ - Model defaults are provider and functional-role policy. Fallbacks include Claude lead/analyser=`opus`, Codex lead/analyser=`gpt-6.2-sol`, Claude report writer=`sonnet`, Antigravity=`gemini-3.1-pro`, Grok analyser=`grok-4.7`, and Kimi analyser=`kimi-k3`. Selectable catalog models may be assigned to every role.
337
337
  - Before the final judgment, each required role in the current run's worker roster must have either a result or an explicit terminal status (`completed`, `timeout`, `error`, `not-run`).
338
338
  - Every attempted worker (`completed`, `timeout`, `error`) must have an assigned worker prompt history file under the current run's `prompts/` directory.
339
339
  - Worker timing begins at the atomic transition to `in-progress`, which records `workers[].startedAt` in `team-state.json`; prompt creation time is not a dispatch proxy. `okstra worker-state transition` and both dispatch adapters share `dispatch_state.transition_worker_status`, while `okstra worker-liveness --team-state ... --worker ...` reads that timestamp as the launch-grace authority for both probe kinds — the in-process audit sidecar is reused on re-dispatch, so only `startedAt` separates the previous attempt's last heartbeat from this dispatch's silence.
package/docs/cli.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # okstra-run 입력 형식과 사용량 정책
2
2
 
3
+ ## 작업자 모델과 인증
4
+
5
+ 새 선택에는 Codex GPT-6.1 Terra, Kimi K3.1 Pro·Highspeed, Antigravity Gemini 4 Carbon·Hydrogen, Z.ai GLM-5.3 FlashX·Legal, Qwen4-Max가 포함된다. Kimi 기본값은 `k3.1-pro`, Antigravity 기본값은 `gemini-4-argon`이다. 구형 `kimi-k3`·`gemini-3.1-pro`는 새 선택에서 제외하지만 과거 실행의 검증과 정산 정보는 보존한다. 저장된 새 실행 설정에 구형 모델이 있으면 현재 모델로 다시 선택한다. Gemini와 Codex는 기존 계정별 가용성 검사를 사용하며 다른 모델로 자동 대체하지 않는다. FlashX 계열은 일반 API용이고 GLM Coding Plan에는 제공되지 않는다.
6
+
7
+ Qwen 작업자는 `qwen/qwen4-max`로 선택한다. `qwen` 실행 파일과 해당 지역의 `DASHSCOPE_API_KEY`, `OKSTRA_QWEN_BASE_URL`을 실행 환경에 준비한다. 주소는 Model Studio 소유 호스트의 HTTPS OpenAI 호환 기본 주소(`/compatible-mode/v1`)이며 개인 CLI의 로컬 주소를 상속하지 않는다. 워크스페이스·지역별 `*.maas.aliyuncs.com` 주소와 기존 `dashscope.aliyuncs.com`·`dashscope-intl.aliyuncs.com`·`cn-hongkong.dashscope.aliyuncs.com` 주소를 허용하며 사용자 정보·쿼리·프래그먼트·비표준 포트를 거부한다. 키는 명령 인자가 아닌 자식 환경으로 전달한다. 자식 프로세스에는 배포된 시스템 공급자 설정을 적용해 개인·프로젝트의 같은 모델 설정보다 주소·인증 출처를 우선한다. Qwen은 작업자 역할만 지원하며 사용자 홈에 설치한 `qwen-local`과 별도다. Qwen Code의 `message.model`은 요청 설정의 복사이므로 실제 응답 모델로 증명하지 않고 미확인으로 남긴다. 최종 이벤트에서 관측한 토큰 수는 캐시 읽기와 분리해 수집한다. 지역별 Qwen 단가와 신규 Gemini 단가는 추정해 넣지 않으므로 비용은 미확인으로 남을 수 있다. 실제 유료 모델 호출과 계정 권한은 별도로 확인해야 한다.
8
+
3
9
  새 실행은 run manifest에 `reportAuthoringFormat: "json-v1"`과 `usageAccountingPolicy: "advisory"`를 기록한다. 작성자 입력은 `reportNarrativePath`의 `.json` 파일에 허용된 작성자 소유 값만 쓰며, 설명 문자열에는 Markdown을 사용할 수 있다. 최종 보고서의 `schemaVersion`과 `reportContractVersion`은 `3.0`을 유지한다. 필드가 없는 기존 실행은 `markdown-v1`·`strict`로 읽으며, 알 수 없는 값은 거부한다.
4
10
 
5
11
  `json-v1` 작성자 입력은 UTF-8 2,000,000바이트, 루트를 0으로 세고 스칼라 값을 포함한 깊이 32까지 받는다. 소유권 검사에서 방문한 필드 경로의 누적 길이는 64,000,000문자까지 허용한다. 초과·재귀 오류는 작성자 입력 결함으로 처리하며, 교정 결과도 같은 크기 제한을 통과한 뒤 게시한다. 보존된 교정 기준은 worker 결과 디렉터리의 일반 파일이어야 하고 심볼릭 링크는 거부한다. 이 한도는 작성자 JSON의 판독·교정 계약이며 최종 `data.json`의 크기 제한은 아니다.
@@ -66,17 +72,30 @@ time; `createdAt` includes its time-zone offset. The result is
66
72
  `{path, currentStep, steps, ids, nextAction, failStreak, commitPoint}`.
67
73
  `nextAction` is `write`, `review`, `ask-user-decision`, `run-tests` or `done`.
68
74
 
69
- `reviewers` works on the current review step. It returns the operation, duty,
70
- `binding` text and reviewer `slots`. `analysis-review` and `spec-review` use the
71
- `trace-scope-review` operation (`scope-critic`); `interface-review` uses
72
- `trace-interface-review` (`interface-reviewer`). Slots come from the registered
73
- model pool, ordered so models outside the host's own provider come first;
74
- `--count` defaults to 1, must be a positive integer, and is capped by the
75
- operation contract (`INVALID_ARGUMENT` otherwise). `independence` is
76
- `cross-provider` when a slot's provider differs from the host's own provider,
77
- otherwise `same-provider`. The binding names the trace path, step, next round,
78
- the SHA-256 digest of the reviewed writing section's raw text (fenced blocks
79
- included) and the host runtime.
75
+ 상태 응답의 `comparison`에는 기존 기준 필드와 함께 `target`·`report` 조회 결과가 붙는다. 대상의 `targetRef`가 `null`이면 수집된 종료 소스가 없다는 뜻이며, 비교 판이 없으면 `report.status`는 `not-generated`다. 정상 판의 `current`, 소비 입력이나 산출물이 달라진 `stale`, 읽기 실패의 `failed`를 구현 완료 상태와 구분한다. 보고서 조회만 실패해도 정상 기준·대상 참조는 유지한다. 상태 조회는 테스트·상태 전이·소스 재수집·HTML 생성을 수행하지 않는다. 통합 성공을 저장한 `advance`는 이력 동기화 전에 종료 대상을 한 번 보존하고 `comparison.renderCommand`를 반환한다. 이 응답에서 HTML을 즉시 생성하지 않는다. `sync`는 종료 대상을 다시 수집하지 않는다. 내부 JSON 경계와 상태 검사는 `tests/report/test_implementation_comparison.py`, 기존 추적 시도의 기준 보존 검사는 `tests-js/trace.test.mjs`가 확인한다.
76
+
77
+ 비교 HTML은 저장된 원본과 종료 대상으로 별도 생성한다. 현재 세션은 완료 응답의 실제 `notesPath`에 공통 안내(`templates/reports/implementation-comparison-notes.md`)의 설명을 작성한 뒤 반환된 명령을 실행한다. `notesPath`가 `null`이면 경로를 계산하지 않고 `trace status --path`로 재조회한다. 재조회 후에도 경로가 없으면 구현 완료·이력 동기화 결과와 비교 생성 불가를 따로 안내한다. 경로는 있지만 기준·종료 참조가 없는 경우에는 해당 제한을 남긴 부분 보고서를 만들 수 있다.
78
+
79
+ ```bash
80
+ okstra implementation-report render --trace <file>
81
+ okstra implementation-report render --run-manifest <file> [--scope task] [--project-root <dir>]
82
+ ```
83
+
84
+ 추적 원본과 실행 매니페스트 중 하나를 선택한다. 명령은 `published`·`reused`에서 종료 코드 0, `stale`·`failed`와 입력 오류에서 1을 반환한다. 정상 응답의 `dataPath`·`htmlPath`는 프로젝트 기준 경로이며, `reportStatus`의 `ready`는 읽을 수 있다는 뜻으로 모든 동작의 실행 검증을 뜻하지 않는다. 저장 원본으로 재생성하므로 구현·검사·이력 동기화를 반복하지 않는다. 비교 선언이 있는 구현 실행은 작성자 전달 전에 종료 대상을 보존하고, 정상 검증을 마친 `report-finalize`에서 비교 게시와 기존 HTML 링크 갱신을 각각 반환한다. 작성자는 합성 자료의 실제 실행 근거와 공통 안내를 사용해 선택적 설명을 작성한다. 보존 뒤 소스 변경을 발견하면 자동 게시를 보류한다. 비교·링크 오류는 기존 완료 결과와 분리한다.
85
+
86
+ `--scope task`는 선택한 구현 실행이 속한 작업을 해소해 최신 계획과 유효한 완료·이월 기록으로 전체 보고서를 만든다. 단계별 설명·실행 근거의 정체성을 유지하며, 같은 파일의 변경이나 효과를 합산하지 않는다. 단일 누적 종료 대상은 선택된 모든 단계의 커밋을 포함하는 Git 관계와 보존 소스·인덱스의 일치가 입증될 때만 제공한다. 병렬 분기나 미커밋 상태의 포함 여부를 입증하지 못하면 단계별 전후 상태와 관찰 경로의 합집합을 표시한다. 보고서 생성은 읽기 전용 Git 조회만 허용하고 병합·재배치·검사·모델 호출을 수행하지 않는다. 실제 `stage-done`은 완료 기록을 쓴 뒤 같은 전체 게시기를 호출하고 선택적 `comparison` 결과를 반환한다. 비교 실패는 완료·이월을 취소하지 않으며 같은 `--scope task` 명령으로 보고서만 다시 생성한다.
87
+
88
+ 기준 없는 옛 기록은 추적 문서의 기록된 `baseCommit` 또는 동결 입력 4.0의 `reviewBase`를 읽을 수 있을 때 커밋 내용을 사후 복원한다. 당시 작업 파일·인덱스·미추적 상태는 알 수 없으므로 기존 기준으로 승격하지 않는다. 기존 업무 설명은 선택 보고서 해시와 프로젝트·HEAD·전체 파일 집합·내용·인덱스가 같은 저장 자료만 재사용하고 기존 문서 출처로 표시한다. 다른 프로젝트를 검색하거나 설명을 다시 생성하지 않는다.
89
+
90
+ `new`는 프로젝트 루트가 Git 저장소 안에 있고 `.okstra/` 밖에 커밋하지 않은 변경이나 추적하지 않는 파일이 없을 때, 그때의 `HEAD`를 `baseCommit`으로 기록한다. 시작 전에 있던 변경이 이 작업의 줄로 세어지지 않게 하려는 조건이다. `implementation`이 끝난 뒤의 `advance`와 `status` 결과에는 `lineCounts`가 붙는다. 값은 `baseCommit` 이후 프로젝트 루트 아래에서 추가된 줄 수이며, 커밋하지 않은 변경과 추적하지 않는 파일을 포함하고 `.okstra/` 아래 파일은 뺀다. 이름만 바꾼 파일은 바뀐 줄만 센다. `tests-red` 표의 `Path`이거나 일반 테스트 경로 규칙에 맞는 파일은 테스트 줄, 나머지는 소스 줄로 센다. 규칙은 `tests/`·`test/`·`spec/`·`specs/`·`__tests__/`·`testing/`·`testdata/`·`fixtures/`·`e2e/` 디렉터리, `*.test.*`·`*.spec.*`·`*.cy.*`·`*_test.*`·`test_*.py`·`conftest.py`·`tests.py`·`test-utils.*` 파일이다. 결과는 `{available: true, baseCommit, source, test, ratio, threshold: 2, exceeded}`이고, `exceeded`는 테스트 줄이 소스 줄의 2배를 넘을 때 `true`다. 소스 줄이 0이면 `ratio`는 `null`이다. 경고일 뿐 단계 진행을 막지 않는다. 기준 커밋이 없거나 Git이 실패하거나 상한을 넘으면 `{available: false, reason}`이다. 상한은 다음과 같다: Git 출력 4 MiB·30초, 추적하지 않는 파일 2,000개·합계 32 MiB. 4 MiB를 넘거나 NUL 바이트가 있는 파일은 세지 않는다. 진행 중에 병합하거나 리베이스하면 다른 작업의 줄도 함께 세어진다.
91
+
92
+ `reviewers`는 현재 검토 단계에 대해 동작하며, 운영(operation)·직무(duty)·`binding` 문구·검토자 `slots`를 돌려준다. 단계별 운영은 다음과 같다.
93
+
94
+ - `analysis-review`, `spec-review`: `trace-scope-review`(`scope-critic`)
95
+ - `interface-review`: `trace-interface-review`(`interface-reviewer`)
96
+ - `tests-review`: `trace-tests-review`(`test-reviewer`)
97
+
98
+ 슬롯은 등록된 모델 풀에서 고르며, 호스트와 다른 공급자의 모델이 앞에 온다. `--count`는 기본값 1의 양의 정수이고 운영 계약의 상한을 넘으면 `INVALID_ARGUMENT`다. 슬롯 공급자가 호스트 공급자와 다르면 `independence`는 `cross-provider`, 같으면 `same-provider`다. binding에는 trace 경로, 단계, 다음 회차, 검토 대상 절 원문(펜스 블록 포함)의 SHA-256 다이제스트, 호스트 런타임이 들어간다. `tests-review`의 검토 대상 절은 `tests-red`이며, 근거 블록도 다이제스트에 포함된다.
80
99
 
81
100
  `advance` accepts only the current step. A review passes in one of two ways:
82
101
 
@@ -92,9 +111,7 @@ included) and the host runtime.
92
111
  - `--verdict pass --approve "<user quote>"`, the user-approval mode, which records
93
112
  the quote under `approval`.
94
113
 
95
- `--verdict fail` alone always fails the review. Failed reviews return to their
96
- writing step and increment their failure streak. Three consecutive failures ask
97
- the agent to obtain a user decision.
114
+ `--verdict fail`만 주면 검토는 항상 불합격이다. 불합격한 검토는 작성 단계로 돌아가고 연속 실패 횟수를 1 늘린다. 세 번 연속 실패하면 에이전트가 사용자 결정을 받아야 한다. 검토 합격은 검토한 절을 다시 읽는다. `analysis`·`interface-design`은 ID와 `Key`/`Value` 표를 다시 기록하고, `tests-review` 합격은 사용 사례마다 통합 테스트 행이 있는지 다시 검사한다. `tests-review`가 불합격하면 `tests-red`로 돌아가며, 새 RED 근거로 `tests-red`를 다시 진행하면 이전 근거 블록을 새 블록으로 교체한다. 근거를 기록한 적 없는 단계에 근거 표지가 있으면 `TRACE_MALFORMED`로 거부한다.
98
115
 
99
116
  Writing sections use Markdown tables with fixed English headers:
100
117
 
@@ -113,6 +130,8 @@ typecheck GREEN; `tests-red` requires unit and integration RED, each classified
113
130
  remain RED; `integration` requires integration GREEN. Other failure causes are
114
131
  `assertion`, `compile-error`, `import-error` and `other`.
115
132
 
133
+ `tests-review` 단계가 생기기 전에 저장한 시도도 읽는다. 상태에 `tests-review` 기록이 없으면, `tests-red`를 아직 지나지 않은 시도는 `pending`으로, 이미 지난 시도는 검토 없이 `done`(`round: 0`)으로 채운다. 이 기록은 다음 `advance` 때 저장된다.
134
+
116
135
  The command updates JSON frontmatter and appends evidence blocks atomically.
117
136
  The body belongs to the agent. `commitPoint` is set after `interface-code`,
118
137
  `implementation` and `integration`; the command does not commit.
@@ -141,7 +160,8 @@ Without binding options, existing standalone creation is unchanged.
141
160
 
142
161
  A successful linked operation also returns `taskKey`, `task` and `taskSync`.
143
162
  Trace publication precedes task projection. `TASK_SYNC_FAILED` includes
144
- `traceSaved`, `path`, `taskKey` and a retry command. Query `status`, then use
163
+ `traceSaved`, `path`, `taskKey` and a retry command.
164
+ 통합 성공 뒤 동기화 실패 응답에도 `comparison`을 보존한다. 비교 생성 성공이 `TASK_SYNC_FAILED`를 성공으로 바꾸지 않는다. Query `status`, then use
145
165
  `sync` to retry projection without advancing an already saved step. Read-only
146
166
  status returns `taskSync: "pending"` when acknowledgment is unavailable. History
147
167
  retains prior attempts; completion uses direct-work provenance with
@@ -243,6 +263,8 @@ For a stage, pass its identified `--run-manifest <path>` to reuse the author's
243
263
  frozen policy. A missing author-policy reference is unverified policy alignment;
244
264
  do not infer a latest run or claim that independently captured policies match.
245
265
 
266
+ Python이 아닌 코드의 함수 경계를 읽지 못하면 `census`는 `Unresolved function boundaries`에 그 파일을 적고 종료 코드 1을 낸다. `--function-inventory <path>`를 붙여 다시 실행하면, 파일이 없을 때 해당 파일을 `null`로 둔 양식을 쓰고 종료 코드 2를 낸다. 각 항목을 frozen head 기준 `functions: [{start, end, name}]`와 비어 있지 않은 `rationale`로 채운 뒤 다시 실행하면, 변경 줄이 걸친 함수마다 semantic 셀이 생긴다. 양식의 `base`·`head`에는 census에 넘긴 ref를 해석한 커밋이 기록되므로, 새 커밋이 생기면 양식을 다시 만들어야 한다. 범위 검사는 목록이 빠짐없는지 증명하지 않는다.
267
+
246
268
  `okstra code-review assign --census <review-id>.census.md`는 프로젝트 `.okstra/` 아래의
247
269
  전체 census를 축별 배정 census로 나눈다. 셀이 있는 축마다 같은 디렉터리에
248
270
  `<review-id>.<axis>.census.md`를 쓰고, `Axis`·`Cells`·`Census` 줄을 축 순서
@@ -34,6 +34,10 @@ and compact attempt history without a verification run. Regression owners are
34
34
  `tests-js/trace.test.mjs`; run `npm run test:js`
35
35
  separately from `npm run check`.
36
36
 
37
+ 구현 전후 자료의 공통 소유자는 `scripts/okstra_ctl/implementation_comparison/`이다. `source.py`가 읽기 한도를 적용한 소스·Git 수집을, `baseline.py`가 소유 정체성·경로 선택·최초 실패·불변 보존과 상태 조회를 담당한다. `target.py`는 종료 세대의 불변 수집·조회와 저장 완료가 확인된 추적 대상 수집, `assembly.py`는 원본 지문과 주장별 근거 연결, `html.py`는 표시만 소유한다. `model.py`는 공통 입력 타입과 한도, `inputs.py`는 원본 지문 검증과 기존 실행 원본의 선택·정규화, `publication.py`는 소유 범위 잠금·판 게시·현재 포인터와 상태 조회를 담당한다. `__main__.py`는 한도를 적용한 내부 JSON 전달 경계이며 Node의 `runPythonModule`은 선택적 표준 입력을 전달한다. `preparation.py`는 최초 전체 매니페스트의 비교 선언과 작업 기준의 최초 수집 정책을 소유한다. `run.py`는 실제 단계 작업 공간을 확정한 준비 경로에 연결하며, `src/commands/trace/comparison.mts`는 추적 시도 생성·상태 조회·완료 대상 수집의 얇은 전달과 기존 추적 자료의 정규화를 담당한다. `trace/document.mts`는 기존 추적 읽기를 두 명령에서 공유하며 `src/commands/implementation-report/implementation-report.mts`는 저장 자료의 공개 재생성 진입점이다. 공통 설명 안내는 `templates/reports/implementation-comparison-notes.md`, TDD의 완료 안내 순서는 `skills/okstra-tdd/SKILL.md`가 소유한다. `run_evidence.py`는 완료 세대·실제 검사 기록·보존 대상 결합과 최신 선택 재검사를, `run_integration.py`는 작성 전 대상 보존·합성 자료·정확한 설명 권한·선택적 완료 게시를 연결한다. `task_assembly.py`가 작업 전체를 조립하고 `commit_source.py`가 기록된 커밋만 제한 조회하며 `business_reuse.py`가 범위·해시가 같은 기존 설명을 읽는다. 새 입력을 재선택한 같은 게시기는 작업 전체 범위에도 사용하며 기존 보고서와 추적 frontmatter는 각 원본이 계속 소유한다. 기존 HTML의 원본 보존 교체와 공유 검사는 `report_html/render.py`·`validation.py`가 담당한다.
38
+
39
+ `implementation_comparison/task_selection.py`는 전체 작업 비교가 소비할 최신 유효 단계의 읽기 전용 선택 기반이다. 기존 계획 해석·소비 상태·이월 성공·재번호 대조를 호출하고 실제 보고서와 실행 명세의 정체성을 결합한다. `stage_map.parse_stage_map_data`, `plan_run_root.list_implementation_planning_reports`의 선택적 열거, `implementation_outcome.carry_is_pass_grade`, `stage_ledger.renumbering_divergence`가 기존 판정 본문을 공유한다. 원장 복구나 완료 쓰기는 호출하지 않으며 `task_assembly.py`는 단계별 근거 정체성을 유지하고 입증된 통합 대상만 누적 비교한다. `stage_done.py`의 선택적 부가 처리와 공개 `--scope task`가 같은 조립·게시 기능을 소비한다.
40
+
37
41
  `okstra` is a host-aware, multi-provider cross-verification runtime distributed as the npm package `okstra`. It is not a one-shot reviewer; it runs one neutral lifecycle core through Claude Code, Codex, or an explicit external adapter around a stable task key.
38
42
 
39
43
  Current baseline:
@@ -311,7 +315,8 @@ Important modules:
311
315
  | `pr_template.py` | PR body template resolution for release-handoff |
312
316
  | `report_views.py`, `render_final_report.py`, `final_report_schema.py` | Final-report render layer: from the assembled `data.json` (schema v2 or v3) it independently produces the full reading copy Markdown and human HTML; both schema versions render the reading copy from `final-report-v2.template.md` (schema v3 reuses the v2 template for read/render compatibility) |
313
317
  | `report_inputs.py` | Report contract 3.0 role-input path + single-owner registry — resolves each owning role's input artifact from the manifest (`narrative` → report-writer, `approval-decisions` → lead, `agent-activity` → activity ledger, `execution-status` → team-state, `convergence`; for an implementation or final-verification run marked `verificationEvidenceVersion`, `execution-evidence` → verification-execution, the run's verification directory) |
314
- | `report_execution_evidence.py` | Derives each verifier's execution evidence references and final-verification command rows from the verification execution records, and compares a report's references with them for the phase validators |
318
+ | `report_execution_evidence.py` | 검증 실행 기록에서 검증자별 근거와 최종 검증 명령 행을 조립하고 보고서의 근거를 대조한다. 비교 소비자는 같은 해석 바이트의 지문과 호출·시도·세대·최신 검사 선택을 함께 받을 수 있다. |
319
+ | `implementation_generation_evidence.py` | 실행 정체성·예약·반환 봉인과 고정 검증 입력을 재사용해 현재 완료된 구현 세대와 소비 입력 지문을 읽는다. 설계 검토의 승인 판정과 분리하며, 입증하지 못한 현재 시도 대신 과거 완료 세대를 선택하지 않는다. |
315
320
  | `report_assembly.py` | Validates the role-owned report inputs and publishes the contract 3.0 record once (assembled in a temp file, then atomically promoted); a bad input aborts with owner / artifact path / field path / reason and preserves the existing `data.json` |
316
321
  | `report_projections.py` | Pure projections turning role-owned execution inputs (agent activity, execution status, convergence, design, token usage) into canonical final-report fragments |
317
322
  | `report_narrative.py` | 계약 3.0의 작성자 소유 입력을 manifest의 `reportAuthoringFormat`에 따라 읽고 쓴다. 새 `json-v1`은 표준 JSON 객체와 Markdown 설명 문자열을 사용하며, 기존 `markdown-v1` 줄 문법도 유지한다. 중첩된 기계 소유 필드까지 소유권을 검사한다 |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "okstra",
3
- "version": "0.234.1",
3
+ "version": "0.236.0",
4
4
  "description": "Host-aware multi-provider cross-verification orchestrator runtime and agent skills.",
5
5
  "license": "MIT",
6
6
  "author": "devonshin",
@@ -1,5 +1,5 @@
1
1
  {
2
- "package": "0.234.1",
3
- "builtAt": "2026-11-16T14:56:35.582Z",
2
+ "package": "0.236.0",
3
+ "builtAt": "2026-11-19T05:54:13.362Z",
4
4
  "repoRoot": "/home/runner/work/okstra/okstra"
5
5
  }
@@ -0,0 +1,6 @@
1
+ {
2
+ "schemaVersion": "1.0",
3
+ "id": "trace-tests-review",
4
+ "dutyId": "test-reviewer",
5
+ "count": 3
6
+ }
@@ -103,13 +103,13 @@ options:
103
103
  --role-count Instance count for one profile role (repeatable), e.g. analyser=1.
104
104
  Allowed range comes from the phase profile.json; default is its recommended count.
105
105
  A single analyser runs without cross-model verification.
106
- --role-model Model for the next instance of a role (repeatable), e.g. analyser=codex/gpt-6.1-sol.
106
+ --role-model Model for the next instance of a role (repeatable), e.g. analyser=codex/gpt-6.2-sol.
107
107
  --lead-provider Compatibility assertion for the lead assignment. Must match the selected host adapter's native provider.
108
108
  --lead-model Model for the host-native lead. Default: the selected provider's lead policy.
109
109
  --claude-model Model for Claude worker. Default: OKSTRA_DEFAULT_CLAUDE_MODEL or opus
110
- --codex-model Model for Codex worker. Default: OKSTRA_DEFAULT_CODEX_MODEL or gpt-6.1-sol
111
- --antigravity-model Model for Antigravity worker. Default: OKSTRA_DEFAULT_ANTIGRAVITY_MODEL or gemini-3.1-pro
112
- --worker-model Provider-qualified worker override CSV, e.g. grok=grok-4.7,kimi=kimi-k3.
110
+ --codex-model Model for Codex worker. Default: OKSTRA_DEFAULT_CODEX_MODEL or gpt-6.2-sol
111
+ --antigravity-model Model for Antigravity worker. Default: OKSTRA_DEFAULT_ANTIGRAVITY_MODEL or gemini-4-argon
112
+ --worker-model Provider-qualified worker override CSV, e.g. grok=grok-4.7,kimi=k3.1-pro.
113
113
  --report-writer-provider
114
114
  Provider for report writer. Supported: claude, codex. Default: claude.
115
115
  --report-writer-model
@@ -140,13 +140,13 @@ options:
140
140
  -h, --help Show this help.
141
141
 
142
142
  model defaults:
143
- Host-native lead: provider policy (Claude default: opus; Codex default: gpt-6.1-sol)
143
+ Host-native lead: provider policy (Claude default: opus; Codex default: gpt-6.2-sol)
144
144
  Report writer worker: selected provider policy (Claude default: sonnet)
145
145
  Claude worker: OKSTRA_DEFAULT_CLAUDE_MODEL or opus
146
- Codex worker: OKSTRA_DEFAULT_CODEX_MODEL or gpt-6.1-sol
147
- Antigravity worker: OKSTRA_DEFAULT_ANTIGRAVITY_MODEL or gemini-3.1-pro
146
+ Codex worker: OKSTRA_DEFAULT_CODEX_MODEL or gpt-6.2-sol
147
+ Antigravity worker: OKSTRA_DEFAULT_ANTIGRAVITY_MODEL or gemini-4-argon
148
148
  Grok worker: grok-4.7
149
- Kimi worker: kimi-k3
149
+ Kimi worker: k3.1-pro
150
150
  Implementation executor: OKSTRA_DEFAULT_EXECUTOR or claude (one of: claude | codex | antigravity | grok | kimi)
151
151
 
152
152
  output:
@@ -0,0 +1,5 @@
1
+ #!/usr/bin/env bash
2
+ set -euo pipefail
3
+
4
+ script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
5
+ exec python3 "$script_dir/okstra-provider-exec.py" qwen "$@"
@@ -0,0 +1,32 @@
1
+ {
2
+ "schemaVersion": "1.0",
3
+ "id": "test-reviewer",
4
+ "roleId": "verifier",
5
+ "responsibilities": [
6
+ "Independently judge whether the RED tests written for an approved interface design verify every use case through the smallest set of non-overlapping assertions, before any implementation is written."
7
+ ],
8
+ "requiredConduct": [
9
+ "Map every use case to its integration test and every unit test to the rule it asserts. Read the test files, the interface code they call and the project's existing test helpers and conventions. For each assertion, check which test layer owns it: unit tests own a rule's variants (boundaries, limits, error kinds), and an integration test checks one representative wired case of its use case."
10
+ ],
11
+ "decisionPrinciples": [
12
+ "Prefer the fewest tests that still distinguish every required outcome. Distinguish an unverified use case or outcome, an assertion repeated across unit and integration layers, test setup copied instead of shared, a test that mocks the unit under test and a RED result caused by something other than missing implementation from a stylistic preference."
13
+ ],
14
+ "authorityAndBoundaries": [
15
+ "Review the assigned tests against the approved use cases, interface design and existing code without rewriting them. Do not add requirements, change the interface or write implementation code."
16
+ ],
17
+ "evidenceStandards": [
18
+ "Each finding names the use case or rule affected, the test at fault as path:line, the overlapping or missing assertion, and its consequence for later maintenance or for catching a defect. A clean verdict states which use cases and rules were mapped to which tests."
19
+ ],
20
+ "collaborationContract": [
21
+ "Return findings and the verdict to the lead with their evidence. Do not negotiate the tests with their author or decide whether the use cases themselves should change."
22
+ ],
23
+ "completionCriteria": [
24
+ "Every use case has been traced to its integration test, every unit test to the rule it asserts, overlapping assertions and copied setup have been checked, and missing coverage, defects and clean checks are all recorded."
25
+ ],
26
+ "prohibitions": [
27
+ "Do not pass tests that leave a use case or required outcome unverified, or that repeat a unit-tested rule variant in an integration test, and do not turn naming or style preferences into defects."
28
+ ],
29
+ "blockedStateReporting": [
30
+ "Identify the missing use-case table, test file or source context, the mapping that cannot be completed, the attempts made and the use cases or rules left unverified."
31
+ ]
32
+ }
@@ -453,11 +453,14 @@ re-read the task brief, instruction-set, or report template.
453
453
  **Explanation** (required for every verdict, SURVIVES included): <2-3 sentences; for
454
454
  SURVIVES say what you attacked and why the attack failed; for counter-evidence include
455
455
  the file:line you found>
456
+ **Opened**: <every file you opened for this finding, as path:line, comma-separated>
456
457
 
457
458
  ### F-002
458
459
  ...
459
460
  ```
460
461
 
462
+ A SURVIVES, SURVIVES-WITH-CAVEAT or burden-not-met vote whose `**Opened**` line names none of the files in the finding's `originEvidence` is collected as `unverifiable`, with the reason prefixed to its explanation. **Enforced:** `okstra convergence collect-results` reads `originEvidence` from the `convergence-work-<suffix>.json` beside the round plan (`okstra_ctl.convergence._grounded_vote`), tested by `tests/verification/test_convergence_collect_results.py`. Critic-gap and acceptance votes are not collected there and are not checked.
463
+
461
464
  When persisting votes, map SURVIVES→`agree`, SURVIVES-WITH-CAVEAT→`supplement`, REFUTED→`disagree`, and UNVERIFIABLE→`unverifiable`; copy the stated Basis into `votes.<worker>.disagreeBasis` (null for non-REFUTED verdicts). Every vote requires a non-empty `explanation`.
462
465
 
463
466
  UNVERIFIABLE is **not** `verification-error`. A verifier that opened the evidence and could not check it participated in the round; a `verification-error` is a verifier that failed to answer. The classifier counts only non-error votes, so folding the two shrinks the participating roster without saying so — a round where one analyser answers UNVERIFIABLE throughout would read as a two-way cross-check while reporting three voters. **Enforced:** `okstra convergence collect-results` applies this mapping (`okstra_ctl.verdict_blocks.ADVERSARIAL_VERDICTS`); do not transcribe votes by hand.
@@ -630,7 +633,7 @@ above the Round 0 list, and the lead pastes the output whole.
630
633
  critic sets `duplicateOf` to that finding's id (`schemas/convergence-critic-results-v1.0.schema.json` `$defs.Candidate`). A restated finding costs a whole gap-verification round to reject; a declared duplicate costs none — it is recorded in the ledger, never dispatched, and counted in `config.critic.gapsDuplicate`. **Enforced:** `okstra convergence apply-critic-gaps` rejects a `duplicateOf` that names no finding the state carries, and rejects a duplicate row carrying votes.
631
634
 
632
635
  ### Gap verification (1 adversarial reverify round)
633
- Each critic gap enters the verification queue as a finding with `originWorker = "<provider>-critic"` and `source = "critic"`, except a gap the critic declared `duplicateOf` — that one is recorded and never dispatched. The lead runs ONE adversarial reverify round (§"Adversarial Verification Mode" classifier) in which **each gap is verified by exactly one Phase 4 analyser**: walk the analyser roster in `criticVerification.analyserRoster` order and assign gap *i* to `roster[i % len(roster)]`, then dispatch each assigned analyser once with its own gaps. Rejecting a gap costs the same as accepting one and this round is off the books (`rounds: []`, no `roundHistory` entry) on the serial path, so a batch of two gaps no longer wakes four analysers. **Enforced:** `okstra_ctl.convergence_engine._critic_gap_coverage_errors` accepts a dispatch set that is either the assignee set or the full roster, and rejects anything else — the full roster stays valid because a run finished before this rule cannot say which shape it used, the same dual acceptance `_validate_round_ledger_counts` gives the two round-counting arithmetics. Choosing a critic provider that is already in the analyser roster costs nothing: the critic is a different role contract, a different duty and a different session, so an analyser is not disqualified by sharing its provider name (ADR-0017 — provider and model are not role identity, and the same model assigned to two roles gets two independent workers). The critic cannot judge its own gaps because it is not an analyser: the voter roster is `workers[]` filtered to `audience == "analysis"`, and a critic is not even representable there (the allowed values are `analysis` / `lead` / `report-writer`). `okstra convergence apply-critic-gaps` refuses a vote from anyone outside that roster (`critic voter must be a non-critic analyser`). Only gaps classified `full-consensus` / `partial-consensus` merge into the final report findings; `contested` / `worker-unique` gaps are treated as hallucinations and dropped (recorded in the convergence state, not promoted).
636
+ Each critic gap enters the verification queue as a finding with `originWorker = "<provider>-critic"` and `source = "critic"`, except a gap the critic declared `duplicateOf` — that one is recorded and never dispatched. The lead runs ONE adversarial reverify round (§"Adversarial Verification Mode" classifier). With two analysers or fewer, **every analyser verifies every gap**: one verifier per gap let a single shallow pass decide what merged into the report. With more, **each gap is verified by exactly one Phase 4 analyser**: walk the analyser roster in `criticVerification.analyserRoster` order and assign gap *i* to `roster[i % len(roster)]`, then dispatch each assigned analyser once with its own gaps. Rejecting a gap costs the same as accepting one and this round is off the books (`rounds: []`, no `roundHistory` entry) on the serial path, so a batch of two gaps does not wake four analysers. `okstra convergence critic-verify-prompt` renders each analyser's gaps from `okstra_ctl.convergence_engine.critic_gap_assignees`, the same rule the coverage check applies. **Enforced:** `okstra_ctl.convergence_engine._critic_gap_coverage_errors` accepts a dispatch set that is either the assignee set or the full roster, and rejects anything else — the full roster stays valid because a run finished before this rule cannot say which shape it used, the same dual acceptance `_validate_round_ledger_counts` gives the two round-counting arithmetics. Choosing a critic provider that is already in the analyser roster costs nothing: the critic is a different role contract, a different duty and a different session, so an analyser is not disqualified by sharing its provider name (ADR-0017 — provider and model are not role identity, and the same model assigned to two roles gets two independent workers). The critic cannot judge its own gaps because it is not an analyser: the voter roster is `workers[]` filtered to `audience == "analysis"`, and a critic is not even representable there (the allowed values are `analysis` / `lead` / `report-writer`). `okstra convergence apply-critic-gaps` refuses a vote from anyone outside that roster (`critic voter must be a non-critic analyser`). Only gaps classified `full-consensus` / `partial-consensus` merge into the final report findings; `contested` / `worker-unique` gaps are treated as hallucinations and dropped (recorded in the convergence state, not promoted).
634
637
 
635
638
  **Dispatching the gap round.** The gap round is off the round ledger, so `plan-round` writes no plan for it and `reverify-prompt` cannot render it; it has its own generator and dispatch kind. Assemble the coverage batch first — the same `{ schemaVersion, taskKey, mode: "coverage", provider, modelExecutionValue, gaps[] }` document `apply-critic-gaps` will take, with each candidate as a gap (`gapId` = the critic's item id, `summary`, `category`, `ticketIds`, `originEvidence`, `duplicateOf` where declared) and no `votes` or `dispatches` yet. Then, for each assigned analyser, render `okstra convergence critic-verify-prompt --run-manifest <run-manifest> --gaps <coverage-batch.json> --worker <worker-id>` and write its output verbatim as the instruction file: it applies the same round-robin as `apply-critic-gaps` (`okstra_ctl.convergence_engine.critic_gap_assignees`) and carries only that analyser's gaps, each with the critic's result file and `### [<gapId>]` section, the critic audit sidecar the verifier may open, and the adversarial response format the collector parses (gap votes are always read as adversarial). Materialize with the analyser's existing `reverify/<worker-id>` assignment ref, `--dispatch-kind critic-verify`, `--audience reverification-worker`, and on a v2 run the analyser's own `--source-role-execution-ref` exactly as a numbered reverify round; name the prompt `<worker-id>-worker-critic-verify-<task-type>-<seq>.md` and the result `worker-results/<worker-id>-worker-critic-verify-<task-type>-<seq>.md`. Collect each result with `parse_finding_votes` semantics (the `### <gapId>` blocks), write the votes and one `dispatches[]` row per assigned analyser into the batch, and run `apply-critic-gaps`. **Enforced (rendering):** `okstra_ctl.convergence_critic_verify_prompt`. **Enforced (pre-dispatch):** `validate_reverify_prompt` in `scripts/okstra_ctl/worker_prompt_contract.py` requires the `**Rendered by:** okstra convergence critic-verify-prompt` line for dispatch kind `critic-verify`, so a hand-written gap instruction cannot be materialized; `worker_prompt_policy.is_verification_dispatch_kind` routes the kind through the reverify prompt plan, and `convergence_store.reserve_dynamic_verifier` records the kind on the v2 reservation. Before this path existed (2026-09-09, dev-10642 requirements-discovery 001) every attempt to dispatch the round was refused and all three gaps ended `gapsUnverified`.
636
639
 
@@ -278,7 +278,7 @@ For an `implementation-planning` run whose run manifest declares `activityContra
278
278
  The live projection follows this shape:
279
279
 
280
280
  ```text
281
- PROGRESS: phase-4-dispatch worker=codex-worker model=gpt-6.1-sol
281
+ PROGRESS: phase-4-dispatch worker=codex-worker model=gpt-6.2-sol
282
282
  ACTIVITY: id=A-001 agent=codex-worker summary="Verify Stage Map paths and commands" items=P-Step-001,P-Step-002 result=runs/.../codex-worker-....md outcome=pending
283
283
  ```
284
284
 
@@ -380,8 +380,8 @@ The table below documents those prep-time seed values **for reference only** —
380
380
  | Lead role | opus | -- | runtime-specific role label; orchestration + convergence supervision + final-report review/approval |
381
381
  | Report writer worker | sonnet | report-writer-worker | common + role + duty contracts composed per invocation; `native-session` execution |
382
382
  | Claude worker | opus | claude-worker | common + role + duty contracts composed per invocation; `native-session` execution |
383
- | Codex worker | gpt-6.1-sol | codex-worker | duty + task instructions composed per invocation; deterministic `worker-dispatch` execution |
384
- | Antigravity worker | gemini-3.1-pro | antigravity-worker | duty + task instructions composed per invocation; deterministic `worker-dispatch` execution |
383
+ | Codex worker | gpt-6.2-sol | codex-worker | duty + task instructions composed per invocation; deterministic `worker-dispatch` execution |
384
+ | Antigravity worker | gemini-4-argon | antigravity-worker | duty + task instructions composed per invocation; deterministic `worker-dispatch` execution |
385
385
 
386
386
  Each analysis assignment follows its recorded `runner`. `runner=native-session` uses the host's native subagent primitive after `host-native-spec-link-gate`. `runner=cli-wrapper` follows the planned execution surface after `core-pre-dispatch` verification: `okstra team dispatch` when `terminalBackend` is `cmux-pane`, otherwise the deterministic `okstra worker-dispatch` process boundary. No LLM transport wrapper sits in front of a provider CLI.
387
387
 
@@ -4,7 +4,7 @@
4
4
 
5
5
  Phase 6 gives the report writer all settled analysis, convergence, task, and planning context required for synthesis. Read access supplies context; it does not grant write authority over another owner's file.
6
6
 
7
- The report writer writes only the report authoring input, its pointer record, and its audit sidecar. The run manifest's `reportAuthoringFormat` selects standard JSON for `json-v1`; an absent field selects the existing `markdown-v1` line grammar. `reportNarrativePath` retains its name and identifies that exact input path. Never infer the format from its suffix or change an existing run's format. It must not write or patch `final-report-*.data.json`, the approval decision ledger, activity ledger, team state, convergence state, or design-preparation input.
7
+ The report writer writes the report authoring input, its pointer record, and its audit sidecar. When the synthesis packet explicitly supplies `authoringContract.implementationComparison.notesPath`, it may also write comparison notes to that exact path using the supplied notes guide and identities. Missing comparison notes do not prevent completion of the original report. The run manifest's `reportAuthoringFormat` selects standard JSON for `json-v1`; an absent field selects the existing `markdown-v1` line grammar. `reportNarrativePath` retains its name and identifies that exact input path. Never infer the format from its suffix or change an existing run's format. It must not write or patch `final-report-*.data.json`, the approval decision ledger, activity ledger, team state, convergence state, or design-preparation input.
8
8
 
9
9
  The narrative owns judgments, plan body, summaries, user explanation, recommended steps, and follow-up descriptions. It never owns `designPreparation`, `designSurfaceCoverage`, `executionStatus`, `executionRoles`, `tokenUsage`, `crossVerification`, `approvalContext`, `clarificationItems`, `agentActivity`, or `planBodyVerification`. It must not pre-fill a future round, future gate result, activity identifier, usage value, or resolution.
10
10
 
@@ -15,6 +15,7 @@ Report assembly reads the role-owned inputs, validates them, derives links and s
15
15
  | Input | Owner | Write boundary |
16
16
  |---|---|---|
17
17
  | report authoring input in the declared format | report-writer | `reportNarrativePath` |
18
+ | optional implementation comparison notes | report-writer | exact `authoringContract.implementationComparison.notesPath` supplied by the synthesis packet |
18
19
  | approval decision ledger | lead | `approvalDecisionsPath` through `okstra approval-decision` |
19
20
  | activity ledger | activity recorder | `leadEventsPath` through `okstra agent-activity append` |
20
21
  | team state and usage | runtime/accounting adapter | `teamStatePath` |
@@ -58,6 +59,17 @@ This is enforced by
58
59
  `report_synthesis_packet.build_report_synthesis_packet()`, and
59
60
  `report_assembly.assemble_report()`.
60
61
 
62
+ For an implementation run with a comparison declaration, initial materialization
63
+ preserves the current completed verification generation before dispatch. The
64
+ packet supplies the original baseline and target references, optional notes path,
65
+ common notes guide, actual execution records, and capture limitations. Reuse the
66
+ implementation explanation already in the packet to explain the triggering
67
+ condition, previous handling, changed processing, resulting behavior, and impact.
68
+ Reference only supplied record identifiers and known preserved source locations;
69
+ mark missing or unmeasured support as a limitation. Do not copy authored origins,
70
+ target attribution, hashes, or command results into notes. Corrective authoring
71
+ reads the same saved target rather than capturing the working source again.
72
+
61
73
  Materialize the duty prompt with `okstra agent-prompt materialize --audience report-writer ...`. `--assignment-ref` is `initial/report-writer` — the run manifest declares the report writer under the `initial` phase, so `report-writer/report-writer` is refused. `--result` is the narrative path the run manifest's `reportNarrativePath` names (report contract 3.0; the `expectedReportRecordPath` data.json under 2.0) and `--audit-source` is the roster's worker result (`team-state` `workers[].resultPath` for `report-writer`). The materializer refuses any other value: report assembly reads the narrative from the manifest path and nowhere else, and `okstra team await` records the roster row completed only when the roster's file exists. A corrective dispatch (fix, self-fix, verdict, citations, supersession) reuses both paths and changes only the prompt path and the invocation ID. **Enforced:** `_validate_report_writer_paths` in `scripts/okstra_ctl/agent/prompt_cli/materialize.py`. The materializer also writes the report synthesis packet next to the narrative and puts `- Report synthesis packet: <path>` as the first line of the prompt's `## Inputs` section — opening the section when the instruction has none, or inserting under the instruction's own `## Inputs` heading when it has one. The instruction therefore does not enumerate raw source paths; a missing or unreadable packet source is refused before dispatch with its owner (`report synthesis packet contract defects`). **Enforced:** `_report_writer_input_lines` in `scripts/okstra_ctl/agent/prompt_cli/materialize.py`. The prompt starts with these anchors in order:
62
74
 
63
75
  1. `**Project Root:**`
@@ -5,7 +5,7 @@ Edit here once; every profile picks the change up at next render. Do NOT
5
5
  add phase-specific rules to this file — phase rules stay in the per-
6
6
  profile document.
7
7
  -->
8
- - Team contract (shared): roster roles, model-assignment rules, dispatch invariants, and worker attempt rules are canonical in the team contract (`prompts/lead/team-contract.md`). Two consequences every phase honours: the host-native Okstra lead is synthesis-only (in `implementation`, distinct from the `Executor` and verifiers), and unnamed generic parallel workers never replace or extend the run's selected roster (`resultContract.workerRoles`). Prep-time model recommendations come from the catalog defaults in `okstra_ctl.models` (for example, `Codex worker` → `gpt-6.1-sol`); at dispatch time the task-manifest's materialized assignment is the only source — there is no dispatch-time fallback.
8
+ - Team contract (shared): roster roles, model-assignment rules, dispatch invariants, and worker attempt rules are canonical in the team contract (`prompts/lead/team-contract.md`). Two consequences every phase honours: the host-native Okstra lead is synthesis-only (in `implementation`, distinct from the `Executor` and verifiers), and unnamed generic parallel workers never replace or extend the run's selected roster (`resultContract.workerRoles`). Prep-time model recommendations come from the catalog defaults in `okstra_ctl.models` (for example, `Codex worker` → `gpt-6.2-sol`); at dispatch time the task-manifest's materialized assignment is the only source — there is no dispatch-time fallback.
9
9
  - Worker interaction model (shared — read before inferring behaviour from the roster):
10
10
  - the run's selected roster is a **roster**, not a behaviour contract. Each role's interaction mode changes across operating phases of the same run.
11
11
  - **Phase 4 / 5 (independent analysis)**: every analyser in the resolved provider assignment roster produces findings independently and has no access to another worker's output. `report-writer` does not analyse.
@@ -24,6 +24,15 @@ profile document.
24
24
  - Okstra-owned project artifacts live only under `<PROJECT_ROOT>/.okstra/**`. Treat `project.json`, task bundles, run artifacts, `glossary.md`, and `decisions/` under that subtree as the canonical okstra memory.
25
25
  - Treat paths outside `<PROJECT_ROOT>/.okstra/**` as source material only when the task brief's `Source Material` or `Reporter Confirmations` explicitly cites them; they never become okstra memory.
26
26
  - Create, modify, or delete only inside `<PROJECT_ROOT>/.okstra/**` unless the brief verbatim requests a specific non-okstra edit. The phase performing that edit must quote the user instruction in its report. Implementation source edits also require the approved implementation plan.
27
+ - Runtime resources (shared — Docker containers, volumes, databases, images and networks a worker uses, e.g. a PostgreSQL test database for validation or a built server image):
28
+ - Reuse before creating. Before `docker run`, `docker volume create` or `docker build`, look for an okstra resource of this project that already serves the purpose: `docker ps -a --filter label=okstra.project=<project-id>` and `docker volume ls --filter label=okstra.project=<project-id>`, where `<project-id>` is the first segment of the task key. Resources created before this rule carry `okstra.validation.scope` / `okstra.validation.owner` instead and no `okstra.project`; list them with `docker ps -a --filter label=okstra.validation.owner` and `docker volume ls --filter label=okstra.validation.owner`, and count one only when its name or `okstra.validation.scope` value names this project — otherwise treat it as foreign. Reuse one with a matching image and major version: start it if it is stopped and wait until it is healthy or accepts connections. Create a new one only when none fits (for example, a different major version is required), and record why in your result.
29
+ - Inside a reused database server, keep this task's data in its own database (or schema) named `<task-group>_<task-id>` from the task key, with `_s<N>` appended for implementation stage `<N>`, lower-cased and with every character other than letters, digits and `_` replaced by `_`. Concurrent stages never share one. On a later attempt, reuse that database; create it only when it does not exist. When a test needs a known starting state, reset this database's contents (for example, drop and recreate its schemas, then rerun the migrations) instead of dropping the database. Never drop or alter another task's database.
30
+ - Label what you create with `okstra.project=<project-id>` and `okstra.purpose=<service>-<major-version>` (for example `postgres-16`), and give it a stable name built from the same values. Never put a random or per-attempt id in a name or label: that is what makes the next attempt treat the previous attempt's container as a foreign resource and create another one.
31
+ - For an image you build, add `--label okstra.source=<commit sha of the source>` and use one stable tag per task and stage, built from the same sanitized `<task-group>_<task-id>[_s<N>]` value, so concurrent stages and tasks never overwrite each other's image. Reuse an existing image only when its `okstra.source` label equals the current commit of a worktree with no uncommitted changes; otherwise rebuild under the same tag instead of adding a per-attempt tag.
32
+ - Keep these containers, volumes and databases after the work; later attempts, phases and tasks reuse them. Do not remove them, and do not stop, modify or remove any Docker resource without an okstra label.
33
+ - Starting, connecting to, and creating a task database or schema in an okstra-labelled resource is authorised by this rule. It is not a non-okstra edit under the Resource boundary above, and needs no brief instruction.
34
+ - This rule governs how a phase and role already permitted to run Docker or test commands does so. It grants no such permission and does NOT relax any phase-specific Forbidden actions list or a read-only role's limits.
35
+ - This is a prompt instruction, not a code-enforced gate.
27
36
  - Authority & permissions assumption (applies to every okstra task-type):
28
37
  - **Assume the user (and their team) holds full authority and every permission required for the anticipated, in-flight, or follow-up work.** Treat external approvals, third-party access grants, role/IAM permissions, organisational sign-off, legal/compliance review, vendor coordination, and "verify access exists" steps as already satisfied unless the task brief explicitly states otherwise.
29
38
  - Do NOT add such items to routing decisions, missing-materials lists, clarification questions, option trade-offs, dependency/migration risk, validation checklists, rollout plans, acceptance blockers, residual risks, release recommendations, the `## 1. Clarification Items` table, or any day/effort estimate. They are not legitimate sources of schedule extension.
@@ -568,7 +568,7 @@
568
568
  "echo_template": "edit-target: {value}"
569
569
  },
570
570
  "role_models": {
571
- "label": "{role} 역할의 모델을 고르세요 — 고른 만큼 인스턴스를 띄웁니다 ({range}). 제공자별로 표시하며 추천은 프로젝트 modelDefaults(없으면 카탈로그 기본값)를 따릅니다",
571
+ "label": "{role} 역할의 모델을 고르세요 — 고른 만큼 인스턴스를 띄웁니다 ({range}). 벤더별로 표시하며 목록에 없는 모델은 '직접 입력'으로 고릅니다. 추천은 프로젝트 modelDefaults(없으면 카탈로그 기본값)를 따릅니다",
572
572
  "echo_template": "role-models: {value}",
573
573
  "options": {
574
574
  "model": "{model_ref} — {display}",
@@ -580,18 +580,26 @@
580
580
  "labels": {
581
581
  "range": "허용 {minimum}..{maximum}개, 권장 {recommended}개",
582
582
  "exact": "정확히 {count}개",
583
- "single": "{role} 역할의 모델을 하나 고르세요 — 인스턴스는 1개입니다 ({range}). 1번 추천은 프로젝트 modelDefaults(없으면 카탈로그 기본값)이고, 이 역할을 빼려면 '추가 안 함' 입니다"
583
+ "single": "{role} 역할의 모델을 하나 고르세요 — 인스턴스는 1개입니다 ({range}). 1번 추천은 프로젝트 modelDefaults(없으면 카탈로그 기본값)이고, 이 역할을 빼려면 '추가 안 함'(벤더 탭 화면에서는 아무것도 고르지 않음) 입니다"
584
584
  },
585
585
  "errors": {
586
586
  "count_out_of_range": "{range} 골라야 합니다 — 고른 수 {count}개",
587
- "min_one_required": "모델을 {range} 고르세요 (이 역할을 빼려면 '추가 안 함')",
587
+ "min_one_required": "모델을 {range} 고르세요",
588
588
  "unknown_option": "목록에 없는 항목입니다: {values}"
589
589
  },
590
590
  "echo_variants": {
591
591
  "skipped": "role-models: (추가 안 함)"
592
592
  }
593
+ },
594
+ "role_model_input": {
595
+ "label": "{role} 역할에 쓸 {providers} 모델 id를 입력하세요 (쉼표로 여러 개). 앞 화면에서 고른 모델: {chosen}. 입력할 수 있는 모델: {candidates}",
596
+ "echo_template": "role-model-input: {value}"
593
597
  }
594
598
  },
599
+ "model_tabs": {
600
+ "free_input": "직접 입력 ({vendors})",
601
+ "mixed": "기타 {vendors}"
602
+ },
595
603
  "confirmation": {
596
604
  "header": "선택 확인:",
597
605
  "provider_data_scope": "\n전달 대상: 위 역할·모델 목록의 제공자(현재 세션 및 선택한 외부 모델 제공자).\n전달 자료: `{project_root}`의 이 작업에 대한 작업 개요, 작업 수행에 필요한 저장소 소스·문서, 선택한 근거 자료 및 실행 중 생성되는 관련 분석·검증 결과.\n진행을 선택하면 위 대상에 해당 자료를 전달하여 선택한 작업을 실행하는 것을 승인합니다. 선택에 없는 제공자나 작업과 무관한 자료는 승인 범위에 포함되지 않습니다. 실행 환경의 권한 검토는 별도로 적용됩니다.",
@@ -648,7 +656,11 @@
648
656
  "save": "저장",
649
657
  "edit": "계속 수정",
650
658
  "review": "변경 검토",
651
- "models_label": "{role} · 허용 {minimum}..{maximum}명\n선택한 모델 하나당 1명입니다. 상속·해제·사용 안 함은 단독으로 선택하세요.\n검증자 기본값은 시작 역할에만 적용하며 동적 검증자는 원본 배정을 따릅니다.",
659
+ "action_label": "{role} · 허용 {minimum}..{maximum}명\n모델을 고르거나, 상속·해제·사용 안 함을 고르세요.",
660
+ "choose_models": "모델 고르기",
661
+ "models_label": "{role} · 허용 {minimum}..{maximum}명\n선택한 모델 하나당 1명입니다. 벤더별로 표시하며 목록에 없는 모델은 '직접 입력'으로 고릅니다.\n검증자 기본값은 시작 역할에만 적용하며 동적 검증자는 원본 배정을 따릅니다.",
662
+ "model_input_label": "{role}에 쓸 {providers} 모델 id를 입력하세요 (쉼표로 여러 개). 앞 화면에서 고른 모델: {chosen}. 입력할 수 있는 모델: {candidates}",
663
+ "choose_action": "모델 고르기, 상속·해제·사용 안 함, 취소 중에서 고르세요.",
652
664
  "exclusive": "상속·해제·사용 안 함은 다른 모델과 함께 선택할 수 없습니다.",
653
665
  "conflict": "{path}: {role} 설정이 이 편집을 시작한 뒤 바뀌었습니다. 설정을 다시 여세요.",
654
666
  "choose_scope": "설정 범위를 선택하세요.",