@girardmedia/bootspring 2.1.2 → 2.2.0

package/cli/init.js

@@ -1,669 +0,0 @@
-/**
- * Bootspring Init Command
- * Initialize Bootspring in a new or existing project
- *
- * Now with questionnaire-driven setup for a magical experience!
- *
- * @package bootspring
- * @command init
- */
-
-const path = require('path');
-const fs = require('fs');
-const readline = require('readline');
-const { execSync } = require('child_process');
-const config = require('../core/config');
-const utils = require('../core/utils');
-const contextLoader = require('../core/context-loader');
-const { getManagedMcpServerConfig, ensureProjectMcpConfig } = require('../core/mcp-config');
-const { runQuestionnaire } = require('../generators/questionnaire');
-const claudeTemplate = require('../generators/templates/claude.template');
-const seedTemplate = require('../generators/templates/seed.template');
-const planningTemplate = require('../generators/templates/planning.template');
-const api = require('../core/api-client');
-const { requireProjectSelection } = require('./auth');
-// Presets available via runQuestionnaire('preset-name')
-
-// Available options (for legacy quick mode)
-const FRAMEWORKS = ['nextjs', 'remix', 'nuxt', 'sveltekit', 'express', 'fastify', 'other'];
-const LANGUAGES = ['typescript', 'javascript'];
-const DATABASES = ['postgresql', 'mysql', 'mongodb', 'sqlite', 'none'];
-const HOSTINGS = ['vercel', 'netlify', 'railway', 'fly', 'aws', 'self-hosted'];
-
-/**
- * Create readline interface for interactive prompts
- */
-function createPrompt() {
-  return readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-}
-
-/**
- * Ask a question and return the answer
- */
-function ask(rl, question, defaultValue = '') {
-  const prompt = defaultValue ? `${question} [${defaultValue}]: ` : `${question}: `;
-  return new Promise((resolve) => {
-    rl.question(prompt, (answer) => {
-      resolve(answer.trim() || defaultValue);
-    });
-  });
-}
-
-/**
- * Ask a multiple choice question
- */
-function askChoice(rl, question, options, defaultIndex = 0) {
-  return new Promise((resolve) => {
-    console.log(`\n${question}`);
-    options.forEach((opt, i) => {
-      const marker = i === defaultIndex ? `${utils.COLORS.cyan}→${utils.COLORS.reset}` : ' ';
-      console.log(`  ${marker} ${i + 1}. ${opt}`);
-    });
-    rl.question(`\nSelect [1-${options.length}] (default: ${defaultIndex + 1}): `, (answer) => {
-      const index = parseInt(answer, 10) - 1;
-      if (index >= 0 && index < options.length) {
-        resolve(options[index]);
-      } else {
-        resolve(options[defaultIndex]);
-      }
-    });
-  });
-}
-
-/**
- * Ask yes/no question
- */
-function askYesNo(rl, question, defaultYes = true) {
-  const hint = defaultYes ? '[Y/n]' : '[y/N]';
-  return new Promise((resolve) => {
-    rl.question(`${question} ${hint}: `, (answer) => {
-      const a = answer.trim().toLowerCase();
-      if (a === '') {
-        resolve(defaultYes);
-      } else {
-        resolve(a === 'y' || a === 'yes');
-      }
-    });
-  });
-}
-
-/**
- * Check if bootspring is installed globally
- */
-function isGloballyInstalled() {
-  try {
-    execSync('npm list -g @girardmedia/bootspring', { stdio: 'pipe', encoding: 'utf-8' });
-    return true;
-  } catch {
-    // Also check for 'bootspring' without scope
-    try {
-      execSync('npm list -g bootspring', { stdio: 'pipe', encoding: 'utf-8' });
-      return true;
-    } catch {
-      return false;
-    }
-  }
-}
-
-/**
- * Get global Claude Code settings path
- */
-function getGlobalMcpPath() {
-  const home = process.env.HOME || process.env.USERPROFILE;
-  const platform = process.platform;
-
-  if (platform === 'darwin') {
-    return path.join(home, '.config', 'claude-code', 'settings.json');
-  } else if (platform === 'win32') {
-    return path.join(home, 'AppData', 'Roaming', 'claude-code', 'settings.json');
-  } else {
-    return path.join(home, '.config', 'claude-code', 'settings.json');
-  }
-}
-
-/**
- * Check if MCP is configured globally
- */
-function isGlobalMcpConfigured() {
-  const globalPath = getGlobalMcpPath();
-  if (!utils.fileExists(globalPath)) {
-    return false;
-  }
-
-  try {
-    const content = fs.readFileSync(globalPath, 'utf-8');
-    const settings = JSON.parse(content);
-    return settings?.mcpServers?.bootspring !== undefined;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Detect project info from existing files
- */
-function detectProject(projectRoot) {
-  const detected = {
-    name: path.basename(projectRoot),
-    framework: 'nextjs',
-    language: 'typescript',
-    database: 'postgresql',
-    hosting: 'vercel'
-  };
-
-  // Check package.json
-  const pkg = utils.getPackageJson(projectRoot);
-  if (pkg) {
-    detected.name = pkg.name || detected.name;
-
-    // Detect framework
-    if (pkg.dependencies?.next || pkg.devDependencies?.next) {
-      detected.framework = 'nextjs';
-    } else if (pkg.dependencies?.remix || pkg.devDependencies?.remix) {
-      detected.framework = 'remix';
-    } else if (pkg.dependencies?.nuxt || pkg.devDependencies?.nuxt) {
-      detected.framework = 'nuxt';
-    } else if (pkg.dependencies?.['@sveltejs/kit']) {
-      detected.framework = 'sveltekit';
-    } else if (pkg.dependencies?.express) {
-      detected.framework = 'express';
-    } else if (pkg.dependencies?.fastify) {
-      detected.framework = 'fastify';
-    }
-
-    // Detect database
-    if (pkg.dependencies?.['@prisma/client']) {
-      detected.database = 'postgresql';
-    } else if (pkg.dependencies?.mongoose) {
-      detected.database = 'mongodb';
-    } else if (pkg.dependencies?.mysql2) {
-      detected.database = 'mysql';
-    }
-  }
-
-  // Detect TypeScript
-  if (utils.fileExists(path.join(projectRoot, 'tsconfig.json'))) {
-    detected.language = 'typescript';
-  } else {
-    detected.language = 'javascript';
-  }
-
-  // Detect Vercel
-  if (utils.fileExists(path.join(projectRoot, 'vercel.json'))) {
-    detected.hosting = 'vercel';
-  } else if (utils.fileExists(path.join(projectRoot, 'netlify.toml'))) {
-    detected.hosting = 'netlify';
-  } else if (utils.fileExists(path.join(projectRoot, 'fly.toml'))) {
-    detected.hosting = 'fly';
-  }
-
-  return detected;
-}
-
-/**
- * Generate CLAUDE.md content
- */
-function generateClaudeMd(projectConfig) {
-  const date = utils.formatDate();
-
-  return `# ${projectConfig.project.name} - AI Context
-
-**Generated by**: Bootspring v1.0.0
-**Last Updated**: ${date}
-**Documentation**: https://bootspring.com/docs
-
----
-
-## Project Overview
-
-${projectConfig.project.description || 'A project scaffolded with Bootspring.'}
-
----
-
-## Tech Stack
-
-- **Framework**: ${projectConfig.stack.framework}
-- **Language**: ${projectConfig.stack.language}
-- **Database**: ${projectConfig.stack.database}
-- **Hosting**: ${projectConfig.stack.hosting}
-
----
-
-## Bootspring Commands
-
-Use these commands with your AI assistant:
-
-| Command | Description |
-|---------|-------------|
-| \`bootspring todo add "task"\` | Add a new todo item |
-| \`bootspring todo list\` | List all todos |
-| \`bootspring todo done <id>\` | Mark todo as complete |
-| \`bootspring agent list\` | List available agents |
-| \`bootspring agent invoke <name>\` | Get specialized help |
-| \`bootspring skill search <query>\` | Find code patterns |
-| \`bootspring dashboard\` | Start real-time dashboard |
-| \`bootspring quality pre-commit\` | Run quality checks |
-
----
-
-## Enabled Plugins
-
-${Object.entries(projectConfig.plugins)
-    .filter(([_key, p]) => p.enabled !== false)
-    .map(([name, plugin]) => `### ${name.charAt(0).toUpperCase() + name.slice(1)}
-- Provider: ${plugin.provider || 'default'}
-- Features: ${(plugin.features || []).join(', ') || 'default'}`)
-    .join('\n\n')}
-
----
-
-## Development Workflow
-
-1. **Start dashboard**: \`bootspring dashboard\` for real-time visibility
-2. **Track work**: Use \`bootspring todo\` to manage tasks
-3. **Get help**: Invoke agents for specialized expertise
-4. **Quality**: Run \`bootspring quality pre-commit\` before committing
-
----
-
-## Custom Instructions
-
-- Use Server Components by default (Next.js)
-- Prefer Server Actions over API routes for mutations
-- Use Zod for all input validation
-- Follow existing file naming conventions
-- Keep components small and focused
-- Write tests for new features
-- Never expose API keys to client-side code
-
----
-
-*Generated by [Bootspring](https://bootspring.com) - Development scaffolding with intelligence*
-`;
-}
-
-/**
- * Generate todo.md content
- */
-function generateTodoMd(projectName) {
-  const date = utils.formatDate();
-
-  return `# ${projectName} - Todo List
-
-> Last updated: ${date}
-
-## In Progress
-
-- [ ] Complete project setup
-
-## Pending
-
-- [ ] Configure environment variables
-- [ ] Set up database schema
-- [ ] Implement core features
-
-## Completed
-
-`;
-}
-
-/**
- * Run init command
- */
-async function run(args) {
-  const parsedArgs = utils.parseArgs(args);
-  const force = parsedArgs.force || parsedArgs.f;
-  const quick = parsedArgs.quick || parsedArgs.q;
-  const listPresetsFlag = parsedArgs['list-presets'] || parsedArgs.presets;
-  const presetArg = parsedArgs.preset || (quick ? 'minimal' : null);
-  const projectRoot = config.findProjectRoot();
-
-  // Handle --list-presets flag (no auth required for help)
-  if (listPresetsFlag) {
-    console.log(`
-${utils.COLORS.cyan}${utils.COLORS.bold}Available Config Presets${utils.COLORS.reset}
-
-${config.listPresets({ verbose: true }).map(p =>
-    `  ${utils.COLORS.bold}${p.key}${utils.COLORS.reset}
-   ${p.description}
-   ${utils.COLORS.dim}Tags: ${p.tags.join(', ')}${p.extends ? ` | Extends: ${p.extends}` : ''}${utils.COLORS.reset}
-`).join('\n')}
-${utils.COLORS.dim}Usage: bootspring init --preset <preset-name>
-       bootspring init --preset saas-starter,ai-app  (combine presets)${utils.COLORS.reset}
-`);
-    return;
-  }
-
-  // Require authentication before proceeding
-  try {
-    api.requireAuth();
-  } catch (error) {
-    utils.print.error(error.message);
-    utils.print.dim('Run: bootspring auth login');
-    return;
-  }
-
-  // Ensure project is selected
-  await requireProjectSelection();
-
-  // Parse and validate preset(s)
-  let configPresets = null;
-  if (presetArg && !['minimal', 'standard', 'full'].includes(presetArg)) {
-    // This is a config preset (saas-starter, api-only, etc.), not a questionnaire preset
-    configPresets = config.parsePresetString(presetArg);
-    const validation = config.validatePresets(configPresets);
-    if (!validation.valid) {
-      utils.print.error('Invalid preset(s):');
-      validation.errors.forEach(err => utils.print.dim(`  - ${err}`));
-      console.log(`\n${utils.COLORS.dim}Run 'bootspring init --list-presets' to see available presets${utils.COLORS.reset}`);
-      return;
-    }
-  }
-
-  // Determine questionnaire preset (for interactive mode)
-  const questionnairePreset = !configPresets && presetArg && ['minimal', 'standard', 'full'].includes(presetArg)
-    ? presetArg
-    : null;
-
-  console.log(`
-${utils.COLORS.cyan}${utils.COLORS.bold}⚡ Bootspring Init${utils.COLORS.reset}
-${utils.COLORS.dim}Development scaffolding with intelligence${utils.COLORS.reset}
-`);
-
-  // Check if already initialized
-  const existingConfig = config.findConfigFile(projectRoot);
-  if (existingConfig && !force) {
-    utils.print.warning(`Project already initialized at ${projectRoot}`);
-    utils.print.dim('Use --force to reinitialize');
-    return;
-  }
-
-  // Detect existing project settings
-  const detected = detectProject(projectRoot);
-  utils.print.info(`Detected project: ${detected.name}`);
-  utils.print.dim(`Root: ${projectRoot}`);
-
-  let projectConfig;
-
-  // Config preset mode (saas-starter, api-only, etc.)
-  if (configPresets && configPresets.length > 0) {
-    const presetDisplay = configPresets.join(' + ');
-    utils.print.info(`Using config preset(s): ${presetDisplay}`);
-
-    try {
-      // Apply presets (combining if multiple)
-      projectConfig = config.applyPreset(configPresets, {
-        project: {
-          name: detected.name,
-          description: '',
-          version: '1.0.0'
-        }
-      });
-      projectConfig._configPreset = configPresets.join(',');
-      projectConfig._preset = 'config'; // Mark as config preset for template generation
-    } catch (error) {
-      utils.print.error(`Failed to apply preset: ${error.message}`);
-      return;
-    }
-  }
-  // Questionnaire preset mode (minimal, standard, full)
-  else if (questionnairePreset) {
-    utils.print.info(`Using ${questionnairePreset} preset questionnaire`);
-
-    try {
-      projectConfig = await runQuestionnaire(questionnairePreset);
-      projectConfig._preset = questionnairePreset;
-    } catch (error) {
-      utils.print.error(`Questionnaire failed: ${error.message}`);
-      return;
-    }
-  }
-  // Quick mode - use detected values (legacy behavior)
-  else if (quick) {
-    utils.print.info('Using detected settings (quick mode)');
-    projectConfig = {
-      project: {
-        name: detected.name,
-        description: '',
-        version: '1.0.0'
-      },
-      stack: {
-        framework: detected.framework,
-        language: detected.language,
-        database: detected.database,
-        hosting: detected.hosting
-      },
-      plugins: {
-        auth: { enabled: false, provider: 'clerk' },
-        payments: { enabled: false, provider: 'stripe' },
-        database: { enabled: detected.database !== 'none', provider: 'prisma' },
-        testing: { enabled: true, provider: 'vitest' },
-        security: { enabled: true },
-        ai: { enabled: false, provider: 'anthropic' }
-      },
-      dashboard: { port: 3456, autoOpen: false },
-      quality: { preCommit: true, prePush: false, strictMode: false },
-      paths: { context: 'CLAUDE.md', config: 'bootspring.config.js', todo: 'todo.md' }
-    };
-  }
-  // Default: Interactive questionnaire mode
-  else {
-    try {
-      projectConfig = await runQuestionnaire('standard');
-      projectConfig._preset = 'standard';
-    } catch (_error) {
-      // Fall back to legacy interactive mode
-      utils.print.warning('Falling back to basic interactive mode');
-
-      const rl = createPrompt();
-
-      console.log(`\n${utils.COLORS.bold}Project Configuration${utils.COLORS.reset}`);
-
-      const name = await ask(rl, 'Project name', detected.name);
-      const description = await ask(rl, 'Description', '');
-      const framework = await askChoice(rl, 'Framework:', FRAMEWORKS, FRAMEWORKS.indexOf(detected.framework));
-      const language = await askChoice(rl, 'Language:', LANGUAGES, LANGUAGES.indexOf(detected.language));
-      const database = await askChoice(rl, 'Database:', DATABASES, DATABASES.indexOf(detected.database));
-      const hosting = await askChoice(rl, 'Hosting:', HOSTINGS, HOSTINGS.indexOf(detected.hosting));
-
-      console.log(`\n${utils.COLORS.bold}Plugins${utils.COLORS.reset}`);
-
-      const enableAuth = await askYesNo(rl, 'Enable auth plugin?', false);
-      const enablePayments = await askYesNo(rl, 'Enable payments plugin?', false);
-      const enableTesting = await askYesNo(rl, 'Enable testing plugin?', true);
-      const enableAI = await askYesNo(rl, 'Enable AI plugin?', false);
-
-      rl.close();
-
-      projectConfig = {
-        project: { name, description, version: '1.0.0' },
-        stack: { framework, language, database, hosting },
-        plugins: {
-          auth: { enabled: enableAuth, provider: 'clerk' },
-          payments: { enabled: enablePayments, provider: 'stripe' },
-          database: { enabled: database !== 'none', provider: 'prisma' },
-          testing: { enabled: enableTesting, provider: 'vitest' },
-          security: { enabled: true },
-          ai: { enabled: enableAI, provider: 'anthropic' }
-        },
-        dashboard: { port: 3456, autoOpen: false },
-        quality: { preCommit: true, prePush: false, strictMode: false },
-        paths: { context: 'CLAUDE.md', config: 'bootspring.config.js', todo: 'todo.md' }
-      };
-    }
-  }
-
-  // Create files
-  console.log(`\n${utils.COLORS.bold}Creating files...${utils.COLORS.reset}\n`);
-
-  // 1. bootspring.config.js
-  const configPath = path.join(projectRoot, 'bootspring.config.js');
-  const configSpinner = utils.createSpinner('Creating bootspring.config.js').start();
-  if (config.save(projectConfig, configPath)) {
-    configSpinner.succeed('Created bootspring.config.js');
-  } else {
-    configSpinner.fail('Failed to create bootspring.config.js');
-  }
-
-  // 2. CLAUDE.md (use template if from questionnaire)
-  const claudePath = path.join(projectRoot, 'CLAUDE.md');
-  const claudeSpinner = utils.createSpinner('Creating CLAUDE.md').start();
-  const claudeContent = projectConfig._preset
-    ? claudeTemplate.generate(projectConfig)
-    : generateClaudeMd(projectConfig);
-  if (utils.writeFile(claudePath, claudeContent)) {
-    claudeSpinner.succeed('Created CLAUDE.md');
-  } else {
-    claudeSpinner.fail('Failed to create CLAUDE.md');
-  }
-
-  // 2b. SEED.md (for questionnaire mode)
-  if (projectConfig._preset) {
-    const seedPath = path.join(projectRoot, 'SEED.md');
-    const seedSpinner = utils.createSpinner('Creating SEED.md').start();
-    if (utils.writeFile(seedPath, seedTemplate.generate(projectConfig))) {
-      seedSpinner.succeed('Created SEED.md');
-    } else {
-      seedSpinner.fail('Failed to create SEED.md');
-    }
-  }
-
-  // 3. todo.md (if not exists)
-  const todoPath = path.join(projectRoot, 'todo.md');
-  if (!utils.fileExists(todoPath)) {
-    const todoSpinner = utils.createSpinner('Creating todo.md').start();
-    if (utils.writeFile(todoPath, generateTodoMd(projectConfig.project.name))) {
-      todoSpinner.succeed('Created todo.md');
-    } else {
-      todoSpinner.fail('Failed to create todo.md');
-    }
-  }
-
-  // 4. MCP configuration (local or global)
-  const globalMcpPath = getGlobalMcpPath();
-  const isGlobal = isGloballyInstalled();
-  const hasGlobalMcp = isGlobalMcpConfigured();
-
-  // Determine MCP scope
-  let mcpScope = 'local'; // default
-
-  if (isGlobal && !hasGlobalMcp) {
-    // Global install detected but no global MCP config - suggest global
-    utils.print.info('Global bootspring installation detected');
-
-    if (!quick && !presetArg) {
-      const rl = createPrompt();
-      const useGlobal = await askYesNo(rl, 'Configure MCP server globally (for all projects)?', true);
-      rl.close();
-      mcpScope = useGlobal ? 'global' : 'local';
-    }
-  }
-
-  if (mcpScope === 'global') {
-    const globalSpinner = utils.createSpinner('Configuring global MCP server').start();
-    try {
-      // Ensure directory exists
-      const globalDir = path.dirname(globalMcpPath);
-      if (!fs.existsSync(globalDir)) {
-        fs.mkdirSync(globalDir, { recursive: true });
-      }
-
-      // Read or create settings
-      let settings = {};
-      if (utils.fileExists(globalMcpPath)) {
-        settings = JSON.parse(fs.readFileSync(globalMcpPath, 'utf-8'));
-      }
-
-      // Add bootspring MCP server
-      if (!settings.mcpServers) {
-        settings.mcpServers = {};
-      }
-      settings.mcpServers.bootspring = getManagedMcpServerConfig();
-
-      if (utils.writeFile(globalMcpPath, JSON.stringify(settings, null, 2))) {
-        globalSpinner.succeed(`Configured global MCP at ${globalMcpPath}`);
-      } else {
-        globalSpinner.fail('Failed to configure global MCP');
-      }
-    } catch (error) {
-      globalSpinner.fail(`Global MCP config failed: ${error.message}`);
-    }
-  } else {
-    const mcpSpinner = utils.createSpinner('Creating .mcp.json').start();
-    const result = ensureProjectMcpConfig(projectRoot, { createIfMissing: true });
-    if (result.status === 'created') {
-      mcpSpinner.succeed('Created .mcp.json (MCP server config)');
-    } else if (result.status === 'updated' || result.status === 'added') {
-      mcpSpinner.succeed('Updated .mcp.json (MCP server config)');
-    } else if (result.status === 'unchanged') {
-      mcpSpinner.succeed('Verified .mcp.json (MCP server config)');
-    } else {
-      mcpSpinner.fail(`Failed to configure .mcp.json${result.error ? `: ${result.error.message}` : ''}`);
-    }
-  }
-
-  // 5. Create /planning folder with templates
-  const planningDir = path.join(projectRoot, 'planning');
-  if (!fs.existsSync(planningDir)) {
-    const planningSpinner = utils.createSpinner('Creating planning folder').start();
-    try {
-      fs.mkdirSync(planningDir, { recursive: true });
-
-      // Get all planning templates
-      const templates = planningTemplate.getTemplates(projectConfig);
-      let filesCreated = 0;
-
-      for (const [filename, content] of Object.entries(templates)) {
-        const filePath = path.join(planningDir, filename);
-        if (utils.writeFile(filePath, content)) {
-          filesCreated++;
-        }
-      }
-
-      planningSpinner.succeed(`Created planning folder (${filesCreated} templates)`);
-    } catch (error) {
-      planningSpinner.fail(`Failed to create planning folder: ${error.message}`);
-    }
-  }
-
-  // 6. Build context index
-  const indexSpinner = utils.createSpinner('Building context index').start();
-  try {
-    const cfg = config.load();
-    contextLoader.buildIndex({ config: cfg });
-    indexSpinner.succeed('Built context index');
-  } catch (error) {
-    indexSpinner.warn(`Context index: ${error.message}`);
-  }
-
-  // Success message
-  console.log(`
-${utils.COLORS.green}${utils.COLORS.bold}✓ Bootspring initialized successfully!${utils.COLORS.reset}
-
-${utils.COLORS.bold}Created:${utils.COLORS.reset}
-  • bootspring.config.js  - Project configuration
-  • CLAUDE.md             - AI context file
-  • SEED.md               - Project seed data
-  • planning/             - Planning documents
-  • ${mcpScope === 'global' ? 'Global MCP config' : '.mcp.json'} - MCP server config
-
-${utils.COLORS.bold}Next steps:${utils.COLORS.reset}
-
-  1. Review ${utils.COLORS.cyan}planning/MASTER_PLAN.md${utils.COLORS.reset} and define your vision
-  2. Fill out ${utils.COLORS.cyan}planning/PRD.md${utils.COLORS.reset} with requirements
-  3. Start the dashboard: ${utils.COLORS.cyan}bootspring dashboard${utils.COLORS.reset}
-  4. Add your first todo: ${utils.COLORS.cyan}bootspring todo add "Your first task"${utils.COLORS.reset}
-
-${utils.COLORS.bold}Context commands:${utils.COLORS.reset}
-  bootspring context list              ${utils.COLORS.dim}# See all context files${utils.COLORS.reset}
-  bootspring context read plan         ${utils.COLORS.dim}# View master plan${utils.COLORS.reset}
-  bootspring context search "feature"  ${utils.COLORS.dim}# Search across docs${utils.COLORS.reset}
-
-${utils.COLORS.dim}Documentation: https://bootspring.com/docs${utils.COLORS.reset}
-`);
-}
-
-module.exports = { run };