@binaryandthread/cli 0.4.3 → 0.4.5

package/README.md

@@ -27,6 +27,30 @@ unambiguous form.)
 > `npx bt`, `npx btn`, and `npx binaryandthread` are **different, unscoped packages owned by
 > strangers** — never run them. Always install the full scoped name.
 
+## The ones you forward
+
+People forward commands, not shops. Each of these installs nothing, buys nothing, and costs the
+person you send it to about four seconds.
+
+```bash
+npx @binaryandthread/cli fortune   # a real aphorism from the trade, never an invented one
+npx @binaryandthread/cli brew      # ask a clothing company for coffee, get RFC 2324
+npx @binaryandthread/cli init      # the welcome, and the three commands that matter
+npx @binaryandthread/cli browse    # the whole catalogue, as a numbered table
+```
+
+`fortune` draws from a fixed pool of genuine, attributable lines. Nothing in it was made up, which
+is the only reason it is worth passing on.
+
+`brew` is the house joke, and it is the one design two separate strangers have laughed at. Ask for
+coffee and the shop answers **`418 i'm a teapot`**, which is a real HTTP status code from a real
+April Fools' RFC that somehow never died. The article is at
+[/guide/the-joke-that-would-not-die](https://binaryandthread.com/guide/the-joke-that-would-not-die);
+the garment exists too.
+
+There are a dozen or so other responses hidden in here for commands a developer types by reflex.
+Listing them would defeat the point.
+
 ## Commands
 
 | command | what it does |
@@ -44,6 +68,21 @@ unambiguous form.)
 | `bt drops` | terminal-visible drops |
 | `bt forget` | wipe your local session + config (keychain token, cart, email) |
 
+Ten more that the CLI has always had and this table has never listed:
+
+| command | what it does |
+| --- | --- |
+| `bt init` | the first-run welcome and the three-command happy path. What the bare `bt` points a newcomer at |
+| `bt buy <n\|slug>` | stage and checkout in one, for when you already know what you want |
+| `bt status` | working-tree state: what is staged, what is in flight |
+| `bt config [sub] [key] [value]` | local preferences (email, region, default fit). **The auth token is never stored here** |
+| `bt token` | prints your keychain JWT for an MCP config. A bearer credential, treat it like one |
+| `bt completion <shell>` | a shell completion script, to eval in your rc |
+| `bt doctor` | local diagnostics for a bug report. Sends nothing |
+| `bt report [message]` | files a bug report: a redacted snapshot, never cards or tokens |
+| `bt brew` | see above |
+| `bt fortune` | see above |
+
 ## Config (all optional, env overrides the baked-in prod defaults)
 
 | var | notes |

package/dist/bin.js

@@ -55,7 +55,7 @@ import {
   versionLine,
   warn,
   working
-} from "./chunk-VO3TABLK.js";
+} from "./chunk-PG7YCPAN.js";
 import {
   __require
 } from "./chunk-7OCVIDC7.js";
@@ -104,7 +104,7 @@ function makeLogger(debug, write = (s) => process.stderr.write(s)) {
 }
 
 // src/version.ts
-var VERSION = "0.4.3";
+var VERSION = "0.4.5";
 
 // src/eggs.ts
 function teapot() {
@@ -524,7 +524,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-4NOJ3LFW.js");
+      const { runInteractiveBrowse } = await import("./interactive-HI3LDK5U.js");
       const handled = await runInteractiveBrowse(makeClient2(), loadConfig2(), { branch: opts.branch, brand });
       if (handled) return;
     }
@@ -2060,7 +2060,7 @@ function buildProgram() {
     "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)").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(() => {
+  program.command("brew").alias("teapot").argument("[what]", "what to brew").description("we make clothing, not coffee.").action(() => {
     process.stdout.write(teapot() + "\n");
   });
   registerEggs(program);