snapshot-checker 0.8.3 → 0.8.7

package/dist/src/index.js

@@ -1,6 +1,6 @@
 export { executeOne, executeAll, finalizeBackgroundProcesses, getCommandsToRun, getCommandsToRunWithRepeat, getGroupChunks, runGroupChunks, isSupportedOnCurrentPlatform, } from "hmcommand-runner";
 export { parseGroupSpecs } from "hmcommand-runner";
-export { buildApplyOptionsInput, resolveScenario, runScenarioGroups, normalizeGroupCliArg, } from "./lib/scenario.js";
-export { createHdcCli } from "./lib/hdc.js";
-export { CommandKind, createCommandContext, getCurrentPlatformKind } from "hmcommand-runner";
+export { buildApplyOptionsInput, resolveCommandSuite, runCommandSuiteGroups, normalizeGroupCliArg, } from "./lib/command_suite/runner.js";
+export { createHdcCli } from "./lib/report/hdc.js";
+export { CommandKind, createCommandContext, getCurrentPlatformKind, } from "hmcommand-runner";
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,UAAU,EACV,2BAA2B,EAC3B,gBAAgB,EAChB,0BAA0B,EAC1B,cAAc,EACd,cAAc,EACd,4BAA4B,GAK7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GAKrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAe,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,UAAU,EACV,2BAA2B,EAC3B,gBAAgB,EAChB,0BAA0B,EAC1B,cAAc,EACd,cAAc,EACd,4BAA4B,GAK7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,GAKrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,YAAY,EAAe,MAAM,qBAAqB,CAAC;AAChE,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC"}

package/dist/src/lib/cli/env.d.ts

@@ -0,0 +1,9 @@
+/** pkg 二进制构建时注入的版本环境变量名 */
+export declare const HYPER_STARTUP_CHECKER_BUNDLED_VERSION_ENV = "HYPER_STARTUP_CHECKER_BUNDLED_VERSION";
+/** CLI 默认日志级别环境变量名（优先于 `LOG_LEVEL`） */
+export declare const HYPER_STARTUP_CHECKER_LOG_LEVEL_ENV = "HYPER_STARTUP_CHECKER_LOG_LEVEL";
+/** 读取 pkg 嵌入版本；新变量优先，兼容旧 `SNAPSHOT_CHECKER_BUNDLED_VERSION`。 */
+export declare function readHyperStartUpCheckerBundledVersionFromEnv(): string | undefined;
+/** 读取默认日志级别 env；新变量优先，兼容旧 `SNAPSHOT_CHECKER_LOG_LEVEL`。 */
+export declare function readHyperStartUpCheckerLogLevelFromEnv(): string | undefined;
+//# sourceMappingURL=env.d.ts.map

package/dist/src/lib/cli/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../src/lib/cli/env.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,eAAO,MAAM,yCAAyC,0CACb,CAAC;AAE1C,uCAAuC;AACvC,eAAO,MAAM,mCAAmC,oCAAoC,CAAC;AAKrF,gEAAgE;AAChE,wBAAgB,4CAA4C,IAAI,MAAM,GAAG,SAAS,CAOjF;AAED,2DAA2D;AAC3D,wBAAgB,sCAAsC,IAAI,MAAM,GAAG,SAAS,CAO3E"}

package/dist/src/lib/cli/env.js

@@ -0,0 +1,25 @@
+/** pkg 二进制构建时注入的版本环境变量名 */
+export const HYPER_STARTUP_CHECKER_BUNDLED_VERSION_ENV = "HYPER_STARTUP_CHECKER_BUNDLED_VERSION";
+/** CLI 默认日志级别环境变量名（优先于 `LOG_LEVEL`） */
+export const HYPER_STARTUP_CHECKER_LOG_LEVEL_ENV = "HYPER_STARTUP_CHECKER_LOG_LEVEL";
+const LEGACY_SNAPSHOT_CHECKER_BUNDLED_VERSION_ENV = "SNAPSHOT_CHECKER_BUNDLED_VERSION";
+const LEGACY_SNAPSHOT_CHECKER_LOG_LEVEL_ENV = "SNAPSHOT_CHECKER_LOG_LEVEL";
+/** 读取 pkg 嵌入版本；新变量优先，兼容旧 `SNAPSHOT_CHECKER_BUNDLED_VERSION`。 */
+export function readHyperStartUpCheckerBundledVersionFromEnv() {
+    const primary = process.env[HYPER_STARTUP_CHECKER_BUNDLED_VERSION_ENV]?.trim();
+    if (primary) {
+        return primary;
+    }
+    const legacy = process.env[LEGACY_SNAPSHOT_CHECKER_BUNDLED_VERSION_ENV]?.trim();
+    return legacy || undefined;
+}
+/** 读取默认日志级别 env；新变量优先，兼容旧 `SNAPSHOT_CHECKER_LOG_LEVEL`。 */
+export function readHyperStartUpCheckerLogLevelFromEnv() {
+    const primary = process.env[HYPER_STARTUP_CHECKER_LOG_LEVEL_ENV]?.trim();
+    if (primary) {
+        return primary;
+    }
+    const legacy = process.env[LEGACY_SNAPSHOT_CHECKER_LOG_LEVEL_ENV]?.trim();
+    return legacy || undefined;
+}
+//# sourceMappingURL=env.js.map

