zinkee 0.1.36 → 0.1.37

package/dist/index.js

@@ -275,6 +275,41 @@ var commandRegistry = {
     supportsRaw: false,
     output: writeOutput
   },
+  "displays folders list": {
+    command: "displays folders list",
+    accessLevel: "read",
+    supportsExample: true,
+    supportsRaw: false,
+    output: readOutput
+  },
+  "displays folders create": {
+    command: "displays folders create",
+    accessLevel: "write",
+    supportsExample: true,
+    supportsRaw: false,
+    output: writeOutput
+  },
+  "displays folders update": {
+    command: "displays folders update",
+    accessLevel: "write",
+    supportsExample: true,
+    supportsRaw: false,
+    output: writeOutput
+  },
+  "displays folders delete": {
+    command: "displays folders delete",
+    accessLevel: "destructive",
+    supportsExample: true,
+    supportsRaw: false,
+    output: writeOutput
+  },
+  "displays folders move": {
+    command: "displays folders move",
+    accessLevel: "write",
+    supportsExample: true,
+    supportsRaw: false,
+    output: writeOutput
+  },
   "displays layout get": {
     command: "displays layout get",
     accessLevel: "read",
@@ -436,6 +471,62 @@ var commandRegistry = {
     supportsRaw: false,
     output: writeOutput
   },
+  "document-templates list": {
+    command: "document-templates list",
+    accessLevel: "read",
+    supportsExample: true,
+    supportsRaw: false,
+    output: readOutput
+  },
+  "document-templates get": {
+    command: "document-templates get",
+    accessLevel: "read",
+    supportsExample: true,
+    supportsRaw: false,
+    output: readOutput
+  },
+  "document-templates create": {
+    command: "document-templates create",
+    accessLevel: "write",
+    supportsExample: true,
+    supportsRaw: true,
+    output: writeOutput
+  },
+  "document-templates update": {
+    command: "document-templates update",
+    accessLevel: "write",
+    supportsExample: true,
+    supportsRaw: false,
+    output: writeOutput
+  },
+  "document-templates delete": {
+    command: "document-templates delete",
+    accessLevel: "destructive",
+    supportsExample: true,
+    supportsRaw: false,
+    output: writeOutput
+  },
+  "document-templates assets add": {
+    command: "document-templates assets add",
+    accessLevel: "write",
+    supportsExample: true,
+    supportsRaw: false,
+    output: writeOutput
+  },
+  "document-templates assets delete": {
+    command: "document-templates assets delete",
+    accessLevel: "destructive",
+    supportsExample: true,
+    supportsRaw: false,
+    output: writeOutput
+  },
+  "document-templates assets download": {
+    command: "document-templates assets download",
+    accessLevel: "read",
+    supportsExample: true,
+    supportsRaw: false,
+    output: "binary"
+  },
   "files upload": {
     command: "files upload",
     accessLevel: "write",
@@ -576,6 +667,13 @@ var commandRegistry = {
     supportsRaw: false,
     output: writeOutput
   },
+  "schemas set-unique-fields": {
+    command: "schemas set-unique-fields",
+    accessLevel: "write",
+    supportsExample: true,
+    supportsRaw: false,
+    output: writeOutput
+  },
   "schemas delete": {
     command: "schemas delete",
     accessLevel: "destructive",
@@ -2311,6 +2409,7 @@ var specificExamples = {
   },
   "auditable": true,
   "commentable": true,
+  "highlightedField": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
   "fields": [
     {
       "id": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
@@ -2325,7 +2424,8 @@ var specificExamples = {
         "conditionalFormatting": []
       }
     }
-  ]
+  ],
+  "uniqueFields": []
 }`
     },
     {
@@ -2341,6 +2441,86 @@ var specificExamples = {
       command: "zinkee --json schemas update contacts --auditable true",
       raw: `{
   "auditable": true
+}`
+    },
+    {
+      description: "Set the schema's highlighted (main) field \u2014 the field whose value names each record in the UI (activity-panel title and detail-view record list).",
+      command: "zinkee --json schemas update contacts --highlighted-field contact-name",
+      raw: `{
+  "highlightedField": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+}`
+    }
+  ]),
+  "schemas set-unique-fields": buildCommandExamples([
+    {
+      description: "Set a composite unique constraint: the listed fields must be unique together across records.",
+      command: "zinkee --json schemas set-unique-fields contacts --field contact-name --field notes",
+      raw: `{
+  "fieldIds": [
+    "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+    "1d2e3f4a-5b6c-7d8e-9f01-23456789abcd"
+  ]
+}`,
+      response: `{
+  "id": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+  "name": "Contacts",
+  "slug": "contacts",
+  "folder": {
+    "id": "7f4e7c25-d8b2-4c1a-9f3e-6a7b5c8d9e1f",
+    "name": "Customers",
+    "isRoot": false
+  },
+  "auditable": true,
+  "commentable": true,
+  "highlightedField": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+  "fields": [
+    {
+      "id": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+      "type": "TextField",
+      "slug": "contact-name",
+      "label": "Customer Name",
+      "required": true,
+      "system": false,
+      "config": {
+        "textType": "NORMAL",
+        "defaultValue": "Unknown",
+        "conditionalFormatting": []
+      }
+    },
+    {
+      "id": "1d2e3f4a-5b6c-7d8e-9f01-23456789abcd",
+      "type": "TextField",
+      "slug": "notes",
+      "label": "Notes",
+      "required": false,
+      "system": false,
+      "config": {
+        "textType": "LONG",
+        "defaultValue": null,
+        "conditionalFormatting": []
+      }
+    }
+  ],
+  "uniqueFields": [
+    "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+    "1d2e3f4a-5b6c-7d8e-9f01-23456789abcd"
+  ]
+}`
+    },
+    {
+      description: "Set a single-field unique constraint.",
+      command: "zinkee --json schemas set-unique-fields contacts --field contact-name",
+      raw: `{
+  "fieldIds": [
+    "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+  ]
+}`
+    },
+    {
+      description: "Clear the unique constraint (no field must be unique anymore).",
+      command: "zinkee --json schemas set-unique-fields contacts --clear",
+      raw: `{
+  "fieldIds": []
 }`
     }
   ]),
@@ -2570,7 +2750,7 @@ var specificExamples = {
     },
     {
       description: "Filter by status with a free-text search term.",
-      command: `zinkee --json records query contacts --select id,contact-name,status --where "status in OPEN" --limit 25 --raw '{"search":{"term":"garcia"}}'`,
+      command: `zinkee --json records query contacts --select id,contact-name,status --where "status in OPEN" --search garcia --limit 25`,
       raw: `{
   "select": ["id", "contact-name", "status"],
   "where": [
@@ -2652,35 +2832,78 @@ var specificExamples = {
   ]),
   "records create": buildCommandExamples([
     {
-      description: "Minimal create using just two plain string fields.",
+      description: "Create a single record with --set/--set-json (the single-record flags build one record, sent as a one-element 'records' array).",
       command: `zinkee --json records create contacts --set contact-name="Ada Lovelace" --set contact-email=ada@example.com`,
       raw: `{
-  "values": {
-    "contact-name": "Ada Lovelace",
-    "contact-email": "ada@example.com"
-  }
+  "records": [
+    {
+      "contact-name": "Ada Lovelace",
+      "contact-email": "ada@example.com"
+    }
+  ]
 }`,
       response: `{
-  "recordId": "550e8400-e29b-41d4-a716-446655440000",
-  "values": {
-    "contact-name": "Ada Lovelace",
-    "contact-email": "ada@example.com"
-  }
+  "created": [
+    "550e8400-e29b-41d4-a716-446655440000"
+  ],
+  "errors": []
 }`
     },
     {
-      description: "Create a record mixing text, option, number, date, reference and member fields. ReferenceField values must match the target's current targetDisplayField (read it from the target record before writing).",
-      command: `zinkee --json records create contacts --set contact-name="Grace Hopper" --set contact-email=grace@example.com --set status=2 --set amount=1999.99 --set due-date=2026-06-01T09:00:00Z --set customer-ref="CUST-12" --set owner=6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d`,
+      description: "Create many records from a JSON array file (one object per record, slug -> value). Best-effort: valid records are created and invalid ones are reported per index in 'errors'. ReferenceField values accept the target record id (a bare UUID, or the compound 'recordId::anything' whose label is ignored) or an exact display value; the server stores the canonical 'recordId::displayValue'.",
+      command: `zinkee --json records create contacts --records-file ./records.json`,
       raw: `{
-  "values": {
-    "contact-name": "Grace Hopper",
-    "contact-email": "grace@example.com",
-    "status": 2,
-    "amount": 1999.99,
-    "due-date": "2026-06-01T09:00:00Z",
-    "customer-ref": "CUST-12",
-    "owner": "6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d"
-  }
+  "records": [
+    {
+      "contact-name": "Ada Lovelace",
+      "contact-email": "ada@example.com"
+    },
+    {
+      "contact-name": "Grace Hopper",
+      "contact-email": "grace@example.com",
+      "status": 2,
+      "amount": 1999.99,
+      "due-date": "2026-06-01T09:00:00Z",
+      "customer-ref": "8ad602a1-f6e3-43f6-9ab2-f1c5afc99621",
+      "owner": "6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d"
+    }
+  ]
+}`,
+      response: `{
+  "created": [
+    "550e8400-e29b-41d4-a716-446655440000"
+  ],
+  "errors": [
+    {
+      "index": 1,
+      "reason": "record_field_not_found",
+      "message": "Field 'contact-emial' was not found in schema '2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e'.",
+      "action": "Use a valid field slug from the schema and retry."
+    }
+  ]
+}`
+    },
+    {
+      description: "Set a ReferenceField by the target record id (a bare UUID, or the compound 'recordId::anything' whose label is ignored) or by an exact display value. The server resolves and stores the canonical 'recordId::displayValue'. Unknown references are rejected per index with reason 'data_field_reference_not_found'.",
+      command: `zinkee --json records create deals --set deal-name="Acme renewal" --set customer-ref=00000000-0000-0000-0000-000000000000`,
+      raw: `{
+  "records": [
+    {
+      "deal-name": "Acme renewal",
+      "customer-ref": "00000000-0000-0000-0000-000000000000"
+    }
+  ]
+}`,
+      response: `{
+  "created": [],
+  "errors": [
+    {
+      "index": 0,
+      "reason": "data_field_reference_not_found",
+      "message": "Referenced record was not found in the target schema.",
+      "action": "Use an existing record id or an existing display value for this reference field."
+    }
+  ]
 }`
     }
   ]),
@@ -2722,6 +2945,22 @@ var specificExamples = {
       command: "zinkee --json records update contacts 550e8400-e29b-41d4-a716-446655440000 --unset contact-email --unset due-date",
       raw: `{
   "unset": ["contact-email", "due-date"]
+}`
+    },
+    {
+      description: "Set a ReferenceField on an existing record. Pass the target record id (a bare UUID, or the compound 'recordId::anything' whose label is ignored) or an exact display value; the response shows the canonical 'recordId::displayValue' the server stored. If the reference doesn't exist the whole update is rejected with reason 'data_field_reference_not_found'.",
+      command: "zinkee --json records update deals 550e8400-e29b-41d4-a716-446655440000 --set customer-ref=8ad602a1-f6e3-43f6-9ab2-f1c5afc99621",
+      raw: `{
+  "set": {
+    "customer-ref": "8ad602a1-f6e3-43f6-9ab2-f1c5afc99621"
+  }
+}`,
+      response: `{
+  "recordId": "550e8400-e29b-41d4-a716-446655440000",
+  "values": {
+    "deal-name": "Acme renewal",
+    "customer-ref": "8ad602a1-f6e3-43f6-9ab2-f1c5afc99621::Acme Corp"
+  }
 }`
     }
   ]),
@@ -2863,11 +3102,10 @@ var specificExamples = {
   ]),
   "navigation resources move": buildCommandExamples([
     {
-      description: "Move a schema into a navigation folder.",
-      command: "zinkee --json navigation resources move 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --type SCHEMA --to Sales",
+      description: "Move a schema into a navigation folder. Only schemas can be moved; the navigation menu holds databases.",
+      command: "zinkee --json navigation resources move 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --to Sales",
       raw: `{
   "resourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
-  "resourceType": "SCHEMA",
   "targetFolderId": "84a0fca4-37ef-4c83-a8ed-9ef67ad9324a"
 }`,
       response: `{
@@ -2876,39 +3114,11 @@ var specificExamples = {
 }`
     },
     {
-      description: "Move a workflow.",
-      command: "zinkee --json navigation resources move 3f8a2c1b-9d4e-4a5b-8c6d-7e8f90123456 --type WORKFLOW --to Operations",
-      raw: `{
-  "resourceId": "3f8a2c1b-9d4e-4a5b-8c6d-7e8f90123456",
-  "resourceType": "WORKFLOW",
-  "targetFolderId": "b8c9d0e1-f2a3-4b5c-6d7e-8f9012345678"
-}`
-    },
-    {
-      description: "Move a display.",
-      command: "zinkee --json navigation resources move 0f6f062f-1478-4df2-96a1-c495d037d260 --type DISPLAY --to Operations",
-      raw: `{
-  "resourceId": "0f6f062f-1478-4df2-96a1-c495d037d260",
-  "resourceType": "DISPLAY",
-  "targetFolderId": "b8c9d0e1-f2a3-4b5c-6d7e-8f9012345678"
-}`
-    },
-    {
-      description: "Move a resource back to the root folder (root is always UUID 00000000-0000-0000-0000-000000000000).",
-      command: "zinkee --json navigation resources move 5223cbc8-8c6c-4694-93bc-dd176364df9b --type SCHEMA --to 00000000-0000-0000-0000-000000000000",
+      description: "Move a schema back to the root folder (root is always UUID 00000000-0000-0000-0000-000000000000).",
+      command: "zinkee --json navigation resources move 5223cbc8-8c6c-4694-93bc-dd176364df9b --to 00000000-0000-0000-0000-000000000000",
       raw: `{
   "resourceId": "5223cbc8-8c6c-4694-93bc-dd176364df9b",
-  "resourceType": "SCHEMA",
   "targetFolderId": "00000000-0000-0000-0000-000000000000"
-}`
-    },
-    {
-      description: "Move a schedule resource.",
-      command: "zinkee --json navigation resources move a1b2c3d4-e5f6-7890-1234-567890abcdef --type SCHEDULE --to Operations",
-      raw: `{
-  "resourceId": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
-  "resourceType": "SCHEDULE",
-  "targetFolderId": "b8c9d0e1-f2a3-4b5c-6d7e-8f9012345678"
 }`
     }
   ]),
