@go-labs-sg/bb 1.6.0 → 1.7.0

package/README.md

@@ -1,6 +1,10 @@
 # bb
 
-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.
+Command-line interface for **Budget Builder**. Call budgets, bills, claims, 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.
+
+For AI agents: bills and claims are stored as the same underlying bill records. Use the `isClaimable` column/flag to distinguish them: `isClaimable=false` means a normal bill, while `isClaimable=true` means a reimbursable claim.
+
+For AI agents using this CLI: always check whether a newer `@go-labs-sg/bb` version is available before running Budget Builder commands, then update the CLI if needed so command flags and API behavior stay current.
 
 **Registry:** [`@go-labs-sg/bb`](https://www.npmjs.com/package/@go-labs-sg/bb)
 
@@ -39,7 +43,7 @@ The CLI talks to the production API: `https://budget-builder.getout.events`.
 bb help
 bb list-budgets
 bb get-budget <budget-id>
-bb update-budget-status <budget-id> <status>
+bb update-budget-status <budget-id> <status> [--markProjectWon true]
 bb list-bills
 bb approve-bill <bill-id>
 bb list-approvals
@@ -56,12 +60,12 @@ Global options and flags use `--key=value` or `--key value` (see `bb help`).
 
 | Area | Commands (non-exhaustive) |
 | --- | --- |
-| **Budgets** | `list-budgets` (full payload by default; `--summary` or `--includeDetails false` for slim list), `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` (also sends approval request emails), `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), `upload-budget-attachment` (`<budgetId>` + local file path; uses `attachment.requestBudgetAttachmentUpload` + PUT + `attachment.confirmBudgetAttachment`) |
-| **Bills** | `list-bills`, `list-claims`, `create-bill` (`--payload`), `update-bill` (`--payload`), `delete-bill`, `create-bill-approval` (also sends approval request emails), `update-bill-status`, `patch-bill-payment` (PAID bills: `--paymentTrackingUrl`, `--paymentReference`, `--quickbooksBillId`, `--paymentDate` ISO; clear with `--clearPaymentTrackingUrl` / `--clearPaymentReference` / `--clearQuickbooksBillId` / `--clearPaymentDate` `true`), `patch-bill-invoice-number`, `get-bill-attachments`, `upload-bill-attachment` (`<billId>` + local path), `get-bill-details` |
+| **Budgets** | `list-budgets` (full payload by default; `--summary` or `--includeDetails false` for slim list), `get-budget`, `get-budget-items`, `get-budget-details`, `get-budget-categories`, `get-budget-versions`, `update-budget-status` (`--markProjectWon true` can move the parent project to `WON` for accepted/closed estimates), `mark-budget-won` (`<budgetId>` + proof file path; optional `--markProjectWon true`), `create-budget` / `update-budget` (`--payload`), `delete-budget`, `create-budget-approval` (also sends approval request emails), `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), `upload-budget-attachment` (`<budgetId>` + local file path; uses `attachment.requestBudgetAttachmentUpload` + PUT + `attachment.confirmBudgetAttachment`) |
+| **Bills / claims** | `list-bills` (`--isClaimable false` for bills, `--isClaimable true` for claims, omit for both), `list-claims` (claims only), `create-bill` (`--payload`; set `isClaimable=false` for a bill or `isClaimable=true` for a claim), `update-bill` (`--payload`), `delete-bill`, `create-bill-approval` (also sends approval request emails), `update-bill-status`, `patch-bill-payment` (PAID bills: `--paymentTrackingUrl`, `--paymentReference`, `--quickbooksBillId`, `--paymentDate` ISO; clear with `--clearPaymentTrackingUrl` / `--clearPaymentReference` / `--clearQuickbooksBillId` / `--clearPaymentDate` `true`), `patch-bill-invoice-number`, `get-bill-attachments`, `upload-bill-attachment` (`<billId>` + local path), `get-bill-details` |
 | **Approvals** | `list-approvals` / `get-pending-approvals`, `approve-bill` / `reject-bill` (send reply email), `approve-budget` / `reject-budget` (send reply email), `approve-supplier` / `reject-supplier` (send reply email) |
