agentlytics 0.2.8 → 0.2.10

package/README.md

@@ -14,6 +14,7 @@
   <a href="#supported-editors"><img src="https://img.shields.io/badge/editors-16-818cf8" alt="editors"></a>
   <a href="#license"><img src="https://img.shields.io/badge/license-MIT-green" alt="license"></a>
   <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%E2%89%A520.19%20%7C%20%E2%89%A522.12-brightgreen" alt="node"></a>
+  <a href="https://deno.land"><img src="https://img.shields.io/badge/deno-%E2%89%A52.0-000?logo=deno" alt="deno"></a>
 </p>
 
 <p align="center">
@@ -39,10 +40,61 @@ You switch between Cursor, Windsurf, Claude Code, VS Code Copilot, and more —
 
 ```bash
 npx agentlytics
+# or
+pnpm dlx agentlytics
+# or
+yarn dlx agentlytics
+# or
+bunx agentlytics
 ```
 
 Opens at **http://localhost:4637**. Requires Node.js ≥ 20.19 or ≥ 22.12, macOS. No data ever leaves your machine.
 
+### Deno (Sandboxed)
+
+Run a lightweight, zero-dependency analytics scan with Deno's permission sandbox — directly from a URL, no install needed:
+
+```bash
+deno run --allow-read --allow-env https://raw.githubusercontent.com/f/agentlytics/master/mod.ts
+```
+
+Only `--allow-read` and `--allow-env` are required. No network access, no file writes, no code execution — just reads your local editor data and prints a summary.
+
+```
+  (● ●) [● ●]   Agentlytics — Deno Sandboxed Edition
+  {● ●} <● ●>   Lightweight CLI analytics for AI coding agents
+
+  ✓ Claude Code            8 sessions
+  ✓ VS Code                23 sessions
+  ✓ VS Code Insiders       66 sessions
+  ● Cursor                 detected
+  ✓ Codex CLI              3 sessions
+  ...
+
+  Summary
+  Sessions           109
+  Messages           459
+  Projects           18
+  Editors            7 of 15 checked
+  Date range         2025-04-02 → 2026-03-09
+```
+
+Add `--json` for machine-readable output:
+
+```bash
+deno run --allow-read --allow-env mod.ts --json
+```
+
+If you've cloned the repo, you can also use Deno tasks for the full dashboard:
+
+```bash
+deno task start       # Full dashboard (all permissions)
+deno task scan        # Lightweight CLI scan
+deno task scan:json   # JSON output
+```
+
+### Node.js
+
 ```
 $ npx agentlytics
 
@@ -68,6 +120,7 @@ To only build the cache without starting the server:
 
 ```bash
 npx agentlytics --collect
+# or: pnpm dlx agentlytics --collect
 ```
 
 ## Features
@@ -112,6 +165,7 @@ Relay enables multi-user context sharing across a team. One person starts a rela
 
 ```bash
 npx agentlytics --relay
+# or: pnpm dlx agentlytics --relay
 ```
 
 Optionally protect with a password:
@@ -138,6 +192,7 @@ This starts a relay server on port `4638` and prints the join command and MCP en
 ```bash
 cd /path/to/your-project
 npx agentlytics --join <host:port>
+# or: pnpm dlx agentlytics --join <host:port>
 ```
 
 If the relay is password-protected:
@@ -186,7 +241,11 @@ Editor files/APIs → editors/*.js → cache.js (SQLite) → server.js (REST)
 Relay:  join clients → POST /relay/sync → relay.db (SQLite) → MCP server → AI clients
 ```
 
-All data is normalized into a local SQLite cache at `~/.agentlytics/cache.db`. The Express server exposes read-only REST endpoints consumed by the React frontend. Relay data is stored separately in `~/.agentlytics/relay.db`.
+```
+Deno:   Editor files → mod.ts (zero deps) → stdout (CLI/JSON)
+```
+
+All data is normalized into a local SQLite cache at `~/.agentlytics/cache.db`. The Express server exposes read-only REST endpoints consumed by the React frontend. Relay data is stored separately in `~/.agentlytics/relay.db`. The Deno sandboxed edition (`mod.ts`) bypasses SQLite entirely and reads editor files directly for a lightweight, permission-minimal CLI report.
 
 ## API
 

