@koda-sl/baker-cli 0.232.1 → 0.233.0-dev.bfa5a91e4

package/dist/cli.js

@@ -58,7 +58,7 @@ import {
   ulid,
   validateCanvasDeep,
   ytDlpBlockSignal
-} from "./chunk-EKLAHWSF.js";
+} from "./chunk-CMPAHYLB.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -43316,8 +43316,8 @@ import { defineCommand as defineCommand178 } from "citty";
 // src/commands/scheduled-actions/shared.ts
 var TEMP_SCHEDULED_ACTION_PREFIX = "temp_sched_";
 var TEMP_ID_PREFIX = "temp_";
-function writeOk2(data) {
-  writeJson({ ok: true, data: data ?? null });
+function writeOk2(data, hints) {
+  writeJson({ ok: true, data: data ?? null, ...hints && hints.length > 0 ? { hints } : {} });
 }
 function failValidation4(message) {
   writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
@@ -43358,10 +43358,41 @@ function isPromptWithoutAgent(args, agentDisabled) {
 function failIfPromptWithoutAgent(args, agentDisabled) {
   if (isPromptWithoutAgent(args, agentDisabled)) {
     failValidation4(
-      "--prompt only applies when an agent is spawned; it has no effect with --no-spawn-agent or --spawn-agent false."
+      "--prompt only applies when a run does the work; it has no effect with --mode remind, --no-spawn-agent or --spawn-agent false."
     );
   }
 }
+function isModeAndSpawnAgentBothSet(args, mode) {
+  const spawnAgentGiven = args["spawn-agent"] !== void 0 || args["no-spawn-agent"] === true || args.noSpawnAgent === true;
+  return mode !== void 0 && spawnAgentGiven;
+}
+function failIfModeAndSpawnAgent(args, mode) {
+  if (isModeAndSpawnAgentBothSet(args, mode)) {
+    failValidation4("--mode and --spawn-agent/--no-spawn-agent set the same thing. Use --mode on its own.");
+  }
+}
+var TASK_MODES = [
+  { id: "remind", does: "Opens the Task on schedule and leaves it. Nothing runs." },
+  { id: "recommend", does: "Opens a Task with what it would change and why. Touches nothing itself." },
+  { id: "propose", does: "Does the work and leaves it for the user to review, then publish." },
+  { id: "publish", does: "Does the work and publishes it as soon as it finishes \u2014 nobody reviews it first." }
+];
+var TASK_MODE_IDS = TASK_MODES.map((mode) => mode.id);
+var TASK_MODE_ARG_DESCRIPTION = `How far a run of this task goes on its own. ${TASK_MODES.map(
+  (mode) => `${mode.id}: ${mode.does}`
+).join(" ")} Only set publish when the user asked for it outright \u2014 those runs go live unreviewed and can spend money.`;
+function isKnownTaskMode(raw) {
+  return typeof raw === "string" && TASK_MODE_IDS.some((id) => id === raw);
+}
+function parseModeFlag(raw) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  if (!isKnownTaskMode(raw)) {
+    failValidation4(`--mode must be one of: ${TASK_MODE_IDS.join(", ")}.`);
+  }
+  return raw;
+}
 function parseBooleanFlag(raw, flagName) {
   if (raw === void 0) {
     return void 0;
@@ -43417,6 +43448,12 @@ registerSchema({
     },
     timezone: { type: "string", description: "IANA timezone override; defaults to Company Timezone", required: false },
     disabled: { type: "boolean", description: "Create disabled", required: false, default: false },
+    mode: {
+      type: "string",
+      description: `${TASK_MODE_ARG_DESCRIPTION} Defaults to propose, or to the template's own mode with --template.`,
+      required: false,
+      enum: TASK_MODE_IDS
+    },
     "no-spawn-agent": {
       type: "boolean",
       description: "Do not spawn an agent when this scheduled action fires",
@@ -43443,6 +43480,7 @@ var createCommand3 = defineCommand178({
     "run-at": { type: "string", description: "ISO UTC timestamp ending in Z", 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 },
     "no-spawn-agent": { type: "boolean", description: "Disable agent spawning", required: false, default: false },
     prompt: { type: "string", description: "Additional spawned-agent instructions", required: false },
     template: { type: "string", description: "Template id to run on this schedule", required: false }
@@ -43460,7 +43498,9 @@ var createCommand3 = defineCommand178({
       const schedule = buildScheduleBody(args, { required: true });
       const chatId = requireChatId();
       const noSpawnAgent = isNoSpawnAgentFlagSet(args);
-      failIfPromptWithoutAgent(args, noSpawnAgent);
+      const mode = parseModeFlag(args.mode);
+      failIfModeAndSpawnAgent(args, mode);
+      failIfPromptWithoutAgent(args, noSpawnAgent || mode === "remind");
       const body = {
         chatId,
         name,
@@ -43469,6 +43509,9 @@ var createCommand3 = defineCommand178({
         spawnAgent: !noSpawnAgent,
         ...schedule
       };
+      if (mode !== void 0) {
+        body.mode = mode;
+      }
       if (typeof args.prompt === "string") {
         body.agentPrompt = args.prompt;
       }
@@ -43810,6 +43853,12 @@ registerSchema({
     },
     timezone: { type: "string", description: "IANA timezone override", required: false },
     enabled: { type: "string", description: "Replacement enabled state", required: false, enum: ["true", "false"] },
+    mode: {
+      type: "string",
+      description: TASK_MODE_ARG_DESCRIPTION,
+      required: false,
+      enum: TASK_MODE_IDS
+    },
     "spawn-agent": {
       type: "string",
       description: "Replacement spawn-agent state",
@@ -43822,7 +43871,7 @@ registerSchema({
 var updateCommand3 = defineCommand184({
   meta: {
     name: "update",
-    description: "Stage a scheduled action update. Example: baker scheduled-actions update <id> --enabled false"
+    description: "Stage a scheduled action update. Examples: baker scheduled-actions update <id> --enabled false | baker scheduled-actions update <id> --mode publish"
   },
   args: {
     id: { type: "positional", description: "Scheduled action ID or temp_sched_* draft ID", required: false },
@@ -43837,6 +43886,7 @@ var updateCommand3 = defineCommand184({
     "run-at": { type: "string", description: "ISO UTC timestamp ending in Z", 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 },
     "spawn-agent": { type: "string", description: "true|false", required: false },
     prompt: { type: "string", description: "Replacement additional spawned-agent instructions", required: false }
   },
@@ -43865,24 +43915,30 @@ var updateCommand3 = defineCommand184({
         body.enabled = enabled;
         hasPatch = true;
       }
+      const mode = parseModeFlag(args.mode);
+      failIfModeAndSpawnAgent(args, mode);
+      if (mode !== void 0) {
+        body.mode = mode;
+        hasPatch = true;
+      }
       const spawnAgent = parseBooleanFlag(args["spawn-agent"], "--spawn-agent");
       if (spawnAgent !== void 0) {
         body.spawnAgent = spawnAgent;
         hasPatch = true;
       }
-      failIfPromptWithoutAgent(args, spawnAgent === false);
+      failIfPromptWithoutAgent(args, spawnAgent === false || mode === "remind");
       if (typeof args.prompt === "string") {
         body.agentPrompt = args.prompt;
         hasPatch = true;
       }
       if (!hasPatch) {
         failValidation4(
-          "Provide at least one of --name, --description, --cron, --run-at, --timezone, --enabled, --spawn-agent, --prompt."
+          "Provide at least one of --name, --description, --cron, --run-at, --timezone, --enabled, --mode, --spawn-agent, --prompt."
         );
       }
       body.chatId = requireChatId();
-      await apiPost("/api/scheduled-actions/update", body);
-      writeOk2();
+      const response = await apiPost("/api/scheduled-actions/update", body);
+      writeOk2(null, response.hints);
     } catch (err) {
       failApi2(err);
     }
@@ -43902,6 +43958,7 @@ Examples:
   baker scheduled-actions get <id-or-temp_sched_id>
   baker scheduled-actions create --name "Weekly report" --description "Prepare weekly report" --cron "0 9 * * MON"
   baker scheduled-actions update <id-or-temp_sched_id> --enabled false
+  baker scheduled-actions update <id-or-temp_sched_id> --mode publish   # what a run does on its own: remind|recommend|propose|publish
   baker scheduled-actions delete <id-or-temp_sched_id>
   baker scheduled-actions trigger <id>
 Full guide: __tooling__/docs/tools/baker/scheduled-actions.md`