-| **Companies & projects** | `list-companies`, `get-company`, `create-company`, `update-company` (`--payload`), `delete-company`, `list-projects`, `get-project`, `create-project` (required: `--name`, `--companyId`, `--contactPersonId`, `--insideSalesId`, `--businessDevelopmentId`, `--venue`, `--pax`, `--asanaTaskId`, `--slackChannelId`, `--slackChannelUrl`, `--slackChannelName`, `--startDate` as ISO datetime for project/window start; optional `--endDate`; optional `--description`; optional `--requestQboAccountantNotification false` to skip QBO accountant emails), `update-project` (`--payload` with `dateRange.from` / `dateRange.to` for the project window; optional `requestQboAccountantNotification` in JSON), `delete-project`, `update-project-status` (`<id>` `<status>`: `PITCH` \| `WON` \| `COMPLETED` \| `LOST`; for `PITCH` → `WON` also pass `--projectManagerId` or `--projectManagerName`) |
+| **Companies & projects** | `list-companies`, `get-company`, `create-company`, `update-company` (`--payload`), `delete-company`, `list-projects`, `get-project`, `create-project` (required: `--name`, `--companyId`, `--contactPersonId`, `--insideSalesId`, `--businessDevelopmentId`, `--venue`, `--asanaTaskId`, `--slackChannelId`, `--slackChannelUrl`, `--slackChannelName`, `--startDate` as ISO datetime for project/window start; optional `--pax`; optional `--endDate`; optional `--description`; optional `--requestQboAccountantNotification false` to skip QBO accountant emails), `update-project` (`--payload` with `dateRange.from` / `dateRange.to` for the project window; optional `requestQboAccountantNotification` in JSON), `delete-project`, `update-project-status` (`<id>` `<status>`: `PITCH` \| `WON` \| `COMPLETED` \| `LOST`; for `PITCH` → `WON` also pass `--projectManagerId` or `--projectManagerName`; when marking `WON` without an accepted/closed budget or proof, pass `--wonOverrideReason`) |
 | **Contacts** | `list-contacts`, `create-contact-person` (`--payload`), `update-contact-person` (`--payload`) |
