@girardmedia/bootspring 1.1.0

package/mcp/capabilities.js

@@ -0,0 +1,71 @@
+/**
+ * Bootspring MCP Capabilities
+ * Capability manifest for assistant clients (Claude Code, Codex, etc.).
+ */
+
+const entitlements = require('../core/entitlements');
+const policies = require('../core/policies');
+const intelligence = require('../intelligence');
+
+function buildCapabilities(options = {}) {
+  const access = entitlements.resolveWorkflowAccessContext(options);
+  const policy = policies.getPolicyProfile(access.policyProfile, options);
+  const workflows = intelligence.listWorkflows();
+  const filtered = entitlements.filterAccessibleWorkflows(workflows, options);
+  const premiumLocked = filtered.denied.length;
+
+  const packs = filtered.allowed
+    .filter(workflow => (workflow.tier || 'free') !== 'free')
+    .map(workflow => ({
+      key: workflow.key,
+      name: workflow.name,
+      pack: workflow.pack || null,
+      outcomes: workflow.outcomes || [],
+      completionSignals: workflow.completionSignals || []
+    }));
+
+  return {
+    platform: {
+      name: 'bootspring',
+      protocol: 'mcp',
+      version: '1.1.0'
+    },
+    access: {
+      mode: access.mode,
+      tier: access.tier,
+      entitled: access.entitled,
+      policyProfile: access.policyProfile
+    },
+    policy: {
+      id: policy.id,
+      allowExternalSkills: policy.allowExternalSkills,
+      blockedWorkflows: policy.blockedWorkflows
+    },
+    capabilities: {
+      skills: {
+        builtIn: true,
+        externalCatalog: access.mode !== 'server' || access.entitled || ['pro', 'team', 'enterprise'].includes(access.tier)
+      },
+      workflows: {
+        availableCount: filtered.allowed.length,
+        premiumLocked,
+        packs
+      },
+      telemetry: {
+        events: [
+          'workflow_started',
+          'workflow_step_advanced',
+          'workflow_checkpoint_completed',
+          'pack_signal_checkpoint',
+          'workflow_completed',
+          'premium_prompted',
+          'premium_unlocked'
+        ]
+      }
+    }
+  };
+}
+
+module.exports = {
+  buildCapabilities
+};

package/mcp/contracts/mcp-contract.v1.json

