mesh-cron

mesh-cron — Scheduled task triggers for mesh protocol

Infrastructure

Usage

mesh cron  [args]

Commands

add, remove, list, enable, disable, check, history, stats

Commons Entry


# mesh-cron

**Layer:** Infrastructure (cross-cutting)
**CLI:** `mesh cron <command>`
**Ledger:** `mesh-state/cron/history.jsonl`

## Purpose
Time-based task triggers for the mesh protocol. Cron-like scheduling that auto-submits tasks to mesh-scheduler when due. Enables recurring automation (health checks, reports, cleanup) without external cron dependencies.

## Commands
- `add` — Create scheduled job (--schedule, --task, --priority, --desc)
- `remove` — Delete a job by ID
- `list` — Show all jobs with status
- `enable/disable` — Toggle job without removing
- `check` — Evaluate all enabled jobs, trigger due ones → scheduler
- `history` — Recent trigger log
- `stats` — Job counts, top runners

## Schedule Format
Standard 5-field cron: `minute hour day month weekday`
- `*/30 * * * *` — every 30 minutes
- `0 9 * * 1-5` — weekday mornings at 9am
- `0 */6 * * *` — every 6 hours

## Integration
- Submits to **mesh-scheduler** on trigger
- Uses **ledger-write.sh** for standardized logging
- Wired into mesh CLI as `mesh cron`