okstra 0.180.0 → 0.184.0

package/runtime/python/okstra_ctl/mutation_probe.py

@@ -85,6 +85,7 @@ from .self_mock_signals import (
     partition_waived_entries,
     selfmock_path_key,
 )
+from .json_boundary import JsonBoundaryError, external_tool_json_source, load_external_json
 
 # `survived` is read by a human in the sidecar, so it is trimmed. The verdict and
 # the logged total are taken before the trim — the cap shortens the report, never
@@ -414,8 +415,12 @@ class StrykerAdapter:
         if not path.is_file():
             return None
         try:
-            return json.loads(path.read_text(encoding="utf-8"))
-        except (OSError, json.JSONDecodeError):
+            # 외부 입력: mutation testing 도구가 생성한 실행 보고서다.
+            return load_external_json(
+                external_tool_json_source(path, Path(worktree) if worktree else Path.cwd()),
+                artifact="mutation test report",
+            )
+        except JsonBoundaryError:
             return None
 
 
@@ -1004,8 +1009,12 @@ class CargoMutantsAdapter:
         if not path.is_file():
             return None
         try:
-            data = json.loads(path.read_text(encoding="utf-8"))
-        except (OSError, json.JSONDecodeError):
+            # 외부 입력: mutation testing 도구가 생성한 실행 보고서다.
+            data = load_external_json(
+                external_tool_json_source(path, Path(worktree) if worktree else Path.cwd()),
+                artifact="mutation test report",
+            )
+        except JsonBoundaryError:
             return None
         return data if isinstance(data, dict) else None
 

package/runtime/python/okstra_ctl/pane_reclaim.py

@@ -18,6 +18,7 @@ import sys
 from pathlib import Path
 
 from .dispatch_state import NON_TERMINAL_WORKER_STATUSES
+from .json_boundary import JsonBoundaryError, load_owned_object
 
 
 def _newest_team_state(state_dir: Path) -> Path | None:
@@ -33,8 +34,8 @@ def _newest_team_state(state_dir: Path) -> Path | None:
 
 def _has_live_dispatch(team_state_path: Path) -> bool:
     try:
-        payload = json.loads(team_state_path.read_text(encoding="utf-8"))
-    except (OSError, json.JSONDecodeError):
+        payload = load_owned_object(team_state_path, artifact="team state")
+    except JsonBoundaryError:
         return False
     if not isinstance(payload, dict):
         return False

package/runtime/python/okstra_ctl/paths.py

@@ -552,6 +552,9 @@ def compute_run_paths(
     team_state = run_state / f"team-state{suffixes['state']}.json"
     active_run_context = run_state / f"active-run-context{suffixes['state']}.json"
     lead_events = run_state / f"lead-events-{task_type_segment}-{seqs['state']}.jsonl"
+    convergence_state = (
+        run_state / f"convergence-{task_type_segment}-{seqs['state']}.json"
+    )
     final_report_template = instruction_set / "final-report-template.md"
     final_report_schema = instruction_set / "final-report-schema.json"
     reference_expectations = instruction_set / "reference-expectations.md"
@@ -674,6 +677,7 @@ def compute_run_paths(
         "REPORT_WRITER_NARRATIVE_FILE": str(report_writer_narrative),
         "APPROVAL_DECISIONS_PATH": str(approval_decisions),
         "DESIGN_PREPARATION_PATH": str(design_preparation),
+        "CONVERGENCE_STATE_PATH": str(convergence_state),
         "PLAN_BODY_VERIFICATION_STATE_PATH": str(plan_body_verification),
         "RUN_ERRORS_LOG_PATH": str(run_errors_log),
         "CLAUDE_WORKER_ERRORS_SIDECAR_PATH": str(claude_worker_errors_sidecar),
@@ -732,6 +736,11 @@ def compute_run_paths(
         ("FINAL_REPORT_RECORD_RELATIVE_PATH", final_report),
         ("FINAL_STATUS_RELATIVE_PATH", final_status),
         ("TEAM_STATE_RELATIVE_PATH", team_state),
+        # `render.py` 가 이 키로 매니페스트의 `convergenceStatePath` 를 채운다.
+        # `path_hints` 만 내보내던 동안 그 필드가 빈 문자열로 렌더돼,
+        # `report-finalize` 가 "report contract 3.0 requires convergenceStatePath"
+        # 로 죽었다 — 수렴 상태 파일 자체는 정상 생성돼 있었다.
+        ("CONVERGENCE_STATE_RELATIVE_PATH", convergence_state),
         ("ACTIVE_RUN_CONTEXT_RELATIVE_PATH", active_run_context),
         ("LEAD_EVENTS_RELATIVE_PATH", lead_events),
         ("WORKER_RESULTS_RELATIVE_PATH", worker_results),