wegho-agentes 7.0.0 → 7.0.1

package/.agents/examples/reporting-example.md

@@ -1,203 +0,0 @@
-# 📊 Exemplo de Reporting Completo
-
-## ❌ ANTES: Sem Sistema de Reporting
-
-```
-Usuário: "Crie um componente de login com validação"
-
-Agente: Vou criar o componente...
-
-[... código é gerado ...]
-
-Agente: Pronto! Criei o componente LoginForm.tsx com validações.
-```
-
-**Problemas**:
-- ❌ Não mostra quais agentes foram usados
-- ❌ Não mostra nível de contexto
-- ❌ Não explica POR QUÊ as escolhas foram feitas
-- ❌ Não mostra o ANTES vs DEPOIS
-- ❌ Não documenta memórias (boas e ruins)
-- ❌ Não há plano antes de executar
-
----
-
-## ✅ DEPOIS: Com Sistema de Reporting
-
-```markdown
-Usuário: "Crie um componente de login com validação"
-
----
-
-📊 CONTEXTO ATUAL
-🟡 **MÉDIO** (54%)
-Espaço suficiente para esta tarefa.
-
-[████████████████░░░░░░░░░░░░░░] 54%
-
----
-
-📋 PLANO DE EXECUÇÃO
-
-## ⚙️ O Que Será Feito
-- [ ] Criar componente LoginForm.tsx
-- [ ] Adicionar validação de email (regex)
-- [ ] Adicionar validação de senha (min 8 chars)
-- [ ] Integrar com Supabase Auth
-- [ ] Adicionar feedback visual de erros
-
-## 🤖 Agentes que Serão Usados
-- [ ] **Frontend Agent** - Criar componente React
-- [ ] **Security Agent** - Validar padrões de segurança
-- [ ] **Testing Agent** - Criar testes unitários
-
-## 📊 Estimativa de Contexto
-**Contexto Atual**: Médio (54%)
-**Contexto Após Tarefa**: Médio-Alto (~72%)
-**Ação Recomendada**: Continuar nesta conversa
-
-## 🎯 Critérios de Sucesso
-- ✅ Componente funcional
-- ✅ Validação de email funcionando
-- ✅ Validação de senha funcionando
-- ✅ Sem vulnerabilidades
-- ✅ Testes passando
-
-## 🚨 Possíveis Bloqueadores
-- ⚠️ Pode precisar atualizar @supabase/auth-helpers
-- ⚠️ Regex de email pode precisar ajuste
-
----
-
-[Aguardando confirmação do usuário...]
-
----
-
-🤖 AGENTES ATIVOS:
-  🔄 Frontend Agent - Criando componente LoginForm (2s)
-
----
-
-✅ EXECUTANDO...
-
----
-
-📝 RELATÓRIO DE MUDANÇAS
-
-## 🤖 Agente Responsável
-**Frontend Agent**
-
-## 📊 Contexto
-- **Nível de contexto**: Médio-Alto (72%)
-- **Status**: ✅ Dentro do limite saudável
-
-## ✅ O Que Foi Feito
-- Criado `components/auth/LoginForm.tsx`
-- Adicionadas validações de email e senha
-- Integrado com Supabase Auth (signInWithPassword)
-- Adicionado feedback visual de erros com toast
-
-## 🎯 Por Que Foi Feito
-- **Necessidade**: Sistema precisa de autenticação de usuários
-- **Validação**: Previne erros de input antes de chamar API
-- **Segurança**: Validação client-side + server-side (RLS)
-- **UX**: Feedback visual melhora experiência do usuário
-
-## 📊 Antes vs Depois
-
-### ANTES
-```typescript
-// Não existia
-```
-
-### DEPOIS
-```typescript
-'use client';
-
-import { useState } from 'react';
-import { z } from 'zod';
-import { supabase } from '@/lib/supabase';
-
-const loginSchema = z.object({
-  email: z.string().email('Email inválido'),
-  password: z.string().min(8, 'Mínimo 8 caracteres')
-});
-
-export function LoginForm() {
-  // Validação de email com zod
-  // Validação de senha (min 8 chars)
-  // Integração com Supabase Auth
-  // Feedback visual de erros
-}
-```
-
-## 🔍 Diferenças Importantes
-- ➕ **Adicionado**: Validação regex de email (RFC 5322)
-- ➕ **Adicionado**: Validação de senha (mínimo 8 caracteres)
-- ➕ **Adicionado**: Integração com Supabase Auth
-- ➕ **Adicionado**: Feedback de erros com toast notifications
-- ➕ **Adicionado**: Loading state durante autenticação
-
-## 💾 MEMÓRIAS SALVAS
-
-### ✅ Frontend Agent (Boa)
-- Padrão de validação com zod funciona muito bem
-- Toast notifications melhoram UX
-- Separar validação client/server é boa prática
-
-### ❌ Security Agent (Atenção)
-- Quase esqueci de adicionar rate limiting no Supabase
-- Validação client-side NÃO substitui server-side (RLS)
-
----
-
-📊 DASHBOARD DE MEMÓRIAS
-
-┌──────────────────────────────────────────────────┐
-│ Frontend Agent                                   │
-├──────────────────────────────────────────────────┤
-│ ✅ Memórias Boas: 13                             │
-│   - Padrão de validação com zod (6x sucesso)    │
-│   - Estrutura de componentes (3x)               │
-│   - State management com Zustand (4x)           │
-│                                                  │
-│ ❌ Memórias Ruins: 3                             │
-│   - Esquecer PropTypes (2x erro)                │
-│   - Não validar props opcionais (1x)            │
-│                                                  │
-│ 📈 Taxa de Sucesso: 81%                          │
-└──────────────────────────────────────────────────┘
-
----
-
-📊 CONTEXTO FINAL: Médio-Alto (72%)
-⚠️ Ainda há espaço, mas monitore o crescimento.
-
----
-
-**Status**: ✅ Tarefa concluída com sucesso!
-```
-
----
-
-## 🎯 Comparação
-
-| Aspecto | SEM Reporting | COM Reporting |
-|---------|---------------|---------------|
-| **Transparência** | ❌ Baixa | ✅ Total |
-| **Controle de Contexto** | ❌ Sem aviso | ✅ Aviso proativo |
-| **Rastreabilidade** | ❌ Não sabe quem fez | ✅ Agente + timestamp |
-| **Explicação** | ❌ Só mostra resultado | ✅ Explica POR QUÊ |
-| **Aprendizado** | ❌ Sem histórico | ✅ Dashboard de memórias |
-| **Planejamento** | ❌ Executa direto | ✅ Plano antes de executar |
-
----
-
-## ✨ Benefícios do Novo Sistema
-
-1. **📊 Transparência Total**: Usuário sempre sabe o que está acontecendo
-2. **⚠️ Controle de Contexto**: Aviso antes de estourar limite
-3. **📝 Rastreabilidade**: Sabe exatamente quem fez o quê e quando
-4. **🧠 Aprendizado Visível**: Dashboard mostra padrões de sucesso e erro
-5. **✅ Planejamento Obrigatório**: Sempre há confirmação antes de executar
-6. **🔍 Explicação Detalhada**: Entende POR QUÊ as decisões foram tomadas

