@girardelli/architect 6.0.0 → 8.2.0

package/.agent/guards/CODE-REVIEW-CHECKLIST.md

@@ -1,94 +0,0 @@
----
-antigravity:
-  trigger: 'on_demand'
-  description: 'Code Review Checklist — Pontos obrigatórios de revisão'
----
-
-# 🔍 CODE REVIEW CHECKLIST — @girardelli/architect
-
-🟡 Projeto Médio (50-200 arquivos)
-
-> **Todo PR deve ser verificado contra este checklist.**
-
-## Obrigatório
-
-```
-□ Código compila sem erros
-□ Todos os testes passam
-□ Cobertura ≥ 80%
-□ Lint sem errors
-□ Nenhum secret hardcoded
-□ Score não regrediu
-```
-
-## Funcional
-
-```
-□ Atende aos critérios de aceite
-□ Edge cases tratados
-□ Erros tratados adequadamente
-□ Não quebra features existentes
-```
-
-## Qualidade
-
-```
-□ Código legível sem comentários explicativos
-□ Naming descritivo e consistente
-□ Sem duplicação (DRY)
-□ Sem magic numbers
-□ Sem any / type: ignore injustificado
-□ Arquivos < 500 linhas
-```
-
-## Segurança
-
-```
-□ Inputs validados
-□ Queries parametrizadas
-□ Auth/authz verificados
-□ Dados sensíveis protegidos
-```
-
-## Checklist Específico para TypeScript
-
-□ `strict: true` em tsconfig (sem any sem justificativa)?
-□ Imports circulares?
-□ Async/await tratado (sem unhandled promises)?
-□ Memory leaks (EventListeners desinscritos)?
-□ Console.log/debugger removidos?
-
-## Itens de Revisão Específicos do Domínio: devtools
-
-□ Fluxo crítico de negócio não quebrou?
-□ Rollback é seguro?
-□ Concorrência tratada?
-□ State final é consistente?
-
-## Itens de Revisão de Integração
-
-□ Endpoint trata todos os status codes esperados?
-□ Validação do payload de entrada?
-
-
-□ Resposta segue o contrato documentado?
-□ Erros retornam mensagens claras?
-□ Rate limiting aplicado?
-□ Logging estruturado?
-
-
-
-## 🔗 Cross-References (Agentes Relacionados)
-
-| Agente | Quando Consultar |
-|--------|-----------------|
-| **Security Auditor** | Review de endpoints, auth, dados sensíveis |
-| **QA Test Engineer** | Verificar cobertura e qualidade dos testes |
-| **Tech Debt Controller** | Avaliar impacto em débito técnico |
-
-> **Regra:** Nunca implementar isoladamente. Sempre verificar se o agente relacionado precisa ser consultado.
-
-
----
-
-**Gerado por Architect v3.1**

package/.agent/guards/PREFLIGHT.md

