@workbuddy/cli-edge 1.0.4 → 1.0.6

package/dist/index.js

@@ -2542,7 +2542,12 @@ function buildHttpErrorMessage(status, contentType, buffer) {
   if (contentType.includes("application/json")) {
     try {
       const parsed = JSON.parse(text);
-      const detail = parsed.message ?? parsed.error ?? parsed.details;
+      const errorObj = parsed?.error;
+      if (errorObj && typeof errorObj === "object") {
+        const msg = errorObj.message ?? errorObj.code ?? JSON.stringify(errorObj);
+        return "Request failed with status " + status + ": " + msg;
+      }
+      const detail = parsed?.message ?? (typeof errorObj === "string" ? errorObj : null) ?? parsed?.details;
       return detail ? "Request failed with status " + status + ": " + detail : "Request failed with status " + status + ": " + text;
     } catch {
       return "Request failed with status " + status + ": " + text;
@@ -2704,7 +2709,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Search mode",
         enumValues: ["jobs", "stages"]
       },
       {
@@ -2714,7 +2719,7 @@ var operations = [
         source: "body",
         type: "integer",
         required: false,
-        description: ""
+        description: "Maximum number of results to return"
       },
       {
         name: "cursor",
@@ -2723,7 +2728,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Pagination cursor from a previous response"
       },
       {
         name: "sortBy",
@@ -2732,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"]
       },
       {
@@ -2742,7 +2747,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Sort direction: asc or desc",
         enumValues: ["asc", "desc"]
       },
       {
@@ -2752,7 +2757,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "Status filter"
       },
       {
         name: "customer",
@@ -2761,7 +2766,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "Inline customer object — alternative to customerId"
       },
       {
         name: "site",
@@ -2770,7 +2775,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "Inline site object — alternative to siteId"
       },
       {
         name: "type",
@@ -2878,7 +2883,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Free-text search query"
       },
       {
         name: "createdDate",
@@ -2887,7 +2892,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Date range filter for creation date"
       },
       {
         name: "dueDate",
@@ -2896,7 +2901,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Due date (ISO 8601 datetime)"
       },
       {
         name: "completedDate",
@@ -2905,7 +2910,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Completion date (ISO 8601 datetime)"
       },
       {
         name: "finalisedDate",
@@ -2914,7 +2919,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Finalisation date (ISO 8601 datetime)"
       },
       {
         name: "stageDueDate",
@@ -2923,7 +2928,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "stage due date (ISO 8601 datetime)"
       },
       {
         name: "stageCompletedDate",
@@ -2932,7 +2937,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "stage completed date (ISO 8601 datetime)"
       },
       {
         name: "fields",
@@ -2941,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",
@@ -2950,7 +2955,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "Related entities to include in the response"
       },
       {
         name: "raw-body",
@@ -3008,7 +3013,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Reason for the action (e.g. cancellation reason)"
       },
       {
         name: "raw-body",
@@ -3037,7 +3042,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Display name"
       },
       {
         name: "description",
@@ -3046,7 +3051,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Detailed description"
       },
       {
         name: "customerId",
@@ -3055,7 +3060,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Customer ID — use /crm/customers to look up"
       },
       {
         name: "customer",
@@ -3064,7 +3069,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Inline customer object — alternative to customerId"
       },
       {
         name: "siteId",
@@ -3073,7 +3078,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Site ID — use /crm/sites to look up"
       },
       {
         name: "site",
@@ -3082,7 +3087,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Inline site object — alternative to siteId"
       },
       {
         name: "contactId",
@@ -3091,7 +3096,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Contact ID — use /crm/contacts to look up"
       },
       {
         name: "contact",
@@ -3100,7 +3105,7 @@ var operations = [
         source: "body",
         type: "object",
         required: false,
-        description: ""
+        description: "Inline contact object — alternative to contactId"
       },
       {
         name: "typeId",
@@ -3109,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",
@@ -3118,7 +3123,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Priority ID — use /settings/priorities to look up"
       },
       {
         name: "priceBookId",
@@ -3127,7 +3132,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Price book ID for job pricing"
       },
       {
         name: "ownerId",
@@ -3136,7 +3141,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Owner (employee) ID — use /crm/employees to look up"
       },
       {
         name: "fieldSupervisorId",
@@ -3145,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",
@@ -3154,7 +3159,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Zone ID — use /settings/zones to look up"
       },
       {
         name: "tagIds",
@@ -3163,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",
@@ -3172,7 +3177,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Additional notes or comments"
       },
       {
         name: "reference",
@@ -3181,7 +3186,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "External reference number"
       },
       {
         name: "customerWO",
@@ -3190,7 +3195,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Customer work order reference"
       },
       {
         name: "customerPO",
@@ -3199,7 +3204,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Customer purchase order reference"
       },
       {
         name: "templateId",
@@ -3208,7 +3213,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Template ID to pre-populate fields from a template"
       },
       {
         name: "startDate",
@@ -3217,7 +3222,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Start date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -3227,7 +3232,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Due date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -3237,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",
@@ -3275,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"
       },
       {
@@ -3285,7 +3290,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Display name"
       },
       {
         name: "description",
@@ -3294,7 +3299,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Detailed description"
       },
       {
         name: "siteId",
@@ -3303,7 +3308,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Site ID — use /crm/sites to look up"
       },
       {
         name: "contactId",
@@ -3312,7 +3317,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Contact ID — use /crm/contacts to look up"
       },
       {
         name: "typeId",
@@ -3321,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",
@@ -3330,7 +3335,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Priority ID — use /settings/priorities to look up"
       },
       {
         name: "priceBookId",
@@ -3339,7 +3344,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Price book ID for job pricing"
       },
       {
         name: "ownerId",
@@ -3348,7 +3353,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Owner (employee) ID — use /crm/employees to look up"
       },
       {
         name: "fieldSupervisorId",
@@ -3357,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",
@@ -3366,7 +3371,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Zone ID — use /settings/zones to look up"
       },
       {
         name: "tagIds",
@@ -3375,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",
@@ -3384,7 +3389,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Additional notes or comments"
       },
       {
         name: "reference",
@@ -3393,7 +3398,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "External reference number"
       },
       {
         name: "customerWO",
@@ -3402,7 +3407,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Customer work order reference"
       },
       {
         name: "customerPO",
@@ -3411,7 +3416,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Customer purchase order reference"
       },
       {
         name: "startDate",
@@ -3420,7 +3425,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Start date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -3430,7 +3435,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Due date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -3440,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",
@@ -3641,7 +3646,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "name",
@@ -3650,7 +3655,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Display name"
       },
       {
         name: "workCategoryId",
@@ -3659,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",
@@ -3668,7 +3673,7 @@ var operations = [
         source: "body",
         type: "number",
         required: false,
-        description: ""
+        description: "Display order / sequence number"
       },
       {
         name: "startDate",
@@ -3677,7 +3682,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Start date (ISO 8601 datetime)"
       },
       {
         name: "dueDate",
@@ -3686,7 +3691,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Due date (ISO 8601 datetime)"
       },
       {
         name: "notes",
@@ -3695,7 +3700,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Additional notes or comments"
       },
       {
         name: "customFields",
@@ -3704,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",
@@ -3742,7 +3747,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Display name"
       },
       {
         name: "workCategoryId",
@@ -3751,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",
@@ -3760,7 +3765,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Start date (ISO 8601 datetime)"
       },
       {
         name: "dueDate",
@@ -3769,7 +3774,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Due date (ISO 8601 datetime)"
       },
       {
         name: "notes",
@@ -3778,7 +3783,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Additional notes or comments"
       },
       {
         name: "tagsSet",
@@ -3847,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",
@@ -3925,7 +3930,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Completion date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -3935,7 +3940,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Additional notes or comments"
       },
       {
         name: "raw-body",
@@ -3973,7 +3978,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Finalisation date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -4174,7 +4179,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "contactId",
@@ -4183,7 +4188,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Contact ID — use /crm/contacts to look up"
       },
       {
         name: "raw-body",
@@ -4353,7 +4358,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "status",
@@ -4362,7 +4367,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: "",
+        description: "Status filter",
         enumValues: ["enroute", "onsite", "checkedout", "completed", "onhold"]
       },
       {
@@ -4618,7 +4623,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       }
     ],
     hasRequestBody: false
@@ -4638,7 +4643,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -4667,7 +4672,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -4696,7 +4701,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "body",
@@ -4705,7 +4710,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "labelIds",
@@ -4714,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",
@@ -4723,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",
@@ -4732,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",
@@ -4761,7 +4766,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "templateId",
@@ -4770,7 +4775,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Template ID to pre-populate fields from a template"
       },
       {
         name: "subject",
@@ -4779,7 +4784,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Email subject line"
       },
       {
         name: "body",
@@ -4788,7 +4793,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "to",
@@ -4797,7 +4802,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "Recipients"
       },
       {
         name: "cc",
@@ -4806,7 +4811,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "CC recipients"
       },
       {
         name: "bcc",
@@ -4815,7 +4820,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "BCC recipients"
       },
       {
         name: "labelIds",
@@ -4824,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",
@@ -4833,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",
@@ -4842,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",
@@ -4871,7 +4876,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "templateId",
@@ -4880,7 +4885,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Template ID to pre-populate fields from a template"
       },
       {
         name: "body",
@@ -4889,7 +4894,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "to",
@@ -4898,7 +4903,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "Recipients"
       },
       {
         name: "labelIds",
@@ -4907,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",
@@ -4916,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",
@@ -4945,7 +4950,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "direction",
@@ -4991,7 +4996,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "call date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -5001,7 +5006,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "labelIds",
@@ -5010,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",
@@ -5019,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",
@@ -5048,7 +5053,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "body",
@@ -5057,7 +5062,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "integrationType",
@@ -5075,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",
@@ -5104,7 +5109,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -5133,7 +5138,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "id",
@@ -5171,7 +5176,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "id",
@@ -5209,7 +5214,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -5227,7 +5232,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "labelIds",
@@ -5236,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",
@@ -5245,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",
@@ -5254,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",
@@ -5283,7 +5288,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -5301,7 +5306,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Template ID to pre-populate fields from a template"
       },
       {
         name: "subject",
@@ -5310,7 +5315,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Email subject line"
       },
       {
         name: "body",
@@ -5319,7 +5324,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "to",
@@ -5328,7 +5333,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "Recipients"
       },
       {
         name: "cc",
@@ -5337,7 +5342,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "CC recipients"
       },
       {
         name: "bcc",
@@ -5346,7 +5351,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "BCC recipients"
       },
       {
         name: "labelIds",
@@ -5355,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",
@@ -5364,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",
@@ -5373,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",
@@ -5402,7 +5407,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -5420,7 +5425,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Template ID to pre-populate fields from a template"
       },
       {
         name: "body",
@@ -5429,7 +5434,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "to",
@@ -5438,7 +5443,7 @@ var operations = [
         source: "body",
         type: "array",
         required: false,
-        description: ""
+        description: "Recipients"
       },
       {
         name: "labelIds",
@@ -5447,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",
@@ -5456,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",
@@ -5485,7 +5490,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -5540,7 +5545,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "call date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -5550,7 +5555,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "labelIds",
@@ -5559,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",
@@ -5568,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",
@@ -5597,7 +5602,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -5615,7 +5620,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Message body content (HTML supported for email)"
       },
       {
         name: "integrationType",
@@ -5633,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",
@@ -5662,7 +5667,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       }
     ],
     hasRequestBody: false
@@ -5682,7 +5687,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       }
     ],
     hasRequestBody: false
@@ -5702,7 +5707,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -5731,7 +5736,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -5760,7 +5765,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -5789,7 +5794,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -5818,7 +5823,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "id",
@@ -5856,7 +5861,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "id",
@@ -5894,7 +5899,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       }
     ],
     hasRequestBody: false
