@cxtms/cx-schema 1.6.5 → 1.6.7

package/.claude/skills/cx-module/SKILL.md

@@ -15,8 +15,8 @@ You are a CargoXplorer module YAML builder. You generate schema-valid YAML for C
 - **List schemas**: `npx cx-cli list`
 - **Extract**: `npx cx-cli extract <source> <component> --to <target>` — move components between modules
 - **Feature folder**: `npx cx-cli create module <name> --template <template> --feature <feature-name>`
-- **Push to server**: `npx cx-cli appmodule push <file.yaml>` — creates or updates module on the CX server
-- **Delete from server**: `npx cx-cli appmodule delete <appModuleId>` — removes a module by UUID
+- **Deploy to server**: `npx cx-cli appmodule deploy <file.yaml>` — creates or updates module on the CX server
+- **Undeploy from server**: `npx cx-cli appmodule undeploy <appModuleId>` — removes a module by UUID
 - **Publish all**: `npx cx-cli publish [--feature <name>]` — push all modules and workflows to the server
 
 ## Generation Workflow
@@ -209,7 +209,7 @@ module:
   description:
     en-US: "Module description"
   application: "CargoXplorer"             # Required
-  fileName: "modules/<name>-module.yaml"  # File path in repo
+  filePath: "modules/<name>-module.yaml"  # File path in repo
 
 entities:
   - name: <EntityName>
@@ -397,24 +397,24 @@ Reusable select components (e.g., `Countries/Select`, `Ports/Select`) follow thi
 
 ## Server Module Commands
 
-### Push / Delete
+### Deploy / Undeploy
 
 ```bash
-# Push a module YAML to the server (creates or updates)
-npx cx-cli appmodule push modules/my-module.yaml
+# Deploy a module YAML to the server (creates or updates)
+npx cx-cli appmodule deploy modules/my-module.yaml
 
-# Push with explicit org ID
-npx cx-cli appmodule push modules/my-module.yaml --org 42
+# Deploy with explicit org ID
+npx cx-cli appmodule deploy modules/my-module.yaml --org 42
 
-# Delete an app module by UUID
-npx cx-cli appmodule delete <appModuleId>
+# Undeploy an app module by UUID
+npx cx-cli appmodule undeploy <appModuleId>
 
 # Publish all modules and workflows (validates first)
 npx cx-cli publish
 npx cx-cli publish --feature billing
 ```
 
-Push reads `module.appModuleId` from the YAML, queries the server, and creates or updates accordingly. Requires an active session (`cx-cli login` or PAT token — see cx-core skill).
+Deploy reads `module.appModuleId` from the YAML, queries the server, and creates or updates accordingly. Requires an active session (`cx-cli login` or PAT token — see cx-core skill).
 
 ---
 
@@ -428,9 +428,9 @@ Push reads `module.appModuleId` from the YAML, queries the server, and creates o
    - Route paths: kebab-case (e.g., `/warehouse-locations`)
    - Permission names: PascalCase with slashes (e.g., `WarehouseLocations/Read`, `System/Contacts/Update`)
 4. **Template expressions** use `{{ expression }}` syntax (double curly braces)
-5. **Include fileName** property pointing to the YAML file location
+5. **Include filePath** property pointing to the YAML file location
 6. **Set proper entityKind** when defining entities (Order, Contact, OrderEntity, AccountingTransaction, Calendar, CalendarEvent, Other)
 7. **DataGrid options** requires ALL properties: query, rootEntityName, entityKeys, navigationType, enableDynamicGrid, enableViews, enableSearch, enablePagination, enableColumns, enableFilter, defaultView, onRowClick
 8. **Form component** requires `validationSchema` in props
-9. **Do not change `appModuleId` or `fileName`** — set correctly by CLI scaffold
+9. **Do not change `appModuleId` or `filePath`** — set correctly by CLI scaffold
 10. **Always validate** the final YAML: `npx cx-cli <file.yaml>`

package/.claude/skills/cx-workflow/SKILL.md

@@ -13,8 +13,8 @@ You are a CargoXplorer workflow YAML builder. You generate schema-valid YAML for
 - **Examples**: `npx cx-cli example <task>` — show example YAML for a task
 - **List schemas**: `npx cx-cli list --type workflow` — shows all available task schemas in the Tasks section
 - **Feature folder**: `npx cx-cli create workflow <name> --template <template> --feature <feature-name>`
