@workbuddy/cli-edge 1.0.5 → 1.0.7

package/dist/index.js

@@ -2709,7 +2709,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Search mode",
         enumValues: ["jobs", "stages"]
       },
       {
@@ -2719,7 +2719,7 @@ var operations = [
         source: "body",
         type: "integer",
         required: false,
-        description: ""
+        description: "Maximum number of results to return"
       },
       {
         name: "cursor",
@@ -2728,7 +2728,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Pagination cursor from a previous response"
       },
       {
         name: "sortBy",
@@ -2737,7 +2737,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Field to sort results by",
         enumValues: ["created_at", "due_date", "completed_date", "priority"]
       },
       {
@@ -2747,7 +2747,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Sort direction: asc or desc",
         enumValues: ["asc", "desc"]
       },
       {
@@ -2757,7 +2757,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "Status filter"
       },
       {
         name: "customer",
@@ -2766,7 +2766,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "Inline customer object — alternative to customerId"
       },
       {
         name: "site",
@@ -2775,7 +2775,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "Inline site object — alternative to siteId"
       },
       {
         name: "type",
@@ -2883,7 +2883,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Free-text search query"
       },
       {
         name: "createdDate",
@@ -2892,7 +2892,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Date range filter for creation date"
       },
       {
         name: "dueDate",
@@ -2901,7 +2901,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Due date (ISO 8601 datetime)"
       },
       {
         name: "completedDate",
@@ -2910,7 +2910,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Completion date (ISO 8601 datetime)"
       },
       {
         name: "finalisedDate",
@@ -2919,7 +2919,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Finalisation date (ISO 8601 datetime)"
       },
       {
         name: "stageDueDate",
@@ -2928,7 +2928,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "stage due date (ISO 8601 datetime)"
       },
       {
         name: "stageCompletedDate",
@@ -2937,7 +2937,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "stage completed date (ISO 8601 datetime)"
       },
       {
         name: "fields",
@@ -2946,7 +2946,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "Field projection — array of field names to include in the response"
       },
       {
         name: "include",
@@ -2955,7 +2955,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "Related entities to include in the response"
       },
       {
         name: "raw-body",
@@ -3013,7 +3013,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Reason for the action (e.g. cancellation reason)"
       },
       {
         name: "raw-body",
@@ -3042,7 +3042,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Display name"
       },
       {
         name: "description",
@@ -3051,7 +3051,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Detailed description"
       },
       {
         name: "customerId",
@@ -3060,7 +3060,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Customer ID — use /crm/customers to look up"
       },
       {
         name: "customer",
@@ -3069,7 +3069,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Inline customer object — alternative to customerId"
       },
       {
         name: "siteId",
@@ -3078,7 +3078,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Site ID — use /crm/sites to look up"
       },
       {
         name: "site",
@@ -3087,7 +3087,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Inline site object — alternative to siteId"
       },
       {
         name: "contactId",
@@ -3096,7 +3096,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Contact ID — use /crm/contacts to look up"
       },
       {
         name: "contact",
@@ -3105,7 +3105,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Inline contact object — alternative to contactId"
       },
       {
         name: "typeId",
@@ -3114,7 +3114,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Job type ID — use /settings/job-types to look up"
       },
       {
         name: "priorityId",
@@ -3123,7 +3123,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Priority ID — use /settings/priorities to look up"
       },
       {
         name: "priceBookId",
@@ -3132,7 +3132,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Price book ID for job pricing"
       },
       {
         name: "ownerId",
@@ -3141,7 +3141,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Owner (employee) ID — use /crm/employees to look up"
       },
       {
         name: "fieldSupervisorId",
@@ -3150,7 +3150,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Field supervisor (employee) ID — use /crm/employees to look up"
       },
       {
         name: "zoneId",
@@ -3159,7 +3159,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Zone ID — use /settings/zones to look up"
       },
       {
         name: "tagIds",
@@ -3168,7 +3168,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of tag IDs (comma-separated, e.g. "id1,id2") — use /settings/tags to look up'
       },
       {
         name: "notes",
@@ -3177,7 +3177,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Additional notes or comments"
       },
       {
         name: "reference",
@@ -3186,7 +3186,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "External reference number"
       },
       {
         name: "customerWO",
@@ -3195,7 +3195,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Customer work order reference"
       },
       {
         name: "customerPO",
@@ -3204,7 +3204,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Customer purchase order reference"
       },
       {
         name: "templateId",
@@ -3213,7 +3213,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Template ID to pre-populate fields from a template"
       },
       {
         name: "startDate",
@@ -3222,7 +3222,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Start date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -3232,7 +3232,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Due date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -3242,7 +3242,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Custom fields as key-value pairs — validated against tenant field definitions"
       },
       {
         name: "raw-body",
@@ -3280,7 +3280,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "For optimistic concurrency — update fails if entity was modified after this timestamp",
         format: "date-time"
       },
       {
@@ -3290,7 +3290,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Display name"
       },
       {
         name: "description",
@@ -3299,7 +3299,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Detailed description"
       },
       {
         name: "siteId",
@@ -3308,7 +3308,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Site ID — use /crm/sites to look up"
       },
       {
         name: "contactId",
@@ -3317,7 +3317,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Contact ID — use /crm/contacts to look up"
       },
       {
         name: "typeId",
@@ -3326,7 +3326,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Job type ID — use /settings/job-types to look up"
       },
       {
         name: "priorityId",
@@ -3335,7 +3335,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Priority ID — use /settings/priorities to look up"
       },
       {
         name: "priceBookId",
@@ -3344,7 +3344,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Price book ID for job pricing"
       },
       {
         name: "ownerId",
@@ -3353,7 +3353,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Owner (employee) ID — use /crm/employees to look up"
       },
       {
         name: "fieldSupervisorId",
@@ -3362,7 +3362,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Field supervisor (employee) ID — use /crm/employees to look up"
       },
       {
         name: "zoneId",
@@ -3371,7 +3371,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Zone ID — use /settings/zones to look up"
       },
       {
         name: "tagIds",
@@ -3380,7 +3380,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of tag IDs (comma-separated, e.g. "id1,id2") — use /settings/tags to look up'
       },
       {
         name: "notes",
@@ -3389,7 +3389,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Additional notes or comments"
       },
       {
         name: "reference",
@@ -3398,7 +3398,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "External reference number"
       },
       {
         name: "customerWO",
@@ -3407,7 +3407,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Customer work order reference"
       },
       {
         name: "customerPO",
@@ -3416,7 +3416,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Customer purchase order reference"
       },
       {
         name: "startDate",
@@ -3425,7 +3425,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Start date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -3435,7 +3435,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Due date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -3445,7 +3445,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Custom fields as key-value pairs — validated against tenant field definitions"
       },
       {
         name: "raw-body",
@@ -3646,7 +3646,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "name",
@@ -3655,7 +3655,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Display name"
       },
       {
         name: "workCategoryId",
@@ -3664,7 +3664,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Work category ID — use /settings/work-types to look up"
       },
       {
         name: "sequence",
@@ -3673,7 +3673,7 @@ var operations = [
         source: "body",
         type: "number",
         required: false,
-        description: ""
+        description: "Display order / sequence number"
       },
       {
         name: "startDate",
@@ -3682,7 +3682,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Start date (ISO 8601 datetime)"
       },
       {
         name: "dueDate",
@@ -3691,7 +3691,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Due date (ISO 8601 datetime)"
       },
       {
         name: "notes",
@@ -3700,7 +3700,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Additional notes or comments"
       },
       {
         name: "customFields",
@@ -3709,7 +3709,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Custom fields as key-value pairs — validated against tenant field definitions"
       },
       {
         name: "raw-body",
@@ -3747,7 +3747,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Display name"
       },
       {
         name: "workCategoryId",
@@ -3756,7 +3756,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Work category ID — use /settings/work-types to look up"
       },
       {
         name: "startDate",
@@ -3765,7 +3765,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Start date (ISO 8601 datetime)"
       },
       {
         name: "dueDate",
@@ -3774,7 +3774,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Due date (ISO 8601 datetime)"
       },
       {
         name: "notes",
@@ -3783,7 +3783,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Additional notes or comments"
       },
       {
         name: "tagsSet",
@@ -3852,7 +3852,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Custom fields as key-value pairs — validated against tenant field definitions"
       },
       {
         name: "raw-body",
@@ -3930,7 +3930,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Completion date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -3940,7 +3940,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Additional notes or comments"
       },
       {
         name: "raw-body",
@@ -3978,7 +3978,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Finalisation date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -4179,7 +4179,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "contactId",
@@ -4188,7 +4188,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Contact ID — use /crm/contacts to look up"
       },
       {
         name: "raw-body",
@@ -4358,7 +4358,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "status",
@@ -4367,7 +4367,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: "",
+        description: "Status filter",
         enumValues: ["enroute", "onsite", "checkedout", "completed", "onhold"]
       },
       {
@@ -4623,7 +4623,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       }
     ],
     hasRequestBody: false
@@ -4643,7 +4643,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -4672,7 +4672,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -4701,7 +4701,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "body",
@@ -4710,7 +4710,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "labelIds",
@@ -4719,7 +4719,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of label/tag IDs to attach (comma-separated, e.g. "id1,id2")'
       },
       {
         name: "attachmentIds",
@@ -4728,7 +4728,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Attachment IDs from the upload endpoint (comma-separated, e.g. "id1,id2")'
       },
       {
         name: "sharing",
@@ -4737,7 +4737,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Sharing options — control visibility to customer portal and field app"
       },
       {
         name: "raw-body",
@@ -4766,7 +4766,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "templateId",
@@ -4775,7 +4775,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Template ID to pre-populate fields from a template"
       },
       {
         name: "subject",
@@ -4784,7 +4784,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Email subject line"
       },
       {
         name: "body",
@@ -4793,7 +4793,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "to",
@@ -4802,7 +4802,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "Recipients"
       },
       {
         name: "cc",
@@ -4811,7 +4811,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "CC recipients"
       },
       {
         name: "bcc",
@@ -4820,7 +4820,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "BCC recipients"
       },
       {
         name: "labelIds",
@@ -4829,7 +4829,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of label/tag IDs to attach (comma-separated, e.g. "id1,id2")'
       },
       {
         name: "attachmentIds",
@@ -4838,7 +4838,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Attachment IDs from the upload endpoint (comma-separated, e.g. "id1,id2")'
       },
       {
         name: "sharing",
@@ -4847,7 +4847,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Sharing options — control visibility to customer portal and field app"
       },
       {
         name: "raw-body",
@@ -4876,7 +4876,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "templateId",
@@ -4885,7 +4885,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Template ID to pre-populate fields from a template"
       },
       {
         name: "body",
@@ -4894,7 +4894,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "to",
@@ -4903,7 +4903,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "Recipients"
       },
       {
         name: "labelIds",
@@ -4912,7 +4912,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of label/tag IDs to attach (comma-separated, e.g. "id1,id2")'
       },
       {
         name: "sharing",
@@ -4921,7 +4921,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Sharing options — control visibility to customer portal and field app"
       },
       {
         name: "raw-body",
@@ -4950,7 +4950,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "direction",
@@ -4996,7 +4996,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "call date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -5006,7 +5006,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "labelIds",
@@ -5015,7 +5015,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of label/tag IDs to attach (comma-separated, e.g. "id1,id2")'
       },
       {
         name: "sharing",
@@ -5024,7 +5024,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Sharing options — control visibility to customer portal and field app"
       },
       {
         name: "raw-body",
@@ -5053,7 +5053,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "body",
@@ -5062,7 +5062,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "integrationType",
@@ -5080,7 +5080,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Sharing options — control visibility to customer portal and field app"
       },
       {
         name: "raw-body",
@@ -5109,7 +5109,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -5138,7 +5138,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "id",
@@ -5176,7 +5176,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "id",
@@ -5214,7 +5214,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -5232,7 +5232,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "labelIds",
@@ -5241,7 +5241,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of label/tag IDs to attach (comma-separated, e.g. "id1,id2")'
       },
       {
         name: "attachmentIds",
@@ -5250,7 +5250,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Attachment IDs from the upload endpoint (comma-separated, e.g. "id1,id2")'
       },
       {
         name: "sharing",
@@ -5259,7 +5259,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Sharing options — control visibility to customer portal and field app"
       },
       {
         name: "raw-body",
@@ -5288,7 +5288,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -5306,7 +5306,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Template ID to pre-populate fields from a template"
       },
       {
         name: "subject",
@@ -5315,7 +5315,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Email subject line"
       },
       {
         name: "body",
@@ -5324,7 +5324,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "to",
@@ -5333,7 +5333,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "Recipients"
       },
       {
         name: "cc",
@@ -5342,7 +5342,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "CC recipients"
       },
       {
         name: "bcc",
@@ -5351,7 +5351,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "BCC recipients"
       },
       {
         name: "labelIds",
@@ -5360,7 +5360,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of label/tag IDs to attach (comma-separated, e.g. "id1,id2")'
       },
       {
         name: "attachmentIds",
@@ -5369,7 +5369,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Attachment IDs from the upload endpoint (comma-separated, e.g. "id1,id2")'
       },
       {
         name: "sharing",
@@ -5378,7 +5378,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Sharing options — control visibility to customer portal and field app"
       },
       {
         name: "raw-body",
@@ -5407,7 +5407,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -5425,7 +5425,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Template ID to pre-populate fields from a template"
       },
       {
         name: "body",
@@ -5434,7 +5434,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "to",
@@ -5443,7 +5443,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "Recipients"
       },
       {
         name: "labelIds",
@@ -5452,7 +5452,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of label/tag IDs to attach (comma-separated, e.g. "id1,id2")'
       },
       {
         name: "sharing",
@@ -5461,7 +5461,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Sharing options — control visibility to customer portal and field app"
       },
       {
         name: "raw-body",
@@ -5490,7 +5490,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -5545,7 +5545,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "call date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -5555,7 +5555,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "labelIds",
@@ -5564,7 +5564,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of label/tag IDs to attach (comma-separated, e.g. "id1,id2")'
       },
       {
         name: "sharing",
@@ -5573,7 +5573,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Sharing options — control visibility to customer portal and field app"
       },
       {
         name: "raw-body",
@@ -5602,7 +5602,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -5620,7 +5620,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "integrationType",
@@ -5638,7 +5638,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Sharing options — control visibility to customer portal and field app"
       },
       {
         name: "raw-body",
@@ -5667,7 +5667,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       }
     ],
     hasRequestBody: false
