svelte-kit-vice/docs/process/continue-cleanroom-fixes-2026-07.md

Plan de ataque — fixes de la auditoría clean-room (2026-07-10)

Handoff turnkey + plan aprobable. Creado: 2026-07-11. Rama alpha-0.1-sec-dom.

Fuente: la tabla §9 de docs/audit-new-10-july/audit-active-uix.md — leerla ENTERA antes de tocar nada. El programa anterior está COMPLETO (cierre en docs/audit/components/_cierre.md). Este plan cubre todas las IDs de la §9 (P1/P2/P3 + GAP-*); nada queda sin fase asignada — la tabla de cobertura del final es el checklist.

Reconciliación de estado (la clean-room es snapshot del 2026-07-10)

• SOM-5 (P1) ✅ CERRADO post-snapshot: field commit-submit al Enter (33f346ed) + float-panel kb-gestos por handle-events (bdd17f04).
• SOM-3 (P2) ◐: float-panel ya en uix.timers (bdd17f04); media-provider es PUERTO Svelte-agnóstico exento por diseño. Quedan ~6 setTimeout (image-provider, safe-polygon, dismissal, datetime/announcer, tags-input, announce/global).
• Badge R-4.3 (única violación R-4.x viva en su §5.3) ✅ cerrada en el censo R-1.x (ee9786bc). Su matriz (102/32/0) es previa: hoy 134/0/0.

Principios de secuencia

1. La máquina primero. Los fixes que amplían el enforcement (THM-1, MOR-4, guard de enumeración) van ANTES que el resto: destapan trabajo que las fases posteriores deben ver en el tablero.
2. Rojo = parar la línea. Una suite/guard en rojo (hoy: THM-3) se arregla antes de cualquier otra cosa de la sesión. Ninguna sesión cierra en rojo.
3. No-cascada: un fix → gates → el siguiente. Fix sistémico ⇒ guard que lo fije (doctrina del programa 2026-06-26).
4. Iniciativas ≠ fixes. THM-2, SEM-4, DOC-1/2 y los GAP-* requieren decisión de alcance del usuario ANTES de ejecutar — este plan las dimensiona y propone, no las arranca en frío.

---

F0 — La máquina, en verde y completa ✅ EJECUTADA 2026-07-11

Resultado: matriz 135/0/0 (card-group dentro) · contracts 38/38 (guard MOR-4 nuevo) · suite eidos 306/306 · baseline 57 · vocab exit 0. Verificación en navegador: shake commit-block vivo (block-shake, --duration-moderate, stamp commit · risk) + chevrons a --opacity-muted (0.65 computado). Extras que destapó la ejecución:

• El spectrum de color-picker había sido creado para evadir los escáneres (su header lo admitía; reescrito con doctrina honesta) y recipe-css-contract.test.ts tenía el MISMO agujero de enumeración — cerrado también (concatena hermanos; color-picker en FIXED_TONE_COMPONENTS); R-2.1 ahora caza hsl/hwb/lab/lch/oklab/oklch y escanea texto sin comentarios.
• commit-block promovido a firma global de EidosConfig.motion (block-shake + reduce) — completaba un peldaño ausente (el ladder tenía fulfill/affirm/threat): ahora TODO rechazo de ToggleGroup lleva la firma de denegación en vez del settle de éxito.
• Hallazgo sistémico (pre-existente, registrado abajo): las reglas de cascada de entrada ([data-stagger][data-state='open'] > [data-animation-style], (0,3,0)) retienen animation para SIEMPRE y sombrean cualquier firma de evento de igual/menor especificidad — el shake shipped de card-group YA estaba muerto en grupos con motion. Card-group lo resuelve re-afirmando a (0,4,0); el arreglo sistémico queda en cola.
• morfo/internal/ existe (picker-shell.ts vive ahí); el guard MOR-4 acepta ambas raíces. icon-button (alias puro de Button, 0 css) y svg (glifos) exentos con auto-vigilancia (si les aparece css, el guard exige morfo); spin-field queda como única capa sin contrato (F1). Gap real registrado en el dossier de card-group: disabled no llega al Collapsible (la tabla de props promete selection+toggle).

