ai-project-manage-cli 2.0.12 → 2.0.13

package/dist/core/backend-deploy/backend-deploy-workflow.d.ts

@@ -0,0 +1,16 @@
+import type { BackendDeployParams, BackendDeployResult } from "./types";
+/**
+ * 后端镜像部署编排：本地构建 → 推送私有 Registry → 远程 Docker 拉取镜像。
+ *
+ * 配置（仓库地址、账号、远程主机、证书路径等）由 {@link BackendDeployParams} 传入，
+ * 后续可改为从 `.apm/apm.config.json` 读取并映射到该结构。
+ */
+export declare class BackendDeployWorkflow {
+    private readonly params;
+    constructor(params: BackendDeployParams);
+    /**
+     * @param cwd - 解析相对路径时的基准目录（Dockerfile / context）
+     */
+    run(cwd?: string): Promise<BackendDeployResult>;
+}
+//# sourceMappingURL=backend-deploy-workflow.d.ts.map

package/dist/core/backend-deploy/backend-deploy-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-deploy-workflow.d.ts","sourceRoot":"","sources":["../../../src/core/backend-deploy/backend-deploy-workflow.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EAEpB,MAAM,SAAS,CAAC;AAEjB;;;;;GAKG;AACH,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,mBAAmB;IAExD;;OAEG;IACG,GAAG,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAgCrE"}

package/dist/core/backend-deploy/backend-deploy-workflow.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackendDeployWorkflow = void 0;
+const local_docker_build_1 = require("./local-docker-build");
+const registry_login_push_1 = require("./registry-login-push");
+const remote_docker_client_1 = require("./remote-docker-client");
+const remote_pull_image_1 = require("./remote-pull-image");
+const resolve_dockerfile_1 = require("./resolve-dockerfile");
+/**
+ * 后端镜像部署编排：本地构建 → 推送私有 Registry → 远程 Docker 拉取镜像。
+ *
+ * 配置（仓库地址、账号、远程主机、证书路径等）由 {@link BackendDeployParams} 传入，
+ * 后续可改为从 `.apm/apm.config.json` 读取并映射到该结构。
+ */
+class BackendDeployWorkflow {
+    params;
+    constructor(params) {
+        this.params = params;
+    }
+    /**
+     * @param cwd - 解析相对路径时的基准目录（Dockerfile / context）
+     */
+    async run(cwd = process.cwd()) {
+        const completedSteps = [];
+        console.log("开始解析 Dockerfile 路径");
+        const paths = (0, resolve_dockerfile_1.resolveDockerBuildPaths)(this.params, cwd);
+        completedSteps.push("resolveDockerfile");
+        console.log("已经找到 Dockerfile，开始构建镜像");
+        await (0, local_docker_build_1.buildDockerImageLocally)({
+            dockerfileAbs: paths.dockerfileAbs,
+            contextAbs: paths.contextAbs,
+            imageRef: this.params.imageRef,
+        });
+        completedSteps.push("localBuild");
+        console.log("镜像构建完成，开始登录并推送镜像");
+        await (0, registry_login_push_1.loginAndPushImage)(this.params.registry, this.params.imageRef);
+        completedSteps.push("registryPush");
+        console.log("登录并推送镜像完成，开始远程拉取镜像");
+        const remoteClient = (0, remote_docker_client_1.createRemoteDockerClient)(this.params.remoteDocker);
+        await (0, remote_pull_image_1.pullImageOnRemote)(remoteClient, this.params.imageRef, this.params.remotePullAuth);
+        completedSteps.push("remotePull");
+        console.log("远程拉取镜像完成，部署完成");
+        return {
+            ok: true,
+            imageRef: this.params.imageRef,
+            dockerfileAbs: paths.dockerfileAbs,
+            contextAbs: paths.contextAbs,
+            completedSteps,
+        };
+    }
+}
+exports.BackendDeployWorkflow = BackendDeployWorkflow;
+//# sourceMappingURL=backend-deploy-workflow.js.map

