@ghl-ai/aw 0.1.36 → 0.1.37-beta.4

package/cli.mjs

@@ -6,6 +6,7 @@ import { fileURLToPath } from 'node:url';
 import * as fmt from './fmt.mjs';
 import { chalk } from './fmt.mjs';
 import { checkForUpdate, notifyUpdate } from './update.mjs';
+import { startSpan } from './telemetry.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const VERSION = JSON.parse(readFileSync(join(__dirname, 'package.json'), 'utf8')).version;
@@ -20,6 +21,7 @@ const COMMANDS = {
   link:    () => import('./commands/link-project.mjs').then(m => m.linkProjectCommand),
   nuke:    () => import('./commands/nuke.mjs').then(m => m.nukeCommand),
   daemon:  () => import('./commands/daemon.mjs').then(m => m.daemonCommand),
+  telemetry: () => import('./commands/telemetry.mjs').then(m => m.telemetryCommand),
 };
 
 function parseArgs(argv) {
@@ -101,6 +103,11 @@ function printHelp() {
     cmd('aw daemon uninstall', 'Stop the background daemon'),
     cmd('aw daemon status', 'Check if daemon is running'),
 
+    sec('Settings'),
+    cmd('aw telemetry status', 'Show telemetry status'),
+    cmd('aw telemetry disable', 'Opt out of anonymous analytics'),
+    cmd('aw telemetry enable', 'Re-enable analytics'),
+
     sec('Examples'),
     '',
     `  ${chalk.dim('# Pull content from registry using path')}`,
@@ -147,9 +154,17 @@ export async function run(argv) {
   }
 
   if (command && COMMANDS[command]) {
+    const span = startSpan(command, args);
+    span.notice();
     args._updateCheck = updateCheck;
-    const handler = await COMMANDS[command]();
-    await handler(args);
+    try {
+      const handler = await COMMANDS[command]();
+      await handler(args);
+      await span.end({ status: 'completed' });
+    } catch (err) {
+      await span.end({ status: 'failed', error_type: err.constructor.name });
+      throw err;
+    }
     notifyUpdate(await updateCheck);
     return;
   }

package/commands/init.mjs

@@ -74,7 +74,7 @@ function installIdeTasks() {
       {
         label: 'aw: sync registry',
         type: 'shell',
-        command: 'aw init --silent',
+        command: 'AW_TRIGGER=ide:task aw init --silent',
         presentation: { reveal: 'silent', panel: 'shared', close: true },
         runOptions: { runOn: 'folderOpen' },
         problemMatcher: [],

package/commands/push.mjs

@@ -1,7 +1,8 @@
 // commands/push.mjs — Push local agents/skills to registry via PR using persistent git clone
 
 import { existsSync, statSync, readFileSync, appendFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { exec as execCb, execFile as execFileCb } from 'node:child_process';
 import { promisify } from 'node:util';
 import { homedir } from 'node:os';
@@ -25,6 +26,9 @@ import {
   logAheadOfMain,
 } from '../git.mjs';
 
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const VERSION = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8')).version;
+
 const PUSHABLE_TYPES = ['agents', 'skills', 'commands', 'evals'];
 
 // ── PR content generation ────────────────────────────────────────────
@@ -187,11 +191,14 @@ function generateCommitMsg(files) {
   const deletedParts = Object.entries(groupBy(deleted, 'type')).map(([t, items]) => `${items.length} ${singular(t, items.length)} removed`);
   const countParts = [...addedParts, ...deletedParts];
 
+  const version = VERSION;
+  const trailer = `\n\nGenerated-By: aw/${version}`;
+
   if (files.length === 1) {
     const f = files[0];
-    return `registry: ${f.deleted ? 'remove' : 'add'} ${f.type}/${f.slug} ${f.deleted ? 'from' : 'to'} ${f.namespace}`;
+    return `registry: ${f.deleted ? 'remove' : 'add'} ${f.type}/${f.slug} ${f.deleted ? 'from' : 'to'} ${f.namespace}${trailer}`;
   }
-  return `registry: sync ${files.length} files (${countParts.join(', ')})`;
+  return `registry: sync ${files.length} files (${countParts.join(', ')})${trailer}`;
 }
 
 // ── Batch file collection from folder ────────────────────────────────

package/commands/telemetry.mjs

@@ -0,0 +1,31 @@
+// commands/telemetry.mjs — `aw telemetry [enable|disable|status]`
+
+import { enableTelemetry, disableTelemetry, getStatus } from '../telemetry.mjs';
+import * as fmt from '../fmt.mjs';
+import { chalk } from '../fmt.mjs';
+
+export async function telemetryCommand(args) {
+  const sub = args._positional?.[0];
+
+  if (sub === 'disable') {
+    disableTelemetry();
+    fmt.logSuccess('Telemetry disabled. No anonymous usage data will be sent.');
+    return;
+  }
+
+  if (sub === 'enable') {
+    enableTelemetry();
+    fmt.logSuccess('Telemetry enabled. Anonymous usage stats help improve aw.');
+    return;
+  }
+
+  // status (default)
+  const status = getStatus();
+  fmt.intro('aw telemetry');
+  fmt.logStep(`Status:     ${status.enabled ? chalk.green('enabled') : chalk.red('disabled')}`);
+  fmt.logStep(`Machine ID: ${chalk.dim(status.machine_id)}`);
+  fmt.logStep(`Config:     ${chalk.dim(status.config_path)}`);
+  fmt.logMessage('');
+  fmt.logMessage(`  ${chalk.dim('aw telemetry disable')}  — opt out of anonymous analytics`);
+  fmt.logMessage(`  ${chalk.dim('aw telemetry enable')}   — re-enable analytics`);
+}

package/constants.mjs

@@ -24,3 +24,6 @@ export const DOCS_SOURCE_DIR = 'content';
 
 /** Persistent git clone root — ~/.aw/ */
 export const AW_HOME = join(homedir(), '.aw');
+
+/** Telemetry endpoint — override with AW_TELEMETRY_URL env var */
+export const TELEMETRY_URL = process.env.AW_TELEMETRY_URL || 'https://aw-telemetry.ghl.ai/v1/events';

package/hooks.mjs

@@ -55,17 +55,17 @@ if command -v aw >/dev/null 2>&1; then
   # not the project repo that triggered this hook. Using git's own list of
   # local env vars is more robust than hardcoding specific names.
   unset $(git rev-parse --local-env-vars 2>/dev/null)
-  aw pull --silent >/dev/null 2>&1 &
+  AW_TRIGGER=hook:post-merge aw pull --silent >/dev/null 2>&1 &
 fi`);
 
 const POST_CHECKOUT = makeDispatcher('post-checkout', `\
 # Unset ALL git env vars so aw's "git -C ~/.aw" runs against the correct repo.
 unset $(git rev-parse --local-env-vars 2>/dev/null)
 if [ -d "$HOME/.aw" ] && [ ! -d ".aw" ] && [ -d ".git" ] && command -v aw >/dev/null 2>&1; then
-  aw link >/dev/null 2>&1 &
+  AW_TRIGGER=hook:post-checkout aw link >/dev/null 2>&1 &
 fi
 if command -v aw >/dev/null 2>&1; then
-  aw pull --silent >/dev/null 2>&1 &
+  AW_TRIGGER=hook:post-checkout aw pull --silent >/dev/null 2>&1 &
 fi`);
 
 // post-commit: written separately — needs different guard logic than other hooks.
@@ -83,7 +83,7 @@ case "$(pwd)" in /tmp/aw-*|/var/folders/*/aw-*) exit 0 ;; esac
 # Committing inside .aw/ worktree itself → refresh from parent project dir
 case "$(pwd)" in */.aw)
   if command -v aw >/dev/null 2>&1; then
-    (cd "$(dirname "$(pwd)")" && aw link >/dev/null 2>&1) &
+    (cd "$(dirname "$(pwd)")" && AW_TRIGGER=hook:post-commit aw link >/dev/null 2>&1) &
   fi
   exit 0
   ;;
@@ -91,7 +91,7 @@ esac
 
 # Committing in a project that has a .aw/ worktree → refresh symlinks
 if [ -f ".aw/.git" ] && command -v aw >/dev/null 2>&1; then
-  aw link >/dev/null 2>&1 &
+  AW_TRIGGER=hook:post-commit aw link >/dev/null 2>&1 &
 fi
 
 # Chain to previous hooksPath

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghl-ai/aw",
-  "version": "0.1.36",
+  "version": "0.1.37-beta.4",
   "description": "Agentic Workspace CLI — pull, push & manage agents, skills and commands from the registry",
   "type": "module",
   "bin": "bin.js",
@@ -23,7 +23,8 @@
     "apply.mjs",
     "update.mjs",
     "hooks.mjs",
-    "ecc.mjs"
+    "ecc.mjs",
+    "telemetry.mjs"
   ],
   "engines": {
     "node": ">=18.0.0"

package/telemetry.mjs

@@ -0,0 +1,219 @@
+// telemetry.mjs — Anonymous usage analytics. Zero new dependencies.
+//
+// Span-based: each command sends command_started + command_completed/command_failed,
+// linked by a run_id. Orphaned started events = stuck/killed commands.
+//
+// Opt out: AW_TELEMETRY_DISABLED=1, DO_NOT_TRACK=1, or `aw telemetry disable`.
+
+import { createHash, randomUUID } from 'node:crypto';
+import { hostname, userInfo, platform, arch, release } from 'node:os';
+import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { execSync } from 'node:child_process';
+import { TELEMETRY_URL, AW_HOME } from './constants.mjs';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const VERSION = JSON.parse(readFileSync(join(__dirname, 'package.json'), 'utf8')).version;
+
+const CONFIG_PATH = join(AW_HOME, '.telemetry');
+
+// ── Config ──────────────────────────────────────────────────────────
+
+export function generateMachineId() {
+  const raw = `${hostname()}:${userInfo().username}`;
+  return createHash('sha256').update(raw).digest('hex');
+}
+
+export function loadConfig() {
+  try {
+    if (existsSync(CONFIG_PATH)) {
+      return JSON.parse(readFileSync(CONFIG_PATH, 'utf8'));
+    }
+  } catch { /* corrupt file — recreate */ }
+
+  const config = {
+    machine_id: generateMachineId(),
+    enabled: true,
+    noticed: false,
+  };
+  saveConfig(config);
+  return config;
+}
+
+export function saveConfig(config) {
+  try {
+    mkdirSync(dirname(CONFIG_PATH), { recursive: true });
+    writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + '\n');
+  } catch { /* best effort — don't break CLI */ }
+}
+
+// ── Opt-out detection ───────────────────────────────────────────────
+
+export function isDisabled(config) {
+  if (process.env.DO_NOT_TRACK === '1') return true;
+  if (process.env.AW_TELEMETRY_DISABLED === '1') return true;
+  if (config && config.enabled === false) return true;
+  return false;
+}
+
+// ── Environment collection ──────────────────────────────────────────
+
+function getRegistryHead() {
+  try {
+    return execSync('git -C "' + AW_HOME + '" rev-parse --short HEAD', {
+      encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 2000,
+    }).trim();
+  } catch { return null; }
+}
+
+function detectIDEs() {
+  const ides = [];
+  const cwd = process.cwd();
+  const checks = [
+    ['.cursor', 'cursor'],
+    ['.vscode', 'vscode'],
+    ['.claude', 'claude'],
+    ['.codex', 'codex'],
+  ];
+  for (const [dir, name] of checks) {
+    try {
+      if (existsSync(join(cwd, dir))) ides.push(name);
+    } catch { /* skip */ }
+  }
+  return ides;
+}
+
+function getNamespace() {
+  try {
+    const cfgPath = join(AW_HOME, '.aw_registry', '.sync-config.json');
+    if (existsSync(cfgPath)) {
+      const cfg = JSON.parse(readFileSync(cfgPath, 'utf8'));
+      return cfg.namespace || null;
+    }
+  } catch { /* skip */ }
+  return null;
+}
+
+function projectHash() {
+  return createHash('sha256').update(process.cwd()).digest('hex').slice(0, 8);
+}
+
+export function collectEnv(config) {
+  return {
+    machine_id: config.machine_id,
+    aw_version: VERSION,
+    node_version: process.version,
+    os: platform(),
+    arch: arch(),
+    is_ci: !!(process.env.CI || process.env.CONTINUOUS_INTEGRATION || process.env.BUILD_NUMBER),
+    namespace: getNamespace(),
+    ides_detected: detectIDEs(),
+    project_hash: projectHash(),
+    trigger: process.env.AW_TRIGGER || 'interactive',
+    registry_head: getRegistryHead(),
+  };
+}
+
+// ── Network ─────────────────────────────────────────────────────────
+
+export async function send(payload) {
+  try {
+    await fetch(TELEMETRY_URL, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(payload),
+      signal: AbortSignal.timeout(3000),
+    });
+  } catch {
+    // Swallow ALL errors — telemetry must never break the CLI
+  }
+}
+
+// ── Span API ────────────────────────────────────────────────────────
+
+export function startSpan(command, args) {
+  const config = loadConfig();
+  const disabled = isDisabled(config);
+  const runId = randomUUID();
+  const startTime = Date.now();
+
+  // Extract flags and positional args for the payload
+  const flags = [];
+  const positional = [];
+  if (args) {
+    for (const [key, val] of Object.entries(args)) {
+      if (key === '_positional') {
+        positional.push(...(val || []));
+      } else if (key.startsWith('-') || key.startsWith('--')) {
+        if (val === true) flags.push(key);
+        else flags.push(`${key}=${val}`);
+      }
+    }
+  }
+
+  const env = disabled ? null : collectEnv(config);
+
+  // Fire command_started (non-blocking)
+  if (!disabled) {
+    send({
+      event: 'command_started',
+      run_id: runId,
+      timestamp: new Date().toISOString(),
+      env,
+      command: { name: command, args: positional, flags },
+    });
+  }
+
+  return {
+    runId,
+
+    /** Show one-time first-run notice (only in interactive/TTY mode) */
+    notice() {
+      if (disabled || config.noticed) return;
+      if (args?.['--silent'] || !process.stderr.isTTY) return;
+      console.error('\u2139  Telemetry is on \u2014 anonymous usage stats help improve aw. Opt out: aw telemetry disable');
+      config.noticed = true;
+      saveConfig(config);
+    },
+
+    /** End the span with outcome */
+    async end({ status = 'completed', error_type = null, data = {} } = {}) {
+      if (disabled) return;
+      const duration_ms = Date.now() - startTime;
+      await send({
+        event: status === 'completed' ? 'command_completed' : 'command_failed',
+        run_id: runId,
+        timestamp: new Date().toISOString(),
+        env,
+        command: { name: command, args: positional, flags },
+        outcome: { status, duration_ms, error_type, data },
+      });
+    },
+  };
+}
+
+// ── Telemetry management (for `aw telemetry` command) ───────────────
+
+export function enableTelemetry() {
+  const config = loadConfig();
+  config.enabled = true;
+  saveConfig(config);
+  return config;
+}
+
+export function disableTelemetry() {
+  const config = loadConfig();
+  config.enabled = false;
+  saveConfig(config);
+  return config;
+}
+
+export function getStatus() {
+  const config = loadConfig();
+  return {
+    enabled: !isDisabled(config),
+    machine_id: config.machine_id,
+    config_path: CONFIG_PATH,
+  };
+}