@@ -0,0 +1,497 @@
+{
+  "contractVersion": "v1",
+  "packageName": "@girardmedia/bootspring",
+  "packageVersion": "1.1.0",
+  "tools": [
+    {
+      "name": "bootspring_context",
+      "description": "Show or validate the current project context. Use \"show\" to see project summary, \"validate\" to check project health.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "type": "string",
+            "enum": [
+              "show",
+              "validate",
+              "summary"
+            ],
+            "description": "Action to perform: show (default), validate, or summary"
+          }
+        },
+        "required": []
+      }
+    },
+    {
+      "name": "bootspring_agent",
+      "description": "Work with specialized AI agents. List available agents, show details, or invoke for specialized expertise.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "type": "string",
+            "enum": [
+              "list",
+              "show",
+              "invoke",
+              "search"
+            ],
+            "description": "Action: list agents, show details, invoke agent, or search"
+          },
+          "name": {
+            "type": "string",
+            "description": "Agent name (e.g., database-expert, security-expert)"
+          },
+          "topic": {
+            "type": "string",
+            "description": "Topic or question for the agent (when invoking)"
+          },
+          "query": {
+            "type": "string",
+            "description": "Search query (when searching)"
+          },
+          "includeExternal": {
+            "type": "boolean",
+            "description": "Include external skills catalog (skills/external) in list/search/show"
+          },
+          "limit": {
+            "type": "number",
+            "description": "Max number of results for list/search when includeExternal is true"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      }
+    },
+    {
+      "name": "bootspring_todo",
+      "description": "Manage project todo items. Add, list, complete, or remove tasks.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "type": "string",
+            "enum": [
+              "list",
+              "add",
+              "done",
+              "remove",
+              "clear"
+            ],
+            "description": "Action: list, add, done (complete), remove, or clear"
+          },
+          "text": {
+            "type": "string",
+            "description": "Todo text (when adding)"
+          },
+          "index": {
+            "type": "number",
+            "description": "Todo index number (when completing or removing)"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      }
+    },
+    {
+      "name": "bootspring_generate",
+      "description": "Regenerate the CLAUDE.md context file with current project state.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "full": {
+            "type": "boolean",
+            "description": "Full regeneration including .mcp.json and todo.md"
+          }
+        },
+        "required": []
+      }
+    },
+    {
+      "name": "bootspring_skill",
+      "description": "Search and retrieve code patterns/skills. Find battle-tested implementations.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "type": "string",
+            "enum": [
+              "list",
+              "show",
+              "search",
+              "sync"
+            ],
+            "description": "Action: list all skills, show a skill, search, or sync remote external catalog"
+          },
+          "name": {
+            "type": "string",
+            "description": "Skill name (e.g., auth/clerk, database/prisma)"
+          },
+          "query": {
+            "type": "string",
+            "description": "Search query"
+          },
+          "includeExternal": {
+            "type": "boolean",
+            "description": "Include external skills from skills/external"
+          },
+          "limit": {
+            "type": "number",
+            "description": "Limit list/search result count (default: 50)"
+          },
+          "summary": {
+            "type": "boolean",
+            "description": "For action=show, return concise summary instead of full content"
+          },
+          "sections": {
+            "type": "string",
+            "description": "For action=show, comma-separated section keywords to include"
+          },
+          "maxChars": {
+            "type": "number",
+            "description": "For action=show, cap returned content length"
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "local",
+              "server"
+            ],
+            "description": "Optional entitlement mode override (default: local)"
+          },
+          "entitled": {
+            "type": "boolean",
+            "description": "Optional entitlement override for external skills"
+          },
+          "tier": {
+            "type": "string",
+            "description": "Optional tier override (free, pro, team, enterprise)"
+          },
+          "manifestUrl": {
+            "type": "string",
+            "description": "For action=sync, remote manifest URL"
+          },
+          "contentBaseUrl": {
+            "type": "string",
+            "description": "For action=sync, fallback base URL for SKILL.md files"
+          },
+          "token": {
+            "type": "string",
+            "description": "For action=sync, optional bearer token"
+          },
+          "cacheDir": {
+            "type": "string",
+            "description": "For action=sync, local cache directory override"
+          },
+          "manifestPublicKey": {
+            "type": "string",
+            "description": "For action=sync, PEM public key for manifest signature verification"
+          },
+          "requireManifestSignature": {
+            "type": "boolean",
+            "description": "For action=sync, require signature validation"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      }
+    },
+    {
+      "name": "bootspring_quality",
+      "description": "Run quality gates to check code quality and security.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "gate": {
+            "type": "string",
+            "enum": [
+              "pre-commit",
+              "pre-push",
+              "pre-deploy"
+            ],
+            "description": "Quality gate to run"
+          }
+        },
+        "required": [
+          "gate"
+        ]
+      }
+    },
+    {
+      "name": "bootspring_dashboard",
+      "description": "Get dashboard status or start URL.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "type": "string",
+            "enum": [
+              "status",
+              "url"
+            ],
+            "description": "Action: status or url"
+          }
+        },
+        "required": []
+      }
+    },
+    {
+      "name": "bootspring_plugin",
+      "description": "Manage plugins. List, enable, disable, or show plugin details.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "type": "string",
+            "enum": [
+              "list",
+              "show",
+              "enable",
+              "disable"
+            ],
+            "description": "Action: list, show, enable, or disable"
+          },
+          "name": {
+            "type": "string",
+            "description": "Plugin name (e.g., auth, payments, database)"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      }
+    },
+    {
+      "name": "bootspring_capabilities",
+      "description": "Return capability manifest for assistant clients (tools, premium access, workflow packs, telemetry events).",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "mode": {
+            "type": "string",
+            "enum": [
+              "local",
+              "server"
+            ],
+            "description": "Optional access mode override"
+          },
+          "tier": {
+            "type": "string",
+            "description": "Optional tier override: free, pro, team, enterprise"
+          },
+          "entitled": {
+            "type": "boolean",
+            "description": "Optional entitlement override"
+          },
+          "client": {
+            "type": "string",
+            "description": "Optional client label (e.g., claude-code, codex)"
+          }
+        },
+        "required": []
+      }
+    },
+    {
+      "name": "bootspring_telemetry",
+      "description": "Inspect and upload Bootspring telemetry events.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "type": "string",
+            "enum": [
+              "status",
+              "list",
+              "upload",
+              "clear"
+            ],
+            "description": "Action: status, list, upload, or clear"
+          },
+          "event": {
+            "type": "string",
+            "description": "Optional event filter"
+          },
+          "limit": {
+            "type": "number",
+            "description": "Optional event limit for list/upload"
+          },
+          "endpoint": {
+            "type": "string",
+            "description": "Optional upload endpoint override"
+          },
+          "token": {
+            "type": "string",
+            "description": "Optional upload bearer token override"
+          },
+          "clearOnSuccess": {
+            "type": "boolean",
+            "description": "For action=upload, clear local events on success"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      }
+    },
+    {
+      "name": "bootspring_orchestrator",
+      "description": "Intelligent agent coordination. Analyze context, suggest agents, manage workflows.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "type": "string",
+            "enum": [
+              "analyze",
+              "suggest",
+              "recommend",
+              "workflows",
+              "workflow",
+              "start",
+              "next",
+              "checkpoint",
+              "status"
+            ],
+            "description": "Action: analyze context, suggest agents, recommend workflows/skills, list workflows, show workflow, start/advance workflow, or status"
+          },
+          "context": {
+            "type": "string",
+            "description": "Context text to analyze (for analyze/suggest actions)"
+          },
+          "workflow": {
+            "type": "string",
+            "description": "Workflow name (for workflow action)"
+          },
+          "signal": {
+            "type": "string",
+            "description": "Completion signal ref for action=checkpoint (exact text, partial text, or 1-based index)"
+          },
+          "limit": {
+            "type": "number",
+            "description": "Max recommendations to return for action=recommend (default: 5)"
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "local",
+              "server"
+            ],
+            "description": "Optional entitlement mode override"
+          },
+          "entitled": {
+            "type": "boolean",
+            "description": "Optional entitlement override for premium workflows"
+          },
+          "tier": {
+            "type": "string",
+            "description": "Optional tier override: free, pro, team, enterprise"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      }
+    },
+    {
+      "name": "bootspring_loop",
+      "description": "Autonomous task loop management. Create PRDs, check status, manage iterative task execution.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "type": "string",
+            "enum": [
+              "status",
+              "next",
+              "complete",
+              "create",
+              "progress"
+            ],
+            "description": "Action: status (PRD overview), next (get next story), complete (mark done), create (new PRD), progress (summary)"
+          },
+          "name": {
+            "type": "string",
+            "description": "PRD or story name (for create/complete actions)"
+          },
+          "storyId": {
+            "type": "string",
+            "description": "Story ID to mark complete"
+          },
+          "prdPath": {
+            "type": "string",
+            "description": "Path to prd.json (default: tasks/prd.json)"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      }
+    },
+    {
+      "name": "bootspring_memory",
+      "description": "Access git-based project memory. Extract learnings, search history, get file-specific context.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "type": "string",
+            "enum": [
+              "summary",
+              "search",
+              "files",
+              "stats"
+            ],
+            "description": "Action: summary (categorized learnings), search (by keyword), files (for specific files), stats (repo overview)"
+          },
+          "query": {
+            "type": "string",
+            "description": "Search query (for search action)"
+          },
+          "files": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "File paths to get learnings for (for files action)"
+          },
+          "limit": {
+            "type": "number",
+            "description": "Max learnings to return (default: 20)"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      }
+    }
+  ],
+  "resources": [
+    {
+      "uri": "bootspring://context/project",
+      "name": "Project Context",
+      "description": "Current project context and configuration",
+      "mimeType": "application/json"
+    },
+    {
+      "uri": "bootspring://context/claude.md",
+      "name": "CLAUDE.md Content",
+      "description": "Generated AI context file",
+      "mimeType": "text/markdown"
+    },
+    {
+      "uri": "bootspring://context/todo.md",
+      "name": "Todo List",
+      "description": "Project todo list",
+      "mimeType": "text/markdown"
+    },
+    {
+      "uri": "bootspring://agents/list",
+      "name": "Agent List",
+      "description": "Available specialized agents",
+      "mimeType": "application/json"
+    }
+  ]
+}