@sswl/ai-manager 0.1.0

package/lib/cli.js

@@ -0,0 +1,919 @@
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const readline = require("readline");
+const core = require("./runtime");
+
+const SUPPORTED_TOOLS = core.SUPPORTED_TOOLS;
+const DEFAULT_REPO_URL = core.DEFAULT_REPO_URL;
+const ANSI = {
+  reset: "\u001b[0m",
+  dim: "\u001b[2m",
+  bold: "\u001b[1m",
+  green: "\u001b[32m",
+  cyan: "\u001b[36m",
+  yellow: "\u001b[33m",
+  white: "\u001b[37m"
+};
+
+function color(text, tone) {
+  if (!process.stdout.isTTY) {
+    return text;
+  }
+  return `${ANSI[tone] || ""}${text}${ANSI.reset}`;
+}
+
+function stripAnsi(text) {
+  return String(text || "").replace(/\u001b\[[0-9;]*m/g, "");
+}
+
+function truncateText(text, width) {
+  const raw = stripAnsi(text);
+  if (raw.length <= width) {
+    return text;
+  }
+  return `${raw.slice(0, Math.max(0, width - 1))}…`;
+}
+
+function usage(commandName = "ai-manager") {
+  console.log(`${color("SSWL AI Manager CLI", "bold")}
+
+Usage:
+  ${commandName}
+  ${commandName} init [--repo-url URL] [--repo-dir PATH]
+  ${commandName} sync [--repo-url URL] [--repo-dir PATH]
+  ${commandName} list [--project PATH]
+  ${commandName} doctor [--project PATH]
+  ${commandName} apply --tool TOOL [--scope project|global] [--project PATH] [--profile ID | --asset ID ...]
+  ${commandName} update [--project PATH] [--tool TOOL]
+  ${commandName} remove --tool TOOL [--scope project|global] [--project PATH]
+`);
+}
+
+function parseArgs(argv) {
+  const args = argv.slice(2);
+  let command = "";
+  const options = {};
+  let index = 0;
+  while (index < args.length) {
+    const current = args[index];
+    if (!command && !current.startsWith("--")) {
+      command = current;
+      index += 1;
+      continue;
+    }
+    if (!current.startsWith("--")) {
+      throw new Error(`unknown argument: ${current}`);
+    }
+    const key = current.slice(2);
+    if (["verbose", "yes", "help"].includes(key)) {
+      options[key] = true;
+      index += 1;
+      continue;
+    }
+    const next = args[index + 1];
+    if (!next || next.startsWith("--")) {
+      throw new Error(`missing value for --${key}`);
+    }
+    if (key === "asset") {
+      if (!Array.isArray(options.asset)) {
+        options.asset = [];
+      }
+      options.asset.push(next.trim());
+    } else {
+      options[key] = next;
+    }
+    index += 2;
+  }
+  return {
+    command: command || "interactive",
+    options
+  };
+}
+
+function createPrompt() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  let altScreen = false;
+  let rawActive = false;
+
+  function enterAltScreen() {
+    if (!process.stdin.isTTY || !process.stdout.isTTY || altScreen) {
+      return;
+    }
+    rl.output.write("\u001b[?1049h\u001b[?25l");
+    altScreen = true;
+  }
+
+  function exitAltScreen() {
+    if (!altScreen) {
+      return;
+    }
+    rl.output.write("\u001b[?25h\u001b[?1049l");
+    altScreen = false;
+  }
+
+  function setRawMode(enabled) {
+    if (!process.stdin.isTTY) {
+      return;
+    }
+    if (enabled && !rawActive) {
+      process.stdin.setRawMode(true);
+      rawActive = true;
+      return;
+    }
+    if (!enabled && rawActive) {
+      process.stdin.setRawMode(false);
+      rawActive = false;
+    }
+  }
+
+  const ask = (message) => new Promise((resolve) => {
+    rl.question(message, (answer) => resolve(String(answer || "").trim()));
+  });
+
+  function screenWidth() {
+    return Math.max(76, Math.min(process.stdout.columns || 96, 120));
+  }
+
+  function wrapText(text, width) {
+    const raw = String(text || "");
+    if (!raw) {
+      return [""];
+    }
+    const words = raw.split(/\s+/);
+    const result = [];
+    let current = "";
+    for (const word of words) {
+      const next = current ? `${current} ${word}` : word;
+      if (stripAnsi(next).length <= width) {
+        current = next;
+      } else {
+        if (current) {
+          result.push(current);
+        }
+        if (word.length > width) {
+          result.push(word.slice(0, width));
+          current = word.slice(width);
+        } else {
+          current = word;
+        }
+      }
+    }
+    if (current) {
+      result.push(current);
+    }
+    return result.length ? result : [raw];
+  }
+
+  function renderFrame({ eyebrow = "", title = "", subtitle = "", bodyLines = [], footerLines = [] }) {
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+      return;
+    }
+    enterAltScreen();
+    const width = screenWidth();
+    const innerWidth = width - 4;
+    const top = color(`┌${"─".repeat(width - 2)}┐`, "dim");
+    const bottom = color(`└${"─".repeat(width - 2)}┘`, "dim");
+    const frame = [top];
+    const pushLine = (text = "") => {
+      const content = truncateText(text, innerWidth);
+      const rawLength = stripAnsi(content).length;
+      frame.push(`${color("│", "dim")} ${content}${" ".repeat(Math.max(0, innerWidth - rawLength))} ${color("│", "dim")}`);
+    };
+    pushLine(`${color("SSWL", "green")} ${color("AI Manager", "bold")} ${color("TUI", "dim")}`);
+    if (eyebrow) {
+      pushLine(color(eyebrow, "dim"));
+    }
+    if (title) {
+      pushLine(color(title, "bold"));
+    }
+    if (subtitle) {
+      for (const line of wrapText(subtitle, innerWidth)) {
+        pushLine(color(line, "white"));
+      }
+    }
+    pushLine("");
+    for (const line of bodyLines) {
+      pushLine(line);
+    }
+    if (footerLines.length) {
+      pushLine("");
+      frame.push(`${color("├", "dim")}${color("─".repeat(width - 2), "dim")}${color("┤", "dim")}`);
+      for (const line of footerLines) {
+        pushLine(color(line, "dim"));
+      }
+    }
+    frame.push(bottom);
+    rl.output.write("\u001b[2J\u001b[H");
+    rl.output.write(frame.join("\n"));
+  }
+
+  function closeTransientView() {
+    if (process.stdin.isTTY && process.stdout.isTTY) {
+      rl.output.write("\u001b[2J\u001b[H");
+    }
+  }
+
+  return {
+    async input(label, defaultValue = "", subtitle = "") {
+      renderFrame({
+        eyebrow: "文本输入",
+        title: label,
+        subtitle: subtitle || (defaultValue ? `默认值: ${defaultValue}` : "请输入内容后回车确认"),
+        bodyLines: [],
+        footerLines: ["回车提交"]
+      });
+      setRawMode(false);
+      const suffix = defaultValue ? ` [${defaultValue}]` : "";
+      const answer = await ask(`${color(">", "green")} ${label}${suffix}: `);
+      return answer || defaultValue;
+    },
+    async confirm(label, defaultValue = true) {
+      renderFrame({
+        eyebrow: "确认操作",
+        title: label,
+        subtitle: defaultValue ? "默认确认" : "默认取消",
+        bodyLines: [],
+        footerLines: ["输入 y / yes 确认，直接回车使用默认值"]
+      });
+      setRawMode(false);
+      const hint = defaultValue ? "Y/n" : "y/N";
+      const answer = (await ask(`${color("?", "cyan")} ${label} ${color(`(${hint})`, "dim")}: `)).toLowerCase();
+      if (!answer) {
+        return defaultValue;
+      }
+      return ["y", "yes", "1"].includes(answer);
+    },
+    async select(label, choices, defaultIndex = 0) {
+      if (!choices.length) {
+        throw new Error(`${label} 没有可选项`);
+      }
+      if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        console.log(`\n${label}`);
+        choices.forEach((choice, index) => {
+          console.log(`  ${index + 1}. ${choice.label}${choice.hint ? `  ${choice.hint}` : ""}`);
+        });
+        while (true) {
+          const raw = await ask(`请选择 [${defaultIndex + 1}]: `);
+          const nextIndex = raw ? Number(raw) - 1 : defaultIndex;
+          if (Number.isInteger(nextIndex) && nextIndex >= 0 && nextIndex < choices.length) {
+            return choices[nextIndex].value;
+          }
+          console.log("输入无效，请重新选择。");
+        }
+      }
+      return new Promise((resolve) => {
+        let cursor = Math.min(Math.max(defaultIndex, 0), choices.length - 1);
+        let scrollOffset = 0;
+        const cleanup = () => {
+          setRawMode(false);
+          process.stdin.removeListener("keypress", onKeypress);
+          closeTransientView();
+        };
+        const render = () => {
+          const visibleCount = Math.max(8, Math.min((process.stdout.rows || 28) - 10, 16));
+          if (cursor < scrollOffset) {
+            scrollOffset = cursor;
+          } else if (cursor >= scrollOffset + visibleCount) {
+            scrollOffset = cursor - visibleCount + 1;
+          }
+          const body = [];
+          const end = Math.min(choices.length, scrollOffset + visibleCount);
+          for (let index = scrollOffset; index < end; index += 1) {
+            const choice = choices[index];
+            const active = index === cursor;
+            body.push(`${active ? color("›", "green") : " "} ${color(String(index + 1).padStart(2, "0"), active ? "green" : "dim")}  ${active ? color(choice.label, "bold") : color(choice.label, "white")}${choice.hint ? color(`  ${choice.hint}`, "dim") : ""}`);
+          }
+          renderFrame({
+            eyebrow: `单选 ${cursor + 1}/${choices.length}`,
+            title: label,
+            subtitle: "选择一个目标项并确认",
+            bodyLines: body,
+            footerLines: ["↑ ↓ 移动    Enter 确认    Ctrl+C 退出"]
+          });
+        };
+        const onKeypress = (_str, key = {}) => {
+          if (key.name === "up") {
+            cursor = cursor === 0 ? choices.length - 1 : cursor - 1;
+            render();
+            return;
+          }
+          if (key.name === "down") {
+            cursor = cursor === choices.length - 1 ? 0 : cursor + 1;
+            render();
+            return;
+          }
+          if (key.name === "return") {
+            cleanup();
+            resolve(choices[cursor].value);
+            return;
+          }
+          if (key.ctrl && key.name === "c") {
+            cleanup();
+            process.exit(130);
+          }
+        };
+        readline.emitKeypressEvents(process.stdin, rl);
+        setRawMode(true);
+        process.stdin.on("keypress", onKeypress);
+        render();
+      });
+    },
+    async multiSelect(label, choices) {
+      if (!choices.length) {
+        throw new Error(`${label} 没有可选项`);
+      }
+      if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        console.log(`\n${label}`);
+        choices.forEach((choice, index) => {
+          console.log(`  ${index + 1}. ${choice.label}${choice.hint ? `  ${choice.hint}` : ""}`);
+        });
+        while (true) {
+          const raw = await ask("请输入编号，支持逗号分隔: ");
+          const indexes = raw.split(",").map((item) => Number(item.trim()) - 1).filter((item) => Number.isInteger(item));
+          const uniqueIndexes = [...new Set(indexes)].filter((item) => item >= 0 && item < choices.length);
+          if (uniqueIndexes.length > 0) {
+            return uniqueIndexes.map((item) => choices[item].value);
+          }
+          console.log("至少选择一个有效项。");
+        }
+      }
+      return new Promise((resolve) => {
+        let cursor = 0;
+        let scrollOffset = 0;
+        const selected = new Set();
+        const cleanup = () => {
+          setRawMode(false);
+          process.stdin.removeListener("keypress", onKeypress);
+          closeTransientView();
+        };
+        const render = () => {
+          const visibleCount = Math.max(8, Math.min((process.stdout.rows || 28) - 12, 18));
+          if (cursor < scrollOffset) {
+            scrollOffset = cursor;
+          } else if (cursor >= scrollOffset + visibleCount) {
+            scrollOffset = cursor - visibleCount + 1;
+          }
+          const body = [];
+          const end = Math.min(choices.length, scrollOffset + visibleCount);
+          for (let index = scrollOffset; index < end; index += 1) {
+            const choice = choices[index];
+            const active = index === cursor;
+            const checked = selected.has(choice.value);
+            body.push(`${active ? color("›", "green") : " "} ${checked ? color("[x]", "green") : color("[ ]", "dim")} ${color(String(index + 1).padStart(2, "0"), active ? "green" : "dim")}  ${active ? color(choice.label, "bold") : color(choice.label, "white")}${choice.hint ? color(`  ${choice.hint}`, "dim") : ""}`);
+          }
+          renderFrame({
+            eyebrow: `复选 ${selected.size} 项`,
+            title: label,
+            subtitle: "勾选后统一安装，依赖会自动补齐",
+            bodyLines: body,
+            footerLines: ["↑ ↓ 移动    Space 勾选    Enter 确认    Ctrl+C 退出"]
+          });
+        };
+        const onKeypress = (str, key = {}) => {
+          if (key.name === "up") {
+            cursor = cursor === 0 ? choices.length - 1 : cursor - 1;
+            render();
+            return;
+          }
+          if (key.name === "down") {
+            cursor = cursor === choices.length - 1 ? 0 : cursor + 1;
+            render();
+            return;
+          }
+          if (key.name === "space" || str === " ") {
+            const value = choices[cursor].value;
+            if (selected.has(value)) {
+              selected.delete(value);
+            } else {
+              selected.add(value);
+            }
+            render();
+            return;
+          }
+          if (key.name === "return") {
+            if (!selected.size) {
+              render();
+              return;
+            }
+            cleanup();
+            resolve(choices.filter((choice) => selected.has(choice.value)).map((choice) => choice.value));
+            return;
+          }
+          if (key.ctrl && key.name === "c") {
+            cleanup();
+            process.exit(130);
+          }
+        };
+        readline.emitKeypressEvents(process.stdin, rl);
+        setRawMode(true);
+        process.stdin.on("keypress", onKeypress);
+        render();
+      });
+    },
+    close() {
+      setRawMode(false);
+      exitAltScreen();
+      rl.close();
+    }
+  };
+}
+
+function isControlPlaneRepo(targetPath) {
+  if (!targetPath || !fs.existsSync(targetPath)) {
+    return false;
+  }
+  return ["catalog", "registry", "scripts", "standards"].every((marker) => fs.existsSync(path.join(path.resolve(targetPath), marker)));
+}
+
+function looksLikeProjectRoot(projectRoot) {
+  if (!projectRoot || !fs.existsSync(projectRoot)) {
+    return false;
+  }
+  const resolved = path.resolve(projectRoot);
+  if (isControlPlaneRepo(resolved)) {
+    return false;
+  }
+  return [".git", "package.json", "composer.json", ".claude", ".codex"].some((marker) => fs.existsSync(path.join(resolved, marker)));
+}
+
+function ensureProjectDirectory(projectRoot, options = {}) {
+  if (!String(projectRoot || "").trim()) {
+    throw new Error("目标项目目录不能为空，请输入业务项目的绝对路径");
+  }
+  const resolved = path.resolve(projectRoot);
+  if (!fs.existsSync(resolved) || !fs.statSync(resolved).isDirectory()) {
+    throw new Error(`目录不存在：${resolved}`);
+  }
+  if (isControlPlaneRepo(resolved)) {
+    throw new Error(`当前目录是控制面仓库，不是业务项目目录：${resolved}`);
+  }
+  if (!looksLikeProjectRoot(resolved) && !options.allowUnrecognized) {
+    throw new Error(`该目录未识别为常见项目根目录：${resolved}`);
+  }
+  return resolved;
+}
+
+function lastKnownProjectRoot() {
+  try {
+    const state = core.getAppState({});
+    const candidate = state?.settings?.last_project_root || "";
+    return candidate && fs.existsSync(candidate) && !isControlPlaneRepo(candidate) ? path.resolve(candidate) : "";
+  } catch (_error) {
+    return "";
+  }
+}
+
+function normalizeAssetSet(assetIds) {
+  return [...new Set((assetIds || []).filter(Boolean))].sort();
+}
+
+function resolveAssetDependencies(assets, assetIds) {
+  const assetMap = new Map((assets || []).map((asset) => [asset.id, asset]));
+  const queue = normalizeAssetSet(assetIds);
+  const resolved = new Set();
+  while (queue.length > 0) {
+    const current = queue.shift();
+    if (!current || resolved.has(current)) {
+      continue;
+    }
+    resolved.add(current);
+    const dependencies = Array.isArray(assetMap.get(current)?.dependencies) ? assetMap.get(current).dependencies : [];
+    for (const dependencyId of dependencies) {
+      if (!resolved.has(dependencyId)) {
+        queue.push(dependencyId);
+      }
+    }
+  }
+  return [...resolved].sort();
+}
+
+function createHooks(options = {}) {
+  return {
+    onLog(message) {
+      if (options.verbose) {
+        console.log(message);
+      }
+    },
+    onProgress(progress) {
+      const percent = progress?.percent != null ? `${String(progress.percent).padStart(3, " ")}%` : " --%";
+      const detail = progress?.detail || progress?.stage || "";
+      console.log(`[${percent}] ${detail}`);
+    }
+  };
+}
+
+function ensureGitMode(options = {}) {
+  core.updateSettings({
+    repo_url: options.repoUrl || DEFAULT_REPO_URL,
+    repo_dir: options.repoDir || undefined,
+    current_scope: options.scope || undefined,
+    last_project_root: Object.prototype.hasOwnProperty.call(options, "projectRoot") ? (options.projectRoot || "") : undefined
+  });
+}
+
+async function syncRepoForCli(options = {}) {
+  ensureGitMode(options);
+  return core.syncRepo({
+    repoUrl: options.repoUrl || "",
+    repoDir: options.repoDir || ""
+  }, createHooks(options));
+}
+
+function describeTool(toolState) {
+  const installed = toolState.enabled ? `已安装 ${toolState.installed_asset_ids?.length || 0} 项` : "未安装";
+  const detected = toolState.detected_installed ? "本机已检测到" : "本机未检测到";
+  return `${toolState.tool} / ${installed} / ${detected}`;
+}
+
+async function resolveProjectForCli(prompt, explicitProjectRoot = "") {
+  if (explicitProjectRoot) {
+    return ensureProjectDirectory(explicitProjectRoot, { allowUnrecognized: true });
+  }
+  try {
+    const currentDir = ensureProjectDirectory(process.cwd(), { allowUnrecognized: true });
+    console.log(`\n当前默认项目目录: ${currentDir}`);
+    if (!looksLikeProjectRoot(currentDir)) {
+      printWarning("当前目录没有命中常见项目标记，但仍可按当前目录处理。");
+    }
+    const useCurrent = await prompt.confirm("是否直接使用当前目录作为目标项目目录", true);
+    if (useCurrent) {
+      return currentDir;
+    }
+  } catch (_error) {}
+  const fallbackProject = lastKnownProjectRoot();
+  while (true) {
+    const selected = await prompt.input(
+      "请输入目标项目目录",
+      fallbackProject || "",
+      "当前目录不是业务项目目录，请输入或粘贴你要安装资产的项目路径"
+    );
+    try {
+      const resolved = ensureProjectDirectory(String(selected || "").trim(), { allowUnrecognized: true });
+      if (!looksLikeProjectRoot(resolved)) {
+        printWarning("该目录没有命中常见项目标记，但会继续按指定目录处理。");
+      }
+      return resolved;
+    } catch (error) {
+      printWarning(error.message || String(error));
+    }
+  }
+}
+
+async function resolveProjectForCommand(explicitProjectRoot = "") {
+  if (explicitProjectRoot) {
+    return ensureProjectDirectory(explicitProjectRoot, { allowUnrecognized: true });
+  }
+  try {
+    return ensureProjectDirectory(process.cwd(), { allowUnrecognized: true });
+  } catch (_error) {
+    const fallbackProject = lastKnownProjectRoot();
+    if (fallbackProject) {
+      return fallbackProject;
+    }
+    throw new Error("当前目录不是业务项目目录，请使用 --project 指定目标项目目录");
+  }
+}
+
+function printSection(title) {
+  console.log(`\n${color(`◆ ${title}`, "bold")}`);
+}
+
+function printBanner() {
+  const line = "─".repeat(56);
+  console.log(color(line, "dim"));
+  console.log(`${color("SSWL", "green")} ${color("AI Manager CLI", "bold")}  ${color("项目级资产安装器", "dim")}`);
+  console.log(color(line, "dim"));
+}
+
+function printKeyValue(label, value, tone = "white") {
+  console.log(`${color(label.padEnd(12, " "), "dim")} ${color(value, tone)}`);
+}
+
+function printBulletList(title, lines, tone = "white") {
+  if (!lines.length) {
+    return;
+  }
+  console.log(color(title, "dim"));
+  lines.forEach((line) => console.log(`  ${color("•", "green")} ${color(line, tone)}`));
+}
+
+function printSuccess(message) {
+  console.log(color(`✔ ${message}`, "green"));
+}
+
+function printWarning(message) {
+  console.log(color(`! ${message}`, "yellow"));
+}
+
+function summarizeAssets(state, assetIds) {
+  return assetIds.map((assetId) => {
+    const asset = (state.assets || []).find((item) => item.id === assetId);
+    return asset ? `${assetId} (${asset.type}/${asset.domain})` : assetId;
+  });
+}
+
+function filterProfilesByTool(state, tool) {
+  return (state.profiles || []).filter((profile) => (profile.supported_tools || []).includes(tool));
+}
+
+function filterInstallableAssetsByTool(state, tool) {
+  return (state.assets || [])
+    .filter((asset) => (asset.supported_tools || []).includes(tool))
+    .filter((asset) => asset.installable !== false);
+}
+
+async function interactiveInstall(options = {}) {
+  const prompt = createPrompt();
+  try {
+    printBanner();
+    printSection("项目确认");
+    const projectRoot = await resolveProjectForCli(prompt, options.project);
+    printSection("仓库同步");
+    const syncedState = await syncRepoForCli({ ...options, scope: "project", projectRoot });
+    const state = core.getAppState({
+      repoDir: syncedState.settings.repo_dir,
+      projectRoot
+    });
+    const projectTools = state.project?.tools || [];
+    const availableTools = projectTools.filter((toolState) => toolState.manageable && SUPPORTED_TOOLS.includes(toolState.tool));
+    printSection("工具选择");
+    const selectedTool = await prompt.select("选择目标工具", availableTools.map((toolState) => ({
+      label: toolState.tool,
+      hint: describeTool(toolState),
+      value: toolState.tool
+    })), 0);
+    const toolState = availableTools.find((item) => item.tool === selectedTool) || availableTools[0];
+    const scope = await prompt.select("选择安装作用域", [
+      { label: "项目级配置", hint: "推荐，直接写入当前项目", value: "project" },
+      { label: "全局配置", hint: "安装到当前用户全局目录", value: "global" }
+    ], 0);
+    let inheritGlobal = true;
+    if (scope === "project" && (state.tools.find((item) => item.tool === selectedTool)?.installed_asset_ids || []).length) {
+      inheritGlobal = await prompt.confirm("项目级安装是否继承当前全局已安装资产", true);
+    }
+    const profiles = filterProfilesByTool(state, selectedTool);
+    printSection("资产组合");
+    const profileChoices = profiles.map((profile) => ({
+      label: profile.id,
+      hint: `${profile.name || profile.id} / ${profile.asset_ids.length} 项`,
+      value: profile.id
+    }));
+    profileChoices.push({
+      label: "自定义选择",
+      hint: "手工选择资产，依赖会自动补齐",
+      value: "__custom__"
+    });
+    const profileId = await prompt.select("选择安装档位", profileChoices, 0);
+    let selectedAssetIds = [];
+    let selectionMode = "profile";
+    let planName = profileId;
+    if (profileId === "__custom__") {
+      const assets = filterInstallableAssetsByTool(state, selectedTool);
+      selectedAssetIds = await prompt.multiSelect("选择需要同步到项目的资产", assets.map((asset) => ({
+        label: `${asset.id}`,
+        hint: `${asset.type} / ${asset.domain} / ${asset.status}`,
+        value: asset.id
+      })));
+      selectionMode = "custom";
+      planName = "custom-selection";
+    } else {
+      const profile = profiles.find((item) => item.id === profileId);
+      selectedAssetIds = profile?.asset_ids || [];
+    }
+    const globalInstalled = scope === "project" && inheritGlobal
+      ? (state.tools.find((item) => item.tool === selectedTool)?.installed_asset_ids || [])
+      : [];
+    const previewAssetIds = resolveAssetDependencies(state.assets || [], normalizeAssetSet([...globalInstalled, ...selectedAssetIds]));
+    printSection("执行预览");
+    printKeyValue("目标项目", projectRoot);
+    printKeyValue("目标工具", selectedTool, "cyan");
+    printKeyValue("安装作用域", scope === "project" ? "项目级" : "全局");
+    printKeyValue("选择模式", selectionMode === "profile" ? `档位 ${profileId}` : "自定义资产");
+    printBulletList("即将同步的资产", summarizeAssets(state, previewAssetIds));
+    const confirmed = options.yes || await prompt.confirm("确认继续执行安装", true);
+    if (!confirmed) {
+      printWarning("已取消。");
+      return;
+    }
+    const nextState = await core.applyActivationPlan({
+      tool: selectedTool,
+      assetIds: selectedAssetIds,
+      selectedAssetIds,
+      installRoot: scope === "project" ? "" : (state.tools.find((item) => item.tool === selectedTool)?.install_root || ""),
+      linkName: toolState.link_name || "sswl-ai-coding-platform",
+      linkTarget: toolState.link_target || "skills",
+      repoDir: state.settings.repo_dir || "",
+      repoUrl: state.settings.repo_url || "",
+      planName,
+      profileId: profileId === "__custom__" ? "" : profileId,
+      selectionMode,
+      scope,
+      projectRoot,
+      inheritGlobal
+    }, createHooks(options));
+    printSection("完成");
+    printSuccess("安装完成");
+    printKeyValue("项目", projectRoot);
+    printKeyValue("工具", selectedTool, "cyan");
+    printKeyValue("已安装资产", `${(scope === "project" ? nextState.project?.tools : nextState.tools).find((item) => item.tool === selectedTool)?.installed_asset_ids?.length || 0} 项`);
+    printKeyValue("后续更新", `ai-manager update --project "${projectRoot}"`, "dim");
+  } finally {
+    prompt.close();
+  }
+}
+
+async function runInit(options = {}) {
+  printBanner();
+  const state = await syncRepoForCli(options);
+  printSuccess("仓库已准备完成");
+  printKeyValue("仓库目录", state.settings.repo_dir);
+}
+
+async function runSync(options = {}) {
+  printBanner();
+  const state = await syncRepoForCli(options);
+  printSuccess("仓库已同步");
+  printKeyValue("仓库目录", state.settings.repo_dir);
+}
+
+function parseScope(value = "") {
+  return value === "global" ? "global" : "project";
+}
+
+async function runList(options = {}) {
+  printBanner();
+  ensureGitMode(options);
+  const projectRoot = options.project ? path.resolve(options.project) : "";
+  const state = core.getAppState({ projectRoot });
+  printKeyValue("资产源模式", state.settings.asset_source_mode);
+  printKeyValue("仓库目录", state.settings.repo_dir);
+  if (projectRoot) {
+    printKeyValue("项目目录", projectRoot);
+  }
+  printSection("可用档位");
+  for (const tool of SUPPORTED_TOOLS) {
+    const profiles = filterProfilesByTool(state, tool);
+    printKeyValue(tool, profiles.map((profile) => profile.id).join(", ") || "无");
+  }
+  printSection("工具状态");
+  const scopedTools = projectRoot && state.project ? state.project.tools : state.tools;
+  scopedTools.filter((toolState) => SUPPORTED_TOOLS.includes(toolState.tool)).forEach((toolState) => {
+    console.log(`  ${color("•", "green")} ${describeTool(toolState)}`);
+  });
+}
+
+async function runDoctor(options = {}) {
+  printBanner();
+  ensureGitMode(options);
+  let projectRoot = "";
+  try {
+    projectRoot = options.project ? ensureProjectDirectory(options.project, { allowUnrecognized: true }) : ensureProjectDirectory(process.cwd(), { allowUnrecognized: true });
+  } catch (_error) {
+    projectRoot = "";
+  }
+  const network = await core.getEnterpriseNetworkStatus();
+  const state = core.getAppState({ projectRoot });
+  printKeyValue("企业网络", `${network.status_label}${network.error ? ` (${network.error})` : ""}`, network.reachable ? "green" : "yellow");
+  printKeyValue("仓库地址", state.settings.repo_url);
+  printKeyValue("仓库目录", state.settings.repo_dir);
+  printKeyValue("资产源模式", state.settings.asset_source_mode);
+  printKeyValue("当前项目", projectRoot || "未识别");
+  printSection("工具检测");
+  state.tools.filter((toolState) => SUPPORTED_TOOLS.includes(toolState.tool)).forEach((toolState) => {
+    console.log(`  ${color("•", "green")} ${toolState.tool}: ${toolState.detected_installed ? "已检测到" : "未检测到"}${toolState.detected_command_path ? ` / ${toolState.detected_command_path}` : ""}`);
+  });
+}
+
+async function runApply(options = {}) {
+  printBanner();
+  if (!options.tool || !SUPPORTED_TOOLS.includes(options.tool)) {
+    throw new Error(`--tool 必须是 ${SUPPORTED_TOOLS.join(" / ")}`);
+  }
+  const scope = parseScope(options.scope);
+  const projectRoot = scope === "project" ? await resolveProjectForCommand(options.project) : "";
+  const state = await syncRepoForCli({ ...options, scope, projectRoot });
+  const profiles = filterProfilesByTool(state, options.tool);
+  let selectedAssetIds = [];
+  let profileId = "";
+  let selectionMode = "";
+  let planName = "";
+  if (options.profile) {
+    const profile = profiles.find((item) => item.id === options.profile);
+    if (!profile) {
+      throw new Error(`未知档位: ${options.profile}`);
+    }
+    selectedAssetIds = profile.asset_ids;
+    profileId = profile.id;
+    selectionMode = "profile";
+    planName = profile.id;
+  } else if (Array.isArray(options.asset) && options.asset.length) {
+    selectedAssetIds = options.asset;
+    selectionMode = "custom";
+    planName = "custom-selection";
+  } else {
+    throw new Error("apply 必须提供 --profile 或至少一个 --asset");
+  }
+  await core.applyActivationPlan({
+    tool: options.tool,
+    assetIds: selectedAssetIds,
+    selectedAssetIds,
+    installRoot: scope === "global" ? (state.tools.find((item) => item.tool === options.tool)?.install_root || "") : "",
+    repoDir: state.settings.repo_dir || "",
+    repoUrl: state.settings.repo_url || "",
+    planName,
+    profileId,
+    selectionMode,
+    scope,
+    projectRoot,
+    inheritGlobal: String(options["inherit-global"] || "true").toLowerCase() !== "false"
+  }, createHooks(options));
+  printSuccess("安装完成");
+}
+
+async function runUpdate(options = {}) {
+  printBanner();
+  const projectRoot = await resolveProjectForCommand(options.project);
+  ensureGitMode({ ...options, scope: "project", projectRoot });
+  await core.updateProjectInstallations({
+    projectRoot,
+    repoDir: options.repoDir || options["repo-dir"] || "",
+    repoUrl: options.repoUrl || options["repo-url"] || "",
+    tool: options.tool || ""
+  }, createHooks(options));
+  printSuccess("项目已更新");
+  printKeyValue("项目目录", projectRoot);
+}
+
+async function runRemove(options = {}) {
+  printBanner();
+  if (!options.tool || !SUPPORTED_TOOLS.includes(options.tool)) {
+    throw new Error(`--tool 必须是 ${SUPPORTED_TOOLS.join(" / ")}`);
+  }
+  const scope = parseScope(options.scope);
+  const projectRoot = scope === "project" ? await resolveProjectForCommand(options.project) : "";
+  await core.disableTool({
+    tool: options.tool,
+    scope,
+    projectRoot
+  }, createHooks(options));
+  printSuccess("卸载完成");
+}
+
+async function runCli(argv = process.argv, options = {}) {
+  const { command, options: parsedOptions } = parseArgs(argv);
+  if (parsedOptions.help || command === "help") {
+    usage(options.commandName || "ai-manager");
+    return;
+  }
+  const normalizedOptions = {
+    ...parsedOptions,
+    repoUrl: parsedOptions["repo-url"] || "",
+    repoDir: parsedOptions["repo-dir"] || "",
+    project: parsedOptions.project || "",
+    verbose: Boolean(parsedOptions.verbose),
+    yes: Boolean(parsedOptions.yes)
+  };
+  if (command === "interactive") {
+    await interactiveInstall(normalizedOptions);
+    return;
+  }
+  if (command === "init") {
+    await runInit(normalizedOptions);
+    return;
+  }
+  if (command === "sync") {
+    await runSync(normalizedOptions);
+    return;
+  }
+  if (command === "list") {
+    await runList(normalizedOptions);
+    return;
+  }
+  if (command === "doctor") {
+    await runDoctor(normalizedOptions);
+    return;
+  }
+  if (command === "apply") {
+    await runApply(normalizedOptions);
+    return;
+  }
+  if (command === "update") {
+    await runUpdate(normalizedOptions);
+    return;
+  }
+  if (command === "remove") {
+    await runRemove(normalizedOptions);
+    return;
+  }
+  throw new Error(`unknown command: ${command}`);
+}
+
+module.exports = {
+  runCli
+};