@cxtms/cx-schema 1.1.1 → 1.3.0

package/.claude/skills/cx-core/ref-entity-commodity.md

@@ -203,3 +203,25 @@ inputs:
 - `OrderCommodity.customValues` — per-order-per-commodity fields
 - `CommodityType.customValues` — type-level fields
 - `CommodityTag.customValues` — tag-level fields
+
+---
+
+## CommodityEvent (Bridge Entity)
+
+Links tracking events to individual commodities for granular item-level tracking.
+
+| Field | Type | Notes |
+|-------|------|-------|
+| `commodityEventId` | `int` | PK |
+| `commodityId` | `int` | FK to Commodity |
+| `trackingEventId` | `int` | FK to TrackingEvent |
+
+**Navigation:** `commodity`, `trackingEvent` (with `eventDefinition`)
+
+Used in Flow workflow aggregations:
+```yaml
+aggregations:
+  - name: "hasCommodityEvent"
+    parameter: "eventCode"
+    expression: "any([Commodity.CommodityEvents], [each.TrackingEvent.EventDefinition.EventCode] = [eventCode])"
+```

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

@@ -9,9 +9,9 @@ You are a CargoXplorer workflow YAML builder. You generate schema-valid YAML for
 **IMPORTANT — use `cx-cli` for all workflow operations:**
 - **Scaffold**: `npx cx-cli create workflow <name> --template <template>` — generates a schema-valid YAML file. ALWAYS run this first, then read the generated file, then customize. Do NOT write YAML from scratch or copy templates manually.
 - **Validate**: `npx cx-cli <file.yaml>` — run after every change
-- **Schema lookup**: `npx cx-cli schema <task>` — e.g., `cx-cli schema graphql`, `cx-cli schema foreach`
+- **Schema lookup**: `npx cx-cli schema <task>` — e.g., `cx-cli schema graphql`, `cx-cli schema foreach`, `cx-cli schema action-event`. Schema names use kebab-case file names. Case-insensitive: `ActionEvent` resolves to `action-event`.
 - **Examples**: `npx cx-cli example <task>` — show example YAML for a task
-- **List schemas**: `npx cx-cli list --type workflow`
+- **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>`
 
 ## Generation Workflow

package/.claude/skills/cx-workflow/ref-entity.md

@@ -6,7 +6,19 @@ All entity tasks follow the `Namespace/Operation@Version` pattern. Outputs are s
 
 | Task | Description |
 |------|-------------|
-| `Entity/Change` | Generic entity change (works for any entity type) |
+| `Entity/Change` | Generic entity change — modify custom values on the tracked entity. Designed for **Before** triggers where the entity hasn't been persisted yet. |
+
+```yaml
+- task: "Entity/Change@1"
+  name: SetDefaults
+  inputs:
+    changes:
+      customValues:
+        region: "{{ parseAddress(Order.ShipToAddress).state }}"
+        lastModifiedBy: "{{ currentUser.name }}"
+```
+
+> **Note**: Async "Before" triggers are forbidden. Before triggers must use `executionMode: Sync`.
 
 ## Order
 
@@ -160,3 +172,20 @@ All entity tasks follow the `Namespace/Operation@Version` pattern. Outputs are s
 | `Cities/Import` | Import cities |
 | `Rate/Update` | Update rate |
 | `TrackingEvent/Import` | Import tracking events |
+
+## Note
+
+| Task | Description |
+|------|-------------|
+| `Note/Create` | Create note in a thread |
+| `Note/Update` | Update note content |
+| `Note/Delete` | Delete a note |
+| `Note/Import` | Bulk import notes |
+| `Note/Export` | Export notes for an entity |
+| `Note/RenameThread` | Rename a note thread |
+
+## Accounting Transaction (Additional)
+
+| Task | Description |
+|------|-------------|
+| `AccountingTransaction/ApplyCredit` | Apply credit memo to invoices |

package/.claude/skills/cx-workflow/ref-expressions.md

@@ -174,6 +174,7 @@ Functions use two iterator variable names:
 | `join([items], [each.name], ',')` | Join collection with `[each.*]` accessor and separator (3-arg) |
 | `join([items], ',')` | Join collection directly with separator (2-arg) |
 | `split([str], ' ')` | Split string by first character of separator. Returns `List<string>` |
+| `elementAt([items], 0)` | Get element at index (zero-based) from list |
 
 ### String Functions
 
@@ -183,6 +184,7 @@ Functions use two iterator variable names:
 | `length([var])` | String length or collection count. `0` for null strings and non-collections |
 | `lower([name])` / `upper([code])` | Case conversion. Handles string, JToken, any `.ToString()` |
 | `left([code], 3)` / `right([code], 3)` | Left/right N characters. Returns full string if shorter than N |
+| `substring([str], 0, 5)` | Extract substring starting at position for given length |
 | `replace([str], 'old', 'new')` | String replacement. Returns null if any arg is null |
 | `trim([value])` | Trim whitespace. Returns `""` for null |
 | `format('{0}-{1}', [prefix], [id])` | String.Format style. Variadic args. Returns null if format is null |
@@ -196,6 +198,7 @@ Functions use two iterator variable names:
 
 | Function | Description |
 |----------|-------------|
+| `parseDate([str])` | Parse date string to DateTime. Supports common formats (ISO, US, etc.) |
 | `now()` | Current UTC `DateTime` |
 | `now('yyyy-MM-dd', 'en-US')` | Formatted current time as string |
 | `addDays([date], 30)` | Add days (decimal, can be negative). Accepts DateTime, DateTimeOffset, string |

package/.claude/skills/cx-workflow/ref-utilities.md

@@ -91,6 +91,27 @@ Performs HTTP requests to external APIs.
 
 Response available at `ActivityName?.CallApi?.result?`.
 
+**Action events**: When an HTTP request operates on a specific entity (e.g., sending parcel info for an order), enable `actionEvents` in the inputs so the system can track and notify about the request. Include `eventDataExt` with the entity ID to link the event to the entity.
+
+```yaml
+- task: "Utilities/HttpRequest@1"
+  name: CallCarrierApi
+  inputs:
+    actionEvents:
+      enabled: true
+      eventName: "carrier.sendParcelInfo"
+      eventDataExt:
+        orderId: "{{ inputs.orderId }}"
+    url: "{{ carrierConfig?.baseUrl? }}/api/shipments"
+    method: POST
+    contentType: "application/json"
+    body:
+      trackingNumber: "{{ Data?.GetOrder?.order?.trackingNumber? }}"
+  outputs:
+    - name: result
+      mapping: "response?.body?"
+```
+
 ## Map@1
 
 Extracts/reshapes data from variables into new variables.