Comece aqui

Use as ferramentas de referência do monorepo hoje. Os pacotes ainda não estão no npm público — clone o repositório e rode a CLI localmente. Requisitos: Node.js 20+, Git.

1. Clonar e instalar

git clone https://github.com/eudameron/aiparlance.git
cd aiparlance
npm ci
npm run build

Isso compila @aiparlance/parser, validator, cli e os emitters em prévia (sql, openapi, typescript, go, mysql, workers, python, php, docs, tests).

2. Rodar a CLI

O binário fica em packages/cli/dist/cli.js após o build:

node packages/cli/dist/cli.js --help

Comando	O que faz
`aip parse <file.aip>`	Imprime o AST em JSON
`aip validate <file.aip>`	Checagens semânticas (MUST) — Core + Infra + Security + Behavior
`aip emit sql <file.aip>`	DDL PostgreSQL (+ índices / seeds quando houver)
`aip emit openapi <file.aip>`	OpenAPI 3.0.3 JSON
`aip emit typescript <file.aip>`	Interfaces TypeScript + type guards
`aip emit go <file.aip>`	Structs Go + handlers finos + middleware de auth
`aip emit mysql <file.aip>`	DDL MySQL (`database mysql`)
`aip emit workers <file.aip>`	Stubs de jobs / filas
`aip emit python <file.aip>`	Dataclasses Python
`aip emit php <file.aip>`	Classes PHP
`aip emit docs <file.aip>`	Referência API em Markdown
`aip emit tests <file.aip>`	Fixtures de teste CRUD

Experimente o exemplo mínimo

node packages/cli/dist/cli.js validate examples/minimal.aip
node packages/cli/dist/cli.js emit sql examples/minimal.aip
node packages/cli/dist/cli.js emit openapi examples/minimal.aip
node packages/cli/dist/cli.js emit typescript examples/minimal.aip
node packages/cli/dist/cli.js emit go examples/minimal.aip

Grave a saída em arquivo:

node packages/cli/dist/cli.js emit sql examples/minimal.aip > /tmp/minimal.sql
node packages/cli/dist/cli.js emit openapi examples/minimal.aip > /tmp/minimal.openapi.json
node packages/cli/dist/cli.js emit typescript examples/minimal.aip > /tmp/minimal.ts
node packages/cli/dist/cli.js emit go examples/minimal.aip > /tmp/minimal.go

Passo a passo CRUD completo (entidades, policies, API, seeds, emit): Passo a passo CRUD.

Caminho feliz do blog CRUD (TypeScript + SQL + OpenAPI)

export DATABASE_URL=postgres://postgres:postgres@127.0.0.1:5432/aiparlance
export AIP_JWT_SECRET=dev-secret
node packages/cli/dist/cli.js validate examples/blog-crud.aip
node packages/cli/dist/cli.js emit sql examples/blog-crud.aip | psql "$DATABASE_URL"
node packages/cli/dist/cli.js emit typescript examples/blog-crud.aip > /tmp/blog-app.ts
# npm i zod pg jose  (peers do app gerado)
npx tsx -e "import { listenCrudApp } from '/tmp/blog-app.ts'; listenCrudApp()"

GET /v1/posts é público; rotas de escrita pedem Authorization: Bearer <JWT> (signCrudToken no arquivo gerado). Sem DATABASE_URL o app fica em memória.

3. Escreva seu próprio `.aip`

Toda spec v0.1 precisa de um bloco app primeiro, depois entity / crud / validation (Core). Veja Sintaxe e examples/.

app Demo @0.1 {
  database postgres
}

entity User {
  name: string required
  email: email required unique
}

crud User

Salve como my-app.aip e então:

node packages/cli/dist/cli.js validate my-app.aip
node packages/cli/dist/cli.js emit sql my-app.aip

Exemplos mais ricos (blog-crud.aip, crm-reference.aip, ops-reference.aip, inventory-crud.aip) incluem Infra / Security / Behavior e fazem parse + validate com as ferramentas de referência v0.1 completa. Use mysql-minimal.aip para aip emit mysql.

4. Rodar a suíte de testes

Na raiz do repositório:

npm test

Isso faz typecheck/build dos workspaces e roda o Vitest (parser, validator, emitters, CLI e CI de examples). Só examples:

npm run check:examples

Typecheck sem testes:

npm run typecheck

5. O que já está disponível vs o que é prévia

Status	Alvos
Prévia (no monorepo)	PostgreSQL, MySQL, OpenAPI 3, TypeScript, Go, Python, PHP, Workers, Docs, Testes
Foco Phase D	Aprofundar TypeScript, OpenAPI, PostgreSQL → caminho feliz executável; depois playground + npm
Só ilustrativo	Playground do site — não são os pacotes oficiais

Opcional: docs e site localmente

# Docs (Mintlify)
cd docs && npx mintlify dev

# Site de marketing
cd site && npm ci && npm run build:prod

Visão geral

Exemplos

Emitters

Referência

Domínios

IA

Comece aqui

Comece aqui

1. Clonar e instalar

2. Rodar a CLI

Experimente o exemplo mínimo

Caminho feliz do blog CRUD (TypeScript + SQL + OpenAPI)

3. Escreva seu próprio `.aip`

4. Rodar a suíte de testes

5. O que já está disponível vs o que é prévia

Opcional: docs e site localmente

​Comece aqui

​1. Clonar e instalar

​2. Rodar a CLI

​Experimente o exemplo mínimo

​Caminho feliz do blog CRUD (TypeScript + SQL + OpenAPI)

​3. Escreva seu próprio .aip

​4. Rodar a suíte de testes

​5. O que já está disponível vs o que é prévia

​Opcional: docs e site localmente

Comece aqui

1. Clonar e instalar

2. Rodar a CLI

Experimente o exemplo mínimo

Caminho feliz do blog CRUD (TypeScript + SQL + OpenAPI)

3. Escreva seu próprio `.aip`

4. Rodar a suíte de testes

5. O que já está disponível vs o que é prévia

Opcional: docs e site localmente