@go-labs-sg/bb 1.2.0 → 1.2.2

package/README.md

@@ -56,8 +56,8 @@ Global options and flags use `--key=value` or `--key value` (see `bb help`).
 
 | Area | Commands (non-exhaustive) |
 | --- | --- |
-| **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` |
+| **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`, `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`, `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`, `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`) |
@@ -70,6 +70,7 @@ Global options and flags use `--key=value` or `--key value` (see `bb help`).
 
 - **Stdout:** JSON (pretty-printed)
 - **Stderr:** Error objects as JSON on failure
+- **Action logs (default on):** Each run logs to **stderr**: (1) JSON lines for command start, then `ok` or `error` with `durationMs` (`--payload` and similar flags are redacted); (2) tRPC lines for every API procedure (path, timing). **Stdout** stays JSON-only for piping (e.g. `| jq`). Suppress with `--quiet`, `-q`, or `BB_CLI_QUIET=1`.
 - **Exit code:** `0` on success, `1` on error
 
 A `.env` file in the **current working directory** is loaded automatically (for `BB_API_KEY`, etc.).
@@ -93,8 +94,9 @@ 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.
+- **`src/prisma-enums.ts`** — Prisma enum string values for runtime; mirror `packages/db/src/generated/prisma/enums.ts` after schema changes.
+- **`src/filter-enums.ts`** — “extended” filter enums (ALL + Prisma enums). 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).
+`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`). Prisma enum **values** used at runtime live in `src/prisma-enums.ts` (kept in sync with `packages/db` generated enums) so npm installs do not need `@bb/db`.

package/dist/api-client.js

@@ -1,5 +1,6 @@
-import { createTRPCProxyClient, httpBatchLink } from "@trpc/client";
+import { createTRPCProxyClient, httpBatchLink, loggerLink } from "@trpc/client";
 import SuperJSON from "superjson";
