ai-lens 0.8.91 → 0.8.92

package/.commithash

@@ -1 +1 @@
-8894c21
+2196993

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 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.92 — 2026-06-11
+- fix: when global `~/.claude` hooks are active, `ai-lens init` no longer also installs the `.claude/settings.local.json` platform overlay (and removes a previously-written one) — global hooks already capture every project, and registering both made every hook event fire capture twice
+- improve: `ai-lens status` shows committed other-OS project hooks as healthy ("capture covered by global hooks") when global hooks are doing the work, instead of a false warning
+
 ## 0.8.91 — 2026-06-11
 - fix: Claude Code hooks committed to a repo now work on both Windows and macOS/Linux. A committed `.claude/settings.json` can only carry one OS's `CLAUDE_PROJECT_DIR` syntax, so on the other OS hooks silently captured nothing; `ai-lens init` now writes the running OS's form into `.claude/settings.local.json` (per-machine, auto-gitignored) without touching the shared file
 - improve: `ai-lens status` correctly diagnoses committed project hooks — green when the platform overlay is in place, a clear fix hint when it's missing, and no more false "command path missing" on healthy setups

package/cli/hooks.js

@@ -1080,6 +1080,43 @@ export function writeClaudeLocalOverlay(tool, opts = {}) {
   return { written: true, localPath: a.localPath };
 }
 
