npm - openxiangda-skill-kit - Versions diffs - 2.0.0-alpha.37 → 2.0.0-alpha.38 - Mend

openxiangda-skill-kit 2.0.0-alpha.37 → 2.0.0-alpha.38

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/docs/architecture/best-practice-template-rebuild-v2.md +1 -1
package/docs/architecture/field-component-migration-matrix-v1-to-v2.md +8 -11
package/docs/architecture/proven-field-components-and-standard-surfaces-v2.md +14 -6
package/docs/field-components.md +93 -0
package/docs/frontend.md +2 -2
package/docs/index.md +2 -0
package/docs/llms.txt +1 -0
package/package.json +1 -1
package/skills/openxiangda-v2-frontend/SKILL.md +9 -7

package/docs/architecture/best-practice-template-rebuild-v2.md CHANGED Viewed

@@ -184,7 +184,7 @@ Admin 工作台还原本轮决策：
 | Shell | 任一路径恰好一个菜单选中；标签边界对齐；无全局搜索和内容区重复标题；直接 URL、关闭、恢复、身份/环境切换正确 |
 | 视觉 | PC 冻结稿尺寸 1536x1024（并补充 1280x800 结构检查）；移动 390x844、375x812 截图回归 |
 | 数据 | 默认一行与更多筛选、服务端搜索/排序/分页、四类列表设置、空/错/加载、revision 冲突 |
-| 字段 | 官方验收表单覆盖 `text/textarea/number/money/percent/boolean/date/datetime/dateRange/option/options/radio/checkbox/cascade/user/users/department/departments/attachments/images/address/location/richtext/signature/subtable/json/serial/relation/workflowStatus` |
+| 字段 | 官方验收表单覆盖 `text/textarea/number/money/percent/boolean/date/datetime/dateRange/option/options/radio/checkbox/cascade/user/users/department/departments/attachments/images/address/location/richtext/signature/subtable/json/serial/workflowStatus`；关联表单组件弃用 |
 | 目录 | 打开即能看到真实根组织；树展开、搜索、路径、单选/多选和失败重试 |
 | 身份 | 页面显示真实姓名/部门；正则扫描页面不存在裸 UUID |
 | 流程 | 提交前没有预览；保存和 prepare 后弹窗；预览仅含具体审批人路径；Surface DataRef 可读业务数据；同意、拒绝、转交、回退、加签和代理按 Surface 展示 |

package/docs/architecture/field-component-migration-matrix-v1-to-v2.md CHANGED Viewed

@@ -1,11 +1,9 @@
 # OpenXiangda 1.x → 2.0 全量字段组件迁移矩阵
-状态：2026-08-18 已实现并验证
+状态：2026-08-18 已完成并通过组件、模板与三端回归验证
 关联决策：[`proven-field-components-and-standard-surfaces-v2.md`](./proven-field-components-and-standard-surfaces-v2.md)
-1.x 基线：`tools/openxiangda/packages/sdk/src/components/core/defaultRegistry.ts`
 ## 1. 迁移原则
 - “复用 1.0”指复用已经验证的功能、信息顺序、交互状态、错误反馈和移动端适配，不在 2.0
@@ -21,15 +19,15 @@
 | 1.x Registry 名称 | 2.0 `FieldKind` | 2.0 稳定值 | Desktop / Mobile 行为基线 | 当前实施状态 |
 | --- | --- | --- | --- | --- |
-| `TextField` | `text` | `string \| null` | 单行输入、placeholder、长度/必填、只读文本 | 已完成，纳入回归 |
-| `NumberField` | `number` / `money` / `percent` | `number \| null` | 数值边界、精度、单位；移动数字输入 | 已完成，纳入回归 |
-| `TextAreaField` / `TextareaField` | `textarea` | `string \| null` | 多行自适应、长度/必填、只读换行 | 已完成，纳入回归 |
+| `TextField` | `text` | `string \| null` | 单行输入、placeholder、长度/计数、清空、前后缀、只读文本 | 已完成 |
+| `NumberField` | `number` / `money` / `percent` | `number \| null` | 数值边界、步长、精度、单位位置、千分位；移动数字输入 | 已完成 |
+| `TextAreaField` / `TextareaField` | `textarea` | `string \| null` | 多行自适应、最少/最多行、长度/计数、只读换行 | 已完成 |
 | `SelectField` | `option` | `{label,value} \| null` | 搜索、清空、禁用项、稳定标签回显 | 已完成，纳入回归 |