Ítem	Qué	Tamaño
THM-3 P2	Voltear el canario vencido: toggle ya lee 0 class-hooks → lint.test.ts:110 a toBe(0). Suite eidos 305/306 → 306/306.	S
THM-1 P1	Extender component-audit.ts:698,756 a todos los *.css del directorio del componente (hoy solo {kebab}.css). Pagar lo que destape: hsl() ×8 en spectrum (anotar /* literal: physically-fixed */), opacity: 0.6 (calendar-select.css:27), fallback mágico var(--calendar-month-gap, 36px). Mismo espíritu que la válvula R-2.1: máquina primero, luego los fixes, no-cascada.	M
MOR-4 P1	Morfo para card-group (doctrina morfo-first, scope:['eidos'] si procede): leer CSS+wrapper existentes para derivar parts/attrs, recordar la decisión de cardinalidad 2026-06-27 (ToggleGroup OWNS cardinality) en el docblock. Entra en la matriz (→135) con dossier F-1.x y R-* limpias (incluida su opacidad literal, TOK-3).	M
Guard de enumeración (contramedida)	La matriz enumera por MORFO_DIR — un dir de eidos sin morfo es invisible (así se escondió card-group). Guard nuevo: eidos/components/* ↔ morfos, con exenciones explícitas (picker-shell, spin-field = capas compartidas).	S

Salida de F0: matriz 135/0/0 · contracts 38/38 · suite eidos 306/306.

F1 — Coherencia P1: foco y voz (≈1 sesión)

Ítem	Qué	Tamaño
EID-1 P1	Anillo de foco de la fundación (archetypes.css:162-167) en box-shadow vs §32 que canoniza outline. Propuesta: retirar el condicionante (el outline: none global de web/routes/layout.css — inversión de dependencia app→fundación), migrar el anillo a outline con --focus-ring-*, conservar la vía forced-colors. Verificación visual obligatoria (focus visible en varios componentes, light/dark; 57/130 recetas caen a este anillo). Alternativa (si el usuario prefiere): anotar la excepción en §32. DECISIÓN #2.	M
EID-2 P2	Misma pasada, mismo fichero: opacity: 0.5/0.85 literales en la fundación → var(--opacity-disabled) / token o anotación.	S
Fundación bajo R-* (contramedida)	La fundación violaba su propia disciplina porque nadie la escanea. Añadir archetypes.css + capas compartidas sin morfo (picker-shell/*.css, spin-field.css) al alcance del escáner R-2.x/R-4.x o test dedicado. Nota THM-1 (2026-07-11): recipe-css-contract.test.ts ya cubre esas capas para color/typo/phantoms (enumera por directorio y ahora concatena hermanos); lo que falta aquí es la vía component-audit (enumera por morfo).	S
SEM-1 P1	Unificar la prioridad de live-region: runtime (family==='signal' ∧ intent∈{threat,loss} → assertive, runtime.svelte.ts:725) vs AnnounceChannel (solo intent, announce.ts:55). Propuesta: canónica = intent (lo que sugiere el libro); alinear el runtime + test que fije la política. DECISIÓN #1.	S–M
AUX-1 P3	Mismo territorio: párrafo de doctrina que ordene los TRES mecanismos de live-region (uix.announce zwsp-toggle · fallback del canal · <Announce> soma) — quién es para qué capa.	S

F2 — Lote mecánico P2/P3 (≈1 sesión, sin decisiones de usuario)

Batch de fixes pequeños, cada uno con su test donde aplique; gates al final:

• DEP-2 P2 — eliminar ogl de package.json (0 imports; doctrina zero-dependence en su forma más barata).
• DEP-1 P2 — clsx fantasma (soma/props/props.ts:1): inlinear implementación propia mínima (doctrina zero-dependence) y cerrar el "pending decision" de architecture/soma.md §12.
• MOR-1 P2 — semaSelector: escape propio de valores (isomorfo, sin CSS.escape del DOM) + validación de nombres de attr en matchers string (selectors.ts:141-155); tests con " y ].
• MOR-2 P3 — des-duplicar la convención de marker (selectors.ts:121 re-implementa lo que el compilador ya posee): exportarla de un solo sitio.
• MOR-3 P3 — _resetCompileCache() no-op: implementar (WeakMap reasignable) o eliminar según uso real.
• SOM-1 P2 — await handler() vs contrato "handler síncrono": censo de handlers async registrados; si 0 → quitar el await (contrato cumplido, timing más limpio incluso para síncronos); si hay async → DECISIÓN #3.
• SOM-2 P2 — keydown corta en el primer match sin handler (runtime.svelte.ts:562): continue en vez de return false + test con dos planes de la misma tecla.
• SEM-2 P2 — política de errores: logging por defecto (dev) en fallos de canales sin logger inyectado; el camino void trigger(...) no puede producir unhandled rejection en producción (catch+log en la vía void, throw intacto para llamadores que awaitean).
• SEM-3 P3 — motor: fallback muerto de applyDominance (engine.ts:518)
  • cancelar el timer tope de awaitExpression cuando finished gana (callback fantasma ≤1500 ms).
• SEC-1 P2 — endurecer el serializador de renderCssVariables: rechazar ;/} embebidos en valores + test.
• THM-7 P2 — ejemplo de sema.md §packs con selector manual → reescribir con semaSelector (el código real ya está limpio).
• THM-6 P3 — var(--radius-full, 1px) en menu-dial.css:293 → 9999px.
• EID-4 P3 — comentarios "31-scale" → 33 (active-eidos.svelte.ts:653, arts/color/README.md:65).

F3 — Censos con guard (≈2 sesiones; SOM-4 puede parir lotes)

Ítem	Qué	Tamaño
SOM-3 P2 ◐	Migrar los ~6 setTimeout restantes a uix.timers.schedule (key+meta, patrón float-panel) y retirar sus exenciones del guard de contracts.	S–M
THM-5 P2	Doctrina para los 17 !important: anotación en línea (/* important: <razón> */) + regla de máquina R-* nueva que marque los no anotados. color-picker (4) y group (8) ya tienen razón — anotarla; drawer/float-panel/tabs/select: revisar (fix o anotar).	S–M
SOM-4 P2	Censo de providers que re-declaran role/aria-* en props getters en vez de renderProps() ("most existing providers", guía §Part props). Entregable: tabla censo + guard (WARN) + migración de los mecánicos; si el volumen es grande → plan por lotes tipo S4 con sizing para aprobación.	M (censo)
THM-4 P2	Doctrina para los 1150 selectores de contrato sin consumidor CSS: criterio en eidos.md (attr de comportamiento puro = legítimo y declarado; resto = consumir o podar del contrato) + quemar hotspots (media-player 47 · stepper 30 · color-picker 29 · avatar 28 · trp 26; words 149 excluido).	M

