@cxtms/cx-schema 1.7.17 → 1.8.1

package/templates/module-configuration.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Configuration Module
-# Generated by cxtms create module --template configuration
+# Generated by cx-cli create module --template configuration
 
 module:
   name: "{{displayNameNoSpaces}}"
@@ -8,37 +8,103 @@ module:
     en-US: "{{displayName}}"
   description:
     en-US: "{{displayName}} configuration module"
-  application: System
+  application: CargoXplorer
+  fileName: "{{fileName}}"
 
 components:
-  - name: Configurations/{{displayNameNoSpaces}}
+  - name: {{displayNameNoSpaces}}/Configuration
     displayName:
-      en-US: "{{displayName}} Config"
-    platforms:
-      - web
+      en-US: "{{displayName}}"
     layout:
-      component: layout
-      name: {{displayNameNoSpaces}}ConfigLayout
+      component: form
+      name: {{name}}Form
       props:
-        cols: 1
         title:
-          en-US: "{{displayName}} Configuration"
-        icon: Create
-        permission: System/OrganizationConfigs/Update
+          en-US: "{{displayName}}"
+        queries:
+          - name: getConfiguration
+            query:
+              command: |
+                query GetConfiguration($organizationId: Int!) {
+                  configuration(organizationId: $organizationId) {
+                    settingName
+                    maxRetries
+                    enableNotifications
+                  }
+                }
+              variables:
+                organizationId: "\{{organizationId}}"
+        initialValues:
+          fromQuery:
+            name: getConfiguration
+            path: configuration
+          append:
+            settingName: "Default Setting"
+            maxRetries: 3
+            enableNotifications: true
+        validationSchema:
+          settingName:
+            type: string
+            required: true
+          maxRetries:
+            type: number
+            required: true
+          enableNotifications:
+            type: boolean
+        onSubmit:
+          - type: mutation
+            props:
+              command: |
+                mutation SaveConfiguration($organizationId: Int!, $input: ConfigurationInput!) {
+                  saveConfiguration(organizationId: $organizationId, input: $input) {
+                    success
+                  }
+                }
+              variables:
+                organizationId: "\{{organizationId}}"
+                input: "\{{formValues}}"
+          - type: notification
+            props:
+              message:
+                en-US: "{{displayName}} saved successfully"
+              severity: success
       children:
         - component: field
-          name: customValues.enabled
+          name: settingName
+          props:
+            label:
+              en-US: "Setting Name"
+            type: text
+            required: true
+        - component: field
+          name: maxRetries
+          props:
+            label:
+              en-US: "Max Retries"
+            type: number
+        - component: field
+          name: enableNotifications
           props:
-            type: checkbox
             label:
-              en-US: "Enable {{displayName}}"
+              en-US: "Enable Notifications"
+            type: checkbox
 
-configurations:
-  - configName: "apps.{{name}}"
+routes:
+  - name: configuration
+    path: /{{name}}
+    component: {{displayNameNoSpaces}}/Configuration
+    props:
+      title:
+        en-US: "{{displayName}}"
+
+permissions:
+  - name: "{{displayNameNoSpaces}}/View"
     displayName:
-      en-US: "{{displayName}}"
-    description:
-      en-US: "{{displayName}} configuration"
-    component: "Configurations/{{displayNameNoSpaces}}"
-    defaultValue:
-      enabled: false
+      en-US: "View {{displayName}}"
+    roles:
+      - Admin
+  - name: "{{displayNameNoSpaces}}/Edit"
+    displayName:
+      en-US: "Edit {{displayName}}"
+    roles:
+      - Admin

package/templates/module-form.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Form Module
-# Generated by cxtms create module --template form
+# Generated by cx-cli create module --template form
 
 module:
   name: "{{displayNameNoSpaces}}"
@@ -8,8 +8,8 @@ module:
     en-US: "{{displayName}}"
   description:
     en-US: "{{displayName}} module"
-  application: System
-  filePath: "{{fileName}}"
+  application: CargoXplorer
+  fileName: "{{fileName}}"
 
 components:
   - name: {{displayNameNoSpaces}}/Detail

package/templates/module-grid.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Module
-# Generated by cxtms create module --template grid
+# Generated by cx-cli create module --template grid
 
 module:
   name: "{{displayNameNoSpaces}}"
@@ -8,8 +8,8 @@ module:
     en-US: "{{displayName}}"
   description:
     en-US: "{{displayName}} module"
-  application: System
-  filePath: "{{fileName}}"
+  application: CargoXplorer
+  fileName: "{{fileName}}"
 
 components:
   - name: {{displayNameNoSpaces}}/List

package/templates/module-select.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Select Module
-# Generated by cxtms create module --template select
+# Generated by cx-cli create module --template select
 
 module:
   name: "{{displayNameNoSpaces}}"
@@ -8,8 +8,8 @@ module:
     en-US: "{{displayName}}"
   description:
     en-US: "{{displayName}} async select component"
-  application: System
-  filePath: "{{fileName}}"
+  application: CargoXplorer
+  fileName: "{{fileName}}"
 
 components:
   - name: {{displayNameNoSpaces}}/Select

package/templates/module.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Module
-# Generated by cxtms create module
+# Generated by cx-cli create module
 
 module:
   name: "{{name}}"
@@ -8,8 +8,7 @@ module:
   description: "{{displayName}} module"
   icon: "folder"
   version: "1.0"
-  application: System
-  filePath: "{{fileName}}"
+  fileName: "{{fileName}}"
 
 entities:
   - name: {{name}}

