agent-recon 1.0.1

package/installer/steps/welcome.js

@@ -0,0 +1,46 @@
+// Copyright 2026 PNW Great Loop LLC. All rights reserved.
+// Licensed under the Agent Recon™ Commercial License — see LICENSE-COMMERCIAL.
+
+'use strict';
+
+const { confirm } = require('@inquirer/prompts');
+const ui = require('../ui');
+
+const EULA_TEXT = [
+  'Agent Recon\u2122 End User License Agreement',
+  '',
+  'This software is provided under a dual-license model:',
+  '  \u2022 Core components: Apache License 2.0 (see LICENSE)',
+  '  \u2022 LLM analysis, telemetry, installer: Commercial (see LICENSE-COMMERCIAL)',
+  '',
+  'Community tier (free): real-time feed, token tracking, regex security, 7-day retention.',
+  'Personal ($9.99/mo) and Professional ($29/mo) tiers unlock LLM-powered analysis,',
+  'extended retention, OTEL export, and encrypted archives.',
+  '',
+  'You supply your own LLM API key(s). All inference costs are your responsibility.',
+  'Full terms: see EULA.md in the installation directory.',
+  '',
+  'Agent Recon\u2122 is not affiliated with or endorsed by Anthropic PBC.',
+  'Claude and Claude Code are trademarks of Anthropic PBC.',
+].join('\n  ');
+
+async function run(ctx) {
+  ui.banner(ctx.version);
+
+  ui.divider();
+  console.log(`  ${EULA_TEXT}`);
+  ui.divider();
+
+  const accepted = await confirm({ message: 'Do you accept the license terms?' });
+  if (!accepted) {
+    return { success: false, error: 'License terms not accepted' };
+  }
+
+  const telemetryEnabled = await confirm({
+    message: 'Help improve Agent Recon™ by sharing anonymous usage statistics?',
+  });
+
+  return { success: true, eulaAccepted: true, telemetryEnabled };
+}
+
+module.exports = { run };

package/installer/ui.js

