zinkee 0.1.2 → 0.1.7

package/src/utils/examples.ts

@@ -14,6 +14,7 @@ export interface CommandExample {
   command: string;
   description: string;
   raw?: string;
+  response?: string;
 }
 
 export interface ExampleContextOptions {
@@ -27,6 +28,7 @@ export function buildCommandExample(example: CommandExample): CommandExample {
     command: example.command,
     description: example.description,
     raw: example.raw,
+    response: example.response,
   };
 }
 
@@ -37,82 +39,2781 @@ export function buildCommandExamples(examples: readonly CommandExample[]): reado
 const SAMPLE_UUID = "550e8400-e29b-41d4-a716-446655440001";
 
 const specificExamples: Record<string, readonly CommandExample[]> = {
+  "profiles list": buildCommandExamples([
+    {
+      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"
+  }
+]`,
+    },
+  ]),
+  "profiles get": buildCommandExamples([
+    {
+      description: "Show one profile by name.",
+      command: "zinkee --json profiles get prod",
+      response: `{
+  "name": "prod",
+  "isDefault": true,
+  "apiKey": "********cdef",
+  "baseUrl": "https://api.zinkee.com"
+}`,
+    },
+  ]),
+  "profiles use": buildCommandExamples([
+    {
+      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"
+}`,
+    },
+  ]),
+  "profiles add": buildCommandExamples([
+    {
+      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"
+}`,
+    },
+  ]),
+  "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: "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"
+}`,
+    },
+  ]),
+  "profiles remove": buildCommandExamples([
+    {
+      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"
+}`,
+    },
+  ]),
+  "config path": buildCommandExamples([
+    {
+      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:
+        "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: "Minimal create with just name and slug.",
+      command: 'zinkee --json schemas create --name Leads --slug leads',
+      raw: `{
+  "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"
+}`,
+    },
+  ]),
+  "schemas update": buildCommandExamples([
+    {
+      description: "Rename a schema and change its slug.",
+      command:
+        'zinkee --json schemas update contacts --name "Customer Contacts" --slug customer-contacts',
+      raw: `{
+  "set": {
+    "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
+  },
+  "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
+  }
+}`,
+    },
+  ]),
+  "schemas fields update": buildCommandExamples([
+    {
+      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: `{
+  "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: "Make a field required.",
+      command: 'zinkee --json schemas fields update contacts status --required true',
+      raw: `{
+  "set": {
+    "required": true
+  }
+}`,
+    },
+    {
+      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: `{
+  "set": {
+    "config": {
+      "formatOptions": {
+        "format": "percent",
+        "decimals": 1
+      }
+    }
+  }
+}`,
+    },
+  ]),
   "records query": 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: "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: `{
+  "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:
+        "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: `{
+  "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: "Text contains search.",
+      command:
+        'zinkee --json records query contacts --select id,contact-name,contact-email --where "contact-name contains Lovelace" --limit 50',
+      raw: `{
+  "select": ["id", "contact-name", "contact-email"],
+  "where": [
+    { "field": "contact-name", "op": "contains", "value": "Lovelace" }
+  ],
+  "page": { "offset": 0, "size": 50 }
+}`,
+    },
+    {
+      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: `{
+  "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" }
+  ]
+}`,
     },
   ]),
   "records create": 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: "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: `{
+  "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"
+  }
+}`,
+    },
+    {
+      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"
+  }
+}`,
+    },
+  ]),
+  "records update": buildCommandExamples([
+    {
+      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: `{
+  "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"
+  }
+}`,
+    },
+    {
+      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"]
+}`,
+    },
+  ]),
+  "comments create": buildCommandExamples([
+    {
+      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: `{
+  "content": [
+    {
+      "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." }
+  ]
+}`,
+    },
+    {
+      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: `{
+  "content": [
+    { "type": "TEXT", "value": "Assigning to " },
+    { "type": "MENTION", "value": "9f8e7d6c-5b4a-3c2d-1e0f-a1b2c3d4e5f6" },
+    { "type": "TEXT", "value": " for follow up." }
+  ]
+}`,
+    },
+  ]),
+  "files download": buildCommandExamples([
+    {
+      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"
+}`,
+    },
+  ]),
+  "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": "€"
+        },
+        "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"
+    }
+  }
+]`,
     },
   ]),
-  "files download": buildCommandExamples([
+  "automations plugins get": buildCommandExamples([
     {
-      description: "Download a file to disk in JSON mode",
-      command: `zinkee --json files download ${SAMPLE_UUID} --output ./download.bin`,
+      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"
+  }
+}`,
     },
   ]),
