clementine-agent 1.0.13 → 1.0.15

package/dist/cli/dashboard.js

@@ -135,8 +135,18 @@ async function cachedAsync(key, ttlMs, compute) {
 // ── Lazy gateway for chat ────────────────────────────────────────────
 let gatewayInstance = null;
 let gatewayInitializing = false;
+let gatewayDispatcher = null;
+/** SSE broadcaster; set once cmdDashboard has built the SSE infrastructure. */
+let dashboardSseBroadcast = null;
 /** Reset the cached gateway (called when daemon PID changes). */
 function resetGateway() {
+    if (gatewayDispatcher) {
+        try {
+            gatewayDispatcher.shutdown();
+        }
+        catch { /* best-effort */ }
+        gatewayDispatcher = null;
+    }
     gatewayInstance = null;
     responseCache.clear();
 }
@@ -156,6 +166,26 @@ async function getGateway() {
         gatewayInstance = new GatewayClass(assistant);
         const { setApprovalCallback } = await import('../agent/hooks.js');
         setApprovalCallback(async () => false);
+        // Wire a local NotificationDispatcher so deep-task results launched from
+        // dashboard chat sessions can be pushed back into the browser via SSE.
+        try {
+            const { NotificationDispatcher } = await import('../gateway/notifications.js');
+            const dispatcher = new NotificationDispatcher();
+            dispatcher.register('dashboard', async (text, context) => {
+                if (!dashboardSseBroadcast)
+                    return;
+                dashboardSseBroadcast({
+                    type: 'deep_result',
+                    data: { sessionKey: context?.sessionKey ?? null, text },
+                });
+            });
+            gatewayInstance.setDispatcher(dispatcher);
+            gatewayDispatcher = dispatcher;
+        }
+        catch (err) {
+            // Non-fatal — deep-task results from dashboard sessions just won't surface live
+            console.warn('Failed to wire dashboard SSE dispatcher:', err);
+        }
         return gatewayInstance;
     }
     catch (err) {
@@ -2009,6 +2039,8 @@ export async function cmdDashboard(opts) {
             }
         }
     }
+    // Let the lazy-gateway dispatcher publish deep_result events through SSE.
+    dashboardSseBroadcast = broadcastEvent;
     // SSE events handler moved before auth middleware (see above)
     // ── POST routes (actions) ──────────────────────────────────────
     app.post('/api/cron/run/:job', (req, res) => {
@@ -2043,6 +2075,16 @@ export async function cmdDashboard(opts) {
             res.status(500).json({ error: String(err) });
         }
     });
