jarvis-ai-framework 2.1.1 → 3.2.0

package/bin/commands/docs-publish.js

@@ -1,18 +1,11 @@
-import { loadEnv, resolveEnvPath } from '../lib/env-loader.js'
-import { execSync } from 'node:child_process'
-import { promisify } from 'node:util'
-import { exec } from 'node:child_process'
-import { existsSync } from 'node:fs'
-import { join, dirname } from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-const execAsync = promisify(exec)
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = dirname(__filename)
+import { loadEnv, resolveEnvPath } from "../lib/env-loader.js";
+import { existsSync } from "node:fs";
+import { publishFile } from "../lib/docs/publish-file.js";
+import { logger, configureFromFlags } from "../lib/utils/logger.js";
 
 /**
  * Publica documento no central-docs via GitLab API (branch + MR)
- * 
+ *
  * @param {Object} flags - Flags do comando
  * @param {string} flags.file - Caminho do arquivo local
  * @param {string} flags.tipo - Tipo do documento (prd|frd|ard|rfc)
@@ -22,163 +15,134 @@ const __dirname = dirname(__filename)
  * @param {string} flags.envFile - Path customizado do ENV.md
  */
 export async function docsPublish(flags = {}) {
-  const { file, tipo, feature, squad: squadOverride, workspace: workspaceOverride } = flags
-  
+  configureFromFlags(flags);
+
+  const { file, tipo, feature, squad: squadOverride, workspace: workspaceOverride } = flags;
+
   // Validar parâmetros obrigatórios
   if (!file || !tipo || !feature) {
-    console.error('❌ Parâmetros obrigatórios faltando\n')
-    console.error('Uso: jarvis docs publish --file <path> --tipo <prd|frd|ard|rfc|swagger|qa-report> --feature <slug> [--squad <squad>] [--workspace <workspace>]\n')
-    console.error('Exemplo:')
-    console.error('  jarvis docs publish \\')
-    console.error('    --file ./docs/engineering/ard-api-wallet.md \\')
-    console.error('    --tipo ard \\')
-    console.error('    --feature api-wallet-auth-jwt')
-    console.error('')
-    console.error('  # Publicar Swagger/OpenAPI:')
-    console.error('  jarvis docs publish \\')
-    console.error('    --file ./docs/engineering/swagger/api-wallet.yaml \\')
-    console.error('    --tipo swagger \\')
-    console.error('    --feature api-wallet')
-    console.error('')
-    console.error('  # Com override de squad/workspace:')
-    console.error('  jarvis docs publish \\')
-    console.error('    --file ./docs/engineering/ard-api-wallet.md \\')
-    console.error('    --tipo ard \\')
-    console.error('    --feature api-wallet-auth-jwt \\')
-    console.error('    --squad squad-driver \\')
-    console.error('    --workspace meu-workspace')
-    process.exit(1)
+    logger.error("❌ Parâmetros obrigatórios faltando\n");
+    logger.error(
+      "Uso: jarvis docs publish --file <path> --tipo <prd|frd|ard|rfc|swagger|qa-report> --feature <slug> [--squad <squad>] [--workspace <workspace>]\n"
+    );
+    logger.error("Exemplo:");
+    logger.error("  jarvis docs publish \\");
+    logger.error("    --file ./docs/engineering/ard-api-wallet.md \\");
+    logger.error("    --tipo ard \\");
+    logger.error("    --feature api-wallet-auth-jwt");
+    logger.error("");
+    logger.error("  # Publicar Swagger/OpenAPI:");
+    logger.error("  jarvis docs publish \\");
+    logger.error("    --file ./docs/engineering/swagger/api-wallet.yaml \\");
+    logger.error("    --tipo swagger \\");
+    logger.error("    --feature api-wallet");
+    logger.error("");
+    logger.error("  # Com override de squad/workspace:");
+    logger.error("  jarvis docs publish \\");
+    logger.error("    --file ./docs/engineering/ard-api-wallet.md \\");
+    logger.error("    --tipo ard \\");
+    logger.error("    --feature api-wallet-auth-jwt \\");
+    logger.error("    --squad core \\");
+    logger.error("    --workspace meu-workspace");
+    process.exit(1);
   }
-  
+
   // Validar tipo
-  const validTypes = ['prd', 'frd', 'ard', 'rfc', 'swagger', 'qa-report']
+  const validTypes = ["prd", "frd", "ard", "rfc", "swagger", "qa-report"];
   if (!validTypes.includes(tipo)) {
-    console.error(`❌ Tipo inválido: ${tipo}`)
-    console.error(`Tipos válidos: ${validTypes.join(', ')}`)
-    process.exit(1)
+    logger.error(`❌ Tipo inválido: ${tipo}`);
+    logger.error(`Tipos válidos: ${validTypes.join(", ")}`);
+    process.exit(1);
   }
-  
+
   // Validar se arquivo existe
   if (!existsSync(file)) {
-    console.error(`❌ Arquivo não encontrado: ${file}`)
-    process.exit(1)
+    logger.error(`❌ Arquivo não encontrado: ${file}`);
+    process.exit(1);
   }
-  
-  const cwd = process.cwd()
-  
+
+  const cwd = process.cwd();
+
   // Resolver path do ENV.md (suporta --ide e --env-file)
-  let envPath
+  let envPath;
   try {
-    const resolved = resolveEnvPath(cwd, flags)
-    envPath = resolved.path
+    const resolved = resolveEnvPath(cwd, flags);
+    envPath = resolved.path;
   } catch (error) {
-    console.error('❌ Erro ao resolver ENV.md:', error.message)
-    process.exit(1)
+    logger.error("❌ Erro ao resolver ENV.md:", error.message);
+    process.exit(1);
   }
-  
+
   // Carregar ENV.md
-  let env
+  let env;
   try {
-    env = loadEnv(cwd, envPath)
+    env = loadEnv(cwd, envPath);
   } catch (error) {
-    console.error('❌ Erro ao carregar ENV.md:', error.message)
-    process.exit(1)
+    logger.error("❌ Erro ao carregar ENV.md:", error.message);
+    process.exit(1);
   }
-  
+
   // Verificar se central-docs está configurado
   if (!env.CENTRAL_DOCS_REPO) {
-    console.error('❌ CENTRAL_DOCS_REPO não configurado no ENV.md')
-    console.error('\nConfigure a URL do repositório central:')
-    console.error('  CENTRAL_DOCS_REPO=https://gitlab.com/org/central-docs.git')
-    process.exit(1)
+    logger.error("❌ CENTRAL_DOCS_REPO não configurado no ENV.md");
+    logger.error("\nConfigure a URL do repositório central:");
+    logger.error("  CENTRAL_DOCS_REPO=https://gitlab.com/org/central-docs.git");
+    process.exit(1);
   }
-  
+
   // Usar override de squad/workspace se fornecido, senão usar do ENV.md
-  const squad = squadOverride || env.SQUAD
-  const workspace = workspaceOverride || env.WORKSPACE
-  
+  const squad = squadOverride || env.SQUAD;
+  const workspace = workspaceOverride || env.WORKSPACE;
+
   if (!squad || !workspace) {
-    console.error('❌ SQUAD ou WORKSPACE não definidos')
-    console.error('\nOpções:')
-    console.error('  1. Definir no ENV.md:')
-    console.error('     SQUAD=squad-driver')
-    console.error('     WORKSPACE=meu-workspace')
-    console.error('')
-    console.error('  2. Passar via flags:')
-    console.error('     --squad squad-driver --workspace meu-workspace')
-    process.exit(1)
-  }
-  
-  // Verificar se script publish-file.sh existe
-  // Usar path relativo ao módulo, não ao cwd do usuário
-  const publishScript = join(__dirname, '../lib/docs/publish-file.sh')
-  if (!existsSync(publishScript)) {
-    console.error('❌ Script não encontrado:', publishScript)
-    process.exit(1)
+    logger.error("❌ SQUAD ou WORKSPACE não definidos");
+    logger.error("\nOpções:");
+    logger.error("  1. Definir no ENV.md:");
+    logger.error("     SQUAD=core");
+    logger.error("     WORKSPACE=meu-workspace");
+    logger.error("");
+    logger.error("  2. Passar via flags:");
+    logger.error("     --squad core --workspace meu-workspace");
+    process.exit(1);
   }
-  
-  console.log(`📤 Publicando ${tipo.toUpperCase()} ${feature}...\n`)
-  
+
+  logger.info(`📤 Publicando ${tipo.toUpperCase()} ${feature}...\n`);
+
   try {
-    // Exportar variáveis de ambiente para o script bash
-    const envVars = {
-      ...process.env,
-      CENTRAL_DOCS_REPO: env.CENTRAL_DOCS_REPO,
-      CENTRAL_DOCS_TARGET_BRANCH: env.CENTRAL_DOCS_TARGET_BRANCH || 'dev',
-      CENTRAL_DOCS_CACHE_TTL: env.CENTRAL_DOCS_CACHE_TTL || '3600',
-      SQUAD_OVERRIDE: squad,
-      WORKSPACE_OVERRIDE: workspace
-    }
-    
-    const { stdout, stderr } = await execAsync(
-      `bash "${publishScript}" "${file}" "${tipo}" "${feature}"`,
-      { 
-        env: envVars,
-        maxBuffer: 10 * 1024 * 1024 // 10MB buffer para output grande
-      }
-    )
-    
-    // Exibir output do script
-    if (stdout) {
-      console.log(stdout)
-    }
-    
-    if (stderr) {
-      console.warn('⚠️  Avisos:', stderr)
-    }
-    
+    await publishFile({
+      localFile: file,
+      tipo,
+      feature,
+      squad,
+      workspace,
+      repo: env.CENTRAL_DOCS_REPO,
+      targetBranch: env.CENTRAL_DOCS_TARGET_BRANCH || "dev",
+      cacheTtl: env.CENTRAL_DOCS_CACHE_TTL || "3600",
+    });
   } catch (error) {
-    console.error('\n❌ Erro ao publicar documento\n')
-    
-    // Exibir output de erro do script
-    if (error.stdout) {
-      console.log(error.stdout)
-    }
-    
-    if (error.stderr) {
-      console.error(error.stderr)
-    }
-    
+    logger.error("\n❌ Erro ao publicar documento\n");
+    logger.error(error.message);
+
     // Dicas de troubleshooting
-    console.error('\n💡 Troubleshooting:\n')
-    
-    if (error.message.includes('Token GitLab')) {
-      console.error('1. Configure o token GitLab no .npmrc:')
-      console.error('   //gitlab.com/api/v4/packages/npm/:_authToken=seu-token\n')
+    logger.error("\n💡 Troubleshooting:\n");
+
+    if (error.message.includes("Token GitLab")) {
+      logger.error("1. Configure o token GitLab no .npmrc:");
+      logger.error("   //gitlab.com/api/v4/packages/npm/:_authToken=seu-token\n");
     }
-    
-    if (error.message.includes('Campos obrigatórios')) {
-      console.error('2. Verifique o frontmatter do documento:')
-      console.error(`   Tipo ${tipo} requer campos específicos no YAML\n`)
+
+    if (error.message.includes("Campos obrigatórios")) {
+      logger.error("2. Verifique o frontmatter do documento:");
+      logger.error(`   Tipo ${tipo} requer campos específicos no YAML\n`);
     }
-    
-    if (error.message.includes('401') || error.message.includes('403')) {
-      console.error('4. Verifique permissões no GitLab:')
-      console.error('   Token precisa de scopes: api, read_api, write_repository\n')
+
+    if (error.message.includes("401") || error.message.includes("403")) {
+      logger.error("4. Verifique permissões no GitLab:");
+      logger.error("   Token precisa de scopes: api, read_api, write_repository\n");
     }
-    
-    console.error('Para mais detalhes, execute com --verbose')
-    
-    process.exit(1)
+
+    logger.error("Para mais detalhes, execute com --verbose");
+
+    process.exit(1);
   }
 }

package/bin/commands/docs-sync.js

@@ -1,139 +1,101 @@
-import { loadEnv, resolveEnvPath } from '../lib/env-loader.js'
-import { exec } from 'node:child_process'
-import { promisify } from 'node:util'
-import { existsSync } from 'node:fs'
-import { join, dirname } from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-const execAsync = promisify(exec)
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = dirname(__filename)
+import { loadEnv, resolveEnvPath } from "../lib/env-loader.js";
+import { fetchFile } from "../lib/docs/fetch-file.js";
+import { logger, configureFromFlags } from "../lib/utils/logger.js";
 
 /**
  * Sincroniza documentação do central-docs
  * Executado automaticamente em /warm-up
- * 
+ *
  * @param {Object} flags - Flags do comando
- * @param {boolean} flags.silent - Modo silencioso (sem output)
- * @param {boolean} flags.verbose - Modo verbose (mostra conteúdo)
+ * @param {boolean} flags.silent - Modo silencioso (nem erros aparecem)
+ * @param {boolean} flags.quiet - Só erros aparecem
+ * @param {boolean} flags.verbose - Mostra o conteúdo completo retornado
  * @param {string} flags.envFile - Path customizado do ENV.md
  */
 export async function docsSync(flags = {}) {
-  const cwd = process.cwd()
-  
+  configureFromFlags(flags);
+
+  const cwd = process.cwd();
+
   // Resolver path do ENV.md (suporta --ide e --env-file)
-  let envPath
+  let envPath;
   try {
-    const resolved = resolveEnvPath(cwd, flags)
-    envPath = resolved.path
+    const resolved = resolveEnvPath(cwd, flags);
+    envPath = resolved.path;
   } catch (error) {
-    if (!flags.silent) {
-      console.error('❌ Erro ao resolver ENV.md:', error.message)
-    }
-    process.exit(1)
+    logger.error("❌ Erro ao resolver ENV.md:", error.message);
+    process.exit(1);
   }
-  
+
   // Carregar ENV.md
-  let env
+  let env;
   try {
-    env = loadEnv(cwd, envPath)
+    env = loadEnv(cwd, envPath);
   } catch (error) {
-    if (!flags.silent) {
-      console.error('❌ Erro ao carregar ENV.md:', error.message)
-    }
-    process.exit(1)
+    logger.error("❌ Erro ao carregar ENV.md:", error.message);
+    process.exit(1);
   }
-  
+
   // Verificar se central-docs está configurado
   if (!env.CENTRAL_DOCS_REPO) {
-    if (!flags.silent) {
-      console.log('ℹ️  Central docs não configurado (CENTRAL_DOCS_REPO vazio)')
-    }
-    return
+    logger.info("ℹ️  Central docs não configurado (CENTRAL_DOCS_REPO vazio)");
+    return;
   }
-  
-  const { SQUAD, WORKSPACE, CENTRAL_DOCS_REF = 'main' } = env
-  
+
+  const { SQUAD, WORKSPACE, CENTRAL_DOCS_REF = "main" } = env;
+
   if (!SQUAD || !WORKSPACE) {
-    if (!flags.silent) {
-      console.error('❌ SQUAD ou WORKSPACE não definidos no ENV.md')
-    }
-    process.exit(1)
-  }
-  
-  if (!flags.silent) {
-    console.log(`🔄 Sincronizando docs do squad ${SQUAD}...`)
+    logger.error("❌ SQUAD ou WORKSPACE não definidos no ENV.md");
+    process.exit(1);
   }
 
-  // Verificar se script fetch-file.sh existe
-  // Usar path relativo ao módulo, não ao cwd do usuário
-  const fetchScript = join(__dirname, '../lib/docs/fetch-file.sh')
-  if (!existsSync(fetchScript)) {
-    console.error('❌ Script não encontrado:', fetchScript)
-    process.exit(1)
-  }
+  logger.info(`🔄 Sincronizando docs do squad ${SQUAD}...`);
 
   // Buscar index.md do squad
-  const indexPath = `${SQUAD}/index.md`
-  
+  const indexPath = `${SQUAD}/index.md`;
+
   try {
-    // Exportar variáveis de ambiente para o script bash
-    const envVars = {
-      ...process.env,
-      CENTRAL_DOCS_REPO: env.CENTRAL_DOCS_REPO,
-      CENTRAL_DOCS_CACHE_TTL: env.CENTRAL_DOCS_CACHE_TTL || '3600'
-    }
-    
-    const { stdout, stderr } = await execAsync(
-      `bash "${fetchScript}" "${indexPath}" "${CENTRAL_DOCS_REF}"`,
-      { env: envVars }
-    )
-    
-    if (!flags.silent) {
-      console.log('✅ Docs sincronizados')
-    }
-    
-    if (flags.verbose && stdout) {
-      console.log('\n📄 Conteúdo do index.md:\n')
-      console.log(stdout)
+    const content = await fetchFile(indexPath, CENTRAL_DOCS_REF, {
+      repo: env.CENTRAL_DOCS_REPO,
+      cacheTtl: env.CENTRAL_DOCS_CACHE_TTL || "3600",
+    });
+
+    logger.info("✅ Docs sincronizados");
+
+    if (content) {
+      logger.debug("\n📄 Conteúdo do index.md:\n");
+      logger.debug(content);
     }
-    
+
     // Parsear index.md para contar documentos
-    if (!flags.silent && stdout) {
-      const prdCount = (stdout.match(/\[prd-.*\.md\]/g) || []).length
-      const frdCount = (stdout.match(/\[frd-.*\.md\]/g) || []).length
-      const ardCount = (stdout.match(/\[ard-.*\.md\]/g) || []).length
-      const rfcCount = (stdout.match(/\[rfc-.*\.md\]/g) || []).length
-      
-      const total = prdCount + frdCount + ardCount + rfcCount
-      
+    if (content) {
+      const prdCount = (content.match(/\[prd-.*\.md\]/g) || []).length;
+      const frdCount = (content.match(/\[frd-.*\.md\]/g) || []).length;
+      const ardCount = (content.match(/\[ard-.*\.md\]/g) || []).length;
+      const rfcCount = (content.match(/\[rfc-.*\.md\]/g) || []).length;
+
+      const total = prdCount + frdCount + ardCount + rfcCount;
+
       if (total > 0) {
-        console.log(`📊 ${total} documentos disponíveis:`)
-        if (prdCount > 0) console.log(`   - ${prdCount} PRD(s)`)
-        if (frdCount > 0) console.log(`   - ${frdCount} FRD(s)`)
-        if (ardCount > 0) console.log(`   - ${ardCount} ARD(s)`)
-        if (rfcCount > 0) console.log(`   - ${rfcCount} RFC(s)`)
+        logger.info(`📊 ${total} documentos disponíveis:`);
+        if (prdCount > 0) logger.info(`   - ${prdCount} PRD(s)`);
+        if (frdCount > 0) logger.info(`   - ${frdCount} FRD(s)`);
+        if (ardCount > 0) logger.info(`   - ${ardCount} ARD(s)`);
+        if (rfcCount > 0) logger.info(`   - ${rfcCount} RFC(s)`);
       }
     }
-    
-    if (stderr && !flags.silent) {
-      console.warn('⚠️  Avisos:', stderr)
-    }
-    
   } catch (error) {
-    if (!flags.silent) {
-      console.error('❌ Erro ao sincronizar docs:', error.message)
-      
-      // Dicas de troubleshooting
-      if (error.message.includes('Token GitLab')) {
-        console.error('\n💡 Configure o token GitLab no .npmrc:')
-        console.error('   //gitlab.com/api/v4/packages/npm/:_authToken=seu-token')
-      } else if (error.message.includes('não encontrado')) {
-        console.error('\n💡 Verifique se o squad existe no central-docs:')
-        console.error(`   ${SQUAD}/index.md`)
-      }
+    logger.error("❌ Erro ao sincronizar docs:", error.message);
+
+    // Dicas de troubleshooting
+    if (error.message.includes("Token GitLab")) {
+      logger.error("\n💡 Configure o token GitLab no .npmrc:");
+      logger.error("   //gitlab.com/api/v4/packages/npm/:_authToken=seu-token");
+    } else if (error.message.includes("não encontrado")) {
+      logger.error("\n💡 Verifique se o squad existe no central-docs:");
+      logger.error(`   ${SQUAD}/index.md`);
     }
 
-    process.exit(1)
+    process.exit(1);
   }
 }

package/bin/commands/info.js

@@ -1,14 +1,5 @@
 import { findPrompt, discoverAll } from "../lib/core/scanner.js";
-import {
-  showBanner,
-  RED,
-  GREEN,
-  BLUE,
-  YELLOW,
-  CYAN,
-  DIM,
-  NC,
-} from "../lib/utils/ui.js";
+import { showBanner, RED, GREEN, BLUE, YELLOW, CYAN, DIM, NC } from "../lib/utils/ui.js";
 import { logger } from "../lib/utils/logger.js";
 
 export async function info(target) {
@@ -40,15 +31,12 @@ export async function info(target) {
 
   if (!prompt) {
     logger.error(`${RED}❌ Não encontrado: ${YELLOW}${target}${NC}`);
-    logger.info(
-      `${DIM}Execute: ${YELLOW}jarvis list${DIM} para ver prompts disponíveis${NC}\n`,
-    );
+    logger.info(`${DIM}Execute: ${YELLOW}jarvis list${DIM} para ver prompts disponíveis${NC}\n`);
     process.exit(1);
   }
 
   // Icon based on type
-  const icon =
-    prompt.type === "agent" ? "🤖" : prompt.type === "skill" ? "⚡" : "🔄";
+  const icon = prompt.type === "agent" ? "🤖" : prompt.type === "skill" ? "⚡" : "🔄";
 
   logger.info(`${CYAN}${icon} ${prompt.type.toUpperCase()}/${prompt.id}${NC}`);
   logger.info("");
@@ -67,21 +55,13 @@ export async function info(target) {
   if (hasDeps) {
     logger.info(`  ${YELLOW}📦 Dependências:${NC}`);
     if (deps.rules.length)
-      logger.info(
-        `    ${BLUE}Rules:${NC}     ${DIM}${deps.rules.join(", ")}${NC}`,
-      );
+      logger.info(`    ${BLUE}Rules:${NC}     ${DIM}${deps.rules.join(", ")}${NC}`);
     if (deps.templates.length)
-      logger.info(
-        `    ${BLUE}Templates:${NC} ${DIM}${deps.templates.join(", ")}${NC}`,
-      );
+      logger.info(`    ${BLUE}Templates:${NC} ${DIM}${deps.templates.join(", ")}${NC}`);
     if (deps.agents.length)
-      logger.info(
-        `    ${BLUE}Agents:${NC}    ${DIM}${deps.agents.join(", ")}${NC}`,
-      );
+      logger.info(`    ${BLUE}Agents:${NC}    ${DIM}${deps.agents.join(", ")}${NC}`);
     if (deps.skills.length)
-      logger.info(
-        `    ${BLUE}Skills:${NC}    ${DIM}${deps.skills.join(", ")}${NC}`,
-      );
+      logger.info(`    ${BLUE}Skills:${NC}    ${DIM}${deps.skills.join(", ")}${NC}`);
     logger.info("");
   }
 }