@girardmedia/bootspring 1.2.0 → 2.0.3

package/README.md

@@ -10,6 +10,8 @@ Bootspring is an AI-powered development platform that provides intelligent conte
 
 ## Features
 
+- **Preseed → Seed → Scaffold Pipeline** - Go from idea to working code with AI-assisted document generation
+- **Universal Drop Zone** - Drop any files and let AI analyze and categorize them for you
 - **Intelligent Context Management** - Automatically generates and maintains AI context for your project
 - **Specialized Agents** - 12+ expert agents for database, security, frontend, backend, and more
 - **MCP Integration** - Native Model Context Protocol server for seamless AI assistant integration
@@ -22,32 +24,82 @@ Bootspring is an AI-powered development platform that provides intelligent conte
 ## Quick Start
 
 ```bash
-# Initialize in your project
-npx @girardmedia/bootspring init
-
-# Or install globally
+# Install globally
 npm install -g @girardmedia/bootspring
+
+# Start a new project from an idea
+bootspring preseed start
+bootspring seed synthesize
+bootspring seed scaffold --preset=nextjs
+
+# Or initialize in an existing project
 bootspring init
 ```
 
+### New Project Workflow (Recommended)
+
+```bash
+# 1. Capture your idea with preseed
+bootspring preseed start
+
+# 2. Convert preseed docs to SEED.md
+bootspring seed synthesize
+
+# 3. Scaffold your project
+bootspring seed scaffold --preset=nextjs
+
+# 4. Start development
+npm install && npm run dev
+```
+
 ## Authentication
 
-Bootspring uses account-based authentication with device fingerprinting for security.
+Bootspring uses **browser-based device flow** authentication for security.
 
 ```bash
-# Register a new account
-bootspring auth register
-
-# Login to your account
+# Login via browser (opens browser for authentication)
 bootspring auth login
 
-# View account status
+# View authentication and project status
 bootspring auth status
 
-# Logout
+# Logout from all projects
 bootspring auth logout
 ```
 
+### How It Works
+
+1. **Global credentials** are stored in `~/.bootspring/credentials.json`
+2. **Each directory** is linked to a specific project via `.bootspring.json`
+3. **Login opens your browser** to authenticate and select/create a project
+
+```bash
+# First login in a directory:
+cd my-project
+bootspring auth login
+# → Opens browser → Sign in → Select project → Creates .bootspring.json
+
+# Subsequent use:
+bootspring auth login
+# → "Already authenticated as user@example.com"
+# → "Project: my-project (from .bootspring.json)"
+```
+
+### Per-Directory Project Linking
+
+Each directory can be linked to a different Bootspring project:
+
+```bash
+~/projects/frontend/    → "frontend-app" project
+~/projects/backend/     → "backend-api" project
+~/projects/mobile/      → "mobile-app" project
+```
+
+Switch projects with:
+```bash
+bootspring switch my-other-project
+```
+
 ### Device Management
 
 Each account has a device limit based on your subscription tier:
@@ -71,6 +123,24 @@ bootspring generate          # Generate/regenerate CLAUDE.md context
 bootspring dashboard         # Start the real-time dashboard
 ```
 
+### Preseed (Idea Capture)
+
+```bash
+bootspring preseed start         # Smart entry point - recommended first command
+bootspring preseed setup         # Create context folders including drop zone
+bootspring preseed init          # Interactive document generation wizard
+bootspring preseed workflow start # Begin document approval workflow
+bootspring preseed pull/push     # Sync with cloud dashboard
+```
+
+### Seed (Project Scaffolding)
+
+```bash
+bootspring seed synthesize       # Create SEED.md from preseed documents
+bootspring seed scaffold --preset=nextjs  # Generate project from preset
+bootspring seed init --preset=startup     # Interactive project config
+```
+
 ### Daily Workflow
 
 ```bash
@@ -86,15 +156,15 @@ bootspring context validate  # Validate project setup
 ```bash
 bootspring agent list        # List available agents
 bootspring agent show <name> # Show agent details
-bootspring agent invoke <n>  # Get specialized help (MCP required)
+bootspring agent invoke <n>  # Get specialized help (MCP enhanced)
 bootspring skill search <q>  # Find code patterns
-bootspring skill show <name> # View skill content (MCP required)
+bootspring skill show <name> # View skill content (MCP enhanced)
 bootspring skill list --external  # Include curated external catalog
 bootspring orchestrator workflows  # List workflows and premium packs
 bootspring telemetry status  # Inspect local telemetry pipeline
 ```
 
