vikunja-mcp-ng 0.4.0

package/dist/tools/tasks/filtering/evaluators.js

@@ -0,0 +1,224 @@
+"use strict";
+/**
+ * Filter evaluation functions for tasks
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateCondition = evaluateCondition;
+exports.evaluateComparison = evaluateComparison;
+exports.evaluateDateComparison = evaluateDateComparison;
+exports.parseRelativeDate = parseRelativeDate;
+exports.evaluateStringComparison = evaluateStringComparison;
+exports.evaluateArrayComparison = evaluateArrayComparison;
+exports.evaluateGroup = evaluateGroup;
+exports.applyFilter = applyFilter;
+/**
+ * Evaluates a filter condition against a task
+ */
+function evaluateCondition(task, condition) {
+    const { field, operator, value } = condition;
+    switch (field) {
+        case 'done':
+            return evaluateComparison(task.done, operator, value === true || value === 'true');
+        case 'priority':
+            return evaluateComparison(task.priority || 0, operator, Number(value));
+        case 'percentDone':
+            return evaluateComparison(task.percent_done || 0, operator, Number(value));
+        case 'dueDate':
+            if (!task.due_date) {
+                // Null due dates are only matched by != operator
+                return operator === '!=';
+            }
+            return evaluateDateComparison(task.due_date, operator, String(value));
+        case 'startDate': {
+            // Vikunja returns '0001-01-01T00:00:00Z' for unset dates instead of null.
+            const sd = task.start_date;
+            const isUnset = !sd || sd.startsWith('0001-');
+            if (isUnset)
+                return operator === '!=';
+            return evaluateDateComparison(sd, operator, String(value));
+        }
+        case 'endDate': {
+            const ed = task.end_date;
+            const isUnset = !ed || ed.startsWith('0001-');
+            if (isUnset)
+                return operator === '!=';
+            return evaluateDateComparison(ed, operator, String(value));
+        }
+        case 'doneAt': {
+            const da = task.done_at;
+            const isUnset = !da || da.startsWith('0001-');
+            if (isUnset)
+                return operator === '!=';
+            return evaluateDateComparison(da, operator, String(value));
+        }
+        case 'project':
+            return evaluateComparison(task.project_id || 0, operator, Number(value));
+        case 'created':
+            if (!task.created)
+                return false;
+            return evaluateDateComparison(task.created, operator, String(value));
+        case 'updated':
+            if (!task.updated)
+                return false;
+            return evaluateDateComparison(task.updated, operator, String(value));
+        case 'title':
+            return evaluateStringComparison(task.title ?? '', operator, String(value));
+        case 'description':
+            return evaluateStringComparison(task.description || '', operator, String(value));
+        case 'assignees':
+            return evaluateArrayComparison(task.assignees?.map((a) => a.id).filter((id) => id !== undefined) || [], operator, Array.isArray(value) ? value.map((v) => Number(v)) : [Number(value)]);
+        case 'labels':
+            return evaluateArrayComparison(task.labels?.map((l) => l.id).filter((id) => id !== undefined) || [], operator, Array.isArray(value) ? value.map((v) => Number(v)) : [Number(value)]);
+        default:
+            return false;
+    }
+}
+/**
+ * Evaluates comparison operators
+ */
+function evaluateComparison(actual, operator, expected) {
+    switch (operator) {
+        case '=':
+            return actual === expected;
+        case '!=':
+            return actual !== expected;
+        case '>':
+            return Number(actual) > Number(expected);
+        case '>=':
+            return Number(actual) >= Number(expected);
+        case '<':
+            return Number(actual) < Number(expected);
+        case '<=':
+            return Number(actual) <= Number(expected);
+        default:
+            return false;
+    }
+}
+/**
+ * Evaluates date comparisons (supports relative dates like "now+7d")
+ */
+function evaluateDateComparison(actual, operator, expected) {
+    const actualDate = new Date(actual);
+    const expectedDate = parseRelativeDate(expected);
+    if (!expectedDate)
+        return false;
+    switch (operator) {
+        case '=':
+            // For date equality, compare only the date part
+            return actualDate.toDateString() === expectedDate.toDateString();
+        case '!=':
+            return actualDate.toDateString() !== expectedDate.toDateString();
+        case '>':
+            return actualDate > expectedDate;
+        case '>=':
+            return actualDate >= expectedDate;
+        case '<':
+            return actualDate < expectedDate;
+        case '<=':
+            return actualDate <= expectedDate;
+        default:
+            return false;
+    }
+}
+/**
+ * Parses relative date strings (e.g., "now+7d", "now-1w")
+ */
+function parseRelativeDate(dateStr) {
+    // ISO date format
+    if (/^\d{4}-\d{2}-\d{2}/.test(dateStr)) {
+        return new Date(dateStr);
+    }
+    // Relative date format
+    const relativeMatch = dateStr.match(/^now([+-]\d+)([smhdwMy])?$/);
+    if (relativeMatch && relativeMatch[1]) {
+        const amount = parseInt(relativeMatch[1]);
+        const unit = relativeMatch[2] || 'd';
+        const now = new Date();
+        switch (unit) {
+            case 's':
+                now.setSeconds(now.getSeconds() + amount);
+                break;
+            case 'm':
+                now.setMinutes(now.getMinutes() + amount);
+                break;
+            case 'h':
+                now.setHours(now.getHours() + amount);
+                break;
+            case 'd':
+                now.setDate(now.getDate() + amount);
+                break;
+            case 'w':
+                now.setDate(now.getDate() + amount * 7);
+                break;
+            case 'M':
+                now.setMonth(now.getMonth() + amount);
+                break;
+            case 'y':
+                now.setFullYear(now.getFullYear() + amount);
+                break;
+        }
+        return now;
+    }
+    // "now" without offset
+    if (dateStr === 'now') {
+        return new Date();
+    }
+    return null;
+}
+/**
+ * Evaluates string comparisons
+ */
+function evaluateStringComparison(actual, operator, expected) {
+    switch (operator) {
+        case '=':
+            return actual === expected;
+        case '!=':
+            return actual !== expected;
+        case 'like':
+            // Simple pattern matching - case insensitive
+            return actual.toLowerCase().includes(expected.toLowerCase());
+        default:
+            return false;
+    }
+}
+/**
+ * Evaluates array comparisons (for assignees and labels)
+ */
+function evaluateArrayComparison(actual, operator, expected) {
+    switch (operator) {
+        case 'in':
+            // Check if any expected value is in the actual array
+            return expected.some((e) => actual.includes(e));
+        case 'not in':
+            // Check if none of the expected values are in the actual array
+            return !expected.some((e) => actual.includes(e));
+        default:
+            return false;
+    }
+}
+/**
+ * Evaluates a filter group against a task
+ */
+function evaluateGroup(task, group) {
+    if (group.operator === '&&') {
+        return group.conditions.every((condition) => evaluateCondition(task, condition));
+    }
+    else {
+        return group.conditions.some((condition) => evaluateCondition(task, condition));
+    }
+}
+/**
+ * Applies a filter expression to a list of tasks
+ */
+function applyFilter(tasks, expression) {
+    return tasks.filter((task) => {
+        const groupOperator = expression.operator || '&&';
+        if (groupOperator === '&&') {
+            return expression.groups.every((group) => evaluateGroup(task, group));
+        }
+        else {
+            return expression.groups.some((group) => evaluateGroup(task, group));
+        }
+    });
+}
+//# sourceMappingURL=evaluators.js.map

