@binaryandthread/cli 0.1.9 → 0.2.0

package/dist/bin.js

@@ -26,18 +26,21 @@ import {
   displayName,
   empty,
   fail,
+  failResult,
   firstPrice,
   fmtPrice,
   formatCartLine,
   formatFatal,
   green,
   header,
+  isCartTaxInclusive,
   lineColour,
   ok,
   printResult,
   productColours,
   productLore,
   redact,
+  regionLine,
   registerStage,
   registerView,
   resolveLineItemRef,
@@ -46,10 +49,11 @@ import {
   rule,
   runStage,
   stageMarker,
+  taxSuffix,
   versionLine,
   warn,
   working
-} from "./chunk-RGXH3EZ6.js";
+} from "./chunk-NJ3DW5AX.js";
 import {
   __require
 } from "./chunk-7OCVIDC7.js";
@@ -78,7 +82,7 @@ function makeLogger(debug, write = (s) => process.stderr.write(s)) {
 }
 
 // src/version.ts
-var VERSION = "0.1.9";
+var VERSION = "0.2.0";
 
 // src/eggs.ts
 function teapot() {
@@ -371,24 +375,55 @@ function deleteToken(deps = {}) {
 }
 
 // src/commands/browse.ts
-function productRow(p, index, stage, style) {
-  const { amount, currency } = firstPrice(p);
-  const { title, handle } = displayName(p);
-  const colours = colourMarker(productColours(p));
-  const ref = dim(style, `[${index + 1}]`.padEnd(4));
-  const parts = [
-    title.padEnd(22),
-    cyan(style, fmtPrice(amount, currency).padEnd(11)),
-    dim(style, handle.padEnd(30)),
-    stageMarker(stage)
-  ];
-  const row = `${ref} ${parts.join(" ")}`.trimEnd();
-  return colours ? `${row}
-       ${dim(style, colours)}` : row;
+function truncate(s, w) {
+  if (s.length <= w) return s;
+  if (w <= 1) return s.slice(0, Math.max(0, w));
+  return s.slice(0, w - 1) + "\u2026";
+}
+function layoutRows(rows, style) {
+  const cells = rows.map(({ p, stage }, i) => {
+    const { amount, currency } = firstPrice(p);
+    const { title, handle } = displayName(p);
+    return {
+      ref: `[${i + 1}]`,
+      title,
+      price: fmtPrice(amount, currency),
+      handle,
+      stage,
+      colours: colourMarker(productColours(p))
+    };
+  });
+  const refW = Math.max(...cells.map((c) => c.ref.length));
+  const priceW = Math.max(...cells.map((c) => c.price.length));
+  const handleW = Math.max(...cells.map((c) => c.handle.length));
+  const maxTitle = Math.max(...cells.map((c) => c.title.length));
+  const GAP = 2;
+  const STAGE_W = 12;
+  const term = process.stdout.columns ?? 0;
+  let titleW = maxTitle;
+  if (term > 0) {
+    const fixed = refW + GAP + priceW + GAP + handleW + GAP + STAGE_W;
+    titleW = Math.max(12, Math.min(maxTitle, term - fixed));
+  }
+  const out = [];
+  for (const c of cells) {
+    const row = [
+      dim(style, c.ref.padEnd(refW)),
+      truncate(c.title, titleW).padEnd(titleW),
+      cyan(style, c.price.padStart(priceW)),
+      // right-align money — reads like a ledger
+      dim(style, c.handle.padEnd(handleW)),
+      stageMarker(c.stage)
+    ].join("  ").trimEnd();
+    out.push(c.colours ? `${row}
+       ${dim(style, c.colours)}` : row);
+  }
+  return out;
 }
 async function runBrowse(client, config, args) {
   const style = brandOf(args);
-  const region = await client.resolveRegion(config.region);
+  const rr = await client.resolveRegionResult(config.region);
+  const region = rr.region;
   const products = await client.listProducts({ region });
   const rows = products.map((p) => ({
     p,
@@ -404,9 +439,8 @@ async function runBrowse(client, config, args) {
     lines.push("   peek at next \u2192 bt browse --branch=next");
   } else {
     lines.push(header(style, "bt browse \u2014 in stock"));
-    rows.forEach(({ p, stage }, i) => {
-      lines.push(productRow(p, i, stage, style));
-    });
+    lines.push(regionLine(rr, style));
+    lines.push(...layoutRows(rows, style));
     for (const d of drops) {
       const dt = (d.title ?? d.handle ?? d.id).toString();
       lines.push(
@@ -421,6 +455,10 @@ async function runBrowse(client, config, args) {
     if (drops.length > 0) {
       lines.push("   on next, before the web \u2192 bt drops");
     }
+    const taxIncl = rows.length > 0 ? firstPrice(rows[0].p).taxInclusive : null;
+    if (taxIncl === true) {
+      lines.push(dim(style, "   prices incl. VAT"));
+    }
     lines.push("   view one \u2192 bt view <n|slug>   \xB7   stage one \u2192 bt stage <n|slug> --size L");
   }
   return {
@@ -440,7 +478,7 @@ function registerBrowse(program, makeClient2, loadConfig2) {
   program.command("browse").alias("ls").description("list what's in stock on a branch.").option("--branch <branch>", "main (live) or next (terminal-only drops)").option("--pick", "opt into the arrow-key picker (default is the numbered table \u2014 use bt stage <n>)").option("--plain", "force the static table (the default; kept for back-compat)").action(async (opts) => {
     const { json, brand } = resolveOutput(program);
     if (opts.pick && !json && brand.color && process.stdout.isTTY && process.stdin.isTTY) {
-      const { runInteractiveBrowse } = await import("./interactive-2YROZBIN.js");
+      const { runInteractiveBrowse } = await import("./interactive-5PBJCENZ.js");
       const handled = await runInteractiveBrowse(makeClient2(), loadConfig2(), { branch: opts.branch, brand });
       if (handled) return;
     }
@@ -449,6 +487,143 @@ function registerBrowse(program, makeClient2, loadConfig2) {
   });
 }
 
+// src/commands/region.ts
+var MAX_COUNTRIES_SHOWN = 8;
+function regionRow(r) {
+  const ccs = (r.countries ?? []).map((c) => (c.iso_2 ?? "").toLowerCase()).filter(Boolean).sort();
+  const shown = ccs.slice(0, MAX_COUNTRIES_SHOWN).join(" \xB7 ");
+  const more = ccs.length > MAX_COUNTRIES_SHOWN ? ` \u2026 (${ccs.length})` : "";
+  return `   ${r.currency_code.toLowerCase().padEnd(5)} ${shown}${more}`.trimEnd();
+}
+async function runRegion(client, config, args) {
+  const style = brandOf(args);
+  if (args.cc) {
+    const cc = args.cc.trim().toLowerCase();
+    const rr2 = await client.resolveRegionResult(cc);
+    if (!rr2.matched) {
+      return failResult({
+        code: EXIT.DATAERR,
+        what: `we don't ship to ${cc} yet. nothing was set.`,
+        fix: "bt region --list   (see where we ship)"
+      });
+    }
+    return {
+      lines: [ok(`region \u2192 ${cc} \xB7 prices in ${rr2.region.currency_code}`)],
+      save: { region: cc },
+      json: args.json ? { region: cc, currency: rr2.region.currency_code } : void 0
+    };
+  }
+  if (args.list) {
+    const regions = await client.getRegions();
+    const lines = [
+      dim(style, "where we ship, and what you pay in:"),
+      ...regions.map(regionRow),
+      dim(style, "   set yours \u2192 bt region <cc>")
+    ];
+    return {
+      lines,
+      json: args.json ? { regions: regions.map((r) => ({ currency: r.currency_code, countries: (r.countries ?? []).map((c) => c.iso_2) })) } : void 0
+    };
+  }
+  const rr = await client.resolveRegionResult(config.region);
+  return {
+    lines: [regionLine(rr, style), dim(style, "   change \u2192 bt region <cc>   \xB7   all \u2192 bt region --list")],
+    json: args.json ? { region: rr.requested ?? null, currency: rr.region.currency_code, matched: rr.matched, home: rr.home } : void 0
+  };
+}
+function registerRegion(program, makeClient2, loadConfig2, persist) {
+  program.command("region").argument("[cc]", "set your ship-to country (ISO-2, e.g. se / us / de)").option("--list", "list every country we ship to + its currency").description("see (or set) your ship-to country + currency.").action(async (cc, opts) => {
+    const { json, brand } = resolveOutput(program);
+    const res = await runRegion(makeClient2(), loadConfig2(), { cc, list: opts.list, json, brand });
+    if (res.save) {
+      persist(res.save);
+    }
+    printResult(res, json);
+  });
+}
+
+// src/commands/completion.ts
+var COMMANDS = [
+  "browse",
+  "search",
+  "view",
+  "stage",
+  "buy",
+  "cart",
+  "unstage",
+  "checkout",
+  "commit",
+  "order",
+  "log",
+  "status",
+  "whoami",
+  "region",
+  "drops",
+  "blame",
+  "login",
+  "logout",
+  "config",
+  "token",
+  "doctor",
+  "report",
+  "connect",
+  "init",
+  "completion"
+];
+function completionScript(shell) {
+  const list = COMMANDS.join(" ");
+  if (shell === "bash") {
+    return [
+      '# bt bash completion \u2014 add to ~/.bashrc:  eval "$(bt completion bash)"',
+      "_bt_completions() {",
+      '  local cur="${COMP_WORDS[COMP_CWORD]}"',
+      `  COMPREPLY=( $(compgen -W "${list}" -- "$cur") )`,
+      "}",
+      "complete -F _bt_completions bt btn",
+      ""
+    ].join("\n");
+  }
+  if (shell === "zsh") {
+    return [
+      "#compdef bt btn",
+      '# bt zsh completion \u2014 add to ~/.zshrc:  eval "$(bt completion zsh)"',
+      "_bt() {",
+      "  local -a cmds",
+      `  cmds=(${list})`,
+      "  _describe 'command' cmds",
+      "}",
+      "compdef _bt bt btn",
+      ""
+    ].join("\n");
+  }
+  return [
+    "# bt fish completion \u2014  bt completion fish | source",
+    "complete -c bt -f",
+    `for c in ${list}`,
+    "  complete -c bt -n __fish_use_subcommand -a $c",
+    "end",
+    ""
+  ].join("\n");
+}
+function runCompletion(args) {
+  const shell = (args.shell ?? "").trim().toLowerCase();
+  if (shell !== "bash" && shell !== "zsh" && shell !== "fish") {
+    return failResult({
+      code: EXIT.DATAERR,
+      what: `unknown shell "${args.shell ?? ""}".`,
+      fix: "bt completion <bash|zsh|fish>"
+    });
+  }
+  const script = completionScript(shell);
+  return { lines: [script], json: args.json ? { shell, script } : void 0 };
+}
+function registerCompletion(program) {
+  program.command("completion").argument("<shell>", "bash | zsh | fish").description("print a shell completion script (eval it in your shell rc).").action((shell) => {
+    const { json } = resolveOutput(program);
+    printResult(runCompletion({ shell, json }), json);
+  });
+}
+
 // src/commands/search.ts
 function matches(p, q) {
   const needle = q.toLowerCase();
@@ -523,13 +698,19 @@ async function runCart(client, config, args) {
         lines.push(formatCartLine(item, i, cart.currency_code, style));
       });
       if (cart.total != null) {
-        lines.push(`   total    ${cyan(style, fmtPrice(cart.total, cart.currency_code))} incl. VAT`);
+        const shipNote = (cart.shipping_methods ?? []).length > 0 ? "" : dim(style, "   (excl. shipping \u2014 calculated at checkout)");
+        lines.push(`   total    ${cyan(style, fmtPrice(cart.total, cart.currency_code))}${taxSuffix(isCartTaxInclusive(cart))}${shipNote}`);
       }
       lines.push("   remove one \u2192 bt unstage <#>   \xB7   commit \u2192 bt commit");
     }
     return {
       lines,
-      json: args.json ? { cart_id: cart.id, items: cart.items ?? [], total: cart.total ?? null } : void 0
+      json: args.json ? {
+        cart_id: cart.id,
+        items: cart.items ?? [],
+        total: cart.total ?? null,
+        total_excludes_shipping: (cart.shipping_methods ?? []).length === 0
+      } : void 0
     };
   } catch (e) {
     if (e instanceof RecoverableCartError) {
@@ -641,6 +822,7 @@ async function runCheckout(client, config, args, deps) {
   }
   const itemCount = cart.items.reduce((n, li) => n + (li.quantity ?? 1), 0);
   const totalLine = fmtPrice(shippedCart?.total ?? cart.total, cart.currency_code ?? region.currency_code);
+  const taxIncl = isCartTaxInclusive(cart);
   const reviewLines = [header(style, "bt checkout \u2014 staged for commit")];
   for (const li of cart.items) {
     const colour = lineColour(li);
@@ -649,7 +831,7 @@ async function runCheckout(client, config, args, deps) {
       `   ${(li.title ?? li.product_title ?? "item").toString()}${colourTag} \xB7 qty ${li.quantity}` + (li.total != null ? `   ${cyan(style, fmtPrice(li.total, cart.currency_code ?? region.currency_code))}` : "")
     );
   }
-  reviewLines.push(`   total    ${cyan(style, totalLine)} incl. VAT`);
+  reviewLines.push(`   total    ${cyan(style, totalLine)}${taxSuffix(taxIncl)}`);
   const print = deps.print ?? ((line) => process.stdout.write(line + "\n"));
   for (const line of reviewLines) {
     print(line);
@@ -657,7 +839,7 @@ async function runCheckout(client, config, args, deps) {
   const autoProceed = Boolean(args.json) || Boolean(args.yes);
   if (!autoProceed) {
     const proceed = await prompts.confirm(
-      `proceed to checkout? ${itemCount} item${itemCount === 1 ? "" : "s"} \xB7 ${totalLine} incl. VAT (y/n):`
+      `proceed to checkout? ${itemCount} item${itemCount === 1 ? "" : "s"} \xB7 ${totalLine}${taxSuffix(taxIncl)} (y/n):`
     );
     if (!proceed) {
       return {
@@ -702,7 +884,7 @@ async function runCheckout(client, config, args, deps) {
     lines.push(ok("deploy successful."));
     lines.push(`   committed to wardrobe@main`);
     lines.push(`   order      #${displayId}`);
-    lines.push(`   total      ${cyan(style, totalLine)}   (incl. VAT)`);
+    lines.push(`   total      ${cyan(style, totalLine)}${taxIncl ? "   (incl. VAT)" : ""}`);
     if (shipsTo) {
       lines.push(`   ships to   ${shipsTo} \xB7 ~3\u20136 working days`);
     } else {
@@ -715,7 +897,15 @@ async function runCheckout(client, config, args, deps) {
     return {
       lines,
       save,
-      json: args.json ? { status: "placed", order_id: outcome.order_id, display_id: displayId } : void 0
+      json: args.json ? {
+        status: "placed",
+        order_id: outcome.order_id,
+        display_id: displayId,
+        // A2 — the SHIPPING-INCLUSIVE total the buyer consented to (same figure as the review),
+        // so a --json / bt buy consumer has the real amount, not just a status.
+        total: shippedCart?.total ?? cart.total ?? null,
+        currency: cart.currency_code ?? region.currency_code ?? null
+      } : void 0
     };
   }
   if (outcome.status === "expired") {
@@ -731,7 +921,7 @@ async function runCheckout(client, config, args, deps) {
     fail({
       code: 75,
       what: "checkout handoff timed out \u2014 we didn't see the order complete.",
-      money: "nothing was charged; your stage is still held.",
+      money: "if you completed payment, your order is safe; if not, your stage is still held \u2014 check your email or bt order.",
       fix: "bt checkout --resume   (or open the link below manually)",
       link: checkout_url
     })
@@ -821,40 +1011,33 @@ function timelineGraph(idx) {
 async function runOrder(client, config, args) {
   const email = config.email;
   if (!email) {
-    return {
-      lines: [
-        fail({
-          code: 1,
-          what: "order lookup needs your email.",
-          fix: "bt config email <you@example.com>   (then retry)"
-        })
-      ]
-    };
+    return failResult({
+      code: EXIT.DATAERR,
+      what: "order lookup needs your email.",
+      fix: "bt config set email <you@example.com>   (then retry)"
+    });
   }
   const looked = await client.getOrder(args.displayId, email);
   if (!looked) {
-    return {
-      lines: [
-        fail({
-          code: 1,
-          what: `order ${args.displayId} not found for that email.`,
-          fix: "check the order number + the email it was placed with."
-        })
-      ]
-    };
+    return failResult({
+      code: EXIT.UNAVAILABLE,
+      what: `order ${args.displayId} not found for that email.`,
+      fix: "check the order number + the email it was placed with."
+    });
   }
   const o = looked.order ?? looked;
   const idx = stageIndex(o);
   const display = o.display_id ?? args.displayId;
   const total = fmtPrice(o.total ?? null, o.currency_code ?? null);
   const items = o.items ?? [];
+  const orderTaxInclusive = items.some((i) => i.is_tax_inclusive === true);
   const first = items[0];
   const itemLabel = first ? `${first.title ?? "item"}${first.variant_title ? ` \xB7 ${first.variant_title}` : ""}` : "your order";
   const style = brandOf(args);
   const lines = [];
   lines.push(`${display}  ${itemLabel}   ${cyan(style, timelineGraph(idx))}  ${STAGES[idx]}`);
   lines.push(`      ${STAGES.join(" \u2192 ")}${idx === 4 ? " \u{1F389}" : ""}`);
-  lines.push(`      total ${cyan(style, total)} incl. VAT`);
+  lines.push(`      total ${cyan(style, total)}${taxSuffix(orderTaxInclusive)}`);
   return {
     lines,
     json: args.json ? { display_id: display, stage: STAGES[idx], total: o.total ?? null, currency: o.currency_code ?? null } : void 0
@@ -1048,7 +1231,7 @@ async function runStatus(client, config, args) {
         lines.push(formatCartLine(li, i, cart.currency_code, style));
       });
       if (cart.total != null) {
-        lines.push(`   total    ${cyan(style, fmtPrice(cart.total, cart.currency_code))} incl. VAT`);
+        lines.push(`   total    ${cyan(style, fmtPrice(cart.total, cart.currency_code))}${taxSuffix(isCartTaxInclusive(cart))}`);
       }
       lines.push("   remove one \u2192 bt unstage <#>   \xB7   commit \u2192 bt commit");
     }
@@ -1104,7 +1287,9 @@ async function runUnstage(client, config, args) {
           warn(`no such item in your cart: "${args.itemId}"`),
           "   see what's staged (with its #) \u2192 bt cart"
         ],
-        json: args.json ? { cart_id: before.id, removed: null, items: beforeItems } : void 0
+        json: args.json ? { cart_id: before.id, removed: null, items: beforeItems } : void 0,
+        exitCode: EXIT.DATAERR
+        // bad ref → non-zero so a script can't proceed as if it removed something (B3)
       };
     }
     await client.removeLineItem(config.cart_id, target.id);
@@ -1115,12 +1300,14 @@ async function runUnstage(client, config, args) {
       return {
         lines: [
           fail({
-            code: 1,
+            code: EXIT.GENERIC,
             what: `couldn't unstage "${(target.title ?? target.product_title ?? args.itemId).toString()}" \u2014 it's still in your cart.`,
             fix: "check what's staged \u2192 bt cart   (then try the # shown, or bt forget to clear)"
           })
         ],
-        json: args.json ? { cart_id: after.id, removed: null, items: afterItems } : void 0
+        json: args.json ? { cart_id: after.id, removed: null, items: afterItems } : void 0,
+        exitCode: EXIT.GENERIC
+        // the server didn't drop it → honest non-zero, never a fake success (B3)
       };
     }
     const removedTitle = (target.title ?? target.product_title ?? "item").toString();
@@ -1145,7 +1332,8 @@ async function runUnstage(client, config, args) {
           warn("that cart is no longer valid (expired or already committed)."),
           empty(FRESH_REPO2),
           "   re-stage \u2192 bt browse"
-        ]
+        ],
+        json: args.json ? { cart_id: null, removed: null, items: [] } : void 0
       };
     }
     throw e;
@@ -1275,7 +1463,8 @@ function mergesIn(nextUntil) {
   if (hours < 48) return `merges to main in ${hours}h`;
   return `merges to main in ${Math.round(hours / 24)}d`;
 }
-async function runDrops(client, _config, args) {
+async function runDrops(client, config, args) {
+  const region = await client.resolveRegion(config.region);
   const drops = await client.listDrops();
   if (!drops || drops.length === 0) {
     return {
@@ -1291,7 +1480,7 @@ async function runDrops(client, _config, args) {
     lines.push(
       [
         `  ${(d.handle ?? d.id).padEnd(32)}`,
-        fmtPrice(d.price, null).padEnd(10),
+        fmtPrice(d.price, region.currency_code).padEnd(10),
         mergesIn(d.next_until)
       ].join(" ").trimEnd()
     );
@@ -1344,6 +1533,35 @@ function registerConnect(program) {
 // src/commands/login.ts
 var EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
 async function runLogin(client, prompts, keychain, config, args) {
+  if (args.json) {
+    const jsonEmail = (args.email ?? "").trim();
+    const jsonToken = (args.token ?? "").trim();
+    if (!jsonEmail || !EMAIL_RE.test(jsonEmail) || !jsonToken) {
+      return failResult({
+        code: EXIT.DATAERR,
+        what: "login --json is non-interactive \u2014 it needs --email and a token in BT_MAGIC_TOKEN.",
+        fix: "bt login --email you@dev.to   with BT_MAGIC_TOKEN=<the token from the email>"
+      });
+    }
+    let jsonResult;
+    try {
+      jsonResult = await client.verifyMagicLink(jsonToken);
+    } catch (e) {
+      if (e instanceof StoreApiError && (e.status === 401 || e.status === 403)) {
+        return failResult({ code: EXIT.NOPERM, what: "that token is invalid or expired.", fix: "request a fresh one, then set BT_MAGIC_TOKEN" });
+      }
+      if (e instanceof StoreApiError) {
+        return failResult({ code: EXIT.TEMPFAIL, what: "login couldn't complete right now.", fix: "try again in a moment" });
+      }
+      throw e;
+    }
+    keychain.setToken(jsonResult.jwt);
+    return {
+      lines: [ok("authenticated. welcome \u2014 you're a contributor now.")],
+      save: { email: jsonEmail },
+      json: { connected: true, customer_id: jsonResult.customer.id }
+    };
+  }
   let email = (args.email ?? "").trim();
   if (!email) {
     email = (await prompts.ask("email", { default: config.email })).trim();
@@ -1410,11 +1628,7 @@ function registerLogin(program, makeClient2, loadConfig2, prompts, keychain, per
     if (res.save) {
       persist(res.save);
     }
-    if (json && res.json !== void 0) {
-      process.stdout.write(JSON.stringify(res.json) + "\n");
-    } else {
-      process.stdout.write(res.lines.join("\n") + "\n");
-    }
+    printResult(res, json);
   });
 }
 
@@ -1425,13 +1639,15 @@ async function runLogout(keychain) {
     lines: [
       ok("logged out. your token is wiped from this machine's keychain."),
       empty("   (server tokens are short-lived by design \u2014 they expire on their own.)")
-    ]
+    ],
+    json: { logged_out: true }
   };
 }
 function registerLogout(program, keychain) {
   program.command("logout").description("clear your local session (wipes the keychain token).").action(async () => {
+    const { json } = resolveOutput(program);
     const res = await runLogout(keychain);
-    process.stdout.write(res.lines.join("\n") + "\n");
+    printResult(res, json);
   });
 }
 
@@ -1472,7 +1688,9 @@ async function runDrop(args, exec) {
   if (code !== 0) {
     return {
       lines: [warn(`drop ${sub} reported a problem (exit ${code}). check the backend logs / ops alert.`)],
-      json: args.json ? { sub, drop_id: args.dropId, exit: code } : void 0
+      json: args.json ? { sub, drop_id: args.dropId, exit: code } : void 0,
+      exitCode: code
+      // forward the backend's exit code so operator CI can branch on $? (B3)
     };
   }
   const done = {
@@ -1490,16 +1708,12 @@ function registerDrop(program, exec) {
   program.command("drop", { hidden: true }).argument("<sub>", "create | verify | promote | retire").option("--motif <slug>", "motif slug (create)").option("--drop-id <id>", "the drop id").option("--stage <stage>", "expected stage for verify (next|main)").description("operator: manage a drop's lifecycle (create/verify/promote/retire).").action(async (sub, opts) => {
     const { json } = resolveOutput(program);
     const operator = process.env.BT_OPERATOR === "1";
-    process.stdout.write(working(`drop ${sub}\u2026`) + "\n");
+    if (!json) process.stdout.write(working(`drop ${sub}\u2026`) + "\n");
     const res = await runDrop(
       { sub, motif: opts.motif, dropId: opts.dropId, stage: opts.stage, operator, json },
       exec
     );
-    if (json && res.json !== void 0) {
-      process.stdout.write(JSON.stringify(res.json) + "\n");
-    } else {
-      process.stdout.write(res.lines.join("\n") + "\n");
-    }
+    printResult(res, json);
   });
 }
 
@@ -1611,21 +1825,19 @@ function runConfig(args, deps) {
   }
   if (sub === "set") {
     if (!args.key || args.value == null || args.value === "") {
-      return { lines: [warn("usage: bt config set <key> <value>")] };
+      return failResult({ code: EXIT.DATAERR, what: "config set needs a key and a value.", fix: "bt config set <key> <value>" });
     }
     if (!SETTABLE.includes(args.key)) {
-      return {
-        lines: [
-          warn(
-            `can't set "${args.key}". settable keys: ${SETTABLE.join(", ")}. (the auth token is never stored in config \u2014 use bt login.)`
-          )
-        ]
-      };
+      return failResult({
+        code: EXIT.DATAERR,
+        what: `can't set "${args.key}".`,
+        fix: `settable keys: ${SETTABLE.join(", ")}   (the auth token is never stored in config \u2014 use bt login)`
+      });
     }
     deps.save({ [args.key]: args.value });
     return { lines: [ok(`set ${args.key} = ${args.value}`)], json: args.json ? { [args.key]: args.value } : void 0 };
   }
-  return { lines: [warn("usage: bt config get [key]  |  bt config set <key> <value>")] };
+  return failResult({ code: EXIT.DATAERR, what: `unknown config command "${sub}".`, fix: "bt config get [key]   |   bt config set <key> <value>" });
 }
 function registerConfig(program) {
   program.command("config").argument("[sub]", "get | set", "get").argument("[key]", "config key").argument("[value]", "value (for set)").description("view or set local prefs (email, region, defaults). the auth token is never stored here.").action(async (sub, key, value) => {
@@ -1644,7 +1856,9 @@ function runDoctor(s, json) {
     ok("bt doctor \u2014 local checkup (nothing was sent)"),
     `   bt          ${s.btVersion}`,
     `   node        ${s.node} \xB7 ${s.platform}`,
-    `   store       ${s.storeUrl}`,
+    // E4 — a friendly label for the production store; the raw URL only when pointed elsewhere
+    // (local/staging), where it's genuinely diagnostic. The JSON snapshot keeps the raw URL.
+    `   store       ${s.storeUrl === BT_DEFAULT_STORE_URL ? "binaryandthread.com (production)" : s.storeUrl}`,
     `   key         set (${s.keySource})`,
     `   auth        ${auth}`,
     `   terminal    ${s.tty ? "tty" : "non-tty"} \xB7 colour ${s.color ? "on" : "off"}`,
@@ -1793,7 +2007,7 @@ function buildProgram() {
   const program = new Command();
   program.name("bt").description(
     "the binary & thread terminal store. techno-minimalist clothing & lifestyle, bought with the ceremony of a deploy.\nprimary invocation: npx @binaryandthread/cli  (a bare `bt` may collide with another binary)"
-  ).version(versionLine(VERSION), "-v, --version", "print the version").option("--json", "machine-readable output", false).option("--no-color", "disable ANSI colour + inline images (also honours NO_COLOR)").option("--debug, --verbose", "trace requests to stderr (redacted) \u2014 for bug reports (d15)").showSuggestionAfterError();
+  ).version(versionLine(VERSION), "-v, --version", "print the version").option("--json", "machine-readable output", false).option("--no-color", "disable ANSI colour + inline images (also honours NO_COLOR)").option("--debug, --verbose", "trace requests to stderr (redacted) \u2014 for bug reports (d15)").option("--region <cc>", "ship-to country for this command (ISO-2, overrides your saved region)").showSuggestionAfterError();
   program.addHelpText("beforeAll", "\n  bt \u2014 the binary & thread terminal store. new here? \u2192 bt init\n");
   program.command("brew").argument("[what]", "what to brew").description("we make clothing, not coffee.").action(() => {
     process.stdout.write(teapot() + "\n");
@@ -1802,7 +2016,9 @@ function buildProgram() {
   program.command("forget").description("wipe your local session + config (keychain token, cart, email, defaults).").action(() => {
     deleteToken();
     forgetConfig();
-    process.stdout.write("\u2713  local session + config wiped. (your wardrobe on the server is untouched.)\n");
+    const json = Boolean(program.opts().json);
+    if (json) process.stdout.write(JSON.stringify({ wiped: true }) + "\n");
+    else process.stdout.write("\u2713  local session + config wiped. (your wardrobe on the server is untouched.)\n");
   });
   registerCommands(program);
   return program;
@@ -1822,34 +2038,41 @@ var dropExec = {
   }
 };
 function registerCommands(program) {
+  const persist = (patch) => {
+    saveConfig(patch);
+  };
+  const effectiveConfig = () => {
+    const saved = loadConfig();
+    const flag = program.opts().region;
+    return flag ? { ...saved, region: flag.trim().toLowerCase() } : saved;
+  };
   registerInit(program);
-  registerBrowse(program, makeClient, loadConfig);
-  registerSearch(program, makeClient, loadConfig);
-  registerView(program, makeClient, loadConfig);
-  registerStage(program, makeClient, loadConfig);
-  registerBuy(program, makeClient, loadConfig);
+  registerBrowse(program, makeClient, effectiveConfig);
+  registerSearch(program, makeClient, effectiveConfig);
+  registerView(program, makeClient, effectiveConfig);
+  registerStage(program, makeClient, effectiveConfig);
+  registerBuy(program, makeClient, effectiveConfig);
   registerConfig(program);
+  registerRegion(program, makeClient, effectiveConfig, persist);
+  registerCompletion(program);
   registerToken(program);
   registerDoctor(program);
   registerReport(program, makeClient);
-  registerBlame(program, makeClient, loadConfig);
-  registerCart(program, makeClient, loadConfig);
-  registerCheckout(program, makeClient, loadConfig);
-  registerOrder(program, makeClient, loadConfig);
-  registerLog(program, makeClient, loadConfig);
-  registerStatus(program, makeClient, loadConfig);
-  registerWhoami(program, makeClient, loadConfig);
-  registerDrops(program, makeClient, loadConfig);
+  registerBlame(program, makeClient, effectiveConfig);
+  registerCart(program, makeClient, effectiveConfig);
+  registerCheckout(program, makeClient, effectiveConfig);
+  registerOrder(program, makeClient, effectiveConfig);
+  registerLog(program, makeClient, effectiveConfig);
+  registerStatus(program, makeClient, effectiveConfig);
+  registerWhoami(program, makeClient, effectiveConfig);
+  registerDrops(program, makeClient, effectiveConfig);
   registerConnect(program);
-  registerUnstage(program, makeClient, loadConfig);
+  registerUnstage(program, makeClient, effectiveConfig);
   const prompts = makePrompts();
-  const persist = (patch) => {
-    saveConfig(patch);
-  };
   registerLogin(
     program,
     makeClient,
-    loadConfig,
+    effectiveConfig,
     prompts,
     { setToken: (jwt) => setToken(jwt) },
     persist