@specforge/mcp 2.2.0 → 2.4.0

package/dist/cli/templates/content/sf-create-spec.js

@@ -5,7 +5,7 @@
  */
 export const SF_CREATE_SPEC_CONTENT = `# Create Specification (SpecForge)
 
-Create a SpecForge specification structure with patterns extracted from a plan document.
+Create a SpecForge specification structure with metadata extracted from a plan document.
 
 ## Arguments
 - \`$ARGUMENTS\` - Required: Path to plan markdown file
@@ -16,21 +16,75 @@ Create a SpecForge specification structure with patterns extracted from a plan d
 
 **Logic:**
 - Read file at $ARGUMENTS
-- Extract specification metadata
-- Identify patterns and guardrails
-- Parse high-level structure
-- Extract success criteria
+- Extract specification title and description
+- Identify priority level (high/medium/low)
+- Parse tags from plan categories/themes
+- Extract goals, requirements, and constraints
 
 ### 2. Create Specification
 
 **MCP Calls:**
 \`\`\`typescript
-create_specification({
+specification({
+  operation: 'create',
+
+  // === REQUIRED ===
+  projectId: currentProjectId,
   title: extractedTitle,
-  description: extractedDescription,
-  patterns: extractedPatterns,
-  guardrails: extractedGuardrails,
-  successCriteria: extractedCriteria
+
+  // === CORE (recommended) ===
+  description: shortSummary,        // 2-3 sentence summary
+  content: fullMarkdownContent,     // Full markdown content
+  background: problemContext,       // Why this exists
+  scope: scopeDefinition,           // What's in/out of scope
+  priority: 'high',                 // high | medium | low
+  tags: ['feature', 'api'],
+  estimatedHours: 40,
+  targetAudience: 'developers',
+
+  // === GOALS & REQUIREMENTS ===
+  goals: ['Enable X', 'Improve Y'],
+  requirements: ['Must do A', 'Must support B'],
+  nonFunctionalRequirements: ['< 100ms latency', '99.9% uptime'],
+  acceptanceCriteria: ['Users can X', 'System handles Y'],
+  successMetrics: ['50% reduction in Z'],
+
+  // === GUARDRAILS & RISKS ===
+  guardrails: ['Do NOT modify X', 'Avoid pattern Y'],
+  constraints: ['Must use existing auth', 'Budget limit'],
+  assumptions: ['Users have Node 18+'],
+  risks: ['Third-party API may change'],
+
+  // === TECHNICAL ===
+  architecture: 'Microservices with event-driven communication',
+  fileStructure: 'src/\\n  components/\\n  services/\\n  utils/',
+  techStack: ['typescript', 'react', 'node'],
+  dependencies: ['@aws-sdk/client-s3', 'zod'],
+  apiContracts: { endpoints: [{ path: '/api/v1/users', method: 'GET' }] },
+
+  // === PATTERN INHERITANCE (for epics/tickets) ===
+  codeStandards: {
+    errorHandling: 'Use Result<T, E> pattern',
+    naming: 'camelCase for functions, PascalCase for types'
+  },
+  commonImports: [
+    "import { logger } from '@/lib/logger'",
+    "import { db } from '@/lib/db'"
+  ],
+  returnTypes: {
+    success: '{ success: true, data: T }',
+    error: '{ success: false, error: string }'
+  },
+
+  // === VALIDATION (for CI/CD) ===
+  validationCommands: {
+    test: 'npm test',
+    lint: 'npm run lint',
+    build: 'npm run build',
+    typeCheck: 'npm run typecheck'
+  },
+  workingDirectory: './src',
+  outputDirectory: './dist'
 })
 \`\`\`
 
@@ -41,27 +95,42 @@ create_specification({
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 SPECIFICATION CREATED
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-Title: {title}
-ID:    {specificationId}
+Title:    {title}
+ID:       {specificationId}
+Priority: {priority}
 
-EXTRACTED PATTERNS
+DESCRIPTION
 ─────────────────────────────────────────────────────────────────
-• {pattern1}
-• {pattern2}
-• {pattern3}
+{description}
 
-GUARDRAILS
+TAGS
 ─────────────────────────────────────────────────────────────────
-• {guardrail1}
-• {guardrail2}
+{tags}
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 Next: Run /sf-create-epics {specificationId} to create epics
 \`\`\`
 
+## Field Reference
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| projectId | ✅ | Project to create spec in |
+| title | ✅ | Specification title |
+| description | | Short summary |
+| content | | Full markdown content |
+| background | | Problem context |
+| scope | | In/out of scope |
+| goals | | Business objectives |
+| requirements | | Functional requirements |
+| guardrails | | What NOT to do |
+| architecture | | System design |
+| techStack | | Technologies used |
+| codeStandards | | Inherited by epics/tickets |
+
 ## Notes
-- Creates specification structure only
-- Extracts patterns for epic/ticket creation
-- Use /sf-create-epics to add epics
+- Only projectId and title are required
+- codeStandards, commonImports, returnTypes are inherited by child epics/tickets
+- Use /sf-create-epics to add epics after creation
 `;
 //# sourceMappingURL=sf-create-spec.js.map