F4 — Iniciativas con decisión de usuario (cada una, su sesión)

F4-A · THM-2 P1 — paleta 33 por instancia (2/17 superficies)

Es un ROLLOUT, no un fix. Triple acción de la clean-room + sizing previo:

1. Medir el delta de CSS generado por superficie (33 escalas × 15 componentes en generated/base.css — el peso decide el alcance).
2. DECISIÓN #4: rollout completo (15), subconjunto razonado, o re-redactar la promesa de demo-authoring §6 ("acepta las 33") al estado real. Mecanismo real: universalPaletteDecls (render-css.ts:1766) — el doc cita un helper inexistente (paletteScaleDecls): corregirlo.
3. Tracker con hogar: el registro de rollout borrado renace en docs/theming/ (contramedida: borrar un tracker exige puntero sucesor).

F4-B · SEM-4 P2 — firma perceptiva declarada y no emitida

Deuda "sin urgencia" desde 2026-05/06 — ponerle fecha (DECISIÓN #5):

• close polimórfico inerte (5 pickers togglean open sin disparar el evento): cablear runtime.trigger('close-*') con el patrón dialog/popover — el intent per-evento ya está declarado.
• packs dormant (6 morfos menú/árbol sin emitir): cablear triggers en providers (D.6).
• flag emission (D.2) en el morfo para que esto sea auditable por la máquina (cumple la regla 2-de-3: sema + auditoría).

F4-C · Corpus documental (DOC-1/2 P1 · DOC-3/4 P2 · DOC-5/6, EID-3, AUX-2 P3)

1. DOC-1 — migrar el contenido canonizado FUERA de audit/deprecated: registro de intent-assignment (CANON §3 ← _veredictos.md) y build-contract (component-guide ← ARCHETYPE_COHERENCE §13) a E1/E2; los audits quedan como historia. DECISIÓN #6 (hogares exactos).
2. DOC-2 — ancla editorial: existe edición FINAL sin trackear (docs/Disenando_lo_que_ocurre_FINAL.{pdf,docx}, 426 págs.) y los punteros apuntan a ficheros inexistentes (README.md:138 · CANON.md:295). DECISIÓN #7: ¿commitear los binarios (hoy excluidos por norma) o punteros a edición externa? Reconciliar en cualquier caso.
3. Barrido editorial (una sesión): DOC-3 enlaces muertos ×15 · DOC-4 secciones stale (cadena de hold sin SEMA_MAP.families[*].hold, event:* obsoleto en notes.md, gradient omitido en reference §10 + channels §5, paletteScaleDecls) · DOC-5 recuentos fósiles (95/62/25/66/31 → reales) · DOC-6 menudencias (§4.11 duplicado, TODO(reconcile) huérfanos, stub TSC, enlace air-old) · EID-3 párrafo de excepción de placement físico en el mandato logical-RTL · AUX-2 documentar disabledDom mixto en la tabla de contratos.
4. Contramedida: tras limpiar, docs:check enlaces muertos WARN→error (que nunca vuelva a tolerarse ×15).

F4-D · GAP-* — menú de personalización (§7; el usuario elige)

Iniciativa	Contenido	Tamaño
Selection/caret/cursor	La fundación no emite ::selection, caret-color ni tokens de cursor (cableados por arquetipo) — los 3 huecos sistémicos visibles.	M
Scrollbar global	scrollbar-color/webkit sistémico fuera de scroll-area.	S–M
Layer 4	--{c}-{role}-{slot} sin consumidores; la FAQ la marca candidata a colapso "si en 6 meses nadie la usa" → decidir: consumir o colapsar.	decisión
Jaulas abiertas	scrim sin regla consumidora · --depth-{plane}-z 0 consumidores · container queries 0 consumidores — fecha de consume-o-poda para que no fosilicen.	decisión
Assets variables	Motor de fuentes variables listo, assets aún TTF estáticos (rfc-typography §5).	M
Límites a registrar (sin código)	Sonido por tema = app/dev (D.7) · icon-set no temable · touch-target constante (§37) · ThemeDefinition sin recipes (§19). Registrarlos como decisiones en el gap-log y cerrar.	S

---

Tabla de cobertura (toda ID de §9 → fase)

Fase	IDs
✅ hecho	SOM-5 (33f346ed+bdd17f04) · badge R-4.3 (ee9786bc)
F0	THM-3 · THM-1 · MOR-4 (+guard enumeración)
F1	EID-1 · EID-2 (+fundación bajo R-*) · SEM-1 · AUX-1
F2	DEP-1 · DEP-2 · MOR-1 · MOR-2 · MOR-3 · SOM-1 · SOM-2 · SEM-2 · SEM-3 · SEC-1 · THM-7 · THM-6 · EID-4
F3	SOM-3◐ · SOM-4 · THM-5 · THM-4
F4-A	THM-2
F4-B	SEM-4
F4-C	DOC-1 · DOC-2 · DOC-3 · DOC-4 · DOC-5 · DOC-6 · EID-3 · AUX-2
F4-D	GAP-* (§7)

Decisiones que solo puede tomar el usuario

1. SEM-1: política canónica de assertive — propuesta: intent ∈ {threat, loss} (el libro), alineando el runtime.
2. EID-1: migrar fundación a outline + retirar el reset del app (propuesta) — o anotar excepción en §32.
3. SOM-1: solo si el censo encuentra handlers async reales (si 0, se quita el await sin preguntar).
4. THM-2: alcance del rollout de paleta (15 / subconjunto / re-redactar promesa), tras la medición de peso.
5. SEM-4: prioridad y fecha (close ×5 · packs ×6 · flag emission).
6. DOC-1: hogares E1/E2 exactos del contenido migrado.
7. DOC-2: destino de los binarios del libro (commit vs puntero externo).
8. F4-D: qué iniciativas GAP se arrancan y cuáles se registran como límite deliberado.
9. Contramedidas: adoptar rojo=parar · fundación bajo R-* · guard de enumeración · trackers con sucesor · deuda con fecha (book-deviations) · docs:check en error · clean-room periódica al cierre de cada programa.

Protocolo de verificación (invariantes)

• npx tsx scripts/component-audit.ts → 134/0/0 debe MANTENERSE (→135 al entrar card-group; nunca hacia abajo).
• npx vitest run src/uix/contracts.test.ts → 37/37 (→38 con el guard de enumeración).
• npm run check fuera de alpha|words|palabras|chronos → 57.
• npx tsx scripts/morfo-vocabulary-check.ts → exit 0 (WARN cropper conocido).
• Suite eidos → 306/306 tras F0 y se mantiene.
• Cambios observables → verificación en navegador (gesto/tecla/inspección real). Gotchas de entorno en la memoria del proyecto (rAF congelado en tab desenfocado, dev server flaky, HMR de .svelte.ts).

Exclusiones DURAS (sin cambios)

• words/** · palabras/** · chronos (ACTIVE_DEV_TRACK) · web/routes/alpha/**.
• Demos: NO son fix — frame nuevo de sistema pendiente de diseño (decisión 2026-07-10, e53bf0e8); las D-* son verdict-neutral.
• Nada a git sin petición; commits con paths explícitos (excluir .claude/, rt.css, README stub, binarios del libro — salvo que la DECISIÓN #7 los incorpore).

Cola lateral (no bloqueante, registrada)

• Cascada de entrada vs firmas de evento (sistémico, shipped): las reglas generadas [data-stagger][data-state='open'] > [data-animation-style='…'] (0,3,0) siguen reclamando animation tras terminar la entrada (data-state persiste) y sombrean las firmas de evento (0,2,0) en cualquier ítem escalonado — commit-settle/announce-* incluidos. Card-group re-afirma la suya a (0,4,0) como parche local; el arreglo de sistema (¿liberar animation durante data-event-phase='active'? riesgo: re-disparo de la entrada al soltar) es diseño de motion — adjudicar en F2/F4-B.
• spin-field: única capa compartida sin morfo/contrato (guard MOR-4 la exime con nota) — darle contrato en F1 junto a la fundación.
• card-group.disabled no alcanza el Collapsible compuesto (promesa de la tabla de props a medias) — dossier ## Gaps con «implementar»; toca wrapper eidos de collapsible (reenvío) o corregir el doc.
• class-hooks preexistentes: color-picker(2) · time-picker(8) · time-range-picker(12) — extensión del codemod S1 cuando cuadre; nota: .range-time / .picker-time-row (CSS secundarios, ahora escaneados) pertenecen al mismo censo.
• task_d66356de (trp data-size a endpoints) · Task #31 (pickers → PickerProvider<TValue>) · FieldLangsSnippetProps sin uso.
• Hallazgos trascendentes del programa anterior (en _cierre.md): holiday/event de range-calendar · naming gemelos tree · invalid de rango.