sidekick-agent-hub 0.13.7 → 0.13.8

package/README.md

@@ -110,7 +110,9 @@ Subscription Quota
   7-Day    ██████████████████████░░░░░░░░ 72%   resets in 4d 6h
 ```
 
-Use `--json` for machine-readable output. Requires Claude Code credentials (`~/.claude/.credentials.json`).
+When quota data is unavailable, `sidekick quota` shows structured auth, rate-limit, network, server, or unexpected-failure messaging instead of a generic raw error. The dashboard Sessions panel also keeps a compact inline quota state for Claude Code instead of hiding quota entirely.
+
+Use `--json` for machine-readable output. Requires Claude Code credentials (`~/.claude/.credentials.json`). JSON output includes `failureKind`, `httpStatus`, and `retryAfterMs` on unavailable responses.
 
 ## Dashboard Panels
 

package/dist/sidekick-cli.mjs

@@ -16796,14 +16796,27 @@ var require_quota = __commonJS({
         return void 0;
       return Math.min(Math.round(utilization * (windowMs / elapsed)), 200);
     }
-    function unavailableState(error) {
+    function unavailableState(error, meta = {}) {
       return {
         fiveHour: { utilization: 0, resetsAt: "" },
         sevenDay: { utilization: 0, resetsAt: "" },
         available: false,
-        error
+        error,
+        ...meta
       };
     }
+    function parseRetryAfterMs(retryAfter) {
+      if (!retryAfter)
+        return void 0;
+      const seconds = Number(retryAfter);
+      if (Number.isFinite(seconds) && seconds >= 0) {
+        return Math.round(seconds * 1e3);
+      }
+      const retryAt = Date.parse(retryAfter);
+      if (Number.isNaN(retryAt))
+        return void 0;
+      return Math.max(retryAt - Date.now(), 0);
+    }
     async function fetchQuota2(accessToken) {
       try {
         const res = await fetch(USAGE_URL, {
@@ -16815,9 +16828,29 @@ var require_quota = __commonJS({
           }
         });
         if (!res.ok) {
-          if (res.status === 401)
-            return unavailableState("Sign in to Claude Code to view quota");
-          return unavailableState(`API error: ${res.status}`);
+          if (res.status === 401) {
+            return unavailableState("Sign in to Claude Code to view quota", {
+              failureKind: "auth",
+              httpStatus: res.status
+            });
+          }
+          if (res.status === 429) {
+            return unavailableState(`API error: ${res.status}`, {
+              failureKind: "rate_limit",
+              httpStatus: res.status,
+              retryAfterMs: parseRetryAfterMs(res.headers.get("retry-after"))
+            });
+          }
+          if (res.status >= 500 && res.status <= 599) {
+            return unavailableState(`API error: ${res.status}`, {
+              failureKind: "server",
+              httpStatus: res.status
+            });
+          }
+          return unavailableState(`API error: ${res.status}`, {
+            failureKind: "unknown",
+            httpStatus: res.status
+          });
         }
         const data = await res.json();
         const fiveUtil = data.five_hour?.utilization ?? 0;
@@ -16832,7 +16865,95 @@ var require_quota = __commonJS({
           projectedSevenDay: projectFromElapsed(sevenUtil, sevenResetsAt, SEVEN_DAY_MS)
         };
       } catch {
-        return unavailableState("Network error");
+        return unavailableState("Network error", { failureKind: "network" });
+      }
+    }
+  }
+});
+
+// ../sidekick-shared/dist/quotaPresentation.js
+var require_quotaPresentation = __commonJS({
+  "../sidekick-shared/dist/quotaPresentation.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.describeQuotaFailure = describeQuotaFailure4;
+    function formatRetryAfter(ms) {
+      if (ms <= 0)
+        return "now";
+      const totalSeconds = Math.ceil(ms / 1e3);
+      const days = Math.floor(totalSeconds / 86400);
+      const hours = Math.floor(totalSeconds % 86400 / 3600);
+      const minutes = Math.floor(totalSeconds % 3600 / 60);
+      const seconds = totalSeconds % 60;
+      const parts = [];
+      if (days > 0)
+        parts.push(`${days}d`);
+      if (hours > 0)
+        parts.push(`${hours}h`);
+      if (minutes > 0 && days === 0)
+        parts.push(`${minutes}m`);
+      if (parts.length === 0)
+        parts.push(`${seconds}s`);
+      return parts.join(" ");
+    }
+    function describeQuotaFailure4(quota) {
+      if (!quota || quota.available || !quota.failureKind)
+        return null;
+      switch (quota.failureKind) {
+        case "auth":
+          if (quota.error === "No OAuth token available") {
+            return {
+              severity: "error",
+              title: "Sign in required",
+              message: "No Claude Code credentials are available in this environment.",
+              detail: "Run `claude` to sign in, then retry quota refresh.",
+              alertKey: "auth:no-credentials",
+              isRetryable: false
+            };
+          }
+          return {
+            severity: "error",
+            title: "Claude Code sign-in expired",
+            message: "The current Claude Code OAuth session was rejected.",
+            detail: "Sign in again to refresh subscription quota.",
+            alertKey: `auth:${quota.httpStatus ?? "unknown"}`,
+            isRetryable: false
+          };
+        case "network":
+          return {
+            severity: "warning",
+            title: "Quota API unreachable",
+            message: "Could not reach Anthropic from the current environment.",
+            detail: "Check connectivity, proxy, or firewall settings, then retry.",
+            alertKey: "network",
+            isRetryable: true
+          };
+        case "rate_limit":
+          return {
+            severity: "warning",
+            title: "Quota API rate limited",
+            message: quota.retryAfterMs != null ? `Retry in ${formatRetryAfter(quota.retryAfterMs)}.` : "Retry shortly.",
+            detail: quota.httpStatus != null ? `Anthropic returned HTTP ${quota.httpStatus}.` : void 0,
+            alertKey: `rate_limit:${quota.httpStatus ?? 429}`,
+            isRetryable: true
+          };
+        case "server":
+          return {
+            severity: "warning",
+            title: "Quota API unavailable",
+            message: quota.httpStatus != null ? `Anthropic returned HTTP ${quota.httpStatus}. Try again shortly.` : "Anthropic quota data is temporarily unavailable.",
+            alertKey: `server:${quota.httpStatus ?? "unknown"}`,
+            isRetryable: true
+          };
+        case "unknown":
+          return {
+            severity: "error",
+            title: "Unexpected quota response",
+            message: quota.httpStatus != null ? `Anthropic returned HTTP ${quota.httpStatus}.` : quota.error ?? "Quota data could not be retrieved.",
+            detail: "This failure is not classified as retryable.",
+            alertKey: `unknown:${quota.httpStatus ?? "none"}`,
+            isRetryable: false
+          };
       }
     }
   }
@@ -16895,7 +17016,7 @@ var require_dist = __commonJS({
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.findActiveClaudeSession = exports.discoverSessionDirectory = exports.getClaudeSessionDirectory = exports.encodeClaudeWorkspacePath = exports.detectSessionActivity = exports.extractTaskInfo = exports.scanSubagentDir = exports.normalizeCodexToolInput = exports.normalizeCodexToolName = exports.extractPatchFilePaths = exports.CodexRolloutParser = exports.parseDbPartData = exports.parseDbMessageData = exports.convertOpenCodeMessage = exports.detectPlanModeFromText = exports.normalizeToolInput = exports.normalizeToolName = exports.TRUNCATION_PATTERNS = exports.JsonlParser = exports.CodexProvider = exports.OpenCodeProvider = exports.ClaudeCodeProvider = exports.getAllDetectedProviders = exports.detectProvider = exports.readClaudeCodePlanFiles = exports.getPlanAnalytics = exports.writePlans = exports.getLatestPlan = exports.readPlans = exports.readLatestHandoff = exports.readHistory = exports.readNotes = exports.readDecisions = exports.readTasks = exports.getProjectSlugRaw = exports.getProjectSlug = exports.encodeWorkspacePath = exports.getGlobalDataPath = exports.getProjectDataPath = exports.getConfigDir = exports.MAX_PLANS_PER_PROJECT = exports.PLAN_SCHEMA_VERSION = exports.createEmptyTokenTotals = exports.HISTORICAL_DATA_SCHEMA_VERSION = exports.STALENESS_THRESHOLDS = exports.IMPORTANCE_DECAY_FACTORS = exports.KNOWLEDGE_NOTE_SCHEMA_VERSION = exports.DECISION_LOG_SCHEMA_VERSION = exports.normalizeTaskStatus = exports.TASK_PERSISTENCE_SCHEMA_VERSION = void 0;
     exports.HeatmapTracker = exports.FrequencyTracker = exports.getSnapshotPath = exports.isSnapshotValid = exports.deleteSnapshot = exports.loadSnapshot = exports.saveSnapshot = exports.parseTodoDependencies = exports.EventAggregator = exports.getRandomPhrase = exports.ALL_PHRASES = exports.HIGHLIGHT_CSS = exports.clearHighlightCache = exports.highlightEvent = exports.formatSessionJson = exports.formatSessionMarkdown = exports.formatSessionText = exports.classifyNoise = exports.shouldMergeWithPrevious = exports.classifyFollowEvent = exports.classifyMessage = exports.getSoftNoiseReason = exports.isHardNoiseFollowEvent = exports.isHardNoise = exports.formatToolSummary = exports.toFollowEvents = exports.createWatcher = exports.parseChangelog = exports.extractProposedPlanShared = exports.parsePlanMarkdownShared = exports.PlanExtractor = exports.composeContext = exports.FilterEngine = exports.searchSessions = exports.CodexDatabase = exports.OpenCodeDatabase = exports.discoverDebugLogs = exports.collapseDuplicates = exports.filterByLevel = exports.parseDebugLog = exports.scanSubagentTraces = exports.findAllSessionsWithWorktrees = exports.discoverWorktreeSiblings = exports.resolveWorktreeMainRepo = exports.getAllClaudeProjectFolders = exports.decodeEncodedPath = exports.getMostRecentlyActiveSessionDir = exports.findSubdirectorySessionDirs = exports.findSessionsInDirectory = exports.findAllClaudeSessions = void 0;
-    exports.fetchProviderStatus = exports.fetchQuota = exports.readClaudeMaxAccessTokenSync = exports.readClaudeMaxCredentials = exports.openInBrowser = exports.parseTranscript = exports.generateHtmlReport = exports.PatternExtractor = void 0;
+    exports.fetchProviderStatus = exports.describeQuotaFailure = exports.fetchQuota = exports.readClaudeMaxAccessTokenSync = exports.readClaudeMaxCredentials = exports.openInBrowser = exports.parseTranscript = exports.generateHtmlReport = exports.PatternExtractor = void 0;
     var taskPersistence_1 = require_taskPersistence();
     Object.defineProperty(exports, "TASK_PERSISTENCE_SCHEMA_VERSION", { enumerable: true, get: function() {
       return taskPersistence_1.TASK_PERSISTENCE_SCHEMA_VERSION;
@@ -17263,6 +17384,10 @@ var require_dist = __commonJS({
     Object.defineProperty(exports, "fetchQuota", { enumerable: true, get: function() {
       return quota_1.fetchQuota;
     } });
+    var quotaPresentation_1 = require_quotaPresentation();
+    Object.defineProperty(exports, "describeQuotaFailure", { enumerable: true, get: function() {
+      return quotaPresentation_1.describeQuotaFailure;
+    } });
     var providerStatus_1 = require_providerStatus();
     Object.defineProperty(exports, "fetchProviderStatus", { enumerable: true, get: function() {
       return providerStatus_1.fetchProviderStatus;
@@ -19332,12 +19457,25 @@ var init_StaticDataLoader = __esm({
 });
 
 // src/dashboard/QuotaService.ts
-var import_sidekick_shared4, REFRESH_MS, QuotaService;
+function unavailableAuthState() {
+  return {
+    fiveHour: { utilization: 0, resetsAt: "" },
+    sevenDay: { utilization: 0, resetsAt: "" },
+    available: false,
+    error: NO_CREDENTIALS_ERROR,
+    failureKind: "auth"
+  };
+}
+function shouldKeepCachedQuota(state) {
+  return !state.available && (state.failureKind === "network" || state.failureKind === "rate_limit" || state.failureKind === "server");
+}
+var import_sidekick_shared4, REFRESH_MS, NO_CREDENTIALS_ERROR, QuotaService;
 var init_QuotaService = __esm({
   "src/dashboard/QuotaService.ts"() {
     "use strict";
     import_sidekick_shared4 = __toESM(require_dist(), 1);
     REFRESH_MS = 3e4;
+    NO_CREDENTIALS_ERROR = "No OAuth token available";
     QuotaService = class {
       _interval = null;
       _cached = null;
@@ -19367,18 +19505,18 @@ var init_QuotaService = __esm({
       async fetchOnce() {
         const creds = await (0, import_sidekick_shared4.readClaudeMaxCredentials)();
         if (!creds) {
-          return { fiveHour: { utilization: 0, resetsAt: "" }, sevenDay: { utilization: 0, resetsAt: "" }, available: false, error: "no-credentials" };
+          return unavailableAuthState();
         }
         return (0, import_sidekick_shared4.fetchQuota)(creds.accessToken);
       }
       async fetchQuota() {
         const creds = await (0, import_sidekick_shared4.readClaudeMaxCredentials)();
         if (!creds) {
-          this.emit({ fiveHour: { utilization: 0, resetsAt: "" }, sevenDay: { utilization: 0, resetsAt: "" }, available: false });
+          this.emit(unavailableAuthState());
           return;
         }
         const state = await (0, import_sidekick_shared4.fetchQuota)(creds.accessToken);
-        if (!state.available && this._cached?.available) return;
+        if (shouldKeepCachedQuota(state) && this._cached?.available) return;
         this.emit(state);
       }
       emit(state) {
@@ -19465,7 +19603,7 @@ var init_UpdateCheckService = __esm({
       /** Run the update check (one-shot). */
       async check() {
         try {
-          const current = "0.13.7";
+          const current = "0.13.8";
           const cached = this.readCache();
           let latest;
           if (cached && Date.now() - cached.checkedAt < CACHE_TTL_MS) {
@@ -21048,6 +21186,18 @@ ${hint}{/grey-fg}`;
               return ` {grey-fg}\u2192{/grey-fg} {${pc}-fg}${q.projectedSevenDay.toFixed(0)}%{/${pc}-fg}`;
             })() : "";
             lines.push(`  {grey-fg}7d{/grey-fg}  ${sevenBar} {bold}${q.sevenDay.utilization.toFixed(0)}%{/bold}${sevenProj}`);
