taskin 4.1.3 → 4.2.0

package/README.md

@@ -87,6 +87,7 @@ Taskin is built as a modular ecosystem. Besides the CLI, you can use individual
 2. **List all tasks:**
    \`\`\`bash
    taskin list
+   taskin list --json   # JSON array, for another tool to consume
    \`\`\`
 
 3. **Start working on a task:**

package/dist/index.js

@@ -3456,6 +3456,51 @@ init_esm_shims();
 // ../task-manager/src/index.ts
 init_esm_shims();
 
+// ../task-manager/src/filter-tasks/index.ts
+init_esm_shims();
+
+// ../task-manager/src/filter-tasks/filter-tasks.ts
+init_esm_shims();
+var EM_ABERTO = ["pending", "in-progress", "paused", "in-review", "blocked"];
+var ENCERRADOS = ["done", "canceled"];
+var contem = (valor, procurado) => valor !== void 0 && valor.toLowerCase().includes(procurado);
+function casaResponsavel(task, procurado) {
+  const alvo = procurado.toLowerCase();
+  return contem(task.assignee?.id, alvo) || contem(task.assignee?.name, alvo);
+}
+function filterTasks(tasks, criteria) {
+  return tasks.filter((task) => {
+    if (criteria.status !== void 0) {
+      if (task.status !== criteria.status) return false;
+    } else if (criteria.open && !EM_ABERTO.includes(task.status)) {
+      return false;
+    } else if (criteria.closed && !ENCERRADOS.includes(task.status)) {
+      return false;
+    }
+    if (criteria.type !== void 0 && task.type !== criteria.type) return false;
+    if (criteria.assignee !== void 0 && !casaResponsavel(task, criteria.assignee)) return false;
+    if (criteria.text !== void 0) {
+      const procurado = criteria.text.toLowerCase();
+      const casa = task.id.toLowerCase().includes(procurado) || contem(task.title, procurado) || contem(task.status, procurado) || casaResponsavel(task, procurado);
+      if (!casa) return false;
+    }
+    return true;
+  });
+}
+function summarizeTask(task) {
+  return {
+    id: task.id,
+    title: task.title,
+    status: task.status,
+    type: task.type,
+    ...task.assignee && { assignee: { id: task.assignee.id, name: task.assignee.name } },
+    ...task.order !== void 0 && { priority: task.order },
+    ...task.groupId && { groupId: task.groupId },
+    ...task.groupName && { groupName: task.groupName },
+    ...task.difficulty !== void 0 && { difficulty: task.difficulty }
+  };
+}
+
 // ../task-manager/src/metrics.types.ts
 init_esm_shims();
 
@@ -3502,6 +3547,16 @@ var TaskManager = class {
     await this.taskProvider.updateTask(updatedTask);
     return updatedTask;
   }
+  /**
+   * Every task the configured provider knows about.
+   *
+   * Pass-through on purpose: the manager owns the state transitions, not the
+   * storage. Having it here is what lets a consumer holding only the manager —
+   * the MCP server — answer "what work exists?".
+   */
+  async getAllTasks() {
+    return await this.taskProvider.getAllTasks();
+  }
   async finishTask(taskId) {
     const task = await this.taskProvider.findTask(taskId);
     if (!task) {
@@ -4313,7 +4368,7 @@ async function startDashboard(options) {
       }
     });
     await wsServer.start();
-    success(`\u2713 WebSocket server running on ws://${host}:${wsPort}`);
+    success(`WebSocket server running on ws://${host}:${wsPort}`);
     info(`Starting dashboard server on http://${host}:${port}...`);
     const isDev = __dirname2.includes("/src/");
     const dashboardDist = isDev ? path8.join(__dirname2, "..", "..", "dashboard-dist") : path8.join(__dirname2, "..", "dashboard-dist");
@@ -4364,7 +4419,7 @@ async function startDashboard(options) {
     if (actualPort !== port) {
       warning(`Port ${port} was in use. Dashboard started on port ${actualPort}.`);
     }
-    success(`\u2713 Dashboard available at http://${host}:${actualPort}`);
+    success(`Dashboard available at http://${host}:${actualPort}`);
     const filterParams = new URLSearchParams();
     if (options.open) {
       filterParams.set("filter", "open");
@@ -4396,7 +4451,7 @@ async function startDashboard(options) {
         httpServer.close(() => resolve());
       });
       await wsServer.stop();
-      success("\u2713 Servers stopped");
+      success("Servers stopped");
       process.exit(0);
     };
     process.on("SIGINT", cleanup);