package/dist/core/backend-deploy/backend-deploy-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-deploy-workflow.js","sourceRoot":"","sources":["../../../src/core/backend-deploy/backend-deploy-workflow.ts"],"names":[],"mappings":";;;AAAA,6DAA+D;AAC/D,+DAA0D;AAC1D,iEAAkE;AAClE,2DAAwD;AACxD,6DAA+D;AAO/D;;;;;GAKG;AACH,MAAa,qBAAqB;IACH;IAA7B,YAA6B,MAA2B;QAA3B,WAAM,GAAN,MAAM,CAAqB;IAAG,CAAC;IAE5D;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;QACnC,MAAM,cAAc,GAAwB,EAAE,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,IAAA,4CAAuB,EAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACxD,cAAc,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,MAAM,IAAA,4CAAuB,EAAC;YAC5B,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;SAC/B,CAAC,CAAC;QACH,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAChC,MAAM,IAAA,uCAAiB,EAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpE,cAAc,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,MAAM,YAAY,GAAG,IAAA,+CAAwB,EAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACxE,MAAM,IAAA,qCAAiB,EACrB,YAAY,EACZ,IAAI,CAAC,MAAM,CAAC,QAAQ,EACpB,IAAI,CAAC,MAAM,CAAC,cAAc,CAC3B,CAAC;QACF,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC7B,OAAO;YACL,EAAE,EAAE,IAAI;YACR,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;YAC9B,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,cAAc;SACf,CAAC;IACJ,CAAC;CACF;AAtCD,sDAsCC"}

package/dist/core/backend-deploy/image-tag.d.ts

@@ -0,0 +1,2 @@
+export declare function assertDeployImageTag(tag: string, label: string): void;
+//# sourceMappingURL=image-tag.d.ts.map

package/dist/core/backend-deploy/image-tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-tag.d.ts","sourceRoot":"","sources":["../../../src/core/backend-deploy/image-tag.ts"],"names":[],"mappings":"AAMA,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOrE"}

