tokenhud 0.1.0 → 0.1.2

package/README.md

@@ -16,7 +16,7 @@ history on first run.
 
 ## Install
 
-**With Bun** (recommended on Linux and macOS, once the packages are on npm):
+**With Bun** (recommended on Linux and macOS):
 
 ```sh
 bun add -g tokenhud
@@ -26,6 +26,10 @@ No Node is needed. Bun puts the `tokenhud` command in `~/.bun/bin`, which Bun's
 adds to your PATH; `tokenhud doctor` says if it isn't there. Release candidates:
 `bun add -g tokenhud@next`.
 
+Bun ends by saying `Blocked 1 postinstall`. That is expected, and harmless on Linux and
+macOS: the script it blocked is tokenhud's own `preinstall`, which sets up the command for
+npm on Windows and does nothing anywhere else. Leave it blocked; don't `bun pm -g trust` it.
+
 > **On Windows, Bun isn't supported yet.** `bun add -g tokenhud` installs a command that
 > fails at once with `interpreter executable "/bin/sh" not found`. On Windows, use
 > `npm i -g tokenhud` or the PowerShell installer (see **On Windows**, below).
@@ -43,6 +47,13 @@ is a small sh script that starts the binary: no JS runtime runs, so it needs nei
 nor Bun, and nothing in the directory you run it in (a `.env`, a `bunfig.toml`) can reach
 tokenhud.
 
+If a download of that package fails, Bun and npm install tokenhud without it, and the
+command only says the package is not installed (`tokenhud doctor`, from another copy, says
+so too). Right after a release, npm's servers can take a few minutes to serve it
+everywhere; wait a few minutes and reinstall:
+`bun remove -g tokenhud && bun add -g --no-cache tokenhud`, or
+`npm install -g --prefer-online tokenhud`.
+
 **On Windows**, tokenhud is supported through npm (`npm i -g tokenhud`, Node 18 or later)
 or the PowerShell installer, `install.ps1`, below; not through Bun. npm's install script
 sets up a Node launcher for the command. If you installed with Bun, that command can't run,
@@ -343,8 +354,10 @@ its last 30 days.
 - `━` **bars**: a limit meter or a share. The coloured part is the share used, the dark
   track the rest. Limit meters are blue below 50 %, amber from 50 % and red-orange from 80 %;
   share bars are amber for cost and blue for tokens.
-- `▁▂▃▄▅▆▇█` **columns**: the activity chart, the 30-day bars and the weekly history, in
-  eighths of a row.
+- `▂▃▄▅▆▇█` **columns**: the activity chart, the 30-day bars and the weekly history, in
+  eighths of a row; any usage at all shows as `▂` or more. A dim baseline, `▁`, = no usage
+  in that bucket, so a quiet stretch reads as part of the chart, not its end. Without
+  colour, `▁` still means none.
 - `■` **heat map**: the darkest square is a day without usage; the four lighter shades are
   days under a quarter of the busiest day shown, under a half, under three quarters, and
   the rest. White is the table's selected row: a day, or a week's or month's days.
@@ -646,7 +659,7 @@ test/              bun test suites
 scripts/build.ts   builds, checksums and smoke-tests the binaries
 install.sh         the Linux and macOS installer; install.ps1 is the Windows one
 npm/               the npm package's command (sh) and Windows launcher; scripts/stage-npm.ts
-                   builds the npm packages
+                   builds the npm packages, scripts/publish-npm.ts publishes them
 plugin/            the Claude Code plugin (listed by .claude-plugin/marketplace.json)
 ```
 

package/bin/tokenhud

@@ -138,6 +138,10 @@ if [ -z "$binary" ]; then
         "  bun add -g tokenhud          (a global install with bun)" \
         "  npm install -g tokenhud      (a global install with npm)" \
         "  npm install tokenhud         (in a project)" \
+        "It is also missing when its download failed, which bun and npm pass over without an" \
+        "error. If tokenhud was just released, wait a few minutes and reinstall:" \
+        "  bun remove -g tokenhud && bun add -g --no-cache tokenhud" \
+        "  npm install -g --prefer-online tokenhud" \
         "or install the binary directly: https://github.com/ZhuoQiuMcgill/tokenhud#install"
       ;;
   esac

package/lib/tokenhud.cjs

@@ -83,6 +83,9 @@ if (bin === null) {
           "made on another platform). Reinstall tokenhud the same way, without --omit=optional:\n" +
           "  npm install -g tokenhud      (a global install)\n" +
           "  npm install tokenhud         (in a project)\n" +
+          "It is also missing when its download failed, which npm passes over without an\n" +
+          "error. If tokenhud was just released, wait a few minutes and reinstall:\n" +
+          "  npm install -g --prefer-online tokenhud\n" +
           "or install the binary directly: https://github.com/ZhuoQiuMcgill/tokenhud#install",
   );
   process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokenhud",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "license": "MIT",
   "homepage": "https://github.com/ZhuoQiuMcgill/tokenhud#readme",
   "repository": {
@@ -35,11 +35,11 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "@tokenhud/linux-x64": "0.1.0",
-    "@tokenhud/linux-arm64": "0.1.0",
-    "@tokenhud/darwin-x64": "0.1.0",
-    "@tokenhud/darwin-arm64": "0.1.0",
-    "@tokenhud/win32-x64": "0.1.0",
-    "@tokenhud/win32-arm64": "0.1.0"
+    "@tokenhud/linux-x64": "0.1.2",
+    "@tokenhud/linux-arm64": "0.1.2",
+    "@tokenhud/darwin-x64": "0.1.2",
+    "@tokenhud/darwin-arm64": "0.1.2",
+    "@tokenhud/win32-x64": "0.1.2",
+    "@tokenhud/win32-arm64": "0.1.2"
   }
 }