package/.agents/managers/build-manager.ts

@@ -1,304 +0,0 @@
-/**
- * Build Manager - Sistema de Build Incremental
- * 
- * Responsabilidades:
- * - Rastrear todas as mudanças de arquivos
- * - Versionar builds incrementalmente (build 1 → build 780)
- * - Criar snapshots de arquivos modificados
- * - Manter histórico completo de builds
- * 
- * Estrutura:
- * projeto/
- * ├── .builds/
- * │   ├── history.json
- * │   └── snapshots/
- * │       └── 0.0.1/
- * │           └── arquivo.ts/
- * │               ├── build-001.ts
- * │               ├── build-002.ts
- * │               └── build-780.ts
- */
-
-import * as fs from 'fs';
-import * as path from 'path';
-
-export interface BuildEntry {
-    buildNumber: number;
-    version: string;
-    timestamp: string;
-    agent: string;
-    files: string[];
-    success: boolean;
-    description?: string;
-}
-
-export interface BuildHistory {
-    currentVersion: string;
-    currentBuild: number;
-    builds: BuildEntry[];
-}
-
-export class BuildManager {
-    private projectRoot: string;
-    private buildsDir: string;
-    private historyFile: string;
-    private snapshotsDir: string;
-    private history: BuildHistory;
-
-    constructor(projectRoot: string = process.cwd()) {
-        this.projectRoot = projectRoot;
-
-        // Use package-relative path instead of project root
-        const packageRoot = path.join(__dirname, '..', '..');
-        this.buildsDir = path.join(packageRoot, '.system', 'builds');
-        this.historyFile = path.join(this.buildsDir, 'history.json');
-        this.snapshotsDir = path.join(this.buildsDir, 'snapshots');
-
-        this.ensureDirectories();
-        this.history = this.loadHistory();
-    }
-
-    /**
-     * Cria diretórios necessários
-     */
-    private ensureDirectories(): void {
-        if (!fs.existsSync(this.buildsDir)) {
-            fs.mkdirSync(this.buildsDir, { recursive: true });
-        }
-        if (!fs.existsSync(this.snapshotsDir)) {
-            fs.mkdirSync(this.snapshotsDir, { recursive: true });
-        }
-    }
-
-    /**
-     * Carrega histórico de builds
-     */
-    private loadHistory(): BuildHistory {
-        if (fs.existsSync(this.historyFile)) {
-            try {
-                const content = fs.readFileSync(this.historyFile, 'utf-8');
-                return JSON.parse(content);
-            } catch (error) {
-                console.warn('⚠️  Erro ao carregar histórico de builds, criando novo');
-            }
-        }
-
-        return {
-            currentVersion: '0.0.1',
-            currentBuild: 0,
-            builds: []
-        };
-    }
-
-    /**
-     * Salva histórico de builds
-     */
-    private saveHistory(): void {
-        fs.writeFileSync(
-            this.historyFile,
-            JSON.stringify(this.history, null, 2),
-            'utf-8'
-        );
-    }
-
-    /**
-     * Incrementa build e cria snapshot
-     */
-    async createBuild(
-        files: string[],
-        agent: string,
-        success: boolean,
-        description?: string
-    ): Promise<number> {
-        this.history.currentBuild++;
-        const buildNumber = this.history.currentBuild;
-
-        console.log(`\n📦 Criando Build ${buildNumber}...`);
-
-        // Criar snapshots dos arquivos modificados
-        const savedFiles: string[] = [];
-        for (const filePath of files) {
-            if (fs.existsSync(filePath)) {
-                const snapshotPath = await this.createSnapshot(filePath, buildNumber);
-                if (snapshotPath) {
-                    savedFiles.push(snapshotPath);
-                }
-            }
-        }
-
-        // Registrar build no histórico
-        const buildEntry: BuildEntry = {
-            buildNumber,
-            version: this.history.currentVersion,
-            timestamp: new Date().toISOString(),
-            agent,
-            files: savedFiles,
-            success,
-            description
-        };
-
-        this.history.builds.push(buildEntry);
-        this.saveHistory();
-
-        console.log(`✅ Build ${buildNumber} criado com sucesso`);
-        console.log(`   Arquivos: ${savedFiles.length}`);
-        console.log(`   Agente: ${agent}`);
-
-        return buildNumber;
-    }
-
-    /**
-     * Cria snapshot de um arquivo
-     */
-    private async createSnapshot(filePath: string, buildNumber: number): Promise<string | null> {
-        try {
-            // Caminho relativo ao projeto
-            const relativePath = path.relative(this.projectRoot, filePath);
-
-            // Diretório do snapshot: .builds/snapshots/0.0.1/arquivo.ts/
-            const snapshotDir = path.join(
-                this.snapshotsDir,
-                this.history.currentVersion,
-                relativePath
-            );
-
-            // Criar diretório se não existir
-            if (!fs.existsSync(snapshotDir)) {
-                fs.mkdirSync(snapshotDir, { recursive: true });
-            }
-
-            // Arquivo snapshot: build-001.ts
-            const ext = path.extname(filePath);
-            const snapshotFile = path.join(
-                snapshotDir,
-                `build-${buildNumber.toString().padStart(3, '0')}${ext}`
-            );
-
-            // Copiar arquivo
-            const content = fs.readFileSync(filePath, 'utf-8');
-            fs.writeFileSync(snapshotFile, content, 'utf-8');
-
-            return path.relative(this.buildsDir, snapshotFile);
-        } catch (error) {
-            console.error(`❌ Erro ao criar snapshot de ${filePath}:`, error);
-            return null;
-        }
-    }
-
-    /**
-     * Incrementa versão (0.0.1 → 0.0.2)
-     */
-    incrementVersion(type: 'major' | 'minor' | 'patch' = 'patch'): string {
-        const [major, minor, patch] = this.history.currentVersion.split('.').map(Number);
-
-        switch (type) {
-            case 'major':
-                this.history.currentVersion = `${major + 1}.0.0`;
-                break;
-            case 'minor':
-                this.history.currentVersion = `${major}.${minor + 1}.0`;
-                break;
-            case 'patch':
-                this.history.currentVersion = `${major}.${minor}.${patch + 1}`;
-                break;
-        }
-
-        this.history.currentBuild = 0; // Reset build counter
-        this.saveHistory();
-
-        console.log(`📌 Versão incrementada para ${this.history.currentVersion}`);
-        return this.history.currentVersion;
-    }
-
-    /**
-     * Obtém histórico de builds
-     */
-    getHistory(): BuildHistory {
-        return this.history;
-    }
-
-    /**
-     * Obtém build atual
-     */
-    getCurrentBuild(): number {
-        return this.history.currentBuild;
-    }
-
-    /**
-     * Obtém versão atual
-     */
-    getCurrentVersion(): string {
-        return this.history.currentVersion;
-    }
-
-    /**
-     * Obtém builds de um arquivo específico
-     */
-    getFileBuilds(filePath: string): BuildEntry[] {
-        const relativePath = path.relative(this.projectRoot, filePath);
-        return this.history.builds.filter(build =>
-            build.files.some(f => f.includes(relativePath))
-        );
-    }
-
-    /**
-     * Restaura arquivo de um build específico
-     */
-    async restoreFromBuild(filePath: string, buildNumber: number): Promise<boolean> {
-        try {
-            const relativePath = path.relative(this.projectRoot, filePath);
-            const ext = path.extname(filePath);
-
-            const snapshotFile = path.join(
-                this.snapshotsDir,
-                this.history.currentVersion,
-                relativePath,
-                `build-${buildNumber.toString().padStart(3, '0')}${ext}`
-            );
-
-            if (!fs.existsSync(snapshotFile)) {
-                console.error(`❌ Build ${buildNumber} não encontrado para ${filePath}`);
-                return false;
-            }
-
-            const content = fs.readFileSync(snapshotFile, 'utf-8');
-            fs.writeFileSync(filePath, content, 'utf-8');
-
-            console.log(`✅ Arquivo restaurado do build ${buildNumber}`);
-            return true;
-        } catch (error) {
-            console.error(`❌ Erro ao restaurar do build ${buildNumber}:`, error);
-            return false;
-        }
-    }
-
-    /**
-     * Gera relatório de builds
-     */
-    generateReport(): string {
-        const report = [`\n📊 RELATÓRIO DE BUILDS\n${'='.repeat(60)}`];
-
-        report.push(`Versão Atual: ${this.history.currentVersion}`);
-        report.push(`Build Atual: ${this.history.currentBuild}`);
-        report.push(`Total de Builds: ${this.history.builds.length}\n`);
-
-        if (this.history.builds.length > 0) {
-            report.push('Últimos 10 Builds:');
-            const recent = this.history.builds.slice(-10).reverse();
-
-            for (const build of recent) {
-                const status = build.success ? '✅' : '❌';
-                const date = new Date(build.timestamp).toLocaleString('pt-BR');
-                report.push(`${status} Build ${build.buildNumber} - ${date}`);
-                report.push(`   Agente: ${build.agent}`);
-                if (build.description) {
-                    report.push(`   Descrição: ${build.description}`);
-                }
-                report.push(`   Arquivos: ${build.files.length}`);
-            }
-        }
-
-        report.push(`${'='.repeat(60)}\n`);
-        return report.join('\n');
-    }
-}

