@hasna/todos 0.9.21 → 0.9.23

package/README.md

@@ -163,20 +163,20 @@ Or start manually via stdio:
 todos-mcp
 ```
 
-### MCP Tools (29)
-
-| Category | Tools |
-|----------|-------|
-| **Tasks** | `create_task`, `list_tasks`, `get_task`, `update_task`, `delete_task`, `start_task`, `complete_task` |
-| **Locking** | `lock_task`, `unlock_task` |
-| **Dependencies** | `add_dependency`, `remove_dependency` |
-| **Comments** | `add_comment` |
-| **Projects** | `create_project`, `list_projects` |
-| **Plans** | `create_plan`, `list_plans`, `get_plan`, `update_plan`, `delete_plan` |
-| **Agents** | `register_agent`, `list_agents`, `get_agent` |
-| **Task Lists** | `create_task_list`, `list_task_lists`, `get_task_list`, `update_task_list`, `delete_task_list` |
-| **Search** | `search_tasks` |
-| **Sync** | `sync` |
+### MCP Tools (40)
+
+**Tasks:** `create_task`, `list_tasks`, `get_task`, `update_task`, `delete_task`, `start_task`, `complete_task`, `lock_task`, `unlock_task`, `approve_task`
+**Dependencies:** `add_dependency`, `remove_dependency`
+**Comments:** `add_comment`
+**Projects:** `create_project`, `list_projects`
+**Plans:** `create_plan`, `list_plans`, `get_plan`, `update_plan`, `delete_plan`
+**Agents:** `register_agent`, `list_agents`, `get_agent`
+**Task Lists:** `create_task_list`, `list_task_lists`, `get_task_list`, `update_task_list`, `delete_task_list`
+**Search:** `search_tasks`
+**Sync:** `sync`
+**Audit:** `get_task_history`, `get_recent_activity`
+**Webhooks:** `create_webhook`, `list_webhooks`, `delete_webhook`
+**Templates:** `create_template`, `list_templates`, `create_task_from_template`, `delete_template`
 
 ### MCP Resources
 
@@ -208,28 +208,66 @@ The dashboard auto-refreshes every 30 seconds, supports dark mode, and includes
 
 ## REST API
 
-When running `todos serve`, the following REST API is available:
+Start the server with `todos serve` or `todos-serve`. Default port: 19427.
+
+### Tasks
 
 | Method | Endpoint | Description |
 |--------|----------|-------------|
-| GET | `/api/stats` | Dashboard statistics |
-| GET | `/api/tasks` | List tasks (supports `?status=`, `?project_id=`, `?limit=`) |
-| POST | `/api/tasks` | Create a task |
+| GET | `/api/tasks` | List tasks. Query: `?status=`, `?project_id=`, `?limit=` |
+| POST | `/api/tasks` | Create task. Body: `{ title, description?, priority?, project_id?, estimated_minutes?, requires_approval? }` |
 | GET | `/api/tasks/:id` | Get task details |
-| PATCH | `/api/tasks/:id` | Update a task |
-| DELETE | `/api/tasks/:id` | Delete a task |
-| POST | `/api/tasks/:id/start` | Start a task |
-| POST | `/api/tasks/:id/complete` | Complete a task |
-| POST | `/api/tasks/bulk` | Bulk operations (start, complete, delete) |
-| GET | `/api/tasks/export?format=csv` | Export tasks as CSV |
-| GET | `/api/tasks/export?format=json` | Export tasks as JSON |
-| GET | `/api/projects` | List projects |
-| POST | `/api/projects` | Create a project |
-| DELETE | `/api/projects/:id` | Delete a project |
-| GET | `/api/agents` | List agents |
-| POST | `/api/agents` | Register an agent |
-| PATCH | `/api/agents/:id` | Update an agent |
-| DELETE | `/api/agents/:id` | Delete an agent |
+| PATCH | `/api/tasks/:id` | Update task. Body: `{ title?, status?, priority?, description?, assigned_to?, tags?, due_at?, estimated_minutes?, requires_approval?, approved_by? }` |
+| DELETE | `/api/tasks/:id` | Delete task |
+| POST | `/api/tasks/:id/start` | Start task (sets in_progress, locks) |
+| POST | `/api/tasks/:id/complete` | Complete task |
+| GET | `/api/tasks/:id/history` | Get task audit log |
+| POST | `/api/tasks/bulk` | Bulk ops. Body: `{ ids: [...], action: "start" | "complete" | "delete" }` |
+| GET | `/api/tasks/export?format=csv` | Export as CSV |
+| GET | `/api/tasks/export?format=json` | Export as JSON |
+
+### Projects
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/projects` | List all projects |
+| POST | `/api/projects` | Create project. Body: `{ name, path, description? }` |
+| DELETE | `/api/projects/:id` | Delete project |
+| POST | `/api/projects/bulk` | Bulk delete. Body: `{ ids: [...], action: "delete" }` |
+
+### Plans
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/plans` | List plans. Query: `?project_id=` |
+| POST | `/api/plans` | Create plan. Body: `{ name, description?, project_id?, task_list_id?, agent_id?, status? }` |
+| GET | `/api/plans/:id` | Get plan with its tasks |
+| PATCH | `/api/plans/:id` | Update plan |
+| DELETE | `/api/plans/:id` | Delete plan |
+| POST | `/api/plans/bulk` | Bulk delete |
+
+### Agents
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/agents` | List all agents |
+| POST | `/api/agents` | Register agent. Body: `{ name, description?, role? }` |
+| PATCH | `/api/agents/:id` | Update agent. Body: `{ name?, description?, role? }` |
+| DELETE | `/api/agents/:id` | Delete agent |
+| POST | `/api/agents/bulk` | Bulk delete |
+
+### Webhooks, Templates, Activity
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/webhooks` | List webhooks |
+| POST | `/api/webhooks` | Create webhook. Body: `{ url, events?, secret? }` |
+| DELETE | `/api/webhooks/:id` | Delete webhook |
+| GET | `/api/templates` | List task templates |
+| POST | `/api/templates` | Create template. Body: `{ name, title_pattern, description?, priority?, tags? }` |
+| DELETE | `/api/templates/:id` | Delete template |
+| GET | `/api/activity` | Recent audit log. Query: `?limit=50` |
+| GET | `/api/stats` | Dashboard statistics |
 
 ## Sync
 
@@ -274,50 +312,48 @@ Claude uses native Claude Code task lists. Other agents use JSON files under `~/
 }
 ```
 
-## CLI Commands
-
-### Task Operations
-
-| Command | Description |
-|---------|-------------|
-| `todos add <title>` | Create a task (`-p` priority, `--tags`, `--list`, `--plan`, `--assign`, `--parent`) |
-| `todos list` | List tasks (`-s` status, `-p` priority, `--list`, `--tags`, `-a` all) |
-| `todos show <id>` | Show full task details with relations |
-| `todos update <id>` | Update fields (`--title`, `-s`, `-p`, `--tags`, `--list`, `--assign`) |
-| `todos start <id>` | Claim task, lock it, set to in_progress |
-| `todos done <id>` | Mark task completed, release lock |
-| `todos delete <id>` | Delete permanently |
-| `todos lock <id>` | Acquire exclusive lock |
-| `todos unlock <id>` | Release lock |
-
-### Organization
-
-| Command | Description |
-|---------|-------------|
-| `todos lists` | List task lists (`--add`, `--delete`, `--slug`, `-d`) |
-| `todos plans` | List plans (`--add`, `--show`, `--delete`, `--complete`) |
-| `todos projects` | List projects (`--add`, `--name`, `--task-list-id`) |
-| `todos deps <id>` | Manage dependencies (`--needs`, `--remove`) |
-| `todos comment <id> <text>` | Add a comment to a task |
-| `todos search <query>` | Full-text search across tasks |
-
-### Agent & System
-
-| Command | Description |
-|---------|-------------|
-| `todos init <name>` | Register agent, get short UUID (`-d` description) |
-| `todos agents` | List registered agents |
-| `todos sync` | Sync with agent task lists |
-| `todos mcp` | MCP server (`--register`, `--unregister`) |
-| `todos hooks install` | Install Claude Code auto-sync hooks |
-| `todos export` | Export tasks (`-f json\|md`) |
-| `todos upgrade` | Self-update to latest version |
-
-### Global Options
-
-All commands support: `--project <path>`, `--json`, `--agent <name>`, `--session <id>`.
-
-Partial IDs work everywhere — use the first 8+ characters of any UUID.
+## CLI Reference
+
+```bash
+# Task management
+todos add "title" [-d desc] [-p priority] [--tags t1,t2] [--plan id] [--estimated 30] [--approval]
+todos list [-s status] [-p priority] [--assigned agent] [--project-name name] [--agent-name name] [--sort field] [-a]
+todos show <id>                    # Full task details with relations
+todos update <id> [--title t] [-s status] [-p priority] [--tags t1,t2] [--estimated 30]
+todos done <id>                    # Complete a task
+todos start <id>                   # Claim, lock, and start
+todos delete <id>
+todos approve <id>                 # Approve a task requiring approval
+todos history <id>                 # Show task audit log
+todos search <query>
+todos bulk <done|start|delete> <id1> <id2> ...
+todos comment <id> <text>
+todos deps <id> --add <dep_id>     # Manage dependencies
+
+# Plans
+todos plans [--add name] [--show id] [--delete id] [--complete id]
+
+# Templates
+todos templates [--add name --title pattern] [--delete id] [--use id]
+
+# Projects & Agents
+todos projects [--add name --path /path]
+todos agents
+todos init <name>                  # Register an agent
+todos lists                        # Manage task lists
+
+# Utilities
+todos count [--json]               # Quick stats
+todos watch [-s status] [-i 5]     # Live-updating task list
+todos config [--get key] [--set key=value]
+todos export [--format csv|json]
+todos sync [--task-list id]        # Sync with Claude Code
+todos serve [--port 19427]         # Start web dashboard
+todos interactive                  # Launch TUI
+todos upgrade                      # Update to latest version
+```
+
+All output supports `--json` for machine-readable format.
 
 ## Library Usage
 

package/dist/cli/index.js

@@ -3205,8 +3205,26 @@ function deleteTask(id, db) {
   const result = d.run("DELETE FROM tasks WHERE id = ?", [id]);
   return result.changes > 0;
 }
+function getBlockingDeps(id, db) {
+  const d = db || getDatabase();
+  const deps = getTaskDependencies(id, d);
+  if (deps.length === 0)
+    return [];
+  const blocking = [];
+  for (const dep of deps) {
+    const task = getTask(dep.depends_on, d);
+    if (task && task.status !== "completed")
+      blocking.push(task);
+  }
+  return blocking;
+}
 function startTask(id, agentId, db) {
   const d = db || getDatabase();
+  const blocking = getBlockingDeps(id, d);
+  if (blocking.length > 0) {
+    const blockerIds = blocking.map((b) => b.id.slice(0, 8)).join(", ");
+    throw new Error(`Task is blocked by ${blocking.length} unfinished dependency(ies): ${blockerIds}`);
+  }
   const cutoff = lockExpiryCutoff();
   const timestamp = now();
   const result = d.run(`UPDATE tasks SET status = 'in_progress', assigned_to = ?, locked_by = ?, locked_at = ?, version = version + 1, updated_at = ?
