@girardelli/architect 6.0.0 → 8.1.0

package/tests/github-action.test.ts

@@ -0,0 +1,109 @@
+import { jest } from '@jest/globals';
+import { AnalysisReport } from '@girardelli/architect-core/src/core/types/core.js';
+import { ValidationResult } from '@girardelli/architect-core/src/core/types/architect-rules.js';
+
+// Mock dependencies
+jest.unstable_mockModule('@actions/core', () => ({
+  info: jest.fn(),
+  error: jest.fn(),
+}));
+
+  // @ts-ignore
+  const createCommentMock = jest.fn().mockResolvedValue({});
+  jest.unstable_mockModule('@actions/github', () => ({
+    context: {
+      repo: { owner: 'test', repo: 'test-repo' },
+      payload: {
+        pull_request: {
+          number: 42,
+          base: { ref: 'main' }
+        }
+      }
+    },
+    getOctokit: jest.fn().mockReturnValue({
+      rest: {
+        issues: {
+          createComment: createCommentMock
+        }
+      }
+    })
+  }));
+
+describe('GithubActionAdapter', () => {
+  let adapter: any;
+  let mockHeadReport: AnalysisReport;
+  let mockBaseReport: AnalysisReport;
+  let mockValidation: ValidationResult;
+
+  beforeAll(async () => {
+    const { GithubActionAdapter } = await import('../src/adapters/github-action.js');
+    adapter = new GithubActionAdapter('fake-token');
+  });
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+    
+    mockHeadReport = {
+      timestamp: new Date().toISOString(),
+      projectInfo: { path: '.', name: 'Test', frameworks: [], primaryLanguages: [], totalFiles: 10, totalLines: 100 },
+      score: {
+        overall: 80,
+        components: [],
+        breakdown: { modularity: 80, coupling: 80, cohesion: 80, layering: 80 },
+      },
+      antiPatterns: [
+        { name: 'God Class', severity: 'HIGH', location: 'file.ts', description: 'desc', suggestion: 'sugg' }
+      ],
+      layers: [],
+      dependencyGraph: { nodes: [], edges: [] },
+      suggestions: [],
+      diagram: { mermaid: '', type: 'component' }
+    };
+
+    mockBaseReport = JSON.parse(JSON.stringify(mockHeadReport));
+    mockBaseReport.score.overall = 85;
+
+    mockValidation = {
+      success: false,
+      violations: [
+        { level: 'error', rule: 'min_overall_score', message: 'Score too low', actual: 80, expected: 90 }
+      ]
+    };
+  });
+
+  it('should post comment with positive delta', async () => {
+    mockBaseReport.score.overall = 75; // improved by 5
+    await adapter.postComment(mockHeadReport, mockBaseReport);
+    
+    expect(createCommentMock).toHaveBeenCalledWith(expect.objectContaining({
+      issue_number: 42,
+      body: expect.stringContaining('📈 **+5** (Improved from 75)')
+    }));
+  });
+
+  it('should post comment with negative delta', async () => {
+    mockBaseReport.score.overall = 85; // dropped by 5
+    await adapter.postComment(mockHeadReport, mockBaseReport);
+    
+    expect(createCommentMock).toHaveBeenCalledWith(expect.objectContaining({
+      issue_number: 42,
+      body: expect.stringContaining('📉 **-5** (Regressed from 85)')
+    }));
+  });
+
+  it('should output validation errors in the comment', async () => {
+    await adapter.postComment(mockHeadReport, mockBaseReport, mockValidation);
+    
+    const callArgs = createCommentMock.mock.calls[0][0] as any;
+    expect(callArgs.body).toContain('❌ **Quality Gates Failed!**');
+    expect(callArgs.body).toContain('`min_overall_score`');
+  });
+
+  it('should list anti-patterns in the report', async () => {
+    await adapter.postComment(mockHeadReport, null);
+    
+    const callArgs = createCommentMock.mock.calls[0][0] as any;
+    expect(callArgs.body).toContain('### ⚠️ Anti-Patterns Detected');
+    expect(callArgs.body).toContain('God Class');
+  });
+});

package/tsconfig.json

@@ -1,24 +1,17 @@
 {
+  "extends": "../../tsconfig.base.json",
   "compilerOptions": {
-    "target": "ES2020",
-    "module": "ES2020",
-    "lib": ["ES2020"],
-    "moduleResolution": "bundler",
     "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "noUnusedLocals": false,
-    "noUnusedParameters": false,
-    "noImplicitReturns": true,
-    "noFallthroughCasesInSwitch": true
+    "rootDir": "./"
   },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "tests"]