-| **Suppliers & items** | `list-suppliers`, `create-supplier` (`--payload`; when supplier status is `PENDING_APPROVAL`, also runs `supplier.createSupplierApproval` and `email.sendSupplierApprovalRequestEmail`), `update-supplier` (`--payload`; when supplier status is `PENDING_APPROVAL`, also runs `supplier.createSupplierApproval` and `email.sendSupplierApprovalRequestEmail`), `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) |
+| **Suppliers & items** | `list-suppliers` (defaults to active suppliers, `--perPage 10`, sorted by `createdAt` desc; supports `--name`, `--sortBy` for scalar supplier fields, `--sortDir`, `--createdBy`, `--gstRegistered`, `--status`, `--supplierTags`, `--active false` for archived suppliers), `create-supplier` (`--payload`; when supplier status is `PENDING_APPROVAL`, also runs `supplier.createSupplierApproval` and `email.sendSupplierApprovalRequestEmail`), `update-supplier` (`--payload`; when supplier status is `PENDING_APPROVAL`, also runs `supplier.createSupplierApproval` and `email.sendSupplierApprovalRequestEmail`), `delete-suppliers` (`--ids` CSV; admin; archives/deactivates related items), `reactivate-suppliers` (`--ids` CSV; admin; reactivates related items), `create-certification` / `create-payment-method` / `create-supplier-role` / `create-supplier-tag` (`--name`), `get-supplier-details` (includes `supplierApprovalSummary` for pending approvers, superseded approvers, and the actual responder/respondedAt metadata), `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` |

package/dist/commands.js

@@ -48,13 +48,13 @@ export async function getBudget(id) {
     ]);
     out({ budget, items });
 }
-export async function updateBudgetStatus(budgetId, status) {
-    if (status === "ESTIMATE_ACCEPTED") {
-        throw new Error("Use mark-budget-won <budgetId> <filePath> so proof upload is included before setting ESTIMATE_ACCEPTED.");
-    }
+export async function updateBudgetStatus(budgetId, status, opts) {
     const result = await api.budget.updateBudgetStatus.mutate({
         id: budgetId,
         status,
+        ...(opts?.markProjectWon !== undefined && {
+            markProjectWon: opts.markProjectWon,
+        }),
     });
     out(result);
 }
@@ -110,7 +110,7 @@ const runBudgetPreflight = async (budgetId, preflight) => {
             insideSalesId: project.insideSalesId ?? "",
             businessDevelopmentId: project.businessDevelopmentId ?? "",
             venue: project.venue ?? "",
-            pax: String(project.pax),
+            pax: String(project.pax ?? ""),
             ...(project.slackChannelId &&
                 project.slackChannelUrl &&
                 project.slackChannelName
@@ -217,8 +217,14 @@ export async function listApprovals(opts) {
 export async function listSuppliers(opts) {
     const result = await api.supplier.getSuppliers.query({
         page: opts.page ?? 1,
-        perPage: opts.perPage ?? 20,
+        perPage: opts.perPage ?? 10,
+        sort: opts.sort ?? [{ id: "createdAt", desc: true }],
         name: opts.name,
+        createdBy: opts.createdBy,
+        gstRegistered: opts.gstRegistered ?? null,
+        status: opts.status,
+        supplierTags: opts.supplierTags,
+        active: opts.active ?? true,
     });
     out(result);
 }
@@ -338,7 +344,7 @@ export async function uploadBudgetAttachmentFromPath(budgetId, filePath) {
     });
     out(confirmed);
 }
-export async function uploadBudgetWinProofFromPath(budgetId, filePath) {
+export async function uploadBudgetWinProofFromPath(budgetId, filePath, opts) {
     const buf = await readFile(filePath);
     const fileName = basename(filePath);
     const size = buf.byteLength;
@@ -364,11 +370,14 @@ export async function uploadBudgetWinProofFromPath(budgetId, filePath) {
     const result = await api.budget.updateBudgetStatus.mutate({
         id: budgetId,
         status: "ESTIMATE_ACCEPTED",
+        ...(opts?.markProjectWon !== undefined && {
+            markProjectWon: opts.markProjectWon,
+        }),
     });
     out(result);
 }
-export async function markBudgetWonWithProof(budgetId, filePath) {
-    await uploadBudgetWinProofFromPath(budgetId, filePath);
+export async function markBudgetWonWithProof(budgetId, filePath, opts) {
+    await uploadBudgetWinProofFromPath(budgetId, filePath, opts);
 }
 export async function getBillDetails(id) {
     const result = await api.bill.getById.query({ id });
@@ -508,6 +517,10 @@ export async function deleteSuppliersByIds(ids) {
     const result = await api.supplier.deleteSuppliers.mutate({ ids });
     out(result);
 }
+export async function reactivateSuppliersByIds(ids) {
+    const result = await api.supplier.reactivateSuppliers.mutate({ ids });
+    out(result);
+}
 export async function createSupplierCertification(name) {
     const result = await api.supplier.createCertification.mutate({ name });
     out(result);
@@ -742,7 +755,62 @@ export async function getSupplierDetails(supplierId) {
     const supplier = await api.supplier.getSupplierById.query({
         id: supplierId,
     });
-    out(supplier);
+    const respondedStatuses = new Set([
+        ExtendedApprovalStatus.APPROVED,
+        ExtendedApprovalStatus.REJECTED,
+    ]);
+    const latestRespondedApproval = [
+        ...supplier.approvals.filter((approval) => respondedStatuses.has(approval.status)),
+    ].sort((a, b) => new Date(b.respondedAt ?? b.updatedAt).getTime() -
+        new Date(a.respondedAt ?? a.updatedAt).getTime() ||
+        new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime())[0];
+    const pendingApprovals = supplier.approvals.filter((approval) => approval.status === ExtendedApprovalStatus.PENDING_APPROVAL);
+    const supersededApprovals = supplier.approvals.filter((approval) => approval.status === ExtendedApprovalStatus.SUPERSEDED);
+    const respondedByApproval = latestRespondedApproval ?? null;
+    const responseUser = respondedByApproval
+        ? (respondedByApproval.responder ?? respondedByApproval.approver)
+        : null;
+    out({
+        ...supplier,
+        supplierApprovalSummary: {
+            pendingApprovalCount: pendingApprovals.length,
+            pendingApprovers: pendingApprovals.map((approval) => ({
+                approvalId: approval.id,
+                approverId: approval.approverId,
+                name: approval.approver.name,
+                email: approval.approver.email,
+                createdAt: approval.createdAt,
+                updatedAt: approval.updatedAt,
+            })),
+            supersededApprovalCount: supersededApprovals.length,
+            supersededApprovers: supersededApprovals.map((approval) => ({
+                approvalId: approval.id,
+                approverId: approval.approverId,
+                name: approval.approver.name,
+                email: approval.approver.email,
+                respondedAt: approval.respondedAt,
+                responder: approval.responder
+                    ? {
+                        id: approval.responder.id,
+                        name: approval.responder.name,
+                        email: approval.responder.email,
+                    }
+                    : null,
+            })),
+            respondedBy: respondedByApproval && responseUser
+                ? {
+                    approvalId: respondedByApproval.id,
+                    status: respondedByApproval.status,
+                    approverId: respondedByApproval.approverId,
+                    responderId: respondedByApproval.responderId,
+                    name: responseUser.name,
+                    email: responseUser.email,
+                    respondedAt: respondedByApproval.respondedAt,
+                    updatedAt: respondedByApproval.updatedAt,
+                }
+                : null,
+        },
+    });
 }
 export async function approveSupplier(supplierId) {
     const notifications = await api.budget.getNotifications.query();
@@ -910,6 +978,9 @@ export async function updateProjectStatus(id, status, opts) {
         ...(opts?.projectManagerName && {
             projectManagerName: opts.projectManagerName,
         }),
+        ...(opts?.wonOverrideReason && {
+            wonOverrideReason: opts.wonOverrideReason,
+        }),
     });
     out(result);
 }

package/dist/index.js

@@ -2,9 +2,9 @@
 import "./load-env.js";
 import { requireApiKey } from "./api-client.js";
 import { consumeCliQuietFlags, logCliAction, sanitizeFlagsForTrace, setCliQuiet, shouldLogCliActions, } from "./cli-trace.js";
-import { addBudgetItems, approveBill, approveBudget, approveSupplier, createBillApproval, createBillFromPayload, createBudgetApproval, createBudgetCategory, createBudgetFromPayload, createCompany, createContactPersonFromPayload, createEstimate, 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, markBudgetWonWithProof, patchBillInvoiceNumber, patchBillPayment, rejectBill, rejectBudget, rejectSupplier, removeBudgetItem, reorderBudgetItemsCli, updateBillFromPayload, updateBillStatus, updateBudgetCategory, updateBudgetCommissionFromPayload, updateBudgetDiscountFromPayload, updateBudgetFromPayload, updateBudgetItem, updateBudgetItemSupplierCli, updateBudgetStatus, updateCompanyFromPayload, updateContactPersonFromPayload, updateItemCategory, updateItemFromPayload, updateProjectFromPayload, updateProjectStatus, updateSupplierFromPayload, uploadBillAttachmentFromPath, uploadBudgetAttachmentFromPath, } from "./commands.js";
+import { addBudgetItems, approveBill, approveBudget, approveSupplier, createBillApproval, createBillFromPayload, createBudgetApproval, createBudgetCategory, createBudgetFromPayload, createCompany, createContactPersonFromPayload, createEstimate, 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, markBudgetWonWithProof, patchBillInvoiceNumber, patchBillPayment, reactivateSuppliersByIds, rejectBill, rejectBudget, rejectSupplier, removeBudgetItem, reorderBudgetItemsCli, updateBillFromPayload, updateBillStatus, updateBudgetCategory, updateBudgetCommissionFromPayload, updateBudgetDiscountFromPayload, updateBudgetFromPayload, updateBudgetItem, updateBudgetItemSupplierCli, updateBudgetStatus, updateCompanyFromPayload, updateContactPersonFromPayload, updateItemCategory, updateItemFromPayload, updateProjectFromPayload, updateProjectStatus, updateSupplierFromPayload, uploadBillAttachmentFromPath, uploadBudgetAttachmentFromPath, } 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 { billStatusesForUpdateHelp, budgetStatusesForHelp, isBudgetStatusUpdate, parseApprovalTypeFlag, parseBillStatusForUpdate, parseCommaSeparatedBillStatuses, parseCommaSeparatedBudgetStatuses, parseCommaSeparatedIds, parseCommaSeparatedSupplierStatuses, 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)
@@ -45,6 +45,45 @@ function parseListBillsFlags(flags) {
         pageSize: parsePositiveIntFlag(getFlag(flags, "pageSize"), "--pageSize"),
     };
 }
+const SUPPLIER_SORT_FIELDS = [
+    "createdAt",
+    "updatedAt",
+    "name",
+    "email",
+    "phone",
+    "gstRegistered",
+    "status",
+    "active",
+];
+function parseOptionalSupplierSortBy(raw) {
+    if (raw === undefined || raw === "")
+        return undefined;
+    if (!SUPPLIER_SORT_FIELDS.includes(raw)) {
+        throw new Error(`Invalid --sortBy "${raw}". Use one of: ${SUPPLIER_SORT_FIELDS.join(", ")}.`);
+    }
+    return raw;
+}
+function parseListSuppliersFlags(flags) {
+    const createdByRaw = getFlag(flags, "createdBy");
+    const statusRaw = getFlag(flags, "status");
+    const supplierTagsRaw = getFlag(flags, "supplierTags");
+    const sortBy = parseOptionalSupplierSortBy(getFlag(flags, "sortBy"));
+    const sortDirRaw = getFlag(flags, "sortDir");
+    const sortDir = parseOptionalBillListSortDir(sortDirRaw !== undefined ? String(sortDirRaw) : undefined);
+    return {
+        name: getFlag(flags, "name"),
+        page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
+        perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage"),
+        sort: sortBy !== undefined || sortDir !== undefined
+            ? [{ id: sortBy ?? "createdAt", desc: (sortDir ?? "desc") === "desc" }]
+            : undefined,
+        createdBy: parseCommaSeparatedIds(createdByRaw !== undefined ? String(createdByRaw) : undefined),
+        gstRegistered: parseOptionalBoolFlag(flags, "gstRegistered"),
+        status: parseCommaSeparatedSupplierStatuses(statusRaw !== undefined ? String(statusRaw) : undefined),
+        supplierTags: parseCommaSeparatedIds(supplierTagsRaw !== undefined ? String(supplierTagsRaw) : undefined),
+        active: parseOptionalBoolFlag(flags, "active"),
+    };
+}
 function parseDashboardQueryFlags(flags) {
     const roleRaw = getFlag(flags, "role");
     const timeFrameRaw = getFlag(flags, "timeFrame");
@@ -59,7 +98,7 @@ function parseDashboardQueryFlags(flags) {
 }
 function printHelp() {
     const help = `
