refactor(cli): split into runtime / commands packages for composable CLIs

Decompose the monolithic `cli` package into three layers so multiple
products can be assembled from a shared base:

- bailian-cli-runtime: framework infra (createCli, registry, args,
  output, pipeline, utils) — product-agnostic
- bailian-cli-commands: command library, grouped (base/knowledge/text/
  media/memory/misc) so each product picks the sets it needs
- packages/cli (bl): full command set; packages/rag (rag): base +
  knowledge only

Product identity (binName / clientName / npmPackage) is injected at the
createCli boundary and required there, with no per-consumer defaults.

Author: XXPermanentXX

package.json

@@ -19,6 +19,7 @@
     "sync:skill-assets": "pnpm --filter bailian-cli-core run build && pnpm --filter bailian-cli run generate:reference && pnpm --filter bailian-cli run sync:skill-version",
     "dev": "pnpm -F bailian-cli-core dev",
     "bl": "pnpm -F bailian-cli dev",
+    "rag": "pnpm -F bailian-cli-rag dev",
     "test": "vp test",
     "release:check": "node tools/release/check.mjs",
     "wiki:crawl": "node tools/wiki-crawler/index.mjs",

packages/cli/package.json

@@ -44,32 +44,23 @@
     "check": "vp check"
   },
   "dependencies": {
+    "bailian-cli-commands": "workspace:*",
     "bailian-cli-core": "workspace:*",
-    "boxen": "catalog:",
-    "chalk": "catalog:",
-    "undici": "catalog:"
+    "bailian-cli-runtime": "workspace:*"
   },
   "devDependencies": {
     "@clack/prompts": "^0.7.0",
     "@types/node": "catalog:",
     "@typescript/native-preview": "7.0.0-dev.20260328.1",
     "ajv": "catalog:",
+    "boxen": "catalog:",
+    "chalk": "catalog:",
     "typescript": "^6.0.2",
-    "vite-plus": "catalog:",
+    "undici": "catalog:",
+    "vite-plus": "0.1.22",
     "yaml": "catalog:"
   },
   "engines": {
     "node": ">=22.12.0"
-  },
-  "inlinedDependencies": {
-    "@clack/core": "0.3.5",
-    "@clack/prompts": "0.7.0",
-    "ajv": "8.20.0",
-    "fast-deep-equal": "3.1.3",
-    "fast-uri": "3.1.2",
-    "json-schema-traverse": "1.0.0",
-    "picocolors": "1.1.1",
-    "sisteransi": "1.0.5",
-    "yaml": "2.8.3"
   }
 }

packages/cli/src/main.ts

