coder-config 0.50.3 → 0.50.4-beta

package/lib/constants.js

@@ -2,7 +2,7 @@
  * Constants and tool path configurations
  */
 
-const VERSION = '0.50.3';
+const VERSION = '0.50.4-beta';
 
 // Tool-specific path configurations
 const TOOL_PATHS = {

package/lib/heartbeat.js

@@ -0,0 +1,169 @@
+/**
+ * Heartbeat module - monitors Ralph Loop health
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { loadLoops, loadLoopState } = require('./loops.js');
+
+/**
+ * Get default heartbeat configuration
+ */
+function getDefaultHeartbeatConfig() {
+  return {
+    staleThresholdMinutes: 30,
+    iterationLimitPercent: 80,
+    cooldownMinutes: 15,
+    notifications: {
+      macos: { enabled: true },
+      slack: { enabled: false }
+    }
+  };
+}
+
+/**
+ * Evaluate heartbeat for all active loops
+ * @param {string} installDir - path to coder-config install dir
+ * @param {object} [config] - optional heartbeat config overrides
+ * @returns {object} report with alerts and healthy loops
+ */
+function heartbeat(installDir, config) {
+  const hbConfig = Object.assign({}, getDefaultHeartbeatConfig(), config || {});
+
+  const registry = loadLoops(installDir);
+  const loops = registry.loops || [];
+
+  const alerts = [];
+  const healthy = [];
+  const terminalStates = new Set(['completed', 'cancelled']);
+
+  for (const entry of loops) {
+    const state = loadLoopState(installDir, entry.id);
+    if (!state) continue;
+
+    const status = state.status || 'unknown';
+    if (terminalStates.has(status)) continue;
+
+    const name = state.name || entry.name || entry.id;
+
+    // Check: failed
+    if (status === 'failed') {
+      alerts.push({
+        loopId: entry.id,
+        name,
+        type: 'failed',
+        message: `Loop "${name}" has failed`,
+        severity: 'critical'
+      });
+      continue;
+    }
+
+    let hasAlert = false;
+
+    // Check: stale
+    const perLoopThreshold = state.heartbeat && state.heartbeat.staleThresholdMinutes != null
+      ? state.heartbeat.staleThresholdMinutes
+      : hbConfig.staleThresholdMinutes;
+
+    if (state.updatedAt) {
+      const updatedAt = new Date(state.updatedAt);
+      const ageMinutes = (Date.now() - updatedAt.getTime()) / 60000;
+      if (ageMinutes >= perLoopThreshold) {
+        alerts.push({
+          loopId: entry.id,
+          name,
+          type: 'stale',
+          message: `Loop "${name}" has not updated in ${Math.floor(ageMinutes)} minutes`,
+          severity: 'warning'
+        });
+        hasAlert = true;
+      }
+    }
+
+    // Check: iteration_limit
+    const iterations = state.iterations || {};
+    const current = iterations.current != null ? iterations.current : 0;
+    const max = iterations.max != null ? iterations.max : 0;
+    if (max > 0) {
+      const pct = (current / max) * 100;
+      if (pct >= hbConfig.iterationLimitPercent) {
+        alerts.push({
+          loopId: entry.id,
+          name,
+          type: 'iteration_limit',
+          message: `Loop "${name}" is at ${Math.round(pct)}% of iteration limit (${current}/${max})`,
+          severity: 'warning'
+        });
+        hasAlert = true;
+      }
+    }
+
+    // Check: phase_gate (plan phase + running)
+    if (state.phase === 'plan' && status === 'running') {
+      alerts.push({
+        loopId: entry.id,
+        name,
+        type: 'phase_gate',
+        message: `Loop "${name}" is waiting at plan phase gate`,
+        severity: 'info'
+      });
+      hasAlert = true;
+    }
+
+    // Check: blocked (paused with pauseReason)
+    if (status === 'paused' && state.pauseReason) {
+      alerts.push({
+        loopId: entry.id,
+        name,
+        type: 'blocked',
+        message: `Loop "${name}" is blocked: ${state.pauseReason}`,
+        severity: 'info'
+      });
+      hasAlert = true;
+    }
+
+    if (!hasAlert) {
+      healthy.push({
+        loopId: entry.id,
+        name,
+        phase: state.phase || null,
+        iteration: current
+      });
+    }
+  }
+
+  const activeLoops = loops.filter(e => {
+    const state = loadLoopState(installDir, e.id);
+    if (!state) return false;
+    const status = state.status || 'unknown';
+    return !terminalStates.has(status);
+  }).length;
+
+  const criticalCount = alerts.filter(a => a.severity === 'critical').length;
+  const warningCount = alerts.filter(a => a.severity === 'warning').length;
+
+  let summary;
+  if (alerts.length === 0) {
+    summary = `${activeLoops} active loop${activeLoops !== 1 ? 's' : ''}, all healthy`;
+  } else {
+    const parts = [];
+    if (criticalCount > 0) parts.push(`${criticalCount} critical`);
+    if (warningCount > 0) parts.push(`${warningCount} warning${warningCount !== 1 ? 's' : ''}`);
+    const infoCount = alerts.filter(a => a.severity === 'info').length;
+    if (infoCount > 0) parts.push(`${infoCount} info`);
+    summary = `${activeLoops} active loop${activeLoops !== 1 ? 's' : ''}, ${parts.join(', ')}`;
+  }
+
+  return {
+    timestamp: new Date().toISOString(),
+    activeLoops,
+    alerts,
+    healthy,
+    summary
+  };
+}
+
+module.exports = {
+  getDefaultHeartbeatConfig,
+  heartbeat
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coder-config",
-  "version": "0.50.3",
+  "version": "0.50.4-beta",
   "description": "Configuration manager for AI coding tools - Claude Code, Gemini CLI, Codex CLI, Antigravity. Manage MCPs, rules, permissions, memory, and workstreams.",
   "author": "regression.io",
   "main": "config-loader.js",