aitasks 1.4.2 → 1.4.3

package/README.md

@@ -1,213 +1,215 @@
-# aitasks
-
-> CLI task management built for AI agents.
-
-`aitasks` gives AI agents (Claude, Gemini, GPT, etc.) a structured task queue to work from. Agents can claim tasks, log progress notes, verify acceptance criteria with evidence, and hand off work — all via simple shell commands.
-
-**Requires [Bun](https://bun.sh) ≥ 1.0.0.**
-
----
-
-## Install
-
-```sh
-bun install -g aitasks
-```
-
-## Quick Start
-
-```sh
-# 1. Initialize in your project
-aitasks init
-
-# 2. Create a task
-aitasks create --title "Add JWT auth" --desc "Implement user authentication" --priority high --ac "POST /login returns token" --ac "Token expires in 1h"
-
-# 3. Agent picks up work (one-liner with auto-claim)
-aitasks next --claim --agent claude-sonnet
-
-# 4. Or claim and start separately
-aitasks claim TASK-001 --agent claude-sonnet
-aitasks start TASK-001 --agent claude-sonnet
-
-# 5. Log notes along the way
-aitasks note TASK-001 "Using bcrypt for hashing — src/auth.ts:L22" --agent claude-sonnet
-
-# 6. Verify acceptance criteria
-aitasks check TASK-001 0 --evidence "POST /login returns 200 with token field" --agent claude-sonnet
-aitasks check TASK-001 1 --evidence "token exp claim set to now+3600, confirmed in jwt.test.ts:L14"
-
-# 7. Mark done
-aitasks done TASK-001 --agent claude-sonnet
-```
-
-**Pro tips:**
-- Use `aitasks next --claim --agent <id>` to find, claim, and start in one command
-- Bulk operations: `aitasks done TASK-001 TASK-002 TASK-003 --agent <id>`
-- Pattern matching: `aitasks claim TASK-0* --agent <id>` claims all TASK-00x tasks
-- Search: `aitasks search "auth"` finds tasks mentioning authentication
-- Undo mistakes: `aitasks undo TASK-001`
-- Delete tasks: `aitasks delete TASK-001` (no need to claim first)
-
----
-
-## Environment Variables
-
-| Variable | Description |
-|---|---|
-| `AITASKS_AGENT_ID` | Default agent ID — avoids passing `--agent` on every command |
-| `AITASKS_JSON` | Set to `true` to force JSON output globally (useful for scripting) |
-
-```sh
-export AITASKS_AGENT_ID=claude-sonnet
-export AITASKS_JSON=true
-```
-
----
-
-## Commands
-
-### Setup
-
-| Command | Description |
-|---|---|
-| `aitasks init` | Initialize a task database in the current project |
-| `aitasks init --with-review` | Initialize with review enforcement (agents cannot mark done without a passing review) |
-| `aitasks onboard` | Print or inject agent protocol instructions into CLAUDE.md / AGENTS.md |
-
-### Task Discovery
-
-| Command | Description |
-|---|---|
-| `aitasks list` | List all tasks, sorted by priority |
-| `aitasks list --status ready` | Filter by status (`ready`, `in_progress`, `blocked`, `review`, `done`) |
-| `aitasks next` | Show the highest-priority unblocked ready task |
-| `aitasks next --claim --agent <id>` | Auto-claim and start the best task |
-| `aitasks show <id>` | Full detail on a specific task (includes time tracking) |
-| `aitasks search <query>` | Full-text search across titles, descriptions, and notes |
-| `aitasks deps <id>` | Show dependency tree (what blocks what) |
-| `aitasks board` | Kanban-style board view |
-
-### Task Lifecycle
-
-| Command | Description |
-|---|---|
-| `aitasks create` | Create a task (interactive if no flags given) |
-| `aitasks claim <id...> --agent <id>` | Claim task(s) - supports patterns like `TASK-0*` |
-| `aitasks start <id...> --agent <id>` | Begin active work on task(s) |
-| `aitasks note <id> <text>` | Add an implementation note |
-| `aitasks check <id> <n> --evidence <text>` | Verify acceptance criterion n |
-| `aitasks done <id...> --agent <id>` | Mark task(s) complete (all criteria must be verified; must be in `review` status if enforcement is on) |
-| `aitasks review <id...> --agent <id>` | Submit task(s) for review (moves to `review` status) |
-| `aitasks reject <id> --reason <text>` | Reject a task in review, send it back to `in_progress` with feedback |
-| `aitasks unclaim <id> --agent <id>` | Release a task back to the pool |
-| `aitasks undo <id>` | Undo the last action on a task |
-| `aitasks delete <id...>` | Delete task(s) - does not require claiming first |
-
-**Note:** Commands marked with `<id...>` support multiple task IDs and pattern matching (e.g., `TASK-0*`).
-
-### Blocking
-
-| Command | Description |
-|---|---|
-| `aitasks block <id> --on <id,...>` | Mark a task as blocked by others |
-| `aitasks unblock <id> --from <id>` | Manually remove a blocker |
-
-### Agents & History
-
-| Command | Description |
-|---|---|
-| `aitasks agents` | List active agents and their current tasks |
-| `aitasks heartbeat [taskId]` | Update agent last-seen timestamp |
-| `aitasks log <id>` | Full event history for a task |
-| `aitasks export --format json` | Export all tasks as JSON |
-| `aitasks export --format csv` | Export all tasks as CSV |
-
-### Database
-
-| Command | Description |
-|---|---|
-| `aitasks db status` | Show database health and stats |
-
----
-
-## `create` Flags
-
-```sh
-aitasks create \
-  --title "My task" \
-  --desc "Longer description" \
-  --ac "Returns 200" \          # Acceptance criterion (repeatable, at least one required)
-  --priority high \             # critical | high | medium | low
-  --type feature \              # feature | bug | chore | spike
-  --parent TASK-001 \           # Parent task ID (optional)
-  --agent $AITASKS_AGENT_ID     # Agent creating the task (logged in event history)
-```
-
----
-
-## Agent Protocol
-
-When you run `aitasks init`, it automatically injects a full agent protocol into `CLAUDE.md`, `AGENTS.md`, or `GEMINI.md` (whichever exists, or creates `AGENTS.md`). This tells the AI agent exactly how to use `aitasks`.
-
-You can also inject/view it manually:
-
-```sh
-aitasks onboard               # print to stdout (reflects current review_required setting)
-aitasks onboard --append      # append to detected agent file
-aitasks onboard --file MY.md  # append to a specific file
-aitasks onboard --json        # output as JSON string
-```
-
-The injected instructions automatically adapt to the project's review enforcement setting — if `--with-review` is enabled, agents receive the full review workflow (with `aitasks review`, sub-agent approval, and `aitasks reject`) instead of the standard completion flow.
-
----
-
-## Review Enforcement
-
-Enable a mandatory review gate so agents cannot mark tasks done without an explicit approval step:
-
-```sh
-# Enable at init time
-aitasks init --with-review
-
-# Enable on an existing project (also replaces the agent instructions file with review-aware version)
-aitasks init --with-review  # safe to re-run; updates DB setting and rewrites agent file
-```
-
-**A task is only complete when its status is `done`.** No other status — verified criteria, `review`, `in_progress` — counts as complete. Agents must reach `done` to consider a task finished.
-
-**How it works:**
-
-1. Agent completes work and verifies all acceptance criteria with evidence
-2. Agent submits for review — task moves to `review` status:
-   ```sh
-   aitasks review TASK-001 --agent $AITASKS_AGENT_ID
-   ```
-   The command output explicitly instructs the agent to immediately spawn a review sub-agent. The task is **not complete** at this point.
-3. The agent **immediately spawns a review sub-agent** to inspect the implementation:
-   - **Approves** — moves task to done:
-     ```sh
-     aitasks done TASK-001 --agent review-agent
-     ```
-   - **Rejects** — sends it back to `in_progress` with feedback:
-     ```sh
-     aitasks reject TASK-001 --reason "Missing error handling for 404 case" --agent review-agent
-     ```
-4. If rejected, the original agent addresses the feedback, re-verifies criteria, and repeats from step 2.
-
-**Enforcement:** `aitasks done` and `aitasks update --status done` both block if the task isn't already in `review` status. The gate cannot be bypassed.
-
-**Board:** Tasks in `review` status appear in the **IN PROGRESS** section with a `◈` magenta indicator so they're visually distinct from actively-worked tasks.
-
----
-
-## Data Storage
-
-`aitasks init` creates a `.aitasks/` directory in your project root containing a SQLite database. Add `.aitasks/` to your `.gitignore` if you don't want to commit task data, or commit it to share tasks across your team.
-
----
-
-## License
-
-MIT
+[![DOWNLOADS](https://img.shields.io/npm/dt/aitasks?label=npm&colorA=151B23&colorB=81F096&style=for-the-badge)](https://www.npmjs.com/package/aitasks)
+
+# aitasks
+
+> CLI task management built for AI agents.
+
+`aitasks` gives AI agents (Claude, Gemini, GPT, etc.) a structured task queue to work from. Agents can claim tasks, log progress notes, verify acceptance criteria with evidence, and hand off work — all via simple shell commands.
+
+**Requires [Bun](https://bun.sh) ≥ 1.0.0.**
+
+---
+
+## Install
+
+```sh
+bun install -g aitasks
+```
+
+## Quick Start
+
+```sh
+# 1. Initialize in your project
+aitasks init
+
+# 2. Create a task
+aitasks create --title "Add JWT auth" --desc "Implement user authentication" --priority high --ac "POST /login returns token" --ac "Token expires in 1h"
+
+# 3. Agent picks up work (one-liner with auto-claim)
+aitasks next --claim --agent claude-sonnet
+
+# 4. Or claim and start separately
+aitasks claim TASK-001 --agent claude-sonnet
+aitasks start TASK-001 --agent claude-sonnet
+
+# 5. Log notes along the way
+aitasks note TASK-001 "Using bcrypt for hashing — src/auth.ts:L22" --agent claude-sonnet
+
+# 6. Verify acceptance criteria
+aitasks check TASK-001 0 --evidence "POST /login returns 200 with token field" --agent claude-sonnet
+aitasks check TASK-001 1 --evidence "token exp claim set to now+3600, confirmed in jwt.test.ts:L14"
+
+# 7. Mark done
+aitasks done TASK-001 --agent claude-sonnet
+```
+
+**Pro tips:**
+- Use `aitasks next --claim --agent <id>` to find, claim, and start in one command
+- Bulk operations: `aitasks done TASK-001 TASK-002 TASK-003 --agent <id>`
+- Pattern matching: `aitasks claim TASK-0* --agent <id>` claims all TASK-00x tasks
+- Search: `aitasks search "auth"` finds tasks mentioning authentication
+- Undo mistakes: `aitasks undo TASK-001`
+- Delete tasks: `aitasks delete TASK-001` (no need to claim first)
+
+---
+
+## Environment Variables
+
+| Variable | Description |
+|---|---|
+| `AITASKS_AGENT_ID` | Default agent ID — avoids passing `--agent` on every command |
+| `AITASKS_JSON` | Set to `true` to force JSON output globally (useful for scripting) |
+
+```sh
+export AITASKS_AGENT_ID=claude-sonnet
+export AITASKS_JSON=true
+```
+
+---
+
+## Commands
+
+### Setup
+
+| Command | Description |
+|---|---|
+| `aitasks init` | Initialize a task database in the current project |
+| `aitasks init --with-review` | Initialize with review enforcement (agents cannot mark done without a passing review) |
+| `aitasks onboard` | Print or inject agent protocol instructions into CLAUDE.md / AGENTS.md |
+
+### Task Discovery
+
+| Command | Description |
+|---|---|
+| `aitasks list` | List all tasks, sorted by priority |
+| `aitasks list --status ready` | Filter by status (`ready`, `in_progress`, `blocked`, `review`, `done`) |
+| `aitasks next` | Show the highest-priority unblocked ready task |
+| `aitasks next --claim --agent <id>` | Auto-claim and start the best task |
+| `aitasks show <id>` | Full detail on a specific task (includes time tracking) |
+| `aitasks search <query>` | Full-text search across titles, descriptions, and notes |
+| `aitasks deps <id>` | Show dependency tree (what blocks what) |
+| `aitasks board` | Kanban-style board view |
+
+### Task Lifecycle
+
+| Command | Description |
+|---|---|
+| `aitasks create` | Create a task (interactive if no flags given) |
+| `aitasks claim <id...> --agent <id>` | Claim task(s) - supports patterns like `TASK-0*` |
+| `aitasks start <id...> --agent <id>` | Begin active work on task(s) |
+| `aitasks note <id> <text>` | Add an implementation note |
+| `aitasks check <id> <n> --evidence <text>` | Verify acceptance criterion n |
+| `aitasks done <id...> --agent <id>` | Mark task(s) complete (all criteria must be verified; must be in `review` status if enforcement is on) |
+| `aitasks review <id...> --agent <id>` | Submit task(s) for review (moves to `review` status) |
+| `aitasks reject <id> --reason <text>` | Reject a task in review, send it back to `in_progress` with feedback |
+| `aitasks unclaim <id> --agent <id>` | Release a task back to the pool |
+| `aitasks undo <id>` | Undo the last action on a task |
+| `aitasks delete <id...>` | Delete task(s) - does not require claiming first |
+
+**Note:** Commands marked with `<id...>` support multiple task IDs and pattern matching (e.g., `TASK-0*`).
+
+### Blocking
+
+| Command | Description |
+|---|---|
+| `aitasks block <id> --on <id,...>` | Mark a task as blocked by others |
+| `aitasks unblock <id> --from <id>` | Manually remove a blocker |
+
+### Agents & History
+
+| Command | Description |
+|---|---|
+| `aitasks agents` | List active agents and their current tasks |
+| `aitasks heartbeat [taskId]` | Update agent last-seen timestamp |
+| `aitasks log <id>` | Full event history for a task |
+| `aitasks export --format json` | Export all tasks as JSON |
+| `aitasks export --format csv` | Export all tasks as CSV |
+
+### Database
+
+| Command | Description |
+|---|---|
+| `aitasks db status` | Show database health and stats |
+
+---
+
+## `create` Flags
+
+```sh
+aitasks create \
+  --title "My task" \
+  --desc "Longer description" \
+  --ac "Returns 200" \          # Acceptance criterion (repeatable, at least one required)
+  --priority high \             # critical | high | medium | low
+  --type feature \              # feature | bug | chore | spike
+  --parent TASK-001 \           # Parent task ID (optional)
+  --agent $AITASKS_AGENT_ID     # Agent creating the task (logged in event history)
+```
+
+---
+
+## Agent Protocol
+
+When you run `aitasks init`, it automatically injects a full agent protocol into `CLAUDE.md`, `AGENTS.md`, or `GEMINI.md` (whichever exists, or creates `AGENTS.md`). This tells the AI agent exactly how to use `aitasks`.
+
+You can also inject/view it manually:
+
+```sh
+aitasks onboard               # print to stdout (reflects current review_required setting)
+aitasks onboard --append      # append to detected agent file
+aitasks onboard --file MY.md  # append to a specific file
+aitasks onboard --json        # output as JSON string
+```
+
+The injected instructions automatically adapt to the project's review enforcement setting — if `--with-review` is enabled, agents receive the full review workflow (with `aitasks review`, sub-agent approval, and `aitasks reject`) instead of the standard completion flow.
+
+---
+
+## Review Enforcement
+
+Enable a mandatory review gate so agents cannot mark tasks done without an explicit approval step:
+
+```sh
+# Enable at init time
+aitasks init --with-review
+
+# Enable on an existing project (also replaces the agent instructions file with review-aware version)
+aitasks init --with-review  # safe to re-run; updates DB setting and rewrites agent file
+```
+
+**A task is only complete when its status is `done`.** No other status — verified criteria, `review`, `in_progress` — counts as complete. Agents must reach `done` to consider a task finished.
+
+**How it works:**
+
+1. Agent completes work and verifies all acceptance criteria with evidence
+2. Agent submits for review — task moves to `review` status:
+   ```sh
+   aitasks review TASK-001 --agent $AITASKS_AGENT_ID
+   ```
+   The command output explicitly instructs the agent to immediately spawn a review sub-agent. The task is **not complete** at this point.
+3. The agent **immediately spawns a review sub-agent** to inspect the implementation:
+   - **Approves** — moves task to done:
+     ```sh
+     aitasks done TASK-001 --agent review-agent
+     ```
+   - **Rejects** — sends it back to `in_progress` with feedback:
+     ```sh
+     aitasks reject TASK-001 --reason "Missing error handling for 404 case" --agent review-agent
+     ```
+4. If rejected, the original agent addresses the feedback, re-verifies criteria, and repeats from step 2.
+
+**Enforcement:** `aitasks done` and `aitasks update --status done` both block if the task isn't already in `review` status. The gate cannot be bypassed.
+
+**Board:** Tasks in `review` status appear in the **IN PROGRESS** section with a `◈` magenta indicator so they're visually distinct from actively-worked tasks.
+
+---
+
+## Data Storage
+
+`aitasks init` creates a `.aitasks/` directory in your project root containing a SQLite database. Add `.aitasks/` to your `.gitignore` if you don't want to commit task data, or commit it to share tasks across your team.
+
+---
+
+## License
+
+MIT

package/dist/index.js

@@ -861,7 +861,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         this._exitCallback = (err) => {
           if (err.code !== "commander.executeSubCommandAsync") {
             throw err;
-          } else {}
+          }
         };
       }
       return this;
@@ -1890,7 +1890,7 @@ var require_commander = __commonJS((exports) => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "aitasks",
-    version: "1.4.2",
+    version: "1.4.3",
     description: "CLI task management tool built for AI agents",
     type: "module",
     bin: {
@@ -9868,7 +9868,7 @@ Learn more about data fetching with Hooks: https://react.dev/link/hooks-data-fet
           offscreenSubtreeIsHidden = prevOffscreenSubtreeIsHidden;
           wasHidden && !hoistableRoot && !prevOffscreenSubtreeIsHidden && !prevOffscreenSubtreeWasHidden && (finishedWork.mode & 2) !== NoMode && 0 <= componentEffectStartTime && 0 <= componentEffectEndTime && 0.05 < componentEffectEndTime - componentEffectStartTime && logComponentReappeared(finishedWork, componentEffectStartTime, componentEffectEndTime);
           commitReconciliationEffects(finishedWork);
-          if (flags & 8192 && (root = finishedWork.stateNode, root._visibility = hoistableRoot ? root._visibility & ~OffscreenVisible : root._visibility | OffscreenVisible, !hoistableRoot || current2 === null || wasHidden || offscreenSubtreeIsHidden || offscreenSubtreeWasHidden || (recursivelyTraverseDisappearLayoutEffects(finishedWork), (finishedWork.mode & 2) !== NoMode && 0 <= componentEffectStartTime && 0 <= componentEffectEndTime && 0.05 < componentEffectEndTime - componentEffectStartTime && logComponentTrigger(finishedWork, componentEffectStartTime, componentEffectEndTime, "Disconnect")), supportsMutation))
+          if (flags & 8192 && (root = finishedWork.stateNode, root._visibility = hoistableRoot ? root._visibility & ~OffscreenVisible : root._visibility | OffscreenVisible, !hoistableRoot || current2 === null || wasHidden || offscreenSubtreeIsHidden || offscreenSubtreeWasHidden || (recursivelyTraverseDisappearLayoutEffects(finishedWork), (finishedWork.mode & 2) !== NoMode && 0 <= componentEffectStartTime && 0 <= componentEffectEndTime && 0.05 < componentEffectEndTime - componentEffectStartTime && logComponentTrigger(finishedWork, componentEffectStartTime, componentEffectEndTime, "Disconnect")), supportsMutation)) {
             a:
               if (current2 = null, supportsMutation)
                 for (root = finishedWork;; ) {
@@ -9918,6 +9918,7 @@ Learn more about data fetching with Hooks: https://react.dev/link/hooks-data-fet
                   root.sibling.return = root.return;
                   root = root.sibling;
                 }
+          }
           flags & 4 && (flags = finishedWork.updateQueue, flags !== null && (current2 = flags.retryQueue, current2 !== null && (flags.retryQueue = null, attachSuspenseRetryListeners(finishedWork, current2))));
           break;
         case 19:
@@ -14590,7 +14591,7 @@ var require_backend = __commonJS((exports, module) => {
         987: (module2, __unused_webpack_exports, __webpack_require__2) => {
           if (true) {
             module2.exports = __webpack_require__2(786);
-          } else {}
+          }
         },
         126: (__unused_webpack_module, exports2, __webpack_require__2) => {
           var process6 = __webpack_require__2(169);
@@ -15050,7 +15051,7 @@ var require_backend = __commonJS((exports, module) => {
         189: (module2, __unused_webpack_exports, __webpack_require__2) => {
           if (true) {
             module2.exports = __webpack_require__2(126);
-          } else {}
+          }
         },
         206: function(module2, exports2, __webpack_require__2) {
           var __WEBPACK_AMD_DEFINE_FACTORY__, __WEBPACK_AMD_DEFINE_ARRAY__, __WEBPACK_AMD_DEFINE_RESULT__;
@@ -15070,7 +15071,7 @@ var require_backend = __commonJS((exports, module) => {
           (function(root, factory) {
             if (true) {
               __WEBPACK_AMD_DEFINE_ARRAY__ = [__webpack_require__2(430)], __WEBPACK_AMD_DEFINE_FACTORY__ = factory, __WEBPACK_AMD_DEFINE_RESULT__ = typeof __WEBPACK_AMD_DEFINE_FACTORY__ === "function" ? __WEBPACK_AMD_DEFINE_FACTORY__.apply(exports2, __WEBPACK_AMD_DEFINE_ARRAY__) : __WEBPACK_AMD_DEFINE_FACTORY__, __WEBPACK_AMD_DEFINE_RESULT__ !== undefined && (module2.exports = __WEBPACK_AMD_DEFINE_RESULT__);
-            } else {}
+            }
           })(this, function ErrorStackParser(StackFrame) {
             var FIREFOX_SAFARI_STACK_REGEXP = /(^|@)\S+:\d+/;
             var CHROME_IE_STACK_REGEXP = /^\s*at .*(\S+:\d+|\(native\))/m;
@@ -15746,7 +15747,7 @@ var require_backend = __commonJS((exports, module) => {
           (function(root, factory) {
             if (true) {
               __WEBPACK_AMD_DEFINE_ARRAY__ = [], __WEBPACK_AMD_DEFINE_FACTORY__ = factory, __WEBPACK_AMD_DEFINE_RESULT__ = typeof __WEBPACK_AMD_DEFINE_FACTORY__ === "function" ? __WEBPACK_AMD_DEFINE_FACTORY__.apply(exports2, __WEBPACK_AMD_DEFINE_ARRAY__) : __WEBPACK_AMD_DEFINE_FACTORY__, __WEBPACK_AMD_DEFINE_RESULT__ !== undefined && (module2.exports = __WEBPACK_AMD_DEFINE_RESULT__);
-            } else {}
+            }
           })(this, function() {
             function _isNumber(n) {
               return !isNaN(parseFloat(n)) && isFinite(n);
@@ -20528,7 +20529,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
           var suffix = "";
           if (true) {
             suffix = " (<anonymous>)";
-          } else {}
+          }
           return `
 ` + prefix + name + suffix;
         }
@@ -22857,7 +22858,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
                     hasChanges = true;
                     updateMostRecentlyInspectedElementIfNecessary(devtoolsInstance.id);
                   }
-                } else {}
+                }
               }
             } catch (err) {
               _iterator2.e(err);
@@ -26729,7 +26730,7 @@ The error thrown in the component is:
               rendererInterface = renderer_attach(hook, id, renderer, global2, shouldStartProfilingNow, profilingSettings);
             } else if (renderer.ComponentTree) {
               rendererInterface = legacy_renderer_attach(hook, id, renderer, global2);
-            } else {}
+            }
           }
           return rendererInterface;
         }
@@ -29409,8 +29410,14 @@ aitasks block TASK-001 --on TASK-002,TASK-003
 View dependencies:
 \`\`\`bash
 aitasks deps TASK-001    # Shows what this task is blocked by and what it blocks
+aitasks show TASK-001    # Also lists "Blocked by" / "Blocks" for a single task
 \`\`\`
 
+When a prerequisite is marked \`done\`, its dependents are **auto-unblocked**: any task
+whose last blocker just completed moves to \`ready\` automatically (no manual promotion
+needed). You can then \`aitasks claim\` it directly. To override a status by hand, use
+\`aitasks update <id> --status ready\`.
+
 ---
 
 ### Completing a Task${reviewRequired ? " \u26A0\uFE0F  REVIEW REQUIRED" : ""}
@@ -29528,10 +29535,12 @@ must be spawned and must approve the task in this same session.
 \`\`\`
 aitasks next [--claim] [--agent <id>]       Find best task (optionally auto-claim/start)
 aitasks list [--status <s>] [--json]        List tasks
+aitasks board                               Live kanban board (visual TUI)
 aitasks show <id>                           Full task detail (includes time tracking)
 aitasks search <query>                      Search titles, descriptions, notes
 aitasks deps <id>                           Show dependency tree
 aitasks create --title <t> --desc <d> --ac <c> [--ac <c> ...] --agent <id>   Create a task
+aitasks update <id> [--status|--priority|--title|--desc|--ac|--type]   Update task fields
 aitasks claim <id...> --agent <id>          Claim task(s) - supports patterns like TASK-0*
 aitasks start <id...> --agent <id>          Begin work on task(s)
 aitasks note <id> <text> --agent <id>       Add implementation note
@@ -29546,6 +29555,7 @@ aitasks undo <id>                           Undo last action on task
 aitasks delete <id...>                      Delete task(s) - no claim required
 aitasks log <id>                            Full event history
 aitasks agents                              List active agents
+aitasks heartbeat [<id>] --agent <id>       Keep-alive: refresh agent last-seen
 aitasks export --format json                Export all tasks
 \`\`\`
 
@@ -29631,6 +29641,42 @@ function appendToSpecificFile(filePath, version, reviewRequired = false) {
   return { filePath, action: "appended" };
 }
 
+// src/commands/shared.ts
+function jsonOut(success, data, errorMsg) {
+  console.log(JSON.stringify(success ? { success: true, data } : { success: false, error: errorMsg }, null, 2));
+}
+function agentId(flagValue) {
+  return flagValue ?? process.env["AITASKS_AGENT_ID"] ?? null;
+}
+function requireAgentId(flagValue, command = "this command") {
+  const id = agentId(flagValue);
+  if (!id) {
+    console.error(`  Agent ID required for ${command}.
+` + `  Use --agent <id> or set AITASKS_AGENT_ID environment variable.`);
+    process.exit(1);
+  }
+  return id;
+}
+function isJsonMode(flag) {
+  return flag === true || process.env["AITASKS_JSON"] === "true";
+}
+function exitError(msg, json) {
+  if (json) {
+    console.log(JSON.stringify({ success: false, error: msg }, null, 2));
+  } else {
+    console.error(`  Error: ${msg}`);
+  }
+  process.exit(1);
+}
+function getVersion() {
+  try {
+    const pkg = require_package();
+    return pkg.version;
+  } catch {
+    return "0.0.0";
+  }
+}
+
 // src/commands/init.ts
 var initCommand = new Command("init").description("Initialize AITasks in the current project").option("--skip-agent-file", "Skip injecting agent instructions into CLAUDE.md/AGENTS.md/GEMINI.md").option("--with-review", "Enforce review gate: agents cannot mark tasks done without a passing review").addHelpText("after", `
 Examples:
@@ -29697,14 +29743,6 @@ function printAgentFileResult(result) {
   }
   console.log("");
 }
-function getVersion() {
-  try {
-    const pkg = require_package();
-    return pkg.version;
-  } catch {
-    return "1.0.0";
-  }
-}
 
 // node_modules/@clack/core/dist/index.mjs
 var import_sisteransi = __toESM(require_src(), 1);
@@ -30456,22 +30494,22 @@ function updateTask(id, updates) {
   const row = db.query(`UPDATE tasks SET ${fields.join(", ")} WHERE id = ? RETURNING *`).get(...params);
   return row ? parseTask(row) : null;
 }
-function addImplementationNote(taskId, note, agentId) {
+function addImplementationNote(taskId, note, agentId2) {
   const task = getTask(taskId);
   if (!task)
     return null;
   const entry = {
     timestamp: Date.now(),
-    agent: agentId,
+    agent: agentId2,
     note
   };
   const updated = updateTask(taskId, {
     implementation_notes: [...task.implementation_notes, entry]
   });
-  logEvent({ task_id: taskId, agent_id: agentId, event_type: "note_added", payload: { note } });
+  logEvent({ task_id: taskId, agent_id: agentId2, event_type: "note_added", payload: { note } });
   return updated;
 }
-function checkCriterion(taskId, index, evidence, agentId) {
+function checkCriterion(taskId, index, evidence, agentId2) {
   const task = getTask(taskId);
   if (!task)
     return { task: null, error: "Task not found" };
@@ -30488,20 +30526,20 @@ function checkCriterion(taskId, index, evidence, agentId) {
     passed: true,
     evidence,
     checked_at: Date.now(),
-    agent: agentId
+    agent: agentId2
   };
   const results = task.test_results.filter((r2) => r2.index !== index);
   results.push(result);
   const updated = updateTask(taskId, { test_results: results });
   logEvent({
     task_id: taskId,
-    agent_id: agentId,
+    agent_id: agentId2,
     event_type: "criterion_checked",
     payload: { index, criterion, evidence }
   });
   return { task: updated };
 }
-function claimTask(taskId, agentId) {
+function claimTask(taskId, agentId2) {
   const s = stmts2();
   const task = getTask(taskId);
   if (!task)
@@ -30518,34 +30556,34 @@ function claimTask(taskId, agentId) {
     };
   }
   const now = Date.now();
-  s.upsertAgent.run(agentId, now, now, taskId);
-  const updated = updateTask(taskId, { assigned_to: agentId, status: "ready" });
-  logEvent({ task_id: taskId, agent_id: agentId, event_type: "claimed", payload: {} });
+  s.upsertAgent.run(agentId2, now, now, taskId);
+  const updated = updateTask(taskId, { assigned_to: agentId2, status: "ready" });
+  logEvent({ task_id: taskId, agent_id: agentId2, event_type: "claimed", payload: {} });
   return { task: updated };
 }
-function startTask(taskId, agentId) {
+function startTask(taskId, agentId2) {
   const s = stmts2();
   const task = getTask(taskId);
   if (!task)
     return { task: null, error: "Task not found" };
   if (task.status === "in_progress")
     return { task: null, error: "Task is already in progress" };
-  if (task.assigned_to && task.assigned_to !== agentId) {
-    return { task: null, error: `Task is assigned to ${task.assigned_to}, not ${agentId}` };
+  if (task.assigned_to && task.assigned_to !== agentId2) {
+    return { task: null, error: `Task is assigned to ${task.assigned_to}, not ${agentId2}` };
   }
   if (!task.assigned_to) {
     const now = Date.now();
-    s.upsertAgent.run(agentId, now, now, taskId);
+    s.upsertAgent.run(agentId2, now, now, taskId);
   }
   const updated = updateTask(taskId, {
-    assigned_to: agentId,
+    assigned_to: agentId2,
     status: "in_progress",
     started_at: Date.now()
   });
-  logEvent({ task_id: taskId, agent_id: agentId, event_type: "started", payload: {} });
+  logEvent({ task_id: taskId, agent_id: agentId2, event_type: "started", payload: {} });
   return { task: updated };
 }
-function completeTask(taskId, agentId) {
+function completeTask(taskId, agentId2) {
   const s = stmts2();
   const task = getTask(taskId);
   if (!task)
@@ -30571,18 +30609,18 @@ function completeTask(taskId, agentId) {
 ` + "  Tasks cannot be moved to Done without a passing review."
       };
     }
-    if (task.assigned_to && task.assigned_to === agentId) {
+    if (task.assigned_to && task.assigned_to === agentId2) {
       return {
         task: null,
-        error: `Self-approval blocked: ${agentId} is the implementing agent and cannot approve their own review.
+        error: `Self-approval blocked: ${agentId2} is the implementing agent and cannot approve their own review.
 ` + `  A separate review sub-agent must run: aitasks done ${taskId} --agent <review-agent-id>`
       };
     }
     const reviewEvent = getLastReviewEvent(taskId);
-    if (reviewEvent?.agent_id && reviewEvent.agent_id === agentId) {
+    if (reviewEvent?.agent_id && reviewEvent.agent_id === agentId2) {
       return {
         task: null,
-        error: `Self-approval blocked: ${agentId} submitted this task for review and cannot also approve it.
+        error: `Self-approval blocked: ${agentId2} submitted this task for review and cannot also approve it.
 ` + `  A separate review sub-agent must run: aitasks done ${taskId} --agent <review-agent-id>`
       };
     }
@@ -30590,7 +30628,7 @@ function completeTask(taskId, agentId) {
   const db = s.db;
   const doComplete = db.transaction(() => {
     const updated2 = updateTask(taskId, { status: "done", completed_at: Date.now() });
-    logEvent({ task_id: taskId, agent_id: agentId, event_type: "completed", payload: {} });
+    logEvent({ task_id: taskId, agent_id: agentId2, event_type: "completed", payload: {} });
     const pendingRows = db.query(`SELECT id, blocked_by FROM tasks
          WHERE status != 'done' AND blocked_by LIKE '%' || ? || '%'`).all(taskId);
     for (const row of pendingRows) {
@@ -30608,14 +30646,14 @@ function completeTask(taskId, agentId) {
         });
       }
     }
-    if (agentId)
-      s.releaseAgent.run(agentId);
+    if (agentId2)
+      s.releaseAgent.run(agentId2);
     return updated2;
   });
   const updated = doComplete();
   return { task: updated };
 }
-function blockTask(taskId, blockerIds, agentId) {
+function blockTask(taskId, blockerIds, agentId2) {
   const s = stmts2();
   const db = s.db;
   const task = getTask(taskId);
@@ -30647,7 +30685,7 @@ function blockTask(taskId, blockerIds, agentId) {
     const updated = updateTask(taskId, { blocked_by: newBlockedBy, status: "blocked" });
     logEvent({
       task_id: taskId,
-      agent_id: agentId,
+      agent_id: agentId2,
       event_type: "blocked",
       payload: { blocked_by: blockerIds }
     });
@@ -30666,7 +30704,7 @@ function detectCycleFromMap(taskId, candidateBlocker, taskMap, visited = new Set
     return false;
   return blocker.blocked_by.some((id) => detectCycleFromMap(taskId, id, taskMap, visited));
 }
-function unblockTask(taskId, fromId, agentId) {
+function unblockTask(taskId, fromId, agentId2) {
   const db = stmts2().db;
   const task = getTask(taskId);
   if (!task)
@@ -30682,10 +30720,10 @@ function unblockTask(taskId, fromId, agentId) {
   }
   const newStatus = remaining.length === 0 ? "ready" : "blocked";
   const updated = updateTask(taskId, { blocked_by: remaining, status: newStatus });
-  logEvent({ task_id: taskId, agent_id: agentId, event_type: "unblocked", payload: { from: fromId } });
+  logEvent({ task_id: taskId, agent_id: agentId2, event_type: "unblocked", payload: { from: fromId } });
   return { task: updated };
 }
-function reviewTask(taskId, agentId) {
+function reviewTask(taskId, agentId2) {
   const task = getTask(taskId);
   if (!task)
     return { task: null, error: "Task not found" };
@@ -30693,17 +30731,17 @@ function reviewTask(taskId, agentId) {
     return { task: null, error: "Task must be in_progress to request review" };
   }
   const updated = updateTask(taskId, { status: "review" });
-  logEvent({ task_id: taskId, agent_id: agentId, event_type: "review_requested", payload: {} });
+  logEvent({ task_id: taskId, agent_id: agentId2, event_type: "review_requested", payload: {} });
   return { task: updated };
 }
-function rejectTask(taskId, reason, agentId) {
+function rejectTask(taskId, reason, agentId2) {
   const task = getTask(taskId);
   if (!task)
     return { task: null, error: "Task not found" };
   if (task.status !== "review") {
     return { task: null, error: "Task must be in review status to reject" };
   }
-  const agent = agentId ?? "human";
+  const agent = agentId2 ?? "human";
   const entry = {
     timestamp: Date.now(),
     agent,
@@ -30713,30 +30751,30 @@ function rejectTask(taskId, reason, agentId) {
     status: "in_progress",
     implementation_notes: [...task.implementation_notes, entry]
   });
-  logEvent({ task_id: taskId, agent_id: agentId, event_type: "note_added", payload: { note: entry.note } });
+  logEvent({ task_id: taskId, agent_id: agentId2, event_type: "note_added", payload: { note: entry.note } });
   logEvent({
     task_id: taskId,
-    agent_id: agentId,
+    agent_id: agentId2,
     event_type: "rejected",
     payload: { reason }
   });
   return { task: updated };
 }
-function unclaimTask(taskId, agentId, reason) {
+function unclaimTask(taskId, agentId2, reason) {
   const s = stmts2();
   const task = getTask(taskId);
   if (!task)
     return { task: null, error: "Task not found" };
-  if (task.assigned_to !== agentId) {
-    return { task: null, error: `Task is not assigned to ${agentId}` };
+  if (task.assigned_to !== agentId2) {
+    return { task: null, error: `Task is not assigned to ${agentId2}` };
   }
   const backStatus = task.blocked_by.length > 0 ? "blocked" : "ready";
   let updated;
   if (reason) {
     const entry = {
       timestamp: Date.now(),
-      agent: agentId,
-      note: `UNCLAIMED by ${agentId}: ${reason}`
+      agent: agentId2,
+      note: `UNCLAIMED by ${agentId2}: ${reason}`
     };
     updated = updateTask(taskId, {
       assigned_to: null,
@@ -30744,32 +30782,32 @@ function unclaimTask(taskId, agentId, reason) {
       started_at: null,
       implementation_notes: [...task.implementation_notes, entry]
     });
-    logEvent({ task_id: taskId, agent_id: agentId, event_type: "note_added", payload: { note: entry.note } });
+    logEvent({ task_id: taskId, agent_id: agentId2, event_type: "note_added", payload: { note: entry.note } });
   } else {
     updated = updateTask(taskId, { assigned_to: null, status: backStatus, started_at: null });
   }
-  s.releaseAgent.run(agentId);
+  s.releaseAgent.run(agentId2);
   logEvent({
     task_id: taskId,
-    agent_id: agentId,
+    agent_id: agentId2,
     event_type: "unclaimed",
     payload: { reason: reason ?? "" }
   });
   return { task: updated };
 }
-function heartbeat(agentId, taskId) {
+function heartbeat(agentId2, taskId) {
   const now = Date.now();
-  stmts2().heartbeat.run(agentId, now, now, taskId ?? null);
+  stmts2().heartbeat.run(agentId2, now, now, taskId ?? null);
 }
 function listAgents() {
   const db = stmts2().db;
   return db.query("SELECT * FROM agents ORDER BY last_seen DESC").all();
 }
-function getNextTask(agentId) {
+function getNextTask(agentId2) {
   const db = stmts2().db;
-  if (agentId) {
+  if (agentId2) {
     const mine = db.query(`SELECT * FROM tasks WHERE status = 'ready' AND assigned_to = ?
-       ORDER BY ${PRIORITY_ORDER}, created_at ASC LIMIT 1`).get(agentId);
+       ORDER BY ${PRIORITY_ORDER}, created_at ASC LIMIT 1`).get(agentId2);
     if (mine)
       return parseTask(mine);
   }
@@ -30796,7 +30834,7 @@ function getStats() {
   }
   return { by_status, by_priority, by_type, total };
 }
-function deleteTask(taskId, agentId) {
+function deleteTask(taskId, agentId2) {
   const s = stmts2();
   const db = s.db;
   const task = getTask(taskId);
@@ -30813,7 +30851,7 @@ function deleteTask(taskId, agentId) {
   const doDelete = db.transaction(() => {
     logEvent({
       task_id: taskId,
-      agent_id: agentId,
+      agent_id: agentId2,
       event_type: "deleted",
       payload: {}
     });
@@ -30837,34 +30875,6 @@ function deleteTask(taskId, agentId) {
   return { success: true };
 }
 
-// src/commands/shared.ts
-function jsonOut(success, data, errorMsg) {
-  console.log(JSON.stringify(success ? { success: true, data } : { success: false, error: errorMsg }, null, 2));
-}
-function agentId(flagValue) {
-  return flagValue ?? process.env["AITASKS_AGENT_ID"] ?? null;
-}
-function requireAgentId(flagValue, command = "this command") {
-  const id = agentId(flagValue);
-  if (!id) {
-    console.error(`  Agent ID required for ${command}.
-` + `  Use --agent <id> or set AITASKS_AGENT_ID environment variable.`);
-    process.exit(1);
-  }
-  return id;
-}
-function isJsonMode(flag) {
-  return flag === true || process.env["AITASKS_JSON"] === "true";
-}
-function exitError(msg, json) {
-  if (json) {
-    console.log(JSON.stringify({ success: false, error: msg }, null, 2));
-  } else {
-    console.error(`  Error: ${msg}`);
-  }
-  process.exit(1);
-}
-
 // src/commands/create.ts
 var createCommand2 = new Command("create").description("Create a new task").option("-t, --title <title>", "Task title").option("-d, --desc <description>", "Task description").option("-a, --ac <criterion>", "Acceptance criterion (repeatable)", collect, []).option("-p, --priority <priority>", "Priority: critical|high|medium|low", "medium").option("--type <type>", "Type: feature|bug|chore|spike", "feature").option("--parent <taskId>", "Parent task ID for subtasks").option("--agent <agentId>", "Agent ID creating this task (or set AITASKS_AGENT_ID)").option("--json", "Output as JSON").action(async (opts) => {
   requireInitialized();
@@ -42919,7 +42929,7 @@ var exportCommand = new Command("export").description("Export all task data").op
 });
 
 // src/commands/onboard.ts
-var VERSION = "1.0.0";
+var VERSION = getVersion();
 var onboardCommand = new Command("onboard").description("Print or inject agent protocol instructions").option("--append", "Auto-detect and append to CLAUDE.md/AGENTS.md/GEMINI.md").option("--file <path>", "Append to a specific file").option("--json", "Output the instructions as a JSON string").action((opts) => {
   const reviewRequired = isInitialized() ? getReviewRequired() : false;
   const instructions = getAgentInstructions(VERSION, { reviewRequired });
@@ -43514,4 +43524,4 @@ program2.parseAsync(process.argv).catch((err) => {
   process.exit(1);
 });
 
-//# debugId=55B7B23CFF99871064756E2164756E21
+//# debugId=624747270A6DB83264756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aitasks",
-  "version": "1.4.2",
+  "version": "1.4.3",
   "description": "CLI task management tool built for AI agents",
   "type": "module",
   "bin": {