-> **Note:** Commands marked "MCP required" only work when invoked through an MCP-compatible AI assistant (Claude Code, etc). This protects proprietary prompts and agent configurations from being exposed in standalone CLI mode.
+> **Note:** Commands marked "MCP enhanced" provide full functionality through MCP integration but offer degraded (but useful) CLI mode. Run `bootspring mcp start` to enable full features.
 
 Premium workflow packs:
 
@@ -274,6 +344,29 @@ your-project/
 - [Planning Workspace](planning/README.md)
 - [MCP API Platform](docs/mcp-api-platform.md)
 
+## Development
+
+### Shared Database Schema
+
+The Bootspring API server (`server/`) and the website (`bootspring-site/`) share a PostgreSQL database. The canonical schema is in `shared/db/schema.sql`.
+
+```bash
+# To make schema changes:
+# 1. Edit the canonical schema
+vim shared/db/schema.sql
+
+# 2. Sync to both repos
+npm run db:sync
+
+# 3. Run server migration
+cd server && npm run migrate
+
+# 4. Run site migration
+cd ../bootspring-site && npm run db:push
+```
+
+See `shared/db/README.md` for full documentation.
+
 ## Contributing
 
 Contributions are welcome! Please see our [Contributing Guide](CONTRIBUTING.md).

package/bin/bootspring.js

@@ -25,25 +25,15 @@ const BRAND = {
   red: '\x1b[31m'
 };
 
-// ASCII art logo
+// ASCII art logo - fits in 60 columns
 const LOGO = `
-${BRAND.color}╔══════════════════════════════════════════╗
-║                                          ║
-║   ██████╗  ██████╗  ██████╗ ████████╗   ║
-║   ██╔══██╗██╔═══██╗██╔═══██╗╚══██╔══╝   ║
-║   ██████╔╝██║   ██║██║   ██║   ██║      ║
-║   ██╔══██╗██║   ██║██║   ██║   ██║      ║
-║   ██████╔╝╚██████╔╝╚██████╔╝   ██║      ║
-║   ╚═════╝  ╚═════╝  ╚═════╝    ╚═╝      ║
-║                                          ║
-║   ███████╗██████╗ ██████╗ ██╗███╗   ██╗ ║
-║   ██╔════╝██╔══██╗██╔══██╗██║████╗  ██║ ║
-║   ███████╗██████╔╝██████╔╝██║██╔██╗ ██║ ║
-║   ╚════██║██╔═══╝ ██╔══██╗██║██║╚██╗██║ ║
-║   ███████║██║     ██║  ██║██║██║ ╚████║ ║
-║   ╚══════╝╚═╝     ╚═╝  ╚═╝╚═╝╚═╝  ╚═══╝ ║
-║                                          ║
-╚══════════════════════════════════════════╝${BRAND.reset}
+${BRAND.color}╔══════════════════════════════════════════════════════════╗
+║  ████   ███   ███  █████  ███  ████  ████  █  █   █  ███  ║
+║  █   █ █   █ █   █   █   █     █   █ █   █ █  ██  █ █     ║
+║  ████  █   █ █   █   █    ███  ████  ████  █  █ █ █ █  ██ ║
+║  █   █ █   █ █   █   █       █ █     █  █  █  █  ██ █   █ ║
+║  ████   ███   ███    █   ████  █     █   █ █  █   █  ███  ║
+╚══════════════════════════════════════════════════════════╝${BRAND.reset}
 `;
 
 // Compact logo for non-help commands
@@ -57,6 +47,16 @@ const COMMANDS = {
     description: 'Login, logout, and manage authentication',
     usage: 'bootspring auth <login|logout|register|whoami|status>'
   },
