claudecode-omc 4.8.4 → 4.9.4

package/dist/hud/background-cleanup.js

@@ -12,8 +12,8 @@ const STALE_TASK_THRESHOLD_MS = 30 * 60 * 1000; // 30 minutes default
  * @param thresholdMs Age threshold in milliseconds (default: 30 minutes)
  * @returns Number of tasks removed
  */
-export async function cleanupStaleBackgroundTasks(thresholdMs = STALE_TASK_THRESHOLD_MS) {
-    const state = readHudState();
+export async function cleanupStaleBackgroundTasks(thresholdMs = STALE_TASK_THRESHOLD_MS, directory) {
+    const state = readHudState(directory);
     if (!state || !state.backgroundTasks) {
         return 0;
     }
@@ -34,7 +34,7 @@ export async function cleanupStaleBackgroundTasks(thresholdMs = STALE_TASK_THRES
     }
     const removedCount = originalCount - state.backgroundTasks.length;
     if (removedCount > 0) {
-        writeHudState(state);
+        writeHudState(state, directory);
     }
     return removedCount;
 }
@@ -44,8 +44,8 @@ export async function cleanupStaleBackgroundTasks(thresholdMs = STALE_TASK_THRES
  *
  * @returns Array of orphaned tasks
  */
-export async function detectOrphanedTasks() {
-    const state = readHudState();
+export async function detectOrphanedTasks(directory) {
+    const state = readHudState(directory);
     if (!state || !state.backgroundTasks) {
         return [];
     }
@@ -70,12 +70,12 @@ export async function detectOrphanedTasks() {
  *
  * @returns Number of tasks marked
  */
-export async function markOrphanedTasksAsStale() {
-    const state = readHudState();
+export async function markOrphanedTasksAsStale(directory) {
+    const state = readHudState(directory);
     if (!state || !state.backgroundTasks) {
         return 0;
     }
-    const orphaned = await detectOrphanedTasks();
+    const orphaned = await detectOrphanedTasks(directory);
     let marked = 0;
     for (const orphanedTask of orphaned) {
         const task = state.backgroundTasks.find(t => t.id === orphanedTask.id);
@@ -85,7 +85,7 @@ export async function markOrphanedTasksAsStale() {
         }
     }
     if (marked > 0) {
-        writeHudState(state);
+        writeHudState(state, directory);
     }
     return marked;
 }

package/dist/hud/background-cleanup.js.map

@@ -1 +1 @@
-{"version":3,"file":"background-cleanup.js","sourceRoot":"","sources":["../../src/hud/background-cleanup.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"background-cleanup.js","sourceRoot":"","sources":["../../src/hud/background-cleanup.ts"],"names":[],"mappings":"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"}

package/dist/hud/background-tasks.d.ts

@@ -14,6 +14,13 @@ export declare function addBackgroundTask(id: string, description: string, agent
  * Called when a Task tool completes.
  */
 export declare function completeBackgroundTask(id: string, directory?: string, failed?: boolean): boolean;
+/**
+ * Remap a running background task from its launch-time hook id to the
+ * async task id reported after launch.
+ */
+export declare function remapBackgroundTaskId(currentId: string, nextId: string, directory?: string): boolean;
+export declare function completeMostRecentMatchingBackgroundTask(description: string, directory?: string, failed?: boolean, agentType?: string): boolean;
+export declare function remapMostRecentMatchingBackgroundTaskId(description: string, nextId: string, directory?: string, agentType?: string): boolean;
 /**
  * Get count of running background tasks.
  */

package/dist/hud/background-tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"background-tasks.d.ts","sourceRoot":"","sources":["../../src/hud/background-tasks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAuBT;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,MAAM,EACV,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,GAAE,OAAe,GACtB,OAAO,CAoBT;AA6CD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAOhE"}
+{"version":3,"file":"background-tasks.d.ts","sourceRoot":"","sources":["../../src/hud/background-tasks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAuBT;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,MAAM,EACV,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,GAAE,OAAe,GACtB,OAAO,CAoBT;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CA4BT;AAgBD,wBAAgB,wCAAwC,CACtD,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,GAAE,OAAe,EACvB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAoBT;AAED,wBAAgB,uCAAuC,CACrD,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAwBT;AA6CD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAahE"}

package/dist/hud/background-tasks.js

@@ -55,6 +55,83 @@ export function completeBackgroundTask(id, directory, failed = false) {
         return false;
     }
 }
+/**
+ * Remap a running background task from its launch-time hook id to the
+ * async task id reported after launch.
+ */
+export function remapBackgroundTaskId(currentId, nextId, directory) {
+    try {
+        if (currentId === nextId) {
+            return true;
+        }
+        const state = readHudState(directory);
+        if (!state) {
+            return false;
+        }
+        const task = state.backgroundTasks.find((t) => t.id === currentId);
+        if (!task) {
+            return false;
+        }
+        const existingTask = state.backgroundTasks.find((t) => t.id === nextId);
+        if (existingTask && existingTask !== task) {
+            return false;
+        }
+        task.id = nextId;
+        state.timestamp = new Date().toISOString();
+        return writeHudState(state, directory);
+    }
+    catch {
+        return false;
+    }
+}
+function findMostRecentMatchingRunningTask(state, description, agentType) {
+    return [...state.backgroundTasks]
+        .filter((task) => task.status === 'running'
+        && task.description === description
+        && (agentType === undefined || task.agentType === agentType))
+        .sort((a, b) => new Date(b.startedAt).getTime() - new Date(a.startedAt).getTime())[0];
+}
+export function completeMostRecentMatchingBackgroundTask(description, directory, failed = false, agentType) {
+    try {
+        const state = readHudState(directory);
+        if (!state) {
+            return false;
+        }
+        const task = findMostRecentMatchingRunningTask(state, description, agentType);
+        if (!task) {
+            return false;
+        }
+        task.status = failed ? 'failed' : 'completed';
+        task.completedAt = new Date().toISOString();
+        state.timestamp = new Date().toISOString();
+        return writeHudState(state, directory);
+    }
+    catch {
+        return false;
+    }
+}
+export function remapMostRecentMatchingBackgroundTaskId(description, nextId, directory, agentType) {
+    try {
+        const state = readHudState(directory);
+        if (!state) {
+            return false;
+        }
+        const task = findMostRecentMatchingRunningTask(state, description, agentType);
+        if (!task) {
+            return false;
+        }
+        const existingTask = state.backgroundTasks.find((t) => t.id === nextId);
+        if (existingTask && existingTask !== task) {
+            return false;
+        }
+        task.id = nextId;
+        state.timestamp = new Date().toISOString();
+        return writeHudState(state, directory);
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Clean up old and expired tasks from state.
  */
@@ -106,7 +183,13 @@ export function getRunningTaskCount(directory) {
  */
 export function clearBackgroundTasks(directory) {
     try {
+        // Read existing state to preserve session fields (sessionStartTimestamp, sessionId)
+        const existing = readHudState(directory);
         const state = createEmptyHudState();
+        if (existing) {
+            state.sessionStartTimestamp = existing.sessionStartTimestamp;
+            state.sessionId = existing.sessionId;
+        }
         return writeHudState(state, directory);
     }
     catch {

package/dist/hud/background-tasks.js.map

@@ -1 +1 @@
-{"version":3,"file":"background-tasks.js","sourceRoot":"","sources":["../../src/hud/background-tasks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"background-tasks.js","sourceRoot":"","sources":["../../src/hud/background-tasks.ts"],"names":[],"mappings":"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"}

package/dist/hud/elements/context.d.ts

@@ -4,16 +4,26 @@
  * Renders context window usage display.
  */
 import type { HudThresholds } from '../types.js';
+/**
+ * Reset cached context display state.
+ * Useful for test isolation and fresh render sessions.
+ */
+export declare function resetContextDisplayState(): void;
+/**
+ * Apply display-layer hysteresis so small refresh-to-refresh ctx fluctuations
+ * do not visibly jitter in the HUD.
+ */
+export declare function getStableContextDisplayPercent(percent: number, thresholds: HudThresholds, displayScope?: string | null): number;
 /**
  * Render context window percentage.
  *
  * Format: ctx:67%
  */
-export declare function renderContext(percent: number, thresholds: HudThresholds): string | null;
+export declare function renderContext(percent: number, thresholds: HudThresholds, displayScope?: string | null): string | null;
 /**
  * Render context window with visual bar.
  *
  * Format: ctx:[████░░░░░░]67%
  */
-export declare function renderContextWithBar(percent: number, thresholds: HudThresholds, barWidth?: number): string | null;
+export declare function renderContextWithBar(percent: number, thresholds: HudThresholds, barWidth?: number, displayScope?: string | null): string | null;
 //# sourceMappingURL=context.d.ts.map

package/dist/hud/elements/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/hud/elements/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQjD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,GACxB,MAAM,GAAG,IAAI,CAkBf;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,EACzB,QAAQ,GAAE,MAAW,GACpB,MAAM,GAAG,IAAI,CAsBf"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/hud/elements/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAuDjD;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAK/C;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,EACzB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAC3B,MAAM,CAuCR;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,EACzB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAC3B,MAAM,GAAG,IAAI,CAKf;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,EACzB,QAAQ,GAAE,MAAW,EACrB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAC3B,MAAM,GAAG,IAAI,CAQf"}

package/dist/hud/elements/context.js

@@ -8,29 +8,95 @@ const GREEN = '\x1b[32m';
 const YELLOW = '\x1b[33m';
 const RED = '\x1b[31m';
 const DIM = '\x1b[2m';
+const CONTEXT_DISPLAY_HYSTERESIS = 2;
+const CONTEXT_DISPLAY_STATE_TTL_MS = 5_000;
+let lastDisplayedPercent = null;
+let lastDisplayedSeverity = null;
+let lastDisplayScope = null;
+let lastDisplayUpdatedAt = 0;
+function clampContextPercent(percent) {
+    return Math.min(100, Math.max(0, Math.round(percent)));
+}
+function getContextSeverity(safePercent, thresholds) {
+    if (safePercent >= thresholds.contextCritical) {
+        return 'critical';
+    }
+    if (safePercent >= thresholds.contextCompactSuggestion) {
+        return 'compact';
+    }
+    if (safePercent >= thresholds.contextWarning) {
+        return 'warning';
+    }
+    return 'normal';
+}
+function getContextDisplayStyle(safePercent, thresholds) {
+    const severity = getContextSeverity(safePercent, thresholds);
+    switch (severity) {
+        case 'critical':
+            return { color: RED, suffix: ' CRITICAL' };
+        case 'compact':
+            return { color: YELLOW, suffix: ' COMPRESS?' };
+        case 'warning':
+            return { color: YELLOW, suffix: '' };
+        default:
+            return { color: GREEN, suffix: '' };
+    }
+}
 /**
- * Render context window percentage.
- *
- * Format: ctx:67%
+ * Reset cached context display state.
+ * Useful for test isolation and fresh render sessions.
  */
-export function renderContext(percent, thresholds) {
-    const safePercent = Math.min(100, Math.max(0, Math.round(percent)));
-    let color;
-    let suffix = '';
-    if (safePercent >= thresholds.contextCritical) {
-        color = RED;
-        suffix = ' CRITICAL';
+export function resetContextDisplayState() {
+    lastDisplayedPercent = null;
+    lastDisplayedSeverity = null;
+    lastDisplayScope = null;
+    lastDisplayUpdatedAt = 0;
+}
+/**
+ * Apply display-layer hysteresis so small refresh-to-refresh ctx fluctuations
+ * do not visibly jitter in the HUD.
+ */
+export function getStableContextDisplayPercent(percent, thresholds, displayScope) {
+    const safePercent = clampContextPercent(percent);
+    const severity = getContextSeverity(safePercent, thresholds);
+    const nextScope = displayScope ?? null;
+    const now = Date.now();
+    if (nextScope !== lastDisplayScope) {
+        lastDisplayedPercent = null;
+        lastDisplayedSeverity = null;
+        lastDisplayScope = nextScope;
     }
-    else if (safePercent >= thresholds.contextCompactSuggestion) {
-        color = YELLOW;
-        suffix = ' COMPRESS?';
+    if (lastDisplayedPercent === null
+        || lastDisplayedSeverity === null
+        || now - lastDisplayUpdatedAt > CONTEXT_DISPLAY_STATE_TTL_MS) {
+        lastDisplayedPercent = safePercent;
+        lastDisplayedSeverity = severity;
+        lastDisplayUpdatedAt = now;
+        return safePercent;
     }
-    else if (safePercent >= thresholds.contextWarning) {
-        color = YELLOW;
+    if (severity !== lastDisplayedSeverity) {
+        lastDisplayedPercent = safePercent;
+        lastDisplayedSeverity = severity;
+        lastDisplayUpdatedAt = now;
+        return safePercent;
     }
-    else {
-        color = GREEN;
+    if (Math.abs(safePercent - lastDisplayedPercent) <= CONTEXT_DISPLAY_HYSTERESIS) {
+        lastDisplayUpdatedAt = now;
+        return lastDisplayedPercent;
     }
+    lastDisplayedPercent = safePercent;
+    lastDisplayedSeverity = severity;
+    lastDisplayUpdatedAt = now;
+    return safePercent;
+}
+/**
+ * Render context window percentage.
+ *
+ * Format: ctx:67%
+ */
+export function renderContext(percent, thresholds, displayScope) {
+    const safePercent = getStableContextDisplayPercent(percent, thresholds, displayScope);
+    const { color, suffix } = getContextDisplayStyle(safePercent, thresholds);
     return `ctx:${color}${safePercent}%${suffix}${RESET}`;
 }
 /**
@@ -38,26 +104,11 @@ export function renderContext(percent, thresholds) {
  *
  * Format: ctx:[████░░░░░░]67%
  */
-export function renderContextWithBar(percent, thresholds, barWidth = 10) {
-    const safePercent = Math.min(100, Math.max(0, Math.round(percent)));
+export function renderContextWithBar(percent, thresholds, barWidth = 10, displayScope) {
+    const safePercent = getStableContextDisplayPercent(percent, thresholds, displayScope);
     const filled = Math.round((safePercent / 100) * barWidth);
     const empty = barWidth - filled;
-    let color;
-    let suffix = '';
-    if (safePercent >= thresholds.contextCritical) {
-        color = RED;
-        suffix = ' CRITICAL';
-    }
-    else if (safePercent >= thresholds.contextCompactSuggestion) {
-        color = YELLOW;
-        suffix = ' COMPRESS?';
-    }
-    else if (safePercent >= thresholds.contextWarning) {
-        color = YELLOW;
-    }
-    else {
-        color = GREEN;
-    }
+    const { color, suffix } = getContextDisplayStyle(safePercent, thresholds);
     const bar = `${color}${'█'.repeat(filled)}${DIM}${'░'.repeat(empty)}${RESET}`;
     return `ctx:[${bar}]${color}${safePercent}%${suffix}${RESET}`;
 }

package/dist/hud/elements/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/hud/elements/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,MAAM,KAAK,GAAG,UAAU,CAAC;AACzB,MAAM,MAAM,GAAG,UAAU,CAAC;AAC1B,MAAM,GAAG,GAAG,UAAU,CAAC;AACvB,MAAM,GAAG,GAAG,SAAS,CAAC;AAEtB;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAe,EACf,UAAyB;IAEzB,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACpE,IAAI,KAAa,CAAC;IAClB,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,IAAI,WAAW,IAAI,UAAU,CAAC,eAAe,EAAE,CAAC;QAC9C,KAAK,GAAG,GAAG,CAAC;QACZ,MAAM,GAAG,WAAW,CAAC;IACvB,CAAC;SAAM,IAAI,WAAW,IAAI,UAAU,CAAC,wBAAwB,EAAE,CAAC;QAC9D,KAAK,GAAG,MAAM,CAAC;QACf,MAAM,GAAG,YAAY,CAAC;IACxB,CAAC;SAAM,IAAI,WAAW,IAAI,UAAU,CAAC,cAAc,EAAE,CAAC;QACpD,KAAK,GAAG,MAAM,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,KAAK,CAAC;IAChB,CAAC;IAED,OAAO,OAAO,KAAK,GAAG,WAAW,IAAI,MAAM,GAAG,KAAK,EAAE,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAe,EACf,UAAyB,EACzB,WAAmB,EAAE;IAErB,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAEhC,IAAI,KAAa,CAAC;IAClB,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,IAAI,WAAW,IAAI,UAAU,CAAC,eAAe,EAAE,CAAC;QAC9C,KAAK,GAAG,GAAG,CAAC;QACZ,MAAM,GAAG,WAAW,CAAC;IACvB,CAAC;SAAM,IAAI,WAAW,IAAI,UAAU,CAAC,wBAAwB,EAAE,CAAC;QAC9D,KAAK,GAAG,MAAM,CAAC;QACf,MAAM,GAAG,YAAY,CAAC;IACxB,CAAC;SAAM,IAAI,WAAW,IAAI,UAAU,CAAC,cAAc,EAAE,CAAC;QACpD,KAAK,GAAG,MAAM,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,KAAK,CAAC;IAChB,CAAC;IAED,MAAM,GAAG,GAAG,GAAG,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,EAAE,CAAC;IAC9E,OAAO,QAAQ,GAAG,IAAI,KAAK,GAAG,WAAW,IAAI,MAAM,GAAG,KAAK,EAAE,CAAC;AAChE,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/hud/elements/context.ts"],"names":[],"mappings":"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"}

package/dist/hud/elements/git.d.ts

@@ -3,6 +3,10 @@
  *
  * Renders git repository name and branch information.
  */
+/**
+ * Clear all git caches. Call in tests beforeEach to ensure a clean slate.
+ */
+export declare function resetGitCache(): void;
 /**
  * Get git repository name from remote URL.
  * Extracts the repo name from URLs like:

package/dist/hud/elements/git.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../src/hud/elements/git.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmB1D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAcxD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIzD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI3D"}
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../src/hud/elements/git.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA+B1D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBxD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIzD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI3D"}

package/dist/hud/elements/git.js

@@ -4,7 +4,18 @@
  * Renders git repository name and branch information.
  */
 import { execSync } from 'node:child_process';
+import { resolve } from 'node:path';
 import { dim, cyan } from '../colors.js';
+const CACHE_TTL_MS = 30_000;
+const repoCache = new Map();
+const branchCache = new Map();
+/**
+ * Clear all git caches. Call in tests beforeEach to ensure a clean slate.
+ */
+export function resetGitCache() {
+    repoCache.clear();
+    branchCache.clear();
+}
 /**
  * Get git repository name from remote URL.
  * Extracts the repo name from URLs like:
@@ -15,6 +26,12 @@ import { dim, cyan } from '../colors.js';
  * @returns Repository name or null if not available
  */
 export function getGitRepoName(cwd) {
+    const key = cwd ? resolve(cwd) : process.cwd();
+    const cached = repoCache.get(key);
+    if (cached && Date.now() < cached.expiresAt) {
+        return cached.value;
+    }
+    let result = null;
     try {
         const url = execSync('git remote get-url origin', {
             cwd,
@@ -23,16 +40,21 @@ export function getGitRepoName(cwd) {
             stdio: ['pipe', 'pipe', 'pipe'],
             shell: process.platform === 'win32' ? 'cmd.exe' : undefined,
         }).trim();
-        if (!url)
-            return null;
-        // Extract repo name from URL
-        // Handles: https://github.com/user/repo.git, git@github.com:user/repo.git
-        const match = url.match(/\/([^/]+?)(?:\.git)?$/) || url.match(/:([^/]+?)(?:\.git)?$/);
-        return match ? match[1].replace(/\.git$/, '') : null;
+        if (!url) {
+            result = null;
+        }
+        else {
+            // Extract repo name from URL
+            // Handles: https://github.com/user/repo.git, git@github.com:user/repo.git
+            const match = url.match(/\/([^/]+?)(?:\.git)?$/) || url.match(/:([^/]+?)(?:\.git)?$/);
+            result = match ? match[1].replace(/\.git$/, '') : null;
+        }
     }
     catch {
-        return null;
+        result = null;
     }
+    repoCache.set(key, { value: result, expiresAt: Date.now() + CACHE_TTL_MS });
+    return result;
 }
 /**
  * Get current git branch name.
@@ -41,6 +63,12 @@ export function getGitRepoName(cwd) {
  * @returns Branch name or null if not available
  */
 export function getGitBranch(cwd) {
+    const key = cwd ? resolve(cwd) : process.cwd();
+    const cached = branchCache.get(key);
+    if (cached && Date.now() < cached.expiresAt) {
+        return cached.value;
+    }
+    let result = null;
     try {
         const branch = execSync('git branch --show-current', {
             cwd,
@@ -49,11 +77,13 @@ export function getGitBranch(cwd) {
             stdio: ['pipe', 'pipe', 'pipe'],
             shell: process.platform === 'win32' ? 'cmd.exe' : undefined,
         }).trim();
-        return branch || null;
+        result = branch || null;
     }
     catch {
-        return null;
+        result = null;
     }
+    branchCache.set(key, { value: result, expiresAt: Date.now() + CACHE_TTL_MS });
+    return result;
 }
 /**
  * Render git repository name element.

package/dist/hud/elements/git.js.map

@@ -1 +1 @@
-{"version":3,"file":"git.js","sourceRoot":"","sources":["../../../src/hud/elements/git.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,QAAQ,CAAC,2BAA2B,EAAE;YAChD,GAAG;YACH,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;SAC5D,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QAEtB,6BAA6B;QAC7B,0EAA0E;QAC1E,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,uBAAuB,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACtF,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,2BAA2B,EAAE;YACnD,GAAG;YACH,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;SAC5D,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,OAAO,MAAM,IAAI,IAAI,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../../src/hud/elements/git.ts"],"names":[],"mappings":"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"}

package/dist/hud/elements/index.d.ts

@@ -21,4 +21,5 @@ export { renderModel, formatModelName } from './model.js';
 export { renderPromptTime } from './prompt-time.js';
 export { detectApiKeySource, renderApiKeySource, type ApiKeySource } from './api-key-source.js';
 export { renderMissionBoard } from './mission-board.js';
+export { renderSessionSummary, type SessionSummaryState } from './session-summary.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/hud/elements/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hud/elements/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACpG,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hud/elements/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACpG,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/hud/elements/index.js

@@ -21,4 +21,5 @@ export { renderModel, formatModelName } from './model.js';
 export { renderPromptTime } from './prompt-time.js';
 export { detectApiKeySource, renderApiKeySource } from './api-key-source.js';
 export { renderMissionBoard } from './mission-board.js';
+export { renderSessionSummary } from './session-summary.js';
 //# sourceMappingURL=index.js.map

package/dist/hud/elements/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hud/elements/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAA6B,MAAM,gBAAgB,CAAC;AACpG,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAqB,MAAM,qBAAqB,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hud/elements/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAA6B,MAAM,gBAAgB,CAAC;AACpG,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAqB,MAAM,qBAAqB,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAA4B,MAAM,sBAAsB,CAAC"}

package/dist/hud/elements/session-summary.d.ts

@@ -0,0 +1,23 @@
+/**
+ * OMC HUD - Session Summary Element
+ *
+ * Displays a brief (<20 char) AI-generated summary of the current session.
+ * The summary is generated by a standalone script (scripts/session-summary.mjs)
+ * that runs in the background and caches results in the state directory.
+ *
+ * Generation rules:
+ * - First generation after 10+ user turns
+ * - Regeneration every 10 additional turns
+ * - Uses `claude -p` for summarization
+ */
+export interface SessionSummaryState {
+    summary: string;
+    turnCount: number;
+    generatedAt: string;
+}
+/**
+ * Render the session summary element.
+ * Returns null if no summary is available.
+ */
+export declare function renderSessionSummary(summaryState: SessionSummaryState | null): string | null;
+//# sourceMappingURL=session-summary.d.ts.map

package/dist/hud/elements/session-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-summary.d.ts","sourceRoot":"","sources":["../../../src/hud/elements/session-summary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,mBAAmB,GAAG,IAAI,GACvC,MAAM,GAAG,IAAI,CAGf"}

package/dist/hud/elements/session-summary.js

@@ -0,0 +1,23 @@
+/**
+ * OMC HUD - Session Summary Element
+ *
+ * Displays a brief (<20 char) AI-generated summary of the current session.
+ * The summary is generated by a standalone script (scripts/session-summary.mjs)
+ * that runs in the background and caches results in the state directory.
+ *
+ * Generation rules:
+ * - First generation after 10+ user turns
+ * - Regeneration every 10 additional turns
+ * - Uses `claude -p` for summarization
+ */
+import { dim } from '../colors.js';
+/**
+ * Render the session summary element.
+ * Returns null if no summary is available.
+ */
+export function renderSessionSummary(summaryState) {
+    if (!summaryState?.summary)
+        return null;
+    return dim('summary:') + summaryState.summary;
+}
+//# sourceMappingURL=session-summary.js.map

package/dist/hud/elements/session-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-summary.js","sourceRoot":"","sources":["../../../src/hud/elements/session-summary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAQnC;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,YAAwC;IAExC,IAAI,CAAC,YAAY,EAAE,OAAO;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC;AAChD,CAAC"}

package/dist/hud/elements/token-usage.d.ts

@@ -0,0 +1,8 @@
+/**
+ * OMC HUD - Token Usage Element
+ *
+ * Renders last-request input/output token usage from transcript metadata.
+ */
+import type { LastRequestTokenUsage } from '../types.js';
+export declare function renderTokenUsage(usage: LastRequestTokenUsage | null | undefined, sessionTotalTokens?: number | null): string | null;
+//# sourceMappingURL=token-usage.d.ts.map

package/dist/hud/elements/token-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-usage.d.ts","sourceRoot":"","sources":["../../../src/hud/elements/token-usage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,qBAAqB,GAAG,IAAI,GAAG,SAAS,EAC/C,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,GACjC,MAAM,GAAG,IAAI,CAmBf"}