@go-labs-sg/bb 1.17.0 → 1.19.0

package/dist/index.js

@@ -2,9 +2,9 @@
 import "./load-env.js";
 import { requireApiKey } from "./api-client.js";
 import { consumeCliQuietFlags, logCliAction, sanitizeFlagsForTrace, setCliQuiet, shouldLogCliActions, } from "./cli-trace.js";
-import { addBudgetItems, approveBill, approveBudget, approveQuotation, approveSupplier, createApiKeyForUser, createBillApproval, createBillFromPayload, createBudgetApproval, createBudgetCategory, createBudgetFromPayload, createCompany, createContactPersonFromPayload, createEstimate, createItemCategory, createItemFromPayload, createProject, createQuotationFromPayload, createSupplierCertification, createSupplierFromPayload, createSupplierPaymentMethod, createSupplierRoleOption, createSupplierTagOption, createUser, deleteBillById, deleteBudgetById, deleteBudgetCategory, deleteCompanyById, deleteItemById, deleteItemCategoriesByIds, deleteProjectById, deleteSuppliersByIds, downloadQuotationPdf, getApprovedBudgets, getBillAttachments, getBillDetails, getBudget, getBudgetCategories, getBudgetCategoryBenchmarks, getBudgetDetails, getBudgetItemsOnly, getBudgetVersions, getCompany, getDashboard, getErrorMetrics, getEstimatePerformance, getFinancialOverview, getItem, getItemPricingHistory, getMonthlyMetrics, getProject, getQuotationDetails, getRecentErrors, getSupplierAnalytics, getSupplierDetails, getSupplierPricingHistory, getSystemOverview, getUserPerformance, listApiKeysForUser, listApprovals, listBills, listBudgets, listCompanies, listContacts, listItemCategories, listItems, listProjects, listQuotations, listSuppliers, listUsers, markBudgetWonWithProof, patchBillInvoiceNumber, patchBillPayment, reactivateSuppliersByIds, rejectBill, rejectBudget, rejectQuotation, rejectSupplier, removeBudgetItem, reorderBudgetItemsCli, revokeApiKeyForUser, submitQuotation, updateBillFromPayload, updateBillStatus, updateBudgetCategory, updateBudgetCommissionFromPayload, updateBudgetDiscountFromPayload, updateBudgetFromPayload, updateBudgetItem, updateBudgetItemSupplierCli, updateBudgetStatus, updateCompanyFromPayload, updateContactPersonFromPayload, updateItemCategory, updateItemFromPayload, updateProjectFromPayload, updateProjectStatus, updateSupplierFromPayload, uploadBillAttachmentFromPath, uploadBillAttachmentsFromPaths, uploadBillDocumentsFromPaths, uploadBudgetAttachmentFromPath, uploadQuotationAttachmentFromPath, } from "./commands.js";
+import { addBudgetItems, approveBill, approveBudget, approveCustomerInvoice, approveQuotation, approveSupplier, checkCustomerInvoiceReadiness, checkProjectReconciliation, cleanupStagedBillAttachments, cleanupStagedQuotationAttachments, completeProject, createApiKeyForUser, createBillApproval, createBillFromPayload, createBudgetApproval, createBudgetCategory, createBudgetFromPayload, createCompany, createContactPersonFromPayload, createCustomerInvoice, createEstimate, createItemCategory, createItemFromPayload, createPlaceholderBillForBudgetItem, createProject, createQuotationFromPayload, createSupplierCertification, createSupplierFromPayload, createSupplierPaymentMethod, createSupplierRoleOption, createSupplierTagOption, createUser, deleteBillById, deleteBudgetById, deleteBudgetCategory, deleteBudgetCommission, deleteBudgetDiscount, deleteCompanyById, deleteCustomerInvoice, deleteItemById, deleteItemCategoriesByIds, deleteProjectById, deleteQuotationById, deleteSuppliersByIds, discardCreatingCustomerInvoice, downloadCustomerInvoicePdf, downloadQuotationPdf, getApprovedBudgets, getBillAttachments, getBillDetails, getBudget, getBudgetCategories, getBudgetCategoryBenchmarks, getBudgetDetails, getBudgetItemsOnly, getBudgetVersions, getCompany, getCustomerInvoice, getDashboard, getErrorMetrics, getEstimatePerformance, getFinancialOverview, getItem, getItemPricingHistory, getMonthlyMetrics, getProject, getQuotationDetails, getRecentErrors, getSupplierAnalytics, getSupplierDetails, getSupplierPricingHistory, getSystemOverview, getUserPerformance, importQuickBooksProjectId, listApiKeysForUser, listApprovals, listBills, listBudgets, listCompanies, listContacts, listCustomerInvoices, listIntegrationOperations, listItemCategories, listItems, listProjects, listQuotations, listSuppliers, listUsers, markBudgetWonWithProof, patchBillInvoiceNumber, patchBillPayment, reactivateSuppliersByIds, reconcileProject, rejectBill, rejectBudget, rejectCustomerInvoice, rejectQuotation, rejectSupplier, removeBudgetItem, renameBudgetVersion, reorderBudgetItemsCli, restoreBudgetVersion, retryIntegrationOperation, revokeApiKeyForUser, setBudgetItemsNotUtilized, stageBillAttachmentsFromPaths, submitQuotation, syncCustomerInvoice, updateBillFromPayload, updateBillPaymentEvidenceFromPayload, updateBillStatus, updateBudgetCategory, updateBudgetCommissionFromPayload, updateBudgetDiscountFromPayload, updateBudgetFromPayload, updateBudgetItem, updateBudgetItemSupplierCli, updateBudgetStatus, updateCompanyFromPayload, updateContactPersonFromPayload, updateItemCategory, updateItemFromPayload, updateProjectFromPayload, updateProjectStatus, updateQuotationFromPayload, updateSupplierFromPayload, uploadBillAttachmentFromPath, uploadBillAttachmentsFromPaths, uploadBillDocumentsFromPaths, uploadBudgetAttachmentFromPath, uploadQuotationAttachmentFromPath, validateBillSelectionFromPayload, voidCustomerInvoice, } from "./commands.js";
 import { getFlag, parseArgs } from "./parse-args.js";
