ai-lens 0.8.96 → 0.8.97

package/.commithash

@@ -1 +1 @@
-549ce90
+13ab9a5

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.97 — 2026-06-17
+- fix: `ai-lens init` no longer leaves an invalid `{ "version": 1 }` (no hooks) in `~/.cursor/hooks.json` when migrating to project hooks — Cursor flagged such a file as an error and stopped running ALL hooks, silently killing capture even when project hooks were correct. init now deletes the empty file, and repairs machines already left in this state on the next run
+
 ## 0.8.96 — 2026-06-17
 - fix: `ai-lens status` now reports a Windows Cursor (or Claude Code) hook that lacks the windowless `conhost.exe --headless` wrapper as outdated, so a normal re-run of `ai-lens init` (or `/setup`) upgrades it in place. Previously the console-flash fix from 0.8.95 only applied to brand-new installs; existing hooks were considered up-to-date and never rewritten. macOS/Linux, older Windows, and Codex hooks are unaffected
 

package/cli/hooks.js

@@ -1312,8 +1312,15 @@ export function buildStrippedConfig(tool, existingConfig) {
   // If no hooks remain, clean up
   if (Object.keys(base.hooks).length === 0) {
     delete base.hooks;
-    // If other settings remain (shared config like settings.json), keep them
-    if (Object.keys(base).length > 0) {
+    // Keep the file only if REAL user settings remain — i.e. keys beyond the tool's
+    // OWN scaffolding (e.g. Cursor's `version: 1`, which we wrote ourselves). Leaving
+    // a Cursor hooks.json as just `{ "version": 1 }` is an invalid hookless config:
+    // Cursor flags it as an error and stops running hooks. In that case return null so
+    // the caller deletes the file. Real settings (Claude settings.json env/statusLine,
+    // not in topLevelFields) are still preserved.
+    const scaffolding = new Set(Object.keys(tool.topLevelFields || {}));
+    const meaningful = Object.keys(base).filter((k) => !scaffolding.has(k));
+    if (meaningful.length > 0) {
       return base;
     }
     return null;
@@ -1800,7 +1807,19 @@ export function cleanupOppositeScope(activeTools) {
     try { config = JSON.parse(raw); } catch { continue; }
 
     const hooks = config.hooks;
-    if (!hooks || typeof hooks !== 'object') continue;
+    if (!hooks || typeof hooks !== 'object') {
+      // Repair: an older CLI could strip the opposite-scope hooks but leave behind an
+      // invalid hookless scaffolding file (e.g. Cursor's `{ "version": 1 }`), which the
+      // tool then flags as an error and stops running hooks. If a non-shared opposite
+      // file has no hooks and only our own scaffolding keys, delete it.
+      const scaffold = new Set(Object.keys(global.topLevelFields || {}));
+      const onlyScaffold = Object.keys(config).every((k) => scaffold.has(k));
+      if (!global.sharedConfig && onlyScaffold) {
+        try { unlinkSync(oppositeConfigPath); } catch { /* already gone */ }
+        results.push({ path: oppositeConfigPath, action: 'removed', toolName: oppositeToolName });
+      }
+      continue;
+    }
 
     let hasAiLens = false;
     for (const entries of Object.values(hooks)) {
@@ -1816,8 +1835,18 @@ export function cleanupOppositeScope(activeTools) {
     if (stripped) {
       writeHooksConfig({ configPath: oppositeConfigPath }, stripped);
       results.push({ path: oppositeConfigPath, action: 'cleaned', toolName: oppositeToolName });
+    } else if (global.sharedConfig) {
+      // Shared config (Claude settings.json): drop the hooks but keep the file —
+      // it may carry the user's other settings.
+      writeHooksConfig({ configPath: oppositeConfigPath }, {});
+      results.push({ path: oppositeConfigPath, action: 'cleaned', toolName: oppositeToolName });
+    } else {
+      // Non-shared (Cursor/Codex): the file held only AI Lens hooks plus our own
+      // scaffolding (e.g. Cursor's `version: 1`). Delete it rather than leave an
+      // invalid hookless `{ "version": 1 }` that breaks the tool's hook loading.
+      try { unlinkSync(oppositeConfigPath); } catch { /* already gone */ }
+      results.push({ path: oppositeConfigPath, action: 'removed', toolName: oppositeToolName });
     }
-    // Don't delete the file — global settings.json may have other settings
   }
   return results;
 }

package/package.json

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