openxiangda-devkit-core 2.71.4 → 2.71.6

package/dist/application-services.js

@@ -1147,8 +1147,8 @@ export class OpenXiangdaApplicationServices {
         if (diagnostics.length > 0) {
             return this.result("deployment.plan", workspace.context.workspace, undefined, diagnostics);
         }
-        const source = await operationStage('source', '核对远端主线与源码', () => publishedDeliverySource(workspace.root));
-        const lifecycle = developmentLifecycle(workspace.root, this.appSpecContractIndex(workspace, true));
+        const source = await operationStage('source', '核对远端主线与源码（网络不可达时保留本地来源）', () => publishedDeliverySource(workspace.root));
+        const lifecycle = developmentLifecycle(workspace.root, this.appSpecContractIndex(workspace, true), undefined, input.appSpecChangeId, 'warning-first');
         if (!lifecycle.readyForTest)
             return this.result('deployment.plan', workspace.context.workspace, { lifecycle: summarizeLifecycle(lifecycle) }, lifecycle.diagnostics);
         const sources = compileApplicationSources(workspace.config, this.toolchainVersion);
@@ -1158,6 +1158,7 @@ export class OpenXiangdaApplicationServices {
         return this.result("deployment.plan", workspace.context.workspace, {
             runtimeCapacity,
             workflowActivation,
+            lifecycle: summarizeLifecycle(lifecycle),
             environment: input.environment,
             appCode: workspace.config.app.code,
             sealed: false,
@@ -1168,7 +1169,7 @@ export class OpenXiangdaApplicationServices {
             backendRoot: workspace.config.backend.root,
             configDigest: sources.config.digest,
             contractDigest: sources.contracts.digest,
-        }, workflowActivation);
+        }, [...workflowActivation, ...lifecycle.diagnostics]);
     }
     async deploy(input) {
         const workspace = await this.workspace(input.root);
@@ -1181,14 +1182,18 @@ export class OpenXiangdaApplicationServices {
                 this.diagnostic("DEPLOY_PREPRODUCTION_ONLY", "Native 2.0 只允许直接部署到预发环境", String(input.environment), "使用 openxiangda deploy；生产环境必须显式复用成功的测试 DeploymentRun"),
             ]);
         }
-        const source = await operationStage('source', '核对远端主线与源码', () => publishedDeliverySource(workspace.root));
+        const source = await operationStage('source', '核对远端主线与源码（网络不可达时保留本地来源）', () => publishedDeliverySource(workspace.root));
         const client = await this.client(workspace.root);
         const capabilities = await client.capabilities();
