@task-mcp/shared 0.1.0

package/dist/utils/natural-language.js

@@ -0,0 +1,112 @@
+import { parseRelativeDate } from "./date.js";
+/**
+ * Parse natural language task input
+ *
+ * Examples:
+ * - "Review PR tomorrow #dev !high"
+ * - "내일까지 보고서 작성 #업무 !높음 @집중"
+ * - "Fix bug by Friday #backend !critical"
+ * - "Write tests every Monday #testing"
+ */
+export function parseTaskInput(input) {
+    let remaining = input.trim();
+    const result = { title: "" };
+    // Extract priority (!high, !critical, !medium, !low, !높음, !보통, !낮음)
+    const priorityMatch = remaining.match(/!([\p{L}\p{N}_]+)/gu);
+    if (priorityMatch) {
+        for (const match of priorityMatch) {
+            const priority = parsePriority(match.slice(1));
+            if (priority) {
+                result.priority = priority;
+                remaining = remaining.replace(match, "").trim();
+                break;
+            }
+        }
+    }
+    // Extract contexts (@focus, @review, @집중)
+    const contextMatches = remaining.match(/@([\p{L}\p{N}_]+)/gu);
+    if (contextMatches) {
+        result.contexts = contextMatches.map((m) => m.slice(1));
+        for (const match of contextMatches) {
+            remaining = remaining.replace(match, "").trim();
+        }
+    }
+    // Extract tags (#dev, #backend, #개발)
+    const tagMatches = remaining.match(/#([\p{L}\p{N}_]+)/gu);
+    if (tagMatches) {
+        result.tags = tagMatches.map((m) => m.slice(1));
+        for (const match of tagMatches) {
+            remaining = remaining.replace(match, "").trim();
+        }
+    }
+    // Extract due date patterns
+    // "by Friday", "by tomorrow", "until next week"
+    const byMatch = remaining.match(/\b(by|until|before)\s+(\w+(\s+\w+)?)/i);
+    if (byMatch) {
+        const dateStr = byMatch[2];
+        const date = parseRelativeDate(dateStr);
+        if (date) {
+            result.dueDate = date.toISOString();
+            remaining = remaining.replace(byMatch[0], "").trim();
+        }
+    }
+    // Korean date patterns: "내일까지", "금요일까지"
+    const koreanDueMatch = remaining.match(/(\S+)까지/);
+    if (koreanDueMatch && !result.dueDate) {
+        const dateStr = koreanDueMatch[1];
+        const date = parseRelativeDate(dateStr);
+        if (date) {
+            result.dueDate = date.toISOString();
+            remaining = remaining.replace(koreanDueMatch[0], "").trim();
+        }
+    }
+    // "tomorrow", "today" at the end
+    const dateWords = ["tomorrow", "today", "내일", "오늘", "모레"];
+    for (const word of dateWords) {
+        if (remaining.toLowerCase().endsWith(word) && !result.dueDate) {
+            const date = parseRelativeDate(word);
+            if (date) {
+                result.dueDate = date.toISOString();
+                remaining = remaining.slice(0, -word.length).trim();
+            }
+        }
+    }
+    // Extract time estimate (30m, 2h, 1h30m)
+    // Pattern matches: "2h30m", "2h", "30m" (but not empty string)
+    const timeMatch = remaining.match(/\b(\d+h\d+m|\d+h|\d+m)\b/);
+    if (timeMatch) {
+        let minutes = 0;
+        const hoursMatch = timeMatch[0].match(/(\d+)h/);
+        const minsMatch = timeMatch[0].match(/(\d+)m/);
+        if (hoursMatch) {
+            minutes += parseInt(hoursMatch[1], 10) * 60;
+        }
+        if (minsMatch) {
+            minutes += parseInt(minsMatch[1], 10);
+        }
+        if (minutes > 0) {
+            result.estimate = { expected: minutes, confidence: "medium" };
+            remaining = remaining.replace(timeMatch[0], "").trim();
+        }
+    }
+    // Clean up extra spaces
+    result.title = remaining.replace(/\s+/g, " ").trim();
+    return result;
+}
+function parsePriority(input) {
+    const lower = input.toLowerCase();
+    const priorityMap = {
+        critical: "critical",
+        highest: "critical",
+        긴급: "critical",
+        high: "high",
+        높음: "high",
+        medium: "medium",
+        normal: "medium",
+        보통: "medium",
+        low: "low",
+        낮음: "low",
+    };
+    return priorityMap[lower] ?? null;
+}
+//# sourceMappingURL=natural-language.js.map

package/dist/utils/natural-language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"natural-language.js","sourceRoot":"","sources":["../../src/utils/natural-language.ts"],"names":[],"mappings":"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"}

