lism-cli 0.7.0 → 0.9.0

package/dist/index.js

@@ -3,7 +3,8 @@ import {
   DEFAULT_SKILL_REF,
   DEFAULT_UI_REF,
   RAW_GITHUB_BASE,
-  SKILL_SOURCE_PATH,
+  SKILL_NAMES,
+  SKILL_SOURCE_BASE,
   SOURCE_REPO,
   UI_COMPONENTS_PATH,
   UI_HELPER_PATH,
@@ -13,13 +14,13 @@ import {
   preScanLang,
   setLang,
   t
-} from "./chunk-6E4LIZPL.js";
+} from "./chunk-BEY36YDC.js";
 
 // src/createProgram.ts
-import { Command as Command3 } from "commander";
+import { Command as Command4 } from "commander";
 
 // src/commands/ui/index.ts
-import { Command, Option } from "commander";
+import { Command as Command2 } from "commander";
 
 // src/commands/ui/add.ts
 import fs3 from "fs";
@@ -30,209 +31,91 @@ import { confirm, select as select2 } from "@inquirer/prompts";
 import fs from "fs";
 import path from "path";
 import { createJiti } from "jiti";
-
-// src/invokeCommand.ts
-function getInvokeCommand() {
-  const scriptPath = process.argv[1] ?? "";
-  const userAgent = process.env.npm_config_user_agent ?? "";
-  const normalizedScriptPath = normalizePath(scriptPath);
-  const inDlxCache = /\/_npx\//.test(normalizedScriptPath) || /\/pnpm(?:-cache)?\/(?:[^/]+\/)*dlx-[^/]+\//.test(normalizedScriptPath) || /\/\.yarn\/berry\/cache\//.test(normalizedScriptPath) || /\/\.bun\/install\/cache\//.test(normalizedScriptPath);
-  const inLocalDependency = isInProjectNodeModules(normalizedScriptPath) && (/\/node_modules\/\.bin\/lism(?:\.(?:cmd|ps1))?$/.test(normalizedScriptPath) || /\/node_modules\/lism-cli\/bin\/lism\.mjs$/.test(normalizedScriptPath));
-  if (inDlxCache) return getDlxInvokeCommand(userAgent);
-  if (inLocalDependency) return getLocalInvokeCommand(userAgent);
-  return "lism";
-}
-function getDlxInvokeCommand(userAgent) {
-  if (userAgent.startsWith("pnpm/")) return "pnpm dlx lism-cli";
-  if (userAgent.startsWith("yarn/")) return "yarn dlx lism-cli";
-  if (userAgent.startsWith("bun/")) return "bunx lism-cli";
-  return "npx lism-cli";
-}
-function getLocalInvokeCommand(userAgent) {
-  if (userAgent.startsWith("pnpm/")) return "pnpm exec lism";
-  if (userAgent.startsWith("yarn/")) return "yarn lism";
-  if (userAgent.startsWith("bun/")) return "bun run lism";
-  return "npx lism-cli";
-}
-function isInProjectNodeModules(scriptPath) {
-  let dir = normalizePath(process.cwd());
-  while (dir) {
-    if (scriptPath.startsWith(`${dir}/node_modules/`)) return true;
-    const parent = dir.slice(0, dir.lastIndexOf("/"));
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return false;
-}
-function normalizePath(value) {
-  return value.replaceAll("\\", "/").replace(/\/+$/, "");
-}
-
-// src/config.ts
-var LEGACY_CONFIG_FILE = "lism-ui.json";
-var CONFIG_SEARCH = ["lism.config.js", "lism.config.mjs"];
+var CONFIG_SEARCH = ["lism.config.ts", "lism.config.mjs", "lism.config.js"];
 function resolvePath(filename) {
   return path.resolve(process.cwd(), filename);
 }
 function findConfigFile() {
   for (const name of CONFIG_SEARCH) {
     const abs = resolvePath(name);
-    if (fs.existsSync(abs)) return { path: abs, filename: name, kind: "module" };
+    if (fs.existsSync(abs)) return { path: abs, filename: name };
   }
-  const legacy = resolvePath(LEGACY_CONFIG_FILE);
-  if (fs.existsSync(legacy)) return { path: legacy, filename: LEGACY_CONFIG_FILE, kind: "legacy-json" };
   return null;
 }
-function configExists() {
-  return findConfigFile() !== null;
-}
 var DEFAULT_CONFIG_FILENAME = "lism.config.js";
 function getDefaultConfigPath() {
   return resolvePath(DEFAULT_CONFIG_FILENAME);
 }
 async function readConfig() {
   const found = findConfigFile();
-  if (!found) {
-    throw new Error(t("config.notFound"));
-  }
-  if (found.kind === "legacy-json") {
-    logger.warn(t("config.legacyWarning", { filename: LEGACY_CONFIG_FILE, invoke: getInvokeCommand() }));
-    const raw = fs.readFileSync(found.path, "utf-8");
-    const parsed = JSON.parse(raw);
-    return parsed;
-  }
+  if (!found) return null;
   const jiti = createJiti(import.meta.url, { interopDefault: true });
-  const mod = await jiti.import(found.path);
-  const cli = mod?.cli ?? mod;
-  if (!cli || typeof cli !== "object") {
-    throw new Error(t("config.cliSectionMissing", { filename: found.filename }));
+  let mod;
+  try {
+    mod = await jiti.import(found.path);
+  } catch (err) {
+    throw new Error(t("config.loadFailed", { path: found.path, reason: String(err) }));
+  }
+  const modObj = mod;
+  const hasUiKey = modObj?.ui !== void 0;
+  const hasCliKey = modObj?.cli !== void 0;
+  if (hasUiKey || hasCliKey) {
+    if (!hasUiKey && hasCliKey) {
+      logger.warn(t("config.cliKeyDeprecated", { filename: found.filename }));
+    }
+    return normalizeUiConfig(hasUiKey ? modObj.ui : modObj.cli);
+  }
+  try {
+    return normalizeUiConfig(modObj);
+  } catch {
+    return null;
   }
-  validateCliConfig(cli);
-  return cli;
 }
-function validateCliConfig(cli) {
-  const c = cli;
+function normalizeUiConfig(raw) {
+  const c = raw ?? {};
   if (c.framework !== "react" && c.framework !== "astro") {
     throw new Error(t("config.invalidFramework"));
   }
-  if (typeof c.componentsDir !== "string" || !c.componentsDir) {
-    throw new Error(t("config.invalidComponentsDir"));
-  }
-  if (typeof c.helperDir !== "string" || !c.helperDir) {
-    throw new Error(t("config.invalidHelperDir"));
+  const dir = c.dir !== void 0 ? c.dir : c.componentsDir;
+  if (typeof dir !== "string" || !dir) {
+    throw new Error(t("config.invalidDir"));
   }
+  return { framework: c.framework, dir };
 }
-function writeFreshConfig(cli) {
+function writeFreshConfig(ui) {
   const filePath = getDefaultConfigPath();
-  const body = renderConfigTemplate(cli);
+  if (fs.existsSync(filePath)) {
+    throw new Error(t("config.freshConfigExists", { path: filePath }));
+  }
+  const body = renderConfigTemplate(ui);
   fs.writeFileSync(filePath, body);
   return filePath;
 }
-async function hasCliSection(filePath) {
-  try {
-    const jiti = createJiti(import.meta.url, { interopDefault: true });
-    const mod = await jiti.import(filePath);
-    return !!mod?.cli;
-  } catch (err) {
-    throw new Error(t("config.loadFailed", { path: filePath, reason: String(err) }));
-  }
-}
-async function patchConfigWithCli(cli, targetPath, options = {}) {
-  const filePath = targetPath ?? getDefaultConfigPath();
-  let source = fs.readFileSync(filePath, "utf-8");
-  const hasExisting = options.existingCli ?? await hasCliSection(filePath);
-  if (hasExisting) {
-    if (!options.force) {
-      return { path: filePath, patched: false };
-    }
-    const removed = removeCliSection(source);
-    if (removed === null) {
-      return { path: filePath, patched: false };
-    }
-    source = removed;
-  }
-  const insertAt = findInsertPosition(source);
-  if (insertAt === -1) {
-    return { path: filePath, patched: false };
-  }
-  const insertion = `
-  cli: ${renderCliObject(cli, "  ")},`;
-  const updated = source.slice(0, insertAt) + insertion + source.slice(insertAt);
-  fs.writeFileSync(filePath, updated);
-  return { path: filePath, patched: true };
-}
-function removeCliSection(source) {
-  const match = source.match(/(^|[\n,{])(\s*)cli\s*:\s*\{/);
-  if (!match) return null;
-  const sectionStart = match.index + match[1].length + match[2].length;
-  const openBrace = match.index + match[0].length - 1;
-  let i = openBrace + 1;
-  let depth = 1;
-  while (i < source.length && depth > 0) {
-    const c = source[i];
-    if (c === '"' || c === "'" || c === "`") {
-      const quote = c;
-      i++;
-      while (i < source.length && source[i] !== quote) {
-        if (source[i] === "\\") i++;
-        i++;
-      }
-      i++;
-      continue;
-    }
-    if (c === "/" && source[i + 1] === "/") {
-      while (i < source.length && source[i] !== "\n") i++;
-      continue;
-    }
-    if (c === "/" && source[i + 1] === "*") {
-      i += 2;
-      while (i < source.length - 1 && !(source[i] === "*" && source[i + 1] === "/")) i++;
-      i += 2;
-      continue;
-    }
-    if (c === "{") depth++;
-    else if (c === "}") depth--;
-    i++;
-  }
-  if (depth !== 0) return null;
-  let end = i;
-  if (source[end] === ",") end++;
-  const trailing = source.slice(end).match(/^[ \t]*\n/);
-  if (trailing) end += trailing[0].length;
-  return source.slice(0, sectionStart) + source.slice(end);
-}
-function findInsertPosition(source) {
-  const inline = source.match(/export default\s*(?:[A-Za-z_$][A-Za-z0-9_$]*\s*)?\(?\s*\{/);
-  if (inline) {
-    return inline.index + inline[0].length;
-  }
-  const varExport = source.match(/export default\s+([A-Za-z_$][A-Za-z0-9_$]*)\s*;?/);
-  if (varExport) {
-    const varName = varExport[1];
-    const escaped = varName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    const decl = source.match(new RegExp(`(?:const|let|var)\\s+${escaped}\\s*=\\s*(?:[A-Za-z_$][A-Za-z0-9_$]*\\s*)?\\(?\\s*\\{`));
-    if (decl) {
-      return decl.index + decl[0].length;
-    }
-  }
-  return -1;
-}
-function renderConfigTemplate(cli) {
-  return [
+function renderConfigTemplate(ui) {
+  const lines = [
+    // `.js` でもエディタ補完・typo 検出が効くように LismConfig 型（#449）を JSDoc で付与する
+    "/** @type {import('lism-css/config-types').LismConfig} */",
     "export default {",
-    //
-    `  cli: ${renderCliObject(cli, "  ")},`,
-    "};",
-    ""
-  ].join("\n");
+    "  // tokens: {},",
+    "  // props: {},",
+    "  // traits: {},",
+    "  // breakpoints: {},"
+  ];
+  if (ui) {
+    lines.push(`  ui: ${renderCliObject(ui, "  ")},`);
+  }
+  lines.push("};", "");
+  return lines.join("\n");
+}
+function renderUiSnippet(cli) {
+  return `ui: ${renderCliObject(cli, "")},`;
 }
 function renderCliObject(cli, indent) {
   return [
     "{",
     //
     `${indent}  framework: ${JSON.stringify(cli.framework)},`,
-    `${indent}  componentsDir: ${JSON.stringify(cli.componentsDir)},`,
-    `${indent}  helperDir: ${JSON.stringify(cli.helperDir)},`,
+    `${indent}  dir: ${JSON.stringify(cli.dir)},`,
     `${indent}}`
   ].join("\n");
 }
@@ -400,63 +283,18 @@ async function fetchHelper(name, options = {}) {
   return { name, files };
 }
 
-// src/commands/ui/init.ts
-import { select, input } from "@inquirer/prompts";
-async function runInit(options = {}) {
+// src/commands/ui/promptUiConfig.ts
+import { select } from "@inquirer/prompts";
+async function promptUiConfig(options = {}) {
   const framework = options.framework ?? await select({
-    message: t("ui.init.promptFramework"),
+    message: t("ui.promptFramework"),
     choices: [
       { name: "React", value: "react" },
       { name: "Astro", value: "astro" }
     ]
   });
-  const componentsDir = options.componentsDir ?? await input({
-    message: t("ui.init.promptComponentsDir"),
-    default: "src/components/ui"
-  });
-  const helperDir = options.helperDir ?? await input({
-    message: t("ui.init.promptHelperDir"),
-    default: `${componentsDir}/_helper`
-  });
-  const config = { framework, componentsDir, helperDir };
-  const found = findConfigFile();
-  if (found?.kind === "module") {
-    const { patched, path: outPath } = await patchConfigWithCli(config, found.path, {
-      force: options.force,
-      existingCli: options.existingCli
-    });
-    if (patched) {
-      logger.success(t(options.force ? "ui.init.patchedUpdate" : "ui.init.patchedAdd", { path: outPath }));
-    } else {
-      logger.warn(t("ui.init.notPatched", { path: outPath }));
-    }
-  } else {
-    const outPath = writeFreshConfig(config);
-    logger.success(t("ui.init.created", { path: outPath }));
-  }
-  return config;
-}
-async function initCommand(options) {
-  const found = findConfigFile();
-  let existingCli = false;
-  if (found?.kind === "legacy-json") {
-    logger.warn(t("ui.init.legacyDetected", { filename: found.filename }));
-  } else if (found?.kind === "module") {
-    try {
-      existingCli = await hasCliSection(found.path);
-    } catch (err) {
-      logger.error(err instanceof Error ? err.message : String(err));
-      process.exit(1);
-    }
-    if (existingCli) {
-      if (!options.force) {
-        logger.warn(t("ui.init.alreadyExists", { filename: found.filename }));
-        return;
-      }
-      logger.warn(t("ui.init.willOverwrite", { filename: found.filename }));
-    }
-  }
-  await runInit({ ...options, existingCli });
+  const dir = options.dir ?? "src/components/ui";
+  return { framework, dir };
 }
 
 // src/commands/ui/normalize.ts
@@ -464,12 +302,12 @@ var normalizeComponentName = (s) => s.replace(/[-_]/g, "").toLowerCase();
 
 // src/commands/ui/add.ts
 async function addCommand(names, options) {
-  let config;
-  if (configExists()) {
-    config = await readConfig();
-  } else {
+  let config = await readConfig();
+  let needsGuidance = false;
+  if (!config) {
+    needsGuidance = true;
     logger.info(t("ui.add.noConfig"));
-    config = await runInit();
+    config = await promptUiConfig({ framework: options.uiFramework, dir: options.uiDir });
     console.log();
   }
   const fetchOpts = { ref: options.ref };
@@ -492,11 +330,11 @@ async function addCommand(names, options) {
   }
   const resolvedNames = [];
   const notFound = [];
-  for (const input2 of names) {
-    const normalized = normalizeComponentName(input2);
+  for (const input of names) {
+    const normalized = normalizeComponentName(input);
     const match = catalog.components.find((c) => normalizeComponentName(c.name) === normalized);
     if (match) resolvedNames.push(match.name);
-    else notFound.push(input2);
+    else notFound.push(input);
   }
   if (notFound.length > 0) {
     logger.error(t("ui.add.notFound", { list: notFound.join(", ") }));
@@ -521,6 +359,10 @@ async function addCommand(names, options) {
     const helperFailed = await writeComponent(result.value, config, overwriteAll, overwritePolicy, installedHelpers, fetchOpts);
     if (helperFailed) hasFailure = true;
   }
+  if (needsGuidance) {
+    const filename = findConfigFile()?.filename ?? DEFAULT_CONFIG_FILENAME;
+    logger.info(t("ui.add.snippetGuide", { filename, snippet: renderUiSnippet(config) }));
+  }
   if (hasFailure) {
     logger.error(t("ui.add.someFailed"));
     process.exit(1);
@@ -549,8 +391,8 @@ async function writeComponent(component, config, overwriteAll, policy, installed
   logger.info(t("ui.add.deploying", { name: component.name }));
   const filesToWrite = [...component.files.shared, ...component.files[config.framework]];
   const componentDirName = component.name;
-  const componentDir = path4.resolve(process.cwd(), config.componentsDir, componentDirName);
-  const helperDir = path4.resolve(process.cwd(), config.helperDir);
+  const componentDir = path4.resolve(process.cwd(), config.dir, componentDirName);
+  const helperDir = path4.resolve(process.cwd(), config.dir, "_helper");
   let shouldWrite;
   const hasExisting = hasExistingFiles(filesToWrite, componentDir);
   if (overwriteAll) {
@@ -638,17 +480,23 @@ Lism UI v${catalog.version}
 ${t("ui.list.total", { count: catalog.components.length })}`);
 }
 
+// src/commands/ui/uiSectionOptions.ts
+import { Option } from "commander";
+function applyUiSectionOptions(command) {
+  return command.addOption(new Option("--ui-framework <name>", t("cli.init.opt.uiFramework")).choices(["react", "astro"])).option("--ui-dir <path>", t("cli.init.opt.uiDir"));
+}
+
 // src/commands/ui/index.ts
 function createUiCommand() {
-  const ui = new Command("ui").description(t("cli.ui.description"));
-  ui.command("init").description(t("cli.ui.init.description")).addOption(new Option("--framework <name>", t("cli.ui.init.opt.framework")).choices(["react", "astro"])).option("--components-dir <path>", t("cli.ui.init.opt.componentsDir")).option("--helper-dir <path>", t("cli.ui.init.opt.helperDir")).option("-f, --force", t("cli.ui.init.opt.force"), false).action(initCommand);
-  ui.command("add").description(t("cli.ui.add.description")).argument("[names...]", t("cli.ui.add.arg.names")).option("-o, --overwrite", t("cli.ui.add.opt.overwrite"), false).option("-a, --all", t("cli.ui.add.opt.all"), false).option("--ref <ref>", t("cli.ui.opt.ref")).action(addCommand);
+  const ui = new Command2("ui").description(t("cli.ui.description"));
+  const add = ui.command("add").description(t("cli.ui.add.description")).argument("[names...]", t("cli.ui.add.arg.names")).option("-o, --overwrite", t("cli.ui.add.opt.overwrite"), false).option("-a, --all", t("cli.ui.add.opt.all"), false);
+  applyUiSectionOptions(add).option("--ref <ref>", t("cli.ui.opt.ref")).action(addCommand);
   ui.command("list").description(t("cli.ui.list.description")).option("--ref <ref>", t("cli.ui.opt.ref")).action(listCommand);
   return ui;
 }
 
 // src/commands/skill/index.ts
-import { Command as Command2 } from "commander";
+import { Command as Command3 } from "commander";
 
 // src/commands/skill/add.ts
 import fs5 from "fs";
@@ -657,15 +505,18 @@ import { checkbox, confirm as confirm2 } from "@inquirer/prompts";
 
 // src/commands/skill/paths.ts
 var SKILL_PATHS = {
-  claude: ".claude/skills/lism-css-guide",
-  codex: ".agents/skills/lism-css-guide",
-  cursor: ".cursor/skills/lism-css-guide",
-  windsurf: ".windsurf/skills/lism-css-guide",
-  cline: ".cline/skills/lism-css-guide",
-  copilot: ".github/skills/lism-css-guide",
-  gemini: ".gemini/skills/lism-css-guide",
-  junie: ".junie/skills/lism-css-guide"
+  claude: ".claude/skills",
+  codex: ".agents/skills",
+  cursor: ".cursor/skills",
+  windsurf: ".windsurf/skills",
+  cline: ".cline/skills",
+  copilot: ".github/skills",
+  gemini: ".gemini/skills",
+  junie: ".junie/skills"
 };
+function skillDestDir(tool, skill) {
+  return `${SKILL_PATHS[tool]}/${skill}`;
+}
 var ALL_SKILL_TOOLS = Object.keys(SKILL_PATHS);
 var TOOL_MARKERS = {
   claude: [".claude"],
@@ -684,9 +535,9 @@ import fs4 from "fs";
 import os2 from "os";
 import path5 from "path";
 import { downloadTemplate as downloadTemplate2 } from "giget";
-async function fetchSkillSource(ref = DEFAULT_SKILL_REF) {
+async function fetchSkillSource(skillName, ref = DEFAULT_SKILL_REF) {
   const tmpDir = fs4.mkdtempSync(path5.join(os2.tmpdir(), "lism-skill-"));
-  await downloadTemplate2(`github:${SOURCE_REPO}/${SKILL_SOURCE_PATH}#${ref}`, {
+  await downloadTemplate2(`github:${SOURCE_REPO}/${SKILL_SOURCE_BASE}/${skillName}#${ref}`, {
     dir: tmpDir,
     force: true,
     forceClean: true
@@ -766,8 +617,17 @@ function resolveExplicitTools(options) {
 function autoDetectTools(cwd) {
   return ALL_SKILL_TOOLS.filter((tool) => TOOL_MARKERS[tool].some((marker) => fs5.existsSync(path6.resolve(cwd, marker))));
 }
-async function skillAddCommand(options) {
+function resolveSkills(skillArg) {
+  if (skillArg === void 0) return [...SKILL_NAMES];
+  return SKILL_NAMES.includes(skillArg) ? [skillArg] : null;
+}
+async function skillAddCommand(skillArg, options) {
   const cwd = process.cwd();
+  const skills = resolveSkills(skillArg);
+  if (skills === null) {
+    logger.error(t("skill.unknownSkill", { name: skillArg, list: SKILL_NAMES.join(", ") }));
+    process.exit(1);
+  }
   let targets = resolveExplicitTools(options);
   if (targets.length === 0) {
     const detected = autoDetectTools(cwd);
@@ -788,23 +648,26 @@ async function skillAddCommand(options) {
     return;
   }
   const ref = options.ref ?? DEFAULT_SKILL_REF;
-  logger.info(t("skill.add.fetching", { ref }));
-  const { dir: srcDir } = await fetchSkillSource(ref);
-  try {
-    for (const tool of targets) {
-      await deploySkillTo(srcDir, tool, options);
+  for (const skill of skills) {
+    logger.info(t("skill.add.fetching", { skill, ref }));
+    const { dir: srcDir } = await fetchSkillSource(skill, ref);
+    try {
+      for (const tool of targets) {
+        await deploySkillTo(srcDir, skill, tool, options);
+      }
+    } finally {
+      cleanupTempDir(srcDir);
     }
-    logger.success(t("common.done"));
-  } finally {
-    cleanupTempDir(srcDir);
   }
+  logger.success(t("common.done"));
 }
-async function deploySkillTo(srcDir, tool, options) {
-  const destDir = path6.resolve(process.cwd(), SKILL_PATHS[tool]);
+async function deploySkillTo(srcDir, skill, tool, options) {
+  const relDest = skillDestDir(tool, skill);
+  const destDir = path6.resolve(process.cwd(), relDest);
   const existing = fs5.existsSync(destDir);
   if (existing && !options.overwrite) {
     const diff = compareSkillDirs(destDir, srcDir);
-    const label = `${tool} (${SKILL_PATHS[tool]})`;
+    const label = `${tool} (${relDest})`;
     if (!hasDiff(diff)) {
       logger.log(t("skill.add.skippedSame", { label }));
       return;
@@ -818,7 +681,7 @@ async function deploySkillTo(srcDir, tool, options) {
       for (const rel of diff.localOnly) logger.log(`      - ${rel}`);
     }
     const go = await confirm2({
-      message: t("skill.add.confirmOverwrite", { path: SKILL_PATHS[tool] }),
+      message: t("skill.add.confirmOverwrite", { path: relDest }),
       default: false
     });
     if (!go) {
@@ -834,39 +697,90 @@ async function deploySkillTo(srcDir, tool, options) {
 // src/commands/skill/check.ts
 import fs6 from "fs";
 import path7 from "path";
+
+// src/invokeCommand.ts
+function getInvokeCommand() {
+  const scriptPath = process.argv[1] ?? "";
+  const userAgent = process.env.npm_config_user_agent ?? "";
+  const normalizedScriptPath = normalizePath(scriptPath);
+  const inDlxCache = /\/_npx\//.test(normalizedScriptPath) || /\/pnpm(?:-cache)?\/(?:[^/]+\/)*dlx-[^/]+\//.test(normalizedScriptPath) || /\/\.yarn\/berry\/cache\//.test(normalizedScriptPath) || /\/\.bun\/install\/cache\//.test(normalizedScriptPath);
+  const inLocalDependency = isInProjectNodeModules(normalizedScriptPath) && (/\/node_modules\/\.bin\/lism-cli(?:\.(?:cmd|ps1))?$/.test(normalizedScriptPath) || /\/node_modules\/lism-cli\/bin\/lism-cli\.mjs$/.test(normalizedScriptPath));
+  if (inDlxCache) return getDlxInvokeCommand(userAgent);
+  if (inLocalDependency) return getLocalInvokeCommand(userAgent);
+  return "lism-cli";
+}
+function getDlxInvokeCommand(userAgent) {
+  if (userAgent.startsWith("pnpm/")) return "pnpm dlx lism-cli";
+  if (userAgent.startsWith("yarn/")) return "yarn dlx lism-cli";
+  if (userAgent.startsWith("bun/")) return "bunx lism-cli";
+  return "npx lism-cli";
+}
+function getLocalInvokeCommand(userAgent) {
+  if (userAgent.startsWith("pnpm/")) return "pnpm exec lism-cli";
+  if (userAgent.startsWith("yarn/")) return "yarn lism-cli";
+  if (userAgent.startsWith("bun/")) return "bun run lism-cli";
+  return "npx lism-cli";
+}
+function isInProjectNodeModules(scriptPath) {
+  let dir = normalizePath(process.cwd());
+  while (dir) {
+    if (scriptPath.startsWith(`${dir}/node_modules/`)) return true;
+    const parent = dir.slice(0, dir.lastIndexOf("/"));
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return false;
+}
+function normalizePath(value) {
+  return value.replaceAll("\\", "/").replace(/\/+$/, "");
+}
+
+// src/commands/skill/check.ts
 async function skillCheckCommand(options = {}) {
   const cwd = process.cwd();
-  const installed = ALL_SKILL_TOOLS.filter((tool) => fs6.existsSync(path7.join(cwd, SKILL_PATHS[tool], "SKILL.md")));
+  const installed = [];
+  for (const skill of SKILL_NAMES) {
+    for (const tool of ALL_SKILL_TOOLS) {
+      if (fs6.existsSync(path7.join(cwd, skillDestDir(tool, skill), "SKILL.md"))) {
+        installed.push({ skill, tool });
+      }
+    }
+  }
   if (installed.length === 0) {
     logger.info(t("skill.check.noneInstalled", { invoke: getInvokeCommand() }));
     return;
   }
   const ref = options.ref ?? DEFAULT_SKILL_REF;
-  logger.info(t("skill.check.fetching", { ref }));
-  const { dir: remoteDir } = await fetchSkillSource(ref);
-  try {
-    let outdatedCount = 0;
-    for (const tool of installed) {
-      const localDir = path7.resolve(cwd, SKILL_PATHS[tool]);
-      const diff = compareSkillDirs(localDir, remoteDir);
-      const label = `${tool.padEnd(9)} ${SKILL_PATHS[tool]}`;
-      if (!hasDiff(diff)) {
-        logger.log(t("skill.check.upToDate", { label }));
-        continue;
+  let outdatedCount = 0;
+  for (const skill of SKILL_NAMES) {
+    const pairs = installed.filter((p) => p.skill === skill);
+    if (pairs.length === 0) continue;
+    logger.info(t("skill.check.fetching", { skill, ref }));
+    const { dir: remoteDir } = await fetchSkillSource(skill, ref);
+    try {
+      for (const { tool } of pairs) {
+        const relDest = skillDestDir(tool, skill);
+        const localDir = path7.resolve(cwd, relDest);
+        const diff = compareSkillDirs(localDir, remoteDir);
+        const label = `${tool.padEnd(9)} ${relDest}`;
+        if (!hasDiff(diff)) {
+          logger.log(t("skill.check.upToDate", { label }));
+          continue;
+        }
+        outdatedCount += 1;
+        logger.warn(`  ! ${label}`);
+        logger.log(formatDiffSummary(diff));
+        if (options.verbose) logger.log(formatDiffDetails(diff));
       }
-      outdatedCount += 1;
-      logger.warn(`  ! ${label}`);
-      logger.log(formatDiffSummary(diff));
-      if (options.verbose) logger.log(formatDiffDetails(diff));
-    }
-    logger.log("");
-    if (outdatedCount === 0) {
-      logger.success(t("skill.check.allLatest"));
-    } else {
-      logger.info(t("skill.check.outdated", { count: outdatedCount, invoke: getInvokeCommand() }));
+    } finally {
+      cleanupTempDir(remoteDir);
     }
-  } finally {
-    cleanupTempDir(remoteDir);
+  }
+  logger.log("");
+  if (outdatedCount === 0) {
+    logger.success(t("skill.check.allLatest"));
+  } else {
+    logger.info(t("skill.check.outdated", { count: outdatedCount, invoke: getInvokeCommand() }));
   }
 }
 function formatDiffSummary(diff) {
@@ -886,16 +800,16 @@ function formatDiffDetails(diff) {
 
 // src/commands/skill/update.ts
 async function skillUpdateCommand(options) {
-  await skillAddCommand({ ...options, overwrite: true });
+  await skillAddCommand(void 0, { ...options, overwrite: true });
 }
 
 // src/commands/skill/index.ts
 function createSkillCommand() {
-  const skill = new Command2("skill").description(t("cli.skill.description"));
+  const skill = new Command3("skill").description(t("cli.skill.description"));
   const toolOptDescription = (tool) => t("cli.skill.opt.toolPath", { path: SKILL_PATHS[tool] });
   const toolFlags = (cmd) => cmd.option("--all", t("cli.skill.opt.all")).option("--claude", toolOptDescription("claude")).option("--codex", toolOptDescription("codex")).option("--cursor", toolOptDescription("cursor")).option("--windsurf", toolOptDescription("windsurf")).option("--cline", toolOptDescription("cline")).option("--copilot", toolOptDescription("copilot")).option("--gemini", toolOptDescription("gemini")).option("--junie", toolOptDescription("junie"));
   toolFlags(
-    skill.command("add").description(t("cli.skill.add.description")).option("-o, --overwrite", t("cli.skill.add.opt.overwrite"), false).option("--ref <ref>", t("cli.skill.opt.ref"))
+    skill.command("add").description(t("cli.skill.add.description")).argument("[skill]", t("cli.skill.add.arg.skill")).option("-o, --overwrite", t("cli.skill.add.opt.overwrite"), false).option("--ref <ref>", t("cli.skill.opt.ref"))
   ).action(skillAddCommand);
   skill.command("check").description(t("cli.skill.check.description")).option("--ref <ref>", t("cli.skill.opt.ref")).option("-v, --verbose", t("cli.skill.check.opt.verbose")).action(skillCheckCommand);
   toolFlags(skill.command("update").description(t("cli.skill.update.description")).option("--ref <ref>", t("cli.skill.opt.ref"))).action(
@@ -904,22 +818,69 @@ function createSkillCommand() {
   return skill;
 }
 
+// src/commands/init.ts
+import { confirm as confirm3 } from "@inquirer/prompts";
+async function initCommand(options = {}) {
+  const found = findConfigFile();
+  if (found) {
+    logger.warn(t("init.alreadyExists", { filename: found.filename }));
+    return;
+  }
+  const ui = await resolveUiConfig(options);
+  const outPath = writeFreshConfig(ui);
+  logger.success(t("init.created", { path: outPath }));
+}
+async function resolveUiConfig(options) {
+  const hasFramework = options.uiFramework !== void 0;
+  const hasDir = options.uiDir !== void 0;
+  const uiOptions = { framework: options.uiFramework, dir: options.uiDir };
+  if (!process.stdin.isTTY) {
+    if (hasFramework) return promptUiConfig(uiOptions);
+    if (hasDir) {
+      logger.error(t("init.uiFrameworkRequired"));
+      process.exit(1);
+    }
+    return null;
+  }
+  if (hasFramework) {
+    const useUi2 = await confirm3({ message: t("init.promptUseUi"), default: true });
+    return useUi2 ? promptUiConfig(uiOptions) : null;
+  }
+  if (hasDir) {
+    return promptUiConfig(uiOptions);
+  }
+  const useUi = await confirm3({ message: t("init.promptUseUi"), default: false });
+  return useUi ? promptUiConfig(uiOptions) : null;
+}
+
+// src/commands/mockup.ts
+function mockupCommand() {
+  logger.log(t("mockup.guide"));
+}
+
 // src/createProgram.ts
 function createLismProgram() {
-  const program2 = new Command3();
-  program2.name("lism").description(t("cli.description")).version(CLI_VERSION).option("--lang <code>", t("cli.opt.lang"));
+  const program2 = new Command4();
+  program2.name("lism-cli").description(t("cli.description")).version(CLI_VERSION).option("--lang <code>", t("cli.opt.lang"));
   program2.hook("preAction", (thisCommand) => {
     const opts = thisCommand.optsWithGlobals();
     const lang = opts.lang;
     if (typeof lang === "string") setLang(lang);
   });
   program2.command("create").description(t("cli.create.description")).argument("[targetDir]", t("cli.create.arg.targetDir")).option("-t, --template <name>", t("cli.create.opt.template")).option("-f, --force", t("cli.create.opt.force"), false).action(createCommand);
+  const init = program2.command("init").description(t("cli.init.description"));
+  applyUiSectionOptions(init).action(initCommand);
   program2.addCommand(createUiCommand());
   program2.addCommand(createSkillCommand());
+  program2.command("mockup").description(t("cli.mockup.description")).allowExcessArguments().action(mockupCommand);
   return program2;
 }
 
 // src/index.ts
 preScanLang(process.argv.slice(2));
 var program = createLismProgram();
-program.parse();
+program.parseAsync().catch((err) => {
+  if (err instanceof Error && err.name === "ExitPromptError") process.exit(130);
+  logger.error(err instanceof Error ? err.message : String(err));
+  process.exit(1);
+});