ai-lens 0.8.68 → 0.8.69

package/.commithash

@@ -1 +1 @@
-72eb1f0
+fe949b0

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.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.
+
 ## 0.8.68 — 2026-05-27
 - fix: hooks now resolve node from nvm, asdf, fnm, volta and n in addition to Homebrew. Previously `init` fell back to `/usr/bin/env node`, which made GUI Cursor on macOS silently lose every event because launchd's minimal PATH doesn't include node. Affected users with custom node installs (e.g. `/Users/<you>/node/bin/node`) saw hundreds of dropped events with no visible error.
 - feat: `init` now installs a per-machine launcher (`~/.ai-lens/client/run.sh` on macOS/Linux, `run.cmd` on Windows) with the resolved node path baked in. Hook commands invoke the launcher directly, so they no longer depend on the GUI app's PATH and survive `brew upgrade node`.

package/cli/hooks.js

@@ -242,8 +242,20 @@ export function launcherFilename(platform = process.platform) {
 
 /**
  * Write a per-machine launcher script with the resolved node path baked in.
- * The launcher uses dirname-of-script to find capture.js, so it's independent
- * of HOME / USERPROFILE / cwd at execution time.
+ *
+ * The launcher acts as a node-resolution shim that supports two invocation modes:
+ *
+ *   1. No arguments — run the sibling capture.js (the default install flow where
+ *      both the launcher and capture.js live in ~/.ai-lens/client/).
+ *   2. Script path as $1 — run that script with the resolved node. This is the
+ *      repo-path mode (e.g. meta-cursor static hooks pointing at
+ *      `internal/analytics/ai-lens/client/capture.js`) where capture.js auto-
+ *      updates via `git pull` and only the node binary needs per-machine baking.
+ *
+ * In both cases the launcher is independent of HOME / USERPROFILE / cwd — for
+ * mode 1 the path is derived from `dirname $0`; for mode 2 it's whatever the
+ * caller passes through (typically a workspace-relative path that resolves
+ * against the cwd Cursor/Claude Code set when firing the hook).
  *
  * @param {object} opts
  * @param {string} opts.clientDir — directory where the launcher (and capture.js) live
@@ -256,7 +268,13 @@ export function writeLauncher({ clientDir = CLIENT_INSTALL_DIR, nodePath, platfo
 
   if (platform === 'win32') {
     const escaped = nodePath.replace(/"/g, '""');
-    const content = `@echo off\r\n"${escaped}" "%~dp0capture.js" %*\r\n`;
+    const content =
+      '@echo off\r\n'
+      + 'if "%~1"=="" goto default\r\n'
+      + `"${escaped}" %*\r\n`
+      + 'goto :eof\r\n'
+      + ':default\r\n'
+      + `"${escaped}" "%~dp0capture.js"\r\n`;
     const target = join(clientDir, 'run.cmd');
     writeFileSync(target, content);
     return target;
@@ -265,8 +283,14 @@ export function writeLauncher({ clientDir = CLIENT_INSTALL_DIR, nodePath, platfo
   const escaped = shellEscape(nodePath, 'linux'); // POSIX single-quote escape
   const content =
     '#!/bin/sh\n'
+    + `# AI Lens per-machine launcher. Two modes:\n`
+    + `#   $0           → exec node on sibling capture.js (default install)\n`
+    + `#   $0 <script>  → exec node on <script> with remaining args (repo-path mode)\n`
+    + 'if [ $# -gt 0 ]; then\n'
+    + `  exec ${escaped} "$@"\n`
+    + 'fi\n'
     + 'DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)\n'
-    + `exec ${escaped} "$DIR/capture.js" "$@"\n`;
+    + `exec ${escaped} "$DIR/capture.js"\n`;
   const target = join(clientDir, 'run.sh');
   writeFileSync(target, content);
   try { chmodSync(target, 0o755); } catch { /* best effort */ }

package/cli/init.js

@@ -20,8 +20,9 @@ import {
   getClaudeCodeHookDefsWithPath, getCursorHookDefsWithPath,
   cleanupLegacyHooks, cleanupOppositeScope, cleanupEmptyMcpJson, addCursorMcp, removeCursorMcp,
   checkHooksDisabled, enableHooks,
-  findStableNodePath, isVersionPinnedNodePath,
+  findStableNodePath, isVersionPinnedNodePath, writeLauncher,
 } from './hooks.js';
