@koda-sl/baker-cli 0.96.0 → 0.97.0

package/README.md

@@ -2347,12 +2347,14 @@ baker actions status temp_hero jx123       # batch resolve real IDs and temp_* r
 baker actions claim <action-id>            # live — returns action details + skill-loading hints
 baker actions release <action-id>
 
-baker actions create --name "Build hero" --tags landing,creative --description "..."
-# → returns { ok, data: { tempId }, hints: [...] } — check hints for tags/dependencies/description reminders
+baker actions create --name "Build hero" --priority high --tags landing,creative --description "..."
+# → returns { ok, data: { tempId }, hints: [...] } — check hints for tags/priority/dependencies/description reminders
 # If the name/description reads as recurring or future-dated (e.g. "weekly", "every Monday", "schedule"),
 # create emits a hint to use `baker scheduled-actions create` instead of a Work Action.
-# If no --tags are passed, create emits a hint to add them so the action is filterable.
+# If no --tags are passed, create emits a MISSING --tags hint — the action is invisible to the backlog's tag filter.
+# If no --priority is passed, create emits a MISSING --priority hint — the action ranks as normal/medium in the do-first order.
 baker actions update <action-id> --name "Better name" --tags google-ads,strategy  # --tags REPLACES the set; '' clears
+baker actions update <action-id> --priority urgent                              # urgent|high|medium|low; 'none' clears
 baker actions complete <action-id-or-tempId> --note "What was done"  # stages — applies on chat publish
 baker actions discard <action-id> --reason "obsolete"
 

package/dist/cli.js

@@ -483,6 +483,33 @@ var SCHEDULE_SIGNALS = [
   /\bremind(?:er|s)?\b/i,
   /\brun\s+at\b/i
 ];
