@koda-sl/baker-cli 0.134.1 → 0.135.0

package/README.md

@@ -2507,7 +2507,8 @@ Permissions enforced server-side:
 
 - Only `claim`/`release` mutate live state.
 - `claim` returns action details (`id`, `name`, `description`) plus `recommendedSkills` — a fast model reads the action's name/description/tags against the local `.claude/skills/` catalog and returns the skills (`{ name, reason }`) most worth loading for the work, echoed as `/skill — reason` lines in `hints`. It is best-effort: if the catalog is absent or the model call fails, the claim still succeeds and falls back to the generic "review and load relevant skills" hint.
-- `update`, `complete`, `discard`, `unlink` require the action to be claimed by the current chat — otherwise the API returns `FORBIDDEN` with a hint to claim first.
+- `complete` and `unlink` require the action to be claimed by the current chat — otherwise the API returns `FORBIDDEN` with a hint to claim first. Completing is the record that the work is done, so it stays claim-gated.
+- `update` and `discard` do NOT require a claim — a chat may edit or retire an action it never claimed. They are blocked only when another chat currently holds the claim (`CONFLICT` with that chat's title).
 - Claiming an action already claimed by another chat returns `CONFLICT` with the other chat's title — pick a different action.
 - All staged ops are reverted automatically when the chat is discarded.
 

package/dist/cli.js

@@ -507,7 +507,7 @@ function readSkillCatalog(startDir) {
 // src/commands/actions/claim.ts
 registerSchema({
   command: "actions.claim",
-  description: "Claim an action for the current chat (live \u2014 visible to other chats immediately). Returns action details plus a fast-model recommendation of which skills to load for the work (`recommendedSkills`).",
+  description: "Claim an action for the current chat (live \u2014 visible to other chats immediately). Claim only what you're actively working on now: it's required before `complete`, but NOT for `update` or `discard` (those stage without a claim). Returns action details plus a fast-model recommendation of which skills to load for the work (`recommendedSkills`).",
   args: {
     id: { type: "string", description: "Action ID", required: true }
   }
@@ -536,7 +536,7 @@ function buildHints(recommendations) {
 var claimCommand = defineCommand({
   meta: {
     name: "claim",
-    description: "Claim an action so other chats see you're working on it. Required before update/complete/discard. Example: baker actions claim <action-id>"
+    description: "Claim an action so other chats see you're working on it. Required before `complete` (update and discard don't need a claim). Example: baker actions claim <action-id>"
   },
   args: {
     id: { type: "positional", description: "Action ID", required: false },
@@ -2752,16 +2752,16 @@ var createCommand = defineCommand3({
 import { defineCommand as defineCommand4 } from "citty";
 registerSchema({
   command: "actions.discard",
-  description: "Stage discard of a claimed action. Applies on chat publish.",
+  description: "Stage discard of an action \u2014 no claim needed; retire any action you're not working on. Applies on chat publish. Blocked only if another chat currently has it claimed.",
   args: {
-    id: { type: "string", description: "Action ID (must be claimed by current chat)", required: true },
+    id: { type: "string", description: "Action ID", required: true },
     reason: { type: "string", description: "Optional reason", required: false }
   }
 });
 var discardCommand = defineCommand4({
   meta: {
     name: "discard",
-    description: 'Stage discard of a claimed action. Example: baker actions discard <id> --reason "obsolete"'
+    description: 'Stage discard of an action (no claim needed). Example: baker actions discard <id> --reason "obsolete"'
   },
   args: {
     id: { type: "positional", description: "Action ID", required: false },
@@ -3340,9 +3340,9 @@ var unlinkCommand = defineCommand16({
 import { defineCommand as defineCommand17 } from "citty";
 registerSchema({
   command: "actions.update",
-  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).",
+  description: "Stage an update on an action (name, description, tags, and/or priority) \u2014 no claim needed; edit any action you're not working on. Applies on publish. Blocked only if another chat currently has it claimed. --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 },
+    id: { type: "string", description: "Action ID", required: true },
     name: { type: "string", description: "New name", required: false },
     description: { type: "string", description: "New description", required: false },
     tags: {
@@ -3360,7 +3360,7 @@ registerSchema({
 var updateCommand = defineCommand17({
   meta: {
     name: "update",
-    description: 'Stage an update on a claimed action. Example: baker actions update <id> --name "New name"'
+    description: 'Stage an update on an action (no claim needed). Example: baker actions update <id> --name "New name"'
   },
   args: {
     id: { type: "positional", description: "Action ID", required: false },