package/.agents/managers/cache-manager.ts

@@ -1,184 +0,0 @@
-/**
- * Cache Manager - Sistema de cache inteligente com TTL
- * 
- * Reduz latência de consultas à memória em até 80%
- * ao cachear resultados frequentes em memória
- */
-
-export interface CacheEntry<T> {
-    data: T;
-    expiry: number;
-    hits: number;
-    createdAt: number;
-}
-
-export interface CacheStats {
-    hits: number;
-    misses: number;
-    size: number;
-    hitRate: number;
-}
-
-export class CacheManager {
-    private cache = new Map<string, CacheEntry<any>>();
-    private readonly defaultTTL: number;
-    private readonly maxSize: number;
-    private stats = {
-        hits: 0,
-        misses: 0
-    };
-
-    constructor(defaultTTL: number = 300000, maxSize: number = 1000) {
-        this.defaultTTL = defaultTTL; // 5 minutos padrão
-        this.maxSize = maxSize;
-    }
-
-    /**
-     * Obtém valor do cache
-     */
-    get<T>(key: string): T | null {
-        const entry = this.cache.get(key);
-
-        if (!entry) {
-            this.stats.misses++;
-            return null;
-        }
-
-        // Verificar se expirou
-        if (Date.now() > entry.expiry) {
-            this.cache.delete(key);
-            this.stats.misses++;
-            return null;
-        }
-
-        // Incrementar hits
-        entry.hits++;
-        this.stats.hits++;
-
-        return entry.data as T;
-    }
-
-    /**
-     * Define valor no cache
-     */
-    set<T>(key: string, data: T, ttl?: number): void {
-        // Verificar limite de tamanho
-        if (this.cache.size >= this.maxSize && !this.cache.has(key)) {
-            this.evictLRU();
-        }
-
-        const expiryTime = ttl || this.defaultTTL;
-
-        this.cache.set(key, {
-            data,
-            expiry: Date.now() + expiryTime,
-            hits: 0,
-            createdAt: Date.now()
-        });
-    }
-
-    /**
-     * Remove entrada do cache
-     */
-    delete(key: string): boolean {
-        return this.cache.delete(key);
-    }
-
-    /**
-     * Limpa todo o cache
-     */
-    clear(): void {
-        this.cache.clear();
-        this.stats.hits = 0;
-        this.stats.misses = 0;
-    }
-
-    /**
-     * Remove entradas expiradas
-     */
-    cleanup(): number {
-        const now = Date.now();
-        let removed = 0;
-
-        for (const [key, entry] of this.cache.entries()) {
-            if (now > entry.expiry) {
-                this.cache.delete(key);
-                removed++;
-            }
-        }
-
-        return removed;
-    }
-
-    /**
-     * Evict Least Recently Used (LRU)
-     */
-    private evictLRU(): void {
-        let lruKey: string | null = null;
-        let lruHits = Infinity;
-
-        for (const [key, entry] of this.cache.entries()) {
-            if (entry.hits < lruHits) {
-                lruHits = entry.hits;
-                lruKey = key;
-            }
-        }
-
-        if (lruKey) {
-            this.cache.delete(lruKey);
-        }
-    }
-
-    /**
-     * Obtém estatísticas do cache
-     */
-    getStats(): CacheStats {
-        const total = this.stats.hits + this.stats.misses;
-        const hitRate = total > 0 ? (this.stats.hits / total) * 100 : 0;
-
-        return {
-            hits: this.stats.hits,
-            misses: this.stats.misses,
-            size: this.cache.size,
-            hitRate: Math.round(hitRate * 100) / 100
-        };
-    }
-
-    /**
-     * Reseta estatísticas
-     */
-    resetStats(): void {
-        this.stats.hits = 0;
-        this.stats.misses = 0;
-    }
-
-    /**
-     * Obtém todas as chaves do cache
-     */
-    keys(): string[] {
-        return Array.from(this.cache.keys());
-    }
-
-    /**
-     * Verifica se chave existe no cache
-     */
-    has(key: string): boolean {
-        const entry = this.cache.get(key);
-        if (!entry) return false;
-
-        // Verificar se não expirou
-        if (Date.now() > entry.expiry) {
-            this.cache.delete(key);
-            return false;
-        }
-
-        return true;
-    }
-
-    /**
-     * Obtém tamanho atual do cache
-     */
-    size(): number {
-        return this.cache.size;
-    }
-}