@@ -1,151 +1,11 @@
-import { scanCommandPath, parseFlags } from "./args.ts";
-import { registry } from "./registry.ts";
-import {
-  GLOBAL_OPTIONS,
-  loadConfig,
-  resolveCredential,
-  trackCommandExecution,
-  flushTelemetry,
-} from "bailian-cli-core";
-import { ensureApiKey } from "./utils/ensure-key.ts";
-import { setupProxyFromEnv } from "./proxy.ts";
-import { handleError } from "./error-handler.ts";
-import { checkForUpdate, getPendingUpdateNotification } from "./utils/update-checker.ts";
-import { maybeShowStatusBar } from "./output/status-bar.ts";
-import { printWelcomeBanner, printQuickStart } from "./output/banner.ts";
-import { CLI_VERSION } from "./version.ts";
-import {
-  printCurrentCommandHelp,
-  registerCommandHelpPrinter,
-  setExecutingCommandPath,
-} from "./utils/command-help.ts";
-
-// 必须在任何 fetch 发起前安装（含 update-checker / telemetry）
-try {
-  setupProxyFromEnv();
-} catch (err) {
-  handleError(err);
-}
-
-registerCommandHelpPrinter((commandPath, out) => {
-  registry.printHelp(commandPath, out);
-});
-
-// 优雅处理 Ctrl+C
-// 退出前尝试 best-effort 刷出埋点，让去抖队列中 / 在途的 fetch 请求有机会
-// 落网络；flush 与较短超时 race，保证 SIGINT 仍然响应及时。
-process.on("SIGINT", () => {
-  process.stderr.write("\nInterrupted. Exiting.\n");
-  void flushTelemetry(500).finally(() => process.exit(130));
-});
-
-// 优雅处理 stdout EPIPE（例如管道到提前退出的 `mpv`）
-process.stdout.on("error", (e: NodeJS.ErrnoException) => {
-  if (e.code === "EPIPE") process.exit(0);
-  else throw e;
-});
-
-async function main() {
-  let argv = process.argv.slice(2);
-  if (argv[0] === "--") argv = argv.slice(1);
-
-  if (argv.includes("--version") || argv.includes("-v")) {
-    process.stdout.write(`bl ${CLI_VERSION}\n`);
-    process.exit(0);
-  }
-
-  const commandPath = scanCommandPath(argv, GLOBAL_OPTIONS);
-
-  if (argv.includes("--help") || argv.includes("-h")) {
-    registry.printHelp(commandPath, process.stderr);
-    process.exit(0);
-  }
-
-  // 未传任何命令：展示帮助信息与登录引导
-  if (commandPath.length === 0) {
-    registry.printHelp([], process.stderr);
-
-    const flags = parseFlags(argv, GLOBAL_OPTIONS);
-    const config = loadConfig(flags);
-    config.clientName = "bailian-cli";
-    config.clientVersion = CLI_VERSION;
-
-    const hasKey = !!(
-      config.apiKey ||
-      config.fileApiKey ||
-      config.fileAccessToken ||
-      config.accessTokenEnv
-    );
-    if (hasKey) printQuickStart();
-    else printWelcomeBanner();
-    process.exit(0);
-  }
-
-  // 组路径（例如 `bl speech` 未接子命令）：展示帮助后干净退出
-  if (registry.isGroupPath(commandPath)) {
-    registry.printHelp(commandPath, process.stderr);
-    process.exit(0);
-  }
-
-  const { command, extra } = registry.resolve(commandPath);
-  const flags = parseFlags(argv, [...GLOBAL_OPTIONS, ...(command.options ?? [])]);
-
-  if (extra.length > 0) (flags as Record<string, unknown>)._positional = extra;
-
-  const config = loadConfig(flags);
-  config.clientName = "bailian-cli";
-  config.clientVersion = CLI_VERSION;
-
-  // 默认执行 ensureApiKey；自行处理鉴权或仅需 Console/AK-SK 等的命令在 defineCommand 上设 skipDefaultApiKeySetup
-  if (!command.skipDefaultApiKeySetup) {
-    await ensureApiKey(config);
-    try {
-      const credential = await resolveCredential(config);
-      maybeShowStatusBar(config, credential.token, credential);
-    } catch {
-      /* 没有凭证，不展示状态栏 */
-    }
-  }
-
-  const updateCheckPromise = checkForUpdate(CLI_VERSION).catch(() => {});
-
-  setExecutingCommandPath(commandPath);
-
-  if (
-    commandPath[0] === "auth" &&
-    commandPath[1] === "login" &&
-    !flags.console &&
-    !String((flags.apiKey as string | undefined) ?? "").trim() &&
-    !String(config.apiKey ?? "").trim() &&
-    !process.env.DASHSCOPE_API_KEY?.trim()
-  ) {
-    printCurrentCommandHelp(process.stderr);
-    process.exit(0);
-  }
-
-  await trackCommandExecution(config, commandPath, flags, () => command.execute(config, flags));
-
-  await updateCheckPromise;
-  const isUpdateCommand = commandPath.length === 1 && commandPath[0] === "update";
-  const newVersion = getPendingUpdateNotification();
-  if (newVersion && !config.quiet && !isUpdateCommand) {
-    const isTTY = process.stderr.isTTY;
-    const yellow = isTTY ? "\x1b[33m" : "";
-    const cyan = isTTY ? "\x1b[36m" : "";
-    const reset = isTTY ? "\x1b[0m" : "";
-    process.stderr.write(`\n  ${yellow}Update available: ${CLI_VERSION} → ${newVersion}${reset}\n`);
-    process.stderr.write(`  Run ${cyan}bl update${reset} to upgrade\n\n`);
-  }
-
-  // 进程退出前尽力等待在途的埋点完成。
-  // 使用较短超时兜底，避免慢网拖慢用户感知。
-  await flushTelemetry(1000);
-}
-
-main().catch((err) => {
-  // 在 handleError() 调用 process.exit() 之前刷出在途埋点。
-  // 命令抛出的错误已被 trackCommandExecution 的 finally 块记录，
-  // 但底层 tracker 有 ~500ms 的发送去抖。不主动 flush 的话，
-  // 错误事件会随进程退出丢掉。
-  void flushTelemetry(1000).finally(() => handleError(err));
-});
+import { createCli } from "bailian-cli-runtime";
+import { commands } from "bailian-cli-commands";
+import pkg from "../package.json" with { type: "json" };
+
+// Full bailian-cli product: every command, exposed under the `bl` binary.
+createCli(commands, {
+  binName: "bl",
+  version: pkg.version,
+  clientName: "bailian-cli",
+  npmPackage: "bailian-cli",
+}).run();

