sergio/takana

1#!/usr/bin/env python3
2# build-state-view.py — vista HUMANA del grafo de estado. Lee docs/state/build-state.json (la fuente
3# firme que emite build-state.py) y emite docs/state/build-state.html: un dashboard self-contained
4# (sin recursos externos) para VER y SEGUIR el avance, los huecos y los fallos.
5#
6# El dato clave que añade sobre el JSON crudo: para cada receta en deuda, computa quién la BLOQUEA
7# —sus deps que también están en deuda— usando el grafo. Una receta en deuda con TODAS sus deps
8# selladas está "lista para construir ya"; una con deps en deuda debe esperar. Ese es el uso
9# accionable del orden topológico: qué atacar primero.
10#
11# Uso:   scripts/build-state-view.py         # corpus → docs/state/build-state.html
12#        scripts/build-state-view.py --kde   # frente KDE → docs/state/build-state-kde.html
13import json, html, sys
14from pathlib import Path
15from datetime import datetime, timezone
16
17ROOT = Path(__file__).resolve().parent.parent
18KDE = "--kde" in sys.argv
19DATA = ROOT / ("docs/state/build-state-kde.json" if KDE else "docs/state/build-state.json")
20OUT = ROOT / ("docs/state/build-state-kde.html" if KDE else "docs/state/build-state.html")
21
22doc = json.loads(DATA.read_text())
23nodes = doc["nodes"]
24
25STATE_ORDER = ["sealed", "debt", "never", "unhashable"]
26STATE_ES = {"sealed": "sellado al día", "debt": "deuda de rebuild",
27            "never": "nunca construida", "unhashable": "ilegible"}
28CLASS_ES = {"c": "C", "go": "Go", "rust": "Rust", "gui": "GUI", "kernel": "kernel"}
29
30# blocked_by / unblocks los computa build-state.py sobre el grafo; acá sólo los leemos.
31def blockers(name):
32    return nodes[name].get("blocked_by", [])
33def unblocks(name):
34    return nodes[name].get("unblocks", 0)
35
36debt = {n: r for n, r in nodes.items() if r["state"] in ("debt", "never", "unhashable")}
37# Orden de ATAQUE: primero las "listas" (sin bloqueadores), y entre ellas la que DESBLOQUEA más
38# arriba; luego las bloqueadas por menos, luego alfabético. Es el orden que libera el grafo más rápido.
39def debt_key(n):
40    b = blockers(n)
41    return (len(b), -unblocks(n), nodes[n]["cls"], n)
42debt_sorted = sorted(debt, key=debt_key)
43ready = [n for n in debt_sorted if not blockers(n)]
44
45totals = doc["totals"]
46n_total = totals["recipes"]
47
48# Reparto por clase (para las barras por-clase).
49classes = {}
50for n, r in nodes.items():
51    c = r.get("cls", "c")
52    classes.setdefault(c, {s: 0 for s in STATE_ORDER})
53    classes[c][r["state"]] += 1
54
55def pct(x): return f"{100*x/n_total:.1f}%"
56
57E = html.escape
58
59def chip(dep):
60    st = nodes[dep]["state"] if dep in nodes else "unhashable"
61    return f'<span class="chip s-{st}" title="{E(STATE_ES.get(st, st))}">{E(dep)}</span>'
62
63# ---- barra de progreso apilada (sealed|debt|never|unhashable) ----
64seg = ""
65for s in STATE_ORDER:
66    v = totals.get(s, 0)
67    if v:
68        seg += f'<span class="seg s-{s}" style="width:{100*v/n_total}%" title="{E(STATE_ES[s])}: {v}"></span>'
69
70# ---- tiles de estado ----
71tiles = ""
72for s in STATE_ORDER:
73    v = totals.get(s, 0)
74    tiles += f'''<div class="tile s-{s}">
75      <div class="tile-n">{v}</div>
76      <div class="tile-l">{E(STATE_ES[s])}</div>
77      <div class="tile-p">{pct(v)}</div>
78    </div>'''
79
80# ---- grid por clase ----
81cls_cards = ""
82for c in sorted(classes, key=lambda c: -sum(classes[c].values())):
83    cc = classes[c]; tot = sum(cc.values())
84    bar = ""
85    for s in STATE_ORDER:
86        if cc[s]:
87            bar += f'<span class="seg s-{s}" style="width:{100*cc[s]/tot}%"></span>'
88    deuda = cc["debt"] + cc["never"] + cc["unhashable"]
89    cls_cards += f'''<div class="cls">
90      <div class="cls-head"><span class="cls-name">{E(CLASS_ES.get(c, c))}</span>
91        <span class="cls-tot">{tot}</span></div>
92      <div class="bar">{bar}</div>
93      <div class="cls-foot"><span class="ok">{cc['sealed']} al día</span>
94        <span class="{'warn' if deuda else 'muted'}">{deuda} en deuda</span></div>
95    </div>'''
96
97# ---- filas de deuda (agrupadas visualmente por "listas" vs "bloqueadas") ----
98def debt_row(n):
99    r = nodes[n]; b = blockers(n); u = unblocks(n)
100    deps = r.get("deps", [])
101    chips = "".join(chip(d) for d in deps) if deps else '<span class="chip empty">sin deps de build</span>'
102    if not b:
103        impact = f' <span class="impact" title="desbloquea {u} recetas en deuda">↑{u}</span>' if u else ""
104        badge = f'<span class="ready">lista</span>{impact}'
105    else:
106        badge = f'<span class="blocked">espera {len(b)}</span>'
107    ver = f'<span class="ver">{E(str(r.get("version") or ""))}</span>' if r.get("version") else ""
108    return f'''<tr class="drow" data-cls="{r['cls']}" data-ready="{'1' if not b else '0'}" data-name="{E(n)}" data-unblocks="{u}">
109      <td class="c-name"><span class="s-dot s-{r['state']}"></span>{E(n)} {ver}</td>
110      <td class="c-cls"><span class="tag t-{r['cls']}">{E(CLASS_ES.get(r['cls'], r['cls']))}</span></td>
111      <td class="c-badge">{badge}</td>
112      <td class="c-deps">{chips}</td>
113    </tr>'''
114
115rows = "".join(debt_row(n) for n in debt_sorted)
116gen_time = datetime.now(timezone.utc).strftime("%Y-%m-%d %H:%M UTC")
117topo = "cierra sin ciclos" if doc.get("topo_ok") else "⚠ CICLO detectado"
118orphan_note = ("grafo cerrado" if not doc.get("orphan_deps")
119               else f"⚠ {len(doc['orphan_deps'])} deps huérfanas")
120
121CSS = """
122:root{
123  --bg:#eef0f3; --panel:#ffffff; --panel-2:#f6f7f9; --ink:#1b1e24; --ink-2:#5b636f;
124  --line:#dce0e6; --steel:#4a7291; --ember:#dd6b3d;
125  --sealed:#3f8f61; --debt:#bf922f; --never:#8f6234; --unhashable:#bb443c;
126  --sealed-bg:#e7f1eb; --debt-bg:#f6efdc; --never-bg:#efe6da; --unhashable-bg:#f4e2e0;
127}
128@media (prefers-color-scheme:dark){:root{
129  --bg:#12151a; --panel:#1a1e25; --panel-2:#20252e; --ink:#e7eaef; --ink-2:#98a1af;
130  --line:#2a303a; --steel:#7aa6c8; --ember:#e97d4f;
131  --sealed:#59b483; --debt:#d8b054; --never:#b98a54; --unhashable:#d76258;
132  --sealed-bg:#182a20; --debt-bg:#2a2617; --never-bg:#271f16; --unhashable-bg:#2c1a19;
133}}
134:root[data-theme="light"]{
135  --bg:#eef0f3; --panel:#ffffff; --panel-2:#f6f7f9; --ink:#1b1e24; --ink-2:#5b636f;
136  --line:#dce0e6; --steel:#4a7291; --ember:#dd6b3d;
137  --sealed:#3f8f61; --debt:#bf922f; --never:#8f6234; --unhashable:#bb443c;
138  --sealed-bg:#e7f1eb; --debt-bg:#f6efdc; --never-bg:#efe6da; --unhashable-bg:#f4e2e0;
139}
140:root[data-theme="dark"]{
141  --bg:#12151a; --panel:#1a1e25; --panel-2:#20252e; --ink:#e7eaef; --ink-2:#98a1af;
142  --line:#2a303a; --steel:#7aa6c8; --ember:#e97d4f;
143  --sealed:#59b483; --debt:#d8b054; --never:#b98a54; --unhashable:#d76258;
144  --sealed-bg:#182a20; --debt-bg:#2a2617; --never-bg:#271f16; --unhashable-bg:#2c1a19;
145}
146*{box-sizing:border-box}
147body{margin:0;background:var(--bg);color:var(--ink);
148  font-family:system-ui,-apple-system,"Segoe UI",Roboto,sans-serif;line-height:1.5;
149  -webkit-font-smoothing:antialiased}
150.mono{font-family:ui-monospace,"SF Mono","JetBrains Mono","Cascadia Code",Menlo,monospace}
151.wrap{max-width:1180px;margin:0 auto;padding:clamp(20px,4vw,48px)}
152header{display:flex;flex-wrap:wrap;align-items:baseline;gap:12px 20px;margin-bottom:28px}
153h1{font-size:clamp(1.5rem,3vw,2.1rem);margin:0;font-weight:680;letter-spacing:-.02em}
154h1 .mark{color:var(--ember)}
155.sub{color:var(--ink-2);font-size:.9rem}
156.sub .mono{color:var(--ink)}
157.eyebrow{text-transform:uppercase;letter-spacing:.12em;font-size:.7rem;font-weight:650;
158  color:var(--ink-2);margin:0 0 10px}
159section{margin-bottom:34px}
160/* progress */
161.progress{height:34px;display:flex;border-radius:8px;overflow:hidden;border:1px solid var(--line);
162  background:var(--panel)}
163.seg{display:block;height:100%}
164.s-sealed{background:var(--sealed)} .s-debt{background:var(--debt)}
165.s-never{background:var(--never)} .s-unhashable{background:var(--unhashable)}
166.legend{display:flex;flex-wrap:wrap;gap:16px;margin-top:12px;font-size:.82rem;color:var(--ink-2)}
167.legend b{color:var(--ink);font-weight:600}
168.legend .k{display:inline-block;width:10px;height:10px;border-radius:3px;margin-right:6px;
169  vertical-align:baseline}
170/* tiles */
171.tiles{display:grid;grid-template-columns:repeat(4,1fr);gap:14px}
172@media(max-width:640px){.tiles{grid-template-columns:repeat(2,1fr)}}
173.tile{background:var(--panel);border:1px solid var(--line);border-radius:10px;padding:16px 18px;
174  border-top:3px solid var(--line)}
175.tile.s-sealed{border-top-color:var(--sealed)} .tile.s-debt{border-top-color:var(--debt)}
176.tile.s-never{border-top-color:var(--never)} .tile.s-unhashable{border-top-color:var(--unhashable)}
177.tile-n{font-size:2rem;font-weight:680;font-family:ui-monospace,monospace;line-height:1;
178  font-variant-numeric:tabular-nums}
179.tile-l{font-size:.82rem;color:var(--ink-2);margin-top:6px}
180.tile-p{font-size:.78rem;color:var(--ink-2);margin-top:2px;font-family:ui-monospace,monospace}
181/* class grid */
182.cls-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(200px,1fr));gap:14px}
183.cls{background:var(--panel);border:1px solid var(--line);border-radius:10px;padding:15px 16px}
184.cls-head{display:flex;justify-content:space-between;align-items:baseline;margin-bottom:10px}
185.cls-name{font-weight:620} .cls-tot{font-family:ui-monospace,monospace;color:var(--ink-2);
186  font-variant-numeric:tabular-nums}
187.bar{height:9px;display:flex;border-radius:5px;overflow:hidden;background:var(--panel-2)}
188.cls-foot{display:flex;justify-content:space-between;margin-top:9px;font-size:.78rem}
189.cls-foot .ok{color:var(--sealed)} .cls-foot .warn{color:var(--debt)}
190.cls-foot .muted{color:var(--ink-2)}
191/* debt table */
192.controls{display:flex;flex-wrap:wrap;gap:10px;align-items:center;margin-bottom:14px}
193.controls input{background:var(--panel);border:1px solid var(--line);color:var(--ink);
194  padding:8px 12px;border-radius:8px;font-size:.9rem;min-width:200px;font-family:ui-monospace,monospace}
195.controls input:focus{outline:2px solid var(--steel);outline-offset:1px}
196.fbtn{background:var(--panel);border:1px solid var(--line);color:var(--ink-2);padding:7px 13px;
197  border-radius:999px;font-size:.8rem;cursor:pointer;font-weight:550}
198.fbtn[aria-pressed="true"]{background:var(--steel);border-color:var(--steel);color:#fff}
199.tbl-wrap{overflow-x:auto;border:1px solid var(--line);border-radius:10px;background:var(--panel)}
200table{border-collapse:collapse;width:100%;font-size:.88rem}
201th{text-align:left;font-size:.7rem;text-transform:uppercase;letter-spacing:.08em;color:var(--ink-2);
202  font-weight:600;padding:11px 14px;border-bottom:1px solid var(--line);background:var(--panel-2);
203  position:sticky;top:0}
204td{padding:10px 14px;border-bottom:1px solid var(--line);vertical-align:top}
205.drow:last-child td{border-bottom:none}
206.c-name{font-family:ui-monospace,monospace;font-weight:550;white-space:nowrap}
207.c-name .ver{color:var(--ink-2);font-weight:400;font-size:.82em;margin-left:5px}
208.s-dot{display:inline-block;width:8px;height:8px;border-radius:50%;margin-right:8px;
209  vertical-align:middle}
210.tag{font-size:.72rem;padding:2px 8px;border-radius:999px;font-weight:600;white-space:nowrap}
211.t-c{background:var(--panel-2);color:var(--ink-2)} .t-go{background:#1f3a4d33;color:var(--steel)}
212.t-rust{background:#dd6b3d22;color:var(--ember)} .t-gui{background:#8f623422;color:var(--never)}
213.t-kernel{background:#bb443c22;color:var(--unhashable)}
214.ready{color:var(--sealed);font-weight:600;font-size:.8rem}
215.impact{display:inline-block;background:var(--ember);color:#fff;font-family:ui-monospace,monospace;
216  font-size:.72rem;font-weight:650;padding:1px 6px;border-radius:999px;margin-left:4px}
217.blocked{color:var(--debt);font-weight:600;font-size:.8rem;font-family:ui-monospace,monospace}
218.c-deps{max-width:560px}
219.chip{display:inline-block;font-family:ui-monospace,monospace;font-size:.74rem;padding:2px 7px;
220  border-radius:5px;margin:2px 3px 2px 0;border:1px solid transparent}
221.chip.s-sealed{background:var(--sealed-bg);color:var(--sealed)}
222.chip.s-debt{background:var(--debt-bg);color:var(--debt);border-color:var(--debt)}
223.chip.s-never{background:var(--never-bg);color:var(--never);border-color:var(--never)}
224.chip.s-unhashable{background:var(--unhashable-bg);color:var(--unhashable);border-color:var(--unhashable)}
225.chip.empty{color:var(--ink-2);font-style:italic}
226.hint{color:var(--ink-2);font-size:.82rem;margin:0 0 14px}
227.count{color:var(--ink-2);font-size:.82rem;margin-left:auto;font-family:ui-monospace,monospace}
228footer{color:var(--ink-2);font-size:.78rem;margin-top:36px;padding-top:16px;
229  border-top:1px solid var(--line);line-height:1.7}
230footer .mono{color:var(--ink)}
231@media(prefers-reduced-motion:no-preference){.seg,.fbtn{transition:.15s}}
232"""
233
234JS = """
235const rows=[...document.querySelectorAll('.drow')];
236const q=document.getElementById('q');
237let cls='all',onlyReady=false;
238function apply(){
239  const t=(q.value||'').toLowerCase();let shown=0;
240  for(const r of rows){
241    const okC=cls==='all'||r.dataset.cls===cls;
242    const okR=!onlyReady||r.dataset.ready==='1';
243    const okT=!t||r.dataset.name.includes(t);
244    const v=okC&&okR&&okT;r.style.display=v?'':'none';if(v)shown++;
245  }
246  document.getElementById('count').textContent=shown+' en deuda';
247}
248document.querySelectorAll('.fbtn[data-cls]').forEach(b=>b.onclick=()=>{
249  document.querySelectorAll('.fbtn[data-cls]').forEach(x=>x.setAttribute('aria-pressed','false'));
250  b.setAttribute('aria-pressed','true');cls=b.dataset.cls;apply();});
251const rb=document.getElementById('ready');
252rb.onclick=()=>{onlyReady=!onlyReady;rb.setAttribute('aria-pressed',onlyReady);apply();};
253q.oninput=apply;
254"""
255
256cls_btns = '<button class="fbtn" data-cls="all" aria-pressed="true">todas</button>'
257for c in sorted(classes, key=lambda c: -sum(classes[c].values())):
258    deuda = classes[c]["debt"] + classes[c]["never"] + classes[c]["unhashable"]
259    if deuda:
260        cls_btns += f'<button class="fbtn" data-cls="{c}" aria-pressed="false">{E(CLASS_ES.get(c,c))} ({deuda})</button>'
261
262scope = "frente KDE" if KDE else "hammer"
263by_queue = doc.get("by_queue", {})
264queue_line = ""
265if "incoming-kde" in by_queue and len(by_queue) > 1:
266    kq = by_queue["incoming-kde"]; kd = kq.get("debt", 0) + kq.get("never", 0)
267    queue_line = (f' · <b>cola KDE {kq.get("sealed",0)}/{sum(kq.values())} selladas</b>, '
268                  f'{kd} en deuda')
269
270HTML = f'''<style>{CSS}</style>
271<div class="wrap">
272  <header>
273    <h1>estado del build <span class="mark">·</span> <span class="mono">{E(scope)}</span></h1>
274    <div class="sub">{n_total} recetas{queue_line} · grafo {E(topo)} · {E(orphan_note)} · <span class="mono">{E(gen_time)}</span></div>
275  </header>
276
277  <section>
278    <p class="eyebrow">avance del corpus</p>
279    <div class="progress">{seg}</div>
280    <div class="legend">
281      <span><span class="k s-sealed"></span><b>{totals.get('sealed',0)}</b> sellado al día</span>
282      <span><span class="k s-debt"></span><b>{totals.get('debt',0)}</b> deuda de rebuild</span>
283      <span><span class="k s-never"></span><b>{totals.get('never',0)}</b> nunca construida</span>
284      {'<span><span class="k s-unhashable"></span><b>'+str(totals.get('unhashable',0))+'</b> ilegible</span>' if totals.get('unhashable') else ''}
285    </div>
286  </section>
287
288  <section>
289    <div class="tiles">{tiles}</div>
290  </section>
291
292  <section>
293    <p class="eyebrow">dónde está la deuda</p>
294    <div class="cls-grid">{cls_cards}</div>
295  </section>
296
297  <section>
298    <p class="eyebrow">huecos, en orden de ataque</p>
299    <p class="hint">Cada receta en deuda con sus deps de build coloreadas por estado. Una fila
300      <b style="color:var(--sealed)">lista</b> tiene todas sus deps al día ⇒ se puede construir ya;
301      el pastilla <span class="impact">↑N</span> es cuántas otras en deuda desbloquea (ordenadas por
302      ahí: construí primero las de más impacto). Una <b style="color:var(--debt)">espera N</b> depende
303      de N recetas que también están en deuda. {len(ready)} listas ahora.</p>
304    <div class="controls">
305      {cls_btns}
306      <button class="fbtn" id="ready" data-ready aria-pressed="false">sólo listas</button>
307      <input id="q" placeholder="buscar receta…" spellcheck="false" aria-label="buscar receta">
308      <span class="count" id="count">{len(debt_sorted)} en deuda</span>
309    </div>
310    <div class="tbl-wrap">
311      <table>
312        <thead><tr><th>receta</th><th>clase</th><th>estado</th><th>deps de build</th></tr></thead>
313        <tbody>{rows}</tbody>
314      </table>
315    </div>
316  </section>
317
318  <footer>
319    Derivado de <span class="mono">recipes/*.toml</span> + <span class="mono">hammer hash</span> + el store,
320    por <span class="mono">scripts/build-state.py</span>. La fuente firme es
321    <span class="mono">docs/state/build-state.json</span> (versionada: su <span class="mono">git diff</span> es el avance).
322    Regenerar: <span class="mono">scripts/build-state.py && scripts/build-state-view.py</span>.
323  </footer>
324</div>
325<script>{JS}</script>
326'''
327
328OUT.write_text(HTML)
329print(f"→ {OUT.relative_to(ROOT)} ({len(HTML)//1024} KB) · {len(debt_sorted)} en deuda, {len(ready)} listas")