@girardmedia/bootspring 2.1.3 → 2.2.1

package/bin/bootspring.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 
-/**
- * Bootspring CLI
- * Thin client for the hosted Bootspring MCP and API platform.
- */
+/** Bootspring CLI bridge. Stable runtime by default, monorepo preview via --v2. */
 
 const path = require('path');
-const selfUpdate = require('../core/self-update');
-const { ensureProjectMcpConfig } = require('../core/mcp-config');
+const fs = require('fs');
+const { spawn } = require('child_process');
 
 const VERSION = require('../package.json').version;
+const STABLE_CLI_DIST = path.join(__dirname, '../dist/index.js');
+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 +21,193 @@ const C = {
   red: '\x1b[31m'
 };
 
-const LOGO = `${C.cyan}${C.bold}⚡ Bootspring${C.reset} ${C.dim}v${VERSION}${C.reset}`;
+const LOGO = `${C.cyan}${C.bold}⚡ Bootspring${C.reset} ${C.dim}v${VERSION}${C.reset}${USE_V2 ? ` ${C.green}(v2-beta)${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' }
+  auth: 'auth',
+  init: 'init',
+  project: 'project',
+  switch: { module: 'switchCmd' },
+  health: 'health',
+  mcp: 'mcp',
+  dashboard: 'dashboard',
+  context: 'context',
+  build: 'build',
+  deploy: 'deploy',
+  loop: 'loop',
+  quality: 'quality',
+  security: 'security',
+  doctor: 'doctor',
+  update: 'update',
+  plan: 'plan',
+  prd: 'prd',
+  preseed: 'preseed',
+  'preseed-start': { module: 'preseedStart', method: 'start' },
+  'preseed-from-codebase': { module: 'preseed', prepend: ['from-codebase'] },
+  seed: 'seed',
+  manager: 'manager',
+  agent: 'agent',
+  skill: 'skill',
+  todo: 'todo',
+  billing: 'billing',
+  plugin: 'plugin',
+  analyze: 'analyze',
+  audit: 'audit',
+  monitor: 'monitor',
+  metrics: 'metrics',
+  validate: 'validate',
+  visualize: 'visualize',
+  generate: 'generate',
+  content: 'content',
+  docs: 'docs',
+  learn: 'learn',
+  memory: 'memory',
+  suggest: 'suggest',
+  orchestrator: 'orchestrator',
+  watch: 'watch',
+  business: 'business',
+  fundraise: 'fundraise',
+  legal: 'legal',
+  org: 'org',
+  workspace: 'workspace',
+  'cloud-sync': { module: 'cloudSync' },
+  github: { module: 'githubCmd' },
+  onboard: 'onboard',
+  checkpoint: 'checkpoint',
+  setup: 'setup',
+  log: 'log',
+  mvp: 'mvp',
+  task: 'task',
+  telemetry: 'telemetry'
 };
 
-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;
-  }
+const HELP_GROUPS = {
+  'Core': ['auth', 'init', 'project', 'switch', 'health', 'mcp', 'dashboard', 'context'],
+  'Build & Deploy': ['build', 'deploy', 'loop', 'quality', 'security', 'doctor', 'update'],
+  'Planning': ['plan', 'prd', 'preseed', 'preseed-start', 'preseed-from-codebase', 'seed', 'manager'],
+  'Agents & Skills': ['agent', 'skill', 'todo', 'billing', 'plugin'],
+  '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', 'setup'],
+  'Tools': ['log', 'mvp', 'task', 'telemetry']
+};
 
+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}`);
+  for (const [group, cmds] of Object.entries(HELP_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}Run "bootspring <command> --help" for command details${C.reset}`);
+  console.log(`${C.dim}Use --v2 to try the monorepo preview CLI${C.reset}`);
+  console.log(`${C.dim}The preview CLI is not the production MCP/server path${C.reset}`);
+  console.log(`${C.dim}Docs: https://bootspring.com/docs${C.reset}\n`);
+}
 
