wegho-agentes 7.0.4 → 7.0.6

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

@@ -1,347 +1,142 @@
-/**
- * Base Agent - Classe base para todos os agentes
- * 
- * Responsabilidades:
- * - Fornecer interface comum para todos os agentes
- * - Integrar sistema de memória
- * - Gerenciar consulta e registro de resultados
- * - Implementar aprendizado contínuo
- */
-
-import { MemorySystem, MemoryEntry } from './memory-system.js';
-import { WorkflowStep } from './workflow-validator.js';
-import { SkillManager, Skill } from './skill-manager.js';
-import * as fs from 'fs';
-import * as path from 'path';
-
-export interface TaskContext {
-    files: string[];
-    areas: string[];
-    complexity: 'low' | 'medium' | 'high';
-}
-
-export interface TaskResult {
-    success: boolean;
-    details: string;
-    issues?: string[];
-    warnings?: string[];
-    recommendations?: string[];
-    blockers?: string[];
-}
-
-export interface UserFeedback {
-    satisfied: boolean;
-    likes: string[];
-    dislikes: string[];
-    suggestions: string[];
-}
-
-/**
- * Classe base abstrata para agentes
- */
-export abstract class BaseAgent {
-    protected agentName: string;
-    protected memory: MemorySystem;
-    protected skillManager: SkillManager;
-    protected specialtyPath: string;
-    protected workflowSteps: WorkflowStep[] = [];
-    protected referenceReposPath: string;
-
-    constructor(agentName: string, memoryBasePath: string = '.agents/memory') {
-        this.agentName = agentName;
-        this.memory = new MemorySystem(memoryBasePath);
-        this.skillManager = new SkillManager();
-        this.specialtyPath = path.join(memoryBasePath, agentName, 'specialty.md');
-        this.referenceReposPath = path.join(memoryBasePath, 'reference-repositories.json');
-        this.ensureSpecialtyFile();
-        this.initializeWorkflowSteps();
-    }
-
-    /**
-     * Método abstrato: cada agente implementa sua lógica
-     */
-    abstract executeTask(taskDescription: string, context: TaskContext): Promise<TaskResult>;
-
-    /**
-     * Executa tarefa consultando memória
-     */
+import { WorkflowStep } from './workflow-validator.js';
+import { SkillManager } from './skill-manager.js';
+import * as fs from 'fs';
+
+export interface TaskContext {
+    files: string[];
+    areas: string[];
+    complexity: 'low' | 'medium' | 'high';
+}
+
+export interface TaskResult {
+    success: boolean;
+    details: string;
+    issues?: string[];
+    warnings?: string[];
+    recommendations?: string[];
+    blockers?: string[];
+}
+
+export interface UserFeedback {
+    satisfied: boolean;
+    likes: string[];
+    dislikes: string[];
+    suggestions: string[];
+}
+
+export abstract class BaseAgent {
+    protected agentName: string;
+    protected skillManager: SkillManager;
+    protected specialtyPath: string;
+    protected workflowSteps: WorkflowStep[] = [];
+    protected referenceReposPath: string;
+
+    constructor(agentName: string, _runtimePath: string = '.agents/runtime') {
+        this.agentName = agentName;
+        this.skillManager = new SkillManager();
+        this.specialtyPath = `.agent/agents/${agentName}.md`;
+        this.referenceReposPath = '.agents/reference-repositories.json';
+        this.initializeWorkflowSteps();
+    }
+
+    abstract executeTask(taskDescription: string, context: TaskContext): Promise<TaskResult>;
+
     async executeWithMemory(taskDescription: string, context: TaskContext): Promise<TaskResult> {
         console.log(`\n${'='.repeat(60)}`);
-        console.log(`🤖 AGENTE ATIVO: ${this.agentName.toUpperCase()}`);
+        console.log(`AGENTE ATIVO: ${this.agentName.toUpperCase()}`);
         console.log(`${'='.repeat(60)}`);
-        console.log(`📋 Tarefa: ${taskDescription}`);
-        console.log(`⏰ Início: ${new Date().toLocaleTimeString('pt-BR')}\n`);
+        console.log(`Tarefa: ${taskDescription}`);
 
-        // Resetar passos do workflow a cada execução
         this.initializeWorkflowSteps();
+        this.markStepCompleted('Validar Escopo', context);
+        await this.consultReferenceRepositories();
+        this.markStepCompleted('Consultar Repositórios');
+
+        const skills = await this.skillManager.getRelevantSkills(taskDescription);
+        this.markStepCompleted('Carregar Skills', { count: skills.length });
+
+        const result = await this.executeTask(taskDescription, context);
+
+        this.markStepCompleted('Executar Tarefa', { success: result.success });
+        this.markStepCompleted('Registrar Resultado', { success: result.success });
+        return result;
+    }
+
+    async recordOutcome(
+        _taskDescription: string,
+        _context: TaskContext,
+        _result: TaskResult,
+        _userFeedback?: UserFeedback
+    ): Promise<void> {
+        return;
+    }
 
-        // PASSO 1: Consultar casos similares
-        this.markStepCompleted('Consultar Memória', { count: 0 });
-        const similarCases = this.memory.getSimilarCases(this.agentName, taskDescription, 5);
-
-        if (similarCases.length > 0) {
-            console.log(`💭 [${this.agentName}] Encontrei ${similarCases.length} caso(s) similar(es):`);
-            similarCases.forEach((case_, index) => {
-                const emoji = case_.result === 'success' ? '✅' : '❌';
-                console.log(`  ${index + 1}. ${emoji} ${case_.taskDescription}`);
-                if (case_.userFeedback) {
-                    console.log(`     Feedback: ${case_.userFeedback.satisfied ? '👍' : '👎'}`);
-                }
-            });
-            this.updateStepDetails('Consultar Memória', { count: similarCases.length });
+    async learn(
+        _pattern: string,
+        _description: string,
+        _recommendation: string,
+        _exampleIds: string[] = []
+    ): Promise<void> {
+        return;
+    }
+
+    getStats() {
+        return {
+            totalTasks: 0,
+            successRate: 0,
+            lastUpdated: new Date(),
+        };
+    }
+
+    getSpecialty(): string {
+        if (fs.existsSync(this.specialtyPath)) {
+            return fs.readFileSync(this.specialtyPath, 'utf-8');
+        }
+
+        return 'Especialidade não definida';
+    }
+
+    private initializeWorkflowSteps(): void {
+        this.workflowSteps = [
+            { name: 'Validar Escopo', required: true, completed: false },
+            { name: 'Consultar Repositórios', required: true, completed: false },
+            { name: 'Carregar Skills', required: true, completed: false },
+            { name: 'Executar Tarefa', required: true, completed: false },
+            { name: 'Registrar Resultado', required: true, completed: false },
+        ];
+    }
+
+    protected markStepCompleted(stepName: string, details?: any): void {
+        const step = this.workflowSteps.find((item) => item.name === stepName);
+        if (step) {
+            step.completed = true;
+            step.timestamp = new Date();
+            step.details = details;
         }
+    }
 
-        // Verificar últimas mudanças relacionadas aos arquivos da tarefa
-        if (context.files && context.files.length > 0) {
-            const latestEntries = this.memory.getLatestEntriesForFiles(this.agentName, context.files, 3);
-            if (latestEntries.length > 0) {
-                console.log(`\n🕵️  [${this.agentName}] Últimas mudanças relacionadas aos arquivos da tarefa:`);
-                latestEntries.forEach((entry, index) => {
-                    const status = entry.result === 'success' ? '✅' : '❌';
-                    const when = new Date(entry.timestamp as any).toLocaleString('pt-BR');
-                    console.log(`  ${index + 1}. ${status} ${entry.taskDescription} (${when})`);
-                });
+    getWorkflowSteps(): WorkflowStep[] {
+        return [...this.workflowSteps];
+    }
+
+    protected async consultReferenceRepositories(): Promise<void> {
+        try {
+            if (!fs.existsSync(this.referenceReposPath)) {
+                return;
             }
+
+            const repos = JSON.parse(fs.readFileSync(this.referenceReposPath, 'utf-8'));
+            const relevantRepos = this.getRelevantRepositories(repos);
+
+            if (relevantRepos.length > 0) {
+                console.log(`[${this.agentName}] referências consultadas: ${relevantRepos.length}`);
+            }
+        } catch {
+            return;
         }
-
-        // PASSO 2: Obter recomendações baseadas em aprendizados
-        this.markStepCompleted('Obter Recomendações', { count: 0 });
-        const recommendations = this.memory.getRecommendations(this.agentName, taskDescription);
-
-        if (recommendations.length > 0) {
-            console.log(`\n💡 [${this.agentName}] Recomendações baseadas em aprendizados:`);
-            recommendations.forEach((rec, index) => {
-                console.log(`  ${index + 1}. ${rec}`);
-            });
-            this.updateStepDetails('Obter Recomendações', { count: recommendations.length });
-        }
-
-        // PASSO 3: Consultar repositórios de referência
-        this.markStepCompleted('Consultar Repositórios');
-        await this.consultReferenceRepositories();
-
-        // PASSO 4: Aplicar aprendizados com alta confiança
-        this.markStepCompleted('Aplicar Aprendizados');
-        this.applyHighConfidenceLearnings(recommendations);
-
-        // PASSO 5: Carregar Skills relevantes
-        this.markStepCompleted('Carregar Skills');
-        const skills = await this.skillManager.getRelevantSkills(taskDescription);
-
-        if (skills.length === 1) {
-            console.log(`\n💬 [${this.agentName}] Sou o agente ${this.agentName}, vou usar a skill ${skills[0].metadata.name}.`);
-        } else if (skills.length > 1) {
-            console.log(`\n💬 [${this.agentName}] Sou o agente ${this.agentName}, vou usar as seguintes skills para esta tarefa:`);
-            skills.forEach(skill => {
-                console.log(`   - ${skill.metadata.name}: ${skill.metadata.description}`);
-            });
-        } else {
-            console.log(`\nℹ️  [${this.agentName}] Nenhuma skill específica encontrada para esta tarefa.`);
-        }
-
-        // Executar tarefa
-        console.log(`\n⚙️  [${this.agentName}] Executando tarefa...\n`);
-        const result = await this.executeTask(taskDescription, context);
-
-        // PASSO 5: Registrar resultado
-        this.markStepCompleted('Registrar Resultado');
-        await this.recordOutcome(taskDescription, context, result);
-
-        const status = result.success ? '✅ SUCESSO' : '❌ FALHA';
-        console.log(`\n${status} [${this.agentName}] Tarefa concluída`);
-        console.log(`⏰ Término: ${new Date().toLocaleTimeString('pt-BR')}`);
-        console.log(`${'='.repeat(60)}\n`);
-
-        return result;
-    }
-
-    /**
-     * Registra resultado na memória
-     */
-    async recordOutcome(
-        taskDescription: string,
-        context: TaskContext,
-        result: TaskResult,
-        userFeedback?: UserFeedback
-    ): Promise<void> {
-        if (result.success) {
-            this.memory.recordSuccess(
-                this.agentName,
-                taskDescription,
-                context,
-                result.details,
-                userFeedback
-            );
-        } else {
-            this.memory.recordFailure(
-                this.agentName,
-                taskDescription,
-                context,
-                result.details,
-                userFeedback
-            );
-        }
-    }
-
-    /**
-     * Adiciona aprendizado baseado em feedback
-     */
-    async learn(
-        pattern: string,
-        description: string,
-        recommendation: string,
-        exampleIds: string[] = []
-    ): Promise<void> {
-        this.memory.addLearning(
-            this.agentName,
-            pattern,
-            description,
-            recommendation,
-            exampleIds
-        );
-    }
-
-    /**
-     * Obtém estatísticas do agente
-     */
-    getStats() {
-        return this.memory.getStats(this.agentName);
-    }
-
-    /**
-     * Lê arquivo de especialidade
-     */
-    getSpecialty(): string {
-        if (fs.existsSync(this.specialtyPath)) {
-            return fs.readFileSync(this.specialtyPath, 'utf-8');
-        }
-        return 'Especialidade não definida';
-    }
-
-    /**
-     * Garante que arquivo de especialidade existe
-     */
-    private ensureSpecialtyFile(): void {
-        const agentDir = path.dirname(this.specialtyPath);
-
-        if (!fs.existsSync(agentDir)) {
-            fs.mkdirSync(agentDir, { recursive: true });
-        }
-
-        if (!fs.existsSync(this.specialtyPath)) {
-            const defaultSpecialty = this.getDefaultSpecialty();
-            fs.writeFileSync(this.specialtyPath, defaultSpecialty, 'utf-8');
-        }
-    }
-
-    /**
-     * Retorna especialidade padrão (pode ser sobrescrito)
-     */
-    protected getDefaultSpecialty(): string {
-        return `# ${this.agentName} - Especialidade
-
-## Responsabilidades
-- Definir responsabilidades específicas
-
-## Expertise
-- Definir áreas de expertise
-
-## Regras
-- Definir regras específicas
-
-## Tarefas Típicas
-- Listar tarefas típicas
-`;
-    }
-
-    /**
-     * Inicializa os passos do workflow
-     */
-    private initializeWorkflowSteps(): void {
-        this.workflowSteps = [
-            { name: 'Consultar Memória', required: true, completed: false },
-            { name: 'Obter Recomendações', required: true, completed: false },
-            { name: 'Consultar Repositórios', required: true, completed: false },
-            { name: 'Aplicar Aprendizados', required: true, completed: false },
-            { name: 'Carregar Skills', required: true, completed: false },
-            { name: 'Registrar Resultado', required: true, completed: false },
-            { name: 'Gerar Aprendizados', required: false, completed: false }
-        ];
-    }
-
-    /**
-     * Marca um passo como completado
-     */
-    protected markStepCompleted(stepName: string, details?: any): void {
-        const step = this.workflowSteps.find(s => s.name === stepName);
-        if (step) {
-            step.completed = true;
-            step.timestamp = new Date();
-            step.details = details;
-        }
-    }
-
-    /**
-     * Atualiza detalhes de um passo
-     */
-    protected updateStepDetails(stepName: string, details: any): void {
-        const step = this.workflowSteps.find(s => s.name === stepName);
-        if (step) {
-            step.details = { ...step.details, ...details };
-        }
-    }
-
-    /**
-     * Retorna os passos do workflow para validação
-     */
-    getWorkflowSteps(): WorkflowStep[] {
-        return [...this.workflowSteps];
-    }
-
-    /**
-     * Consulta repositórios de referência relevantes
-     */
-    protected async consultReferenceRepositories(): Promise<void> {
-        try {
-            if (!fs.existsSync(this.referenceReposPath)) {
-                console.log(`⚠️  [${this.agentName}] Arquivo de repositórios não encontrado`);
-                return;
-            }
-
-            const repos = JSON.parse(fs.readFileSync(this.referenceReposPath, 'utf-8'));
-            const relevantRepos = this.getRelevantRepositories(repos);
-
-            if (relevantRepos.length > 0) {
-                console.log(`\n📚 [${this.agentName}] Consultando repositórios de referência:`);
-                relevantRepos.forEach(repo => {
-                    console.log(`   - ${repo.name}: ${repo.url}`);
-                });
-            }
-        } catch (error: any) {
-            console.log(`⚠️  [${this.agentName}] Erro ao consultar repositórios:`, error.message);
-        }
-    }
-
-    /**
-     * Retorna repositórios relevantes para este agente (pode ser sobrescrito)
-     */
-    protected getRelevantRepositories(repos: any): Array<{ name: string; url: string }> {
-        // Implementação padrão - pode ser sobrescrita por agentes específicos
-        return [];
-    }
-
-    /**
-     * Aplica aprendizados com alta confiança
-     */
-    protected applyHighConfidenceLearnings(recommendations: string[]): void {
-        const memory = this.memory.loadMemory(this.agentName);
-        const highConfidenceLearnings = memory.learnings.filter(l => l.confidence > 0.7);
-
-        if (highConfidenceLearnings.length > 0) {
-            console.log(`\n🎯 [${this.agentName}] Aplicando ${highConfidenceLearnings.length} aprendizado(s) de alta confiança:`);
-            highConfidenceLearnings.forEach((learning, index) => {
-                console.log(`   ${index + 1}. ${learning.recommendation} (confiança: ${(learning.confidence * 100).toFixed(0)}%)`);
-            });
-        }
-    }
-}
+    }
+
+    protected getRelevantRepositories(_repos: any): Array<{ name: string; url: string }> {
+        return [];
+    }
+}

package/.agents/core/build-manager.md

@@ -0,0 +1,35 @@
+# build-manager.ts
+
+> Arquivo fonte: `.agents/core/build-manager.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
+- 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/cache-manager.md

@@ -0,0 +1,32 @@
+# cache-manager.ts
+
+> Arquivo fonte: `.agents/core/cache-manager.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.
+- 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
+- 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/checkpoint-manager.md

@@ -0,0 +1,36 @@
+# checkpoint-manager.ts
+
+> Arquivo fonte: `.agents/core/checkpoint-manager.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
+- path
+- child_process
+
+## 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/cloud-agent.md

@@ -0,0 +1,33 @@
+# cloud-agent.ts
+
+> Arquivo fonte: `.agents/core/cloud-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
+
+## 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/cro-agent.md

@@ -0,0 +1,33 @@
+# cro-agent.ts
+
+> Arquivo fonte: `.agents/core/cro-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
+
+## 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.