specweave 0.18.0 → 0.20.0

package/dist/plugins/specweave-kafka/lib/mcp/detector.js

@@ -0,0 +1,316 @@
+/**
+ * MCP Server Detector
+ *
+ * Auto-detects installed and running MCP servers for Kafka integration.
+ * Supports: kanapuli, tuannvm, Joel-hanson, Confluent
+ */
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { MCPServerType, AuthMethod } from './types';
+const execAsync = promisify(exec);
+export class MCPServerDetector {
+    /**
+     * Detect all available MCP servers
+     */
+    async detectAll() {
+        const servers = [];
+        // Check each MCP server type
+        const checks = [
+            this.detectKanapuli(),
+            this.detectTuannvm(),
+            this.detectJoelHanson(),
+            this.detectConfluent()
+        ];
+        const results = await Promise.allSettled(checks);
+        results.forEach((result) => {
+            if (result.status === 'fulfilled' && result.value) {
+                servers.push(result.value);
+            }
+        });
+        // Rank servers (Confluent > tuannvm > kanapuli > Joel-hanson)
+        const recommended = this.rankServers(servers);
+        return {
+            servers,
+            recommended: recommended?.type || null,
+            rankingReason: this.getRankingReason(recommended, servers)
+        };
+    }
+    /**
+     * Detect kanapuli/mcp-kafka server
+     */
+    async detectKanapuli() {
+        try {
+            // Check if npm package installed
+            const { stdout } = await execAsync('npm list -g mcp-kafka --json 2>/dev/null || echo "{}"');
+            const packageInfo = JSON.parse(stdout);
+            const installed = !!packageInfo.dependencies?.['mcp-kafka'];
+            if (!installed) {
+                return {
+                    type: MCPServerType.KANAPULI,
+                    version: 'unknown',
+                    installed: false,
+                    running: false,
+                    capabilities: this.getKanapuliCapabilities()
+                };
+            }
+            // Check if running (look for process)
+            const running = await this.isProcessRunning('mcp-kafka');
+            const version = packageInfo.dependencies?.['mcp-kafka']?.version || 'unknown';
+            return {
+                type: MCPServerType.KANAPULI,
+                version,
+                installed: true,
+                running,
+                capabilities: this.getKanapuliCapabilities(),
+                connectionDetails: running ? {
+                    host: 'localhost',
+                    port: 3000, // Default MCP port
+                    protocol: 'http',
+                    healthEndpoint: '/health',
+                    infoEndpoint: '/info'
+                } : undefined
+            };
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    /**
+     * Detect tuannvm/kafka-mcp-server (Go implementation)
+     */
+    async detectTuannvm() {
+        try {
+            // Check if binary exists
+            const { stdout } = await execAsync('which kafka-mcp-server 2>/dev/null || echo ""');
+            const installed = !!stdout.trim();
+            if (!installed) {
+                return {
+                    type: MCPServerType.TUANNVM,
+                    version: 'unknown',
+                    installed: false,
+                    running: false,
+                    capabilities: this.getTuannvmCapabilities()
+                };
+            }
+            // Check if running
+            const running = await this.isProcessRunning('kafka-mcp-server');
+            // Try to get version
+            let version = 'unknown';
+            try {
+                const { stdout: versionOut } = await execAsync('kafka-mcp-server --version 2>/dev/null');
+                version = versionOut.trim();
+            }
+            catch { }
+            return {
+                type: MCPServerType.TUANNVM,
+                version,
+                installed: true,
+                running,
+                capabilities: this.getTuannvmCapabilities(),
+                connectionDetails: running ? {
+                    host: 'localhost',
+                    port: 8080, // Default port
+                    protocol: 'http'
+                } : undefined
+            };
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    /**
+     * Detect Joel-hanson/kafka-mcp-server
+     */
+    async detectJoelHanson() {
+        try {
+            // Check if Python package installed
+            const { stdout } = await execAsync('pip show kafka-mcp-server 2>/dev/null || echo ""');
+            const installed = stdout.includes('Name: kafka-mcp-server');
+            if (!installed) {
+                return {
+                    type: MCPServerType.JOEL_HANSON,
+                    version: 'unknown',
+                    installed: false,
+                    running: false,
+                    capabilities: this.getJoelHansonCapabilities()
+                };
+            }
+            // Extract version
+            const versionMatch = stdout.match(/Version: ([\d.]+)/);
+            const version = versionMatch ? versionMatch[1] : 'unknown';
+            // Check if running
+            const running = await this.isProcessRunning('kafka-mcp-server');
+            return {
+                type: MCPServerType.JOEL_HANSON,
+                version,
+                installed: true,
+                running,
+                capabilities: this.getJoelHansonCapabilities(),
+                connectionDetails: running ? {
+                    host: 'localhost',
+                    port: 5000, // Default Python MCP port
+                    protocol: 'http'
+                } : undefined
+            };
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    /**
+     * Detect Confluent official MCP server
+     */
+    async detectConfluent() {
+        try {
+            // Confluent MCP is typically part of Confluent Cloud CLI
+            const { stdout } = await execAsync('confluent version 2>/dev/null || echo ""');
+            const installed = !!stdout.trim();
+            if (!installed) {
+                return {
+                    type: MCPServerType.CONFLUENT,
+                    version: 'unknown',
+                    installed: false,
+                    running: false,
+                    capabilities: this.getConfluentCapabilities()
+                };
+            }
+            // Extract version
+            const versionMatch = stdout.match(/Version:\s+([\d.]+)/);
+            const version = versionMatch ? versionMatch[1] : 'unknown';
+            // Confluent MCP runs as part of CLI, check if CLI is authenticated
+            let running = false;
+            try {
+                const { stdout: authOut } = await execAsync('confluent auth current 2>/dev/null');
+                running = authOut.includes('Logged in as');
+            }
+            catch { }
+            return {
+                type: MCPServerType.CONFLUENT,
+                version,
+                installed: true,
+                running,
+                capabilities: this.getConfluentCapabilities()
+            };
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    /**
+     * Check if process is running
+     */
+    async isProcessRunning(processName) {
+        try {
+            const { stdout } = await execAsync(`ps aux | grep "${processName}" | grep -v grep || echo ""`);
+            return !!stdout.trim();
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Rank servers by priority (Confluent > tuannvm > kanapuli > Joel-hanson)
+     */
+    rankServers(servers) {
+        const ranking = [
+            MCPServerType.CONFLUENT,
+            MCPServerType.TUANNVM,
+            MCPServerType.KANAPULI,
+            MCPServerType.JOEL_HANSON
+        ];
+        // Find highest-ranked installed server
+        for (const type of ranking) {
+            const server = servers.find(s => s.type === type && s.installed);
+            if (server)
+                return server;
+        }
+        return null;
+    }
+    /**
+     * Get ranking reason
+     */
+    getRankingReason(recommended, servers) {
+        if (!recommended) {
+            return 'No MCP servers installed';
+        }
+        const reasons = {
+            [MCPServerType.CONFLUENT]: 'Confluent official MCP (best features: natural language, Flink SQL)',
+            [MCPServerType.TUANNVM]: 'Go implementation (advanced SASL: SCRAM-SHA-256/512)',
+            [MCPServerType.KANAPULI]: 'Node.js implementation (basic operations, SASL_PLAINTEXT)',
+            [MCPServerType.JOEL_HANSON]: 'Python implementation (Claude Desktop integration)'
+        };
+        return reasons[recommended.type];
+    }
+    /**
+     * Get capabilities for each MCP server type
+     */
+    getKanapuliCapabilities() {
+        return {
+            authentication: [AuthMethod.SASL_PLAINTEXT, AuthMethod.PLAINTEXT],
+            operations: ['produce', 'consume', 'list-topics', 'describe-topic', 'get-offsets'],
+            advancedFeatures: []
+        };
+    }
+    getTuannvmCapabilities() {
+        return {
+            authentication: [
+                AuthMethod.SASL_SCRAM_SHA_256,
+                AuthMethod.SASL_SCRAM_SHA_512,
+                AuthMethod.SASL_PLAINTEXT,
+                AuthMethod.SASL_SSL,
+                AuthMethod.PLAINTEXT
+            ],
+            operations: [
+                'produce',
+                'consume',
+                'list-topics',
+                'create-topic',
+                'delete-topic',
+                'describe-topic',
+                'list-consumer-groups',
+                'describe-consumer-group',
+                'get-offsets',
+                'reset-offsets'
+            ],
+            advancedFeatures: ['consumer-group-management', 'offset-management']
+        };
+    }
+    getJoelHansonCapabilities() {
+        return {
+            authentication: [AuthMethod.SASL_PLAINTEXT, AuthMethod.PLAINTEXT, AuthMethod.SSL],
+            operations: ['produce', 'consume', 'list-topics', 'describe-topic'],
+            advancedFeatures: ['claude-desktop-integration']
+        };
+    }
+    getConfluentCapabilities() {
+        return {
+            authentication: [
+                AuthMethod.OAUTH,
+                AuthMethod.SASL_SCRAM_SHA_256,
+                AuthMethod.SASL_SCRAM_SHA_512,
+                AuthMethod.SASL_SSL
+            ],
+            operations: [
+                'produce',
+                'consume',
+                'list-topics',
+                'create-topic',
+                'delete-topic',
+                'describe-topic',
+                'list-consumer-groups',
+                'describe-consumer-group',
+                'schema-registry-operations',
+                'ksqldb-query',
+                'flink-sql-query'
+            ],
+            advancedFeatures: [
+                'natural-language-interface',
+                'schema-registry',
+                'ksqldb',
+                'flink-sql',
+                'cloud-managed'
+            ]
+        };
+    }
+}
+//# sourceMappingURL=detector.js.map

package/dist/plugins/specweave-kafka/lib/mcp/detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../../../../plugins/specweave-kafka/lib/mcp/detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EACL,aAAa,EAIb,UAAU,EACX,MAAM,SAAS,CAAC;AAEjB,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC,MAAM,OAAO,iBAAiB;IAC5B;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,OAAO,GAAoB,EAAE,CAAC;QAEpC,6BAA6B;QAC7B,MAAM,MAAM,GAAG;YACb,IAAI,CAAC,cAAc,EAAE;YACrB,IAAI,CAAC,aAAa,EAAE;YACpB,IAAI,CAAC,gBAAgB,EAAE;YACvB,IAAI,CAAC,eAAe,EAAE;SACvB,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAEjD,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YACzB,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBAClD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,8DAA8D;QAC9D,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAE9C,OAAO;YACL,OAAO;YACP,WAAW,EAAE,WAAW,EAAE,IAAI,IAAI,IAAI;YACtC,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,OAAO,CAAC;SAC3D,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc;QAC1B,IAAI,CAAC;YACH,iCAAiC;YACjC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,uDAAuD,CAAC,CAAC;YAC5F,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAEvC,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,YAAY,EAAE,CAAC,WAAW,CAAC,CAAC;YAE5D,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO;oBACL,IAAI,EAAE,aAAa,CAAC,QAAQ;oBAC5B,OAAO,EAAE,SAAS;oBAClB,SAAS,EAAE,KAAK;oBAChB,OAAO,EAAE,KAAK;oBACd,YAAY,EAAE,IAAI,CAAC,uBAAuB,EAAE;iBAC7C,CAAC;YACJ,CAAC;YAED,sCAAsC;YACtC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;YACzD,MAAM,OAAO,GAAG,WAAW,CAAC,YAAY,EAAE,CAAC,WAAW,CAAC,EAAE,OAAO,IAAI,SAAS,CAAC;YAE9E,OAAO;gBACL,IAAI,EAAE,aAAa,CAAC,QAAQ;gBAC5B,OAAO;gBACP,SAAS,EAAE,IAAI;gBACf,OAAO;gBACP,YAAY,EAAE,IAAI,CAAC,uBAAuB,EAAE;gBAC5C,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAC;oBAC3B,IAAI,EAAE,WAAW;oBACjB,IAAI,EAAE,IAAI,EAAE,mBAAmB;oBAC/B,QAAQ,EAAE,MAAM;oBAChB,cAAc,EAAE,SAAS;oBACzB,YAAY,EAAE,OAAO;iBACtB,CAAC,CAAC,CAAC,SAAS;aACd,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa;QACzB,IAAI,CAAC;YACH,yBAAyB;YACzB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,+CAA+C,CAAC,CAAC;YACpF,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAElC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO;oBACL,IAAI,EAAE,aAAa,CAAC,OAAO;oBAC3B,OAAO,EAAE,SAAS;oBAClB,SAAS,EAAE,KAAK;oBAChB,OAAO,EAAE,KAAK;oBACd,YAAY,EAAE,IAAI,CAAC,sBAAsB,EAAE;iBAC5C,CAAC;YACJ,CAAC;YAED,mBAAmB;YACnB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;YAEhE,qBAAqB;YACrB,IAAI,OAAO,GAAG,SAAS,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,SAAS,CAAC,wCAAwC,CAAC,CAAC;gBACzF,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;YAC9B,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;YAEV,OAAO;gBACL,IAAI,EAAE,aAAa,CAAC,OAAO;gBAC3B,OAAO;gBACP,SAAS,EAAE,IAAI;gBACf,OAAO;gBACP,YAAY,EAAE,IAAI,CAAC,sBAAsB,EAAE;gBAC3C,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAC;oBAC3B,IAAI,EAAE,WAAW;oBACjB,IAAI,EAAE,IAAI,EAAE,eAAe;oBAC3B,QAAQ,EAAE,MAAM;iBACjB,CAAC,CAAC,CAAC,SAAS;aACd,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB;QAC5B,IAAI,CAAC;YACH,oCAAoC;YACpC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,kDAAkD,CAAC,CAAC;YACvF,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC;YAE5D,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO;oBACL,IAAI,EAAE,aAAa,CAAC,WAAW;oBAC/B,OAAO,EAAE,SAAS;oBAClB,SAAS,EAAE,KAAK;oBAChB,OAAO,EAAE,KAAK;oBACd,YAAY,EAAE,IAAI,CAAC,yBAAyB,EAAE;iBAC/C,CAAC;YACJ,CAAC;YAED,kBAAkB;YAClB,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACvD,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAE3D,mBAAmB;YACnB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;YAEhE,OAAO;gBACL,IAAI,EAAE,aAAa,CAAC,WAAW;gBAC/B,OAAO;gBACP,SAAS,EAAE,IAAI;gBACf,OAAO;gBACP,YAAY,EAAE,IAAI,CAAC,yBAAyB,EAAE;gBAC9C,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAC;oBAC3B,IAAI,EAAE,WAAW;oBACjB,IAAI,EAAE,IAAI,EAAE,0BAA0B;oBACtC,QAAQ,EAAE,MAAM;iBACjB,CAAC,CAAC,CAAC,SAAS;aACd,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe;QAC3B,IAAI,CAAC;YACH,yDAAyD;YACzD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,0CAA0C,CAAC,CAAC;YAC/E,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAElC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO;oBACL,IAAI,EAAE,aAAa,CAAC,SAAS;oBAC7B,OAAO,EAAE,SAAS;oBAClB,SAAS,EAAE,KAAK;oBAChB,OAAO,EAAE,KAAK;oBACd,YAAY,EAAE,IAAI,CAAC,wBAAwB,EAAE;iBAC9C,CAAC;YACJ,CAAC;YAED,kBAAkB;YAClB,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;YACzD,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAE3D,mEAAmE;YACnE,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,SAAS,CAAC,oCAAoC,CAAC,CAAC;gBAClF,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;YAC7C,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;YAEV,OAAO;gBACL,IAAI,EAAE,aAAa,CAAC,SAAS;gBAC7B,OAAO;gBACP,SAAS,EAAE,IAAI;gBACf,OAAO;gBACP,YAAY,EAAE,IAAI,CAAC,wBAAwB,EAAE;aAC9C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB,CAAC,WAAmB;QAChD,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,kBAAkB,WAAW,6BAA6B,CAAC,CAAC;YAC/F,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,OAAwB;QAC1C,MAAM,OAAO,GAAG;YACd,aAAa,CAAC,SAAS;YACvB,aAAa,CAAC,OAAO;YACrB,aAAa,CAAC,QAAQ;YACtB,aAAa,CAAC,WAAW;SAC1B,CAAC;QAEF,uCAAuC;QACvC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC;YACjE,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;QAC5B,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,WAAiC,EAAE,OAAwB;QAClF,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,0BAA0B,CAAC;QACpC,CAAC;QAED,MAAM,OAAO,GAAkC;YAC7C,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,qEAAqE;YAChG,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,sDAAsD;YAC/E,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,2DAA2D;YACrF,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,oDAAoD;SAClF,CAAC;QAEF,OAAO,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACK,uBAAuB;QAC7B,OAAO;YACL,cAAc,EAAE,CAAC,UAAU,CAAC,cAAc,EAAE,UAAU,CAAC,SAAS,CAAC;YACjE,UAAU,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,CAAC;YAClF,gBAAgB,EAAE,EAAE;SACrB,CAAC;IACJ,CAAC;IAEO,sBAAsB;QAC5B,OAAO;YACL,cAAc,EAAE;gBACd,UAAU,CAAC,kBAAkB;gBAC7B,UAAU,CAAC,kBAAkB;gBAC7B,UAAU,CAAC,cAAc;gBACzB,UAAU,CAAC,QAAQ;gBACnB,UAAU,CAAC,SAAS;aACrB;YACD,UAAU,EAAE;gBACV,SAAS;gBACT,SAAS;gBACT,aAAa;gBACb,cAAc;gBACd,cAAc;gBACd,gBAAgB;gBAChB,sBAAsB;gBACtB,yBAAyB;gBACzB,aAAa;gBACb,eAAe;aAChB;YACD,gBAAgB,EAAE,CAAC,2BAA2B,EAAE,mBAAmB,CAAC;SACrE,CAAC;IACJ,CAAC;IAEO,yBAAyB;QAC/B,OAAO;YACL,cAAc,EAAE,CAAC,UAAU,CAAC,cAAc,EAAE,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC;YACjF,UAAU,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,CAAC;YACnE,gBAAgB,EAAE,CAAC,4BAA4B,CAAC;SACjD,CAAC;IACJ,CAAC;IAEO,wBAAwB;QAC9B,OAAO;YACL,cAAc,EAAE;gBACd,UAAU,CAAC,KAAK;gBAChB,UAAU,CAAC,kBAAkB;gBAC7B,UAAU,CAAC,kBAAkB;gBAC7B,UAAU,CAAC,QAAQ;aACpB;YACD,UAAU,EAAE;gBACV,SAAS;gBACT,SAAS;gBACT,aAAa;gBACb,cAAc;gBACd,cAAc;gBACd,gBAAgB;gBAChB,sBAAsB;gBACtB,yBAAyB;gBACzB,4BAA4B;gBAC5B,cAAc;gBACd,iBAAiB;aAClB;YACD,gBAAgB,EAAE;gBAChB,4BAA4B;gBAC5B,iBAAiB;gBACjB,QAAQ;gBACR,WAAW;gBACX,eAAe;aAChB;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/plugins/specweave-kafka/lib/mcp/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * MCP Server Types and Interfaces
+ *
+ * Defines types for MCP server detection, configuration, and operations.
+ */
+export declare enum MCPServerType {
+    KANAPULI = "kanapuli",
+    TUANNVM = "tuannvm",
+    JOEL_HANSON = "joel-hanson",
+    CONFLUENT = "confluent"
+}
+export interface MCPServerInfo {
+    type: MCPServerType;
+    version: string;
+    installed: boolean;
+    running: boolean;
+    capabilities: MCPServerCapabilities;
+    connectionDetails?: MCPConnectionDetails;
+}
+export interface MCPServerCapabilities {
+    authentication: AuthMethod[];
+    operations: string[];
+    advancedFeatures: string[];
+}
+export declare enum AuthMethod {
+    SASL_PLAINTEXT = "SASL_PLAINTEXT",
+    SASL_SCRAM_SHA_256 = "SASL/SCRAM-SHA-256",
+    SASL_SCRAM_SHA_512 = "SASL/SCRAM-SHA-512",
+    SASL_SSL = "SASL_SSL",
+    SSL = "SSL",
+    PLAINTEXT = "PLAINTEXT",
+    OAUTH = "OAUTH"
+}
+export interface MCPConnectionDetails {
+    host: string;
+    port: number;
+    protocol: string;
+    healthEndpoint?: string;
+    infoEndpoint?: string;
+}
+export interface MCPServerConfig {
+    serverType: MCPServerType;
+    brokerUrls: string[];
+    authentication: {
+        mechanism: AuthMethod;
+        username?: string;
+        password?: string;
+        saslMechanism?: string;
+        sslCertPath?: string;
+        sslKeyPath?: string;
+        sslCaPath?: string;
+    };
+    options?: Record<string, any>;
+}
+export interface MCPDetectionResult {
+    servers: MCPServerInfo[];
+    recommended: MCPServerType | null;
+    rankingReason: string;
+}
+export interface MCPOperationResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+    metadata?: {
+        serverType: MCPServerType;
+        operation: string;
+        duration: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/specweave-kafka/lib/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../plugins/specweave-kafka/lib/mcp/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,oBAAY,aAAa;IACvB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,WAAW,gBAAgB;IAC3B,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,qBAAqB,CAAC;IACpC,iBAAiB,CAAC,EAAE,oBAAoB,CAAC;CAC1C;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,UAAU,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,oBAAY,UAAU;IACpB,cAAc,mBAAmB;IACjC,kBAAkB,uBAAuB;IACzC,kBAAkB,uBAAuB;IACzC,QAAQ,aAAa;IACrB,GAAG,QAAQ;IACX,SAAS,cAAc;IACvB,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,aAAa,CAAC;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE;QACd,SAAS,EAAE,UAAU,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,WAAW,EAAE,aAAa,GAAG,IAAI,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE;QACT,UAAU,EAAE,aAAa,CAAC;QAC1B,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH"}

package/dist/plugins/specweave-kafka/lib/mcp/types.js

@@ -0,0 +1,23 @@
+/**
+ * MCP Server Types and Interfaces
+ *
+ * Defines types for MCP server detection, configuration, and operations.
+ */
+export var MCPServerType;
+(function (MCPServerType) {
+    MCPServerType["KANAPULI"] = "kanapuli";
+    MCPServerType["TUANNVM"] = "tuannvm";
+    MCPServerType["JOEL_HANSON"] = "joel-hanson";
+    MCPServerType["CONFLUENT"] = "confluent";
+})(MCPServerType || (MCPServerType = {}));
+export var AuthMethod;
+(function (AuthMethod) {
+    AuthMethod["SASL_PLAINTEXT"] = "SASL_PLAINTEXT";
+    AuthMethod["SASL_SCRAM_SHA_256"] = "SASL/SCRAM-SHA-256";
+    AuthMethod["SASL_SCRAM_SHA_512"] = "SASL/SCRAM-SHA-512";
+    AuthMethod["SASL_SSL"] = "SASL_SSL";
+    AuthMethod["SSL"] = "SSL";
+    AuthMethod["PLAINTEXT"] = "PLAINTEXT";
+    AuthMethod["OAUTH"] = "OAUTH";
+})(AuthMethod || (AuthMethod = {}));
+//# sourceMappingURL=types.js.map

package/dist/plugins/specweave-kafka/lib/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../plugins/specweave-kafka/lib/mcp/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;IACnB,4CAA2B,CAAA;IAC3B,wCAAuB,CAAA;AACzB,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAiBD,MAAM,CAAN,IAAY,UAQX;AARD,WAAY,UAAU;IACpB,+CAAiC,CAAA;IACjC,uDAAyC,CAAA;IACzC,uDAAyC,CAAA;IACzC,mCAAqB,CAAA;IACrB,yBAAW,CAAA;IACX,qCAAuB,CAAA;IACvB,6BAAe,CAAA;AACjB,CAAC,EARW,UAAU,KAAV,UAAU,QAQrB"}

package/dist/plugins/specweave-kafka/lib/utils/partitioning.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Partitioning Strategy Analyzer
+ *
+ * Analyzes partition key distribution and provides recommendations
+ * for optimal Kafka topic partitioning strategies.
+ */
+export interface PartitionKeyAnalysis {
+    key: string;
+    sampleValues: string[];
+    estimatedCardinality: number;
+    distribution: 'uniform' | 'skewed' | 'severely-skewed';
+    hotspotRisk: 'low' | 'medium' | 'high';
+}
+export interface PartitioningRecommendation {
+    recommendedPartitions: number;
+    keyStrategy: 'simple-hash' | 'compound-hash' | 'custom-partitioner' | 'round-robin';
+    keyField: string | null;
+    reasoning: string;
+    warnings: string[];
+    examples: string[];
+}
+export interface PartitionAnalysisRequest {
+    topicName: string;
+    currentPartitionCount?: number;
+    expectedMessagesPerSecond: number;
+    peakMultiplier?: number;
+    potentialKeys: Array<{
+        fieldName: string;
+        sampleValues: string[];
+        estimatedUniqueCount: number;
+    }>;
+    orderingRequired: boolean;
+    targetLatencyMs?: number;
+    targetThroughputMBps?: number;
+}
+export declare class PartitioningStrategyAnalyzer {
+    private readonly MAX_PARTITION_THROUGHPUT_MBPS;
+    private readonly MAX_PARTITION_MSG_PER_SEC;
+    private readonly IDEAL_PARTITIONS_PER_CONSUMER;
+    /**
+     * Analyze partition key candidates and recommend strategy
+     */
+    analyze(req: PartitionAnalysisRequest): PartitioningRecommendation;
+    /**
+     * Analyze a single partition key candidate
+     */
+    private analyzeKey;
+    /**
+     * Select best partition key from candidates
+     */
+    private selectBestKey;
+    /**
+     * Determine optimal partitioning key strategy
+     */
+    private determineKeyStrategy;
+    /**
+     * Generate warnings for partitioning strategy
+     */
+    private generateWarnings;
+    /**
+     * Generate usage examples for the recommended strategy
+     */
+    private generateExamples;
+    /**
+     * Helper: Next power of 2
+     */
+    private nextPowerOfTwo;
+    /**
+     * Helper: Capitalize first letter
+     */
+    private capitalize;
+    /**
+     * Calculate partition distribution for a given key
+     */
+    calculateDistribution(sampleValues: string[], partitionCount: number): {
+        partition: number;
+        count: number;
+        percentage: number;
+    }[];
+    /**
+     * Simple MurmurHash2 implementation (matches Kafka's DefaultPartitioner)
+     */
+    private murmur2Hash;
+}
+//# sourceMappingURL=partitioning.d.ts.map

package/dist/plugins/specweave-kafka/lib/utils/partitioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"partitioning.d.ts","sourceRoot":"","sources":["../../../../../plugins/specweave-kafka/lib/utils/partitioning.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,SAAS,GAAG,QAAQ,GAAG,iBAAiB,CAAC;IACvD,WAAW,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,0BAA0B;IACzC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,aAAa,GAAG,eAAe,GAAG,oBAAoB,GAAG,aAAa,CAAC;IACpF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IAEvC,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAG/B,yBAAyB,EAAE,MAAM,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,aAAa,EAAE,KAAK,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC,CAAC;IAGH,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,4BAA4B;IACvC,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAM;IACpD,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAS;IACnD,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAK;IAEnD;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,wBAAwB,GAAG,0BAA0B;IAwElE;;OAEG;IACH,OAAO,CAAC,UAAU;IAqClB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiD5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuDxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA+FxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,qBAAqB,CACnB,YAAY,EAAE,MAAM,EAAE,EACtB,cAAc,EAAE,MAAM,GACrB;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE;IAsB7D;;OAEG;IACH,OAAO,CAAC,WAAW;CAgCpB"}