"""Shared machinery for the document-style leadership pages.
Pure ASCII in and out. References record their own usage for the ledger's back-links."""
import html
import json
from pathlib import Path
SITE = Path(__file__).resolve().parent.parent / "site-v2"
if not SITE.exists():
SITE = Path(__file__).resolve().parent.parent / "site"
DATA = json.load(open(SITE / "assets" / "claims.json"))
CLAIMS = {c["id"]: c for c in DATA["claims"]}
S = DATA["summary"]
USAGE = {}
CURRENT = {"page": None, "anchor": None, "label": None}
GRADE_WORD = {
"A": "grade A: holds regardless of model progress",
"B": "grade B: current-generation measurement, confirmed at the bakeoff",
"C": "grade C: superseded-generation number, mechanism only",
}
def esc(s):
return html.escape(s, quote=True)
def at(page, anchor, label):
CURRENT.update(page=page, anchor=anchor, label=label)
def _record(cid):
entry = {"page": CURRENT["page"], "anchor": CURRENT["anchor"], "label": CURRENT["label"]}
bucket = USAGE.setdefault(cid, [])
if not any(e["page"] == entry["page"] and e["anchor"] == entry["anchor"] for e in bucket):
bucket.append(entry)
def R(cid):
"""Bracketed reference to a ledger entry. Records usage."""
c = CLAIMS.get(cid)
if c is None:
return ""
_record(cid)
du = c.get("decision_use") or {}
tip = esc(GRADE_WORD.get(du.get("grade", ""), "") + ". " + c["claim"][:180])
return '[%s]' % (cid, tip, cid)
def RG(cid, note):
"""Evidence row for the decision pages: ref, grade in words, one-line reason."""
c = CLAIMS.get(cid)
if c is None:
return ""
_record(cid)
du = c.get("decision_use") or {}
g = du.get("grade", "?")
basis = du.get("basis", "")
return ('%s (%s - %s) %s'
% (R(cid), esc("grade " + g), esc(basis), esc(note)))
def G(gid, label=None):
tip = "Measured gap: the reviewed corpus identifies no evidence; scheduled for in-house measurement."
return '[%s]' % (gid, tip, label or gid.upper())
NAV = [
("index.html", "home", "Overview"),
("brief.html", "summary", "Summary"),
("research.html", "research", "Research"),
("architecture.html", "architecture", "System"),
("pilot.html", "pilot", "Pilot"),
("decisions.html", "decisions", "Decisions"),
("evidence.html", "evidence", "Evidence"),
("library.html", "library", "Library"),
]
def shell(title, description, active, body):
nav = "\n ".join(
'%s' % (href, key, label) for href, key, label in NAV
)
return """
%s - AutoQASkip to content