@botbuddy/cli 1.69.3 → 1.69.5

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 1.69.5
+
+- The bb-status band shows the session's context use on its last row, for example `Context 62% · 124k of 200k`, the same figures as Claude Code's status line. It reads them once with the free `$.session.usage()` and then only when Claude Code pushes `session.measure` after a turn, so it never polls and makes no model calls. The row is hidden while Claude Code has no figure yet. The band's plugin version moves to 1.1.0, so `bb update` installs this and the 1.69.3 session-renewal wording into bands already installed at 1.0.0.
+
 ## 1.69.3
 
 - The bb-status band no longer goes dead with "BB session expired" when a Claude Code session outlives its ~8-hour BB session. Within two hours of expiry `bb status-band read` heartbeats the same session; after expiry it renews that same session in place (`renew_agent_session`), so its tickets and PRs stay on the band. `bb wait` and other CLI self-heals renew the session in place before minting a new one. A closed session is never revived: the band then names `bb doctor --fix`.

package/claude-plugin/.claude-plugin/marketplace.json

@@ -11,7 +11,7 @@
       "name": "bb-status",
       "source": "./bb-status",
       "description": "BB session status above the prompt: tickets, PRs with review counts, epic and staging, for BotBuddy and Supply Guard sessions",
-      "version": "1.0.0"
+      "version": "1.1.0"
     }
   ]
 }

package/claude-plugin/bb-status/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "bb-status",
-  "version": "1.0.0",
-  "description": "BB session status above the prompt: tickets, PRs with review counts, epic and staging, live only while the session is on screen.",
+  "version": "1.1.0",
+  "description": "BB session status above the prompt: tickets, PRs with review counts, epic, staging and context use, live only while the session is on screen.",
   "author": {
     "name": "BotBuddy"
   },

package/claude-plugin/bb-status/README.md

@@ -31,6 +31,14 @@ The relay is parked, with no child and no server wait, while
 session. Once a surface draws the session again, the 5 s display tick does one
 read and re-arms the relay.
 
+**BOT-3211 context row.** The last row shows the session's context use as
+Claude Code's status line has it, for example `Context 62% · 124k of 200k`. The
+mod reads it once with the free `$.session.usage()` (no `breakdown`) at
+session start and resume, then only from the `session.measure` event the
+engine pushes after each main-thread turn: no timer reads it. The row is hidden
+while the runtime has no fill figure (a fresh or just-compacted session before
+its next response), never shown as 0%.
+
 ## Install
 
 The bb CLI ships this mod and installs it (BOT-3152). `bb setup` and `bb update`

package/claude-plugin/bb-status/hooks/register.js

@@ -27,6 +27,10 @@ let parked = false;
 // BOT-3152 AC-5: a repo with no BB binding shows no band at all (the mod is
 // installed once at user scope, so it also loads in unrelated repos).
 let unbound = false;
+// BOT-3211: the session's context window as the status line has it. Read once
+// with the free `$.session.usage()` and then only from `session.measure`,
+// which the engine pushes after each main-thread turn: never polled.
+let context = null;
 const ERRORS = {
   linear_key_missing:
     "Export LINEAR_BB_API_KEY to Claude Desktop before using Live.",
@@ -692,6 +696,41 @@ function bandLine(el, spec, widths, right) {
   // Top-aligned: with a wrapped title, the id and status sit on its first line.
   return el.Box({ key: spec.key, flexDirection: "row", alignItems: "flex-start", columnGap: 1, children });
 }
+// BOT-3211: 124000 → "124k", 1000000 → "1M".
+function tokens(n) {
+  if (n >= 999500) return String(Math.round(n / 100000) / 10).replace(/\.0$/, "") + "M";
+  if (n >= 1000) return Math.round(n / 1000) + "k";
+  return String(n);
+}
+// The row's text, or null when the runtime has no fill figure (a fresh or
+// just-compacted session): hidden, never "0%".
+function contextText(c) {
+  if (
+    !c ||
+    !Number.isFinite(c.percent) ||
+    c.percent < 0 ||
+    c.percent > 100 ||
+    !Number.isSafeInteger(c.window) ||
+    c.window <= 0
+  )
+    return null;
+  const pct = "Context " + Math.round(c.percent) + "%";
+  return Number.isSafeInteger(c.tokens) && c.tokens >= 0
+    ? pct + " · " + tokens(c.tokens) + " of " + tokens(c.window)
+    : pct + " of " + tokens(c.window);
+}
+function contextLine(el, key) {
+  const text = contextText(context);
+  if (!text) return null;
+  return el.Box({ key, flexDirection: "row", children: [dim(el, text)] });
+}
+async function readContext($) {
+  try {
+    context = (await $.session.usage()).context ?? null;
+  } catch {
+    context = null;
+  }
+}
 const UNREAD = {
   prs: "Couldn't read this session's PRs",
   epic: "Couldn't read this session's epic",
@@ -735,7 +774,8 @@ function bandLines(el, $, inPane) {
         columnGap: 1,
         children: [...tag, el.Text({ color: loading ? undefined : "warning", children: ["BB · " + text] }), details].filter(Boolean),
       }),
-    ];
+      contextLine(el, k("line-context")),
+    ].filter(Boolean);
   }
   const s = snapshot;
   // One row per ticket and per PR, each with its own icon, status and title.
