@girardmedia/bootspring 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bootspring
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,255 @@
+# Bootspring
+
+> 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)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Bootspring is an AI-powered development platform that provides intelligent context, specialized agents, and workflow automation for any MCP-compatible AI assistant.
+
+## Features
+
+- **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
+- **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
+# Initialize in your project
+npx @girardmedia/bootspring init
+
+# Or install globally
+npm install -g @girardmedia/bootspring
+bootspring init
+```
+
+## 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
+```
+
+### 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
+bootspring skill search <q>  # Find code patterns
+bootspring skill list --external  # Include curated external catalog
+bootspring orchestrator workflows  # List workflows and premium packs
+bootspring telemetry status  # Inspect local telemetry pipeline
+```
+
+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`
+
+### 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
+
+- [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)
+
+## 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/bootspring/bootspring)

package/agents/README.md

@@ -0,0 +1,93 @@
+# Bootspring Agents
+
+Specialized AI agents for different development domains. Each agent provides focused expertise, context, and patterns for its area.
+
+## Available Agents
+
+| Agent | Domain | Use When |
+|-------|--------|----------|
+| [database-expert](./database-expert/) | Database & ORM | Schema design, queries, migrations |
+| [security-expert](./security-expert/) | Security & Auth | Auth flows, vulnerabilities, OWASP |
+| [frontend-expert](./frontend-expert/) | UI & React | Components, state, styling |
+| [backend-expert](./backend-expert/) | Server Logic | API routes, server actions, business logic |
+| [api-expert](./api-expert/) | API Design | REST, GraphQL, route handlers |
+| [testing-expert](./testing-expert/) | Testing | Unit, integration, E2E tests |
+| [performance-expert](./performance-expert/) | Performance | Optimization, caching, profiling |
+| [devops-expert](./devops-expert/) | DevOps & CI/CD | Deployment, pipelines, infrastructure |
+| [ui-ux-expert](./ui-ux-expert/) | Design & UX | User experience, accessibility, design |
+| [architecture-expert](./architecture-expert/) | Architecture | System design, patterns, scaling |
+| [code-review-expert](./code-review-expert/) | Code Quality | Reviews, best practices, refactoring |
+| [vercel-expert](./vercel-expert/) | Vercel Platform | Deployment, edge, serverless |
+
+## Using Agents
+
+### Via CLI
+```bash
+# List all agents
+bootspring agent list
+
+# Show agent details
+bootspring agent show database-expert
+
+# Invoke agent for current context
+bootspring agent invoke security-expert
+```
+
+### Via MCP
+When using Claude Code, agents are automatically suggested based on your task context. You can also explicitly request an agent:
+
+```
+@bootspring agent database-expert
+```
+
+### Agent Selection
+
+Bootspring automatically detects which agents are relevant based on keywords in your request:
+
+- **database-expert**: database, schema, prisma, drizzle, migration, query, model
+- **security-expert**: auth, login, security, password, jwt, csrf, xss, owasp
+- **frontend-expert**: component, react, ui, tailwind, state, client, hook
+- **backend-expert**: api, server, action, business, logic, service
+- **testing-expert**: test, spec, jest, vitest, playwright, coverage
+- **performance-expert**: performance, optimize, cache, slow, fast, bundle
+- **devops-expert**: deploy, ci, cd, docker, kubernetes, pipeline
+- **architecture-expert**: architecture, design, pattern, scale, structure
+
+## Agent Context Files
+
+Each agent directory contains:
+
+```
+agents/{name}/
+├── context.md       # Full agent context and expertise
+├── patterns.md      # Common patterns this agent uses
+└── checklist.md     # Review checklist for this domain
+```
+
+## Creating Custom Agents
+
+Add a new directory under `agents/` with at minimum a `context.md` file:
+
+```markdown
+# Custom Agent Name
+
+## Role
+Brief description of what this agent does.
+
+## Expertise
+- Area 1
+- Area 2
+
+## Context
+Detailed knowledge and patterns...
+```
+
+Then register it in your `bootspring.config.js`:
+
+```javascript
+module.exports = {
+  agents: {
+    custom: ['my-custom-agent']
+  }
+};
+```