+import { shouldLogCliActions } from "./cli-trace.js";
 const BASE_URL = "https://budget-builder.getout.events";
 function getAuthHeader() {
     const key = process.env.BB_API_KEY;
@@ -9,6 +10,16 @@ function getAuthHeader() {
 }
 export const api = createTRPCProxyClient({
     links: [
+        loggerLink({
+            enabled: () => shouldLogCliActions(),
+            colorMode: "ansi",
+            withContext: false,
+            // tRPC defaults use console.log for requests; stderr keeps stdout JSON-safe for pipes.
+            console: {
+                log: (...args) => console.error(...args),
+                error: (...args) => console.error(...args),
+            },
+        }),
         httpBatchLink({
             url: `${BASE_URL}/api/trpc`,
             transformer: SuperJSON,

package/dist/cli-trace.js

@@ -0,0 +1,51 @@
+/**
+ * Action logging for the CLI (default on).
+ * - Lifecycle: `logCliAction` in index (command + timing).
+ * - Per API call: tRPC `loggerLink` in api-client when `shouldLogCliActions()`.
+ * Logs go to stderr so stdout stays JSON for piping. Use `--quiet` / `-q` / BB_CLI_QUIET=1 to silence.
+ */
+let cliQuietSession = false;
+/** Call from main after `consumeCliQuietFlags`. */
+export const setCliQuiet = (quiet) => {
+    cliQuietSession = quiet;
+};
+export const isCliQuiet = () => cliQuietSession || process.env.BB_CLI_QUIET === "1";
+export const shouldLogCliActions = () => !isCliQuiet();
+const SENSITIVE_FLAG = new Set([
+    "payload",
+    "apikey",
+    "bb_api_key",
+    "token",
+    "password",
+    "secret",
+    "authorization",
+]);
+export const sanitizeFlagsForTrace = (flags) => {
+    const out = {};
+    for (const [k, v] of Object.entries(flags)) {
+        const lower = k.toLowerCase();
+        if (SENSITIVE_FLAG.has(lower) ||
+            lower.includes("secret") ||
+            lower.includes("password")) {
+            out[k] =
+                typeof v === "string" ? `[redacted ${v.length} chars]` : "[redacted]";
+        }
+        else {
+            out[k] = v;
+        }
+    }
+    return out;
+};
+export const consumeCliQuietFlags = (flags) => {
+    const fromEnv = process.env.BB_CLI_QUIET === "1";
+    const fromFlags = flags.quiet === true || flags.q === true;
+    delete flags.quiet;
+    delete flags.q;
+    return fromEnv || fromFlags;
+};
+/** stderr so stdout remains JSON-only for pipes (same intent as “log what the CLI is doing”). */
+export const logCliAction = (record) => {
+    if (!shouldLogCliActions())
+        return;
+    console.error("[bb]", JSON.stringify({ ...record, ts: new Date().toISOString() }));
+};

package/dist/commands.js

@@ -1,3 +1,6 @@
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
+import { contentType } from "mime-types";
 import { api } from "./api-client.js";
 import { BudgetRole, Deals, ExtendedApprovalStatus, ExtendedApprovalType, ExtendedBudgetStatus, TimeFrame, } from "./filter-enums.js";
 import { billStatusesForApi, } from "./parse-cli-enums.js";
@@ -11,6 +14,11 @@ function isPendingRequest(n) {
 const out = (data) => {
     console.log(JSON.stringify(data, null, 2));
 };
+/** Extension-based MIME, like browser `File.type` when the OS provides it */
+const contentTypeHeaderForFileName = (fileName) => {
+    const ct = contentType(fileName);
+    return typeof ct === "string" ? ct : "application/octet-stream";
+};
 export async function listBudgets(opts) {
     const input = {
         projectId: opts.projectId,
@@ -23,6 +31,7 @@ export async function listBudgets(opts) {
         sortDir: opts.sortDir,
         page: opts.page ?? 1,
         perPage: opts.perPage ?? 20,
+        includeDetails: opts.includeDetails ?? true,
     };
     const result = await api.budget.getAllBudgets.query(input);
     out(result);
@@ -141,12 +150,22 @@ export async function updateBillStatus(opts) {
     out(result);
 }
 export async function patchBillPayment(opts) {
-    const result = await api.bill.patchPayment.mutate({
-        id: opts.id,
-        paymentTrackingUrl: opts.paymentTrackingUrl,
-        paymentReference: opts.paymentReference,
-        quickbooksBillId: opts.quickbooksBillId,
-    });
+    const input = { id: opts.id };
+    if (opts.paymentTrackingUrl !== undefined)
+        input.paymentTrackingUrl = opts.paymentTrackingUrl;
+    if (opts.paymentReference !== undefined)
+        input.paymentReference = opts.paymentReference;
+    if (opts.quickbooksBillId !== undefined)
+        input.quickbooksBillId = opts.quickbooksBillId;
+    if (opts.paymentDate !== undefined) {
+        input.paymentDate =
+            opts.paymentDate === null
+                ? null
+                : typeof opts.paymentDate === "string"
+                    ? new Date(opts.paymentDate)
+                    : opts.paymentDate;
+    }
+    const result = await api.bill.patchPayment.mutate(input);
     out(result);
 }
 export async function patchBillInvoiceNumber(id, invoiceNumber) {
@@ -160,6 +179,56 @@ export async function getBillAttachments(id) {
     const result = await api.bill.getAttachments.query({ id });
     out(result);
 }
+export async function uploadBillAttachmentFromPath(billId, filePath) {
+    const buf = await readFile(filePath);
+    const fileName = basename(filePath);
+    const size = buf.byteLength;
+    const { uploadUrl, key } = await api.attachment.requestBillAttachmentUpload.mutate({
+        billId,
+        fileName,
+        size,
+    });
+    const res = await fetch(uploadUrl, {
+        method: "PUT",
+        body: buf,
+        headers: { "Content-Type": contentTypeHeaderForFileName(fileName) },
+    });
+    if (!res.ok) {
+        throw new Error(`S3 upload failed: HTTP ${res.status} ${(await res.text()).slice(0, 500)}`);
+    }
+    const confirmed = await api.attachment.confirmBillAttachment.mutate({
+        billId,
+        key,
+        name: fileName,
+        size,
+    });
+    out(confirmed);
+}
+export async function uploadBudgetAttachmentFromPath(budgetId, filePath) {
+    const buf = await readFile(filePath);
+    const fileName = basename(filePath);
+    const size = buf.byteLength;
+    const { uploadUrl, key } = await api.attachment.requestBudgetAttachmentUpload.mutate({
+        budgetId,
+        fileName,
+        size,
+    });
+    const res = await fetch(uploadUrl, {
+        method: "PUT",
+        body: buf,
+        headers: { "Content-Type": contentTypeHeaderForFileName(fileName) },
+    });
+    if (!res.ok) {
+        throw new Error(`S3 upload failed: HTTP ${res.status} ${(await res.text()).slice(0, 500)}`);
+    }
+    const confirmed = await api.attachment.confirmBudgetAttachment.mutate({
+        budgetId,
+        key,
+        name: fileName,
+        size,
+    });
+    out(confirmed);
+}
 export async function getBillDetails(id) {
     const result = await api.bill.getById.query({ id });
     out(result);
@@ -619,6 +688,7 @@ export async function getApprovedBudgets(opts) {
         ],
         page: 1,
         perPage,
+        includeDetails: false,
     });
     const items = (budgets ?? []).map((b) => {
         const calc = b;

package/dist/filter-enums.js

@@ -1,4 +1,4 @@
-import { ApprovalStatus, ApprovalType, BillStatus, BudgetStatus, ErrorSeverity, ErrorStatus, EstimationMode, ProjectStatus, } from "@bb/db/enums";
+import { ApprovalStatus, ApprovalType, BillStatus, BudgetStatus, ErrorSeverity, ErrorStatus, EstimationMode, ProjectStatus, } from "./prisma-enums.js";
 export const ExtendedApprovalStatus = {
     ...ApprovalStatus,
     ALL: "ALL",

package/dist/index.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 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 { consumeCliQuietFlags, logCliAction, sanitizeFlagsForTrace, setCliQuiet, shouldLogCliActions, } from "./cli-trace.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, 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 { parseJsonFlag, parseOptionalNumber as parseOptNum, } from "./parse-json-flag.js";
@@ -62,10 +63,12 @@ bb — Budget Builder CLI (parity with MCP tools)
 
 Usage: bb <command> [options] [args]
 
+Global: --quiet | -q | BB_CLI_QUIET=1 — hide action logs (default: log command + each tRPC call to stderr; stdout JSON unchanged).
+
 Auth: Set BB_API_KEY in the environment (same API key as MCP / Goracle).
 
 Budgets
-  list-budgets              [--projectId] [--name] [--status CSV] [--createdBy] [--dateFrom] [--dateTo] [--sortBy] [--sortDir] [--page] [--perPage]
+  list-budgets              [--projectId] [--name] [--status CSV] [--createdBy] [--dateFrom] [--dateTo] [--sortBy] [--sortDir] [--page] [--perPage] [--summary]
   get-budget <id>            Budget + line items
   get-budget-items <id>      Line items only
   get-budget-details <id>    Full detail (margins, suppliers, etc.)
@@ -87,19 +90,22 @@ Budgets
   delete-budget-category <id>
   update-budget-commission   --payload '<json>'  (budget.updateBudgetCommission)
   update-budget-discount     --payload '<json>'  (budget.updateBudgetDiscount; type percentage|amount)
+  upload-budget-attachment <budgetId> <filePath>   Presigned S3 upload + confirm
 
 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 [])
+  create-bill                --payload '<json>'  (bill.create; 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]
     status (${billStatusesForUpdateHelp.join(", ")}) — not PENDING_APPROVAL; use create-bill-approval
-  patch-bill-payment <billId> [--paymentTrackingUrl] [--paymentReference] [--quickbooksBillId]
+  patch-bill-payment <billId> [--paymentTrackingUrl] [--paymentReference] [--quickbooksBillId] [--paymentDate <ISO>]
+    Clear a field: --clearPaymentTrackingUrl true | --clearPaymentReference true | --clearQuickbooksBillId true | --clearPaymentDate true
   patch-bill-invoice-number <billId> <invoiceNumber>
   get-bill-attachments <billId>
+  upload-bill-attachment <billId> <filePath>   Presigned S3 upload + confirm (same flow as web UI)
   get-bill-details <billId>
 
 Approvals
@@ -188,12 +194,23 @@ function normalizeCliCommand(raw) {
 }
 async function main() {
     const { command, positional, flags } = parseArgs(process.argv);
+    setCliQuiet(consumeCliQuietFlags(flags));
     const cmd = normalizeCliCommand(command ?? "");
     if (!cmd || cmd === "help" || flags.help === true) {
         printHelp();
         process.exit(0);
     }
     requireApiKey();
+    const t0 = Date.now();
+    if (shouldLogCliActions()) {
+        logCliAction({
+            event: "cli.command",
+            phase: "start",
+            command: cmd,
+            positional,
+            flags: sanitizeFlagsForTrace(flags),
+        });
+    }
     try {
         switch (cmd) {
             case "list-budgets": {
@@ -210,6 +227,9 @@ async function main() {
                     sortDir: getFlag(flags, "sortDir"),
                     page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
                     perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage"),
+                    includeDetails: flags.summary === true
+                        ? false
+                        : parseOptionalBoolFlag(flags, "includeDetails") ?? true,
                 });
                 break;
             }
@@ -220,6 +240,14 @@ async function main() {
                 await getBudget(id);
                 break;
             }
+            case "upload-budget-attachment": {
+                const [budgetId, filePath] = positional;
+                if (!budgetId || !filePath) {
+                    throw new Error("upload-budget-attachment requires <budgetId> <filePath>");
+                }
+                await uploadBudgetAttachmentFromPath(budgetId, filePath);
+                break;
+            }
             case "get-budget-items": {
                 const id = positional[0];
                 if (!id)
@@ -450,11 +478,60 @@ async function main() {
                 const id = positional[0];
                 if (!id)
                     throw new Error("patch-bill-payment requires <billId>");
+                const paymentTrackingUrl = (() => {
+                    const clear = parseOptionalBoolFlag(flags, "clearPaymentTrackingUrl");
+                    const raw = getFlag(flags, "paymentTrackingUrl");
+                    if (clear === true && raw !== undefined) {
+                        throw new Error("Use either --paymentTrackingUrl or --clearPaymentTrackingUrl true, not both");
+                    }
+                    if (clear === true)
+                        return null;
+                    if (raw !== undefined)
+                        return String(raw);
+                    return undefined;
+                })();
+                const paymentReference = (() => {
+                    const clear = parseOptionalBoolFlag(flags, "clearPaymentReference");
+                    const raw = getFlag(flags, "paymentReference");
+                    if (clear === true && raw !== undefined) {
+                        throw new Error("Use either --paymentReference or --clearPaymentReference true, not both");
+                    }
+                    if (clear === true)
+                        return null;
+                    if (raw !== undefined)
+                        return String(raw);
+                    return undefined;
+                })();
+                const quickbooksBillId = (() => {
+                    const clear = parseOptionalBoolFlag(flags, "clearQuickbooksBillId");
+                    const raw = getFlag(flags, "quickbooksBillId");
+                    if (clear === true && raw !== undefined) {
+                        throw new Error("Use either --quickbooksBillId or --clearQuickbooksBillId true, not both");
+                    }
+                    if (clear === true)
+                        return null;
+                    if (raw !== undefined)
+                        return String(raw);
+                    return undefined;
+                })();
+                const paymentDate = (() => {
+                    const clear = parseOptionalBoolFlag(flags, "clearPaymentDate");
+                    const raw = getFlag(flags, "paymentDate");
+                    if (clear === true && raw !== undefined) {
+                        throw new Error("Use either --paymentDate or --clearPaymentDate true, not both");
+                    }
+                    if (clear === true)
+                        return null;
+                    if (raw !== undefined)
+                        return String(raw);
+                    return undefined;
+                })();
                 await patchBillPayment({
                     id,
-                    paymentTrackingUrl: getFlag(flags, "paymentTrackingUrl"),
-                    paymentReference: getFlag(flags, "paymentReference"),
-                    quickbooksBillId: getFlag(flags, "quickbooksBillId"),
+                    paymentTrackingUrl,
+                    paymentReference,
+                    quickbooksBillId,
+                    paymentDate,
                 });
                 break;
             }
@@ -473,6 +550,14 @@ async function main() {
                 await getBillAttachments(id);
                 break;
             }
+            case "upload-bill-attachment": {
+                const [billId, filePath] = positional;
+                if (!billId || !filePath) {
+                    throw new Error("upload-bill-attachment requires <billId> <filePath>");
+                }
+                await uploadBillAttachmentFromPath(billId, filePath);
+                break;
+            }
             case "get-bill-details": {
                 const id = positional[0];
                 if (!id)
@@ -914,9 +999,26 @@ async function main() {
                 throw new Error(`Unknown command: ${cmd}. Run 'bb help'.`);
             }
         }
+        if (shouldLogCliActions()) {
+            logCliAction({
+                event: "cli.command",
+                phase: "ok",
+                command: cmd,
+                durationMs: Date.now() - t0,
+            });
+        }
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
+        if (shouldLogCliActions()) {
+            logCliAction({
+                event: "cli.command",
+                phase: "error",
+                command: cmd,
+                durationMs: Date.now() - t0,
+                error: message,
+            });
+        }
         console.error(JSON.stringify({ error: message }));
         process.exit(1);
     }

package/dist/parse-args.js

@@ -35,6 +35,9 @@ export function parseArgs(argv) {
                 }
             }
         }
+        else if (arg === "-q") {
+            flags.q = true;
+        }
         else {
             positional.push(arg);
         }

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 "./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));
 const PROJECT_STATUS_VALUES = new Set(Object.values(ProjectStatus));
@@ -209,7 +209,7 @@ export function parseApprovalTypeFlag(raw) {
     }
     return u;
 }
-/** For help text / error messages (single import site for `@bb/db` enums in the CLI). */
+/** For help text / error messages (values from `./prisma-enums.js`, synced with Prisma). */
 export const budgetStatusesForHelp = Object.values(BudgetStatus);
 export const billStatusesForHelp = Object.values(BillStatus);
 export const billStatusesForUpdateHelp = Object.values(BillStatus).filter((s) => s !== BillStatus.PENDING_APPROVAL);

package/dist/prisma-enums.js

@@ -0,0 +1,55 @@
+/**
+ * Runtime Prisma enum values the CLI needs. Mirrors
+ * `packages/db/src/generated/prisma/enums.ts` — keep in sync when the schema changes.
+ */
+export const EstimationMode = {
+    MICRO: "MICRO",
+    MANPOWER_SPECIFIED: "MANPOWER_SPECIFIED",
+};
+export const ProjectStatus = {
+    NOT_STARTED: "NOT_STARTED",
+    IN_PROGRESS: "IN_PROGRESS",
+    COMPLETED: "COMPLETED",
+    CANCELLED: "CANCELLED",
+};
+export const BudgetStatus = {
+    DRAFT: "DRAFT",
+    PENDING_APPROVAL: "PENDING_APPROVAL",
+    APPROVED: "APPROVED",
+    REJECTED: "REJECTED",
+    ESTIMATE_CREATED: "ESTIMATE_CREATED",
+    ESTIMATE_SENT: "ESTIMATE_SENT",
+    ESTIMATE_ACCEPTED: "ESTIMATE_ACCEPTED",
+    ESTIMATE_REJECTED: "ESTIMATE_REJECTED",
+    ESTIMATE_CLOSED: "ESTIMATE_CLOSED",
+};
+export const ApprovalStatus = {
+    PENDING_APPROVAL: "PENDING_APPROVAL",
+    APPROVED: "APPROVED",
+    REJECTED: "REJECTED",
+};
+export const ApprovalType = {
+    BUDGET: "BUDGET",
+    SUPPLIER: "SUPPLIER",
+    BILL: "BILL",
+};
+export const ErrorSeverity = {
+    LOW: "LOW",
+    MEDIUM: "MEDIUM",
+    HIGH: "HIGH",
+    CRITICAL: "CRITICAL",
+};
+export const ErrorStatus = {
+    UNRESOLVED: "UNRESOLVED",
+    INVESTIGATING: "INVESTIGATING",
+    RESOLVED: "RESOLVED",
+    IGNORED: "IGNORED",
+};
+export const BillStatus = {
+    DRAFT: "DRAFT",
+    PENDING_APPROVAL: "PENDING_APPROVAL",
+    CHECKED: "CHECKED",
+    APPROVED: "APPROVED",
+    PAID: "PAID",
+    REJECTED: "REJECTED",
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@go-labs-sg/bb",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "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",
@@ -23,9 +23,12 @@
   "dependencies": {
     "@trpc/client": "^11.16.0",
     "dotenv": "^17.2.4",
+    "mime-types": "^3.0.2",
     "superjson": "^2.2.6"
   },
-  "devDependencies": {},
+  "devDependencies": {
+    "@types/mime-types": "^3.0.1"
+  },
   "engines": {
     "node": ">=18"
   },

package/dist/api-client.d.ts

@@ -1,5 +0,0 @@
-import type { AppRouter } from "@bb/api";
-import { type CreateTRPCProxyClient } from "@trpc/client";
-export declare const api: CreateTRPCProxyClient<AppRouter>;
-export declare function requireApiKey(): string;
-//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAGN,KAAK,qBAAqB,EAC1B,MAAM,cAAc,CAAC;AAetB,eAAO,MAAM,GAAG,EAAE,qBAAqB,CAAC,SAAS,CAgB/C,CAAC;AAEH,wBAAgB,aAAa,IAAI,MAAM,CAOtC"}

package/dist/commands.d.ts

@@ -1,28 +0,0 @@
-import type { BudgetStatus } from "@bb/db/enums";
-import type { ExtendedBudgetStatus } from "@bb/utils/filter-enums";
-export declare function listBudgets(opts: {
-    projectId?: string;
-    name?: string;
-    statuses?: ExtendedBudgetStatus[];
-    page?: number;
-    perPage?: number;
-}): Promise<void>;
-export declare function getBudget(id: string): Promise<void>;
-export declare function updateBudgetStatus(budgetId: string, status: BudgetStatus): Promise<void>;
-export declare function listBills(opts: {
-    projectId?: string;
-    budgetId?: string;
-    status?: string;
-    page?: number;
-    pageSize?: number;
-}): Promise<void>;
-export declare function approveBill(billId: string): Promise<void>;
-export declare function listApprovals(opts: {
-    type?: string;
-}): Promise<void>;
-export declare function listSuppliers(opts: {
-    name?: string;
-    page?: number;
-    perPage?: number;
-}): Promise<void>;
-//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAWnE,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAShB;AAED,wBAAsB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzD;AAED,wBAAsB,kBAAkB,CACvC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAehB;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB/D;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6C1E;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhB"}

package/dist/index.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-import "./load-env.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC"}

package/dist/load-env.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=load-env.d.ts.map

package/dist/load-env.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"load-env.d.ts","sourceRoot":"","sources":["../src/load-env.ts"],"names":[],"mappings":""}

package/dist/parse-args.d.ts

@@ -1,11 +0,0 @@
-/**
- * Minimal argv parser for bb CLI.
- * Supports: command [positional...] [--key=value] [--key value]
- */
-export declare function parseArgs(argv: string[]): {
-    command: string;
-    positional: string[];
-    flags: Record<string, string | true>;
-};
-export declare function getFlag<T extends string | number>(flags: Record<string, string | true>, key: string, parse?: (s: string) => T): T | undefined;
-//# sourceMappingURL=parse-args.d.ts.map

package/dist/parse-args.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parse-args.d.ts","sourceRoot":"","sources":["../src/parse-args.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CACrC,CA8BA;AAED,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAChD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,EACpC,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,CAAC,GACtB,CAAC,GAAG,SAAS,CAIf"}