robot-resources 1.9.1 → 1.9.2

package/lib/wizard.js

@@ -9,6 +9,40 @@ import { installService, isServiceRunning, isServiceInstalled } from './service.
 import { configureToolRouting, registerScraperMcp, restartOpenClawGateway } from './tool-config.js';
 import { checkHealth } from './health-report.js';
 import { header, step, success, warn, error, info, blank, summary } from './ui.js';
+/**
+ * Classify an install error into a short reason code + bounded detail string.
+ *
+ * Before this existed, install_complete telemetry reported router:false with
+ * no context — 100% of rr-router installs failed and we couldn't diagnose.
+ * The reason code slots into a small enum so we can aggregate in the admin
+ * dashboard; detail is the tail of stderr/error message for deep-dives.
+ */
+function classifyRouterError(err) {
+  const msg = (err?.message || String(err)).toLowerCase();
+  let reason = 'unknown';
+
+  if (msg.includes('python 3.10+') || msg.includes('python is required')) {
+    reason = 'python_not_found';
+  } else if (err?.code === 'ENOENT' || msg.includes('enoent')) {
+    reason = 'spawn_enoent';
+  } else if (msg.includes('timeout') || msg.includes('timed out') || err?.code === 'ETIMEDOUT') {
+    reason = 'timeout';
+  } else if (msg.includes('exited with code') || msg.includes('pip install')) {
+    reason = 'pip_install_failed';
+  } else if (msg.includes('permission denied') || err?.code === 'EACCES') {
+    reason = 'permission_denied';
+  } else if (msg.includes('disk') || msg.includes('space') || err?.code === 'ENOSPC') {
+    reason = 'disk_full';
+  } else if (msg.includes('network') || msg.includes('getaddrinfo') || msg.includes('enetunreach')) {
+    reason = 'network';
+  }
+
+  const rawDetail = err?.stderr?.trim?.() || err?.message || String(err);
+  const detail = rawDetail.slice(-500);
+
+  return { reason, detail, exitCode: err?.exitCode ?? null };
+}
+
 /**
  * Main setup wizard. Handles the full onboarding flow:
  * 1. Router installation (Python venv + pip)
@@ -128,6 +162,8 @@ export async function runWizard({ nonInteractive = false } = {}) {
       warn('Python 3.10+ not found — skipping Router installation');
       info('Install Python from https://python.org and re-run this wizard');
       info('Scraper works without Python');
+      // Record the reason so install_complete tells us why router=false.
+      results.routerError = { reason: 'python_not_found', detail: 'Python 3.10+ not detected on PATH' };
     } else {
       info(`Found Python ${python.version} (${python.bin})`);
       step('Installing Router (this may take a moment)...');
@@ -138,7 +174,7 @@ export async function runWizard({ nonInteractive = false } = {}) {
         results.router = true;
       } catch (err) {
         error(`Router installation failed: ${err.message}`);
-        results.routerError = 'install-failed';
+        results.routerError = classifyRouterError(err);
       }
     }
   }
@@ -298,15 +334,21 @@ export async function runWizard({ nonInteractive = false } = {}) {
     try {
       const config = readConfig();
       const platformUrl = process.env.RR_PLATFORM_URL || 'https://api.robotresources.ai';
+      const installPayload = {
+        router: results.router || false,
+        service: results.service || false,
+        scraper: results.scraper || false,
+        source: 'wizard',
+      };
+      if (results.routerError && typeof results.routerError === 'object') {
+        installPayload.routerError = results.routerError.reason;
+        installPayload.routerErrorDetail = results.routerError.detail;
+        installPayload.platform = process.platform;
+      }
       const body = JSON.stringify({
         product: 'cli',
         event_type: 'install_complete',
-        payload: {
-          router: results.router || false,
-          service: results.service || false,
-          scraper: results.scraper || false,
-          source: 'wizard',
-        },
+        payload: installPayload,
       });
 
       for (let attempt = 0; attempt < 2; attempt++) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "robot-resources",
-  "version": "1.9.1",
+  "version": "1.9.2",
   "description": "Robot Resources — AI agent tools. One command to install everything.",
   "type": "module",
   "bin": {