openxiangda 2.2.2 → 2.3.0

package/documentation/getting-started.md

@@ -11,10 +11,10 @@ OpenXiangda 2.0 默认生成 React 应用和共享契约。普通 CRUD、标准
 以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
 
 ```bash
-pnpm dlx openxiangda@2.2.2 skill install --force
-pnpm dlx openxiangda@2.2.2 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.2.2 login --base-url https://platform.example.com
-pnpm dlx openxiangda@2.2.2 create my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.3.0 skill install --force
+pnpm dlx openxiangda@2.3.0 auth status --base-url <平台地址> --json
+pnpm dlx openxiangda@2.3.0 login --base-url https://platform.example.com
+pnpm dlx openxiangda@2.3.0 create my-app --base-url https://platform.example.com
 cd my-app
 pnpm openxiangda context --json
 pnpm openxiangda dev
@@ -114,9 +114,9 @@ MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MC
 无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
 
 ```bash
-pnpm dlx openxiangda@2.2.2 auth status --base-url <平台> --json
-pnpm dlx openxiangda@2.2.2 source resolve <仓库URL> --base-url <平台> --json
-pnpm dlx openxiangda@2.2.2 source clone <仓库URL> <新目录> --base-url <平台> --json
+pnpm dlx openxiangda@2.3.0 auth status --base-url <平台> --json
+pnpm dlx openxiangda@2.3.0 source resolve <仓库URL> --base-url <平台> --json
+pnpm dlx openxiangda@2.3.0 source clone <仓库URL> <新目录> --base-url <平台> --json
 ```
 
 登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回

package/documentation/manifest.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": "openxiangda.documentation/v1",
-  "version": "2.2.2",
+  "version": "2.3.0",
   "topics": [
     {
       "id": "getting-started",
       "title": "安装与开始开发",
       "file": "getting-started.md",
-      "sha256": "2286d8507cc07fec478c2f125b5bc80337d06f3c2fba430ef36539662c872c03"
+      "sha256": "179ed8bd147fd85a7df4035275ccbf5e80d029a8ce6356ae3a9fe3f9ec478419"
     },
     {
       "id": "product-design",
@@ -72,7 +72,7 @@
       "id": "workflow-events",
       "title": "审批、事件与通知",
       "file": "workflow-events.md",
-      "sha256": "e3cf53985f3d9b731e1e7ab25ccbd9225f380aa861d7055957aaf5cccc3b9082"
+      "sha256": "998422cb6270a086fab19848553e7fa20655e062a2c6a724683247df59427b7b"
     },
     {
       "id": "backend",

package/documentation/workflow-events.md

@@ -37,6 +37,64 @@ Head、实例/任务版本、允许的命令集合与 CSRF。命令请求只提
 `expectedTaskVersion`/`expectedInstanceVersion` 不再是合同。冲突必须刷新 Surface，
 不得自动重放旧意图。
 
+### 撤回与业务终止策略
+
+需要按业务时间限制取消时，在固定 Workflow definition 中声明：
+
+```ts
+instanceCommands: {
+  withdraw: { beforeFact: 'startsAt' },
+  terminate: {
+    capability: 'app:reservation-center:meeting:cancel',
+    beforeFact: 'startsAt',
+  },
+},
+```
+
+`beforeFact` 必须是 `inputSchema` 中 required 的根字段，类型为
+`string`、格式为 `date-time`，并通过 `subject.factProjection` 映射到非空
+`datetime` 业务字段。例如定义与模型的相关部分为：
+
+```ts
+// Workflow definition
+inputSchema: {
+  type: 'object',
+  additionalProperties: false,
+  required: ['startsAt'],
+  properties: { startsAt: { type: 'string', format: 'date-time' } },
+},
+subject: {
+  resourceCode: 'meetings',
+  factProjection: { startsAt: 'startsAt' },
+},
+// meetings 模型字段
+fields: [{ code: 'startsAt', label: '开始时间', type: 'datetime', required: true }],
+```
+
+时间值必须携带 `Z` 或 `±HH:mm` 时区，可省略秒的小数部分或使用 1–3 位小数，
+例如 `2026-09-08T09:00:00+08:00`、`2026-09-08T01:00:00.000Z`。
+标准字段和 Data API 将 datetime 规范化为毫秒 ISO 字符串后冻结为事实。
+平台在锁定实例后，
+按数据库当前时间严格判断 `当前时间 < 截止时间`；事先取得 token 不能绕过
+后续的时限或授权检查。缺失或非法事实拒绝执行。Surface 到期禁用操作，
+应用收到冲突后刷新详情，不自动换幂等键重试。
+
+撤回始终只允许发起人。终止允许原应用超级管理员，或当前角色并集拥有
+所声明精确 capability 的用户；capability 必须在同一应用显式声明，不支持
+通配符。该授权同时允许读取对应流程实例的详情及时间线，包括完成后查阅；
+不授予审批、抄送、改派、删除、普通数据读取或管理后台权限。撤销 capability
+后读取和终止权限都失效。撤回、终止均要求填写原因；超级管理员也遵守已声明时限。
+
+不声明 `instanceCommands` 时沿用既有行为；只为终止授权时可以省略其
+`beforeFact`。声明策略的交付包自动要求平台能力
+`workflow.instance-cancellation-policy`，旧平台无法激活该应用版本。
+已经固定该策略的实例存在期间，平台回滚也必须保留策略执行能力。
+发布新 definition 不会改写旧实例固定的 definition 版本，因此不会给旧实例
+补上截止时间或业务管理员终止授权。升级前应盘点存量实例，按各自原定义完成
+或由原有授权主体处置；不要通过重发事件或改写事实迁移策略。已使用新策略的
+实例在截止后及终态仍允许当前被授权的业务管理员查阅，撤销其 capability
+也会撤销这些存量实例的详情读取权限。
+
 ## 事实和消息投影
 
 Workflow 在同一 PostgreSQL 事务中提交状态、fact 和 outbox。每个实例使用严格单调的 `instanceSequence`，每位审批人拥有独立 participant 生命周期。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "2.2.2",
+  "version": "2.3.0",
   "description": "OpenXiangda 2.0 的统一命令、应用 SDK、MCP 与中文 AI 技能资料。",
   "type": "module",
   "main": "./dist/index.js",
@@ -58,13 +58,13 @@
     "antd-mobile": "5.42.3",
     "dayjs": "1.11.18",
     "docx-preview": "0.3.7",
-    "openxiangda-cli": "2.2.3",
-    "openxiangda-contracts": "2.2.2",
-    "openxiangda-devkit-core": "2.2.2",
+    "openxiangda-cli": "2.2.4",
+    "openxiangda-contracts": "2.3.0",
+    "openxiangda-devkit-core": "2.3.0",
     "openxiangda-legacy": "npm:openxiangda@1.0.268",
-    "openxiangda-mcp": "2.0.4",
-    "openxiangda-nest": "2.0.4",
-    "openxiangda-skill-kit": "2.0.5",
+    "openxiangda-mcp": "2.0.5",
+    "openxiangda-nest": "2.0.5",
+    "openxiangda-skill-kit": "2.0.6",
     "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz"
   },
   "peerDependencies": {
@@ -130,18 +130,18 @@
   },
   "openxiangdaRelease": {
     "schemaVersion": "openxiangda.release-notes/v1",
-    "version": "2.2.2",
-    "title": "源码托管能力发现契约修复",
+    "version": "2.3.0",
+    "title": "流程实例撤回期限与业务终止授权",
     "status": "reviewed",
-    "summary": "补齐平台已提供的可选 sourceHosting 字段，修复严格预检拒绝平台能力响应的问题。",
+    "summary": "为标准流程实例增加可选的撤回时间限制和精确业务能力终止授权，应用编译器与平台共用策略校验。",
     "newFeatures": [
-      "本次修复已有能力声明，不要求应用使用托管仓库。"
+      "流程可声明 instanceCommands，以必填时间事实限制撤回，并以同应用的精确能力授权业务管理员终止。"
     ],
     "fixes": [
-      "闭合 Schema 接受 Forgejo provider 和布尔 enabled，同时拒绝未知字段和无效类型。"
+      "阻止未绑定时间事实、跨应用能力和未声明终止能力进入可发布应用包。"
     ],
     "affectedUsers": [
-      "连接已提供 sourceHosting 能力字段的平台的 V2 应用开发者。"
+      "需要限制标准流程撤回时间或授权业务角色终止流程的 V2 应用开发者。"
     ],
     "compatibility": {
       "node": ">=24",
@@ -150,17 +150,20 @@
         "v2"
       ],
       "v1Policy": "V1 引擎与应用契约不变。",
-      "platformPolicy": "兼容包含或未包含可选源码托管能力的平台。"
+      "platformPolicy": "开发与部署需要匹配的共享校验器版本。使用新策略必须由平台提供 workflow.instance-cancellation-policy 1.0.0；平台预检会拒绝不支持该能力的版本。"
     },
     "upgradeSteps": [
-      "将应用 openxiangda 精确依赖升级为 2.2.2，更新锁文件并重新执行正式部署预检。"
+      "将应用 openxiangda 精确依赖升级为 2.3.0，更新锁文件并刷新技能与资料。",
+      "待目标平台部署匹配版本后执行正式检查、测试发布及真实角色验收。"
     ],
     "knownLimitations": [
-      "其他未知平台字段仍按闭合契约拒绝。"
+      "新策略只作用于声明该策略的新定义，不改写既有实例固定的定义。",
+      "撤回和终止的线上执行由平台版本提供；本工具包发布不代表平台已完成部署。",
+      "驳回意见校验与 Data API 事务时钟问题不在本次工具包修复范围。"
     ],
     "issues": [],
-    "sha256": "e45a418150e90adc8658db171afe3bbfef27bb53f6521b7d3cb237decc6dca94",
-    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.2.2"
+    "sha256": "134f47befeec3138041d5eb24558379135456cf2f7d437502643fc5919331ec4",
+    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.3.0"
   },
   "scripts": {
     "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",

package/releases/2.3.0.json

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.3.0",
+  "title": "流程实例撤回期限与业务终止授权",
+  "status": "reviewed",
+  "summary": "为标准流程实例增加可选的撤回时间限制和精确业务能力终止授权，应用编译器与平台共用策略校验。",
+  "newFeatures": [
+    "流程可声明 instanceCommands，以必填时间事实限制撤回，并以同应用的精确能力授权业务管理员终止。"
+  ],
+  "fixes": [
+    "阻止未绑定时间事实、跨应用能力和未声明终止能力进入可发布应用包。"
+  ],
+  "affectedUsers": [
+    "需要限制标准流程撤回时间或授权业务角色终止流程的 V2 应用开发者。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v1",
+      "v2"
+    ],
+    "v1Policy": "V1 引擎与应用契约不变。",
+    "platformPolicy": "开发与部署需要匹配的共享校验器版本。使用新策略必须由平台提供 workflow.instance-cancellation-policy 1.0.0；平台预检会拒绝不支持该能力的版本。"
+  },
+  "upgradeSteps": [
+    "将应用 openxiangda 精确依赖升级为 2.3.0，更新锁文件并刷新技能与资料。",
+    "待目标平台部署匹配版本后执行正式检查、测试发布及真实角色验收。"
+  ],
+  "knownLimitations": [
+    "新策略只作用于声明该策略的新定义，不改写既有实例固定的定义。",
+    "撤回和终止的线上执行由平台版本提供；本工具包发布不代表平台已完成部署。",
+    "驳回意见校验与 Data API 事务时钟问题不在本次工具包修复范围。"
+  ],
+  "issues": [],
+  "sha256": "134f47befeec3138041d5eb24558379135456cf2f7d437502643fc5919331ec4",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.3.0"
+}

package/skills/manifest.json

@@ -4,7 +4,7 @@
     {
       "name": "openxiangda-v2",
       "description": "使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，再开发、检查和交付应用。维护 1.x 应用时使用对应的 1.x 技能。",
-      "sha256": "98f2d5e9241e3a314c545ebc0c747da9b9a6bb08ec0b45b035ab44ecb9179d23"
+      "sha256": "533d36eee4faac5be82c5ad9bd87a1e6803b17be62bf376ed250f73443209203"
     }
   ]
 }

package/skills/openxiangda-v2/SKILL.md

@@ -18,10 +18,10 @@ description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具
 未创建工作区时使用本 Skill 随根包发布的精确版本：
 
 ```bash