@@ -3222,7 +3240,7 @@ function startTask(id, agentId, db) {
   logTaskChange(id, "start", "status", "pending", "in_progress", agentId, d);
   return getTask(id, d);
 }
-function completeTask(id, agentId, db) {
+function completeTask(id, agentId, db, evidence) {
   const d = db || getDatabase();
   const task = getTask(id, d);
   if (!task)
@@ -3231,6 +3249,10 @@ function completeTask(id, agentId, db) {
     throw new LockError(id, task.locked_by);
   }
   checkCompletionGuard(task, agentId || null, d);
+  if (evidence) {
+    const meta = { ...task.metadata, _evidence: evidence };
+    d.run("UPDATE tasks SET metadata = ? WHERE id = ?", [JSON.stringify(meta), id]);
+  }
   const timestamp = now();
   d.run(`UPDATE tasks SET status = 'completed', locked_by = NULL, locked_at = NULL, completed_at = ?, version = version + 1, updated_at = ?
      WHERE id = ?`, [timestamp, timestamp, id]);
@@ -3293,6 +3315,10 @@ function removeDependency(taskId, dependsOn, db) {
   const result = d.run("DELETE FROM task_dependencies WHERE task_id = ? AND depends_on = ?", [taskId, dependsOn]);
   return result.changes > 0;
 }
+function getTaskDependencies(taskId, db) {
+  const d = db || getDatabase();
+  return d.query("SELECT * FROM task_dependencies WHERE task_id = ?").all(taskId);
+}
 function wouldCreateCycle(taskId, dependsOn, db) {
   const visited = new Set;
   const queue = [dependsOn];
@@ -9132,6 +9158,39 @@ ${task.id.slice(0, 8)} | ${task.priority} | ${task.title}` }] };
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
   });
+  server.tool("get_my_tasks", "Get your assigned tasks and stats. Auto-registers if needed.", {
+    agent_name: exports_external.string().describe("Your agent name")
+  }, async ({ agent_name }) => {
+    try {
+      const agent = registerAgent({ name: agent_name });
+      const tasks = listTasks({});
+      const myTasks = tasks.filter((t) => t.assigned_to === agent_name || t.assigned_to === agent.id || t.agent_id === agent.id || t.agent_id === agent_name);
+      const pending = myTasks.filter((t) => t.status === "pending");
+      const inProgress = myTasks.filter((t) => t.status === "in_progress");
+      const completed = myTasks.filter((t) => t.status === "completed");
+      const rate = myTasks.length > 0 ? Math.round(completed.length / myTasks.length * 100) : 0;
+      const lines = [
+        `Agent: ${agent.name} (${agent.id})`,
+        `Tasks: ${myTasks.length} total, ${pending.length} pending, ${inProgress.length} active, ${completed.length} done (${rate}%)`
+      ];
+      if (pending.length > 0) {
+        lines.push(`
+Pending:`);
+        for (const t of pending.slice(0, 10))
+          lines.push(`  [${t.priority}] ${t.id.slice(0, 8)} | ${t.title}`);
+      }
+      if (inProgress.length > 0) {
+        lines.push(`
+In Progress:`);
+        for (const t of inProgress)
+          lines.push(`  ${t.id.slice(0, 8)} | ${t.title}`);
+      }
+      return { content: [{ type: "text", text: lines.join(`
+`) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
   server.resource("tasks", "todos://tasks", { description: "All active tasks", mimeType: "application/json" }, async () => {
     const tasks = listTasks({ status: ["pending", "in_progress"] });
     return { contents: [{ uri: "todos://tasks", text: JSON.stringify(tasks, null, 2), mimeType: "application/json" }] };
@@ -9225,6 +9284,19 @@ function taskToSummary(task) {
 async function startServer(port, options) {
   const shouldOpen = options?.open ?? true;
   getDatabase();
+  const sseClients = new Set;
+  function broadcastEvent(event) {
+    const data = JSON.stringify({ ...event, timestamp: new Date().toISOString() });
+    for (const controller of sseClients) {
+      try {
+        controller.enqueue(`data: ${data}
+
+`);
+      } catch {
+        sseClients.delete(controller);
+      }
+    }
+  }
   const dashboardDir = resolveDashboardDir();
   const dashboardExists = existsSync6(dashboardDir);
   if (!dashboardExists) {
@@ -9250,6 +9322,27 @@ Dashboard not found at: ${dashboardDir}`);
           }
         });
       }
