@cxtms/cx-schema 1.8.2 → 1.9.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cxtms/cx-schema",
-  "version": "1.8.2",
+  "version": "1.9.1",
   "description": "Schema validation package for CargoXplorer YAML modules",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -32,7 +32,7 @@
     "schemas",
     "scripts",
     "templates",
-    ".claude"
+    "skills"
   ],
   "dependencies": {
     "ajv": "^8.12.0",

package/schemas/workflows/tasks/httpRequest.json

@@ -66,21 +66,27 @@
         "body": {
           "description": "Request body (can be string or object)"
         },
-        "timeout": {
-          "type": "integer",
-          "description": "Request timeout in milliseconds"
-        },
-        "retry": {
+        "retryOptions": {
           "type": "object",
           "properties": {
-            "count": {
-              "type": "integer"
+            "limit": {
+              "type": "integer",
+              "description": "Number of retry attempts"
             },
-            "delay": {
-              "type": "integer"
+            "codes": {
+              "type": "array",
+              "items": {
+                "type": "integer"
+              },
+              "description": "HTTP status codes that trigger a retry (e.g. [429, 502, 503])"
             }
           },
-          "description": "Retry configuration"
+          "description": "Retry configuration with exponential backoff"
+        },
+        "circuitBreaker": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable circuit breaker for the target host (default: true). When open, serves stale cache or throws."
         },
         "responseContentType": {
           "type": "string",
@@ -112,14 +118,23 @@
         "cache": {
           "type": "object",
           "properties": {
-            "key": {
-              "type": "string"
+            "enabled": {
+              "type": "boolean",
+              "default": true,
+              "description": "Enable response caching"
             },
             "duration": {
-              "type": "string"
+              "type": "string",
+              "default": "1h",
+              "description": "Cache duration (e.g. '30s', '5m', '1h', '2d', 'EndOfDay', 'EndOfDay|America/Chicago')"
+            },
+            "useSlidingExpiration": {
+              "type": "boolean",
+              "default": false,
+              "description": "Use sliding expiration instead of absolute"
             }
           },
-          "description": "Response caching configuration"
+          "description": "Response caching configuration. Cache key is auto-generated from url + method + headers + body."
         }
       },
       "required": ["url", "method"],

package/scripts/postinstall.js

@@ -150,9 +150,9 @@ function main() {
   createValidationScript(projectRoot);
 
   // Copy Claude Code skills (clean existing first to remove stale files)
-  const skillNames = ['cx-core', 'cx-module', 'cx-workflow'];
+  const skillNames = ['cxtms-developer', 'cxtms-module-builder', 'cxtms-workflow-builder'];
   for (const skillName of skillNames) {
-    const skillSource = path.join(__dirname, '..', '.claude', 'skills', skillName);
+    const skillSource = path.join(__dirname, '..', 'skills', skillName);
     if (fs.existsSync(skillSource)) {
       const skillDest = path.join(projectRoot, '.claude', 'skills', skillName);
       console.log(`Installing ${skillName} skill...`);
@@ -169,14 +169,17 @@ function main() {
     }
   }
 
-  // Remove old cx-build skill if it exists
-  const oldSkillDest = path.join(projectRoot, '.claude', 'skills', 'cx-build');
-  if (fs.existsSync(oldSkillDest)) {
-    try {
-      fs.rmSync(oldSkillDest, { recursive: true });
-      console.log('Removed deprecated cx-build skill.');
-    } catch (error) {
-      // Ignore cleanup errors
+  // Remove deprecated skills
+  const deprecatedSkills = ['cx-build', 'cx-core', 'cx-module', 'cx-workflow'];
+  for (const oldSkill of deprecatedSkills) {
+    const oldSkillDest = path.join(projectRoot, '.claude', 'skills', oldSkill);
+    if (fs.existsSync(oldSkillDest)) {
+      try {
+        fs.rmSync(oldSkillDest, { recursive: true });
+        console.log(`Removed deprecated ${oldSkill} skill.`);
+      } catch (error) {
+        // Ignore cleanup errors
+      }
     }
   }
 
@@ -184,8 +187,8 @@ function main() {
   console.log('\nUsage:');
   console.log('  npx cxtms modules/your-module.yaml');
   console.log('  node .cx-schema/validate.js modules/your-module.yaml');
-  console.log('  /cx-module <description>   (Claude Code skill - UI modules)');
-  console.log('  /cx-workflow <description>  (Claude Code skill - workflows)');
+  console.log('  /cxtms-module-builder <description>   (Claude Code skill - UI modules)');
+  console.log('  /cxtms-workflow-builder <description>  (Claude Code skill - workflows)');
 }
 
 // Only run if this is not being installed as a dependency of cx-schema-validator itself

package/{.claude/skills/cx-core → skills/cxtms-developer}/SKILL.md

@@ -1,10 +1,12 @@
 ---
-name: cx-core
-description: Shared CargoXplorer entity field reference — domain entities, field names, enums, and customValues patterns
+name: cxtms-developer
+description: >
+  Shared CargoXplorer domain reference — entity fields, enums, customValues, GraphQL queries, and CLI auth.
+  Use when the user asks about CX entity fields, enums, customValues, entity relationships, or needs domain reference for Orders, Contacts, Commodities, Jobs, Charges, or other CX entities.
 argument-hint: <entity name or question about fields>
 ---
 
-Shared domain reference for CargoXplorer entities. Used by `cx-workflow` and `cx-module` skills for entity field names, types, navigation properties, enums, and customValues extension patterns.
+Shared domain reference for CargoXplorer entities. Used by `cxtms-workflow-builder` and `cxtms-module-builder` skills for entity field names, types, navigation properties, enums, and customValues extension patterns.
 
 ## Feature File Layout
 
@@ -27,32 +29,32 @@ Use `--feature <feature_name>` with `cx-cli create` to automatically place files
 
 ### Primary Entities
 
-!cat .claude/skills/cx-core/ref-entity-order.md
-!cat .claude/skills/cx-core/ref-entity-contact.md
-!cat .claude/skills/cx-core/ref-entity-commodity.md
-!cat .claude/skills/cx-core/ref-entity-accounting.md
+!cat skills/cxtms-developer/ref-entity-order.md
+!cat skills/cxtms-developer/ref-entity-contact.md
+!cat skills/cxtms-developer/ref-entity-commodity.md
+!cat skills/cxtms-developer/ref-entity-accounting.md
 
 ### Order Sub-Entities & Related
 
-!cat .claude/skills/cx-core/ref-entity-order-sub.md
-!cat .claude/skills/cx-core/ref-entity-job.md
+!cat skills/cxtms-developer/ref-entity-order-sub.md
+!cat skills/cxtms-developer/ref-entity-job.md
 
 ### Pricing & Accounting Lookups
 
-!cat .claude/skills/cx-core/ref-entity-rate.md
+!cat skills/cxtms-developer/ref-entity-rate.md
 
 ### Shared & Lookup Entities
 
-!cat .claude/skills/cx-core/ref-entity-shared.md
-!cat .claude/skills/cx-core/ref-entity-geography.md
+!cat skills/cxtms-developer/ref-entity-shared.md
+!cat skills/cxtms-developer/ref-entity-geography.md
 
 ### Warehouse & Inventory
 
-!cat .claude/skills/cx-core/ref-entity-warehouse.md
+!cat skills/cxtms-developer/ref-entity-warehouse.md
 
 ### Notifications
 
-!cat .claude/skills/cx-core/ref-entity-notification.md
+!cat skills/cxtms-developer/ref-entity-notification.md
 
 | Category | Entities | Reference |
 |----------|----------|-----------|

package/{.claude/skills/cx-module → skills/cxtms-module-builder}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: cx-module
+name: cxtms-module-builder
 description: >
   Works with CXTMS app module YAML files — creates, modifies, fixes, validates, and deploys UI screens, forms, grids, and routes.
   Use when the user asks to create, modify, or fix a module YAML file, references *-module.yaml files, or asks about UI components/forms/grids/routes in a CX project.
@@ -160,9 +160,9 @@ When the target file doesn't exist, a new module is created with:
 
 **Read these files only when needed for the current task.** Do not load all references upfront.
 
-### Entity Field Reference (cx-core)
+### Entity Field Reference (cxtms-developer)
 
-!cat .claude/skills/cx-core/SKILL.md
+!cat skills/cxtms-developer/SKILL.md
 
 ### Component Directory
 
@@ -170,12 +170,12 @@ Read the relevant category ref file when building specific component types:
 
 | Category | Components | File |
 |----------|-----------|------|
-| **Layout & Structure** | `layout`, `row`, `col`, `header`, `tabs`, `toolbar`, `card`, `line`, `slot` | `.claude/skills/cx-module/ref-components-layout.md` |
-| **Forms & Input** | `form`, `field`, `field-collection`, `barcodeScanner` | `.claude/skills/cx-module/ref-components-forms.md` |
-| **Data Display** | `dataGrid`, `text`, `markup`, `badge`, `icon`, `image`, `photo`, `summary`, `diff`, `viewer`, `embed` | `.claude/skills/cx-module/ref-components-display.md` |
-| **Interactive & Nav** | `button`, `dropdown`, `menuButton`, `link`, `redirect`, `navbar`, `navbarItem`, `navbarLink`, `navDropdown` | `.claude/skills/cx-module/ref-components-interactive.md` |
-| **Data & Collections** | `collection`, `list`, `listItem`, `datasource`, `script` | `.claude/skills/cx-module/ref-components-data.md` |
-| **Specialized** | `calendar`, `notes`, `dashboard`, `dashboard-widget`, `widget`, `timeline`, `timeline-grid`, `oauth2` | `.claude/skills/cx-module/ref-components-specialized.md` |
+| **Layout & Structure** | `layout`, `row`, `col`, `header`, `tabs`, `toolbar`, `card`, `line`, `slot` | `skills/cxtms-module-builder/ref-components-layout.md` |
+| **Forms & Input** | `form`, `field`, `field-collection`, `barcodeScanner` | `skills/cxtms-module-builder/ref-components-forms.md` |
+| **Data Display** | `dataGrid`, `text`, `markup`, `badge`, `icon`, `image`, `photo`, `summary`, `diff`, `viewer`, `embed` | `skills/cxtms-module-builder/ref-components-display.md` |
+| **Interactive & Nav** | `button`, `dropdown`, `menuButton`, `link`, `redirect`, `navbar`, `navbarItem`, `navbarLink`, `navDropdown` | `skills/cxtms-module-builder/ref-components-interactive.md` |
+| **Data & Collections** | `collection`, `list`, `listItem`, `datasource`, `script` | `skills/cxtms-module-builder/ref-components-data.md` |
+| **Specialized** | `calendar`, `notes`, `dashboard`, `dashboard-widget`, `widget`, `timeline`, `timeline-grid`, `oauth2` | `skills/cxtms-module-builder/ref-components-specialized.md` |
 
 ### Templates
 
@@ -409,7 +409,7 @@ Reusable select components (e.g., `Countries/Select`, `Ports/Select`) follow thi
 
 ## Server Module Commands
 
-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)
+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 [cxtms-developer/ref-cli-auth.md](skills/cxtms-developer/ref-cli-auth.md)
 
 ### Releasing App to GitHub
 

package/{.claude/skills/cx-workflow → skills/cxtms-workflow-builder}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: cx-workflow
+name: cxtms-workflow-builder
 description: >
   Works with CXTMS workflow YAML files — creates, modifies, fixes, validates, and deploys standard process and Flow state machine workflows.
   Use when the user asks to create, modify, or fix a workflow YAML file, references workflow/*.yaml files, or asks about workflow tasks/triggers/activities in a CX project.
@@ -75,7 +75,7 @@ npx cxtms create workflow <name> --template <template>
 
 **All templates** include workflow-level `events` (`onWorkflowStarted`, `onWorkflowExecuted`, `onWorkflowFailed`) and activity-level `events` (`onActivityStarted`, `onActivityCompleted`, `onActivityFailed`) with Log steps. Replace/extend these with notification tasks (Email/Send, HttpRequest, Workflow/Execute) as needed.
 
-**Flow workflows** — scaffold with `basic` then set `workflowType: Flow`, remove `activities`/`triggers`, add `entity`, `states`, `transitions`, `aggregations`. Load Flow reference: `!cat .claude/skills/cx-workflow/ref-flow.md`
+**Flow workflows** — scaffold with `basic` then set `workflowType: Flow`, remove `activities`/`triggers`, add `entity`, `states`, `transitions`, `aggregations`. Load Flow reference: `!cat skills/cxtms-workflow-builder/ref-flow.md`
 
 ### Step 4: Validate
 
@@ -191,8 +191,8 @@ events:                                     # Workflow-level event handlers
 
 ## Variable References (quick summary)
 
-For template expressions and value directives: see [ref-expressions-template.md](.claude/skills/cx-workflow/ref-expressions-template.md)
-For NCalc conditions and functions: see [ref-expressions-ncalc.md](.claude/skills/cx-workflow/ref-expressions-ncalc.md)
+For template expressions and value directives: see [ref-expressions-template.md](skills/cxtms-workflow-builder/ref-expressions-template.md)
+For NCalc conditions and functions: see [ref-expressions-ncalc.md](skills/cxtms-workflow-builder/ref-expressions-ncalc.md)
 
 **`{{ path }}`** — in step inputs. Single `{{ }}` returns raw object. Multiple returns string interpolation.
 **`[variable]`** — in conditions and `expression:` directives. NCalc syntax.
@@ -279,25 +279,25 @@ Implicit variable: `iteration` (zero-based).
 
 | Category | Tasks | Load Reference |
 |----------|-------|----------------|
-| Utilities | SetVariable, Log, Error, HttpRequest, Map, Template, Import, Export, CsvParse, UnzipFile | `!cat .claude/skills/cx-workflow/ref-utilities.md` |
-| Query & Workflow | Query/GraphQL, Validation, Workflow/Execute | `!cat .claude/skills/cx-workflow/ref-query.md` |
-| Entity CRUD | Order, Contact, Commodity, Job, Charge, Discount, Inventory, Movement, Transmission | `!cat .claude/skills/cx-workflow/ref-entity.md` |
-| Communication | Email/Send, Document/Render, Attachment, PdfDocument/Merge | `!cat .claude/skills/cx-workflow/ref-communication.md` |
-| File Transfer | Connect, Disconnect, ListFiles, Download, Upload, Move, Delete | `!cat .claude/skills/cx-workflow/ref-filetransfer.md` |
-| Accounting | AccountingTransaction, Payment, Number/Generate, SequenceNumber | `!cat .claude/skills/cx-workflow/ref-accounting.md` |
-| Other | User, Auth, Caching, X12/Parse, EDIFACT, Flow/Transition, Notes, AppModule, ActionEvent | `!cat .claude/skills/cx-workflow/ref-other.md` |
+| Utilities | SetVariable, Log, Error, HttpRequest, Map, Template, Import, Export, CsvParse, UnzipFile | `!cat skills/cxtms-workflow-builder/ref-utilities.md` |
+| Query & Workflow | Query/GraphQL, Validation, Workflow/Execute | `!cat skills/cxtms-workflow-builder/ref-query.md` |
+| Entity CRUD | Order, Contact, Commodity, Job, Charge, Discount, Inventory, Movement, Transmission | `!cat skills/cxtms-workflow-builder/ref-entity.md` |
+| Communication | Email/Send, Document/Render, Attachment, PdfDocument/Merge | `!cat skills/cxtms-workflow-builder/ref-communication.md` |
+| File Transfer | Connect, Disconnect, ListFiles, Download, Upload, Move, Delete | `!cat skills/cxtms-workflow-builder/ref-filetransfer.md` |
+| Accounting | AccountingTransaction, Payment, Number/Generate, SequenceNumber | `!cat skills/cxtms-workflow-builder/ref-accounting.md` |
+| Other | User, Auth, Caching, X12/Parse, EDIFACT, Flow/Transition, Notes, AppModule, ActionEvent | `!cat skills/cxtms-workflow-builder/ref-other.md` |
 
-## Entity Field Reference (cx-core)
+## Entity Field Reference (cxtms-developer)
 
-!cat .claude/skills/cx-core/SKILL.md
+!cat skills/cxtms-developer/SKILL.md
 
 ## Additional References (load on demand)
 
 | Reference | Load |
 |-----------|------|
-| Template Expressions & Value Directives | `!cat .claude/skills/cx-workflow/ref-expressions-template.md` |
-| NCalc Expressions & Functions | `!cat .claude/skills/cx-workflow/ref-expressions-ncalc.md` |
-| Flow Workflows (state machines) | `!cat .claude/skills/cx-workflow/ref-flow.md` |
+| Template Expressions & Value Directives | `!cat skills/cxtms-workflow-builder/ref-expressions-template.md` |
+| NCalc Expressions & Functions | `!cat skills/cxtms-workflow-builder/ref-expressions-ncalc.md` |
+| Flow Workflows (state machines) | `!cat skills/cxtms-workflow-builder/ref-flow.md` |
 
 ## Dynamic Schema Access (load on demand)
 
@@ -320,7 +320,7 @@ Implicit variable: `iteration` (zero-based).
 
 ## Server Workflow Commands
 
-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)
+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 [cxtms-developer/ref-cli-auth.md](skills/cxtms-developer/ref-cli-auth.md)
 
 ### Releasing App to GitHub