packages/commands/.gitignore

@@ -0,0 +1,4 @@
+node_modules
+dist
+*.log
+.DS_Store

packages/commands/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "bailian-cli-commands",
+  "version": "1.4.0",
+  "description": "Command library for bailian-cli products (knowledge, memory, media, …). See https://www.npmjs.com/package/bailian-cli for usage.",
+  "homepage": "https://bailian.console.aliyun.com/cli",
+  "bugs": {
+    "url": "https://github.com/modelstudioai/cli/issues"
+  },
+  "license": "Apache-2.0",
+  "author": "Aliyun Model Studio",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/modelstudioai/cli.git",
+    "directory": "packages/commands"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test",
+    "check": "vp check"
+  },
+  "dependencies": {
+    "bailian-cli-core": "workspace:*",
+    "bailian-cli-runtime": "workspace:*",
+    "boxen": "catalog:",
+    "chalk": "catalog:",
+    "yaml": "catalog:"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:",
+    "@typescript/native-preview": "7.0.0-dev.20260328.1",
+    "typescript": "^6.0.2",
+    "vite-plus": "0.1.22"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  }
+}

…es/cli/src/commands/advisor/recommend.ts …mmands/src/commands/advisor/recommend.tspackages/cli/src/commands/advisor/recommend.ts renamed to packages/commands/src/commands/advisor/recommend.ts packages/cli/src/commands/advisor/recommend.ts renamed to packages/commands/src/commands/advisor/recommend.ts

@@ -17,9 +17,9 @@ import {
 } from "bailian-cli-core";
 import boxen from "boxen";
 import chalk, { Chalk, type ChalkInstance } from "chalk";
-import { emitBare, emitResult } from "../../output/output.ts";
-import { createSpinner } from "../../output/progress.ts";
-import { failIfMissing, promptText } from "../../output/prompt.ts";
+import { emitBare, emitResult } from "bailian-cli-runtime";
+import { createSpinner } from "bailian-cli-runtime";
+import { failIfMissing, promptText } from "bailian-cli-runtime";
 
 function formatContextWindow(tokens: number): string {
   if (tokens >= 1_000_000)

packages/cli/src/commands/app/call.ts …ckages/commands/src/commands/app/call.tspackages/cli/src/commands/app/call.ts renamed to packages/commands/src/commands/app/call.ts packages/cli/src/commands/app/call.ts renamed to packages/commands/src/commands/app/call.ts

@@ -11,8 +11,8 @@ import {
   type AppStreamChunk,
   type AppCompletionResponse,
 } from "bailian-cli-core";
-import { failIfMissing } from "../../output/prompt.ts";
-import { emitResult, emitBare } from "../../output/output.ts";
+import { failIfMissing } from "bailian-cli-runtime";
+import { emitResult, emitBare } from "bailian-cli-runtime";
 
 export default defineCommand({
   name: "app call",

packages/cli/src/commands/app/list.ts …ckages/commands/src/commands/app/list.tspackages/cli/src/commands/app/list.ts renamed to packages/commands/src/commands/app/list.ts packages/cli/src/commands/app/list.ts renamed to packages/commands/src/commands/app/list.ts

@@ -6,7 +6,7 @@ import {
   type Config,
   type GlobalFlags,
 } from "bailian-cli-core";
-import { emitResult } from "../../output/output.ts";
+import { emitResult } from "bailian-cli-runtime";
 
 const APP_LIST_API = "zeldaEasy.broadscope-bailian.app-control.list";
 

…s/cli/src/commands/auth/login-console.ts …mands/src/commands/auth/login-console.tspackages/cli/src/commands/auth/login-console.ts renamed to packages/commands/src/commands/auth/login-console.ts packages/cli/src/commands/auth/login-console.ts renamed to packages/commands/src/commands/auth/login-console.ts

@@ -7,10 +7,10 @@ import {
   type Config,
   type GlobalFlags,
 } from "bailian-cli-core";
-import { printQuickStart } from "../../output/banner.ts";
-import { emitBare } from "../../output/output.ts";
-import { promptConfirm } from "../../output/prompt.ts";
-import { printCurrentCommandHelp } from "../../utils/command-help.ts";
+import { printQuickStart } from "bailian-cli-runtime";
+import { emitBare } from "bailian-cli-runtime";
+import { promptConfirm } from "bailian-cli-runtime";
+import { printCurrentCommandHelp } from "bailian-cli-runtime";
 import {
   resolveConsoleOrigin,
   runConsoleLogin,