+    // ── Broken jobs (failure monitor) ───────────────────────────────
+    app.get('/api/cron/broken-jobs', async (_req, res) => {
+        try {
+            const { computeBrokenJobs } = await import('../gateway/failure-monitor.js');
+            res.json({ jobs: computeBrokenJobs() });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
     // ── Cron trace viewer ──────────────────────────────────────────
     app.get('/api/cron/traces/:job', (req, res) => {
         try {
@@ -3743,19 +3785,87 @@ export async function cmdDashboard(opts) {
         }
     });
     // ── Skills (Procedural Memory) API ──────────────────────────────────
-    app.get('/api/skills', (_req, res) => {
+    // NOTE: /api/skills/pending routes must come before /api/skills/:name so
+    // Express doesn't capture "pending" as a :name param.
+    app.get('/api/skills/pending', async (_req, res) => {
+        try {
+            const { listPendingSkills } = await import('../agent/skill-extractor.js');
+            res.json({ skills: listPendingSkills() });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    app.post('/api/skills/pending/:name/approve', async (req, res) => {
+        try {
+            const { approvePendingSkill } = await import('../agent/skill-extractor.js');
+            const result = approvePendingSkill(req.params.name);
+            if (!result.ok) {
+                res.status(404).json(result);
+                return;
+            }
+            res.json(result);
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    app.post('/api/skills/pending/:name/reject', async (req, res) => {
+        try {
+            const { rejectPendingSkill } = await import('../agent/skill-extractor.js');
+            const result = rejectPendingSkill(req.params.name);
+            if (!result.ok) {
+                res.status(404).json(result);
+                return;
+            }
+            res.json(result);
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    app.get('/api/skills', async (_req, res) => {
         try {
             const skillsDir = path.join(VAULT_DIR, '00-System', 'skills');
             if (!existsSync(skillsDir)) {
                 res.json({ skills: [] });
                 return;
             }
+            // Aggregate last-7-day retrieval stats from skill_usage table (best-effort).
+            const usageStats = new Map();
+            if (existsSync(MEMORY_DB_PATH)) {
+                try {
+                    const Database = (await import('better-sqlite3')).default;
+                    const db = new Database(MEMORY_DB_PATH, { readonly: true });
+                    try {
+                        const rows = db.prepare(`SELECT skill_name,
+                      COUNT(*) AS retrievals,
+                      MAX(retrieved_at) AS last_retrieved_at,
+                      AVG(score) AS avg_score
+               FROM skill_usage
+               WHERE retrieved_at >= datetime('now', '-7 days')
+               GROUP BY skill_name`).all();
+                        for (const r of rows) {
+                            usageStats.set(r.skill_name, {
+                                retrievals7d: r.retrievals,
+                                lastRetrievedAt: r.last_retrieved_at,
+                                avgScore: r.avg_score,
+                            });
+                        }
+                    }
+                    catch { /* skill_usage may not exist on older DBs */ }
+                    db.close();
+                }
+                catch { /* non-fatal */ }
+            }
             const files = readdirSync(skillsDir).filter(f => f.endsWith('.md'));
             const skills = files.map(f => {
                 try {
                     const parsed = matter(readFileSync(path.join(skillsDir, f), 'utf-8'));
+                    const name = f.replace('.md', '');
+                    const stats = usageStats.get(name);
                     return {
-                        name: f.replace('.md', ''),
+                        name,
                         title: parsed.data.title ?? f,
                         description: parsed.data.description ?? '',
                         source: parsed.data.source ?? 'unknown',
@@ -3766,6 +3876,9 @@ export async function cmdDashboard(opts) {
                         lastUsed: parsed.data.lastUsed ?? null,
                         createdAt: parsed.data.createdAt ?? '',
                         updatedAt: parsed.data.updatedAt ?? '',
+                        retrievals7d: stats?.retrievals7d ?? 0,
+                        lastRetrievedAt: stats?.lastRetrievedAt ?? null,
+                        avgScore: stats?.avgScore ?? null,
                     };
                 }
                 catch {
@@ -8972,15 +9085,25 @@ if('serviceWorker' in navigator){navigator.serviceWorker.getRegistrations().then
       <div class="page-title">Scheduled Tasks</div>
       <div class="tab-bar" id="automations-tabs">
         <button class="active" onclick="switchTab('automations','scheduled')">Scheduled Tasks</button>
+        <button onclick="switchTab('automations','broken')">Broken Jobs <span class="tab-badge" id="tab-broken-count" title="repeatedly failing" style="display:none;background:#ef4444;color:#fff">0</span></button>
         <button onclick="switchTab('automations','timers')">Timers <span class="tab-badge" id="tab-timer-count" style="display:none">0</span></button>
         <button onclick="switchTab('automations','self-improve')">Self-Improve <span class="tab-badge" id="tab-si-pending" style="display:none">0</span></button>
-        <button onclick="switchTab('automations','skills')">Skills <span class="tab-badge" id="tab-skill-count" style="display:none">0</span></button>
+        <button onclick="switchTab('automations','skills')">Skills <span class="tab-badge" id="tab-skill-count" style="display:none">0</span><span class="tab-badge" id="tab-pending-skill-count" title="pending approval" style="display:none;background:#f59e0b;color:#000">0</span></button>
         <button onclick="switchTab('automations','analytics')">Execution Analytics</button>
       </div>
       <div id="automations-tab-content">
         <div class="tab-pane active" id="tab-automations-scheduled">
           <div id="panel-cron"><div class="empty-state">Loading...</div></div>
         </div>
+        <div class="tab-pane" id="tab-automations-broken">
+          <div class="card">
+            <div class="card-header" style="display:flex;align-items:center;justify-content:space-between">
+              <span>Repeatedly Failing Jobs (last 48h)</span>
+              <span class="badge badge-gray" id="broken-count-badge" style="font-size:10px">0 jobs</span>
+            </div>
+            <div class="card-body" id="panel-broken-jobs"><div class="empty-state">Loading...</div></div>
+          </div>
+        </div>
         <div class="tab-pane" id="tab-automations-timers">
           <div class="card">
             <div class="card-body" id="panel-timers"><div class="empty-state">Loading...</div></div>
@@ -9032,6 +9155,13 @@ if('serviceWorker' in navigator){navigator.serviceWorker.getRegistrations().then
               </div>
             </div>
           </div>
+          <div class="card" id="pending-skills-card" style="display:none">
+            <div class="card-header" style="display:flex;align-items:center;justify-content:space-between">
+              <span>Pending Approval</span>
+              <span class="badge badge-orange" id="pending-skills-count-badge" style="font-size:10px">0 pending</span>
+            </div>
+            <div class="card-body" id="panel-pending-skills"></div>
+          </div>
           <div class="card">
             <div class="card-header" style="display:flex;align-items:center;justify-content:space-between">
               <span>Learned Skills</span>
@@ -10197,7 +10327,7 @@ function navigateTo(page, opts) {
     updateBuilderMode();
     document.getElementById('builder-input').focus();
   }
-  if (page === 'automations') { refreshCron(); refreshTimers(); refreshSelfImprove(); refreshSkills(); }
+  if (page === 'automations') { refreshCron(); refreshTimers(); refreshSelfImprove(); refreshSkills(); refreshBrokenJobs(); }
   if (page === 'intelligence') { refreshMemory(); }
   if (page === 'settings') { refreshSettings(); refreshRemoteAccess(); refreshSalesforce(); refreshClaudeIntegrations(); refreshMcpServers(); }
   if (page === 'logs') refreshLogs();
@@ -10238,6 +10368,7 @@ function switchTab(group, tab) {
   // Tab-specific refresh
   if (group === 'automations') {
     if (tab === 'scheduled') refreshCron();
+    if (tab === 'broken') refreshBrokenJobs();
     if (tab === 'timers') refreshTimers();
     if (tab === 'self-improve') refreshSelfImprove();
     if (tab === 'workflows') refreshWorkflows();
@@ -16031,7 +16162,139 @@ async function expandSkill(name) {
   } catch(e) { toast('Failed to load skill', 'error'); }
 }
 
+async function refreshBrokenJobs() {
+  try {
+    var r = await apiFetch('/api/cron/broken-jobs');
+    var d = await r.json();
+    var jobs = d.jobs || [];
+    var tabBadge = document.getElementById('tab-broken-count');
+    if (tabBadge) {
+      tabBadge.textContent = String(jobs.length);
+      tabBadge.style.display = jobs.length > 0 ? '' : 'none';
+    }
+    var countBadge = document.getElementById('broken-count-badge');
+    if (countBadge) countBadge.textContent = jobs.length + ' job' + (jobs.length !== 1 ? 's' : '');
+    var container = document.getElementById('panel-broken-jobs');
+    if (!container) return;
+    if (jobs.length === 0) {
+      container.innerHTML = '<div class="empty-state">All jobs healthy in the last 48h.</div>';
+      return;
+    }
+    var html = '<div style="display:flex;flex-direction:column;gap:12px">';
+    for (var j of jobs) {
+      var breaker = j.circuitBreakerEngagedAt
+        ? '<span class="badge" style="background:rgba(239,68,68,0.15);color:#ef4444;font-size:10px">circuit broken</span>'
+        : '';
+      var lastErrorAt = j.lastErrorAt ? timeAgo(j.lastErrorAt) : 'unknown';
+      var failureRatio = j.errorCount48h + '/' + j.totalRuns48h;
+      var advisorLine = j.lastAdvisorOpinion
+        ? '<div style="font-size:11px;color:var(--text-muted);margin-top:6px"><strong>Advisor:</strong> ' + esc(j.lastAdvisorOpinion) + '</div>'
+        : '';
+      var errorsHtml = '';
+      if (j.lastErrors && j.lastErrors.length > 0) {
+        errorsHtml = '<div style="margin-top:8px;display:flex;flex-direction:column;gap:4px">';
+        for (var e of j.lastErrors) {
+          errorsHtml += '<pre style="font-size:11px;color:var(--text-secondary);background:var(--bg-tertiary);padding:6px 8px;border-radius:4px;white-space:pre-wrap;word-break:break-word;margin:0;max-height:120px;overflow-y:auto">' + esc(e) + '</pre>';
+        }
+        errorsHtml += '</div>';
+      }
+      var agentTag = j.agentSlug
+        ? '<span class="badge badge-blue" style="font-size:10px">' + esc(j.agentSlug) + '</span>'
+        : '';
+      html += '<div style="padding:12px;border:1px solid var(--border);border-radius:8px;background:var(--bg-secondary)">'
+        + '<div style="display:flex;align-items:center;gap:8px;flex-wrap:wrap">'
+        + '<strong>' + esc(j.jobName) + '</strong> ' + agentTag + ' ' + breaker
+        + '<span style="margin-left:auto;font-size:11px;color:var(--text-muted)">' + failureRatio + ' failed \\u00b7 last error ' + lastErrorAt + '</span>'
+        + '</div>'
+        + errorsHtml
+        + advisorLine
+        + '</div>';
+    }
+    html += '</div>';
+    container.innerHTML = html;
+  } catch(e) {
+    var c = document.getElementById('panel-broken-jobs');
+    if (c) c.innerHTML = '<div class="empty-state" style="color:var(--red)">Failed to load broken jobs</div>';
+  }
+}
+
+async function refreshPendingSkills() {
+  try {
+    var r = await apiFetch('/api/skills/pending');
+    var d = await r.json();
+    var pending = d.skills || [];
+    var tabBadge = document.getElementById('tab-pending-skill-count');
+    if (tabBadge) {
+      tabBadge.textContent = String(pending.length);
+      tabBadge.style.display = pending.length > 0 ? '' : 'none';
+    }
+    var card = document.getElementById('pending-skills-card');
+    var countBadge = document.getElementById('pending-skills-count-badge');
+    var container = document.getElementById('panel-pending-skills');
+    if (!container) return;
+    if (pending.length === 0) {
+      if (card) card.style.display = 'none';
+      container.innerHTML = '';
+      return;
+    }
+    if (card) card.style.display = '';
+    if (countBadge) countBadge.textContent = pending.length + ' pending';
+
+    var html = '<div style="display:flex;flex-direction:column;gap:10px">';
+    for (var s of pending) {
+      var sourceTag = s.source === 'cron' ? '<span class="badge badge-green" style="font-size:10px">cron</span>'
+        : s.source === 'unleashed' ? '<span class="badge badge-purple" style="font-size:10px">unleashed</span>'
+        : s.source === 'chat' ? '<span class="badge badge-blue" style="font-size:10px">chat</span>'
+        : '<span class="badge badge-gray" style="font-size:10px">' + esc(s.source || 'unknown') + '</span>';
+      var age = s.createdAt ? timeAgo(s.createdAt) : '';
+      var scopeTag = s.agentSlug
+        ? '<span style="font-size:10px;color:var(--text-muted)">for ' + esc(s.agentSlug) + '</span>'
+        : '<span style="font-size:10px;color:var(--text-muted)">global</span>';
+      html += '<div style="padding:12px;border:1px solid var(--border);border-radius:8px;background:var(--bg-secondary)">'
+        + '<div style="display:flex;align-items:center;gap:8px;margin-bottom:6px;flex-wrap:wrap">'
+        + '<strong>' + esc(s.title) + '</strong> ' + sourceTag + ' ' + scopeTag
+        + (age ? ' <span style="font-size:10px;color:var(--text-muted)">\\u00b7 learned ' + age + '</span>' : '')
+        + '<span style="margin-left:auto;display:flex;gap:6px">'
+        + '<button onclick="approvePendingSkill(\\x27' + esc(s.name) + '\\x27)" style="background:var(--accent);border:1px solid var(--accent);border-radius:4px;padding:3px 10px;font-size:11px;color:white;cursor:pointer">Approve</button>'
+        + '<button onclick="rejectPendingSkill(\\x27' + esc(s.name) + '\\x27)" style="background:none;border:1px solid var(--border);border-radius:4px;padding:3px 10px;font-size:11px;color:var(--red);cursor:pointer">Reject</button>'
+        + '</span>'
+        + '</div>'
+        + '<div style="font-size:12px;color:var(--text-secondary)">' + esc(s.description || '') + '</div>'
+        + '</div>';
+    }
+    html += '</div>';
+    container.innerHTML = html;
+  } catch(e) { /* non-fatal */ }
+}
+
+async function approvePendingSkill(name) {
+  try {
+    var r = await apiJson('POST', '/api/skills/pending/' + encodeURIComponent(name) + '/approve', {});
+    if (r && r.ok) {
+      toast(r.message || 'Skill approved', 'success');
+      refreshPendingSkills();
+      refreshSkills();
+    } else {
+      toast((r && r.message) || 'Failed to approve', 'error');
+    }
+  } catch(e) { toast('Failed to approve skill', 'error'); }
+}
+
+async function rejectPendingSkill(name) {
+  if (!confirm('Reject this pending skill? It will be deleted.')) return;
+  try {
+    var r = await apiJson('POST', '/api/skills/pending/' + encodeURIComponent(name) + '/reject', {});
+    if (r && r.ok) {
+      toast(r.message || 'Skill rejected', 'success');
+      refreshPendingSkills();
+    } else {
+      toast((r && r.message) || 'Failed to reject', 'error');
+    }
+  } catch(e) { toast('Failed to reject skill', 'error'); }
+}
+
 async function refreshSkills() {
+  refreshPendingSkills();
   try {
     var r = await apiFetch('/api/skills');
     var d = await r.json();
@@ -16075,12 +16338,15 @@ async function refreshSkills() {
           + (s.toolsUsed.length > 4 ? ' <span style="font-size:10px;color:var(--text-muted)">+' + (s.toolsUsed.length - 4) + '</span>' : '')
           + '</div>';
       }
+      var retrieval7d = (typeof s.retrievals7d === 'number' && s.retrievals7d > 0)
+        ? ' \\u00b7 ' + s.retrievals7d + ' retrievals (7d)'
+        : '';
       html += '<div id="skill-card-' + esc(s.name) + '" style="padding:12px;border:1px solid var(--border);border-radius:8px;background:var(--bg-secondary)">'
         + '<div style="display:flex;align-items:center;gap:8px;margin-bottom:6px">'
         + '<strong style="cursor:pointer" onclick="expandSkill(\\x27' + esc(s.name) + '\\x27)">' + esc(s.title) + '</strong> ' + sourceTag
         + (sourceCtx ? ' ' + sourceCtx : '')
         + '<span style="margin-left:auto;display:flex;align-items:center;gap:8px">'
-        + '<span style="font-size:11px;color:var(--text-muted)">used ' + s.useCount + 'x' + (age ? ' \\u00b7 ' + age : '') + '</span>'
+        + '<span style="font-size:11px;color:var(--text-muted)">used ' + s.useCount + 'x' + (age ? ' \\u00b7 ' + age : '') + retrieval7d + '</span>'
         + '<button onclick="expandSkill(\\x27' + esc(s.name) + '\\x27)" style="background:none;border:1px solid var(--border);border-radius:4px;padding:2px 8px;font-size:11px;color:var(--text-secondary);cursor:pointer">View</button>'
         + '<button onclick="editSkillInBuilder(\\x27' + esc(s.name) + '\\x27)" style="background:none;border:1px solid var(--border);border-radius:4px;padding:2px 8px;font-size:11px;color:var(--accent);cursor:pointer">Edit</button>'
         + '<button onclick="deleteSkill(\\x27' + esc(s.name) + '\\x27)" style="background:none;border:1px solid var(--border);border-radius:4px;padding:2px 8px;font-size:11px;color:var(--red);cursor:pointer">Delete</button>'
@@ -17538,6 +17804,34 @@ try {
         toast('Daemon restarted \u2014 refreshing data...', 'info');
         setTimeout(function() { refreshAll(); }, 1500);
       }
+      if (evt.type === 'deep_result') {
+        try {
+          var container = document.getElementById('chat-messages');
+          var text = (evt.data && evt.data.text) ? evt.data.text : '';
+          if (container && text) {
+            var emptyState = container.querySelector('.empty-state');
+            if (emptyState) emptyState.remove();
+            var row = document.createElement('div');
+            row.className = 'chat-assistant-row';
+            var av = document.createElement('div');
+            av.className = 'chat-avatar-sm';
+            av.innerHTML = (lastStatusData && lastStatusData.name ? lastStatusData.name : 'C').charAt(0).toUpperCase();
+            row.appendChild(av);
+            var bubble = document.createElement('div');
+            bubble.className = 'chat-bubble assistant';
+            bubble.innerHTML = renderMd(text);
+            var meta = document.createElement('div');
+            meta.className = 'chat-meta';
+            meta.textContent = new Date().toLocaleTimeString() + ' \u00b7 deep task';
+            bubble.appendChild(meta);
+            row.appendChild(bubble);
+            container.appendChild(row);
+            container.scrollTop = container.scrollHeight;
+          } else {
+            toast('Deep task result ready \u2014 open chat to view.', 'info');
+          }
+        } catch(e) { /* non-fatal */ }
+      }
     } catch(err) { /* ignore */ }
   };
 } catch(err) { /* SSE not supported */ }

package/dist/gateway/cron-scheduler.d.ts

@@ -87,6 +87,11 @@ export declare class CronScheduler {
     private watchAgentsDir;
     private unwatchAgentsDir;
     reloadJobs(): void;
+    /**
+     * Wrap runLog.append so every completion also checks whether a fix
+     * verification is pending and DMs the verdict if so.
+     */
+    private _logRun;
     private runJob;
     /**
      * Log an advisor event to the events JSONL file for dashboard surfacing.

package/dist/gateway/cron-scheduler.js

@@ -491,6 +491,9 @@ export class CronScheduler {
         this.watchingAgents = false;
     }
     reloadJobs() {
+        // Snapshot the pre-reload job definitions so fix-verification can diff
+        // and flag any currently-failing job whose config just changed.
+        const oldJobs = this.jobs.map(j => ({ ...j }));
         // Stop existing scheduled tasks (but NOT the file watcher)
         for (const [name, task] of this.scheduledTasks) {
             task.stop();
@@ -580,6 +583,30 @@ export class CronScheduler {
                 logger.info(`Cron job '${def.name}' scheduled: ${def.schedule} (${SYSTEM_TIMEZONE})`);
             }
         }
+        // Fix-verification: detect any currently-failing job whose definition just
+        // changed, and record a pending verification for their next run.
+        // Skipped on the first load (oldJobs empty) since there's no edit to verify.
+        if (oldJobs.length > 0) {
+            import('./fix-verification.js').then(({ recordEditsForFailingJobs }) => {
+                try {
+                    recordEditsForFailingJobs(oldJobs, this.jobs);
+                }
+                catch (err) {
+                    logger.warn({ err }, 'Fix-verification capture failed');
+                }
+            }).catch(err => logger.warn({ err }, 'Fix-verification import failed'));
+        }
+    }
+    /**
+     * Wrap runLog.append so every completion also checks whether a fix
+     * verification is pending and DMs the verdict if so.
+     */
+    _logRun(entry) {
+        this.runLog.append(entry);
+        import('./fix-verification.js').then(({ checkAndDeliverVerification }) => {
+            checkAndDeliverVerification(entry, (text) => this.dispatcher.send(text, {}))
+                .catch(err => logger.warn({ err, job: entry.jobName }, 'Fix verification DM failed'));
+        }).catch(err => logger.warn({ err }, 'Fix-verification import failed'));
     }
     async runJob(job) {
         // Agent status check — skip if agent is paused/terminated
@@ -649,7 +676,7 @@ export class CronScheduler {
                 // Non-zero exit or timeout → skip the job
                 const exitCode = preCheckErr.status ?? 1;
                 logger.info({ job: job.name, exitCode }, 'Pre-check failed — skipping job (no work to do)');
-                this.runLog.append({
+                this._logRun({
                     jobName: job.name,
                     startedAt: new Date().toISOString(),
                     finishedAt: new Date().toISOString(),
@@ -690,7 +717,7 @@ export class CronScheduler {
             });
             if (!approved) {
                 logger.info({ job: job.name }, 'Cron job skipped by owner');
-                this.runLog.append({
+                this._logRun({
                     jobName: job.name,
                     startedAt: new Date().toISOString(),
                     finishedAt: new Date().toISOString(),
@@ -709,7 +736,7 @@ export class CronScheduler {
         const advice = getExecutionAdvice(job.name, job);
         if (advice.shouldSkip) {
             logger.info({ job: job.name, reason: advice.skipReason }, 'Execution advisor: circuit breaker — skipping job');
-            this.runLog.append({
+            this._logRun({
                 jobName: job.name,
                 startedAt: new Date().toISOString(),
                 finishedAt: new Date().toISOString(),
@@ -876,7 +903,7 @@ export class CronScheduler {
                             this.gateway.injectContext(`discord:user:${DISCORD_OWNER_ID}`, `[Scheduled cron: ${job.name}]`, response);
                         }
                     }
-                    this.runLog.append(entry);
+                    this._logRun(entry);
                     // Fire-and-forget: extract procedural skill from successful long-running cron jobs
                     if (entry.status === 'ok' && entry.durationMs > 30_000 && response && response.length > 500) {
                         this.gateway.extractCronSkill(job.name, job.prompt, response, entry.durationMs, job.agentSlug)
@@ -902,7 +929,7 @@ export class CronScheduler {
                     const errorType = errTerminalReason
                         ? classifyTerminalReason(errTerminalReason)
                         : classifyError(err);
-                    this.runLog.append({
+                    this._logRun({
                         jobName: job.name,
                         startedAt: startedAt.toISOString(),
                         finishedAt: finishedAt.toISOString(),

package/dist/gateway/failure-monitor.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Clementine TypeScript — Cron failure monitor.
+ *
+ * Surfaces cron jobs that have been failing repeatedly so they don't sit
+ * silently broken (which is what happened to ross-the-sdr:reply-detection —
+ * the existing circuit breaker fired ONCE at consErrors=5 and then went
+ * quiet for days).
+ *
+ * Threshold: a job is "broken" if either
+ *   - it has >= 3 error/retried entries in the last 48h, OR
+ *   - the circuit breaker engaged for it within the last 48h.
+ *
+ * Per-job 24h cooldown prevents re-spamming the owner with the same news.
+ *
+ * Read-only with respect to the cron run logs and advisor events; mutates
+ * only its own state file (cron/failure-monitor.json).
+ */
+export interface BrokenJob {
+    jobName: string;
+    agentSlug?: string;
+    errorCount48h: number;
+    totalRuns48h: number;
+    lastErrorAt: string | null;
+    lastErrors: string[];
+    circuitBreakerEngagedAt: string | null;
+    lastAdvisorOpinion: string | null;
+}
+/**
+ * Compute the current set of broken jobs by scanning all run logs.
+ * Pure function (state-free) — used both by the monitor sweep and the dashboard endpoint.
+ */
+export declare function computeBrokenJobs(now?: number): BrokenJob[];
+/**
+ * Run a sweep: identify currently-broken jobs, pick the ones we haven't
+ * notified about recently, and dispatch one consolidated DM.
+ *
+ * Returns the jobs that triggered a fresh notification (mostly for tests/logs).
+ */
+export declare function runFailureSweep(send: (text: string) => Promise<unknown>, now?: number): Promise<BrokenJob[]>;
+//# sourceMappingURL=failure-monitor.d.ts.map