@girardmedia/bootspring 1.1.0

package/cli/init.js

@@ -0,0 +1,410 @@
+/**
+ * Bootspring Init Command
+ * Initialize Bootspring in a new or existing project
+ *
+ * @package bootspring
+ * @command init
+ */
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+const config = require('../core/config');
+const utils = require('../core/utils');
+
+// Available options
+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');
+      }
+    });
+  });
+}
+
+/**
+ * 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(([_, 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 projectRoot = config.findProjectRoot();
+
+  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;
+
+  if (quick) {
+    // Quick mode - use detected values
+    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' }
+    };
+  } else {
+    // 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
+  const claudePath = path.join(projectRoot, 'CLAUDE.md');
+  const claudeSpinner = utils.createSpinner('Creating CLAUDE.md').start();
+  if (utils.writeFile(claudePath, generateClaudeMd(projectConfig))) {
+    claudeSpinner.succeed('Created CLAUDE.md');
+  } else {
+    claudeSpinner.fail('Failed to create CLAUDE.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.json for Claude Code
+  const mcpPath = path.join(projectRoot, '.mcp.json');
+  if (!utils.fileExists(mcpPath)) {
+    const mcpSpinner = utils.createSpinner('Creating .mcp.json').start();
+    const mcpConfig = {
+      mcpServers: {
+        bootspring: {
+          command: 'npx',
+          args: ['bootspring', 'mcp'],
+          env: {}
+        }
+      }
+    };
+    if (utils.writeFile(mcpPath, JSON.stringify(mcpConfig, null, 2))) {
+      mcpSpinner.succeed('Created .mcp.json (MCP server config)');
+    } else {
+      mcpSpinner.fail('Failed to create .mcp.json');
+    }
+  }
+
+  // Success message
+  console.log(`
+${utils.COLORS.green}${utils.COLORS.bold}✓ Bootspring initialized successfully!${utils.COLORS.reset}
+
+${utils.COLORS.bold}Next steps:${utils.COLORS.reset}
+
+  1. Review ${utils.COLORS.cyan}bootspring.config.js${utils.COLORS.reset} and customize as needed
+  2. Start the dashboard: ${utils.COLORS.cyan}bootspring dashboard${utils.COLORS.reset}
+  3. Add your first todo: ${utils.COLORS.cyan}bootspring todo add "Your first task"${utils.COLORS.reset}
+
+${utils.COLORS.dim}Documentation: https://bootspring.com/docs${utils.COLORS.reset}
+`);
+}
+
+module.exports = { run };