specweave 0.18.0 → 0.20.0

package/dist/plugins/specweave-kafka/lib/cli/kcat-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kcat-wrapper.d.ts","sourceRoot":"","sources":["../../../../../plugins/specweave-kafka/lib/cli/kcat-wrapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,kBAAkB,EAGnB,MAAM,SAAS,CAAC;AAIjB,qBAAa,WAAW;IACtB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+BxF;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAmCtE;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAsBzE;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAsB5G;;OAEG;YACW,OAAO;IAsCrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA4B3B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAKlC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmBxB;;OAEG;WACU,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAS5C;;OAEG;WACU,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;CAS3C"}

package/dist/plugins/specweave-kafka/lib/cli/kcat-wrapper.js

@@ -0,0 +1,248 @@
+/**
+ * kcat CLI Wrapper
+ *
+ * Type-safe TypeScript wrapper for kcat (kafkacat) CLI tool.
+ * Provides produce, consume, metadata, and query operations.
+ */
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+export class KcatWrapper {
+    /**
+     * Produce a message to Kafka topic
+     */
+    async produce(message, options) {
+        const args = [
+            'kcat',
+            '-P', // Producer mode
+            '-b', options.brokers,
+            '-t', options.topic
+        ];
+        if (options.key) {
+            args.push('-K', ':'); // Key delimiter
+        }
+        if (options.partition !== undefined) {
+            args.push('-p', options.partition.toString());
+        }
+        if (options.compression) {
+            args.push('-z', options.compression);
+        }
+        if (options.acks !== undefined) {
+            const acksValue = options.acks === 'all' ? '-1' : options.acks.toString();
+            args.push('-X', `acks=${acksValue}`);
+        }
+        const command = args.join(' ');
+        const input = options.key ? `${options.key}:${message}` : message;
+        return this.execute(command, input);
+    }
+    /**
+     * Consume messages from Kafka topic
+     */
+    async consume(options) {
+        const args = [
+            'kcat',
+            '-C', // Consumer mode
+            '-b', options.brokers,
+            '-t', options.topic,
+            '-f', '%t:%p:%o:%k:%s\\n' // Format: topic:partition:offset:key:value
+        ];
+        if (options.offset) {
+            args.push('-o', options.offset.toString());
+        }
+        if (options.partition !== undefined) {
+            args.push('-p', options.partition.toString());
+        }
+        if (options.count) {
+            args.push('-c', options.count.toString());
+        }
+        if (options.groupId) {
+            args.push('-G', options.groupId);
+        }
+        const command = args.join(' ');
+        const result = await this.execute(command);
+        if (!result.success) {
+            throw new Error(`kcat consume failed: ${result.error}`);
+        }
+        return this.parseConsumeOutput(result.output);
+    }
+    /**
+     * Get cluster metadata
+     */
+    async getMetadata(options) {
+        const args = [
+            'kcat',
+            '-L', // Metadata mode
+            '-b', options.brokers,
+            '-J' // JSON output
+        ];
+        if (options.topic) {
+            args.push('-t', options.topic);
+        }
+        const command = args.join(' ');
+        const result = await this.execute(command);
+        if (!result.success) {
+            throw new Error(`kcat metadata failed: ${result.error}`);
+        }
+        return this.parseMetadataOutput(result.output);
+    }
+    /**
+     * Query topic offsets
+     */
+    async queryOffsets(options) {
+        const args = [
+            'kcat',
+            '-Q', // Query mode
+            '-b', options.brokers,
+            '-t', options.topic
+        ];
+        if (options.partition !== undefined) {
+            args.push('-p', options.partition.toString());
+        }
+        const command = args.join(' ');
+        const result = await this.execute(command);
+        if (!result.success) {
+            throw new Error(`kcat query failed: ${result.error}`);
+        }
+        return this.parseQueryOutput(result.output);
+    }
+    /**
+     * Execute kcat command
+     */
+    async execute(command, input) {
+        const startTime = Date.now();
+        try {
+            const execOptions = {
+                maxBuffer: 10 * 1024 * 1024, // 10MB buffer
+                timeout: 30000 // 30 second timeout
+            };
+            if (input) {
+                execOptions.input = input;
+            }
+            const { stdout, stderr } = await execAsync(command, execOptions);
+            const duration = Date.now() - startTime;
+            return {
+                success: true,
+                output: stdout,
+                error: stderr || undefined,
+                exitCode: 0,
+                command,
+                duration
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            return {
+                success: false,
+                output: error.stdout || '',
+                error: error.stderr || error.message,
+                exitCode: error.code || 1,
+                command,
+                duration
+            };
+        }
+    }
+    /**
+     * Parse consume output into messages
+     */
+    parseConsumeOutput(output) {
+        const lines = output.trim().split('\n').filter(line => line.length > 0);
+        const messages = [];
+        for (const line of lines) {
+            // Format: topic:partition:offset:key:value
+            const parts = line.split(':');
+            if (parts.length >= 5) {
+                messages.push({
+                    topic: parts[0],
+                    partition: parseInt(parts[1]),
+                    offset: parseInt(parts[2]),
+                    key: parts[3] || undefined,
+                    value: parts.slice(4).join(':'), // Rejoin in case value contains ':'
+                    timestamp: Date.now() // kcat doesn't provide timestamp in this format
+                });
+            }
+        }
+        return messages;
+    }
+    /**
+     * Parse metadata JSON output
+     */
+    parseMetadataOutput(output) {
+        const metadata = JSON.parse(output);
+        return {
+            clusterId: metadata.originatingBroker?.cluster || 'unknown',
+            controllerId: metadata.controllerId || -1,
+            brokers: (metadata.brokers || []).map((b) => ({
+                id: b.id,
+                host: b.host,
+                port: b.port,
+                rack: b.rack
+            })),
+            topics: (metadata.topics || []).map((t) => ({
+                name: t.topic,
+                replicationFactor: this.calculateReplicationFactor(t.partitions),
+                configs: {},
+                partitions: (t.partitions || []).map((p) => ({
+                    id: p.partition,
+                    leader: p.leader,
+                    replicas: p.replicas || [],
+                    isr: p.isrs || [],
+                    earliestOffset: 0, // Not provided in metadata
+                    latestOffset: 0 // Not provided in metadata
+                }))
+            }))
+        };
+    }
+    /**
+     * Calculate replication factor from partitions
+     */
+    calculateReplicationFactor(partitions) {
+        if (!partitions || partitions.length === 0)
+            return 0;
+        return partitions[0].replicas?.length || 0;
+    }
+    /**
+     * Parse query offset output
+     */
+    parseQueryOutput(output) {
+        const lines = output.trim().split('\n');
+        const offsets = {};
+        for (const line of lines) {
+            // Format: topic partition [earliest] [latest]
+            const match = line.match(/(\d+)\s+\[(\d+)\]\s+\[(\d+)\]/);
+            if (match) {
+                const partition = parseInt(match[1]);
+                offsets[partition] = {
+                    earliest: parseInt(match[2]),
+                    latest: parseInt(match[3])
+                };
+            }
+        }
+        return offsets;
+    }
+    /**
+     * Check if kcat is installed
+     */
+    static async isInstalled() {
+        try {
+            const { stdout } = await execAsync('which kcat 2>/dev/null || which kafkacat 2>/dev/null');
+            return !!stdout.trim();
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get kcat version
+     */
+    static async getVersion() {
+        try {
+            const { stdout } = await execAsync('kcat -V 2>&1 || kafkacat -V 2>&1');
+            const match = stdout.match(/kafkacat - Apache Kafka producer and consumer tool\s+(\S+)/);
+            return match ? match[1] : 'unknown';
+        }
+        catch {
+            return 'unknown';
+        }
+    }
+}
+//# sourceMappingURL=kcat-wrapper.js.map

package/dist/plugins/specweave-kafka/lib/cli/kcat-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kcat-wrapper.js","sourceRoot":"","sources":["../../../../../plugins/specweave-kafka/lib/cli/kcat-wrapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAajC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC,MAAM,OAAO,WAAW;IACtB;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,OAA2B;QACxD,MAAM,IAAI,GAAa;YACrB,MAAM;YACN,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,OAAO,CAAC,OAAO;YACrB,IAAI,EAAE,OAAO,CAAC,KAAK;SACpB,CAAC;QAEF,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,gBAAgB;QACxC,CAAC;QAED,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1E,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,SAAS,EAAE,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAElE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,OAA2B;QACvC,MAAM,IAAI,GAAa;YACrB,MAAM;YACN,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,OAAO,CAAC,OAAO;YACrB,IAAI,EAAE,OAAO,CAAC,KAAK;YACnB,IAAI,EAAE,mBAAmB,CAAC,2CAA2C;SACtE,CAAC;QAEF,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE3C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,OAA4B;QAC5C,MAAM,IAAI,GAAa;YACrB,MAAM;YACN,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,OAAO,CAAC,OAAO;YACrB,IAAI,CAAC,cAAc;SACpB,CAAC;QAEF,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE3C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,OAAyB;QAC1C,MAAM,IAAI,GAAa;YACrB,MAAM;YACN,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,OAAO,CAAC,OAAO;YACrB,IAAI,EAAE,OAAO,CAAC,KAAK;SACpB,CAAC;QAEF,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE3C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,KAAc;QACnD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC;YACH,MAAM,WAAW,GAAQ;gBACvB,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,cAAc;gBAC3C,OAAO,EAAE,KAAK,CAAC,oBAAoB;aACpC,CAAC;YAEF,IAAI,KAAK,EAAE,CAAC;gBACV,WAAW,CAAC,KAAK,GAAG,KAAK,CAAC;YAC5B,CAAC;YAED,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAExC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,MAAM,IAAI,SAAS;gBAC1B,QAAQ,EAAE,CAAC;gBACX,OAAO;gBACP,QAAQ;aACT,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAExC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;gBAC1B,KAAK,EAAE,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO;gBACpC,QAAQ,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC;gBACzB,OAAO;gBACP,QAAQ;aACT,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,MAAc;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAsB,EAAE,CAAC;QAEvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,2CAA2C;YAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACtB,QAAQ,CAAC,IAAI,CAAC;oBACZ,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;oBACf,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBAC7B,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBAC1B,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS;oBAC1B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,oCAAoC;oBACrE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,gDAAgD;iBACvE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,MAAc;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEpC,OAAO;YACL,SAAS,EAAE,QAAQ,CAAC,iBAAiB,EAAE,OAAO,IAAI,SAAS;YAC3D,YAAY,EAAE,QAAQ,CAAC,YAAY,IAAI,CAAC,CAAC;YACzC,OAAO,EAAE,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;gBACjD,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;aACb,CAAC,CAAC;YACH,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;gBAC/C,IAAI,EAAE,CAAC,CAAC,KAAK;gBACb,iBAAiB,EAAE,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC,UAAU,CAAC;gBAChE,OAAO,EAAE,EAAE;gBACX,UAAU,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;oBAChD,EAAE,EAAE,CAAC,CAAC,SAAS;oBACf,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE;oBAC1B,GAAG,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE;oBACjB,cAAc,EAAE,CAAC,EAAE,2BAA2B;oBAC9C,YAAY,EAAE,CAAC,CAAC,2BAA2B;iBAC5C,CAAC,CAAC;aACJ,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,0BAA0B,CAAC,UAAiB;QAClD,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QACrD,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,MAAc;QACrC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,OAAO,GAAyD,EAAE,CAAC;QAEzE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,8CAA8C;YAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;YAC1D,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrC,OAAO,CAAC,SAAS,CAAC,GAAG;oBACnB,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBAC5B,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;iBAC3B,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,WAAW;QACtB,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,sDAAsD,CAAC,CAAC;YAC3F,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,UAAU;QACrB,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,kCAAkC,CAAC,CAAC;YACvE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;YACzF,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,82 @@
+/**
+ * CLI Tool Types and Interfaces
+ *
+ * Types for kcat, kcli, kaf, kafkactl wrappers
+ */
+export declare enum CLITool {
+    KCAT = "kcat",
+    KCLI = "kcli",
+    KAF = "kaf",
+    KAFKACTL = "kafkactl"
+}
+export interface KcatProduceOptions {
+    topic: string;
+    brokers: string;
+    key?: string;
+    partition?: number;
+    headers?: Record<string, string>;
+    compression?: 'none' | 'gzip' | 'snappy' | 'lz4' | 'zstd';
+    acks?: 0 | 1 | 'all';
+}
+export interface KcatConsumeOptions {
+    topic: string;
+    brokers: string;
+    offset?: 'beginning' | 'end' | 'stored' | number;
+    partition?: number;
+    count?: number;
+    format?: 'json' | 'avro' | 'protobuf' | 'string';
+    groupId?: string;
+}
+export interface KcatMetadataOptions {
+    brokers: string;
+    topic?: string;
+}
+export interface KcatQueryOptions {
+    brokers: string;
+    topic: string;
+    partition?: number;
+}
+export interface TopicMetadata {
+    name: string;
+    partitions: PartitionMetadata[];
+    replicationFactor: number;
+    configs: Record<string, string>;
+}
+export interface PartitionMetadata {
+    id: number;
+    leader: number;
+    replicas: number[];
+    isr: number[];
+    earliestOffset: number;
+    latestOffset: number;
+}
+export interface BrokerMetadata {
+    id: number;
+    host: string;
+    port: number;
+    rack?: string;
+}
+export interface ClusterMetadata {
+    brokers: BrokerMetadata[];
+    topics: TopicMetadata[];
+    clusterId: string;
+    controllerId: number;
+}
+export interface ConsumerMessage {
+    topic: string;
+    partition: number;
+    offset: number;
+    timestamp: number;
+    key?: string;
+    value: string;
+    headers?: Record<string, string>;
+}
+export interface CLIExecutionResult {
+    success: boolean;
+    output: string;
+    error?: string;
+    exitCode: number;
+    command: string;
+    duration: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../plugins/specweave-kafka/lib/cli/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,oBAAY,OAAO;IACjB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IAC1D,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

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

@@ -0,0 +1,13 @@
+/**
+ * CLI Tool Types and Interfaces
+ *
+ * Types for kcat, kcli, kaf, kafkactl wrappers
+ */
+export var CLITool;
+(function (CLITool) {
+    CLITool["KCAT"] = "kcat";
+    CLITool["KCLI"] = "kcli";
+    CLITool["KAF"] = "kaf";
+    CLITool["KAFKACTL"] = "kafkactl";
+})(CLITool || (CLITool = {}));
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../plugins/specweave-kafka/lib/cli/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAN,IAAY,OAKX;AALD,WAAY,OAAO;IACjB,wBAAa,CAAA;IACb,wBAAa,CAAA;IACb,sBAAW,CAAA;IACX,gCAAqB,CAAA;AACvB,CAAC,EALW,OAAO,KAAP,OAAO,QAKlB"}

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

@@ -0,0 +1,49 @@
+/**
+ * MCP Server Detector
+ *
+ * Auto-detects installed and running MCP servers for Kafka integration.
+ * Supports: kanapuli, tuannvm, Joel-hanson, Confluent
+ */
+import { MCPDetectionResult } from './types';
+export declare class MCPServerDetector {
+    /**
+     * Detect all available MCP servers
+     */
+    detectAll(): Promise<MCPDetectionResult>;
+    /**
+     * Detect kanapuli/mcp-kafka server
+     */
+    private detectKanapuli;
+    /**
+     * Detect tuannvm/kafka-mcp-server (Go implementation)
+     */
+    private detectTuannvm;
+    /**
+     * Detect Joel-hanson/kafka-mcp-server
+     */
+    private detectJoelHanson;
+    /**
+     * Detect Confluent official MCP server
+     */
+    private detectConfluent;
+    /**
+     * Check if process is running
+     */
+    private isProcessRunning;
+    /**
+     * Rank servers by priority (Confluent > tuannvm > kanapuli > Joel-hanson)
+     */
+    private rankServers;
+    /**
+     * Get ranking reason
+     */
+    private getRankingReason;
+    /**
+     * Get capabilities for each MCP server type
+     */
+    private getKanapuliCapabilities;
+    private getTuannvmCapabilities;
+    private getJoelHansonCapabilities;
+    private getConfluentCapabilities;
+}
+//# sourceMappingURL=detector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../../../plugins/specweave-kafka/lib/mcp/detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAGL,kBAAkB,EAGnB,MAAM,SAAS,CAAC;AAIjB,qBAAa,iBAAiB;IAC5B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,kBAAkB,CAAC;IA6B9C;;OAEG;YACW,cAAc;IAyC5B;;OAEG;YACW,aAAa;IA2C3B;;OAEG;YACW,gBAAgB;IAwC9B;;OAEG;YACW,eAAe;IAuC7B;;OAEG;YACW,gBAAgB;IAS9B;;OAEG;IACH,OAAO,CAAC,WAAW;IAiBnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,sBAAsB;IAyB9B,OAAO,CAAC,yBAAyB;IAQjC,OAAO,CAAC,wBAAwB;CA8BjC"}