"""Render audit JSON as HTML for Gradio.
Design: a pre-publish readiness check, not a magazine. Cool grayscale instrument
panel where the only saturated colour is the verdict itself (severity = meaning).
Signature element: a linear readiness meter whose score can be visibly capped by
a blocking finding.
"""
from __future__ import annotations
import html
import json
from typing import Any
DIM_LABELS = {
"hook": "Hook",
"clarity": "Clarity",
"audienceFit": "Audience fit",
"goalService": "Goal service",
"cta": "Call to action",
}
SEV_ORDER = {"critical": 0, "warning": 1, "info": 2}
SEV_CLASS = {"critical": "crit", "warning": "warn", "info": "info"}
SEV_LABEL = {"critical": "blocker", "warning": "warning", "info": "note"}
def _esc(s: Any) -> str:
return html.escape(str(s if s is not None else ""))
def _band(pct: int) -> str:
if pct < 40:
return "crit"
if pct < 70:
return "warn"
return "ok"
def _dim_band(score: int) -> str:
if score <= 2:
return "crit"
if score == 3:
return "warn"
return "ok"
def _verdict(overall: int, capped: bool) -> tuple[str, str]:
"""Return (headline state, band) — the human verdict that opens the report."""
if capped:
return "Not ready to publish", "crit"
if overall < 40:
return "Not ready to publish", "crit"
if overall < 70:
return "Needs work", "warn"
return "Ready to publish", "ok"
def _meter(pct: int, capped: bool) -> str:
pct = max(0, min(100, pct))
band = _band(pct)
ceiling = (
''
'
ceiling
'
if capped
else ""
)
return f"""
{ceiling}
04070100
"""
def _render_audit(data: dict[str, Any]) -> str:
ga = data.get("goalAlignment") or {}
dims = ga.get("dimensions") or []
overall = int(ga.get("overall") or 0)
capped_list = ga.get("cappedBy") or []
capped = bool(capped_list)
state, band = _verdict(overall, capped)
warns = sorted(
data.get("warnings") or [],
key=lambda w: SEV_ORDER.get(w.get("severity", "info"), 9),
)
counts: dict[str, int] = {}
for w in warns:
sev = w.get("severity", "info")
counts[sev] = counts.get(sev, 0) + 1
count_str = " · ".join(
f"{counts[s]} {SEV_LABEL[s]}{'s' if counts[s] > 1 else ''}"
for s in ("critical", "warning", "info")
if counts.get(s)
)
# Hero — the verdict, the meter, and (the signature) the cap indictment.
cap_row = ""
if capped:
codes = "".join(f'{_esc(c)}' for c in capped_list)
cap_row = (
f'
held at {overall} / 100'
f'blocked by{codes}
'
)
summary = _esc(ga.get("summary") or "")
hero = f"""
pre-publish readiness check
{_esc(state)}
{overall}/100
{_meter(overall, capped)}
{cap_row}
{f'
{summary}
' if summary else ''}
"""
parts = [hero]
if dims:
parts.append('
Goal dimensions'
'score / 5
')
for dm in dims:
s = int(dm.get("score") or 0)
dband = _dim_band(s)
key = dm.get("key", "")
parts.append(
f"""
{_esc(DIM_LABELS.get(key, key))}{_esc(key)}
{s}/5
{_esc(dm.get("rationale") or "")}
"""
)
parts.append("
")
if warns:
parts.append(
f'
Findings'
f'{_esc(count_str)}
'
)
for w in warns:
cl = SEV_CLASS.get(w.get("severity", "info"), "info")
label = SEV_LABEL.get(w.get("severity", "info"), "note")
src = f'{_esc(w.get("source"))}' if w.get("source") else ""
ev = (
f'
{_esc(w.get("evidence"))}
'
if w.get("evidence")
else ""
)
parts.append(
f"""
{_esc(label)}{_esc(w.get("code"))}
{src}
{_esc(w.get("message"))}
{ev}
"""
)
parts.append("
")
hints = data.get("rewriteHints") or []
if hints:
items = "".join(f"
{_esc(h)}
" for h in hints)
parts.append(
f'
Fix before publishing
'
f'{items}'
)
return "".join(parts)
def _render_brief(data: dict[str, Any]) -> str:
ok = data.get("status") == "ok"
state = "Brief accepted" if ok else "Needs a clearer goal"
band = "ok" if ok else "warn"
note = (
"The audit ran on the goal and audience inferred below."
if ok
else "The goal is too vague to judge the post against. Pick a concrete target, then re-run."
)
inferred = data.get("inferred") or {}
parts = [
f"""
pre-publish readiness check
{_esc(state)}
{_esc(note)}
goal · inferred
{_esc(inferred.get("goal") or "—")}
audience · inferred
{_esc(inferred.get("audience") or "—")}
"""
]
gaps = data.get("gaps") or []
if gaps:
parts.append('
What to clarify
')
for g in gaps:
chips = "".join(f'{_esc(c)}' for c in g.get("candidates") or [])
parts.append(
f"""