package/dist/core/backend-deploy/image-tag.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertDeployImageTag = assertDeployImageTag;
+/**
+ * 部署用镜像 tag：与 OCI tag 常见规则接近（与分支名片段兼容）；不用 semver 版本号作唯一约定。
+ * 例：test、aaa_bbb、feat-1、prod
+ */
+const DEPLOY_IMAGE_TAG = /^(?!\.|-)[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/;
+function assertDeployImageTag(tag, label) {
+    const t = tag.trim();
+    if (!DEPLOY_IMAGE_TAG.test(t)) {
+        throw new Error(`${label} 须为合法镜像 tag（字母数字及 ._-，不以 . 或 - 开头，最长 128 字符），当前：${JSON.stringify(tag)}`);
+    }
+}
+//# sourceMappingURL=image-tag.js.map

package/dist/core/backend-deploy/image-tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-tag.js","sourceRoot":"","sources":["../../../src/core/backend-deploy/image-tag.ts"],"names":[],"mappings":";;AAMA,oDAOC;AAbD;;;GAGG;AACH,MAAM,gBAAgB,GAAG,4CAA4C,CAAC;AAEtE,SAAgB,oBAAoB,CAAC,GAAW,EAAE,KAAa;IAC7D,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,mDAAmD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CACjF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/core/backend-deploy/index.d.ts

@@ -0,0 +1,12 @@
+export { assertDeployImageTag } from "./image-tag";
+export { BackendDeployWorkflow } from "./backend-deploy-workflow";
+export { buildDockerImageLocally } from "./local-docker-build";
+export { resolveDockerBuildPaths } from "./resolve-dockerfile";
+export type { ResolvedDockerBuildPaths } from "./resolve-dockerfile";
+export { dockerLoginPrivateRegistry, dockerPushImage, loginAndPushImage, } from "./registry-login-push";
+export { runDockerCli, runProcess } from "./run-docker-cli";
+export { createRemoteDockerClient } from "./remote-docker-client";
+export type { DockerodeInstance } from "./remote-docker-client";
+export { pullImageOnRemote } from "./remote-pull-image";
+export type { BackendDeployParams, BackendDeployResult, BackendDeployStep, PrivateRegistryCredentials, RemoteDockerTlsOptions, RemotePullRegistryAuth, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/backend-deploy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/backend-deploy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,SAAS,CAAC"}

package/dist/core/backend-deploy/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pullImageOnRemote = exports.createRemoteDockerClient = exports.runProcess = exports.runDockerCli = exports.loginAndPushImage = exports.dockerPushImage = exports.dockerLoginPrivateRegistry = exports.resolveDockerBuildPaths = exports.buildDockerImageLocally = exports.BackendDeployWorkflow = exports.assertDeployImageTag = void 0;
+var image_tag_1 = require("./image-tag");
+Object.defineProperty(exports, "assertDeployImageTag", { enumerable: true, get: function () { return image_tag_1.assertDeployImageTag; } });
+var backend_deploy_workflow_1 = require("./backend-deploy-workflow");
+Object.defineProperty(exports, "BackendDeployWorkflow", { enumerable: true, get: function () { return backend_deploy_workflow_1.BackendDeployWorkflow; } });
+var local_docker_build_1 = require("./local-docker-build");
+Object.defineProperty(exports, "buildDockerImageLocally", { enumerable: true, get: function () { return local_docker_build_1.buildDockerImageLocally; } });
+var resolve_dockerfile_1 = require("./resolve-dockerfile");
+Object.defineProperty(exports, "resolveDockerBuildPaths", { enumerable: true, get: function () { return resolve_dockerfile_1.resolveDockerBuildPaths; } });
+var registry_login_push_1 = require("./registry-login-push");
+Object.defineProperty(exports, "dockerLoginPrivateRegistry", { enumerable: true, get: function () { return registry_login_push_1.dockerLoginPrivateRegistry; } });
+Object.defineProperty(exports, "dockerPushImage", { enumerable: true, get: function () { return registry_login_push_1.dockerPushImage; } });
+Object.defineProperty(exports, "loginAndPushImage", { enumerable: true, get: function () { return registry_login_push_1.loginAndPushImage; } });
+var run_docker_cli_1 = require("./run-docker-cli");
+Object.defineProperty(exports, "runDockerCli", { enumerable: true, get: function () { return run_docker_cli_1.runDockerCli; } });
+Object.defineProperty(exports, "runProcess", { enumerable: true, get: function () { return run_docker_cli_1.runProcess; } });
+var remote_docker_client_1 = require("./remote-docker-client");
+Object.defineProperty(exports, "createRemoteDockerClient", { enumerable: true, get: function () { return remote_docker_client_1.createRemoteDockerClient; } });
+var remote_pull_image_1 = require("./remote-pull-image");
+Object.defineProperty(exports, "pullImageOnRemote", { enumerable: true, get: function () { return remote_pull_image_1.pullImageOnRemote; } });
+//# sourceMappingURL=index.js.map

package/dist/core/backend-deploy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/backend-deploy/index.ts"],"names":[],"mappings":";;;AAAA,yCAAmD;AAA1C,iHAAA,oBAAoB,OAAA;AAC7B,qEAAkE;AAAzD,gIAAA,qBAAqB,OAAA;AAC9B,2DAA+D;AAAtD,6HAAA,uBAAuB,OAAA;AAChC,2DAA+D;AAAtD,6HAAA,uBAAuB,OAAA;AAEhC,6DAI+B;AAH7B,iIAAA,0BAA0B,OAAA;AAC1B,sHAAA,eAAe,OAAA;AACf,wHAAA,iBAAiB,OAAA;AAEnB,mDAA4D;AAAnD,8GAAA,YAAY,OAAA;AAAE,4GAAA,UAAU,OAAA;AACjC,+DAAkE;AAAzD,gIAAA,wBAAwB,OAAA;AAEjC,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA"}

package/dist/core/backend-deploy/local-docker-build.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 使用本机 Docker CLI 构建镜像（`docker build`）。
+ *
+ * 使用绝对路径指定 Dockerfile 与 context，避免工作目录与相对 `-f` 歧义。
+ */
+export declare function buildDockerImageLocally(params: {
+    dockerfileAbs: string;
+    contextAbs: string;
+    imageRef: string;
+}): Promise<void>;
+//# sourceMappingURL=local-docker-build.d.ts.map

package/dist/core/backend-deploy/local-docker-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-docker-build.d.ts","sourceRoot":"","sources":["../../../src/core/backend-deploy/local-docker-build.ts"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAahB"}

package/dist/core/backend-deploy/local-docker-build.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDockerImageLocally = buildDockerImageLocally;
+const node_os_1 = require("node:os");
+const run_docker_cli_1 = require("./run-docker-cli");
+/**
+ * 在 macOS（Apple 芯片）上本机构建时，默认指定目标平台为 `linux/amd64`，
+ * 以便与常见 Linux 服务器一致，避免默认构建出 arm64 镜像。
+ */
+function dockerBuildPlatformFlags() {
+    return (0, node_os_1.platform)() === "darwin" ? ["--platform", "linux/amd64"] : [];
+}
+/**
+ * 使用本机 Docker CLI 构建镜像（`docker build`）。
+ *
+ * 使用绝对路径指定 Dockerfile 与 context，避免工作目录与相对 `-f` 歧义。
+ */
+async function buildDockerImageLocally(params) {
+    await (0, run_docker_cli_1.runDockerCli)([
+        "build",
+        ...dockerBuildPlatformFlags(),
+        "-f",
+        params.dockerfileAbs,
+        "-t",
+        params.imageRef,
+        params.contextAbs,
+    ], {});
+}
+//# sourceMappingURL=local-docker-build.js.map

package/dist/core/backend-deploy/local-docker-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-docker-build.js","sourceRoot":"","sources":["../../../src/core/backend-deploy/local-docker-build.ts"],"names":[],"mappings":";;AAiBA,0DAiBC;AAlCD,qCAAmC;AAEnC,qDAAgD;AAEhD;;;GAGG;AACH,SAAS,wBAAwB;IAC/B,OAAO,IAAA,kBAAQ,GAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACtE,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,uBAAuB,CAAC,MAI7C;IACC,MAAM,IAAA,6BAAY,EAChB;QACE,OAAO;QACP,GAAG,wBAAwB,EAAE;QAC7B,IAAI;QACJ,MAAM,CAAC,aAAa;QACpB,IAAI;QACJ,MAAM,CAAC,QAAQ;QACf,MAAM,CAAC,UAAU;KAClB,EACD,EAAE,CACH,CAAC;AACJ,CAAC"}

package/dist/core/backend-deploy/registry-login-push.d.ts

@@ -0,0 +1,14 @@
+import type { PrivateRegistryCredentials } from "./types";
+/**
+ * 向私有 Registry 登录（`docker login`，密码经 stdin 传入，避免出现在进程列表中）。
+ */
+export declare function dockerLoginPrivateRegistry(registry: PrivateRegistryCredentials): Promise<void>;
+/**
+ * 推送镜像到已登录的 Registry（`docker push`）。
+ */
+export declare function dockerPushImage(imageRef: string): Promise<void>;
+/**
+ * 登录私有仓库并推送镜像（本地构建后的典型步骤）。
+ */
+export declare function loginAndPushImage(registry: PrivateRegistryCredentials, imageRef: string): Promise<void>;
+//# sourceMappingURL=registry-login-push.d.ts.map

package/dist/core/backend-deploy/registry-login-push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-login-push.d.ts","sourceRoot":"","sources":["../../../src/core/backend-deploy/registry-login-push.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAG1D;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,0BAA0B,GACnC,OAAO,CAAC,IAAI,CAAC,CAiCf;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAErE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,0BAA0B,EACpC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/core/backend-deploy/registry-login-push.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dockerLoginPrivateRegistry = dockerLoginPrivateRegistry;
+exports.dockerPushImage = dockerPushImage;
+exports.loginAndPushImage = loginAndPushImage;
+const node_child_process_1 = require("node:child_process");
+const run_docker_cli_1 = require("./run-docker-cli");
+/**
+ * 向私有 Registry 登录（`docker login`，密码经 stdin 传入，避免出现在进程列表中）。
+ */
+function dockerLoginPrivateRegistry(registry) {
+    return new Promise((resolve, reject) => {
+        const child = (0, node_child_process_1.spawn)("docker", [
+            "login",
+            "--username",
+            registry.username,
+            "--password-stdin",
+            registry.registryHost,
+        ], {
+            stdio: ["pipe", "inherit", "inherit"],
+            shell: false,
+        });
+        child.stdin?.write(`${registry.password}\n`);
+        child.stdin?.end();
+        child.on("error", reject);
+        child.on("close", (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            reject(new Error(`docker login 失败（退出码 ${code ?? "?"}），仓库：${registry.registryHost}`));
+        });
+    });
+}
+/**
+ * 推送镜像到已登录的 Registry（`docker push`）。
+ */
+async function dockerPushImage(imageRef) {
+    await (0, run_docker_cli_1.runDockerCli)(["push", imageRef], {});
+}
+/**
+ * 登录私有仓库并推送镜像（本地构建后的典型步骤）。
+ */
+async function loginAndPushImage(registry, imageRef) {
+    await dockerLoginPrivateRegistry(registry);
+    await dockerPushImage(imageRef);
+}
+//# sourceMappingURL=registry-login-push.js.map

package/dist/core/backend-deploy/registry-login-push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-login-push.js","sourceRoot":"","sources":["../../../src/core/backend-deploy/registry-login-push.ts"],"names":[],"mappings":";;AAQA,gEAmCC;AAKD,0CAEC;AAKD,8CAMC;AA7DD,2DAA2C;AAG3C,qDAAgD;AAEhD;;GAEG;AACH,SAAgB,0BAA0B,CACxC,QAAoC;IAEpC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,IAAA,0BAAK,EACjB,QAAQ,EACR;YACE,OAAO;YACP,YAAY;YACZ,QAAQ,CAAC,QAAQ;YACjB,kBAAkB;YAClB,QAAQ,CAAC,YAAY;SACtB,EACD;YACE,KAAK,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC;YACrC,KAAK,EAAE,KAAK;SACb,CACF,CAAC;QAEF,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,QAAQ,CAAC,QAAQ,IAAI,CAAC,CAAC;QAC7C,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC;QAEnB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YACD,MAAM,CACJ,IAAI,KAAK,CACP,uBAAuB,IAAI,IAAI,GAAG,QAAQ,QAAQ,CAAC,YAAY,EAAE,CAClE,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,MAAM,IAAA,6BAAY,EAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,iBAAiB,CACrC,QAAoC,EACpC,QAAgB;IAEhB,MAAM,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC"}

package/dist/core/backend-deploy/remote-docker-client.d.ts

@@ -0,0 +1,11 @@
+import Docker from "dockerode";
+import type { RemoteDockerTlsOptions } from "./types";
+export type DockerodeInstance = Docker;
+/**
+ * 根据 TLS 选项创建连接**远程** Docker 守护进程的 dockerode 客户端。
+ *
+ * - 若提供 ca/cert/key 路径，则读取为 Buffer 传入 Modem（与 `docker --host` 使用证书场景一致）。
+ * - 仅内网 HTTP 且无需证书时，可只设置 protocol: 'http'，不传 ca/cert/key。
+ */
+export declare function createRemoteDockerClient(options: RemoteDockerTlsOptions): DockerodeInstance;
+//# sourceMappingURL=remote-docker-client.d.ts.map

package/dist/core/backend-deploy/remote-docker-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-docker-client.d.ts","sourceRoot":"","sources":["../../../src/core/backend-deploy/remote-docker-client.ts"],"names":[],"mappings":"AAEA,OAAO,MAAM,MAAM,WAAW,CAAC;AAE/B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEvC;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,sBAAsB,GAC9B,iBAAiB,CAoBnB"}

package/dist/core/backend-deploy/remote-docker-client.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRemoteDockerClient = createRemoteDockerClient;
+const node_fs_1 = require("node:fs");
+const dockerode_1 = __importDefault(require("dockerode"));
+/**
+ * 根据 TLS 选项创建连接**远程** Docker 守护进程的 dockerode 客户端。
+ *
+ * - 若提供 ca/cert/key 路径，则读取为 Buffer 传入 Modem（与 `docker --host` 使用证书场景一致）。
+ * - 仅内网 HTTP 且无需证书时，可只设置 protocol: 'http'，不传 ca/cert/key。
+ */
+function createRemoteDockerClient(options) {
+    const protocol = options.protocol ?? "https";
+    const modemOpts = {
+        host: options.host,
+        port: options.port,
+        protocol,
+    };
+    if (options.caPath) {
+        modemOpts.ca = (0, node_fs_1.readFileSync)(options.caPath);
+    }
+    if (options.certPath) {
+        modemOpts.cert = (0, node_fs_1.readFileSync)(options.certPath);
+    }
+    if (options.keyPath) {
+        modemOpts.key = (0, node_fs_1.readFileSync)(options.keyPath);
+    }
+    return new dockerode_1.default(modemOpts);
+}
+//# sourceMappingURL=remote-docker-client.js.map

package/dist/core/backend-deploy/remote-docker-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-docker-client.js","sourceRoot":"","sources":["../../../src/core/backend-deploy/remote-docker-client.ts"],"names":[],"mappings":";;;;;AAcA,4DAsBC;AApCD,qCAAuC;AAEvC,0DAA+B;AAM/B;;;;;GAKG;AACH,SAAgB,wBAAwB,CACtC,OAA+B;IAE/B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC;IAE7C,MAAM,SAAS,GAAyB;QACtC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ;KACT,CAAC;IAEF,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,SAAS,CAAC,EAAE,GAAG,IAAA,sBAAY,EAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,SAAS,CAAC,IAAI,GAAG,IAAA,sBAAY,EAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,SAAS,CAAC,GAAG,GAAG,IAAA,sBAAY,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,IAAI,mBAAM,CAAC,SAAS,CAAC,CAAC;AAC/B,CAAC"}

package/dist/core/backend-deploy/remote-pull-image.d.ts

@@ -0,0 +1,9 @@
+import Docker from "dockerode";
+import type { RemotePullRegistryAuth } from "./types";
+/**
+ * 在远程 Docker 上拉取镜像（`docker pull` 的 API 等价物），并等待拉取流结束。
+ *
+ * 私有仓库拉取需在远程引擎侧提供 authconfig（与本地 `docker login` 写入的认证类似）。
+ */
+export declare function pullImageOnRemote(docker: Docker, imageRef: string, auth?: RemotePullRegistryAuth): Promise<void>;
+//# sourceMappingURL=remote-pull-image.d.ts.map

package/dist/core/backend-deploy/remote-pull-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-pull-image.d.ts","sourceRoot":"","sources":["../../../src/core/backend-deploy/remote-pull-image.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,WAAW,CAAC;AAE/B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAStD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,sBAAsB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAiCf"}

package/dist/core/backend-deploy/remote-pull-image.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pullImageOnRemote = pullImageOnRemote;
+/**
+ * 在远程 Docker 上拉取镜像（`docker pull` 的 API 等价物），并等待拉取流结束。
+ *
+ * 私有仓库拉取需在远程引擎侧提供 authconfig（与本地 `docker login` 写入的认证类似）。
+ */
+function pullImageOnRemote(docker, imageRef, auth) {
+    return new Promise((resolve, reject) => {
+        const authConfig = auth
+            ? {
+                username: auth.username,
+                password: auth.password,
+                serveraddress: auth.serveraddress,
+            }
+            : undefined;
+        const cb = (err, stream) => {
+            if (err) {
+                reject(err);
+                return;
+            }
+            if (!stream) {
+                reject(new Error("docker pull 未返回流"));
+                return;
+            }
+            docker.modem.followProgress(stream, (progressErr) => {
+                if (progressErr) {
+                    reject(progressErr);
+                }
+                else {
+                    resolve();
+                }
+            });
+        };
+        docker.pull(imageRef, {}, cb, authConfig);
+    });
+}
+//# sourceMappingURL=remote-pull-image.js.map

package/dist/core/backend-deploy/remote-pull-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-pull-image.js","sourceRoot":"","sources":["../../../src/core/backend-deploy/remote-pull-image.ts"],"names":[],"mappings":";;AAgBA,8CAqCC;AA1CD;;;;GAIG;AACH,SAAgB,iBAAiB,CAC/B,MAAc,EACd,QAAgB,EAChB,IAA6B;IAE7B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,UAAU,GAA2B,IAAI;YAC7C,CAAC,CAAC;gBACE,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,aAAa,EAAE,IAAI,CAAC,aAAa;aAClC;YACH,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,EAAE,GAAG,CACT,GAAiB,EACjB,MAAyC,EACzC,EAAE;YACF,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,CAAC,GAAG,CAAC,CAAC;gBACZ,OAAO;YACT,CAAC;YACD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;gBACtC,OAAO;YACT,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,WAAyB,EAAE,EAAE;gBAChE,IAAI,WAAW,EAAE,CAAC;oBAChB,MAAM,CAAC,WAAW,CAAC,CAAC;gBACtB,CAAC;qBAAM,CAAC;oBACN,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/core/backend-deploy/resolve-dockerfile.d.ts

@@ -0,0 +1,12 @@
+import type { BackendDeployParams } from "./types";
+export type ResolvedDockerBuildPaths = {
+    dockerfileAbs: string;
+    contextAbs: string;
+};
+/**
+ * 校验 Dockerfile 与构建上下文路径，并解析为绝对路径。
+ *
+ * @param cwd - 解析相对路径时的基准目录，一般为 `process.cwd()`
+ */
+export declare function resolveDockerBuildPaths(params: Pick<BackendDeployParams, "dockerfilePath" | "contextPath">, cwd: string): ResolvedDockerBuildPaths;
+//# sourceMappingURL=resolve-dockerfile.d.ts.map

package/dist/core/backend-deploy/resolve-dockerfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-dockerfile.d.ts","sourceRoot":"","sources":["../../../src/core/backend-deploy/resolve-dockerfile.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,MAAM,MAAM,wBAAwB,GAAG;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,gBAAgB,GAAG,aAAa,CAAC,EACnE,GAAG,EAAE,MAAM,GACV,wBAAwB,CAqB1B"}

package/dist/core/backend-deploy/resolve-dockerfile.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveDockerBuildPaths = resolveDockerBuildPaths;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * 校验 Dockerfile 与构建上下文路径，并解析为绝对路径。
+ *
+ * @param cwd - 解析相对路径时的基准目录，一般为 `process.cwd()`
+ */
+function resolveDockerBuildPaths(params, cwd) {
+    const dockerfileAbs = node_path_1.default.resolve(cwd, params.dockerfilePath);
+    if (!(0, node_fs_1.existsSync)(dockerfileAbs)) {
+        throw new Error(`Dockerfile 不存在：${dockerfileAbs}`);
+    }
+    if (!(0, node_fs_1.statSync)(dockerfileAbs).isFile()) {
+        throw new Error(`路径不是文件（应为 Dockerfile）：${dockerfileAbs}`);
+    }
+    const contextAbs = params.contextPath
+        ? node_path_1.default.resolve(cwd, params.contextPath)
+        : node_path_1.default.dirname(dockerfileAbs);
+    if (!(0, node_fs_1.existsSync)(contextAbs)) {
+        throw new Error(`构建上下文目录不存在：${contextAbs}`);
+    }
+    if (!(0, node_fs_1.statSync)(contextAbs).isDirectory()) {
+        throw new Error(`构建上下文不是目录：${contextAbs}`);
+    }
+    return { dockerfileAbs, contextAbs };
+}
+//# sourceMappingURL=resolve-dockerfile.js.map

package/dist/core/backend-deploy/resolve-dockerfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-dockerfile.js","sourceRoot":"","sources":["../../../src/core/backend-deploy/resolve-dockerfile.ts"],"names":[],"mappings":";;;;;AAeA,0DAwBC;AAvCD,qCAA+C;AAC/C,0DAA6B;AAS7B;;;;GAIG;AACH,SAAgB,uBAAuB,CACrC,MAAmE,EACnE,GAAW;IAEX,MAAM,aAAa,GAAG,mBAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IAC/D,IAAI,CAAC,IAAA,oBAAU,EAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,kBAAkB,aAAa,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,CAAC,IAAA,kBAAQ,EAAC,aAAa,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,yBAAyB,aAAa,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW;QACnC,CAAC,CAAC,mBAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC;QACvC,CAAC,CAAC,mBAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAEhC,IAAI,CAAC,IAAA,oBAAU,EAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,cAAc,UAAU,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,CAAC,IAAA,kBAAQ,EAAC,UAAU,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,aAAa,UAAU,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC;AACvC,CAAC"}

package/dist/core/backend-deploy/run-docker-cli.d.ts

@@ -0,0 +1,14 @@
+export type RunProcessOptions = {
+    cwd?: string;
+    /** 默认继承当前进程的 stdio，便于在终端看到 docker 输出 */
+    stdio?: "inherit" | "pipe";
+};
+/**
+ * 执行本地 `docker` CLI（需已安装 Docker Desktop / Engine 且 `docker` 在 PATH 中）。
+ */
+export declare function runDockerCli(args: string[], options?: RunProcessOptions): Promise<void>;
+/**
+ * 通用子进程封装：非 0 退出码时 reject。
+ */
+export declare function runProcess(command: string, args: string[], options?: RunProcessOptions): Promise<void>;
+//# sourceMappingURL=run-docker-cli.d.ts.map

package/dist/core/backend-deploy/run-docker-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-docker-cli.d.ts","sourceRoot":"","sources":["../../../src/core/backend-deploy/run-docker-cli.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/core/backend-deploy/run-docker-cli.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDockerCli = runDockerCli;
+exports.runProcess = runProcess;
+const node_child_process_1 = require("node:child_process");
+/**
+ * 执行本地 `docker` CLI（需已安装 Docker Desktop / Engine 且 `docker` 在 PATH 中）。
+ */
+function runDockerCli(args, options) {
+    return runProcess("docker", args, options);
+}
+/**
+ * 通用子进程封装：非 0 退出码时 reject。
+ */
+function runProcess(command, args, options) {
+    return new Promise((resolve, reject) => {
+        const child = (0, node_child_process_1.spawn)(command, args, {
+            stdio: options?.stdio ?? "inherit",
+            shell: false,
+            cwd: options?.cwd,
+        });
+        child.on("error", reject);
+        child.on("close", (code, signal) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            const hint = signal ? `，信号 ${signal}` : "";
+            reject(new Error(`命令失败：${command} ${args.join(" ")}（退出码 ${code ?? "?"}${hint}）`));
+        });
+    });
+}
+//# sourceMappingURL=run-docker-cli.js.map