-- **Push to server**: `npx cx-cli workflow push <file.yaml>` — creates or updates workflow on the CX server
-- **Delete from server**: `npx cx-cli workflow delete <workflowId>` — removes a workflow by UUID
+- **Deploy to server**: `npx cx-cli workflow deploy <file.yaml>` — creates or updates workflow on the CX server
+- **Undeploy from server**: `npx cx-cli workflow undeploy <workflowId>` — removes a workflow by UUID
 - **Execute**: `npx cx-cli workflow execute <workflowId|file.yaml> [--vars '<json>']` — trigger a workflow execution
 - **List logs**: `npx cx-cli workflow logs <workflowId|file.yaml> [--from YYYY-MM-DD] [--to YYYY-MM-DD]` — list executions with log availability
 - **Download log**: `npx cx-cli workflow log <executionId> [--json] [--console] [--output <file>]` — download execution log
@@ -315,21 +315,21 @@ Implicit variable: `iteration` (zero-based).
 
 ## Server Workflow Commands
 
-### Push / Delete
+### Deploy / Undeploy
 
 ```bash
 # Push a workflow YAML to the server (creates or updates)
-npx cx-cli workflow push workflows/my-workflow.yaml
+npx cx-cli workflow deploy workflows/my-workflow.yaml
 
 # Delete a workflow by UUID
-npx cx-cli workflow delete <workflowId>
+npx cx-cli workflow undeploy <workflowId>
 
 # Publish all modules and workflows (validates first)
 npx cx-cli publish
 npx cx-cli publish --feature billing
 ```
 
-Push reads `workflow.workflowId` from the YAML, queries the server, and creates or updates accordingly. Requires an active session (`cx-cli login` or PAT token — see cx-core skill).
+Deploy reads `workflow.workflowId` from the YAML, queries the server, and creates or updates accordingly. Requires an active session (`cx-cli login` or PAT token — see cx-core skill).
 
 ### Execute
 

package/dist/cli.js

@@ -114,8 +114,8 @@ ${chalk_1.default.bold.yellow('COMMANDS:')}
   ${chalk_1.default.green('logout')}          Logout from a CX environment
   ${chalk_1.default.green('pat')}             Manage personal access tokens (create, list, revoke)
   ${chalk_1.default.green('orgs')}            List, select, or set active organization
-  ${chalk_1.default.green('appmodule')}       Manage app modules on a CX server (push, delete)
-  ${chalk_1.default.green('workflow')}        Manage workflows on a CX server (push, delete, execute, logs, log)
+  ${chalk_1.default.green('appmodule')}       Manage app modules on a CX server (deploy, undeploy)
+  ${chalk_1.default.green('workflow')}        Manage workflows on a CX server (deploy, undeploy, execute, logs, log)
   ${chalk_1.default.green('publish')}         Publish all modules and workflows to a CX server
   ${chalk_1.default.green('schema')}          Show JSON schema for a component or task
   ${chalk_1.default.green('example')}         Show example YAML for a component or task
@@ -245,21 +245,21 @@ ${chalk_1.default.bold.yellow('ORG COMMANDS:')}
   ${chalk_1.default.cyan(`${PROGRAM_NAME} orgs use`)}
 
 ${chalk_1.default.bold.yellow('APPMODULE COMMANDS:')}
-  ${chalk_1.default.gray('# Push a module YAML to the server (creates or updates)')}
-  ${chalk_1.default.cyan(`${PROGRAM_NAME} appmodule push modules/my-module.yaml`)}
+  ${chalk_1.default.gray('# Deploy a module YAML to the server (creates or updates)')}
+  ${chalk_1.default.cyan(`${PROGRAM_NAME} appmodule deploy modules/my-module.yaml`)}
 
-  ${chalk_1.default.gray('# Push with explicit org ID')}
-  ${chalk_1.default.cyan(`${PROGRAM_NAME} appmodule push modules/my-module.yaml --org 42`)}
+  ${chalk_1.default.gray('# Deploy with explicit org ID')}
+  ${chalk_1.default.cyan(`${PROGRAM_NAME} appmodule deploy modules/my-module.yaml --org 42`)}
 
-  ${chalk_1.default.gray('# Delete an app module by UUID')}
-  ${chalk_1.default.cyan(`${PROGRAM_NAME} appmodule delete <appModuleId>`)}
+  ${chalk_1.default.gray('# Undeploy an app module by UUID')}
+  ${chalk_1.default.cyan(`${PROGRAM_NAME} appmodule undeploy <appModuleId>`)}
 
 ${chalk_1.default.bold.yellow('WORKFLOW COMMANDS:')}
-  ${chalk_1.default.gray('# Push a workflow YAML to the server (creates or updates)')}
-  ${chalk_1.default.cyan(`${PROGRAM_NAME} workflow push workflows/my-workflow.yaml`)}
+  ${chalk_1.default.gray('# Deploy a workflow YAML to the server (creates or updates)')}
+  ${chalk_1.default.cyan(`${PROGRAM_NAME} workflow deploy workflows/my-workflow.yaml`)}
 
