mega-brain-ai 1.1.0

package/bin/lib/installer.js

@@ -0,0 +1,402 @@
+/**
+ * Mega Brain - Installer Module
+ * Handles the full installation flow:
+ *   1. Edition selection (PREMIUM vs Community)
+ *   2. Email validation (PREMIUM only)
+ *   3. Directory setup
+ *   4. File copy (shell)
+ *   5. Premium content fetch (if validated)
+ *   6. Post-install summary
+ */
+
+import { createInterface } from 'readline';
+import { existsSync, mkdirSync, cpSync, writeFileSync, readFileSync } from 'fs';
+import { resolve, dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+import { validateEmail, getErrorMessage, resetAttempts } from './validate-email.js';
+import { showStep, showSuccess, showError, showPostInstall } from './ascii-art.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const TEMPLATE_ROOT = resolve(__dirname, '..', '..');
+
+function prompt(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+/**
+ * Main installer flow
+ */
+export async function runInstaller(version) {
+  console.log('\n  Bem-vindo ao instalador do Mega Brain!\n');
+
+  // ──────────────────────────────────────────────────────────
+  // STEP 1: Edition Selection
+  // ──────────────────────────────────────────────────────────
+  showStep(1, 5, 'Selecione sua Edição');
+
+  const isPremium = await selectEdition();
+
+  // ──────────────────────────────────────────────────────────
+  // STEP 2: Email Validation (PREMIUM only)
+  // ──────────────────────────────────────────────────────────
+  let buyerName = '';
+  let premiumToken = null;
+
+  if (isPremium) {
+    showStep(2, 5, 'Validação de Acesso Premium');
+
+    let validated = false;
+    resetAttempts();
+
+    while (!validated) {
+      const email = await prompt('  Digite o email cadastrado no MoneyClub: ');
+
+      if (!email) {
+        showError('Email não pode estar vazio.');
+        continue;
+      }
+
+      console.log('  Verificando...');
+      const result = await validateEmail(email);
+
+      if (result.valid) {
+        buyerName = result.name || 'Membro';
+        premiumToken = result.premium_token || null;
+        console.log(`\n  Bem-vindo, ${buyerName}! Acesso PREMIUM confirmado.`);
+        if (result.installCount > 1) {
+          console.log(`  (Esta é a sua instalação #${result.installCount})`);
+        }
+        validated = true;
+      } else {
+        showError(getErrorMessage(result.reason));
+        if (result.reason === 'max_attempts_exceeded') {
+          process.exit(1);
+        }
+        const retry = await prompt('  Tentar novamente? (s/n): ');
+        if (retry.toLowerCase() !== 's') {
+          console.log('\n  Instalação cancelada.\n');
+          process.exit(0);
+        }
+      }
+    }
+  } else {
+    showStep(2, 5, 'Modo Community — Pulando validação');
+    console.log('\n  Instalando versão Community (shell sem conteúdo premium).');
+    buyerName = 'Community User';
+  }
+
+  // ──────────────────────────────────────────────────────────
+  // STEP 3: Installation Directory
+  // ──────────────────────────────────────────────────────────
+  showStep(3, 5, 'Diretório de Instalação');
+
+  console.log('\n  Onde deseja instalar o Mega Brain?');
+  console.log('  [1] Diretório atual (.)');
+  console.log('  [2] Novo diretório (./mega-brain)');
+  console.log('  [3] Caminho personalizado\n');
+
+  const choice = await prompt('  Escolha (1/2/3): ');
+
+  let targetDir;
+  switch (choice) {
+    case '1':
+      targetDir = process.cwd();
+      break;
+    case '3': {
+      const customPath = await prompt('  Digite o caminho completo: ');
+      targetDir = resolve(customPath);
+      break;
+    }
+    case '2':
+    default:
+      targetDir = resolve(process.cwd(), 'mega-brain');
+      break;
+  }
+
+  if (existsSync(join(targetDir, '.claude', 'CLAUDE.md'))) {
+    const overwrite = await prompt(`\n  Mega Brain ja existe em ${targetDir}. Sobrescrever? (s/n): `);
+    if (overwrite.toLowerCase() !== 's') {
+      console.log('\n  Instalação cancelada.\n');
+      process.exit(0);
+    }
+  }
+
+  // ──────────────────────────────────────────────────────────
+  // STEP 4: Install Shell (Layer 1 — always)
+  // ──────────────────────────────────────────────────────────
+  showStep(4, 5, 'Instalando estrutura base...');
+
+  try {
+    if (!existsSync(targetDir)) {
+      mkdirSync(targetDir, { recursive: true });
+    }
+
+    // Copy template files (excluding node_modules, .git, bin/)
+    const excludeDirs = ['.git', 'node_modules', 'bin'];
+    copyTemplateFiles(TEMPLATE_ROOT, targetDir, excludeDirs);
+
+    // Create .env from template
+    const envTemplate = resolve(__dirname, '..', 'templates', 'env.example');
+    if (existsSync(envTemplate)) {
+      const envContent = readFileSync(envTemplate, 'utf-8');
+      writeFileSync(join(targetDir, '.env.example'), envContent);
+    }
+
+    // Ensure all directories exist with .gitkeep
+    ensureDirectories(targetDir);
+
+    console.log('\n  Estrutura base instalada com sucesso!');
+  } catch (err) {
+    showError(`Erro ao instalar: ${err.message}`);
+    process.exit(1);
+  }
+
+  // ──────────────────────────────────────────────────────────
+  // STEP 5: Fetch Premium Content (Layer 2 — PREMIUM only)
+  // ──────────────────────────────────────────────────────────
+  if (isPremium && premiumToken) {
+    showStep(5, 5, 'Baixando conteúdo PREMIUM...');
+
+    try {
+      await fetchPremiumContent(targetDir, premiumToken);
+      console.log('\n  Conteúdo PREMIUM instalado com sucesso!');
+    } catch (err) {
+      console.log(`\n  AVISO: Não foi possível baixar conteúdo premium: ${err.message}`);
+      console.log('  Você pode tentar novamente depois com: mega-brain upgrade');
+    }
+  } else {
+    showStep(5, 5, 'Instalação Completa');
+  }
+
+  // ──────────────────────────────────────────────────────────
+  // Summary
+  // ──────────────────────────────────────────────────────────
+  if (isPremium) {
+    showPostInstallPremium(buyerName);
+  } else {
+    showPostInstallCommunity();
+  }
+}
+
+/**
+ * Edition selection with marketing copy
+ */
+async function selectEdition() {
+  console.log(`
+  ┌──────────────────────────────────────────────────────────────────────┐
+  │                                                                      │
+  │   [1]  PREMIUM — Membro MoneyClub                                   │
+  │                                                                      │
+  │        O sistema COMPLETO com o cérebro ligado.                      │
+  │        Inclui Mentes Clonadas de experts reais, Agentes             │
+  │        Operacionais que trabalham no seu negócio, +$500 mil         │
+  │        dólares em conteúdo pago já processado e pronto.             │
+  │                                                                      │
+  │        → Clones cognitivos que PENSAM como os experts               │
+  │        → C-Levels (CRO, CFO, CMO, COO) operando 24/7               │
+  │        → Squad de Vendas (Closer, BDR, SDS, LNS)                   │
+  │        → Conclave de Deliberação Estratégica                        │
+  │        → Playbooks e Frameworks extraídos de +50 fontes pagas       │
+  │        → Pipeline JARVIS de processamento inteligente               │
+  │                                                                      │
+  │        Requer email cadastrado no MoneyClub.                        │
+  │                                                                      │
+  ├──────────────────────────────────────────────────────────────────────┤
+  │                                                                      │
+  │   [2]  COMMUNITY — Máquina sem Cérebro                              │
+  │                                                                      │
+  │        A estrutura vazia. Comandos, skills e protocolos             │
+  │        do JARVIS, mas SEM conteúdo processado.                      │
+  │        Você precisará alimentar tudo do zero.                       │
+  │                                                                      │
+  │        → Estrutura de pastas e comandos                             │
+  │        → Skills e hooks do Claude Code                              │
+  │        → Templates vazios para começar                              │
+  │        → Sem agentes, sem playbooks, sem DNAs                       │
+  │                                                                      │
+  └──────────────────────────────────────────────────────────────────────┘
+`);
+
+  const choice = await prompt('  Sua escolha (1/2): ');
+  return choice === '1';
+}
+
+/**
+ * Fetch premium content from private repo using token
+ *
+ * SECURITY DESIGN:
+ *   - Token is passed via git http.extraheader, NEVER embedded in the clone URL.
+ *     This means .git/config inside the temp clone does NOT contain the token.
+ *   - ZERO recursive delete operations (rm -rf / rmSync recursive).
+ *     The .layer-sync/ directory is left in place and listed in .gitignore.
+ *     This installer runs on other people's machines — we never risk data loss.
+ */
+async function fetchPremiumContent(targetDir, token) {
+  const premiumRepo = 'https://github.com/thiagofinch/mega-brain-premium.git';
+  const tempDir = join(targetDir, '.layer-sync', 'premium-fetch');
+
+  // Safety: ensure tempDir is strictly INSIDE targetDir (prevent path traversal)
+  const resolvedTemp = resolve(tempDir);
+  const resolvedTarget = resolve(targetDir);
+  if (!resolvedTemp.startsWith(resolvedTarget + '/') && !resolvedTemp.startsWith(resolvedTarget + '\\')) {
+    throw new Error('Erro interno: caminho de download fora do diretório de instalação.');
+  }
+
+  if (!existsSync(dirname(tempDir))) {
+    mkdirSync(dirname(tempDir), { recursive: true });
+  }
+
+  // If a previous clone exists, reuse it (no delete + re-clone)
+  if (!existsSync(join(tempDir, '.git'))) {
+    // Use http.extraheader so the token is NEVER written to .git/config.
+    // The -c flag is a runtime-only override — not persisted to disk.
+    const base64Auth = Buffer.from(`x-access-token:${token}`).toString('base64');
+
+    execSync(
+      `git -c "http.https://github.com/.extraheader=AUTHORIZATION: basic ${base64Auth}" clone --depth 1 "${premiumRepo}" "${tempDir}"`,
+      {
+        stdio: 'pipe',
+        encoding: 'utf-8',
+        timeout: 120000,
+      }
+    );
+  } else {
+    console.log('  Download anterior encontrado, reutilizando...');
+  }
+
+  // Copy premium content over the shell (merge, not replace)
+  const excludeDirs = ['.git', 'node_modules', 'bin', '.layer-sync'];
+  cpSync(tempDir, targetDir, {
+    recursive: true,
+    force: true,
+    filter: (src) => {
+      for (const exclude of excludeDirs) {
+        if (src.includes(`${exclude}/`) || src.includes(`${exclude}\\`) || src.endsWith(exclude)) {
+          return false;
+        }
+      }
+      return true;
+    },
+  });
+
+  console.log('  Conteúdo premium integrado na estrutura.');
+
+  // NOTE: .layer-sync/ is intentionally NOT deleted.
+  // It is listed in .gitignore and contains no sensitive data
+  // (token was never written to disk thanks to http.extraheader).
+  // We NEVER use recursive delete operations on user machines.
+}
+
+/**
+ * Post-install message for PREMIUM users
+ */
+function showPostInstallPremium(name) {
+  console.log(`
+  ┌──────────────────────────────────────────────────────────────┐
+  │                                                              │
+  │  Mega Brain PREMIUM instalado com sucesso!                   │
+  │                                                              │
+  │  Bem-vindo ao sistema completo, ${(name + '!').padEnd(25)}  │
+  │                                                              │
+  │  Próximo passo:                                              │
+  │  Abra o projeto no Claude Code e o JARVIS                   │
+  │  irá se apresentar automaticamente.                          │
+  │                                                              │
+  │  Comandos iniciais:                                          │
+  │    /conclave "sua pergunta"  — Deliberação estratégica      │
+  │    /ingest [URL/arquivo]     — Alimentar o sistema          │
+  │    /ask [expert]             — Consultar clone mental       │
+  │                                                              │
+  └──────────────────────────────────────────────────────────────┘
+`);
+}
+
+/**
+ * Post-install message for Community users
+ */
+function showPostInstallCommunity() {
+  console.log(`
+  ┌──────────────────────────────────────────────────────────────┐
+  │                                                              │
+  │  Mega Brain COMMUNITY instalado com sucesso!                 │
+  │                                                              │
+  │  Você tem a estrutura. Agora precisa do cérebro.            │
+  │                                                              │
+  │  Para ativar o PREMIUM a qualquer momento:                   │
+  │    mega-brain upgrade                                        │
+  │                                                              │
+  │  Ou comece do zero alimentando o sistema:                    │
+  │    /ingest [URL do YouTube]  — Importar conteúdo            │
+  │    /process-jarvis           — Processar pipeline            │
+  │                                                              │
+  │  moneyclub.thiagofinch.com — Acesse o PREMIUM completo      │
+  │                                                              │
+  └──────────────────────────────────────────────────────────────┘
+`);
+}
+
+function copyTemplateFiles(source, target, excludeDirs) {
+  try {
+    cpSync(source, target, {
+      recursive: true,
+      filter: (src) => {
+        for (const exclude of excludeDirs) {
+          if (src.includes(`${exclude}\\`) || src.includes(`${exclude}/`) || src.endsWith(exclude)) {
+            return false;
+          }
+        }
+        return true;
+      },
+    });
+  } catch (err) {
+    throw new Error(`Erro ao copiar arquivos: ${err.message}. Certifique-se de usar Node.js 18+.`);
+  }
+}
+
+function ensureDirectories(root) {
+  const dirs = [
+    'inbox',
+    'processing/chunks',
+    'processing/canonical',
+    'processing/insights',
+    'processing/narratives',
+    'knowledge/dossiers/persons',
+    'knowledge/dossiers/themes',
+    'knowledge/dossiers/system',
+    'knowledge/sources',
+    'knowledge/playbooks',
+    'knowledge/dna',
+    'logs',
+    'logs/sessions',
+    'logs/batches',
+    'logs/decisions',
+    'agents/persons',
+    'agents/cargo',
+    'agents/sua-empresa/org',
+    'agents/sua-empresa/roles',
+    'agents/sua-empresa/jds',
+    'agents/sua-empresa/operations',
+    'agents/sua-empresa/metrics',
+    'agents/sua-empresa/memory',
+    'agents/sua-empresa/sow',
+  ];
+
+  for (const dir of dirs) {
+    const fullPath = join(root, dir);
+    if (!existsSync(fullPath)) {
+      mkdirSync(fullPath, { recursive: true });
+    }
+    const gitkeep = join(fullPath, '.gitkeep');
+    if (!existsSync(gitkeep)) {
+      writeFileSync(gitkeep, '');
+    }
+  }
+}

package/bin/lib/setup-wizard.js

@@ -0,0 +1,95 @@
+/**
+ * Mega Brain - Setup Wizard
+ * First-time configuration guide for Claude Code /setup command
+ * This module is referenced by the /setup slash command but executes within Claude Code context
+ */
+
+export const SETUP_STEPS = {
+  1: {
+    name: 'Verificar Python',
+    command: 'python --version || python3 --version',
+    required: true,
+    minVersion: '3.10',
+    instructions: 'Python 3.10+ necessário. Instale em https://python.org',
+  },
+  2: {
+    name: 'Verificar Node.js',
+    command: 'node --version',
+    required: true,
+    minVersion: '18',
+    instructions: 'Node.js 18+ necessário. Instale em https://nodejs.org',
+  },
+  3: {
+    name: 'Instalar Dependências Python',
+    command: 'pip install -r requirements.txt',
+    required: false,
+    fallback: 'pip install --user -r requirements.txt',
+  },
+  4: {
+    name: 'Configurar API Keys',
+    keys: [
+      {
+        name: 'OPENAI_API_KEY',
+        required: true,
+        description: 'A API da OpenAI fornece o Whisper para transcrição de vídeos do YouTube e áudios. Essencial para o /ingest funcionar com vídeos.',
+        url: 'https://platform.openai.com/api-keys',
+        prefix: 'sk-',
+      },
+      {
+        name: 'VOYAGE_API_KEY',
+        required: false,
+        description: 'Voyage AI fornece busca semântica avançada no knowledge base. Permite que o Conclave e agentes encontrem evidências nos materiais inseridos.',
+        url: 'https://dash.voyageai.com/api-keys',
+      },
+      {
+        name: 'ANTHROPIC_API_KEY',
+        required: false,
+        description: 'Não necessária se você usa Claude Code via assinatura Max ou Pro (acesso ao Claude já incluído). Apenas para scripts autônomos fora do Claude Code.',
+        url: 'https://console.anthropic.com/settings/keys',
+        prefix: 'sk-ant-',
+      },
+      {
+        name: 'GOOGLE_CLIENT_ID',
+        required: false,
+        description: 'Para importar conteúdos diretamente do Google Drive (PDFs, documentos, planilhas).',
+        url: 'https://console.cloud.google.com/apis/credentials',
+        companion: 'GOOGLE_CLIENT_SECRET',
+      },
+    ],
+  },
+  5: {
+    name: 'Validar Configuração',
+    description: 'Testa conexões com os serviços configurados.',
+  },
+  6: {
+    name: 'Gerar .env',
+    description: 'Salva configuração final no arquivo .env',
+  },
+};
+
+export const ENV_TEMPLATE = `# Mega Brain - Configuration
+# Generated by /setup wizard
+
+# === REQUIRED ===
+# OpenAI API (Whisper) - Transcrição de vídeos e áudios
+# Essencial para /ingest com vídeos do YouTube
+# Obtenha em: https://platform.openai.com/api-keys
+OPENAI_API_KEY=
+
+# === RECOMMENDED ===
+# Voyage AI - Busca semântica avançada no knowledge base
+# Permite que Conclave e agentes encontrem evidências nos materiais
+# Obtenha em: https://dash.voyageai.com/api-keys
+VOYAGE_API_KEY=
+
+# === OPTIONAL ===
+# Anthropic API (Claude) - Não necessária com Claude Code Max/Pro
+# Apenas para scripts autônomos fora do Claude Code
+# Obtenha em: https://console.anthropic.com/settings/keys
+ANTHROPIC_API_KEY=
+
+# Google Drive Import - Importar conteúdos do Google Drive
+# Configure em: https://console.cloud.google.com/apis/credentials
+GOOGLE_CLIENT_ID=
+GOOGLE_CLIENT_SECRET=
+`;

package/bin/lib/validate-email.js

@@ -0,0 +1,109 @@
+/**
+ * Mega Brain - Email Validation Module
+ * Validates MoneyClub buyer emails via Supabase RPC
+ *
+ * Uses native fetch (Node.js 18+) instead of Supabase client
+ * to avoid assertion errors from dangling WebSocket handles.
+ *
+ * On successful validation, returns a premium_token for
+ * accessing the premium content repository.
+ */
+
+// Supabase config - anon key is public by design (RLS + RPC protected)
+const SUPABASE_URL = 'https://lgbzktgbhowxiwppycbi.supabase.co';
+const SUPABASE_ANON_KEY = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImxnYnprdGdiaG93eGl3cHB5Y2JpIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzE0NjgxMTUsImV4cCI6MjA4NzA0NDExNX0.fyidwl35q6rmj_AqaoW2rN_a1xCaDX2_LuKgwO2nTU4';
+
+const TIMEOUT_MS = 10000;
+const MAX_ATTEMPTS = 3;
+
+let attemptCount = 0;
+
+/**
+ * Validate a buyer email against MoneyClub database
+ * @param {string} email - Email to validate
+ * @returns {Promise<{valid: boolean, name?: string, reason?: string, installCount?: number, premium_token?: string}>}
+ */
+export async function validateEmail(email) {
+  if (attemptCount >= MAX_ATTEMPTS) {
+    return {
+      valid: false,
+      reason: 'max_attempts_exceeded',
+    };
+  }
+
+  attemptCount++;
+
+  if (!email || !email.includes('@')) {
+    return {
+      valid: false,
+      reason: 'invalid_email_format',
+    };
+  }
+
+  try {
+    const response = await fetch(
+      `${SUPABASE_URL}/rest/v1/rpc/validate_buyer_email`,
+      {
+        method: 'POST',
+        headers: {
+          'apikey': SUPABASE_ANON_KEY,
+          'Authorization': `Bearer ${SUPABASE_ANON_KEY}`,
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ buyer_email: email.trim().toLowerCase() }),
+        signal: AbortSignal.timeout(TIMEOUT_MS),
+      }
+    );
+
+    if (!response.ok) {
+      return {
+        valid: false,
+        reason: 'validation_error',
+      };
+    }
+
+    const data = await response.json();
+
+    return {
+      valid: data.valid,
+      name: data.name || null,
+      reason: data.reason || null,
+      installCount: data.install_count || 0,
+      premium_token: data.premium_token || null,
+    };
+  } catch (err) {
+    if (err.name === 'TimeoutError' || err.name === 'AbortError') {
+      return {
+        valid: false,
+        reason: 'timeout',
+      };
+    }
+
+    return {
+      valid: false,
+      reason: 'network_error',
+    };
+  }
+}
+
+/**
+ * Get user-friendly error messages in Portuguese
+ * @param {string} reason - Error reason code
+ * @returns {string} Human-readable message
+ */
+export function getErrorMessage(reason) {
+  const messages = {
+    email_not_found: 'Este email não está cadastrado no MoneyClub.\nAcesse moneyclub.thiagofinch.com para adquirir o produto.',
+    invalid_email_format: 'Formato de email inválido. Verifique e tente novamente.',
+    max_attempts_exceeded: 'Número máximo de tentativas excedido. Reinicie o instalador.',
+    timeout: 'Tempo de conexão esgotado. Verifique sua internet e tente novamente.',
+    network_error: 'Erro de conexão. Verifique sua internet e tente novamente.',
+    validation_error: 'Erro na validação. Tente novamente em alguns minutos.',
+  };
+
+  return messages[reason] || 'Erro desconhecido. Tente novamente.';
+}
+
+export function resetAttempts() {
+  attemptCount = 0;
+}