@@ -5687,7 +5687,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       }
     ],
     hasRequestBody: false
@@ -5707,7 +5707,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -5736,7 +5736,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -5765,7 +5765,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -5794,7 +5794,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -5823,7 +5823,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "id",
@@ -5861,7 +5861,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "id",
@@ -5899,7 +5899,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       }
     ],
     hasRequestBody: false
@@ -5919,7 +5919,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "name",
@@ -5928,7 +5928,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Display name"
       },
       {
         name: "description",
@@ -5937,7 +5937,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Detailed description"
       },
       {
         name: "target",
@@ -5956,7 +5956,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "assignee ID"
       },
       {
         name: "dueDate",
@@ -5965,7 +5965,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Due date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -5975,7 +5975,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of tag IDs (comma-separated, e.g. "id1,id2") — use /settings/tags to look up'
       },
       {
         name: "evidenceOptions",
@@ -5993,7 +5993,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Sharing options — control visibility to customer portal and field app"
       },
       {
         name: "raw-body",
@@ -6022,7 +6022,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -6051,7 +6051,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -6069,7 +6069,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Display name"
       },
       {
         name: "description",
@@ -6078,7 +6078,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Detailed description"
       },
       {
         name: "status",
@@ -6087,7 +6087,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Status filter",
         enumValues: ["open", "completed"]
       },
       {
@@ -6107,7 +6107,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "assignee ID"
       },
       {
         name: "dueDate",
@@ -6116,7 +6116,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Due date (ISO 8601 datetime)"
       },
       {
         name: "completedOn",
@@ -6134,7 +6134,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "completed by ID"
       },
       {
         name: "tagIds",
@@ -6143,7 +6143,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of tag IDs (comma-separated, e.g. "id1,id2") — use /settings/tags to look up'
       },
       {
         name: "sharing",
@@ -6152,7 +6152,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Sharing options — control visibility to customer portal and field app"
       },
       {
         name: "raw-body",
@@ -6181,7 +6181,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -6210,7 +6210,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -6228,7 +6228,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of signature attachment IDs (comma-separated in CLI, e.g. "id1,id2")'
       },
       {
         name: "beforePhotoAttachmentIds",
@@ -6237,7 +6237,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of before photo attachment IDs (comma-separated in CLI, e.g. "id1,id2")'
       },
       {
         name: "duringPhotoAttachmentIds",
@@ -6246,7 +6246,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of during photo attachment IDs (comma-separated in CLI, e.g. "id1,id2")'
       },
       {
         name: "afterPhotoAttachmentIds",
@@ -6255,7 +6255,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of after photo attachment IDs (comma-separated in CLI, e.g. "id1,id2")'
       },
       {
         name: "comment",
@@ -6282,7 +6282,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "form response ID"
       },
       {
         name: "fileAttachmentIds",
@@ -6291,7 +6291,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of file attachment IDs (comma-separated in CLI, e.g. "id1,id2")'
       },
       {
         name: "additionalFileAttachmentIds",
@@ -6300,7 +6300,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of additional file attachment IDs (comma-separated in CLI, e.g. "id1,id2")'
       },
       {
         name: "complete",
@@ -6338,7 +6338,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -6347,7 +6347,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       }
     ],
     hasRequestBody: false
