codeant-cli 0.2.6 → 0.2.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeant-cli",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "Code review CLI tool",
   "type": "module",
   "bin": {
@@ -41,6 +41,7 @@
     "ink": "^5.0.1",
     "minimatch": "^10.1.1",
     "open": "^10.1.0",
+    "posthog-node": "^5.28.5",
     "react": "^18.3.1"
   },
   "devDependencies": {

package/src/commands/review.js

@@ -6,6 +6,7 @@ import { fetchApi } from '../utils/fetchApi.js';
 import fs from 'fs';
 import path from 'path';
 import { executeTool } from '../tools/executeTool.js';
+import { track, shutdown as analyticsShutdown } from '../utils/analytics.js';
 import {
   renderInitializing,
   renderFetchingDiff,
@@ -51,6 +52,9 @@ export default function Review({ scanType = 'all', lastNCommits = 1, failOn = 'C
     let cancelled = false;
 
     async function runReview() {
+      const reviewStartTime = Date.now();
+      track('review_triggered', { scan_type: scanType, source: 'cli_interactive' });
+
       try {
         // ── Fetch diff ─────────────────────────────────────────────────────
         setStatus('fetching_diff');
@@ -140,9 +144,24 @@ export default function Review({ scanType = 'all', lastNCommits = 1, failOn = 'C
         setSummary(null);
         setStatus('done');
 
+        const labelCounts = {};
+        for (const i of reviewIssues) { labelCounts[i.label] = (labelCounts[i.label] || 0) + 1; }
+        track('review_completed', {
+          scan_type: scanType,
+          source: 'cli_interactive',
+          issue_count: reviewIssues.length,
+          file_count: perFileRequests.length,
+          duration_ms: Date.now() - reviewStartTime,
+          label_counts: labelCounts,
+        });
+        await analyticsShutdown();
+
       } catch (err) {
         if (!cancelled) {
-          setError(err.message);
+          const errMsg = err instanceof Error ? err.message : String(err);
+          track('review_error', { scan_type: scanType, source: 'cli_interactive', error: errMsg });
+          await analyticsShutdown();
+          setError(errMsg);
           setStatus('error');
         }
       }

package/src/index.js

@@ -13,6 +13,7 @@ import Review from './commands/review.js';
 import Welcome from './components/Welcome.js';
 import * as scm from './scm/index.js';
 import { setConfigValue } from './utils/config.js';
+import { track, shutdown as analyticsShutdown } from './utils/analytics.js';
 
 // Read version from package.json — createRequire works with ncc bundling
 const require = createRequire(import.meta.url);
@@ -324,5 +325,25 @@ program
       }));
     });
 
+  // ─── Analytics tracking (for external callers like Claude Code skills) ───
+  program
+    .command('track')
+    .description('Send an analytics event')
+    .requiredOption('--event <name>', 'Event name (e.g. skill_invoked, suggestions_applied)')
+    .option('--props <json>', 'JSON string of event properties', '{}')
+    .action(async (options) => {
+      try {
+        const props = JSON.parse(options.props);
+        if (typeof props !== 'object' || props === null || Array.isArray(props)) {
+          process.stderr.write('--props must be a JSON object\n');
+          return;
+        }
+        track(options.event, props);
+        await analyticsShutdown();
+      } catch (err) {
+        process.stderr.write(`Invalid --props JSON: ${err instanceof Error ? err.message : String(err)}\n`);
+      }
+    });
+
   program.parse();
 }

package/src/reviewHeadless.js

@@ -2,6 +2,7 @@ import ReviewApiHelper from './utils/reviewApiHelper.js';
 import { fetchApi } from './utils/fetchApi.js';
 import { executeTool } from './tools/executeTool.js';
 import { getConfigValue, setConfigValue } from './utils/config.js';
+import { track } from './utils/analytics.js';
 
 const MAX_TURNS = 5;
 
@@ -97,6 +98,9 @@ export async function runReviewHeadless(options = {}) {
   if (apiKey) process.env.CODEANT_API_TOKEN = apiKey;
   if (baseUrl) process.env.CODEANT_API_URL = baseUrl;
 
+  const reviewStartTime = Date.now();
+  track('review_triggered', { scan_type: scanType, source: 'headless' });
+
   try {
     // ── Fetch diff ──────────────────────────────────────────────────────
     onProgress('Fetching diff...');
@@ -113,6 +117,7 @@ export async function runReviewHeadless(options = {}) {
     onFilesReady(meta?.reviewed_files || [], meta);
 
     if (!requestBody?.diff_content?.length) {
+      track('review_completed', { scan_type: scanType, source: 'headless', issue_count: 0, file_count: 0, duration_ms: Date.now() - reviewStartTime, no_files: true });
       return { issues: [], meta, error: null, noFiles: true };
     }
 
@@ -163,9 +168,19 @@ export async function runReviewHeadless(options = {}) {
       label: issue.label || 'Code Quality',
     }));
 
+    const labelCounts = {};
+    for (const i of issues) { labelCounts[i.label] = (labelCounts[i.label] || 0) + 1; }
+    track('review_completed', {
+      scan_type: scanType, source: 'headless', issue_count: issues.length,
+      file_count: perFileRequests.length, duration_ms: Date.now() - reviewStartTime,
+      label_counts: labelCounts,
+    });
+
     return { issues, meta, error: null, noFiles: false };
   } catch (err) {
-    return { issues: [], meta: null, error: err.message, noFiles: false };
+    const errMsg = err instanceof Error ? err.message : String(err);
+    track('review_error', { scan_type: scanType, source: 'headless', error: errMsg });
+    return { issues: [], meta: null, error: errMsg, noFiles: false };
   } finally {
     // Restore env vars
     if (prevToken !== undefined) process.env.CODEANT_API_TOKEN = prevToken;

package/src/utils/analytics.js

@@ -0,0 +1,45 @@
+import { PostHog } from 'posthog-node';
+import { getConfigValue } from './config.js';
+
+const POSTHOG_API_KEY = 'phc_TpsLE5AMwHYsrSQIYgI7uqvorzlDMsin3lDvTEv2DxO';
+const POSTHOG_HOST = 'https://r.codeant.ai';
+
+let client = null;
+
+function getClient() {
+  if (!client) {
+    client = new PostHog(POSTHOG_API_KEY, { host: POSTHOG_HOST, flushAt: 1, flushInterval: 0 });
+  }
+  return client;
+}
+
+/** Use the API key directly as distinct ID */
+function getDistinctId() {
+  return process.env.CODEANT_API_TOKEN || getConfigValue('apiKey') || 'anonymous';
+}
+
+/**
+ * Track an analytics event. Fire-and-forget — never throws or blocks the CLI.
+ * @param {string} event - Event name (e.g. 'review_triggered')
+ * @param {Object} [properties={}] - Event properties
+ */
+export function track(event, properties = {}) {
+  try {
+    getClient().capture({
+      distinctId: getDistinctId(),
+      event,
+      properties: { source: 'cli', cli_version: process.env.npm_package_version || 'unknown', ...properties },
+    });
+  } catch (_) {
+    // Analytics should never break the CLI
+  }
+}
+
+/** Flush pending events. Call before process exits. */
+export async function shutdown() {
+  try {
+    if (client) await client.shutdown();
+  } catch (_) {
+    // noop
+  }
+}