@koda-sl/baker-cli 0.256.0 → 0.257.0

package/README.md

@@ -3024,7 +3024,7 @@ baker scheduled-actions create --template baker-ads --name "Weekly ad review" --
 Rules:
 
 - `--cron` and `--run-at` are mutually exclusive.
-- `--run-at` must be an ISO UTC timestamp ending in `Z`.
+- `--run-at` must be an ISO UTC timestamp ending in `Z`, and still in the future — a time that has already passed is refused when the op is staged. If a one-off's time passes while the chat is still open, publishing creates the task **switched off** with the reason on it rather than dropping it, so it is never lost.
 - Draft-created ids use `temp_sched_*`; use them with `get`, `update`, or `delete` before publish.
 - Staged commands require `BAKER_CHAT_ID` to point to an `in_progress` chat.
 - `trigger` rejects `temp_sched_*` and only accepts published scheduled-action ids.

package/dist/cli.js

@@ -47675,6 +47675,20 @@ function parseBooleanFlag(raw, flagName) {
   }
   failValidation4(`${flagName} must be true or false.`);
 }
+function validateRunAt(runAt) {
+  if (!runAt.endsWith("Z")) {
+    failValidation4("--run-at must be an ISO UTC timestamp ending in Z.");
+  }
+  const parsed = Date.parse(runAt);
+  if (!Number.isFinite(parsed)) {
+    failValidation4("--run-at must be a valid ISO timestamp.");
+  }
+  if (parsed <= Date.now()) {
+    failValidation4(
+      `--run-at ${runAt} has already passed. A one-off task only runs at a time still to come \u2014 pass a later ISO UTC timestamp, and check which timezone you converted from if you worked it out from a local time.`
+    );
+  }
+}
 function buildScheduleBody(args, options) {
   const cron = args.cron;
   const runAt = args["run-at"];
@@ -47683,12 +47697,7 @@ function buildScheduleBody(args, options) {
     failValidation4("--cron and --run-at are mutually exclusive.");
   }
   if (runAt) {
-    if (!runAt.endsWith("Z")) {
-      failValidation4("--run-at must be an ISO UTC timestamp ending in Z.");
-    }
-    if (!Number.isFinite(Date.parse(runAt))) {
-      failValidation4("--run-at must be a valid ISO timestamp.");
-    }
+    validateRunAt(runAt);
     return { runAt, ...timezone ? { timezone } : {} };
   }
   if (cron) {
@@ -47713,7 +47722,7 @@ registerSchema({
     cron: { type: "string", description: "5-field cron expression; mutually exclusive with --run-at", required: false },
     "run-at": {
       type: "string",
-      description: "ISO UTC timestamp ending in Z; mutually exclusive with --cron",
+      description: "When this runs once, as an ISO UTC timestamp ending in Z. Must still be in the future \u2014 a time that has passed is refused. Mutually exclusive with --cron.",
       required: false
     },
     timezone: { type: "string", description: "IANA timezone override; defaults to Company Timezone", required: false },
@@ -47747,7 +47756,7 @@ var createCommand3 = defineCommand181({
     name: { type: "string", description: "Scheduled action name", required: false },
     description: { type: "string", description: "Description", required: false },
     cron: { type: "string", description: "5-field cron expression", required: false },
-    "run-at": { type: "string", description: "ISO UTC timestamp ending in Z", required: false },
+    "run-at": { type: "string", description: "ISO UTC timestamp ending in Z, still in the future", required: false },
     timezone: { type: "string", description: "IANA timezone override", required: false },
     disabled: { type: "boolean", description: "Create disabled", required: false, default: false },
     mode: { type: "string", description: `One of: ${TASK_MODE_IDS.join(", ")}`, required: false },
@@ -48118,7 +48127,7 @@ registerSchema({
     cron: { type: "string", description: "5-field cron expression; mutually exclusive with --run-at", required: false },
     "run-at": {
       type: "string",
-      description: "ISO UTC timestamp ending in Z; mutually exclusive with --cron",
+      description: "New one-off run time, as an ISO UTC timestamp ending in Z. Must still be in the future \u2014 a time that has passed is refused. Mutually exclusive with --cron.",
       required: false
     },
     timezone: { type: "string", description: "IANA timezone override", required: false },
@@ -48153,7 +48162,7 @@ var updateCommand3 = defineCommand187({
     name: { type: "string", description: "New name", required: false },
     description: { type: "string", description: "New description", required: false },
     cron: { type: "string", description: "5-field cron expression", required: false },
-    "run-at": { type: "string", description: "ISO UTC timestamp ending in Z", required: false },
+    "run-at": { type: "string", description: "ISO UTC timestamp ending in Z, still in the future", required: false },
     timezone: { type: "string", description: "IANA timezone override", required: false },
     enabled: { type: "string", description: "true|false", required: false },
     mode: { type: "string", description: `One of: ${TASK_MODE_IDS.join(", ")}`, required: false },