package/dist/core/backend-deploy/run-docker-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-docker-cli.js","sourceRoot":"","sources":["../../../src/core/backend-deploy/run-docker-cli.ts"],"names":[],"mappings":";;AAWA,oCAKC;AAKD,gCAyBC;AA9CD,2DAA2C;AAQ3C;;GAEG;AACH,SAAgB,YAAY,CAC1B,IAAc,EACd,OAA2B;IAE3B,OAAO,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CACxB,OAAe,EACf,IAAc,EACd,OAA2B;IAE3B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,IAAA,0BAAK,EAAC,OAAO,EAAE,IAAI,EAAE;YACjC,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,SAAS;YAClC,KAAK,EAAE,KAAK;YACZ,GAAG,EAAE,OAAO,EAAE,GAAG;SAClB,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YACjC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,MAAM,CACJ,IAAI,KAAK,CACP,QAAQ,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI,GAAG,GAAG,IAAI,GAAG,CAC/D,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/core/backend-deploy/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 后端镜像部署相关类型（后续可由 .apm/apm.config.json 映射注入）。
+ */
+/** 阿里云（或其它兼容 Docker Registry V2 的）私有仓库登录信息 */
+export type PrivateRegistryCredentials = {
+    /** 仓库主机名，如 registry.cn-hangzhou.aliyuncs.com */
+    registryHost: string;
+    username: string;
+    password: string;
+};
+/**
+ * 远程 Docker 守护进程连接参数（通常对应 TLS 的 Docker Host）。
+ * 与 dockerode / DockerModem 选项对齐。
+ */
+export type RemoteDockerTlsOptions = {
+    host: string;
+    port: number;
+    /** 默认可为 https（TLS），内网无证书场景可用 http */
+    protocol?: "https" | "http";
+    /** CA 证书文件路径（PEM） */
+    caPath?: string;
+    /** 客户端证书路径（PEM），与 keyPath 成对使用 */
+    certPath?: string;
+    /** 客户端私钥路径（PEM） */
+    keyPath?: string;
+};
+/**
+ * 在远程主机上拉取私有镜像时，传给 docker pull 的认证（与本地 docker login 类似）。
+ * serveraddress 一般为 https://{registryHost}
+ */
+export type RemotePullRegistryAuth = {
+    username: string;
+    password: string;
+    /** 例如 https://registry.cn-hangzhou.aliyuncs.com */
+    serveraddress: string;
+};
+/**
+ * 单次后端部署流程的输入：路径、镜像名、仓库与远程连接均由调用方组装（例如来自 CLI 或配置文件）。
+ */
+export type BackendDeployParams = {
+    /** Dockerfile 路径（相对 cwd 或绝对路径） */
+    dockerfilePath: string;
+    /**
+     * 构建上下文目录；缺省为 Dockerfile 所在目录。
+     * 须包含 Dockerfile 中 COPY 所依赖的文件。
+     */
+    contextPath?: string;
+    /**
+     * 完整镜像引用（含 tag），如
+     * registry.cn-hangzhou.aliyuncs.com/my-ns/my-app:v1.0.0
+     */
+    imageRef: string;
+    registry: PrivateRegistryCredentials;
+    remoteDocker: RemoteDockerTlsOptions;
+    /**
+     * 远程 docker pull 拉取私有镜像时是否需要认证。
+     * 若镜像仓库可在远程主机上匿名拉取，可省略。
+     */
+    remotePullAuth?: RemotePullRegistryAuth;
+};
+export type BackendDeployStep = "resolveDockerfile" | "localBuild" | "registryPush" | "remotePull";
+export type BackendDeployResult = {
+    ok: true;
+    imageRef: string;
+    dockerfileAbs: string;
+    contextAbs: string;
+    completedSteps: BackendDeployStep[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/core/backend-deploy/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/backend-deploy/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8CAA8C;AAC9C,MAAM,MAAM,0BAA0B,GAAG;IACvC,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,0BAA0B,CAAC;IACrC,YAAY,EAAE,sBAAsB,CAAC;IACrC;;;OAGG;IACH,cAAc,CAAC,EAAE,sBAAsB,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB,mBAAmB,GACnB,YAAY,GACZ,cAAc,GACd,YAAY,CAAC;AAEjB,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,iBAAiB,EAAE,CAAC;CACrC,CAAC"}

package/dist/core/backend-deploy/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * 后端镜像部署相关类型（后续可由 .apm/apm.config.json 映射注入）。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/core/backend-deploy/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/backend-deploy/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/core/branch-name.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 与 `deploy-frontend` / `deploy-backend` 共享：从位置参数解析「分支名片段」及 `--env` 环境标签。
+ */
+export declare function sanitizeBranchName(raw: string): string;
+export declare function normalizeBranchName(raw: string): string;
+/** `--env` 默认含逗号时取第一段作为标签（如「测试环境」） */
+export declare function resolveEnvTag(raw: string): string;
+//# sourceMappingURL=branch-name.d.ts.map

package/dist/core/branch-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-name.d.ts","sourceRoot":"","sources":["../../src/core/branch-name.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUtD;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,sCAAsC;AACtC,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMjD"}