@koda-sl/baker-cli 0.232.1 → 0.233.0

package/README.md

@@ -2858,6 +2858,8 @@ baker scheduled-actions create --name "Spend review" --description "Review spend
 
 baker scheduled-actions update <id-or-temp_sched_id> --enabled false
 baker scheduled-actions update <id-or-temp_sched_id> --run-at "2026-09-02T07:00:00Z" --spawn-agent true --prompt "Use the launch checklist"
+baker scheduled-actions update <id-or-temp_sched_id> --mode publish     # runs go live unreviewed
+baker scheduled-actions update <id-or-temp_sched_id> --mode recommend   # runs advise and change nothing
 baker scheduled-actions delete <id-or-temp_sched_id>
 
 baker scheduled-actions trigger <id>
@@ -2875,9 +2877,11 @@ Rules:
 - Staged commands require `BAKER_CHAT_ID` to point to an `in_progress` chat.
 - `trigger` rejects `temp_sched_*` and only accepts published scheduled-action ids.
 - Company Timezone is the default; `--timezone` is an explicit IANA override.
+- `--mode` sets how far a run goes on its own: `remind` (opens the Task, runs nothing), `recommend` (writes up what it would change, touches nothing), `propose` (does the work, waits to be published — the default), `publish` (does the work and publishes it unreviewed). It applies when the chat is published, on the authority of whoever published it; a chat completed with no person behind it lands a `publish` task on `propose` instead.
+- `--mode` supersedes `--spawn-agent`/`--no-spawn-agent`, which can only reach `remind` and `propose`. Passing both is rejected.
 - Scheduled actions spawn agents by default; create with `--no-spawn-agent` or update with `--spawn-agent false` to disable it.
 - `--prompt` maps to the scheduled action's additional spawned-agent instructions (`agentPrompt`), not a replacement for Baker's automatic spawned Work Action reference.
-- `--prompt` requires an agent: it is rejected alongside `--no-spawn-agent` (create) or `--spawn-agent false` (update), since a bypassed agent never reads it.
+- `--prompt` requires a run that does the work: it is rejected alongside `--mode remind`, `--no-spawn-agent` (create) or `--spawn-agent false` (update), since a bypassed agent never reads it.
 - `--template <id>` binds the schedule to a marketplace recipe instead of a prompt you wrote. The row stores the id alone: name, brief and prompt resolve at fire time, so the job improves when the recipe does. `--description` carries what is true of this company. One row per recipe per company; a second `create` for the same id is refused.
 
 #### Marketplace recipes (`templates`)

package/dist/cli.js

@@ -5617,6 +5617,33 @@ var researchFetchResponseSchema = z17.object({
   provider: z17.literal("firecrawl")
 });
 
+// ../api/src/scheduledTaskModes.ts
+var TASK_MODES = {
+  remind: {
+    label: "Just reminds you",
+    description: "Opens the Task on schedule and leaves it for you. Nothing runs."
+  },
+  recommend: {
+    label: "Recommends",
+    description: "Opens a Task with what it would change and why. Touches nothing itself."
+  },
+  propose: {
+    label: "Prepares for review",
+    description: "Does the work and leaves it for you to review, then publish."
+  },
+  publish: {
+    label: "Publishes on its own",
+    description: "Does the work and publishes it as soon as it finishes \u2014 nobody reviews it first."
+  }
+};
+var TASK_MODE_IDS = Object.keys(TASK_MODES);
+function modeDescription(mode) {
+  return TASK_MODES[mode].description;
+}
+function isTaskMode(value) {
+  return TASK_MODE_IDS.some((id) => id === value);
+}
+
 // ../api/src/studio.ts
 import { z as z18 } from "zod";
 var studioGenerationStatusSchema = z18.enum(["running", "completed", "partial", "failed"]);
@@ -43316,8 +43343,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 +43385,31 @@ 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_MODE_ARG_DESCRIPTION = `How far a run of this task goes on its own. ${TASK_MODE_IDS.map(
+  (id) => `${id}: ${modeDescription(id)}`
+).join(" ")} Only set publish when the user asked for it outright \u2014 those runs go live unreviewed and can spend money.`;
+function parseModeFlag(raw) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  if (!isTaskMode(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 +43465,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 +43497,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 +43515,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 +43526,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 +43870,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 +43888,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 +43903,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 +43932,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 +43975,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`