@@ -1,200 +0,0 @@
----
-antigravity:
-  trigger: 'always_on'
-  globs: ['**/*']
-  description: 'PREFLIGHT — Checklist obrigatório pré-ação para @girardelli/architect'
-  priority: CRITICAL
----
-
-# ✈️ PREFLIGHT — Checklist Pré-Ação
-
-> **NENHUMA ação de código é permitida antes de completar este checklist.**
-> Pular qualquer fase é violação do protocolo.
-
----
-
-## FASE 0: Preparação Mental
-
-Antes de abrir qualquer arquivo:
-
-```
-□ Li e entendi a requisição COMPLETAMENTE
-□ Sei qual WORKFLOW estou seguindo (new-feature / fix-bug / review)
-□ Identifiquei as CAMADAS envolvidas (Backend / Frontend / App / Database)
-□ Tenho CLAREZA sobre o que é esperado como entrega
-□ Se algo não está claro → PAREI e PERGUNTEI ao humano
-```
-
----
-
-## FASE 1: Leitura Obrigatória
-
-```
-□ [00-general.md](../rules/00-general.md)         → Regras de Ouro do projeto
-□ [QUALITY-GATES.md](./QUALITY-GATES.md)           → Métricas e blockers
-□ LESSONS-LEARNED.md (se existir)                   → Erros passados
-□ ERROR-PATTERNS.md (se existir)                    → Padrões de erro conhecidos
-□ BUSINESS-RULES.md (se existir)                    → Regras de negócio do domínio
-```
-
-> **Objetivo:** Não repetir erros e entender o contexto antes de agir.
-
----
-
-## FASE 2: Verificação de Ambiente
-
-```bash
-# Git: verificar branch e status
-git branch --show-current        # NUNCA em main/develop direto
-git status                       # Limpo antes de começar
-git pull origin <branch>         # Sincronizado
-
-# Deps: verificar se está tudo instalado
-npm install
-
-# Build: verificar se compila
-npm run build
-
-# Tests: verificar se passam ANTES de começar
-npm test
-```
-
-```
-□ Branch correta (NUNCA main/develop)
-□ Working tree limpa
-□ Dependências instaladas
-□ Build passando
-□ Testes passando ANTES da minha alteração
-```
-
----
-
-## FASE 3: Verificação de Regras de Negócio
-
-```
-□ Entendo QUEM são os atores afetados
-□ Entendo QUAL é a regra de negócio envolvida
-□ Verifiquei se existe documentação do domínio
-□ Se a feature envolve dinheiro/pagamento → ATENÇÃO REDOBRADA
-□ Se a feature envolve dados pessoais → verificar LGPD/compliance
-□ Se a feature muda um fluxo existente → verificar impacto em features dependentes
-```
-
----
-
-## FASE 4: Before-Code Checklist (por Camada)
-
-### 4A: Backend ✅
-
-```
-□ Entendo a estrutura de módulos existente
-□ Sei onde criar/modificar controllers, services, entities
-□ Verifiquei se já existe código similar (DRY)
-□ DTOs e validações planejados
-□ Tratamento de erros definido
-□ Sei qual padrão de teste usar (unitário + integração)
-□ Migrations planejadas (se houver alteração de banco)
-```
-
-### 4B: Frontend ⬜ (skip se não aplicável)
-
-```
-□ MOCKUP aprovado pelo humano
-□ Entendo o state management utilizado
-□ Sei onde criar/modificar componentes
-□ Verificar padrão visual (cores, fontes, espaçamentos)
-□ Responsividade considerada
-□ Acessibilidade básica (labels, aria, contraste)
-□ Documento de integração do backend disponível
-```
-
-### 4C: Mobile (Flutter) ⬜ (skip se não aplicável)
-
-```
-□ MOCKUP aprovado pelo humano
-□ Entendo a navegação atual do app
-□ Sei onde criar/modificar screens e widgets
-□ Verificar padrão visual do app
-□ Comportamento offline considerado
-□ Documento de integração do backend disponível
-```
-
-### 4D: Database ⬜ (skip se não aplicável)
-
-```
-□ Schema atual compreendido
-□ Migration reversível planejada
-□ Índices necessários identificados
-□ Impacto em queries existentes avaliado
-□ Seed data / fixtures atualizados
-□ Backup strategy para dados existentes
-```
-
----
-
-## FASE 5: Before-Commit
-
-```
-□ Build compila sem erros
-□ TODOS os testes passam (velhos + novos)
-□ Cobertura ≥ 80%
-□ Lint sem warnings
-□ Sem console.log / print() em produção
-□ Sem TODO / FIXME sem issue
-□ Sem secrets hardcoded
-□ Sem arquivos > 500 linhas sem justificativa
-□ Commit message segue padrão (feat: / fix: / refactor: / docs:)
-□ Branch está atualizada com base (rebase se necessário)
-```
-
----
-
-## FASE 6: Before-Done
-
-```
-□ TODOS os critérios de aceite estão cobertos
-□ Score não regrediu: architect score ./src ≥ 70/100
-□ Documentação atualizada (se necessário)
-□ LESSONS-LEARNED atualizado (se descobri algo novo)
-□ PR criado com descrição completa
-□ Code review solicitado
-```
-
----
-
-## 🚩 Red Flags — PARE IMEDIATAMENTE SE:
-
-| Red Flag | Ação |
-|----------|------|
-| Não entendo a requisição | PARAR → Perguntar ao humano |
-| Código que mexo tem 0% de cobertura | PARAR → Escrever testes ANTES |
-| Estou modificando > 10 arquivos | PARAR → Reavaliar escopo |
-| Build quebrou após minha mudança | PARAR → Reverter → Investigar |
-| Estou copiando/colando código | PARAR → Extrair abstração |
-| Estou trabalhando em main/develop | PARAR → Criar branch |
-| Não tenho mockup e a feature tem UI | PARAR → Gate 1 primeiro |
-| Estou escrevendo código sem testes | PARAR → TDD |
-
----
-
-## 🔍 Template de Diagnóstico
-
-Execute antes de qualquer implementação:
-
-```bash
-# Estrutura do projeto
-find . -type f -name "*.ts" | head -30
-
-# Dependências do módulo que vou modificar
-grep -r "import.*from" --include="*.ts" [modulo]/ | head -20
-
-# Testes existentes
-find . -name "*.test.*" -o -name "*.spec.*" -o -name "*_test.*" | head -20
-
-# Score atual
-npx @girardelli/architect score .
-```
-
----
-
-**Gerado por Architect v3.1 · Score: 94/100 · 2026-03-30**

