@actiondock/cli 2.0.12 → 2.2.1

package/dist/commands/validate.js

@@ -0,0 +1,106 @@
+import { checkGeneratedTypes, findProjectRoot, GENERATED_TYPES_OUTDATED_CODE, loadActions, loadProjectConfig, resolvePackageRoot, } from "@actiondock/core";
+import { ArgumentError, ExecutionError } from "../errors.js";
+import { renderActionValidation, renderResult } from "../renderer.js";
+import { getEffectiveOptions } from "../utils/index.js";
+/**
+ * 注册顶层统一 validate 命令：校验 Action 的 Schema 与方法定义完整性。
+ *
+ * @param program Commander 根程序对象
+ * @param context 命令行上下文
+ */
+export function registerValidateCommand(program, context) {
+    program
+        .command("validate [id]")
+        .description("Validate action schemas and definitions")
+        .option("-P, --package <id>", "Target package ID or path")
+        .option("--json", "Output as JSON")
+        .option("--envelope", "Wrap JSON output in standard envelope")
+        .option("--data-dir <path>", "Custom database storage directory")
+        .action(async (id, rawOptions, cmd) => {
+        const options = getEffectiveOptions(rawOptions, cmd);
+        let root = null;
+        if (options.package) {
+            root = resolvePackageRoot(options.package);
+            if (!root) {
+                throw new ArgumentError(`Package '${options.package}' not found in linked packages or path`);
+            }
+        }
+        else {
+            root = findProjectRoot();
+        }
+        if (!root) {
+            throw new ArgumentError("Not in an ActionDock project (actiondock.json not found).\nPlease specify -P, --package <id> or cd into a project directory.");
+        }
+        const config = loadProjectConfig(root);
+        const actions = await loadActions(root, config.actionsDir);
+        let toValidate = [];
+        if (id) {
+            const act = actions.get(id);
+            if (!act) {
+                throw new ArgumentError(`Action '${id}' not found in project '${config.id}'`);
+            }
+            toValidate = [{ id, act, spec: config.actions?.[id] }];
+        }
+        else {
+            toValidate = Array.from(actions.entries()).map(([actId, act]) => ({
+                id: actId,
+                act,
+                spec: config.actions?.[actId],
+            }));
+        }
+        const results = [];
+        for (const item of toValidate) {
+            const errors = [];
+            if (!item.id)
+                errors.push("Missing id property");
+            if (!item.act?.run || typeof item.act.run !== "function")
+                errors.push("Missing run method");
+            const inSchema = item.spec?.inputSchema ?? item.act.inputSchema;
+            if (inSchema && typeof inSchema !== "object") {
+                errors.push("Invalid inputSchema object");
+            }
+            const outSchema = item.spec?.outputSchema ?? item.act.outputSchema;
+            if (outSchema && typeof outSchema !== "object") {
+                errors.push("Invalid outputSchema object");
+            }
+            results.push({
+                id: item.id,
+                valid: errors.length === 0,
+                errors,
+            });
+        }
+        const allValid = results.every((r) => r.valid);
+        const validationPayload = { valid: allValid, results };
+        renderResult(validationPayload, {
+            json: options.json,
+            envelope: options.envelope,
+            humanFormatter: () => renderActionValidation(results),
+            context,
+        });
+        if (!allValid) {
+            process.exitCode = 1;
+            return;
+        }
+        // 校验 Action 本地相对依赖完整性
+        try {
+            const { SelectionPlanner } = await import("@actiondock/builder");
+            SelectionPlanner.plan({ projectRoot: root, actions: id ? [id] : undefined });
+        }
+        catch (err) {
+            if (err?.code === "UNMET_LOCAL_DEPENDENCY" ||
+                err?.code === "EXTERNAL_LOCAL_DEPENDENCY" ||
+                err?.code === "FILE_NOT_FOUND") {
+                throw new ExecutionError(`Action dependency integrity validation failed:\n${err.message}`, undefined, err.code);
+            }
+            throw err;
+        }
+        // 只读校验已生成的类型文件摘要是否过期
+        const typeCheck = checkGeneratedTypes(root);
+        if (typeCheck.exists && typeCheck.outdated) {
+            throw new ExecutionError(`Generated types in ${typeCheck.filePath} are outdated. Expected manifest digest '${typeCheck.expectedDigest}', but got '${typeCheck.actualDigest || "none"}'. Run 'ad generate types' to update.`, {
+                expectedDigest: typeCheck.expectedDigest,
+                actualDigest: typeCheck.actualDigest,
+            }, GENERATED_TYPES_OUTDATED_CODE);
+        }
+    });
+}

package/dist/errors.d.ts

