coder-config 0.50.6-beta → 0.50.8-beta

package/config-loader.js

@@ -31,6 +31,7 @@ const { getProjectsRegistryPath, loadProjectsRegistry, saveProjectsRegistry, pro
 const { getWorkstreamsPath, loadWorkstreams, saveWorkstreams, workstreamList, workstreamCreate, workstreamUpdate, workstreamDelete, workstreamUse, workstreamActive, workstreamAddProject, workstreamRemoveProject, workstreamInject, workstreamDetect, workstreamGet, getActiveWorkstream, countWorkstreamsForProject, workstreamInstallHook, workstreamInstallHookGemini, workstreamInstallHookCodex, workstreamDeactivate, workstreamCheckPath, getSettingsPath, loadSettings, saveSettings, workstreamAddTrigger, workstreamRemoveTrigger, workstreamSetAutoActivate, setGlobalAutoActivate, shouldAutoActivate, workstreamCheckFolder, workstreamInstallCdHook, workstreamUninstallCdHook, workstreamCdHookStatus, discoverSubProjects, generateRulesFromRepos, generateRulesWithClaude, generateRulesWithAI, getAvailableAITools, findAIBinary, AI_TOOLS, workstreamSetSandbox } = require('./lib/workstreams');
 const { getActivityPath, getDefaultActivity, loadActivity, saveActivity, detectProjectRoot, activityLog, activitySummary, generateWorkstreamName, activitySuggestWorkstreams, activityClear } = require('./lib/activity');
 const { getLoopsPath, loadLoops, saveLoops, loadLoopState, saveLoopState, loadHistory, saveHistory, loopList, loopCreate, loopGet, loopUpdate, loopDelete, loopStart, loopPause, loopResume, loopCancel, loopApprove, loopComplete, loopFail, loopStatus, loopHistory, loopConfig, getActiveLoop, recordIteration, saveClarifications, savePlan, loadClarifications, loadPlan, loopInject, archiveLoop } = require('./lib/loops');
+const { heartbeat: runHeartbeat, formatReport, getExitCode, saveLastHeartbeat, shouldNotify, buildMacosNotification, loadHeartbeatConfig, getDefaultHeartbeatConfig } = require('./lib/heartbeat');
 const { getSessionStatus, showSessionStatus, flushContext, clearContext, installHooks: sessionInstallHooks, getFlushedContext, installFlushCommand, installAll: sessionInstallAll, SESSION_DIR, FLUSHED_CONTEXT_FILE } = require('./lib/sessions');
 const { runCli } = require('./lib/cli');
 const { shellStatus, shellInstall, shellUninstall, printShellStatus } = require('./lib/shell');
@@ -253,6 +254,54 @@ class ClaudeConfigManager {
   loopInject(silent) { return loopInject(this.installDir, silent); }
   archiveLoop(loopId) { return archiveLoop(this.installDir, loopId); }
 
+  loopHeartbeat(options = {}) {
+    const report = runHeartbeat(this.installDir);
+
+    if (options.json) {
+      console.log(JSON.stringify(report, null, 2));
+    } else if (options.quiet) {
+      if (getExitCode(report) === 1) {
+        console.log(formatReport(report));
+      }
+    } else {
+      console.log(formatReport(report));
+    }
+
+    if (options.notify) {
+      const config = loadHeartbeatConfig(this.installDir);
+      const newAlerts = report.alerts.filter(a =>
+        (a.severity === 'critical' || a.severity === 'warning') &&
+        shouldNotify(this.installDir, a, config.cooldownMinutes || 15)
+      );
+
+      if (newAlerts.length > 0) {
+        if (config.notifications?.macos?.enabled !== false) {
+          const cmd = buildMacosNotification(report);
+          try {
+            require('child_process').execSync(cmd);
+          } catch (e) {
+            // osascript may fail in non-GUI contexts
+          }
+        }
+
+        if (config.notifications?.slack?.enabled && config.notifications?.slack?.webhookUrl) {
+          const https = require('https');
+          const url = new URL(config.notifications.slack.webhookUrl);
+          const payload = JSON.stringify({ text: `Ralph Heartbeat: ${report.summary}` });
+          const req = https.request({ hostname: url.hostname, path: url.pathname, method: 'POST',
+            headers: { 'Content-Type': 'application/json' }
+          });
+          req.write(payload);
+          req.end();
+        }
+
+        saveLastHeartbeat(this.installDir, report);
+      }
+    }
+
+    return report;
+  }
+
   // Activity
   getActivityPath() { return getActivityPath(this.installDir); }
   loadActivity() { return loadActivity(this.installDir); }

package/lib/cli.js

@@ -263,15 +263,31 @@ function runCli(manager) {
         manager.loopHistory();
       } else if (args[1] === 'config') {
         const updates = {};
-        const maxIterIdx = args.indexOf('--max-iterations');
-        if (maxIterIdx !== -1) updates.maxIterations = args[maxIterIdx + 1];
-        if (args.includes('--auto-approve-plan')) updates.autoApprovePlan = true;
-        if (args.includes('--no-auto-approve-plan')) updates.autoApprovePlan = false;
+        // Dot-notation key=value: coder-config loop config heartbeat.staleThresholdMinutes 30
+        if (args[2] && args[3] && !args[2].startsWith('--')) {
+          updates[args[2]] = args[3];
+        } else {
+          // Flag-based (backwards compatible)
+          const maxIterIdx = args.indexOf('--max-iterations');
+          if (maxIterIdx !== -1) updates.maxIterations = args[maxIterIdx + 1];
+          if (args.includes('--auto-approve-plan')) updates.autoApprovePlan = true;
+          if (args.includes('--no-auto-approve-plan')) updates.autoApprovePlan = false;
+        }
         if (Object.keys(updates).length > 0) {
           manager.loopConfig(updates);
         } else {
           manager.loopConfig();
         }
+      } else if (args[1] === 'heartbeat') {
+        const options = {
+          notify: args.includes('--notify'),
+          quiet: args.includes('--quiet'),
+          json: args.includes('--json')
+        };
+        const report = manager.loopHeartbeat(options);
+        if (options.quiet) {
+          process.exitCode = report.alerts.some(a => a.severity === 'critical' || a.severity === 'warning') ? 1 : 0;
+        }
       } else if (args[1] === 'inject') {
         const silent = args.includes('--silent') || args.includes('-s');
         manager.loopInject(silent);
@@ -456,6 +472,9 @@ ${chalk.dim('Configuration manager for AI coding tools (Claude Code, Gemini CLI,
       cmd('loop cancel <id>', 'Cancel loop'),
       cmd('loop status [id]', 'Show loop status'),
       cmd('loop config', 'Show/set loop config'),
+      cmd('loop heartbeat', 'Check loop health'),
+      cmd('loop heartbeat --notify', 'Check + send notifications'),
+      cmd('loop heartbeat --quiet', 'Silent unless alerts'),
     ]));
     console.log();
   }

package/lib/constants.js

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

package/lib/heartbeat.js

@@ -277,6 +277,62 @@ function getExitCode(report) {
   return hasActionable ? 1 : 0;
 }
 
+/**
+ * Format a heartbeat report for terminal display
+ * @param {object} report - heartbeat report object
+ * @returns {string} formatted string for console output
+ */
+function formatReport(report) {
+  const chalk = require('chalk');
+  const lines = [];
+
+  lines.push(`♥ Loop Heartbeat — ${report.timestamp}`);
+  lines.push('');
+
+  const alerts = report.alerts || [];
+  const critical = alerts.filter(a => a.severity === 'critical');
+  const warning = alerts.filter(a => a.severity === 'warning');
+  const info = alerts.filter(a => a.severity === 'info');
+  const healthy = report.healthy || [];
+
+  if (critical.length > 0) {
+    lines.push(chalk.red('🔴 CRITICAL'));
+    for (const a of critical) {
+      lines.push(`   ${chalk.red('✗')} ${a.name} — ${a.message}`);
+    }
+    lines.push('');
+  }
+
+  if (warning.length > 0) {
+    lines.push(chalk.yellow('🟡 WARNING'));
+    for (const a of warning) {
+      lines.push(`   ${chalk.yellow('⚠')} ${a.name} — ${a.message}`);
+    }
+    lines.push('');
+  }
+
+  if (info.length > 0) {
+    lines.push(chalk.blue('🔵 INFO'));
+    for (const a of info) {
+      lines.push(`   ${chalk.blue('ℹ')} ${a.name} — ${a.message}`);
+    }
+    lines.push('');
+  }
+
+  if (healthy.length > 0) {
+    lines.push(chalk.green('🟢 HEALTHY'));
+    for (const h of healthy) {
+      const phase = h.phase ? ` [${h.phase}]` : '';
+      lines.push(`   ${chalk.green('●')} ${h.name}${phase} ${h.iteration}`);
+    }
+    lines.push('');
+  }
+
+  lines.push(`Summary: ${report.summary}`);
+
+  return lines.join('\n');
+}
+
 module.exports = {
   heartbeat,
   getDefaultHeartbeatConfig,
@@ -287,5 +343,6 @@ module.exports = {
   loadLastHeartbeat,
   shouldNotify,
   buildMacosNotification,
-  getExitCode
+  getExitCode,
+  formatReport
 };

package/lib/loops.js

@@ -4,6 +4,7 @@
 
 const fs = require('fs');
 const path = require('path');
+const { getDefaultHeartbeatConfig } = require('./heartbeat');
 
 /**
  * Get loops directory path
@@ -621,6 +622,32 @@ function archiveLoop(installDir, loopId) {
   }
 }
 
+/**
+ * Set a nested value on an object using dot-notation path.
+ * Creates intermediate objects as needed.
+ */
+function setNestedValue(obj, dotPath, value) {
+  const parts = dotPath.split('.');
+  let current = obj;
+  for (let i = 0; i < parts.length - 1; i++) {
+    if (current[parts[i]] === undefined || typeof current[parts[i]] !== 'object') {
+      current[parts[i]] = {};
+    }
+    current = current[parts[i]];
+  }
+  current[parts[parts.length - 1]] = value;
+}
+
+/**
+ * Auto-convert string values to appropriate types.
+ */
+function coerceValue(value) {
+  if (value === 'true') return true;
+  if (value === 'false') return false;
+  if (typeof value === 'string' && /^\d+$/.test(value)) return parseInt(value, 10);
+  return value;
+}
+
 /**
  * Get/set loop configuration
  */
@@ -634,11 +661,46 @@ function loopConfig(installDir, updates = null) {
     console.log(`   Auto-approve Plan: ${data.config.autoApprovePlan}`);
     console.log(`   Max Clarify Iterations: ${data.config.maxClarifyIterations}`);
     console.log(`   Completion Promise: ${data.config.completionPromise || 'DONE'}`);
+    if (data.config.heartbeat) {
+      const hb = data.config.heartbeat;
+      const slack = hb.notifications && hb.notifications.slack;
+      const macos = hb.notifications && hb.notifications.macos;
+      console.log('   Heartbeat:');
+      console.log(`     Stale Threshold: ${hb.staleThresholdMinutes !== undefined ? hb.staleThresholdMinutes + 'm' : '30m'}`);
+      console.log(`     Iteration Limit: ${hb.iterationLimitPercent !== undefined ? hb.iterationLimitPercent + '%' : '80%'}`);
+      console.log(`     Cooldown: ${hb.cooldownMinutes !== undefined ? hb.cooldownMinutes + 'm' : '15m'}`);
+      console.log(`     macOS Notifications: ${macos && macos.enabled !== undefined ? (macos.enabled ? 'on' : 'off') : 'on'}`);
+      if (slack) {
+        const slackStatus = slack.enabled ? `on (${slack.channel || '#dev-loops'})` : 'off';
+        console.log(`     Slack: ${slackStatus}`);
+      } else {
+        console.log('     Slack: off');
+      }
+    }
     console.log('');
     return data.config;
   }
 
-  // Apply updates
+  // Check for dot-notation heartbeat keys
+  const dotKeys = Object.keys(updates).filter(k => k.includes('.'));
+  if (dotKeys.length > 0) {
+    // Initialize heartbeat config with defaults if not present
+    if (!data.config.heartbeat) {
+      data.config.heartbeat = getDefaultHeartbeatConfig();
+    }
+    for (const key of dotKeys) {
+      if (key.startsWith('heartbeat.')) {
+        const subPath = key.slice('heartbeat.'.length);
+        setNestedValue(data.config.heartbeat, subPath, coerceValue(updates[key]));
+      } else {
+        setNestedValue(data.config, key, coerceValue(updates[key]));
+      }
+    }
+    // Remove dot-notation keys so they don't fall through to flat handling
+    dotKeys.forEach(k => delete updates[k]);
+  }
+
+  // Apply flat updates
   if (updates.maxIterations !== undefined) {
     data.config.maxIterations = parseInt(updates.maxIterations, 10);
   }

package/package.json

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

package/ui/routes/loops.js

@@ -598,7 +598,14 @@ function setupLoopHooks(projectPath) {
   return installLoopHooks(null, projectPath);
 }
 
+function getHeartbeat(manager) {
+  if (!manager) return { error: 'Manager not available' };
+  const { heartbeat: runHeartbeat } = require('../../lib/heartbeat');
+  return runHeartbeat(manager.installDir);
+}
+
 module.exports = {
+  getHeartbeat,
   getLoops,
   getActiveLoop,
   getLoop,

package/ui/server.cjs

@@ -886,6 +886,10 @@ class ConfigUIServer {
         }
         break;
 
+      case '/api/loops/heartbeat':
+        if (req.method === 'GET') return this.json(res, routes.loops.getHeartbeat(this.manager));
+        break;
+
       case '/api/loops/tune-prompt':
         if (req.method === 'POST') {
           const result = await routes.loops.tunePrompt(