wegho-agentes 7.0.4 → 7.0.6

package/skills/systematic-debugging/condition-based-waiting-example.md

@@ -0,0 +1,34 @@
+# condition-based-waiting-example.ts
+
+> Arquivo fonte: `skills/systematic-debugging/condition-based-waiting-example.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.
+- 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
+- ~/threads/thread-manager
+- ~/threads/types
+
+## 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/skills/typescript-expert/references/tsconfig-strict.md

@@ -0,0 +1,30 @@
+# tsconfig-strict.json
+
+> Arquivo fonte: `skills/typescript-expert/references/tsconfig-strict.json`
+
+## O que este arquivo faz
+Este arquivo concentra configuração ou metadados usados pelo sistema para definir comportamento, integração ou execução.
+
+## Principais Responsabilidades
+- Declarar dados ou configuração consumidos em tempo de execução.
+- Servir como ponto de manutenção para esta parte da funcionalidade.
+
+## Como funciona
+1. Carrega definições locais e dependências necessárias.
+2. Fornece valores de configuração para leitura por outros módulos ou ferramentas.
+3. 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, o sistema perde configuração necessária e pode falhar na inicialização, na integração ou na execução esperada.
+
+## Resumo Técnico
+Arquivo técnico de configuração, usado para controlar o comportamento do sistema e suas integrações.

package/skills/typescript-expert/references/utility-types.md

@@ -0,0 +1,32 @@
+# utility-types.ts
+
+> Arquivo fonte: `skills/typescript-expert/references/utility-types.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 50 item(ns) reutilizável(is) para outras partes do sistema.
+- 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
+- as
+
+## 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/skills/writing-skills/render-graphs.md

@@ -0,0 +1,32 @@
+# render-graphs.js
+
+> Arquivo fonte: `skills/writing-skills/render-graphs.js`
+
+## O que este arquivo faz
+Este arquivo contém lógica operacional usada pelo sistema para executar uma responsabilidade específica dentro do projeto.
+
+## Principais Responsabilidades
+- 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. Processa a responsabilidade principal do arquivo e retorna ou aplica o resultado esperado.
+3. 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, a responsabilidade operacional que ele concentra deixa de existir e afeta o fluxo que depende dessa implementação.
+
+## Resumo Técnico
+Arquivo técnico com responsabilidade localizada no sistema, necessário para manter o fluxo funcional dessa parte do projeto.

package/.agents/AI_COMPATIBILITY.md

