@go-labs-sg/bb 1.12.0 → 1.14.0

package/README.md

@@ -56,15 +56,16 @@ Global options and flags use `--key=value` or `--key value` (see `bb help`).
 
 **Budget status automation:** Setting a budget to `ESTIMATE_ACCEPTED` requires a confirmed win-proof attachment. If the parent project is `PITCH` or `LOST`, the API now marks it `WON` automatically and, when the `asana-tasks` feature flag is enabled, creates the Asana project/section/tasks automatically. When rejecting the only accepted/closed budget on a commercial project, pass `--projectStatusOnCommercialRejection PITCH|LOST`.
 
-**Mutations with `--payload`:** Commands such as `create-budget`, `create-bill`, `update-supplier`, etc. take a single JSON object (`--payload '<json>'`) matching the corresponding tRPC procedure input. Use ISO strings for date/datetime fields; the CLI coerces them where needed. The API still validates the full shape. For **`update-project`**, the project window is `dateRange.from` and `dateRange.to` (optional end); there are no separate event-date fields on the project payload. **`create-budget` / `update-budget`** do not accept `asanaTaskId`; configure the deal card on the project (`update-project` / project settings).
+**Mutations with `--payload`:** Commands such as `create-budget`, `create-bill`, `update-supplier`, etc. take a single JSON object (`--payload '<json>'`) matching the corresponding tRPC procedure input. Use ISO strings for date/datetime fields; the CLI coerces them where needed. The API still validates the full shape. Plain `description` fields for item create/update are converted to `descriptionRichText`; pass `descriptionRichText` directly when formatted Tiptap JSON is required. For **`update-project`**, the project window is `dateRange.from` and `dateRange.to` (optional end); there are no separate event-date fields on the project payload. **`create-budget` / `update-budget`** do not accept `asanaTaskId`; configure the deal card on the project (`update-project` / project settings).
 
 ### Command overview
 
 | 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` (`ESTIMATE_ACCEPTED` requires win proof, auto-marks `PITCH` or `LOST` projects `WON`, and auto-creates Asana project/section/tasks when enabled; `--projectStatusOnCommercialRejection PITCH\|LOST` is required when rejecting the only accepted/closed budget on a commercial project), `mark-budget-won` (`<budgetId>` + proof file path; `PITCH` or `LOST` projects become `WON` automatically), `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) |
