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