takibibase 1.15.1 → 1.16.0

package/SKILL.md

@@ -71,9 +71,11 @@ error hints.
   follow-up). Needs the create cap; naming anyone other than yourself
   needs Orchestrator. The card lands at To do, unassigned unless
   `--assignee` names someone — claim it before driving it.
-- `takibi tasks update <id> [--title …] [--body …] [--due …]` — amend a
-  card without spinning a follow-up (at least one flag; empty `--due`
-  clears the date). A holder edits its own card; an orchestrator may
+- `takibi tasks update <id> [--title …] [--body …] [--due …] [--blocked [--reason …]] [--unblocked]` —
+  amend a card without spinning a follow-up (at least one flag; empty `--due`
+  clears the date). `--blocked` flags the card (optional `--reason`, max 500
+  chars, also usable alone to rewrite the reason); `--unblocked` clears the
+  flag and its reason. A holder edits its own card; an orchestrator may
   edit any card on the board. Title/body edits need the create cap.
 - `@name` in a task names the handoff target: the FIRST explicit
   `assign to @name` (or the first @name clearly meaning "who gets the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "takibibase",
-  "version": "1.15.1",
+  "version": "1.16.0",
   "description": "Thin CLI for the Takibi API: ask, search, tasks, docs, notes. Single file, zero dependencies.",
   "type": "module",
   "bin": {

package/takibi.mjs

@@ -39,7 +39,7 @@ import { homedir } from 'node:os';
 import { basename, join } from 'node:path';
 
 /** Baked fallback; the published package re-reads package.json next door. */
-const BAKED_VERSION = '1.15.1';
+const BAKED_VERSION = '1.16.0';
 const CLI_INFO = (() => {
   try {
     const pkg = JSON.parse(readFileSync(new URL('./package.json', import.meta.url), 'utf8'));
@@ -377,7 +377,7 @@ Commands:
   tasks create            Open a fresh card [--title/--body/--assignee/--due]
   tasks claim <id>        Claim an open to-do card (atomic, one winner)
   tasks status <id> <st>  Move a card: todo | in_progress | review | done [--note <text>]
-  tasks update <id>       Amend a card's title, body, or due date [--title/--body/--due]
+  tasks update <id>       Amend a card's title, body, due date, or blocked state [--title/--body/--due/--blocked/--unblocked/--reason]
   tasks handoff <id> <profile>  Hand a card you hold to another profile [--review --note <text>]
   tasks follow-up <id>  Spin a fresh linked todo off any card [--title/--body/--assignee/--due]
   tasks escalate <id>       Ask the Founder for help on a held card [--reason <text>]
@@ -493,9 +493,9 @@ function parseArgv(argv) {
       i = ni;
     }
     else if (a.startsWith('--folder=')) globals.folder = a.slice('--folder='.length);
-    else if (a === '--query' || a === '-q' || a === '--q' || a === '-k' || a === '--limit' || a === '--max-chars' || a === '--all' || a === '--review' || a === '--add' || a === '--note' || a === '--reason' || a === '--size' || a === '--hash' || a === '--markdown' || a === '--title' || a === '--body' || a === '--assignee' || a === '--due' || a === '--problem' || a === '--tried' || a === '--worked' || a === '--failed' || a === '--next-time' || a === '--source' || a === '--since' || a === '--run-id' || a === '--install' || a === '--force' || a === '--agents' || a === '--claude' || a === '--codex' || a === '--dir') {
+    else if (a === '--query' || a === '-q' || a === '--q' || a === '-k' || a === '--limit' || a === '--max-chars' || a === '--all' || a === '--review' || a === '--add' || a === '--note' || a === '--reason' || a === '--size' || a === '--hash' || a === '--markdown' || a === '--title' || a === '--body' || a === '--assignee' || a === '--due' || a === '--blocked' || a === '--unblocked' || a === '--problem' || a === '--tried' || a === '--worked' || a === '--failed' || a === '--next-time' || a === '--source' || a === '--since' || a === '--run-id' || a === '--install' || a === '--force' || a === '--agents' || a === '--claude' || a === '--codex' || a === '--dir') {
       rest.push(a);
-      if (a !== '--all' && a !== '--review' && a !== '--install' && a !== '--force' && a !== '--agents' && a !== '--claude' && a !== '--codex') {
+      if (a !== '--all' && a !== '--review' && a !== '--blocked' && a !== '--unblocked' && a !== '--install' && a !== '--force' && a !== '--agents' && a !== '--claude' && a !== '--codex') {
         const [v, ni] = takeValue(a, i);
         rest.push(v);
         i = ni;
@@ -856,25 +856,37 @@ async function cmdTasks(tokens, globals) {
     return;
   }
   if (sub === 'update') {
-    const usage = 'Usage: takibi tasks update <id> [--title <text>] [--body <text>] [--due <date>]';
+    const usage = 'Usage: takibi tasks update <id> [--title <text>] [--body <text>] [--due <date>] [--blocked] [--unblocked] [--reason <text>]';
     const [id, ...flagTokens] = rest;
     if (!id || id.startsWith('--')) throw usageError(usage);
     let title;
     let body;
     let due;
+    let blocked;
+    let reason;
     for (let i = 0; i < flagTokens.length; i++) {
       const f = flagTokens[i];
       if (f === '--title') title = flagTokens[++i];
       else if (f === '--body') body = flagTokens[++i];
       else if (f === '--due') due = flagTokens[++i];
+      else if (f === '--blocked') {
+        if (blocked === false) throw usageError(`--blocked and --unblocked conflict. ${usage}`);
+        blocked = true;
+      } else if (f === '--unblocked') {
+        if (blocked === true) throw usageError(`--blocked and --unblocked conflict. ${usage}`);
+        blocked = false;
+      } else if (f === '--reason') reason = flagTokens[++i];
       else throw usageError(`Unexpected ${JSON.stringify(f)}. ${usage}`);
     }
-    if (title === undefined && body === undefined && due === undefined) {
-      throw usageError(`Nothing to change — pass at least one of --title, --body, --due. ${usage}`);
+    if (title === undefined && body === undefined && due === undefined && blocked === undefined && reason === undefined) {
+      throw usageError(`Nothing to change — pass at least one of --title, --body, --due, --blocked, --unblocked, --reason. ${usage}`);
     }
     if (title !== undefined && title.trim() === '') throw usageError('--title needs non-empty text.');
     if (title !== undefined && title.trim().length > 300) throw usageError('--title is max 300 chars.');
     if (body !== undefined && body.length > 20000) throw usageError('--body is max 20000 chars.');
+    if (blocked === false && reason !== undefined) throw usageError('--reason cannot ride with --unblocked (unblocking clears the reason).');
+    if (reason !== undefined && reason.trim() === '') throw usageError('--reason needs non-empty text.');
+    if (reason !== undefined && reason.length > 500) throw usageError('--reason is max 500 chars.');
     // An explicit empty --due clears the date (the server treats '' and
     // null as clear). Create keeps rejecting it: omit and clear are the
     // same on POST.
@@ -883,7 +895,7 @@ async function cmdTasks(tokens, globals) {
     const data = await api('PATCH', `/v1/tasks/${id}`, {
       ...ctx,
       query: qparams([['projectId', ctx.projectId]]),
-      body: { title: title?.trim(), body, dueAt: due },
+      body: { title: title?.trim(), body, dueAt: due, blocked, blockedReason: reason },
       label: 'tasks update',
     });
     if (ctx.json) out(JSON.stringify(data, null, 2));