package/dist/tools/tasks/filtering/evaluators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluators.js","sourceRoot":"","sources":["../../../../src/tools/tasks/filtering/evaluators.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAWH,8CA4EC;AAKD,gDAiBC;AAKD,wDAuBC;AAKD,8CA8CC;AAKD,4DAYC;AAKD,0DAWC;AAKD,sCAMC;AAKD,kCAUC;AA/OD;;GAEG;AACH,SAAgB,iBAAiB,CAAC,IAAU,EAAE,SAA0B;IACtE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC;IAE7C,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,MAAM;YACT,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC,CAAC;QAErF,KAAK,UAAU;YACb,OAAO,kBAAkB,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAEzE,KAAK,aAAa;YAChB,OAAO,kBAAkB,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAE7E,KAAK,SAAS;YACZ,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACnB,iDAAiD;gBACjD,OAAO,QAAQ,KAAK,IAAI,CAAC;YAC3B,CAAC;YACD,OAAO,sBAAsB,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAExE,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,0EAA0E;YAC1E,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;YAC3B,MAAM,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAC9C,IAAI,OAAO;gBAAE,OAAO,QAAQ,KAAK,IAAI,CAAC;YACtC,OAAO,sBAAsB,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7D,CAAC;QAED,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;YACzB,MAAM,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAC9C,IAAI,OAAO;gBAAE,OAAO,QAAQ,KAAK,IAAI,CAAC;YACtC,OAAO,sBAAsB,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7D,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;YACxB,MAAM,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAC9C,IAAI,OAAO;gBAAE,OAAO,QAAQ,KAAK,IAAI,CAAC;YACtC,OAAO,sBAAsB,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7D,CAAC;QAED,KAAK,SAAS;YACZ,OAAO,kBAAkB,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAE3E,KAAK,SAAS;YACZ,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,OAAO,KAAK,CAAC;YAChC,OAAO,sBAAsB,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAEvE,KAAK,SAAS;YACZ,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,OAAO,KAAK,CAAC;YAChC,OAAO,sBAAsB,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAEvE,KAAK,OAAO;YACV,OAAO,wBAAwB,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAE7E,KAAK,aAAa;YAChB,OAAO,wBAAwB,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAEnF,KAAK,WAAW;YACd,OAAO,uBAAuB,CAC5B,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,IAAI,EAAE,EACrF,QAAQ,EACR,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CACrE,CAAC;QAEJ,KAAK,QAAQ;YACX,OAAO,uBAAuB,CAC5B,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,IAAI,EAAE,EAClF,QAAQ,EACR,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CACrE,CAAC;QAEJ;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,MAAe,EAAE,QAAgB,EAAE,QAAiB;IACrF,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,GAAG;YACN,OAAO,MAAM,KAAK,QAAQ,CAAC;QAC7B,KAAK,IAAI;YACP,OAAO,MAAM,KAAK,QAAQ,CAAC;QAC7B,KAAK,GAAG;YACN,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC3C,KAAK,IAAI;YACP,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5C,KAAK,GAAG;YACN,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC3C,KAAK,IAAI;YACP,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5C;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,MAAc,EAAE,QAAgB,EAAE,QAAgB;IACvF,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,YAAY,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAEjD,IAAI,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IAEhC,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,GAAG;YACN,gDAAgD;YAChD,OAAO,UAAU,CAAC,YAAY,EAAE,KAAK,YAAY,CAAC,YAAY,EAAE,CAAC;QACnE,KAAK,IAAI;YACP,OAAO,UAAU,CAAC,YAAY,EAAE,KAAK,YAAY,CAAC,YAAY,EAAE,CAAC;QACnE,KAAK,GAAG;YACN,OAAO,UAAU,GAAG,YAAY,CAAC;QACnC,KAAK,IAAI;YACP,OAAO,UAAU,IAAI,YAAY,CAAC;QACpC,KAAK,GAAG;YACN,OAAO,UAAU,GAAG,YAAY,CAAC;QACnC,KAAK,IAAI;YACP,OAAO,UAAU,IAAI,YAAY,CAAC;QACpC;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,OAAe;IAC/C,kBAAkB;IAClB,IAAI,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,uBAAuB;IACvB,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAClE,IAAI,aAAa,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QAEvB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,GAAG;gBACN,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,CAAC;gBAC1C,MAAM;YACR,KAAK,GAAG;gBACN,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,CAAC;gBAC1C,MAAM;YACR,KAAK,GAAG;gBACN,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,MAAM,CAAC,CAAC;gBACtC,MAAM;YACR,KAAK,GAAG;gBACN,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC;gBACpC,MAAM;YACR,KAAK,GAAG;gBACN,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC;gBACxC,MAAM;YACR,KAAK,GAAG;gBACN,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,MAAM,CAAC,CAAC;gBACtC,MAAM;YACR,KAAK,GAAG;gBACN,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,CAAC;gBAC5C,MAAM;QACV,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED,uBAAuB;IACvB,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACtB,OAAO,IAAI,IAAI,EAAE,CAAC;IACpB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAgB,wBAAwB,CAAC,MAAc,EAAE,QAAgB,EAAE,QAAgB;IACzF,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,GAAG;YACN,OAAO,MAAM,KAAK,QAAQ,CAAC;QAC7B,KAAK,IAAI;YACP,OAAO,MAAM,KAAK,QAAQ,CAAC;QAC7B,KAAK,MAAM;YACT,6CAA6C;YAC7C,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/D;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB,CAAC,MAAgB,EAAE,QAAgB,EAAE,QAAkB;IAC5F,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,IAAI;YACP,qDAAqD;YACrD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,KAAK,QAAQ;YACX,+DAA+D;YAC/D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,IAAU,EAAE,KAAkB;IAC1D,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IACnF,CAAC;SAAM,CAAC;QACN,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,KAAa,EAAE,UAA4B;IACrE,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,MAAM,aAAa,GAAG,UAAU,CAAC,QAAQ,IAAI,IAAI,CAAC;QAElD,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACxE,CAAC;aAAM,CAAC;YACN,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACvE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/tasks/filtering/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Task Filtering Module
+ * Provides comprehensive filtering capabilities for task operations
+ */
+export { TaskFilteringOrchestrator } from './TaskFilteringOrchestrator';
+export { FilterValidator } from './FilterValidator';
+export { FilterExecutor } from './FilterExecutor';
+export { evaluateCondition, evaluateComparison, evaluateDateComparison, parseRelativeDate, evaluateStringComparison, evaluateArrayComparison, evaluateGroup, applyFilter } from './evaluators';
+export type { TaskListingArgs, TaskFilteringParams, TaskFilteringResult, TaskFilterValidationConfig, TaskFilteringContext, TaskFilterExecutionResult, TaskFilterStorage } from '../types/filters';
+export type { FilterExpression, FilterValidationResult, SavedFilter } from '../../../types/filters';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/tasks/filtering/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/tasks/filtering/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAGxE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB,EACvB,aAAa,EACb,WAAW,EACZ,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,oBAAoB,EACpB,yBAAyB,EACzB,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACZ,MAAM,wBAAwB,CAAC"}

