@go-labs-sg/bb 1.18.1 → 1.20.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, stageBillAttachmentsFromPaths, 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, sendEstimateToContactPersonFromPayload, 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.
+estimate emails, 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.
@@ -144,6 +176,7 @@ Budgets
   delete-budget <budgetId>
   create-budget-approval <budgetId>   (also sends approval request emails)
   create-estimate <budgetId>          (creates QuickBooks estimate; supports preflight updates)
+  send-estimate-to-contact-person --payload '<json>'   Send using the web contact-person workflow; payload includes recipient fields plus HTML content/signature.
   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] [--gstOutOfScope true|false]
   remove-budget-item <budgetItemId>
@@ -154,6 +187,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
@@ -163,12 +201,16 @@ Bills
     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)
+  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]
+  update-bill-status <id> <status> [--rejectionReason] [--paymentTrackingUrl] [--paymentReference] [--paymentProof <receipt.pdf>]
     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.
+    PAID requires --paymentReference and a payment-proof PDF. Use --paymentProof to stage and submit the PDF atomically, or omit it only when BB already has a BILL_PAYMENT_PROOF attachment.
+    Moving a bill or claim to PAID runs the server's paid-bill notification workflow.
   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>
@@ -179,17 +221,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
+  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)
@@ -211,8 +269,12 @@ Companies & projects
   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>
+  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 PITCH → WON: supply --projectManagerId or --projectManagerEmail.
     Required when moving to WON without accepted/closed budget or win proof: --wonOverrideReason (10+ chars).
     status: ${projectStatusesForHelp.join(", ")}
 
@@ -261,6 +323,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]
@@ -377,6 +443,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) {
@@ -434,6 +517,16 @@ async function main() {
                 });
                 break;
             }
+            case "send-estimate-email":
+            case "send-estimate-to-contact-person": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("send-estimate-to-contact-person requires --payload '<json>'");
+                }
+                const raw = parseJsonFlag(String(payloadRaw), "--payload");
+                await sendEstimateToContactPersonFromPayload(raw);
+                break;
+            }
             case "create-budget": {
                 const payloadRaw = getFlag(flags, "payload");
                 if (!payloadRaw) {
@@ -560,6 +653,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;
@@ -587,6 +720,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) {
@@ -596,6 +738,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)
@@ -606,7 +757,11 @@ async function main() {
             case "update-bill-status": {
                 const [id, statusRaw] = positional;
                 if (!id || !statusRaw) {
-                    throw new Error("update-bill-status requires <billId> <status> [--rejectionReason] [--paymentTrackingUrl] [--paymentReference]");
+                    throw new Error("update-bill-status requires <billId> <status> [--rejectionReason] [--paymentTrackingUrl] [--paymentReference] [--paymentProof <receipt.pdf>]");
+                }
+                const paymentProofFlag = flags.paymentProof ?? flags["payment-proof"] ?? flags.receipt;
+                if (paymentProofFlag === true) {
+                    throw new Error("--paymentProof requires a PDF file path.");
                 }
                 const status = parseBillStatusForUpdate(statusRaw);
                 await updateBillStatus({
@@ -615,6 +770,7 @@ async function main() {
                     rejectionReason: getFlag(flags, "rejectionReason"),
                     paymentTrackingUrl: getFlag(flags, "paymentTrackingUrl"),
                     paymentReference: getFlag(flags, "paymentReference"),
+                    paymentProofPath: paymentProofFlag,
                 });
                 break;
             }
@@ -714,6 +870,15 @@ async function main() {
                 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": {
@@ -794,12 +959,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,
@@ -824,6 +986,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) {
@@ -833,6 +1004,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)
@@ -866,10 +1053,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");
@@ -1057,6 +1348,37 @@ 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) {
@@ -1344,6 +1666,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"),

package/dist/parse-cli-enums.js

@@ -1,8 +1,10 @@
 import { BudgetRole, Deals, ExtendedApprovalStatus, ExtendedBillStatus, ExtendedErrorSeverity, ExtendedErrorStatus, ExtendedProjectStatus, TimeFrame, } from "./filter-enums.js";
-import { BillStatus, BudgetStatus, ProjectStatus, UserRole, } from "./prisma-enums.js";
+import { BillStatus, BudgetStatus, CustomerInvoiceBatchStatus, ProjectStatus, SupplierQuotationStatus, UserRole, } from "./prisma-enums.js";
 const BUDGET_STATUS_VALUES = new Set(Object.values(BudgetStatus));
 const BILL_STATUS_VALUES = new Set(Object.values(BillStatus));
 const PROJECT_STATUS_VALUES = new Set(Object.values(ProjectStatus));
+const SUPPLIER_QUOTATION_STATUS_VALUES = new Set(Object.values(SupplierQuotationStatus));
+const CUSTOMER_INVOICE_BATCH_STATUS_VALUES = new Set(Object.values(CustomerInvoiceBatchStatus));
 const USER_ROLE_VALUES = new Set(Object.values(UserRole));
 const EXTENDED_PROJECT_STATUS_VALUES = new Set(Object.values(ExtendedProjectStatus));
 const DASHBOARD_ROLE_VALUES = new Set([
@@ -173,6 +175,38 @@ export function parseCommaSeparatedSupplierStatuses(raw) {
     }
     return out;
 }
+export function parseCommaSeparatedQuotationStatuses(raw) {
+    if (raw === undefined)
+        return undefined;
+    const parts = raw
+        .split(",")
+        .map((value) => value.trim().toUpperCase())
+        .filter(Boolean);
+    if (parts.length === 0)
+        return undefined;
+    for (const status of parts) {
+        if (!SUPPLIER_QUOTATION_STATUS_VALUES.has(status)) {
+            throw new Error(`Invalid quotation status "${status}". Use one of: ${[...SUPPLIER_QUOTATION_STATUS_VALUES].join(", ")}.`);
+        }
+    }
+    return parts;
+}
+export function parseCommaSeparatedCustomerInvoiceStatuses(raw) {
+    if (raw === undefined)
+        return undefined;
+    const parts = raw
+        .split(",")
+        .map((value) => value.trim().toUpperCase())
+        .filter(Boolean);
+    if (parts.length === 0)
+        return undefined;
+    for (const status of parts) {
+        if (!CUSTOMER_INVOICE_BATCH_STATUS_VALUES.has(status)) {
+            throw new Error(`Invalid customer invoice status "${status}". Use one of: ${[...CUSTOMER_INVOICE_BATCH_STATUS_VALUES].join(", ")}.`);
+        }
+    }
+    return parts;
+}
 export function parseBillStatusFlag(raw) {
     if (raw === undefined)
         return undefined;
@@ -225,7 +259,11 @@ export function parseOptionalBillListSortDir(raw) {
     return raw;
 }
 function isPendingRequestType(s) {
-    return (s === "BUDGET" || s === "BILL" || s === "SUPPLIER" || s === "QUOTATION");
+    return (s === "BUDGET" ||
+        s === "BILL" ||
+        s === "SUPPLIER" ||
+        s === "QUOTATION" ||
+        s === "CUSTOMER_INVOICE");
 }
 export function parseApprovalTypeFlag(raw) {
     if (raw === undefined)
@@ -234,7 +272,7 @@ export function parseApprovalTypeFlag(raw) {
     if (u === "ALL")
         return "ALL";
     if (!isPendingRequestType(u)) {
-        throw new Error(`Invalid --type "${raw}". Use budget, supplier, bill, quotation, or all.`);
+        throw new Error(`Invalid --type "${raw}". Use budget, supplier, bill, quotation, customer_invoice, or all.`);
     }
     return u;
 }