+| **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; non-legacy supplier bills from 1 Jul 2026 00:00 SGT require approved quotation coverage), `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` |
+| **Quotations** | `list-quotations`, `get-quotation`, `upload-quotation-attachment` (`<projectId>` + local PDF path; returns attachment JSON for payload use), `create-quotation` (`--payload` for `quotation.createDraft`), `submit-quotation`, `approve-quotation`, `reject-quotation`, `download-quotation-pdf` (`original`, `staff`, or `final`) |
+| **Approvals** | `list-approvals` / `get-pending-approvals` (`--type budget\|supplier\|bill\|quotation\|all`), `approve-bill` / `reject-bill` (send reply email), `approve-budget` / `reject-budget` (send reply email), `approve-supplier` / `reject-supplier` (send reply email), `approve-quotation` / `reject-quotation` |
 | **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` (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) |

package/dist/commands.js

@@ -1,3 +1,4 @@
+import { randomUUID } from "node:crypto";
 import { readFile } from "node:fs/promises";
 import { basename } from "node:path";
 import { contentType } from "mime-types";
@@ -5,9 +6,11 @@ import { api } from "./api-client.js";
 import { BudgetRole, Deals, ExtendedApprovalStatus, ExtendedApprovalType, ExtendedBudgetStatus, TimeFrame, } from "./filter-enums.js";
 import { billStatusesForApi, } from "./parse-cli-enums.js";
 import { parseBudgetDiscountPayload, parseCompanyUpdatePayload, parseContactCreatePayload, parseContactUpdatePayload, parseCreateBillPayload, parseCreateBudgetPayload, parseItemCreatePayload, parseItemUpdatePayload, parseSupplierCreatePayload, parseSupplierUpdatePayload, parseUpdateBillPayload, parseUpdateBudgetCommissionPayload, parseUpdateBudgetPayload, parseUpdateProjectPayload, } from "./parse-mutation-payload.js";
+import { createRichTextFromPlainText } from "./rich-text.js";
 const BUDGET = "BUDGET";
 const BILL = "BILL";
 const SUPPLIER = "SUPPLIER";
+const QUOTATION = "QUOTATION";
 function isPendingRequest(n) {
     return n.notificationType === "request" && n.status === "PENDING_APPROVAL";
 }
@@ -198,6 +201,10 @@ export async function listApprovals(opts) {
             id = n.supplier.id;
             name = n.supplier.name;
         }
+        else if (n.type === QUOTATION && n.supplierQuotation) {
+            id = n.supplierQuotation.id;
+            name = `Quotation ${n.supplierQuotation.supplier.name}`;
+        }
         else {
             id = n.id;
             name = "Unknown";
@@ -322,6 +329,33 @@ export async function uploadBillAttachmentFromPath(billId, filePath) {
     });
     out(confirmed);
 }
+export async function uploadQuotationAttachmentFromPath(projectId, filePath) {
+    const buf = await readFile(filePath);
+    const fileName = basename(filePath);
+    const ext = fileName
+        .split(".")
+        .pop()
+        ?.toLowerCase()
+        .replace(/[^a-z0-9]/g, "");
+    const key = `quotations/${projectId}/${randomUUID()}.${ext || "pdf"}`;
+    const uploadUrl = await api.attachment.getPresignedUrlToUpload.mutate({
+        key,
+    });
+    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)}`);
+    }
+    out({
+        id: randomUUID(),
+        name: fileName,
+        key,
+        size: buf.byteLength,
+    });
+}
 export async function uploadBudgetAttachmentFromPath(budgetId, filePath) {
     const buf = await readFile(filePath);
     const fileName = basename(filePath);
@@ -396,7 +430,17 @@ export async function addBudgetItems(opts) {
     out(result);
 }
 export async function updateBudgetItem(input) {
-    const result = await api.budgetItem.updateBudgetItem.mutate(input);
+    const result = await api.budgetItem.updateBudgetItem.mutate({
+        ...input,
+        ...(input.description !== undefined &&
+            input.descriptionRichText === undefined && {
+            descriptionRichText: createRichTextFromPlainText(input.description),
+        }),
+        ...(input.note !== undefined &&
+            input.noteRichText === undefined && {
+            noteRichText: createRichTextFromPlainText(input.note),
+        }),
+    });
     out(result);
 }
 export async function removeBudgetItem(budgetItemId) {
@@ -557,6 +601,29 @@ export async function createBillFromPayload(raw) {
     const result = await api.bill.create.mutate(input);
     out(result);
 }
+export async function listQuotations(opts) {
+    const result = await api.quotation.list.query(opts);
+    out(result);
+}
+export async function getQuotationDetails(id) {
+    const result = await api.quotation.getById.query({ id });
+    out(result);
+}
+export async function createQuotationFromPayload(raw) {
+    const result = await api.quotation.createDraft.mutate(raw);
+    out(result);
+}
+export async function submitQuotation(id) {
+    const result = await api.quotation.submitForApproval.mutate({ id });
+    out(result);
+}
+export async function downloadQuotationPdf(id, fileRole) {
+    const result = await api.quotation.getSignedDownloadUrl.query({
+        id,
+        fileRole,
+    });
+    out(result);
+}
 export async function updateBillFromPayload(raw) {
     const input = parseUpdateBillPayload(raw);
     const result = await api.bill.update.mutate(input);
@@ -913,6 +980,37 @@ export async function rejectBill(billId, reason) {
         email,
     });
 }
+export async function approveQuotation(quotationId) {
+    const notifications = await api.budget.getNotifications.query();
+    const pending = notifications.filter((n) => isPendingRequest(n) &&
+        n.type === QUOTATION &&
+        (n.supplierQuotationId === quotationId ||
+            n.supplierQuotation?.id === quotationId));
+    const approval = pending[0];
+    if (!approval) {
+        throw new Error("No pending quotation approval found.");
+    }
+    const result = await api.quotation.approve.mutate({
+        quotationApprovalId: approval.id,
+    });
+    out(result);
+}
+export async function rejectQuotation(quotationId, reason) {
+    const notifications = await api.budget.getNotifications.query();
+    const pending = notifications.filter((n) => isPendingRequest(n) &&
+        n.type === QUOTATION &&
+        (n.supplierQuotationId === quotationId ||
+            n.supplierQuotation?.id === quotationId));
+    const approval = pending[0];
+    if (!approval) {
+        throw new Error("No pending quotation approval found.");
+    }
+    const result = await api.quotation.reject.mutate({
+        quotationApprovalId: approval.id,
+        rejectionReason: reason,
+    });
+    out(result);
+}
 // --- Companies & projects ---
 export async function listCompanies(opts) {
     const result = await api.company.getCompanies.query({

package/dist/index.js

@@ -2,7 +2,7 @@
 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, 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 { addBudgetItems, approveBill, approveBudget, approveQuotation, approveSupplier, createBillApproval, createBillFromPayload, createBudgetApproval, createBudgetCategory, createBudgetFromPayload, createCompany, createContactPersonFromPayload, createEstimate, createItemCategory, createItemFromPayload, createProject, createQuotationFromPayload, createSupplierCertification, createSupplierFromPayload, createSupplierPaymentMethod, createSupplierRoleOption, createSupplierTagOption, deleteBillById, deleteBudgetById, deleteBudgetCategory, deleteCompanyById, deleteItemById, deleteItemCategoriesByIds, deleteProjectById, deleteSuppliersByIds, downloadQuotationPdf, getApprovedBudgets, getBillAttachments, getBillDetails, getBudget, getBudgetCategories, getBudgetCategoryBenchmarks, getBudgetDetails, getBudgetItemsOnly, getBudgetVersions, getCompany, getDashboard, getErrorMetrics, getEstimatePerformance, getFinancialOverview, getItem, getItemPricingHistory, getMonthlyMetrics, getProject, getQuotationDetails, getRecentErrors, getSupplierAnalytics, getSupplierDetails, getSupplierPricingHistory, getSystemOverview, getUserPerformance, listApprovals, listBills, listBudgets, listCompanies, listContacts, listItemCategories, listItems, listProjects, listQuotations, listSuppliers, listUsers, markBudgetWonWithProof, patchBillInvoiceNumber, patchBillPayment, reactivateSuppliersByIds, rejectBill, rejectBudget, rejectQuotation, rejectSupplier, removeBudgetItem, reorderBudgetItemsCli, submitQuotation, updateBillFromPayload, updateBillStatus, updateBudgetCategory, updateBudgetCommissionFromPayload, updateBudgetDiscountFromPayload, updateBudgetFromPayload, updateBudgetItem, updateBudgetItemSupplierCli, updateBudgetStatus, updateCompanyFromPayload, updateContactPersonFromPayload, updateItemCategory, updateItemFromPayload, updateProjectFromPayload, updateProjectStatus, updateSupplierFromPayload, uploadBillAttachmentFromPath, uploadBudgetAttachmentFromPath, uploadQuotationAttachmentFromPath, } from "./commands.js";
 import { getFlag, parseArgs } from "./parse-args.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";
@@ -137,7 +137,7 @@ Budgets
   create-budget-approval <budgetId>   (also sends approval request emails)
   create-estimate <budgetId>          (creates QuickBooks estimate; supports preflight updates)
   add-budget-items           --budgetId --items '[{"itemId":"…","quantity":1,"markup":30},…]'
-  update-budget-item         --id <budgetItemId> [--description] [--note] [--quantity] [--markup] [--cost] [--unitPrice] [--isFreeOfCharge true|false] [--gstInclusive true|false]
+  update-budget-item         --id <budgetItemId> [--description plain-text] [--note plain-text] [--quantity] [--markup] [--cost] [--unitPrice] [--isFreeOfCharge true|false] [--gstInclusive true|false]
   remove-budget-item <budgetItemId>
   reorder-budget-items       <budgetId> --itemIds <csv>
   update-budget-item-supplier --budgetItemId --supplierId
@@ -152,6 +152,7 @@ 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.
+    New supplier bills from 1 Jul 2026 00:00 SGT require approved quotation coverage for each non-legacy line item.
   create-bill-approval <billId>       (also sends approval request emails)
   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)
@@ -165,8 +166,18 @@ Bills
   upload-bill-attachment <billId> <filePath>   Presigned S3 upload + confirm (same flow as web UI)
   get-bill-details <billId>
 
+Quotations
+  list-quotations            [--projectId] [--budgetId] [--supplierId] [--status CSV] [--page] [--pageSize]
+  get-quotation <quotationId>
+  upload-quotation-attachment <projectId> <filePath>   Presigned S3 upload; returns attachment JSON for create-quotation payload
+  create-quotation           --payload '<json>'  (quotation.createDraft)
+  submit-quotation <quotationId>
+  approve-quotation <quotationId>
+  reject-quotation <quotationId> --reason <text>
+  download-quotation-pdf <quotationId> [original|staff|final]
+
 Approvals
-  list-approvals | get-pending-approvals   [--type budget|supplier|bill|all]
+  list-approvals | get-pending-approvals   [--type budget|supplier|bill|quotation|all]
   approve-bill <billId>               (also sends requester reply email)
   reject-bill <billId> --reason <text> (also sends requester reply email)
   approve-budget <budgetId>           (also sends requester reply email)
@@ -674,6 +685,88 @@ async function main() {
                 await getBillDetails(id);
                 break;
             }
+            case "list-quotations": {
+                const statusRaw = getFlag(flags, "status");
+                await listQuotations({
+                    projectId: getFlag(flags, "projectId"),
+                    budgetId: getFlag(flags, "budgetId"),
+                    supplierId: getFlag(flags, "supplierId"),
+                    status: statusRaw !== undefined
+                        ? String(statusRaw)
+                            .split(",")
+                            .map((value) => value.trim().toUpperCase())
+                            .filter(Boolean)
+                        : undefined,
+                    page: getFlag(flags, "page") !== undefined
+                        ? Number(getFlag(flags, "page"))
+                        : undefined,
+                    pageSize: getFlag(flags, "pageSize") !== undefined
+                        ? Number(getFlag(flags, "pageSize"))
+                        : undefined,
+                });
+                break;
+            }
+            case "get-quotation": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("get-quotation requires <quotationId>");
+                await getQuotationDetails(id);
+                break;
+            }
+            case "upload-quotation-attachment": {
+                const [projectId, filePath] = positional;
+                if (!projectId || !filePath) {
+                    throw new Error("upload-quotation-attachment requires <projectId> <filePath>");
+                }
+                await uploadQuotationAttachmentFromPath(projectId, filePath);
+                break;
+            }
+            case "create-quotation": {
+                const payloadRaw = getFlag(flags, "payload");
+                if (!payloadRaw) {
+                    throw new Error("create-quotation requires --payload '<json>'");
+                }
+                const raw = parseJsonFlag(String(payloadRaw), "--payload");
+                await createQuotationFromPayload(raw);
+                break;
+            }
+            case "submit-quotation": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("submit-quotation requires <quotationId>");
+                await submitQuotation(id);
+                break;
+            }
+            case "approve-quotation": {
+                const id = positional[0];
+                if (!id)
+                    throw new Error("approve-quotation requires <quotationId>");
+                await approveQuotation(id);
+                break;
+            }
+            case "reject-quotation": {
+                const id = positional[0];
+                const reason = getFlag(flags, "reason");
+                if (!id || reason === undefined) {
+                    throw new Error("reject-quotation requires <quotationId> --reason <text>");
+                }
+                await rejectQuotation(id, reason);
+                break;
+            }
+            case "download-quotation-pdf": {
+                const id = positional[0];
+                if (!id) {
+                    throw new Error("download-quotation-pdf requires <quotationId> [original|staff|final]");
+                }
+                const roleRaw = (positional[1] ?? "final").toLowerCase();
+                const fileRole = roleRaw === "original"
+                    ? "ORIGINAL"
+                    : roleRaw === "staff"
+                        ? "STAFF_SIGNED"
+                        : "FINAL_SIGNED";
+                await downloadQuotationPdf(id, fileRole);
+                break;
+            }
             case "list-approvals":
             case "get-pending-approvals": {
                 const typeRaw = getFlag(flags, "type");

package/dist/parse-cli-enums.js

@@ -215,7 +215,7 @@ export function parseOptionalBillListSortDir(raw) {
     return raw;
 }
 function isPendingRequestType(s) {
-    return s === "BUDGET" || s === "BILL" || s === "SUPPLIER";
+    return (s === "BUDGET" || s === "BILL" || s === "SUPPLIER" || s === "QUOTATION");
 }
 export function parseApprovalTypeFlag(raw) {
     if (raw === undefined)
@@ -224,7 +224,7 @@ export function parseApprovalTypeFlag(raw) {
     if (u === "ALL")
         return "ALL";
     if (!isPendingRequestType(u)) {
-        throw new Error(`Invalid --type "${raw}". Use budget, supplier, bill, or all.`);
+        throw new Error(`Invalid --type "${raw}". Use budget, supplier, bill, quotation, or all.`);
     }
     return u;
 }

package/dist/parse-mutation-payload.js

@@ -1,3 +1,4 @@
+import { normalizePlainTextRichTextField } from "./rich-text.js";
 function requireObject(raw, label) {
     if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
         throw new Error(`${label} must be a JSON object.`);
@@ -237,12 +238,20 @@ export function parseSupplierUpdatePayload(raw) {
     return raw;
 }
 export function parseItemCreatePayload(raw) {
-    requireObject(raw, "create-item payload");
-    return raw;
+    const input = requireObject(raw, "create-item payload");
+    return normalizePlainTextRichTextField({
+        input,
+        textField: "description",
+        richTextField: "descriptionRichText",
+    });
 }
 export function parseItemUpdatePayload(raw) {
-    requireObject(raw, "update-item payload");
-    return raw;
+    const input = requireObject(raw, "update-item payload");
+    return normalizePlainTextRichTextField({
+        input,
+        textField: "description",
+        richTextField: "descriptionRichText",
+    });
 }
 export function parseContactCreatePayload(raw) {
     requireObject(raw, "create-contact-person payload");

package/dist/prisma-enums.js

@@ -33,6 +33,8 @@ export const ApprovalType = {
     BUDGET: "BUDGET",
     SUPPLIER: "SUPPLIER",
     BILL: "BILL",
+    CUSTOMER_INVOICE: "CUSTOMER_INVOICE",
+    QUOTATION: "QUOTATION",
 };
 export const ErrorSeverity = {
     LOW: "LOW",

package/dist/rich-text.js

@@ -0,0 +1,34 @@
+const escapeHtml = (text) => text
+    .replace(/&/g, "&")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&#39;");
+export const createRichTextFromPlainText = (text) => {
+    const lines = text?.split(/\r?\n/) ?? [];
+    const paragraphs = lines.length ? lines : [""];
+    return {
+        json: {
+            type: "doc",
+            content: paragraphs.map((line) => ({
+                type: "paragraph",
+                ...(line ? { content: [{ type: "text", text: line }] } : {}),
+            })),
+        },
+        html: paragraphs.map((line) => `<p>${escapeHtml(line)}</p>`).join(""),
+    };
+};
+export const isRichTextJson = (value) => Boolean(value &&
+    typeof value === "object" &&
+    "json" in value &&
+    "html" in value &&
+    typeof value.html === "string");
+export const normalizePlainTextRichTextField = ({ input, textField, richTextField, }) => {
+    if (isRichTextJson(input[richTextField]) || input[textField] === undefined) {
+        return input;
+    }
+    return {
+        ...input,
+        [richTextField]: createRichTextFromPlainText(String(input[textField] ?? "")),
+    };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@go-labs-sg/bb",
-  "version": "1.12.0",
+  "version": "1.14.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",
@@ -21,7 +21,7 @@
     "postpack": "node scripts/restore-package-json.js"
   },
   "dependencies": {
-    "@trpc/client": "^11.17.0",
+    "@trpc/client": "^11.18.0",
     "dotenv": "^17.4.2",
     "mime-types": "^3.0.2",
     "superjson": "^2.2.6"