@girardmedia/bootspring 2.2.0 → 2.3.0

package/README.md

@@ -3,7 +3,7 @@
 > Development scaffolding with intelligence
 
 [![npm version](https://badge.fury.io/js/@girardmedia%2Fbootspring.svg)](https://www.npmjs.com/package/@girardmedia/bootspring)
-[![CI](https://github.com/bootspring/bootspring/actions/workflows/ci.yml/badge.svg)](https://github.com/bootspring/bootspring/actions/workflows/ci.yml)
+[![CI](https://github.com/Girard-Media/bootspring/actions/workflows/ci.yml/badge.svg)](https://github.com/Girard-Media/bootspring/actions/workflows/ci.yml)
 
 Bootspring is an AI-powered development platform that provides intelligent context, specialized agents, and workflow automation for any MCP-compatible AI assistant.
 
@@ -404,4 +404,4 @@ MIT License - see [LICENSE](LICENSE) for details.
 
 **Bootspring** - Bootstrap your development. Spring into production.
 
-[Website](https://bootspring.com) · [Documentation](https://bootspring.com/docs) · [GitHub](https://github.com/bootspring/bootspring)
+[Website](https://bootspring.com) · [Documentation](https://bootspring.com/docs) · [GitHub](https://github.com/Girard-Media/bootspring)

package/bin/bootspring.js

@@ -1,16 +1,17 @@
 #!/usr/bin/env node
 
 /**
- * Bootspring CLI Bridge
- * Routes commands to either the modern v2 monorepo CLI or legacy v1 handlers.
+ * Bootspring CLI bridge.
+ * Routes all commands through the v2 monorepo CLI (thin client).
+ * dist/core.js provides self-update only. No IP ships in this package.
  */
 
 const path = require('path');
 const fs = require('fs');
+const { spawn } = require('child_process');
 
 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 CLI_DIST = path.join(__dirname, '../dist/cli/index.cjs');
 
 const C = {
   reset: '\x1b[0m',
@@ -22,57 +23,25 @@ const C = {
   red: '\x1b[31m'
 };
 
-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'
-];
+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']
+};
 
-/**
- * Legacy v1 commands (kept for backward compat, prefer v2)
- */
-const V1_COMMANDS = {};
 function showHelp() {
-  console.log(LOGO);
+  console.log(`${C.cyan}${C.bold}⚡ Bootspring${C.reset} ${C.dim}v${VERSION}${C.reset}`);
   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(', ')}`);
   }
 
@@ -80,31 +49,16 @@ function showHelp() {
   console.log(`${C.dim}Docs: https://bootspring.com/docs${C.reset}\n`);
 }
 
-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}`);
+function runCli(args) {
+  if (!fs.existsSync(CLI_DIST)) {
+    console.error(`${C.red}Error: CLI build not found at ${CLI_DIST}${C.reset}`);
+    console.error(`${C.dim}Please run 'npm run 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], {
+  const child = spawn('node', [CLI_DIST, ...args], {
     stdio: 'inherit',
-    env: { ...process.env, BOOTSPRING_V2_BRIDGE: 'true' }
+    env: { ...process.env, BOOTSPRING_BRIDGE: 'true' }
   });
 
   child.on('exit', (code) => {
@@ -122,38 +76,23 @@ async function main() {
   }
 
   if (command === '--version' || command === '-v') {
-    console.log(`Bootspring v${VERSION} (Bridge)`);
+    console.log(`Bootspring v${VERSION}`);
     return;
   }
 
-  // Auto-update check (before any command execution)
+  // Self-update check (best-effort from thin-client core)
   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)) {
-    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);
-    }
-    return;
-  }
-
-  console.log(`${C.red}Unknown command: ${command}${C.reset}`);
-  showHelp();
-  process.exit(1);
+  // Route everything through the v2 monorepo CLI
+  runCli(args);
 }
 
-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