@go-labs-sg/bb 1.0.1 → 1.0.2

package/README.md

@@ -1,77 +1,84 @@
-# bb — Budget Builder CLI
+# bb
 
-Lightweight CLI that wraps the same tRPC API used by the MCP server. For AI agents (e.g. Chuck/OpenClaw) that don’t support MCP: run `bb` from the shell and get JSON back.
+Command-line interface for **Budget Builder**. Call budgets, bills, approvals, and suppliers from your terminal or from tools that don’t support MCP (e.g. some AI agents). Responses are JSON on stdout.
 
-**Why no workspace refs in the published package?**  
-`workspace:*` only resolves inside your monorepo. When someone installs from npm (`npx @go-labs-sg/bb` or `npm i -g @go-labs-sg/bb`), their environment has no workspace, so the CLI is built with no runtime dependency on `@bb/api`, `@bb/db`, or `@bb/utils`. In the repo we keep `@bb/typescript-config` as a devDependency for typechecking; it is stripped from the tarball when publishing (or use a publish flow that omits workspace devDeps).
+**Registry:** [`@go-labs-sg/bb`](https://www.npmjs.com/package/@go-labs-sg/bb)
 
-## Auth
+## Requirements
 
-- Set **`BB_API_KEY`** in the environment (same API key as MCP / Goracle > API Keys).
-- The CLI targets the production API at `https://budget-builder.getout.events`.
+- **Node.js** 18+
+- A **Budget Builder API key** (same key used for the MCP server)
 
-## Usage
-
-From the monorepo root:
+## Install
 
 ```bash
-export BB_API_KEY=your_api_key
-bun run bb -- list-budgets
-bun run bb -- get-budget <id>
-bun run bb -- update-budget-status <id> <status>
-bun run bb -- list-bills
-bun run bb -- approve-bill <id>
-bun run bb -- list-approvals
-bun run bb -- list-suppliers
+npm install -g @go-labs-sg/bb
 ```
 
-Or from `packages/cli`:
+Or run without installing:
 
 ```bash
-bun run src/index.ts list-budgets
+npx @go-labs-sg/bb <command>
 ```
 
-## Commands
+## Authentication
 
-| Command | Description |
-|--------|-------------|
-| `list-budgets` | List budgets. Optional: `--projectId`, `--name`, `--status` (comma-separated), `--page`, `--perPage` |
-| `get-budget <id>` | Budget details + line items |
-| `update-budget-status <id> <status>` | Set status (e.g. `APPROVED`, `REJECTED`) |
-| `list-bills` | List bills. Optional: `--projectId`, `--budgetId`, `--status`, `--page`, `--pageSize` |
-| `approve-bill <id>` | Approve a pending bill |
-| `list-approvals` | Pending approvals. Optional: `--type` (budget \| supplier \| bill \| all) |
-| `list-suppliers` | List suppliers. Optional: `--name`, `--page`, `--perPage` |
+Set your API key before running commands:
+
+```bash
+export BB_API_KEY=<your-key>
+```
 
-Output is JSON to stdout. Errors go to stderr and exit code 1.
+Create or revoke keys in the web app: **Goracle → API Keys** (MCP API keys).
 
-## Install from npm (for agents without the repo)
+The CLI talks to the production API: `https://budget-builder.getout.events`.
+
+## Usage
 
 ```bash
-npx @go-labs-sg/bb list-budgets
-# or
-npm install -g @go-labs-sg/bb
+bb help
 bb list-budgets
+bb get-budget <budget-id>
+bb update-budget-status <budget-id> <status>
+bb list-bills
+bb approve-bill <bill-id>
+bb list-approvals
+bb list-suppliers
 ```
 
-Set `BB_API_KEY` in the environment before running.
+Global options and flags use `--key=value` or `--key value` (see `bb help`).
 
-## Testing (local)
+## Commands
+
+| Command | Description |
+| --- | --- |
+| `list-budgets` | List budgets. Flags: `--projectId`, `--name`, `--status` (comma-separated), `--page`, `--perPage` |
+| `get-budget <id>` | Budget details and line items |
+| `update-budget-status <id> <status>` | Change budget status (e.g. `APPROVED`, `REJECTED`, `DRAFT`, …) |
+| `list-bills` | List bills. Flags: `--projectId`, `--budgetId`, `--status`, `--page`, `--pageSize` |
+| `approve-bill <id>` | Approve a pending bill (matches your pending bill approvals) |
+| `list-approvals` | Pending approvals. Flag: `--type` = `budget`, `supplier`, `bill`, or `all` |
+| `list-suppliers` | List suppliers. Flags: `--name`, `--page`, `--perPage` |
+
+## Output
 
-1. **Create an API key** in the web app: Goracle → API Keys → Create MCP API Key. Copy the key (shown once).
+- **Stdout:** JSON (pretty-printed)
+- **Stderr:** Error objects as JSON on failure
+- **Exit code:** `0` on success, `1` on error
 
-2. **Start the web app** (or use a deployed URL):
-   ```bash
-   bun run web:dev
-   ```
+A `.env` file in the **current working directory** is loaded automatically (for `BB_API_KEY`, etc.).
+
+## Developing in this repo
+
+From the monorepo root:
 
-3. **Set env and run** from monorepo root:
-   ```bash
-   export BB_API_KEY=your_copied_key
-   bun run bb -- list-budgets
-   bun run bb -- list-suppliers
-   ```
+```bash
+export BB_API_KEY=...
+bun run bb -- list-budgets
+```
 
-4. **Verify JSON output** — you should see structured JSON on stdout. Errors go to stderr with exit code 1.
+Or from `packages/cli`:
 
-   If you see `{"error":"Unable to connect..."}` — the production API may be unreachable or your network may be blocking the request.
+```bash
+bun run src/index.ts list-budgets
+```

package/dist/commands.js

@@ -2,6 +2,12 @@ import { api } from "./api-client.js";
 const BUDGET = "BUDGET";
 const BILL = "BILL";
 const SUPPLIER = "SUPPLIER";
+function isPendingRequest(n) {
+    return n.notificationType === "request" && n.status === "PENDING_APPROVAL";
+}
+function isApprovalType(s) {
+    return s === BUDGET || s === BILL || s === SUPPLIER;
+}
 const out = (data) => {
     console.log(JSON.stringify(data, null, 2));
 };
@@ -43,9 +49,8 @@ export async function listBills(opts) {
     out(result);
 }
 export async function approveBill(billId) {
-    const notifications = (await api.budget.getNotifications.query());
-    const pending = notifications.filter((n) => n.notificationType === "request" &&
-        n.status === "PENDING_APPROVAL" &&
+    const notifications = await api.budget.getNotifications.query();
+    const pending = notifications.filter((n) => isPendingRequest(n) &&
         n.type === BILL &&
         (n.billId === billId || n.bill?.id === billId));
     const approval = pending[0];
@@ -60,12 +65,12 @@ export async function approveBill(billId) {
     out({ ...result, success: true, message: "Bill approved" });
 }
 export async function listApprovals(opts) {
-    const notifications = (await api.budget.getNotifications.query());
-    const pending = notifications.filter((n) => n.notificationType === "request" && n.status === "PENDING_APPROVAL");
-    const typeUpper = opts.type?.toUpperCase();
+    const notifications = await api.budget.getNotifications.query();
+    const pending = notifications.filter(isPendingRequest);
+    const raw = opts.type?.toUpperCase();
     const typeFilter = !opts.type || opts.type.toLowerCase() === "all"
-        ? () => true
-        : (n) => n.type === typeUpper;
+        ? (_n) => true
+        : (n) => raw !== undefined && isApprovalType(raw) && n.type === raw;
     const filtered = pending.filter(typeFilter);
     const items = filtered.map((n) => {
         let id;

package/dist/index.js

@@ -48,7 +48,7 @@ Output: JSON to stdout. Errors to stderr and exit code 1.
 }
 async function main() {
     const { command, positional, flags } = parseArgs(process.argv);
-    if (!command || command === "help" || flags["help"] === true) {
+    if (!command || command === "help" || flags.help === true) {
         printHelp();
         process.exit(0);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@go-labs-sg/bb",
-  "version": "1.0.1",
+  "version": "1.0.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",
@@ -18,7 +18,7 @@
     "check:write": "biome check --write .",
     "run": "bun run src/index.ts",
     "prepublishOnly": "node scripts/strip-workspace-deps.js && bun run build",
-    "postpublish": "node scripts/restore-package-json.js"
+    "postpack": "node scripts/restore-package-json.js"
   },
   "dependencies": {
     "@trpc/client": "^11.10.0",