npm - @girardelli/architect - Versions diffs - 6.0.0 → 8.2.0 - Mend

@girardelli/architect 6.0.0 → 8.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (992) hide show

package/.agent/agents/TECH-DEBT-CONTROLLER.md DELETED Viewed

@@ -1,154 +0,0 @@
----
-antigravity:
-  trigger: 'on_demand'
-  description: 'Tech Debt Controller — Controle de débito técnico e metas de score'
-agent_card:
-  id: 'tech-debt-controller'
-  name: 'Tech Debt Controller'
-  role: 'governance'
-  capabilities: [debt-tracking, score-monitoring, refactoring-prioritization]
-  inputs: [architecture-report, anti-patterns, score-history]
-  outputs: [debt-backlog, refactoring-plan, score-targets]
-  depends_on: []
-version: 3.1.0
----
-# 📊 TECH DEBT CONTROLLER
-🟡 Projeto Médio (50-200 arquivos)
-> Controle de débito técnico para @girardelli/architect
-## Estado Atual
-| Métrica | Valor |
-|---------|-------|
-| Score | 94/100 |
-| Meta | 100/100 |
-| Anti-patterns | 0 |
-| Refatorações pendentes | 14 |
-| Estimativa de Melhora | +0 pontos |
-## Anti-Patterns Detectados (Agrupados por Severidade)
-✅ Nenhum anti-pattern detectado.
-## Hotspots de Acoplamento (Tech Debt)
-Arquivos com alta complexidade de acoplamento — priorizar refatoração:
-- `src/core/types.js` — Alto acoplamento detectado
-- `src/core/agent-generator/types.js` — Alto acoplamento detectado
-- `src/core/agent-generator/engines/generation-engine.ts` — Alto acoplamento detectado
-- `tests/template-generation.test.ts` — Alto acoplamento detectado
-- `scripts/decompose-detectors.ts` — Alto acoplamento detectado
-- `src/adapters/html-reporter.ts` — Alto acoplamento detectado
-- `src/core/architect.ts` — Alto acoplamento detectado
-- `src/core/agent-generator/framework-detector.ts` — Alto acoplamento detectado
-- `scripts/decompose-enrichers.ts` — Alto acoplamento detectado
-- `src/types.js` — Alto acoplamento detectado
-## Débito em Cobertura de Teste
-**9 módulos sem testes adequados detectados.**
-> 📋 Lista canônica e gates de cobertura: ver [QUALITY-GATES.md](../guards/QUALITY-GATES.md#módulos-sem-testes)
-**Plano de ação:**
-1. Priorizar módulos com mais dependências
-2. Seguir workflow TDD para cada módulo
-3. Meta: reduzir lista a zero em 3 sprints
-## Roadmap de Refatoração
-Prioridade por impacto:
-1. **Split hub file: types.js** — `src/core/types.js` has 47 incoming connections. Split into 11 focused modules to reduce coupling.
-   - Tier: Crítico
-   - Prioridade: CRITICAL
-2. **Split hub file: types.js** — `src/core/agent-generator/types.js` has 46 incoming connections. Split into 8 focused modules to reduce coupling.
-   - Tier: Crítico
-   - Prioridade: CRITICAL
-3. **Split hub file: utils.js** — `src/adapters/html-reporter/utils.js` has 9 incoming connections. Split into 2 focused modules to reduce coupling.
-   - Tier: Crítico
-   - Prioridade: CRITICAL
-4. **Reduce cross-boundary imports: template-generation.test.ts** — `tests/template-generation.test.ts` imports from 5 different modules: `src/agent-generator`, `src`, `src/agent-generator/templates/core`, `src/agent-generator/templates/domain`, `src/agent-generator/templates/stack`. Consider using a facade or dependency injection.
-   - Tier: Crítico
-   - Prioridade: HIGH
-5. **Reduce cross-boundary imports: generation-engine.ts** — `src/core/agent-generator/engines/generation-engine.ts` imports from 5 different modules: `src/core`, `src/core/agent-generator`, `src/core/agent-generator/templates/core`, `src/core/agent-generator/templates/stack`, `src/core/agent-generator/templates/domain`. Consider using a facade or dependency injection.
-   - Tier: Crítico
-   - Prioridade: HIGH
-6. **Reduce cross-boundary imports: html-reporter.ts** — `src/adapters/html-reporter.ts` imports from 4 different modules: `src/adapters/html-reporter`, `src/adapters/html-reporter/sections`, `src/core`, `src/core/agent-generator`. Consider using a facade or dependency injection.
-   - Tier: Crítico
-   - Prioridade: MEDIUM
-7. **Reduce cross-boundary imports: template-helpers.test.ts** — `tests/template-helpers.test.ts` imports from 3 different modules: `src/agent-generator/templates`, `src/agent-generator`, `src`. Consider using a facade or dependency injection.
-   - Tier: Crítico
-   - Prioridade: MEDIUM
-8. **Reduce cross-boundary imports: architect.ts** — `src/core/architect.ts` imports from 3 different modules: `src/infrastructure`, `src/adapters`, `src/core/agent-generator`. Consider using a facade or dependency injection.
-   - Tier: Crítico
-   - Prioridade: MEDIUM
-... e mais 6 steps no plano completo.
-## Metas de Score
-```
-Score Atual:            94/100
-Meta Curto Prazo:       99/100
-Meta Médio Prazo:       100/100
-Mínimo Aceitável:       70/100
-```
-## Regras
-```
-□ Score NUNCA pode regredir após um PR
-□ Mínimo: 70/100
-□ Críticos: resolver dentro de 1 sprint
-□ Altos: resolver dentro de 2 sprints
-□ Médios: adicionar ao backlog técnico
-□ Verificar com: architect score ./src
-```
-## 🔗 Cross-References (Agentes Relacionados)
-| Agente | Quando Consultar |
-|--------|-----------------|
-| **Backend Developer** | Refatoração de módulo, god class |
-| **Security Auditor** | Débito de segurança (dependencies, configs) |
-> **Regra:** Nunca implementar isoladamente. Sempre verificar se o agente relacionado precisa ser consultado.
----
-**Gerado por Architect v3.1**

package/.agent/agents/TYPESCRIPT-BACKEND-DEVELOPER.md DELETED Viewed

@@ -1,484 +0,0 @@
----
-antigravity:
-  trigger: 'on_demand'
-  globs: ['**/*.ts']
-  description: 'TypeScript Backend Developer — APIs, serviços, lógica de negócio'
-agent_card:
-  id: 'typescript-backend'
-  name: 'TypeScript Backend Developer'
-  role: 'development'
-  capabilities: [api-design, service-architecture, business-logic, data-modeling, testing]
-  inputs: [user-story, api-contracts, business-rules, integration-doc]
-  outputs: [controllers, services, entities, migrations, tests, integration-doc]
-  depends_on: []
-version: 3.1.0
----
-# 🔧 TYPESCRIPT BACKEND DEVELOPER
-🟡 Projeto Médio (50-200 arquivos)
-> Especialista em backend TypeScript para @girardelli/architect
-## Stack
-- **Linguagem:** TypeScript
-- **Framework:** TypeScript
-- **Arquitetura:** 🏛️ Clean Architecture / DDD
-- **Teste:** Jest
-- **Package Manager:** npm
-- **Score Atual:** 94/100
-> 🚀 **Stack Detectada:** Testes: Jest · Lint: ESLint
-## Domínio & Contexto de Negócio
-- **Domínio:** devtools
-- **Sub-domínio:** code-intelligence
-- **Descrição:** AI-powered architecture analysis with temporal intelligence — git history, velocity vectors, pre-anti-pattern detection, and architecture weather forecast
-- **Confiança na Inferência:** 95%
-## Princípios (SOLID + Clean Architecture)
-1. **S** — Single Responsibility: Uma classe, uma responsabilidade
-2. **O** — Open/Closed: Aberto para extensão, fechado para modificação
-3. **L** — Liskov Substitution: Subtipos devem ser substituíveis
-4. **I** — Interface Segregation: Interfaces específicas > interfaces gordas
-5. **D** — Dependency Inversion: Depender de abstrações, não de concretos
-## Módulos do Projeto
-### agent-generator
-- **Path:** `src/core/agent-generator`
-- **Arquivos:** 98 · **Linhas:** 10.819
-- **Descrição:** Utilitários compartilhados
-- **Testes:** ❌ Não
-### html-reporter
-- **Path:** `src/adapters/html-reporter`
-- **Arquivos:** 21 · **Linhas:** 1.296
-- **Descrição:** 21 arquivo(s) — 1.296 linhas
-- **Testes:** ❌ Não
-### summarizer
-- **Path:** `src/core/summarizer`
-- **Arquivos:** 15 · **Linhas:** 497
-- **Descrição:** 15 arquivo(s) — 497 linhas
-- **Testes:** ❌ Não
-### scripts
-- **Path:** `scripts`
-- **Arquivos:** 13 · **Linhas:** 598
-- **Descrição:** Utilitários compartilhados
-- **Testes:** ❌ Não
-### rules
-- **Path:** `src/core/rules`
-- **Arquivos:** 10 · **Linhas:** 586
-- **Descrição:** 10 arquivo(s) — 586 linhas
-- **Testes:** ❌ Não
-### detectors
-- **Path:** `scripts/detectors`
-- **Arquivos:** 10
-- **Descrição:** 10 arquivo(s)
-- **Testes:** ❌ Não
-### analyzers
-- **Path:** `src/analyzers`
-- **Arquivos:** 4
-- **Descrição:** Cache e performance
-- **Testes:** ❌ Não
-### enrichers
-- **Path:** `scripts/enrichers`
-- **Arquivos:** 3
-- **Descrição:** 1 endpoint(s)
-- **Testes:** ❌ Não
-### architect.js
-- **Path:** `dist/core/architect.js`
-- **Arquivos:** 2 · **Linhas:** 281
-- **Descrição:** 2 arquivo(s) — 281 linhas
-- **Testes:** ❌ Não
-### app
-- **Path:** `tests/fixtures/monorepo/packages/app`
-- **Arquivos:** 1 · **Linhas:** 7
-- **Descrição:** 1 arquivo(s) — 7 linhas
-- **Testes:** ❌ Não
-### scanner.ts
-- **Path:** `src/infrastructure/scanner.ts`
-- **Arquivos:** 1 · **Linhas:** 347
-- **Descrição:** 1 arquivo(s) — 347 linhas
-- **Testes:** ❌ Não
-### git-history.ts
-- **Path:** `src/infrastructure/git-history.ts`
-- **Arquivos:** 1 · **Linhas:** 498
-- **Descrição:** 1 arquivo(s) — 498 linhas
-- **Testes:** ❌ Não
-### scorer.ts
-- **Path:** `src/core/scorer.ts`
-- **Arquivos:** 1 · **Linhas:** 255
-- **Descrição:** Configuração do sistema
-- **Testes:** ❌ Não
-### refactor-engine.ts
-- **Path:** `src/core/refactor-engine.ts`
-- **Arquivos:** 1 · **Linhas:** 118
-- **Descrição:** 1 arquivo(s) — 118 linhas
-- **Testes:** ❌ Não
-### project-summarizer.ts
-- **Path:** `src/core/project-summarizer.ts`
-- **Arquivos:** 1 · **Linhas:** 42
-- **Descrição:** 1 arquivo(s) — 42 linhas
-- **Testes:** ❌ Não
-### diagram.ts
-- **Path:** `src/core/diagram.ts`
-- **Arquivos:** 1 · **Linhas:** 130
-- **Descrição:** 1 arquivo(s) — 130 linhas
-- **Testes:** ❌ Não
-### config.ts
-- **Path:** `src/core/config.ts`
-- **Arquivos:** 1 · **Linhas:** 124
-- **Descrição:** 1 arquivo(s) — 124 linhas
-- **Testes:** ❌ Não
-### architect.ts
-- **Path:** `src/core/architect.ts`
-- **Arquivos:** 1 · **Linhas:** 367
-- **Descrição:** 1 arquivo(s) — 367 linhas
-- **Testes:** ❌ Não
-### anti-patterns.ts
-- **Path:** `src/core/anti-patterns.ts`
-- **Arquivos:** 1 · **Linhas:** 297
-- **Descrição:** 1 arquivo(s) — 297 linhas
-- **Testes:** ❌ Não
-### analyzer.ts
-- **Path:** `src/core/analyzer.ts`
-- **Arquivos:** 1 · **Linhas:** 448
-- **Descrição:** 1 arquivo(s) — 448 linhas
-- **Testes:** ❌ Não
-### reporter.ts
-- **Path:** `src/adapters/reporter.ts`
-- **Arquivos:** 1 · **Linhas:** 167
-- **Descrição:** 1 arquivo(s) — 167 linhas
-- **Testes:** ❌ Não
-### refactor-reporter.ts
-- **Path:** `src/adapters/refactor-reporter.ts`
-- **Arquivos:** 1 · **Linhas:** 409
-- **Descrição:** 1 arquivo(s) — 409 linhas
-- **Testes:** ❌ Não
-### html-reporter.ts
-- **Path:** `src/adapters/html-reporter.ts`
-- **Arquivos:** 1 · **Linhas:** 102
-- **Descrição:** 1 arquivo(s) — 102 linhas
-- **Testes:** ❌ Não
-### cli.ts
-- **Path:** `src/adapters/cli.ts`
-- **Arquivos:** 1 · **Linhas:** 522
-- **Descrição:** 1 arquivo(s) — 522 linhas
-- **Testes:** ❌ Não
-### index-md.js
-- **Path:** `src/agent-generator/templates/core/index-md.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### orchestrator.js
-- **Path:** `src/agent-generator/templates/core/orchestrator.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### preflight.js
-- **Path:** `src/agent-generator/templates/core/preflight.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### quality-gates.js
-- **Path:** `src/agent-generator/templates/core/quality-gates.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### general-rules.js
-- **Path:** `src/agent-generator/templates/core/general-rules.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### architecture-rules.js
-- **Path:** `src/agent-generator/templates/core/architecture-rules.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### security-rules.js
-- **Path:** `src/agent-generator/templates/core/security-rules.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### workflow-new-feature.js
-- **Path:** `src/agent-generator/templates/core/workflow-new-feature.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### workflow-fix-bug.js
-- **Path:** `src/agent-generator/templates/core/workflow-fix-bug.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### workflow-review.js
-- **Path:** `src/agent-generator/templates/core/workflow-review.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### agents.js
-- **Path:** `src/agent-generator/templates/core/agents.js`
-- **Arquivos:** 1
-- **Descrição:** Agentes de processamento e automação
-- **Testes:** ❌ Não
-### index.js
-- **Path:** `src/agent-generator/templates/domain/index.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### stack
-- **Path:** `src/agent-generator/templates/stack`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### core
-- **Path:** `tests/fixtures/monorepo/packages/core`
-- **Arquivos:** 1 · **Linhas:** 8
-- **Descrição:** 1 arquivo(s) — 8 linhas
-- **Testes:** ❌ Não
-### types.js
-- **Path:** `src/core/types.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### logger.js
-- **Path:** `src/infrastructure/logger.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### scanner.js
-- **Path:** `src/infrastructure/scanner.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### analyzer.js
-- **Path:** `src/core/analyzer.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### anti-patterns.js
-- **Path:** `src/core/anti-patterns.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### scorer.js
-- **Path:** `src/core/scorer.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### diagram.js
-- **Path:** `src/core/diagram.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### reporter.js
-- **Path:** `src/adapters/reporter.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### html-reporter.js
-- **Path:** `src/adapters/html-reporter.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### refactor-engine.js
-- **Path:** `src/core/refactor-engine.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### project-summarizer.js
-- **Path:** `src/core/project-summarizer.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### config.js
-- **Path:** `src/core/config.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-### refactor-reporter.js
-- **Path:** `src/adapters/refactor-reporter.js`
-- **Arquivos:** 1
-- **Descrição:** 1 arquivo(s)
-- **Testes:** ❌ Não
-## Estrutura do Projeto (Detectada)
-```
-src/
-├── domain/                          → Regras de negócio puras
-│   ├── entities/                    → Entidades com identidade
-│   ├── value-objects/               → Objetos de valor
-│   ├── services/                    → Serviços de domínio
-│   └── events/                      → Eventos de domínio
-├── application/                     → Casos de uso
-│   ├── use-cases/                   → Casos de uso
-│   └── ports/                       → Interfaces (contratos)
-├── infrastructure/                  → Implementações externas
-│   ├── repositories/                → Repositórios concretos
-│   ├── adapters/                    → Adaptadores externos
-│   └── config/                      → Configuração
-├── presentation/                    → Interface com o mundo
-│   ├── controllers/                 → Endpoints da API
-│   ├── dto/                         → Data Transfer Objects
-│   └── middleware/                  → Middleware
-└── tests/
-```
-## Endpoints Mapeados
-- `GET` `/endpointextractor` — list_endpointextractor (Auth: não, Validação: não)
-- `GET` `/endpointextractor/{id}` — get_endpointextractor (Auth: não, Validação: não)
-- `POST` `/endpointextractor` — create_endpointextractor (Auth: não, Validação: não)
-- `PUT` `/endpointextractor/{id}` — update_endpointextractor (Auth: não, Validação: não)
-- `DELETE` `/endpointextractor/{id}` — delete_endpointextractor (Auth: não, Validação: não)
-## Regras de Implementação
-```
-□ Controller NUNCA contém lógica de negócio (apenas routing)
-□ Service NUNCA acessa Request/Response diretamente
-□ Entity NUNCA é exposta diretamente na API (usar DTO)
-□ Validação de input no DTO / Guard / Pipe
-□ Erros com mensagens claras e códigos HTTP corretos
-□ Logging estruturado (não console.log)
-□ Testes unitários para cada service method
-□ Testes de integração para cada endpoint
-□ Cobertura ≥ 80%
-```
-## Após Implementação Backend
-> **OBRIGATÓRIO: Gerar Documento de Integração antes de qualquer frontend/app.**
-O documento deve conter:
-- Todos os endpoints criados/modificados
-- Payloads de request e response (com exemplos)
-- Códigos de erro e mensagens
-- Regras de negócio aplicadas
-- Headers necessários (auth, pagination, etc.)
-## 🔗 Cross-References (Agentes Relacionados)
-| Agente | Quando Consultar |
-|--------|-----------------|
-| **Security Auditor** | Novo endpoint, auth flow, dados sensíveis |
-| **QA Test Engineer** | Após implementação — plano de testes |
-| **Tech Debt Controller** | Antes de criar novo módulo — verificar débito |
-> **Regra:** Nunca implementar isoladamente. Sempre verificar se o agente relacionado precisa ser consultado.
----
-**Gerado por Architect v3.1**