openxiangda 1.0.189 → 1.0.190

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "1.0.189",
+  "version": "1.0.190",
   "description": "OpenXiangda CLI, workspace build tools, runtime SDK, and form components.",
   "private": false,
   "bin": {

package/templates/openxiangda-react-spa/.cursor/rules/openxiangda-form.mdc

@@ -0,0 +1,24 @@
+---
+description: src/forms/** — Use openxiangda-form skill
+globs: src/forms/**/*
+alwaysApply: false
+---
+
+# OpenXiangda React SPA Form Files
+
+Editing `src/forms/<formCode>/`. Use the **`openxiangda-form`** skill.
+
+- Keep field/schema rules in `schema.ts` and presentation in `page.tsx`.
+- Prefer OpenXiangda platform fields, then `antd` / `antd-mobile`; do not use native inputs, hand-written uploaders, pickers, or user/department selectors.
+- Option fields require non-empty `options`; linked data uses `SelectField` with `optionSource.type: "linkedForm"`.
+- Top-level `schema.rules` is only for `FormEffect[]`; validation belongs to field `rules`.
+- Do not recreate platform system fields. Use `behavior: "HIDDEN"` + `valueSync` for derived or permission keys.
+
+Release with exact scope:
+
+```bash
+openxiangda resource plan form-setting --only <formCode> --profile <name>
+openxiangda resource publish form-setting --only <formCode> --change <change> --profile <name>
+```
+
+Managed production activation only occurs through candidate → preproduction deploy/test → promotion of the same candidate.

package/templates/openxiangda-react-spa/.cursor/rules/openxiangda-page.mdc

@@ -0,0 +1,25 @@
+---
+description: src/pages/** — Use openxiangda-page skill
+globs: src/pages/**/*
+alwaysApply: false
+---
+
+# OpenXiangda React SPA Page Files
+
+Editing `src/pages/`. Use the **`openxiangda-page`** skill.
+
+- Keep routes in `src/app/router.tsx` and navigation in `src/app/navigation.ts`.
+- Split complex pages into thin views, `domain/`, `shared/{services,hooks}/`, `components/`, and styles.
+- Use server pagination and structured `filterGroup`; never fetch an oversized page and filter in the browser.
+- Prefer OpenXiangda platform components for platform data fields and `antd` / `antd-mobile` for ordinary UI.
+- Do not use native form controls, hand-written pickers/uploaders, or frontend-only authorization.
+
+Build and stage:
+
+```bash
+pnpm typecheck
+pnpm build
+openxiangda runtime deploy --no-activate --change <change> --profile <name>
+```
+
+Managed production activation only occurs through candidate → preproduction deploy/test → promotion of the same candidate.

package/templates/openxiangda-react-spa/.cursor/rules/openxiangda-workflow-automation.mdc

@@ -0,0 +1,26 @@
+---
+description: src/{workflows,automations,js-code-nodes,functions}/** — Use openxiangda-workflow-automation skill
+globs: src/{workflows,automations,js-code-nodes,functions}/**/*
+alwaysApply: false
+---
+
+# OpenXiangda React SPA Workflow / Automation / Function Files
+
+Use the **`openxiangda-workflow-automation`** skill for workflows, automations, JS_CODE, and App Functions.
+
+- Ordinary lifecycle state changes use a status field, domain state machine, and automation; create workflows only for real approval semantics.
+- Prefer App Functions for reusable backend logic. JS_CODE is for cross-form, batch, process, platform API, external HTTP, and complex orchestration.
+- Keep UI interactions, normal validation, and display logic in React.
+- Log important backend steps with `ctx.logger`; obtain third-party credentials only through declared `secretRefs`.
+- Never copy workflow, automation, or function IDs across profiles.
+
+Build and release with exact scope:
+
+```bash
+pnpm typecheck:js-code
+pnpm build-js-code --script <code>
+openxiangda resource plan <workflow|automation|function> --only <code> --profile <name>
+openxiangda resource publish <workflow|automation|function> --only <code> --change <change> --profile <name>
+```
+
+Managed production activation only occurs through candidate → preproduction deploy/test → promotion of the same candidate.

package/templates/openxiangda-react-spa/.qoder/rules/openxiangda-form.md

@@ -0,0 +1,37 @@
+---
+description: src/forms/** glob — 精准引导到 openxiangda-form skill
+glob: src/forms/**/*
+alwaysApply: false
+---
+
+# OpenXiangda React SPA Form Files
+
+You are editing files under `src/forms/<formCode>/`. Use the **`openxiangda-form`** skill.
+
+## Required structure
+
+```text
+src/forms/<formCode>/
+├── schema.ts   # defineFormSchema() default export
+└── page.tsx    # presentation only
+```
+
+## Common pitfalls
+
+- 平台字段组件优先于 `antd` / `antd-mobile` 包装和自定义业务组件。
+- `schema.ts` 定义字段、选项、规则与行为；`page.tsx` 只负责展示。
+- 禁止直接写原生 `<input>` / `<select>` / `<textarea>` / file input，禁止手写人员、部门、上传和 picker 组件。
+- 选项字段必须提供非空 `options`；跨表数据使用 `SelectField` + `optionSource.type: "linkedForm"`。
+- 顶层 `schema.rules` 只用于 `FormEffect[]`；字段校验放字段自己的 `rules`。
+- 平台系统字段由平台维护，不要重复创建。
+- 派生键和隐式权限键使用 `behavior: "HIDDEN"` + `valueSync`。
+
+## Release
+
+```bash
+openxiangda resource validate form-setting --only <formCode> --profile <name>
+openxiangda resource plan form-setting --only <formCode> --profile <name>
+openxiangda resource publish form-setting --only <formCode> --change <change> --profile <name>
+```
+
+正式环境托管发布仍必须走 candidate → preproduction deploy/test → 同 candidate promotion，禁止直接激活生产资源。

package/templates/openxiangda-react-spa/.qoder/rules/openxiangda-page.md

@@ -0,0 +1,29 @@
+---
+description: src/pages/** glob — 精准引导到 openxiangda-page skill
+glob: src/pages/**/*
+alwaysApply: false
+---
+
+# OpenXiangda React SPA Page Files
+
+You are editing files under `src/pages/`. Use the **`openxiangda-page`** skill.
+
+## Strong defaults
+
+- 路由集中维护在 `src/app/router.tsx`，应用导航维护在 `src/app/navigation.ts`。
+- 复杂页面拆分为薄视图、`domain/`、`shared/{services,hooks}/`、`components/` 和样式文件。
+- 默认使用原生 Tailwind utilities，不使用未配置的 shadcn token。
+- 列表必须服务端分页并使用结构化 `filterGroup`；禁止抓取超大页后在浏览器过滤。
+- 平台数据字段优先使用 OpenXiangda 平台组件；普通 UI 使用 `antd` / `antd-mobile`。
+- 禁止原生表单控件、手写 picker/uploader/人员部门选择器。
+- 后端权限、公开访问 grants 与 App Function 检查才是授权依据；前端只做展示保护。
+
+## Release
+
+```bash
+pnpm typecheck
+pnpm build
+openxiangda runtime deploy --no-activate --change <change> --profile <name>
+```
+
+Runtime 只暂存到候选发布；正式环境托管发布必须走 candidate → preproduction deploy/test → 同 candidate promotion。

package/templates/openxiangda-react-spa/.qoder/rules/openxiangda-workflow-automation.md

@@ -0,0 +1,34 @@
+---
+description: src/{workflows,automations,js-code-nodes,functions}/** glob — 精准引导到 openxiangda-workflow-automation skill
+glob: src/{workflows,automations,js-code-nodes,functions}/**/*
+alwaysApply: false
+---
+
+# OpenXiangda React SPA Workflow / Automation / Function Files
+
+Use the **`openxiangda-workflow-automation`** skill when editing:
+
+- `src/workflows/<code>/workflow.ts`
+- `src/automations/<code>/index.ts`
+- `src/js-code-nodes/<code>/index.ts`
+- `src/functions/<code>/index.ts`
+
+## Boundaries
+
+- 普通 `pending → processing → resolved → closed` 使用状态字段、领域状态机与 automation；只有真实审批语义才创建 workflow。
+- 复用后端业务逻辑优先 App Function；JS_CODE 用于跨表、批量、流程、平台 API、外部 HTTP 与复杂编排。
+- UI 交互、普通表单校验和展示逻辑留在 React 代码，不放进 JS_CODE。
+- 每个关键步骤使用 `ctx.logger.debug/info/warn/error`；第三方凭据只通过 `secretRefs` 与 `ctx.secrets.get()` 获取。
+- workflowId / automationId / functionId 不得跨 profile 复制。
+
+## Build and release
+
+```bash
+pnpm typecheck:js-code
+pnpm build-js-code --script <code>
+openxiangda resource validate <workflow|automation|function> --only <code> --profile <name>
+openxiangda resource plan <workflow|automation|function> --only <code> --profile <name>
+openxiangda resource publish <workflow|automation|function> --only <code> --change <change> --profile <name>
+```
+
+资源发布只生成候选子版本；正式环境托管发布必须走 candidate → preproduction deploy/test → 同 candidate promotion。

package/templates/openxiangda-react-spa/scripts/guard-publish.mjs

@@ -9,7 +9,7 @@ const lines = [
   '  openxiangda resource publish <type> --only <codes> --change <change> --profile <name>',
   '  openxiangda runtime deploy --no-activate --change <change> --profile <name>',
   '',
-  '正式激活后还必须 merge/push 冻结 SHA，再执行 release integration-status 与 release end。',
+  '发布前必须先把批准的提交合并并 push 到权威主线；激活后直接执行 release integration-status 与 release end。',
   '',
   'legacy lowcode-workspace publish-all 只用于旧 classic workspace 的兼容流程。',
   '',