Scheduling recurring work

Give ask or task a time and it becomes a schedule: the pack does that work without being asked, either once or repeatedly. --cron takes a cron expression (30-minute minimum interval); --at takes a single future RFC 3339 time. --name is an optional human label.

edisyl task growth-metrics "Digest the week's activity" --cron "0 9 * * 1" --name weekly_digest
edisyl ask growth-metrics "Which hypotheses moved this week?" --cron "0 9 * * 2" --name weekly_check

Each fire creates that verb’s own Action: a scheduled ask answers, a scheduled task works. task and ask are schedulable because a brief carries their whole request; a verb that also needs a file or a target (teach, import) has nothing to schedule from.

The create command prints a schedule id. Every other schedule command takes that id or the schedule’s name. A name is unique within a pack, so when two packs share one, add --pack <pack>.

edisyl schedule list [--pack <pack>]     # ids, labels, when they run, last/next run
edisyl schedule view <schedule-id>       # when it runs, brief, recent runs
edisyl schedule trigger <schedule-id>    # run it now; returns an actionId to follow
edisyl schedule runs <schedule-id>       # run history
edisyl schedule update <schedule-id>     # change the brief, cadence, mode, must-write, or description
edisyl schedule pause <schedule-id>      # stop firing, keep it
edisyl schedule resume <schedule-id>
edisyl schedule delete <schedule-id>     # removes it; pauses it instead once it has run

Caution

delete removes only a schedule that has never run. One with run history is paused instead, so its runs and their Actions stay readable, and you can resume it.

Composing a self-maintaining pack

This is where the Ask/Teach/Task model compounds:

1. A pack receives a recurring task to research weekly activity.
2. The task reads the pack’s live sources and learned definitions.
3. It produces a result.
4. If requested, it teaches that result back into the same pack.
5. Future asks can compare the current week against every retained prior run.

No self-updating skill is a separate product concept here: schedules and tasks supply the recurrence, teach supplies the durable update.