@hasna/todos 0.13.10 → 0.13.11

package/dist/cli/assignee-guard.d.ts

@@ -8,6 +8,13 @@
  *
  * Refusal exits the process via `handleError` (typed `never`), so a caller
  * cannot accidentally fall through to a silent self-assign.
+ *
+ * `buildSeatHint` is REQUIRED, not optional, and deliberately has no default:
+ * every call site takes the assignee on a different real shape (a
+ * `--assign <agent>` flag on three verbs, a bare positional on the fourth),
+ * so there is no invocation-shaped default that is correct everywhere. See
+ * {@link AssigneeContext.seatHint} for why a shared default was exactly the
+ * bug (todos 75296282).
  */
-export declare function resolveValidatedAssignee(value: string, allowSeat: boolean): Promise<string>;
+export declare function resolveValidatedAssignee(value: string, allowSeat: boolean, buildSeatHint: (value: string) => string): Promise<string>;
 //# sourceMappingURL=assignee-guard.d.ts.map

package/dist/cli/assignee-guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assignee-guard.d.ts","sourceRoot":"","sources":["../../src/cli/assignee-guard.ts"],"names":[],"mappings":"AAmBA;;;;;;;;;;GAUG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAejG"}
+{"version":3,"file":"assignee-guard.d.ts","sourceRoot":"","sources":["../../src/cli/assignee-guard.ts"],"names":[],"mappings":"AAmBA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,OAAO,EAClB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACvC,OAAO,CAAC,MAAM,CAAC,CAejB"}

package/dist/cli/commands/query-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/query-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgPzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,QAkqGrD"}
+{"version":3,"file":"query-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/query-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgPzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,QA6qGrD"}

package/dist/cli/commands/task-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/task-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0DzC,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAkPD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAshDpD"}
+{"version":3,"file":"task-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/task-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0DzC,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAkPD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAqiDpD"}

package/dist/cli/index.js

@@ -2123,7 +2123,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/todos",
-    version: "0.13.10",
+    version: "0.13.11",
     description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
     type: "module",
     main: "dist/index.js",
