Phase 3 (E1). After Phase 1b pulled the embedded "Handoff 2026-05-14" out, the
doc still read as session process ("tras cerrar P1", "punto crítico para
mañana", a "Regla de trabajo vigente" section). Rewrote it as a clean layer
reference: what active-uix is, the two boot paths (createActiveUix /
attachActiveUix), the minimum-contracts table (linked to the executable
contracts.ts — fixed the path: it lives in src/uix/, not active-uix/), the
ownership + degradation rules as timeless invariants, and the shell-boot example.
Dropped the process framing. Spanish kept (consistent with its sibling
active_architecture.md; coordinated EN migration is a later pass).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
| `ActiveUix` standalone | `langs` config | `clipboard:false`, `format`, `events`, `portal`, `dom:false` | crea `prefs`, core services y, si `dom:false`, `disabledDom` local | falta config `langs` |
| Módulo | Mínimo requerido | Opcional | Fallback si falta | Error si falta |
| `ActiveUix` attach | `ActiveApp` core + services `langs`, `dom` | `app.clipboard`, `app.format`, app event engine, `portal` | ninguno para servicios requeridos | falta `langs` o `dom` en app; getter explicito falla si se pide un servicio opcional ausente |
| --- | --- | --- | --- | --- |
| `SomaRuntime` | `dom` desde `ActiveUix` | event engine, `langs`, `format` | ninguno propio | morfo/event/part inexistente |
| `ActiveUix` standalone | `langs` config | `clipboard:false`, `format`, `events`, `portal`, `dom:false` | crea `prefs`, core services y, si `dom:false`, `disabledDom` local | falta config `langs` |
| `Sema` directo | `dom` o `projector` si `visual` esta activo | `sound`, `haptic`, `visual:false` | ninguno propio de servicios UIX | `SemaConfigError` sin `dom/projector` y con visual activo |
| `ActiveUix` attach | `ActiveApp` core + servicios `langs`, `dom` | `app.clipboard`, `app.format`, motor de eventos, `portal` | ninguno para servicios requeridos | falta `langs` o `dom` en app; el getter de un servicio opcional ausente falla explícito |
| `Eidos` | `dom` si `applyDom` | `langs`, `format`, `prefs`, mode/density sources | `applyDom:false` permite render/serializar sin DOM | falta `dom` con `applyDom` activo; componentes visuales fallan si leen un servicio no inyectado |
| `SomaRuntime` | `dom` desde `ActiveUix` | motor de eventos, `langs`, `format` | ninguno propio | morfo/event/part inexistente |
| `ADom` directo | target/window/document del caller | breakpoints/window | `disabledDom` solo si el caller lo pide explicitamente | errores propios de ADom si no hay DOM real |
| `Sema` directo | `dom` o `projector` si `visual` activo | `sound`, `haptic`, `visual:false` | ninguno propio de servicios UIX | `SemaConfigError` sin `dom/projector` con visual activo |
| `Eidos` | `dom` si `applyDom` | `langs`, `format`, `prefs`, fuentes mode/density | `applyDom:false` permite render/serializar sin DOM | falta `dom` con `applyDom` activo |
## Decisiones cerradas y riesgos abiertos
| `ADom` directo | target/window/document del caller | breakpoints/window | `disabledDom` solo si el caller lo pide | errores propios de ADom sin DOM real |
1. `dom:false` solo degrada en standalone: `ActiveUix` expone un
## Reglas de ownership y degradación
`disabledDom` local y no deja a Sema/events caer a escrituras directas.
2. En attach mode no hay creacion compensatoria: si la app no tiene `dom`,
1. **Solo los composition roots crean servicios compartidos.**`morfo`, `soma`,
`attachActiveUix(app)` falla.
`sema`, `eidos` y los componentes nunca crean `dom`, `langs`, `prefs`,
3. Standalone usa el mismo bus Svelte-aware que `ActiveApp`.
`format`, `clipboard` ni equivalentes: los reciben de `ActiveUix`.
4. Attach mode no duplica la suscripcion `prefs.language -> langs`.
2. **`dom:false` solo degrada en standalone.** `ActiveUix` expone un
5. `langs` no es `locale`: `prefs.language` alimenta traducciones;
`disabledDom` local y se lo pasa también a `EngineSemantic`; Sema/events no
`prefs.locale` alimenta formatos.
caen a escrituras DOM directas. En attach no hay creación compensatoria: si la
6. `clipboard` es un servicio de capacidad, no DOM visual. Standalone lo
app no tiene `dom`, `attachActiveUix(app)` falla.
crea salvo `clipboard:false`; attach lo consume de `app.clipboard` si una
3. **`langs` no es `locale`.** `prefs.language` alimenta las traducciones;
capa lo pide y falla con error explicito si no fue declarado.
`prefs.locale` alimenta los formatos. No se mezclan.
7. `prefs.direction` es la preferencia efectiva de direccion; `html[dir]` es
4. **`clipboard` es un servicio de capacidad, no DOM visual.** Standalone lo crea
solo su proyeccion DOM.
salvo `clipboard:false`; attach lo consume de `app.clipboard` cuando una capa
8. Los wrappers/componentes no deben ser el lugar donde se resuelvan estas
lo pide, y falla con error explícito si no se declaró.
politicas. Primero se cierra el contrato de la raiz activa.
5. **`prefs.direction` es la preferencia efectiva de dirección**; `html[dir]` es
9. El antiguo artefacto `frontend` fue retirado. `ActiveUix` no proyecta
solo su proyección DOM.
preferencias al DOM: `arts/prefs` proyecta lo transversal y `ActiveEidos`
6. **`ActiveUix` no auto-proyecta preferencias al DOM.** `arts/prefs` proyecta lo
