@go-labs-sg/bb 1.12.0 → 1.13.0

package/README.md

@@ -56,7 +56,7 @@ 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
 

package/dist/commands.js

@@ -5,6 +5,7 @@ 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";
@@ -396,7 +397,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) {

package/dist/index.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

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/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.13.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"