@binaryandthread/cli 0.1.3 → 0.1.5

package/dist/bin.js

@@ -7,10 +7,11 @@ import {
 } from "./chunk-OVG37IIX.js";
 import {
   makePrompts
-} from "./chunk-IM3HF7NN.js";
+} from "./chunk-AAN4VWP3.js";
 import {
   BT_DEFAULT_PUBLISHABLE_KEY,
   BT_DEFAULT_STORE_URL,
+  EXIT,
   GLYPH,
   RecoverableCartError,
   StoreApiError,
@@ -27,24 +28,27 @@ import {
   firstPrice,
   fmtPrice,
   formatCartLine,
+  formatFatal,
   green,
   header,
   lineColour,
   ok,
   printResult,
   productColours,
+  productLore,
   redact,
   registerStage,
   registerView,
   resolveLineItemRef,
   resolveOutput,
+  resolveProduct,
   rule,
   runStage,
   stageMarker,
   versionLine,
   warn,
   working
-} from "./chunk-7FH7BZ3I.js";
+} from "./chunk-VRNJLVHX.js";
 import {
   __require
 } from "./chunk-7OCVIDC7.js";
@@ -73,7 +77,7 @@ function makeLogger(debug, write = (s) => process.stderr.write(s)) {
 }
 
 // src/version.ts
