@vfarcic/dot-ai 0.103.0 → 0.104.0

package/README.md

@@ -22,6 +22,11 @@ DevOps AI Toolkit is an AI-powered development productivity platform that enhanc
 - **SRE Teams**: Automate root cause analysis and generate executable remediation commands
 - **Support Teams**: Handle incident response with AI-guided investigation and repair workflows
 
+### Platform Building
+- **Platform Engineers**: Install and configure platform tools conversationally without memorizing script paths and commands
+- **New Team Members**: Build platform infrastructure through zero-knowledge guided workflows
+- **DevOps Teams**: Create and manage Kubernetes clusters through natural language interactions
+
 ### Documentation Testing  
 - **Documentation Maintainers**: Automatically validate documentation accuracy and catch outdated content
 - **Technical Writers**: Identify which sections need updates and prioritize work effectively
@@ -79,6 +84,15 @@ Result: Finds sqls.devopstoolkit.live as perfect match ✨
 
 📖 [Learn more →](./docs/mcp-remediate-guide.md)
 
+### Platform Building
+🗣️ **Natural Language Operations**: Install tools and create clusters through conversation without memorizing commands
+🔍 **Dynamic Discovery**: Automatically discovers 21+ available platform operations from infrastructure scripts
+🤖 **AI-Powered Intent Mapping**: Understands variations like "Install Argo CD", "Set up ArgoCD", "Deploy Argo CD"
+💬 **Conversational Configuration**: Guides through parameter collection step-by-step with sensible defaults
+🎯 **Zero-Knowledge Onboarding**: New users successfully build platforms without documentation
+
+📖 [Learn more →](./docs/mcp-build-platform-guide.md)
+
 ### Documentation Testing & Validation
 📖 **Automated Testing**: Validates documentation by executing commands and testing examples  
 🔍 **Two-Phase Validation**: Tests both functionality (does it work?) and semantic accuracy (are descriptions truthful?)  

package/dist/core/nushell-runtime.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Nushell Runtime Checker
+ *
+ * Detects Nushell installation and provides installation guidance.
+ */
+export interface NushellVersionInfo {
+    installed: boolean;
+    version: string | null;
+    error?: string;
+}
+export declare class NushellRuntime {
+    /**
+     * Check if Nushell is installed on the system
+     */
+    checkInstalled(): Promise<boolean>;
+    /**
+     * Get the installed Nushell version
+     * Returns null if Nushell is not installed
+     */
+    getVersion(): Promise<string | null>;
+    /**
+     * Get comprehensive version information
+     */
+    getVersionInfo(): Promise<NushellVersionInfo>;
+    /**
+     * Get the official installation documentation URL
+     */
+    getInstallationUrl(): string;
+    /**
+     * Validate Nushell installation and return detailed status
+     */
+    validateRuntime(): Promise<{
+        ready: boolean;
+        message: string;
+        versionInfo?: NushellVersionInfo;
+        installationUrl?: string;
+    }>;
+}
+//# sourceMappingURL=nushell-runtime.d.ts.map

package/dist/core/nushell-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nushell-runtime.d.ts","sourceRoot":"","sources":["../../src/core/nushell-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAOD,qBAAa,cAAc;IACzB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IASxC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAW1C;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,kBAAkB,CAAC;IA2BnD;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC;QAC/B,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,kBAAkB,CAAC;QACjC,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CA2BH"}

