@kya-os/create-mcpi-app 1.7.38-canary.2 → 1.7.38

package/src/helpers/rename.ts

@@ -1,17 +0,0 @@
-import fs from "fs-extra";
-import path from "path";
-
-export function renameFiles(projectPath: string): void {
-  const filesToRename = [
-    { from: "_gitignore", to: ".gitignore" },
-  ];
-
-  filesToRename.forEach(({ from, to }) => {
-    const fromPath = path.join(projectPath, from);
-    const toPath = path.join(projectPath, to);
-    
-    if (fs.existsSync(fromPath)) {
-      fs.renameSync(fromPath, toPath);
-    }
-  });
-}

package/src/helpers/validate-project-structure.ts

@@ -1,127 +0,0 @@
-import fs from "fs-extra";
-import path from "path";
-import chalk from "chalk";
-
-interface ProjectStructureValidation {
-  valid: boolean;
-  issues: string[];
-}
-
-/**
- * Validate that the generated project structure meets requirements
- */
-export function validateProjectStructure(
-  projectPath: string,
-  identityEnabled: boolean
-): ProjectStructureValidation {
-  const issues: string[] = [];
-
-  // Check package.json scripts
-  const packageJsonPath = path.join(projectPath, "package.json");
-  if (fs.existsSync(packageJsonPath)) {
-    const packageJson = fs.readJsonSync(packageJsonPath);
-    const scripts = packageJson.scripts || {};
-    const scriptCount = Object.keys(scripts).length;
-
-    if (identityEnabled) {
-      // Should have exactly 8 scripts for identity-enabled projects
-      if (scriptCount !== 8) {
-        issues.push(
-          `Expected exactly 8 scripts for identity project, found ${scriptCount}`
-        );
-      }
-
-      const requiredScripts = [
-        "dev",
-        "build",
-        "start",
-        "init",
-        "register",
-        "keys:rotate",
-        "identity:clean",
-        "status",
-      ];
-
-      for (const script of requiredScripts) {
-        if (!scripts[script]) {
-          issues.push(`Missing required script: ${script}`);
-        }
-      }
-    } else {
-      // Should have exactly 3 scripts for vanilla XMCP projects
-      if (scriptCount !== 3) {
-        issues.push(
-          `Expected exactly 3 scripts for vanilla project, found ${scriptCount}`
-        );
-      }
-
-      const requiredScripts = ["dev", "build", "start"];
-      for (const script of requiredScripts) {
-        if (!scripts[script]) {
-          issues.push(`Missing required script: ${script}`);
-        }
-      }
-    }
-  } else {
-    issues.push("package.json not found");
-  }
-
-  // Check required files exist (based on actual XMCP upstream structure)
-  const requiredFiles = [
-    "src/tools/greet.ts", // XMCP creates greet.ts, not hello.ts
-    ".gitignore",
-    "xmcp.config.ts",
-  ];
-
-  for (const file of requiredFiles) {
-    if (!fs.existsSync(path.join(projectPath, file))) {
-      issues.push(`Missing required file: ${file}`);
-    }
-  }
-
-  // Check .gitignore includes .mcpi/ for identity projects
-  if (identityEnabled) {
-    const gitignorePath = path.join(projectPath, ".gitignore");
-    if (fs.existsSync(gitignorePath)) {
-      const gitignoreContent = fs.readFileSync(gitignorePath, "utf8");
-      if (!gitignoreContent.includes(".mcpi/")) {
-        issues.push(".gitignore should include .mcpi/ directory");
-      }
-    }
-  }
-
-  return {
-    valid: issues.length === 0,
-    issues,
-  };
-}
-
-/**
- * Ensure lockfile is written and not mutated post-generation
- */
-export function ensureLockfile(
-  projectPath: string,
-  packageManager: string
-): void {
-  const lockfiles = {
-    npm: "package-lock.json",
-    yarn: "yarn.lock",
-    pnpm: "pnpm-lock.yaml",
-  };
-
-  const lockfileName = lockfiles[packageManager as keyof typeof lockfiles];
-  if (!lockfileName) {
-    console.warn(chalk.yellow(`Unknown package manager: ${packageManager}`));
-    return;
-  }
-
-  const lockfilePath = path.join(projectPath, lockfileName);
-
-  // The lockfile should be created during npm install
-  // We just validate it exists after installation
-  if (fs.existsSync(lockfilePath)) {
-    console.log(chalk.green(`✅ Lockfile created: ${lockfileName}`));
-  } else {
-    console.warn(chalk.yellow(`⚠️  Lockfile not found: ${lockfileName}`));
-  }
-}