package/dist/src/lib/cli/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../../src/lib/cli/env.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,MAAM,CAAC,MAAM,yCAAyC,GACpD,uCAAuC,CAAC;AAE1C,uCAAuC;AACvC,MAAM,CAAC,MAAM,mCAAmC,GAAG,iCAAiC,CAAC;AAErF,MAAM,2CAA2C,GAAG,kCAAkC,CAAC;AACvF,MAAM,qCAAqC,GAAG,4BAA4B,CAAC;AAE3E,gEAAgE;AAChE,MAAM,UAAU,4CAA4C;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,EAAE,IAAI,EAAE,CAAC;IAC/E,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,EAAE,IAAI,EAAE,CAAC;IAChF,OAAO,MAAM,IAAI,SAAS,CAAC;AAC7B,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,sCAAsC;IACpD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,EAAE,IAAI,EAAE,CAAC;IACzE,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,EAAE,IAAI,EAAE,CAAC;IAC1E,OAAO,MAAM,IAAI,SAAS,CAAC;AAC7B,CAAC"}

package/dist/src/lib/cli/errors.d.ts

@@ -0,0 +1,13 @@
+/** CLI 参数/契约类错误；退出码 2，便于 Agent 与脚本区分执行失败（1）。 */
+export declare class CliUsageError extends Error {
+    readonly exitCode = 2;
+    readonly code: string;
+    readonly details?: Record<string, unknown>;
+    constructor(code: string, message: string, details?: Record<string, unknown>);
+}
+export declare function isCliUsageError(error: unknown): error is CliUsageError;
+export declare function formatCliFatalError(error: unknown): {
+    message: string;
+    exitCode: number;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/lib/cli/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/lib/cli/errors.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,QAAQ,KAAK;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE/B,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAM7E;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAMA"}

package/dist/src/lib/cli/errors.js

@@ -0,0 +1,23 @@
+/** CLI 参数/契约类错误；退出码 2，便于 Agent 与脚本区分执行失败（1）。 */
+export class CliUsageError extends Error {
+    exitCode = 2;
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = "CliUsageError";
+        this.code = code;
+        this.details = details;
+    }
+}
+export function isCliUsageError(error) {
+    return error instanceof CliUsageError;
+}
+export function formatCliFatalError(error) {
+    if (isCliUsageError(error)) {
+        return { message: error.message, exitCode: error.exitCode };
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return { message, exitCode: 1 };
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/lib/cli/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/lib/cli/errors.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,QAAQ,GAAG,CAAC,CAAC;IACb,IAAI,CAAS;IACb,OAAO,CAA2B;IAE3C,YAAY,IAAY,EAAE,OAAe,EAAE,OAAiC;QAC1E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,aAAa,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAIhD,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC9D,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;AAClC,CAAC"}

package/dist/src/lib/cli/fatal.d.ts

@@ -0,0 +1,2 @@
+export declare function handleCliFatalError(error: unknown, argv?: readonly string[]): void;
+//# sourceMappingURL=fatal.d.ts.map

package/dist/src/lib/cli/fatal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fatal.d.ts","sourceRoot":"","sources":["../../../../src/lib/cli/fatal.ts"],"names":[],"mappings":"AAGA,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,SAAS,MAAM,EAAiB,GACrC,IAAI,CAWN"}

package/dist/src/lib/cli/fatal.js

@@ -0,0 +1,15 @@
+import { formatCliFatalError } from "./errors.js";
+import { resolveOutputFormatFromArgv, writeCliJsonError } from "./output.js";
+export function handleCliFatalError(error, argv = process.argv) {
+    const outputFormat = resolveOutputFormatFromArgv(argv.slice(2));
+    const { exitCode } = formatCliFatalError(error);
+    if (outputFormat === "json") {
+        writeCliJsonError(error);
+        process.exitCode = exitCode;
+        return;
+    }
+    const { message } = formatCliFatalError(error);
+    console.error(message);
+    process.exitCode = exitCode;
+}
+//# sourceMappingURL=fatal.js.map

package/dist/src/lib/cli/fatal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fatal.js","sourceRoot":"","sources":["../../../../src/lib/cli/fatal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE7E,MAAM,UAAU,mBAAmB,CACjC,KAAc,EACd,OAA0B,OAAO,CAAC,IAAI;IAEtC,MAAM,YAAY,GAAG,2BAA2B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;QAC5B,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACzB,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC5B,OAAO;IACT,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvB,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC9B,CAAC"}

package/dist/src/lib/cli/global_options.d.ts

@@ -0,0 +1,4 @@
+import type { CommandSuiteGlobalOptions } from "../command_suite/globals.js";
+/** 从 argv 读取用户显式传入的根级全局选项（不含 Commander 默认值）。 */
+export declare function readExplicitRootGlobalOptionsFromArgv(argv: readonly string[]): CommandSuiteGlobalOptions;
+//# sourceMappingURL=global_options.d.ts.map

package/dist/src/lib/cli/global_options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global_options.d.ts","sourceRoot":"","sources":["../../../../src/lib/cli/global_options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAE7E,gDAAgD;AAChD,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,yBAAyB,CAqB3B"}

package/dist/src/lib/cli/global_options.js

@@ -0,0 +1,27 @@
+/** 从 argv 读取用户显式传入的根级全局选项（不含 Commander 默认值）。 */
+export function readExplicitRootGlobalOptionsFromArgv(argv) {
+    const explicit = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === "--hdc-target") {
+            const next = argv[i + 1];
+            if (next !== undefined && !next.startsWith("-")) {
+                explicit.hdcTarget = next;
+            }
+        }
+        else if (arg.startsWith("--hdc-target=")) {
+            explicit.hdcTarget = arg.slice("--hdc-target=".length);
+        }
+        else if (arg === "--parse-concurrency") {
+            const next = argv[i + 1];
+            if (next !== undefined && !next.startsWith("-")) {
+                explicit.parseConcurrency = next;
+            }
+        }
+        else if (arg.startsWith("--parse-concurrency=")) {
+            explicit.parseConcurrency = arg.slice("--parse-concurrency=".length);
+        }
+    }
+    return explicit;
+}
+//# sourceMappingURL=global_options.js.map

