okstra 0.130.1 → 0.130.3

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 (43) hide show
  1. package/docs/architecture.md +7 -1
  2. package/docs/cli.md +10 -2
  3. package/docs/project-structure-overview.md +16 -9
  4. package/docs/task-process/implementation-planning.md +11 -5
  5. package/package.json +1 -1
  6. package/runtime/BUILD.json +2 -2
  7. package/runtime/agents/workers/antigravity-worker.md +3 -1
  8. package/runtime/agents/workers/claude-worker.md +1 -1
  9. package/runtime/agents/workers/codex-worker.md +3 -1
  10. package/runtime/agents/workers/report-writer-worker.md +8 -4
  11. package/runtime/prompts/lead/adapters/claude-code.md +2 -2
  12. package/runtime/prompts/lead/convergence.md +44 -21
  13. package/runtime/prompts/lead/okstra-lead-contract.md +9 -2
  14. package/runtime/prompts/lead/plan-body-verification.md +55 -12
  15. package/runtime/prompts/lead/report-writer.md +16 -15
  16. package/runtime/prompts/lead/team-contract.md +8 -6
  17. package/runtime/prompts/profiles/implementation-planning.md +10 -2
  18. package/runtime/python/okstra_ctl/codex_dispatch.py +5 -1
  19. package/runtime/python/okstra_ctl/convergence.py +121 -1
  20. package/runtime/python/okstra_ctl/convergence_engine.py +903 -13
  21. package/runtime/python/okstra_ctl/convergence_migration.py +9 -1
  22. package/runtime/python/okstra_ctl/dispatch_core.py +13 -0
  23. package/runtime/python/okstra_ctl/plan_items.py +203 -0
  24. package/runtime/python/okstra_ctl/plan_items_cli.py +81 -0
  25. package/runtime/python/okstra_ctl/report_finalize.py +6 -4
  26. package/runtime/python/okstra_ctl/worker_artifact_paths.py +23 -0
  27. package/runtime/python/okstra_ctl/worker_liveness.py +4 -4
  28. package/runtime/python/okstra_ctl/worker_prompt_body.py +1 -1
  29. package/runtime/python/okstra_ctl/worker_prompt_contract.py +2 -1
  30. package/runtime/python/okstra_ctl/worker_prompt_headers.py +14 -0
  31. package/runtime/schemas/convergence-critic-results-v1.0.schema.json +57 -0
  32. package/runtime/schemas/convergence-groups-v1.0.schema.json +109 -0
  33. package/runtime/schemas/convergence-round-results-v1.0.schema.json +55 -0
  34. package/runtime/schemas/final-report-v1.0.schema.json +21 -2
  35. package/runtime/templates/report-writer-prompt-preamble.md +5 -3
  36. package/runtime/templates/reports/final-report.template.md +1 -1
  37. package/runtime/templates/worker-prompt-preamble.md +8 -7
  38. package/runtime/validators/validate-run.py +154 -118
  39. package/runtime/validators/validate_session_conformance.py +66 -23
  40. package/src/cli-registry.mjs +7 -0
  41. package/src/commands/execute/convergence.mjs +6 -1
  42. package/src/commands/execute/plan-items.mjs +9 -0
  43. package/src/commands/inspect/worker-liveness.mjs +2 -2
package/src/cli-registry.mjs CHANGED
@@ -73,6 +73,13 @@ export const COMMAND_REGISTRY = [
73
73
  category: "admin",
74
74
  summary: ["Advance and validate deterministic re-verification state"],
75
75
  },
76
+ {
77
+ name: "plan-items",
78
+ module: "./commands/execute/plan-items.mjs",
79
+ export: "run",
80
+ category: "admin",
81
+ summary: ["Extract and validate deterministic plan-body items"],
82
+ },
76
83
  {
77
84
  name: "git-reconcile",
78
85
  module: "./commands/execute/git-reconcile.mjs",
package/src/commands/execute/convergence.mjs CHANGED
@@ -8,8 +8,14 @@ Usage:
8
8
  okstra convergence plan-round --work-state <path> --plan <path>
9
9
  okstra convergence apply-round --work-state <path> --plan <path> \\
10
10
  --results <path>
11
+ okstra convergence apply-critic-gaps --work-state <path> --results <path>
11
12
  okstra convergence finalize --work-state <path> --output <path>
12
13
  okstra convergence validate --state <path> --kind <working|final>
14
+ okstra convergence example --kind <groups|round-results|critic-results>
15
+
16
+ Working lifecycle:
17
+ groups v1.0 → work v1.0 → round-plan/results v1.0 → final v1.3
18
+ historical final readers: v1.0, v1.1, v1.2
13
19
 
14
20
  This internal admin command is consumed by the Phase 5.5 lead contract. It
15
21
  does not install or revive the obsolete okstra-convergence skill.
@@ -31,4 +37,3 @@ export async function run(args) {
31
37
  });
32
38
  return result.code;
33
39
  }
34
-
package/src/commands/execute/plan-items.mjs ADDED
@@ -0,0 +1,9 @@
1
+ import { runPythonModule } from "../../lib/python-helper.mjs";
2
+
3
+ export async function run(args) {
4
+ const { code } = await runPythonModule({
5
+ module: "okstra_ctl.plan_items_cli",
6
+ args,
7
+ });
8
+ return code ?? 1;
9
+ }
package/src/commands/inspect/worker-liveness.mjs CHANGED
@@ -6,8 +6,8 @@ Usage:
6
6
  okstra worker-liveness [--audit <path>]... [--prompt <path>]...
7
7
  [--max-idle <seconds>] [--launch-grace <seconds>] [--json]
8
8
 
9
- --audit a claude-worker audit sidecar; stale past the heartbeat cadence means
10
- the in-process worker hung.
9
+ --audit an in-process worker audit sidecar path; stale past the heartbeat cadence
10
+ means the worker hung.
11
11
  --prompt a CLI-wrapper prompt-history path; no sibling .log or .status.json
12
12
  past the launch grace means the wrapper never started.
13
13