Cron Health

Description

Checks all registered cron jobs from data/cron/jobs.json and mind.db cron_runs table, reporting which jobs are healthy and which are failing or overdue.

A job is healthy if its last run status is ok and it is not past 3× its scheduled interval. A job is failing if its last run status is failed or it is overdue.

Input Schema

{
  "type": "object",
  "properties": {},
  "required": []
}

(No input parameters required.)

Output Schema

{
  "type": "object",
  "properties": {
    "healthy":  { "type": "array", "items": { "type": "string" }, "description": "Job names running without issues" },
    "failing":  { "type": "array", "items": { "type": "string" }, "description": "Job names that errored or are overdue" },
    "lastRun":  { "type": "string", "description": "ISO timestamp of the most recent cron run" },
    "details":  { "type": "array", "description": "Per-job detail objects with status, lastRan, lastError, overdue" }
  }
}

Example

const result = await registry.execute('automation.cron-health', {});
// result.data.healthy  → ['system.heartbeat']
// result.data.failing  → ['daily.brief']
// result.data.lastRun  → '2026-03-29T22:37:54.777Z'

Notes

• Reads data/cron/jobs.json for job definitions.
• Reads mind.db cron_runs table for execution history.
• No network calls — fully local.
• Overdue threshold: 3 × schedule.ms.