#!/usr/bin/env python3 import hashlib import json import os import shutil import subprocess import sys from pathlib import Path ROOT = Path(__file__).resolve().parent.parent SCRIPT = ROOT / "scripts" / "render_world_class_operator_runbook.py" CLI = ROOT / "scripts" / "yao.py" TMP = ROOT / "tests" / "tmp_world_class_operator_runbook" def sha256_file(path: Path) -> str: digest = hashlib.sha256() with path.open("rb") as handle: for chunk in iter(lambda: handle.read(1024 * 1024), b""): digest.update(chunk) return digest.hexdigest() def provider_submission() -> dict: return { "schema_version": "1.0", "evidence_key": "provider-holdout", "template_only": False, "category": "external", "source_type": "provider-output-eval", "submitted_by": "Yao provider operator", "submitted_at": "2026-06-14", "summary": "Aggregate provider-backed holdout evidence for ledger review.", "artifact_refs": [ { "path": "reports/output_execution_runs.json", "kind": "aggregate-report", "contains_raw_content": False, "sha256": sha256_file(ROOT / "reports" / "output_execution_runs.json"), } ], "provenance": {"provider": "openai", "model": "gpt-4.1-mini", "credential_material_committed": False}, "privacy": { "raw_user_content_included": False, "raw_provider_prompt_included": False, "credentials_included": False, "secrets_included": False, }, "anti_overclaim": { "planned_work_counts_as_evidence": False, "metadata_fallback_counts_as_native_enforcement": False, "pending_review_counts_as_human_decision": False, "local_command_runner_counts_as_provider_model": False, }, "attestation": { "real_external_or_human_evidence": True, "reviewer_or_operator_identity_present": True, "artifact_refs_reviewed": True, "privacy_contract_satisfied": True, }, } def run_direct(*extra: str) -> dict: proc = subprocess.run( [sys.executable, str(SCRIPT), str(ROOT), "--generated-at", "2026-06-14", *extra], cwd=ROOT, capture_output=True, text=True, check=True, ) return json.loads(proc.stdout) def run_cli(*extra: str) -> dict: env = dict(os.environ) env["YAO_CLI_TELEMETRY"] = "0" env.pop("YAO_CLI_TELEMETRY_EVENTS", None) proc = subprocess.run( [sys.executable, str(CLI), *extra], cwd=ROOT, capture_output=True, text=True, env=env, check=True, ) return json.loads(proc.stdout) def main() -> None: shutil.rmtree(TMP, ignore_errors=True) TMP.mkdir(parents=True, exist_ok=True) output_json = TMP / "world_class_operator_runbook.json" output_md = TMP / "world_class_operator_runbook.md" output_html = TMP / "world_class_operator_runbook.html" payload = run_direct("--output-json", str(output_json), "--output-md", str(output_md), "--output-html", str(output_html)) assert payload["schema_version"] == "1.0", payload assert payload["ok"] is True, payload summary = payload["summary"] assert summary["decision"] == "collect-evidence", summary assert summary["evidence_item_count"] == 4, summary assert summary["pending_count"] == 4, summary assert summary["awaiting_submission_count"] == 4, summary assert summary["ready_for_ledger_review_count"] == 0, summary assert summary["valid_packet_source_incomplete_count"] == 0, summary assert summary["invalid_submission_count"] == 0, summary assert summary["source_check_count"] >= 13, summary assert summary["source_pass_count"] + summary["source_blocked_count"] == summary["source_check_count"], summary assert summary["source_blocked_count"] >= 6, summary assert summary["ready_to_claim_world_class"] is False, summary assert summary["runbook_counts_as_completion"] is False, summary items = {item["evidence_key"]: item for item in payload["items"]} assert set(items) == { "provider-holdout", "human-adjudication", "native-permission-enforcement", "native-client-telemetry", }, items provider = items["provider-holdout"] assert provider["review_state"] == "awaiting-submission", provider assert provider["source_accepted"] is False, provider assert provider["blocked_source_check_count"] == 2, provider assert any("output-exec --provider-runner openai" in step for step in provider["execution_runbook"]), provider assert "Run provider-backed output-exec with real credentials." in provider["next_source_actions"], provider assert "Provider execution should return non-estimated token usage." in provider["next_source_actions"], provider assert provider["commands"]["prepare_submission"].startswith("python3 scripts/yao.py world-class-submission-kit"), provider assert "world-class-intake" in provider["commands"]["validate_intake"], provider assert "world-class-submission-review" in provider["commands"]["review_queue"], provider assert "world-class-ledger" in provider["commands"]["refresh_ledger"], provider assert "world-class-claim-guard" in provider["commands"]["guard_claim"], provider assert "provider-backed model run" in provider["must_collect"]["provenance_requirements"], provider assert "reports/output_execution_runs.json summary.model_executed_count > 0" in provider["must_collect"]["success_checks"], provider provider_source = {item["field"]: item for item in provider["source_checklist"]} assert provider_source["model_executed_count"]["status"] == "blocked", provider_source assert provider_source["timing_observed_count"]["status"] == "pass", provider_source assert provider_source["token_observed_count"]["status"] == "blocked", provider_source markdown = output_md.read_text(encoding="utf-8") assert "World-Class Operator Runbook" in markdown, markdown assert "runbook counts as completion: `false`" in markdown, markdown assert "Valid intake means ready for submission review; ledger review still requires passing source evidence." in markdown, markdown assert "| Evidence | Ledger | Intake | Review | Blocked checks | Next source action | Owner |" in markdown, markdown assert "| `provider-holdout` | `pending` | `awaiting-submission` | `awaiting-submission` | `2` | Run provider-backed output-exec with real credentials." in markdown, markdown assert "Source Runbook" in markdown, markdown assert "output-exec --provider-runner openai" in markdown, markdown assert "### Next Source Actions" in markdown, markdown assert "- Provider execution should return non-estimated token usage." in markdown, markdown assert "Source Evidence Snapshot" in markdown, markdown assert "| Check | Current | Expected | Status | Next action |" in markdown, markdown assert "| Provider model run | `0` | `>0` | `blocked` | Run provider-backed output-exec with real credentials. |" in markdown, markdown html = output_html.read_text(encoding="utf-8") assert "World-Class Operator Runbook" in html, html[:400] assert "ledger and claim guard" in html, html assert "position:sticky" in html, html assert "Ready0" in html, html assert "Invalid0" in html, html assert f"Blocked{summary['source_blocked_count']}" in html, html assert "
2