ai-lens 0.8.92 → 0.8.93

package/.commithash

@@ -1 +1 @@
-2196993
+255d9a3

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.93 — 2026-06-15
+- fix: on Windows, committed Claude Code project hooks no longer flash a console window that steals focus on every event — the hook command is wrapped in `conhost.exe --headless` (Windows 10 1809+), which runs capture with no visible window while still capturing every event. Older Windows builds and macOS/Linux are unchanged
+
 ## 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

package/cli/hooks.js

@@ -1,6 +1,6 @@
 import { existsSync, lstatSync, readFileSync, writeFileSync, copyFileSync, renameSync, mkdirSync, rmSync, unlinkSync, chmodSync, readdirSync } from 'node:fs';
 import { join, dirname } from 'node:path';
-import { homedir } from 'node:os';
+import { homedir, release } from 'node:os';
 import { fileURLToPath } from 'node:url';
 import { execFileSync } from 'node:child_process';
 
@@ -302,6 +302,22 @@ export function writeLauncher({ clientDir = CLIENT_INSTALL_DIR, nodePath, platfo
 // Hook command construction
 // ---------------------------------------------------------------------------
 
+// `conhost.exe --headless` runs a console program with no visible window — the
+// fix for Windows hooks flashing/stealing focus on every event (Claude Code spawns
+// the hook process without CREATE_NO_WINDOW; upstream anthropics/claude-code#61051).
+// Unlike wscript/`-WindowStyle Hidden`, it keeps stdin wired, so capture.js still
+// receives the hook payload. `--headless` requires the modern conhost shipped in
+// Windows 10 1809 (build 17763); on older builds the flag errors, so we gate on it
+// and fall back to the bare-node form (still flashes, but captures).
+const WIN_HEADLESS_MIN_BUILD = 17763;
+
+export function supportsConhostHeadless(osRelease = release()) {
+  // os.release() on Windows looks like '10.0.22631'. Build = the third segment.
+  const m = /^\d+\.\d+\.(\d+)/.exec(String(osRelease || ''));
+  if (!m) return false;
+  return Number(m[1]) >= WIN_HEADLESS_MIN_BUILD;
+}
+
 // Lazy default ctx for callers that don't pass one (legacy tests, TOOL_CONFIGS at
 // import-time). Resolver isn't called at module load — only when captureCommand runs.
 function resolveDefaultCtx() {
@@ -310,6 +326,7 @@ function resolveDefaultCtx() {
     nodeResolution,
     platform: process.platform,
     clientDir: CLIENT_INSTALL_DIR,
+    conhost: process.platform === 'win32' && supportsConhostHeadless(),
   };
 }
 
@@ -340,6 +357,9 @@ export function captureCommand(opts = {}) {
   const clientDir = ctx.clientDir ?? CLIENT_INSTALL_DIR;
   const nodeResolution = ctx.nodeResolution;
   const isWin = platform === 'win32';
+  // Windows-only windowless wrapper (see supportsConhostHeadless). Resolved per-ctx
+  // so a build < 1809 falls back to the bare form. Never applied off Windows.
+  const conhost = isWin && (ctx.conhost ?? supportsConhostHeadless());
   // shell hint distinguishes cmd.exe (Claude Code) from PowerShell (Cursor) on
   // Windows — the two need different escaping for paths with spaces.
   const isPS = shell === 'powershell';
@@ -354,6 +374,13 @@ export function captureCommand(opts = {}) {
   // POSIX shells use $VAR.
   if (projectDirRelPath != null) {
     const rel = projectDirRelPath.replace(/\\/g, '/').replace(/^\.?\/+/, '');
+    if (conhost) {
+      // Windowless form. conhost is the launched image (no cmd.exe shell), so the
+      // path must use $CLAUDE_PROJECT_DIR — Claude Code substitutes that variable
+      // itself before exec on every OS (the %VAR% form would survive unexpanded
+      // since there's no shell to expand it). Verified on Windows 11 / cc 2.1.177.
+      return `conhost.exe --headless node "$CLAUDE_PROJECT_DIR/${rel}"`;
+    }
     const dir = isWin ? '%CLAUDE_PROJECT_DIR%' : '$CLAUDE_PROJECT_DIR';
     return `node "${dir}/${rel}"`;
   }
@@ -945,10 +972,21 @@ function isAcceptableHookCommand(cmd) {
 export function isWrongPlatformProjectDirCommand(cmd, platform = process.platform) {
   if (!isClaudeProjectDirCommand(cmd)) return false;
   const n = (cmd || '').replace(/\\/g, '/');
+  // The conhost windowless form is unambiguously a Windows command (conhost.exe is
+  // Windows-only) and deliberately uses $CLAUDE_PROJECT_DIR — Claude Code substitutes
+  // that itself, so it expands on Windows too. It is therefore correct on win32 and
+  // wrong (won't run) anywhere else; the %VAR% rule below doesn't apply to it.
+  if (isConhostHeadlessCommand(n)) return platform !== 'win32';
   const correctVar = platform === 'win32' ? '%CLAUDE_PROJECT_DIR%' : '$CLAUDE_PROJECT_DIR';
   return !n.includes(correctVar);
 }
 
+// `conhost.exe --headless …` windowless wrapper (Windows). Tolerates an optional
+// `.exe` and arbitrary spacing between the two tokens.
+export function isConhostHeadlessCommand(cmd) {
+  return /(^|[\\/\s])conhost(\.exe)?\s+--headless\b/i.test(String(cmd || '').replace(/\\/g, '/'));
+}
+
 // Whether a hook-config file is committed (tracked) in git. The anti-churn rule
 // (treat both $ and % CLAUDE_PROJECT_DIR forms as current) exists ONLY to keep a
 // COMMITTED cross-platform hook file from being flipped to one OS's syntax and

package/package.json

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