@@ -4943,7 +4998,7 @@ async function finishTask(taskId, options, gitService) {
     );
     console.log(colors.secondary(`  - Push: git push`));
     console.log();
-    info("\u2713 Dry run complete");
+    info("Dry run complete");
     return;
   }
   if (task.status === "done") {
@@ -4962,7 +5017,7 @@ async function finishTask(taskId, options, gitService) {
     if (behavior.autoCommitStatusChange) {
       const committed = await git.commitTaskStatusChangeOnBranch(normalizedId, "done", behavior.defaultBranch);
       if (committed) {
-        success("\u2713 Auto-committed status change");
+        success("Auto-committed status change");
       }
     }
     if (behavior.autoSync && behavior.originBranch && behavior.defaultBranch) {
@@ -4974,7 +5029,7 @@ async function finishTask(taskId, options, gitService) {
           ciSkipTag: behavior.ciSkipTag
         });
         if (squashed) {
-          success(`\u2713 Squash commit pushed to ${behavior.originBranch}`);
+          success(`Squash commit pushed to ${behavior.originBranch}`);
         }
       } catch (squashError) {
         error(
@@ -4990,7 +5045,7 @@ async function finishTask(taskId, options, gitService) {
           cwd: process.cwd(),
           stdio: "ignore"
         });
-        success("\u2713 Auto-committed completed work");
+        success("Auto-committed completed work");
       } catch {
       }
     }
@@ -5227,7 +5282,7 @@ async function initializeTaskin(options) {
   };
   info("Creating configuration file...");
   writeFileSync2(configFile, JSON.stringify(config, null, 2), "utf-8");
-  success(`\u2713 Created ${colors.highlight(".taskin.json")}`);
+  success(`Created ${colors.highlight(".taskin.json")}`);
   if (process.env.CI !== "true" && selectedProvider.id === "fs") {
     await promptCreateFirstUser(cwd);
   }
@@ -5310,7 +5365,7 @@ async function setupProviderConfig(provider, cwd) {
   }));
   const answers = await inquirer2.prompt(questions);
   console.log();
-  success(`\u2713 ${provider.name} configuration saved`);
+  success(`${provider.name} configuration saved`);
   return answers;
 }
 async function setupFileSystemProvider(cwd) {
@@ -5352,7 +5407,7 @@ This is a sample task created during Taskin initialization.
 You can edit or delete this file. Use \`taskin list\` to see all tasks.
 `;
     writeFileSync2(sampleTaskFile, sampleTask, "utf-8");
-    success(`\u2713 Created sample task ${colors.highlight("task-001-setup-project.md")}`);
+    success(`Created sample task ${colors.highlight("task-001-setup-project.md")}`);
   }
   return {
     tasksDir: "TASKS",
@@ -5397,7 +5452,7 @@ async function promptCreateFirstUser(cwd) {
     email: answers.email
   };
   await userRegistry.saveUser(user);
-  success(`\u2713 User "${user.name}" (${user.email}) created successfully!`);
+  success(`User "${user.name}" (${user.email}) created successfully!`);
 }
 
 // src/commands/lint.ts
