Expediente 2/8: la nota que apagó la alarma

🕵️ Mostrar expediente completo → 📋 Protocolo de sesión →

Expediente · Depto. de Homicidios de Código

Un arreglo de CSS correcto dejó escrita, en su propio comentario, una frase que declaraba segura la forma que nadie había renderizado: «so every fenced block with a language was fine». Siete horas y media más tarde el siguiente autor —otro agente— la leyó, la creyó, y diagnosticó el fallo razonando sobre dos hojas de estilo que la página ni siquiera carga. Cero consultas al navegador. La única que hacía falta habría dado la respuesta entera. Lo detectó el operador, adjuntando la captura de un bloque de código ilegible.

El doble balance — lo que costó, y lo que dejó

Los sospechosos — las pistas falsas

El arma — El arma · una frase que ningún check respalda

/* custom.css — comentario del arreglo anterior, commit 3294761, 04:07:40 */

   It only bites the BARE <pre>. `pre code` already reads `--code-text`,
   which does flip, so every fenced block with a language was fine
                          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

# Ningún check respalda esa frase. Ninguna página con un fence etiquetado
# se renderizó para escribirla. A las 11:42 el operador adjuntó la captura
# de un fence ```nu ilegible: la forma declarada segura.

El arreglo anterior fue bueno. Corrigió un <pre> pelado que en modo claro salía casi blanco sobre casi blanco, y lo documentó con el detalle que esta serie exige. Después escribió una frase más:

It only bites the BARE <pre>. pre code already reads --code-text, which does flip, so every fenced block with a language was fine

Ningún check respalda esa última línea. Ninguna página con un fence etiquetado se renderizó para escribirla. Es una afirmación sobre una forma que el autor no miró, colocada justo donde el siguiente lector la va a leer antes que la regla.

