nanoai-cli 1.0.11 → 1.1.0

package/README.md

@@ -86,6 +86,7 @@ NANOAGENT_SKIP_UPDATE_CHECK=1 nanoai
 | Variable | Purpose |
 | --- | --- |
 | `NANOAGENT_SKIP_DOWNLOAD` | Set to `1` to skip the install-time download. The binary will still be fetched on first run. |
+| `NANOAGENT_TELEMETRY_DISABLED` | Set to `1` to opt out of the anonymous `nanoagent cli installed` analytics event. `DO_NOT_TRACK=1` is also honored. |
 | `NANOAGENT_SKIP_UPDATE_CHECK` | Set to `1` to disable the runtime check for newer GitHub releases. |
 | `NANOAGENT_CLI_TAG` | Override the release tag to download, such as `v1.2.3`. |
 | `NANOAGENT_CLI_VERSION` | Override the version used to derive the default release tag. |

package/bin/nanoai.js

@@ -5,6 +5,7 @@ const { spawn } = require("child_process");
 
 const { ensureBinary } = require("../scripts/download");
 const { maybeUpdateBinary } = require("../scripts/update");
+const { trackInstall } = require("../scripts/telemetry");
 
 function log(message) {
   console.error(`[nanoagent] ${message}`);
@@ -23,7 +24,9 @@ function forwardSignal(child, signal) {
 }
 
 async function main() {
-  let binaryPath = await ensureBinary({ log });
+  // On a clean `bun add` (postinstall is skipped) the binary is fetched here on
+  // first launch; record the install once at that point.
+  let binaryPath = await ensureBinary({ log, onDownloaded: () => trackInstall() });
   binaryPath = await maybeUpdateBinary(binaryPath, { log });
 
   const child = spawn(binaryPath, process.argv.slice(2), {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nanoai-cli",
-  "version": "1.0.11",
+  "version": "1.1.0",
   "description": "Terminal UI, ACP server, and automation-friendly CLI for NanoAgent.",
   "keywords": [
     "nanoagent",

package/scripts/download.js

@@ -76,8 +76,10 @@ function extractExecutable(zipBuffer, destinationPath) {
 }
 
 // Ensures the platform binary is present in vendor/. Returns the absolute path.
+// `onDownloaded` is awaited only when a fresh (non-update) binary is fetched, so
+// callers can record an anonymous install event exactly once per real install.
 async function ensureBinary(options = {}) {
-  const { force = false, log = () => {}, tag } = options;
+  const { force = false, log = () => {}, tag, onDownloaded } = options;
 
   const binaryPath = platform.installedBinaryPath();
   if (!force && fs.existsSync(binaryPath)) {
@@ -121,6 +123,17 @@ async function ensureBinary(options = {}) {
   fs.renameSync(tempPath, binaryPath);
 
   log(`Installed NanoAgent CLI to ${binaryPath}.`);
+
+  // Fire once per genuine install. Updates pass force=true and are intentionally
+  // excluded so they are not counted as new installs.
+  if (!force && typeof onDownloaded === "function") {
+    try {
+      await onDownloaded();
+    } catch {
+      // Telemetry must never affect installation.
+    }
+  }
+
   return binaryPath;
 }
 

package/scripts/postinstall.js

@@ -12,8 +12,12 @@ if (process.env.NANOAGENT_SKIP_DOWNLOAD === "1") {
 }
 
 const { ensureBinary } = require("./download");
+const { trackInstall } = require("./telemetry");
 
-ensureBinary({ log: (m) => console.error(`[nanoagent] ${m}`) })
+ensureBinary({
+  log: (m) => console.error(`[nanoagent] ${m}`),
+  onDownloaded: () => trackInstall(),
+})
   .then(() => {
     console.error("[nanoagent] Ready. Run `nanoai` to start.");
   })

package/scripts/telemetry.js

@@ -0,0 +1,115 @@
+"use strict";
+
+// Best-effort, anonymous PostHog "installed" event shared by the postinstall step
+// and the runtime first-run download (covers `bun add`, which skips postinstall).
+// Telemetry must never affect installation: every failure is swallowed and the
+// network call is bounded by a short timeout. Opt out with NANOAGENT_TELEMETRY_DISABLED
+// or the cross-tool DO_NOT_TRACK convention.
+
+const crypto = require("crypto");
+
+const platform = require("./platform");
+
+// Mirrors NanoAgent.Infrastructure.Configuration.TelemetryOptions so install and
+// in-product analytics land in the same PostHog project.
+const TELEMETRY_HOST = "https://us.i.posthog.com";
+const TELEMETRY_PROJECT_TOKEN = "phc_AKZFSyU239kkQ5GQ2y4idb8MtFX96kVekgezgnsELHRk";
+const TELEMETRY_EVENT = "nanoagent cli installed";
+const TIMEOUT_MS = 5000;
+
+function isTruthy(value) {
+  if (!value) return false;
+  return ["1", "true", "yes", "on"].includes(String(value).trim().toLowerCase());
+}
+
+function telemetryEnabled() {
+  if (isTruthy(process.env.NANOAGENT_TELEMETRY_DISABLED) || isTruthy(process.env.DO_NOT_TRACK)) {
+    return false;
+  }
+  return Boolean(TELEMETRY_PROJECT_TOKEN);
+}
+
+// Identify the package manager that triggered the install. npm/pnpm/yarn set
+// npm_config_user_agent during their lifecycle; bun is detected from the runtime
+// when the binary is fetched lazily on first launch.
+function detectInstallMethod() {
+  const ua = (process.env.npm_config_user_agent || "").toLowerCase();
+  if (ua.includes("bun")) return "bun";
+  if (ua.includes("pnpm")) return "pnpm";
+  if (ua.includes("yarn")) return "yarn";
+  if (ua.includes("npm")) return "npm";
+  if (process.versions && process.versions.bun) return "bun";
+  return "npm";
+}
+
+function osFamily() {
+  switch (process.platform) {
+    case "win32":
+      return "windows";
+    case "darwin":
+      return "macos";
+    case "linux":
+      return "linux";
+    default:
+      return "other";
+  }
+}
+
+function isCi() {
+  return Boolean(
+    process.env.CI ||
+      process.env.GITHUB_ACTIONS ||
+      process.env.GITLAB_CI ||
+      process.env.BITBUCKET_BUILD_NUMBER
+  );
+}
+
+function resolveQuietly(resolver, fallback) {
+  try {
+    const value = resolver();
+    return value && String(value).trim() ? value : fallback;
+  } catch {
+    return fallback;
+  }
+}
+
+async function trackInstall(options = {}) {
+  try {
+    if (!telemetryEnabled() || typeof fetch !== "function") {
+      return;
+    }
+
+    const ci = isCi();
+    const payload = {
+      api_key: TELEMETRY_PROJECT_TOKEN,
+      event: TELEMETRY_EVENT,
+      distinct_id: crypto.randomUUID(),
+      properties: {
+        $lib: "nanoagent-installer",
+        install_method: options.method || detectInstallMethod(),
+        nanoagent_version: resolveQuietly(() => platform.resolveTag(), "unknown"),
+        os_family: osFamily(),
+        platform: resolveQuietly(() => platform.resolveRid(), "unknown"),
+        app_surface: "cli",
+        execution_environment: ci ? "ci" : "local",
+        is_ci: ci,
+      },
+    };
+
+    const signal =
+      typeof AbortSignal !== "undefined" && typeof AbortSignal.timeout === "function"
+        ? AbortSignal.timeout(TIMEOUT_MS)
+        : undefined;
+
+    await fetch(`${TELEMETRY_HOST}/i/v0/e/`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(payload),
+      signal,
+    });
+  } catch {
+    // Telemetry must never affect installation.
+  }
+}
+
+module.exports = { trackInstall, detectInstallMethod };