-  console.log(`\n${C.dim}Docs: https://bootspring.com/docs${C.reset}`);
-  console.log(`${C.dim}Pricing: https://bootspring.com/pricing${C.reset}\n`);
+function loadStableCli() {
+  if (!fs.existsSync(STABLE_CLI_DIST)) {
+    console.error(`${C.red}Error: stable CLI build not found at ${STABLE_CLI_DIST}${C.reset}`);
+    console.error(`${C.dim}Please run 'npm run build' first.${C.reset}`);
+    process.exit(1);
+  }
+
+  return require(STABLE_CLI_DIST);
 }
 
-async function runCommand(command, args) {
+async function runStable(command, args) {
   const config = COMMANDS[command];
-  if (!config || !config.handler) {
-    showHelp(command);
-    return;
+  if (!config) {
+    return false;
   }
 
-  const handler = require(path.resolve(__dirname, config.handler));
-  await handler.run(args);
+  const stableCli = loadStableCli();
+  const route = typeof config === 'string'
+    ? { module: config, method: 'run', prepend: [] }
+    : { method: 'run', prepend: [], ...config };
+  const cliModule = stableCli.cli && stableCli.cli[route.module];
+  const handler = cliModule && cliModule[route.method];
+  const normalizedArgs = args[0] === '--help' || args[0] === '-h'
+    ? ['help', ...args.slice(1)]
+    : args;
+
+  if (typeof handler !== 'function') {
+    console.error(`${C.red}Error: missing stable CLI handler for ${command}${C.reset}`);
+    process.exit(1);
+  }
+
+  const result = await Promise.resolve(handler([...(route.prepend || []), ...normalizedArgs]));
+  if (typeof result === 'number' && Number.isFinite(result)) {
+    process.exit(result);
+  }
+
+  return true;
+}
+
+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);
+  }
+
+  console.error(`${C.yellow}Warning: using preview v2 CLI. Stable npm CLI remains the supported production path.${C.reset}`);
+  const cleanArgs = args.filter(arg => arg !== '--v2');
+  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 rawArgs = process.argv.slice(2);
+  const args = rawArgs.filter(arg => arg !== '--v2');
   const command = args[0];
 