package/dist/tools/tasks/filtering/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Task Filtering Module
+ * Provides comprehensive filtering capabilities for task operations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyFilter = exports.evaluateGroup = exports.evaluateArrayComparison = exports.evaluateStringComparison = exports.parseRelativeDate = exports.evaluateDateComparison = exports.evaluateComparison = exports.evaluateCondition = exports.FilterExecutor = exports.FilterValidator = exports.TaskFilteringOrchestrator = void 0;
+// Main orchestrator
+var TaskFilteringOrchestrator_1 = require("./TaskFilteringOrchestrator");
+Object.defineProperty(exports, "TaskFilteringOrchestrator", { enumerable: true, get: function () { return TaskFilteringOrchestrator_1.TaskFilteringOrchestrator; } });
+// Core components
+var FilterValidator_1 = require("./FilterValidator");
+Object.defineProperty(exports, "FilterValidator", { enumerable: true, get: function () { return FilterValidator_1.FilterValidator; } });
+var FilterExecutor_1 = require("./FilterExecutor");
+Object.defineProperty(exports, "FilterExecutor", { enumerable: true, get: function () { return FilterExecutor_1.FilterExecutor; } });
+// Filter evaluators (moved from original filters.ts)
+var evaluators_1 = require("./evaluators");
+Object.defineProperty(exports, "evaluateCondition", { enumerable: true, get: function () { return evaluators_1.evaluateCondition; } });
+Object.defineProperty(exports, "evaluateComparison", { enumerable: true, get: function () { return evaluators_1.evaluateComparison; } });
+Object.defineProperty(exports, "evaluateDateComparison", { enumerable: true, get: function () { return evaluators_1.evaluateDateComparison; } });
+Object.defineProperty(exports, "parseRelativeDate", { enumerable: true, get: function () { return evaluators_1.parseRelativeDate; } });
+Object.defineProperty(exports, "evaluateStringComparison", { enumerable: true, get: function () { return evaluators_1.evaluateStringComparison; } });
+Object.defineProperty(exports, "evaluateArrayComparison", { enumerable: true, get: function () { return evaluators_1.evaluateArrayComparison; } });
+Object.defineProperty(exports, "evaluateGroup", { enumerable: true, get: function () { return evaluators_1.evaluateGroup; } });
+Object.defineProperty(exports, "applyFilter", { enumerable: true, get: function () { return evaluators_1.applyFilter; } });
+//# sourceMappingURL=index.js.map