-bb — Budget Builder CLI (parity with MCP tools)
+bb — Budget Builder CLI for AI agents (parity with MCP tools)
 
 Usage: bb <command> [options] [args]
 
@@ -74,9 +113,9 @@ Budgets
   get-budget-details <id>    Full detail (margins, suppliers, etc.)
   get-budget-categories
   get-budget-versions <budgetId>
-  update-budget-status <id> <status>
+  update-budget-status <id> <status> [--markProjectWon true|false]
     status: ${budgetStatusesForHelp.join(", ")}
-  mark-budget-won <budgetId> <filePath>   Upload signed quote/PO proof and set status to ESTIMATE_ACCEPTED
+  mark-budget-won <budgetId> <filePath> [--markProjectWon true|false]   Upload signed quote/PO proof and set status to ESTIMATE_ACCEPTED
   create-budget              --payload '<json>'  (budget.createBudget; Asana deal card is on the project)
   update-budget              --payload '<json>'  (budget.updateBudget; must include id)
   delete-budget <budgetId>
@@ -97,8 +136,9 @@ Budgets
 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)
+    isClaimable differentiates the shared bill/claim records: false = bill, true = claim.
   create-bill-approval <billId>       (also sends approval request emails)
-  create-bill                --payload '<json>'  (bill.create; use upload-bill-attachment after create to add files)
+  create-bill                --payload '<json>'  (bill.create; payload.isClaimable false = bill, true = claim; use upload-bill-attachment after create to add files)
   update-bill                --payload '<json>'  (bill.update; must include id)
   delete-bill <billId>
   update-bill-status <id> <status> [--rejectionReason] [--paymentTrackingUrl] [--paymentReference]
