@longzai-intelligence-cli/core 0.0.1

package/README.md

@@ -0,0 +1,31 @@
+# @longzai-intelligence-cli/core
+
+Longzai Intelligence 产品群级 CLI 基础设施核心包，收口 192 个子项目的 CLI 框架分化。
+
+## 定位
+
+该包面向所有 `longzai-intelligence-*` 子项目的 `apps/cli`，作为命令装配、参数解析、输出版式、交互层与版本注入的统一真源，替代各项目散落的自研 `cli/` 副本。
+
+## 核心能力
+
+- **createCli()**：基于 commander 的命令装配工厂，内置 `--version` / `--help`
+- **输出版式**：`OutputFormatter` 支持 text / json 双格式 + table 渲染
+- **交互层**：select / confirm / textInput / spinner / note（`@clack/prompts` 封装）
+- **版本注入**：`getCliVersion()` 构建期 define 静态替换 + 开发期 package.json 兜底
+
+## 使用示例
+
+```ts
+import { createCli } from '@longzai-intelligence-cli/core';
+
+const program = createCli({
+  name: 'lzi-my-app',
+  description: '我的 CLI 应用',
+});
+
+program.command('hello').action(() => {
+  console.log('Hello, Longzai Intelligence!');
+});
+
+await program.parseAsync(process.argv);
+```

package/dist/index.d.ts