@@ -5473,8 +5528,17 @@ async function executeLint(options) {
     console.log();
   }
   if (result.valid) {
-    console.log(chalk5.green(`\u2705 All task files are valid!
+    if (notices.length === 0) {
+      console.log(chalk5.green(`\u2705 All task files are valid!
 `));
+    } else {
+      const partes = [
+        result.warningCount > 0 ? `${result.warningCount} warning(s)` : "",
+        result.infoCount > 0 ? `${result.infoCount} info` : ""
+      ].filter(Boolean);
+      console.log(chalk5.green(`\u2705 No errors \u2014 ${partes.join(" and ")} above, listed for a human to decide.
+`));
+    }
   }
   if (!result.valid && !options.fix) {
     console.log(chalk5.blue(`\u{1F4A1} Run with --fix to automatically fix format issues
@@ -5509,6 +5573,10 @@ var listCommand = defineCommand({
     {
       flags: "--closed",
       description: "Show only closed tasks (done, canceled)"
+    },
+    {
+      flags: "--json",
+      description: "Print the tasks as JSON, for other tools to consume"
     }
   ],
   handler: async (filter, options) => {
@@ -5517,36 +5585,28 @@ var listCommand = defineCommand({
 });
 async function listTasks(filter, options) {
   requireTaskinProject();
-  printHeader("Task List", "\u{1F4CA}");
+  const comoJson = options.json === true;
+  if (!comoJson) {
+    printHeader("Task List", "\u{1F4CA}");
+  }
   const { provider: taskProvider } = await resolveTaskProvider();
   const tasks = await taskProvider.getAllTasks();
-  if (tasks.length === 0) {
+  if (tasks.length === 0 && !comoJson) {
     console.log(colors.warning("No tasks found in TASKS/ directory"));
     return;
   }
-  const openStatuses = ["pending", "in-progress", "paused", "in-review", "blocked"];
-  const closedStatuses = ["done", "canceled"];
-  let filteredTasks = tasks;
-  if (options.status) {
-    filteredTasks = filteredTasks.filter((t) => t.status === options.status);
-  } else if (options.open) {
-    filteredTasks = filteredTasks.filter((t) => t.status && openStatuses.includes(t.status));
-  } else if (options.closed) {
-    filteredTasks = filteredTasks.filter((t) => t.status && closedStatuses.includes(t.status));
-  }
-  if (options.type) {
-    filteredTasks = filteredTasks.filter((t) => t.type === options.type);
-  }
-  if (options.assignee) {
-    filteredTasks = filteredTasks.filter(
-      (t) => t.assignee?.name.toLowerCase().includes(options.assignee.toLowerCase()) || t.assignee?.id.toLowerCase().includes(options.assignee.toLowerCase())
-    );
-  }
-  if (filter) {
-    const lowerFilter = filter.toLowerCase();
-    filteredTasks = filteredTasks.filter(
-      (t) => t.id.includes(lowerFilter) || t.title.toLowerCase().includes(lowerFilter) || t.status.toLowerCase().includes(lowerFilter) || t.assignee?.name.toLowerCase().includes(lowerFilter) || t.assignee?.id.toLowerCase().includes(lowerFilter)
-    );
+  const criteria = {
+    ...options.status && { status: options.status },
+    ...options.type && { type: options.type },
+    ...options.assignee && { assignee: options.assignee },
+    ...options.open && { open: true },
+    ...options.closed && { closed: true },
+    ...filter && { text: filter }
+  };
+  const filteredTasks = filterTasks(tasks, criteria);
+  if (comoJson) {
+    console.log(JSON.stringify(filteredTasks.map(summarizeTask), null, 2));
+    return;
   }
   if (filteredTasks.length === 0) {
     console.log(colors.warning("No tasks match the filters"));
@@ -5625,6 +5685,72 @@ init_esm_shims();
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+
+// node_modules/@opentask/taskin-task-server-mcp/node_modules/@opentask/taskin-task-manager/dist/index.js
+init_esm_shims();
+
+// node_modules/@opentask/taskin-task-server-mcp/node_modules/@opentask/taskin-task-manager/dist/filter-tasks/index.js
+init_esm_shims();
+
+// node_modules/@opentask/taskin-task-server-mcp/node_modules/@opentask/taskin-task-manager/dist/filter-tasks/filter-tasks.js
+init_esm_shims();
+var EM_ABERTO2 = ["pending", "in-progress", "paused", "in-review", "blocked"];
+var ENCERRADOS2 = ["done", "canceled"];
+var contem2 = (valor, procurado) => valor !== void 0 && valor.toLowerCase().includes(procurado);
+function casaResponsavel2(task, procurado) {
+  const alvo = procurado.toLowerCase();
+  return contem2(task.assignee?.id, alvo) || contem2(task.assignee?.name, alvo);
+}
+function filterTasks2(tasks, criteria) {
+  return tasks.filter((task) => {
+    if (criteria.status !== void 0) {
+      if (task.status !== criteria.status)
+        return false;
+    } else if (criteria.open && !EM_ABERTO2.includes(task.status)) {
+      return false;
+    } else if (criteria.closed && !ENCERRADOS2.includes(task.status)) {
+      return false;
+    }
+    if (criteria.type !== void 0 && task.type !== criteria.type)
+      return false;
+    if (criteria.assignee !== void 0 && !casaResponsavel2(task, criteria.assignee))
+      return false;
+    if (criteria.text !== void 0) {
+      const procurado = criteria.text.toLowerCase();
+      const casa = task.id.toLowerCase().includes(procurado) || contem2(task.title, procurado) || contem2(task.status, procurado) || casaResponsavel2(task, procurado);
+      if (!casa)
+        return false;
+    }
+    return true;
+  });
+}
+function summarizeTask2(task) {
+  return {
+    id: task.id,
+    title: task.title,
+    status: task.status,
+    type: task.type,
+    ...task.assignee && { assignee: { id: task.assignee.id, name: task.assignee.name } },
+    ...task.order !== void 0 && { priority: task.order },
+    ...task.groupId && { groupId: task.groupId },
+    ...task.groupName && { groupName: task.groupName },
+    ...task.difficulty !== void 0 && { difficulty: task.difficulty }
+  };
+}
+
+// node_modules/@opentask/taskin-task-server-mcp/node_modules/@opentask/taskin-task-manager/dist/metrics.types.js
+init_esm_shims();
+
+// node_modules/@opentask/taskin-task-server-mcp/node_modules/@opentask/taskin-task-manager/dist/task-manager.js
+init_esm_shims();
+
+// node_modules/@opentask/taskin-task-server-mcp/node_modules/@opentask/taskin-task-manager/dist/task-manager.types.js
+init_esm_shims();
+
+// node_modules/@opentask/taskin-task-server-mcp/node_modules/@opentask/taskin-task-manager/dist/user-registry.types.js
+init_esm_shims();
+
+// node_modules/@opentask/taskin-task-server-mcp/dist/task-server-mcp.js
 import { TaskIdSchema as TaskIdSchema4 } from "@opentask/taskin-types";
 function readTaskId(raw) {
   if (typeof raw !== "string")
@@ -5643,7 +5769,7 @@ function invalidTaskId(raw) {
     isError: true
   };
 }
-var TaskMCPServer = class {
+var TaskMCPServer = class _TaskMCPServer {
   server;
   taskManager;
   config;
@@ -5682,12 +5808,7 @@ var TaskMCPServer = class {
         arguments: request.params.arguments
       });
       return {
-        content: [
-          {
-            type: "text",
-            text: result.content
-          }
-        ],
+        content: result.content,
         isError: result.isError
       };
     });
@@ -5753,6 +5874,22 @@ var TaskMCPServer = class {
    */
   listTools() {
     const tools = [
+      {
+        name: "list_tasks",
+        description: "List the tasks in the project. Returns a JSON array with what identifies each task \u2014 id, title, status, type, assignee \u2014 without the markdown body. Fetch a task body by id after choosing one.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            status: { type: "string", description: "Exact status (pending, in-progress, done, ...)" },
+            type: { type: "string", description: "Exact type (feat, fix, chore, ...)" },
+            assignee: { type: "string", description: "Assignee id or name, whole or in part" },
+            open: { type: "boolean", description: "Only tasks still open" },
+            closed: { type: "boolean", description: "Only tasks already closed" },
+            text: { type: "string", description: "Free text over id, title, status and assignee" }
+          },
+          required: []
+        }
+      },
       {
         name: "start_task",
         description: "Start working on a task by changing its status to in-progress",
@@ -5791,6 +5928,8 @@ var TaskMCPServer = class {
     try {
       this.log(`Calling tool: ${params.name}`, params.arguments);
       switch (params.name) {
+        case "list_tasks":
+          return await this.handleListTasks(params.arguments ?? {});
         case "start_task": {
           const taskId = readTaskId(params.arguments?.taskId);
           return taskId ? await this.handleStartTask(taskId) : invalidTaskId(params.arguments?.taskId);
@@ -5994,6 +6133,35 @@ Let me start by marking the task as done using the finish_task tool.`
         throw new Error(`Unknown prompt: ${params.name}`);
     }
   }
+  /**
+   * Le e seleciona as tarefas, pela mesma seam que o CLI usa.
+   *
+   * `filterTasks` e `summarizeTask` vivem no pacote agnostico justamente para
+   * que a resposta aqui e a de `taskin list --json` nao possam divergir — ja
+   * houve duas filtragens discordando no repositorio.
+   */
+  async selecionarTarefas(criteria) {
+    const tasks = await this.taskManager.getAllTasks();
+    return filterTasks2(tasks, criteria).map(summarizeTask2);
+  }
+  /** Converte os argumentos crus da chamada MCP no criterio tipado. */
+  static criterioDe(args) {
+    return {
+      ...typeof args.status === "string" && { status: args.status },
+      ...typeof args.type === "string" && { type: args.type },
+      ...typeof args.assignee === "string" && { assignee: args.assignee },
+      ...args.open === true && { open: true },
+      ...args.closed === true && { closed: true },
+      ...typeof args.text === "string" && { text: args.text }
+    };
+  }
+  async handleListTasks(args) {
+    const tarefas = await this.selecionarTarefas(_TaskMCPServer.criterioDe(args));
+    return {
+      content: [{ type: "text", text: JSON.stringify(tarefas, null, 2) }],
+      isError: false
+    };
+  }
   /**
    * List available resources
    */
@@ -6016,15 +6184,13 @@ Let me start by marking the task as done using the finish_task tool.`
     this.log(`Reading resource: ${params.uri}`);
     const uri = params.uri;
     if (uri === "taskin://tasks") {
+      const tarefas = await this.selecionarTarefas({});
       return {
         contents: [
           {
             uri,
             mimeType: "application/json",
-            text: JSON.stringify({
-              message: "Task list would be here",
-              note: "Requires ITaskProvider integration"
-            })
+            text: JSON.stringify(tarefas, null, 2)
           }
         ]
       };
@@ -6083,7 +6249,7 @@ async function startMCPServer(options) {
     });
     info("Starting MCP server...");
     await mcpServer.connect({ transport });
-    success("\u2713 MCP server started successfully");
+    success("MCP server started successfully");
     info("");
     info(chalk6.bold("Server Information:"));
     info(`  \u2022 Transport: ${chalk6.cyan(transport)}`);
@@ -6105,7 +6271,7 @@ async function startMCPServer(options) {
     info("");
     const cleanup = async () => {
       info("\nShutting down MCP server...");
-      success("\u2713 Server stopped");
+      success("Server stopped");
       process.exit(0);
     };
     process.on("SIGINT", cleanup);
@@ -6278,7 +6444,7 @@ async function createTask(options, gitService) {
     console.log(colors.secondary(`\u{1F4C1} Path: ${createdPath}`));
   }
   if (autoSyncActive) {
-    success("\u2713 Task committed and pushed to remote");
+    success("Task committed and pushed to remote");
   }
   console.log();
   console.log(colors.info("Next steps:"));
@@ -6433,7 +6599,7 @@ async function pauseTask(taskId, options) {
     console.log(colors.secondary(`  - Add all changes: git add -A`));
     console.log(colors.secondary(`  - Commit: git commit -m "${commitMessage2}"`));
     console.log();
-    info("\u2713 Dry run complete");
+    info("Dry run complete");
     return;
   }
   if (task.status !== "in-progress") {
@@ -6467,7 +6633,7 @@ async function pauseTask(taskId, options) {
     }
     await taskManager.pauseTask(normalizedId);
     success("Task paused successfully!");
-    success("\u2713 Auto-committed work in progress");
+    success("Auto-committed work in progress");
     info("Status updated to paused");
     console.log();
     info("Next steps:");
@@ -6654,7 +6820,7 @@ async function reviewTask(taskId, options) {
       });
       console.log();
     }
-    info("\u2713 Dry run complete");
+    info("Dry run complete");
     return;
   }
   if (reviewHooks.pre && reviewHooks.pre.length > 0 && !options.skipMerge) {
@@ -6673,7 +6839,7 @@ async function reviewTask(taskId, options) {
     const failedPre = preResults.find((r) => !r.success);
     if (failedPre && !hookSettings.continueOnError) {
       console.log();
-      error("\u2717 Pre-review hooks failed!");
+      error("Pre-review hooks failed!");
       error("Fix the errors above and try again.");
       process.exit(1);
     }
@@ -6695,7 +6861,7 @@ async function reviewTask(taskId, options) {
     const failedCheck = duringResults.find((r) => !r.success);
     if (failedCheck && !hookSettings.continueOnError) {
       console.log();
-      error("\u2717 Review checks failed!");
+      error("Review checks failed!");
       error("Fix the errors above and try again.");
       console.log();
       info("Tip: Run individual checks to see full error details");
@@ -6705,7 +6871,7 @@ async function reviewTask(taskId, options) {
   }
   info("Marking task as ready for review...");
   const updatedTask = await taskManager.reviewTask(task.id);
-  success(`\u2713 Task ${updatedTask.id} status changed to: ${updatedTask.status}`);
+  success(`Task ${updatedTask.id} status changed to: ${updatedTask.status}`);
   if (behavior.autoCommitStatusChange) {
     try {
       const message = appendCiSkipTag(
@@ -6716,7 +6882,7 @@ async function reviewTask(taskId, options) {
         cwd: monorepoRoot,
         stdio: "ignore"
       });
-      success("\u2713 Auto-committed status change");
+      success("Auto-committed status change");
     } catch {
     }
   }
@@ -6737,7 +6903,7 @@ async function reviewTask(taskId, options) {
     console.log();
   }
   const totalDuration = [...reviewHooks.pre ?? [], ...reviewHooks.during ?? [], ...reviewHooks.post ?? []].length > 0 ? "with hooks" : "";
-  success(`\u2713 Task ready for review! ${totalDuration}`);
+  success(`Task ready for review! ${totalDuration}`);
   await sendTaskNotification(configManager, "task:review", normalizedId, task.title);
   if (options.sound !== false) {
     await playSound("review");
@@ -6830,7 +6996,7 @@ async function startTask(taskId, _options, gitService) {
       )
     );
     console.log();
-    info("\u2713 Dry run complete");
+    info("Dry run complete");
     return;
   }
   if (task.status === "in-progress") {
@@ -6849,7 +7015,7 @@ async function startTask(taskId, _options, gitService) {
   if (behavior.autoCommitStatusChange) {
     const committed = await git.commitTaskStatusChangeOnBranch(normalizedId, "in-progress", behavior.defaultBranch);
     if (committed) {
-      success("\u2713 Auto-committed status change");
+      success("Auto-committed status change");
     }
   }
   console.log();
@@ -7068,102 +7234,72 @@ function getStatusEmoji(status) {
 
 // src/lib/help.ts
 init_esm_shims();
-function showCustomHelp() {
+var EXEMPLOS = {
+  init: ["taskin init", "taskin setup"],
+  list: ["taskin list", "taskin list pending", "taskin list --status in-progress", "taskin list --type feat"],
+  new: [
+    'taskin new -t feat -T "Add login" -d "Implement user authentication"',
+    'taskin new --type fix --title "Fix bug" --user "John"',
+    'taskin create -t docs -T "Update README"'
+  ],
+  start: ["taskin start 001", "taskin start task-001", "taskin start 001 --force"],
+  pause: ["taskin pause 001", 'taskin pause 001 -m "saving progress"'],
+  review: ["taskin review 001", "taskin review 001 --dry-run"],
+  finish: ["taskin finish 001", "taskin done task-001"],
+  stats: ["taskin stats", "taskin stats --team", "taskin stats --period month"],
+  config: ["taskin config", "taskin config --level assisted", "taskin config --show"],
+  export: ["taskin export", "taskin export --format json"],
+  lint: ["taskin lint", "taskin lint --fix", "taskin lint --fix --metadata-style=list"],
+  dashboard: ["taskin dashboard", "taskin dashboard --port 3000", "taskin dashboard --filter-open"],
+  "mcp-server": ["taskin mcp-server", "taskin mcp"],
+  notify: ["taskin notify --event task:done --task 001"]
+};
+var ICONE_PADRAO = "\u2022";
+function separarIcone(descricao) {
+  const match = descricao.match(new RegExp("^(\\p{Extended_Pictographic}\\uFE0F?)\\s+(.*)$", "su"));
+  return match?.[1] && match[2] !== void 0 ? { icone: match[1], texto: match[2] } : { icone: ICONE_PADRAO, texto: descricao };
+}
+var OCULTOS = ["help"];
+function assinatura(cmd) {
+  const argumentos = cmd.usage().replace("[options]", "").trim();
+  const nome = colors.highlight(`taskin ${cmd.name()}`);
+  return argumentos ? nome + colors.normal(` ${argumentos}`) : nome;
+}
+function detalhes(cmd) {
+  const partes = [];
+  const aliases = cmd.aliases();
+  if (aliases.length > 0) {
+    partes.push(`Alias: ${aliases.join(", ")}`);
+  }
+  const flags = cmd.options.map((opcao) => opcao.flags.split(",")[0]?.trim()).filter(Boolean);
+  if (flags.length > 0) {
+    partes.push(`Options: ${flags.join(", ")}`);
+  }
+  return partes.length > 0 ? partes.join(" \xB7 ") : void 0;
+}
+function showCustomHelp(program2) {
   printHeader("Taskin - Task Management System", icons.rocket);
   console.log(colors.info("\u{1F4CB} AVAILABLE COMMANDS"));
   console.log(colors.highlight("\u2550".repeat(60)));
   console.log();
-  const commands = [
-    {
-      name: colors.highlight("taskin init"),
-      alias: colors.secondary("Alias: setup"),
-      description: "Initialize Taskin in your project",
-      examples: ["taskin init", "taskin setup"],
-      icon: "\u{1F3AF}"
-    },
-    {
-      name: colors.highlight("taskin list") + colors.normal(" [filter]"),
-      alias: colors.secondary("Alias: ls"),
-      description: "List all tasks in the project",
-      examples: ["taskin list", "taskin list pending", "taskin list --status in-progress", "taskin list --type feat"],
-      icon: "\u{1F4CA}"
-    },
-    {
-      name: colors.highlight("taskin new"),
-      alias: colors.secondary("Alias: create"),
-      description: "Create a new task",
-      examples: [
-        'taskin new -t feat -T "Add login" -d "Implement user authentication"',
-        'taskin new --type fix --title "Fix bug" --user "John"',
-        'taskin create -t docs -T "Update README"'
-      ],
-      icon: "\u{1F4DD}"
-    },
-    {
-      name: colors.highlight("taskin start") + colors.normal(" <task-id>"),
-      alias: colors.secondary("Alias: begin"),
-      description: "Start working on a task (suggests commits)",
-      examples: ["taskin start 001", "taskin start task-001", "taskin start 001 --force"],
-      icon: "\u{1F680}"
-    },
-    {
-      name: colors.highlight("taskin pause") + colors.normal(" <task-id>"),
-      alias: colors.secondary("Alias: stop"),
-      description: "Pause a task (auto-commits work in progress)",
-      examples: ["taskin pause 001", 'taskin pause 001 -m "saving progress"'],
-      icon: "\u23F8\uFE0F"
-    },
-    {
-      name: colors.highlight("taskin finish") + colors.normal(" <task-id>"),
-      alias: colors.secondary("Alias: done"),
-      description: "Finish a task (suggests commits)",
-      examples: ["taskin finish 001", "taskin done task-001"],
-      icon: "\u2705"
-    },
-    {
-      name: colors.highlight("taskin config") + colors.normal(" [options]"),
-      alias: colors.secondary("Options: --level <manual|assisted|autopilot>"),
-      description: "Configure automation level",
-      examples: ["taskin config", "taskin config --level assisted", "taskin config --level autopilot"],
-      icon: "\u2699\uFE0F"
-    },
-    {
-      name: colors.highlight("taskin lint") + colors.normal(" [options]"),
-      alias: colors.secondary("Options: -p, --path <directory>"),
-      description: "Validate task markdown files",
-      examples: ["taskin lint", "taskin lint --path ./TASKS", "taskin lint -p /path/to/tasks"],
-      icon: "\u{1F50D}"
-    },
-    {
-      name: colors.highlight("taskin dashboard") + colors.normal(" [options]"),
-      alias: colors.secondary("Options: --host, --port, --filter-open, --filter-closed"),
-      description: "Start the web dashboard",
-      examples: [
-        "taskin dashboard",
-        "taskin dashboard --port 3000",
-        "taskin dashboard --filter-open",
-        "taskin dashboard --filter-closed -o"
-      ],
-      icon: "\u{1F4CA}"
-    },
-    {
-      name: colors.highlight("taskin mcp-server"),
-      alias: colors.secondary("Alias: mcp"),
-      description: "Start MCP server for Claude Desktop integration",
-      examples: ["taskin mcp-server", "taskin mcp"],
-      icon: "\u{1F916}"
+  const comandos = program2.commands.filter((cmd) => !OCULTOS.includes(cmd.name()));
+  comandos.forEach((cmd, index) => {
+    const exemplos = EXEMPLOS[cmd.name()] ?? [];
+    const { icone, texto } = separarIcone(cmd.description());
+    console.log(colors.warning(`${icone} ${assinatura(cmd)}`));
+    const linhaDeDetalhes = detalhes(cmd);
+    if (linhaDeDetalhes) {
+      console.log(colors.normal(`   ${colors.secondary(linhaDeDetalhes)}`));
+    }
+    console.log(colors.info(`   ${texto}`));
+    if (exemplos.length > 0) {
+      console.log();
+      console.log(colors.normal(`   ${colors.info("\u{1F4DD} Examples:")}`));
+      for (const exemplo of exemplos) {
+        console.log(colors.secondary(`      ${exemplo}`));
+      }
     }
-  ];
-  commands.forEach((cmd, index) => {
-    console.log(colors.warning(`${cmd.icon} ${cmd.name}`));
-    console.log(colors.normal(`   ${cmd.alias}`));
-    console.log(colors.info(`   ${cmd.description}`));
-    console.log();
-    console.log(colors.normal(`   ${colors.info("\u{1F4DD} Examples:")}`));
-    cmd.examples.forEach((example) => {
-      console.log(colors.secondary(`      ${example}`));
-    });
-    if (index < commands.length - 1) {
+    if (index < comandos.length - 1) {
       console.log();
       console.log(colors.normal(`   ${colors.secondary("\u2500".repeat(50))}`));
       console.log();
@@ -7565,7 +7701,7 @@ var program = new Command();
 program.name("taskin").description("\u{1F680} Task Management System").version(getVersion());
 program.helpOption("-h, --help", "Display help information");
 program.command("help").description("Show help information").action(() => {
-  showCustomHelp();
+  showCustomHelp(program);
 });
 initCommand(program);
 listCommand(program);
@@ -7582,15 +7718,15 @@ dashboardCommand(program);
 mcpServerCommand(program);
 notifyCommand(program);
 program.on("option:help", () => {
-  showCustomHelp();
+  showCustomHelp(program);
   process.exit(0);
 });
 if (process.argv.length <= 2) {
-  showCustomHelp();
+  showCustomHelp(program);
   process.exit(0);
 }
 if (process.argv.length === 3 && (process.argv[2] === "--help" || process.argv[2] === "-h")) {
-  showCustomHelp();
+  showCustomHelp(program);
   process.exit(0);
 }
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taskin",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "description": "Task management system integrated with Git workflows",
   "motivation": "Provide a CLI tool for task management integrated with Git workflows",
   "solve": "Simplifies task tracking and management directly from the command line",
@@ -79,13 +79,13 @@
     "play-sound": "^1.1.6",
     "ws": "^8.18.3",
     "zod": "^3.25.76",
-    "@opentask/taskin-file-system-provider": "3.2.3",
-    "@opentask/taskin-task-manager": "3.0.2",
-    "@opentask/taskin-task-server-ws": "0.3.2",
-    "@opentask/taskin-task-server-mcp": "0.2.4",
-    "@opentask/taskin-git-utils": "3.0.2",
-    "@opentask/taskin-utils": "1.1.1",
-    "@opentask/taskin-types": "2.1.1"
+    "@opentask/taskin-file-system-provider": "3.2.4",
+    "@opentask/taskin-git-utils": "3.0.3",
+    "@opentask/taskin-task-server-mcp": "0.3.0",
+    "@opentask/taskin-task-manager": "3.1.0",
+    "@opentask/taskin-task-server-ws": "0.3.3",
+    "@opentask/taskin-types": "2.2.0",
+    "@opentask/taskin-utils": "1.1.1"
   },
   "devDependencies": {
     "@types/node": "^20.19.24",