lumira 1.12.2 → 1.13.0

package/.claude-plugin/marketplace.json

@@ -5,14 +5,14 @@
   },
   "metadata": {
     "description": "Real-time statusline HUD for Claude Code and Qwen Code — analytics, quota projection, themes, powerline",
-    "version": "1.12.2"
+    "version": "1.13.0"
   },
   "plugins": [
     {
       "name": "lumira",
       "source": "./",
       "description": "Real-time statusline HUD for Claude Code and Qwen Code. Session analytics, API latency widget, 7-day quota projection, auto-compact warnings, 7 themes, powerline support. Zero runtime dependencies. Run /lumira:setup after install to activate.",
-      "version": "1.12.2",
+      "version": "1.13.0",
       "author": {
         "name": "Carlos Cativo"
       },
@@ -32,5 +32,5 @@
       ]
     }
   ],
-  "version": "1.12.2"
+  "version": "1.13.0"
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lumira",
-  "version": "1.12.2",
+  "version": "1.13.0",
   "description": "Real-time statusline HUD for Claude Code and Qwen Code — session analytics, API latency, 7-day quota projection, auto-compact warnings, 7 themes, powerline. Zero runtime deps.",
   "author": {
     "name": "Carlos Cativo"

package/README.md

@@ -87,7 +87,7 @@ See [`docs/competitive-comparison.md`](docs/competitive-comparison.md) for the f
 ## Requirements
 
 - **Node ≥18**
-- **Nerd Font** (recommended) — for branch, folder, model, and spinner icons. Falls back to plain glyphs via `icons: emoji` or `icons: none`.
+- **Nerd Font** (recommended) — for branch, folder, model, and spinner icons. **Use a recent build (Nerd Fonts v3.0+);** some indicators use newer Material Design Icons codepoints (e.g. the extended-thinking glyph `U+F09D1`) that older font releases render as a blank/tofu cell. Falls back to plain glyphs via `icons: emoji` or `icons: none`.
 - **Truecolor terminal** (for themes / powerline) — auto-detected via `COLORTERM=truecolor`. 256-color terminals get a nearest-index projection; named-ANSI terminals fall back to default colors silently.
 
 ## Features
@@ -95,7 +95,7 @@ See [`docs/competitive-comparison.md`](docs/competitive-comparison.md) for the f
 - **Context bar with thresholds** — green → yellow → orange → blinking red, plus an actionable `/compact?` hint when fill is high.
 - **Session intelligence** — pace delta (🐢/🏎️) shows whether you're burning quota faster than the time window allows, with ETA when ahead of pace. Live agent count and cache hit rate round it out.
 - **Powerline mode** + 7 separator presets (`arrow`, `flame`, `slant`, `round`, `diamond`, `compatible`, `plain`) across 3 lines.
-- **OSC 8 hyperlinks** — clickable directory and version tag on iTerm2, WezTerm, Kitty, VS Code, Alacritty.
+- **OSC 8 hyperlinks** — clickable directory, repo, PR, and version tag on iTerm2, WezTerm, Kitty, VS Code, Alacritty.
 - **7 hand-curated themes** — `dracula`, `nord`, `tokyo-night`, `catppuccin`, `monokai`, `gruvbox`, `solarized`. WCAG AA contrast guaranteed in CI.
 - **Token + cost metrics** — input/output counts, speed (tok/s), $ total + burn rate ($/h), cache hit rate.
 - **Auto-fits at <70 cols** — switches from 3-line custom mode to single-line minimal automatically.
@@ -106,6 +106,7 @@ See [`docs/competitive-comparison.md`](docs/competitive-comparison.md) for the f
 <summary>Everything else lumira shows</summary>
 
 - **Git status** — branch + staged/modified/untracked counts, 5s TTL cache. Branch turns red on dirty repos in powerline mode.
+- **Repo identity** — when Claude Code exposes `workspace.repo`, line1 shows `owner/name` as a segment linked (OSC 8) to the repo on its host. Toggle via `display.repo`.
 - **Rate limits** — 5h/7d usage as a battery glyph (Nerd Font level fill, or 🔋/🪫 in emoji mode) with color tier and reset countdown. Threshold-gated at 50% to stay invisible while you have margin.
 - **Pace delta** — `usedPct − elapsedPct` of the 5h window. Turtle when behind pace (healthy), car with time-to-exhaustion when ahead. Color escalates green → yellow → orange → blinkRed. Toggle independently via `display.paceDelta`.
 - **7d quota projection** — when the current burn rate would exhaust the 7d quota before the window resets, the 7d segment grows a warning: `⚠ ~24h`, `⚠ ~2d`, `⚠ Tue`, or `🔥 ~8h` (critical icon under 12h). Default on. Toggle via `display.quotaProjection`; off in the `minimal` preset. Different from pace delta — pace looks backwards at the 5h window's actual vs proportional burn, projection looks forwards at the 7d window's exhaustion ETA.

package/dist/config.js

@@ -249,6 +249,7 @@ const PRESET_DEFS = {
         display: {
             agents: true,
             pr: true,
+            repo: true,
             thinking: true,
             burnRate: false,
             duration: false,
@@ -297,6 +298,7 @@ const PRESET_DEFS = {
             worktreeBreadcrumb: false,
             compactionCount: false,
             pr: false,
+            repo: false,
             thinking: false,
         },
     },

package/dist/normalize.js

@@ -123,7 +123,7 @@ export function normalize(input) {
     // For claude-code, honors CLAUDE_CODE_AUTO_COMPACT_WINDOW env var — a fill-%
     // threshold (1-100) that mirrors Claude Code's own auto-compact trigger point.
     // Users who changed this setting in Claude Code should set the same value here.
-    // Falls back to the hardcoded 80% default when absent or invalid.
+    // Falls back to the hardcoded 84% default when absent or invalid.
     const effectivePct = realUsedPercentage ?? contextWindow.used_percentage ?? 0;
     let platformAutoCompactThreshold = AUTO_COMPACT_THRESHOLD[platform];
     if (platform === 'claude-code') {
@@ -200,9 +200,24 @@ export function normalize(input) {
             pr = { number: n, url: prUrl, reviewState: prReviewState };
         }
     }
+    // Repository identity from workspace.repo (CC parses host/owner/name from the
+    // origin remote). All three parts must be present and well-formed: the url is
+    // rendered as an OSC 8 hyperlink, so each part is validated against a strict
+    // pattern to keep a malformed payload from injecting into the link target.
+    let repo;
+    const rawRepo = input.workspace?.repo;
+    if (rawRepo != null) {
+        const host = typeof rawRepo.host === 'string' ? sanitizeTermString(rawRepo.host) : '';
+        const owner = typeof rawRepo.owner === 'string' ? sanitizeTermString(rawRepo.owner) : '';
+        const name = typeof rawRepo.name === 'string' ? sanitizeTermString(rawRepo.name) : '';
+        if (/^[a-zA-Z0-9.-]+$/.test(host) && /^[\w.-]+$/.test(owner) && /^[\w.-]+$/.test(name)) {
+            repo = { host, owner, name, url: `https://${host}/${owner}/${name}` };
+        }
+    }
     return {
         platform,
         model: sanitizeTermString(modelName),
+        repo,
         sessionId: sanitizeTermString(input.session_id),
         version: input.version ? sanitizeTermString(input.version) : undefined,
         cwd: sanitizeTermString(cwd),
@@ -235,7 +250,13 @@ export function normalize(input) {
             ? sanitizeTermString(claude.effort.level)
             : undefined,
         thinkingEnabled: claude?.thinking?.enabled === true ? true : undefined,
-        worktreeName: input.worktree?.name ? sanitizeTermString(input.worktree.name) : undefined,
+        // Prefer the top-level worktree.name; fall back to workspace.git_worktree,
+        // which CC populates for ANY git worktree (verified on v2.1.193) — even
+        // sessions not started with --worktree, where worktree.name is absent.
+        worktreeName: (() => {
+            const n = input.worktree?.name ?? input.workspace?.git_worktree;
+            return n ? sanitizeTermString(n) : undefined;
+        })(),
         addedDirsCount: (() => {
             const dirs = input.workspace?.added_dirs;
             if (!Array.isArray(dirs) || dirs.length === 0)

package/dist/render/icons.js

@@ -61,6 +61,7 @@ export const NERD_ICONS = {
     turtle: '🐢', // turtle — pace-behind indicator
     lightning: '󱐋', // U+F140B — nerd lightning-bolt (was ⚡ emoji); cache hit rate
     pr: '', // nf-cod-git_pull_request
+    repo: '', // U+EA62 nf-cod-repo
     thinking: '󰧑', // U+F09D1 — clearer "thinking" glyph; nf-md-brain (U+F1824) renders faint in many fonts
     battery: nerdBattery,
 };
@@ -86,6 +87,7 @@ export const EMOJI_ICONS = {
     turtle: '\u{1F422}', // 🐢 — turtle
     lightning: '⚡', // ⚡ — cache hit rate
     pr: '\u{1F500}', // 🔀 — twisted rightwards arrows (PR)
+    repo: '\u{1F4E6}', // 📦 — package (repository)
     thinking: '\u{1F4AD}', // 💭 — thought bubble
     battery: (pct) => {
         if (!Number.isFinite(pct) || pct < 0)
@@ -119,6 +121,7 @@ export const NO_ICONS = {
     turtle: '',
     lightning: '',
     pr: 'PR',
+    repo: '',
     thinking: 'think',
     // No-icon mode keeps the legacy bolt fallback (currently empty) so users who
     // opted out of icons see no shape change from this feature.

package/dist/render/line1.js

@@ -40,6 +40,16 @@ export function renderLine1(ctx, c) {
             left.push(hyperlink(pathToFileURL(cwd).href, label));
         }
     }
+    // Repo segment — owner/name from workspace.repo, clickable to open the repo
+    // on its host. Distinct from the directory breadcrumb above (a local path):
+    // this is the canonical remote identity, and surfaces the owner that the
+    // bare cwd basename can't.
+    if (display.repo && input.repo) {
+        const { owner, name, url } = input.repo;
+        const repoLen = cols < 80 ? 14 : cols < 120 ? 24 : 36;
+        const label = c.brightBlue(`${icons.repo} ${truncField(`${owner}/${name}`, repoLen)}`);
+        left.push(hyperlink(url, label));
+    }
     // Added dirs badge — only when count > 0; warning color at >= 5
     if (display.addedDirs && input.addedDirsCount != null && input.addedDirsCount > 0) {
         const badge = `+${input.addedDirsCount} dirs`;

package/dist/render/powerline-line1.js

@@ -79,6 +79,19 @@ function buildSegments(ctx, palette, c) {
             priority: 60,
         });
     }
+    if (display.repo && input.repo) {
+        const { owner, name, url } = input.repo;
+        // Priority 58 — below directory@60 and the addedDirs badge@59. Repo is the
+        // canonical remote identity (annotates the local dir), so it cedes first
+        // under narrow-terminal pressure. Same dir-family background as directory.
+        segments.push({
+            text: hyperlink(url, truncField(`${owner}/${name}`, 36)),
+            icon: icons.repo,
+            bg: palette.dirBg,
+            fg: palette.fg,
+            priority: 58,
+        });
+    }
     if (display.addedDirs && input.addedDirsCount != null && input.addedDirsCount > 0) {
         const badge = `+${input.addedDirsCount} dirs`;
         const bg = input.addedDirsCount >= 5 ? palette.taskBg : palette.versionBg;

package/dist/tui/preview.js

@@ -115,13 +115,13 @@ function buildMockContext(opts) {
  * the context-bar auto-compact behavior they'll see in the live statusline.
  *
  * The platform thresholds referenced here are external constraints, not
- * lumira's: Claude Code auto-compacts at ~80% (hardcoded, reserves headroom
+ * lumira's: Claude Code auto-compacts at ~84% (hardcoded, reserves headroom
  * for output generation); Qwen Code defaults to 70% via the configurable
  * `model.chatCompression.contextPercentageThreshold`. The ⚠ glyph fires
  * 5pp before whichever applies — independent of user-tunable colour
  * thresholds, which track preference, not the platform's hard ceiling.
  */
-const CONTEXT_BAR_NOTE = '\n  Context bar: ⚠ appears in the 5pp window before auto-compact fires (~80% on Claude Code,\n' +
+const CONTEXT_BAR_NOTE = '\n  Context bar: ⚠ appears in the 5pp window before auto-compact fires (~84% on Claude Code,\n' +
     '  70% default on Qwen Code). New defaults (warning 65 / critical 78) turn the bar red before\n' +
     '  auto-compact triggers. Qwen users with a custom model.chatCompression.contextPercentageThreshold\n' +
     '  should mirror that value in lumira\'s contextCriticalThreshold for accurate gating.\n';

package/dist/types.js

@@ -56,7 +56,7 @@ export const QUOTA_CRITICAL = 85;
  * Auto-compact threshold per platform — the % of context window at which
  * the platform automatically compacts the conversation history.
  *
- * - Claude Code: ~80% (hardcoded internally; reserves ~40K tokens for output generation).
+ * - Claude Code: ~84% (hardcoded internally; reserves ~30K tokens for output generation).
  *   Not user-configurable in the main conversation. See anthropics/claude-code#34126.
  * - Qwen Code: 70% by default; user-configurable via
  *   `model.chatCompression.contextPercentageThreshold` in qwen settings.json.
@@ -64,13 +64,19 @@ export const QUOTA_CRITICAL = 85;
  *   `contextCriticalThreshold` — the constant below is the platform default only.
  */
 export const AUTO_COMPACT_THRESHOLD = {
-    'claude-code': 80,
+    // Measured on CC v2.1.193 by capturing the live statusline payload right up to
+    // an auto-compaction: the last render before context dropped was 166177/200000
+    // = 83.09% (CC's own "% until auto-compact" is NOT linear, so adding it to the
+    // fill over-estimated — only the pre-drop peak is reliable). Set to 84 so the
+    // nearAutoCompact warning window [79, 84) keeps the glyph lit through the real
+    // ~83.1% trigger (83 would extinguish it a hair before compaction).
+    'claude-code': 84,
     'qwen-code': 70,
 };
 /**
  * Gap (in percentage points) before the auto-compact threshold at which the
  * `nearAutoCompact` warning glyph fires. The glyph appears in the window
- * `[AUTO_COMPACT_THRESHOLD - GAP, AUTO_COMPACT_THRESHOLD)` — i.e., 75-80%
+ * `[AUTO_COMPACT_THRESHOLD - GAP, AUTO_COMPACT_THRESHOLD)` — i.e., 79-84%
  * on Claude, 65-70% on Qwen. This is an immutable system constant (not the
  * same as the user-configurable `contextWarningThreshold`).
  */
@@ -110,6 +116,7 @@ export const DEFAULT_DISPLAY = {
     worktreeBreadcrumb: true,
     compactionCount: true,
     pr: true,
+    repo: true,
     thinking: true,
     contextWarningThreshold: DEFAULT_CONTEXT_WARNING_THRESHOLD,
     contextCriticalThreshold: DEFAULT_CONTEXT_CRITICAL_THRESHOLD,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumira",
-  "version": "1.12.2",
+  "version": "1.13.0",
   "description": "Real-time statusline HUD for Claude Code and Qwen Code. Includes session analytics CLI, API latency overhead widget, 7d quota projection, auto-compact proximity warnings, themes, and powerline. Zero deps.",
   "type": "module",
   "main": "dist/index.js",