package/dist/src/lib/cli/global_options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global_options.js","sourceRoot":"","sources":["../../../../src/lib/cli/global_options.ts"],"names":[],"mappings":"AAEA,gDAAgD;AAChD,MAAM,UAAU,qCAAqC,CACnD,IAAuB;IAEvB,MAAM,QAAQ,GAA8B,EAAE,CAAC;IAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACrB,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACzB,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChD,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC;YAC5B,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAC3C,QAAQ,CAAC,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QACzD,CAAC;aAAM,IAAI,GAAG,KAAK,qBAAqB,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACzB,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChD,QAAQ,CAAC,gBAAgB,GAAG,IAAI,CAAC;YACnC,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,sBAAsB,CAAC,EAAE,CAAC;YAClD,QAAQ,CAAC,gBAAgB,GAAG,GAAG,CAAC,KAAK,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/src/lib/cli/output.d.ts

@@ -0,0 +1,26 @@
+import type { CommandSuiteCliOutputFormat } from "hmcommand-runner/cli";
+export type { CommandSuiteCliOutputFormat };
+export declare const CLI_OUTPUT_FORMATS: readonly ["text", "json"];
+export interface CliJsonErrorResult {
+    schema_version: string;
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+        [key: string]: unknown;
+    };
+}
+export interface ReportOutputArtifact {
+    path: string;
+    role: string;
+    exists: boolean;
+}
+/** 从 argv 解析 `--output-format`（与 `--output-dir` 无关；支持 `--output-format=json`）。 */
+export declare function resolveOutputFormatFromArgv(argv: readonly string[]): CommandSuiteCliOutputFormat;
+/** 读取全局 `--output-format`；`--output-dir` 为采集产物目录，语义不同。 */
+export declare function resolveOutputFormatFromCli(globals: Record<string, unknown>): CommandSuiteCliOutputFormat;
+export declare function formatCliJsonError(error: unknown): CliJsonErrorResult;
+export declare function writeCliJsonError(error: unknown): void;
+/** report 场景成功执行后的主要产物路径。 */
+export declare function collectReportOutputArtifacts(outputDirRaw: string | undefined): ReportOutputArtifact[];
+//# sourceMappingURL=output.d.ts.map

package/dist/src/lib/cli/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../../src/lib/cli/output.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAKxE,YAAY,EAAE,2BAA2B,EAAE,CAAC;AAE5C,eAAO,MAAM,kBAAkB,2BAA4B,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,kFAAkF;AAClF,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,2BAA2B,CAkB7B;AAED,0DAA0D;AAC1D,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,2BAA2B,CAM7B;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAqBrE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEtD;AAcD,6BAA6B;AAC7B,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,oBAAoB,EAAE,CAUxB"}

package/dist/src/lib/cli/output.js