package/.agent/guards/QUALITY-GATES.md

@@ -1,212 +0,0 @@
----
-antigravity:
-  trigger: 'always_on'
-  globs: ['**/*']
-  description: 'QUALITY GATES — Critérios mínimos obrigatórios para @girardelli/architect'
-  priority: CRITICAL
----
-
-# 🚦 QUALITY GATES — @girardelli/architect
-
-> **Sem aprovação em TODOS os gates CRITICAL, nenhuma entrega é aceita.**
-
----
-
-## 🔴 CRITICAL (Obrigatórios — Bloqueiam Merge)
-
-| # | Gate | Critério | Verificação |
-|---|------|----------|-------------|
-| C1 | **Compilação** | Build completa sem erros | `npm run build` |
-| C2 | **Testes** | 100% dos testes passam | `npm test` |
-| C3 | **Lint** | Zero errors (warnings tolerados) | `npm run lint` |
-| C4 | **Cobertura** | ≥ 80% | `npm run test -- --coverage` |
-| C5 | **Segurança** | Zero vulnerabilidades CRITICAL | SECURITY-AUDITOR review |
-| C6 | **Regras de Negócio** | Todos os critérios de aceite cobertos | BDD scenarios green |
-
----
-
-## 🟡 IMPORTANT (Esperados — Devem ser justificados se ausentes)
-
-| # | Gate | Critério |
-|---|------|----------|
-| I1 | **Documentação** | API documentada, README atualizado se necessário |
-| I2 | **Code Review** | Pelo menos 1 revisor aprovou |
-| I3 | **UI/UX** | Mockup aprovado, padrão visual seguido |
-| I4 | **Performance** | Sem degradação mensurável (benchmark se aplicável) |
-| I5 | **Score** | architect score ≥ 70/100, sem regressão |
-
----
-
-## 🟢 DESIRABLE (Boas práticas — Não bloqueiam, mas são monitoradas)
-
-| # | Gate | Critério |
-|---|------|----------|
-| D1 | **Clean Code** | Sem code smells detectados |
-| D2 | **Arquitetura** | Sem novos anti-patterns |
-| D3 | **Git** | Commits semânticos, branch naming correto |
-| D4 | **Observabilidade** | Logging adequado, métricas expostas |
-
----
-
-## 📊 Tabela de Métricas
-
-| Métrica | Mínimo | Ideal | Blocker se |
-|---------|--------|-------|-----------|
-| Cobertura de testes | 80% | 90%+ | < 80% |
-| Complexidade ciclomática | — | < 10 | > 20 |
-| Linhas por arquivo | — | < 300 | > 500 |
-| Métodos por classe | — | < 10 | > 20 |
-| Score Architect | 70/100 | 80+ | < 70 |
-| Anti-patterns CRITICAL | 0 | 0 | > 0 |
-| Dependencies per file | — | < 5 | > 10 |
-
-
-
----
-
-## ⚠️ Módulos Sem Testes
-
-Os seguintes módulos **DEVEM TER** cobertura de testes antes de merge:
-
-- ⚠️ `agent-generator`
-- ⚠️ `html-reporter`
-- ⚠️ `summarizer`
-- ⚠️ `scripts`
-- ⚠️ `rules`
-- ⚠️ `detectors`
-- ⚠️ `analyzers`
-- ⚠️ `enrichers`
-- ⚠️ `architect.js`
-
-**Ação Obrigatória:** Criar testes para cada módulo listado acima. Se a cobertura for impossível, documentar no BLOCKERS.
-
----
-
-## ⛔ BLOCKERS — Merge PROIBIDO se:
-
-```
-❌ console.log / print() em código de produção
-❌ TODO / FIXME / HACK sem issue vinculada
-❌ any (TypeScript) / type: ignore (Python) sem justificativa
-❌ Testes com .skip() ou @pytest.mark.skip sem motivo
-❌ Secrets, tokens ou senhas hardcoded
-❌ Push direto em main/develop
-❌ Arquivos > 500 linhas sem justificativa
-❌ Imports circulares
-```
-
-
-
----
-
-## ✅ Checklists por Camada
-
-### Backend 
-
-```
-□ Validação de entrada em TODOS os endpoints
-□ Tratamento de erros com mensagens claras
-□ DTOs para request e response (nunca entity direto)
-□ Testes unitários para services
-□ Testes de integração para controllers
-□ Migrations reversíveis
-□ Sem N+1 queries
-□ Rate limiting em endpoints públicos
-□ Logging estruturado (não console.log)
-```
-
-### Frontend (skip se não aplicável)
-
-```
-□ Componentes seguem padrão visual do sistema
-□ Estado gerenciado corretamente (não prop drilling)
-□ Loading states implementados
-□ Error states implementados
-□ Empty states implementados
-□ Responsivo (mobile-first se web)
-□ Formulários com validação client-side
-□ Sem lógica de negócio em componentes (extrair para service)
-□ Lazy loading onde aplicável
-```
-
-### Mobile (Flutter) (skip se não aplicável)
-
-```
-□ Widgets seguem padrão visual do app
-□ Navegação consistente (back button, deep link)
-□ Loading/error/empty states implementados
-□ Comportamento offline graceful
-□ Sem lógica de negócio em widgets
-□ Performance de scroll (ListView.builder, não Column)
-□ Tamanhos de fonte acessíveis
-```
-
-### Database (skip se não aplicável)
-
-```
-□ Migration reversível (up + down)
-□ Índices para queries frequentes
-□ Foreign keys onde aplicável
-□ Constraints de integridade (NOT NULL, UNIQUE, CHECK)
-□ Seed data atualizado
-□ Impacto em queries existentes avaliado
-□ Sem ALTER TABLE em tabelas com milhões de rows sem plano
-```
-
-
-
----
-
-## 🔄 Processo de Verificação (4 Estágios)
-
-### Estágio 1: Antes de Começar
-```
-□ PREFLIGHT completo
-□ Sei quais gates se aplicam à minha tarefa
-□ Ambiente verificado (build + tests green)
-```
-
-### Estágio 2: Durante Desenvolvimento
-```
-□ Rodo testes a cada mudança significativa
-□ Verifico lint periodicamente
-□ Não acumulo débito técnico
-```
-
-### Estágio 3: Antes de Commit
-```
-□ TODOS os gates CRITICAL passam
-□ Gates IMPORTANT justificados se não atendidos
-□ Build + Tests + Lint + Coverage ✓
-□ $ architect score ./src → sem regressão
-```
-
-### Estágio 4: Antes de PR
-```
-□ Branch atualizada com base
-□ Commit messages semânticos
-□ Descrição do PR completa
-□ Code review solicitado
-□ Documentação atualizada
-```
-
----
-
-## 🔌 Verificação Automatizada
-
-Antes de qualquer PR, execute:
-
-```bash
-# Quality gate completo
-npm run build && \
-npm run test -- --coverage && \
-npx @girardelli/architect score . --format json
-```
-
-Score mínimo: **70/100**
-Cobertura mínima: **80%**
-Regra: **Score não pode regredir** em relação ao último report.
-
----
-
-**Gerado por Architect v3.1 · Score: 94/100 · 2026-03-30**

