@hasna/todos 0.9.22 → 0.9.24

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];
@@ -6170,7 +6196,7 @@ ${text}` }] };
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("get_task", "Get full task details including dependencies, subtasks, and comments", {
+server.tool("get_task", "Get full task details with relations", {
   id: exports_external.string().describe("Task ID (full or partial)")
 }, async ({ id }) => {
   try {
@@ -6218,7 +6244,7 @@ Parent: ${task.parent.id.slice(0, 8)} | ${task.parent.title}`);
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("update_task", "Update task fields (requires version for optimistic locking)", {
+server.tool("update_task", "Update task fields. Version required for optimistic locking.", {
   id: exports_external.string().describe("Task ID (full or partial)"),
   version: exports_external.number().describe("Current version (for optimistic locking)"),
   title: exports_external.string().optional().describe("New title"),
@@ -6256,7 +6282,7 @@ server.tool("delete_task", "Delete a task permanently", {
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("start_task", "Claim a task, lock it, and set status to in_progress", {
+server.tool("start_task", "Claim, lock, and set task status to in_progress.", {
   id: exports_external.string().describe("Task ID (full or partial)"),
   agent_id: exports_external.string().describe("Agent claiming the task")
 }, async ({ id, agent_id }) => {
@@ -6269,7 +6295,7 @@ ${formatTask(task)}` }] };
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("complete_task", "Mark a task as completed and release lock", {
+server.tool("complete_task", "Mark task completed and release lock.", {
   id: exports_external.string().describe("Task ID (full or partial)"),
   agent_id: exports_external.string().optional().describe("Agent completing the task")
 }, async ({ id, agent_id }) => {
@@ -6309,7 +6335,7 @@ server.tool("unlock_task", "Release exclusive lock on a task", {
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("add_dependency", "Add a dependency between tasks (task_id depends on depends_on)", {
+server.tool("add_dependency", "Add a dependency: task_id depends on depends_on.", {
   task_id: exports_external.string().describe("Task that depends on another"),
   depends_on: exports_external.string().describe("Task that must complete first")
 }, async ({ task_id, depends_on }) => {
@@ -6500,7 +6526,7 @@ server.tool("delete_plan", "Delete a plan", {
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("search_tasks", "Full-text search across task titles, descriptions, and tags", {
+server.tool("search_tasks", "Full-text search across task titles, descriptions, tags.", {
   query: exports_external.string().describe("Search query"),
   project_id: exports_external.string().optional().describe("Limit to project"),
   task_list_id: exports_external.string().optional().describe("Filter by task list")
@@ -6520,7 +6546,7 @@ ${text}` }] };
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("sync", "Sync tasks with an agent task list (Claude uses native task list; others use JSON lists).", {
+server.tool("sync", "Sync tasks with an agent task list.", {
   task_list_id: exports_external.string().optional().describe("Task list ID (required for Claude)"),
   agent: exports_external.string().optional().describe("Agent/provider name (default: claude)"),
   all_agents: exports_external.boolean().optional().describe("Sync across all configured agents"),
@@ -6568,7 +6594,7 @@ server.tool("sync", "Sync tasks with an agent task list (Claude uses native task
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("register_agent", "Register an agent and get a short UUID. Idempotent: same name returns existing agent.", {
+server.tool("register_agent", "Register an agent (idempotent by name).", {
   name: exports_external.string().describe("Agent name"),
   description: exports_external.string().optional().describe("Agent description")
 }, async ({ name, description }) => {
@@ -6728,7 +6754,7 @@ Slug: ${list.slug}`
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("delete_task_list", "Delete a task list. Tasks in this list keep their data but lose their list association.", {
+server.tool("delete_task_list", "Delete a task list. Tasks lose association but keep data.", {
   id: exports_external.string().describe("Task list ID (full or partial)")
 }, async ({ id }) => {
   try {
@@ -6744,7 +6770,7 @@ server.tool("delete_task_list", "Delete a task list. Tasks in this list keep the
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("get_task_history", "Get change history for a task (audit log)", {
+server.tool("get_task_history", "Get audit log for a task.", {
   task_id: exports_external.string().describe("Task ID (full or partial)")
 }, async ({ task_id }) => {
   try {
@@ -6761,7 +6787,7 @@ ${text}` }] };
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("get_recent_activity", "Get recent task changes across all tasks (audit log)", {
+server.tool("get_recent_activity", "Get recent task changes across all tasks.", {
   limit: exports_external.number().optional().describe("Max entries (default 50)")
 }, async ({ limit }) => {
   try {
@@ -6777,7 +6803,7 @@ ${text}` }] };
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("create_webhook", "Register a webhook URL to receive task change notifications", {
+server.tool("create_webhook", "Register a webhook to receive task change events.", {
   url: exports_external.string().describe("Webhook URL"),
   events: exports_external.array(exports_external.string()).optional().describe("Event types to subscribe to (empty = all)"),
   secret: exports_external.string().optional().describe("HMAC secret for signature verification")
@@ -6815,7 +6841,7 @@ server.tool("delete_webhook", "Delete a webhook", {
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("create_template", "Create a reusable task template", {
+server.tool("create_template", "Create a reusable task template.", {
   name: exports_external.string().describe("Template name"),
   title_pattern: exports_external.string().describe("Title pattern for tasks created from this template"),
   description: exports_external.string().optional().describe("Default description"),
@@ -6846,7 +6872,7 @@ ${text}` }] };
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("create_task_from_template", "Create a task from a template with optional overrides", {
+server.tool("create_task_from_template", "Create a task from a template with optional overrides.", {
   template_id: exports_external.string().describe("Template ID"),
   title: exports_external.string().optional().describe("Override title"),
   description: exports_external.string().optional().describe("Override description"),
@@ -6879,7 +6905,7 @@ server.tool("delete_template", "Delete a task template", { id: exports_external.
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("approve_task", "Approve a task that requires approval before completion", {
+server.tool("approve_task", "Approve a task that requires approval.", {
   id: exports_external.string().describe("Task ID (full or partial)"),
   agent_id: exports_external.string().optional().describe("Agent approving the task")
 }, async ({ id, agent_id }) => {
@@ -6898,6 +6924,112 @@ 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 assigned tasks and stats for an agent.", {
+  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.tool("search_tools", "List tool names matching a query.", { query: exports_external.string().optional().describe("Keyword to filter tools") }, async ({ query }) => {
+  const all = [
+    "create_task",
+    "list_tasks",
+    "get_task",
+    "update_task",
+    "delete_task",
+    "start_task",
+    "complete_task",
+    "lock_task",
+    "unlock_task",
+    "approve_task",
+    "add_dependency",
+    "remove_dependency",
+    "add_comment",
+    "create_project",
+    "list_projects",
+    "create_plan",
+    "list_plans",
+    "get_plan",
+    "update_plan",
+    "delete_plan",
+    "register_agent",
+    "list_agents",
+    "get_agent",
+    "get_my_tasks",
+    "create_task_list",
+    "list_task_lists",
+    "get_task_list",
+    "update_task_list",
+    "delete_task_list",
+    "search_tasks",
+    "sync",
+    "get_task_history",
+    "get_recent_activity",
+    "create_webhook",
+    "list_webhooks",
+    "delete_webhook",
+    "create_template",
+    "list_templates",
+    "create_task_from_template",
+    "delete_template",
+    "search_tools",
+    "describe_tools"
+  ];
+  const q = query?.toLowerCase();
+  const matches = q ? all.filter((n) => n.includes(q)) : all;
+  return { content: [{ type: "text", text: matches.join(", ") }] };
+});
+server.tool("describe_tools", "Get descriptions for specific tools by name.", { names: exports_external.array(exports_external.string()).describe("Tool names from search_tools") }, async ({ names }) => {
+  const descriptions = {
+    create_task: "Create a task. Params: title(req), description, priority, project_id, plan_id, tags, assigned_to, estimated_minutes, requires_approval",
+    list_tasks: "List tasks. Params: status, priority, project_id, plan_id, assigned_to, tags, limit",
+    get_task: "Get full task details. Params: id",
+    update_task: "Update task fields. Params: id, version(req), title, description, status, priority, tags, assigned_to, due_at",
+    delete_task: "Delete a task. Params: id",
+    start_task: "Claim, lock, and start a task. Params: id",
+    complete_task: "Mark task completed. Params: id, agent_id",
+    approve_task: "Approve task requiring approval. Params: id, agent_id",
+    create_plan: "Create a plan. Params: name, description, project_id, task_list_id, agent_id, status",
+    list_plans: "List plans. Params: project_id",
+    get_plan: "Get plan with tasks. Params: id",
+    search_tasks: "Full-text search tasks. Params: query, project_id, task_list_id",
+    get_my_tasks: "Get your tasks and stats. Params: agent_name",
+    get_task_history: "Get task audit log. Params: task_id",
+    get_recent_activity: "Recent changes across all tasks. Params: limit",
+    create_template: "Create task template. Params: name, title_pattern, description, priority, tags",
+    create_task_from_template: "Create task from template. Params: template_id, title, priority, assigned_to"
+  };
+  const result = names.map((n) => `${n}: ${descriptions[n] || "See tool schema"}`).join(`
+`);
+  return { content: [{ type: "text", text: result }] };
+});
 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.22",
+  "version": "0.9.24",
   "description": "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   "type": "module",
   "main": "dist/index.js",