@ironbee-ai/cli 0.11.4 → 0.13.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.13.0 (2026-05-24)
+
+### Features
+
+* **tui:** add full-screen TUI ([#17](https://github.com/ironbee-ai/ironbee-cli/issues/17)) ([e3d9d71](https://github.com/ironbee-ai/ironbee-cli/commit/e3d9d712bfd80c3a559101c8662bb056f9ba628e))
+
+## 0.12.0 (2026-05-23)
+
+### Features
+
+* **statusline:** add session_status events via a chained statusline wrapper ([#16](https://github.com/ironbee-ai/ironbee-cli/issues/16)) ([a0a5a10](https://github.com/ironbee-ai/ironbee-cli/commit/a0a5a109d9691531711ec1d20ecc5d176aafcc15))
+
 ## 0.11.4 (2026-05-21)
 
 ### Features

package/README.md

@@ -159,6 +159,18 @@ Turns off enforcement but keeps the telemetry path intact. Session lifecycle and
 
 The toggle re-renders all client artifacts (hooks, skill, rule, MCP servers, permissions) atomically. The change takes effect on the next agent session — restart your editor / agent after toggling.
 
+### Optional: statusline `session_status` events (Claude)
+
+```bash
+ironbee statusline enable
+```
+
+Wraps your Claude Code statusline so that, on every statusline tick, IronBee emits a `session_status` event carrying live **context-window size**, **cost**, and **subscription rate-limit utilization** — signals that are unavailable to hooks or the transcript and can only be read from the statusline. Your existing statusline keeps rendering exactly as before: IronBee installs its wrapper into `.claude/settings.local.json` (the highest-priority, gitignored settings layer) and **chains** to whatever statusline you already had (committed project, global, or local), so the display is unchanged — we just piggyback the telemetry.
+
+Auto-enabled when a collector is configured (same as analytics); otherwise opt in with `ironbee statusline enable` or `statusLine.enable: true`. `ironbee statusline disable` restores your original statusline and stops the events. If you change your upstream statusline mid-session, `ironbee statusline sync` re-resolves it for active sessions (otherwise it's picked up on the next session). The change takes effect on the next agent session — restart your editor after toggling.
+
+> Claude-only — Cursor has no equivalent statusline mechanism. The events ship through the same queue + collector pipeline as everything else; nothing is written when no collector is configured.
+
 ### Cursor: additional setup
 
 Cursor requires manual activation of MCP servers after install:
@@ -179,6 +191,7 @@ The next time your AI agent edits code, IronBee will require verification before
 ironbee install [project-dir] [--client <name>] [--all]   Set up hooks and config; --all → batch across every registered project
 ironbee uninstall [project-dir] [--client <name>] [--all] [-y]   Remove hooks and config; --all → batch wipe across every registered project (destructive, prompts unless --yes)
 ironbee update                                    Update IronBee CLI to the latest version (npm self-update)
+ironbee tui [area]                                Interactive full-screen TUI — browse & drive everything (config / platforms / projects / sessions / queue / import). See docs/tui.md
 ironbee status [project-dir]                      Show verdict status for active sessions
 ironbee verify [session-id]                       Dry-run verdict validation
 ironbee analyze [session-id]                      Analyze session metrics (or all sessions)
@@ -187,13 +200,14 @@ ironbee browser <enable|disable>   [-g|--local] [--client <name>]   Manage the b
 ironbee backend <enable|disable>   [-g|--local] [--client <name>]   Manage the runtime-agnostic backend protocol cycle (HTTP/gRPC/GraphQL/WS via backend-devtools)
 ironbee node <enable|disable>      [-g|--local] [--client <name>]   Manage the Node.js runtime debug cycle (V8 inspector probes via node-devtools)
 ironbee verification <enable|disable> [-g|--local] [--client <name>]   Master verification toggle (enable = enforce; disable = monitoring-only, no enforcement but sessions/tools still ship to collector)
+ironbee statusline <enable|disable|sync> [-g|--local] [--client <name>]   Manage the Claude statusline integration (emits session_status events — context-window size, cost, subscription rate-limits — and chains your existing statusline). sync re-resolves the chained statusline for active sessions
 ironbee config get   <key>         [-g|--project|--local]   Read a config value (default: merged effective value; flags narrow to one of the three layers)
 ironbee config set   <key> <value> [-g|--local] [--client <name>] [--no-rerender] [--json] [--apply-all|--no-apply-all]   Write a config value; auto re-renders client artifacts on artifact-affecting keys; -g writes global, --local writes project-local (gitignored)
 ironbee config unset <key>         [-g|--local] [--client <name>] [--no-rerender] [--apply-all|--no-apply-all]   Remove a config value (idempotent); same target / rerender rules as set
 ironbee config list                [-g|--project|--local]   Print the entire config (merged / global / project / local)
 ironbee config path                [-g|--local]   Print the on-disk path of the targeted config file (project default; -g for global, --local for project-local)
-ironbee register   [-p <dir>] [--client <name>]   Add this project to the user-home inventory (no artifact writes)
-ironbee unregister [-p <dir>] [--client <name>]   Remove this project from the user-home inventory (no artifact writes)
+ironbee register   [-p <dir>]   Add this project (path) to the user-home inventory (no artifact writes)
+ironbee unregister [-p <dir>]   Remove this project from the user-home inventory (no artifact writes)
 ironbee queue status [--session <id>]             Queue status per session (counts, recent dead-letter errors)
 ironbee queue drain  [--session <id>]             Synchronously drain pending snapshots
 ironbee queue dead-letter list|stats|retry|clear  Inspect / retry / clear dead-letter entries
@@ -320,7 +334,7 @@ Target flags are mutually exclusive: pass at most one of `-g/--global`, `--proje
 
 **Type coercion** — `set` parses the value as JSON when it can (`true`/`42`/`[…]`/`{…}`) and falls back to a raw string when JSON parse fails. URLs and paths pass through unquoted; pass `--json` to force strict JSON parsing (e.g. when you want the literal string `"42"` instead of the number `42`).
 
-**Smart artifact re-render** — when a top-level key affects installed client artifacts (`verification`, `collector`, `browser`, `backend`, `node`, `browserDevTools`, `backendDevTools`, `nodeDevTools`), `set` and `unset` re-render the client files (hooks, MCP entries, skill, rule, permissions) automatically — same code path `verification enable` / `backend enable` / `node enable` use. Other keys (`maxRetries`, `recording`, `jobQueue`, `analytics`, `import`, `ignoredVerifyPatterns`) are pure config flips that the next agent session picks up — no rerender needed.
+**Smart artifact re-render** — when a top-level key affects installed client artifacts (`verification`, `telemetry`, `statusLine`, `collector`, `browser`, `backend`, `node`, `browserDevTools`, `backendDevTools`, `nodeDevTools`), `set` and `unset` re-render the client files (hooks, MCP entries, skill, rule, permissions, statusline) automatically — same code path `verification enable` / `backend enable` / `node enable` use. Other keys (`maxRetries`, `recording`, `jobQueue`, `analytics`, `import`, `ignoredVerifyPatterns`) are pure config flips that the next agent session picks up — no rerender needed.
 
 Pass `--no-rerender` to skip the rerender on artifact-affecting keys (handy for scripted bulk edits — follow up with `ironbee install` to resync). If a rerender fails midway, the config file is rolled back to its prior bytes so disk state never diverges from installed artifacts.
 

package/dist/assets/banner.txt

@@ -6,4 +6,4 @@
  ██║ ██║  ██║ ╚██████╔╝ ██║ ╚████║ ██████╔╝ ███████╗ ███████╗
  ╚═╝ ╚═╝  ╚═╝  ╚═════╝  ╚═╝  ╚═══╝ ╚═════╝  ╚══════╝ ╚══════╝
 
- The Verification Layer for Agentic Development
+ The Verification and Intelligence Layer for Agentic Development

package/dist/clients/claude/hooks/session-start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-start.d.ts","sourceRoot":"","sources":["../../../../src/clients/claude/hooks/session-start.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH,wBAAsB,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0F3D"}
+{"version":3,"file":"session-start.d.ts","sourceRoot":"","sources":["../../../../src/clients/claude/hooks/session-start.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH,wBAAsB,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiG3D"}

package/dist/clients/claude/hooks/session-start.js

@@ -13,6 +13,7 @@ const actions_1 = require("../../../hooks/core/actions");
 const session_state_1 = require("../../../hooks/core/session-state");
 const util_1 = require("../util");
 const config_1 = require("../../../lib/config");
+const session_status_1 = require("./session-status");
 const logger_1 = require("../../../lib/logger");
 const output_1 = require("../../../lib/output");
 const stdin_1 = require("../../../lib/stdin");
@@ -38,6 +39,12 @@ async function run(projectDir) {
     // them on next start.
     (0, session_state_1.setUserEmail)(sessionDir, (0, util_1.getClaudeUserEmail)());
     (0, session_state_1.setUsage)(sessionDir, (0, util_1.resolveClaudeUsage)());
+    // Resolve + cache the chained statusline command once per session so the
+    // statusline wrapper reads a single state.json field per tick instead of
+    // walking the settings cascade. Gated on the feature; harmless when off.
+    if ((0, config_1.isSessionStatusEnabled)((0, config_1.loadConfig)(projectDir))) {
+        (0, session_state_1.setChainedStatusLine)(sessionDir, (0, session_status_1.resolveChainTarget)(projectDir) ?? null);
+    }
     const entry = {
         ...(0, actions_1.baseFields)(actionsFile),
         type: "session_start",

package/dist/clients/claude/hooks/session-start.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-start.js","sourceRoot":"","sources":["../../../../src/clients/claude/hooks/session-start.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-start.js","sourceRoot":"","sources":["../../../../src/clients/claude/hooks/session-start.ts"],"names":[],"mappings":"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"}

package/dist/clients/claude/hooks/session-status.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Claude Code — statusline wrapper (`ironbee hook session-status`)
+ *
+ * Installed as the project's `statusLine.command`. On every statusline tick
+ * it does two independent things:
+ *   1. Submits a `session_status` event (context-window size, cost,
+ *      subscription rate-limits) to the queue — signals unavailable to hooks
+ *      or the transcript.
+ *   2. Chains to the user's ORIGINAL statusline command so their statusline
+ *      keeps rendering exactly as before (we wrap, never replace).
+ *
+ * The event submit is fire-and-forget and must NEVER block or break the
+ * statusline render. The chain target is resolved once at SessionStart and
+ * cached in state.json; this wrapper falls back to live cascade resolution
+ * if the cache is missing/unreadable, so a cache miss can never make the
+ * user's statusline vanish.
+ */
+import { SessionStatusEvent } from "../../../lib/event";
+/** Subset of the statusline stdin JSON this wrapper consumes. */
+interface StatusLinePayload {
+    session_id?: string;
+    model?: {
+        id?: string;
+    };
+    workspace?: {
+        project_dir?: string;
+    };
+    cost?: {
+        total_cost_usd?: number;
+        total_duration_ms?: number;
+        total_api_duration_ms?: number;
+        total_lines_added?: number;
+        total_lines_removed?: number;
+    };
+    context_window?: {
+        total_input_tokens?: number;
+        total_output_tokens?: number;
+        context_window_size?: number;
+        used_percentage?: number;
+        remaining_percentage?: number;
+        current_usage?: {
+            input_tokens?: number;
+            output_tokens?: number;
+            cache_creation_input_tokens?: number;
+            cache_read_input_tokens?: number;
+        } | null;
+    };
+    rate_limits?: {
+        five_hour?: {
+            used_percentage?: number;
+            resets_at?: number;
+        };
+        seven_day?: {
+            used_percentage?: number;
+            resets_at?: number;
+        };
+    };
+}
+/**
+ * True only when the command is EXACTLY our bare wrapper invocation. A tight
+ * match so a user who wraps us themselves (`tee >(ironbee hook session-status)
+ * | real-cmd`) is NOT mis-identified as "ours" — that compound is their own
+ * statusline and must be chained, not skipped.
+ */
+export declare function isIronbeeStatusLine(command: string | undefined): boolean;
+/**
+ * Resolve the project dir anchor. Prefers `CLAUDE_PROJECT_DIR` to stay
+ * consistent with every other hook and with SessionStart (session runtime
+ * files — state.json, queue — live under exactly this path), falling back to
+ * the statusline's `workspace.project_dir` and finally cwd. NOT canonicalized
+ * — the snapshot store canonicalizes internally on lookup, and the session
+ * dir must match the raw path SessionStart wrote under.
+ */
+export declare function resolveProjectDir(input: StatusLinePayload): string;
+/**
+ * Resolve the chain target = the statusline command Claude Code WOULD run
+ * without us = the highest-priority non-ours `statusLine.command` across the
+ * settings layers, walking high → low:
+ *   1. localSettings layer — our wrapper overwrote it, so the original lives
+ *      in the install snapshot.
+ *   2. projectSettings (`.claude/settings.json`) — untouched, read live.
+ *   3. userSettings (`~/.claude/settings.json`) — untouched, read live.
+ * First non-ours wins. `undefined` = nothing to chain.
+ */
+export declare function resolveChainTarget(projectDir: string): string | undefined;
+/**
+ * Strip the bracketed runtime suffix from the model id
+ * (`claude-opus-4-7[1m]` → `claude-opus-4-7`). The `[1m]` extended-context
+ * marker is redundant on the event — `context_window.context_window_size`
+ * already carries the effective window — so we keep the model field a clean
+ * canonical id.
+ */
+export declare function normalizeModelId(id: string | undefined): string;
+/**
+ * Build the wire event. Maps fields EXPLICITLY from the statusline JSON (R12)
+ * so our wire contract is independent of host JSON drift. `model` is the flat
+ * id string. `actionsFile` is only the derivation anchor for `baseFields`
+ * (id/session_id/project_name + user/usage) — we never write to it.
+ */
+export declare function buildSessionStatusEvent(input: StatusLinePayload, projectDir: string, sessionId: string): SessionStatusEvent;
+/**
+ * Deterministic per-tick id. `total_duration_ms` is monotonic within a
+ * session (`Date.now() - startTime`), so each tick gets a distinct id and the
+ * backend keeps every tick; a cancelled-then-refired identical tick collides
+ * on the same id (dedup). UUID-shaped via the same hashing convention as the
+ * analytics deterministic ids.
+ */
+export declare function deriveSessionStatusEventId(sessionId: string, totalDurationMs: number): string;
+/**
+ * Signature over the RESOURCE-METRIC fields of the event — the fields that
+ * only change on an API response. Deliberately EXCLUDES:
+ *   - `cost.total_duration` / `total_api_duration` — wall-clock durations that
+ *     tick up on every statusline fire (including them would make the
+ *     signature differ every tick, defeating the dedup).
+ *   - `id` / `timestamp` — per-emit, not metrics.
+ *   - `activity_id` — correlation metadata, not a resource metric (a new turn
+ *     with frozen metrics shouldn't re-emit; the next real metric change
+ *     captures the new activity_id).
+ * Used by skip-if-unchanged: two ticks with the same signature carry the same
+ * resource snapshot, so the later one is a redundant emit and is skipped.
+ */
+export declare function computeSessionStatusSignature(e: SessionStatusEvent): string;
+/**
+ * Statusline entry point. Reads stdin, submits the event (gated, fire-and-
+ * forget), then chains the user's original statusline.
+ */
+export declare function runSessionStatus(): Promise<void>;
+export {};
+//# sourceMappingURL=session-status.d.ts.map

package/dist/clients/claude/hooks/session-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-status.d.ts","sourceRoot":"","sources":["../../../../src/clients/claude/hooks/session-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAeH,OAAO,EAAuC,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAO7F,iEAAiE;AACjE,UAAU,iBAAiB;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxB,SAAS,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,IAAI,CAAC,EAAE;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC;IACF,cAAc,CAAC,EAAE;QACb,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,aAAa,CAAC,EAAE;YACZ,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,2BAA2B,CAAC,EAAE,MAAM,CAAC;YACrC,uBAAuB,CAAC,EAAE,MAAM,CAAC;SACpC,GAAG,IAAI,CAAC;KACZ,CAAC;IACF,WAAW,CAAC,EAAE;QACV,SAAS,CAAC,EAAE;YAAE,eAAe,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7D,SAAS,CAAC,EAAE;YAAE,eAAe,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAChE,CAAC;CACL;AAID;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAKxE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAIlE;AAwBD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAczE;AAMD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAE/D;AA+BD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,kBAAkB,CA6C3H;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAK7F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAY3E;AAsLD;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CA+CtD"}