35 Commits (fd6c55a13b163fb348af7760f5501bf15ae25cad)

Author	SHA1	Message	Date
dev	b80ccb33cb	docs(direction): el contrato pasa a ser canon, y el corpus deja de contradecirlo ... El eje estaba cerrado en CODIGO y no en DOCUMENTACION. El contrato vivia solo en `CONTINUE-direction.md`, un handoff que `docs/README.md` declara «never a source of truth». Un capitulo E2 lo fija ahora: `docs/canon/direction-contract.md`. Va a canon y no a arquitectura por la misma razon que `recipe-contract.md`: es normativo y tiene guard ejecutable. Cubre la cadena y donde corre cada eslabon; por que `undefined` no es `'ltr'`; las DOS atributos —`dir` crudo (nativo, lo que `:dir()` mira) y `data-dir` resuelto (opt-in, para recetas que necesitan un hook incondicional)—; cuando el estampado es OBLIGATORIO; la doctrina de selector; las trampas que el guard no ve; que espeja y que no; y la mitad global de prefs. EL CORPUS SE CONTRADECIA en cuatro sitios, y dos de ellos ENSENABAN mal: - `component-guide.md:372` daba la cadena como `prefs → 'ltr'`, DOS eslabones, mandando al wrapper a leer prefs directamente. Eso excluye la prop. - `soma-architecture.md` §3.4 presentaba el resolutor a pelo (`soma.prefs.getDir()` dentro del provider) como LA forma de obtener la direccion — justo lo que el eje retiro del catalogo. - `html.ts` ensenaba en su JSDoc `dir?: 'ltr' | 'rtl'`, el union a mano que la regla E-2.5 ahora prohibe. El mecanismo que ensena (extender para estrechar una clave HTML) es correcto y sobrevive; solo cambia el ejemplo. - `active-architecture.md:416` no listaba `lang` en la proyeccion, contra `contracts.ts` y contra su propio test de frontera. Igual `prefs/README.md`. Y no lo mencionaba en absoluto: el glosario (`activeDir`, `resolvedDir`, `data-dir`, RTL-1, el escape `rtl-physical:`), `eidos.md` (RTL-1 es el TERCER guard de deriva y faltaba junto al builder tipado y eidos-lint), `soma.md`, `building-a-component.md` (§Known traps es exactamente donde va «la prop mueve la matematica y deja la pintura atras»), y la tabla de atributos de la arquitectura, que afirma «todo lo que viaja entre capas viaja por atributos» y omitia `dir`. El checklist gana cuatro reglas y el guard que faltaba (`rtl:check` no estaba en la matriz de aceptacion pese a que la tabla canon lo nombra), mas un recorte en E-3.5: «todas las props visuales mapean a `data-{prop}`» leia como mandato de estampar `data-dir`, que `:dir()` no puede ver. DIVERGENCIA DECLARADA (§7): la familia `chart` no tiene prop ni provider y resuelve leyendo `getComputedStyle(node).direction`. Es el unico sitio del catalogo que hace lo que §1 prohibe. Se registra en vez de esconderse. Tres verificadores adversariales sobre el barrido; sus hallazgos, corregidos: RTL-1 estaba anunciado como guard de TODO el capitulo (solo cubre §4) · «nunca lee al padre» era absoluto y borraba la composicion sancionada en el punto de llamada · el estampado se afirmaba incondicional en un sitio y condicional en otro · las cuatro filas nuevas usaban una aplicabilidad que ni la leyenda ni `component-audit.ts` conocen. `docs:check` 0 errores sobre 564 docs. `check` 77 = la linea base. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2 months ago
dev	d9c79bf584	docs: corpus al día — blocks tier indexado, factorías nuevas, cifras atemporales ... blocks.md entra en el índice y next-features gana el registro §8 del tier; active-app documenta las factorías que faltaban en la tabla (agent, motion, scene…); docs-check aprende a censar catálogos sin tests ni barrels; book-deviations y component-guide dejan de citar recuentos congelados. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2 months ago
dev	31580f3b39	docs(spec): el contrato de delegación como especificación normativa (DRAFT) ... Fase 1 del plan de corrección, y materialización de D-AG.12a firmada ayer: `docs/spec/delegation-contract.md`, versionada por fecha (2026-07-28). QUÉ ES 50 requisitos `AG-1…50` en RFC-2119, con escalera de estabilidad por sección (stable | provisional | reserved), identificadores estables que NUNCA se renumeran ni se reciclan (un requisito retirado conserva su número), y la exigencia de que ambos vehículos de conformance CITEN el identificador que incumplen — «una suite que no nombra lo que falla no acredita a nadie». La doctrina pasa a ser el PORQUÉ y lo declara explícitamente: si doctrina y spec discrepan sobre un requisito, manda la spec y la doctrina se corrige. Annex A lleva las dos reclamaciones de frontera con estado `claimed` (ninguna materializada) y su gate de promoción: ≥2 FORMAS DE DOMINIO con manifiesto conforme — y dice por qué dos participantes de texto no valen: un formato probado solo sobre texto secuencial asume texto secuencial en silencio. Annex B mapea el modelo de amenazas a requisitos concretos en vez de dejarlo como prosa. §0.6 declara la posición honesta (actos secuenciales, cliente- first, generalidad en prueba). LO QUE LA ESCRITURA SACÓ A LA LUZ — y no estaba en ninguna lista - **AG-35 (presencia)**: el invariante correcto NO es «Aura montada» sino «alguna superficie está expresando el ciclo». El playground de agnt ya expresa el ciclo SIN Aura, y exigir el componente lo rechazaría siendo correcto. Además resuelve el problema técnico: el motor es un arte sin DOM y no puede saber qué hay montado, pero sí puede contar adjuntos. - **AG-41 (elicitación)**: especificado y NO cumplido, con el porqué estructural — la escalada lleva razón tipada pero no la pregunta, y la resolución es binaria y no lleva respuesta. No era falta de superficie. - **AG-44**: «ningún estado se distingue solo por el color» sube de decisión de componente a requisito del contrato (ya lo fija `shapes.test.ts`). §D — DECISIONES ABIERTAS, VISIBLES Un DRAFT puede llevarlas; al promocionar, §D debe quedar VACÍA. Son dos y ninguna la firmo yo: `SHOULD` vs `MUST` en AG-35 (con recomendación razonada: SHOULD + política que lo eleve a MUST, porque rehusar por defecto rompería los 30 tests del motor y le quitaría al app el derecho a elegir su superficie) y la forma del canal de elicitación en AG-41. Registrada en el índice del corpus. `docs/README.md` lo edita otra sesión en paralelo: stageada SOLO mi fila (backup → HEAD → mi cambio → add → restaurar su versión + mi cambio), verificado que lo suyo queda sin stagear. Verificado: docs:check 542 docs, sin errores nuevos (el único es el ajeno preexistente de callout). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2 months ago
dev	6be7195f0f	feat(agent): eje agéntico — motor $agent (F1) + Aura + promoción uix.scene ... Materializa el eje ortogonal agéntico del ecosistema: la 8ª familia semántica `delegate` («¿quién actúa ahora?») deja de estar sin materializar. El agente es OTRO ACTOR (LLM, macro, regla, workflow) que actúa por la MISMA API pública del provider; la ruta de llamada no se bifurca, la concreción semántica depende del actor. F0 · Doctrina - docs/architecture/agent.md — la doctrina permanente (capítulo comparativo de referencias + bibliografía de seguridad, máquina estados=verbos, contrato de participación, fila §0, a11y, amenazas). - docs/process/{PLAN,TRIAGE,INFORME}-agent — plan de ejecución con todas las decisiones firmadas (D-AG.1–11 + ⚖️1/2/3), triage de 4 revisores externos, e informe autocontenido para revisión externa. F1 · Motor ($libs/actor + arts/agent, 24º arte) - EngineAgent puro (sin DOM/runes, portable a servidor): máquina D-AG.4 (suggest/review/auto · escalated con reason+timeout · returned outcome-tipado · kill switch · autorización journaled aunque sea auto), tool-loop D-AG.5 (acts secuenciales, fallos→verbos, unknown-capability acotado, idempotencia por callId, presupuestos acts/turns/wall-clock vía puerto de timers), techo de autonomía por origen no confiable (F8b). - ActiveAgent (sesión reactiva, contrato ActiveEngine) · protocolo v1 espejo AG-UI (5 categorías + dirección tipada + reservas) · ScriptedAgentTransport determinista (adapters/ fuera del barrel) · journal WAL + puerto de trazas OTel · emisor sium→JSON Schema. - Acuñación del actor (⚖️2/F6b): ActorToken opaco en $libs/actor (hoja bajo orca/agent), registro privado WeakMap — los forjados resuelven a null; costura `actor?` en TriggerOptions→SemanticSignal (runtime copia verbatim; sema no resuelve). defineActiveAgent (service-factory app-level, timers del core — cero setTimeout a pelo). F3 · Aura — primer componente del eje (ruta 9 fases 0–6) - El materializador canónico de `delegate` (reservado en scene §F6): morfo con los eventos del ciclo (offer/escalate-untilAction/return + sustain-processing stateBound) — PRIMER morfo del ecosistema que emite familia delegate; provider soma que observa un puerto estructural (sin importar $agent — degradación total); orb eidos = aurora $scene modulada por estado (§F6) con fallback CSS = render de reduced-motion; live region única atribuida (WCAG 4.1.3); cancel compone Button (asChild). Demo v2 sobre el MOTOR REAL con compuertas deterministas. Orb-size derivado de la primitiva Avatar (32/40/48). D4 · Promoción uix.scene (Aura llegó) - defineEngineScene + superficie ActiveUix/ActiveEidos/contracts; el orb prefiere el motor compartido (presupuesto de escenas global) con fallback por-superficie. Gates: arts/agent 18/18 · aura 6/6 · arts:check 24 · eidos battery + recipe 30/30 + eidos-lint aura 0 inválidos · morfo:vocabulary + esquemas · smoke aura PASS · verificado en navegador (ciclo completo + estampa delegate en DOM + aurora WebGL pintando). Los tokens de recipe base.ts + CSS generado ya entraron en HEAD vía una sesión concurrente. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	322a1939a8	eidos(gradient-finish): acabado anclado a la sombra de la tinta - v1 Button+Badge + dial temable + guard ... El gradiente entra al sistema como ACABADO (material) del fill, jamas como valor del eje de color: prop `gradient` -> attr eidos-only `data-gradient` (familia data-variant; NO morfo - el runtime lo resolveria desde props de soma y mergeProps clobberea el stamp del wrapper). - Fill por capas: background-color = base solida (degrada sola en forced-colors) + background-image = rampa derivada de los slots de LA instancia (roles + 33 escalas + custom gratis, tinta heredada). - Dial unico de tema: primitives.gradientFinish.lift (26%) -> --gradient-finish-lift (0% = apagado; override por instancia via cascada). - RAMPA ANCLADA a la sombra de la tinta ("la rampa huye de la tinta"): tinta blanca -> #000 fuerte abajo (CTA sombreado); tinta oscura -> #fff fuerte arriba (glossy). Ancla+angulo por color x modo con el MISMO flip del slot contrast. Rectificacion MEDIDA: el lift global hacia blanco rompia la tinta heredada en 52/84 combos a 26% (techo global 0%) - el contraste ahora solo puede mejorar: dial sin topes. - Guard ejecutable gradient-finish-guard.test.ts (3/3): no-regresion <=40% sobre 84 combos + set flat-fail clavado (cyan/orange, deuda on-solid preexistente). - Generador emite la VAR (--_{c}-fill-finish); el recipe pinta (solid + re-assert en hover: su shorthand background resetea el longhand). - Lab temas/gradientes: 9 casos con componentes reales sobre el token real (dial en vivo, polaridad observable, evidencia de pasos 7/11, forced-colors). - Docs: capitulo theming/gradient-finish.md (registro de decisiones D1-D9, alternativas rechazadas con evidencia, leccion de proceso: medir ANTES de fijar defaults) + reference.md paragrafo 39 + changelog paragrafo 42 + plan docs/process/gradient-finish-plan-2026-07.md. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	3 months ago
dev	63b371d5ce	feat(packs+text): incorporate the animation collection — Ambient pack + text-effects family + docs ... Two streams, split by what the animation touches: STREAM A — decorative backgrounds → the pack tier - arts/scene: a consolidated scene runtime ($scene) that owns, once, the citizenship every ad-hoc background reinvented or skipped (frame loop, off-view pause, DPR cap, mandatory reduced-motion, WebGL context loss/restore, scene budget, teardown). SceneDom port (adom satisfies it), webgl/webgl2/canvas2d drivers + a custom-pipeline extension (vertexShader + draw + glContext.depth/dprCap) for real geometry (beam, particles, dither, grid, eter, pixel-blast, hyperspeed). 32 effects as shared resources. - src/packs/ambient: the first pack — <Ambient effect="…"> mounts a registered effect; the P contract (P-1..P-6) guarded by scripts/packs-check.ts; colors are token-aware (P-4). One-way dependency, removable-by-construction. - resolveToken extended to semantic color slots (--color-{role}-{slot}) so consumers resolve theme tokens to concrete colors (the P-4 half). STREAM B — animations over real text → canon - Six components (count-up + text-{gradient,circular,blur,focus,scramble}): each a morfo + eidos recipe (where there's styling) + demo. CountUp is a service component (counts through uix.format.numbers). The five Text* are passive decoratives. Upgrades over the seeds: SR hardening (real text visually-hidden + aria-hidden decoration), a11y fix (no fake role=button), measurement discipline (cached rects via dom.measure, no reflow storm), reduced-motion, ecosystem citizenship (eidos.dom/timers, no raw platform). - MorfoElement gains 'p'. DOCS - docs/architecture/packs.md (pack tier, admission rule, P contract, Aura promotion path); docs/decisions/design-text-effects.md (the family design record) + indexed in decisions.md / README.md; glossary entries (scene/Ambient/Aura/text effects); scene README custom-pipeline + authoring bridge; motion-guide content-effects note; strata tables acknowledge packs. Gates: component:audit 141/0/0 · docs:check 0/0 · scene tests 9/9 · packs:check 0/36 · check 0 own errors. Verified in browser (32 effects mount+compile; 6 text components SSR+hydrate, CountUp re-formats by locale live, TextGradient resolves token stops to OKLCH via var()). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	b55ca6eecb	fix(cleanroom): F2+F3+F4-C+SEM-4s1 — lote mecánico, censos con guard, corpus documental y el close polimórfico de los pickers VIVO ... F2 — lote mecánico (13 ítems): - DEP-2 ogl eliminado (0 imports) · DEP-1 clsx inlineado como toClassString propio + suite de contrato (props.test.ts; soma.md §12 cerrado). - THM-7: los 5 selectores manuales de sema.md reescritos con semaSelector (los ejemplos [data-toast-root] apuntaban a un part INEXISTENTE — la deriva que el builder previene, demostrada en el propio doc). - MOR-1 escape isomorfo + validación de attr-names en semaSelector + 9 tests (selectors.test.ts, matches() real con comillas/corchetes) · MOR-2 partMarkerAttr = única fuente compilador↔builder + test de paridad · MOR-3 _resetCompileCache borrado (0 usos). - SOM-2 keydown continue en match sin handler + keyboardFixtureMorfo · SOM-1 no-await de handlers (censo async = 0; contrato V1 cumplido) + pin. - SEM-2 trigger pre-attacha catch con logger (void trigger sin unhandled rejection; throw intacto para awaiters) + pin · SEM-3 fallback muerto de applyDominance → skip defensivo + timer tope de awaitExpression cancelado · SEC-1 adjudicado YA implementado (assertCssVariableValue desde 2026-05-11) + pin del path de VALOR. - accordion → outline (§32; su outline:none dejaba CERO anillo en HCM) — verificado en vivo · THM-6 radius-full 9999px · EID-4 recuentos 33. F3 — censos con guard: - SOM-3 cerrado: announcer + image-provider migrados a scheduler-preferred (consumidores cableados: date/time-field vía soma.uix.timers; avatar/image vía eidos.timers — verificado en vivo); guard de timers ENSANCHADO de soma/components a TODO soma y pasado a EVIDENCIA (setTimeout exige .schedule( en el fichero — layers/ y datetime/ escapaban del ámbito viejo). - THM-5: R-4.7 nueva (válvula same-line /* important: <razón> */, escaneo comment-blanked) + las 15 declaraciones anotadas con su razón + canon recipe-contract §3/§4. - SOM-4 adjudicado: el censo/guard YA existían (49 pins); knob/mask-field/ timeline pinneados (overrides documentados en call-site); media-player Batch-4 (35 hits, cero renderProps) = único batch restante, registrado. - THM-4 doctrinado en eidos.md §unused (comportamiento/composición = legítimo; deuda = eje visual sin consumidor; hotspots por lotes). F4-C — corpus documental (decisiones de usuario aplicadas): - DOC-3: los 15 enlaces muertos resueltos (repoint a la edición FINAL trackeada / des-link históricos) · docs:check I6-links WARN→ERROR. - DOC-1: tabla «Build contract» MIGRADA a component-guide con estados modernizados (A3–A5 → LIVE + guards de hoy); banners reapuntados; citas de CANON/sema.md historificadas; lápida-redirect en el §13 del fósil. - DOC-4: hold chain → holds.ts · FAQ event:* SUPERSEDED por signatures · gradient añadido a los DOS capstones (sextet real) · nota de paleta de demo-authoring corregida (universalPaletteDecls + decisión THM-2 = mecanismo universal como sucesor del tracker borrado). - DOC-5/6: recuentos anti-frágiles datados · §4.11 dup → §4.12 · Known gaps historificado · N-6/N-7 recuperadas de git (d68d2c45^) y canonizadas en eidos.md §pickers · authoring E2 → canon/tsc.md · air-old des-linkado · EID-3 (placement) en la fila RTL · AUX-2 disabledDom documentado. SEM-4 sesión 1 — el close polimórfico de los pickers, VIVO (D.11): - Reconciliación: los morfos ya no declaran close (delegated al Popover, de-dialoged 06-27); el agujero real era el cierre programático bypaseando dismissWith → save/cancel/select eran perceptualmente SILENCIOSOS. - Fix: PickerShellHandle.setPopoverDismiss + closeWith(cause) en los 5 providers (14 sitios; select/commit → 'save' = commit.save+fulfill, cancel → 'cancel' = emerge; fallback raw para headless) + UN inyector en el eidos PickerShell root (norma N-8). Picker genérico fuera a propósito (ya suena commit-set/cancel por diseño S9). - Verificado en vivo (date-picker): Done → close·commit·fulfill·active · Cancel → close·emerge · cierre real. Gates: matriz 141/141 (los 6 morfos nuevos de la pista de texto paralela también PASS) · contracts 38/38 · eidos 314 · sema 178 · morfo 94 · docs:check 0/0 con I6 en error · baseline propio 57. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	53b6f629f2	feat(audit): component re-audit + fixes P0–P5 (P4 complete, P5 in progress) ... Re-audit of the whole component catalog at pilot depth (91 fichas + the checkpoint verdicts in docs/audit/components/) and the executed fix packages. - P0–P3: doctrine (sema participation, CANON §3 intent, component-guide §5 + API naming, §32 outline), guards (morfo-vocabulary-check S10/S11d, component-audit A-3.1/A-1.4/S9, eidos-lint classHooks), morfo contracts (role=application removed ×4, aria-selected off the Day, drp translationRef, field data-state prune, pin-input commit-set, media-player renames), 13 new sema packs + 12 morfos family-default → pack. - P4 (N1–N10) COMPLETE: selectionMode (select/combobox/toggle-group/calendar); onValueCommit terminal-callback norm (pin-input/search/password/textarea + date/time/color-field add); typed validation reason + onInvalid (tags-input, css-field); index/onIndexChange (carousel); deselectable; openDelay/ groupSkipDelay; allowCustomValue; defaultValue prune. - P5 (in progress): S1 class-hooks codemod (22 hooks → data-attrs across cropper/button/image-picker/toggle/image-adjustments); S5 outline remnant in field.css; depth pass (data-depth=overlay on tooltip/toast/float-panel); touch-rows (--touch-target token, decoupled ::before hit-slop, area-not-visual, 44 AAA). S6 (Field composition) + S8 (calendar-surface) pending. Verification: errors-outside-(alpha|words|palabras|chronos) == 59 (baseline); morfo-vocabulary-check exit 0; eidos-lint class-hooks/invalid 0 on touched components; per-component vitest suites green. Handoff + remaining plan: docs/process/continue-audit-fixes-2026-07.md Excluded (broken by the N1 rename, left broken per user decision, not staged): words/**, palabras/**, chronos, web/routes/alpha/**. Reconciliation pending: the touch-rows ::before for checkbox/switch reverses changelog §37's earlier pseudo-element rejection (WCAG-overlap) that had routed markers to a labeled-row/Field task — flagged for the user in the handoff. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	d326d035c7	docs(arts): B3 — point the runtime-artifact shortcut at the composition root ... The "I want to… use a runtime artifact" row in docs/README.md now routes through the composition root (architecture/active-app.md) → the arts map (arts/README.md) → the per-artifact README. Map/aliases were already complete (9e48b80b). docs:check 0 errors. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	3 months ago
dev	e8ae85ee94	docs(arts): B1 — promote active-app to an architecture chapter ... Move the active-app reference into the book tree as the arts composition root, the App-side analogue of active-uix.md: - new docs/architecture/active-app.md (frontmatter + fixed relative paths); the dated Spanish "Handoff 2026-05-13" heading becomes a timeless "Quick start". - extract that Handoff block verbatim (ES) to docs/process/handoffs-2026-05.md, alongside the other extracted arts/uix handoffs. - stub src/arts/active-app/README.md pointing at the chapter (active-uix pattern). - wire the chapter into the docs/README.md E1 map. docs:check 0 errors (11 pre-existing warnings unrelated). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	3 months ago
dev	116594e063	feat(docs): S1 — generated canonical-vocabulary appendix (STUMBLES #1) ... An agent building a component from the docs-book alone could not assign archetypes / holds / haptic kinds: the closed sets live only in code consts and the corpus (correctly) forbids copying them into prose, so they were invisible from the docs. STUMBLES #1, the top stumble. Fix: docs/canon/vocabularies.md is GENERATED from the consts by 'npm run docs:vocabularies' — the ONE sanctioned place the lists are spelled out (generated = no drift objection), which every other doc links to. It covers part archetypes (with a one-line role each), sema families with their default hold/persistence + per-intent overrides, verbs by family, intents, the perceptual-duration scale, haptic kinds, the 33 palette scales, sizes, variant archetypes, and the shared common.* strings. - scripts/docs-vocabularies.ts imports the consts (robust — no fragile JSDoc/regex parsing) and formats them; the generation is an exported function so docs-check can compare. - Added ARCHETYPE_DESCRIPTIONS to morfo/types.ts (co-located with ARCHETYPE_VOCABULARY, satisfies Record<MorfoArchetype,string>) as the authoritative one-liners the appendix reads — descriptions become first-class data instead of inline union JSDoc a tool would have to parse. - docs-check gains I7: it regenerates in-memory and fails if the committed file drifts from the consts (negative-tested: corrupt -> error, regen -> green). The appendix's own counts pass I1, so I1 doubles as a second guard. - Linked from README (E2 canon row + two 'I want to' shortcuts), CANON.md (doctrine here, enumerated lists there), architecture/morfo.md (pick a part's archetype), and the component-audit minimum-package list (STUMBLES #8). docs:check 0 errors; npm run check unchanged in my files. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	29b121236a	docs(book): F7.6 (2/2) — final link sweep + complete book TOC; decisions/ batch COMPLETE ... The global sweep caught the last corpus links still pointing at pre-book paths: morfo chapter's s2.bis cross-ref (src/uix/README -> overview.md), authoring's E1 stratum row (active_architecture -> docs/architecture/), the related: frontmatter of decisions.md and canon/recipe-contract.md (THEMING/THEMING_GUIDE -> theming/reference + guide), and component-audit's typographic-vertebration pointer (eidos README -> architecture/eidos.md with the translated heading). README map completed as the book TOC: every chapter now has a row — theming/motion.md (the model) and theming/changelog.md (the chronicle) were the two missing. Remaining old-path references live only in chronicle docs (theming/changelog, process/) and resolve via stubs; the 11-warn baseline is all foreign targets (MOTION_SERVICE_RFC demo routes, deleted THEMING_AUDIT/PENDIENTES). F7.6 complete. The book tree is fully populated: architecture/ (8) + canon/ (2) + theming/ (7) + rfcs/ (7) + guides/ (4) + decisions/ (2). Next and last: F7.7 CLAUDE.md thinning — diff to the user first. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	4e7753fe08	docs(book): F7.6 (1/2) — decision logs moved to docs/decisions/ (verbatim Spanish) ... LIBRO_VARIACIONES_Y_EXTENSIONES -> decisions/book-deviations.md and GUIA_IMPLEMENTACION_SEMAUIX -> decisions/guia-semantica-historica.md, both moved AS-IS in Spanish: the deviations registry is a logbook of the author's literal decisions ('transcrita literal') and carries proposed doctrinal text destined for the Spanish book — translating it would destroy that function (s G calls itself bitacora); the guia was already status: historical (Fase 6) and the plan exempts it explicitly. English frontmatter added to both; internal cross-links repointed (CANON, theming/reference, book-deviations D.11). docs-check's I2 phantom-field exemption follows the moved file (it matched by the LIBRO_VARIACIONES filename; now also matches decisions/book-deviations.md). Corpus swept: CANON x3, README (E2/E3 strata + tables — also fixed the pre-Fase-6 leftover row still calling the guia 'authoritative for any new wrapper' and the unswept eidos/TSC.md stratum mention), building-a-component D.4, completion-checklist G-1.1 + header, theming/reference, architecture x5 (active-architecture, eidos, morfo, overview, sema x2). docs:check 0 errors, 11-warn baseline. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	62a62075f9	docs(book): F7.5 (2/2) — COMPONENT_GUIDE moved; guides/ batch COMPLETE ... src/uix/soma/COMPONENT_GUIDE.md (1449 L, English body) moved to docs/guides/component-guide.md. The only Spanish passage — the archetype-canon banner (2026-06-19) — translated in the move; the rest is verbatim. Banner's ARCHETYPE_COHERENCE_AUDIT link reaches into src (audit fossil, stays with the code); the checklist cross-link is now the sibling ./completion-checklist.md and the 'soma/README s9' mention now names architecture/soma.md (its post-F7.2 home). Corpus swept: authoring + README E4 stratum rows (also stale THEMING_GUIDE name), building-a-component phases 0/2, architecture/{soma-architecture s4/ s13-tree/s17, overview, morfo, active-architecture}. F7.5 complete: docs/guides/ = component-guide, completion-checklist, demo-authoring, component-audit. docs:check 0 errors, warns back at the 11 baseline. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	0588644a71	docs(book): F7.5 (1/2) — checklist + audit guide + demo guide moved to docs/guides/ ... Three English guides moved verbatim (copy + link touch-ups, no translation): COMPONENT_COMPLETION_CHECKLIST -> guides/ completion-checklist.md, COMPONENT_AUDIT_GUIDE -> guides/ component-audit.md, DEMO_AUTHORING_GUIDE -> guides/demo-authoring.md. Tooling moved with its doc in the same pass: docs-check I5 now parses the checklist at the new path (verified: 0 errors, rule tables found) and component-audit.ts's two path strings updated. One reconciliation in the audit guide's s5, applied as link-don't-copy: the copied v1 6-tab template list (stale vs the v2 9-tab guide it links, drawer canary vs button) is replaced by a pointer to demo-authoring.md; the domain canaries in s7 stay. demo-authoring's harness links now reach into web/routes/uix/lib/ (the modules stay with the code); the deleted pendiente_color_demos.md reference is marked TODO(reconcile). Corpus swept: building-a-component (frontmatter related: + phases 6/8), authoring, architecture/soma, theming/reference s5-parity, testing-and-tooling, getting-started, README (E4 rows + component-audit row added + two stale F7.3 paths in 'I want to' fixed). Remaining warns = links to component-guide.md, which lands in F7.5 (2/2). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	6735c40187	docs(book): F7.4 closed — rfcs/ row in the TOC, plan + hand-off updated; next is F7.5 (guides/) ... Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	6307ec86f0	docs(book): F7.3 (9/9) — THEMING reference translated; theming/ + canon/ batch COMPLETE ... src/uix/eidos/THEMING.md (1499 L, Spanish) translated to English as docs/theming/reference.md, same s1-s38 numbering: the mental model, s1.bis (theming lives in eidos — the 2-of-3 derivation and the canonical split), the CSS layers, the 7 token layers, the 9 roles, the size canon (universal 1:1 + label step-down + container cap + the icon scale), the naming conventions, the s7/s8/s9/s13/s15/s17/s18 stubs repointed into the book (canon/tsc, theming/guide, theming/notes, theming/changelog, theming/motion), runtime overrides + builders, bundle/purge, validation tooling, s14 motion (the pickup lift), s16 anti-patterns, s19 variants canon, and the s20-s38 standing-decision stubs. One internal reconciliation applied: the s35 stub cited the control/compact/dense size archetypes that s5 declares superseded by the universal 1:1 — aligned. One stale v1 DEMO_AUTHORING s12.8 citation in s5 replaced by the v2 s6 parity rule. Stub at the old path carries the full s1-s38 map (the most sN-cited doc in the repo: code comments, CLAUDE.md, RFCs). Corpus links swept (CANON, docs map, comparison, glossary, eidos chapter, canon/tsc, theming/guide + notes). docs:check 0 errors (260 docs). F7.3 complete: docs/canon/ (tsc, recipe-contract) + docs/theming/ (reference, guide, notes, channels, motion, motion-guide, changelog). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	060f7f1572	docs(book): F7.3 (2/3) — theming/ satellites: guide + notes + channels + motion-guide + changelog ... Five theming docs into the book tree: - docs/theming/guide.md — THEMING_GUIDE (241 L, Spanish -> English): add a component's recipe step-by-step + the three theme-definition modes. - docs/theming/notes.md — THEMING_NOTES (168 L, Spanish -> English): the bundle/feature comparison + the controversial-decisions FAQ (in-page anchor to s1.bis fixed to a real THEMING link). - docs/theming/channels.md — CHANNELS_SYNTHESIS (115 L, Spanish -> English): the per-channel-RFC capstone (two moments, 8 expression vs 3 runtime channels, the builder sextet + applyTheme). - docs/theming/motion-guide.md — MOTION_GUIDE (213 L, already English): moved with frontmatter + links repointed. - docs/theming/changelog.md — THEMING_CHANGELOG (1310 L): chronicle, moved VERBATIM (recorded history is not translated), links repointed. Thin stubs at all five old paths; corpus links swept (docs map E3/E4 rows, building-a-component phase 5, decisions umbrella, getting-started, eidos chapter). docs:check 0 errors (258 docs). Remaining in F7.3: THEMING.md itself (1499 L) + eidos-motion.md (698 L). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	f4639a36fa	docs(book): F7.3 (1/2) — canon/ chapter: TSC + Recipe Contract translated ... src/uix/eidos/TSC.md (334 L) and RECIPE_CONTRACT.md (131 L), both Spanish, translated to English as docs/canon/tsc.md + docs/canon/recipe-contract.md (the E2 visual canon inside the book tree). Thin stubs at the old paths (code comments and component-audit R-4.x provenance keep resolving); corpus links swept (docs map E2 rows, authoring anti-copy law, building-a-component phase 5, comparison, getting-started, glossary, eidos chapter). docs:check 0 errors. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	1a710c12ff	docs(book): F7.2 (7/7) — soma-architecture chapter translated; architecture/ batch COMPLETE ... src/uix/soma/SOMA_ARCHITECTURE.md (1058 L, Spanish) translated to English as docs/architecture/soma-architecture.md, same s1-s17 numbering: layer architecture, design principles, the closed six-piece model + SomaRuntime, component model (picker composition), runtime parts, the layers inventory, the Soma class + date/time domain + statics convention, the reactive system, internal helpers, data-* contracts, IDs, barrels, boundaries, directory structure, anti-patterns, current shape, stability rule, checklist. The frozen per-provider test list (dated 2026-05-15, ~140 L) became the timeless fact: the NO_MISSING_PROVIDER_TESTS guard + the test tree ARE the coverage inventory (testing-and-tooling aligned). Stub with the full sN map at the old path; corpus links swept. F7.2 is complete: docs/architecture/ now holds the whole E1 stratum in English (7 chapters, ~5.4k lines), with thin stubs + sN maps next to the code. docs:check 0 errors (251 docs). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	479204fca6	docs(book): F7.2 (6/7) — eidos chapter translated to docs/architecture/eidos.md ... src/uix/eidos/README.md (1020 L, Spanish) translated to English: the ActiveEidos runtime (config/patch, themes, themeSource, CSS contract, setCssVariables, persistence envelope, resolveToken), canonical size + transversal primitives, what eidos consumes from morfo/soma/sema, the --* token rule, the THEMING sN map, typographic vertebration (two anchors + alias chain + R-2.7), the 2-of-3 rule, disciplined-option-C API conventions (7+4 rules, Toast special case), the selector-drift defense, and the picker patterns P-1..P-5. Two already-decided reconciliations folded in: themes/fonts.css superseded (font-faces live in generated/base.css) and the dated 2026-05-21 picker block merged into the picker-patterns intro — its dead PENDIENTES.md pointer replaced by a TODO(reconcile) note (norms N-6/N-7 orphaned by d68d2c45), which also clears one docs:check warn (13 -> 12). Thin stub at the old path keeps THEMING/TSC/motion pointers next to the code; corpus links swept. docs:check 0 errors. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	8668e117bc	docs(book): F7.2 (5/7) — active-architecture chapter translated ... src/uix/active_architecture.md (865 L, Spanish) translated to English as docs/architecture/active-architecture.md: the s0 module contracts + canonical naming, the four layers in depth, the transcription chain, the causal chain of one interaction, the DOM-attribute table, the 12 hard rules (incl. the sec-dom read-timing rule), authorship vs transcription, what it is NOT, risks. The dated header changelog block was dropped per the timeless rule (s10 already routes snapshots to docs/process/); the stale themes/fonts.css mention in the eidos structure listing corrected to the generated foundation (phase-6 fact). Stub at the old path carries the full sN section map (the most sN-cited doc in the corpus). All docs/ corpus links repointed to the chapter. docs:check 0 errors. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	a6371ab58d	docs(book): F7.2 (4/6) — sema chapter translated to docs/architecture/sema.md ... src/uix/sema/README.md (749 L, Spanish) translated to English: the emit contract (sequential strict), the 1-2-3-4-5a-5b resolution cascade, the data-event-* tokens, the typed semaSelector builder, per-component packs, the sound repository, SoundChannel details, SEMA_FAMILY_POLICY (two axes) and SEMA_VERBS + naming shapes. Thin stub at the old path; corpus links swept (CANON, comparison, glossary, docs map, building-a-component, overview, morfo chapter, active_architecture). docs:check 0 errors. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	e941bd2a7f	docs(book): F7.2 (3/6) — soma chapter translated to docs/architecture/soma.md ... src/uix/soma/README.md (405 L, Spanish) translated to English: purpose, membership criteria, dependencies (incl. the clsx phantom-dep note), morfo consumption, provider/wrapper pattern, composition + context rules, eidos relationship, inventory doctrine. Thin stub at the old path; corpus links swept (docs map, glossary, building-a-component s0, overview). docs:check 0 errors. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	e83b9289ed	docs(book): F7.2 (2/6) — the thesis translated to docs/architecture/overview.md ... src/uix/README.md (485 L, Spanish) translated to English as the book's opening chapter. Two already-decided reconciliations applied in passing: the 'authoritative GUIA' pointer now reflects its historical status (phase-6 decision) and the frozen 2026-05-17 migration status became the timeless statement (every component ships an eidos wrapper; inventory = tree + component:audit). Thin stub at the old path; docs/README entry, strata table and reading order repointed. docs:check 0 errors. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	4b48f2cc74	docs(book): F7.2 (1/6) — morfo chapter migrated to docs/architecture/morfo.md ... Already-English doc: moved verbatim with frontmatter + internal links repointed (10 targets); thin stub at src/uix/morfo/README.md; corpus links swept (docs map, glossary, comparison, building-a-component, the uix thesis, active_architecture, soma docs, eidos README incl. the semaSelector anchor). docs:check 0 errors (245 docs). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	c4fe43abc6	docs(book): F7.1 — book-corpus plan + docs/architecture skeleton + active-uix pilot ... User decision (2026-07-02): the corpus stops being a MAP over dispersed layer docs — the layer reference MOVES into docs/ with book order, in English, superseding the kickoff-era 'hybrid structure' decision. The 189 component READMEs stay in-place (E5, linked). - docs/process/PLAN-docs-book.md: the phase-7 plan — target tree (architecture/ canon/ theming/ rfcs/ guides/ decisions/), the per-doc migration pattern (translate -> Write new path -> stub at old path -> link sweep -> docs:check -> commit per batch), batches F7.1-F7.7 with volumes, and the known risks (sN citations get a map in the stub; the legacy RFC renames finally become safe because the stub keeps the old name alive for provenance citations). - Pilot migrated end-to-end: docs/architecture/active-uix.md (English, frontmatter, links repointed) with a thin stub at src/uix/active-uix/README.md; docs/README map, glossary and active_architecture s0 repointed. Validates the pattern for F7.2+. docs:check: 0 errors (244 docs). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	3095065f0c	feat(eidos): recipe contract R-4.x + motion-channel migration 15/15 + theme-builder fixes + inventory decisions ... Fable audit follow-through (fable_audit.md + fable-eidos-audit.md): - RECIPE_CONTRACT.md (E2 canon): the transversal systems every recipe must consume, enforced by component-audit R-4.1-4.6 (all at error; escape valves /* literal */ + /* functional */; WIP tracks excluded). Stale audit rules fixed against the current architecture (E-2.2 wrapper imports, D-1.2 v2 9-tab union, D-3.1 single snippet, TabsVariant mirror) - verdicts went 0/117/15 -> 75/50/5. - Motion migration 15/15: recipes off local @keyframes onto the channel - preset stamps (dropdown/context/select/combobox/tooltip/link-preview/ clipboard), new expand/collapse + value-flash signatures, shared-axis reverse pair, delayed-open open-alias in the preset trigger (PRESET_STATE_ALIASES), materials pattern for irreducible triggers (card/timeline/tabs/nav-menu/metrics). Duration/scale hooks keep every recipe's tuned values. - buildScheme (fase C): full a1..a12 alpha ramp per role (was a2/a3 - stale alphas after applyColorScheme), intentSeeds so temper starts from the ACTIVE theme's intent mapping (risk stays orange), alpha background self-derived from the scheme's own neutral step 1 (was hardcoded #fff/#111); mode now forces the donor variant. - Inventory decisions (fase D): semanticTracking axis removed (all-zero), border-hover slot dropped (0 consumers), separator slot adopted across line dividers (step 6, Radix divider tone), size-bundle consumption pilot on toggle (canonical coordinates consumed, deliberate deviations kept visible). - Docs: building-a-component.md (the one door, 9-phase route + known traps), PLAN-docs-reconciliation.md (fase 6 kickoff for a fresh session), THEMING wiring updates. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	d0312ee94f	docs(motion): implementation guide + reconcile the doc family ... - New MOTION_GUIDE.md — the task-oriented developer front door: the `motion` prop, the three USE domains (event/state/content), the full preset catalog, recipes (animate in/out, loop, state transitions, staggered list in&out, springs, custom presets), reduced-motion, theming tokens, [data-debug-stagger], and constraints. Links the model (eidos-motion) + the engine (arts/motion) + history (RFC). - eidos-motion.md: note the 3-domain USE framing over the engine's 2 moments (the content domain is a usage pattern over the state machinery); fix the `fallback` overclaim — it is NOT auto-applied (the spring honours ctx.reduced itself, per the audit fix). - docs/README.md (corpus map) + eidos/README.md: motion was undiscoverable — add the guide to E4 Guides + the "I want to…" table + the eidos Motion section. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	4 months ago
dev	9272c54278	docs(corpus): add docs/comparison.md — honest framework-level positioning ... Where UIX sits relative to the two families (headless behavior: Radix/Ark/bits/ React Aria; styled systems: Mantine/Chakra/Radix Themes/shadcn), grounded in UIX's own documented design choices rather than claims about competitors' internals: - morfo as a single declarative contract (compile-time drift), - a perception layer (sema) neither family has, - two-moment motion, theme-as-retint, validated token scope, graceful degradation, - and the honest trade-offs (more to learn, smaller ecosystem, sema only pays off if used). The one competitor-specific claim (Chakra collapses presence onto one axis) is sourced in eidos-motion.md. Per-component prop-parity comparisons stay in each component README, by doctrine. Wired into docs/README.md. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	4 months ago
dev	e737f0f78d	docs(corpus): add docs/testing-and-tooling.md — testing, validation, codegen, SSR ... Consolidates the cross-cutting verification story that was scattered across package.json, COMPONENT_GUIDE and SOMA_ARCHITECTURE into one reference: - The two-project vitest suite (browser client / node server) and how to run one. - Each validator and the class of bug it catches: morfo:check (DOM vs contract), morfo:vocabulary (verb drift), component:audit (acceptance), perm:check (state transitions), smoke (hydration), translations:check, eidos-lint. - Codegen vs authored: generate:eidos-css, generate:contracts-docs, and the compileMorfo primitive. - The SSR posture: dom:false -> disabledDom, ActiveDom owner-document resolution, ornamental sema, and why smoke (not HTTP 200) is what catches hydration bugs. All grounded in the real package.json scripts. Wired into docs/README.md. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	4 months ago
dev	333d791e02	docs(corpus): add docs/getting-started.md — clone to first change ... The narrative onboarding path that complements the map (docs/README.md) and the build guide (COMPONENT_GUIDE): run it, the mental model, and your first change, in order. Grounded in the real routes (/uix/components/*, /active, /temas) and the real scripts (check / test / morfo:check / smoke / component:audit / perm:check), it points at COMPONENT_GUIDE / THEMING_GUIDE rather than duplicating them. The centerpiece is "see the whole architecture in one element": inspect a toggle and watch morfo's data-toggle, soma's data-state, sema's data-event-* and eidos's CSS all on one node — the doctrine made visible. Wired into docs/README.md (top callout + first "I want to…" row). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	4 months ago
dev	cc51535356	docs(corpus): add docs/authoring.md — the rules for writing docs here ... So a session or agent that creates or edits documentation does it consistently with the corpus, not against it. Codifies what the migration learned, each rule tied to the failure it fixes: 1. Link the canon, never copy it (the anti-drift law — "7 families" survived in three docs because they re-transcribed instead of linking). 2. Every doc belongs to one stratum (E0-E5 / process); where each kind lives. 3. Reference docs are timeless — hand-offs, dated status and hardcoded catalogs go to process/ or become pointers. 4. One source per concern; two docs on a subject get distinct stated roles. 5. Frontmatter convention. 6. Sections cited by §N are load-bearing — stub-split, never silently renumber; verify moved links resolve. 7. English target; code comments always English. 8. Naming (rfc-* / design-*), markdown relative links, pre-commit checklist. Wired into docs/README.md ("I want to… write a doc" + a note after the strata). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	4 months ago
dev	7193756a06	docs(corpus): add docs/glossary.md — the invented vocabulary, one line each ... Companion to the entry point: an agent or new session can look up the framework's coined terms (morfo, soma, sema, eidos, archetype, runtime part, Presence, polymorphic close, hold, cascade, TSC, recipe, variant, role, scaling, …) in one place, each with a pointer to its authoritative doc. The semantic subset (family / intent / verb / channel) points at CANON.md instead of restating the values, so it cannot drift. Wired into docs/README.md (E0 stratum + reading order). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	4 months ago
dev	08d83b5a30	docs(corpus): add docs/README.md — the corpus entry point (E0), wire it from CLAUDE.md ... A single front door to the whole documentation set, for new sessions and agents to orient before doing anything: the 60-second framework summary, the strata (E0 orientation / E1 architecture / E2 canon / E3 decisions / E4 guides / E5 module reference / process), a reading order, a per-stratum map of every doc, and task-oriented shortcuts ("I want to build a component / theme it / know why a decision was made…"). CLAUDE.md gets a "Start here" pointer at the top of Reference Documents so the entry point is actually reached on session start (this is the small additive pointer, not the deferred CLAUDE.md slimming). All links verified. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	4 months ago