ai-lens 0.8.52 → 0.8.53

package/.commithash

@@ -1 +1 @@
-8553371
+c830ed5

package/bin/ai-lens.js

@@ -15,7 +15,7 @@ switch (command) {
   }
   case 'status': {
     const { default: status } = await import('../cli/status.js');
-    await status();
+    await status({ report: process.argv.includes('--report') });
     break;
   }
   case 'version':

package/cli/hooks.js

@@ -174,11 +174,12 @@ export function installClientFiles() {
     '{"type":"module"}\n',
   );
 
-  // Write version.json so installed capture.js can identify itself
+  // Write version.json so installed capture.js can identify itself.
+  // packageRoot lets sender.js find bin/ai-lens.js for background status reports.
   const { version, commit } = getVersionInfo();
   writeFileSync(
     join(CLIENT_INSTALL_DIR, 'version.json'),
-    JSON.stringify({ version, commit }) + '\n',
+    JSON.stringify({ version, commit, packageRoot: PKG_ROOT }) + '\n',
   );
 }
 

package/cli/status.js

@@ -5,7 +5,7 @@ import { homedir, release as osRelease, arch as osArch } from 'node:os';
 import { randomUUID } from 'node:crypto';
 
 import { getVersionInfo, readLensConfig, detectInstalledTools, getCursorToolConfig, getClaudeCodeToolConfig, analyzeToolHooks, checkHooksDisabled, CAPTURE_PATH, TOOL_CONFIGS } from './hooks.js';
-import { DATA_DIR, PENDING_DIR, SENDING_DIR, SESSION_PATHS_DIR, LOG_PATH, CAPTURE_LOG_PATH, getGitIdentity, getMonitoredProjects } from '../client/config.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 { readCodexWatcherLock, resolveWatchedCodexDirs } from '../client/codex-watcher.js';
 import { initLogger, info, success, warn, error, heading, blank } from './logger.js';
@@ -92,6 +92,42 @@ function expandTilde(pathStr) {
   return pathStr;
 }
 
+/**
+ * Detect install mode from the capture.js path in hook commands.
+ * Returns { ok, summary, detail } for the status output.
+ */
+function detectInstallMode(tools) {
+  const copyDir = join(homedir(), '.ai-lens', 'client') + '/';
+  const paths = [];
+  for (const tool of tools) {
+    const cmd = extractHookCommand(tool);
+    if (!cmd) continue;
+    const m = cmd.match(/["']([^"']*capture\.js)["']|(\S*capture\.js)/);
+    if (m) paths.push({ tool: tool.name, raw: m[1] || m[2], resolved: expandTilde(m[1] || m[2]) });
+  }
+  if (paths.length === 0) {
+    return { ok: null, summary: 'unknown', detail: 'No hook commands found — cannot determine install mode' };
+  }
+  const modes = paths.map(p => {
+    if (p.resolved.startsWith(copyDir)) return 'copy';
+    return 'repo-path';
+  });
+  const unique = [...new Set(modes)];
+  const mode = unique.length === 1 ? unique[0] : 'mixed';
+  const detail = paths.map(p => {
+    const m = p.resolved.startsWith(copyDir) ? 'copy' : 'repo-path';
+    return `  ${p.tool}: ${m} (${p.raw})`;
+  }).join('\n');
+
+  if (mode === 'copy') {
+    return { ok: true, summary: 'copy (~/.ai-lens/client/)', detail: `Client files copied to ~/.ai-lens/client/\nUpdate: npx -y ai-lens init --yes\n${detail}` };
+  }
+  if (mode === 'repo-path') {
+    return { ok: true, summary: 'repo-path (auto-update on git pull)', detail: `Hooks point directly to repo/package source\nUpdate: git pull (or npx cache refresh)\n${detail}` };
+  }
+  return { ok: null, summary: `mixed (${unique.join(' + ')})`, detail: `Different tools use different install modes:\n${detail}` };
+}
+
 function validateHookCommandPaths(tool) {
   const command = extractHookCommand(tool);
   if (!command) return null;
@@ -1059,43 +1095,83 @@ function buildReport(results, timestamp, warnings = [], allTools = TOOL_CONFIGS)
   return lines.join('\n');
 }
 