+      if (path === "/api/events" && method === "GET") {
+        const stream = new ReadableStream({
+          start(controller) {
+            sseClients.add(controller);
+            controller.enqueue(`data: ${JSON.stringify({ type: "connected", timestamp: new Date().toISOString() })}
+
+`);
+          },
+          cancel(controller) {
+            sseClients.delete(controller);
+          }
+        });
+        return new Response(stream, {
+          headers: {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache",
+            Connection: "keep-alive",
+            "Access-Control-Allow-Origin": `http://localhost:${port}`
+          }
+        });
+      }
       if (path === "/api/stats" && method === "GET") {
         const all = listTasks({ limit: 1e4 });
         const projects = listProjects();
@@ -9287,6 +9380,7 @@ Dashboard not found at: ${dashboardDir}`);
             priority: body.priority,
             project_id: body.project_id
           });
+          broadcastEvent({ type: "task", task_id: task.id, action: "created", agent_id: task.agent_id });
           return json(taskToSummary(task), 201, port);
         } catch (e) {
           return json({ error: e instanceof Error ? e.message : "Failed to create task" }, 500, port);
@@ -9389,6 +9483,7 @@ Dashboard not found at: ${dashboardDir}`);
         const id = startMatch[1];
         try {
           const task = startTask(id, "dashboard");
+          broadcastEvent({ type: "task", task_id: task.id, action: "started", agent_id: "dashboard" });
           return json(taskToSummary(task), 200, port);
         } catch (e) {
           return json({ error: e instanceof Error ? e.message : "Failed to start task" }, 500, port);
@@ -9399,6 +9494,7 @@ Dashboard not found at: ${dashboardDir}`);
         const id = completeMatch[1];
         try {
           const task = completeTask(id, "dashboard");
+          broadcastEvent({ type: "task", task_id: task.id, action: "completed", agent_id: "dashboard" });
           return json(taskToSummary(task), 200, port);
         } catch (e) {
           return json({ error: e instanceof Error ? e.message : "Failed to complete task" }, 500, port);
@@ -9407,6 +9503,67 @@ Dashboard not found at: ${dashboardDir}`);
       if (path === "/api/projects" && method === "GET") {
         return json(listProjects(), 200, port);
       }
