zinkee 0.1.4 → 0.1.7

package/dist/index.js

@@ -674,6 +674,13 @@ var commandRegistry = {
     supportsRaw: true,
     output: writeOutput
   },
+  "logs list": {
+    command: "logs list",
+    accessLevel: "read",
+    supportsExample: true,
+    supportsRaw: false,
+    output: readOutput
+  },
   "teamspace folders list": {
     command: "teamspace folders list",
     accessLevel: "read",
@@ -1976,7 +1983,8 @@ function buildCommandExample(example) {
   return {
     command: example.command,
     description: example.description,
-    raw: example.raw
+    raw: example.raw,
+    response: example.response
   };
 }
 function buildCommandExamples(examples) {
@@ -1984,339 +1992,3061 @@ function buildCommandExamples(examples) {
 }
 var SAMPLE_UUID = "550e8400-e29b-41d4-a716-446655440001";
 var specificExamples = {
-  "records query": buildCommandExamples([
+  "profiles list": buildCommandExamples([
     {
-      description: "Query records with filters, sort and pagination",
-      command: 'zinkee --json records query contacts --select id,name --where "status eq active" --sort createdAt:desc --limit 20 --offset 0'
+      description: "List all local profiles. The CLI always redacts the apiKey to ******** plus the last 4 chars.",
+      command: "zinkee --json profiles list",
+      response: `[
+  {
+    "name": "prod",
+    "isDefault": true,
+    "apiKey": "********cdef",
+    "baseUrl": "https://api.zinkee.com"
+  },
+  {
+    "name": "local",
+    "isDefault": false,
+    "apiKey": "********4321",
+    "baseUrl": "http://localhost:8088"
+  }
+]`
     }
   ]),
-  "records create": buildCommandExamples([
+  "profiles get": buildCommandExamples([
     {
-      description: "Create a record with simple and structured values",
-      command: `zinkee --json records create contacts --set name=Ana --set-json meta='{"tier":"gold"}'`
+      description: "Show one profile by name.",
+      command: "zinkee --json profiles get prod",
+      response: `{
+  "name": "prod",
+  "isDefault": true,
+  "apiKey": "********cdef",
+  "baseUrl": "https://api.zinkee.com"
+}`
     }
   ]),
-  "files download": buildCommandExamples([
+  "profiles use": buildCommandExamples([
     {
-      description: "Download a file to disk in JSON mode",
-      command: `zinkee --json files download ${SAMPLE_UUID} --output ./download.bin`
+      description: "Set a profile as the default one used when --profile is not passed.",
+      command: "zinkee --json profiles use local",
+      response: `{
+  "profile": "local",
+  "defaultProfile": "local"
+}`
     }
   ]),
-  "navigation resources move": buildCommandExamples([
+  "profiles add": buildCommandExamples([
     {
-      description: "Move a resource into a navigation folder by exact folder name",
-      command: `zinkee --json navigation resources move ${SAMPLE_UUID} --type schema --to Finance`
+      description: "Add a new profile with an explicit base URL. Becomes the default if no other profile existed.",
+      command: "zinkee --json profiles add prod --api-key sk-prod-9f3a2c1b-1234567890abcdef --base-url https://api.zinkee.com",
+      response: `{
+  "name": "prod",
+  "isDefault": true,
+  "apiKey": "********cdef",
+  "baseUrl": "https://api.zinkee.com"
+}`
+    },
+    {
+      description: "Add a profile without --base-url (the runtime falls back to the production URL at call time).",
+      command: "zinkee --json profiles add staging --api-key sk-staging-7777aaaa-bbbbccccddddeeee",
+      response: `{
+  "name": "staging",
+  "isDefault": false,
+  "apiKey": "********eeee"
+}`
     }
   ]),
-  "teamspace resources publish": buildCommandExamples([
+  "profiles update": buildCommandExamples([
+    {
+      description: "Rotate just the API key of an existing profile.",
+      command: "zinkee --json profiles update prod --api-key sk-prod-0000new0-fedcba0987654321",
+      response: `{
+  "name": "prod",
+  "isDefault": true,
+  "apiKey": "********4321",
+  "baseUrl": "https://api.zinkee.com"
+}`
+    },
     {
-      description: "Publish a resource into a teamspace folder",
-      command: `zinkee --json teamspace resources publish ${SAMPLE_UUID} --to "Customer Success"`
+      description: "Point an existing profile at a different base URL (useful when moving envs).",
+      command: "zinkee --json profiles update local --base-url http://localhost:9090",
+      response: `{
+  "name": "local",
+  "isDefault": false,
+  "apiKey": "********4321",
+  "baseUrl": "http://localhost:9090"
+}`
     }
   ]),
-  "displays widgets create": buildCommandExamples([
+  "profiles remove": buildCommandExamples([
     {
-      description: "Create a chart widget through the generic --type path",
-      command: 'zinkee --json displays widgets create display-1 --type chart --name "Revenue" --chart-type bar'
+      description: "Remove a profile. If it was the default, defaultProfile becomes null and you should set a new one with profiles use.",
+      command: "zinkee --json profiles remove staging",
+      response: `{
+  "profile": "staging",
+  "defaultProfile": "prod"
+}`
     }
   ]),
-  "automations create": buildCommandExamples([
+  "config path": buildCommandExamples([
     {
-      description: "Create a scheduled automation with a six-field cron expression. This is the safest first example because it does not depend on workspace schemas.",
-      command: 'zinkee --json automations create --name "Nightly invoice sync" --trigger-type scheduled --cron "0 15 10 * * 1"',
-      raw: `{
-  "name": "Nightly invoice sync",
-  "trigger": {
-    "type": "scheduled",
-    "config": {
-      "cronExpression": "0 15 10 * * 1"
+      description: "Print the path of the config file the CLI is reading right now.",
+      command: "zinkee --json config path",
+      response: `{
+  "path": "/home/guillermo/.config/zinkee/config.json"
+}`
+    }
+  ]),
+  "config show": buildCommandExamples([
+    {
+      description: "Dump the whole config with secrets redacted. Same ******** + last 4 chars mask that profiles list uses.",
+      command: "zinkee --json config show",
+      response: `{
+  "defaultProfile": "prod",
+  "profiles": {
+    "prod": {
+      "apiKey": "********cdef",
+      "baseUrl": "https://api.zinkee.com"
+    },
+    "local": {
+      "apiKey": "********4321",
+      "baseUrl": "http://localhost:8088"
     }
   }
 }`
-    },
+    }
+  ]),
+  "config validate": buildCommandExamples([
     {
-      description: "Create a record-created automation using a real schema slug or UUID. Replace 'leads' with a schema from 'zinkee --json schemas list'.",
-      command: 'zinkee --json automations create --name "Lead welcome" --trigger-type record_created --trigger-schema leads',
-      raw: `{
-  "name": "Lead welcome",
-  "trigger": {
-    "type": "record_created",
-    "config": {
-      "schemaId": "leads"
+      description: "Validate that the local config resolves a profile. Useful as a CI gate before running other commands.",
+      command: "zinkee --json config validate",
+      response: `{
+  "valid": true,
+  "profile": "prod"
+}`
     }
+  ]),
+  "schemas create": buildCommandExamples([
+    {
+      description: "Create an auditable and commentable schema from flags.",
+      command: 'zinkee --json schemas create --name "Codex Demo" --slug codex-demo --auditable --commentable',
+      raw: `{
+  "name": "Codex Demo",
+  "slug": "codex-demo",
+  "auditable": true,
+  "commentable": true
+}`,
+      response: `{
+  "schemaId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+  "slug": "codex-demo",
+  "folder": {
+    "id": "00000000-0000-0000-0000-000000000000",
+    "name": "root",
+    "isRoot": true
   }
 }`
     },
     {
-      description: "Create a record-changed automation using real schema and field slugs or UUIDs. Replace 'orders' and 'status' with values from your workspace.",
-      command: 'zinkee --json automations create --name "Order status sync" --trigger-type record_changed --trigger-schema orders --trigger-field status',
+      description: "Minimal create with just name and slug.",
+      command: "zinkee --json schemas create --name Leads --slug leads",
       raw: `{
-  "name": "Order status sync",
-  "trigger": {
-    "type": "record_changed",
-    "config": {
-      "schemaId": "orders",
-      "fieldIds": ["status"]
-    }
-  }
+  "name": "Leads",
+  "slug": "leads"
+}`
+    },
+    {
+      description: "Create an auditable schema inside an existing navigation folder (folder id can be a UUID or the exact folder name).",
+      command: "zinkee --json schemas create --name Tasks --slug tasks --auditable --folder 7f4e7c25-d8b2-4c1a-9f3e-6a7b5c8d9e1f",
+      raw: `{
+  "name": "Tasks",
+  "slug": "tasks",
+  "auditable": true,
+  "commentable": false,
+  "folderId": "7f4e7c25-d8b2-4c1a-9f3e-6a7b5c8d9e1f"
 }`
     }
   ]),
-  "automations update": buildCommandExamples([
+  "schemas update": buildCommandExamples([
     {
-      description: "Patch automation metadata using the backend set/unset contract",
-      command: `zinkee --json automations update automation-1 --raw '{"set":{"description":"Updated by CLI docs"},"unset":["folderId"]}'`,
+      description: "Rename a schema and change its slug.",
+      command: 'zinkee --json schemas update contacts --name "Customer Contacts" --slug customer-contacts',
       raw: `{
   "set": {
-    "description": "Updated by CLI docs"
+    "name": "Customer Contacts",
+    "slug": "customer-contacts"
+  }
+}`,
+      response: `{
+  "id": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+  "name": "Customer Contacts",
+  "slug": "customer-contacts",
+  "folder": {
+    "id": "7f4e7c25-d8b2-4c1a-9f3e-6a7b5c8d9e1f",
+    "name": "Customers",
+    "isRoot": false
   },
-  "unset": ["folderId"]
+  "auditable": true,
+  "commentable": true,
+  "fields": []
+}`
+    },
+    {
+      description: "Enable the audit log on a schema.",
+      command: "zinkee --json schemas update contacts --auditable true",
+      raw: `{
+  "set": {
+    "auditable": true
+  }
+}`
+    },
+    {
+      description: "Toggle commentable off.",
+      command: "zinkee --json schemas update contacts --commentable false",
+      raw: `{
+  "set": {
+    "commentable": false
+  }
 }`
     }
   ]),
-  "automations trigger set": buildCommandExamples([
+  "schemas fields update": buildCommandExamples([
     {
-      description: "Replace the trigger with a scheduled trigger",
-      command: 'zinkee --json automations trigger set automation-1 --trigger-type scheduled --cron "0 0 9 * * *"',
+      description: "Rename a field label and drop the required flag.",
+      command: 'zinkee --json schemas fields update contacts contact-name --label "Customer Full Name" --required false',
       raw: `{
-  "type": "scheduled",
-  "config": {
-    "cronExpression": "0 0 9 * * *"
-  }
+  "set": {
+    "label": "Customer Full Name",
+    "required": false
+  }
+}`,
+      response: `{
+  "schemaId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+  "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+  "slug": "customer-full-name"
 }`
     },
     {
-      description: "Replace the trigger with a record-changed trigger and a literal condition",
-      command: "zinkee --json automations trigger set automation-1 --trigger-type record_changed --trigger-schema orders --trigger-field status --condition status:eq:approved",
+      description: "Make a field required.",
+      command: "zinkee --json schemas fields update contacts status --required true",
       raw: `{
-  "type": "record_changed",
-  "config": {
-    "schemaId": "orders",
-    "fieldIds": ["status"],
-    "conditions": [
-      {
-        "field": "status",
-        "comparator": "eq",
-        "values": [
-          {
-            "rawValue": "approved",
-            "source": null
-          }
-        ]
-      }
-    ]
+  "set": {
+    "required": true
   }
 }`
     },
     {
-      description: "Replace the trigger with a webhook trigger using an existing webhook endpoint id",
-      command: "zinkee --json automations trigger set automation-1 --trigger-type webhook --webhook-endpoint-id 550e8400-e29b-41d4-a716-446655440001",
+      description: "Patch the format options of a number field through a raw set payload (no dedicated flag exists for nested config paths).",
+      command: `zinkee --json schemas fields update contacts amount --raw '{"set":{"config":{"formatOptions":{"format":"percent","decimals":1}}}}'`,
       raw: `{
-  "type": "webhook",
-  "config": {
-    "webhookEndpointId": "550e8400-e29b-41d4-a716-446655440001"
+  "set": {
+    "config": {
+      "formatOptions": {
+        "format": "percent",
+        "decimals": 1
+      }
+    }
   }
 }`
     }
   ]),
-  "automations actions add": buildCommandExamples([
+  "records query": buildCommandExamples([
     {
-      description: "Add a create-record action with literal and trigger-based field mappings",
-      command: `zinkee --json automations actions add automation-1 --type create_record --name "Create follow-up" --target-schema followups --map status=pending --map-json owner='{"rawValue":null,"source":{"type":"TRIGGER","id":"payload_value"}}'`,
+      description: "Lookup a single record by id.",
+      command: 'zinkee --json records query contacts --select id,contact-name --where "id eq 550e8400-e29b-41d4-a716-446655440000" --sort id:desc --limit 10',
       raw: `{
-  "type": "create_record",
-  "name": "Create follow-up",
-  "config": {
-    "targetSchemaId": "followups",
-    "fieldMapping": {
-      "status": {
-        "rawValue": "pending",
-        "source": null
-      },
-      "owner": {
-        "rawValue": null,
-        "source": {
-          "type": "TRIGGER",
-          "id": "payload_value"
-        }
+  "select": ["id", "contact-name"],
+  "where": [
+    { "field": "id", "op": "eq", "value": "550e8400-e29b-41d4-a716-446655440000" }
+  ],
+  "sort": [
+    { "field": "id", "direction": "DESC" }
+  ],
+  "page": { "offset": 0, "size": 10 }
+}`,
+      response: `{
+  "records": [
+    {
+      "recordId": "550e8400-e29b-41d4-a716-446655440000",
+      "values": {
+        "contact-name": "Ada Lovelace",
+        "status": 2,
+        "amount": 1250.50
       }
     }
+  ],
+  "page": {
+    "offset": 0,
+    "limit": 25,
+    "total": 1,
+    "count": 1,
+    "hasMore": false
   }
 }`
     },
     {
-      description: "Add a search-records action with a trigger-based condition",
-      command: `zinkee --json automations actions add automation-1 --type search_records --name "Find duplicates" --target-schema followups --condition-json '{"field":"email","comparator":"eq","values":[{"rawValue":null,"source":{"type":"TRIGGER","id":"payload_value"}}]}'`,
+      description: "Filter by multiple conditions and sort by amount then name.",
+      command: `zinkee --json records query contacts --select id,contact-name,status,amount --where "status in 1,2" --where "amount gte 500" --sort amount:desc --sort contact-name:asc --limit 25`,
       raw: `{
-  "type": "search_records",
-  "name": "Find duplicates",
-  "config": {
-    "targetSchemaId": "followups",
-    "conditions": [
-      {
-        "field": "email",
-        "comparator": "eq",
-        "values": [
-          {
-            "rawValue": null,
-            "source": {
-              "type": "TRIGGER",
-              "id": "payload_value"
-            }
-          }
-        ]
-      }
-    ]
-  }
+  "select": ["id", "contact-name", "status", "amount"],
+  "where": [
+    { "field": "status", "op": "in", "value": [1, 2] },
+    { "field": "amount", "op": "gte", "value": 500 }
+  ],
+  "sort": [
+    { "field": "amount", "direction": "DESC" },
+    { "field": "contact-name", "direction": "ASC" }
+  ],
+  "page": { "offset": 0, "size": 25 }
 }`
     },
     {
-      description: "Add an HTTP request action through the generic --type path",
-      command: "zinkee --json automations actions add automation-1 --type http_request --name Notify --method POST --url https://example.com/hook --content-type application/json",
+      description: "Text contains search.",
+      command: 'zinkee --json records query contacts --select id,contact-name,contact-email --where "contact-name contains Lovelace" --limit 50',
       raw: `{
-  "type": "http_request",
-  "name": "Notify",
-  "config": {
-    "method": "POST",
-    "url": "https://example.com/hook",
-    "contentType": "application/json"
-  }
+  "select": ["id", "contact-name", "contact-email"],
+  "where": [
+    { "field": "contact-name", "op": "contains", "value": "Lovelace" }
+  ],
+  "page": { "offset": 0, "size": 50 }
 }`
     },
     {
-      description: "Add an execute-plugin action with structured plugin arguments. Replace 'clone-budget' with an active id from 'zinkee --json automations plugins list'.",
-      command: `zinkee --json automations actions add automation-1 --type execute_plugin --name "Run plugin" --plugin clone-budget --arg mode=safe --arg-json payload='{"dryRun":true}'`,
+      description: "Records with a non-empty due-date inside a date range.",
+      command: 'zinkee --json records query contacts --where "due-date is_not_empty" --where "due-date lte 2026-12-31T23:59:59Z" --sort due-date:asc',
       raw: `{
-  "type": "execute_plugin",
-  "name": "Run plugin",
-  "config": {
-    "pluginId": "clone-budget",
-    "pluginArgs": {
-      "mode": "safe",
-      "payload": {
-        "dryRun": true
-      }
-    }
-  }
+  "where": [
+    { "field": "due-date", "op": "is_not_empty" },
+    { "field": "due-date", "op": "lte", "value": "2026-12-31T23:59:59Z" }
+  ],
+  "sort": [
+    { "field": "due-date", "direction": "ASC" }
+  ]
+}`
+    },
+    {
+      description: "Records whose status is not equal to a value.",
+      command: 'zinkee --json records query contacts --where "status neq 0"',
+      raw: `{
+  "where": [
+    { "field": "status", "op": "neq", "value": 0 }
+  ]
+}`
+    },
+    {
+      description: "Records with an amount greater than a threshold.",
+      command: 'zinkee --json records query contacts --where "amount gt 1000"',
+      raw: `{
+  "where": [
+    { "field": "amount", "op": "gt", "value": 1000 }
+  ]
+}`
+    },
+    {
+      description: "Records with an amount less than a threshold.",
+      command: 'zinkee --json records query contacts --where "amount lt 100"',
+      raw: `{
+  "where": [
+    { "field": "amount", "op": "lt", "value": 100 }
+  ]
+}`
+    },
+    {
+      description: "Records whose due-date is empty.",
+      command: 'zinkee --json records query contacts --where "due-date is_empty"',
+      raw: `{
+  "where": [
+    { "field": "due-date", "op": "is_empty" }
+  ]
+}`
+    },
+    {
+      description: "Records whose contact-email is not empty.",
+      command: 'zinkee --json records query contacts --where "contact-email is_not_empty"',
+      raw: `{
+  "where": [
+    { "field": "contact-email", "op": "is_not_empty" }
+  ]
 }`
     }
   ]),
-  "automations actions update": buildCommandExamples([
+  "records create": buildCommandExamples([
     {
-      description: "Update a record action using the trigger record without sending conditions",
-      command: 'zinkee --json automations actions update automation-1 action-1 --type update_record --name "Update trigger record" --target-schema followups --map status=ready --use-trigger-record',
+      description: "Minimal create using just two plain string fields.",
+      command: `zinkee --json records create contacts --set contact-name="Ada Lovelace" --set contact-email=ada@example.com`,
       raw: `{
-  "type": "update_record",
-  "name": "Update trigger record",
-  "config": {
-    "targetSchemaId": "followups",
-    "fieldMapping": {
-      "status": {
-        "rawValue": "ready",
-        "source": null
-      }
+  "values": {
+    "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"
+  }
+}`
     },
-    "useTriggerRecord": true
+    {
+      description: "Create a record mixing text, option, number, date and reference fields. Structured values go through --set-json.",
+      command: `zinkee --json records create contacts --set contact-name="Grace Hopper" --set contact-email=grace@example.com --set-json status=2 --set-json amount=1999.99 --set due-date=2026-06-01T09:00:00Z --set customer-ref=8ad602a1-f6e3-43f6-9ab2-f1c5afc99621 --set owner=6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d`,
+      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": "8ad602a1-f6e3-43f6-9ab2-f1c5afc99621",
+    "owner": "6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d"
   }
 }`
     }
   ]),
-  "automations flow set": buildCommandExamples([
+  "records update": buildCommandExamples([
     {
-      description: "Set flow entry actions and transitions",
-      command: "zinkee --json automations flow set automation-1 --entry action-1 --transition action-1:action-2",
+      description: "Set one field and unset another.",
+      command: 'zinkee --json records update contacts 550e8400-e29b-41d4-a716-446655440000 --set contact-name="Ada Lovelace Updated" --unset contact-email',
       raw: `{
-  "entryActionIds": ["action-1"],
-  "transitions": [
+  "set": {
+    "contact-name": "Ada Lovelace Updated"
+  },
+  "unset": ["contact-email"]
+}`,
+      response: `{
+  "recordId": "550e8400-e29b-41d4-a716-446655440000",
+  "values": {
+    "contact-name": "Ada Lovelace Updated",
+    "status": 2,
+    "amount": 1250.50,
+    "due-date": "2026-05-15T12:00:00Z",
+    "owner": "6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d"
+  }
+}`
+    },
     {
-      "fromActionId": "action-1",
-      "toActionId": "action-2"
-    }
-  ]
+      description: "Patch multiple typed values at once.",
+      command: "zinkee --json records update contacts 550e8400-e29b-41d4-a716-446655440000 --set-json status=3 --set-json amount=2500.00 --set due-date=2026-07-01T09:00:00Z --set owner=6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d",
+      raw: `{
+  "set": {
+    "status": 3,
+    "amount": 2500.00,
+    "due-date": "2026-07-01T09:00:00Z",
+    "owner": "6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d"
+  }
+}`
+    },
+    {
+      description: "Unset only (clear fields).",
+      command: "zinkee --json records update contacts 550e8400-e29b-41d4-a716-446655440000 --unset contact-email --unset due-date",
+      raw: `{
+  "unset": ["contact-email", "due-date"]
 }`
     }
   ]),
-  "automations webhook set": buildCommandExamples([
+  "comments create": buildCommandExamples([
     {
-      description: "Configure webhook ingestion paths and field mappings for a webhook automation. This config is separate from the webhook trigger itself.",
-      command: `zinkee --json automations webhook set automation-1 --active --idempotency-key-path "$.id" --event-type-path "$.type" --allowed-event-type frontend.demo.created --field-mapping '{"variable":"external_id","jsonPath":"$.data.id"}'`,
+      description: "Plain text comment on a record (uses --text).",
+      command: `zinkee --json comments create contacts 550e8400-e29b-41d4-a716-446655440000 --text "This record needs review."`,
       raw: `{
-  "active": true,
-  "idempotencyKeyJsonPath": "$.id",
-  "eventTypeJsonPath": "$.type",
-  "allowedEventTypes": ["frontend.demo.created"],
-  "fieldMappings": [
+  "content": [
     {
-      "variable": "external_id",
-      "jsonPath": "$.data.id"
+      "type": "TEXT",
+      "value": "This record needs review."
     }
   ]
+}`,
+      response: `{
+  "id": "cd8e3b2a-1f5c-4e9a-8b7d-0a2b3c4d5e6f",
+  "recordId": "550e8400-e29b-41d4-a716-446655440000",
+  "createdAt": "2026-04-22T10:15:00Z",
+  "createdBy": "developer@zinkee.com",
+  "content": [
+    { "type": "TEXT", "value": "This record needs review." }
+  ]
 }`
-    }
-  ]),
-  "automations connections create": buildCommandExamples([
+    },
     {
-      description: "Create a stored workspace connection for HTTP request actions",
-      command: `zinkee --json automations connections create --name "ERP API Key" --type api_key --scope workspace --config '{"headerName":"Authorization"}' --secret apiKey=super-secret --active`,
+      description: "Comment with an inline member mention. Mentions only go through --raw today because --text is plain text.",
+      command: `zinkee --json comments create contacts 550e8400-e29b-41d4-a716-446655440000 --raw '{"content":[{"type":"TEXT","value":"Assigning to "},{"type":"MENTION","value":"9f8e7d6c-5b4a-3c2d-1e0f-a1b2c3d4e5f6"},{"type":"TEXT","value":" for follow up."}]}'`,
       raw: `{
-  "name": "ERP API Key",
-  "type": "api_key",
-  "scope": "workspace",
-  "config": {
-    "headerName": "Authorization"
-  },
-  "secret": {
-    "apiKey": "super-secret"
-  },
-  "active": true
+  "content": [
+    { "type": "TEXT", "value": "Assigning to " },
+    { "type": "MENTION", "value": "9f8e7d6c-5b4a-3c2d-1e0f-a1b2c3d4e5f6" },
+    { "type": "TEXT", "value": " for follow up." }
+  ]
 }`
     }
   ]),
-  "automations connections update": buildCommandExamples([
+  "files download": buildCommandExamples([
     {
-      description: "Patch an existing stored connection",
-      command: `zinkee --json automations connections update connection-1 --raw '{"set":{"name":"ERP API Key Updated","config":{"headerName":"Authorization"}}}'`,
-      raw: `{
-  "set": {
-    "name": "ERP API Key Updated",
-    "config": {
-      "headerName": "Authorization"
+      description: "Download a file to disk (the CLI writes the raw bytes to the --output path; the JSON mode only emits a success envelope).",
+      command: `zinkee --json files download ${SAMPLE_UUID} --output ./download.bin`
     }
-  }
+  ]),
+  "files upload": buildCommandExamples([
+    {
+      description: "Upload a local file. The CLI sends the multipart form and the backend returns the generated file id to reference from record FileField values.",
+      command: "zinkee --json files upload ./report.pdf",
+      response: `{
+  "id": "d290f1ee-6c54-4b01-90e6-d701748f0851"
 }`
     }
-  ])
-};
-function fallbackExamples(commandName) {
+  ]),
+  "files delete": buildCommandExamples([
+    {
+      description: "Delete a file from workspace storage. Records that still reference the file id keep the stale pointer until updated separately.",
+      command: `zinkee --json files delete ${SAMPLE_UUID}`,
+      response: `{
+  "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
+  "deleted": true
+}`
+    }
+  ]),
+  "navigation folders create": buildCommandExamples([
+    {
+      description: "Create a folder with a display order and custom properties.",
+      command: `zinkee --json navigation folders create --name Finance --order 20 --props '{"color":"green"}'`,
+      raw: `{
+  "name": "Finance",
+  "order": 20,
+  "additionalProperties": {
+    "color": "green"
+  }
+}`,
+      response: `{
+  "folderId": "c5d6e7f8-9012-3456-789a-bcdef0123456",
+  "name": "Finance"
+}`
+    },
+    {
+      description: "Minimal create with just a name.",
+      command: "zinkee --json navigation folders create --name Archive",
+      raw: `{
+  "name": "Archive"
+}`
+    },
+    {
+      description: "Create a folder with color and icon metadata.",
+      command: `zinkee --json navigation folders create --name Reports --order 5 --props '{"color":"teal","icon":"chart-line"}'`,
+      raw: `{
+  "name": "Reports",
+  "order": 5,
+  "additionalProperties": {
+    "color": "teal",
+    "icon": "chart-line"
+  }
+}`
+    }
+  ]),
+  "navigation folders update": buildCommandExamples([
+    {
+      description: "Rename the folder, change its order, and rewrite its additionalProperties.",
+      command: `zinkee --json navigation folders update Finance --name "Finance Ops" --order 30 --props '{"color":"teal"}'`,
+      raw: `{
+  "name": "Finance Ops",
+  "order": 30,
+  "additionalProperties": {
+    "color": "teal"
+  }
+}`,
+      response: `{
+  "folderId": "84a0fca4-37ef-4c83-a8ed-9ef67ad9324a",
+  "name": "Finance Ops"
+}`
+    },
+    {
+      description: "Rename only.",
+      command: 'zinkee --json navigation folders update Finance --name "Finance (legacy)"',
+      raw: `{
+  "name": "Finance (legacy)"
+}`
+    },
+    {
+      description: "Change only the display order.",
+      command: "zinkee --json navigation folders update Finance --order 1",
+      raw: `{
+  "order": 1
+}`
+    },
+    {
+      description: "Replace only additionalProperties.",
+      command: `zinkee --json navigation folders update Finance --props '{"color":"red","icon":"archive"}'`,
+      raw: `{
+  "additionalProperties": {
+    "color": "red",
+    "icon": "archive"
+  }
+}`
+    }
+  ]),
+  "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",
+      raw: `{
+  "resourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+  "resourceType": "SCHEMA",
+  "targetFolderId": "84a0fca4-37ef-4c83-a8ed-9ef67ad9324a"
+}`,
+      response: `{
+  "resourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+  "targetFolderId": "84a0fca4-37ef-4c83-a8ed-9ef67ad9324a"
+}`
+    },
+    {
+      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",
+      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"
+}`
+    }
+  ]),
+  "teamspace folders create": buildCommandExamples([
+    {
+      description: "Create a teamspace folder with order and icon metadata.",
+      command: `zinkee --json teamspace folders create --name "Customer Success" --order 10 --props '{"icon":"folder-users"}'`,
+      raw: `{
+  "name": "Customer Success",
+  "order": 10,
+  "additionalProperties": {
+    "icon": "folder-users"
+  }
+}`,
+      response: `{
+  "id": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+  "name": "Customer Success",
+  "order": 10,
+  "isRoot": false,
+  "resourceCount": 0,
+  "resources": [],
+  "additionalProperties": {
+    "icon": "folder-users"
+  }
+}`
+    },
+    {
+      description: "Minimal create.",
+      command: "zinkee --json teamspace folders create --name Shared",
+      raw: `{
+  "name": "Shared"
+}`
+    },
+    {
+      description: "Prominent folder with icon and color.",
+      command: `zinkee --json teamspace folders create --name Executive --order 1 --props '{"icon":"crown","color":"gold"}'`,
+      raw: `{
+  "name": "Executive",
+  "order": 1,
+  "additionalProperties": {
+    "icon": "crown",
+    "color": "gold"
+  }
+}`
+    }
+  ]),
+  "teamspace folders update": buildCommandExamples([
+    {
+      description: "Rename, reorder and update properties in one call.",
+      command: `zinkee --json teamspace folders update "Customer Success" --name "Shared KPIs" --order 5 --props '{"icon":"chart-bar"}'`,
+      raw: `{
+  "name": "Shared KPIs",
+  "order": 5,
+  "additionalProperties": {
+    "icon": "chart-bar"
+  }
+}`,
+      response: `{
+  "id": "f45a251d-3ea0-4b41-bfe8-c0f44c8ad54a",
+  "name": "Shared KPIs",
+  "order": 5,
+  "isRoot": false,
+  "resourceCount": 1,
+  "resources": [
+    {
+      "id": "0f6f062f-1478-4df2-96a1-c495d037d260",
+      "name": "Executive Revenue",
+      "type": "DISPLAY"
+    }
+  ],
+  "additionalProperties": {
+    "icon": "chart-bar"
+  }
+}`
+    },
+    {
+      description: "Rename only.",
+      command: 'zinkee --json teamspace folders update "Customer Success" --name "Shared Analytics"',
+      raw: `{
+  "name": "Shared Analytics"
+}`
+    },
+    {
+      description: "Reorder only.",
+      command: 'zinkee --json teamspace folders update "Customer Success" --order 2',
+      raw: `{
+  "order": 2
+}`
+    },
+    {
+      description: "Update only the icon metadata.",
+      command: `zinkee --json teamspace folders update "Customer Success" --props '{"icon":"chart-line"}'`,
+      raw: `{
+  "additionalProperties": {
+    "icon": "chart-line"
+  }
+}`
+    }
+  ]),
+  "teamspace resources publish": buildCommandExamples([
+    {
+      description: "Publish a schema by slug into a teamspace folder.",
+      command: 'zinkee --json teamspace resources publish customer-records --to "Shared Dashboards"',
+      raw: `{
+  "resourceId": "customer-records",
+  "targetFolderId": "f45a251d-3ea0-4b41-bfe8-c0f44c8ad54a"
+}`,
+      response: `{
+  "resourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+  "targetFolder": {
+    "id": "f45a251d-3ea0-4b41-bfe8-c0f44c8ad54a",
+    "name": "Shared Dashboards",
+    "isRoot": false
+  },
+  "previousFolder": null
+}`
+    },
+    {
+      description: "Publish a schema by UUID.",
+      command: 'zinkee --json teamspace resources publish 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --to "Shared Dashboards"',
+      raw: `{
+  "resourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+  "targetFolderId": "f45a251d-3ea0-4b41-bfe8-c0f44c8ad54a"
+}`
+    },
+    {
+      description: "Publish a display.",
+      command: 'zinkee --json teamspace resources publish 0f6f062f-1478-4df2-96a1-c495d037d260 --to "Shared Dashboards"',
+      raw: `{
+  "resourceId": "0f6f062f-1478-4df2-96a1-c495d037d260",
+  "targetFolderId": "f45a251d-3ea0-4b41-bfe8-c0f44c8ad54a"
+}`
+    },
+    {
+      description: "Publish directly at the teamspace root (root folder UUID is always 00000000-0000-0000-0000-000000000000).",
+      command: "zinkee --json teamspace resources publish customer-records --to 00000000-0000-0000-0000-000000000000",
+      raw: `{
+  "resourceId": "customer-records",
+  "targetFolderId": "00000000-0000-0000-0000-000000000000"
+}`
+    }
+  ]),
+  "teamspace resources unpublish": buildCommandExamples([
+    {
+      description: "Unpublish a schema by slug.",
+      command: "zinkee --json teamspace resources unpublish customer-records",
+      raw: `{
+  "resourceId": "customer-records"
+}`,
+      response: `{
+  "resourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+  "removedFromFolder": {
+    "id": "f45a251d-3ea0-4b41-bfe8-c0f44c8ad54a",
+    "name": "Shared Dashboards",
+    "isRoot": false
+  }
+}`
+    },
+    {
+      description: "Unpublish a schema by UUID.",
+      command: "zinkee --json teamspace resources unpublish 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+      raw: `{
+  "resourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e"
+}`
+    },
+    {
+      description: "Unpublish a display.",
+      command: "zinkee --json teamspace resources unpublish 0f6f062f-1478-4df2-96a1-c495d037d260",
+      raw: `{
+  "resourceId": "0f6f062f-1478-4df2-96a1-c495d037d260"
+}`
+    }
+  ]),
+  "displays create": buildCommandExamples([
+    {
+      description: "Create a freeform display with an initial widget layout. Freeform layouts travel through --freeform-layouts.",
+      command: `zinkee --json displays create --name "Control Proyecto Freeform" --template freeform --freeform-layouts '{"lg":[{"i":"widget-1","x":0,"y":0,"w":6,"h":5}]}'`,
+      raw: `{
+  "name": "Control Proyecto Freeform",
+  "layout": {
+    "template": "freeform",
+    "freeformLayouts": {
+      "lg": [
+        { "i": "widget-1", "x": 0, "y": 0, "w": 6, "h": 5 }
+      ]
+    }
+  }
+}`,
+      response: `{
+  "displayId": "0f6f062f-1478-4df2-96a1-c495d037d260"
+}`
+    },
+    {
+      description: "Create a tabbed display using the widget_row_tabs template.",
+      command: 'zinkee --json displays create --name "Executive Revenue" --template widget_row_tabs',
+      raw: `{
+  "name": "Executive Revenue",
+  "layout": {
+    "template": "widget_row_tabs"
+  }
+}`
+    },
+    {
+      description: "Create a grid display.",
+      command: 'zinkee --json displays create --name "Customer Detail" --template grid',
+      raw: `{
+  "name": "Customer Detail",
+  "layout": {
+    "template": "grid"
+  }
+}`
+    }
+  ]),
+  "displays tabs create": buildCommandExamples([
+    {
+      description: "Create a horizontal tab.",
+      command: "zinkee --json displays tabs create 0f6f062f-1478-4df2-96a1-c495d037d260 --name Overview --orientation horizontal",
+      raw: `{
+  "name": "Overview",
+  "orientation": "horizontal"
+}`,
+      response: `{
+  "displayId": "0f6f062f-1478-4df2-96a1-c495d037d260",
+  "tabId": "tab-overview"
+}`
+    },
+    {
+      description: "Create a vertical tab.",
+      command: "zinkee --json displays tabs create 0f6f062f-1478-4df2-96a1-c495d037d260 --name Details --orientation vertical",
+      raw: `{
+  "name": "Details",
+  "orientation": "vertical"
+}`
+    }
+  ]),
+  "displays tabs update": buildCommandExamples([
+    {
+      description: "Rename a tab.",
+      command: 'zinkee --json displays tabs update 0f6f062f-1478-4df2-96a1-c495d037d260 tab-main --name "Overview (renamed)"',
+      raw: `{
+  "name": "Overview (renamed)"
+}`,
+      response: `{
+  "displayId": "0f6f062f-1478-4df2-96a1-c495d037d260",
+  "tabId": "tab-main"
+}`
+    },
+    {
+      description: "Change orientation only.",
+      command: "zinkee --json displays tabs update 0f6f062f-1478-4df2-96a1-c495d037d260 tab-main --orientation vertical",
+      raw: `{
+  "orientation": "vertical"
+}`
+    },
+    {
+      description: "Rename and reorient at once.",
+      command: "zinkee --json displays tabs update 0f6f062f-1478-4df2-96a1-c495d037d260 tab-main --name Details --orientation vertical",
+      raw: `{
+  "name": "Details",
+  "orientation": "vertical"
+}`
+    }
+  ]),
+  "displays variables create": buildCommandExamples([
+    {
+      description: "Create a single-select REFERENCE variable bound to a (schema, field) pair. schemaId and fieldId accept slugs or UUIDs.",
+      command: 'zinkee --json displays variables create 0f6f062f-1478-4df2-96a1-c495d037d260 --type REFERENCE --name Customer --source-schema contacts --source-field contact-name --default ""',
+      raw: `{
+  "type": "REFERENCE",
+  "name": "Customer",
+  "source": {
+    "schemaId": "contacts",
+    "fieldId": "contact-name"
+  },
+  "defaultValue": "",
+  "allowMultiple": false,
+  "staticVariable": false,
+  "filters": []
+}`,
+      response: `{
+  "displayId": "0f6f062f-1478-4df2-96a1-c495d037d260",
+  "variableId": "aaaaaaaa-1111-4111-a111-111111111111"
+}`
+    },
+    {
+      description: "Create a multi-select REFERENCE variable with a filter. Complex filters go via --raw because --filter only accepts raw expressions.",
+      command: `zinkee --json displays variables create 0f6f062f-1478-4df2-96a1-c495d037d260 --raw '{"type":"REFERENCE","name":"Active customers","source":{"schemaId":"contacts","fieldId":"contact-name"},"defaultValues":[],"allowMultiple":true,"staticVariable":false,"filters":[{"origin":{"schemaId":"contacts","fieldId":"status"},"comparisonOperator":"ANY_OF","values":["1","2"]}]}'`,
+      raw: `{
+  "type": "REFERENCE",
+  "name": "Active customers",
+  "source": {
+    "schemaId": "contacts",
+    "fieldId": "contact-name"
+  },
+  "defaultValues": [],
+  "allowMultiple": true,
+  "staticVariable": false,
+  "filters": [
+    {
+      "origin": {
+        "schemaId": "contacts",
+        "fieldId": "status"
+      },
+      "comparisonOperator": "ANY_OF",
+      "values": ["1", "2"]
+    }
+  ]
+}`
+    },
+    {
+      description: "Create a MEMBER variable with a default user id.",
+      command: "zinkee --json displays variables create 0f6f062f-1478-4df2-96a1-c495d037d260 --type MEMBER --name Owner --default 6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d",
+      raw: `{
+  "type": "MEMBER",
+  "name": "Owner",
+  "defaultValue": "6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d",
+  "allowMultiple": false,
+  "staticVariable": false
+}`
+    },
+    {
+      description: "Create a DATE variable using a dynamic period (thisMonth).",
+      command: "zinkee --json displays variables create 0f6f062f-1478-4df2-96a1-c495d037d260 --type DATE --name Period --date-mode dynamic --date-dynamic-option thisMonth",
+      raw: `{
+  "type": "DATE",
+  "name": "Period",
+  "date": {
+    "mode": "dynamic",
+    "dynamicOption": "thisMonth"
+  }
+}`
+    },
+    {
+      description: "Create a DATE variable with a specific date.",
+      command: "zinkee --json displays variables create 0f6f062f-1478-4df2-96a1-c495d037d260 --type DATE --name Cutoff --date-mode specific --date-specific 2026-04-22",
+      raw: `{
+  "type": "DATE",
+  "name": "Cutoff",
+  "date": {
+    "mode": "specific",
+    "specificDate": "2026-04-22"
+  }
+}`
+    },
+    {
+      description: "Create a DATE variable with a custom range.",
+      command: "zinkee --json displays variables create 0f6f062f-1478-4df2-96a1-c495d037d260 --type DATE --name Quarter --date-mode range --date-range-start 2026-04-01 --date-range-end 2026-06-30",
+      raw: `{
+  "type": "DATE",
+  "name": "Quarter",
+  "date": {
+    "mode": "range",
+    "rangeStart": "2026-04-01",
+    "rangeEnd": "2026-06-30"
+  }
+}`
+    }
+  ]),
+  "displays variables update": buildCommandExamples([
+    {
+      description: "Rename the variable and make it static (defaults must be cleared with a raw patch because the CLI has no --default-values [] shortcut).",
+      command: `zinkee --json displays variables update 0f6f062f-1478-4df2-96a1-c495d037d260 aaaaaaaa-1111-4111-a111-111111111111 --raw '{"name":"Proyecto principal","staticVariable":true,"defaultValues":[]}'`,
+      raw: `{
+  "name": "Proyecto principal",
+  "staticVariable": true,
+  "defaultValues": []
+}`,
+      response: `{
+  "displayId": "0f6f062f-1478-4df2-96a1-c495d037d260",
+  "variableId": "aaaaaaaa-1111-4111-a111-111111111111"
+}`
+    },
+    {
+      description: "Replace the reference filters of the variable.",
+      command: `zinkee --json displays variables update 0f6f062f-1478-4df2-96a1-c495d037d260 aaaaaaaa-1111-4111-a111-111111111111 --raw '{"filters":[{"origin":{"schemaId":"contacts","fieldId":"status"},"comparisonOperator":"ANY_OF","values":["2","3"]}]}'`,
+      raw: `{
+  "filters": [
+    {
+      "origin": {
+        "schemaId": "contacts",
+        "fieldId": "status"
+      },
+      "comparisonOperator": "ANY_OF",
+      "values": ["2", "3"]
+    }
+  ]
+}`
+    },
+    {
+      description: "Switch a variable to multi-select.",
+      command: `zinkee --json displays variables update 0f6f062f-1478-4df2-96a1-c495d037d260 aaaaaaaa-1111-4111-a111-111111111111 --allow-multiple --raw '{"defaultValues":[]}'`,
+      raw: `{
+  "allowMultiple": true,
+  "defaultValues": []
+}`
+    },
+    {
+      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",
+      raw: `{
+  "date": {
+    "mode": "dynamic",
+    "dynamicOption": "lastWeek"
+  }
+}`
+    }
+  ]),
+  "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"}'`,
+      raw: `{
+  "type": "TABLE_OR_SUBTABLE",
+  "source": {
+    "originResourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+    "isOriginSubSchema": false
+  },
+  "placement": {
+    "layout": { "x": 0, "y": 0, "w": 12, "h": 8 }
+  },
+  "presentation": {
+    "name": "Customers"
+  },
+  "query": {
+    "sorts": [
+      { "fieldId": "id", "direction": "DESC" }
+    ]
+  },
+  "view": {
+    "fields": ["id", "contact-name", "status"]
+  }
+}`,
+      response: `{
+  "displayId": "0f6f062f-1478-4df2-96a1-c495d037d260",
+  "widgetId": "11111111-1111-4111-a111-111111111111"
+}`
+    },
+    {
+      description: "Create a DETAIL widget on a tab. The rich placement is easier via --raw.",
+      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --raw '{"type":"DETAIL","source":{"originResourceId":"2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e","isOriginSubSchema":false},"placement":{"tabId":"tab-detail","layout":{"x":0,"y":0,"w":6,"h":10}},"presentation":{"name":"Customer detail"},"behavior":{"readOnly":true},"view":{"fields":["contact-name","contact-email","status","amount"]}}'`,
+      raw: `{
+  "type": "DETAIL",
+  "source": {
+    "originResourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+    "isOriginSubSchema": false
+  },
+  "placement": {
+    "tabId": "tab-detail",
+    "layout": { "x": 0, "y": 0, "w": 6, "h": 10 }
+  },
+  "presentation": { "name": "Customer detail" },
+  "behavior": { "readOnly": true },
+  "view": {
+    "fields": ["contact-name", "contact-email", "status", "amount"]
+  }
+}`
+    },
+    {
+      description: "Create a KPI widget computing SUM(amount).",
+      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type KPI --name "Total revenue" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":3,"h":3}' --calc SUM --calc-field amount --kpi-config '{"format":"currency","decimals":2}'`,
+      raw: `{
+  "type": "KPI",
+  "source": {
+    "originResourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+    "isOriginSubSchema": false
+  },
+  "placement": {
+    "layout": { "x": 0, "y": 0, "w": 3, "h": 3 }
+  },
+  "presentation": { "name": "Total revenue" },
+  "kpi": {
+    "typeCalc": "SUM",
+    "fieldCalc": "amount",
+    "config": { "format": "currency", "decimals": 2 }
+  }
+}`
+    },
+    {
+      description: "Create a bar 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 bar --x-axis-field due-date --x-axis-date-format MONTH --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#4B9CD3","axisType":"BAR"}' --y-axis-serie '{"typeCalc":"COUNT","fieldCalc":"id","color":"#E57373","axisType":"LINE"}' --legend '{"position":"bottom"}'`,
+      raw: `{
+  "type": "CHART",
+  "source": {
+    "originResourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+    "isOriginSubSchema": false
+  },
+  "placement": {
+    "layout": { "x": 0, "y": 0, "w": 8, "h": 6 }
+  },
+  "presentation": { "name": "Revenue by month" },
+  "chart": {
+    "chartType": "bar",
+    "xAxisFieldId": "due-date",
+    "xAxisDateFormat": "MONTH",
+    "xAxisAsTimeSerie": true,
+    "yAxisSeries": [
+      {
+        "typeCalc": "SUM",
+        "fieldCalc": "amount",
+        "color": "#4B9CD3",
+        "axisType": "BAR"
+      },
+      {
+        "typeCalc": "COUNT",
+        "fieldCalc": "id",
+        "color": "#E57373",
+        "axisType": "LINE"
+      }
+    ],
+    "legend": { "position": "bottom" }
+  }
+}`
+    },
+    {
+      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`,
+      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": ["contact-name", "due-date"]
+  }
+}`
+    },
+    {
+      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}}}'`,
+      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 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"}}}'`,
+      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"
+    }
+  }
+}`
+    }
+  ]),
+  "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`,
+      raw: `{
+  "placement": {
+    "layout": { "x": 1, "y": 2, "w": 8, "h": 4 }
+  },
+  "view": {
+    "fields": ["id", "contact-name", "status"]
+  },
+  "presentation": { "name": "Revenue Updated" },
+  "behavior": { "readOnly": true }
+}`,
+      response: `{
+  "displayId": "0f6f062f-1478-4df2-96a1-c495d037d260",
+  "widgetId": "11111111-1111-4111-a111-111111111111"
+}`
+    },
+    {
+      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"]}]}}'`,
+      raw: `{
+  "query": {
+    "filters": [
+      {
+        "origin": {
+          "schemaId": "contacts",
+          "fieldId": "status"
+        },
+        "comparisonOperator": "EQUAL",
+        "values": ["2"]
+      },
+      {
+        "origin": {
+          "schemaId": "contacts",
+          "fieldId": "amount"
+        },
+        "comparisonOperator": "GREATER_OR_EQUAL",
+        "values": ["500"]
+      }
+    ]
+  }
+}`
+    },
+    {
+      description: "Hide the add, delete and filter buttons.",
+      command: "zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 11111111-1111-4111-a111-111111111111 --hide-add-button --hide-delete-button --hide-filter-button",
+      raw: `{
+  "behavior": {
+    "hideAddButton": true,
+    "hideDeleteButton": true,
+    "hideFilterButton": true
+  }
+}`
+    },
+    {
+      description: "Update the KPI aggregation to AVG with one-decimal format.",
+      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 33333333-3333-4333-a333-333333333333 --calc AVG --calc-field amount --kpi-config '{"format":"number","decimals":1}'`,
+      raw: `{
+  "kpi": {
+    "typeCalc": "AVG",
+    "fieldCalc": "amount",
+    "config": { "format": "number", "decimals": 1 }
+  }
+}`
+    },
+    {
+      description: "Replace the chart series with a weekly line.",
+      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 22222222-2222-4222-a222-222222222222 --chart-type line --x-axis-field due-date --x-axis-date-format WEEK --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#2E7D32","axisType":"LINE"}'`,
+      raw: `{
+  "chart": {
+    "chartType": "line",
+    "xAxisFieldId": "due-date",
+    "xAxisDateFormat": "WEEK",
+    "xAxisAsTimeSerie": true,
+    "yAxisSeries": [
+      {
+        "typeCalc": "SUM",
+        "fieldCalc": "amount",
+        "color": "#2E7D32",
+        "axisType": "LINE"
+      }
+    ]
+  }
+}`
+    },
+    {
+      description: "Rewrite the widget bindings (requires --raw because the CLI has no --binding flag).",
+      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 11111111-1111-4111-a111-111111111111 --raw '{"bindings":{"variableMap":{"aaaaaaaa-1111-4111-a111-111111111111":"contact-name","cccccccc-3333-4333-a333-333333333333":"owner"}}}'`,
+      raw: `{
+  "bindings": {
+    "variableMap": {
+      "aaaaaaaa-1111-4111-a111-111111111111": "contact-name",
+      "cccccccc-3333-4333-a333-333333333333": "owner"
+    }
+  }
+}`
+    }
+  ]),
+  "displays navigation-targets create": buildCommandExamples([
+    {
+      description: "Create a navigation target with a visible label.",
+      command: 'zinkee --json displays navigation-targets create 0f6f062f-1478-4df2-96a1-c495d037d260 --source-widget 11111111-1111-4111-a111-111111111111 --target-display ef012345-6789-4abc-8def-0123456789ab --target-variable aaaaaaaa-1111-4111-a111-111111111111 --label "Open customer"',
+      raw: `{
+  "sourceWidgetId": "11111111-1111-4111-a111-111111111111",
+  "targetDisplayId": "ef012345-6789-4abc-8def-0123456789ab",
+  "targetVariableId": "aaaaaaaa-1111-4111-a111-111111111111",
+  "label": "Open customer"
+}`,
+      response: `{
+  "displayId": "0f6f062f-1478-4df2-96a1-c495d037d260",
+  "navigationTargetId": "nav-target-customer"
+}`
+    },
+    {
+      description: "Create a navigation target without a label (uses the target display name).",
+      command: "zinkee --json displays navigation-targets create 0f6f062f-1478-4df2-96a1-c495d037d260 --source-widget 22222222-2222-4222-a222-222222222222 --target-display ef012345-6789-4abc-8def-0123456789ab --target-variable aaaaaaaa-1111-4111-a111-111111111111",
+      raw: `{
+  "sourceWidgetId": "22222222-2222-4222-a222-222222222222",
+  "targetDisplayId": "ef012345-6789-4abc-8def-0123456789ab",
+  "targetVariableId": "aaaaaaaa-1111-4111-a111-111111111111"
+}`
+    }
+  ]),
+  "displays navigation-targets update": buildCommandExamples([
+    {
+      description: "Change just the label.",
+      command: 'zinkee --json displays navigation-targets update 0f6f062f-1478-4df2-96a1-c495d037d260 nav-target-customer --label "Go to customer"',
+      raw: `{
+  "label": "Go to customer"
+}`,
+      response: `{
+  "displayId": "0f6f062f-1478-4df2-96a1-c495d037d260",
+  "navigationTargetId": "nav-target-customer"
+}`
+    },
+    {
+      description: "Redirect the target to another display/variable pair.",
+      command: "zinkee --json displays navigation-targets update 0f6f062f-1478-4df2-96a1-c495d037d260 nav-target-customer --target-display 6b7c8d9e-0f12-3456-789a-bcdef0123456 --target-variable bbbbbbbb-2222-4222-a222-222222222222",
+      raw: `{
+  "targetDisplayId": "6b7c8d9e-0f12-3456-789a-bcdef0123456",
+  "targetVariableId": "bbbbbbbb-2222-4222-a222-222222222222"
+}`
+    },
+    {
+      description: "Change the source widget.",
+      command: "zinkee --json displays navigation-targets update 0f6f062f-1478-4df2-96a1-c495d037d260 nav-target-customer --source-widget 44444444-4444-4444-a444-444444444444",
+      raw: `{
+  "sourceWidgetId": "44444444-4444-4444-a444-444444444444"
+}`
+    }
+  ]),
+  "displays cross-widget-filter set": buildCommandExamples([
+    {
+      description: "Link one source widget/field to several target widgets through the same field.",
+      command: "zinkee --json displays cross-widget-filter set 0f6f062f-1478-4df2-96a1-c495d037d260 --source-widget 11111111-1111-4111-a111-111111111111 --source-field c60b8526-5835-4c9f-aecd-9a16c7704a34 --target 22222222-2222-4222-a222-222222222222:c60b8526-5835-4c9f-aecd-9a16c7704a34 --target 33333333-3333-4333-a333-333333333333:c60b8526-5835-4c9f-aecd-9a16c7704a34",
+      raw: `{
+  "source": {
+    "widgetId": "11111111-1111-4111-a111-111111111111",
+    "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+  },
+  "targets": [
+    {
+      "widgetId": "22222222-2222-4222-a222-222222222222",
+      "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+    },
+    {
+      "widgetId": "33333333-3333-4333-a333-333333333333",
+      "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+    }
+  ]
+}`
+    },
+    {
+      description: "Filter one target widget by the status field of the source.",
+      command: "zinkee --json displays cross-widget-filter set 0f6f062f-1478-4df2-96a1-c495d037d260 --source-widget 11111111-1111-4111-a111-111111111111 --source-field a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890 --target 66666666-6666-4666-a666-666666666666:a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+      raw: `{
+  "source": {
+    "widgetId": "11111111-1111-4111-a111-111111111111",
+    "fieldId": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890"
+  },
+  "targets": [
+    {
+      "widgetId": "66666666-6666-4666-a666-666666666666",
+      "fieldId": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890"
+    }
+  ]
+}`
+    }
+  ]),
+  "schemas list": buildCommandExamples([
+    {
+      description: "List schemas in the workspace with folder and field counts.",
+      command: "zinkee --json schemas list",
+      response: `[
+  {
+    "id": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+    "name": "Contacts",
+    "slug": "contacts",
+    "folder": {
+      "id": "7f4e7c25-d8b2-4c1a-9f3e-6a7b5c8d9e1f",
+      "name": "Customers",
+      "isRoot": false
+    },
+    "auditable": false,
+    "commentable": false,
+    "fieldCount": 11
+  },
+  {
+    "id": "5223cbc8-8c6c-4694-93bc-dd176364df9b",
+    "name": "Orders",
+    "slug": "orders",
+    "folder": {
+      "id": "00000000-0000-0000-0000-000000000000",
+      "name": "root",
+      "isRoot": true
+    },
+    "auditable": true,
+    "commentable": true,
+    "fieldCount": 7
+  }
+]`
+    }
+  ]),
+  "schemas get": buildCommandExamples([
+    {
+      description: "Get a schema with all its fields.",
+      command: "zinkee --json schemas get contacts",
+      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,
+  "fields": [
+    {
+      "id": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+      "type": "TextField",
+      "slug": "contact-name",
+      "label": "Customer Name",
+      "required": true,
+      "system": false,
+      "config": {
+        "textType": "LONG",
+        "defaultValue": "Unknown",
+        "conditionalFormatting": []
+      }
+    },
+    {
+      "id": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+      "type": "OptionField",
+      "slug": "status",
+      "label": "Status",
+      "required": false,
+      "system": false,
+      "config": {
+        "options": [
+          { "id": 1, "name": "Open", "color": "default" },
+          { "id": 2, "name": "In Progress", "color": "warning" },
+          { "id": 3, "name": "Done", "color": "success" }
+        ],
+        "defaultValue": 1,
+        "conditionalFormatting": [],
+        "buttonConfig": null
+      }
+    },
+    {
+      "id": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+      "type": "NumberField",
+      "slug": "amount",
+      "label": "Amount",
+      "required": false,
+      "system": false,
+      "config": {
+        "defaultValue": "0",
+        "formatOptions": {
+          "format": "currency",
+          "decimals": 2,
+          "negativesInRed": true,
+          "thousandsSeparator": true,
+          "symbolEnabled": true,
+          "symbolPosition": "before",
+          "symbolValue": "\u20AC"
+        },
+        "conditionalFormatting": []
+      }
+    },
+    {
+      "id": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+      "type": "DateField",
+      "slug": "due-date",
+      "label": "Due Date",
+      "required": false,
+      "system": false,
+      "config": {
+        "defaultValue": null,
+        "formatOptions": {
+          "format": "datetime",
+          "dateFormat": "DD/MM/YYYY",
+          "showTime": true
+        },
+        "conditionalFormatting": []
+      }
+    },
+    {
+      "id": "a7b8c9d0-e1f2-3a4b-5c6d-7e8f90123456",
+      "type": "MemberField",
+      "slug": "owner",
+      "label": "Owner",
+      "required": false,
+      "system": false,
+      "config": {
+        "defaultValue": null,
+        "conditionalFormatting": []
+      }
+    }
+  ]
+}`
+    }
+  ]),
+  "schemas delete": buildCommandExamples([
+    {
+      description: "Delete a schema (also removes it from navigation folders).",
+      command: "zinkee --json schemas delete contacts",
+      response: `{
+  "schemaId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+  "deleted": true
+}`
+    }
+  ]),
+  "schemas fields list": buildCommandExamples([
+    {
+      description: "List the fields of a schema (fields are inlined in the schema resource).",
+      command: "zinkee --json schemas fields list contacts",
+      response: `[
+  {
+    "id": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+    "type": "TextField",
+    "slug": "contact-name",
+    "label": "Customer Name",
+    "required": true,
+    "system": false,
+    "config": {
+      "textType": "LONG",
+      "defaultValue": "Unknown",
+      "conditionalFormatting": []
+    }
+  },
+  {
+    "id": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+    "type": "OptionField",
+    "slug": "status",
+    "label": "Status",
+    "required": false,
+    "system": false,
+    "config": {
+      "options": [
+        { "id": 1, "name": "Open", "color": "default" },
+        { "id": 2, "name": "In Progress", "color": "warning" },
+        { "id": 3, "name": "Done", "color": "success" }
+      ],
+      "defaultValue": 1,
+      "conditionalFormatting": [],
+      "buttonConfig": null
+    }
+  }
+]`
+    }
+  ]),
+  "schemas fields get": buildCommandExamples([
+    {
+      description: "Get a schema field (returns the full typed field contract).",
+      command: "zinkee --json schemas fields get contacts status",
+      response: `{
+  "id": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+  "type": "OptionField",
+  "slug": "status",
+  "label": "Status",
+  "required": false,
+  "system": false,
+  "config": {
+    "options": [
+      { "id": 1, "name": "Open", "color": "default" },
+      { "id": 2, "name": "In Progress", "color": "warning" },
+      { "id": 3, "name": "Done", "color": "success" }
+    ],
+    "defaultValue": 1,
+    "conditionalFormatting": [],
+    "buttonConfig": {
+      "displayMode": "button",
+      "buttonBehavior": {
+        "mode": "cycle",
+        "cycleOrder": [1, 2, 3],
+        "requireConfirmation": false,
+        "lockAfterSelection": false,
+        "useFixedLabel": false,
+        "allowReselect": true
+      }
+    }
+  }
+}`
+    }
+  ]),
+  "schemas fields delete": buildCommandExamples([
+    {
+      description: "Delete a schema field.",
+      command: "zinkee --json schemas fields delete contacts status",
+      response: `{
+  "schemaId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+  "fieldId": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+  "slug": "status"
+}`
+    }
+  ]),
+  "records list": buildCommandExamples([
+    {
+      description: "List records with default pagination.",
+      command: "zinkee --json records list contacts",
+      response: `{
+  "records": [
+    {
+      "recordId": "550e8400-e29b-41d4-a716-446655440000",
+      "values": {
+        "contact-name": "Ada Lovelace",
+        "contact-email": "ada@example.com",
+        "status": 2,
+        "amount": 1250.50,
+        "due-date": "2026-05-15T12:00:00Z",
+        "owner": "6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d"
+      }
+    },
+    {
+      "recordId": "7c9a4b31-e85d-42f7-8b6a-123456789abc",
+      "values": {
+        "contact-name": "Alan Turing",
+        "contact-email": "alan@example.com",
+        "status": 1,
+        "amount": 890.00
+      }
+    }
+  ],
+  "page": {
+    "offset": 0,
+    "limit": 50,
+    "total": 2,
+    "count": 2,
+    "hasMore": false
+  }
+}`
+    },
+    {
+      description: "Paginate further into the result set.",
+      command: "zinkee --json records list contacts --limit 50 --offset 100"
+    }
+  ]),
+  "records get": buildCommandExamples([
+    {
+      description: "Get one record by id (values are keyed by field slug).",
+      command: `zinkee --json records get contacts ${SAMPLE_UUID}`,
+      response: `{
+  "recordId": "550e8400-e29b-41d4-a716-446655440000",
+  "values": {
+    "contact-name": "Ada Lovelace",
+    "contact-email": "ada@example.com",
+    "status": 2,
+    "amount": 1250.50,
+    "due-date": "2026-05-15T12:00:00Z",
+    "owner": "6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d"
+  }
+}`
+    }
+  ]),
+  "records delete": buildCommandExamples([
+    {
+      description: "Delete a record.",
+      command: `zinkee --json records delete contacts ${SAMPLE_UUID}`,
+      response: `{
+  "recordId": "550e8400-e29b-41d4-a716-446655440000",
+  "deleted": true
+}`
+    }
+  ]),
+  "comments list": buildCommandExamples([
+    {
+      description: "List comments on a record (content is an array of TEXT/MENTION items).",
+      command: `zinkee --json comments list contacts ${SAMPLE_UUID}`,
+      response: `[
+  {
+    "id": "cd8e3b2a-1f5c-4e9a-8b7d-0a2b3c4d5e6f",
+    "recordId": "550e8400-e29b-41d4-a716-446655440000",
+    "createdAt": "2026-04-22T10:15:00Z",
+    "createdBy": "developer@zinkee.com",
+    "content": [
+      { "type": "TEXT", "value": "This record needs review." }
+    ]
+  },
+  {
+    "id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
+    "recordId": "550e8400-e29b-41d4-a716-446655440000",
+    "createdAt": "2026-04-22T11:30:00Z",
+    "createdBy": "developer@zinkee.com",
+    "content": [
+      { "type": "TEXT", "value": "Assigning to " },
+      { "type": "MENTION", "value": "9f8e7d6c-5b4a-3c2d-1e0f-a1b2c3d4e5f6" },
+      { "type": "TEXT", "value": " for follow up." }
+    ]
+  }
+]`
+    }
+  ]),
+  "logs list": buildCommandExamples([
+    {
+      description: "List the change history for a record (CREATE entry plus UPDATE entries with before/after values per field).",
+      command: `zinkee --json logs list contacts ${SAMPLE_UUID}`,
+      response: `[
+  {
+    "recordId": "550e8400-e29b-41d4-a716-446655440000",
+    "timestamp": "2026-04-22T10:00:00Z",
+    "changeField": "",
+    "change": {
+      "beforeValue": null,
+      "afterValue": null,
+      "author": "developer@zinkee.com",
+      "operation": "CREATE"
+    }
+  },
+  {
+    "recordId": "550e8400-e29b-41d4-a716-446655440000",
+    "timestamp": "2026-04-22T10:15:00Z",
+    "changeField": "status",
+    "change": {
+      "beforeValue": "1",
+      "afterValue": "2",
+      "author": "developer@zinkee.com",
+      "operation": "UPDATE"
+    }
+  },
+  {
+    "recordId": "550e8400-e29b-41d4-a716-446655440000",
+    "timestamp": "2026-04-22T10:20:00Z",
+    "changeField": "amount",
+    "change": {
+      "beforeValue": "1000.00",
+      "afterValue": "1250.50",
+      "author": "developer@zinkee.com",
+      "operation": "UPDATE"
+    }
+  }
+]`
+    }
+  ]),
+  "navigation folders list": buildCommandExamples([
+    {
+      description: "List navigation folders with embedded resources, sorted by order.",
+      command: "zinkee --json navigation folders list",
+      response: `[
+  {
+    "id": "84a0fca4-37ef-4c83-a8ed-9ef67ad9324a",
+    "order": 1,
+    "name": "Sales",
+    "resources": [
+      {
+        "id": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+        "name": "Contacts",
+        "type": "SCHEMA",
+        "isInSpace": false,
+        "additionalProperties": {}
+      },
+      {
+        "id": "5223cbc8-8c6c-4694-93bc-dd176364df9b",
+        "name": "Orders",
+        "type": "SCHEMA",
+        "isInSpace": true,
+        "additionalProperties": {}
+      }
+    ],
+    "additionalProperties": {
+      "color": "blue"
+    }
+  },
+  {
+    "id": "b8c9d0e1-f2a3-4b5c-6d7e-8f9012345678",
+    "order": 2,
+    "name": "Operations",
+    "resources": [
+      {
+        "id": "3f8a2c1b-9d4e-4a5b-8c6d-7e8f90123456",
+        "name": "Quote approval",
+        "type": "WORKFLOW",
+        "isInSpace": false,
+        "additionalProperties": {}
+      },
+      {
+        "id": "0f6f062f-1478-4df2-96a1-c495d037d260",
+        "name": "Executive Revenue",
+        "type": "DISPLAY",
+        "isInSpace": true,
+        "additionalProperties": {
+          "pinned": true
+        }
+      }
+    ],
+    "additionalProperties": {
+      "color": "purple"
+    }
+  },
+  {
+    "id": "00000000-0000-0000-0000-000000000000",
+    "order": 99,
+    "name": "root",
+    "resources": [],
+    "additionalProperties": {}
+  }
+]`
+    }
+  ]),
+  "navigation folders get": buildCommandExamples([
+    {
+      description: "Get a navigation folder by exact name or UUID.",
+      command: "zinkee --json navigation folders get Finance"
+    }
+  ]),
+  "navigation folders delete": buildCommandExamples([
+    {
+      description: "Delete a navigation folder by exact name or UUID.",
+      command: "zinkee --json navigation folders delete Finance",
+      response: `{
+  "folderId": "84a0fca4-37ef-4c83-a8ed-9ef67ad9324a",
+  "name": "Finance Ops"
+}`
+    }
+  ]),
+  "teamspace folders list": buildCommandExamples([
+    {
+      description: "List teamspace folders.",
+      command: "zinkee --json teamspace folders list"
+    },
+    {
+      description: "List teamspace folders with their published resources.",
+      command: "zinkee --json teamspace folders list --include-resources",
+      response: `[
+  {
+    "id": "f45a251d-3ea0-4b41-bfe8-c0f44c8ad54a",
+    "name": "Shared Dashboards",
+    "order": 1,
+    "isRoot": false,
+    "resourceCount": 1,
+    "resources": [
+      {
+        "id": "0f6f062f-1478-4df2-96a1-c495d037d260",
+        "name": "Executive Revenue",
+        "type": "DISPLAY"
+      }
+    ],
+    "additionalProperties": {}
+  }
+]`
+    }
+  ]),
+  "teamspace folders get": buildCommandExamples([
+    {
+      description: "Get a teamspace folder by exact name or UUID.",
+      command: 'zinkee --json teamspace folders get "Shared Dashboards"'
+    }
+  ]),
+  "teamspace folders delete": buildCommandExamples([
+    {
+      description: "Delete a teamspace folder. Its resources are moved to the returned target folder (root by default).",
+      command: 'zinkee --json teamspace folders delete "Customer Success"',
+      response: `{
+  "folderId": "f45a251d-3ea0-4b41-bfe8-c0f44c8ad54a",
+  "movedResourceCount": 3,
+  "targetFolder": {
+    "id": "00000000-0000-0000-0000-000000000000",
+    "name": "root",
+    "isRoot": true
+  }
+}`
+    }
+  ]),
+  "files storage": buildCommandExamples([
+    {
+      description: "Get the storage quota and current usage (bytes).",
+      command: "zinkee --json files storage",
+      response: `{
+  "maxSize": 10737418240,
+  "usedSize": 2147483648
+}`
+    }
+  ]),
+  "displays list": buildCommandExamples([
+    {
+      description: "List displays in the workspace with variable and widget counts.",
+      command: "zinkee --json displays list",
+      response: `[
+  {
+    "id": "0f6f062f-1478-4df2-96a1-c495d037d260",
+    "name": "Executive Revenue",
+    "layoutTemplate": "widget_row_tabs",
+    "variableCount": 3,
+    "widgetCount": 6
+  },
+  {
+    "id": "6b7c8d9e-0f12-3456-789a-bcdef0123456",
+    "name": "Sales Pipeline",
+    "layoutTemplate": "freeform",
+    "variableCount": 1,
+    "widgetCount": 3
+  },
+  {
+    "id": "ef012345-6789-4abc-8def-0123456789ab",
+    "name": "Customer Detail",
+    "layoutTemplate": "grid",
+    "variableCount": 0,
+    "widgetCount": 2
+  }
+]`
+    }
+  ]),
+  "displays get": buildCommandExamples([
+    {
+      description: "Get a display with its layout (tabs/freeformLayouts/slots), variables, widgets, cross-widget filter and navigation targets.",
+      command: "zinkee --json displays get 0f6f062f-1478-4df2-96a1-c495d037d260",
+      response: `{
+  "id": "0f6f062f-1478-4df2-96a1-c495d037d260",
+  "name": "Executive Revenue",
+  "layout": {
+    "template": "widget_row_tabs",
+    "freeformLayouts": null,
+    "slots": null,
+    "tabs": [
+      {
+        "id": "tab-main",
+        "name": "Overview",
+        "orientation": "horizontal",
+        "widgetIds": [
+          "11111111-1111-4111-a111-111111111111",
+          "22222222-2222-4222-a222-222222222222",
+          "33333333-3333-4333-a333-333333333333"
+        ]
+      },
+      {
+        "id": "tab-detail",
+        "name": "Detail",
+        "orientation": "horizontal",
+        "widgetIds": [
+          "44444444-4444-4444-a444-444444444444",
+          "55555555-5555-4555-a555-555555555555",
+          "66666666-6666-4666-a666-666666666666"
+        ]
+      }
+    ]
+  },
+  "variables": [
+    {
+      "id": "aaaaaaaa-1111-4111-a111-111111111111",
+      "type": "REFERENCE",
+      "name": "Customer",
+      "source": {
+        "schemaId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+        "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+      },
+      "defaultValue": "",
+      "allowMultiple": false,
+      "staticVariable": false,
+      "filters": []
+    },
+    {
+      "id": "bbbbbbbb-2222-4222-a222-222222222222",
+      "type": "DATE",
+      "name": "Period",
+      "date": {
+        "mode": "dynamic",
+        "dynamicOption": "thisMonth"
+      }
+    },
+    {
+      "id": "cccccccc-3333-4333-a333-333333333333",
+      "type": "MEMBER",
+      "name": "Owner",
+      "defaultValue": "6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d",
+      "allowMultiple": false,
+      "staticVariable": false
+    }
+  ],
+  "widgets": [
+    {
+      "id": "11111111-1111-4111-a111-111111111111",
+      "type": "TABLE_OR_SUBTABLE",
+      "source": {
+        "originResourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+        "isOriginSubSchema": false
+      },
+      "placement": {
+        "layout": { "x": 0, "y": 0, "w": 12, "h": 8 }
+      },
+      "presentation": {
+        "name": "Customers",
+        "description": "All customers",
+        "icon": "users",
+        "color": "blue"
+      },
+      "bindings": {
+        "variableMap": {
+          "aaaaaaaa-1111-4111-a111-111111111111": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+        }
+      },
+      "query": {
+        "filters": [],
+        "sorts": [
+          { "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34", "direction": "ASC" }
+        ]
+      },
+      "behavior": {
+        "readOnly": false,
+        "hideAddButton": false,
+        "hideDeleteButton": false
+      },
+      "view": {
+        "fields": ["id", "contact-name", "status", "amount"],
+        "columnSize": { "contact-name": 240 }
+      }
+    }
+  ],
+  "crossWidgetFilter": {
+    "source": {
+      "widgetId": "11111111-1111-4111-a111-111111111111",
+      "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+    },
+    "targets": [
+      {
+        "widgetId": "22222222-2222-4222-a222-222222222222",
+        "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+      }
+    ]
+  },
+  "navigationTargets": [
+    {
+      "id": "nav-target-customer",
+      "sourceWidgetId": "11111111-1111-4111-a111-111111111111",
+      "targetDisplayId": "ef012345-6789-4abc-8def-0123456789ab",
+      "targetVariableId": "aaaaaaaa-1111-4111-a111-111111111111",
+      "label": "Open customer"
+    }
+  ]
+}`
+    }
+  ]),
+  "displays update": buildCommandExamples([
+    {
+      description: "Rename a display (patch of top-level metadata only).",
+      command: 'zinkee --json displays update 0f6f062f-1478-4df2-96a1-c495d037d260 --name "Pipeline overview (renamed)"',
+      raw: `{
+  "name": "Pipeline overview (renamed)"
+}`,
+      response: `{
+  "displayId": "0f6f062f-1478-4df2-96a1-c495d037d260"
+}`
+    }
+  ]),
+  "displays delete": buildCommandExamples([
+    {
+      description: "Delete a display.",
+      command: "zinkee --json displays delete 0f6f062f-1478-4df2-96a1-c495d037d260"
+    }
+  ]),
+  "displays layout get": buildCommandExamples([
+    {
+      description: "Get the layout block of a display (template + tabs/freeformLayouts/slots).",
+      command: "zinkee --json displays layout get 0f6f062f-1478-4df2-96a1-c495d037d260"
+    }
+  ]),
+  "displays layout update": buildCommandExamples([
+    {
+      description: "Replace the freeform layout of a display.",
+      command: `zinkee --json displays layout update 0f6f062f-1478-4df2-96a1-c495d037d260 --template freeform --freeform-layouts '{"lg":[{"i":"widget-1","x":0,"y":0,"w":6,"h":5}]}'`
+    }
+  ]),
+  "displays tabs list": buildCommandExamples([
+    {
+      description: "List the tabs of a display (only meaningful when the layout template uses tabs).",
+      command: "zinkee --json displays tabs list 0f6f062f-1478-4df2-96a1-c495d037d260"
+    }
+  ]),
+  "displays tabs delete": buildCommandExamples([
+    {
+      description: "Delete a tab by id.",
+      command: "zinkee --json displays tabs delete 0f6f062f-1478-4df2-96a1-c495d037d260 tab-main",
+      response: `{
+  "displayId": "0f6f062f-1478-4df2-96a1-c495d037d260",
+  "tabId": "tab-main"
+}`
+    }
+  ]),
+  "displays variables list": buildCommandExamples([
+    {
+      description: "List the variables of a display.",
+      command: "zinkee --json displays variables list 0f6f062f-1478-4df2-96a1-c495d037d260"
+    }
+  ]),
+  "displays variables get": buildCommandExamples([
+    {
+      description: "Get one variable by id.",
+      command: "zinkee --json displays variables get 0f6f062f-1478-4df2-96a1-c495d037d260 aaaaaaaa-1111-4111-a111-111111111111"
+    }
+  ]),
+  "displays variables delete": buildCommandExamples([
+    {
+      description: "Delete a variable.",
+      command: "zinkee --json displays variables delete 0f6f062f-1478-4df2-96a1-c495d037d260 aaaaaaaa-1111-4111-a111-111111111111",
+      response: `{
+  "displayId": "0f6f062f-1478-4df2-96a1-c495d037d260",
+  "variableId": "aaaaaaaa-1111-4111-a111-111111111111"
+}`
+    }
+  ]),
+  "displays widgets list": buildCommandExamples([
+    {
+      description: "List the widgets of a display.",
+      command: "zinkee --json displays widgets list 0f6f062f-1478-4df2-96a1-c495d037d260"
+    }
+  ]),
+  "displays widgets get": buildCommandExamples([
+    {
+      description: "Get one widget (returns the canonical typed widget contract).",
+      command: "zinkee --json displays widgets get 0f6f062f-1478-4df2-96a1-c495d037d260 11111111-1111-4111-a111-111111111111",
+      response: `{
+  "id": "11111111-1111-4111-a111-111111111111",
+  "type": "TABLE_OR_SUBTABLE",
+  "source": {
+    "originResourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+    "isOriginSubSchema": false
+  },
+  "placement": {
+    "layout": { "x": 0, "y": 0, "w": 12, "h": 8 }
+  },
+  "presentation": {
+    "name": "Customers",
+    "description": "All customers",
+    "icon": "users",
+    "color": "blue"
+  },
+  "bindings": {
+    "variableMap": {
+      "aaaaaaaa-1111-4111-a111-111111111111": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+    }
+  },
+  "query": {
+    "filters": [],
+    "sorts": [
+      { "fieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34", "direction": "ASC" }
+    ]
+  },
+  "behavior": {
+    "readOnly": false,
+    "hideAddButton": false,
+    "hideDeleteButton": false
+  },
+  "view": {
+    "fields": ["id", "contact-name", "status", "amount"],
+    "columnSize": { "contact-name": 240 }
+  }
+}`
+    }
+  ]),
+  "displays widgets delete": buildCommandExamples([
+    {
+      description: "Delete a widget.",
+      command: "zinkee --json displays widgets delete 0f6f062f-1478-4df2-96a1-c495d037d260 11111111-1111-4111-a111-111111111111",
+      response: `{
+  "displayId": "0f6f062f-1478-4df2-96a1-c495d037d260",
+  "widgetId": "11111111-1111-4111-a111-111111111111"
+}`
+    }
+  ]),
+  "displays navigation-targets list": buildCommandExamples([
+    {
+      description: "List navigation targets for a display.",
+      command: "zinkee --json displays navigation-targets list 0f6f062f-1478-4df2-96a1-c495d037d260"
+    }
+  ]),
+  "displays navigation-targets delete": buildCommandExamples([
+    {
+      description: "Delete a navigation target.",
+      command: "zinkee --json displays navigation-targets delete 0f6f062f-1478-4df2-96a1-c495d037d260 nav-target-customer",
+      response: `{
+  "displayId": "0f6f062f-1478-4df2-96a1-c495d037d260",
+  "navigationTargetId": "nav-target-customer"
+}`
+    }
+  ]),
+  "displays cross-widget-filter get": buildCommandExamples([
+    {
+      description: "Get the cross-widget filter of a display (can be null if none is set).",
+      command: "zinkee --json displays cross-widget-filter get 0f6f062f-1478-4df2-96a1-c495d037d260"
+    }
+  ]),
+  "displays cross-widget-filter delete": buildCommandExamples([
+    {
+      description: "Delete the cross-widget filter of a display.",
+      command: "zinkee --json displays cross-widget-filter delete 0f6f062f-1478-4df2-96a1-c495d037d260"
+    }
+  ]),
+  "automations list": buildCommandExamples([
+    {
+      description: "List automations with summaries.",
+      command: "zinkee --json automations list",
+      response: `[
+  {
+    "id": "d2df2478-2513-4ecb-a2aa-2cea8c3d614a",
+    "name": "Codex Trigger Demo 1774278580",
+    "description": "Demo compleja no-webhook para revisar en frontend.",
+    "status": "active",
+    "folder": {
+      "id": "cdfc14e3-3169-4ffb-8d9b-b11858a9240f",
+      "name": "Codex Frontend Demo",
+      "isRoot": false
+    },
+    "triggerType": "record_changed",
+    "actionTypes": ["create_record", "http_request", "execute_plugin", "send_message"]
+  }
+]`
+    },
+    {
+      description: "Filter automations by folder, status, and trigger type.",
+      command: 'zinkee --json automations list --folder "Codex Frontend Demo" --status active --trigger-type record_changed'
+    }
+  ]),
+  "automations get": buildCommandExamples([
+    {
+      description: "Get the full automation document, including trigger, actions and flow.",
+      command: "zinkee --json automations get automation-1",
+      response: `{
+  "id": "d2df2478-2513-4ecb-a2aa-2cea8c3d614a",
+  "name": "Codex Trigger Demo 1774278580",
+  "description": "Demo compleja no-webhook para revisar en frontend.",
+  "status": "active",
+  "folder": {
+    "id": "cdfc14e3-3169-4ffb-8d9b-b11858a9240f",
+    "name": "Codex Frontend Demo",
+    "isRoot": false
+  },
+  "trigger": {
+    "type": "record_changed",
+    "config": {
+      "schemaId": "68d2c7be-4392-42de-b5ae-625ad79cfc3c",
+      "fieldIds": ["4dd04e57-2a01-4c49-8728-9cb288bffb8d"],
+      "conditions": [
+        {
+          "field": "4dd04e57-2a01-4c49-8728-9cb288bffb8d",
+          "comparator": "ine",
+          "values": [{"rawValue": "", "source": null}]
+        }
+      ]
+    }
+  },
+  "actions": [
+    {
+      "id": "a657c49a-8ca1-4ec1-af86-d0dac4fc49b2",
+      "type": "create_record",
+      "name": "Create follow-up order",
+      "config": {
+        "targetSchemaId": "68d2c7be-4392-42de-b5ae-625ad79cfc3c",
+        "fieldMapping": {
+          "34250412-f016-44c0-9f88-37dd1ddb4b13": {
+            "rawValue": "Created by automation",
+            "source": null
+          }
+        }
+      }
+    },
+    {
+      "id": "784d0971-bd8f-4b05-87eb-3392d1570273",
+      "type": "http_request",
+      "name": "Notify ERP",
+      "config": {
+        "method": "POST",
+        "url": "https://example.com/integrations/order-status",
+        "headers": {"X-Demo": "codex"},
+        "body": "{\\"event\\":\\"order.status.changed\\"}",
+        "contentType": "application/json",
+        "timeoutMs": 5000,
+        "variables": {},
+        "authMode": "STORED",
+        "connectionId": "4fc20b5c-9353-4991-b68e-1027cb674ed4"
+      }
+    },
+    {
+      "id": "dae13307-057f-4c39-817c-4d2dd5898421",
+      "type": "execute_plugin",
+      "name": "Run billing plugin",
+      "config": {
+        "pluginId": "demo-plugin",
+        "pluginArgs": {
+          "mode": "safe"
+        }
+      }
+    }
+  ],
+  "flow": {
+    "entryActionIds": ["a657c49a-8ca1-4ec1-af86-d0dac4fc49b2"],
+    "transitions": [
+      {
+        "fromActionId": "a657c49a-8ca1-4ec1-af86-d0dac4fc49b2",
+        "toActionId": "784d0971-bd8f-4b05-87eb-3392d1570273"
+      },
+      {
+        "fromActionId": "784d0971-bd8f-4b05-87eb-3392d1570273",
+        "toActionId": "dae13307-057f-4c39-817c-4d2dd5898421"
+      }
+    ]
+  }
+}`
+    }
+  ]),
+  "automations delete": buildCommandExamples([
+    {
+      description: "Delete an automation. The response mirrors the mutation shape.",
+      command: "zinkee --json automations delete automation-1",
+      response: `{
+  "automationId": "d2df2478-2513-4ecb-a2aa-2cea8c3d614a",
+  "webhookEndpoint": null
+}`
+    }
+  ]),
+  "automations activate": buildCommandExamples([
+    {
+      description: "Activate an automation (transitions it to status=active).",
+      command: "zinkee --json automations activate automation-1",
+      response: `{
+  "automationId": "d2df2478-2513-4ecb-a2aa-2cea8c3d614a",
+  "webhookEndpoint": null
+}`
+    }
+  ]),
+  "automations deactivate": buildCommandExamples([
+    {
+      description: "Deactivate an automation (transitions it to status=inactive).",
+      command: "zinkee --json automations deactivate automation-1",
+      response: `{
+  "automationId": "d2df2478-2513-4ecb-a2aa-2cea8c3d614a",
+  "webhookEndpoint": null
+}`
+    }
+  ]),
+  "automations folders list": buildCommandExamples([
+    {
+      description: "List flat automation folders (non-root plus the root bucket).",
+      command: "zinkee --json automations folders list",
+      response: `[
+  {
+    "id": "cdfc14e3-3169-4ffb-8d9b-b11858a9240f",
+    "name": "Codex Frontend Demo",
+    "isRoot": false,
+    "automationCount": 2
+  },
+  {
+    "id": "8b22282b-3db3-4dd7-87f7-b29365dcf3f6",
+    "name": null,
+    "isRoot": true,
+    "automationCount": 3
+  }
+]`
+    }
+  ]),
+  "automations folders delete": buildCommandExamples([
+    {
+      description: "Delete a non-root automation folder by exact name.",
+      command: 'zinkee --json automations folders delete "Codex Frontend Demo"',
+      response: `{
+  "id": "cdfc14e3-3169-4ffb-8d9b-b11858a9240f",
+  "name": "Codex Frontend Demo",
+  "isRoot": false,
+  "automationCount": 0
+}`
+    }
+  ]),
+  "automations trigger get": buildCommandExamples([
+    {
+      description: "Get the trigger subresource. Response shape depends on trigger type; here the scheduled variant.",
+      command: "zinkee --json automations trigger get automation-1",
+      response: `{
+  "type": "scheduled",
+  "config": {
+    "cronExpression": "0 15 10 * * 1"
+  }
+}`
+    }
+  ]),
+  "automations webhook get": buildCommandExamples([
+    {
+      description: "Get the webhook endpoint companion resource (only exists when the trigger is a webhook).",
+      command: "zinkee --json automations webhook get automation-1",
+      response: `{
+  "endpointId": "b3cb4283-97ab-4d94-9e6f-82d0ee5cee24",
+  "automationId": "d2df2478-2513-4ecb-a2aa-2cea8c3d614a",
+  "endpointUrl": "https://hooks.zinkee.com/webhooks/b3cb4283-97ab-4d94-9e6f-82d0ee5cee24",
+  "active": true,
+  "idempotencyKeyJsonPath": "$.id",
+  "eventTypeJsonPath": "$.type",
+  "allowedEventTypes": ["frontend.demo.created"],
+  "fieldMappings": [
+    {
+      "variable": "external_id",
+      "jsonPath": "$.data.id"
+    }
+  ]
+}`
+    }
+  ]),
+  "automations webhook delete": buildCommandExamples([
+    {
+      description: "Delete the webhook endpoint companion resource (returns no body).",
+      command: "zinkee --json automations webhook delete automation-1"
+    }
+  ]),
+  "automations actions list": buildCommandExamples([
+    {
+      description: "List the ordered actions of an automation.",
+      command: "zinkee --json automations actions list automation-1",
+      response: `[
+  {
+    "id": "a657c49a-8ca1-4ec1-af86-d0dac4fc49b2",
+    "type": "create_record",
+    "name": "Create follow-up order",
+    "config": {
+      "targetSchemaId": "68d2c7be-4392-42de-b5ae-625ad79cfc3c",
+      "fieldMapping": {
+        "34250412-f016-44c0-9f88-37dd1ddb4b13": {
+          "rawValue": "Created by automation",
+          "source": null
+        }
+      }
+    }
+  },
+  {
+    "id": "784d0971-bd8f-4b05-87eb-3392d1570273",
+    "type": "http_request",
+    "name": "Notify ERP",
+    "config": {
+      "method": "POST",
+      "url": "https://example.com/integrations/order-status",
+      "headers": {"X-Demo": "codex"},
+      "body": "{\\"event\\":\\"order.status.changed\\"}",
+      "contentType": "application/json",
+      "timeoutMs": 5000,
+      "variables": {},
+      "authMode": "STORED",
+      "connectionId": "4fc20b5c-9353-4991-b68e-1027cb674ed4"
+    }
+  },
+  {
+    "id": "dae13307-057f-4c39-817c-4d2dd5898421",
+    "type": "execute_plugin",
+    "name": "Run billing plugin",
+    "config": {
+      "pluginId": "demo-plugin",
+      "pluginArgs": {"mode": "safe"}
+    }
+  }
+]`
+    }
+  ]),
+  "automations actions delete": buildCommandExamples([
+    {
+      description: "Delete one action from an automation.",
+      command: "zinkee --json automations actions delete automation-1 action-1",
+      response: `{
+  "automationId": "d2df2478-2513-4ecb-a2aa-2cea8c3d614a",
+  "webhookEndpoint": null
+}`
+    }
+  ]),
+  "automations flow get": buildCommandExamples([
+    {
+      description: "Get the flow subresource (entry actions and transitions).",
+      command: "zinkee --json automations flow get automation-1",
+      response: `{
+  "entryActionIds": ["a657c49a-8ca1-4ec1-af86-d0dac4fc49b2"],
+  "transitions": [
+    {
+      "fromActionId": "a657c49a-8ca1-4ec1-af86-d0dac4fc49b2",
+      "toActionId": "784d0971-bd8f-4b05-87eb-3392d1570273"
+    },
+    {
+      "fromActionId": "784d0971-bd8f-4b05-87eb-3392d1570273",
+      "toActionId": "dae13307-057f-4c39-817c-4d2dd5898421"
+    }
+  ]
+}`
+    }
+  ]),
+  "automations plugins list": buildCommandExamples([
+    {
+      description: "List active workspace plugins available for execute_plugin actions.",
+      command: "zinkee --json automations plugins list",
+      response: `[
+  {
+    "id": "demo-plugin",
+    "name": "Demo Plugin",
+    "active": true,
+    "description": "Example plugin for automations",
+    "properties": {
+      "version": "1.0"
+    }
+  }
+]`
+    }
+  ]),
+  "automations plugins get": buildCommandExamples([
+    {
+      description: "Get one plugin by id.",
+      command: "zinkee --json automations plugins get demo-plugin",
+      response: `{
+  "id": "demo-plugin",
+  "name": "Demo Plugin",
+  "active": true,
+  "description": "Example plugin for automations",
+  "properties": {
+    "version": "1.0"
+  }
+}`
+    }
+  ]),
+  "automations connections list": buildCommandExamples([
+    {
+      description: "List stored workspace connections (secrets are never returned).",
+      command: "zinkee --json automations connections list",
+      response: `[
+  {
+    "id": "4fc20b5c-9353-4991-b68e-1027cb674ed4",
+    "name": "ERP API Key",
+    "type": "api_key",
+    "scope": "workspace",
+    "active": true,
+    "config": {
+      "headerName": "Authorization"
+    }
+  }
+]`
+    }
+  ]),
+  "automations connections get": buildCommandExamples([
+    {
+      description: "Get one stored connection by id.",
+      command: "zinkee --json automations connections get connection-1",
+      response: `{
+  "id": "4fc20b5c-9353-4991-b68e-1027cb674ed4",
+  "name": "ERP API Key",
+  "type": "api_key",
+  "scope": "workspace",
+  "ownerMemberId": "6c8a3e0d-7b1f-4c98-a2e9-8b9a2e3f5b14",
+  "active": true,
+  "config": {
+    "headerName": "Authorization"
+  },
+  "createdAt": "2026-04-21T09:00:00Z",
+  "updatedAt": "2026-04-21T09:00:00Z",
+  "createdBy": "developer@zinkee.com",
+  "updatedBy": "developer@zinkee.com"
+}`
+    }
+  ]),
+  "automations connections delete": buildCommandExamples([
+    {
+      description: "Delete one stored connection (returns no body).",
+      command: "zinkee --json automations connections delete connection-1"
+    }
+  ]),
+  "automations create": buildCommandExamples([
+    {
+      description: "Create a scheduled automation with description and target folder. Safe first example because it does not depend on workspace schemas.",
+      command: 'zinkee --json automations create --name "Nightly invoice sync" --description "Runs every Monday morning" --folder cdfc14e3-3169-4ffb-8d9b-b11858a9240f --trigger-type scheduled --cron "0 15 10 * * 1"',
+      raw: `{
+  "name": "Nightly invoice sync",
+  "description": "Runs every Monday morning",
+  "folderId": "cdfc14e3-3169-4ffb-8d9b-b11858a9240f",
+  "trigger": {
+    "type": "scheduled",
+    "config": {
+      "cronExpression": "0 15 10 * * 1"
+    }
+  }
+}`,
+      response: `{
+  "automationId": "d2df2478-2513-4ecb-a2aa-2cea8c3d614a",
+  "webhookEndpoint": null
+}`
+    },
+    {
+      description: "Create a record-created automation with an 'is not empty' condition. Replace 'leads' and 'status' with real schema/field slugs or UUIDs.",
+      command: `zinkee --json automations create --name "Lead welcome" --trigger-type record_created --trigger-schema leads --condition-json '{"field":"status","comparator":"ine","values":[{"rawValue":"","source":null}]}'`,
+      raw: `{
+  "name": "Lead welcome",
+  "trigger": {
+    "type": "record_created",
+    "config": {
+      "schemaId": "leads",
+      "conditions": [
+        {
+          "field": "status",
+          "comparator": "ine",
+          "values": [{"rawValue": "", "source": null}]
+        }
+      ]
+    }
+  }
+}`
+    },
+    {
+      description: "Create a record-changed automation watching a single field, with an 'is not empty' condition. Replace 'orders' and 'status' with values from your workspace.",
+      command: `zinkee --json automations create --name "Order status sync" --trigger-type record_changed --trigger-schema orders --trigger-field status --condition-json '{"field":"status","comparator":"ine","values":[{"rawValue":"","source":null}]}'`,
+      raw: `{
+  "name": "Order status sync",
+  "trigger": {
+    "type": "record_changed",
+    "config": {
+      "schemaId": "orders",
+      "fieldIds": ["status"],
+      "conditions": [
+        {
+          "field": "status",
+          "comparator": "ine",
+          "values": [{"rawValue": "", "source": null}]
+        }
+      ]
+    }
+  }
+}`
+    }
+  ]),
+  "automations update": buildCommandExamples([
+    {
+      description: "Update automation description and move it to a folder. Supported patch paths: name, description, folderId.",
+      command: 'zinkee --json automations update automation-1 --description "Updated by an agent" --folder cdfc14e3-3169-4ffb-8d9b-b11858a9240f',
+      raw: `{
+  "set": {
+    "description": "Updated by an agent",
+    "folderId": "cdfc14e3-3169-4ffb-8d9b-b11858a9240f"
+  }
+}`
+    },
+    {
+      description: "Clear the folder assignment by combining an explicit unset through the raw payload.",
+      command: `zinkee --json automations update automation-1 --raw '{"unset":["folderId"]}'`,
+      raw: `{
+  "unset": ["folderId"]
+}`
+    }
+  ]),
+  "automations trigger set": buildCommandExamples([
+    {
+      description: "Replace the trigger with a scheduled (cron) trigger.",
+      command: 'zinkee --json automations trigger set automation-1 --trigger-type scheduled --cron "0 15 10 * * 1"',
+      raw: `{
+  "type": "scheduled",
+  "config": {
+    "cronExpression": "0 15 10 * * 1"
+  }
+}`
+    },
+    {
+      description: "Replace the trigger with a record-created trigger plus an 'is not empty' condition. Agents should provide at least one meaningful condition.",
+      command: `zinkee --json automations trigger set automation-1 --trigger-type record_created --trigger-schema orders --condition-json '{"field":"status","comparator":"ine","values":[{"rawValue":"","source":null}]}'`,
+      raw: `{
+  "type": "record_created",
+  "config": {
+    "schemaId": "orders",
+    "conditions": [
+      {
+        "field": "status",
+        "comparator": "ine",
+        "values": [{"rawValue": "", "source": null}]
+      }
+    ]
+  }
+}`
+    },
+    {
+      description: "Replace the trigger with a record-changed trigger watching one field, with an 'is not empty' condition on that field.",
+      command: `zinkee --json automations trigger set automation-1 --trigger-type record_changed --trigger-schema orders --trigger-field status --condition-json '{"field":"status","comparator":"ine","values":[{"rawValue":"","source":null}]}'`,
+      raw: `{
+  "type": "record_changed",
+  "config": {
+    "schemaId": "orders",
+    "fieldIds": ["status"],
+    "conditions": [
+      {
+        "field": "status",
+        "comparator": "ine",
+        "values": [{"rawValue": "", "source": null}]
+      }
+    ]
+  }
+}`
+    },
+    {
+      description: "Replace the trigger with a webhook trigger that reuses an existing webhook endpoint id.",
+      command: "zinkee --json automations trigger set automation-1 --trigger-type webhook --webhook-endpoint-id b3cb4283-97ab-4d94-9e6f-82d0ee5cee24",
+      raw: `{
+  "type": "webhook",
+  "config": {
+    "webhookEndpointId": "b3cb4283-97ab-4d94-9e6f-82d0ee5cee24"
+  }
+}`
+    }
+  ]),
+  "automations actions add": buildCommandExamples([
+    {
+      description: "Add a create-record action with two literal field mappings. Populate visible fieldMapping entries so the frontend form is complete.",
+      command: 'zinkee --json automations actions add automation-1 --type create_record --name "Create follow-up order" --target-schema followups --map status=pending --map description="Created by automation"',
+      raw: `{
+  "type": "create_record",
+  "name": "Create follow-up order",
+  "config": {
+    "targetSchemaId": "followups",
+    "fieldMapping": {
+      "status": {
+        "rawValue": "pending",
+        "source": null
+      },
+      "description": {
+        "rawValue": "Created by automation",
+        "source": null
+      }
+    }
+  }
+}`
+    },
+    {
+      description: "Add an update-record action that targets the trigger record. Pair --use-trigger-record with --map to rewrite fields on the record that fired the automation.",
+      command: 'zinkee --json automations actions add automation-1 --type update_record --name "Mark order as processed" --target-schema orders --use-trigger-record --map status=processed',
+      raw: `{
+  "type": "update_record",
+  "name": "Mark order as processed",
+  "config": {
+    "targetSchemaId": "orders",
+    "fieldMapping": {
+      "status": {
+        "rawValue": "processed",
+        "source": null
+      }
+    },
+    "useTriggerRecord": true
+  }
+}`
+    },
+    {
+      description: "Add a search-records action scoped to a target schema.",
+      command: 'zinkee --json automations actions add automation-1 --type search_records --name "Find related invoices" --target-schema orders',
+      raw: `{
+  "type": "search_records",
+  "name": "Find related invoices",
+  "config": {
+    "targetSchemaId": "orders"
+  }
+}`
+    },
+    {
+      description: "Add a search-records action whose condition pulls its value from the trigger payload using --condition-json.",
+      command: `zinkee --json automations actions add automation-1 --type search_records --name "Find duplicates" --target-schema followups --condition-json '{"field":"email","comparator":"eq","values":[{"rawValue":null,"source":{"type":"TRIGGER","id":"payload_value"}}]}'`,
+      raw: `{
+  "type": "search_records",
+  "name": "Find duplicates",
+  "config": {
+    "targetSchemaId": "followups",
+    "conditions": [
+      {
+        "field": "email",
+        "comparator": "eq",
+        "values": [
+          {
+            "rawValue": null,
+            "source": {
+              "type": "TRIGGER",
+              "id": "payload_value"
+            }
+          }
+        ]
+      }
+    ]
+  }
+}`
+    },
+    {
+      description: "Add an HTTP request action using a stored workspace connection for authentication.",
+      command: 'zinkee --json automations actions add automation-1 --type http_request --name "Notify external ERP" --method POST --url https://example.com/integrations/order-status --header X-Demo=codex --content-type application/json --timeout-ms 5000 --auth-mode STORED --connection connection-1',
+      raw: `{
+  "type": "http_request",
+  "name": "Notify external ERP",
+  "config": {
+    "method": "POST",
+    "url": "https://example.com/integrations/order-status",
+    "headers": {
+      "X-Demo": "codex"
+    },
+    "contentType": "application/json",
+    "timeoutMs": 5000,
+    "authMode": "STORED",
+    "connectionId": "connection-1"
+  }
+}`
+    },
+    {
+      description: "Add an execute-plugin action with structured plugin arguments. Replace 'demo-plugin' with an active id from 'zinkee --json automations plugins list'.",
+      command: `zinkee --json automations actions add automation-1 --type execute_plugin --name "Run billing plugin" --plugin demo-plugin --arg mode=safe --arg-json steps='["one","two"]'`,
+      raw: `{
+  "type": "execute_plugin",
+  "name": "Run billing plugin",
+  "config": {
+    "pluginId": "demo-plugin",
+    "pluginArgs": {
+      "mode": "safe",
+      "steps": ["one", "two"]
+    }
+  }
+}`
+    }
+  ]),
+  "automations actions update": buildCommandExamples([
+    {
+      description: "Replace an update-record action so it targets the trigger record. Conditions are stripped automatically when --use-trigger-record is provided.",
+      command: 'zinkee --json automations actions update automation-1 action-1 --type update_record --name "Update trigger record" --target-schema followups --map status=ready --use-trigger-record',
+      raw: `{
+  "type": "update_record",
+  "name": "Update trigger record",
+  "config": {
+    "targetSchemaId": "followups",
+    "fieldMapping": {
+      "status": {
+        "rawValue": "ready",
+        "source": null
+      }
+    },
+    "useTriggerRecord": true
+  }
+}`,
+      response: `{
+  "id": "a657c49a-8ca1-4ec1-af86-d0dac4fc49b2",
+  "type": "create_record",
+  "name": "Create follow-up order",
+  "config": {
+    "targetSchemaId": "68d2c7be-4392-42de-b5ae-625ad79cfc3c",
+    "fieldMapping": {
+      "34250412-f016-44c0-9f88-37dd1ddb4b13": {
+        "rawValue": "Updated by an agent",
+        "source": null
+      }
+    }
+  }
+}`
+    },
+    {
+      description: "Replace an HTTP request action, keeping it authenticated through a stored connection.",
+      command: 'zinkee --json automations actions update automation-1 action-1 --type http_request --name "Notify external ERP" --method POST --url https://example.com/integrations/order-status --content-type application/json --timeout-ms 5000 --auth-mode STORED --connection connection-1',
+      raw: `{
+  "type": "http_request",
+  "name": "Notify external ERP",
+  "config": {
+    "method": "POST",
+    "url": "https://example.com/integrations/order-status",
+    "contentType": "application/json",
+    "timeoutMs": 5000,
+    "authMode": "STORED",
+    "connectionId": "connection-1"
+  }
+}`
+    }
+  ]),
+  "automations flow set": buildCommandExamples([
+    {
+      description: "Set one entry action and chain two transitions (action-1 \u2192 action-2 \u2192 action-3).",
+      command: "zinkee --json automations flow set automation-1 --entry action-1 --transition action-1:action-2 --transition action-2:action-3",
+      raw: `{
+  "entryActionIds": ["action-1"],
+  "transitions": [
+    {
+      "fromActionId": "action-1",
+      "toActionId": "action-2"
+    },
+    {
+      "fromActionId": "action-2",
+      "toActionId": "action-3"
+    }
+  ]
+}`
+    }
+  ]),
+  "automations webhook set": buildCommandExamples([
+    {
+      description: "Create or update the webhook endpoint companion resource with idempotency key, event type filter, and a field mapping. This config is separate from the webhook trigger itself.",
+      command: `zinkee --json automations webhook set automation-1 --idempotency-key-path "$.id" --event-type-path "$.type" --allowed-event-type frontend.demo.created --field-mapping '{"variable":"external_id","jsonPath":"$.data.id"}' --active`,
+      raw: `{
+  "active": true,
+  "idempotencyKeyJsonPath": "$.id",
+  "eventTypeJsonPath": "$.type",
+  "allowedEventTypes": ["frontend.demo.created"],
+  "fieldMappings": [
+    {
+      "variable": "external_id",
+      "jsonPath": "$.data.id"
+    }
+  ]
+}`,
+      response: `{
+  "endpointId": "b3cb4283-97ab-4d94-9e6f-82d0ee5cee24",
+  "automationId": "d2df2478-2513-4ecb-a2aa-2cea8c3d614a",
+  "endpointUrl": "https://hooks.zinkee.com/webhooks/b3cb4283-97ab-4d94-9e6f-82d0ee5cee24",
+  "active": true,
+  "idempotencyKeyJsonPath": "$.id",
+  "eventTypeJsonPath": "$.type",
+  "allowedEventTypes": ["frontend.demo.created"],
+  "fieldMappings": [
+    {
+      "variable": "external_id",
+      "jsonPath": "$.data.id"
+    }
+  ]
+}`
+    }
+  ]),
+  "automations connections create": buildCommandExamples([
+    {
+      description: "Create a stored workspace connection for http_request actions. Secret values are write-only and never returned on read.",
+      command: `zinkee --json automations connections create --name "ERP API Key" --type api_key --scope workspace --config '{"headerName":"Authorization"}' --secret apiKey=super-secret --active`,
+      raw: `{
+  "name": "ERP API Key",
+  "type": "api_key",
+  "scope": "workspace",
+  "config": {
+    "headerName": "Authorization"
+  },
+  "secret": {
+    "apiKey": "super-secret"
+  },
+  "active": true
+}`,
+      response: `{
+  "id": "4fc20b5c-9353-4991-b68e-1027cb674ed4",
+  "name": "ERP API Key",
+  "type": "api_key",
+  "scope": "workspace",
+  "ownerMemberId": "6c8a3e0d-7b1f-4c98-a2e9-8b9a2e3f5b14",
+  "active": true,
+  "config": {
+    "headerName": "Authorization"
+  },
+  "createdAt": "2026-04-21T09:00:00Z",
+  "updatedAt": "2026-04-21T09:00:00Z",
+  "createdBy": "developer@zinkee.com",
+  "updatedBy": "developer@zinkee.com"
+}`
+    }
+  ]),
+  "automations connections update": buildCommandExamples([
+    {
+      description: "Patch an existing stored connection. Use set.secret only when rotating secrets.",
+      command: `zinkee --json automations connections update connection-1 --raw '{"set":{"name":"ERP API Key Updated","config":{"headerName":"Authorization"}}}'`,
+      raw: `{
+  "set": {
+    "name": "ERP API Key Updated",
+    "config": {
+      "headerName": "Authorization"
+    }
+  }
+}`,
+      response: `{
+  "id": "4fc20b5c-9353-4991-b68e-1027cb674ed4",
+  "name": "ERP API Key Updated",
+  "type": "api_key",
+  "scope": "workspace",
+  "ownerMemberId": "6c8a3e0d-7b1f-4c98-a2e9-8b9a2e3f5b14",
+  "active": true,
+  "config": {
+    "headerName": "Authorization"
+  },
+  "createdAt": "2026-04-21T09:00:00Z",
+  "updatedAt": "2026-04-21T10:15:00Z",
+  "createdBy": "developer@zinkee.com",
+  "updatedBy": "developer@zinkee.com"
+}`
+    }
+  ]),
+  "automations folders create": buildCommandExamples([
+    {
+      description: "Create one flat automation folder.",
+      command: 'zinkee --json automations folders create --name "Codex Frontend Demo"',
+      raw: `{
+  "name": "Codex Frontend Demo"
+}`,
+      response: `{
+  "id": "cdfc14e3-3169-4ffb-8d9b-b11858a9240f",
+  "name": "Codex Frontend Demo",
+  "isRoot": false,
+  "automationCount": 0
+}`
+    }
+  ]),
+  "automations folders update": buildCommandExamples([
+    {
+      description: "Rename a non-root automation folder. The folder argument accepts a UUID or an exact name.",
+      command: 'zinkee --json automations folders update "Codex Frontend Demo" --name "Codex Frontend Demo Updated"',
+      raw: `{
+  "name": "Codex Frontend Demo Updated"
+}`,
+      response: `{
+  "id": "cdfc14e3-3169-4ffb-8d9b-b11858a9240f",
+  "name": "Codex Frontend Demo Updated",
+  "isRoot": false,
+  "automationCount": 2
+}`
+    }
+  ]),
+  "automations folders move": buildCommandExamples([
+    {
+      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"
+}`,
+      response: `{
+  "id": "cdfc14e3-3169-4ffb-8d9b-b11858a9240f",
+  "name": "Codex Frontend Demo",
+  "isRoot": false
+}`
+    }
+  ])
+};
+function fallbackExamples(commandName) {
   switch (commandName) {
-    case "profiles list":
-      return [{ description: "List configured profiles", command: "zinkee profiles list" }];
-    case "profiles get":
-      return [{ description: "Show a profile", command: "zinkee profiles get prod" }];
-    case "profiles add":
-      return [{ description: "Add a profile", command: "zinkee profiles add local --api-key token --base-url http://localhost:8088" }];
-    case "config validate":
-      return [{ description: "Validate config", command: "zinkee --json config validate" }];
-    case "schemas list":
-      return [{ description: "List schemas", command: "zinkee --json schemas list" }];
-    case "schemas create":
-      return [{ description: "Create a schema", command: "zinkee --json schemas create --name Contacts --slug contacts --auditable --commentable" }];
-    case "comments create":
-      return [{ description: "Create a text comment", command: `zinkee --json comments create contacts ${SAMPLE_UUID} --text "Hello world"` }];
-    case "navigation folders create":
-      return [{ description: "Create a navigation folder", command: "zinkee --json navigation folders create --name Finance --order 10" }];
-    case "teamspace folders list":
-      return [{ description: "List teamspace folders with resources", command: "zinkee --json teamspace folders list --include-resources" }];
-    case "displays create":
-      return [
-        { description: "Create a display", command: "zinkee --json displays create --name Pipeline --template widget_row_tabs" },
-        {
-          description: "Create a freeform display with responsive layout data",
-          command: `zinkee --json displays create --name "Control Proyecto Freeform" --template freeform --freeform-layouts '{"lg":[{"i":"widget-1","x":0,"y":0,"w":6,"h":5}]}'`
-        }
-      ];
-    case "automations list":
-      return [{ description: "List automations", command: "zinkee --json automations list" }];
     default:
       return [];
   }
@@ -2461,31 +5191,49 @@ async function buildDynamicAutomationExamples(commandName, options = {}) {
       "cronExpression": "0 15 10 * * 1"
     }
   }
+}`,
+          response: `{
+  "automationId": "d2df2478-2513-4ecb-a2aa-2cea8c3d614a",
+  "webhookEndpoint": null
 }`
         },
         {
-          description: `Create a record-created automation using a real schema reference from this workspace (${schemaField.schemaRef}).`,
-          command: `zinkee --json automations create --name "Record created demo" --trigger-type record_created --trigger-schema ${schemaField.schemaRef}`,
+          description: `Create a record-created automation using a real schema reference from this workspace (${schemaField.schemaRef}), with an 'is not empty' condition on ${schemaField.fieldRef}.`,
+          command: `zinkee --json automations create --name "Record created demo" --trigger-type record_created --trigger-schema ${schemaField.schemaRef} --condition-json '{"field":"${schemaField.fieldRef}","comparator":"ine","values":[{"rawValue":"","source":null}]}'`,
           raw: `{
   "name": "Record created demo",
   "trigger": {
     "type": "record_created",
     "config": {
-      "schemaId": "${schemaField.schemaRef}"
+      "schemaId": "${schemaField.schemaRef}",
+      "conditions": [
+        {
+          "field": "${schemaField.fieldRef}",
+          "comparator": "ine",
+          "values": [{"rawValue": "", "source": null}]
+        }
+      ]
     }
   }
 }`
         },
         {
-          description: `Create a record-changed automation using a real schema and field reference from this workspace (${schemaField.schemaRef} / ${schemaField.fieldRef}).`,
-          command: `zinkee --json automations create --name "Record changed demo" --trigger-type record_changed --trigger-schema ${schemaField.schemaRef} --trigger-field ${schemaField.fieldRef}`,
+          description: `Create a record-changed automation watching ${schemaField.fieldRef} on ${schemaField.schemaRef}, with an 'is not empty' condition on that field.`,
+          command: `zinkee --json automations create --name "Record changed demo" --trigger-type record_changed --trigger-schema ${schemaField.schemaRef} --trigger-field ${schemaField.fieldRef} --condition-json '{"field":"${schemaField.fieldRef}","comparator":"ine","values":[{"rawValue":"","source":null}]}'`,
           raw: `{
   "name": "Record changed demo",
   "trigger": {
     "type": "record_changed",
     "config": {
       "schemaId": "${schemaField.schemaRef}",
-      "fieldIds": ["${schemaField.fieldRef}"]
+      "fieldIds": ["${schemaField.fieldRef}"],
+      "conditions": [
+        {
+          "field": "${schemaField.fieldRef}",
+          "comparator": "ine",
+          "values": [{"rawValue": "", "source": null}]
+        }
+      ]
     }
   }
 }`
@@ -2498,17 +5246,34 @@ async function buildDynamicAutomationExamples(commandName, options = {}) {
       return buildCommandExamples([
         {
           description: "Replace the trigger with a scheduled trigger on a real automation from this workspace.",
-          command: `zinkee --json automations trigger set ${automationId} --trigger-type scheduled --cron "0 0 9 * * *"`,
+          command: `zinkee --json automations trigger set ${automationId} --trigger-type scheduled --cron "0 15 10 * * 1"`,
           raw: `{
   "type": "scheduled",
   "config": {
-    "cronExpression": "0 0 9 * * *"
+    "cronExpression": "0 15 10 * * 1"
+  }
+}`
+        },
+        {
+          description: `Replace the trigger with a record-created trigger on ${schemaField.schemaRef}, with an 'is not empty' condition on ${schemaField.fieldRef}.`,
+          command: `zinkee --json automations trigger set ${automationId} --trigger-type record_created --trigger-schema ${schemaField.schemaRef} --condition-json '{"field":"${schemaField.fieldRef}","comparator":"ine","values":[{"rawValue":"","source":null}]}'`,
+          raw: `{
+  "type": "record_created",
+  "config": {
+    "schemaId": "${schemaField.schemaRef}",
+    "conditions": [
+      {
+        "field": "${schemaField.fieldRef}",
+        "comparator": "ine",
+        "values": [{"rawValue": "", "source": null}]
+      }
+    ]
   }
 }`
         },
         {
-          description: `Replace the trigger with a record-changed trigger using a real schema and field (${schemaField.schemaRef} / ${schemaField.fieldRef}).`,
-          command: `zinkee --json automations trigger set ${automationId} --trigger-type record_changed --trigger-schema ${schemaField.schemaRef} --trigger-field ${schemaField.fieldRef} --condition ${schemaField.fieldRef}:eq:approved`,
+          description: `Replace the trigger with a record-changed trigger watching ${schemaField.fieldRef} on ${schemaField.schemaRef}.`,
+          command: `zinkee --json automations trigger set ${automationId} --trigger-type record_changed --trigger-schema ${schemaField.schemaRef} --trigger-field ${schemaField.fieldRef} --condition-json '{"field":"${schemaField.fieldRef}","comparator":"ine","values":[{"rawValue":"","source":null}]}'`,
           raw: `{
   "type": "record_changed",
   "config": {
@@ -2517,13 +5282,8 @@ async function buildDynamicAutomationExamples(commandName, options = {}) {
     "conditions": [
       {
         "field": "${schemaField.fieldRef}",
-        "comparator": "eq",
-        "values": [
-          {
-            "rawValue": "approved",
-            "source": null
-          }
-        ]
+        "comparator": "ine",
+        "values": [{"rawValue": "", "source": null}]
       }
     ]
   }
@@ -2536,11 +5296,11 @@ async function buildDynamicAutomationExamples(commandName, options = {}) {
       }
       return buildCommandExamples([
         {
-          description: "Add a create-record action with literal and trigger-based mappings from this workspace.",
-          command: `zinkee --json automations actions add ${automationId} --type create_record --name "Create follow-up" --target-schema ${schemaField.schemaRef} --map ${schemaField.fieldRef}=pending --map-json owner='{"rawValue":null,"source":{"type":"TRIGGER","id":"payload_value"}}'`,
+          description: `Add a create-record action with literal and trigger-based mappings targeting ${schemaField.schemaRef}.`,
+          command: `zinkee --json automations actions add ${automationId} --type create_record --name "Create follow-up order" --target-schema ${schemaField.schemaRef} --map ${schemaField.fieldRef}=pending --map-json owner='{"rawValue":null,"source":{"type":"TRIGGER","id":"payload_value"}}'`,
           raw: `{
   "type": "create_record",
-  "name": "Create follow-up",
+  "name": "Create follow-up order",
   "config": {
     "targetSchemaId": "${schemaField.schemaRef}",
     "fieldMapping": {
@@ -2560,7 +5320,25 @@ async function buildDynamicAutomationExamples(commandName, options = {}) {
 }`
         },
         {
-          description: "Add a search-records action with a trigger-based condition from this workspace.",
+          description: `Add an update-record action that targets the trigger record on ${schemaField.schemaRef}.`,
+          command: `zinkee --json automations actions add ${automationId} --type update_record --name "Mark record as processed" --target-schema ${schemaField.schemaRef} --use-trigger-record --map ${schemaField.fieldRef}=processed`,
+          raw: `{
+  "type": "update_record",
+  "name": "Mark record as processed",
+  "config": {
+    "targetSchemaId": "${schemaField.schemaRef}",
+    "fieldMapping": {
+      "${schemaField.fieldRef}": {
+        "rawValue": "processed",
+        "source": null
+      }
+    },
+    "useTriggerRecord": true
+  }
+}`
+        },
+        {
+          description: `Add a search-records action with a trigger-based condition on ${schemaField.schemaRef}.`,
           command: `zinkee --json automations actions add ${automationId} --type search_records --name "Find duplicates" --target-schema ${schemaField.schemaRef} --condition-json '{"field":"${schemaField.fieldRef}","comparator":"eq","values":[{"rawValue":null,"source":{"type":"TRIGGER","id":"payload_value"}}]}'`,
           raw: `{
   "type": "search_records",
@@ -2584,34 +5362,54 @@ async function buildDynamicAutomationExamples(commandName, options = {}) {
     ]
   }
 }`
-        },
-        {
-          description: "Add an HTTP request action through the generic --type path.",
-          command: `zinkee --json automations actions add ${automationId} --type http_request --name Notify --method POST --url https://example.com/hook --content-type application/json`,
-          raw: `{
+        },
+        ...connectionId ? buildCommandExamples([
+          {
+            description: `Add an HTTP request action authenticated through a stored connection (${connectionId}).`,
+            command: `zinkee --json automations actions add ${automationId} --type http_request --name "Notify external ERP" --method POST --url https://example.com/integrations/order-status --header X-Demo=codex --content-type application/json --timeout-ms 5000 --auth-mode STORED --connection ${connectionId}`,
+            raw: `{
+  "type": "http_request",
+  "name": "Notify external ERP",
+  "config": {
+    "method": "POST",
+    "url": "https://example.com/integrations/order-status",
+    "headers": {
+      "X-Demo": "codex"
+    },
+    "contentType": "application/json",
+    "timeoutMs": 5000,
+    "authMode": "STORED",
+    "connectionId": "${connectionId}"
+  }
+}`
+          }
+        ]) : buildCommandExamples([
+          {
+            description: "Add an HTTP request action through the generic --type path.",
+            command: `zinkee --json automations actions add ${automationId} --type http_request --name "Notify external ERP" --method POST --url https://example.com/integrations/order-status --content-type application/json`,
+            raw: `{
   "type": "http_request",
-  "name": "Notify",
+  "name": "Notify external ERP",
   "config": {
     "method": "POST",
-    "url": "https://example.com/hook",
+    "url": "https://example.com/integrations/order-status",
     "contentType": "application/json"
   }
 }`
-        },
+          }
+        ]),
         ...pluginId ? buildCommandExamples([
           {
             description: `Add an execute-plugin action using an active plugin from this workspace (${pluginId}).`,
-            command: `zinkee --json automations actions add ${automationId} --type execute_plugin --name "Run plugin" --plugin ${pluginId} --arg mode=safe --arg-json payload='{"dryRun":true}'`,
+            command: `zinkee --json automations actions add ${automationId} --type execute_plugin --name "Run billing plugin" --plugin ${pluginId} --arg mode=safe --arg-json steps='["one","two"]'`,
             raw: `{
   "type": "execute_plugin",
-  "name": "Run plugin",
+  "name": "Run billing plugin",
   "config": {
     "pluginId": "${pluginId}",
     "pluginArgs": {
       "mode": "safe",
-      "payload": {
-        "dryRun": true
-      }
+      "steps": ["one", "two"]
     }
   }
 }`
@@ -2639,6 +5437,21 @@ async function buildDynamicAutomationExamples(commandName, options = {}) {
     },
     "useTriggerRecord": true
   }
+}`,
+          response: `{
+  "id": "${automationWithAction.actionId}",
+  "type": "update_record",
+  "name": "Update trigger record",
+  "config": {
+    "targetSchemaId": "${schemaField.schemaRef}",
+    "fieldMapping": {
+      "${schemaField.fieldRef}": {
+        "rawValue": "ready",
+        "source": null
+      }
+    },
+    "useTriggerRecord": true
+  }
 }`
         }
       ]);
@@ -2672,6 +5485,21 @@ async function buildDynamicAutomationExamples(commandName, options = {}) {
     "apiKey": "super-secret"
   },
   "active": true
+}`,
+          response: `{
+  "id": "4fc20b5c-9353-4991-b68e-1027cb674ed4",
+  "name": "ERP API Key",
+  "type": "api_key",
+  "scope": "workspace",
+  "ownerMemberId": "6c8a3e0d-7b1f-4c98-a2e9-8b9a2e3f5b14",
+  "active": true,
+  "config": {
+    "headerName": "Authorization"
+  },
+  "createdAt": "2026-04-21T09:00:00Z",
+  "updatedAt": "2026-04-21T09:00:00Z",
+  "createdBy": "developer@zinkee.com",
+  "updatedBy": "developer@zinkee.com"
 }`
         }
       ]);
@@ -2690,6 +5518,21 @@ async function buildDynamicAutomationExamples(commandName, options = {}) {
       "headerName": "Authorization"
     }
   }
+}`,
+          response: `{
+  "id": "${connectionId}",
+  "name": "ERP API Key Updated",
+  "type": "api_key",
+  "scope": "workspace",
+  "ownerMemberId": "6c8a3e0d-7b1f-4c98-a2e9-8b9a2e3f5b14",
+  "active": true,
+  "config": {
+    "headerName": "Authorization"
+  },
+  "createdAt": "2026-04-21T09:00:00Z",
+  "updatedAt": "2026-04-21T10:15:00Z",
+  "createdBy": "developer@zinkee.com",
+  "updatedBy": "developer@zinkee.com"
 }`
         }
       ]);
@@ -2807,6 +5650,13 @@ ${index + 1}. ${example.description}
       writer.write("   Equivalent JSON payload:\n");
       for (const line of example.raw.split("\n")) {
         writer.write(`     ${line}
+`);
+      }
+    }
+    if (example.response) {
+      writer.write("   Example response:\n");
+      for (const line of example.response.split("\n")) {
+        writer.write(`     ${line}
 `);
       }
     }
@@ -2815,7 +5665,7 @@ ${index + 1}. ${example.description}
 
 // src/program.ts
 import { createRequire } from "module";
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
 
 // src/commands/config.ts
 function getCommandIo(stdout) {
@@ -5308,9 +8158,117 @@ function registerFilesCommands(program, options = {}) {
   });
 }
 
+// src/commands/logs.ts
+import { InvalidArgumentError as InvalidArgumentError5 } from "commander";
+
+// src/api/logs.ts
+function selectorValue6(selector2) {
+  return selector2.value;
+}
+var LogsApi = class {
+  constructor(client) {
+    this.client = client;
+  }
+  listLogs(schema, recordId) {
+    return this.client.getJson(
+      `/api/v2/schemas/${selectorValue6(schema)}/records/${recordId}/logs`
+    );
+  }
+};
+
+// src/commands/logs.ts
+function getCommandIo6(stdout) {
+  return stdout ?? process.stdout;
+}
+function writeLine6(stdout, value) {
+  stdout.write(`${value}
+`);
+}
+function getGlobalOptions6(command) {
+  return command.optsWithGlobals();
+}
+function emitJson6(stdout, commandName, data, ..._extra) {
+  writeLine6(
+    stdout,
+    JSON.stringify(buildJsonSuccess(data, { command: commandName }))
+  );
+}
+function toConfigurationError6(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 createLogsApi(command, filePath) {
+  try {
+    const config = readRuntimeConfig(filePath);
+    const runtime = resolveRuntimeContext(config, getGlobalOptions6(command));
+    if (!runtime.baseUrl) {
+      throw new CliError(
+        "configuration_error",
+        `Resolved profile "${runtime.profile}" is missing a base URL.`
+      );
+    }
+    return {
+      api: new LogsApi(
+        new ApiClient({
+          baseUrl: runtime.baseUrl,
+          apiKey: runtime.apiKey
+        })
+      ),
+      json: runtime.json
+    };
+  } catch (error) {
+    toConfigurationError6(filePath, error);
+  }
+}
+function parseUuidOrSlugSelector5(input) {
+  try {
+    return normalizeUuidOrSlug(input);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Invalid selector.";
+    throw new InvalidArgumentError5(message);
+  }
+}
+function isJsonObject4(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 });
+  }
+  if (isJsonObject4(data)) {
+    return [data];
+  }
+  return [{ value: data }];
+}
+function emitTable3(stdout, data) {
+  printTable(toTableRows3(data), void 0, stdout);
+}
+function registerLogsCommands(program, options = {}) {
+  const filePath = options.configPath ?? defaultConfigPath;
+  const stdout = getCommandIo6(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) {
+    const { api, json } = createLogsApi(this, filePath);
+    const data = await api.listLogs(schema, record.value);
+    if (json) {
+      emitJson6(stdout, "logs list", data, filePath);
+      return;
+    }
+    emitTable3(stdout, data);
+  });
+}
+
 // src/commands/navigation.ts
 import { readFileSync as readFileSync6 } from "fs";
-import { InvalidArgumentError as InvalidArgumentError5 } from "commander";
+import { InvalidArgumentError as InvalidArgumentError6 } from "commander";
 
 // src/api/navigation.ts
 function jsonOptions5(body, method) {
@@ -5322,7 +8280,7 @@ function jsonOptions5(body, method) {
     body: JSON.stringify(body)
   };
 }
-function selectorValue6(selector2) {
+function selectorValue7(selector2) {
   return selector2.value;
 }
 var NavigationApi = class {
@@ -5340,13 +8298,13 @@ var NavigationApi = class {
   }
   updateFolder(folder, body) {
     return this.client.requestJson(
-      `/api/v2/navigation/folders/${selectorValue6(folder)}`,
+      `/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" }
     );
   }
@@ -5359,20 +8317,20 @@ var NavigationApi = class {
 };
 
 // src/commands/navigation.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, configPath) {
-  writeLine6(stdout, JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath })));
+function emitJson7(stdout, commandName, data, configPath) {
+  writeLine7(stdout, JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath })));
 }
-function toConfigurationError6(filePath, error) {
+function toConfigurationError7(filePath, error) {
   if (error instanceof CliError) {
     throw error;
   }
@@ -5387,7 +8345,7 @@ function toConfigurationError6(filePath, error) {
 function createNavigationApi(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", `Resolved profile "${runtime.profile}" is missing a base URL.`);
     }
@@ -5402,7 +8360,7 @@ function createNavigationApi(command, filePath) {
       readOnly: runtime.readOnly
     };
   } catch (error) {
-    toConfigurationError6(filePath, error);
+    toConfigurationError7(filePath, error);
   }
 }
 function ensureWritable5(commandName, readOnly, mode) {
@@ -5414,12 +8372,12 @@ function ensureWritable5(commandName, readOnly, mode) {
     );
   }
 }
-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 parseInteger(value, flagName) {
@@ -5498,24 +8456,24 @@ function folderRows2(folders) {
 }
 function registerNavigationCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
-  const stdout = getCommandIo6(options.stdout);
+  const stdout = getCommandIo7(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) {
-      emitJson6(stdout, "navigation folders list", data, filePath);
+      emitJson7(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", parseUuidOrSlugSelector5).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", parseUuidOrSlugSelector6).action(async function action(folder) {
     const { api, json } = createNavigationApi(this, filePath);
     const data = await api.listFolders();
     const resolved = resolveFolder2(data, folder);
     if (json) {
-      emitJson6(stdout, "navigation folders get", resolved, filePath);
+      emitJson7(stdout, "navigation folders get", resolved, filePath);
       return;
     }
     printTable(folderRows2([resolved]), ["id", "order", "name", "resourceCount"], stdout);
@@ -5525,12 +8483,12 @@ function registerNavigationCommands(program, options = {}) {
     ensureWritable5("navigation folders create", readOnly, "write");
     const data = await api.createFolder(buildFolderBody(commandOptions));
     if (json) {
-      emitJson6(stdout, "navigation folders create", data, filePath);
+      emitJson7(stdout, "navigation folders create", data, filePath);
       return;
     }
-    writeLine6(stdout, `Created navigation folder "${String(data.name ?? commandOptions.name)}".`);
+    writeLine7(stdout, `Created navigation folder "${String(data.name ?? commandOptions.name)}".`);
   });
-  folders.command("update").description("Update a navigation folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector5).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", 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) {
     const { api, json, readOnly } = createNavigationApi(this, filePath);
     ensureWritable5("navigation folders update", readOnly, "write");
     const allFolders = await api.listFolders();
@@ -5541,54 +8499,54 @@ function registerNavigationCommands(program, options = {}) {
     }
     const data = await api.updateFolder({ kind: "uuid", value: resolved.id }, body);
     if (json) {
-      emitJson6(stdout, "navigation folders update", data, filePath);
+      emitJson7(stdout, "navigation folders update", data, filePath);
       return;
     }
-    writeLine6(stdout, `Updated navigation folder "${String(data.name ?? resolved.name ?? resolved.id)}".`);
+    writeLine7(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", parseUuidOrSlugSelector5).action(async function action(folder) {
+  folders.command("delete").description("Delete a navigation folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector6).action(async function action(folder) {
     const { api, json, readOnly } = createNavigationApi(this, filePath);
     ensureWritable5("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) {
-      emitJson6(stdout, "navigation folders delete", data, filePath);
+      emitJson7(stdout, "navigation folders delete", data, filePath);
       return;
     }
-    writeLine6(stdout, `Deleted navigation folder "${resolved.name ?? resolved.id}".`);
+    writeLine7(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) {
     const { api, json, readOnly } = createNavigationApi(this, filePath);
     ensureWritable5("navigation resources move", readOnly, "write");
     const allFolders = await api.listFolders();
-    const resolved = resolveFolder2(allFolders, parseUuidOrSlugSelector5(commandOptions.to));
+    const resolved = resolveFolder2(allFolders, parseUuidOrSlugSelector6(commandOptions.to));
     const data = await api.moveResource({
       resourceId,
       resourceType: commandOptions.type.toUpperCase(),
       targetFolderId: resolved.id
     });
     if (json) {
-      emitJson6(stdout, "navigation resources move", data, filePath);
+      emitJson7(stdout, "navigation resources move", data, filePath);
       return;
     }
-    writeLine6(stdout, `Moved resource "${resourceId}" to "${resolved.name ?? resolved.id}".`);
+    writeLine7(stdout, `Moved resource "${resourceId}" to "${resolved.name ?? resolved.id}".`);
   });
 }
 
 // src/commands/profiles.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(
+function emitJson8(stdout, commandName, data, configPath) {
+  writeLine8(
     stdout,
     JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath }))
   );
@@ -5631,15 +8589,15 @@ function emitProfilesTable(stdout, data) {
 }
 function registerProfilesCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
-  const stdout = getCommandIo7(options.stdout);
+  const stdout = getCommandIo8(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 (getGlobalOptions7(this).json) {
-      emitJson7(stdout, "profiles list", data, filePath);
+    if (getGlobalOptions8(this).json) {
+      emitJson8(stdout, "profiles list", data, filePath);
       return;
     }
     emitProfilesTable(stdout, data);
@@ -5648,8 +8606,8 @@ function registerProfilesCommands(program, options = {}) {
     const config = readRequiredConfig(filePath);
     const profile = getRequiredProfile(config, profileName);
     const data = toDisplayProfile(profileName, profile, config.defaultProfile);
-    if (getGlobalOptions7(this).json) {
-      emitJson7(stdout, "profiles get", data, filePath);
+    if (getGlobalOptions8(this).json) {
+      emitJson8(stdout, "profiles get", data, filePath);
       return;
     }
     emitProfilesTable(stdout, [data]);
@@ -5663,11 +8621,11 @@ function registerProfilesCommands(program, options = {}) {
       profile: profileName,
       defaultProfile: nextConfig.defaultProfile
     };
-    if (getGlobalOptions7(this).json) {
-      emitJson7(stdout, "profiles use", data, filePath);
+    if (getGlobalOptions8(this).json) {
+      emitJson8(stdout, "profiles use", data, filePath);
       return;
     }
-    writeLine7(stdout, `Using profile "${profileName}".`);
+    writeLine8(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);
@@ -5690,11 +8648,11 @@ function registerProfilesCommands(program, options = {}) {
       nextConfig.profiles[profileName] ?? {},
       nextConfig.defaultProfile
     );
-    if (getGlobalOptions7(this).json) {
-      emitJson7(stdout, "profiles add", data, filePath);
+    if (getGlobalOptions8(this).json) {
+      emitJson8(stdout, "profiles add", data, filePath);
       return;
     }
-    writeLine7(stdout, `Added profile "${profileName}".`);
+    writeLine8(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) {
@@ -5715,11 +8673,11 @@ function registerProfilesCommands(program, options = {}) {
       nextConfig.profiles[profileName] ?? {},
       nextConfig.defaultProfile
     );
-    if (getGlobalOptions7(this).json) {
-      emitJson7(stdout, "profiles update", data, filePath);
+    if (getGlobalOptions8(this).json) {
+      emitJson8(stdout, "profiles update", data, filePath);
       return;
     }
-    writeLine7(stdout, `Updated profile "${profileName}".`);
+    writeLine8(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);
@@ -5730,17 +8688,17 @@ function registerProfilesCommands(program, options = {}) {
       profile: profileName,
       defaultProfile: nextConfig.defaultProfile
     };
-    if (getGlobalOptions7(this).json) {
-      emitJson7(stdout, "profiles remove", data, filePath);
+    if (getGlobalOptions8(this).json) {
+      emitJson8(stdout, "profiles remove", data, filePath);
       return;
     }
-    writeLine7(stdout, `Removed profile "${profileName}".`);
+    writeLine8(stdout, `Removed profile "${profileName}".`);
   });
 }
 
 // src/commands/records.ts
 import { readFileSync as readFileSync7 } from "fs";
-import { InvalidArgumentError as InvalidArgumentError6 } from "commander";
+import { InvalidArgumentError as InvalidArgumentError7 } from "commander";
 
 // src/api/records.ts
 function jsonOptions6(body, method) {
@@ -5752,7 +8710,7 @@ function jsonOptions6(body, method) {
     body: JSON.stringify(body)
   };
 }
-function selectorValue7(selector2) {
+function selectorValue8(selector2) {
   return selector2.value;
 }
 var RecordsApi = class {
@@ -5767,7 +8725,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
@@ -5776,30 +8734,30 @@ var RecordsApi = class {
   queryRecords(schema, query) {
     const body = this.normalizeQueryInput(query);
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue7(schema)}/records:query`,
+      `/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) {
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue7(schema)}/records`,
+      `/api/v2/schemas/${selectorValue8(schema)}/records`,
       jsonOptions6(input, "POST")
     );
   }
   updateRecord(schema, record, input) {
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue7(schema)}/records/${selectorValue7(record)}`,
+      `/api/v2/schemas/${selectorValue8(schema)}/records/${selectorValue8(record)}`,
       jsonOptions6(input, "PATCH")
     );
   }
   deleteRecord(schema, record) {
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue7(schema)}/records/${selectorValue7(record)}`,
+      `/api/v2/schemas/${selectorValue8(schema)}/records/${selectorValue8(record)}`,
       { method: "DELETE" }
     );
   }
@@ -5834,11 +8792,17 @@ var RecordsApi = class {
 // src/parsers/expressions.ts
 var supportedComparators = /* @__PURE__ */ new Set([
   "eq",
-  "contains",
+  "neq",
   "gt",
-  "is-null",
-  "in"
+  "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) {
@@ -5870,7 +8834,7 @@ function parseSpaceExpression(input) {
   return [field.trim(), comparator.trim(), parts.slice(2).join(" ").trim()];
 }
 function normalizeValue(comparator, rawValue) {
-  if (comparator === "is-null") {
+  if (noValueComparators.has(comparator)) {
     if (rawValue.length > 0) {
       throw new Error(`Comparator "${comparator}" does not accept a value.`);
     }
@@ -5906,23 +8870,23 @@ function parseExpression(input) {
 }
 
 // src/commands/records.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, meta = {}) {
-  writeLine8(
+function emitJson9(stdout, commandName, data, configPath, meta = {}) {
+  writeLine9(
     stdout,
     JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath, ...meta }))
   );
 }
-function toConfigurationError7(filePath, error) {
+function toConfigurationError8(filePath, error) {
   if (error instanceof CliError) {
     throw error;
   }
@@ -5937,7 +8901,7 @@ function toConfigurationError7(filePath, error) {
 function createRecordsApi(command, filePath) {
   try {
     const config = readRuntimeConfig(filePath);
-    const runtime = resolveRuntimeContext(config, getGlobalOptions8(command));
+    const runtime = resolveRuntimeContext(config, getGlobalOptions9(command));
     if (!runtime.baseUrl) {
       throw new CliError(
         "configuration_error",
@@ -5956,7 +8920,7 @@ function createRecordsApi(command, filePath) {
       readOnly: runtime.readOnly
     };
   } catch (error) {
-    toConfigurationError7(filePath, error);
+    toConfigurationError8(filePath, error);
   }
 }
 function ensureWritable6(commandName, readOnly, commandMode) {
@@ -5971,24 +8935,24 @@ function ensureWritable6(commandName, readOnly, commandMode) {
     );
   }
 }
-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 parseNonNegativeInteger2(input) {
   if (!/^\d+$/.test(input.trim())) {
-    throw new InvalidArgumentError6(`Expected a non-negative integer, received "${input}".`);
+    throw new InvalidArgumentError7(`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 InvalidArgumentError6(`Expected ${label} to contain at least one value.`);
+    throw new InvalidArgumentError7(`Expected ${label} to contain at least one value.`);
   }
   return values;
 }
@@ -5997,7 +8961,7 @@ function parseExpressionValue(input) {
     return parseExpression(input);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Invalid expression.";
-    throw new InvalidArgumentError6(message);
+    throw new InvalidArgumentError7(message);
   }
 }
 function parseKeyValueAssignment(input) {
@@ -6005,7 +8969,7 @@ function parseKeyValueAssignment(input) {
     return parseKeyValue(input);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Invalid assignment.";
-    throw new InvalidArgumentError6(message);
+    throw new InvalidArgumentError7(message);
   }
 }
 function parseJsonKeyValueAssignment(input) {
@@ -6013,7 +8977,7 @@ function parseJsonKeyValueAssignment(input) {
     return parseJsonAssignment(input);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Invalid JSON assignment.";
-    throw new InvalidArgumentError6(message);
+    throw new InvalidArgumentError7(message);
   }
 }
 function collectStringValues(value, previous = []) {
@@ -6031,7 +8995,7 @@ function collectKeyValueAssignments(value, previous = []) {
 function collectJsonAssignments(value, previous = []) {
   return [...previous, parseJsonKeyValueAssignment(value)];
 }
-function isJsonObject4(value) {
+function isJsonObject5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseRawJsonObject2(input, sourceLabel) {
@@ -6045,7 +9009,7 @@ function parseRawJsonObject2(input, sourceLabel) {
       `Failed to parse JSON from ${sourceLabel}: ${message}`
     );
   }
-  if (!isJsonObject4(parsed)) {
+  if (!isJsonObject5(parsed)) {
     throw new CliError(
       "invalid_cli_usage",
       `Expected ${sourceLabel} to contain a JSON object.`
@@ -6139,7 +9103,7 @@ function readRawSetPayload2(raw) {
   if (setValue === void 0) {
     return {};
   }
-  if (!isJsonObject4(setValue)) {
+  if (!isJsonObject5(setValue)) {
     throw new CliError(
       "invalid_cli_usage",
       'Expected raw update payload field "set" to be a JSON object.'
@@ -6192,17 +9156,17 @@ function buildRecordUpdateInput(options) {
   }
   return input;
 }
-function toTableRows3(data) {
+function toTableRows4(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 }];
 }
-function emitTable3(stdout, data) {
-  printTable(toTableRows3(data), void 0, stdout);
+function emitTable4(stdout, data) {
+  printTable(toTableRows4(data), void 0, stdout);
 }
 function getQueryRecords(result) {
   return Array.isArray(result.records) ? result.records : [];
@@ -6226,9 +9190,9 @@ async function resolveSchemaSelector(api, selector2) {
 }
 function registerRecordsCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
-  const stdout = getCommandIo8(options.stdout);
+  const stdout = getCommandIo9(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", parseUuidOrSlugSelector6).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", parseUuidOrSlugSelector7).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(
@@ -6237,7 +9201,7 @@ function registerRecordsCommands(program, options = {}) {
     );
     const recordsData = getQueryRecords(data);
     if (json) {
-      emitJson8(
+      emitJson9(
         stdout,
         "records list",
         recordsData,
@@ -6246,9 +9210,9 @@ function registerRecordsCommands(program, options = {}) {
       );
       return;
     }
-    emitTable3(stdout, recordsData);
+    emitTable4(stdout, recordsData);
   });
-  records.command("query").description("Query records for a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector6).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", 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) {
     const { api, schemasApi, json } = createRecordsApi(this, filePath);
     const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
     const data = await api.queryRecords(
@@ -6257,7 +9221,7 @@ function registerRecordsCommands(program, options = {}) {
     );
     const recordsData = getQueryRecords(data);
     if (json) {
-      emitJson8(
+      emitJson9(
         stdout,
         "records query",
         recordsData,
@@ -6266,19 +9230,19 @@ function registerRecordsCommands(program, options = {}) {
       );
       return;
     }
-    emitTable3(stdout, recordsData);
+    emitTable4(stdout, recordsData);
   });
-  records.command("get").description("Get a record by UUID or slug").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector6).argument("<record>", "record uuid or slug", parseUuidOrSlugSelector6).action(async function action(schema, record) {
+  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) {
     const { api, schemasApi, json } = createRecordsApi(this, filePath);
     const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
     const data = await api.getRecord(resolvedSchema, record);
     if (json) {
-      emitJson8(stdout, "records get", data, filePath);
+      emitJson9(stdout, "records get", data, filePath);
       return;
     }
-    emitTable3(stdout, data);
+    emitTable4(stdout, data);
   });
-  records.command("create").description("Create a record").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector6).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 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) {
     const { api, schemasApi, json, readOnly } = createRecordsApi(this, filePath);
     ensureWritable6("records create", readOnly, "write");
     const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
@@ -6287,12 +9251,12 @@ function registerRecordsCommands(program, options = {}) {
       buildRecordCreateInput(commandOptions)
     );
     if (json) {
-      emitJson8(stdout, "records create", data, filePath);
+      emitJson9(stdout, "records create", data, filePath);
       return;
     }
-    writeLine8(stdout, `Created record "${getRecordIdentifier(data)}".`);
+    writeLine9(stdout, `Created record "${getRecordIdentifier(data)}".`);
   });
-  records.command("update").description("Update a record").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector6).argument("<record>", "record uuid or slug", parseUuidOrSlugSelector6).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", 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) {
     const { api, schemasApi, json, readOnly } = createRecordsApi(this, filePath);
     ensureWritable6("records update", readOnly, "write");
     const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
@@ -6302,12 +9266,12 @@ function registerRecordsCommands(program, options = {}) {
       buildRecordUpdateInput(commandOptions)
     );
     if (json) {
-      emitJson8(stdout, "records update", data, filePath);
+      emitJson9(stdout, "records update", data, filePath);
       return;
     }
-    writeLine8(stdout, `Updated record "${getRecordIdentifier(data)}".`);
+    writeLine9(stdout, `Updated record "${getRecordIdentifier(data)}".`);
   });
-  records.command("delete").description("Delete a record").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector6).argument("<record>", "record uuid or slug", parseUuidOrSlugSelector6).action(async function action(schema, record) {
+  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) {
     const { api, schemasApi, json, readOnly } = createRecordsApi(this, filePath);
     ensureWritable6("records delete", readOnly, "destructive");
     const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
@@ -6318,33 +9282,33 @@ function registerRecordsCommands(program, options = {}) {
       deleted: true
     };
     if (json) {
-      emitJson8(stdout, "records delete", data, filePath);
+      emitJson9(stdout, "records delete", data, filePath);
       return;
     }
-    writeLine8(stdout, `Deleted record "${record.value}" from schema "${schema.value}".`);
+    writeLine9(stdout, `Deleted record "${record.value}" from schema "${schema.value}".`);
   });
 }
 
 // src/commands/schemas.ts
 import { readFileSync as readFileSync8 } from "fs";
-import { InvalidArgumentError as InvalidArgumentError7 } from "commander";
-function getCommandIo9(stdout) {
+import { InvalidArgumentError as InvalidArgumentError8 } from "commander";
+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) {
-  writeLine9(
+function emitJson10(stdout, commandName, data, configPath) {
+  writeLine10(
     stdout,
     JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath }))
   );
 }
-function toConfigurationError8(filePath, error) {
+function toConfigurationError9(filePath, error) {
   if (error instanceof CliError) {
     throw error;
   }
@@ -6359,7 +9323,7 @@ function toConfigurationError8(filePath, error) {
 function createSchemasApi(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",
@@ -6378,7 +9342,7 @@ function createSchemasApi(command, filePath) {
       readOnly: runtime.readOnly
     };
   } catch (error) {
-    toConfigurationError8(filePath, error);
+    toConfigurationError9(filePath, error);
   }
 }
 function ensureWritable7(commandName, readOnly, commandMode) {
@@ -6393,12 +9357,12 @@ function ensureWritable7(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 parseBooleanFlag(input) {
@@ -6409,9 +9373,9 @@ function parseBooleanFlag(input) {
   if (["false", "0", "no", "n", "off"].includes(normalized)) {
     return false;
   }
-  throw new InvalidArgumentError7(`Expected a boolean value, received "${input}".`);
+  throw new InvalidArgumentError8(`Expected a boolean value, received "${input}".`);
 }
-function isJsonObject5(value) {
+function isJsonObject6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseRawJsonObject3(input, sourceLabel) {
@@ -6425,7 +9389,7 @@ function parseRawJsonObject3(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.`
@@ -6528,7 +9492,7 @@ function buildFieldCreateInput(options) {
   if (options.required !== void 0) {
     input.required = options.required;
   }
-  if ("config" in input && isJsonObject5(input.config) && isEmptyObject5(input.config)) {
+  if ("config" in input && isJsonObject6(input.config) && isEmptyObject5(input.config)) {
     delete input.config;
   }
   return input;
@@ -6605,23 +9569,23 @@ function isEmptyObject5(value) {
 }
 function registerSchemasCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
-  const stdout = getCommandIo9(options.stdout);
+  const stdout = getCommandIo10(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) {
-      emitJson9(stdout, "schemas list", data, filePath);
+      emitJson10(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", parseUuidOrSlugSelector7).action(async function action(schema) {
+  schemas.command("get").description("Get a schema by UUID or slug").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).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) {
-      emitJson9(stdout, "schemas get", data, filePath);
+      emitJson10(stdout, "schemas get", data, filePath);
       return;
     }
     emitSchemasTable(stdout, [data]);
@@ -6637,12 +9601,12 @@ function registerSchemasCommands(program, options = {}) {
     };
     const data = await api.createSchema(input);
     if (json) {
-      emitJson9(stdout, "schemas create", data, filePath);
+      emitJson10(stdout, "schemas create", data, filePath);
       return;
     }
-    writeLine9(stdout, `Created schema "${data.slug ?? commandOptions.slug}".`);
+    writeLine10(stdout, `Created schema "${data.slug ?? commandOptions.slug}".`);
   });
-  schemas.command("update").description("Update a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).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", 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) {
     const { api, json, readOnly } = createSchemasApi(this, filePath);
     ensureWritable7("schemas update", readOnly, "write");
     const resolvedSchema = await resolveSchemaSelector2(api, schema);
@@ -6655,12 +9619,12 @@ function registerSchemasCommands(program, options = {}) {
     }
     const data = await api.updateSchema(resolvedSchema, input);
     if (json) {
-      emitJson9(stdout, "schemas update", data, filePath);
+      emitJson10(stdout, "schemas update", data, filePath);
       return;
     }
-    writeLine9(stdout, `Updated schema "${data.slug ?? schema.value}".`);
+    writeLine10(stdout, `Updated schema "${data.slug ?? schema.value}".`);
   });
-  schemas.command("delete").description("Delete a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).action(async function action(schema) {
+  schemas.command("delete").description("Delete a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).action(async function action(schema) {
     const { api, json, readOnly } = createSchemasApi(this, filePath);
     ensureWritable7("schemas delete", readOnly, "destructive");
     const resolvedSchema = await resolveSchemaSelector2(api, schema);
@@ -6670,34 +9634,34 @@ function registerSchemasCommands(program, options = {}) {
       deleted: true
     };
     if (json) {
-      emitJson9(stdout, "schemas delete", data, filePath);
+      emitJson10(stdout, "schemas delete", data, filePath);
       return;
     }
-    writeLine9(stdout, `Deleted schema "${schema.value}".`);
+    writeLine10(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", parseUuidOrSlugSelector7).action(async function action(schema) {
+  fields.command("list").description("List fields for a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).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) {
-      emitJson9(stdout, "schemas fields list", data, filePath);
+      emitJson10(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", parseUuidOrSlugSelector7).argument("<field>", "field uuid or slug", parseUuidOrSlugSelector7).action(async function action(schema, field) {
+  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) {
     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) {
-      emitJson9(stdout, "schemas fields get", data, filePath);
+      emitJson10(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", parseUuidOrSlugSelector7).option("--type <type>", `field type (${formatSchemaFieldTypes()})`).option("--slug <slug>", "field slug").option("--label <label>", "field label").option("--required <bool>", "required flag", parseBooleanFlag).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", parseUuidOrSlugSelector8).option("--type <type>", `field type (${formatSchemaFieldTypes()})`).option("--slug <slug>", "field slug").option("--label <label>", "field label").option("--required <bool>", "required flag", parseBooleanFlag).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");
     const input = buildFieldCreateInput(commandOptions);
@@ -6709,12 +9673,12 @@ function registerSchemasCommands(program, options = {}) {
       toFieldCreateError(error, input);
     }
     if (json) {
-      emitJson9(stdout, "schemas fields create", data, filePath);
+      emitJson10(stdout, "schemas fields create", data, filePath);
       return;
     }
-    writeLine9(stdout, `Created field "${data.slug ?? commandOptions.slug}".`);
+    writeLine10(stdout, `Created field "${data.slug ?? commandOptions.slug}".`);
   });
-  fields.command("update").description("Update a field in a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).argument("<field>", "field uuid or slug", parseUuidOrSlugSelector7).option("--label <label>", "field label").option("--required <bool>", "required flag", parseBooleanFlag).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", parseUuidOrSlugSelector8).argument("<field>", "field uuid or slug", parseUuidOrSlugSelector8).option("--label <label>", "field label").option("--required <bool>", "required flag", parseBooleanFlag).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");
     const resolvedSchema = await resolveSchemaSelector2(api, schema);
@@ -6733,12 +9697,12 @@ function registerSchemasCommands(program, options = {}) {
     }
     const data = await api.updateField(resolvedSchema, resolvedField, input);
     if (json) {
-      emitJson9(stdout, "schemas fields update", data, filePath);
+      emitJson10(stdout, "schemas fields update", data, filePath);
       return;
     }
-    writeLine9(stdout, `Updated field "${data.slug ?? field.value}".`);
+    writeLine10(stdout, `Updated field "${data.slug ?? field.value}".`);
   });
-  fields.command("delete").description("Delete a field from a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).argument("<field>", "field uuid or slug", parseUuidOrSlugSelector7).action(async function action(schema, field) {
+  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) {
     const { api, json, readOnly } = createSchemasApi(this, filePath);
     ensureWritable7("schemas fields delete", readOnly, "destructive");
     const resolvedSchema = await resolveSchemaSelector2(api, schema);
@@ -6750,16 +9714,16 @@ function registerSchemasCommands(program, options = {}) {
       deleted: true
     };
     if (json) {
-      emitJson9(stdout, "schemas fields delete", data, filePath);
+      emitJson10(stdout, "schemas fields delete", data, filePath);
       return;
     }
-    writeLine9(stdout, `Deleted field "${field.value}" from schema "${schema.value}".`);
+    writeLine10(stdout, `Deleted field "${field.value}" from schema "${schema.value}".`);
   });
 }
 
 // src/commands/teamspace.ts
 import { readFileSync as readFileSync9 } from "fs";
-import { InvalidArgumentError as InvalidArgumentError8 } from "commander";
+import { InvalidArgumentError as InvalidArgumentError9 } from "commander";
 
 // src/api/teamspace.ts
 function jsonOptions7(body, method) {
@@ -6771,7 +9735,7 @@ function jsonOptions7(body, method) {
     body: JSON.stringify(body)
   };
 }
-function selectorValue8(selector2) {
+function selectorValue9(selector2) {
   return selector2.value;
 }
 var TeamspaceApi = class {
@@ -6797,13 +9761,13 @@ var TeamspaceApi = class {
   }
   updateFolder(folder, input) {
     return this.client.requestJson(
-      `/api/v2/teamspaces/folders/${selectorValue8(folder)}`,
+      `/api/v2/teamspaces/folders/${selectorValue9(folder)}`,
       jsonOptions7(input, "PATCH")
     );
   }
   deleteFolder(folder) {
     return this.client.requestJson(
-      `/api/v2/teamspaces/folders/${selectorValue8(folder)}`,
+      `/api/v2/teamspaces/folders/${selectorValue9(folder)}`,
       { method: "DELETE" }
     );
   }
@@ -6822,23 +9786,23 @@ var TeamspaceApi = class {
 };
 
 // src/commands/teamspace.ts
-function getCommandIo10(stdout) {
+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;
   }
@@ -6853,7 +9817,7 @@ function toConfigurationError9(filePath, error) {
 function createTeamspaceApi(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",
@@ -6871,7 +9835,7 @@ function createTeamspaceApi(command, filePath) {
       readOnly: runtime.readOnly
     };
   } catch (error) {
-    toConfigurationError9(filePath, error);
+    toConfigurationError10(filePath, error);
   }
 }
 function ensureWritable8(commandName, readOnly, commandMode) {
@@ -6886,21 +9850,21 @@ function ensureWritable8(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 parseNonNegativeInteger3(input) {
   if (!/^\d+$/.test(input.trim())) {
-    throw new InvalidArgumentError8(`Expected a non-negative integer, received "${input}".`);
+    throw new InvalidArgumentError9(`Expected a non-negative integer, received "${input}".`);
   }
   return Number(input);
 }
-function isJsonObject6(value) {
+function isJsonObject7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseRawJsonObject4(input, sourceLabel) {
@@ -6914,7 +9878,7 @@ function parseRawJsonObject4(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.`
@@ -6986,17 +9950,17 @@ function buildFolderUpdateInput(options) {
   }
   return input;
 }
-function toTableRows4(data) {
+function toTableRows5(data) {
   if (Array.isArray(data)) {
-    return data.map((entry) => isJsonObject6(entry) ? entry : { value: entry });
+    return data.map((entry) => isJsonObject7(entry) ? entry : { value: entry });
   }
-  if (isJsonObject6(data)) {
+  if (isJsonObject7(data)) {
     return [data];
   }
   return [{ value: data }];
 }
-function emitTable4(stdout, data) {
-  printTable(toTableRows4(data), void 0, stdout);
+function emitTable5(stdout, data) {
+  printTable(toTableRows5(data), void 0, stdout);
 }
 function getFolderIdentifier(folder) {
   return typeof folder.id === "string" ? folder.id : typeof folder.name === "string" ? folder.name : "unknown";
@@ -7052,63 +10016,63 @@ async function resolveFolderSelector2(api, selector2) {
 }
 function registerTeamspaceCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
-  const stdout = getCommandIo10(options.stdout);
+  const stdout = getCommandIo11(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) {
     const { api, json } = createTeamspaceApi(this, filePath);
     const data = await api.listFolders(Boolean(commandOptions.includeResources));
     if (json) {
-      emitJson10(stdout, "teamspace folders list", data, filePath);
+      emitJson11(stdout, "teamspace folders list", data, filePath);
       return;
     }
-    emitTable4(stdout, data);
+    emitTable5(stdout, data);
   });
-  folders.command("get").description("Get a teamspace folder by exact name or UUID").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector8).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", parseUuidOrSlugSelector9).option("--include-resources", "include nested resources").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) {
-      emitJson10(stdout, "teamspace folders get", data, filePath);
+      emitJson11(stdout, "teamspace folders get", data, filePath);
       return;
     }
-    emitTable4(stdout, data);
+    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) {
     const { api, json, readOnly } = createTeamspaceApi(this, filePath);
     ensureWritable8("teamspace folders create", readOnly, "write");
     const data = await api.createFolder(buildFolderCreateInput(commandOptions));
     if (json) {
-      emitJson10(stdout, "teamspace folders create", data, filePath);
+      emitJson11(stdout, "teamspace folders create", data, filePath);
       return;
     }
-    writeLine10(stdout, `Created folder "${getFolderIdentifier(data)}".`);
+    writeLine11(stdout, `Created folder "${getFolderIdentifier(data)}".`);
   });
-  folders.command("update").description("Update a teamspace folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector8).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", 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) {
     const { api, json, readOnly } = createTeamspaceApi(this, filePath);
     ensureWritable8("teamspace folders update", readOnly, "write");
     const resolvedFolder = await resolveFolderSelector2(api, folder);
     const data = await api.updateFolder(resolvedFolder, buildFolderUpdateInput(commandOptions));
     if (json) {
-      emitJson10(stdout, "teamspace folders update", data, filePath);
+      emitJson11(stdout, "teamspace folders update", data, filePath);
       return;
     }
-    writeLine10(stdout, `Updated folder "${getFolderIdentifier(data)}".`);
+    writeLine11(stdout, `Updated folder "${getFolderIdentifier(data)}".`);
   });
-  folders.command("delete").description("Delete a teamspace folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector8).action(async function action(folder) {
+  folders.command("delete").description("Delete a teamspace folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector9).action(async function action(folder) {
     const { api, json, readOnly } = createTeamspaceApi(this, filePath);
     ensureWritable8("teamspace folders delete", readOnly, "destructive");
     const resolvedFolder = await resolveFolderSelector2(api, folder);
     const data = await api.deleteFolder(resolvedFolder);
     if (json) {
-      emitJson10(stdout, "teamspace folders delete", data, filePath);
+      emitJson11(stdout, "teamspace folders delete", data, filePath);
       return;
     }
-    writeLine10(stdout, `Deleted folder "${resolvedFolder.value}".`);
+    writeLine11(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", parseUuidOrSlugSelector8).requiredOption("--to <folder>", "target folder", parseUuidOrSlugSelector8).action(async function action(resource, commandOptions) {
+  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) {
     const { api, json, readOnly } = createTeamspaceApi(this, filePath);
     ensureWritable8("teamspace resources publish", readOnly, "write");
     const folder = await resolveFolderSelector2(api, commandOptions.to);
@@ -7117,20 +10081,20 @@ function registerTeamspaceCommands(program, options = {}) {
       targetFolderId: folder.value
     });
     if (json) {
-      emitJson10(stdout, "teamspace resources publish", data, filePath);
+      emitJson11(stdout, "teamspace resources publish", data, filePath);
       return;
     }
-    writeLine10(stdout, `Published resource "${resource.value}" to folder "${folder.value}".`);
+    writeLine11(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", parseUuidOrSlugSelector8).action(async function action(resource) {
+  resources.command("unpublish").description("Unpublish a resource from teamspace").argument("<resource>", "resource UUID or exact name", parseUuidOrSlugSelector9).action(async function action(resource) {
     const { api, json, readOnly } = createTeamspaceApi(this, filePath);
     ensureWritable8("teamspace resources unpublish", readOnly, "write");
     const data = await api.unpublishResource(resource.value);
     if (json) {
-      emitJson10(stdout, "teamspace resources unpublish", data, filePath);
+      emitJson11(stdout, "teamspace resources unpublish", data, filePath);
       return;
     }
-    writeLine10(stdout, `Unpublished resource "${resource.value}".`);
+    writeLine11(stdout, `Unpublished resource "${resource.value}".`);
   });
 }
 
@@ -7138,7 +10102,7 @@ function registerTeamspaceCommands(program, options = {}) {
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
 function buildProgram(options = {}) {
-  const program = new Command9();
+  const program = new Command10();
   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");
   registerProfilesCommands(program, options);
   registerAutomationsCommands(program, options);
@@ -7149,6 +10113,7 @@ function buildProgram(options = {}) {
   registerSchemasCommands(program, options);
   registerRecordsCommands(program, options);
   registerCommentsCommands(program, options);
+  registerLogsCommands(program, options);
   registerTeamspaceCommands(program, options);
   return program;
 }