package/.agent/hooks/post-analysis.sh

@@ -1,64 +0,0 @@
-#!/bin/bash
-# ============================================================
-# POST-ANALYSIS HOOK — @girardelli/architect
-# Gerado por Architect v5.1
-#
-# Executa após 'architect analyze .' para gerar ações
-# de remediação automáticas.
-#
-# Uso:
-#   architect analyze . && bash .agent/hooks/post-analysis.sh
-# ============================================================
-
-set -e
-
-echo "🔧 [post-analysis] Processando resultados da análise..."
-
-REPORT_JSON="architect-report.json"
-REPORT_HTML="architect-report.html"
-
-# ── 1. Score Evolution ──
-CURRENT_SCORE=94
-echo "📊 Score atual: $CURRENT_SCORE/100"
-echo "   Meta curto prazo: 99/100"
-echo "   Meta médio prazo: 100/100"
-
-# ── 2. Critical Anti-Patterns Alert ──
-CRITICAL_COUNT=$(grep -c '"severity":"CRITICAL"' "$REPORT_JSON" 2>/dev/null || echo "0")
-HIGH_COUNT=$(grep -c '"severity":"HIGH"' "$REPORT_JSON" 2>/dev/null || echo "0")
-
-if [ "$CRITICAL_COUNT" -gt 0 ]; then
-  echo ""
-  echo "🔴 ATENÇÃO: $CRITICAL_COUNT anti-patterns CRÍTICOS detectados!"
-  echo "   Resolva antes do próximo sprint."
-fi
-
-if [ "$HIGH_COUNT" -gt 0 ]; then
-  echo "🟠 $HIGH_COUNT anti-patterns HIGH detectados."
-fi
-
-# ── 3. Generate Summary ──
-echo ""
-echo "📋 Resumo:"
-echo "   Arquivos: 122"
-echo "   Linhas: 37.407"
-echo "   Anti-patterns: 0"
-echo ""
-
-# ── 4. Suggestions ──
-if [ -f "$REPORT_JSON" ]; then
-  echo "💡 Top 5 sugestões:"
-  cat "$REPORT_JSON" | python3 -c "
-import json, sys
-data = json.load(sys.stdin)
-for s in data.get('suggestions', [])[:5]:
-    print(f'   → {s.get("description", "")}')
-" 2>/dev/null || echo "   (instale python3 para ver sugestões)"
-fi
-
-echo ""
-echo "📄 Report HTML: $REPORT_HTML"
-echo "📦 Report JSON: $REPORT_JSON"
-echo ""
-echo "✅ [post-analysis] Concluído."
-exit 0

