wegho-agentes 7.0.3 → 7.0.6

package/.agents/CLI.md

@@ -1,222 +1,42 @@
-# 🤖 CLI - Comandos do Sistema de Agentes
-
-Interface de linha de comando para facilitar o uso dos agentes.
-
----
-
-## 📋 Comandos Disponíveis
-
-### 1. !comandos
-**Mostra lista de todos os comandos**
-
-```bash
-node .agents/cli.js "!comandos"
-```
-
----
-
-### 2. !iniciar contexto
-**Carrega contexto completo do projeto**
-
-- Detecta se projeto é novo ou existente
-- Se existente: executa auditoria automática de código
-- Faz perguntas sobre domínio, stack, features
-- Salva perfil em `docs/PROJECT_PROFILE.json`
-
-```bash
-node .agents/cli.js "!iniciar contexto"
-```
-
-**Equivalente a**:
-```bash
-node .agents/test-init-context.js
-```
-
----
-
-### 3. !rever codigo
-**Executa auditoria completa do código**
-
-- Escaneia todos arquivos `.ts`, `.tsx`, `.js`, `.jsx`
-- Detecta 9 tipos de violações (P0/P1/P2)
-- Gera relatório em `docs/AUDIT_REPORT.md`
-
-```bash
-node .agents/cli.js "!rever codigo"
-```
-
-**Saída**:
-```
-📊 RELATÓRIO DE AUDITORIA
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-📁 Arquivos analisados: 47
-⚠️  Total de violações: 23
-
-💀 P0 (CRÍTICO): 3
-⚠️  P1 (IMPORTANTE): 12
-💡 P2 (MELHORIA): 8
-
-✅ Relatório salvo em: docs/AUDIT_REPORT.md
-```
-
----
-
-### 4. !rever plano
-**Revisa plano de implementação**
-
-- Mostra `docs/IMPLEMENTATION_PLAN.md`
-- Exibe perfil do projeto (`PROJECT_PROFILE.json`)
-- Lista próximos passos
-
-```bash
-node .agents/cli.js "!rever plano"
-```
-
----
-
-### 5. !voltar versao
-**Reverte para versão anterior (Git)**
-
-- Lista últimos 10 commits
-- Mostra comandos para reverter
-- Opções: `git revert` (seguro) ou `git reset` (perigoso)
-
-```bash
-node .agents/cli.js "!voltar versao"
-```
-
-**Saída**:
-```
-📜 Últimos commits:
-
-abc1234 feat: adicionar login
-def5678 fix: corrigir validação
-...
-
-⚠️  Para reverter, execute manualmente:
-
-   git revert <commit-hash>   # Criar commit de reversão
-   ou
-   git reset --hard <commit-hash>   # Voltar diretamente (CUIDADO!)
-```
-
----
-
-### 6. !criar backup
-**Cria backup completo do estado atual**
-
-- Salva em `.backups/backup-YYYYMMDD-HHmmss/`
-- Inclui: código, docs, configs
-- Exclui: node_modules, .next, dist
-- Cria `backup-info.json` com metadados
-
-```bash
-node .agents/cli.js "!criar backup"
-```
-
-**Saída**:
-```
-💾 Criando backup em: .backups/backup-2026-01-20T10-40-00
-
-  ✅ app/
-  ✅ components/
-  ✅ hooks/
-  ✅ docs/
-  ✅ .agents/
-  ✅ package.json
-
-✅ Backup criado com sucesso!
-📂 Localização: .backups/backup-2026-01-20T10-40-00
-📊 6 itens salvos
-
-💡 Para restaurar:
-   cp -r .backups/backup-2026-01-20T10-40-00/* .
-```
-
----
-
-## 🚀 Uso Rápido via NPM
-
-Adicione ao `package.json`:
-
-```json
-{
-  "scripts": {
-    "agent": "node .agents/cli.js"
-  }
-}
-```
-
-Depois use:
-
-```bash
-npm run agent "!comandos"
-npm run agent "!iniciar contexto"
-npm run agent "!rever codigo"
-npm run agent "!rever plano"
-npm run agent "!voltar versao"
-npm run agent "!criar backup"
-```
-
----
-
-## 💡 Exemplos de Uso
-
-### Workflow Completo
-
-```bash
-# 1. Iniciar contexto (primeira vez)
-npm run agent "!iniciar contexto"
-
-# 2. Antes de começar implementação
-npm run agent "!criar backup"
-
-# 3. Após implementar código
-npm run agent "!rever codigo"
-
-# 4. Se houver problemas, voltar
-npm run agent "!voltar versao"
-
-# 5. Revisar plano antes de deploy
-npm run agent "!rever plano"
-```
-
-### Auditoria Rápida
-
-```bash
-# Auditar código atual
-npm run agent "!rever codigo"
-
-# Se P0 > 0: corrigir e auditar novamente
-# ... (fazer correções)
-npm run agent "!rever codigo"
-```
-
-### Backup Antes de Deploy
-
-```bash
-# Criar backup
-npm run agent "!criar backup"
-
-# Deploy
-npm run build
-# ... (deploy)
-
-# Se algo der errado, restaurar:
-cp -r .backups/backup-2026-01-20T10-40-00/* .
-```
-
----
-
-## 📌 Notas
-
-- **Todos os comandos** podem ser executados diretamente: `node .agents/cli.js "!comando"`
-- **Scripts NPM** são apenas atalhos convenientes
-- **Backups** não incluem `node_modules`, `.next`, `dist` (reduz tamanho)
-- **Git necessário** para `!voltar versao`
-
----
-
-**Versão**: 1.0.0  
-**Última atualização**: 2026-01-20
+# cli.ts
+
+> Arquivo fonte: `.agents/cli.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 8 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
+- ./context-loader.js
+- ./code-auditor-agent.js
+- fs
+- path
+- child_process
+- readline
+- ./orchestrator.js
+- url
+- o
+
+## Integrações
+- Sistema de arquivos
+
+## Segurança
+- Manipula dados sensíveis e exige cuidado com exposição em logs e cliente.
+- Utiliza mecanismos de proteção criptográfica ou hashing.
+
+## 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/README.md

@@ -1,130 +1,18 @@
-# Sistema de Agentes - README
-
-## 🎯 Visão Geral
-
-Sistema de agentes especializados para garantir qualidade, segurança e organização em projetos Next.js + Supabase.
-
-## 📁 Estrutura
-
-```
-.agents/
-├── core/                        # 5 Agentes Core
-│   ├── frontend-agent.ts        # UI/UX, acessibilidade, performance
-│   ├── security-agent.ts        # Vulnerabilidades, RLS, validações
-│   ├── documentation-agent.ts   # Docs automáticas
-│   ├── architecture-agent.ts    # Organização, separação de camadas
-│   └── quality-agent.ts         # Lint, build, tests, audit (GO/NO-GO)
-├── domains/                     # Agentes Especializados
-│   ├── news/                    # Site de Notícias
-│   ├── production/              # Produção/Expedição
-│   └── logistics/               # Logística
-├── config.ts                    # Configurações globais
-├── context-loader.ts            # Sistema "iniciar contexto"
-├── orchestrator.ts              # Coordenador dos 6 passos
-└── test-init-context.js         # Script de teste
-```
-
-## 🚀 Como Usar
-
-### 1. Iniciar Contexto
-
-Antes de qualquer implementação, execute:
-
-```bash
-node .agents/test-init-context.js
-```
-
-Ou adicione ao `package.json`:
-
-```json
-{
-  "scripts": {
-    "agents:init": "node .agents/test-init-context.js"
-  }
-}
-```
-
-Isso carregará:
-- ✅ DESIGN_SYSTEM.md  
-- ✅ SYMBOLS_TREE.md  
-- ✅ BUILD_HISTORY.md  
-- ✅ AGENT_RULES.md  
-- ✅ Build atual  
-- ✅ Regras do usuário (MEMORY)  
-- ✅ Domínio do projeto
-
-### 2. Processo de 6 Passos
-
-Todo código passa por:
-
-1. **Arquitetura** - Estrutura e organização
-2. **Front-End** - UI/UX, acessibilidade, performance
-3. **Segurança FE** - XSS, CSRF, validações
-4. **Tech Lead** - Integração e limpeza
-5. **Database Security** - RLS, policies, índices
-6. **Auditor Final** - GO/NO-GO (lint, build, tests)
-
-### 3. Salvamento Automático
-
-Ao finalizar build, o **Documentation Agent** atualiza:
-- `docs/builds/build-XXX.md` (detalhes)
-- `docs/BUILD_HISTORY.md` (resumo)
-- `docs/SYMBOLS_TREE.md` (símbolos)
-
-## 📋 Regras Absolutas
-
-1. ❌ **Máximo 500 linhas** por arquivo
-2. ❌ **Não alucinar** (APIs, tabelas, libs)
-3. ✅ **Priorizar libs existentes**
-4. ✅ **Fonte de verdade**: Código → Docs → Padrões
-5. ✅ **Mudanças mínimas**
-6. ❌ **Sem gambiarra**
-7. ✅ **Entregas obrigatórias** (arquivos + por quê + como validar)
-8. ✅ **Tipagem forte** (evitar `any`)
-
-## 📊 Domínios Suportados
-
-- **Generic** - Projeto padrão (apenas agentes core)
-- **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)
-
-## 🔧 Configuração
-
-Edite `.agents/config.ts` para personalizar:
-
-```typescript
-export const DEFAULT_CONFIG: AgentConfig = {
-  domain: 'production', // ou 'news', 'logistics', 'generic'
-  enabledAgents: ['frontend', 'security', 'documentation', 'architecture', 'quality'],
-  autoDocumentation: true,
-  buildTracking: true,
-  maxFileLines: 500,
-};
-```
-
-## 📚 Documentação Completa
-
-- [DESIGN_SYSTEM.md](../docs/DESIGN_SYSTEM.md) - Sistema de design
-- [SYMBOLS_TREE.md](../docs/SYMBOLS_TREE.md) - Árvore de símbolos
-- [BUILD_HISTORY.md](../docs/BUILD_HISTORY.md) - Histórico de builds
-- [AGENT_RULES.md](../docs/AGENT_RULES.md) - Regras completas
-
-## 🧪 Testar Sistema
-
-```bash
-# Teste 1: Iniciar contexto
-npm run agents:init
-
-# Teste 2: Validar arquivo
-node .agents/test-validate-file.js path/to/file.tsx
-
-# Teste 3: Full audit
-npm run lint && npm run build && npm test
-```
-
----
-
-**Versão**: 1.0.0  
-**Última atualização**: 2026-01-20  
-**Gerado por**: Documentation Agent
+# Sistema de Agentes
+
+## Fluxo principal
+1. `npm run docs:sync`
+2. `npm run agent:preflight`
+3. `npm run agent:start`
+
+## Estrutura
+- `.agents/core/` agentes base
+- `.agents/domains/` agentes por domínio
+- `.agents/runtime/` artefatos temporários
+- `.agent/skills/file-doc-sync/` skill de documentação por arquivo
+
+## Removido
+- Sistema de memória persistente
+- Feedback collector persistente
+- Agente de inventário
+- Estrutura legada de memória persistente

package/.agents/antigravity-preflight.md

@@ -0,0 +1,36 @@
+# antigravity-preflight.ts
+
+> Arquivo fonte: `.agents/antigravity-preflight.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.
+- 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
+- fs
+- path
+- module
+- url
+- ./sync-docs.ts
+
+## 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/antigravity-preflight.ts