@@ -0,0 +1,83 @@
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { COMMAND_SUITE_CLI_RESULT_SCHEMA_VERSION } from "hmcommand-runner/cli";
+import { isCliUsageError } from "./errors.js";
+import { normalizeCliOutputDir } from "../report/paths.js";
+export const CLI_OUTPUT_FORMATS = ["text", "json"];
+/** 从 argv 解析 `--output-format`（与 `--output-dir` 无关；支持 `--output-format=json`）。 */
+export function resolveOutputFormatFromArgv(argv) {
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === "--output-format") {
+            const next = argv[i + 1];
+            if (next === "json" || next === "text") {
+                return next;
+            }
+            continue;
+        }
+        if (arg.startsWith("--output-format=")) {
+            const value = arg.slice("--output-format=".length);
+            if (value === "json" || value === "text") {
+                return value;
+            }
+        }
+    }
+    return "text";
+}
+/** 读取全局 `--output-format`；`--output-dir` 为采集产物目录，语义不同。 */
+export function resolveOutputFormatFromCli(globals) {
+    const raw = globals.outputFormat;
+    if (raw === "json" || raw === "text") {
+        return raw;
+    }
+    return "text";
+}
+export function formatCliJsonError(error) {
+    if (isCliUsageError(error)) {
+        return {
+            schema_version: COMMAND_SUITE_CLI_RESULT_SCHEMA_VERSION,
+            ok: false,
+            error: {
+                code: error.code,
+                message: error.message.split("\n")[0] ?? error.message,
+                ...(error.details ?? {}),
+            },
+        };
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        schema_version: COMMAND_SUITE_CLI_RESULT_SCHEMA_VERSION,
+        ok: false,
+        error: {
+            code: "ERROR",
+            message,
+        },
+    };
+}
+export function writeCliJsonError(error) {
+    process.stdout.write(`${JSON.stringify(formatCliJsonError(error))}\n`);
+}
+const REPORT_OUTPUT_ROLES = [
+    { role: "dump_stack_json", basename: "dump_stack.json" },
+    { role: "dump_stack_txt", basename: "dump_stack.txt" },
+    { role: "dump_stack_xlsx", basename: "dump_stack.xlsx" },
+    { role: "perf_txt", basename: path.join("perf_txt", "hyperstart_perf.data.txt") },
+    { role: "workspace_log", basename: path.join("workspace", "hyperstart_log.txt") },
+    {
+        role: "workspace_hitrace",
+        basename: path.join("workspace", "hyperstart_hitrace.txt"),
+    },
+];
+/** report 场景成功执行后的主要产物路径。 */
+export function collectReportOutputArtifacts(outputDirRaw) {
+    const outputDir = normalizeCliOutputDir(outputDirRaw);
+    return REPORT_OUTPUT_ROLES.map(({ role, basename }) => {
+        const filePath = path.join(outputDir, basename);
+        return {
+            role,
+            path: filePath,
+            exists: existsSync(filePath),
+        };
+    });
+}
+//# sourceMappingURL=output.js.map

package/dist/src/lib/cli/output.js.map

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

package/dist/src/lib/cli/pkg_runtime.d.ts

@@ -0,0 +1,2 @@
+export declare function isPkgBinaryRuntime(): boolean;
+//# sourceMappingURL=pkg_runtime.d.ts.map

package/dist/src/lib/cli/pkg_runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkg_runtime.d.ts","sourceRoot":"","sources":["../../../../src/lib/cli/pkg_runtime.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C"}

package/dist/src/lib/cli/pkg_runtime.js

@@ -0,0 +1,4 @@
+export function isPkgBinaryRuntime() {
+    return Boolean(process.pkg);
+}
+//# sourceMappingURL=pkg_runtime.js.map

package/dist/src/lib/cli/pkg_runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkg_runtime.js","sourceRoot":"","sources":["../../../../src/lib/cli/pkg_runtime.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,CAAE,OAA8C,CAAC,GAAG,CAAC,CAAC;AACtE,CAAC"}

package/dist/src/lib/cli/shell_identifiers.d.ts

