openxiangda-skill-kit 2.0.0-alpha.117 → 2.0.0-alpha.118

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda-skill-kit",
-  "version": "2.0.0-alpha.117",
+  "version": "2.0.0-alpha.118",
   "description": "Validation and deterministic packaging for OpenXiangda 2.0 AI skills.",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,7 +17,7 @@
     "README.md"
   ],
   "dependencies": {
-    "openxiangda-devkit-core": "2.0.0-alpha.95"
+    "openxiangda-devkit-core": "2.0.0-alpha.96"
   },
   "devDependencies": {
     "tsx": "4.23.12",

package/skills/openxiangda-v2/references/frontend.md

@@ -175,3 +175,13 @@ Generated contracts intentionally emit each resource Surface once in
 `resourceSurfaces`; `resourceDefinitions[code].surface` references that shared
 object. Import the generated runtime definitions normally. Do not serialize,
 inline or duplicate Surface literals in application code.
+
+The standard Workflow detail renderers consume only the authoritative Surface:
+`presentation.businessDetail`, `presentation.summary`, the typed timeline and
+operation descriptors. Continue to use `SurfaceFieldValue` for complete field
+semantics and the Workflow-scoped file client for attachments, rich-text images
+and signatures. Keep desktop and mobile renderers structurally independent;
+place decision actions in the fixed primary group, all low-frequency actions in
+the single more-actions entry, and collect comments in the action confirmation
+layer. Do not copy the standard page into an application merely to show full
+business fields or rearrange platform-owned operations.

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

@@ -154,6 +154,23 @@ channel snapshots. Omitting `detailRouteCode` keeps the standard pages. A
 declared but missing or incompatible route fails closed rather than falling
 back silently.
 
+When `detailRouteCode` is omitted, use the platform standard detail page. Its
+Surface carries `presentation.businessDetail`, pinned to the instance Data
+logical revision, declaration digest, physical resource and requested record
+revision, then filtered by the current user's field policy. Parent and subtable
+resources stay on that same logical revision and each subtable is bounded to
+200 rows. Render the provided summary, full field Surface, typed timeline and
+server-owned operation descriptors; do not infer labels, operation hierarchy
+or field semantics from codes in application code. Desktop and mobile have
+independent renderers, low-frequency operations live under one more-actions
+entry, and comments are collected only after an operation is selected.
+
+Files, rich-text images and signatures on this page use only the Workflow
+instance-scoped preview/content client. Every request is rebound to the current
+principal, authorized instance, projected resource/record/field and managed
+file id. Never substitute the ordinary Data API file route or put credentials
+in a file URL.
+
 Standard launch entry is also a platform Surface. Desktop uses
 `/admin/workflows/:workflowCode/new` and mobile uses
 `/m/workflows/:workflowCode/start`; both first load
@@ -204,4 +221,4 @@ Use Fake Channel before a real Adapter. Verify create, update, close, reconcile,
 
 ## Verification
 
-Run the workspace generate/check/test/build gates plus real current-user positive and negative role-union cases. Acceptance must include submit, approve, reject, return/resubmit, transfer, delegate, before/after add-sign, withdraw, terminate, duplicate commands, stale revisions, repeated callbacks, full terminal card updates, detail navigation and 1.x zero-touch evidence.
+Run the workspace generate/check/test/build gates plus real current-user positive and negative role-union cases. Acceptance must include full business-detail projection, bounded parent/subtable reads, Workflow-scoped files, independent desktop/mobile renderers, submit, approve, reject, return/resubmit, transfer, delegate, before/after add-sign, withdraw, terminate, duplicate commands, stale revisions, repeated callbacks, full terminal card updates, detail navigation and 1.x zero-touch evidence.