okstra 0.207.1 → 0.209.0

package/runtime/python/okstra_ctl/render.py

@@ -784,7 +784,7 @@ def render_team_state(team_state_path: str, ctx: dict) -> None:
     catalog = _worker_catalog(ctx)
     worker_dispatch_plan = _worker_dispatch_plan(ctx)
     workers = []
-    for row in _optional_worker_roles(ctx):
+    for row in _critic_role_rows(ctx):
         workers.append({
             **{key: row[key] for key in (
                 "workerId", "role", "agent", "provider", "runner",
@@ -1180,7 +1180,7 @@ def migrate_legacy_run_artifacts(ctx: dict) -> None:
 # --------------------------------------------------------------------------- #
 
 
-def _required_worker_roles(ctx: dict, reviewers: list[str]) -> list[dict]:
+def _worker_role_rows(ctx: dict, reviewers: list[str]) -> list[dict]:
     catalog = _worker_catalog(ctx)
     return [
         {
@@ -1199,7 +1199,7 @@ def _required_worker_roles(ctx: dict, reviewers: list[str]) -> list[dict]:
     ]
 
 
-def _optional_worker_roles(ctx: dict) -> list[dict]:
+def _critic_role_rows(ctx: dict) -> list[dict]:
     """선택해 배정한 비평 역할. 선택 후에는 실행 또는 미실행 사유가 필요하다.
 
     `invocationAssignments`의 `critic/*` 배정만 선언하므로 역할을 선택하지
@@ -1412,7 +1412,7 @@ def render_task_manifest(manifest_path: str, ctx: dict) -> None:
     reviewers = _resolve_workers(ctx)
     worker_dispatch_plan = _worker_dispatch_plan(ctx)
     catalog = _worker_catalog(ctx)
-    required_worker_roles = _required_worker_roles(ctx, reviewers)
+    worker_role_rows = _worker_role_rows(ctx, reviewers)
     worker_prompt_paths = {item: catalog[item]["promptPath"] for item in reviewers}
     lead_agent = _lead_agent(ctx)
     lead_role = _lead_role(ctx)
@@ -1557,13 +1557,10 @@ def render_task_manifest(manifest_path: str, ctx: dict) -> None:
             "finalReportFormat": "markdown",
             "finalReportFilename": ctx.get("FINAL_REPORT_FILENAME", ""),
             "finalStatusFilename": ctx.get("FINAL_STATUS_FILENAME", ""),
-            "minimumPreferredWorkerResults": len(reviewers),
-            "requiredWorkerAttempts": reviewers,
-            "requiredWorkerRoles": required_worker_roles,
-            "optionalWorkerRoles": _optional_worker_roles(ctx),
+            "workerRoles": worker_role_rows,
+            "criticRoles": _critic_role_rows(ctx),
             "requiredAgentStatusEntries": required_agent_status_entries,
             "requireDistinctLeadFromWorkerSession": True,
-            "requireAllRequiredWorkerAttempts": True,
             "requireAntigravityWorkerAttempt": "antigravity" in reviewers,
             "requireCollectedWorkerStatusesBeforeFinalVerdict": True,
             "disallowLeadSoloAnalysisAsWorkerResult": True,
@@ -1574,6 +1571,7 @@ def render_task_manifest(manifest_path: str, ctx: dict) -> None:
                 "Safe or Reasonable Areas",
                 "Uncertain Points",
                 "Recommended Next Actions",
+                "Coverage Verdicts",
             ],
             "finalReportSections": [
                 "Problem or Validation Summary",
@@ -1736,7 +1734,7 @@ def render_run_manifest(run_manifest_path: str, ctx: dict) -> None:
     reviewers = _resolve_workers(ctx)
     worker_dispatch_plan = _worker_dispatch_plan(ctx)
     catalog = _worker_catalog(ctx)
-    required_worker_roles = _required_worker_roles(ctx, reviewers)
+    worker_role_rows = _worker_role_rows(ctx, reviewers)
     worker_prompt_paths = {item: catalog[item]["promptPath"] for item in reviewers}
     lead_agent = _lead_agent(ctx)
     lead_role = _lead_role(ctx)
@@ -1903,18 +1901,15 @@ def render_run_manifest(run_manifest_path: str, ctx: dict) -> None:
             "leadModelExecutionValue": ctx.get("LEAD_MODEL_EXECUTION_VALUE", ""),
             "leadExecutionMode": "synthesis-only",
             "finalSynthesisOwner": lead_role,
-            "requiredWorkerAttempts": reviewers,
-            "requiredWorkerRoles": required_worker_roles,
-            "optionalWorkerRoles": _optional_worker_roles(ctx),
+            "workerRoles": worker_role_rows,
+            "criticRoles": _critic_role_rows(ctx),
             "requiredAgentStatusEntries": [lead_role]
             + [catalog[item]["role"] for item in reviewers],
             "requireDistinctLeadFromWorkerSession": True,
-            "requireAllRequiredWorkerAttempts": True,
             "requireAntigravityWorkerAttempt": "antigravity" in reviewers,
             "requireCollectedWorkerStatusesBeforeFinalVerdict": True,
             "disallowLeadSoloAnalysisAsWorkerResult": True,
             "disallowGenericParallelOnlyExecution": True,
-            "preferredCompletedWorkerResults": len(reviewers),
             "executor": _executor_contract(ctx),
         },
         "validation": {
@@ -2696,7 +2691,6 @@ def inject_lead_prompt_computed_tokens(ctx: dict) -> None:
     model_assignment_lines = [
         fmt_assignment(lead_role, lead_model, lead_model_execution)
     ]
-    worker_role_labels: list[str] = []
     execution_status_entries = [f"`{lead_role}`"]
     execution_status_table_lines = [
         "| 에이전트 | 역할 | 모델 | 상태 | 핵심 발견 요약 |",
@@ -2714,35 +2708,11 @@ def inject_lead_prompt_computed_tokens(ctx: dict) -> None:
         model_assignment_lines.append(
             fmt_assignment(m["role"], m["model"], m["modelExecutionValue"])
         )
-        worker_role_labels.append(f"`{m['role']}`")
         execution_status_entries.append(f"`{m['role']}`")
         execution_status_table_lines.append(
             f"| {m['agentLabel']} | {m['role']} | {m['model']} | completed / timeout / error / not-run | {m['role']}의 핵심 발견 요약 |"
         )
 
-    if worker_role_labels:
-        if len(worker_role_labels) == 1:
-            worker_role_sentence = (
-                f"- {worker_role_labels[0]} is the required worker role."
-            )
-        else:
-            worker_role_sentence = (
-                f"- {', '.join(worker_role_labels[:-1])}, "
-                f"and {worker_role_labels[-1]} are the required worker roles."
-            )
-        preferred_results_sentence = (
-            f"- Aim to collect completed results from all "
-            f"{len(worker_role_labels)} required workers."
-        )
-    else:
-        worker_role_sentence = "- No worker roles were selected for this run."
-        preferred_results_sentence = "- No worker results are expected for this run."
-    worker_attempt_sentence = (
-        "- `Antigravity worker` is mandatory to attempt for this workflow."
-        if "antigravity" in selected
-        else "- `Antigravity worker` is not selected for this run, so no Antigravity attempt is required."
-    )
-
     task_type = ctx.get("TASK_TYPE", "")
     adapter_setup_facts: list[str] = []
     if lead_runtime == "claude-code":
@@ -2865,9 +2835,6 @@ def inject_lead_prompt_computed_tokens(ctx: dict) -> None:
     ctx["WORKER_RESULT_PATH_LINES"] = "\n".join(worker_result_lines)
     ctx["MODEL_ASSIGNMENT_LINES"] = "\n".join(model_assignment_lines)
     ctx["TEAM_ROLE_LINES"] = "\n".join(team_role_lines)
-    ctx["REQUIRED_WORKER_ROLE_SENTENCE"] = worker_role_sentence
-    ctx["ANTIGRAVITY_ATTEMPT_SENTENCE"] = worker_attempt_sentence
-    ctx["PREFERRED_WORKER_RESULTS_SENTENCE"] = preferred_results_sentence
     ctx["EXECUTION_STATUS_EXACT_ENTRIES"] = ", ".join(execution_status_entries)
     ctx["EXECUTION_STATUS_TABLE_ROWS"] = "\n".join(execution_status_table_lines)
 

package/runtime/python/okstra_ctl/render_final_report.py

@@ -817,6 +817,9 @@ def render_to_file(
         raise _with_excerpt_drift_hint(exc, data_path, str(task_type or "")) from exc
 
     output_path.parent.mkdir(parents=True, exist_ok=True)
+    from .business_flow.hooks import markdown_report_links
+
+    rendered += markdown_report_links(data_path)
     tmp = output_path.with_suffix(output_path.suffix + f".tmp.{os.getpid()}")
     tmp.write_text(rendered, encoding="utf-8")
     tmp.replace(output_path)

package/runtime/python/okstra_ctl/report_assembly.py

@@ -25,6 +25,7 @@ from .report_synthesis_packet import (
     verify_report_synthesis_packet_sources,
 )
 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 .phases.implementation_option_selection.validation import validate_blocked_answer_channel
 from .phases.technical_verification.validation import validate_technical_verification_report
@@ -498,7 +499,7 @@ def _compose(
         data["verificationScope"] = scope
     data["agentActivity"] = activities
     data["evidence"] = {"primary": _promoted_evidence(convergence_data)}
-    data["missingInformation"] = []
+    data["missingInformation"] = _census_missing_information(project_root, manifest)
     # 스냅샷 복사가 _attach_metadata 보다 먼저다 — frontmatter 가
     # selectedDirectionRef.snapshotPath 를 읽는다.
     _apply_selected_direction_snapshot(data, project_root, manifest)
@@ -509,6 +510,19 @@ def _compose(
     return data
 
 
+def _census_missing_information(
+    project_root: Path, manifest: Mapping[str, Any],
+) -> list[dict[str, Any]]:
+    """Coverage-census warnings are the only rows this field carries under the
+    v3 contract, so they number from `R-001`."""
+    state = read_census_state(project_root, manifest)
+    if state is None:
+        return []
+    _project_id, _task_group, task_id = _identity(manifest)
+    rows = census_warning_rows(state, ticket_id=task_id or "unknown")
+    return [{"id": f"R-{index:03d}", **row} for index, row in enumerate(rows, start=1)]
+
+
 def _selected_direction_inputs(
     project_root: Path, manifest: Mapping[str, Any]
 ) -> tuple[Path, Path]:

package/runtime/python/okstra_ctl/report_finalize.py

@@ -51,6 +51,7 @@ from typing import Any, Callable, Mapping, Sequence
 from . import group_context
 from .agent.activity import ActivityProjectionError, project_agent_activity
 from .report_contract import apply_execution_roles
+from .coverage_census import census_warnings, read_census_state
 from .report_assembly import ReportAssemblyError, assemble_report
 from .dispatch_state import (
     DispatchError,
@@ -722,9 +723,35 @@ def run_finalize(
     # closeout 이 실제로 건넬 명령. 표를 리드의 기억에 맡기지 않는다.
     payload["nextCommand"] = closeout_command(payload)
     payload["reportPaths"] = _closeout_report_paths(ctx)
+    for step in steps:
+        if step["name"] == "business-flow":
+            payload["businessProcess"] = step["result"]
+            # 선택 단계라 exitCode 는 0 이다. 실패를 중첩 JSON 에만 두면 리드가 못 본다.
+            failed = [
+                {"id": row.get("id", ""), "mode": row.get("mode", ""), "error": row.get("error", "")}
+                for row in step["result"].get("executions") or []
+                if isinstance(row, dict) and row.get("status") == "failed"
+            ]
+            if step["result"].get("error"):
+                failed.append({"id": "", "mode": "", "error": str(step["result"]["error"])})
+            if failed:
+                payload["businessFlowWarnings"] = failed
+    census = _census_summary(ctx)
+    if census is not None:
+        payload["censusWarnings"] = census
     return payload
 
 
+def _census_summary(ctx: FinalizeContext) -> dict[str, Any] | None:
+    """Unverdicted census cells per worker, for the lead's completion line."""
+    try:
+        manifest = load_owned_object(ctx.manifest_path, artifact="run manifest")
+    except JsonBoundaryError as exc:
+        return {"auditProblem": f"the run manifest could not be read: {exc}"}
+    state = read_census_state(ctx.project_root, manifest)
+    return census_warnings(state) if state is not None else None
+
+
 def _execute_finalize_steps(
     ctx: FinalizeContext, commands: Sequence[tuple[str, list[str]]],
     before_step: Callable[[str], None] | None,
@@ -768,11 +795,34 @@ def _execute_finalize_steps(
             first_failure = f"{name} failed with exit code {result.returncode}"
         if name == STEP_VALIDATE_RUN and result.returncode == 0:
             validated = True
+            if not first_failure:
+                business = _finalize_business_effects(ctx)
+                if business is not None:
+                    steps.append({"name": "business-flow", "exitCode": 0, "result": business})
     if validated and not first_failure:
         _record_run_end(ctx.team_state_path)
     return steps, first_failure
 
 
+def _finalize_business_effects(ctx: FinalizeContext) -> dict[str, Any] | None:
+    from .business_flow.hooks import finalize_business_flow
+
+    result = None
+    try:
+        result = finalize_business_flow(ctx.project_root, _load_manifest(ctx.manifest_path), ctx.data_path)
+        if result is not None and result.get("executions"):
+            from .render_final_report import render_to_file
+            from .report_html.render import render_v2_html_view
+            from .report_html.models import HtmlRunMeta
+
+            render_to_file(ctx.data_path, ctx.markdown_path)
+            render_v2_html_view(ctx.data_path, run_meta=HtmlRunMeta(
+                ctx.task_key, ctx.task_type, ctx.seq, str(ctx.markdown_path)))
+        return result
+    except Exception as exc:
+        return {**result, "viewError": str(exc)} if result is not None else {"status": "failed", "error": str(exc), "executions": []}
+
+
 def _finalize_recovery(ctx: FinalizeContext, result: Mapping[str, Any]) -> dict[str, Any]:
     """새 실행 대신 실패한 처리부터 재개할 명령과 원본 소유자 오류를 전달한다."""
     order = V3_STEP_ORDER if ctx.report_contract_version == "3.0" else STEP_ORDER

package/runtime/python/okstra_ctl/report_html/render.py

@@ -226,6 +226,9 @@ def render_v2_html_view(
         "css": (root / "html/assets/base.css").read_text(encoding="utf-8"),
         "js": response_js + "\n" + base_js,
     }
+    from ..business_flow.hooks import report_links
+
+    context["businessFlow"] = report_links(data_path)
     output_path = _html_path(data_path)
     document = env.get_template(route.template_name).render(**context)
     document = inject_report_index(document, label=translate("base.contents"))

package/runtime/python/okstra_ctl/report_synthesis_packet.py

@@ -364,8 +364,7 @@ _SOURCE_FIELDS = (
 _READ_CHUNK_BYTES = 16_000
 _SHARED_TEXT_MIN_BYTES = 256
 _ANALYSER_OPERATION_SECTIONS = frozenset({
-    "Required workers", "Optional workers", "Team contract",
-    "Worker interaction model", "Tooling — read-only MCP availability",
+    "Team contract", "Worker interaction model", "Tooling — read-only MCP availability",
     "Run-scoped worker-resource lifecycle",
 })