@@ -5914,7 +5919,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "name",
@@ -5923,7 +5928,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Display name"
       },
       {
         name: "description",
@@ -5932,7 +5937,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Detailed description"
       },
       {
         name: "target",
@@ -5951,7 +5956,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "assignee ID"
       },
       {
         name: "dueDate",
@@ -5960,7 +5965,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Due date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -5970,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",
@@ -5988,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",
@@ -6017,7 +6022,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -6046,7 +6051,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -6064,7 +6069,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Display name"
       },
       {
         name: "description",
@@ -6073,7 +6078,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Detailed description"
       },
       {
         name: "status",
@@ -6082,7 +6087,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Status filter",
         enumValues: ["open", "completed"]
       },
       {
@@ -6102,7 +6107,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "assignee ID"
       },
       {
         name: "dueDate",
@@ -6111,7 +6116,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Due date (ISO 8601 datetime)"
       },
       {
         name: "completedOn",
@@ -6129,7 +6134,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "completed by ID"
       },
       {
         name: "tagIds",
@@ -6138,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",
@@ -6147,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",
@@ -6176,7 +6181,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -6205,7 +6210,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -6223,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",
@@ -6232,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",
@@ -6241,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",
@@ -6250,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",
@@ -6277,7 +6282,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "form response ID"
       },
       {
         name: "fileAttachmentIds",
@@ -6286,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",
@@ -6295,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",
@@ -6333,7 +6338,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -6342,7 +6347,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       }
     ],
     hasRequestBody: false
