okstra 0.209.3 → 0.209.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okstra",
-  "version": "0.209.3",
+  "version": "0.209.5",
   "description": "Host-aware multi-provider cross-verification orchestrator runtime and agent skills.",
   "license": "MIT",
   "author": "devonshin",

package/runtime/BUILD.json

@@ -1,5 +1,5 @@
 {
-  "package": "0.209.3",
-  "builtAt": "2026-10-05T06:23:58.308Z",
+  "package": "0.209.5",
+  "builtAt": "2026-10-05T07:34:52.243Z",
   "repoRoot": "/home/runner/work/okstra/okstra"
 }

package/runtime/bin/lib/okstra/usage.sh

@@ -11,7 +11,7 @@ summary:
 
   Skills, worker agents, and the codex wrapper are installed once per user under
   ~/.claude and ~/.okstra by scripts/okstra-install.sh. The user's settings.json
-  is never modified; `okstra setup` and the prepare path provision the project's
+  is never modified; \`okstra setup\` and the prepare path provision the project's
   .claude/settings.local.json as a symlink to ~/.okstra/templates/settings.local.json,
   which Claude Code auto-loads.
 

package/runtime/python/okstra_ctl/design_prep.py

@@ -313,6 +313,23 @@ def _complete_request(
     return "\n".join(lines) + "\n"
 
 
+def canonical_request_path(planning_seq: str, item_id: str) -> str:
+    return f"design-prep-requests/design-prep-request-{planning_seq}-{item_id}.md"
+
+
+def canonicalize_request_paths(data: Mapping[str, Any], data_path: Path) -> None:
+    """Name each open item's request by this report's planning seq.
+
+    The detector snapshot cannot know the report seq and names requests by stage
+    number, so a second planning run of the same task pointed its request at the
+    first run's file and materialization refused to overwrite it.
+    """
+    planning_seq = _planning_seq(Path(data_path))
+    for item in _design_preparation_items(data):
+        if isinstance(item, dict) and "requestPath" in item and isinstance(item.get("id"), str):
+            item["requestPath"] = canonical_request_path(planning_seq, item["id"])
+
+
 def _request_target(
     *,
     data_path: Path,
@@ -322,10 +339,7 @@ def _request_target(
     item_id = item.get("id")
     if not isinstance(item_id, str) or not item_id:
         raise DesignPrepError("design preparation item id must be a non-empty string")
-    expected_relative = (
-        "design-prep-requests/"
-        f"design-prep-request-{planning_seq}-{item_id}.md"
-    )
+    expected_relative = canonical_request_path(planning_seq, item_id)
     request_dir = data_path.parent.parent / "design-prep-requests"
     recorded = item.get("requestPath")
     if recorded == expected_relative:

package/runtime/python/okstra_ctl/entrypoints/hosts.py

@@ -257,7 +257,8 @@ def _launch_plan_payload(
         args, adapter.descriptor.id
     )
     request = LeadStartRequest(project_root, "", request_argv)
-    plan = start_run(request, context, adapter)
+    with _probe_paths(str(project_root), str(Path.home())):
+        plan = start_run(request, context, adapter)
     if dispatch_authority is not None:
         run_manifest_path, metadata_path, _assignment = dispatch_authority
         record_verified_agent_dispatch(
@@ -292,7 +293,8 @@ def _resume_plan_payload(
         args.session_id,
         tuple(args.request_arg),
     )
-    plan = resume_run(request, context, adapter)
+    with _probe_paths(str(project_root), str(Path.home())):
+        plan = resume_run(request, context, adapter)
     return {"ok": True, "_project_root": str(project_root), **asdict(plan)}
 
 

package/runtime/python/okstra_ctl/report_assembly.py

@@ -26,7 +26,11 @@ from .report_synthesis_packet import (
 )
 from .conformance import strip_stage_declaration_label
 from .coverage_census import census_warning_rows, read_census_state
-from .design_prep import DesignPrepError, materialize_design_prep_requests
+from .design_prep import (
+    DesignPrepError,
+    canonicalize_request_paths,
+    materialize_design_prep_requests,
+)
 from .phases.implementation_option_selection.validation import validate_blocked_answer_channel
 from .phases.technical_verification.validation import validate_technical_verification_report
 from .report_routing import technical_verification_routing_errors
@@ -830,6 +834,16 @@ def assemble_report(
     if input_issues:
         raise ReportAssemblyError(tuple(input_issues))
     data = _compose(project_root, manifest_path, manifest, inputs, schema)
+    value = manifest.get("expectedReportRecordPath")
+    if not isinstance(value, str) or not value:
+        _fail("orchestrator", manifest_path, "expectedReportRecordPath", "required")
+    target = Path(value)
+    target = target if target.is_absolute() else project_root / target
+    if manifest.get("taskType") == "implementation-planning":
+        try:
+            canonicalize_request_paths(data, target)
+        except DesignPrepError as exc:
+            _fail("orchestrator", target, "designPreparation", str(exc))
     errors = validate(data, schema)
     path_errors = planned_path_declaration_errors(data)
     if path_errors:
@@ -840,11 +854,6 @@ def assemble_report(
     direction_errors = selected_direction_plan_errors(
         data, project_root, manifest
     )
-    value = manifest.get("expectedReportRecordPath")
-    if not isinstance(value, str) or not value:
-        _fail("orchestrator", manifest_path, "expectedReportRecordPath", "required")
-    target = Path(value)
-    target = target if target.is_absolute() else project_root / target
     verification_errors = validate_technical_verification_report(data, target, project_root)
     verification_errors.extend(technical_verification_routing_errors(data))
     if verification_errors: