wegho-agentes 7.0.3 → 7.0.6

package/.agents/core/planning-agent.ts

@@ -1,388 +1,77 @@
-import { BaseAgent, TaskContext, TaskResult } from './base-agent.js';
-import { InventoryAgent } from './inventory-agent.js';
-import * as fs from 'fs';
-import * as path from 'path';
-
-/**
- * Planning Agent - Cria planos de implementação automáticos
- * 
- * Responsabilidades:
- * - Analisar tarefa e criar plano detalhado
- * - Definir arquitetura de solução
- * - Listar arquivos a criar/modificar
- * - Estimar esforço e complexidade
- * - Validar viabilidade técnica
- */
-
-export interface ImplementationPlan {
-    title: string;
-    description: string;
-    architecture: {
-        components: string[];
-        apis: string[];
-        database: string[];
-        dependencies: string[];
-    };
-    files: {
-        create: Array<{
-            path: string;
-            type: 'component' | 'api' | 'hook' | 'util' | 'type' | 'config';
-            purpose: string;
-        }>;
-        modify: Array<{
-            path: string;
-            changes: string;
-        }>;
-        delete: string[];
-    };
-    steps: string[];
-    estimatedTime: string;
-    complexity: 'low' | 'medium' | 'high';
-    risks: string[];
-    dependencies: string[];
-}
-
-export class PlanningAgent extends BaseAgent {
-    private inventoryAgent: InventoryAgent;
-    private projectRoot: string;
-
-    constructor(memoryPath: string, projectRoot: string = process.cwd()) {
-        super('planning-agent', memoryPath);
-        this.projectRoot = projectRoot;
-        this.inventoryAgent = new InventoryAgent(projectRoot, memoryPath);
-    }
-
-    /**
-     * Cria um plano de implementação completo
-     */
-    async createImplementationPlan(taskDescription: string): Promise<ImplementationPlan> {
-        console.log('\n🏗️  Criando plano de implementação...\n');
-
-        // 1. Analisar tarefa
-        const taskAnalysis = this.analyzeTask(taskDescription);
-
-        // 2. Consultar inventário para entender projeto
-        const inventory = await this.consultInventory();
-
-        // 3. Definir arquitetura
-        const architecture = this.defineArchitecture(taskAnalysis, inventory);
-
-        // 4. Planejar arquivos
-        const files = this.planFiles(taskAnalysis, architecture, inventory);
-
-        // 5. Criar passos de execução
-        const steps = this.createExecutionSteps(architecture, files);
-
-        // 6. Estimar esforço
-        const { estimatedTime, complexity } = this.estimateEffort(files, architecture);
-
-        // 7. Identificar riscos
-        const risks = this.identifyRisks(taskAnalysis, architecture);
-
-        // 8. Listar dependências
-        const dependencies = this.listDependencies(architecture);
-
-        const plan: ImplementationPlan = {
-            title: taskAnalysis.title,
-            description: taskAnalysis.description,
-            architecture,
-            files,
-            steps,
-            estimatedTime,
-            complexity,
-            risks,
-            dependencies
-        };
-
-        // Exibir plano
-        this.displayPlan(plan);
-
-        return plan;
-    }
-
-    /**
-     * Analisa a tarefa e extrai informações chave
-     */
-    private analyzeTask(taskDescription: string): {
-        title: string;
-        description: string;
-        type: string;
-        keywords: string[];
-    } {
-        const lower = taskDescription.toLowerCase();
-
-        // Detectar tipo de tarefa
-        let type = 'feature';
-        if (lower.includes('criar') || lower.includes('adicionar')) type = 'create';
-        if (lower.includes('modificar') || lower.includes('atualizar')) type = 'update';
-        if (lower.includes('remover') || lower.includes('deletar')) type = 'delete';
-        if (lower.includes('corrigir') || lower.includes('bug')) type = 'fix';
-
-        // Extrair keywords importantes
-        const keywords: string[] = [];
-        if (lower.includes('autenticação') || lower.includes('login')) keywords.push('auth');
-        if (lower.includes('dashboard') || lower.includes('painel')) keywords.push('dashboard');
-        if (lower.includes('formulário') || lower.includes('form')) keywords.push('form');
-        if (lower.includes('api') || lower.includes('endpoint')) keywords.push('api');
-        if (lower.includes('banco') || lower.includes('database')) keywords.push('database');
-        if (lower.includes('componente') || lower.includes('component')) keywords.push('component');
-
-        return {
-            title: this.extractTitle(taskDescription),
-            description: taskDescription,
-            type,
-            keywords
-        };
-    }
-
-    /**
-     * Extrai título da tarefa
-     */
-    private extractTitle(taskDescription: string): string {
-        // Remove palavras de ação e retorna o resto
-        return taskDescription
-            .replace(/^(criar|adicionar|modificar|atualizar|remover|deletar|corrigir)\s+/i, '')
-            .trim()
-            .split(' ')
-            .slice(0, 5)
-            .join(' ');
-    }
-
-    /**
-     * Consulta inventário do projeto
-     */
-    private async consultInventory(): Promise<any> {
-        try {
-            const inventoryPath = path.join(this.projectRoot, '.agents', 'memory', 'inventory-agent', 'inventory');
-
-            if (!fs.existsSync(inventoryPath)) {
-                return { components: [], apis: [], types: [] };
-            }
-
-            const components = this.loadInventoryFile(path.join(inventoryPath, 'components.json'));
-            const apis = this.loadInventoryFile(path.join(inventoryPath, 'endpoints.json'));
-            const types = this.loadInventoryFile(path.join(inventoryPath, 'types.json'));
-
-            return { components, apis, types };
-        } catch (error) {
-            console.warn('⚠️  Não foi possível carregar inventário completo');
-            return { components: [], apis: [], types: [] };
-        }
-    }
-
-    /**
-     * Carrega arquivo de inventário
-     */
-    private loadInventoryFile(filePath: string): any[] {
-        try {
-            if (fs.existsSync(filePath)) {
-                return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
-            }
-        } catch (error) {
-            // Ignora erro
-        }
-        return [];
-    }
-
-    /**
-     * Define arquitetura da solução
-     */
-    private defineArchitecture(taskAnalysis: any, inventory: any): ImplementationPlan['architecture'] {
-        const architecture: ImplementationPlan['architecture'] = {
-            components: [],
-            apis: [],
-            database: [],
-            dependencies: []
-        };
-
-        // Baseado nas keywords, definir componentes necessários
-        if (taskAnalysis.keywords.includes('auth')) {
-            architecture.components.push('AuthProvider', 'LoginForm', 'ProtectedRoute');
-            architecture.apis.push('/api/auth/login', '/api/auth/logout', '/api/auth/session');
-            architecture.database.push('users', 'sessions');
-            architecture.dependencies.push('@supabase/auth-helpers-nextjs');
-        }
-
-        if (taskAnalysis.keywords.includes('dashboard')) {
-            architecture.components.push('DashboardLayout', 'StatsCard', 'ChartWidget');
-            architecture.apis.push('/api/dashboard/stats');
-        }
-
-        if (taskAnalysis.keywords.includes('form')) {
-            architecture.components.push('FormComponent', 'FormField', 'FormValidation');
-            architecture.dependencies.push('react-hook-form', 'zod');
-        }
-
-        return architecture;
-    }
-
-    /**
-     * Planeja arquivos a criar/modificar
-     */
-    private planFiles(taskAnalysis: any, architecture: any, inventory: any): ImplementationPlan['files'] {
-        const files: ImplementationPlan['files'] = {
-            create: [],
-            modify: [],
-            delete: []
-        };
-
-        // Criar componentes
-        for (const component of architecture.components) {
-            files.create.push({
-                path: `components/${component}.tsx`,
-                type: 'component',
-                purpose: `Componente ${component}`
-            });
-        }
-
-        // Criar APIs
-        for (const api of architecture.apis) {
-            const apiPath = api.replace('/api/', 'app/api/') + '/route.ts';
-            files.create.push({
-                path: apiPath,
-                type: 'api',
-                purpose: `Endpoint ${api}`
-            });
-        }
-
-        // Modificar layout se necessário
-        if (architecture.components.length > 0) {
-            files.modify.push({
-                path: 'app/layout.tsx',
-                changes: 'Adicionar providers necessários'
-            });
-        }
-
-        return files;
-    }
-
-    /**
-     * Cria passos de execução
-     */
-    private createExecutionSteps(architecture: any, files: any): string[] {
-        const steps: string[] = [];
-
-        if (architecture.database.length > 0) {
-            steps.push('1. Criar/atualizar tabelas no banco de dados');
-        }
-
-        if (architecture.dependencies.length > 0) {
-            steps.push('2. Instalar dependências necessárias');
-        }
-
-        if (files.create.length > 0) {
-            steps.push('3. Criar novos arquivos');
-        }
-
-        if (files.modify.length > 0) {
-            steps.push('4. Modificar arquivos existentes');
-        }
-
-        steps.push('5. Validar implementação');
-        steps.push('6. Executar testes');
-
-        return steps;
-    }
-
-    /**
-     * Estima esforço necessário
-     */
-    private estimateEffort(files: any, architecture: any): { estimatedTime: string; complexity: 'low' | 'medium' | 'high' } {
-        const totalFiles = files.create.length + files.modify.length;
-        const hasDatabaseChanges = architecture.database.length > 0;
-        const hasAPIs = architecture.apis.length > 0;
-
-        let minutes = totalFiles * 5; // 5min por arquivo base
-
-        if (hasDatabaseChanges) minutes += 15;
-        if (hasAPIs) minutes += totalFiles * 3;
-
-        let complexity: 'low' | 'medium' | 'high' = 'low';
-        if (totalFiles > 5 || hasDatabaseChanges) complexity = 'medium';
-        if (totalFiles > 10 || (hasDatabaseChanges && hasAPIs)) complexity = 'high';
-
-        return {
-            estimatedTime: `${minutes}min`,
-            complexity
-        };
-    }
-
-    /**
-     * Identifica riscos potenciais
-     */
-    private identifyRisks(taskAnalysis: any, architecture: any): string[] {
-        const risks: string[] = [];
-
-        if (architecture.database.length > 0) {
-            risks.push('Mudanças no banco de dados podem afetar dados existentes');
-        }
-
-        if (architecture.apis.length > 3) {
-            risks.push('Múltiplos endpoints podem ter impacto em performance');
-        }
-
-        if (architecture.dependencies.length > 0) {
-            risks.push('Novas dependências aumentam bundle size');
-        }
-
-        return risks;
-    }
-
-    /**
-     * Lista dependências necessárias
-     */
-    private listDependencies(architecture: any): string[] {
-        return architecture.dependencies || [];
-    }
-
-    /**
-     * Exibe plano formatado
-     */
-    private displayPlan(plan: ImplementationPlan): void {
-        console.log(`📋 Título: ${plan.title}`);
-        console.log(`📝 Descrição: ${plan.description}`);
-        console.log(`⏱️  Tempo estimado: ${plan.estimatedTime}`);
-        console.log(`🎯 Complexidade: ${plan.complexity.toUpperCase()}\n`);
-
-        console.log('🏗️  Arquitetura:');
-        if (plan.architecture.components.length > 0) {
-            console.log(`   Componentes: ${plan.architecture.components.join(', ')}`);
-        }
-        if (plan.architecture.apis.length > 0) {
-            console.log(`   APIs: ${plan.architecture.apis.join(', ')}`);
-        }
-        if (plan.architecture.database.length > 0) {
-            console.log(`   Banco: ${plan.architecture.database.join(', ')}`);
-        }
-
-        console.log(`\n📁 Arquivos (${plan.files.create.length} criar, ${plan.files.modify.length} modificar):`);
-        plan.files.create.slice(0, 5).forEach(f => console.log(`   ✨ ${f.path}`));
-        if (plan.files.create.length > 5) {
-            console.log(`   ... e mais ${plan.files.create.length - 5} arquivo(s)`);
-        }
-
-        if (plan.risks.length > 0) {
-            console.log(`\n⚠️  Riscos:`);
-            plan.risks.forEach(r => console.log(`   - ${r}`));
-        }
-
-        console.log('');
-    }
-
-    async executeTask(taskDescription: string, context: TaskContext): Promise<TaskResult> {
-        try {
-            const plan = await this.createImplementationPlan(taskDescription);
-
-            return {
-                success: true,
-                details: `Plano criado: ${plan.files.create.length} arquivos a criar`,
-                recommendations: plan.steps
-            };
-        } catch (error) {
-            return {
-                success: false,
-                details: `Erro ao criar plano: ${(error as Error).message}`
-            };
-        }
-    }
-}
+import { BaseAgent, TaskContext, TaskResult } from './base-agent.js';
+
+export interface ImplementationPlan {
+    title: string;
+    description: string;
+    architecture: {
+        components: string[];
+        apis: string[];
+        database: string[];
+        dependencies: string[];
+    };
+    files: {
+        create: Array<{
+            path: string;
+            type: 'component' | 'api' | 'hook' | 'util' | 'type' | 'config';
+            purpose: string;
+        }>;
+        modify: Array<{
+            path: string;
+            changes: string;
+        }>;
+        delete: string[];
+    };
+    steps: string[];
+    estimatedTime: string;
+    complexity: 'low' | 'medium' | 'high';
+    risks: string[];
+    dependencies: string[];
+}
+
+export class PlanningAgent extends BaseAgent {
+    constructor(_runtimePath?: string, _projectRoot: string = process.cwd()) {
+        super('planning-agent');
+    }
+
+    async createImplementationPlan(taskDescription: string): Promise<ImplementationPlan> {
+        return {
+            title: this.extractTitle(taskDescription),
+            description: taskDescription,
+            architecture: {
+                components: [],
+                apis: [],
+                database: [],
+                dependencies: [],
+            },
+            files: {
+                create: [],
+                modify: [],
+                delete: [],
+            },
+            steps: [
+                'Sincronizar documentação técnica por arquivo',
+                'Validar escopo e arquivos impactados',
+                'Aplicar mudanças mínimas necessárias',
+                'Executar validações disponíveis',
+                'Revisar diff e reportar resultado',
+            ],
+            estimatedTime: '15min',
+            complexity: 'low',
+            risks: [],
+            dependencies: [],
+        };
+    }
+
+    private extractTitle(taskDescription: string): string {
+        return taskDescription.trim().split(' ').slice(0, 6).join(' ');
+    }
+
+    async executeTask(taskDescription: string, _context: TaskContext): Promise<TaskResult> {
+        const plan = await this.createImplementationPlan(taskDescription);
+        return {
+            success: true,
+            details: `Plano criado: ${plan.title}`,
+            recommendations: plan.steps,
+        };
+    }
+}