@@ -6367,7 +6367,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -6376,7 +6376,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "name",
@@ -6385,7 +6385,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Display name"
       },
       {
         name: "description",
@@ -6394,7 +6394,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Detailed description"
       },
       {
         name: "target",
@@ -6413,7 +6413,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "assignee ID"
       },
       {
         name: "dueDate",
@@ -6422,7 +6422,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Due date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -6432,7 +6432,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of tag IDs (comma-separated, e.g. "id1,id2") — use /settings/tags to look up'
       },
       {
         name: "evidenceOptions",
@@ -6450,7 +6450,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Sharing options — control visibility to customer portal and field app"
       },
       {
         name: "raw-body",
@@ -6479,7 +6479,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "id",
@@ -6517,7 +6517,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "id",
@@ -6544,7 +6544,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Display name"
       },
       {
         name: "description",
@@ -6553,7 +6553,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Detailed description"
       },
       {
         name: "status",
@@ -6562,7 +6562,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Status filter",
         enumValues: ["open", "completed"]
       },
       {
@@ -6582,7 +6582,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "assignee ID"
       },
       {
         name: "dueDate",
@@ -6591,7 +6591,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Due date (ISO 8601 datetime)"
       },
       {
         name: "completedOn",
@@ -6609,7 +6609,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "completed by ID"
       },
       {
         name: "tagIds",
@@ -6618,7 +6618,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of tag IDs (comma-separated, e.g. "id1,id2") — use /settings/tags to look up'
       },
       {
         name: "sharing",
@@ -6627,7 +6627,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Sharing options — control visibility to customer portal and field app"
       },
       {
         name: "raw-body",
@@ -6656,7 +6656,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "id",
@@ -6694,7 +6694,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "id",
@@ -6721,7 +6721,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of signature attachment IDs (comma-separated in CLI, e.g. "id1,id2")'
       },
       {
         name: "beforePhotoAttachmentIds",
@@ -6730,7 +6730,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of before photo attachment IDs (comma-separated in CLI, e.g. "id1,id2")'
       },
       {
         name: "duringPhotoAttachmentIds",
@@ -6739,7 +6739,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of during photo attachment IDs (comma-separated in CLI, e.g. "id1,id2")'
       },
       {
         name: "afterPhotoAttachmentIds",
@@ -6748,7 +6748,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of after photo attachment IDs (comma-separated in CLI, e.g. "id1,id2")'
       },
       {
         name: "comment",
@@ -6775,7 +6775,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "form response ID"
       },
       {
         name: "fileAttachmentIds",
@@ -6784,7 +6784,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of file attachment IDs (comma-separated in CLI, e.g. "id1,id2")'
       },
       {
         name: "additionalFileAttachmentIds",
@@ -6793,7 +6793,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: 'Array of additional file attachment IDs (comma-separated in CLI, e.g. "id1,id2")'
       },
       {
         name: "complete",
@@ -6831,7 +6831,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       }
     ],
     hasRequestBody: false