package/dist/tools/tasks/filtering/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/tasks/filtering/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,oBAAoB;AACpB,yEAAwE;AAA/D,sIAAA,yBAAyB,OAAA;AAElC,kBAAkB;AAClB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAEvB,qDAAqD;AACrD,2CASsB;AARpB,+GAAA,iBAAiB,OAAA;AACjB,gHAAA,kBAAkB,OAAA;AAClB,oHAAA,sBAAsB,OAAA;AACtB,+GAAA,iBAAiB,OAAA;AACjB,sHAAA,wBAAwB,OAAA;AACxB,qHAAA,uBAAuB,OAAA;AACvB,2GAAA,aAAa,OAAA;AACb,yGAAA,WAAW,OAAA"}

package/dist/tools/tasks/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tasks Tool
+ * Handles task operations for Vikunja
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AuthManager } from '../../auth/AuthManager';
+import type { VikunjaClientFactory } from '../../client/VikunjaClientFactory';
+export declare function registerTasksTool(server: McpServer, authManager: AuthManager, clientFactory?: VikunjaClientFactory): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/tasks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/tasks/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAuH9E,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,WAAW,EACxB,aAAa,CAAC,EAAE,oBAAoB,GACnC,IAAI,CA0SN"}

package/dist/tools/tasks/index.js

