wegho-agentes 7.0.4 → 7.0.6

package/.agents/install.ts

@@ -1,138 +1,115 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-/**
- * Script de Instalação de Agentes
- * 
- * Copia arquivos de configuração (.cursorrules, .clinerules, .agent/)
- * do pacote node_modules para a raiz do projeto do usuário.
- */
-
-async function install() {
-    const projectRoot = process.cwd();
-    const packageDir = path.join(__dirname, '..'); // .agents is in the package root
-
-    console.log('\n📦 Instalando componentes do sistema de agentes...');
-
-    const itemsToCopy = [
-        { src: '.cursorrules', dest: '.cursorrules' },
-        { src: '.clinerules', dest: '.clinerules' },
-        { src: '.agent', dest: '.agent' },
-        { src: 'skills', dest: 'skills' },
-        { src: 'docs', dest: 'docs' }
-    ];
-
-    for (const item of itemsToCopy) {
-        const srcPath = path.join(packageDir, item.src);
-        const destPath = path.join(projectRoot, item.dest);
-
-        if (fs.existsSync(srcPath)) {
-            if (fs.statSync(srcPath).isDirectory()) {
-                copyRecursive(srcPath, destPath);
-            } else {
-                // Se o arquivo de destino já existe, não sobrescreve sem permissão
-                if (!fs.existsSync(destPath)) {
-                    fs.copyFileSync(srcPath, destPath);
-                    console.log(`  ✅ Criado: ${item.dest}`);
-                } else {
-                    console.log(`  ℹ️  Mantido: ${item.dest} (já existe)`);
-                }
-            }
-        }
-    }
-
-    // 2. Adicionar scripts ao package.json
-    const packageJsonPath = path.join(projectRoot, 'package.json');
-    if (fs.existsSync(packageJsonPath)) {
-        try {
-            const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
-            if (!packageJson.scripts) packageJson.scripts = {};
-
-            let modified = false;
-
-            if (!packageJson.scripts['agent']) {
-                packageJson.scripts['agent'] = 'node node_modules/wegho-agentes/.agents/cli.mjs';
-                console.log('  ✅ Script adicionado: npm run agent');
-                modified = true;
-            }
-
-            if (!packageJson.scripts['agents:init']) {
-                packageJson.scripts['agents:init'] = 'node node_modules/wegho-agentes/.agents/init.mjs';
-                console.log('  ✅ Script adicionado: npm run agents:init');
-                modified = true;
-            }
-
-            if (!packageJson.scripts['init']) {
-                packageJson.scripts['init'] = 'npm run agents:init';
-                console.log('  ✅ Script adicionado: npm run init');
-                modified = true;
-            }
-
-            if (!packageJson.scripts['task']) {
-                packageJson.scripts['task'] = 'npm run agent --';
-                console.log('  ✅ Script adicionado: npm run task');
-                modified = true;
-            }
-
-            if (!packageJson.scripts['agent:preflight']) {
-                packageJson.scripts['agent:preflight'] = 'node node_modules/wegho-agentes/.agents/preflight.mjs';
-                console.log('  ✅ Script adicionado: npm run agent:preflight');
-                modified = true;
-            }
-
-            if (!packageJson.scripts['agent:auto']) {
-                packageJson.scripts['agent:auto'] = 'node node_modules/wegho-agentes/.agents/auto-runner.mjs';
-                console.log('  ✅ Script adicionado: npm run agent:auto');
-                modified = true;
-            }
-
-            if (!packageJson.scripts['validate']) {
-                packageJson.scripts['validate'] = 'node node_modules/wegho-agentes/.agents/validate.mjs';
-                console.log('  ✅ Script adicionado: npm run validate');
-                modified = true;
-            }
-
-            if (modified) {
-                fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2), 'utf-8');
-            }
-        } catch (error) {
-            console.error('  ⚠️  Não foi possível atualizar o package.json automaticamente:', (error as Error).message);
-        }
-    }
-
-    console.log('\n✅ Componentes instalados com sucesso!');
-    console.log('\n💡 Dica: Execute "npm run validate" para validar as regras do projeto');
-}
-
-
-function copyRecursive(src: string, dest: string) {
-    if (!fs.existsSync(dest)) {
-        fs.mkdirSync(dest, { recursive: true });
-    }
-
-    const entries = fs.readdirSync(src, { withFileTypes: true });
-
-    for (const entry of entries) {
-        const srcPath = path.join(src, entry.name);
-        const destPath = path.join(dest, entry.name);
-
-        if (entry.isDirectory()) {
-            copyRecursive(srcPath, destPath);
-        } else {
-            if (!fs.existsSync(destPath)) {
-                fs.copyFileSync(srcPath, destPath);
-                // console.log(`    - ${entry.name}`);
-            }
-        }
-    }
-}
-
-if (process.argv[1] === __filename) {
-    install().catch(console.error);
-}
-
-export { install };
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+async function install() {
+    const projectRoot = process.cwd();
+    const packageDir = path.join(__dirname, '..');
+
+    console.log('\n[wegho-agentes] Instalando componentes do sistema...');
+
+    const itemsToCopy = [
+        { src: '.cursorrules', dest: '.cursorrules' },
+        { src: '.clinerules', dest: '.clinerules' },
+        { src: '.agent', dest: '.agent' },
+        { src: '.agents', dest: '.agents' },
+        { src: 'docs', dest: 'docs' },
+        { src: 'skills', dest: 'skills' },
+    ];
+
+    for (const item of itemsToCopy) {
+        const srcPath = path.join(packageDir, item.src);
+        const destPath = path.join(projectRoot, item.dest);
+
+        if (!fs.existsSync(srcPath)) {
+            continue;
+        }
+
+        if (fs.statSync(srcPath).isDirectory()) {
+            copyRecursive(srcPath, destPath);
+            continue;
+        }
+
+        if (!fs.existsSync(destPath)) {
+            fs.copyFileSync(srcPath, destPath);
+            console.log(`  [ok] Criado: ${item.dest}`);
+        }
+    }
+
+    updateProjectScripts(projectRoot);
+
+    console.log('\n[wegho-agentes] Instalação concluída.');
+    console.log('[wegho-agentes] Início rápido: npm run agent:start');
+}
+
+function updateProjectScripts(projectRoot: string): void {
+    const packageJsonPath = path.join(projectRoot, 'package.json');
+    if (!fs.existsSync(packageJsonPath)) {
+        return;
+    }
+
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+    packageJson.scripts ||= {};
+
+    const scripts: Record<string, string> = {
+        agent: 'node node_modules/wegho-agentes/.agents/cli.mjs',
+        'docs:sync': 'tsx node_modules/wegho-agentes/.agents/sync-docs.ts',
+        'agent:preflight': 'node node_modules/wegho-agentes/.agents/preflight.mjs',
+        'agent:auto': 'node node_modules/wegho-agentes/.agents/auto-runner.mjs',
+        'agent:start': 'npm run docs:sync && npm run agent:preflight && npm run agent',
+        'agents:init': 'node node_modules/wegho-agentes/.agents/init.mjs',
+        task: 'npm run agent --',
+        validate: 'node node_modules/wegho-agentes/.agents/validate.mjs',
+    };
+
+    if (!packageJson.scripts.init) {
+        packageJson.scripts.init = 'npm run agents:init';
+    }
+
+    let modified = false;
+
+    for (const [name, command] of Object.entries(scripts)) {
+        if (packageJson.scripts[name]) {
+            continue;
+        }
+
+        packageJson.scripts[name] = command;
+        console.log(`  [ok] Script adicionado: npm run ${name}`);
+        modified = true;
+    }
+
+    if (modified) {
+        fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2), 'utf-8');
+    }
+}
+
+function copyRecursive(src: string, dest: string): void {
+    if (!fs.existsSync(dest)) {
+        fs.mkdirSync(dest, { recursive: true });
+    }
+
+    const entries = fs.readdirSync(src, { withFileTypes: true });
+
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+
+        if (entry.isDirectory()) {
+            copyRecursive(srcPath, destPath);
+            continue;
+        }
+
+        if (!fs.existsSync(destPath)) {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+
+if (process.argv[1] === __filename) {
+    install().catch(console.error);
+}
+
+export { install };

package/.agents/orchestrator.md

@@ -0,0 +1,43 @@
+# orchestrator.ts
+
+> Arquivo fonte: `.agents/orchestrator.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.
+- Definir classes ou estruturas centrais para encapsular comportamento.
+- 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
+- ./core/frontend-agent.js
+- ./core/security-agent.js
+- ./core/architecture-agent.js
+- ./core/quality-agent.js
+- ./core/documentation-agent.js
+- ./domains/news/cms-agent.js
+- ./domains/news/seo-agent.js
+- ./domains/production/production-control-agent.js
+- ./domains/logistics/route-agent.js
+- ./task-analyzer-agent.js
+
+## 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.