listpage_cli 0.0.293 → 0.0.295

package/bin/services/build-project-service.js

@@ -0,0 +1,190 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runBuildProjectFlow = runBuildProjectFlow;
+const command_result_1 = require("../domain/command-result");
+const config_loader_1 = require("./config-loader");
+const command_runner_1 = require("./command-runner");
+const node_path_1 = __importDefault(require("node:path"));
+const node_fs_1 = require("node:fs");
+const CONFIG_ERROR_CODE_MAP = {
+    CONFIG_NOT_FOUND: "E_CONFIG_NOT_FOUND",
+    CONFIG_READ_FAILED: "E_CONFIG_READ_FAILED",
+    CONFIG_INVALID_JSON: "E_CONFIG_INVALID_JSON",
+    CONFIG_REQUIRED_FIELD_MISSING: "E_CONFIG_REQUIRED_FIELD_MISSING",
+};
+async function runBuildProjectFlow(deps) {
+    const projectRoot = deps.fs.cwd();
+    const configPath = (0, config_loader_1.getDefaultConfigPath)(projectRoot, deps.fs.join);
+    let configResult;
+    try {
+        configResult = (0, config_loader_1.loadProjectConfig)({
+            readText: deps.fs.readText,
+        }, configPath);
+    }
+    catch (error) {
+        if (error instanceof config_loader_1.ConfigLoaderError) {
+            return (0, command_result_1.commandError)(error.message, CONFIG_ERROR_CODE_MAP[error.code], 1);
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        return (0, command_result_1.commandError)(message, command_result_1.COMMAND_ERROR_CODES.invalidPath, 1);
+    }
+    if (deps.executeBuild) {
+        try {
+            const result = await deps.executeBuild({
+                projectRoot,
+                configPath: configResult.configPath,
+                config: configResult.config,
+            });
+            return normalizeBuildResult(result);
+        }
+        catch (error) {
+            return (0, command_result_1.commandError)(formatExecuteBuildThrownError(error), command_result_1.COMMAND_ERROR_CODES.executionFailed, getNonZeroExitCode(error));
+        }
+    }
+    const commandRunner = (0, command_runner_1.createCommandRunner)();
+    const buildConfig = toBuildProjectConfig(configResult.config);
+    const buildTargets = getBuildTargets(projectRoot, buildConfig);
+    try {
+        for (const target of buildTargets) {
+            const output = await commandRunner({
+                command: "npm",
+                args: ["run", "build"],
+                cwd: target.projectDir,
+            });
+            if (output.exitCode !== 0) {
+                return (0, command_result_1.commandError)(`[${command_runner_1.COMMAND_RUNNER_STAGE}] 构建命令执行失败: npm run build (cwd=${target.projectDir}, exit=${output.exitCode})`, command_result_1.COMMAND_ERROR_CODES.executionFailed, output.exitCode);
+            }
+        }
+        copyBuildArtifacts(projectRoot, buildTargets);
+        copyConfiguredFiles(projectRoot, buildConfig.copyFiles);
+        return (0, command_result_1.commandOk)();
+    }
+    catch (error) {
+        if (error instanceof command_runner_1.ExecutionError) {
+            return (0, command_result_1.commandError)(error.message, command_result_1.COMMAND_ERROR_CODES.executionFailed, error.exitCode);
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        return (0, command_result_1.commandError)(`[${command_runner_1.COMMAND_RUNNER_STAGE}] 构建命令执行异常: npm run build (${message})`, command_result_1.COMMAND_ERROR_CODES.executionFailed, 1);
+    }
+}
+function getBuildTargets(projectRoot, config) {
+    return [...config.frontend, config.backend].map((item) => ({
+        ...item,
+        projectDir: resolveBuildTarget(projectRoot, item.projectDir),
+    }));
+}
+function toBuildProjectConfig(config) {
+    const frontendRaw = config.frontend;
+    const backendRaw = config.backend;
+    return {
+        frontend: frontendRaw.map((item) => toBuildTarget(item)),
+        backend: toBuildTarget(backendRaw),
+        copyFiles: toCopySpecs(config.copyFiles),
+    };
+}
+function toBuildTarget(item) {
+    const projectDir = asRequiredString(item.projectDir, "projectDir");
+    const packageSubDir = asRequiredString(item.packageSubDir, "packageSubDir");
+    const buildArtifactDirName = asOptionalString(item.buildArtifactDirName, "dist");
+    const artifactAlias = asOptionalString(item.artifactAlias, "dist");
+    return {
+        projectDir,
+        packageSubDir,
+        buildArtifactDirName,
+        artifactAlias,
+    };
+}
+function asRequiredString(value, fieldName) {
+    if (typeof value === "string" && value.trim() !== "") {
+        return value.trim();
+    }
+    throw new Error(`配置字段无效: ${fieldName}`);
+}
+function asOptionalString(value, fallback) {
+    if (typeof value !== "string") {
+        return fallback;
+    }
+    const normalized = value.trim();
+    return normalized === "" ? fallback : normalized;
+}
+function resolveBuildTarget(projectRoot, projectDir) {
+    return node_path_1.default.isAbsolute(projectDir)
+        ? projectDir
+        : node_path_1.default.resolve(projectRoot, projectDir);
+}
+function toCopySpecs(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.map((item, index) => toCopySpec(item, index));
+}
+function toCopySpec(item, index) {
+    if (!item || typeof item !== "object" || Array.isArray(item)) {
+        throw new Error(`配置字段无效: copyFiles[${index}]`);
+    }
+    const source = asRequiredString(item.source, `copyFiles[${index}].source`);
+    const dest = asRequiredString(item.dest, `copyFiles[${index}].dest`);
+    return { source, dest };
+}
+function copyBuildArtifacts(projectRoot, targets) {
+    for (const target of targets) {
+        const sourceDir = node_path_1.default.resolve(target.projectDir, target.buildArtifactDirName);
+        if (!(0, node_fs_1.existsSync)(sourceDir)) {
+            throw new Error(`[${command_runner_1.COMMAND_RUNNER_STAGE}] 构建产物不存在: ${sourceDir}`);
+        }
+        const targetDir = node_path_1.default.resolve(projectRoot, ".listpage", "output", target.packageSubDir, target.artifactAlias);
+        if ((0, node_fs_1.existsSync)(targetDir)) {
+            (0, node_fs_1.rmSync)(targetDir, { recursive: true, force: true });
+        }
+        (0, node_fs_1.mkdirSync)(node_path_1.default.dirname(targetDir), { recursive: true });
+        (0, node_fs_1.cpSync)(sourceDir, targetDir, { recursive: true });
+    }
+}
+function copyConfiguredFiles(projectRoot, copySpecs) {
+    for (const spec of copySpecs) {
+        const sourcePath = node_path_1.default.resolve(projectRoot, spec.source);
+        if (!(0, node_fs_1.existsSync)(sourcePath)) {
+            throw new Error(`[${command_runner_1.COMMAND_RUNNER_STAGE}] 复制源不存在: ${sourcePath}`);
+        }
+        const targetPath = node_path_1.default.resolve(projectRoot, ".listpage", "output", spec.dest);
+        if ((0, node_fs_1.existsSync)(targetPath)) {
+            (0, node_fs_1.rmSync)(targetPath, { recursive: true, force: true });
+        }
+        (0, node_fs_1.mkdirSync)(node_path_1.default.dirname(targetPath), { recursive: true });
+        const sourceIsDirectory = (0, node_fs_1.statSync)(sourcePath).isDirectory();
+        (0, node_fs_1.cpSync)(sourcePath, targetPath, { recursive: sourceIsDirectory });
+    }
+}
+function normalizeBuildResult(result) {
+    if (result.ok) {
+        if (result.exitCode === 0) {
+            return result;
+        }
+        return (0, command_result_1.commandError)(`[${command_runner_1.COMMAND_RUNNER_STAGE}] 构建命令执行失败: 执行器返回成功但退出码非零 (exit=${result.exitCode})`, command_result_1.COMMAND_ERROR_CODES.executionFailed, result.exitCode);
+    }
+    if (result.exitCode !== 0) {
+        return result;
+    }
+    return (0, command_result_1.commandError)(result.message ??
+        `[${command_runner_1.COMMAND_RUNNER_STAGE}] 构建命令执行失败: 执行器返回失败但退出码为 0`, result.errorCode ?? command_result_1.COMMAND_ERROR_CODES.executionFailed, 1);
+}
+function formatExecuteBuildThrownError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return `[${command_runner_1.COMMAND_RUNNER_STAGE}] 构建命令执行异常: ${message}`;
+}
+function getNonZeroExitCode(error) {
+    if (!error || typeof error !== "object") {
+        return 1;
+    }
+    const candidate = error;
+    if (typeof candidate.exitCode === "number" && candidate.exitCode !== 0) {
+        return candidate.exitCode;
+    }
+    if (typeof candidate.status === "number" && candidate.status !== 0) {
+        return candidate.status;
+    }
+    return 1;
+}

package/bin/services/command-runner.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecutionError = exports.COMMAND_RUNNER_STAGE = void 0;
+exports.createCommandRunner = createCommandRunner;
+const node_child_process_1 = require("node:child_process");
+exports.COMMAND_RUNNER_STAGE = "build";
+class ExecutionError extends Error {
+    constructor(code, stage, command, exitCode, message) {
+        super(message);
+        this.name = "ExecutionError";
+        this.code = code;
+        this.stage = stage;
+        this.command = command;
+        this.exitCode = exitCode;
+    }
+}
+exports.ExecutionError = ExecutionError;
+function createCommandRunner(deps) {
+    const spawnSyncImpl = deps?.spawnSyncImpl ?? node_child_process_1.spawnSync;
+    const stage = deps?.stage ?? exports.COMMAND_RUNNER_STAGE;
+    return async (input) => {
+        const args = input.args ?? [];
+        const output = spawnSyncImpl(input.command, args, {
+            cwd: input.cwd,
+            env: {
+                ...process.env,
+                ...input.env,
+            },
+            shell: true,
+            stdio: "inherit",
+        });
+        if (output.error) {
+            const maybeNodeError = output.error;
+            const isNotFound = maybeNodeError.code === "ENOENT";
+            const code = isNotFound
+                ? "COMMAND_NOT_FOUND"
+                : "COMMAND_EXECUTION_FAILED";
+            const messagePrefix = isNotFound ? "命令不存在" : "命令执行异常";
+            throw new ExecutionError(code, stage, input.command, 1, `[${stage}][${code}] ${messagePrefix}: ${input.command} (${output.error.message})`);
+        }
+        return {
+            exitCode: output.status ?? 1,
+        };
+    };
+}

package/bin/services/config-loader.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigLoaderError = exports.CONFIG_LOADER_STAGE = void 0;
+exports.getDefaultConfigPath = getDefaultConfigPath;
+exports.loadProjectConfig = loadProjectConfig;
+exports.CONFIG_LOADER_STAGE = "config";
+const DEFAULT_CONFIG_NAME = "listpage.config.json";
+const REQUIRED_CONFIG_FIELDS = ["backend.projectDir", "backend.packageSubDir"];
+class ConfigLoaderError extends Error {
+    constructor(code, configPath, message) {
+        super(message);
+        this.stage = exports.CONFIG_LOADER_STAGE;
+        this.name = "ConfigLoaderError";
+        this.code = code;
+        this.configPath = configPath;
+    }
+}
+exports.ConfigLoaderError = ConfigLoaderError;
+function getDefaultConfigPath(projectRoot, join) {
+    return join(projectRoot, DEFAULT_CONFIG_NAME);
+}
+function loadProjectConfig(reader, configPath) {
+    const raw = readConfigText(reader, configPath);
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new ConfigLoaderError("CONFIG_INVALID_JSON", configPath, `[${exports.CONFIG_LOADER_STAGE}][CONFIG_INVALID_JSON] 无法解析配置文件: ${configPath} (${reason})`);
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new ConfigLoaderError("CONFIG_INVALID_JSON", configPath, `[${exports.CONFIG_LOADER_STAGE}][CONFIG_INVALID_JSON] 配置文件顶层必须是对象: ${configPath}`);
+    }
+    const config = parsed;
+    validateRequiredFields(config, configPath);
+    return {
+        configPath,
+        config,
+    };
+}
+function readConfigText(reader, configPath) {
+    try {
+        return reader.readText(configPath);
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        const maybeNodeError = error;
+        const isNotFound = maybeNodeError?.code === "ENOENT";
+        const errorCode = isNotFound
+            ? "CONFIG_NOT_FOUND"
+            : "CONFIG_READ_FAILED";
+        const errorLabel = isNotFound ? "找不到配置文件" : "读取配置文件失败";
+        throw new ConfigLoaderError(errorCode, configPath, `[${exports.CONFIG_LOADER_STAGE}][${errorCode}] 无效项目上下文，${errorLabel}: ${configPath} (${reason})`);
+    }
+}
+function validateRequiredFields(config, configPath) {
+    const frontend = config.frontend;
+    if (!Array.isArray(frontend) || frontend.length === 0) {
+        throw new ConfigLoaderError("CONFIG_REQUIRED_FIELD_MISSING", configPath, `[${exports.CONFIG_LOADER_STAGE}][CONFIG_REQUIRED_FIELD_MISSING] 配置缺少必填字段: frontend (至少包含一个构建项)`);
+    }
+    frontend.forEach((item, index) => {
+        const projectDir = getNestedString({ frontend: item }, "frontend.projectDir");
+        if (!projectDir) {
+            throw new ConfigLoaderError("CONFIG_REQUIRED_FIELD_MISSING", configPath, `[${exports.CONFIG_LOADER_STAGE}][CONFIG_REQUIRED_FIELD_MISSING] 配置缺少必填字段: frontend[${index}].projectDir`);
+        }
+        const packageSubDir = getNestedString({ frontend: item }, "frontend.packageSubDir");
+        if (!packageSubDir) {
+            throw new ConfigLoaderError("CONFIG_REQUIRED_FIELD_MISSING", configPath, `[${exports.CONFIG_LOADER_STAGE}][CONFIG_REQUIRED_FIELD_MISSING] 配置缺少必填字段: frontend[${index}].packageSubDir`);
+        }
+    });
+    for (const field of REQUIRED_CONFIG_FIELDS) {
+        const value = getNestedString(config, field);
+        if (!value) {
+            throw new ConfigLoaderError("CONFIG_REQUIRED_FIELD_MISSING", configPath, `[${exports.CONFIG_LOADER_STAGE}][CONFIG_REQUIRED_FIELD_MISSING] 配置缺少必填字段: ${field}`);
+        }
+    }
+    validateCopyFiles(config, configPath);
+}
+function validateCopyFiles(config, configPath) {
+    const copyFiles = config.copyFiles;
+    if (copyFiles === undefined) {
+        return;
+    }
+    if (!Array.isArray(copyFiles)) {
+        throw new ConfigLoaderError("CONFIG_REQUIRED_FIELD_MISSING", configPath, `[${exports.CONFIG_LOADER_STAGE}][CONFIG_REQUIRED_FIELD_MISSING] 配置缺少必填字段: copyFiles (必须为数组)`);
+    }
+    copyFiles.forEach((item, index) => {
+        const source = getNestedString({ item }, "item.source");
+        if (!source) {
+            throw new ConfigLoaderError("CONFIG_REQUIRED_FIELD_MISSING", configPath, `[${exports.CONFIG_LOADER_STAGE}][CONFIG_REQUIRED_FIELD_MISSING] 配置缺少必填字段: copyFiles[${index}].source`);
+        }
+        const dest = getNestedString({ item }, "item.dest");
+        if (!dest) {
+            throw new ConfigLoaderError("CONFIG_REQUIRED_FIELD_MISSING", configPath, `[${exports.CONFIG_LOADER_STAGE}][CONFIG_REQUIRED_FIELD_MISSING] 配置缺少必填字段: copyFiles[${index}].dest`);
+        }
+    });
+}
+function getNestedString(source, dottedPath) {
+    const nodes = dottedPath.split(".");
+    let current = source;
+    for (const node of nodes) {
+        if (!current || typeof current !== "object" || Array.isArray(current)) {
+            return undefined;
+        }
+        current = current[node];
+    }
+    if (typeof current !== "string") {
+        return undefined;
+    }
+    const normalized = current.trim();
+    return normalized === "" ? undefined : normalized;
+}