package/deno.json

@@ -0,0 +1,9 @@
+{
+  "tasks": {
+    "start": "deno run --allow-read --allow-write --allow-net --allow-env --allow-ffi --allow-run index.js",
+    "collect": "deno run --allow-read --allow-write --allow-env --allow-ffi index.js --collect",
+    "scan": "deno run --allow-read --allow-env mod.ts",
+    "scan:json": "deno run --allow-read --allow-env mod.ts --json"
+  },
+  "nodeModulesDir": "auto"
+}

package/index.js

@@ -6,11 +6,44 @@ const path = require('path');
 const os = require('os');
 const { execSync } = require('child_process');
 
+// ── Node.js version check ─────────────────────────────────
+const nodeVersion = process.versions.node;
+const [nodeMajor, nodeMinor] = nodeVersion.split('.').map(Number);
+const isNodeSupported =
+  (nodeMajor === 20 && nodeMinor >= 19) ||
+  (nodeMajor === 22 && nodeMinor >= 12) ||
+  nodeMajor === 23 || nodeMajor === 24 || nodeMajor >= 25;
+
+if (!isNodeSupported) {
+  console.error('');
+  console.error(`  \x1b[31m✗ Unsupported Node.js version: v${nodeVersion}\x1b[0m`);
+  console.error('');
+  console.error(`  \x1b[1mAgentlytics requires Node.js 20.19+ or 22.12+\x1b[0m`);
+  console.error(`  \x1b[2mYour current version: v${nodeVersion}\x1b[0m`);
+  console.error('');
+  console.error(`  \x1b[2mTo upgrade, visit: https://nodejs.org\x1b[0m`);
+  console.error(`  \x1b[2mOr use a version manager: nvm install 22\x1b[0m`);
+  console.error('');
+  process.exit(1);
+}
+
 const HOME = os.homedir();
+
+// ── Detect package manager ─────────────────────────────────
+function detectPackageManager() {
+  const ua = process.env.npm_config_user_agent || '';
+  if (ua.startsWith('pnpm/')) return 'pnpm';
+  if (ua.startsWith('yarn/')) return 'yarn';
+  if (ua.startsWith('bun/')) return 'bun';
+  return 'npm';
+}
+const PM = detectPackageManager();
+const PM_RUN = PM === 'npm' ? 'npx' : PM === 'pnpm' ? 'pnpm dlx' : PM === 'yarn' ? 'yarn dlx' : 'bunx';
 const PORT = process.env.PORT || 4637;
 const RELAY_PORT = process.env.RELAY_PORT || 4638;
 const noCache = process.argv.includes('--no-cache');
 const collectOnly = process.argv.includes('--collect');
+const isUiDev = process.argv.includes('--ui-dev');
 const isRelay = process.argv.includes('--relay');
 const joinIndex = process.argv.indexOf('--join');
 const isJoin = joinIndex !== -1;
