taskin 1.0.9 → 1.0.11

package/README.md

@@ -19,7 +19,7 @@ Taskin is a command-line tool that helps you manage tasks directly from your ter
 
 ## 🚀 Installation
 
-\`\`\`bash
+```bash
 
 # Using npx (recommended - no installation needed!)
 
@@ -36,9 +36,9 @@ pnpm add -g taskin
 # Or with yarn
 
 yarn global add taskin
-\`\`\`
+```
 
-> **Note:** This is a beta version. Please report any issues on [GitHub](https://github.com/sidartaveloso/taskin/issues).
+> **Note:** Please report any issues on [GitHub](https://github.com/sidartaveloso/taskin/issues).
 
 ## 📦 Available Packages
 
@@ -103,6 +103,59 @@ Taskin is built as a modular ecosystem. Besides the CLI, you can use individual
 - `taskin pause <id>` - Pause work on a task
 - `taskin finish <id>` - Complete a task
 - `taskin lint` - Validate task files
+- `taskin dashboard` - Start the web dashboard
+- `taskin mcp-server` - Start MCP server for Claude Desktop integration (alias: `mcp`)
+
+## 🤖 MCP Server (Model Context Protocol)
+
+Taskin includes an MCP server that allows AI assistants like Claude Desktop to interact with your tasks:
+
+```bash
+taskin mcp-server
+```
+
+### Integration with Claude Desktop
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "taskin": {
+      "args": ["taskin@beta", "mcp-server"],
+      "command": "npx"
+    }
+  }
+}
+```
+
+Or if installed globally:
+
+```json
+{
+  "mcpServers": {
+    "taskin": {
+      "args": ["mcp-server"],
+      "command": "taskin"
+    }
+  }
+}
+```
+
+**Available MCP Tools:**
+
+- `start_task` - Start working on a task
+- `finish_task` - Mark a task as finished
+
+**Available MCP Prompts:**
+
+- `start-task-workflow` - Guide for starting tasks
+- `finish-task-workflow` - Guide for finishing tasks
+- `task-summary` - Get task summary and insights
+
+**Available MCP Resources:**
+
+- `taskin://tasks` - Access all tasks
 
 ## 📦 Programmatic Usage
 

package/dist/index.js