+/**
+ * Whether GLOBAL Claude Code hooks (~/.claude/settings.json) are active on this
+ * machine — current AI Lens hooks and not disabled. When they are, the
+ * settings.local.json platform overlay is redundant: global hooks fire for every
+ * project, and registering both would double-capture each event (collapsed by the
+ * server's content-hash dedup, but pointless client work).
+ * @param {object} [globalTool] — override for tests (defaults to the real ~/.claude tool)
+ */
+export function globalClaudeHooksActive(globalTool = TOOL_CONFIGS.find(t => t.name === 'Claude Code')) {
+  if (!globalTool || !existsSync(globalTool.configPath)) return false;
+  if (analyzeToolHooks(globalTool).status !== 'current') return false;
+  return checkHooksDisabled(globalTool).length === 0;
+}
+
+/**
+ * Strip AI Lens hooks from the settings.local.json overlay (e.g. after global
+ * Claude Code hooks were installed and the overlay became a double-capture source).
+ * Preserves everything else in the file; refuses a malformed file.
+ */
+export function removeClaudeLocalOverlay(tool) {
+  const localPath = claudeLocalSettingsPath(tool);
+  if (!existsSync(localPath)) return { removed: false, reason: 'no settings.local.json' };
+  let config;
+  try {
+    config = JSON.parse(readFileSync(localPath, 'utf-8'));
+  } catch {
+    return { removed: false, reason: `${localPath} is malformed`, localPath };
+  }
+  const hasAiLens = config.hooks && typeof config.hooks === 'object'
+    && Object.values(config.hooks).some(en => Array.isArray(en) && en.some(e => isAiLensHook(e)));
+  if (!hasAiLens) return { removed: false, reason: 'no AI Lens hooks in overlay', localPath };
+  const probe = { ...tool, configPath: localPath, sharedConfig: true };
+  const stripped = buildStrippedConfig(probe, config);
+  writeHooksConfig(probe, stripped ?? {});
+  return { removed: true, localPath };
+}
+
 function isCurrentAiLensHook(entry, expected, opts = {}) {
   // "Current" = a GUI-safe install (launcher OR absolute-node capture.js) OR a
   // committed Claude Code $CLAUDE_PROJECT_DIR project hook. We do NOT require an exact

package/cli/init.js

@@ -15,7 +15,7 @@ import { migrateIfNeeded } from '../client/sender.js';
 import {
   CAPTURE_PATH, REPO_CAPTURE_PATH, detectInstalledTools, getCursorToolConfig, getClaudeCodeToolConfig, getCodexToolConfig,
   analyzeToolHooks, buildMergedConfig, writeHooksConfig, describePlan, enableCodexHookTrust,
-  analyzeClaudeLocalOverlay, writeClaudeLocalOverlay,
+  analyzeClaudeLocalOverlay, writeClaudeLocalOverlay, removeClaudeLocalOverlay, globalClaudeHooksActive,
   installClientFiles, readLensConfig, saveLensConfig, getVersionInfo,
   getClaudeCodeHookDefsWithPath, getClaudeCodeHookDefsWithProjectDir, getCursorHookDefsWithPath, getCodexHookDefsWithPath,
   cleanupLegacyHooks, cleanupOppositeScope, cleanupEmptyMcpJson, addCursorMcp, removeCursorMcp,
@@ -1002,7 +1002,16 @@ export default async function init() {
       const overlayClaudeTool = getClaudeCodeToolConfig(overlayProjectRoot, 'Claude Code (project)', ctx);
       if (overlayClaudeTool && existsSync(overlayClaudeTool.configPath)) {
         const overlay = analyzeClaudeLocalOverlay(overlayClaudeTool);
-        if (overlay.applicable && !overlay.overlayCurrent) {
+        if (overlay.applicable && globalClaudeHooksActive()) {
+          // Global ~/.claude hooks fire for every project — an overlay would only
+          // double-register capture. Make sure it's absent rather than present.
+          const rm = removeClaudeLocalOverlay(overlayClaudeTool);
+          if (rm.removed) {
+            success(`  Claude Code: global hooks cover this project — removed the redundant overlay from ${rm.localPath}`);
+          } else {
+            info('  Claude Code: global hooks cover this project — settings.local.json overlay not needed.');
+          }
+        } else if (overlay.applicable && !overlay.overlayCurrent) {
           const r = writeClaudeLocalOverlay(overlayClaudeTool, { analysis: overlay });
           if (r.written) {
             success(`  Claude Code: committed project hooks use the other OS's CLAUDE_PROJECT_DIR syntax — wrote this OS's form to ${r.localPath} (per-machine, not committed)`);

package/cli/status.js

@@ -7,7 +7,7 @@ import tls from 'node:tls';
 
 import { TLS_TRUST_CODES, tlsCodeOf, tlsVerdictSummary, issuerName } from '../client/tls-trust.js';
 
-import { getVersionInfo, readLensConfig, detectInstalledTools, getCursorToolConfig, getClaudeCodeToolConfig, getCodexToolConfig, analyzeToolHooks, checkHooksDisabled, verifyCodexHookTrust, CAPTURE_PATH, TOOL_CONFIGS, isClaudeProjectDirCommand, analyzeClaudeLocalOverlay, extractProjectDirRelPath } from './hooks.js';
+import { getVersionInfo, readLensConfig, detectInstalledTools, getCursorToolConfig, getClaudeCodeToolConfig, getCodexToolConfig, analyzeToolHooks, checkHooksDisabled, verifyCodexHookTrust, CAPTURE_PATH, TOOL_CONFIGS, isClaudeProjectDirCommand, analyzeClaudeLocalOverlay, extractProjectDirRelPath, globalClaudeHooksActive } from './hooks.js';
 import { DATA_DIR, PENDING_DIR, SENDING_DIR, SESSION_PATHS_DIR, LOG_PATH, CAPTURE_LOG_PATH, LAST_STATUS_REPORT_PATH, getGitIdentity, getMonitoredProjects } from '../client/config.js';
 import { isLockStale } from '../client/sender.js';
 import { initLogger, info, success, warn, error, heading, blank } from './logger.js';
@@ -555,6 +555,13 @@ function checkHooks(tool) {
     if (cmd && isClaudeProjectDirCommand(cmd)) {
       const overlay = analyzeClaudeLocalOverlay(tool);
       if (overlay.applicable) {
+        if (globalClaudeHooksActive()) {
+          return {
+            ok: true,
+            summary: 'committed hooks are for the other OS \u2014 capture covered by global hooks',
+            detail: `${detail}\n\nCommitted settings.json uses the other OS's CLAUDE_PROJECT_DIR syntax (never fires here), but global ~/.claude hooks are active and capture every project \u2014 no overlay needed.`,
+          };
+        }
         if (overlay.overlayCurrent) {
           return {
             ok: true,

package/package.json

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