@@ -0,0 +1,253 @@
+import "./rolldown-runtime-BqT_7tdF.js";
+import { Command } from "commander";
+//#region src/create-cli.d.ts
+/**
+ * createCli 工厂的配置选项
+ */
+type CreateCliOptions = {
+  /**
+   * CLI 程序名称（如 `lzi-gateway`）
+   */
+  name: string;
+  /**
+   * 程序描述（显示在 --help 顶部）
+   */
+  description?: string;
+  /**
+   * 版本号（默认从构建期注入读取，无需手动传入）
+   */
+  version?: string;
+};
+/**
+ * 创建 CLI 程序实例
+ *
+ * 基于 commander 封装，内置 `--version`（版本号由构建期 define 注入 + 开发期兜底）
+ * 与 `--help`，调用方只需注册具体子命令后 `parseAsync(process.argv)` 即可。
+ *
+ * @example
+ *   ```ts
+ *   const program = createCli({ name: 'lzi-my-app', description: '我的 CLI' });
+ *   program.command('hello').action(() => console.log('hi'));
+ *   await program.parseAsync(process.argv);
+ *   ```;
+ *
+ * @param options - 工厂配置
+ * @returns commander Command 实例
+ */
+declare function createCli(options: CreateCliOptions): Command;
+//#endregion
+//#region src/version/index.d.ts
+/**
+ * 获取 CLI 版本号
+ *
+ * 解析顺序：
+ *
+ * 1. 构建期注入的 `process.env.CLI_VERSION`（lzi-builder define 静态替换）
+ * 2. 开发期兜底：从源码旁的 package.json 读取（src/../package.json）
+ * 3. 找不到时回退 '0.0.0'（极端沙箱场景），避免阻塞 --version 输出
+ *
+ * @returns CLI 版本号字符串
+ */
+declare const getCliVersion: () => string;
+//#endregion
+//#region src/output/index.d.ts
+/**
+ * 输出格式类型
+ */
+type OutputFormat = 'text' | 'json';
+/**
+ * 输出格式化器
+ *
+ * 支持 text（带颜色的可读输出）与 json（机器可读的结构化输出）两种格式，
+ * 由 `parseOutputFormat` 从命令行 `--format` 参数解析得到。
+ */
+declare class OutputFormatter {
+  /**
+   * 当前输出格式
+   */
+  private format;
+  /**
+   * 构造输出格式化器
+   *
+   * @param format - 输出格式，默认 text
+   */
+  constructor(format?: OutputFormat);
+  /**
+   * 输出成功信息
+   *
+   * @param data - 要展示的数据
+   * @param message - 可选的自定义消息（仅 text 格式生效）
+   */
+  success(data: unknown, message?: string): void;
+  /**
+   * 输出错误信息
+   *
+   * @param error - 错误对象或消息
+   */
+  error(error: unknown): void;
+  /**
+   * 输出提示信息
+   *
+   * @param message - 提示消息
+   */
+  info(message: string): void;
+  /**
+   * 输出警告信息
+   *
+   * @param message - 警告消息
+   */
+  warn(message: string): void;
+  /**
+   * 输出表格
+   *
+   * @param headers - 表头列表
+   * @param rows - 数据行列表
+   */
+  table(headers: string[], rows: string[][]): void;
+  /**
+   * 格式化数据为字符串
+   *
+   * @param data - 原始数据
+   * @returns 字符串表示
+   */
+  private formatData;
+}
+/**
+ * 解析输出格式参数
+ *
+ * @param format - 格式参数字符串
+ * @returns 输出格式类型
+ */
+declare function parseOutputFormat(format?: string): OutputFormat;
+//#endregion
+//#region src/tui/index.d.ts
+/**
+ * 选择选项
+ */
+type SelectOption = {
+  /**
+   * 选项值
+   */
+  value: string;
+  /**
+   * 选项标签
+   */
+  label: string;
+  /**
+   * 选项提示
+   */
+  hint?: string;
+};
+/**
+ * 文本输入选项
+ */
+type TextInputModule = {
+  /**
+   * 占位提示文本
+   */
+  placeholder?: string;
+  /**
+   * 默认值
+   */
+  defaultValue?: string;
+};
+/**
+ * 确认选项
+ */
+type ConfirmOptions = {
+  /**
+   * 默认选中值
+   */
+  defaultValue?: boolean;
+};
+/**
+ * 加载动画控制器
+ */
+type SpinnerController = {
+  /**
+   * 启动动画
+   *
+   * @param message - 动画提示消息
+   */
+  start(message: string): void;
+  /**
+   * 停止动画
+   *
+   * @param message - 结束提示消息
+   */
+  stop(message: string): void;
+};
+/**
+ * 交互式选择
+ *
+ * @param message - 提示消息
+ * @param options - 选项列表
+ * @returns 选中的值
+ */
+declare function select(message: string, options: SelectOption[]): Promise<string>;
+/**
+ * 交互式文本输入
+ *
+ * @param message - 提示消息
+ * @param options - 输入选项
+ * @returns 输入的文本
+ */
+declare function textInput(message: string, options?: TextInputModule): Promise<string>;
+/**
+ * 交互式确认
+ *
+ * @param message - 提示消息
+ * @param options - 确认选项
+ * @returns 确认结果
+ */
+declare function confirm(message: string, options?: ConfirmOptions): Promise<boolean>;
+/**
+ * 创建加载动画
+ *
+ * @returns 加载动画控制器
+ */
+declare function spinner(): SpinnerController;
+/**
+ * 显示提示信息框
+ *
+ * @param message - 信息内容
+ * @param title - 信息标题
+ */
+declare function note(message: string, title?: string): void;
+/**
+ * 日志输出工具集
+ */
+declare const log: {
+  /**
+   * 输出信息级日志
+   *
+   * @param message - 日志消息
+   */
+  info(message: string): void;
+  /**
+   * 输出成功级日志
+   *
+   * @param message - 日志消息
+   */
+  success(message: string): void;
+  /**
+   * 输出警告级日志
+   *
+   * @param message - 日志消息
+   */
+  warn(message: string): void;
+  /**
+   * 输出错误级日志
+   *
+   * @param message - 日志消息
+   */
+  error(message: string): void;
+  /**
+   * 输出步骤级日志
+   *
+   * @param message - 日志消息
+   */
+  step(message: string): void;
+};
+//#endregion
+export { type ConfirmOptions, type CreateCliOptions, type OutputFormat, OutputFormatter, type SelectOption, type SpinnerController, type TextInputModule, confirm, createCli, getCliVersion, log, note, parseOutputFormat, select, spinner, textInput };

package/dist/index.js