@@ -47,7 +80,7 @@ if (isRelay) {
     console.log('');
     console.log(chalk.bold('  Share this command with your team:'));
     console.log('');
-    console.log(chalk.cyan(`    npx agentlytics --join ${localIp}:${RELAY_PORT} --username <name>`));
+    console.log(chalk.cyan(`    ${PM_RUN} agentlytics --join ${localIp}:${RELAY_PORT} --username <name>`));
     console.log('');
     console.log(chalk.bold('  MCP server endpoint (add to your AI client):'));
     console.log('');
@@ -76,7 +109,7 @@ if (isJoin) {
     let username = usernameIndex !== -1 ? process.argv[usernameIndex + 1] : null;
 
     if (!relayAddress) {
-      console.error(chalk.red('\n  ✗ Missing relay address. Usage: npx agentlytics --join <host:port> --username <name>\n'));
+      console.error(chalk.red(`\n  ✗ Missing relay address. Usage: ${PM_RUN} agentlytics --join <host:port> --username <name>\n`));
       process.exit(1);
     }
 
@@ -135,15 +168,20 @@ console.log('');
 const publicIndex = path.join(__dirname, 'public', 'index.html');
 const uiDir = path.join(__dirname, 'ui');
 
-if (!collectOnly && !fs.existsSync(publicIndex) && fs.existsSync(uiDir)) {
+if (!collectOnly && !isUiDev && !fs.existsSync(publicIndex) && fs.existsSync(uiDir)) {
   console.log(chalk.cyan('  ⟳ Building dashboard UI (first run)...'));
   try {
     const uiModules = path.join(uiDir, 'node_modules');
     if (fs.existsSync(uiModules)) fs.rmSync(uiModules, { recursive: true, force: true });
     console.log(chalk.dim('    Installing UI dependencies...'));
-    execSync('npm install --no-audit --no-fund', { cwd: uiDir, stdio: 'pipe' });
+    const installCmd = PM === 'npm' ? 'npm install --no-audit --no-fund'
+      : PM === 'pnpm' ? 'pnpm install --no-frozen-lockfile'
+      : PM === 'yarn' ? 'yarn install'
+      : 'bun install';
+    const buildCmd = `${PM} run build`;
+    execSync(installCmd, { cwd: uiDir, stdio: 'pipe' });
     console.log(chalk.dim('    Compiling frontend...'));
-    execSync('npm run build', { cwd: uiDir, stdio: 'pipe' });
+    execSync(buildCmd, { cwd: uiDir, stdio: 'pipe' });
     console.log(chalk.green('  ✓ UI built successfully'));
   } catch (err) {
     console.error(chalk.red('  ✗ UI build failed:'), err.message);
@@ -152,12 +190,34 @@ if (!collectOnly && !fs.existsSync(publicIndex) && fs.existsSync(uiDir)) {
   console.log('');
 }
 
-if (!collectOnly && !fs.existsSync(publicIndex)) {
+if (!collectOnly && !isUiDev && !fs.existsSync(publicIndex)) {
   console.error(chalk.red('  ✗ No built UI found at public/index.html'));
-  console.error(chalk.dim('    Run: cd ui && npm install && npm run build'));
+  console.error(chalk.dim(`    Run: cd ui && ${PM} install && ${PM} run build`));
   process.exit(1);
 }
 
+// ── Ensure better-sqlite3 native bindings exist ─────────────
+try {
+  require('better-sqlite3');
+} catch (e) {
+  if (e.message && e.message.includes('Could not locate the bindings file')) {
+    console.log(chalk.cyan('  ⟳ Rebuilding native SQLite module...'));
+    try {
+      const bsqlDir = path.dirname(require.resolve('better-sqlite3/package.json'));
+      execSync('npx --yes prebuild-install -r napi || npx --yes node-gyp rebuild --release', {
+        cwd: bsqlDir, stdio: 'pipe', timeout: 120000,
+      });
+      console.log(chalk.green('  ✓ Native module rebuilt'));
+    } catch (rebuildErr) {
+      console.error(chalk.red('  ✗ Failed to rebuild better-sqlite3:'), rebuildErr.message);
+      console.error(chalk.dim('    Try: npm install better-sqlite3 --build-from-source'));
+      process.exit(1);
+    }
+  } else {
+    throw e;
+  }
+}
+
 const cache = require('./cache');
 
 // Wipe cache if --no-cache flag is passed
@@ -365,12 +425,12 @@ const BOT_STYLES = [
     }
 
     app.listen(port, '0.0.0.0', () => {
+      if (isUiDev) return;
       const url = `http://localhost:${port}`;
       console.log(chalk.green(`  ✓ Dashboard ready at ${chalk.bold.white(url)}`));
       console.log('');
       console.log(chalk.dim('  Press Ctrl+C to stop\n'));
 
-      // Auto-open browser
       const open = require('open');
       open(url).catch(() => {});
     });