@girardmedia/bootspring 2.5.0 → 2.5.1

package/README.md

@@ -1,408 +1,14 @@
-# Bootspring
+# Monorepo CLI Authority
 
-> Development scaffolding with intelligence
+`monorepo/apps/cli/` is the authoritative Bootspring CLI source and npm package.
 
-[![npm version](https://badge.fury.io/js/@girardmedia%2Fbootspring.svg)](https://www.npmjs.com/package/@girardmedia/bootspring)
-[![CI](https://github.com/Girard-Media/bootspring/actions/workflows/ci.yml/badge.svg)](https://github.com/Girard-Media/bootspring/actions/workflows/ci.yml)
+## Runtime Path
 
-Bootspring is an AI-powered development platform that provides intelligent context, specialized agents, and workflow automation for any MCP-compatible AI assistant.
+`bin/bootspring.js` -> `dist/cli-launcher.js` -> `dist/cli/index.js`
 
-## Features
+## Rules
 
-- **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
-- **Parallel Workflow Orchestration** - Multi-phase parallel execution plans with 36 specialized agents
-- **Specialized Agents** - 36 expert agents for database, security, frontend, backend, and more
-- **MCP Integration** - Native Model Context Protocol server for seamless AI assistant integration
-- **Entitlement-Ready Skill Catalog** - Built-in patterns public, curated external catalog policy-gated
-- **Plugin System** - Extensible architecture for auth, payments, database, testing, security
-- **Real-time Dashboard** - Visual project tracking with live updates
-- **Quality Gates** - Automated code quality and security checks
-- **Todo Management** - Simple, powerful task tracking
-
-## Quick Start
-
-```bash
-# 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 **browser-based device flow** authentication for security.
-
-```bash
-# Login via browser (opens browser for authentication)
-bootspring auth login
-
-# View authentication and project status
-bootspring auth status
-
-# 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` (local secret state, git-ignored)
-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:
-
-| Tier | Max Devices |
-|------|-------------|
-| Free | 1 |
-| Pro | 3 |
-| Team | 10 |
-| Enterprise | 50 |
-
-Your devices are automatically tracked when you login. If you hit your device limit, logout from another device or upgrade your plan.
-
-## Tier Boundaries
-
-Bootspring enforces plan boundaries across CLI, API, and MCP features:
-
-| Tier | Included | Upgrade Boundary |
-|------|----------|------------------|
-| Free | Core CLI workflow, built-in skills, free workflow packs | Premium workflows, external skills in server mode, managed connectors |
-| Pro | Premium workflow packs, external skills, managed connectors (pro catalog) | Team collaboration limits and team-only managed connectors |
-| Team | Team collaboration features, higher limits, team-only managed connectors | Enterprise governance/SLA features |
-| Enterprise | Highest limits, governance/compliance features, enterprise support | Custom contracts/add-ons |
-
-Billing and current tier:
-
-```bash
-bootspring billing status
-bootspring billing upgrade
-```
-
-## Commands
-
-### Getting Started
-
-```bash
-bootspring init              # Initialize Bootspring in your project
-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
-bootspring todo add "task"   # Add a new todo
-bootspring todo list         # List all todos
-bootspring todo done 1       # Mark todo #1 as complete
-bootspring context           # View project context summary
-bootspring context validate  # Validate project setup
-```
-
-### Intelligence
-
-```bash
-bootspring agent list        # List available agents
-bootspring agent show <name> # Show agent details
-bootspring agent invoke <n>  # Get specialized help (MCP enhanced)
-bootspring skill search <q>  # Find code patterns
-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 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:
-
-- `launch-pack` (pro)
-- `reliability-pack` (pro)
-- `growth-pack` (pro)
-
-Workflow telemetry (stored locally in `.bootspring/telemetry/events.jsonl`):
-
-- `workflow_started`
-- `workflow_step_advanced`
-- `workflow_checkpoint_completed`
-- `pack_signal_checkpoint`
-- `workflow_completed`
-- `conversion.time_to_first_success`
-- `conversion.first_week_activation`
-
-### External Skill Entitlements
-
-Built-in skills are always available. Curated external skills (`external/*`) are policy-gated via a shared entitlement layer:
-
-- Local mode (default): external skills are available when present.
-- Server mode: external skills require entitlement.
-
-```bash
-# Server-side policy mode (for hosted API/MCP)
-export BOOTSPRING_SKILL_ACCESS_MODE=server
-
-# Grant entitlement in server mode
-export BOOTSPRING_SKILLS_ENTITLED=true
-# or
-export BOOTSPRING_USER_TIER=pro
-```
-
-Remote premium delivery (cache-first):
-
-```bash
-bootspring skill sync \
-  --manifest-url https://api.bootspring.com/skills/manifest.json \
-  --content-base-url https://api.bootspring.com/skills/content
-```
-
-Recommended for production:
-
-```bash
-export BOOTSPRING_SKILL_MANIFEST_REQUIRE_SIGNATURE=true
-export BOOTSPRING_SKILL_MANIFEST_PUBLIC_KEY="-----BEGIN PUBLIC KEY-----..."
-```
-
-### PRD Markdown
-
-`intelligence/prd` supports both hand-written and exported story headings:
-
-- `## Story 1: Title`
-- `### [ ] Title` (export format from `toMarkdown()`)
-
-Top-level description text should appear after the `# Title` and before story headings.
-
-### Quality & Plugins
-
-```bash
-bootspring quality pre-commit  # Run pre-commit checks
-bootspring plugin list         # List available plugins
-bootspring plugin enable auth  # Enable a plugin
-```
-
-## Agents
-
-Bootspring includes 12+ specialized agents:
-
-| Agent | Expertise |
-|-------|-----------|
-| `database-expert` | SQL, Prisma, PostgreSQL, migrations |
-| `security-expert` | OWASP, authentication, authorization |
-| `frontend-expert` | React, Next.js, Tailwind, components |
-| `backend-expert` | Node.js, APIs, server actions |
-| `api-expert` | REST, GraphQL, tRPC, webhooks |
-| `testing-expert` | Vitest, Jest, Playwright, coverage |
-| `performance-expert` | Optimization, caching, profiling |
-| `devops-expert` | CI/CD, Docker, deployment |
-| `ui-ux-expert` | Design systems, accessibility |
-| `architecture-expert` | System design, patterns |
-| `code-review-expert` | Code quality, best practices |
-| `vercel-expert` | Vercel, serverless, edge |
-
-## Configuration
-
-Create `bootspring.config.js` in your project root:
-
-```javascript
-module.exports = {
-  project: {
-    name: 'My App',
-    description: 'A modern web application'
-  },
-  stack: {
-    framework: 'nextjs',
-    language: 'typescript',
-    database: 'postgresql',
-    hosting: 'vercel'
-  },
-  plugins: {
-    auth: { enabled: true, provider: 'clerk' },
-    payments: { enabled: true, provider: 'stripe' },
-    database: { enabled: true, provider: 'prisma' },
-    testing: { enabled: true, provider: 'vitest' },
-    security: { enabled: true }
-  },
-  dashboard: {
-    port: 3456
-  }
-};
-```
-
-## MCP Integration
-
-Bootspring works as an MCP server for Claude Code and other compatible AI assistants.
-
-Configure in `.mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "bootspring": {
-      "command": "npx",
-      "args": ["@girardmedia/bootspring", "mcp"],
-      "env": {}
-    }
-  }
-}
-```
-
-Available MCP tools:
-- `bootspring_context` - Show/validate project context
-- `bootspring_agent` - Invoke specialized agents
-- `bootspring_capabilities` - Discover client-adaptive capabilities by tier/mode
-- `bootspring_skill` - Retrieve code patterns
-- `bootspring_telemetry` - List/upload/clear telemetry events
-- `bootspring_todo` - Manage todo items
-- `bootspring_task` - Manage complex tasks
-- `bootspring_quality` - Run quality gates
-- `bootspring_generate` - Regenerate context
-- `bootspring_dashboard` - Control dashboard
-
-## Project Structure
-
-```
-your-project/
-├── bootspring.config.js    # Configuration
-├── CLAUDE.md               # Generated AI context
-├── todo.md                 # Task tracking
-├── .mcp.json               # MCP server config
-└── ...
-```
-
-## Why Bootspring?
-
-**Before Bootspring:**
-- Manual context management for AI assistants
-- Inconsistent code patterns across projects
-- No specialized expertise on demand
-- Manual quality checks
-
-**With Bootspring:**
-- Automatic context generation and updates
-- Battle-tested code patterns via skills
-- 12+ specialized agents at your fingertips
-- Automated quality gates
-- Real-time project visibility
-
-## Documentation
-
-- [Quick Start](docs/QUICK_START.md)
-- [Installation](docs/INSTALLATION.md)
-- [First Project Tutorial](docs/FIRST_PROJECT.md)
-- [Troubleshooting](docs/TROUBLESHOOTING.md)
-- [FAQ](docs/FAQ.md)
-- [Enterprise Guide](docs/ENTERPRISE.md)
-- [Getting Started](https://bootspring.com/docs/getting-started)
-- [Configuration](https://bootspring.com/docs/configuration)
-- [Agents](https://bootspring.com/docs/agents)
-- [Skills](https://bootspring.com/docs/skills)
-- [Plugins](https://bootspring.com/docs/plugins)
-- [MCP Integration](https://bootspring.com/docs/mcp)
-- [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).
-
-## License
-
-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/Girard-Media/bootspring)
+- Implement new CLI behavior here.
+- Keep published launcher behavior in `monorepo/apps/cli/publish-shell/bootspring.ts`.
+- Keep package-local publish assets here: `bin/`, `dist/`, `assets/`, and `scripts/postinstall.cjs`.
+- Keep release docs, tests, and migration notes aligned with this folder as the CLI authority.

package/bin/bootspring.js

@@ -1,98 +1,3 @@
 #!/usr/bin/env node
 
-/**
- * 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 CLI_DIST = path.join(__dirname, '../dist/cli/index.cjs');
-
-const C = {
-  reset: '\x1b[0m',
-  bold: '\x1b[1m',
-  dim: '\x1b[2m',
-  cyan: '\x1b[36m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  red: '\x1b[31m'
-};
-
-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(`${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`);
-
-  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}Docs: https://bootspring.com/docs${C.reset}\n`);
-}
-
-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);
-  }
-
-  const child = spawn('node', [CLI_DIST, ...args], {
-    stdio: 'inherit',
-    env: { ...process.env, BOOTSPRING_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 || command === '--help' || command === '-h' || command === 'help') {
-    showHelp();
-    return;
-  }
-
-  if (command === '--version' || command === '-v') {
-    console.log(`Bootspring v${VERSION}`);
-    return;
-  }
-
-  // Self-update check (best-effort from thin-client core)
-  try {
-    const { selfUpdate } = require(path.resolve(__dirname, '../dist/core'));
-    selfUpdate.ensureLatestVersion(args);
-  } catch {
-    // Best-effort; do not block CLI on update failures.
-  }
-
-  // Route everything through the v2 monorepo CLI
-  runCli(args);
-}
-
-main().catch((error) => {
-  console.error(`\n${C.red}Error: ${error.message}${C.reset}\n`);
-  process.exit(1);
-});
+require('../dist/cli-launcher.js');