New plugin: cron-driven autonomous task runs (not just live-session reminders)

[argszero]

New plugin: @argszero/cordis-plugin-schedule-cron — cron-driven autonomous task runs

A while back I mapped the @deepseek-ai/dsh-schedule surface and found a concrete gap: it delivers reminders into the live session (a follow-up message), and the README is explicit that it has no calendar rules ("当交付必须到达会话之外时请避开它...或者当你需要「每个工作日 9 点」这类日历规则时：重复提醒只按固定间隔运行").

dsh-cron fills exactly that gap. On a standard 5-field cron fire it spawns a fresh agent run via ctx.agents.create() + agent.followup() — the same primitive the ACP bridge uses for non-interactive sessions. So scheduled work actually happens even with no browser session open, which is the "EMRG-style" autonomous scheduled task model.

Install

npm install @argszero/cordis-plugin-schedule-cron

Then mount it in a cordis.yml overlay:

plugins:
  schedule-cron:
    cron:
      - id: daily-triage
        expression: "0 9 * * 1-5"          # 09:00 Mon–Fri
        task: "Review the open issues in this repo and summarize anything urgent."
      - id: weekly-report
        expression: "0 8 * * 1"             # 08:00 Monday
        task: "Write this week's status report."
        provider: deepseek
        model: deepseek-chat
        cwd: /path/to/workspace
    tickMs: 60000

Design

• Monotonic per-rule cursor (croner), so each occurrence fires exactly once and a restart mid-window resumes forward (no re-fire).
• No backfill burst: on mount every cursor anchors to its next future occurrence; a long-downed schedule is capped at 4 fires/tick.
• Recoverable state: initialState (lastFiredAt per rule id) lets you restore dedupe baselines across restarts.
• Dependency-free engine: collectDue(cursors, now) is pure and unit-tested, so it can be driven by any timer.

Source + 10 passing logic tests: https://github.com/argszero/cordis-plugin-schedule-cron · npm: https://www.npmjs.com/package/@argszero/cordis-plugin-schedule-cron

Happy to hear feedback — especially if you've wanted "9am on weekdays, spawn an agent" style scheduling that dsh-schedule deliberately doesn't cover.