-| `MultiSelectField` | `options` | `{label,value}[]` | 多选、响应式标签、移动 Popup/CheckList | 已完成，纳入回归 |
+| `MultiSelectField` | `options` | `{label,value}[]` | 多选、最大数量、响应式标签、移动 Popup/CheckList | 已完成 |
 | `RadioField` | `radio` | `{label,value} \| null` | 单选组、禁用项、只读标签 | 已完成，纳入回归 |
 | `CheckboxField` | `checkbox` | `{label,value}[]` | 多选组、禁用项、只读标签集合 | 已完成，纳入回归 |
 | `DateField` | `date` / `datetime` | ISO/格式化日期字符串或 `null` | 日期与日期时间选择、清空、只读格式化 | 已完成，纳入回归 |
-| `CascadeDateField` | `dateRange` | `[start,end]` | 成对日期、范围校验、移动分步选择 | 已完成，纳入回归 |
+| `CascadeDateField` | `dateRange` | `[start,end]` | 成对日期、可选日期限制、范围校验、移动分步选择 | 已完成 |
 | `AttachmentField` | `attachments` | `StableAttachmentValue[]` | 上传进度、取消/重试、预览、下载、删除、同名文件不合并 | 已完成 |
 | `ImageField` | `images` | `StableAttachmentValue[]`，`variant=image` | 图片选择、缩略图、预览、上传状态、删除 | 已完成 |
 | `SubFormField` | `subtable` | `Record<string,unknown>[]` | 行增删、子字段编辑、最少/最多行、只读明细 | 已完成 |
@@ -37,7 +35,7 @@
 | `DepartmentSelectField` | `department` / `departments` | `{label,value}` 或数组 | 部门树、路径、搜索、单/多选 | 已完成，纳入回归 |
 | `CascadeSelectField` | `cascade` | `{label,value}[]` 路径 | 级联路径、叶子选择、清空、只读路径 | 已完成，纳入回归 |
 | `AddressField` | `address` | `StableAddressValue` | 省市区级联、详细地址、完整地址回显 | 已完成，纳入回归 |
-| `AssociationFormField` | `relation` | `{label,value}` 或数组 | 资源检索、分页、稳定 record id、只读跳转信息 | 已完成，纳入回归 |
+| `AssociationFormField` | 不迁移 | - | 平台组件弃用；复杂关联查询由应用页面和 App API 实现 | 已确认弃用 |
 | `EditorField` | `richtext` | 清洗后的 HTML `string` | 常用格式、链接安全、移动简化工具栏、只读二次清洗 | 已完成 |
 | `SerialNumberField` | `serial` | 平台生成的 `string \| null` | 创建前占位、创建后只读，不允许客户端伪造 | 已完成，纳入回归 |
 | `LocationField` | `location` | `StableLocationValue` | 钉钉优先、浏览器降级、地址/坐标/精度、重定位/清空 | 已完成 |
@@ -69,8 +67,7 @@
 ## 5. 验收清单
-- Registry 中 22 个名称全部有明确的 2.0 映射，`EmployeeSelectField` 和 `TextareaField` 作为别名
-  不重复实现。
+- 除已明确弃用的关联表单外，1.0 标准字段都有明确的 2.0 映射；别名不重复实现。
 - 每种 `FieldKind` 至少有值归一化测试；关键字段有 Desktop、Mobile、只读和失败态测试。
 - `attachments` 与 `images` 只能绑定到真实声明为 `file` 的 DataResource 字段。
 - 同名不同 `fileId` 的文件保留两份；相同 `fileId` 或同一稳定 URL 只显示一份。

package/docs/architecture/proven-field-components-and-standard-surfaces-v2.md CHANGED Viewed

@@ -1,6 +1,6 @@
 # 经过验证的平台字段组件与三端标准页面决策
-状态：2026-08-18 已实现并通过开发、三端与完整本地运行时验证
+状态：2026-08-18 已实现并通过组件、模板、三端与完整本地运行时验证
 适用范围：OpenXiangda 2.0 `openxiangda-contracts`、`openxiangda-field-kit`、
 `openxiangda-user`、官方应用模板及其本地验收夹具。OpenXiangda 1.x 运行时、