+      if (path === "/api/agents/me" && method === "GET") {
+        const name = url.searchParams.get("name");
+        if (!name)
+          return json({ error: "Missing name param" }, 400, port);
+        const { registerAgent: registerAgent2 } = await Promise.resolve().then(() => (init_agents(), exports_agents));
+        const agent = registerAgent2({ name });
+        const tasks = listTasks({ assigned_to: name });
+        const agentIdTasks = listTasks({ agent_id: agent.id });
+        const allTasks = [...tasks, ...agentIdTasks.filter((t) => !tasks.some((tt) => tt.id === t.id))];
+        const pending = allTasks.filter((t) => t.status === "pending");
+        const inProgress = allTasks.filter((t) => t.status === "in_progress");
+        const completed = allTasks.filter((t) => t.status === "completed");
+        return json({
+          agent,
+          pending_tasks: pending.map(taskToSummary),
+          in_progress_tasks: inProgress.map(taskToSummary),
+          stats: {
+            total: allTasks.length,
+            pending: pending.length,
+            in_progress: inProgress.length,
+            completed: completed.length,
+            completion_rate: allTasks.length > 0 ? Math.round(completed.length / allTasks.length * 100) : 0
+          }
+        }, 200, port);
+      }
+      const queueMatch = path.match(/^\/api\/agents\/([^/]+)\/queue$/);
+      if (queueMatch && method === "GET") {
+        const agentId = decodeURIComponent(queueMatch[1]);
+        const pending = listTasks({ status: "pending" });
+        const queue = pending.filter((t) => t.assigned_to === agentId || t.agent_id === agentId || !t.assigned_to && !t.locked_by);
+        const order = { critical: 0, high: 1, medium: 2, low: 3 };
+        queue.sort((a, b) => (order[a.priority] ?? 4) - (order[b.priority] ?? 4) || new Date(a.created_at).getTime() - new Date(b.created_at).getTime());
+        return json(queue.map(taskToSummary), 200, port);
+      }
+      if (path === "/api/tasks/claim" && method === "POST") {
+        try {
+          const body = await req.json();
+          const agentId = body.agent_id || "anonymous";
+          const pending = listTasks({ status: "pending", project_id: body.project_id });
+          const available = pending.filter((t) => !t.locked_by);
+          if (available.length === 0)
+            return json({ task: null }, 200, port);
+          const order = { critical: 0, high: 1, medium: 2, low: 3 };
+          available.sort((a, b) => (order[a.priority] ?? 4) - (order[b.priority] ?? 4));
+          const target = available[0];
+          try {
+            const claimed = startTask(target.id, agentId);
+            return json({ task: taskToSummary(claimed) }, 200, port);
+          } catch (e) {
+            const next = available[1] || null;
+            return json({
+              task: null,
+              locked_by: target.locked_by,
+              locked_since: target.locked_at,
+              suggested_task: next ? taskToSummary(next) : null
+            }, 200, port);
+          }
+        } catch (e) {
+          return json({ error: e instanceof Error ? e.message : "Failed to claim" }, 500, port);
+        }
+      }
       if (path === "/api/agents" && method === "GET") {
         return json(listAgents(), 200, port);
       }

