@girardmedia/bootspring 2.1.2 → 2.2.0

package/bin/bootspring.js

@@ -1,15 +1,16 @@
 #!/usr/bin/env node
 
 /**
- * Bootspring CLI
- * Thin client for the hosted Bootspring MCP and API platform.
+ * Bootspring CLI Bridge
+ * Routes commands to either the modern v2 monorepo CLI or legacy v1 handlers.
  */
 
 const path = require('path');
-const selfUpdate = require('../core/self-update');
-const { ensureProjectMcpConfig } = require('../core/mcp-config');
+const fs = require('fs');
 
 const VERSION = require('../package.json').version;
+const MONOREPO_CLI_DIST = path.join(__dirname, '../monorepo/apps/cli/dist/index.js');
+const USE_V2 = process.env.BOOTSPRING_V2 === 'true' || process.argv.includes('--v2');
 
 const C = {
   reset: '\x1b[0m',
@@ -21,119 +22,138 @@ const C = {
   red: '\x1b[31m'
 };
 
-const LOGO = `${C.cyan}${C.bold}⚡ Bootspring${C.reset} ${C.dim}v${VERSION}${C.reset}`;
-
-const COMMANDS = {
-  auth: { handler: '../cli/auth.js', description: 'Login, logout, and account status' },
-  switch: { handler: '../cli/switch.js', description: 'Switch project context' },
-  project: { handler: '../cli/project.js', description: 'Manage cloud projects and members' },
-  init: { handler: '../cli/init.js', description: 'Initialize Bootspring in the current project' },
-  build: { handler: '../cli/build.js', description: 'Run the local build loop and task workflow' },
-  agent: { handler: '../cli/agent.js', description: 'Use hosted specialist agents' },
-  skill: { handler: '../cli/skill.js', description: 'Browse hosted skills and patterns' },
-  orchestrator: { handler: '../cli/orchestrator.js', description: 'Run hosted workflow orchestration' },
-  quality: { handler: '../cli/quality.js', description: 'Fetch hosted quality gates' },
-  billing: { handler: '../cli/billing.js', description: 'View subscription and usage' },
-  update: { handler: '../cli/update.js', description: 'Check for and apply updates' },
-  todo: { handler: '../cli/todo.js', description: 'Manage local todo.md tasks' },
-  dashboard: { handler: '../cli/dashboard.js', description: 'Open the cloud dashboard' },
-  mcp: { handler: '../cli/mcp.js', description: 'Start the hosted MCP proxy' },
-  help: { description: 'Show help' }
-};
+const LOGO = `${C.cyan}${C.bold}⚡ Bootspring${C.reset} ${C.dim}v${VERSION}${C.reset}${USE_V2 ? ` ${C.green}(v2-beta)${C.reset}` : ''}`;
 
-function showHelp(command = null) {
-  if (command && COMMANDS[command]) {
-    console.log(LOGO);
-    console.log(`\n${C.bold}${command}${C.reset}`);
-    console.log(`${C.dim}${COMMANDS[command].description}${C.reset}\n`);
-    return;
-  }
+/**
+ * v2-enabled commands (monorepo implementations)
+ */
+const V2_COMMANDS = [
+  // Core
+  'auth', 'project', 'switch', 'init', 'mcp', 'health',
+  // Content & Agents
+  'agent', 'skill', 'todo', 'billing',
+  // Build & Deploy
+  'build', 'deploy', 'loop', 'quality', 'security', 'doctor',
+  // Planning & PRD
+  'plan', 'prd', 'preseed', 'preseed-start', 'preseed-from-codebase',
+  // Analysis & Monitoring
+  'analyze', 'audit', 'monitor', 'metrics', 'visualize',
+  // Documentation & Content
+  'generate', 'dashboard', 'content', 'docs', 'seed',
+  // Intelligence
+  'learn', 'memory', 'suggest', 'orchestrator', 'validate', 'watch',
+  // Business & Legal
+  'business', 'fundraise', 'legal', 'org',
+  // Infrastructure
+  'workspace', 'cloud-sync', 'github', 'onboard', 'checkpoint',
+  // Misc
+  'log', 'mvp', 'plugin', 'task', 'telemetry', 'update'
+];
 
+/**
+ * Legacy v1 commands (kept for backward compat, prefer v2)
+ */
+const V1_COMMANDS = {};
+function showHelp() {
   console.log(LOGO);
-  console.log(`${C.dim}Thin client powered by Bootspring cloud MCP and API services${C.reset}\n`);
+  console.log(`${C.dim}Development scaffolding with intelligence${C.reset}\n`);
   console.log(`${C.bold}Usage:${C.reset} bootspring <command> [options]\n`);
-  console.log(`${C.bold}Commands:${C.reset}`);
 
-  for (const [name, config] of Object.entries(COMMANDS)) {
-    const padding = ' '.repeat(Math.max(2, 14 - name.length));
-    console.log(`  ${C.cyan}${name}${C.reset}${padding}${C.dim}${config.description}${C.reset}`);
+  const groups = {
+    'Core': ['auth', 'init', 'project', 'switch', 'health', 'mcp', 'dashboard'],
+    'Build & Deploy': ['build', 'deploy', 'loop', 'quality', 'security', 'doctor', 'update'],
+    'Planning': ['plan', 'prd', 'preseed', 'preseed-start', 'preseed-from-codebase', 'seed'],
+    'Agents & Skills': ['agent', 'skill', 'todo', 'billing'],
+    'Analysis': ['analyze', 'audit', 'monitor', 'metrics', 'validate', 'visualize'],
+    'Docs & Content': ['generate', 'content', 'docs'],
+    'Intelligence': ['learn', 'memory', 'suggest', 'orchestrator', 'watch'],
+    'Business': ['business', 'fundraise', 'legal', 'org'],
+    'Infrastructure': ['workspace', 'cloud-sync', 'github', 'onboard', 'checkpoint'],
+    'Tools': ['log', 'mvp', 'plugin', 'task', 'telemetry']
+  };
+
+  for (const [group, cmds] of Object.entries(groups)) {
+    console.log(`${C.bold}${group}:${C.reset}  ${cmds.map(c => `${C.green}${c}${C.reset}`).join(', ')}`);
   }
 
-  console.log(`\n${C.bold}Get Started:${C.reset}`);
-  console.log(`  ${C.dim}$${C.reset} bootspring auth login`);
-  console.log(`  ${C.dim}$${C.reset} bootspring init`);
-  console.log(`  ${C.dim}$${C.reset} bootspring mcp config`);
-
-  console.log(`\n${C.dim}Docs: https://bootspring.com/docs${C.reset}`);
-  console.log(`${C.dim}Pricing: https://bootspring.com/pricing${C.reset}\n`);
+  console.log(`\n${C.dim}Run "bootspring <command> --help" for command details${C.reset}`);
+  console.log(`${C.dim}Docs: https://bootspring.com/docs${C.reset}\n`);
 }
 
-async function runCommand(command, args) {
-  const config = COMMANDS[command];
-  if (!config || !config.handler) {
-    showHelp(command);
+async function runV1(command, args) {
+  const config = V1_COMMANDS[command];
+  if (!config) {
+    showHelp();
     return;
   }
-
   const handler = require(path.resolve(__dirname, config.handler));
   await handler.run(args);
 }
 
+async function runV2(args) {
+  if (!fs.existsSync(MONOREPO_CLI_DIST)) {
+    console.error(`${C.red}Error: v2 CLI build not found at ${MONOREPO_CLI_DIST}${C.reset}`);
+    console.error(`${C.dim}Please run 'cd monorepo && pnpm build' first.${C.reset}`);
+    process.exit(1);
+  }
+
+  // Filter out the --v2 flag if present
+  const cleanArgs = args.filter(arg => arg !== '--v2');
+  
+  // Use dynamic import for ESM v2 CLI
+  const { spawn } = require('child_process');
+  const child = spawn('node', [MONOREPO_CLI_DIST, ...cleanArgs], {
+    stdio: 'inherit',
+    env: { ...process.env, BOOTSPRING_V2_BRIDGE: 'true' }
+  });
+
+  child.on('exit', (code) => {
+    process.exit(code || 0);
+  });
+}
+
 async function main() {
   const args = process.argv.slice(2);
   const command = args[0];
 
-  if (!command) {
+  if (!command || command === '--help' || command === '-h' || command === 'help') {
     showHelp();
     return;
   }
 
   if (command === '--version' || command === '-v') {
-    console.log(`Bootspring v${VERSION}`);
+    console.log(`Bootspring v${VERSION} (Bridge)`);
     return;
   }
 
-  if (command === '--help' || command === '-h' || command === 'help') {
-    showHelp(args[1]);
-    return;
+  // Auto-update check (before any command execution)
+  try {
+    const selfUpdate = require(path.resolve(__dirname, '../core/self-update'));
+    selfUpdate.ensureLatestVersion(args);
+  } catch {
+    // Best-effort; don't block CLI on update failures
   }
 
-  if (!COMMANDS[command]) {
-    console.log(LOGO);
-    console.log(`\n${C.red}Command '${command}' is not available in the public thin client.${C.reset}`);
-    console.log(`${C.dim}Run 'bootspring help' to see supported launch commands.${C.reset}\n`);
-    process.exitCode = 1;
+  // Route to v2 if explicitly requested or if command is migrated
+  if (USE_V2 || V2_COMMANDS.includes(command)) {
+    await runV2(args);
     return;
   }
 
-  const updateResult = selfUpdate.ensureLatestVersion(args);
-  if (updateResult.updated) {
-    process.exitCode = updateResult.exitCode;
+  // Fallback to v1 for unmigrated commands
+  if (V1_COMMANDS[command]) {
+    try {
+      await runV1(command, args.slice(1));
+    } catch (error) {
+      console.error(`\n${C.red}Legacy Error: ${error.message}${C.reset}\n`);
+      process.exit(1);
+    }
     return;
   }
 
-  const mcpConfigResult = ensureProjectMcpConfig(process.cwd(), { createIfMissing: false });
-  if (mcpConfigResult.status === 'updated') {
-    console.error('[bootspring] Updated .mcp.json to use the managed latest-package launcher.');
-  }
-
-  try {
-    await runCommand(command, args.slice(1));
-  } catch (error) {
-    console.log(LOGO);
-    console.log(`\n${C.red}Error: ${error.message}${C.reset}`);
-
-    if (error.code === 'AUTH_REQUIRED' || error.status === 401) {
-      console.log(`${C.dim}Run 'bootspring auth login' to authenticate.${C.reset}`);
-    } else if (error.status === 403) {
-      console.log(`${C.dim}Upgrade access: https://bootspring.com/pricing${C.reset}`);
-    } else if (error.code === 'ENOTFOUND' || error.code === 'ECONNREFUSED') {
-      console.log(`${C.dim}Could not reach the Bootspring API.${C.reset}`);
-    }
-
-    console.log();
-    process.exitCode = 1;
-  }
+  console.log(`${C.red}Unknown command: ${command}${C.reset}`);
+  showHelp();
+  process.exit(1);
 }
 
 main();

package/generators/api-docs.js

@@ -585,15 +585,15 @@ Rate limiting may be applied to certain endpoints.
     sections.push(`## Endpoints
 
 ${Object.entries(endpointsByTag).map(([tag, endpoints]) => {
-  return `### ${tag}
+    return `### ${tag}
 
 ${endpoints.map(e => `- [\`${e.method}\` ${e.path}](#${this.slugify(e.method + '-' + e.path)})`).join('\n')}`;
-}).join('\n\n')}
+  }).join('\n\n')}
 
 ---`);
 
     // Endpoint Details
-    sections.push(`## Endpoint Reference\n`);
+    sections.push('## Endpoint Reference\n');
 
     for (const [tag, endpoints] of Object.entries(endpointsByTag)) {
       sections.push(`### ${tag}\n`);

package/generators/decisions.js

@@ -274,17 +274,17 @@ This document tracks significant architecture and design decisions made during t
 | ID | Title | Category | Status | Impact | Date |
 |----|-------|----------|--------|--------|------|
 ${data.decisions.map(d => {
-  const category = DECISION_CATEGORIES[d.category] || { emoji: '📋', label: d.category };
-  const impact = IMPACT_LEVELS[d.impact] || { emoji: '🟡', label: d.impact };
-  return `| [${d.id}](#${d.id.toLowerCase()}) | ${d.title} | ${category.emoji} ${category.label} | ${this.formatStatus(d.status)} | ${impact.emoji} ${impact.label} | ${d.date} |`;
-}).join('\n')}
+    const category = DECISION_CATEGORIES[d.category] || { emoji: '📋', label: d.category };
+    const impact = IMPACT_LEVELS[d.impact] || { emoji: '🟡', label: d.impact };
+    return `| [${d.id}](#${d.id.toLowerCase()}) | ${d.title} | ${category.emoji} ${category.label} | ${this.formatStatus(d.status)} | ${impact.emoji} ${impact.label} | ${d.date} |`;
+  }).join('\n')}
 
 ---`);
     }
 
     // Individual Decisions
     if (data.decisions.length > 0) {
-      sections.push(`## Decisions\n`);
+      sections.push('## Decisions\n');
 
       for (const decision of data.decisions) {
         sections.push(this.formatDecision(decision));
@@ -318,16 +318,16 @@ bootspring docs decisions add "Decision Title"
 ### By Category
 
 ${Object.entries(stats.byCategory).map(([cat, count]) => {
-  const category = DECISION_CATEGORIES[cat] || { emoji: '📋', label: cat };
-  return `- ${category.emoji} **${category.label}:** ${count}`;
-}).join('\n')}
+    const category = DECISION_CATEGORIES[cat] || { emoji: '📋', label: cat };
+    return `- ${category.emoji} **${category.label}:** ${count}`;
+  }).join('\n')}
 
 ### By Impact
 
 ${Object.entries(stats.byImpact).map(([imp, count]) => {
-  const impact = IMPACT_LEVELS[imp] || { emoji: '🟡', label: imp };
-  return `- ${impact.emoji} **${impact.label}:** ${count}`;
-}).join('\n')}
+    const impact = IMPACT_LEVELS[imp] || { emoji: '🟡', label: imp };
+    return `- ${impact.emoji} **${impact.label}:** ${count}`;
+  }).join('\n')}
 
 ---`);
 
@@ -422,14 +422,14 @@ ${decision.rationale || '_No rationale provided._'}
 #### Options Considered
 
 ${decision.options.map((opt, i) => {
-  const chosen = opt.chosen ? ' ✅ **CHOSEN**' : '';
-  return `**Option ${i + 1}: ${opt.name}**${chosen}
+    const chosen = opt.chosen ? ' ✅ **CHOSEN**' : '';
+    return `**Option ${i + 1}: ${opt.name}**${chosen}
 
 ${opt.description || ''}
 
 - Pros: ${(opt.pros || []).join(', ') || 'None listed'}
 - Cons: ${(opt.cons || []).join(', ') || 'None listed'}`;
-}).join('\n\n')}
+  }).join('\n\n')}
 `;
     }
 

package/generators/health.js

@@ -590,12 +590,12 @@ ${scoreBar} **${metrics.overallScore}%**
 | Category | Score | Status |
 |----------|-------|--------|
 ${Object.entries(METRIC_CATEGORIES).map(([key, config]) => {
-  const metricKey = this.categoryToMetricKey(key);
-  const score = metrics[metricKey]?.score || 0;
-  const catStatus = this.getStatusFromScore(score);
-  const statusConfig = HEALTH_STATUS[catStatus];
-  return `| ${config.emoji} ${config.label} | ${score}/100 | ${statusConfig.emoji} ${statusConfig.label} |`;
-}).join('\n')}
+    const metricKey = this.categoryToMetricKey(key);
+    const score = metrics[metricKey]?.score || 0;
+    const catStatus = this.getStatusFromScore(score);
+    const statusConfig = HEALTH_STATUS[catStatus];
+    return `| ${config.emoji} ${config.label} | ${score}/100 | ${statusConfig.emoji} ${statusConfig.label} |`;
+  }).join('\n')}
 
 ---`);
 