package/dist/core/nushell-runtime.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * Nushell Runtime Checker
+ *
+ * Detects Nushell installation and provides installation guidance.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NushellRuntime = void 0;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+/**
+ * Official Nushell installation documentation
+ */
+const INSTALL_URL = 'https://www.nushell.sh/book/installation.html';
+class NushellRuntime {
+    /**
+     * Check if Nushell is installed on the system
+     */
+    async checkInstalled() {
+        try {
+            await execAsync('nu --version');
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * Get the installed Nushell version
+     * Returns null if Nushell is not installed
+     */
+    async getVersion() {
+        try {
+            const { stdout } = await execAsync('nu --version');
+            // Parse version from output like "0.95.0" or "nushell 0.95.0"
+            const versionMatch = stdout.trim().match(/(\d+\.\d+\.\d+)/);
+            return versionMatch ? versionMatch[1] : null;
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    /**
+     * Get comprehensive version information
+     */
+    async getVersionInfo() {
+        const installed = await this.checkInstalled();
+        if (!installed) {
+            return {
+                installed: false,
+                version: null,
+                error: 'Nushell is not installed'
+            };
+        }
+        const version = await this.getVersion();
+        if (!version) {
+            return {
+                installed: true,
+                version: null,
+                error: 'Unable to determine Nushell version'
+            };
+        }
+        return {
+            installed: true,
+            version
+        };
+    }
+    /**
+     * Get the official installation documentation URL
+     */
+    getInstallationUrl() {
+        return INSTALL_URL;
+    }
+    /**
+     * Validate Nushell installation and return detailed status
+     */
+    async validateRuntime() {
+        const versionInfo = await this.getVersionInfo();
+        if (!versionInfo.installed) {
+            return {
+                ready: false,
+                message: `Nushell is not installed. Please install Nushell from: ${INSTALL_URL}`,
+                versionInfo,
+                installationUrl: INSTALL_URL
+            };
+        }
+        if (!versionInfo.version) {
+            return {
+                ready: false,
+                message: `Unable to determine Nushell version. Please ensure Nushell is properly installed from: ${INSTALL_URL}`,
+                versionInfo,
+                installationUrl: INSTALL_URL
+            };
+        }
+        return {
+            ready: true,
+            message: `Nushell ${versionInfo.version} is ready`,
+            versionInfo
+        };
+    }
+}
+exports.NushellRuntime = NushellRuntime;

package/dist/core/platform-operations.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Platform Operations Discovery
+ *
+ * Discovers available Nu shell script operations and maps user intent to operations
+ * using AI-powered parsing and matching.
+ */
+import { ClaudeIntegration } from './claude';
+import { Logger } from './error-handling';
+export interface OperationCommand {
+    name: string;
+    command: string[];
+}
+export interface Operation {
+    name: string;
+    description: string;
+    operations: OperationCommand[];
+}
+export interface MatchedOperation {
+    tool: string;
+    operation: string;
+    command: string[];
+    description: string;
+}
+export interface IntentMapping {
+    matched: boolean;
+    operation?: MatchedOperation;
+    reason?: string;
+}
+export interface ParameterMetadata {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'choice';
+    required: boolean;
+    description: string;
+    default?: any;
+    choices?: string[];
+}
+export interface PlatformSession {
+    sessionId: string;
+    intent: string;
+    matchedOperation: MatchedOperation;
+    parameters: ParameterMetadata[];
+    answers: Record<string, any>;
+    currentStep: 'collectParameters' | 'confirm' | 'execute' | 'complete';
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Discover available operations from Nu shell scripts using AI parsing
+ */
+export declare function discoverOperations(claudeIntegration: ClaudeIntegration, logger: Logger): Promise<Operation[]>;
+/**
+ * Map user intent to a specific operation using AI
+ */
+export declare function mapIntentToOperation(intent: string, operations: Operation[], claudeIntegration: ClaudeIntegration, logger: Logger): Promise<IntentMapping>;
+/**
+ * Get parameters for a specific operation using Nushell's structured JSON output
+ */
+export declare function getOperationParameters(command: string[], logger: Logger): Promise<ParameterMetadata[]>;
+/**
+ * Create and persist a platform session
+ */
+export declare function createSession(sessionId: string, intent: string, matchedOperation: MatchedOperation, parameters: ParameterMetadata[], logger: Logger): Promise<PlatformSession>;
+/**
+ * Load a platform session from file
+ */
+export declare function loadSession(sessionId: string, logger: Logger): PlatformSession | null;
+/**
+ * Execute a platform operation with collected parameters
+ */
+export declare function executeOperation(session: PlatformSession, answers: Record<string, any>, logger: Logger): Promise<{
+    success: boolean;
+    message?: string;
+    error?: string;
+    missingParameters?: string[];
+}>;
+//# sourceMappingURL=platform-operations.d.ts.map

package/dist/core/platform-operations.d.ts.map

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

package/dist/core/platform-operations.js

@@ -0,0 +1,317 @@
+"use strict";
+/**
+ * Platform Operations Discovery
+ *
+ * Discovers available Nu shell script operations and maps user intent to operations
+ * using AI-powered parsing and matching.
+ */
+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.discoverOperations = discoverOperations;
+exports.mapIntentToOperation = mapIntentToOperation;
+exports.getOperationParameters = getOperationParameters;
+exports.createSession = createSession;
+exports.loadSession = loadSession;
+exports.executeOperation = executeOperation;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+/**
+ * Get the scripts directory path, works in both development and installed npm package
+ */
+function getScriptsDir() {
+    // In CommonJS (after TypeScript compilation), __dirname is available
+    // Go up from dist/core/ to project root, then into scripts/
+    return path.join(__dirname, '..', '..', 'scripts');
+}
+/**
+ * Strip markdown code blocks from AI response
+ */
+function stripMarkdownCodeBlocks(content) {
+    let jsonContent = content.trim();
+    if (jsonContent.startsWith('```json')) {
+        jsonContent = jsonContent.replace(/^```json\s*/, '').replace(/\s*```$/, '');
+    }
+    else if (jsonContent.startsWith('```')) {
+        jsonContent = jsonContent.replace(/^```\s*/, '').replace(/\s*```$/, '');
+    }
+    return jsonContent;
+}
+/**
+ * Discover available operations from Nu shell scripts using AI parsing
+ */
+async function discoverOperations(claudeIntegration, logger) {
+    try {
+        // Execute Nu script help command
+        const scriptPath = path.join(getScriptsDir(), 'dot.nu');
+        const { stdout, stderr } = await execAsync(`nu ${scriptPath} --help`);
+        if (stderr) {
+            logger.warn?.('Nu script help command produced stderr', { stderr });
+        }
+        // Load AI prompt template for parsing help output
+        const promptPath = path.join(process.cwd(), 'prompts', 'parse-script-operations.md');
+        const promptTemplate = fs.readFileSync(promptPath, 'utf8');
+        // Replace template variable with actual help output
+        const prompt = promptTemplate.replace('{helpOutput}', stdout);
+        // Send to Claude for AI-powered parsing
+        const response = await claudeIntegration.sendMessage(prompt);
+        // Strip markdown code blocks and parse JSON
+        const jsonContent = stripMarkdownCodeBlocks(response.content);
+        const operations = JSON.parse(jsonContent);
+        logger.info?.('Discovered operations from Nu scripts', {
+            count: operations.length
+        });
+        return operations;
+    }
+    catch (error) {
+        logger.error?.('Failed to discover operations', error);
+        throw error;
+    }
+}
+/**
+ * Map user intent to a specific operation using AI
+ */
+async function mapIntentToOperation(intent, operations, claudeIntegration, logger) {
+    try {
+        // Load AI prompt template for intent mapping
+        const promptPath = path.join(process.cwd(), 'prompts', 'map-intent-to-operation.md');
+        const promptTemplate = fs.readFileSync(promptPath, 'utf8');
+        // Replace template variables
+        const prompt = promptTemplate
+            .replace('{intent}', intent)
+            .replace('{operations}', JSON.stringify(operations, null, 2));
+        // Send to Claude for AI-powered intent matching
+        const response = await claudeIntegration.sendMessage(prompt);
+        // Strip markdown code blocks and parse JSON
+        const jsonContent = stripMarkdownCodeBlocks(response.content);
+        const mapping = JSON.parse(jsonContent);
+        // Validate that AI returned required fields
+        if (mapping.matched && mapping.operation) {
+            if (!mapping.operation.command || !Array.isArray(mapping.operation.command)) {
+                throw new Error(`AI did not return valid command array. Response: ${JSON.stringify(mapping)}`);
+            }
+        }
+        logger.info?.('Mapped user intent to operation', {
+            intent,
+            matched: mapping.matched,
+            operation: mapping.operation?.tool,
+            command: mapping.operation?.command
+        });
+        return mapping;
+    }
+    catch (error) {
+        logger.error?.('Failed to map intent to operation', error);
+        throw error;
+    }
+}
+/**
+ * Get parameters for a specific operation using Nushell's structured JSON output
+ */
+async function getOperationParameters(command, logger) {
+    try {
+        // Build the full command name that Nushell expects
+        const commandName = `main ${command.join(' ')}`;
+        // Execute Nu script to get structured command metadata
+        const scriptPath = path.join(getScriptsDir(), 'dot.nu');
+        const nuCommand = `source ${scriptPath}; scope commands | where name == "${commandName}" | to json`;
+        const { stdout, stderr } = await execAsync(`nu -c '${nuCommand}'`);
+        if (stderr) {
+            logger.warn?.('Nu scope commands produced stderr', { stderr });
+        }
+        // Parse JSON response
+        const commands = JSON.parse(stdout);
+        if (!commands || commands.length === 0) {
+            logger.warn?.('No command metadata found', { commandName });
+            return [];
+        }
+        const commandMetadata = commands[0];
+        const signatures = commandMetadata.signatures?.any || [];
+        // Filter and transform parameter data
+        const parameters = [];
+        for (const param of signatures) {
+            // Skip input/output parameters
+            if (param.parameter_type === 'input' || param.parameter_type === 'output') {
+                continue;
+            }
+            // Skip help parameter
+            if (param.parameter_name === 'help') {
+                continue;
+            }
+            // Map Nushell types to our types
+            let type = 'string';
+            if (param.syntax_shape === 'bool') {
+                type = 'boolean';
+            }
+            else if (param.syntax_shape === 'int') {
+                type = 'number';
+            }
+            else if (param.syntax_shape === 'string') {
+                type = 'string';
+            }
+            // Determine if required (positional parameters are typically required)
+            const required = param.parameter_type === 'positional' && !param.is_optional;
+            parameters.push({
+                name: param.parameter_name,
+                type,
+                required,
+                description: param.description || '',
+                default: param.parameter_default
+            });
+        }
+        logger.info?.('Retrieved operation parameters', {
+            command: commandName,
+            parameterCount: parameters.length
+        });
+        return parameters;
+    }
+    catch (error) {
+        logger.error?.('Failed to get operation parameters', error);
+        throw error;
+    }
+}
+/**
+ * Create and persist a platform session
+ */
+async function createSession(sessionId, intent, matchedOperation, parameters, logger) {
+    try {
+        const session = {
+            sessionId,
+            intent,
+            matchedOperation,
+            parameters,
+            answers: {},
+            currentStep: 'collectParameters',
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString()
+        };
+        // Ensure session directory exists
+        const sessionDir = path.join(process.cwd(), 'tmp', 'sessions', 'platform');
+        if (!fs.existsSync(sessionDir)) {
+            fs.mkdirSync(sessionDir, { recursive: true });
+        }
+        // Write session file
+        const sessionPath = path.join(sessionDir, `${sessionId}.json`);
+        fs.writeFileSync(sessionPath, JSON.stringify(session, null, 2), 'utf8');
+        logger.info?.('Created platform session', { sessionId, intent });
+        return session;
+    }
+    catch (error) {
+        logger.error?.('Failed to create platform session', error);
+        throw error;
+    }
+}
+/**
+ * Load a platform session from file
+ */
+function loadSession(sessionId, logger) {
+    try {
+        const sessionPath = path.join(process.cwd(), 'tmp', 'sessions', 'platform', `${sessionId}.json`);
+        if (!fs.existsSync(sessionPath)) {
+            logger.warn?.('Session file not found', { sessionId });
+            return null;
+        }
+        const sessionData = fs.readFileSync(sessionPath, 'utf8');
+        const session = JSON.parse(sessionData);
+        logger.info?.('Loaded platform session', { sessionId });
+        return session;
+    }
+    catch (error) {
+        logger.error?.('Failed to load platform session', error);
+        throw error;
+    }
+}
+/**
+ * Execute a platform operation with collected parameters
+ */
+async function executeOperation(session, answers, logger) {
+    try {
+        // Validate required parameters
+        const missingRequired = session.parameters
+            .filter(p => p.required && !(p.name in answers))
+            .map(p => p.name);
+        if (missingRequired.length > 0) {
+            return {
+                success: false,
+                error: `Missing required parameters: ${missingRequired.join(', ')}`,
+                missingParameters: missingRequired
+            };
+        }
+        // Merge answers with defaults for optional parameters
+        const finalAnswers = { ...answers };
+        for (const param of session.parameters) {
+            if (!(param.name in finalAnswers) && param.default !== undefined) {
+                finalAnswers[param.name] = param.default;
+            }
+        }
+        // Build Nu script command
+        const scriptPath = path.join(getScriptsDir(), 'dot.nu');
+        const command = session.matchedOperation.command;
+        // Build command arguments
+        const args = [];
+        for (const param of session.parameters) {
+            const value = finalAnswers[param.name];
+            if (value !== undefined) {
+                args.push(`--${param.name}`);
+                args.push(String(value));
+            }
+        }
+        const fullCommand = `nu ${scriptPath} ${command.join(' ')} ${args.join(' ')}`;
+        logger.info?.('Executing platform operation', {
+            sessionId: session.sessionId,
+            command: fullCommand
+        });
+        const { stdout, stderr } = await execAsync(fullCommand);
+        if (stderr) {
+            logger.warn?.('Operation produced stderr', { stderr });
+        }
+        logger.info?.('Platform operation completed', {
+            sessionId: session.sessionId,
+            stdout: stdout.substring(0, 500) // Log first 500 chars
+        });
+        return {
+            success: true,
+            message: `Successfully executed ${session.matchedOperation.tool} ${session.matchedOperation.operation}`
+        };
+    }
+    catch (error) {
+        logger.error?.('Failed to execute platform operation', error);
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}

package/dist/interfaces/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/interfaces/mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAwCtC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;CACxC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAC,CAAkC;IACrD,OAAO,CAAC,aAAa,CAAC,CAAgC;IACtD,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe;IAsCjD;;OAEG;IACH,OAAO,CAAC,YAAY;IAsBpB;;OAEG;IACH,OAAO,CAAC,aAAa;IA0GrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqCvB,OAAO,CAAC,iBAAiB;IAInB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAkBd,mBAAmB;YAMnB,kBAAkB;YAiFlB,gBAAgB;IAexB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B,OAAO,IAAI,OAAO;CAGnB"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/interfaces/mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AA8CtC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;CACxC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAC,CAAkC;IACrD,OAAO,CAAC,aAAa,CAAC,CAAgC;IACtD,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe;IAsCjD;;OAEG;IACH,OAAO,CAAC,YAAY;IAsBpB;;OAEG;IACH,OAAO,CAAC,aAAa;IA4HrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqCvB,OAAO,CAAC,iBAAiB;IAInB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAkBd,mBAAmB;YAMnB,kBAAkB;YAiFlB,gBAAgB;IAexB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B,OAAO,IAAI,OAAO;CAGnB"}

package/dist/interfaces/mcp.js

@@ -19,6 +19,7 @@ const version_1 = require("../tools/version");
 const test_docs_1 = require("../tools/test-docs");
 const organizational_data_1 = require("../tools/organizational-data");
 const remediate_1 = require("../tools/remediate");
+const build_platform_1 = require("../tools/build-platform");
 const prompts_1 = require("../tools/prompts");
 const rest_registry_1 = require("./rest-registry");
 const rest_api_1 = require("./rest-api");
@@ -116,6 +117,12 @@ class MCPServer {
             this.logger.info(`Processing ${remediate_1.REMEDIATE_TOOL_NAME} tool request`, { requestId });
             return await (0, remediate_1.handleRemediateTool)(args);
         }, 'Troubleshooting', ['remediation', 'troubleshooting', 'kubernetes', 'analysis']);
+        // Register buildPlatform tool
+        this.registerTool(build_platform_1.BUILD_PLATFORM_TOOL_NAME, build_platform_1.BUILD_PLATFORM_TOOL_DESCRIPTION, build_platform_1.BUILD_PLATFORM_TOOL_INPUT_SCHEMA, async (args) => {
+            const requestId = this.generateRequestId();
+            this.logger.info(`Processing ${build_platform_1.BUILD_PLATFORM_TOOL_NAME} tool request`, { requestId });
+            return await (0, build_platform_1.handleBuildPlatformTool)(args, this.dotAI, this.logger, requestId);
+        }, 'Platform', ['platform', 'kubernetes', 'installation', 'infrastructure']);
         this.logger.info('Registered all tools with McpServer', {
             tools: [
                 recommend_1.RECOMMEND_TOOL_NAME,
@@ -123,8 +130,9 @@ class MCPServer {
                 test_docs_1.TESTDOCS_TOOL_NAME,
                 organizational_data_1.ORGANIZATIONAL_DATA_TOOL_NAME,
                 remediate_1.REMEDIATE_TOOL_NAME,
+                build_platform_1.BUILD_PLATFORM_TOOL_NAME,
             ],
-            totalTools: 5,
+            totalTools: 6,
         });
     }
     /**

package/dist/tools/build-platform.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Build Platform Tool for MCP Server
+ *
+ * AI-powered tool that enables users to build and manage Kubernetes platforms
+ * through natural language intent. Handles script discovery, parameter collection,
+ * and execution transparently.
+ *
+ * Phase 1: Basic invocation and Nushell runtime validation
+ */
+import { z } from 'zod';
+import { Logger } from '../core/error-handling';
+import { DotAI } from '../core/index';
+export declare const BUILD_PLATFORM_TOOL_NAME = "buildPlatform";
+export declare const BUILD_PLATFORM_TOOL_DESCRIPTION = "AI-powered platform operations tool for building and managing Kubernetes platforms. Use this to: (1) LIST/DISCOVER what tools and operations are available - use stage=\"list\" when user asks \"what can I install\", \"show available tools\", \"list platform capabilities\", (2) INSTALL/CREATE platform components like Argo CD, Crossplane, cert-manager, Kubernetes clusters through natural language intent. Handles tool installation, cluster creation, and platform configuration conversationally.";
+export declare const BUILD_PLATFORM_TOOL_INPUT_SCHEMA: {
+    stage: z.ZodOptional<z.ZodString>;
+    intent: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    answers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+};
+/**
+ * Main tool handler - Phase 1 & 2: Script discovery and intent mapping
+ */
+export declare function handleBuildPlatformTool(args: any, dotAI: DotAI, logger: Logger, requestId: string): Promise<any>;
+//# sourceMappingURL=build-platform.d.ts.map

package/dist/tools/build-platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-platform.d.ts","sourceRoot":"","sources":["../../src/tools/build-platform.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGhD,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAItC,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AACxD,eAAO,MAAM,+BAA+B,mfAA2e,CAAC;AAuBxhB,eAAO,MAAM,gCAAgC;;;;;CAY5C,CAAC;AAEF;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,GAAG,EACT,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,CAgQd"}