-pnpm dlx openxiangda@2.2.2 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.2.2 login --base-url <平台地址>
-pnpm dlx openxiangda@2.2.2 create <应用目录> --base-url <同一平台地址>
-pnpm dlx openxiangda@2.2.2 skill install --force
+pnpm dlx openxiangda@2.3.0 auth status --base-url <平台地址> --json
+pnpm dlx openxiangda@2.3.0 login --base-url <平台地址>
+pnpm dlx openxiangda@2.3.0 create <应用目录> --base-url <同一平台地址>
+pnpm dlx openxiangda@2.3.0 skill install --force
 ```
 
 创建前把产品要求的目标平台明确带入命令，不从旧登录态推断站点。已有工作区从原绑定恢复，平台不一致时先解决登录与目标，不改 link 文件跨站创建。

package/skills/openxiangda-v2/references/getting-started.md

@@ -11,10 +11,10 @@ OpenXiangda 2.0 默认生成 React 应用和共享契约。普通 CRUD、标准
 以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
 
 ```bash
-pnpm dlx openxiangda@2.2.2 skill install --force
-pnpm dlx openxiangda@2.2.2 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.2.2 login --base-url https://platform.example.com
-pnpm dlx openxiangda@2.2.2 create my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.3.0 skill install --force
+pnpm dlx openxiangda@2.3.0 auth status --base-url <平台地址> --json
+pnpm dlx openxiangda@2.3.0 login --base-url https://platform.example.com
+pnpm dlx openxiangda@2.3.0 create my-app --base-url https://platform.example.com
 cd my-app
 pnpm openxiangda context --json
 pnpm openxiangda dev