@@ -0,0 +1 @@
+import"./rolldown-runtime-BqT_7tdF.js";import{Command as e}from"commander";import"node:fs";import"node:path";import"node:url";import{createNodeLogger as t}from"@longzai-intelligence-logger/node";import n from"picocolors";import*as r from"@clack/prompts";const i=()=>`0.0.1`;function a(t){let n=t.version??i(),r=new e;return r.name(t.name).version(n,`-v, --version`,`输出 ${t.name} 的版本号`),t.description&&r.description(t.description),r}const o=t(`@longzai-intelligence-cli/core/output`);var s=class{format;constructor(e=`text`){this.format=e}success(e,t){this.format===`json`?o.info(JSON.stringify({success:!0,data:e},null,2)):o.info(t?n.green(t):n.green(this.formatData(e)))}error(e){if(this.format===`json`){let t=e instanceof Error?{message:e.message,name:e.name}:{message:String(e)};o.info(JSON.stringify({success:!1,error:t},null,2))}else{let t=e instanceof Error?e.message:String(e);o.error(n.red(`错误: ${t}`))}}info(e){this.format===`json`?o.info(JSON.stringify({success:!0,message:e},null,2)):o.info(n.blue(e))}warn(e){this.format===`json`?o.info(JSON.stringify({success:!0,warning:e},null,2)):o.info(n.yellow(e))}table(e,t){if(this.format===`json`){let n=t.map(t=>{let n={};return e.forEach((e,r)=>{n[e]=t[r]??``}),n});o.info(JSON.stringify({success:!0,data:n},null,2))}else{let r=e.map((e,n)=>Math.max(e.length,...t.map(e=>(e[n]??``).length)));o.info(e.map((e,t)=>n.bold(e.padEnd(r[t]??0))).join(`  `)),o.info(r.map(e=>`-`.repeat(e??0)).join(`  `));for(let e of t)o.info(e.map((e,t)=>(e??``).padEnd(r[t]??0)).join(`  `))}}formatData(e){return typeof e==`string`?e:typeof e==`number`||typeof e==`boolean`?String(e):JSON.stringify(e,null,2)}};function c(e){return e===`json`?`json`:`text`}async function l(e,t){let n=await r.select({message:e,options:t.map(e=>({value:e.value,label:e.label,hint:e.hint}))});return r.isCancel(n)&&(r.cancel(`操作已取消`),process.exit(0)),typeof n==`string`?n:String(n)}async function u(e,t){let n=await r.text({message:e,placeholder:t?.placeholder,defaultValue:t?.defaultValue});return r.isCancel(n)&&(r.cancel(`操作已取消`),process.exit(0)),typeof n==`string`?n:String(n)}async function d(e,t){let n=await r.confirm({message:e,initialValue:t?.defaultValue??!1});return r.isCancel(n)&&(r.cancel(`操作已取消`),process.exit(0)),typeof n==`boolean`?n:!!n}function f(){let e=r.spinner();return{start(t){e.start(t)},stop(t){e.stop(t)}}}function p(e,t){r.note(e,t)}const m={info(e){r.log.info(n.blue(e))},success(e){r.log.success(n.green(e))},warn(e){r.log.warn(n.yellow(e))},error(e){r.log.error(n.red(e))},step(e){r.log.step(e)}};export{s as OutputFormatter,d as confirm,a as createCli,i as getCliVersion,m as log,p as note,c as parseOutputFormat,l as select,f as spinner,u as textInput};

package/dist/rolldown-runtime-BqT_7tdF.js

@@ -0,0 +1 @@
+import"node:module";export{};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@longzai-intelligence-cli/core",
+  "version": "0.0.1",
+  "private": false,
+  "keywords": [
+    "cli",
+    "commander",
+    "infrastructure"
+  ],
+  "license": "UNLICENSED",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "lzi-builder",
+    "build:prod": "NODE_ENV=production lzi-builder",
+    "prepublishOnly": "bun run build:prod",
+    "typecheck": "bun run typecheck:app && bun run typecheck:node && bun run typecheck:test",
+    "typecheck:app": "tsgo --noEmit -p tsconfig/app.json",
+    "typecheck:node": "tsgo --noEmit -p tsconfig/node.json",
+    "typecheck:test": "tsgo --noEmit -p tsconfig/test.json",
+    "lint": "oxlint && oxfmt --check",
+    "lint:fix": "oxlint --fix && oxfmt",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage",
+    "clean": "lzi-dev-cli clean"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "@longzai-intelligence-builder/utils": "^0.2.13",
+    "@longzai-intelligence-logger/node": "^0.1.0",
+    "commander": "^14.0.0",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {}
+}