fix: cleanup stale status files on startup

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: grimmerk

src/main.ts

@@ -34,6 +34,7 @@ import {
   watchStatusDir,
   scanInitialStatuses,
   writeStatusFile,
+  cleanupStaleStatuses,
   SessionStatus,
 } from './session-status-hooks';
 import {
@@ -1845,9 +1846,10 @@ ipcMain.handle('get-session-statuses', async () => {
   const obj: Record<string, SessionStatus> = {};
   fileStatuses.forEach((v, k) => { obj[k] = v; });
 
-  // Scan active sessions that don't have status files yet
+  // Scan active sessions that don't have status files yet + cleanup stale ones
   try {
     const activeMap = await detectActiveSessions();
+    cleanupStaleStatuses(new Set(activeMap.keys()));
     const allSessions = readClaudeSessions(500); // hoisted out of loop
     const sessionsWithoutStatus = Array.from(activeMap.entries())
       .filter(([sessionId]) => !obj[sessionId])

src/session-status-hooks.ts

@@ -296,6 +296,23 @@ export const scanInitialStatuses = async (
   return statuses;
 };
 
+/**
+ * Clean up stale status files for sessions that are no longer active.
+ * Call on startup to prevent accumulation from crashed sessions or missing SessionEnd hooks.
+ */
+export const cleanupStaleStatuses = (activeSessionIds: Set<string>): void => {
+  try {
+    if (!fs.existsSync(STATUS_DIR)) return;
+    for (const file of fs.readdirSync(STATUS_DIR)) {
+      if (!file.endsWith('.json')) continue;
+      const sessionId = file.replace('.json', '');
+      if (!activeSessionIds.has(sessionId)) {
+        try { fs.unlinkSync(path.join(STATUS_DIR, file)); } catch {}
+      }
+    }
+  } catch {}
+};
+
 /**
  * Write a status file for a session (used to persist JSONL-scanned statuses).
  */