@@ -0,0 +1,133 @@
+// Copyright 2026 PNW Great Loop LLC. All rights reserved.
+// Licensed under the Agent Recon™ Commercial License — see LICENSE-COMMERCIAL.
+
+'use strict';
+
+/**
+ * Agent Recon Installer — Terminal UI helpers
+ *
+ * ANSI color output (respects NO_COLOR), step progress, banner, spinner.
+ * Zero dependencies — pure Node stdlib.
+ */
+
+// ── Color support ───────────────────────────────────────────────────────────
+
+const useColor = !process.env.NO_COLOR && process.stdout.isTTY;
+
+const esc = (code, text) => useColor ? `\x1b[${code}m${text}\x1b[0m` : text;
+
+const green  = t => esc('32', t);
+const red    = t => esc('31', t);
+const yellow = t => esc('33', t);
+const cyan   = t => esc('36', t);
+const bold   = t => esc('1', t);
+const dim    = t => esc('2', t);
+
+// ── Output helpers ──────────────────────────────────────────────────────────
+
+function ok(msg)    { console.log(`  ${green('[OK]')}   ${msg}`); }
+function warn(msg)  { console.log(`  ${yellow('[WARN]')} ${msg}`); }
+function error(msg) { console.log(`  ${red('[FAIL]')} ${msg}`); }
+function info(msg)  { console.log(`  ${cyan('[INFO]')} ${msg}`); }
+
+function step(n, total, msg) {
+  const label = dim(`[${n}/${total}]`);
+  console.log(`\n  ${label} ${bold(msg)}`);
+}
+
+function divider() {
+  console.log(dim('  ' + '─'.repeat(68)));
+}
+
+// ── Banner ──────────────────────────────────────────────────────────────────
+
+function banner(version) {
+  const v = version || '1.0.0';
+  console.log('');
+  console.log(bold(cyan('  ╔══════════════════════════════════════════════╗')));
+  console.log(bold(cyan('  ║                                              ║')));
+  console.log(bold(cyan('  ║') + '     Agent Recon' + cyan('™') + '  Installer                ' + cyan('║')));
+  console.log(bold(cyan('  ║') + dim(`     v${v}`)
+    + ' '.repeat(Math.max(0, 40 - v.length - 1)) + cyan('║')));
+  console.log(bold(cyan('  ║                                              ║')));
+  console.log(bold(cyan('  ╚══════════════════════════════════════════════╝')));
+  console.log('');
+}
+
+// ── Environment report ──────────────────────────────────────────────────────
+
+function printEnvReport(env) {
+  divider();
+  console.log(bold('  Environment Detection'));
+  divider();
+
+  const row = (label, value, status) => {
+    const pad = ' '.repeat(Math.max(0, 24 - label.length));
+    const val = value || dim('not found');
+    const tag = status === 'ok' ? green('OK')
+      : status === 'warn' ? yellow('WARN')
+      : status === 'fail' ? red('FAIL')
+      : '';
+    console.log(`  ${label}${pad} ${val}  ${tag}`);
+  };
+
+  row('OS',              env.os, 'ok');
+  row('Architecture',    env.arch, 'ok');
+  row('Node.js',         env.nodeVersion ? `${env.nodeVersion} (${env.nodePath})` : null,
+    env.nodeVersion ? 'ok' : 'fail');
+  row('Python',          env.pythonVersion ? `${env.pythonVersion} (${env.pythonPath})` : null,
+    env.pythonVersion ? 'ok' : 'fail');
+  row('Home directory',  env.home, 'ok');
+  row('Config directory', env.configDir, 'ok');
+  row('Claude settings', env.claudeSettingsExists ? env.claudeSettingsPath : 'not found',
+    env.claudeSettingsExists ? 'ok' : 'warn');
+  row('Credential store', env.credentialBackend, 'ok');
+
+  if (env.existingInstall) {
+    console.log('');
+    row('Existing install', `v${env.existingInstall.version} at ${env.existingInstall.installDir}`, 'ok');
+    row('Hook script',     env.existingInstall.hookScriptCurrent ? 'up to date' : 'outdated',
+      env.existingInstall.hookScriptCurrent ? 'ok' : 'warn');
+    row('Hooks registered', `${env.existingInstall.hooksRegistered}/13`,
+      env.existingInstall.hooksRegistered === 13 ? 'ok' : 'warn');
+    row('Service',         env.existingInstall.serviceInstalled ? 'installed' : 'not installed',
+      env.existingInstall.serviceInstalled ? 'ok' : 'warn');
+    row('Server',          env.existingInstall.serverHealthy ? 'running' : 'not running',
+      env.existingInstall.serverHealthy ? 'ok' : 'warn');
+  } else {
+    console.log('');
+    row('Existing install', 'none (fresh install)', 'ok');
+  }
+
+  divider();
+}
+
+// ── Spinner ─────────────────────────────────────────────────────────────────
+
+function startSpinner(msg) {
+  if (!process.stdout.isTTY) {
+    console.log(`  ${msg}...`);
+    return null;
+  }
+  const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+  let i = 0;
+  return setInterval(() => {
+    process.stdout.write(`\r  ${cyan(frames[i++ % frames.length])} ${msg}`);
+  }, 80);
+}
+
+function stopSpinner(intervalId, successMsg) {
+  if (intervalId) clearInterval(intervalId);
+  if (process.stdout.isTTY) process.stdout.write('\r' + ' '.repeat(60) + '\r');
+  if (successMsg) ok(successMsg);
+}
+
+// ── Exports ─────────────────────────────────────────────────────────────────
+
+module.exports = {
+  green, red, yellow, cyan, bold, dim,
+  ok, warn, error, info,
+  step, divider, banner, printEnvReport,
+  startSpinner, stopSpinner,
+  _useColor: () => useColor,
+};

package/installer/uninstall.js