@@ -0,0 +1,43 @@
+import { type ExitCodeValue } from "./types.js";
+/**
+ * 命令行标准错误基类。
+ */
+export declare class CliError extends Error {
+    readonly exitCode: ExitCodeValue;
+    readonly code: string;
+    readonly details?: unknown;
+    constructor(message: string, exitCode?: ExitCodeValue, code?: string, details?: unknown);
+}
+/**
+ * 命令行参数与选项校验错误（退出码为 2）。
+ */
+export declare class ArgumentError extends CliError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * 业务逻辑或框架执行失败错误（退出码为 1）。
+ */
+export declare class ExecutionError extends CliError {
+    constructor(message: string, details?: unknown, code?: string);
+}
+/**
+ * 用户中断信号错误（退出码为 130）。
+ */
+export declare class SigintError extends CliError {
+    constructor(message?: string);
+}
+/**
+ * 标准化错误信息解析结果。
+ */
+export interface FormattedError {
+    code: string;
+    message: string;
+    exitCode: ExitCodeValue;
+    details?: unknown;
+}
+/**
+ * 解析并格式化任意异常为结构化错误对象。
+ *
+ * @param err 待解析的异常对象
+ */
+export declare function formatError(err: unknown): FormattedError;

package/dist/errors.js

@@ -0,0 +1,103 @@
+import { ExitCode } from "./types.js";
+/**
+ * CLI 信封错误码常量（仅 CLI 输出协议使用，属包内部码，就地常量化管理）。
+ */
+const CLI_CODE_SUCCESS = "SUCCESS";
+const CLI_CODE_INVALID_ARGUMENT = "INVALID_ARGUMENT";
+const CLI_CODE_ERROR = "ERROR";
+const CLI_CODE_UNKNOWN_ERROR = "UNKNOWN_ERROR";
+/**
+ * 命令行标准错误基类。
+ */
+export class CliError extends Error {
+    exitCode;
+    code;
+    details;
+    constructor(message, exitCode = ExitCode.FAILURE, code = "CLI_ERROR", details) {
+        super(message);
+        this.name = "CliError";
+        this.exitCode = exitCode;
+        this.code = code;
+        this.details = details;
+    }
+}
+/**
+ * 命令行参数与选项校验错误（退出码为 2）。
+ */
+export class ArgumentError extends CliError {
+    constructor(message, details) {
+        super(message, ExitCode.INVALID_ARGUMENT, "INVALID_ARGUMENT", details);
+        this.name = "ArgumentError";
+    }
+}
+/**
+ * 业务逻辑或框架执行失败错误（退出码为 1）。
+ */
+export class ExecutionError extends CliError {
+    constructor(message, details, code = "EXECUTION_FAILURE") {
+        super(message, ExitCode.FAILURE, code, details);
+        this.name = "ExecutionError";
+    }
+}
+/**
+ * 用户中断信号错误（退出码为 130）。
+ */
+export class SigintError extends CliError {
+    constructor(message = "Interrupted by SIGINT") {
+        super(message, ExitCode.SIGINT, "SIGINT_INTERRUPTED");
+        this.name = "SigintError";
+    }
+}
+/**
+ * 解析并格式化任意异常为结构化错误对象。
+ *
+ * @param err 待解析的异常对象
+ */
+export function formatError(err) {
+    if (err instanceof CliError) {
+        return {
+            code: err.code,
+            message: err.message,
+            exitCode: err.exitCode,
+            details: err.details,
+        };
+    }
+    // Commander.js 原生错误处理
+    if (typeof err === "object" && err !== null && "code" in err && typeof err.code === "string") {
+        const commanderErr = err;
+        const code = commanderErr.code;
+        // 参数类异常
+        if (code.startsWith("commander.unknownOption") ||
+            code.startsWith("commander.missingArgument") ||
+            code.startsWith("commander.missingMandatoryOptionValue") ||
+            code.startsWith("commander.optionMissingArgument") ||
+            code.startsWith("commander.invalidArgument") ||
+            code.startsWith("commander.excessArguments")) {
+            return {
+                code: CLI_CODE_INVALID_ARGUMENT,
+                message: commanderErr.message,
+                exitCode: ExitCode.INVALID_ARGUMENT,
+            };
+        }
+        // 正常退出（如 --help 或 --version）
+        if (code === "commander.helpDisplayed" || code === "commander.version") {
+            return {
+                code: CLI_CODE_SUCCESS,
+                message: commanderErr.message,
+                exitCode: ExitCode.SUCCESS,
+            };
+        }
+    }
+    if (err instanceof Error) {
+        return {
+            code: CLI_CODE_ERROR,
+            message: err.message,
+            exitCode: ExitCode.FAILURE,
+        };
+    }
+    return {
+        code: CLI_CODE_UNKNOWN_ERROR,
+        message: String(err),
+        exitCode: ExitCode.FAILURE,
+    };
+}

package/dist/index.d.ts

@@ -1,4 +1,11 @@
-export * from "./commands";
+export * from "./types.js";
+export * from "./errors.js";
+export * from "./renderer.js";
+export * from "./prompt.js";
+export * from "./standalone/index.js";
+export * from "./utils/index.js";
+export * from "./services/index.js";
+export * from "./commands/index.js";
 /**
  * ActionDock CLI 主执行入口函数。
  *