@@ -0,0 +1,337 @@
+"use strict";
+/**
+ * Tasks Tool
+ * Handles task operations for Vikunja
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTasksTool = registerTasksTool;
+const zod_1 = require("zod");
+const types_1 = require("../../types");
+const client_1 = require("../../client");
+const logger_1 = require("../../utils/logger");
+const storage_1 = require("../../storage");
+const tasks_relations_1 = require("../tasks-relations");
+const filtering_1 = require("./filtering");
+const error_handler_1 = require("../../utils/error-handler");
+const response_factory_1 = require("../../utils/response-factory");
+const read_only_1 = require("../../utils/read-only");
+// Import all operation handlers
+const crud_1 = require("./crud");
+const bulk_operations_1 = require("./bulk-operations");
+const assignees_1 = require("./assignees");
+const comments_1 = require("./comments");
+const reminders_1 = require("./reminders");
+const labels_1 = require("./labels");
+const attach_1 = require("./attach");
+const attachments_1 = require("./attachments");
+const buckets_1 = require("./buckets");
+const position_1 = require("./position");
+const by_index_1 = require("./by-index");
+const subtasks_1 = require("./subtasks");
+const duplicate_1 = require("./duplicate");
+const mark_read_1 = require("./mark-read");
+/**
+ * Get session-scoped storage instance
+ */
+async function getSessionStorage(authManager) {
+    const session = authManager.getSession();
+    const sessionId = session.apiToken ? `${session.apiUrl}:${session.apiToken.substring(0, 8)}` : 'anonymous';
+    return storage_1.storageManager.getStorage(sessionId, session.userId, session.apiUrl);
+}
+/**
+ * List tasks with optional filtering
+ */
+async function listTasks(args, storage, authManager) {
+    try {
+        // Execute the complete filtering workflow using the orchestrator.
+        // authManager is threaded through for cross-project listing's
+        // direct-REST GET /tasks strategy (RestCrossProjectFilteringStrategy).
+        const filteringResult = await filtering_1.TaskFilteringOrchestrator.executeTaskFiltering(args, storage, {}, authManager);
+        // Determine filtering method message
+        let filteringMessage = '';
+        if (args.filter) {
+            if (filteringResult.metadata?.serverSideFilteringUsed) {
+                filteringMessage = ' (filtered server-side)';
+            }
+            else if (filteringResult.metadata?.serverSideFilteringAttempted) {
+                filteringMessage = ' (filtered client-side - server-side fallback)';
+            }
+            else {
+                filteringMessage = ' (filtered client-side)';
+            }
+        }
+        const taskCount = filteringResult.tasks?.length || 0;
+        const response = (0, crud_1.createTaskResponse)('list-tasks', `Found ${taskCount} tasks${filteringMessage}`, { tasks: filteringResult.tasks || [] }, {
+            timestamp: new Date().toISOString(),
+            count: taskCount,
+            ...(filteringResult.metadata || {}),
+        }, undefined, // verbosity (ignored - using standard AORP)
+        undefined, // useOptimizedFormat (ignored - using standard AORP)
+        undefined, // useAorp (ignored - always using AORP)
+        undefined, // aorpConfig (using auto-generated)
+        args.sessionId);
+        logger_1.logger.debug('Tasks tool response', { subcommand: 'list', itemCount: taskCount });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: (0, response_factory_1.formatAorpAsMarkdown)(response.response),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        if (error instanceof types_1.MCPError) {
+            throw error;
+        }
+        // Log the full error for debugging filter issues
+        logger_1.logger.error('Task list error:', {
+            error: error instanceof Error ? error.message : String(error),
+            filter: args.filter,
+            filterId: args.filterId,
+        });
+        throw (0, error_handler_1.handleFetchError)(error, 'list tasks');
+    }
+}
+function registerTasksTool(server, authManager, clientFactory) {
+    server.tool('vikunja_tasks', (0, read_only_1.withReadOnlyNote)('vikunja_tasks', 'Manage tasks with comprehensive operations (create, update, delete, list, assign, attach/list/delete files, comment, bulk operations, set Kanban bucket, set position, lookup by per-project index, create/list subtasks, duplicate, mark-read). ' +
+        'download-attachment cannot deliver file bytes through MCP (no binary channel) — it returns the direct download URL and auth guidance instead. ' +
+        'create-subtask is a composite (resolve parent -> create task -> relate -> verify) with opt-in atomic rollback via `atomic: true` (default best-effort — see docs/ENDPOINT-PLAYBOOK.md §5). ' +
+        'duplicate copies a task (labels, assignees, attachments, reminders) into the same project (PUT /tasks/{taskID}/duplicate, no body). ' +
+        'mark-read removes the current unread status entry for a task (POST /tasks/{projecttask}/read).'), {
+        subcommand: zod_1.z.enum([
+            'create',
+            'get',
+            'update',
+            'delete',
+            'list',
+            'assign',
+            'unassign',
+            'list-assignees',
+            'attach',
+            'list-attachments',
+            'get-attachment-info',
+            'delete-attachment',
+            'download-attachment',
+            'comment',
+            'bulk-create',
+            'bulk-update',
+            'bulk-delete',
+            'relate',
+            'unrelate',
+            'relations',
+            'add-reminder',
+            'remove-reminder',
+            'list-reminders',
+            'apply-label',
+            'remove-label',
+            'list-labels',
+            'set-bucket',
+            'set-position',
+            'get-by-index',
+            'create-subtask',
+            'list-subtasks',
+            'duplicate',
+            'mark-read',
+        ]),
+        // Task creation/update fields
+        title: zod_1.z.string().optional(),
+        description: zod_1.z.string().optional(),
+        projectId: zod_1.z.number().optional(),
+        dueDate: zod_1.z.string().optional(),
+        startDate: zod_1.z.string().optional(),
+        endDate: zod_1.z.string().optional(),
+        priority: zod_1.z.number().min(0).max(5).optional(),
+        percentDone: zod_1.z.number().min(0).max(1).optional(),
+        labels: zod_1.z.array(zod_1.z.number()).optional(),
+        assignees: zod_1.z.array(zod_1.z.number()).optional(),
+        // Kanban bucket fields (set-bucket subcommand).
+        // z.coerce tolerates MCP clients whose cached tool schema predates
+        // these params and therefore send them as strings over JSON-RPC.
+        bucketId: zod_1.z.coerce.number().optional(),
+        viewId: zod_1.z.coerce.number().optional(),
+        // Task position fields (set-position subcommand). position is a
+        // float64 per the API (see models.TaskPosition) - see docs on
+        // spreading tasks between two positions - so it is not coerced to an
+        // integer. projectViewId is auto-resolved from projectId + viewKind
+        // when omitted, mirroring set-bucket's resolve-by-name friendliness.
+        position: zod_1.z.coerce.number().optional(),
+        projectViewId: zod_1.z.coerce.number().optional(),
+        viewKind: zod_1.z.enum(['list', 'gantt', 'table', 'kanban']).optional(),
+        // By-index lookup field (get-by-index subcommand): the task's
+        // human-facing per-project index (e.g. the "42" in "PROJ-42").
+        index: zod_1.z.coerce.number().optional(),
+        // Recurring task fields
+        repeatAfter: zod_1.z.number().min(0).optional(),
+        repeatMode: zod_1.z.enum(['day', 'week', 'month', 'year']).optional(),
+        // Query fields
+        id: zod_1.z.number().optional(),
+        filter: zod_1.z.string().optional(),
+        filterId: zod_1.z.string().optional(),
+        page: zod_1.z.number().optional(),
+        perPage: zod_1.z.number().optional(),
+        sort: zod_1.z.string().optional(),
+        search: zod_1.z.string().optional(),
+        // List specific filters
+        allProjects: zod_1.z.boolean().optional(),
+        done: zod_1.z.boolean().optional(),
+        // GET /tasks query params honored for cross-project listing (direct
+        // REST — see RestCrossProjectFilteringStrategy). Single-project
+        // listing (ClientSideFilteringStrategy/ServerSideFilteringStrategy)
+        // calls GET /projects/{id}/tasks, which never supported these extra
+        // params, so they are silently unused in that case.
+        orderBy: zod_1.z.enum(['asc', 'desc']).optional(),
+        filterTimezone: zod_1.z.string().optional(),
+        filterIncludeNulls: zod_1.z.boolean().optional(),
+        expand: zod_1.z.array(zod_1.z.enum(['subtasks', 'buckets', 'reactions', 'comments'])).optional(),
+        // Comment fields
+        comment: zod_1.z.string().optional(),
+        commentId: zod_1.z.number().optional(),
+        // Bulk operation fields
+        taskIds: zod_1.z.array(zod_1.z.number()).optional(),
+        field: zod_1.z.string().optional(),
+        value: zod_1.z.unknown().optional(),
+        tasks: zod_1.z
+            .array(zod_1.z.object({
+            title: zod_1.z.string(),
+            description: zod_1.z.string().optional(),
+            dueDate: zod_1.z.string().optional(),
+            startDate: zod_1.z.string().optional(),
+            endDate: zod_1.z.string().optional(),
+            priority: zod_1.z.number().min(0).max(5).optional(),
+            labels: zod_1.z.array(zod_1.z.number()).optional(),
+            assignees: zod_1.z.array(zod_1.z.number()).optional(),
+            repeatAfter: zod_1.z.number().min(0).optional(),
+            repeatMode: zod_1.z.enum(['day', 'week', 'month', 'year']).optional(),
+        }))
+            .optional(),
+        // Reminder fields
+        reminderDate: zod_1.z.string().optional(),
+        // Vikunja's API has no reminder id — remove-reminder identifies the
+        // reminder to remove by its reminderDate string and/or its zero-based
+        // reminderIndex, both shown by list-reminders.
+        reminderIndex: zod_1.z.number().optional(),
+        // Attach subcommand fields (filePath, fileContent, filename)
+        ...attach_1.attachSchemaFields,
+        // Attachments read-side fields (list-attachments, get-attachment-info,
+        // delete-attachment, download-attachment). page/perPage are shared
+        // with the generic query fields above.
+        attachmentId: zod_1.z.number().optional(),
+        previewSize: zod_1.z.enum(['sm', 'md', 'lg', 'xl']).optional(),
+        // Add relation schema
+        ...tasks_relations_1.relationSchema,
+        // Subtask composite fields (create-subtask). title/description/dueDate/
+        // priority/labels/assignees/bucketId are shared with the generic
+        // create/set-bucket fields above.
+        parentTaskId: zod_1.z.number().optional(),
+        // Opt into atomic rollback for create-subtask (default best-effort) —
+        // see docs/ENDPOINT-PLAYBOOK.md §5.
+        atomic: zod_1.z.boolean().optional(),
+        // Session ID for AORP response tracking
+        sessionId: zod_1.z.string().optional(),
+    }, (0, read_only_1.getToolAnnotations)('vikunja_tasks'), async (args) => {
+        try {
+            logger_1.logger.debug('Executing tasks tool', { subcommand: args.subcommand, args });
+            // Check authentication with enhanced error message
+            if (!authManager.isAuthenticated()) {
+                throw (0, error_handler_1.createAuthRequiredError)('access task management features');
+            }
+            // Global read-only safety mode gate. 'comment' is dual-purpose
+            // (creates a comment when text is supplied, otherwise lists
+            // comments — see handleComment) so its effective classification
+            // depends on whether `comment` text was actually provided.
+            (0, read_only_1.assertWriteAllowed)('vikunja_tasks', args.subcommand, args.subcommand === 'comment' ? (args.comment ? 'write' : 'read') : undefined);
+            // Set the client factory for this request if provided
+            if (clientFactory) {
+                await (0, client_1.setGlobalClientFactory)(clientFactory);
+            }
+            // Test client connection
+            await (0, client_1.getAuthManagerFromContext)();
+            switch (args.subcommand) {
+                case 'list': {
+                    // Get session-scoped storage for filter operations (only when needed)
+                    const storage = await getSessionStorage(authManager);
+                    return listTasks(args, storage, authManager);
+                }
+                case 'create':
+                    return (0, crud_1.createTask)(args, authManager);
+                case 'get':
+                    return (0, crud_1.getTask)(args, authManager);
+                case 'update':
+                    return (0, crud_1.updateTask)(args, authManager);
+                case 'delete':
+                    return (0, crud_1.deleteTask)(args, authManager);
+                case 'assign':
+                    return (0, assignees_1.assignUsers)(args, authManager);
+                case 'unassign':
+                    return (0, assignees_1.unassignUsers)(args, authManager);
+                case 'list-assignees':
+                    return (0, assignees_1.listAssignees)(args, authManager);
+                case 'comment':
+                    return (0, comments_1.handleComment)(args, authManager);
+                case 'attach':
+                    return (0, attach_1.handleAttach)(args, authManager);
+                case 'list-attachments':
+                    return (0, attachments_1.listAttachments)(args, authManager);
+                case 'get-attachment-info':
+                    return (0, attachments_1.getAttachmentInfo)(args, authManager);
+                case 'delete-attachment':
+                    return (0, attachments_1.deleteAttachment)(args, authManager);
+                case 'download-attachment':
+                    return (0, attachments_1.downloadAttachment)(args, authManager);
+                case 'bulk-update':
+                    return (0, bulk_operations_1.bulkUpdateTasks)(args, authManager);
+                case 'bulk-delete':
+                    return (0, bulk_operations_1.bulkDeleteTasks)(args, authManager);
+                case 'bulk-create':
+                    return (0, bulk_operations_1.bulkCreateTasks)(args, authManager);
+                // Handle relation subcommands
+                case 'relate':
+                case 'unrelate':
+                case 'relations':
+                    return (0, tasks_relations_1.handleRelationSubcommands)({
+                        subcommand: args.subcommand,
+                        id: args.id,
+                        otherTaskId: args.otherTaskId,
+                        relationKind: args.relationKind,
+                    }, authManager);
+                // Handle reminder operations
+                case 'add-reminder':
+                    return (0, reminders_1.addReminder)(args, authManager);
+                case 'remove-reminder':
+                    return (0, reminders_1.removeReminder)(args, authManager);
+                case 'list-reminders':
+                    return (0, reminders_1.listReminders)(args, authManager);
+                case 'apply-label':
+                    return (0, labels_1.applyLabels)(args, authManager);
+                case 'remove-label':
+                    return (0, labels_1.removeLabels)(args, authManager);
+                case 'list-labels':
+                    return (0, labels_1.listTaskLabels)(args, authManager);
+                case 'set-bucket':
+                    return (0, buckets_1.setTaskBucket)(args, authManager);
+                case 'set-position':
+                    return (0, position_1.setTaskPosition)(args, authManager);
+                case 'get-by-index':
+                    return (0, by_index_1.getTaskByIndex)(args, authManager);
+                case 'create-subtask':
+                    return (0, subtasks_1.createSubtask)(args, authManager);
+                case 'list-subtasks':
+                    return (0, subtasks_1.listSubtasks)(args, authManager);
+                case 'duplicate':
+                    return (0, duplicate_1.duplicateTask)(args, authManager);
+                case 'mark-read':
+                    return (0, mark_read_1.markTaskRead)(args, authManager);
+                default:
+                    throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Unknown subcommand: ${args.subcommand}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof types_1.MCPError) {
+                throw error;
+            }
+            throw new types_1.MCPError(types_1.ErrorCode.INTERNAL_ERROR, `Task operation error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    });
+}
+//# sourceMappingURL=index.js.map