-var VERSION = "0.1.3";
+var VERSION = "0.1.5";
 
 // src/eggs.ts
 function teapot() {
@@ -102,6 +106,21 @@ function rmWardrobe() {
 function force() {
   return "--force-pushing to prod, are we. there's no --force here \u2014\n   a commit to your wardrobe is already that decisive.";
 }
+function gitClone() {
+  return "no clone for a fit \u2014 each one's committed by hand. browse the originals \u2192 bt browse";
+}
+function gitStash() {
+  return "that's bt unstage here. your cart holds; nothing's lost.";
+}
+function gitPush() {
+  return "no remote for your wardrobe. the only push that ships \u2192 bt commit";
+}
+function gitPull() {
+  return "nothing to pull \u2014 the freshest designs land as drops \u2192 bt drops";
+}
+function gitReflog() {
+  return "nothing's ever truly lost here. your history \u2192 bt log";
+}
 var FORTUNES = [
   '// "there are only two hard things in computer science: cache invalidation and naming things." \u2014 phil karlton',
   '// "premature optimization is the root of all evil." \u2014 donald knuth',
@@ -180,50 +199,6 @@ function manPage(version) {
   ];
 }
 
-// src/errors.ts
-var EXIT = {
-  OK: 0,
-  GENERIC: 1,
-  DATAERR: 65,
-  // EX_DATAERR — bad request / unprocessable / stale cart (400/409/422)
-  UNAVAILABLE: 69,
-  // EX_UNAVAILABLE — not found (404)
-  TEMPFAIL: 75,
-  // EX_TEMPFAIL — temporary: 5xx, network/exhausted, rate-limited (429)
-  NOPERM: 77
-  // EX_NOPERM — auth required / forbidden (401/403)
-};
-function messageOf(e) {
-  if (e instanceof Error && e.message) {
-    return e.message;
-  }
-  const s = String(e ?? "").trim();
-  return s || "unexpected error";
-}
-function classifyError(e) {
-  const message = String(redact(messageOf(e)));
-  if (e instanceof RecoverableCartError) {
-    return { code: EXIT.DATAERR, type: "stale_cart", status: e.status, message };
-  }
-  if (e instanceof StoreApiError) {
-    const s = e.status;
-    if (s === 401 || s === 403) return { code: EXIT.NOPERM, type: "auth", status: s, message };
-    if (s === 404) return { code: EXIT.UNAVAILABLE, type: "not_found", status: s, message };
-    if (s === 429) return { code: EXIT.TEMPFAIL, type: "rate_limited", status: s, message };
-    if (s === 0 || s === 408 || s >= 500) return { code: EXIT.TEMPFAIL, type: "upstream", status: s, message };
-    if (s >= 400) return { code: EXIT.DATAERR, type: "client_error", status: s, message };
-  }
-  return { code: EXIT.GENERIC, type: "error", message };
-}
-function formatFatal(e, json) {
-  const info = classifyError(e);
-  if (json) {
-    const envelope = { error: { code: info.code, type: info.type, message: info.message } };
-    return { out: JSON.stringify(envelope, null, 2), err: null, code: info.code };
-  }
-  return { out: null, err: `\u2717  ${info.message}`, code: info.code };
-}
-
 // src/is-main.ts
 import { realpathSync } from "fs";
 import { fileURLToPath } from "url";
@@ -312,19 +287,20 @@ function deleteToken(deps = {}) {
 }
 
 // src/commands/browse.ts
-function productRow(p, stage, style) {
+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(34)),
+    dim(style, handle.padEnd(30)),
     stageMarker(stage)
   ];
-  const row = parts.join(" ").trimEnd();
+  const row = `${ref} ${parts.join(" ")}`.trimEnd();
   return colours ? `${row}
-   ${dim(style, colours)}` : row;
+       ${dim(style, colours)}` : row;
 }
 async function runBrowse(client, config, args) {
   const style = brandOf(args);
@@ -344,9 +320,9 @@ 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"));
-    for (const { p, stage } of rows) {
-      lines.push(productRow(p, stage, style));
-    }
+    rows.forEach(({ p, stage }, i) => {
+      lines.push(productRow(p, i, stage, style));
+    });
     for (const d of drops) {
       const dt = (d.title ?? d.handle ?? d.id).toString();
       lines.push(
@@ -361,7 +337,7 @@ async function runBrowse(client, config, args) {
     if (drops.length > 0) {
       lines.push("   on next, before the web \u2192 bt drops");
     }
-    lines.push("   view one \u2192 bt view <handle>   \xB7   stage one \u2192 bt stage <handle> --size L");
+    lines.push("   view one \u2192 bt view <n|slug>   \xB7   stage one \u2192 bt stage <n|slug> --size L");
   }
   return {
     lines,
@@ -377,10 +353,10 @@ async function runBrowse(client, config, args) {
   };
 }
 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("--plain", "force the static table (skip the interactive picker)").action(async (opts) => {
+  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 (!json && !opts.plain && brand.color && process.stdout.isTTY) {
-      const { runInteractiveBrowse } = await import("./interactive-DZ67P6UX.js");
+    if (opts.pick && !json && brand.color && process.stdout.isTTY && process.stdin.isTTY) {
+      const { runInteractiveBrowse } = await import("./interactive-WFI5K77G.js");
       const handled = await runInteractiveBrowse(makeClient2(), loadConfig2(), { branch: opts.branch, brand });
       if (handled) return;
     }
@@ -497,6 +473,18 @@ function registerCart(program, makeClient2, loadConfig2) {
 function supportedCountries(region) {
   return (region.countries ?? []).map((c) => (c.iso_2 ?? "").toLowerCase()).filter((c) => c.length > 0);
 }
+var HEARTBEAT_EVERY_TICKS = 6;
+function heartbeatLine(attempt, opts = {}) {
+  const everyTicks = opts.everyTicks ?? HEARTBEAT_EVERY_TICKS;
+  if (attempt <= 1 || (attempt - 1) % everyTicks !== 0) {
+    return null;
+  }
+  const intervalMs = opts.intervalMs ?? 5e3;
+  const elapsedS = Math.round((attempt - 1) * intervalMs / 1e3);
+  return working(
+    `still waiting for the browser hand-off, ${elapsedS}s in. ctrl-c is safe; resume with bt checkout --resume`
+  );
+}
 async function runCheckout(client, config, args, deps) {
   const cartId = config.cart_id;
   if (!cartId) {
@@ -562,7 +550,9 @@ async function runCheckout(client, config, args, deps) {
           what: "couldn't attach a shipping method to your cart.",
           fix: "this region may not have shipping configured yet \u2014 try again shortly, or re-stage."
         })
-      ]
+      ],
+      exitCode: EXIT.GENERIC
+      // fail-closed, no order placed → non-zero (matches the shown exit 1)
     };
   }
   const itemCount = cart.items.reduce((n, li) => n + (li.quantity ?? 1), 0);
@@ -616,7 +606,9 @@ async function runCheckout(client, config, args, deps) {
           link: checkout_url
         })
       ],
-      save
+      save,
+      exitCode: EXIT.TEMPFAIL
+      // lost the connection mid-poll → not confirmed → non-zero (75)
     };
   }
   const lines = [];
@@ -648,7 +640,7 @@ async function runCheckout(client, config, args, deps) {
       warn("your stage expired before checkout completed. nothing was charged.")
     );
     lines.push("   re-stage \u2192 bt stage <slug>   then   bt checkout");
-    return { lines, save, json: args.json ? { status: "expired" } : void 0 };
+    return { lines, save, json: args.json ? { status: "expired" } : void 0, exitCode: EXIT.TEMPFAIL };
   }
   lines.push("");
   lines.push(
@@ -660,7 +652,13 @@ async function runCheckout(client, config, args, deps) {
       link: checkout_url
     })
   );
-  return { lines, save, json: args.json ? { status: "timeout", checkout_url } : void 0 };
+  return {
+    lines,
+    save,
+    json: args.json ? { status: "timeout", checkout_url } : void 0,
+    exitCode: EXIT.TEMPFAIL
+    // handoff timed out → not placed → non-zero (matches the shown exit 75)
+  };
 }
 async function resolveDisplayId(client, orderId, email) {
   if (!orderId) {
@@ -687,11 +685,13 @@ function maskEmail(email) {
 function registerCheckout(program, makeClient2, loadConfig2) {
   const action = async (opts) => {
     const { json, brand } = resolveOutput(program);
-    const { makePrompts: makePrompts2 } = await import("./prompts-GTC5VYM6.js");
+    const { makePrompts: makePrompts2 } = await import("./prompts-DDVV5RE6.js");
     const { openCheckout } = await import("./browser-EO5EQUXQ.js");
     const { pollUntilPlaced } = await import("./poll-O3VUD5WV.js");
     const { saveConfig: saveConfig2 } = await import("./config-FXGCWC6Y.js");
     const client = makeClient2();
+    const print = json ? () => {
+    } : (line) => process.stdout.write(line + "\n");
     const res = await runCheckout(
       client,
       loadConfig2(),
@@ -699,11 +699,16 @@ function registerCheckout(program, makeClient2, loadConfig2) {
       {
         prompts: makePrompts2(),
         open: (url) => openCheckout(url),
-        poll: (sessionId) => pollUntilPlaced(client, sessionId),
+        // Heartbeat the browser-hop wait so the terminal never looks hung (a dim, calm line every
+        // ~30s). Suppressed under --json (print is a no-op there).
+        poll: (sessionId) => pollUntilPlaced(client, sessionId, {
+          onTick: (attempt) => {
+            const line = heartbeatLine(attempt);
+            if (line) print(dim(brand, line));
+          }
+        }),
         saveConfig: saveConfig2,
-        // In --json mode the review is suppressed (machine output only); otherwise print eagerly.
-        print: json ? () => {
-        } : (line) => process.stdout.write(line + "\n")
+        print
       }
     );
     if (res.save && Object.keys(res.save).length > 0) {
@@ -1424,8 +1429,8 @@ function runInit(args) {
     "   buy heavyweight pieces from your terminal. zero setup \u2014 you're already pointed at the live store.",
     "",
     "   the happy path:",
-    "     bt browse                    # the catalog (arrow keys to pick)",
-    "     bt stage <handle> --size L   # add to your cart",
+    "     bt browse                    # the catalog, numbered",
+    "     bt stage <n|slug> --size L   # add to your cart (a browse number, or a slug)",
     "     bt checkout                  # pay in your browser \u2014 cards never touch the terminal",
     "",
     "   optional:",
@@ -1467,24 +1472,34 @@ async function runBuy(client, config, args, deps) {
   return {
     lines: [...staged.lines, "", ...checked.lines],
     save: { ...staged.save ?? {}, ...checked.save ?? {} },
-    json: args.json ? { cart_id: cartId, checkout: checked.json ?? null } : void 0
+    json: args.json ? { cart_id: cartId, checkout: checked.json ?? null } : void 0,
+    // forward the checkout outcome's exit code — bt buy runs the SAME money-path poll as bt
+    // checkout, so a timed-out/failed composed checkout must not report success (d10).
+    exitCode: checked.exitCode
   };
 }
 function registerBuy(program, makeClient2, loadConfig2) {
-  program.command("buy").argument("<handle>", "the product handle/slug").option("--size <size>", "garment size").option("--colour <colour>", "colour, e.g. white / black").description("stage + checkout in one \u2014 reserve, then open browser checkout. cards never touch the terminal.").action(async (handle, opts) => {
+  program.command("buy").argument("<handle>", "the design: a slug, a bt browse number (3), or a fuzzy hint (termnl)").option("--size <size>", "garment size").option("--colour <colour>", "colour, e.g. white / black").description("stage + checkout in one \u2014 reserve, then open browser checkout. cards never touch the terminal.").action(async (handle, opts) => {
     const { json, brand } = resolveOutput(program);
-    const { makePrompts: makePrompts2 } = await import("./prompts-GTC5VYM6.js");
+    const { makePrompts: makePrompts2 } = await import("./prompts-DDVV5RE6.js");
     const { openCheckout } = await import("./browser-EO5EQUXQ.js");
     const { pollUntilPlaced } = await import("./poll-O3VUD5WV.js");
     const { saveConfig: saveConfig2 } = await import("./config-FXGCWC6Y.js");
     const client = makeClient2();
+    const print = json ? () => {
+    } : (line) => process.stdout.write(line + "\n");
     const res = await runBuy(client, loadConfig2(), { handle, size: opts.size, colour: opts.colour, json, brand }, {
       prompts: makePrompts2(),
       open: (url) => openCheckout(url),
-      poll: (sessionId) => pollUntilPlaced(client, sessionId),
+      // Same heartbeat as bt checkout — bt buy's browser-hop wait is the identical 20-min poll.
+      poll: (sessionId) => pollUntilPlaced(client, sessionId, {
+        onTick: (attempt) => {
+          const line = heartbeatLine(attempt);
+          if (line) print(dim(brand, line));
+        }
+      }),
       saveConfig: saveConfig2,
-      print: json ? () => {
-      } : (line) => process.stdout.write(line + "\n")
+      print
     });
     if (res.save && Object.keys(res.save).length > 0) {
       saveConfig2(res.save);
@@ -1630,7 +1645,7 @@ function registerReport(program, makeClient2) {
     const gOpts = program.opts();
     const json = Boolean(gOpts.json);
     const debug = process.argv.includes("--debug") || process.argv.includes("--verbose");
-    const { makePrompts: makePrompts2 } = await import("./prompts-GTC5VYM6.js");
+    const { makePrompts: makePrompts2 } = await import("./prompts-DDVV5RE6.js");
     const snapshot = gatherDoctorSnapshot({ color: gOpts.color });
     const res = await runReport(
       makeClient2(),
@@ -1641,6 +1656,43 @@ function registerReport(program, makeClient2) {
   });
 }
 
+// src/commands/blame.ts
+async function runBlame(client, config, args) {
+  const slug = (args.handle ?? "").trim();
+  if (!slug) {
+    return { lines: blame().split("\n") };
+  }
+  const region = await client.resolveRegion(config.region);
+  const picked = await resolveProduct(client, region, slug);
+  const product = picked.product;
+  if (!product) {
+    return { lines: blame(slug).split("\n") };
+  }
+  const { handle } = displayName(product);
+  const lore = productLore(product);
+  const lines = [];
+  if (picked.fuzzy && handle !== slug) {
+    lines.push(working(`matched "${handle}" from "${slug}"`));
+  }
+  if (!lore.text) {
+    lines.push(...blame(handle).split("\n"));
+    return { lines, json: args.json ? { handle, lore: null } : void 0 };
+  }
+  lines.push(`blame ${handle}`);
+  lines.push(`   ${lore.text}`);
+  for (const s of lore.sources) {
+    lines.push(`   source  ${s.label} (${s.url})`);
+  }
+  return { lines, json: args.json ? { handle, lore } : void 0 };
+}
+function registerBlame(program, makeClient2, loadConfig2) {
+  program.command("blame", { hidden: true }).argument("[slug]", "a design \u2014 a slug, a bt browse number, or a fuzzy hint").description("who's responsible for a design \u2014 its lore + sources (git blame, for motifs).").action(async (slug) => {
+    const { json, brand } = resolveOutput(program);
+    const res = await runBlame(makeClient2(), loadConfig2(), { handle: slug, json, brand });
+    printResult(res, json);
+  });
+}
+
 // src/bin.ts
 function makeClient() {
   const { baseUrl, publishableKey } = resolveClientConfig();
@@ -1657,7 +1709,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)");
+  ).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();
   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");
@@ -1696,6 +1748,7 @@ function registerCommands(program) {
   registerToken(program);
   registerDoctor(program);
   registerReport(program, makeClient);
+  registerBlame(program, makeClient, loadConfig);
   registerCart(program, makeClient, loadConfig);
   registerCheckout(program, makeClient, loadConfig);
   registerOrder(program, makeClient, loadConfig);
@@ -1731,7 +1784,11 @@ function registerEggs(program) {
   program.command("ship", { hidden: true }).argument("[what]").action(() => print(shipIt()));
   program.command("rm", { hidden: true }).allowUnknownOption().argument("[args...]").action(() => print(rmWardrobe()));
   program.command("force", { hidden: true }).allowUnknownOption().argument("[args...]").action(() => print(force()));
-  program.command("blame", { hidden: true }).argument("[slug]", "a design slug to blame").description("who's responsible for all this \u2014 provenance + lore.").action((slug) => print(blame(slug)));
+  program.command("clone", { hidden: true }).allowUnknownOption().argument("[args...]").action(() => print(gitClone()));
+  program.command("stash", { hidden: true }).allowUnknownOption().argument("[args...]").action(() => print(gitStash()));
+  program.command("push", { hidden: true }).allowUnknownOption().argument("[args...]").action(() => print(gitPush()));
+  program.command("pull", { hidden: true }).allowUnknownOption().argument("[args...]").action(() => print(gitPull()));
+  program.command("reflog", { hidden: true }).allowUnknownOption().argument("[args...]").action(() => print(gitReflog()));
   program.command("fortune").description("a coding fortune. real aphorisms only.").action(() => {
     const seed = Math.floor(Date.now() / 1e3) % FORTUNES.length;
     print(fortune(seed));