@@ -0,0 +1,233 @@
+// Copyright 2026 PNW Great Loop LLC. All rights reserved.
+// Licensed under the Agent Recon™ Commercial License — see LICENSE-COMMERCIAL.
+
+'use strict';
+
+/**
+ * Agent Recon Installer — Uninstall Flow (Task 8.4)
+ *
+ * Reads manifest → confirm → stop/remove service → remove hooks from settings →
+ * delete hook script → optionally delete data → delete manifest.
+ */
+
+const fs   = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+const { confirm } = require('@inquirer/prompts');
+const ui       = require('./ui');
+const mnf      = require('./manifest');
+const hooks    = require('./steps/hooks');
+const platform = require('../server/platform');
+
+/**
+ * Run the uninstall flow.
+ * @param {object} env — from detect.detectEnv()
+ */
+async function uninstall(env) {
+  ui.banner();
+
+  ui.step(1, 5, 'Reading installation manifest');
+
+  const m = mnf.readManifest();
+  if (!m) {
+    // Try heuristic
+    if (env.existingInstall && env.existingInstall.hookScriptPath) {
+      ui.warn('No manifest found but hooks were detected heuristically.');
+      ui.info('A fresh "install" followed by "uninstall" would produce a clean removal.');
+      ui.info('Attempting best-effort removal...');
+      await _heuristicUninstall(env);
+      return;
+    }
+    ui.error('No Agent Recon installation found.');
+    return;
+  }
+
+  ui.ok(`Found: v${m.version || 'unknown'} at ${m.installDir || 'unknown'}`);
+
+  // ── Confirm ────────────────────────────────────────────────────────────
+  ui.step(2, 5, 'Confirmation');
+  const proceed = await confirm({
+    message: 'Are you sure you want to uninstall Agent Recon?',
+    default: false,
+  });
+  if (!proceed) {
+    ui.info('Uninstall cancelled.');
+    return;
+  }
+
+  const preserveData = await confirm({
+    message: 'Preserve database and credentials? (Recommended if you plan to reinstall)',
+    default: true,
+  });
+
+  // ── Stop and remove service ────────────────────────────────────────────
+  ui.step(3, 5, 'Removing service');
+  if (m.service && m.service.type && m.service.type !== 'none') {
+    try {
+      _stopAndRemoveService(m.service, env.os);
+      ui.ok(`Removed ${m.service.type} service`);
+    } catch (err) {
+      ui.warn(`Service removal failed: ${err.message}`);
+    }
+  } else {
+    ui.info('No service registered — skipping');
+  }
+
+  // ── Remove hooks from settings.json ────────────────────────────────────
+  ui.step(4, 5, 'Removing hooks');
+  const settingsPath = m.claudeSettingsPath || env.claudeSettingsPath;
+  if (settingsPath && m.hookCommand) {
+    try {
+      _removeHooksFromSettings(settingsPath, m.hookCommand);
+      ui.ok('Removed hook registrations from Claude settings');
+    } catch (err) {
+      ui.warn(`Could not clean settings.json: ${err.message}`);
+    }
+  }
+
+  // Delete hook script
+  const hookDest = m.hookScript && m.hookScript.destination;
+  if (hookDest) {
+    try {
+      fs.unlinkSync(hookDest);
+      ui.ok(`Deleted ${path.basename(hookDest)}`);
+    } catch {
+      ui.warn(`Could not delete hook script: ${hookDest}`);
+    }
+  }
+
+  // ── Data removal ───────────────────────────────────────────────────────
+  ui.step(5, 5, 'Cleaning up');
+  const removed = [];
+  const preserved = [];
+
+  if (!preserveData) {
+    // Delete database
+    if (m.dbPath) {
+      for (const suffix of ['', '-wal', '-shm']) {
+        const dbFile = m.dbPath + suffix;
+        try { fs.unlinkSync(dbFile); removed.push(path.basename(dbFile)); } catch { /* fine */ }
+      }
+    }
+    // Delete credential directory
+    if (m.credentialDir) {
+      try {
+        fs.rmSync(m.credentialDir, { recursive: true, force: true });
+        removed.push('credentials/');
+      } catch { /* fine */ }
+    }
+  } else {
+    if (m.dbPath) preserved.push('database');
+    if (m.credentialDir) preserved.push('credentials');
+  }
+
+  // Delete manifest
+  mnf.deleteManifest();
+  removed.push('manifest.json');
+
+  // Try to clean up empty config dir
+  const confDir = platform.configDir();
+  try {
+    const entries = fs.readdirSync(confDir);
+    if (entries.length === 0) {
+      fs.rmdirSync(confDir);
+      removed.push('config directory');
+    }
+  } catch { /* directory not empty or doesn't exist — fine */ }
+
+  // ── Summary ────────────────────────────────────────────────────────────
+  console.log('');
+  ui.divider();
+  ui.ok('Agent Recon uninstalled');
+  ui.divider();
+  if (removed.length) {
+    ui.info(`Removed: ${removed.join(', ')}`);
+  }
+  if (preserved.length) {
+    ui.info(`Preserved: ${preserved.join(', ')}`);
+  }
+  ui.info('The source directory was NOT removed (it may be a git repo).');
+  ui.divider();
+}
+
+// ── Helpers ─────────────────────────────────────────────────────────────────
+
+function _removeHooksFromSettings(settingsPath, hookCommand) {
+  if (!fs.existsSync(settingsPath)) return;
+  const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+  const cleaned = hooks._removeHooks(settings, hookCommand);
+  const tmpPath = settingsPath + '.tmp';
+  fs.writeFileSync(tmpPath, JSON.stringify(cleaned, null, 2) + '\n', 'utf8');
+  fs.renameSync(tmpPath, settingsPath);
+}
+
+function _stopAndRemoveService(svc, osType) {
+  switch (svc.type) {
+    case 'systemd':
+      execSync('systemctl --user stop agent-recon 2>/dev/null || true', {
+        timeout: 10000, stdio: 'pipe', shell: true,
+      });
+      execSync('systemctl --user disable agent-recon 2>/dev/null || true', {
+        timeout: 10000, stdio: 'pipe', shell: true,
+      });
+      if (svc.path && fs.existsSync(svc.path)) {
+        fs.unlinkSync(svc.path);
+      }
+      execSync('systemctl --user daemon-reload', { timeout: 10000, stdio: 'pipe' });
+      break;
+
+    case 'launchd':
+      if (svc.path && fs.existsSync(svc.path)) {
+        try { execSync(`launchctl unload "${svc.path}"`, { timeout: 10000, stdio: 'pipe' }); } catch { /* fine */ }
+        fs.unlinkSync(svc.path);
+      }
+      break;
+
+    case 'nssm': {
+      const ps = osType === 'wsl'
+        ? '/mnt/c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe'
+        : 'powershell.exe';
+      try {
+        execSync(`"${ps}" -NoProfile -Command "Stop-Service AgentRecon -ErrorAction SilentlyContinue"`,
+          { timeout: 10000, stdio: 'pipe', shell: true });
+        execSync(`nssm remove AgentRecon confirm`, { timeout: 10000, stdio: 'pipe' });
+      } catch { /* best effort */ }
+      break;
+    }
+  }
+}
+
+async function _heuristicUninstall(env) {
+  const existing = env.existingInstall;
+  if (!existing) return;
+
+  // Try to find and remove hook command from settings
+  const settingsPath = env.claudeSettingsPath;
+  if (settingsPath && fs.existsSync(settingsPath)) {
+    try {
+      const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+      const { _findHookCommand } = require('./detect');
+      const hookCmd = _findHookCommand(settings);
+      if (hookCmd) {
+        _removeHooksFromSettings(settingsPath, hookCmd);
+        ui.ok('Removed hook registrations from settings');
+      }
+    } catch (err) {
+      ui.warn(`Could not clean settings: ${err.message}`);
+    }
+  }
+
+  // Delete hook script
+  if (existing.hookScriptPath && fs.existsSync(existing.hookScriptPath)) {
+    try {
+      fs.unlinkSync(existing.hookScriptPath);
+      ui.ok(`Deleted ${path.basename(existing.hookScriptPath)}`);
+    } catch {
+      ui.warn(`Could not delete: ${existing.hookScriptPath}`);
+    }
+  }
+
+  ui.ok('Best-effort removal complete');
+}
+
+module.exports = uninstall;