@go-labs-sg/bb 1.0.3 → 1.1.0

package/dist/index.js

@@ -1,139 +1,584 @@
 #!/usr/bin/env node
-import "./load-env.js";
-import { requireApiKey } from "./api-client.js";
-import { approveBill, getBudget, listApprovals, listBills, listBudgets, listSuppliers, updateBudgetStatus, } from "./commands.js";
+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 { getFlag, parseArgs } from "./parse-args.js";
-const BUDGET_STATUSES = [
-    "DRAFT",
-    "PENDING_APPROVAL",
-    "APPROVED",
-    "REJECTED",
-    "ESTIMATE_CREATED",
-    "ESTIMATE_SENT",
-    "ESTIMATE_ACCEPTED",
-    "ESTIMATE_REJECTED",
-    "ESTIMATE_CLOSED",
-];
+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";
+function parsePositiveIntFlag(value, flagName) {
+    if (value === undefined)
+        return undefined;
+    const parsed = Number.parseInt(String(value), 10);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw new Error(`${flagName} must be a positive integer.`);
+    }
+    return parsed;
+}
+function parseOptionalBoolFlag(flags, key) {
+    const v = flags[key];
+    if (v === undefined || v === true)
+        return undefined;
+    const s = String(v).toLowerCase();
+    if (s === "true" || s === "1")
+        return true;
+    if (s === "false" || s === "0")
+        return false;
+    throw new Error(`--${key} must be true or false.`);
+}
+function parseListBillsFlags(flags) {
+    const statusRaw = getFlag(flags, "status");
+    const createdByIdsRaw = getFlag(flags, "createdByIds");
+    const searchRaw = getFlag(flags, "search");
+    const sortByRaw = getFlag(flags, "sortBy");
+    const sortDirRaw = getFlag(flags, "sortDir");
+    return {
+        projectId: getFlag(flags, "projectId"),
+        budgetId: getFlag(flags, "budgetId"),
+        statuses: parseCommaSeparatedBillStatuses(statusRaw !== undefined ? String(statusRaw) : undefined),
+        search: searchRaw !== undefined ? String(searchRaw) : undefined,
+        isClaimable: parseOptionalBoolFlag(flags, "isClaimable"),
+        createdByIds: parseCommaSeparatedIds(createdByIdsRaw !== undefined ? String(createdByIdsRaw) : undefined),
+        sortBy: parseOptionalBillListSortBy(sortByRaw !== undefined ? String(sortByRaw) : undefined),
+        sortDir: parseOptionalBillListSortDir(sortDirRaw !== undefined ? String(sortDirRaw) : undefined),
+        page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
+        pageSize: parsePositiveIntFlag(getFlag(flags, "pageSize"), "--pageSize"),
+    };
+}
 function printHelp() {
     const help = `
-bb — Budget Builder CLI (for AI agents / shell)
+bb — Budget Builder CLI (parity with MCP tools)
 
 Usage: bb <command> [options] [args]
 
 Auth: Set BB_API_KEY in the environment (same API key as MCP / Goracle).
 
-Commands:
-  list-budgets              List budgets (optional filters)
-    --projectId, --name, --status (comma-separated), --page, --perPage
+Budgets
+  list-budgets              [--projectId] [--name] [--status CSV] [--createdBy] [--dateFrom] [--dateTo] [--sortBy] [--sortDir] [--page] [--perPage]
+  get-budget <id>            Budget + line items
+  get-budget-items <id>      Line items only
+  get-budget-details <id>    Full detail (margins, suppliers, etc.)
+  get-budget-categories
+  get-budget-versions <budgetId>
+  update-budget-status <id> <status>
+    status: ${budgetStatusesForHelp.join(", ")}
+  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>
+
+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>
+  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]
+  patch-bill-invoice-number <billId> <invoiceNumber>
+  get-bill-attachments <billId>
+  get-bill-details <billId>
 
-  get-budget <id>            Get budget details + line items
+Approvals
+  list-approvals | get-pending-approvals   [--type budget|supplier|bill|all]
+  approve-bill <billId>
+  reject-bill <billId> --reason <text>
+  approve-budget <budgetId>
+  reject-budget <budgetId> --reason <text>
+  approve-supplier <supplierId>
+  reject-supplier <supplierId> --reason <text>
 
-  update-budget-status <id> <status>   Set budget status (e.g. APPROVED, REJECTED)
-    status: ${BUDGET_STATUSES.join(", ")}
+Companies & projects
+  list-companies             [--name] [--createdBy] [--page] [--perPage]
+  get-company <id>
+  create-company             --name --website <url>
+  list-projects              [--companyId] [--name] [--status] [--page] [--perPage]
+  get-project <id>
+  create-project             --name --companyId --contactPersonId --startDate <ISO> [--endDate] [--description]
+  update-project-status <id> <status>
+    status: ${projectStatusesForHelp.join(", ")}
 
-  list-bills                 List bills (optional filters)
-    --projectId, --budgetId, --status, --page, --pageSize
+Contacts
+  list-contacts <companyId>
 
-  approve-bill <id>          Approve a pending bill
+Suppliers & items
+  list-suppliers             [--name] [--page] [--perPage]
+  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]
 
-  list-approvals             List pending approvals
-    --type  budget | supplier | bill | all
+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-financial-overview     [same optional flags as dashboard; role uses BudgetRole enum]
 
-  list-suppliers             List suppliers
-    --name, --page, --perPage
+Errors
+  get-recent-errors          [--page] [--perPage] [--severity] [--status]
+  get-error-metrics
 
-Output: JSON to stdout. Errors to stderr and exit code 1.
-`;
-    console.log(help.trim());
+Historical / benchmarks
+  get-approved-budgets       [--projectId] [--limit] [--minRevenue] [--maxRevenue]
+  get-budget-category-benchmarks <categoryId> [--limit]
+  get-item-pricing-history   [--itemName] [--categoryId] [--supplierId] [--limit]
+  get-supplier-pricing-history <supplierId> [--itemCategoryId] [--limit]
+
+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.
+
+Note: MCP also exposes a Prisma schema resource; the CLI has no equivalent.
+
+Not covered vs MCP get_budget: "get-budget" also fetches line items in one call.
+`.trim();
+    console.log(help);
+}
+/** MCP registers tools with snake_case; CLI commands are kebab-case. */
+function normalizeCliCommand(raw) {
+    return raw.replace(/_/g, "-");
 }
 async function main() {
     const { command, positional, flags } = parseArgs(process.argv);
-    if (!command || command === "help" || flags.help === true) {
+    const cmd = normalizeCliCommand(command ?? "");
+    if (!cmd || cmd === "help" || flags.help === true) {
         printHelp();
         process.exit(0);
     }
     requireApiKey();
     try {
-        switch (command) {
+        switch (cmd) {
             case "list-budgets": {
                 const statusStr = getFlag(flags, "status");
+                const statuses = parseCommaSeparatedBudgetStatuses(statusStr !== undefined ? String(statusStr) : undefined);
                 await listBudgets({
                     projectId: getFlag(flags, "projectId"),
                     name: getFlag(flags, "name"),
-                    statuses: statusStr !== undefined
-                        ? String(statusStr)
-                            .split(",")
-                            .map((s) => s.trim())
-                        : undefined,
-                    page: getFlag(flags, "page", (s) => Number.parseInt(s, 10)),
-                    perPage: getFlag(flags, "perPage", (s) => Number.parseInt(s, 10)),
+                    statuses,
+                    createdBy: getFlag(flags, "createdBy"),
+                    dateFrom: getFlag(flags, "dateFrom"),
+                    dateTo: getFlag(flags, "dateTo"),
+                    sortBy: getFlag(flags, "sortBy"),
+                    sortDir: getFlag(flags, "sortDir"),
+                    page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
+                    perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage"),
                 });
                 break;
             }
             case "get-budget": {
                 const id = positional[0];
-                if (!id) {
-                    console.error(JSON.stringify({ error: "get-budget requires <id>" }));
-                    process.exit(1);
-                }
+                if (!id)
+                    throw new Error("get-budget requires <id>");
                 await getBudget(id);
                 break;
             }
+            case "get-budget-items": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("get-budget-items requires <budgetId>");
+                await getBudgetItemsOnly(id);
+                break;
+            }
+            case "get-budget-details": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("get-budget-details requires <budgetId>");
+                await getBudgetDetails(id);
+                break;
+            }
+            case "get-budget-categories": {
+                await getBudgetCategories();
+                break;
+            }
+            case "get-budget-versions": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("get-budget-versions requires <budgetId>");
+                await getBudgetVersions(id);
+                break;
+            }
             case "update-budget-status": {
                 const [id, status] = positional;
                 if (!id || !status) {
-                    console.error(JSON.stringify({
-                        error: "update-budget-status requires <id> <status>",
-                    }));
-                    process.exit(1);
+                    throw new Error("update-budget-status requires <id> <status>");
                 }
-                if (!BUDGET_STATUSES.includes(status)) {
-                    console.error(JSON.stringify({
-                        error: `Invalid status. Use one of: ${BUDGET_STATUSES.join(", ")}`,
-                    }));
-                    process.exit(1);
+                if (!isBudgetStatusUpdate(status)) {
+                    throw new Error(`Invalid status. Use one of: ${budgetStatusesForHelp.join(", ")}`);
                 }
                 await updateBudgetStatus(id, status);
                 break;
             }
+            case "create-budget-approval": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("create-budget-approval requires <budgetId>");
+                await createBudgetApproval(id);
+                break;
+            }
+            case "add-budget-items": {
+                const budgetId = getFlag(flags, "budgetId");
+                if (!budgetId)
+                    throw new Error("add-budget-items requires --budgetId");
+                const items = parseJsonFlag(String(getFlag(flags, "items")), "--items");
+                await addBudgetItems({ budgetId: String(budgetId), items });
+                break;
+            }
+            case "update-budget-item": {
+                const id = getFlag(flags, "id");
+                if (!id)
+                    throw new Error("update-budget-item requires --id");
+                await updateBudgetItem({
+                    id: String(id),
+                    description: getFlag(flags, "description"),
+                    note: getFlag(flags, "note"),
+                    quantity: parseOptNum(getFlag(flags, "quantity"), "--quantity"),
+                    markup: parseOptNum(getFlag(flags, "markup"), "--markup"),
+                    cost: parseOptNum(getFlag(flags, "cost"), "--cost"),
+                    unitPrice: parseOptNum(getFlag(flags, "unitPrice"), "--unitPrice"),
+                    isFreeOfCharge: parseOptionalBoolFlag(flags, "isFreeOfCharge"),
+                    gstInclusive: parseOptionalBoolFlag(flags, "gstInclusive"),
+                });
+                break;
+            }
+            case "remove-budget-item": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("remove-budget-item requires <budgetItemId>");
+                await removeBudgetItem(id);
+                break;
+            }
             case "list-bills": {
+                await listBills(parseListBillsFlags(flags));
+                break;
+            }
+            case "list-claims": {
                 await listBills({
-                    projectId: getFlag(flags, "projectId"),
-                    budgetId: getFlag(flags, "budgetId"),
-                    status: getFlag(flags, "status"),
-                    page: getFlag(flags, "page", (s) => Number.parseInt(s, 10)),
-                    pageSize: getFlag(flags, "pageSize", (s) => Number.parseInt(s, 10)),
+                    ...parseListBillsFlags(flags),
+                    isClaimable: true,
                 });
                 break;
             }
-            case "approve-bill": {
+            case "create-bill-approval": {
                 const id = positional[0];
-                if (!id) {
-                    console.error(JSON.stringify({ error: "approve-bill requires <id>" }));
-                    process.exit(1);
+                if (!id)
+                    throw new Error("create-bill-approval requires <billId>");
+                await createBillApproval(id);
+                break;
+            }
+            case "update-bill-status": {
+                const [id, statusRaw] = positional;
+                if (!id || !statusRaw) {
+                    throw new Error("update-bill-status requires <billId> <status> [--rejectionReason] [--paymentTrackingUrl] [--paymentReference]");
                 }
-                await approveBill(id);
+                const status = parseBillStatusForUpdate(statusRaw);
+                await updateBillStatus({
+                    id,
+                    status,
+                    rejectionReason: getFlag(flags, "rejectionReason"),
+                    paymentTrackingUrl: getFlag(flags, "paymentTrackingUrl"),
+                    paymentReference: getFlag(flags, "paymentReference"),
+                });
+                break;
+            }
+            case "patch-bill-payment": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("patch-bill-payment requires <billId>");
+                await patchBillPayment({
+                    id,
+                    paymentTrackingUrl: getFlag(flags, "paymentTrackingUrl"),
+                    paymentReference: getFlag(flags, "paymentReference"),
+                    quickbooksBillId: getFlag(flags, "quickbooksBillId"),
+                });
+                break;
+            }
+            case "patch-bill-invoice-number": {
+                const [id, inv] = positional;
+                if (!id || !inv) {
+                    throw new Error("patch-bill-invoice-number requires <billId> <invoiceNumber>");
+                }
+                await patchBillInvoiceNumber(id, inv);
                 break;
             }
-            case "list-approvals": {
+            case "get-bill-attachments": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("get-bill-attachments requires <billId>");
+                await getBillAttachments(id);
+                break;
+            }
+            case "get-bill-details": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("get-bill-details requires <billId>");
+                await getBillDetails(id);
+                break;
+            }
+            case "list-approvals":
+            case "get-pending-approvals": {
+                const typeRaw = getFlag(flags, "type");
                 await listApprovals({
-                    type: getFlag(flags, "type"),
+                    type: parseApprovalTypeFlag(typeRaw !== undefined ? String(typeRaw) : undefined),
                 });
                 break;
             }
+            case "approve-bill": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("approve-bill requires <billId>");
+                await approveBill(id);
+                break;
+            }
+            case "reject-bill": {
+                const id = positional[0];
+                const reason = getFlag(flags, "reason");
+                if (!id || reason === undefined) {
+                    throw new Error("reject-bill requires <billId> --reason <text>");
+                }
+                await rejectBill(id, reason);
+                break;
+            }
+            case "approve-budget": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("approve-budget requires <budgetId>");
+                await approveBudget(id);
+                break;
+            }
+            case "reject-budget": {
+                const id = positional[0];
+                const reason = getFlag(flags, "reason");
+                if (!id || reason === undefined) {
+                    throw new Error("reject-budget requires <budgetId> --reason <text>");
+                }
+                await rejectBudget(id, reason);
+                break;
+            }
+            case "approve-supplier": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("approve-supplier requires <supplierId>");
+                await approveSupplier(id);
+                break;
+            }
+            case "reject-supplier": {
+                const id = positional[0];
+                const reason = getFlag(flags, "reason");
+                if (!id || reason === undefined) {
+                    throw new Error("reject-supplier requires <supplierId> --reason <text>");
+                }
+                await rejectSupplier(id, reason);
+                break;
+            }
+            case "get-supplier-details": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("get-supplier-details requires <supplierId>");
+                await getSupplierDetails(id);
+                break;
+            }
+            case "list-companies": {
+                await listCompanies({
+                    name: getFlag(flags, "name"),
+                    createdBy: getFlag(flags, "createdBy"),
+                    page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
+                    perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage"),
+                });
+                break;
+            }
+            case "get-company": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("get-company requires <id>");
+                await getCompany(id);
+                break;
+            }
+            case "create-company": {
+                const name = getFlag(flags, "name");
+                const website = getFlag(flags, "website");
+                if (!name || !website) {
+                    throw new Error("create-company requires --name and --website <url>");
+                }
+                await createCompany({ name, website });
+                break;
+            }
+            case "list-projects": {
+                const statusRaw = getFlag(flags, "status");
+                await listProjects({
+                    companyId: getFlag(flags, "companyId"),
+                    name: getFlag(flags, "name"),
+                    status: parseOptionalExtendedProjectStatus(statusRaw !== undefined ? String(statusRaw) : undefined),
+                    page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
+                    perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage"),
+                });
+                break;
+            }
+            case "get-project": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("get-project requires <id>");
+                await getProject(id);
+                break;
+            }
+            case "create-project": {
+                const name = getFlag(flags, "name");
+                const companyId = getFlag(flags, "companyId");
+                const contactPersonId = getFlag(flags, "contactPersonId");
+                const startDate = getFlag(flags, "startDate");
+                if (!name || !companyId || !contactPersonId || !startDate) {
+                    throw new Error("create-project requires --name --companyId --contactPersonId --startDate (ISO)");
+                }
+                await createProject({
+                    name,
+                    companyId,
+                    contactPersonId,
+                    startDate,
+                    endDate: getFlag(flags, "endDate"),
+                    description: getFlag(flags, "description"),
+                });
+                break;
+            }
+            case "update-project-status": {
+                const [id, statusRaw] = positional;
+                if (!id || !statusRaw) {
+                    throw new Error("update-project-status requires <id> <status>");
+                }
+                await updateProjectStatus(id, parseProjectStatusForUpdate(statusRaw));
+                break;
+            }
+            case "list-contacts": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("list-contacts requires <companyId>");
+                await listContacts(id);
+                break;
+            }
             case "list-suppliers": {
                 await listSuppliers({
                     name: getFlag(flags, "name"),
-                    page: getFlag(flags, "page", (s) => Number.parseInt(s, 10)),
-                    perPage: getFlag(flags, "perPage", (s) => Number.parseInt(s, 10)),
+                    page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
+                    perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage"),
+                });
+                break;
+            }
+            case "get-supplier-analytics": {
+                const tfRaw = getFlag(flags, "timeFrame");
+                await getSupplierAnalytics({
+                    name: getFlag(flags, "name"),
+                    page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
+                    perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage"),
+                    timeFrame: parseOptionalSupplierAnalyticsTimeFrame(tfRaw !== undefined ? String(tfRaw) : undefined),
+                });
+                break;
+            }
+            case "list-items": {
+                await listItems({
+                    name: getFlag(flags, "name"),
+                    page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
+                    perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage"),
+                });
+                break;
+            }
+            case "get-item": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("get-item requires <id>");
+                await getItem(id);
+                break;
+            }
+            case "list-item-categories": {
+                await listItemCategories({
+                    page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
+                    perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage"),
+                });
+                break;
+            }
+            case "list-users": {
+                await listUsers();
+                break;
+            }
+            case "get-user-performance": {
+                await getUserPerformance(getFlag(flags, "userId"));
+                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"),
+                });
+                break;
+            }
+            case "get-financial-overview": {
+                await getFinancialOverview({
+                    userId: getFlag(flags, "userId"),
+                    role: parseOptionalFinancialRole(getFlag(flags, "role")),
+                    deals: parseOptionalDeals(getFlag(flags, "deals")),
+                    timeFrame: parseOptionalTimeFrame(getFlag(flags, "timeFrame")),
+                    startDate: getFlag(flags, "startDate"),
+                    endDate: getFlag(flags, "endDate"),
+                });
+                break;
+            }
+            case "get-recent-errors": {
+                await getRecentErrors({
+                    page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
+                    perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage"),
+                    severity: parseOptionalErrorSeverity(getFlag(flags, "severity")),
+                    status: parseOptionalErrorStatus(getFlag(flags, "status")),
+                });
+                break;
+            }
+            case "get-error-metrics": {
+                await getErrorMetrics();
+                break;
+            }
+            case "get-approved-budgets": {
+                await getApprovedBudgets({
+                    projectId: getFlag(flags, "projectId"),
+                    limit: parsePositiveIntFlag(getFlag(flags, "limit"), "--limit"),
+                    minRevenue: parseOptNum(getFlag(flags, "minRevenue"), "--minRevenue"),
+                    maxRevenue: parseOptNum(getFlag(flags, "maxRevenue"), "--maxRevenue"),
+                });
+                break;
+            }
+            case "get-budget-category-benchmarks": {
+                const id = positional[0];
+                if (!id) {
+                    throw new Error("get-budget-category-benchmarks requires <categoryId> [--limit]");
+                }
+                await getBudgetCategoryBenchmarks({
+                    categoryId: id,
+                    limit: parsePositiveIntFlag(getFlag(flags, "limit"), "--limit"),
+                });
+                break;
+            }
+            case "get-item-pricing-history": {
+                await getItemPricingHistory({
+                    itemName: getFlag(flags, "itemName"),
+                    categoryId: getFlag(flags, "categoryId"),
+                    supplierId: getFlag(flags, "supplierId"),
+                    limit: parsePositiveIntFlag(getFlag(flags, "limit"), "--limit"),
+                });
+                break;
+            }
+            case "get-supplier-pricing-history": {
+                const id = positional[0];
+                if (!id) {
+                    throw new Error("get-supplier-pricing-history requires <supplierId> [--itemCategoryId] [--limit]");
+                }
+                await getSupplierPricingHistory({
+                    supplierId: id,
+                    itemCategoryId: getFlag(flags, "itemCategoryId"),
+                    limit: parsePositiveIntFlag(getFlag(flags, "limit"), "--limit"),
                 });
                 break;
             }
             default: {
-                console.error(JSON.stringify({
-                    error: `Unknown command: ${command}. Run 'bb help'.`,
-                }));
-                process.exit(1);
+                throw new Error(`Unknown command: ${cmd}. Run 'bb help'.`);
             }
         }
     }