@go-labs-sg/bb 1.1.0 → 1.2.0

package/README.md

@@ -1,12 +1,12 @@
 # bb
 
-Command-line interface for **Budget Builder**. Call budgets, bills, approvals, and suppliers from your terminal or from tools that don’t support MCP (e.g. some AI agents). Responses are JSON on stdout.
+Command-line interface for **Budget Builder**. Call budgets, bills, approvals, suppliers, dashboard, and more from your terminal or from tools that don’t support MCP (e.g. some AI agents). Responses are JSON on stdout.
 
 **Registry:** [`@go-labs-sg/bb`](https://www.npmjs.com/package/@go-labs-sg/bb)
 
 ## Requirements
 
-- **Node.js** 18+
+- **Node.js** 18+ (ESM; relative imports in `dist` use `.js` extensions)
 - A **Budget Builder API key** (same key used for the MCP server)
 
 ## Install
@@ -48,18 +48,23 @@ bb list-suppliers
 
 Global options and flags use `--key=value` or `--key value` (see `bb help`).
 
-## Commands
+**Authoritative command list:** run `bb help` — it includes every command, positional args, and flags. MCP exposes a subset of the same tRPC surface; the CLI additionally includes a few procedures mainly used by the web UI (e.g. `reorder-budget-items`, `update-budget-item-supplier`). You can also use MCP-style `snake_case` (e.g. `bb list_bills`); it is normalized to kebab-case.
 
-| Command | Description |
+**Mutations with `--payload`:** Commands such as `create-budget`, `create-bill`, `update-supplier`, etc. take a single JSON object (`--payload '<json>'`) matching the corresponding tRPC procedure input. Use ISO strings for date/datetime fields; the CLI coerces them where needed. The API still validates the full shape.
+
+### Command overview
+
+| Area | Commands (non-exhaustive) |
 | --- | --- |
-| `list-budgets` | List budgets. Flags: `--projectId`, `--name`, `--status` (comma-separated), `--page`, `--perPage` |
-| `get-budget <id>` | Budget details and line items |
-| `update-budget-status <id> <status>` | Change budget status (e.g. `APPROVED`, `REJECTED`, `DRAFT`, …) |
-| `list-bills` | List bills and/or claims. Flags: `--projectId`, `--budgetId`, `--status` (CSV, like `DRAFT,PAID` or `ALL`), `--search`, `--isClaimable` (`true`\|`false`), `--createdByIds` (CSV), `--sortBy` (`createdAt`\|`amount`\|`status`), `--sortDir` (`asc`\|`desc`), `--page`, `--pageSize` |
-| `list-claims` | Reimbursable claims only; same flags as `list-bills` except `--isClaimable` is ignored (always true) |
-| `approve-bill <id>` | Approve a pending bill (matches your pending bill approvals) |
-| `list-approvals` | Pending approvals. Flag: `--type` = `budget`, `supplier`, `bill`, or `all` |
-| `list-suppliers` | List suppliers. Flags: `--name`, `--page`, `--perPage` |
+| **Budgets** | `list-budgets`, `get-budget`, `get-budget-items`, `get-budget-details`, `get-budget-categories`, `get-budget-versions`, `update-budget-status`, `create-budget` / `update-budget` (`--payload`), `delete-budget`, `create-budget-approval`, `add-budget-items`, `update-budget-item`, `remove-budget-item`, `reorder-budget-items`, `update-budget-item-supplier`, `create-budget-category`, `update-budget-category`, `delete-budget-category`, `update-budget-commission`, `update-budget-discount` (`--payload` where noted) |
+| **Bills** | `list-bills`, `list-claims`, `create-bill` (`--payload`), `update-bill` (`--payload`), `delete-bill`, `create-bill-approval`, `update-bill-status`, `patch-bill-payment`, `patch-bill-invoice-number`, `get-bill-attachments`, `get-bill-details` |
+| **Approvals** | `list-approvals` / `get-pending-approvals`, `approve-bill`, `reject-bill`, `approve-budget`, `reject-budget`, `approve-supplier`, `reject-supplier` |
+| **Companies & projects** | `list-companies`, `get-company`, `create-company`, `update-company` (`--payload`), `delete-company`, `list-projects`, `get-project`, `create-project` (optional `--requestQboAccountantNotification false` to skip QBO accountant emails), `update-project` (`--payload`, optional `requestQboAccountantNotification` in JSON), `delete-project`, `update-project-status` |
+| **Contacts** | `list-contacts`, `create-contact-person` (`--payload`), `update-contact-person` (`--payload`) |
+| **Suppliers & items** | `list-suppliers`, `create-supplier` (`--payload`), `update-supplier` (`--payload`), `delete-suppliers` (`--ids` CSV; admin), `create-certification` / `create-payment-method` / `create-supplier-role` / `create-supplier-tag` (`--name`), `get-supplier-details`, `get-supplier-analytics`, `list-items`, `create-item` (`--payload`), `update-item` (`--payload`), `delete-item`, `get-item`, `list-item-categories`, `create-item-category`, `update-item-category`, `delete-item-categories` (`--ids` CSV; admin) |
+| **Dashboard & users** | `list-users`, `get-user-performance`, `get-dashboard`, `get-monthly-metrics`, `get-system-overview`, `get-estimate-performance`, `get-financial-overview` |
+| **Errors** | `get-recent-errors`, `get-error-metrics` |
+| **Historical / benchmarks** | `get-approved-budgets`, `get-budget-category-benchmarks`, `get-item-pricing-history`, `get-supplier-pricing-history` |
 
 ## Output
 
@@ -71,7 +76,7 @@ A `.env` file in the **current working directory** is loaded automatically (for
 
 ## Developing in this repo
 
-From the monorepo root:
+From the monorepo root (after `bun install`):
 
 ```bash
 export BB_API_KEY=...
@@ -81,5 +86,15 @@ bun run bb -- list-budgets
 Or from `packages/cli`:
 
 ```bash
+bun run build          # emit dist/ via tsc
+bun run typecheck      # tsc --noEmit
 bun run src/index.ts list-budgets
 ```
+
+### Layout
+
+- **`src/filter-enums.ts`** — “extended” filter enums (ALL + Prisma enums), maintained here so the published package does not depend on unpublished workspace packages. Keep in line with `packages/utils/src/filter-enums.ts` when those values change.
+
+### Publish
+
+`prepublishOnly` strips `workspace:` / `catalog:` entries from this package’s `package.json`, runs `tsc`, then `postpack` restores the file — so the npm tarball does not contain monorepo protocol dependencies. Types from `@bb/api` are compile-time only (`import type`). Enum **values** in emitted JS import `@bb/db/enums` (workspace `@bb/db` during monorepo development).

package/dist/commands.js

@@ -1,6 +1,7 @@
-import { BudgetRole, Deals, ExtendedApprovalStatus, ExtendedApprovalType, ExtendedBudgetStatus, TimeFrame, } from "@bb/utils/filter-enums";
-import { api } from "./api-client";
-import { billStatusesForApi, } from "./parse-cli-enums";
+import { api } from "./api-client.js";
+import { BudgetRole, Deals, ExtendedApprovalStatus, ExtendedApprovalType, ExtendedBudgetStatus, TimeFrame, } from "./filter-enums.js";
+import { billStatusesForApi, } from "./parse-cli-enums.js";
+import { parseBudgetDiscountPayload, parseCompanyUpdatePayload, parseContactCreatePayload, parseContactUpdatePayload, parseCreateBillPayload, parseCreateBudgetPayload, parseItemCreatePayload, parseItemUpdatePayload, parseSupplierCreatePayload, parseSupplierUpdatePayload, parseUpdateBillPayload, parseUpdateBudgetCommissionPayload, parseUpdateBudgetPayload, parseUpdateProjectPayload, } from "./parse-mutation-payload.js";
 const BUDGET = "BUDGET";
 const BILL = "BILL";
 const SUPPLIER = "SUPPLIER";
@@ -200,6 +201,148 @@ export async function getBudgetDetails(budgetId) {
     const detail = await api.budget.getBudgetDetail.query({ id: budgetId });
     out(detail);
 }
+export async function createBudgetFromPayload(raw) {
+    const input = parseCreateBudgetPayload(raw);
+    const result = await api.budget.createBudget.mutate(input);
+    out(result);
+}
+export async function updateBudgetFromPayload(raw) {
+    const input = parseUpdateBudgetPayload(raw);
+    const result = await api.budget.updateBudget.mutate(input);
+    out(result);
+}
+export async function deleteBudgetById(budgetId) {
+    const result = await api.budget.deleteBudget.mutate({ id: budgetId });
+    out(result);
+}
+export async function deleteProjectById(projectId) {
+    const result = await api.project.deleteProject.mutate({ id: projectId });
+    out(result);
+}
+export async function deleteCompanyById(companyId) {
+    const result = await api.company.deleteCompany.mutate({ id: companyId });
+    out(result);
+}
+export async function reorderBudgetItemsCli(opts) {
+    const result = await api.budgetItem.reorderBudgetItems.mutate(opts);
+    out(result);
+}
+export async function updateBudgetItemSupplierCli(opts) {
+    const result = await api.budgetItem.updateBudgetItemSupplier.mutate(opts);
+    out(result);
+}
+export async function createBudgetCategory(name) {
+    const result = await api.budget.createBudgetCategory.mutate({ name });
+    out(result);
+}
+export async function updateBudgetCategory(opts) {
+    const result = await api.budget.updateBudgetCategory.mutate(opts);
+    out(result);
+}
+export async function deleteBudgetCategory(id) {
+    const result = await api.budget.deleteBudgetCategory.mutate({ id });
+    out(result);
+}
+export async function updateBudgetCommissionFromPayload(raw) {
+    const input = parseUpdateBudgetCommissionPayload(raw);
+    const result = await api.budget.updateBudgetCommission.mutate(input);
+    out(result);
+}
+export async function updateBudgetDiscountFromPayload(raw) {
+    const input = parseBudgetDiscountPayload(raw);
+    const result = await api.budget.updateBudgetDiscount.mutate(input);
+    out(result);
+}
+export async function deleteItemById(itemId) {
+    const result = await api.item.deleteItem.mutate({ id: itemId });
+    out(result);
+}
+export async function deleteSuppliersByIds(ids) {
+    const result = await api.supplier.deleteSuppliers.mutate({ ids });
+    out(result);
+}
+export async function createSupplierCertification(name) {
+    const result = await api.supplier.createCertification.mutate({ name });
+    out(result);
+}
+export async function createSupplierPaymentMethod(name) {
+    const result = await api.supplier.createPaymentMethod.mutate({ name });
+    out(result);
+}
+export async function createSupplierRoleOption(name) {
+    const result = await api.supplier.createSupplierRole.mutate({ name });
+    out(result);
+}
+export async function createSupplierTagOption(name) {
+    const result = await api.supplier.createSupplierTag.mutate({ name });
+    out(result);
+}
+export async function createItemCategory(name) {
+    const result = await api.itemCategory.createItemCategory.mutate({ name });
+    out(result);
+}
+export async function updateItemCategory(opts) {
+    const result = await api.itemCategory.updateItemCategory.mutate(opts);
+    out(result);
+}
+export async function deleteItemCategoriesByIds(ids) {
+    const result = await api.itemCategory.deleteItemCategories.mutate({ ids });
+    out(result);
+}
+export async function createBillFromPayload(raw) {
+    const input = parseCreateBillPayload(raw);
+    const result = await api.bill.create.mutate(input);
+    out(result);
+}
+export async function updateBillFromPayload(raw) {
+    const input = parseUpdateBillPayload(raw);
+    const result = await api.bill.update.mutate(input);
+    out(result);
+}
+export async function deleteBillById(id) {
+    const result = await api.bill.delete.mutate({ id });
+    out(result);
+}
+export async function createSupplierFromPayload(raw) {
+    const input = parseSupplierCreatePayload(raw);
+    const result = await api.supplier.createSupplier.mutate(input);
+    out(result);
+}
+export async function updateSupplierFromPayload(raw) {
+    const input = parseSupplierUpdatePayload(raw);
+    const result = await api.supplier.updateSupplier.mutate(input);
+    out(result);
+}
+export async function createItemFromPayload(raw) {
+    const input = parseItemCreatePayload(raw);
+    const result = await api.item.createItem.mutate(input);
+    out(result);
+}
+export async function updateItemFromPayload(raw) {
+    const input = parseItemUpdatePayload(raw);
+    const result = await api.item.updateItem.mutate(input);
+    out(result);
+}
+export async function createContactPersonFromPayload(raw) {
+    const input = parseContactCreatePayload(raw);
+    const result = await api.contactPerson.createContactPerson.mutate(input);
+    out(result);
+}
+export async function updateContactPersonFromPayload(raw) {
+    const input = parseContactUpdatePayload(raw);
+    const result = await api.contactPerson.updateContactPerson.mutate(input);
+    out(result);
+}
+export async function updateProjectFromPayload(raw) {
+    const input = parseUpdateProjectPayload(raw);
+    const result = await api.project.updateProject.mutate(input);
+    out(result);
+}
+export async function updateCompanyFromPayload(raw) {
+    const input = parseCompanyUpdatePayload(raw);
+    const result = await api.company.updateCompany.mutate(input);
+    out(result);
+}
 // --- Approvals: budgets / suppliers / bills (MCP parity) ---
 export async function approveBudget(budgetId) {
     const notifications = await api.budget.getNotifications.query();
@@ -338,6 +481,9 @@ export async function createProject(opts) {
             from: new Date(opts.startDate),
             to: opts.endDate ? new Date(opts.endDate) : undefined,
         },
+        ...(opts.requestQboAccountantNotification !== undefined && {
+            requestQboAccountantNotification: opts.requestQboAccountantNotification,
+        }),
     });
     out(result);
 }
@@ -403,6 +549,39 @@ export async function getDashboard(input) {
     });
     out(result);
 }
+export async function getMonthlyMetrics(input) {
+    const result = await api.dashboard.getMonthlyMetrics.query({
+        userId: input.userId,
+        role: input.role ?? "ALL",
+        deals: input.deals ?? "ALL",
+        timeFrame: input.timeFrame ?? "ALL",
+        startDate: input.startDate,
+        endDate: input.endDate,
+    });
+    out(result);
+}
+export async function getSystemOverview(input) {
+    const result = await api.dashboard.getSystemOverview.query({
+        userId: input.userId,
+        role: input.role ?? "ALL",
+        deals: input.deals ?? "ALL",
+        timeFrame: input.timeFrame ?? "ALL",
+        startDate: input.startDate,
+        endDate: input.endDate,
+    });
+    out(result);
+}
+export async function getEstimatePerformance(input) {
+    const result = await api.dashboard.getEstimatePerformance.query({
+        userId: input.userId,
+        role: input.role ?? "ALL",
+        deals: input.deals ?? "ALL",
+        timeFrame: input.timeFrame ?? "ALL",
+        startDate: input.startDate,
+        endDate: input.endDate,
+    });
+    out(result);
+}
 export async function getFinancialOverview(input) {
     const result = await api.dashboard.getFinancialOverview.query({
         userId: input.userId,

package/dist/filter-enums.js

@@ -0,0 +1,58 @@
+import { ApprovalStatus, ApprovalType, BillStatus, BudgetStatus, ErrorSeverity, ErrorStatus, EstimationMode, ProjectStatus, } from "@bb/db/enums";
+export const ExtendedApprovalStatus = {
+    ...ApprovalStatus,
+    ALL: "ALL",
+};
+export const ExtendedApprovalType = {
+    ...ApprovalType,
+    ALL: "ALL",
+};
+export const ExtendedProjectStatus = {
+    ...ProjectStatus,
+    ALL: "ALL",
+};
+export const ExtendedBudgetStatus = {
+    ...BudgetStatus,
+    ALL: "ALL",
+};
+export const ExtendedBillStatus = {
+    ...BillStatus,
+    ALL: "ALL",
+};
+export const ExtendedEstimationMode = {
+    ...EstimationMode,
+    ALL: "ALL",
+};
+export const BudgetRole = {
+    ALL: "ALL",
+    BD: "BD",
+    CREATOR: "CREATOR",
+    INSIDE_SALES: "INSIDE_SALES",
+};
+export const Deals = {
+    ALL: "ALL",
+    SUCCESSFUL: "SUCCESSFUL",
+    LOST: "LOST",
+};
+export const TimeFrame = {
+    ALL: "ALL",
+    LAST_YEAR: "LAST_YEAR",
+    LAST_6_MONTHS: "LAST_6_MONTHS",
+    LAST_3_MONTHS: "LAST_3_MONTHS",
+    CUSTOM: "CUSTOM",
+};
+export const ChartTimeFrame = {
+    LAST_30_DAYS: "last_30_days",
+    LAST_3_MONTHS: "last_3_months",
+    LAST_6_MONTHS: "last_6_months",
+    LAST_1_YEAR: "last_1_year",
+    ALL_TIME: "all_time",
+};
+export const ExtendedErrorSeverity = {
+    ALL: "ALL",
+    ...ErrorSeverity,
+};
+export const ExtendedErrorStatus = {
+    ALL: "ALL",
+    ...ErrorStatus,
+};

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import "./load-env";
-import { requireApiKey } from "./api-client";
-import { addBudgetItems, approveBill, approveBudget, approveSupplier, createBillApproval, createBudgetApproval, createCompany, createProject, getApprovedBudgets, getBillAttachments, getBillDetails, getBudget, getBudgetCategories, getBudgetCategoryBenchmarks, getBudgetDetails, getBudgetItemsOnly, getBudgetVersions, getCompany, getDashboard, getErrorMetrics, getFinancialOverview, getItem, getItemPricingHistory, getProject, getRecentErrors, getSupplierAnalytics, getSupplierDetails, getSupplierPricingHistory, getUserPerformance, listApprovals, listBills, listBudgets, listCompanies, listContacts, listItemCategories, listItems, listProjects, listSuppliers, listUsers, patchBillInvoiceNumber, patchBillPayment, rejectBill, rejectBudget, rejectSupplier, removeBudgetItem, updateBillStatus, updateBudgetItem, updateBudgetStatus, updateProjectStatus, } from "./commands.js";
+import "./load-env.js";
+import { requireApiKey } from "./api-client.js";
+import { addBudgetItems, approveBill, approveBudget, approveSupplier, createBillApproval, createBillFromPayload, createBudgetApproval, createBudgetCategory, createBudgetFromPayload, createCompany, createContactPersonFromPayload, createItemCategory, createItemFromPayload, createProject, createSupplierCertification, createSupplierFromPayload, createSupplierPaymentMethod, createSupplierRoleOption, createSupplierTagOption, deleteBillById, deleteBudgetById, deleteBudgetCategory, deleteCompanyById, deleteItemById, deleteItemCategoriesByIds, deleteProjectById, deleteSuppliersByIds, getApprovedBudgets, getBillAttachments, getBillDetails, getBudget, getBudgetCategories, getBudgetCategoryBenchmarks, getBudgetDetails, getBudgetItemsOnly, getBudgetVersions, getCompany, getDashboard, getErrorMetrics, getEstimatePerformance, getFinancialOverview, getItem, getItemPricingHistory, getMonthlyMetrics, getProject, getRecentErrors, getSupplierAnalytics, getSupplierDetails, getSupplierPricingHistory, getSystemOverview, getUserPerformance, listApprovals, listBills, listBudgets, listCompanies, listContacts, listItemCategories, listItems, listProjects, listSuppliers, listUsers, patchBillInvoiceNumber, patchBillPayment, rejectBill, rejectBudget, rejectSupplier, removeBudgetItem, reorderBudgetItemsCli, updateBillFromPayload, updateBillStatus, updateBudgetCategory, updateBudgetCommissionFromPayload, updateBudgetDiscountFromPayload, updateBudgetFromPayload, updateBudgetItem, updateBudgetItemSupplierCli, updateBudgetStatus, updateCompanyFromPayload, updateContactPersonFromPayload, updateItemCategory, updateItemFromPayload, updateProjectFromPayload, updateProjectStatus, updateSupplierFromPayload, } from "./commands.js";
 import { getFlag, parseArgs } from "./parse-args.js";
 import { billStatusesForUpdateHelp, budgetStatusesForHelp, isBudgetStatusUpdate, parseApprovalTypeFlag, parseBillStatusForUpdate, parseCommaSeparatedBillStatuses, parseCommaSeparatedBudgetStatuses, parseCommaSeparatedIds, parseOptionalBillListSortBy, parseOptionalBillListSortDir, parseOptionalDashboardRole, parseOptionalDeals, parseOptionalErrorSeverity, parseOptionalErrorStatus, parseOptionalExtendedProjectStatus, parseOptionalFinancialRole, parseOptionalSupplierAnalyticsTimeFrame, parseOptionalTimeFrame, parseProjectStatusForUpdate, projectStatusesForHelp, } from "./parse-cli-enums.js";
 import { parseJsonFlag, parseOptionalNumber as parseOptNum, } from "./parse-json-flag.js";
@@ -44,6 +44,18 @@ function parseListBillsFlags(flags) {
         pageSize: parsePositiveIntFlag(getFlag(flags, "pageSize"), "--pageSize"),
     };
 }
+function parseDashboardQueryFlags(flags) {
+    const roleRaw = getFlag(flags, "role");
+    const timeFrameRaw = getFlag(flags, "timeFrame");
+    return {
+        userId: getFlag(flags, "userId"),
+        role: parseOptionalDashboardRole(roleRaw !== undefined ? String(roleRaw) : undefined),
+        deals: parseOptionalDeals(getFlag(flags, "deals")),
+        timeFrame: parseOptionalTimeFrame(timeFrameRaw !== undefined ? String(timeFrameRaw) : undefined),
+        startDate: getFlag(flags, "startDate"),
+        endDate: getFlag(flags, "endDate"),
+    };
+}
 function printHelp() {
     const help = `
 bb — Budget Builder CLI (parity with MCP tools)
@@ -61,15 +73,28 @@ Budgets
   get-budget-versions <budgetId>
   update-budget-status <id> <status>
     status: ${budgetStatusesForHelp.join(", ")}
+  create-budget              --payload '<json>'  (budget.createBudget; ISO dates for date/startTime/endTime)
+  update-budget              --payload '<json>'  (budget.updateBudget; must include id)
+  delete-budget <budgetId>
   create-budget-approval <budgetId>
   add-budget-items           --budgetId --items '[{"itemId":"…","quantity":1,"markup":30},…]'
   update-budget-item         --id <budgetItemId> [--description] [--note] [--quantity] [--markup] [--cost] [--unitPrice] [--isFreeOfCharge true|false] [--gstInclusive true|false]
   remove-budget-item <budgetItemId>
+  reorder-budget-items       <budgetId> --itemIds <csv>
+  update-budget-item-supplier --budgetItemId --supplierId
+  create-budget-category     --name <text>
+  update-budget-category     --id --name
+  delete-budget-category <id>
+  update-budget-commission   --payload '<json>'  (budget.updateBudgetCommission)
+  update-budget-discount     --payload '<json>'  (budget.updateBudgetDiscount; type percentage|amount)
 
 Bills
   list-bills                 [--projectId] [--budgetId] [--status CSV] [--search <text>] [--isClaimable true|false] [--createdByIds <csv>] [--sortBy createdAt|amount|status] [--sortDir asc|desc] [--page] [--pageSize]
   list-claims                same flags as list-bills; only reimbursable claims (ignores --isClaimable)
   create-bill-approval <billId>
+  create-bill                --payload '<json>'  (bill.create; attachments may be [])
+  update-bill                --payload '<json>'  (bill.update; must include id)
+  delete-bill <billId>
   update-bill-status <id> <status> [--rejectionReason] [--paymentTrackingUrl] [--paymentReference]
     status (${billStatusesForUpdateHelp.join(", ")}) — not PENDING_APPROVAL; use create-bill-approval
   patch-bill-payment <billId> [--paymentTrackingUrl] [--paymentReference] [--quickbooksBillId]
@@ -90,27 +115,49 @@ Companies & projects
   list-companies             [--name] [--createdBy] [--page] [--perPage]
   get-company <id>
   create-company             --name --website <url>
+  update-company             --payload '<json>'  (company.updateCompany; must include id, name, website)
+  delete-company <id>
   list-projects              [--companyId] [--name] [--status] [--page] [--perPage]
   get-project <id>
-  create-project             --name --companyId --contactPersonId --startDate <ISO> [--endDate] [--description]
+  create-project             --name --companyId --contactPersonId --startDate <ISO> [--endDate] [--description] [--requestQboAccountantNotification false]
+  update-project             --payload '<json>'  (project.updateProject; optional requestQboAccountantNotification; default notify like web)
+  delete-project <id>
   update-project-status <id> <status>
     status: ${projectStatusesForHelp.join(", ")}
 
 Contacts
   list-contacts <companyId>
+  create-contact-person      --payload '<json>'  (contactPerson.createContactPerson; title MR|MRS|MS|DR)
+  update-contact-person      --payload '<json>'  (contactPerson.updateContactPerson; must include id)
 
 Suppliers & items
   list-suppliers             [--name] [--page] [--perPage]
+  create-supplier            --payload '<json>'  (supplier.createSupplier)
+  update-supplier            --payload '<json>'  (supplier.updateSupplier; must include id)
+  delete-suppliers           --ids <csv>  (supplier.deleteSuppliers; admin)
+  create-certification       --name  (supplier.createCertification)
+  create-payment-method      --name  (supplier.createPaymentMethod)
+  create-supplier-role       --name  (supplier.createSupplierRole)
+  create-supplier-tag        --name  (supplier.createSupplierTag)
+  create-item                --payload '<json>'  (item.createItem)
+  update-item                --payload '<json>'  (item.updateItem; must include id)
+  delete-item <id>
   get-supplier-details <supplierId>
   get-supplier-analytics     [--name] [--page] [--perPage] [--timeFrame ALL|LAST_YEAR|…]
   list-items                 [--name] [--page] [--perPage]
   get-item <id>
   list-item-categories       [--page] [--perPage]
+  create-item-category       --name
+  update-item-category       --id --name
+  delete-item-categories     --ids <csv>  (itemCategory.deleteItemCategories; admin; empty categories only)
 
 Dashboard & users
   list-users
   get-user-performance       [--userId]
   get-dashboard              [--userId] [--role BD|CREATOR|INSIDE_SALES|ALL] [--deals ALL|SUCCESSFUL|LOST] [--timeFrame] [--startDate] [--endDate]
+  get-monthly-metrics        [same optional flags as get-dashboard]  (dashboard.getMonthlyMetrics)
+  get-system-overview        [same optional flags as get-dashboard]  (dashboard.getSystemOverview)
+  get-estimate-performance   [same optional flags as get-dashboard]  (dashboard.getEstimatePerformance)
   get-financial-overview     [same optional flags as dashboard; role uses BudgetRole enum]
 
 Errors
@@ -125,8 +172,9 @@ Historical / benchmarks
 
 Output: JSON to stdout. Errors to stderr; exit 1 on failure.
 
-MCP parity: every MCP tool maps to one command above. You may use MCP-style
-  snake_case (e.g. bb list_bills) — it is normalized to kebab-case.
+MCP parity: every MCP tool maps to one command above. The CLI also exposes
+  reorder-budget-items and update-budget-item-supplier (web UI–oriented tRPC).
+  You may use MCP-style snake_case (e.g. bb list_bills) — normalized to kebab-case.
 
 Note: MCP also exposes a Prisma schema resource; the CLI has no equivalent.
 
@@ -215,6 +263,31 @@ async function main() {
                 await createBudgetApproval(id);
                 break;
             }
+            case "create-budget": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("create-budget requires --payload '<json>'");
+                }
+                const raw = parseJsonFlag(String(payloadRaw), "--payload");
+                await createBudgetFromPayload(raw);
+                break;
+            }
+            case "update-budget": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("update-budget requires --payload '<json>'");
+                }
+                const raw = parseJsonFlag(String(payloadRaw), "--payload");
+                await updateBudgetFromPayload(raw);
+                break;
+            }
+            case "delete-budget": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("delete-budget requires <budgetId>");
+                await deleteBudgetById(id);
+                break;
+            }
             case "add-budget-items": {
                 const budgetId = getFlag(flags, "budgetId");
                 if (!budgetId)
@@ -247,6 +320,74 @@ async function main() {
                 await removeBudgetItem(id);
                 break;
             }
+            case "reorder-budget-items": {
+                const budgetId = positional[0];
+                const itemIdsRaw = getFlag(flags, "itemIds");
+                if (!budgetId || itemIdsRaw === undefined) {
+                    throw new Error("reorder-budget-items requires <budgetId> --itemIds <csv>");
+                }
+                const itemIds = parseCommaSeparatedIds(String(itemIdsRaw));
+                if (!itemIds?.length) {
+                    throw new Error("reorder-budget-items requires non-empty --itemIds <csv>");
+                }
+                await reorderBudgetItemsCli({ budgetId, itemIds });
+                break;
+            }
+            case "update-budget-item-supplier": {
+                const budgetItemId = getFlag(flags, "budgetItemId");
+                const supplierId = getFlag(flags, "supplierId");
+                if (!budgetItemId || !supplierId) {
+                    throw new Error("update-budget-item-supplier requires --budgetItemId and --supplierId");
+                }
+                await updateBudgetItemSupplierCli({
+                    budgetItemId: String(budgetItemId),
+                    supplierId: String(supplierId),
+                });
+                break;
+            }
+            case "create-budget-category": {
+                const name = getFlag(flags, "name");
+                if (!name) {
+                    throw new Error("create-budget-category requires --name");
+                }
+                await createBudgetCategory(String(name));
+                break;
+            }
+            case "update-budget-category": {
+                const id = getFlag(flags, "id");
+                const name = getFlag(flags, "name");
+                if (!id || !name) {
+                    throw new Error("update-budget-category requires --id and --name");
+                }
+                await updateBudgetCategory({ id: String(id), name: String(name) });
+                break;
+            }
+            case "delete-budget-category": {
+                const id = positional[0];
+                if (!id) {
+                    throw new Error("delete-budget-category requires <id>");
+                }
+                await deleteBudgetCategory(id);
+                break;
+            }
+            case "update-budget-commission": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("update-budget-commission requires --payload '<json>'");
+                }
+                const raw = parseJsonFlag(String(payloadRaw), "--payload");
+                await updateBudgetCommissionFromPayload(raw);
+                break;
+            }
+            case "update-budget-discount": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("update-budget-discount requires --payload '<json>'");
+                }
+                const raw = parseJsonFlag(String(payloadRaw), "--payload");
+                await updateBudgetDiscountFromPayload(raw);
+                break;
+            }
             case "list-bills": {
                 await listBills(parseListBillsFlags(flags));
                 break;
@@ -265,6 +406,31 @@ async function main() {
                 await createBillApproval(id);
                 break;
             }
+            case "create-bill": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("create-bill requires --payload '<json>'");
+                }
+                const raw = parseJsonFlag(String(payloadRaw), "--payload");
+                await createBillFromPayload(raw);
+                break;
+            }
+            case "update-bill": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("update-bill requires --payload '<json>'");
+                }
+                const raw = parseJsonFlag(String(payloadRaw), "--payload");
+                await updateBillFromPayload(raw);
+                break;
+            }
+            case "delete-bill": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("delete-bill requires <billId>");
+                await deleteBillById(id);
+                break;
+            }
             case "update-bill-status": {
                 const [id, statusRaw] = positional;
                 if (!id || !statusRaw) {
@@ -402,6 +568,22 @@ async function main() {
                 await createCompany({ name, website });
                 break;
             }
+            case "update-company": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("update-company requires --payload '<json>'");
+                }
+                const raw = parseJsonFlag(String(payloadRaw), "--payload");
+                await updateCompanyFromPayload(raw);
+                break;
+            }
+            case "delete-company": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("delete-company requires <id>");
+                await deleteCompanyById(id);
+                break;
+            }
             case "list-projects": {
                 const statusRaw = getFlag(flags, "status");
                 await listProjects({
@@ -435,9 +617,26 @@ async function main() {
                     startDate,
                     endDate: getFlag(flags, "endDate"),
                     description: getFlag(flags, "description"),
+                    requestQboAccountantNotification: parseOptionalBoolFlag(flags, "requestQboAccountantNotification"),
                 });
                 break;
             }
+            case "update-project": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("update-project requires --payload '<json>'");
+                }
+                const raw = parseJsonFlag(String(payloadRaw), "--payload");
+                await updateProjectFromPayload(raw);
+                break;
+            }
+            case "delete-project": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("delete-project requires <id>");
+                await deleteProjectById(id);
+                break;
+            }
             case "update-project-status": {
                 const [id, statusRaw] = positional;
                 if (!id || !statusRaw) {
@@ -453,6 +652,24 @@ async function main() {
                 await listContacts(id);
                 break;
             }
+            case "create-contact-person": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("create-contact-person requires --payload '<json>'");
+                }
+                const raw = parseJsonFlag(String(payloadRaw), "--payload");
+                await createContactPersonFromPayload(raw);
+                break;
+            }
+            case "update-contact-person": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("update-contact-person requires --payload '<json>'");
+                }
+                const raw = parseJsonFlag(String(payloadRaw), "--payload");
+                await updateContactPersonFromPayload(raw);
+                break;
+            }
             case "list-suppliers": {
                 await listSuppliers({
                     name: getFlag(flags, "name"),
@@ -461,6 +678,64 @@ async function main() {
                 });
                 break;
             }
+            case "create-supplier": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("create-supplier requires --payload '<json>'");
+                }
+                const raw = parseJsonFlag(String(payloadRaw), "--payload");
+                await createSupplierFromPayload(raw);
+                break;
+            }
+            case "update-supplier": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("update-supplier requires --payload '<json>'");
+                }
+                const raw = parseJsonFlag(String(payloadRaw), "--payload");
+                await updateSupplierFromPayload(raw);
+                break;
+            }
+            case "delete-suppliers": {
+                const idsRaw = getFlag(flags, "ids");
+                if (idsRaw === undefined) {
+                    throw new Error("delete-suppliers requires --ids <csv>");
+                }
+                const ids = parseCommaSeparatedIds(String(idsRaw));
+                if (!ids?.length) {
+                    throw new Error("delete-suppliers requires non-empty --ids");
+                }
+                await deleteSuppliersByIds(ids);
+                break;
+            }
+            case "create-certification": {
+                const name = getFlag(flags, "name");
+                if (!name)
+                    throw new Error("create-certification requires --name");
+                await createSupplierCertification(String(name));
+                break;
+            }
+            case "create-payment-method": {
+                const name = getFlag(flags, "name");
+                if (!name)
+                    throw new Error("create-payment-method requires --name");
+                await createSupplierPaymentMethod(String(name));
+                break;
+            }
+            case "create-supplier-role": {
+                const name = getFlag(flags, "name");
+                if (!name)
+                    throw new Error("create-supplier-role requires --name");
+                await createSupplierRoleOption(String(name));
+                break;
+            }
+            case "create-supplier-tag": {
+                const name = getFlag(flags, "name");
+                if (!name)
+                    throw new Error("create-supplier-tag requires --name");
+                await createSupplierTagOption(String(name));
+                break;
+            }
             case "get-supplier-analytics": {
                 const tfRaw = getFlag(flags, "timeFrame");
                 await getSupplierAnalytics({
@@ -486,6 +761,31 @@ async function main() {
                 await getItem(id);
                 break;
             }
+            case "create-item": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("create-item requires --payload '<json>'");
+                }
+                const raw = parseJsonFlag(String(payloadRaw), "--payload");
+                await createItemFromPayload(raw);
+                break;
+            }
+            case "update-item": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("update-item requires --payload '<json>'");
+                }
+                const raw = parseJsonFlag(String(payloadRaw), "--payload");
+                await updateItemFromPayload(raw);
+                break;
+            }
+            case "delete-item": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("delete-item requires <id>");
+                await deleteItemById(id);
+                break;
+            }
             case "list-item-categories": {
                 await listItemCategories({
                     page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
@@ -493,6 +793,34 @@ async function main() {
                 });
                 break;
             }
+            case "create-item-category": {
+                const name = getFlag(flags, "name");
+                if (!name)
+                    throw new Error("create-item-category requires --name");
+                await createItemCategory(String(name));
+                break;
+            }
+            case "update-item-category": {
+                const id = getFlag(flags, "id");
+                const name = getFlag(flags, "name");
+                if (!id || !name) {
+                    throw new Error("update-item-category requires --id and --name");
+                }
+                await updateItemCategory({ id: String(id), name: String(name) });
+                break;
+            }
+            case "delete-item-categories": {
+                const idsRaw = getFlag(flags, "ids");
+                if (idsRaw === undefined) {
+                    throw new Error("delete-item-categories requires --ids <csv>");
+                }
+                const ids = parseCommaSeparatedIds(String(idsRaw));
+                if (!ids?.length) {
+                    throw new Error("delete-item-categories requires non-empty --ids");
+                }
+                await deleteItemCategoriesByIds(ids);
+                break;
+            }
             case "list-users": {
                 await listUsers();
                 break;
@@ -502,14 +830,19 @@ async function main() {
                 break;
             }
             case "get-dashboard": {
-                await getDashboard({
-                    userId: getFlag(flags, "userId"),
-                    role: parseOptionalDashboardRole(getFlag(flags, "role")),
-                    deals: parseOptionalDeals(getFlag(flags, "deals")),
-                    timeFrame: parseOptionalTimeFrame(getFlag(flags, "timeFrame")),
-                    startDate: getFlag(flags, "startDate"),
-                    endDate: getFlag(flags, "endDate"),
-                });
+                await getDashboard(parseDashboardQueryFlags(flags));
+                break;
+            }
+            case "get-monthly-metrics": {
+                await getMonthlyMetrics(parseDashboardQueryFlags(flags));
+                break;
+            }
+            case "get-system-overview": {
+                await getSystemOverview(parseDashboardQueryFlags(flags));
+                break;
+            }
+            case "get-estimate-performance": {
+                await getEstimatePerformance(parseDashboardQueryFlags(flags));
                 break;
             }
             case "get-financial-overview": {

package/dist/parse-cli-enums.js

@@ -1,5 +1,5 @@
 import { BillStatus, BudgetStatus, ProjectStatus } from "@bb/db/enums";
-import { BudgetRole, Deals, ExtendedBillStatus, ExtendedErrorSeverity, ExtendedErrorStatus, ExtendedProjectStatus, TimeFrame, } from "@bb/utils/filter-enums";
+import { BudgetRole, Deals, ExtendedBillStatus, ExtendedErrorSeverity, ExtendedErrorStatus, ExtendedProjectStatus, TimeFrame, } from "./filter-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));

package/dist/parse-mutation-payload.js

@@ -0,0 +1,238 @@
+function requireObject(raw, label) {
+    if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+        throw new Error(`${label} must be a JSON object.`);
+    }
+    return raw;
+}
+function toDate(value, field) {
+    if (value instanceof Date && !Number.isNaN(value.getTime())) {
+        return value;
+    }
+    if (typeof value === "string") {
+        const d = new Date(value);
+        if (!Number.isNaN(d.getTime()))
+            return d;
+    }
+    throw new Error(`${field} must be an ISO date/datetime string.`);
+}
+function optionalString(v) {
+    if (v === undefined || v === null)
+        return undefined;
+    const s = String(v);
+    return s === "" ? undefined : s;
+}
+/** Required string fields: rejects null/undefined, whitespace-only, and avoids String(undefined) → "undefined" passing Zod .min(1). */
+function requiredString(value, fieldLabel) {
+    if (value === undefined || value === null) {
+        throw new Error(`${fieldLabel} is required.`);
+    }
+    const s = typeof value === "string" ? value : String(value);
+    const t = s.trim();
+    if (t === "") {
+        throw new Error(`${fieldLabel} is required.`);
+    }
+    return t;
+}
+/** Matches budget.createBudget — dates may be ISO strings in JSON. */
+export function parseCreateBudgetPayload(raw) {
+    const o = requireObject(raw, "create-budget payload");
+    return {
+        name: requiredString(o.name, "create-budget payload.name"),
+        date: toDate(o.date, "date"),
+        startTime: toDate(o.startTime, "startTime"),
+        endTime: toDate(o.endTime, "endTime"),
+        pax: requiredString(o.pax, "create-budget payload.pax"),
+        venue: requiredString(o.venue, "create-budget payload.venue"),
+        budget: requiredString(o.budget, "create-budget payload.budget"),
+        paymentTerm: requiredString(o.paymentTerm, "create-budget payload.paymentTerm"),
+        categoryId: requiredString(o.categoryId, "create-budget payload.categoryId"),
+        projectId: requiredString(o.projectId, "create-budget payload.projectId"),
+        insideSalesId: requiredString(o.insideSalesId, "create-budget payload.insideSalesId"),
+        businessDevelopmentId: requiredString(o.businessDevelopmentId, "create-budget payload.businessDevelopmentId"),
+        asanaTaskId: requiredString(o.asanaTaskId, "create-budget payload.asanaTaskId"),
+        sourceBudgetId: optionalString(o.sourceBudgetId),
+        pipedriveDealId: optionalString(o.pipedriveDealId),
+    };
+}
+/** Matches budget.updateBudget — same as create plus id. */
+export function parseUpdateBudgetPayload(raw) {
+    const o = requireObject(raw, "update-budget payload");
+    const id = requiredString(o.id, "update-budget payload.id");
+    const base = parseCreateBudgetPayload(raw);
+    return { ...base, id };
+}
+export function parseUpdateBudgetCommissionPayload(raw) {
+    const o = requireObject(raw, "update-budget-commission payload");
+    return {
+        budgetId: requiredString(o.budgetId, "update-budget-commission payload.budgetId"),
+        name: requiredString(o.name, "update-budget-commission payload.name"),
+        percentage: requiredString(o.percentage, "update-budget-commission payload.percentage"),
+        totalSellingAfterDiscount: Number(o.totalSellingAfterDiscount),
+    };
+}
+export function parseBudgetDiscountPayload(raw) {
+    const o = requireObject(raw, "update-budget-discount payload");
+    const type = o.type;
+    if (type !== "percentage" && type !== "amount") {
+        throw new Error('update-budget-discount payload.type must be "percentage" or "amount".');
+    }
+    return {
+        budgetId: requiredString(o.budgetId, "update-budget-discount payload.budgetId"),
+        name: requiredString(o.name, "update-budget-discount payload.name"),
+        type,
+        value: requiredString(o.value, "update-budget-discount payload.value"),
+        totalSellingBeforeDiscount: Number(o.totalSellingBeforeDiscount),
+    };
+}
+const billAttachment = (x, i) => {
+    const label = `create-bill payload.attachments[${i}]`;
+    const a = requireObject(x, label);
+    return {
+        id: requiredString(a.id, `${label}.id`),
+        name: requiredString(a.name, `${label}.name`),
+        key: requiredString(a.key, `${label}.key`),
+        size: Number(a.size),
+    };
+};
+/** Matches bill.create — invoiceDate may be ISO string; attachments default to []. */
+export function parseCreateBillPayload(raw) {
+    const o = requireObject(raw, "create-bill payload");
+    const isClaimable = o.isClaimable;
+    if (typeof isClaimable !== "boolean") {
+        throw new Error("create-bill payload.isClaimable must be boolean.");
+    }
+    const budgetItemIds = o.budgetItemIds;
+    if (!Array.isArray(budgetItemIds) || budgetItemIds.length === 0) {
+        throw new Error("create-bill payload.budgetItemIds must be a non-empty string array.");
+    }
+    const attachmentsRaw = o.attachments;
+    const attachments = Array.isArray(attachmentsRaw)
+        ? attachmentsRaw.map((x, i) => billAttachment(x, i))
+        : [];
+    let verificationResults;
+    const vr = o.verificationResults;
+    if (vr !== undefined && vr !== null) {
+        const v = requireObject(vr, "verificationResults");
+        verificationResults = {
+            status: v.status,
+            extractedAmount: v.extractedAmount === null || v.extractedAmount === undefined
+                ? null
+                : Number(v.extractedAmount),
+            difference: v.difference === null || v.difference === undefined
+                ? null
+                : Number(v.difference),
+            confidence: v.confidence === null || v.confidence === undefined
+                ? null
+                : Number(v.confidence),
+        };
+    }
+    const verificationStatus = o.verificationStatus;
+    let vs;
+    if (verificationStatus === "PENDING" ||
+        verificationStatus === "PASS" ||
+        verificationStatus === "FAIL" ||
+        verificationStatus === "MANUAL_REVIEW") {
+        vs = verificationStatus;
+    }
+    else if (verificationStatus !== undefined && verificationStatus !== null) {
+        throw new Error("create-bill payload.verificationStatus must be PENDING | PASS | FAIL | MANUAL_REVIEW.");
+    }
+    const amount = Number(o.amount);
+    if (!Number.isFinite(amount) || amount < 0) {
+        throw new Error("create-bill payload.amount must be a number >= 0.");
+    }
+    return {
+        budgetId: requiredString(o.budgetId, "create-bill payload.budgetId"),
+        projectId: requiredString(o.projectId, "create-bill payload.projectId"),
+        supplierId: requiredString(o.supplierId, "create-bill payload.supplierId"),
+        amount,
+        budgetItemIds: budgetItemIds.map((id, i) => requiredString(id, `create-bill payload.budgetItemIds[${i}]`)),
+        comment: optionalString(o.comment),
+        isClaimable,
+        attachments,
+        extractedSupplierName: optionalString(o.extractedSupplierName),
+        extractedAmount: o.extractedAmount === undefined || o.extractedAmount === null
+            ? undefined
+            : Number(o.extractedAmount),
+        invoiceNumber: o.invoiceNumber === undefined || o.invoiceNumber === null
+            ? ""
+            : typeof o.invoiceNumber === "string"
+                ? o.invoiceNumber
+                : String(o.invoiceNumber),
+        invoiceDate: o.invoiceDate === undefined || o.invoiceDate === null
+            ? undefined
+            : toDate(o.invoiceDate, "invoiceDate"),
+        verificationStatus: vs,
+        verificationResults,
+    };
+}
+/** Matches bill.update */
+export function parseUpdateBillPayload(raw) {
+    const o = requireObject(raw, "update-bill payload");
+    return {
+        ...parseCreateBillPayload(raw),
+        id: requiredString(o.id, "update-bill payload.id"),
+    };
+}
+/** Matches project.updateProject — dateRange.from/to may be ISO strings. */
+export function parseUpdateProjectPayload(raw) {
+    const o = requireObject(raw, "update-project payload");
+    const dr = o.dateRange;
+    if (dr === null || typeof dr !== "object" || Array.isArray(dr)) {
+        throw new Error("update-project payload.dateRange must be an object.");
+    }
+    const range = dr;
+    const notification = o.requestQboAccountantNotification;
+    let requestQboAccountantNotification;
+    if (typeof notification === "boolean") {
+        requestQboAccountantNotification = notification;
+    }
+    else if (notification !== undefined && notification !== null) {
+        throw new Error("update-project payload.requestQboAccountantNotification must be a boolean when set.");
+    }
+    return {
+        id: requiredString(o.id, "update-project payload.id"),
+        name: requiredString(o.name, "update-project payload.name"),
+        description: optionalString(o.description),
+        companyId: requiredString(o.companyId, "update-project payload.companyId"),
+        contactPersonId: requiredString(o.contactPersonId, "update-project payload.contactPersonId"),
+        dateRange: {
+            from: toDate(range.from, "dateRange.from"),
+            to: range.to === undefined || range.to === null
+                ? undefined
+                : toDate(range.to, "dateRange.to"),
+        },
+        ...(requestQboAccountantNotification !== undefined && {
+            requestQboAccountantNotification,
+        }),
+    };
+}
+/** Server validates with Zod; CLI only checks top-level shape is object. */
+export function parseSupplierCreatePayload(raw) {
+    requireObject(raw, "create-supplier payload");
+    return raw;
+}
+export function parseSupplierUpdatePayload(raw) {
+    requireObject(raw, "update-supplier payload");
+    return raw;
+}
+export function parseItemCreatePayload(raw) {
+    requireObject(raw, "create-item payload");
+    return raw;
+}
+export function parseItemUpdatePayload(raw) {
+    requireObject(raw, "update-item payload");
+    return raw;
+}
+export function parseContactCreatePayload(raw) {
+    requireObject(raw, "create-contact-person payload");
+    return raw;
+}
+export function parseContactUpdatePayload(raw) {
+    requireObject(raw, "update-contact-person payload");
+    return raw;
+}
+export function parseCompanyUpdatePayload(raw) {
+    requireObject(raw, "update-company payload");
+    return raw;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@go-labs-sg/bb",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Budget Builder CLI — list budgets, bills, approvals, suppliers; approve bills; change status. For AI agents (e.g. Chuck/OpenClaw).",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,7 +21,7 @@
     "postpack": "node scripts/restore-package-json.js"
   },
   "dependencies": {
-    "@trpc/client": "^11.15.0",
+    "@trpc/client": "^11.16.0",
     "dotenv": "^17.2.4",
     "superjson": "^2.2.6"
   },