okstra 0.235.0 → 0.237.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 (80) hide show
  1. package/dist/lib/host-registry-client.d.mts +9 -2
  2. package/dist/lib/host-registry-client.mjs +29 -3
  3. package/dist/lib/host-registry-client.mjs.map +1 -1
  4. package/dist/lib/runtime-payload.mjs +1 -0
  5. package/dist/lib/runtime-payload.mjs.map +1 -1
  6. package/docs/architecture/storage-model.md +1 -0
  7. package/docs/architecture.md +2 -2
  8. package/docs/cli.md +6 -0
  9. package/package.json +1 -1
  10. package/runtime/BUILD.json +2 -2
  11. package/runtime/bin/lib/okstra/usage.sh +8 -8
  12. package/runtime/bin/okstra-qwen-exec.sh +5 -0
  13. package/runtime/prompts/lead/convergence.md +4 -1
  14. package/runtime/prompts/lead/okstra-lead-contract.md +4 -4
  15. package/runtime/prompts/profiles/_clarification-recommendation.md +1 -1
  16. package/runtime/prompts/profiles/_common-contract.md +10 -1
  17. package/runtime/prompts/wizard/prompts.ko.json +16 -4
  18. package/runtime/python/okstra_ctl/adapters/providers/antigravity/adapter.py +10 -2
  19. package/runtime/python/okstra_ctl/adapters/providers/claude/adapter.py +16 -1
  20. package/runtime/python/okstra_ctl/adapters/providers/codex/adapter.py +20 -5
  21. package/runtime/python/okstra_ctl/adapters/providers/kimi/adapter.py +17 -9
  22. package/runtime/python/okstra_ctl/adapters/providers/qwen/adapter.py +88 -0
  23. package/runtime/python/okstra_ctl/adapters/providers/qwen/manifest.json +1 -0
  24. package/runtime/python/okstra_ctl/adapters/providers/qwen/settings.json +12 -0
  25. package/runtime/python/okstra_ctl/adapters/providers/zai/adapter.py +8 -2
  26. package/runtime/python/okstra_ctl/approval_decisions.py +22 -2
  27. package/runtime/python/okstra_ctl/business_flow/contracts.py +11 -0
  28. package/runtime/python/okstra_ctl/business_flow/engine.py +90 -32
  29. package/runtime/python/okstra_ctl/business_flow/hooks.py +4 -2
  30. package/runtime/python/okstra_ctl/business_flow/source.py +39 -7
  31. package/runtime/python/okstra_ctl/business_flow/store.py +94 -28
  32. package/runtime/python/okstra_ctl/convergence.py +95 -5
  33. package/runtime/python/okstra_ctl/convergence_critic_verify_prompt.py +11 -10
  34. package/runtime/python/okstra_ctl/convergence_engine.py +30 -15
  35. package/runtime/python/okstra_ctl/convergence_reverify_prompt.py +9 -2
  36. package/runtime/python/okstra_ctl/coverage_census.py +75 -12
  37. package/runtime/python/okstra_ctl/entrypoints/hosts.py +1 -1
  38. package/runtime/python/okstra_ctl/lead_progress.py +1 -1
  39. package/runtime/python/okstra_ctl/manager_cli.py +42 -5
  40. package/runtime/python/okstra_ctl/manager_launch.py +60 -1
  41. package/runtime/python/okstra_ctl/manager_store.py +45 -0
  42. package/runtime/python/okstra_ctl/model_discovery.py +1 -1
  43. package/runtime/python/okstra_ctl/models.py +2 -2
  44. package/runtime/python/okstra_ctl/phases/discussion/profile.md +2 -2
  45. package/runtime/python/okstra_ctl/phases/error_analysis/profile.md +1 -1
  46. package/runtime/python/okstra_ctl/phases/implementation_option_selection/profile.md +1 -1
  47. package/runtime/python/okstra_ctl/phases/implementation_planning/authoring.py +2 -1
  48. package/runtime/python/okstra_ctl/phases/implementation_planning/instructions/plan-body-verification.md +2 -2
  49. package/runtime/python/okstra_ctl/phases/implementation_planning/profile.md +3 -3
  50. package/runtime/python/okstra_ctl/phases/requirements_discovery/profile.md +5 -5
  51. package/runtime/python/okstra_ctl/plan_item_evidence.py +25 -1
  52. package/runtime/python/okstra_ctl/registry/provider_registry.py +1 -1
  53. package/runtime/python/okstra_ctl/render_final_report.py +1 -1
  54. package/runtime/python/okstra_ctl/run.py +1 -1
  55. package/runtime/python/okstra_ctl/run_context.py +18 -3
  56. package/runtime/python/okstra_ctl/schema_excerpt.py +14 -9
  57. package/runtime/python/okstra_ctl/verdict_blocks.py +7 -2
  58. package/runtime/python/okstra_ctl/wizard/cli.py +14 -2
  59. package/runtime/python/okstra_ctl/wizard/engine.py +28 -1
  60. package/runtime/python/okstra_ctl/wizard/ids.py +8 -0
  61. package/runtime/python/okstra_ctl/wizard/picker_navigation.py +64 -2
  62. package/runtime/python/okstra_ctl/wizard/roles.py +194 -45
  63. package/runtime/python/okstra_ctl/wizard/sources.py +10 -1
  64. package/runtime/python/okstra_ctl/wizard/state.py +71 -21
  65. package/runtime/python/okstra_ctl/wizard/statefile.py +8 -3
  66. package/runtime/python/okstra_ctl/wizard/steps_roles.py +6 -3
  67. package/runtime/python/okstra_ctl/wizard/worker_settings.py +129 -25
  68. package/runtime/python/okstra_ctl/worker_audit_ledger.py +50 -8
  69. package/runtime/python/okstra_ctl/worker_prompt_body.py +26 -2
  70. package/runtime/python/okstra_ctl/worker_prompt_headers.py +12 -9
  71. package/runtime/python/okstra_token_usage/claude.py +5 -1
  72. package/runtime/python/okstra_token_usage/collect.py +3 -3
  73. package/runtime/python/okstra_token_usage/pricing.py +1 -0
  74. package/runtime/skills/_fragments/wizard-relay-protocol.md +1 -1
  75. package/runtime/skills/okstra-discussion/SKILL.md +1 -1
  76. package/runtime/skills/okstra-manager/SKILL.md +8 -2
  77. package/runtime/skills/okstra-run/SKILL.md +2 -2
  78. package/runtime/skills/okstra-setup/SKILL.md +34 -5
  79. package/runtime/skills/okstra-setup/references/project-config.md +19 -0
  80. package/runtime/templates/worker-prompt-preamble.md +12 -2