@@ -62,9 +62,13 @@
 9. Admin、业务用户 PC 与 Mobile 使用相同 route/data/workflow 合同；三端可以有独立页面组合，
    不能维护第二份数据、权限或流程状态。
-公开受影响面包括：contracts 的签名值类型、Field Kit 的 Desktop/Mobile 导出与样式、
-User 包的 Desktop 入口、模板 DataResource/Surface/fixture、参考应用路由与测试。Native Data
-API 的文件安全语义和现有 URL 不变化。
+公开受影响面包括：Field Kit 的 Desktop/Mobile/Readonly 导出与样式、User 包的标准页面、
+模板 DataResource/Surface/fixture、组件使用指南和参考应用路由与测试。Native Data API 的文件
+安全语义和现有 URL 不变化。
+本轮采用简单目录和单一 Registry。1.x 只提供已验证的功能、样式、交互与移动端基线，不建立
+逐文件追溯、兼容运行时或第二套协议。组件通过一个 `fileService` 调用既有 2.0 文件接口，页面和
+字段组件不感知 initiate/PUT/complete/delete-unbound 的步骤。
 ## 4. 失败、并发与清理行为
@@ -75,8 +79,9 @@ API 的文件安全语义和现有 URL 不变化。
 - 预览 Object URL 在关闭、替换和卸载时释放；预览失败保留下载动作和可重试错误。
 - 定位优先使用钉钉能力，失败后降级浏览器 Geolocation；超时、拒绝和不支持分别显示可恢复错误。
 - 签名保存只接受非空轨迹，生成图片和哈希任一步失败都不覆盖原值；重复保存以最后一次成功值为准。
-- 富文本迁移 1.x 的格式编辑与安全只读能力；在平台提供可事务绑定的嵌套文件合同前，工具栏不开放
-  会产生未绑定文件的本地图片上传。编辑器销毁后不得提交迟到回调。
+- 富文本迁移 1.x 的完整格式、表格、链接、图片、粘贴/拖拽与安全只读能力。需要上传图片时，
+  Surface 显式提供一个声明为 `file` 的伴随字段，编辑器仍通过同一个 `fileService` 上传；未配置时
+  保留图片 URL，不建立旁路上传协议。编辑器销毁后不得提交迟到回调。
 - Workflow prepare/start 使用既有 revision、token 和幂等键；审批人解析为空时保留节点编码并引导修正配置。
 ## 5. 安全与资源上限
@@ -110,6 +115,9 @@ API 的文件安全语义和现有 URL 不变化。
 新增验收资源可随模板 AppVersion 回滚；既有 `purchase_requests` 数据和文件绑定不修改。
 1.x 仓库、已发布 1.x 包、其他租户和当前生产 Head 不引用本次未发布源码，影响面为零。
+`relation`/关联表单不再属于 Field Kit 标准组件，不迁移到新模板。普通供应商选择使用单选、
+下拉或应用自己的业务页面；复杂关联查询由应用 App API 和页面自行实现。
 ## 8. 可证伪验收
 1. Desktop/Mobile 连续上传两个同名文件时，每个服务端 `fileId` 只显示一次；上传成功不保留本地副本。

package/docs/field-components.md ADDED Viewed

