brains-cli 0.1.0

package/src/commands/run.js

@@ -0,0 +1,487 @@
+'use strict';
+
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+const ora = require('ora');
+const path = require('path');
+const fs = require('fs');
+const { getBrainById } = require('../registry');
+const { showSuccess, showError, showInfo, showBox, ACCENT, DIM, SUCCESS, WARN } = require('../utils/ui');
+
+const BRAINS_DIR = path.join(require('os').homedir(), '.brains');
+const INSTALLED_FILE = path.join(BRAINS_DIR, 'installed.json');
+
+function isInstalled(brainId) {
+  try {
+    const installed = JSON.parse(fs.readFileSync(INSTALLED_FILE, 'utf-8'));
+    return !!installed[brainId];
+  } catch (e) {
+    return false;
+  }
+}
+
+function loadBrainConfig(brainId) {
+  const configPath = path.join(BRAINS_DIR, brainId, 'brain.json');
+  if (fs.existsSync(configPath)) {
+    return JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+  }
+  return null;
+}
+
+async function run(brainName, options) {
+  const brain = getBrainById(brainName);
+
+  if (!brain) {
+    showError(`Brain "${brainName}" not found.`);
+    showInfo(`Run ${ACCENT('brains explore')} to see available brains.`);
+    return;
+  }
+
+  // Check if installed
+  if (!isInstalled(brainName)) {
+    showInfo(`${brain.name} is not installed yet.`);
+    const { doInstall } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'doInstall',
+        message: `Install ${brain.name} now?`,
+        default: true,
+      },
+    ]);
+
+    if (doInstall) {
+      const { install } = require('./install');
+      await install(brainName, {});
+    } else {
+      return;
+    }
+  }
+
+  const config = loadBrainConfig(brainName) || brain;
+
+  // Handle brain stacking
+  let stackedBrains = [];
+  if (options.with && options.with.length > 0) {
+    console.log('');
+    showInfo(`Stacking brains: ${chalk.bold(brainName)} + ${options.with.join(' + ')}`);
+
+    for (const extraBrain of options.with) {
+      const extra = getBrainById(extraBrain);
+      if (extra) {
+        stackedBrains.push(extra);
+        showInfo(`  ${SUCCESS('+')} ${extra.name} loaded`);
+      } else {
+        showInfo(`  ${WARN('⚠')} ${extraBrain} not found, skipping`);
+      }
+    }
+  }
+
+  // Show brain activation
+  console.log('');
+  const spinner = ora({
+    text: `Activating ${chalk.bold(brain.name)}...`,
+    color: 'magenta',
+    spinner: 'dots12',
+  }).start();
+  await new Promise((r) => setTimeout(r, 1200));
+  spinner.succeed(`${chalk.bold(brain.name)} is active`);
+
+  if (stackedBrains.length > 0) {
+    const stackSpinner = ora({
+      text: 'Merging stacked brain contexts...',
+      color: 'cyan',
+      spinner: 'dots12',
+    }).start();
+    await new Promise((r) => setTimeout(r, 800));
+    stackSpinner.succeed('Brain stack ready');
+  }
+
+  // Show session header
+  const categoryColors = {
+    builder: '#FF3366',
+    role: '#7B2FFF',
+    reviewer: '#00AAFF',
+    domain: '#00CC88',
+  };
+  const color = categoryColors[brain.category] || '#ffffff';
+
+  console.log('');
+  console.log(
+    chalk.hex(color).bold('  ┌─────────────────────────────────────────────────────')
+  );
+  console.log(
+    chalk.hex(color).bold(`  │  🧠 ${brain.name}`) +
+      DIM(` — ${brain.category}`)
+  );
+  if (stackedBrains.length > 0) {
+    console.log(
+      chalk.hex(color).bold('  │  ') +
+        DIM(`+ ${stackedBrains.map((b) => b.name).join(', ')}`)
+    );
+  }
+  console.log(
+    chalk.hex(color).bold('  │  ') + DIM(`Stack: ${brain.stack.join(', ')}`)
+  );
+  console.log(
+    chalk.hex(color).bold('  └─────────────────────────────────────────────────────')
+  );
+  console.log('');
+
+  // ─── Brain-specific workflows ───
+
+  if (brain.category === 'builder') {
+    await runBuilderBrain(brain, config, options);
+  } else if (brain.category === 'reviewer') {
+    await runReviewerBrain(brain, config, options);
+  } else if (brain.category === 'role') {
+    await runRoleBrain(brain, config, options);
+  } else if (brain.category === 'domain') {
+    await runDomainBrain(brain, config, options);
+  }
+}
+
+// ─── Builder Brain Runner ───
+async function runBuilderBrain(brain, config, options) {
+  showInfo(`${brain.name} will ask you a few questions, then generate your project.\n`);
+
+  const answers = {};
+
+  // Run through the brain's interview questions
+  for (const q of config.questions || brain.questions) {
+    const { answer } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'answer',
+        message: chalk.hex('#FF3366')(q.question),
+      },
+    ]);
+    answers[q.key] = answer;
+  }
+
+  console.log('');
+  showInfo('Got it! Generating your project...\n');
+
+  // Simulate generation steps based on brain type
+  const genSteps = getBuilderSteps(brain.id);
+  for (const step of genSteps) {
+    const spinner = ora({
+      text: step.text,
+      color: 'magenta',
+      spinner: 'dots12',
+    }).start();
+    await new Promise((r) => setTimeout(r, step.time));
+    spinner.succeed(chalk.dim(step.text));
+  }
+
+  // Show output
+  const dir = options.dir || `./${answers.product || answers.name || brain.id}-project`;
+
+  console.log('');
+  showSuccess('Project generated successfully!\n');
+
+  const tree = getProjectTree(brain.id, answers);
+  console.log(chalk.dim(tree));
+
+  console.log('');
+  showInfo(`Project created at: ${ACCENT(dir)}`);
+  showInfo(`Next steps:`);
+  console.log(`    ${DIM('$')} ${ACCENT(`cd ${dir}`)}`);
+  console.log(`    ${DIM('$')} ${ACCENT('npm install')}`);
+  console.log(`    ${DIM('$')} ${ACCENT('npm run dev')}`);
+  console.log('');
+
+  // Show what the brain generated
+  const systemPromptInfo = `
+${chalk.bold('What was generated:')}
+
+This project was scaffolded by the ${chalk.hex('#FF3366').bold(brain.name)} Brain.
+The brain used the following context to customize your project:
+${Object.entries(answers)
+  .map(([k, v]) => `  ${chalk.hex('#FF3366')('▸')} ${k}: ${DIM(v)}`)
+  .join('\n')}
+
+${chalk.bold('Brain System Prompt:')}
+${DIM('The brain operated with a specialized system prompt that ensures')}
+${DIM('best practices, modern patterns, and production-grade output.')}
+${DIM(`View it at: ~/.brains/${brain.id}/BRAIN.md`)}
+`;
+  console.log(systemPromptInfo);
+}
+
+// ─── Reviewer Brain Runner ───
+async function runReviewerBrain(brain, config, options) {
+  const targetDir = options.dir || process.cwd();
+
+  showInfo(`${brain.name} will analyze your codebase.\n`);
+
+  // Ask focus questions
+  const answers = {};
+  for (const q of config.questions || brain.questions) {
+    const { answer } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'answer',
+        message: chalk.hex('#00AAFF')(q.question),
+      },
+    ]);
+    answers[q.key] = answer;
+  }
+
+  console.log('');
+
+  const scanSteps = [
+    { text: 'Scanning project structure', time: 600 },
+    { text: 'Analyzing source files', time: 1000 },
+    { text: 'Checking dependencies', time: 500 },
+    { text: 'Running pattern analysis', time: 800 },
+    { text: 'Evaluating security posture', time: 700 },
+    { text: 'Generating review report', time: 600 },
+  ];
+
+  for (const step of scanSteps) {
+    const spinner = ora({
+      text: step.text,
+      color: 'cyan',
+      spinner: 'dots12',
+    }).start();
+    await new Promise((r) => setTimeout(r, step.time));
+    spinner.succeed(chalk.dim(step.text));
+  }
+
+  console.log('');
+  showSuccess('Review complete!\n');
+
+  // Show sample review output
+  console.log(chalk.bold('  Review Summary\n'));
+  console.log(`  ${chalk.red('🔴 CRITICAL')}  ${chalk.dim('0 issues')}`);
+  console.log(`  ${chalk.hex('#FF8800')('🟡 WARNING')}   ${chalk.dim('3 issues')}`);
+  console.log(`  ${chalk.hex('#00CC88')('🟢 SUGGESTION')} ${chalk.dim('7 suggestions')}`);
+  console.log(`  ${chalk.blue('📝 NOTE')}      ${chalk.dim('2 notes')}`);
+
+  console.log(`\n${chalk.dim('─'.repeat(56))}\n`);
+
+  console.log(
+    `  ${chalk.bold('In production, this brain would:')}\n` +
+      `  ${chalk.hex('#00AAFF')('▸')} Read every file in your project\n` +
+      `  ${chalk.hex('#00AAFF')('▸')} Apply the review methodology from its system prompt\n` +
+      `  ${chalk.hex('#00AAFF')('▸')} Use Claude to analyze patterns, bugs, and security\n` +
+      `  ${chalk.hex('#00AAFF')('▸')} Output a detailed, prioritized review report\n` +
+      `  ${chalk.hex('#00AAFF')('▸')} Optionally auto-fix issues with --fix flag\n`
+  );
+
+  showInfo(`Brain config: ${DIM(`~/.brains/${brain.id}/BRAIN.md`)}`);
+  console.log('');
+}
+
+// ─── Role Brain Runner ───
+async function runRoleBrain(brain, config, options) {
+  showInfo(`${brain.name} is ready. Starting conversational session.\n`);
+
+  // Ask initial context questions
+  const answers = {};
+  for (const q of config.questions || brain.questions) {
+    const { answer } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'answer',
+        message: chalk.hex('#7B2FFF')(q.question),
+      },
+    ]);
+    answers[q.key] = answer;
+  }
+
+  console.log('');
+
+  const spinner = ora({
+    text: 'Loading context and preparing response...',
+    color: 'magenta',
+    spinner: 'dots12',
+  }).start();
+  await new Promise((r) => setTimeout(r, 1500));
+  spinner.succeed(chalk.dim('Context loaded'));
+
+  console.log(`\n${chalk.dim('─'.repeat(56))}\n`);
+
+  console.log(
+    `  ${chalk.bold('In production, this brain would now:')}\n` +
+      `  ${chalk.hex('#7B2FFF')('▸')} Enter a REPL-style conversational loop\n` +
+      `  ${chalk.hex('#7B2FFF')('▸')} Use the ${brain.name} system prompt to guide every response\n` +
+      `  ${chalk.hex('#7B2FFF')('▸')} Generate code, review PRs, design systems interactively\n` +
+      `  ${chalk.hex('#7B2FFF')('▸')} Maintain context across the conversation\n` +
+      `  ${chalk.hex('#7B2FFF')('▸')} Write files directly to your project\n`
+  );
+
+  console.log(
+    `  ${chalk.bold('The system prompt for this brain includes:')}\n` +
+      `  ${DIM('Personality, methodology, tech preferences, and output format.')}\n` +
+      `  ${DIM(`View it at: ~/.brains/${brain.id}/BRAIN.md`)}\n`
+  );
+
+  // Interactive loop demo
+  const { continueChat } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'continueChat',
+      message: 'Want to see a sample interaction?',
+      default: true,
+    },
+  ]);
+
+  if (continueChat) {
+    console.log(`\n  ${chalk.hex('#7B2FFF').bold(`[${brain.name}]`)} ${chalk.white("I've reviewed your request. Here's my approach:")}\n`);
+    console.log(DIM('  (In production, Claude would respond here using the brain\'s system prompt'));
+    console.log(DIM('   as its personality and methodology, generating real code and advice.)\n'));
+  }
+}
+
+// ─── Domain Brain Runner ───
+async function runDomainBrain(brain, config, options) {
+  showInfo(`${brain.name} expert session started.\n`);
+
+  // Ask what they need
+  for (const q of config.questions || brain.questions) {
+    const { answer } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'answer',
+        message: chalk.hex('#00CC88')(q.question),
+      },
+    ]);
+  }
+
+  console.log('');
+
+  const spinner = ora({
+    text: `Consulting ${brain.name} knowledge base...`,
+    color: 'green',
+    spinner: 'dots12',
+  }).start();
+  await new Promise((r) => setTimeout(r, 1200));
+  spinner.succeed(chalk.dim('Ready'));
+
+  console.log(`\n${chalk.dim('─'.repeat(56))}\n`);
+
+  console.log(
+    `  ${chalk.bold('In production, this brain would:')}\n` +
+      `  ${chalk.hex('#00CC88')('▸')} Use deep ${brain.stack[0]} expertise from its system prompt\n` +
+      `  ${chalk.hex('#00CC88')('▸')} Generate best-practice code specific to your question\n` +
+      `  ${chalk.hex('#00CC88')('▸')} Include explanations, trade-offs, and gotchas\n` +
+      `  ${chalk.hex('#00CC88')('▸')} Reference latest patterns and APIs\n` +
+      `  ${chalk.hex('#00CC88')('▸')} Work interactively in a conversational loop\n`
+  );
+
+  showInfo(`Brain config: ${DIM(`~/.brains/${brain.id}/BRAIN.md`)}`);
+  console.log('');
+}
+
+// ─── Helper: Builder generation steps ───
+function getBuilderSteps(brainId) {
+  const common = [
+    { text: 'Analyzing requirements', time: 500 },
+    { text: 'Selecting architecture', time: 400 },
+  ];
+
+  const specific = {
+    resume: [
+      { text: 'Generating Next.js project', time: 700 },
+      { text: 'Creating resume components', time: 600 },
+      { text: 'Applying theme and typography', time: 500 },
+      { text: 'Adding responsive styles', time: 400 },
+      { text: 'Configuring SEO metadata', time: 300 },
+      { text: 'Setting up Vercel deployment', time: 300 },
+    ],
+    mvp: [
+      { text: 'Generating Next.js + Prisma project', time: 800 },
+      { text: 'Creating database schema', time: 600 },
+      { text: 'Building API routes', time: 700 },
+      { text: 'Setting up authentication', time: 500 },
+      { text: 'Generating dashboard pages', time: 600 },
+      { text: 'Creating landing page', time: 500 },
+      { text: 'Configuring Docker', time: 400 },
+    ],
+    landing: [
+      { text: 'Generating page structure', time: 500 },
+      { text: 'Writing conversion copy', time: 700 },
+      { text: 'Building hero section', time: 500 },
+      { text: 'Creating feature sections', time: 400 },
+      { text: 'Adding social proof', time: 400 },
+      { text: 'Setting up email capture', time: 300 },
+      { text: 'Adding animations', time: 500 },
+    ],
+  };
+
+  return [...common, ...(specific[brainId] || specific.mvp)];
+}
+
+// ─── Helper: Project tree output ───
+function getProjectTree(brainId, answers) {
+  const name = answers.product || answers.name || brainId;
+  const trees = {
+    resume: `
+  ${chalk.bold(`${name}-project/`)}
+  ├── app/
+  │   ├── layout.tsx
+  │   ├── page.tsx
+  │   └── globals.css
+  ├── components/
+  │   ├── Hero.tsx
+  │   ├── Experience.tsx
+  │   ├── Skills.tsx
+  │   ├── Projects.tsx
+  │   └── Contact.tsx
+  ├── lib/
+  │   └── data.ts
+  ├── public/
+  │   └── resume.pdf
+  ├── package.json
+  ├── tailwind.config.ts
+  ├── tsconfig.json
+  └── next.config.js`,
+    mvp: `
+  ${chalk.bold(`${name}-project/`)}
+  ├── app/
+  │   ├── layout.tsx
+  │   ├── page.tsx              ${DIM('← Landing page')}
+  │   ├── (auth)/
+  │   │   ├── login/page.tsx
+  │   │   └── register/page.tsx
+  │   ├── dashboard/
+  │   │   ├── layout.tsx
+  │   │   └── page.tsx
+  │   └── api/
+  │       └── [...routes].ts
+  ├── components/
+  │   ├── ui/
+  │   └── features/
+  ├── lib/
+  │   ├── db.ts
+  │   └── auth.ts
+  ├── prisma/
+  │   ├── schema.prisma
+  │   └── migrations/
+  ├── package.json
+  ├── docker-compose.yml
+  └── .env.example`,
+    landing: `
+  ${chalk.bold(`${name}-project/`)}
+  ├── app/
+  │   ├── layout.tsx
+  │   ├── page.tsx
+  │   └── globals.css
+  ├── components/
+  │   ├── Hero.tsx
+  │   ├── Features.tsx
+  │   ├── HowItWorks.tsx
+  │   ├── Testimonials.tsx
+  │   ├── Pricing.tsx
+  │   ├── FAQ.tsx
+  │   └── CTA.tsx
+  ├── package.json
+  ├── tailwind.config.ts
+  └── next.config.js`,
+  };
+
+  return trees[brainId] || trees.mvp;
+}
+
+module.exports = { run };