@workbuddy/cli-vnext 1.0.80 → 1.0.82

package/dist/index.js

@@ -4930,7 +4930,7 @@ var operations = [
         type: "string"
       },
       {
-        name: "technician",
+        name: "pricebook",
         type: "string"
       },
       {
@@ -5339,7 +5339,7 @@ var operations = [
         type: "string",
         required: false,
         description: "Status filter",
-        enumValues: ["Normal", "Variation", "Cancelled", "Requested", "Pending Review", "Declined", "Deleted"]
+        enumValues: ["Normal", "Variation", "Cancelled", "Deleted"]
       },
       {
         name: "invoicingStatus",
@@ -5506,24 +5506,791 @@ var operations = [
     commandPath: ["items", "list"],
     options: [
       {
-        name: "integrationId",
-        cliName: "integration-id",
-        optionKey: "integrationId",
-        source: "query",
-        type: "string",
-        required: true,
-        description: "External integration ID for the line item"
-      }
-    ],
-    hasRequestBody: false,
-    responseFields: [
+        name: "integrationId",
+        cliName: "integration-id",
+        optionKey: "integrationId",
+        source: "query",
+        type: "string",
+        required: true,
+        description: "External integration ID for the line item"
+      }
+    ],
+    hasRequestBody: false,
+    responseFields: [
+      {
+        name: "items",
+        type: "array"
+      },
+      {
+        name: "pagination",
+        type: "object"
+      }
+    ]
+  },
+  {
+    operationId: "PublicApiPendingItemController_list",
+    displayName: "Find a pending item",
+    description: "Find a pending stage item by its external integration ID.",
+    method: "GET",
+    path: "/pending-items",
+    commandPath: ["pending", "items", "list"],
+    options: [
+      {
+        name: "integrationId",
+        cliName: "integration-id",
+        optionKey: "integrationId",
+        source: "query",
+        type: "string",
+        required: true,
+        description: "External integration ID for the pending item"
+      }
+    ],
+    hasRequestBody: false,
+    responseFields: [
+      {
+        name: "items",
+        type: "array"
+      },
+      {
+        name: "pagination",
+        type: "object"
+      }
+    ]
+  },
+  {
+    operationId: "PublicJobStagePendingItemController_list",
+    displayName: "List stage pending items",
+    description: "List items awaiting approval for a stage.",
+    method: "GET",
+    path: "/jobs/{id}/stages/{stageId}/pending-items",
+    commandPath: ["stages", "pending", "items", "stages", "pending-items", "list"],
+    options: [
+      {
+        name: "id",
+        cliName: "id",
+        optionKey: "id",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Job ID"
+      },
+      {
+        name: "stageId",
+        cliName: "stage-id",
+        optionKey: "stageId",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Stage ID"
+      },
+      {
+        name: "cursor",
+        cliName: "cursor",
+        optionKey: "cursor",
+        source: "query",
+        type: "string",
+        required: false,
+        description: "Pending item ID after which to continue"
+      },
+      {
+        name: "limit",
+        cliName: "limit",
+        optionKey: "limit",
+        source: "query",
+        type: "number",
+        required: false,
+        description: "Maximum results (1-200)"
+      }
+    ],
+    hasRequestBody: false,
+    responseFields: [
+      {
+        name: "items",
+        type: "array"
+      },
+      {
+        name: "pagination",
+        type: "object"
+      }
+    ]
+  },
+  {
+    operationId: "PublicJobStagePendingItemController_create",
+    displayName: "Create stage pending items",
+    description: "Create one or more items awaiting approval.",
+    method: "POST",
+    path: "/jobs/{id}/stages/{stageId}/pending-items",
+    commandPath: ["stages", "pending", "items", "stages", "pending-items", "create"],
+    options: [
+      {
+        name: "id",
+        cliName: "id",
+        optionKey: "id",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Job ID"
+      },
+      {
+        name: "stageId",
+        cliName: "stage-id",
+        optionKey: "stageId",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Stage ID"
+      },
+      {
+        name: "items",
+        cliName: "items",
+        optionKey: "items",
+        source: "body",
+        type: "array",
+        required: true,
+        description: ""
+      },
+      {
+        name: "raw-body",
+        cliName: "raw-body",
+        optionKey: "rawBody",
+        source: "body",
+        type: "object",
+        required: false,
+        description: "Raw request body JSON (overrides individual fields)"
+      }
+    ],
+    hasRequestBody: true,
+    responseFields: [
+      {
+        name: "items",
+        type: "array"
+      }
+    ]
+  },
+  {
+    operationId: "PublicJobStagePendingItemController_get",
+    displayName: "Get stage pending item",
+    description: "Get a specific pending item within a stage.",
+    method: "GET",
+    path: "/jobs/{id}/stages/{stageId}/pending-items/{itemId}",
+    commandPath: ["stages", "pending", "items", "stages", "pending-items", "get"],
+    options: [
+      {
+        name: "id",
+        cliName: "id",
+        optionKey: "id",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Job ID"
+      },
+      {
+        name: "stageId",
+        cliName: "stage-id",
+        optionKey: "stageId",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Stage ID"
+      },
+      {
+        name: "itemId",
+        cliName: "item-id",
+        optionKey: "itemId",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Pending item ID"
+      }
+    ],
+    hasRequestBody: false,
+    responseFields: [
+      {
+        name: "id",
+        type: "string",
+        description: "Entity ID"
+      },
+      {
+        name: "jobId",
+        type: "string",
+        description: "Job ID or job number (e.g. J12345)"
+      },
+      {
+        name: "stageId",
+        type: "string",
+        description: "Stage ID or stage number"
+      },
+      {
+        name: "integrationId",
+        type: "string",
+        description: "integration ID"
+      },
+      {
+        name: "code",
+        type: "string"
+      },
+      {
+        name: "description",
+        type: "string",
+        description: "Detailed description"
+      },
+      {
+        name: "type",
+        type: "string"
+      },
+      {
+        name: "quantity",
+        type: "number"
+      },
+      {
+        name: "unit",
+        type: "string"
+      },
+      {
+        name: "location",
+        type: "string"
+      },
+      {
+        name: "note",
+        type: "string"
+      },
+      {
+        name: "itemStatus",
+        type: "object"
+      },
+      {
+        name: "buyPrice",
+        type: "number"
+      },
+      {
+        name: "sellPrice",
+        type: "number"
+      },
+      {
+        name: "invoicingStatus",
+        type: "string"
+      },
+      {
+        name: "suppliedBySubcontractor",
+        type: "boolean"
+      },
+      {
+        name: "createdAt",
+        type: "string"
+      },
+      {
+        name: "updatedAt",
+        type: "string",
+        description: "For optimistic concurrency — update fails if entity was modified after this timestamp"
+      }
+    ]
+  },
+  {
+    operationId: "PublicJobStagePendingItemController_update",
+    displayName: "Update stage pending item",
+    description: "Update general pending-item fields. Use the status route for itemStatus.",
+    method: "PATCH",
+    path: "/jobs/{id}/stages/{stageId}/pending-items/{itemId}",
+    commandPath: ["stages", "pending", "items", "stages", "pending-items", "update"],
+    options: [
+      {
+        name: "id",
+        cliName: "id",
+        optionKey: "id",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Job ID"
+      },
+      {
+        name: "stageId",
+        cliName: "stage-id",
+        optionKey: "stageId",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Stage ID"
+      },
+      {
+        name: "itemId",
+        cliName: "item-id",
+        optionKey: "itemId",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Pending item ID"
+      },
+      {
+        name: "updatedAt",
+        cliName: "updated-at",
+        optionKey: "updatedAt",
+        source: "body",
+        type: "string",
+        required: false,
+        description: "For optimistic concurrency — update fails if entity was modified after this timestamp",
+        format: "date-time"
+      },
+      {
+        name: "quantity",
+        cliName: "quantity",
+        optionKey: "quantity",
+        source: "body",
+        type: "number",
+        required: false,
+        description: ""
+      },
+      {
+        name: "unit",
+        cliName: "unit",
+        optionKey: "unit",
+        source: "body",
+        type: "string",
+        required: false,
+        description: ""
+      },
+      {
+        name: "location",
+        cliName: "location",
+        optionKey: "location",
+        source: "body",
+        type: "string",
+        required: false,
+        description: ""
+      },
+      {
+        name: "note",
+        cliName: "note",
+        optionKey: "note",
+        source: "body",
+        type: "string",
+        required: false,
+        description: ""
+      },
+      {
+        name: "buyPrice",
+        cliName: "buy-price",
+        optionKey: "buyPrice",
+        source: "body",
+        type: "number",
+        required: false,
+        description: ""
+      },
+      {
+        name: "sellPrice",
+        cliName: "sell-price",
+        optionKey: "sellPrice",
+        source: "body",
+        type: "number",
+        required: false,
+        description: ""
+      },
+      {
+        name: "invoicingStatus",
+        cliName: "invoicing-status",
+        optionKey: "invoicingStatus",
+        source: "body",
+        type: "string",
+        required: false,
+        description: "",
+        enumValues: ["Billable", "No Charge", "Not Billable"]
+      },
+      {
+        name: "suppliedBySubcontractor",
+        cliName: "supplied-by-subcontractor",
+        optionKey: "suppliedBySubcontractor",
+        source: "body",
+        type: "boolean",
+        required: false,
+        description: ""
+      },
+      {
+        name: "raw-body",
+        cliName: "raw-body",
+        optionKey: "rawBody",
+        source: "body",
+        type: "object",
+        required: false,
+        description: "Raw request body JSON (overrides individual fields)"
+      }
+    ],
+    hasRequestBody: true,
+    responseFields: [
+      {
+        name: "id",
+        type: "string",
+        description: "Entity ID"
+      },
+      {
+        name: "jobId",
+        type: "string",
+        description: "Job ID or job number (e.g. J12345)"
+      },
+      {
+        name: "stageId",
+        type: "string",
+        description: "Stage ID or stage number"
+      },
+      {
+        name: "integrationId",
+        type: "string",
+        description: "integration ID"
+      },
+      {
+        name: "code",
+        type: "string"
+      },
+      {
+        name: "description",
+        type: "string",
+        description: "Detailed description"
+      },
+      {
+        name: "type",
+        type: "string"
+      },
+      {
+        name: "quantity",
+        type: "number"
+      },
+      {
+        name: "unit",
+        type: "string"
+      },
+      {
+        name: "location",
+        type: "string"
+      },
+      {
+        name: "note",
+        type: "string"
+      },
+      {
+        name: "itemStatus",
+        type: "object"
+      },
+      {
+        name: "buyPrice",
+        type: "number"
+      },
+      {
+        name: "sellPrice",
+        type: "number"
+      },
+      {
+        name: "invoicingStatus",
+        type: "string"
+      },
+      {
+        name: "suppliedBySubcontractor",
+        type: "boolean"
+      },
+      {
+        name: "createdAt",
+        type: "string"
+      },
+      {
+        name: "updatedAt",
+        type: "string",
+        description: "For optimistic concurrency — update fails if entity was modified after this timestamp"
+      }
+    ]
+  },
+  {
+    operationId: "PublicJobStagePendingItemController_delete",
+    displayName: "Delete stage pending item",
+    description: "Delete or decline a pending item according to tenant deletion settings.",
+    method: "DELETE",
+    path: "/jobs/{id}/stages/{stageId}/pending-items/{itemId}",
+    commandPath: ["stages", "pending", "items", "stages", "pending-items", "delete"],
+    options: [
+      {
+        name: "id",
+        cliName: "id",
+        optionKey: "id",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Job ID"
+      },
+      {
+        name: "stageId",
+        cliName: "stage-id",
+        optionKey: "stageId",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Stage ID"
+      },
+      {
+        name: "itemId",
+        cliName: "item-id",
+        optionKey: "itemId",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Pending item ID"
+      }
+    ],
+    hasRequestBody: false,
+    responseFields: [
+      {
+        name: "deleted",
+        type: "boolean"
+      }
+    ]
+  },
+  {
+    operationId: "PublicJobStagePendingItemController_updateStatus",
+    displayName: "Update pending-item status",
+    description: "Set the dedicated pending-item status. No general item fields are accepted.",
+    method: "PATCH",
+    path: "/jobs/{id}/stages/{stageId}/pending-items/{itemId}/status",
+    commandPath: ["stages", "pending", "items", "stages", "pending-items", "status", "update-status"],
+    options: [
+      {
+        name: "id",
+        cliName: "id",
+        optionKey: "id",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Job ID"
+      },
+      {
+        name: "stageId",
+        cliName: "stage-id",
+        optionKey: "stageId",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Stage ID"
+      },
+      {
+        name: "itemId",
+        cliName: "item-id",
+        optionKey: "itemId",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Pending item ID"
+      },
+      {
+        name: "itemStatusId",
+        cliName: "item-status-id",
+        optionKey: "itemStatusId",
+        source: "body",
+        type: "string",
+        required: true,
+        description: "item status ID"
+      },
+      {
+        name: "raw-body",
+        cliName: "raw-body",
+        optionKey: "rawBody",
+        source: "body",
+        type: "object",
+        required: false,
+        description: "Raw request body JSON (overrides individual fields)"
+      }
+    ],
+    hasRequestBody: true,
+    responseFields: [
+      {
+        name: "id",
+        type: "string",
+        description: "Entity ID"
+      },
+      {
+        name: "jobId",
+        type: "string",
+        description: "Job ID or job number (e.g. J12345)"
+      },
+      {
+        name: "stageId",
+        type: "string",
+        description: "Stage ID or stage number"
+      },
+      {
+        name: "integrationId",
+        type: "string",
+        description: "integration ID"
+      },
+      {
+        name: "code",
+        type: "string"
+      },
+      {
+        name: "description",
+        type: "string",
+        description: "Detailed description"
+      },
+      {
+        name: "type",
+        type: "string"
+      },
+      {
+        name: "quantity",
+        type: "number"
+      },
+      {
+        name: "unit",
+        type: "string"
+      },
+      {
+        name: "location",
+        type: "string"
+      },
+      {
+        name: "note",
+        type: "string"
+      },
+      {
+        name: "itemStatus",
+        type: "object"
+      },
+      {
+        name: "buyPrice",
+        type: "number"
+      },
+      {
+        name: "sellPrice",
+        type: "number"
+      },
+      {
+        name: "invoicingStatus",
+        type: "string"
+      },
+      {
+        name: "suppliedBySubcontractor",
+        type: "boolean"
+      },
+      {
+        name: "createdAt",
+        type: "string"
+      },
+      {
+        name: "updatedAt",
+        type: "string",
+        description: "For optimistic concurrency — update fails if entity was modified after this timestamp"
+      }
+    ]
+  },
+  {
+    operationId: "PublicJobStagePendingItemController_approve",
+    displayName: "Approve stage pending item",
+    description: "Approve a pending item and promote it to a standard stage item.",
+    method: "POST",
+    path: "/jobs/{id}/stages/{stageId}/pending-items/{itemId}/approve",
+    commandPath: ["stages", "pending", "items", "stages", "pending-items", "approve"],
+    options: [
+      {
+        name: "id",
+        cliName: "id",
+        optionKey: "id",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Job ID"
+      },
+      {
+        name: "stageId",
+        cliName: "stage-id",
+        optionKey: "stageId",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Stage ID"
+      },
+      {
+        name: "itemId",
+        cliName: "item-id",
+        optionKey: "itemId",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Pending item ID"
+      }
+    ],
+    hasRequestBody: false,
+    responseFields: [
+      {
+        name: "id",
+        type: "string",
+        description: "Entity ID"
+      },
+      {
+        name: "jobId",
+        type: "string",
+        description: "Job ID or job number (e.g. J12345)"
+      },
+      {
+        name: "stageId",
+        type: "string",
+        description: "Stage ID or stage number"
+      },
+      {
+        name: "integrationId",
+        type: "string",
+        description: "integration ID"
+      },
+      {
+        name: "code",
+        type: "string"
+      },
+      {
+        name: "description",
+        type: "string",
+        description: "Detailed description"
+      },
+      {
+        name: "type",
+        type: "string"
+      },
+      {
+        name: "quantity",
+        type: "number"
+      },
+      {
+        name: "unit",
+        type: "string"
+      },
+      {
+        name: "location",
+        type: "string"
+      },
+      {
+        name: "note",
+        type: "string"
+      },
+      {
+        name: "status",
+        type: "string",
+        description: "Status filter"
+      },
+      {
+        name: "buyPrice",
+        type: "number"
+      },
+      {
+        name: "sellPrice",
+        type: "number"
+      },
+      {
+        name: "invoicingStatus",
+        type: "string"
+      },
+      {
+        name: "suppliedBySubcontractor",
+        type: "boolean"
+      },
       {
-        name: "items",
-        type: "array"
+        name: "createdAt",
+        type: "string"
       },
       {
-        name: "pagination",
-        type: "object"
+        name: "updatedAt",
+        type: "string",
+        description: "For optimistic concurrency — update fails if entity was modified after this timestamp"
       }
     ]
   },
@@ -5644,7 +6411,7 @@ var operations = [
         type: "string"
       },
       {
-        name: "technician",
+        name: "pricebook",
         type: "string"
       },
       {
@@ -5894,7 +6661,7 @@ var operations = [
         type: "string"
       },
       {
-        name: "technician",
+        name: "pricebook",
         type: "string"
       },
       {
@@ -6055,7 +6822,7 @@ var operations = [
         type: "string"
       },
       {
-        name: "technician",
+        name: "pricebook",
         type: "string"
       },
       {
@@ -6131,7 +6898,7 @@ var operations = [
   {
     operationId: "PublicJobStageController_complete",
     displayName: "Complete a stage",
-    description: "Mark a stage as completed. Field work is done but stage may still need finalisation/billing.",
+    description: "Mark a stage as completed. Field work is done but stage may still need finalisation/billing. Optional statusId selects a tenant Completed status from GET /settings/stage-statuses (systemStatus Completed); omit to use the system Completed status (MAI-2101).",
     method: "POST",
     path: "/stages/{id}/complete",
     commandPath: ["stages", "complete"],
@@ -6145,6 +6912,15 @@ var operations = [
         required: true,
         description: "Stage ID"
       },
+      {
+        name: "statusId",
+        cliName: "status-id",
+        optionKey: "statusId",
+        source: "body",
+        type: "string",
+        required: false,
+        description: "status ID"
+      },
       {
         name: "completedDate",
         cliName: "completed-date",
@@ -6218,7 +6994,169 @@ var operations = [
         type: "string"
       },
       {
-        name: "technician",
+        name: "pricebook",
+        type: "string"
+      },
+      {
+        name: "resources",
+        type: "string"
+      },
+      {
+        name: "startDate",
+        type: "string",
+        description: "Start date (ISO 8601 datetime)"
+      },
+      {
+        name: "dueDate",
+        type: "string",
+        description: "Due date (ISO 8601 datetime)"
+      },
+      {
+        name: "completedDate",
+        type: "string",
+        description: "Completion date (ISO 8601 datetime)"
+      },
+      {
+        name: "completedBy",
+        type: "string"
+      },
+      {
+        name: "completedNote",
+        type: "string"
+      },
+      {
+        name: "finalisedDate",
+        type: "string",
+        description: "Finalisation date (ISO 8601 datetime)"
+      },
+      {
+        name: "tags",
+        type: "string",
+        description: "Tag operation — use set, add, or remove (mutually exclusive: set vs add/remove)"
+      },
+      {
+        name: "systemTags",
+        type: "string"
+      },
+      {
+        name: "schedulingTags",
+        type: "string",
+        description: "Scheduling tag operation — use set, add, or remove"
+      },
+      {
+        name: "items",
+        type: "array"
+      },
+      {
+        name: "totals",
+        type: "object"
+      },
+      {
+        name: "customFields",
+        type: "string",
+        description: "Custom fields as key-value pairs — validated against tenant field definitions"
+      },
+      {
+        name: "createdAt",
+        type: "string"
+      },
+      {
+        name: "updatedAt",
+        type: "string",
+        description: "For optimistic concurrency — update fails if entity was modified after this timestamp"
+      }
+    ]
+  },
+  {
+    operationId: "PublicJobStageController_inProgress",
+    displayName: "Mark a stage in progress",
+    description: "Set the stage to an In Progress status. Pass statusId from GET /settings/stage-statuses with systemStatus In Progress (multiple peer statuses may share that systemStatus) (MAI-2101).",
+    method: "POST",
+    path: "/stages/{id}/in-progress",
+    commandPath: ["stages", "in-progress"],
+    options: [
+      {
+        name: "id",
+        cliName: "id",
+        optionKey: "id",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Stage ID"
+      },
+      {
+        name: "statusId",
+        cliName: "status-id",
+        optionKey: "statusId",
+        source: "body",
+        type: "string",
+        required: true,
+        description: "status ID"
+      },
+      {
+        name: "note",
+        cliName: "note",
+        optionKey: "note",
+        source: "body",
+        type: "string",
+        required: false,
+        description: ""
+      },
+      {
+        name: "raw-body",
+        cliName: "raw-body",
+        optionKey: "rawBody",
+        source: "body",
+        type: "object",
+        required: false,
+        description: "Raw request body JSON (overrides individual fields)"
+      }
+    ],
+    hasRequestBody: true,
+    responseFields: [
+      {
+        name: "id",
+        type: "string",
+        description: "Entity ID"
+      },
+      {
+        name: "stageNumber",
+        type: "string"
+      },
+      {
+        name: "jobId",
+        type: "string",
+        description: "Job ID or job number (e.g. J12345)"
+      },
+      {
+        name: "job",
+        type: "object"
+      },
+      {
+        name: "name",
+        type: "string",
+        description: "Display name"
+      },
+      {
+        name: "status",
+        type: "object",
+        description: "Status filter"
+      },
+      {
+        name: "sequence",
+        type: "string",
+        description: "Display order / sequence number"
+      },
+      {
+        name: "owner",
+        type: "string"
+      },
+      {
+        name: "contractor",
+        type: "string"
+      },
+      {
+        name: "pricebook",
         type: "string"
       },
       {
@@ -6381,7 +7319,7 @@ var operations = [
         type: "string"
       },
       {
-        name: "technician",
+        name: "pricebook",
         type: "string"
       },
       {
@@ -6534,7 +7472,7 @@ var operations = [
         type: "string"
       },
       {
-        name: "technician",
+        name: "pricebook",
         type: "string"
       },
       {
@@ -6696,7 +7634,7 @@ var operations = [
         type: "string"
       },
       {
-        name: "technician",
+        name: "pricebook",
         type: "string"
       },
       {
@@ -6859,7 +7797,7 @@ var operations = [
         type: "string"
       },
       {
-        name: "technician",
+        name: "pricebook",
         type: "string"
       },
       {
@@ -6961,7 +7899,7 @@ var operations = [
   {
     operationId: "PublicJobStageResourceController_list",
     displayName: "List stage resources",
-    description: "Get all assigned resources for a stage.",
+    description: "List people assigned to the stage via this API: employees (resource rows) and the stage contractor when set. Contractors assigned with POST .../resources appear here with isContractor=true (same shape as the assign response) (WBS-10448). Login contacts auto-created for contractor dispatch are excluded.",
     method: "GET",
     path: "/jobs/{jobId}/stages/{stageId}/resources",
     commandPath: ["stages", "resources", "list"],
@@ -7018,7 +7956,7 @@ var operations = [
   {
     operationId: "PublicJobStageResourceController_assign",
     displayName: "Assign resource to stage",
-    description: "Assign a technician or contractor.",
+    description: "Assign an Employee or Subcontractor by contactId. Employee → resource row. Subcontractor → stage contractor (isContractor=true). Both appear on GET list (WBS-10448). contactId is a person Contact id (use /employees for staff), not a CRM Contact from /contacts (WBS-10445 / WBS-10442).",
     method: "POST",
     path: "/jobs/{jobId}/stages/{stageId}/resources",
     commandPath: ["stages", "resources", "assign"],
@@ -7104,7 +8042,7 @@ var operations = [
   {
     operationId: "PublicJobStageResourceController_get",
     displayName: "Get stage resource",
-    description: "Get a specific resource assignment.",
+    description: "Get one assignment by id. Employee rows use the resource/contact id; the stage contractor uses the contractor contact id (same id as POST assign when isContractor=true) (WBS-10448).",
     method: "GET",
     path: "/jobs/{jobId}/stages/{stageId}/resources/{resourceId}",
     commandPath: ["stages", "resources", "get"],
@@ -7134,7 +8072,7 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: "Resource ID"
+        description: "Resource or contractor contact ID"
       }
     ],
     hasRequestBody: false,
@@ -7322,7 +8260,7 @@ var operations = [
   {
     operationId: "PublicApiEntityStatusController_list",
     displayName: "List entity statuses",
-    description: "Retrieve all active statuses for a given entity type. Supported entities: customer, contractor, supplier, contact, external-user",
+    description: "Retrieve all active statuses for a given entity type. Supported entities: customer, contractor, supplier, contact, external-user, pending-item",
     method: "GET",
     path: "/settings/entity-statuses/{entity}",
     commandPath: ["settings", "reference", "data", "entity-statuses", "get"],
@@ -7334,8 +8272,8 @@ var operations = [
         source: "path",
         type: "string",
         required: true,
-        description: "Entity type (customer, contractor, supplier, contact, external-user)",
-        enumValues: ["customer", "contractor", "supplier", "contact", "external-user"]
+        description: "Entity type (customer, contractor, supplier, contact, external-user, pending-item)",
+        enumValues: ["customer", "contractor", "supplier", "contact", "external-user", "pending-item"]
       }
     ],
     hasRequestBody: false,
@@ -7413,7 +8351,7 @@ var operations = [
   {
     operationId: "PublicApiPriceBookController_list",
     displayName: "List pricebooks",
-    description: "Discover tenant pricebooks for a category (customer / contractor / supplier). Use category=customer&status=current&assignableOnly=true for job-create candidates. Optional accountId scopes to a CRM account (includeGlobal defaults true).",
+    description: "Discover tenant pricebooks for a category (customer / contractor / supplier). Use category=customer&status=current&assignableOnly=true for job-create candidates. Optional accountId scopes to a CRM account (includeGlobal defaults true). Each item includes company (owning company) and optional account — both match Settings UI fields.",
     method: "GET",
     path: "/settings/pricebooks",
     commandPath: ["settings", "reference", "data", "pricebooks", "list"],
@@ -7505,7 +8443,7 @@ var operations = [
   {
     operationId: "PublicApiPriceBookController_getByIdOrName",
     displayName: "Get pricebook",
-    description: "Retrieve a pricebook by id (preferred) or exact name (case-insensitive). Pass category when the name may exist in more than one category.",
+    description: "Retrieve a pricebook by id (preferred) or exact name (case-insensitive). Pass category when the name may exist in more than one category. Response includes company (owning company) and optional account, matching Settings UI.",
     method: "GET",
     path: "/settings/pricebooks/{idOrName}",
     commandPath: ["settings", "reference", "data", "pricebooks", "get"],
@@ -7573,6 +8511,10 @@ var operations = [
         name: "account",
         type: "string"
       },
+      {
+        name: "company",
+        type: "string"
+      },
       {
         name: "dateStart",
         type: "string"
@@ -7586,7 +8528,21 @@ var operations = [
   {
     operationId: "PublicApiStageStatusController_list",
     displayName: "List stage statuses",
-    description: "Retrieve all stage statuses configured for the tenant. Stage statuses represent the workflow states a stage (work order) can transition through (e.g., New, Dispatched, En Route, On Site, Completed, Finalised).",
+    description: `Retrieve all stage statuses configured for the tenant (Settings > Stage Status).
+Each item is a workflow state a stage (work order) can use (e.g. New, Dispatched, En Route, On Site, Completed, Finalised).
+
+Response fields include:
+- identity: id, name, systemName, systemStatus, sortOrder
+- description (nullable)
+- activityOptions: shareWithCustomer, shareWithField (always present; unset = false)
+- displayOptions: showInContractorPortal, showInFieldApp (always present)
+
+Display Options rules (match Settings UI):
+- Only systemStatus On Hold or In Progress support display options; other systemStatus values return both flags as false
+- showInFieldApp is not configurable for In Progress and is always false
+- When supported and not configured, visibility defaults to true (Settings UI default)
+
+Requires scope: settings:read`,
     method: "GET",
     path: "/settings/stage-statuses",
     commandPath: ["settings", "reference", "data", "stage-statuses", "list"],
@@ -13479,7 +14435,7 @@ var operations = [
   {
     operationId: "PublicCrmExternalUserController_getById",
     displayName: "Get external user by ID",
-    description: "Get external user by ID",
+    description: "Login Contact (portal user). parents lists active parent accounts only; portal role is parents[].role.",
     method: "GET",
     path: "/external-users/{id}",
     commandPath: ["crm", "external", "users", "get"],
@@ -13544,7 +14500,7 @@ var operations = [
   {
     operationId: "PublicCrmContactController_getById",
     displayName: "Get contact by ID",
-    description: "Get contact by ID",
+    description: "Returns a people contact (basic or Login Contact). parents lists active parent accounts only (inactive/soft-deleted omitted); portal role for Login Contacts is parents[].role.",
     method: "GET",
     path: "/contacts/{id}",
     commandPath: ["crm", "contacts", "get"],
@@ -13814,11 +14770,20 @@ var operations = [
   {
     operationId: "PublicCrmSiteController_list",
     displayName: "List all sites",
-    description: "List all sites",
+    description: "List CRM sites for the tenant (Managed and Account only — Adhoc sites are excluded). Each item includes type (Managed | Account), optional primaryContact, and address. Optional search filters by site name/address tokens (space-separated words; all must match).",
     method: "GET",
     path: "/sites",
     commandPath: ["crm", "sites", "list"],
     options: [
+      {
+        name: "search",
+        cliName: "search",
+        optionKey: "search",
+        source: "query",
+        type: "string",
+        required: false,
+        description: "Search by name/address (space-separated words; all must match as token prefixes)"
+      },
       {
         name: "status",
         cliName: "status",
@@ -13862,7 +14827,7 @@ var operations = [
   {
     operationId: "PublicCrmSiteController_getById",
     displayName: "Get site by ID",
-    description: "Get site by ID",
+    description: "Retrieve a CRM site by id (Managed or Account only). Adhoc sites are not exposed. Includes primaryContact when set (UI Primary Contact). type is CRM Site Type — not address.type.",
     method: "GET",
     path: "/sites/{id}",
     commandPath: ["crm", "sites", "get"],
@@ -13885,6 +14850,54 @@ var operations = [
       }
     ]
   },
+  {
+    operationId: "PublicCrmSiteController_listContacts",
+    displayName: "List contacts for site",
+    description: "List contacts linked to this site (same pattern as GET /customers/{id}/contacts). Returns basic contacts and external users parented to the site.",
+    method: "GET",
+    path: "/sites/{id}/contacts",
+    commandPath: ["crm", "sites", "contacts", "list"],
+    options: [
+      {
+        name: "id",
+        cliName: "id",
+        optionKey: "id",
+        source: "path",
+        type: "string",
+        required: true,
+        description: "Site ID"
+      },
+      {
+        name: "cursor",
+        cliName: "cursor",
+        optionKey: "cursor",
+        source: "query",
+        type: "string",
+        required: false,
+        description: ""
+      },
+      {
+        name: "limit",
+        cliName: "limit",
+        optionKey: "limit",
+        source: "query",
+        type: "number",
+        required: false,
+        description: ""
+      }
+    ],
+    hasRequestBody: false,
+    responseFields: [
+      {
+        name: "items",
+        type: "array"
+      },
+      {
+        name: "pagination",
+        type: "object"
+      }
+    ]
+  },
   {
     operationId: "PublicApiWebhookV2Controller_listEntities",
     displayName: "List webhook-supported entity types and their available events",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workbuddy/cli-vnext",
-  "version": "1.0.80",
+  "version": "1.0.82",
   "description": "WorkBuddy command line interface",
   "license": "MIT",
   "type": "module",