package/templates/workflow-api-tracking.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cxtms create workflow --template api-tracking
+# Generated by cx-cli create workflow --template api-tracking
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-basic.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cxtms create workflow --template basic
+# Generated by cx-cli create workflow --template basic
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-document.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cxtms create workflow --template document
+# Generated by cx-cli create workflow --template document
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-entity-trigger.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cxtms create workflow --template entity-trigger
+# Generated by cx-cli create workflow --template entity-trigger
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-ftp-edi.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cxtms create workflow --template ftp-edi
+# Generated by cx-cli create workflow --template ftp-edi
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-ftp-tracking.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cxtms create workflow --template ftp-tracking
+# Generated by cx-cli create workflow --template ftp-tracking
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-mcp-tool.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cxtms create workflow --template mcp-tool
+# Generated by cx-cli create workflow --template mcp-tool
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-public-api.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cxtms create workflow --template public-api
+# Generated by cx-cli create workflow --template public-api
 #
 # This workflow exposes a public REST API endpoint.
 # The api section defines the route, method, authentication, and OpenAPI metadata.

package/templates/workflow-scheduled.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cxtms create workflow --template scheduled
+# Generated by cx-cli create workflow --template scheduled
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-utility.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cxtms create workflow --template utility
+# Generated by cx-cli create workflow --template utility
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-webhook.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cxtms create workflow --template webhook
+# Generated by cx-cli create workflow --template webhook
 #
 # Endpoint: POST /api/v2/orgs/{organizationId}/webhooks/{workflowId}
 # The endpoint is anonymous (no auth token required) and rate-limited (10/sec, 100/min per IP).

package/templates/workflow.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cxtms create workflow
+# Generated by cx-cli create workflow
 
 workflow:
   workflowId: "{{uuid}}"

package/.claude/skills/cx-core/ref-cli-auth.md

@@ -1,120 +0,0 @@
-# CX Server Authentication & Management
-
-## Contents
-- Authentication (OAuth2 login/logout)
-- PAT Tokens (CI/CD alternative to OAuth)
-- Organization Management
-- Session Resolution
-- Publish (push modules and workflows to server)
-
-## Authentication
-
-```bash
-# Login to a CX environment (OAuth2 + PKCE — opens browser)
-npx cxtms login https://tms-v3-dev.usatrt.com
-
-# Logout from current session
-npx cxtms logout
-```
-
-The session is stored at `~/.cxtms/<project-dir>/.session.json`, scoped by project directory name. Each project gets its own server session. The CLI auto-refreshes expired tokens.
-
-## PAT Tokens (alternative to OAuth)
-
-For CI/CD or headless environments, use Personal Access Tokens instead of interactive OAuth:
-
-```bash
-# Check PAT status and setup instructions
-npx cxtms pat setup
-
-# Create a new PAT token (requires OAuth login first)
-npx cxtms pat create "my-ci-token"
-
-# List active PAT tokens
-npx cxtms pat list
-
-# Revoke a PAT token
-npx cxtms pat revoke <tokenId>
-```
-
-After creating a PAT, add to `.env` in your project root:
-```
-CXTMS_AUTH=pat_xxxxx...
-CXTMS_SERVER=https://tms-v3-dev.usatrt.com
-```
-
-When `CXTMS_AUTH` is set, the CLI skips OAuth and uses the PAT token directly. `CXTMS_SERVER` provides the server URL (or set `server` in `app.yaml`).
-
-## Organization Management
-
-```bash
-# List organizations on the server
-npx cxtms orgs list
-
-# Select an organization interactively
-npx cxtms orgs select
-
-# Set active organization by ID
-npx cxtms orgs use <orgId>
-
-# Show current context (server, org, app)
-npx cxtms orgs use
-```
-
-The active org is cached in the session file and used by all server commands. **Always pass `--org <id>` on deploy/undeploy/release/execute/logs commands** to avoid the interactive org picker blocking automation.
-
-## Session Resolution
-
-Server commands resolve the target session in this order:
-1. `CXTMS_AUTH` env var → PAT token auth (with `CXTMS_SERVER` or `app.yaml` server field)
-2. `~/.cxtms/<project-dir>/.session.json` → project-scoped OAuth session
-3. Not logged in → error
-
-## Publish
-
-```bash
-# Publish all modules and workflows from current project
-npx cxtms publish
-
-# Publish only a specific feature directory
-npx cxtms publish --feature billing
-npx cxtms publish billing
-
-# Publish with explicit org ID
-npx cxtms publish --org 42
-```
-
-Validates all YAML files first, then pushes modules and workflows to the server. Skips files with validation errors and reports results.
-
-## App Manifest Management
-
-Server-side app manifest operations — install from git, release changes to git, and list installed apps.
-
-```bash
-# Install/refresh app from its git repository into the CX server
-npx cxtms app install
-
-# Force reinstall even if same version is already installed
-npx cxtms app install --force
-
-# Install from a specific branch
-npx cxtms app install --branch develop
-
-# Install but skip modules that have unpublished local changes
-npx cxtms app install --skip-changed
-
-# Release server changes to git (creates a PR) — message is required
-npx cxtms app release -m "Add new shipping module"
-
-# Force release all modules and workflows (not just changed ones)
-npx cxtms app release -m "Full republish" --force
-
-# List installed app manifests on the server
-npx cxtms app list
-```
-
-**`app install`** reads `repository` and `branch` from `app.yaml`, downloads the repo on the server side, and installs/updates all modules and workflows. Use `--force` to reinstall even if the version hasn't changed. Use `--skip-changed` to preserve modules with unpublished changes.
-
-**`app release`** takes the current server state and releases it to git by creating a PR. Requires a `-m` message describing the changes (like a git commit message). The server increments the version, creates a release branch, commits all module/workflow YAML files, and opens a pull request to the target branch.
-
-**`app list`** shows all installed app manifests with their version, status flags (disabled, unpublished changes, update available), and repository info.