@go-labs-sg/bb 1.2.1 → 1.2.3

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,9 +94,9 @@ bun run src/index.ts list-budgets
 
 ### Layout
 
-- **`src/prisma-enums.ts`** — Prisma enum string values for runtime; mirror `packages/db/src/generated/prisma/enums.ts` after schema changes.
+- **`src/prisma-enums.ts`** — Prisma enum string values for runtime; mirror `packages/budget-builder/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`). 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`.
+`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 `@go-labs/budget-builder-api` are compile-time only (`import type`). Prisma enum **values** used at runtime live in `src/prisma-enums.ts` (kept in sync with `packages/budget-builder/db` generated enums) so npm installs do not need `@go-labs/budget-builder-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);
@@ -477,6 +546,7 @@ export async function createProject(opts) {
         description: opts.description,
         companyId: opts.companyId,
         contactPersonId: opts.contactPersonId,
+        asanaTaskId: opts.asanaTaskId,
         dateRange: {
             from: new Date(opts.startDate),
             to: opts.endDate ? new Date(opts.endDate) : undefined,
@@ -619,6 +689,7 @@ export async function getApprovedBudgets(opts) {
         ],
         page: 1,
         perPage,
+        includeDetails: false,
     });
     const items = (budgets ?? []).map((b) => {
         const calc = b;

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)
@@ -606,14 +691,20 @@ async function main() {
                 const name = getFlag(flags, "name");
                 const companyId = getFlag(flags, "companyId");
                 const contactPersonId = getFlag(flags, "contactPersonId");
+                const asanaTaskId = getFlag(flags, "asanaTaskId");
                 const startDate = getFlag(flags, "startDate");
-                if (!name || !companyId || !contactPersonId || !startDate) {
-                    throw new Error("create-project requires --name --companyId --contactPersonId --startDate (ISO)");
+                if (!name ||
+                    !companyId ||
+                    !contactPersonId ||
+                    !asanaTaskId ||
+                    !startDate) {
+                    throw new Error("create-project requires --name --companyId --contactPersonId --asanaTaskId --startDate (ISO)");
                 }
                 await createProject({
                     name,
                     companyId,
                     contactPersonId,
+                    asanaTaskId,
                     startDate,
                     endDate: getFlag(flags, "endDate"),
                     description: getFlag(flags, "description"),
@@ -914,9 +1005,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-mutation-payload.js

@@ -196,6 +196,7 @@ export function parseUpdateProjectPayload(raw) {
         description: optionalString(o.description),
         companyId: requiredString(o.companyId, "update-project payload.companyId"),
         contactPersonId: requiredString(o.contactPersonId, "update-project payload.contactPersonId"),
+        asanaTaskId: requiredString(o.asanaTaskId, "update-project payload.asanaTaskId"),
         dateRange: {
             from: toDate(range.from, "dateRange.from"),
             to: range.to === undefined || range.to === null

package/dist/prisma-enums.js

@@ -1,6 +1,6 @@
 /**
  * Runtime Prisma enum values the CLI needs. Mirrors
- * `packages/db/src/generated/prisma/enums.ts` — keep in sync when the schema changes.
+ * `packages/budget-builder/db/src/generated/prisma/enums.ts` — keep in sync when the schema changes.
  */
 export const EstimationMode = {
     MICRO: "MICRO",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@go-labs-sg/bb",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "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",
@@ -22,10 +22,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"
   },