+  switch: {
+    script: '../cli/switch.js',
+    description: 'Switch current project context',
+    usage: 'bootspring switch [project|recent|init|clear|status]'
+  },
+  project: {
+    script: '../cli/project.js',
+    description: 'Manage projects (list, create, info)',
+    usage: 'bootspring project <list|create|info> [args]'
+  },
 
   // Core commands
   init: {
@@ -64,10 +64,35 @@ const COMMANDS = {
     description: 'Initialize Bootspring in current project',
     usage: 'bootspring init [--force]'
   },
+  onboard: {
+    script: '../cli/onboard.js',
+    description: 'Layer Bootspring onto existing projects',
+    usage: 'bootspring onboard [status|resume|detect|generate|reset]'
+  },
+  analyze: {
+    script: '../cli/analyze.js',
+    description: 'Deep codebase analysis',
+    usage: 'bootspring analyze [status|resume|reset] [--depth=shallow|standard|deep]'
+  },
+  audit: {
+    script: '../cli/audit.js',
+    description: 'Quality, security, and best practices audit',
+    usage: 'bootspring audit [status|resume|reset] [--phase=<phase>] [--ci]'
+  },
+  preseed: {
+    script: '../cli/preseed.js',
+    description: 'Generate foundational documents from minimal input',
+    usage: 'bootspring preseed <init|generate|sync|status|update|export>'
+  },
   seed: {
     script: '../cli/seed.js',
     description: 'Project scaffolding and configuration',
-    usage: 'bootspring seed <init|scaffold|update|status|export>'
+    usage: 'bootspring seed <init|scaffold|build|update|status|export>'
+  },
+  build: {
+    script: '../cli/build.js',
+    description: 'Build management and progress tracking',
+    usage: 'bootspring build <status|pause|resume|task|skip|plan|reset>'
   },
   generate: {
     script: '../cli/generate.js',
@@ -79,6 +104,56 @@ const COMMANDS = {
     description: 'Open cloud dashboard (bootspring.com)',
     usage: 'bootspring dashboard'
   },
+  deploy: {
+    script: '../cli/deploy.js',
+    description: 'Deploy to production (Vercel, Railway, Fly.io, etc.)',
+    usage: 'bootspring deploy [target] [--preview] [--dry-run]'
+  },
+  monitor: {
+    script: '../cli/monitor.js',
+    description: 'Production monitoring, hooks, and alerting',
+    usage: 'bootspring monitor <init|status|metrics|post-deploy> [options]'
+  },
+  health: {
+    script: '../cli/health.js',
+    description: 'Quick project health overview and status',
+    usage: 'bootspring health [--json]'
+  },
+  checkpoint: {
+    script: '../cli/checkpoint.js',
+    description: 'Manage project checkpoints and milestones',
+    usage: 'bootspring checkpoint [status|complete|history|sync]'
+  },
+  github: {
+    script: '../cli/github-cmd.js',
+    description: 'GitHub integration and repository sync',
+    usage: 'bootspring github [connect|sync|status|disconnect]'
+  },
+  'cloud-sync': {
+    script: '../cli/cloud-sync.js',
+    description: 'Sync project context to cloud (Cloudflare R2)',
+    usage: 'bootspring cloud-sync [push|pull|status|history|restore]'
+  },
+  billing: {
+    script: '../cli/billing.js',
+    description: 'Manage subscription and view usage',
+    usage: 'bootspring billing [status|usage|upgrade|portal]'
+  },
+  manager: {
+    script: '../cli/manager.js',
+    description: 'Overview of all projects with health scores',
+    usage: 'bootspring manager [list|show|export|scan]'
+  },
+  security: {
+    script: '../cli/security.js',
+    description: 'Security scanning and score tracking',
+    usage: 'bootspring security [scan|quick|status|findings]'
+  },
+  metrics: {
+    script: '../cli/metrics.js',
+    description: 'Collect and track project metrics',
+    usage: 'bootspring metrics [collect|status|show|export|badges]'
+  },
 
   // Todo commands
   todo: {
@@ -157,6 +232,13 @@ const COMMANDS = {
     usage: 'bootspring mvp <init|analyze|import|list|show|extract>'
   },
 
+  // PRD commands
+  prd: {
+    script: '../cli/prd.js',
+    description: 'Product requirements management',
+    usage: 'bootspring prd <create|list|show|import|to-tasks|status>'
+  },
+
   // Business commands
   business: {
     script: '../cli/business.js',
@@ -178,6 +260,13 @@ const COMMANDS = {
     usage: 'bootspring legal <init|terms|privacy|gdpr|status>'
   },
 
+  // Content commands
+  content: {
+    script: '../cli/content.js',
+    description: 'Generate content (blogs, docs, releases)',
+    usage: 'bootspring content <new|types> <type> [options]'
+  },
+
   // Update commands
   update: {
     script: '../cli/update.js',
@@ -205,6 +294,11 @@ const COMMANDS = {
     description: 'View git-based project memory',
     usage: 'bootspring memory <summary|search|files|stats> [args]'
   },
+  suggest: {
+    script: '../cli/suggest.js',
+    description: 'AI-powered recommendations based on telemetry',
+    usage: 'bootspring suggest [next|learning|workflows|skills] [--limit=5]'
+  },
 
   // Telemetry commands
   telemetry: {
@@ -213,6 +307,27 @@ const COMMANDS = {
     usage: 'bootspring telemetry <status|list|upload|clear> [options]'
   },
 
+  // Visualize command
+  visualize: {
+    script: '../cli/visualize.js',
+    description: 'Terminal-based workflow visualization',
+    usage: 'bootspring visualize [--watch] [--graph]'
+  },
+
+  // Watch command
+  watch: {
+    script: '../cli/watch.js',
+    description: 'Real-time file watching and sync',
+    usage: 'bootspring watch [--todos] [--workflows] [--prd]'
+  },
+
+  // Workspace command
+  workspace: {
+    script: '../cli/workspace.js',
+    description: 'Multi-project workspace management',
+    usage: 'bootspring workspace <init|add|remove|list|run>'
+  },
+
   // Help
   help: {
     script: null,
@@ -223,12 +338,16 @@ const COMMANDS = {
 
 // Command categories for help display
 const CATEGORIES = {
-  'Getting Started': ['auth', 'init', 'seed', 'mvp', 'generate', 'dashboard', 'help'],
+  'Getting Started': ['auth', 'switch', 'project', 'init', 'onboard', 'preseed', 'seed', 'build', 'mvp', 'prd', 'generate', 'dashboard', 'workspace', 'help'],
+  'Project Management': ['checkpoint', 'manager', 'github'],
+  'Analysis': ['analyze', 'audit'],
   'Business': ['business', 'fundraise', 'legal'],
-  'Daily Workflow': ['todo', 'task', 'context', 'log'],
-  'Intelligence': ['agent', 'skill', 'orchestrator', 'loop', 'memory'],
+  'Content': ['content'],
+  'Daily Workflow': ['todo', 'task', 'context', 'log', 'watch'],
+  'Intelligence': ['agent', 'skill', 'orchestrator', 'loop', 'memory', 'suggest'],
   'Quality & Plugins': ['quality', 'plugin'],
-  'System': ['mcp', 'doctor', 'telemetry', 'update']
+  'Deployment': ['deploy', 'monitor', 'health'],
+  'System': ['mcp', 'doctor', 'telemetry', 'update', 'visualize']
 };
 
 /**
@@ -279,7 +398,13 @@ function showVersion() {
  * Main entry point
  */
 async function main() {
-  const args = process.argv.slice(2);
+  const rawArgs = process.argv.slice(2);
+
+  // Parse --project flag first (can appear anywhere)
+  const projectContext = require('../core/project-context');
+  const { projectOverride, cleanArgs } = projectContext.parseProjectFlag(rawArgs);
+
+  const args = cleanArgs;
   const command = args[0];
 
   // Handle no command
@@ -328,13 +453,20 @@ async function main() {
     process.exit(0);
   }
 
+  // Validate project context before running command
+  const commandArgs = args.slice(1);
+  const validation = projectContext.validateForCommand(command, commandArgs, { projectOverride });
+
+  if (!validation.valid) {
+    console.log(LOGO_COMPACT);
+    console.log(`\n${projectContext.formatError(validation.error)}\n`);
+    process.exit(1);
+  }
+
   // Load and execute command
   try {
     const commandModule = require(scriptPath);
 
-    // Pass remaining args to command
-    const commandArgs = args.slice(1);
-
     // Execute command
     if (typeof commandModule.run === 'function') {
       await commandModule.run(commandArgs);
@@ -345,6 +477,13 @@ async function main() {
       process.exit(1);
     }
   } catch (error) {
+    // Handle project context errors specially
+    if (error.code === 'NO_PROJECT_CONTEXT') {
+      console.log(LOGO_COMPACT);
+      console.log(`\n${projectContext.formatError(error)}\n`);
+      process.exit(1);
+    }
+
     console.log(LOGO_COMPACT);
     console.log(`\n${BRAND.red}Error executing '${command}':${BRAND.reset}`);
     console.log(`${BRAND.dim}${error.message}${BRAND.reset}\n`);