A las 11:42 el operador adjuntó una captura: un fence ```nu gris lavado, ilegible. La forma declarada segura.

Y lo que hace el caso es lo que pasó después. El siguiente autor no ignoró la nota: la usó. Buscó la causa donde la nota decía que no estaba —en la paleta de tokens— escribió un arreglo para eso, y lo declaró resuelto sin medir nada. Cuando el operador preguntó «¿por qué las correcciones css no se ven?», el diagnóstico llevaba construido sobre app.min.css y site.min.css: dos ficheros que contienen exactamente las reglas que explicaban el síntoma, y que esta página no carga. Ocho hojas enlazadas, ninguna de las dos entre ellas.

Una consulta a getComputedStyle devolvía la respuesta entera. Se hicieron cero.

Y hay una vuelta de tuerca que sale del propio git show. El commit 3294761 toca dos ficheros: custom.css (+91) y gen-expediente.nu (+56). En el segundo, su autor escribió que la primera reparación de este mismo fallo «resolvía contra una hoja que este sitio ni siquiera carga» — el hecho exacto que siete horas después nadie usó. El conocimiento existía, en el mismo commit, en el fichero de al lado. Lo que no existía era su co-locación con la afirmación que lo desmentía.

El giro — El arreglo · una consulta al DOM, y la cascada que de verdad ganó

// una consulta, y la respuesta entera:
[...document.querySelectorAll('.post-content-body pre')].map(pre => {
  const code = pre.querySelector('code');
  return { lang: code.className, ink: getComputedStyle(code).color };
});

// language-nu               #e5e7eb   ← sin clase .hljs, nada lo pisa
// language- hljs sql        #334155   ← hljs lo rescató con !important
// language-nickel           #e5e7eb
//
// Dos bloques, una página, resultados opuestos.
// La diferencia nunca fue el tema: era si existía el módulo del lenguaje.

Medido en el navegador, en modo claro, antes de tocar nada:

AA exige 4.5:1. Los bloques 0 y 2 no tienen clase .hljs porque el bundle de hljs no trae módulo para nu ni para nickel: highlightElement se rinde y no marca nada. El bloque 1 sí se marcó, y entonces .hljs { color: … !important } lo rescató.

Y la regla que ganaba en los dos casos perdidos estaba en website.css, anidada:

:is([prose=""]) :where(pre):not(…) { color: var(--un-prose-pre-code) }   (0,1,0)
:where(pre code):not(…)            { color: inherit }

Contra eso, pre { color: var(--code-text) } es (0,0,1). Pierde. El arreglo anterior nunca ganó ese desempate — ni para los posts ni para los expedientes.

Entonces, ¿qué arregló los expedientes? Esto, en gen-expediente.nu:

.exp pre { color: var(--exp-ink) }        (0,1,1)  →  gana a prose (0,1,0)

La clase .exp que envuelve cada expediente sube la especificidad justo lo suficiente. Y está en el mismo commit 3294761 — 91 líneas en custom.css, 56 en gen-expediente.nu, un solo autor, una sola madrugada. Con un comentario que dice, palabra por palabra, que la primera reparación «resolvía contra una hoja que este sitio ni siquiera carga».

El conocimiento no faltaba. Estaba a cincuenta líneas, en otro fichero del mismo commit — y no junto a la afirmación que lo refutaba.

El arreglo real sube la especificidad a (0,1,2), en las dos formas —clase y atributo— porque el cuerpo del post lleva class="prose" y la regla de UnoCSS está escrita para [prose=""]. Dar por hecho cuál aplicaba es cómo se llegó a creer que el anterior funcionaba.

Después, otra vez medido: 3 de 3 bloques a #334155, 9.9:1 en claro y 11.87:1 en oscuro.

El veredicto

Tres constraints Hard ya dicen lo necesario — un mecanismo declara su extensión, un check puede decir «esto no lo miré», la página es la publicación — y ninguna alcanzó la frase que abrió este caso, porque gobiernan CHECKS y esto era un COMENTARIO. Un comentario es folklore con permisos de escritura: se versiona, se revisa, viaja con el fichero y se lee antes que la regla que explica, y nada comprueba que lo que afirma sea cierto. El patrón de la serie es «declarado dos veces»; aquí la segunda copia no es código, es la nota sobre el código, y cuando las dos discreparon ganó la prosa porque es la que se lee primero. La coartada de la nota casi se sostiene, y por eso este caso importa más que un error: su autor estaba siendo cuidadoso, y el defecto no fue descuido sino una afirmación de cobertura escrita sin la medición que la respaldaba. Peor aún, y es lo que el git show reveló al escribir este expediente: el mismo commit toca dos ficheros, y en el segundo su autor había dejado escrito el hecho exacto que refutaba la frase del primero. El conocimiento no faltaba — faltaba su co-locación. Una afirmación y su refutación pueden convivir en un commit sin que nada las enfrente, porque el diff las presenta como dos cambios y no como una contradicción. Lo que no se cierra aquí queda dicho abajo: sigue sin existir nada que rechace un arreglo cuya justificación afirma una cobertura que nunca se renderizó. Y mientras se escribía este expediente, en la misma sesión, una comprobación propia pasó en verde sin poder mirar: un patrón que no cruzaba un salto de línea. Cuatro veces en un día — el mismo defecto, con y sin nota.

La reconstrucción — la sesión, repetida con protocolo

Lo que se pidió — reconstruido de refs:sessions/2026-08-06-la-nota-que-apago-la-alarma — extracto acotado en custodia. La sesión contiene el incidente Y la escritura del caso; autorreferencia declarada. Se identificó por el TRABAJO que hizo (editó custom.css, ejecutó las consultas al DOM), nunca contando menciones.

css el tema de los tags <pre> se arregó para los expedientes en modo light pero en los post no lo está
[captura adjunta del post servido en claro]

Lo que había que pedir

css el tema de los tags <pre> se arregó para los expedientes en modo light pero en los post no lo está
[captura adjunta]

Antes de escribir una sola regla:

1. Mide el DOM, no leas hojas de estilo. Para cada <pre> de la página: clases del
   <code>, `getComputedStyle(...).color` calculado, y el contraste contra el fondo.
   Pega la salida. Una causa sin esa tabla es una hipótesis, no un diagnóstico.
2. Comprueba QUÉ HOJAS CARGA la página antes de razonar sobre su cascada. Una regla
   leída en un fichero que la página no enlaza es una regla que no existe.
3. Compara con el caso que SÍ funciona (un expediente) en el mismo turno: la diferencia
   entre los dos es el diagnóstico, y adivinarla sale más caro que medirla.
4. Después del arreglo, vuelve a medir los mismos números. Y no escribas en el comentario
   ninguna afirmación sobre una forma que no hayas renderizado.

La puerta antes de delegar: Un arreglo de presentación no se declara hasta que el número medido en el DOM está pegado, antes y después, en el tema reportado. Sin eso el agente entrega su razonamiento sobre la cascada, no la página — que es exactamente lo que ocurrió: dos hojas leídas, cero consultas, y la única que hacía falta habría dado la respuesta entera.

El disparador de ADR: Ninguno nuevo: ADR-072 ya declara que un mecanismo declara su extensión y que la página es la publicación. Lo que falta no es la decisión, es el gate — ver lesson_debt.

La jurisprudencia — qué exige hoy la lección

• ✓
  Un mecanismo declara qué abarca; el verde es una afirmación sobre su propia extensión, nunca sobre el mundoadr:072/a-mechanism-declares-its-extent
• ✓
  Lo que el lector recibe es la página: un fichero que valida y un gate en verde son afirmaciones sobre ficherosadr:072/the-page-is-the-publication
• ✓
  Un check puede —y debe— decir «esto no lo miré» en vez de pasar en silencioadr:072/a-check-can-say-i-did-not-look
• ✓
  Verifica la página, nunca el fichero; y si un check y un lector discrepan, sospecha primero del transporte del checkqa:expediente-howto
• ✓
  Toda cifra sale de un log o un artefacto; la que no se puede trazar se cae del recuento en vez de estimarsemode:generate-expediente/gather_metrics

⊘Deuda declarada: Nada rechaza hoy un arreglo de presentación cuya JUSTIFICACIÓN afirma una cobertura que nunca se renderizó. ADR-072 gobierna checks y mecanismos; un comentario de código no es ninguno de los dos, y por eso sus tres constraints Hard pasaron de largo por la frase que abrió este caso. Lo que lo saldaría: un gate que, ante un cambio en una hoja de estilo servida, exija en el mismo cambio el número medido en el DOM —antes y después, en los dos temas— y que rechace el commit sin él; medible con lo que ya existe (getComputedStyle y un cálculo de contraste), sin protocolo nuevo. Nombrado, no encogido de hombros, y NO sustituido por «revisar mejor los comentarios», que es una promesa de disciplina y es exactamente lo que falló: la frase la escribió alguien que estaba siendo cuidadoso.