# TSK-0003 — infraestrutura transacional SQLite

Implementado SqliteDatabase e sqlite/schema-v1.sql: inicialização explícita, marca de aplicação/schema, chaves de identidade/propriedade/revisão/referência e contador local; foreign keys por conexão, WAL/FULL, BEGIN IMMEDIATE para escrita, leitura readonly e consistente, busy timeout limitado. Transações aninhadas compartilham conexão e falha interna impede commit parcial mesmo quando capturada. Abertura não cria base ausente; versões futuras, symlinks e sidecars indevidos são recusados. Campos/tabelas específicos do domínio serão integrados nas TSKs seguintes; CLI ainda não usa SQLite para Works.

Validação executada nesta sessão:
- ./gradlew test --tests net.intrepid.aiengineering.SqliteDatabaseTest --tests net.intrepid.aiengineering.ArchitectureTest --console=plain: BUILD SUCCESSFUL; 12 testes SQLite e 1 teste de arquitetura, zero falhas/erros/skips.
- Casos observados: rollback em falha de FK; publicação conjunta com referências diferidas; falha aninhada capturada não comita; leitura readonly; snapshot estável enquanto outro escritor comita; lock com espera limitada a 75 ms e diagnóstico; schema futuro; nomes de diretório com espaço/?/#/UTF-8; recusa de symlinks e sidecar órfão.
- Prova Native Image recompilada com infraestrutura e recurso de schema: BUILD SUCCESSFUL. scripts/sqlite-probe.sh passou criação e reabertura do schema em processos separados, além de UTF-8, rollback e biblioteca externa, com extração desabilitada. Ausência da biblioteca falha conforme esperado.
- Uma ambiguidade de inferência de tipos no código do teste foi corrigida antes da execução bem-sucedida.
- git diff --check passou.

Arquivos principais: SqliteDatabase.java, sqlite/schema-v1.sql, SqliteDatabaseTest.java, NativeHints.java, build.gradle.kts, src/sqliteProbe e docs/sqlite-migration-design.md.

Nenhuma instalação, ativação de backend no workspace real, migração de consumidores ou descarte de evidências legadas foi feito. Próxima ação: TSK-0004, persistir Works e investigação.