package/generators/sprint.js

@@ -252,7 +252,7 @@ class SprintGenerator {
     const idealPointsPerDay = sprint.metrics.totalPoints / totalDays;
 
     const burndown = [];
-    let currentDate = new Date(startDate);
+    const currentDate = new Date(startDate);
     let idealRemaining = sprint.metrics.totalPoints;
 
     while (currentDate <= endDate) {
@@ -364,10 +364,10 @@ ${progressBar} **${metrics.percentComplete}%** Complete
       sections.push(`## Sprint Goals
 
 ${sprint.goals.map((goal, i) => {
-  const statusIcon = goal.status === 'completed' ? '✅' : goal.status === 'in_progress' ? '🔄' : '⬜';
-  return `${i + 1}. ${statusIcon} **${goal.description}**
+    const statusIcon = goal.status === 'completed' ? '✅' : goal.status === 'in_progress' ? '🔄' : '⬜';
+    return `${i + 1}. ${statusIcon} **${goal.description}**
    ${goal.success_criteria.length > 0 ? goal.success_criteria.map(c => `   - ${c}`).join('\n') : ''}`;
-}).join('\n\n')}
+  }).join('\n\n')}
 
 ---`);
     }

package/generators/templates/build-planning.template.js

@@ -284,8 +284,8 @@ function generateTodo(tasks, options = {}) {
       const checkbox = task.status === 'completed' ? '[x]' : '[ ]';
       const statusTag = task.status === 'completed' ? ' (`completed`)' :
         task.status === 'in_progress' ? ' (`in_progress`)' :
-        task.status === 'blocked' ? ' (`blocked`)' :
-        task.status === 'skipped' ? ' (`skipped`)' : '';
+          task.status === 'blocked' ? ' (`blocked`)' :
+            task.status === 'skipped' ? ' (`skipped`)' : '';
       content += `- ${checkbox} \`${task.id}\` ${task.title}${statusTag}\n`;
 
       // Source traceability

package/generators/visual-doc-generator.js

@@ -629,7 +629,7 @@ class VisualDocGenerator {
       // Add header comment
       const content = [
         `%% ${diagram.title}`,
-        `%% Generated by Bootspring Visual Doc Generator`,
+        '%% Generated by Bootspring Visual Doc Generator',
         `%% ${new Date().toISOString()}`,
         '',
         diagram.code

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@girardmedia/bootspring",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "description": "Thin client for Bootspring cloud MCP, hosted agents, and paywalled workflow intelligence",
   "keywords": [
     "ai",
@@ -48,20 +48,7 @@
   },
   "files": [
     "bin/bootspring.js",
-    "cli/agent.js",
-    "cli/auth.js",
-    "cli/billing.js",
-    "cli/build.js",
-    "cli/dashboard.js",
-    "cli/init.js",
-    "cli/mcp.js",
-    "cli/orchestrator.js",
-    "cli/project.js",
-    "cli/quality.js",
-    "cli/skill.js",
-    "cli/switch.js",
-    "cli/todo.js",
-    "cli/update.js",
+    "monorepo/apps/cli/dist/",
     "core/api-client.d.ts",
     "core/api-client.js",
     "core/auth.d.ts",