wegho-agentes 7.0.4 → 7.0.6

package/INSTALL.md

@@ -1,300 +1,18 @@
-# 🚀 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! 🚀
+# Instalação do Sistema de Agentes
+
+## Fluxo atual
+1. `npm install`
+2. `npm run docs:sync`
+3. `npm run agent:preflight`
+4. `npm run agent:start`
+
+## O que a instalação prepara
+- Copia `.agent`, `.agents`, `docs` e `skills`
+- Registra scripts úteis no `package.json`
+- Sincroniza a documentação técnica `.md` por arquivo
+- Prepara apenas artefatos temporários em `.agents/runtime`
+
+## O que não existe mais
+- Sistema de memória persistente por agente
+- Agente de inventário
+- Estrutura legada de memória persistente

package/README.md

@@ -1,332 +1,20 @@
-# Sistema de Agentes WebGho v7.0.1
-
-[![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-7.0.1-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?
-
-**20+ 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)
-
-### **Novos Agentes Especializados (12)**
-- **Web**: NextJS, UIUX, Frontend
-- **Backend**: API, Database (Postgres/Prisma)
-- **Security**: Pentest, Security
-- **DevOps**: Cloud, DevOps (Docker/CI)
-- **AI**: AI Agents, RAG
-- **Tools**: Automation, CRO, Testing
-
-### 🆕 **NOVIDADES v5.0.0**
-
-#### 🤖 **20+ Agentes Especializados**
-- ✅ **Cobertura Total**: De frontend a DevOps, cada área tem um especialista
-- ✅ **Roteamento Inteligente**: `TaskAnalyzer` detecta qual agente usar
-- ✅ **Skills Integradas**: 200+ skills (melhores práticas) carregadas sob demanda
-
-#### 📦 **Sistema de Build Incremental**
-- ✅ **Builds Automáticos**: Criados após cada sucesso
-- ✅ **Snapshots**: Histórico arquivo-por-arquivo
-- ✅ **Restore**: Volte para qualquer versão anterior
-- ✅ **Rastreabilidade**: Saiba exatamente quem mudou o que
-
-#### 🧠 **Memória Individual**
-- ✨ **Cérebro Próprio**: Cada agente tem sua memória persistente
-- 🎯 **Aprendizado**: Agentes lembram de sucessos e evitam erros passados
-- 📊 **Feedback**: Sistema de auto-melhoria contínua
-
-#### 🚀 **Automação Completa**
-- ✅ `npm run agent "tarefa"` - Só pedir e o sistema orquestra tudo
-
----
-
-## 🚀 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)
-
----
-
-## 📂 Onde Ficam os Arquivos do Sistema?
-
-Todos os arquivos gerados pelo sistema ficam **isolados** dentro do pacote `wegho-agentes`:
-
-```
-node_modules/wegho-agentes/
-├── .agents/          # Código dos agentes
-├── .system/          # Dados gerados (isolado)
-│   ├── builds/       # Histórico de builds
-│   ├── checkpoints/  # Pontos de restauração
-│   ├── reports/      # Relatórios de execução
-│   └── logs/         # Logs de debug
-└── docs/             # Documentação
-```
-
-**Seu projeto permanece limpo!** ✨  
-Apenas `.clinerules` e `.cursorrules` ficam na raiz do seu projeto.
-
----
-
-## 🛠 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**: 7.0.1 (Multi-Agent Governance & Continuous Learning)  
-**Última atualização**: 2026-01-25
+# Sistema de Agentes WebGho
+
+Sistema de agentes para validação, execução coordenada e documentação técnica por arquivo.
+
+## Fluxo atual
+1. `npm install`
+2. `npm run docs:sync`
+3. `npm run agent:preflight`
+4. `npm run agent:start`
+
+## O que existe
+- Orquestração de agentes por domínio
+- Validação de arquitetura, segurança, frontend e qualidade
+- Geração e atualização automática de `.md` técnicos por arquivo
+
+## O que foi removido
+- Memória persistente por agente
+- Feedback persistente
+- Inventory agent
+- Estrutura legada de memória persistente