@@ -3306,12 +3516,12 @@ var specificExamples = {
 }`
     },
     {
-      description: "Change a DATE variable to use lastWeek.",
-      command: "zinkee --json displays variables update 0f6f062f-1478-4df2-96a1-c495d037d260 bbbbbbbb-2222-4222-a222-222222222222 --date-mode dynamic --date-dynamic-option lastWeek",
+      description: "Change a DATE variable to use last12Months.",
+      command: "zinkee --json displays variables update 0f6f062f-1478-4df2-96a1-c495d037d260 bbbbbbbb-2222-4222-a222-222222222222 --date-mode dynamic --date-dynamic-option last12Months",
       raw: `{
   "date": {
     "mode": "dynamic",
-    "dynamicOption": "lastWeek"
+    "dynamicOption": "last12Months"
   }
 }`
     }
@@ -3319,7 +3529,7 @@ var specificExamples = {
   "displays widgets create": buildCommandExamples([
     {
       description: "Create a TABLE widget (CLI normalises --type table to TABLE_OR_SUBTABLE).",
-      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type table --name Customers --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":12,"h":8}' --field id --field contact-name --field status --sort '{"fieldId":"id","direction":"DESC"}'`,
+      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type table --name Customers --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":12,"h":8}' --field contact-name --field status --field amount --sort '{"fieldId":"contact-name","direction":"ASC"}'`,
       raw: `{
   "type": "TABLE_OR_SUBTABLE",
   "source": {
@@ -3334,11 +3544,11 @@ var specificExamples = {
   },
   "query": {
     "sorts": [
-      { "fieldId": "id", "direction": "DESC" }
+      { "fieldId": "contact-name", "direction": "ASC" }
     ]
   },
   "view": {
-    "fields": ["id", "contact-name", "status"]
+    "fields": ["contact-name", "status", "amount"]
   }
 }`,
       response: `{
@@ -3387,8 +3597,8 @@ var specificExamples = {
 }`
     },
     {
-      description: "Create a bars CHART widget with a time-serie x-axis and two y-axis series.",
-      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type CHART --name "Revenue by month" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":8,"h":6}' --chart-type bars --x-axis-field due-date --x-axis-date-format MONTH --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#4B9CD3","axisType":"PRIMARY"}' --y-axis-serie '{"typeCalc":"COUNT","fieldCalc":"id","color":"#E57373","axisType":"SECONDARY"}' --legend '{"position":"bottom"}'`,
+      description: "Create a CHART widget with a daily time-serie x-axis.",
+      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type CHART --name "Revenue by day" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":8,"h":6}' --chart-type lines --x-axis-field due-date --x-axis-date-format DATE --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#4B9CD3","axisType":"PRIMARY"}' --legend '{"position":"bottom"}'`,
       raw: `{
   "type": "CHART",
   "source": {
@@ -3398,11 +3608,11 @@ var specificExamples = {
   "placement": {
     "layout": { "x": 0, "y": 0, "w": 8, "h": 6 }
   },
-  "presentation": { "name": "Revenue by month" },
+  "presentation": { "name": "Revenue by day" },
   "chart": {
-    "chartType": "bars",
+    "chartType": "lines",
     "xAxisFieldId": "due-date",
-    "xAxisDateFormat": "MONTH",
+    "xAxisDateFormat": "DATE",
     "xAxisAsTimeSerie": true,
     "yAxisSeries": [
       {
@@ -3410,12 +3620,6 @@ var specificExamples = {
         "fieldCalc": "amount",
         "color": "#4B9CD3",
         "axisType": "PRIMARY"
-      },
-      {
-        "typeCalc": "COUNT",
-        "fieldCalc": "id",
-        "color": "#E57373",
-        "axisType": "SECONDARY"
       }
     ],
     "legend": { "position": "bottom" }
@@ -3423,71 +3627,246 @@ var specificExamples = {
 }`
     },
     {
-      description: "Create a TIMELINE widget.",
-      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type TIMELINE --name "Customer schedule" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":12,"h":6}' --field contact-name --field due-date`,
+      description: "Create a bars CHART widget with a monthly time-serie x-axis and two y-axis series.",
+      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type CHART --name "Revenue by month" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":8,"h":6}' --chart-type bars --x-axis-field due-date --x-axis-date-format MONTH_YEAR --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#4B9CD3","axisType":"PRIMARY"}' --y-axis-serie '{"typeCalc":"COUNT","fieldCalc":"contact-name","color":"#E57373","axisType":"SECONDARY"}' --legend '{"position":"bottom"}'`,
       raw: `{
-  "type": "TIMELINE",
+  "type": "CHART",
   "source": {
     "originResourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
     "isOriginSubSchema": false
   },
   "placement": {
-    "layout": { "x": 0, "y": 0, "w": 12, "h": 6 }
+    "layout": { "x": 0, "y": 0, "w": 8, "h": 6 }
   },
-  "presentation": { "name": "Customer schedule" },
-  "view": {
-    "fields": ["contact-name", "due-date"]
+  "presentation": { "name": "Revenue by month" },
+  "chart": {
+    "chartType": "bars",
+    "xAxisFieldId": "due-date",
+    "xAxisDateFormat": "MONTH_YEAR",
+    "xAxisAsTimeSerie": true,
+    "yAxisSeries": [
+      {
+        "typeCalc": "SUM",
+        "fieldCalc": "amount",
+        "color": "#4B9CD3",
+        "axisType": "PRIMARY"
+      },
+      {
+        "typeCalc": "COUNT",
+        "fieldCalc": "contact-name",
+        "color": "#E57373",
+        "axisType": "SECONDARY"
+      }
+    ],
+    "legend": { "position": "bottom" }
   }
 }`
     },
     {
-      description: "Create a KANBAN widget with a status filter and groupsExpanded config (rich query/view requires --raw).",
-      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --raw '{"type":"KANBAN","source":{"originResourceId":"2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e","isOriginSubSchema":false},"placement":{"layout":{"x":0,"y":0,"w":12,"h":8}},"presentation":{"name":"Status board"},"query":{"filters":[{"origin":{"schemaId":"contacts","fieldId":"status"},"comparisonOperator":"ANY_OF","values":["1","2","3"]}]},"view":{"fields":["contact-name","status","amount"],"groupsExpanded":{"1":true,"2":true,"3":false}}}'`,
+      description: "Create a bars CHART widget with a quarterly time-serie x-axis.",
+      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type CHART --name "Revenue by quarter" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":8,"h":6}' --chart-type bars --x-axis-field due-date --x-axis-date-format QUARTER_YEAR --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#4B9CD3","axisType":"PRIMARY"}' --legend '{"position":"bottom"}'`,
       raw: `{
-  "type": "KANBAN",
+  "type": "CHART",
   "source": {
     "originResourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
     "isOriginSubSchema": false
   },
   "placement": {
-    "layout": { "x": 0, "y": 0, "w": 12, "h": 8 }
+    "layout": { "x": 0, "y": 0, "w": 8, "h": 6 }
   },
-  "presentation": { "name": "Status board" },
-  "query": {
-    "filters": [
+  "presentation": { "name": "Revenue by quarter" },
+  "chart": {
+    "chartType": "bars",
+    "xAxisFieldId": "due-date",
+    "xAxisDateFormat": "QUARTER_YEAR",
+    "xAxisAsTimeSerie": true,
+    "yAxisSeries": [
       {
-        "origin": {
-          "schemaId": "contacts",
-          "fieldId": "status"
-        },
-        "comparisonOperator": "ANY_OF",
-        "values": ["1", "2", "3"]
+        "typeCalc": "SUM",
+        "fieldCalc": "amount",
+        "color": "#4B9CD3",
+        "axisType": "PRIMARY"
       }
-    ]
-  },
-  "view": {
-    "fields": ["contact-name", "status", "amount"],
-    "groupsExpanded": { "1": true, "2": true, "3": false }
+    ],
+    "legend": { "position": "bottom" }
   }
 }`
     },
     {
-      description: "Create a HIERARCHY widget rooted on a parent field.",
-      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --raw '{"type":"HIERARCHY","source":{"originResourceId":"2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e","isOriginSubSchema":false},"placement":{"layout":{"x":0,"y":0,"w":12,"h":6}},"presentation":{"name":"Org tree"},"view":{"fields":["contact-name","status"],"hierarchyConfig":{"parentFieldId":"contact-name"}}}'`,
+      description: "Create a CHART widget with a yearly time-serie x-axis.",
+      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type CHART --name "Revenue by year" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":8,"h":6}' --chart-type lines --x-axis-field due-date --x-axis-date-format YEAR --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#4B9CD3","axisType":"PRIMARY"}' --legend '{"position":"bottom"}'`,
       raw: `{
-  "type": "HIERARCHY",
+  "type": "CHART",
   "source": {
     "originResourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
     "isOriginSubSchema": false
   },
   "placement": {
-    "layout": { "x": 0, "y": 0, "w": 12, "h": 6 }
+    "layout": { "x": 0, "y": 0, "w": 8, "h": 6 }
+  },
+  "presentation": { "name": "Revenue by year" },
+  "chart": {
+    "chartType": "lines",
+    "xAxisFieldId": "due-date",
+    "xAxisDateFormat": "YEAR",
+    "xAxisAsTimeSerie": true,
+    "yAxisSeries": [
+      {
+        "typeCalc": "SUM",
+        "fieldCalc": "amount",
+        "color": "#4B9CD3",
+        "axisType": "PRIMARY"
+      }
+    ],
+    "legend": { "position": "bottom" }
+  }
+}`
+    },
+    {
+      description: "Create a TIMELINE widget via flags. The typed view state lives in view.viewAdditionalProperties.viewState; field references there must be UUIDs (slugs are only resolved in --field). cardConfig uses category1/category2/category4 (no category3). Use --view-state for UI scalars (granularity, sidebarWidth, show* ...).",
+      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type TIMELINE --name "Customer schedule" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":12,"h":6}' --field c60b8526-5835-4c9f-aecd-9a16c7704a34 --field a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890 --field c52efe3f-2825-4c60-a7e3-34dd4c1ce043 --field d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90 --start-date-field d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90 --end-date-field e5f6a7b8-c9d0-1e2f-3a4b-5c6d7e8f9012 --label-field c60b8526-5835-4c9f-aecd-9a16c7704a34 --group-field a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890 --subgroup-field c60b8526-5835-4c9f-aecd-9a16c7704a34 --progress-field c52efe3f-2825-4c60-a7e3-34dd4c1ce043 --card-title-field c60b8526-5835-4c9f-aecd-9a16c7704a34 --card-category1-field a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890 --card-category2-field d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90 --card-category4-field c52efe3f-2825-4c60-a7e3-34dd4c1ce043 --card-description-field c60b8526-5835-4c9f-aecd-9a16c7704a34 --view-state '{"granularity":"month","sidebarWidth":300,"showUngroupedEvents":true,"showUnsubgroupedEvents":true}'`,
+      raw: `{
+  "type": "TIMELINE",
+  "source": {
+    "originResourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+    "isOriginSubSchema": false
+  },
+  "placement": {
+    "layout": { "x": 0, "y": 0, "w": 12, "h": 6 }
+  },
+  "presentation": { "name": "Customer schedule" },
+  "view": {
+    "fields": [
+      "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+      "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+      "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+      "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90"
+    ],
+    "viewAdditionalProperties": {
+      "viewState": {
+        "granularity": "month",
+        "sidebarWidth": 300,
+        "showUngroupedEvents": true,
+        "showUnsubgroupedEvents": true,
+        "fieldMapping": {
+          "startDateField": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+          "endDateField": "e5f6a7b8-c9d0-1e2f-3a4b-5c6d7e8f9012",
+          "labelField": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+          "groupField": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+          "subgroupField": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+          "progressField": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+          "cardConfig": {
+            "titleField": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+            "category1Field": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+            "category2Field": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+            "category4Field": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+            "descriptionField": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+          }
+        }
+      }
+    }
+  }
+}`
+    },
+    {
+      description: "Create a KANBAN widget via flags. The typed view state lives in view.viewAdditionalProperties.viewState; field references there must be UUIDs (slugs are only resolved in --field). cardConfig uses category1/category2/category3 (no category4). --aggregation-method/--aggregation-field set the card aggregation; use --view-state for UI scalars.",
+      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type KANBAN --name "Status board" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":12,"h":8}' --field c60b8526-5835-4c9f-aecd-9a16c7704a34 --field a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890 --field c52efe3f-2825-4c60-a7e3-34dd4c1ce043 --field d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90 --column-field a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890 --swimlane-field c60b8526-5835-4c9f-aecd-9a16c7704a34 --card-title-field c60b8526-5835-4c9f-aecd-9a16c7704a34 --card-category1-field a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890 --card-category2-field d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90 --card-category3-field c52efe3f-2825-4c60-a7e3-34dd4c1ce043 --card-description-field c60b8526-5835-4c9f-aecd-9a16c7704a34 --aggregation-method sum --aggregation-field c52efe3f-2825-4c60-a7e3-34dd4c1ce043 --view-state '{"hideEmptyColumns":false,"showNoValueColumn":true,"showNoValueSwimlane":true}'`,
+      raw: `{
+  "type": "KANBAN",
+  "source": {
+    "originResourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+    "isOriginSubSchema": false
+  },
+  "placement": {
+    "layout": { "x": 0, "y": 0, "w": 12, "h": 8 }
+  },
+  "presentation": { "name": "Status board" },
+  "view": {
+    "fields": [
+      "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+      "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+      "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+      "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90"
+    ],
+    "viewAdditionalProperties": {
+      "viewState": {
+        "hideEmptyColumns": false,
+        "showNoValueColumn": true,
+        "showNoValueSwimlane": true,
+        "fieldMapping": {
+          "columnField": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+          "swimlaneField": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+          "cardConfig": {
+            "titleField": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+            "category1Field": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+            "category2Field": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+            "category3Field": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+            "descriptionField": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+          },
+          "aggregationConfig": {
+            "method": "sum",
+            "fieldId": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043"
+          }
+        }
+      }
+    }
+  }
+}`
+    },
+    {
+      description: "Create a HIERARCHY widget via flags. Declare columns once (--hierarchy-label, repeatable --hierarchy-info <id:name>, --hierarchy-number <id:name:aggregation>), map the root level (the view's own table) with --hierarchy-root-* and add each child level as a JSON object with --hierarchy-child. label is required per level; info/number mappings are optional. Column ids (e.g. col_1779975207355_zfndknslw) are unique opaque identifiers you choose \u2014 not the column name \u2014 and are reused as columnId in every mapping. All field references must be UUIDs.",
+      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type HIERARCHY --name "Org tree" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":12,"h":6}' --field c60b8526-5835-4c9f-aecd-9a16c7704a34 --field a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890 --field c52efe3f-2825-4c60-a7e3-34dd4c1ce043 --hierarchy-label "Name" --hierarchy-info "col_1779975207355_zfndknslw:Status" --hierarchy-info "col_1779975243018_qm4t7xb2pa:Description" --hierarchy-number "col_1779975261490_h8kd3nv9ws:Total amount:SUM" --hierarchy-root-name "Customers" --hierarchy-root-label-field c60b8526-5835-4c9f-aecd-9a16c7704a34 --hierarchy-root-info "col_1779975207355_zfndknslw:a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890" --hierarchy-root-number "col_1779975261490_h8kd3nv9ws:c52efe3f-2825-4c60-a7e3-34dd4c1ce043" --hierarchy-child '{"name":"Projects","schemaId":"3ec9cdef-7e0a-4cdd-8019-8fb9281f5d6f","childFieldId":"80deefae-af3d-4000-b322-bfe1594f8073","labelFieldId":"50dbef0b-7e0a-4fdd-8019-8fb9281f5d70","infoMappings":[{"columnId":"col_1779975243018_qm4t7xb2pa","fieldId":"60dcef0c-8f1b-4eee-9120-9fc0392f6e71"}],"numberMappings":[{"columnId":"col_1779975261490_h8kd3nv9ws","fieldId":"70ddef0d-9f2c-4fff-a221-afd0493f7f72"}]}'`,
+      raw: `{
+  "type": "HIERARCHY",
+  "source": {
+    "originResourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+    "isOriginSubSchema": false
+  },
+  "placement": {
+    "layout": { "x": 0, "y": 0, "w": 12, "h": 6 }
   },
   "presentation": { "name": "Org tree" },
   "view": {
-    "fields": ["contact-name", "status"],
+    "fields": [
+      "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+      "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+      "c52efe3f-2825-4c60-a7e3-34dd4c1ce043"
+    ],
     "hierarchyConfig": {
-      "parentFieldId": "contact-name"
+      "columns": {
+        "label": "Name",
+        "infos": [
+          { "id": "col_1779975207355_zfndknslw", "name": "Status" },
+          { "id": "col_1779975243018_qm4t7xb2pa", "name": "Description" }
+        ],
+        "numbers": [
+          { "id": "col_1779975261490_h8kd3nv9ws", "name": "Total amount", "aggregation": "SUM" }
+        ]
+      },
+      "rootLevel": {
+        "name": "Customers",
+        "labelFieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+        "infoMappings": [
+          { "columnId": "col_1779975207355_zfndknslw", "fieldId": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890" }
+        ],
+        "numberMappings": [
+          { "columnId": "col_1779975261490_h8kd3nv9ws", "fieldId": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043" }
+        ]
+      },
+      "childLevels": [
+        {
+          "name": "Projects",
+          "schemaId": "3ec9cdef-7e0a-4cdd-8019-8fb9281f5d6f",
+          "childFieldId": "80deefae-af3d-4000-b322-bfe1594f8073",
+          "labelFieldId": "50dbef0b-7e0a-4fdd-8019-8fb9281f5d70",
+          "infoMappings": [
+            { "columnId": "col_1779975243018_qm4t7xb2pa", "fieldId": "60dcef0c-8f1b-4eee-9120-9fc0392f6e71" }
+          ],
+          "numberMappings": [
+            { "columnId": "col_1779975261490_h8kd3nv9ws", "fieldId": "70ddef0d-9f2c-4fff-a221-afd0493f7f72" }
+          ]
+        }
+      ]
     }
   }
 }`
@@ -3496,13 +3875,13 @@ var specificExamples = {
   "displays widgets update": buildCommandExamples([
     {
       description: "Move placement, update view columns, rename the widget and lock it.",
-      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 11111111-1111-4111-a111-111111111111 --layout '{"x":1,"y":2,"w":8,"h":4}' --field id --field contact-name --field status --name "Revenue Updated" --widget-read-only`,
+      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 11111111-1111-4111-a111-111111111111 --layout '{"x":1,"y":2,"w":8,"h":4}' --field contact-name --field status --field amount --name "Revenue Updated" --widget-read-only`,
       raw: `{
   "placement": {
     "layout": { "x": 1, "y": 2, "w": 8, "h": 4 }
   },
   "view": {
-    "fields": ["id", "contact-name", "status"]
+    "fields": ["contact-name", "status", "amount"]
   },
   "presentation": { "name": "Revenue Updated" },
   "behavior": { "readOnly": true }
@@ -3513,29 +3892,38 @@ var specificExamples = {
 }`
     },
     {
-      description: "Add query filters that match the full comparisonOperator contract (requires --raw because --filter only accepts free-form expressions).",
-      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 11111111-1111-4111-a111-111111111111 --raw '{"query":{"filters":[{"origin":{"schemaId":"contacts","fieldId":"status"},"comparisonOperator":"EQUAL","values":["2"]},{"origin":{"schemaId":"contacts","fieldId":"amount"},"comparisonOperator":"GREATER_OR_EQUAL","values":["500"]}]}}'`,
+      description: "Add query filters with --filter. The CLI parses the expression and emits the structured comparisonOperator payload the API expects.",
+      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 11111111-1111-4111-a111-111111111111 --filter "status:eq:2" --filter "amount:gte:500"`,
       raw: `{
   "query": {
     "filters": [
       {
-        "origin": {
-          "schemaId": "contacts",
-          "fieldId": "status"
-        },
+        "origin": { "fieldId": "status" },
         "comparisonOperator": "EQUAL",
         "values": ["2"]
       },
       {
-        "origin": {
-          "schemaId": "contacts",
-          "fieldId": "amount"
-        },
+        "origin": { "fieldId": "amount" },
         "comparisonOperator": "GREATER_OR_EQUAL",
         "values": ["500"]
       }
     ]
   }
+}`
+    },
+    {
+      description: "Fall back to --raw for comparators the parser does not cover yet (e.g. NOT_CONTAINS, RANGE).",
+      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 11111111-1111-4111-a111-111111111111 --raw '{"query":{"filters":[{"origin":{"fieldId":"due-date"},"comparisonOperator":"RANGE","values":["2025-01-01","2025-12-31"]}]}}'`,
+      raw: `{
+  "query": {
+    "filters": [
+      {
+        "origin": { "fieldId": "due-date" },
+        "comparisonOperator": "RANGE",
+        "values": ["2025-01-01", "2025-12-31"]
+      }
+    ]
+  }
 }`
     },
     {
@@ -3561,13 +3949,13 @@ var specificExamples = {
 }`
     },
     {
-      description: "Replace the chart series with weekly lines.",
-      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 22222222-2222-4222-a222-222222222222 --chart-type lines --x-axis-field due-date --x-axis-date-format WEEK --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#2E7D32","axisType":"PRIMARY"}'`,
+      description: "Replace the chart series with quarterly lines.",
+      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 22222222-2222-4222-a222-222222222222 --chart-type lines --x-axis-field due-date --x-axis-date-format QUARTER_YEAR --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#2E7D32","axisType":"PRIMARY"}'`,
       raw: `{
   "chart": {
     "chartType": "lines",
     "xAxisFieldId": "due-date",
-    "xAxisDateFormat": "WEEK",
+    "xAxisDateFormat": "QUARTER_YEAR",
     "xAxisAsTimeSerie": true,
     "yAxisSeries": [
       {
@@ -3733,6 +4121,7 @@ var specificExamples = {
   },
   "auditable": true,
   "commentable": true,
+  "highlightedField": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
   "fields": [
     {
       "id": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
@@ -3922,7 +4311,7 @@ var specificExamples = {
       "required": false,
       "system": false,
       "config": {
-        "formulaText": "date_format(d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90, "AAAA-MM")",
+        "formulaText": "date_format(d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90, \\"AAAA-MM\\")",
         "uiFormatKind": "date",
         "status": "ACTIVE",
         "defaultValue": null,
@@ -4041,6 +4430,10 @@ var specificExamples = {
         "conditionalFormatting": []
       }
     }
+  ],
+  "uniqueFields": [
+    "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+    "1d2e3f4a-5b6c-7d8e-9f01-23456789abcd"
   ]
 }`
     }
@@ -4199,10 +4592,24 @@ var specificExamples = {
   ]),
   "records delete": buildCommandExamples([
     {
-      description: "Delete a record.",
-      command: `zinkee --json records delete contacts ${SAMPLE_UUID}`,
+      description: "Delete one or more records by id (--record is repeatable).",
+      command: `zinkee --json records delete contacts --record 550e8400-e29b-41d4-a716-446655440000 --record 6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d`,
       response: `{
-  "recordId": "550e8400-e29b-41d4-a716-446655440000",
+  "recordIds": [
+    "550e8400-e29b-41d4-a716-446655440000",
+    "6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d"
+  ],
+  "deleted": true
+}`
+    },
+    {
+      description: "Delete many records listing one uuid per line in a file (merged with any --record flags and de-duplicated).",
+      command: `zinkee --json records delete contacts --records-file ./record-ids.txt`,
+      response: `{
+  "recordIds": [
+    "550e8400-e29b-41d4-a716-446655440000",
+    "6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d"
+  ],
   "deleted": true
 }`
     }
@@ -4298,7 +4705,7 @@ var specificExamples = {
     "resources": [
       {
         "id": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
-        "name": "Contacts",
+        "name": "Customer records",
         "type": "SCHEMA",
         "isInSpace": false,
         "additionalProperties": {}
@@ -4322,19 +4729,10 @@ var specificExamples = {
     "resources": [
       {
         "id": "3f8a2c1b-9d4e-4a5b-8c6d-7e8f90123456",
-        "name": "Quote approval",
-        "type": "WORKFLOW",
+        "name": "Shipments",
+        "type": "SCHEMA",
         "isInSpace": false,
         "additionalProperties": {}
-      },
-      {
-        "id": "0f6f062f-1478-4df2-96a1-c495d037d260",
-        "name": "Executive Revenue",
-        "type": "DISPLAY",
-        "isInSpace": true,
-        "additionalProperties": {
-          "pinned": true
-        }
       }
     ],
     "additionalProperties": {
@@ -4381,8 +4779,13 @@ var specificExamples = {
     "name": "Shared Dashboards",
     "order": 1,
     "isRoot": false,
-    "resourceCount": 1,
+    "resourceCount": 2,
     "resources": [
+      {
+        "id": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+        "name": "Customer records",
+        "type": "SCHEMA"
+      },
       {
         "id": "0f6f062f-1478-4df2-96a1-c495d037d260",
         "name": "Executive Revenue",
@@ -4554,7 +4957,7 @@ var specificExamples = {
         "hideDeleteButton": false
       },
       "view": {
-        "fields": ["id", "contact-name", "status", "amount"],
+        "fields": ["contact-name", "status", "amount"],
         "columnSize": { "contact-name": 240 }
       }
     }
@@ -4601,6 +5004,83 @@ var specificExamples = {
       command: "zinkee --json displays delete 0f6f062f-1478-4df2-96a1-c495d037d260"
     }
   ]),
+  "displays folders list": buildCommandExamples([
+    {
+      description: "List flat display folders (non-root folders plus the root bucket).",
+      command: "zinkee --json displays folders list",
+      response: `[
+  {
+    "id": "e7a1c3d2-5f4b-4a6c-9d8e-1f2a3b4c5d6e",
+    "name": "Executive Dashboards",
+    "isRoot": false,
+    "displayCount": 2
+  },
+  {
+    "id": "8b22282b-3db3-4dd7-87f7-b29365dcf3f6",
+    "name": null,
+    "isRoot": true,
+    "displayCount": 4
+  }
+]`
+    }
+  ]),
+  "displays folders create": buildCommandExamples([
+    {
+      description: "Create one flat display folder.",
+      command: 'zinkee --json displays folders create --name "Executive Dashboards"',
+      raw: `{
+  "name": "Executive Dashboards"
+}`,
+      response: `{
+  "id": "e7a1c3d2-5f4b-4a6c-9d8e-1f2a3b4c5d6e",
+  "name": "Executive Dashboards",
+  "isRoot": false,
+  "displayCount": 0
+}`
+    }
+  ]),
+  "displays folders update": buildCommandExamples([
+    {
+      description: "Rename a display folder. The folder argument accepts a UUID or an exact name.",
+      command: 'zinkee --json displays folders update "Executive Dashboards" --name "Executive Dashboards (2026)"',
+      raw: `{
+  "name": "Executive Dashboards (2026)"
+}`,
+      response: `{
+  "id": "e7a1c3d2-5f4b-4a6c-9d8e-1f2a3b4c5d6e",
+  "name": "Executive Dashboards (2026)",
+  "isRoot": false,
+  "displayCount": 2
+}`
+    }
+  ]),
+  "displays folders delete": buildCommandExamples([
+    {
+      description: "Delete a non-root display folder. Its displays move back to the root folder.",
+      command: 'zinkee --json displays folders delete "Executive Dashboards"',
+      response: `{
+  "id": "e7a1c3d2-5f4b-4a6c-9d8e-1f2a3b4c5d6e",
+  "name": "Executive Dashboards",
+  "isRoot": false,
+  "displayCount": 2
+}`
+    }
+  ]),
+  "displays folders move": buildCommandExamples([
+    {
+      description: "Move one display into a target folder by exact folder name.",
+      command: 'zinkee --json displays folders move 0f6f062f-1478-4df2-96a1-c495d037d260 --to "Executive Dashboards"',
+      raw: `{
+  "displayId": "0f6f062f-1478-4df2-96a1-c495d037d260",
+  "targetFolderId": "e7a1c3d2-5f4b-4a6c-9d8e-1f2a3b4c5d6e"
+}`,
+      response: `{
+  "id": "e7a1c3d2-5f4b-4a6c-9d8e-1f2a3b4c5d6e",
+  "name": "Executive Dashboards",
+  "isRoot": false
+}`
+    }
+  ]),
   "displays layout get": buildCommandExamples([
     {
       description: "Get the layout block of a display (template + tabs/freeformLayouts/slots).",
@@ -4694,7 +5174,7 @@ var specificExamples = {
     "hideDeleteButton": false
   },
   "view": {
-    "fields": ["id", "contact-name", "status", "amount"],
+    "fields": ["contact-name", "status", "amount"],
     "columnSize": { "contact-name": 240 }
   }
 }`
@@ -5351,6 +5831,43 @@ var specificExamples = {
       "steps": ["one", "two"]
     }
   }
+}`
+    },
+    {
+      description: "Add a send-message action. --to maps to fieldMapping.recipients and --message maps to fieldMapping.body. Values are wrapped in {rawValue, source} like every other automation field mapping; use --map / --map-json for extra keys.",
+      command: `zinkee --json automations actions add automation-1 --type send_message --name "Notify customer" --to customer@example.com --subject "Your order status has changed" --message "Hello, your order is now processed."`,
+      raw: `{
+  "type": "send_message",
+  "name": "Notify customer",
+  "config": {
+    "fieldMapping": {
+      "recipients": {
+        "rawValue": "customer@example.com",
+        "source": null
+      },
+      "subject": {
+        "rawValue": "Your order status has changed",
+        "source": null
+      },
+      "body": {
+        "rawValue": "Hello, your order is now processed.",
+        "source": null
+      }
+    }
+  }
+}`
+    },
+    {
+      description: "Add a generate-document action. The renderer reads the template, writes the file, and stores its id in the target FileField of the target schema.",
+      command: 'zinkee --json automations actions add automation-1 --type generate_document --name "Generate invoice PDF" --document-template 6c08673e-f8a6-44d2-8c91-d09eca911f8f --target-schema 68d2c7be-4392-42de-b5ae-625ad79cfc3c --target-file-field c8edbde8-a361-4e9f-a39a-2e88971f21a7',
+      raw: `{
+  "type": "generate_document",
+  "name": "Generate invoice PDF",
+  "config": {
+    "documentTemplateId": "6c08673e-f8a6-44d2-8c91-d09eca911f8f",
+    "targetSchemaId": "68d2c7be-4392-42de-b5ae-625ad79cfc3c",
+    "targetFileFieldId": "c8edbde8-a361-4e9f-a39a-2e88971f21a7"
+  }
 }`
     }
   ]),
@@ -5401,6 +5918,30 @@ var specificExamples = {
     "authMode": "STORED",
     "connectionId": "connection-1"
   }
+}`
+    },
+    {
+      description: "Replace a send-message action. --to maps to fieldMapping.recipients and --message maps to fieldMapping.body; values are wrapped in {rawValue, source}.",
+      command: `zinkee --json automations actions update automation-1 action-1 --type send_message --name "Notify customer" --to customer@example.com --subject "Your order status has changed" --message "Hello, your order is now processed."`,
+      raw: `{
+  "type": "send_message",
+  "name": "Notify customer",
+  "config": {
+    "fieldMapping": {
+      "recipients": {
+        "rawValue": "customer@example.com",
+        "source": null
+      },
+      "subject": {
+        "rawValue": "Your order status has changed",
+        "source": null
+      },
+      "body": {
+        "rawValue": "Hello, your order is now processed.",
+        "source": null
+      }
+    }
+  }
 }`
     }
   ]),
@@ -5553,7 +6094,8 @@ var specificExamples = {
       description: "Move one automation into a target folder by exact folder name.",
       command: 'zinkee --json automations folders move automation-1 --to "Codex Frontend Demo"',
       raw: `{
-  "automationId": "automation-1"
+  "automationId": "automation-1",
+  "targetFolderId": "cdfc14e3-3169-4ffb-8d9b-b11858a9240f"
 }`,
       response: `{
   "id": "cdfc14e3-3169-4ffb-8d9b-b11858a9240f",
@@ -5561,70 +6103,248 @@ var specificExamples = {
   "isRoot": false
 }`
     }
-  ])
-};
-function fallbackExamples(commandName) {
-  switch (commandName) {
-    default:
-      return [];
-  }
-}
-function buildSchemaFieldCreateExamples(type) {
-  const definitions = getSchemaFieldTypeDefinitions();
-  const selectedDefinition = resolveSchemaFieldType(type);
-  const filteredDefinitions = selectedDefinition ? definitions.filter((definition) => definition.key === selectedDefinition.key) : definitions;
-  const flat = filteredDefinitions.flatMap(
-    (definition) => definition.examplePayloads.map((example) => ({ definition, example }))
-  );
-  return buildCommandExamples(
-    flat.map(({ example }, index) => {
-      const slug = typeof example.payload.slug === "string" ? example.payload.slug : "field";
-      const command = `zinkee --json schemas fields create contacts --raw '${JSON.stringify(example.payload)}'`;
-      if (index === 0) {
-        return {
-          description: example.name,
-          command,
-          response: `{
-  "schemaId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
-  "fieldId": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
-  "slug": "${slug}"
-}`
-        };
+  ]),
+  "document-templates list": buildCommandExamples([
+    {
+      description: "List every document template in the workspace. Each asset's link is a relative path to the asset download endpoint, ready to call without composition.",
+      command: "zinkee --json document-templates list",
+      response: `[
+  {
+    "id": "7c4a8d3f-1b2e-4a5c-9d6e-1f2a3b4c5d6e",
+    "name": "Quarterly report",
+    "assets": [
+      {
+        "id": "9e8d7c6b-5a4f-3e2d-1c0b-9a8b7c6d5e4f",
+        "name": "Requirements.docx",
+        "link": "/api/v2/document-templates/7c4a8d3f-1b2e-4a5c-9d6e-1f2a3b4c5d6e/assets/9e8d7c6b-5a4f-3e2d-1c0b-9a8b7c6d5e4f/download"
       }
-      return {
-        description: example.name,
-        command
-      };
-    })
-  );
-}
-function getCommandExamples(commandName, filters = {}) {
-  if (commandName === "schemas fields create") {
-    return buildSchemaFieldCreateExamples(filters.type);
+    ],
+    "createdAt": "2026-01-15T10:00:00Z",
+    "updatedAt": "2026-01-20T14:30:00Z",
+    "createdBy": "creator@example.com",
+    "updatedBy": "updater@example.com"
   }
-  return specificExamples[commandName] ?? fallbackExamples(commandName);
-}
-function getResolvedCommandExamples(commandName, filters = {}) {
-  return getCommandExamples(commandName, filters);
-}
-
-// src/cli-examples.ts
-function getStdout(stdout) {
-  return stdout ?? process.stdout;
-}
-function extractExampleFilters(tokens) {
-  const filters = {};
-  for (let index = 0; index < tokens.length; index += 1) {
-    const token = tokens[index];
-    if (token === "--type") {
-      const value = tokens[index + 1];
-      if (value && !value.startsWith("-")) {
-        filters.type = value;
-        index += 1;
-      }
+]`
     }
-  }
-  return filters;
+  ]),
+  "document-templates get": buildCommandExamples([
+    {
+      description: "Look up one template by UUID. The CLI filters the list endpoint locally (the backend does not expose a get-one route).",
+      command: "zinkee --json document-templates get 7c4a8d3f-1b2e-4a5c-9d6e-1f2a3b4c5d6e",
+      response: `{
+  "id": "7c4a8d3f-1b2e-4a5c-9d6e-1f2a3b4c5d6e",
+  "name": "Quarterly report",
+  "assets": [
+    {
+      "id": "9e8d7c6b-5a4f-3e2d-1c0b-9a8b7c6d5e4f",
+      "name": "Requirements.docx",
+      "link": "/api/v2/document-templates/7c4a8d3f-1b2e-4a5c-9d6e-1f2a3b4c5d6e/assets/9e8d7c6b-5a4f-3e2d-1c0b-9a8b7c6d5e4f/download"
+    }
+  ],
+  "createdAt": "2026-01-15T10:00:00Z",
+  "updatedAt": "2026-01-20T14:30:00Z",
+  "createdBy": "creator@example.com",
+  "updatedBy": "creator@example.com"
+}`
+    },
+    {
+      description: "Look up by exact template name. Names are unique within the workspace; ambiguity is reported as an error.",
+      command: 'zinkee --json document-templates get "Quarterly report"'
+    }
+  ]),
+  "document-templates create": buildCommandExamples([
+    {
+      description: "Typical create: empty template by name. Assets are uploaded afterwards via document-templates assets add.",
+      command: 'zinkee --json document-templates create --name "Quarterly report"',
+      raw: `{
+  "name": "Quarterly report",
+  "assets": []
+}`,
+      response: `{
+  "id": "7c4a8d3f-1b2e-4a5c-9d6e-1f2a3b4c5d6e",
+  "name": "Quarterly report",
+  "assets": [],
+  "createdAt": "2026-01-15T10:00:00Z",
+  "updatedAt": "2026-01-15T10:00:00Z",
+  "createdBy": "creator@example.com",
+  "updatedBy": "creator@example.com"
+}`
+    },
+    {
+      description: "Create with pre-existing asset records via --raw. Used for import/migration flows where the assets already exist elsewhere; the typical UX is to create empty and upload via assets add.",
+      command: `zinkee --json document-templates create --raw '{"name":"Annual report","assets":[{"id":"9e8d7c6b-5a4f-3e2d-1c0b-9a8b7c6d5e4f","name":"Cover.docx","link":"/existing/cover.docx"},{"id":"3f2e1d0c-9b8a-7654-3210-fedcba987654","name":"Appendix.docx","link":"/existing/appendix.docx"}]}'`,
+      raw: `{
+  "name": "Annual report",
+  "assets": [
+    {
+      "id": "9e8d7c6b-5a4f-3e2d-1c0b-9a8b7c6d5e4f",
+      "name": "Cover.docx",
+      "link": "/existing/cover.docx"
+    },
+    {
+      "id": "3f2e1d0c-9b8a-7654-3210-fedcba987654",
+      "name": "Appendix.docx",
+      "link": "/existing/appendix.docx"
+    }
+  ]
+}`
+    }
+  ]),
+  "document-templates update": buildCommandExamples([
+    {
+      description: "Rename a template. The template argument accepts a UUID or an exact current name. Only the name is updatable through this endpoint; assets are managed via the assets subcommands.",
+      command: 'zinkee --json document-templates update "Quarterly report" --name "Annual report"',
+      raw: `{
+  "name": "Annual report"
+}`,
+      response: `{
+  "id": "7c4a8d3f-1b2e-4a5c-9d6e-1f2a3b4c5d6e",
+  "name": "Annual report",
+  "assets": [
+    {
+      "id": "9e8d7c6b-5a4f-3e2d-1c0b-9a8b7c6d5e4f",
+      "name": "Requirements.docx",
+      "link": "/api/v2/document-templates/7c4a8d3f-1b2e-4a5c-9d6e-1f2a3b4c5d6e/assets/9e8d7c6b-5a4f-3e2d-1c0b-9a8b7c6d5e4f/download"
+    }
+  ],
+  "createdAt": "2026-01-15T10:00:00Z",
+  "updatedAt": "2026-01-22T09:15:00Z",
+  "createdBy": "creator@example.com",
+  "updatedBy": "updater@example.com"
+}`
+    }
+  ]),
+  "document-templates delete": buildCommandExamples([
+    {
+      description: "Delete a template and remove its asset files from storage. Record fields that reference previously generated documents are not modified.",
+      command: "zinkee --json document-templates delete 7c4a8d3f-1b2e-4a5c-9d6e-1f2a3b4c5d6e",
+      response: `{
+  "id": "7c4a8d3f-1b2e-4a5c-9d6e-1f2a3b4c5d6e",
+  "deleted": true
+}`
+    }
+  ]),
+  "document-templates assets add": buildCommandExamples([
+    {
+      description: 'Upload a local file as an asset of a template. The CLI sends a multipart form with a part named "file"; the asset display name defaults to the uploaded filename.',
+      command: 'zinkee --json document-templates assets add "Quarterly report" ./contract.docx',
+      response: `{
+  "id": "7c4a8d3f-1b2e-4a5c-9d6e-1f2a3b4c5d6e",
+  "name": "Quarterly report",
+  "assets": [
+    {
+      "id": "9e8d7c6b-5a4f-3e2d-1c0b-9a8b7c6d5e4f",
+      "name": "contract.docx",
+      "link": "/api/v2/document-templates/7c4a8d3f-1b2e-4a5c-9d6e-1f2a3b4c5d6e/assets/9e8d7c6b-5a4f-3e2d-1c0b-9a8b7c6d5e4f/download"
+    }
+  ],
+  "createdAt": "2026-01-15T10:00:00Z",
+  "updatedAt": "2026-01-22T09:15:00Z",
+  "createdBy": "creator@example.com",
+  "updatedBy": "updater@example.com"
+}`
+    },
+    {
+      description: "Override the asset display name with --name (otherwise the uploaded filename is used).",
+      command: 'zinkee --json document-templates assets add "Quarterly report" ./contract.docx --name "Customer Contract"'
+    }
+  ]),
+  "document-templates assets delete": buildCommandExamples([
+    {
+      description: "Delete one asset from a template and remove its file from storage.",
+      command: "zinkee --json document-templates assets delete 7c4a8d3f-1b2e-4a5c-9d6e-1f2a3b4c5d6e 9e8d7c6b-5a4f-3e2d-1c0b-9a8b7c6d5e4f",
+      response: `{
+  "id": "9e8d7c6b-5a4f-3e2d-1c0b-9a8b7c6d5e4f",
+  "deleted": true
+}`
+    }
+  ]),
+  "document-templates assets download": buildCommandExamples([
+    {
+      description: "Download asset bytes to disk. The CLI streams the raw bytes to --output; in --json mode --output is required and the JSON envelope only carries metadata.",
+      command: "zinkee --json document-templates assets download 7c4a8d3f-1b2e-4a5c-9d6e-1f2a3b4c5d6e 9e8d7c6b-5a4f-3e2d-1c0b-9a8b7c6d5e4f --output ./contract.docx"
+    },
+    {
+      description: "Stream asset bytes to stdout (omit --json and --output). Useful for piping into other tools.",
+      command: "zinkee document-templates assets download 7c4a8d3f-1b2e-4a5c-9d6e-1f2a3b4c5d6e 9e8d7c6b-5a4f-3e2d-1c0b-9a8b7c6d5e4f > contract.docx"
+    }
+  ])
+};
+function fallbackExamples(commandName) {
+  switch (commandName) {
+    default:
+      return [];
+  }
+}
+function buildSchemaFieldCreateExamples(type) {
+  const definitions = getSchemaFieldTypeDefinitions();
+  const selectedDefinition = resolveSchemaFieldType(type);
+  const filteredDefinitions = selectedDefinition ? definitions.filter((definition) => definition.key === selectedDefinition.key) : definitions;
+  const flat = filteredDefinitions.flatMap(
+    (definition) => definition.examplePayloads.map((example) => ({ definition, example }))
+  );
+  return buildCommandExamples(
+    flat.map(({ example }, index) => {
+      const slug = typeof example.payload.slug === "string" ? example.payload.slug : "field";
+      const command = `zinkee --json schemas fields create contacts --raw '${JSON.stringify(example.payload)}'`;
+      if (index === 0) {
+        return {
+          description: example.name,
+          command,
+          response: `{
+  "schemaId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+  "fieldId": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+  "slug": "${slug}"
+}`
+        };
+      }
+      return {
+        description: example.name,
+        command
+      };
+    })
+  );
+}
+function getCommandExamples(commandName, filters = {}) {
+  const examples = commandName === "schemas fields create" ? buildSchemaFieldCreateExamples(filters.type) : specificExamples[commandName] ?? fallbackExamples(commandName);
+  return examples.map((example) => withResponseEnvelope(example, commandName));
+}
+function withResponseEnvelope(example, commandName) {
+  if (example.response === void 0) {
+    return example;
+  }
+  let payload;
+  try {
+    payload = JSON.parse(example.response);
+  } catch {
+    return example;
+  }
+  return {
+    ...example,
+    response: JSON.stringify(buildJsonSuccess(payload, { command: commandName }), null, 2)
+  };
+}
+function getResolvedCommandExamples(commandName, filters = {}) {
+  return getCommandExamples(commandName, filters);
+}
+
+// src/cli-examples.ts
+function getStdout(stdout) {
+  return stdout ?? process.stdout;
+}
+function extractExampleFilters(tokens) {
+  const filters = {};
+  for (let index = 0; index < tokens.length; index += 1) {
+    const token = tokens[index];
+    if (token === "--type") {
+      const value = tokens[index + 1];
+      if (value && !value.startsWith("-")) {
+        filters.type = value;
+        index += 1;
+      }
+    }
+  }
+  return filters;
 }
 function extractExampleRequest(argv, optionMeta = createDefaultOptionMetadata()) {
   if (!argv.includes("--example")) {
@@ -5634,7 +6354,22 @@ function extractExampleRequest(argv, optionMeta = createDefaultOptionMetadata())
   const operands = collectOperandTokens(userArgs, optionMeta, { skipFlag: "--example" });
   const cmdPath = findCommandPath(operands, commandRegistry);
   if (!cmdPath) {
-    throw new CliError("invalid_cli_usage", 'Provide a command after "--example".');
+    const typed = operands.map((operand) => operand.token).join(" ");
+    if (typed.length === 0) {
+      throw new CliError("invalid_cli_usage", 'Provide a command after "--example".');
+    }
+    const subcommands = Object.keys(commandRegistry).filter(
+      (name) => name.startsWith(`${typed} `)
+    );
+    if (subcommands.length > 0) {
+      const list = subcommands.map((name) => `  zinkee --example ${name}`).join("\n");
+      throw new CliError(
+        "invalid_cli_usage",
+        `"${typed}" is a command group, not a runnable command. Available subcommands:
+${list}`
+      );
+    }
+    throw new CliError("invalid_cli_usage", `Unknown command "${typed}".`);
   }
   const remainingTokens = userArgs.slice(cmdPath.lastArgvIndex + 1);
   return {
@@ -5680,7 +6415,7 @@ ${index + 1}. ${example.description}
 
 // src/program.ts
 import { createRequire } from "module";
-import { Command as Command10 } from "commander";
+import { Command as Command11 } from "commander";
 
 // src/config.ts
 import { mkdirSync, readFileSync, writeFileSync } from "fs";
@@ -6034,7 +6769,7 @@ var AutomationsApi = class {
   }
   moveAutomation(input) {
     return this.client.requestJson(
-      `/api/v2/automation-folders/${segment(input.targetFolderId)}/automations:move`,
+      "/api/v2/automation-folders/automations:move",
       jsonOptions(input, "POST")
     );
   }
@@ -6441,11 +7176,11 @@ function hasSetPath(target, path) {
     return Object.hasOwn(target, path);
   }
   let current = target;
-  for (const segment3 of segments) {
-    if (!isJsonObject2(current) || !Object.hasOwn(current, segment3)) {
+  for (const segment4 of segments) {
+    if (!isJsonObject2(current) || !Object.hasOwn(current, segment4)) {
       return false;
     }
-    current = current[segment3];
+    current = current[segment4];
   }
   return true;
 }
@@ -6908,6 +7643,15 @@ function buildActionInput(options, mode) {
   if (options.targetSchema !== void 0) {
     config.targetSchemaId = options.targetSchema;
   }
+  if (options.to !== void 0) {
+    mappings.recipients = options.to;
+  }
+  if (options.subject !== void 0) {
+    mappings.subject = options.subject;
+  }
+  if (options.message !== void 0) {
+    mappings.body = options.message;
+  }
   if (!isEmptyObject(mappings)) {
     config.fieldMapping = mappings;
   }
@@ -6951,6 +7695,12 @@ function buildActionInput(options, mode) {
   if (!isEmptyObject(args)) {
     config.pluginArgs = args;
   }
+  if (options.documentTemplate !== void 0) {
+    config.documentTemplateId = options.documentTemplate;
+  }
+  if (options.targetFileField !== void 0) {
+    config.targetFileFieldId = options.targetFileField;
+  }
   if (!isEmptyObject(config)) {
     if (isJsonObject2(config.fieldMapping)) {
       config.fieldMapping = normalizeAutomationFieldMapping(
@@ -7137,19 +7887,35 @@ function addTriggerPayloadOptions(command) {
     []
   ).option("--webhook-endpoint-id <uuid>", "webhook endpoint id").option("--raw <json>", "raw trigger JSON payload").option("--raw-file <path>", "path to raw trigger JSON payload");
 }
+var ACTION_TYPES_HELP = `
+Action types and their flags:
+  create_record      --target-schema, --map, --map-json
+  update_record      --target-schema, --use-trigger-record, --map,
+                     --condition, --condition-json
+  search_records     --target-schema, --condition, --condition-json
+  send_message       --to, --subject, --message
+                     (--map / --map-json also accepted for extra keys)
+  http_request       --method, --url, --header, --body, --content-type,
+                     --timeout-ms, --var, --auth-mode, --connection
+  execute_plugin     --plugin, --arg, --arg-json
+  generate_document  --document-template, --target-schema, --target-file-field
+`;
 function addActionPayloadOptions(command) {
-  return command.option("--type <type>", "action type").option("--name <name>", "action name").option("--target-schema <uuid>", "target schema id").option("--map <field=value>", "field mapping", collectValues, []).option("--map-json <field=json>", "JSON field mapping", collectValues, []).option("--condition <field:comparator:value>", "action condition", collectValues, []).option("--condition-json <json>", "action condition as JSON", collectValues, []).option("--use-trigger-record", "use the triggering record").option("--method <method>", "HTTP method").option("--url <url>", "HTTP target URL").option("--header <key=value>", "HTTP header", collectValues, []).option("--body <json>", "HTTP request body as JSON").option("--body-file <path>", "path to HTTP request body JSON").option("--content-type <type>", "HTTP content type").option(
+  return command.option(
+    "--type <type>",
+    "action type (create_record|update_record|search_records|send_message|http_request|execute_plugin|generate_document)"
+  ).option("--name <name>", "action name").option("--target-schema <uuid>", "target schema id").option("--map <field=value>", "field mapping", collectValues, []).option("--map-json <field=json>", "JSON field mapping", collectValues, []).option("--condition <field:comparator:value>", "action condition", collectValues, []).option("--condition-json <json>", "action condition as JSON", collectValues, []).option("--use-trigger-record", "use the triggering record").option("--method <method>", "HTTP method").option("--url <url>", "HTTP target URL").option("--header <key=value>", "HTTP header", collectValues, []).option("--body <json>", "HTTP request body as JSON").option("--body-file <path>", "path to HTTP request body JSON").option("--content-type <type>", "HTTP content type").option(
     "--timeout-ms <n>",
     "HTTP timeout in milliseconds",
     parseNonNegativeInteger
-  ).option("--var <key=value>", "HTTP variable", collectValues, []).option("--auth-mode <mode>", "HTTP auth mode").option("--connection <uuid>", "connection id for HTTP auth").option("--plugin <id>", "plugin id for execute_plugin").option("--arg <key=value>", "plugin argument", collectValues, []).option("--arg-json <key=json>", "plugin argument as JSON", collectValues, []).option("--raw <json>", "raw action JSON payload").option("--raw-file <path>", "path to raw action JSON payload");
+  ).option("--var <key=value>", "HTTP variable", collectValues, []).option("--auth-mode <mode>", "HTTP auth mode").option("--connection <uuid>", "connection id for HTTP auth").option("--plugin <id>", "plugin id for execute_plugin").option("--arg <key=value>", "plugin argument", collectValues, []).option("--arg-json <key=json>", "plugin argument as JSON", collectValues, []).option("--to <recipient>", "send_message recipient (maps to fieldMapping.recipients)").option("--subject <text>", "send_message subject").option("--message <text>", "send_message body text (maps to fieldMapping.body)").option("--document-template <uuid>", "generate_document template id").option("--target-file-field <uuid>", "generate_document target FileField id").option("--raw <json>", "raw action JSON payload").option("--raw-file <path>", "path to raw action JSON payload").addHelpText("after", ACTION_TYPES_HELP);
 }
 function registerAutomationsCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
   const stdout = getCommandIo2(options.stdout);
   const automations = program.command("automations").description("Manage automations, triggers, actions, and connections");
-  const folders = automations.command("folders").description("Manage automation folders");
-  folders.command("list").description("List automation folders").action(async function action() {
+  const folders = automations.command("folders").description("Manage automation folders (flat: a folder only has a name, no order or properties)");
+  folders.command("list").description("List automation folders (non-root folders plus the root bucket, whose name is null)").action(async function action() {
     const { api, json } = createAutomationsApi(this, filePath);
     const data = await api.listFolders();
     if (json) {
@@ -7199,7 +7965,11 @@ function registerAutomationsCommands(program, options = {}) {
     }
     writeLine2(stdout, `Deleted automation folder "${folder.value}".`);
   });
-  folders.command("move").description("Move an automation into a folder").argument("<automation>", "automation UUID", parseUuidOrSlugSelector).requiredOption("--to <folder>", "target folder UUID or exact name", parseUuidOrSlugSelector).action(async function action(automation, commandOptions) {
+  folders.command("move").description("Move an automation into a folder").argument("<automation>", "automation UUID", parseUuidOrSlugSelector).requiredOption(
+    "--to <folder>",
+    "target folder UUID or exact name (use the root folder to move it out of any folder)",
+    parseUuidOrSlugSelector
+  ).action(async function action(automation, commandOptions) {
     const { api, json, readOnly } = createAutomationsApi(this, filePath);
     ensureWritable("automations folders move", readOnly, "write");
     if (!commandOptions.to) {
@@ -7884,9 +8654,117 @@ var DisplaysApi = class {
       { method: "DELETE" }
     );
   }
+  listFolders() {
+    return this.client.getJson("/api/v2/display-folders");
+  }
+  createFolder(body) {
+    return this.client.requestJson(
+      "/api/v2/display-folders",
+      jsonOptions3(body, "POST")
+    );
+  }
+  updateFolder(folder, body) {
+    return this.client.requestJson(
+      `/api/v2/display-folders/${selectorValue3(folder)}`,
+      jsonOptions3(body, "PATCH")
+    );
+  }
+  deleteFolder(folder) {
+    return this.client.requestJson(
+      `/api/v2/display-folders/${selectorValue3(folder)}`,
+      { method: "DELETE" }
+    );
+  }
+  moveDisplay(input) {
+    return this.client.requestJson(
+      "/api/v2/display-folders/displays:move",
+      jsonOptions3(input, "POST")
+    );
+  }
 };
 
+// src/parsers/expressions.ts
+var supportedComparators = /* @__PURE__ */ new Set([
+  "eq",
+  "neq",
+  "gt",
+  "gte",
+  "lt",
+  "lte",
+  "contains",
+  "in",
+  "is_empty",
+  "is_not_empty"
+]);
+var noValueComparators = /* @__PURE__ */ new Set(["is_empty", "is_not_empty"]);
+function parseColonExpression(input) {
+  const parts = input.split(":");
+  if (parts.length < 2) {
+    throw new Error(`Expected a field:comparator[:value] expression, got "${input}".`);
+  }
+  const field = parts[0]?.trim();
+  const comparator = parts[1]?.trim();
+  if (!field) {
+    throw new Error(`Expected a field before ":", got "${input}".`);
+  }
+  if (!comparator) {
+    throw new Error(`Expected a comparator after "${field}:", got "${input}".`);
+  }
+  return [field, comparator, parts.slice(2).join(":").trim()];
+}
+function parseSpaceExpression(input) {
+  const parts = input.trim().split(/\s+/);
+  if (parts.length < 2) {
+    throw new Error(`Expected a field comparator expression, got "${input}".`);
+  }
+  const field = parts[0];
+  const comparator = parts[1];
+  if (!field) {
+    throw new Error(`Expected a field comparator expression, got "${input}".`);
+  }
+  if (!comparator) {
+    throw new Error(`Expected a comparator after "${field}", got "${input}".`);
+  }
+  return [field.trim(), comparator.trim(), parts.slice(2).join(" ").trim()];
+}
+function normalizeValue(comparator, rawValue) {
+  if (noValueComparators.has(comparator)) {
+    if (rawValue.length > 0) {
+      throw new Error(`Comparator "${comparator}" does not accept a value.`);
+    }
+    return null;
+  }
+  if (comparator === "in") {
+    const values = rawValue.split(",").map((value) => value.trim()).filter(Boolean);
+    if (values.length === 0) {
+      throw new Error(`Comparator "${comparator}" requires at least one value.`);
+    }
+    return values;
+  }
+  if (rawValue.length === 0) {
+    throw new Error(`Comparator "${comparator}" requires a value.`);
+  }
+  return rawValue;
+}
+function parseExpression(input) {
+  const trimmed = input.trim();
+  const [field, comparatorCandidate, rawValue] = trimmed.includes(":") && !trimmed.includes(" ") ? parseColonExpression(trimmed) : parseSpaceExpression(trimmed);
+  if (!supportedComparators.has(comparatorCandidate)) {
+    throw new Error(
+      `Unsupported comparator "${comparatorCandidate}" in expression "${input}".`
+    );
+  }
+  const comparator = comparatorCandidate;
+  return {
+    field,
+    comparator,
+    value: normalizeValue(comparator, rawValue),
+    raw: trimmed
+  };
+}
+
 // src/commands/displays.ts
+var DATE_DYNAMIC_OPTIONS = "today, thisWeek, thisMonth, thisQuarter, thisSemester, thisYear, next7Days, next30Days, next6Months, next12Months, last12Months";
 function getCommandIo4(stdout) {
   return stdout ?? process.stdout;
 }
@@ -7950,6 +8828,37 @@ function parseUuidOrSlugSelector3(input) {
     throw new InvalidArgumentError3(message);
   }
 }
+var COMPARATOR_TO_DISPLAY_OPERATOR = {
+  eq: "EQUAL",
+  neq: "NOT_EQUAL",
+  gt: "GREATER",
+  gte: "GREATER_OR_EQUAL",
+  lt: "LESS",
+  lte: "LESS_OR_EQUAL",
+  contains: "CONTAINS",
+  in: "ANY_OF",
+  is_empty: "IS_EMPTY",
+  is_not_empty: "IS_NOT_EMPTY"
+};
+function toDisplayFilter(parsed) {
+  const values = parsed.value === null ? [] : Array.isArray(parsed.value) ? [...parsed.value] : [parsed.value];
+  return {
+    origin: { fieldId: parsed.field },
+    comparisonOperator: COMPARATOR_TO_DISPLAY_OPERATOR[parsed.comparator],
+    values
+  };
+}
+function parseFilterExpression(input) {
+  try {
+    return parseExpression(input);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Invalid filter expression.";
+    throw new InvalidArgumentError3(message);
+  }
+}
+function collectFilters(value, previous = []) {
+  return [...previous, parseFilterExpression(value)];
+}
 function readRawObject2(raw, rawFile) {
   if (raw && rawFile) {
     throw new CliError("invalid_cli_usage", 'Use either "--raw" or "--raw-file", not both.');
@@ -7984,8 +8893,152 @@ function readNamedJsonOption(raw, rawFile, inlineFlag = "--option", fileFlag = "
 function isEmptyObject3(value) {
   return Object.keys(value).length === 0;
 }
-function displayRows(displays) {
-  return displays.map((display) => ({
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function deepMerge(target, source) {
+  const out = { ...target };
+  for (const [key, value] of Object.entries(source)) {
+    const existing = out[key];
+    out[key] = isPlainObject(existing) && isPlainObject(value) ? deepMerge(existing, value) : value;
+  }
+  return out;
+}
+function assignDefined(target, key, value) {
+  if (value !== void 0) target[key] = value;
+}
+function readNamedJsonObject(raw, rawFile, inlineFlag, fileFlag) {
+  const parsed = readNamedJsonOption(raw, rawFile, inlineFlag, fileFlag);
+  if (parsed === void 0) return void 0;
+  if (!isPlainObject(parsed)) {
+    throw new CliError("invalid_cli_usage", `${inlineFlag} payload must be a JSON object.`);
+  }
+  return parsed;
+}
+var HIERARCHY_AGGREGATIONS = /* @__PURE__ */ new Set([
+  "SUM",
+  "AVERAGE",
+  "MINIMUM",
+  "MAXIMUM",
+  "COUNT",
+  "COUNT_DISTINCT"
+]);
+function parseHierarchyInfo(value) {
+  const idx = value.indexOf(":");
+  if (idx <= 0 || idx === value.length - 1) {
+    throw new CliError("invalid_cli_usage", `--hierarchy-info "${value}" must use the format <id:name>.`);
+  }
+  return { id: value.slice(0, idx).trim(), name: value.slice(idx + 1).trim() };
+}
+function parseHierarchyNumber(value) {
+  const parts = value.split(":");
+  if (parts.length < 3) {
+    throw new CliError(
+      "invalid_cli_usage",
+      `--hierarchy-number "${value}" must use the format <id:name:aggregation>.`
+    );
+  }
+  const id = parts[0]?.trim() ?? "";
+  const aggregation = (parts[parts.length - 1]?.trim() ?? "").toUpperCase();
+  const name = parts.slice(1, -1).join(":").trim();
+  if (!id || !name) {
+    throw new CliError(
+      "invalid_cli_usage",
+      `--hierarchy-number "${value}" must use the format <id:name:aggregation>.`
+    );
+  }
+  if (!HIERARCHY_AGGREGATIONS.has(aggregation)) {
+    throw new CliError(
+      "invalid_cli_usage",
+      `--hierarchy-number aggregation "${aggregation}" must be one of SUM, AVERAGE, MINIMUM, MAXIMUM, COUNT, COUNT_DISTINCT.`
+    );
+  }
+  return { id, name, aggregation };
+}
+function parseHierarchyMapping(value, flag) {
+  const idx = value.indexOf(":");
+  if (idx <= 0 || idx === value.length - 1) {
+    throw new CliError("invalid_cli_usage", `${flag} "${value}" must use the format <columnId:fieldId>.`);
+  }
+  return { columnId: value.slice(0, idx).trim(), fieldId: value.slice(idx + 1).trim() };
+}
+function buildWidgetFieldMapping(options) {
+  const mapping = {};
+  assignDefined(mapping, "columnField", options.columnField);
+  assignDefined(mapping, "swimlaneField", options.swimlaneField);
+  assignDefined(mapping, "startDateField", options.startDateField);
+  assignDefined(mapping, "endDateField", options.endDateField);
+  assignDefined(mapping, "labelField", options.labelField);
+  assignDefined(mapping, "groupField", options.groupField);
+  assignDefined(mapping, "subgroupField", options.subgroupField);
+  assignDefined(mapping, "progressField", options.progressField);
+  const cardConfig = {};
+  assignDefined(cardConfig, "titleField", options.cardTitleField);
+  assignDefined(cardConfig, "category1Field", options.cardCategory1Field);
+  assignDefined(cardConfig, "category2Field", options.cardCategory2Field);
+  assignDefined(cardConfig, "category3Field", options.cardCategory3Field);
+  assignDefined(cardConfig, "category4Field", options.cardCategory4Field);
+  assignDefined(cardConfig, "descriptionField", options.cardDescriptionField);
+  if (Object.keys(cardConfig).length > 0) mapping.cardConfig = cardConfig;
+  const aggregationConfig = {};
+  assignDefined(aggregationConfig, "method", options.aggregationMethod);
+  assignDefined(aggregationConfig, "fieldId", options.aggregationField);
+  if (Object.keys(aggregationConfig).length > 0) mapping.aggregationConfig = aggregationConfig;
+  return Object.keys(mapping).length > 0 ? mapping : void 0;
+}
+function buildHierarchyConfig(options) {
+  const base = readNamedJsonObject(
+    options.hierarchyConfig,
+    options.hierarchyConfigFile,
+    "--hierarchy-config",
+    "--hierarchy-config-file"
+  );
+  const patch = {};
+  const columns = {};
+  assignDefined(columns, "label", options.hierarchyLabel);
+  if (options.hierarchyInfo && options.hierarchyInfo.length > 0) {
+    columns.infos = options.hierarchyInfo.map(parseHierarchyInfo);
+  }
+  if (options.hierarchyNumber && options.hierarchyNumber.length > 0) {
+    columns.numbers = options.hierarchyNumber.map(parseHierarchyNumber);
+  }
+  if (Object.keys(columns).length > 0) patch.columns = columns;
+  const rootLevel = {};
+  assignDefined(rootLevel, "name", options.hierarchyRootName);
+  assignDefined(rootLevel, "labelFieldId", options.hierarchyRootLabelField);
+  if (options.hierarchyRootInfo && options.hierarchyRootInfo.length > 0) {
+    rootLevel.infoMappings = options.hierarchyRootInfo.map(
+      (entry) => parseHierarchyMapping(entry, "--hierarchy-root-info")
+    );
+  }
+  if (options.hierarchyRootNumber && options.hierarchyRootNumber.length > 0) {
+    rootLevel.numberMappings = options.hierarchyRootNumber.map(
+      (entry) => parseHierarchyMapping(entry, "--hierarchy-root-number")
+    );
+  }
+  if (Object.keys(rootLevel).length > 0) patch.rootLevel = rootLevel;
+  if (options.hierarchyChild && options.hierarchyChild.length > 0) {
+    patch.childLevels = options.hierarchyChild.map((entry, index) => {
+      let parsed;
+      try {
+        parsed = JSON.parse(entry);
+      } catch {
+        throw new CliError("invalid_cli_usage", `--hierarchy-child payload #${index + 1} is invalid JSON.`);
+      }
+      if (!isPlainObject(parsed)) {
+        throw new CliError(
+          "invalid_cli_usage",
+          `--hierarchy-child payload #${index + 1} must be a JSON object.`
+        );
+      }
+      return parsed;
+    });
+  }
+  if (base === void 0 && Object.keys(patch).length === 0) return void 0;
+  return deepMerge(base ?? {}, patch);
+}
+function displayRows(displays) {
+  return displays.map((display) => ({
     id: display.id,
     name: display.name ?? "",
     layoutTemplate: display.layoutTemplate ?? "",
@@ -7999,6 +9052,31 @@ function getDisplaySubresource(value) {
   }
   return value.filter((entry) => Boolean(entry) && typeof entry === "object");
 }
+function displayFolderRows(folders) {
+  return folders.map((folder) => ({
+    id: folder.id ?? "",
+    name: folder.name ?? "",
+    isRoot: folder.isRoot ?? "",
+    displayCount: folder.displayCount ?? ""
+  }));
+}
+async function resolveDisplayFolderId(api, selector) {
+  if (selector.kind === "uuid") {
+    return selector.value;
+  }
+  const folders = await api.listFolders();
+  const matches = folders.filter((folder) => folder.name === selector.value);
+  if (matches.length === 1 && typeof matches[0]?.id === "string" && matches[0].id.length > 0) {
+    return matches[0].id;
+  }
+  if (matches.length > 1) {
+    throw new CliError(
+      "invalid_cli_usage",
+      `Folder "${selector.value}" is ambiguous. Found ${matches.length} matches.`
+    );
+  }
+  throw new CliError("invalid_cli_usage", `Folder "${selector.value}" was not found.`);
+}
 function buildVariableBody(options) {
   const body = {
     ...readRawObject2(options.raw, options.rawFile)
@@ -8016,7 +9094,7 @@ function buildVariableBody(options) {
     };
   }
   if (options.filter && options.filter.length > 0) {
-    body.filters = options.filter.map((entry) => ({ raw: entry }));
+    body.filters = options.filter.map(toDisplayFilter);
   }
   if (options.dateMode || options.dateDynamicOption || options.dateSpecific || options.dateRangeStart || options.dateRangeEnd) {
     body.date = {
@@ -8065,15 +9143,39 @@ function buildWidgetBody(options) {
       layout
     };
   }
-  if (options.field?.length || options.sort?.length || options.filter?.length) {
-    body.view = {
-      ...typeof body.view === "object" && body.view ? body.view : {},
-      fields: options.field
-    };
+  const viewPatch = {};
+  if (options.field && options.field.length > 0) {
+    viewPatch.fields = options.field;
+  }
+  const fieldMapping = buildWidgetFieldMapping(options);
+  const viewStateBase = readNamedJsonObject(
+    options.viewState,
+    options.viewStateFile,
+    "--view-state",
+    "--view-state-file"
+  );
+  let viewState = viewStateBase ? { ...viewStateBase } : void 0;
+  if (fieldMapping) {
+    viewState = deepMerge(viewState ?? {}, { fieldMapping });
+  }
+  if (viewState !== void 0) {
+    viewPatch.viewAdditionalProperties = { viewState };
+  }
+  const hierarchyConfig = buildHierarchyConfig(options);
+  if (hierarchyConfig !== void 0) {
+    viewPatch.hierarchyConfig = hierarchyConfig;
+  }
+  if (Object.keys(viewPatch).length > 0) {
+    const existingView = typeof body.view === "object" && body.view ? body.view : {};
+    body.view = deepMerge(existingView, viewPatch);
+  }
+  const queryMerge = {};
+  if (options.sort && options.sort.length > 0) queryMerge.sorts = options.sort;
+  if (options.filter && options.filter.length > 0) queryMerge.filters = options.filter.map(toDisplayFilter);
+  if (Object.keys(queryMerge).length > 0) {
     body.query = {
       ...typeof body.query === "object" && body.query ? body.query : {},
-      sorts: options.sort,
-      filters: options.filter?.map((entry) => ({ raw: entry }))
+      ...queryMerge
     };
   }
   if (options.widgetReadOnly !== void 0 || options.hideAddButton !== void 0 || options.hideDeleteButton !== void 0 || options.hideSortButton !== void 0 || options.hideFilterButton !== void 0 || options.hideSeeButton !== void 0) {
@@ -8200,6 +9302,72 @@ function registerDisplaysCommands(program, options = {}) {
     }
     writeLine4(stdout, `Deleted display "${display.value}".`);
   });
+  const folders = displays.command("folders").description("Manage display folders (flat: a folder only has a name, no order or properties)");
+  folders.command("list").description("List display folders (non-root folders plus the root bucket, whose name is null)").action(async function action() {
+    const { api, json } = createDisplaysApi(this, filePath);
+    const data = await api.listFolders();
+    if (json) {
+      emitJson4(stdout, "displays folders list", data);
+      return;
+    }
+    printTable(displayFolderRows(data), ["id", "name", "isRoot", "displayCount"], stdout);
+  });
+  folders.command("create").description("Create a display folder").requiredOption("--name <name>", "folder name").action(async function action(commandOptions) {
+    const { api, json, readOnly } = createDisplaysApi(this, filePath);
+    ensureWritable3("displays folders create", readOnly, "write");
+    if (commandOptions.name === void 0) {
+      throw new CliError("invalid_cli_usage", 'Provide folder name via "--name".');
+    }
+    const data = await api.createFolder({ name: commandOptions.name });
+    if (json) {
+      emitJson4(stdout, "displays folders create", data);
+      return;
+    }
+    writeLine4(stdout, `Created display folder "${String(data.name ?? commandOptions.name)}".`);
+  });
+  folders.command("update").description("Rename a display folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector3).requiredOption("--name <name>", "folder name").action(async function action(folder, commandOptions) {
+    const { api, json, readOnly } = createDisplaysApi(this, filePath);
+    ensureWritable3("displays folders update", readOnly, "write");
+    if (commandOptions.name === void 0) {
+      throw new CliError("invalid_cli_usage", 'Provide folder name via "--name".');
+    }
+    const folderId = await resolveDisplayFolderId(api, folder);
+    const data = await api.updateFolder({ kind: "uuid", value: folderId }, { name: commandOptions.name });
+    if (json) {
+      emitJson4(stdout, "displays folders update", data);
+      return;
+    }
+    writeLine4(stdout, `Updated display folder "${String(data.name ?? folder.value)}".`);
+  });
+  folders.command("delete").description("Delete a display folder (its displays move back to the root folder)").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector3).action(async function action(folder) {
+    const { api, json, readOnly } = createDisplaysApi(this, filePath);
+    ensureWritable3("displays folders delete", readOnly, "destructive");
+    const folderId = await resolveDisplayFolderId(api, folder);
+    const data = await api.deleteFolder({ kind: "uuid", value: folderId });
+    if (json) {
+      emitJson4(stdout, "displays folders delete", data);
+      return;
+    }
+    writeLine4(stdout, `Deleted display folder "${folder.value}".`);
+  });
+  folders.command("move").description("Move a display into a folder").argument("<display>", "display UUID", parseUuidOrSlugSelector3).requiredOption(
+    "--to <folder>",
+    "target folder UUID or exact name (use the root folder to move it out of any folder)",
+    parseUuidOrSlugSelector3
+  ).action(async function action(display, commandOptions) {
+    const { api, json, readOnly } = createDisplaysApi(this, filePath);
+    ensureWritable3("displays folders move", readOnly, "write");
+    if (!commandOptions.to) {
+      throw new CliError("invalid_cli_usage", 'Provide target folder via "--to".');
+    }
+    const targetFolderId = await resolveDisplayFolderId(api, commandOptions.to);
+    const data = await api.moveDisplay({ displayId: display.value, targetFolderId });
+    if (json) {
+      emitJson4(stdout, "displays folders move", data);
+      return;
+    }
+    writeLine4(stdout, `Moved display "${display.value}" to folder "${targetFolderId}".`);
+  });
   const layout = displays.command("layout").description("Manage display layout");
   layout.command("get").description("Get display layout").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).action(async function action(display) {
     const { api, json } = createDisplaysApi(this, filePath);
@@ -8288,7 +9456,7 @@ function registerDisplaysCommands(program, options = {}) {
     }
     printTable([match], void 0, stdout);
   });
-  variables.command("create").description("Create variable").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).option("--type <type>").option("--name <name>").option("--allow-multiple").option("--static").option("--default <value>").option("--default-value <value>", "repeatable default value", (v, p = []) => [...p, v], []).option("--source-schema <id>").option("--source-field <id>").option("--filter <expr>", "repeatable filter", (v, p = []) => [...p, v], []).option("--date-mode <mode>").option("--date-dynamic-option <option>").option("--date-specific <iso>").option("--date-range-start <iso>").option("--date-range-end <iso>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, commandOptions) {
+  variables.command("create").description("Create variable").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).option("--type <type>").option("--name <name>").option("--allow-multiple").option("--static").option("--default <value>").option("--default-value <value>", "repeatable default value", (v, p = []) => [...p, v], []).option("--source-schema <id>").option("--source-field <id>").option("--filter <expr>", "repeatable filter", collectFilters, []).option("--date-mode <mode>").option("--date-dynamic-option <option>", `dynamic date period (${DATE_DYNAMIC_OPTIONS})`).option("--date-specific <iso>").option("--date-range-start <iso>").option("--date-range-end <iso>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, commandOptions) {
     const { api, json, readOnly } = createDisplaysApi(this, filePath);
     ensureWritable3("displays variables create", readOnly, "write");
     const data = await api.createVariable(display, buildVariableBody(commandOptions));
@@ -8298,7 +9466,7 @@ function registerDisplaysCommands(program, options = {}) {
     }
     writeLine4(stdout, `Created variable on display "${display.value}".`);
   });
-  variables.command("update").description("Update variable").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<variable>", "variable id").option("--type <type>").option("--name <name>").option("--allow-multiple").option("--static").option("--default <value>").option("--default-value <value>", "repeatable default value", (v, p = []) => [...p, v], []).option("--source-schema <id>").option("--source-field <id>").option("--filter <expr>", "repeatable filter", (v, p = []) => [...p, v], []).option("--date-mode <mode>").option("--date-dynamic-option <option>").option("--date-specific <iso>").option("--date-range-start <iso>").option("--date-range-end <iso>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, variableId, commandOptions) {
+  variables.command("update").description("Update variable").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<variable>", "variable id").option("--type <type>").option("--name <name>").option("--allow-multiple").option("--static").option("--default <value>").option("--default-value <value>", "repeatable default value", (v, p = []) => [...p, v], []).option("--source-schema <id>").option("--source-field <id>").option("--filter <expr>", "repeatable filter", collectFilters, []).option("--date-mode <mode>").option("--date-dynamic-option <option>", `dynamic date period (${DATE_DYNAMIC_OPTIONS})`).option("--date-specific <iso>").option("--date-range-start <iso>").option("--date-range-end <iso>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, variableId, commandOptions) {
     const { api, json, readOnly } = createDisplaysApi(this, filePath);
     ensureWritable3("displays variables update", readOnly, "write");
     const data = await api.updateVariable(display, variableId, buildVariableBody(commandOptions));
@@ -8338,117 +9506,520 @@ function registerDisplaysCommands(program, options = {}) {
     }
     printTable([data], void 0, stdout);
   });
-  widgets.command("create").description("Create widget").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).requiredOption("--type <type>", "widget type").option("--name <name>").option("--description <text>").option("--icon <icon>").option("--color <color>").option("--origin-resource <uuid>").option("--origin-subschema").option("--tab <tabId>").option("--slot <slotId>").option("--layout <json>").option("--layout-file <path>").option("--field <field>", "repeatable field", (v, p = []) => [...p, v], []).option("--sort <sort>", "repeatable sort", (v, p = []) => [...p, v], []).option("--filter <expr>", "repeatable filter", (v, p = []) => [...p, v], []).option("--widget-read-only").option("--hide-add-button").option("--hide-delete-button").option("--hide-sort-button").option("--hide-filter-button").option("--hide-see-button").option("--calc <type>").option("--calc-field <uuid>").option("--kpi-config <json>").option("--chart-type <type>").option("--x-axis-field <uuid>").option("--x-axis-date-format <granularity>").option("--x-axis-time-series").option("--y-axis-serie <json>", "repeatable y axis serie", (v, p = []) => [...p, v], []).option("--legend <json>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, commandOptions) {
+  widgets.command("create").description("Create widget").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).requiredOption("--type <type>", "widget type").option("--name <name>").option("--description <text>").option("--icon <icon>").option("--color <color>").option("--origin-resource <uuid>").option("--origin-subschema").option("--tab <tabId>").option("--slot <slotId>").option("--layout <json>").option("--layout-file <path>").option("--field <field>", "repeatable field", (v, p = []) => [...p, v], []).option("--sort <sort>", "repeatable sort", (v, p = []) => [...p, v], []).option("--filter <expr>", "repeatable filter", collectFilters, []).option("--widget-read-only").option("--hide-add-button").option("--hide-delete-button").option("--hide-sort-button").option("--hide-filter-button").option("--hide-see-button").option("--calc <type>").option("--calc-field <uuid>").option("--kpi-config <json>").option("--chart-type <type>", "chart type (lines, bars, stackedBars, combined)").option("--x-axis-field <uuid>").option("--x-axis-date-format <granularity>", "time granularity (DATE, MONTH_YEAR, QUARTER_YEAR, YEAR)").option("--x-axis-time-series").option("--y-axis-serie <json>", "repeatable y axis serie", (v, p = []) => [...p, v], []).option("--legend <json>").option("--column-field <uuid>", "KANBAN column field (UUID, not slug)").option("--swimlane-field <uuid>", "KANBAN swimlane field (UUID, not slug)").option("--start-date-field <uuid>", "TIMELINE start date field (UUID, not slug)").option("--end-date-field <uuid>", "TIMELINE end date field (UUID, not slug)").option("--label-field <uuid>", "TIMELINE label field (UUID, not slug)").option("--group-field <uuid>", "TIMELINE group field (UUID, not slug)").option("--subgroup-field <uuid>", "TIMELINE subgroup field (UUID, not slug)").option("--progress-field <uuid>", "TIMELINE progress field (UUID, not slug)").option("--card-title-field <uuid>", "KANBAN/TIMELINE card title field (UUID, not slug)").option("--card-category1-field <uuid>", "KANBAN/TIMELINE card category 1 field (UUID, not slug)").option("--card-category2-field <uuid>", "KANBAN/TIMELINE card category 2 field (UUID, not slug)").option("--card-category3-field <uuid>", "KANBAN card category 3 field (UUID, not slug)").option("--card-category4-field <uuid>", "TIMELINE card category 4 field (UUID, not slug)").option("--card-description-field <uuid>", "KANBAN/TIMELINE card description field (UUID, not slug)").option("--aggregation-method <method>", "KANBAN card aggregation method (e.g. sum)").option("--aggregation-field <uuid>", "KANBAN card aggregation field (UUID, not slug)").option("--view-state <json>", "KANBAN/TIMELINE viewState UI scalars (columnOrder, granularity, sidebarWidth, show* ...)").option("--view-state-file <path>", "read --view-state JSON from a file").option("--hierarchy-label <name>", "HIERARCHY label column name").option("--hierarchy-info <id:name>", "HIERARCHY info column; id is a unique opaque column id you choose (e.g. col_1779975207355_zfndknslw), not the name, and is reused as columnId in mappings (repeatable)", (v, p = []) => [...p, v], []).option("--hierarchy-number <id:name:aggregation>", "HIERARCHY number column; id is a unique opaque column id (e.g. col_1779975207355_zfndknslw), not the name; aggregation SUM|AVERAGE|MINIMUM|MAXIMUM|COUNT|COUNT_DISTINCT (repeatable)", (v, p = []) => [...p, v], []).option("--hierarchy-root-name <name>", "HIERARCHY root level name").option("--hierarchy-root-label-field <uuid>", "HIERARCHY root level label field (UUID, not slug)").option("--hierarchy-root-info <columnId:fieldId>", "HIERARCHY root info mapping; columnId must match a --hierarchy-info id (repeatable)", (v, p = []) => [...p, v], []).option("--hierarchy-root-number <columnId:fieldId>", "HIERARCHY root number mapping; columnId must match a --hierarchy-number id (repeatable)", (v, p = []) => [...p, v], []).option("--hierarchy-child <json>", "HIERARCHY child level JSON {name,schemaId,childFieldId,labelFieldId,infoMappings,numberMappings} (repeatable)", (v, p = []) => [...p, v], []).option("--hierarchy-config <json>", "HIERARCHY full hierarchyConfig JSON (escape hatch)").option("--hierarchy-config-file <path>", "read --hierarchy-config JSON from a file").option("--raw <json>").option("--raw-file <path>").action(async function action(display, commandOptions) {
     const { api, json, readOnly } = createDisplaysApi(this, filePath);
     ensureWritable3("displays widgets create", readOnly, "write");
     const data = await api.createWidget(display, buildWidgetBody(commandOptions));
     if (json) {
-      emitJson4(stdout, "displays widgets create", data);
+      emitJson4(stdout, "displays widgets create", data);
+      return;
+    }
+    writeLine4(stdout, `Created widget on display "${display.value}".`);
+  });
+  widgets.command("update").description("Update widget").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<widget>", "widget id").option("--type <type>").option("--name <name>").option("--description <text>").option("--icon <icon>").option("--color <color>").option("--origin-resource <uuid>").option("--origin-subschema").option("--tab <tabId>").option("--slot <slotId>").option("--layout <json>").option("--layout-file <path>").option("--field <field>", "repeatable field", (v, p = []) => [...p, v], []).option("--sort <sort>", "repeatable sort", (v, p = []) => [...p, v], []).option("--filter <expr>", "repeatable filter", collectFilters, []).option("--widget-read-only").option("--hide-add-button").option("--hide-delete-button").option("--hide-sort-button").option("--hide-filter-button").option("--hide-see-button").option("--calc <type>").option("--calc-field <uuid>").option("--kpi-config <json>").option("--chart-type <type>", "chart type (lines, bars, stackedBars, combined)").option("--x-axis-field <uuid>").option("--x-axis-date-format <granularity>", "time granularity (DATE, MONTH_YEAR, QUARTER_YEAR, YEAR)").option("--x-axis-time-series").option("--y-axis-serie <json>", "repeatable y axis serie", (v, p = []) => [...p, v], []).option("--legend <json>").option("--column-field <uuid>", "KANBAN column field (UUID, not slug)").option("--swimlane-field <uuid>", "KANBAN swimlane field (UUID, not slug)").option("--start-date-field <uuid>", "TIMELINE start date field (UUID, not slug)").option("--end-date-field <uuid>", "TIMELINE end date field (UUID, not slug)").option("--label-field <uuid>", "TIMELINE label field (UUID, not slug)").option("--group-field <uuid>", "TIMELINE group field (UUID, not slug)").option("--subgroup-field <uuid>", "TIMELINE subgroup field (UUID, not slug)").option("--progress-field <uuid>", "TIMELINE progress field (UUID, not slug)").option("--card-title-field <uuid>", "KANBAN/TIMELINE card title field (UUID, not slug)").option("--card-category1-field <uuid>", "KANBAN/TIMELINE card category 1 field (UUID, not slug)").option("--card-category2-field <uuid>", "KANBAN/TIMELINE card category 2 field (UUID, not slug)").option("--card-category3-field <uuid>", "KANBAN card category 3 field (UUID, not slug)").option("--card-category4-field <uuid>", "TIMELINE card category 4 field (UUID, not slug)").option("--card-description-field <uuid>", "KANBAN/TIMELINE card description field (UUID, not slug)").option("--aggregation-method <method>", "KANBAN card aggregation method (e.g. sum)").option("--aggregation-field <uuid>", "KANBAN card aggregation field (UUID, not slug)").option("--view-state <json>", "KANBAN/TIMELINE viewState UI scalars (columnOrder, granularity, sidebarWidth, show* ...)").option("--view-state-file <path>", "read --view-state JSON from a file").option("--hierarchy-label <name>", "HIERARCHY label column name").option("--hierarchy-info <id:name>", "HIERARCHY info column; id is a unique opaque column id you choose (e.g. col_1779975207355_zfndknslw), not the name, and is reused as columnId in mappings (repeatable)", (v, p = []) => [...p, v], []).option("--hierarchy-number <id:name:aggregation>", "HIERARCHY number column; id is a unique opaque column id (e.g. col_1779975207355_zfndknslw), not the name; aggregation SUM|AVERAGE|MINIMUM|MAXIMUM|COUNT|COUNT_DISTINCT (repeatable)", (v, p = []) => [...p, v], []).option("--hierarchy-root-name <name>", "HIERARCHY root level name").option("--hierarchy-root-label-field <uuid>", "HIERARCHY root level label field (UUID, not slug)").option("--hierarchy-root-info <columnId:fieldId>", "HIERARCHY root info mapping; columnId must match a --hierarchy-info id (repeatable)", (v, p = []) => [...p, v], []).option("--hierarchy-root-number <columnId:fieldId>", "HIERARCHY root number mapping; columnId must match a --hierarchy-number id (repeatable)", (v, p = []) => [...p, v], []).option("--hierarchy-child <json>", "HIERARCHY child level JSON {name,schemaId,childFieldId,labelFieldId,infoMappings,numberMappings} (repeatable)", (v, p = []) => [...p, v], []).option("--hierarchy-config <json>", "HIERARCHY full hierarchyConfig JSON (escape hatch)").option("--hierarchy-config-file <path>", "read --hierarchy-config JSON from a file").option("--raw <json>").option("--raw-file <path>").action(async function action(display, widgetId, commandOptions) {
+    const { api, json, readOnly } = createDisplaysApi(this, filePath);
+    ensureWritable3("displays widgets update", readOnly, "write");
+    const data = await api.updateWidget(display, widgetId, buildWidgetBody(commandOptions));
+    if (json) {
+      emitJson4(stdout, "displays widgets update", data);
+      return;
+    }
+    writeLine4(stdout, `Updated widget "${widgetId}".`);
+  });
+  widgets.command("delete").description("Delete widget").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<widget>", "widget id").action(async function action(display, widgetId) {
+    const { api, json, readOnly } = createDisplaysApi(this, filePath);
+    ensureWritable3("displays widgets delete", readOnly, "destructive");
+    const data = await api.deleteWidget(display, widgetId);
+    if (json) {
+      emitJson4(stdout, "displays widgets delete", data);
+      return;
+    }
+    writeLine4(stdout, `Deleted widget "${widgetId}".`);
+  });
+  const targets = displays.command("navigation-targets").description("Manage navigation targets");
+  targets.command("list").description("List navigation targets").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).action(async function action(display) {
+    const { api, json } = createDisplaysApi(this, filePath);
+    const data = await api.getDisplay(display);
+    const items = getDisplaySubresource(data.navigationTargets);
+    if (json) {
+      emitJson4(stdout, "displays navigation-targets list", items);
+      return;
+    }
+    printTable(items, void 0, stdout);
+  });
+  targets.command("create").description("Create navigation target").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).requiredOption("--source-widget <id>").requiredOption("--target-display <id>").requiredOption("--target-variable <id>").option("--label <label>").action(async function action(display, commandOptions) {
+    const { api, json, readOnly } = createDisplaysApi(this, filePath);
+    ensureWritable3("displays navigation-targets create", readOnly, "write");
+    const data = await api.createNavigationTarget(display, buildNavigationTargetBody(commandOptions));
+    if (json) {
+      emitJson4(stdout, "displays navigation-targets create", data);
+      return;
+    }
+    writeLine4(stdout, `Created navigation target on display "${display.value}".`);
+  });
+  targets.command("update").description("Update navigation target").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<target>", "target id").option("--source-widget <id>").option("--target-display <id>").option("--target-variable <id>").option("--label <label>").action(async function action(display, targetId, commandOptions) {
+    const { api, json, readOnly } = createDisplaysApi(this, filePath);
+    ensureWritable3("displays navigation-targets update", readOnly, "write");
+    const data = await api.updateNavigationTarget(display, targetId, buildNavigationTargetBody(commandOptions));
+    if (json) {
+      emitJson4(stdout, "displays navigation-targets update", data);
+      return;
+    }
+    writeLine4(stdout, `Updated navigation target "${targetId}".`);
+  });
+  targets.command("delete").description("Delete navigation target").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<target>", "target id").action(async function action(display, targetId) {
+    const { api, json, readOnly } = createDisplaysApi(this, filePath);
+    ensureWritable3("displays navigation-targets delete", readOnly, "destructive");
+    const data = await api.deleteNavigationTarget(display, targetId);
+    if (json) {
+      emitJson4(stdout, "displays navigation-targets delete", data);
+      return;
+    }
+    writeLine4(stdout, `Deleted navigation target "${targetId}".`);
+  });
+  const cross = displays.command("cross-widget-filter").description("Manage cross widget filter");
+  cross.command("get").description("Get cross widget filter").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).action(async function action(display) {
+    const { api, json } = createDisplaysApi(this, filePath);
+    const data = await api.getDisplay(display);
+    const item = data.crossWidgetFilter ?? null;
+    if (json) {
+      emitJson4(stdout, "displays cross-widget-filter get", item);
+      return;
+    }
+    printTable(item ? [item] : [], void 0, stdout);
+  });
+  cross.command("set").description("Set cross widget filter").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).requiredOption("--source-widget <id>").requiredOption("--source-field <id>").requiredOption("--target <widget:field>", "repeatable target", (v, p = []) => [...p, v], []).action(async function action(display, commandOptions) {
+    const { api, json, readOnly } = createDisplaysApi(this, filePath);
+    ensureWritable3("displays cross-widget-filter set", readOnly, "write");
+    const data = await api.setCrossWidgetFilter(display, buildCrossWidgetFilterBody(commandOptions));
+    if (json) {
+      emitJson4(stdout, "displays cross-widget-filter set", data);
+      return;
+    }
+    writeLine4(stdout, `Updated cross widget filter for display "${display.value}".`);
+  });
+  cross.command("delete").description("Delete cross widget filter").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).action(async function action(display) {
+    const { api, json, readOnly } = createDisplaysApi(this, filePath);
+    ensureWritable3("displays cross-widget-filter delete", readOnly, "destructive");
+    const data = await api.deleteCrossWidgetFilter(display);
+    if (json) {
+      emitJson4(stdout, "displays cross-widget-filter delete", data);
+      return;
+    }
+    writeLine4(stdout, `Deleted cross widget filter for display "${display.value}".`);
+  });
+}
+
+// src/commands/document-templates.ts
+import { readFileSync as readFileSync5, writeFileSync as writeFileSync2 } from "fs";
+import { basename } from "path";
+import { InvalidArgumentError as InvalidArgumentError4 } from "commander";
+
+// src/api/document-templates.ts
+function jsonOptions4(body, method) {
+  return {
+    method,
+    headers: {
+      "content-type": "application/json"
+    },
+    body: JSON.stringify(body)
+  };
+}
+function selectorValue4(selector) {
+  return encodeURIComponent(selector.value);
+}
+function segment3(value) {
+  return encodeURIComponent(value);
+}
+var DocumentTemplatesApi = class {
+  constructor(client) {
+    this.client = client;
+  }
+  listTemplates() {
+    return this.client.getJson("/api/v2/document-templates");
+  }
+  createTemplate(input) {
+    return this.client.requestJson(
+      "/api/v2/document-templates",
+      jsonOptions4(input, "POST")
+    );
+  }
+  updateTemplate(template, input) {
+    return this.client.requestJson(
+      `/api/v2/document-templates/${selectorValue4(template)}`,
+      jsonOptions4(input, "PATCH")
+    );
+  }
+  deleteTemplate(template) {
+    return this.client.requestJson(
+      `/api/v2/document-templates/${selectorValue4(template)}`,
+      { method: "DELETE" }
+    );
+  }
+  addAsset(template, input) {
+    return this.client.requestJson(
+      `/api/v2/document-templates/${selectorValue4(template)}/assets`,
+      { method: "POST", body: input }
+    );
+  }
+  deleteAsset(template, assetId) {
+    return this.client.requestJson(
+      `/api/v2/document-templates/${selectorValue4(template)}/assets/${segment3(assetId)}`,
+      { method: "DELETE" }
+    );
+  }
+  downloadAsset(template, assetId) {
+    return this.client.requestBinary(
+      `/api/v2/document-templates/${selectorValue4(template)}/assets/${segment3(assetId)}/download`
+    );
+  }
+};
+
+// src/commands/document-templates.ts
+function getCommandIo5(stdout) {
+  return stdout ?? process.stdout;
+}
+function writeLine5(stdout, value) {
+  stdout.write(`${value}
+`);
+}
+function writeBinary(stdout, value) {
+  stdout.write(Buffer.from(value));
+}
+function getGlobalOptions5(command) {
+  return command.optsWithGlobals();
+}
+function emitJson5(stdout, commandName, data, configPath, meta = {}) {
+  writeLine5(
+    stdout,
+    JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath, ...meta }))
+  );
+}
+function toConfigurationError5(filePath, error) {
+  if (error instanceof CliError) {
+    throw error;
+  }
+  if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
+    throw new CliError("configuration_error", `Config file not found at ${filePath}.`);
+  }
+  if (error instanceof Error) {
+    throw new CliError("configuration_error", error.message);
+  }
+  throw error;
+}
+function createDocumentTemplatesApi(command, filePath) {
+  try {
+    const config = readRuntimeConfig(filePath);
+    const runtime = resolveRuntimeContext(config, getGlobalOptions5(command));
+    if (!runtime.baseUrl) {
+      throw new CliError(
+        "configuration_error",
+        `Resolved profile "${runtime.profile}" is missing a base URL.`
+      );
+    }
+    return {
+      api: new DocumentTemplatesApi(
+        new ApiClient({
+          baseUrl: runtime.baseUrl,
+          apiKey: runtime.apiKey
+        })
+      ),
+      json: runtime.json,
+      readOnly: runtime.readOnly
+    };
+  } catch (error) {
+    toConfigurationError5(filePath, error);
+  }
+}
+function ensureWritable4(commandName, readOnly, commandMode) {
+  if (readOnly) {
+    throw new CliError(
+      "command_not_allowed_in_read_only_mode",
+      `Command "${commandName}" is not allowed in read-only mode.`,
+      {
+        commandMode,
+        executionMode: "read-only"
+      }
+    );
+  }
+}
+function parseUuidOrSlugSelector4(input) {
+  try {
+    return normalizeUuidOrSlug(input);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Invalid selector.";
+    throw new InvalidArgumentError4(message);
+  }
+}
+function isJsonObject4(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isEmptyObject4(value) {
+  return Object.keys(value).length === 0;
+}
+function parseJsonValue2(input, sourceLabel) {
+  try {
+    return JSON.parse(input);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Invalid JSON.";
+    throw new CliError(
+      "invalid_cli_usage",
+      `Failed to parse JSON from ${sourceLabel}: ${message}`
+    );
+  }
+}
+function readTextFile2(filePath, label) {
+  try {
+    return readFileSync5(filePath, "utf8");
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unable to read file.";
+    throw new CliError(
+      "invalid_cli_usage",
+      `Failed to read ${label} from ${filePath}: ${message}`
+    );
+  }
+}
+function readJsonObjectOption2(raw, rawFile, rawLabel, rawFileLabel) {
+  if (raw && rawFile) {
+    throw new CliError(
+      "invalid_cli_usage",
+      `Provide either "${rawLabel}" or "${rawFileLabel}", not both.`
+    );
+  }
+  let parsed;
+  if (raw) {
+    parsed = parseJsonValue2(raw, rawLabel);
+  } else if (rawFile) {
+    parsed = parseJsonValue2(readTextFile2(rawFile, rawFileLabel), `${rawFileLabel} ${rawFile}`);
+  } else {
+    return {};
+  }
+  if (!isJsonObject4(parsed)) {
+    throw new CliError(
+      "invalid_cli_usage",
+      `Expected ${raw ? rawLabel : rawFileLabel} to contain a JSON object.`
+    );
+  }
+  return parsed;
+}
+function readLocalFile(filePath) {
+  try {
+    return readFileSync5(filePath);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unable to read file.";
+    throw new CliError("invalid_cli_usage", `Failed to read file at ${filePath}: ${message}`);
+  }
+}
+function writeDownloadedFile(outputPath, value) {
+  try {
+    writeFileSync2(outputPath, Buffer.from(value));
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unable to write file.";
+    throw new CliError(
+      "invalid_cli_usage",
+      `Failed to write downloaded file to ${outputPath}: ${message}`
+    );
+  }
+}
+function templateRows(templates) {
+  return templates.map((template) => ({
+    id: template.id ?? "",
+    name: template.name ?? "",
+    assetCount: Array.isArray(template.assets) ? template.assets.length : 0,
+    updatedAt: template.updatedAt ?? ""
+  }));
+}
+function resolveTemplate(templates, selector) {
+  if (selector.kind === "uuid") {
+    const match = templates.find((template) => template.id === selector.value);
+    if (match) {
+      return match;
+    }
+    throw new CliError(
+      "invalid_cli_usage",
+      `Document template "${selector.value}" was not found.`
+    );
+  }
+  const matches = templates.filter((template) => template.name === selector.value);
+  if (matches.length === 1) {
+    return matches[0];
+  }
+  if (matches.length > 1) {
+    throw new CliError(
+      "invalid_cli_usage",
+      `Document template "${selector.value}" is ambiguous. Found ${matches.length} matches.`
+    );
+  }
+  throw new CliError(
+    "invalid_cli_usage",
+    `Document template "${selector.value}" was not found.`
+  );
+}
+async function resolveTemplateSelector(api, selector) {
+  if (selector.kind === "uuid") {
+    return selector;
+  }
+  const templates = await api.listTemplates();
+  const resolved = resolveTemplate(templates, selector);
+  if (typeof resolved.id !== "string" || resolved.id.length === 0) {
+    throw new CliError(
+      "invalid_cli_usage",
+      `Document template "${selector.value}" is missing an id in the API response.`
+    );
+  }
+  return { kind: "uuid", value: resolved.id };
+}
+function buildCreateInput(options) {
+  const raw = readJsonObjectOption2(options.raw, options.rawFile, "--raw", "--raw-file");
+  const input = { ...raw };
+  if (options.name !== void 0) {
+    input.name = options.name;
+  }
+  if (typeof input.name !== "string" || input.name.trim().length === 0) {
+    throw new CliError("invalid_cli_usage", 'Provide template name via "--name".');
+  }
+  if (input.assets === void 0) {
+    input.assets = [];
+  }
+  return input;
+}
+function buildUpdateInput(options) {
+  const input = {};
+  if (options.name !== void 0) {
+    input.name = options.name;
+  }
+  if (isEmptyObject4(input)) {
+    throw new CliError("invalid_cli_usage", 'Provide template updates via "--name".');
+  }
+  return input;
+}
+function registerDocumentTemplatesCommands(program, options = {}) {
+  const filePath = options.configPath ?? defaultConfigPath;
+  const stdout = getCommandIo5(options.stdout);
+  const templates = program.command("document-templates").description("Manage document templates and their assets");
+  templates.command("list").description("List document templates").action(async function action() {
+    const { api, json } = createDocumentTemplatesApi(this, filePath);
+    const data = await api.listTemplates();
+    if (json) {
+      emitJson5(stdout, "document-templates list", data, filePath);
       return;
     }
-    writeLine4(stdout, `Created widget on display "${display.value}".`);
+    printTable(templateRows(data), ["id", "name", "assetCount", "updatedAt"], stdout);
   });
-  widgets.command("update").description("Update widget").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<widget>", "widget id").option("--type <type>").option("--name <name>").option("--description <text>").option("--icon <icon>").option("--color <color>").option("--origin-resource <uuid>").option("--origin-subschema").option("--tab <tabId>").option("--slot <slotId>").option("--layout <json>").option("--layout-file <path>").option("--field <field>", "repeatable field", (v, p = []) => [...p, v], []).option("--sort <sort>", "repeatable sort", (v, p = []) => [...p, v], []).option("--filter <expr>", "repeatable filter", (v, p = []) => [...p, v], []).option("--widget-read-only").option("--hide-add-button").option("--hide-delete-button").option("--hide-sort-button").option("--hide-filter-button").option("--hide-see-button").option("--calc <type>").option("--calc-field <uuid>").option("--kpi-config <json>").option("--chart-type <type>").option("--x-axis-field <uuid>").option("--x-axis-date-format <granularity>").option("--x-axis-time-series").option("--y-axis-serie <json>", "repeatable y axis serie", (v, p = []) => [...p, v], []).option("--legend <json>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, widgetId, commandOptions) {
-    const { api, json, readOnly } = createDisplaysApi(this, filePath);
-    ensureWritable3("displays widgets update", readOnly, "write");
-    const data = await api.updateWidget(display, widgetId, buildWidgetBody(commandOptions));
+  templates.command("get").description("Get a document template by UUID or exact name").argument("<template>", "template UUID or exact name", parseUuidOrSlugSelector4).action(async function action(template) {
+    const { api, json } = createDocumentTemplatesApi(this, filePath);
+    const list = await api.listTemplates();
+    const data = resolveTemplate(list, template);
     if (json) {
-      emitJson4(stdout, "displays widgets update", data);
+      emitJson5(stdout, "document-templates get", data, filePath);
       return;
     }
-    writeLine4(stdout, `Updated widget "${widgetId}".`);
+    printTable([data], void 0, stdout);
   });
-  widgets.command("delete").description("Delete widget").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<widget>", "widget id").action(async function action(display, widgetId) {
-    const { api, json, readOnly } = createDisplaysApi(this, filePath);
-    ensureWritable3("displays widgets delete", readOnly, "destructive");
-    const data = await api.deleteWidget(display, widgetId);
+  templates.command("create").description("Create a document template").option("--name <name>", "template name").option("--raw <json>", "raw create JSON payload").option("--raw-file <path>", "path to raw create JSON payload").action(async function action(commandOptions) {
+    const { api, json, readOnly } = createDocumentTemplatesApi(this, filePath);
+    ensureWritable4("document-templates create", readOnly, "write");
+    const data = await api.createTemplate(buildCreateInput(commandOptions));
     if (json) {
-      emitJson4(stdout, "displays widgets delete", data);
+      emitJson5(stdout, "document-templates create", data, filePath);
       return;
     }
-    writeLine4(stdout, `Deleted widget "${widgetId}".`);
+    writeLine5(stdout, `Created document template "${String(data.name ?? commandOptions.name)}".`);
   });
-  const targets = displays.command("navigation-targets").description("Manage navigation targets");
-  targets.command("list").description("List navigation targets").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).action(async function action(display) {
-    const { api, json } = createDisplaysApi(this, filePath);
-    const data = await api.getDisplay(display);
-    const items = getDisplaySubresource(data.navigationTargets);
+  templates.command("update").description("Rename a document template").argument("<template>", "template UUID or exact name", parseUuidOrSlugSelector4).option("--name <name>", "new template name").action(async function action(template, commandOptions) {
+    const { api, json, readOnly } = createDocumentTemplatesApi(this, filePath);
+    ensureWritable4("document-templates update", readOnly, "write");
+    const resolved = await resolveTemplateSelector(api, template);
+    const data = await api.updateTemplate(resolved, buildUpdateInput(commandOptions));
     if (json) {
-      emitJson4(stdout, "displays navigation-targets list", items);
+      emitJson5(stdout, "document-templates update", data, filePath);
       return;
     }
-    printTable(items, void 0, stdout);
+    writeLine5(stdout, `Updated document template "${String(data.name ?? template.value)}".`);
   });
-  targets.command("create").description("Create navigation target").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).requiredOption("--source-widget <id>").requiredOption("--target-display <id>").requiredOption("--target-variable <id>").option("--label <label>").action(async function action(display, commandOptions) {
-    const { api, json, readOnly } = createDisplaysApi(this, filePath);
-    ensureWritable3("displays navigation-targets create", readOnly, "write");
-    const data = await api.createNavigationTarget(display, buildNavigationTargetBody(commandOptions));
+  templates.command("delete").description("Delete a document template (and its assets)").argument("<template>", "template UUID or exact name", parseUuidOrSlugSelector4).action(async function action(template) {
+    const { api, json, readOnly } = createDocumentTemplatesApi(this, filePath);
+    ensureWritable4("document-templates delete", readOnly, "destructive");
+    const resolved = await resolveTemplateSelector(api, template);
+    const data = await api.deleteTemplate(resolved);
     if (json) {
-      emitJson4(stdout, "displays navigation-targets create", data);
+      emitJson5(stdout, "document-templates delete", data, filePath);
       return;
     }
-    writeLine4(stdout, `Created navigation target on display "${display.value}".`);
+    writeLine5(stdout, `Deleted document template "${template.value}".`);
   });
-  targets.command("update").description("Update navigation target").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<target>", "target id").option("--source-widget <id>").option("--target-display <id>").option("--target-variable <id>").option("--label <label>").action(async function action(display, targetId, commandOptions) {
-    const { api, json, readOnly } = createDisplaysApi(this, filePath);
-    ensureWritable3("displays navigation-targets update", readOnly, "write");
-    const data = await api.updateNavigationTarget(display, targetId, buildNavigationTargetBody(commandOptions));
-    if (json) {
-      emitJson4(stdout, "displays navigation-targets update", data);
-      return;
+  const assets = templates.command("assets").description("Manage document template assets");
+  assets.command("add").description("Upload an asset file to a document template").argument("<template>", "template UUID or exact name", parseUuidOrSlugSelector4).argument("<path>", "path to the local file").option("--name <name>", "override the asset display name").action(async function action(template, localPath, commandOptions) {
+    const { api, json, readOnly } = createDocumentTemplatesApi(this, filePath);
+    ensureWritable4("document-templates assets add", readOnly, "write");
+    const contents = readLocalFile(localPath);
+    const formData = new FormData();
+    formData.append("file", new Blob([contents]), basename(localPath));
+    if (commandOptions.name !== void 0) {
+      formData.append("name", commandOptions.name);
     }
-    writeLine4(stdout, `Updated navigation target "${targetId}".`);
-  });
-  targets.command("delete").description("Delete navigation target").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<target>", "target id").action(async function action(display, targetId) {
-    const { api, json, readOnly } = createDisplaysApi(this, filePath);
-    ensureWritable3("displays navigation-targets delete", readOnly, "destructive");
-    const data = await api.deleteNavigationTarget(display, targetId);
+    const resolved = await resolveTemplateSelector(api, template);
+    const data = await api.addAsset(resolved, formData);
     if (json) {
-      emitJson4(stdout, "displays navigation-targets delete", data);
+      emitJson5(stdout, "document-templates assets add", data, filePath);
       return;
     }
-    writeLine4(stdout, `Deleted navigation target "${targetId}".`);
+    writeLine5(
+      stdout,
+      `Added asset "${commandOptions.name ?? basename(localPath)}" to template "${template.value}".`
+    );
   });
-  const cross = displays.command("cross-widget-filter").description("Manage cross widget filter");
-  cross.command("get").description("Get cross widget filter").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).action(async function action(display) {
-    const { api, json } = createDisplaysApi(this, filePath);
-    const data = await api.getDisplay(display);
-    const item = data.crossWidgetFilter ?? null;
+  assets.command("delete").description("Delete one asset from a document template").argument("<template>", "template UUID or exact name", parseUuidOrSlugSelector4).argument("<asset>", "asset UUID").action(async function action(template, assetId) {
+    const { api, json, readOnly } = createDocumentTemplatesApi(this, filePath);
+    ensureWritable4("document-templates assets delete", readOnly, "destructive");
+    const resolved = await resolveTemplateSelector(api, template);
+    const data = await api.deleteAsset(resolved, assetId);
     if (json) {
-      emitJson4(stdout, "displays cross-widget-filter get", item);
+      emitJson5(stdout, "document-templates assets delete", data, filePath);
       return;
     }
-    printTable(item ? [item] : [], void 0, stdout);
+    writeLine5(stdout, `Deleted asset "${assetId}" from template "${template.value}".`);
   });
-  cross.command("set").description("Set cross widget filter").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).requiredOption("--source-widget <id>").requiredOption("--source-field <id>").requiredOption("--target <widget:field>", "repeatable target", (v, p = []) => [...p, v], []).action(async function action(display, commandOptions) {
-    const { api, json, readOnly } = createDisplaysApi(this, filePath);
-    ensureWritable3("displays cross-widget-filter set", readOnly, "write");
-    const data = await api.setCrossWidgetFilter(display, buildCrossWidgetFilterBody(commandOptions));
-    if (json) {
-      emitJson4(stdout, "displays cross-widget-filter set", data);
-      return;
+  assets.command("download").description("Download the raw bytes of a document template asset").argument("<template>", "template UUID or exact name", parseUuidOrSlugSelector4).argument("<asset>", "asset UUID").option("--output <path>", "write the downloaded bytes to a path").action(async function action(template, assetId, commandOptions) {
+    const { api, json } = createDocumentTemplatesApi(this, filePath);
+    if (json && !commandOptions.output) {
+      throw new CliError(
+        "invalid_cli_usage",
+        'Provide "--output" when using "--json" with "document-templates assets download".'
+      );
     }
-    writeLine4(stdout, `Updated cross widget filter for display "${display.value}".`);
-  });
-  cross.command("delete").description("Delete cross widget filter").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).action(async function action(display) {
-    const { api, json, readOnly } = createDisplaysApi(this, filePath);
-    ensureWritable3("displays cross-widget-filter delete", readOnly, "destructive");
-    const data = await api.deleteCrossWidgetFilter(display);
-    if (json) {
-      emitJson4(stdout, "displays cross-widget-filter delete", data);
+    const resolved = await resolveTemplateSelector(api, template);
+    const data = await api.downloadAsset(resolved, assetId);
+    if (commandOptions.output) {
+      writeDownloadedFile(commandOptions.output, data);
+      if (json) {
+        emitJson5(
+          stdout,
+          "document-templates assets download",
+          {
+            template: resolved.value,
+            asset: assetId,
+            output: commandOptions.output,
+            bytes: data.byteLength
+          },
+          filePath
+        );
+        return;
+      }
+      writeLine5(stdout, `Downloaded asset to "${commandOptions.output}".`);
       return;
     }
-    writeLine4(stdout, `Deleted cross widget filter for display "${display.value}".`);
+    writeBinary(stdout, data);
   });
 }
 
 // src/commands/files.ts
-import { readFileSync as readFileSync5, writeFileSync as writeFileSync2 } from "fs";
-import { basename } from "path";
-import { InvalidArgumentError as InvalidArgumentError4 } from "commander";
+import { readFileSync as readFileSync6, writeFileSync as writeFileSync3 } from "fs";
+import { basename as basename2 } from "path";
+import { InvalidArgumentError as InvalidArgumentError5 } from "commander";
 
 // src/api/files.ts
-function selectorValue4(selector) {
+function selectorValue5(selector) {
   return selector.value;
 }
 var FilesApi = class {
@@ -8462,11 +10033,11 @@ var FilesApi = class {
     });
   }
   downloadFile(file) {
-    return this.client.requestBinary(`/api/v2/files/${selectorValue4(file)}`);
+    return this.client.requestBinary(`/api/v2/files/${selectorValue5(file)}`);
   }
   deleteFile(file) {
     return this.client.requestJson(
-      `/api/v2/files/${selectorValue4(file)}`,
+      `/api/v2/files/${selectorValue5(file)}`,
       { method: "DELETE" }
     );
   }
@@ -8476,26 +10047,26 @@ var FilesApi = class {
 };
 
 // src/commands/files.ts
-function getCommandIo5(stdout) {
+function getCommandIo6(stdout) {
   return stdout ?? process.stdout;
 }
-function writeLine5(stdout, value) {
+function writeLine6(stdout, value) {
   stdout.write(`${value}
 `);
 }
-function writeBinary(stdout, value) {
+function writeBinary2(stdout, value) {
   stdout.write(Buffer.from(value));
 }
-function getGlobalOptions5(command) {
+function getGlobalOptions6(command) {
   return command.optsWithGlobals();
 }
-function emitJson5(stdout, commandName, data, configPath, meta = {}) {
-  writeLine5(
+function emitJson6(stdout, commandName, data, configPath, meta = {}) {
+  writeLine6(
     stdout,
     JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath, ...meta }))
   );
 }
-function toConfigurationError5(filePath, error) {
+function toConfigurationError6(filePath, error) {
   if (error instanceof CliError) {
     throw error;
   }
@@ -8510,7 +10081,7 @@ function toConfigurationError5(filePath, error) {
 function createFilesApi(command, filePath) {
   try {
     const config = readRuntimeConfig(filePath);
-    const runtime = resolveRuntimeContext(config, getGlobalOptions5(command));
+    const runtime = resolveRuntimeContext(config, getGlobalOptions6(command));
     if (!runtime.baseUrl) {
       throw new CliError(
         "configuration_error",
@@ -8528,10 +10099,10 @@ function createFilesApi(command, filePath) {
       readOnly: runtime.readOnly
     };
   } catch (error) {
-    toConfigurationError5(filePath, error);
+    toConfigurationError6(filePath, error);
   }
 }
-function ensureWritable4(commandName, readOnly, commandMode) {
+function ensureWritable5(commandName, readOnly, commandMode) {
   if (readOnly) {
     throw new CliError(
       "command_not_allowed_in_read_only_mode",
@@ -8543,28 +10114,28 @@ function ensureWritable4(commandName, readOnly, commandMode) {
     );
   }
 }
-function parseUuidOrSlugSelector4(input) {
+function parseUuidOrSlugSelector5(input) {
   try {
     return normalizeUuidOrSlug(input);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Invalid selector.";
-    throw new InvalidArgumentError4(message);
+    throw new InvalidArgumentError5(message);
   }
 }
 function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function readLocalFile(filePath) {
+function readLocalFile2(filePath) {
   try {
-    return readFileSync5(filePath);
+    return readFileSync6(filePath);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Unable to read file.";
     throw new CliError("invalid_cli_usage", `Failed to read file at ${filePath}: ${message}`);
   }
 }
-function writeDownloadedFile(outputPath, value) {
+function writeDownloadedFile2(outputPath, value) {
   try {
-    writeFileSync2(outputPath, Buffer.from(value));
+    writeFileSync3(outputPath, Buffer.from(value));
   } catch (error) {
     const message = error instanceof Error ? error.message : "Unable to write file.";
     throw new CliError(
@@ -8575,20 +10146,20 @@ function writeDownloadedFile(outputPath, value) {
 }
 function registerFilesCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
-  const stdout = getCommandIo5(options.stdout);
+  const stdout = getCommandIo6(options.stdout);
   const files = program.command("files").description("Manage files and storage");
   files.command("upload").description("Upload a local file").argument("<path>", "path to the local file").action(function action(path) {
     const { api, json, readOnly } = createFilesApi(this, filePath);
-    ensureWritable4("files upload", readOnly, "write");
-    const contents = readLocalFile(path);
+    ensureWritable5("files upload", readOnly, "write");
+    const contents = readLocalFile2(path);
     const formData = new FormData();
-    formData.append("file", new Blob([contents]), basename(path));
+    formData.append("file", new Blob([contents]), basename2(path));
     return api.uploadFile(formData).then((data) => {
       if (json) {
-        emitJson5(stdout, "files upload", data, filePath);
+        emitJson6(stdout, "files upload", data, filePath);
         return;
       }
-      writeLine5(stdout, `Uploaded file "${basename(path)}".`);
+      writeLine6(stdout, `Uploaded file "${basename2(path)}".`);
     });
   });
   files.command("download").description("Download a file").argument("<file>", "file identifier").option("--output <path>", "write the downloaded file to a path").action(function action(file, commandOptions) {
@@ -8599,12 +10170,12 @@ function registerFilesCommands(program, options = {}) {
         'Provide "--output" when using "--json" with "files download".'
       );
     }
-    const fileSelector = parseUuidOrSlugSelector4(file);
+    const fileSelector = parseUuidOrSlugSelector5(file);
     return api.downloadFile(fileSelector).then((data) => {
       if (commandOptions.output) {
-        writeDownloadedFile(commandOptions.output, data);
+        writeDownloadedFile2(commandOptions.output, data);
         if (json) {
-          emitJson5(
+          emitJson6(
             stdout,
             "files download",
             {
@@ -8616,45 +10187,45 @@ function registerFilesCommands(program, options = {}) {
           );
           return;
         }
-        writeLine5(stdout, `Downloaded file to "${commandOptions.output}".`);
+        writeLine6(stdout, `Downloaded file to "${commandOptions.output}".`);
         return;
       }
-      writeBinary(stdout, data);
+      writeBinary2(stdout, data);
     });
   });
   files.command("delete").description("Delete a file").argument("<file>", "file identifier").action(function action(file) {
     const { api, json, readOnly } = createFilesApi(this, filePath);
-    ensureWritable4("files delete", readOnly, "destructive");
-    const fileSelector = parseUuidOrSlugSelector4(file);
+    ensureWritable5("files delete", readOnly, "destructive");
+    const fileSelector = parseUuidOrSlugSelector5(file);
     return api.deleteFile(fileSelector).then((data) => {
       if (json) {
-        emitJson5(stdout, "files delete", data, filePath);
+        emitJson6(stdout, "files delete", data, filePath);
         return;
       }
-      writeLine5(stdout, `Deleted file "${fileSelector.value}".`);
+      writeLine6(stdout, `Deleted file "${fileSelector.value}".`);
     });
   });
   files.command("storage").description("Show storage usage information").action(function action() {
     const { api, json } = createFilesApi(this, filePath);
     return api.getStorageInfo().then((data) => {
       if (json) {
-        emitJson5(stdout, "files storage", data, filePath);
+        emitJson6(stdout, "files storage", data, filePath);
         return;
       }
       if (isRecord3(data)) {
         printTable([data], Object.keys(data), stdout);
         return;
       }
-      writeLine5(stdout, String(data));
+      writeLine6(stdout, String(data));
     });
   });
 }
 
 // src/commands/logs.ts
-import { InvalidArgumentError as InvalidArgumentError5 } from "commander";
+import { InvalidArgumentError as InvalidArgumentError6 } from "commander";
 
 // src/api/logs.ts
-function selectorValue5(selector) {
+function selectorValue6(selector) {
   return selector.value;
 }
 var LogsApi = class {
@@ -8663,29 +10234,29 @@ var LogsApi = class {
   }
   listLogs(schema, recordId) {
     return this.client.getJson(
-      `/api/v2/schemas/${selectorValue5(schema)}/records/${recordId}/logs`
+      `/api/v2/schemas/${selectorValue6(schema)}/records/${recordId}/logs`
     );
   }
 };
 
 // src/commands/logs.ts
-function getCommandIo6(stdout) {
+function getCommandIo7(stdout) {
   return stdout ?? process.stdout;
 }
-function writeLine6(stdout, value) {
+function writeLine7(stdout, value) {
   stdout.write(`${value}
 `);
 }
-function getGlobalOptions6(command) {
+function getGlobalOptions7(command) {
   return command.optsWithGlobals();
 }
-function emitJson6(stdout, commandName, data, ..._extra) {
-  writeLine6(
+function emitJson7(stdout, commandName, data, ..._extra) {
+  writeLine7(
     stdout,
     JSON.stringify(buildJsonSuccess(data, { command: commandName }))
   );
 }
-function toConfigurationError6(filePath, error) {
+function toConfigurationError7(filePath, error) {
   if (error instanceof CliError) {
     throw error;
   }
@@ -8700,7 +10271,7 @@ function toConfigurationError6(filePath, error) {
 function createLogsApi(command, filePath) {
   try {
     const config = readRuntimeConfig(filePath);
-    const runtime = resolveRuntimeContext(config, getGlobalOptions6(command));
+    const runtime = resolveRuntimeContext(config, getGlobalOptions7(command));
     if (!runtime.baseUrl) {
       throw new CliError(
         "configuration_error",
@@ -8717,25 +10288,25 @@ function createLogsApi(command, filePath) {
       json: runtime.json
     };
   } catch (error) {
-    toConfigurationError6(filePath, error);
+    toConfigurationError7(filePath, error);
   }
 }
-function parseUuidOrSlugSelector5(input) {
+function parseUuidOrSlugSelector6(input) {
   try {
     return normalizeUuidOrSlug(input);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Invalid selector.";
-    throw new InvalidArgumentError5(message);
+    throw new InvalidArgumentError6(message);
   }
 }
-function isJsonObject4(value) {
+function isJsonObject5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function toTableRows3(data) {
   if (Array.isArray(data)) {
-    return data.map((entry) => isJsonObject4(entry) ? entry : { value: entry });
+    return data.map((entry) => isJsonObject5(entry) ? entry : { value: entry });
   }
-  if (isJsonObject4(data)) {
+  if (isJsonObject5(data)) {
     return [data];
   }
   return [{ value: data }];
@@ -8745,13 +10316,13 @@ function emitTable3(stdout, data) {
 }
 function registerLogsCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
-  const stdout = getCommandIo6(options.stdout);
+  const stdout = getCommandIo7(options.stdout);
   const logs = program.command("logs").description("Inspect record change logs");
-  logs.command("list").description("List change logs for a record").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector5).argument("<record>", "record uuid or slug", parseUuidOrSlugSelector5).action(async function action(schema, record) {
+  logs.command("list").description("List change logs for a record").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector6).argument("<record>", "record uuid or slug", parseUuidOrSlugSelector6).action(async function action(schema, record) {
     const { api, json } = createLogsApi(this, filePath);
     const data = await api.listLogs(schema, record.value);
     if (json) {
-      emitJson6(stdout, "logs list", data, filePath);
+      emitJson7(stdout, "logs list", data, filePath);
       return;
     }
     emitTable3(stdout, data);
@@ -8759,11 +10330,11 @@ function registerLogsCommands(program, options = {}) {
 }
 
 // src/commands/navigation.ts
-import { readFileSync as readFileSync6 } from "fs";
-import { InvalidArgumentError as InvalidArgumentError6 } from "commander";
+import { readFileSync as readFileSync7 } from "fs";
+import { InvalidArgumentError as InvalidArgumentError7 } from "commander";
 
 // src/api/navigation.ts
-function jsonOptions4(body, method) {
+function jsonOptions5(body, method) {
   return {
     method,
     headers: {
@@ -8772,7 +10343,7 @@ function jsonOptions4(body, method) {
     body: JSON.stringify(body)
   };
 }
-function selectorValue6(selector) {
+function selectorValue7(selector) {
   return selector.value;
 }
 var NavigationApi = class {
@@ -8785,44 +10356,44 @@ var NavigationApi = class {
   createFolder(body) {
     return this.client.requestJson(
       "/api/v2/navigation/folders",
-      jsonOptions4(body, "POST")
+      jsonOptions5(body, "POST")
     );
   }
   updateFolder(folder, body) {
     return this.client.requestJson(
-      `/api/v2/navigation/folders/${selectorValue6(folder)}`,
-      jsonOptions4(body, "PATCH")
+      `/api/v2/navigation/folders/${selectorValue7(folder)}`,
+      jsonOptions5(body, "PATCH")
     );
   }
   deleteFolder(folder) {
     return this.client.requestJson(
-      `/api/v2/navigation/folders/${selectorValue6(folder)}`,
+      `/api/v2/navigation/folders/${selectorValue7(folder)}`,
       { method: "DELETE" }
     );
   }
   moveResource(body) {
     return this.client.requestJson(
       "/api/v2/navigation/resources:move",
-      jsonOptions4(body, "POST")
+      jsonOptions5(body, "POST")
     );
   }
 };
 
 // src/commands/navigation.ts
-function getCommandIo7(stdout) {
+function getCommandIo8(stdout) {
   return stdout ?? process.stdout;
 }
-function writeLine7(stdout, value) {
+function writeLine8(stdout, value) {
   stdout.write(`${value}
 `);
 }
-function getGlobalOptions7(command) {
+function getGlobalOptions8(command) {
   return command.optsWithGlobals();
 }
-function emitJson7(stdout, commandName, data, configPath) {
-  writeLine7(stdout, JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath })));
+function emitJson8(stdout, commandName, data, configPath) {
+  writeLine8(stdout, JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath })));
 }
-function toConfigurationError7(filePath, error) {
+function toConfigurationError8(filePath, error) {
   if (error instanceof CliError) {
     throw error;
   }
@@ -8837,7 +10408,7 @@ function toConfigurationError7(filePath, error) {
 function createNavigationApi(command, filePath) {
   try {
     const config = readRuntimeConfig(filePath);
-    const runtime = resolveRuntimeContext(config, getGlobalOptions7(command));
+    const runtime = resolveRuntimeContext(config, getGlobalOptions8(command));
     if (!runtime.baseUrl) {
       throw new CliError("configuration_error", `Resolved profile "${runtime.profile}" is missing a base URL.`);
     }
@@ -8852,10 +10423,10 @@ function createNavigationApi(command, filePath) {
       readOnly: runtime.readOnly
     };
   } catch (error) {
-    toConfigurationError7(filePath, error);
+    toConfigurationError8(filePath, error);
   }
 }
-function ensureWritable5(commandName, readOnly, mode) {
+function ensureWritable6(commandName, readOnly, mode) {
   if (readOnly) {
     throw new CliError(
       "command_not_allowed_in_read_only_mode",
@@ -8864,12 +10435,12 @@ function ensureWritable5(commandName, readOnly, mode) {
     );
   }
 }
-function parseUuidOrSlugSelector6(input) {
+function parseUuidOrSlugSelector7(input) {
   try {
     return normalizeUuidOrSlug(input);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Invalid selector.";
-    throw new InvalidArgumentError6(message);
+    throw new InvalidArgumentError7(message);
   }
 }
 function parseInteger(value, flagName) {
@@ -8886,7 +10457,7 @@ function readJsonObject(raw, rawFile) {
   if (raw && rawFile) {
     throw new CliError("invalid_cli_usage", 'Use either "--props" or "--props-file", not both.');
   }
-  const source = rawFile ? readFileSync6(rawFile, "utf8") : raw;
+  const source = rawFile ? readFileSync7(rawFile, "utf8") : raw;
   if (!source) {
     return {};
   }
@@ -8948,41 +10519,41 @@ function folderRows2(folders) {
 }
 function registerNavigationCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
-  const stdout = getCommandIo7(options.stdout);
+  const stdout = getCommandIo8(options.stdout);
   const navigation = program.command("navigation").description("Manage workspace navigation");
   const folders = navigation.command("folders").description("Manage navigation folders");
   folders.command("list").description("List navigation folders").action(async function action() {
     const { api, json } = createNavigationApi(this, filePath);
     const data = await api.listFolders();
     if (json) {
-      emitJson7(stdout, "navigation folders list", data, filePath);
+      emitJson8(stdout, "navigation folders list", data, filePath);
       return;
     }
     printTable(folderRows2(data), ["id", "order", "name", "resourceCount"], stdout);
   });
-  folders.command("get").description("Get a navigation folder by UUID or exact name").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector6).action(async function action(folder) {
+  folders.command("get").description("Get a navigation folder by UUID or exact name").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector7).action(async function action(folder) {
     const { api, json } = createNavigationApi(this, filePath);
     const data = await api.listFolders();
     const resolved = resolveFolder2(data, folder);
     if (json) {
-      emitJson7(stdout, "navigation folders get", resolved, filePath);
+      emitJson8(stdout, "navigation folders get", resolved, filePath);
       return;
     }
     printTable(folderRows2([resolved]), ["id", "order", "name", "resourceCount"], stdout);
   });
-  folders.command("create").description("Create a navigation folder").requiredOption("--name <name>", "folder name").option("--order <n>", "folder order").option("--props <json>", "folder additionalProperties JSON").option("--props-file <path>", "folder additionalProperties JSON file").action(async function action(commandOptions) {
+  folders.command("create").description("Create a navigation folder").requiredOption("--name <name>", "folder name").option("--order <n>", "display order (lower values appear first)").option("--props <json>", 'additionalProperties JSON: free-form client metadata, e.g. {"color":"blue","icon":"chart-line"}').option("--props-file <path>", "path to a file with the additionalProperties JSON").action(async function action(commandOptions) {
     const { api, json, readOnly } = createNavigationApi(this, filePath);
-    ensureWritable5("navigation folders create", readOnly, "write");
+    ensureWritable6("navigation folders create", readOnly, "write");
     const data = await api.createFolder(buildFolderBody(commandOptions));
     if (json) {
-      emitJson7(stdout, "navigation folders create", data, filePath);
+      emitJson8(stdout, "navigation folders create", data, filePath);
       return;
     }
-    writeLine7(stdout, `Created navigation folder "${String(data.name ?? commandOptions.name)}".`);
+    writeLine8(stdout, `Created navigation folder "${String(data.name ?? commandOptions.name)}".`);
   });
-  folders.command("update").description("Update a navigation folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector6).option("--name <name>", "folder name").option("--order <n>", "folder order").option("--props <json>", "folder additionalProperties JSON").option("--props-file <path>", "folder additionalProperties JSON file").action(async function action(folder, commandOptions) {
+  folders.command("update").description("Update a navigation folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector7).option("--name <name>", "folder name").option("--order <n>", "display order (lower values appear first)").option("--props <json>", 'additionalProperties JSON: free-form client metadata, e.g. {"color":"blue","icon":"chart-line"}').option("--props-file <path>", "path to a file with the additionalProperties JSON").action(async function action(folder, commandOptions) {
     const { api, json, readOnly } = createNavigationApi(this, filePath);
-    ensureWritable5("navigation folders update", readOnly, "write");
+    ensureWritable6("navigation folders update", readOnly, "write");
     const allFolders = await api.listFolders();
     const resolved = resolveFolder2(allFolders, folder);
     const body = buildFolderBody(commandOptions);
@@ -8991,54 +10562,55 @@ function registerNavigationCommands(program, options = {}) {
     }
     const data = await api.updateFolder({ kind: "uuid", value: resolved.id }, body);
     if (json) {
-      emitJson7(stdout, "navigation folders update", data, filePath);
+      emitJson8(stdout, "navigation folders update", data, filePath);
       return;
     }
-    writeLine7(stdout, `Updated navigation folder "${String(data.name ?? resolved.name ?? resolved.id)}".`);
+    writeLine8(stdout, `Updated navigation folder "${String(data.name ?? resolved.name ?? resolved.id)}".`);
   });
-  folders.command("delete").description("Delete a navigation folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector6).action(async function action(folder) {
+  folders.command("delete").description("Delete a navigation folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector7).action(async function action(folder) {
     const { api, json, readOnly } = createNavigationApi(this, filePath);
-    ensureWritable5("navigation folders delete", readOnly, "destructive");
+    ensureWritable6("navigation folders delete", readOnly, "destructive");
     const allFolders = await api.listFolders();
     const resolved = resolveFolder2(allFolders, folder);
     const data = await api.deleteFolder({ kind: "uuid", value: resolved.id });
     if (json) {
-      emitJson7(stdout, "navigation folders delete", data, filePath);
+      emitJson8(stdout, "navigation folders delete", data, filePath);
       return;
     }
-    writeLine7(stdout, `Deleted navigation folder "${resolved.name ?? resolved.id}".`);
+    writeLine8(stdout, `Deleted navigation folder "${resolved.name ?? resolved.id}".`);
   });
-  navigation.command("resources").description("Manage navigation resources").command("move").description("Move a resource into a folder").argument("<resource>", "resource UUID").requiredOption("--type <type>", "resource type").requiredOption("--to <folder>", "target folder UUID or exact name").action(async function action(resourceId, commandOptions) {
+  navigation.command("resources").description("Manage navigation resources").command("move").description(
+    "Move a schema into a navigation folder. Only schemas can be moved (the navigation menu holds databases); schedules and sub-schemas follow their parent schema. Use the root folder UUID 00000000-0000-0000-0000-000000000000 to move it back to the workspace root."
+  ).argument("<resource>", "schema UUID").requiredOption("--to <folder>", "target folder UUID or exact name").action(async function action(resourceId, commandOptions) {
     const { api, json, readOnly } = createNavigationApi(this, filePath);
-    ensureWritable5("navigation resources move", readOnly, "write");
+    ensureWritable6("navigation resources move", readOnly, "write");
     const allFolders = await api.listFolders();
-    const resolved = resolveFolder2(allFolders, parseUuidOrSlugSelector6(commandOptions.to));
+    const resolved = resolveFolder2(allFolders, parseUuidOrSlugSelector7(commandOptions.to));
     const data = await api.moveResource({
       resourceId,
-      resourceType: commandOptions.type.toUpperCase(),
       targetFolderId: resolved.id
     });
     if (json) {
-      emitJson7(stdout, "navigation resources move", data, filePath);
+      emitJson8(stdout, "navigation resources move", data, filePath);
       return;
     }
-    writeLine7(stdout, `Moved resource "${resourceId}" to "${resolved.name ?? resolved.id}".`);
+    writeLine8(stdout, `Moved resource "${resourceId}" to "${resolved.name ?? resolved.id}".`);
   });
 }
 
 // src/commands/profiles.ts
-function getCommandIo8(stdout) {
+function getCommandIo9(stdout) {
   return stdout ?? process.stdout;
 }
-function writeLine8(stdout, value) {
+function writeLine9(stdout, value) {
   stdout.write(`${value}
 `);
 }
-function getGlobalOptions8(command) {
+function getGlobalOptions9(command) {
   return command.optsWithGlobals();
 }
-function emitJson8(stdout, commandName, data, configPath) {
-  writeLine8(
+function emitJson9(stdout, commandName, data, configPath) {
+  writeLine9(
     stdout,
     JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath }))
   );
@@ -9094,15 +10666,15 @@ function emitProfilesTable(stdout, data) {
 }
 function registerProfilesCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
-  const stdout = getCommandIo8(options.stdout);
+  const stdout = getCommandIo9(options.stdout);
   const profiles = program.command("profiles").description("Manage local CLI profiles");
   profiles.command("list").description("List configured profiles").action(function action() {
     const config = readRequiredConfig(filePath);
     const data = Object.entries(config.profiles).map(
       ([name, profile]) => toDisplayProfile(name, profile, config.defaultProfile)
     );
-    if (getGlobalOptions8(this).json) {
-      emitJson8(stdout, "profiles list", data, filePath);
+    if (getGlobalOptions9(this).json) {
+      emitJson9(stdout, "profiles list", data, filePath);
       return;
     }
     emitProfilesTable(stdout, data);
@@ -9111,8 +10683,8 @@ function registerProfilesCommands(program, options = {}) {
     const config = readRequiredConfig(filePath);
     const profile = getRequiredProfile(config, profileName);
     const data = toDisplayProfile(profileName, profile, config.defaultProfile);
-    if (getGlobalOptions8(this).json) {
-      emitJson8(stdout, "profiles get", data, filePath);
+    if (getGlobalOptions9(this).json) {
+      emitJson9(stdout, "profiles get", data, filePath);
       return;
     }
     emitProfilesTable(stdout, [data]);
@@ -9126,11 +10698,11 @@ function registerProfilesCommands(program, options = {}) {
       profile: profileName,
       defaultProfile: nextConfig.defaultProfile
     };
-    if (getGlobalOptions8(this).json) {
-      emitJson8(stdout, "profiles use", data, filePath);
+    if (getGlobalOptions9(this).json) {
+      emitJson9(stdout, "profiles use", data, filePath);
       return;
     }
-    writeLine8(stdout, `Using profile "${profileName}".`);
+    writeLine9(stdout, `Using profile "${profileName}".`);
   });
   profiles.command("add").description("Add a profile to the local config").argument("<profile>", "profile name").requiredOption("--api-key <token>", "API key").option("--base-url <url>", "base URL").action(function action(profileName, commandOptions) {
     const config = loadConfigForAdd(filePath);
@@ -9154,11 +10726,11 @@ function registerProfilesCommands(program, options = {}) {
       nextConfig.profiles[profileName] ?? {},
       nextConfig.defaultProfile
     );
-    if (getGlobalOptions8(this).json) {
-      emitJson8(stdout, "profiles add", data, filePath);
+    if (getGlobalOptions9(this).json) {
+      emitJson9(stdout, "profiles add", data, filePath);
       return;
     }
-    writeLine8(stdout, `Added profile "${profileName}".`);
+    writeLine9(stdout, `Added profile "${profileName}".`);
   });
   profiles.command("update").description("Update an existing profile").argument("<profile>", "profile name").option("--api-key <token>", "API key").option("--base-url <url>", "base URL").action(function action(profileName, commandOptions) {
     if (commandOptions.apiKey === void 0 && commandOptions.baseUrl === void 0) {
@@ -9180,11 +10752,11 @@ function registerProfilesCommands(program, options = {}) {
       nextConfig.profiles[profileName] ?? {},
       nextConfig.defaultProfile
     );
-    if (getGlobalOptions8(this).json) {
-      emitJson8(stdout, "profiles update", data, filePath);
+    if (getGlobalOptions9(this).json) {
+      emitJson9(stdout, "profiles update", data, filePath);
       return;
     }
-    writeLine8(stdout, `Updated profile "${profileName}".`);
+    writeLine9(stdout, `Updated profile "${profileName}".`);
   });
   profiles.command("remove").description("Remove a profile from the local config").argument("<profile>", "profile name").action(function action(profileName) {
     const config = readRequiredConfig(filePath);
@@ -9195,20 +10767,20 @@ function registerProfilesCommands(program, options = {}) {
       profile: profileName,
       defaultProfile: nextConfig.defaultProfile
     };
-    if (getGlobalOptions8(this).json) {
-      emitJson8(stdout, "profiles remove", data, filePath);
+    if (getGlobalOptions9(this).json) {
+      emitJson9(stdout, "profiles remove", data, filePath);
       return;
     }
-    writeLine8(stdout, `Removed profile "${profileName}".`);
+    writeLine9(stdout, `Removed profile "${profileName}".`);
   });
 }
 
 // src/commands/records.ts
-import { readFileSync as readFileSync7 } from "fs";
-import { InvalidArgumentError as InvalidArgumentError7 } from "commander";
+import { readFileSync as readFileSync8 } from "fs";
+import { InvalidArgumentError as InvalidArgumentError8 } from "commander";
 
 // src/api/records.ts
-function jsonOptions5(body, method) {
+function jsonOptions6(body, method) {
   return {
     method,
     headers: {
@@ -9217,7 +10789,7 @@ function jsonOptions5(body, method) {
     body: JSON.stringify(body)
   };
 }
-function selectorValue7(selector) {
+function selectorValue8(selector) {
   return selector.value;
 }
 var RecordsApi = class {
@@ -9232,7 +10804,7 @@ var RecordsApi = class {
     if (query.offset !== void 0) {
       params.set("offset", String(query.offset));
     }
-    const path = `/api/v2/schemas/${selectorValue7(schema)}/records`;
+    const path = `/api/v2/schemas/${selectorValue8(schema)}/records`;
     const queryString = params.toString();
     return this.client.getJson(
       queryString ? `${path}?${queryString}` : path
@@ -9241,36 +10813,36 @@ var RecordsApi = class {
   queryRecords(schema, query) {
     const body = this.normalizeQueryInput(query);
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue7(schema)}/records:query`,
-      jsonOptions5(body, "POST")
+      `/api/v2/schemas/${selectorValue8(schema)}/records:query`,
+      jsonOptions6(body, "POST")
     );
   }
   getRecord(schema, record) {
     return this.client.getJson(
-      `/api/v2/schemas/${selectorValue7(schema)}/records/${selectorValue7(record)}`
+      `/api/v2/schemas/${selectorValue8(schema)}/records/${selectorValue8(record)}`
     );
   }
-  createRecord(schema, input) {
+  createRecords(schema, records) {
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue7(schema)}/records`,
-      jsonOptions5(input, "POST")
+      `/api/v2/schemas/${selectorValue8(schema)}/records`,
+      jsonOptions6({ records }, "POST")
     );
   }
   updateRecord(schema, record, input) {
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue7(schema)}/records/${selectorValue7(record)}`,
-      jsonOptions5(input, "PATCH")
+      `/api/v2/schemas/${selectorValue8(schema)}/records/${selectorValue8(record)}`,
+      jsonOptions6(input, "PATCH")
     );
   }
-  deleteRecord(schema, record) {
+  deleteRecords(schema, recordIds) {
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue7(schema)}/records/${selectorValue7(record)}`,
-      { method: "DELETE" }
+      `/api/v2/schemas/${selectorValue8(schema)}/records:delete`,
+      jsonOptions6({ recordIds }, "POST")
     );
   }
   clearRecords(schema) {
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue7(schema)}/records:clear`,
+      `/api/v2/schemas/${selectorValue8(schema)}/records:clear`,
       { method: "DELETE" }
     );
   }
@@ -9303,7 +10875,7 @@ var RecordsApi = class {
 };
 
 // src/api/schemas.ts
-function jsonOptions6(body, method) {
+function jsonOptions7(body, method) {
   return {
     method,
     headers: {
@@ -9312,7 +10884,7 @@ function jsonOptions6(body, method) {
     body: JSON.stringify(body)
   };
 }
-function selectorValue8(selector) {
+function selectorValue9(selector) {
   return selector.value;
 }
 var SchemasApi = class {
@@ -9323,150 +10895,76 @@ var SchemasApi = class {
     return this.client.getJson("/api/v2/schemas");
   }
   getSchema(schema) {
-    return this.client.getJson(`/api/v2/schemas/${selectorValue8(schema)}`);
+    return this.client.getJson(`/api/v2/schemas/${selectorValue9(schema)}`);
   }
   createSchema(input) {
-    return this.client.requestJson("/api/v2/schemas", jsonOptions6(input, "POST"));
+    return this.client.requestJson("/api/v2/schemas", jsonOptions7(input, "POST"));
   }
   updateSchema(schema, input) {
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue8(schema)}`,
-      jsonOptions6(input, "PATCH")
-    );
-  }
-  deleteSchema(schema) {
-    return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue8(schema)}`,
-      { method: "DELETE" }
-    );
-  }
-  async listFields(schema) {
-    const result = await this.getSchema(schema);
-    return Array.isArray(result.fields) ? result.fields : [];
-  }
-  getField(schema, field) {
-    return this.client.getJson(
-      `/api/v2/schemas/${selectorValue8(schema)}/fields/${selectorValue8(field)}`
-    );
-  }
-  createField(schema, input) {
-    return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue8(schema)}/fields`,
-      jsonOptions6(input, "POST")
+      `/api/v2/schemas/${selectorValue9(schema)}`,
+      jsonOptions7(input, "PATCH")
     );
   }
-  updateField(schema, field, input) {
+  setUniqueFields(schema, input) {
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue8(schema)}/fields/${selectorValue8(field)}`,
-      jsonOptions6(input, "PATCH")
+      `/api/v2/schemas/${selectorValue9(schema)}/unique-fields`,
+      jsonOptions7(input, "PUT")
     );
   }
-  deleteField(schema, field) {
+  deleteSchema(schema) {
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue8(schema)}/fields/${selectorValue8(field)}`,
-      { method: "DELETE" }
-    );
-  }
-};
-
-// src/parsers/expressions.ts
-var supportedComparators = /* @__PURE__ */ new Set([
-  "eq",
-  "neq",
-  "gt",
-  "gte",
-  "lt",
-  "lte",
-  "contains",
-  "in",
-  "is_empty",
-  "is_not_empty"
-]);
-var noValueComparators = /* @__PURE__ */ new Set(["is_empty", "is_not_empty"]);
-function parseColonExpression(input) {
-  const parts = input.split(":");
-  if (parts.length < 2) {
-    throw new Error(`Expected a field:comparator[:value] expression, got "${input}".`);
-  }
-  const field = parts[0]?.trim();
-  const comparator = parts[1]?.trim();
-  if (!field) {
-    throw new Error(`Expected a field before ":", got "${input}".`);
-  }
-  if (!comparator) {
-    throw new Error(`Expected a comparator after "${field}:", got "${input}".`);
-  }
-  return [field, comparator, parts.slice(2).join(":").trim()];
-}
-function parseSpaceExpression(input) {
-  const parts = input.trim().split(/\s+/);
-  if (parts.length < 2) {
-    throw new Error(`Expected a field comparator expression, got "${input}".`);
-  }
-  const field = parts[0];
-  const comparator = parts[1];
-  if (!field) {
-    throw new Error(`Expected a field comparator expression, got "${input}".`);
+      `/api/v2/schemas/${selectorValue9(schema)}`,
+      { method: "DELETE" }
+    );
   }
-  if (!comparator) {
-    throw new Error(`Expected a comparator after "${field}", got "${input}".`);
+  async listFields(schema) {
+    const result = await this.getSchema(schema);
+    return Array.isArray(result.fields) ? result.fields : [];
   }
-  return [field.trim(), comparator.trim(), parts.slice(2).join(" ").trim()];
-}
-function normalizeValue(comparator, rawValue) {
-  if (noValueComparators.has(comparator)) {
-    if (rawValue.length > 0) {
-      throw new Error(`Comparator "${comparator}" does not accept a value.`);
-    }
-    return null;
+  getField(schema, field) {
+    return this.client.getJson(
+      `/api/v2/schemas/${selectorValue9(schema)}/fields/${selectorValue9(field)}`
+    );
   }
-  if (comparator === "in") {
-    const values = rawValue.split(",").map((value) => value.trim()).filter(Boolean);
-    if (values.length === 0) {
-      throw new Error(`Comparator "${comparator}" requires at least one value.`);
-    }
-    return values;
+  createField(schema, input) {
+    return this.client.requestJson(
+      `/api/v2/schemas/${selectorValue9(schema)}/fields`,
+      jsonOptions7(input, "POST")
+    );
   }
-  if (rawValue.length === 0) {
-    throw new Error(`Comparator "${comparator}" requires a value.`);
+  updateField(schema, field, input) {
+    return this.client.requestJson(
+      `/api/v2/schemas/${selectorValue9(schema)}/fields/${selectorValue9(field)}`,
+      jsonOptions7(input, "PATCH")
+    );
   }
-  return rawValue;
-}
-function parseExpression(input) {
-  const trimmed = input.trim();
-  const [field, comparatorCandidate, rawValue] = trimmed.includes(":") && !trimmed.includes(" ") ? parseColonExpression(trimmed) : parseSpaceExpression(trimmed);
-  if (!supportedComparators.has(comparatorCandidate)) {
-    throw new Error(
-      `Unsupported comparator "${comparatorCandidate}" in expression "${input}".`
+  deleteField(schema, field) {
+    return this.client.requestJson(
+      `/api/v2/schemas/${selectorValue9(schema)}/fields/${selectorValue9(field)}`,
+      { method: "DELETE" }
     );
   }
-  const comparator = comparatorCandidate;
-  return {
-    field,
-    comparator,
-    value: normalizeValue(comparator, rawValue),
-    raw: trimmed
-  };
-}
+};
 
 // src/commands/records.ts
-function getCommandIo9(stdout) {
+function getCommandIo10(stdout) {
   return stdout ?? process.stdout;
 }
-function writeLine9(stdout, value) {
+function writeLine10(stdout, value) {
   stdout.write(`${value}
 `);
 }
-function getGlobalOptions9(command) {
+function getGlobalOptions10(command) {
   return command.optsWithGlobals();
 }
-function emitJson9(stdout, commandName, data, configPath, meta = {}) {
-  writeLine9(
+function emitJson10(stdout, commandName, data, configPath, meta = {}) {
+  writeLine10(
     stdout,
     JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath, ...meta }))
   );
 }
-function toConfigurationError8(filePath, error) {
+function toConfigurationError9(filePath, error) {
   if (error instanceof CliError) {
     throw error;
   }
@@ -9481,7 +10979,7 @@ function toConfigurationError8(filePath, error) {
 function createRecordsApi(command, filePath) {
   try {
     const config = readRuntimeConfig(filePath);
-    const runtime = resolveRuntimeContext(config, getGlobalOptions9(command));
+    const runtime = resolveRuntimeContext(config, getGlobalOptions10(command));
     if (!runtime.baseUrl) {
       throw new CliError(
         "configuration_error",
@@ -9500,10 +10998,10 @@ function createRecordsApi(command, filePath) {
       readOnly: runtime.readOnly
     };
   } catch (error) {
-    toConfigurationError8(filePath, error);
+    toConfigurationError9(filePath, error);
   }
 }
-function ensureWritable6(commandName, readOnly, commandMode) {
+function ensureWritable7(commandName, readOnly, commandMode) {
   if (readOnly) {
     throw new CliError(
       "command_not_allowed_in_read_only_mode",
@@ -9515,24 +11013,24 @@ function ensureWritable6(commandName, readOnly, commandMode) {
     );
   }
 }
-function parseUuidOrSlugSelector7(input) {
+function parseUuidOrSlugSelector8(input) {
   try {
     return normalizeUuidOrSlug(input);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Invalid selector.";
-    throw new InvalidArgumentError7(message);
+    throw new InvalidArgumentError8(message);
   }
 }
 function parseNonNegativeInteger2(input) {
   if (!/^\d+$/.test(input.trim())) {
-    throw new InvalidArgumentError7(`Expected a non-negative integer, received "${input}".`);
+    throw new InvalidArgumentError8(`Expected a non-negative integer, received "${input}".`);
   }
   return Number(input);
 }
 function parseCommaSeparatedValues(input, label) {
   const values = input.split(",").map((value) => value.trim()).filter(Boolean);
   if (values.length === 0) {
-    throw new InvalidArgumentError7(`Expected ${label} to contain at least one value.`);
+    throw new InvalidArgumentError8(`Expected ${label} to contain at least one value.`);
   }
   return values;
 }
@@ -9541,7 +11039,7 @@ function parseExpressionValue(input) {
     return parseExpression(input);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Invalid expression.";
-    throw new InvalidArgumentError7(message);
+    throw new InvalidArgumentError8(message);
   }
 }
 function parseKeyValueAssignment(input) {
@@ -9549,7 +11047,7 @@ function parseKeyValueAssignment(input) {
     return parseKeyValue(input);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Invalid assignment.";
-    throw new InvalidArgumentError7(message);
+    throw new InvalidArgumentError8(message);
   }
 }
 function parseJsonKeyValueAssignment(input) {
@@ -9557,14 +11055,75 @@ function parseJsonKeyValueAssignment(input) {
     return parseJsonAssignment(input);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Invalid JSON assignment.";
-    throw new InvalidArgumentError7(message);
+    throw new InvalidArgumentError8(message);
+  }
+}
+function dedupeStrings(values) {
+  return [...new Set(values)];
+}
+function toRecordUuid(value) {
+  try {
+    const normalized = normalizeUuidOrSlug(value);
+    return normalized.kind === "uuid" ? normalized.value : null;
+  } catch {
+    return null;
+  }
+}
+function collectRecordIds(value, previous = []) {
+  const uuid = toRecordUuid(value.trim());
+  if (!uuid) {
+    throw new InvalidArgumentError8(`Expected a record UUID, received "${value}".`);
+  }
+  return [...previous, uuid];
+}
+function readRecordIdsFromFile(path) {
+  let contents;
+  try {
+    contents = readFileSync8(path, "utf8");
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unable to read file.";
+    throw new CliError(
+      "invalid_cli_usage",
+      `Failed to read record ids from ${path}: ${message}`
+    );
+  }
+  const ids = [];
+  contents.split(/\r?\n/).forEach((line, index) => {
+    const value = line.trim();
+    if (!value) {
+      return;
+    }
+    const uuid = toRecordUuid(value);
+    if (!uuid) {
+      throw new CliError(
+        "invalid_cli_usage",
+        `Invalid record UUID "${value}" at ${path}:${index + 1}.`
+      );
+    }
+    ids.push(uuid);
+  });
+  return ids;
+}
+function resolveDeleteRecordIds(options) {
+  const flagIds = options.record ?? [];
+  const fileIds = options.recordsFile ? readRecordIdsFromFile(options.recordsFile) : [];
+  const recordIds = dedupeStrings([...flagIds, ...fileIds]);
+  if (recordIds.length === 0) {
+    throw new CliError(
+      "invalid_cli_usage",
+      'Provide at least one record id via "--record <uuid>" (repeatable) or "--records-file <path>".'
+    );
   }
+  return recordIds;
 }
 function collectStringValues(value, previous = []) {
   return [...previous, value];
 }
+function collectSelectValues(value, previous = []) {
+  return dedupeStrings([...previous, ...parseCommaSeparatedValues(value, "--select")]);
+}
 function collectSortValues(value, previous = []) {
-  return [...previous, ...parseCommaSeparatedValues(value, "--sort")];
+  return dedupeStrings([...previous, ...parseCommaSeparatedValues(value, "--sort")]);
 }
 function collectWhereExpressions(value, previous = []) {
   return [...previous, parseExpressionValue(value)];
@@ -9575,7 +11134,7 @@ function collectKeyValueAssignments(value, previous = []) {
 function collectJsonAssignments(value, previous = []) {
   return [...previous, parseJsonKeyValueAssignment(value)];
 }
-function isJsonObject5(value) {
+function isJsonObject6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseRawJsonObject2(input, sourceLabel) {
@@ -9589,7 +11148,7 @@ function parseRawJsonObject2(input, sourceLabel) {
       `Failed to parse JSON from ${sourceLabel}: ${message}`
     );
   }
-  if (!isJsonObject5(parsed)) {
+  if (!isJsonObject6(parsed)) {
     throw new CliError(
       "invalid_cli_usage",
       `Expected ${sourceLabel} to contain a JSON object.`
@@ -9610,7 +11169,7 @@ function readRawObject3(raw, rawFile) {
   if (rawFile) {
     let contents;
     try {
-      contents = readFileSync7(rawFile, "utf8");
+      contents = readFileSync8(rawFile, "utf8");
     } catch (error) {
       const message = error instanceof Error ? error.message : "Unable to read file.";
       throw new CliError(
@@ -9622,7 +11181,7 @@ function readRawObject3(raw, rawFile) {
   }
   return {};
 }
-function isEmptyObject4(value) {
+function isEmptyObject5(value) {
   return Object.keys(value).length === 0;
 }
 function buildAssignmentObject(assignments = [], jsonAssignments = []) {
@@ -9654,6 +11213,9 @@ function buildRecordQueryInput(options, allowRaw) {
   if (where && where.length > 0) {
     input.where = where;
   }
+  if (options.search !== void 0) {
+    input.search = { term: options.search };
+  }
   if (options.sort && options.sort.length > 0) {
     input.sort = [...options.sort];
   }
@@ -9665,53 +11227,80 @@ function buildRecordQueryInput(options, allowRaw) {
   }
   return input;
 }
-function buildRecordCreateInput(options) {
-  const values = {
-    ...readRawObject3(options.raw, options.rawFile),
-    ...buildAssignmentObject(options.set, options.setJson)
-  };
-  if (isEmptyObject4(values)) {
+function readRecordsFromFile(path) {
+  let contents;
+  try {
+    contents = readFileSync8(path, "utf8");
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unable to read file.";
     throw new CliError(
       "invalid_cli_usage",
-      'Provide record fields via "--set", "--set-json", "--raw", or "--raw-file".'
+      `Failed to read records from ${path}: ${message}`
     );
   }
-  return { values };
-}
-function readRawSetPayload2(raw) {
-  const setValue = raw.set;
-  if (setValue === void 0) {
-    return {};
+  let parsed;
+  try {
+    parsed = JSON.parse(contents);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Invalid JSON.";
+    throw new CliError(
+      "invalid_cli_usage",
+      `Failed to parse JSON from --records-file ${path}: ${message}`
+    );
   }
-  if (!isJsonObject5(setValue)) {
+  if (!Array.isArray(parsed)) {
     throw new CliError(
       "invalid_cli_usage",
-      'Expected raw update payload field "set" to be a JSON object.'
+      `Expected --records-file ${path} to contain a JSON array of record objects.`
     );
   }
-  return { ...setValue };
+  if (parsed.length === 0) {
+    throw new CliError(
+      "invalid_cli_usage",
+      `--records-file ${path} must contain at least one record.`
+    );
+  }
+  return parsed.map((record, index) => {
+    if (!isJsonObject6(record)) {
+      throw new CliError(
+        "invalid_cli_usage",
+        `Record at index ${index} in --records-file ${path} must be a JSON object.`
+      );
+    }
+    return record;
+  });
 }
-function readRawUnsetPayload2(raw) {
-  const unsetValue = raw.unset;
-  if (unsetValue === void 0) {
-    return [];
+function buildCreateRecords(options) {
+  const hasSingleRecordFlags = (options.set?.length ?? 0) > 0 || (options.setJson?.length ?? 0) > 0 || options.raw !== void 0 || options.rawFile !== void 0;
+  if (options.recordsFile !== void 0) {
+    if (hasSingleRecordFlags) {
+      throw new CliError(
+        "invalid_cli_usage",
+        'Provide either "--records-file" or the single-record flags (--set/--set-json/--raw/--raw-file), not both.'
+      );
+    }
+    return readRecordsFromFile(options.recordsFile);
   }
-  if (!Array.isArray(unsetValue) || !unsetValue.every((value) => typeof value === "string")) {
+  const values = {
+    ...readRawObject3(options.raw, options.rawFile),
+    ...buildAssignmentObject(options.set, options.setJson)
+  };
+  if (isEmptyObject5(values)) {
     throw new CliError(
       "invalid_cli_usage",
-      'Expected raw update payload field "unset" to be an array of strings.'
+      'Provide record fields via "--set", "--set-json", "--raw", "--raw-file", or load multiple records with "--records-file".'
     );
   }
-  return [...unsetValue];
+  return [values];
 }
 function buildRecordUpdateInput(options) {
   const raw = readRawObject3(options.raw, options.rawFile);
-  const input = { ...raw };
+  const input = {};
   const setPayload = {
-    ...readRawSetPayload2(raw),
+    ...raw,
     ...buildAssignmentObject(options.set, options.setJson)
   };
-  const unsetPayload = [...readRawUnsetPayload2(raw), ...options.unset ?? []];
+  const unsetPayload = [...options.unset ?? []];
   for (const key of Object.keys(setPayload)) {
     const unsetIndex = unsetPayload.indexOf(key);
     if (unsetIndex !== -1) {
@@ -9728,7 +11317,7 @@ function buildRecordUpdateInput(options) {
   } else {
     delete input.unset;
   }
-  if (isEmptyObject4(input)) {
+  if (isEmptyObject5(input)) {
     throw new CliError(
       "invalid_cli_usage",
       'Provide record updates via "--set", "--set-json", "--unset", "--raw", or "--raw-file".'
@@ -9738,9 +11327,9 @@ function buildRecordUpdateInput(options) {
 }
 function toTableRows4(data) {
   if (Array.isArray(data)) {
-    return data.map((entry) => isJsonObject5(entry) ? entry : { value: entry });
+    return data.map((entry) => isJsonObject6(entry) ? entry : { value: entry });
   }
-  if (isJsonObject5(data)) {
+  if (isJsonObject6(data)) {
     return [data];
   }
   return [{ value: data }];
@@ -9770,9 +11359,9 @@ async function resolveSchemaSelector(api, selector) {
 }
 function registerRecordsCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
-  const stdout = getCommandIo9(options.stdout);
+  const stdout = getCommandIo10(options.stdout);
   const records = program.command("records").description("Manage schema records");
-  records.command("list").description("List records for a schema with simple pagination").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).option("--limit <number>", "limit results", parseNonNegativeInteger2).option("--offset <number>", "offset results", parseNonNegativeInteger2).action(async function action(schema, commandOptions) {
+  records.command("list").description("List records for a schema with simple pagination").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).option("--limit <number>", "limit results", parseNonNegativeInteger2).option("--offset <number>", "offset results", parseNonNegativeInteger2).action(async function action(schema, commandOptions) {
     const { api, schemasApi, json } = createRecordsApi(this, filePath);
     const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
     const data = await api.listRecords(
@@ -9781,7 +11370,7 @@ function registerRecordsCommands(program, options = {}) {
     );
     const recordsData = getQueryRecords(data);
     if (json) {
-      emitJson9(
+      emitJson10(
         stdout,
         "records list",
         recordsData,
@@ -9792,7 +11381,10 @@ function registerRecordsCommands(program, options = {}) {
     }
     emitTable4(stdout, recordsData);
   });
-  records.command("query").description("Query records for a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).option("--select <fields>", "comma-separated field selection", (value) => parseCommaSeparatedValues(value, "--select")).option("--where <expression>", "where expression", collectWhereExpressions, []).option("--sort <field:direction>", "sort field(s)", collectSortValues, []).option("--limit <number>", "limit results", parseNonNegativeInteger2).option("--offset <number>", "offset results", parseNonNegativeInteger2).option("--raw <json>", "raw JSON object payload").option("--raw-file <path>", "path to a raw JSON object payload").action(async function action(schema, commandOptions) {
+  records.command("query").description("Query records for a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).option("--select <fields>", "field selection (comma-separated, repeatable)", collectSelectValues, []).option("--where <expression>", "where expression", collectWhereExpressions, []).option(
+    "--search <term>",
+    "free-text search term (matched across the schema's searchable fields)"
+  ).option("--sort <field:direction>", "sort field(s)", collectSortValues, []).option("--limit <number>", "limit results", parseNonNegativeInteger2).option("--offset <number>", "offset results", parseNonNegativeInteger2).option("--raw <json>", "raw JSON object payload").option("--raw-file <path>", "path to a raw JSON object payload").action(async function action(schema, commandOptions) {
     const { api, schemasApi, json } = createRecordsApi(this, filePath);
     const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
     const data = await api.queryRecords(
@@ -9801,7 +11393,7 @@ function registerRecordsCommands(program, options = {}) {
     );
     const recordsData = getQueryRecords(data);
     if (json) {
-      emitJson9(
+      emitJson10(
         stdout,
         "records query",
         recordsData,
@@ -9812,33 +11404,50 @@ function registerRecordsCommands(program, options = {}) {
     }
     emitTable4(stdout, recordsData);
   });
-  records.command("get").description("Get a record by UUID or slug").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).argument("<record>", "record uuid or slug", parseUuidOrSlugSelector7).action(async function action(schema, record) {
+  records.command("get").description("Get a record by UUID or slug").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).argument("<record>", "record uuid or slug", parseUuidOrSlugSelector8).action(async function action(schema, record) {
     const { api, schemasApi, json } = createRecordsApi(this, filePath);
     const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
     const data = await api.getRecord(resolvedSchema, record);
     if (json) {
-      emitJson9(stdout, "records get", data, filePath);
+      emitJson10(stdout, "records get", data, filePath);
       return;
     }
     emitTable4(stdout, data);
   });
-  records.command("create").description("Create a record").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).option("--set <field=value>", "set a string field", collectKeyValueAssignments, []).option("--set-json <field=json>", "set a structured field", collectJsonAssignments, []).option("--raw <json>", "raw JSON object payload").option("--raw-file <path>", "path to a raw JSON object payload").action(async function action(schema, commandOptions) {
+  records.command("create").description("Create one or more records").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).option(
+    "--set <field=value>",
+    "set a string field (reference fields: a record id, 'recordId::label', or an exact display value)",
+    collectKeyValueAssignments,
+    []
+  ).option("--set-json <field=json>", "set a structured field", collectJsonAssignments, []).option("--raw <json>", "raw JSON object payload").option("--raw-file <path>", "path to a raw JSON object payload").option(
+    "--records-file <path>",
+    "path to a JSON array of record objects (mutually exclusive with --set/--set-json/--raw/--raw-file)"
+  ).action(async function action(schema, commandOptions) {
     const { api, schemasApi, json, readOnly } = createRecordsApi(this, filePath);
-    ensureWritable6("records create", readOnly, "write");
+    ensureWritable7("records create", readOnly, "write");
+    const records2 = buildCreateRecords(commandOptions);
     const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
-    const data = await api.createRecord(
-      resolvedSchema,
-      buildRecordCreateInput(commandOptions)
-    );
+    const data = await api.createRecords(resolvedSchema, records2);
     if (json) {
-      emitJson9(stdout, "records create", data, filePath);
+      emitJson10(stdout, "records create", data, filePath);
       return;
     }
-    writeLine9(stdout, `Created record "${getRecordIdentifier(data)}".`);
+    writeLine10(stdout, `Created ${data.created.length} record(s) in schema "${schema.value}".`);
+    if (data.errors.length > 0) {
+      writeLine10(stdout, `${data.errors.length} record(s) rejected:`);
+      for (const error of data.errors) {
+        writeLine10(stdout, `  - index ${error.index}: ${error.message}`);
+      }
+    }
   });
-  records.command("update").description("Update a record").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).argument("<record>", "record uuid or slug", parseUuidOrSlugSelector7).option("--set <field=value>", "set a string field", collectKeyValueAssignments, []).option("--set-json <field=json>", "set a structured field", collectJsonAssignments, []).option("--unset <field>", "unset a field", collectStringValues, []).option("--raw <json>", "raw JSON object payload").option("--raw-file <path>", "path to a raw JSON object payload").action(async function action(schema, record, commandOptions) {
+  records.command("update").description("Update a record").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).argument("<record>", "record uuid or slug", parseUuidOrSlugSelector8).option(
+    "--set <field=value>",
+    "set a string field (reference fields: a record id, 'recordId::label', or an exact display value)",
+    collectKeyValueAssignments,
+    []
+  ).option("--set-json <field=json>", "set a structured field", collectJsonAssignments, []).option("--unset <field>", "unset a field", collectStringValues, []).option("--raw <json>", "raw JSON object of fields to set").option("--raw-file <path>", "path to a JSON object of fields to set").action(async function action(schema, record, commandOptions) {
     const { api, schemasApi, json, readOnly } = createRecordsApi(this, filePath);
-    ensureWritable6("records update", readOnly, "write");
+    ensureWritable7("records update", readOnly, "write");
     const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
     const data = await api.updateRecord(
       resolvedSchema,
@@ -9846,60 +11455,71 @@ function registerRecordsCommands(program, options = {}) {
       buildRecordUpdateInput(commandOptions)
     );
     if (json) {
-      emitJson9(stdout, "records update", data, filePath);
+      emitJson10(stdout, "records update", data, filePath);
       return;
     }
-    writeLine9(stdout, `Updated record "${getRecordIdentifier(data)}".`);
+    writeLine10(stdout, `Updated record "${getRecordIdentifier(data)}".`);
   });
-  records.command("delete").description("Delete a record").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).argument("<record>", "record uuid or slug", parseUuidOrSlugSelector7).action(async function action(schema, record) {
+  records.command("delete").description("Delete one or more records").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).option("--record <uuid>", "record uuid to delete (repeatable)", collectRecordIds, []).option(
+    "--records-file <path>",
+    "path to a file with one record uuid per line (merged with --record)"
+  ).action(async function action(schema, commandOptions) {
     const { api, schemasApi, json, readOnly } = createRecordsApi(this, filePath);
-    ensureWritable6("records delete", readOnly, "destructive");
+    ensureWritable7("records delete", readOnly, "destructive");
+    const recordIds = resolveDeleteRecordIds(commandOptions);
     const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
-    await api.deleteRecord(resolvedSchema, record);
-    const data = {
-      schema: resolvedSchema.value,
-      record: record.value,
-      deleted: true
-    };
+    const data = await api.deleteRecords(resolvedSchema, recordIds);
     if (json) {
-      emitJson9(stdout, "records delete", data, filePath);
+      emitJson10(stdout, "records delete", data, filePath);
       return;
     }
-    writeLine9(stdout, `Deleted record "${record.value}" from schema "${schema.value}".`);
+    writeLine10(
+      stdout,
+      `Deleted ${recordIds.length} record(s) from schema "${schema.value}".`
+    );
   });
-  records.command("clear").description("Delete all records from a schema's table").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).action(async function action(schema) {
+  records.command("clear").description("Delete all records from a schema's table").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).action(async function action(schema) {
     const { api, schemasApi, json, readOnly } = createRecordsApi(this, filePath);
-    ensureWritable6("records clear", readOnly, "destructive");
+    ensureWritable7("records clear", readOnly, "destructive");
     const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
     const data = await api.clearRecords(resolvedSchema);
     if (json) {
-      emitJson9(stdout, "records clear", data, filePath);
+      emitJson10(stdout, "records clear", data, filePath);
       return;
     }
-    writeLine9(stdout, `Cleared all records from schema "${schema.value}".`);
+    writeLine10(stdout, `Cleared all records from schema "${schema.value}".`);
   });
 }
 
 // src/commands/schemas.ts
-import { readFileSync as readFileSync8 } from "fs";
-import { InvalidArgumentError as InvalidArgumentError8 } from "commander";
-function getCommandIo10(stdout) {
+import { readFileSync as readFileSync9 } from "fs";
+import { InvalidArgumentError as InvalidArgumentError9 } from "commander";
+var HIGHLIGHTED_FIELD_HELP = `
+Highlighted field:
+  The schema's "main" field. The frontend uses its value as each record's
+  display name, in two places:
+    - Activity panel: the record's title in the activity side panel
+      (the panel with the record's logs and comments).
+    - Detail view: the record's name in the left-hand record list you
+      browse to open each record's form.
+`;
+function getCommandIo11(stdout) {
   return stdout ?? process.stdout;
 }
-function writeLine10(stdout, value) {
+function writeLine11(stdout, value) {
   stdout.write(`${value}
 `);
 }
-function getGlobalOptions10(command) {
+function getGlobalOptions11(command) {
   return command.optsWithGlobals();
 }
-function emitJson10(stdout, commandName, data, configPath) {
-  writeLine10(
+function emitJson11(stdout, commandName, data, configPath) {
+  writeLine11(
     stdout,
     JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath }))
   );
 }
-function toConfigurationError9(filePath, error) {
+function toConfigurationError10(filePath, error) {
   if (error instanceof CliError) {
     throw error;
   }
@@ -9914,7 +11534,7 @@ function toConfigurationError9(filePath, error) {
 function createSchemasApi(command, filePath) {
   try {
     const config = readRuntimeConfig(filePath);
-    const runtime = resolveRuntimeContext(config, getGlobalOptions10(command));
+    const runtime = resolveRuntimeContext(config, getGlobalOptions11(command));
     if (!runtime.baseUrl) {
       throw new CliError(
         "configuration_error",
@@ -9933,10 +11553,10 @@ function createSchemasApi(command, filePath) {
       readOnly: runtime.readOnly
     };
   } catch (error) {
-    toConfigurationError9(filePath, error);
+    toConfigurationError10(filePath, error);
   }
 }
-function ensureWritable7(commandName, readOnly, commandMode) {
+function ensureWritable8(commandName, readOnly, commandMode) {
   if (readOnly) {
     throw new CliError(
       "command_not_allowed_in_read_only_mode",
@@ -9948,14 +11568,17 @@ function ensureWritable7(commandName, readOnly, commandMode) {
     );
   }
 }
-function parseUuidOrSlugSelector8(input) {
+function parseUuidOrSlugSelector9(input) {
   try {
     return normalizeUuidOrSlug(input);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Invalid selector.";
-    throw new InvalidArgumentError8(message);
+    throw new InvalidArgumentError9(message);
   }
 }
+function collectFieldSelectors(value, previous = []) {
+  return [...previous, parseUuidOrSlugSelector9(value)];
+}
 function parseBooleanFlag(input) {
   const normalized = input.trim().toLowerCase();
   if (["true", "1", "yes", "y", "on"].includes(normalized)) {
@@ -9964,9 +11587,9 @@ function parseBooleanFlag(input) {
   if (["false", "0", "no", "n", "off"].includes(normalized)) {
     return false;
   }
-  throw new InvalidArgumentError8(`Expected a boolean value, received "${input}".`);
+  throw new InvalidArgumentError9(`Expected a boolean value, received "${input}".`);
 }
-function isJsonObject6(value) {
+function isJsonObject7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseRawJsonObject3(input, sourceLabel) {
@@ -9980,7 +11603,7 @@ function parseRawJsonObject3(input, sourceLabel) {
       `Failed to parse JSON from ${sourceLabel}: ${message}`
     );
   }
-  if (!isJsonObject6(parsed)) {
+  if (!isJsonObject7(parsed)) {
     throw new CliError(
       "invalid_cli_usage",
       `Expected ${sourceLabel} to contain a JSON object.`
@@ -10001,7 +11624,7 @@ function readRawObject4(raw, rawFile) {
   if (rawFile) {
     let contents;
     try {
-      contents = readFileSync8(rawFile, "utf8");
+      contents = readFileSync9(rawFile, "utf8");
     } catch (error) {
       const message = error instanceof Error ? error.message : "Unable to read file.";
       throw new CliError(
@@ -10060,7 +11683,7 @@ function applyFieldDefaultValue(input, defaultValue) {
     return;
   }
   const config = input.config;
-  if (config !== void 0 && !isJsonObject6(config)) {
+  if (config !== void 0 && !isJsonObject7(config)) {
     throw new CliError(
       "invalid_cli_usage",
       'Expected field "config" to be a JSON object when using "--default".'
@@ -10100,7 +11723,7 @@ function buildFieldCreateInput(options) {
     input.required = options.required;
   }
   applyFieldDefaultValue(input, options.default);
-  if ("config" in input && isJsonObject6(input.config) && isEmptyObject5(input.config)) {
+  if ("config" in input && isJsonObject7(input.config) && isEmptyObject6(input.config)) {
     delete input.config;
   }
   return input;
@@ -10173,35 +11796,35 @@ async function resolveFieldSelector(api, schema, selector) {
     value: match.id
   };
 }
-function isEmptyObject5(value) {
+function isEmptyObject6(value) {
   return Object.keys(value).length === 0;
 }
 function registerSchemasCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
-  const stdout = getCommandIo10(options.stdout);
+  const stdout = getCommandIo11(options.stdout);
   const schemas = program.command("schemas").description("Manage schemas and schema fields");
   schemas.command("list").description("List schemas").action(async function action() {
     const { api, json } = createSchemasApi(this, filePath);
     const data = await api.listSchemas();
     if (json) {
-      emitJson10(stdout, "schemas list", data, filePath);
+      emitJson11(stdout, "schemas list", data, filePath);
       return;
     }
     emitSchemasTable(stdout, data);
   });
-  schemas.command("get").description("Get a schema by UUID or slug").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).action(async function action(schema) {
+  schemas.command("get").description("Get a schema by UUID or slug").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector9).action(async function action(schema) {
     const { api, json } = createSchemasApi(this, filePath);
     const resolvedSchema = await resolveSchemaSelector2(api, schema);
     const data = await api.getSchema(resolvedSchema);
     if (json) {
-      emitJson10(stdout, "schemas get", data, filePath);
+      emitJson11(stdout, "schemas get", data, filePath);
       return;
     }
     emitSchemasTable(stdout, [data]);
   });
   schemas.command("create").description("Create a schema").requiredOption("--name <name>", "schema name").requiredOption("--slug <slug>", "schema slug").option("--auditable", "mark schema as auditable").option("--commentable", "mark schema as commentable").action(async function action(commandOptions) {
     const { api, json, readOnly } = createSchemasApi(this, filePath);
-    ensureWritable7("schemas create", readOnly, "write");
+    ensureWritable8("schemas create", readOnly, "write");
     const input = {
       name: commandOptions.name,
       slug: commandOptions.slug,
@@ -10210,32 +11833,87 @@ function registerSchemasCommands(program, options = {}) {
     };
     const data = await api.createSchema(input);
     if (json) {
-      emitJson10(stdout, "schemas create", data, filePath);
+      emitJson11(stdout, "schemas create", data, filePath);
       return;
     }
-    writeLine10(stdout, `Created schema "${data.slug ?? commandOptions.slug}".`);
+    writeLine11(stdout, `Created schema "${data.slug ?? commandOptions.slug}".`);
   });
-  schemas.command("update").description("Update a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).option("--name <name>", "schema name").option("--slug <slug>", "schema slug").option("--auditable <bool>", "auditable flag", parseBooleanFlag).option("--commentable <bool>", "commentable flag", parseBooleanFlag).action(async function action(schema, commandOptions) {
+  schemas.command("update").description("Update a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector9).option("--name <name>", "schema name").option("--slug <slug>", "schema slug").option("--auditable <bool>", "auditable flag", parseBooleanFlag).option("--commentable <bool>", "commentable flag", parseBooleanFlag).option(
+    "--highlighted-field <field>",
+    "its value is used as each record's display name in the UI (field uuid or slug)",
+    parseUuidOrSlugSelector9
+  ).action(async function action(schema, commandOptions) {
     const { api, json, readOnly } = createSchemasApi(this, filePath);
-    ensureWritable7("schemas update", readOnly, "write");
+    ensureWritable8("schemas update", readOnly, "write");
     const resolvedSchema = await resolveSchemaSelector2(api, schema);
     const input = buildSchemaUpdateInput(commandOptions);
-    if (isEmptyObject5(input)) {
+    if (commandOptions.highlightedField !== void 0) {
+      const resolvedField = await resolveFieldSelector(
+        api,
+        resolvedSchema,
+        commandOptions.highlightedField
+      );
+      input.highlightedField = resolvedField.value;
+    }
+    if (isEmptyObject6(input)) {
       throw new CliError(
         "invalid_cli_usage",
-        'Provide at least one schema field to update via "--name", "--slug", "--auditable", or "--commentable".'
+        'Provide at least one schema field to update via "--name", "--slug", "--auditable", "--commentable", or "--highlighted-field".'
       );
     }
     const data = await api.updateSchema(resolvedSchema, input);
     if (json) {
-      emitJson10(stdout, "schemas update", data, filePath);
+      emitJson11(stdout, "schemas update", data, filePath);
+      return;
+    }
+    writeLine11(stdout, `Updated schema "${data.slug ?? schema.value}".`);
+  }).addHelpText("after", HIGHLIGHTED_FIELD_HELP);
+  schemas.command("set-unique-fields").description("Set or clear the composite unique-field constraint on a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector9).option(
+    "--field <field>",
+    "field uuid or slug to include in the unique constraint (repeatable)",
+    collectFieldSelectors,
+    []
+  ).option("--clear", "clear the unique constraint (sends an empty field list)").action(async function action(schema, commandOptions) {
+    const { api, json, readOnly } = createSchemasApi(this, filePath);
+    ensureWritable8("schemas set-unique-fields", readOnly, "write");
+    const selectors = commandOptions.field ?? [];
+    if (commandOptions.clear && selectors.length > 0) {
+      throw new CliError(
+        "invalid_cli_usage",
+        'Use either "--field" or "--clear", not both.'
+      );
+    }
+    if (!commandOptions.clear && selectors.length === 0) {
+      throw new CliError(
+        "invalid_cli_usage",
+        'Provide at least one field via "--field", or pass "--clear" to remove the unique constraint.'
+      );
+    }
+    const resolvedSchema = await resolveSchemaSelector2(api, schema);
+    const resolvedFields = await Promise.all(
+      selectors.map((selector) => resolveFieldSelector(api, resolvedSchema, selector))
+    );
+    const input = {
+      fieldIds: resolvedFields.map((field) => field.value)
+    };
+    const data = await api.setUniqueFields(resolvedSchema, input);
+    if (json) {
+      emitJson11(stdout, "schemas set-unique-fields", data, filePath);
+      return;
+    }
+    if (input.fieldIds.length === 0) {
+      writeLine11(stdout, `Cleared unique fields on schema "${schema.value}".`);
       return;
     }
-    writeLine10(stdout, `Updated schema "${data.slug ?? schema.value}".`);
+    const count = input.fieldIds.length;
+    writeLine11(
+      stdout,
+      `Set unique fields on schema "${schema.value}" (${count} field${count === 1 ? "" : "s"}).`
+    );
   });
-  schemas.command("delete").description("Delete a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).action(async function action(schema) {
+  schemas.command("delete").description("Delete a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector9).action(async function action(schema) {
     const { api, json, readOnly } = createSchemasApi(this, filePath);
-    ensureWritable7("schemas delete", readOnly, "destructive");
+    ensureWritable8("schemas delete", readOnly, "destructive");
     const resolvedSchema = await resolveSchemaSelector2(api, schema);
     await api.deleteSchema(resolvedSchema);
     const data = {
@@ -10243,36 +11921,36 @@ function registerSchemasCommands(program, options = {}) {
       deleted: true
     };
     if (json) {
-      emitJson10(stdout, "schemas delete", data, filePath);
+      emitJson11(stdout, "schemas delete", data, filePath);
       return;
     }
-    writeLine10(stdout, `Deleted schema "${schema.value}".`);
+    writeLine11(stdout, `Deleted schema "${schema.value}".`);
   });
   const fields = schemas.command("fields").description("Manage schema fields");
-  fields.command("list").description("List fields for a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).action(async function action(schema) {
+  fields.command("list").description("List fields for a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector9).action(async function action(schema) {
     const { api, json } = createSchemasApi(this, filePath);
     const resolvedSchema = await resolveSchemaSelector2(api, schema);
     const data = await api.listFields(resolvedSchema);
     if (json) {
-      emitJson10(stdout, "schemas fields list", data, filePath);
+      emitJson11(stdout, "schemas fields list", data, filePath);
       return;
     }
     emitFieldsTable(stdout, data);
   });
-  fields.command("get").description("Get a field by UUID or slug").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).argument("<field>", "field uuid or slug", parseUuidOrSlugSelector8).action(async function action(schema, field) {
+  fields.command("get").description("Get a field by UUID or slug").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector9).argument("<field>", "field uuid or slug", parseUuidOrSlugSelector9).action(async function action(schema, field) {
     const { api, json } = createSchemasApi(this, filePath);
     const resolvedSchema = await resolveSchemaSelector2(api, schema);
     const resolvedField = await resolveFieldSelector(api, resolvedSchema, field);
     const data = await api.getField(resolvedSchema, resolvedField);
     if (json) {
-      emitJson10(stdout, "schemas fields get", data, filePath);
+      emitJson11(stdout, "schemas fields get", data, filePath);
       return;
     }
     emitFieldsTable(stdout, [data]);
   });
-  fields.command("create").description(`Create a field in a schema.${buildSchemaFieldCreateHelpText()}`).argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).option("--type <type>", `field type (${formatSchemaFieldTypes()})`).option("--slug <slug>", "field slug").option("--label <label>", "field label").option("--required <bool>", "required flag", parseBooleanFlag).option("--default <value>", "default field value").option("--raw <json>", "raw JSON object payload (see type-specific shapes in --help)").option("--raw-file <path>", "path to a raw JSON object payload").action(async function action(schema, commandOptions) {
+  fields.command("create").description(`Create a field in a schema.${buildSchemaFieldCreateHelpText()}`).argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector9).option("--type <type>", `field type (${formatSchemaFieldTypes()})`).option("--slug <slug>", "field slug").option("--label <label>", "field label").option("--required <bool>", "required flag", parseBooleanFlag).option("--default <value>", "default field value").option("--raw <json>", "raw JSON object payload (see type-specific shapes in --help)").option("--raw-file <path>", "path to a raw JSON object payload").action(async function action(schema, commandOptions) {
     const { api, json, readOnly } = createSchemasApi(this, filePath);
-    ensureWritable7("schemas fields create", readOnly, "write");
+    ensureWritable8("schemas fields create", readOnly, "write");
     const input = buildFieldCreateInput(commandOptions);
     const resolvedSchema = await resolveSchemaSelector2(api, schema);
     let data;
@@ -10282,14 +11960,14 @@ function registerSchemasCommands(program, options = {}) {
       toFieldCreateError(error, input);
     }
     if (json) {
-      emitJson10(stdout, "schemas fields create", data, filePath);
+      emitJson11(stdout, "schemas fields create", data, filePath);
       return;
     }
-    writeLine10(stdout, `Created field "${data.slug ?? commandOptions.slug}".`);
+    writeLine11(stdout, `Created field "${data.slug ?? commandOptions.slug}".`);
   });
-  fields.command("update").description("Update a field in a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).argument("<field>", "field uuid or slug", parseUuidOrSlugSelector8).option("--label <label>", "field label").option("--required <bool>", "required flag", parseBooleanFlag).option("--default <value>", "default field value").option("--raw <json>", "raw JSON object payload").option("--raw-file <path>", "path to a raw JSON object payload").action(async function action(schema, field, commandOptions) {
+  fields.command("update").description("Update a field in a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector9).argument("<field>", "field uuid or slug", parseUuidOrSlugSelector9).option("--label <label>", "field label").option("--required <bool>", "required flag", parseBooleanFlag).option("--default <value>", "default field value").option("--raw <json>", "raw JSON object payload").option("--raw-file <path>", "path to a raw JSON object payload").action(async function action(schema, field, commandOptions) {
     const { api, json, readOnly } = createSchemasApi(this, filePath);
-    ensureWritable7("schemas fields update", readOnly, "write");
+    ensureWritable8("schemas fields update", readOnly, "write");
     const resolvedSchema = await resolveSchemaSelector2(api, schema);
     const resolvedField = await resolveFieldSelector(api, resolvedSchema, field);
     const currentField = await api.getField(resolvedSchema, resolvedField);
@@ -10298,7 +11976,7 @@ function registerSchemasCommands(program, options = {}) {
       throw new CliError("invalid_cli_usage", `Field "${field.value}" is missing type metadata.`);
     }
     const input = buildFieldUpdateInput(currentType, commandOptions);
-    if (isEmptyObject5(input)) {
+    if (isEmptyObject6(input)) {
       throw new CliError(
         "invalid_cli_usage",
         'Provide at least one field update via "--label", "--required", "--raw", or "--raw-file".'
@@ -10306,14 +11984,14 @@ function registerSchemasCommands(program, options = {}) {
     }
     const data = await api.updateField(resolvedSchema, resolvedField, input);
     if (json) {
-      emitJson10(stdout, "schemas fields update", data, filePath);
+      emitJson11(stdout, "schemas fields update", data, filePath);
       return;
     }
-    writeLine10(stdout, `Updated field "${data.slug ?? field.value}".`);
+    writeLine11(stdout, `Updated field "${data.slug ?? field.value}".`);
   });
-  fields.command("delete").description("Delete a field from a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).argument("<field>", "field uuid or slug", parseUuidOrSlugSelector8).action(async function action(schema, field) {
+  fields.command("delete").description("Delete a field from a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector9).argument("<field>", "field uuid or slug", parseUuidOrSlugSelector9).action(async function action(schema, field) {
     const { api, json, readOnly } = createSchemasApi(this, filePath);
-    ensureWritable7("schemas fields delete", readOnly, "destructive");
+    ensureWritable8("schemas fields delete", readOnly, "destructive");
     const resolvedSchema = await resolveSchemaSelector2(api, schema);
     const resolvedField = await resolveFieldSelector(api, resolvedSchema, field);
     await api.deleteField(resolvedSchema, resolvedField);
@@ -10323,19 +12001,19 @@ function registerSchemasCommands(program, options = {}) {
       deleted: true
     };
     if (json) {
-      emitJson10(stdout, "schemas fields delete", data, filePath);
+      emitJson11(stdout, "schemas fields delete", data, filePath);
       return;
     }
-    writeLine10(stdout, `Deleted field "${field.value}" from schema "${schema.value}".`);
+    writeLine11(stdout, `Deleted field "${field.value}" from schema "${schema.value}".`);
   });
 }
 
 // src/commands/teamspace.ts
-import { readFileSync as readFileSync9 } from "fs";
-import { InvalidArgumentError as InvalidArgumentError9 } from "commander";
+import { readFileSync as readFileSync10 } from "fs";
+import { InvalidArgumentError as InvalidArgumentError10 } from "commander";
 
 // src/api/teamspace.ts
-function jsonOptions7(body, method) {
+function jsonOptions8(body, method) {
   return {
     method,
     headers: {
@@ -10344,7 +12022,7 @@ function jsonOptions7(body, method) {
     body: JSON.stringify(body)
   };
 }
-function selectorValue9(selector) {
+function selectorValue10(selector) {
   return selector.value;
 }
 var TeamspaceApi = class {
@@ -10365,53 +12043,53 @@ var TeamspaceApi = class {
   createFolder(input) {
     return this.client.requestJson(
       "/api/v2/teamspaces/folders",
-      jsonOptions7(input, "POST")
+      jsonOptions8(input, "POST")
     );
   }
   updateFolder(folder, input) {
     return this.client.requestJson(
-      `/api/v2/teamspaces/folders/${selectorValue9(folder)}`,
-      jsonOptions7(input, "PATCH")
+      `/api/v2/teamspaces/folders/${selectorValue10(folder)}`,
+      jsonOptions8(input, "PATCH")
     );
   }
   deleteFolder(folder) {
     return this.client.requestJson(
-      `/api/v2/teamspaces/folders/${selectorValue9(folder)}`,
+      `/api/v2/teamspaces/folders/${selectorValue10(folder)}`,
       { method: "DELETE" }
     );
   }
   publishResource(input) {
     return this.client.requestJson(
       "/api/v2/teamspaces/resources:publish",
-      jsonOptions7(input, "POST")
+      jsonOptions8(input, "POST")
     );
   }
   unpublishResource(resourceId) {
     return this.client.requestJson(
       "/api/v2/teamspaces/resources:unpublish",
-      jsonOptions7({ resourceId }, "POST")
+      jsonOptions8({ resourceId }, "POST")
     );
   }
 };
 
 // src/commands/teamspace.ts
-function getCommandIo11(stdout) {
+function getCommandIo12(stdout) {
   return stdout ?? process.stdout;
 }
-function writeLine11(stdout, value) {
+function writeLine12(stdout, value) {
   stdout.write(`${value}
 `);
 }
-function getGlobalOptions11(command) {
+function getGlobalOptions12(command) {
   return command.optsWithGlobals();
 }
-function emitJson11(stdout, commandName, data, configPath) {
-  writeLine11(
+function emitJson12(stdout, commandName, data, configPath) {
+  writeLine12(
     stdout,
     JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath }))
   );
 }
-function toConfigurationError10(filePath, error) {
+function toConfigurationError11(filePath, error) {
   if (error instanceof CliError) {
     throw error;
   }
@@ -10426,7 +12104,7 @@ function toConfigurationError10(filePath, error) {
 function createTeamspaceApi(command, filePath) {
   try {
     const config = readRuntimeConfig(filePath);
-    const runtime = resolveRuntimeContext(config, getGlobalOptions11(command));
+    const runtime = resolveRuntimeContext(config, getGlobalOptions12(command));
     if (!runtime.baseUrl) {
       throw new CliError(
         "configuration_error",
@@ -10444,10 +12122,10 @@ function createTeamspaceApi(command, filePath) {
       readOnly: runtime.readOnly
     };
   } catch (error) {
-    toConfigurationError10(filePath, error);
+    toConfigurationError11(filePath, error);
   }
 }
-function ensureWritable8(commandName, readOnly, commandMode) {
+function ensureWritable9(commandName, readOnly, commandMode) {
   if (readOnly) {
     throw new CliError(
       "command_not_allowed_in_read_only_mode",
@@ -10459,21 +12137,21 @@ function ensureWritable8(commandName, readOnly, commandMode) {
     );
   }
 }
-function parseUuidOrSlugSelector9(input) {
+function parseUuidOrSlugSelector10(input) {
   try {
     return normalizeUuidOrSlug(input);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Invalid selector.";
-    throw new InvalidArgumentError9(message);
+    throw new InvalidArgumentError10(message);
   }
 }
 function parseNonNegativeInteger3(input) {
   if (!/^\d+$/.test(input.trim())) {
-    throw new InvalidArgumentError9(`Expected a non-negative integer, received "${input}".`);
+    throw new InvalidArgumentError10(`Expected a non-negative integer, received "${input}".`);
   }
   return Number(input);
 }
-function isJsonObject7(value) {
+function isJsonObject8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseRawJsonObject4(input, sourceLabel) {
@@ -10487,7 +12165,7 @@ function parseRawJsonObject4(input, sourceLabel) {
       `Failed to parse JSON from ${sourceLabel}: ${message}`
     );
   }
-  if (!isJsonObject7(parsed)) {
+  if (!isJsonObject8(parsed)) {
     throw new CliError(
       "invalid_cli_usage",
       `Expected ${sourceLabel} to contain a JSON object.`
@@ -10508,7 +12186,7 @@ function readRawObject5(raw, rawFile) {
   if (rawFile) {
     let contents;
     try {
-      contents = readFileSync9(rawFile, "utf8");
+      contents = readFileSync10(rawFile, "utf8");
     } catch (error) {
       const message = error instanceof Error ? error.message : "Unable to read file.";
       throw new CliError(
@@ -10520,7 +12198,7 @@ function readRawObject5(raw, rawFile) {
   }
   return void 0;
 }
-function isEmptyObject6(value) {
+function isEmptyObject7(value) {
   return Object.keys(value).length === 0;
 }
 function buildFolderCreateInput(options) {
@@ -10551,7 +12229,7 @@ function buildFolderUpdateInput(options) {
   if (props !== void 0) {
     input.additionalProperties = props;
   }
-  if (isEmptyObject6(input)) {
+  if (isEmptyObject7(input)) {
     throw new CliError(
       "invalid_cli_usage",
       'Provide folder updates via "--name", "--order", "--props", or "--props-file".'
@@ -10561,9 +12239,9 @@ function buildFolderUpdateInput(options) {
 }
 function toTableRows5(data) {
   if (Array.isArray(data)) {
-    return data.map((entry) => isJsonObject7(entry) ? entry : { value: entry });
+    return data.map((entry) => isJsonObject8(entry) ? entry : { value: entry });
   }
-  if (isJsonObject7(data)) {
+  if (isJsonObject8(data)) {
     return [data];
   }
   return [{ value: data }];
@@ -10625,85 +12303,91 @@ async function resolveFolderSelector2(api, selector) {
 }
 function registerTeamspaceCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
-  const stdout = getCommandIo11(options.stdout);
+  const stdout = getCommandIo12(options.stdout);
   const teamspace = program.command("teamspace").description("Manage teamspace folders and resources");
   const folders = teamspace.command("folders").description("Manage teamspace folders");
-  folders.command("list").description("List teamspace folders").option("--include-resources", "include nested resources").action(async function action(commandOptions) {
+  folders.command("list").description("List teamspace folders").option("--include-resources", "include the published resources inside each folder").action(async function action(commandOptions) {
     const { api, json } = createTeamspaceApi(this, filePath);
     const data = await api.listFolders(Boolean(commandOptions.includeResources));
     if (json) {
-      emitJson11(stdout, "teamspace folders list", data, filePath);
+      emitJson12(stdout, "teamspace folders list", data, filePath);
       return;
     }
     emitTable5(stdout, data);
   });
-  folders.command("get").description("Get a teamspace folder by exact name or UUID").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector9).option("--include-resources", "include nested resources").action(async function action(folder, commandOptions) {
+  folders.command("get").description("Get a teamspace folder by exact name or UUID").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector10).option("--include-resources", "include the published resources inside each folder").action(async function action(folder, commandOptions) {
     const { api, json } = createTeamspaceApi(this, filePath);
     const resolvedFolder = await resolveFolderSelector2(api, folder);
     const allFolders = await api.listFolders(Boolean(commandOptions.includeResources));
     const data = findFolderEntity(allFolders, resolvedFolder);
     if (json) {
-      emitJson11(stdout, "teamspace folders get", data, filePath);
+      emitJson12(stdout, "teamspace folders get", data, filePath);
       return;
     }
     emitTable5(stdout, data);
   });
-  folders.command("create").description("Create a teamspace folder").requiredOption("--name <name>", "folder name").option("--order <n>", "folder order", parseNonNegativeInteger3).option("--props <json>", "folder properties payload").option("--props-file <path>", "path to a folder properties JSON payload").action(async function action(commandOptions) {
+  folders.command("create").description("Create a teamspace folder").requiredOption("--name <name>", "folder name").option("--order <n>", "display order (lower values appear first)", parseNonNegativeInteger3).option("--props <json>", 'additionalProperties JSON: free-form client metadata, e.g. {"icon":"folder-users","color":"gold"}').option("--props-file <path>", "path to a file with the additionalProperties JSON").action(async function action(commandOptions) {
     const { api, json, readOnly } = createTeamspaceApi(this, filePath);
-    ensureWritable8("teamspace folders create", readOnly, "write");
+    ensureWritable9("teamspace folders create", readOnly, "write");
     const data = await api.createFolder(buildFolderCreateInput(commandOptions));
     if (json) {
-      emitJson11(stdout, "teamspace folders create", data, filePath);
+      emitJson12(stdout, "teamspace folders create", data, filePath);
       return;
     }
-    writeLine11(stdout, `Created folder "${getFolderIdentifier(data)}".`);
+    writeLine12(stdout, `Created folder "${getFolderIdentifier(data)}".`);
   });
-  folders.command("update").description("Update a teamspace folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector9).option("--name <name>", "folder name").option("--order <n>", "folder order", parseNonNegativeInteger3).option("--props <json>", "folder properties payload").option("--props-file <path>", "path to a folder properties JSON payload").action(async function action(folder, commandOptions) {
+  folders.command("update").description("Update a teamspace folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector10).option("--name <name>", "folder name").option("--order <n>", "display order (lower values appear first)", parseNonNegativeInteger3).option("--props <json>", 'additionalProperties JSON: free-form client metadata, e.g. {"icon":"folder-users","color":"gold"}').option("--props-file <path>", "path to a file with the additionalProperties JSON").action(async function action(folder, commandOptions) {
     const { api, json, readOnly } = createTeamspaceApi(this, filePath);
-    ensureWritable8("teamspace folders update", readOnly, "write");
+    ensureWritable9("teamspace folders update", readOnly, "write");
     const resolvedFolder = await resolveFolderSelector2(api, folder);
     const data = await api.updateFolder(resolvedFolder, buildFolderUpdateInput(commandOptions));
     if (json) {
-      emitJson11(stdout, "teamspace folders update", data, filePath);
+      emitJson12(stdout, "teamspace folders update", data, filePath);
       return;
     }
-    writeLine11(stdout, `Updated folder "${getFolderIdentifier(data)}".`);
+    writeLine12(stdout, `Updated folder "${getFolderIdentifier(data)}".`);
   });
-  folders.command("delete").description("Delete a teamspace folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector9).action(async function action(folder) {
+  folders.command("delete").description("Delete a teamspace folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector10).action(async function action(folder) {
     const { api, json, readOnly } = createTeamspaceApi(this, filePath);
-    ensureWritable8("teamspace folders delete", readOnly, "destructive");
+    ensureWritable9("teamspace folders delete", readOnly, "destructive");
     const resolvedFolder = await resolveFolderSelector2(api, folder);
     const data = await api.deleteFolder(resolvedFolder);
     if (json) {
-      emitJson11(stdout, "teamspace folders delete", data, filePath);
+      emitJson12(stdout, "teamspace folders delete", data, filePath);
       return;
     }
-    writeLine11(stdout, `Deleted folder "${resolvedFolder.value}".`);
+    writeLine12(stdout, `Deleted folder "${resolvedFolder.value}".`);
   });
   const resources = teamspace.command("resources").description("Manage teamspace resources");
-  resources.command("publish").description("Publish a resource to a teamspace folder").argument("<resource>", "resource UUID or exact name", parseUuidOrSlugSelector9).requiredOption("--to <folder>", "target folder", parseUuidOrSlugSelector9).action(async function action(resource, commandOptions) {
+  resources.command("publish").description(
+    "Publish a resource to a teamspace folder. Publishing an already-published resource moves it to the new folder."
+  ).argument("<resource>", "schema UUID, schema slug, or display UUID", parseUuidOrSlugSelector10).requiredOption(
+    "--to <folder>",
+    "target folder UUID or exact name (root folder UUID is 00000000-0000-0000-0000-000000000000)",
+    parseUuidOrSlugSelector10
+  ).action(async function action(resource, commandOptions) {
     const { api, json, readOnly } = createTeamspaceApi(this, filePath);
-    ensureWritable8("teamspace resources publish", readOnly, "write");
+    ensureWritable9("teamspace resources publish", readOnly, "write");
     const folder = await resolveFolderSelector2(api, commandOptions.to);
     const data = await api.publishResource({
       resourceId: resource.value,
       targetFolderId: folder.value
     });
     if (json) {
-      emitJson11(stdout, "teamspace resources publish", data, filePath);
+      emitJson12(stdout, "teamspace resources publish", data, filePath);
       return;
     }
-    writeLine11(stdout, `Published resource "${resource.value}" to folder "${folder.value}".`);
+    writeLine12(stdout, `Published resource "${resource.value}" to folder "${folder.value}".`);
   });
-  resources.command("unpublish").description("Unpublish a resource from teamspace").argument("<resource>", "resource UUID or exact name", parseUuidOrSlugSelector9).action(async function action(resource) {
+  resources.command("unpublish").description("Unpublish a resource from teamspace (removes it from its shared folder)").argument("<resource>", "schema UUID, schema slug, or display UUID", parseUuidOrSlugSelector10).action(async function action(resource) {
     const { api, json, readOnly } = createTeamspaceApi(this, filePath);
-    ensureWritable8("teamspace resources unpublish", readOnly, "write");
+    ensureWritable9("teamspace resources unpublish", readOnly, "write");
     const data = await api.unpublishResource(resource.value);
     if (json) {
-      emitJson11(stdout, "teamspace resources unpublish", data, filePath);
+      emitJson12(stdout, "teamspace resources unpublish", data, filePath);
       return;
     }
-    writeLine11(stdout, `Unpublished resource "${resource.value}".`);
+    writeLine12(stdout, `Unpublished resource "${resource.value}".`);
   });
 }
 
@@ -10711,12 +12395,13 @@ function registerTeamspaceCommands(program, options = {}) {
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
 function buildProgram(options = {}) {
-  const program = new Command10();
+  const program = new Command11();
   program.name("zinkee").description("CLI for Zinkee API v2").version(version).enablePositionalOptions().showHelpAfterError().option("--profile <name>", "select a profile from config").option("--base-url <url>", "override the configured base URL").option("--api-key <token>", "override the configured API key").option("--read-only", "run in read-only mode").option("--example", "show examples for a command").option("--json", "emit JSON output").option("--install-completion [shell]", "install shell completion (bash, zsh, fish, powershell)").option("--show-completion [shell]", "print shell completion script for the current shell");
   registerProfilesCommands(program, options);
   registerAutomationsCommands(program, options);
   registerConfigCommands(program, options);
   registerDisplaysCommands(program, options);
+  registerDocumentTemplatesCommands(program, options);
   registerFilesCommands(program, options);
   registerNavigationCommands(program, options);
   registerSchemasCommands(program, options);
@@ -10861,9 +12546,9 @@ function getCompletions(program, request, deps = {}) {
 
 // src/completion/install.ts
 import { execFileSync } from "child_process";
-import { mkdirSync as mkdirSync2, readFileSync as readFileSync10, writeFileSync as writeFileSync3 } from "fs";
+import { mkdirSync as mkdirSync2, readFileSync as readFileSync11, writeFileSync as writeFileSync4 } from "fs";
 import { homedir as homedir2, platform } from "os";
-import { basename as basename2, dirname as dirname2, join as join2 } from "path";
+import { basename as basename3, dirname as dirname2, join as join2 } from "path";
 
 // src/completion/scripts.ts
 var PROGRAM = "zinkee";
@@ -10985,7 +12670,7 @@ function defaultPowerShellProfile(env) {
 function detectShell(env) {
   const fromEnv = env.shellEnv;
   if (fromEnv) {
-    const name = basename2(fromEnv).toLowerCase().replace(/\.exe$/, "");
+    const name = basename3(fromEnv).toLowerCase().replace(/\.exe$/, "");
     if (name === "bash") {
       return "bash";
     }
@@ -11083,7 +12768,7 @@ ${BLOCK_END}
 }
 function readFileOrEmpty(path) {
   try {
-    return readFileSync10(path, "utf8");
+    return readFileSync11(path, "utf8");
   } catch (error) {
     if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
       return "";
@@ -11093,7 +12778,7 @@ function readFileOrEmpty(path) {
 }
 function writeFileEnsuringDir(path, content) {
   mkdirSync2(dirname2(path), { recursive: true });
-  writeFileSync3(path, content, "utf8");
+  writeFileSync4(path, content, "utf8");
 }
 function installCompletion(shell, env) {
   const target = resolveTarget(shell, env);