@hithink-tech/hithink-finance-cli 0.1.0

package/dist/application/use-cases/local-query.js

@@ -0,0 +1,88 @@
+import { CliError } from '../../contracts/errors.js';
+import { mkdir, rename, rm } from 'node:fs/promises';
+import path from 'node:path';
+function readOnlyViolation() {
+    return new CliError({
+        code: 'DB_READ_ONLY_VIOLATION',
+        category: 'validation',
+        message: 'db query accepts exactly one read-only SELECT statement.',
+        hint: 'Use SELECT or WITH ... SELECT. Database writes are available only through managed data commands.',
+        retryable: false,
+        exitCode: 2,
+    });
+}
+export async function queryReadOnly(connection, sql) {
+    await connection.run('SET enable_external_access=false; SET autoinstall_known_extensions=false; SET autoload_known_extensions=false');
+    let extracted;
+    try {
+        extracted = await connection.extractStatements(sql);
+    }
+    catch {
+        throw readOnlyViolation();
+    }
+    if (extracted.count !== 1)
+        throw readOnlyViolation();
+    let prepared;
+    try {
+        prepared = await extracted.prepare(0);
+    }
+    catch {
+        throw readOnlyViolation();
+    }
+    try {
+        if (prepared.statementType !== 1)
+            throw readOnlyViolation();
+        const reader = await prepared.runAndReadAll();
+        return reader.getRowObjectsJson();
+    }
+    finally {
+        prepared.destroySync();
+    }
+}
+async function assertReadOnly(connection, sql) {
+    if (/\b(?:attach|copy|install|load|read_csv|read_json|read_parquet|httpfs|sqlite_scan)\b/iu.test(sql))
+        throw readOnlyViolation();
+    let extracted;
+    try {
+        extracted = await connection.extractStatements(sql);
+        if (extracted.count !== 1)
+            throw readOnlyViolation();
+        const prepared = await extracted.prepare(0);
+        try {
+            if (prepared.statementType !== 1)
+                throw readOnlyViolation();
+        }
+        finally {
+            prepared.destroySync();
+        }
+    }
+    catch (error) {
+        if (error instanceof CliError)
+            throw error;
+        throw readOnlyViolation();
+    }
+}
+export async function exportQuery(connection, sql, outputPath, format) {
+    await assertReadOnly(connection, sql);
+    const absolute = path.resolve(outputPath);
+    const temporary = `${absolute}.${process.pid}.tmp`;
+    await mkdir(path.dirname(absolute), { recursive: true });
+    const escaped = temporary.replaceAll("'", "''");
+    const copyOptions = format === 'parquet'
+        ? 'FORMAT PARQUET'
+        : format === 'csv'
+            ? 'FORMAT CSV, HEADER true'
+            : 'FORMAT JSON, ARRAY false';
+    try {
+        await connection.run(`COPY (${sql}) TO '${escaped}' (${copyOptions})`);
+        const countReader = await connection.runAndReadAll(`SELECT count(*) FROM (${sql}) q`);
+        const count = Number(countReader.getRowsJson()[0]?.[0] ?? 0);
+        await rename(temporary, absolute);
+        return count;
+    }
+    catch (error) {
+        await rm(temporary, { force: true });
+        throw error;
+    }
+}
+//# sourceMappingURL=local-query.js.map

package/dist/application/use-cases/market-history.d.ts

@@ -0,0 +1,8 @@
+import type { DuckDBConnection } from '@duckdb/node-api';
+export declare function getHistory(connection: DuckDBConnection, input: {
+    thscodes: readonly string[];
+    start?: string;
+    end?: string;
+    adjust?: 'none' | 'forward' | 'backward';
+}): Promise<Record<string, unknown>[]>;
+//# sourceMappingURL=market-history.d.ts.map

package/dist/application/use-cases/market-history.js

