@hasna/todos 0.9.23 → 0.9.25

package/dist/mcp/index.js

@@ -6196,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 {
@@ -6244,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"),
@@ -6282,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 }) => {
@@ -6295,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 }) => {
@@ -6335,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 }) => {
@@ -6526,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")
@@ -6546,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"),
@@ -6594,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 }) => {
@@ -6754,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 {
@@ -6770,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 {
@@ -6787,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 {
@@ -6803,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")
@@ -6841,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"),
@@ -6872,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"),
@@ -6905,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 }) => {
@@ -6924,7 +6924,7 @@ 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.", {
+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 {
@@ -6957,6 +6957,79 @@ In Progress:`);
     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

@@ -1429,8 +1429,8 @@ function serveStaticFile(filePath) {
     headers: { "Content-Type": contentType }
   });
 }
-function taskToSummary(task) {
-  return {
+function taskToSummary(task, fields) {
+  const full = {
     id: task.id,
     short_id: task.short_id,
     title: task.title,
@@ -1450,6 +1450,9 @@ function taskToSummary(task) {
     completed_at: task.completed_at,
     due_at: task.due_at
   };
+  if (!fields || fields.length === 0)
+    return full;
+  return Object.fromEntries(fields.map((f) => [f, full[f] ?? null]));
 }
 async function startServer(port, options) {
   const shouldOpen = options?.open ?? true;
@@ -1532,12 +1535,14 @@ Dashboard not found at: ${dashboardDir}`);
         const status = url.searchParams.get("status") || undefined;
         const projectId = url.searchParams.get("project_id") || undefined;
         const limitParam = url.searchParams.get("limit");
+        const fieldsParam = url.searchParams.get("fields");
+        const fields = fieldsParam ? fieldsParam.split(",").map((f) => f.trim()).filter(Boolean) : undefined;
         const tasks = listTasks({
           status,
           project_id: projectId,
           limit: limitParam ? parseInt(limitParam, 10) : undefined
         });
-        return json(tasks.map(taskToSummary), 200, port);
+        return json(tasks.map((t) => taskToSummary(t, fields)), 200, port);
       }
       if (path === "/api/tasks" && method === "POST") {
         try {
@@ -1561,7 +1566,7 @@ Dashboard not found at: ${dashboardDir}`);
         const status = url.searchParams.get("status") || undefined;
         const projectId = url.searchParams.get("project_id") || undefined;
         const tasks = listTasks({ status, project_id: projectId, limit: 1e4 });
-        const summaries = tasks.map(taskToSummary);
+        const summaries = tasks.map((t) => taskToSummary(t));
         if (format === "csv") {
           const headers = ["id", "short_id", "title", "status", "priority", "project_id", "assigned_to", "agent_id", "created_at", "updated_at", "completed_at", "due_at"];
           const rows = summaries.map((t) => headers.map((h) => {
@@ -1687,8 +1692,8 @@ Dashboard not found at: ${dashboardDir}`);
         const completed = allTasks.filter((t) => t.status === "completed");
         return json({
           agent,
-          pending_tasks: pending.map(taskToSummary),
-          in_progress_tasks: inProgress.map(taskToSummary),
+          pending_tasks: pending.map((t) => taskToSummary(t)),
+          in_progress_tasks: inProgress.map((t) => taskToSummary(t)),
           stats: {
             total: allTasks.length,
             pending: pending.length,
@@ -1705,7 +1710,7 @@ Dashboard not found at: ${dashboardDir}`);
         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);
+        return json(queue.map((t) => taskToSummary(t)), 200, port);
       }
       if (path === "/api/tasks/claim" && method === "POST") {
         try {
@@ -1921,7 +1926,7 @@ Dashboard not found at: ${dashboardDir}`);
           if (!plan)
             return json({ error: "Plan not found" }, 404, port);
           const tasks = listTasks({ plan_id: id });
-          return json({ ...plan, tasks: tasks.map(taskToSummary) }, 200, port);
+          return json({ ...plan, tasks: tasks.map((t) => taskToSummary(t)) }, 200, port);
         }
         if (method === "PATCH") {
           try {

package/package.json

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