@@ -1,29 +1,15 @@
 #!/usr/bin/env node
 
-/**
- * Antigravity Preflight
- *
- * Goal:
- * - Keep runtime stable across model/agent switches.
- * - Ensure minimal required files/dirs exist.
- * - Avoid failures caused by missing queue or memory files.
- */
-
 import * as fs from 'fs';
 import * as path from 'path';
 import { createRequire } from 'module';
 import { fileURLToPath } from 'url';
+import { syncProjectFileDocs } from './sync-docs.ts';
 
 const require = createRequire(import.meta.url);
 const __filename = fileURLToPath(import.meta.url);
 
-const REQUIRED_DIRS = [
-    '.agents/memory',
-    'docs',
-    'docs/ui-maps',
-    'docs/mapsite',
-    'docs/mapsite/modules',
-];
+const REQUIRED_DIRS = ['docs', 'docs/ui-maps', 'docs/mapsite', 'docs/mapsite/modules', '.agents/runtime'];
 
 const REQUIRED_FILES: Array<{ filePath: string; content: string }> = [
     {
@@ -31,7 +17,7 @@ const REQUIRED_FILES: Array<{ filePath: string; content: string }> = [
         content: '# ANTIGRAVITY TASKS\n\n- [ ] Descreva sua tarefa aqui\n',
     },
     {
-        filePath: '.agents/memory/reference-repositories.json',
+        filePath: '.agents/reference-repositories.json',
         content: JSON.stringify(
             {
                 repositories: {},
@@ -44,31 +30,11 @@ const REQUIRED_FILES: Array<{ filePath: string; content: string }> = [
     },
 ];
 
-const AGENTS = [
-    'architecture-agent',
-    'frontend-agent',
-    'security-agent',
-    'quality-agent',
-    'documentation-agent',
-    'inventory-agent',
-    'cms-agent',
-    'seo-agent',
-    'production-control-agent',
-    'route-agent',
-    'nextjs-agent',
-    'uiux-agent',
-    'backend-agent',
-    'database-agent',
-    'ai-agents-agent',
-    'rag-agent',
-    'pentest-agent',
-    'devops-agent',
-    'cloud-agent',
-    'testing-agent',
-    'cro-agent',
-    'automation-agent',
-    'ui-data-map-agent',
-    'stack-boundary-agent',
+const REQUIRED_IDENTITY_FILES = [
+    '.agent/skills/wegho-global-rules/SKILL.md',
+    '.agent/rules/GEMINI.md',
+    '.agents/AGENT_WORKFLOW.md',
+    'docs/AGENT_RULES.md',
 ];
 
 function ensureDir(dirPath: string): void {
@@ -91,38 +57,6 @@ function ensureFile(filePath: string, content: string): void {
     }
 }
 
-function ensureAgentMemory(agentName: string): void {
-    const base = path.resolve(process.cwd(), '.agents', 'memory', agentName);
-    if (!fs.existsSync(base)) {
-        fs.mkdirSync(base, { recursive: true });
-        console.log(`created memory dir: .agents/memory/${agentName}`);
-    }
-
-    const jsonDefaults = [
-        { name: 'successes.json', value: '[]\n' },
-        { name: 'failures.json', value: '[]\n' },
-        { name: 'learnings.json', value: '[]\n' },
-    ];
-
-    for (const item of jsonDefaults) {
-        const p = path.join(base, item.name);
-        if (!fs.existsSync(p)) {
-            fs.writeFileSync(p, item.value, 'utf-8');
-            console.log(`created file: .agents/memory/${agentName}/${item.name}`);
-        }
-    }
-
-    const specialtyPath = path.join(base, 'specialty.md');
-    if (!fs.existsSync(specialtyPath)) {
-        fs.writeFileSync(
-            specialtyPath,
-            `# ${agentName}\n\nEspecialidade inicial. Atualize conforme o projeto.\n`,
-            'utf-8'
-        );
-        console.log(`created file: .agents/memory/${agentName}/specialty.md`);
-    }
-}
-
 function checkTooling(): void {
     try {
         require.resolve('tsx');
@@ -133,22 +67,29 @@ function checkTooling(): void {
     }
 }
 
+function checkWebGhoIdentity(): void {
+    for (const filePath of REQUIRED_IDENTITY_FILES) {
+        const fullPath = path.resolve(process.cwd(), filePath);
+        console.log(`${fs.existsSync(fullPath) ? 'ok' : 'warn'}: identity file ${fs.existsSync(fullPath) ? 'found' : 'missing'}: ${filePath}`);
+    }
+}
+
 export function runAntigravityPreflight(): void {
     console.log('antigravity preflight: start');
 
+    const docsSync = syncProjectFileDocs(process.cwd());
+    console.log(`ok: docs synced (${docsSync.scanned} scanned, ${docsSync.created} created, ${docsSync.updated} updated)`);
+
     for (const dir of REQUIRED_DIRS) {
         ensureDir(dir);
     }
 
-    for (const f of REQUIRED_FILES) {
-        ensureFile(f.filePath, f.content);
-    }
-
-    for (const agent of AGENTS) {
-        ensureAgentMemory(agent);
+    for (const file of REQUIRED_FILES) {
+        ensureFile(file.filePath, file.content);
     }
 
     checkTooling();
+    checkWebGhoIdentity();
     console.log('antigravity preflight: done');
 }
 

package/.agents/auto-runner.md

@@ -0,0 +1,36 @@
+# auto-runner.ts
+
+> Arquivo fonte: `.agents/auto-runner.ts`
+
+## 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. Executa etapas assíncronas quando precisa consultar arquivos, serviços ou processos externos.
+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
+- fs
+- path
+- ./context-loader.js
+- ./orchestrator.js
+- ./antigravity-preflight.js
+
+## Integrações
+- Variáveis de ambiente
+- 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/auto-runner.ts

@@ -17,8 +17,8 @@ import { IntelligentOrchestrator } from './orchestrator.js';
 import { runAntigravityPreflight } from './antigravity-preflight.js';
 
 const TASKS_FILE = path.join(process.cwd(), 'docs', 'ANTIGRAVITY_TASKS.md');
-const STATE_FILE = path.join(process.cwd(), '.agents', 'memory', 'auto-runner-state.json');
-const LOCK_FILE = path.join(process.cwd(), '.agents', 'memory', 'auto-runner.lock');
+const STATE_FILE = path.join(process.cwd(), '.agents', 'runtime', 'auto-runner-state.json');
+const LOCK_FILE = path.join(process.cwd(), '.agents', 'runtime', 'auto-runner.lock');
 
 const DEFAULT_TASK = process.env.WEGHO_AUTORUN_DEFAULT_TASK || 'escanear projeto';
 const MIN_INTERVAL_MINUTES = Number(process.env.WEGHO_AUTORUN_MIN_INTERVAL || '15');

package/.agents/cli.ts

@@ -322,8 +322,8 @@ export async function scanProject(): Promise<void> {
         console.log('🏭 Iniciando scan completo do projeto...');
         await orchestrator.orchestrateTask('escanear projeto');
 
-        console.log('\n✅ Inventário atualizado com sucesso!');
-        console.log('📂 Veja os resultados em: .agents/memory/inventory-agent/inventory/');
+        console.log('\n✅ Varredura concluída com sucesso!');
+        console.log('📂 Documentação sincronizada via: npm run docs:sync');
     } catch (error: any) {
         console.error('❌ Erro ao escanear projeto:', error.message);
         process.exit(1);