lumira 1.6.1 → 1.8.0

package/README.md

@@ -26,7 +26,7 @@ Interactive wizard — preset, theme, icons — previewed live before write.
 
 > 3,400+ monthly downloads, zero marketing. Try it for one session — `npx lumira install`.
 
-> **What's new in v1.5:** the [`lumira stats` CLI](#stats-cli) prints post-session analytics (cost, tokens, cache hit, tool frequency, burn rate). Combined with the `API N%` latency widget (v1.4.0), 7-day quota projection warning (v1.3.0), and auto-compact proximity glyph ⚠ (v1.4.1), recent releases add several diagnostic signals to the session.
+> **What's new in v1.8.0:** compaction counter (`⊙ N` on line 2) — tracks how many times the session has been compacted, pairing with the auto-compact proximity glyph ⚠. Togglable via `display.compactionCount`, on by default in `full`/`balanced`. Combined with the added-dirs badge and worktree breadcrumb (v1.7.0), [`lumira stats` CLI](#stats-cli) (v1.5), `API N%` latency widget (v1.4.0), 7-day quota projection warning (v1.3.0), and auto-compact proximity glyph ⚠ (v1.4.1), recent releases add several diagnostic signals to the session.
 
 ## Table of contents
 
@@ -87,7 +87,7 @@ Inspired by [claude-hud](https://github.com/jarrodwatts/claude-hud); takes a dif
 - **Config health widget** — surfaces silent fallbacks (theme/powerline degrading in named-ANSI, missing GSD STATE.md). Opt-in.
 - **Memory usage** — process RSS percentage.
 - **MCP server detection** — count of attached MCP servers per session.
-- **Vim-mode hint, thinking effort, worktree, output style, session name** — all togglable per-field via `display.*`.
+- **Vim-mode hint, thinking effort, worktree, output style, session name, added-dirs badge, worktree origin-branch breadcrumb** — all togglable per-field via `display.*`.
 - **3-tier color system** — named ANSI / 256-color / truecolor, auto-detected.
 - **Config-driven** — every feature toggleable via JSON config + CLI flags.
 
@@ -269,6 +269,7 @@ Create `~/.config/lumira/config.json`:
     "burnRate": true,
     "duration": true,
     "tokenSpeed": true,
+    "apiLatency": true,
     "rateLimits": true,
     "paceDelta": true,
     "quotaProjection": true,
@@ -278,6 +279,8 @@ Create `~/.config/lumira/config.json`:
     "vim": true,
     "effort": true,
     "worktree": true,
+    "addedDirs": true,
+    "worktreeBreadcrumb": true,
     "agent": true,
     "sessionName": true,
     "style": true,
@@ -285,6 +288,7 @@ Create `~/.config/lumira/config.json`:
     "linesChanged": true,
     "memory": true,
     "agents": true,
+    "compactionCount": true,
     "health": false,
     "contextWarningThreshold": 70,
     "contextCriticalThreshold": 85

package/dist/config.js

@@ -291,6 +291,9 @@ const PRESET_DEFS = {
             // surface (see burnRate/rateLimits/paceDelta etc. above). Default
             // remains true; users on full/balanced see the widget out of the box.
             apiLatency: false,
+            addedDirs: false,
+            worktreeBreadcrumb: false,
+            compactionCount: false,
         },
     },
 };

package/dist/normalize.js