@@ -0,0 +1,16 @@
+import { queryReadOnly } from './local-query.js';
+export async function getHistory(connection, input) {
+    const view = input.adjust === 'backward'
+        ? 'v_daily_hfq'
+        : input.adjust === 'none'
+            ? 'v_daily'
+            : 'v_daily_qfq';
+    const codes = input.thscodes.map((code) => `'${code.replaceAll("'", "''")}'`).join(',');
+    const filters = [`thscode IN (${codes || "''"})`];
+    if (input.start !== undefined)
+        filters.push(`date >= DATE '${input.start}'`);
+    if (input.end !== undefined)
+        filters.push(`date <= DATE '${input.end}'`);
+    return queryReadOnly(connection, `SELECT * FROM ${view} WHERE ${filters.join(' AND ')} ORDER BY thscode,date`);
+}
+//# sourceMappingURL=market-history.js.map

package/dist/application/use-cases/market-panel.d.ts

@@ -0,0 +1,3 @@
+import type { DuckDBConnection } from '@duckdb/node-api';
+export declare function getPanel(connection: DuckDBConnection, start: string, end: string): Promise<Record<string, unknown>[]>;
+//# sourceMappingURL=market-panel.d.ts.map

package/dist/application/use-cases/market-panel.js

@@ -0,0 +1,5 @@
+import { queryReadOnly } from './local-query.js';
+export async function getPanel(connection, start, end) {
+    return queryReadOnly(connection, `SELECT * FROM v_daily_qfq WHERE date BETWEEN DATE '${start}' AND DATE '${end}' ORDER BY date,thscode`);
+}
+//# sourceMappingURL=market-panel.js.map

package/dist/application/use-cases/remote-query.d.ts

@@ -0,0 +1,4 @@
+import type { RemoteCapabilityDescriptor } from '../../contracts/remote-capabilities.js';
+import type { FuyaoClient, FuyaoSuccess } from '../../infrastructure/fuyao/client.js';
+export declare function executeRemoteQuery(capability: RemoteCapabilityDescriptor, input: Record<string, unknown>, client: FuyaoClient): Promise<FuyaoSuccess<unknown>>;
+//# sourceMappingURL=remote-query.d.ts.map

package/dist/application/use-cases/remote-query.js

@@ -0,0 +1,66 @@
+import { deduplicateAndSort, sliceTimeWindow } from '../../infrastructure/fuyao/windowing.js';
+function optionKey(flags) {
+    const longFlag = flags.split(/[ ,|]+/u).find((part) => part.startsWith('--')) ?? flags;
+    return longFlag
+        .replace(/^--/u, '')
+        .replace(/^no-/u, '')
+        .replace(/-([a-z])/gu, (_match, letter) => letter.toUpperCase());
+}
+function queryFor(capability, input) {
+    const query = {};
+    for (const option of capability.options) {
+        const key = optionKey(option.flags);
+        const value = input[key];
+        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+            query[option.queryName ?? key] = value;
+        }
+    }
+    if (capability.id === 'market.history' || capability.id === 'index.history') {
+        query.interval = '1d';
+    }
+    return query;
+}
+function mergeWindowData(values) {
+    const objects = values.filter((value) => value !== null && typeof value === 'object');
+    const items = objects.flatMap((value) => (Array.isArray(value.item) ? value.item : []));
+    const mergedItems = deduplicateAndSort(items, (item) => {
+        if (item !== null && typeof item === 'object' && 'date_ms' in item) {
+            const date = item.date_ms;
+            if (typeof date === 'number' || typeof date === 'string')
+                return date;
+        }
+        return JSON.stringify(item);
+    });
+    return { ...(objects[objects.length - 1] ?? {}), item: mergedItems };
+}
+export async function executeRemoteQuery(capability, input, client) {
+    const query = queryFor(capability, input);
+    const start = input.startMs;
+    const end = input.endMs;
+    if (capability.window === 'ten-years' && typeof start === 'number' && typeof end === 'number') {
+        const slices = sliceTimeWindow(start, end);
+        if (slices.length > 1) {
+            const responses = [];
+            for (const slice of slices) {
+                responses.push(await client.request({
+                    path: capability.endpoint,
+                    query: { ...query, start: slice.start, end: slice.end },
+                    schema: capability.outputSchema,
+                }));
+            }
+            const result = {
+                data: mergeWindowData(responses.map((response) => response.data)),
+            };
+            const requestId = responses.at(-1)?.requestId;
+            if (requestId !== undefined)
+                result.requestId = requestId;
+            return result;
+        }
+    }
+    return client.request({
+        path: capability.endpoint,
+        query,
+        schema: capability.outputSchema,
+    });
+}
+//# sourceMappingURL=remote-query.js.map