package/dist/utils/natural-language.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=natural-language.test.d.ts.map

package/dist/utils/natural-language.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"natural-language.test.d.ts","sourceRoot":"","sources":["../../src/utils/natural-language.test.ts"],"names":[],"mappings":""}

package/dist/utils/natural-language.test.js

@@ -0,0 +1,132 @@
+import { describe, test, expect } from "bun:test";
+import { parseTaskInput } from "./natural-language.js";
+describe("parseTaskInput", () => {
+    describe("priority parsing", () => {
+        test("parses !critical priority", () => {
+            const result = parseTaskInput("Fix bug !critical");
+            expect(result.priority).toBe("critical");
+            expect(result.title).toBe("Fix bug");
+        });
+        test("parses !high priority", () => {
+            const result = parseTaskInput("Review PR !high");
+            expect(result.priority).toBe("high");
+        });
+        test("parses !medium priority", () => {
+            const result = parseTaskInput("Write docs !medium");
+            expect(result.priority).toBe("medium");
+        });
+        test("parses !low priority", () => {
+            const result = parseTaskInput("Clean up !low");
+            expect(result.priority).toBe("low");
+        });
+        test("parses Korean priority !높음", () => {
+            const result = parseTaskInput("버그 수정 !높음");
+            expect(result.priority).toBe("high");
+            expect(result.title).toBe("버그 수정");
+        });
+        test("parses Korean priority !긴급", () => {
+            const result = parseTaskInput("장애 대응 !긴급");
+            expect(result.priority).toBe("critical");
+            expect(result.title).toBe("장애 대응");
+        });
+    });
+    describe("tag parsing", () => {
+        test("parses single tag", () => {
+            const result = parseTaskInput("Fix auth #backend");
+            expect(result.tags).toEqual(["backend"]);
+            expect(result.title).toBe("Fix auth");
+        });
+        test("parses multiple tags", () => {
+            const result = parseTaskInput("Update API #backend #api #v2");
+            expect(result.tags).toEqual(["backend", "api", "v2"]);
+        });
+        test("parses Korean tags", () => {
+            const result = parseTaskInput("보고서 작성 #업무 #문서");
+            expect(result.tags).toEqual(["업무", "문서"]);
+            expect(result.title).toBe("보고서 작성");
+        });
+    });
+    describe("context parsing", () => {
+        test("parses single context", () => {
+            const result = parseTaskInput("Deep work task @focus");
+            expect(result.contexts).toEqual(["focus"]);
+            expect(result.title).toBe("Deep work task");
+        });
+        test("parses multiple contexts", () => {
+            const result = parseTaskInput("Review code @focus @office");
+            expect(result.contexts).toEqual(["focus", "office"]);
+        });
+    });
+    describe("due date parsing", () => {
+        test("parses 'by tomorrow'", () => {
+            const result = parseTaskInput("Submit report by tomorrow");
+            expect(result.dueDate).toBeDefined();
+            expect(result.title).toBe("Submit report");
+        });
+        test("parses 'until Friday'", () => {
+            const result = parseTaskInput("Complete feature until Friday");
+            expect(result.dueDate).toBeDefined();
+        });
+        test("parses Korean '내일까지'", () => {
+            const result = parseTaskInput("보고서 제출 내일까지");
+            expect(result.dueDate).toBeDefined();
+            expect(result.title).toBe("보고서 제출");
+        });
+        test("parses standalone 'tomorrow' at end", () => {
+            const result = parseTaskInput("Submit PR tomorrow");
+            expect(result.dueDate).toBeDefined();
+            expect(result.title).toBe("Submit PR");
+        });
+    });
+    describe("time estimate parsing", () => {
+        test("parses hours only", () => {
+            const result = parseTaskInput("Write tests 2h");
+            expect(result.estimate?.expected).toBe(120);
+        });
+        test("parses minutes only", () => {
+            const result = parseTaskInput("Quick fix 30m");
+            expect(result.estimate?.expected).toBe(30);
+        });
+        test("parses combined hours and minutes", () => {
+            const result = parseTaskInput("Big refactor 1h30m");
+            expect(result.estimate?.expected).toBe(90);
+        });
+        test("removes time estimate from title", () => {
+            const result = parseTaskInput("Task 2h30m done");
+            expect(result.estimate?.expected).toBe(150);
+            expect(result.title).toBe("Task done");
+        });
+    });
+    describe("combined parsing", () => {
+        test("parses full English input", () => {
+            const result = parseTaskInput("Review PR #dev !high @focus");
+            expect(result.title).toBe("Review PR");
+            expect(result.tags).toEqual(["dev"]);
+            expect(result.priority).toBe("high");
+            expect(result.contexts).toEqual(["focus"]);
+        });
+        test("parses input with due date", () => {
+            const result = parseTaskInput("Submit report by tomorrow #work");
+            expect(result.title).toBe("Submit report");
+            expect(result.tags).toEqual(["work"]);
+            expect(result.dueDate).toBeDefined();
+        });
+        test("parses full Korean input", () => {
+            const result = parseTaskInput("보고서 작성 내일까지 #업무 !높음 @집중");
+            expect(result.title).toBe("보고서 작성");
+            expect(result.tags).toEqual(["업무"]);
+            expect(result.priority).toBe("high");
+            expect(result.contexts).toEqual(["집중"]);
+            expect(result.dueDate).toBeDefined();
+        });
+        test("returns clean title with no metadata", () => {
+            const result = parseTaskInput("Simple task");
+            expect(result.title).toBe("Simple task");
+            expect(result.tags).toBeUndefined();
+            expect(result.priority).toBeUndefined();
+            expect(result.contexts).toBeUndefined();
+            expect(result.dueDate).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=natural-language.test.js.map

package/dist/utils/natural-language.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"natural-language.test.js","sourceRoot":"","sources":["../../src/utils/natural-language.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@task-mcp/shared",
+  "version": "0.1.0",
+  "description": "Shared utilities for task-mcp: types, algorithms, and natural language parsing",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "import": "./src/index.ts",
+      "types": "./src/index.ts"
+    }
+  },
+  "files": [
+    "src",
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "keywords": [
+    "task-mcp",
+    "shared",
+    "critical-path",
+    "topological-sort",
+    "natural-language-parsing"
+  ],
+  "author": "addsalt1t",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/addsalt1t/task-mcp.git",
+    "directory": "packages/shared"
+  },
+  "homepage": "https://github.com/addsalt1t/task-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/addsalt1t/task-mcp/issues"
+  },
+  "dependencies": {
+    "arktype": "2.0.0-rc.31"
+  }
+}

package/src/algorithms/critical-path.test.ts

@@ -0,0 +1,241 @@
+import { describe, test, expect } from "bun:test";
+import {
+  criticalPathAnalysis,
+  findParallelTasks,
+  suggestNextTask,
+} from "./critical-path.js";
+import type { Task } from "../schemas/task.js";
+
+// Helper to create mock tasks
+function createTask(
+  id: string,
+  options: {
+    priority?: string;
+    deps?: string[];
+    estimate?: number;
+    status?: string;
+    contexts?: string[];
+  } = {}
+): Task {
+  const task: Task = {
+    id,
+    title: `Task ${id}`,
+    status: (options.status ?? "pending") as Task["status"],
+    priority: (options.priority ?? "medium") as Task["priority"],
+    projectId: "test-project",
+    createdAt: new Date().toISOString(),
+    updatedAt: new Date().toISOString(),
+    dependencies: (options.deps ?? []).map((depId) => ({
+      taskId: depId,
+      type: "blocked_by" as const,
+    })),
+  };
+  if (options.estimate) {
+    task.estimate = { expected: options.estimate, confidence: "medium" as const };
+  }
+  if (options.contexts) {
+    task.contexts = options.contexts;
+  }
+  return task;
+}
+
+describe("criticalPathAnalysis", () => {
+  test("returns empty result for empty input", () => {
+    const result = criticalPathAnalysis([]);
+    expect(result.tasks).toEqual([]);
+    expect(result.criticalPath).toEqual([]);
+    expect(result.projectDuration).toBe(0);
+  });
+
+  test("returns empty for all completed tasks", () => {
+    const tasks = [createTask("A", { status: "completed" })];
+    const result = criticalPathAnalysis(tasks);
+    expect(result.tasks).toEqual([]);
+  });
+
+  test("calculates single task correctly", () => {
+    const tasks = [createTask("A", { estimate: 60 })];
+    const result = criticalPathAnalysis(tasks);
+
+    expect(result.projectDuration).toBe(60);
+    expect(result.criticalPath.length).toBe(1);
+    expect(result.criticalPath[0]!.id).toBe("A");
+    expect(result.criticalPath[0]!.isCritical).toBe(true);
+  });
+
+  test("identifies critical path in linear chain", () => {
+    // A -> B -> C (each 30 min)
+    const tasks = [
+      createTask("A", { estimate: 30 }),
+      createTask("B", { estimate: 30, deps: ["A"] }),
+      createTask("C", { estimate: 30, deps: ["B"] }),
+    ];
+    const result = criticalPathAnalysis(tasks);
+
+    expect(result.projectDuration).toBe(90);
+    expect(result.criticalPath.length).toBe(3);
+    expect(result.criticalPath.map((t) => t.id)).toEqual(["A", "B", "C"]);
+  });
+
+  test("calculates slack for parallel tasks", () => {
+    // A (60) and B (30) both lead to C
+    // A is on critical path, B has 30 min slack
+    const tasks = [
+      createTask("A", { estimate: 60 }),
+      createTask("B", { estimate: 30 }),
+      createTask("C", { estimate: 30, deps: ["A", "B"] }),
+    ];
+    const result = criticalPathAnalysis(tasks);
+
+    expect(result.projectDuration).toBe(90); // A + C
+
+    const taskA = result.tasks.find((t) => t.id === "A")!;
+    const taskB = result.tasks.find((t) => t.id === "B")!;
+    const taskC = result.tasks.find((t) => t.id === "C")!;
+
+    expect(taskA.isCritical).toBe(true);
+    expect(taskB.slack).toBe(30); // B can start 30 min late
+    expect(taskC.isCritical).toBe(true);
+  });
+
+  test("identifies bottlenecks by dependent count", () => {
+    // A blocks B, C, D
+    const tasks = [
+      createTask("A", { estimate: 30 }),
+      createTask("B", { estimate: 30, deps: ["A"] }),
+      createTask("C", { estimate: 30, deps: ["A"] }),
+      createTask("D", { estimate: 30, deps: ["A"] }),
+    ];
+    const result = criticalPathAnalysis(tasks);
+
+    expect(result.bottlenecks.length).toBeGreaterThan(0);
+    expect(result.bottlenecks[0]!.id).toBe("A"); // A blocks the most tasks
+  });
+});
+
+describe("findParallelTasks", () => {
+  test("returns empty for empty input", () => {
+    const result = findParallelTasks([]);
+    expect(result).toEqual([]);
+  });
+
+  test("returns single group for independent tasks", () => {
+    const tasks = [
+      createTask("A"),
+      createTask("B"),
+      createTask("C"),
+    ];
+    const result = findParallelTasks(tasks);
+
+    expect(result.length).toBe(1);
+    expect(result[0]!.length).toBe(3);
+  });
+
+  test("excludes tasks with uncompleted dependencies", () => {
+    const tasks = [
+      createTask("A"),
+      createTask("B", { deps: ["A"] }),
+    ];
+    const result = findParallelTasks(tasks);
+
+    // Only A is available (B is blocked)
+    expect(result.length).toBe(1);
+    expect(result[0]!.length).toBe(1);
+    expect(result[0]![0]!.id).toBe("A");
+  });
+
+  test("includes task when dependency is completed", () => {
+    const tasks = [
+      createTask("A", { status: "completed" }),
+      createTask("B", { deps: ["A"] }),
+      createTask("C"),
+    ];
+    const result = findParallelTasks(tasks);
+
+    // B and C can run in parallel
+    expect(result.length).toBe(1);
+    expect(result[0]!.map((t) => t.id).sort()).toEqual(["B", "C"]);
+  });
+
+  test("excludes completed tasks from result", () => {
+    const tasks = [
+      createTask("A", { status: "completed" }),
+      createTask("B"),
+    ];
+    const result = findParallelTasks(tasks);
+
+    expect(result.length).toBe(1);
+    expect(result[0]!.length).toBe(1);
+    expect(result[0]![0]!.id).toBe("B");
+  });
+});
+
+describe("suggestNextTask", () => {
+  test("returns null for empty input", () => {
+    const result = suggestNextTask([]);
+    expect(result).toBeNull();
+  });
+
+  test("returns null when all tasks completed", () => {
+    const tasks = [createTask("A", { status: "completed" })];
+    const result = suggestNextTask(tasks);
+    expect(result).toBeNull();
+  });
+
+  test("prefers critical path tasks", () => {
+    // A is critical (longer), B has slack
+    const tasks = [
+      createTask("A", { estimate: 60, priority: "low" }),
+      createTask("B", { estimate: 30, priority: "high" }),
+      createTask("C", { estimate: 30, deps: ["A", "B"] }),
+    ];
+    const result = suggestNextTask(tasks);
+
+    // A is on critical path, should be suggested first
+    expect(result!.id).toBe("A");
+  });
+
+  test("filters by context when specified", () => {
+    const tasks = [
+      createTask("A", { priority: "critical", contexts: ["office"] }),
+      createTask("B", { priority: "high", contexts: ["focus"] }),
+    ];
+    const result = suggestNextTask(tasks, { contexts: ["focus"] });
+
+    expect(result!.id).toBe("B");
+  });
+
+  test("filters by max time when specified", () => {
+    const tasks = [
+      createTask("A", { estimate: 120, priority: "critical" }),
+      createTask("B", { estimate: 30, priority: "high" }),
+    ];
+    const result = suggestNextTask(tasks, { maxMinutes: 60 });
+
+    expect(result!.id).toBe("B");
+  });
+
+  test("skips blocked tasks", () => {
+    const tasks = [
+      createTask("A", { priority: "low" }),
+      createTask("B", { priority: "critical", deps: ["A"] }),
+    ];
+    const result = suggestNextTask(tasks);
+
+    // B is blocked, so A should be suggested
+    expect(result!.id).toBe("A");
+  });
+
+  test("considers tasks with more dependents", () => {
+    const tasks = [
+      createTask("A", { priority: "medium" }),
+      createTask("B", { priority: "medium" }),
+      createTask("C", { priority: "medium", deps: ["A"] }),
+      createTask("D", { priority: "medium", deps: ["A"] }),
+    ];
+    const result = suggestNextTask(tasks);
+
+    // A blocks more tasks (C and D), should be preferred over B
+    expect(result!.id).toBe("A");
+  });
+});