@hasna/todos 0.9.26 → 0.9.27

package/dist/cli/index.js

@@ -8305,6 +8305,12 @@ function resolveTaskListId(agent, explicit) {
   return process.env[key] || process.env["TODOS_TASK_LIST_ID"] || getAgentTaskListId(normalized) || "default";
 }
 function formatTask(task) {
+  const id = task.short_id || task.id.slice(0, 8);
+  const assigned = task.assigned_to ? ` -> ${task.assigned_to}` : "";
+  const lock = task.locked_by ? ` [locked:${task.locked_by}]` : "";
+  return `${id} ${task.status.padEnd(11)} ${task.priority.padEnd(8)} ${task.title}${assigned}${lock}`;
+}
+function formatTaskDetail(task) {
   const parts = [
     `ID: ${task.id}`,
     `Title: ${task.title}`,
@@ -8385,8 +8391,7 @@ var init_mcp = __esm(() => {
       if (resolved.task_list_id)
         resolved.task_list_id = resolveId(resolved.task_list_id, "task_lists");
       const task = createTask(resolved);
-      return { content: [{ type: "text", text: `Task created:
-${formatTask(task)}` }] };
+      return { content: [{ type: "text", text: `created: ${formatTask(task)}` }] };
     } catch (e) {
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
@@ -8430,7 +8435,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 {
@@ -8438,7 +8443,7 @@ ${text}` }] };
       const task = getTaskWithRelations(resolvedId);
       if (!task)
         return { content: [{ type: "text", text: `Task not found: ${id}` }], isError: true };
-      const parts = [formatTask(task)];
+      const parts = [formatTaskDetail(task)];
       if (task.subtasks.length > 0) {
         parts.push(`
 Subtasks (${task.subtasks.length}):`);
@@ -8478,7 +8483,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"),
@@ -8494,8 +8499,7 @@ Parent: ${task.parent.id.slice(0, 8)} | ${task.parent.title}`);
     try {
       const resolvedId = resolveId(id);
       const task = updateTask(resolvedId, rest);
-      return { content: [{ type: "text", text: `Task updated:
-${formatTask(task)}` }] };
+      return { content: [{ type: "text", text: `updated: ${formatTask(task)}` }] };
     } catch (e) {
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
@@ -8516,28 +8520,26 @@ ${formatTask(task)}` }] };
       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 }) => {
     try {
       const resolvedId = resolveId(id);
       const task = startTask(resolvedId, agent_id);
-      return { content: [{ type: "text", text: `Task started:
-${formatTask(task)}` }] };
+      return { content: [{ type: "text", text: `started: ${formatTask(task)}` }] };
     } catch (e) {
       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 }) => {
     try {
       const resolvedId = resolveId(id);
       const task = completeTask(resolvedId, agent_id);
-      return { content: [{ type: "text", text: `Task completed:
-${formatTask(task)}` }] };
+      return { content: [{ type: "text", text: `completed: ${formatTask(task)}` }] };
     } catch (e) {
       return { content: [{ type: "text", text: formatError(e) }], isError: true };
     }
@@ -8569,7 +8571,7 @@ ${formatTask(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 }) => {
@@ -8760,7 +8762,7 @@ ${text}` }] };
       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")
@@ -8780,7 +8782,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"),
@@ -8828,7 +8830,7 @@ ${text}` }] };
       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 }) => {
@@ -8988,7 +8990,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 {
@@ -9004,7 +9006,7 @@ Slug: ${list.slug}`
       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 {
@@ -9021,7 +9023,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 {
@@ -9037,7 +9039,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")
@@ -9075,7 +9077,7 @@ ${text}` }] };
       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"),
@@ -9106,7 +9108,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"),
@@ -9139,7 +9141,7 @@ ${task.id.slice(0, 8)} | ${task.priority} | ${task.title}` }] };
       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 }) => {
@@ -9158,7 +9160,7 @@ ${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.", {
+  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 {
@@ -9191,6 +9193,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" }] };
@@ -9259,8 +9334,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,
@@ -9280,6 +9355,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;
@@ -9362,12 +9440,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 {
@@ -9391,7 +9471,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) => {
@@ -9517,8 +9597,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,
@@ -9535,7 +9615,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 {
@@ -9751,7 +9831,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 {
@@ -11043,7 +11123,7 @@ program2.command("add <title>").description("Create a new task").option("-d, --d
     console.log(formatTaskLine(task));
   }
 });
-program2.command("list").description("List tasks").option("-s, --status <status>", "Filter by status").option("-p, --priority <priority>", "Filter by priority").option("--assigned <agent>", "Filter by assigned agent").option("--tags <tags>", "Filter by tags (comma-separated)").option("--tag <tags>", "Filter by tags (alias for --tags)").option("-a, --all", "Show all tasks (including completed/cancelled)").option("--list <id>", "Filter by task list ID").option("--task-list <id>", "Filter by task list ID (alias for --list)").option("--project-name <name>", "Filter by project name").option("--agent-name <name>", "Filter by agent name/assigned").option("--sort <field>", "Sort by: updated, created, priority, status").action((opts) => {
+program2.command("list").description("List tasks").option("-s, --status <status>", "Filter by status").option("-p, --priority <priority>", "Filter by priority").option("--assigned <agent>", "Filter by assigned agent").option("--tags <tags>", "Filter by tags (comma-separated)").option("--tag <tags>", "Filter by tags (alias for --tags)").option("-a, --all", "Show all tasks (including completed/cancelled)").option("--list <id>", "Filter by task list ID").option("--task-list <id>", "Filter by task list ID (alias for --list)").option("--project-name <name>", "Filter by project name").option("--agent-name <name>", "Filter by agent name/assigned").option("--sort <field>", "Sort by: updated, created, priority, status").option("--format <fmt>", "Output format: table (default), compact, csv, json").action((opts) => {
   const globalOpts = program2.opts();
   opts.tags = opts.tags || opts.tag;
   opts.list = opts.list || opts.taskList;
@@ -11099,12 +11179,40 @@ program2.command("list").description("List tasks").option("-s, --status <status>
       return 0;
     });
   }
-  if (globalOpts.json) {
+  const fmt = opts.format || (globalOpts.json ? "json" : "table");
+  if (fmt === "json") {
     output(tasks, true);
     return;
   }
   if (tasks.length === 0) {
-    console.log(chalk.dim("No tasks found."));
+    if (fmt === "compact" || fmt === "csv")
+      process.stdout.write("");
+    else
+      console.log(chalk.dim("No tasks found."));
+    return;
+  }
+  if (fmt === "csv") {
+    const headers = "id,short_id,title,status,priority,assigned_to,updated_at";
+    const rows = tasks.map((t) => [
+      t.id,
+      t.short_id || "",
+      t.title.replace(/,/g, ";"),
+      t.status,
+      t.priority,
+      t.assigned_to || "",
+      t.updated_at
+    ].join(","));
+    console.log([headers, ...rows].join(`
+`));
+    return;
+  }
+  if (fmt === "compact") {
+    for (const t of tasks) {
+      const id = t.short_id || t.id.slice(0, 8);
+      const assigned = t.assigned_to ? ` ${t.assigned_to}` : "";
+      process.stdout.write(`${id} ${t.status} ${t.priority} ${t.title}${assigned}
+`);
+    }
     return;
   }
   console.log(chalk.bold(`${tasks.length} task(s):

package/package.json

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