@@ -114,9 +114,9 @@ MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MC
 无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
 
 ```bash
-pnpm dlx openxiangda@2.2.2 auth status --base-url <平台> --json
-pnpm dlx openxiangda@2.2.2 source resolve <仓库URL> --base-url <平台> --json
-pnpm dlx openxiangda@2.2.2 source clone <仓库URL> <新目录> --base-url <平台> --json
+pnpm dlx openxiangda@2.3.0 auth status --base-url <平台> --json
+pnpm dlx openxiangda@2.3.0 source resolve <仓库URL> --base-url <平台> --json
+pnpm dlx openxiangda@2.3.0 source clone <仓库URL> <新目录> --base-url <平台> --json
 ```
 
 登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回

package/skills/openxiangda-v2/references/workflow-events.md

@@ -37,6 +37,64 @@ Head、实例/任务版本、允许的命令集合与 CSRF。命令请求只提
 `expectedTaskVersion`/`expectedInstanceVersion` 不再是合同。冲突必须刷新 Surface，
 不得自动重放旧意图。
 
+### 撤回与业务终止策略
+
+需要按业务时间限制取消时，在固定 Workflow definition 中声明：
+
+```ts
+instanceCommands: {
+  withdraw: { beforeFact: 'startsAt' },
+  terminate: {
+    capability: 'app:reservation-center:meeting:cancel',
+    beforeFact: 'startsAt',
+  },
+},
+```
+
+`beforeFact` 必须是 `inputSchema` 中 required 的根字段，类型为
+`string`、格式为 `date-time`，并通过 `subject.factProjection` 映射到非空
+`datetime` 业务字段。例如定义与模型的相关部分为：
+
+```ts
+// Workflow definition
+inputSchema: {
+  type: 'object',
+  additionalProperties: false,
+  required: ['startsAt'],
+  properties: { startsAt: { type: 'string', format: 'date-time' } },
+},
+subject: {
+  resourceCode: 'meetings',
+  factProjection: { startsAt: 'startsAt' },
+},
+// meetings 模型字段
+fields: [{ code: 'startsAt', label: '开始时间', type: 'datetime', required: true }],
+```
+
+时间值必须携带 `Z` 或 `±HH:mm` 时区，可省略秒的小数部分或使用 1–3 位小数，
+例如 `2026-09-08T09:00:00+08:00`、`2026-09-08T01:00:00.000Z`。
+标准字段和 Data API 将 datetime 规范化为毫秒 ISO 字符串后冻结为事实。
+平台在锁定实例后，
+按数据库当前时间严格判断 `当前时间 < 截止时间`；事先取得 token 不能绕过
+后续的时限或授权检查。缺失或非法事实拒绝执行。Surface 到期禁用操作，
+应用收到冲突后刷新详情，不自动换幂等键重试。
+
+撤回始终只允许发起人。终止允许原应用超级管理员，或当前角色并集拥有
+所声明精确 capability 的用户；capability 必须在同一应用显式声明，不支持
+通配符。该授权同时允许读取对应流程实例的详情及时间线，包括完成后查阅；
+不授予审批、抄送、改派、删除、普通数据读取或管理后台权限。撤销 capability
+后读取和终止权限都失效。撤回、终止均要求填写原因；超级管理员也遵守已声明时限。
+
+不声明 `instanceCommands` 时沿用既有行为；只为终止授权时可以省略其
+`beforeFact`。声明策略的交付包自动要求平台能力
+`workflow.instance-cancellation-policy`，旧平台无法激活该应用版本。
+已经固定该策略的实例存在期间，平台回滚也必须保留策略执行能力。
+发布新 definition 不会改写旧实例固定的 definition 版本，因此不会给旧实例
+补上截止时间或业务管理员终止授权。升级前应盘点存量实例，按各自原定义完成
+或由原有授权主体处置；不要通过重发事件或改写事实迁移策略。已使用新策略的
+实例在截止后及终态仍允许当前被授权的业务管理员查阅，撤销其 capability
+也会撤销这些存量实例的详情读取权限。
+
 ## 事实和消息投影
 
 Workflow 在同一 PostgreSQL 事务中提交状态、fact 和 outbox。每个实例使用严格单调的 `instanceSequence`，每位审批人拥有独立 participant 生命周期。