package/dist/cli/context.d.ts

@@ -0,0 +1,17 @@
+import { type Language } from './i18n.js';
+export type OutputFormat = 'auto' | 'json' | 'ndjson' | 'csv' | 'table';
+export interface CliContext {
+    format: OutputFormat;
+    language: Language;
+    color: boolean;
+    requestId: string;
+    stdout: NodeJS.WriteStream;
+    stderr: NodeJS.WriteStream;
+}
+export declare function optionValue(argv: readonly string[], name: string): string | undefined;
+export declare function createCliContext(argv: readonly string[], defaults?: {
+    format?: OutputFormat;
+    language?: Language;
+}): CliContext;
+export declare function inferCommand(argv: readonly string[]): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/cli/context.js

@@ -0,0 +1,52 @@
+import { randomUUID } from 'node:crypto';
+import { resolveLanguage } from './i18n.js';
+export function optionValue(argv, name) {
+    const inlinePrefix = `${name}=`;
+    const inline = argv.find((argument) => argument.startsWith(inlinePrefix));
+    if (inline !== undefined) {
+        return inline.slice(inlinePrefix.length);
+    }
+    const index = argv.indexOf(name);
+    return index >= 0 ? argv[index + 1] : undefined;
+}
+export function createCliContext(argv, defaults = {}) {
+    const rawFormat = optionValue(argv, '--format');
+    const format = rawFormat === 'json' || rawFormat === 'ndjson' || rawFormat === 'csv' || rawFormat === 'table'
+        ? rawFormat
+        : (defaults.format ?? 'auto');
+    const language = resolveLanguage(optionValue(argv, '--lang') ?? defaults.language, process.env.LC_ALL ?? process.env.LC_MESSAGES ?? process.env.LANG);
+    return {
+        format,
+        language,
+        color: process.stderr.isTTY === true && process.env.NO_COLOR === undefined,
+        requestId: optionValue(argv, '--request-id') ?? randomUUID(),
+        stdout: process.stdout,
+        stderr: process.stderr,
+    };
+}
+export function inferCommand(argv) {
+    const optionsWithValues = new Set([
+        '--format',
+        '--lang',
+        '--profile',
+        '--api-key',
+        '--db',
+        '--config',
+        '--source',
+        '--request-id',
+    ]);
+    for (let index = 0; index < argv.length; index += 1) {
+        const argument = argv[index];
+        if (argument === undefined)
+            continue;
+        if (optionsWithValues.has(argument)) {
+            index += 1;
+            continue;
+        }
+        if (!argument.startsWith('-')) {
+            return argument;
+        }
+    }
+    return 'root';
+}
+//# sourceMappingURL=context.js.map

package/dist/cli/i18n.d.ts

