@cxtms/cx-schema 1.7.15 → 1.7.17

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

@@ -10,7 +10,7 @@ Shared domain reference for CargoXplorer entities. Used by `cx-workflow` and `cx
 
 ## CX Server Authentication & Management
 
-For CLI authentication, PAT tokens, org management, and publishing: see [ref-cli-auth.md](ref-cli-auth.md)
+For CLI authentication, PAT tokens, org management, and releasing: see [ref-cli-auth.md](ref-cli-auth.md)
 
 ## GraphQL Querying & Audit History
 

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

@@ -61,7 +61,7 @@ npx cxtms orgs use <orgId>
 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/publish/execute/logs commands** to avoid the interactive org picker blocking automation.
+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
 
@@ -88,7 +88,7 @@ Validates all YAML files first, then pushes modules and workflows to the server.
 
 ## App Manifest Management
 
-Server-side app manifest operations — install from git, publish changes to git, and list installed apps.
+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

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

@@ -65,6 +65,8 @@ Field names as used in workflow expressions: `{{ entity.orderId }}`, `{{ entity.
 | `orderCarriers` | `[OrderCarrier]` | |
 | `allTags` | `[OrderAllTagsView]` | View: all tags including from commodities |
 | `allRelatedOrders` | `[OrderRelatedOrdersView]` | Orders sharing commodities |
+| `attachmentsSummary` | `OrderAttachmentSummaryView?` | DB view: `.totalCount`, `.hasAny` (active attachments) |
+| `notesSummary` | `OrderNoteSummaryView?` | DB view: `.totalCount`, `.hasAny` (non-deleted notes) |
 | `outgoingLinks` | `[LinkedOrder]` | |
 | `incomingLinks` | `[LinkedOrder]` | |
 
@@ -107,6 +109,8 @@ These are virtual fields that filter `orderEntities` by type:
 | `getChargesByChargeType(chargeType)` | `[Charge]` | Charges filtered by type |
 | `getOrderSummary(weightUnit, volumeUnit, dimensionsUnit)` | `OrderSummary` | |
 | `lastTrackingEvent(eventDefinitionName)` | `TrackingEvent` | Most recent |
+| `attachmentsSummary` | `OrderAttachmentSummaryGqlDto` | `.totalCount` (int), `.hasAny` (bool) — batched DataLoader, backed by DB view |
+| `notesSummary` | `OrderNoteSummaryGqlDto` | `.totalCount` (int), `.hasAny` (bool) — batched DataLoader, backed by DB view |
 | `notesCount(threadFilter)` | `int` | |
 | `changeHistory(startDate, endDate, maxResults)` | `[ChangeHistory]` | Audit trail |
 

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

@@ -0,0 +1,41 @@
+# Organization Entity Reference
+
+Core tenant entity. Each organization represents a company/tenant in the system.
+
+## Fields
+
+| Field | Type | Notes |
+|-------|------|-------|
+| `organizationId` | `int` | PK |
+| `companyName` | `string` | Required |
+| `addressLine` | `string?` | |
+| `addressLine2` | `string?` | |
+| `cityName` | `string?` | |
+| `countryCode` | `string?` | |
+| `stateCode` | `string?` | |
+| `postalCode` | `string?` | |
+| `phoneNumber` | `string?` | |
+| `faxNumber` | `string?` | |
+| `uniqueId` | `Guid` | Immutable external identifier |
+| `slug` | `string?` | URL-friendly identifier for Public API routes (lowercase, hyphenated) |
+| `isDeleted` | `bool` | Soft delete |
+| `customValues` | `Dictionary?` | jsonb, merged on update |
+| `created` / `lastModified` | `DateTime` | Audit fields (from `AuditableEntity`) |
+| `createdBy` / `lastModifiedBy` | `string` | Audit fields |
+
+## Slug
+
+Generated by `SlugGenerator`: lowercased, non-alphanumeric stripped, spaces→hyphens, truncated to max length. Numeric suffix appended for uniqueness.
+
+Used by `PublicApiOrganizationResolver` to resolve org by slug or GUID in Public API URLs. Cached 1h sliding.
+
+## Relationships
+
+- `AspNetUserEmployees` — users belonging to this organization
+
+## Domain Methods
+
+- `ChangeSlug(string?)` — trims and lowercases
+- `ChangeCompanyName(string)`, `ChangeAddressLine(string?)`, etc.
+- `ChangeCustomValues(Dictionary?)` — merges into existing values
+- `DeleteOrganization()` — sets `IsDeleted = true`

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

@@ -20,7 +20,7 @@ You are a CargoXplorer module YAML builder. You generate schema-valid YAML for C
 - **Feature folder**: `npx cxtms create module <name> --template <template> --feature <feature-name>`
 - **Deploy to server**: `npx cxtms appmodule deploy <file.yaml> --org <id>` — creates or updates module on the CX server
 - **Undeploy from server**: `npx cxtms appmodule undeploy <appModuleId> --org <id>` — removes a module by UUID
-- **Publish all**: `npx cxtms publish [--feature <name>] --org <id>` — push all modules and workflows to the server
+- **Publish all**: `npx cxtms publish [--feature <name>] --org <id>` — deploy all modules and workflows to the server
 
 ## Generation Workflow
 
@@ -409,7 +409,7 @@ Reusable select components (e.g., `Countries/Select`, `Ports/Select`) follow thi
 
 ## Server Module Commands
 
-Deploy, undeploy, and publish commands are listed in the CLI section at the top of this file. For authentication setup (login, PAT tokens, org management): see [cx-core/ref-cli-auth.md](.claude/skills/cx-core/ref-cli-auth.md)
+Deploy, undeploy, and release commands are listed in the CLI section at the top of this file. For authentication setup (login, PAT tokens, org management): see [cx-core/ref-cli-auth.md](.claude/skills/cx-core/ref-cli-auth.md)
 
 ### Releasing App to GitHub
 
@@ -438,11 +438,11 @@ npx cxtms app release -m "Add warehouse locations module" --org 42
 5. Creates a pull request from the publish branch to the target branch
 6. Marks published modules and workflows as `hasUnpublishedChanges: false`
 
-**This is a commit-and-push operation** — it commits the current server-side YAML directly to GitHub via the API. No local git repo is involved. The modules and workflows being published are taken from the CX server database, not from local files. The YAML file arguments only identify *which* items to include by their IDs.
+**This is a release-to-git operation** — it commits the current server-side YAML directly to GitHub via the API. No local git repo is involved. The modules and workflows being released are taken from the CX server database, not from local files. The YAML file arguments only identify *which* items to include by their IDs.
 
-**Important:** Modules and workflows must be deployed to the TMS server before they can be published. Use `cxtms appmodule deploy` or `cxtms workflow deploy` first, then `cxtms app release` to commit them to GitHub.
+**Important:** Modules and workflows must be deployed to the TMS server before they can be released. Use `cxtms appmodule deploy` or `cxtms workflow deploy` first, then `cxtms app release` to commit them to GitHub.
 
-**Do NOT run `app release` automatically.** Only publish when the user explicitly requests it. Publishing creates a branch and PR on GitHub, so it should be done once when all changes are ready — not after every deploy.
+**Do NOT run `app release` automatically.** Only release when the user explicitly requests it. Releasing creates a branch and PR on GitHub, so it should be done once when all changes are ready — not after every deploy.
 
 **Prerequisites:**
 - `app.yaml` must exist with a valid `id` field

package/.claude/skills/cx-module/ref-components-layout.md

@@ -288,6 +288,47 @@ children:
 
 ---
 
+## slot
+
+Extension point that renders dynamically registered components targeting a named slot. Enables cross-module UI extensions without modifying the original layout.
+
+**Props:**
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `name` | `string` | — | Slot name to match. Supports templates: `TMS/{{entityType}}/Actions` |
+| `itemTag` | `string` | `React.Fragment` | HTML element to wrap each extension (`div`, `li`, etc.) |
+
+**Children:** No — extensions are loaded from the database at runtime.
+
+Extension components must define `props.targetSlot` matching the slot name, `props.order` for sort order, and a `layout` object.
+
+```yaml
+# Define a slot extension point
+component: slot
+props:
+  name: "TMS/ShipmentDashboard/Tabs"
+```
+
+```yaml
+# Extension component (registered via another module's appComponents)
+name: "TMS/ShipmentDashboard/TrackingTab"
+props:
+  targetSlot: "TMS/ShipmentDashboard/Tabs"
+  order: 10
+layout:
+  component: tab
+  props:
+    label: { en-US: "Tracking" }
+  children:
+    - component: layout
+      props:
+        component: "TMS/Tracking/Panel"
+```
+
+**Naming convention:** `{Module}/{Entity}/{Location}` (e.g., `TMS/OrderDetail/Actions`)
+
+---
+
 ## line
 
 Simple `<hr>` horizontal divider.

package/.claude/skills/cx-module/ref-components-specialized.md

@@ -341,7 +341,9 @@ CSS Grid-based timeline with swim lanes, drill-down, and virtual scrolling.
 | `view` | `day \| week \| month \| year` | `week` | Time view |
 | `startDate` / `endDate` | `string` | — | Date range |
 | `eventSources` | `EventSource[]` | — | Event data sources |
+| `eventSources[].query.name` | `string` | `query1`, `query2`... | Source name, used as key in `summaryComponent` `dataSources` |
 | `eventTemplate` | `ComponentProps` | — | Custom event template |
+| `summaryComponent` | `ComponentProps` | — | Custom component rendered per column in the summary row. Replaces numeric totals when set. |
 | `options.height` | `string \| number` | `600` | Container height |
 | `options.cellHeight` | `number` | `60/100` | Cell height (px) |
 | `options.groupBy` | `string` | — | Field for swim lane grouping |
@@ -352,6 +354,14 @@ CSS Grid-based timeline with swim lanes, drill-down, and virtual scrolling.
 | `options.showWeekends` | `boolean` | `true` | Show weekends |
 | `options.showTotalCount` | `boolean` | `false` | Show event totals |
 
+**Summary component variables** (available when `summaryComponent` is set):
+| Variable | Type | Description |
+|----------|------|-------------|
+| `dataSources` | `Record<string, TimelineEvent[]>` | Per-source events filtered to the column, keyed by `query.name` |
+| `column` | `ColumnDefinition` | Column metadata (`id`, `label`, `date`, `startDate`, `endDate`) |
+| `columnIndex` | `number` | Zero-based column index |
+| `totalCount` | `number` | Total event count for the column across all sources |
+
 **Events:**
 | Event | Data | Description |
 |-------|------|-------------|
@@ -397,6 +407,36 @@ props:
           props: { date: "{{ date }}", assignee: "{{ row }}" }
 ```
 
+**Summary component example** (per-source breakdown per column):
+```yaml
+component: timeline-grid
+props:
+  view: week
+  options: { height: 600, enableNavigation: true }
+  eventSources:
+    - query:
+        name: ups
+        command: "query($s:String!,$e:String!){ upsShipments(start:$s,end:$e){ id date title } }"
+        variables: { s: "{{ startDate }}", e: "{{ endDate }}" }
+        path: upsShipments
+    - query:
+        name: fedex
+        command: "query($s:String!,$e:String!){ fedexShipments(start:$s,end:$e){ id date title } }"
+        variables: { s: "{{ startDate }}", e: "{{ endDate }}" }
+        path: fedexShipments
+  summaryComponent:
+    component: layout
+    props:
+      direction: column
+    children:
+      - component: text
+        props: { value: "UPS: {{ dataSources.ups.length }}" }
+      - component: text
+        props: { value: "FedEx: {{ dataSources.fedex.length }}" }
+      - component: text
+        props: { value: "Total: {{ totalCount }}" }
+```
+
 ---
 
 ## oauth2

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

@@ -21,7 +21,7 @@ You are a CargoXplorer workflow YAML builder. You generate schema-valid YAML for
 - **Execute**: `npx cxtms workflow execute <workflowId|file.yaml> --org <id> [--vars '<json>'] [--file varName=path]` — trigger a workflow execution (--file uploads a local file and passes the URL as a variable)
 - **List logs**: `npx cxtms workflow logs <workflowId|file.yaml> --org <id> [--from YYYY-MM-DD] [--to YYYY-MM-DD]` — list executions with log availability
 - **Download log**: `npx cxtms workflow log <executionId> --org <id> [--json] [--console] [--output <file>]` — download execution log
-- **Publish all**: `npx cxtms publish [--feature <name>] --org <id>` — push all modules and workflows to the server
+- **Publish all**: `npx cxtms publish [--feature <name>] --org <id>` — deploy all modules and workflows to the server
 
 ## Generation Workflow
 
@@ -320,7 +320,7 @@ Implicit variable: `iteration` (zero-based).
 
 ## Server Workflow Commands
 
-Deploy, undeploy, and publish commands are listed in the CLI section at the top of this file. For authentication setup (login, PAT tokens, org management): see [cx-core/ref-cli-auth.md](.claude/skills/cx-core/ref-cli-auth.md)
+Deploy, undeploy, and release commands are listed in the CLI section at the top of this file. For authentication setup (login, PAT tokens, org management): see [cx-core/ref-cli-auth.md](.claude/skills/cx-core/ref-cli-auth.md)
 
 ### Releasing App to GitHub
 
@@ -349,11 +349,11 @@ npx cxtms app release -m "Add order notification workflow" --org 42
 5. Creates a pull request from the publish branch to the target branch
 6. Marks published workflows and modules as `hasUnpublishedChanges: false`
 
-**This is a commit-and-push operation** — it commits the current server-side YAML directly to GitHub via the API. No local git repo is involved. The workflows and modules being published are taken from the CX server database, not from local files. The YAML file arguments only identify *which* items to include by their IDs.
+**This is a release-to-git operation** — it commits the current server-side YAML directly to GitHub via the API. No local git repo is involved. The workflows and modules being released are taken from the CX server database, not from local files. The YAML file arguments only identify *which* items to include by their IDs.
 
-**Important:** Workflows and modules must be deployed to the TMS server before they can be published. Use `cxtms workflow deploy` or `cxtms appmodule deploy` first, then `cxtms app release` to commit them to GitHub.
+**Important:** Workflows and modules must be deployed to the TMS server before they can be released. Use `cxtms workflow deploy` or `cxtms appmodule deploy` first, then `cxtms app release` to commit them to GitHub.
 
-**Do NOT run `app release` automatically.** Only publish when the user explicitly requests it. Publishing creates a branch and PR on GitHub, so it should be done once when all changes are ready — not after every deploy.
+**Do NOT run `app release` automatically.** Only release when the user explicitly requests it. Releasing creates a branch and PR on GitHub, so it should be done once when all changes are ready — not after every deploy.
 
 **Prerequisites:**
 - `app.yaml` must exist with a valid `id` field

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cxtms/cx-schema",
-  "version": "1.7.15",
+  "version": "1.7.17",
   "description": "Schema validation package for CargoXplorer YAML modules",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/schemas/components/timelineGrid.json

@@ -130,6 +130,10 @@
           "$ref": "../schemas.json#/definitions/component",
           "description": "Template for items; receives 'item' context"
         },
+        "summaryComponent": {
+          "$ref": "../schemas.json#/definitions/component",
+          "description": "Custom component for the summary row. When set, the built-in overall total row is hidden and replaced with this component. Receives aggregated data."
+        },
         "isHidden": {
           "$ref": "../schemas.json#/definitions/templateExpression",
           "description": "Boolean expression for conditional rendering"

package/schemas/schemas.json

@@ -115,6 +115,18 @@
               "isHidden": {
                 "type": "boolean",
                 "description": "Whether column is hidden"
+              },
+              "enableEdit": {
+                "type": "boolean",
+                "description": "Enables inline cell editing for this column"
+              },
+              "editor": {
+                "$ref": "#/definitions/component",
+                "description": "Component rendered via ComponentRender when enableEdit is true. Uses same pattern as showAs."
+              },
+              "onEdit": {
+                "$ref": "#/definitions/actionsList",
+                "description": "Action array executed sequentially when the cell value changes. Receives changedValues and value variables."
               }
             }
           }