Conflito de Migração Drizzle

Use esta habilidade para ajudar um usuário a diagnosticar, reparar e prevenir conflitos de migração do Drizzle Kit em um repositório com múltiplos desenvolvedores. As migrações Drizzle codificam tanto SQL quanto snapshots de migração, então a resposta segura depende da forma atual do diretório de migração, da versão do Drizzle Kit e do estado do git.

Quando Usar Esta Habilidade

• Use quando arquivos de migração Drizzle, _journal.json, ou snapshot.json entrarem em conflito após um pull, merge, rebase ou atualização de PR.
• Use quando drizzle-kit check relatar migrações não comutativas ou conflitos na pasta de migração.
• Use quando uma equipe desejar um fluxo de reparo seguro para migrações Drizzle geradas após a convergência de alterações de esquema.
• Use ao projetar políticas de CI ou fila de merge para prevenir conflitos repetidos de migração Drizzle.

Regras de Segurança

• Comece no modo de diagnóstico somente leitura, a menos que o usuário peça explicitamente para corrigir arquivos.
• Não execute drizzle-kit migrate, drizzle-kit push, scripts de seed de banco de dados, ou qualquer comando que se conecte a um banco de dados ativo, a menos que o usuário solicite explicitamente e o alvo esteja claro.
• Trate drizzle-kit check, typechecks do projeto e testes como execução de comandos que podem carregar configurações do projeto, variáveis de ambiente ou scripts. Inspecione scripts/configurações primeiro e exija um alvo explícito não produtivo ou descartável antes de qualquer validação baseada em DB.
• Não exclua arquivos de migração, reescreva _journal.json, ou execute git checkout --ours, git checkout --theirs, git restore, ou rm, a menos que o usuário tenha confirmado o lado exato e os arquivos a serem alterados.
• Não recomende drizzle-kit push como a solução de produção para conflitos de migração; isso pula o histórico de migração auditável que as equipes precisam.
• Trate --ignore-conflicts como uma exceção para um falso positivo conhecido, não como a correção normal.
• Preserve as alterações no código fonte do esquema, a menos que o usuário peça explicitamente para descartá-las. O reparo de conflitos normalmente descarta as migrações geradas e as regenera a partir do esquema mesclado.
• Se ours e theirs puderem significar branches diferentes dependendo da direção do merge, peça ao usuário para identificar o branch pai antes de sugerir comandos de checkout.

Referências Necessárias

• Leia references/sources.md quando a resposta depender do comportamento atual do Drizzle, orientação oficial ou um dos links externos preservados.
• Leia references/conflict-resolution.md antes de recomendar um fluxo de reparo.
• Leia references/ci-policy.md antes de propor alterações de CI, fila de merge ou fluxo de trabalho da equipe.
• Leia references/report-template.md antes de escrever um relatório de diagnóstico.

Referências de Origem

A lista completa de documentação oficial, discussões do GitHub do Drizzle, scripts da comunidade e referências de fila de merge vive em references/sources.md com níveis de confiança e ressalvas. Leia esse arquivo sempre que a resposta depender do comportamento atual do Drizzle. Reavalie a documentação oficial e a discussão mais relevante quando a versão principal drizzle-kit do projeto mudar, pois os internos de migração (formato do snapshot, forma do journal, semântica de drizzle-kit check) mudaram entre as versões.

Seleção de Modo

Classifique a tarefa primeiro:

1. Diagnosticar - O usuário tem um conflito ou drizzle-kit check falhou e quer entendê-lo.
2. Reparar - O usuário pede explicitamente para corrigir ou regenerar arquivos de migração.
3. Fortalecimento de CI - O usuário quer prevenir conflitos futuros em PRs ou filas de merge.
4. Explicar - O usuário quer uma resposta conceitual ou um playbook para a equipe.

Quando o modo não for explícito, escolha Diagnosticar.

Cada modo desbloqueia um conjunto específico de ações. Não cruze essas fronteiras sem um upgrade explícito:

• Diagnosticar - somente leitura. Execute git status, git ls-files -u, o script auxiliar e inspeção de arquivos. Não execute drizzle-kit check, typechecks, testes ou qualquer comando de escrita. Relate as descobertas e o caminho de reparo proposto, mas não o execute.
• Reparar - adiciona escrita de arquivos e execução de drizzle-kit generate/check, cada um com portão pelas Regras de Segurança e confirmação explícita dos arquivos exatos e lado (ours/theirs) a serem alterados.
• Fortalecimento de CI - adiciona a proposta ou edição de arquivos de CI/fluxo de trabalho. Não execute comandos de migração contra o banco de dados do usuário para validar o fluxo de trabalho; valide apenas a sintaxe e a lógica do fluxo de trabalho.
• Explicar - apenas conceitual. Nenhum comando contra o repositório além de inspeção opcional somente leitura.

Descoberta de Repositório

Colete fatos do repositório antes de dar comandos:

git status --short
git rev-parse --show-toplevel

…