agent-master-devsecops 0.0.0-stage → 3.9.0

package/scripts/bootstrap_cli.js

@@ -0,0 +1,468 @@
+#!/usr/bin/env node
+/**
+ * scripts/bootstrap_cli.js
+ * 
+ * Universal One-Line Bootstrap CLI (AGDEV-26 / I-12).
+ * Auto-detecta IDEs instaladas (Cursor, Windsurf, VS Code, Claude Desktop, Ollama)
+ * e provisiona o Agent Master DevSecOps e servidor MCP com zero configuração em < 2 segundos.
+ */
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { execSync, execFileSync } = require('node:child_process');
+const { UniversalPackager } = require('./universal_packager.js');
+const { runCredentialHealthcheck } = require('./credentials_guard.js');
+const { detectProjectMode, inspectProjectContext } = require('./smart_onboarding.js');
+
+const CANONICAL_FILES = [
+  'agents/AGENT_ORCHESTRATOR.md',
+  'agents/AGENT_UIUX.md',
+  'agents/AGENT_DEVSECOPS.md',
+  'agents/AGENT_SCRUM.md',
+  'agents/AGENT_SRE.md',
+  'agents/AGENT_QA.md',
+  'docs/ENGINEERING_RULES.md',
+  'docs/ARCHITECTURE.md',
+  'docs/IDEAS.md'
+];
+
+function commandExists(cmd) {
+  try {
+    const isWindows = process.platform === 'win32';
+    const testCmd = isWindows ? `where ${cmd}` : `which ${cmd}`;
+    execSync(testCmd, { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function detectEnvironments(targetDir = process.cwd(), options = {}) {
+  const detected = {
+    cursor: false,
+    windsurf: false,
+    vscode: false,
+    claude_desktop: false,
+    ollama: false,
+    antigravity: false,
+    generic: true
+  };
+
+  const isWindows = process.platform === 'win32';
+  const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+  const appData = process.env.APPDATA || '';
+
+  // 0. Se plataformas foram especificadas expressamente (options.platforms), honrar estritamente
+  if (options.platforms && options.platforms.length > 0) {
+    for (const p of options.platforms) {
+      const clean = String(p).toLowerCase().trim();
+      if (clean === 'all' || clean === 'universal') {
+        detected.cursor = true;
+        detected.windsurf = true;
+        detected.vscode = true;
+        detected.claude_desktop = true;
+        detected.antigravity = true;
+      } else if (clean === 'vscode' || clean === 'code') {
+        detected.vscode = true;
+      } else if (clean === 'antigravity' || clean === 'gemini') {
+        detected.antigravity = true;
+      } else if (clean === 'cursor') {
+        detected.cursor = true;
+      } else if (clean === 'windsurf') {
+        detected.windsurf = true;
+      } else if (clean === 'claude_desktop' || clean === 'claude') {
+        detected.claude_desktop = true;
+      } else if (clean === 'ollama') {
+        detected.ollama = true;
+      }
+    }
+    return detected;
+  }
+
+  // 1. Detectar Antigravity no targetDir ou processo ativo
+  const isRunningInAntigravity = Boolean(process.env.ANTIGRAVITY_AGENT || process.env.ANTIGRAVITY_APP_DATA_DIR);
+  if (
+    isRunningInAntigravity ||
+    fs.existsSync(path.join(targetDir, '.antigravity')) ||
+    fs.existsSync(path.join(targetDir, '.gemini'))
+  ) {
+    detected.antigravity = true;
+  }
+
+  // 2. Detectar Cursor no targetDir
+  if (
+    fs.existsSync(path.join(targetDir, '.cursor')) ||
+    fs.existsSync(path.join(targetDir, '.cursorrules'))
+  ) {
+    detected.cursor = true;
+  }
+
+  // 3. Detectar Windsurf no targetDir
+  if (
+    fs.existsSync(path.join(targetDir, '.windsurf')) ||
+    fs.existsSync(path.join(targetDir, '.windsurfrules'))
+  ) {
+    detected.windsurf = true;
+  }
+
+  // 4. Detectar VS Code SOMENTE se houver diretório .vscode existente no targetDir
+  // Evita poluir o projeto com .vscode/ apenas por ter a IDE instalada no sistema operacional
+  if (fs.existsSync(path.join(targetDir, '.vscode'))) {
+    detected.vscode = true;
+  }
+
+  // 5. Detectar Claude Desktop no targetDir
+  if (
+    fs.existsSync(path.join(targetDir, '.claude')) ||
+    fs.existsSync(path.join(targetDir, 'claude_desktop_config.json'))
+  ) {
+    detected.claude_desktop = true;
+  }
+
+  // 6. Detectar Ollama no targetDir
+  if (fs.existsSync(path.join(targetDir, 'Modelfile'))) {
+    detected.ollama = true;
+  }
+
+  // Se nenhum arquivo de IDE foi encontrado no diretório do projeto:
+  const hasProjectLevelIde = detected.antigravity || detected.cursor || detected.windsurf || detected.vscode || detected.claude_desktop || detected.ollama;
+  if (!hasProjectLevelIde) {
+    // Se há Antigravity no ambiente do usuário, assume Antigravity por padrão
+    if (
+      (homeDir && fs.existsSync(path.join(homeDir, '.gemini', 'antigravity'))) ||
+      commandExists('antigravity') ||
+      commandExists('agy')
+    ) {
+      detected.antigravity = true;
+    }
+  }
+
+  return detected;
+}
+
+function bootstrapEnvironment(targetDir = process.cwd(), options = {}) {
+  const startTime = Date.now();
+  const rootSource = path.resolve(__dirname, '..');
+  const dryRun = Boolean(options.dryRun);
+
+  // 1. Auto-detectar ambientes
+  const detected = options.platforms 
+    ? detectEnvironments(targetDir, { platforms: options.platforms })
+    : detectEnvironments(targetDir, options);
+
+  const activePlatforms = Object.keys(detected).filter(k => detected[k]);
+  const credentialHealth = runCredentialHealthcheck(targetDir);
+  const projectMode = detectProjectMode(targetDir);
+  const projectContext = inspectProjectContext(targetDir);
+
+  const results = {
+    onboardingMode: projectMode.mode,
+    projectContext,
+    status: 'SUCCESS',
+    targetDir,
+    dryRun,
+    detectedEnvironments: detected,
+    activePlatforms,
+    credentials: {
+      allReady: credentialHealth.allReady,
+      github: credentialHealth.github,
+      atlassian: credentialHealth.atlassian,
+      missing: credentialHealth.missing,
+      promptGuidance: credentialHealth.promptGuidance
+    },
+    copiedFiles: [],
+    configuredPlatforms: [],
+    mcpServerPath: path.resolve(rootSource, 'scripts', 'mcp_server.js'),
+    durationMs: 0
+  };
+
+  // 2. Provisionar arquivos canônicos do agente no targetDir (Modo Limpo de Submódulo)
+  const isSubmoduleMode = Boolean(
+    !options.forceCopy &&
+    (
+      path.resolve(targetDir, 'agent-master-devsecops') === rootSource ||
+      (fs.existsSync(path.join(targetDir, '.gitmodules')) && fs.existsSync(path.join(targetDir, 'agent-master-devsecops')))
+    )
+  );
+
+  results.isSubmoduleMode = isSubmoduleMode;
+
+  if (!isSubmoduleMode) {
+    const agentDir = path.join(targetDir, 'agents');
+    const docDir = path.join(targetDir, 'docs');
+
+    if (!dryRun) {
+      if (!fs.existsSync(agentDir)) fs.mkdirSync(agentDir, { recursive: true });
+      if (!fs.existsSync(docDir)) fs.mkdirSync(docDir, { recursive: true });
+    }
+
+    for (const relFile of CANONICAL_FILES) {
+      const src = path.join(rootSource, relFile);
+      const actualSrc = src;
+      const dest = path.join(targetDir, relFile);
+
+      if (fs.existsSync(actualSrc)) {
+        if (!dryRun) {
+          const destParent = path.dirname(dest);
+          if (!fs.existsSync(destParent)) fs.mkdirSync(destParent, { recursive: true });
+          fs.copyFileSync(actualSrc, dest);
+        }
+        results.copiedFiles.push(relFile);
+      }
+    }
+  } else {
+    results.submoduleNotice = 'Submódulo detectado. Cópia redundante de agents/ e docs/ na raiz suprimida com sucesso (Modo Limpo - Regra 16).';
+  }
+
+  // 3. Gerar configurações das plataformas detectadas
+  const packager = new UniversalPackager(rootSource);
+
+  if (detected.cursor) {
+    const res = packager.generateCursorProfile(targetDir, { dryRun, mcpServerPath: results.mcpServerPath });
+    results.configuredPlatforms.push({ platform: 'cursor', files: res.filesCount });
+  }
+
+  if (detected.windsurf) {
+    const res = packager.generateWindsurfProfile(targetDir, { dryRun });
+    results.configuredPlatforms.push({ platform: 'windsurf', files: res.filesCount });
+  }
+
+  if (detected.vscode) {
+    const res = packager.generateVsCodeProfile(targetDir, { dryRun, mcpServerPath: results.mcpServerPath });
+    results.configuredPlatforms.push({ platform: 'vscode', files: res.filesCount });
+  }
+
+  if (detected.claude_desktop) {
+    const res = packager.generateClaudeDesktopConfig(targetDir, { dryRun, mcpServerPath: results.mcpServerPath });
+    results.configuredPlatforms.push({ platform: 'claude_desktop', files: res.filesCount });
+  }
+
+  if (detected.antigravity) {
+    const res = packager.generateAntigravityConfig(targetDir, { dryRun, mcpServerPath: results.mcpServerPath });
+    results.configuredPlatforms.push({ platform: 'antigravity', files: res.filesCount });
+  }
+
+  if (detected.ollama) {
+    const res = packager.generateOllamaModelfile(targetDir, { dryRun });
+    results.configuredPlatforms.push({ platform: 'ollama', files: res.filesCount });
+  }
+
+  // Se nenhuma IDE especializada foi detectada, gera o bundle universal genérico
+  if (results.configuredPlatforms.length === 0) {
+    const res = packager.generateCursorProfile(targetDir, { dryRun, mcpServerPath: results.mcpServerPath });
+    results.configuredPlatforms.push({ platform: 'universal_fallback_cursor', files: res.filesCount });
+  }
+
+  results.durationMs = Date.now() - startTime;
+  return results;
+}
+
+if (require.main === module) {
+  (async () => {
+    const args = process.argv.slice(2);
+    const dryRun = args.includes('--dryRun') || args.includes('-d');
+    const detectOnly = args.includes('--detectOnly');
+    const nonInteractive = args.includes('--non-interactive') || args.includes('--yes') || args.includes('-y');
+    let targetDir = process.cwd();
+
+    const targetIdx = args.findIndex(a => a === '--targetDir' || a === '-t');
+    if (targetIdx !== -1 && args[targetIdx + 1]) {
+      targetDir = path.resolve(args[targetIdx + 1]);
+    }
+
+    let requestedPlatform = null;
+    const platformIdx = args.findIndex(a => a === '--platform' || a === '-p');
+    if (platformIdx !== -1 && args[platformIdx + 1]) {
+      requestedPlatform = args[platformIdx + 1].toLowerCase().trim();
+    }
+
+    console.log('\n============================================================');
+    console.log('⚡ Agent Master DevSecOps — Universal One-Line Bootstrap CLI');
+    console.log('============================================================\n');
+
+    // Auto-diagnóstico de integridade do executável (Prevenção de links órfãos)
+    try {
+      if (!fs.existsSync(__filename)) {
+        console.warn('⚠️ AVISO: Executável rodando a partir de um link simbólico quebrado ou desatualizado.\n');
+      }
+    } catch (_) {}
+
+    if (detectOnly) {
+      const detected = detectEnvironments(targetDir, { platforms: requestedPlatform ? [requestedPlatform] : undefined });
+      console.log('🔍 Ambientes Detectados em:', targetDir);
+      console.log(JSON.stringify(detected, null, 2));
+      process.exit(0);
+    }
+
+    let selectedPlatforms = requestedPlatform ? [requestedPlatform] : null;
+
+    // Se nenhuma plataforma foi passada via flag e o terminal é interativo (TTY), exibe menu de seleção
+    if (!selectedPlatforms && process.stdin.isTTY && !nonInteractive && !dryRun) {
+      const initialDetected = detectEnvironments(targetDir);
+      const hasExplicitProjectConfig = initialDetected.cursor || initialDetected.windsurf || initialDetected.vscode || initialDetected.claude_desktop;
+
+      if (!hasExplicitProjectConfig) {
+        const readline = require('node:readline/promises');
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+        console.log('🛠️  Selecione a IDE / Plataforma para este projeto:');
+        console.log('  1) Google Antigravity (Padrão)');
+        console.log('  2) Cursor IDE (.cursorrules + .cursor/mcp.json)');
+        console.log('  3) Windsurf IDE (.windsurfrules)');
+        console.log('  4) VS Code (.vscode/mcp.json)');
+        console.log('  5) Claude Desktop (claude_desktop_config.json)');
+        console.log('  6) Universal (Configurar todas as plataformas)\n');
+
+        try {
+          const answer = await rl.question('👉 Escolha uma opção (1-6) [1]: ');
+          const choice = answer.trim();
+          switch (choice) {
+            case '2': selectedPlatforms = ['cursor']; break;
+            case '3': selectedPlatforms = ['windsurf']; break;
+            case '4': selectedPlatforms = ['vscode']; break;
+            case '5': selectedPlatforms = ['claude_desktop']; break;
+            case '6': selectedPlatforms = ['all']; break;
+            case '1':
+            case '':
+            default:
+              selectedPlatforms = ['antigravity']; break;
+          }
+        } catch (_) {
+          selectedPlatforms = ['antigravity'];
+        } finally {
+          rl.close();
+        }
+        console.log();
+      }
+    }
+
+    const bootOptions = { dryRun };
+    if (selectedPlatforms) {
+      bootOptions.platforms = selectedPlatforms;
+    }
+
+    const result = bootstrapEnvironment(targetDir, bootOptions);
+    console.log(`✅ Bootstrapping concluído com sucesso em ${result.durationMs}ms!`);
+    console.log(`📂 Diretório Alvo: ${result.targetDir}`);
+    console.log(`🔍 Modo de Projeto (Regra 16): [${result.onboardingMode}] (${result.onboardingMode === 'BROWNFIELD' ? 'Projeto existente mapeado' : 'Projeto novo do zero'})`);
+    if (result.projectContext && result.projectContext.stack && result.projectContext.stack.length > 0) {
+      console.log(`🛠️ Stack Mapeada: ${result.projectContext.stack.join(', ')}`);
+    }
+    if (result.isSubmoduleMode) {
+      console.log(`✨ Modo Submódulo Limpo: Os arquivos canônicos residem em 'agent-master-devsecops/'. Nenhuma pasta duplicada criada na raiz!`);
+    } else {
+      console.log(`📄 Arquivos Canônicos Injetados: ${result.copiedFiles.length}`);
+    }
+    console.log(`🛠️ Plataformas Configuradas:`, result.configuredPlatforms.map(p => p.platform).join(', '));
+    console.log(`🔌 Servidor MCP Vinculado: ${result.mcpServerPath}`);
+
+    if (!result.credentials.allReady) {
+      console.log('\n------------------------------------------------------------');
+      console.log(result.credentials.promptGuidance);
+      console.log('------------------------------------------------------------\n');
+
+      if (process.stdin.isTTY && !nonInteractive) {
+        const readline = require('node:readline/promises');
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        try {
+          const ans = await rl.question('🔑 Deseja cadastrar as credenciais da Atlassian agora no .env? (s/n): ');
+          if (ans.trim().toLowerCase() === 's') {
+            const domain = await rl.question('Domínio Atlassian (ex: empresa.atlassian.net): ');
+            const email = await rl.question('Email da conta Atlassian: ');
+            const token = await rl.question('API Token Atlassian: ');
+            const jiraKey = await rl.question('Chave do Projeto no Jira (ex: AGDEV ou PROJ): ');
+            const confluenceSpace = await rl.question('Chave do Espaço no Confluence (ex: AGDEV ou DOCS): ');
+            const { configureCredentials } = require('./credentials_guard.js');
+            configureCredentials(targetDir, { domain, email, token, jiraKey, confluenceSpace });
+            console.log('\n✅ Credenciais salvas com sucesso em .env (protegido pelo .gitignore)!\n');
+          }
+        } catch (_) {}
+        finally {
+          rl.close();
+        }
+      }
+    } else {
+      console.log('🩺 Credenciais Atlassian & GitHub: 100% Autenticadas e Prontas!\n');
+    }
+
+    console.log('O Agent Master está pronto para uso na sua IDE e LLM!\n');
+  })();
+}
+
+/**
+ * Validação de integridade estrutural modular
+ */
+function validateModularStructure(baseDir) {
+  const missing = [];
+  const present = [];
+
+  for (const relPath of CANONICAL_FILES) {
+    const fullPath = path.join(baseDir, relPath);
+    if (fs.existsSync(fullPath)) {
+      present.push(relPath);
+    } else {
+      missing.push(relPath);
+    }
+  }
+
+  return {
+    valid: missing.length === 0,
+    total: CANONICAL_FILES.length,
+    present,
+    missing
+  };
+}
+
+/**
+ * Função de inicialização universal com contrato do init_cli
+ */
+function initProject(targetDir = process.cwd(), options = {}) {
+  const res = bootstrapEnvironment(targetDir, options);
+  res.rulesConfigured = res.copiedFiles.length > 0 || Boolean(options.dryRun) || Boolean(res.isSubmoduleMode);
+  res.mcpConfigured = true;
+  return res;
+}
+
+/**
+ * Renderiza o prompt canônico customizado com metadados do projeto.
+ */
+function renderCanonicalPrompt(meta = {}) {
+  const projectName = meta.projectName || 'Enterprise Software System';
+  const techStack = meta.techStack || 'Polyglot / Universal Multi-Stack';
+  const ticketSystem = meta.ticketSystem || 'Jira Cloud / GitHub Issues';
+
+  return `Você é o AGENT ORCHESTRATOR DE ENGENHARIA DE SOFTWARE, ARQUITETURA, DEVSECOPS E GOVERNANÇA do projeto "${projectName}".
+Stack Tecnológica: ${techStack}
+Sistema de Governança & Rastreabilidade: ${ticketSystem}
+
+Você opera sob a estrutura modular soberana das pastas /agents e /docs com contratos de engenharia catalogados:
+- agents/AGENT_ORCHESTRATOR.md (Orquestrador multi-persona)
+- agents/AGENT_UIUX.md (Product Designer, UX/UI, Heurísticas & WCAG 2.1 AA)
+- agents/AGENT_DEVSECOPS.md (Staff Engineer & DevSecOps Lead)
+- agents/AGENT_QA.md (Auditor adversário independente)
+- agents/AGENT_SCRUM.md (Gestão ágil, melhoria contínua e PDCA)
+- agents/AGENT_SRE.md (SRE Lead, observabilidade e telemetria)
+- docs/ENGINEERING_RULES.md (14 Regras Fundamentais de Engenharia)
+- README.md (Manual mestre, catálogo e MCP)
+- docs/ARCHITECTURE.md (Topologia cooperativa e matriz de handovers)
+
+Modos de Operação Disponíveis:
+- modo: orchestrator
+- modo: uiux
+- modo: devsecops
+- modo: qa
+- modo: scrum
+- modo: sre
+- modo: full-dev (loop ininterrupto de implementação autônoma)
+
+Protocolo Obrigatório: Protocolo de Resposta em Duas Camadas (relatórios densos de 15 seções externalizados no Jira/Confluence/PRs e respostas curtas com links e dupla quebra de linha (\\n\\n) no chat). Declare prontidão para atuar.`;
+}
+
+module.exports = {
+  detectEnvironments,
+  bootstrapEnvironment,
+  CANONICAL_FILES,
+  initProject,
+  validateModularStructure,
+  renderCanonicalPrompt
+};