@kya-os/cli 1.1.0 → 1.2.0

package/dist/commands/dev.js

@@ -0,0 +1,111 @@
+import chalk from "chalk";
+import { spawn } from "child_process";
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { showError, showInfo } from "../utils/prompts.js";
+/**
+ * Start development server with hot reloading
+ */
+export async function dev() {
+    console.log(chalk.cyan("\n🚀 Starting Development Server\n"));
+    // Check if we're in a valid XMCP-I project
+    const packageJsonPath = join(process.cwd(), "package.json");
+    if (!existsSync(packageJsonPath)) {
+        showError("No package.json found. Are you in a valid project directory?");
+        process.exit(1);
+    }
+    // Check for mcpi dependency
+    try {
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+        const hasmcpi = packageJson.dependencies?.mcpi ||
+            packageJson.devDependencies?.mcpi ||
+            packageJson.dependencies?.["@kya-os/mcp-i"] ||
+            packageJson.devDependencies?.["@kya-os/mcp-i"] ||
+            packageJson.dependencies?.["@kya-os/mcpi"] ||
+            packageJson.devDependencies?.["@kya-os/mcpi"];
+        if (!hasmcpi) {
+            showError("This doesn't appear to be an XMCP-I project. Missing mcpi dependency.");
+            console.log(`\n${chalk.gray("To create a new XMCP-I project:")}`);
+            console.log(`${chalk.cyan("npx @kya-os/create-mcpi-app my-agent")}`);
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        showError("Failed to read package.json");
+        process.exit(1);
+    }
+    // Check for identity
+    const identityPath = join(process.cwd(), ".mcpi", "identity.json");
+    if (!existsSync(identityPath)) {
+        showInfo("No identity found. Run 'mcpi init' to set up identity first.");
+        console.log(`\n${chalk.gray("Setting up identity...")}`);
+        // Import and run init command
+        const { init } = await import("./init.js");
+        await init({});
+        console.log(`\n${chalk.gray("Continuing with development server...")}`);
+    }
+    // Look for common dev scripts or entry points
+    let command = "npm";
+    let args = ["run", "dev"];
+    // Check if there's a dev script in package.json
+    try {
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+        if (!packageJson.scripts?.dev) {
+            // Try alternative approaches
+            if (packageJson.scripts?.start) {
+                args = ["run", "start"];
+            }
+            else if (existsSync(join(process.cwd(), "src", "server.ts"))) {
+                // Use tsx directly if available
+                command = "npx";
+                args = ["tsx", "src/server.ts"];
+            }
+            else if (existsSync(join(process.cwd(), "src", "index.ts"))) {
+                command = "npx";
+                args = ["tsx", "src/index.ts"];
+            }
+            else {
+                showError("No dev script found and no obvious entry point detected.");
+                console.log(`\n${chalk.gray("Expected one of:")}`);
+                console.log(`${chalk.gray("• npm script 'dev' in package.json")}`);
+                console.log(`${chalk.gray("• src/server.ts file")}`);
+                console.log(`${chalk.gray("• src/index.ts file")}`);
+                process.exit(1);
+            }
+        }
+    }
+    catch (error) {
+        showError("Failed to parse package.json");
+        process.exit(1);
+    }
+    console.log(`${chalk.gray("Running:")} ${chalk.cyan(`${command} ${args.join(" ")}`)}`);
+    console.log(`${chalk.gray("Press Ctrl+C to stop")}\n`);
+    // Spawn the development process
+    const child = spawn(command, args, {
+        stdio: "inherit",
+        shell: true,
+        env: {
+            ...process.env,
+            NODE_ENV: "development",
+        },
+    });
+    // Handle process termination
+    process.on("SIGINT", () => {
+        console.log(chalk.yellow("\n\n🛑 Stopping development server..."));
+        child.kill("SIGINT");
+    });
+    process.on("SIGTERM", () => {
+        child.kill("SIGTERM");
+    });
+    child.on("error", (error) => {
+        showError(`Failed to start development server: ${error.message}`);
+        process.exit(1);
+    });
+    child.on("exit", (code) => {
+        if (code !== 0 && code !== null) {
+            showError(`Development server exited with code ${code}`);
+            process.exit(code);
+        }
+    });
+}
+//# sourceMappingURL=dev.js.map

package/dist/commands/dev.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,11 @@
+interface DoctorOptions {
+    json?: boolean;
+    verbose?: boolean;
+}
+/**
+ * Comprehensive system health check for XMCP-I
+ * Implements Requirements 16.2, 16.3, 16.4, 16.5, 16.6
+ */
+export declare function doctor(options?: DoctorOptions): Promise<void>;
+export {};
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AA0BA,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,OAAO,GAAE,aAAkB,iBAiFvD"}

package/dist/commands/doctor.js

@@ -0,0 +1,530 @@
+import chalk from "chalk";
+import ora from "ora";
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { exec } from "child_process";
+import { promisify } from "util";
+import { EnvManager } from "../utils/env-manager.js";
+import { detectPlatform } from "../utils/platform-detector.js";
+import { ktaApi, isKTAAvailable } from "../utils/kta-api.js";
+import { showSuccess, showError, showWarning, } from "../utils/prompts.js";
+const execAsync = promisify(exec);
+/**
+ * Comprehensive system health check for XMCP-I
+ * Implements Requirements 16.2, 16.3, 16.4, 16.5, 16.6
+ */
+export async function doctor(options = {}) {
+    const { json = false, verbose = false } = options;
+    if (!json) {
+        console.log(chalk.cyan("\n🩺 XMCP-I Doctor - System Health Check\n"));
+    }
+    const spinner = json ? null : ora("Running diagnostics...").start();
+    try {
+        // Run all diagnostic checks
+        const [packages, xmcpUpstream, environment, kta, cache] = await Promise.all([
+            checkPackageVersions(verbose),
+            checkXMCPUpstreamCompatibility(verbose),
+            checkEnvironmentConfiguration(verbose),
+            checkKTAConnectivity(verbose),
+            checkNonceCacheConfiguration(verbose),
+        ]);
+        if (spinner) {
+            spinner.succeed("Diagnostics complete");
+        }
+        const result = {
+            packages,
+            xmcpUpstream,
+            environment,
+            kta,
+            cache,
+        };
+        if (json) {
+            const output = {
+                success: true,
+                result,
+                schemaId: "https://schemas.kya-os.ai/mcpi/doctor-result/v1.0.0.json",
+                timestamp: new Date().toISOString(),
+            };
+            console.log(JSON.stringify(output, null, 2));
+        }
+        else {
+            displayDoctorResults(result, verbose);
+        }
+        // Determine exit code based on critical issues
+        const hasCriticalIssues = !environment.valid ||
+            packages.some((p) => !p.compatible) ||
+            !xmcpUpstream.compatible;
+        if (hasCriticalIssues && process.env.NODE_ENV !== "test") {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        if (spinner) {
+            spinner.fail("Diagnostics failed");
+        }
+        const errorMessage = error.message || "Failed to run diagnostics";
+        if (json) {
+            console.log(JSON.stringify({
+                success: false,
+                error: errorMessage,
+                code: "XMCP_I_EDOCTOR",
+            }, null, 2));
+        }
+        else {
+            showError(`Doctor check failed: ${errorMessage}`);
+        }
+        if (process.env.NODE_ENV !== "test") {
+            process.exit(1);
+        }
+    }
+}
+/**
+ * Check all package versions for compatibility (R16.2)
+ */
+async function checkPackageVersions(verbose) {
+    const packages = [];
+    const packageJsonPath = join(process.cwd(), "package.json");
+    if (!existsSync(packageJsonPath)) {
+        return [
+            {
+                name: "package.json",
+                version: "not found",
+                compatible: false,
+                issues: ["No package.json found in current directory"],
+            },
+        ];
+    }
+    try {
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+        const allDeps = {
+            ...packageJson.dependencies,
+            ...packageJson.devDependencies,
+            ...packageJson.peerDependencies,
+        };
+        // Check XMCP-I related packages
+        const xmcpPackages = [
+            "mcpi",
+            "@kya-os/cli",
+            "@kya-os/contracts",
+            "@kya-os/create-mcpi-app",
+            "create-mcpi-app",
+            "@kya-os/mcp-i", // deprecated
+        ];
+        for (const pkgName of xmcpPackages) {
+            const version = allDeps[pkgName];
+            if (version) {
+                const compatible = await checkPackageCompatibility(pkgName, version, verbose);
+                packages.push({
+                    name: pkgName,
+                    version,
+                    compatible: compatible.compatible,
+                    issues: compatible.issues,
+                });
+            }
+        }
+        // Check for deprecated packages
+        if (allDeps["@kya-os/mcp-i"]) {
+            const mcpIPackage = packages.find((p) => p.name === "@kya-os/mcp-i");
+            if (mcpIPackage) {
+                mcpIPackage.issues = mcpIPackage.issues || [];
+                mcpIPackage.issues.push("This package is deprecated. Migrate to 'mcpi'");
+            }
+        }
+    }
+    catch (error) {
+        packages.push({
+            name: "package.json",
+            version: "error",
+            compatible: false,
+            issues: [`Failed to parse package.json: ${error.message}`],
+        });
+    }
+    return packages;
+}
+/**
+ * Check individual package compatibility
+ */
+async function checkPackageCompatibility(name, version, verbose) {
+    const issues = [];
+    let compatible = true;
+    try {
+        // Check if package is installed
+        const { stdout } = await execAsync(`npm list ${name} --depth=0 --json`, {
+            cwd: process.cwd(),
+        });
+        const listResult = JSON.parse(stdout);
+        const installedVersion = listResult.dependencies?.[name]?.version;
+        if (!installedVersion) {
+            compatible = false;
+            issues.push(`Package ${name} is not installed`);
+            return { compatible, issues };
+        }
+        // Version compatibility checks
+        if (name === "mcpi" ||
+            name === "@kya-os/cli" ||
+            name === "@kya-os/contracts") {
+            // These should be on compatible versions (1.x.x)
+            if (!installedVersion.startsWith("1.")) {
+                compatible = false;
+                issues.push(`Expected version 1.x.x, found ${installedVersion}`);
+            }
+        }
+        if (verbose) {
+            issues.push(`Installed version: ${installedVersion}`);
+        }
+    }
+    catch (error) {
+        if (verbose) {
+            issues.push(`Could not verify installation: ${error.message}`);
+        }
+    }
+    return { compatible, issues };
+}
+/**
+ * Verify XMCP upstream version compatibility (R16.3)
+ */
+async function checkXMCPUpstreamCompatibility(verbose) {
+    const issues = [];
+    let compatible = true;
+    let version = "unknown";
+    try {
+        // Check if XMCP is installed
+        const { stdout } = await execAsync("npm list xmcp --depth=0 --json", {
+            cwd: process.cwd(),
+        });
+        const listResult = JSON.parse(stdout);
+        const installedVersion = listResult.dependencies?.xmcp?.version;
+        if (installedVersion) {
+            version = installedVersion;
+            // Check compatibility with known versions
+            // Based on design doc: default caret ^0.3.1
+            const majorVersion = installedVersion.split(".")[0];
+            const minorVersion = installedVersion.split(".")[1];
+            if (majorVersion !== "0" || parseInt(minorVersion) < 3) {
+                compatible = false;
+                issues.push(`XMCP version ${installedVersion} may not be compatible. Expected ^0.3.1`);
+            }
+            if (verbose) {
+                issues.push(`Found XMCP version: ${installedVersion}`);
+            }
+        }
+        else {
+            compatible = false;
+            issues.push("XMCP package not found. This is required for XMCP-I runtime");
+        }
+        // Check for latest version availability
+        if (verbose) {
+            try {
+                const { stdout: viewOutput } = await execAsync("npm view xmcp version");
+                const latestVersion = viewOutput.trim();
+                if (latestVersion !== installedVersion) {
+                    issues.push(`Latest available version: ${latestVersion}`);
+                }
+            }
+            catch (error) {
+                if (verbose) {
+                    issues.push("Could not check latest version");
+                }
+            }
+        }
+    }
+    catch (error) {
+        compatible = false;
+        version = "not found";
+        issues.push("XMCP package not installed");
+        if (verbose) {
+            issues.push(`Error: ${error.message}`);
+        }
+    }
+    return { version, compatible, issues };
+}
+/**
+ * Validate platform environment variables and identity configuration (R16.4)
+ */
+async function checkEnvironmentConfiguration(verbose) {
+    const envManager = new EnvManager();
+    const issues = [];
+    // Check process environment
+    const processVars = envManager.getFromProcess();
+    const { valid, missing } = envManager.validateVariables(processVars);
+    // Check environment files
+    const envFiles = envManager.scanEnvFiles();
+    const hasValidEnvFile = envFiles.some((f) => f.hasmcpidentity && f.exists);
+    // Platform-specific checks
+    const platform = detectPlatform();
+    if (verbose) {
+        issues.push(`Detected platform: ${platform.platform}`);
+        issues.push(`Package manager: ${platform.packageManager}`);
+    }
+    // Environment validation
+    if (!valid && !hasValidEnvFile) {
+        issues.push("No valid environment configuration found");
+        issues.push("Run 'mcpi init' to set up identity");
+    }
+    if (missing.length > 0) {
+        issues.push(`Missing environment variables: ${missing.join(", ")}`);
+    }
+    // Platform-specific environment checks
+    if (platform.platform === "vercel" && process.env.VERCEL) {
+        if (!valid) {
+            issues.push("Running on Vercel but environment variables not configured");
+            issues.push("Add variables to Vercel Dashboard → Settings → Environment Variables");
+        }
+    }
+    // Check .gitignore for security
+    const sensitiveFiles = [".env", ".env.local", ".mcpi/identity.json"];
+    const { missing: notIgnored } = envManager.checkGitignore(sensitiveFiles);
+    if (notIgnored.length > 0) {
+        issues.push(`Sensitive files not in .gitignore: ${notIgnored.join(", ")}`);
+    }
+    // Check identity file in development
+    const identityPath = join(process.cwd(), ".mcpi", "identity.json");
+    if (existsSync(identityPath)) {
+        if (verbose) {
+            issues.push("Development identity file found");
+        }
+        try {
+            const identity = JSON.parse(readFileSync(identityPath, "utf-8"));
+            if (!identity.did || !identity.keyId || !identity.privateKey) {
+                issues.push("Identity file is incomplete or corrupted");
+            }
+        }
+        catch (error) {
+            issues.push("Identity file is corrupted or unreadable");
+        }
+    }
+    return {
+        valid: valid || hasValidEnvFile,
+        missing,
+        issues,
+    };
+}
+/**
+ * Test KTA connectivity and authentication (R16.5)
+ */
+async function checkKTAConnectivity(verbose) {
+    const issues = [];
+    let reachable = false;
+    let authenticated = false;
+    try {
+        // Test basic connectivity
+        reachable = await isKTAAvailable();
+        if (reachable) {
+            if (verbose) {
+                issues.push("KTA endpoint is reachable");
+            }
+            // Test authentication if we have an API key
+            const apiKey = process.env.KYA_VOUCHED_API_KEY || process.env.VOUCHED_API_KEY;
+            if (apiKey) {
+                try {
+                    // Try to make an authenticated request
+                    const envManager = new EnvManager();
+                    const processVars = envManager.getFromProcess();
+                    if (processVars.AGENT_DID) {
+                        await ktaApi.getAgentStatus(processVars.AGENT_DID);
+                        authenticated = true;
+                        if (verbose) {
+                            issues.push("KTA authentication successful");
+                        }
+                    }
+                    else {
+                        issues.push("Cannot test authentication without AGENT_DID");
+                    }
+                }
+                catch (error) {
+                    if (error.message.includes("404")) {
+                        // Agent not found is OK for auth test
+                        authenticated = true;
+                        if (verbose) {
+                            issues.push("KTA authentication successful (agent not registered)");
+                        }
+                    }
+                    else if (error.message.includes("401") ||
+                        error.message.includes("403")) {
+                        issues.push("KTA authentication failed - check API key");
+                    }
+                    else {
+                        issues.push(`KTA authentication test failed: ${error.message}`);
+                    }
+                }
+            }
+            else {
+                issues.push("No KTA API key found - cannot test authentication");
+            }
+        }
+        else {
+            issues.push("KTA endpoint is not reachable");
+            issues.push("Check internet connection and firewall settings");
+        }
+    }
+    catch (error) {
+        issues.push(`KTA connectivity check failed: ${error.message}`);
+    }
+    return { reachable, authenticated, issues };
+}
+/**
+ * Check nonce cache configuration (R16.5)
+ */
+async function checkNonceCacheConfiguration(verbose) {
+    const issues = [];
+    let type = "memory";
+    let functional = true;
+    try {
+        // Detect cache type based on environment
+        if (process.env.REDIS_URL) {
+            type = "redis";
+            // Test Redis connectivity if available
+            try {
+                // This is a basic check - in a real implementation we'd test the actual connection
+                if (verbose) {
+                    issues.push("Redis URL detected");
+                }
+            }
+            catch (error) {
+                functional = false;
+                issues.push("Redis connection failed");
+            }
+        }
+        else if (process.env.AWS_REGION) {
+            type = "dynamodb";
+            if (verbose) {
+                issues.push("AWS region detected - will use DynamoDB cache");
+            }
+        }
+        else if (typeof globalThis !== "undefined" && "caches" in globalThis) {
+            type = "cloudflare-kv";
+            if (verbose) {
+                issues.push("Cloudflare Workers environment detected");
+            }
+        }
+        else {
+            type = "memory";
+            // Memory cache warnings for production
+            if (process.env.NODE_ENV === "production") {
+                issues.push("Using memory cache in production - not suitable for multi-instance deployments");
+                issues.push("Consider configuring Redis, DynamoDB, or Cloudflare KV");
+            }
+            if (verbose) {
+                issues.push("Using in-memory cache (suitable for single-instance only)");
+            }
+        }
+        // Platform-specific cache recommendations
+        const platform = detectPlatform();
+        if (platform.platform === "vercel" && type === "memory") {
+            issues.push("Vercel deployment detected - consider using external cache for multi-region");
+        }
+        if (platform.platform === "lambda" && type === "memory") {
+            issues.push("Lambda deployment detected - consider DynamoDB for persistence");
+        }
+    }
+    catch (error) {
+        functional = false;
+        issues.push(`Cache configuration check failed: ${error.message}`);
+    }
+    return { type, functional, issues };
+}
+/**
+ * Display doctor results in human-readable format
+ */
+function displayDoctorResults(result, verbose) {
+    console.log(chalk.bold("📦 Package Compatibility:"));
+    if (result.packages.length === 0) {
+        console.log(`   ${chalk.yellow("⚠️  No XMCP-I packages found")}`);
+    }
+    else {
+        for (const pkg of result.packages) {
+            const status = pkg.compatible ? chalk.green("✓") : chalk.red("✗");
+            console.log(`   ${status} ${pkg.name}@${pkg.version}`);
+            if (pkg.issues && (verbose || !pkg.compatible)) {
+                pkg.issues.forEach((issue) => {
+                    const color = pkg.compatible ? chalk.gray : chalk.red;
+                    console.log(`     ${color(`• ${issue}`)}`);
+                });
+            }
+        }
+    }
+    console.log(chalk.bold("\n🔗 XMCP Upstream:"));
+    const xmcpStatus = result.xmcpUpstream.compatible
+        ? chalk.green("✓")
+        : chalk.red("✗");
+    console.log(`   ${xmcpStatus} XMCP ${result.xmcpUpstream.version}`);
+    if (result.xmcpUpstream.issues &&
+        (verbose || !result.xmcpUpstream.compatible)) {
+        result.xmcpUpstream.issues.forEach((issue) => {
+            const color = result.xmcpUpstream.compatible ? chalk.gray : chalk.red;
+            console.log(`     ${color(`• ${issue}`)}`);
+        });
+    }
+    console.log(chalk.bold("\n🔐 Environment Configuration:"));
+    const envStatus = result.environment.valid
+        ? chalk.green("✓")
+        : chalk.red("✗");
+    console.log(`   ${envStatus} Environment variables`);
+    if (result.environment.missing.length > 0) {
+        console.log(`     ${chalk.red(`• Missing: ${result.environment.missing.join(", ")}`)}`);
+    }
+    if (result.environment.issues && (verbose || !result.environment.valid)) {
+        result.environment.issues.forEach((issue) => {
+            const color = result.environment.valid ? chalk.gray : chalk.yellow;
+            console.log(`     ${color(`• ${issue}`)}`);
+        });
+    }
+    console.log(chalk.bold("\n🌐 KTA Connectivity:"));
+    const ktaStatus = result.kta.reachable ? chalk.green("✓") : chalk.red("✗");
+    const authStatus = result.kta.authenticated
+        ? chalk.green("authenticated")
+        : chalk.yellow("not authenticated");
+    console.log(`   ${ktaStatus} KTA reachable (${authStatus})`);
+    if (result.kta.issues && (verbose || !result.kta.reachable)) {
+        result.kta.issues.forEach((issue) => {
+            const color = result.kta.reachable ? chalk.gray : chalk.red;
+            console.log(`     ${color(`• ${issue}`)}`);
+        });
+    }
+    console.log(chalk.bold("\n💾 Nonce Cache:"));
+    const cacheStatus = result.cache.functional
+        ? chalk.green("✓")
+        : chalk.red("✗");
+    console.log(`   ${cacheStatus} ${result.cache.type} cache`);
+    if (result.cache.issues && (verbose || !result.cache.functional)) {
+        result.cache.issues.forEach((issue) => {
+            const color = result.cache.functional ? chalk.gray : chalk.yellow;
+            console.log(`     ${color(`• ${issue}`)}`);
+        });
+    }
+    // Overall summary
+    const hasIssues = !result.environment.valid ||
+        result.packages.some((p) => !p.compatible) ||
+        !result.xmcpUpstream.compatible ||
+        !result.kta.reachable;
+    console.log(chalk.bold("\n📊 Summary:"));
+    if (!hasIssues) {
+        showSuccess("All systems operational! 🎉");
+    }
+    else {
+        showWarning("Issues detected that may affect functionality");
+        console.log(chalk.bold("\n💡 Recommended Actions:"));
+        if (!result.environment.valid) {
+            console.log(`   • Run ${chalk.cyan("mcpi init")} to set up identity`);
+        }
+        if (result.packages.some((p) => !p.compatible)) {
+            console.log(`   • Update incompatible packages to latest versions`);
+        }
+        if (!result.xmcpUpstream.compatible) {
+            console.log(`   • Update XMCP to version ^0.3.1 or later`);
+        }
+        if (!result.kta.reachable) {
+            console.log(`   • Check internet connection and firewall settings`);
+        }
+        if (result.cache.type === "memory" &&
+            process.env.NODE_ENV === "production") {
+            console.log(`   • Configure external cache (Redis/DynamoDB/KV) for production`);
+        }
+    }
+    console.log(chalk.bold("\n🔧 Additional Commands:"));
+    console.log(`   ${chalk.cyan("mcpi status")}        - Check agent registration status`);
+    console.log(`   ${chalk.cyan("mcpi env verify")}    - Verify environment configuration`);
+    console.log(`   ${chalk.cyan("mcpi keys rotate")}   - Rotate identity keys`);
+    console.log(`   ${chalk.cyan("mcpi --help")}        - Show all available commands`);
+}
+//# sourceMappingURL=doctor.js.map