@@ -6851,7 +6851,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       }
     ],
     hasRequestBody: false
@@ -6871,7 +6871,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -6900,7 +6900,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -7534,7 +7534,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Entity ID"
       }
     ],
     hasRequestBody: false
@@ -7554,7 +7554,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Entity ID"
       }
     ],
     hasRequestBody: false
@@ -7574,7 +7574,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Entity ID"
       }
     ],
     hasRequestBody: false
@@ -7594,7 +7594,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Entity ID"
       }
     ],
     hasRequestBody: false
@@ -7614,7 +7614,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Entity ID"
       }
     ],
     hasRequestBody: false
@@ -7634,7 +7634,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Entity ID"
       }
     ],
     hasRequestBody: false
@@ -7716,7 +7716,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "run ID"
       },
       {
         name: "eventId",
@@ -7782,7 +7782,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "run ID"
       },
       {
         name: "eventId",
@@ -7849,7 +7849,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Entity ID"
       },
       {
         name: "method",
@@ -8090,6 +8090,34 @@ function registerAuthCommands(program2) {
     console.log("Active profile set to " + options.profile);
   });
 }
+var GROUP_DESCRIPTIONS = {
+  jobs: "Manage jobs — create, update, search, and track work",
+  stages: "Manage stages (work orders) within jobs",
+  settings: "Read tenant configuration — job types, priorities, zones, tags, statuses",
+  attachments: "Upload and manage file attachments",
+  crm: "CRM — customers, employees, contractors, suppliers, contacts, sites",
+  webhooks: "Register and manage webhook subscriptions",
+  exports: "Bulk export entity data",
+  agents: "AI agent bridge — progress, actions, lifecycle callbacks",
+  mcp: "Model Context Protocol tools for AI agents",
+  activities: "Activity log — notes, emails, SMS, phone calls, integrations",
+  files: "Files attached to jobs or stages",
+  tasks: "Tasks and to-dos linked to jobs or stages",
+  contacts: "Contacts linked to jobs",
+  customers: "Customer records",
+  employees: "Employee records",
+  contractors: "Contractor records",
+  suppliers: "Supplier records",
+  companies: "Company records",
+  sites: "Site/location records",
+  invites: "User invitations",
+  email: "Email activities",
+  sms: "SMS activities",
+  note: "Note activities",
+  phone: "Phone call activities",
+  integration: "Integration activities",
+  resources: "Technicians and contractors assigned to stages"
+};
 function registerGeneratedCommands(program2) {
   const commandCache = new Map;
   commandCache.set("", program2);
@@ -8102,6 +8130,9 @@ function registerGeneratedCommands(program2) {
       let command = commandCache.get(key);
       if (!command) {
         command = parent.command(segment);
+        if (GROUP_DESCRIPTIONS[segment]) {
+          command.description(GROUP_DESCRIPTIONS[segment]);
+        }
         commandCache.set(key, command);
       }
       parent = command;
@@ -8110,7 +8141,19 @@ function registerGeneratedCommands(program2) {
     applyCommonOptions(parent);
     applyOperationOptions(parent, operation.options);
     parent.action(async (options) => {
-      const outputFormat = getOutputFormat(options.output);
+      if (options.describe) {
+        console.log(JSON.stringify(describeOperation(operation), null, 2));
+        return;
+      }
+      if (options.example) {
+        const example = generateExample(operation);
+        if (!example) {
+          console.log("This command has no request body.");
+        } else {
+          console.log(JSON.stringify(example, null, 2));
+        }
+        return;
+      }
       const config = resolveConfig({
         profile: options.profile,
         baseUrl: options.baseUrl,
@@ -8119,6 +8162,12 @@ function registerGeneratedCommands(program2) {
         accessToken: options.accessToken,
         apiVersion: options.apiVersion
       });
+      if (options.dryRun) {
+        const dryRun = buildDryRun(operation, options, config);
+        console.log(JSON.stringify(dryRun, null, 2));
+        return;
+      }
+      const outputFormat = getOutputFormat(options.output);
       validateRequiredOptions(operation, options);
       const response = await executeOperation(operation, options, config);
       printResponse(response, outputFormat, options.save);
@@ -8134,6 +8183,9 @@ function applyCommonOptions(command) {
   command.option("--api-version <version>", "WorkBuddy API version header override");
   command.option("--output <format>", "Output format: json, table, raw", "json");
   command.option("--save <file>", "Save the response body to a file");
+  command.option("--describe", "Print machine-readable JSON description of this command");
+  command.option("--example", "Print an example request body for this command");
+  command.option("--dry-run", "Print the request that would be sent without executing it");
 }
 function applyOperationOptions(command, options) {
   for (const option of options) {
@@ -8150,6 +8202,97 @@ function buildOptionDescription(option) {
   }
   return parts.join(" ");
 }
+function describeOperation(operation) {
+  return {
+    operationId: operation.operationId,
+    command: operation.commandPath.join(" "),
+    method: operation.method,
+    path: operation.path,
+    description: operation.description,
+    hasRequestBody: operation.hasRequestBody,
+    options: operation.options.filter((o) => o.name !== "raw-body").map((option) => ({
+      name: option.name,
+      flag: "--" + option.cliName,
+      source: option.source,
+      type: option.type,
+      required: option.required,
+      description: option.description,
+      ...option.enumValues?.length ? { enum: option.enumValues } : {},
+      ...option.format ? { format: option.format } : {}
+    }))
+  };
+}
+function generateExample(operation) {
+  const bodyOptions = operation.options.filter((o) => o.source === "body" && o.name !== "raw-body");
+  if (bodyOptions.length === 0) {
+    return null;
+  }
+  const example = {};
+  for (const option of bodyOptions) {
+    const key = option.bodyPath ?? option.name;
+    let value;
+    if (option.enumValues?.length) {
+      value = option.enumValues[0];
+    } else {
+      switch (option.type) {
+        case "integer":
+          value = 1;
+          break;
+        case "number":
+          value = 0;
+          break;
+        case "boolean":
+          value = false;
+          break;
+        case "array":
+          value = [];
+          break;
+        case "object":
+          value = {};
+          break;
+        default:
+          if (option.format === "date-time") {
+            value = "2026-01-01T00:00:00Z";
+          } else if (option.name.endsWith("Id") || option.name === "id") {
+            value = "<" + option.name + ">";
+          } else {
+            value = option.description || option.name;
+          }
+      }
+    }
+    setNestedValue(example, key, value);
+  }
+  return example;
+}
+function buildDryRun(operation, values, config) {
+  let requestPath = "/api/v2/public" + operation.path;
+  for (const option of operation.options.filter((o) => o.source === "path")) {
+    const rawValue = values[option.optionKey];
+    if (rawValue !== undefined && rawValue !== null && rawValue !== "") {
+      requestPath = requestPath.replace("{" + option.name + "}", encodeURIComponent(String(rawValue)));
+    }
+  }
+  const queryParams = {};
+  for (const option of operation.options.filter((o) => o.source === "query")) {
+    const rawValue = values[option.optionKey];
+    if (rawValue !== undefined && rawValue !== null && rawValue !== "") {
+      queryParams[option.name] = String(rawValue);
+    }
+  }
+  const body = buildRequestBody(operation, values);
+  const url = config.baseUrl ? config.baseUrl + requestPath : requestPath;
+  const queryString = Object.entries(queryParams).map(([k, v]) => k + "=" + encodeURIComponent(v)).join("&");
+  return {
+    method: operation.method,
+    url: queryString ? url + "?" + queryString : url,
+    headers: {
+      "Content-Type": "application/json",
+      "X-WorkBuddy-Version": config.apiVersion ?? "2026-01",
+      Authorization: "Bearer <token>"
+    },
+    ...body !== undefined ? { body } : {}
+  };
+}
 function validateRequiredOptions(operation, values) {
   const hasBody = typeof values.rawBody === "string" && values.rawBody.length > 0;
   const missing = operation.options.filter((option) => {