package/dist/cli/templates/content/sf-create-spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"sf-create-spec.js","sourceRoot":"","sources":["../../../../src/cli/templates/content/sf-create-spec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4DrC,CAAC"}
+{"version":3,"file":"sf-create-spec.js","sourceRoot":"","sources":["../../../../src/cli/templates/content/sf-create-spec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiIrC,CAAC"}

package/dist/cli/templates/content/sf-create-tickets.d.ts

@@ -3,5 +3,5 @@
  *
  * Template for creating detailed tickets individually with full implementation context.
  */
-export declare const SF_CREATE_TICKETS_CONTENT = "# Create Tickets (SpecForge)\n\nCreate detailed tickets for an epic with full implementation context.\n\n## Arguments\n- `$ARGUMENTS` - Required: Epic ID\n\n## Task\n\n### 1. Get Epic Context\n\n**MCP Calls:**\n```typescript\nget_epic($ARGUMENTS)\nget_specification(epic.specificationId)\n```\n\n### 2. Extract Ticket Definitions\n\n**Logic:**\n- Read epic description and patterns\n- Parse task breakdown\n- Extract dependencies\n- Generate acceptance criteria\n- Add implementation guidance\n\n### 3. Create Tickets\n\n**MCP Calls:**\n```typescript\n// For each task in epic\nfor (const task of tasks) {\n  await create_ticket({\n    epicId: $ARGUMENTS,\n    title: task.title,\n    description: task.description,\n    acceptanceCriteria: task.criteria,\n    dependencies: task.dependencies,\n    implementationGuidance: task.guidance,\n    estimatedComplexity: task.complexity\n  })\n}\n```\n\n### 4. Display Creation Results\n\n**Output:**\n```\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\nTICKETS CREATED\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\nEpic: E{n} - {epicTitle}\n\nCREATED TICKETS\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nE{n}-T1  \u2502 {title} \u2502 {complexity}\nE{n}-T2  \u2502 {title} \u2502 {complexity} \u2502 Depends: E{n}-T1\nE{n}-T3  \u2502 {title} \u2502 {complexity}\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\nTotal: {ticketCount} tickets created\n\nNext: Run /sf-status to see overall progress\n```\n\n## Notes\n- Creates tickets with full implementation details\n- Establishes dependency relationships\n- Use /sf-next to start implementation\n";
+export declare const SF_CREATE_TICKETS_CONTENT = "# Create Tickets (SpecForge)\n\nCreate detailed tickets for an epic with full implementation context.\n\n## Arguments\n- `$ARGUMENTS` - Required: Epic ID\n\n## Task\n\n### 1. Get Epic Context\n\n**MCP Calls:**\n```typescript\nepic({\n  operation: 'get',\n  epicId: $ARGUMENTS,\n  include: ['tickets', 'specification']  // Get existing tickets and parent spec\n})\n```\n\n### 2. Extract Ticket Definitions\n\n**Logic:**\n- Read epic description and objective\n- Parse task breakdown from epic content\n- Determine complexity and dependencies\n- Extract acceptance criteria for each ticket\n\n### 3. Create Tickets\n\n**MCP Calls:**\n```typescript\n// For each task in epic\nfor (const task of tasks) {\n  await ticket({\n    operation: 'create',\n\n    // === REQUIRED ===\n    epicId: $ARGUMENTS,\n    title: task.title,\n\n    // === CORE (recommended) ===\n    description: task.description,\n    priority: 'high',               // high | medium | low\n    complexity: 'medium',           // small | medium | large | xlarge\n    estimatedHours: 4,\n    tags: ['feature', 'api'],\n    notes: 'Watch out for edge case X',  // Warnings, considerations\n\n    // === ACCEPTANCE CRITERIA ===\n    acceptanceCriteria: [\n      'Function returns correct result for valid input',\n      'Function throws error for invalid input',\n      'Unit tests cover all branches'\n    ],\n\n    // === IMPLEMENTATION GUIDANCE ===\n    implementation: {\n      filesToCreate: ['src/services/user.service.ts'],\n      filesToModify: ['src/index.ts'],\n      steps: [\n        'Create UserService class',\n        'Implement createUser method',\n        'Add validation with zod',\n        'Write unit tests'\n      ],\n      testing: 'Use vitest with mocked database'\n    },\n    technicalDetails: {\n      approach: 'Repository pattern with dependency injection',\n      stack: ['typescript', 'prisma', 'zod'],\n      endpoints: ['/api/users POST'],\n      databaseChanges: ['Add users table']\n    },\n\n    // === CODE REFERENCES ===\n    codeReferences: [{\n      name: 'createUser',\n      language: 'typescript',\n      code: `async function createUser(data: CreateUserInput): Promise<User> {\n  const validated = createUserSchema.parse(data);\n  return await db.user.create({ data: validated });\n}`\n    }],\n    typeReferences: [{\n      name: 'CreateUserInput',\n      definition: `interface CreateUserInput {\n  email: string;\n  name: string;\n  role?: 'admin' | 'user';\n}`\n    }],\n\n    // === DEPENDENCIES ===\n    dependsOn: ['ticket-id-1', 'ticket-id-2']  // Must complete these first\n  })\n}\n```\n\n### 4. Display Creation Results\n\n**Output:**\n```\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\nTICKETS CREATED\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\nEpic: E{n} - {epicTitle}\n\nCREATED TICKETS\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nE{n}-T1  \u2502 {title} \u2502 {complexity} \u2502 ready\nE{n}-T2  \u2502 {title} \u2502 {complexity} \u2502 pending (depends on T1)\nE{n}-T3  \u2502 {title} \u2502 {complexity} \u2502 ready\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\nTotal: {ticketCount} tickets created\n\nNext: Run /sf-status to see overall progress\n```\n\n## Field Reference\n\n| Field | Required | Description |\n|-------|----------|-------------|\n| epicId | \u2705 | Parent epic |\n| title | \u2705 | Ticket title |\n| description | | What to implement |\n| complexity | | small \\| medium \\| large \\| xlarge |\n| acceptanceCriteria | | Success criteria (array of strings) |\n| implementation | | Steps, files to create/modify |\n| technicalDetails | | Approach, stack, endpoints |\n| codeReferences | | Code snippets to guide implementation |\n| typeReferences | | Type definitions to implement |\n| dependsOn | | Ticket IDs that must complete first |\n| notes | | Warnings, edge cases, considerations |\n\n## Notes\n- Only epicId and title are required\n- Tickets with dependsOn start as 'pending', others as 'ready'\n- codeReferences and typeReferences provide implementation guidance\n- Use /sf-next to start working on ready tickets\n";
 //# sourceMappingURL=sf-create-tickets.d.ts.map

package/dist/cli/templates/content/sf-create-tickets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sf-create-tickets.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/content/sf-create-tickets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,yBAAyB,upFAqErC,CAAC"}
+{"version":3,"file":"sf-create-tickets.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/content/sf-create-tickets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,yBAAyB,4kKA6IrC,CAAC"}

package/dist/cli/templates/content/sf-create-tickets.js

@@ -16,18 +16,20 @@ Create detailed tickets for an epic with full implementation context.
 
 **MCP Calls:**
 \`\`\`typescript
-get_epic($ARGUMENTS)
-get_specification(epic.specificationId)
+epic({
+  operation: 'get',
+  epicId: $ARGUMENTS,
+  include: ['tickets', 'specification']  // Get existing tickets and parent spec
+})
 \`\`\`
 
 ### 2. Extract Ticket Definitions
 
 **Logic:**
-- Read epic description and patterns
-- Parse task breakdown
-- Extract dependencies
-- Generate acceptance criteria
-- Add implementation guidance
+- Read epic description and objective
+- Parse task breakdown from epic content
+- Determine complexity and dependencies
+- Extract acceptance criteria for each ticket
 
 ### 3. Create Tickets
 
@@ -35,14 +37,67 @@ get_specification(epic.specificationId)
 \`\`\`typescript
 // For each task in epic
 for (const task of tasks) {
-  await create_ticket({
+  await ticket({
+    operation: 'create',
+
+    // === REQUIRED ===
     epicId: $ARGUMENTS,
     title: task.title,
+
+    // === CORE (recommended) ===
     description: task.description,
-    acceptanceCriteria: task.criteria,
-    dependencies: task.dependencies,
-    implementationGuidance: task.guidance,
-    estimatedComplexity: task.complexity
+    priority: 'high',               // high | medium | low
+    complexity: 'medium',           // small | medium | large | xlarge
+    estimatedHours: 4,
+    tags: ['feature', 'api'],
+    notes: 'Watch out for edge case X',  // Warnings, considerations
+
+    // === ACCEPTANCE CRITERIA ===
+    acceptanceCriteria: [
+      'Function returns correct result for valid input',
+      'Function throws error for invalid input',
+      'Unit tests cover all branches'
+    ],
+
+    // === IMPLEMENTATION GUIDANCE ===
+    implementation: {
+      filesToCreate: ['src/services/user.service.ts'],
+      filesToModify: ['src/index.ts'],
+      steps: [
+        'Create UserService class',
+        'Implement createUser method',
+        'Add validation with zod',
+        'Write unit tests'
+      ],
+      testing: 'Use vitest with mocked database'
+    },
+    technicalDetails: {
+      approach: 'Repository pattern with dependency injection',
+      stack: ['typescript', 'prisma', 'zod'],
+      endpoints: ['/api/users POST'],
+      databaseChanges: ['Add users table']
+    },
+
+    // === CODE REFERENCES ===
+    codeReferences: [{
+      name: 'createUser',
+      language: 'typescript',
+      code: \`async function createUser(data: CreateUserInput): Promise<User> {
+  const validated = createUserSchema.parse(data);
+  return await db.user.create({ data: validated });
+}\`
+    }],
+    typeReferences: [{
+      name: 'CreateUserInput',
+      definition: \`interface CreateUserInput {
+  email: string;
+  name: string;
+  role?: 'admin' | 'user';
+}\`
+    }],
+
+    // === DEPENDENCIES ===
+    dependsOn: ['ticket-id-1', 'ticket-id-2']  // Must complete these first
   })
 }
 \`\`\`
@@ -58,9 +113,9 @@ Epic: E{n} - {epicTitle}
 
 CREATED TICKETS
 ─────────────────────────────────────────────────────────────────
-E{n}-T1  │ {title} │ {complexity}
-E{n}-T2  │ {title} │ {complexity} │ Depends: E{n}-T1
-E{n}-T3  │ {title} │ {complexity}
+E{n}-T1  │ {title} │ {complexity} │ ready
+E{n}-T2  │ {title} │ {complexity} │ pending (depends on T1)
+E{n}-T3  │ {title} │ {complexity} │ ready
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 Total: {ticketCount} tickets created
@@ -68,9 +123,26 @@ Total: {ticketCount} tickets created
 Next: Run /sf-status to see overall progress
 \`\`\`
 
+## Field Reference
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| epicId | ✅ | Parent epic |
+| title | ✅ | Ticket title |
+| description | | What to implement |
+| complexity | | small \\| medium \\| large \\| xlarge |
+| acceptanceCriteria | | Success criteria (array of strings) |
+| implementation | | Steps, files to create/modify |
+| technicalDetails | | Approach, stack, endpoints |
+| codeReferences | | Code snippets to guide implementation |
+| typeReferences | | Type definitions to implement |
+| dependsOn | | Ticket IDs that must complete first |
+| notes | | Warnings, edge cases, considerations |
+
 ## Notes
-- Creates tickets with full implementation details
-- Establishes dependency relationships
-- Use /sf-next to start implementation
+- Only epicId and title are required
+- Tickets with dependsOn start as 'pending', others as 'ready'
+- codeReferences and typeReferences provide implementation guidance
+- Use /sf-next to start working on ready tickets
 `;
 //# sourceMappingURL=sf-create-tickets.js.map

package/dist/cli/templates/content/sf-create-tickets.js.map

@@ -1 +1 @@
-{"version":3,"file":"sf-create-tickets.js","sourceRoot":"","sources":["../../../../src/cli/templates/content/sf-create-tickets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqExC,CAAC"}
+{"version":3,"file":"sf-create-tickets.js","sourceRoot":"","sources":["../../../../src/cli/templates/content/sf-create-tickets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6IxC,CAAC"}

package/dist/tools/core/blueprint.d.ts

@@ -0,0 +1,7 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { ConsolidatedToolArgs, OperationHandler } from './types.js';
+import { ApiClient } from '../../client/api-client.js';
+export declare const blueprintTool: Tool;
+export declare function createBlueprintOperations(apiClient: ApiClient): Record<string, OperationHandler>;
+export declare function createBlueprintHandler(apiClient: ApiClient): (args: ConsolidatedToolArgs, userId: string) => Promise<unknown>;
+//# sourceMappingURL=blueprint.d.ts.map

package/dist/tools/core/blueprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.d.ts","sourceRoot":"","sources":["../../../src/tools/core/blueprint.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD,eAAO,MAAM,aAAa,EAAE,IAgH3B,CAAC;AAUF,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAyFhG;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS,oEAG1D"}

package/dist/tools/core/blueprint.js

@@ -0,0 +1,210 @@
+// mcp/src/tools/core/blueprint.ts
+import { createOperationRouter } from './router.js';
+export const blueprintTool = {
+    name: 'blueprint',
+    description: `Manage specification blueprints (flowcharts, diagrams, mockups, ADRs). Operations:
+- create: Create a new blueprint for a specification
+- get: Get blueprint by ID with full content
+- update: Update blueprint fields
+- list: List blueprints for a specification (with optional category/status filters)
+- delete: Delete a blueprint and all its ticket references
+- link: Link a ticket to a blueprint for implementation context
+- unlink: Remove a ticket-blueprint link
+- get_for_ticket: Get all blueprints linked to a ticket`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['create', 'get', 'update', 'list', 'delete', 'link', 'unlink', 'get_for_ticket'],
+                description: 'The operation to perform',
+            },
+            // IDs
+            blueprintId: {
+                type: 'string',
+                description: 'Blueprint ID (for get, update, delete, link, unlink)',
+            },
+            specificationId: {
+                type: 'string',
+                description: 'Specification ID (for create, list)',
+            },
+            ticketId: {
+                type: 'string',
+                description: 'Ticket ID (for link, unlink, get_for_ticket)',
+            },
+            referenceId: {
+                type: 'string',
+                description: 'Reference ID (for unlink - alternative to ticketId+blueprintId)',
+            },
+            // Blueprint fields
+            title: {
+                type: 'string',
+                description: 'Blueprint title',
+            },
+            description: {
+                type: 'string',
+                description: 'Blueprint description',
+            },
+            slug: {
+                type: 'string',
+                description: 'URL-friendly identifier',
+            },
+            category: {
+                type: 'string',
+                enum: ['flowchart', 'architecture', 'state', 'sequence', 'erd', 'mockup', 'adr', 'component', 'deployment', 'api'],
+                description: 'Blueprint category type',
+            },
+            content: {
+                type: 'string',
+                description: 'The blueprint content (Mermaid syntax, markdown, or ASCII art)',
+            },
+            format: {
+                type: 'string',
+                enum: ['markdown', 'mermaid', 'ascii', 'mixed'],
+                description: 'Content format (default: mermaid)',
+            },
+            tags: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Categorization tags',
+            },
+            status: {
+                type: 'string',
+                enum: ['draft', 'review', 'approved', 'deprecated'],
+                description: 'Blueprint status',
+            },
+            order: {
+                type: 'number',
+                description: 'Display order within specification',
+            },
+            version: {
+                type: 'string',
+                description: 'Semantic version (e.g., "1.0.0")',
+            },
+            // Reference fields
+            context: {
+                type: 'string',
+                description: 'Why this blueprint is relevant to the ticket (for link)',
+            },
+            section: {
+                type: 'string',
+                description: 'Specific section in blueprint relevant to ticket (for link)',
+            },
+            // Response options
+            outputFormat: {
+                type: 'string',
+                enum: ['json', 'toon'],
+                description: 'Output format (default: json)',
+            },
+            includeContent: {
+                type: 'boolean',
+                description: 'Include full content in list results (default: false)',
+            },
+            // Pagination
+            limit: {
+                type: 'number',
+                description: 'Max items to return',
+            },
+            offset: {
+                type: 'number',
+                description: 'Number of items to skip',
+            },
+        },
+        required: ['operation'],
+    },
+};
+function validateRequired(args, ...fields) {
+    for (const field of fields) {
+        if (args[field] === undefined || args[field] === null || args[field] === '') {
+            throw new Error(`${field} is required`);
+        }
+    }
+}
+export function createBlueprintOperations(apiClient) {
+    return {
+        create: async (args, _userId) => {
+            validateRequired(args, 'specificationId', 'title');
+            return await apiClient.call('create_blueprint', {
+                specificationId: args.specificationId,
+                title: args.title,
+                description: args.description,
+                slug: args.slug,
+                category: args.category,
+                content: args.content,
+                format: args.format,
+                tags: args.tags,
+                status: args.status,
+                version: args.version,
+            });
+        },
+        get: async (args, _userId) => {
+            validateRequired(args, 'blueprintId');
+            return await apiClient.call('get_blueprint', {
+                blueprintId: args.blueprintId,
+            });
+        },
+        update: async (args, _userId) => {
+            validateRequired(args, 'blueprintId');
+            return await apiClient.call('update_blueprint', {
+                blueprintId: args.blueprintId,
+                title: args.title,
+                description: args.description,
+                slug: args.slug,
+                category: args.category,
+                content: args.content,
+                format: args.format,
+                tags: args.tags,
+                status: args.status,
+                order: args.order,
+                version: args.version,
+            });
+        },
+        list: async (args, _userId) => {
+            validateRequired(args, 'specificationId');
+            return await apiClient.call('list_blueprints', {
+                specificationId: args.specificationId,
+                category: args.category,
+                status: args.status,
+                limit: args.limit,
+                offset: args.offset,
+            });
+        },
+        delete: async (args, _userId) => {
+            validateRequired(args, 'blueprintId');
+            return await apiClient.call('delete_blueprint', {
+                blueprintId: args.blueprintId,
+            });
+        },
+        link: async (args, _userId) => {
+            validateRequired(args, 'ticketId', 'blueprintId');
+            return await apiClient.call('link_ticket_blueprint', {
+                ticketId: args.ticketId,
+                blueprintId: args.blueprintId,
+                context: args.context,
+                section: args.section,
+            });
+        },
+        unlink: async (args, _userId) => {
+            // Either referenceId or both ticketId and blueprintId required
+            if (!args.referenceId && (!args.ticketId || !args.blueprintId)) {
+                throw new Error('Either referenceId or both ticketId and blueprintId are required');
+            }
+            return await apiClient.call('unlink_ticket_blueprint', {
+                referenceId: args.referenceId,
+                ticketId: args.ticketId,
+                blueprintId: args.blueprintId,
+            });
+        },
+        get_for_ticket: async (args, _userId) => {
+            validateRequired(args, 'ticketId');
+            return await apiClient.call('get_ticket_blueprints', {
+                ticketId: args.ticketId,
+            });
+        },
+    };
+}
+export function createBlueprintHandler(apiClient) {
+    const operations = createBlueprintOperations(apiClient);
+    return createOperationRouter('blueprint', operations);
+}
+//# sourceMappingURL=blueprint.js.map

package/dist/tools/core/blueprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.js","sourceRoot":"","sources":["../../../src/tools/core/blueprint.ts"],"names":[],"mappings":"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"}

package/dist/tools/core/epic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"epic.d.ts","sourceRoot":"","sources":["../../../src/tools/core/epic.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD,eAAO,MAAM,QAAQ,EAAE,IAsFtB,CAAC;AAUF,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CA4D3F;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,oEAGrD"}
+{"version":3,"file":"epic.d.ts","sourceRoot":"","sources":["../../../src/tools/core/epic.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD,eAAO,MAAM,QAAQ,EAAE,IAmItB,CAAC;AAUF,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAmG3F;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,oEAGrD"}