Análise de Stack Trace

Você: "Analisa esse erro:
TypeError: Cannot read property 'id' of undefined
    at UserService.getProfile (user.service.ts:45)
    at async UserController.profile (user.controller.ts:23)
    at async Router.handle (router.ts:156)"

Agente:
 Análise do Erro

**Causa provável:** 
O usuário retornado do banco é `null/undefined`, mas o código 
tenta acessar `.id` sem verificar.

**Localização:** 
`user.service.ts:45` - método `getProfile`

**Cenário reproduzível:**
- Usuário deletado mas sessão ainda ativa
- ID de usuário inválido passado
- Race condition no cache

**Solução sugerida:**
```typescript
// user.service.ts:45
const user = await this.userRepo.findById(id);
if (!user) {
  throw new NotFoundException(`User ${id} not found`);
}
return user.id; // Agora seguro

Prevenção:

• Adicione verificação de null
• Considere strict null checks no TS
• Adicione teste para usuário não encontrado

Quer que eu crie um PR com essa correção?

#### Debug de Performance

Você: “API /users tá lenta, 3s de resposta”

Agente: Investigando latência de /users…

Analisando últimas 100 requests:

• P50: 2.8s
• P95: 4.2s
• P99: 5.1s

Breakdown por etapa:

1. Auth middleware: 15ms ✓
2. Database query: 2.650ms Não
3. Serialização: 120ms ⚠
4. Response: 5ms ✓

Problema identificado: Query N+1 no banco

-- Query atual (executada 1 + N vezes)
SELECT * FROM users WHERE id = ?
SELECT * FROM orders WHERE user_id = ?
SELECT * FROM orders WHERE user_id = ?
... (repetido para cada user)

-- Query otimizada (1 query com JOIN)
SELECT users.*, orders.* 
FROM users 
LEFT JOIN orders ON users.id = orders.user_id

Impacto estimado: 2.8s → 200ms

Quer que eu implemente a correção?

### 5. Automação de Tarefas

#### CI/CD Completo

“Quando PR for aprovado, faça merge automático” “Se testes falharem, comente no PR com o erro” “Toda sexta às 18h, crie release notes da semana” “Se staging estiver estável por 24h, promova para prod”

#### Manutenção Automática

“Toda segunda, verifique dependências desatualizadas” “Se houver vulnerabilidade crítica, crie issue” “Limpe branches mergadas há mais de 30 dias” “Arquive issues sem atividade há 90 dias”

### 6. Documentação Automática

#### Gerar Docs do Código

Você: “Documenta a função processPayment em payment.service.ts”

Agente: Documentação gerada:

/**
 * Processa pagamento de um pedido.
 * 
 * @param orderId - ID único do pedido
 * @param paymentMethod - Método de pagamento (credit_card, pix, boleto)
 * @param amount - Valor em centavos
 * 
 * @returns PaymentResult com status e transactionId
 * 
 * @throws PaymentGatewayError - Falha na comunicação com gateway
 * @throws InsufficientFundsError - Saldo insuficiente
 * @throws InvalidPaymentMethodError - Método não suportado
 * 
 * @example
 * const result = await processPayment('ord_123', 'pix', 10000);
 * // result: { status: 'approved', transactionId: 'tx_456' }
 */

Quer que eu adicione isso ao código?

#### Changelog Automático

Você: “Gera changelog da última semana”

Agente: Changelog - Semana 04/2026

---

## Setup Recomendado

### Integrações Essenciais

```yaml
# config.yaml para devs
integrations:
  github:
    token: "${GITHUB_TOKEN}"
    repos:
      - "empresa/backend"
      - "empresa/frontend"
    notifications:
      - pull_request
      - check_run
      - deployment
  
  vercel:
    token: "${VERCEL_TOKEN}"
    
  sentry:
    dsn: "${SENTRY_DSN}"
    alert_threshold: "error"
    
  slack:
    webhook: "${SLACK_DEPLOY_WEBHOOK}"
    channel: "#deployments"

# SOUL.md - Assistente Dev

## Identidade
Você é um dev sênior assistindo outro dev. 
Direto ao ponto, técnico, sem enrolação.

## Comportamento
- Código > texto quando possível
- Sugira melhorias proativamente
- Alerte sobre problemas de segurança
- Use terminologia técnica correta

## Stack do Projeto
- Backend: Node.js 20, TypeScript, NestJS
- Database: PostgreSQL 16, Redis
- Infra: AWS (ECS, RDS, ElastiCache)
- CI/CD: GitHub Actions, Vercel
- Monitoramento: Sentry, Datadog

## Preferências
- Commits semânticos (feat:, fix:, chore:)
- PRs pequenos e focados
- Testes antes de merge
- Docs atualizadas

## Contexto
Repositórios ativos:
- empresa/api - Backend principal
- empresa/web - Frontend Next.js
- empresa/mobile - React Native

# HEARTBEAT.md - Verificações Automáticas

## A cada 30 minutos
- Ping em api.seusite.com (alerta se > 500ms ou erro)
- Verificar novos erros no Sentry (críticos)
- Status dos deploys em andamento

## A cada 4 horas  
- Checar PRs aguardando review há mais de 24h
- Verificar branches com CI falhando
- Uso de recursos (CPU, RAM, disco)

## Diariamente (09:00)
- Relatório de produção
- PRs abertos precisando atenção
- Dependências com vulnerabilidades

## Skill: Deploy Notifier

Quando: "deploy [branch] para [ambiente]"

1. Notifica no Slack: " Deploy iniciado por @user"
2. Executa pipeline:
   - git pull
   - npm ci
   - npm test
   - npm build
   - deploy
3. Health check (3 tentativas)
4. Se sucesso: "Sim Deploy concluído" + métricas
5. Se falha: "Não Deploy falhou" + logs + auto-rollback

## Skill: PR Reviewer

Quando: PR é aberto

1. Analisa arquivos alterados
2. Roda linters e checkers
3. Identifica:
   - Problemas de segurança
   - Code smells
   - Testes faltando
   - Docs desatualizadas
4. Comenta no PR com findings
5. Aprova automaticamente se:
   - < 50 linhas alteradas
   - Só arquivos de config
   - Testes passando
   - Sem security issues

## Skill: Incident Responder

Quando: Erro crítico detectado

1. Coleta informações:
   - Stack trace
   - Request que causou
   - Usuário afetado
   - Frequência
2. Cria issue no GitHub com template
3. Notifica on-call no Slack/PagerDuty
4. Se error_rate > 10%: sugere rollback
5. Documenta timeline do incidente

"Lista PRs abertos"
"Status do CI na branch develop"
"Merge PR 123 quando CI passar"
"Cria branch hotfix/bug-login"
"Cherry-pick commit abc123 para main"
"Quem commitou mais essa semana?"

"Deploy staging"
"Status de produção"
"Escala API para 5 instâncias"
"Logs dos últimos 30 minutos"
"Reinicia container web"
"Quanto de disco livre no servidor?"

"Explica esse erro: [stack trace]"
"Por que /api/users está lento?"
"Queries mais pesadas da última hora"
"Diferença entre versão 2.3 e 2.4"
"Quais endpoints não têm testes?"

"Documenta essa função"
"Gera README para este projeto"
"Changelog da última release"
"Quais endpoints da API existem?"
"Diagrama de arquitetura do sistema"

services:
  api:
    repo: "empresa/api"
    deploy_cmd: "deploy-api.sh"
  web:
    repo: "empresa/web"  
    deploy_cmd: "vercel deploy"
  worker:
    repo: "empresa/worker"
    deploy_cmd: "docker-compose up -d"