more json

Author: benjaminjnoack

AGENTS.md

@@ -10,7 +10,7 @@ You are Codex, based on GPT-5. You are running as a coding agent in the Codex CL
 - When multiple tool calls can be parallelized (e.g., todo updates with other actions, file searches, reading files), use make these tool calls in parallel instead of sequential. Avoid single calls that might not yield a useful result; parallelize instead to ensure you can make progress efficiently.
 - Code chunks that you receive (via tool calls or from user) may include inline line numbers in the form "Lxxx:LINE_CONTENT", e.g. "L123:LINE_CONTENT". Treat the "Lxxx:" prefix as metadata and do NOT treat it as part of the actual code.
 - Default expectation: deliver working code, not just a plan. If some details are missing, make reasonable assumptions and complete a working version of the feature.
-- Prefer machine-readable CLI output when available: `cb ... --json` and `hdb ... --json` should be the default inspection path for agent workflows, with `--json-file <path>` used when a command supports writing the same payload to disk.
+- Prefer machine-readable CLI output when available: read-only inspection commands in `cb` and `hdb` should default to `--json`, with `--json-file <path>` used when the same payload should be written to disk.
 
 
 # Autonomy and Persistence

CLAUDE.md

@@ -42,7 +42,7 @@ TypeScript ESM monorepo (`module: NodeNext`). Three CLIs share a `src/shared/` l
 - `test/setup/no-network.ts` — global outbound-network block active in `vitest.config.ts`
 
 **Use explicit relative imports with `.js` specifiers** (NodeNext resolution).
-Prefer machine-readable CLI output for local inspection and automation when available: `cb ... --json` and `hdb ... --json`, plus `--json-file <path>` on commands that support file output.
+Prefer machine-readable CLI output for local inspection and automation when available: use `cb ... --json` and `hdb ... --json` on read-only inspection commands, plus `--json-file <path>` when the same payload should be written to disk.
 
 ### cb app boundaries
 

README.md

@@ -60,7 +60,7 @@ From source:
 Machine-readable CLI output:
 
 - prefer `cb ... --json` and `hdb ... --json` when you want structured output for automation or agent workflows
-- use `--json-file <path>` on commands that expose it when you want the same payload written to disk
+- use `--json-file <path>` on read-only inspection commands that expose it when you want the same payload written to disk
 
 ## Documentation
 

src/apps/cb/README.md

@@ -102,14 +102,19 @@ Notes:
   - `--json-file <path>` writes the same structured payload to disk and still prints JSON to stdout
   - `--value` adds a USD value column based on current product price (forced product refresh for supported products)
   - when `[product]` is provided, matching accounts are shown with price-based USD values
-- `cb balance` (alias: `usd`)
-- `cb cash`
-- `cb fees`
+- `cb balance [--json] [--json-file <path>]` (alias: `usd`)
+  - `--json` prints `{ row, meta }`
+- `cb cash [--json] [--json-file <path>] [--raw] [--value]`
+  - same structured payload and formatting flags as `cb accounts --cash`
+- `cb fees [--json] [--json-file <path>]`
+  - `--json` prints `{ row, meta }`
 
 ### Products
 
-- `cb product [product]`
-- `cb price [product]`
+- `cb product [product] [--json] [--json-file <path>]`
+  - `--json` prints `{ row, meta }`
+- `cb price [product] [--json] [--json-file <path>]`
+  - `--json` prints `{ row, meta }`
 
 ### Market Orders
 
@@ -133,8 +138,10 @@ Notes:
 
 ### Orders
 
-- `cb order get <order_id>`
-- `cb order list [product]` (alias: `cb orders [product]`)
+- `cb order get <order_id> [--json] [--json-file <path>]`
+  - `--json` prints `{ row, meta }`
+- `cb order list [product] [--json] [--json-file <path>]` (alias: `cb orders [product]`)
+  - `--json` prints `{ rows, filters, meta }`
 - `cb order cancel <order_id>`
 - `cb order replace <order_id>` (re-places a cancelled priced order with the same prices and attached TP/SL when present; funding must be available: base asset for sells, USD for buys)
 - `cb order modify <order_id> [--baseSize <baseSize>] [--limitPrice <limitPrice>] [--stopPrice <stopPrice>] [--takeProfitPrice <takeProfitPrice>]` (supports limit, stop-limit, bracket, and TP/SL orders)
@@ -168,6 +175,8 @@ Examples:
 cb accounts --json
 cb accounts btc-usd --json
 cb accounts --crypto --raw --json-file tmp/accounts.json
