@cloudglab/yapi-cli 0.0.1

package/dist/core/cli-registry.js

@@ -0,0 +1,189 @@
+import { z } from 'zod';
+export class InMemoryCliRegistry {
+    constructor() {
+        this.commands = new Map();
+    }
+    tool(name, schema, handler, description, metadata) {
+        if (this.commands.has(name)) {
+            throw new Error(`重复命令: ${name}`);
+        }
+        this.commands.set(name, {
+            name,
+            schema,
+            handler,
+            description,
+            metadata,
+        });
+    }
+    getCommand(name) {
+        return this.commands.get(name);
+    }
+    listCommands() {
+        return [...this.commands.values()].sort((left, right) => left.name.localeCompare(right.name));
+    }
+}
+function unwrapSchema(schema) {
+    let current = schema;
+    while (true) {
+        const typeName = current._def.typeName;
+        if (typeName === z.ZodFirstPartyTypeKind.ZodOptional || typeName === z.ZodFirstPartyTypeKind.ZodNullable || typeName === z.ZodFirstPartyTypeKind.ZodDefault) {
+            current = current._def.innerType;
+            continue;
+        }
+        if (typeName === z.ZodFirstPartyTypeKind.ZodEffects) {
+            current = current._def.schema;
+            continue;
+        }
+        return current;
+    }
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function parseBoolean(value) {
+    const normalized = value.trim().toLowerCase();
+    if (['1', 'true', 'yes', 'on'].includes(normalized))
+        return true;
+    if (['0', 'false', 'no', 'off'].includes(normalized))
+        return false;
+    throw new Error(`无法解析布尔值: ${value}`);
+}
+function parseArrayValue(rawValue, itemSchema) {
+    const trimmed = rawValue.trim();
+    const parsed = trimmed.startsWith('[') ? JSON.parse(trimmed) : trimmed.includes(',') ? trimmed.split(',').map((item) => item.trim()).filter(Boolean) : [trimmed];
+    if (!Array.isArray(parsed)) {
+        throw new Error(`数组参数格式错误: ${rawValue}`);
+    }
+    return parsed.map((item) => coerceValue(itemSchema, item));
+}
+function coerceValue(schema, rawValue) {
+    const resolved = unwrapSchema(schema);
+    const typeName = resolved._def.typeName;
+    if (rawValue === undefined) {
+        return undefined;
+    }
+    if (typeName === z.ZodFirstPartyTypeKind.ZodString || typeName === z.ZodFirstPartyTypeKind.ZodEnum || typeName === z.ZodFirstPartyTypeKind.ZodNativeEnum || typeName === z.ZodFirstPartyTypeKind.ZodLiteral) {
+        return String(rawValue);
+    }
+    if (typeName === z.ZodFirstPartyTypeKind.ZodNumber) {
+        const numberValue = typeof rawValue === 'number' ? rawValue : Number(rawValue);
+        if (Number.isNaN(numberValue)) {
+            throw new Error(`无法解析数字: ${rawValue}`);
+        }
+        return numberValue;
+    }
+    if (typeName === z.ZodFirstPartyTypeKind.ZodBoolean) {
+        if (typeof rawValue === 'boolean')
+            return rawValue;
+        return parseBoolean(String(rawValue));
+    }
+    if (typeName === z.ZodFirstPartyTypeKind.ZodArray) {
+        const arraySchema = resolved;
+        const itemSchema = arraySchema.element;
+        if (Array.isArray(rawValue)) {
+            return rawValue.map((item) => coerceValue(itemSchema, item));
+        }
+        return parseArrayValue(String(rawValue), itemSchema);
+    }
+    if (typeName === z.ZodFirstPartyTypeKind.ZodObject) {
+        if (isPlainObject(rawValue))
+            return rawValue;
+        return JSON.parse(String(rawValue));
+    }
+    if (typeName === z.ZodFirstPartyTypeKind.ZodUnion) {
+        return rawValue;
+    }
+    return rawValue;
+}
+function takeFlagValue(values) {
+    if (values.length === 0) {
+        return true;
+    }
+    if (values.length === 1) {
+        return values[0];
+    }
+    return values;
+}
+function toCamelCase(key) {
+    return key.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+function collectFlags(args) {
+    const flags = new Map();
+    let index = 0;
+    while (index < args.length) {
+        const token = args[index];
+        if (!token.startsWith('-')) {
+            throw new Error(`不支持的位置参数: ${token}`);
+        }
+        if (token === '--') {
+            throw new Error('不支持 -- 之后的位置参数');
+        }
+        const raw = token.replace(/^-+/, '');
+        const equalsIndex = raw.indexOf('=');
+        const key = toCamelCase(equalsIndex >= 0 ? raw.slice(0, equalsIndex) : raw);
+        if (equalsIndex >= 0) {
+            const value = raw.slice(equalsIndex + 1);
+            flags.set(key, [...(flags.get(key) ?? []), value]);
+            index += 1;
+            continue;
+        }
+        const next = args[index + 1];
+        if (next !== undefined && !next.startsWith('-')) {
+            flags.set(key, [...(flags.get(key) ?? []), next]);
+            index += 2;
+            continue;
+        }
+        flags.set(key, [...(flags.get(key) ?? []), '']);
+        index += 1;
+    }
+    return flags;
+}
+export function describeSchema(schema) {
+    return Object.entries(schema).map(([name, fieldSchema]) => {
+        const resolved = unwrapSchema(fieldSchema);
+        const typeName = resolved._def.typeName;
+        const required = fieldSchema._def.typeName !== z.ZodFirstPartyTypeKind.ZodOptional && fieldSchema._def.typeName !== z.ZodFirstPartyTypeKind.ZodDefault;
+        let type = 'string';
+        if (typeName === z.ZodFirstPartyTypeKind.ZodNumber)
+            type = 'number';
+        if (typeName === z.ZodFirstPartyTypeKind.ZodBoolean)
+            type = 'boolean';
+        if (typeName === z.ZodFirstPartyTypeKind.ZodArray)
+            type = 'array';
+        if (typeName === z.ZodFirstPartyTypeKind.ZodObject)
+            type = 'object';
+        if (typeName === z.ZodFirstPartyTypeKind.ZodEnum || typeName === z.ZodFirstPartyTypeKind.ZodNativeEnum || typeName === z.ZodFirstPartyTypeKind.ZodLiteral)
+            type = 'enum';
+        return {
+            name,
+            required,
+            type,
+            description: fieldSchema.description,
+        };
+    });
+}
+export function parseCommandInput(schema, args) {
+    const flags = collectFlags(args);
+    const input = {};
+    const allowedNames = new Set(Object.keys(schema));
+    for (const key of flags.keys()) {
+        if (!allowedNames.has(key)) {
+            throw new Error(`未知参数: --${key}`);
+        }
+    }
+    for (const [name, fieldSchema] of Object.entries(schema)) {
+        const values = flags.get(name);
+        if (values === undefined)
+            continue;
+        const resolved = unwrapSchema(fieldSchema);
+        const isArrayField = resolved._def.typeName === z.ZodFirstPartyTypeKind.ZodArray;
+        const rawValue = isArrayField ? values : values[values.length - 1];
+        const coerced = coerceValue(fieldSchema, rawValue);
+        if (coerced !== undefined) {
+            input[name] = coerced;
+        }
+    }
+    const parsedSchema = z.object(schema).strict();
+    return parsedSchema.parse(input);
+}
+//# sourceMappingURL=cli-registry.js.map

package/dist/core/cli-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-registry.js","sourceRoot":"","sources":["../../src/core/cli-registry.ts"],"names":[],"mappings":"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"}

package/dist/core/completion.d.ts

@@ -0,0 +1,3 @@
+import type { CliCommandDefinition } from './cli-registry.js';
+/** 生成 bash/zsh/fish 补全脚本 */
+export declare function generateCompletionScript(commands: CliCommandDefinition[], appName: string, shellArg?: string): string;

package/dist/core/completion.js

@@ -0,0 +1,94 @@
+function detectShellType(shellArg) {
+    if (shellArg === 'zsh')
+        return 'zsh';
+    if (shellArg === 'fish')
+        return 'fish';
+    return 'bash';
+}
+/** 生成 bash/zsh/fish 补全脚本 */
+export function generateCompletionScript(commands, appName, shellArg) {
+    const shell = detectShellType(shellArg);
+    const commandNames = commands.map((c) => c.name).sort();
+    if (shell === 'zsh') {
+        return generateZshCompletion(commandNames, appName);
+    }
+    if (shell === 'fish') {
+        return generateFishCompletion(commandNames, appName);
+    }
+    return generateBashCompletion(commandNames, appName);
+}
+function generateBashCompletion(commandNames, appName) {
+    const builtins = ['help', 'list', 'version', 'install', 'update', 'uninstall', 'remove', 'doctor', 'changelog'];
+    const all = [...builtins, ...commandNames];
+    const wordList = all.join(' ');
+    const script = [
+        `# ${appName} bash completion`,
+        `# 安装: source <(${appName} completion bash)`,
+        '# 或添加到 ~/.bashrc',
+        '',
+        `_${appName}() {`,
+        '  local cur="${COMP_WORDS[COMP_CWORD]}"',
+        '  local prev="${COMP_WORDS[COMP_CWORD-1]}"',
+        '',
+        '  # 二级补全：help 后补命令名',
+        '  if [[ COMP_CWORD -eq 2 && "${COMP_WORDS[1]}" == "help" ]]; then',
+        `    COMPREPLY=($(compgen -W "${wordList}" -- "\${cur}"))`,
+        '    return 0',
+        '  fi',
+        '',
+        '  if [[ COMP_CWORD -eq 1 ]]; then',
+        `    COMPREPLY=($(compgen -W "${wordList}" -- "\${cur}"))`,
+        '    return 0',
+        '  fi',
+        '',
+        '  # -- 补全',
+        '  if [[ "${cur}" == --* ]]; then',
+        '    COMPREPLY=($(compgen -W "--help" -- "${cur}"))',
+        '    return 0',
+        '  fi',
+        '}',
+        '',
+        `complete -F _${appName} ${appName}`,
+        '',
+    ];
+    return script.join('\n');
+}
+function generateZshCompletion(commandNames, appName) {
+    const builtins = ['help:显示帮助信息', 'list:列出所有命令', 'version:显示版本号', 'install:安装 CLI（配置 + skill）', 'update:更新 CLI', 'uninstall:卸载 CLI', 'remove:卸载 CLI', 'doctor:系统自检', 'changelog:查看版本变更'];
+    const cmds = builtins.concat(commandNames.map((name) => `${name}:`));
+    return `# ${appName} zsh completion
+# 安装: source <(${appName} completion zsh)
+# 或添加到 ~/.zshrc
+
+_${appName}() {
+  local -a commands
+  commands=(
+    ${cmds.map((c) => `"${c}"`).join('\n    ')}
+  )
+
+  _describe -t commands "${appName} commands" commands
+}
+
+compdef _${appName} ${appName}
+`;
+}
+function generateFishCompletion(commandNames, appName) {
+    const builtins = ['help', 'list', 'version', 'install', 'update', 'uninstall', 'remove', 'doctor', 'changelog'];
+    const all = [...builtins, ...commandNames];
+    return `# ${appName} fish completion
+# 安装: source <(${appName} completion fish)
+# 或添加到 ~/.config/fish/completions/${appName}.fish
+
+complete -c ${appName} -f -a "help" -d "显示帮助信息"
+complete -c ${appName} -f -a "list" -d "列出所有命令"
+complete -c ${appName} -f -a "version" -d "显示版本号"
+complete -c ${appName} -f -a "install" -d "安装 CLI（配置 + skill）"
+complete -c ${appName} -f -a "update" -d "更新 CLI"
+complete -c ${appName} -f -a "uninstall" -d "卸载 CLI"
+complete -c ${appName} -f -a "remove" -d "卸载 CLI"
+complete -c ${appName} -f -a "doctor" -d "系统自检"
+complete -c ${appName} -f -a "changelog" -d "查看版本变更"
+${commandNames.map((name) => `complete -c ${appName} -f -a "${name}" -d ""`).join('\n')}
+`;
+}
+//# sourceMappingURL=completion.js.map

package/dist/core/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../src/core/completion.ts"],"names":[],"mappings":"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"}

package/dist/core/doctor.d.ts

@@ -0,0 +1,13 @@
+export interface CheckResult {
+    name: string;
+    status: 'pass' | 'warn' | 'fail' | 'skip';
+    message: string;
+    detail?: string;
+}
+export interface DoctorReport {
+    timestamp: string;
+    nodeVersion: string;
+    platform: string;
+    checks: CheckResult[];
+}
+export declare function runDoctor(args: string[]): Promise<DoctorReport>;

package/dist/core/doctor.js

@@ -0,0 +1,124 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { loadConfig } from '../services/yapi/config.js';
+function collectBasicChecks() {
+    const checks = [];
+    // Node 版本检查
+    const nodeVersion = process.versions.node;
+    const major = Number(nodeVersion.split('.')[0]);
+    if (major >= 18) {
+        checks.push({ name: 'Node.js 版本', status: 'pass', message: `v${nodeVersion}（>= 18）` });
+    }
+    else {
+        checks.push({ name: 'Node.js 版本', status: 'fail', message: `v${nodeVersion}（需要 >= 18）` });
+    }
+    // npm/pnpm 是否可用
+    const packageManager = process.env.npm_config_user_agent || '未知';
+    checks.push({ name: '包管理器', status: 'pass', message: packageManager });
+    return checks;
+}
+function collectConfigChecks() {
+    const checks = [];
+    const configDir = join(homedir(), '.yapi');
+    if (!existsSync(configDir)) {
+        checks.push({ name: '配置目录 ~/.yapi', status: 'fail', message: '不存在', detail: '请运行 `yapi config-init` 或 `yapi install --server <url>`' });
+        return checks;
+    }
+    checks.push({ name: '配置目录 ~/.yapi', status: 'pass', message: '已创建' });
+    const config = loadConfig();
+    if (!config) {
+        checks.push({ name: '配置文件 config.json', status: 'fail', message: '不存在或无法解析' });
+        return checks;
+    }
+    checks.push({ name: '配置文件 config.json', status: 'pass', message: '已加载' });
+    checks.push({ name: '服务器地址', status: 'pass', message: config.serverUrl });
+    if (config.token) {
+        checks.push({ name: 'API Token', status: 'pass', message: '已设置' });
+    }
+    else {
+        checks.push({ name: 'API Token', status: 'warn', message: '未设置', detail: '部分功能需要 token' });
+    }
+    if (config.projectId) {
+        checks.push({ name: '默认项目 ID', status: 'pass', message: String(config.projectId) });
+    }
+    else {
+        checks.push({ name: '默认项目 ID', status: 'warn', message: '未设置', detail: '可通过 --project-id 参数指定' });
+    }
+    return checks;
+}
+async function collectNetworkChecks() {
+    const checks = [];
+    const config = loadConfig();
+    if (!config?.serverUrl) {
+        checks.push({ name: '网络连通性', status: 'skip', message: '未配置服务器地址' });
+        return checks;
+    }
+    const url = config.serverUrl.replace(/\/+$/, '');
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 5000);
+        const response = await fetch(`${url}/api/user/status`, { signal: controller.signal });
+        clearTimeout(timer);
+        if (response.ok) {
+            checks.push({ name: '网络连通性', status: 'pass', message: `${url}/api/user/status → ${response.status}` });
+        }
+        else {
+            checks.push({
+                name: '网络连通性',
+                status: 'warn',
+                message: `${url}/api/user/status → ${response.status}`,
+                detail: `服务器响应 ${response.status}，请检查 URL 或网络`,
+            });
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        checks.push({ name: '网络连通性', status: 'fail', message, detail: '请检查网络连接或服务器地址' });
+    }
+    return checks;
+}
+export async function runDoctor(args) {
+    const isVerbose = args.includes('--verbose');
+    const isJson = args.includes('--json');
+    const report = {
+        timestamp: new Date().toISOString(),
+        nodeVersion: process.versions.node,
+        platform: `${process.platform}/${process.arch}`,
+        checks: [
+            ...collectBasicChecks(),
+            ...collectConfigChecks(),
+            ...(isVerbose ? await collectNetworkChecks() : []),
+        ],
+    };
+    if (isJson) {
+        process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+        return report;
+    }
+    const lines = [];
+    const total = report.checks.length;
+    const passed = report.checks.filter((c) => c.status === 'pass').length;
+    const warnings = report.checks.filter((c) => c.status === 'warn').length;
+    const failed = report.checks.filter((c) => c.status === 'fail').length;
+    lines.push('🔍 YApi CLI 自检报告');
+    lines.push(`   时间: ${report.timestamp}`);
+    lines.push(`   系统: ${report.platform}`);
+    lines.push(`   Node: v${report.nodeVersion}`);
+    lines.push('');
+    for (const check of report.checks) {
+        const icon = check.status === 'pass' ? '✅' : check.status === 'warn' ? '⚠️' : check.status === 'fail' ? '❌' : '➖';
+        lines.push(`  ${icon} ${check.name}: ${check.message}`);
+        if (check.detail) {
+            lines.push(`        ${check.detail}`);
+        }
+    }
+    lines.push('');
+    lines.push(`  结果: ${passed} 通过, ${warnings} 警告, ${failed} 失败, 共 ${total} 项`);
+    if (!isVerbose) {
+        lines.push('');
+        lines.push('提示: 使用 --verbose 可包含网络连通性检查');
+    }
+    process.stdout.write(`${lines.join('\n')}\n`);
+    return report;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/core/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/core/doctor.ts"],"names":[],"mappings":"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"}

package/dist/core/errors.d.ts

@@ -0,0 +1,38 @@
+/**
+ * CLI 错误类层次。
+ * 每个错误携带机器可读 code + 可读 hint + 语义 exitCode，
+ * 供 cli.ts 集中捕获并设置 process.exitCode。
+ */
+export declare class CliError extends Error {
+    readonly exitCode: number;
+    readonly code?: string | undefined;
+    readonly hint?: string | undefined;
+    constructor(message: string, exitCode?: number, code?: string | undefined, hint?: string | undefined);
+}
+/** 参数验证错误（如缺少必填参数、类型不对） */
+export declare class CliValidationError extends CliError {
+    constructor(message?: string, hint?: string);
+}
+/** 认证失败（如 token 过期、未登录） */
+export declare class CliAuthError extends CliError {
+    constructor(message?: string, hint?: string);
+}
+/** 资源未找到 */
+export declare class CliNotFoundError extends CliError {
+    constructor(message?: string, hint?: string);
+}
+/** 配置错误（如未初始化） */
+export declare class CliConfigError extends CliError {
+    constructor(message?: string, hint?: string);
+}
+/** 网络错误 */
+export declare class CliNetworkError extends CliError {
+    constructor(message?: string, hint?: string);
+}
+/** 业务逻辑错误（来自 API 的错误响应） */
+export declare class CliApiError extends CliError {
+    readonly apiErrCode?: number | undefined;
+    constructor(message: string, apiErrCode?: number | undefined, hint?: string);
+}
+/** 检查错误是否为 CliError 并设置 exitCode。返回 human 消息 */
+export declare function handleCliError(err: unknown): string;

package/dist/core/errors.js

@@ -0,0 +1,74 @@
+/**
+ * CLI 错误类层次。
+ * 每个错误携带机器可读 code + 可读 hint + 语义 exitCode，
+ * 供 cli.ts 集中捕获并设置 process.exitCode。
+ */
+export class CliError extends Error {
+    constructor(message, exitCode = 1, code, hint) {
+        super(message);
+        this.exitCode = exitCode;
+        this.code = code;
+        this.hint = hint;
+        this.name = 'CliError';
+    }
+}
+/** 参数验证错误（如缺少必填参数、类型不对） */
+export class CliValidationError extends CliError {
+    constructor(message = '参数错误', hint) {
+        super(message, 9, 'VALIDATION_ERROR', hint);
+        this.name = 'CliValidationError';
+    }
+}
+/** 认证失败（如 token 过期、未登录） */
+export class CliAuthError extends CliError {
+    constructor(message = '认证失败，请重新登录', hint) {
+        super(message, 10, 'AUTH_FAILED', hint);
+        this.name = 'CliAuthError';
+    }
+}
+/** 资源未找到 */
+export class CliNotFoundError extends CliError {
+    constructor(message = '未找到', hint) {
+        super(message, 11, 'NOT_FOUND', hint);
+        this.name = 'CliNotFoundError';
+    }
+}
+/** 配置错误（如未初始化） */
+export class CliConfigError extends CliError {
+    constructor(message = '配置错误', hint) {
+        super(message, 12, 'CONFIG_ERROR', hint);
+        this.name = 'CliConfigError';
+    }
+}
+/** 网络错误 */
+export class CliNetworkError extends CliError {
+    constructor(message = '网络错误', hint) {
+        super(message, 13, 'NETWORK_ERROR', hint);
+        this.name = 'CliNetworkError';
+    }
+}
+/** 业务逻辑错误（来自 API 的错误响应） */
+export class CliApiError extends CliError {
+    constructor(message, apiErrCode, hint) {
+        super(message, 14, 'API_ERROR', hint);
+        this.apiErrCode = apiErrCode;
+        this.name = 'CliApiError';
+    }
+}
+/** 检查错误是否为 CliError 并设置 exitCode。返回 human 消息 */
+export function handleCliError(err) {
+    if (err instanceof CliError) {
+        process.exitCode = err.exitCode;
+        let msg = err.message;
+        if (err.hint)
+            msg += `\n提示: ${err.hint}`;
+        return msg;
+    }
+    if (err instanceof Error) {
+        process.exitCode = 1;
+        return err.message;
+    }
+    process.exitCode = 1;
+    return String(err);
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YACE,OAAe,EACN,WAAmB,CAAC,EACpB,IAAa,EACb,IAAa;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJN,aAAQ,GAAR,QAAQ,CAAY;QACpB,SAAI,GAAJ,IAAI,CAAS;QACb,SAAI,GAAJ,IAAI,CAAS;QAGtB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,2BAA2B;AAC3B,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9C,YAAY,OAAO,GAAG,MAAM,EAAE,IAAa;QACzC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,2BAA2B;AAC3B,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxC,YAAY,OAAO,GAAG,YAAY,EAAE,IAAa;QAC/C,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,YAAY;AACZ,MAAM,OAAO,gBAAiB,SAAQ,QAAQ;IAC5C,YAAY,OAAO,GAAG,KAAK,EAAE,IAAa;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,kBAAkB;AAClB,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAC1C,YAAY,OAAO,GAAG,MAAM,EAAE,IAAa;QACzC,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,WAAW;AACX,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,OAAO,GAAG,MAAM,EAAE,IAAa;QACzC,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,2BAA2B;AAC3B,MAAM,OAAO,WAAY,SAAQ,QAAQ;IACvC,YAAY,OAAe,EAAW,UAAmB,EAAE,IAAa;QACtE,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;QADF,eAAU,GAAV,UAAU,CAAS;QAEvD,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,gDAAgD;AAChD,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;QAC5B,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAChC,IAAI,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC;QACtB,IAAI,GAAG,CAAC,IAAI;YAAE,GAAG,IAAI,SAAS,GAAG,CAAC,IAAI,EAAE,CAAC;QACzC,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACrB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC"}

package/dist/core/output.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 统一输出渲染。
+ *
+ * 支持两种模式：
+ *   json   — 纯 JSON 输出（默认，MCP 协议兼容）
+ *   pretty — 人类友好格式（列表、表格、颜色标记）
+ *
+ * 所有命令 handler 统一通过 `output.result(data)` 返回，
+ * 由 OutputFormatter 根据格式模式渲染。
+ */
+import type { JsonContentResult } from './cli-registry.js';
+export type OutputFormat = 'json' | 'pretty';
+export declare class OutputFormatter {
+    readonly format: OutputFormat;
+    private readonly appName;
+    constructor(format?: OutputFormat, appName?: string);
+    /** 将数据包装为 MCP-compatible 结果 */
+    result(data: unknown): JsonContentResult;
+    /** 格式化错误信息（输出到 stderr），返回人类可读的消息 */
+    printError(err: unknown): string;
+    /** 打印帮助或状态信息到 stdout */
+    printMessage(msg: string): void;
+    /** 将数据格式化为字符串 */
+    private formatData;
+    private renderTable;
+    private renderObject;
+}