+var ACTION_PRIORITIES = ["urgent", "high", "medium", "low"];
+function parsePriority(value, { allowClear }) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value !== "string") {
+    failValidation(
+      `--priority must be one of: ${ACTION_PRIORITIES.join(", ")}${allowClear ? ", or 'none' to clear" : ""}.`
+    );
+  }
+  const trimmed = value.trim().toLowerCase();
+  if (trimmed === "") {
+    if (allowClear) {
+      return null;
+    }
+    return void 0;
+  }
+  if (allowClear && (trimmed === "none" || trimmed === "clear")) {
+    return null;
+  }
+  if (ACTION_PRIORITIES.includes(trimmed)) {
+    return trimmed;
+  }
+  failValidation(
+    `Unknown --priority "${value}". Expected one of: ${ACTION_PRIORITIES.join(", ")}${allowClear ? ", or 'none' to clear" : ""}.`
+  );
+}
 function looksScheduled(name, description) {
   const haystack = `${name}
 ${description}`;
@@ -570,7 +597,7 @@ var completeCommand = defineCommand2({
 import { defineCommand as defineCommand3 } from "citty";
 registerSchema({
   command: "actions.create",
-  description: "Stage creation of a new action (applies when the chat is published). Returns a tempId you can use to link in the same draft. Tag the action with --tags (strongly encouraged \u2014 run `baker actions tags list` for the taxonomy). After creating, check if this action blocks or is blocked by other actions and wire dependencies with `baker actions link`.",
+  description: "Stage creation of a new action (applies when the chat is published). Returns a tempId you can use to link in the same draft. Pass --tags (REQUIRED \u2014 run `baker actions tags list` for the taxonomy) and --priority (one of urgent|high|medium|low \u2014 drives the dependency-aware 'Do first' ordering). After creating, check if this action blocks or is blocked by other actions and wire dependencies with `baker actions link`.",
   args: {
     name: { type: "string", description: "Action name (short, action-verb, \u22646 words)", required: true },
     description: {
@@ -583,6 +610,11 @@ registerSchema({
       description: "Comma-separated tag slugs (e.g. google-ads,audit-finding). Must be known \u2014 see `baker actions tags list`.",
       required: false
     },
+    priority: {
+      type: "string",
+      description: `User priority for the do-first ordering. One of: ${ACTION_PRIORITIES.join(", ")}.`,
+      required: false
+    },
     "temp-id": { type: "string", description: "Custom tempId (auto-generated if omitted)", required: false }
   }
 });
@@ -595,6 +627,7 @@ var createCommand = defineCommand3({
     name: { type: "string", description: "Action name", required: false },
     description: { type: "string", description: "Description", required: false, default: "" },
     tags: { type: "string", description: "Comma-separated tag slugs (see `baker actions tags list`)", required: false },
+    priority: { type: "string", description: `User priority: ${ACTION_PRIORITIES.join("|")}`, required: false },
     "temp-id": { type: "string", description: "Optional custom tempId", required: false }
   },
   run: async ({ args }) => {
@@ -606,12 +639,14 @@ var createCommand = defineCommand3({
       const chatId = requireChatId();
       const tempId = args["temp-id"] || generateTempId();
       const tags = parseTagList(args.tags);
+      const priority = parsePriority(args.priority, { allowClear: false });
       const response = await apiPost("/api/actions/create", {
         chatId,
         tempId,
         name,
         description: args.description ?? "",
-        ...tags ? { tags } : {}
+        ...tags ? { tags } : {},
+        ...priority !== void 0 && priority !== null ? { priority } : {}
       });
       const hints = [];
       if (looksScheduled(name, args.description ?? "")) {
@@ -625,7 +660,12 @@ var createCommand = defineCommand3({
       }
       if (!tags || tags.length === 0) {
         hints.push(
-          "Tag this action so it's filterable in the backlog: re-run with --tags <slug,...> (run `baker actions tags list` for the taxonomy, or `baker actions update <tempId> --tags <slug,...>`)."
+          "MISSING --tags. This action is invisible to the backlog's tag filter. Re-run with --tags <slug,...> (`baker actions tags list` for the taxonomy, `baker actions tags create --slug <slug>` to mint) \u2014 or `baker actions update <tempId> --tags <slug,...>`."
+        );
+      }
+      if (priority === void 0) {
+        hints.push(
+          `MISSING --priority. Without it this action ranks as 'normal' (medium) in the do-first ordering, so urgent/high client work won't surface first. Re-run with --priority ${ACTION_PRIORITIES.join("|")} \u2014 or \`baker actions update <tempId> --priority <level>\`.`
         );
       }
       writeJson({ ...response, hints });
@@ -1161,7 +1201,7 @@ var unlinkCommand = defineCommand15({
 import { defineCommand as defineCommand16 } from "citty";
 registerSchema({
   command: "actions.update",
-  description: "Stage an update on a claimed action (name, description, and/or tags). Applies on publish. --tags REPLACES the tag set; pass --tags '' to clear all tags. Tags must be known \u2014 see `baker actions tags list`.",
+  description: "Stage an update on a claimed action (name, description, tags, and/or priority). Applies on publish. --tags REPLACES the tag set; pass --tags '' to clear. --priority accepts urgent|high|medium|low or 'none' to clear back to unset (== normal).",
   args: {
     id: { type: "string", description: "Action ID (must be claimed by current chat)", required: true },
     name: { type: "string", description: "New name", required: false },
@@ -1170,6 +1210,11 @@ registerSchema({
       type: "string",
       description: "Comma-separated tag slugs \u2014 REPLACES existing tags ('' clears)",
       required: false
+    },
+    priority: {
+      type: "string",
+      description: `User priority: ${ACTION_PRIORITIES.join("|")}, or 'none' to clear.`,
+      required: false
     }
   }
 });
@@ -1183,7 +1228,8 @@ var updateCommand = defineCommand16({
     "action-id": { type: "string", description: "Action ID", required: false },
     name: { type: "string", description: "New name", required: false },
     description: { type: "string", description: "New description", required: false },
-    tags: { type: "string", description: "Comma-separated tag slugs \u2014 REPLACES existing ('' clears)", required: false }
+    tags: { type: "string", description: "Comma-separated tag slugs \u2014 REPLACES existing ('' clears)", required: false },
+    priority: { type: "string", description: `Priority: ${ACTION_PRIORITIES.join("|")}|none`, required: false }
   },
   run: async ({ args }) => {
     try {
@@ -1193,8 +1239,9 @@ var updateCommand = defineCommand16({
       }
       validateConvexId(id);
       const tags = parseTagList(args.tags);
-      if (args.name === void 0 && args.description === void 0 && tags === void 0) {
-        failValidation("Provide at least one of --name, --description, --tags.");
+      const priority = parsePriority(args.priority, { allowClear: true });
+      if (args.name === void 0 && args.description === void 0 && tags === void 0 && priority === void 0) {
+        failValidation("Provide at least one of --name, --description, --tags, --priority.");
       }
       const chatId = requireChatId();
       await apiPost("/api/actions/update", {
@@ -1202,7 +1249,8 @@ var updateCommand = defineCommand16({
         actionId: id,
         name: args.name,
         description: args.description,
-        ...tags !== void 0 ? { tags } : {}
+        ...tags !== void 0 ? { tags } : {},
+        ...priority !== void 0 ? { priority } : {}
       });
       writeOk();
     } catch (err) {