@go-labs-sg/bb 3.0.0 → 3.2.0

package/command-reference.md

@@ -396,7 +396,7 @@ Effects: state-change, email.
 
 ## `bb bill create`
 
-Create a bill or claim with an approved supplier. All amount fields exclude GST: amount is the portion billed; extractedAmount is the full invoice subtotal; lineAmounts and quotationAllocations also exclude GST. Example: 1800 + 162 GST = 1962 total requires amount=1800 and extractedAmount=1800 for a full bill. The CLI does not strip GST from input. --draft-only guarantees DRAFT without email or external writes; otherwise unpaid creation skips email permission but keeps external-write permission.
+Create a bill or claim with an approved supplier. All amount fields exclude GST: amount is the portion billed; extractedAmount is the full invoice subtotal; lineAmounts and quotationAllocations also exclude GST. Example: 1800 + 162 GST = 1962 total requires amount=1800 and extractedAmount=1800 for a full bill. The CLI does not strip GST from input. If the selected quotations cannot split the bill amount across every selected line (a line without a quoted amount that cannot be derived from the quotation total), pass lineAmounts; updates that keep the same amount and lines reuse the existing line amounts. --draft-only guarantees DRAFT without email or external writes; otherwise unpaid creation skips email permission but keeps external-write permission.
 
 Legacy aliases: `create-bill`, `create_bill`.
 
@@ -409,7 +409,7 @@ Payload fields (--payload JSON)
 
 ## `bb bill selection validate`
 
-Validate the approved supplier and selected bill line items.
+Validate the approved supplier and selected bill line items. Supplier bills need approved quotation sources (quotationIds, legacy quotationId, or quotationAllocations with lineAmounts) for every line that is not quotation-exempt (Go Internal lines, or projects/budgets created before the quotation cutoff). With billId, lines already on the bill keep their stored sources unless new sources are supplied. Exemption is decided by the server, so there is no --quotation-exempt flag here. Amounts (amount, lineAmounts, quotationAllocations) are ex-GST dollars with at most 2 decimal places.
 
 Legacy aliases: `validate-bill-selection`, `validate_bill_selection`.
 
@@ -435,7 +435,7 @@ Payload fields (--payload JSON)
 
 ## `bb bill update`
 
-Update a bill or claim with a partial payload including id; omitted fields are preserved. Comment-only updates are allowed on approved/paid bills without altering financial data or QuickBooks. All amount fields exclude GST: amount is the portion billed; extractedAmount is the full invoice subtotal; lineAmounts and quotationAllocations also exclude GST. Example: 1800 + 162 GST = 1962 total requires amount=1800 and extractedAmount=1800 for a full bill. The CLI does not strip GST from input. Re-read and verify both amount fields and allocations after correcting a gross/net mistake.
+Update a bill or claim with a partial payload including id; omitted fields are preserved. Comment-only updates are allowed on approved/paid bills without altering financial data or QuickBooks. All amount fields exclude GST: amount is the portion billed; extractedAmount is the full invoice subtotal; lineAmounts and quotationAllocations also exclude GST. Example: 1800 + 162 GST = 1962 total requires amount=1800 and extractedAmount=1800 for a full bill. The CLI does not strip GST from input. If the selected quotations cannot split the bill amount across every selected line (a line without a quoted amount that cannot be derived from the quotation total), pass lineAmounts; updates that keep the same amount and lines reuse the existing line amounts. Re-read and verify both amount fields and allocations after correcting a gross/net mistake.
 
 Legacy aliases: `update-bill`, `update_bill`.
 
@@ -557,12 +557,36 @@ Effects: state-change.
 
 ## `bb bill get`
 
-Get bill details.
+Get a bill's summary as shown in the web app: status, amounts, people, payment and line totals. Use get-bill-line-items, get-bill-approvals, get-bill-attachments or get-bill-payment for more detail. Argument: <billId>.
 
 Legacy aliases: `get-bill-details`, `get_bill_details`.
 
 Effects: none.
 
+## `bb bill line-item list`
+
+List a bill's line items with budget-item and quotation-allocation detail. <billId> [--limit 1-100] [--cursor <token>] Newest first. Returns { items, pageInfo }; follow nextCursor.
+
+Legacy aliases: `get-bill-line-items`, `get_bill_line_items`.
+
+Effects: none.
+
+## `bb bill approval list`
+
+List a bill's approval requests with approver, requester and responder. <billId> [--limit 1-50] [--cursor <token>] Newest first. Returns { items, pageInfo }; follow nextCursor.
+
+Legacy aliases: `get-bill-approvals`, `get_bill_approvals`.
+
+Effects: none.
+
+## `bb bill payment get`
+
+Get a bill's payment status, reference, date, tracking URL, QuickBooks link and external payment. Argument: <billId>.
+
+Legacy aliases: `get-bill-payment`, `get_bill_payment`.
+
+Effects: none.
+
 ## `bb quotation list`
 
 List quotations with cursor pagination. [--projectId] [--budgetId] [--supplierId] [--status CSV] [--createdBy CSV] [--search] [--limit 1-100] [--cursor <token>] [--direction forward|backward] Newest first; returns { items, pageInfo }. Follow nextCursor/previousCursor with the same filters. --page/--pageSize/--perPage are rejected; --requesterIds remains an alias for --createdBy.
@@ -581,12 +605,20 @@ Effects: none.
 
 ## `bb quotation get`
 