@@ -0,0 +1,24 @@
+import type { AppSpec } from "../report/app.js";
+/** 进入设备 Shell 命令的标识符白名单（bundleName、ability、logKey、hitrace tag 等）。 */
+export declare const SHELL_IDENTIFIER_PATTERN: RegExp;
+/** hdc -t 目标序列号；允许 IP:port 常见字符，仍禁止 Shell 元字符。 */
+export declare const HDC_TARGET_PATTERN: RegExp;
+export declare function isShellIdentifier(value: string): boolean;
+export declare function isHdcTargetIdentifier(value: string): boolean;
+/** 校验单个进入 Shell 的标识符；空字符串跳过。 */
+export declare function assertShellIdentifier(field: string, value: string): void;
+/** 校验 `--hdc-target`；空字符串跳过。 */
+export declare function assertHdcTargetIdentifier(value: string): void;
+/** 校验 `--app` 解析结果中的 bundleName / pickerName。 */
+export declare function assertAppSpecShellIdentifiers(spec: AppSpec): void;
+/** 校验逗号分隔的 hitrace tag 列表（每项独立白名单）。 */
+export declare function assertHitraceTagsShellIdentifiers(raw: string | undefined): void;
+/** report / report-user 进入 Shell 的 CLI 字符串参数统一校验。 */
+export declare function assertReportShellIdentifiers(input: {
+    app?: string;
+    ability?: string;
+    logKey?: string;
+    hitraceTag?: string;
+    hdcTarget?: string;
+}): void;
+//# sourceMappingURL=shell_identifiers.d.ts.map

package/dist/src/lib/cli/shell_identifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell_identifiers.d.ts","sourceRoot":"","sources":["../../../../src/lib/cli/shell_identifiers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,qEAAqE;AACrE,eAAO,MAAM,wBAAwB,QAAqB,CAAC;AAE3D,kDAAkD;AAClD,eAAO,MAAM,kBAAkB,QAAuB,CAAC;AAEvD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE5D;AAcD,gCAAgC;AAChC,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQxE;AAED,gCAAgC;AAChC,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAY7D;AAED,iDAAiD;AACjD,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAKjE;AAED,uCAAuC;AACvC,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAU/E;AAED,qDAAqD;AACrD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CAWP"}

package/dist/src/lib/cli/shell_identifiers.js

@@ -0,0 +1,67 @@
+import { CliUsageError } from "./errors.js";
+/** 进入设备 Shell 命令的标识符白名单（bundleName、ability、logKey、hitrace tag 等）。 */
+export const SHELL_IDENTIFIER_PATTERN = /^[A-Za-z0-9_.]+$/;
+/** hdc -t 目标序列号；允许 IP:port 常见字符，仍禁止 Shell 元字符。 */
+export const HDC_TARGET_PATTERN = /^[A-Za-z0-9_.:-]+$/;
+export function isShellIdentifier(value) {
+    return SHELL_IDENTIFIER_PATTERN.test(value);
+}
+export function isHdcTargetIdentifier(value) {
+    return HDC_TARGET_PATTERN.test(value);
+}
+function throwInvalidIdentifier(field, value, patternLabel) {
+    throw new CliUsageError("INVALID_IDENTIFIER", `INVALID_IDENTIFIER: ${field} 含非法字符，仅允许 ${patternLabel}，实际值: ${JSON.stringify(value)}`, { field, value });
+}
+/** 校验单个进入 Shell 的标识符；空字符串跳过。 */
+export function assertShellIdentifier(field, value) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return;
+    }
+    if (!isShellIdentifier(trimmed)) {
+        throwInvalidIdentifier(field, trimmed, "字母、数字、下划线与点号");
+    }
+}
+/** 校验 `--hdc-target`；空字符串跳过。 */
+export function assertHdcTargetIdentifier(value) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return;
+    }
+    if (!isHdcTargetIdentifier(trimmed)) {
+        throwInvalidIdentifier("hdcTarget", trimmed, "字母、数字、下划线、点号、冒号与连字符");
+    }
+}
+/** 校验 `--app` 解析结果中的 bundleName / pickerName。 */
+export function assertAppSpecShellIdentifiers(spec) {
+    assertShellIdentifier("bundleName", spec.bundleName);
+    if (spec.pickerName) {
+        assertShellIdentifier("pickerName", spec.pickerName);
+    }
+}
+/** 校验逗号分隔的 hitrace tag 列表（每项独立白名单）。 */
+export function assertHitraceTagsShellIdentifiers(raw) {
+    if (!raw?.trim()) {
+        return;
+    }
+    for (const tag of raw.split(",")) {
+        const trimmed = tag.trim();
+        if (trimmed) {
+            assertShellIdentifier("hitraceTag", trimmed);
+        }
+    }
+}
+/** report / report-user 进入 Shell 的 CLI 字符串参数统一校验。 */
+export function assertReportShellIdentifiers(input) {
+    if (input.hdcTarget) {
+        assertHdcTargetIdentifier(input.hdcTarget);
+    }
+    if (input.logKey) {
+        assertShellIdentifier("logKey", input.logKey);
+    }
+    assertHitraceTagsShellIdentifiers(input.hitraceTag);
+    if (input.ability) {
+        assertShellIdentifier("ability", input.ability);
+    }
+}
+//# sourceMappingURL=shell_identifiers.js.map