@@ -38,12 +38,12 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// ../../node_modules/.pnpm/tsup@8.5.0_postcss@8.5.6_tsx@4.20.6_typescript@5.9.3/node_modules/tsup/assets/esm_shims.js
+// ../../node_modules/.pnpm/tsup@8.5.0_postcss@8.5.6_tsx@4.21.0_typescript@5.9.3/node_modules/tsup/assets/esm_shims.js
 import path from "path";
 import { fileURLToPath } from "url";
 var getFilename, getDirname, __dirname;
 var init_esm_shims = __esm({
-  "../../node_modules/.pnpm/tsup@8.5.0_postcss@8.5.6_tsx@4.20.6_typescript@5.9.3/node_modules/tsup/assets/esm_shims.js"() {
+  "../../node_modules/.pnpm/tsup@8.5.0_postcss@8.5.6_tsx@4.21.0_typescript@5.9.3/node_modules/tsup/assets/esm_shims.js"() {
     "use strict";
     getFilename = () => fileURLToPath(import.meta.url);
     getDirname = () => path.dirname(getFilename());
@@ -127,7 +127,9 @@ async function validateTaskFile(filePath) {
       });
     }
     if (hasInlineStatus) {
-      const statusLineIdx = lines.findIndex((line) => /^Status:/i.test(line.trim()));
+      const statusLineIdx = lines.findIndex(
+        (line) => /^Status:/i.test(line.trim())
+      );
       issues.push({
         file: filePath,
         line: statusLineIdx >= 0 ? statusLineIdx + 1 : void 0,
@@ -147,7 +149,9 @@ async function validateTaskFile(filePath) {
       const statusMatch = content.match(/## Status\s*\n\s*([^\n\r]+)/i);
       const statusValue = statusMatch ? statusMatch[1].trim().toLowerCase() : "";
       if (!["todo", "in-progress", "done", "pending"].includes(statusValue)) {
-        const statusLineIdx = lines.findIndex((line) => line.trim() === "## Status");
+        const statusLineIdx = lines.findIndex(
+          (line) => line.trim() === "## Status"
+        );
         issues.push({
           file: filePath,
           line: statusLineIdx >= 0 ? statusLineIdx + 2 : void 0,
@@ -194,9 +198,15 @@ async function validateTaskFile(filePath) {
   return issues;
 }
 function createLintResult(allIssues) {
-  const errorCount = allIssues.filter((issue) => issue.severity === "error").length;
-  const warningCount = allIssues.filter((issue) => issue.severity === "warning").length;
-  const infoCount = allIssues.filter((issue) => issue.severity === "info").length;
+  const errorCount = allIssues.filter(
+    (issue) => issue.severity === "error"
+  ).length;
+  const warningCount = allIssues.filter(
+    (issue) => issue.severity === "warning"
+  ).length;
+  const infoCount = allIssues.filter(
+    (issue) => issue.severity === "info"
+  ).length;
   return {
     valid: errorCount === 0,
     issues: allIssues,
@@ -7105,7 +7115,9 @@ var FileSystemTaskProvider = class {
   }
   async findTask(taskId) {
     const files = await fs.readdir(this.tasksDirectory);
-    const taskFile = files.find((file) => file.startsWith(`task-${taskId}-`) && file.endsWith(".md"));
+    const taskFile = files.find(
+      (file) => file.startsWith(`task-${taskId}-`) && file.endsWith(".md")
+    );
     if (!taskFile) {
       return void 0;
     }
@@ -7120,8 +7132,7 @@ var FileSystemTaskProvider = class {
       for (const n of names) {
         const rx = new RegExp(`##\\s*${n}\\s*\\n\\s*([^\\n\\r]+)`, "i");
         const m = content.match(rx);
-        if (m)
-          return m[1].trim();
+        if (m) return m[1].trim();
       }
       return null;
     };
@@ -7133,7 +7144,9 @@ var FileSystemTaskProvider = class {
       const assigneeValue = assigneeMatch.trim();
       assignee = this.userRegistry.resolveUser(assigneeValue);
       if (!assignee) {
-        console.warn(`[FS Provider] User "${assigneeValue}" not found in registry, creating temporary user`);
+        console.warn(
+          `[FS Provider] User "${assigneeValue}" not found in registry, creating temporary user`
+        );
         assignee = this.userRegistry.createTemporaryUser(assigneeValue);
       }
     }
@@ -7151,7 +7164,9 @@ var FileSystemTaskProvider = class {
   }
   async updateTask(task) {
     const currentContent = await fs.readFile(task.filePath, "utf-8");
-    const hasInlineMetadata = /^(Status|Type|Assignee):\s*.+$/im.test(currentContent);
+    const hasInlineMetadata = /^(Status|Type|Assignee):\s*.+$/im.test(
+      currentContent
+    );
     if (hasInlineMetadata) {
       const { fixTaskFile: fixTaskFile2 } = await Promise.resolve().then(() => (init_task_validator(), task_validator_exports));
       await fixTaskFile2(task.filePath);
@@ -7159,18 +7174,26 @@ var FileSystemTaskProvider = class {
     const content = await fs.readFile(task.filePath, "utf-8");
     let updatedContent;
     if (/##\s*Status/i.test(content)) {
-      updatedContent = content.replace(/(##\s*Status\s*\n\s*)([^\n\r]*)/i, `$1${task.status}`);
+      updatedContent = content.replace(
+        /(##\s*Status\s*\n\s*)([^\n\r]*)/i,
+        `$1${task.status}`
+      );
     } else {
-      updatedContent = content.replace(/(^#.*\n)/, `$1
+      updatedContent = content.replace(
+        /(^#.*\n)/,
+        `$1
 ## Status
 ${task.status}
-`);
+`
+      );
     }
     await fs.writeFile(task.filePath, updatedContent, "utf-8");
   }
   async getAllTasks() {
     const files = await fs.readdir(this.tasksDirectory);
-    const taskFiles = files.filter((file) => file.startsWith("task-") && file.endsWith(".md"));
+    const taskFiles = files.filter(
+      (file) => file.startsWith("task-") && file.endsWith(".md")
+    );
     const tasks = [];
     for (const file of taskFiles) {
       const filePath = path2.join(this.tasksDirectory, file);
@@ -7186,8 +7209,7 @@ ${task.status}
         for (const n of names) {
           const rx = new RegExp(`##\\s*${n}\\s*\\n\\s*([^\\n\\r]+)`, "i");
           const m = content.match(rx);
-          if (m)
-            return m[1].trim();
+          if (m) return m[1].trim();
         }
         return null;
       };
@@ -9027,13 +9049,13 @@ async function listTasks(filter, options) {
   }
   if (options.assignee) {
     filteredTasks = filteredTasks.filter(
-      (t) => t.userId?.toLowerCase().includes(options.assignee.toLowerCase())
+      (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.userId?.toLowerCase().includes(lowerFilter)
+      (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)
     );
   }
   if (filteredTasks.length === 0) {
@@ -9050,7 +9072,7 @@ async function listTasks(filter, options) {
     const statusColor = getStatusColor(task.status);
     const typeColor = getTypeColor(task.type);
     console.log(
-      `${colors2.info(task.id.padEnd(15))} ${statusColor(task.status.padEnd(15))} ${typeColor(task.type.padEnd(12))} ${colors2.secondary((task.userId || "unknown").padEnd(15))} ${colors2.normal(task.title)}`
+      `${colors2.info(task.id.padEnd(15))} ${statusColor(task.status.padEnd(15))} ${typeColor(task.type.padEnd(12))} ${colors2.secondary((task.assignee?.name || "unassigned").padEnd(15))} ${colors2.normal(task.title)}`
     );
   });
   console.log();
@@ -11712,6 +11734,24 @@ function showCustomHelp() {
         "taskin lint -p /path/to/tasks"
       ],
       icon: "\u{1F50D}"
+    },
+    {
+      name: colors2.highlight("taskin dashboard") + colors2.normal(" [options]"),
+      alias: colors2.secondary("Options: --host, --port"),
+      description: "Start the web dashboard",
+      examples: [
+        "taskin dashboard",
+        "taskin dashboard --port 3000",
+        "taskin dashboard --host 0.0.0.0"
+      ],
+      icon: "\u{1F4CA}"
+    },
+    {
+      name: colors2.highlight("taskin mcp-server"),
+      alias: colors2.secondary("Alias: mcp"),
+      description: "Start MCP server for Claude Desktop integration",
+      examples: ["taskin mcp-server", "taskin mcp"],
+      icon: "\u{1F916}"
     }
   ];
   commands.forEach((cmd, index) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taskin",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "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",
@@ -87,10 +87,10 @@
     "vitest": "^1.6.1",
     "@opentask/taskin-fs-provider": "1.0.5",
     "@opentask/taskin-task-manager": "1.0.5",
-    "@opentask/taskin-task-server-mcp": "0.1.0",
-    "@opentask/taskin-types": "1.0.5",
+    "@opentask/taskin-task-server-ws": "0.1.0",
     "@opentask/taskin-utils": "1.0.5",
-    "@opentask/taskin-task-server-ws": "0.1.0"
+    "@opentask/taskin-task-server-mcp": "0.1.0",
+    "@opentask/taskin-types": "1.0.5"
   },
   "scripts": {
     "build": "pnpm run build:dashboard && tsup",