@onexapis/cli 1.1.45 → 1.1.47

package/dist/cli.mjs

@@ -2673,12 +2673,12 @@ async function validateCommand(options) {
     }
     themeToValidate = options.theme;
   } else {
-    const isThemeDir = [
+    const isThemeDir2 = [
       "theme.config.ts",
       "bundle-entry.ts",
       "manifest.ts"
     ].some((f) => fs.existsSync(path9.join(process.cwd(), f)));
-    if (isThemeDir) {
+    if (isThemeDir2) {
       themeToValidate = path9.basename(process.cwd());
       logger.info(`Validating current theme: ${themeToValidate}`);
     } else {
@@ -3070,12 +3070,12 @@ async function buildCommand(options) {
       process.exit(1);
     }
   } else {
-    const isThemeDir = [
+    const isThemeDir2 = [
       "theme.config.ts",
       "bundle-entry.ts",
       "manifest.ts"
     ].some((f) => fs.existsSync(path9.join(process.cwd(), f)));
-    if (isThemeDir) {
+    if (isThemeDir2) {
       themePath = process.cwd();
       themeName = path9.basename(themePath);
       logger.info(`Building current theme: ${themeName}`);
@@ -3206,12 +3206,12 @@ async function packageCommand(options) {
       process.exit(1);
     }
   } else {
-    const isThemeDir = [
+    const isThemeDir2 = [
       "theme.config.ts",
       "bundle-entry.ts",
       "manifest.ts"
     ].some((f) => fs.existsSync(path9.join(process.cwd(), f)));
-    if (isThemeDir) {
+    if (isThemeDir2) {
       themePath = process.cwd();
       themeName = path9.basename(themePath);
       logger.info(`Packaging current theme: ${themeName}`);
@@ -3747,8 +3747,8 @@ function runInstall(cwd) {
   });
 }
 async function promptThemeName(originalName) {
-  const { default: inquirer7 } = await import('inquirer');
-  const { themeName } = await inquirer7.prompt([
+  const { default: inquirer8 } = await import('inquirer');
+  const { themeName } = await inquirer8.prompt([
     {
       type: "input",
       name: "themeName",
@@ -4225,12 +4225,12 @@ async function devCommand(options) {
       process.exit(1);
     }
   } else {
-    const isThemeDir = [
+    const isThemeDir2 = [
       "theme.config.ts",
       "bundle-entry.ts",
       "manifest.ts"
     ].some((f) => fs.existsSync(path9.join(process.cwd(), f)));
-    if (isThemeDir) {
+    if (isThemeDir2) {
       themePath = process.cwd();
       themeName = path9.basename(themePath);
     } else {
@@ -4658,12 +4658,12 @@ async function publishCommand(options) {
   if (options.theme) {
     themePath = path9.resolve(options.theme);
   } else {
-    const isThemeDir = [
+    const isThemeDir2 = [
       "theme.config.ts",
       "bundle-entry.ts",
       "manifest.ts"
     ].some((f) => fs.existsSync(path9.join(process.cwd(), f)));
-    if (isThemeDir) {
+    if (isThemeDir2) {
       themePath = process.cwd();
     } else {
       logger.error(
@@ -5013,6 +5013,218 @@ async function createZip(sourceDir, outputPath, exclude) {
   });
 }
 
+// src/commands/mcp.ts
+init_logger();
+var AI_CONTEXT_FILES = [
+  "CLAUDE.md",
+  "AGENTS.md",
+  ".cursorrules",
+  "THEME_REFERENCE.md",
+  ".mcp.json"
+];
+function resolveTargetDir(opts) {
+  return path9.resolve(opts.cwd ?? process.cwd());
+}
+function resolveDefaultTemplateDir() {
+  return path9.join(getTemplatesDir(), "default");
+}
+function isThemeDir(dir) {
+  return fs.existsSync(path9.join(dir, "theme.config.ts")) || fs.existsSync(path9.join(dir, "theme.config.js"));
+}
+function inspectFiles(templateDir, targetDir) {
+  return AI_CONTEXT_FILES.map((name) => {
+    const templatePath = path9.join(templateDir, name);
+    const targetPath = path9.join(targetDir, name);
+    const exists = fs.existsSync(targetPath);
+    let identical = false;
+    if (exists && fs.existsSync(templatePath)) {
+      try {
+        const a = fs.readFileSync(templatePath, "utf-8");
+        const b = fs.readFileSync(targetPath, "utf-8");
+        identical = a.replace(/\r\n/g, "\n") === b.replace(/\r\n/g, "\n");
+      } catch {
+        identical = false;
+      }
+    }
+    return { name, templatePath, targetPath, exists, identical };
+  });
+}
+async function mcpSetupCommand(options = {}) {
+  const targetDir = resolveTargetDir(options);
+  const templateDir = resolveDefaultTemplateDir();
+  logger.header("Install OneX MCP context files");
+  logger.log(`Target: ${targetDir}`);
+  logger.log("");
+  if (!isThemeDir(targetDir)) {
+    logger.error(
+      `${targetDir} does not look like an OneX theme (no theme.config.ts found).`
+    );
+    logger.log("Run this command from the root of your theme project.");
+    process.exitCode = 1;
+    return;
+  }
+  const statuses = inspectFiles(templateDir, targetDir);
+  const missing = statuses.filter((s) => !s.exists);
+  if (missing.length === 0) {
+    logger.success("All AI context files are already present.");
+    logger.log(
+      "Run `onexthm mcp upgrade` to refresh them to the latest version."
+    );
+    return;
+  }
+  logger.log(`Will install ${missing.length} file(s):`);
+  for (const s of missing) logger.log(`  + ${s.name}`);
+  logger.log("");
+  if (!options.yes) {
+    const { confirm } = await inquirer.prompt([
+      {
+        type: "confirm",
+        name: "confirm",
+        message: "Proceed?",
+        default: true
+      }
+    ]);
+    if (!confirm) {
+      logger.log("Cancelled.");
+      return;
+    }
+  }
+  for (const s of missing) {
+    if (!fs.existsSync(s.templatePath)) {
+      logger.warning(`  ! ${s.name} not in template \u2014 skipped`);
+      continue;
+    }
+    await fs.copy(s.templatePath, s.targetPath);
+    logger.success(`  \u2713 ${s.name}`);
+  }
+  logger.log("");
+  logger.success("Done. Restart your AI client to pick up the new MCP server.");
+  logger.log("");
+  logger.log("Tip: if your theme uses the Figma MCP, edit .mcp.json and");
+  logger.log(
+    "replace __FIGMA_API_KEY__ with your Figma personal access token."
+  );
+}
+async function mcpUpgradeCommand(options = {}) {
+  const targetDir = resolveTargetDir(options);
+  const templateDir = resolveDefaultTemplateDir();
+  logger.header("Upgrade OneX MCP context files");
+  logger.log(`Target: ${targetDir}`);
+  logger.log("");
+  if (!isThemeDir(targetDir)) {
+    logger.error(
+      `${targetDir} does not look like an OneX theme (no theme.config.ts found).`
+    );
+    process.exitCode = 1;
+    return;
+  }
+  const statuses = inspectFiles(templateDir, targetDir);
+  const toUpgrade = statuses.filter(
+    (s) => !s.identical && s.name !== ".mcp.json"
+  );
+  const mcpJsonStatus = statuses.find((s) => s.name === ".mcp.json");
+  if (mcpJsonStatus && !mcpJsonStatus.exists) {
+    logger.warning(
+      ".mcp.json is missing. Run `onexthm mcp setup` to install it."
+    );
+  }
+  if (toUpgrade.length === 0) {
+    logger.success("All AI context files are already up to date.");
+    return;
+  }
+  logger.log("Files to update:");
+  for (const s of toUpgrade) {
+    const tag = !s.exists ? "+ new" : "~ changed";
+    logger.log(`  ${tag}  ${s.name}`);
+  }
+  logger.log("");
+  logger.log("(.mcp.json is never auto-upgraded \u2014 edit by hand if needed.)");
+  logger.log("");
+  if (!options.yes) {
+    const { confirm } = await inquirer.prompt([
+      {
+        type: "confirm",
+        name: "confirm",
+        message: "Overwrite the file(s) above?",
+        default: true
+      }
+    ]);
+    if (!confirm) {
+      logger.log("Cancelled.");
+      return;
+    }
+  }
+  for (const s of toUpgrade) {
+    if (!fs.existsSync(s.templatePath)) {
+      logger.warning(`  ! ${s.name} not in template \u2014 skipped`);
+      continue;
+    }
+    await fs.copy(s.templatePath, s.targetPath, { overwrite: true });
+    logger.success(`  \u2713 ${s.name}`);
+  }
+  logger.log("");
+  logger.success("Done. Restart your AI client to pick up the new context.");
+}
+async function mcpDoctorCommand(options = {}) {
+  const targetDir = resolveTargetDir(options);
+  const templateDir = resolveDefaultTemplateDir();
+  logger.header("OneX MCP doctor");
+  logger.log(`Target: ${targetDir}`);
+  logger.log("");
+  if (!isThemeDir(targetDir)) {
+    logger.error("Not an OneX theme directory (no theme.config.ts).");
+    process.exitCode = 1;
+    return;
+  }
+  logger.success("theme.config.ts present");
+  const mcpJsonPath = path9.join(targetDir, ".mcp.json");
+  if (!fs.existsSync(mcpJsonPath)) {
+    logger.error(".mcp.json missing \u2014 run `onexthm mcp setup`");
+  } else {
+    try {
+      const mcpJson = JSON.parse(fs.readFileSync(mcpJsonPath, "utf-8"));
+      const servers = mcpJson?.mcpServers ?? {};
+      if (servers.onexthm) {
+        logger.success(".mcp.json registers `onexthm`");
+      } else {
+        logger.error(".mcp.json does not register `onexthm`");
+      }
+      if (servers.figma) {
+        const arg = (servers.figma.args ?? []).join(" ");
+        if (arg.includes("__FIGMA_API_KEY__")) {
+          logger.warning(
+            "figma server uses placeholder API key \u2014 replace __FIGMA_API_KEY__"
+          );
+        } else {
+          logger.success(".mcp.json registers `figma`");
+        }
+      }
+    } catch (err) {
+      logger.error(`.mcp.json could not be parsed: ${err.message}`);
+    }
+  }
+  const statuses = inspectFiles(templateDir, targetDir).filter(
+    (s) => s.name !== ".mcp.json"
+  );
+  for (const s of statuses) {
+    if (!s.exists) {
+      logger.warning(`${s.name} missing`);
+    } else if (!s.identical) {
+      logger.warning(`${s.name} is out of date \u2014 run \`onexthm mcp upgrade\``);
+    } else {
+      logger.success(`${s.name} up to date`);
+    }
+  }
+  const registryPath = path9.join(targetDir, "sections-registry.ts");
+  if (fs.existsSync(registryPath)) {
+    logger.success("sections-registry.ts present");
+  } else {
+    logger.warning(
+      "sections-registry.ts missing \u2014 section tools won't auto-register"
+    );
+  }
+}
+
 // src/cli.ts
 dotenv.config({
   path: path9.join(process.cwd(), ".env.local"),
@@ -5078,6 +5290,14 @@ program.command("config").description("Configure OneX CLI credentials (AWS, API
 program.command("login").description("Login to OneX platform").action(loginCommand);
 program.command("logout").description("Logout from OneX platform").action(logoutCommand);
 program.command("whoami").description("Show current logged-in developer").action(whoamiCommand);
+var mcpCmd = program.command("mcp").description("Manage MCP server registration and AI-context files");
+mcpCmd.command("setup").description(
+  "Install .mcp.json + CLAUDE.md + AGENTS.md + .cursorrules into the current theme"
+).option("-y, --yes", "Skip confirmation prompts").action(mcpSetupCommand);
+mcpCmd.command("upgrade").description(
+  "Refresh AI-context files to the latest version from the bundled template"
+).option("-y, --yes", "Skip confirmation prompts").action(mcpUpgradeCommand);
+mcpCmd.command("doctor").description("Diagnose MCP setup in the current theme directory").action(mcpDoctorCommand);
 program.command("publish").description("Build, scan, and publish theme to marketplace (requires login)").option("-t, --theme <path>", "Theme directory path").option(
   "--bump <type>",
   "Auto-bump version before publish (patch|minor|major)"