-  ${chalk_1.default.gray('# Delete a workflow by UUID')}
-  ${chalk_1.default.cyan(`${PROGRAM_NAME} workflow delete <workflowId>`)}
+  ${chalk_1.default.gray('# Undeploy a workflow by UUID')}
+  ${chalk_1.default.cyan(`${PROGRAM_NAME} workflow undeploy <workflowId>`)}
 
   ${chalk_1.default.gray('# Execute a workflow')}
   ${chalk_1.default.cyan(`${PROGRAM_NAME} workflow execute <workflowId|file.yaml>`)}
@@ -1844,10 +1844,10 @@ async function resolveOrgId(domain, token, override) {
     console.error(chalk_1.default.gray(`\n  Run \`cx-cli orgs select\` to choose, or pass --org <id>.\n`));
     process.exit(2);
 }
-async function runAppModulePush(file, orgOverride) {
+async function runAppModuleDeploy(file, orgOverride) {
     if (!file) {
         console.error(chalk_1.default.red('Error: File path required'));
-        console.error(chalk_1.default.gray(`Usage: ${PROGRAM_NAME} appmodule push <file.yaml> [--org <id>]`));
+        console.error(chalk_1.default.gray(`Usage: ${PROGRAM_NAME} appmodule deploy <file.yaml> [--org <id>]`));
         process.exit(2);
     }
     if (!fs.existsSync(file)) {
@@ -1876,7 +1876,7 @@ async function runAppModulePush(file, orgOverride) {
     if (!appManifestId && session.app_manifest_id) {
         appManifestId = session.app_manifest_id;
     }
-    console.log(chalk_1.default.bold.cyan('\n  AppModule Push\n'));
+    console.log(chalk_1.default.bold.cyan('\n  AppModule Deploy\n'));
     console.log(chalk_1.default.gray(`  Server:  ${new URL(domain).hostname}`));
     console.log(chalk_1.default.gray(`  Org:     ${orgId}`));
     console.log(chalk_1.default.gray(`  Module:  ${appModuleId}`));
@@ -1930,17 +1930,17 @@ async function runAppModulePush(file, orgOverride) {
         console.log(chalk_1.default.green(`  ✓ Created: ${mod?.name || appModuleId}\n`));
     }
 }
-async function runAppModuleDelete(uuid, orgOverride) {
+async function runAppModuleUndeploy(uuid, orgOverride) {
     if (!uuid) {
         console.error(chalk_1.default.red('Error: AppModule ID required'));
-        console.error(chalk_1.default.gray(`Usage: ${PROGRAM_NAME} appmodule delete <appModuleId> [--org <id>]`));
+        console.error(chalk_1.default.gray(`Usage: ${PROGRAM_NAME} appmodule undeploy <appModuleId> [--org <id>]`));
         process.exit(2);
     }
     const session = resolveSession();
     const domain = session.domain;
     const token = session.access_token;
     const orgId = await resolveOrgId(domain, token, orgOverride);
-    console.log(chalk_1.default.bold.cyan('\n  AppModule Delete\n'));
+    console.log(chalk_1.default.bold.cyan('\n  AppModule Undeploy\n'));
     console.log(chalk_1.default.gray(`  Server:  ${new URL(domain).hostname}`));
     console.log(chalk_1.default.gray(`  Org:     ${orgId}`));
     console.log(chalk_1.default.gray(`  Module:  ${uuid}`));
@@ -2087,10 +2087,10 @@ async function runOrgsSelect() {
 // ============================================================================
 // Workflow Commands
 // ============================================================================
-async function runWorkflowPush(file, orgOverride) {
+async function runWorkflowDeploy(file, orgOverride) {
     if (!file) {
         console.error(chalk_1.default.red('Error: File path required'));
-        console.error(chalk_1.default.gray(`Usage: ${PROGRAM_NAME} workflow push <file.yaml> [--org <id>]`));
+        console.error(chalk_1.default.gray(`Usage: ${PROGRAM_NAME} workflow deploy <file.yaml> [--org <id>]`));
         process.exit(2);
     }
     if (!fs.existsSync(file)) {
@@ -2109,7 +2109,7 @@ async function runWorkflowPush(file, orgOverride) {
         process.exit(2);
     }
     const workflowName = parsed?.workflow?.name || workflowId;
-    console.log(chalk_1.default.bold.cyan('\n  Workflow Push\n'));
+    console.log(chalk_1.default.bold.cyan('\n  Workflow Deploy\n'));
     console.log(chalk_1.default.gray(`  Server:    ${new URL(domain).hostname}`));
     console.log(chalk_1.default.gray(`  Org:       ${orgId}`));
     console.log(chalk_1.default.gray(`  Workflow:  ${workflowName}`));
@@ -2156,17 +2156,17 @@ async function runWorkflowPush(file, orgOverride) {
         console.log(chalk_1.default.green(`  ✓ Created: ${workflowName}\n`));
     }
 }
-async function runWorkflowDelete(uuid, orgOverride) {
+async function runWorkflowUndeploy(uuid, orgOverride) {
     if (!uuid) {
         console.error(chalk_1.default.red('Error: Workflow ID required'));
-        console.error(chalk_1.default.gray(`Usage: ${PROGRAM_NAME} workflow delete <workflowId> [--org <id>]`));
+        console.error(chalk_1.default.gray(`Usage: ${PROGRAM_NAME} workflow undeploy <workflowId> [--org <id>]`));
         process.exit(2);
     }
     const session = resolveSession();
     const domain = session.domain;
     const token = session.access_token;
     const orgId = await resolveOrgId(domain, token, orgOverride);
-    console.log(chalk_1.default.bold.cyan('\n  Workflow Delete\n'));
+    console.log(chalk_1.default.bold.cyan('\n  Workflow Undeploy\n'));
     console.log(chalk_1.default.gray(`  Server:    ${new URL(domain).hostname}`));
     console.log(chalk_1.default.gray(`  Org:       ${orgId}`));
     console.log(chalk_1.default.gray(`  Workflow:  ${uuid}`));
@@ -2721,7 +2721,7 @@ async function runPublish(featureDir, orgOverride) {
     console.log(chalk_1.default.gray(`\n  Found ${workflowFiles.length} workflow(s), ${moduleFiles.length} module(s)\n`));
     let succeeded = 0;
     let failed = 0;
-    // Step 3: Push workflows
+    // Step 3: Deploy workflows
     for (const file of workflowFiles) {
         const relPath = path.relative(process.cwd(), file);
         const result = await pushWorkflowQuiet(domain, token, orgId, file);
@@ -2734,7 +2734,7 @@ async function runPublish(featureDir, orgOverride) {
             failed++;
         }
     }
-    // Step 4: Push modules
+    // Step 4: Deploy modules
     for (const file of moduleFiles) {
         const relPath = path.relative(process.cwd(), file);
         const result = await pushModuleQuiet(domain, token, orgId, file, appManifestId);
@@ -3925,15 +3925,15 @@ async function main() {
     // Handle appmodule command (no schemas needed)
     if (command === 'appmodule') {
         const sub = files[0];
-        if (sub === 'push') {
-            await runAppModulePush(files[1], options.orgId);
+        if (sub === 'deploy') {
+            await runAppModuleDeploy(files[1], options.orgId);
         }
-        else if (sub === 'delete') {
-            await runAppModuleDelete(files[1], options.orgId);
+        else if (sub === 'undeploy') {
+            await runAppModuleUndeploy(files[1], options.orgId);
         }
         else {
             console.error(chalk_1.default.red(`Unknown appmodule subcommand: ${sub || '(none)'}`));
-            console.error(chalk_1.default.gray(`Usage: ${PROGRAM_NAME} appmodule <push|delete> ...`));
+            console.error(chalk_1.default.gray(`Usage: ${PROGRAM_NAME} appmodule <deploy|undeploy> ...`));
             process.exit(2);
         }
         process.exit(0);
@@ -3941,11 +3941,11 @@ async function main() {
     // Handle workflow command (no schemas needed)
     if (command === 'workflow') {
         const sub = files[0];
-        if (sub === 'push') {
-            await runWorkflowPush(files[1], options.orgId);
+        if (sub === 'deploy') {
+            await runWorkflowDeploy(files[1], options.orgId);
         }
-        else if (sub === 'delete') {
-            await runWorkflowDelete(files[1], options.orgId);
+        else if (sub === 'undeploy') {
+            await runWorkflowUndeploy(files[1], options.orgId);
         }
         else if (sub === 'execute') {
             await runWorkflowExecute(files[1], options.orgId, options.vars);
@@ -3958,7 +3958,7 @@ async function main() {
         }
         else {
             console.error(chalk_1.default.red(`Unknown workflow subcommand: ${sub || '(none)'}`));
-            console.error(chalk_1.default.gray(`Usage: ${PROGRAM_NAME} workflow <push|delete|execute|logs|log> ...`));
+            console.error(chalk_1.default.gray(`Usage: ${PROGRAM_NAME} workflow <deploy|undeploy|execute|logs|log> ...`));
             process.exit(2);
         }
         process.exit(0);