zinkee 0.1.24 → 0.1.26

package/src/utils/examples.test.ts

@@ -200,6 +200,25 @@ describe("getCommandExamples", () => {
     }
   });
 
+  it("does not teach legacy system columns in display widget examples", () => {
+    const legacyColumns = ["id", "createdat", "updatedat", "createdby", "updatedby"];
+    const commands = ["displays widgets create", "displays widgets update", "displays list", "displays get"];
+
+    for (const command of commands) {
+      for (const example of getCommandExamples(command)) {
+        for (const column of legacyColumns) {
+          expect(example.command).not.toContain(`--field ${column}`);
+        }
+
+        const examplePayloads = [example.raw, example.response].filter(Boolean);
+        for (const payload of examplePayloads) {
+          expect(payload).not.toMatch(/"fields"\s*:\s*\[[^\]]*"(id|createdat|updatedat|createdby|updatedby)"/);
+          expect(payload).not.toMatch(/"fieldCalc"\s*:\s*"(id|createdat|updatedat|createdby|updatedby)"/);
+        }
+      }
+    }
+  });
+
   it("covers REFERENCE, MEMBER and DATE variants in displays variables create", () => {
     const examples = getCommandExamples("displays variables create");
     const rawPayloads = examples.map((example) => example.raw ?? "");
@@ -211,14 +230,23 @@ describe("getCommandExamples", () => {
     expect(rawPayloads.some((raw) => raw.includes('"dynamicOption": "thisMonth"'))).toBe(true);
   });
 
-  it("covers SCHEMA, WORKFLOW and DISPLAY variants in navigation resources move", () => {
+  it("documents navigation resources move as schema-only with no resourceType", () => {
     const examples = getCommandExamples("navigation resources move");
     const rawPayloads = examples.map((example) => example.raw ?? "");
 
-    expect(examples.length).toBeGreaterThanOrEqual(5);
-    for (const resourceType of ["SCHEMA", "WORKFLOW", "DISPLAY", "SCHEDULE"]) {
-      expect(rawPayloads.some((raw) => raw.includes(`"resourceType": "${resourceType}"`))).toBe(true);
+    expect(examples.length).toBeGreaterThanOrEqual(2);
+    // Navigation only moves schemas now, so the payload no longer carries a
+    // resourceType and the example commands must not pass --type.
+    for (const raw of rawPayloads) {
+      expect(raw).not.toContain("resourceType");
+    }
+    for (const example of examples) {
+      expect(example.command).not.toContain("--type");
     }
+    // Covers moving into a folder and back to the root folder.
+    expect(
+      rawPayloads.some((raw) => raw.includes('"targetFolderId": "00000000-0000-0000-0000-000000000000"')),
+    ).toBe(true);
   });
 
   it("covers slug and UUID variants in teamspace resources publish", () => {

package/src/utils/examples.ts

@@ -818,12 +818,12 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
   ]),
   "navigation resources move": buildCommandExamples([
     {
-      description: "Move a schema into a navigation folder.",
+      description:
+        "Move a schema into a navigation folder. Only schemas can be moved; the navigation menu holds databases.",
       command:
-        'zinkee --json navigation resources move 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --type SCHEMA --to Sales',
+        'zinkee --json navigation resources move 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --to Sales',
       raw: `{
   "resourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
-  "resourceType": "SCHEMA",
   "targetFolderId": "84a0fca4-37ef-4c83-a8ed-9ef67ad9324a"
 }`,
       response: `{
@@ -832,43 +832,12 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
 }`,
     },
     {
-      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).",
+      description: "Move a schema back to the root folder (root is always UUID 00000000-0000-0000-0000-000000000000).",
       command:
-        'zinkee --json navigation resources move 5223cbc8-8c6c-4694-93bc-dd176364df9b --type SCHEMA --to 00000000-0000-0000-0000-000000000000',
+        'zinkee --json navigation resources move 5223cbc8-8c6c-4694-93bc-dd176364df9b --to 00000000-0000-0000-0000-000000000000',
       raw: `{
   "resourceId": "5223cbc8-8c6c-4694-93bc-dd176364df9b",
-  "resourceType": "SCHEMA",
   "targetFolderId": "00000000-0000-0000-0000-000000000000"
-}`,
-    },
-    {
-      description: "Move a schedule resource.",
-      command:
-        'zinkee --json navigation resources move a1b2c3d4-e5f6-7890-1234-567890abcdef --type SCHEDULE --to Operations',
-      raw: `{
-  "resourceId": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
-  "resourceType": "SCHEDULE",
-  "targetFolderId": "b8c9d0e1-f2a3-4b5c-6d7e-8f9012345678"
 }`,
     },
   ]),
@@ -1314,7 +1283,7 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
       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"}'`,
+        `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type table --name Customers --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":12,"h":8}' --field contact-name --field status --field amount --sort '{"fieldId":"contact-name","direction":"ASC"}'`,
       raw: `{
   "type": "TABLE_OR_SUBTABLE",
   "source": {
@@ -1329,11 +1298,11 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
   },
   "query": {
     "sorts": [
-      { "fieldId": "id", "direction": "DESC" }
+      { "fieldId": "contact-name", "direction": "ASC" }
     ]
   },
   "view": {
-    "fields": ["id", "contact-name", "status"]
+    "fields": ["contact-name", "status", "amount"]
   }
 }`,
       response: `{
@@ -1418,7 +1387,7 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
     {
       description: "Create a bars CHART widget with a monthly time-serie x-axis and two y-axis series.",
       command:
-        `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type CHART --name "Revenue by month" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":8,"h":6}' --chart-type bars --x-axis-field due-date --x-axis-date-format MONTH_YEAR --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#4B9CD3","axisType":"PRIMARY"}' --y-axis-serie '{"typeCalc":"COUNT","fieldCalc":"id","color":"#E57373","axisType":"SECONDARY"}' --legend '{"position":"bottom"}'`,
+        `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type CHART --name "Revenue by month" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":8,"h":6}' --chart-type bars --x-axis-field due-date --x-axis-date-format MONTH_YEAR --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#4B9CD3","axisType":"PRIMARY"}' --y-axis-serie '{"typeCalc":"COUNT","fieldCalc":"contact-name","color":"#E57373","axisType":"SECONDARY"}' --legend '{"position":"bottom"}'`,
       raw: `{
   "type": "CHART",
   "source": {
@@ -1443,7 +1412,7 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
       },
       {
         "typeCalc": "COUNT",
-        "fieldCalc": "id",
+        "fieldCalc": "contact-name",
         "color": "#E57373",
         "axisType": "SECONDARY"
       }
@@ -1515,9 +1484,10 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
 }`,
     },
     {
-      description: "Create a TIMELINE widget.",
+      description:
+        "Create a TIMELINE widget via flags. The typed view state lives in view.viewAdditionalProperties.viewState; field references there must be UUIDs (slugs are only resolved in --field). cardConfig uses category1/category2/category4 (no category3). Use --view-state for UI scalars (granularity, sidebarWidth, show* ...).",
       command:
-        `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type TIMELINE --name "Customer schedule" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":12,"h":6}' --field contact-name --field due-date`,
+        `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type TIMELINE --name "Customer schedule" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":12,"h":6}' --field c60b8526-5835-4c9f-aecd-9a16c7704a34 --field a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890 --field c52efe3f-2825-4c60-a7e3-34dd4c1ce043 --field d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90 --start-date-field d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90 --end-date-field e5f6a7b8-c9d0-1e2f-3a4b-5c6d7e8f9012 --label-field c60b8526-5835-4c9f-aecd-9a16c7704a34 --group-field a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890 --subgroup-field c60b8526-5835-4c9f-aecd-9a16c7704a34 --progress-field c52efe3f-2825-4c60-a7e3-34dd4c1ce043 --card-title-field c60b8526-5835-4c9f-aecd-9a16c7704a34 --card-category1-field a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890 --card-category2-field d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90 --card-category4-field c52efe3f-2825-4c60-a7e3-34dd4c1ce043 --card-description-field c60b8526-5835-4c9f-aecd-9a16c7704a34 --view-state '{"granularity":"month","sidebarWidth":300,"showUngroupedEvents":true,"showUnsubgroupedEvents":true}'`,
       raw: `{
   "type": "TIMELINE",
   "source": {
@@ -1529,15 +1499,43 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
   },
   "presentation": { "name": "Customer schedule" },
   "view": {
-    "fields": ["contact-name", "due-date"]
+    "fields": [
+      "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+      "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+      "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+      "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90"
+    ],
+    "viewAdditionalProperties": {
+      "viewState": {
+        "granularity": "month",
+        "sidebarWidth": 300,
+        "showUngroupedEvents": true,
+        "showUnsubgroupedEvents": true,
+        "fieldMapping": {
+          "startDateField": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+          "endDateField": "e5f6a7b8-c9d0-1e2f-3a4b-5c6d7e8f9012",
+          "labelField": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+          "groupField": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+          "subgroupField": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+          "progressField": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+          "cardConfig": {
+            "titleField": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+            "category1Field": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+            "category2Field": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+            "category4Field": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+            "descriptionField": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+          }
+        }
+      }
+    }
   }
 }`,
     },
     {
       description:
-        "Create a KANBAN widget with a status filter and groupsExpanded config (rich query/view requires --raw).",
+        "Create a KANBAN widget via flags. The typed view state lives in view.viewAdditionalProperties.viewState; field references there must be UUIDs (slugs are only resolved in --field). cardConfig uses category1/category2/category3 (no category4). --aggregation-method/--aggregation-field set the card aggregation; use --view-state for UI scalars.",
       command:
-        `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --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}}}'`,
+        `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type KANBAN --name "Status board" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":12,"h":8}' --field c60b8526-5835-4c9f-aecd-9a16c7704a34 --field a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890 --field c52efe3f-2825-4c60-a7e3-34dd4c1ce043 --field d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90 --column-field a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890 --swimlane-field c60b8526-5835-4c9f-aecd-9a16c7704a34 --card-title-field c60b8526-5835-4c9f-aecd-9a16c7704a34 --card-category1-field a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890 --card-category2-field d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90 --card-category3-field c52efe3f-2825-4c60-a7e3-34dd4c1ce043 --card-description-field c60b8526-5835-4c9f-aecd-9a16c7704a34 --aggregation-method sum --aggregation-field c52efe3f-2825-4c60-a7e3-34dd4c1ce043 --view-state '{"hideEmptyColumns":false,"showNoValueColumn":true,"showNoValueSwimlane":true}'`,
       raw: `{
   "type": "KANBAN",
   "source": {
@@ -1548,28 +1546,43 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
     "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 }
+    "fields": [
+      "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+      "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+      "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+      "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90"
+    ],
+    "viewAdditionalProperties": {
+      "viewState": {
+        "hideEmptyColumns": false,
+        "showNoValueColumn": true,
+        "showNoValueSwimlane": true,
+        "fieldMapping": {
+          "columnField": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+          "swimlaneField": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+          "cardConfig": {
+            "titleField": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+            "category1Field": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+            "category2Field": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+            "category3Field": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+            "descriptionField": "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+          },
+          "aggregationConfig": {
+            "method": "sum",
+            "fieldId": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043"
+          }
+        }
+      }
+    }
   }
 }`,
     },
     {
-      description: "Create a HIERARCHY widget rooted on a parent field.",
+      description:
+        "Create a HIERARCHY widget via flags. Declare columns once (--hierarchy-label, repeatable --hierarchy-info <id:name>, --hierarchy-number <id:name:aggregation>), map the root level (the view's own table) with --hierarchy-root-* and add each child level as a JSON object with --hierarchy-child. label is required per level; info/number mappings are optional. Column ids (e.g. col_1779975207355_zfndknslw) are unique opaque identifiers you choose — not the column name — and are reused as columnId in every mapping. All field references must be UUIDs.",
       command:
-        `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --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"}}}'`,
+        `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type HIERARCHY --name "Org tree" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":12,"h":6}' --field c60b8526-5835-4c9f-aecd-9a16c7704a34 --field a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890 --field c52efe3f-2825-4c60-a7e3-34dd4c1ce043 --hierarchy-label "Name" --hierarchy-info "col_1779975207355_zfndknslw:Status" --hierarchy-info "col_1779975243018_qm4t7xb2pa:Description" --hierarchy-number "col_1779975261490_h8kd3nv9ws:Total amount:SUM" --hierarchy-root-name "Customers" --hierarchy-root-label-field c60b8526-5835-4c9f-aecd-9a16c7704a34 --hierarchy-root-info "col_1779975207355_zfndknslw:a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890" --hierarchy-root-number "col_1779975261490_h8kd3nv9ws:c52efe3f-2825-4c60-a7e3-34dd4c1ce043" --hierarchy-child '{"name":"Projects","schemaId":"3ec9cdef-7e0a-4cdd-8019-8fb9281f5d6f","childFieldId":"80deefae-af3d-4000-b322-bfe1594f8073","labelFieldId":"50dbef0b-7e0a-4fdd-8019-8fb9281f5d70","infoMappings":[{"columnId":"col_1779975243018_qm4t7xb2pa","fieldId":"60dcef0c-8f1b-4eee-9120-9fc0392f6e71"}],"numberMappings":[{"columnId":"col_1779975261490_h8kd3nv9ws","fieldId":"70ddef0d-9f2c-4fff-a221-afd0493f7f72"}]}'`,
       raw: `{
   "type": "HIERARCHY",
   "source": {
@@ -1581,9 +1594,46 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
   },
   "presentation": { "name": "Org tree" },
   "view": {
-    "fields": ["contact-name", "status"],
+    "fields": [
+      "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+      "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+      "c52efe3f-2825-4c60-a7e3-34dd4c1ce043"
+    ],
     "hierarchyConfig": {
-      "parentFieldId": "contact-name"
+      "columns": {
+        "label": "Name",
+        "infos": [
+          { "id": "col_1779975207355_zfndknslw", "name": "Status" },
+          { "id": "col_1779975243018_qm4t7xb2pa", "name": "Description" }
+        ],
+        "numbers": [
+          { "id": "col_1779975261490_h8kd3nv9ws", "name": "Total amount", "aggregation": "SUM" }
+        ]
+      },
+      "rootLevel": {
+        "name": "Customers",
+        "labelFieldId": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+        "infoMappings": [
+          { "columnId": "col_1779975207355_zfndknslw", "fieldId": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890" }
+        ],
+        "numberMappings": [
+          { "columnId": "col_1779975261490_h8kd3nv9ws", "fieldId": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043" }
+        ]
+      },
+      "childLevels": [
+        {
+          "name": "Projects",
+          "schemaId": "3ec9cdef-7e0a-4cdd-8019-8fb9281f5d6f",
+          "childFieldId": "80deefae-af3d-4000-b322-bfe1594f8073",
+          "labelFieldId": "50dbef0b-7e0a-4fdd-8019-8fb9281f5d70",
+          "infoMappings": [
+            { "columnId": "col_1779975243018_qm4t7xb2pa", "fieldId": "60dcef0c-8f1b-4eee-9120-9fc0392f6e71" }
+          ],
+          "numberMappings": [
+            { "columnId": "col_1779975261490_h8kd3nv9ws", "fieldId": "70ddef0d-9f2c-4fff-a221-afd0493f7f72" }
+          ]
+        }
+      ]
     }
   }
 }`,
@@ -1593,13 +1643,13 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
     {
       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`,
+        `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 11111111-1111-4111-a111-111111111111 --layout '{"x":1,"y":2,"w":8,"h":4}' --field contact-name --field status --field amount --name "Revenue Updated" --widget-read-only`,
       raw: `{
   "placement": {
     "layout": { "x": 1, "y": 2, "w": 8, "h": 4 }
   },
   "view": {
-    "fields": ["id", "contact-name", "status"]
+    "fields": ["contact-name", "status", "amount"]
   },
   "presentation": { "name": "Revenue Updated" },
   "behavior": { "readOnly": true }
@@ -2421,7 +2471,7 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
     "resources": [
       {
         "id": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
-        "name": "Contacts",
+        "name": "Customer records",
         "type": "SCHEMA",
         "isInSpace": false,
         "additionalProperties": {}
@@ -2445,19 +2495,10 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
     "resources": [
       {
         "id": "3f8a2c1b-9d4e-4a5b-8c6d-7e8f90123456",
-        "name": "Quote approval",
-        "type": "WORKFLOW",
+        "name": "Shipments",
+        "type": "SCHEMA",
         "isInSpace": false,
         "additionalProperties": {}
-      },
-      {
-        "id": "0f6f062f-1478-4df2-96a1-c495d037d260",
-        "name": "Executive Revenue",
-        "type": "DISPLAY",
-        "isInSpace": true,
-        "additionalProperties": {
-          "pinned": true
-        }
       }
     ],
     "additionalProperties": {
@@ -2504,8 +2545,13 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
     "name": "Shared Dashboards",
     "order": 1,
     "isRoot": false,
-    "resourceCount": 1,
+    "resourceCount": 2,
     "resources": [
+      {
+        "id": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+        "name": "Customer records",
+        "type": "SCHEMA"
+      },
       {
         "id": "0f6f062f-1478-4df2-96a1-c495d037d260",
         "name": "Executive Revenue",
@@ -2679,7 +2725,7 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
         "hideDeleteButton": false
       },
       "view": {
-        "fields": ["id", "contact-name", "status", "amount"],
+        "fields": ["contact-name", "status", "amount"],
         "columnSize": { "contact-name": 240 }
       }
     }
@@ -2727,6 +2773,85 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
       command: "zinkee --json displays delete 0f6f062f-1478-4df2-96a1-c495d037d260",
     },
   ]),
+  "displays folders list": buildCommandExamples([
+    {
+      description: "List flat display folders (non-root folders plus the root bucket).",
+      command: "zinkee --json displays folders list",
+      response: `[
+  {
+    "id": "e7a1c3d2-5f4b-4a6c-9d8e-1f2a3b4c5d6e",
+    "name": "Executive Dashboards",
+    "isRoot": false,
+    "displayCount": 2
+  },
+  {
+    "id": "8b22282b-3db3-4dd7-87f7-b29365dcf3f6",
+    "name": null,
+    "isRoot": true,
+    "displayCount": 4
+  }
+]`,
+    },
+  ]),
+  "displays folders create": buildCommandExamples([
+    {
+      description: "Create one flat display folder.",
+      command: 'zinkee --json displays folders create --name "Executive Dashboards"',
+      raw: `{
+  "name": "Executive Dashboards"
+}`,
+      response: `{
+  "id": "e7a1c3d2-5f4b-4a6c-9d8e-1f2a3b4c5d6e",
+  "name": "Executive Dashboards",
+  "isRoot": false,
+  "displayCount": 0
+}`,
+    },
+  ]),
+  "displays folders update": buildCommandExamples([
+    {
+      description: "Rename a display folder. The folder argument accepts a UUID or an exact name.",
+      command:
+        'zinkee --json displays folders update "Executive Dashboards" --name "Executive Dashboards (2026)"',
+      raw: `{
+  "name": "Executive Dashboards (2026)"
+}`,
+      response: `{
+  "id": "e7a1c3d2-5f4b-4a6c-9d8e-1f2a3b4c5d6e",
+  "name": "Executive Dashboards (2026)",
+  "isRoot": false,
+  "displayCount": 2
+}`,
+    },
+  ]),
+  "displays folders delete": buildCommandExamples([
+    {
+      description: "Delete a non-root display folder. Its displays move back to the root folder.",
+      command: 'zinkee --json displays folders delete "Executive Dashboards"',
+      response: `{
+  "id": "e7a1c3d2-5f4b-4a6c-9d8e-1f2a3b4c5d6e",
+  "name": "Executive Dashboards",
+  "isRoot": false,
+  "displayCount": 2
+}`,
+    },
+  ]),
+  "displays folders move": buildCommandExamples([
+    {
+      description: "Move one display into a target folder by exact folder name.",
+      command:
+        'zinkee --json displays folders move 0f6f062f-1478-4df2-96a1-c495d037d260 --to "Executive Dashboards"',
+      raw: `{
+  "displayId": "0f6f062f-1478-4df2-96a1-c495d037d260",
+  "targetFolderId": "e7a1c3d2-5f4b-4a6c-9d8e-1f2a3b4c5d6e"
+}`,
+      response: `{
+  "id": "e7a1c3d2-5f4b-4a6c-9d8e-1f2a3b4c5d6e",
+  "name": "Executive Dashboards",
+  "isRoot": false
+}`,
+    },
+  ]),
   "displays layout get": buildCommandExamples([
     {
       description: "Get the layout block of a display (template + tabs/freeformLayouts/slots).",
@@ -2824,7 +2949,7 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
     "hideDeleteButton": false
   },
   "view": {
-    "fields": ["id", "contact-name", "status", "amount"],
+    "fields": ["contact-name", "status", "amount"],
     "columnSize": { "contact-name": 240 }
   }
 }`,
@@ -3797,7 +3922,8 @@ const specificExamples: Record<string, readonly CommandExample[]> = {
       description: "Move one automation into a target folder by exact folder name.",
       command: 'zinkee --json automations folders move automation-1 --to "Codex Frontend Demo"',
       raw: `{
-  "automationId": "automation-1"
+  "automationId": "automation-1",
+  "targetFolderId": "cdfc14e3-3169-4ffb-8d9b-b11858a9240f"
 }`,
       response: `{
   "id": "cdfc14e3-3169-4ffb-8d9b-b11858a9240f",