# 1. Instalar dependências
cd workers/agent-api
npm install

# 2. Gerar tipos Cloudflare a partir do wrangler.jsonc
npx wrangler types

# 3. Copiar e preencher secrets locais
cp .dev.vars.example .dev.vars
# editar .dev.vars com API_KEY_ENCRYPTION_SECRET

# 4. Aplicar migrations no banco local
npm run migrate:local

# 5. Iniciar Worker local
npm run dev

workers/agent-api/
├── wrangler.jsonc          ← configuração com todos os bindings e environments
├── package.json
├── tsconfig.json
├── vitest.config.ts
├── .dev.vars.example       ← copiar para .dev.vars (não commitar)
├── src/
│   ├── index.ts            ← entry point (Hono app)
│   ├── types.ts            ← Env + FormationStatus + tipos compartilhados
│   ├── config/
│   │   └── jurisdictions.ts ← dados estáticos: WY, MI, NV, BVI, PA, UAE
│   ├── routes/
│   │   ├── health.ts
│   │   ├── jurisdictions.ts
│   │   └── openapi.ts
│   ├── middleware/
│   │   ├── cors.ts
│   │   ├── errors.ts
│   │   └── trace.ts
│   └── lib/
│       ├── crypto.ts       ← geração de IDs, hash, HMAC, timing-safe compare
│       ├── logger.ts       ← JSON estruturado, sanitização de PII
│       └── response.ts     ← helpers de resposta padronizados
├── migrations/
│   └── agent-db/
│       ├── 0001_initial_schema.sql   ← api_keys, formations, events, idempotency, webhooks
│       └── 0002_usage_tracking.sql   ← usage_daily, admin_actions
└── tests/
    └── health.test.ts

# Staging
npm run deploy:staging

# Produção (BLOQUEADO até live gate checklist)
# Ver: docs/plano-agentes-heitor/plano-definitivo/10-PLANO-DE-INICIO-ENG.md
npm run deploy:production:force  # apenas com aprovação explícita

npm run test           # run once
npm run test:watch     # watch mode
npm run test:coverage  # with coverage

npm run migrate:local    # aplica no banco local (dev)
npm run migrate:staging  # aplica no AGENT_DB remoto (staging)
npm run migrate:list     # lista migrations e status