@task-mcp/shared 1.0.29 → 1.0.30

package/dist/utils/clustering.js

@@ -0,0 +1,283 @@
+/**
+ * Semantic clustering utilities for task similarity
+ *
+ * Uses lightweight text similarity without external APIs.
+ * Designed for session resumption to suggest related tasks.
+ */
+/**
+ * Stop words to ignore in similarity calculation
+ * Common words that don't contribute to semantic meaning
+ */
+const STOP_WORDS = new Set([
+    // English
+    "a",
+    "am",
+    "an",
+    "the",
+    "is",
+    "are",
+    "was",
+    "were",
+    "be",
+    "been",
+    "being",
+    "have",
+    "has",
+    "had",
+    "do",
+    "does",
+    "did",
+    "will",
+    "would",
+    "could",
+    "should",
+    "may",
+    "might",
+    "must",
+    "can",
+    "to",
+    "of",
+    "in",
+    "for",
+    "on",
+    "with",
+    "at",
+    "by",
+    "from",
+    "as",
+    "into",
+    "through",
+    "during",
+    "before",
+    "after",
+    "above",
+    "below",
+    "and",
+    "or",
+    "but",
+    "if",
+    "then",
+    "else",
+    "when",
+    "where",
+    "why",
+    "how",
+    "all",
+    "each",
+    "every",
+    "both",
+    "few",
+    "more",
+    "most",
+    "other",
+    "some",
+    "such",
+    "no",
+    "nor",
+    "not",
+    "only",
+    "own",
+    "same",
+    "so",
+    "than",
+    "too",
+    "very",
+    "just",
+    "also",
+    "this",
+    "that",
+    "these",
+    "those",
+    "it",
+    "its",
+    // Korean particles (common suffixes)
+    "을",
+    "를",
+    "이",
+    "가",
+    "은",
+    "는",
+    "에",
+    "에서",
+    "으로",
+    "로",
+    "와",
+    "과",
+    "의",
+    "도",
+    "만",
+    "까지",
+    "부터",
+    "하다",
+    "하기",
+    "해서",
+    "하고",
+]);
+/**
+ * Tokenize text into meaningful words
+ * - Converts to lowercase
+ * - Splits on whitespace and punctuation
+ * - Removes stop words
+ * - Removes short tokens (< 2 chars)
+ */
+export function tokenize(text) {
+    if (!text)
+        return [];
+    return text
+        .toLowerCase()
+        .split(/[\s\-_.,;:!?()\[\]{}'"\/\\]+/)
+        .filter((token) => token.length >= 2 && !STOP_WORDS.has(token));
+}
+/**
+ * Calculate Jaccard similarity between two token sets
+ * Returns value between 0 (no overlap) and 1 (identical)
+ */
+export function jaccardSimilarity(tokensA, tokensB) {
+    if (tokensA.length === 0 && tokensB.length === 0)
+        return 0;
+    if (tokensA.length === 0 || tokensB.length === 0)
+        return 0;
+    const setA = new Set(tokensA);
+    const setB = new Set(tokensB);
+    let intersection = 0;
+    for (const token of setA) {
+        if (setB.has(token)) {
+            intersection++;
+        }
+    }
+    const union = setA.size + setB.size - intersection;
+    return union === 0 ? 0 : intersection / union;
+}
+/**
+ * Calculate weighted similarity between two tasks
+ *
+ * Weights:
+ * - Intent: 0.4 (highest priority - captures purpose)
+ * - Title: 0.3 (strong signal)
+ * - Description: 0.2 (additional context)
+ * - Tags: 0.1 (explicit categorization)
+ */
+export function calculateTaskSimilarity(task1, task2) {
+    // Extract text fields
+    const intent1 = task1.workContext?.intent || "";
+    const intent2 = task2.workContext?.intent || "";
+    const title1 = task1.title || "";
+    const title2 = task2.title || "";
+    const desc1 = task1.description || "";
+    const desc2 = task2.description || "";
+    const tags1 = task1.tags?.join(" ") || "";
+    const tags2 = task2.tags?.join(" ") || "";
+    // Tokenize
+    const intentTokens1 = tokenize(intent1);
+    const intentTokens2 = tokenize(intent2);
+    const titleTokens1 = tokenize(title1);
+    const titleTokens2 = tokenize(title2);
+    const descTokens1 = tokenize(desc1);
+    const descTokens2 = tokenize(desc2);
+    const tagTokens1 = tokenize(tags1);
+    const tagTokens2 = tokenize(tags2);
+    // Calculate component similarities
+    const intentSim = jaccardSimilarity(intentTokens1, intentTokens2);
+    const titleSim = jaccardSimilarity(titleTokens1, titleTokens2);
+    const descSim = jaccardSimilarity(descTokens1, descTokens2);
+    const tagSim = jaccardSimilarity(tagTokens1, tagTokens2);
+    // Weighted combination
+    // Adjust weights based on available content
+    let totalWeight = 0;
+    let weightedSum = 0;
+    if (intentTokens1.length > 0 || intentTokens2.length > 0) {
+        weightedSum += intentSim * 0.4;
+        totalWeight += 0.4;
+    }
+    if (titleTokens1.length > 0 || titleTokens2.length > 0) {
+        weightedSum += titleSim * 0.3;
+        totalWeight += 0.3;
+    }
+    if (descTokens1.length > 0 || descTokens2.length > 0) {
+        weightedSum += descSim * 0.2;
+        totalWeight += 0.2;
+    }
+    if (tagTokens1.length > 0 || tagTokens2.length > 0) {
+        weightedSum += tagSim * 0.1;
+        totalWeight += 0.1;
+    }
+    return totalWeight === 0 ? 0 : weightedSum / totalWeight;
+}
+/**
+ * Find tasks related to a given task
+ *
+ * @param task - The reference task
+ * @param allTasks - All tasks to search from
+ * @param options - Configuration options
+ * @returns Array of related tasks sorted by similarity (highest first)
+ */
+export function findRelatedTasks(task, allTasks, options = {}) {
+    const { limit = 5, minSimilarity = 0.1, excludeCompleted = true, excludeSameParent = true, } = options;
+    const candidates = allTasks.filter((t) => {
+        // Exclude self
+        if (t.id === task.id)
+            return false;
+        // Exclude completed if requested
+        if (excludeCompleted && t.status === "completed")
+            return false;
+        // Exclude same parent (siblings are already contextually related)
+        if (excludeSameParent && task.parentId && t.parentId === task.parentId)
+            return false;
+        // Exclude direct parent/child relationships
+        if (t.parentId === task.id || task.parentId === t.id)
+            return false;
+        return true;
+    });
+    // Calculate similarities
+    const withSimilarity = candidates
+        .map((t) => ({
+        task: t,
+        similarity: calculateTaskSimilarity(task, t),
+    }))
+        .filter((item) => item.similarity >= minSimilarity)
+        .sort((a, b) => b.similarity - a.similarity)
+        .slice(0, limit);
+    return withSimilarity;
+}
+/**
+ * Cluster tasks by similarity
+ * Returns groups of related tasks
+ */
+export function clusterTasks(tasks, options = {}) {
+    const { minClusterSize = 2, similarityThreshold = 0.2 } = options;
+    // Simple greedy clustering
+    const assigned = new Set();
+    const clusters = [];
+    // Sort by priority to use higher priority tasks as cluster representatives
+    const sortedTasks = [...tasks].sort((a, b) => {
+        const priorityOrder = { critical: 0, high: 1, medium: 2, low: 3 };
+        return (priorityOrder[a.priority] ?? 2) - (priorityOrder[b.priority] ?? 2);
+    });
+    for (const task of sortedTasks) {
+        if (assigned.has(task.id))
+            continue;
+        // Find related tasks that haven't been assigned
+        const related = findRelatedTasks(task, tasks, {
+            minSimilarity: similarityThreshold,
+            excludeCompleted: false,
+            excludeSameParent: false,
+            limit: 10,
+        }).filter((r) => !assigned.has(r.task.id));
+        if (related.length >= minClusterSize - 1) {
+            // Create cluster
+            const members = [task, ...related.map((r) => r.task)];
+            const avgSimilarity = related.length > 0 ? related.reduce((sum, r) => sum + r.similarity, 0) / related.length : 0;
+            clusters.push({
+                representative: task,
+                members,
+                avgSimilarity,
+            });
+            // Mark as assigned
+            for (const member of members) {
+                assigned.add(member.id);
+            }
+        }
+    }
+    return clusters;
+}
+//# sourceMappingURL=clustering.js.map

package/dist/utils/clustering.js.map

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

package/dist/utils/clustering.test.d.ts

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

package/dist/utils/clustering.test.d.ts.map

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

package/dist/utils/clustering.test.js

@@ -0,0 +1,237 @@
+import { describe, test, expect } from "bun:test";
+import { tokenize, jaccardSimilarity, calculateTaskSimilarity, findRelatedTasks, clusterTasks, } from "./clustering.js";
+// Helper to create minimal task for testing
+function createTask(overrides) {
+    return {
+        status: "pending",
+        priority: "medium",
+        workspace: "test-workspace",
+        tags: [],
+        contexts: [],
+        createdAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+        ...overrides,
+    };
+}
+describe("tokenize", () => {
+    test("splits on whitespace and punctuation", () => {
+        expect(tokenize("Fix the bug")).toEqual(["fix", "bug"]);
+        expect(tokenize("user-authentication")).toEqual(["user", "authentication"]);
+        expect(tokenize("task.create")).toEqual(["task", "create"]);
+    });
+    test("removes stop words", () => {
+        expect(tokenize("the user is authenticated")).toEqual(["user", "authenticated"]);
+        expect(tokenize("to be or not to be")).toEqual([]);
+    });
+    test("removes short tokens (< 2 chars)", () => {
+        // "I" and "a" are 1 char, removed. "am" is a stop word
+        expect(tokenize("I am a user")).toEqual(["user"]);
+    });
+    test("handles Korean text", () => {
+        expect(tokenize("버그 수정하기")).toEqual(["버그", "수정하기"]);
+        // Korean particles are removed
+        expect(tokenize("사용자를")).toEqual(["사용자를"]); // 를 is suffix, not separate word
+    });
+    test("handles empty input", () => {
+        expect(tokenize("")).toEqual([]);
+        expect(tokenize("   ")).toEqual([]);
+    });
+});
+describe("jaccardSimilarity", () => {
+    test("returns 1 for identical sets", () => {
+        expect(jaccardSimilarity(["fix", "bug"], ["fix", "bug"])).toBe(1);
+    });
+    test("returns 0 for completely different sets", () => {
+        expect(jaccardSimilarity(["fix", "bug"], ["create", "feature"])).toBe(0);
+    });
+    test("returns 0.5 for half overlap", () => {
+        expect(jaccardSimilarity(["fix", "bug"], ["fix", "error"])).toBeCloseTo(0.333, 2);
+    });
+    test("handles empty arrays", () => {
+        expect(jaccardSimilarity([], [])).toBe(0);
+        expect(jaccardSimilarity(["fix"], [])).toBe(0);
+    });
+});
+describe("calculateTaskSimilarity", () => {
+    test("returns high similarity for tasks with same intent", () => {
+        const task1 = createTask({
+            id: "1",
+            title: "Fix login bug",
+            workContext: { intent: "Fix issue or bug" },
+        });
+        const task2 = createTask({
+            id: "2",
+            title: "Debug authentication",
+            workContext: { intent: "Fix issue or bug" },
+        });
+        const similarity = calculateTaskSimilarity(task1, task2);
+        expect(similarity).toBeGreaterThan(0.3);
+    });
+    test("returns high similarity for tasks with similar titles", () => {
+        const task1 = createTask({
+            id: "1",
+            title: "Implement user authentication",
+        });
+        const task2 = createTask({
+            id: "2",
+            title: "Implement admin authentication",
+        });
+        const similarity = calculateTaskSimilarity(task1, task2);
+        expect(similarity).toBeGreaterThan(0.3);
+    });
+    test("returns low similarity for unrelated tasks", () => {
+        const task1 = createTask({
+            id: "1",
+            title: "Fix login bug",
+            workContext: { intent: "Fix issue or bug" },
+        });
+        const task2 = createTask({
+            id: "2",
+            title: "Write documentation",
+            workContext: { intent: "Document functionality" },
+        });
+        const similarity = calculateTaskSimilarity(task1, task2);
+        expect(similarity).toBeLessThan(0.2);
+    });
+    test("handles tasks with missing fields", () => {
+        const task1 = createTask({ id: "1", title: "Task one" });
+        const task2 = createTask({ id: "2", title: "Task two" });
+        // Should not throw
+        const similarity = calculateTaskSimilarity(task1, task2);
+        expect(similarity).toBeGreaterThanOrEqual(0);
+    });
+});
+describe("findRelatedTasks", () => {
+    const tasks = [
+        createTask({
+            id: "auth-1",
+            title: "Implement user authentication",
+            workContext: { intent: "Implement new functionality" },
+        }),
+        createTask({
+            id: "auth-2",
+            title: "Implement OAuth authentication",
+            workContext: { intent: "Implement new functionality" },
+        }),
+        createTask({
+            id: "bug-1",
+            title: "Fix login bug",
+            workContext: { intent: "Fix issue or bug" },
+        }),
+        createTask({
+            id: "doc-1",
+            title: "Write API documentation",
+            workContext: { intent: "Document functionality" },
+        }),
+        createTask({
+            id: "completed-1",
+            title: "Implement session authentication",
+            status: "completed",
+            workContext: { intent: "Implement new functionality" },
+        }),
+    ];
+    test("finds related tasks by similarity", () => {
+        const related = findRelatedTasks(tasks[0], tasks);
+        // auth-2 should be most similar to auth-1
+        expect(related.length).toBeGreaterThan(0);
+        expect(related[0].task.id).toBe("auth-2");
+    });
+    test("excludes completed tasks by default", () => {
+        const related = findRelatedTasks(tasks[0], tasks);
+        const hasCompleted = related.some((r) => r.task.status === "completed");
+        expect(hasCompleted).toBe(false);
+    });
+    test("includes completed tasks when requested", () => {
+        const related = findRelatedTasks(tasks[0], tasks, { excludeCompleted: false });
+        const hasCompleted = related.some((r) => r.task.status === "completed");
+        expect(hasCompleted).toBe(true);
+    });
+    test("respects limit option", () => {
+        const related = findRelatedTasks(tasks[0], tasks, { limit: 1 });
+        expect(related.length).toBe(1);
+    });
+    test("excludes self", () => {
+        const related = findRelatedTasks(tasks[0], tasks);
+        const hasSelf = related.some((r) => r.task.id === tasks[0].id);
+        expect(hasSelf).toBe(false);
+    });
+    test("excludes siblings when excludeSameParent is true", () => {
+        const parentId = "parent-1";
+        const tasksWithParent = [
+            createTask({ id: "child-1", title: "Task one", parentId }),
+            createTask({ id: "child-2", title: "Task one similar", parentId }),
+            createTask({ id: "other", title: "Task one other" }),
+        ];
+        const related = findRelatedTasks(tasksWithParent[0], tasksWithParent, {
+            excludeSameParent: true,
+        });
+        const hasSibling = related.some((r) => r.task.id === "child-2");
+        expect(hasSibling).toBe(false);
+    });
+});
+describe("clusterTasks", () => {
+    test("groups similar tasks together", () => {
+        const tasks = [
+            createTask({
+                id: "auth-1",
+                title: "Implement user authentication",
+                priority: "high",
+                workContext: { intent: "Implement new functionality" },
+            }),
+            createTask({
+                id: "auth-2",
+                title: "Implement OAuth authentication",
+                priority: "medium",
+                workContext: { intent: "Implement new functionality" },
+            }),
+            createTask({
+                id: "bug-1",
+                title: "Fix critical login bug",
+                priority: "critical",
+                workContext: { intent: "Fix issue or bug" },
+            }),
+            createTask({
+                id: "bug-2",
+                title: "Fix authentication bug",
+                priority: "high",
+                workContext: { intent: "Fix issue or bug" },
+            }),
+        ];
+        const clusters = clusterTasks(tasks, { minClusterSize: 2 });
+        // Should have at least one cluster
+        expect(clusters.length).toBeGreaterThan(0);
+        // Each cluster should have at least minClusterSize members
+        for (const cluster of clusters) {
+            expect(cluster.members.length).toBeGreaterThanOrEqual(2);
+        }
+    });
+    test("uses higher priority tasks as representatives", () => {
+        const tasks = [
+            createTask({
+                id: "low",
+                title: "Implement feature",
+                priority: "low",
+                workContext: { intent: "Implement new functionality" },
+            }),
+            createTask({
+                id: "high",
+                title: "Implement similar feature",
+                priority: "high",
+                workContext: { intent: "Implement new functionality" },
+            }),
+        ];
+        const clusters = clusterTasks(tasks, { minClusterSize: 2, similarityThreshold: 0.1 });
+        if (clusters.length > 0) {
+            expect(clusters[0].representative.id).toBe("high");
+        }
+    });
+    test("returns empty array for no matching clusters", () => {
+        const tasks = [
+            createTask({ id: "1", title: "Unique task one" }),
+            createTask({ id: "2", title: "Different topic completely" }),
+        ];
+        const clusters = clusterTasks(tasks, { minClusterSize: 2, similarityThreshold: 0.5 });
+        expect(clusters.length).toBe(0);
+    });
+});
+//# sourceMappingURL=clustering.test.js.map

package/dist/utils/clustering.test.js.map

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

package/dist/utils/env.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Environment detection utilities
+ */
+/**
+ * Check if running in test environment.
+ * Detects: NODE_ENV=test, BUN_TEST (set by bun test), VITEST, JEST_WORKER_ID
+ */
+export declare function isTestEnv(): boolean;
+/**
+ * Check if debug mode is enabled via environment variable
+ */
+export declare function isDebugEnabled(): boolean;
+/**
+ * Check if verbose logging should be suppressed.
+ *
+ * Logs are suppressed if:
+ * - In test environment AND
+ * - TASK_MCP_DEBUG is not set AND
+ * - TASK_MCP_TEST_VERBOSE is not set
+ *
+ * Set TASK_MCP_TEST_VERBOSE=true to enable logs in specific tests.
+ */
+export declare function shouldSuppressLogs(): boolean;
+//# sourceMappingURL=env.d.ts.map

package/dist/utils/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/utils/env.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAOnC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAGxC;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAK5C"}

package/dist/utils/env.js

@@ -0,0 +1,40 @@
+/**
+ * Environment detection utilities
+ */
+/**
+ * Check if running in test environment.
+ * Detects: NODE_ENV=test, BUN_TEST (set by bun test), VITEST, JEST_WORKER_ID
+ */
+export function isTestEnv() {
+    return (process.env.NODE_ENV === "test" ||
+        process.env["BUN_TEST"] !== undefined ||
+        process.env["VITEST"] !== undefined ||
+        process.env["JEST_WORKER_ID"] !== undefined);
+}
+/**
+ * Check if debug mode is enabled via environment variable
+ */
+export function isDebugEnabled() {
+    const debugEnv = process.env["TASK_MCP_DEBUG"];
+    return debugEnv === "true" || debugEnv === "1";
+}
+/**
+ * Check if verbose logging should be suppressed.
+ *
+ * Logs are suppressed if:
+ * - In test environment AND
+ * - TASK_MCP_DEBUG is not set AND
+ * - TASK_MCP_TEST_VERBOSE is not set
+ *
+ * Set TASK_MCP_TEST_VERBOSE=true to enable logs in specific tests.
+ */
+export function shouldSuppressLogs() {
+    if (!isTestEnv())
+        return false;
+    if (isDebugEnabled())
+        return false;
+    if (process.env["TASK_MCP_TEST_VERBOSE"] === "true")
+        return false;
+    return true;
+}
+//# sourceMappingURL=env.js.map

package/dist/utils/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/utils/env.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM;QAC/B,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,SAAS;QACrC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,SAAS;QACnC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,SAAS,CAC5C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC/C,OAAO,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,GAAG,CAAC;AACjD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC,SAAS,EAAE;QAAE,OAAO,KAAK,CAAC;IAC/B,IAAI,cAAc,EAAE;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAClE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/hierarchy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hierarchy.d.ts","sourceRoot":"","sources":["../../src/utils/hierarchy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA6BlE;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAU/E;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BtE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAyBxE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,CAEnE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAiBtE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,IAAI,EAAE,EACb,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,GAAE,MAAgC,GACzC,YAAY,EAAE,CAkDhB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3D,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,gBAAgB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,yBAAyB,CAsC1E"}
+{"version":3,"file":"hierarchy.d.ts","sourceRoot":"","sources":["../../src/utils/hierarchy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAG/C;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA+BlE;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAU/E;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BtE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAyBxE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,CAEnE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAiBtE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,IAAI,EAAE,EACb,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,GAAE,MAAgC,GACzC,YAAY,EAAE,CAmDhB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3D,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,gBAAgB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,yBAAyB,CAsC1E"}

package/dist/utils/hierarchy.js

@@ -1,3 +1,4 @@
+import { shouldSuppressLogs } from "./env.js";
 /**
  * Maximum allowed hierarchy depth (0-indexed)
  * 0 = root task
@@ -28,7 +29,9 @@ export function getTaskLevel(tasks, taskId) {
     while (currentTask.parentId) {
         const parent = taskMap.get(currentTask.parentId);
         if (!parent) {
-            console.warn(`[task-mcp] Orphaned parent reference: task "${currentTask.id}" references non-existent parent "${currentTask.parentId}"`);
+            if (!shouldSuppressLogs()) {
+                console.warn(`[task-mcp] Detached parent reference: task "${currentTask.id}" references non-existent parent "${currentTask.parentId}"`);
+            }
             break;
         }
         level++;
@@ -186,8 +189,9 @@ export function buildTaskTree(tasks, rootId, maxDepth = MAX_HIERARCHY_DEPTH + 1)
         }
         return [buildNode(rootTask, 0, new Set())];
     }
-    // Return all root tasks (no parent)
-    const rootTasks = tasks.filter((t) => !t.parentId);
+    // Return all root tasks (no parent OR parent not in filtered tasks)
+    // This ensures orphaned subtasks (whose parent was filtered out) are still visible
+    const rootTasks = tasks.filter((t) => !t.parentId || !taskMap.has(t.parentId));
     return rootTasks.map((task) => buildNode(task, 0, new Set()));
 }
 /**