wolverine-ai 2.3.2 → 2.4.0

package/README.md

@@ -448,6 +448,29 @@ server/config/settings.json    ← Everything else (models, port, clustering, te
 
 ---
 
+## Auto-Update
+
+Wolverine checks npm for new versions hourly and upgrades itself automatically. Config files are protected — backed up before update, restored after.
+
+```json
+// server/config/settings.json
+{
+  "autoUpdate": {
+    "enabled": true,       // set false to disable
+    "intervalMs": 3600000  // check interval (default: 1 hour)
+  }
+}
+```
+
+**How it works:**
+- Checks `npm view wolverine-ai version` against installed version
+- If newer: backs up `settings.json`, `.env.local`, `.env` → runs `npm install wolverine-ai@latest` → restores configs → restarts
+- Protected files never overwritten during update
+- First check 30s after startup, then every hour
+- **Disable:** `"autoUpdate": { "enabled": false }` or `WOLVERINE_AUTO_UPDATE=false`
+
+---
+
 ## Platform Telemetry
 
 Every wolverine instance automatically broadcasts health data to the analytics platform. **Zero config** — telemetry is on by default.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wolverine-ai",
-  "version": "2.3.2",
+  "version": "2.4.0",
   "description": "Self-healing Node.js server framework powered by AI. Catches crashes, diagnoses errors, generates fixes, verifies, and restarts — automatically.",
   "main": "src/index.js",
   "bin": {

package/server/config/settings.json

@@ -79,6 +79,11 @@
     "cooldownMs": 60000
   },
 
+  "autoUpdate": {
+    "enabled": true,
+    "intervalMs": 3600000
+  },
+
   "dashboard": {},
 
   "cors": {

package/src/brain/brain.js

@@ -235,6 +235,10 @@ const SEED_DOCS = [
     text: "Dependency manager skill (src/skills/deps.js): structured npm dependency analysis + repair. diagnose(errorMessage, cwd) returns {diagnosed, category, summary, fixes} — categories: missing_install, missing_package, version_conflict, outdated_api, corrupted_modules. healthReport(cwd) returns full health check: npm audit (vulnerabilities), outdated packages, peer dep conflicts, unused packages, lock file status, health score 0-100. getMigration(packageName) returns known upgrade paths: express→fastify (5.6x faster), moment→dayjs (2KB vs 70KB), request→node-fetch (deprecated), body-parser→built-in, callbacks→async/await. Agent tools: audit_deps (full health check), check_migration (upgrade paths). Heal pipeline uses diagnose() in tryOperationalFix before AI — zero tokens for dependency issues.",
     metadata: { topic: "skill-deps" },
   },
+  {
+    text: "Auto-update: wolverine checks npm registry hourly for new versions. When found, runs npm install wolverine-ai@latest, backs up settings.json/.env.local before update and restores after. Config: autoUpdate.enabled (default true) in settings.json. Disable with WOLVERINE_AUTO_UPDATE=false env var. On successful update, signals runner to restart. Protected files never overwritten: settings.json, .env.local, .env, db.js. Update check runs 30s after startup then every hour (configurable via autoUpdate.intervalMs).",
+    metadata: { topic: "auto-update" },
+  },
   {
     text: "Cost optimization: 7 techniques reduce heal cost from $0.31 to $0.02 for simple errors. (1) Verifier skips route probe for simple errors (TypeError/ReferenceError/SyntaxError) — trusts syntax+boot, ErrorMonitor is safety net. Prevents false-rejection cascades. (2) Sub-agents use Haiku (classifier model) for explore/plan/verify/research — only fixer uses Sonnet/Opus. 6 Haiku calls=$0.006 vs 6 Sonnet calls=$0.12. (3) Agent context compacted every 3 turns using compacting model — prevents 15K→95K token blowup. (4) Brain checked for cached fix patterns before AI — repeat errors cost $0. (5) Token budgets capped by error complexity: simple=20K agent budget, moderate=50K, complex=100K. Simple errors get 4 agent turns max. (6) Prior attempt summaries (not full context) passed between iterations — concise 'do NOT repeat' directives. (7) Fast path includes last known good backup code so AI can revert broken additions instead of patching around them.",
     metadata: { topic: "cost-optimization" },

package/src/core/runner.js

@@ -21,6 +21,7 @@ const { RouteProber } = require("../monitor/route-prober");
 const { startHeartbeat, stopHeartbeat } = require("../platform/heartbeat");
 const { Notifier } = require("../notifications/notifier");
 const { ErrorMonitor } = require("../monitor/error-monitor");
+const { startAutoUpdate, stopAutoUpdate } = require("../platform/auto-update");
 
 /**
  * The Wolverine process runner — v3.
@@ -213,6 +214,25 @@ class WolverineRunner {
       redactor: this.redactor,
     });
 
+    // Auto-update: check for new wolverine-ai versions
+    const { getConfig: _gc } = require("./config");
+    const autoUpdateEnabled = _gc("autoUpdate.enabled") !== false;
+    if (autoUpdateEnabled) {
+      startAutoUpdate({
+        cwd: this.cwd,
+        logger: this.logger,
+        intervalMs: parseInt(process.env.WOLVERINE_UPDATE_INTERVAL_MS, 10) || 3600000,
+        onUpdate: (result) => {
+          console.log(chalk.blue(`  🔄 Wolverine updated ${result.from} → ${result.to}, restarting...`));
+          this.logger.info("update.restart", `Restarting after update ${result.from} → ${result.to}`);
+          this.restart();
+        },
+      });
+      console.log(chalk.gray("  🔄 Auto-update: enabled (checks hourly)"));
+    } else {
+      console.log(chalk.gray("  🔄 Auto-update: disabled"));
+    }
+
     this._spawn();
   }
 
@@ -272,6 +292,7 @@ class WolverineRunner {
     this.processMonitor.stop();
     this.routeProber.stop();
     stopHeartbeat();
+    stopAutoUpdate();
     this.mcp.shutdown();
     this.tokenTracker.save();
     this.dashboard.stop();

package/src/index.js

@@ -35,6 +35,7 @@ const { ClusterManager } = require("./core/cluster-manager");
 const { loadConfig, getConfig } = require("./core/config");
 const { sqlGuard, SafeDB, scanForInjection, idempotencyGuard, idempotencyAfterHook } = require("./skills/sql");
 const { diagnose: diagnoseDeps, healthReport: depsHealthReport, getMigration } = require("./skills/deps");
+const { checkForUpdate, upgrade: upgradeWolverine, getCurrentVersion } = require("./platform/auto-update");
 
 module.exports = {
   // Core
@@ -99,4 +100,7 @@ module.exports = {
   diagnoseDeps,
   depsHealthReport,
   getMigration,
+  checkForUpdate,
+  upgradeWolverine,
+  getCurrentVersion,
 };

package/src/platform/auto-update.js

@@ -0,0 +1,220 @@
+const { execSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+const chalk = require("chalk");
+
+/**
+ * Auto-Updater — self-updating wolverine framework.
+ *
+ * Checks npm registry for newer wolverine-ai versions on a schedule.
+ * When a new version is found, upgrades via npm and restarts.
+ *
+ * Config/settings are protected: backed up before update, restored after.
+ * Disable in settings.json: "autoUpdate": { "enabled": false }
+ *
+ * Wolverine can't edit files outside server/ directly, but it CAN
+ * run bash commands — so npm update is the upgrade path.
+ */
+
+const PACKAGE_NAME = "wolverine-ai";
+const CHECK_INTERVAL_MS = 3600000; // 1 hour
+
+let _timer = null;
+let _currentVersion = null;
+let _checking = false;
+
+/**
+ * Get the currently installed version.
+ */
+function getCurrentVersion() {
+  if (_currentVersion) return _currentVersion;
+  try {
+    const pkg = require("../../package.json");
+    _currentVersion = pkg.version;
+  } catch {
+    _currentVersion = "0.0.0";
+  }
+  return _currentVersion;
+}
+
+/**
+ * Check npm registry for the latest published version.
+ * Uses `npm view` — no network dependency beyond npm.
+ */
+function getLatestVersion() {
+  try {
+    const result = execSync(`npm view ${PACKAGE_NAME} version 2>/dev/null`, {
+      encoding: "utf-8",
+      timeout: 15000,
+    }).trim();
+    return result || null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Compare semver versions. Returns true if latest > current.
+ */
+function isNewer(latest, current) {
+  if (!latest || !current) return false;
+  const a = latest.split(".").map(Number);
+  const b = current.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((a[i] || 0) > (b[i] || 0)) return true;
+    if ((a[i] || 0) < (b[i] || 0)) return false;
+  }
+  return false;
+}
+
+/**
+ * Protect config files before update and restore after.
+ */
+function backupConfigs(cwd) {
+  const configs = [
+    "server/config/settings.json",
+    ".env.local",
+    ".env",
+  ];
+  const backups = {};
+  for (const file of configs) {
+    const fullPath = path.join(cwd, file);
+    if (fs.existsSync(fullPath)) {
+      backups[file] = fs.readFileSync(fullPath, "utf-8");
+    }
+  }
+  return backups;
+}
+
+function restoreConfigs(cwd, backups) {
+  for (const [file, content] of Object.entries(backups)) {
+    const fullPath = path.join(cwd, file);
+    try {
+      fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+      fs.writeFileSync(fullPath, content, "utf-8");
+    } catch {}
+  }
+}
+
+/**
+ * Perform the upgrade. Returns { success, from, to, error? }
+ */
+function upgrade(cwd, logger) {
+  const current = getCurrentVersion();
+  const latest = getLatestVersion();
+
+  if (!latest || !isNewer(latest, current)) {
+    return { success: false, from: current, to: latest, error: "Already up to date" };
+  }
+
+  console.log(chalk.blue(`\n  🔄 Wolverine update available: ${current} → ${latest}`));
+  if (logger) logger.info("update.start", `Upgrading ${current} → ${latest}`, { from: current, to: latest });
+
+  // Back up configs
+  const configBackups = backupConfigs(cwd);
+  console.log(chalk.gray(`  🔒 Backed up ${Object.keys(configBackups).length} config files`));
+
+  try {
+    // Determine install method: global or local
+    const isGlobal = __dirname.includes("node_modules") && !cwd.includes("node_modules");
+    const cmd = isGlobal
+      ? `npm install -g ${PACKAGE_NAME}@${latest}`
+      : `npm install ${PACKAGE_NAME}@${latest}`;
+
+    console.log(chalk.blue(`  📦 Running: ${cmd}`));
+    execSync(cmd, { cwd, stdio: "pipe", timeout: 120000 });
+
+    // Restore configs (npm might have overwritten them)
+    restoreConfigs(cwd, configBackups);
+    console.log(chalk.gray(`  🔒 Restored config files`));
+
+    // Clear version cache
+    _currentVersion = null;
+
+    console.log(chalk.green(`  ✅ Updated to ${latest}`));
+    if (logger) logger.info("update.success", `Upgraded to ${latest}`, { from: current, to: latest });
+
+    return { success: true, from: current, to: latest };
+  } catch (err) {
+    // Restore configs on failure
+    restoreConfigs(cwd, configBackups);
+    const errMsg = (err.message || "").slice(0, 100);
+    console.log(chalk.yellow(`  ⚠️  Update failed: ${errMsg}`));
+    if (logger) logger.warn("update.failed", `Upgrade failed: ${errMsg}`, { from: current, to: latest });
+    return { success: false, from: current, to: latest, error: errMsg };
+  }
+}
+
+/**
+ * Check for updates (non-blocking). Logs if update available.
+ * Call upgrade() separately to actually apply.
+ */
+function checkForUpdate() {
+  if (_checking) return null;
+  _checking = true;
+  try {
+    const current = getCurrentVersion();
+    const latest = getLatestVersion();
+    _checking = false;
+    if (latest && isNewer(latest, current)) {
+      console.log(chalk.blue(`  🔄 Update available: ${PACKAGE_NAME} ${current} → ${latest}`));
+      return { available: true, current, latest };
+    }
+    return { available: false, current, latest };
+  } catch {
+    _checking = false;
+    return null;
+  }
+}
+
+/**
+ * Start auto-update schedule. Checks every hour (configurable).
+ * If autoUpdate is enabled and a new version is found, upgrades and signals restart.
+ *
+ * @param {object} options
+ * @param {string} options.cwd — project root
+ * @param {object} options.logger — EventLogger
+ * @param {function} options.onUpdate — called after successful update (trigger restart)
+ * @param {number} options.intervalMs — check interval (default: 1h)
+ */
+function startAutoUpdate({ cwd, logger, onUpdate, intervalMs }) {
+  const interval = intervalMs || CHECK_INTERVAL_MS;
+
+  // Check on startup (delayed 30s to not block boot)
+  setTimeout(() => {
+    const result = checkForUpdate();
+    if (result?.available) {
+      const upgraded = upgrade(cwd, logger);
+      if (upgraded.success && onUpdate) {
+        console.log(chalk.blue("  🔄 Restarting with new version..."));
+        onUpdate(upgraded);
+      }
+    }
+  }, 30000);
+
+  // Periodic check
+  _timer = setInterval(() => {
+    const result = checkForUpdate();
+    if (result?.available) {
+      const upgraded = upgrade(cwd, logger);
+      if (upgraded.success && onUpdate) {
+        console.log(chalk.blue("  🔄 Restarting with new version..."));
+        onUpdate(upgraded);
+      }
+    }
+  }, interval);
+}
+
+function stopAutoUpdate() {
+  if (_timer) { clearInterval(_timer); _timer = null; }
+}
+
+module.exports = {
+  getCurrentVersion,
+  getLatestVersion,
+  isNewer,
+  checkForUpdate,
+  upgrade,
+  startAutoUpdate,
+  stopAutoUpdate,
+};