openxiangda-cli 2.0.0-alpha.98 → 2.0.0

package/dist/commands/cancel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.js","sourceRoot":"","sources":["../../src/commands/cancel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,kBAAkB;IACpD,MAAM,CAAC,OAAO,GAAG,2BAA2B,CAAC;IAC7C,MAAM,CAAC,IAAI,GAAG,EAAE,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAChE,MAAM,CAAC,KAAK,GAAG,cAAc,CAAC;IAE9B,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,OAAO,CACjB,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,YAAY,CAAC,CACzD,CAAC;IACJ,CAAC"}

package/dist/commands/check.d.ts

@@ -2,21 +2,30 @@ import { OpenXiangdaCommand } from '../base.js';
 export default class Check extends OpenXiangdaCommand {
     static summary: string;
     static flags: {
+        local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        environment: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        "json-events": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "run-id": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         cwd: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<import("openxiangda-contracts").DevkitResult<unknown> | {
-        schemaVersion: string;
+        schemaVersion: "openxiangda.cli-result/v2";
         ok: boolean;
         operation: string;
-        workspace: import("openxiangda-contracts").WorkspaceIdentity;
+        workspace: import("openxiangda-contracts").WorkspaceIdentity | {
+            appCode: string;
+            name: string | undefined;
+        };
         data: {} | null;
         error: {
+            details?: Record<string, unknown>;
+            pointer?: string;
             code: string;
             message: string;
             retryable: boolean;
             remediation: string;
             nextCommand: string | null;
         } | null;
-    }>;
+    } | undefined>;
 }
 //# sourceMappingURL=check.d.ts.map

package/dist/commands/check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAkB,MAAM,YAAY,CAAC;AAChE,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,kBAAkB;IACnD,MAAM,CAAC,OAAO,SAAe;IAC7B,MAAM,CAAC,KAAK;;MAAkB;IACxB,GAAG;;;;;;;;;;;;;;CACV"}
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAwB,MAAM,YAAY,CAAC;AAGtE,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,kBAAkB;IACnD,MAAM,CAAC,OAAO,SAAqB;IACnC,MAAM,CAAC,KAAK;;;;;;MAQV;IAEI,GAAG;;;;;;;;;;;;;;;;;;;CAQV"}

package/dist/commands/check.js