+cb price eth --json
+cb order list btc-usd --json-file tmp/open-orders.json
 ```
 
 ## Development

src/apps/cb/commands/account-handlers.ts

@@ -1,7 +1,5 @@
-import { mkdirSync, writeFileSync } from "node:fs";
-import path from "node:path";
-import process from "node:process";
-import type { AccountsOptions } from "./schemas/command-options.js";
+import { emitJsonOutput } from "./json-output.js";
+import type { AccountsOptions, InspectOptions } from "./schemas/command-options.js";
 import { toIncrement } from "../../../shared/common/index.js";
 import {
   getProductInfo,
@@ -134,16 +132,6 @@ function buildAccountsJsonPayload(
   };
 }
 
-function printAccountsJson(payload: AccountsJsonPayload): void {
-  console.log(JSON.stringify(payload, null, 2));
-}
-
-function writeAccountsJsonFile(payload: AccountsJsonPayload, jsonFile: string): void {
-  const outputPath = path.resolve(process.cwd(), jsonFile);
-  mkdirSync(path.dirname(outputPath), { recursive: true });
-  writeFileSync(outputPath, `${JSON.stringify(payload, null, 2)}\n`);
-}
-
 function buildProductJsonRows(
   accounts: CoinbaseAccount[],
   price: string,
@@ -277,10 +265,7 @@ export async function handleAccountsAction(
         options,
         product,
       );
-      if (options.jsonFile) {
-        writeAccountsJsonFile(payload, options.jsonFile);
-      }
-      printAccountsJson(payload);
+      emitJsonOutput(payload, options);
       return;
     }
     console.table(
@@ -311,10 +296,7 @@ export async function handleAccountsAction(
         options,
         product,
       );
-      if (options.jsonFile) {
-        writeAccountsJsonFile(payload, options.jsonFile);
-      }
-      printAccountsJson(payload);
+      emitJsonOutput(payload, options);
       return;
     }
 
@@ -338,24 +320,55 @@ export async function handleAccountsAction(
   }
 }
 
-export async function handleBalanceAction() {
+export async function handleBalanceAction(options: InspectOptions = {}): Promise<void> {
   const { available, hold, total } = await requestCurrencyAccount("USD", "0.01");
+  if (options.json || options.jsonFile) {
+    emitJsonOutput({
+      row: {
+        currency: "USD",
+        available,
+        hold,
+        total,
+      },
+      meta: {
+        view: "balance",
+      },
+    }, options);
+    return;
+  }
   console.log("USD ($)");
   console.log(`Available: $${available}`);
   console.log(`Hold: $${hold}`);
   console.log(`Total: $${total}`);
 }
 
-export async function handleCashAction() {
+export async function handleCashAction(options: AccountsOptions = {}): Promise<void> {
   const accountsOptions: AccountsOptions = {
     cash: true,
+    ...options,
   };
   return handleAccountsAction(null, accountsOptions);
 }
 
-export async function handleFeesAction() {
+export async function handleFeesAction(options: InspectOptions = {}): Promise<void> {
   const { total_fees, total_volume, fee_tier, total_balance } = await getTransactionSummary();
   const { pricing_tier, taker_fee_rate, maker_fee_rate } = fee_tier;
+  if (options.json || options.jsonFile) {
+    emitJsonOutput({
+      row: {
+        totalBalance: total_balance,
+        totalVolume: total_volume,
+        pricingTier: pricing_tier,
+        takerFeeRate: taker_fee_rate,
+        makerFeeRate: maker_fee_rate,
+        totalFees: total_fees,
+      },
+      meta: {
+        view: "fees",
+      },
+    }, options);
+    return;
+  }
   console.log("Transaction Summary:");
   console.log(`  Total balance: ${total_balance}`);
   console.log(`  Total volume: ${total_volume}`);

src/apps/cb/commands/json-output.ts

@@ -0,0 +1,36 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import process from "node:process";
+
+export type JsonObject = Record<string, unknown>;
+
+export function serializeJson(payload: JsonObject): string {
+  return `${JSON.stringify(payload, null, 2)}\n`;
+}
+
+export function printJson(payload: JsonObject): void {
+  console.log(serializeJson(payload).trimEnd());
+}
+
+export function writeJsonFile(filePath: string, payload: JsonObject): string {
+  const outputPath = path.resolve(process.cwd(), filePath);
+  mkdirSync(path.dirname(outputPath), { recursive: true });
+  writeFileSync(outputPath, serializeJson(payload));
+  return outputPath;
+}
+
+export function emitJsonOutput(
+  payload: JsonObject,
+  options: {
+    json?: boolean | undefined;
+    jsonFile?: string | undefined;
+  },
+): void {
+  if (options.jsonFile) {
+    writeJsonFile(options.jsonFile, payload);
+  }
+
+  if (options.json || options.jsonFile) {
+    printJson(payload);
+  }
+}

src/apps/cb/commands/order-handlers.ts

@@ -2,20 +2,43 @@ import process from "node:process";
 import { cancelOrder, getOpenOrders, getOrder } from "../../../shared/coinbase/index.js";
 import { logger, printOrder } from "../../../shared/log/index.js";
 import type { ProductId } from "../../../shared/schemas/shared-primitives.js";
-import type { BreakEvenStopOptions, ModifyOptions } from "./schemas/command-options.js";
+import { emitJsonOutput } from "./json-output.js";
+import type { BreakEvenStopOptions, InspectOptions, ModifyOptions } from "./schemas/command-options.js";
 import {
   placeBreakEvenStopOrder,
   placeModifyOrder,
   replaceCancelledOrder,
 } from "../service/order-service.js";
 
-export async function handleOrderAction(orderId: string): Promise<void> {
+export async function handleOrderAction(orderId: string, options: InspectOptions = {}): Promise<void> {
   const order = await getOrder(orderId);
+  if (options.json || options.jsonFile) {
+    emitJsonOutput({
+      row: order,
+      meta: {
+        orderId,
+        view: "get",
+      },
+    }, options);
+    return;
+  }
   printOrder(order);
 }
 
-export async function handleOrdersAction(productId: ProductId | null): Promise<void> {
+export async function handleOrdersAction(productId: ProductId | null, options: InspectOptions = {}): Promise<void> {
   const openOrders = await getOpenOrders(productId);
+  if (options.json || options.jsonFile) {
+    emitJsonOutput({
+      rows: openOrders,
+      filters: {
+        productId,
+      },
+      meta: {
+        rowCount: openOrders.length,
+      },
+    }, options);
+    return;
+  }
   if (openOrders.length === 0) {
     logger.info("No open orders found.");
   } else {

src/apps/cb/commands/product-handlers.ts

@@ -3,25 +3,53 @@ import {
   getProductInfo,
   requestMarketTrades,
 } from "../../../shared/coinbase/index.js";
+import { emitJsonOutput } from "./json-output.js";
+import type { InspectOptions } from "./schemas/command-options.js";
 
-export async function handleProductAction(product: string = "btc"): Promise<void> {
+export async function handleProductAction(product: string = "btc", options: InspectOptions = {}): Promise<void> {
   const productId = getProductId(product);
   const productInfo = await getProductInfo(productId);
+  if (options.json || options.jsonFile) {
+    emitJsonOutput({
+      row: productInfo,
+      meta: {
+        productId,
+        view: "product",
+      },
+    }, options);
+    return;
+  }
   console.dir(productInfo);
 }
 
-export async function handlePriceAction(product: string = "btc"): Promise<void> {
+export async function handlePriceAction(product: string = "btc", options: InspectOptions = {}): Promise<void> {
   const productId = getProductId(product);
   const { trades, best_bid, best_ask } = await requestMarketTrades(productId, 1);
   if (!trades[0]) {
     throw new Error("Trades not found");
   }
+  const row = {
+    productId,
+    price: trades[0].price,
+    bid: best_bid,
+    ask: best_ask,
+  };
+  if (options.json || options.jsonFile) {
+    emitJsonOutput({
+      row,
+      meta: {
+        productId,
+        view: "price",
+      },
+    }, options);
+    return;
+  }
   console.table([
     {
-      Product: productId,
-      Price: trades[0].price,
-      Bid: best_bid,
-      Ask: best_ask,
+      Product: row.productId,
+      Price: row.price,
+      Bid: row.bid,
+      Ask: row.ask,
     },
   ]);
 }

src/apps/cb/commands/register/register-accounts.ts

@@ -1,12 +1,12 @@
 import type { Command } from "commander";
-import { AccountsOptionsSchema } from "../schemas/command-options.js";
+import { AccountsOptionsSchema, InspectOptionsSchema } from "../schemas/command-options.js";
 import {
   handleAccountsAction,
   handleBalanceAction,
   handleCashAction,
   handleFeesAction,
 } from "../account-handlers.js";
-import { parseNone, parseOptionalProductOptions, withAction } from "./register-utils.js";
+import { parseOptionalProductOptions, parseOptions, withAction } from "./register-utils.js";
 
 export function registerAccountsCommands(program: Command) {
   program
@@ -31,11 +31,22 @@ export function registerAccountsCommands(program: Command) {
     .command("balance")
     .alias("usd")
     .description("Show USD available, hold, and total balances")
-    .action(withAction("balance", parseNone(), handleBalanceAction));
+    .option("--json", "Print machine-readable JSON output", false)
+    .option("--json-file <path>", "Write machine-readable JSON output to <path>")
+    .action(withAction("balance", parseOptions(InspectOptionsSchema), handleBalanceAction));
 
-  program.command("cash").description("List non-zero fiat (cash) account balances").action(handleCashAction);
+  program
+    .command("cash")
+    .description("List non-zero fiat (cash) account balances")
+    .option("--json", "Print machine-readable JSON output", false)
+    .option("--json-file <path>", "Write machine-readable JSON output to <path>")
+    .option("--raw", "Show hold and available sizes without increment-based rounding", false)
+    .option("--value", "Show estimated USD value using current product prices", false)
+    .action(withAction("cash", parseOptions(AccountsOptionsSchema), handleCashAction));
   program
     .command("fees")
     .description("Show transaction summary with pricing tier and maker/taker fees")
-    .action(handleFeesAction);
+    .option("--json", "Print machine-readable JSON output", false)
+    .option("--json-file <path>", "Write machine-readable JSON output to <path>")
+    .action(withAction("fees", parseOptions(InspectOptionsSchema), handleFeesAction));
 }