+// ---------------------------------------------------------------------------
+// Report mode: POST structured status to server
+// ---------------------------------------------------------------------------
+
+async function sendStatusReport(results, warnings, clientVersion, clientCommit, serverUrl, authToken) {
+  if (!serverUrl || !authToken) return;
+
+  const payload = {
+    timestamp: new Date().toISOString(),
+    client_version: clientVersion,
+    client_commit: clientCommit,
+    node_version: process.version,
+    os: `${process.platform} ${osRelease()} ${osArch()}`,
+    checks: results.map(({ label, ok, summary, detail }) => ({ label, ok, summary, detail })),
+    warnings: warnings.map(({ msg, action }) => ({ msg, action })),
+  };
+
+  try {
+    const res = await fetch(`${serverUrl}/api/client-reports`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'X-Auth-Token': authToken,
+        'X-Client-Version': `${clientVersion}+${clientCommit}`,
+      },
+      body: JSON.stringify(payload),
+      signal: AbortSignal.timeout(15_000),
+    });
+    if (res.ok) {
+      try { writeFileSync(LAST_STATUS_REPORT_PATH, new Date().toISOString()); } catch {}
+    }
+  } catch {
+    // Silent — report is best-effort
+  }
+}
+
 // ---------------------------------------------------------------------------
 // Main
 // ---------------------------------------------------------------------------
 
-export default async function status() {
+export default async function status({ report = false } = {}) {
   const versionResult = checkVersion();
-  initLogger(versionResult.summary);
+  if (!report) initLogger(versionResult.summary);
 
   const { version, commit } = getVersionInfo();
-  blank();
-  info(`${BOLD}AI Lens Status v${version} (${commit})${RESET}`);
-  info('='.repeat(40));
-  blank();
+  if (!report) {
+    blank();
+    info(`${BOLD}AI Lens Status v${version} (${commit})${RESET}`);
+    info('='.repeat(40));
+    blank();
+  }
 
   const results = [];
 
   function printLine(label, result) {
-    const icon = result.ok === true ? CHECK : result.ok === false ? CROSS : `${DIM}-${RESET}`;
-    const pad = ' '.repeat(Math.max(1, 17 - label.length));
-    info(`${label}:${pad}${icon} ${result.summary}`);
+    if (!report) {
+      const icon = result.ok === true ? CHECK : result.ok === false ? CROSS : `${DIM}-${RESET}`;
+      const pad = ' '.repeat(Math.max(1, 17 - label.length));
+      info(`${label}:${pad}${icon} ${result.summary}`);
+    }
     results.push({ label, ...result });
   }
 
   // 1. System info
   const sys = checkSystem();
-  info(`${'System:'}          ${sys.summary}`);
+  if (!report) info(`${'System:'}          ${sys.summary}`);
   results.push({ label: 'System', ...sys });
 
   // 2. Tool versions
   const claude = checkToolVersion('Claude');
   const cursor = checkToolVersion('Cursor');
   if (claude.ok !== null) {
-    info(`${'Claude Code:'}     ${claude.summary}`);
+    if (!report) info(`${'Claude Code:'}     ${claude.summary}`);
     results.push({ label: 'Claude Code version', ...claude });
   }
   if (cursor.ok !== null) {
-    info(`${'Cursor:'}          ${cursor.summary}`);
+    if (!report) info(`${'Cursor:'}          ${cursor.summary}`);
     results.push({ label: 'Cursor version', ...cursor });
   }
 
@@ -1155,6 +1231,10 @@ export default async function status() {
     detail: `Global hooks active: ${hasGlobalHooks}\nProject hooks active: ${hasProjectHooks}${hasGlobalHooks && hasProjectHooks ? '\nWarning: both global and project hooks are active — events may be captured twice. Run init with --project-hooks to consolidate.' : ''}`,
   });
 
+  // 6c. Install mode: detect how capture.js is referenced in hooks
+  const installMode = detectInstallMode(toolsWithProject);
+  printLine('Install mode', installMode);
+
   // 7. Queue (before capture test so test event doesn't show as pending)
   const queueResult = checkQueue();
   printLine('Queue', queueResult);
@@ -1200,7 +1280,7 @@ export default async function status() {
     serverReachable: serverResult.ok === true,
   });
 
