openxiangda 1.0.265 → 1.0.267

package/README.md

@@ -4,14 +4,19 @@
 
 OpenXiangda is a lightweight CLI and skill package for private low-code platforms.
 
-## Two runtime generations
+## Repository boundary
 
-OpenXiangda now has two deliberately separate development tracks:
+This repository contains only the stable OpenXiangda 1.x maintenance toolchain.
+It maintains existing resource-based applications and its legacy Delivery V2
+protocol. Stable applications keep this runtime and are not migrated by a
+platform upgrade.
 
-- `openxiangda` 1.x maintains existing resource-based applications and its legacy Delivery V2 protocol. Stable applications keep this runtime and are not migrated by a platform upgrade.
-- `v2/` contains the new platform-2.0 application toolchain: `create-openxiangda`, `@openxiangda/cli`, `@openxiangda/mcp`, standard React/NestJS packages, typed configuration, domain skills, and application-level deployment.
-
-For a new 2.0 application, start with [`v2/docs/getting-started.md`](v2/docs/getting-started.md). A 2.0 workspace has `openxiangda.config.ts`, `apps/web`, and `apps/server`; it must not use the 1.x resource/SDD publishing commands.
+OpenXiangda 2.0 is developed and released from the independent
+`tools/openxiangda-v2` repository pinned by the platform orchestration
+repository. A new 2.0 workspace must use that repository's current public
+packages, unified AI skill, templates, and documentation. It must not use the
+1.x resource/SDD publishing commands or any historical embedded copy of the
+2.0 toolchain.
 
 Normal OpenXiangda app development uses platform-user login tokens through `/openxiangda-api/v1`; it does not use AK/SK. External backend and third-party integrations use the separate `openxiangda-open-api` skill, `/dingtalk-api/v1.0`, and a platform-managed AK/SK credential.
 
@@ -107,6 +112,10 @@ openxiangda resource plan function --only customer_get,customer_save --profile d
 openxiangda sdd bundle mainline-release --changes add-customer-page,fix-customer-api
 # verify, wait for the lease, stage exact children, atomically finalize, and release
 openxiangda release publish --change mainline-release --profile dev
+# 仅限平台已核验的旧式多历史 lineage、精确非删除恢复
+openxiangda release publish --change mainline-release --profile dev \
+  --adopt-online-baseline \
+  --adoption-reason "已合入主线的目标来自多次历史发布，无法对应单一 Git 基线"
 openxiangda release status --change mainline-release --watch
 openxiangda release explain --change mainline-release --profile dev
 # 环境托管应用一次性登记（已有应用通常作为 preproduction）

package/lib/application-environments.js