-  if (!command) {
+  if (!command || command === '--help' || command === '-h' || command === 'help') {
+    if (command === 'help' && args[1]) {
+      const handled = await runStable(args[1], ['--help']);
+      if (handled) return;
+    }
     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;
+  try {
+    const { selfUpdate } = require(path.resolve(__dirname, '../dist/core'));
+    selfUpdate.ensureLatestVersion(args);
+  } catch {
+    // Best-effort; do not 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;
+  if (USE_V2) {
+    await runV2(args);
     return;
   }
 
-  const updateResult = selfUpdate.ensureLatestVersion(args);
-  if (updateResult.updated) {
-    process.exitCode = updateResult.exitCode;
+  if (await runStable(command, args.slice(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();
+main().catch((error) => {
+  console.error(`\n${C.red}Error: ${error.message}${C.reset}\n`);
+  process.exit(1);
+});

package/claude-commands/agent.md

@@ -0,0 +1,34 @@
+---
+name: agent
+description: Invoke Bootspring specialized AI agents
+---
+
+# /agent - Bootspring Agents
+
+Invoke specialized AI agents for focused tasks.
+
+## Instructions
+
+When user invokes `/agent`, use the `bootspring_agent` MCP tool:
+
+```json
+{
+  "action": "invoke",
+  "name": "<agent-name>"
+}
+```
+
+## Actions
+
+- `/agent <name>` → `bootspring_agent` with action: "invoke", name: "<name>"
+- `/agent list` → `bootspring_agent` with action: "list"
+- `/agent show <name>` → `bootspring_agent` with action: "show", name: "<name>"
+
+## Available Agents
+
+- `security` - Security audit
+- `performance` - Performance review
+- `api` - API design review
+- `database` - Database review
+- `testing` - Test analysis
+- `code-reviewer` - Code review

package/claude-commands/bs.md

@@ -0,0 +1,31 @@
+---
+name: bs
+description: Bootspring quick commands (universal shorthand)
+---
+
+# /bs - Bootspring Quick Commands
+
+Universal shorthand for Bootspring operations. Works with any AI CLI.
+
+## Instructions
+
+Parse the subcommand and use the appropriate bootspring MCP tool or CLI command.
+
+## Commands
+
+| Command | MCP Tool | CLI Fallback |
+|---------|----------|--------------|
+| `/bs skill <q>` | `bootspring_skill` action:search | `bootspring skill search <q>` |
+| `/bs agent <n>` | `bootspring_agent` action:invoke | `bootspring agent invoke <n>` |
+| `/bs todo` | `bootspring_todo` action:list | `bootspring todo list` |
+| `/bs todo add "<t>"` | `bootspring_todo` action:add | `bootspring todo add "<t>"` |
+| `/bs build` | `bootspring_seed` action:build-status | `bootspring build status` |
+| `/bs health` | `bootspring_context` action:health | `bootspring health` |
+| `/bs help` | - | `bootspring help` |
+
+## Examples
+
+- `/bs skill auth` - Search auth patterns
+- `/bs agent security` - Run security agent
+- `/bs todo add "Fix bug"` - Add todo
+- `/bs build` - Check build status

package/claude-commands/build.md

@@ -0,0 +1,25 @@
+---
+name: build
+description: Bootspring build management
+---
+
+# /build - Bootspring Build
+
+Manage the Bootspring build loop and task execution.
+
+## Instructions
+
+When user invokes `/build`, use the `bootspring_seed` MCP tool with build actions:
+
+## Actions
+
+- `/build` → `bootspring_seed` with action: "build-status"
+- `/build status` → `bootspring_seed` with action: "build-status"
+- `/build next` → `bootspring_seed` with action: "build-next"
+- `/build done` → `bootspring_seed` with action: "build-done"
+
+## Workflow
+
+1. `/build next` - Get next task
+2. Implement the task
+3. `/build done` - Mark complete

package/claude-commands/skill.md

@@ -0,0 +1,31 @@
+---
+name: skill
+description: Search and view Bootspring code patterns
+---
+
+# /skill - Bootspring Skills
+
+Search and view code patterns from the Bootspring library.
+
+## Instructions
+
+When user invokes `/skill`, use the `bootspring_skill` MCP tool:
+
+```json
+{
+  "action": "search",
+  "query": "<user's query>"
+}
+```
+
+## Actions
+
+- `/skill <query>` → `bootspring_skill` with action: "search", query: "<query>"
+- `/skill show <name>` → `bootspring_skill` with action: "show", name: "<name>"
+- `/skill list` → `bootspring_skill` with action: "list"
+
+## Examples
+
+- `/skill auth` → Search for authentication patterns
+- `/skill show auth/clerk` → Show the Clerk auth pattern
+- `/skill list` → List all available patterns

package/claude-commands/todo.md

@@ -0,0 +1,25 @@
+---
+name: todo
+description: Manage Bootspring project todos
+---
+
+# /todo - Bootspring Todos
+
+Manage project todos tracked by Bootspring.
+
+## Instructions
+
+When user invokes `/todo`, use the `bootspring_todo` MCP tool:
+
+## Actions
+
+- `/todo` → `bootspring_todo` with action: "list"
+- `/todo add "<task>"` → `bootspring_todo` with action: "add", text: "<task>"
+- `/todo done <id>` → `bootspring_todo` with action: "done", id: "<id>"
+- `/todo clear` → `bootspring_todo` with action: "clear"
+
+## Examples
+
+- `/todo` - List all todos
+- `/todo add "Fix login bug"` - Add new todo
+- `/todo done 1` - Complete todo #1