pando-ai 0.0.15 → 0.0.17

package/README.md

@@ -1,11 +1,13 @@
-# pando-ai CLI
+# pandō CLI
 
-`pando-ai` is the standalone MCP CLI for the shared Pando engine runtime.
+`pando-ai` is the standalone MCP CLI for the shared pandō engine runtime.
 
 It starts the same core indexing and tool runtime used by the VS Code extension, but runs headlessly for terminal agents and local MCP clients.
 
 ## Install
 
+Requires Node.js `22.5.0` or newer.
+
 Run without installing globally:
 
 ```bash
@@ -30,7 +32,7 @@ pando-ai --help
 ## Commands
 
 - `pando-ai [project-path]` starts the engine for the given path, or the current working directory.
-- `pando config set telemetry false` disables anonymous telemetry.
+- `pando-ai config set telemetry false` disables usage telemetry.
 
 ## Transport behavior
 
@@ -52,25 +54,23 @@ If no known agent is detected, the CLI still prints a generic MCP config snippet
 
 ## Telemetry
 
-The CLI sends anonymous usage telemetry by default. It is non-blocking and can be disabled with:
+The CLI sends usage telemetry by default. It is non-blocking and can be disabled with:
 
 ```bash
-pando config set telemetry false
+pando-ai config set telemetry false
 ```
 
 Telemetry includes:
 
-- operating system
-- CPU architecture
-- Node version
-- pando version
-- project file count
-- detected agent names
-- operation names
-- hashed project path
+- operation name, success/failure, and duration
+- file and symbol counts (not names or contents)
+- HMAC-hashed project path (not the raw path)
+- MCP client name and version (e.g. "claude-code 1.x")
+- a stable install ID and per-session ID
+- your authenticated user ID (derived server-side from your login session)
 - event timestamp
 
-The CLI does not send source code contents.
+The CLI does not send source code, file paths, file names, or symbol names.
 
 ## Support level
 

package/bin/pando-ai.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+
+function parseNodeVersion(version) {
+  const match = /^v?(\d+)\.(\d+)\.(\d+)/.exec(version || "");
+  if (!match) {
+    return null;
+  }
+  return {
+    major: Number(match[1]),
+    minor: Number(match[2]),
+    patch: Number(match[3]),
+  };
+}
+
+function isSupportedNode(version) {
+  if (!version) {
+    return false;
+  }
+  if (version.major > 22) {
+    return true;
+  }
+  if (version.major < 22) {
+    return false;
+  }
+  return version.minor >= 5;
+}
+
+const current = parseNodeVersion(process.version);
+if (!isSupportedNode(current)) {
+  const detected = current ? `${current.major}.${current.minor}.${current.patch}` : process.version;
+  console.error(
+    `[pando] pando-ai requires Node.js 22.5.0 or newer. Detected ${detected}.\n` +
+      "[pando] Upgrade Node, then re-run `npx -y pando-ai`.",
+  );
+  process.exit(1);
+}
+
+require("../dist/cli.js");