package/dist/index.js

@@ -1122,8 +1122,26 @@ function deleteTask(id, db) {
   const result = d.run("DELETE FROM tasks WHERE id = ?", [id]);
   return result.changes > 0;
 }
+function getBlockingDeps(id, db) {
+  const d = db || getDatabase();
+  const deps = getTaskDependencies(id, d);
+  if (deps.length === 0)
+    return [];
+  const blocking = [];
+  for (const dep of deps) {
+    const task = getTask(dep.depends_on, d);
+    if (task && task.status !== "completed")
+      blocking.push(task);
+  }
+  return blocking;
+}
 function startTask(id, agentId, db) {
   const d = db || getDatabase();
+  const blocking = getBlockingDeps(id, d);
+  if (blocking.length > 0) {
+    const blockerIds = blocking.map((b) => b.id.slice(0, 8)).join(", ");
+    throw new Error(`Task is blocked by ${blocking.length} unfinished dependency(ies): ${blockerIds}`);
+  }
   const cutoff = lockExpiryCutoff();
   const timestamp = now();
   const result = d.run(`UPDATE tasks SET status = 'in_progress', assigned_to = ?, locked_by = ?, locked_at = ?, version = version + 1, updated_at = ?
@@ -1139,7 +1157,7 @@ function startTask(id, agentId, db) {
   logTaskChange(id, "start", "status", "pending", "in_progress", agentId, d);
   return getTask(id, d);
 }
-function completeTask(id, agentId, db) {
+function completeTask(id, agentId, db, evidence) {
   const d = db || getDatabase();
   const task = getTask(id, d);
   if (!task)
@@ -1148,6 +1166,10 @@ function completeTask(id, agentId, db) {
     throw new LockError(id, task.locked_by);
   }
   checkCompletionGuard(task, agentId || null, d);
+  if (evidence) {
+    const meta = { ...task.metadata, _evidence: evidence };
+    d.run("UPDATE tasks SET metadata = ? WHERE id = ?", [JSON.stringify(meta), id]);
+  }
   const timestamp = now();
   d.run(`UPDATE tasks SET status = 'completed', locked_by = NULL, locked_at = NULL, completed_at = ?, version = version + 1, updated_at = ?
      WHERE id = ?`, [timestamp, timestamp, id]);
@@ -2233,6 +2255,7 @@ export {
   getDatabase,
   getCompletionGuardConfig,
   getComment,
+  getBlockingDeps,
   getAgentByName,
   getAgent,
   ensureTaskList,

package/dist/mcp/index.js

@@ -5161,8 +5161,26 @@ function deleteTask(id, db) {
   const result = d.run("DELETE FROM tasks WHERE id = ?", [id]);
   return result.changes > 0;
 }
+function getBlockingDeps(id, db) {
+  const d = db || getDatabase();
+  const deps = getTaskDependencies(id, d);
+  if (deps.length === 0)
+    return [];
+  const blocking = [];
+  for (const dep of deps) {
+    const task = getTask(dep.depends_on, d);
+    if (task && task.status !== "completed")
+      blocking.push(task);
+  }
+  return blocking;
+}
 function startTask(id, agentId, db) {
   const d = db || getDatabase();
+  const blocking = getBlockingDeps(id, d);
+  if (blocking.length > 0) {
+    const blockerIds = blocking.map((b) => b.id.slice(0, 8)).join(", ");
+    throw new Error(`Task is blocked by ${blocking.length} unfinished dependency(ies): ${blockerIds}`);
+  }
   const cutoff = lockExpiryCutoff();
   const timestamp = now();
   const result = d.run(`UPDATE tasks SET status = 'in_progress', assigned_to = ?, locked_by = ?, locked_at = ?, version = version + 1, updated_at = ?
@@ -5178,7 +5196,7 @@ function startTask(id, agentId, db) {
   logTaskChange(id, "start", "status", "pending", "in_progress", agentId, d);
   return getTask(id, d);
 }
-function completeTask(id, agentId, db) {
+function completeTask(id, agentId, db, evidence) {
   const d = db || getDatabase();
   const task = getTask(id, d);
   if (!task)
@@ -5187,6 +5205,10 @@ function completeTask(id, agentId, db) {
     throw new LockError(id, task.locked_by);
   }
   checkCompletionGuard(task, agentId || null, d);
+  if (evidence) {
+    const meta = { ...task.metadata, _evidence: evidence };
+    d.run("UPDATE tasks SET metadata = ? WHERE id = ?", [JSON.stringify(meta), id]);
+  }
   const timestamp = now();
   d.run(`UPDATE tasks SET status = 'completed', locked_by = NULL, locked_at = NULL, completed_at = ?, version = version + 1, updated_at = ?
      WHERE id = ?`, [timestamp, timestamp, id]);
@@ -5249,6 +5271,10 @@ function removeDependency(taskId, dependsOn, db) {
   const result = d.run("DELETE FROM task_dependencies WHERE task_id = ? AND depends_on = ?", [taskId, dependsOn]);
   return result.changes > 0;
 }
+function getTaskDependencies(taskId, db) {
+  const d = db || getDatabase();
+  return d.query("SELECT * FROM task_dependencies WHERE task_id = ?").all(taskId);
+}
 function wouldCreateCycle(taskId, dependsOn, db) {
   const visited = new Set;
   const queue = [dependsOn];
@@ -6898,6 +6924,39 @@ server.tool("approve_task", "Approve a task that requires approval before comple
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
+server.tool("get_my_tasks", "Get your assigned tasks and stats. Auto-registers if needed.", {
+  agent_name: exports_external.string().describe("Your agent name")
+}, async ({ agent_name }) => {
+  try {
+    const agent = registerAgent({ name: agent_name });
+    const tasks = listTasks({});
+    const myTasks = tasks.filter((t) => t.assigned_to === agent_name || t.assigned_to === agent.id || t.agent_id === agent.id || t.agent_id === agent_name);
+    const pending = myTasks.filter((t) => t.status === "pending");
+    const inProgress = myTasks.filter((t) => t.status === "in_progress");
+    const completed = myTasks.filter((t) => t.status === "completed");
+    const rate = myTasks.length > 0 ? Math.round(completed.length / myTasks.length * 100) : 0;
+    const lines = [
+      `Agent: ${agent.name} (${agent.id})`,
+      `Tasks: ${myTasks.length} total, ${pending.length} pending, ${inProgress.length} active, ${completed.length} done (${rate}%)`
+    ];
+    if (pending.length > 0) {
+      lines.push(`
+Pending:`);
+      for (const t of pending.slice(0, 10))
+        lines.push(`  [${t.priority}] ${t.id.slice(0, 8)} | ${t.title}`);
+    }
+    if (inProgress.length > 0) {
+      lines.push(`
+In Progress:`);
+      for (const t of inProgress)
+        lines.push(`  ${t.id.slice(0, 8)} | ${t.title}`);
+    }
+    return { content: [{ type: "text", text: lines.join(`
+`) }] };
+  } catch (e) {
+    return { content: [{ type: "text", text: formatError(e) }], isError: true };
+  }
+});
 server.resource("tasks", "todos://tasks", { description: "All active tasks", mimeType: "application/json" }, async () => {
   const tasks = listTasks({ status: ["pending", "in_progress"] });
   return { contents: [{ uri: "todos://tasks", text: JSON.stringify(tasks, null, 2), mimeType: "application/json" }] };

package/dist/server/index.js

@@ -1240,8 +1240,26 @@ function deleteTask(id, db) {
   const result = d.run("DELETE FROM tasks WHERE id = ?", [id]);
   return result.changes > 0;
 }
+function getBlockingDeps(id, db) {
+  const d = db || getDatabase();
+  const deps = getTaskDependencies(id, d);
+  if (deps.length === 0)
+    return [];
+  const blocking = [];
+  for (const dep of deps) {
+    const task = getTask(dep.depends_on, d);
+    if (task && task.status !== "completed")
+      blocking.push(task);
+  }
+  return blocking;
+}
 function startTask(id, agentId, db) {
   const d = db || getDatabase();
+  const blocking = getBlockingDeps(id, d);
+  if (blocking.length > 0) {
+    const blockerIds = blocking.map((b) => b.id.slice(0, 8)).join(", ");
+    throw new Error(`Task is blocked by ${blocking.length} unfinished dependency(ies): ${blockerIds}`);
+  }
   const cutoff = lockExpiryCutoff();
   const timestamp = now();
   const result = d.run(`UPDATE tasks SET status = 'in_progress', assigned_to = ?, locked_by = ?, locked_at = ?, version = version + 1, updated_at = ?
@@ -1257,7 +1275,7 @@ function startTask(id, agentId, db) {
   logTaskChange(id, "start", "status", "pending", "in_progress", agentId, d);
   return getTask(id, d);
 }
-function completeTask(id, agentId, db) {
+function completeTask(id, agentId, db, evidence) {
   const d = db || getDatabase();
   const task = getTask(id, d);
   if (!task)
@@ -1266,12 +1284,20 @@ function completeTask(id, agentId, db) {
     throw new LockError(id, task.locked_by);
   }
   checkCompletionGuard(task, agentId || null, d);
+  if (evidence) {
+    const meta = { ...task.metadata, _evidence: evidence };
+    d.run("UPDATE tasks SET metadata = ? WHERE id = ?", [JSON.stringify(meta), id]);
+  }
   const timestamp = now();
   d.run(`UPDATE tasks SET status = 'completed', locked_by = NULL, locked_at = NULL, completed_at = ?, version = version + 1, updated_at = ?
      WHERE id = ?`, [timestamp, timestamp, id]);
   logTaskChange(id, "complete", "status", task.status, "completed", agentId || null, d);
   return getTask(id, d);
 }
+function getTaskDependencies(taskId, db) {
+  const d = db || getDatabase();
+  return d.query("SELECT * FROM task_dependencies WHERE task_id = ?").all(taskId);
+}
 
 // src/server/serve.ts
 init_projects();
@@ -1428,6 +1454,19 @@ function taskToSummary(task) {
 async function startServer(port, options) {
   const shouldOpen = options?.open ?? true;
   getDatabase();
+  const sseClients = new Set;
+  function broadcastEvent(event) {
+    const data = JSON.stringify({ ...event, timestamp: new Date().toISOString() });
+    for (const controller of sseClients) {
+      try {
+        controller.enqueue(`data: ${data}
+
+`);
+      } catch {
+        sseClients.delete(controller);
+      }
+    }
+  }
   const dashboardDir = resolveDashboardDir();
   const dashboardExists = existsSync4(dashboardDir);
   if (!dashboardExists) {
@@ -1453,6 +1492,27 @@ Dashboard not found at: ${dashboardDir}`);
           }
         });
       }
+      if (path === "/api/events" && method === "GET") {
+        const stream = new ReadableStream({
+          start(controller) {
+            sseClients.add(controller);
+            controller.enqueue(`data: ${JSON.stringify({ type: "connected", timestamp: new Date().toISOString() })}
+
+`);
+          },
+          cancel(controller) {
+            sseClients.delete(controller);
+          }
+        });
+        return new Response(stream, {
+          headers: {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache",
+            Connection: "keep-alive",
+            "Access-Control-Allow-Origin": `http://localhost:${port}`
+          }
+        });
+      }
       if (path === "/api/stats" && method === "GET") {
         const all = listTasks({ limit: 1e4 });
         const projects = listProjects();
@@ -1490,6 +1550,7 @@ Dashboard not found at: ${dashboardDir}`);
             priority: body.priority,
             project_id: body.project_id
           });
+          broadcastEvent({ type: "task", task_id: task.id, action: "created", agent_id: task.agent_id });
           return json(taskToSummary(task), 201, port);
         } catch (e) {
           return json({ error: e instanceof Error ? e.message : "Failed to create task" }, 500, port);
@@ -1592,6 +1653,7 @@ Dashboard not found at: ${dashboardDir}`);
         const id = startMatch[1];
         try {
           const task = startTask(id, "dashboard");
+          broadcastEvent({ type: "task", task_id: task.id, action: "started", agent_id: "dashboard" });
           return json(taskToSummary(task), 200, port);
         } catch (e) {
           return json({ error: e instanceof Error ? e.message : "Failed to start task" }, 500, port);
@@ -1602,6 +1664,7 @@ Dashboard not found at: ${dashboardDir}`);
         const id = completeMatch[1];
         try {
           const task = completeTask(id, "dashboard");
+          broadcastEvent({ type: "task", task_id: task.id, action: "completed", agent_id: "dashboard" });
           return json(taskToSummary(task), 200, port);
         } catch (e) {
           return json({ error: e instanceof Error ? e.message : "Failed to complete task" }, 500, port);
@@ -1610,6 +1673,67 @@ Dashboard not found at: ${dashboardDir}`);
       if (path === "/api/projects" && method === "GET") {
         return json(listProjects(), 200, port);
       }
+      if (path === "/api/agents/me" && method === "GET") {
+        const name = url.searchParams.get("name");
+        if (!name)
+          return json({ error: "Missing name param" }, 400, port);
+        const { registerAgent: registerAgent2 } = await Promise.resolve().then(() => (init_agents(), exports_agents));
+        const agent = registerAgent2({ name });
+        const tasks = listTasks({ assigned_to: name });
+        const agentIdTasks = listTasks({ agent_id: agent.id });
+        const allTasks = [...tasks, ...agentIdTasks.filter((t) => !tasks.some((tt) => tt.id === t.id))];
+        const pending = allTasks.filter((t) => t.status === "pending");
+        const inProgress = allTasks.filter((t) => t.status === "in_progress");
+        const completed = allTasks.filter((t) => t.status === "completed");
+        return json({
+          agent,
+          pending_tasks: pending.map(taskToSummary),
+          in_progress_tasks: inProgress.map(taskToSummary),
+          stats: {
+            total: allTasks.length,
+            pending: pending.length,
+            in_progress: inProgress.length,
+            completed: completed.length,
+            completion_rate: allTasks.length > 0 ? Math.round(completed.length / allTasks.length * 100) : 0
+          }
+        }, 200, port);
+      }
+      const queueMatch = path.match(/^\/api\/agents\/([^/]+)\/queue$/);
+      if (queueMatch && method === "GET") {
+        const agentId = decodeURIComponent(queueMatch[1]);
+        const pending = listTasks({ status: "pending" });
+        const queue = pending.filter((t) => t.assigned_to === agentId || t.agent_id === agentId || !t.assigned_to && !t.locked_by);
+        const order = { critical: 0, high: 1, medium: 2, low: 3 };
+        queue.sort((a, b) => (order[a.priority] ?? 4) - (order[b.priority] ?? 4) || new Date(a.created_at).getTime() - new Date(b.created_at).getTime());
+        return json(queue.map(taskToSummary), 200, port);
+      }
+      if (path === "/api/tasks/claim" && method === "POST") {
+        try {
+          const body = await req.json();
+          const agentId = body.agent_id || "anonymous";
+          const pending = listTasks({ status: "pending", project_id: body.project_id });
+          const available = pending.filter((t) => !t.locked_by);
+          if (available.length === 0)
+            return json({ task: null }, 200, port);
+          const order = { critical: 0, high: 1, medium: 2, low: 3 };
+          available.sort((a, b) => (order[a.priority] ?? 4) - (order[b.priority] ?? 4));
+          const target = available[0];
+          try {
+            const claimed = startTask(target.id, agentId);
+            return json({ task: taskToSummary(claimed) }, 200, port);
+          } catch (e) {
+            const next = available[1] || null;
+            return json({
+              task: null,
+              locked_by: target.locked_by,
+              locked_since: target.locked_at,
+              suggested_task: next ? taskToSummary(next) : null
+            }, 200, port);
+          }
+        } catch (e) {
+          return json({ error: e instanceof Error ? e.message : "Failed to claim" }, 500, port);
+        }
+      }
       if (path === "/api/agents" && method === "GET") {
         return json(listAgents(), 200, port);
       }

package/package.json

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