@@ -1,7 +1,24 @@
-import { OpenXiangdaCommand, workspaceFlags } from '../base.js';
+import { Flags } from '@oclif/core';
+import { OpenXiangdaCommand, studioWorkspaceFlags } from '../base.js';
+import { checkApplication, DEVELOPER_ENVIRONMENTS } from 'openxiangda-devkit-core';
 export default class Check extends OpenXiangdaCommand {
-    static summary = '确定性检查完整应用';
-    static flags = workspaceFlags;
-    async run() { const { flags } = await this.parse(Check); return this.present(await this.services.check(flags.cwd)); }
+    static summary = '针对目标平台确定性检查完整应用';
+    static flags = {
+        ...studioWorkspaceFlags,
+        local: Flags.boolean({ summary: '只执行本地完整校验与构建，不验证目标平台；适用于 CI 和候选包验证', default: false }),
+        environment: Flags.string({
+            options: [...DEVELOPER_ENVIRONMENTS],
+            default: 'test',
+            summary: '兼容性预检目标；默认为 test',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Check);
+        this.beginStudioEvents('check');
+        return this.present(await checkApplication(this.services, {
+            onProgress: event => this.presentOperationProgress(event),
+            ...(flags.cwd ? { root: flags.cwd } : {}), environment: flags.environment, local: flags.local,
+        }));
+    }
 }
 //# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

@@ -1 +1 @@
-{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAChE,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,kBAAkB;IACnD,MAAM,CAAC,OAAO,GAAG,WAAW,CAAC;IAC7B,MAAM,CAAC,KAAK,GAAG,cAAc,CAAC;IAC9B,KAAK,CAAC,GAAG,KAAK,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEnF,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,kBAAkB;IACnD,MAAM,CAAC,OAAO,GAAG,iBAAiB,CAAC;IACnC,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,oBAAoB;QACvB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACvF,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC;YACxB,OAAO,EAAE,CAAC,GAAG,sBAAsB,CAAC;YACpC,OAAO,EAAE,MAAM;YACf,OAAO,EAAE,kBAAkB;SAC5B,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE;YACxD,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC;YACzD,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK;SAC9F,CAAC,CAAC,CAAC;IACN,CAAC"}

package/dist/commands/context.d.ts

@@ -0,0 +1,27 @@
+import { OpenXiangdaCommand } from '../base.js';
+export default class Context extends OpenXiangdaCommand {
+    static summary: string;
+    static flags: {
+        cwd: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<import("openxiangda-contracts").DevkitResult<unknown> | {
+        schemaVersion: "openxiangda.cli-result/v2";
+        ok: boolean;
+        operation: string;
+        workspace: import("openxiangda-contracts").WorkspaceIdentity | {
+            appCode: string;
+            name: string | undefined;
+        };
+        data: {} | null;
+        error: {
+            details?: Record<string, unknown>;
+            pointer?: string;
+            code: string;
+            message: string;
+            retryable: boolean;
+            remediation: string;
+            nextCommand: string | null;
+        } | null;
+    } | undefined>;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/commands/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAkB,MAAM,YAAY,CAAC;AAEhE,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,kBAAkB;IACrD,MAAM,CAAC,OAAO,SAA0B;IACxC,MAAM,CAAC,KAAK;;MAAkB;IACxB,GAAG;;;;;;;;;;;;;;;;;;;CAIV"}

package/dist/commands/context.js

@@ -0,0 +1,10 @@
+import { OpenXiangdaCommand, workspaceFlags } from '../base.js';
+export default class Context extends OpenXiangdaCommand {
+    static summary = '只读查看当前工作区、工具链版本与平台绑定';
+    static flags = workspaceFlags;
+    async run() {
+        const { flags } = await this.parse(Context);
+        return this.present(await this.services.workspaceContext(flags.cwd));
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,kBAAkB;IACrD,MAAM,CAAC,OAAO,GAAG,sBAAsB,CAAC;IACxC,MAAM,CAAC,KAAK,GAAG,cAAc,CAAC;IAC9B,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACvE,CAAC"}

package/dist/commands/create.d.ts

@@ -4,20 +4,37 @@ export default class Create extends OpenXiangdaCommand {
     static args: {
         directory: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
+    static flags: {
+        "base-url": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "app-code": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "template-ref": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "template-digest": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "studio-project-id": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "provisioning-run-id": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "json-events": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "run-id": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
     run(): Promise<import("openxiangda-contracts").DevkitResult<unknown> | {
-        schemaVersion: string;
+        schemaVersion: "openxiangda.cli-result/v2";
         ok: boolean;
         operation: string;
-        workspace: import("openxiangda-contracts").WorkspaceIdentity;
+        workspace: import("openxiangda-contracts").WorkspaceIdentity | {
+            appCode: string;
+            name: string | undefined;
+        };
         data: {} | null;
         error: {
+            details?: Record<string, unknown>;
+            pointer?: string;
             code: string;
             message: string;
             retryable: boolean;
             remediation: string;
             nextCommand: string | null;
         } | null;
-    }>;
+    } | undefined>;
+    private studioCompilerSummary;
     private reuseWorkspace;
 }
 //# sourceMappingURL=create.d.ts.map

package/dist/commands/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAOhD,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,kBAAkB;IACpD,MAAM,CAAC,OAAO,SAAmC;IACjD,MAAM,CAAC,IAAI;;MAET;IAEI,GAAG;;;;;;;;;;;;;;YAkEK,cAAc;CAsB7B"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,kBAAkB,EAAoB,MAAM,YAAY,CAAC;AAelE,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,kBAAkB;IACpD,MAAM,CAAC,OAAO,SAA8B;IAC5C,MAAM,CAAC,IAAI;;MAET;IACF,MAAM,CAAC,KAAK;;;;;;;;;;MA4BV;IAEI,GAAG;;;;;;;;;;;;;;;;;;;YAsQK,qBAAqB;YAuBrB,cAAc;CAoE7B"}

package/dist/commands/create.js

@@ -1,42 +1,245 @@
-import { Args } from "@oclif/core";
-import { existsSync, readdirSync } from "node:fs";
-import { basename, resolve } from "node:path";
-import { OpenXiangdaDeveloperSession } from "openxiangda-devkit-core";
-import { OpenXiangdaCommand } from "../base.js";
-import { createWorkspace, prepareWorkspace, } from "../create-workspace.js";
+import { Args, Flags } from "@oclif/core";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { basename, join, resolve } from "node:path";
+import { normalizePlatformBaseUrl, OpenXiangdaDeveloperSession } from "openxiangda-devkit-core";
+import { OPENXIANGDA_COMPILER_CONTRACT_VERSION, STUDIO_APPLICATION_AUTHORITY, STUDIO_WORKSPACE_INITIALIZATION_SCHEMA_VERSION, STUDIO_WORKSPACE_PROTOCOL_VERSION, } from "openxiangda-contracts";
+import { OpenXiangdaCommand, studioEventFlags } from "../base.js";
+import { createWorkspace, ensureStudioWorkspaceBinding, isPlatformUuid, prepareWorkspace, readStudioWorkspaceBinding, readWorkspaceTemplateBinding, resolveWorkspaceTemplate, studioWorkspaceBindingDigest, studioWorkspaceInitializationDigest, } from "../create-workspace.js";
+import { resolveCliToolchainCapsule } from "../toolchain-capsule.js";
 export default class Create extends OpenXiangdaCommand {
-    static summary = "创建、绑定并幂等初始化 React + NestJS 应用";
+    static summary = "创建并绑定 React 应用，按业务需要启用后端";
     static args = {
         directory: Args.string({ required: true, summary: "应用目录" }),
     };
+    static flags = {
+        ...studioEventFlags,
+        "base-url": Flags.string({
+            summary: "新应用的目标平台；已有工作区必须与原绑定一致",
+            helpValue: "<platform>",
+        }),
+        "app-code": Flags.string({
+            summary: "显式应用代码；默认从目录名推导",
+            helpValue: "<kebab-case>",
+        }),
+        name: Flags.string({ summary: "显式应用名称；默认使用目录名" }),
+        "template-ref": Flags.string({
+            summary: "builtin:application 或已物化的本地模板目录",
+            helpValue: "<ref>",
+        }),
+        "template-digest": Flags.string({
+            summary: "模板内容摘要 sha256:<64位小写十六进制>",
+            helpValue: "<sha256:digest>",
+            dependsOn: ["template-ref"],
+        }),
+        "studio-project-id": Flags.string({
+            summary: "站点 Project UUID；启用站点权威的 Studio 初始化模式",
+            helpValue: "<uuid>",
+        }),
+        "provisioning-run-id": Flags.string({
+            summary: "站点 ProjectProvisioningRun UUID",
+            helpValue: "<uuid>",
+        }),
+    };
     async run() {
-        const { args } = await this.parse(Create);
+        const { args, flags } = await this.parse(Create);
+        this.beginStudioEvents("create");
         const root = resolve(args.directory);
         const directoryName = basename(root);
-        const appCode = deriveAppCode(directoryName);
-        const name = directoryName;
-        const installOutput = this.jsonEnabled()
+        const appCode = flags["app-code"] || deriveAppCode(directoryName);
+        const name = flags.name || directoryName;
+        const studioMode = Boolean(flags["studio-project-id"] || flags["provisioning-run-id"]);
+        if (Boolean(flags["template-ref"]) !== Boolean(flags["template-digest"])) {
+            throw new Error("TEMPLATE_REF_DIGEST_PAIR_REQUIRED: --template-ref 与 --template-digest 必须一起提供");
+        }
+        const templateInput = flags["template-ref"]
+            ? {
+                templateRef: flags["template-ref"],
+                templateDigest: flags["template-digest"],
+            }
+            : {};
+        if (studioMode) {
+            assertStudioCreateInput({
+                appCode: flags["app-code"],
+                name: flags.name,
+                templateRef: flags["template-ref"],
+                templateDigest: flags["template-digest"],
+                projectId: flags["studio-project-id"],
+                provisioningRunId: flags["provisioning-run-id"],
+                jsonEvents: flags["json-events"],
+                runId: flags["run-id"],
+            });
+        }
+        const baseUrl = resolveCreatePlatform(root, appCode, flags["base-url"] || process.env.OPENXIANGDA_BASE_URL, studioMode);
+        const retryCommand = renderCreateRetryCommand(root, {
+            baseUrl,
+            ...(flags["app-code"] ? { appCode } : {}),
+            ...(flags.name ? { name } : {}),
+            ...templateInput,
+        });
+        const installOutput = this.machineOutputEnabled()
             ? "capture"
             : "inherit";
+        this.emitStudioStatus("正在验证目标平台开发者会话", { stage: "identity", baseUrl });
         const session = await OpenXiangdaDeveloperSession.load();
         if (!session) {
             throw new Error("OPENXIANGDA_AUTH_REQUIRED: 先运行 openxiangda login --base-url <platform>");
         }
+        session.assertPlatform(baseUrl);
+        if (studioMode)
+            assertStudioSiteBaseUrl(baseUrl);
         await session.whoami();
         const reusable = existsSync(root) && readdirSync(root).length > 0;
-        const workspace = reusable
-            ? await this.reuseWorkspace(root, appCode, name, installOutput)
-            : await createWorkspace({
-                directory: root,
-                appCode,
-                name,
-                installOutput,
-            });
+        this.emitStudioStatus(reusable ? "正在恢复已有工作区" : "正在生成应用工作区", { stage: "workspace", reusable });
+        let workspace;
+        if (studioMode) {
+            const resolvedTemplate = resolveWorkspaceTemplate(templateInput);
+            if (reusable) {
+                const storedBinding = readStudioWorkspaceBinding(root);
+                if (!storedBinding) {
+                    throw Object.assign(new Error("STUDIO_WORKSPACE_BINDING_REQUIRED: 非空目录必须已有同一 Studio 初始化绑定"), {
+                        code: "STUDIO_WORKSPACE_BINDING_REQUIRED",
+                        retryable: false,
+                        data: { pointer: "/studioBinding" },
+                    });
+                }
+                ensureStudioWorkspaceBinding(root, {
+                    siteBaseUrl: session.baseUrl,
+                    projectId: flags["studio-project-id"],
+                    provisioningRunId: flags["provisioning-run-id"],
+                    appType: appCode,
+                    appName: name,
+                    template: resolvedTemplate.binding,
+                });
+                if (storedBinding.compiler) {
+                    ensureStudioWorkspaceBinding(root, {
+                        siteBaseUrl: session.baseUrl,
+                        projectId: flags["studio-project-id"],
+                        provisioningRunId: flags["provisioning-run-id"],
+                        appType: appCode,
+                        appName: name,
+                        template: resolvedTemplate.binding,
+                        compiler: await this.studioCompilerSummary(root),
+                    });
+                }
+                workspace = await this.reuseWorkspace(root, appCode, name, installOutput, { explicitName: true, ...templateInput });
+            }
+            else {
+                const prepared = await createWorkspace({
+                    directory: root,
+                    appCode,
+                    name,
+                    install: false,
+                    installOutput,
+                    ...templateInput,
+                });
+                ensureStudioWorkspaceBinding(root, {
+                    siteBaseUrl: session.baseUrl,
+                    projectId: flags["studio-project-id"],
+                    provisioningRunId: flags["provisioning-run-id"],
+                    appType: appCode,
+                    appName: name,
+                    template: prepared.template,
+                });
+                await prepareWorkspace(root, {
+                    installOutput,
+                    toolchainCapsule: resolveCliToolchainCapsule(resolvedTemplate.root),
+                });
+                workspace = {
+                    ...prepared,
+                    installed: true,
+                    generated: true,
+                    generationDeferred: false,
+                };
+            }
+        }
+        else {
+            workspace = reusable
+                ? await this.reuseWorkspace(root, appCode, name, installOutput, {
+                    explicitName: Boolean(flags.name),
+                    ...templateInput,
+                })
+                : await createWorkspace({
+                    directory: root,
+                    appCode,
+                    name,
+                    installOutput,
+                    ...templateInput,
+                });
+        }
+        this.emitStudioStatus("正在绑定平台应用", { stage: "link" });
         const link = await this.services.linkApplication(root, {
             baseUrl: session.baseUrl,
         });
         if (!link.ok)
             return this.present({ ...link, operation: "create" });
+        if (studioMode) {
+            this.emitStudioStatus("正在生成可核对的工作区摘要", {
+                stage: "compiler-summary",
+            });
+            const compiler = await this.studioCompilerSummary(root);
+            const binding = ensureStudioWorkspaceBinding(root, {
+                siteBaseUrl: session.baseUrl,
+                projectId: flags["studio-project-id"],
+                provisioningRunId: flags["provisioning-run-id"],
+                appType: appCode,
+                appName: name,
+                template: workspace.template,
+                compiler,
+            });
+            const initializationFacts = {
+                schemaVersion: STUDIO_WORKSPACE_INITIALIZATION_SCHEMA_VERSION,
+                applicationAuthority: STUDIO_APPLICATION_AUTHORITY,
+                siteBaseUrl: binding.siteBaseUrl,
+                projectId: binding.projectId,
+                provisioningRunId: binding.provisioningRunId,
+                appType: binding.appType,
+                appName: binding.appName,
+                workspace: {
+                    reused: "reused" in workspace && workspace.reused === true,
+                },
+                cliVersion: this.config.version,
+                protocolVersion: STUDIO_WORKSPACE_PROTOCOL_VERSION,
+                template: binding.template,
+                compiler,
+                bindingDigest: studioWorkspaceBindingDigest(binding),
+            };
+            const initialization = {
+                ...initializationFacts,
+                workspaceDigest: studioWorkspaceInitializationDigest(initializationFacts),
+            };
+            if (!link.data) {
+                throw new Error("STUDIO_LINK_RESULT_MISSING: 平台绑定结果缺少 data");
+            }
+            const { path: _localLinkPath, ...linkSummary } = link.data;
+            return this.present({
+                ok: true,
+                operation: "create",
+                workspace: { appCode, name, root },
+                data: {
+                    workspace: {
+                        appType: appCode,
+                        appName: name,
+                        installed: workspace.installed,
+                        generated: workspace.generated,
+                        reused: "reused" in workspace && workspace.reused === true,
+                        template: binding.template,
+                        compiler,
+                    },
+                    link: linkSummary,
+                    provision: null,
+                    studioInitialization: initialization,
+                },
+                diagnostics: [],
+                nextActions: [
+                    {
+                        code: "dev",
+                        label: "启动连接开发",
+                        command: "openxiangda dev --cwd <workspace>",
+                    },
+                ],
+            });
+        }
+        this.emitStudioStatus("正在幂等初始化平台应用", { stage: "provision" });
         const provision = await this.services.provisionApplication(root);
         if (!provision.ok) {
             return this.present({
@@ -46,7 +249,7 @@ export default class Create extends OpenXiangdaCommand {
                     {
                         code: "create.retry",
                         label: "重试幂等初始化",
-                        command: `openxiangda create ${root}`,
+                        command: retryCommand,
                     },
                 ],
             });
@@ -70,12 +273,59 @@ export default class Create extends OpenXiangdaCommand {
             ],
         });
     }
-    async reuseWorkspace(root, appCode, name, installOutput) {
+    async studioCompilerSummary(root) {
+        const [context, description] = await Promise.all([
+            this.services.workspaceContext(root),
+            this.services.contractDescribe(root),
+        ]);
+        if (!context.ok || !context.data) {
+            throw devkitResultError("STUDIO_WORKSPACE_CONTEXT_FAILED", context);
+        }
+        if (!description.ok || !description.data) {
+            throw devkitResultError("STUDIO_COMPILER_SUMMARY_FAILED", description);
+        }
+        return {
+            toolchainVersion: context.data.toolchain.version,
+            contractVersion: context.data.toolchain.contractVersion,
+            compilerContractVersion: OPENXIANGDA_COMPILER_CONTRACT_VERSION,
+            configurationDigest: description.data.configDigest,
+            contractDigest: description.data.contractDigest,
+            aiCatalogDigest: description.data.aiCatalogDigest,
+        };
+    }
+    async reuseWorkspace(root, appCode, name, installOutput, options) {
         const context = await this.services.workspaceContext(root);
         if (context.workspace.appCode !== appCode) {
             throw new Error(`TARGET_DIRECTORY_APP_MISMATCH: 目录应用代码 ${context.workspace.appCode} 与推导值 ${appCode} 不一致`);
         }
-        await prepareWorkspace(root, { installOutput });
+        if (options.explicitName &&
+            context.workspace.name &&
+            context.workspace.name !== name) {
+            throw new Error(`TARGET_DIRECTORY_NAME_MISMATCH: 目录应用名称 ${context.workspace.name} 与显式名称 ${name} 不一致`);
+        }
+        const storedTemplate = readWorkspaceTemplateBinding(root);
+        let requestedTemplate = null;
+        if (options.templateRef && options.templateDigest) {
+            requestedTemplate = resolveWorkspaceTemplate({
+                templateRef: options.templateRef,
+                templateDigest: options.templateDigest,
+            });
+            if (!storedTemplate) {
+                throw new Error("WORKSPACE_TEMPLATE_BINDING_REQUIRED: 已有工作区缺少可验证的模板绑定");
+            }
+            if (storedTemplate.ref !== requestedTemplate.binding.ref ||
+                storedTemplate.digest !== requestedTemplate.binding.digest) {
+                throw new Error("WORKSPACE_TEMPLATE_BINDING_MISMATCH: 已有工作区与请求模板不一致");
+            }
+        }
+        await prepareWorkspace(root, {
+            installOutput,
+            ...(requestedTemplate
+                ? {
+                    toolchainCapsule: resolveCliToolchainCapsule(requestedTemplate.root),
+                }
+                : {}),
+        });
         return {
             root,
             appCode,
@@ -83,9 +333,116 @@ export default class Create extends OpenXiangdaCommand {
             installed: true,
             generated: true,
             reused: true,
+            template: storedTemplate,
         };
     }
 }
+function resolveCreatePlatform(root, appType, requestedBaseUrl, studioMode) {
+    const requested = requestedBaseUrl
+        ? normalizePlatformBaseUrl(requestedBaseUrl)
+        : undefined;
+    const path = join(root, ".openxiangda", "link.json");
+    if (!existsSync(path)) {
+        if (requested)
+            return requested;
+        throw Object.assign(new Error("OPENXIANGDA_CREATE_PLATFORM_REQUIRED: 新建应用必须通过 --base-url <平台地址> 指定目标；先登录同一平台，不能沿用旧登录态猜测站点"), { code: "OPENXIANGDA_CREATE_PLATFORM_REQUIRED", retryable: false, data: { pointer: "/baseUrl" } });
+    }
+    let link;
+    try {
+        link = JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        throw localLinkError("已有 OpenXiangda link 不是有效 JSON", studioMode);
+    }
+    if (!link || typeof link !== "object" || Array.isArray(link)) {
+        throw localLinkError("已有 OpenXiangda link 结构无效", studioMode);
+    }
+    const value = link;
+    if (value.schemaVersion !== 2 ||
+        value.appCode !== appType ||
+        typeof value.baseUrl !== "string" || !value.baseUrl) {
+        throw localLinkError("已有 OpenXiangda link 与本次应用身份不一致", studioMode);
+    }
+    const linked = normalizePlatformBaseUrl(value.baseUrl);
+    if (requested && requested !== linked) {
+        throw localLinkError(`已有工作区绑定 ${linked}，与请求目标 ${requested} 不一致；create 不能重绑到其他站点`, studioMode);
+    }
+    return linked;
+}
+function localLinkError(message, studioMode) {
+    const code = studioMode ? "STUDIO_WORKSPACE_LINK_MISMATCH" : "OPENXIANGDA_WORKSPACE_LINK_MISMATCH";
+    return Object.assign(new Error(`${code}: ${message}`), {
+        code,
+        retryable: false,
+        data: { pointer: "/link" },
+    });
+}
+function devkitResultError(fallbackCode, result) {
+    const diagnostic = result.diagnostics.find(item => item.code) || {
+        code: fallbackCode,
+        message: fallbackCode,
+        retryable: false,
+    };
+    return Object.assign(new Error(`${diagnostic.code}: ${diagnostic.message}`), {
+        code: diagnostic.code,
+        retryable: diagnostic.retryable,
+        data: { ...(diagnostic.path ? { pointer: diagnostic.path } : {}) },
+    });
+}
+function assertStudioCreateInput(input) {
+    const missing = [
+        ["--app-code", input.appCode],
+        ["--name", input.name],
+        ["--template-ref", input.templateRef],
+        ["--template-digest", input.templateDigest],
+        ["--studio-project-id", input.projectId],
+        ["--provisioning-run-id", input.provisioningRunId],
+        ["--json-events", input.jsonEvents],
+        ["--run-id", input.runId],
+    ]
+        .filter(([, value]) => !value)
+        .map(([flag]) => flag);
+    if (missing.length > 0) {
+        throw Object.assign(new Error(`STUDIO_CREATE_FLAGS_REQUIRED: Studio 初始化缺少 ${missing.join(", ")}`), {
+            code: "STUDIO_CREATE_FLAGS_REQUIRED",
+            retryable: false,
+            data: { pointer: "/flags", missing },
+        });
+    }
+    for (const [pointer, value] of [
+        ["/studioProjectId", input.projectId],
+        ["/provisioningRunId", input.provisioningRunId],
+        ["/runId", input.runId],
+    ]) {
+        if (!isPlatformUuid(value)) {
+            throw Object.assign(new Error(`STUDIO_CREATE_UUID_INVALID: ${pointer} 必须是平台 UUID`), {
+                code: "STUDIO_CREATE_UUID_INVALID",
+                retryable: false,
+                data: { pointer },
+            });
+        }
+    }
+}
+function assertStudioSiteBaseUrl(value) {
+    try {
+        const url = new URL(value);
+        if (url.protocol === "https:" &&
+            !url.username &&
+            !url.password &&
+            !url.search &&
+            !url.hash) {
+            return;
+        }
+    }
+    catch {
+        // The stable error below owns malformed and insecure site URLs.
+    }
+    throw Object.assign(new Error("STUDIO_SITE_BASE_URL_INVALID: Studio 站点必须使用无 credential、query 或 fragment 的 HTTPS 地址"), {
+        code: "STUDIO_SITE_BASE_URL_INVALID",
+        retryable: false,
+        data: { pointer: "/siteBaseUrl" },
+    });
+}
 function deriveAppCode(directoryName) {
     const code = directoryName
         .normalize("NFKD")
@@ -98,4 +455,21 @@ function deriveAppCode(directoryName) {
     }
     return code;
 }
+function renderCreateRetryCommand(root, input) {
+    const parts = ["openxiangda", "create", shellArgument(root), "--base-url", shellArgument(input.baseUrl)];
+    if (input.appCode)
+        parts.push("--app-code", shellArgument(input.appCode));
+    if (input.name)
+        parts.push("--name", shellArgument(input.name));
+    if (input.templateRef) {
+        parts.push("--template-ref", shellArgument(input.templateRef));
+    }
+    if (input.templateDigest) {
+        parts.push("--template-digest", shellArgument(input.templateDigest));
+    }
+    return parts.join(" ");
+}
+function shellArgument(value) {
+    return `'${String(value).replaceAll("'", `'"'"'`)}'`;
+}
 //# sourceMappingURL=create.js.map