openxiangda-devkit-core 2.0.0-alpha.12 → 2.0.0-alpha.121

package/dist/backend-image-build.js

@@ -0,0 +1,204 @@
+import { runCommandProcess } from './command-process.js';
+import { existsSync, mkdtempSync, readFileSync, rmSync, } from "node:fs";
+import { tmpdir } from "node:os";
+import { isAbsolute, join, relative, resolve } from "node:path";
+import { randomUUID } from "node:crypto";
+import { isIP } from "node:net";
+const MAX_REPOSITORY_PREFIX_LENGTH = 200;
+const MAX_REPOSITORY_PREFIX_SEGMENTS = 32;
+const BACKEND_IMAGE_NETWORK_ATTEMPTS = 3;
+const BACKEND_IMAGE_NETWORK_RETRY_DELAYS_MS = [250, 750];
+const REPOSITORY_COMPONENT = /^[a-z0-9]+(?:(?:[._]|__|[-]+)[a-z0-9]+)*$/;
+const DOMAIN_COMPONENT = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
+const SHA256_DIGEST = /^sha256:[a-f0-9]{64}$/;
+export class BackendImageBuildError extends Error {
+    code;
+    retryable;
+    constructor(code, message, retryable = false) {
+        super(`${code}: ${message}`);
+        this.code = code;
+        this.retryable = retryable;
+        this.name = "BackendImageBuildError";
+    }
+}
+export function backendImageBuildTarget(capabilities, appCode) {
+    const build = capabilities.deployment?.backendImageBuild;
+    if (!build ||
+        build.owner !== "developer-cli" ||
+        typeof build.available !== "boolean" ||
+        build.platform !== "linux/amd64") {
+        throw new BackendImageBuildError("OPENXIANGDA_BACKEND_IMAGE_BUILD_CONFIG_INVALID", "平台返回了不受支持的后端镜像构建合同");
+    }
+    if (!build.available) {
+        throw new BackendImageBuildError("OPENXIANGDA_BACKEND_IMAGE_BUILD_UNAVAILABLE", "平台尚未配置可运行的应用后端镜像环境，请联系平台管理员配置后重试");
+    }
+    const prefix = build.repositoryPrefix;
+    if (typeof prefix !== "string" ||
+        prefix.trim() !== prefix ||
+        !validOciRepositoryPrefix(prefix)) {
+        throw new BackendImageBuildError("OPENXIANGDA_BACKEND_IMAGE_REPOSITORY_INVALID", "平台返回的后端镜像 repositoryPrefix 不是安全的 OCI repository 前缀");
+    }
+    if (!/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(appCode)) {
+        throw new BackendImageBuildError("OPENXIANGDA_BACKEND_IMAGE_APP_CODE_INVALID", "应用代码不能用于后端镜像仓库");
+    }
+    return {
+        repository: `${prefix}/${appCode}-server`,
+        platform: build.platform,
+    };
+}
+function validOciRepositoryPrefix(value) {
+    if (!value ||
+        value.length > MAX_REPOSITORY_PREFIX_LENGTH ||
+        value !== value.toLowerCase() ||
+        value.includes("://") ||
+        /[@?#%\\\s]/.test(value)) {
+        return false;
+    }
+    const segments = value.split("/");
+    if (segments.length > MAX_REPOSITORY_PREFIX_SEGMENTS ||
+        segments.some(segment => !segment || segment === "." || segment === "..")) {
+        return false;
+    }
+    const [first, ...remaining] = segments;
+    if (!first)
+        return false;
+    const explicitRegistry = first === "localhost" ||
+        first.includes(".") ||
+        first.includes(":") ||
+        first.startsWith("[");
+    if (explicitRegistry && !validRegistry(first))
+        return false;
+    const repositorySegments = explicitRegistry ? remaining : segments;
+    return repositorySegments.every(segment => REPOSITORY_COMPONENT.test(segment) && !segment.includes(":"));
+}
+function validRegistry(value) {
+    if (value.startsWith("[")) {
+        const match = /^\[([^\]]+)\](?::([0-9]{1,5}))?$/.exec(value);
+        return Boolean(match && isIP(match[1]) === 6 && validPort(match[2]));
+    }
+    const match = /^([^:]+)(?::([0-9]{1,5}))?$/.exec(value);
+    if (!match || !validPort(match[2]))
+        return false;
+    const host = match[1];
+    if (isIP(host) === 4)
+        return true;
+    return host.split(".").every(component => DOMAIN_COMPONENT.test(component));
+}
+function validPort(value) {
+    if (value === undefined)
+        return true;
+    const port = Number(value);
+    return Number.isSafeInteger(port) && port >= 1 && port <= 65535;
+}
+export async function publishBackendImage(input) {
+    const root = resolve(input.root);
+    const dockerfile = resolve(root, input.backendRoot, "Dockerfile");
+    const relativeDockerfile = relative(root, dockerfile);
+    if (!relativeDockerfile ||
+        relativeDockerfile.startsWith("..") ||
+        isAbsolute(relativeDockerfile)) {
+        throw new BackendImageBuildError("OPENXIANGDA_BACKEND_DOCKERFILE_OUTSIDE_WORKSPACE", "后端 Dockerfile 必须位于应用工作区内");
+    }
+    if (!existsSync(dockerfile)) {
+        throw new BackendImageBuildError("OPENXIANGDA_BACKEND_DOCKERFILE_MISSING", `官方后端 Dockerfile 不存在: ${relativeDockerfile}`);
+    }
+    if (!existsSync(join(root, ".dockerignore"))) {
+        throw new BackendImageBuildError("OPENXIANGDA_DOCKERIGNORE_MISSING", "工作区缺少模板 .dockerignore，拒绝上传未受约束的构建上下文");
+    }
+    const docker = input.dockerExecutable || "docker";
+    const version = await runDocker(docker, ["buildx", "version"], root);
+    if (version.error?.code === "ENOENT") {
+        throw new BackendImageBuildError("OPENXIANGDA_DOCKER_REQUIRED", "未找到 Docker CLI，请安装并启动 Docker Desktop");
+    }
+    if (version.error || version.status !== 0) {
+        throw new BackendImageBuildError("OPENXIANGDA_DOCKER_BUILDX_REQUIRED", "当前 Docker CLI 未提供可用的 Buildx");
+    }
+    const scratch = mkdtempSync(join(tmpdir(), "openxiangda-buildx-"));
+    const metadataFile = join(scratch, "metadata.json");
+    const revision = String(input.sourceRevision || "").toLowerCase();
+    const sourceKey = /^[a-f0-9]{7,64}$/.test(revision)
+        ? revision.slice(0, 12)
+        : "local";
+    const tag = `ox2-${sourceKey}-${randomUUID().slice(0, 8)}`;
+    try {
+        for (let attempt = 1; attempt <= BACKEND_IMAGE_NETWORK_ATTEMPTS; attempt += 1) {
+            rmSync(metadataFile, { force: true });
+            const built = await runDocker(docker, [
+                "buildx",
+                "build",
+                "--file",
+                dockerfile,
+                "--platform",
+                input.target.platform,
+                "--provenance=false",
+                "--tag",
+                `${input.target.repository}:${tag}`,
+                "--metadata-file",
+                metadataFile,
+                "--push",
+                root,
+            ], root);
+            if (built.error?.code === "ENOENT") {
+                throw new BackendImageBuildError("OPENXIANGDA_DOCKER_REQUIRED", "未找到 Docker CLI，请安装并启动 Docker Desktop");
+            }
+            if (!built.error && built.status === 0)
+                break;
+            const failure = buildFailure(built.output);
+            if (failure.code !== "OPENXIANGDA_BACKEND_IMAGE_PUSH_FAILED" ||
+                attempt === BACKEND_IMAGE_NETWORK_ATTEMPTS) {
+                if (failure.code === "OPENXIANGDA_BACKEND_IMAGE_PUSH_FAILED" &&
+                    attempt === BACKEND_IMAGE_NETWORK_ATTEMPTS) {
+                    throw new BackendImageBuildError(failure.code, `后端镜像构建或推送连续 ${BACKEND_IMAGE_NETWORK_ATTEMPTS} 次遇到临时网络故障`, true);
+                }
+                throw failure;
+            }
+            await wait(BACKEND_IMAGE_NETWORK_RETRY_DELAYS_MS[attempt - 1] || 0);
+        }
+        let metadata;
+        try {
+            metadata = JSON.parse(readFileSync(metadataFile, "utf8"));
+        }
+        catch {
+            throw new BackendImageBuildError("OPENXIANGDA_BACKEND_IMAGE_DIGEST_MISSING", "Buildx 没有返回可解析的镜像 metadata digest");
+        }
+        const digest = String(metadata["containerimage.digest"] || "").toLowerCase();
+        if (!SHA256_DIGEST.test(digest)) {
+            throw new BackendImageBuildError("OPENXIANGDA_BACKEND_IMAGE_DIGEST_MISSING", "Buildx metadata 没有返回合法 sha256 镜像摘要");
+        }
+        return {
+            ...input.target,
+            digest,
+            reference: `${input.target.repository}@${digest}`,
+        };
+    }
+    finally {
+        rmSync(scratch, { recursive: true, force: true });
+    }
+}
+async function runDocker(executable, args, cwd) {
+    const environment = { ...process.env };
+    delete environment.OPENXIANGDA_TOKEN;
+    delete environment.OPENXIANGDA_BACKEND_IMAGE;
+    const result = await runCommandProcess(executable, args, { cwd, env: environment });
+    return {
+        status: result.status,
+        error: result.error,
+        output: result.output,
+    };
+}
+function wait(delayMs) {
+    return new Promise(resolve => setTimeout(resolve, delayMs));
+}
+function buildFailure(output) {
+    if (/cannot connect|daemon is not running|is the docker daemon running/i.test(output)) {
+        return new BackendImageBuildError("OPENXIANGDA_DOCKER_DAEMON_UNAVAILABLE", "Docker daemon 不可用，请启动 Docker Desktop 后重试", true);
+    }
+    if (/unauthorized|authentication required|requested access.*denied|denied:/i.test(output)) {
+        return new BackendImageBuildError("OPENXIANGDA_REGISTRY_AUTH_REQUIRED", "镜像仓库拒绝推送，请先在本机 Docker credential store 完成登录");
+    }
+    if (/timeout|temporary failure|connection reset|econnreset|fetch failed|network is unreachable|unexpected eof|socket disconnected before secure tls|socket hang up|etimedout/i.test(output)) {
+        return new BackendImageBuildError("OPENXIANGDA_BACKEND_IMAGE_PUSH_FAILED", "后端镜像构建或推送遇到临时网络故障", true);
+    }
+    return new BackendImageBuildError("OPENXIANGDA_BACKEND_IMAGE_BUILD_FAILED", "后端镜像构建或推送失败；请检查官方 Dockerfile 与本机 Docker 状态");
+}
+//# sourceMappingURL=backend-image-build.js.map

