Scripts e comandos

⚠️ Arquivo gerado por pnpm docs:generate. Não edite à mão — o próximo build o sobrescreve.

Fonte: o package.json de cada pacote e o Makefile da raiz.

Raiz — package.json

comando executa
pnpm docs:start pnpm docs:site && pnpm docs:serve
pnpm docs:build pnpm docs:site && pnpm docs:site:check
pnpm docs:serve python3 -m http.server 3000 -d build/docs-site
pnpm docs:clear rm -rf build/docs-site
pnpm docs:site node scripts/docs/site/build.mjs
pnpm docs:site:check node scripts/docs/site/links.mjs && node scripts/docs/links-do-locale.mjs build/docs-site && node scripts/docs/faixa-de-traducao-check.mjs build/docs-site
pnpm docs:generate node scripts/docs/generate.mjs
pnpm docs:openapi-textos node scripts/docs/openapi-textos.mjs
pnpm docs:landing node scripts/docs/landing.mjs
pnpm docs:check node scripts/docs/docmap.mjs && node scripts/docs/generate.mjs --check
pnpm docs:drift node scripts/docs/drift.mjs
pnpm docs:audit node scripts/docs/audit.mjs
pnpm docs:fontes bash scripts/docs/montar-layout.sh
pnpm test:scripts vitest run scripts/docs scripts/dev/install- scripts/ci/assets-do-instalador scripts/ci/montar-images --exclude scripts/docs/openapi-por-locale.spec.ts

api — apps/api/package.json

comando executa
pnpm --filter api build nest build
pnpm --filter api format prettier --write "src/**/*.ts" "test/**/*.ts"
pnpm --filter api start nest start
pnpm --filter api start:dev nest start --watch
pnpm --filter api start:debug nest start --debug --watch
pnpm --filter api start:prod node dist/main
pnpm --filter api lint eslint "src/**/*.ts" "test/**/*.ts" --max-warnings 0
pnpm --filter api test vitest run
pnpm --filter api typecheck tsc -p tsconfig.build.json --noEmit
pnpm --filter api test:watch vitest
pnpm --filter api test:cov vitest run --coverage
pnpm --filter api seed ts-node src/db/seed.ts
pnpm --filter api openapi:export ts-node src/scripts/export-openapi.ts
pnpm --filter api demo:repo-bootstrap ts-node scripts/demo-repo-bootstrap.ts
pnpm --filter api demo:noop-execution ts-node scripts/demo-noop-execution.ts
pnpm --filter api demo:dev-agent-real ts-node scripts/demo-dev-agent-real.ts
pnpm --filter api demo:pr-gates ts-node scripts/demo-pr-gates.ts
pnpm --filter api demo:pr-gates-area-qa ts-node scripts/demo-pr-gates-area-qa.ts
pnpm --filter api golden-set:qa-seed ts-node scripts/seed-golden-set-qa.ts
pnpm --filter api golden-set:rag-seed ts-node scripts/seed-golden-set-rag.ts
pnpm --filter api demo:infra-agent ts-node scripts/demo-infra-agent.ts
pnpm --filter api demo:infra-workflows-github ts-node scripts/demo-infra-workflows-github.ts
pnpm --filter api demo:psicologo ts-node scripts/demo-psicologo.ts
pnpm --filter api demo:anamnese ts-node scripts/demo-anamnese.ts
pnpm --filter api validacao:fase-12 ts-node scripts/validacao-fase-12.ts
pnpm --filter api validacao:real ts-node scripts/validacao-real.ts
pnpm --filter api validacao:gates ts-node scripts/validacao-gates.ts
pnpm --filter api medir:execucao ts-node scripts/medir-execucao.ts
pnpm --filter api medir:rag ts-node scripts/medir-rag.ts
pnpm --filter api analise:funil ts-node scripts/analise-funil.ts
pnpm --filter api relatorio:seguranca-runtime ts-node scripts/relatorio-seguranca-runtime.ts
pnpm --filter api relatorio:telemetria ts-node scripts/relatorio-telemetria.ts
pnpm --filter api gerar:areas ts-node scripts/gerar-areas.ts
pnpm --filter api lint:migracao ts-node scripts/lint-migracao.ts
pnpm --filter api relatorio:backup ts-node scripts/relatorio-backup.ts
pnpm --filter api migrar-projeto-para-trunk ts-node src/scripts/migrar-projeto-para-trunk.ts
pnpm --filter api grafo:reprojetar ts-node src/scripts/reprojetar-grafo.ts
pnpm --filter api artefatos:reprojetar ts-node src/scripts/reprojetar-artefatos.ts
pnpm --filter api db:generate drizzle-kit generate
pnpm --filter api db:migrate drizzle-kit migrate
pnpm --filter api lint:fix eslint "{src,apps,libs,test}/**/*.ts" --fix

web — apps/web/package.json

comando executa
pnpm --filter web dev vite
pnpm --filter web build tsc -b && vite build
pnpm --filter web typecheck tsc -b --force
pnpm --filter web lint oxlint
pnpm --filter web preview vite preview
pnpm --filter web test vitest run
pnpm --filter web openapi:types openapi-typescript fixados/openapi.json -o src/lib/api-types.generated.ts
pnpm --filter web openapi:types:check openapi-typescript fixados/openapi.json -o src/lib/api-types.generated.ts --check
pnpm --filter web areas:baixar node scripts/baixar-areas.mjs