+import { mkdirSync } from 'node:fs';
 import { scanNestedClaudeProjects, summarizeNestedProjects } from './scan.js';
 
 function ask(question) {
@@ -351,6 +352,9 @@ function getInitArgs() {
       case '--use-repo-path':
         flags.useRepoPath = true;
         break;
+      case '--install-launcher':
+        flags.installLauncher = true;
+        break;
       case '--mcp-scope':
         if (i + 1 < args.length) flags.mcpScope = args[++i];
         else process.stderr.write('Warning: --mcp-scope requires a value\n');
@@ -359,7 +363,7 @@ function getInitArgs() {
         const a = args[i];
         if (a.startsWith('-')) {
           process.stderr.write(`Warning: unknown flag "${a}" — did you mean --${a.replace(/^-+/, '')}?\n`);
-        } else if (['server', 'projects', 'yes', 'no-mcp', 'no-hooks', 'project-hooks', 'use-repo-path', 'mcp-scope'].includes(a)) {
+        } else if (['server', 'projects', 'yes', 'no-mcp', 'no-hooks', 'project-hooks', 'use-repo-path', 'install-launcher', 'mcp-scope'].includes(a)) {
           process.stderr.write(`Warning: unexpected argument "${a}" — did you mean --${a}?\n`);
         }
       }
@@ -387,11 +391,17 @@ export default async function init() {
   //
   // --project-hooks ALWAYS writes hooks regardless of whether ~/.cursor or
   // ~/.claude exist globally — so willWriteHooks must consider it.
+  //
+  // --install-launcher (added 0.8.69) forces launcher installation even when
+  // --no-hooks. Used by bootstrap workflows like meta-cursor where static hook
+  // templates point at ~/.ai-lens/client/run.sh but init must NOT overwrite
+  // those templates with the dynamic hook form.
   const globalTools = detectInstalledTools();
   const willWriteHooks = !flags.noHooks && (globalTools.length > 0 || !!flags.projectHooks);
+  const willInstallLauncher = willWriteHooks || !!flags.installLauncher;
   let nodeResolution = null;
   let ctx = null;
-  if (willWriteHooks) {
+  if (willInstallLauncher) {
     nodeResolution = findStableNodePath();
     if (!nodeResolution) {
       error('Could not find any node binary on this system.');
@@ -406,7 +416,9 @@ export default async function init() {
     } else {
       detail(`  Resolved node: ${nodeResolution.path} (${nodeResolution.source})`);
     }
-    ctx = { nodeResolution, platform: process.platform, clientDir: join(homedir(), '.ai-lens', 'client') };
+    if (willWriteHooks) {
+      ctx = { nodeResolution, platform: process.platform, clientDir: join(homedir(), '.ai-lens', 'client') };
+    }
   }
 
   // Detect installed tools — re-detect with ctx now that it's available.
@@ -545,9 +557,8 @@ export default async function init() {
   // Build new config in memory — saved after "Proceed?" confirmation
   const newConfig = { ...currentConfig, serverUrl, projects };
 
-  // Install client files to ~/.ai-lens/client/ (skip when --use-repo-path).
-  // Launcher (run.sh / run.cmd) is written only when we will actually wire up hooks
-  // — --no-hooks installs leave it out (and don't require a resolved node path).
+  // Install client files to ~/.ai-lens/client/ (skip when --use-repo-path because
+  // capture.js comes from the monorepo / package source in that mode).
   if (!flags.useRepoPath) {
     heading('Installing client files...');
     try {
@@ -564,6 +575,21 @@ export default async function init() {
       error(`  Failed to install client files: ${err.message}`);
       return;
     }
+  } else if (willInstallLauncher) {
+    // --use-repo-path with --install-launcher: keep capture.js out of the install
+    // dir (it lives in the monorepo, auto-updates via git pull) but still create
+    // the per-machine launcher so static hooks can route through it for proper
+    // node resolution. The meta-cursor bootstrap is the primary consumer.
+    heading('Installing launcher (--install-launcher) ...');
+    try {
+      const clientDir = join(homedir(), '.ai-lens', 'client');
+      mkdirSync(clientDir, { recursive: true });
+      writeLauncher({ clientDir, nodePath: nodeResolution.path, platform: process.platform });
+      success('  Wrote per-machine launcher to ~/.ai-lens/client/');
+    } catch (err) {
+      error(`  Failed to write launcher: ${err.message}`);
+      return;
+    }
   } else {
     detail('  Skipping client install (--use-repo-path: using package copy).');
   }

package/package.json

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