ADR 0099 — El lint se mide al analizar

Estado: aceptado · Fecha: 2026-10-31

Contexto

El ADR 0094 descartó ejecutar ESLint dentro de analyze para no atar un análisis determinista y barato a node_modules y a media docena de configuraciones. El lint quedó como una pasada aparte —codarch lint— y serve la lanzaba por su cuenta, con su cola y su evento.

El resultado se vio al usar la lente: la deuda de lint no era una lente del análisis, era un fichero que a veces estaba. Abrir un cc.json no traía lint; codarch analyze tampoco lo medía, así que el mapa solo podía pintarse por lint si alguien había corrido codarch lint o había un serve detrás. Y el artefacto podía ser de otro árbol, lo que obligó al ADR 0098 a firmarlo y avisar. Todo eso era síntoma de lo mismo: el lint medía fuera de la pasada que dibuja el mapa.

La lente tampoco se leía: con el repo limpio, la escala arrancaba en el color del papel y todos los bloques se fundían con el fondo. Y el bloque del lint de Métricas había ganado un botón «Pintar el mapa» que no era el sitio: las lentes se eligen en COLOR, como todas.

Decisión

1. El lint se mide en el análisis

codarch analyze ejecuta el lint que tiene el proyecto —su configuración y su binario, ADR 0096— y escribe .codarch/lint.cc.json en la misma pasada, con meta.tree igual al checksum del snapshot que acaba de escribir. --no-lint lo omite para quien solo quiere el mapa y no puede esperar a un linter.

Esto enmienda el ADR 0094 en su descarte: la objeción era el coste, y el coste se asume —once segundos en un repo de quinientos ficheros— a cambio de que el lint sea del análisis y no de la sesión. El artefacto sigue fuera de cc.json y de su checksum: el checksum depende del código, no de lo que tenga instalado la máquina, y cc.json sigue siendo interoperable.

2. El que ya es del árbol no se vuelve a medir

serve y el live comparan el meta.tree del artefacto guardado con el checksum que están sirviendo: si coincide, no lanzan el linter. Analizar y servir el mismo árbol cuesta una pasada, no dos. Si no coincide —o el artefacto es 1.1, sin árbol— se mide en segundo plano y se avisa al abrir la app.

3. La lente es una lente

• Se ofrece en COLOR, como Riesgo, Estructura o cualquier métrica, y solo cuando hay lint medido.
• Tiene su escala propia: el extremo limpio es un verde apagado, no el papel. Un repo sin hallazgos se ve como un mapa pintado de limpio, no como un mapa sin pintar.
• La leyenda, la hoja y el PNG de codarch shot leen la misma escala y la misma cuenta.
• No tiene botón en la hoja del proyecto: el control es el selector de color de siempre.

Consecuencias

• Un codarch analyze en un repo con ESLint tarda lo que tarda ESLint; --no-lint devuelve la pasada barata.
• El lint existe después de analizar, con cualquier consumidor: CLI, web servida, escritorio y MCP leen el mismo artefacto; un cc.json compartido sin su .codarch/ no lo lleva, y la app lo dice.
• La lente del lint no puede «no estar cargada» en el mapa que la ofrece: si el artefacto falta, la opción no se ofrece y la banda lo dice.
• Ya no hay dos caminos para medir: uno, el del análisis. La cola del live solo existe para no perder un guardado durante una pasada.

Hoja de ruta

Fases M65 — El lint, en el mapa y M67 — El lint es del proyecto.

• ✅ codarch analyze mide el lint del proyecto y lo firma con el árbol (con --no-lint).
• ✅ serve y el live no remiden un artefacto que ya es del árbol servido.
• ✅ La lente del lint en COLOR, con su escala propia, su leyenda y el PNG.
• ✅ Sin botón propio en la hoja: las lentes se eligen en COLOR.
• ✅ El punto del lint en la barra (ADR 0094).
• ⬜ El lint incremental del live: medir solo lo que cambió.

El registro de lo hecho vive en el feed de la guía.