@@ -191,6 +191,18 @@ export function normalize(input) {
             ? sanitizeTermString(claude.effort.level)
             : undefined,
         worktreeName: input.worktree?.name ? sanitizeTermString(input.worktree.name) : undefined,
+        addedDirsCount: (() => {
+            const dirs = input.workspace?.added_dirs;
+            if (!Array.isArray(dirs) || dirs.length === 0)
+                return undefined;
+            return dirs.length;
+        })(),
+        worktreeOriginalBranch: (() => {
+            const orig = input.worktree?.original_branch;
+            if (!orig || typeof orig !== 'string')
+                return undefined;
+            return sanitizeTermString(orig);
+        })(),
         rateLimits,
         cacheHitRate,
         raw: input,

package/dist/parsers/transcript.js

@@ -124,7 +124,7 @@ export function extractToolTarget(toolName, input) {
 // same canonicalisation and allow-list semantics. See `path.ts` for caveats
 // about the string-level (non-symlink-following) nature of the check.
 export async function parseTranscript(transcriptPath) {
-    const result = { ...EMPTY_TRANSCRIPT, tools: [], agents: [], todos: [] };
+    const result = { ...EMPTY_TRANSCRIPT, tools: [], agents: [], todos: [], compactionCount: 0 };
     if (!transcriptPath || !existsSync(transcriptPath)) {
         if (log.enabled)
             log('skip — transcript path missing or nonexistent:', transcriptPath || '(empty)');
@@ -185,6 +185,8 @@ export async function parseTranscript(transcriptPath) {
                 const entry = JSON.parse(line);
                 if (!result.sessionStart && entry.timestamp)
                     result.sessionStart = new Date(entry.timestamp);
+                if (entry.type === 'system' && entry.subtype === 'compact_boundary')
+                    result.compactionCount++;
                 const effortMatch = Array.isArray(entry.message?.content)
                     ? entry.message.content
                         .filter((b) => b.type === 'text')

package/dist/render/burn-math.js

@@ -0,0 +1,10 @@
+export function computeBurnExtrapolation(usedPct, elapsedSec, remainingSec) {
+    const windowSec = elapsedSec + remainingSec;
+    const elapsedPct = (elapsedSec / windowSec) * 100;
+    const delta = usedPct - elapsedPct;
+    const burnRateSec = usedPct / elapsedSec;
+    const timeToExhaustSec = (100 - usedPct) / burnRateSec;
+    const willExhaustBefore = timeToExhaustSec < remainingSec;
+    return { burnRateSec, elapsedSec, remainingSec, delta, timeToExhaustSec, willExhaustBefore };
+}
+//# sourceMappingURL=burn-math.js.map

package/dist/render/line1.js

@@ -40,6 +40,18 @@ export function renderLine1(ctx, c) {
             left.push(hyperlink(pathToFileURL(cwd).href, 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`;
+        left.push(input.addedDirsCount >= 5 ? c.orange(badge) : c.dim(badge));
+    }
+    // Worktree origin-branch breadcrumb — only when original_branch is present,
+    // there IS a current branch to contrast against (anchor), and they differ.
+    const branchForBreadcrumb = input.gitBranch || git.branch;
+    if (display.worktreeBreadcrumb && input.worktreeOriginalBranch && branchForBreadcrumb && input.worktreeOriginalBranch !== branchForBreadcrumb) {
+        const truncated = truncField(input.worktreeOriginalBranch, 15);
+        left.push(c.gray(`↳ ${truncated}`));
+    }
     // Duration (Claude only)
     if (display.duration && input.durationMs != null) {
         right.push(c.dim(`${icons.clock} ${formatDuration(input.durationMs)}`));

package/dist/render/line2.js

@@ -25,7 +25,7 @@ export function formatCountdown(resetsAt) {
     return `${s}s`;
 }
 export function renderLine2(ctx, c) {
-    const { input, tokenSpeed, transcript: { thinkingEffort }, config: { display }, cols, memory, mcp, icons } = ctx;
+    const { input, tokenSpeed, transcript: { thinkingEffort, compactionCount }, config: { display }, cols, memory, mcp, icons } = ctx;
     const leftParts = [];
     const rightParts = [];
     // Track context slots pushed so critical rate-limit segments anchor after
@@ -56,6 +56,11 @@ export function renderLine2(ctx, c) {
             contextSlotCount++;
         }
     }
+    // Compaction counter — how many times this session has been compacted.
+    // Self-gating: renders nothing at count 0. Paired with the context bar.
+    if (display.compactionCount && compactionCount > 0) {
+        leftParts.push(c.dim(`⊙ ${compactionCount}`));
+    }
     // Tokens
     if (display.tokens) {
         const inTokens = input.tokens.input;

package/dist/render/pace.js

@@ -1,4 +1,5 @@
 import { debug } from '../utils/debug.js';
+import { computeBurnExtrapolation } from './burn-math.js';
 const log = debug('pace');
 export function computePaceDelta(usedPercentage, resetsAt, nowSec) {
     const now = nowSec ?? Date.now() / 1000;
@@ -15,15 +16,12 @@ export function computePaceDelta(usedPercentage, resetsAt, nowSec) {
             log({ reason: 'insufficient data (<5min)', elapsedSec, remainingSec });
         return null;
     }
-    const elapsedPct = (elapsedSec / totalWindowSec) * 100;
-    const delta = usedPercentage - elapsedPct;
-    let timeToExhaustion = null;
-    if (delta > 0 && usedPercentage > 0) {
-        // burn rate = usedPercentage / elapsedSec (pct per second)
-        // time to exhaust remaining (100 - usedPercentage) pct at that rate
-        timeToExhaustion = (100 - usedPercentage) / (usedPercentage / elapsedSec) / 60;
-    }
+    const burn = computeBurnExtrapolation(usedPercentage, elapsedSec, remainingSec);
+    const timeToExhaustion = burn.delta > 0 && usedPercentage > 0
+        ? burn.timeToExhaustSec / 60
+        : null;
     if (log.enabled) {
+        const elapsedPct = (elapsedSec / totalWindowSec) * 100;
         log({
             usedPercentage,
             resetsAt,
@@ -33,11 +31,11 @@ export function computePaceDelta(usedPercentage, resetsAt, nowSec) {
             remainingSec: Math.round(remainingSec),
             remainingMin: Math.round(remainingSec / 60),
             elapsedPct: Math.round(elapsedPct * 10) / 10,
-            delta: Math.round(delta * 10) / 10,
+            delta: Math.round(burn.delta * 10) / 10,
             timeToExhaustionMin: timeToExhaustion != null ? Math.round(timeToExhaustion) : null,
         });
     }
-    return { delta, timeToExhaustion };
+    return { delta: burn.delta, timeToExhaustion };
 }
 export function formatPaceDelta(pace) {
     const rounded = Math.round(pace.delta);

package/dist/render/powerline-line1.js

@@ -11,19 +11,21 @@ import { derivePowerlinePalette, DEFAULT_POWERLINE_PALETTE, } from '../themes.js
 /**
  * Build the line1 segment list for the powerline renderer. Segment priorities
  * control which get dropped first when the terminal is narrow (lower = drops first):
- *   model:        100  (always kept)
- *   branch:        80
- *   dir:           60
- *   task:          40
- *   duration:      35
- *   memory:        30
- *   tokenSpeed:    25
- *   linesChanged:  24
- *   worktree:      23
- *   agent:         22
- *   sessionName:   21
- *   version:       20
- *   style:         18  (dropped first)
+ *   model:             100  (always kept)
+ *   branch:             80
+ *   dir:                60
+ *   addedDirs:          59  (renders after dir; data-gated; evicts before dir under pressure)
+ *   task:               40
+ *   duration:           35
+ *   memory:             30
+ *   tokenSpeed:         25
+ *   linesChanged:       24
+ *   worktree:           23
+ *   worktreeBreadcrumb: 22.5 (between worktree@23 and agent@22; data-gated)
+ *   agent:              22
+ *   sessionName:        21
+ *   version:            20
+ *   style:              18  (dropped first)
  */
 function buildSegments(ctx, palette, c) {
     const { input, git, transcript, config: { display }, icons, memory, tokenSpeed } = ctx;
@@ -77,6 +79,15 @@ function buildSegments(ctx, palette, c) {
             priority: 60,
         });
     }
+    if (display.addedDirs && input.addedDirsCount != null && input.addedDirsCount > 0) {
+        const badge = `+${input.addedDirsCount} dirs`;
+        const bg = input.addedDirsCount >= 5 ? palette.taskBg : palette.versionBg;
+        // Priority 59 — one BELOW directory@60. The badge annotates the directory,
+        // so it must evict before the directory under narrow-terminal pressure
+        // (applyPriorityEviction drops lowest-priority first). Insertion order is
+        // unchanged, so it still renders right after the directory.
+        segments.push({ text: badge, bg, fg: palette.fg, priority: 59 });
+    }
     const activeTask = getActiveTodo(transcript);
     if (activeTask) {
         segments.push({
@@ -136,6 +147,19 @@ function buildSegments(ctx, palette, c) {
             priority: 23,
         });
     }
+    if (display.worktreeBreadcrumb && input.worktreeOriginalBranch) {
+        const currentBranch = input.gitBranch || git.branch;
+        // Only render when there is a current branch to contrast against — the
+        // breadcrumb is meaningless without an anchor (no branch shown / branch off).
+        if (currentBranch && input.worktreeOriginalBranch !== currentBranch) {
+            segments.push({
+                text: `↳ ${truncField(input.worktreeOriginalBranch, 15)}`,
+                bg: palette.versionBg,
+                fg: palette.fg,
+                priority: 22.5,
+            });
+        }
+    }
     // Mirrors classic line1: prefer the explicit input.agentName (subagent
     // session render), else show the cubes badge when exactly one *named*
     // subagent is running on the parent. Anonymous agents stay collapsed

package/dist/render/powerline-line2.js

@@ -44,7 +44,7 @@ function getApiLatencyBg(pct, palette) {
 // urgency channels the user actually needs at a glance. Decision rationale
 // recorded against PR #47.
 function buildSegments(ctx, palette, c) {
-    const { input, config: { display }, icons, mcp, transcript: { thinkingEffort } } = ctx;
+    const { input, config: { display }, icons, mcp, transcript: { thinkingEffort, compactionCount } } = ctx;
     const segments = [];
     // Context bar — always highest priority. plain=true so the bar cells inherit
     // the powerline segment bg; only %/icon/hint emit color escapes.
@@ -72,6 +72,11 @@ function buildSegments(ctx, palette, c) {
             segments.push({ text: `${formatTokens(used)}/${formatTokens(capacity)}`, bg: palette.dirBg, fg: palette.fg, priority: 90 });
         }
     }
+    // Compaction counter — self-gating at 0; priority 88 keeps it adjacent to
+    // the context family (contextBar=100, contextTokens=90).
+    if (display.compactionCount && compactionCount > 0) {
+        segments.push({ text: `⊙ ${compactionCount}`, bg: palette.dirBg, fg: palette.fg, priority: 88 });
+    }
     // 7d projection — computed once, surfaced inside the 7d segment when the
     // badge is visible (≥50%), or as a standalone segment when it isn't. Mirrors
     // classic line2: badge filter hides noise, projection surfaces signal.

package/dist/render/quota-projection.js

@@ -1,4 +1,5 @@
 import { debug } from '../utils/debug.js';
+import { computeBurnExtrapolation } from './burn-math.js';
 const log = debug('quota-projection');
 /**
  * Extrapolates current burn rate to when the quota would hit 100%.
@@ -27,21 +28,18 @@ export function computeQuotaProjection(usedPct, resetsAt, windowSec, nowSec, min
             log({ reason: 'insufficient elapsed', elapsedSec, minElapsedSec });
         return null;
     }
-    // burnRate is in pct-per-second
-    const burnRate = usedPct / elapsedSec;
-    const timeToExhaustSec = (100 - usedPct) / burnRate;
-    const willExhaustBefore = timeToExhaustSec < remainingSec;
+    const burn = computeBurnExtrapolation(usedPct, elapsedSec, remainingSec);
     if (log.enabled) {
         log({
             usedPct,
             elapsedSec: Math.round(elapsedSec),
             remainingSec: Math.round(remainingSec),
-            burnRate,
-            timeToExhaustSec: Math.round(timeToExhaustSec),
-            willExhaustBefore,
+            burnRate: burn.burnRateSec,
+            timeToExhaustSec: Math.round(burn.timeToExhaustSec),
+            willExhaustBefore: burn.willExhaustBefore,
         });
     }
-    return { timeToExhaustSec, willExhaustBefore };
+    return { timeToExhaustSec: burn.timeToExhaustSec, willExhaustBefore: burn.willExhaustBefore };
 }
 /**
  * Renders a projection as a short warning string (e.g. "⚠ Mon", "🔥 ~12h").

package/dist/types.js

@@ -11,6 +11,7 @@ export const EMPTY_TRANSCRIPT = Object.freeze({
     todos: Object.freeze([]),
     thinkingEffort: '',
     sessionStart: null,
+    compactionCount: 0,
 });
 /** Hard cap on per-command wall time (ms). */
 export const CUSTOM_COMMAND_MAX_TIMEOUT_MS = 2000;
@@ -104,6 +105,9 @@ export const DEFAULT_DISPLAY = {
     agents: true,
     health: false,
     apiLatency: true,
+    addedDirs: true,
+    worktreeBreadcrumb: true,
+    compactionCount: true,
     contextWarningThreshold: DEFAULT_CONTEXT_WARNING_THRESHOLD,
     contextCriticalThreshold: DEFAULT_CONTEXT_CRITICAL_THRESHOLD,
 };

package/package.json

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

package/skills/lumira/SKILL.md

@@ -44,7 +44,7 @@ Your job: read the user's current config, translate their natural-language reque
 
 Valid keys (anything else must be rejected):
 
-`model`, `branch`, `gitChanges`, `directory`, `contextBar`, `contextTokens`, `tokens`, `cost`, `burnRate`, `duration`, `tokenSpeed`, `rateLimits`, `paceDelta`, `quotaProjection`, `tools`, `todos`, `vim`, `effort`, `worktree`, `agent`, `agents`, `sessionName`, `style`, `version`, `linesChanged`, `memory`, `cacheMetrics`, `mcp`, `health`
+`model`, `branch`, `gitChanges`, `directory`, `contextBar`, `contextTokens`, `tokens`, `cost`, `burnRate`, `duration`, `tokenSpeed`, `rateLimits`, `paceDelta`, `quotaProjection`, `tools`, `todos`, `vim`, `effort`, `worktree`, `agent`, `agents`, `sessionName`, `style`, `version`, `linesChanged`, `memory`, `cacheMetrics`, `mcp`, `health`, `apiLatency`, `addedDirs`, `worktreeBreadcrumb`
 
 ### Display thresholds (`display.*`, numeric)