Emitter PostgreSQL


Pacote	`@aiparlance/sql`
CLI	`aip emit sql`
Papel	`schema`
Nota	15/23 (65%)
Nível	Fatia sólida
Ficha de maturidade	transpilers/sql/EMITTER_OBJECTIVES.md

Avaliado pelo checklist mestre (55 IDs, v2 · 2026-08-06).

Resumo

✅ Passou	⚠️ Parcial	❌ Falhou	➖ N/A
15	1	7	32

Itens N/A estão fora do papel schema e não entram no denominador da nota.

DDL PostgreSQL: CREATE TABLE, índices, seeds. SQL principal.

ID	Objetivo
`A1`	Gerar as estruturas da entidade (types / structs / schemas / tables) a partir de `entity`
`A4`	Gerar enums / variantes restritas a partir de `enum(…)`
`A5`	Gerar `belongs_to` como FKs ou referências
`A6`	Gerar a chave primária implícita `id`
`A7`	Gerar `timestamps` (`created_at` / `updated_at`)
`A8`	Gerar campo/coluna `soft_delete` (`deleted_at`)
`B1`	Respeitar `required` / `optional`
`B2`	Respeitar `unique`
`C1`	Schema persistente (DDL ou ORM / modelos de query)
`C2`	Índices a partir de `index { }`
`C3`	Seeds a partir de `seed { }`
`C6`	Respeitar o alvo definido em `app.database`
`H3`	Golden / CI para `minimal.aip` (ou equivalente no alvo)
`H4`	O emit funciona nos examples full-tier correspondentes sem crash
`H5`	Nomenclatura alinhada à documentação (tabelas no plural, `*_id`, snake_case)

ID	Objetivo
`B4`	Mapear tipos semânticos (`email`, `phone`, …) de forma distinta

ID	Objetivo
`A9`	Semântica de soft-delete (leituras padrão filtram linhas deletadas)
`B3`	Aplicar `validation { }` além de marcar campos como obrigatórios
`C4`	Migrations versionadas (up ordenado)
`C5`	Migration down / rollback
`C7`	Transações para writes multi-statement / de workflow
`H1`	Documentação legível de API / domínio
`H2`	Fixtures ou scaffolds de testes automatizados

Ficha de maturidade completa (incluindo ➖ N/A): transpilers/sql/EMITTER_OBJECTIVES.md.

Vitest do pacote + golden transpilers/sql/fixtures/minimal.sql. CI do repo cobre minimal.aip e seeds/índices em exemplos ricos.

npm test
node packages/cli/dist/cli.js emit sql examples/blog-crud.aip