@@ -6362,7 +6367,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "jobId",
@@ -6371,7 +6376,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "name",
@@ -6380,7 +6385,7 @@ var operations = [
         source: "body",
         type: "string",
         required: true,
-        description: ""
+        description: "Display name"
       },
       {
         name: "description",
@@ -6389,7 +6394,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Detailed description"
       },
       {
         name: "target",
@@ -6408,7 +6413,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "assignee ID"
       },
       {
         name: "dueDate",
@@ -6417,7 +6422,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Due date (ISO 8601 datetime)",
         format: "date-time"
       },
       {
@@ -6427,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",
@@ -6445,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",
@@ -6474,7 +6479,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "id",
@@ -6512,7 +6517,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "id",
@@ -6539,7 +6544,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Display name"
       },
       {
         name: "description",
@@ -6548,7 +6553,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Detailed description"
       },
       {
         name: "status",
@@ -6557,7 +6562,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: "",
+        description: "Status filter",
         enumValues: ["open", "completed"]
       },
       {
@@ -6577,7 +6582,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "assignee ID"
       },
       {
         name: "dueDate",
@@ -6586,7 +6591,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Due date (ISO 8601 datetime)"
       },
       {
         name: "completedOn",
@@ -6604,7 +6609,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "completed by ID"
       },
       {
         name: "tagIds",
@@ -6613,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",
@@ -6622,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",
@@ -6651,7 +6656,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "id",
@@ -6689,7 +6694,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Stage ID or stage number"
       },
       {
         name: "id",
@@ -6716,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",
@@ -6725,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",
@@ -6734,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",
@@ -6743,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",
@@ -6770,7 +6775,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "form response ID"
       },
       {
         name: "fileAttachmentIds",
@@ -6779,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",
@@ -6788,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",
@@ -6826,7 +6831,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       }
     ],
     hasRequestBody: false