@@ -813,6 +853,9 @@ function bandLines(el, $, inPane) {
   const lines = specs.map((spec, i) => bandLine(el, spec, widths, i === 0 ? right : null));
   // BOT-3152 AC-2: the web Staging chip's red, with its link, above the rows.
   if (s.staging?.red) lines.unshift(stagingBanner(el, k("line-staging"), s.staging.since));
+  // BOT-3211: the session's context use, last.
+  const ctx = contextLine(el, k("line-context"));
+  if (ctx) lines.push(ctx);
   return lines;
 }
 export function register(on) {
@@ -832,6 +875,7 @@ export function register(on) {
       immediate: true,
     });
     parked = false;
+    await readContext($);
     if (await onScreen($)) await refresh($);
     else parked = true;
     return next(e);
@@ -861,6 +905,14 @@ export function register(on) {
     await openPanel($);
     return {};
   });
+  // BOT-3211 AC-2: the context row's only trigger after the first read.
+  on("session.measure", async ($, e, next) => {
+    if (e.changed?.includes("context")) {
+      context = e.context ?? null;
+      $.ui.invalidate("ui.render");
+    }
+    return next(e);
+  });
   on("turn.start", async ($, e, next) => {
     if (!e.agentId) {
       activity = "Working";
@@ -886,6 +938,7 @@ export function register(on) {
     errorCode = "session_changed";
     parked = false;
     unbound = false;
+    context = null;
     if (timer) timer.cancel();
     return next(e);
   });
@@ -895,6 +948,8 @@ export function register(on) {
     async ($, e, next) => {
       selectedTicket = undefined;
       mode = "live";
+      // A resumed session's first figure comes before any turn.
+      await readContext($);
       await refresh($);
       return next(e);
     },

package/daemon-release/darwin-arm64.json

@@ -1,7 +1,7 @@
 {
-  "release_version": "1.69.3",
-  "source_commit": "6ba3ab0c70d18df8f5ab32a731fa2dcc54d27043",
-  "source_sha256": "ad8e68f44c4d80d651a703bef2846c570c870cfc901e6891998c001d7baf9296",
+  "release_version": "1.69.5",
+  "source_commit": "53b366064d9f9db05f38f488bd51b971f73276a2",
+  "source_sha256": "9bc7ec78214edbb54996d8245375eb3914ec7fa20436d8d375b516a2bb5bf8eb",
   "target": "darwin-arm64",
-  "sha256": "f79be7f7fc6c91c9864d446028f6f5fdecda67dee1b6f96732105f0f69700b37"
+  "sha256": "125e42c26d1d3116ac192a8b1138e74c61c7ea56d8fc1c1abf4392ad1d43bd5d"
 }

package/daemon-release/linux-x64.json

@@ -1,7 +1,7 @@
 {
-  "release_version": "1.69.3",
-  "source_commit": "6ba3ab0c70d18df8f5ab32a731fa2dcc54d27043",
-  "source_sha256": "ad8e68f44c4d80d651a703bef2846c570c870cfc901e6891998c001d7baf9296",
+  "release_version": "1.69.5",
+  "source_commit": "53b366064d9f9db05f38f488bd51b971f73276a2",
+  "source_sha256": "9bc7ec78214edbb54996d8245375eb3914ec7fa20436d8d375b516a2bb5bf8eb",
   "target": "linux-x64",
-  "sha256": "a425f235cb57efc5879412ccf0c7601b1e0e94ca98a84ce0c39ac6168feea19f"
+  "sha256": "14ebbb9064a188c5aaa7c804e20417b5611c6ee6a2a525b015064ed28f418c2e"
 }

package/daemon-release/manifest.json

@@ -1,21 +1,21 @@
 {
   "schema_version": 1,
-  "release_version": "1.69.3",
-  "source_commit": "6ba3ab0c70d18df8f5ab32a731fa2dcc54d27043",
-  "source_sha256": "ad8e68f44c4d80d651a703bef2846c570c870cfc901e6891998c001d7baf9296",
+  "release_version": "1.69.5",
+  "source_commit": "53b366064d9f9db05f38f488bd51b971f73276a2",
+  "source_sha256": "9bc7ec78214edbb54996d8245375eb3914ec7fa20436d8d375b516a2bb5bf8eb",
   "targets": {
     "darwin-arm64": {
       "goos": "darwin",
       "goarch": "arm64",
       "binary": "daemon/bin/darwin-arm64/botbuddy-daemon",
-      "sha256": "f79be7f7fc6c91c9864d446028f6f5fdecda67dee1b6f96732105f0f69700b37",
+      "sha256": "125e42c26d1d3116ac192a8b1138e74c61c7ea56d8fc1c1abf4392ad1d43bd5d",
       "mode": "0755"
     },
     "linux-x64": {
       "goos": "linux",
       "goarch": "amd64",
       "binary": "daemon/bin/linux-x64/botbuddy-daemon",
-      "sha256": "a425f235cb57efc5879412ccf0c7601b1e0e94ca98a84ce0c39ac6168feea19f",
+      "sha256": "14ebbb9064a188c5aaa7c804e20417b5611c6ee6a2a525b015064ed28f418c2e",
       "mode": "0755"
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbuddy/cli",
-  "version": "1.69.3",
+  "version": "1.69.5",
   "description": "BotBuddy — Swarm coordination CLI for multi-agent workflows",
   "type": "module",
   "bin": {