package/.agent/hooks/pre-commit.sh

@@ -1,68 +0,0 @@
-#!/bin/bash
-# ============================================================
-# PRE-COMMIT HOOK — @girardelli/architect
-# Gerado por Architect v5.1
-#
-# Instalação:
-#   cp .agent/hooks/pre-commit.sh .git/hooks/pre-commit
-#   chmod +x .git/hooks/pre-commit
-# ============================================================
-
-set -e
-
-echo "🔍 [pre-commit] Verificando qualidade do código..."
-
-# ── 1. Branch Safety ──
-BRANCH=$(git branch --show-current)
-if [[ "$BRANCH" == "main" || "$BRANCH" == "master" || "$BRANCH" == "staging" || "$BRANCH" == "develop" ]]; then
-  echo "❌ BLOQUEADO: Commit direto em '$BRANCH' é proibido."
-  echo "   Crie uma branch: git checkout -b feature/<nome>"
-  exit 1
-fi
-
-# ── 2. Secrets Check ──
-echo "🔐 Verificando secrets..."
-SECRETS_PATTERN='(password|secret|api[_-]?key|access[_-]?token|private[_-]?key)\s*[:=]\s*["\'\x60][^"\x60]{8,}'
-
-STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM)
-if echo "$STAGED_FILES" | xargs grep -ilE "$SECRETS_PATTERN" 2>/dev/null; then
-  echo "❌ BLOQUEADO: Possível secret detectado nos arquivos staged."
-  echo "   Remova o secret e use variáveis de ambiente."
-  exit 1
-fi
-
-# ── 3. File Size Check ──
-echo "📏 Verificando tamanho de arquivos..."
-for file in $STAGED_FILES; do
-  if [ -f "$file" ]; then
-    LINES=$(wc -l < "$file" 2>/dev/null || echo "0")
-    if [ "$LINES" -gt 500 ]; then
-      echo "⚠️  AVISO: $file tem $LINES linhas (limite: 500)"
-    fi
-  fi
-done
-
-# ── 4. Lint ──
-echo "🧹 Executando lint..."
-npm run lint --quiet 2>/dev/null || {
-  echo "❌ BLOQUEADO: Lint falhou."
-  echo "   Corrija: npm run lint"
-  exit 1
-}
-
-# ── 5. Build ──
-echo "🔨 Verificando build..."
-npm run build 2>/dev/null || {
-  echo "❌ BLOQUEADO: Build falhou."
-  echo "   Corrija: npm run build"
-  exit 1
-}
-
-# ── 6. Debug Statements ──
-echo "🐛 Verificando debug statements..."
-if echo "$STAGED_FILES" | xargs grep -n 'console\.log\|debugger\|print(' 2>/dev/null | grep -v 'node_modules' | grep -v '.test.'; then
-  echo "⚠️  AVISO: Debug statements encontrados. Remova antes do merge."
-fi
-
-echo "✅ [pre-commit] Tudo OK — commit liberado."
-exit 0

