openxiangda 1.0.110 → 1.0.111

package/lib/cli.js

@@ -132,7 +132,7 @@ Usage:
   openxiangda menu update|sort [--json-file file] [--write-manifest]
   openxiangda menu bind <menuCode> --menu-id <id>
   openxiangda workflow compile <workflow.ts> [--check] [--stdout] [--out-definition file] [--out-preview file]
-  openxiangda workflow list [--profile name] [--form-code code] [--json]
+  openxiangda workflow list [--profile name] [--form-code code] [--json] [--all]
   openxiangda workflow create <workflowCode> --form-code <formCode> --definition-json <file>
   openxiangda workflow bind <workflowCode> --workflow-id <id>
   openxiangda workflow publish <workflowCode|workflowId>
@@ -171,6 +171,7 @@ JS_CODE V2 使用 trusted_node；AI 源码必须写在 src/js-code-nodes/<script
 }
 
 const SUBCOMMAND_BOOLEAN_FLAGS = new Set([
+  '--all',
   '--dry-run',
   '--enabled',
   '--force',
@@ -1377,7 +1378,7 @@ async function workspace(args) {
   const [subcommand, ...rest] = args;
   const { flags, positional } = parseArgs(rest);
   if (wantsSubcommandHelp(subcommand, flags)) {
-    print('用法: openxiangda workspace init|bind|publish [--changed [--since ref]|--form code|--page code|--only list] [--dry-run] [--force] [--resources|--skip-resources]');
+    printWorkspaceHelp();
     return;
   }
   const config = loadConfig();
@@ -1527,6 +1528,34 @@ async function workspace(args) {
   fail('用法: openxiangda workspace init|bind|publish [--changed [--since ref]|--form code|--page code|--only list] [--dry-run] [--force] [--resources|--skip-resources]');
 }
 
+function printWorkspaceHelp() {
+  print(`OpenXiangda workspace
+
+Usage:
+  openxiangda workspace init [dir] [--name package-name] [--runtime legacy|react-spa] [--install] [--force]
+  openxiangda workspace init [dir] --profile <name> --app-name <app-name> [--runtime legacy|react-spa] [--description text] [--install] [--force]
+  openxiangda workspace init [dir] --profile <name> --app-type <APP_XXX> [--runtime legacy|react-spa] [--install] [--force]
+  openxiangda workspace bind --profile <name> --app-type <APP_XXX>
+  openxiangda workspace publish --profile <name> [--changed [--since ref]|--form code|--page code|--only list] [--dry-run] [--force] [--resources|--skip-resources] [--prune]
+
+React SPA:
+  openxiangda workspace publish --profile <name> --form <formCode>   # sync form schema only
+  openxiangda resource publish --profile <name>
+  openxiangda runtime deploy --profile <name>
+
+Options:
+  --runtime legacy|react-spa       Workspace template/runtime mode.
+  --app-name <name>                Create and bind a new platform app.
+  --app-type <APP_XXX>             Bind an existing platform app.
+  --form <code>                    Publish one form schema/page.
+  --page <code>                    Publish one classic page.
+  --only pages/a,forms/b           Publish selected classic resources.
+  --changed [--since ref]          Publish changed classic resources.
+  --dry-run                        Show planned work without writing.
+  --resources / --skip-resources   Include or skip src/resources publish.
+  --legacy-form-bundle             Force legacy workspace publish in React SPA workspaces.`);
+}
+
 async function app(args) {
   const [subcommand, ...rest] = args;
   const { flags, positional } = parseArgs(rest);
@@ -1980,7 +2009,7 @@ async function workflow(args) {
   const { subcommand, rest } = parseSubcommandArgs(args);
   const { flags, positional } = parseArgs(rest);
   if (wantsSubcommandHelp(subcommand, flags)) {
-    print('用法: openxiangda workflow compile|list|create|bind|pull|publish|delete|validate [--profile name] [--json]');
+    printWorkflowHelp();
     return;
   }
   const config = loadConfig();
@@ -2041,8 +2070,9 @@ async function workflow(args) {
         }
       )
     );
-    if (flags.json) return writeJson(data);
-    print(JSON.stringify(data, null, 2));
+    const output = flags.all ? data : filterManifestBackedWorkflows(data);
+    if (flags.json) return writeJson(output);
+    print(JSON.stringify(output, null, 2));
     return;
   }
 
@@ -2084,8 +2114,8 @@ async function workflow(args) {
         body: {
           formUuid,
           definitionJson,
-          ...(flags['view-json']
-            ? { viewJson: readJsonArg(flags['view-json'], 'view-json') }
+          ...(flags['preview-json'] || flags['view-json']
+            ? { viewJson: readJsonArg(flags['preview-json'] || flags['view-json'], 'preview-json') }
             : {}),
         },
       }
@@ -2192,6 +2222,49 @@ async function workflow(args) {
   fail('用法: openxiangda workflow compile|list|create|bind|pull|publish|delete|validate');
 }
 
+function printWorkflowHelp() {
+  print(`OpenXiangda workflow
+
+Usage:
+  openxiangda workflow compile <workflow.ts> [--check] [--stdout|--json] [--out-definition file] [--out-preview file]
+  openxiangda workflow list [--profile name] [--form-code code|--form-uuid FORM_XXX] [--published true|false] [--page n] [--page-size n] [--json] [--all]
+  openxiangda workflow create <workflowCode> --form-code <formCode> --definition-json <file> [--preview-json file] [--publish]
+  openxiangda workflow bind <workflowCode> --workflow-id <id> [--form-code code|--form-uuid FORM_XXX]
+  openxiangda workflow pull <workflowCode|workflowId> [--out file] [--json]
+  openxiangda workflow publish <workflowCode|workflowId> [--profile name]
+  openxiangda workflow delete <workflowCode|workflowId> [--yes]
+  openxiangda workflow validate --definition-json <file> [--strict] [--publish]
+
+Notes:
+  - Prefer semantic DSL: src/workflows/<code>/workflow.ts + defineWorkflow().
+  - Run workspace publish --form <formCode> before publishing workflow resources for React SPA process forms.
+  - workflow list hides platform shell workflows with empty resourceCode by default; pass --all to inspect raw platform rows.`);
+}
+
+function filterManifestBackedWorkflows(data) {
+  const shouldKeep = item => item && String(item.resourceCode || '').trim();
+  if (Array.isArray(data)) {
+    return data.filter(shouldKeep);
+  }
+  if (!data || typeof data !== 'object') return data;
+  for (const key of ['data', 'items', 'list', 'records']) {
+    if (Array.isArray(data[key])) {
+      const filtered = data[key].filter(shouldKeep);
+      return {
+        ...data,
+        [key]: filtered,
+        totalCount: Object.prototype.hasOwnProperty.call(data, 'totalCount')
+          ? filtered.length
+          : data.totalCount,
+        total: Object.prototype.hasOwnProperty.call(data, 'total')
+          ? filtered.length
+          : data.total,
+      };
+    }
+  }
+  return data;
+}
+
 async function automation(args) {
   const { subcommand, rest } = parseSubcommandArgs(args);
   const { flags, positional } = parseArgs(rest);

package/openxiangda-skills/SKILL.md

@@ -163,7 +163,7 @@ When the user provides a root domain such as `https://yida.wisejob.cn/`, use it
 - For workflow/automation JS_CODE nodes, prefer V2 `runtimeMode: "trusted_node"`. AI-authored source must be TypeScript under `src/js-code-nodes/<scriptCode>/index.ts`, `src/automations/<resourceCode>/index.ts`, or `src/functions/<functionCode>/index.ts`. `pnpm build-js-code --script <scriptCode>` runs TypeScript validation before bundling, and `sourceFile.localPath` should point to the TS source; the CLI builds, uploads, and replaces it with snapshot metadata during validate/create.
 - Form permission group resources must have stable local codes. Use unique `code` values such as `ticket_reporter_view` and `ticket_repairer_view`; do not rely on the form code when one form has multiple groups.
 - Workflow resources should prefer `workflowFile` + `defineWorkflow` semantic DSL over hand-written raw JSON. For workflows bound by `formCode`, run `openxiangda workspace publish --form <formCode>` first so the process form schema/table is initialized, then run `openxiangda workflow compile <workflow.ts> --check` and `openxiangda resource publish --dry-run --profile <name>` before publish; use `sdk.process.resolveCapabilities(...)` or `ProcessActionBar` / `ProcessTimeline` from `openxiangda/runtime/react` for runtime buttons and timelines instead of hard-coded operation lists.
-- Workflow resources can be created as drafts. After resource publish, verify `openxiangda workflow list --profile <name> --json` and run `openxiangda workflow publish <workflowCode> --profile <name>` until `isPublished: true` is visible.
+- Workflow resources can be created as drafts. After resource publish, verify `openxiangda workflow list --profile <name> --json` and run `openxiangda workflow publish <workflowCode> --profile <name>` until `isPublished: true` is visible. `workflow list` hides platform shell workflows with empty `resourceCode` by default; pass `--all` only when diagnosing raw platform rows.
 
 ## Subskills
 

package/openxiangda-skills/skills/openxiangda-workflow-automation/SKILL.md

@@ -93,7 +93,7 @@ openxiangda form bind customer --form-uuid FORM_XXX --profile dev
    openxiangda workflow list --profile dev --json
    ```
 
-Use `workflow pull` to inspect the live definition. Use `workflow list --json` after publishing and confirm the target shows `isPublished: true`; resource publish can create/update a draft without activating it. Use logical workflow codes locally; never copy a workflow ID from one profile to another.
+Use `workflow pull` to inspect the live definition. Use `workflow list --json` after publishing and confirm the target shows `isPublished: true`; resource publish can create/update a draft without activating it. `workflow list` hides platform shell workflows with empty `resourceCode` by default; use `--all` only for raw platform diagnostics. Use logical workflow codes locally; never copy a workflow ID from one profile to another.
 
 ## JS_CODE V2
 

package/package.json

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