@@ -0,0 +1,23 @@
+export type Language = 'zh-CN' | 'en';
+declare const messages: {
+    readonly en: {
+        readonly rootDescription: "Enterprise financial data CLI for humans and AI agents";
+        readonly versionDescription: "Print the installed CLI version";
+        readonly unknownCommand: "Unknown command.";
+        readonly unknownCommandHint: "Run `hithink-finance --help` to list available commands.";
+        readonly authLoginAlreadyConfigured: "This profile is already logged in. To switch API keys, run `hithink-finance auth logout` first, then run `hithink-finance auth login` again.";
+    };
+    readonly 'zh-CN': {
+        readonly rootDescription: "面向人类与 AI Agent 的企业级金融数据命令行工具";
+        readonly versionDescription: "显示已安装的 CLI 版本";
+        readonly unknownCommand: "未知命令。";
+        readonly unknownCommandHint: "运行 `hithink-finance --help` 查看可用命令。";
+        readonly authLoginAlreadyConfigured: "当前 profile 已登录。如需切换 API Key，请先运行 `hithink-finance auth logout`，再重新运行 `hithink-finance auth login`。";
+    };
+};
+export type MessageKey = keyof (typeof messages)['en'];
+export declare function translate(language: Language, key: MessageKey): string;
+export declare function localizeText(language: Language, english: string): string;
+export declare function resolveLanguage(explicit: string | undefined, locale: string | undefined): Language;
+export {};
+//# sourceMappingURL=i18n.d.ts.map

package/dist/cli/i18n.js