package/.agent/hooks/pre-push.sh

@@ -1,59 +0,0 @@
-#!/bin/bash
-# ============================================================
-# PRE-PUSH HOOK — @girardelli/architect
-# Gerado por Architect v5.1
-#
-# Instalação:
-#   cp .agent/hooks/pre-push.sh .git/hooks/pre-push
-#   chmod +x .git/hooks/pre-push
-# ============================================================
-
-set -e
-
-echo "🚀 [pre-push] Verificação completa antes do push..."
-
-# ── 1. Branch Safety ──
-BRANCH=$(git branch --show-current)
-if [[ "$BRANCH" == "main" || "$BRANCH" == "master" ]]; then
-  echo "❌ BLOQUEADO: Push direto para '$BRANCH' é proibido."
-  echo "   Use Pull Request."
-  exit 1
-fi
-
-# ── 2. Full Test Suite ──
-echo "🧪 Executando testes completos..."
-npm test || {
-  echo "❌ BLOQUEADO: Testes falharam."
-  echo "   Corrija antes de fazer push."
-  exit 1
-}
-
-# ── 3. Coverage Gate ──
-echo "📊 Verificando cobertura (mínimo: 80%)..."
-COVERAGE_OUTPUT=$(npm run test -- --coverage 2>&1 || true)
-echo "$COVERAGE_OUTPUT" | tail -5
-
-# Parse coverage percentage (works with Jest/Istanbul output)
-COVERAGE=$(echo "$COVERAGE_OUTPUT" | grep -oP 'All files[^|]*\|\s*[\d.]+' | grep -oP '[\d.]+$' || echo "0")
-if [ -n "$COVERAGE" ]; then
-  COVERAGE_INT=${COVERAGE%.*}
-  if [ "$COVERAGE_INT" -lt 80 ] 2>/dev/null; then
-    echo "⚠️  AVISO: Cobertura ($COVERAGE_INT%) abaixo do mínimo (80%)"
-  fi
-fi
-
-# ── 4. Architecture Score Gate ──
-echo "🏗️ Verificando score de arquitetura (mínimo: 70/100)..."
-if command -v architect &> /dev/null; then
-  SCORE=$(architect score . --json 2>/dev/null | grep -oP '"overall":\s*\K[0-9]+' || echo "N/A")
-  if [ "$SCORE" != "N/A" ] && [ "$SCORE" -lt 70 ] 2>/dev/null; then
-    echo "❌ BLOQUEADO: Score ($SCORE/100) abaixo do mínimo (70/100)"
-    exit 1
-  fi
-  echo "   Score: $SCORE/100 ✅"
-else
-  echo "   ⏭️  architect não instalado — skip score gate"
-fi
-
-echo "✅ [pre-push] Tudo OK — push liberado."
-exit 0