@mbc-cqrs-serverless/mcp-server 1.0.15

package/dist/prompts/cqrs-guide.js

@@ -0,0 +1,467 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCqrsPrompts = getCqrsPrompts;
+exports.getCqrsPromptMessages = getCqrsPromptMessages;
+/**
+ * CQRS implementation guide prompts.
+ */
+function getCqrsPrompts() {
+    return [
+        {
+            name: 'cqrs_implementation_guide',
+            description: 'Get guidance on implementing CQRS patterns with MBC CQRS Serverless framework',
+            arguments: [
+                {
+                    name: 'feature_type',
+                    description: 'Type of feature to implement (module, entity, command, query, event)',
+                    required: true,
+                },
+                {
+                    name: 'feature_name',
+                    description: 'Name of the feature (e.g., "Order", "Product")',
+                    required: true,
+                },
+            ],
+        },
+        {
+            name: 'debug_command_error',
+            description: 'Get help debugging command-related errors',
+            arguments: [
+                {
+                    name: 'error_message',
+                    description: 'The error message you encountered',
+                    required: true,
+                },
+                {
+                    name: 'operation',
+                    description: 'The operation being performed (create, update, delete)',
+                    required: false,
+                },
+            ],
+        },
+        {
+            name: 'migration_guide',
+            description: 'Get guidance on migrating between framework versions',
+            arguments: [
+                {
+                    name: 'from_version',
+                    description: 'Current version',
+                    required: true,
+                },
+                {
+                    name: 'to_version',
+                    description: 'Target version',
+                    required: true,
+                },
+            ],
+        },
+    ];
+}
+function getCqrsPromptMessages(name, args) {
+    const safeArgs = args || {};
+    switch (name) {
+        case 'cqrs_implementation_guide':
+            return getImplementationGuideMessages(safeArgs.feature_type || 'module', safeArgs.feature_name || 'Example');
+        case 'debug_command_error':
+            return getDebugCommandMessages(safeArgs.error_message || 'Unknown error', safeArgs.operation);
+        case 'migration_guide':
+            return getMigrationGuideMessages(safeArgs.from_version || '0.1.0', safeArgs.to_version || 'latest');
+        default:
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: { type: 'text', text: `Unknown prompt: ${name}` },
+                    },
+                ],
+            };
+    }
+}
+function getImplementationGuideMessages(featureType, featureName) {
+    const guides = {
+        module: `# Implementing a ${featureName} Module
+
+## Steps
+
+1. **Generate the module structure**:
+   \`\`\`bash
+   mbc generate module ${featureName.toLowerCase()}
+   \`\`\`
+
+2. **Define the entity** in \`src/${featureName.toLowerCase()}/entities/${featureName.toLowerCase()}.entity.ts\`:
+   \`\`\`typescript
+   import { CommandEntity, DataEntity } from '@mbc-cqrs-serverless/core'
+
+   export class ${featureName}CommandEntity extends CommandEntity {
+     // Add your command-specific fields
+     name: string
+     // ... other fields
+   }
+
+   export class ${featureName}DataEntity extends DataEntity {
+     // Add your read model fields
+     name: string
+     // ... other fields
+   }
+   \`\`\`
+
+3. **Create DTOs** for request validation
+
+4. **Implement the service** with CommandService injection
+
+5. **Register the module** in your AppModule
+
+## Key Patterns
+
+- Use CommandService for write operations
+- Use DataService for read operations
+- Implement optimistic locking with version field
+- Handle events for side effects`,
+        entity: `# Implementing a ${featureName} Entity
+
+## Command Entity (Write Model)
+
+\`\`\`typescript
+import { CommandEntity, CommandModel } from '@mbc-cqrs-serverless/core'
+
+export class ${featureName}CommandEntity extends CommandEntity implements CommandModel {
+  pk: string      // Partition key
+  sk: string      // Sort key
+  id: string      // Unique identifier
+  code: string    // Business code
+  name: string    // Display name
+  version: number // For optimistic locking
+  tenantCode: string
+
+  // Add your business fields
+  // ...
+}
+\`\`\`
+
+## Data Entity (Read Model)
+
+\`\`\`typescript
+import { DataEntity, DataModel } from '@mbc-cqrs-serverless/core'
+
+export class ${featureName}DataEntity extends DataEntity implements DataModel {
+  pk: string
+  sk: string
+  id: string
+  code: string
+  name: string
+
+  // Denormalized fields for efficient queries
+  // ...
+}
+\`\`\`
+
+## Key Points
+
+- Command entity stores the write model (event sourced)
+- Data entity stores the read model (denormalized)
+- Use proper key patterns: \`pk: 'ENTITY#tenantCode'\`, \`sk: 'ENTITY#id'\``,
+        command: `# Implementing Commands for ${featureName}
+
+## Using CommandService
+
+\`\`\`typescript
+import { CommandService } from '@mbc-cqrs-serverless/core'
+
+@Injectable()
+export class ${featureName}Service {
+  constructor(private readonly commandService: CommandService) {}
+
+  // Create (Async - returns immediately, processes in background)
+  async createAsync(dto: Create${featureName}Dto, options: IInvoke) {
+    const entity = new ${featureName}CommandEntity()
+    entity.pk = \`${featureName.toUpperCase()}#\${options.tenantCode}\`
+    entity.sk = \`${featureName.toUpperCase()}#\${ulid()}\`
+    // ... set other fields
+
+    return this.commandService.publishAsync(entity, options)
+  }
+
+  // Create (Sync - waits for completion)
+  async createSync(dto: Create${featureName}Dto, options: IInvoke) {
+    const entity = new ${featureName}CommandEntity()
+    // ... same setup
+
+    return this.commandService.publishSync(entity, options)
+  }
+
+  // Update with optimistic locking
+  async update(dto: Update${featureName}Dto, options: IInvoke) {
+    return this.commandService.publishPartialUpdateAsync({
+      pk: dto.pk,
+      sk: dto.sk,
+      version: dto.version, // Must match current version
+      name: dto.name,
+      // ... partial updates
+    }, options)
+  }
+}
+\`\`\`
+
+## Sync vs Async
+
+- **Async**: Better performance, eventual consistency
+- **Sync**: Immediate consistency, slower`,
+        query: `# Implementing Queries for ${featureName}
+
+## Using DataService
+
+\`\`\`typescript
+import { DataService, SearchDto } from '@mbc-cqrs-serverless/core'
+
+@Injectable()
+export class ${featureName}QueryService {
+  constructor(private readonly dataService: DataService) {}
+
+  // Get single item
+  async getById(pk: string, sk: string) {
+    return this.dataService.getItem({ pk, sk })
+  }
+
+  // List with pagination
+  async list(searchDto: SearchDto, tenantCode: string) {
+    return this.dataService.listItemsByPk(
+      \`${featureName.toUpperCase()}#\${tenantCode}\`,
+      searchDto
+    )
+  }
+
+  // Search with filters
+  async search(searchDto: SearchDto, tenantCode: string) {
+    return this.dataService.searchItems({
+      pk: \`${featureName.toUpperCase()}#\${tenantCode}\`,
+      ...searchDto,
+    })
+  }
+}
+\`\`\`
+
+## Key Points
+
+- DataService reads from the denormalized read model
+- Use pagination for large result sets
+- Implement search filters as needed`,
+        event: `# Implementing Events for ${featureName}
+
+## Event Handler
+
+\`\`\`typescript
+import { IEventHandler } from '@mbc-cqrs-serverless/core'
+
+@Injectable()
+export class ${featureName}CreatedHandler implements IEventHandler {
+  constructor(
+    private readonly notificationService: NotificationService,
+  ) {}
+
+  async execute(event: CommandEntity): Promise<void> {
+    // Handle ${featureName} created event
+    // - Send notifications
+    // - Update related data
+    // - Trigger workflows
+
+    await this.notificationService.send({
+      type: '${featureName.toLowerCase()}_created',
+      data: event,
+    })
+  }
+}
+\`\`\`
+
+## Data Sync Handler
+
+\`\`\`typescript
+import { IDataSyncHandler, DataEntity } from '@mbc-cqrs-serverless/core'
+
+@Injectable()
+export class ${featureName}DataSyncHandler implements IDataSyncHandler {
+  async sync(command: CommandEntity): Promise<DataEntity> {
+    // Transform command to data entity
+    const data = new ${featureName}DataEntity()
+    data.pk = command.pk
+    data.sk = command.sk
+    // ... map fields
+
+    return data
+  }
+}
+\`\`\``,
+    };
+    const guide = guides[featureType] || `Unknown feature type: ${featureType}. Valid types are: module, entity, command, query, event`;
+    return {
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `I want to implement a ${featureType} called "${featureName}" using MBC CQRS Serverless framework. Please provide guidance.`,
+                },
+            },
+            {
+                role: 'assistant',
+                content: {
+                    type: 'text',
+                    text: guide,
+                },
+            },
+        ],
+    };
+}
+function getDebugCommandMessages(errorMessage, operation) {
+    const operationContext = operation ? ` during ${operation} operation` : '';
+    return {
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `I'm getting this error${operationContext} with MBC CQRS Serverless:
+
+\`\`\`
+${errorMessage}
+\`\`\`
+
+How can I debug and fix this?`,
+                },
+            },
+            {
+                role: 'assistant',
+                content: {
+                    type: 'text',
+                    text: `# Debugging Command Error
+
+## Error Analysis
+
+The error "${errorMessage}" typically occurs in these scenarios:
+
+### Common Causes
+
+1. **Version Mismatch (Optimistic Locking)**
+   - You're trying to update an item with an outdated version
+   - Solution: Fetch the latest version before updating
+
+2. **Item Not Found**
+   - The pk/sk combination doesn't exist
+   - Solution: Verify the keys are correct
+
+3. **Validation Error**
+   - Request data doesn't match DTO validation
+   - Solution: Check your DTO decorators
+
+### Debugging Steps
+
+1. **Check the request data**:
+   \`\`\`typescript
+   console.log('Request:', JSON.stringify(request, null, 2))
+   \`\`\`
+
+2. **Verify item exists**:
+   \`\`\`typescript
+   const existing = await dataService.getItem({ pk, sk })
+   console.log('Existing item:', existing)
+   \`\`\`
+
+3. **Check version**:
+   \`\`\`typescript
+   // Current item version
+   console.log('Version:', existing?.version)
+   // Your request version
+   console.log('Request version:', dto.version)
+   \`\`\`
+
+### Quick Fixes
+
+\`\`\`typescript
+// Auto-fetch latest version (async mode)
+await commandService.publishPartialUpdateAsync({
+  pk, sk,
+  version: -1, // Auto-fetches latest
+  name: 'Updated',
+}, options)
+
+// Or fetch and use latest (sync mode)
+const latest = await dataService.getItem({ pk, sk })
+await commandService.publishPartialUpdateSync({
+  pk, sk,
+  version: latest.version,
+  name: 'Updated',
+}, options)
+\`\`\`
+
+Use the \`mbc_lookup_error\` tool for specific error solutions.`,
+                },
+            },
+        ],
+    };
+}
+function getMigrationGuideMessages(fromVersion, toVersion) {
+    return {
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `I need to migrate my MBC CQRS Serverless project from version ${fromVersion} to ${toVersion}. What do I need to know?`,
+                },
+            },
+            {
+                role: 'assistant',
+                content: {
+                    type: 'text',
+                    text: `# Migration Guide: ${fromVersion} to ${toVersion}
+
+## General Migration Steps
+
+1. **Update dependencies**:
+   \`\`\`bash
+   npm update @mbc-cqrs-serverless/core @mbc-cqrs-serverless/cli
+   \`\`\`
+
+2. **Check for breaking changes** in the CHANGELOG.md
+
+3. **Update imports** if API has changed
+
+4. **Run tests** to verify everything works
+
+## Common Migration Issues
+
+### Interface Changes
+- Check if CommandEntity/DataEntity interfaces have new required fields
+- Update your entities accordingly
+
+### Configuration Changes
+- Review CommandModuleOptions for new options
+- Check environment variables
+
+### Deprecated Features
+- Look for deprecation warnings in build output
+- Replace deprecated APIs with recommended alternatives
+
+## Verification
+
+1. Build the project:
+   \`\`\`bash
+   npm run build
+   \`\`\`
+
+2. Run tests:
+   \`\`\`bash
+   npm test
+   \`\`\`
+
+3. Test locally:
+   \`\`\`bash
+   npm run offline
+   \`\`\`
+
+For specific version migration details, check the CHANGELOG.md in the framework repository.`,
+                },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=cqrs-guide.js.map

package/dist/prompts/cqrs-guide.js.map

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

package/dist/prompts/index.d.ts

@@ -0,0 +1,11 @@
+import { Prompt, PromptMessage } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Register all available prompts.
+ */
+export declare function registerPrompts(): Prompt[];
+/**
+ * Handle prompt get requests.
+ */
+export declare function handlePromptGet(name: string, args?: Record<string, string>): {
+    messages: PromptMessage[];
+};

package/dist/prompts/index.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPrompts = registerPrompts;
+exports.handlePromptGet = handlePromptGet;
+const cqrs_guide_js_1 = require("./cqrs-guide.js");
+/**
+ * Register all available prompts.
+ */
+function registerPrompts() {
+    return [
+        ...(0, cqrs_guide_js_1.getCqrsPrompts)(),
+    ];
+}
+/**
+ * Handle prompt get requests.
+ */
+function handlePromptGet(name, args) {
+    const safeArgs = args || {};
+    // CQRS prompts
+    const cqrsPromptNames = ['cqrs_implementation_guide', 'debug_command_error', 'migration_guide'];
+    if (cqrsPromptNames.includes(name)) {
+        return (0, cqrs_guide_js_1.getCqrsPromptMessages)(name, safeArgs);
+    }
+    return {
+        messages: [
+            {
+                role: 'user',
+                content: { type: 'text', text: `Unknown prompt: ${name}` },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":";;AAMA,0CAIC;AAKD,0CAoBC;AAlCD,mDAAuE;AAEvE;;GAEG;AACH,SAAgB,eAAe;IAC7B,OAAO;QACL,GAAG,IAAA,8BAAc,GAAE;KACpB,CAAA;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAC7B,IAAY,EACZ,IAA6B;IAE7B,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAA;IAE3B,eAAe;IACf,MAAM,eAAe,GAAG,CAAC,2BAA2B,EAAE,qBAAqB,EAAE,iBAAiB,CAAC,CAAA;IAC/F,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,OAAO,IAAA,qCAAqB,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC9C,CAAC;IAED,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,IAAI,EAAE,EAAE;aAC3D;SACF;KACF,CAAA;AACH,CAAC"}

package/dist/resources/documentation.d.ts

@@ -0,0 +1,12 @@
+import { Resource } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Documentation resources for MBC CQRS Serverless framework.
+ */
+export declare function getDocumentationResources(): Resource[];
+export declare function readDocumentation(uri: string): Promise<{
+    contents: {
+        uri: string;
+        mimeType: string;
+        text: string;
+    }[];
+}>;

package/dist/resources/documentation.js

@@ -0,0 +1,131 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDocumentationResources = getDocumentationResources;
+exports.readDocumentation = readDocumentation;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Documentation resources for MBC CQRS Serverless framework.
+ */
+function getDocumentationResources() {
+    return [
+        {
+            uri: 'mbc://docs/overview',
+            name: 'Framework Overview',
+            description: 'Complete documentation of MBC CQRS Serverless framework including architecture, APIs, and usage examples',
+            mimeType: 'text/plain',
+        },
+        {
+            uri: 'mbc://docs/llms-short',
+            name: 'Framework Summary',
+            description: 'Concise summary of MBC CQRS Serverless framework for quick reference',
+            mimeType: 'text/plain',
+        },
+        {
+            uri: 'mbc://docs/architecture',
+            name: 'Architecture Guide',
+            description: 'CQRS and Event Sourcing architecture patterns used in the framework',
+            mimeType: 'text/markdown',
+        },
+        {
+            uri: 'mbc://docs/faq',
+            name: 'FAQ',
+            description: 'Frequently asked questions about the framework',
+            mimeType: 'text/markdown',
+        },
+        {
+            uri: 'mbc://docs/troubleshooting',
+            name: 'Troubleshooting Guide',
+            description: 'Common issues and their solutions',
+            mimeType: 'text/markdown',
+        },
+        {
+            uri: 'mbc://docs/security',
+            name: 'Security Best Practices',
+            description: 'Security guidelines and best practices for the framework',
+            mimeType: 'text/markdown',
+        },
+    ];
+}
+async function readDocumentation(uri) {
+    const frameworkRoot = path.resolve(__dirname, '../../../../..');
+    let content;
+    let mimeType = 'text/plain';
+    switch (uri) {
+        case 'mbc://docs/overview':
+            content = await readFileContent(path.join(frameworkRoot, 'llms-full.txt'));
+            break;
+        case 'mbc://docs/llms-short':
+            content = await readFileContent(path.join(frameworkRoot, 'llms.txt'));
+            break;
+        case 'mbc://docs/architecture':
+            content = await readFileContent(path.join(frameworkRoot, 'docs', 'ARCHITECTURE.md'));
+            mimeType = 'text/markdown';
+            break;
+        case 'mbc://docs/faq':
+            content = await readFileContent(path.join(frameworkRoot, 'docs', 'FAQ.md'));
+            mimeType = 'text/markdown';
+            break;
+        case 'mbc://docs/troubleshooting':
+            content = await readFileContent(path.join(frameworkRoot, 'docs', 'TROUBLESHOOTING.md'));
+            mimeType = 'text/markdown';
+            break;
+        case 'mbc://docs/security':
+            content = await readFileContent(path.join(frameworkRoot, 'SECURITY.md'));
+            mimeType = 'text/markdown';
+            break;
+        default:
+            throw new Error(`Unknown documentation resource: ${uri}`);
+    }
+    return {
+        contents: [
+            {
+                uri,
+                mimeType,
+                text: content,
+            },
+        ],
+    };
+}
+async function readFileContent(filePath) {
+    try {
+        return fs.readFileSync(filePath, 'utf-8');
+    }
+    catch (error) {
+        return `Error reading file: ${filePath}. File may not exist.`;
+    }
+}
+//# sourceMappingURL=documentation.js.map

package/dist/resources/documentation.js.map

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

package/dist/resources/errors.d.ts

@@ -0,0 +1,12 @@
+import { Resource } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Error catalog resources for MBC CQRS Serverless framework.
+ */
+export declare function getErrorResources(): Resource[];
+export declare function readErrorCatalog(uri: string): Promise<{
+    contents: {
+        uri: string;
+        mimeType: string;
+        text: string;
+    }[];
+}>;