@@ -0,0 +1,150 @@
+const messages = {
+    en: {
+        rootDescription: 'Enterprise financial data CLI for humans and AI agents',
+        versionDescription: 'Print the installed CLI version',
+        unknownCommand: 'Unknown command.',
+        unknownCommandHint: 'Run `hithink-finance --help` to list available commands.',
+        authLoginAlreadyConfigured: 'This profile is already logged in. To switch API keys, run `hithink-finance auth logout` first, then run `hithink-finance auth login` again.',
+    },
+    'zh-CN': {
+        rootDescription: '面向人类与 AI Agent 的企业级金融数据命令行工具',
+        versionDescription: '显示已安装的 CLI 版本',
+        unknownCommand: '未知命令。',
+        unknownCommandHint: '运行 `hithink-finance --help` 查看可用命令。',
+        authLoginAlreadyConfigured: '当前 profile 已登录。如需切换 API Key，请先运行 `hithink-finance auth logout`，再重新运行 `hithink-finance auth login`。',
+    },
+};
+const zhTextByEnglish = {
+    'output format': '输出格式',
+    'human interface language': '人类界面语言',
+    'configuration and credential profile': '配置与凭据 profile',
+    'explicit JSON configuration file': '显式指定 JSON 配置文件',
+    'API key for this process': '仅当前进程使用的 API Key',
+    'read an API key from stdin': '从标准输入读取 API Key',
+    'disable interactive input': '禁用交互式输入',
+    'confirm non-interactive operations': '确认非交互式操作',
+    'data source: auto, local, or remote': '数据来源：auto、local 或 remote',
+    'local DuckDB path': '本地 DuckDB 路径',
+    'caller-supplied correlation ID': '调用方提供的关联 ID',
+    'enable diagnostic details on stderr': '在 stderr 输出诊断细节',
+    'disable terminal colors': '禁用终端颜色',
+    'Manage API key authentication': '管理 API Key 认证',
+    'Store an API key in the system credential store': '保存 API Key 到系统凭据库',
+    'Show whether an API key is configured': '查看 API Key 是否已配置',
+    'Delete API key credentials': '删除 API Key 凭据',
+    'delete every hithink-finance profile': '删除所有 hithink-finance profile 凭据',
+    'Inspect resolved non-secret configuration': '查看已解析的非敏感配置',
+    'Show resolved non-secret configuration': '显示已解析的非敏感配置',
+    'List machine-readable command capabilities': '列出机器可读命令能力清单',
+    'Show a command contract': '查看命令契约',
+    'Manage Agent Skills': '管理 Agent Skills',
+    'Check or repair the installed CLI version': '检查或修复已安装的 CLI 版本',
+    'Check for a newer version without installing': '仅检查新版本，不安装',
+    'Repair the current or target installation': '修复当前或目标安装',
+    'Install a specific SemVer version': '安装指定 SemVer 版本',
+    'Plan or run CLI uninstall cleanup': '预览或执行 CLI 卸载清理',
+    'Show the uninstall plan without deleting anything': '只显示卸载计划，不删除任何内容',
+    'Delete local data during uninstall': '卸载时删除本地数据',
+    'Delete local configuration during uninstall': '卸载时删除本地配置',
+    'Delete all CLI-managed API key credentials': '删除所有 CLI 管理的 API Key 凭据',
+    'Run local environment diagnostics': '运行本地环境诊断',
+    'Manage local DuckDB data': '管理本地 DuckDB 数据（初始化/同步需要先登录）',
+    'Initialize local data from a verified dump': '初始化本地数据（远端初始化需要 API Key）',
+    'Synchronize local data': '同步本地数据（需要 API Key）',
+    'Show local database status': '显示本地数据库状态',
+    'Validate local data quality': '校验本地数据质量',
+    'Rebuild derived factors': '重建本地派生因子',
+    'Plan or apply schema migrations': '预览或执行 schema 迁移',
+    'Clean managed download caches': '清理托管下载缓存',
+    'Remove the explicitly confirmed database': '删除已显式确认的数据库',
+    'Query the local DuckDB': '查询本地 DuckDB',
+    'Describe local database objects': '查看本地数据库对象',
+    'Run a read-only SQL query': '执行只读 SQL 查询',
+    'Export a read-only SQL query': '导出只读 SQL 查询结果',
+    'ndjson, csv, or parquet': 'ndjson、csv 或 parquet',
+    'Export a local full-market panel': '导出本地全市场面板',
+    'Query local daily adjustment factors': '查询本地日频复权因子',
+    'symbol remote data commands': '标的目录与代码搜索命令',
+    'market remote data commands': '普通行情与交易日历命令',
+    'special remote data commands': '特色榜单与事件数据命令',
+    'financials remote data commands': '财务报表与指标命令',
+    'index remote data commands': '指数目录、成分和行情命令',
+    'write the full JSON response envelope to a file': '将完整 JSON 响应信封写入文件',
+    'read thscodes from a comma/newline-delimited file': '从逗号或换行分隔文件读取 thscode',
+    'read thscodes from stdin': '从标准输入读取 thscode',
+    'Resolve a name or code to thscode': '将名称、ticker 或代码消歧为 thscode',
+    'List symbols with bounded pagination': '分页列出标的目录',
+    'Query A-share price snapshots': '查询 A 股行情快照',
+    'Query daily A-share history': '查询 A 股日线历史行情',
+    'Query adjustment events': '查询公司行动/复权事件',
+    'Query income financial statements': '查询利润表',
+    'Query balance-sheet financial statements': '查询资产负债表',
+    'Query cash-flow financial statements': '查询现金流量表',
+    'Query financial indicators for a report': '查询指定报告期财务指标',
+    'Query the one-year A-share trading calendar': '查询一年内 A 股交易日历',
+    'List THS indices by category': '按类别列出同花顺指数',
+    'Query index constituents': '查询指数成分股',
+    'Query index price snapshots': '查询指数行情快照',
+    'Query daily index history': '查询指数日线历史行情',
+    'Query the limit-up stock pool': '查询涨停股票池',
+    'Query the 30-day limit-up ladder': '查询 30 日连板天梯',
+    'Query today-only anomaly analysis rows': '查询今日个股异动列表',
+    'Query today-only anomalies for up to 50 raw code tokens': '查询最多 50 只股票的今日异动原因',
+    'Query the skyrocket ranking': '查询飙升榜',
+    'Query the current hot-stock ranking': '查询当前热股榜',
+    'Query a historical hot-stock ranking': '查询历史热股榜',
+    'Query one stock hot-rank trend': '查询单股热度排名趋势',
+    'Query dragon-tiger board records': '查询龙虎榜记录',
+    'name, ticker, or thscode': '名称、ticker 或 thscode',
+    'exchange filter': '交易所过滤条件',
+    'asset type': '资产类型',
+    'maximum matches (1-50)': '最大匹配数量（1-50）',
+    'comma-separated exchanges': '逗号分隔的交易所',
+    'page size (1-10000)': '分页大小（1-10000）',
+    'row offset': '行偏移量',
+    'comma-separated A-share thscodes': '逗号分隔的 A 股 thscode',
+    'page size': '分页大小',
+    'single A-share thscode': '单只 A 股 thscode',
+    'start timestamp': '开始时间戳',
+    'end timestamp': '结束时间戳',
+    'adjustment mode': '复权模式',
+    'first ex-date YYYY-MM-DD': '最早除权除息日期 YYYY-MM-DD',
+    'last ex-date YYYY-MM-DD': '最晚除权除息日期 YYYY-MM-DD',
+    'financial period': '财报周期',
+    'recent report count (1-20)': '最近报告数量（1-20）',
+    'range start in milliseconds': '区间开始毫秒时间戳',
+    'range end in milliseconds': '区间结束毫秒时间戳',
+    'report quarter YYYY-[1-4]': '报告季度 YYYY-[1-4]',
+    'index category': '指数类别',
+    'single index thscode': '单个指数 thscode',
+    'comma-separated index thscodes': '逗号分隔的指数 thscode',
+    'trade date at Asia/Shanghai midnight': 'Asia/Shanghai 零点对应的交易日',
+    'page number': '页码',
+    'page size (1-200)': '分页大小（1-200）',
+    'sort field': '排序字段',
+    'sort direction': '排序方向',
+    'comma-separated anomaly tags': '逗号分隔的异动标签',
+    '1-50 comma-separated A-share thscodes': '1-50 个逗号分隔的 A 股 thscode',
+    'ranking period': '榜单周期',
+    'trade date YYYY-MM-DD': '交易日 YYYY-MM-DD',
+    'start date YYYY-MM-DD': '开始日期 YYYY-MM-DD',
+    'end date YYYY-MM-DD': '结束日期 YYYY-MM-DD',
+    'board category': '榜单类别',
+    'optional trade date YYYY-MM-DD': '可选交易日 YYYY-MM-DD',
+};
+export function translate(language, key) {
+    return messages[language][key];
+}
+export function localizeText(language, english) {
+    return language === 'zh-CN' ? (zhTextByEnglish[english] ?? english) : english;
+}
+export function resolveLanguage(explicit, locale) {
+    if (explicit === 'zh-CN' || explicit === 'en') {
+        return explicit;
+    }
+    if (locale?.toLowerCase().startsWith('en') === true) {
+        return 'en';
+    }
+    return 'zh-CN';
+}
+//# sourceMappingURL=i18n.js.map