@@ -127,11 +167,12 @@ Companies & projects
   delete-company <id>
   list-projects              [--companyId] [--name] [--status] [--page] [--perPage]
   get-project <id>
-  create-project             --name --companyId --contactPersonId --insideSalesId --businessDevelopmentId --venue --pax --asanaTaskId --slackChannelId --slackChannelUrl --slackChannelName --startDate <ISO> [--endDate <ISO>] [--description] [--requestQboAccountantNotification false]
+  create-project             --name --companyId --contactPersonId --insideSalesId --businessDevelopmentId --venue --asanaTaskId --slackChannelId --slackChannelUrl --slackChannelName --startDate <ISO> [--pax] [--endDate <ISO>] [--description] [--requestQboAccountantNotification false]
   update-project             --payload '<json>'  (project.updateProject; optional requestQboAccountantNotification; default notify like web)
   delete-project <id>
-  update-project-status <id> <status> [--projectManagerId <id>] [--projectManagerName <name>]
+  update-project-status <id> <status> [--projectManagerId <id>] [--projectManagerName <name>] [--wonOverrideReason <text>]
     Required when moving PITCH → WON: supply --projectManagerId or --projectManagerName.
+    Required when moving to WON without accepted/closed budget or win proof: --wonOverrideReason (10+ chars).
     status: ${projectStatusesForHelp.join(", ")}
 
 Contacts
