scoreko-dev/docs/refactor/SESSION_HANDOFF.md

Session Handoff

Este handoff resume el contexto que debe asumir cualquier sesión futura antes de continuar el refactor. El análisis arquitectónico ya está hecho; no debe repetirse desde cero.

Estado de la Sesión

• No se habían modificado archivos antes de crear esta documentación.
• Se leyó la estructura del proyecto, configs, schemas, extensión, dashboard, overlays y shared.
• vue-tsc pasa.
• tsc pasa.
• lint falla con 3 errores reales y 243 warnings de formato.

Documentación Creada

Documento	Propósito
docs/refactor/ARCHITECTURE_AUDIT.md	Diagnóstico del estado actual y riesgos.
docs/refactor/MIGRATION_PLAN.md	Orden secuencial de migración.
docs/refactor/ARCHITECTURE_RULES.md	Reglas accionables para implementación posterior.
docs/refactor/TARGET_ARCHITECTURE.md	Source of truth de la arquitectura objetivo.
docs/refactor/SESSION_HANDOFF.md	Contexto operativo para futuras sesiones.

Source of Truth

Para futuras sesiones:

1. Usar TARGET_ARCHITECTURE.md como referencia principal.
2. Aplicar siempre ARCHITECTURE_RULES.md.
3. Ejecutar MIGRATION_PLAN.md en orden.
4. Consultar ARCHITECTURE_AUDIT.md solo para entender el diagnóstico original.

Próximo Paso Recomendado

El siguiente paso técnico, cuando se decida continuar, es iniciar el Paso 1 del plan:

• Congelar comportamiento.
• Capturar screenshots de overlays.
• Crear fixtures de replicants.
• Registrar baseline de build, typecheck y lint.

No empezar moviendo código antes de tener esa baseline.

Riesgos a Recordar

• El sistema de packs es el área de mayor riesgo.
• Los overlays son sensibles a cambios visuales y deben tocarse al final.
• La frontera NodeCG debe centralizarse antes de reescribir features.
• Los replicants de packs deben formalizarse con schemas antes de limpiar runtime.
• Players.vue y Settings.vue deben dividirse, no reescribirse desde cero.

Checks Conocidos

Check	Resultado
vue-tsc	Pasa.
tsc	Pasa.
lint	Falla con 3 errores reales.

Errores lint reales conocidos:

• _id en Players.vue.
• _config en startgg.ts.
• _config en challonge.ts.

Los demás avisos conocidos son warnings de formato Vue.

Instrucción para Futuras Sesiones

No reanalizar el proyecto desde cero salvo que el código haya cambiado de forma sustancial. Continuar desde estos documentos y ejecutar el plan en orden.