+  "include": ["src/**/*", "tests/**/*"],
+  "exclude": ["node_modules", "dist"],
+  "references": [
+    {
+      "path": "../architect-core"
+    },
+    {
+      "path": "../architect-agents"
+    }
+  ]
 }

package/.agent/INDEX.md

@@ -1,197 +0,0 @@
-# @girardelli/architect — Agent Framework
-
-> **Auto-generated by [Architect v3.1](https://github.com/camilooscargbaptista/architect)**
-> Stack: **TypeScript + JavaScript** | Score: **94/100** | Files: **122** | Lines: **37.407**
-
----
-
-## ⛔ PARE AQUI — LEITURA OBRIGATÓRIA
-
-> **Antes de qualquer ação, leia estes documentos NA ORDEM.**
-> Pular esta etapa é violação do protocolo.
-
-| # | Arquivo | O que contém | Quando ler |
-|---|---------|-------------|-----------|
-| 1 | [00-general.md](./rules/00-general.md) | Regras de Ouro, convenções, identidade do projeto | **SEMPRE** |
-| 2 | [PREFLIGHT.md](./guards/PREFLIGHT.md) | Checklist pré-ação por camada | **SEMPRE** |
-| 3 | [QUALITY-GATES.md](./guards/QUALITY-GATES.md) | Métricas mínimas, blockers, processo de verificação | **SEMPRE** |
-| 4 | [CODE-REVIEW-CHECKLIST.md](./guards/CODE-REVIEW-CHECKLIST.md) | Pontos obrigatórios de revisão | Antes de PR |
-
----
-
-## 🗺️ Guia Situacional
-
-> **"O que vou fazer?"** → Siga a coluna correspondente.
-
-| Ação | Leia antes | Workflow | Agente principal |
-|------|-----------|---------|-----------------|
-| Nova feature | 00-general + PREFLIGHT | [new-feature](./workflows/new-feature.md) | ORCHESTRATOR |
-| Corrigir bug | 00-general + PREFLIGHT | [fix-bug](./workflows/fix-bug.md) | ORCHESTRATOR |
-| Mexer em backend | 00-general + 01-architecture | new-feature ou fix-bug | TYPESCRIPT-BACKEND |
-| Segurança | 02-security | — | SECURITY-AUDITOR |
-| Testes | 00-general | — | QA-TEST-ENGINEER |
-| Refatoração | QUALITY-GATES | — | TECH-DEBT-CONTROLLER |
-| Code review | CODE-REVIEW-CHECKLIST | [review](./workflows/review.md) | QA-TEST-ENGINEER |
-
----
-
-## 🤖 Agentes Disponíveis
-
-| Agente | Role | Capabilities |
-|--------|------|-------------|
-| [AGENT-ORCHESTRATOR](./agents/AGENT-ORCHESTRATOR.md) | coordination | Decomposição, dispatch, consolidação, quality gate |
-| [TYPESCRIPT-BACKEND-DEVELOPER](./agents/TYPESCRIPT-BACKEND-DEVELOPER.md) | development | APIs, serviços, lógica de negócio, migrations |
-| [SECURITY-AUDITOR](./agents/SECURITY-AUDITOR.md) | quality | Ameaças STRIDE, OWASP, LGPD, vulnerabilidades |
-| [QA-TEST-ENGINEER](./agents/QA-TEST-ENGINEER.md) | quality | Planos de teste, BDD/TDD, cobertura, regressão |
-| [TECH-DEBT-CONTROLLER](./agents/TECH-DEBT-CONTROLLER.md) | governance | Débito técnico, refatorações, metas de score |
-
----
-
-## 📋 Templates Disponíveis
-
-| Template | Arquivo | Quando usar |
-|----------|---------|-----------|
-| C4 Architecture | [C4.md](./templates/C4.md) | Documentar arquitetura de qualquer feature |
-| BDD Scenarios | [BDD.md](./templates/BDD.md) | Antes de implementar — cenários de aceite |
-| TDD Cases | [TDD.md](./templates/TDD.md) | Antes de implementar — casos de teste |
-| ADR | [ADR.md](./templates/ADR.md) | Decisões arquiteturais significativas |
-| Threat Model | [THREAT-MODEL.md](./templates/THREAT-MODEL.md) | Features que lidam com dados sensíveis |
-
----
-
-## 📁 Estrutura do Framework
-
-```
-.agent/
-├── INDEX.md              ← VOCÊ ESTÁ AQUI
-├── agents/               → Agentes especializados
-│   ├── AGENT-ORCHESTRATOR.md
-│   ├── TYPESCRIPT-BACKEND-DEVELOPER.md
-│   ├── SECURITY-AUDITOR.md
-│   ├── QA-TEST-ENGINEER.md
-│   └── TECH-DEBT-CONTROLLER.md
-├── rules/                → Regras de codificação
-│   ├── 00-general.md
-│   ├── 01-architecture.md
-│   └── 02-security.md
-├── guards/               → Checklists e quality gates
-│   ├── PREFLIGHT.md
-│   ├── QUALITY-GATES.md
-│   └── CODE-REVIEW-CHECKLIST.md
-├── workflows/            → Fluxos de trabalho
-│   ├── new-feature.md
-│   ├── fix-bug.md
-│   └── review.md
-├── templates/            → Templates reutilizáveis
-│   ├── C4.md
-│   ├── BDD.md
-│   ├── TDD.md
-│   ├── ADR.md
-│   └── THREAT-MODEL.md
-└── skills/               → Padrões e referências
-```
-
----
-
-## 🔄 Fluxo Completo de Desenvolvimento
-
-```
-REQUISIÇÃO RECEBIDA
-       │
-       ▼
-┌──────────────────┐
-│  PREFLIGHT.md    │ ← Ler OBRIGATÓRIO
-│  (diagnóstico)   │
-└────────┬─────────┘
-         │
-         ▼
-┌──────────────────┐
-│  ORCHESTRATOR    │ ← Decompõe a requisição
-│  (classificar)   │
-└────────┬─────────┘
-         │
-         ▼
-┌──────────────────────────────────────┐
-│         6 GATES OBRIGATÓRIOS         │
-│                                      │
-│  1. MOCKUP (se tem UI)               │
-│  2. User Stories                     │
-│  3. Arquitetura (C4)                 │
-│  4. Tarefas (breakdown)              │
-│  5. BDD (cenários)                   │
-│  6. TDD (casos de teste)            │
-│                                      │
-│  ⚠️  /approved após cada gate        │
-└────────┬─────────────────────────────┘
-         │
-         ▼
-┌──────────────────────────────────────┐
-│      IMPLEMENTAÇÃO (ordenada)        │
-│                                      │
-│  1° Backend (se houver)              │
-│  2° Documento de Integração          │
-│  3° Frontend / App (se houver)       │
-└────────┬─────────────────────────────┘
-         │
-         ▼
-┌──────────────────┐
-│  QUALITY-GATES   │ ← Build + Coverage ≥ 80%
-│  (verificação)   │
-└────────┬─────────┘
-         │
-         ▼
-┌──────────────────┐
-│  CODE REVIEW     │ ← Checklist obrigatório
-│  (PR)            │
-└────────┬─────────┘
-         │
-         ▼
-      ✅ DONE
-```
-
----
-
-## ⚡ Atalhos Rápidos
-
-| Situação | Comando / Workflow |
-|----------|-------------------|
-| Nova feature | `/new-feature` → [workflow](./workflows/new-feature.md) |
-| Corrigir bug | `/fix-bug` → [workflow](./workflows/fix-bug.md) |
-| Code review | `/review` → [workflow](./workflows/review.md) |
-| Verificar qualidade | `architect score ./src` |
-| Analisar arquitetura | `architect analyze ./src` |
-
----
-
-## 🔌 Plugin Recomendado
-
-Para análise contínua de arquitetura e manutenção do score:
-
-```
-┌─────────────────────────────────────────────┐
-│  📦 @girardelli/architect                   │
-│  Plugin para Claude Code                    │
-│                                             │
-│  npm install -g @girardelli/architect       │
-│                                             │
-│  Comandos:                                  │
-│  • architect analyze ./src                  │
-│  • architect score ./src                    │
-│  • architect agents ./src                   │
-│  • architect refactor ./src                 │
-│                                             │
-│  Score atual: 94/100                        │
-│  Meta: 100/100                       │
-└─────────────────────────────────────────────┘
-```
-
----
-
-## ⚠️ REGRA DE OURO
-
-> **Na dúvida, PARA e PERGUNTA ao humano.**
-> Nunca assuma. Nunca decida sozinho. Sempre valide.
-
----
-
-**Gerado por Architect v3.1 · Score: 94/100 · 2026-03-30**