@@ -140,10 +181,12 @@ Contacts
   update-contact-person      --payload '<json>'  (contactPerson.updateContactPerson; must include id)
 
 Suppliers & items
-  list-suppliers             [--name] [--page] [--perPage]
+  list-suppliers             [--name] [--page] [--perPage] [--sortBy createdAt|updatedAt|name|email|phone|gstRegistered|status|active] [--sortDir asc|desc] [--createdBy <csv>] [--gstRegistered true|false] [--status CSV] [--supplierTags <csv>] [--active true|false]
+    Defaults: --active true, --perPage 10, --sortBy createdAt, --sortDir desc (same as the web list); pass --active false for archived suppliers.
   create-supplier            --payload '<json>'  (supplier.createSupplier; auto-requests approval + emails when status is PENDING_APPROVAL)
   update-supplier            --payload '<json>'  (supplier.updateSupplier; must include id; auto-requests approval + emails when status is PENDING_APPROVAL)
-  delete-suppliers           --ids <csv>  (supplier.deleteSuppliers; admin)
+  delete-suppliers           --ids <csv>  (supplier.deleteSuppliers; admin; archives/deactivates supplier items)
+  reactivate-suppliers       --ids <csv>  (supplier.reactivateSuppliers; admin; reactivates supplier items)
   create-certification       --name  (supplier.createCertification)
   create-payment-method      --name  (supplier.createPaymentMethod)
   create-supplier-role       --name  (supplier.createSupplierRole)