@@ -335,3 +335,22 @@ existing entries.
335
335
  prepare repeats the check for the providers a run selects and prints a warning
336
336
  for each gap; it never refuses the run. It also warns when the task brief cites
337
337
  a Figma URL and no declared server name or alias contains `figma`.
338
+
339
+ ## I. Worker defaults (`workerDefaults`)
340
+
341
+ `workerDefaults` saves the worker models for each role, keyed by role name. The
342
+ array fixes both the models and the count; an empty array disables an optional
343
+ role. The project value in `project.json` replaces that role's global value in
344
+ `~/.okstra/config.json`. `/okstra-run` fills each valid configured role without
345
+ showing its selection screen and still asks for roles that are missing or whose
346
+ saved models are unavailable. `modelDefaults` only orders the candidate list and
347
+ never skips a screen.
348
+
349
+ Review, change or clear these values with the same flow as SKILL.md Step 5: run
350
+ the worker settings mode of the installed `okstra-run` skill. It shows the
351
+ current values for every role and saves nothing until the user chooses Save.
352
+ To only read the saved values of both scopes, run:
353
+
354
+ ```bash
355
+ okstra config show --scope all
356
+ ```
@@ -6,7 +6,7 @@ Your identity is the stored role execution (`executionLabel`). Canonical roles a
6
6
 
7
7
  ## Required reading
8
8
 
9
- Read `analysis-packet.md`, the primary compact input, end-to-end. Source files named as fallback/evidence paths are read only when a finding needs to verify a citation, fill a packet gap, or resolve ambiguity. Do not read `final-report-template.md` or `final-report-schema.json`; analysis workers produce findings, not the final report.
9
+ Read `analysis-packet.md`, the primary compact input, end-to-end. The packet is the map, not the evidence: your main work is opening the source, configuration, tests and installed dependencies it points to, and confirming each claim there before you cite it. The fallback and evidence paths it names are starting points, not limits. Do not read `final-report-template.md` or `final-report-schema.json`; analysis workers produce findings, not the final report.
10
10
 
11
11
  ### Reading rules
12
12
 
@@ -39,12 +39,22 @@ Every item has a worker-local ID and file:line evidence where code evidence exis
39
39
 
40
40
  Section 6 judges every cell of the packet's `## Coverage Census`, one line per cell, using the cell id verbatim:
41
41
 
42
- - `- <cell-id>: clean — <path:line evidence>`
42
+ - `- <cell-id>: clean — <path:line evidence>` — the cited line is project source, configuration or a test that shows the cell's question has no problem in the current code. The brief and the packet only pose the question; a `clean` that cites nothing but `.okstra/` files counts as unjudged, unless the census question says the brief or okstra records may settle it.
43
43
  - `- <cell-id>: finding <worker-local ID>` — the ID of an item in sections 1–5
44
44
  - `- <cell-id>: n/a — <reason>`
45
45
 
46
46
  A cell with no line, a `clean` without a `path:line` citation, an `n/a` without a reason, or a `finding` naming an ID your result does not contain counts as unjudged. The lead sends unjudged cells back to you once, in a `census-gapfill` dispatch; whatever stays unjudged after it is reported as a coverage warning. That dispatch narrows this contract: write only Findings (the new items its verdicts point to, or `- none`) and Coverage Verdicts for the cells it lists. When the packet has no `## Coverage Census`, omit section 6.
47
47
 
48
+ ## Before writing the result
49
+
50
+ Check your draft against what you actually opened, and correct it before you write:
51
+
52
+ 1. A file, function or test you list as not opened cannot support a `clean`, an `n/a` or a stated fact. Open it, or turn that verdict into a finding or an uncertain point that names what was not read.
53
+ 2. Every open question the brief or packet asks has a `path:line` you opened, or appears under Missing Information or Uncertain Points with the reason it stays open.
54
+ 3. Every `clean` cites the line that shows the absence of the problem, not a file that exists, and not a line of the brief or packet unless the census question says they may settle it.
55
+
56
+ In a `census-gapfill` dispatch, which allows only Findings and Coverage Verdicts, record what stays unread as a `finding` instead of an uncertain point.
57
+
48
58
  ## Return message to the lead
49
59
 
50
60
  Begin the inline return with the model identity copied verbatim from the `**Model:** <Role>, <modelExecutionValue>` line in the prompt, followed by the status summary. Never invent or abbreviate the model.