active-svelte/NEXT_STEPS.md

Next Steps

Estado al cierre:

• Suite unitaria verde: npm test -> 103 archivos, 1189 tests.
• fmts verde: npx vitest run src/arts/fmts -> 14 archivos, 39 tests.
• conn verde: npx vitest run src/arts/conn -> 5 archivos, 28 tests.
• auth verde: npx vitest run src/arts/auth src/svrs/auth src/libs/auth -> 4 archivos, 14 tests.
• Refactor tecnico posterior:
  • svrs/auth/engine-auth.ts ya delega CSRF en csrf-flow.ts, coherente con password/session/recovery/device flows.
  • libs/cach/engine.ts centraliza eventos de lectura con emitForContext(...).
  • arts/conn/connection.ts usa createConnectionIdFactory(...) desde helpers.
  • arts/conn/connection.ts delega auth/request/ACK request-reply en connection-requests.ts.
  • svrs/auth/adapters/memory-store.ts queda como composition root de 39 lineas; la logica se reparte en stores internos de credentials, flows, linked accounts, sessions/devices, refresh y state/snapshot.
  • arts/perm/client.ts delega transporte HTTP/JSON en client-http.ts; el cliente queda centrado en cache, snapshot y fallback.
  • arts/timr/engine-timers.ts delega TimerHandle cancel/reschedule en timer-handle.ts.
  • arts/stor/engine-storage.ts delega IDs de adapter, bus keys y suscripciones cross-tab en adapter-registry.ts.
  • arts/stor/engine-storage.ts delega el registro de defaults conflictivos en defaults-registry.ts.
  • libs/cach/engine.ts delega creacion/escritura/fetch-store de envelopes en runtime-io.ts.
  • libs/cach/engine.ts delega safe-delete y clear en runtime-delete.ts.
  • arts/sess/engine-session.ts delega la clasificacion none/anonymous/identified en session-identity.ts.
  • arts/sess/engine-session.ts delega snapshot, generation, dispatch, persistencia y commits en session-state.ts.
  • arts/sess/engine-session.ts delega la resolucion de revoke local/global/degradado en session-revoke.ts.
  • arts/sess/engine-session.ts delega refresh, stale-generation, validacion y diagnosticos de refresh en session-refresh.ts.
  • arts/perm/client.ts delega claves/scope de cache en client-keys.ts y lectura de snapshot en client-snapshot.ts.
  • arts/stor/engine-storage.ts delega lectura/escritura/validacion/migracion de entradas en entry-runtime.ts.
  • arts/timr/engine-timers.ts delega armado nativo, ejecucion, finalizacion e intervalos en timer-runner.ts.
  • arts/cach/active-cache.svelte.ts delega la entry reactiva en active-cache-entry.svelte.ts y normalizacion de errores en helper compartido.
  • arts/auth/active-auth.svelte.ts delega CSRF, validacion de respuestas, normalizacion de errores e invalidacion de cache en active-auth-runtime.ts.
  • arts/conn/connection.ts delega apertura/cierre logico e isConnected en connection-lifecycle.ts.
  • arts/conn/connection.ts delega la programacion de reconnect y exhaustion en connection-reconnect-runtime.ts.
  • libs/perm/evaluator.ts delega helpers puros de resultado, dependencias y comparacion en evaluator-helpers.ts.
  • arts/http/engine-http.ts delega la validacion preflight de bodySchema en request-validation.ts.
  • arts/http/engine-http.ts delega la resolucion final de response/error en response-resolution.ts.
  • arts/sium/core/pipe.ts queda centrado en composicion; factories refine/transform/codec/meta viven en steps.ts.
  • libs/cach/engine.ts delega lectura get() en runtime-get.ts.
  • libs/cach/engine.ts delega escritura set() en runtime-set.ts.
  • libs/cach/engine.ts delega query() en runtime-query.ts; conserva composition root para context/io/delete/invalidate/mutate/explain.
  • arts/conn/connection.ts delega decode/routing de frames entrantes en connection-message-router.ts.
  • arts/conn/connection.ts delega el intento open/auth/flush/join en connection-connect.ts.
  • arts/conn/connection.ts delega current transport, attach/detach y close en connection-transport-runtime.ts.
  • arts/conn/connection.ts delega cierre intencional y close-event handling en connection-close.ts.
  • arts/timr/engine-timers.ts delega fan-out de listeners y diagnostico de listeners en timer-events.ts.
  • arts/timr/engine-timers.ts delega la construccion de entradas internas en timer-entry.ts.
  • arts/timr/engine-timers.ts delega cancelacion y seleccion por scope en timer-cancel.ts.
  • arts/timr/engine-timers.ts delega entrada viva, contexto de task y max-runs en timer-entry.ts.
• Integracion total ampliada: Auth.signOut() valida anonimizacion, invalidacion de Permissions y evento Cache.invalidate.
• Tanda focalizada verde: npx vitest run src/arts/conn src/libs/cach src/arts/cach src/svrs/cach src/arts/auth src/svrs/auth src/libs/auth src/arts/aapp/test/ecosystem.integration.test.ts -> 19 archivos, 82 tests.
• /test/ecosystem revisado en navegador: carga sin errores de consola, ar cambia a rtl, Formats se actualiza por locale, Perm cambia con rol viewer, Cach re-scopea por locale y Conn loopback publica/recibe.
• src/arts/aapp/test/ecosystem.integration.test.ts ampliado para cubrir rol viewer no-allow y cache re-scoped por locale.
• Referencias residuales de marca anterior eliminadas de src/ fuera de rutas temporales: docs, páginas de test y constantes de cookies/headers auth usan ahora Active/active.
• src/arts/conn/README.md ampliado: contrato de raíz/conexión/canal, estados, transportes, request/reply, reconnect, heartbeat, sesión, diagnostics/logger, errores y testing.
• src/arts/fmts/README.md ampliado con guia de uso, LocaleSource, contrato auto/manual, submodulos, listeners, integracion con aapp y tests.
• fmts redujo boilerplate activo con helpers readFrom / writeTo y los engines comparten directamente las funciones de createFormatsLocaleState; APIs públicas sin cambios.
• No tocar src/web/routes/temp/ hasta decidir que hacer con esa pagina.
• No commitear .idea/, .claude/ ni .opencode/.

Pendiente para manana:

• Revisar documentacion restante de cach, perm, auth y fmts con ojo de consumidor externo, no solo tecnico.
• Continuar la reduccion de archivos grandes: prioridad conn/connection.ts, extraccion progresiva de runtime read/write en libs/cach y separar helpers de test/server auth cuando crezcan.
• Ampliar tests de integracion cruzada: auth + sess + perm + cach + http + stor + fmts + conn + timr + logr.
• Revisar la adopcion final del contrato comun Logger / diagnostics en todos los modulos, sin acoplar artefactos a arts/logr; primera pasada limpia salvo aapp como composition root, arts/logr y tests.
• Decidir que hacer con la pagina temporal que bloquea npm run check; mientras tanto, validar con npm test y tests focalizados.