package/src/index.ts

@@ -1,520 +0,0 @@
-#!/usr/bin/env node
-
-import path from "path";
-import fs from "fs-extra";
-import chalk from "chalk";
-import { Command } from "commander";
-import inquirer from "inquirer";
-import ora from "ora";
-import { fileURLToPath } from "url";
-import { checkNodeVersion } from "./utils/check-node.js";
-import { createProject } from "./helpers/create.js";
-import { isFolderEmpty } from "./utils/is-folder-empty.js";
-import { createKYAOSBanner } from "./effects/index.js";
-import {
-  validateProjectName,
-  validateDirectoryAvailability,
-} from "./utils/validate-project-name.js";
-import {
-  resetIdentity,
-  regenerateIdentity,
-} from "./helpers/identity-manager.js";
-
-checkNodeVersion();
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-const packageJson = JSON.parse(
-  fs.readFileSync(path.join(__dirname, "../package.json"), "utf8")
-);
-
-const program = new Command()
-  .name("create-mcpi-app")
-  .description("Create a new MCP-I application with identity features built-in")
-  .version(
-    packageJson.version,
-    "-v, --version",
-    "Output the current version of create-mcpi-app."
-  )
-  .argument("[directory]")
-  .usage("[directory] [options]")
-  .helpOption("-h, --help", "Display help message.")
-  .option("-y, --yes", "Skip confirmation prompt", false)
-  .option("--use-npm", "Use npm as package manager (default: use npm)")
-  .option("--use-yarn", "Use yarn as package manager")
-  .option("--use-pnpm", "Use pnpm as package manager")
-  .option("--skip-install", "Skip installing dependencies", false)
-  .option("--skip-identity", "Skip identity generation", false)
-  .option("--no-identity", "Create plain MCP project without identity features")
-  .option("--vercel", "Add Vercel support for deployment", false)
-  .option("--http", "Enable HTTP transport", false)
-  .option("--stdio", "Enable STDIO transport", false)
-  .option("--local", "Use local mcp-i dependency", false)
-  .option("--mcpi-version <version>", "Specify MCP-I version (e.g., ^1.2.7)")
-  .option("--no-animation", "Skip the black hole animation", false)
-  .option("--fast", "Use shorter animation duration", false)
-  .option(
-    "--platform <name>",
-    "Deployment platform: node (default), cloudflare",
-    "node"
-  )
-  .option("--mode <name>", "Server mode: mcp-i (default), verifier", "mcp-i")
-  .option("--template <name>", "[DEPRECATED] Use --platform and --mode instead")
-  .option("--apikey <key>", "AgentShield API key for Cloudflare deployment")
-  .option(
-    "--project <id>",
-    "AgentShield Project ID for Cloudflare deployment (enables project-scoped tool protection)"
-  )
-  .action(async (projectDir, options) => {
-    console.log(chalk.bold(`\ncreate-mcpi-app@${packageJson.version}`));
-
-    // Show KYA-OS banner
-    const banner = await createKYAOSBanner();
-    console.log(chalk.cyan(banner));
-    console.log(chalk.dim("\nEnhanced with identity features by MCP-I\n"));
-
-    // If project directory wasn't specified, ask for it
-    if (!projectDir) {
-      const answers = await inquirer.prompt([
-        {
-          type: "input",
-          name: "projectDir",
-          message: "What is your project named?",
-          default: "my-mcpi-app",
-        },
-      ]);
-      projectDir = answers.projectDir;
-    }
-
-    // Normalize project directory
-    const resolvedProjectPath = path.resolve(process.cwd(), projectDir);
-    const projectName = path.basename(resolvedProjectPath);
-
-    // Validate project name
-    const nameValidation = validateProjectName(projectName);
-    if (!nameValidation.valid) {
-      console.error(chalk.red("Invalid project name:"));
-      for (const issue of nameValidation.issues) {
-        console.error(chalk.red(`  - ${issue}`));
-      }
-      process.exit(1);
-    }
-
-    // Validate directory availability
-    const dirValidation = validateDirectoryAvailability(resolvedProjectPath);
-    if (!dirValidation.valid) {
-      console.error(chalk.red("Directory validation failed:"));
-      for (const issue of dirValidation.issues) {
-        console.error(chalk.red(`  - ${issue}`));
-      }
-      process.exit(1);
-    }
-
-    let packageManager = "npm";
-    let useLocalXmcp = options.local;
-    let mcpiVersion = options.mcpiVersion;
-    let deployToVercel = options.vercel;
-    let skipInstall = options.skipInstall;
-    let skipIdentity = options.skipIdentity || !options.identity;
-    let transports = ["http"];
-    let agentName = projectName;
-    let agentDescription = "MCP-I server with identity features";
-    let agentRepository = "";
-
-    // Handle platform and mode flags (with backward compatibility for --template)
-    let platform = options.platform || "node";
-    let mode = options.mode || "mcp-i";
-
-    // Backward compatibility: map --template to --platform/--mode
-    if (options.template) {
-      console.log(
-        chalk.yellow(
-          "⚠️  --template is deprecated. Use --platform and --mode instead."
-        )
-      );
-      if (options.template === "cloudflare") {
-        platform = "cloudflare";
-        mode = "verifier";
-      } else if (options.template === "default") {
-        platform = "node";
-        mode = "mcp-i";
-      }
-    }
-
-    // Validate platform and mode combinations
-    const validCombinations = [
-      { platform: "node", mode: "mcp-i" },
-      { platform: "cloudflare", mode: "mcp-i" },
-      { platform: "cloudflare", mode: "verifier" },
-    ];
-
-    const isValid = validCombinations.some(
-      (combo) => combo.platform === platform && combo.mode === mode
-    );
-
-    if (!isValid) {
-      console.error(
-        chalk.red(`\n❌ Invalid platform/mode combination: ${platform}/${mode}`)
-      );
-      console.log(chalk.yellow("\nSupported combinations:"));
-      console.log(chalk.cyan("  - node + mcp-i (default)"));
-      console.log(chalk.cyan("  - cloudflare + mcp-i"));
-      console.log(chalk.cyan("  - cloudflare + verifier"));
-      process.exit(1);
-    }
-
-    // Handle transport selection from CLI options
-    if (options.http || options.stdio) {
-      transports = [];
-      if (options.http) transports.push("http");
-      if (options.stdio) transports.push("stdio");
-    }
-
-    if (!options.yes) {
-      // Package manager selection
-      if (options.useYarn) packageManager = "yarn";
-      if (options.usePnpm) packageManager = "pnpm";
-
-      if (!options.useYarn && !options.usePnpm && !options.useNpm) {
-        const pmAnswers = await inquirer.prompt([
-          {
-            type: "list",
-            name: "packageManager",
-            message: "Select a package manager:",
-            choices: [
-              { name: "npm", value: "npm" },
-              { name: "yarn", value: "yarn" },
-              { name: "pnpm", value: "pnpm" },
-            ],
-            default: "npm",
-          },
-        ]);
-        packageManager = pmAnswers.packageManager;
-      }
-
-      // Transport selection (skip if already specified via CLI options)
-      if (!options.http && !options.stdio) {
-        const transportAnswers = await inquirer.prompt([
-          {
-            type: "checkbox",
-            name: "transports",
-            message: "Select the transports you want to use:",
-            choices: [
-              {
-                name: "HTTP (runs on a server)",
-                value: "http",
-                checked: true,
-              },
-              {
-                name: "STDIO (runs on the user's machine)",
-                value: "stdio",
-                checked: false,
-              },
-            ],
-            validate: (input) => {
-              if (input.length === 0) {
-                return "You must select at least one transport.";
-              }
-              return true;
-            },
-          },
-        ]);
-        transports = transportAnswers.transports;
-      }
-
-      // Vercel deployment option (only for Node.js platform)
-      if (
-        !options.vercel &&
-        transports.includes("http") &&
-        platform === "node"
-      ) {
-        const vercelAnswers = await inquirer.prompt([
-          {
-            type: "confirm",
-            name: "deployToVercel",
-            message: "Add Vercel deployment support?",
-            default: true,
-          },
-        ]);
-        deployToVercel = vercelAnswers.deployToVercel;
-      }
-
-      // Agent information for identity generation
-      if (!skipIdentity) {
-        console.log(chalk.blue("\n🤖 Agent Configuration:"));
-
-        const agentInfo = await inquirer.prompt([
-          {
-            type: "input",
-            name: "name",
-            message: "What's your agent name?",
-            default: projectName,
-          },
-          {
-            type: "input",
-            name: "description",
-            message: "Brief description of your agent:",
-            default: "XMCP-I server with identity features",
-          },
-          {
-            type: "input",
-            name: "repository",
-            message: "Repository URL (optional):",
-            default: "",
-          },
-        ]);
-
-        agentName = agentInfo.name;
-        agentDescription = agentInfo.description;
-        agentRepository = agentInfo.repository;
-      }
-
-      console.log();
-      console.log(
-        `Creating a new xmcp app in ${chalk.green(resolvedProjectPath)}.\n`
-      );
-
-      const { confirmed } = await inquirer.prompt([
-        {
-          type: "confirm",
-          name: "confirmed",
-          message: "Ok to continue?",
-          default: true,
-        },
-      ]);
-
-      if (!confirmed) {
-        console.log(chalk.yellow("Aborting installation."));
-        process.exit(0);
-      }
-    } else {
-      // Use command-line options when --yes is provided
-      if (options.useYarn) packageManager = "yarn";
-      if (options.usePnpm) packageManager = "pnpm";
-    }
-
-    const spinner = ora(
-      "Creating your xmcp-i app with identity features..."
-    ).start();
-
-    try {
-      spinner.text = "Scaffolding project structure...";
-
-      const result = await createProject({
-        projectPath: resolvedProjectPath,
-        projectName,
-        packageManager,
-        transports: transports,
-        packageVersion: packageJson.version,
-        useLocalXmcp,
-        mcpiVersion,
-        deployToVercel,
-        skipInstall,
-        agentName,
-        agentDescription,
-        agentRepository,
-        skipIdentity,
-        skipAnimation: options.noAnimation === false ? true : false, // Handle --no-animation flag
-        fastAnimation: options.fast,
-        spinner, // Pass spinner to stop it before animation
-        platform, // Pass platform (node, cloudflare)
-        mode, // Pass mode (mcp-i, verifier)
-        template: options.template || "default", // Keep for backward compatibility
-        apikey: options.apikey, // Pass AgentShield API key for Cloudflare
-        projectId: options.project, // Pass AgentShield Project ID for Cloudflare
-      });
-
-      if (!result.success) {
-        spinner.fail(chalk.red("Failed to create the project."));
-        if (result.warnings) {
-          for (const warning of result.warnings) {
-            console.error(chalk.red(`  ${warning}`));
-          }
-        }
-        process.exit(1);
-      }
-
-      if (result.warnings && result.warnings.length > 0) {
-        spinner.warn(chalk.yellow("Your xmcp-i app is ready with warnings"));
-        for (const warning of result.warnings) {
-          console.warn(chalk.yellow(`  ⚠️  ${warning}`));
-        }
-      } else {
-        spinner.succeed(chalk.green("Your xmcp-i app is ready"));
-      }
-
-      console.log();
-      console.log("Next Steps:");
-
-      // Show different instructions based on platform/mode
-      if (platform === "cloudflare") {
-        // Cloudflare Worker instructions (both verifier and mcp-i)
-        console.log("1. Install dependencies:");
-        if (resolvedProjectPath !== process.cwd()) {
-          console.log(`  cd ${chalk.cyan(projectDir)}`);
-        }
-        if (skipInstall) {
-          if (packageManager === "yarn") {
-            console.log(`  ${chalk.cyan("yarn install")}`);
-          } else if (packageManager === "pnpm") {
-            console.log(`  ${chalk.cyan("pnpm install")}`);
-          } else {
-            console.log(`  ${chalk.cyan("npm install")}`);
-          }
-        }
-        console.log();
-        console.log("2. Create KV namespaces (creates both NONCE and PROOF):");
-        console.log(
-          `  ${chalk.cyan(`${packageManager === "npm" ? "npm run" : packageManager} kv:create`)}`
-        );
-        console.log(
-          chalk.gray(
-            "   Copy both namespace IDs from output and update wrangler.toml"
-          )
-        );
-        console.log();
-        console.log("3. Test locally:");
-        console.log(
-          `  ${chalk.cyan(`${packageManager === "npm" ? "npm run" : packageManager} dev`)}`
-        );
-        console.log();
-        console.log("4. Deploy to Cloudflare:");
-        console.log(
-          `  ${chalk.cyan("npx wrangler login")} ${chalk.gray("(first time only)")}`
-        );
-        console.log(
-          `  ${chalk.cyan(`${packageManager === "npm" ? "npm run" : packageManager} deploy`)}`
-        );
-      } else {
-        // Default MCP-I server instructions
-        // Show agent management with claim URL first
-        if (!skipIdentity) {
-          console.log("Agent management:");
-          console.log("  Follow the Claim URL above to claim your agent");
-          if (resolvedProjectPath !== process.cwd()) {
-            console.log(`  cd ${chalk.cyan(projectDir)}`);
-          }
-          console.log(
-            `  ${chalk.cyan(`${packageManager} run status`)} - Check agent status`
-          );
-          console.log(
-            `  ${chalk.cyan(`${packageManager} run register`)} - Register with registry`
-          );
-          console.log();
-        }
-
-        console.log("Start agent:");
-        if (resolvedProjectPath !== process.cwd()) {
-          console.log(`  cd ${chalk.cyan(projectDir)}`);
-        }
-
-        if (skipInstall) {
-          if (packageManager === "yarn") {
-            console.log(`  ${chalk.cyan("yarn install")}`);
-          } else if (packageManager === "pnpm") {
-            console.log(`  ${chalk.cyan("pnpm install")}`);
-          } else {
-            console.log(`  ${chalk.cyan("npm install")}`);
-          }
-        }
-
-        // Show appropriate command based on transport
-        if (transports.includes("stdio")) {
-          console.log(`  ${chalk.cyan("npx xmcp build")}`);
-        } else {
-          // HTTP transport - show dev command
-          if (packageManager === "yarn") {
-            console.log(`  ${chalk.cyan("yarn dev")}`);
-          } else if (packageManager === "pnpm") {
-            console.log(`  ${chalk.cyan("pnpm dev")}`);
-          } else {
-            console.log(`  ${chalk.cyan("npm run dev")}`);
-          }
-        }
-
-        console.log();
-        console.log("Manage identity:");
-        if (resolvedProjectPath !== process.cwd()) {
-          console.log(`  cd ${chalk.cyan(projectDir)}`);
-        }
-
-        // Show identity management commands
-        if (packageManager === "yarn") {
-          console.log(
-            `  ${chalk.cyan("yarn keys:rotate")} - Rotate cryptographic keys`
-          );
-          console.log(
-            `  ${chalk.cyan("yarn identity:clean")} - Clean identity data`
-          );
-        } else if (packageManager === "pnpm") {
-          console.log(
-            `  ${chalk.cyan("pnpm keys:rotate")} - Rotate cryptographic keys`
-          );
-          console.log(
-            `  ${chalk.cyan("pnpm identity:clean")} - Clean identity data`
-          );
-        } else {
-          console.log(
-            `  ${chalk.cyan("npm run keys:rotate")} - Rotate cryptographic keys`
-          );
-          console.log(
-            `  ${chalk.cyan("npm run identity:clean")} - Clean identity data`
-          );
-        }
-      }
-
-      console.log();
-
-      // Explicitly exit after successful completion
-      process.exit(0);
-    } catch (error) {
-      spinner.fail(chalk.red("Failed to create the project."));
-      console.error(error);
-      process.exit(1);
-    }
-  });
-
-// Add subcommand for resetting identity
-program
-  .command("reset-identity")
-  .description("Reset the current project's identity (removes identity files)")
-  .option(
-    "-d, --dir <directory>",
-    "Project directory (defaults to current directory)"
-  )
-  .action(async (options) => {
-    try {
-      const projectPath = options.dir
-        ? path.resolve(process.cwd(), options.dir)
-        : process.cwd();
-      await resetIdentity(projectPath);
-    } catch (error) {
-      console.error(chalk.red("Failed to reset identity:"), error);
-      process.exit(1);
-    }
-  });
-
-// Add subcommand for regenerating identity
-program
-  .command("regenerate-identity")
-  .description(
-    "Regenerate the current project's identity (creates new DID and keys)"
-  )
-  .option(
-    "-d, --dir <directory>",
-    "Project directory (defaults to current directory)"
-  )
-  .action(async (options) => {
-    try {
-      const projectPath = options.dir
-        ? path.resolve(process.cwd(), options.dir)
-        : process.cwd();
-      await regenerateIdentity(projectPath);
-    } catch (error) {
-      console.error(chalk.red("Failed to regenerate identity:"), error);
-      process.exit(1);
-    }
-  });
-
-program.parse(process.argv);