@@ -19090,10 +19090,11 @@ function validateAssignee(input, ctx) {
     if (ctx.allowSeat) {
       return { ok: true, assignee: byId ? byId.name : raw, agentId: byId?.id, isSeat: true };
     }
+    const hint = ctx.seatHint?.(raw);
     return {
       ok: false,
       reason: "seat",
-      message: `'${raw}' is a durable SEAT, and a task assigned to a seat is assigned to nobody \u2014 no session is watching that queue. ` + `Assign a specific agent, use --unassigned to file it with no owner on purpose, or pass --assign-seat if filing at the seat is what you mean.`
+      message: `'${raw}' is a durable SEAT, and a task assigned to a seat is assigned to nobody \u2014 no session is watching that queue. ` + `Assign a specific agent, use --unassigned to file it with no owner on purpose, or repeat the command with --assign-seat added to confirm the seat is deliberate` + (hint ? `: ${hint}` : " (see --help for this command's exact form).")
     };
   }
   if (byId) {
@@ -19821,10 +19822,10 @@ var init_agents = __esm(() => {
 
 // src/cli/assignee-guard.ts
 import chalk2 from "chalk";
-async function resolveValidatedAssignee(value, allowSeat) {
+async function resolveValidatedAssignee(value, allowSeat, buildSeatHint) {
   const cloud = getTodosCloudClient();
   const ctx = await loadAssigneeContext(() => cloud ? cloudListAgents(cloud) : listAgents(), allowSeat);
-  const verdict = validateAssignee(value, ctx);
+  const verdict = validateAssignee(value, { ...ctx, seatHint: buildSeatHint });
   if (!verdict.ok) {
     handleError(new Error(`Cannot assign to '${value}'. ${verdict.message}`));
   }
@@ -20344,7 +20345,7 @@ function registerTaskCommands(program2) {
     opts.list = opts.list || opts.taskList;
     const creator = resolveCreatorIdentity(opts.createdBy || globalOpts.agent);
     const router = resolveWritableIdentity(opts.createdBy || globalOpts.agent);
-    const requestedAssign = opts.assign ? await resolveValidatedAssignee(opts.assign, Boolean(opts.assignSeat)) : undefined;
+    const requestedAssign = opts.assign ? await resolveValidatedAssignee(opts.assign, Boolean(opts.assignSeat), (v) => `--assign ${v} --assign-seat`) : undefined;
     const assignee = requestedAssign || (opts.unassigned ? undefined : router.agent_id || undefined);
     if (!assignee && !opts.unassigned) {
       console.error(chalk3.yellow("Warning: task is ownerless and unattributable \u2014 export TODOS_AGENT_ID=<name> for this session, or pass --agent/--assign <agent> or --unassigned."));
@@ -20447,7 +20448,7 @@ function registerTaskCommands(program2) {
     opts.tags = opts.tags || opts.tag;
     opts.list = opts.list || opts.taskList;
     if (opts.assign) {
-      opts.assign = await resolveValidatedAssignee(opts.assign, Boolean(opts.assignSeat));
+      opts.assign = await resolveValidatedAssignee(opts.assign, Boolean(opts.assignSeat), (v) => `--assign ${v} --assign-seat`);
     }
     const explicitProject = opts.project || globalOpts.project;
     const cloud = getTodosCloudClient();
@@ -21108,7 +21109,7 @@ ${chalk3.cyan(sid)} ${statusColor(task2.status)} ${prioColor(task2.priority)} ${
       handleError(new Error("Use either --working-dir or --clear-working-dir, not both."));
     }
     if (opts.assign) {
-      opts.assign = await resolveValidatedAssignee(opts.assign, Boolean(opts.assignSeat));
+      opts.assign = await resolveValidatedAssignee(opts.assign, Boolean(opts.assignSeat), (v) => `--assign ${v} --assign-seat`);
     }
     const cloud = getTodosCloudClient();
     if (cloud) {
@@ -68355,7 +68356,7 @@ No task claimed (nothing available).`));
   });
   program2.command("assign <id> <agent>").description("Assign a task to an agent").option("-j, --json", "Output as JSON").option("--assign-seat", "Allow <agent> to name a durable seat (a seat queue has no session watching it)").action(async (id, agentInput, opts) => {
     const globalOpts = program2.opts();
-    const agent = await resolveValidatedAssignee(agentInput, Boolean(opts.assignSeat));
+    const agent = await resolveValidatedAssignee(agentInput, Boolean(opts.assignSeat), (v) => `${id} ${v} --assign-seat`);
     const cloud = getTodosCloudClient();
     if (cloud) {
       try {

package/dist/contracts.js

@@ -12009,7 +12009,7 @@ var init_tasks = __esm(() => {
 // package.json
 var package_default = {
   name: "@hasna/todos",
-  version: "0.13.10",
+  version: "0.13.11",
   description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   type: "module",
   main: "dist/index.js",

package/dist/index.js

@@ -12122,7 +12122,7 @@ var init_dispatches = __esm(() => {
 // package.json
 var package_default = {
   name: "@hasna/todos",
-  version: "0.13.10",
+  version: "0.13.11",
   description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   type: "module",
   main: "dist/index.js",

package/dist/lib/assignee-validation.d.ts

@@ -10,6 +10,28 @@ export interface AssigneeContext {
     seats: Set<string>;
     /** Caller passed `--assign-seat`: filing at a seat is deliberate. */
     allowSeat?: boolean;
+    /**
+     * Builds the exact runnable suffix that pairs `--assign-seat` with the
+     * refused value, FOR THE VERB THE CALLER IS ACTUALLY ON.
+     *
+     * This function is shared by four call sites — `add`, `update`,
+     * `task upsert`, and the standalone `assign <id> <agent>` — and three of
+     * them take the assignee via a `--assign <agent>` FLAG while the fourth
+     * takes it POSITIONALLY with no `--assign` flag at all. A single hardcoded
+     * `--assign <value> --assign-seat` snippet is therefore correct for three
+     * verbs and `error: unknown option '--assign'` on the fourth (todos
+     * 75296282, PR hasna/todos#162 review by pr162-reviewer, cycle 1): the
+     * seat-refusal message recommended an invocation the verb it was printed
+     * from does not accept — the exact class of defect the message exists to
+     * remove, relocated rather than fixed.
+     *
+     * Each call site supplies its own builder naming its own real shape, so the
+     * message can never again claim a flag a given verb does not have.
+     * Undefined falls back to naming `--assign-seat` in prose with no runnable
+     * snippet, which is always safe because it recommends no invocation shape
+     * at all.
+     */
+    seatHint?: (value: string) => string;
 }
 /**
  * Three outcomes, and the split between REFUSE and WARN is evidence-driven

package/dist/lib/assignee-validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assignee-validation.d.ts","sourceRoot":"","sources":["../../src/lib/assignee-validation.ts"],"names":[],"mappings":"AA2CA,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,gEAAgE;IAChE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACnF;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;CAC3B,CAAC;AAEN;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAK9C;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAAgC,GAAG,GAAG,CAAC,MAAM,CAAC,CAajF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,eAAe,CAoErF"}
+{"version":3,"file":"assignee-validation.d.ts","sourceRoot":"","sources":["../../src/lib/assignee-validation.ts"],"names":[],"mappings":"AA2CA,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,gEAAgE;IAChE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACnF;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;CAC3B,CAAC;AAEN;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAK9C;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAAgC,GAAG,GAAG,CAAC,MAAM,CAAC,CAajF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,eAAe,CAsErF"}

package/dist/mcp/index.js

@@ -18012,10 +18012,11 @@ function validateAssignee(input, ctx) {
     if (ctx.allowSeat) {
       return { ok: true, assignee: byId ? byId.name : raw, agentId: byId?.id, isSeat: true };
     }
+    const hint = ctx.seatHint?.(raw);
     return {
       ok: false,
       reason: "seat",
-      message: `'${raw}' is a durable SEAT, and a task assigned to a seat is assigned to nobody \u2014 no session is watching that queue. ` + `Assign a specific agent, use --unassigned to file it with no owner on purpose, or pass --assign-seat if filing at the seat is what you mean.`
+      message: `'${raw}' is a durable SEAT, and a task assigned to a seat is assigned to nobody \u2014 no session is watching that queue. ` + `Assign a specific agent, use --unassigned to file it with no owner on purpose, or repeat the command with --assign-seat added to confirm the seat is deliberate` + (hint ? `: ${hint}` : " (see --help for this command's exact form).")
     };
   }
   if (byId) {
@@ -34842,7 +34843,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/todos",
-    version: "0.13.10",
+    version: "0.13.11",
     description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
     type: "module",
     main: "dist/index.js",

package/dist/mcp.js

@@ -41,7 +41,7 @@ var __require = import.meta.require;
 // package.json
 var package_default = {
   name: "@hasna/todos",
-  version: "0.13.10",
+  version: "0.13.11",
   description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   type: "module",
   main: "dist/index.js",

package/dist/registry.js

@@ -12009,7 +12009,7 @@ var init_tasks = __esm(() => {
 // package.json
 var package_default = {
   name: "@hasna/todos",
-  version: "0.13.10",
+  version: "0.13.11",
   description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   type: "module",
   main: "dist/index.js",

package/dist/release-provenance.json

@@ -1,9 +1,9 @@
 {
   "packageName": "@hasna/todos",
-  "packageVersion": "0.13.10",
+  "packageVersion": "0.13.11",
   "repository": "https://github.com/hasna/todos.git",
-  "gitCommit": "caef21b58b4e8d4cd7996e57bc922504c98ddee9",
-  "gitTree": "574134d0b7552948e8f31013b4b247fd8ec6d187",
-  "sourceTreeSha256": "eca04b82f06e0d20a8f744e7efc9091afa1f0606b4899d473ee1c44e0966769c",
-  "generatedAt": "2026-08-02T04:51:15.000Z"
+  "gitCommit": "af551bd57da4ef1835d763232c1e3b3b8cee4f9f",
+  "gitTree": "23029d1f9a1afeecf519674e13746e615431ae8b",
+  "sourceTreeSha256": "b14e57ef9ec0cbd0e0142681b993aa34c941d59a18649ddd499f3ee1a62cfef9",
+  "generatedAt": "2026-08-02T06:21:53.000Z"
 }

package/dist/server/index.js

@@ -70,7 +70,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/todos",
-    version: "0.13.10",
+    version: "0.13.11",
     description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
     type: "module",
     main: "dist/index.js",
@@ -44798,10 +44798,11 @@ function validateAssignee(input, ctx) {
     if (ctx.allowSeat) {
       return { ok: true, assignee: byId ? byId.name : raw, agentId: byId?.id, isSeat: true };
     }
+    const hint = ctx.seatHint?.(raw);
     return {
       ok: false,
       reason: "seat",
-      message: `'${raw}' is a durable SEAT, and a task assigned to a seat is assigned to nobody \u2014 no session is watching that queue. ` + `Assign a specific agent, use --unassigned to file it with no owner on purpose, or pass --assign-seat if filing at the seat is what you mean.`
+      message: `'${raw}' is a durable SEAT, and a task assigned to a seat is assigned to nobody \u2014 no session is watching that queue. ` + `Assign a specific agent, use --unassigned to file it with no owner on purpose, or repeat the command with --assign-seat added to confirm the seat is deliberate` + (hint ? `: ${hint}` : " (see --help for this command's exact form).")
     };
   }
   if (byId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/todos",
-  "version": "0.13.10",
+  "version": "0.13.11",
   "description": "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   "type": "module",
   "main": "dist/index.js",