teefayb/claude-code-setup-demo

Cambiar el modelo de datos: $ARGUMENTS

Los datos almacenados residen en archivos JSON que ya existen en las máquinas de los compañeros y en el servidor, por lo que cada cambio debe leer archivos antiguos sin romper nada.

Pasos

1. Lee src/lib/links/schema.ts, src/lib/links/store.ts y data/seed.json.
2. Decide si el cambio es aditivo (nuevo campo opcional con un valor por defecto) o disruptivo (renombrar, eliminar, nuevo campo obligatorio, cambio de tipo).
   • Aditivo: agrega el campo con .optional() o .default(...) a linkSchema, y también a linkInputSchema si los usuarios pueden establecerlo. Sin incremento de versión.
   • Disruptivo: incrementa el literal version del archivo de datos (por ejemplo, 1 → 2). Mantén el esquema antiguo como dataFileV1Schema, y añade una función upgradeV1toV2(data) en store.ts que load() aplique cuando lea un archivo v1. Nunca sobrescribas archivos al leer; el siguiente save() escribe v2.
3. Actualiza data/seed.json a la nueva forma.
4. Actualiza la interfaz de usuario solo si la tarea lo solicita.
5. Pruebas en src/lib/links/store.test.ts:
   • El nuevo campo viaja de ida y vuelta a través de createLink y listLinks.
   • Para cambios disruptivos: escribe un archivo v1 en la ruta de datos temporales y verifica que listLinks() devuelva enlaces actualizados, y que un createLink posterior guarde un archivo v2.
6. Ejecuta npm run check y npm run build.
7. En tu resumen, indica si el cambio fue aditivo o disruptivo, y qué sucede con los archivos de datos existentes.