oh-my-knowledge 0.30.0 → 0.31.0

package/dist/src/cli/commands/skill-extract.d.ts

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../oclif/base-command.js';
+import { type CliLang } from '../lib/i18n.js';
+import type { SkillExtractArgs, SkillExtractFlags } from '../lib/cmd-flags.js';
+export declare function runSkillExtract(args: SkillExtractArgs, flags: SkillExtractFlags, lang: CliLang): Promise<void>;
+export default class SkillExtract extends BaseCommand {
+    static description: string;
+    static args: {
+        skillName: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'input-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        review: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        reason: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=skill-extract.d.ts.map

package/dist/src/cli/commands/skill-extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-extract.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/skill-extract.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAc/E,wBAAsB,eAAe,CACnC,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAW;IACnD,MAAM,CAAC,WAAW,SAGf;IAEH,MAAM,CAAC,IAAI;;MAKT;IAEF,MAAM,CAAC,KAAK;;;;;;;MAuBV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAO3B"}

package/dist/src/cli/commands/skill-extract.js

@@ -0,0 +1,84 @@
+import { resolve } from 'node:path';
+import { Args, Flags } from '@oclif/core';
+import { LANG_FLAG, bilingual } from '../oclif/i18n.js';
+import { BaseCommand } from '../oclif/base-command.js';
+import { enumStringParser } from '../oclif/parsers.js';
+import { DEFAULT_OBSERVATIONS_DIR } from '../../observability/inbox.js';
+import { updateObservationReviewState } from '../../observability/review-state.js';
+import { updateSkillDerivedStandardStatus } from '../../observability/soft-standards.js';
+const STATUS_VALUES = ['author_confirmed', 'rejected', 'pending_review', 'confirm', 'confirmed', 'reject', 'pending'];
+function canonicalStatus(value) {
+    if (!value || value === 'confirm' || value === 'confirmed')
+        return 'author_confirmed';
+    if (value === 'reject')
+        return 'rejected';
+    if (value === 'pending')
+        return 'pending_review';
+    return value;
+}
+export async function runSkillExtract(args, flags, lang) {
+    const skillName = args.skillName;
+    const standardId = flags.review;
+    const status = canonicalStatus(flags.status);
+    const observationsDir = resolve(flags['input-dir'] || DEFAULT_OBSERVATIONS_DIR);
+    const now = new Date().toISOString();
+    const record = updateSkillDerivedStandardStatus(observationsDir, skillName, standardId, status, now);
+    const verdict = status === 'author_confirmed' ? 'real_issue' : status === 'rejected' ? 'not_issue' : 'needs_more_context';
+    const reviewState = updateObservationReviewState(observationsDir, {
+        targetType: 'soft_standard',
+        targetId: `${skillName}:${standardId}`,
+        verdict,
+        reason: flags.reason,
+    }, now);
+    if (flags.json) {
+        console.log(JSON.stringify({ kind: 'skill-extract-review', skillName, standardId, status, record, reviewState }, null, 2));
+        return;
+    }
+    console.log(lang === 'zh'
+        ? `软标准已复核：${skillName} ${standardId} status=${status}`
+        : `Soft standard reviewed: ${skillName} ${standardId} status=${status}`);
+}
+export default class SkillExtract extends BaseCommand {
+    static description = bilingual({
+        zh: '确认或否决 skill 软标准候选。',
+        en: 'Confirm or reject skill soft standard candidates.',
+    });
+    static args = {
+        skillName: Args.string({
+            description: bilingual({ zh: 'skill 名称', en: 'Skill name' }),
+            required: true,
+        }),
+    };
+    static flags = {
+        lang: LANG_FLAG,
+        'input-dir': Flags.string({
+            description: bilingual({ zh: 'observation 数据目录', en: 'Observation data directory' }),
+        }),
+        review: Flags.string({
+            description: bilingual({ zh: '要确认或否决的软标准 ID', en: 'Soft standard id to review' }),
+            required: true,
+        }),
+        status: Flags.string({
+            description: bilingual({
+                zh: '确认状态：author_confirmed / rejected / pending_review（也接受 confirm / confirmed / reject / pending 别名）',
+                en: 'Review status: author_confirmed / rejected / pending_review (also accepts aliases: confirm / confirmed / reject / pending)',
+            }),
+            parse: enumStringParser('--status', STATUS_VALUES),
+        }),
+        reason: Flags.string({
+            description: bilingual({ zh: '人工判断原因', en: 'Manual review reason' }),
+        }),
+        json: Flags.boolean({
+            description: bilingual({ zh: 'JSON 格式输出', en: 'JSON output' }),
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(SkillExtract);
+        const lang = this.lang;
+        await this.runWithCliExit(async () => {
+            await runSkillExtract(args, { ...flags, lang }, lang);
+        });
+    }
+}
+//# sourceMappingURL=skill-extract.js.map

package/dist/src/cli/commands/skill-extract.js.map

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

package/dist/src/cli/commands/studio.d.ts

@@ -1,2 +1,23 @@
-export declare function execute(argv: string[]): Promise<void>;
+import { BaseCommand } from '../oclif/base-command.js';
+import { type CliLang } from '../lib/i18n.js';
+import type { StudioArgs, StudioFlags } from '../lib/cmd-flags.js';
+export declare function runStudio(_args: StudioArgs, flags: StudioFlags, lang: CliLang): Promise<void>;
+export default class Studio extends BaseCommand {
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static flags: {
+        lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        port: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        host: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'reports-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'analyses-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'observations-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'no-open': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        dev: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
 //# sourceMappingURL=studio.d.ts.map

package/dist/src/cli/commands/studio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"studio.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/studio.ts"],"names":[],"mappings":"AA0BA,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6D3D"}
+{"version":3,"file":"studio.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/studio.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGpD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAyBnE,wBAAsB,SAAS,CAC7B,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,IAAI,CAAC,CAsDf;AAED,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,WAAW;IAC7C,MAAM,CAAC,WAAW,SAGf;IAEH,MAAM,CAAC,QAAQ;;;QAYb;IAEF,MAAM,CAAC,KAAK;;;;;;;;;MAgDV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAO3B"}

package/dist/src/cli/commands/studio.js

@@ -1,7 +1,10 @@
 import { resolve } from 'node:path';
-import { langFromArgv, tCli } from '../i18n.js';
-import { COMMON_OPTIONS, DEFAULT_REPORTS_DIR } from '../parse-run-config.js';
-import { parseArgsStrictOrExit } from '../parse-strict.js';
+import { Flags } from '@oclif/core';
+import { LANG_FLAG, bilingual } from '../oclif/i18n.js';
+import { BaseCommand } from '../oclif/base-command.js';
+import { integerStringParser } from '../oclif/parsers.js';
+import { tCli } from '../lib/i18n.js';
+import { DEFAULT_REPORTS_DIR } from '../lib/parse-run-config.js';
 async function openWorkbench(url, lang) {
     const { execFile } = await import('node:child_process');
     const { platform } = await import('node:os');
@@ -22,63 +25,134 @@ async function openWorkbench(url, lang) {
         }));
     });
 }