package/.agents/core/quality-agent.md

@@ -0,0 +1,36 @@
+# quality-agent.ts
+
+> Arquivo fonte: `.agents/core/quality-agent.ts`
+
+## O que este arquivo faz
+Este arquivo expõe lógica reutilizável para outras partes do sistema, centralizando comportamento, configuração ou execução especializada.
+
+## Principais Responsabilidades
+- Expor 2 item(ns) reutilizável(is) para outras partes do sistema.
+- Definir classes ou estruturas centrais para encapsular comportamento.
+- Concentrar funções que executam a lógica principal deste arquivo.
+- Servir como ponto de manutenção para esta parte da funcionalidade.
+
+## Como funciona
+1. Carrega definições locais e dependências necessárias.
+2. Expõe a interface pública consumida por outros arquivos do projeto.
+3. Executa etapas assíncronas quando precisa consultar arquivos, serviços ou processos externos.
+4. Processa a responsabilidade principal do arquivo e retorna ou aplica o resultado esperado.
+5. Entrega a saída esperada para os consumidores diretos deste arquivo.
+
+## Dependências
+- child_process
+- fs
+- ./base-agent.js
+
+## Integrações
+- Sistema de arquivos
+
+## Segurança
+- Não há controle de segurança explícito neste arquivo; a proteção depende das camadas consumidoras e das regras globais do sistema.
+
+## Impacto da Remoção
+Sem este arquivo, consumidores diretos perdem a lógica ou a configuração que ele centraliza, causando erro funcional ou regressão de comportamento.
+
+## Resumo Técnico
+Arquivo técnico de suporte ao sistema, responsável por fornecer lógica, configuração ou interface reutilizável para outros módulos.