runner — apps/runner/package.json

comando executa
pnpm --filter @brabo/runner start node --import ./scripts/strip-node-modules.mjs src/index.ts
pnpm --filter @brabo/runner build tsup
pnpm --filter @brabo/runner build:bin node scripts/build-bin.mjs
pnpm --filter @brabo/runner smoke node scripts/smoke-dist.mjs
pnpm --filter @brabo/runner smoke:bin node scripts/smoke-bin.mjs
pnpm --filter @brabo/runner test vitest run
pnpm --filter @brabo/runner typecheck tsc --noEmit
pnpm --filter @brabo/runner lint oxlint --deny-warnings src scripts

broker — apps/broker/package.json

comando executa
pnpm --filter @brabo/broker start tsup && node dist/index.cjs
pnpm --filter @brabo/broker build tsup
pnpm --filter @brabo/broker test vitest run
pnpm --filter @brabo/broker typecheck tsc --noEmit
pnpm --filter @brabo/broker lint oxlint --deny-warnings src tsup.config.ts vitest.config.ts

docker-port — packages/docker-port/package.json

comando executa
pnpm --filter @brabo/docker-port build tsc -p tsconfig.build.json
pnpm --filter @brabo/docker-port test vitest run
pnpm --filter @brabo/docker-port typecheck tsc --noEmit
pnpm --filter @brabo/docker-port lint oxlint --deny-warnings src vitest.config.ts

e2e — e2e/package.json

comando executa
pnpm --dir e2e test playwright test
pnpm --dir e2e test:headed playwright test --headed
pnpm --dir e2e relatorio playwright show-report
pnpm --dir e2e navegadores playwright install --with-deps chromium
pnpm --dir e2e typecheck tsc --noEmit

scripts — scripts/package.json

comando executa
pnpm --filter scripts test vitest run
pnpm --filter scripts typecheck tsc --noEmit && tsc --noEmit -p idioma && tsc --noEmit -p jev/vivo
pnpm --filter scripts idioma:medir node --disable-warning=MODULE_TYPELESS_PACKAGE_JSON idioma/medir.ts
pnpm --filter scripts idioma:extrair node --disable-warning=MODULE_TYPELESS_PACKAGE_JSON idioma/extrair.ts
pnpm --filter scripts idioma:rotular node --disable-warning=MODULE_TYPELESS_PACKAGE_JSON idioma/rotular.ts
pnpm --filter scripts jev:replay node jev/replay.ts
pnpm --filter scripts jev:analise node --disable-warning=MODULE_TYPELESS_PACKAGE_JSON jev/analise.ts
pnpm --filter scripts jev:menu node --disable-warning=MODULE_TYPELESS_PACKAGE_JSON jev/menu-relatorio.ts
pnpm --filter scripts jev:vivo node --disable-warning=MODULE_TYPELESS_PACKAGE_JSON jev/vivo/vivo.ts
pnpm --filter scripts idioma:validar node --disable-warning=MODULE_TYPELESS_PACKAGE_JSON idioma/validar.ts
pnpm --filter scripts idioma:diagnosticar node --disable-warning=MODULE_TYPELESS_PACKAGE_JSON idioma/diagnostico-haiku.ts
pnpm --filter scripts idioma:revisar node --disable-warning=MODULE_TYPELESS_PACKAGE_JSON idioma/revisao.ts

Makefile

alvo faz
make dev Brings up the dev environment (preflight + docker compose up) from the sibling clones
make help Lists the available targets
make deploy-local Brings up the local cluster, installs everything and runs the smoke test (TAG=vX.Y.Z-qa.N optional)
make deploy-local-clean Same as deploy-local, but without rebuilding the images
make imagens-do-release Applies the digests from .release/images.json to an overlay (OVERLAY=prod
make smoke-k8s Runs only the smoke test against the cluster already up
make hpa-test Fills the Oban queue and proves the engine's HPA scales
make rollout-test Opens active sessions, does a rollout restart and proves none is orphaned
make test-restore Triggers a real backup, restores it into a new database and validates it
make test-restore-mutacao Breaks the restore on purpose (dump without a table) and requires the proof to catch it
make test-restore-compose Same proof as test-restore, against docker compose (no cluster); BRABO_ENV_FILE passes the installation .env
make test-reprojecao Wipes a graph scenario, reprojects it from the event log and compares counts (needs Neo4j up)
make test-reprojecao-k8s Same proof as test-reprojecao, inside the local cluster (needs make deploy-local first)
make test-reprojecao-artefatos-k8s Wipes an artifact file inside the cluster, reprojects it from the event log and compares it (needs make deploy-local first)
make test-rotacao-chave-mestra-k8s Rehearses the master key rotation (three runbook steps) inside the local cluster (needs make deploy-local first; leaves the cluster on a new key)
make k8s-validate Renders the overlays and validates them against the Kubernetes schema
make k8s-logs Last lines from each workload
make k8s-down Removes the local cluster

116 comandos no total. Alvo do Makefile sem a anotação ## descrição não aparece aqui — anote-o na fonte.