@@ -6846,7 +6851,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       }
     ],
     hasRequestBody: false
@@ -6866,7 +6871,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -6895,7 +6900,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Job ID or job number (e.g. J12345)"
       },
       {
         name: "id",
@@ -7529,7 +7534,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Entity ID"
       }
     ],
     hasRequestBody: false
@@ -7549,7 +7554,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Entity ID"
       }
     ],
     hasRequestBody: false
@@ -7569,7 +7574,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Entity ID"
       }
     ],
     hasRequestBody: false
@@ -7589,7 +7594,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Entity ID"
       }
     ],
     hasRequestBody: false
@@ -7609,7 +7614,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Entity ID"
       }
     ],
     hasRequestBody: false
@@ -7629,7 +7634,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "Entity ID"
       }
     ],
     hasRequestBody: false
@@ -7711,7 +7716,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "run ID"
       },
       {
         name: "eventId",
@@ -7777,7 +7782,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: ""
+        description: "run ID"
       },
       {
         name: "eventId",
@@ -7844,7 +7849,7 @@ var operations = [
         source: "body",
         type: "string",
         required: false,
-        description: ""
+        description: "Entity ID"
       },
       {
         name: "method",
@@ -8105,7 +8110,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,
@@ -8114,6 +8131,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);
@@ -8129,6 +8152,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) {
@@ -8145,6 +8171,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) => {