coder-config 0.50.5-beta → 0.50.6-beta

package/lib/constants.js

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

package/lib/heartbeat.js

@@ -199,10 +199,93 @@ function heartbeat(installDir, config) {
   };
 }
 
+/**
+ * Save the last heartbeat report to disk for deduplication
+ * @param {string} installDir - path to coder-config install dir
+ * @param {object} report - heartbeat report with alerts array
+ */
+function saveLastHeartbeat(installDir, report) {
+  const loopsDir = path.join(installDir, 'loops');
+  fs.mkdirSync(loopsDir, { recursive: true });
+  const alertHashes = {};
+  const now = Date.now();
+  for (const alert of (report.alerts || [])) {
+    const key = `${alert.loopId}:${alert.type}`;
+    alertHashes[key] = now;
+  }
+  const data = { alertHashes, timestamp: now };
+  fs.writeFileSync(path.join(loopsDir, 'last-heartbeat.json'), JSON.stringify(data, null, 2));
+}
+
+/**
+ * Load the last saved heartbeat from disk
+ * @param {string} installDir - path to coder-config install dir
+ * @returns {object|null} saved heartbeat data or null if not found
+ */
+function loadLastHeartbeat(installDir) {
+  const filePath = path.join(installDir, 'loops', 'last-heartbeat.json');
+  try {
+    const raw = fs.readFileSync(filePath, 'utf8');
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Determine whether an alert should fire (not within cooldown)
+ * @param {string} installDir - path to coder-config install dir
+ * @param {object} alert - alert object with loopId and type
+ * @param {number} cooldownMinutes - cooldown in minutes
+ * @returns {boolean} true if should notify, false if within cooldown
+ */
+function shouldNotify(installDir, alert, cooldownMinutes) {
+  const last = loadLastHeartbeat(installDir);
+  if (!last || !last.alertHashes) return true;
+  const key = `${alert.loopId}:${alert.type}`;
+  const lastTime = last.alertHashes[key];
+  if (lastTime == null) return true;
+  const ageMinutes = (Date.now() - lastTime) / 60000;
+  return ageMinutes >= cooldownMinutes;
+}
+
+/**
+ * Build a macOS osascript notification command for a heartbeat report
+ * @param {object} report - heartbeat report
+ * @returns {string} shell command string
+ */
+function buildMacosNotification(report) {
+  const alerts = report.alerts || [];
+  const criticalCount = alerts.filter(a => a.severity === 'critical').length;
+  const warningCount = alerts.filter(a => a.severity === 'warning').length;
+  const parts = [];
+  if (criticalCount > 0) parts.push(`${criticalCount} critical`);
+  if (warningCount > 0) parts.push(`${warningCount} warning${warningCount !== 1 ? 's' : ''}`);
+  const subtitle = parts.length > 0 ? parts.join(', ') : 'all healthy';
+  const body = (report.summary || subtitle).replace(/'/g, "\\'");
+  return `osascript -e 'display notification "${body}" with title "Ralph Heartbeat" subtitle "${subtitle}"'`;
+}
+
+/**
+ * Get exit code for a heartbeat report
+ * @param {object} report - heartbeat report with alerts array
+ * @returns {number} 0 if healthy or only info, 1 if any warning or critical
+ */
+function getExitCode(report) {
+  const alerts = report.alerts || [];
+  const hasActionable = alerts.some(a => a.severity === 'critical' || a.severity === 'warning');
+  return hasActionable ? 1 : 0;
+}
+
 module.exports = {
   heartbeat,
   getDefaultHeartbeatConfig,
   loadHeartbeatConfig,
   evaluateLoop,
-  buildSummary
+  buildSummary,
+  saveLastHeartbeat,
+  loadLastHeartbeat,
+  shouldNotify,
+  buildMacosNotification,
+  getExitCode
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coder-config",
-  "version": "0.50.5-beta",
+  "version": "0.50.6-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",