@go-labs-sg/bb 3.0.0 → 3.1.0

package/command-reference.md

@@ -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`.