-Get quotation.
+Get a quotation as shown in the web app: status, amounts, people, line totals, files and approvals. Use get-quotation-line-items for budget-item detail. Argument: <quotationId>.
 
 Legacy aliases: `get-quotation`, `get_quotation`.
 
 Effects: none.
 
+## `bb quotation line-item list`
+
+List a quotation's line items with budget-item, supplier and budget detail. <quotationId> [--limit 1-100] [--cursor <token>] Newest first. Returns { items, pageInfo }; follow nextCursor.
+
+Legacy aliases: `get-quotation-line-items`, `get_quotation_line_items`.
+
+Effects: none.
+
 ## `bb quotation attachment upload`
 
 Upload Quotation Attachment.
@@ -719,12 +751,44 @@ Effects: none.
 
 ## `bb customer-invoice get`
 
-Get customer invoice.
+Get an invoice batch as shown in the web app: status, totals, people, approvals and invoice summaries. Use get-customer-invoice-invoices, get-customer-invoice-lines, get-customer-invoice-approvals or get-customer-invoice-history for more detail. Argument: <batchId>.
 
 Legacy aliases: `get-customer-invoice`, `get_customer_invoice`.
 
 Effects: none.
 
+## `bb customer-invoice invoice list`
+
+List a batch's invoices with QuickBooks id/doc number, issue/due dates, amounts, sync state and sender. Argument: <batchId>.
+
+Legacy aliases: `get-customer-invoice-invoices`, `get_customer_invoice_invoices`.
+
+Effects: none.
+
+## `bb customer-invoice line list`
+
+List one invoice's lines (name, description, QuickBooks item/tax code, quantity, amounts). <invoiceId> [--limit 1-100] [--cursor <token>] Newest first. Returns { items, pageInfo }; follow nextCursor.
+
+Legacy aliases: `get-customer-invoice-lines`, `get_customer_invoice_lines`.
+
+Effects: none.
+
+## `bb customer-invoice approval list`
+
+List an invoice batch's approval requests with approver, requester and responder. <batchId> [--limit 1-50] [--cursor <token>] Newest first. Returns { items, pageInfo }; follow nextCursor.
+
+Legacy aliases: `get-customer-invoice-approvals`, `get_customer_invoice_approvals`.
+
+Effects: none.
+
+## `bb customer-invoice history list`
+
+List an invoice batch's status history (batch/invoice status changes, source, note, actor). <batchId> [--limit 1-100] [--cursor <token>] Newest first. Returns { items, pageInfo }; follow nextCursor.
+
+Legacy aliases: `get-customer-invoice-history`, `get_customer_invoice_history`.
+
+Effects: none.
+
 ## `bb customer-invoice email-context get`
 
 Get customer invoice email context.
@@ -1054,7 +1118,7 @@ Effects: state-change, external-write.
 
 Payload fields (--payload JSON)
   Required: id: string; name: string; companyId: string; contactPersonId: string; asanaTaskId: string; insideSalesId: string; businessDevelopmentId: string; venue: string; dateRange: {from: ISO date}
-  Optional: dateRange.to: ISO date; projectManagerId: string; pax: string; description: string; slackChannelId/slackChannelUrl/slackChannelName: strings (supply all three); requestQboAccountantNotification: boolean; confirmEstimateInvalidation: boolean
+  Optional: dateRange.to: ISO date; projectManagerId: string; pax: string; description: string; slackChannelId/slackChannelUrl/slackChannelName: strings (supply all three); requestQboAccountantNotification: boolean; confirmEstimateInvalidation: boolean. Changing companyId requires a contactPersonId from the new company; the company change itself does not reject existing estimates or touch existing invoices, but date, pax or venue changes in the same save still require confirmEstimateInvalidation.
   Example: bb update-project --payload '{"id":"<project-id>","name":"Launch","companyId":"<company-id>","contactPersonId":"<contact-id>","asanaTaskId":"<asana-task-id>","insideSalesId":"<user-id>","businessDevelopmentId":"<user-id>","venue":"Hall","dateRange":{"from":"2026-10-01T09:00:00Z"}}'
 
 ## `bb project delete`
@@ -1471,6 +1535,14 @@ Legacy aliases: `count-errors`, `count_errors`.
 
 Effects: none.
 
+## `bb error get`
+
+Admin-only: one error log with full diagnostics (stack, cause, request details, metadata, AI summary, resolution). Argument: <errorId>. error recent list returns table columns only.
+
+Legacy aliases: `get-error`, `get_error`.
+
+Effects: none.
+
 ## `bb error metrics get`
 
 Get error metrics.
@@ -1489,7 +1561,7 @@ Effects: none.
 
 ## `bb integration operation count`
 
-Count integration operations matching filters: { totalCount, filterOptions }. Admin only.
+Provider filter options for integration operations: { filterOptions }. No total; filter flags are accepted but do not change the result. Admin only.
 
 Legacy aliases: `count-integration-operations`, `count_integration_operations`.
 
@@ -1585,7 +1657,7 @@ Effects: state-change.
 
 ## `bb webhook delivery list`
 
-List webhook deliveries.
+Admin-only: list webhook deliveries newest first. Returns { items, pageInfo }; follow pageInfo.nextCursor (or previousCursor with --direction backward). Cursors are opaque and filter-bound; raw delivery ids are rejected.
 
 Legacy aliases: `list-webhook-deliveries`, `list_webhook_deliveries`.