lumira 1.9.1 → 1.12.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.9.0"
+    "version": "1.12.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.9.0",
+      "version": "1.12.0",
       "author": {
         "name": "Carlos Cativo"
       },
@@ -32,5 +32,5 @@
       ]
     }
   ],
-  "version": "1.9.0"
+  "version": "1.12.0"
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lumira",
-  "version": "1.9.0",
+  "version": "1.12.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

@@ -40,6 +40,7 @@ Interactive wizard — preset, theme, icons — previewed live before write.
 ## Table of contents
 
 - [Why lumira?](#why-lumira)
+- [How lumira compares](#how-lumira-compares)
 - [Requirements](#requirements)
 - [Features](#features)
 - [Install](#install)
@@ -63,7 +64,25 @@ Claude Code's default statusline shows the model name and current directory. Tha
 - **Active tools, agents, and todo progress** — parsed from the live transcript, updated every render.
 - **Cross-platform** — same config drives Claude Code and Qwen Code; Qwen sessions auto-collapse to single-line.
 
-Inspired by [claude-hud](https://github.com/jarrodwatts/claude-hud); takes a different stance on opt-in powerline rendering, theme contrast guarantees, and Qwen Code compatibility.
+Inspired by [GSD's](https://github.com/open-gsd/gsd-core) statusline; takes its own stance on opt-in powerline rendering, theme contrast guarantees, and Qwen Code compatibility.
+
+## How lumira compares
+
+The Claude Code statusline space has several good tools. Here's an honest head-to-head on **features** against the other true statuslines (feature claims checked against each tool's current README, 2026-06-14):
+
+| Tool | Runtime / deps | Distribution | Platforms | Config UX | Powerline + themes | Session-intel widgets |
+|---|---|---|---|---|---|---|
+| **lumira** | TS / **0 runtime deps** | npm + npx + plugin (+ Qwen skill) | **Claude Code + Qwen Code** | Wizard + JSON + CLI flags | Yes (7 styles) + 7 themes, **WCAG-AA guard** | **Quota projection, pace delta, API-latency, auto-compact glyph + counter, cache, agents, MCP, todos, tools** + `stats` CLI |
+| ccstatusline | TS / bundled | npm + npx | Claude Code | **Ink TUI** (live preview) | Yes + themes | Context, cost, usage %, block timer, compaction count, git; no quota/pace/latency |
+| claude-hud | JS / Node 18+ | Plugin marketplace | Claude Code (v1.0.80+) | Guided `/configure` + JSON | No / no themes | Context, 5h/7d usage, cost, git, tools, agents, todos, cache TTL; no quota ETA/pace/latency |
+| CCometixLine | Rust binary | npm + binary + source | Claude Code | TUI (TOML) | Yes + themes | Model, dir, git, context %, usage, cost, time, output-style |
+| claude-pace | Bash + jq | curl + plugin + npx | Claude Code 2.1.80+ | JSON block | No / no | 5h+7d %, pace delta, reset countdown, git diff; ~10ms (lightest) |
+| cship | Rust binary | binary / script / cargo | Claude Code | TOML (Starship-style) | Yes (Starship) + themes | Cost, context bar, usage limits, model, effort, agent, session, peak-time |
+| starship-claude | Shell / needs Starship | Plugin + manual | Claude Code (no tmux) | Wizard + TOML | Via Starship + palettes | Context bar, model, session |
+
+**Where lumira leads:** breadth of session-intelligence widgets — sole owner of an API-latency widget, a 7-day quota *projection ETA*, an MCP-server count, and a bundled `stats` analytics CLI, on top of the full pace / agents / todos / cache set. Plus zero runtime deps, dual-platform (Claude Code **and** Qwen Code), and WCAG-AA contrast enforced in CI on every theme. **Where it doesn't:** no Ink-style interactive widget builder — config is a wizard + JSON, not a live drag-and-drop TUI.
+
+See [`docs/competitive-comparison.md`](docs/competitive-comparison.md) for the full per-widget matrix, config-UX detail, and distribution breakdown across every tool.
 
 ## Requirements
 

package/dist/config.js

@@ -248,6 +248,8 @@ const PRESET_DEFS = {
         layout: 'auto',
         display: {
             agents: true,
+            pr: true,
+            thinking: true,
             burnRate: false,
             duration: false,
             tokenSpeed: false,
@@ -294,6 +296,8 @@ const PRESET_DEFS = {
             addedDirs: false,
             worktreeBreadcrumb: false,
             compactionCount: false,
+            pr: false,
+            thinking: false,
         },
     },
 };

package/dist/normalize.js

@@ -3,7 +3,7 @@
 // Single internal format that all renderers can consume.
 // Platform-specific quirks are handled once here.
 // Renderers check field presence, not platform identity.
-import { AUTO_COMPACT_THRESHOLD, AUTO_COMPACT_WARNING_GAP } from './types.js';
+import { AUTO_COMPACT_THRESHOLD, AUTO_COMPACT_WARNING_GAP, PR_REVIEW_STATES } from './types.js';
 export function isQwenInput(input) {
     const raw = input;
     if (!raw.metrics || typeof raw.metrics !== 'object' || !('models' in raw.metrics))
@@ -28,6 +28,8 @@ export function sanitizeTermString(s) {
 }
 /** Allowed values for the reasoning effort level field (CC ≥ 2.1.x). */
 const VALID_EFFORT_LEVELS = new Set(['low', 'medium', 'high', 'xhigh', 'max']);
+/** Allowed values for PR review state (CC ≥ 2.1.145). */
+const VALID_PR_REVIEW_STATES = new Set(PR_REVIEW_STATES);
 /**
  * Sum input token categories from `context_window.current_usage` to compute
  * a real context usage total (input + cache_read + cache_creation).
@@ -174,6 +176,30 @@ export function normalize(input) {
     const cacheHitRate = (cached != null && cacheTurnDenominator && platform === 'claude-code')
         ? Math.min(100, Math.round((cached / cacheTurnDenominator) * 100))
         : undefined;
+    // PR widget (Claude only, CC ≥ 2.1.145).
+    // number must be a positive integer — drop the whole object if invalid.
+    // url: sanitize then accept only https:// scheme (OSC 8 injection guard).
+    // reviewState: sanitize then gate against the PR_REVIEW_STATES allowlist.
+    let pr;
+    if (claude?.pr != null) {
+        const rawPr = claude.pr;
+        const n = rawPr.number;
+        if (typeof n === 'number' && Number.isInteger(n) && n > 0) {
+            let prUrl;
+            if (typeof rawPr.url === 'string') {
+                const sanitized = sanitizeTermString(rawPr.url);
+                if (sanitized.startsWith('https://'))
+                    prUrl = sanitized;
+            }
+            let prReviewState;
+            if (typeof rawPr.review_state === 'string') {
+                const sanitized = sanitizeTermString(rawPr.review_state);
+                if (VALID_PR_REVIEW_STATES.has(sanitized))
+                    prReviewState = sanitized;
+            }
+            pr = { number: n, url: prUrl, reviewState: prReviewState };
+        }
+    }
     return {
         platform,
         model: sanitizeTermString(modelName),
@@ -208,6 +234,7 @@ export function normalize(input) {
         effortLevel: claude?.effort?.level && VALID_EFFORT_LEVELS.has(claude.effort.level)
             ? sanitizeTermString(claude.effort.level)
             : undefined,
+        thinkingEnabled: claude?.thinking?.enabled === true ? true : undefined,
         worktreeName: input.worktree?.name ? sanitizeTermString(input.worktree.name) : undefined,
         addedDirsCount: (() => {
             const dirs = input.workspace?.added_dirs;
@@ -223,6 +250,7 @@ export function normalize(input) {
         })(),
         rateLimits,
         cacheHitRate,
+        pr,
         raw: input,
     };
 }

package/dist/parsers/gsd.js

@@ -83,6 +83,22 @@ export function parseStateMd(content) {
         state.phaseTotal = phaseMatch[2];
         state.phaseName = phaseMatch[3];
     }
+    // Plan progress within the current phase (gsd-core ≥ 1.4.x). Accepts both the
+    // compound "X of Y in current phase" and the bare "X of Y" forms. A "Plan: —"
+    // (not started) line has no digits and is correctly skipped.
+    const planMatch = content.match(/^Plan:\s*(\d+)\s+of\s+(\d+)/m);
+    if (planMatch) {
+        state.planNum = planMatch[1];
+        state.planTotal = planMatch[2];
+    }
+    // Resume point (gsd-core ≥ 1.4.x). "Resume file: None" means no active resume
+    // point and is treated as absent.
+    const resumeMatch = content.match(/^Resume file:\s*(.+)/m);
+    if (resumeMatch) {
+        const path = resumeMatch[1].trim();
+        if (path && path.toLowerCase() !== 'none')
+            state.resumeFile = path;
+    }
     if (!state.status) {
         // Fallback: parse body Status line when frontmatter status is missing
         const bodyStatus = content.match(/^Status:\s*(.+)/m);
@@ -145,9 +161,13 @@ function formatState(s) {
     }
     // Scene selection: activePhase → nextAction → milestone-complete → default
     const phasesStr = s.nextPhases?.length ? s.nextPhases.join('/') : null;
+    // Plan progress within the phase (gsd-core ≥ 1.4.x), appended to the phase
+    // descriptor in the active/default scenes — e.g. "auth (3/5) p2/9".
+    const planSuffix = s.planNum && s.planTotal ? ` p${s.planNum}/${s.planTotal}` : '';
     if (s.activePhase) {
         // Scene 1: activePhase (with optional status)
-        parts.push(s.status ? `Phase ${s.activePhase} ${s.status}` : `Phase ${s.activePhase}`);
+        const phase = s.status ? `Phase ${s.activePhase} ${s.status}` : `Phase ${s.activePhase}`;
+        parts.push(`${phase}${planSuffix}`);
     }
     else if (s.nextAction && phasesStr) {
         // Scene 2: nextAction + phases when idle
@@ -163,7 +183,7 @@ function formatState(s) {
             parts.push(s.status);
         if (s.phaseNum && s.phaseTotal) {
             const phase = s.phaseName ? `${s.phaseName} (${s.phaseNum}/${s.phaseTotal})` : `ph ${s.phaseNum}/${s.phaseTotal}`;
-            parts.push(phase);
+            parts.push(`${phase}${planSuffix}`);
         }
     }
     return parts.join(' · ');
@@ -234,11 +254,13 @@ export function getGsdInfo(cwd, opts = {}) {
     const legacyCacheFile = join(claudeDir, 'cache', 'gsd-update-check.json');
     const cacheData = readUpdateCache(openGsdCacheFile, sharedCacheFile, legacyCacheFile);
     let currentTask;
+    let hasResume = false;
     const stateFile = findStateMd(cwd || process.cwd());
     if (stateFile) {
         log('STATE.md found:', stateFile);
         try {
             const state = parseStateMd(readFileSync(stateFile, 'utf8'));
+            hasResume = state.resumeFile !== undefined;
             const formatted = formatState(state);
             if (formatted) {
                 currentTask = sanitizeTermString(formatted);
@@ -261,6 +283,7 @@ export function getGsdInfo(cwd, opts = {}) {
         staleHooks: cacheData.staleHooks || undefined,
         devInstall: cacheData.devInstall || undefined,
         currentTask,
+        hasResume: hasResume || undefined,
     };
 }
 //# sourceMappingURL=gsd.js.map

package/dist/render/icons.js

@@ -60,6 +60,8 @@ export const NERD_ICONS = {
     car: '🏎️', // racing car — pace-ahead indicator
     turtle: '🐢', // turtle — pace-behind indicator
     lightning: '⚡', // lightning bolt — cache hit rate
+    pr: '', // nf-cod-git_pull_request
+    thinking: '󱠤', // nf-md-brain
     battery: nerdBattery,
 };
 export const EMOJI_ICONS = {
@@ -83,6 +85,8 @@ export const EMOJI_ICONS = {
     car: '\u{1F3CE}️', // 🏎️ — racing car
     turtle: '\u{1F422}', // 🐢 — turtle
     lightning: '⚡', // ⚡ — cache hit rate
+    pr: '\u{1F500}', // 🔀 — twisted rightwards arrows (PR)
+    thinking: '\u{1F4AD}', // 💭 — thought bubble
     battery: (pct) => {
         if (!Number.isFinite(pct) || pct < 0)
             return '\u{1F50B}'; // 🔋 — no data / invalid input
@@ -114,6 +118,8 @@ export const NO_ICONS = {
     car: '',
     turtle: '',
     lightning: '',
+    pr: 'PR',
+    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.
     battery: () => '',

package/dist/render/line2.js

@@ -7,6 +7,7 @@ import { formatTokens, formatCost, formatBurnRate } from '../utils/format.js';
 import { getConfigHealth } from '../parsers/config-health.js';
 import { computePaceDelta, formatPaceDelta } from './pace.js';
 import { computeQuotaProjection, formatProjectionWarning } from './quota-projection.js';
+import { hyperlink } from './hyperlink.js';
 const SEVEN_DAY_WINDOW_SEC = 7 * 24 * 3600;
 const SEVEN_DAY_MIN_ELAPSED_SEC = 3600; // 1h floor — see quota-projection.ts
 export function formatCountdown(resetsAt) {
@@ -115,6 +116,18 @@ export function renderLine2(ctx, c) {
             leftParts.push(c.dim(`MCP ${total}`));
         }
     }
+    // PR widget (CC ≥ 2.1.145)
+    if (display.pr && input.pr) {
+        const { number, url, reviewState } = input.pr;
+        const stateStr = reviewState ?? '';
+        const colorFn = reviewState === 'approved' ? c.green :
+            reviewState === 'pending' ? c.yellow :
+                reviewState === 'changes_requested' ? c.orange :
+                    c.dim; // draft or unknown
+        const text = `${icons.pr} #${number}${stateStr ? ` ${stateStr}` : ''}`;
+        const colored = colorFn(text);
+        leftParts.push(url ? hyperlink(url, colored) : colored);
+    }
     // Qwen metrics (shared helper)
     leftParts.push(...formatQwenMetrics(input, c, icons));
     // 7d quota projection — computed once, surfaced two ways depending on whether
@@ -233,6 +246,9 @@ export function renderLine2(ctx, c) {
     if (display.effort && effort && effort !== 'medium') {
         rightParts.push(c.dim(`^${effort}`));
     }
+    if (display.thinking && input.thinkingEnabled) {
+        rightParts.push(c.dim(icons.thinking));
+    }
     // Config health hints (opt-in, default off). Sit on the right side as
     // auxiliary signals next to vim/effort, and are dropped silently when the
     // projected line width would overflow `cols` — they are advisory, never

package/dist/render/line4.js

@@ -13,6 +13,12 @@ export function renderLine4(ctx, c) {
         if (gsd.currentTask) {
             parts.push(c.bold(`${icons.hammer} ${truncField(gsd.currentTask, 60)}`));
         }
+        // Resume-point indicator (gsd-core ≥ 1.4.x). A ↩ glyph signals STATE.md has
+        // an active `.continue-here`/spec resume file — a cue that work can be picked
+        // up where it left off. Cyan: informational, distinct from update/stale warns.
+        if (gsd.hasResume) {
+            parts.push(c.cyan('↩'));
+        }
         if (gsd.updateAvailable) {
             parts.push(c.yellow('⬆ /gsd:update'));
         }

package/dist/render/powerline-line2.js

@@ -21,6 +21,20 @@ function getCacheHitBg(rate, palette) {
         case 'critical': return palette.branchDirtyBg;
     }
 }
+// Maps PR review state to a powerline bg slot (urgency via background, not text color).
+// approved  → dirBg   (neutral — PR is ready, low urgency)
+// pending   → taskBg  (warm — waiting on reviewers)
+// changes_requested → branchDirtyBg (hot — action needed from author)
+// draft     → dirBg   (neutral — not ready for review)
+function getPrReviewBg(reviewState, palette) {
+    switch (reviewState) {
+        case 'changes_requested': return palette.branchDirtyBg;
+        case 'pending': return palette.taskBg;
+        case 'approved':
+        case 'draft':
+        default: return palette.dirBg;
+    }
+}
 // Maps the API latency tier (SSOT in colors.ts) to a powerline bg slot.
 // healthy/notable → dirBg (neutral; api is fast or only slightly slow)
 // warn            → taskBg (warm; api is dominating session time)
@@ -210,6 +224,14 @@ function buildSegments(ctx, palette, c) {
         const mcpText = errors > 0 ? `MCP ${total - errors}/${total}` : `MCP ${total}`;
         segments.push({ text: mcpText, bg: palette.taskBg, fg: palette.fg, priority: 50 });
     }
+    // PR widget (CC ≥ 2.1.145)
+    if (display.pr && input.pr) {
+        const { number, reviewState } = input.pr;
+        const stateStr = reviewState ?? '';
+        const text = `${icons.pr} #${number}${stateStr ? ` ${stateStr}` : ''}`;
+        const bg = getPrReviewBg(reviewState, palette);
+        segments.push({ text, bg, fg: palette.fg, priority: 55 });
+    }
     // Qwen metrics
     const qwenParts = formatQwenMetrics(input, c, icons);
     for (const part of qwenParts) {
@@ -224,6 +246,11 @@ function buildSegments(ctx, palette, c) {
     if (display.effort && effort && effort !== 'medium') {
         segments.push({ text: `^${effort}`, bg: palette.versionBg, fg: palette.fg, priority: 30 });
     }
+    // Extended thinking indicator — priority 28 (one below effort/vim at 30) so it
+    // evicts before them on narrow terminals; thinking is informational, not urgent.
+    if (display.thinking && input.thinkingEnabled) {
+        segments.push({ text: icons.thinking, bg: palette.dirBg, fg: palette.fg, priority: 28 });
+    }
     // Config health hints (opt-in, lowest priority — evicted first on narrow terminals)
     if (display.health && input.cwd) {
         const colorMode = ctx.config.colors.mode === 'auto' ? detectColorMode() : ctx.config.colors.mode;

package/dist/types.js

@@ -38,6 +38,7 @@ export const CUSTOM_COMMAND_COLORS = ['dim', 'green', 'yellow', 'orange', 'red',
  * `POWERLINE_STYLES` in `src/render/powerline.ts` — that map's keys
  * MUST match this list.
  */
+export const PR_REVIEW_STATES = ['approved', 'pending', 'changes_requested', 'draft'];
 export const POWERLINE_STYLE_NAMES = [
     'arrow', 'flame', 'slant', 'round', 'diamond', 'compatible', 'plain', 'auto',
 ];
@@ -108,6 +109,8 @@ export const DEFAULT_DISPLAY = {
     addedDirs: true,
     worktreeBreadcrumb: true,
     compactionCount: true,
+    pr: true,
+    thinking: true,
     contextWarningThreshold: DEFAULT_CONTEXT_WARNING_THRESHOLD,
     contextCriticalThreshold: DEFAULT_CONTEXT_CRITICAL_THRESHOLD,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumira",
-  "version": "1.9.1",
+  "version": "1.12.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",