package/dist/cli/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/cli/main.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { CommanderError } from 'commander';
+import { createCliContext, inferCommand, optionValue } from './context.js';
+import { createProgram, commanderError } from './program.js';
+import { errorEnvelope } from '../contracts/envelope.js';
+import { internalError } from '../contracts/errors.js';
+import { renderResult } from '../output/renderer.js';
+import { ApiKeyAuthProvider } from '../infrastructure/credentials/api-key-provider.js';
+import { KeyringCredentialStore } from '../infrastructure/credentials/keyring.js';
+import path from 'node:path';
+import { createPlatformPaths } from '../infrastructure/filesystem/platform-paths.js';
+import { loadConfig } from '../application/config.js';
+import { maybeEmitCachedUpdateNotice } from '../infrastructure/updater/check.js';
+const require = createRequire(import.meta.url);
+const packageMetadata = require('../../package.json');
+const argv = process.argv.slice(2);
+if (argv.length === 0) {
+    argv.push('--help');
+    process.argv.push('--help');
+}
+let context = createCliContext(argv);
+if (argv.length === 1 && (argv[0] === '--version' || argv[0] === '-V')) {
+    process.stdout.write(`${packageMetadata.version}\n`);
+}
+else
+    try {
+        const platformPaths = createPlatformPaths();
+        const packageRoot = path.resolve(import.meta.dirname, '../..');
+        const rawDbPath = optionValue(argv, '--db');
+        const rawProfile = optionValue(argv, '--profile');
+        const rawFormat = optionValue(argv, '--format');
+        const rawLanguage = optionValue(argv, '--lang');
+        const rawConfigPath = optionValue(argv, '--config');
+        const resolvedConfig = await loadConfig({
+            paths: platformPaths,
+            cli: {
+                ...(rawDbPath === undefined ? {} : { dbPath: rawDbPath }),
+                ...(rawProfile === undefined ? {} : { profile: rawProfile }),
+                ...(rawFormat === undefined ? {} : { format: rawFormat }),
+                ...(rawLanguage === 'zh-CN' || rawLanguage === 'en' ? { language: rawLanguage } : {}),
+                ...(rawConfigPath === undefined ? {} : { configPath: rawConfigPath }),
+            },
+        });
+        context = createCliContext(argv, {
+            format: resolvedConfig.format,
+            ...(resolvedConfig.language === undefined ? {} : { language: resolvedConfig.language }),
+        });
+        const program = createProgram(packageMetadata, context, {
+            authProvider: new ApiKeyAuthProvider(new KeyringCredentialStore(), process.env),
+            fuyaoBaseUrl: process.env.HITHINK_FINANCE_FUYAO_BASE_URL ?? 'https://fuyao.aicubes.cn',
+            packageRoot,
+            platformPaths: { ...platformPaths, defaultDbPath: resolvedConfig.dbPath },
+            resolvedConfig,
+        });
+        await program.parseAsync(process.argv);
+        if (inferCommand(argv) !== 'update') {
+            await maybeEmitCachedUpdateNotice({
+                packageRoot,
+                packageName: packageMetadata.name,
+                currentVersion: packageMetadata.version,
+                cacheFile: path.join(platformPaths.stateDir, 'update-cache.json'),
+                stderr: context.stderr,
+                disabled: !resolvedConfig.updateCheck,
+            });
+        }
+    }
+    catch (error) {
+        if (error instanceof CommanderError && error.exitCode === 0) {
+            process.exitCode = 0;
+        }
+        else {
+            const cliError = error instanceof CommanderError
+                ? commanderError(error, context.language)
+                : internalError(error);
+            await renderResult(errorEnvelope(inferCommand(argv), cliError, packageMetadata.version), context);
+            process.exitCode = cliError.exitCode;
+        }
+    }
+//# sourceMappingURL=main.js.map

package/dist/cli/program.d.ts

@@ -0,0 +1,20 @@
+import { Command, CommanderError } from 'commander';
+import type { CliContext } from './context.js';
+import { CliError } from '../contracts/errors.js';
+import type { ApiKeyAuthProvider } from '../infrastructure/credentials/api-key-provider.js';
+import type { PlatformPaths } from '../infrastructure/filesystem/platform-paths.js';
+import type { ResolvedConfig } from '../application/config.js';
+export interface PackageMetadata {
+    name: string;
+    version: string;
+}
+export interface ProgramDependencies {
+    authProvider: ApiKeyAuthProvider;
+    fuyaoBaseUrl: string;
+    packageRoot: string;
+    platformPaths: PlatformPaths;
+    resolvedConfig: ResolvedConfig;
+}
+export declare function createProgram(metadata: PackageMetadata, context: CliContext, dependencies: ProgramDependencies): Command;
+export declare function commanderError(error: CommanderError, language: CliContext['language']): CliError;
+//# sourceMappingURL=program.d.ts.map