wegho-agentes 4.0.1

package/INSTALL.md

@@ -0,0 +1,300 @@
+# 🚀 Instalação do Sistema de Agentes Inteligentes
+
+## 📋 Pré-requisitos
+
+- Node.js >= 18.0.0
+- npm ou yarn
+- TypeScript >= 5.0.0
+
+---
+
+## 🔧 Instalação
+
+### **1. Clone o Repositório**
+
+```bash
+git clone https://github.com/cordeirinhocaleb-stack/wegho-agentes.git
+cd wegho-agentes
+```
+
+### **2. Instale as Dependências**
+
+```bash
+npm install
+```
+
+### **3. Execute a Inicialização (IMPORTANTE!)**
+
+```bash
+npm run init
+```
+
+Este comando irá:
+
+1. ✅ Pedir sua permissão para escanear o projeto
+2. ✅ Inicializar o orquestrador
+3. ✅ Criar memória inicial para **TODOS os 10 agentes**:
+   - 🎨 Frontend Agent
+   - 🔒 Security Agent
+   - 🏗️ Architecture Agent
+   - ✅ Quality Agent
+   - 📚 Documentation Agent
+   - 🏭 **Inventory Agent** (Almoxarifado)
+   - 📰 CMS Agent
+   - 🔍 SEO Agent
+   - 🏭 Production Control Agent
+   - 🚚 Route Agent
+4. ✅ Escanear seu projeto completo
+5. ✅ Catalogar **TODOS** os recursos no almoxarifado (Inventory Agent)
+
+---
+
+## 🎯 O que Acontece na Inicialização
+
+### **Fluxo Completo:**
+
+```
+┌─────────────────────────────────────────────────────────┐
+│  1. Sistema pede permissão para escanear projeto        │
+└─────────────────────────────────────────────────────────┘
+                          ↓
+┌─────────────────────────────────────────────────────────┐
+│  2. Orquestrador inicializa cada agente                 │
+│     (em ordem de prioridade)                            │
+└─────────────────────────────────────────────────────────┘
+                          ↓
+┌─────────────────────────────────────────────────────────┐
+│  3. Cada agente cria sua memória inicial:               │
+│     - specialty.md (especialidade)                      │
+│     - successes.json (sucessos)                         │
+│     - failures.json (falhas)                            │
+│     - learnings.json (aprendizados)                     │
+└─────────────────────────────────────────────────────────┘
+                          ↓
+┌─────────────────────────────────────────────────────────┐
+│  4. Inventory Agent escaneia TUDO:                      │
+│     - Componentes (.tsx, .jsx)                          │
+│     - Variáveis (exports)                               │
+│     - Endpoints (API routes)                            │
+│     - Tipos (TypeScript)                                │
+│     - Banco de dados (schema)                           │
+└─────────────────────────────────────────────────────────┘
+                          ↓
+┌─────────────────────────────────────────────────────────┐
+│  5. Sistema pronto para uso! 🎉                         │
+└─────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 📂 Estrutura Criada
+
+Após a inicialização, você terá:
+
+```
+seu-projeto/
+├── .agents/
+│   ├── memory/
+│   │   ├── frontend-agent/
+│   │   │   ├── specialty.md
+│   │   │   ├── successes.json
+│   │   │   ├── failures.json
+│   │   │   └── learnings.json
+│   │   │
+│   │   ├── security-agent/
+│   │   │   └── ... (mesma estrutura)
+│   │   │
+│   │   ├── inventory-agent/
+│   │   │   ├── specialty.md
+│   │   │   ├── successes.json
+│   │   │   ├── failures.json
+│   │   │   ├── learnings.json
+│   │   │   └── inventory/           # 🏭 ALMOXARIFADO
+│   │   │       ├── components.json  # Todos os componentes
+│   │   │       ├── variables.json   # Todas as variáveis
+│   │   │       ├── endpoints.json   # Todos os endpoints
+│   │   │       ├── tables.json      # Todas as tabelas
+│   │   │       ├── types.json       # Todos os tipos
+│   │   │       └── index.json       # Índice geral
+│   │   │
+│   │   └── ... (outros 7 agentes)
+│   │
+│   └── ... (código dos agentes)
+```
+
+---
+
+## 🎬 Exemplo de Saída da Inicialização
+
+```bash
+$ npm run init
+
+============================================================
+🤖 BEM-VINDO AO SISTEMA DE AGENTES INTELIGENTES
+============================================================
+
+Este é o processo de inicialização do sistema.
+O orquestrador irá preparar TODOS os agentes para trabalhar.
+
+❓ Posso escanear seu projeto e criar a memória inicial para todos os agentes? (s/n): s
+
+✅ Permissão concedida! Iniciando...
+
+📦 Inicializando agentes...
+
+============================================================
+🤖 Inicializando: Inventory Agent
+============================================================
+
+🔍 [inventory-agent] Escaneando projeto...
+✅ [inventory-agent] Scan completo: 247 itens catalogados
+
+✅ Inventory Agent inicializado com sucesso!
+   Inventário completo: 247 itens catalogados
+
+============================================================
+🤖 Inicializando: Frontend Agent
+============================================================
+
+✅ Frontend Agent inicializado com sucesso!
+
+============================================================
+🤖 Inicializando: Security Agent
+============================================================
+
+✅ Security Agent inicializado com sucesso!
+
+... (outros agentes)
+
+============================================================
+🏭 INVENTORY AGENT - Escaneando Projeto Completo
+============================================================
+
+🔍 [inventory-agent] Escaneando projeto...
+✅ [inventory-agent] Scan completo: 247 itens catalogados
+
+✅ Scan completo do projeto finalizado!
+   Inventário completo: 247 itens catalogados
+
+📊 Resumo do Inventário:
+   Total de 247 itens no almoxarifado
+
+============================================================
+🎉 INICIALIZAÇÃO COMPLETA!
+============================================================
+
+✅ Todos os agentes foram inicializados e estão prontos para trabalhar!
+✅ Memória inicial criada para cada agente
+✅ Inventário completo do projeto catalogado
+
+📚 Próximos passos:
+   1. Execute tarefas usando: npm run task "sua tarefa"
+   2. Consulte a documentação em: .agents/README.md
+   3. Veja o inventário em: .agents/memory/inventory-agent/inventory/
+
+🤖 Sistema de Agentes Inteligentes pronto para uso!
+```
+
+---
+
+## ✅ Verificação
+
+Para verificar se tudo foi instalado corretamente:
+
+```bash
+# Verificar se memória foi criada
+ls .agents/memory/
+
+# Verificar inventário
+ls .agents/memory/inventory-agent/inventory/
+
+# Ver resumo do inventário
+cat .agents/memory/inventory-agent/inventory/index.json
+```
+
+---
+
+## 🚀 Uso Após Instalação
+
+### **Executar uma Tarefa**
+
+```bash
+npm run task "Criar componente de login"
+```
+
+### **Consultar Inventário**
+
+```bash
+# Ver todos os componentes
+cat .agents/memory/inventory-agent/inventory/components.json
+
+# Ver todos os endpoints
+cat .agents/memory/inventory-agent/inventory/endpoints.json
+```
+
+### **Verificar Memória de um Agente**
+
+```bash
+# Ver sucessos do Frontend Agent
+cat .agents/memory/frontend-agent/successes.json
+
+# Ver aprendizados do Security Agent
+cat .agents/memory/security-agent/learnings.json
+```
+
+---
+
+## 🔄 Reinicializar Sistema
+
+Se precisar reinicializar (limpar memória e recomeçar):
+
+```bash
+# Remover memória existente
+rm -rf .agents/memory/
+
+# Executar inicialização novamente
+npm run init
+```
+
+---
+
+## 🆘 Problemas Comuns
+
+### **Erro: "Permission denied"**
+
+```bash
+# Dar permissão de execução
+chmod +x .agents/init.ts
+```
+
+### **Erro: "tsx not found"**
+
+```bash
+# Instalar tsx globalmente
+npm install -g tsx
+
+# Ou usar npx
+npx tsx .agents/init.ts
+```
+
+### **Erro: "Cannot find module 'glob'"**
+
+```bash
+# Instalar dependências
+npm install
+```
+
+---
+
+## 📚 Documentação Completa
+
+- [README Principal](../README.md)
+- [Guia de Agentes](.agents/README.md)
+- [Sistema de Memória](docs/LEARNING_SYSTEM.md)
+- [Inventory Agent](.agents/memory/inventory-agent/specialty.md)
+
+---
+
+## 🎉 Pronto!
+
+Seu sistema de agentes está **100% configurado** e pronto para uso! 🚀

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WebGho Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,315 @@
+# Sistema de Agentes WebGho v4.0.0
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0%2B-blue)](https://www.typescriptlang.org/)
+[![NPM Version](https://img.shields.io/badge/npm-4.0.0-red)](https://www.npmjs.com/package/wegho-agentes)
+
+Sistema de agentes especializados para garantir **qualidade**, **segurança** e **organização** em projetos **Next.js + Supabase**.
+
+---
+
+## 🎯 O Que São os Agentes?
+
+**10 agentes autônomos** que trabalham em conjunto:
+
+### **Agentes Core (6)**
+1. 🏭 **Inventory Agent** - Almoxarifado central que cataloga TUDO e **impede duplicação**
+2. 🎨 **Front-End** - UI/UX, acessibilidade, performance
+3. 🔒 **Security** - Vulnerabilidades (XSS, CSRF), RLS, validações
+4. 📚 **Documentation** - Docs automáticas (builds, símbolos, changelog)
+5. 🏗️ **Architecture** - Organização, 500 linhas/arquivo, duplicação
+6. ✅ **Quality** - Lint, TypeCheck, Build, Audit (GO/NO-GO)
+
+### **Agentes de Domínio (4)**
+7. 📰 **CMS Agent** - Validação de conteúdo e estrutura
+8. 🔍 **SEO Agent** - Otimização para motores de busca
+9. 🏭 **Production Control** - Monitoramento de produção
+10. 🚚 **Route Agent** - Otimização de rotas logísticas
+
+### 🆕 **NOVIDADES v4.0.0**
+
+#### 🏭 **Inventory Agent (Almoxarifado Central)**
+- ✅ Cataloga **TODOS** os recursos do projeto (componentes, variáveis, endpoints, tipos, banco)
+- ✅ **Impede duplicação** de código - agentes consultam antes de criar
+- ✅ Busca inteligente (exata, fuzzy, textual)
+- ✅ Organização centralizada de recursos
+
+#### 🚀 **Sistema de Inicialização Automática**
+- ✅ `npm run init` - Inicialização guiada
+- ✅ Pede permissão para escanear projeto
+- ✅ Cria memória inicial para **TODOS os 10 agentes**
+- ✅ Organiza almoxarifado automaticamente
+
+#### 🧠 **Sistema de Aprendizado Contínuo**
+- ✨ **Memória Persistente**: Cada agente registra sucessos e falhas
+- 🎯 **Seleção Inteligente**: Orquestrador escolhe melhores agentes baseado em histórico
+- 📊 **Feedback Loop**: Aprende com suas preferências e evita repetir erros
+- 🚀 **Melhoria Contínua**: Agentes ficam mais inteligentes a cada tarefa
+
+#### 🤖 **Compatibilidade com Múltiplas IAs**
+- ✅ Gemini 3 Pro / Flash
+- ✅ Claude Sonnet 4.5 (incluindo modo Thinking)
+- ✅ GPT-4o5
+- ✅ Guia de compatibilidade completo
+
+---
+
+## 🚀 Instalação Rápida
+
+### **Via NPM (Recomendado)**
+
+```bash
+# Instalar o pacote
+npm install wegho-agentes
+
+# Inicializar sistema (IMPORTANTE!)
+npm run init
+```
+
+O comando `npm run init` irá:
+1. ✅ Pedir permissão para escanear seu projeto
+2. ✅ Inicializar todos os 10 agentes
+3. ✅ Criar memória inicial para cada agente
+4. ✅ Catalogar todos os recursos no Inventory Agent
+
+### **Via Git Clone**
+
+```bash
+# Clone o repositório
+git clone https://github.com/cordeirinhocaleb-stack/wegho-agentes.git
+
+# Copie para seu projeto
+cp -r wegho-agentes/.agents seu-projeto/
+cp -r wegho-agentes/docs seu-projeto/
+
+# Inicialize
+cd seu-projeto
+npm run init
+```
+
+---
+
+## 📋 Pré-requisitos
+
+- ✅ Node.js >= 18.0.0
+- ✅ TypeScript >= 5.0.0
+- ✅ Projeto Next.js (recomendado App Router)
+- ✅ Supabase (opcional, para Database Security Agent)
+
+---
+
+## 🛠 Uso Básico
+
+### 1. Iniciar Contexto
+
+Antes de **qualquer implementação**, carregue o contexto do projeto:
+
+```bash
+node .agents/test-init-context.js
+```
+
+Isso carrega:
+- ✅ `DESIGN_SYSTEM.md` - Sistema de design
+- ✅ `SYMBOLS_TREE.md` - Estrutura do código
+- ✅ `BUILD_HISTORY.md` - Histórico de mudanças
+- ✅ `AGENT_RULES.md` - Regras consolidadas
+- ✅ Domínio detectado (news/production/logistics/generic)
+
+### 2. Desenvolvimento com Agentes
+
+Os agentes seguem o **Processo de 6 Passos Obrigatórios**:
+
+```
+1. Arquitetura      → Valida estrutura
+2. Front-End        → Valida UI/UX (se aplicável)
+3. Security FE      → Detecta vulnerabilidades
+4. Tech Lead        → Integra + limpa código
+5. Database Sec     → Valida RLS/policies (se aplicável)
+6. Audit Final      → GO/NO-GO (lint, build, tests)
+```
+
+### 3. Validação Automática
+
+Exemplo de validação de componente:
+
+```typescript
+import { FrontEndAgent } from './.agents/core/frontend-agent';
+
+const agent = new FrontEndAgent();
+const result = await agent.validateComponent('components/MyComponent.tsx');
+
+if (!result.passed) {
+  console.error('❌ Issues:', result.issues);
+  // Bloqueia commit/deploy
+}
+```
+
+---
+
+## 📚 Estrutura do Sistema
+
+```
+.agents/
+├── core/                          # 5 Agentes Base
+│   ├── frontend-agent.ts          # UI/UX
+│   ├── security-agent.ts          # Segurança
+│   ├── documentation-agent.ts     # Docs
+│   ├── architecture-agent.ts      # Arquitetura
+│   └── quality-agent.ts           # Quality (Auditor)
+├── domains/                       # Agentes Especializados
+│   ├── news/                      # CMS, SEO, Content, Analytics
+│   ├── production/                # Control, Quality, Shipping, Inventory
+│   └── logistics/                 # Route, Fleet, Warehouse, Tracking
+├── config.ts                      # Configurações
+├── context-loader.ts              # Sistema "iniciar contexto"
+├── orchestrator.ts                # Coordenador dos 6 passos
+└── README.md                      # Este arquivo
+
+docs/
+├── DESIGN_SYSTEM.md               # Sistema de design do projeto
+├── SYMBOLS_TREE.md                # Árvore hierárquica de código
+├── BUILD_HISTORY.md               # Histórico de builds
+├── AGENT_RULES.md                 # Regras consolidadas
+└── builds/                        # Builds detalhados (build-XXX.md)
+```
+
+---
+
+## 🚨 Regras Absolutas
+
+1. ❌ **Máximo 500 linhas** por arquivo (bloqueio automático)
+2. ❌ **Não alucinar** (APIs, tabelas, bibliotecas inexistentes)
+3. ✅ **Priorizar libs existentes** (justificar novas)
+4. ✅ **Fonte de verdade**: Código → Docs Oficiais → Padrões
+5. ✅ **Mudanças mínimas** (sem refactor por estética)
+6. ❌ **Sem gambiarra** (sem `@ts-ignore`, bypass de tipos)
+7. ✅ **Entregas obrigatórias** (arquivos + por quê + validação)
+8. ✅ **Tipagem forte** (evitar `any`, usar `unknown` + guards)
+
+---
+
+## 🔧 Configuração
+
+Edite `.agents/config.ts`:
+
+```typescript
+export const DEFAULT_CONFIG: AgentConfig = {
+  domain: 'generic',              // ou 'news', 'production', 'logistics'
+  enabledAgents: ['frontend', 'security', 'documentation', 'architecture', 'quality'],
+  autoDocumentation: true,
+  buildTracking: true,
+  maxFileLines: 500,
+};
+```
+
+---
+
+## 📊 Domínios Suportados
+
+| Domínio | Descrição | Agentes Especializados |
+|---------|-----------|------------------------|
+| **Generic** | Projeto padrão | Apenas core (5) |
+| **News** | Site de Notícias | CMS, SEO, Content, Analytics |
+| **Production** | Produção/Expedição | Control, Quality, Shipping, Inventory |
+| **Logistics** | Logística | Route, Fleet, Warehouse, Tracking |
+
+---
+
+## 🧪 Exemplos de Uso
+
+### Validar Arquivo Individual
+
+```bash
+# Criar script personalizado
+cat > validate.js << 'EOF'
+const { FrontEndAgent } = require('./.agents/core/frontend-agent');
+const agent = new FrontEndAgent();
+
+(async () => {
+  const result = await agent.validateComponent(process.argv[2]);
+  console.log(agent.generateReport([result]));
+})();
+EOF
+
+node validate.js components/MyComponent.tsx
+```
+
+### Integrar com Git Hooks (Husky)
+
+```json
+// package.json
+{
+  "husky": {
+    "hooks": {
+      "pre-commit": "node .agents/pre-commit-check.js"
+    }
+  }
+}
+```
+
+### Integrar com CI/CD (GitHub Actions)
+
+```yaml
+# .github/workflows/agents.yml
+name: Agents Validation
+on: [pull_request]
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 18
+      - run: node .agents/test-init-context.js
+      - run: npm run lint
+      - run: npm run build
+```
+
+---
+
+## 📖 Documentação Completa
+
+- [Guia de Instalação](./docs/installation.md)
+- [Regras Detalhadas](./docs/AGENT_RULES.md)
+- [Sistema de Design](./docs/DESIGN_SYSTEM.md)
+- [Árvore de Símbolos](./docs/SYMBOLS_TREE.md)
+- [Histórico de Builds](./docs/BUILD_HISTORY.md)
+- **[🧠 Sistema de Aprendizado](./docs/LEARNING_SYSTEM.md)** ← NOVO!
+
+---
+
+## 🤝 Contribuindo
+
+Contribuições são bem-vindas! Por favor:
+
+1. Fork o repositório
+2. Crie uma branch (`git checkout -b feature/minha-feature`)
+3. Commit suas mudanças (`git commit -m 'feat: adiciona nova feature'`)
+4. Push para a branch (`git push origin feature/minha-feature`)
+5. Abra um Pull Request
+
+---
+
+## 📝 Licença
+
+Este projeto está sob a licença MIT. Veja [LICENSE](./LICENSE) para mais detalhes.
+
+---
+
+## 🆘 Suporte
+
+- 📧 Email: suporte@webgho.com
+- 🐛 Issues: [GitHub Issues](https://github.com/webgho/agentes/issues)
+- 📖 Docs: https://www.webgho.agentes.com
+
+---
+
+## ✨ Créditos
+
+Desenvolvido por **WebGho Team** com foco em qualidade, segurança e produtividade.
+
+**Versão**: 2.0.0 (com Sistema de Aprendizado)  
+**Última atualização**: 2026-01-22