package/bin/services/deploy-project-service.js

@@ -0,0 +1,237 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDeployProjectFlow = runDeployProjectFlow;
+const command_result_1 = require("../domain/command-result");
+const config_loader_1 = require("./config-loader");
+const command_runner_1 = require("./command-runner");
+const artifact_validator_1 = require("./artifact-validator");
+const DEPLOY_STAGE = "deploy";
+const ARTIFACT_STAGE = "artifact";
+const CONFIG_ERROR_CODE_MAP = {
+    CONFIG_NOT_FOUND: "E_CONFIG_NOT_FOUND",
+    CONFIG_READ_FAILED: "E_CONFIG_READ_FAILED",
+    CONFIG_INVALID_JSON: "E_CONFIG_INVALID_JSON",
+    CONFIG_REQUIRED_FIELD_MISSING: "E_CONFIG_REQUIRED_FIELD_MISSING",
+};
+async function runDeployProjectFlow(deps) {
+    const projectRoot = deps.fs.cwd();
+    const configPath = (0, config_loader_1.getDefaultConfigPath)(projectRoot, deps.fs.join);
+    let configResult;
+    try {
+        configResult = (0, config_loader_1.loadProjectConfig)({
+            readText: deps.fs.readText,
+        }, configPath);
+    }
+    catch (error) {
+        if (error instanceof config_loader_1.ConfigLoaderError) {
+            return (0, command_result_1.commandError)(error.message, CONFIG_ERROR_CODE_MAP[error.code], 1);
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        return (0, command_result_1.commandError)(message, command_result_1.COMMAND_ERROR_CODES.invalidPath, 1);
+    }
+    let executionInput;
+    try {
+        executionInput = parseDeployInput(projectRoot, configResult.config, deps.fs.resolve);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return (0, command_result_1.commandError)(`[${DEPLOY_STAGE}] 部署配置无效: ${message}`, "E_CONFIG_REQUIRED_FIELD_MISSING", 1);
+    }
+    const validator = (0, artifact_validator_1.createArtifactValidator)({
+        resolve: deps.fs.resolve,
+        exists: deps.fs.exists,
+        isDirectory: deps.fs.isDirectory,
+        readDir: deps.fs.readDir,
+    });
+    const validationResult = validator({
+        outputDir: executionInput.outputDir,
+        requiredRelativePaths: collectRequiredArtifacts(configResult.config),
+    });
+    if (!validationResult.ok) {
+        const message = validationResult.issues.map((issue) => issue.message).join("; ");
+        return (0, command_result_1.commandError)(message, command_result_1.COMMAND_ERROR_CODES.executionFailed, 1);
+    }
+    if (deps.executeDeploy) {
+        try {
+            const result = await deps.executeDeploy({
+                projectRoot,
+                configPath: configResult.configPath,
+                config: configResult.config,
+                outputDir: executionInput.outputDir,
+                remoteImage: executionInput.remoteImage,
+                docker: executionInput.docker,
+            });
+            return normalizeDeployResult(result);
+        }
+        catch (error) {
+            return (0, command_result_1.commandError)(formatDeployThrownError(error), command_result_1.COMMAND_ERROR_CODES.executionFailed, getNonZeroExitCode(error));
+        }
+    }
+    const commandRunner = deps.createRunner
+        ? deps.createRunner()
+        : (0, command_runner_1.createCommandRunner)({ stage: DEPLOY_STAGE });
+    return runDockerDeploy(commandRunner, executionInput);
+}
+function parseDeployInput(projectRoot, config, resolve) {
+    const dockerRaw = asObject(config.docker, "docker");
+    const registry = asObject(dockerRaw.registry, "docker.registry");
+    const build = asOptionalObject(dockerRaw.build);
+    const imageName = asRequiredString(dockerRaw.imageName ?? dockerRaw.appName, "docker.imageName/appName");
+    const imageTag = asRequiredString(dockerRaw.imageTag, "docker.imageTag");
+    const registryUrl = asRequiredString(registry.url, "docker.registry.url");
+    const registryNamespace = asRequiredString(registry.namespace, "docker.registry.namespace");
+    const username = asRequiredString(registry.username, "docker.registry.username");
+    const password = asOptionalString(registry.password);
+    const platform = asOptionalString(build?.platform);
+    const outputDir = resolve(projectRoot, ".listpage", "output");
+    return {
+        outputDir,
+        remoteImage: `${registryUrl}/${registryNamespace}/${imageName}:${imageTag}`,
+        docker: {
+            imageName,
+            imageTag,
+            registryUrl,
+            registryNamespace,
+            username,
+            password,
+            platform,
+        },
+    };
+}
+function collectRequiredArtifacts(config) {
+    const required = new Set(["Dockerfile"]);
+    const frontend = config.frontend;
+    if (Array.isArray(frontend)) {
+        for (const item of frontend) {
+            if (!item || typeof item !== "object" || Array.isArray(item)) {
+                continue;
+            }
+            const record = item;
+            const packageSubDir = asOptionalString(record.packageSubDir) ?? "public";
+            const artifactAlias = asOptionalString(record.artifactAlias) ?? "dist";
+            required.add(`${packageSubDir}/${artifactAlias}`);
+        }
+    }
+    if (config.backend && typeof config.backend === "object" && !Array.isArray(config.backend)) {
+        const backend = config.backend;
+        const packageSubDir = asOptionalString(backend.packageSubDir) ?? "server";
+        const artifactAlias = asOptionalString(backend.artifactAlias) ?? "dist";
+        required.add(`${packageSubDir}/${artifactAlias}`);
+    }
+    return [...required];
+}
+async function runDockerDeploy(runner, input) {
+    const { docker } = input;
+    const localImage = `${docker.imageName}:${docker.imageTag}`;
+    const loginArgs = docker.password
+        ? [
+            "login",
+            `--username=${docker.username}`,
+            `--password=${docker.password}`,
+            docker.registryUrl,
+        ]
+        : [
+            "login",
+            `--username=${docker.username}`,
+            "--password-stdin",
+            docker.registryUrl,
+        ];
+    const buildArgs = [
+        "buildx",
+        "build",
+        ...(docker.platform ? ["--platform", docker.platform] : []),
+        "-t",
+        localImage,
+        ".",
+    ];
+    const stageCommands = [
+        { stage: "login", args: loginArgs, cwd: input.outputDir },
+        { stage: "build", args: buildArgs, cwd: input.outputDir },
+        {
+            stage: "tag",
+            args: ["tag", localImage, input.remoteImage],
+            cwd: input.outputDir,
+        },
+        {
+            stage: "push",
+            args: ["push", input.remoteImage],
+            cwd: input.outputDir,
+        },
+    ];
+    try {
+        for (const command of stageCommands) {
+            const result = await runner({
+                command: "docker",
+                args: command.args,
+                cwd: command.cwd,
+            });
+            if (result.exitCode !== 0) {
+                return (0, command_result_1.commandError)(`[${DEPLOY_STAGE}][${command.stage}] Docker 命令执行失败: docker ${command.args.join(" ")} (exit=${result.exitCode})`, command_result_1.COMMAND_ERROR_CODES.executionFailed, result.exitCode);
+            }
+        }
+    }
+    catch (error) {
+        if (error instanceof command_runner_1.ExecutionError) {
+            return (0, command_result_1.commandError)(`[${DEPLOY_STAGE}] ${error.message}`, command_result_1.COMMAND_ERROR_CODES.executionFailed, error.exitCode);
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        return (0, command_result_1.commandError)(`[${DEPLOY_STAGE}] 部署命令执行异常: ${message}`, command_result_1.COMMAND_ERROR_CODES.executionFailed, 1);
+    }
+    return (0, command_result_1.commandOk)(`[${DEPLOY_STAGE}] 部署完成: ${input.remoteImage}\n` +
+        `[${DEPLOY_STAGE}] 运行示例: docker run -d -p 3000:3000 --name ${docker.imageName}-container ${input.remoteImage}`);
+}
+function normalizeDeployResult(result) {
+    if (result.ok) {
+        if (result.exitCode === 0) {
+            return result;
+        }
+        return (0, command_result_1.commandError)(`[${DEPLOY_STAGE}] 部署执行器返回成功但退出码非零 (exit=${result.exitCode})`, command_result_1.COMMAND_ERROR_CODES.executionFailed, result.exitCode);
+    }
+    if (result.exitCode !== 0) {
+        return result;
+    }
+    return (0, command_result_1.commandError)(result.message ??
+        `[${DEPLOY_STAGE}] 部署执行器返回失败但退出码为 0`, result.errorCode ?? command_result_1.COMMAND_ERROR_CODES.executionFailed, 1);
+}
+function asObject(value, fieldName) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`缺少对象字段: ${fieldName}`);
+    }
+    return value;
+}
+function asOptionalObject(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    return value;
+}
+function asRequiredString(value, fieldName) {
+    if (typeof value === "string" && value.trim() !== "") {
+        return value.trim();
+    }
+    throw new Error(`缺少字段: ${fieldName}`);
+}
+function asOptionalString(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const normalized = value.trim();
+    return normalized === "" ? undefined : normalized;
+}
+function formatDeployThrownError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return `[${DEPLOY_STAGE}] 部署执行异常: ${message}`;
+}
+function getNonZeroExitCode(error) {
+    if (!error || typeof error !== "object") {
+        return 1;
+    }
+    const candidate = error;
+    if (typeof candidate.exitCode === "number" && candidate.exitCode !== 0) {
+        return candidate.exitCode;
+    }
+    if (typeof candidate.status === "number" && candidate.status !== 0) {
+        return candidate.status;
+    }
+    return 1;
+}