-  "navigation resources move": buildCommandExamples([
+  "automations connections list": 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: "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"
+    }
+  }
+]`,
     },
   ]),
-  "teamspace resources publish": buildCommandExamples([
+  "automations connections get": buildCommandExamples([
     {
-      description: "Publish a resource into a teamspace folder",
-      command: `zinkee --json teamspace resources publish ${SAMPLE_UUID} --to "Customer Success"`,
+      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"
+}`,
     },
   ]),
-  "displays widgets create": buildCommandExamples([
+  "automations connections delete": 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: "Delete one stored connection (returns no body).",
+      command: "zinkee --json automations connections delete connection-1",
     },
   ]),
   "automations create": 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"',
+        "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 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',
+        "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"
+      "schemaId": "leads",
+      "conditions": [
+        {
+          "field": "status",
+          "comparator": "ine",
+          "values": [{"rawValue": "", "source": null}]
+        }
+      ]
     }
   }
 }`,
     },
     {
       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',
+        "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"]
+      "fieldIds": ["status"],
+      "conditions": [
+        {
+          "field": "status",
+          "comparator": "ine",
+          "values": [{"rawValue": "", "source": null}]
+        }
+      ]
     }
   }
 }`,
@@ -120,32 +2821,63 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
   ]),
   "automations update": buildCommandExamples([
     {
-      description: "Patch automation metadata using the backend set/unset contract",
+      description:
+        "Update automation description and move it to a folder. Supported patch paths: name, description, folderId.",
       command:
-        'zinkee --json automations update automation-1 --raw \'{"set":{"description":"Updated by CLI docs"},"unset":["folderId"]}\'',
+        'zinkee --json automations update automation-1 --description "Updated by an agent" --folder cdfc14e3-3169-4ffb-8d9b-b11858a9240f',
       raw: `{
   "set": {
-    "description": "Updated by CLI docs"
-  },
+    "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 trigger",
-      command: 'zinkee --json automations trigger set automation-1 --trigger-type scheduled --cron "0 0 9 * * *"',
+      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 0 9 * * *"
+    "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 and a literal condition",
+      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 status:eq:approved',
+        `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": {
@@ -154,38 +2886,34 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
     "conditions": [
       {
         "field": "status",
-        "comparator": "eq",
-        "values": [
-          {
-            "rawValue": "approved",
-            "source": null
-          }
-        ]
+        "comparator": "ine",
+        "values": [{"rawValue": "", "source": null}]
       }
     ]
   }
 }`,
     },
     {
-      description: "Replace the trigger with a webhook trigger using an existing webhook endpoint id",
+      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 550e8400-e29b-41d4-a716-446655440001',
+        "zinkee --json automations trigger set automation-1 --trigger-type webhook --webhook-endpoint-id b3cb4283-97ab-4d94-9e6f-82d0ee5cee24",
       raw: `{
   "type": "webhook",
   "config": {
-    "webhookEndpointId": "550e8400-e29b-41d4-a716-446655440001"
+    "webhookEndpointId": "b3cb4283-97ab-4d94-9e6f-82d0ee5cee24"
   }
 }`,
     },
   ]),
   "automations actions add": buildCommandExamples([
     {
-      description: "Add a create-record action with literal and trigger-based field mappings",
+      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" --target-schema followups --map status=pending --map-json owner=\'{"rawValue":null,"source":{"type":"TRIGGER","id":"payload_value"}}\'',
+        '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",
+  "name": "Create follow-up order",
   "config": {
     "targetSchemaId": "followups",
     "fieldMapping": {
@@ -193,21 +2921,51 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
         "rawValue": "pending",
         "source": null
       },
-      "owner": {
-        "rawValue": null,
-        "source": {
-          "type": "TRIGGER",
-          "id": "payload_value"
-        }
+      "description": {
+        "rawValue": "Created by automation",
+        "source": null
       }
     }
   }
 }`,
     },
     {
-      description: "Add a search-records action with a trigger-based condition",
+      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"}}]}\'',
+        `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",
@@ -232,34 +2990,39 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
 }`,
     },
     {
-      description: "Add an HTTP request action through the generic --type path",
+      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 --method POST --url https://example.com/hook --content-type application/json',
+        '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",
+  "name": "Notify external ERP",
   "config": {
     "method": "POST",
-    "url": "https://example.com/hook",
-    "contentType": "application/json"
+    "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 'clone-budget' with an active id from 'zinkee --json automations plugins list'.",
+        "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 plugin" --plugin clone-budget --arg mode=safe --arg-json payload=\'{"dryRun":true}\'',
+        `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 plugin",
+  "name": "Run billing plugin",
   "config": {
-    "pluginId": "clone-budget",
+    "pluginId": "demo-plugin",
     "pluginArgs": {
       "mode": "safe",
-      "payload": {
-        "dryRun": true
-      }
+      "steps": ["one", "two"]
     }
   }
 }`,
@@ -267,7 +3030,8 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
   ]),
   "automations actions update": buildCommandExamples([
     {
-      description: "Update a record action using the trigger record without sending conditions",
+      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: `{
@@ -283,19 +3047,57 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
     },
     "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 flow entry actions and transitions",
-      command: 'zinkee --json automations flow set automation-1 --entry action-1 --transition action-1:action-2',
+      description:
+        "Set one entry action and chain two transitions (action-1 → action-2 → 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"
     }
   ]
 }`,
@@ -304,9 +3106,9 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
   "automations webhook set": buildCommandExamples([
     {
       description:
-        "Configure webhook ingestion paths and field mappings for a webhook automation. This config is separate from the webhook trigger itself.",
+        "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 --active --idempotency-key-path "$.id" --event-type-path "$.type" --allowed-event-type frontend.demo.created --field-mapping \'{"variable":"external_id","jsonPath":"$.data.id"}\'',
+        `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",
@@ -318,14 +3120,30 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
       "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",
+      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',
+        `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",
@@ -337,14 +3155,30 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
     "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",
+      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"}}}\'',
+        `zinkee --json automations connections update connection-1 --raw '{"set":{"name":"ERP API Key Updated","config":{"headerName":"Authorization"}}}'`,
       raw: `{
   "set": {
     "name": "ERP API Key Updated",
@@ -352,6 +3186,66 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
       "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
 }`,
     },
   ]),
@@ -359,34 +3253,6 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
 
 function fallbackExamples(commandName: string): readonly CommandExample[] {
   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 [];
   }
@@ -594,33 +3460,51 @@ async function buildDynamicAutomationExamples(
       "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}`,
+            `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}`,
+            `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}]
+        }
+      ]
     }
   }
 }`,
@@ -633,18 +3517,36 @@ async function buildDynamicAutomationExamples(
       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`,
+            `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": {
@@ -653,13 +3555,8 @@ async function buildDynamicAutomationExamples(
     "conditions": [
       {
         "field": "${schemaField.fieldRef}",
-        "comparator": "eq",
-        "values": [
-          {
-            "rawValue": "approved",
-            "source": null
-          }
-        ]
+        "comparator": "ine",
+        "values": [{"rawValue": "", "source": null}]
       }
     ]
   }
@@ -672,11 +3569,12 @@ async function buildDynamicAutomationExamples(
       }
       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": {
@@ -696,7 +3594,26 @@ async function buildDynamicAutomationExamples(
 }`,
         },
         {
-          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",
@@ -721,35 +3638,56 @@ async function buildDynamicAutomationExamples(
   }
 }`,
         },
-        {
-          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}'`,
+                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 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"]
     }
   }
 }`,
@@ -778,6 +3716,21 @@ async function buildDynamicAutomationExamples(
     },
     "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
+  }
 }`,
         },
       ]);
@@ -812,6 +3765,21 @@ async function buildDynamicAutomationExamples(
     "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"
 }`,
         },
       ]);
@@ -830,6 +3798,21 @@ async function buildDynamicAutomationExamples(
       "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"
 }`,
         },
       ]);