teefayb/claude-code-setup-demo

Altere o modelo de dados: $ARGUMENTS

Os dados armazenados residem em arquivos JSON que já existem nas máquinas dos colegas e no servidor, portanto, toda alteração deve ler arquivos antigos sem quebrá-los.

Etapas

1. Leia src/lib/links/schema.ts, src/lib/links/store.ts e data/seed.json.
2. Decida se a mudança é aditiva (novo campo opcional com valor padrão) ou crítica (renomear, remover, novo campo obrigatório, alteração de tipo).
   • Aditiva: adicione o campo com .optional() ou .default(...) ao linkSchema, e também ao linkInputSchema se os usuários puderem defini-lo. Sem incremento de versão.
   • Crítica: incremente o literal version do arquivo de dados (ex.: 1 → 2). Mantenha o esquema antigo como dataFileV1Schema e adicione uma função upgradeV1toV2(data) em store.ts que load() aplica ao ler um arquivo v1. Nunca reescreva arquivos durante a leitura; o próximo save() escreve v2.
3. Atualize data/seed.json para o novo formato.
4. Atualize a interface somente se a tarefa exigir.
5. Testes em src/lib/links/store.test.ts:
   • O novo campo passa por createLink e listLinks sem perdas.
   • Para mudanças críticas: escreva um arquivo v1 no caminho de dados temporário e verifique se listLinks() retorna links atualizados, e que um createLink subsequente salva um arquivo v2.
6. Execute npm run check e npm run build.
7. Em seu resumo, indique se a mudança foi aditiva ou crítica e o que acontece com os arquivos de dados existentes.