@@ -256,7 +299,9 @@ async function main() {
                 if (!budgetId || !filePath) {
                     throw new Error("mark-budget-won requires <budgetId> <filePath>");
                 }
-                await markBudgetWonWithProof(budgetId, filePath);
+                await markBudgetWonWithProof(budgetId, filePath, {
+                    markProjectWon: parseOptionalBoolFlag(flags, "markProjectWon"),
+                });
                 break;
             }
             case "get-budget-items": {
@@ -292,7 +337,9 @@ async function main() {
                 if (!isBudgetStatusUpdate(status)) {
                     throw new Error(`Invalid status. Use one of: ${budgetStatusesForHelp.join(", ")}`);
                 }
-                await updateBudgetStatus(id, status);
+                await updateBudgetStatus(id, status, {
+                    markProjectWon: parseOptionalBoolFlag(flags, "markProjectWon"),
+                });
                 break;
             }
             case "create-budget-approval": {
@@ -750,13 +797,12 @@ async function main() {
                     !insideSalesId ||
                     !businessDevelopmentId ||
                     !venue ||
-                    !pax ||
                     !asanaTaskId ||
                     !slackChannelId ||
                     !slackChannelUrl ||
                     !slackChannelName ||
                     !startDate) {
-                    throw new Error("create-project requires --name --companyId --contactPersonId --insideSalesId --businessDevelopmentId --venue --pax --asanaTaskId --slackChannelId --slackChannelUrl --slackChannelName --startDate (ISO/datetime flags as appropriate); optional --endDate");
+                    throw new Error("create-project requires --name --companyId --contactPersonId --insideSalesId --businessDevelopmentId --venue --asanaTaskId --slackChannelId --slackChannelUrl --slackChannelName --startDate (ISO/datetime flags as appropriate); optional --pax and --endDate");
                 }
                 await createProject({
                     name,
@@ -800,9 +846,13 @@ async function main() {
                 }
                 const pmIdFlag = getFlag(flags, "projectManagerId");
                 const pmNameFlag = getFlag(flags, "projectManagerName");
+                const wonOverrideReasonFlag = getFlag(flags, "wonOverrideReason");
                 await updateProjectStatus(id, parseProjectStatusForUpdate(statusRaw), {
                     ...(pmIdFlag && { projectManagerId: String(pmIdFlag) }),
                     ...(pmNameFlag && { projectManagerName: String(pmNameFlag) }),
+                    ...(wonOverrideReasonFlag && {
+                        wonOverrideReason: String(wonOverrideReasonFlag),
+                    }),
                 });
                 break;
             }
@@ -832,11 +882,7 @@ async function main() {
                 break;
             }
             case "list-suppliers": {
-                await listSuppliers({
-                    name: getFlag(flags, "name"),
-                    page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
-                    perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage"),
-                });
+                await listSuppliers(parseListSuppliersFlags(flags));
                 break;
             }
             case "create-supplier": {
@@ -869,6 +915,18 @@ async function main() {
                 await deleteSuppliersByIds(ids);
                 break;
             }
+            case "reactivate-suppliers": {
+                const idsRaw = getFlag(flags, "ids");
+                if (idsRaw === undefined) {
+                    throw new Error("reactivate-suppliers requires --ids <csv>");
+                }
+                const ids = parseCommaSeparatedIds(String(idsRaw));
+                if (!ids?.length) {
+                    throw new Error("reactivate-suppliers requires non-empty --ids");
+                }
+                await reactivateSuppliersByIds(ids);
+                break;
+            }
             case "create-certification": {
                 const name = getFlag(flags, "name");
                 if (!name)

package/dist/parse-cli-enums.js

@@ -1,4 +1,4 @@
-import { BudgetRole, Deals, ExtendedBillStatus, ExtendedErrorSeverity, ExtendedErrorStatus, ExtendedProjectStatus, TimeFrame, } from "./filter-enums.js";
+import { BudgetRole, Deals, ExtendedApprovalStatus, ExtendedBillStatus, ExtendedErrorSeverity, ExtendedErrorStatus, ExtendedProjectStatus, TimeFrame, } from "./filter-enums.js";
 import { BillStatus, BudgetStatus, ProjectStatus } from "./prisma-enums.js";
 const BUDGET_STATUS_VALUES = new Set(Object.values(BudgetStatus));
 const BILL_STATUS_VALUES = new Set(Object.values(BillStatus));
@@ -20,6 +20,7 @@ const SUPPLIER_ANALYTICS_TF = new Set([
     "LAST_3_MONTHS",
     "CUSTOM",
 ]);
+const SUPPLIER_APPROVAL_STATUS_VALUES = new Set(Object.values(ExtendedApprovalStatus));
 const EXT_ERROR_SEVERITY_VALUES = new Set(Object.values(ExtendedErrorSeverity));
 const EXT_ERROR_STATUS_VALUES = new Set(Object.values(ExtendedErrorStatus));
 export function isBudgetStatusListToken(s) {
@@ -144,6 +145,24 @@ export function parseCommaSeparatedBudgetStatuses(raw) {
     }
     return out;
 }
+export function parseCommaSeparatedSupplierStatuses(raw) {
+    if (raw === undefined)
+        return undefined;
+    const parts = raw
+        .split(",")
+        .map((x) => x.trim())
+        .filter(Boolean);
+    if (parts.length === 0)
+        return undefined;
+    const out = [];
+    for (const p of parts) {
+        if (!SUPPLIER_APPROVAL_STATUS_VALUES.has(p)) {
+            throw new Error(`Invalid supplier approval status "${p}". Use one of: ${[...SUPPLIER_APPROVAL_STATUS_VALUES].join(", ")}.`);
+        }
+        out.push(p);
+    }
+    return out;
+}
 export function parseBillStatusFlag(raw) {
     if (raw === undefined)
         return undefined;

package/dist/parse-mutation-payload.js

@@ -214,7 +214,7 @@ export function parseUpdateProjectPayload(raw) {
         insideSalesId: requiredString(o.insideSalesId, "update-project payload.insideSalesId"),
         businessDevelopmentId: requiredString(o.businessDevelopmentId, "update-project payload.businessDevelopmentId"),
         venue: requiredString(o.venue, "update-project payload.venue"),
-        pax: requiredString(o.pax, "update-project payload.pax"),
+        pax: optionalString(o.pax),
         dateRange: {
             from: toDate(range.from, "dateRange.from"),
             to: range.to === undefined || range.to === null

package/dist/prisma-enums.js

@@ -27,6 +27,7 @@ export const ApprovalStatus = {
     PENDING_APPROVAL: "PENDING_APPROVAL",
     APPROVED: "APPROVED",
     REJECTED: "REJECTED",
+    SUPERSEDED: "SUPERSEDED",
 };
 export const ApprovalType = {
     BUDGET: "BUDGET",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@go-labs-sg/bb",
-  "version": "1.6.0",
-  "description": "Budget Builder CLI — list budgets, bills, approvals, suppliers; approve bills; change status. For AI agents (e.g. Chuck/OpenClaw).",
+  "version": "1.7.0",
+  "description": "Budget Builder CLI for AI agents — manage budgets, bills, and claims; bill records use isClaimable=false for bills and isClaimable=true for claims.",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {