YAO
31ce04c655
Merge the beta-ready Yao Meta Skill architecture, report, evidence gate, and release-boundary updates.\n\nRelease boundary: beta/public testing is allowed; formal world-class, fully reviewed, or superiority claims remain blocked until the pending evidence gates are accepted.
351 lines
17 KiB
Python
351 lines
17 KiB
Python
#!/usr/bin/env python3
|
|
"""HTML layout helpers for the world-class evidence preflight report."""
|
|
|
|
from typing import Any
|
|
|
|
from html_rendering import html_text
|
|
|
|
|
|
SCRIPT_INTERFACE = "internal-module"
|
|
SCRIPT_INTERFACE_REASON = "Imported by render_world_class_preflight.py to keep preflight HTML layout out of data assembly."
|
|
|
|
|
|
def html_list(values: list[Any], empty: str) -> str:
|
|
if not values:
|
|
return f"<li>{html_text(empty)}</li>"
|
|
return "".join(f"<li>{html_text(value)}</li>" for value in values)
|
|
|
|
|
|
def render_html_commands(commands: dict[str, str]) -> str:
|
|
return "".join(
|
|
f"<li><span>{html_text(label.replace('_', ' '))}</span><code>{html_text(command)}</code></li>"
|
|
for label, command in commands.items()
|
|
)
|
|
|
|
|
|
def render_html_prechecks(rows: list[dict[str, Any]]) -> str:
|
|
if not rows:
|
|
return "<p class=\"muted\">No prechecks listed.</p>"
|
|
return "".join(
|
|
"""
|
|
<article class="check-row {status}">
|
|
<div>
|
|
<span>{kind}</span>
|
|
<strong>{label}</strong>
|
|
</div>
|
|
<dl>
|
|
<dt>Current</dt><dd><code>{actual}</code></dd>
|
|
<dt>Status</dt><dd>{status}</dd>
|
|
<dt>Action</dt><dd>{action}</dd>
|
|
</dl>
|
|
</article>
|
|
""".format(
|
|
status=html_text(row.get("status", "")),
|
|
kind=html_text(row.get("kind", "")),
|
|
label=html_text(row.get("label", "")),
|
|
actual=html_text(row.get("actual", "")),
|
|
action=html_text(row.get("next_action", "")),
|
|
)
|
|
for row in rows
|
|
)
|
|
|
|
|
|
def render_html_source_checks(rows: list[dict[str, Any]]) -> str:
|
|
if not rows:
|
|
return "<p class=\"muted\">No source checks listed.</p>"
|
|
return "".join(
|
|
"""
|
|
<article class="check-row {status}">
|
|
<div>
|
|
<span>{field}</span>
|
|
<strong>{label}</strong>
|
|
</div>
|
|
<dl>
|
|
<dt>Current</dt><dd><code>{actual}</code></dd>
|
|
<dt>Expected</dt><dd><code>{expected}</code></dd>
|
|
<dt>Status</dt><dd>{status}</dd>
|
|
<dt>Action</dt><dd>{action}</dd>
|
|
</dl>
|
|
</article>
|
|
""".format(
|
|
status=html_text(row.get("status", "")),
|
|
field=html_text(row.get("field", "")),
|
|
label=html_text(row.get("label", "")),
|
|
actual=html_text(row.get("actual", "")),
|
|
expected=html_text(row.get("expected", "")),
|
|
action=html_text(row.get("next_action", "")),
|
|
)
|
|
for row in rows
|
|
)
|
|
|
|
|
|
def render_html_repair_rows(rows: list[dict[str, Any]]) -> str:
|
|
if not rows:
|
|
return "<p class=\"muted\">No repair rows listed.</p>"
|
|
return "".join(
|
|
"""
|
|
<article class="repair-row {status}">
|
|
<div>
|
|
<span>{repair_type}</span>
|
|
<strong>{target}</strong>
|
|
</div>
|
|
<dl>
|
|
<dt>Priority</dt><dd>{priority}</dd>
|
|
<dt>Phase</dt><dd>{phase}</dd>
|
|
<dt>Owner</dt><dd>{owner}</dd>
|
|
<dt>Status</dt><dd>{status}</dd>
|
|
<dt>Reason</dt><dd>{reason}</dd>
|
|
<dt>Action</dt><dd>{action}</dd>
|
|
<dt>Verify</dt><dd><code>{verify}</code></dd>
|
|
<dt>Evidence</dt><dd>does not count as completion</dd>
|
|
</dl>
|
|
</article>
|
|
""".format(
|
|
status=html_text(row.get("status", "")),
|
|
repair_type=html_text(row.get("repair_type", "")),
|
|
target=html_text(row.get("target", "")),
|
|
priority=html_text(row.get("priority", "")),
|
|
phase=html_text(row.get("phase", "")),
|
|
owner=html_text(row.get("owner", "")),
|
|
reason=html_text(row.get("blocking_reason", "")),
|
|
action=html_text(row.get("next_action", "")),
|
|
verify=html_text(row.get("verification_command", "")),
|
|
)
|
|
for row in rows
|
|
)
|
|
|
|
|
|
def render_html_phase_queue(rows: list[dict[str, Any]]) -> str:
|
|
if not rows:
|
|
return "<p class=\"muted\">No phase queue rows listed.</p>"
|
|
return "".join(
|
|
"""
|
|
<article class="phase-row {status}">
|
|
<header>
|
|
<span>#{priority} · {status}</span>
|
|
<h3>{label}</h3>
|
|
</header>
|
|
<dl>
|
|
<dt>Phase</dt><dd><code>{phase}</code></dd>
|
|
<dt>Rows</dt><dd>{blocked} / {total} blocked</dd>
|
|
<dt>Owners</dt><dd>{owners}</dd>
|
|
<dt>Evidence</dt><dd>{evidence}</dd>
|
|
<dt>Next</dt><dd>{action}</dd>
|
|
<dt>Verify</dt><dd><code>{verify}</code></dd>
|
|
<dt>Counts</dt><dd>does not count as completion</dd>
|
|
</dl>
|
|
</article>
|
|
""".format(
|
|
status=html_text(row.get("status", "")),
|
|
priority=html_text(row.get("priority", "")),
|
|
label=html_text(row.get("label", "")),
|
|
phase=html_text(row.get("phase", "")),
|
|
blocked=html_text(row.get("blocked_count", 0)),
|
|
total=html_text(row.get("row_count", 0)),
|
|
owners=html_text(", ".join(str(owner) for owner in row.get("owners", [])) or "n/a"),
|
|
evidence=html_text(", ".join(str(key) for key in row.get("evidence_keys", [])) or "n/a"),
|
|
action=html_text(row.get("next_action", "")),
|
|
verify=html_text(row.get("verification_command", "")),
|
|
)
|
|
for row in rows
|
|
)
|
|
|
|
|
|
def render_html_artifact_roles(contract: dict[str, Any]) -> str:
|
|
cards = []
|
|
for role in contract.get("roles", []):
|
|
role_name = str(role.get("role", ""))
|
|
if role_name == "submission-ref":
|
|
ready = f"{contract.get('submission_ref_ready_count', 0)}/{contract.get('submission_ref_total_count', 0)} ready"
|
|
else:
|
|
ready = (
|
|
f"{contract.get('supporting_evidence_ready_count', 0)}/"
|
|
f"{contract.get('supporting_evidence_total_count', 0)} ready"
|
|
)
|
|
cards.append(
|
|
"""
|
|
<article class="role-card">
|
|
<span>{label}</span>
|
|
<h3>{role}</h3>
|
|
<strong>{ready}</strong>
|
|
<p>{description}</p>
|
|
<small>copy to artifact_refs: <code>{copy}</code></small>
|
|
</article>
|
|
""".format(
|
|
label=html_text(role.get("label", "")),
|
|
role=html_text(role_name),
|
|
ready=html_text(ready),
|
|
description=html_text(role.get("description", "")),
|
|
copy=html_text(str(role.get("copy_to_artifact_refs") is True).lower()),
|
|
)
|
|
)
|
|
return "".join(cards)
|
|
|
|
|
|
def render_html_item(item: dict[str, Any]) -> str:
|
|
role_contract = item.get("submission_kit", {}).get("artifact_role_contract", {})
|
|
return f"""
|
|
<article class="evidence-card {html_text(item.get('status', ''))}">
|
|
<header>
|
|
<span>{html_text(item.get('category', ''))} · {html_text(item.get('status', ''))}</span>
|
|
<h3>{html_text(item.get('label', item.get('evidence_key', '')))}</h3>
|
|
</header>
|
|
<dl class="meta">
|
|
<dt>Evidence</dt><dd><code>{html_text(item.get('evidence_key', ''))}</code></dd>
|
|
<dt>Ledger</dt><dd>{html_text(item.get('ledger_status', ''))}</dd>
|
|
<dt>Intake</dt><dd>{html_text(item.get('intake_readiness', ''))}</dd>
|
|
<dt>Review</dt><dd>{html_text(item.get('review_state', ''))}</dd>
|
|
<dt>Draft</dt><dd><code>{html_text(item.get('submission_path', ''))}</code></dd>
|
|
</dl>
|
|
<section class="next-action">
|
|
<h4>Next Action</h4>
|
|
<p>{html_text(item.get('next_action', ''))}</p>
|
|
<code>{html_text(item.get('commands', {}).get('prepare_submission', ''))}</code>
|
|
<code>{html_text(item.get('commands', {}).get('prepare_prefilled_submission', ''))}</code>
|
|
</section>
|
|
<section class="check-section">
|
|
<h4>Artifact Roles</h4>
|
|
<div class="role-grid compact">{render_html_artifact_roles(role_contract)}</div>
|
|
</section>
|
|
<section class="check-section">
|
|
<h4>Prechecks</h4>
|
|
<div class="check-grid">{render_html_prechecks(item.get('prechecks', []))}</div>
|
|
</section>
|
|
<section class="check-section">
|
|
<h4>Source Checks</h4>
|
|
<div class="check-grid">{render_html_source_checks(item.get('source_checklist', []))}</div>
|
|
</section>
|
|
<section class="check-section">
|
|
<h4>Repair Rows</h4>
|
|
<div class="repair-grid compact">{render_html_repair_rows(item.get('repair_checklist', []))}</div>
|
|
</section>
|
|
<section class="runbook">
|
|
<h4>Runbook</h4>
|
|
<ul>{html_list(item.get('runbook', []), 'No runbook steps listed.')}</ul>
|
|
</section>
|
|
</article>
|
|
"""
|
|
|
|
|
|
def render_html(report: dict[str, Any]) -> str:
|
|
summary = report["summary"]
|
|
stats = [
|
|
("Decision", summary["decision"]),
|
|
("Pending", summary["pending_count"]),
|
|
("Ready", summary["collection_ready_count"]),
|
|
("Blocked", summary["collection_blocked_count"]),
|
|
("Source", f"{summary['source_pass_count']}/{summary['source_check_count']}"),
|
|
("Repairs", f"{summary.get('repair_blocked_count', 0)}/{summary.get('repair_checklist_count', 0)}"),
|
|
("Phases", f"{summary.get('phase_queue_blocked_count', 0)}/{summary.get('phase_queue_count', 0)}"),
|
|
]
|
|
stat_html = "".join(
|
|
f"<article><span>{html_text(label)}</span><strong>{html_text(value)}</strong></article>"
|
|
for label, value in stats
|
|
)
|
|
role_contract = report["submissions"]["artifact_role_contract"]
|
|
item_cards = "".join(render_html_item(item) for item in report.get("items", []))
|
|
phase_queue_html = render_html_phase_queue(report.get("phase_queue", []))
|
|
html = f"""<!doctype html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
<title>World-Class Evidence Preflight</title>
|
|
<style>
|
|
:root {{ --ink:#1B365D; --text:#202124; --muted:#6f6a63; --line:#e8e1d8; --soft:#f8f6f2; --warn:#9b4d0f; --pass:#1f6f43; --block:#8a1f11; }}
|
|
* {{ box-sizing:border-box; }}
|
|
body {{ margin:0; background:#fff; color:var(--text); font:16px/1.55 Georgia, "Times New Roman", serif; }}
|
|
.topbar {{ position:sticky; top:0; z-index:10; background:rgba(255,255,255,.96); border-bottom:1px solid var(--line); }}
|
|
.topbar-inner {{ max-width:1180px; margin:0 auto; padding:12px 24px; display:flex; justify-content:space-between; gap:16px; align-items:center; }}
|
|
.brand, a, h1, h2, h3, h4 {{ color:var(--ink); }}
|
|
.links {{ display:flex; gap:14px; flex-wrap:wrap; }}
|
|
.links a {{ text-decoration:none; }}
|
|
.shell {{ max-width:1180px; margin:0 auto; padding:36px 24px 72px; }}
|
|
.hero {{ border-bottom:1px solid var(--line); padding:32px 0 28px; }}
|
|
.eyebrow {{ color:var(--ink); font-size:12px; text-transform:uppercase; font-weight:700; letter-spacing:0; }}
|
|
h1 {{ margin:8px 0 12px; font-size:56px; line-height:1.04; letter-spacing:0; }}
|
|
h2 {{ margin:0 0 14px; font-size:30px; letter-spacing:0; }}
|
|
h3 {{ margin:4px 0 10px; font-size:22px; letter-spacing:0; }}
|
|
h4 {{ margin:0 0 8px; font-size:16px; letter-spacing:0; }}
|
|
.lede {{ max-width:820px; color:var(--muted); font-size:20px; }}
|
|
.stats {{ display:grid; grid-template-columns:repeat(7, minmax(0,1fr)); gap:12px; margin:26px 0 0; }}
|
|
.stats article, .panel, .evidence-card, .check-row, .repair-row, .phase-row {{ border:1px solid var(--line); border-radius:8px; background:#fff; }}
|
|
.stats article {{ padding:16px; }}
|
|
.stats span, .muted, .evidence-card header span, .check-row span, .repair-row span, .phase-row span {{ color:var(--muted); }}
|
|
.stats strong {{ display:block; color:var(--ink); font-size:28px; line-height:1.15; overflow-wrap:anywhere; }}
|
|
.section {{ padding:32px 0; border-bottom:1px solid var(--line); }}
|
|
.two-col {{ display:grid; grid-template-columns:minmax(0,.45fr) minmax(0,1fr); gap:18px; align-items:start; }}
|
|
.panel {{ padding:20px; min-width:0; }}
|
|
.commands {{ list-style:none; padding:0; margin:0; display:grid; gap:10px; }}
|
|
.commands li {{ padding:12px; background:var(--soft); border-radius:8px; }}
|
|
.commands span {{ display:block; color:var(--ink); font-weight:700; margin-bottom:4px; }}
|
|
.role-grid {{ display:grid; grid-template-columns:repeat(2, minmax(0,1fr)); gap:12px; margin-top:16px; }}
|
|
.role-grid.compact {{ margin-top:0; }}
|
|
.role-card {{ border:1px solid var(--line); border-radius:8px; padding:14px; background:#fff; min-width:0; }}
|
|
.role-card span, .role-card small {{ color:var(--muted); }}
|
|
.role-card strong {{ display:block; color:var(--ink); font-size:22px; margin:4px 0 6px; overflow-wrap:anywhere; }}
|
|
.role-card p {{ margin:0 0 8px; }}
|
|
.evidence-grid {{ display:grid; gap:18px; }}
|
|
.evidence-card {{ padding:20px; min-width:0; }}
|
|
.phase-grid {{ display:grid; grid-template-columns:repeat(2, minmax(0,1fr)); gap:14px; margin-bottom:24px; }}
|
|
.phase-row {{ padding:18px; min-width:0; }}
|
|
.evidence-card.blocked {{ border-left:4px solid var(--block); }}
|
|
.evidence-card.ready-for-human-review, .evidence-card.ready-to-collect, .check-row.human-required, .check-row.external-required, .check-row.missing, .check-row.blocked, .repair-row.blocked, .phase-row.blocked {{ border-left:4px solid var(--warn); }}
|
|
.evidence-card.ready-for-submission, .check-row.pass, .repair-row.ready, .phase-row.ready {{ border-left:4px solid var(--pass); }}
|
|
.meta, .check-row dl, .repair-row dl, .phase-row dl {{ display:grid; grid-template-columns:96px minmax(0,1fr); gap:8px 12px; }}
|
|
dt {{ color:var(--ink); }}
|
|
dd {{ margin:0; min-width:0; overflow-wrap:anywhere; }}
|
|
code {{ font-family:ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; font-size:13px; overflow-wrap:anywhere; }}
|
|
.next-action, .runbook {{ background:var(--soft); border-radius:8px; padding:14px; margin:14px 0; }}
|
|
.next-action p {{ margin-top:0; }}
|
|
.next-action code {{ display:block; margin-top:8px; }}
|
|
.check-grid {{ display:grid; grid-template-columns:repeat(2, minmax(0,1fr)); gap:12px; }}
|
|
.repair-grid {{ display:grid; grid-template-columns:repeat(2, minmax(0,1fr)); gap:12px; }}
|
|
.check-row, .repair-row {{ padding:14px; min-width:0; }}
|
|
.check-section {{ margin-top:16px; }}
|
|
.notice {{ background:var(--soft); border-left:4px solid var(--ink); padding:16px; border-radius:8px; }}
|
|
li {{ overflow-wrap:anywhere; }}
|
|
@media (max-width:820px) {{ .stats, .two-col, .check-grid, .repair-grid, .role-grid, .phase-grid {{ grid-template-columns:1fr; }} h1 {{ font-size:38px; }} .topbar-inner {{ align-items:flex-start; flex-direction:column; }} }}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<nav class="topbar"><div class="topbar-inner"><span class="brand">World-Class Preflight</span><div class="links"><a href="#handoff">Handoff</a><a href="#queue">Queue</a><a href="#boundary">Boundary</a></div></div></nav>
|
|
<main class="shell">
|
|
<section class="hero">
|
|
<span class="eyebrow">Evidence Collection</span>
|
|
<h1>World-Class Evidence Preflight</h1>
|
|
<p class="lede">This operator view shows which external and human evidence is still blocked, which commands prepare editable submission drafts, and why preflight never counts as accepted evidence.</p>
|
|
<div class="stats">{stat_html}</div>
|
|
</section>
|
|
<section class="section two-col" id="handoff">
|
|
<article class="panel">
|
|
<h2>Submission Kit</h2>
|
|
<p class="muted">Generate drafts only after real provider, human-review, native-permission, or native-client work exists. Drafts remain non-evidence until valid aggregate artifact refs and SHA-256 digests are supplied. Artifact prefill is convenience data only.</p>
|
|
<ul>
|
|
<li>submissions directory: <code>{html_text(report['submissions']['directory'])}</code></li>
|
|
<li>drafts count as evidence: <code>{html_text(str(report['submissions']['drafts_count_as_evidence']).lower())}</code></li>
|
|
<li>artifact prefill counts as evidence: <code>{html_text(str(report['submissions']['artifact_prefill_counts_as_evidence']).lower())}</code></li>
|
|
<li>preflight accepts evidence: <code>{html_text(str(report['summary']['preflight_counts_as_evidence']).lower())}</code></li>
|
|
</ul>
|
|
<div class="role-grid">{render_html_artifact_roles(role_contract)}</div>
|
|
<p class="muted"><code>submission-ref</code> rows are the paths expected in <code>artifact_refs</code>; <code>supporting-evidence</code> rows stay available for audit context.</p>
|
|
</article>
|
|
<aside class="panel"><h2>Commands</h2><ul class="commands">{render_html_commands(report['submissions']['commands'])}</ul></aside>
|
|
</section>
|
|
<section class="section" id="queue">
|
|
<h2>Phase Queue</h2>
|
|
<p class="muted">Repair rows are grouped into execution phases so operators can clear the first blocker before moving to later source collection. Phase queue rows remain procedural and never count as accepted evidence.</p>
|
|
<div class="phase-grid">{phase_queue_html}</div>
|
|
<h2>Evidence Queue</h2>
|
|
<div class="evidence-grid">{item_cards}</div>
|
|
</section>
|
|
<section class="section" id="boundary">
|
|
<h2>Safety Boundary</h2>
|
|
<div class="notice"><ul><li>Environment variables are displayed only as set or not-set; secret values are never printed.</li><li>Human-required and external-required states are operator work, not accepted evidence.</li><li>The world-class ledger remains the only source of truth for ready_to_claim_world_class.</li></ul></div>
|
|
</section>
|
|
</main>
|
|
</body>
|
|
</html>
|
|
"""
|
|
return "\n".join(line.rstrip() for line in html.splitlines()) + "\n"
|