-import { billStatusesForUpdateHelp, budgetStatusesForHelp, isBudgetStatusUpdate, parseApprovalTypeFlag, parseBillStatusForUpdate, parseCommaSeparatedBillStatuses, parseCommaSeparatedBudgetStatuses, parseCommaSeparatedIds, parseCommaSeparatedSupplierStatuses, parseOptionalBillListSortBy, parseOptionalBillListSortDir, parseOptionalDashboardRole, parseOptionalDeals, parseOptionalErrorSeverity, parseOptionalErrorStatus, parseOptionalExtendedProjectStatus, parseOptionalFinancialRole, parseOptionalSupplierAnalyticsTimeFrame, parseOptionalTimeFrame, parseProjectStatusForUpdate, parseUserRole, projectStatusesForHelp, userRolesForHelp, } from "./parse-cli-enums.js";
+import { billStatusesForUpdateHelp, budgetStatusesForHelp, isBudgetStatusUpdate, parseApprovalTypeFlag, parseBillStatusForUpdate, parseCommaSeparatedBillStatuses, parseCommaSeparatedBudgetStatuses, parseCommaSeparatedCustomerInvoiceStatuses, parseCommaSeparatedIds, parseCommaSeparatedQuotationStatuses, parseCommaSeparatedSupplierStatuses, parseOptionalBillListSortBy, parseOptionalBillListSortDir, parseOptionalDashboardRole, parseOptionalDeals, parseOptionalErrorSeverity, parseOptionalErrorStatus, parseOptionalExtendedProjectStatus, parseOptionalFinancialRole, parseOptionalSupplierAnalyticsTimeFrame, parseOptionalTimeFrame, parseProjectStatusForUpdate, parseUserRole, projectStatusesForHelp, userRolesForHelp, } from "./parse-cli-enums.js";
 import { parseJsonFlag, parseOptionalNumber as parseOptNum, } from "./parse-json-flag.js";
 function parsePositiveIntFlag(value, flagName) {
     if (value === undefined)
@@ -26,6 +26,35 @@ function parseOptionalBoolFlag(flags, key) {
         return false;
     throw new Error(`--${key} must be true or false.`);
 }
+const CUSTOMER_INVOICE_SORT_FIELDS = [
+    "createdAt",
+    "status",
+    "totalNetAmount",
+    "approvalExpiresAt",
+];
+function parseCustomerInvoiceSortBy(value) {
+    if (value === undefined)
+        return "createdAt";
+    if (!CUSTOMER_INVOICE_SORT_FIELDS.includes(value)) {
+        throw new Error(`Invalid --sortBy "${value}". Use one of: ${CUSTOMER_INVOICE_SORT_FIELDS.join(", ")}.`);
+    }
+    return value;
+}
+const INTEGRATION_OPERATION_STATUSES = [
+    "PENDING",
+    "PROCESSING",
+    "FAILED",
+    "COMPLETED",
+];
+function parseIntegrationOperationStatus(value) {
+    if (value === undefined)
+        return undefined;
+    const normalized = value.toUpperCase();
+    if (!INTEGRATION_OPERATION_STATUSES.includes(normalized)) {
+        throw new Error(`Invalid --status "${value}". Use one of: ${INTEGRATION_OPERATION_STATUSES.join(", ")}.`);
+    }
+    return normalized;
+}
 function parseCommercialRejectionProjectStatus(flags) {
     const raw = flags.projectStatusOnCommercialRejection;
     if (raw === undefined)
@@ -120,8 +149,9 @@ Global: --quiet | -q | BB_CLI_QUIET=1 — hide action logs (default: log command
 Auth: Set BB_API_KEY in the environment (same API key as MCP / Goracle).
 
 Sensitive workflow changes: approval decisions/requests, entity status updates,
-mark-budget-won, submit-quotation, and supplier approval request side effects
-require an interactive CONFIRM prompt and abort in non-interactive shells.
+customer invoices, integration retries, mark-budget-won, submit-quotation, and
+supplier approval request side effects require an interactive CONFIRM prompt
+and abort in non-interactive shells.
 AI agents must inspect the entity first, summarize the exact entity, target
 state, and side effects, then wait for explicit user confirmation before running
 the sensitive command.
@@ -133,6 +163,8 @@ Budgets
   get-budget-details <id>    Full detail (margins, suppliers, etc.)
   get-budget-categories
   get-budget-versions <budgetId>
+  rename-budget-version <versionId> --name <text>
+  restore-budget-version <versionId>   Replace current budget data and return it to DRAFT.
   update-budget-status <id> <status> [--projectManagerId <id>] [--markProjectWon true|false] [--projectStatusOnCommercialRejection PITCH|LOST]
     Budget-changing commands require interactive "yes" confirmation when the current budget is ESTIMATE_CREATED, ESTIMATE_SENT, ESTIMATE_ACCEPTED, ESTIMATE_REJECTED, or ESTIMATE_CLOSED.
     ESTIMATE_ACCEPTED requires win proof, auto-marks PITCH or LOST projects WON, requires --projectManagerId when the project has no PM, and auto-creates the Asana project/section when enabled.
@@ -145,7 +177,7 @@ Budgets
   create-budget-approval <budgetId>   (also sends approval request emails)
   create-estimate <budgetId>          (creates QuickBooks estimate; supports preflight updates)
   add-budget-items           --budgetId --items '[{"itemId":"…","quantity":1,"markup":30},…]'
-  update-budget-item         --id <budgetItemId> [--description plain-text] [--note plain-text] [--quantity] [--markup] [--cost] [--unitPrice] [--isFreeOfCharge true|false] [--gstInclusive true|false]
+  update-budget-item         --id <budgetItemId> [--description plain-text] [--note plain-text] [--quantity] [--markup] [--cost] [--unitPrice] [--isFreeOfCharge true|false] [--gstInclusive true|false] [--gstOutOfScope true|false]
   remove-budget-item <budgetItemId>
   reorder-budget-items       <budgetId> --itemIds <csv>
   update-budget-item-supplier --budgetItemId --supplierId
@@ -154,6 +186,11 @@ Budgets
   delete-budget-category <id>
   update-budget-commission   --payload '<json>'  (budget.updateBudgetCommission)
   update-budget-discount     --payload '<json>'  (budget.updateBudgetDiscount; type percentage|amount)
+  delete-budget-commission <budgetId>   Remove commission and return the budget to DRAFT.
+  delete-budget-discount <budgetId>     Remove discount and return the budget to DRAFT.
+  mark-budget-items-not-utilized --ids <csv>   Remove unused lines from reconciliation and clear QBO placeholders.
+  restore-budget-item <budgetItemId>           Restore one Not Utilized line and its QBO placeholder when required.
+  create-placeholder-bill <budgetItemId>       Admin-only placeholder recovery.
   upload-budget-attachment <budgetId> <filePath>   Presigned S3 upload + confirm
 
 Bills
@@ -162,11 +199,16 @@ Bills
     isClaimable differentiates the shared bill/claim records: false = bill, true = claim.
     New supplier bills from 1 Jul 2026 00:00 SGT require approved quotation coverage for each non-legacy line item.
   create-bill-approval <billId>       (also sends approval request emails)
-  create-bill                --payload '<json>'  (bill.create; payload.isClaimable false = bill, true = claim; use upload-bill-attachment after create to add files)
+  create-bill                --payload '<json>'  (bill.create; payload.isClaimable false = bill, true = claim)
+  validate-bill-selection    --payload '<json>'  Check projectId, supplierId, budgetItemIds, and optional alreadyPaid before creation.
+  stage-bill-attachment <projectId> <filePath...> [--file <path>] [--files <csv>]   Upload files before create-bill; returns attachment JSON for attachments/paymentProofAttachments
+  cleanup-staged-bill-attachments <projectId> --keys <csv>   Delete unattached staged bill/claim uploads.
   update-bill                --payload '<json>'  (bill.update; must include id)
+  update-bill-payment-evidence --payload '<json>'  Replace paymentReference/paymentProofAttachments for an already-paid bill.
   delete-bill <billId>
   update-bill-status <id> <status> [--rejectionReason] [--paymentTrackingUrl] [--paymentReference]
     status (${billStatusesForUpdateHelp.join(", ")}) — not PENDING_APPROVAL; use create-bill-approval
+    Moving a bill or claim to PAID sends creator and supplier emails, CC m@getout.sg and BCC noah@getout.sg; duplicate claim recipients receive one email.
   patch-bill-payment <billId> [--paymentTrackingUrl] [--paymentReference] [--quickbooksBillId] [--paymentDate <ISO>]
     Clear a field: --clearPaymentTrackingUrl true | --clearPaymentReference true | --clearQuickbooksBillId true | --clearPaymentDate true
   patch-bill-invoice-number <billId> <invoiceNumber>
@@ -177,17 +219,33 @@ Bills
   get-bill-details <billId>
 
 Quotations
-  list-quotations            [--projectId] [--budgetId] [--supplierId] [--status CSV] [--page] [--pageSize]
+  list-quotations            [--projectId] [--budgetId] [--supplierId] [--status CSV] [--requesterIds CSV] [--search] [--page] [--pageSize]
   get-quotation <quotationId>
-  upload-quotation-attachment <projectId> <filePath>   Presigned S3 upload; returns attachment JSON for create-quotation payload
-  create-quotation           --payload '<json>'  (quotation.createDraft)
+  upload-quotation-attachment <projectId> <filePath>   Upload one PDF, JPEG, or PNG up to 20MB; returns attachment JSON for a quotation payload.
+  cleanup-staged-quotation-attachments <projectId> --keys <csv>   Delete unattached staged quotation uploads.
+  create-quotation           --payload '<json>'  (quotation.createDraft; requires amountWithoutGst and gstAmount)
+  update-quotation           --payload '<json>'  Update a DRAFT or REJECTED quotation; same payload plus id.
+  delete-quotation <quotationId>
   submit-quotation <quotationId>
   approve-quotation <quotationId>
   reject-quotation <quotationId> --reason <text>
   download-quotation-pdf <quotationId> [original|staff|final]
 
+Customer invoices
+  check-customer-invoice-readiness <budgetId>
+  list-customer-invoices <budgetId> [--status CSV] [--search] [--sortBy createdAt|status|totalNetAmount|approvalExpiresAt] [--sortDir asc|desc] [--page] [--perPage]
+  get-customer-invoice <batchId>
+  create-customer-invoice --payload '<json>'   budgetId + one split with label, percentage, and dueDate.
+  discard-customer-invoice <batchId>           Discard a reserved CREATING batch with no created QBO invoices.
+  delete-customer-invoice <batchId>            Delete QBO invoices and the local batch.
+  void-customer-invoice <batchId>              Void the invoice batch in QuickBooks.
+  approve-customer-invoice <batchId>           Admin approval; notifies the creator.
+  reject-customer-invoice <batchId> --reason <text>   Admin rejection; voids QBO invoices and notifies the creator.
+  download-customer-invoice-pdf <invoiceId> [--output <path>]
+  sync-customer-invoice <invoiceId>             Refresh local status and balance from QuickBooks.
+
 Approvals
-  list-approvals | get-pending-approvals   [--type budget|supplier|bill|quotation|all]
+  list-approvals | get-pending-approvals   [--type budget|supplier|bill|quotation|customer_invoice|all]
   approve-bill <billId>               (also sends requester reply email)
   reject-bill <billId> --reason <text> (also sends requester reply email)
   approve-budget <budgetId>           (also sends requester reply email)
@@ -205,11 +263,16 @@ Companies & projects
   list-projects              [--companyId] [--name] [--status] [--active true|false] [--page] [--perPage]
     Omit --active to include both active and inactive projects.
   get-project <id>
-  create-project             --name --companyId --contactPersonId --insideSalesId --businessDevelopmentId --venue --startDate <ISO> [--asanaTaskId] [--asanaSearch <text>] [--slackChannelId --slackChannelUrl --slackChannelName] [--pax] [--endDate <ISO>] [--description]
-  update-project             --payload '<json>'  (project.updateProject; optional requestQboAccountantNotification; default notify like web)
+    Budget overview totalRevenue includes Estimate Accepted and Estimate Closed budgets only.
+  create-project             --name --companyId --contactPersonId --insideSalesId --businessDevelopmentId --venue --startDate <ISO> [--projectManagerId <userId>] [--asanaTaskId] [--asanaSearch <text>] [--slackChannelId --slackChannelUrl --slackChannelName] [--pax] [--endDate <ISO>] [--description]
+  update-project             --payload '<json>'  (project.updateProject; optional projectManagerId and requestQboAccountantNotification; default notify like web)
   delete-project <id>
-  update-project-status <id> <status> [--projectManagerId <id>] [--projectManagerName <name>] [--wonOverrideReason <text>]
-    Required when moving PITCH → WON: supply --projectManagerId or --projectManagerName.
+  check-project-reconciliation <id>   Run the same live reconciliation review as the web app without changing status.
+  reconcile-project <id>              Rerun all checks transactionally and mark an eligible WON project RECONCILED.
+  complete-project <id>               Rerun reconciliation validation, mark a RECONCILED project COMPLETED, and queue QBO placeholder cleanup.
+  import-qbo-project <projectId> --url <quickBooksProjectUrl>
+  update-project-status <id> <status> [--projectManagerId <userId>] [--projectManagerEmail <email>] [--wonOverrideReason <text>]
+    Required when moving PITCH → WON: supply --projectManagerId or --projectManagerEmail.
     Required when moving to WON without accepted/closed budget or win proof: --wonOverrideReason (10+ chars).
     status: ${projectStatusesForHelp.join(", ")}
 
@@ -258,6 +321,10 @@ Errors
   get-recent-errors          [--page] [--perPage] [--severity] [--status]
   get-error-metrics
 
+Automation (admin)
+  list-integration-operations [--destination] [--status PENDING|PROCESSING|FAILED|COMPLETED] [--page] [--perPage]
+  retry-integration-operation <operationId> [--confirmExternalStateReconciled true|false]
+
 Historical / benchmarks
   get-approved-budgets       [--projectId] [--limit] [--minRevenue] [--maxRevenue]
   get-budget-category-benchmarks <categoryId> [--limit]
@@ -374,6 +441,23 @@ async function main() {
                 await getBudgetVersions(id);
                 break;
             }
+            case "rename-budget-version": {
+                const versionId = positional[0];
+                const newName = getFlag(flags, "name");
+                if (!versionId || newName === undefined) {
+                    throw new Error("rename-budget-version requires <versionId> --name <text>");
+                }
+                await renameBudgetVersion(versionId, String(newName));
+                break;
+            }
+            case "restore-budget-version": {
+                const versionId = positional[0];
+                if (!versionId) {
+                    throw new Error("restore-budget-version requires <versionId>");
+                }
+                await restoreBudgetVersion(versionId);
+                break;
+            }
             case "update-budget-status": {
                 const [id, status] = positional;
                 if (!id || !status) {
@@ -478,6 +562,7 @@ async function main() {
                     unitPrice: parseOptNum(getFlag(flags, "unitPrice"), "--unitPrice"),
                     isFreeOfCharge: parseOptionalBoolFlag(flags, "isFreeOfCharge"),
                     gstInclusive: parseOptionalBoolFlag(flags, "gstInclusive"),
+                    gstOutOfScope: parseOptionalBoolFlag(flags, "gstOutOfScope"),
                 });
                 break;
             }
@@ -556,6 +641,46 @@ async function main() {
                 await updateBudgetDiscountFromPayload(raw);
                 break;
             }
+            case "delete-budget-commission": {
+                const budgetId = positional[0];
+                if (!budgetId) {
+                    throw new Error("delete-budget-commission requires <budgetId>");
+                }
+                await deleteBudgetCommission(budgetId);
+                break;
+            }
+            case "delete-budget-discount": {
+                const budgetId = positional[0];
+                if (!budgetId) {
+                    throw new Error("delete-budget-discount requires <budgetId>");
+                }
+                await deleteBudgetDiscount(budgetId);
+                break;
+            }
+            case "mark-budget-items-not-utilized": {
+                const budgetItemIds = parseCommaSeparatedIds(getFlag(flags, "ids"));
+                if (!budgetItemIds?.length) {
+                    throw new Error("mark-budget-items-not-utilized requires --ids <csv>");
+                }
+                await setBudgetItemsNotUtilized(budgetItemIds, true);
+                break;
+            }
+            case "restore-budget-item": {
+                const budgetItemId = positional[0];
+                if (!budgetItemId) {
+                    throw new Error("restore-budget-item requires <budgetItemId>");
+                }
+                await setBudgetItemsNotUtilized([budgetItemId], false);
+                break;
+            }
+            case "create-placeholder-bill": {
+                const budgetItemId = positional[0];
+                if (!budgetItemId) {
+                    throw new Error("create-placeholder-bill requires <budgetItemId>");
+                }
+                await createPlaceholderBillForBudgetItem(budgetItemId);
+                break;
+            }
             case "list-bills": {
                 await listBills(parseListBillsFlags(flags));
                 break;
@@ -583,6 +708,15 @@ async function main() {
                 await createBillFromPayload(raw);
                 break;
             }
+            case "validate-bill-selection": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("validate-bill-selection requires --payload '<json>'");
+                }
+                const raw = parseJsonFlag(String(payloadRaw), "--payload");
+                await validateBillSelectionFromPayload(raw);
+                break;
+            }
             case "update-bill": {
                 const payloadRaw = getFlag(flags, "payload");
                 if (!payloadRaw) {
@@ -592,6 +726,15 @@ async function main() {
                 await updateBillFromPayload(raw);
                 break;
             }
+            case "update-bill-payment-evidence": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("update-bill-payment-evidence requires --payload '<json>'");
+                }
+                const raw = parseJsonFlag(String(payloadRaw), "--payload");
+                await updateBillPaymentEvidenceFromPayload(raw);
+                break;
+            }
             case "delete-bill": {
                 const id = positional[0];
                 if (!id)
@@ -690,6 +833,35 @@ async function main() {
                 await getBillAttachments(id);
                 break;
             }
+            case "stage-bill-attachment": {
+                const [projectId, ...positionalFilePaths] = positional;
+                const fileFlag = getFlag(flags, "file");
+                const filesFlag = getFlag(flags, "files");
+                const filePaths = [
+                    ...positionalFilePaths,
+                    ...(fileFlag !== undefined ? [String(fileFlag)] : []),
+                    ...(filesFlag !== undefined
+                        ? String(filesFlag)
+                            .split(",")
+                            .map((value) => value.trim())
+                            .filter(Boolean)
+                        : []),
+                ];
+                if (!projectId || filePaths.length === 0) {
+                    throw new Error("stage-bill-attachment requires <projectId> <filePath...> or --file/--files");
+                }
+                await stageBillAttachmentsFromPaths(projectId, filePaths);
+                break;
+            }
+            case "cleanup-staged-bill-attachments": {
+                const projectId = positional[0];
+                const keys = parseCommaSeparatedIds(getFlag(flags, "keys"));
+                if (!projectId || !keys) {
+                    throw new Error("cleanup-staged-bill-attachments requires <projectId> --keys <csv>");
+                }
+                await cleanupStagedBillAttachments(projectId, keys);
+                break;
+            }
             case "upload-bill-attachment":
             case "attach-bill-attachment":
             case "attach-bill-payment-receipt": {
@@ -770,12 +942,9 @@ async function main() {
                     projectId: getFlag(flags, "projectId"),
                     budgetId: getFlag(flags, "budgetId"),
                     supplierId: getFlag(flags, "supplierId"),
-                    status: statusRaw !== undefined
-                        ? String(statusRaw)
-                            .split(",")
-                            .map((value) => value.trim().toUpperCase())
-                            .filter(Boolean)
-                        : undefined,
+                    status: parseCommaSeparatedQuotationStatuses(statusRaw),
+                    requesterIds: parseCommaSeparatedIds(getFlag(flags, "requesterIds")),
+                    search: getFlag(flags, "search"),
                     page: getFlag(flags, "page") !== undefined
                         ? Number(getFlag(flags, "page"))
                         : undefined,
@@ -800,6 +969,15 @@ async function main() {
                 await uploadQuotationAttachmentFromPath(projectId, filePath);
                 break;
             }
+            case "cleanup-staged-quotation-attachments": {
+                const projectId = positional[0];
+                const keys = parseCommaSeparatedIds(getFlag(flags, "keys"));
+                if (!projectId || !keys) {
+                    throw new Error("cleanup-staged-quotation-attachments requires <projectId> --keys <csv>");
+                }
+                await cleanupStagedQuotationAttachments(projectId, keys);
+                break;
+            }
             case "create-quotation": {
                 const payloadRaw = getFlag(flags, "payload");
                 if (!payloadRaw) {
@@ -809,6 +987,22 @@ async function main() {
                 await createQuotationFromPayload(raw);
                 break;
             }
+            case "update-quotation": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("update-quotation requires --payload '<json>'");
+                }
+                const raw = parseJsonFlag(String(payloadRaw), "--payload");
+                await updateQuotationFromPayload(raw);
+                break;
+            }
+            case "delete-quotation": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("delete-quotation requires <quotationId>");
+                await deleteQuotationById(id);
+                break;
+            }
             case "submit-quotation": {
                 const id = positional[0];
                 if (!id)
@@ -842,10 +1036,114 @@ async function main() {
                     ? "ORIGINAL"
                     : roleRaw === "staff"
                         ? "STAFF_SIGNED"
-                        : "FINAL_SIGNED";
+                        : roleRaw === "final"
+                            ? "FINAL_SIGNED"
+                            : null;
+                if (!fileRole) {
+                    throw new Error("download-quotation-pdf role must be original, staff, or final");
+                }
                 await downloadQuotationPdf(id, fileRole);
                 break;
             }
+            case "check-customer-invoice-readiness": {
+                const budgetId = positional[0];
+                if (!budgetId) {
+                    throw new Error("check-customer-invoice-readiness requires <budgetId>");
+                }
+                await checkCustomerInvoiceReadiness(budgetId);
+                break;
+            }
+            case "list-customer-invoices": {
+                const budgetId = positional[0];
+                if (!budgetId) {
+                    throw new Error("list-customer-invoices requires <budgetId>");
+                }
+                const statusRaw = getFlag(flags, "status");
+                const sortDir = parseOptionalBillListSortDir(getFlag(flags, "sortDir"));
+                await listCustomerInvoices({
+                    budgetId,
+                    page: parsePositiveIntFlag(getFlag(flags, "page"), "--page") ?? 1,
+                    perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage") ?? 12,
+                    q: getFlag(flags, "search") ?? "",
+                    statuses: parseCommaSeparatedCustomerInvoiceStatuses(statusRaw !== undefined ? String(statusRaw) : undefined),
+                    sortBy: parseCustomerInvoiceSortBy(getFlag(flags, "sortBy")),
+                    sortDir: sortDir ?? "desc",
+                });
+                break;
+            }
+            case "get-customer-invoice": {
+                const batchId = positional[0];
+                if (!batchId) {
+                    throw new Error("get-customer-invoice requires <batchId>");
+                }
+                await getCustomerInvoice(batchId);
+                break;
+            }
+            case "create-customer-invoice": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("create-customer-invoice requires --payload '<json>'");
+                }
+                await createCustomerInvoice(parseJsonFlag(String(payloadRaw), "--payload"));
+                break;
+            }
+            case "discard-customer-invoice": {
+                const batchId = positional[0];
+                if (!batchId) {
+                    throw new Error("discard-customer-invoice requires <batchId>");
+                }
+                await discardCreatingCustomerInvoice(batchId);
+                break;
+            }
+            case "delete-customer-invoice": {
+                const batchId = positional[0];
+                if (!batchId) {
+                    throw new Error("delete-customer-invoice requires <batchId>");
+                }
+                await deleteCustomerInvoice(batchId);
+                break;
+            }
+            case "void-customer-invoice": {
+                const batchId = positional[0];
+                if (!batchId) {
+                    throw new Error("void-customer-invoice requires <batchId>");
+                }
+                await voidCustomerInvoice(batchId);
+                break;
+            }
+            case "approve-customer-invoice": {
+                const batchId = positional[0];
+                if (!batchId) {
+                    throw new Error("approve-customer-invoice requires <batchId>");
+                }
+                await approveCustomerInvoice(batchId);
+                break;
+            }
+            case "reject-customer-invoice": {
+                const batchId = positional[0];
+                const reason = getFlag(flags, "reason");
+                if (!batchId || reason === undefined) {
+                    throw new Error("reject-customer-invoice requires <batchId> --reason <text>");
+                }
+                await rejectCustomerInvoice(batchId, String(reason));
+                break;
+            }
+            case "download-customer-invoice-pdf": {
+                const invoiceId = positional[0];
+                if (!invoiceId) {
+                    throw new Error("download-customer-invoice-pdf requires <invoiceId> [--output <path>]");
+                }
+                await downloadCustomerInvoicePdf(invoiceId, getFlag(flags, "output"));
+                break;
+            }
+            case "sync-customer-invoice": {
+                const invoiceId = positional[0];
+                if (!invoiceId) {
+                    throw new Error("sync-customer-invoice requires <invoiceId>");
+                }
+                await syncCustomerInvoice(invoiceId);
+                break;
+            }
             case "list-approvals":
             case "get-pending-approvals": {
                 const typeRaw = getFlag(flags, "type");
@@ -976,6 +1274,7 @@ async function main() {
                 const contactPersonId = getFlag(flags, "contactPersonId");
                 const insideSalesId = getFlag(flags, "insideSalesId");
                 const businessDevelopmentId = getFlag(flags, "businessDevelopmentId");
+                const projectManagerId = getFlag(flags, "projectManagerId");
                 const venue = getFlag(flags, "venue");
                 const pax = getFlag(flags, "pax");
                 const asanaTaskId = getFlag(flags, "asanaTaskId");
@@ -994,7 +1293,7 @@ async function main() {
                     !businessDevelopmentId ||
                     !venue ||
                     !startDate) {
-                    throw new Error("create-project requires --name --companyId --contactPersonId --insideSalesId --businessDevelopmentId --venue --startDate (ISO/datetime flags as appropriate); optional --asanaTaskId, --asanaSearch, --pax and --endDate");
+                    throw new Error("create-project requires --name --companyId --contactPersonId --insideSalesId --businessDevelopmentId --venue --startDate (ISO/datetime flags as appropriate); optional --projectManagerId, --asanaTaskId, --asanaSearch, --pax and --endDate");
                 }
                 await createProject({
                     name,
@@ -1002,6 +1301,7 @@ async function main() {
                     contactPersonId,
                     insideSalesId,
                     businessDevelopmentId,
+                    projectManagerId,
                     venue,
                     pax,
                     asanaTaskId,
@@ -1031,17 +1331,50 @@ async function main() {
                 await deleteProjectById(id);
                 break;
             }
+            case "check-project-reconciliation": {
+                const id = positional[0];
+                if (!id) {
+                    throw new Error("check-project-reconciliation requires <id>");
+                }
+                await checkProjectReconciliation(id);
+                break;
+            }
+            case "reconcile-project": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("reconcile-project requires <id>");
+                await reconcileProject(id);
+                break;
+            }
+            case "complete-project": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("complete-project requires <id>");
+                await completeProject(id);
+                break;
+            }
+            case "import-qbo-project": {
+                const projectId = positional[0];
+                const projectUrl = getFlag(flags, "url");
+                if (!projectId || projectUrl === undefined) {
+                    throw new Error("import-qbo-project requires <projectId> --url <quickBooksProjectUrl>");
+                }
+                await importQuickBooksProjectId(projectId, String(projectUrl));
+                break;
+            }
             case "update-project-status": {
                 const [id, statusRaw] = positional;
                 if (!id || !statusRaw) {
                     throw new Error("update-project-status requires <id> <status>");
                 }
                 const pmIdFlag = getFlag(flags, "projectManagerId");
-                const pmNameFlag = getFlag(flags, "projectManagerName");
+                const pmEmailFlag = getFlag(flags, "projectManagerEmail");
                 const wonOverrideReasonFlag = getFlag(flags, "wonOverrideReason");
                 await updateProjectStatus(id, parseProjectStatusForUpdate(statusRaw), {
                     ...(pmIdFlag && { projectManagerId: String(pmIdFlag) }),
-                    ...(pmNameFlag && { projectManagerName: String(pmNameFlag) }),
+                    ...(pmEmailFlag && {
+                        projectManagerEmail: String(pmEmailFlag),
+                    }),
                     ...(wonOverrideReasonFlag && {
                         wonOverrideReason: String(wonOverrideReasonFlag),
                     }),
@@ -1316,6 +1649,24 @@ async function main() {
                 await getErrorMetrics();
                 break;
             }
+            case "list-integration-operations": {
+                await listIntegrationOperations({
+                    destination: getFlag(flags, "destination"),
+                    page: parsePositiveIntFlag(getFlag(flags, "page"), "--page") ?? 1,
+                    perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage") ?? 25,
+                    status: parseIntegrationOperationStatus(getFlag(flags, "status")),
+                });
+                break;
+            }
+            case "retry-integration-operation": {
+                const operationId = positional[0];
+                if (!operationId) {
+                    throw new Error("retry-integration-operation requires <operationId>");
+                }
+                await retryIntegrationOperation(operationId, parseOptionalBoolFlag(flags, "confirmExternalStateReconciled") ??
+                    false);
+                break;
+            }
             case "get-approved-budgets": {
                 await getApprovedBudgets({
                     projectId: getFlag(flags, "projectId"),