-  if (warnings.length > 0) {
+  if (!report && warnings.length > 0) {
     blank();
     info('='.repeat(40));
     info(`${BOLD}Warnings${RESET}`);
@@ -1211,19 +1291,23 @@ export default async function status() {
     }
   }
 
-  // Write report file
-  const timestamp = new Date().toISOString();
-  // Merge global TOOL_CONFIGS (always listed, even if not installed) with project tools
-  const allToolsForReport = [...TOOL_CONFIGS, ...toolsWithProject.filter(t => !TOOL_CONFIGS.includes(t))];
-  const report = buildReport(results, timestamp, warnings, allToolsForReport);
-  try {
-    writeFileSync(REPORT_PATH, report);
-    blank();
-    info(`${DIM}Full report \u2192 ${REPORT_PATH}${RESET}`);
-  } catch (err) {
+  if (report) {
+    // --report mode: POST structured JSON to server, update marker file
+    await sendStatusReport(results, warnings, version, commit, serverUrl, authToken);
+  } else {
+    // Normal mode: write text report file
+    const timestamp = new Date().toISOString();
+    // Merge global TOOL_CONFIGS (always listed, even if not installed) with project tools
+    const allToolsForReport = [...TOOL_CONFIGS, ...toolsWithProject.filter(t => !TOOL_CONFIGS.includes(t))];
+    const reportText = buildReport(results, timestamp, warnings, allToolsForReport);
+    try {
+      writeFileSync(REPORT_PATH, reportText);
+      blank();
+      info(`${DIM}Full report \u2192 ${REPORT_PATH}${RESET}`);
+    } catch (err) {
+      blank();
+      error(`Could not write report: ${err.message}`);
+    }
     blank();
-    error(`Could not write report: ${err.message}`);
   }
-
-  blank();
 }

package/client/config.js

@@ -22,6 +22,7 @@ export const GIT_REMOTES_DIR    = join(DATA_DIR, 'git-remotes');
 export const LOG_PATH = join(DATA_DIR, 'sender.log');
 export const CAPTURE_LOG_PATH = join(DATA_DIR, 'capture.log');
 export const SENDER_BACKOFF_PATH = join(DATA_DIR, 'sender-backoff.json');
+export const LAST_STATUS_REPORT_PATH = join(DATA_DIR, 'last-status-report');
 export const LOG_MAX_AGE_DAYS = 30;
 const GIT_ROOT_CACHE = new Map();
 // Pipe stderr (instead of inheriting it) so that "fatal: not a git repository"

package/client/sender.js

@@ -12,16 +12,18 @@
 
 import {
   readFileSync, writeFileSync, writeSync, unlinkSync, rmSync, renameSync, realpathSync,
-  readdirSync, mkdirSync, existsSync, openSync, closeSync,
+  readdirSync, mkdirSync, existsSync, openSync, closeSync, statSync,
 } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { randomUUID } from 'node:crypto';
 import { fileURLToPath } from 'node:url';
+import { spawn } from 'node:child_process';
 import {
   ensureDataDir,
   PENDING_DIR,
   SENDING_DIR,
   SENDER_BACKOFF_PATH,
+  LAST_STATUS_REPORT_PATH,
   STORAGE_VERSION_PATH,
   CURRENT_STORAGE_VERSION,
   QUEUE_PATH,
@@ -633,6 +635,49 @@ async function postEvents(serverUrl, events, identity, authToken) {
   throw new Error(`Server responded ${res.status}: ${data}`);
 }
 
+// =============================================================================
+// Status report (once per 24h)
+// =============================================================================
+
+const STATUS_REPORT_INTERVAL_MS = 24 * 60 * 60 * 1000;
+
+function resolveStatusBin() {
+  // 1. Relative to sender.js — works for --use-repo-path installs
+  const relBin = join(dirname(fileURLToPath(import.meta.url)), '..', 'bin', 'ai-lens.js');
+  if (existsSync(relBin)) return relBin;
+  // 2. packageRoot from version.json — works for copy installs (npx, global)
+  try {
+    const { packageRoot } = getClientVersion();
+    if (packageRoot) {
+      const pkgBin = join(packageRoot, 'bin', 'ai-lens.js');
+      if (existsSync(pkgBin)) return pkgBin;
+    }
+  } catch {}
+  return null;
+}
+
+function trySpawnStatusReport() {
+  try {
+    if (existsSync(LAST_STATUS_REPORT_PATH)) {
+      const mtime = statSync(LAST_STATUS_REPORT_PATH).mtimeMs;
+      if (Date.now() - mtime < STATUS_REPORT_INTERVAL_MS) return;
+    }
+    const binPath = resolveStatusBin();
+    if (!binPath) return;
+    // Touch marker immediately to prevent multiple spawns
+    writeFileSync(LAST_STATUS_REPORT_PATH, new Date().toISOString());
+    const child = spawn(process.execPath, [binPath, 'status', '--report'], {
+      detached: true,
+      stdio: 'ignore',
+      windowsHide: true,
+    });
+    child.on('error', () => {});
+    child.unref();
+  } catch {
+    // Best-effort — don't break sender
+  }
+}
+
 // =============================================================================
 // Main
 // =============================================================================
@@ -698,6 +743,7 @@ async function main() {
     }
     clearSenderBackoff();
     commitQueue(sendingDir, acquiredFiles);
+    trySpawnStatusReport();
   } catch (err) {
     const unsentIds = new Set(
       events.filter(e => !sentEventIds.has(e.event_id)).map(e => e.event_id).filter(Boolean)

package/package.json

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