-export async function execute(argv) {
-    const lang = langFromArgv(argv);
-    const { values } = parseArgsStrictOrExit({
-        args: argv,
-        options: {
-            ...COMMON_OPTIONS,
-            port: { type: 'string', default: '7799' },
-            host: { type: 'string' },
-            'reports-dir': { type: 'string', default: DEFAULT_REPORTS_DIR },
-            'analyses-dir': { type: 'string' },
-            'observations-dir': { type: 'string' },
-            'no-open': { type: 'boolean', default: false },
-            dev: { type: 'boolean', default: false },
-        },
-    });
-    if (values.dev && !process.env.__OMK_DEV_CHILD) {
+// dev / browser-open 测试需要 mock `node:child_process` + `node:os`,通过 in-process
+// import 直接调用。把业务作为 module-level helper export 从 Command file 暴露,
+// 既保留 test 兼容又让产品命令树语义干净(无 legacy commands directory)。
+export async function runStudio(_args, flags, lang) {
+    const reportsDir = flags['reports-dir'] ?? DEFAULT_REPORTS_DIR;
+    if (flags.dev && !process.env.__OMK_DEV_CHILD) {
         const { spawn } = await import('node:child_process');
         const { fileURLToPath } = await import('node:url');
+        // 路径绑定:`commands/studio.{ts,js}` → 两层 `..` 回 `cli/`,再 `index.js`。
+        // 移动本文件到不同嵌套(例如 `commands/group/studio.ts`)需同步改 `..` 数量。
+        // cli/index.{ts,js} 在源跟 dist 中位置一致(src/cli/index.ts → dist/src/cli/index.js)。
         const cliPath = resolve(fileURLToPath(import.meta.url), '..', '..', 'index.js');
         const watchRoot = resolve(cliPath, '..', '..');
-        const args = [
+        const childArgs = [
             '--watch-path', watchRoot,
             cliPath,
             'studio',
-            '--port', values.port,
-            ...(values.host ? ['--host', values.host] : []),
-            '--reports-dir', values['reports-dir'],
+            '--port', flags.port,
+            ...(flags.host ? ['--host', flags.host] : []),
+            '--reports-dir', reportsDir,
         ];
-        if (values['analyses-dir']) {
-            args.push('--analyses-dir', values['analyses-dir']);
+        if (flags['analyses-dir']) {
+            childArgs.push('--analyses-dir', flags['analyses-dir']);
         }
-        if (values['observations-dir']) {
-            args.push('--observations-dir', values['observations-dir']);
+        if (flags['observations-dir']) {
+            childArgs.push('--observations-dir', flags['observations-dir']);
         }
-        if (values['no-open']) {
-            args.push('--no-open');
+        if (flags['no-open']) {
+            childArgs.push('--no-open');
         }
-        const child = spawn(process.execPath, args, {
+        const child = spawn(process.execPath, childArgs, {
             stdio: 'inherit',
             env: { ...process.env, __OMK_DEV_CHILD: '1' },
         });
-        child.on('exit', (code) => process.exit(code || 0));
+        // child 被 signal kill 时 code=null,用 ?? 退 1 让父进程感知异常退出,
+        // 不要 `code || 0` 把 null 当 0 假装成功(把 signal kill / unknown exit 也
+        // 当成功上报会让 omk studio --dev 的 crash 静默)。
+        child.on('exit', (code) => process.exit(code ?? 1));
         return;
     }
     const { createReportServer } = await import('../../server/report-server.js');
     const server = createReportServer({
-        port: Number(values.port),
-        ...(values.host ? { host: values.host } : {}),
-        reportsDir: resolve(values['reports-dir']),
-        ...(values['analyses-dir'] ? { analysesDir: resolve(values['analyses-dir']) } : {}),
-        ...(values['observations-dir'] ? { observationsDir: resolve(values['observations-dir']) } : {}),
+        port: Number(flags.port),
+        ...(flags.host ? { host: flags.host } : {}),
+        reportsDir: resolve(reportsDir),
+        ...(flags['analyses-dir'] ? { analysesDir: resolve(flags['analyses-dir']) } : {}),
+        ...(flags['observations-dir'] ? { observationsDir: resolve(flags['observations-dir']) } : {}),
     });
     const url = await server.start();
     console.log(tCli('cli.studio.started', lang, { url }));
     console.log(tCli('cli.studio.stop_hint', lang));
-    if (!values['no-open'] && process.stdout.isTTY) {
+    if (!flags['no-open'] && process.stdout.isTTY) {
         await openWorkbench(url, lang);
     }
 }
+export default class Studio extends BaseCommand {
+    static description = bilingual({
+        zh: '启动 omk Studio 报告服务（skill-centric 仪表盘 + 浏览器自动打开）。',
+        en: 'Start omk Studio report server (skill-centric dashboard + browser auto-open).',
+    });
+    static examples = [
+        {
+            description: bilingual({ zh: '默认端口 7799', en: 'Default port 7799' }),
+            command: '<%= config.bin %> studio',
+        },
+        {
+            description: bilingual({
+                zh: '指定端口，不打开浏览器',
+                en: 'Custom port, no browser',
+            }),
+            command: '<%= config.bin %> studio --port 8080 --no-open',
+        },
+    ];
+    static flags = {
+        lang: LANG_FLAG,
+        port: Flags.string({
+            description: bilingual({
+                zh: '监听端口，默认 7799。传 0 让 OS 分配',
+                en: 'Listen port, default 7799. Pass 0 for OS-assigned',
+            }),
+            default: '7799',
+            parse: integerStringParser('--port', { min: 0, max: 65_535 }),
+        }),
+        host: Flags.string({
+            description: bilingual({
+                zh: '监听 host，默认 localhost。改为 0.0.0.0 暴露给局域网',
+                en: 'Listen host, default localhost. Use 0.0.0.0 to expose to LAN',
+            }),
+        }),
+        'reports-dir': Flags.string({
+            description: bilingual({
+                zh: '报告目录，默认 ~/.oh-my-knowledge/reports',
+                en: 'Reports dir, default ~/.oh-my-knowledge/reports',
+            }),
+        }),
+        'analyses-dir': Flags.string({
+            description: bilingual({
+                zh: '分析数据目录（可选）',
+                en: 'Analyses dir (optional)',
+            }),
+        }),
+        'observations-dir': Flags.string({
+            description: bilingual({
+                zh: '观测数据目录（可选）',
+                en: 'Observations dir (optional)',
+            }),
+        }),
+        'no-open': Flags.boolean({
+            description: bilingual({
+                zh: '不自动打开浏览器',
+                en: 'Do not auto-open browser',
+            }),
+            default: false,
+        }),
+        dev: Flags.boolean({
+            description: bilingual({
+                zh: 'dev 模式：子进程启动 + 热更新',
+                en: 'Dev mode: child process with hot reload',
+            }),
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Studio);
+        const lang = this.lang;
+        await this.runWithCliExit(async () => {
+            await runStudio({}, { ...flags, lang }, lang);
+        });
+    }
+}
 //# sourceMappingURL=studio.js.map

package/dist/src/cli/commands/studio.js.map

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

package/dist/src/cli/index.js

@@ -1,57 +1,25 @@
 #!/usr/bin/env node
-import { tCli, getCliLang, parseLangFromArgv } from './i18n.js';
-import { checkUpdate } from './update-check.js';
-import { CliExit } from './cli-exit.js';
-import { PRODUCT_COMMANDS } from './commands/registry.js';
-/**
- * --help / -h 在 argv 任意位置都打印对应 helpKey 内容并 exit 0。
- * 集中在 dispatcher 处理,因为下游 execute 走 parseArgsStrictOrExit,
- * 那一层 strict:true 不识别 --help 会当 unknown option 报错。
- */
-function helpKeyFor(cmd, argv) {
-    if (!cmd.subHelp)
-        return cmd.helpKey;
-    for (let i = 0; i < argv.length; i++) {
-        const token = argv[i];
-        if (!token || token === '--help' || token === '-h')
-            continue;
-        if (token === '--lang') {
-            i++;
-            continue;
-        }
-        if (token.startsWith('--lang='))
-            continue;
-        if (token.startsWith('-'))
-            continue;
-        return cmd.subHelp[token] ?? cmd.helpKey;
-    }
-    return cmd.helpKey;
-}
-function dispatchOrPrintHelp(cmd, argv, lang) {
-    if (argv.includes('--help') || argv.includes('-h')) {
-        console.log(tCli(helpKeyFor(cmd, argv), lang).trim());
-        throw new CliExit(0);
-    }
-    return cmd.execute(argv);
+import { getCliLang, parseLangFromArgv } from './lib/i18n.js';
+import { checkUpdate } from './lib/update-check.js';
+import { CliExit } from './lib/cli-exit.js';
+// CLI 入口:lang / 版本提醒等共享前置逻辑跑完,把控制权交给 oclif dispatcher。
+// 所有命令统一走 src/cli/commands/* 下的 oclif Command。
+// --help / --version / -h / -v 走短路径,不应当被网络 I/O 拖慢。oclif 走完
+// --help 路径自然 resolve 不调 process.exit,unawaited fetch 会把 event
+// loop 拖住 ~1s(worst case AbortSignal.timeout 3s)。短路径整体 skip checkUpdate。
+const SHORT_PATH_FLAGS = ['--help', '-h', '--version', '-v'];
+function isShortPath(argv) {
+    return argv.some((a) => SHORT_PATH_FLAGS.includes(a));
 }
 async function main() {
     const lang = getCliLang(parseLangFromArgv(process.argv));
-    checkUpdate(lang);
-    const [command, ...rest] = process.argv.slice(2);
-    if (!command || command === '--help' || command === '-h') {
-        console.log(tCli('cli.help.product_main', lang).trim());
-        throw new CliExit(0);
-    }
-    const cmd = PRODUCT_COMMANDS[command];
-    if (!cmd) {
-        console.error(tCli('cli.common.unknown_domain', lang, { domain: command }));
-        throw new CliExit(1);
+    if (!isShortPath(process.argv)) {
+        checkUpdate(lang);
     }
-    await dispatchOrPrintHelp(cmd, rest, lang);
+    const { runOclifPath } = await import('./oclif/run.js');
+    await runOclifPath();
 }
 main().catch((err) => {
-    // CliExit = 命令显式终止(--help / 业务失败 / parse 错误等),透传 exit code。
-    // 其他 throw 是未处理的运行时错误,打印 stack 后 exit 1。
     if (err instanceof CliExit) {
         process.exit(err.code);
     }

package/dist/src/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,uDAAuD;AACvD,+CAA+C;AAE/C,2DAA2D;AAC3D,+DAA+D;AAC/D,yEAAyE;AACzE,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;AAC7D,SAAS,WAAW,CAAC,IAAuB;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,WAAW,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACxD,MAAM,YAAY,EAAE,CAAC;AACvB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,IAAI,GAAG,YAAY,OAAO,EAAE,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/src/cli/lib/cli-exit.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 命令退出信号。业务逻辑 / requireEvaluationReport 等想以特定 exit code 终止时,
+ * throw 这个,不要直接 process.exit。
+ *
+ * oclif Command.run() 末尾的 try/catch 把 CliExit 转成 this.exit(code);main()
+ * 顶层 catch 兜底转 process.exit — 这样业务可以在单测里被 try/catch 捕获,不 kill
+ * 整个测试进程。
+ *
+ * 异步回调内的「子进程 exit code 透传」(如 studio --dev spawn child)不走这层,
+ * 继续 process.exit — 那是子进程退出后的 cleanup,不在 main 调用栈。
+ */
+export declare class CliExit extends Error {
+    readonly code: number;
+    constructor(code: number);
+}
+//# sourceMappingURL=cli-exit.d.ts.map

package/dist/src/cli/lib/cli-exit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-exit.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/cli-exit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,qBAAa,OAAQ,SAAQ,KAAK;aACJ,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAIzC"}

package/dist/src/cli/lib/cli-exit.js

@@ -0,0 +1,20 @@
+/**
+ * 命令退出信号。业务逻辑 / requireEvaluationReport 等想以特定 exit code 终止时,
+ * throw 这个,不要直接 process.exit。
+ *
+ * oclif Command.run() 末尾的 try/catch 把 CliExit 转成 this.exit(code);main()
+ * 顶层 catch 兜底转 process.exit — 这样业务可以在单测里被 try/catch 捕获,不 kill
+ * 整个测试进程。
+ *
+ * 异步回调内的「子进程 exit code 透传」(如 studio --dev spawn child)不走这层,
+ * 继续 process.exit — 那是子进程退出后的 cleanup,不在 main 调用栈。
+ */
+export class CliExit extends Error {
+    code;
+    constructor(code) {
+        super(`CliExit(${code})`);
+        this.code = code;
+        this.name = 'CliExit';
+    }
+}
+//# sourceMappingURL=cli-exit.js.map

package/dist/src/cli/lib/cli-exit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-exit.js","sourceRoot":"","sources":["../../../../src/cli/lib/cli-exit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,OAAQ,SAAQ,KAAK;IACJ;IAA5B,YAA4B,IAAY;QACtC,KAAK,CAAC,WAAW,IAAI,GAAG,CAAC,CAAC;QADA,SAAI,GAAJ,IAAI,CAAQ;QAEtC,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IACxB,CAAC;CACF"}