@@ -1,333 +0,0 @@
-# Guia de Compatibilidade com IAs - Sistema de Agentes
-
-## 🎯 Objetivo
-
-Este documento garante que **TODAS as IAs** (Gemini, Claude, GPT) entendam e trabalhem corretamente com o sistema de agentes.
-
----
-
-## 🤖 IAs Suportadas
-
-Este sistema é **100% compatível** com:
-
-1. ✅ **Google Gemini** (Gemini 1.5 Pro, Gemini 2.0, etc)
-2. ✅ **Anthropic Claude** (Claude 3.5 Sonnet, Claude 3 Opus, etc)
-3. ✅ **OpenAI GPT** (GPT-4, GPT-4 Turbo, GPT-3.5, etc)
-
----
-
-## 📋 Instruções para TODAS as IAs
-
-### Quando Trabalhar com Este Sistema
-
-**SEMPRE siga estas regras:**
-
-1. **Identifique-se como agente ativo**
-   ```
-   ============================================================
-   🤖 AGENTE ATIVO: FRONTEND-AGENT
-   ============================================================
-   📋 Tarefa: Validar componente de login
-   ⏰ Início: 23:27:00
-   ```
-
-2. **Consulte memória ANTES de executar**
-   - Buscar casos similares
-   - Obter recomendações
-   - Consultar repositórios de referência
-
-3. **Mostre progresso durante execução**
-   ```
-   ⚙️  [frontend-agent] Executando tarefa...
-   ```
-
-4. **Indique conclusão claramente**
-   ```
-   ✅ SUCESSO [frontend-agent] Tarefa concluída
-   ⏰ Término: 23:27:45
-   ============================================================
-   ```
-
-5. **Registre resultado na memória**
-   - Salvar em `successes.json` ou `failures.json`
-   - Incluir contexto completo
-
----
-
-## 🔄 Fluxo Obrigatório para Todas as IAs
-
-### 1. Inicialização
-
-```typescript
-// Gemini, Claude ou GPT executando:
-const agent = new FrontEndAgent('.agents/memory');
-// Cria estrutura de memória automaticamente
-```
-
-### 2. Antes de Executar
-
-```typescript
-// TODAS as IAs DEVEM:
-console.log(`\n${'='.repeat(60)}`);
-console.log(`🤖 AGENTE ATIVO: ${agentName.toUpperCase()}`);
-console.log(`${'='.repeat(60)}`);
-console.log(`📋 Tarefa: ${taskDescription}`);
-console.log(`⏰ Início: ${new Date().toLocaleTimeString('pt-BR')}\n`);
-
-// Consultar memória
-const similarCases = this.memory.getSimilarCases(...);
-const recommendations = this.memory.getRecommendations(...);
-```
-
-### 3. Durante Execução
-
-```typescript
-// Mostrar progresso
-console.log(`\n⚙️  [${agentName}] Executando tarefa...\n`);
-
-// Executar validações
-const result = await this.executeTask(...);
-```
-
-### 4. Após Execução
-
-```typescript
-// Mostrar resultado
-const status = result.success ? '✅ SUCESSO' : '❌ FALHA';
-console.log(`\n${status} [${agentName}] Tarefa concluída`);
-console.log(`⏰ Término: ${new Date().toLocaleTimeString('pt-BR')}`);
-console.log(`${'='.repeat(60)}\n`);
-
-// Registrar na memória
-this.recordOutcome(...);
-```
-
----
-
-## 📝 Formato de Mensagens
-
-### Para Gemini
-
-```
-Você é o [NOME-DO-AGENTE]. 
-
-Sua tarefa: [DESCRIÇÃO]
-
-SEMPRE:
-1. Anuncie que você é o agente ativo
-2. Consulte memória antes de executar
-3. Mostre progresso durante execução
-4. Registre resultado na memória
-```
-
-### Para Claude
-
-```
-You are the [AGENT-NAME].
-
-Your task: [DESCRIPTION]
-
-ALWAYS:
-1. Announce yourself as the active agent
-2. Consult memory before executing
-3. Show progress during execution
-4. Record result in memory
-```
-
-### Para GPT
-
-```
-You are the [AGENT-NAME].
-
-Task: [DESCRIPTION]
-
-Required steps:
-1. Announce yourself as active agent
-2. Check memory for similar cases
-3. Execute with progress updates
-4. Save result to memory
-```
-
----
-
-## 🎨 Padrão Visual Obrigatório
-
-Todas as IAs DEVEM usar este formato:
-
-```
-============================================================
-🤖 AGENTE ATIVO: [NOME-DO-AGENTE]
-============================================================
-📋 Tarefa: [descrição da tarefa]
-⏰ Início: [HH:MM:SS]
-
-💭 [agente] Encontrei X caso(s) similar(es):
-  1. ✅ [descrição]
-  2. ❌ [descrição]
-
-💡 [agente] Recomendações baseadas em aprendizados:
-  1. [recomendação]
-  2. [recomendação]
-
-⚙️  [agente] Executando tarefa...
-
-[... output da execução ...]
-
-✅ SUCESSO [agente] Tarefa concluída
-⏰ Término: [HH:MM:SS]
-============================================================
-```
-
----
-
-## 🔍 Identificação de Agentes
-
-Cada IA deve saber qual agente está executando:
-
-| Agente | Identificador | Emoji |
-|--------|---------------|-------|
-| Frontend | `frontend-agent` | 🎨 |
-| Security | `security-agent` | 🔒 |
-| Architecture | `architecture-agent` | 🏗️ |
-| Quality | `quality-agent` | ✅ |
-| Documentation | `documentation-agent` | 📚 |
-| Pentest | `pentest-agent` | 🐍 |
-| CMS | `cms-agent` | 📰 |
-| SEO | `seo-agent` | 🔍 |
-| Production Control | `production-control-agent` | 🏭 |
-| Route | `route-agent` | 🚚 |
-| Orchestrator | `orchestrator` | 🎯 |
-
----
-
-## 📂 Estrutura de Memória (Todas as IAs)
-
-Todas as IAs trabalham com a mesma estrutura:
-
-```
-.agents/memory/
-├── [agente-name]/
-│   ├── specialty.md          # Leia para entender especialidade
-│   ├── successes.json        # Consulte antes de executar
-│   ├── failures.json         # Aprenda com erros passados
-│   └── learnings.json        # Aplique recomendações
-└── reference-repositories.json  # 27 recursos públicos
-```
-
----
-
-## 🌐 Repositórios de Referência
-
-Todas as IAs DEVEM consultar quando relevante:
-
-```typescript
-// Carregar repositórios
-const repos = JSON.parse(
-    fs.readFileSync('.agents/memory/reference-repositories.json', 'utf-8')
-);
-
-// Gemini consultando React
-const reactDocs = repos.repositories.react.docs;
-
-// Claude consultando OWASP
-const owaspTop10 = repos.security_resources.owasp_top_10.url;
-
-// GPT consultando TypeScript
-const tsDocs = repos.repositories.typescript.docs;
-```
-
----
-
-## ✅ Checklist para Todas as IAs
-
-Antes de executar qualquer tarefa:
-
-- [ ] Anunciar qual agente está ativo
-- [ ] Mostrar timestamp de início
-- [ ] Consultar memória (successes, failures, learnings)
-- [ ] Consultar repositórios de referência
-- [ ] Mostrar casos similares encontrados
-- [ ] Mostrar recomendações baseadas em aprendizados
-
-Durante execução:
-
-- [ ] Mostrar progresso (`⚙️  [agente] Executando...`)
-- [ ] Aplicar aprendizados com alta confiança (>0.7)
-
-Após execução:
-
-- [ ] Mostrar status (✅ SUCESSO ou ❌ FALHA)
-- [ ] Mostrar timestamp de término
-- [ ] Registrar resultado na memória
-- [ ] Incluir contexto completo (files, areas, complexity)
-
----
-
-## 🎯 Exemplo Completo (Qualquer IA)
-
-```typescript
-// Gemini, Claude ou GPT executando:
-
-console.log(`\n${'='.repeat(60)}`);
-console.log(`🤖 AGENTE ATIVO: FRONTEND-AGENT`);
-console.log(`${'='.repeat(60)}`);
-console.log(`📋 Tarefa: Validar componente de login`);
-console.log(`⏰ Início: 23:27:00\n`);
-
-// Consultar memória
-const similar = memory.getSimilarCases('frontend-agent', 'login', 5);
-console.log(`💭 [frontend-agent] Encontrei ${similar.length} caso(s) similar(es):`);
-
-// Executar
-console.log(`\n⚙️  [frontend-agent] Executando tarefa...\n`);
-const result = await agent.executeTask(...);
-
-// Concluir
-console.log(`\n✅ SUCESSO [frontend-agent] Tarefa concluída`);
-console.log(`⏰ Término: 23:27:45`);
-console.log(`${'='.repeat(60)}\n`);
-
-// Registrar
-memory.recordSuccess(...);
-```
-
----
-
-## 🚨 Regras Críticas
-
-**TODAS as IAs DEVEM:**
-
-1. ✅ Sempre identificar qual agente está trabalhando
-2. ✅ Sempre consultar memória antes de executar
-3. ✅ Sempre mostrar progresso durante execução
-4. ✅ Sempre registrar resultado na memória
-5. ✅ Sempre usar formato visual padronizado
-
-**NUNCA:**
-
-❌ Executar sem anunciar qual agente está ativo  
-❌ Ignorar memória de casos similares  
-❌ Executar sem mostrar progresso  
-❌ Esquecer de registrar resultado  
-❌ Usar formato diferente do padrão  
-
----
-
-## 📊 Compatibilidade Testada
-
-| IA | Versão | Status | Notas |
-|----|--------|--------|-------|
-| Gemini | 1.5 Pro | ✅ | Totalmente compatível |
-| Gemini | 2.0 | ✅ | Totalmente compatível |
-| Claude | 3.5 Sonnet | ✅ | Totalmente compatível |
-| Claude | 3 Opus | ✅ | Totalmente compatível |
-| GPT | 4 Turbo | ✅ | Totalmente compatível |
-| GPT | 4 | ✅ | Totalmente compatível |
-| GPT | 3.5 | ✅ | Totalmente compatível |
-
----
-
-**Versão**: 1.0  
-**Última Atualização**: 2026-01-22  
-**Compatível com**: Gemini, Claude, GPT
-