+        let prerequisiteWarnings = [];
         if (capabilities.features?.['application.deployment-prerequisites']?.status === 'available') {
-            await operationStage('prerequisites', '检查内核、源码托管与镜像仓库', async () => {
+            const prerequisites = await operationStage('prerequisites', '检查内核、源码托管与镜像仓库（源码异常转为警告）', async () => {
                 const backend = backendRuntimeRequired(workspace.config);
-                assertDeploymentPrerequisites(await client.deploymentPrerequisites(workspace.config.app.code, backend), workspace.config.app.code, backend);
+                const report = await client.deploymentPrerequisites(workspace.config.app.code, backend);
+                const warnings = assertDeploymentPrerequisites(report, workspace.config.app.code, backend);
+                return { report, warnings };
             });
+            prerequisiteWarnings = prerequisites.warnings;
         }
         const sources = compileApplicationSources(workspace.config, this.toolchainVersion);
         await operationStage('target-preflight', '目标平台只读预检', () => this.validateTargetConfigurationCompatibility(workspace, input.environment, compileLocalConfiguration(workspace.config, this.toolchainVersion)));
@@ -1204,8 +1209,8 @@ export class OpenXiangdaApplicationServices {
         const generated = await this.generate({ root: workspace.root, check: true });
         if (!generated.ok)
             return { ...generated, operation: 'deploy' };
-        const lifecycle = await operationStage('development-records', '核对需求、架构与测试验收计划', async () => {
-            const lifecycle = developmentLifecycle(workspace.root, this.appSpecContractIndex(workspace, true));
+        const lifecycle = await operationStage('development-records', '读取需求、架构与测试验收计划（缺口转为警告）', async () => {
+            const lifecycle = developmentLifecycle(workspace.root, this.appSpecContractIndex(workspace, true), undefined, input.appSpecChangeId, 'warning-first');
             return { ...lifecycle, ok: lifecycle.readyForTest };
         });
         if (!lifecycle.readyForTest)
@@ -1253,8 +1258,13 @@ export class OpenXiangdaApplicationServices {
             idempotencyKey: input.idempotencyKey ||
                 `deploy:${built.data.package.digest}:${input.environment}${input.deploymentStrategy === 'maintenance-replace' ? ':maintenance-replace' : ''}`,
             ...(input.requestId ? { requestId: input.requestId } : {}),
+            ...(input.approvalLink ? { approvalLink: true } : {}),
         });
-        return this.result("deploy", workspace.context.workspace, deployment, workflowActivation, [
+        return this.result("deploy", workspace.context.workspace, deployment, [
+            ...workflowActivation,
+            ...prerequisiteWarnings,
+            ...lifecycle.diagnostics,
+        ], [
             {
                 code: "status",
                 label: "查看部署状态",
@@ -1447,7 +1457,7 @@ export class OpenXiangdaApplicationServices {
         if (!appVersionId)
             throw new Error("DEPLOYMENT_APP_VERSION_NOT_AVAILABLE");
         const diagnostics = await this.productionPromotionDiagnostics(workspace, client, source, appVersionId);
-        if (diagnostics.length > 0) {
+        if (diagnostics.some(item => item.severity === 'error')) {
             return this.result("deploy", workspace.context.workspace, undefined, diagnostics);
         }
         const deployment = await operationStage('submit', '提交生产晋级', () => client.promote({
@@ -1456,7 +1466,7 @@ export class OpenXiangdaApplicationServices {
             environmentKind: environment,
             idempotencyKey: `promote:${source.packageDigest}:${environment}`,
         }));
-        return this.ok("deploy", workspace.context.workspace, deployment, [
+        return this.result("deploy", workspace.context.workspace, deployment, diagnostics, [
             { code: "status", label: "查看生产部署状态", command: `openxiangda status ${deployment.id}` },
         ]);
     }
@@ -1476,12 +1486,21 @@ export class OpenXiangdaApplicationServices {
             assertProductionPromotionPreflight(version, {
                 appCode: workspace.config.app.code, sourceDeploymentId: source.id, appVersionId, packageDigest: source.packageDigest,
             });
-            const testedLifecycle = lifecycleAtCommit(workspace.root, version.source.commit, this.appSpecContractIndex(workspace, true));
+            let testedLifecycle;
+            try {
+                testedLifecycle = lifecycleAtCommit(workspace.root, version.source.commit, this.appSpecContractIndex(workspace, true));
+            }
+            catch (error) {
+                // 生产晋级使用已封存的 packageDigest；当前机器无法读取来源仓库时仅提示，
+                // 不把本地 Git、VPN 或远端仓库可达性误判成制品不可发布。
+                diagnostics.push(this.advisoryDiagnostic(this.diagnostic('APPSPEC_TESTED_SOURCE_UNAVAILABLE', '无法从测试版本来源读取 AppSpec 验收计划；仍可按不可变测试制品晋级', 'appspec', '网络恢复后补齐验收记录；本次以测试 DeploymentRun 和 packageDigest 为准', { message: error instanceof Error ? error.message : String(error) })));
+                testedLifecycle = { changeId: null, acceptanceIds: [], design: { diagnostics: [] } };
+            }
             if (!testedLifecycle.changeId || !testedLifecycle.acceptanceIds.length) {
-                diagnostics.push(this.diagnostic('APPSPEC_TESTED_PLAN_REQUIRED', '指定测试版本缺少可追溯的需求与验收计划', 'appspec', '补齐真实记录并发布新的测试候选，再执行验收和生产晋级'));
+                diagnostics.push(this.advisoryDiagnostic(this.diagnostic('APPSPEC_TESTED_PLAN_REQUIRED', '指定测试版本缺少可追溯的需求与验收计划；仍可继续生产晋级，请在后续补齐记录', 'appspec', '补齐真实记录并在下一次发布前复核；本次仅作为发布风险提示')));
             }
             // 原测试提交中的设计基线也必须有效，当前主线的补写不能补签旧版本。
-            diagnostics.push(...testedLifecycle.design.diagnostics);
+            diagnostics.push(...this.advisoryDiagnostics(testedLifecycle.design.diagnostics));
             const acceptance = await operationStage('business-acceptance', '核对原测试版本的业务验收报告', async () => {
                 const result = verifyBusinessAcceptance(workspace.root, source, testedLifecycle);
                 if (result.ok)
@@ -1492,13 +1511,13 @@ export class OpenXiangdaApplicationServices {
                     });
                 return result;
             });
-            diagnostics.push(...acceptance.diagnostics);
+            diagnostics.push(...this.advisoryDiagnostics(acceptance.diagnostics));
         }
         catch (error) {
             return [this.configurationCompatibilityDiagnostic(error)];
         }
         if (workspace.context.workspace.dirty || version.source.dirty) {
-            diagnostics.push(this.diagnostic("PRODUCTION_SOURCE_DIRTY", "生产晋级只接受来源干净且当前工作区无未提交变更的 AppVersion", "git", "提交并推送当前改动，或在干净主线目录中晋级该测试版本"));
+            diagnostics.push(this.advisoryDiagnostic(this.diagnostic("PRODUCTION_SOURCE_DIRTY", "测试版本或当前工作区存在未提交变更；本次仍复用已封存测试制品晋级", "git", "后续发布前补齐来源快照；当前制品仍按不可变 packageDigest 晋级")));
         }
         const repository = git(workspace.root, ["config", "--get", "remote.origin.url"]);
         const currentRepository = this.repositoryIdentity(repository);
@@ -1506,9 +1525,9 @@ export class OpenXiangdaApplicationServices {
         if (!currentRepository ||
             !sourceRepository ||
             currentRepository !== sourceRepository) {
-            diagnostics.push(this.diagnostic("PRODUCTION_SOURCE_REPOSITORY_MISMATCH", "当前工作区仓库与 AppVersion 来源仓库不一致", "git.remote.origin.url", "在构建该 AppVersion 的同一仓库中执行晋级", { current: repository || null, source: version.source.repository }));
+            diagnostics.push(this.advisoryDiagnostic(this.diagnostic("PRODUCTION_SOURCE_REPOSITORY_MISMATCH", "当前工作区仓库与 AppVersion 来源仓库不一致；仓库归属仅作溯源提示", "git.remote.origin.url", "确认 packageDigest 和测试 DeploymentRun 后继续；如需完整溯源再补充仓库信息", { current: repository || null, source: version.source.repository })));
         }
-        if (diagnostics.length)
+        if (diagnostics.some(item => item.severity === 'error'))
             return diagnostics;
         try {
             await operationStage('promotion-source', '核对测试制品的主线来源', () => publishedDeliverySource(workspace.root, version.source.commit));
@@ -1516,7 +1535,7 @@ export class OpenXiangdaApplicationServices {
         catch (error) {
             if (!(error instanceof DeliverySourceError))
                 throw error;
-            diagnostics.push(this.diagnostic(error.code, error.message, 'git', String(error.data.remediation), error.data));
+            diagnostics.push(this.advisoryDiagnostic(this.diagnostic(error.code, error.message, 'git', String(error.data.remediation), error.data)));
         }
         return diagnostics;
     }
@@ -2080,6 +2099,21 @@ export class OpenXiangdaApplicationServices {
             ...(details ? { details } : {}),
         };
     }
+    advisoryDiagnostic(diagnostic) {
+        return {
+            ...diagnostic,
+            severity: diagnostic.severity === 'error' ? 'warning' : diagnostic.severity,
+            retryable: true,
+            details: {
+                ...diagnostic.details,
+                gateClass: 'advisory',
+                affects: ['release-readiness'],
+            },
+        };
+    }
+    advisoryDiagnostics(diagnostics) {
+        return diagnostics.map(diagnostic => this.advisoryDiagnostic(diagnostic));
+    }
     connectedDevelopmentFailure(error, workspaceRoot) {
         const rawCode = String(error?.code ||
             (error instanceof Error ? error.message.split(":", 1)[0] : "") ||