package/.agents/core/quality-agent.ts

@@ -25,7 +25,7 @@ export interface QualityCheckResult extends TaskResult {
 }
 
 export class QualityAgent extends BaseAgent {
-    constructor(memoryBasePath: string = '.agents/memory') {
+    constructor(memoryBasePath: string = '.agents/runtime') {
         super('quality-agent', memoryBasePath);
     }
 

package/.agents/core/rag-agent.md

@@ -0,0 +1,36 @@
+# rag-agent.ts
+
+> Arquivo fonte: `.agents/core/rag-agent.ts`
+
+## O que este arquivo faz
+Este arquivo expõe lógica reutilizável para outras partes do sistema, centralizando comportamento, configuração ou execução especializada.
+
+## Principais Responsabilidades
+- Expor 1 item(ns) reutilizável(is) para outras partes do sistema.
+- Definir classes ou estruturas centrais para encapsular comportamento.
+- Servir como ponto de manutenção para esta parte da funcionalidade.
+
+## Como funciona
+1. Carrega definições locais e dependências necessárias.
+2. Expõe a interface pública consumida por outros arquivos do projeto.
+3. Executa etapas assíncronas quando precisa consultar arquivos, serviços ou processos externos.
+4. Processa a responsabilidade principal do arquivo e retorna ou aplica o resultado esperado.
+5. Entrega a saída esperada para os consumidores diretos deste arquivo.
+
+## Dependências
+- ./base-agent.js
+- fs
+- path
+- para
+
+## Integrações
+- Não há integração externa explícita identificada neste arquivo.
+
+## Segurança
+- Não há controle de segurança explícito neste arquivo; a proteção depende das camadas consumidoras e das regras globais do sistema.
+
+## Impacto da Remoção
+Sem este arquivo, consumidores diretos perdem a lógica ou a configuração que ele centraliza, causando erro funcional ou regressão de comportamento.
+
+## Resumo Técnico
+Arquivo técnico de suporte ao sistema, responsável por fornecer lógica, configuração ou interface reutilizável para outros módulos.

package/.agents/core/report-generator.md

@@ -0,0 +1,35 @@
+# report-generator.ts
+
+> Arquivo fonte: `.agents/core/report-generator.ts`
+
+## O que este arquivo faz
+Este arquivo expõe lógica reutilizável para outras partes do sistema, centralizando comportamento, configuração ou execução especializada.
+
+## Principais Responsabilidades
+- Expor 2 item(ns) reutilizável(is) para outras partes do sistema.
+- Definir classes ou estruturas centrais para encapsular comportamento.
+- Concentrar funções que executam a lógica principal deste arquivo.
+- Servir como ponto de manutenção para esta parte da funcionalidade.
+
+## Como funciona
+1. Carrega definições locais e dependências necessárias.
+2. Expõe a interface pública consumida por outros arquivos do projeto.
+3. Processa a responsabilidade principal do arquivo e retorna ou aplica o resultado esperado.
+4. Entrega a saída esperada para os consumidores diretos deste arquivo.
+
+## Dependências
+- child_process
+- fs
+- path
+
+## Integrações
+- Sistema de arquivos
+
+## Segurança
+- Não há controle de segurança explícito neste arquivo; a proteção depende das camadas consumidoras e das regras globais do sistema.
+
+## Impacto da Remoção
+Sem este arquivo, consumidores diretos perdem a lógica ou a configuração que ele centraliza, causando erro funcional ou regressão de comportamento.
+
+## Resumo Técnico
+Arquivo técnico de suporte ao sistema, responsável por fornecer lógica, configuração ou interface reutilizável para outros módulos.

package/.agents/core/retry-utility.md

@@ -0,0 +1,34 @@
+# retry-utility.ts
+
+> Arquivo fonte: `.agents/core/retry-utility.ts`
+
+## O que este arquivo faz
+Este arquivo expõe lógica reutilizável para outras partes do sistema, centralizando comportamento, configuração ou execução especializada.
+
+## Principais Responsabilidades
+- Expor 3 item(ns) reutilizável(is) para outras partes do sistema.
+- Definir classes ou estruturas centrais para encapsular comportamento.
+- Concentrar funções que executam a lógica principal deste arquivo.
+- Servir como ponto de manutenção para esta parte da funcionalidade.
+
+## Como funciona
+1. Carrega definições locais e dependências necessárias.
+2. Expõe a interface pública consumida por outros arquivos do projeto.
+3. Executa etapas assíncronas quando precisa consultar arquivos, serviços ou processos externos.
+4. Processa a responsabilidade principal do arquivo e retorna ou aplica o resultado esperado.
+5. Entrega a saída esperada para os consumidores diretos deste arquivo.
+
+## Dependências
+- Nenhuma dependência explícita identificada pelo gerador.
+
+## Integrações
+- Não há integração externa explícita identificada neste arquivo.
+
+## Segurança
+- Não há controle de segurança explícito neste arquivo; a proteção depende das camadas consumidoras e das regras globais do sistema.
+
+## Impacto da Remoção
+Sem este arquivo, consumidores diretos perdem a lógica ou a configuração que ele centraliza, causando erro funcional ou regressão de comportamento.
+
+## Resumo Técnico
+Arquivo técnico de suporte ao sistema, responsável por fornecer lógica, configuração ou interface reutilizável para outros módulos.

package/.agents/core/security-agent.md

@@ -0,0 +1,39 @@
+# security-agent.ts
+
+> Arquivo fonte: `.agents/core/security-agent.ts`
+
+## O que este arquivo faz
+Este arquivo expõe lógica reutilizável para outras partes do sistema, centralizando comportamento, configuração ou execução especializada.
+
+## Principais Responsabilidades
+- Expor 2 item(ns) reutilizável(is) para outras partes do sistema.
+- Definir classes ou estruturas centrais para encapsular comportamento.
+- Concentrar funções que executam a lógica principal deste arquivo.
+- Servir como ponto de manutenção para esta parte da funcionalidade.
+
+## Como funciona
+1. Carrega definições locais e dependências necessárias.
+2. Expõe a interface pública consumida por outros arquivos do projeto.
+3. Executa etapas assíncronas quando precisa consultar arquivos, serviços ou processos externos.
+4. Processa a responsabilidade principal do arquivo e retorna ou aplica o resultado esperado.
+5. Entrega a saída esperada para os consumidores diretos deste arquivo.
+
+## Dependências
+- fs
+- ./base-agent.js
+
+## Integrações
+- Supabase
+- HTTP APIs externas
+- Sistema de arquivos
+
+## Segurança
+- Aplica ou referencia regras de RLS.
+- Manipula dados sensíveis e exige cuidado com exposição em logs e cliente.
+- Utiliza mecanismos de proteção criptográfica ou hashing.
+
+## Impacto da Remoção
+Sem este arquivo, consumidores diretos perdem a lógica ou a configuração que ele centraliza, causando erro funcional ou regressão de comportamento.
+
+## Resumo Técnico
+Arquivo técnico de suporte ao sistema, responsável por fornecer lógica, configuração ou interface reutilizável para outros módulos.

package/.agents/core/security-agent.ts

@@ -25,7 +25,7 @@ export interface SecurityCheckResult extends TaskResult {
 }
 
 export class SecurityAgent extends BaseAgent {
-    constructor(memoryBasePath: string = '.agents/memory') {
+    constructor(memoryBasePath: string = '.agents/runtime') {
         super('security-agent', memoryBasePath);
     }