taskin 1.0.10 → 1.0.12

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
 

package/dist/index.js

@@ -51,6 +51,48 @@ var init_esm_shims = __esm({
   }
 });
 
+// ../fs-task-provider/dist/i18n.js
+function getI18n(locale = "en-US") {
+  return i18nConfig[locale];
+}
+function detectLocale(content) {
+  if (content.includes("## Descri\xE7\xE3o") || content.includes("## Tipo") || content.includes("## Respons\xE1vel") || content.includes("## Tarefas")) {
+    return "pt-BR";
+  }
+  return "en-US";
+}
+var i18nConfig;
+var init_i18n = __esm({
+  "../fs-task-provider/dist/i18n.js"() {
+    "use strict";
+    init_esm_shims();
+    i18nConfig = {
+      "en-US": {
+        status: "Status",
+        type: "Type",
+        assignee: "Assignee",
+        description: "Description",
+        tasks: "Tasks",
+        notes: "Notes",
+        defaultAssignee: "To be defined",
+        descriptionPlaceholder: "Add task description here...",
+        notesPlaceholder: "Add any relevant notes or links here."
+      },
+      "pt-BR": {
+        status: "Status",
+        type: "Tipo",
+        assignee: "Respons\xE1vel",
+        description: "Descri\xE7\xE3o",
+        tasks: "Tarefas",
+        notes: "Notas",
+        defaultAssignee: "A definir",
+        descriptionPlaceholder: "Adicione a descri\xE7\xE3o da tarefa aqui...",
+        notesPlaceholder: "Adicione notas ou links relevantes aqui."
+      }
+    };
+  }
+});
+
 // ../fs-task-provider/dist/task-validator.js
 var task_validator_exports = {};
 __export(task_validator_exports, {
@@ -62,47 +104,79 @@ import { readFile, writeFile } from "fs/promises";
 async function fixTaskFile(filePath) {
   try {
     const content = await readFile(filePath, "utf-8");
-    const hasInlineStatus = /^Status:\s*.+$/im.test(content);
-    const hasInlineType = /^Type:\s*.+$/im.test(content);
-    const hasInlineAssignee = /^Assignee:\s*.+$/im.test(content);
-    if (!hasInlineStatus && !hasInlineType && !hasInlineAssignee) {
+    const locale = detectLocale(content);
+    const i18n = getI18n(locale);
+    const statusPattern = new RegExp(`##\\s*(?:Status|${i18n.status})\\s*\\n\\s*([^\\n\\r]+)`, "i");
+    const typePattern = new RegExp(`##\\s*(?:Type|${i18n.type})\\s*\\n\\s*([^\\n\\r]+)`, "i");
+    const assigneePattern = new RegExp(`##\\s*(?:Assignee|${i18n.assignee})\\s*\\n\\s*([^\\n\\r]+)`, "i");
+    const hasSectionStatus = statusPattern.test(content);
+    const hasSectionType = typePattern.test(content);
+    const hasSectionAssignee = assigneePattern.test(content);
+    const inlineStatusPattern = /^(Status|Tipo):\s*(.+?)(\s*)$/im;
+    const inlineTypePattern = /^(Type|Tipo):\s*(.+?)(\s*)$/im;
+    const inlineAssigneePattern = /^(Assignee|Responsável):\s*(.+?)(\s*)$/im;
+    const hasInlineStatus = inlineStatusPattern.test(content);
+    const hasInlineType = inlineTypePattern.test(content);
+    const hasInlineAssignee = inlineAssigneePattern.test(content);
+    const needsSpaceFix = hasInlineStatus && !/^(?:Status|Tipo):.+  $/im.test(content) || hasInlineType && !/^(?:Type|Tipo):.+  $/im.test(content) || hasInlineAssignee && !/^(?:Assignee|Responsável):.+  $/im.test(content);
+    if (!hasSectionStatus && !hasSectionType && !hasSectionAssignee && !needsSpaceFix) {
       return false;
     }
-    const statusMatch = content.match(/^Status:\s*(.+)$/im);
-    const typeMatch = content.match(/^Type:\s*(.+)$/im);
-    const assigneeMatch = content.match(/^Assignee:\s*(.+)$/im);
     let newContent = content;
-    if (statusMatch) {
-      newContent = newContent.replace(/^Status:\s*.+$/im, "");
-    }
-    if (typeMatch) {
-      newContent = newContent.replace(/^Type:\s*.+$/im, "");
-    }
-    if (assigneeMatch) {
-      newContent = newContent.replace(/^Assignee:\s*.+$/im, "");
-    }
-    newContent = newContent.replace(/\n{3,}/g, "\n\n");
-    const titleLineIdx = newContent.split("\n").findIndex((line) => line.trim().startsWith("# "));
-    if (titleLineIdx === -1) {
-      return false;
-    }
-    const contentLines = newContent.split("\n");
-    const beforeTitle = contentLines.slice(0, titleLineIdx + 1);
-    const afterTitle = contentLines.slice(titleLineIdx + 1);
-    const sections = [];
-    if (statusMatch) {
-      sections.push("", "## Status", "", statusMatch[1].trim());
-    }
-    if (typeMatch) {
-      sections.push("", "## Type", "", typeMatch[1].trim());
-    }
-    if (assigneeMatch) {
-      sections.push("", "## Assignee", "", assigneeMatch[1].trim());
+    let wasModified = false;
+    if (hasSectionStatus || hasSectionType || hasSectionAssignee) {
+      const statusMatch = content.match(statusPattern);
+      const typeMatch = content.match(typePattern);
+      const assigneeMatch = content.match(assigneePattern);
+      if (statusMatch) {
+        newContent = newContent.replace(statusPattern, "");
+      }
+      if (typeMatch) {
+        newContent = newContent.replace(typePattern, "");
+      }
+      if (assigneeMatch) {
+        newContent = newContent.replace(assigneePattern, "");
+      }
+      newContent = newContent.replace(/\n{3,}/g, "\n\n");
+      const titleLineIdx = newContent.split("\n").findIndex((line) => line.trim().startsWith("# "));
+      if (titleLineIdx === -1) {
+        return false;
+      }
+      const contentLines = newContent.split("\n");
+      const beforeTitle = contentLines.slice(0, titleLineIdx + 1);
+      const afterTitle = contentLines.slice(titleLineIdx + 1);
+      const inlineMetadata = [];
+      if (statusMatch) {
+        inlineMetadata.push(`Status: ${statusMatch[1].trim()}  `);
+      }
+      if (typeMatch) {
+        inlineMetadata.push(`Type: ${typeMatch[1].trim()}  `);
+      }
+      if (assigneeMatch) {
+        inlineMetadata.push(`Assignee: ${assigneeMatch[1].trim()}  `);
+      }
+      newContent = [
+        ...beforeTitle,
+        "",
+        ...inlineMetadata,
+        "",
+        ...afterTitle
+      ].join("\n");
+      wasModified = true;
+    }
+    if (needsSpaceFix) {
+      newContent = newContent.replace(/^(# .+)\n([^#\n])/m, "$1\n\n$2");
+      newContent = newContent.replace(/^(Status|Tipo):\s*(.+?)(\s*)$/im, (_, key, value) => `${key}: ${value.trim()}  `);
+      newContent = newContent.replace(/^(Type|Tipo):\s*(.+?)(\s*)$/im, (_, key, value) => `${key}: ${value.trim()}  `);
+      newContent = newContent.replace(/^(Assignee|Responsável):\s*(.+?)(\s*)$/im, (_, key, value) => `${key}: ${value.trim()}  `);
+      wasModified = true;
+    }
+    if (wasModified) {
+      const finalContent = newContent.replace(/\n{3,}/g, "\n\n").trim() + "\n";
+      await writeFile(filePath, finalContent, "utf-8");
+      return true;
     }
-    const fixed = [...beforeTitle, ...sections, "", ...afterTitle].join("\n");
-    const finalContent = fixed.replace(/\n{3,}/g, "\n\n").trim() + "\n";
-    await writeFile(filePath, finalContent, "utf-8");
-    return true;
+    return false;
   } catch (error2) {
     console.error(`Failed to fix ${filePath}:`, error2);
     return false;
@@ -113,9 +187,13 @@ async function validateTaskFile(filePath) {
   try {
     const content = await readFile(filePath, "utf-8");
     const lines = content.split("\n");
+    const locale = detectLocale(content);
+    const i18n = getI18n(locale);
     const hasTitleSection = lines.some((line) => line.trim().startsWith("# "));
-    const hasStatusSection = content.includes("## Status");
-    const hasInlineStatus = /^Status:\s*.+$/im.test(content);
+    const inlineStatusPattern = new RegExp(`^(?:Status|${i18n.status}):\\s*.+$`, "im");
+    const sectionStatusPattern = new RegExp(`##\\s*(?:Status|${i18n.status})`, "i");
+    const hasInlineStatus = inlineStatusPattern.test(content);
+    const hasSectionStatus = sectionStatusPattern.test(content);
     const hasDescriptionSection = content.includes("## Description") || content.includes("## Descri\xE7\xE3o");
     if (!hasTitleSection) {
       issues.push({
@@ -126,34 +204,43 @@ async function validateTaskFile(filePath) {
         suggestion: "Add a level-1 heading at the start: # Your Task Title"
       });
     }
-    if (hasInlineStatus) {
-      const statusLineIdx = lines.findIndex((line) => /^Status:/i.test(line.trim()));
+    if (hasSectionStatus) {
+      const statusLineIdx = lines.findIndex((line) => sectionStatusPattern.test(line.trim()));
       issues.push({
         file: filePath,
         line: statusLineIdx >= 0 ? statusLineIdx + 1 : void 0,
-        message: 'Inline metadata ("Status: ...") is not allowed. Use a "## Status" section instead.',
+        message: 'Section-based metadata ("## Status") is not allowed. Use inline format instead.',
         severity: "error",
-        suggestion: "Replace inline metadata with a section:\n## Status\n<todo|in-progress|done>"
+        suggestion: `Replace section with inline metadata:
+${i18n.status}: <todo|in-progress|done>`
       });
     }
-    if (!hasStatusSection) {
+    if (!hasInlineStatus) {
       issues.push({
         file: filePath,
-        message: "Task file must have a ## Status section",
+        message: "Task file must have a Status field",
         severity: "error",
-        suggestion: "Add a section:\n## Status\n<todo|in-progress|done>"
+        suggestion: `Add inline metadata after title:
+${i18n.status}: <todo|in-progress|done>`
       });
     } else {
-      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 statusMatch = content.match(inlineStatusPattern);
+      const statusValue = statusMatch ? statusMatch[0].split(":")[1]?.trim().toLowerCase() || "" : "";
+      if (![
+        "todo",
+        "in-progress",
+        "done",
+        "pending",
+        "blocked",
+        "canceled"
+      ].includes(statusValue)) {
+        const statusLineIdx = lines.findIndex((line) => inlineStatusPattern.test(line.trim()));
         issues.push({
           file: filePath,
-          line: statusLineIdx >= 0 ? statusLineIdx + 2 : void 0,
-          message: "Status must be one of: todo, in-progress, done, pending",
+          line: statusLineIdx >= 0 ? statusLineIdx + 1 : void 0,
+          message: "Status must be one of: todo, in-progress, done, pending, blocked, canceled",
           severity: "error",
-          suggestion: "Set status to: todo, in-progress, done, or pending"
+          suggestion: "Set status to: todo, in-progress, done, pending, blocked, or canceled"
         });
       }
     }
@@ -209,6 +296,7 @@ var init_task_validator = __esm({
   "../fs-task-provider/dist/task-validator.js"() {
     "use strict";
     init_esm_shims();
+    init_i18n();
   }
 });
 
@@ -7053,47 +7141,10 @@ init_esm_shims();
 
 // ../fs-task-provider/dist/fs-task-provider.js
 init_esm_shims();
+init_i18n();
+init_task_validator();
 import { promises as fs } from "fs";
 import path2 from "path";
-
-// ../fs-task-provider/dist/i18n.js
-init_esm_shims();
-var i18nConfig = {
-  "en-US": {
-    status: "Status",
-    type: "Type",
-    assignee: "Assignee",
-    description: "Description",
-    tasks: "Tasks",
-    notes: "Notes",
-    defaultAssignee: "To be defined",
-    descriptionPlaceholder: "Add task description here...",
-    notesPlaceholder: "Add any relevant notes or links here."
-  },
-  "pt-BR": {
-    status: "Status",
-    type: "Tipo",
-    assignee: "Respons\xE1vel",
-    description: "Descri\xE7\xE3o",
-    tasks: "Tarefas",
-    notes: "Notas",
-    defaultAssignee: "A definir",
-    descriptionPlaceholder: "Adicione a descri\xE7\xE3o da tarefa aqui...",
-    notesPlaceholder: "Adicione notas ou links relevantes aqui."
-  }
-};
-function getI18n(locale = "en-US") {
-  return i18nConfig[locale];
-}
-function detectLocale(content) {
-  if (content.includes("## Descri\xE7\xE3o") || content.includes("## Tipo") || content.includes("## Respons\xE1vel") || content.includes("## Tarefas")) {
-    return "pt-BR";
-  }
-  return "en-US";
-}
-
-// ../fs-task-provider/dist/fs-task-provider.js
-init_task_validator();
 var FileSystemTaskProvider = class {
   tasksDirectory;
   userRegistry;
@@ -7115,19 +7166,20 @@ var FileSystemTaskProvider = class {
     const title = titleMatch ? titleMatch[1].trim() : "Untitled";
     const contentLocale = detectLocale(content);
     const i18n = getI18n(contentLocale);
-    const extractSection = (name, localizedName) => {
+    const extractInline = (name, localizedName) => {
       const names = localizedName && localizedName !== name ? [localizedName, name] : [name];
       for (const n of names) {
-        const rx = new RegExp(`##\\s*${n}\\s*\\n\\s*([^\\n\\r]+)`, "i");
+        const escapedName = n.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        const rx = new RegExp(`^${escapedName}:\\s*(.+)$`, "im");
         const m = content.match(rx);
         if (m)
           return m[1].trim();
       }
       return null;
     };
-    const statusMatch = extractSection("Status", i18n.status);
-    const typeMatch = extractSection("Type", i18n.type);
-    const assigneeMatch = extractSection("Assignee", i18n.assignee);
+    const statusMatch = extractInline("Status", i18n.status);
+    const typeMatch = extractInline("Type", i18n.type);
+    const assigneeMatch = extractInline("Assignee", i18n.assignee);
     let assignee;
     if (assigneeMatch) {
       const assigneeValue = assigneeMatch.trim();
@@ -7151,19 +7203,17 @@ var FileSystemTaskProvider = class {
   }
   async updateTask(task) {
     const currentContent = await fs.readFile(task.filePath, "utf-8");
-    const hasInlineMetadata = /^(Status|Type|Assignee):\s*.+$/im.test(currentContent);
-    if (hasInlineMetadata) {
+    const hasSectionMetadata = /##\s*(Status|Type|Assignee)/i.test(currentContent);
+    if (hasSectionMetadata) {
       const { fixTaskFile: fixTaskFile2 } = await Promise.resolve().then(() => (init_task_validator(), task_validator_exports));
       await fixTaskFile2(task.filePath);
     }
     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}`);
+    if (/^Status:\s*.+$/im.test(content)) {
+      updatedContent = content.replace(/^Status:\s*.+$/im, `Status: ${task.status}  `);
     } else {
-      updatedContent = content.replace(/(^#.*\n)/, `$1
-## Status
-${task.status}
+      updatedContent = content.replace(/(^#.*\n)/, `$1Status: ${task.status}  
 `);
     }
     await fs.writeFile(task.filePath, updatedContent, "utf-8");
@@ -7181,19 +7231,20 @@ ${task.status}
       const title = titleMatch ? titleMatch[1].trim() : "Untitled";
       const contentLocale = detectLocale(content);
       const i18n = getI18n(contentLocale);
-      const extractSection = (name, localizedName) => {
+      const extractInline = (name, localizedName) => {
         const names = localizedName && localizedName !== name ? [localizedName, name] : [name];
         for (const n of names) {
-          const rx = new RegExp(`##\\s*${n}\\s*\\n\\s*([^\\n\\r]+)`, "i");
+          const escapedName = n.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+          const rx = new RegExp(`^${escapedName}:\\s*(.+)$`, "im");
           const m = content.match(rx);
           if (m)
             return m[1].trim();
         }
         return null;
       };
-      const statusMatch = extractSection("Status", i18n.status);
-      const typeMatch = extractSection("Type", i18n.type);
-      const assigneeMatch = extractSection("Assignee", i18n.assignee);
+      const statusMatch = extractInline("Status", i18n.status);
+      const typeMatch = extractInline("Type", i18n.type);
+      const assigneeMatch = extractInline("Assignee", i18n.assignee);
       let assignee;
       if (assigneeMatch) {
         const assigneeValue = assigneeMatch.trim();
@@ -7217,8 +7268,13 @@ ${task.status}
     return tasks;
   }
   async createTask(options) {
-    const i18n = getI18n(this.locale);
     const allTasks = await this.getAllTasks();
+    let detectedLocale = this.locale;
+    if (allTasks.length > 0) {
+      const lastTask = allTasks[allTasks.length - 1];
+      detectedLocale = detectLocale(lastTask.content);
+    }
+    const i18n = getI18n(detectedLocale);
     const taskNumbers = allTasks.map((task2) => {
       const match = task2.id.match(/^(\d+)$/);
       return match ? parseInt(match[1], 10) : 0;
@@ -7262,30 +7318,19 @@ ${task.status}
     const { id, title, type, description, assignee, i18n } = data;
     return `# \u{1F9E9} Task ${id} \u2014 ${title}
 
-## ${i18n.status}
-
-pending
-
-## ${i18n.type}
-
-${type}
-
-## ${i18n.assignee}
-
-${assignee}
+${i18n.status}: pending
+${i18n.type}: ${type}
+${i18n.assignee}: ${assignee}
 
 ## ${i18n.description}
-
 ${description || i18n.descriptionPlaceholder}
 
 ## ${i18n.tasks}
-
 - [ ] Task 1
 - [ ] Task 2
 - [ ] Task 3
 
 ## ${i18n.notes}
-
 ${i18n.notesPlaceholder}
 `;
   }
@@ -7313,6 +7358,9 @@ ${i18n.notesPlaceholder}
   }
 };
 
+// ../fs-task-provider/dist/index.js
+init_i18n();
+
 // ../fs-task-provider/dist/user-registry.js
 init_esm_shims();
 import { promises as fs2 } from "fs";
@@ -7339,7 +7387,9 @@ var UserRegistry = class {
       console.log(`[UserRegistry] Loaded ${this.users.size} users`);
     } catch (error2) {
       if (error2.code === "ENOENT") {
-        console.warn("[UserRegistry] users.json not found, starting with empty registry");
+        console.warn(
+          "[UserRegistry] users.json not found, starting with empty registry"
+        );
         this.users.clear();
       } else {
         throw error2;
@@ -7358,12 +7408,10 @@ var UserRegistry = class {
    */
   resolveUser(nameOrId) {
     const byId = this.users.get(nameOrId);
-    if (byId)
-      return byId;
+    if (byId) return byId;
     const slug = nameOrId.toLowerCase().replace(/\s+/g, "-");
     const bySlug = this.users.get(slug);
-    if (bySlug)
-      return bySlug;
+    if (bySlug) return bySlug;
     for (const user of this.users.values()) {
       if (user.name.toLowerCase() === nameOrId.toLowerCase()) {
         return user;
@@ -7403,7 +7451,11 @@ var UserRegistry = class {
     const data = {
       users: Object.fromEntries(this.users.entries())
     };
-    await fs2.writeFile(this.usersFilePath, JSON.stringify(data, null, 2), "utf-8");
+    await fs2.writeFile(
+      this.usersFilePath,
+      JSON.stringify(data, null, 2),
+      "utf-8"
+    );
   }
 };
 
@@ -7808,38 +7860,41 @@ init_esm_shims();
 // ../utils/dist/security.js
 init_esm_shims();
 import { z } from "zod";
-var HostSchema = z.string().refine((host) => {
-  if (!host || host.length === 0)
-    return false;
-  if (host === "localhost")
-    return true;
-  const parts = host.split(".");
-  const allNumeric = parts.every((p) => /^\d+$/.test(p));
-  if (allNumeric) {
-    if (parts.length !== 4)
-      return false;
-    return parts.every((part) => {
-      const num = parseInt(part, 10);
-      return !isNaN(num) && num >= 0 && num <= 255 && part === num.toString();
-    });
+var HostSchema = z.string().refine(
+  (host) => {
+    if (!host || host.length === 0) return false;
+    if (host === "localhost") return true;
+    const parts = host.split(".");
+    const allNumeric = parts.every((p) => /^\d+$/.test(p));
+    if (allNumeric) {
+      if (parts.length !== 4) return false;
+      return parts.every((part) => {
+        const num = parseInt(part, 10);
+        return !isNaN(num) && num >= 0 && num <= 255 && part === num.toString();
+      });
+    }
+    const hostnameRegex = /^[a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(\.[a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;
+    return hostnameRegex.test(host);
+  },
+  {
+    message: "Invalid host. Must be localhost, a valid IPv4 address, or hostname."
   }
-  const hostnameRegex = /^[a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(\.[a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;
-  return hostnameRegex.test(host);
-}, {
-  message: "Invalid host. Must be localhost, a valid IPv4 address, or hostname."
-});
+);
 var PortSchema = z.union([
   z.number().int().min(1).max(65535),
   z.string().regex(/^\d+$/).transform((val) => parseInt(val, 10)).pipe(z.number().int().min(1).max(65535))
 ]);
-var WebSocketUrlSchema = z.string().refine((url) => {
-  try {
-    const parsed = new URL(url);
-    return parsed.protocol === "ws:" || parsed.protocol === "wss:";
-  } catch {
-    return false;
-  }
-}, { message: "Invalid WebSocket URL. Must use ws:// or wss:// protocol." });
+var WebSocketUrlSchema = z.string().refine(
+  (url) => {
+    try {
+      const parsed = new URL(url);
+      return parsed.protocol === "ws:" || parsed.protocol === "wss:";
+    } catch {
+      return false;
+    }
+  },
+  { message: "Invalid WebSocket URL. Must use ws:// or wss:// protocol." }
+);
 var TaskIdSchema = z.string().min(1).max(100).regex(/^[a-zA-Z0-9_-]+$/, {
   message: "Task ID must contain only alphanumeric characters, hyphens, and underscores."
 });
@@ -7847,23 +7902,25 @@ var UserIdSchema = z.string().min(1).max(100).regex(/^[a-zA-Z0-9._-]+$/, {
   message: "User ID must contain only alphanumeric characters, dots, hyphens, and underscores."
 });
 var EmailSchema = z.string().email().max(254);
-var SafePathSchema = z.string().refine((filePath) => {
-  if (!filePath || filePath.length === 0)
-    return false;
-  const dangerousPatterns = [
-    /\.\./,
-    // Parent directory (..)
-    /~\//,
-    // Home directory
-    /^\//,
-    // Absolute path
-    /^[A-Za-z]:\\/
-    // Windows absolute path
-  ];
-  return !dangerousPatterns.some((pattern) => pattern.test(filePath));
-}, {
-  message: "Invalid path. Must be a relative path without traversal patterns."
-});
+var SafePathSchema = z.string().refine(
+  (filePath) => {
+    if (!filePath || filePath.length === 0) return false;
+    const dangerousPatterns = [
+      /\.\./,
+      // Parent directory (..)
+      /~\//,
+      // Home directory
+      /^\//,
+      // Absolute path
+      /^[A-Za-z]:\\/
+      // Windows absolute path
+    ];
+    return !dangerousPatterns.some((pattern) => pattern.test(filePath));
+  },
+  {
+    message: "Invalid path. Must be a relative path without traversal patterns."
+  }
+);
 var DashboardOptionsSchema = z.object({
   host: HostSchema.optional(),
   port: PortSchema.optional(),
@@ -8640,8 +8697,15 @@ async function setupFileSystemProvider(cwd) {
     info(`${colors2.highlight("TASKS/")} directory already exists`);
     success("\u2713 Directory is ready to use");
   }
-  const sampleTaskFile = join(tasksDir, "task-001-setup-project.md");
-  if (!existsSync4(sampleTaskFile)) {
+  const fs3 = __require("fs");
+  const existingTask001 = fs3.readdirSync(tasksDir).find(
+    (file) => file.startsWith("task-001-") && file.endsWith(".md")
+  );
+  if (existingTask001) {
+    info(`Sample task already exists: ${colors2.highlight(existingTask001)}`);
+    info("Skipping sample task creation (users already know the pattern)");
+  } else {
+    const sampleTaskFile = join(tasksDir, "task-001-setup-project.md");
     info("Creating sample task...");
     const sampleTask = `# Task 001 \u2014 Setup Project
 
@@ -8675,303 +8739,59 @@ You can edit or delete this file. Use \`taskin list\` to see all tasks.
 
 // src/commands/lint.ts
 init_esm_shims();
-import { join as join3 } from "path";
-
-// src/lib/file-system-task-linter/index.ts
-init_esm_shims();
-
-// src/lib/file-system-task-linter/file-system-task-linter.ts
-init_esm_shims();
 import chalk4 from "chalk";
-import { readdir, readFile as readFile2 } from "fs/promises";
 import { join as join2 } from "path";
-var VALID_STATUSES = ["pending", "in-progress", "done", "blocked"];
-var VALID_TYPES = ["feat", "fix", "chore", "docs", "refactor", "test"];
-var FileSystemTaskLinter = class {
-  errors = [];
-  addError(file, message, severity = "error", line) {
-    this.errors.push({ file, message, severity, line });
-  }
-  /**
-   * Validate task file name format (FileSystem-specific)
-   */
-  validateFileName(fileName) {
-    const pattern = /^task-\d{2,3}-[a-z0-9-]+\.md$/;
-    if (!pattern.test(fileName)) {
-      return {
-        file: fileName,
-        message: "Invalid filename. Expected: task-NNN-kebab-case-title.md",
-        severity: "error"
-      };
+var lintCommand = defineCommand({
+  name: "lint",
+  description: "\u{1F50D} Validate task markdown files",
+  options: [
+    {
+      flags: "-p, --path <directory>",
+      description: "Path to TASKS directory",
+      defaultValue: "TASKS"
+    },
+    {
+      flags: "-f, --fix",
+      description: "Automatically fix task file format issues"
     }
-    return null;
+  ],
+  handler: async (options) => {
+    await executeLint(options);
   }
-  extractMetadata(content) {
-    const headerSection = content.split(/^##/m)[0];
-    const statusMatch = headerSection.match(/^Status:\s*(.+)$/im);
-    const typeMatch = headerSection.match(/^Type:\s*(.+)$/im);
-    const assigneeMatch = headerSection.match(/^Assignee:\s*(.+)$/im);
-    return {
-      status: statusMatch?.[1]?.trim().toLowerCase(),
-      type: typeMatch?.[1]?.trim().toLowerCase(),
-      assignee: assigneeMatch?.[1]?.trim()
-    };
+});
+async function executeLint(options) {
+  const tasksDir = options.path || join2(process.cwd(), "TASKS");
+  if (options.fix) {
+    console.log(`\u{1F527} Fixing task files in: ${tasksDir}
+`);
+  } else {
+    console.log(`\u{1F4CB} Linting task files in: ${tasksDir}
+`);
   }
-  /**
-   * Validate task metadata (FileSystem-specific)
-   */
-  validateMetadata(metadata, filePath) {
-    const errors = [];
-    if (!metadata.status) {
-      errors.push({
-        file: filePath,
-        message: "Missing required metadata: Status",
-        severity: "error"
-      });
-    } else if (!VALID_STATUSES.includes(metadata.status)) {
-      errors.push({
-        file: filePath,
-        message: `Invalid status "${metadata.status}". Valid: ${VALID_STATUSES.join(", ")}`,
-        severity: "error"
-      });
-    }
-    if (!metadata.type) {
-      errors.push({
-        file: filePath,
-        message: "Missing required metadata: Type",
-        severity: "error"
-      });
-    } else if (!VALID_TYPES.includes(metadata.type)) {
-      errors.push({
-        file: filePath,
-        message: `Invalid type "${metadata.type}". Valid: ${VALID_TYPES.join(", ")}`,
-        severity: "error"
-      });
-    }
-    if (!metadata.assignee) {
-      errors.push({
-        file: filePath,
-        message: "Missing recommended metadata: Assignee",
-        severity: "warning"
-      });
+  const userRegistry = new UserRegistry({
+    taskinDir: join2(process.cwd(), ".taskin")
+  });
+  await userRegistry.load();
+  const provider = new FileSystemTaskProvider(tasksDir, userRegistry);
+  const result = await provider.lint(options.fix);
+  if (result.valid) {
+    console.log(chalk4.green(`\u2705 All task files are valid!
+`));
+  } else {
+    console.log(chalk4.red(`
+\u274C Found ${result.issues.length} issue(s):
+`));
+    for (const issue of result.issues) {
+      console.log(chalk4.yellow(`  ${issue.file}: ${issue.message}`));
     }
-    return errors;
+    console.log();
   }
-  validateContent(filename, content) {
-    const lines = content.split("\n");
-    if (!lines[0]?.trim().startsWith("# ")) {
-      this.addError(
-        filename,
-        "Task file must start with a level 1 heading (# Task NNN \u2014 Title)",
-        "error",
-        1
-      );
-    }
-    const h1Pattern = /^#\s+(?:🧩\s+)?Task\s+\d{2,3}\s+[—-]\s+.+$/i;
-    if (lines[0] && !h1Pattern.test(lines[0])) {
-      this.addError(
-        filename,
-        'H1 heading must follow format: "# Task NNN \u2014 Title"',
-        "error",
-        1
-      );
-    }
-    const metadata = this.extractMetadata(content);
-    const metadataErrors = this.validateMetadata(metadata, filename);
-    metadataErrors.forEach((error2) => {
-      this.addError(error2.file, error2.message, error2.severity, error2.line);
-    });
-    const h2Sections = content.match(/^##\s+.+$/gm);
-    if (!h2Sections || h2Sections.length === 0) {
-      this.addError(
-        filename,
-        "Task should have at least one section (## heading)",
-        "warning"
-      );
-    }
-    const firstH2Index = content.indexOf("\n##");
-    if (firstH2Index > -1) {
-      const afterH2 = content.substring(firstH2Index);
-      if (afterH2.match(/^Status:/im) || afterH2.match(/^Type:/im) || afterH2.match(/^Assignee:/im)) {
-        this.addError(
-          filename,
-          "Metadata must be placed BEFORE the first ## section",
-          "error"
-        );
-      }
-    }
-  }
-  /**
-   * Lint a single task file (FileSystem-specific)
-   */
-  async lintFile(filePath) {
-    const errors = [];
-    const fileName = filePath.split("/").pop() || filePath;
-    const fileNameError = this.validateFileName(fileName);
-    if (fileNameError) {
-      errors.push(fileNameError);
-    }
-    try {
-      const content = await readFile2(filePath, "utf-8");
-      this.errors = [];
-      this.validateContent(fileName, content);
-      errors.push(...this.errors);
-    } catch (error2) {
-      errors.push({
-        file: fileName,
-        message: `Failed to read file: ${error2}`,
-        severity: "error"
-      });
-    }
-    return errors;
-  }
-  /**
-   * Lint all task files in the specified directory (FileSystem-specific)
-   */
-  async lintDirectory(tasksDir) {
-    this.errors = [];
-    try {
-      const files = await readdir(tasksDir);
-      const taskFiles = files.filter((f) => f.endsWith(".md"));
-      for (const file of taskFiles) {
-        const fileNameError = this.validateFileName(file);
-        if (fileNameError) {
-          this.addError(file, fileNameError.message, fileNameError.severity);
-        }
-        const content = await readFile2(join2(tasksDir, file), "utf-8");
-        this.validateContent(file, content);
-      }
-      const errors = this.errors.filter((e) => e.severity === "error");
-      const warnings = this.errors.filter((e) => e.severity === "warning");
-      return {
-        errors,
-        warnings,
-        filesChecked: taskFiles.length,
-        valid: errors.length === 0
-      };
-    } catch (error2) {
-      throw new Error(`Failed to lint tasks: ${error2}`);
-    }
-  }
-  static printResults(result) {
-    if (result.errors.length === 0 && result.warnings.length === 0) {
-      console.log(
-        chalk4.green(`\u2705 All ${result.filesChecked} task files are valid!
-`)
-      );
-      return;
-    }
-    console.log(
-      chalk4.bold(
-        `
-\u{1F4CA} Validation Results (${result.filesChecked} files checked):
-`
-      )
-    );
-    const errorsByFile = /* @__PURE__ */ new Map();
-    [...result.errors, ...result.warnings].forEach((error2) => {
-      if (!errorsByFile.has(error2.file)) {
-        errorsByFile.set(error2.file, []);
-      }
-      errorsByFile.get(error2.file).push(error2);
-    });
-    for (const [file, fileErrors] of errorsByFile) {
-      console.log(chalk4.cyan(`
-\u{1F4C4} ${file}`));
-      for (const error2 of fileErrors) {
-        const icon = error2.severity === "error" ? chalk4.red("\u274C") : chalk4.yellow("\u26A0\uFE0F");
-        const location = error2.line ? `:${error2.line}` : "";
-        console.log(`  ${icon} ${error2.message}${location}`);
-      }
-    }
-    console.log("\n" + "\u2500".repeat(60));
-    console.log(
-      chalk4.bold(
-        `
-\u{1F4CA} Summary: ${chalk4.red(result.errors.length + " error(s)")}, ${chalk4.yellow(result.warnings.length + " warning(s)")}
-`
-      )
-    );
-  }
-};
-
-// src/lib/file-system-task-linter/file-system-task-linter.mock.ts
-init_esm_shims();
-function createMockFileValidationError(overrides) {
-  return {
-    file: "task-001.md",
-    message: "Mock validation error",
-    severity: "error",
-    ...overrides
-  };
-}
-var MOCK_INVALID_LINT_RESULT = {
-  errors: [
-    createMockFileValidationError({
-      file: "task-001.md",
-      message: 'Invalid status: "invalid"'
-    }),
-    createMockFileValidationError({
-      file: "task-002.md",
-      message: 'Invalid type: "unknown"'
-    })
-  ],
-  filesChecked: 2,
-  valid: false,
-  warnings: []
-};
-var MOCK_WARNINGS_LINT_RESULT = {
-  errors: [],
-  filesChecked: 3,
-  valid: true,
-  warnings: [
-    createMockFileValidationError({
-      file: "task-003.md",
-      message: "Consider adding assignee",
-      severity: "warning"
-    })
-  ]
-};
-var MOCK_VALIDATION_ERRORS = [
-  createMockFileValidationError({
-    file: "task-001.md",
-    message: "Invalid status: must be one of [pending, in-progress, done, blocked]",
-    line: 5
-  }),
-  createMockFileValidationError({
-    file: "task-001.md",
-    message: "Invalid type: must be one of [feat, fix, chore, docs, refactor, test]",
-    line: 6
-  })
-];
-
-// src/lib/file-system-task-linter/file-system-task-linter.types.ts
-init_esm_shims();
-
-// src/commands/lint.ts
-var lintCommand = defineCommand({
-  name: "lint",
-  description: "\u{1F50D} Validate task markdown files",
-  options: [
-    {
-      flags: "-p, --path <directory>",
-      description: "Path to TASKS directory",
-      defaultValue: "TASKS"
-    }
-  ],
-  handler: async (options) => {
-    await executeLint(options);
-  }
-});
-async function executeLint(options) {
-  const tasksDir = options.path || join3(process.cwd(), "TASKS");
-  console.log(`\u{1F4CB} Linting task files in: ${tasksDir}
-`);
-  const linter = new FileSystemTaskLinter();
-  const result = await linter.lintDirectory(tasksDir);
-  FileSystemTaskLinter.printResults(result);
-  if (!result.valid) {
-    process.exit(1);
+  if (!result.valid && !options.fix) {
+    console.log(
+      chalk4.blue(`\u{1F4A1} Run with --fix to automatically fix format issues
+`)
+    );
+    process.exit(1);
   }
 }
 
@@ -11774,13 +11594,13 @@ function showCustomHelp() {
 // src/version.ts
 init_esm_shims();
 import { readFileSync } from "fs";
-import { dirname, join as join4 } from "path";
+import { dirname, join as join3 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 var __filename3 = fileURLToPath3(import.meta.url);
 var __dirname3 = dirname(__filename3);
 function getVersion() {
   try {
-    const packageJsonPath = join4(__dirname3, "../package.json");
+    const packageJsonPath = join3(__dirname3, "../package.json");
     const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
     return packageJson.version;
   } catch {
@@ -11792,6 +11612,277 @@ function getVersion() {
 init_esm_shims();
 import { dirname as dirname2, join as join5 } from "path";
 
+// src/lib/file-system-task-linter/index.ts
+init_esm_shims();
+
+// src/lib/file-system-task-linter/file-system-task-linter.ts
+init_esm_shims();
+import chalk6 from "chalk";
+import { readdir, readFile as readFile2 } from "fs/promises";
+import { join as join4 } from "path";
+var VALID_STATUSES = ["pending", "in-progress", "done", "blocked"];
+var VALID_TYPES = ["feat", "fix", "chore", "docs", "refactor", "test"];
+var FileSystemTaskLinter = class {
+  errors = [];
+  addError(file, message, severity = "error", line) {
+    this.errors.push({ file, message, severity, line });
+  }
+  /**
+   * Validate task file name format (FileSystem-specific)
+   */
+  validateFileName(fileName) {
+    const pattern = /^task-\d{2,3}-[a-z0-9-]+\.md$/;
+    if (!pattern.test(fileName)) {
+      return {
+        file: fileName,
+        message: "Invalid filename. Expected: task-NNN-kebab-case-title.md",
+        severity: "error"
+      };
+    }
+    return null;
+  }
+  extractMetadata(content) {
+    const headerSection = content.split(/^##/m)[0];
+    const statusMatch = headerSection.match(/^Status:\s*(.+)$/im);
+    const typeMatch = headerSection.match(/^Type:\s*(.+)$/im);
+    const assigneeMatch = headerSection.match(/^Assignee:\s*(.+)$/im);
+    return {
+      status: statusMatch?.[1]?.trim().toLowerCase(),
+      type: typeMatch?.[1]?.trim().toLowerCase(),
+      assignee: assigneeMatch?.[1]?.trim()
+    };
+  }
+  /**
+   * Validate task metadata (FileSystem-specific)
+   */
+  validateMetadata(metadata, filePath) {
+    const errors = [];
+    if (!metadata.status) {
+      errors.push({
+        file: filePath,
+        message: "Missing required metadata: Status",
+        severity: "error"
+      });
+    } else if (!VALID_STATUSES.includes(metadata.status)) {
+      errors.push({
+        file: filePath,
+        message: `Invalid status "${metadata.status}". Valid: ${VALID_STATUSES.join(", ")}`,
+        severity: "error"
+      });
+    }
+    if (!metadata.type) {
+      errors.push({
+        file: filePath,
+        message: "Missing required metadata: Type",
+        severity: "error"
+      });
+    } else if (!VALID_TYPES.includes(metadata.type)) {
+      errors.push({
+        file: filePath,
+        message: `Invalid type "${metadata.type}". Valid: ${VALID_TYPES.join(", ")}`,
+        severity: "error"
+      });
+    }
+    if (!metadata.assignee) {
+      errors.push({
+        file: filePath,
+        message: "Missing recommended metadata: Assignee",
+        severity: "warning"
+      });
+    }
+    return errors;
+  }
+  validateContent(filename, content) {
+    const lines = content.split("\n");
+    if (!lines[0]?.trim().startsWith("# ")) {
+      this.addError(
+        filename,
+        "Task file must start with a level 1 heading (# Task NNN \u2014 Title)",
+        "error",
+        1
+      );
+    }
+    const h1Pattern = /^#\s+(?:🧩\s+)?Task\s+\d{2,3}\s+[—-]\s+.+$/i;
+    if (lines[0] && !h1Pattern.test(lines[0])) {
+      this.addError(
+        filename,
+        'H1 heading must follow format: "# Task NNN \u2014 Title"',
+        "error",
+        1
+      );
+    }
+    const metadata = this.extractMetadata(content);
+    const metadataErrors = this.validateMetadata(metadata, filename);
+    metadataErrors.forEach((error2) => {
+      this.addError(error2.file, error2.message, error2.severity, error2.line);
+    });
+    const h2Sections = content.match(/^##\s+.+$/gm);
+    if (!h2Sections || h2Sections.length === 0) {
+      this.addError(
+        filename,
+        "Task should have at least one section (## heading)",
+        "warning"
+      );
+    }
+    const firstH2Index = content.indexOf("\n##");
+    if (firstH2Index > -1) {
+      const afterH2 = content.substring(firstH2Index);
+      if (afterH2.match(/^Status:/im) || afterH2.match(/^Type:/im) || afterH2.match(/^Assignee:/im)) {
+        this.addError(
+          filename,
+          "Metadata must be placed BEFORE the first ## section",
+          "error"
+        );
+      }
+    }
+  }
+  /**
+   * Lint a single task file (FileSystem-specific)
+   */
+  async lintFile(filePath) {
+    const errors = [];
+    const fileName = filePath.split("/").pop() || filePath;
+    const fileNameError = this.validateFileName(fileName);
+    if (fileNameError) {
+      errors.push(fileNameError);
+    }
+    try {
+      const content = await readFile2(filePath, "utf-8");
+      this.errors = [];
+      this.validateContent(fileName, content);
+      errors.push(...this.errors);
+    } catch (error2) {
+      errors.push({
+        file: fileName,
+        message: `Failed to read file: ${error2}`,
+        severity: "error"
+      });
+    }
+    return errors;
+  }
+  /**
+   * Lint all task files in the specified directory (FileSystem-specific)
+   */
+  async lintDirectory(tasksDir) {
+    this.errors = [];
+    try {
+      const files = await readdir(tasksDir);
+      const taskFiles = files.filter((f) => f.endsWith(".md"));
+      for (const file of taskFiles) {
+        const fileNameError = this.validateFileName(file);
+        if (fileNameError) {
+          this.addError(file, fileNameError.message, fileNameError.severity);
+        }
+        const content = await readFile2(join4(tasksDir, file), "utf-8");
+        this.validateContent(file, content);
+      }
+      const errors = this.errors.filter((e) => e.severity === "error");
+      const warnings = this.errors.filter((e) => e.severity === "warning");
+      return {
+        errors,
+        warnings,
+        filesChecked: taskFiles.length,
+        valid: errors.length === 0
+      };
+    } catch (error2) {
+      throw new Error(`Failed to lint tasks: ${error2}`);
+    }
+  }
+  static printResults(result) {
+    if (result.errors.length === 0 && result.warnings.length === 0) {
+      console.log(
+        chalk6.green(`\u2705 All ${result.filesChecked} task files are valid!
+`)
+      );
+      return;
+    }
+    console.log(
+      chalk6.bold(
+        `
+\u{1F4CA} Validation Results (${result.filesChecked} files checked):
+`
+      )
+    );
+    const errorsByFile = /* @__PURE__ */ new Map();
+    [...result.errors, ...result.warnings].forEach((error2) => {
+      if (!errorsByFile.has(error2.file)) {
+        errorsByFile.set(error2.file, []);
+      }
+      errorsByFile.get(error2.file).push(error2);
+    });
+    for (const [file, fileErrors] of errorsByFile) {
+      console.log(chalk6.cyan(`
+\u{1F4C4} ${file}`));
+      for (const error2 of fileErrors) {
+        const icon = error2.severity === "error" ? chalk6.red("\u274C") : chalk6.yellow("\u26A0\uFE0F");
+        const location = error2.line ? `:${error2.line}` : "";
+        console.log(`  ${icon} ${error2.message}${location}`);
+      }
+    }
+    console.log("\n" + "\u2500".repeat(60));
+    console.log(
+      chalk6.bold(
+        `
+\u{1F4CA} Summary: ${chalk6.red(result.errors.length + " error(s)")}, ${chalk6.yellow(result.warnings.length + " warning(s)")}
+`
+      )
+    );
+  }
+};
+
+// src/lib/file-system-task-linter/file-system-task-linter.mock.ts
+init_esm_shims();
+function createMockFileValidationError(overrides) {
+  return {
+    file: "task-001.md",
+    message: "Mock validation error",
+    severity: "error",
+    ...overrides
+  };
+}
+var MOCK_INVALID_LINT_RESULT = {
+  errors: [
+    createMockFileValidationError({
+      file: "task-001.md",
+      message: 'Invalid status: "invalid"'
+    }),
+    createMockFileValidationError({
+      file: "task-002.md",
+      message: 'Invalid type: "unknown"'
+    })
+  ],
+  filesChecked: 2,
+  valid: false,
+  warnings: []
+};
+var MOCK_WARNINGS_LINT_RESULT = {
+  errors: [],
+  filesChecked: 3,
+  valid: true,
+  warnings: [
+    createMockFileValidationError({
+      file: "task-003.md",
+      message: "Consider adding assignee",
+      severity: "warning"
+    })
+  ]
+};
+var MOCK_VALIDATION_ERRORS = [
+  createMockFileValidationError({
+    file: "task-001.md",
+    message: "Invalid status: must be one of [pending, in-progress, done, blocked]",
+    line: 5
+  }),
+  createMockFileValidationError({
+    file: "task-001.md",
+    message: "Invalid type: must be one of [feat, fix, chore, docs, refactor, test]",
+    line: 6
+  })
+];
+
+// src/lib/file-system-task-linter/file-system-task-linter.types.ts
+init_esm_shims();
+
 // src/taskin.ts
 init_esm_shims();
 var Taskin = class {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taskin",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "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",
@@ -86,10 +86,10 @@
     "typescript": "^5.9.3",
     "vitest": "^1.6.1",
     "@opentask/taskin-fs-provider": "1.0.5",
-    "@opentask/taskin-task-manager": "1.0.5",
-    "@opentask/taskin-task-server-ws": "0.1.0",
     "@opentask/taskin-task-server-mcp": "0.1.0",
+    "@opentask/taskin-task-manager": "1.0.5",
     "@opentask/taskin-types": "1.0.5",
+    "@opentask/taskin-task-server-ws": "0.1.0",
     "@opentask/taskin-utils": "1.0.5"
   },
   "scripts": {