robot-resources 1.15.1 → 1.15.3

package/lib/non-oc-wizard.js

@@ -1,615 +0,0 @@
-import { existsSync, readFileSync } from 'node:fs';
-import { extname, isAbsolute, join, resolve } from 'node:path';
-import { homedir } from 'node:os';
-import { select, input } from '@inquirer/prompts';
-import { isClaudeCodeInstalled, isCursorInstalled, detectAgentRuntime } from './detect.js';
-import { configureClaudeCode, configureCursor } from './tool-config.js';
-import { header, info, success, warn, blank, confirm } from './ui.js';
-import { readConfig } from './config.mjs';
-import { installNodeShim } from './install-node-shim.js';
-import { installPythonShim } from './install-python-shim.js';
-import {
-  findAgentSourceFile,
-  hasSourceMarker,
-  writeSourceMarker,
-  previewInjection,
-  pathForTelemetry,
-} from './source-edit-attach.js';
-
-const PLATFORM_URL = process.env.RR_PLATFORM_URL || 'https://api.robotresources.ai';
-
-const PATH_LABELS = {
-  js: 'JS/TS agent (LangChain, LangGraph, Mastra, etc.)',
-  python: 'Python agent (LangChain, LlamaIndex, CrewAI, etc.)',
-  mcp: 'Cursor / Claude Code / other MCP tool',
-  docs: "Just point me at docs, I'll integrate manually",
-  'install-oc': 'Install OpenClaw first — exit',
-};
-
-const VALID_TARGETS = new Set(Object.keys(PATH_LABELS).concat(['langchain', 'claude-code']));
-
-/**
- * Inspect cwd to guess what the user is building. Returns one of the path
- * keys, or null if we can't tell. Order matters: detect-by-file beats
- * detect-by-installed-tool, since cwd evidence is stronger than "the user
- * has Cursor installed somewhere on this machine."
- */
-export function detectDefaultPath(cwd = process.cwd()) {
-  const pkgPath = join(cwd, 'package.json');
-  if (existsSync(pkgPath)) {
-    try {
-      const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
-      const allDeps = {
-        ...(pkg.dependencies ?? {}),
-        ...(pkg.devDependencies ?? {}),
-      };
-      const jsAgentMarkers = ['langchain', '@langchain/core', '@langchain/langgraph', '@mastra/core', 'crewai-js', 'llamaindex'];
-      if (jsAgentMarkers.some((m) => Object.prototype.hasOwnProperty.call(allDeps, m))) {
-        return 'js';
-      }
-      // Generic JS project still defaults to JS (cheaper than asking).
-      return 'js';
-    } catch {
-      // fall through
-    }
-  }
-
-  if (existsSync(join(cwd, 'requirements.txt')) || existsSync(join(cwd, 'pyproject.toml'))) {
-    return 'python';
-  }
-
-  if (isCursorInstalled() || isClaudeCodeInstalled()) {
-    return 'mcp';
-  }
-
-  return null;
-}
-
-function normalizeTarget(target) {
-  if (!target) return null;
-  const t = String(target).toLowerCase();
-  if (!VALID_TARGETS.has(t)) return null;
-  // Aliases — friendly synonyms map to canonical path keys.
-  if (t === 'langchain') return 'js';
-  if (t === 'claude-code') return 'mcp';
-  return t;
-}
-
-async function emitPathChosen(path) {
-  const config = readConfig();
-  if (!config.api_key) return; // wizard didn't get to provision; can't authenticate
-  try {
-    await fetch(`${PLATFORM_URL}/v1/telemetry`, {
-      method: 'POST',
-      headers: {
-        Authorization: `Bearer ${config.api_key}`,
-        'Content-Type': 'application/json',
-      },
-      body: JSON.stringify({
-        product: 'cli',
-        event_type: 'wizard_path_chosen',
-        payload: { path, platform: process.platform },
-      }),
-      signal: AbortSignal.timeout(5_000),
-    });
-  } catch {
-    // Best-effort — never let telemetry break the install path.
-  }
-}
-
-async function emitNodeEntryPatched(payload) {
-  const config = readConfig();
-  if (!config.api_key) return;
-  try {
-    await fetch(`${PLATFORM_URL}/v1/telemetry`, {
-      method: 'POST',
-      headers: {
-        Authorization: `Bearer ${config.api_key}`,
-        'Content-Type': 'application/json',
-      },
-      body: JSON.stringify({
-        product: 'cli',
-        event_type: 'node_entry_patched',
-        payload: { ...payload, platform: process.platform },
-      }),
-      signal: AbortSignal.timeout(5_000),
-    });
-  } catch {
-    // Best-effort — never let telemetry break the install path.
-  }
-}
-
-const VALID_SOURCE_EXTS = new Set(['.js', '.mjs', '.cjs', '.ts', '.tsx', '.jsx']);
-
-/**
- * Expand `~` to $HOME. Same trick shells use. Anything else (env vars,
- * `..` segments) we leave to `path.resolve` to handle.
- */
-function expandPath(raw, cwd) {
-  let p = raw.trim();
-  if (p === '~') p = homedir();
-  else if (p.startsWith('~/') || p.startsWith('~\\')) p = join(homedir(), p.slice(2));
-  if (!isAbsolute(p)) p = resolve(cwd, p);
-  return p;
-}
-
-/**
- * Phase 11 + 11.1 — offer to inject `require('@robot-resources/router/auto')`
- * (or ESM equivalent) at the top of the user's entry file. Phase 11 wrote
- * the plumbing; Phase 11.1 swaps the package.json-gated detector for an
- * SDK-import scanner that finds files actually talking to AI models.
- *
- * Why source-edit at all: NODE_OPTIONS in shell config never reaches cron /
- * Docker / systemd / Lambda agents because those launchers don't read shell
- * rc files. A line in the source survives any launcher.
- *
- * Decision matrix (now driven by findAgentSourceFile):
- *   - 0 SDK files found → free-text path prompt (interactive) or skip (CI)
- *   - 1 candidate            → preview + Y/N (skip the chooser)
- *   - 2+, clear winner      → preview winner + Y/N (skip the chooser)
- *   - 2+, ambiguous          → select() chooser, then Y/N
- *   - Marker already present → skip silently
- *   - Non-interactive without `autoAttachSource` → skip with a hint
- *
- * Source files are sacred — every accept path goes through Y/N (or the
- * explicit `--auto-attach-source` opt-in for CI).
- */
-async function maybeInjectSourceEdit({ nonInteractive, autoAttachSource, cwd = process.cwd() } = {}) {
-  const scan = findAgentSourceFile(cwd);
-  const baseTelemetry = {
-    candidates_scanned: scan.scanned,
-    total_files_walked: scan.walked,
-    winner_score: scan.candidates[0]?.score ?? null,
-    runner_up_score: scan.candidates[1]?.score ?? null,
-  };
-
-  // ── 0 candidates ───────────────────────────────────────────────────────
-  if (!scan.winner) {
-    if (nonInteractive) {
-      blank();
-      info(`We scanned ${scan.walked} source files and found no AI SDK imports.`);
-      info('Add this line manually at the top of your agent entry file:');
-      info("  require('@robot-resources/router/auto');   // CJS, or import '...' for ESM/TS");
-      await emitNodeEntryPatched({ ...baseTelemetry, outcome: 'no_sdk_imports_found' });
-      return;
-    }
-
-    // Interactive 0-candidate: ask the user to point us at the file.
-    blank();
-    info(`We scanned ${scan.walked} source files in this directory and found no AI SDK imports.`);
-    blank();
-    let raw;
-    try {
-      raw = await input({
-        message: 'Path to your agent file (or press Enter to skip):',
-        default: '',
-      });
-    } catch {
-      // Ctrl-C or terminal closed.
-      await emitNodeEntryPatched({ ...baseTelemetry, outcome: 'declined_path_prompt' });
-      return;
-    }
-    if (!raw || !raw.trim()) {
-      await emitNodeEntryPatched({ ...baseTelemetry, outcome: 'declined_path_prompt' });
-      return;
-    }
-
-    const target = expandPath(raw, cwd);
-    if (!existsSync(target)) {
-      warn(`File does not exist: ${target}`);
-      await emitNodeEntryPatched({ ...baseTelemetry, outcome: 'failed', error: 'path_missing' });
-      return;
-    }
-    if (!VALID_SOURCE_EXTS.has(extname(target).toLowerCase())) {
-      warn(`Refusing to edit ${extname(target)} — only .js/.mjs/.cjs/.ts/.tsx/.jsx are supported.`);
-      await emitNodeEntryPatched({ ...baseTelemetry, outcome: 'failed', error: 'invalid_extension' });
-      return;
-    }
-    if (hasSourceMarker(target)) {
-      info(`${pathForTelemetry(target, cwd)} already has the auto-attach line — leaving it as-is.`);
-      await emitNodeEntryPatched({ ...baseTelemetry, outcome: 'already_present', entry_path: pathForTelemetry(target, cwd) });
-      return;
-    }
-
-    // Outside-cwd: extra confirmation. The user meant a path relative to
-    // their project; if they typed something far away, double-check.
-    const isOutsideCwd = !target.startsWith(cwd + '/') && target !== cwd;
-    if (isOutsideCwd) {
-      const ok = await confirm(`${target} is outside your current directory. Edit it anyway?`, { defaultYes: false });
-      if (!ok) {
-        await emitNodeEntryPatched({ ...baseTelemetry, outcome: 'declined_path_prompt' });
-        return;
-      }
-    }
-
-    return await applyInjection({
-      target,
-      cwd,
-      nonInteractive,
-      autoAttachSource,
-      baseTelemetry,
-      viaPrompt: true,
-    });
-  }
-
-  // ── 1+ candidates ──────────────────────────────────────────────────────
-  const winnerPath = scan.winner;
-
-  if (hasSourceMarker(winnerPath)) {
-    info(`${pathForTelemetry(winnerPath, cwd)} already has the auto-attach line — leaving it as-is.`);
-    await emitNodeEntryPatched({
-      ...baseTelemetry,
-      outcome: 'already_present',
-      entry_path: pathForTelemetry(winnerPath, cwd),
-    });
-    return;
-  }
-
-  if (nonInteractive && !autoAttachSource) {
-    blank();
-    info('Skipping source-attach in non-interactive mode (auto-rewriting source needs consent).');
-    info(`To enable it in CI, re-run with:  npx robot-resources --for=langchain --auto-attach-source`);
-    info(`Or add this line manually at the top of ${pathForTelemetry(winnerPath, cwd)}:`);
-    info("  require('@robot-resources/router/auto');   // CJS, or import '...' for ESM/TS");
-    await emitNodeEntryPatched({
-      ...baseTelemetry,
-      outcome: 'skipped_non_interactive',
-      entry_path: pathForTelemetry(winnerPath, cwd),
-    });
-    return;
-  }
-
-  // Resolve the actual target. Skip the chooser when winner is unambiguous —
-  // most users see exactly one Y/N.
-  let target = winnerPath;
-  if (!nonInteractive && scan.ambiguous && scan.candidates.length > 1) {
-    const choices = scan.candidates.slice(0, 6).map((c) => ({
-      name: `${pathForTelemetry(c.path, cwd)}  (score ${c.score})`,
-      value: c.path,
-    }));
-    choices.push({ name: 'Skip — I\'ll add the line manually', value: '__skip__' });
-    try {
-      target = await select({
-        message: 'Multiple files import an AI SDK. Which one is your agent?',
-        default: winnerPath,
-        choices,
-      });
-    } catch {
-      await emitNodeEntryPatched({ ...baseTelemetry, outcome: 'declined' });
-      return;
-    }
-    if (target === '__skip__') {
-      await emitNodeEntryPatched({ ...baseTelemetry, outcome: 'declined' });
-      return;
-    }
-  }
-
-  return await applyInjection({
-    target,
-    cwd,
-    nonInteractive,
-    autoAttachSource,
-    baseTelemetry,
-    viaPrompt: false,
-  });
-}
-
-/**
- * Common write path used by both the "winner detected" and "user typed a
- * path" branches. Shows the diff, asks Y/N (unless --auto-attach-source),
- * writes the marker, emits telemetry. Single source of truth so the two
- * branches can't drift.
- */
-async function applyInjection({ target, cwd, nonInteractive, autoAttachSource, baseTelemetry, viaPrompt }) {
-  const preview = previewInjection(target);
-  blank();
-  success('Add the auto-attach line so routing also works under cron / Docker / systemd / Lambda?');
-  blank();
-  info(`File: ${pathForTelemetry(target, cwd)}`);
-  blank();
-  for (const line of preview.split('\n')) info(line);
-  blank();
-
-  let proceed = autoAttachSource;
-  if (!nonInteractive && !autoAttachSource) {
-    proceed = await confirm('Add the line?', { defaultYes: true });
-  }
-
-  if (!proceed) {
-    info('Skipped — you can re-run anytime.');
-    await emitNodeEntryPatched({
-      ...baseTelemetry,
-      outcome: 'declined',
-      entry_path: pathForTelemetry(target, cwd),
-    });
-    return;
-  }
-
-  const result = writeSourceMarker(target);
-  if (result.ok) {
-    success(`Added the auto-attach line to ${pathForTelemetry(target, cwd)} (${result.syntax}).`);
-    if (result.backupWritten) info(`  Backup written to ${pathForTelemetry(`${target}.rr-backup`, cwd)}`);
-    info('Now your agent loads the router on every startup — no env vars, no terminal restart.');
-    await emitNodeEntryPatched({
-      ...baseTelemetry,
-      outcome: viaPrompt ? 'patched_via_prompt' : 'patched',
-      entry_path: pathForTelemetry(target, cwd),
-      import_syntax: result.syntax,
-      backup_written: !!result.backupWritten,
-    });
-  } else {
-    warn(`Could not patch ${pathForTelemetry(target, cwd)}: ${result.error}`);
-    info('You can add the line yourself — see the snippet above.');
-    await emitNodeEntryPatched({
-      ...baseTelemetry,
-      outcome: 'failed',
-      entry_path: pathForTelemetry(target, cwd),
-      error: result.error,
-    });
-  }
-}
-
-async function showJsPath({ nonInteractive = false, autoAttachSource = false } = {}) {
-  blank();
-  success('JS/TS integration');
-  blank();
-
-  const result = await installNodeShim();
-  if (result.ok) {
-    if (result.already) {
-      info(result.message);
-    } else {
-      success(result.message);
-      for (const path of result.written ?? []) {
-        info(`  • ${path}`);
-      }
-    }
-    blank();
-    info('Phase 3+ NODE_OPTIONS shim installed. Works for desktop dev sessions');
-    info('after a terminal restart, but does NOT reach cron / Docker / systemd /');
-    info('Lambda. The next step adds a one-line require to your agent source so');
-    info('routing works regardless of how the process is launched.');
-  } else {
-    warn(result.message);
-    blank();
-    if (process.platform === 'win32') {
-      info('Manual install: in a new cmd, run:');
-      info('  setx NODE_OPTIONS "--require %USERPROFILE%\\.robot-resources\\router\\auto.cjs"');
-    } else {
-      info('Manual install (paste into ~/.zshrc or ~/.bashrc):');
-      info('  export NODE_OPTIONS="${NODE_OPTIONS:-} --require ~/.robot-resources/router/auto.cjs"');
-    }
-  }
-
-  // Phase 11 — source-edit injection. Reaches cron / Docker / systemd / Lambda
-  // since the line lives in the user's source, not in shell config.
-  await maybeInjectSourceEdit({ nonInteractive, autoAttachSource });
-
-  blank();
-  info('Docs: https://robotresources.ai/docs/langchain');
-  blank();
-}
-
-async function showPythonPath() {
-  blank();
-  success('Python integration');
-  blank();
-
-  const result = await installPythonShim();
-  if (result.ok) {
-    success(result.message);
-    if (result.sdks?.length) {
-      info(`  Detected SDKs: ${result.sdks.join(', ')}`);
-    }
-    blank();
-    info('Run your Python agent — every anthropic / openai / google_generativeai');
-    info('SDK call routes through Robot Resources automatically.');
-    info('To opt out for a single command: RR_AUTOATTACH=0 python your-script.py');
-  } else {
-    warn(result.message);
-    blank();
-    info('Manual install (run inside your venv):');
-    info('  pip install --upgrade robot-resources');
-  }
-  blank();
-  info('Docs: https://robotresources.ai/docs/crewai');
-  blank();
-}
-
-function showMcpPath() {
-  blank();
-  success('MCP tool integration');
-  blank();
-  let cursorOk = false;
-  let claudeOk = false;
-  if (isCursorInstalled()) {
-    try {
-      const result = configureCursor();
-      cursorOk = result?.action === 'configured' || result?.action === 'already_configured';
-      info(`Cursor: ${cursorOk ? 'configured' : 'see manual instructions below'}`);
-    } catch {
-      warn('Cursor: failed to write ~/.cursor/mcp.json automatically');
-    }
-  }
-  if (isClaudeCodeInstalled()) {
-    try {
-      const result = configureClaudeCode();
-      claudeOk = result?.action === 'configured' || result?.action === 'already_configured';
-      info(`Claude Code: ${claudeOk ? 'configured' : 'see manual instructions below'}`);
-    } catch {
-      warn('Claude Code: failed to write ~/.claude/settings.json automatically');
-    }
-  }
-  if (!cursorOk && !claudeOk) {
-    info('We did not detect Cursor or Claude Code on this machine.');
-    info('Manual setup: https://robotresources.ai/docs/cursor-mcp');
-  }
-  blank();
-}
-
-function showDocsPath() {
-  blank();
-  success('Docs');
-  blank();
-  info('Integration guides: https://robotresources.ai/docs');
-  info('HTTP API:          https://robotresources.ai/docs/http-api');
-  info('GitHub:            https://github.com/robot-resources/packages');
-  blank();
-}
-
-function showInstallOcPath() {
-  blank();
-  info('OpenClaw is the easiest way to use Robot Resources.');
-  info('Install OpenClaw first (https://openclaw.dev), then re-run:');
-  info('  npx robot-resources');
-  blank();
-}
-
-async function runPath(path, opts = {}) {
-  switch (path) {
-    case 'js': await showJsPath(opts); break;
-    case 'python': await showPythonPath(); break;
-    case 'mcp': showMcpPath(); break;
-    case 'docs': showDocsPath(); break;
-    case 'install-oc': showInstallOcPath(); break;
-    default: showInstallOcPath(); break;
-  }
-}
-
-/**
- * Runs the non-OC wizard. Three modes:
- * - target supplied (--for=<target>): run that path directly, no prompt
- * - non-interactive AND no target: print hint with --for= options and exit
- * - interactive: 5-option menu via @inquirer/prompts.select
- */
-export async function runNonOcWizard({ nonInteractive = false, target = null, autoAttachSource = false } = {}) {
-  const normalized = normalizeTarget(target);
-
-  if (normalized) {
-    await runPath(normalized, { nonInteractive, autoAttachSource });
-    await emitPathChosen(normalized);
-    return;
-  }
-
-  if (nonInteractive) {
-    // Phase 3.5: when project shape is unambiguous (cwd has a package.json
-    // OR a Python project file), auto-install the matching shim instead of
-    // bailing with a hint. CI/agents running `npx robot-resources` from
-    // their repo are exactly this case — making them pass `--for=` is
-    // friction we don't need.
-    //
-    // The Phase 3 noninteractive_no_target path is preserved for the case
-    // where detection finds nothing (truly empty cwd, generic shell run).
-    const runtime = detectAgentRuntime();
-    let autoTarget = null;
-    if (runtime.kind === 'node' || runtime.kind === 'both') autoTarget = 'js';
-    else if (runtime.kind === 'python') autoTarget = 'python';
-
-    if (autoTarget) {
-      // Brief context so the install step doesn't feel sudden.
-      info(`Detected a ${autoTarget === 'js' ? 'Node' : 'Python'} project — installing the matching shim automatically.`);
-      info('  Pass --for=<other> to override, or --uninstall to remove later.');
-      blank();
-      await runPath(autoTarget, { nonInteractive, autoAttachSource });
-      await emitPathChosen(autoTarget);
-      return;
-    }
-
-    info('Robot Resources requires OpenClaw, which we did not detect on this machine.');
-    info('To bypass this prompt in CI / non-TTY contexts, re-run with --for=<target>:');
-    info('  npx robot-resources --for=langchain      # JS/TS agent');
-    info('  npx robot-resources --for=python         # Python agent');
-    info('  npx robot-resources --for=cursor         # Cursor MCP config');
-    info('  npx robot-resources --for=claude-code    # Claude Code MCP config');
-    info('  npx robot-resources --for=docs           # docs URL');
-    blank();
-    await emitPathChosen('noninteractive_no_target');
-    return;
-  }
-
-  // Interactive menu.
-  header();
-  info('Robot Resources requires OpenClaw, which we did not detect on this machine.');
-  info('What are you building? Pick the closest match — we\'ll show the install steps.');
-  blank();
-
-  const defaultPath = detectDefaultPath() ?? 'js';
-
-  // Phase 3.6: race the prompt against a timeout. Some agent runners report
-  // stdin.isTTY=true (so `nonInteractive` ends up false), then never deliver
-  // a keystroke — `select()` blocks forever and the wizard exits silently
-  // without firing wizard_path_chosen. The May-2 23:31 RU cluster all hit
-  // this: 5 wizard_started events, zero wizard_path_chosen.
-  //
-  // After SELECT_TIMEOUT_MS, we treat the session as practically
-  // non-interactive and fall through to the same auto-detect path the
-  // nonInteractive branch above uses (Phase 3.5).
-  const SELECT_TIMEOUT_MS = Number(process.env.RR_WIZARD_SELECT_TIMEOUT_MS) || 30_000;
-  const TIMED_OUT = Symbol('select_timeout');
-
-  let chosen;
-  let timer;
-  try {
-    chosen = await Promise.race([
-      select({
-        message: 'What are you building?',
-        default: defaultPath,
-        choices: [
-          { name: PATH_LABELS.js, value: 'js' },
-          { name: PATH_LABELS.python, value: 'python' },
-          { name: PATH_LABELS.mcp, value: 'mcp' },
-          { name: PATH_LABELS.docs, value: 'docs' },
-          { name: PATH_LABELS['install-oc'], value: 'install-oc' },
-        ],
-      }),
-      new Promise((resolve) => {
-        timer = setTimeout(() => resolve(TIMED_OUT), SELECT_TIMEOUT_MS);
-        // Don't keep the event loop alive purely for this timer — once the
-        // user picks, the process should be free to exit.
-        if (typeof timer.unref === 'function') timer.unref();
-      }),
-    ]);
-  } catch (err) {
-    // User hit Ctrl-C or terminal closed — exit cleanly, but mark the funnel
-    // so we can distinguish "agent shown the prompt and bailed" from
-    // "wizard never reached the prompt at all" in Supabase.
-    if (err && (err.name === 'ExitPromptError' || err.code === 'ABORT_ERR')) {
-      await emitPathChosen('aborted');
-      return;
-    }
-    throw err;
-  } finally {
-    if (timer) clearTimeout(timer);
-  }
-
-  if (chosen === TIMED_OUT) {
-    // No keystroke after SELECT_TIMEOUT_MS — practically non-interactive.
-    // Mirror the Phase 3.5 auto-detect logic.
-    blank();
-    info(`No input received after ${Math.round(SELECT_TIMEOUT_MS / 1000)}s — treating session as non-interactive.`);
-    const runtime = detectAgentRuntime();
-    let autoTarget = null;
-    if (runtime.kind === 'node' || runtime.kind === 'both') autoTarget = 'js';
-    else if (runtime.kind === 'python') autoTarget = 'python';
-
-    if (autoTarget) {
-      info(`Detected a ${autoTarget === 'js' ? 'Node' : 'Python'} project — installing the matching shim automatically.`);
-      blank();
-      // Treat the timed-out interactive session as non-interactive for the
-      // source-edit step too — we don't have a TTY to ask the Y/N on.
-      await runPath(autoTarget, { nonInteractive: true, autoAttachSource });
-      await emitPathChosen(autoTarget);
-      return;
-    }
-
-    // Truly empty cwd — nothing to install. Surface the timeout so the
-    // funnel can be queried separately from genuine aborts.
-    blank();
-    info('No project shape detected — nothing to install. Re-run with --for=<target>.');
-    await emitPathChosen('interactive_timeout');
-    return;
-  }
-
-  await runPath(chosen, { nonInteractive, autoAttachSource });
-  await emitPathChosen(chosen);
-}