@girardmedia/bootspring 2.2.0 → 2.2.1

package/bin/bootspring.js

@@ -1,14 +1,13 @@
 #!/usr/bin/env node
 
-/**
- * Bootspring CLI Bridge
- * Routes commands to either the modern v2 monorepo CLI or legacy v1 handlers.
- */
+/** Bootspring CLI bridge. Stable runtime by default, monorepo preview via --v2. */
 
 const path = require('path');
 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');
 
@@ -24,70 +23,129 @@ const C = {
 
 const LOGO = `${C.cyan}${C.bold}⚡ Bootspring${C.reset} ${C.dim}v${VERSION}${C.reset}${USE_V2 ? ` ${C.green}(v2-beta)${C.reset}` : ''}`;
 
-/**
- * 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 = {};
+const COMMANDS = {
+  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'
+};
+
+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}Development scaffolding with intelligence${C.reset}\n`);
   console.log(`${C.bold}Usage:${C.reset} bootspring <command> [options]\n`);
 
-  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)) {
+  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.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`);
 }
 
-async function runV1(command, args) {
-  const config = V1_COMMANDS[command];
+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 runStable(command, args) {
+  const config = COMMANDS[command];
   if (!config) {
-    showHelp();
-    return;
+    return false;
+  }
+
+  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);
   }
-  const handler = require(path.resolve(__dirname, config.handler));
-  await handler.run(args);
+
+  return true;
 }
 
 async function runV2(args) {
@@ -97,11 +155,8 @@ async function runV2(args) {
     process.exit(1);
   }
 
-  // Filter out the --v2 flag if present
+  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');
-  
-  // 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' }
@@ -113,10 +168,15 @@ async function runV2(args) {
 }
 
 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 || command === '--help' || command === '-h' || command === 'help') {
+    if (command === 'help' && args[1]) {
+      const handled = await runStable(args[1], ['--help']);
+      if (handled) return;
+    }
     showHelp();
     return;
   }
@@ -126,28 +186,19 @@ async function main() {
     return;
   }
 
-  // Auto-update check (before any command execution)
   try {
-    const selfUpdate = require(path.resolve(__dirname, '../core/self-update'));
+    const { selfUpdate } = require(path.resolve(__dirname, '../dist/core'));
     selfUpdate.ensureLatestVersion(args);
   } catch {
-    // Best-effort; don't block CLI on update failures
+    // Best-effort; do not block CLI on update failures.
   }
 
-  // Route to v2 if explicitly requested or if command is migrated
-  if (USE_V2 || V2_COMMANDS.includes(command)) {
+  if (USE_V2) {
     await runV2(args);
     return;
   }
 
-  // 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);
-    }
+  if (await runStable(command, args.slice(1))) {
     return;
   }
 
@@ -156,4 +207,7 @@ async function main() {
   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