openxiangda-devkit-core 2.0.0-alpha.115 → 2.0.0-alpha.118

package/dist/developer-operations.d.ts

@@ -1,57 +1,159 @@
 import type { OpenXiangdaApplicationServices } from './application-services.js';
 import type { DevkitResult } from 'openxiangda-contracts';
+import { type OperationProgressListener } from './operation-progress.js';
 export declare const DEVELOPER_ENVIRONMENTS: readonly ["test", "production"];
 export type DeveloperEnvironment = (typeof DEVELOPER_ENVIRONMENTS)[number];
 export declare function developerEnvironment(value?: string): "preproduction" | "production";
 export declare function checkApplication(services: OpenXiangdaApplicationServices, input?: {
     root?: string;
     environment?: string;
-}): Promise<DevkitResult<undefined> | DevkitResult<{
-    generated: {
-        output: string;
-        changed: boolean;
-        contractDigest: string;
-        aiCatalogDigest: string;
-    } | undefined;
-    compatibility: import("openxiangda-contracts").ConfigurationValidationResult | null;
-    stages: {
-        name: string;
-        state: "passed" | "failed" | "skipped";
-        ok: boolean;
-        exitCode: number | null;
-        output: string;
-    }[];
-    sealedArtifact: import("./application-services.js").SealedArtifactStatus;
-    appSpec: {
-        enabled: boolean;
-        mode: "advisory";
-        releaseGate: false;
-        workspaceDigest: string | null;
-        selectionDigest: string | null;
-        contextBudget: {
-            maximumBytes: number;
-            contentBytes: number;
-            truncated: boolean;
-            omitted: import("./app-spec.js").AppSpecDocumentSummary[];
+    local?: boolean;
+    onProgress?: OperationProgressListener;
+}): Promise<{
+    data: {
+        validationScope: string;
+        targetEnvironment: "preproduction" | "production" | null;
+        generated?: {
+            output: string;
+            changed: boolean;
+            contractDigest: string;
+            aiCatalogDigest: string;
+        } | undefined;
+        compatibility?: import("openxiangda-contracts").ConfigurationValidationResult | null;
+        stages?: {
+            name: string;
+            state: "passed" | "failed" | "skipped";
+            ok: boolean;
+            exitCode: number | null;
+            output: string;
+            reused?: boolean;
+        }[];
+        sealedArtifact?: import("./application-services.js").SealedArtifactStatus;
+        appSpec?: {
+            lifecycle: {
+                schemaVersion: "openxiangda.development-lifecycle/v1";
+                stage: "design-incomplete" | "ready-for-test";
+                readyForTest: boolean;
+                changeId: string | null;
+                acceptanceIds: string[];
+                currentSpecDigest: string | null;
+                diagnostics: import("openxiangda-contracts").Diagnostic[];
+                nextCommand: string;
+            };
+            enabled: boolean;
+            mode: "guided";
+            releaseGate: true;
+            workspaceDigest: string | null;
+            selectionDigest: string | null;
+            historyPage: {
+                offset: number;
+                limit: number;
+                total: number;
+                nextOffset: number | null;
+            };
+            contextBudget: {
+                maximumBytes: number;
+                contentBytes: number;
+                truncated: boolean;
+                omitted: import("./app-spec.js").AppSpecDocumentSummary[];
+            };
+            stats: {
+                files: number;
+                bytes: number;
+                capabilities: number;
+                activeChanges: number;
+                historyChanges: number;
+                decisions: number;
+                requirements: number;
+                acceptanceScenarios: number;
+            };
+            diagnostics: {
+                errors: number;
+                warnings: number;
+                info: number;
+            };
+            nextCommand: string;
         };
-        stats: {
-            files: number;
-            bytes: number;
-            capabilities: number;
-            activeChanges: number;
-            historyChanges: number;
-            decisions: number;
-            requirements: number;
-            acceptanceScenarios: number;
-        };
-        diagnostics: {
-            errors: number;
-            warnings: number;
-            info: number;
+    };
+    ok: boolean;
+    operation: string;
+    workspace: import("openxiangda-contracts").WorkspaceIdentity;
+    diagnostics: import("openxiangda-contracts").Diagnostic[];
+    nextActions: import("openxiangda-contracts").NextAction[];
+    traceId?: string;
+} | {
+    data: {
+        validationScope: string;
+        targetEnvironment: "preproduction" | "production" | null;
+        generated?: {
+            output: string;
+            changed: boolean;
+            contractDigest: string;
+            aiCatalogDigest: string;
+        } | undefined;
+        compatibility?: import("openxiangda-contracts").ConfigurationValidationResult | null;
+        stages?: {
+            name: string;
+            state: "passed" | "failed" | "skipped";
+            ok: boolean;
+            exitCode: number | null;
+            output: string;
+            reused?: boolean;
+        }[];
+        sealedArtifact?: import("./application-services.js").SealedArtifactStatus;
+        appSpec?: {
+            lifecycle: {
+                schemaVersion: "openxiangda.development-lifecycle/v1";
+                stage: "design-incomplete" | "ready-for-test";
+                readyForTest: boolean;
+                changeId: string | null;
+                acceptanceIds: string[];
+                currentSpecDigest: string | null;
+                diagnostics: import("openxiangda-contracts").Diagnostic[];
+                nextCommand: string;
+            };
+            enabled: boolean;
+            mode: "guided";
+            releaseGate: true;
+            workspaceDigest: string | null;
+            selectionDigest: string | null;
+            historyPage: {
+                offset: number;
+                limit: number;
+                total: number;
+                nextOffset: number | null;
+            };
+            contextBudget: {
+                maximumBytes: number;
+                contentBytes: number;
+                truncated: boolean;
+                omitted: import("./app-spec.js").AppSpecDocumentSummary[];
+            };
+            stats: {
+                files: number;
+                bytes: number;
+                capabilities: number;
+                activeChanges: number;
+                historyChanges: number;
+                decisions: number;
+                requirements: number;
+                acceptanceScenarios: number;
+            };
+            diagnostics: {
+                errors: number;
+                warnings: number;
+                info: number;
+            };
+            nextCommand: string;
         };
-        nextCommand: string;
     };
-}>>;
+    ok: boolean;
+    operation: string;
+    workspace: import("openxiangda-contracts").WorkspaceIdentity;
+    diagnostics: import("openxiangda-contracts").Diagnostic[];
+    nextActions: import("openxiangda-contracts").NextAction[];
+    traceId?: string;
+}>;
 export interface DeveloperDeploymentInput {
     root?: string;
     environment?: string;
@@ -59,6 +161,8 @@ export interface DeveloperDeploymentInput {
     environmentId?: string;
     idempotencyKey?: string;
     dryRun?: boolean;
+    wait?: boolean;
+    onProgress?: OperationProgressListener;
 }
 export declare function deployApplication(services: OpenXiangdaApplicationServices, input: DeveloperDeploymentInput): Promise<DevkitResult<unknown>>;
 //# sourceMappingURL=developer-operations.d.ts.map

package/dist/developer-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"developer-operations.d.ts","sourceRoot":"","sources":["../src/developer-operations.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,eAAO,MAAM,sBAAsB,iCAAkC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3E,wBAAgB,oBAAoB,CAAC,KAAK,GAAE,MAAe,kCAI1D;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,8BAA8B,EACxC,KAAK,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIpD;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,8BAA8B,EACxC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAoBhC"}
+{"version":3,"file":"developer-operations.d.ts","sourceRoot":"","sources":["../src/developer-operations.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAyB,KAAK,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAGhG,eAAO,MAAM,sBAAsB,iCAAkC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3E,wBAAgB,oBAAoB,CAAC,KAAK,GAAE,MAAe,kCAI1D;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,8BAA8B,EACxC,KAAK,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,yBAAyB,CAAA;CAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAQ7G;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,yBAAyB,CAAC;CACxC;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,8BAA8B,EACxC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAMhC"}

package/dist/developer-operations.js

@@ -1,6 +1,8 @@
 import { realpathSync } from 'node:fs';
 import { discoverWorkspace } from './workspace-loader.js';
 import { withWorkspaceOperation } from './workspace-operation.js';
+import { withOperationProgress } from './operation-progress.js';
+import { observeDeployment } from './deployment-observer.js';
 export const DEVELOPER_ENVIRONMENTS = ['test', 'production'];
 export function developerEnvironment(value = 'test') {
     if (value === 'test')
@@ -11,9 +13,21 @@ export function developerEnvironment(value = 'test') {
 }
 export function checkApplication(services, input = {}) {
     const environment = developerEnvironment(input.environment);
-    return withWorkspaceOperation(realpathSync(discoverWorkspace(input.root).root), 'check', () => services.check(input.root, environment));
+    if (input.local && input.environment === 'production')
+        throw new Error('LOCAL_CHECK_TARGET_CONFLICT: 本地检查不验证生产环境，请分别执行');
+    return withOperationProgress('check', input.onProgress, () => withWorkspaceOperation(realpathSync(discoverWorkspace(input.root).root), 'check', async () => {
+        const result = await services.check(input.root, input.local ? undefined : environment);
+        return { ...result, data: { ...result.data, validationScope: input.local ? 'local' : 'target', targetEnvironment: input.local ? null : environment } };
+    }));
 }
 export function deployApplication(services, input) {
+    validateDeploymentInput(input);
+    return withOperationProgress(input.dryRun ? 'deployment.plan' : 'deploy', input.onProgress, async () => {
+        const result = await executeDeployment(services, input);
+        return input.dryRun || input.wait === false ? result : observeDeployment(services, result, input);
+    });
+}
+function validateDeploymentInput(input) {
     const environment = developerEnvironment(input.environment);
     if (environment === 'production') {
         if (!input.from)
@@ -21,12 +35,17 @@ export function deployApplication(services, input) {
         if (input.environmentId || input.idempotencyKey) {
             throw new Error('PRODUCTION_DEPLOYMENT_OPTIONS_INVALID: 生产晋级由指定测试运行确定目标版本和幂等身份');
         }
+    }
+    else if (input.from)
+        throw new Error('DEPLOY_TEST_FROM_INVALID: from 仅用于 production 晋级');
+}
+async function executeDeployment(services, input) {
+    const environment = developerEnvironment(input.environment);
+    if (environment === 'production') {
         return input.dryRun
             ? services.productionDeploymentPlan(input.root, input.from)
             : services.deployProduction(input.root, input.from);
     }
-    if (input.from)
-        throw new Error('DEPLOY_TEST_FROM_INVALID: from 仅用于 production 晋级');
     return input.dryRun
         ? services.deploymentPlan({ ...(input.root ? { root: input.root } : {}), environment })
         : withWorkspaceOperation(realpathSync(discoverWorkspace(input.root).root), 'deploy', () => services.deploy({

package/dist/developer-operations.js.map

@@ -1 +1 @@
-{"version":3,"file":"developer-operations.js","sourceRoot":"","sources":["../src/developer-operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAIlE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,MAAM,EAAE,YAAY,CAAU,CAAC;AAGtE,MAAM,UAAU,oBAAoB,CAAC,QAAgB,MAAM;IACzD,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,eAAwB,CAAC;IACtD,IAAI,KAAK,KAAK,YAAY;QAAE,OAAO,YAAqB,CAAC;IACzD,MAAM,IAAI,KAAK,CAAC,6DAA6D,KAAK,EAAE,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAAwC,EACxC,QAAiD,EAAE;IAEnD,MAAM,WAAW,GAAG,oBAAoB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC5D,OAAO,sBAAsB,CAAC,YAAY,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;AAC1I,CAAC;AAWD,MAAM,UAAU,iBAAiB,CAC/B,QAAwC,EACxC,KAA+B;IAE/B,MAAM,WAAW,GAAG,oBAAoB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC5D,IAAI,WAAW,KAAK,YAAY,EAAE,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QAClG,IAAI,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,KAAK,CAAC,MAAM;YACjB,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC;YAC3D,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,KAAK,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACpF,OAAO,KAAK,CAAC,MAAM;QACjB,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC;QACvF,CAAC,CAAC,sBAAsB,CAAC,YAAY,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;YACvG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,WAAW;YACX,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1E,CAAC,CAAC,CAAC;AACV,CAAC"}
+{"version":3,"file":"developer-operations.js","sourceRoot":"","sources":["../src/developer-operations.ts"],"names":[],"mappings":"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"}

package/dist/development-lifecycle.d.ts

@@ -0,0 +1,48 @@
+import { type DeploymentRun, type Diagnostic } from 'openxiangda-contracts';
+import { type AppSpecContractIndex } from './app-spec.js';
+/** 按发布阶段评估事实完整性；不推断用户确认，也不将章节存在当作业务验收。 */
+export declare function developmentLifecycle(root: string, contract: AppSpecContractIndex, message?: string): {
+    schemaVersion: "openxiangda.development-lifecycle/v1";
+    stage: "design-incomplete" | "ready-for-test";
+    readyForTest: boolean;
+    changeId: string | null;
+    acceptanceIds: string[];
+    currentSpecDigest: string | null;
+    diagnostics: Diagnostic[];
+    nextCommand: string;
+    context: import("./app-spec.js").AppSpecContext;
+};
+export declare function summarizeLifecycle(value: ReturnType<typeof developmentLifecycle>): {
+    schemaVersion: "openxiangda.development-lifecycle/v1";
+    stage: "design-incomplete" | "ready-for-test";
+    readyForTest: boolean;
+    changeId: string | null;
+    acceptanceIds: string[];
+    currentSpecDigest: string | null;
+    diagnostics: Diagnostic[];
+    nextCommand: string;
+};
+/** 生产验收按测试版本中的需求计划核对，当前主线后来增加的规则不会冒充已测规则。 */
+export declare function lifecycleAtCommit(root: string, commit: string, contract: AppSpecContractIndex): {
+    schemaVersion: "openxiangda.development-lifecycle/v1";
+    stage: "design-incomplete" | "ready-for-test";
+    readyForTest: boolean;
+    changeId: string | null;
+    acceptanceIds: string[];
+    currentSpecDigest: string | null;
+    diagnostics: Diagnostic[];
+    nextCommand: string;
+    context: import("./app-spec.js").AppSpecContext;
+};
+export declare function verifyBusinessAcceptance(root: string, run: DeploymentRun, expected: {
+    changeId: string | null;
+    acceptanceIds: string[];
+}, pathInput?: string): {
+    ok: boolean;
+    path: string;
+    sourceDeploymentId: string;
+    packageDigest: string;
+    scenarios: any;
+    diagnostics: Diagnostic[];
+};
+//# sourceMappingURL=development-lifecycle.d.ts.map

package/dist/development-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"development-lifecycle.d.ts","sourceRoot":"","sources":["../src/development-lifecycle.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmB,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC7F,OAAO,EAAkB,KAAK,oBAAoB,EAAwB,MAAM,eAAe,CAAC;AA0BhG,0CAA0C;AAC1C,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,EAAE,OAAO,SAAoB;;;;;;;;;;EAiC7G;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC;;;;;;;;;EAGhF;AAED,6CAA6C;AAC7C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB;;;;;;;;;;EAqB7F;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,SAAS,CAAC,EAAE,MAAM;;;;;;;EA6C5J"}

package/dist/development-lifecycle.js

@@ -0,0 +1,180 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname, join, relative, resolve } from 'node:path';
+import { tmpdir } from 'node:os';
+import { SCHEMA_VERSIONS } from 'openxiangda-contracts';
+import { inspectAppSpec } from './app-spec.js';
+const APP_SECTIONS = ['业务目标', '角色', '架构与数据关系', '业务任务与页面', '权限矩阵与确认', '性能与容量预算'];
+const CHANGE_SECTIONS = ['为什么', '需求依据', '方案与影响', '任务与实现', '验收', '性能与容量预算'];
+function issue(code, message, path) {
+    return { schemaVersion: SCHEMA_VERSIONS.diagnostic, severity: 'error', retryable: false, code, message, path, remediation: '依据实际业务补齐对应记录；运行 openxiangda spec context --json 查看阶段缺口，不能填写虚假确认或通过结果' };
+}
+function section(content, title) {
+    const source = content.replace(/<!--[\s\S]*?-->/g, '');
+    const start = source.indexOf(`\n## ${title}\n`);
+    if (start < 0)
+        return '';
+    return source.slice(start + title.length + 5).split(/\n## /)[0] || '';
+}
+function meaningful(content) {
+    return content.split('\n').map(line => line.replace(/^\s*[-*]\s*(?:\[[ x]\]\s*)?/, '').trim())
+        .filter(line => line && !line.startsWith('|') && !line.startsWith('#') && !/^(待补充|待确认|TBD|TODO|无。?|一个可观察的正向结果|需要时补充拒绝、异常或权限反例)$/.test(line)).join('\n').length >= 8
+        || content.split('\n').filter(line => line.trim().startsWith('|') && !/^[|\s:-]+$/.test(line)).length >= 2;
+}
+function boundedGit(root, args, maxBuffer = 2 * 1024 * 1024) {
+    return execFileSync('git', ['-C', root, ...args], { encoding: 'utf8', timeout: 10_000, maxBuffer, stdio: ['ignore', 'pipe', 'pipe'] }).trim();
+}
+function headMessage(root) {
+    try {
+        return boundedGit(root, ['log', '-1', '--format=%B']);
+    }
+    catch {
+        return '';
+    }
+}
+/** 按发布阶段评估事实完整性；不推断用户确认，也不将章节存在当作业务验收。 */
+export function developmentLifecycle(root, contract, message = headMessage(root)) {
+    const index = inspectAppSpec(root, contract);
+    const explicit = message.match(/^AppSpec:\s*([a-z0-9]+(?:-[a-z0-9]+)*)\s*$/m)?.[1];
+    const changeId = explicit || (index.index.activeChanges.length === 1 ? index.index.activeChanges[0]?.id : undefined);
+    const context = changeId ? inspectAppSpec(root, contract, changeId) : index;
+    const change = [...context.activeChanges, ...context.archivedChanges].find(item => item.id === changeId);
+    const diagnostics = context.diagnostics.filter(item => item.severity === 'error');
+    const app = context.application;
+    if (!app)
+        diagnostics.push(issue('APPSPEC_APPLICATION_REQUIRED', '正式发布需要应用总纲；运行 openxiangda spec init 后填写实际目标、权限、架构和容量', 'appspec/app.md'));
+    else
+        for (const title of APP_SECTIONS) {
+            if (!meaningful(section(app.content, title)))
+                diagnostics.push(issue('APPSPEC_APPLICATION_SECTION_INCOMPLETE', `应用总纲“${title}”尚无具体记录`, `${app.path}#${title}`));
+        }
+    if (!change)
+        diagnostics.push(issue('APPSPEC_DELIVERY_CHANGE_REQUIRED', '需要关联本轮变更；有多个活动变更或引用历史记录时，在提交说明加入 AppSpec: <变更ID>', 'appspec/changes/active'));
+    else {
+        for (const title of CHANGE_SECTIONS) {
+            if (!meaningful(section(change.content, title)))
+                diagnostics.push(issue('APPSPEC_CHANGE_SECTION_INCOMPLETE', `变更“${title}”尚无具体记录`, `${change.path}#${title}`));
+        }
+        if (change.status === 'draft' || change.status === 'cancelled')
+            diagnostics.push(issue('APPSPEC_CHANGE_NOT_READY', '变更仍是草稿或已取消；先澄清业务含义并记录实际依据，再进入 implementing', change.path));
+    }
+    for (const document of [app, change].filter((item) => !!item)) {
+        if (/^- \[ \]/m.test(section(document.content, '未确认问题')))
+            diagnostics.push(issue('APPSPEC_BLOCKING_QUESTIONS', '仍有影响正式交付的未确认问题；非阻断假设单独记录，不冒充用户确认', `${document.path}#未确认问题`));
+    }
+    const acceptanceIds = [...new Set([...(app?.acceptanceIds || []), ...(change?.acceptanceIds || []), ...context.capabilities.flatMap(item => item.acceptanceIds)])];
+    if (change && !acceptanceIds.length)
+        diagnostics.push(issue('APPSPEC_ACCEPTANCE_PLAN_REQUIRED', '至少定义一个 #### AC-* 可观察验收场景，供测试部署后逐项验证', `${change.path}#验收`));
+    return {
+        schemaVersion: 'openxiangda.development-lifecycle/v1',
+        stage: diagnostics.length ? 'design-incomplete' : 'ready-for-test',
+        readyForTest: !diagnostics.length, changeId: change?.id || null, acceptanceIds,
+        currentSpecDigest: context.selectionDigest,
+        diagnostics,
+        nextCommand: changeId ? `openxiangda spec context ${changeId} --json` : 'openxiangda spec context --json',
+        context,
+    };
+}
+export function summarizeLifecycle(value) {
+    const { context, ...summary } = value;
+    return summary;
+}
+/** 生产验收按测试版本中的需求计划核对，当前主线后来增加的规则不会冒充已测规则。 */
+export function lifecycleAtCommit(root, commit, contract) {
+    if (!/^[a-f0-9]{40,64}$/.test(commit))
+        throw new Error('APPSPEC_SOURCE_COMMIT_INVALID');
+    const scratch = mkdtempSync(join(tmpdir(), 'openxiangda-spec-source-'));
+    try {
+        const message = boundedGit(root, ['log', '-1', '--format=%B', commit]);
+        const selected = message.match(/^AppSpec:\s*([a-z0-9]+(?:-[a-z0-9]+)*)\s*$/m)?.[1];
+        const paths = boundedGit(root, ['ls-tree', '-r', '--name-only', commit, '--', 'appspec']).split('\n').filter(path => /^appspec\/(?:app\.md|capabilities\/[^/]+\.md|decisions\/[^/]+\.md|changes\/active\/[^/]+\.md)$/.test(path)
+            || (selected && new RegExp(`^appspec/changes/history/[^/]+/${selected}\\.md$`).test(path)));
+        if (paths.length > 128)
+            throw new Error('APPSPEC_SOURCE_FILE_LIMIT');
+        let bytes = 0;
+        for (const path of paths) {
+            const content = boundedGit(root, ['show', `${commit}:${path}`], 256 * 1024);
+            bytes += Buffer.byteLength(content);
+            if (bytes > 2 * 1024 * 1024)
+                throw new Error('APPSPEC_SOURCE_SIZE_LIMIT');
+            const target = join(scratch, path);
+            mkdirSync(dirname(target), { recursive: true });
+            writeFileSync(target, `${content}\n`);
+        }
+        return developmentLifecycle(scratch, contract, message);
+    }
+    finally {
+        rmSync(scratch, { recursive: true, force: true });
+    }
+}
+export function verifyBusinessAcceptance(root, run, expected, pathInput) {
+    const defaultPath = `appspec/verification/${run.id}.json`;
+    const path = resolve(root, pathInput || defaultPath);
+    const local = relative(root, path).replaceAll('\\', '/');
+    const diagnostics = [];
+    function evidenceExists(value) {
+        if (typeof value !== 'string' || !value.trim())
+            return false;
+        if (value.startsWith('https://')) {
+            try {
+                return !!new URL(value).hostname;
+            }
+            catch {
+                return false;
+            }
+        }
+        const path = resolve(root, value);
+        const local = relative(root, path);
+        if (!local || local.startsWith('..'))
+            return false;
+        try {
+            let current = root;
+            for (const name of local.split(/[\\/]/)) {
+                current = join(current, name);
+                if (lstatSync(current).isSymbolicLink())
+                    return false;
+            }
+            return lstatSync(path).isFile();
+        }
+        catch {
+            return false;
+        }
+    }
+    try {
+        if (!/^appspec\/verification\/[a-zA-Z0-9._-]+\.json$/.test(local))
+            throw new Error('验收报告应位于 appspec/verification/ 中');
+        for (const part of ['appspec', 'appspec/verification', local]) {
+            if (lstatSync(join(root, part)).isSymbolicLink())
+                throw new Error('验收报告路径不能使用符号链接');
+        }
+        if (!existsSync(path) || lstatSync(path).size > 1024 * 1024)
+            throw new Error('验收报告缺失或超过 1 MiB');
+        const report = JSON.parse(readFileSync(path, 'utf8'));
+        if (report.schemaVersion !== 'openxiangda.business-verification/v1' || report.appCode !== run.appCode || report.sourceDeploymentId !== run.id || report.packageDigest !== run.packageDigest || !expected.changeId || report.changeId !== expected.changeId || run.status !== 'succeeded' || run.environment.kind !== 'preproduction')
+            throw new Error('验收报告未绑定指定成功测试运行、包摘要与变更');
+        if (!Number.isFinite(Date.parse(report.recordedAt)) || !Array.isArray(report.scenarios) || !report.scenarios.length || report.scenarios.length > 500 || !Array.isArray(report.performance) || !report.performance.length || report.performance.length > 100)
+            throw new Error('报告需要记录时间、具体场景与性能测量');
+        const seen = new Set();
+        for (const scenario of report.scenarios) {
+            if (!/^AC-[A-Z0-9-]+$/.test(scenario.id) || seen.has(scenario.id) || scenario.status !== 'passed' || !meaningful(String(scenario.observation || '')) || !String(scenario.actor || '').trim() || !Array.isArray(scenario.evidence) || !scenario.evidence.some((value) => typeof value === 'string' && value.trim().length >= 4))
+                throw new Error('验收场景必须有唯一 AC ID、已通过结果、实际角色、观察与证据引用；失败或未测场景不能晋级');
+            seen.add(scenario.id);
+            if (!scenario.evidence.every(evidenceExists))
+                throw new Error('场景证据需要工作区内实际存在的文件或 HTTPS 引用');
+        }
+        if (expected.acceptanceIds.some(id => !seen.has(id)))
+            throw new Error('测试版本计划中的验收场景尚未全部覆盖');
+        for (const measurement of report.performance) {
+            if (!meaningful(String(measurement.scenario || '')) || !meaningful(String(measurement.sample || '')) || typeof measurement.targetMs !== 'number' || !Number.isFinite(measurement.targetMs) || measurement.targetMs <= 0 || typeof measurement.observedMs !== 'number' || !Number.isFinite(measurement.observedMs) || measurement.observedMs < 0 || measurement.observedMs > measurement.targetMs || !Array.isArray(measurement.evidence) || !measurement.evidence.length)
+                throw new Error('性能记录需要真实样本、目标毫秒数、实测毫秒数及证据；超出目标时先评估并修复');
+            if (!measurement.evidence.every(evidenceExists))
+                throw new Error('性能证据需要工作区内实际存在的文件或 HTTPS 引用');
+        }
+        return { ok: true, path: local, sourceDeploymentId: run.id, packageDigest: run.packageDigest, scenarios: report.scenarios.length, diagnostics };
+    }
+    catch (error) {
+        diagnostics.push(issue('APPSPEC_BUSINESS_ACCEPTANCE_REQUIRED', `生产晋级前需要该测试版本的实际验收报告：${error.message}`, local));
+        return { ok: false, path: local, sourceDeploymentId: run.id, packageDigest: run.packageDigest, scenarios: 0, diagnostics };
+    }
+}
+//# sourceMappingURL=development-lifecycle.js.map

package/dist/development-lifecycle.js.map

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

package/dist/documentation.d.ts

@@ -13,7 +13,7 @@ export declare const DOCUMENTATION_TOPICS: readonly [{
     readonly file: "application-foundation.md";
 }, {
     readonly id: "appspec";
-    readonly title: "可选的业务需求记录";
+    readonly title: "需求、设计与交付记录";
     readonly file: "appspec.md";
 }, {
     readonly id: "concepts";
@@ -68,14 +68,14 @@ export declare const DOCUMENTATION_TOPICS: readonly [{
     readonly title: "MCP 配置与工具参考";
     readonly file: "reference/mcp.md";
 }];
-/** Skill 参考文件名保留稳定入口，正文仍由中文主题生成。 */
+/** Skill 参考文件名直接使用主题 ID，正文由同一中文主题生成。 */
 export declare function documentationReferenceFile(id: string): string;
 export declare function documentationRoot(): string;
 export declare function documentationIndex(root?: string): {
     schemaVersion: string;
     topics: {
         id: "appspec" | "delivery" | "frontend" | "backend" | "getting-started" | "development" | "application-foundation" | "concepts" | "field-components" | "data-authz" | "public-access" | "workflow-events" | "administration" | "testing" | "upgrading" | "cli" | "mcp";
-        title: "CLI 命令参考" | "安装与开始开发" | "需求与开发流程" | "业务模型与标准 CRUD" | "可选的业务需求记录" | "架构与能力所有者" | "页面与标准组件扩展" | "字段、表单与移动控件" | "数据查询与权限" | "无账号的匿名公开访问" | "审批、事件与通知" | "按需后端与业务动作" | "应用管理与有效配置" | "检查与真实业务验收" | "部署、生产晋级与恢复" | "版本升级与资料刷新" | "MCP 配置与工具参考";
+        title: "CLI 命令参考" | "安装与开始开发" | "需求与开发流程" | "业务模型与标准 CRUD" | "需求、设计与交付记录" | "架构与能力所有者" | "页面与标准组件扩展" | "字段、表单与移动控件" | "数据查询与权限" | "无账号的匿名公开访问" | "审批、事件与通知" | "按需后端与业务动作" | "应用管理与有效配置" | "检查与真实业务验收" | "部署、生产晋级与恢复" | "版本升级与资料刷新" | "MCP 配置与工具参考";
         uri: string;
         version: string;
         sha256: string;
@@ -89,7 +89,7 @@ export declare function documentationIndex(root?: string): {
 export declare function readDocumentation(id: string, section?: string, root?: string): {
     schemaVersion: string;
     topic: string;
-    title: "CLI 命令参考" | "安装与开始开发" | "需求与开发流程" | "业务模型与标准 CRUD" | "可选的业务需求记录" | "架构与能力所有者" | "页面与标准组件扩展" | "字段、表单与移动控件" | "数据查询与权限" | "无账号的匿名公开访问" | "审批、事件与通知" | "按需后端与业务动作" | "应用管理与有效配置" | "检查与真实业务验收" | "部署、生产晋级与恢复" | "版本升级与资料刷新" | "MCP 配置与工具参考";
+    title: "CLI 命令参考" | "安装与开始开发" | "需求与开发流程" | "业务模型与标准 CRUD" | "需求、设计与交付记录" | "架构与能力所有者" | "页面与标准组件扩展" | "字段、表单与移动控件" | "数据查询与权限" | "无账号的匿名公开访问" | "审批、事件与通知" | "按需后端与业务动作" | "应用管理与有效配置" | "检查与真实业务验收" | "部署、生产晋级与恢复" | "版本升级与资料刷新" | "MCP 配置与工具参考";
     version: string;
     sha256: string;
     uri: string;

package/dist/documentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documentation.d.ts","sourceRoot":"","sources":["../src/documentation.ts"],"names":[],"mappings":"AAIA,8BAA8B;AAC9B,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBvB,CAAC;AAEX,oCAAoC;AACpC,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,MAAM,UAGpD;AAID,wBAAgB,iBAAiB,WAEhC;AA4CD,wBAAgB,kBAAkB,CAAC,IAAI,SAAsB;;;;;;;;;;;;;;EAW5D;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,SAAsB;;;;;;;;;;;;EAWzF;AAED,wBAAgB,6BAA6B,WAI5C"}
+{"version":3,"file":"documentation.d.ts","sourceRoot":"","sources":["../src/documentation.ts"],"names":[],"mappings":"AAIA,8BAA8B;AAC9B,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBvB,CAAC;AAEX,wCAAwC;AACxC,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,MAAM,UAEpD;AAID,wBAAgB,iBAAiB,WAEhC;AA4CD,wBAAgB,kBAAkB,CAAC,IAAI,SAAsB;;;;;;;;;;;;;;EAW5D;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,SAAsB;;;;;;;;;;;;EAWzF;AAED,wBAAgB,6BAA6B,WAI5C"}

package/dist/documentation.js

@@ -6,7 +6,7 @@ export const DOCUMENTATION_TOPICS = [
     { id: 'getting-started', title: '安装与开始开发', file: 'getting-started.md' },
     { id: 'development', title: '需求与开发流程', file: 'development.md' },
     { id: 'application-foundation', title: '业务模型与标准 CRUD', file: 'application-foundation.md' },
-    { id: 'appspec', title: '可选的业务需求记录', file: 'appspec.md' },
+    { id: 'appspec', title: '需求、设计与交付记录', file: 'appspec.md' },
     { id: 'concepts', title: '架构与能力所有者', file: 'concepts.md' },
     { id: 'frontend', title: '页面与标准组件扩展', file: 'frontend.md' },
     { id: 'field-components', title: '字段、表单与移动控件', file: 'field-components.md' },
@@ -21,10 +21,9 @@ export const DOCUMENTATION_TOPICS = [
     { id: 'cli', title: 'CLI 命令参考', file: 'reference/cli.md' },
     { id: 'mcp', title: 'MCP 配置与工具参考', file: 'reference/mcp.md' },
 ];
-/** Skill 参考文件名保留稳定入口，正文仍由中文主题生成。 */
+/** Skill 参考文件名直接使用主题 ID，正文由同一中文主题生成。 */
 export function documentationReferenceFile(id) {
-    const aliases = { development: 'discovery', concepts: 'architecture', cli: 'commands' };
-    return `${aliases[id] || id}.md`;
+    return `${id}.md`;
 }
 const MAX_TOPIC_BYTES = 128 * 1024;
 export function documentationRoot() {
@@ -33,7 +32,7 @@ export function documentationRoot() {
 function topicSource(id, root) {
     const topic = DOCUMENTATION_TOPICS.find(item => item.id === id);
     if (!topic)
-        throw new Error(`DOCUMENTATION_TOPIC_NOT_FOUND: 未知主题 ${id}，运行 pnpm openxiangda docs 查看目录`);
+        throw new Error(`DOCUMENTATION_TOPIC_NOT_FOUND: 未知主题 ${id}。CLI 运行 pnpm openxiangda docs，MCP 调用 docs_read 并省略 topic，按目录中的 id 读取正文`);
     const path = resolve(root, topic.file);
     if (!existsSync(path))
         throw new Error(`DOCUMENTATION_NOT_INSTALLED: 当前安装缺少 ${id}，请通过同版本 openxiangda 根包启动`);