zinkee 0.1.9 → 0.1.11

package/dist/index.js

@@ -674,6 +674,13 @@ var commandRegistry = {
     supportsRaw: true,
     output: writeOutput
   },
+  "logs list": {
+    command: "logs list",
+    accessLevel: "read",
+    supportsExample: true,
+    supportsRaw: false,
+    output: readOutput
+  },
   "teamspace folders list": {
     command: "teamspace folders list",
     accessLevel: "read",
@@ -1608,132 +1615,484 @@ var fieldTypeDefinitions = [
     className: "TextField",
     aliases: ["text", "TextField"],
     description: "Plain text field.",
-    rawShape: '{"type":"text","slug":"name","label":"Name"}',
-    examplePayload: {
-      type: "text",
-      slug: "name",
-      label: "Name"
-    }
+    rawShape: '{"type":"TextField","slug":"name","label":"Name","config":{"textType":"NORMAL"}}',
+    examplePayloads: [
+      {
+        name: "Text field (normal)",
+        payload: {
+          type: "TextField",
+          slug: "customer-name",
+          label: "Customer Name",
+          required: true,
+          config: {
+            textType: "NORMAL",
+            defaultValue: null,
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Text field (long)",
+        payload: {
+          type: "TextField",
+          slug: "customer-notes",
+          label: "Customer Notes",
+          required: false,
+          config: {
+            textType: "LONG",
+            defaultValue: "Add internal notes here...",
+            conditionalFormatting: []
+          }
+        }
+      }
+    ]
   },
   {
     key: "number",
     className: "NumberField",
     aliases: ["number", "NumberField"],
     description: "Numeric field.",
-    rawShape: '{"type":"number","slug":"price-eur","label":"Price EUR","config":{"defaultValue":"0","formatOptions":{"format":"number","decimals":2,"thousandsSeparator":true,"symbolEnabled":true,"symbolValue":" \u20AC","symbolPosition":"right"}}}',
-    examplePayload: {
-      type: "number",
-      slug: "price-eur",
-      label: "Price EUR",
-      config: {
-        defaultValue: "0",
-        formatOptions: {
-          format: "number",
-          decimals: 2,
-          thousandsSeparator: true,
-          symbolEnabled: true,
-          symbolValue: " \u20AC",
-          symbolPosition: "right"
+    rawShape: '{"type":"NumberField","slug":"quantity","label":"Quantity","config":{"defaultValue":"0","formatOptions":{"format":"number","decimals":0,"thousandsSeparator":false}}}',
+    examplePayloads: [
+      {
+        name: "Number field (plain integer)",
+        payload: {
+          type: "NumberField",
+          slug: "quantity",
+          label: "Quantity",
+          required: false,
+          config: {
+            defaultValue: "0",
+            formatOptions: {
+              format: "number",
+              decimals: 0,
+              thousandsSeparator: false
+            },
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Number field (decimal with thousands)",
+        payload: {
+          type: "NumberField",
+          slug: "weight",
+          label: "Weight (kg)",
+          required: false,
+          config: {
+            defaultValue: "0",
+            formatOptions: {
+              format: "number",
+              decimals: 2,
+              thousandsSeparator: true,
+              negativesInRed: false
+            },
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Number field (currency \u20AC prefix)",
+        payload: {
+          type: "NumberField",
+          slug: "amount-eur",
+          label: "Amount (EUR)",
+          required: false,
+          config: {
+            defaultValue: "0",
+            formatOptions: {
+              format: "currency",
+              decimals: 2,
+              negativesInRed: true,
+              thousandsSeparator: true,
+              symbolEnabled: true,
+              symbolPosition: "before",
+              symbolValue: "\u20AC"
+            },
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Number field (currency $ suffix)",
+        payload: {
+          type: "NumberField",
+          slug: "amount-usd",
+          label: "Amount (USD)",
+          required: false,
+          config: {
+            defaultValue: "0",
+            formatOptions: {
+              format: "currency",
+              decimals: 2,
+              negativesInRed: false,
+              thousandsSeparator: true,
+              symbolEnabled: true,
+              symbolPosition: "right",
+              symbolValue: " $"
+            },
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Number field (percentage)",
+        payload: {
+          type: "NumberField",
+          slug: "discount-rate",
+          label: "Discount Rate",
+          required: false,
+          config: {
+            defaultValue: "0",
+            formatOptions: {
+              format: "percentage",
+              decimals: 1,
+              negativesInRed: true
+            },
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Number field (duration HH:MM)",
+        payload: {
+          type: "NumberField",
+          slug: "tracked-time",
+          label: "Tracked Time",
+          required: false,
+          config: {
+            defaultValue: "0",
+            formatOptions: {
+              format: "duration",
+              durationFormat: "HH:MM"
+            },
+            conditionalFormatting: []
+          }
         }
       }
-    }
+    ]
   },
   {
     key: "date",
     className: "DateField",
     aliases: ["date", "DateField"],
     description: "Date or datetime field.",
-    rawShape: '{"type":"date","slug":"due-date","label":"Due date"}',
-    examplePayload: {
-      type: "date",
-      slug: "due-date",
-      label: "Due date"
-    }
+    rawShape: '{"type":"DateField","slug":"due-date","label":"Due Date","config":{"formatOptions":{"format":"date","dateFormat":"YYYY-MM-DD","showTime":false}}}',
+    examplePayloads: [
+      {
+        name: "Date field (date only)",
+        payload: {
+          type: "DateField",
+          slug: "birth-date",
+          label: "Birth Date",
+          required: false,
+          config: {
+            defaultValue: null,
+            formatOptions: {
+              format: "date",
+              dateFormat: "YYYY-MM-DD",
+              showTime: false
+            },
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Date field (datetime EU)",
+        payload: {
+          type: "DateField",
+          slug: "due-date",
+          label: "Due Date",
+          required: false,
+          config: {
+            defaultValue: null,
+            formatOptions: {
+              format: "datetime",
+              dateFormat: "DD/MM/YYYY",
+              showTime: true
+            },
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Date field (datetime US)",
+        payload: {
+          type: "DateField",
+          slug: "appointment-at",
+          label: "Appointment",
+          required: false,
+          config: {
+            defaultValue: null,
+            formatOptions: {
+              format: "datetime",
+              dateFormat: "MM/DD/YYYY",
+              showTime: true
+            },
+            conditionalFormatting: []
+          }
+        }
+      }
+    ]
   },
   {
     key: "option",
     className: "OptionField",
     aliases: ["option", "OptionField"],
     description: "Dropdown/select field with options.",
-    rawShape: '{"type":"option","slug":"status","label":"Status","config":{"options":[{"id":1,"name":"Open","color":"default"},{"id":2,"name":"Closed","color":"success"}]}}',
-    examplePayload: {
-      type: "option",
-      slug: "status",
-      label: "Status",
-      config: {
-        options: [
-          {
-            id: 1,
-            name: "Open",
-            color: "default"
-          },
-          {
-            id: 2,
-            name: "Closed",
-            color: "success"
+    rawShape: '{"type":"OptionField","slug":"status","label":"Status","config":{"options":[{"id":1,"name":"Open","color":"default"},{"id":2,"name":"Closed","color":"success"}]}}',
+    examplePayloads: [
+      {
+        name: "Option field (select dropdown)",
+        payload: {
+          type: "OptionField",
+          slug: "priority",
+          label: "Priority",
+          required: false,
+          config: {
+            options: [
+              { id: 1, name: "Low", color: "default" },
+              { id: 2, name: "Medium", color: "warning" },
+              { id: 3, name: "High", color: "danger" }
+            ],
+            defaultValue: 1,
+            conditionalFormatting: [],
+            buttonConfig: null
           }
-        ]
+        }
+      },
+      {
+        name: "Option field (button cycle)",
+        payload: {
+          type: "OptionField",
+          slug: "stage",
+          label: "Stage",
+          required: false,
+          config: {
+            options: [
+              { id: 1, name: "To Do", color: "default" },
+              { id: 2, name: "Doing", 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,
+                allowReselect: true
+              }
+            }
+          }
+        }
+      },
+      {
+        name: "Option field (button dropdown w/ confirm)",
+        payload: {
+          type: "OptionField",
+          slug: "status",
+          label: "Status",
+          required: 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: "dropdown",
+                requireConfirmation: true,
+                confirmationMessage: "Confirm status change",
+                useFixedLabel: true,
+                buttonLabel: "Set status",
+                allowReselect: true
+              }
+            }
+          }
+        }
       }
-    }
+    ]
   },
   {
     key: "file",
     className: "FileField",
     aliases: ["file", "FileField"],
     description: "File attachment field.",
-    rawShape: '{"type":"file","slug":"attachment","label":"Attachment"}',
-    examplePayload: {
-      type: "file",
-      slug: "attachment",
-      label: "Attachment"
-    }
+    rawShape: '{"type":"FileField","slug":"attachment","label":"Attachment","config":{}}',
+    examplePayloads: [
+      {
+        name: "File field",
+        payload: {
+          type: "FileField",
+          slug: "attachment",
+          label: "Attachment",
+          required: false,
+          config: {}
+        }
+      }
+    ]
   },
   {
     key: "reference",
     className: "ReferenceField",
     aliases: ["reference", "ReferenceField"],
     description: "Reference to another schema.",
-    rawShape: '{"type":"reference","slug":"project","label":"Project","config":{"targetSchema":"<schema-uuid>","targetDisplayField":"<field-uuid>","deleteBehavior":"SET_NULL"}}',
-    examplePayload: {
-      type: "reference",
-      slug: "project",
-      label: "Project",
-      config: {
-        targetSchema: "<schema-uuid>",
-        targetDisplayField: "<field-uuid>",
-        deleteBehavior: "SET_NULL"
+    rawShape: '{"type":"ReferenceField","slug":"company-ref","label":"Company","config":{"targetSchema":"<schema-uuid>","targetDisplayField":"<field-uuid>"}}',
+    examplePayloads: [
+      {
+        name: "Reference field (minimal)",
+        payload: {
+          type: "ReferenceField",
+          slug: "company-ref",
+          label: "Company",
+          required: false,
+          config: {
+            targetSchema: "5223cbc8-8c6c-4694-93bc-dd176364df9b",
+            targetDisplayField: "c60b8526-5835-4c9f-aecd-9a16c7704a34"
+          }
+        }
+      },
+      {
+        name: "Reference field (restrict + filter + description)",
+        payload: {
+          type: "ReferenceField",
+          slug: "customer-ref",
+          label: "Customer",
+          required: false,
+          config: {
+            targetSchema: "5223cbc8-8c6c-4694-93bc-dd176364df9b",
+            targetDisplayField: "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+            deleteBehavior: "RESTRICT",
+            defaultValue: "8ad602a1-f6e3-43f6-9ab2-f1c5afc99621::Ref A",
+            filterFields: [
+              {
+                fatherField: "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+                currentField: "45c5da96-0dc2-4cc1-ba61-7660a9c6da32",
+                comparison: "EQUAL",
+                value: null
+              }
+            ],
+            descriptionFields: [
+              {
+                id: "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+                fieldType: "NumberField",
+                options: null,
+                format: "number"
+              }
+            ],
+            conditionalFormatting: []
+          }
+        }
       }
-    }
+    ]
   },
   {
     key: "formula",
     className: "FormulaField",
     aliases: ["formula", "FormulaField"],
     description: "Calculated field from a formula.",
-    rawShape: '{"type":"formula","slug":"total","label":"Total","config":{"formulaText":"{price} * {quantity}"}}',
-    examplePayload: {
-      type: "formula",
-      slug: "total",
-      label: "Total",
-      config: {
-        formulaText: "{price} * {quantity}"
+    rawShape: `{"type":"FormulaField","slug":"formula-summary","label":"Formula Summary","config":{"formulaText":"concat(firstName, ' ', lastName)","uiFormatKind":"none"}}`,
+    examplePayloads: [
+      {
+        name: "Formula field (none)",
+        payload: {
+          type: "FormulaField",
+          slug: "formula-summary",
+          label: "Formula Summary",
+          required: false,
+          config: {
+            formulaText: "concat(firstName, ' ', lastName)",
+            uiFormatKind: "none",
+            status: "ACTIVE",
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Formula field (number)",
+        payload: {
+          type: "FormulaField",
+          slug: "formula-total",
+          label: "Formula Total",
+          required: false,
+          config: {
+            formulaText: "amount * 1.21",
+            uiFormatKind: "number",
+            status: "ACTIVE",
+            numberFormatOptions: {
+              format: "number",
+              decimals: 2,
+              thousandsSeparator: true
+            },
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Formula field (date)",
+        payload: {
+          type: "FormulaField",
+          slug: "formula-deadline",
+          label: "Computed Deadline",
+          required: false,
+          config: {
+            formulaText: "addDays(startDate, 7)",
+            uiFormatKind: "date",
+            status: "ACTIVE",
+            dateFormatOptions: {
+              format: "date",
+              dateFormat: "DD/MM/YYYY",
+              showTime: false
+            },
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Formula field (member)",
+        payload: {
+          type: "FormulaField",
+          slug: "formula-assignee",
+          label: "Computed Assignee",
+          required: false,
+          config: {
+            formulaText: "manager",
+            uiFormatKind: "member",
+            status: "ACTIVE",
+            conditionalFormatting: []
+          }
+        }
       }
-    }
+    ]
   },
   {
     key: "member",
     className: "MemberField",
     aliases: ["member", "MemberField"],
     description: "Workspace member field.",
-    rawShape: '{"type":"member","slug":"owner","label":"Owner","config":{"defaultValue":"<member-id>"}}',
-    examplePayload: {
-      type: "member",
-      slug: "owner",
-      label: "Owner",
-      config: {
-        defaultValue: "<member-id>"
+    rawShape: '{"type":"MemberField","slug":"owner","label":"Owner","config":{"defaultValue":null}}',
+    examplePayloads: [
+      {
+        name: "Member field",
+        payload: {
+          type: "MemberField",
+          slug: "owner",
+          label: "Owner",
+          required: false,
+          config: {
+            defaultValue: null,
+            conditionalFormatting: []
+          }
+        }
       }
-    }
+    ]
   },
   {
     key: "autoincremental",
@@ -1745,15 +2104,74 @@ var fieldTypeDefinitions = [
       "AutoIncrementalField"
     ],
     description: "Auto-generated incremental counter.",
-    rawShape: '{"type":"autoincremental","slug":"counter","label":"Counter","config":{"segmentedByFieldId":null}}',
-    examplePayload: {
-      type: "autoincremental",
-      slug: "counter",
-      label: "Counter",
-      config: {
-        segmentedByFieldId: null
+    rawShape: '{"type":"AutoIncrementalField","slug":"order-number","label":"Order Number","config":{"segmentedByFieldId":null}}',
+    examplePayloads: [
+      {
+        name: "Autoincremental (global counter)",
+        payload: {
+          type: "AutoIncrementalField",
+          slug: "order-number",
+          label: "Order Number",
+          required: false,
+          config: {
+            segmentedByFieldId: null,
+            conditionalFormatting: []
+          }
+        }
+      },
+      {
+        name: "Autoincremental (segmented)",
+        payload: {
+          type: "AutoIncrementalField",
+          slug: "sequence-code",
+          label: "Sequence Code",
+          required: false,
+          config: {
+            segmentedByFieldId: "45c5da96-0dc2-4cc1-ba61-7660a9c6da32",
+            conditionalFormatting: []
+          }
+        }
       }
-    }
+    ]
+  },
+  {
+    key: "schedule",
+    className: "ScheduleField",
+    aliases: ["schedule", "ScheduleField"],
+    description: "Recurrence/schedule field bound to a number reference and a date period (frequency: monthly or daily).",
+    rawShape: '{"type":"ScheduleField","slug":"recurrence","label":"Recurrence","config":{"referenceField":"<number-field-uuid>","beginningPeriodField":"<date-field-uuid>","endingPeriodField":"<date-field-uuid>","frequency":"monthly"}}',
+    examplePayloads: [
+      {
+        name: "Schedule field (monthly)",
+        payload: {
+          type: "ScheduleField",
+          slug: "monthly-recurrence",
+          label: "Monthly Recurrence",
+          required: false,
+          config: {
+            referenceField: "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+            beginningPeriodField: "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+            endingPeriodField: "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+            frequency: "monthly"
+          }
+        }
+      },
+      {
+        name: "Schedule field (daily)",
+        payload: {
+          type: "ScheduleField",
+          slug: "daily-recurrence",
+          label: "Daily Recurrence",
+          required: false,
+          config: {
+            referenceField: "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+            beginningPeriodField: "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+            endingPeriodField: "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+            frequency: "daily"
+          }
+        }
+      }
+    ]
   }
 ];
 var fieldTypeDefinitionByAlias = new Map(
@@ -1877,6 +2295,49 @@ function normalizeReferencePayload(input) {
   }
   return normalized;
 }
+var scheduleAllowedFrequencies = /* @__PURE__ */ new Set(["monthly", "daily"]);
+function normalizeSchedulePayload(input) {
+  const additionalProperties = toJsonObject(input.additionalProperties) ?? {};
+  const config = toJsonObject(input.config) ?? {};
+  const referenceField = config.referenceField ?? input.referenceField ?? additionalProperties.referenceField;
+  const beginningPeriodField = config.beginningPeriodField ?? input.beginningPeriodField ?? additionalProperties.beginningPeriodField;
+  const endingPeriodField = config.endingPeriodField ?? input.endingPeriodField ?? additionalProperties.endingPeriodField;
+  const frequency = config.frequency ?? input.frequency ?? additionalProperties.frequency;
+  const {
+    referenceField: _referenceField,
+    beginningPeriodField: _beginningPeriodField,
+    endingPeriodField: _endingPeriodField,
+    frequency: _frequency,
+    additionalProperties: _additionalProperties,
+    ...rest
+  } = input;
+  const normalized = {
+    ...rest,
+    config: {
+      ...config,
+      ...referenceField !== void 0 ? { referenceField } : {},
+      ...beginningPeriodField !== void 0 ? { beginningPeriodField } : {},
+      ...endingPeriodField !== void 0 ? { endingPeriodField } : {},
+      ...frequency !== void 0 ? { frequency } : {}
+    }
+  };
+  const normalizedConfig = toJsonObject(normalized.config) ?? {};
+  const definition = resolveSchemaFieldType("schedule");
+  if (!toStringValue2(normalizedConfig.referenceField) || !toStringValue2(normalizedConfig.beginningPeriodField) || !toStringValue2(normalizedConfig.endingPeriodField) || !toStringValue2(normalizedConfig.frequency)) {
+    throw new CliError(
+      "invalid_cli_usage",
+      `Schedule fields require "referenceField", "beginningPeriodField", "endingPeriodField" and "frequency". Expected raw shape: ${definition.rawShape}`
+    );
+  }
+  const frequencyValue = toStringValue2(normalizedConfig.frequency);
+  if (!scheduleAllowedFrequencies.has(frequencyValue)) {
+    throw new CliError(
+      "invalid_cli_usage",
+      `Schedule "frequency" must be "monthly" or "daily" (received "${frequencyValue}").`
+    );
+  }
+  return normalized;
+}
 function normalizeFormulaPayload(input) {
   const { status: _status, ...rest } = input;
   const rawAdditionalProperties = toJsonObject(input.additionalProperties);
@@ -1924,6 +2385,8 @@ function normalizeSchemaFieldCreatePayload(input) {
       return normalizeReferencePayload(normalizedWithType);
     case "formula":
       return normalizeFormulaPayload(normalizedWithType);
+    case "schedule":
+      return normalizeSchedulePayload(normalizedWithType);
     case "autoincremental": {
       const config = toJsonObject(normalizedWithType.config) ?? {};
       const segmentedByFieldId = config.segmentedByFieldId ?? normalizedWithType.segmentedByFieldId ?? null;
@@ -2160,13 +2623,10 @@ var specificExamples = {
   ]),
   "schemas update": buildCommandExamples([
     {
-      description: "Rename a schema and change its slug.",
-      command: 'zinkee --json schemas update contacts --name "Customer Contacts" --slug customer-contacts',
+      description: "Toggle the commentable flag on a schema.",
+      command: "zinkee --json schemas update contacts --commentable true",
       raw: `{
-  "set": {
-    "name": "Customer Contacts",
-    "slug": "customer-contacts"
-  }
+  "commentable": true
 }`,
       response: `{
   "id": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
@@ -2179,37 +2639,46 @@ var specificExamples = {
   },
   "auditable": true,
   "commentable": true,
-  "fields": []
+  "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": []
+      }
+    }
+  ]
 }`
     },
     {
-      description: "Enable the audit log on a schema.",
-      command: "zinkee --json schemas update contacts --auditable true",
+      description: "Rename a schema and change its slug.",
+      command: 'zinkee --json schemas update contacts --name "Customer Contacts" --slug customer-contacts',
       raw: `{
-  "set": {
-    "auditable": true
-  }
+  "name": "Customer Contacts",
+  "slug": "customer-contacts"
 }`
     },
     {
-      description: "Toggle commentable off.",
-      command: "zinkee --json schemas update contacts --commentable false",
+      description: "Enable the audit log on a schema.",
+      command: "zinkee --json schemas update contacts --auditable true",
       raw: `{
-  "set": {
-    "commentable": false
-  }
+  "auditable": true
 }`
     }
   ]),
   "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',
+      description: "Rename slug and label.",
+      command: `zinkee --json schemas fields update contacts contact-name --label "Customer Full Name" --raw '{"slug":"customer-full-name"}'`,
       raw: `{
-  "set": {
-    "label": "Customer Full Name",
-    "required": false
-  }
+  "slug": "customer-full-name",
+  "label": "Customer Full Name"
 }`,
       response: `{
   "schemaId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
@@ -2218,95 +2687,243 @@ var specificExamples = {
 }`
     },
     {
-      description: "Make a field required.",
+      description: "Toggle required.",
       command: "zinkee --json schemas fields update contacts status --required true",
       raw: `{
-  "set": {
-    "required": true
-  }
+  "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}}}}'`,
+      description: "Patch text field (long with default).",
+      command: `zinkee --json schemas fields update contacts contact-name --raw '{"type":"TextField","label":"Customer Full Name","required":false,"config":{"textType":"LONG","defaultValue":"Unknown","conditionalFormatting":[]}}'`,
       raw: `{
-  "set": {
-    "config": {
-      "formatOptions": {
-        "format": "percent",
-        "decimals": 1
-      }
-    }
+  "type": "TextField",
+  "label": "Customer Full Name",
+  "required": false,
+  "config": {
+    "textType": "LONG",
+    "defaultValue": "Unknown",
+    "conditionalFormatting": []
   }
 }`
-    }
-  ]),
-  "records query": buildCommandExamples([
+    },
     {
-      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',
+      description: "Patch number field (to currency).",
+      command: `zinkee --json schemas fields update contacts amount --raw '{"type":"NumberField","config":{"defaultValue":"0","formatOptions":{"format":"currency","decimals":2,"thousandsSeparator":true,"symbolEnabled":true,"symbolPosition":"before","symbolValue":"\u20AC"},"conditionalFormatting":[]}}'`,
       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
+  "type": "NumberField",
+  "config": {
+    "defaultValue": "0",
+    "formatOptions": {
+      "format": "currency",
+      "decimals": 2,
+      "thousandsSeparator": true,
+      "symbolEnabled": true,
+      "symbolPosition": "before",
+      "symbolValue": "\u20AC"
+    },
+    "conditionalFormatting": []
   }
 }`
     },
     {
-      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`,
+      description: "Patch number field (to percentage).",
+      command: `zinkee --json schemas fields update contacts discount-rate --raw '{"type":"NumberField","config":{"defaultValue":"0","formatOptions":{"format":"percentage","decimals":1},"conditionalFormatting":[]}}'`,
       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 }
+  "type": "NumberField",
+  "config": {
+    "defaultValue": "0",
+    "formatOptions": {
+      "format": "percentage",
+      "decimals": 1
+    },
+    "conditionalFormatting": []
+  }
 }`
     },
     {
-      description: "Text contains search.",
-      command: 'zinkee --json records query contacts --select id,contact-name,contact-email --where "contact-name contains Lovelace" --limit 50',
+      description: "Patch date field (to date only).",
+      command: `zinkee --json schemas fields update contacts due-date --raw '{"type":"DateField","config":{"defaultValue":null,"formatOptions":{"format":"date","dateFormat":"YYYY-MM-DD","showTime":false},"conditionalFormatting":[]}}'`,
       raw: `{
-  "select": ["id", "contact-name", "contact-email"],
-  "where": [
-    { "field": "contact-name", "op": "contains", "value": "Lovelace" }
-  ],
-  "page": { "offset": 0, "size": 50 }
+  "type": "DateField",
+  "config": {
+    "defaultValue": null,
+    "formatOptions": {
+      "format": "date",
+      "dateFormat": "YYYY-MM-DD",
+      "showTime": false
+    },
+    "conditionalFormatting": []
+  }
 }`
     },
     {
-      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',
+      description: "Patch option field (button cycle).",
+      command: `zinkee --json schemas fields update contacts stage --raw '{"type":"OptionField","config":{"options":[{"id":1,"name":"To Do","color":"default"},{"id":2,"name":"Doing","color":"warning"},{"id":3,"name":"Done","color":"success"}],"defaultValue":1,"conditionalFormatting":[],"buttonConfig":{"displayMode":"button","buttonBehavior":{"mode":"cycle","cycleOrder":[1,2,3],"allowReselect":true}}}}'`,
       raw: `{
-  "where": [
+  "type": "OptionField",
+  "config": {
+    "options": [
+      { "id": 1, "name": "To Do", "color": "default" },
+      { "id": 2, "name": "Doing", "color": "warning" },
+      { "id": 3, "name": "Done", "color": "success" }
+    ],
+    "defaultValue": 1,
+    "conditionalFormatting": [],
+    "buttonConfig": {
+      "displayMode": "button",
+      "buttonBehavior": {
+        "mode": "cycle",
+        "cycleOrder": [1, 2, 3],
+        "allowReselect": true
+      }
+    }
+  }
+}`
+    },
+    {
+      description: "Patch option field (drop button mode).",
+      command: `zinkee --json schemas fields update contacts status --raw '{"type":"OptionField","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}}'`,
+      raw: `{
+  "type": "OptionField",
+  "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
+  }
+}`
+    },
+    {
+      description: "Patch formula field (formula text).",
+      command: `zinkee --json schemas fields update contacts formula-total --raw '{"type":"FormulaField","config":{"formulaText":"amount * 1.10","uiFormatKind":"number","status":"ACTIVE","numberFormatOptions":{"format":"number","decimals":2,"thousandsSeparator":true},"conditionalFormatting":[]}}'`,
+      raw: `{
+  "type": "FormulaField",
+  "config": {
+    "formulaText": "amount * 1.10",
+    "uiFormatKind": "number",
+    "status": "ACTIVE",
+    "numberFormatOptions": {
+      "format": "number",
+      "decimals": 2,
+      "thousandsSeparator": true
+    },
+    "conditionalFormatting": []
+  }
+}`
+    },
+    {
+      description: "Patch reference field (delete behavior).",
+      command: `zinkee --json schemas fields update contacts customer-ref --raw '{"type":"ReferenceField","config":{"targetSchema":"5223cbc8-8c6c-4694-93bc-dd176364df9b","targetDisplayField":"c60b8526-5835-4c9f-aecd-9a16c7704a34","deleteBehavior":"RESTRICT","defaultValue":null,"filterFields":[],"descriptionFields":[],"conditionalFormatting":[]}}'`,
+      raw: `{
+  "type": "ReferenceField",
+  "config": {
+    "targetSchema": "5223cbc8-8c6c-4694-93bc-dd176364df9b",
+    "targetDisplayField": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+    "deleteBehavior": "RESTRICT",
+    "defaultValue": null,
+    "filterFields": [],
+    "descriptionFields": [],
+    "conditionalFormatting": []
+  }
+}`
+    },
+    {
+      description: "Patch schedule field (to daily).",
+      command: `zinkee --json schemas fields update contacts recurrence --raw '{"type":"ScheduleField","config":{"referenceField":"c52efe3f-2825-4c60-a7e3-34dd4c1ce043","beginningPeriodField":"d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90","endingPeriodField":"d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90","frequency":"daily"}}'`,
+      raw: `{
+  "type": "ScheduleField",
+  "config": {
+    "referenceField": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+    "beginningPeriodField": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+    "endingPeriodField": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+    "frequency": "daily"
+  }
+}`
+    }
+  ]),
+  "records query": buildCommandExamples([
+    {
+      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, "limit": 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, "limit": 25 }
+}`
+    },
+    {
+      description: "Filter by status with a free-text search term.",
+      command: `zinkee --json records query contacts --select id,contact-name,status --where "status in OPEN" --limit 25 --raw '{"search":{"term":"garcia"}}'`,
+      raw: `{
+  "select": ["id", "contact-name", "status"],
+  "where": [
+    { "field": "status", "op": "in", "value": ["OPEN"] }
+  ],
+  "search": { "term": "garcia" },
+  "page": { "offset": 0, "limit": 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, "limit": 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" }
   ],
@@ -3453,27 +4070,22 @@ var specificExamples = {
       "required": true,
       "system": false,
       "config": {
-        "textType": "LONG",
+        "textType": "NORMAL",
         "defaultValue": "Unknown",
         "conditionalFormatting": []
       }
     },
     {
-      "id": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
-      "type": "OptionField",
-      "slug": "status",
-      "label": "Status",
+      "id": "1d2e3f4a-5b6c-7d8e-9f01-23456789abcd",
+      "type": "TextField",
+      "slug": "notes",
+      "label": "Notes",
       "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
+        "textType": "LONG",
+        "defaultValue": null,
+        "conditionalFormatting": []
       }
     },
     {
@@ -3497,6 +4109,40 @@ var specificExamples = {
         "conditionalFormatting": []
       }
     },
+    {
+      "id": "2f3a4b5c-6d7e-8f90-1234-56789abcdef0",
+      "type": "NumberField",
+      "slug": "quantity",
+      "label": "Quantity",
+      "required": false,
+      "system": false,
+      "config": {
+        "defaultValue": "0",
+        "formatOptions": {
+          "format": "number",
+          "decimals": 0,
+          "thousandsSeparator": false
+        },
+        "conditionalFormatting": []
+      }
+    },
+    {
+      "id": "3a4b5c6d-7e8f-9012-3456-789abcdef012",
+      "type": "NumberField",
+      "slug": "discount-rate",
+      "label": "Discount Rate",
+      "required": false,
+      "system": false,
+      "config": {
+        "defaultValue": "0",
+        "formatOptions": {
+          "format": "percentage",
+          "decimals": 1,
+          "negativesInRed": true
+        },
+        "conditionalFormatting": []
+      }
+    },
     {
       "id": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
       "type": "DateField",
@@ -3515,77 +4161,274 @@ var specificExamples = {
       }
     },
     {
-      "id": "a7b8c9d0-e1f2-3a4b-5c6d-7e8f90123456",
-      "type": "MemberField",
-      "slug": "owner",
-      "label": "Owner",
+      "id": "4b5c6d7e-8f90-1234-5678-9abcdef01234",
+      "type": "DateField",
+      "slug": "birth-date",
+      "label": "Birth Date",
       "required": false,
       "system": false,
       "config": {
         "defaultValue": null,
+        "formatOptions": {
+          "format": "date",
+          "dateFormat": "YYYY-MM-DD",
+          "showTime": false
+        },
         "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([
+      "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
+      }
+    },
     {
-      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([
+      "id": "5c6d7e8f-9012-3456-789a-bcdef0123456",
+      "type": "OptionField",
+      "slug": "stage",
+      "label": "Stage",
+      "required": false,
+      "system": false,
+      "config": {
+        "options": [
+          { "id": 1, "name": "To Do", "color": "default" },
+          { "id": 2, "name": "Doing", "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,
+            "allowReselect": true
+          }
+        }
+      }
+    },
     {
-      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",
+      "id": "3e9f8c12-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
+      "type": "FormulaField",
+      "slug": "formula-total",
+      "label": "Formula Total",
+      "required": false,
+      "system": false,
+      "config": {
+        "formulaText": "amount * 1.21",
+        "uiFormatKind": "number",
+        "status": "ACTIVE",
+        "defaultValue": null,
+        "numberFormatOptions": {
+          "format": "number",
+          "decimals": 2,
+          "thousandsSeparator": true
+        },
+        "conditionalFormatting": []
+      }
+    },
+    {
+      "id": "6d7e8f90-1234-5678-9abc-def012345678",
+      "type": "FormulaField",
+      "slug": "formula-deadline",
+      "label": "Computed Deadline",
+      "required": false,
+      "system": false,
+      "config": {
+        "formulaText": "addDays(startDate, 7)",
+        "uiFormatKind": "date",
+        "status": "ACTIVE",
+        "defaultValue": null,
+        "dateFormatOptions": {
+          "format": "date",
+          "dateFormat": "DD/MM/YYYY",
+          "showTime": false
+        },
+        "conditionalFormatting": []
+      }
+    },
+    {
+      "id": "45c5da96-0dc2-4cc1-ba61-7660a9c6da32",
+      "type": "ReferenceField",
+      "slug": "customer-ref",
+      "label": "Customer",
+      "required": false,
+      "system": false,
+      "config": {
+        "targetSchema": "5223cbc8-8c6c-4694-93bc-dd176364df9b",
+        "targetDisplayField": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+        "deleteBehavior": "SET_NULL",
+        "defaultValue": null,
+        "filterFields": [],
+        "descriptionFields": [],
+        "conditionalFormatting": []
+      }
+    },
+    {
+      "id": "7e8f9012-3456-789a-bcde-f01234567890",
+      "type": "ReferenceField",
+      "slug": "company-ref",
+      "label": "Company",
+      "required": false,
+      "system": false,
+      "config": {
+        "targetSchema": "5223cbc8-8c6c-4694-93bc-dd176364df9b",
+        "targetDisplayField": "c60b8526-5835-4c9f-aecd-9a16c7704a34",
+        "deleteBehavior": "RESTRICT",
+        "defaultValue": null,
+        "filterFields": [],
+        "descriptionFields": [],
+        "conditionalFormatting": []
+      }
+    },
+    {
+      "id": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
+      "type": "AutoIncrementalField",
+      "slug": "sequence-code",
+      "label": "Sequence Code",
+      "required": false,
+      "system": true,
+      "config": {
+        "segmentedByFieldId": "45c5da96-0dc2-4cc1-ba61-7660a9c6da32",
+        "conditionalFormatting": []
+      }
+    },
+    {
+      "id": "8f901234-5678-9abc-def0-123456789012",
+      "type": "AutoIncrementalField",
+      "slug": "order-number",
+      "label": "Order Number",
+      "required": false,
+      "system": true,
+      "config": {
+        "segmentedByFieldId": null,
+        "conditionalFormatting": []
+      }
+    },
+    {
+      "id": "e5f6a7b8-c9d0-1e2f-3a4b-5c6d7e8f9012",
+      "type": "FileField",
+      "slug": "attachment",
+      "label": "Attachment",
+      "required": false,
+      "system": false,
+      "config": {}
+    },
+    {
+      "id": "f6a7b8c9-d0e1-2f3a-4b5c-6d7e8f901234",
+      "type": "ScheduleField",
+      "slug": "recurrence",
+      "label": "Recurrence",
+      "required": false,
+      "system": false,
+      "config": {
+        "referenceField": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+        "beginningPeriodField": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+        "endingPeriodField": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+        "frequency": "monthly"
+      }
+    },
+    {
+      "id": "9012abcd-ef01-2345-6789-abcdef012345",
+      "type": "ScheduleField",
+      "slug": "daily-recurrence",
+      "label": "Daily Recurrence",
+      "required": false,
+      "system": false,
+      "config": {
+        "referenceField": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
+        "beginningPeriodField": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+        "endingPeriodField": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
+        "frequency": "daily"
+      }
+    },
+    {
+      "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,
@@ -3717,6 +4560,47 @@ var specificExamples = {
       { "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"
+    }
+  }
 ]`
     }
   ]),
@@ -5007,24 +5891,28 @@ function buildSchemaFieldCreateExamples(type) {
   const definitions = getSchemaFieldTypeDefinitions();
   const selectedDefinition = resolveSchemaFieldType(type);
   const filteredDefinitions = selectedDefinition ? definitions.filter((definition) => definition.key === selectedDefinition.key) : definitions;
+  const flat = filteredDefinitions.flatMap(
+    (definition) => definition.examplePayloads.map((example) => ({ definition, example }))
+  );
   return buildCommandExamples(
-    filteredDefinitions.flatMap((definition) => {
-      if (definition.key !== "number") {
-        return [{
-          description: `Create a ${definition.key} field`,
-          command: `zinkee --json schemas fields create contacts --raw '${JSON.stringify(definition.examplePayload)}'`
-        }];
+    flat.map(({ example }, index) => {
+      const slug = typeof example.payload.slug === "string" ? example.payload.slug : "field";
+      const command = `zinkee --json schemas fields create contacts --raw '${JSON.stringify(example.payload)}'`;
+      if (index === 0) {
+        return {
+          description: example.name,
+          command,
+          response: `{
+  "schemaId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+  "fieldId": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+  "slug": "${slug}"
+}`
+        };
       }
-      return [
-        {
-          description: "Create a required number field with a default value",
-          command: "zinkee --json schemas fields create contacts --type number --slug amount --label Amount --required true --default 0"
-        },
-        {
-          description: "Create a number field formatted like Moneda",
-          command: `zinkee --json schemas fields create contacts --raw '${JSON.stringify(definition.examplePayload)}'`
-        }
-      ];
+      return {
+        description: example.name,
+        command
+      };
     })
   );
 }
@@ -5617,7 +6505,7 @@ ${index + 1}. ${example.description}
 
 // src/program.ts
 import { createRequire } from "module";
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
 
 // src/commands/config.ts
 function getCommandIo(stdout) {
@@ -8110,57 +8998,25 @@ function registerFilesCommands(program, options = {}) {
   });
 }
 
-// src/commands/navigation.ts
-import { readFileSync as readFileSync6 } from "fs";
+// src/commands/logs.ts
 import { InvalidArgumentError as InvalidArgumentError5 } from "commander";
 
-// src/api/navigation.ts
-function jsonOptions5(body, method) {
-  return {
-    method,
-    headers: {
-      "content-type": "application/json"
-    },
-    body: JSON.stringify(body)
-  };
-}
+// src/api/logs.ts
 function selectorValue6(selector2) {
   return selector2.value;
 }
-var NavigationApi = class {
+var LogsApi = class {
   constructor(client) {
     this.client = client;
   }
-  listFolders() {
-    return this.client.getJson("/api/v2/navigation/folders");
-  }
-  createFolder(body) {
-    return this.client.requestJson(
-      "/api/v2/navigation/folders",
-      jsonOptions5(body, "POST")
-    );
-  }
-  updateFolder(folder, body) {
-    return this.client.requestJson(
-      `/api/v2/navigation/folders/${selectorValue6(folder)}`,
-      jsonOptions5(body, "PATCH")
-    );
-  }
-  deleteFolder(folder) {
-    return this.client.requestJson(
-      `/api/v2/navigation/folders/${selectorValue6(folder)}`,
-      { method: "DELETE" }
-    );
-  }
-  moveResource(body) {
-    return this.client.requestJson(
-      "/api/v2/navigation/resources:move",
-      jsonOptions5(body, "POST")
+  listLogs(schema, recordId) {
+    return this.client.getJson(
+      `/api/v2/schemas/${selectorValue6(schema)}/records/${recordId}/logs`
     );
   }
 };
 
-// src/commands/navigation.ts
+// src/commands/logs.ts
 function getCommandIo6(stdout) {
   return stdout ?? process.stdout;
 }
@@ -8171,8 +9027,11 @@ function writeLine6(stdout, value) {
 function getGlobalOptions6(command) {
   return command.optsWithGlobals();
 }
-function emitJson6(stdout, commandName, data, configPath) {
-  writeLine6(stdout, JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath })));
+function emitJson6(stdout, commandName, data, ..._extra) {
+  writeLine6(
+    stdout,
+    JSON.stringify(buildJsonSuccess(data, { command: commandName }))
+  );
 }
 function toConfigurationError6(filePath, error) {
   if (error instanceof CliError) {
@@ -8186,36 +9045,29 @@ function toConfigurationError6(filePath, error) {
   }
   throw error;
 }
-function createNavigationApi(command, filePath) {
+function createLogsApi(command, filePath) {
   try {
     const config = readRuntimeConfig(filePath);
     const runtime = resolveRuntimeContext(config, getGlobalOptions6(command));
     if (!runtime.baseUrl) {
-      throw new CliError("configuration_error", `Resolved profile "${runtime.profile}" is missing a base URL.`);
+      throw new CliError(
+        "configuration_error",
+        `Resolved profile "${runtime.profile}" is missing a base URL.`
+      );
     }
     return {
-      api: new NavigationApi(
+      api: new LogsApi(
         new ApiClient({
           baseUrl: runtime.baseUrl,
           apiKey: runtime.apiKey
         })
       ),
-      json: runtime.json,
-      readOnly: runtime.readOnly
+      json: runtime.json
     };
   } catch (error) {
     toConfigurationError6(filePath, error);
   }
 }
-function ensureWritable5(commandName, readOnly, mode) {
-  if (readOnly) {
-    throw new CliError(
-      "command_not_allowed_in_read_only_mode",
-      `Command "${commandName}" is not allowed in read-only mode.`,
-      { commandMode: mode, executionMode: "read-only" }
-    );
-  }
-}
 function parseUuidOrSlugSelector5(input) {
   try {
     return normalizeUuidOrSlug(input);
@@ -8224,35 +9076,179 @@ function parseUuidOrSlugSelector5(input) {
     throw new InvalidArgumentError5(message);
   }
 }
-function parseInteger(value, flagName) {
-  if (value === void 0) {
-    return void 0;
-  }
-  const parsed = Number.parseInt(value, 10);
-  if (Number.isNaN(parsed)) {
-    throw new CliError("invalid_cli_usage", `${flagName} must be an integer.`);
-  }
-  return parsed;
+function isJsonObject4(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function readJsonObject(raw, rawFile) {
-  if (raw && rawFile) {
-    throw new CliError("invalid_cli_usage", 'Use either "--props" or "--props-file", not both.');
+function toTableRows3(data) {
+  if (Array.isArray(data)) {
+    return data.map((entry) => isJsonObject4(entry) ? entry : { value: entry });
   }
-  const source = rawFile ? readFileSync6(rawFile, "utf8") : raw;
-  if (!source) {
-    return {};
+  if (isJsonObject4(data)) {
+    return [data];
   }
-  try {
-    const parsed = JSON.parse(source);
-    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-      throw new CliError("invalid_cli_usage", "Props payload must be a JSON object.");
-    }
-    return parsed;
-  } catch (error) {
-    if (error instanceof CliError) {
-      throw error;
-    }
-    throw new CliError("invalid_cli_usage", "Props payload is invalid JSON.");
+  return [{ value: data }];
+}
+function emitTable3(stdout, data) {
+  printTable(toTableRows3(data), void 0, stdout);
+}
+function registerLogsCommands(program, options = {}) {
+  const filePath = options.configPath ?? defaultConfigPath;
+  const stdout = getCommandIo6(options.stdout);
+  const logs = program.command("logs").description("Inspect record change logs");
+  logs.command("list").description("List change logs for a record").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector5).argument("<record>", "record uuid or slug", parseUuidOrSlugSelector5).action(async function action(schema, record) {
+    const { api, json } = createLogsApi(this, filePath);
+    const data = await api.listLogs(schema, record.value);
+    if (json) {
+      emitJson6(stdout, "logs list", data, filePath);
+      return;
+    }
+    emitTable3(stdout, data);
+  });
+}
+
+// src/commands/navigation.ts
+import { readFileSync as readFileSync6 } from "fs";
+import { InvalidArgumentError as InvalidArgumentError6 } from "commander";
+
+// src/api/navigation.ts
+function jsonOptions5(body, method) {
+  return {
+    method,
+    headers: {
+      "content-type": "application/json"
+    },
+    body: JSON.stringify(body)
+  };
+}
+function selectorValue7(selector2) {
+  return selector2.value;
+}
+var NavigationApi = class {
+  constructor(client) {
+    this.client = client;
+  }
+  listFolders() {
+    return this.client.getJson("/api/v2/navigation/folders");
+  }
+  createFolder(body) {
+    return this.client.requestJson(
+      "/api/v2/navigation/folders",
+      jsonOptions5(body, "POST")
+    );
+  }
+  updateFolder(folder, body) {
+    return this.client.requestJson(
+      `/api/v2/navigation/folders/${selectorValue7(folder)}`,
+      jsonOptions5(body, "PATCH")
+    );
+  }
+  deleteFolder(folder) {
+    return this.client.requestJson(
+      `/api/v2/navigation/folders/${selectorValue7(folder)}`,
+      { method: "DELETE" }
+    );
+  }
+  moveResource(body) {
+    return this.client.requestJson(
+      "/api/v2/navigation/resources:move",
+      jsonOptions5(body, "POST")
+    );
+  }
+};
+
+// src/commands/navigation.ts
+function getCommandIo7(stdout) {
+  return stdout ?? process.stdout;
+}
+function writeLine7(stdout, value) {
+  stdout.write(`${value}
+`);
+}
+function getGlobalOptions7(command) {
+  return command.optsWithGlobals();
+}
+function emitJson7(stdout, commandName, data, configPath) {
+  writeLine7(stdout, JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath })));
+}
+function toConfigurationError7(filePath, error) {
+  if (error instanceof CliError) {
+    throw error;
+  }
+  if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
+    throw new CliError("configuration_error", `Config file not found at ${filePath}.`);
+  }
+  if (error instanceof Error) {
+    throw new CliError("configuration_error", error.message);
+  }
+  throw error;
+}
+function createNavigationApi(command, filePath) {
+  try {
+    const config = readRuntimeConfig(filePath);
+    const runtime = resolveRuntimeContext(config, getGlobalOptions7(command));
+    if (!runtime.baseUrl) {
+      throw new CliError("configuration_error", `Resolved profile "${runtime.profile}" is missing a base URL.`);
+    }
+    return {
+      api: new NavigationApi(
+        new ApiClient({
+          baseUrl: runtime.baseUrl,
+          apiKey: runtime.apiKey
+        })
+      ),
+      json: runtime.json,
+      readOnly: runtime.readOnly
+    };
+  } catch (error) {
+    toConfigurationError7(filePath, error);
+  }
+}
+function ensureWritable5(commandName, readOnly, mode) {
+  if (readOnly) {
+    throw new CliError(
+      "command_not_allowed_in_read_only_mode",
+      `Command "${commandName}" is not allowed in read-only mode.`,
+      { commandMode: mode, executionMode: "read-only" }
+    );
+  }
+}
+function parseUuidOrSlugSelector6(input) {
+  try {
+    return normalizeUuidOrSlug(input);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Invalid selector.";
+    throw new InvalidArgumentError6(message);
+  }
+}
+function parseInteger(value, flagName) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const parsed = Number.parseInt(value, 10);
+  if (Number.isNaN(parsed)) {
+    throw new CliError("invalid_cli_usage", `${flagName} must be an integer.`);
+  }
+  return parsed;
+}
+function readJsonObject(raw, rawFile) {
+  if (raw && rawFile) {
+    throw new CliError("invalid_cli_usage", 'Use either "--props" or "--props-file", not both.');
+  }
+  const source = rawFile ? readFileSync6(rawFile, "utf8") : raw;
+  if (!source) {
+    return {};
+  }
+  try {
+    const parsed = JSON.parse(source);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      throw new CliError("invalid_cli_usage", "Props payload must be a JSON object.");
+    }
+    return parsed;
+  } catch (error) {
+    if (error instanceof CliError) {
+      throw error;
+    }
+    throw new CliError("invalid_cli_usage", "Props payload is invalid JSON.");
   }
 }
 function buildFolderBody(options) {
@@ -8300,24 +9296,24 @@ function folderRows2(folders) {
 }
 function registerNavigationCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
-  const stdout = getCommandIo6(options.stdout);
+  const stdout = getCommandIo7(options.stdout);
   const navigation = program.command("navigation").description("Manage workspace navigation");
   const folders = navigation.command("folders").description("Manage navigation folders");
   folders.command("list").description("List navigation folders").action(async function action() {
     const { api, json } = createNavigationApi(this, filePath);
     const data = await api.listFolders();
     if (json) {
-      emitJson6(stdout, "navigation folders list", data, filePath);
+      emitJson7(stdout, "navigation folders list", data, filePath);
       return;
     }
     printTable(folderRows2(data), ["id", "order", "name", "resourceCount"], stdout);
   });
-  folders.command("get").description("Get a navigation folder by UUID or exact name").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector5).action(async function action(folder) {
+  folders.command("get").description("Get a navigation folder by UUID or exact name").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector6).action(async function action(folder) {
     const { api, json } = createNavigationApi(this, filePath);
     const data = await api.listFolders();
     const resolved = resolveFolder2(data, folder);
     if (json) {
-      emitJson6(stdout, "navigation folders get", resolved, filePath);
+      emitJson7(stdout, "navigation folders get", resolved, filePath);
       return;
     }
     printTable(folderRows2([resolved]), ["id", "order", "name", "resourceCount"], stdout);
@@ -8327,12 +9323,12 @@ function registerNavigationCommands(program, options = {}) {
     ensureWritable5("navigation folders create", readOnly, "write");
     const data = await api.createFolder(buildFolderBody(commandOptions));
     if (json) {
-      emitJson6(stdout, "navigation folders create", data, filePath);
+      emitJson7(stdout, "navigation folders create", data, filePath);
       return;
     }
-    writeLine6(stdout, `Created navigation folder "${String(data.name ?? commandOptions.name)}".`);
+    writeLine7(stdout, `Created navigation folder "${String(data.name ?? commandOptions.name)}".`);
   });
-  folders.command("update").description("Update a navigation folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector5).option("--name <name>", "folder name").option("--order <n>", "folder order").option("--props <json>", "folder additionalProperties JSON").option("--props-file <path>", "folder additionalProperties JSON file").action(async function action(folder, commandOptions) {
+  folders.command("update").description("Update a navigation folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector6).option("--name <name>", "folder name").option("--order <n>", "folder order").option("--props <json>", "folder additionalProperties JSON").option("--props-file <path>", "folder additionalProperties JSON file").action(async function action(folder, commandOptions) {
     const { api, json, readOnly } = createNavigationApi(this, filePath);
     ensureWritable5("navigation folders update", readOnly, "write");
     const allFolders = await api.listFolders();
@@ -8343,54 +9339,54 @@ function registerNavigationCommands(program, options = {}) {
     }
     const data = await api.updateFolder({ kind: "uuid", value: resolved.id }, body);
     if (json) {
-      emitJson6(stdout, "navigation folders update", data, filePath);
+      emitJson7(stdout, "navigation folders update", data, filePath);
       return;
     }
-    writeLine6(stdout, `Updated navigation folder "${String(data.name ?? resolved.name ?? resolved.id)}".`);
+    writeLine7(stdout, `Updated navigation folder "${String(data.name ?? resolved.name ?? resolved.id)}".`);
   });
-  folders.command("delete").description("Delete a navigation folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector5).action(async function action(folder) {
+  folders.command("delete").description("Delete a navigation folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector6).action(async function action(folder) {
     const { api, json, readOnly } = createNavigationApi(this, filePath);
     ensureWritable5("navigation folders delete", readOnly, "destructive");
     const allFolders = await api.listFolders();
     const resolved = resolveFolder2(allFolders, folder);
     const data = await api.deleteFolder({ kind: "uuid", value: resolved.id });
     if (json) {
-      emitJson6(stdout, "navigation folders delete", data, filePath);
+      emitJson7(stdout, "navigation folders delete", data, filePath);
       return;
     }
-    writeLine6(stdout, `Deleted navigation folder "${resolved.name ?? resolved.id}".`);
+    writeLine7(stdout, `Deleted navigation folder "${resolved.name ?? resolved.id}".`);
   });
   navigation.command("resources").description("Manage navigation resources").command("move").description("Move a resource into a folder").argument("<resource>", "resource UUID").requiredOption("--type <type>", "resource type").requiredOption("--to <folder>", "target folder UUID or exact name").action(async function action(resourceId, commandOptions) {
     const { api, json, readOnly } = createNavigationApi(this, filePath);
     ensureWritable5("navigation resources move", readOnly, "write");
     const allFolders = await api.listFolders();
-    const resolved = resolveFolder2(allFolders, parseUuidOrSlugSelector5(commandOptions.to));
+    const resolved = resolveFolder2(allFolders, parseUuidOrSlugSelector6(commandOptions.to));
     const data = await api.moveResource({
       resourceId,
       resourceType: commandOptions.type.toUpperCase(),
       targetFolderId: resolved.id
     });
     if (json) {
-      emitJson6(stdout, "navigation resources move", data, filePath);
+      emitJson7(stdout, "navigation resources move", data, filePath);
       return;
     }
-    writeLine6(stdout, `Moved resource "${resourceId}" to "${resolved.name ?? resolved.id}".`);
+    writeLine7(stdout, `Moved resource "${resourceId}" to "${resolved.name ?? resolved.id}".`);
   });
 }
 
 // src/commands/profiles.ts
-function getCommandIo7(stdout) {
+function getCommandIo8(stdout) {
   return stdout ?? process.stdout;
 }
-function writeLine7(stdout, value) {
+function writeLine8(stdout, value) {
   stdout.write(`${value}
 `);
 }
-function getGlobalOptions7(command) {
+function getGlobalOptions8(command) {
   return command.optsWithGlobals();
 }
-function emitJson7(stdout, commandName, data, configPath) {
-  writeLine7(
+function emitJson8(stdout, commandName, data, configPath) {
+  writeLine8(
     stdout,
     JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath }))
   );
@@ -8433,15 +9429,15 @@ function emitProfilesTable(stdout, data) {
 }
 function registerProfilesCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
-  const stdout = getCommandIo7(options.stdout);
+  const stdout = getCommandIo8(options.stdout);
   const profiles = program.command("profiles").description("Manage local CLI profiles");
   profiles.command("list").description("List configured profiles").action(function action() {
     const config = readRequiredConfig(filePath);
     const data = Object.entries(config.profiles).map(
       ([name, profile]) => toDisplayProfile(name, profile, config.defaultProfile)
     );
-    if (getGlobalOptions7(this).json) {
-      emitJson7(stdout, "profiles list", data, filePath);
+    if (getGlobalOptions8(this).json) {
+      emitJson8(stdout, "profiles list", data, filePath);
       return;
     }
     emitProfilesTable(stdout, data);
@@ -8450,8 +9446,8 @@ function registerProfilesCommands(program, options = {}) {
     const config = readRequiredConfig(filePath);
     const profile = getRequiredProfile(config, profileName);
     const data = toDisplayProfile(profileName, profile, config.defaultProfile);
-    if (getGlobalOptions7(this).json) {
-      emitJson7(stdout, "profiles get", data, filePath);
+    if (getGlobalOptions8(this).json) {
+      emitJson8(stdout, "profiles get", data, filePath);
       return;
     }
     emitProfilesTable(stdout, [data]);
@@ -8465,11 +9461,11 @@ function registerProfilesCommands(program, options = {}) {
       profile: profileName,
       defaultProfile: nextConfig.defaultProfile
     };
-    if (getGlobalOptions7(this).json) {
-      emitJson7(stdout, "profiles use", data, filePath);
+    if (getGlobalOptions8(this).json) {
+      emitJson8(stdout, "profiles use", data, filePath);
       return;
     }
-    writeLine7(stdout, `Using profile "${profileName}".`);
+    writeLine8(stdout, `Using profile "${profileName}".`);
   });
   profiles.command("add").description("Add a profile to the local config").argument("<profile>", "profile name").requiredOption("--api-key <token>", "API key").option("--base-url <url>", "base URL").action(function action(profileName, commandOptions) {
     const config = loadConfigForAdd(filePath);
@@ -8492,11 +9488,11 @@ function registerProfilesCommands(program, options = {}) {
       nextConfig.profiles[profileName] ?? {},
       nextConfig.defaultProfile
     );
-    if (getGlobalOptions7(this).json) {
-      emitJson7(stdout, "profiles add", data, filePath);
+    if (getGlobalOptions8(this).json) {
+      emitJson8(stdout, "profiles add", data, filePath);
       return;
     }
-    writeLine7(stdout, `Added profile "${profileName}".`);
+    writeLine8(stdout, `Added profile "${profileName}".`);
   });
   profiles.command("update").description("Update an existing profile").argument("<profile>", "profile name").option("--api-key <token>", "API key").option("--base-url <url>", "base URL").action(function action(profileName, commandOptions) {
     if (commandOptions.apiKey === void 0 && commandOptions.baseUrl === void 0) {
@@ -8517,11 +9513,11 @@ function registerProfilesCommands(program, options = {}) {
       nextConfig.profiles[profileName] ?? {},
       nextConfig.defaultProfile
     );
-    if (getGlobalOptions7(this).json) {
-      emitJson7(stdout, "profiles update", data, filePath);
+    if (getGlobalOptions8(this).json) {
+      emitJson8(stdout, "profiles update", data, filePath);
       return;
     }
-    writeLine7(stdout, `Updated profile "${profileName}".`);
+    writeLine8(stdout, `Updated profile "${profileName}".`);
   });
   profiles.command("remove").description("Remove a profile from the local config").argument("<profile>", "profile name").action(function action(profileName) {
     const config = readRequiredConfig(filePath);
@@ -8532,17 +9528,17 @@ function registerProfilesCommands(program, options = {}) {
       profile: profileName,
       defaultProfile: nextConfig.defaultProfile
     };
-    if (getGlobalOptions7(this).json) {
-      emitJson7(stdout, "profiles remove", data, filePath);
+    if (getGlobalOptions8(this).json) {
+      emitJson8(stdout, "profiles remove", data, filePath);
       return;
     }
-    writeLine7(stdout, `Removed profile "${profileName}".`);
+    writeLine8(stdout, `Removed profile "${profileName}".`);
   });
 }
 
 // src/commands/records.ts
 import { readFileSync as readFileSync7 } from "fs";
-import { InvalidArgumentError as InvalidArgumentError6 } from "commander";
+import { InvalidArgumentError as InvalidArgumentError7 } from "commander";
 
 // src/api/records.ts
 function jsonOptions6(body, method) {
@@ -8554,7 +9550,7 @@ function jsonOptions6(body, method) {
     body: JSON.stringify(body)
   };
 }
-function selectorValue7(selector2) {
+function selectorValue8(selector2) {
   return selector2.value;
 }
 var RecordsApi = class {
@@ -8569,7 +9565,7 @@ var RecordsApi = class {
     if (query.offset !== void 0) {
       params.set("offset", String(query.offset));
     }
-    const path = `/api/v2/schemas/${selectorValue7(schema)}/records`;
+    const path = `/api/v2/schemas/${selectorValue8(schema)}/records`;
     const queryString = params.toString();
     return this.client.getJson(
       queryString ? `${path}?${queryString}` : path
@@ -8578,30 +9574,30 @@ var RecordsApi = class {
   queryRecords(schema, query) {
     const body = this.normalizeQueryInput(query);
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue7(schema)}/records:query`,
+      `/api/v2/schemas/${selectorValue8(schema)}/records:query`,
       jsonOptions6(body, "POST")
     );
   }
   getRecord(schema, record) {
     return this.client.getJson(
-      `/api/v2/schemas/${selectorValue7(schema)}/records/${selectorValue7(record)}`
+      `/api/v2/schemas/${selectorValue8(schema)}/records/${selectorValue8(record)}`
     );
   }
   createRecord(schema, input) {
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue7(schema)}/records`,
+      `/api/v2/schemas/${selectorValue8(schema)}/records`,
       jsonOptions6(input, "POST")
     );
   }
   updateRecord(schema, record, input) {
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue7(schema)}/records/${selectorValue7(record)}`,
+      `/api/v2/schemas/${selectorValue8(schema)}/records/${selectorValue8(record)}`,
       jsonOptions6(input, "PATCH")
     );
   }
   deleteRecord(schema, record) {
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue7(schema)}/records/${selectorValue7(record)}`,
+      `/api/v2/schemas/${selectorValue8(schema)}/records/${selectorValue8(record)}`,
       { method: "DELETE" }
     );
   }
@@ -8714,23 +9710,23 @@ function parseExpression(input) {
 }
 
 // src/commands/records.ts
-function getCommandIo8(stdout) {
+function getCommandIo9(stdout) {
   return stdout ?? process.stdout;
 }
-function writeLine8(stdout, value) {
+function writeLine9(stdout, value) {
   stdout.write(`${value}
 `);
 }
-function getGlobalOptions8(command) {
+function getGlobalOptions9(command) {
   return command.optsWithGlobals();
 }
-function emitJson8(stdout, commandName, data, configPath, meta = {}) {
-  writeLine8(
+function emitJson9(stdout, commandName, data, configPath, meta = {}) {
+  writeLine9(
     stdout,
     JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath, ...meta }))
   );
 }
-function toConfigurationError7(filePath, error) {
+function toConfigurationError8(filePath, error) {
   if (error instanceof CliError) {
     throw error;
   }
@@ -8745,7 +9741,7 @@ function toConfigurationError7(filePath, error) {
 function createRecordsApi(command, filePath) {
   try {
     const config = readRuntimeConfig(filePath);
-    const runtime = resolveRuntimeContext(config, getGlobalOptions8(command));
+    const runtime = resolveRuntimeContext(config, getGlobalOptions9(command));
     if (!runtime.baseUrl) {
       throw new CliError(
         "configuration_error",
@@ -8764,7 +9760,7 @@ function createRecordsApi(command, filePath) {
       readOnly: runtime.readOnly
     };
   } catch (error) {
-    toConfigurationError7(filePath, error);
+    toConfigurationError8(filePath, error);
   }
 }
 function ensureWritable6(commandName, readOnly, commandMode) {
@@ -8779,24 +9775,24 @@ function ensureWritable6(commandName, readOnly, commandMode) {
     );
   }
 }
-function parseUuidOrSlugSelector6(input) {
+function parseUuidOrSlugSelector7(input) {
   try {
     return normalizeUuidOrSlug(input);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Invalid selector.";
-    throw new InvalidArgumentError6(message);
+    throw new InvalidArgumentError7(message);
   }
 }
 function parseNonNegativeInteger2(input) {
   if (!/^\d+$/.test(input.trim())) {
-    throw new InvalidArgumentError6(`Expected a non-negative integer, received "${input}".`);
+    throw new InvalidArgumentError7(`Expected a non-negative integer, received "${input}".`);
   }
   return Number(input);
 }
 function parseCommaSeparatedValues(input, label) {
   const values = input.split(",").map((value) => value.trim()).filter(Boolean);
   if (values.length === 0) {
-    throw new InvalidArgumentError6(`Expected ${label} to contain at least one value.`);
+    throw new InvalidArgumentError7(`Expected ${label} to contain at least one value.`);
   }
   return values;
 }
@@ -8805,7 +9801,7 @@ function parseExpressionValue(input) {
     return parseExpression(input);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Invalid expression.";
-    throw new InvalidArgumentError6(message);
+    throw new InvalidArgumentError7(message);
   }
 }
 function parseKeyValueAssignment(input) {
@@ -8813,7 +9809,7 @@ function parseKeyValueAssignment(input) {
     return parseKeyValue(input);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Invalid assignment.";
-    throw new InvalidArgumentError6(message);
+    throw new InvalidArgumentError7(message);
   }
 }
 function parseJsonKeyValueAssignment(input) {
@@ -8821,7 +9817,7 @@ function parseJsonKeyValueAssignment(input) {
     return parseJsonAssignment(input);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Invalid JSON assignment.";
-    throw new InvalidArgumentError6(message);
+    throw new InvalidArgumentError7(message);
   }
 }
 function collectStringValues(value, previous = []) {
@@ -8839,7 +9835,7 @@ function collectKeyValueAssignments(value, previous = []) {
 function collectJsonAssignments(value, previous = []) {
   return [...previous, parseJsonKeyValueAssignment(value)];
 }
-function isJsonObject4(value) {
+function isJsonObject5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseRawJsonObject2(input, sourceLabel) {
@@ -8853,7 +9849,7 @@ function parseRawJsonObject2(input, sourceLabel) {
       `Failed to parse JSON from ${sourceLabel}: ${message}`
     );
   }
-  if (!isJsonObject4(parsed)) {
+  if (!isJsonObject5(parsed)) {
     throw new CliError(
       "invalid_cli_usage",
       `Expected ${sourceLabel} to contain a JSON object.`
@@ -8947,7 +9943,7 @@ function readRawSetPayload2(raw) {
   if (setValue === void 0) {
     return {};
   }
-  if (!isJsonObject4(setValue)) {
+  if (!isJsonObject5(setValue)) {
     throw new CliError(
       "invalid_cli_usage",
       'Expected raw update payload field "set" to be a JSON object.'
@@ -9000,17 +9996,17 @@ function buildRecordUpdateInput(options) {
   }
   return input;
 }
-function toTableRows3(data) {
+function toTableRows4(data) {
   if (Array.isArray(data)) {
-    return data.map((entry) => isJsonObject4(entry) ? entry : { value: entry });
+    return data.map((entry) => isJsonObject5(entry) ? entry : { value: entry });
   }
-  if (isJsonObject4(data)) {
+  if (isJsonObject5(data)) {
     return [data];
   }
   return [{ value: data }];
 }
-function emitTable3(stdout, data) {
-  printTable(toTableRows3(data), void 0, stdout);
+function emitTable4(stdout, data) {
+  printTable(toTableRows4(data), void 0, stdout);
 }
 function getQueryRecords(result) {
   return Array.isArray(result.records) ? result.records : [];
@@ -9034,9 +10030,9 @@ async function resolveSchemaSelector(api, selector2) {
 }
 function registerRecordsCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
-  const stdout = getCommandIo8(options.stdout);
+  const stdout = getCommandIo9(options.stdout);
   const records = program.command("records").description("Manage schema records");
-  records.command("list").description("List records for a schema with simple pagination").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector6).option("--limit <number>", "limit results", parseNonNegativeInteger2).option("--offset <number>", "offset results", parseNonNegativeInteger2).action(async function action(schema, commandOptions) {
+  records.command("list").description("List records for a schema with simple pagination").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).option("--limit <number>", "limit results", parseNonNegativeInteger2).option("--offset <number>", "offset results", parseNonNegativeInteger2).action(async function action(schema, commandOptions) {
     const { api, schemasApi, json } = createRecordsApi(this, filePath);
     const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
     const data = await api.listRecords(
@@ -9045,7 +10041,7 @@ function registerRecordsCommands(program, options = {}) {
     );
     const recordsData = getQueryRecords(data);
     if (json) {
-      emitJson8(
+      emitJson9(
         stdout,
         "records list",
         recordsData,
@@ -9054,9 +10050,9 @@ function registerRecordsCommands(program, options = {}) {
       );
       return;
     }
-    emitTable3(stdout, recordsData);
+    emitTable4(stdout, recordsData);
   });
-  records.command("query").description("Query records for a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector6).option("--select <fields>", "comma-separated field selection", (value) => parseCommaSeparatedValues(value, "--select")).option("--where <expression>", "where expression", collectWhereExpressions, []).option("--sort <field:direction>", "sort field(s)", collectSortValues, []).option("--limit <number>", "limit results", parseNonNegativeInteger2).option("--offset <number>", "offset results", parseNonNegativeInteger2).option("--raw <json>", "raw JSON object payload").option("--raw-file <path>", "path to a raw JSON object payload").action(async function action(schema, commandOptions) {
+  records.command("query").description("Query records for a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).option("--select <fields>", "comma-separated field selection", (value) => parseCommaSeparatedValues(value, "--select")).option("--where <expression>", "where expression", collectWhereExpressions, []).option("--sort <field:direction>", "sort field(s)", collectSortValues, []).option("--limit <number>", "limit results", parseNonNegativeInteger2).option("--offset <number>", "offset results", parseNonNegativeInteger2).option("--raw <json>", "raw JSON object payload").option("--raw-file <path>", "path to a raw JSON object payload").action(async function action(schema, commandOptions) {
     const { api, schemasApi, json } = createRecordsApi(this, filePath);
     const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
     const data = await api.queryRecords(
@@ -9065,7 +10061,7 @@ function registerRecordsCommands(program, options = {}) {
     );
     const recordsData = getQueryRecords(data);
     if (json) {
-      emitJson8(
+      emitJson9(
         stdout,
         "records query",
         recordsData,
@@ -9074,19 +10070,19 @@ function registerRecordsCommands(program, options = {}) {
       );
       return;
     }
-    emitTable3(stdout, recordsData);
+    emitTable4(stdout, recordsData);
   });
-  records.command("get").description("Get a record by UUID or slug").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector6).argument("<record>", "record uuid or slug", parseUuidOrSlugSelector6).action(async function action(schema, record) {
+  records.command("get").description("Get a record by UUID or slug").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).argument("<record>", "record uuid or slug", parseUuidOrSlugSelector7).action(async function action(schema, record) {
     const { api, schemasApi, json } = createRecordsApi(this, filePath);
     const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
     const data = await api.getRecord(resolvedSchema, record);
     if (json) {
-      emitJson8(stdout, "records get", data, filePath);
+      emitJson9(stdout, "records get", data, filePath);
       return;
     }
-    emitTable3(stdout, data);
+    emitTable4(stdout, data);
   });
-  records.command("create").description("Create a record").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector6).option("--set <field=value>", "set a string field", collectKeyValueAssignments, []).option("--set-json <field=json>", "set a structured field", collectJsonAssignments, []).option("--raw <json>", "raw JSON object payload").option("--raw-file <path>", "path to a raw JSON object payload").action(async function action(schema, commandOptions) {
+  records.command("create").description("Create a record").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).option("--set <field=value>", "set a string field", collectKeyValueAssignments, []).option("--set-json <field=json>", "set a structured field", collectJsonAssignments, []).option("--raw <json>", "raw JSON object payload").option("--raw-file <path>", "path to a raw JSON object payload").action(async function action(schema, commandOptions) {
     const { api, schemasApi, json, readOnly } = createRecordsApi(this, filePath);
     ensureWritable6("records create", readOnly, "write");
     const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
@@ -9095,12 +10091,12 @@ function registerRecordsCommands(program, options = {}) {
       buildRecordCreateInput(commandOptions)
     );
     if (json) {
-      emitJson8(stdout, "records create", data, filePath);
+      emitJson9(stdout, "records create", data, filePath);
       return;
     }
-    writeLine8(stdout, `Created record "${getRecordIdentifier(data)}".`);
+    writeLine9(stdout, `Created record "${getRecordIdentifier(data)}".`);
   });
-  records.command("update").description("Update a record").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector6).argument("<record>", "record uuid or slug", parseUuidOrSlugSelector6).option("--set <field=value>", "set a string field", collectKeyValueAssignments, []).option("--set-json <field=json>", "set a structured field", collectJsonAssignments, []).option("--unset <field>", "unset a field", collectStringValues, []).option("--raw <json>", "raw JSON object payload").option("--raw-file <path>", "path to a raw JSON object payload").action(async function action(schema, record, commandOptions) {
+  records.command("update").description("Update a record").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).argument("<record>", "record uuid or slug", parseUuidOrSlugSelector7).option("--set <field=value>", "set a string field", collectKeyValueAssignments, []).option("--set-json <field=json>", "set a structured field", collectJsonAssignments, []).option("--unset <field>", "unset a field", collectStringValues, []).option("--raw <json>", "raw JSON object payload").option("--raw-file <path>", "path to a raw JSON object payload").action(async function action(schema, record, commandOptions) {
     const { api, schemasApi, json, readOnly } = createRecordsApi(this, filePath);
     ensureWritable6("records update", readOnly, "write");
     const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
@@ -9110,12 +10106,12 @@ function registerRecordsCommands(program, options = {}) {
       buildRecordUpdateInput(commandOptions)
     );
     if (json) {
-      emitJson8(stdout, "records update", data, filePath);
+      emitJson9(stdout, "records update", data, filePath);
       return;
     }
-    writeLine8(stdout, `Updated record "${getRecordIdentifier(data)}".`);
+    writeLine9(stdout, `Updated record "${getRecordIdentifier(data)}".`);
   });
-  records.command("delete").description("Delete a record").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector6).argument("<record>", "record uuid or slug", parseUuidOrSlugSelector6).action(async function action(schema, record) {
+  records.command("delete").description("Delete a record").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).argument("<record>", "record uuid or slug", parseUuidOrSlugSelector7).action(async function action(schema, record) {
     const { api, schemasApi, json, readOnly } = createRecordsApi(this, filePath);
     ensureWritable6("records delete", readOnly, "destructive");
     const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
@@ -9126,33 +10122,33 @@ function registerRecordsCommands(program, options = {}) {
       deleted: true
     };
     if (json) {
-      emitJson8(stdout, "records delete", data, filePath);
+      emitJson9(stdout, "records delete", data, filePath);
       return;
     }
-    writeLine8(stdout, `Deleted record "${record.value}" from schema "${schema.value}".`);
+    writeLine9(stdout, `Deleted record "${record.value}" from schema "${schema.value}".`);
   });
 }
 
 // src/commands/schemas.ts
 import { readFileSync as readFileSync8 } from "fs";
-import { InvalidArgumentError as InvalidArgumentError7 } from "commander";
-function getCommandIo9(stdout) {
+import { InvalidArgumentError as InvalidArgumentError8 } from "commander";
+function getCommandIo10(stdout) {
   return stdout ?? process.stdout;
 }
-function writeLine9(stdout, value) {
+function writeLine10(stdout, value) {
   stdout.write(`${value}
 `);
 }
-function getGlobalOptions9(command) {
+function getGlobalOptions10(command) {
   return command.optsWithGlobals();
 }
-function emitJson9(stdout, commandName, data, configPath) {
-  writeLine9(
+function emitJson10(stdout, commandName, data, configPath) {
+  writeLine10(
     stdout,
     JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath }))
   );
 }
-function toConfigurationError8(filePath, error) {
+function toConfigurationError9(filePath, error) {
   if (error instanceof CliError) {
     throw error;
   }
@@ -9167,7 +10163,7 @@ function toConfigurationError8(filePath, error) {
 function createSchemasApi(command, filePath) {
   try {
     const config = readRuntimeConfig(filePath);
-    const runtime = resolveRuntimeContext(config, getGlobalOptions9(command));
+    const runtime = resolveRuntimeContext(config, getGlobalOptions10(command));
     if (!runtime.baseUrl) {
       throw new CliError(
         "configuration_error",
@@ -9186,7 +10182,7 @@ function createSchemasApi(command, filePath) {
       readOnly: runtime.readOnly
     };
   } catch (error) {
-    toConfigurationError8(filePath, error);
+    toConfigurationError9(filePath, error);
   }
 }
 function ensureWritable7(commandName, readOnly, commandMode) {
@@ -9201,12 +10197,12 @@ function ensureWritable7(commandName, readOnly, commandMode) {
     );
   }
 }
-function parseUuidOrSlugSelector7(input) {
+function parseUuidOrSlugSelector8(input) {
   try {
     return normalizeUuidOrSlug(input);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Invalid selector.";
-    throw new InvalidArgumentError7(message);
+    throw new InvalidArgumentError8(message);
   }
 }
 function parseBooleanFlag(input) {
@@ -9217,9 +10213,9 @@ function parseBooleanFlag(input) {
   if (["false", "0", "no", "n", "off"].includes(normalized)) {
     return false;
   }
-  throw new InvalidArgumentError7(`Expected a boolean value, received "${input}".`);
+  throw new InvalidArgumentError8(`Expected a boolean value, received "${input}".`);
 }
-function isJsonObject5(value) {
+function isJsonObject6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseRawJsonObject3(input, sourceLabel) {
@@ -9233,7 +10229,7 @@ function parseRawJsonObject3(input, sourceLabel) {
       `Failed to parse JSON from ${sourceLabel}: ${message}`
     );
   }
-  if (!isJsonObject5(parsed)) {
+  if (!isJsonObject6(parsed)) {
     throw new CliError(
       "invalid_cli_usage",
       `Expected ${sourceLabel} to contain a JSON object.`
@@ -9313,7 +10309,7 @@ function applyFieldDefaultValue(input, defaultValue) {
     return;
   }
   const config = input.config;
-  if (config !== void 0 && !isJsonObject5(config)) {
+  if (config !== void 0 && !isJsonObject6(config)) {
     throw new CliError(
       "invalid_cli_usage",
       'Expected field "config" to be a JSON object when using "--default".'
@@ -9353,7 +10349,7 @@ function buildFieldCreateInput(options) {
     input.required = options.required;
   }
   applyFieldDefaultValue(input, options.default);
-  if ("config" in input && isJsonObject5(input.config) && isEmptyObject5(input.config)) {
+  if ("config" in input && isJsonObject6(input.config) && isEmptyObject5(input.config)) {
     delete input.config;
   }
   return input;
@@ -9431,23 +10427,23 @@ function isEmptyObject5(value) {
 }
 function registerSchemasCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
-  const stdout = getCommandIo9(options.stdout);
+  const stdout = getCommandIo10(options.stdout);
   const schemas = program.command("schemas").description("Manage schemas and schema fields");
   schemas.command("list").description("List schemas").action(async function action() {
     const { api, json } = createSchemasApi(this, filePath);
     const data = await api.listSchemas();
     if (json) {
-      emitJson9(stdout, "schemas list", data, filePath);
+      emitJson10(stdout, "schemas list", data, filePath);
       return;
     }
     emitSchemasTable(stdout, data);
   });
-  schemas.command("get").description("Get a schema by UUID or slug").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).action(async function action(schema) {
+  schemas.command("get").description("Get a schema by UUID or slug").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).action(async function action(schema) {
     const { api, json } = createSchemasApi(this, filePath);
     const resolvedSchema = await resolveSchemaSelector2(api, schema);
     const data = await api.getSchema(resolvedSchema);
     if (json) {
-      emitJson9(stdout, "schemas get", data, filePath);
+      emitJson10(stdout, "schemas get", data, filePath);
       return;
     }
     emitSchemasTable(stdout, [data]);
@@ -9463,12 +10459,12 @@ function registerSchemasCommands(program, options = {}) {
     };
     const data = await api.createSchema(input);
     if (json) {
-      emitJson9(stdout, "schemas create", data, filePath);
+      emitJson10(stdout, "schemas create", data, filePath);
       return;
     }
-    writeLine9(stdout, `Created schema "${data.slug ?? commandOptions.slug}".`);
+    writeLine10(stdout, `Created schema "${data.slug ?? commandOptions.slug}".`);
   });
-  schemas.command("update").description("Update a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).option("--name <name>", "schema name").option("--slug <slug>", "schema slug").option("--auditable <bool>", "auditable flag", parseBooleanFlag).option("--commentable <bool>", "commentable flag", parseBooleanFlag).action(async function action(schema, commandOptions) {
+  schemas.command("update").description("Update a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).option("--name <name>", "schema name").option("--slug <slug>", "schema slug").option("--auditable <bool>", "auditable flag", parseBooleanFlag).option("--commentable <bool>", "commentable flag", parseBooleanFlag).action(async function action(schema, commandOptions) {
     const { api, json, readOnly } = createSchemasApi(this, filePath);
     ensureWritable7("schemas update", readOnly, "write");
     const resolvedSchema = await resolveSchemaSelector2(api, schema);
@@ -9481,12 +10477,12 @@ function registerSchemasCommands(program, options = {}) {
     }
     const data = await api.updateSchema(resolvedSchema, input);
     if (json) {
-      emitJson9(stdout, "schemas update", data, filePath);
+      emitJson10(stdout, "schemas update", data, filePath);
       return;
     }
-    writeLine9(stdout, `Updated schema "${data.slug ?? schema.value}".`);
+    writeLine10(stdout, `Updated schema "${data.slug ?? schema.value}".`);
   });
-  schemas.command("delete").description("Delete a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).action(async function action(schema) {
+  schemas.command("delete").description("Delete a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).action(async function action(schema) {
     const { api, json, readOnly } = createSchemasApi(this, filePath);
     ensureWritable7("schemas delete", readOnly, "destructive");
     const resolvedSchema = await resolveSchemaSelector2(api, schema);
@@ -9496,34 +10492,34 @@ function registerSchemasCommands(program, options = {}) {
       deleted: true
     };
     if (json) {
-      emitJson9(stdout, "schemas delete", data, filePath);
+      emitJson10(stdout, "schemas delete", data, filePath);
       return;
     }
-    writeLine9(stdout, `Deleted schema "${schema.value}".`);
+    writeLine10(stdout, `Deleted schema "${schema.value}".`);
   });
   const fields = schemas.command("fields").description("Manage schema fields");
-  fields.command("list").description("List fields for a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).action(async function action(schema) {
+  fields.command("list").description("List fields for a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).action(async function action(schema) {
     const { api, json } = createSchemasApi(this, filePath);
     const resolvedSchema = await resolveSchemaSelector2(api, schema);
     const data = await api.listFields(resolvedSchema);
     if (json) {
-      emitJson9(stdout, "schemas fields list", data, filePath);
+      emitJson10(stdout, "schemas fields list", data, filePath);
       return;
     }
     emitFieldsTable(stdout, data);
   });
-  fields.command("get").description("Get a field by UUID or slug").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).argument("<field>", "field uuid or slug", parseUuidOrSlugSelector7).action(async function action(schema, field) {
+  fields.command("get").description("Get a field by UUID or slug").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).argument("<field>", "field uuid or slug", parseUuidOrSlugSelector8).action(async function action(schema, field) {
     const { api, json } = createSchemasApi(this, filePath);
     const resolvedSchema = await resolveSchemaSelector2(api, schema);
     const resolvedField = await resolveFieldSelector(api, resolvedSchema, field);
     const data = await api.getField(resolvedSchema, resolvedField);
     if (json) {
-      emitJson9(stdout, "schemas fields get", data, filePath);
+      emitJson10(stdout, "schemas fields get", data, filePath);
       return;
     }
     emitFieldsTable(stdout, [data]);
   });
-  fields.command("create").description(`Create a field in a schema.${buildSchemaFieldCreateHelpText()}`).argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).option("--type <type>", `field type (${formatSchemaFieldTypes()})`).option("--slug <slug>", "field slug").option("--label <label>", "field label").option("--required <bool>", "required flag", parseBooleanFlag).option("--default <value>", "default field value").option("--raw <json>", "raw JSON object payload (see type-specific shapes in --help)").option("--raw-file <path>", "path to a raw JSON object payload").action(async function action(schema, commandOptions) {
+  fields.command("create").description(`Create a field in a schema.${buildSchemaFieldCreateHelpText()}`).argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).option("--type <type>", `field type (${formatSchemaFieldTypes()})`).option("--slug <slug>", "field slug").option("--label <label>", "field label").option("--required <bool>", "required flag", parseBooleanFlag).option("--default <value>", "default field value").option("--raw <json>", "raw JSON object payload (see type-specific shapes in --help)").option("--raw-file <path>", "path to a raw JSON object payload").action(async function action(schema, commandOptions) {
     const { api, json, readOnly } = createSchemasApi(this, filePath);
     ensureWritable7("schemas fields create", readOnly, "write");
     const input = buildFieldCreateInput(commandOptions);
@@ -9535,12 +10531,12 @@ function registerSchemasCommands(program, options = {}) {
       toFieldCreateError(error, input);
     }
     if (json) {
-      emitJson9(stdout, "schemas fields create", data, filePath);
+      emitJson10(stdout, "schemas fields create", data, filePath);
       return;
     }
-    writeLine9(stdout, `Created field "${data.slug ?? commandOptions.slug}".`);
+    writeLine10(stdout, `Created field "${data.slug ?? commandOptions.slug}".`);
   });
-  fields.command("update").description("Update a field in a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).argument("<field>", "field uuid or slug", parseUuidOrSlugSelector7).option("--label <label>", "field label").option("--required <bool>", "required flag", parseBooleanFlag).option("--default <value>", "default field value").option("--raw <json>", "raw JSON object payload").option("--raw-file <path>", "path to a raw JSON object payload").action(async function action(schema, field, commandOptions) {
+  fields.command("update").description("Update a field in a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).argument("<field>", "field uuid or slug", parseUuidOrSlugSelector8).option("--label <label>", "field label").option("--required <bool>", "required flag", parseBooleanFlag).option("--default <value>", "default field value").option("--raw <json>", "raw JSON object payload").option("--raw-file <path>", "path to a raw JSON object payload").action(async function action(schema, field, commandOptions) {
     const { api, json, readOnly } = createSchemasApi(this, filePath);
     ensureWritable7("schemas fields update", readOnly, "write");
     const resolvedSchema = await resolveSchemaSelector2(api, schema);
@@ -9559,12 +10555,12 @@ function registerSchemasCommands(program, options = {}) {
     }
     const data = await api.updateField(resolvedSchema, resolvedField, input);
     if (json) {
-      emitJson9(stdout, "schemas fields update", data, filePath);
+      emitJson10(stdout, "schemas fields update", data, filePath);
       return;
     }
-    writeLine9(stdout, `Updated field "${data.slug ?? field.value}".`);
+    writeLine10(stdout, `Updated field "${data.slug ?? field.value}".`);
   });
-  fields.command("delete").description("Delete a field from a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).argument("<field>", "field uuid or slug", parseUuidOrSlugSelector7).action(async function action(schema, field) {
+  fields.command("delete").description("Delete a field from a schema").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector8).argument("<field>", "field uuid or slug", parseUuidOrSlugSelector8).action(async function action(schema, field) {
     const { api, json, readOnly } = createSchemasApi(this, filePath);
     ensureWritable7("schemas fields delete", readOnly, "destructive");
     const resolvedSchema = await resolveSchemaSelector2(api, schema);
@@ -9576,16 +10572,16 @@ function registerSchemasCommands(program, options = {}) {
       deleted: true
     };
     if (json) {
-      emitJson9(stdout, "schemas fields delete", data, filePath);
+      emitJson10(stdout, "schemas fields delete", data, filePath);
       return;
     }
-    writeLine9(stdout, `Deleted field "${field.value}" from schema "${schema.value}".`);
+    writeLine10(stdout, `Deleted field "${field.value}" from schema "${schema.value}".`);
   });
 }
 
 // src/commands/teamspace.ts
 import { readFileSync as readFileSync9 } from "fs";
-import { InvalidArgumentError as InvalidArgumentError8 } from "commander";
+import { InvalidArgumentError as InvalidArgumentError9 } from "commander";
 
 // src/api/teamspace.ts
 function jsonOptions7(body, method) {
@@ -9597,7 +10593,7 @@ function jsonOptions7(body, method) {
     body: JSON.stringify(body)
   };
 }
-function selectorValue8(selector2) {
+function selectorValue9(selector2) {
   return selector2.value;
 }
 var TeamspaceApi = class {
@@ -9623,13 +10619,13 @@ var TeamspaceApi = class {
   }
   updateFolder(folder, input) {
     return this.client.requestJson(
-      `/api/v2/teamspaces/folders/${selectorValue8(folder)}`,
+      `/api/v2/teamspaces/folders/${selectorValue9(folder)}`,
       jsonOptions7(input, "PATCH")
     );
   }
   deleteFolder(folder) {
     return this.client.requestJson(
-      `/api/v2/teamspaces/folders/${selectorValue8(folder)}`,
+      `/api/v2/teamspaces/folders/${selectorValue9(folder)}`,
       { method: "DELETE" }
     );
   }
@@ -9648,23 +10644,23 @@ var TeamspaceApi = class {
 };
 
 // src/commands/teamspace.ts
-function getCommandIo10(stdout) {
+function getCommandIo11(stdout) {
   return stdout ?? process.stdout;
 }
-function writeLine10(stdout, value) {
+function writeLine11(stdout, value) {
   stdout.write(`${value}
 `);
 }
-function getGlobalOptions10(command) {
+function getGlobalOptions11(command) {
   return command.optsWithGlobals();
 }
-function emitJson10(stdout, commandName, data, configPath) {
-  writeLine10(
+function emitJson11(stdout, commandName, data, configPath) {
+  writeLine11(
     stdout,
     JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath }))
   );
 }
-function toConfigurationError9(filePath, error) {
+function toConfigurationError10(filePath, error) {
   if (error instanceof CliError) {
     throw error;
   }
@@ -9679,7 +10675,7 @@ function toConfigurationError9(filePath, error) {
 function createTeamspaceApi(command, filePath) {
   try {
     const config = readRuntimeConfig(filePath);
-    const runtime = resolveRuntimeContext(config, getGlobalOptions10(command));
+    const runtime = resolveRuntimeContext(config, getGlobalOptions11(command));
     if (!runtime.baseUrl) {
       throw new CliError(
         "configuration_error",
@@ -9697,7 +10693,7 @@ function createTeamspaceApi(command, filePath) {
       readOnly: runtime.readOnly
     };
   } catch (error) {
-    toConfigurationError9(filePath, error);
+    toConfigurationError10(filePath, error);
   }
 }
 function ensureWritable8(commandName, readOnly, commandMode) {
@@ -9712,21 +10708,21 @@ function ensureWritable8(commandName, readOnly, commandMode) {
     );
   }
 }
-function parseUuidOrSlugSelector8(input) {
+function parseUuidOrSlugSelector9(input) {
   try {
     return normalizeUuidOrSlug(input);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Invalid selector.";
-    throw new InvalidArgumentError8(message);
+    throw new InvalidArgumentError9(message);
   }
 }
 function parseNonNegativeInteger3(input) {
   if (!/^\d+$/.test(input.trim())) {
-    throw new InvalidArgumentError8(`Expected a non-negative integer, received "${input}".`);
+    throw new InvalidArgumentError9(`Expected a non-negative integer, received "${input}".`);
   }
   return Number(input);
 }
-function isJsonObject6(value) {
+function isJsonObject7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseRawJsonObject4(input, sourceLabel) {
@@ -9740,7 +10736,7 @@ function parseRawJsonObject4(input, sourceLabel) {
       `Failed to parse JSON from ${sourceLabel}: ${message}`
     );
   }
-  if (!isJsonObject6(parsed)) {
+  if (!isJsonObject7(parsed)) {
     throw new CliError(
       "invalid_cli_usage",
       `Expected ${sourceLabel} to contain a JSON object.`
@@ -9812,17 +10808,17 @@ function buildFolderUpdateInput(options) {
   }
   return input;
 }
-function toTableRows4(data) {
+function toTableRows5(data) {
   if (Array.isArray(data)) {
-    return data.map((entry) => isJsonObject6(entry) ? entry : { value: entry });
+    return data.map((entry) => isJsonObject7(entry) ? entry : { value: entry });
   }
-  if (isJsonObject6(data)) {
+  if (isJsonObject7(data)) {
     return [data];
   }
   return [{ value: data }];
 }
-function emitTable4(stdout, data) {
-  printTable(toTableRows4(data), void 0, stdout);
+function emitTable5(stdout, data) {
+  printTable(toTableRows5(data), void 0, stdout);
 }
 function getFolderIdentifier(folder) {
   return typeof folder.id === "string" ? folder.id : typeof folder.name === "string" ? folder.name : "unknown";
@@ -9878,63 +10874,63 @@ async function resolveFolderSelector2(api, selector2) {
 }
 function registerTeamspaceCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
-  const stdout = getCommandIo10(options.stdout);
+  const stdout = getCommandIo11(options.stdout);
   const teamspace = program.command("teamspace").description("Manage teamspace folders and resources");
   const folders = teamspace.command("folders").description("Manage teamspace folders");
   folders.command("list").description("List teamspace folders").option("--include-resources", "include nested resources").action(async function action(commandOptions) {
     const { api, json } = createTeamspaceApi(this, filePath);
     const data = await api.listFolders(Boolean(commandOptions.includeResources));
     if (json) {
-      emitJson10(stdout, "teamspace folders list", data, filePath);
+      emitJson11(stdout, "teamspace folders list", data, filePath);
       return;
     }
-    emitTable4(stdout, data);
+    emitTable5(stdout, data);
   });
-  folders.command("get").description("Get a teamspace folder by exact name or UUID").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector8).option("--include-resources", "include nested resources").action(async function action(folder, commandOptions) {
+  folders.command("get").description("Get a teamspace folder by exact name or UUID").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector9).option("--include-resources", "include nested resources").action(async function action(folder, commandOptions) {
     const { api, json } = createTeamspaceApi(this, filePath);
     const resolvedFolder = await resolveFolderSelector2(api, folder);
     const allFolders = await api.listFolders(Boolean(commandOptions.includeResources));
     const data = findFolderEntity(allFolders, resolvedFolder);
     if (json) {
-      emitJson10(stdout, "teamspace folders get", data, filePath);
+      emitJson11(stdout, "teamspace folders get", data, filePath);
       return;
     }
-    emitTable4(stdout, data);
+    emitTable5(stdout, data);
   });
   folders.command("create").description("Create a teamspace folder").requiredOption("--name <name>", "folder name").option("--order <n>", "folder order", parseNonNegativeInteger3).option("--props <json>", "folder properties payload").option("--props-file <path>", "path to a folder properties JSON payload").action(async function action(commandOptions) {
     const { api, json, readOnly } = createTeamspaceApi(this, filePath);
     ensureWritable8("teamspace folders create", readOnly, "write");
     const data = await api.createFolder(buildFolderCreateInput(commandOptions));
     if (json) {
-      emitJson10(stdout, "teamspace folders create", data, filePath);
+      emitJson11(stdout, "teamspace folders create", data, filePath);
       return;
     }
-    writeLine10(stdout, `Created folder "${getFolderIdentifier(data)}".`);
+    writeLine11(stdout, `Created folder "${getFolderIdentifier(data)}".`);
   });
-  folders.command("update").description("Update a teamspace folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector8).option("--name <name>", "folder name").option("--order <n>", "folder order", parseNonNegativeInteger3).option("--props <json>", "folder properties payload").option("--props-file <path>", "path to a folder properties JSON payload").action(async function action(folder, commandOptions) {
+  folders.command("update").description("Update a teamspace folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector9).option("--name <name>", "folder name").option("--order <n>", "folder order", parseNonNegativeInteger3).option("--props <json>", "folder properties payload").option("--props-file <path>", "path to a folder properties JSON payload").action(async function action(folder, commandOptions) {
     const { api, json, readOnly } = createTeamspaceApi(this, filePath);
     ensureWritable8("teamspace folders update", readOnly, "write");
     const resolvedFolder = await resolveFolderSelector2(api, folder);
     const data = await api.updateFolder(resolvedFolder, buildFolderUpdateInput(commandOptions));
     if (json) {
-      emitJson10(stdout, "teamspace folders update", data, filePath);
+      emitJson11(stdout, "teamspace folders update", data, filePath);
       return;
     }
-    writeLine10(stdout, `Updated folder "${getFolderIdentifier(data)}".`);
+    writeLine11(stdout, `Updated folder "${getFolderIdentifier(data)}".`);
   });
-  folders.command("delete").description("Delete a teamspace folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector8).action(async function action(folder) {
+  folders.command("delete").description("Delete a teamspace folder").argument("<folder>", "folder UUID or exact name", parseUuidOrSlugSelector9).action(async function action(folder) {
     const { api, json, readOnly } = createTeamspaceApi(this, filePath);
     ensureWritable8("teamspace folders delete", readOnly, "destructive");
     const resolvedFolder = await resolveFolderSelector2(api, folder);
     const data = await api.deleteFolder(resolvedFolder);
     if (json) {
-      emitJson10(stdout, "teamspace folders delete", data, filePath);
+      emitJson11(stdout, "teamspace folders delete", data, filePath);
       return;
     }
-    writeLine10(stdout, `Deleted folder "${resolvedFolder.value}".`);
+    writeLine11(stdout, `Deleted folder "${resolvedFolder.value}".`);
   });
   const resources = teamspace.command("resources").description("Manage teamspace resources");
-  resources.command("publish").description("Publish a resource to a teamspace folder").argument("<resource>", "resource UUID or exact name", parseUuidOrSlugSelector8).requiredOption("--to <folder>", "target folder", parseUuidOrSlugSelector8).action(async function action(resource, commandOptions) {
+  resources.command("publish").description("Publish a resource to a teamspace folder").argument("<resource>", "resource UUID or exact name", parseUuidOrSlugSelector9).requiredOption("--to <folder>", "target folder", parseUuidOrSlugSelector9).action(async function action(resource, commandOptions) {
     const { api, json, readOnly } = createTeamspaceApi(this, filePath);
     ensureWritable8("teamspace resources publish", readOnly, "write");
     const folder = await resolveFolderSelector2(api, commandOptions.to);
@@ -9943,20 +10939,20 @@ function registerTeamspaceCommands(program, options = {}) {
       targetFolderId: folder.value
     });
     if (json) {
-      emitJson10(stdout, "teamspace resources publish", data, filePath);
+      emitJson11(stdout, "teamspace resources publish", data, filePath);
       return;
     }
-    writeLine10(stdout, `Published resource "${resource.value}" to folder "${folder.value}".`);
+    writeLine11(stdout, `Published resource "${resource.value}" to folder "${folder.value}".`);
   });
-  resources.command("unpublish").description("Unpublish a resource from teamspace").argument("<resource>", "resource UUID or exact name", parseUuidOrSlugSelector8).action(async function action(resource) {
+  resources.command("unpublish").description("Unpublish a resource from teamspace").argument("<resource>", "resource UUID or exact name", parseUuidOrSlugSelector9).action(async function action(resource) {
     const { api, json, readOnly } = createTeamspaceApi(this, filePath);
     ensureWritable8("teamspace resources unpublish", readOnly, "write");
     const data = await api.unpublishResource(resource.value);
     if (json) {
-      emitJson10(stdout, "teamspace resources unpublish", data, filePath);
+      emitJson11(stdout, "teamspace resources unpublish", data, filePath);
       return;
     }
-    writeLine10(stdout, `Unpublished resource "${resource.value}".`);
+    writeLine11(stdout, `Unpublished resource "${resource.value}".`);
   });
 }
 
@@ -9964,8 +10960,8 @@ function registerTeamspaceCommands(program, options = {}) {
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
 function buildProgram(options = {}) {
-  const program = new Command9();
-  program.name("zinkee").description("CLI for Zinkee API v2").version(version).enablePositionalOptions().showHelpAfterError().option("--profile <name>", "select a profile from config").option("--base-url <url>", "override the configured base URL").option("--api-key <token>", "override the configured API key").option("--read-only", "run in read-only mode").option("--example", "show examples for a command").option("--json", "emit JSON output");
+  const program = new Command10();
+  program.name("zinkee").description("CLI for Zinkee API v2").version(version).enablePositionalOptions().showHelpAfterError().option("--profile <name>", "select a profile from config").option("--base-url <url>", "override the configured base URL").option("--api-key <token>", "override the configured API key").option("--read-only", "run in read-only mode").option("--example", "show examples for a command").option("--json", "emit JSON output").option("--install-completion [shell]", "install shell completion (bash, zsh, fish, powershell)").option("--show-completion [shell]", "print shell completion script for the current shell");
   registerProfilesCommands(program, options);
   registerAutomationsCommands(program, options);
   registerConfigCommands(program, options);
@@ -9975,10 +10971,544 @@ function buildProgram(options = {}) {
   registerSchemasCommands(program, options);
   registerRecordsCommands(program, options);
   registerCommentsCommands(program, options);
+  registerLogsCommands(program, options);
   registerTeamspaceCommands(program, options);
   return program;
 }
 
+// src/completion/engine.ts
+function readProfileNamesFromConfig(configPath) {
+  try {
+    const config = readConfigIfExists(configPath);
+    if (!config) {
+      return [];
+    }
+    return Object.keys(config.profiles).sort();
+  } catch {
+    return [];
+  }
+}
+function findSubcommand(command, name) {
+  return command.commands.find((sub) => {
+    if (sub.name() === name) {
+      return true;
+    }
+    const aliases = sub.aliases();
+    return aliases.includes(name);
+  });
+}
+function collectFlagsThatTakeValues(root) {
+  const flags = /* @__PURE__ */ new Set();
+  const walk = (command) => {
+    for (const option of command.options) {
+      if (!option.required && !option.optional) {
+        continue;
+      }
+      if (option.long) {
+        flags.add(option.long);
+      }
+      if (option.short) {
+        flags.add(option.short);
+      }
+    }
+    for (const sub of command.commands) {
+      walk(sub);
+    }
+  };
+  walk(root);
+  return flags;
+}
+function descend(root, words) {
+  const flagsWithValues = collectFlagsThatTakeValues(root);
+  let current = root;
+  let index = 0;
+  while (index < words.length) {
+    const word = words[index];
+    if (word.startsWith("-")) {
+      const [flagPart] = word.split("=", 1);
+      if (flagPart && flagsWithValues.has(flagPart) && !word.includes("=")) {
+        index += 2;
+      } else {
+        index += 1;
+      }
+      continue;
+    }
+    const next = findSubcommand(current, word);
+    if (!next) {
+      break;
+    }
+    current = next;
+    index += 1;
+  }
+  return current;
+}
+function collectVisibleSubcommands(command) {
+  const names = [];
+  for (const sub of command.commands) {
+    if (sub.name().startsWith("__")) {
+      continue;
+    }
+    names.push(sub.name());
+  }
+  return names;
+}
+function collectVisibleLongFlags(command) {
+  const flags = [];
+  let current = command;
+  while (current) {
+    for (const option of current.options) {
+      if (option.hidden || !option.long) {
+        continue;
+      }
+      if (!flags.includes(option.long)) {
+        flags.push(option.long);
+      }
+    }
+    current = current.parent;
+  }
+  if (!flags.includes("--help")) {
+    flags.push("--help");
+  }
+  return flags;
+}
+function getCompletions(program, request, deps = {}) {
+  const { words, cwordIndex } = request;
+  const safeIndex = Math.max(0, Math.min(cwordIndex, words.length));
+  const current = words[safeIndex] ?? "";
+  const prevToken = safeIndex > 0 ? words[safeIndex - 1] : void 0;
+  const readProfiles = deps.readProfileNames ?? readProfileNamesFromConfig;
+  if (prevToken === "--profile" || prevToken === "-p") {
+    try {
+      return readProfiles(deps.configPath).filter((name) => name.startsWith(current)).slice().sort();
+    } catch {
+      return [];
+    }
+  }
+  const tokensBeforeCurrent = words.slice(1, safeIndex);
+  const command = descend(program, tokensBeforeCurrent);
+  const candidates = /* @__PURE__ */ new Set();
+  if (current.startsWith("-")) {
+    for (const flag of collectVisibleLongFlags(command)) {
+      if (flag.startsWith(current)) {
+        candidates.add(flag);
+      }
+    }
+    return [...candidates].sort();
+  }
+  for (const subcommand of collectVisibleSubcommands(command)) {
+    if (subcommand.startsWith(current)) {
+      candidates.add(subcommand);
+    }
+  }
+  for (const flag of collectVisibleLongFlags(command)) {
+    if (flag.startsWith(current)) {
+      candidates.add(flag);
+    }
+  }
+  return [...candidates].sort();
+}
+
+// src/completion/install.ts
+import { execFileSync } from "child_process";
+import { mkdirSync as mkdirSync2, readFileSync as readFileSync10, writeFileSync as writeFileSync3 } from "fs";
+import { homedir as homedir2, platform } from "os";
+import { basename as basename2, dirname as dirname2, join as join2 } from "path";
+
+// src/completion/scripts.ts
+var PROGRAM = "zinkee";
+var ENV_VAR = "_ZINKEE_COMPLETE";
+function renderBashScript() {
+  return `_zinkee_completion() {
+    local IFS=$'\\n'
+    local response
+
+    response=$(env COMP_WORDS="\${COMP_WORDS[*]}" COMP_CWORD=$COMP_CWORD ${ENV_VAR}=bash_complete ${PROGRAM} 2>/dev/null)
+
+    COMPREPLY=( \${response} )
+    return 0
+}
+
+complete -o default -F _zinkee_completion ${PROGRAM}
+`;
+}
+function renderZshScript() {
+  return `#compdef ${PROGRAM}
+
+_zinkee_completion() {
+    local -a response
+    (( ! $+commands[${PROGRAM}] )) && return 1
+
+    response=("\${(@f)$(env COMP_WORDS="\${words[*]}" COMP_CWORD=$((CURRENT - 1)) ${ENV_VAR}=zsh_complete ${PROGRAM} 2>/dev/null)}")
+
+    if [ -n "$response" ]; then
+        compadd -U -V unsorted -a response
+    fi
+}
+
+if [[ $zsh_eval_context[-1] == loadautofunc ]]; then
+    _zinkee_completion "$@"
+else
+    compdef _zinkee_completion ${PROGRAM}
+fi
+`;
+}
+function renderFishScript() {
+  return `function __zinkee_completion
+    set -l tokens (commandline -opc) (commandline -ct)
+    set -l cword (math (count $tokens) - 1)
+    set -l joined (string join " " -- $tokens)
+
+    env COMP_WORDS="$joined" COMP_CWORD=$cword ${ENV_VAR}=fish_complete ${PROGRAM} 2>/dev/null
+end
+
+complete --no-files --command ${PROGRAM} --arguments '(__zinkee_completion)'
+`;
+}
+function renderPowerShellScript() {
+  return `Register-ArgumentCompleter -Native -CommandName ${PROGRAM} -ScriptBlock {
+    param($wordToComplete, $commandAst, $cursorPosition)
+
+    $tokens = @($commandAst.CommandElements | ForEach-Object { $_.ToString() })
+    $cword = [Math]::Max(0, $tokens.Count - 1)
+
+    $env:COMP_WORDS = ($tokens -join ' ')
+    $env:COMP_CWORD = $cword
+    $env:${ENV_VAR} = 'powershell_complete'
+
+    try {
+        & ${PROGRAM} 2>$null | ForEach-Object {
+            [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+        }
+    } finally {
+        Remove-Item Env:COMP_WORDS -ErrorAction SilentlyContinue
+        Remove-Item Env:COMP_CWORD -ErrorAction SilentlyContinue
+        Remove-Item Env:${ENV_VAR} -ErrorAction SilentlyContinue
+    }
+}
+`;
+}
+function renderScript(shell) {
+  switch (shell) {
+    case "bash":
+      return renderBashScript();
+    case "zsh":
+      return renderZshScript();
+    case "fish":
+      return renderFishScript();
+    case "powershell":
+      return renderPowerShellScript();
+  }
+}
+
+// src/completion/install.ts
+var SUPPORTED_SHELLS = [
+  "bash",
+  "zsh",
+  "fish",
+  "powershell"
+];
+var BLOCK_BEGIN = "# >>> zinkee completion >>>";
+var BLOCK_END = "# <<< zinkee completion <<<";
+var CompletionShellError = class extends Error {
+  name = "CompletionShellError";
+};
+function defaultPowerShellProfile(env) {
+  for (const exe of ["pwsh", "powershell.exe"]) {
+    try {
+      const out = execFileSync(exe, ["-NoProfile", "-Command", "$PROFILE"], {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"]
+      });
+      const path = out.trim();
+      if (path) {
+        return path;
+      }
+    } catch {
+    }
+  }
+  if (env.platform === "win32") {
+    return join2(env.home, "Documents", "PowerShell", "Microsoft.PowerShell_profile.ps1");
+  }
+  return join2(env.home, ".config", "powershell", "Microsoft.PowerShell_profile.ps1");
+}
+function detectShell(env) {
+  const fromEnv = env.shellEnv;
+  if (fromEnv) {
+    const name = basename2(fromEnv).toLowerCase().replace(/\.exe$/, "");
+    if (name === "bash") {
+      return "bash";
+    }
+    if (name === "zsh") {
+      return "zsh";
+    }
+    if (name === "fish") {
+      return "fish";
+    }
+    if (name === "pwsh" || name === "powershell") {
+      return "powershell";
+    }
+  }
+  if (env.platform === "win32") {
+    return "powershell";
+  }
+  throw new CompletionShellError(
+    `Could not detect a supported shell from $SHELL=${fromEnv ?? ""}. Pass one of: ${SUPPORTED_SHELLS.join(", ")}.`
+  );
+}
+function parseShell(value) {
+  const normalized = value.toLowerCase();
+  if (normalized === "bash" || normalized === "zsh" || normalized === "fish" || normalized === "powershell") {
+    return normalized;
+  }
+  if (normalized === "pwsh") {
+    return "powershell";
+  }
+  throw new CompletionShellError(
+    `Unsupported shell "${value}". Supported: ${SUPPORTED_SHELLS.join(", ")}.`
+  );
+}
+function resolveTarget(shell, env) {
+  switch (shell) {
+    case "bash":
+      return {
+        shell,
+        scriptPath: join2(env.home, ".bash_completions", "zinkee.sh"),
+        rcPath: join2(env.home, ".bashrc")
+      };
+    case "zsh":
+      return {
+        shell,
+        scriptPath: join2(env.home, ".zfunc", "_zinkee"),
+        rcPath: join2(env.home, ".zshrc")
+      };
+    case "fish":
+      return {
+        shell,
+        scriptPath: join2(env.home, ".config", "fish", "completions", "zinkee.fish")
+      };
+    case "powershell": {
+      const resolver = env.resolvePowerShellProfile ?? (() => defaultPowerShellProfile(env));
+      const profilePath = resolver();
+      if (!profilePath) {
+        throw new CompletionShellError(
+          "Could not resolve PowerShell $PROFILE path. Install PowerShell or use --show-completion."
+        );
+      }
+      return {
+        shell,
+        scriptPath: profilePath,
+        rcPath: profilePath
+      };
+    }
+  }
+}
+function buildRcSnippet(shell, scriptPath) {
+  switch (shell) {
+    case "bash":
+      return `source "${scriptPath}"`;
+    case "zsh":
+      return [
+        `fpath=("${dirname2(scriptPath)}" $fpath)`,
+        "autoload -Uz compinit && compinit"
+      ].join("\n");
+    default:
+      return "";
+  }
+}
+function applyBlock(existing, block) {
+  const wrapped = `${BLOCK_BEGIN}
+${block.trimEnd()}
+${BLOCK_END}
+`;
+  const blockPattern = new RegExp(
+    `${BLOCK_BEGIN.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[\\s\\S]*?${BLOCK_END.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\n?`,
+    "m"
+  );
+  if (blockPattern.test(existing)) {
+    return existing.replace(blockPattern, wrapped);
+  }
+  const separator = existing.length === 0 || existing.endsWith("\n") ? "" : "\n";
+  return `${existing}${separator}${wrapped}`;
+}
+function readFileOrEmpty(path) {
+  try {
+    return readFileSync10(path, "utf8");
+  } catch (error) {
+    if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
+      return "";
+    }
+    throw error;
+  }
+}
+function writeFileEnsuringDir(path, content) {
+  mkdirSync2(dirname2(path), { recursive: true });
+  writeFileSync3(path, content, "utf8");
+}
+function installCompletion(shell, env) {
+  const target = resolveTarget(shell, env);
+  const script = renderScript(shell);
+  if (shell === "powershell") {
+    const existing = readFileOrEmpty(target.scriptPath);
+    const updated = applyBlock(existing, script);
+    writeFileEnsuringDir(target.scriptPath, updated);
+    return {
+      shell,
+      scriptPath: target.scriptPath,
+      rcPath: target.scriptPath,
+      rcUpdated: true
+    };
+  }
+  writeFileEnsuringDir(target.scriptPath, script);
+  if (!target.rcPath) {
+    return {
+      shell,
+      scriptPath: target.scriptPath,
+      rcUpdated: false
+    };
+  }
+  const snippet = buildRcSnippet(shell, target.scriptPath);
+  if (!snippet) {
+    return {
+      shell,
+      scriptPath: target.scriptPath,
+      rcPath: target.rcPath,
+      rcUpdated: false
+    };
+  }
+  const existingRc = readFileOrEmpty(target.rcPath);
+  const updatedRc = applyBlock(existingRc, snippet);
+  if (updatedRc !== existingRc) {
+    writeFileEnsuringDir(target.rcPath, updatedRc);
+    return {
+      shell,
+      scriptPath: target.scriptPath,
+      rcPath: target.rcPath,
+      rcUpdated: true
+    };
+  }
+  return {
+    shell,
+    scriptPath: target.scriptPath,
+    rcPath: target.rcPath,
+    rcUpdated: false
+  };
+}
+function currentEnvironment() {
+  return {
+    home: homedir2(),
+    platform: platform(),
+    shellEnv: process.env.SHELL
+  };
+}
+
+// src/completion/runtime.ts
+var COMPLETION_ENV_VAR = "_ZINKEE_COMPLETE";
+function getStream(stream, fallback) {
+  return stream ?? fallback;
+}
+function parseEnvWords(env) {
+  const raw = env.COMP_WORDS ?? "";
+  if (raw.trim().length === 0) {
+    return [];
+  }
+  return raw.split(/\s+/).filter((token) => token.length > 0);
+}
+function parseEnvCwordIndex(env) {
+  const raw = env.COMP_CWORD ?? "0";
+  const parsed = Number.parseInt(raw, 10);
+  if (Number.isNaN(parsed) || parsed < 0) {
+    return 0;
+  }
+  return parsed;
+}
+function isCompletionRequest(env = process.env) {
+  return typeof env[COMPLETION_ENV_VAR] === "string" && env[COMPLETION_ENV_VAR].length > 0;
+}
+function runCompletionRequest(env = process.env, stdout) {
+  const out = getStream(stdout, process.stdout);
+  try {
+    const program = buildProgram();
+    const candidates = getCompletions(program, {
+      words: parseEnvWords(env),
+      cwordIndex: parseEnvCwordIndex(env)
+    });
+    if (candidates.length > 0) {
+      out.write(`${candidates.join("\n")}
+`);
+    }
+  } catch {
+  }
+}
+function extractCompletionFlag(argv) {
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+    if (!token) {
+      continue;
+    }
+    if (token === "--install-completion" || token === "--show-completion") {
+      const mode = token === "--install-completion" ? "install" : "show";
+      const next = argv[index + 1];
+      const shellOverride = next && !next.startsWith("-") ? next : void 0;
+      return { mode, shellOverride };
+    }
+    if (token.startsWith("--install-completion=")) {
+      const value = token.slice("--install-completion=".length);
+      return { mode: "install", shellOverride: value || void 0 };
+    }
+    if (token.startsWith("--show-completion=")) {
+      const value = token.slice("--show-completion=".length);
+      return { mode: "show", shellOverride: value || void 0 };
+    }
+  }
+  return null;
+}
+function resolveShell(request, env) {
+  if (request.shellOverride) {
+    return parseShell(request.shellOverride);
+  }
+  return detectShell(env);
+}
+function handleCompletionFlag(request, deps = {}) {
+  const env = deps.environment ?? currentEnvironment();
+  const out = getStream(deps.stdout, process.stdout);
+  const err = getStream(deps.stderr, process.stderr);
+  let shell;
+  try {
+    shell = resolveShell(request, env);
+  } catch (error) {
+    const message = error instanceof CompletionShellError ? error.message : String(error);
+    err.write(`${message}
+`);
+    return 1;
+  }
+  if (request.mode === "show") {
+    out.write(renderScript(shell));
+    return 0;
+  }
+  try {
+    const result = installCompletion(shell, env);
+    err.write(`zinkee completion installed for ${shell}.
+`);
+    err.write(`  script: ${result.scriptPath}
+`);
+    if (result.rcPath && result.rcPath !== result.scriptPath) {
+      err.write(
+        result.rcUpdated ? `  updated: ${result.rcPath}
+` : `  unchanged: ${result.rcPath}
+`
+      );
+    }
+    err.write(`Restart your shell or open a new session to enable completion.
+`);
+    return 0;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    err.write(`Failed to install zinkee completion: ${message}
+`);
+    return 1;
+  }
+}
+
 // src/cli-runner.ts
 var ExampleDisplayed = class extends Error {
   name = "ExampleDisplayed";
@@ -10001,6 +11531,16 @@ function isExecutedAsEntry(argvEntry, moduleUrl) {
 }
 async function runCli(argv) {
   try {
+    if (isCompletionRequest()) {
+      runCompletionRequest();
+      return;
+    }
+    const completionFlag = extractCompletionFlag(argv);
+    if (completionFlag) {
+      const exitCode = handleCompletionFlag(completionFlag);
+      process.exitCode = exitCode;
+      return;
+    }
     const exampleRequest = extractExampleRequest(argv);
     if (exampleRequest) {
       await showExamples(