@@ -0,0 +1,93 @@
+# 平台字段组件使用指南
+OpenXiangda 2.0 应用的持久化表单字段统一使用 `openxiangda-field-kit`。桌面端从
+`openxiangda-field-kit/desktop` 导入，移动端从 `openxiangda-field-kit/mobile` 导入；列表、
+详情和只读状态使用对应的 `FieldValue`。应用可以自由组合页面，但不要在业务页面重新实现字段值、
+文件上传、人员部门目录、地址、定位或签名协议。
+## 基本用法
+```tsx
+import { DesktopFieldControl, DesktopFieldValue } from 'openxiangda-field-kit/desktop';
+<DesktopFieldControl
+  definition={{ code: 'amount', label: '预算金额', kind: 'money', precision: 2 }}
+  value={values.amount}
+  onChange={amount => setValues(current => ({ ...current, amount }))}
+/>
+<DesktopFieldValue
+  definition={{ code: 'amount', label: '预算金额', kind: 'money', precision: 2 }}
+  value={values.amount}
+/>
+```
+移动端替换为 `MobileFieldControl` 与 `MobileFieldValue`。平台目录、地址、定位和文件字段还需要传入
+当前应用的 `FieldPlatformContext`；标准 Admin/User 页面已经自动提供。
+常用体验配置继续沿用 1.0 的语义：文本支持 `maxLength`、`showCount`、前后缀和清空；数值支持
+`min`、`max`、`step`、`precision`、单位位置和千分位；日期支持今天之前、今天之后或自定义区间；
+多选支持 `maxCount`，子表支持 `minRows` / `maxRows`。这些都是页面行为，不改变 2.0 稳定值协议。
+标准模板锁定 Ant Design 的尺寸、圆角和密度，不开放会造成三端样式分裂的任意 `variant` / `size` 覆盖。
+## 什么时候使用哪个组件
+| 需求 | 使用 | 不应使用 |
+| --- | --- | --- |
+| 标题、名称、编号 | `text` | 不用富文本 |
+| 多行纯文本说明 | `textarea` | 不需要格式时不用 `richtext` |
+| 表格、链接、图片和带格式正文 | `richtext` | 简单备注不用它 |
+| 数量、金额、比例 | `number` / `money` / `percent` | 不用文本保存可计算数值 |
+| 少量互斥选项 | `radio` | 选项很多时用 `option` |
+| 少量并列多选 | `checkbox` | 选项很多时用 `options` |
+| 平台成员与组织 | `user(s)` / `department(s)` | 不用自由文本或复制组织树 |
+| 邮寄或行政区地址 | `address` | 需要经纬度时用 `location` |
+| 现场打点、签到 | `location` | 普通地址填写不用定位 |
+| 任意类型文件 | `attachments` | 只收图片时使用 `images` |
+| 照片、截图、凭证 | `images` | 不要直接使用 Ant Upload |
+| 同一表单的多行明细 | `subtable` | 独立生命周期的大量记录应建资源页面 |
+| 现场手写确认 | `signature` | 法律电子签章接专业签署服务 |
+| 流程状态展示 | `workflowStatus` | 不允许页面直接编辑流程状态 |
+完整机器可读清单由 `fieldCatalog` 导出，包含每个 `FieldKind` 的值协议、适用和不适用场景。
+关联表单组件已经弃用。普通关联选择使用 `option`、`radio` 或文本；需要分页检索、复杂权限和业务
+联动时，由应用通过 NestJS App API 实现独立页面，不把业务查询重新塞进通用字段组件。
+## 附件和图片
+DataResource 中对应字段必须声明为 `type: 'file'`。组件保留 1.0 已验证的上传、进度、取消、失败
+重试、预览、下载和删除交互；底层由一个 `fileService` 调用 2.0 Native Files API。应用不接触
+`initiate → PUT → complete → delete-unbound` 细节，也不要拼接对象存储地址。
+```ts
+{ code: 'attachments', type: 'file', nullable: true,
+  file: { multiple: true, maxCount: 10, maxSizeMb: 50 } }
+```
+同名文件不会合并；只按平台 `fileId` 或稳定 URL 去重。图片字段可以配置 `imageCompression`，但页面
+不能放宽 DataResource 已声明的数量、类型和大小限制。
+## 富文本图片
+富文本本身仍保存清洗后的 HTML 字符串。需要上传内嵌图片时，把 `richTextImageFieldCode` 指向同一
+资源中真实的 `file` 字段；标准表单会把上传结果追加到该文件字段，确保记录保存时完成文件绑定。
+```ts
+{
+  code: 'description',
+  label: '详细说明',
+  kind: 'richtext',
+  richTextToolbar: 'full',
+  richTextImageFieldCode: 'images',
+}
+```
+没有配置伴随文件字段时，桌面编辑器仍支持图片 URL，但不会开放本地图片上传。
+## 验收要求
+- 编辑、禁用、只读和空值均可用。
+- 必填标识紧邻标签；提交失败定位到第一个错误字段。
+- Desktop 与 Mobile 使用独立 renderer，移动入口不加载桌面 Ant Design 录入控件。
+- 附件、图片、富文本、人员、部门、地址、定位和签名必须在标准模板真实保存后回显。