@@ -1025,7 +1025,7 @@ function releaseExecutionPath(changeId, deploymentId, cwd = process.cwd()) {
 }
 
 function withManagedReleaseForwardedFlags(stepId, args = [], flags = {}) {
-  const forwarded = [...args];
+  let forwarded = [...args];
   if (stepId === 'runtime-stage' && flags['allow-runtime-rollback']) {
     forwarded.push('--allow-runtime-rollback');
     const rollbackReason = String(flags.reason || '').trim();
@@ -1058,6 +1058,19 @@ function withManagedReleaseForwardedFlags(stepId, args = [], flags = {}) {
       forwarded.push('--reason', replacementReason);
     }
   }
+  forwarded = withOnlineBaselineAdoptionFlags(forwarded, flags);
+  return forwarded;
+}
+
+function withOnlineBaselineAdoptionFlags(args = [], flags = {}) {
+  const forwarded = [...args];
+  const isExactResourcePublish =
+    forwarded[0] === 'resource' &&
+    forwarded[1] === 'publish' &&
+    (forwarded.includes('--only') || forwarded.includes('--code'));
+  if (!isExactResourcePublish) {
+    return forwarded;
+  }
   if (flags['adopt-online-baseline']) {
     forwarded.push('--adopt-online-baseline');
     const adoptionReason = String(
@@ -1129,6 +1142,7 @@ module.exports = {
   saveCandidate,
   sha256Canonical,
   withManagedReleaseForwardedFlags,
+  withOnlineBaselineAdoptionFlags,
   withReleaseClientSessionArgs,
   writePrivateJsonAtomic,
 };

package/lib/cli.js

@@ -163,6 +163,7 @@ const {
   saveCandidate,
   sha256Canonical,
   withManagedReleaseForwardedFlags,
+  withOnlineBaselineAdoptionFlags,
   withReleaseClientSessionArgs,
 } = require('./application-environments');
 const { startDeveloperCenter } = require('./developer-center');
@@ -336,7 +337,7 @@ Usage:
   openxiangda status <runId> [--environment preproduction|production] [--json]
   openxiangda retry <runId> [--environment preproduction|production] [--json]
   openxiangda rollback <preproduction|production> --to <appReleaseId> [--json]
-  openxiangda release publish|begin|status|integration-status|renew|end [--change id] [--profile name] [--watch] [--json]
+  openxiangda release publish|begin|status|integration-status|renew|end [--change id] [--profile name] [--adopt-online-baseline --adoption-reason text] [--watch] [--json]
   openxiangda release ship|candidate|deploy|reconcile|test|fail|promote|rollback [--candidate id] [--deployment id] [--environment target] [--replace-manifest] [--allow-runtime-rollback --reason text] [--adopt-online-baseline --adoption-reason text] [--confirm-production] [--json]
   openxiangda task status --change <id> [--profile name] [--watch] [--json]
   openxiangda release backend-head|backend-list|backend-detail|backend-diff|backend-rollback|backend-abort|backend-retry [releaseId] [--profile name] [--json]
@@ -2075,14 +2076,18 @@ async function endReleaseWithoutLocalLease(
 }
 
 function decorateEnvironmentReleaseSteps(steps, target, flags = {}) {
-  if (!target.environmentId || !target.targetName) return steps;
+  const managedEnvironment = Boolean(
+    target.environmentId && target.targetName
+  );
   const deploymentId = readStringFlag(flags, 'deployment-id');
   for (const step of steps) {
-    step.args = withManagedReleaseForwardedFlags(
-      step.id,
-      step.args,
-      flags
-    );
+    step.args = managedEnvironment
+      ? withManagedReleaseForwardedFlags(step.id, step.args, flags)
+      : withOnlineBaselineAdoptionFlags(step.args, flags);
+    if (!managedEnvironment) {
+      step.command = commandFromArgs(step.args);
+      continue;
+    }
     step.args.push('--environment', target.targetName);
     if (deploymentId) step.args.push('--deployment-id', deploymentId);
     if (step.id === 'runtime-stage' && flags.__verifiedCandidate) {
@@ -2132,6 +2137,43 @@ function decorateEnvironmentReleaseSteps(steps, target, flags = {}) {
   return steps;
 }
 
+function assertReleasePublishAdoptionFlags(flags = {}) {
+  const adoptionRequested = Boolean(flags['adopt-online-baseline']);
+  const adoptionReasonSupplied = Object.prototype.hasOwnProperty.call(
+    flags,
+    'adoption-reason'
+  );
+  const adoptionReason = String(flags['adoption-reason'] || '').trim();
+  if (!adoptionRequested && adoptionReasonSupplied) {
+    const error = new Error(
+      'RELEASE_PUBLISH_ADOPTION_FLAG_REQUIRED: --adoption-reason 必须与 --adopt-online-baseline 一起使用；命令已在任何发布租约或资源写入前终止'
+    );
+    error.code = 'RELEASE_PUBLISH_ADOPTION_FLAG_REQUIRED';
+    throw error;
+  }
+  if (adoptionRequested && adoptionReason.length < 8) {
+    const error = new Error(
+      'RELEASE_PUBLISH_ADOPTION_REASON_REQUIRED: --adopt-online-baseline 必须提供至少 8 个字符的 --adoption-reason；命令已在任何发布租约或资源写入前终止'
+    );
+    error.code = 'RELEASE_PUBLISH_ADOPTION_REASON_REQUIRED';
+    throw error;
+  }
+}
+
+function assertReleasePublishAdoptionScope(steps = [], flags = {}) {
+  if (!flags['adopt-online-baseline']) return;
+  const adoptionSteps = steps.filter(step =>
+    step.args?.includes('--adopt-online-baseline')
+  );
+  if (adoptionSteps.length === 0) {
+    const error = new Error(
+      'RELEASE_PUBLISH_ADOPTION_SCOPE_REQUIRED: 当前发布计划没有可精确采纳线上基线的 resource publish --only/--code 阶段；命令已在任何发布租约或资源写入前终止'
+    );
+    error.code = 'RELEASE_PUBLISH_ADOPTION_SCOPE_REQUIRED';
+    throw error;
+  }
+}
+
 function changeIdFromStep(step) {
   const index = step.args.indexOf('--change');
   return index >= 0 ? step.args[index + 1] : 'change';
@@ -2145,6 +2187,7 @@ async function publishWorkspaceRelease(config, target, flags = {}) {
   if (!changeId) {
     fail('用法: openxiangda release publish --change <id> --profile <name>');
   }
+  assertReleasePublishAdoptionFlags(flags);
   assertManagedRuntimeRollbackFlags(flags);
   const releaseCandidate = flags.__verifiedCandidate
     ? assertLocalCandidate(flags.__verifiedCandidate)
@@ -2171,6 +2214,7 @@ async function publishWorkspaceRelease(config, target, flags = {}) {
     changeId
   );
   decorateEnvironmentReleaseSteps(steps, target, flags);
+  assertReleasePublishAdoptionScope(steps, flags);
   const releaseScope = getSddChangeScope({
     cwd: process.cwd(),
     configText: readWorkspaceConfigText(),
@@ -5308,7 +5352,7 @@ async function release(args) {
   const { flags, positional } = parseArgs(rest);
   if (wantsSubcommandHelp(subcommand, flags)) {
     print([
-      '用法: openxiangda release publish|begin|status|explain|integration-status|renew|end [--change id] [--profile name] [--json]',
+      '用法: openxiangda release publish|begin|status|explain|integration-status|renew|end [--change id] [--profile name] [--adopt-online-baseline --adoption-reason text] [--json]',
       '      openxiangda release ship|candidate|deploy|reconcile|test|fail|promote|rollback [--candidate id] [--deployment id] [--environment target] [--replace-manifest] [--allow-runtime-rollback --reason text] [--adopt-online-baseline --adoption-reason text] [--confirm-production] [--json]',
       '      openxiangda release backend-head|backend-list|backend-detail|backend-diff|backend-rollback|backend-abort|backend-retry [releaseId] [--profile name] [--json]',
       '      openxiangda release app-capture|app-head|app-list|app-detail|app-diff|app-post-commit|app-retry|app-prepare|app-verify|app-activate|app-finalize|app-rollback|app-abort [releaseId] [--staged-resources-json <JSON|file>] [--activate-staged-children] [--break-glass-adopt-verified-root --reason text] [--force-activate-without-validation] [--profile name] [--json]',
@@ -5321,6 +5365,7 @@ async function release(args) {
       '  openxiangda release ship --change <id> --profile <name> --confirm-production',
       '  openxiangda release fail --deployment <id> --message "UAT 未通过" --code UAT_FAILED --details-json <JSON|file> --environment preproduction --profile <name>',
       '  openxiangda release publish --change <id> --profile <name>',
+      '  openxiangda release publish --change <id> --profile <name> --adopt-online-baseline --adoption-reason "已审计目标来自多次历史发布"',
       '  openxiangda release begin --change <id> --profile <name>',
       '  openxiangda resource publish function --only <code> --change <id> --profile <name>',
       '  openxiangda runtime deploy --change <id> --profile <name>',
@@ -5339,6 +5384,7 @@ async function release(args) {
       '  - release fail 只允许显式选择 preproduction target，并会先核对 deployment 的 targetEnvironmentId；message 必填，code/details 会一并写入平台审计。',
       '  - ship 当前不支持 --dry-run；任何未声明参数都会在 candidate/deployment 写入前 fail-closed。需要只读检查时使用 environment status/diff 与 release status。',
       '  - publish 默认等待租约并按私有执行日志恢复；上次写结果不确定时必须只读核对后显式 --resume-after-review。',
+      '  - 旧式非环境托管 publish 也会把线上基线采纳意图仅透传给精确的 resource publish --only/--code 阶段；无精确资源阶段、原因不足或单独提供 reason 均在获取租约前 fail-closed。',
       '  - app-head 默认只输出紧凑 head 摘要；需要完整 manifest 时显式追加 --full。',
       '  - begin 获取应用级单写者 promotion lease；不同工作区仍可并行开发和验证。',
       '  - 带 --change 的 resource/runtime 写命令在没有本地 lease 时会自动 begin，并在后续命令复用。',
@@ -31065,6 +31111,8 @@ function buildWorkspacePublishEnv(
 }
 
 module.exports = {
+  assertReleasePublishAdoptionFlags,
+  assertReleasePublishAdoptionScope,
   assertRuntimeReleaseReusable,
   buildOpenXiangdaUpdateInstallPlan,
   buildResourceManifestSddTargets,
@@ -31081,4 +31129,5 @@ module.exports = {
   resolveDataViewSourceFormCodes,
   satisfiedFormCodesFromContext,
   stagedDataViewFormReleaseDependencies,
+  decorateEnvironmentReleaseSteps,
 };

package/lib/skills.js

@@ -82,62 +82,17 @@ const SKILL_SPECS = [
     sourceRelativePath: 'openxiangda-skills/skills/openxiangda-open-api',
     type: 'subskill',
   },
-  {
-    name: 'openxiangda-v2',
-    displayName: 'OpenXiangda 2.0',
-    shortDescription: '标准 React/NestJS 应用与应用级交付入口。',
-    sourceRelativePath: 'v2/skills/openxiangda-v2',
-    type: 'subskill',
-  },
-  {
-    name: 'openxiangda-v2-architecture',
-    displayName: 'OpenXiangda 2.0 Architecture',
-    shortDescription: '设计 2.0 应用边界与类型化平台契约。',
-    sourceRelativePath: 'v2/skills/openxiangda-v2-architecture',
-    type: 'subskill',
-  },
-  {
-    name: 'openxiangda-v2-frontend',
-    displayName: 'OpenXiangda 2.0 Frontend',
-    shortDescription: '开发 React、Ant Design 与标准后台页面。',
-    sourceRelativePath: 'v2/skills/openxiangda-v2-frontend',
-    type: 'subskill',
-  },
-  {
-    name: 'openxiangda-v2-backend',
-    displayName: 'OpenXiangda 2.0 Backend',
-    shortDescription: '开发平台托管的标准 NestJS 应用后端。',
-    sourceRelativePath: 'v2/skills/openxiangda-v2-backend',
-    type: 'subskill',
-  },
-  {
-    name: 'openxiangda-v2-data-authz',
-    displayName: 'OpenXiangda 2.0 Data and AuthZ',
-    shortDescription: '设计 Data API、RBAC 与上下文数据权限。',
-    sourceRelativePath: 'v2/skills/openxiangda-v2-data-authz',
-    type: 'subskill',
-  },
-  {
-    name: 'openxiangda-v2-workflow-events',
-    displayName: 'OpenXiangda 2.0 Workflow and Events',
-    shortDescription: '开发 Workflow Kernel v2 与持久事件消费者。',
-    sourceRelativePath: 'v2/skills/openxiangda-v2-workflow-events',
-    type: 'subskill',
-  },
-  {
-    name: 'openxiangda-v2-delivery',
-    displayName: 'OpenXiangda 2.0 Delivery',
-    shortDescription: '构建、部署、观察、晋级和回滚完整应用。',
-    sourceRelativePath: 'v2/skills/openxiangda-v2-delivery',
-    type: 'subskill',
-  },
-  {
-    name: 'openxiangda-v1-maintenance',
-    displayName: 'OpenXiangda 1.x Maintenance',
-    shortDescription: '不迁移地安全维护稳定 1.x 应用。',
-    sourceRelativePath: 'v2/skills/openxiangda-v1-maintenance',
-    type: 'subskill',
-  },
+];
+
+const RETIRED_SKILL_SPECS = [
+  { name: 'openxiangda-v2', sourceRelativePath: 'v2/skills/openxiangda-v2' },
+  { name: 'openxiangda-v2-architecture', sourceRelativePath: 'v2/skills/openxiangda-v2-architecture' },
+  { name: 'openxiangda-v2-frontend', sourceRelativePath: 'v2/skills/openxiangda-v2-frontend' },
+  { name: 'openxiangda-v2-backend', sourceRelativePath: 'v2/skills/openxiangda-v2-backend' },
+  { name: 'openxiangda-v2-data-authz', sourceRelativePath: 'v2/skills/openxiangda-v2-data-authz' },
+  { name: 'openxiangda-v2-workflow-events', sourceRelativePath: 'v2/skills/openxiangda-v2-workflow-events' },
+  { name: 'openxiangda-v2-delivery', sourceRelativePath: 'v2/skills/openxiangda-v2-delivery' },
+  { name: 'openxiangda-v1-maintenance', sourceRelativePath: 'v2/skills/openxiangda-v1-maintenance' },
 ];
 
 function getDefaultCodexSkillsDir(env = process.env) {
@@ -242,6 +197,36 @@ function getSkillStatus(spec, skillsDir) {
   };
 }
 
+function getRetiredSkillStatus(spec, skillsDir) {
+  const targetDir = path.join(skillsDir, spec.name);
+  if (!fs.existsSync(targetDir)) {
+    return {
+      name: spec.name,
+      status: 'absent',
+      targetDir,
+      sourceRelativePath: spec.sourceRelativePath,
+    };
+  }
+
+  const manifest = readManifest(targetDir);
+  const isManagedRetiredSkill =
+    manifest?.manager === MANAGER &&
+    manifest.sourceRelativePath === spec.sourceRelativePath;
+  return {
+    name: spec.name,
+    status: isManagedRetiredSkill ? 'retired-managed' : 'preserved-external',
+    targetDir,
+    sourceRelativePath: spec.sourceRelativePath,
+  };
+}
+
+function removeRetiredManagedSkill(spec, skillsDir) {
+  const status = getRetiredSkillStatus(spec, skillsDir);
+  if (status.status === 'retired-managed') {
+    fs.rmSync(status.targetDir, { recursive: true, force: true });
+  }
+}
+
 function getSkillStatusReport(options = {}) {
   const agent = validateAgent(options.agent);
   const env = options.env || process.env;
@@ -252,10 +237,12 @@ function getSkillStatusReport(options = {}) {
   const results = [];
   for (const skillsDir of skillsDirs) {
     const skills = SKILL_SPECS.map(spec => getSkillStatus(spec, skillsDir));
+    const retiredSkills = RETIRED_SKILL_SPECS.map(spec => getRetiredSkillStatus(spec, skillsDir));
     results.push({
       agent,
       skillsDir,
       skills,
+      retiredSkills,
     });
   }
 
@@ -283,6 +270,7 @@ function installSkills(options = {}) {
   const results = [];
   for (const skillsDir of skillsDirs) {
     const before = SKILL_SPECS.map(spec => getSkillStatus(spec, skillsDir));
+    const retiredBefore = RETIRED_SKILL_SPECS.map(spec => getRetiredSkillStatus(spec, skillsDir));
     const conflicts = before.filter(item => item.status === 'foreign');
 
     if (conflicts.length > 0 && !force && !dryRun) {
@@ -298,17 +286,29 @@ function installSkills(options = {}) {
       targetDir: item.targetDir,
       sourceRelativePath: item.sourceRelativePath,
     }));
+    const retiredOperations = retiredBefore.map(item => ({
+      name: item.name,
+      operation: item.status === 'retired-managed' ? 'remove-retired-managed' : 'preserve',
+      targetDir: item.targetDir,
+      sourceRelativePath: item.sourceRelativePath,
+    }));
 
     if (!dryRun) {
       fs.mkdirSync(skillsDir, { recursive: true });
       for (const spec of SKILL_SPECS) {
         installOneSkill(spec, skillsDir);
       }
+      for (const spec of RETIRED_SKILL_SPECS) {
+        removeRetiredManagedSkill(spec, skillsDir);
+      }
     }
 
     const after = dryRun
       ? before
       : SKILL_SPECS.map(spec => getSkillStatus(spec, skillsDir));
+    const retiredAfter = dryRun
+      ? retiredBefore
+      : RETIRED_SKILL_SPECS.map(spec => getRetiredSkillStatus(spec, skillsDir));
 
     results.push({
       agent,
@@ -317,7 +317,9 @@ function installSkills(options = {}) {
       dryRun,
       force,
       operations,
+      retiredOperations,
       skills: after,
+      retiredSkills: retiredAfter,
     });
   }
 
@@ -446,6 +448,7 @@ function buildWarnings(legacySkills) {
 
 module.exports = {
   INSTALL_MANIFEST,
+  RETIRED_SKILL_SPECS,
   SKILL_SPECS,
   getSkillStatusReport,
   installSkills,

package/openxiangda-skills/SKILL.md

@@ -13,7 +13,7 @@ This file is a router and safety card. Read only the one or two subskills select
 
 ## Select the runtime generation first
 
-If the workspace contains `openxiangda.config.ts`, `apps/web`, and `apps/server`, it is a platform-2.0 application. Stop this 1.x resource flow and use `$openxiangda-v2` plus its architecture, frontend, backend, data-authz, workflow-events, and delivery skills. The 2.0 CLI operates on one immutable application package and does not use SDD or per-resource publishing.
+If the workspace contains `openxiangda.config.ts`, `apps/web`, and `apps/server`, it is a platform-2.0 application. Stop this 1.x resource flow and use the independently released `$openxiangda-v2` unified skill. The 2.0 CLI operates on one immutable application package and does not use SDD or per-resource publishing.
 
 If the workspace contains `app-workspace.config.ts`, forms/pages/resource manifests, or an existing 1.x state directory, continue with this router. Never migrate a stable 1.x application merely because platform 2.0 is available.
 
@@ -161,7 +161,7 @@ When the sealed Runtime source intentionally does not descend from the active Ru
 
 `resource plan` and publish dry-runs are strictly GET/HEAD-only. `READ_ONLY_AUTH_REQUIRED` means the access token expired; run `openxiangda auth refresh --profile <name>` or log in again before retrying. Never add an automatic refresh POST inside a plan.
 
-`release publish` is the default promotion entrypoint only for legacy unmanaged workspaces. It verifies without rewriting reviewed `change.json`/`release.json`, waits for the app lease, freezes the App capture after ownership is acquired, executes deterministic exact staged steps, resumes from `.openxiangda/releases/<change>/execution.json`, atomically finalizes, verifies mainline integration, and releases the lease. Environment-managed applications use the two-phase `release ship`; candidate/deploy/test/fail/promote, `release begin`, and child commands remain recovery/diagnostic primitives.
+`release publish` is the default promotion entrypoint only for legacy unmanaged workspaces. It verifies without rewriting reviewed `change.json`/`release.json`, waits for the app lease, freezes the App capture after ownership is acquired, executes deterministic exact staged steps, resumes from `.openxiangda/releases/<change>/execution.json`, atomically finalizes, verifies mainline integration, and releases the lease. When the same audited historical-lineage condition applies, legacy `release publish` accepts `--adopt-online-baseline --adoption-reason "..."` and forwards the pair only to exact `resource publish --only/--code` stages; missing reasons or plans without an exact resource stage fail before lease acquisition. Environment-managed applications use the two-phase `release ship`; candidate/deploy/test/fail/promote, `release begin`, and child commands remain recovery/diagnostic primitives.
 
 Reviewed bundle commands may retain `<profile>` as a template. The explicit real `release publish --profile <name>` value is bound to actual child argv without rewriting tracked SDD. React SPA page codes are logical coverage targets and activate through one Runtime child; they do not require PageRelease. `release app-head` and `runtime releases` are compact by default; use `--full` only when the complete manifest is required.
 

package/openxiangda-skills/skills/openxiangda-core/SKILL.md

@@ -157,7 +157,7 @@ An environment-managed release may intentionally replace complete Function/Autom
 
 For an audited Runtime source rollback, managed `release ship`, recovery `release deploy`, and `release promote` accept `--allow-runtime-rollback --reason "..."` with a reason of at least 8 characters. This pair is scoped only to `runtime-stage` and never reaches resource stages or `app-finalize`. Ship freezes it in `ship.json`; production confirmation inherits it automatically. The default remains fail closed.
 
-`release publish` is the normal whole-app entrypoint for legacy unmanaged workspaces: it verifies SDD without mutating reviewed files, waits for the promotion lease, freezes one App capture, stages the exact Form/Backend/Runtime children, resumes from a private execution journal, finalizes once, and releases the lease. Managed applications use two-phase `release ship` and its deployment-scoped journal. Individual candidate/deploy/test/fail/promote commands are recovery/diagnostic primitives. `release fail --deployment <id> --message <text> [--code <code>] [--details-json <JSON|file>] --environment preproduction` records an audited UAT failure only after verifying the deployment belongs to the selected preproduction environment; production targets and mismatched deployment identities fail before the write.
+`release publish` is the normal whole-app entrypoint for legacy unmanaged workspaces: it verifies SDD without mutating reviewed files, waits for the promotion lease, freezes one App capture, stages the exact Form/Backend/Runtime children, resumes from a private execution journal, finalizes once, and releases the lease. For an approved historical-lineage catch-up, add `--adopt-online-baseline --adoption-reason "..."`; the pair reaches only exact `resource publish --only/--code` stages, never Form ensure, Runtime, or App finalize, and invalid or empty scopes fail before lease acquisition. Managed applications use two-phase `release ship` and its deployment-scoped journal. Individual candidate/deploy/test/fail/promote commands are recovery/diagnostic primitives. `release fail --deployment <id> --message <text> [--code <code>] [--details-json <JSON|file>] --environment preproduction` records an audited UAT failure only after verifying the deployment belongs to the selected preproduction environment; production targets and mismatched deployment identities fail before the write.
 
 Reviewed bundle commands may retain `<profile>` as a template. The explicit real `release publish --profile <name>` value is bound to actual child argv without rewriting tracked SDD. React SPA page codes remain logical coverage targets and activate through the single Runtime child; they do not require PageRelease. If local lease state disappears, `release end --change <id>` reconciles a self-owned remote lease from the private execution journal and never reports inactive while a remote lease is active.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "1.0.265",
+  "version": "1.0.267",
   "description": "OpenXiangda CLI, workspace build tools, runtime SDK, and form components.",
   "private": false,
   "bin": {
@@ -55,7 +55,6 @@
     "bin/",
     "lib/",
     "openxiangda-skills/",
-    "v2/skills/",
     "policy/",
     "templates/",
     "packages/sdk/bin/",

package/packages/sdk/dist/{ProcessPreview-DSUIJi5V.d.mts → ProcessPreview-Cyk6uv-w.d.mts}

@@ -1,4 +1,5 @@
 import React__default, { ReactNode } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
 type FormSectionVariant = 'plain' | 'card';
 type FormSectionAccent = 'blue' | 'green';
@@ -17,7 +18,7 @@ interface FormSectionProps {
     contentClassName?: string;
     children: React__default.ReactNode;
 }
-declare function FormSection({ title, description, variant, accent, icon, iconKey, collapsible, defaultCollapsed, className, titleClassName, contentClassName, children, }: FormSectionProps): React__default.JSX.Element;
+declare function FormSection({ title, description, variant, accent, icon, iconKey, collapsible, defaultCollapsed, className, titleClassName, contentClassName, children, }: FormSectionProps): react_jsx_runtime.JSX.Element;
 
 /** 字段行为状态 */
 type FieldBehavior = 'NORMAL' | 'READONLY' | 'DISABLED' | 'HIDDEN';
@@ -1289,4 +1290,4 @@ interface ProcessPreviewProps {
 }
 declare const ProcessPreview: React__default.FC<ProcessPreviewProps>;
 
-export { type DepartmentSelectFieldProps as $, type ApprovalPermission as A, type ReturnParams as B, type ChangeRecordQueryParams as C, type SaveTaskParams as D, type TransferParams as E, type FieldDefinition as F, type TextFieldProps as G, type TextAreaFieldProps as H, type InitiatorSelectCandidate as I, type SelectFieldProps as J, type RadioFieldProps as K, type CheckboxFieldProps as L, type MultiSelectFieldProps as M, type NumberFieldProps as N, type OptionItem as O, type ProcessStatus as P, type DateFieldProps as Q, type RuntimeResponse as R, type StatusMeta as S, type TaskStatus as T, type CascadeDateFieldProps as U, type ValidationPreset as V, type WithdrawParams as W, type AttachmentFieldProps as X, type ImageFieldProps as Y, type SubFormFieldProps as Z, type UserSelectFieldProps as _, type FormRuntimeApi as a, type ImageVariant as a$, type CascadeSelectFieldProps as a0, type AddressFieldProps as a1, type AssociationFormFieldProps as a2, type EditorFieldProps as a3, type EditorChoiceOption as a4, type SerialNumberFieldProps as a5, type LocationFieldProps as a6, type DigitalSignatureFieldProps as a7, type JSONFieldProps as a8, type AttachmentItem as a9, type DefaultValueLinkageConfig as aA, type DepartmentSearchParams as aB, type DepartmentSearchResult as aC, type DepartmentSearchScope as aD, type DepartmentTreeNode as aE, type DigitalSignatureValue as aF, type EditorToolbarAction as aG, type FieldLayoutNode as aH, type FieldValueSyncConfig as aI, type FilePreviewCapabilityBatch as aJ, type FilePreviewProvider as aK, type FilePreviewRenderMode as aL, type FilePreviewSurface as aM, type FilePreviewType as aN, type FormEffectAction as aO, type FormEffectCondition as aP, type FormEffectConditionOperator as aQ, type FormEngineMode as aR, type FormLayoutNode as aS, FormSection as aT, type FormSectionProps as aU, type FormSubmitBehavior as aV, type FormTemplateConfig as aW, type GridLayoutCell as aX, type GridLayoutNode as aY, type ImageCompressionConfig as aZ, type ImageCompressionVariantConfig as a_, type PreparedFilePreview as aa, type FilePreviewCapability as ab, type FilePreviewMetadata as ac, type FilePreviewRequest as ad, type ProcessAction as ae, type InitiatorSelectedApprovers as af, type ReturnPolicy as ag, type ChangeRecord as ah, type StandardFormPageMode as ai, type LowcodePageSchema as aj, type AddressValue as ak, type ApprovalActionType as al, ApprovalTimeline as am, type ApprovalTimelineProps as an, type AssociationFormConfig as ao, type AssociationValue as ap, type AttachmentImageVariants as aq, type BaseFieldProps as ar, type BaseLayoutNode as as, type DataFilter as at, type DataLinkageCondition as au, type DataLinkageConfig as av, type DateRangeRestriction as aw, type DateRestrictionConfig as ax, type DateShortcutConfig as ay, type DateShortcutType as az, type FormSchema as b, type InitiatorSelectScope as b0, type JSONFieldEditorContext as b1, type JSONFieldRendererContext as b2, type LayoutVisibleWhen as b3, type LinkedFormOptionConfig as b4, type LocationValue as b5, type LowcodePageMeta as b6, type LowcodePageNode as b7, type LowcodePageNodeType as b8, type OptionSourceType as b9, type PeopleShortcutConfig as ba, type PeopleShortcutType as bb, type PreviewImageItem as bc, type ProcessNodeType as bd, ProcessPreview as be, type ProcessPreviewProps as bf, type RuntimeAuthHeadersProvider as bg, type RuntimeDataQueryParams as bh, type RuntimeDataQueryResult as bi, type RuntimeRequestConfig as bj, type RuntimeUploadOptions as bk, type RuntimeUploadProvider as bl, type SectionLayoutNode as bm, type SignaturePoint as bn, type StepLayoutItem as bo, type StepsLayoutNode as bp, type SubFormColumn as bq, type TabLayoutItem as br, type TabsLayoutNode as bs, type TextShortcutConfig as bt, type TextShortcutType as bu, type UserDisplayFormat as bv, type UserItem as bw, type FormRuntimeApiConfig as c, type FormEngineConfig as d, type FieldBehavior as e, type FormRuntimeConfig as f, type FormAppearanceConfig as g, type ValidationRule as h, type FormEffect as i, type OptionSourceConfig as j, type FormDataDeleteParams as k, type ChangeRecordListResponse as l, type FormDataQueryParams as m, type FormInstanceData as n, type InitiatorSelectRequirement as o, type ProcessBasicInfo as p, type ProcessDefinition as q, type ProcessTask as r, type ReturnableNodeResult as s, type ReturnableNode as t, type ViewPermissionQueryParams as u, type ViewPermissionSummary as v, type ApproveParams as w, type PreviewParams as x, type ProcessRoute as y, type ResubmitParams as z };
+export { type FormDataDeleteParams as $, type AddressFieldProps as A, type BaseFieldProps as B, type CascadeDateFieldProps as C, type DataFilter as D, type DepartmentSearchParams as E, type DepartmentSearchResult as F, type DepartmentSearchScope as G, type DepartmentSelectFieldProps as H, type DepartmentTreeNode as I, type DigitalSignatureFieldProps as J, type DigitalSignatureValue as K, type EditorChoiceOption as L, type EditorFieldProps as M, type EditorToolbarAction as N, type FieldBehavior as O, type FieldDefinition as P, type FieldLayoutNode as Q, type FieldValueSyncConfig as R, type FilePreviewCapability as S, type FilePreviewCapabilityBatch as T, type FilePreviewMetadata as U, type FilePreviewProvider as V, type FilePreviewRenderMode as W, type FilePreviewRequest as X, type FilePreviewSurface as Y, type FilePreviewType as Z, type FormAppearanceConfig as _, type AddressValue as a, type RuntimeAuthHeadersProvider as a$, type FormDataQueryParams as a0, type FormEffect as a1, type FormEffectAction as a2, type FormEffectCondition as a3, type FormEffectConditionOperator as a4, type FormEngineConfig as a5, type FormEngineMode as a6, type FormInstanceData as a7, type FormLayoutNode as a8, type FormRuntimeApi as a9, type LowcodePageNodeType as aA, type LowcodePageSchema as aB, type MultiSelectFieldProps as aC, type NumberFieldProps as aD, type OptionItem as aE, type OptionSourceConfig as aF, type OptionSourceType as aG, type PeopleShortcutConfig as aH, type PeopleShortcutType as aI, type PreparedFilePreview as aJ, type PreviewImageItem as aK, type PreviewParams as aL, type ProcessAction as aM, type ProcessBasicInfo as aN, type ProcessDefinition as aO, type ProcessNodeType as aP, ProcessPreview as aQ, type ProcessPreviewProps as aR, type ProcessRoute as aS, type ProcessStatus as aT, type ProcessTask as aU, type RadioFieldProps as aV, type ResubmitParams as aW, type ReturnParams as aX, type ReturnPolicy as aY, type ReturnableNode as aZ, type ReturnableNodeResult as a_, type FormRuntimeApiConfig as aa, type FormRuntimeConfig as ab, type FormSchema as ac, FormSection as ad, type FormSectionProps as ae, type FormSubmitBehavior as af, type FormTemplateConfig as ag, type GridLayoutCell as ah, type GridLayoutNode as ai, type ImageCompressionConfig as aj, type ImageCompressionVariantConfig as ak, type ImageFieldProps as al, type ImageVariant as am, type InitiatorSelectCandidate as an, type InitiatorSelectRequirement as ao, type InitiatorSelectScope as ap, type InitiatorSelectedApprovers as aq, type JSONFieldEditorContext as ar, type JSONFieldProps as as, type JSONFieldRendererContext as at, type LayoutVisibleWhen as au, type LinkedFormOptionConfig as av, type LocationFieldProps as aw, type LocationValue as ax, type LowcodePageMeta as ay, type LowcodePageNode as az, type ApprovalActionType as b, type RuntimeDataQueryParams as b0, type RuntimeDataQueryResult as b1, type RuntimeRequestConfig as b2, type RuntimeResponse as b3, type RuntimeUploadOptions as b4, type RuntimeUploadProvider as b5, type SaveTaskParams as b6, type SectionLayoutNode as b7, type SelectFieldProps as b8, type SerialNumberFieldProps as b9, type SignaturePoint as ba, type StandardFormPageMode as bb, type StatusMeta as bc, type StepLayoutItem as bd, type StepsLayoutNode as be, type SubFormColumn as bf, type SubFormFieldProps as bg, type TabLayoutItem as bh, type TabsLayoutNode as bi, type TaskStatus as bj, type TextAreaFieldProps as bk, type TextFieldProps as bl, type TextShortcutConfig as bm, type TextShortcutType as bn, type TransferParams as bo, type UserDisplayFormat as bp, type UserItem as bq, type UserSelectFieldProps as br, type ValidationPreset as bs, type ValidationRule as bt, type ViewPermissionQueryParams as bu, type ViewPermissionSummary as bv, type WithdrawParams as bw, type ApprovalPermission as c, ApprovalTimeline as d, type ApprovalTimelineProps as e, type ApproveParams as f, type AssociationFormConfig as g, type AssociationFormFieldProps as h, type AssociationValue as i, type AttachmentFieldProps as j, type AttachmentImageVariants as k, type AttachmentItem as l, type BaseLayoutNode as m, type CascadeSelectFieldProps as n, type ChangeRecord as o, type ChangeRecordListResponse as p, type ChangeRecordQueryParams as q, type CheckboxFieldProps as r, type DataLinkageCondition as s, type DataLinkageConfig as t, type DateFieldProps as u, type DateRangeRestriction as v, type DateRestrictionConfig as w, type DateShortcutConfig as x, type DateShortcutType as y, type DefaultValueLinkageConfig as z };

package/packages/sdk/dist/{ProcessPreview-DSUIJi5V.d.ts → ProcessPreview-Cyk6uv-w.d.ts}

@@ -1,4 +1,5 @@
 import React__default, { ReactNode } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
 type FormSectionVariant = 'plain' | 'card';
 type FormSectionAccent = 'blue' | 'green';
@@ -17,7 +18,7 @@ interface FormSectionProps {
     contentClassName?: string;
     children: React__default.ReactNode;
 }
-declare function FormSection({ title, description, variant, accent, icon, iconKey, collapsible, defaultCollapsed, className, titleClassName, contentClassName, children, }: FormSectionProps): React__default.JSX.Element;
+declare function FormSection({ title, description, variant, accent, icon, iconKey, collapsible, defaultCollapsed, className, titleClassName, contentClassName, children, }: FormSectionProps): react_jsx_runtime.JSX.Element;
 
 /** 字段行为状态 */
 type FieldBehavior = 'NORMAL' | 'READONLY' | 'DISABLED' | 'HIDDEN';
@@ -1289,4 +1290,4 @@ interface ProcessPreviewProps {
 }
 declare const ProcessPreview: React__default.FC<ProcessPreviewProps>;
 
-export { type DepartmentSelectFieldProps as $, type ApprovalPermission as A, type ReturnParams as B, type ChangeRecordQueryParams as C, type SaveTaskParams as D, type TransferParams as E, type FieldDefinition as F, type TextFieldProps as G, type TextAreaFieldProps as H, type InitiatorSelectCandidate as I, type SelectFieldProps as J, type RadioFieldProps as K, type CheckboxFieldProps as L, type MultiSelectFieldProps as M, type NumberFieldProps as N, type OptionItem as O, type ProcessStatus as P, type DateFieldProps as Q, type RuntimeResponse as R, type StatusMeta as S, type TaskStatus as T, type CascadeDateFieldProps as U, type ValidationPreset as V, type WithdrawParams as W, type AttachmentFieldProps as X, type ImageFieldProps as Y, type SubFormFieldProps as Z, type UserSelectFieldProps as _, type FormRuntimeApi as a, type ImageVariant as a$, type CascadeSelectFieldProps as a0, type AddressFieldProps as a1, type AssociationFormFieldProps as a2, type EditorFieldProps as a3, type EditorChoiceOption as a4, type SerialNumberFieldProps as a5, type LocationFieldProps as a6, type DigitalSignatureFieldProps as a7, type JSONFieldProps as a8, type AttachmentItem as a9, type DefaultValueLinkageConfig as aA, type DepartmentSearchParams as aB, type DepartmentSearchResult as aC, type DepartmentSearchScope as aD, type DepartmentTreeNode as aE, type DigitalSignatureValue as aF, type EditorToolbarAction as aG, type FieldLayoutNode as aH, type FieldValueSyncConfig as aI, type FilePreviewCapabilityBatch as aJ, type FilePreviewProvider as aK, type FilePreviewRenderMode as aL, type FilePreviewSurface as aM, type FilePreviewType as aN, type FormEffectAction as aO, type FormEffectCondition as aP, type FormEffectConditionOperator as aQ, type FormEngineMode as aR, type FormLayoutNode as aS, FormSection as aT, type FormSectionProps as aU, type FormSubmitBehavior as aV, type FormTemplateConfig as aW, type GridLayoutCell as aX, type GridLayoutNode as aY, type ImageCompressionConfig as aZ, type ImageCompressionVariantConfig as a_, type PreparedFilePreview as aa, type FilePreviewCapability as ab, type FilePreviewMetadata as ac, type FilePreviewRequest as ad, type ProcessAction as ae, type InitiatorSelectedApprovers as af, type ReturnPolicy as ag, type ChangeRecord as ah, type StandardFormPageMode as ai, type LowcodePageSchema as aj, type AddressValue as ak, type ApprovalActionType as al, ApprovalTimeline as am, type ApprovalTimelineProps as an, type AssociationFormConfig as ao, type AssociationValue as ap, type AttachmentImageVariants as aq, type BaseFieldProps as ar, type BaseLayoutNode as as, type DataFilter as at, type DataLinkageCondition as au, type DataLinkageConfig as av, type DateRangeRestriction as aw, type DateRestrictionConfig as ax, type DateShortcutConfig as ay, type DateShortcutType as az, type FormSchema as b, type InitiatorSelectScope as b0, type JSONFieldEditorContext as b1, type JSONFieldRendererContext as b2, type LayoutVisibleWhen as b3, type LinkedFormOptionConfig as b4, type LocationValue as b5, type LowcodePageMeta as b6, type LowcodePageNode as b7, type LowcodePageNodeType as b8, type OptionSourceType as b9, type PeopleShortcutConfig as ba, type PeopleShortcutType as bb, type PreviewImageItem as bc, type ProcessNodeType as bd, ProcessPreview as be, type ProcessPreviewProps as bf, type RuntimeAuthHeadersProvider as bg, type RuntimeDataQueryParams as bh, type RuntimeDataQueryResult as bi, type RuntimeRequestConfig as bj, type RuntimeUploadOptions as bk, type RuntimeUploadProvider as bl, type SectionLayoutNode as bm, type SignaturePoint as bn, type StepLayoutItem as bo, type StepsLayoutNode as bp, type SubFormColumn as bq, type TabLayoutItem as br, type TabsLayoutNode as bs, type TextShortcutConfig as bt, type TextShortcutType as bu, type UserDisplayFormat as bv, type UserItem as bw, type FormRuntimeApiConfig as c, type FormEngineConfig as d, type FieldBehavior as e, type FormRuntimeConfig as f, type FormAppearanceConfig as g, type ValidationRule as h, type FormEffect as i, type OptionSourceConfig as j, type FormDataDeleteParams as k, type ChangeRecordListResponse as l, type FormDataQueryParams as m, type FormInstanceData as n, type InitiatorSelectRequirement as o, type ProcessBasicInfo as p, type ProcessDefinition as q, type ProcessTask as r, type ReturnableNodeResult as s, type ReturnableNode as t, type ViewPermissionQueryParams as u, type ViewPermissionSummary as v, type ApproveParams as w, type PreviewParams as x, type ProcessRoute as y, type ResubmitParams as z };
+export { type FormDataDeleteParams as $, type AddressFieldProps as A, type BaseFieldProps as B, type CascadeDateFieldProps as C, type DataFilter as D, type DepartmentSearchParams as E, type DepartmentSearchResult as F, type DepartmentSearchScope as G, type DepartmentSelectFieldProps as H, type DepartmentTreeNode as I, type DigitalSignatureFieldProps as J, type DigitalSignatureValue as K, type EditorChoiceOption as L, type EditorFieldProps as M, type EditorToolbarAction as N, type FieldBehavior as O, type FieldDefinition as P, type FieldLayoutNode as Q, type FieldValueSyncConfig as R, type FilePreviewCapability as S, type FilePreviewCapabilityBatch as T, type FilePreviewMetadata as U, type FilePreviewProvider as V, type FilePreviewRenderMode as W, type FilePreviewRequest as X, type FilePreviewSurface as Y, type FilePreviewType as Z, type FormAppearanceConfig as _, type AddressValue as a, type RuntimeAuthHeadersProvider as a$, type FormDataQueryParams as a0, type FormEffect as a1, type FormEffectAction as a2, type FormEffectCondition as a3, type FormEffectConditionOperator as a4, type FormEngineConfig as a5, type FormEngineMode as a6, type FormInstanceData as a7, type FormLayoutNode as a8, type FormRuntimeApi as a9, type LowcodePageNodeType as aA, type LowcodePageSchema as aB, type MultiSelectFieldProps as aC, type NumberFieldProps as aD, type OptionItem as aE, type OptionSourceConfig as aF, type OptionSourceType as aG, type PeopleShortcutConfig as aH, type PeopleShortcutType as aI, type PreparedFilePreview as aJ, type PreviewImageItem as aK, type PreviewParams as aL, type ProcessAction as aM, type ProcessBasicInfo as aN, type ProcessDefinition as aO, type ProcessNodeType as aP, ProcessPreview as aQ, type ProcessPreviewProps as aR, type ProcessRoute as aS, type ProcessStatus as aT, type ProcessTask as aU, type RadioFieldProps as aV, type ResubmitParams as aW, type ReturnParams as aX, type ReturnPolicy as aY, type ReturnableNode as aZ, type ReturnableNodeResult as a_, type FormRuntimeApiConfig as aa, type FormRuntimeConfig as ab, type FormSchema as ac, FormSection as ad, type FormSectionProps as ae, type FormSubmitBehavior as af, type FormTemplateConfig as ag, type GridLayoutCell as ah, type GridLayoutNode as ai, type ImageCompressionConfig as aj, type ImageCompressionVariantConfig as ak, type ImageFieldProps as al, type ImageVariant as am, type InitiatorSelectCandidate as an, type InitiatorSelectRequirement as ao, type InitiatorSelectScope as ap, type InitiatorSelectedApprovers as aq, type JSONFieldEditorContext as ar, type JSONFieldProps as as, type JSONFieldRendererContext as at, type LayoutVisibleWhen as au, type LinkedFormOptionConfig as av, type LocationFieldProps as aw, type LocationValue as ax, type LowcodePageMeta as ay, type LowcodePageNode as az, type ApprovalActionType as b, type RuntimeDataQueryParams as b0, type RuntimeDataQueryResult as b1, type RuntimeRequestConfig as b2, type RuntimeResponse as b3, type RuntimeUploadOptions as b4, type RuntimeUploadProvider as b5, type SaveTaskParams as b6, type SectionLayoutNode as b7, type SelectFieldProps as b8, type SerialNumberFieldProps as b9, type SignaturePoint as ba, type StandardFormPageMode as bb, type StatusMeta as bc, type StepLayoutItem as bd, type StepsLayoutNode as be, type SubFormColumn as bf, type SubFormFieldProps as bg, type TabLayoutItem as bh, type TabsLayoutNode as bi, type TaskStatus as bj, type TextAreaFieldProps as bk, type TextFieldProps as bl, type TextShortcutConfig as bm, type TextShortcutType as bn, type TransferParams as bo, type UserDisplayFormat as bp, type UserItem as bq, type UserSelectFieldProps as br, type ValidationPreset as bs, type ValidationRule as bt, type ViewPermissionQueryParams as bu, type ViewPermissionSummary as bv, type WithdrawParams as bw, type ApprovalPermission as c, ApprovalTimeline as d, type ApprovalTimelineProps as e, type ApproveParams as f, type AssociationFormConfig as g, type AssociationFormFieldProps as h, type AssociationValue as i, type AttachmentFieldProps as j, type AttachmentImageVariants as k, type AttachmentItem as l, type BaseLayoutNode as m, type CascadeSelectFieldProps as n, type ChangeRecord as o, type ChangeRecordListResponse as p, type ChangeRecordQueryParams as q, type CheckboxFieldProps as r, type DataLinkageCondition as s, type DataLinkageConfig as t, type DateFieldProps as u, type DateRangeRestriction as v, type DateRestrictionConfig as w, type DateShortcutConfig as x, type DateShortcutType as y, type DefaultValueLinkageConfig as z };