package/.agents/core/feedback-collector.ts

@@ -1,207 +0,0 @@
-/**
- * Feedback Collector - Coletor de Feedback do Usuário
- * 
- * Responsabilidades:
- * - Coletar feedback do usuário após tarefas
- * - Registrar feedback na memória dos agentes
- * - Analisar padrões em feedbacks
- * - Gerar sugestões baseadas em histórico
- */
-
-import { MemorySystem, MemoryEntry } from './memory-system';
-import { TaskContext } from './base-agent';
-
-export interface UserFeedback {
-    taskId: string;
-    agentName: string;
-    satisfied: boolean;
-    likes: string[];
-    dislikes: string[];
-    suggestions: string[];
-    timestamp: Date;
-}
-
-export interface FeedbackPrompt {
-    question: string;
-    type: 'boolean' | 'text' | 'multipleChoice';
-    options?: string[];
-}
-
-export class FeedbackCollector {
-    private memory: MemorySystem;
-
-    constructor(memoryBasePath: string = '.agents/memory') {
-        this.memory = new MemorySystem(memoryBasePath);
-    }
-
-    /**
-     * Coleta feedback do usuário (simulado - em produção seria interativo)
-     */
-    async collectFeedback(
-        taskId: string,
-        agentName: string,
-        taskDescription: string
-    ): Promise<UserFeedback | null> {
-        console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-        console.log('📝 FEEDBACK DO USUÁRIO');
-        console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
-        console.log(`Tarefa: ${taskDescription}`);
-        console.log(`Agente: ${agentName}\n`);
-
-        // Em produção, isso seria um prompt interativo
-        // Por enquanto, retornamos null para indicar que o feedback será coletado manualmente
-        console.log('💡 Para fornecer feedback, use o método provideFeedback()');
-        console.log('   Exemplo: feedbackCollector.provideFeedback(taskId, agentName, {...})\n');
-
-        return null;
-    }
-
-    /**
-     * Fornece feedback manualmente
-     */
-    async provideFeedback(feedback: UserFeedback): Promise<void> {
-        console.log(`\n✅ Feedback recebido para ${feedback.agentName}`);
-        console.log(`   Satisfeito: ${feedback.satisfied ? '👍 Sim' : '👎 Não'}`);
-
-        if (feedback.likes.length > 0) {
-            console.log(`   Gostou: ${feedback.likes.join(', ')}`);
-        }
-
-        if (feedback.dislikes.length > 0) {
-            console.log(`   Não gostou: ${feedback.dislikes.join(', ')}`);
-        }
-
-        if (feedback.suggestions.length > 0) {
-            console.log(`   Sugestões: ${feedback.suggestions.join(', ')}`);
-        }
-
-        // Analisar feedback e gerar aprendizados
-        await this.analyzeFeedback(feedback);
-    }
-
-    /**
-     * Analisa feedback e gera aprendizados
-     */
-    private async analyzeFeedback(feedback: UserFeedback): Promise<void> {
-        // Se não está satisfeito, criar aprendizado negativo
-        if (!feedback.satisfied && feedback.dislikes.length > 0) {
-            for (const dislike of feedback.dislikes) {
-                this.memory.addLearning(
-                    feedback.agentName,
-                    `Evitar: ${dislike}`,
-                    `Usuário não gostou de: ${dislike}`,
-                    `Evitar fazer: ${dislike}`,
-                    [feedback.taskId]
-                );
-            }
-        }
-
-        // Se está satisfeito, criar aprendizado positivo
-        if (feedback.satisfied && feedback.likes.length > 0) {
-            for (const like of feedback.likes) {
-                this.memory.addLearning(
-                    feedback.agentName,
-                    `Repetir: ${like}`,
-                    `Usuário gostou de: ${like}`,
-                    `Continuar fazendo: ${like}`,
-                    [feedback.taskId]
-                );
-            }
-        }
-
-        // Processar sugestões
-        if (feedback.suggestions.length > 0) {
-            for (const suggestion of feedback.suggestions) {
-                this.memory.addLearning(
-                    feedback.agentName,
-                    `Sugestão: ${suggestion}`,
-                    `Usuário sugeriu: ${suggestion}`,
-                    `Considerar implementar: ${suggestion}`,
-                    [feedback.taskId]
-                );
-            }
-        }
-
-        console.log(`\n🧠 Aprendizados registrados para ${feedback.agentName}`);
-    }
-
-    /**
-     * Obtém padrões de feedback
-     */
-    getFeedbackPatterns(agentName: string): {
-        commonLikes: string[];
-        commonDislikes: string[];
-        commonSuggestions: string[];
-    } {
-        const agentMemory = this.memory.loadMemory(agentName);
-
-        // Extrair padrões dos aprendizados
-        const likes = agentMemory.learnings
-            .filter(l => l.pattern.startsWith('Repetir:'))
-            .sort((a, b) => b.occurrences - a.occurrences)
-            .slice(0, 5)
-            .map(l => l.pattern.replace('Repetir: ', ''));
-
-        const dislikes = agentMemory.learnings
-            .filter(l => l.pattern.startsWith('Evitar:'))
-            .sort((a, b) => b.occurrences - a.occurrences)
-            .slice(0, 5)
-            .map(l => l.pattern.replace('Evitar: ', ''));
-
-        const suggestions = agentMemory.learnings
-            .filter(l => l.pattern.startsWith('Sugestão:'))
-            .sort((a, b) => b.occurrences - a.occurrences)
-            .slice(0, 5)
-            .map(l => l.pattern.replace('Sugestão: ', ''));
-
-        return {
-            commonLikes: likes,
-            commonDislikes: dislikes,
-            commonSuggestions: suggestions,
-        };
-    }
-
-    /**
-     * Gera relatório de feedback
-     */
-    generateFeedbackReport(agentName: string): string {
-        const patterns = this.getFeedbackPatterns(agentName);
-        const stats = this.memory.getStats(agentName);
-
-        let report = `\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
-        report += `📊 RELATÓRIO DE FEEDBACK - ${agentName}\n`;
-        report += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n`;
-
-        report += `📈 Estatísticas:\n`;
-        report += `   Total de tarefas: ${stats.totalTasks}\n`;
-        report += `   Taxa de sucesso: ${(stats.successRate * 100).toFixed(1)}%\n\n`;
-
-        if (patterns.commonLikes.length > 0) {
-            report += `👍 O que os usuários mais gostam:\n`;
-            patterns.commonLikes.forEach((like, i) => {
-                report += `   ${i + 1}. ${like}\n`;
-            });
-            report += `\n`;
-        }
-
-        if (patterns.commonDislikes.length > 0) {
-            report += `👎 O que os usuários não gostam:\n`;
-            patterns.commonDislikes.forEach((dislike, i) => {
-                report += `   ${i + 1}. ${dislike}\n`;
-            });
-            report += `\n`;
-        }
-
-        if (patterns.commonSuggestions.length > 0) {
-            report += `💡 Sugestões recorrentes:\n`;
-            patterns.commonSuggestions.forEach((suggestion, i) => {
-                report += `   ${i + 1}. ${suggestion}\n`;
-            });
-            report += `\n`;
-        }
-
-        report += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
-
-        return report;
-    }
-}