package/docs/frontend.md CHANGED Viewed

@@ -53,11 +53,11 @@ OpenXiangda 2.0 桌面管理端采用 React 19、Ant Design 6、Umi Max 4、ProC
 ## Field Kit 与移动用户端
-所有平台字段使用 `openxiangda-field-kit` 的稳定值协议。人员、部门、单选、多选、单选框、复选框、日期、日期区间、地址、关联、图片、附件、数值等都由统一定义驱动存储与显示。
+所有平台字段使用 `openxiangda-field-kit` 的稳定值协议。人员、部门、单选、多选、单选框、复选框、日期、日期区间、地址、图片、附件、富文本和数值等都由统一定义驱动存储与显示。组件选型见[平台字段组件使用指南](./field-components.md)。
 - 桌面 Admin 从 `openxiangda-field-kit/desktop` 使用 Ant Design 控件。
 - 移动用户端由 `openxiangda-user/mobile` 提供工作台、数据列表/表单/详情和流程提交/任务/实例页面，并从 `openxiangda-field-kit/mobile` 使用 Ant Design Mobile 的独立字段交互；不把桌面 Select、DatePicker 或 Cascader 缩小后复用。
-- 人员、部门、行政区、关联数据、上传、下载和预览都通过平台 API；应用不自行复制平台目录或文件协议。
+- 人员、部门、行政区、上传、下载和预览都通过平台 API；应用不自行复制平台目录或文件协议。关联表单平台组件已弃用，复杂关联查询由应用页面和 App API 实现。
 - UI 必填、默认值、显隐、布局和帮助文本属于页面层；后端业务不应假设自定义页面一定执行了前端校验。
 生成模板将桌面 Admin 与移动用户端放在同一个 AppPackage 的两个独立懒加载路由树中；`/admin` 只加载 Pro 页面，`/m` 只加载 `openxiangda-user/mobile`，根入口按设备能力一次性选择。移动 Chromium 已验证两棵树不混用 DOM，并覆盖稳定角色切换、列表/详情、流程发起与平台特殊字段。

package/docs/index.md CHANGED Viewed

@@ -23,3 +23,5 @@ features:
 OpenXiangda 2.0 保留平台统一数据与治理能力，同时把应用开发恢复成成熟的前后端工程。本工具链只面向 2.0 应用；旧应用由独立的 1.x 产品线维护。
 当前能力的完成证据、真实缺口和实施顺序见[实施路线图与证据矩阵](/architecture/implementation-roadmap)。Admin 已确认[全量切换到 Ant Design Pro v6](/architecture/ant-design-pro-v6-admin-foundation)，不再维护自研 Shell/Vite 双轨。实现前先阅读[环境配置内核](/architecture/environment-configuration-kernel-v2)、[Alpha 退役与 Native 切换前置审计](/architecture/native-kernel-inventory-v2)、[原生配置投影蓝图](/architecture/native-configuration-projection-v2)与[授权一致性内核](/architecture/authorization-consistency-v2)，Admin 页面协议建立在这些可验证的运行时事实之上。
+开发表单、列表或详情前阅读[平台字段组件使用指南](/field-components)，按场景选择桌面、移动和只读组件。

package/docs/llms.txt CHANGED Viewed

@@ -3,6 +3,7 @@
 - /getting-started.md: standard workspace and development loop
 - /concepts.md: application, platform, data, runtime, and version boundaries
 - /frontend.md: React admin shell, role session, CRUD, workflow UI
+- /field-components.md: platform field catalog, usage, selection rules, file and rich-text examples
 - /backend.md: NestJS modules, identity, Data API, health, secrets
 - /data-authz.md: RBAC plus contextual data and field authorization
 - /workflow-events.md: Workflow Kernel v2, providers, actions, durable events

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda-skill-kit",
-  "version": "2.0.0-alpha.37",
+  "version": "2.0.0-alpha.38",
   "description": "Validation and deterministic packaging for OpenXiangda 2.0 AI skills.",
   "type": "module",
   "main": "./dist/index.js",

package/skills/openxiangda-v2-frontend/SKILL.md CHANGED Viewed