package/dist/src/lib/cli/shell_identifiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell_identifiers.js","sourceRoot":"","sources":["../../../../src/lib/cli/shell_identifiers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,qEAAqE;AACrE,MAAM,CAAC,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AAE3D,kDAAkD;AAClD,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEvD,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,OAAO,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,sBAAsB,CAC7B,KAAa,EACb,KAAa,EACb,YAAoB;IAEpB,MAAM,IAAI,aAAa,CACrB,oBAAoB,EACpB,uBAAuB,KAAK,cAAc,YAAY,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EACtF,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;AACJ,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,qBAAqB,CAAC,KAAa,EAAE,KAAa;IAChE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IACD,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,sBAAsB,CACpB,WAAW,EACX,OAAO,EACP,qBAAqB,CACtB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,6BAA6B,CAAC,IAAa;IACzD,qBAAqB,CAAC,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACrD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,qBAAqB,CAAC,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,iCAAiC,CAAC,GAAuB;IACvE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC;QACjB,OAAO;IACT,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,OAAO,EAAE,CAAC;YACZ,qBAAqB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;AACH,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,4BAA4B,CAAC,KAM5C;IACC,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,yBAAyB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IACD,iCAAiC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACpD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,qBAAqB,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}

package/dist/src/lib/cli/shell_params.d.ts

@@ -0,0 +1,25 @@
+/** 解析进入 Shell 的正整数 CLI 参数（仅接受纯数字字符串，拒绝注入片段）。 */
+export declare function resolveShellPositiveInteger(field: string, raw: unknown, bounds: {
+    min: number;
+    max: number;
+}): number;
+export declare function resolveShellDurationSeconds(raw: unknown): number;
+export declare function resolveShellBufferSize(raw: unknown): number;
+/** 校验进入 Shell 或重定向的路径；空路径在 allowEmpty 时跳过。 */
+export declare function assertShellSafeCliPath(field: string, raw: string | undefined, options?: {
+    allowEmpty?: boolean;
+}): void;
+/** 嵌入 Shell 命令字符串时对参数做引用（POSIX 双引号语义，与 JSON 字符串转义一致）。 */
+export declare function quoteShellArgForCommand(arg: string): string;
+/** report 场景数值与路径参数统一校验。 */
+export declare function assertReportShellParams(input: {
+    duration?: unknown;
+    bufferSize?: unknown;
+    outputDir?: string;
+    hstackToolPath?: string;
+    sourcemapDir?: string;
+}): {
+    durationSec: number;
+    bufferSizeBytes: number;
+};
+//# sourceMappingURL=shell_params.d.ts.map

package/dist/src/lib/cli/shell_params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell_params.d.ts","sourceRoot":"","sources":["../../../../src/lib/cli/shell_params.ts"],"names":[],"mappings":"AAeA,gDAAgD;AAChD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACnC,MAAM,CAUR;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEhE;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAK3D;AAUD,8CAA8C;AAC9C,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,IAAI,CAWN;AAED,yDAAyD;AACzD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK3D;AAED,4BAA4B;AAC5B,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAOnD"}

package/dist/src/lib/cli/shell_params.js