+          } else if (m.providerId === "claude-code" && m.quota) {
+            const descriptor = (0, import_sidekick_shared7.describeQuotaFailure)(m.quota);
+            if (descriptor) {
+              const severityColor = descriptor.severity === "warning" ? "yellow" : descriptor.severity === "info" ? "cyan" : "red";
+              lines.push("", sectionHeader("Quota", w2));
+              lines.push(`  {${severityColor}-fg}${descriptor.title}{/${severityColor}-fg}`);
+              const failureText = [descriptor.message, descriptor.detail].filter(Boolean).join(" ");
+              const quotaTextWidth = Math.max(20, detailWidth(w2) - 4);
+              for (const line of wordWrap(failureText, quotaTextWidth)) {
+                lines.push(`  {grey-fg}${line}{/grey-fg}`);
+              }
+            }
           }
           if (m.providerStatus && m.providerStatus.indicator !== "none") {
             const ps = m.providerStatus;
@@ -60054,7 +60204,7 @@ function StatusBar({
       /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Text, { children: parseBlessedTags(BRAND_INLINE) }),
       /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(Text, { dimColor: true, children: [
         " v",
-        "0.13.7"
+        "0.13.8"
       ] }),
       updateInfo && /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(Text, { color: "yellow", children: [
         " (v",
@@ -60432,7 +60582,7 @@ function ChangelogOverlay({ entries, scrollOffset }) {
       "  ",
       /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)(Text, { bold: true, color: "cyan", children: [
         "Terminal Dashboard v",
-        "0.13.7"
+        "0.13.8"
       ] }),
       latestDate ? /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)(Text, { color: "gray", children: [
         " \u2014 ",
@@ -60754,7 +60904,7 @@ var init_mouse = __esm({
 var CHANGELOG_default;
 var init_CHANGELOG = __esm({
   "CHANGELOG.md"() {
-    CHANGELOG_default = '# Changelog\n\nAll notable changes to the Sidekick Agent Hub CLI will be documented in this file.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n## [0.13.7] - 2026-03-11\n\n### Changed\n\n- **npm README sync**: Updated the published CLI package README to reflect current OpenCode monitoring behavior, platform-specific data directories, and the `sqlite3` runtime requirement\n- **README badge cleanup**: Removed the Ask DeepWiki badge from the published CLI package README; the repo root README still keeps it\n\n## [0.13.6] - 2026-03-11\n\n### Changed\n\n- **Refreshed CLI Dashboard Wordmark**: Updated the dashboard wordmark/header styling for a cleaner splash and dashboard identity\n\n### Fixed\n\n- **OpenCode dashboard startup**: OpenCode DB-backed session discovery now resolves projects by worktree, sandboxes, and session directory instead of quietly behaving like no session exists\n- **OpenCode runtime notices**: The CLI now prints an OpenCode-only actionable notice when `opencode.db` exists but `sqlite3` is missing, blocked, or otherwise unusable in the current shell environment\n\n## [0.13.5] - 2026-03-10\n\n### Added\n\n- **`sidekick status` Command**: One-shot Claude API status check with color-coded text output and `--json` mode\n- **Dashboard Status Banner**: Status bar shows a colored `\u25CF API minor/major/critical` indicator when Claude is degraded; Sessions panel Summary tab shows an "API Status" section with affected components and active incident details. Polls every 60s\n\n## [0.13.4] - 2026-03-08\n\n### Fixed\n\n- **Onboarding Phrase Spam**: Splash screen and detail pane motivational phrases memoized \u2014 no longer flicker every render tick (fixes [#13](https://github.com/cesarandreslopez/sidekick-agent-hub/issues/13))\n\n### Changed\n\n- **Simplified Logo**: Replaced 6-line ASCII robot art with compact text header in splash, help, and changelog overlays\n- **Removed Dead Code**: Removed unused `getSplashContent()` and `HELP_HEADER` exports from branding module\n\n## [0.13.3] - 2026-03-04\n\n_No CLI-specific changes in this release._\n\n## [0.13.2] - 2026-03-04\n\n_No CLI-specific changes in this release._\n\n## [0.13.1] - 2026-03-04\n\n### Added\n\n- **`sidekick quota` Command**: One-shot subscription quota check showing 5-hour and 7-day utilization with color-coded progress bars and reset countdowns \u2014 supports `--json` for machine-readable output\n- **Quota Projections**: Elapsed-time projections shown in `sidekick quota` output and TUI dashboard quota section \u2014 displays projected end-of-window utilization next to current value (e.g., `40% \u2192 100%`), included in `--json` output as `projectedFiveHour` / `projectedSevenDay`\n\n## [0.13.0] - 2026-03-03\n\n_No CLI-specific changes in this release._\n\n## [0.12.10] - 2026-03-01\n\n### Added\n\n- **Events Panel** (key 7): Scrollable live event stream with colored type badges (`[USR]`, `[AST]`, `[TOOL]`, `[RES]`), timestamps, and keyword-highlighted summaries; detail tabs for full event JSON and surrounding context\n- **Charts Panel** (key 8): Tool frequency horizontal bars, event type distribution, 60-minute activity heatmap using `\u2591\u2592\u2593\u2588` intensity characters, and pattern analysis with frequency bars and template text\n- **Multi-Mode Filter**: `/` filter overlay now supports four modes \u2014 substring, fuzzy, regex, and date range \u2014 Tab cycles modes, regex mode shows red validation errors\n- **Search Term Highlighting**: Active filter terms highlighted in blue within side list items\n- **Timeline Keyword Coloring**: Event summaries in the Sessions panel Timeline tab now use semantic keyword coloring \u2014 errors red, success green, tool names cyan, file paths magenta\n\n### Removed\n\n- **Search Panel**: Removed redundant Search panel (previously key 7) \u2014 the `/` filter with multi-mode support serves the same purpose\n\n## [0.12.9] - 2026-02-28\n\n### Added\n\n- **Standalone Data Commands**: `sidekick tasks`, `sidekick decisions`, `sidekick notes`, `sidekick stats`, `sidekick handoff` for accessing project data without launching the TUI\n- **`sidekick search <query>`**: Cross-session full-text search from the terminal\n- **`sidekick context`**: Composite output of tasks, decisions, notes, and handoff for piping into other tools\n- **`--list` flag on `sidekick dump`**: Discover available session IDs before requiring `--session <id>`\n- **Search Panel**: Search panel (panel 7) wired into the TUI dashboard\n\n### Changed\n\n- **`taskMerger` utility**: Duplicate `mergeTasks` logic extracted into shared `taskMerger` utility\n- **Model constants**: Hardcoded model IDs extracted to named constants\n\n### Fixed\n\n- **`convention` icon**: Notes panel icon replaced with valid `tip` type\n- **Linux clipboard**: Now supports Wayland (`wl-copy`) and `xsel` fallbacks, with error messages instead of silent failure\n- **`provider.dispose()`**: Added to `dump` and `report` commands (prevents SQLite connection leaks)\n\n## [0.12.8] - 2026-02-28\n\n### Changed\n\n- **Dashboard UI/UX Polish**: Visual overhaul for better hierarchy, consistency, and readability\n  - Splash screen and help overlay now display the robot ASCII logo\n  - Toast notifications show severity icons (\u2718 error, \u26A0 warning, \u25CF info) with inner padding\n  - Focused pane uses double-border for clear focus indication\n  - Section dividers (`\u2500\u2500 Title \u2500\u2500\u2500\u2500`) replace bare bold headers in summary, agents, and context attribution\n  - Tab bar: active tab underlined in magenta, inactive tabs dimmed, bracket syntax removed\n  - Status bar: segmented layout with `\u2502` separators; keys bold, labels dim\n  - Summary metrics condensed: elapsed/events/compactions on one line, tokens on one line with cache rate and cost\n  - Sparklines display peak metadata annotations\n  - Progress bars use blessed color tags for consistent coloring\n  - Help overlay uses dot-leader alignment for all keybinding rows\n  - Empty state hints per panel (e.g. "Tasks appear as your agent works.")\n  - Session picker groups sessions by provider with section headers when multiple providers are present\n\n## [0.12.7] - 2026-02-27\n\n### Added\n\n- **HTML Session Report**: `sidekick report` command generates a self-contained HTML report and opens it in the default browser\n  - Options: `--session`, `--output`, `--theme` (dark/light), `--no-open`, `--no-thinking`\n  - TUI Dashboard: press `r` to generate and open an HTML report for the current session\n\n## [0.12.6] - 2026-02-26\n\n### Added\n\n- **Session Dump Command**: `sidekick dump` exports session data in text, markdown, or JSON format with `--format`, `--width`, and `--expand` options\n- **Plans Panel Re-enabled**: Plans panel restored in CLI dashboard with plan file discovery from `~/.claude/plans/`\n- **Enhanced Status Bar**: Session info display improved with richer metadata\n\n### Fixed\n\n- **Old snapshot format migration**: Restoring pre-0.12.3 session snapshots no longer shows empty timeline entries\n\n### Changed\n\n- **Phrase library moved to shared**: CLI-specific phrase formatting kept local, all phrase content now from `sidekick-shared`\n\n## [0.12.5] - 2026-02-24\n\n### Fixed\n\n- **Update check too slow to notice new versions**: Reduced npm registry cache TTL from 24 hours to 4 hours so upgrade notices appear sooner after a new release\n\n## [0.12.4] - 2026-02-24\n\n### Fixed\n\n- **Session crash on upgrade**: Fixed `d.timestamp.getTime is not a function` error when restoring tool call data from session snapshots \u2014 `Date` objects were serialized to strings by JSON but not rehydrated on restore, causing the session monitor to crash on first run after upgrading from 0.12.2 to 0.12.3\n\n## [0.12.3] - 2026-02-24\n\n### Added\n\n- **Latest-node indicator**: The most recently added node in tree and boxed mind map views is now marked with a yellow indicator\n- **Plan analytics in mind map**: Tree and boxed views now display plan progress and per-step metrics\n  - Tree view: plan header shows completion stats; steps show complexity, duration, tokens, tool calls, and errors in metadata brackets\n  - Box view: progress bar with completion percentage; steps show right-aligned metrics; subtitle shows step count and total duration\n- **Cross-provider plan extraction**: Shared `PlanExtractor` now handles Claude Code (EnterPlanMode/ExitPlanMode) and OpenCode (`<proposed_plan>` XML) plans \u2014 previously only Codex plans were shown\n- **Enriched plan data model**: Plan steps include duration, token count, tool call count, and error messages\n- **Phase-grouped plan display**: When a plan has phase structure, tree and boxed views group steps under phase headers with context lines from the original plan markdown\n- **Node type filter**: Press `f` on the Mind Map tab to cycle through node type filters (file, tool, task, subagent, command, plan, knowledge-note) \u2014 non-matching sections render dimmed in grey\n\n### Fixed\n\n- **Kanban board regression**: Subagent and plan-step tasks now correctly appear in the kanban board\n\n### Changed\n\n- **Plans panel temporarily disabled**: The Plans panel in the CLI dashboard is disabled until plan-mode event capture is reliably working end-to-end. Plan nodes in the mind map remain active.\n- `DashboardState` now delegates to shared `EventAggregator` instead of maintaining its own aggregation logic\n\n## [0.12.2] - 2026-02-23\n\n### Added\n\n- **Update notifications**: The dashboard now checks the npm registry for newer versions on startup and shows a yellow banner in the status bar when an update is available (e.g., `v0.13.0 available \u2014 npm i -g sidekick-agent-hub`). Results are cached for 24 hours to avoid repeated network requests.\n\n## [0.12.1] - 2026-02-23\n\n### Fixed\n\n- **VS Code integration**: Fixed exit code 127 when the extension launches the CLI dashboard on systems using nvm or volta (node binary not found when shell init is bypassed)\n\n## [0.12.0] - 2026-02-22\n\n### Added\n\n- **"Open CLI Dashboard" VS Code Integration**: New VS Code command `Sidekick: Open CLI Dashboard` launches the TUI dashboard in an integrated terminal\n  - Install the CLI with `npm install -g sidekick-agent-hub`\n\n## [0.11.0] - 2026-02-19\n\n### Added\n\n- **Initial Release**: Full-screen TUI dashboard for monitoring agent sessions from the terminal\n  - Ink-based terminal UI with panels for sessions, tasks, kanban, mind map, notes, decisions, search, files, and git diff\n  - Multi-provider support: auto-detects Claude Code, OpenCode, and Codex sessions\n  - Reads from `~/.config/sidekick/` \u2014 the same data files the VS Code extension writes\n  - Usage: `sidekick dashboard [--project <path>] [--provider <id>]`\n';
+    CHANGELOG_default = '# Changelog\n\nAll notable changes to the Sidekick Agent Hub CLI will be documented in this file.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n## [0.13.8] - 2026-03-12\n\n### Changed\n\n- **Structured quota failure output**: `sidekick quota` now renders consistent auth, rate-limit, server, network, and unexpected-failure copy from shared quota failure descriptors while preserving `--json` machine-readable output\n- **Dashboard unavailable quota rendering**: The Sessions panel now shows Claude Code quota failures inline instead of hiding the quota section whenever subscription data is unavailable\n- **Quota transition toasts**: The Ink dashboard now fires low-noise toast notifications only when Claude Code quota failure state changes, avoiding repeated alerts every polling interval\n\n## [0.13.7] - 2026-03-11\n\n### Changed\n\n- **npm README sync**: Updated the published CLI package README to reflect current OpenCode monitoring behavior, platform-specific data directories, and the `sqlite3` runtime requirement\n- **README badge cleanup**: Removed the Ask DeepWiki badge from the published CLI package README; the repo root README still keeps it\n\n## [0.13.6] - 2026-03-11\n\n### Changed\n\n- **Refreshed CLI Dashboard Wordmark**: Updated the dashboard wordmark/header styling for a cleaner splash and dashboard identity\n\n### Fixed\n\n- **OpenCode dashboard startup**: OpenCode DB-backed session discovery now resolves projects by worktree, sandboxes, and session directory instead of quietly behaving like no session exists\n- **OpenCode runtime notices**: The CLI now prints an OpenCode-only actionable notice when `opencode.db` exists but `sqlite3` is missing, blocked, or otherwise unusable in the current shell environment\n\n## [0.13.5] - 2026-03-10\n\n### Added\n\n- **`sidekick status` Command**: One-shot Claude API status check with color-coded text output and `--json` mode\n- **Dashboard Status Banner**: Status bar shows a colored `\u25CF API minor/major/critical` indicator when Claude is degraded; Sessions panel Summary tab shows an "API Status" section with affected components and active incident details. Polls every 60s\n\n## [0.13.4] - 2026-03-08\n\n### Fixed\n\n- **Onboarding Phrase Spam**: Splash screen and detail pane motivational phrases memoized \u2014 no longer flicker every render tick (fixes [#13](https://github.com/cesarandreslopez/sidekick-agent-hub/issues/13))\n\n### Changed\n\n- **Simplified Logo**: Replaced 6-line ASCII robot art with compact text header in splash, help, and changelog overlays\n- **Removed Dead Code**: Removed unused `getSplashContent()` and `HELP_HEADER` exports from branding module\n\n## [0.13.3] - 2026-03-04\n\n_No CLI-specific changes in this release._\n\n## [0.13.2] - 2026-03-04\n\n_No CLI-specific changes in this release._\n\n## [0.13.1] - 2026-03-04\n\n### Added\n\n- **`sidekick quota` Command**: One-shot subscription quota check showing 5-hour and 7-day utilization with color-coded progress bars and reset countdowns \u2014 supports `--json` for machine-readable output\n- **Quota Projections**: Elapsed-time projections shown in `sidekick quota` output and TUI dashboard quota section \u2014 displays projected end-of-window utilization next to current value (e.g., `40% \u2192 100%`), included in `--json` output as `projectedFiveHour` / `projectedSevenDay`\n\n## [0.13.0] - 2026-03-03\n\n_No CLI-specific changes in this release._\n\n## [0.12.10] - 2026-03-01\n\n### Added\n\n- **Events Panel** (key 7): Scrollable live event stream with colored type badges (`[USR]`, `[AST]`, `[TOOL]`, `[RES]`), timestamps, and keyword-highlighted summaries; detail tabs for full event JSON and surrounding context\n- **Charts Panel** (key 8): Tool frequency horizontal bars, event type distribution, 60-minute activity heatmap using `\u2591\u2592\u2593\u2588` intensity characters, and pattern analysis with frequency bars and template text\n- **Multi-Mode Filter**: `/` filter overlay now supports four modes \u2014 substring, fuzzy, regex, and date range \u2014 Tab cycles modes, regex mode shows red validation errors\n- **Search Term Highlighting**: Active filter terms highlighted in blue within side list items\n- **Timeline Keyword Coloring**: Event summaries in the Sessions panel Timeline tab now use semantic keyword coloring \u2014 errors red, success green, tool names cyan, file paths magenta\n\n### Removed\n\n- **Search Panel**: Removed redundant Search panel (previously key 7) \u2014 the `/` filter with multi-mode support serves the same purpose\n\n## [0.12.9] - 2026-02-28\n\n### Added\n\n- **Standalone Data Commands**: `sidekick tasks`, `sidekick decisions`, `sidekick notes`, `sidekick stats`, `sidekick handoff` for accessing project data without launching the TUI\n- **`sidekick search <query>`**: Cross-session full-text search from the terminal\n- **`sidekick context`**: Composite output of tasks, decisions, notes, and handoff for piping into other tools\n- **`--list` flag on `sidekick dump`**: Discover available session IDs before requiring `--session <id>`\n- **Search Panel**: Search panel (panel 7) wired into the TUI dashboard\n\n### Changed\n\n- **`taskMerger` utility**: Duplicate `mergeTasks` logic extracted into shared `taskMerger` utility\n- **Model constants**: Hardcoded model IDs extracted to named constants\n\n### Fixed\n\n- **`convention` icon**: Notes panel icon replaced with valid `tip` type\n- **Linux clipboard**: Now supports Wayland (`wl-copy`) and `xsel` fallbacks, with error messages instead of silent failure\n- **`provider.dispose()`**: Added to `dump` and `report` commands (prevents SQLite connection leaks)\n\n## [0.12.8] - 2026-02-28\n\n### Changed\n\n- **Dashboard UI/UX Polish**: Visual overhaul for better hierarchy, consistency, and readability\n  - Splash screen and help overlay now display the robot ASCII logo\n  - Toast notifications show severity icons (\u2718 error, \u26A0 warning, \u25CF info) with inner padding\n  - Focused pane uses double-border for clear focus indication\n  - Section dividers (`\u2500\u2500 Title \u2500\u2500\u2500\u2500`) replace bare bold headers in summary, agents, and context attribution\n  - Tab bar: active tab underlined in magenta, inactive tabs dimmed, bracket syntax removed\n  - Status bar: segmented layout with `\u2502` separators; keys bold, labels dim\n  - Summary metrics condensed: elapsed/events/compactions on one line, tokens on one line with cache rate and cost\n  - Sparklines display peak metadata annotations\n  - Progress bars use blessed color tags for consistent coloring\n  - Help overlay uses dot-leader alignment for all keybinding rows\n  - Empty state hints per panel (e.g. "Tasks appear as your agent works.")\n  - Session picker groups sessions by provider with section headers when multiple providers are present\n\n## [0.12.7] - 2026-02-27\n\n### Added\n\n- **HTML Session Report**: `sidekick report` command generates a self-contained HTML report and opens it in the default browser\n  - Options: `--session`, `--output`, `--theme` (dark/light), `--no-open`, `--no-thinking`\n  - TUI Dashboard: press `r` to generate and open an HTML report for the current session\n\n## [0.12.6] - 2026-02-26\n\n### Added\n\n- **Session Dump Command**: `sidekick dump` exports session data in text, markdown, or JSON format with `--format`, `--width`, and `--expand` options\n- **Plans Panel Re-enabled**: Plans panel restored in CLI dashboard with plan file discovery from `~/.claude/plans/`\n- **Enhanced Status Bar**: Session info display improved with richer metadata\n\n### Fixed\n\n- **Old snapshot format migration**: Restoring pre-0.12.3 session snapshots no longer shows empty timeline entries\n\n### Changed\n\n- **Phrase library moved to shared**: CLI-specific phrase formatting kept local, all phrase content now from `sidekick-shared`\n\n## [0.12.5] - 2026-02-24\n\n### Fixed\n\n- **Update check too slow to notice new versions**: Reduced npm registry cache TTL from 24 hours to 4 hours so upgrade notices appear sooner after a new release\n\n## [0.12.4] - 2026-02-24\n\n### Fixed\n\n- **Session crash on upgrade**: Fixed `d.timestamp.getTime is not a function` error when restoring tool call data from session snapshots \u2014 `Date` objects were serialized to strings by JSON but not rehydrated on restore, causing the session monitor to crash on first run after upgrading from 0.12.2 to 0.12.3\n\n## [0.12.3] - 2026-02-24\n\n### Added\n\n- **Latest-node indicator**: The most recently added node in tree and boxed mind map views is now marked with a yellow indicator\n- **Plan analytics in mind map**: Tree and boxed views now display plan progress and per-step metrics\n  - Tree view: plan header shows completion stats; steps show complexity, duration, tokens, tool calls, and errors in metadata brackets\n  - Box view: progress bar with completion percentage; steps show right-aligned metrics; subtitle shows step count and total duration\n- **Cross-provider plan extraction**: Shared `PlanExtractor` now handles Claude Code (EnterPlanMode/ExitPlanMode) and OpenCode (`<proposed_plan>` XML) plans \u2014 previously only Codex plans were shown\n- **Enriched plan data model**: Plan steps include duration, token count, tool call count, and error messages\n- **Phase-grouped plan display**: When a plan has phase structure, tree and boxed views group steps under phase headers with context lines from the original plan markdown\n- **Node type filter**: Press `f` on the Mind Map tab to cycle through node type filters (file, tool, task, subagent, command, plan, knowledge-note) \u2014 non-matching sections render dimmed in grey\n\n### Fixed\n\n- **Kanban board regression**: Subagent and plan-step tasks now correctly appear in the kanban board\n\n### Changed\n\n- **Plans panel temporarily disabled**: The Plans panel in the CLI dashboard is disabled until plan-mode event capture is reliably working end-to-end. Plan nodes in the mind map remain active.\n- `DashboardState` now delegates to shared `EventAggregator` instead of maintaining its own aggregation logic\n\n## [0.12.2] - 2026-02-23\n\n### Added\n\n- **Update notifications**: The dashboard now checks the npm registry for newer versions on startup and shows a yellow banner in the status bar when an update is available (e.g., `v0.13.0 available \u2014 npm i -g sidekick-agent-hub`). Results are cached for 24 hours to avoid repeated network requests.\n\n## [0.12.1] - 2026-02-23\n\n### Fixed\n\n- **VS Code integration**: Fixed exit code 127 when the extension launches the CLI dashboard on systems using nvm or volta (node binary not found when shell init is bypassed)\n\n## [0.12.0] - 2026-02-22\n\n### Added\n\n- **"Open CLI Dashboard" VS Code Integration**: New VS Code command `Sidekick: Open CLI Dashboard` launches the TUI dashboard in an integrated terminal\n  - Install the CLI with `npm install -g sidekick-agent-hub`\n\n## [0.11.0] - 2026-02-19\n\n### Added\n\n- **Initial Release**: Full-screen TUI dashboard for monitoring agent sessions from the terminal\n  - Ink-based terminal UI with panels for sessions, tasks, kanban, mind map, notes, decisions, search, files, and git diff\n  - Multi-provider support: auto-detects Claude Code, OpenCode, and Codex sessions\n  - Reads from `~/.config/sidekick/` \u2014 the same data files the VS Code extension writes\n  - Usage: `sidekick dashboard [--project <path>] [--provider <id>]`\n';
   }
 });
 
@@ -60879,6 +61029,7 @@ function Dashboard({ panels, metrics, staticData, isPinned, pendingSessionPath,
   const { columns, rows } = useTerminalSize();
   const toastIdRef = (0, import_react36.useRef)(0);
   const lastAlertCountRef = (0, import_react36.useRef)(0);
+  const lastQuotaAlertKeyRef = (0, import_react36.useRef)(null);
   const alertsInitRef = (0, import_react36.useRef)(false);
   const prevDetailLineCountRef = (0, import_react36.useRef)(0);
   (0, import_react36.useEffect)(() => {
@@ -60917,6 +61068,20 @@ function Dashboard({ panels, metrics, staticData, isPinned, pendingSessionPath,
       dispatch({ type: "REMOVE_TOAST", id });
     }, durations[severity]);
   }, []);
+  (0, import_react36.useEffect)(() => {
+    if (metrics.providerId !== "claude-code") {
+      lastQuotaAlertKeyRef.current = null;
+      return;
+    }
+    const descriptor = (0, import_sidekick_shared12.describeQuotaFailure)(metrics.quota);
+    if (!descriptor) {
+      lastQuotaAlertKeyRef.current = null;
+      return;
+    }
+    if (lastQuotaAlertKeyRef.current === descriptor.alertKey) return;
+    lastQuotaAlertKeyRef.current = descriptor.alertKey;
+    addToast(`${descriptor.title}: ${descriptor.message}`, descriptor.severity);
+  }, [addToast, metrics.providerId, metrics.quota]);
   const panel = panels[state.activePanelIndex];
   const tooSmall = columns < MIN_SCREEN_WIDTH || rows < MIN_SCREEN_HEIGHT;
   const getSideWidth = () => {
@@ -62837,21 +63002,28 @@ async function quotaAction(_opts, cmd) {
       process.stdout.write(JSON.stringify(quota, null, 2) + "\n");
       return;
     }
+    const descriptor = (0, import_sidekick_shared23.describeQuotaFailure)(quota);
     let msg;
-    switch (quota.error) {
-      case "no-credentials":
-        msg = "No Claude Code credentials found. Sign in with `claude` first.";
-        break;
-      case "auth-failed":
-        msg = "Authentication failed. Try signing in to Claude Code again.";
-        break;
-      case "network-error":
-        msg = "Could not reach the Anthropic API. Check your connection.";
-        break;
-      default:
-        msg = quota.error ?? "Unknown error fetching quota.";
+    let color = source_default.red;
+    if (descriptor) {
+      msg = [descriptor.title, descriptor.message, descriptor.detail].filter(Boolean).join(" ");
+      color = descriptor.severity === "warning" ? source_default.yellow : descriptor.severity === "info" ? source_default.cyan : source_default.red;
+    } else {
+      switch (quota.error) {
+        case "no-credentials":
+          msg = "No Claude Code credentials found. Sign in with `claude` first.";
+          break;
+        case "auth-failed":
+          msg = "Authentication failed. Try signing in to Claude Code again.";
+          break;
+        case "network-error":
+          msg = "Could not reach the Anthropic API. Check your connection.";
+          break;
+        default:
+          msg = quota.error ?? "Unknown error fetching quota.";
+      }
     }
-    process.stderr.write(source_default.red(msg) + "\n");
+    process.stderr.write(color(msg) + "\n");
     process.exit(1);
   }
   if (jsonOutput) {
@@ -62872,10 +63044,12 @@ async function quotaAction(_opts, cmd) {
   process.stdout.write(`  ${source_default.dim("7-Day")}    ${makeChalkBar(sevenPct, barWidth)} ${String(sevenPct).padStart(3)}%${sevenProj}   ${source_default.dim("resets " + sevenReset)}
 `);
 }
+var import_sidekick_shared23;
 var init_quota = __esm({
   "src/commands/quota.ts"() {
     "use strict";
     init_source();
+    import_sidekick_shared23 = __toESM(require_dist(), 1);
     init_QuotaService();
   }
 });
@@ -62888,7 +63062,7 @@ __export(status_exports, {
 async function statusAction(_opts, cmd) {
   const globalOpts = cmd.parent.opts();
   const jsonOutput = !!globalOpts.json;
-  const status = await (0, import_sidekick_shared23.fetchProviderStatus)();
+  const status = await (0, import_sidekick_shared24.fetchProviderStatus)();
   if (jsonOutput) {
     process.stdout.write(JSON.stringify(status, null, 2) + "\n");
     return;
@@ -62925,12 +63099,12 @@ async function statusAction(_opts, cmd) {
     }
   }
 }
-var import_sidekick_shared23;
+var import_sidekick_shared24;
 var init_status = __esm({
   "src/commands/status.ts"() {
     "use strict";
     init_source();
-    import_sidekick_shared23 = __toESM(require_dist(), 1);
+    import_sidekick_shared24 = __toESM(require_dist(), 1);
   }
 });
 
@@ -62944,12 +63118,12 @@ async function handoffAction(_opts, cmd) {
   const workspacePath = globalOpts.project || process.cwd();
   const jsonOutput = !!globalOpts.json;
   try {
-    const rawSlug = (0, import_sidekick_shared24.getProjectSlugRaw)(workspacePath);
-    const resolvedSlug = (0, import_sidekick_shared24.getProjectSlug)(workspacePath);
+    const rawSlug = (0, import_sidekick_shared25.getProjectSlugRaw)(workspacePath);
+    const resolvedSlug = (0, import_sidekick_shared25.getProjectSlug)(workspacePath);
     const slugs = rawSlug !== resolvedSlug ? [rawSlug, resolvedSlug] : [rawSlug];
     let content = null;
     for (const slug of slugs) {
-      content = await (0, import_sidekick_shared24.readLatestHandoff)(slug);
+      content = await (0, import_sidekick_shared25.readLatestHandoff)(slug);
       if (content) break;
     }
     if (!content) {
@@ -62974,37 +63148,37 @@ async function handoffAction(_opts, cmd) {
     process.exit(1);
   }
 }
-var import_sidekick_shared24;
+var import_sidekick_shared25;
 var init_handoff = __esm({
   "src/commands/handoff.ts"() {
     "use strict";
     init_source();
-    import_sidekick_shared24 = __toESM(require_dist(), 1);
+    import_sidekick_shared25 = __toESM(require_dist(), 1);
   }
 });
 
 // src/cli.ts
 function resolveProvider(opts) {
   const override = opts.provider && opts.provider !== "auto" ? opts.provider : void 0;
-  const id = override || (0, import_sidekick_shared25.detectProvider)(override);
+  const id = override || (0, import_sidekick_shared26.detectProvider)(override);
   switch (id) {
     case "opencode":
-      return new import_sidekick_shared26.OpenCodeProvider();
+      return new import_sidekick_shared27.OpenCodeProvider();
     case "codex":
-      return new import_sidekick_shared26.CodexProvider();
+      return new import_sidekick_shared27.CodexProvider();
     case "claude-code":
     default:
-      return new import_sidekick_shared26.ClaudeCodeProvider();
+      return new import_sidekick_shared27.ClaudeCodeProvider();
   }
 }
-var import_sidekick_shared25, import_sidekick_shared26, program2, dashCmd, dumpCmd, ctxCmd, reportCmd, searchCmd, tasksCmd, decisionsCmd, notesCmd, statsCmd, quotaCmd, statusCmd, handoffCmd;
+var import_sidekick_shared26, import_sidekick_shared27, program2, dashCmd, dumpCmd, ctxCmd, reportCmd, searchCmd, tasksCmd, decisionsCmd, notesCmd, statsCmd, quotaCmd, statusCmd, handoffCmd;
 var init_cli = __esm({
   "src/cli.ts"() {
     init_esm();
-    import_sidekick_shared25 = __toESM(require_dist(), 1);
     import_sidekick_shared26 = __toESM(require_dist(), 1);
+    import_sidekick_shared27 = __toESM(require_dist(), 1);
     program2 = new Command();
-    program2.name("sidekick").description("Query Sidekick project intelligence from the command line").version("0.13.7").option("--json", "Output as JSON").option("--project <path>", "Override project path (default: cwd)").option("--provider <id>", "Provider: claude-code, opencode, codex, auto (default: auto)");
+    program2.name("sidekick").description("Query Sidekick project intelligence from the command line").version("0.13.8").option("--json", "Output as JSON").option("--project <path>", "Override project path (default: cwd)").option("--provider <id>", "Provider: claude-code, opencode, codex, auto (default: auto)");
     dashCmd = new Command("dashboard").description("Full-screen TUI dashboard with live session metrics").option("--session <id>", "Follow a specific session (default: most recent)").option("--replay", "Replay existing events before streaming new ones").action(async (_opts, cmd) => {
       const { dashboardAction: dashboardAction2 } = await init_dashboard().then(() => dashboard_exports);
       return dashboardAction2(_opts, cmd);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sidekick-agent-hub",
-  "version": "0.13.7",
+  "version": "0.13.8",
   "description": "Terminal dashboard for monitoring AI coding agent sessions",
   "type": "module",
   "bin": {