@@ -23,13 +23,15 @@ Build in `apps/web` with React 19, Ant Design 6, Umi Max 4 and ProComponents 3.
 ## Platform fields and mobile user UI
 1. Use `openxiangda-field-kit/desktop` in the desktop Admin. Build the independent mobile tree with `OpenXiangdaUserProvider` from `openxiangda-user` and the standard pages from `openxiangda-user/mobile`; those pages consume `openxiangda-field-kit/mobile`. Mobile is not a CSS-responsive copy of the Admin.
-2. Platform fields include all supported kinds, not only personnel and files: text/textarea, number/money/percent, boolean, single/multiple select, radio/checkbox/cascade, date/datetime/date range, user/users, department/departments, relation, address/location, image/attachments, signature, subtable/JSON, serial and workflow status.
-3. Persist established stable values. Directory/option/relation values use `{ label, value }`; address, location and attachment values use the `openxiangda-field-kit` types. Never replace them with display-only strings or Ant Design component instances.
-4. Personnel, departments, administrative divisions, relations, uploads, downloads and previews must use platform APIs. Do not copy platform directory data or write a second upload protocol.
-5. Keep database declarations minimal: field code, storage type, nullability, index and storage constraints. Required/default/hidden/layout/help/conditional display are page behavior. A custom page may implement different UI validation, so critical business rules must also be enforced by NestJS/Data API policy.
-6. Render list/detail values by field kind. Show readable labels, tags, formatted dates/numbers/amounts, address text, user/department identity, image preview and attachment download instead of raw JSON or internal IDs.
-7. Prefer `MobileAppShell`, `MobileWorkbenchPage`, `MobileResourceListPage`, `MobileResourceFormPage`, `MobileResourceDetailPage`, `MobileWorkflowSubmissionPage`, `MobileWorkflowWorkCenterPage`, `MobileWorkflowTaskPage` and `MobileWorkflowInstancePage`. The Workflow submission page must show only the business form and one Submit action until save and prepare succeed; only then open the approval preview.
-8. Keep the mobile package out of NestJS dependencies. The browser may call only platform-relative Native clients under the current RoleSession; it must not persist platform tokens, service addresses, permission decisions or business responses.
+2. Before choosing a field, read [Platform field components](../../docs/field-components.md) or the exported `fieldCatalog`. It records every kind's value contract, when to use it and when not to use it.
+3. Platform fields include text/textarea/richtext, number/money/percent, boolean, single/multiple select, radio/checkbox/cascade, date/datetime/date range, user/users, department/departments, address/location, image/attachments, signature, subtable/JSON, serial and workflow status. The association-form/relation platform component is discontinued; use option/radio for ordinary choices or an application page plus App API for complex relation queries.
+4. Persist established stable values. Directory and option values use `{ label, value }`; address, location and attachment values use the `openxiangda-field-kit` types. Never replace them with display-only strings or Ant Design component instances.
+5. Personnel, departments, administrative divisions, uploads, downloads and previews must use platform APIs. Do not copy platform directory data or write a second upload protocol. Do not use Ant Upload or a raw file input in an application page for a persistent file field.
+6. Use `attachments` for general files and `images` when thumbnail/preview/photo selection is required. The DataResource field must be `file`. Rich-text local images require `richTextImageFieldCode` pointing to a companion `file` field so uploaded files bind with the saved record.
+7. Keep database declarations minimal: field code, storage type, nullability, index and storage constraints. Required/default/hidden/layout/help/conditional display are page behavior. A custom page may implement different UI validation, so critical business rules must also be enforced by NestJS/Data API policy.
+8. Render list/detail values by field kind. Show readable labels, tags, formatted dates/numbers/amounts, address text, user/department identity, image preview and attachment download instead of raw JSON or internal IDs.
+9. Prefer `MobileAppShell`, `MobileWorkbenchPage`, `MobileResourceListPage`, `MobileResourceFormPage`, `MobileResourceDetailPage`, `MobileWorkflowSubmissionPage`, `MobileWorkflowWorkCenterPage`, `MobileWorkflowTaskPage` and `MobileWorkflowInstancePage`. The Workflow submission page must show only the business form and one Submit action until save and prepare succeed; only then open the approval preview.
+10. Keep the mobile package out of NestJS dependencies. The browser may call only platform-relative Native clients under the current RoleSession; it must not persist platform tokens, service addresses, permission decisions or business responses.
 ## Verification