@@ -0,0 +1,61 @@
+import { CliUsageError } from "./errors.js";
+/** 禁止出现在进入 Shell 命令的路径中的元字符（含 cmd/PowerShell 展开风险字符）。 */
+const SHELL_UNSAFE_PATH_PATTERN = /[;&|$`<>()!"%\n\r\0]/;
+const SHELL_SAFE_BARE_ARG_PATTERN = /^[A-Za-z0-9_./:@%-]+$/;
+function throwInvalidNumeric(field, value, detail) {
+    throw new CliUsageError("INVALID_NUMERIC", `INVALID_NUMERIC: ${field} ${detail}，实际值: ${JSON.stringify(value)}`, { field, value });
+}
+/** 解析进入 Shell 的正整数 CLI 参数（仅接受纯数字字符串，拒绝注入片段）。 */
+export function resolveShellPositiveInteger(field, raw, bounds) {
+    const text = typeof raw === "number" ? String(raw) : String(raw ?? "").trim();
+    if (!/^\d+$/.test(text)) {
+        throwInvalidNumeric(field, raw, "必须为整数");
+    }
+    const value = Number(text);
+    if (!Number.isInteger(value) || value < bounds.min || value > bounds.max) {
+        throwInvalidNumeric(field, raw, `必须在 ${bounds.min}..${bounds.max} 范围内`);
+    }
+    return value;
+}
+export function resolveShellDurationSeconds(raw) {
+    return resolveShellPositiveInteger("duration", raw, { min: 1, max: 86_400 });
+}
+export function resolveShellBufferSize(raw) {
+    return resolveShellPositiveInteger("bufferSize", raw, {
+        min: 1_024,
+        max: 104_857_600,
+    });
+}
+function throwInvalidPath(field, value) {
+    throw new CliUsageError("INVALID_PATH", `INVALID_PATH: ${field} 含 Shell 元字符或控制字符，实际值: ${JSON.stringify(value)}`, { field, value });
+}
+/** 校验进入 Shell 或重定向的路径；空路径在 allowEmpty 时跳过。 */
+export function assertShellSafeCliPath(field, raw, options) {
+    const trimmed = raw?.trim() ?? "";
+    if (!trimmed) {
+        if (options?.allowEmpty) {
+            return;
+        }
+        return;
+    }
+    if (SHELL_UNSAFE_PATH_PATTERN.test(trimmed)) {
+        throwInvalidPath(field, trimmed);
+    }
+}
+/** 嵌入 Shell 命令字符串时对参数做引用（POSIX 双引号语义，与 JSON 字符串转义一致）。 */
+export function quoteShellArgForCommand(arg) {
+    if (SHELL_SAFE_BARE_ARG_PATTERN.test(arg)) {
+        return arg;
+    }
+    return JSON.stringify(arg);
+}
+/** report 场景数值与路径参数统一校验。 */
+export function assertReportShellParams(input) {
+    const durationSec = resolveShellDurationSeconds(input.duration ?? "70");
+    const bufferSizeBytes = resolveShellBufferSize(input.bufferSize ?? "512000");
+    assertShellSafeCliPath("outputDir", input.outputDir, { allowEmpty: true });
+    assertShellSafeCliPath("hstackToolPath", input.hstackToolPath, { allowEmpty: true });
+    assertShellSafeCliPath("sourcemapDir", input.sourcemapDir, { allowEmpty: true });
+    return { durationSec, bufferSizeBytes };
+}
+//# sourceMappingURL=shell_params.js.map

package/dist/src/lib/cli/shell_params.js.map

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

package/dist/src/lib/cli/validation.d.ts

@@ -0,0 +1,8 @@
+export type ReportCommandSuiteVariant = "full" | "user";
+/** report / report-user 要求非空 `--app`。 */
+export declare function assertReportAppProvided(variant: ReportCommandSuiteVariant, app: string): void;
+/** report-user 在提供 `--app` 后要求 `--ability`。 */
+export declare function assertReportUserAbilityProvided(variant: ReportCommandSuiteVariant, ability: string): void;
+/** 显式 `--group` 含未知名称时失败；未指定 group 时使用 defaultOrder，不报错。 */
+export declare function assertKnownCommandGroups(groupRaw: unknown, defaultGroupOrder: readonly string[]): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/src/lib/cli/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/lib/cli/validation.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG,MAAM,CAAC;AAMxD,yCAAyC;AACzC,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,yBAAyB,EAClC,GAAG,EAAE,MAAM,GACV,IAAI,CAcN;AAED,+CAA+C;AAC/C,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,yBAAyB,EAClC,OAAO,EAAE,MAAM,GACd,IAAI,CAWN;AAED,4DAA4D;AAC5D,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,OAAO,EACjB,iBAAiB,EAAE,SAAS,MAAM,EAAE,GACnC,IAAI,CAoBN"}

package/dist/src/lib/cli/validation.js

@@ -0,0 +1,44 @@
+import { normalizeGroupCliArg, parseGroupSpecs } from "hmcommand-runner";
+import { CliUsageError } from "./errors.js";
+import { SNAPSHOT_CHECKER_CLI_NAME } from "./version.js";
+function commandSuiteCommandName(variant) {
+    return variant === "user" ? "report-user" : "report";
+}
+/** report / report-user 要求非空 `--app`。 */
+export function assertReportAppProvided(variant, app) {
+    if (app.trim()) {
+        return;
+    }
+    const command = commandSuiteCommandName(variant);
+    const example = variant === "user"
+        ? `${SNAPSHOT_CHECKER_CLI_NAME} ${command} --dry-run --app com.example.app --ability EntryAbility`
+        : `${SNAPSHOT_CHECKER_CLI_NAME} ${command} --dry-run --app com.example.app`;
+    throw new CliUsageError("ERROR_MISSING_APP", `ERROR_MISSING_APP: ${command} requires --app <bundle_name>.\nExample: ${example}`, { example });
+}
+/** report-user 在提供 `--app` 后要求 `--ability`。 */
+export function assertReportUserAbilityProvided(variant, ability) {
+    if (variant !== "user" || ability.trim()) {
+        return;
+    }
+    throw new CliUsageError("ERROR_MISSING_ABILITY", `ERROR_MISSING_ABILITY: report-user requires --ability <ability_name>.\nExample: ${SNAPSHOT_CHECKER_CLI_NAME} report-user --dry-run --app com.example.app --ability EntryAbility`, {
+        example: `${SNAPSHOT_CHECKER_CLI_NAME} report-user --dry-run --app com.example.app --ability EntryAbility`,
+    });
+}
+/** 显式 `--group` 含未知名称时失败；未指定 group 时使用 defaultOrder，不报错。 */
+export function assertKnownCommandGroups(groupRaw, defaultGroupOrder) {
+    const groupSpecs = normalizeGroupCliArg(groupRaw);
+    if (groupSpecs === undefined) {
+        return;
+    }
+    const available = new Set(defaultGroupOrder);
+    const specs = parseGroupSpecs(groupSpecs, [...defaultGroupOrder]);
+    const unknownGroups = specs
+        .map((spec) => spec.name)
+        .filter((name) => !available.has(name));
+    if (unknownGroups.length === 0) {
+        return;
+    }
+    const label = unknownGroups.length === 1 ? unknownGroups[0] : unknownGroups.join(", ");
+    throw new CliUsageError("UNKNOWN_GROUP", `UNKNOWN_GROUP: Group '${label}' does not exist.\nAvailable groups: ${defaultGroupOrder.join(", ")}`, { available_groups: [...defaultGroupOrder] });
+}
+//# sourceMappingURL=validation.js.map

package/dist/src/lib/cli/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../src/lib/cli/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAIzD,SAAS,uBAAuB,CAAC,OAAkC;IACjE,OAAO,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvD,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,uBAAuB,CACrC,OAAkC,EAClC,GAAW;IAEX,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QACf,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,OAAO,GACX,OAAO,KAAK,MAAM;QAChB,CAAC,CAAC,GAAG,yBAAyB,IAAI,OAAO,yDAAyD;QAClG,CAAC,CAAC,GAAG,yBAAyB,IAAI,OAAO,kCAAkC,CAAC;IAChF,MAAM,IAAI,aAAa,CACrB,mBAAmB,EACnB,sBAAsB,OAAO,4CAA4C,OAAO,EAAE,EAClF,EAAE,OAAO,EAAE,CACZ,CAAC;AACJ,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,+BAA+B,CAC7C,OAAkC,EAClC,OAAe;IAEf,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACzC,OAAO;IACT,CAAC;IACD,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,mFAAmF,yBAAyB,qEAAqE,EACjL;QACE,OAAO,EAAE,GAAG,yBAAyB,qEAAqE;KAC3G,CACF,CAAC;AACJ,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,wBAAwB,CACtC,QAAiB,EACjB,iBAAoC;IAEpC,MAAM,UAAU,GAAG,oBAAoB,CAAC,QAAyC,CAAC,CAAC;IACnF,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO;IACT,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,EAAE,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC;IAClE,MAAM,aAAa,GAAG,KAAK;SACxB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACxB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1C,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GACT,aAAa,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5E,MAAM,IAAI,aAAa,CACrB,eAAe,EACf,yBAAyB,KAAK,wCAAwC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACpG,EAAE,gBAAgB,EAAE,CAAC,GAAG,iBAAiB,CAAC,EAAE,CAC7C,CAAC;AACJ,CAAC"}

package/dist/src/lib/{version.d.ts → cli/version.d.ts}

@@ -1,7 +1,11 @@
+/** 对外 CLI 命令名（保持稳定）。 */
+export declare const SNAPSHOT_CHECKER_CLI_NAME = "snapshot-checker";
+/** 对外 npm 包名（保持稳定）。 */
+export declare const SNAPSHOT_CHECKER_PACKAGE_NAME = "snapshot-checker";
 /** 从磁盘向上查找本包 `package.json`（`name === snapshot-checker`）。 */
-export declare function readSnapshotCheckerVersion(): string;
+export declare function readHyperStartUpCheckerVersion(): string;
 /**
- * 将当前进程 argv 格式化为可复现的 CLI 命令行；识别本工具入口时以 `snapshot-checker` 展示。
+ * 将当前进程 argv 格式化为可复现的 CLI 命令行；识别本工具入口时以 {@link SNAPSHOT_CHECKER_CLI_NAME} 展示。
  */
 export declare function formatInvocationCommandLine(argv?: readonly string[]): string;
 /** checker.log 会话首行：`[snapshot-checker <version>] <command>` */

package/dist/src/lib/cli/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../../src/lib/cli/version.ts"],"names":[],"mappings":"AAOA,wBAAwB;AACxB,eAAO,MAAM,yBAAyB,qBAAqB,CAAC;AAE5D,uBAAuB;AACvB,eAAO,MAAM,6BAA6B,qBAAqB,CAAC;AAEhE,6DAA6D;AAC7D,wBAAgB,8BAA8B,IAAI,MAAM,CA8BvD;AAoBD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,GAAE,SAAS,MAAM,EAAiB,GACrC,MAAM,CAUR;AAED,gEAAgE;AAChE,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAET"}