package/dist/backend-image-build.js.map

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

package/dist/command-process.d.ts

@@ -0,0 +1,14 @@
+/** 异步收集有界输出，让阶段心跳与 MCP 通知在检查、测试和 Docker 构建期间持续执行。 */
+export declare function runCommandProcess(command: string, args: string[], options: {
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    timeoutMs?: number;
+    maximumOutputBytes?: number;
+}): Promise<{
+    ok: boolean;
+    status: number | null;
+    output: string;
+    outputTruncated: boolean;
+    error?: NodeJS.ErrnoException;
+}>;
+//# sourceMappingURL=command-process.d.ts.map

package/dist/command-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-process.d.ts","sourceRoot":"","sources":["../src/command-process.ts"],"names":[],"mappings":"AAEA,qDAAqD;AACrD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE;IAC1E,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;QAC0B,OAAO;YAAU,MAAM,GAAG,IAAI;YAAU,MAAM;qBAAmB,OAAO;YAAU,MAAM,CAAC,cAAc;GAsCjI"}

package/dist/command-process.js

@@ -0,0 +1,51 @@
+import { spawn } from 'node:child_process';
+/** 异步收集有界输出，让阶段心跳与 MCP 通知在检查、测试和 Docker 构建期间持续执行。 */
+export function runCommandProcess(command, args, options) {
+    return new Promise(resolve => {
+        const limit = Math.max(1, options.maximumOutputBytes ?? 4 * 1024 * 1024);
+        const chunks = [];
+        let outputBytes = 0;
+        let outputTruncated = false;
+        let processError;
+        const child = spawn(command, args, { cwd: options.cwd, env: options.env || process.env, stdio: ['ignore', 'pipe', 'pipe'] });
+        const collect = (chunk) => {
+            chunks.push(chunk);
+            outputBytes += chunk.length;
+            while (outputBytes > limit) {
+                outputTruncated = true;
+                const first = chunks[0];
+                const excess = outputBytes - limit;
+                if (first.length <= excess) {
+                    chunks.shift();
+                    outputBytes -= first.length;
+                }
+                else {
+                    chunks[0] = first.subarray(excess);
+                    outputBytes -= excess;
+                }
+            }
+        };
+        child.stdout.on('data', collect);
+        child.stderr.on('data', collect);
+        let killTimer;
+        const timer = setTimeout(() => {
+            processError = Object.assign(new Error('子进程超过运行时限'), { code: 'ETIMEDOUT' });
+            child.kill('SIGTERM');
+            killTimer = setTimeout(() => child.kill('SIGKILL'), 5_000);
+            killTimer.unref();
+        }, options.timeoutMs ?? 30 * 60_000);
+        timer.unref();
+        child.on('error', error => { processError = error; });
+        child.on('close', status => {
+            clearTimeout(timer);
+            if (killTimer)
+                clearTimeout(killTimer);
+            resolve({
+                ok: status === 0 && !processError, status,
+                output: `${outputTruncated ? '[前段日志超过输出预算，已省略]\n' : ''}${Buffer.concat(chunks, outputBytes).toString('utf8')}`,
+                outputTruncated, ...(processError ? { error: processError } : {}),
+            });
+        });
+    });
+}
+//# sourceMappingURL=command-process.js.map

package/dist/command-process.js.map

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