ai-lens 0.8.69 → 0.8.70

package/.commithash

@@ -1 +1 @@
-fe949b0
+0912a07

package/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 History of changes to the `ai-lens` CLI package on npm. New entries go on top. Format: `## X.Y.Z — YYYY-MM-DD`, followed by user-facing bullets.
 
+## 0.8.70 — 2026-05-28
+- diag: `sender-spawn-failed`, `codex-watcher-spawn-failed` and `queue-write-failed` entries in the capture log now record the OS `error.code` (e.g. EMFILE, EACCES). `ai-lens status` surfaces a per-category code breakdown so these failures can be diagnosed centrally instead of guessing from a bare count. The raw error message (which may contain local paths) stays on your machine — only the short code travels in the status report.
+
 ## 0.8.69 — 2026-05-27
 - feat: per-machine launcher (`~/.ai-lens/client/run.sh` / `run.cmd`) now also accepts an optional script path as its first argument. With no args it still execs the sibling `capture.js` (default install), but `~/.ai-lens/client/run.sh path/to/some/capture.js` execs that script with the launcher's resolved node — letting bootstrap-style workflows (e.g. meta-cursor) route through the launcher for proper node resolution while keeping `capture.js` under git in the workspace repo.
 - feat: new `--install-launcher` flag for `init`. Forces launcher installation even when `--no-hooks` is set, so the meta-cursor setup skill can wire up `~/.ai-lens/client/run.sh` without touching the static hook templates in the workspace repo.

package/cli/status.js

@@ -725,8 +725,13 @@ function checkCaptureLog() {
     return { ok: false, summary: `error reading log: ${err.message}`, detail: `Error: ${err.message}` };
   }
 
-  // Count entries by category (reason for drops, msg for errors)
+  // Count entries by category (reason for drops, msg for errors). For error
+  // entries that carry an `error.code` (spawn/queue failures), also tally the
+  // code distribution per category so it reaches the server via client_reports
+  // — the count alone can't tell EMFILE from EACCES from ENOENT. The raw
+  // error.message strings stay local (may contain paths); only the code travels.
   const counts = {};
+  const codesByCategory = {};
   let lastTs = null;
   let hasErrors = false;
   for (const line of lines) {
@@ -734,24 +739,38 @@ function checkCaptureLog() {
       const entry = JSON.parse(line);
       const category = entry.reason || entry.msg || 'unknown';
       counts[category] = (counts[category] || 0) + 1;
+      if (entry.code) {
+        (codesByCategory[category] ??= {});
+        codesByCategory[category][entry.code] = (codesByCategory[category][entry.code] || 0) + 1;
+      }
       lastTs = entry.ts;
       if (entry.msg) hasErrors = true;
     } catch { /* non-JSON line */ }
   }
 
   const total = lines.length;
-  const breakdown = Object.entries(counts).map(([r, n]) => `${r}: ${n}`).join(', ');
+  const breakdown = Object.entries(counts).map(([r, n]) => {
+    const codes = codesByCategory[r];
+    if (!codes) return `${r}: ${n}`;
+    const codeStr = Object.entries(codes).map(([c, cn]) => `${c}: ${cn}`).join(', ');
+    return `${r}: ${n} [${codeStr}]`;
+  }).join(', ');
 
   let summary = `${total} entries`;
   if (breakdown) summary += ` (${breakdown})`;
   if (lastTs) summary += `, last ${relativeTime(lastTs)}`;
 
+  // Include a compact code-distribution block in detail too — survives even if
+  // the "last 10 entries" happen to be benign project_filter lines.
+  const codeLines = Object.entries(codesByCategory)
+    .map(([cat, codes]) => `  ${cat}: ${Object.entries(codes).map(([c, n]) => `${c}=${n}`).join(', ')}`);
+  const codeBlock = codeLines.length ? `\n\nError codes by category:\n${codeLines.join('\n')}` : '';
   const last10 = lines.slice(-10);
 
   return {
     ok: !hasErrors,
     summary,
-    detail: `Log: ${CAPTURE_LOG_PATH}\nTotal: ${total}\n\nLast 10 entries:\n${last10.join('\n')}`,
+    detail: `Log: ${CAPTURE_LOG_PATH}\nTotal: ${total}${codeBlock}\n\nLast 10 entries:\n${last10.join('\n')}`,
   };
 }
 

package/client/capture.js

@@ -1263,7 +1263,7 @@ async function main() {
       writeToSpool(ev);
       if (ev === primary) primaryWritten = true;
     } catch (err) {
-      captureLog({ msg: 'queue-write-failed', error: err.message, type: ev.type, session_id: ev.session_id });
+      captureLog({ msg: 'queue-write-failed', error: err.message, code: err.code, type: ev.type, session_id: ev.session_id });
       // If the primary failed, propagate the failure so the hook exits non-zero
       // (and dedup is NOT committed). If a per-call event failed, log and keep
       // going — losing one TokenUsage row is better than dropping the whole
@@ -1312,14 +1312,14 @@ async function main() {
   try {
     trySpawnSender();
   } catch (err) {
-    captureLog({ msg: 'sender-spawn-failed', error: err.message });
+    captureLog({ msg: 'sender-spawn-failed', error: err.message, code: err.code });
     // event is queued — sender will be spawned on next capture
   }
 
   try {
     trySpawnCodexWatcher({ replayExisting: shouldReplayCodexHistory(primary) });
   } catch (err) {
-    captureLog({ msg: 'codex-watcher-spawn-failed', error: err.message });
+    captureLog({ msg: 'codex-watcher-spawn-failed', error: err.message, code: err.code });
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-lens",
-  "version": "0.8.69",
+  "version": "0.8.70",
   "type": "module",
   "description": "Centralized session analytics for AI coding tools",
   "bin": {