vikunja-mcp-ng 0.4.0

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

@@ -0,0 +1,257 @@
+"use strict";
+/**
+ * Filter validation for task filtering operations
+ * Handles validation of filter expressions and task listing parameters
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilterValidator = void 0;
+const types_1 = require("../../../types");
+const filters_1 = require("../../../utils/filters");
+const memory_1 = require("../../../utils/memory");
+const logger_1 = require("../../../utils/logger");
+const constants_1 = require("../constants");
+const VALID_SORT_FIELD_SET = new Set(constants_1.VALID_SORT_FIELDS);
+/**
+ * Normalizes a `sort` argument (comma-separated `sort_by` field list) by
+ * translating this tool's camelCase field aliases to the API's snake_case
+ * names (`dueDate` -> `due_date`, mirroring `FILTER_FIELD_TO_API_FIELD`),
+ * then checks every resulting token against `VALID_SORT_FIELDS`.
+ *
+ * Without this, an unrecognized `sort_by` value is silently ignored by
+ * Vikunja (tasks come back in default order with no error) — exactly the
+ * "free-form field selector that silently no-ops" pattern this validation
+ * closes, per the field/enum allowlist ergonomics sweep.
+ */
+function normalizeAndValidateSort(sort) {
+    const invalidTokens = [];
+    const normalizedTokens = sort.split(',').map((rawToken) => {
+        const token = rawToken.trim();
+        const apiField = constants_1.SORT_FIELD_ALIASES[token] ?? token;
+        if (!VALID_SORT_FIELD_SET.has(apiField)) {
+            invalidTokens.push(token);
+        }
+        return apiField;
+    });
+    return { normalized: normalizedTokens.join(','), invalidTokens };
+}
+/**
+ * Validates filter parameters for task listing operations
+ */
+exports.FilterValidator = {
+    /**
+     * Validates and processes filter string or filter ID
+     */
+    async validateAndParseFilter(args, storage) {
+        let filterExpression = null;
+        let filterString;
+        const validationWarnings = [];
+        try {
+            // Resolve the user-supplied filter - either a direct filter string or a
+            // saved filter referenced by id.
+            let userFilter;
+            if (args.filterId) {
+                const savedFilter = await storage.get(args.filterId);
+                if (!savedFilter) {
+                    throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Filter with id ${args.filterId} not found`);
+                }
+                userFilter = savedFilter.filter;
+            }
+            else if (args.filter !== undefined) {
+                userFilter = args.filter;
+            }
+            // Parse the user-supplied filter into an expression.
+            if (userFilter) {
+                const parseResult = (0, filters_1.parseFilterString)(userFilter);
+                if (parseResult.error) {
+                    throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Invalid filter syntax: ${parseResult.error.message}${parseResult.error.context ? `\n${parseResult.error.context}` : ''}`);
+                }
+                filterExpression = parseResult.expression;
+            }
+            // Fold the `done` flag into the filter expression so it is applied
+            // server-side (before pagination) rather than trimming an already
+            // paginated page. Without this, `done=false` scattered open tasks
+            // unpredictably across raw pages.
+            if (args.done !== undefined) {
+                const doneGroup = {
+                    conditions: [{ field: 'done', operator: '=', value: args.done }],
+                    operator: '&&',
+                };
+                if (!filterExpression) {
+                    filterExpression = { groups: [doneGroup] };
+                }
+                else if (filterExpression.groups.length === 1) {
+                    // Single user group: AND `done` on as a second group. The user's
+                    // group is parenthesised when serialised, so its own &&/|| operator
+                    // is preserved.
+                    filterExpression = {
+                        groups: [...filterExpression.groups, doneGroup],
+                        operator: '&&',
+                    };
+                }
+                // Multi-group user filter: left untouched - appending a group here
+                // could change group-join semantics. `done` is still enforced by
+                // FilterExecutor.applyPostProcessingFilters in that case.
+            }
+            // Serialise the final expression for Vikunja's server-side `filter`
+            // query param. When `done` was not folded in, keep the user's original
+            // string verbatim.
+            if (filterExpression) {
+                filterString =
+                    args.done === undefined ? userFilter : (0, filters_1.expressionToString)(filterExpression);
+            }
+            if (filterString) {
+                // Log that we're preparing to attempt hybrid filtering
+                logger_1.logger.info('Preparing hybrid filtering (server-side attempt + client-side fallback)', {
+                    filter: filterString,
+                });
+            }
+            return { filterExpression, filterString, validationWarnings };
+        }
+        catch (error) {
+            if (error instanceof types_1.MCPError) {
+                throw error;
+            }
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Filter validation failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    },
+    /**
+     * Validates pagination and memory constraints
+     */
+    validateMemoryConstraints(args, requestedPageSize) {
+        const warnings = [];
+        // Validate pagination limits for memory protection with enhanced analysis
+        const taskCountValidation = (0, memory_1.validateTaskCountLimit)(requestedPageSize, undefined, args.filter ? {
+            filterExpression: args.filter,
+            operationType: 'list'
+        } : undefined);
+        if (!taskCountValidation.allowed) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Task count limit exceeded. Requested: ${requestedPageSize}, Max allowed: ${taskCountValidation.maxAllowed}. ` +
+                `Estimated memory usage: ${taskCountValidation.estimatedMemoryMB}MB (risk: ${taskCountValidation.riskLevel}). ` +
+                'Reduce the perPage parameter, use pagination with smaller page sizes, or apply more specific filters.');
+        }
+        // Add warnings for large page sizes
+        if (requestedPageSize > 500) {
+            warnings.push(`Large page size (${requestedPageSize}) may impact performance. Consider using smaller pages or more specific filters.`);
+        }
+        // Include enhanced memory validation warnings
+        if (taskCountValidation.warnings.length > 0) {
+            warnings.push(...taskCountValidation.warnings);
+        }
+        return {
+            isValid: true,
+            warnings,
+            maxAllowed: taskCountValidation.maxAllowed
+        };
+    },
+    /**
+     * Validates the actual loaded task count against limits
+     */
+    validateLoadedTasks(actualTaskCount, sampleTask) {
+        const warnings = [];
+        const finalTaskCountValidation = (0, memory_1.validateTaskCountLimit)(actualTaskCount, sampleTask);
+        if (!finalTaskCountValidation.allowed) {
+            // Log warning but don't fail since tasks are already loaded
+            logger_1.logger.warn('Loaded task count exceeds recommended limits', {
+                actualCount: actualTaskCount,
+                maxRecommended: finalTaskCountValidation.maxAllowed,
+                estimatedMemoryMB: finalTaskCountValidation.estimatedMemoryMB,
+                riskLevel: finalTaskCountValidation.riskLevel
+            });
+            warnings.push(`Loaded ${actualTaskCount} tasks, which exceeds recommended limit of ${finalTaskCountValidation.maxAllowed}. ` +
+                `Estimated memory usage: ${finalTaskCountValidation.estimatedMemoryMB}MB (risk: ${finalTaskCountValidation.riskLevel}).`);
+            // For extremely large datasets, still enforce hard limits
+            if (actualTaskCount > finalTaskCountValidation.maxAllowed * 1.5) {
+                return {
+                    isValid: false,
+                    warnings,
+                    shouldThrow: true,
+                    riskLevel: finalTaskCountValidation.riskLevel,
+                    estimatedMemoryMB: finalTaskCountValidation.estimatedMemoryMB
+                };
+            }
+        }
+        // Include warnings from enhanced validation
+        if (finalTaskCountValidation.warnings.length > 0) {
+            warnings.push(...finalTaskCountValidation.warnings);
+        }
+        return {
+            isValid: true,
+            warnings,
+            shouldThrow: false,
+            riskLevel: finalTaskCountValidation.riskLevel,
+            estimatedMemoryMB: finalTaskCountValidation.estimatedMemoryMB
+        };
+    },
+    /**
+     * Validates task listing arguments
+     */
+    validateTaskListingArgs(args) {
+        const errors = [];
+        // Validate numeric parameters
+        if (args.page !== undefined && (args.page < 1 || !Number.isInteger(args.page))) {
+            errors.push('Page number must be a positive integer');
+        }
+        if (args.perPage !== undefined && (args.perPage < 1 || !Number.isInteger(args.perPage))) {
+            errors.push('Per page count must be a positive integer');
+        }
+        if (args.projectId !== undefined && (args.projectId < 1 || !Number.isInteger(args.projectId))) {
+            errors.push('Project ID must be a positive integer');
+        }
+        // Validate boolean parameters
+        if (args.done !== undefined && typeof args.done !== 'boolean') {
+            errors.push('Done parameter must be a boolean value');
+        }
+        // Validate string parameters
+        if (args.search !== undefined && typeof args.search !== 'string') {
+            errors.push('Search parameter must be a string');
+        }
+        if (args.sort !== undefined && typeof args.sort !== 'string') {
+            errors.push('Sort parameter must be a string');
+        }
+        else if (args.sort !== undefined && args.sort.trim() !== '') {
+            const { normalized, invalidTokens } = normalizeAndValidateSort(args.sort);
+            if (invalidTokens.length > 0) {
+                errors.push(`Invalid sort field(s): ${invalidTokens.join(', ')}. Valid fields: ${constants_1.VALID_SORT_FIELDS.join(', ')} ` +
+                    `(camelCase aliases also accepted: ${Object.keys(constants_1.SORT_FIELD_ALIASES).join(', ')})`);
+            }
+            else {
+                // Normalize in place so the corrected (snake_case) value is what
+                // actually reaches the API — validation runs before
+                // FilterExecutor.prepareQueryParameters reads args.sort.
+                args.sort = normalized;
+            }
+        }
+        if (args.filter !== undefined && typeof args.filter !== 'string') {
+            errors.push('Filter parameter must be a string');
+        }
+        if (args.filterId !== undefined && typeof args.filterId !== 'string') {
+            errors.push('Filter ID parameter must be a string');
+        }
+        return errors;
+    },
+    /**
+     * Performs comprehensive validation of task filtering parameters
+     */
+    async validateTaskFiltering(args, storage, _config = {}) {
+        const allWarnings = [];
+        // Validate basic arguments
+        const argValidationErrors = exports.FilterValidator.validateTaskListingArgs(args);
+        if (argValidationErrors.length > 0) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Invalid task listing arguments: ${argValidationErrors.join(', ')}`);
+        }
+        // Validate and parse filter
+        const filterValidation = await exports.FilterValidator.validateAndParseFilter(args, storage);
+        allWarnings.push(...filterValidation.validationWarnings);
+        // Validate memory constraints
+        const pageSize = args.perPage || 1000; // Default pagination
+        const memoryValidation = exports.FilterValidator.validateMemoryConstraints(args, pageSize);
+        allWarnings.push(...memoryValidation.warnings);
+        return {
+            filterExpression: filterValidation.filterExpression,
+            filterString: filterValidation.filterString,
+            validationWarnings: allWarnings,
+            memoryValidation
+        };
+    },
+};
+//# sourceMappingURL=FilterValidator.js.map

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

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

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

@@ -0,0 +1,78 @@
+/**
+ * Task Filtering Orchestrator
+ * Main service that coordinates all filtering operations for tasks
+ */
+import type { TaskListingArgs, TaskFilterExecutionResult } from '../types/filters';
+import type { FilterValidationConfig } from '../../../types/filters';
+import type { SimpleFilterStorage } from '../../../storage';
+import type { AuthManager } from '../../../auth/AuthManager';
+/**
+ * Main orchestrator for task filtering operations
+ * Coordinates validation, execution, and result processing
+ */
+export declare const TaskFilteringOrchestrator: {
+    /**
+     * Executes the complete task filtering workflow
+     *
+     * @param args - Task listing arguments including filters
+     * @param storage - Storage interface for saved filters
+     * @param config - Optional validation configuration
+     * @param authManager - Active auth manager, required by cross-project
+     *   listing's direct-REST GET /tasks strategy
+     * @returns Promise resolving to filtering result with metadata
+     */
+    executeTaskFiltering(args: TaskListingArgs, storage: SimpleFilterStorage, config?: FilterValidationConfig, authManager?: AuthManager): Promise<TaskFilterExecutionResult>;
+    /**
+     * Validates task filtering parameters without executing the filtering
+     * Useful for pre-validation or UI validation scenarios
+     */
+    validateTaskFiltering(args: TaskListingArgs, storage: SimpleFilterStorage, config?: FilterValidationConfig): Promise<{
+        isValid: boolean;
+        warnings: string[];
+        errors: string[];
+        memoryValidation: {
+            isValid: boolean;
+            warnings: string[];
+            maxAllowed?: number;
+        };
+    }>;
+    /**
+     * Prepares filtering context information for debugging and monitoring
+     */
+    createFilteringContext(args: TaskListingArgs, result: TaskFilterExecutionResult): {
+        input: {
+            hasFilter: boolean;
+            hasFilterId: boolean;
+            projectId?: number;
+            page?: number;
+            perPage?: number;
+            search?: string;
+            sort?: string;
+        };
+        output: {
+            taskCount: number;
+            serverSideFilteringUsed: boolean;
+            serverSideFilteringAttempted: boolean;
+            clientSideFiltering: boolean;
+            filteringNote: string;
+            memoryInfo?: {
+                actualCount: number;
+                maxAllowed: number;
+                estimatedMemoryMB: number;
+            };
+        };
+        performance: {
+            timestamp: string;
+            processingTimeMs?: number;
+        };
+    };
+    /**
+     * Analyzes filtering performance and provides recommendations
+     */
+    analyzeFilteringPerformance(args: TaskListingArgs, result: TaskFilterExecutionResult): {
+        isOptimal: boolean;
+        recommendations: string[];
+        issues: string[];
+    };
+};
+//# sourceMappingURL=TaskFilteringOrchestrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TaskFilteringOrchestrator.d.ts","sourceRoot":"","sources":["../../../../src/tools/tasks/filtering/TaskFilteringOrchestrator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAKrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,yBAAyB;IACpC;;;;;;;;;OASG;+BAEK,eAAe,WACZ,mBAAmB,WACpB,sBAAsB,gBAChB,WAAW,GACxB,OAAO,CAAC,yBAAyB,CAAC;IA2ErC;;;OAGG;gCAEK,eAAe,WACZ,mBAAmB,WACpB,sBAAsB,GAC7B,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,gBAAgB,EAAE;YAChB,OAAO,EAAE,OAAO,CAAC;YACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;YACnB,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;IA8BF;;OAEG;iCAEK,eAAe,UACb,yBAAyB,GAChC;QACD,KAAK,EAAE;YACL,SAAS,EAAE,OAAO,CAAC;YACnB,WAAW,EAAE,OAAO,CAAC;YACrB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CAAC;QACF,MAAM,EAAE;YACN,SAAS,EAAE,MAAM,CAAC;YAClB,uBAAuB,EAAE,OAAO,CAAC;YACjC,4BAA4B,EAAE,OAAO,CAAC;YACtC,mBAAmB,EAAE,OAAO,CAAC;YAC7B,aAAa,EAAE,MAAM,CAAC;YACtB,UAAU,CAAC,EAAE;gBACX,WAAW,EAAE,MAAM,CAAC;gBACpB,UAAU,EAAE,MAAM,CAAC;gBACnB,iBAAiB,EAAE,MAAM,CAAC;aAC3B,CAAC;SACH,CAAC;QACF,WAAW,EAAE;YACX,SAAS,EAAE,MAAM,CAAC;YAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;SAC3B,CAAC;KACH;IAmED;;OAEG;sCAEK,eAAe,UACb,yBAAyB,GAChC;QACD,SAAS,EAAE,OAAO,CAAC;QACnB,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB;CAyCF,CAAC"}

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

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * Task Filtering Orchestrator
+ * Main service that coordinates all filtering operations for tasks
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskFilteringOrchestrator = void 0;
+const FilterValidator_1 = require("./FilterValidator");
+const FilterExecutor_1 = require("./FilterExecutor");
+const types_1 = require("../../../types");
+const logger_1 = require("../../../utils/logger");
+/**
+ * Main orchestrator for task filtering operations
+ * Coordinates validation, execution, and result processing
+ */
+exports.TaskFilteringOrchestrator = {
+    /**
+     * Executes the complete task filtering workflow
+     *
+     * @param args - Task listing arguments including filters
+     * @param storage - Storage interface for saved filters
+     * @param config - Optional validation configuration
+     * @param authManager - Active auth manager, required by cross-project
+     *   listing's direct-REST GET /tasks strategy
+     * @returns Promise resolving to filtering result with metadata
+     */
+    async executeTaskFiltering(args, storage, config = {}, authManager) {
+        try {
+            logger_1.logger.debug('Starting task filtering orchestration', {
+                hasFilter: !!args.filter,
+                hasFilterId: !!args.filterId,
+                projectId: args.projectId,
+                page: args.page,
+                perPage: args.perPage
+            });
+            // Step 1: Validate all inputs and parse filters
+            const validationResult = await FilterValidator_1.FilterValidator.validateTaskFiltering(args, storage, config);
+            // Log any validation warnings
+            if (validationResult.validationWarnings.length > 0) {
+                logger_1.logger.warn('Task filtering validation warnings', {
+                    warnings: validationResult.validationWarnings
+                });
+            }
+            // Step 2: Prepare query parameters
+            const params = FilterExecutor_1.FilterExecutor.prepareQueryParameters(args);
+            // Step 3: Execute the filtering
+            const filteringResult = await FilterExecutor_1.FilterExecutor.executeFiltering(args, validationResult.filterExpression, validationResult.filterString, params, storage, authManager);
+            // Step 4: Post-process and validate results
+            const finalValidation = FilterValidator_1.FilterValidator.validateLoadedTasks(filteringResult.tasks.length);
+            if (finalValidation.warnings.length > 0) {
+                logger_1.logger.warn('Task filtering result warnings', {
+                    warnings: finalValidation.warnings
+                });
+            }
+            if (finalValidation.shouldThrow) {
+                throw new types_1.MCPError(types_1.ErrorCode.INTERNAL_ERROR, `Task filtering result validation failed: ${finalValidation.warnings.join(', ')}`);
+            }
+            logger_1.logger.debug('Task filtering orchestration completed', {
+                taskCount: filteringResult.tasks.length,
+                serverSideFilteringUsed: filteringResult.metadata.serverSideFilteringUsed,
+                clientSideFiltering: filteringResult.metadata.clientSideFiltering
+            });
+            return filteringResult;
+        }
+        catch (error) {
+            if (error instanceof types_1.MCPError) {
+                throw error;
+            }
+            logger_1.logger.error('Task filtering orchestration failed', {
+                error: error instanceof Error ? error.message : String(error),
+                args: {
+                    hasFilter: !!args.filter,
+                    hasFilterId: !!args.filterId,
+                    projectId: args.projectId
+                }
+            });
+            // Re-throw original error to be handled by main function
+            throw error;
+        }
+    },
+    /**
+     * Validates task filtering parameters without executing the filtering
+     * Useful for pre-validation or UI validation scenarios
+     */
+    async validateTaskFiltering(args, storage, config = {}) {
+        try {
+            const validationResult = await FilterValidator_1.FilterValidator.validateTaskFiltering(args, storage, config);
+            return {
+                isValid: true,
+                warnings: validationResult.validationWarnings,
+                errors: [],
+                memoryValidation: validationResult.memoryValidation
+            };
+        }
+        catch (error) {
+            if (error instanceof types_1.MCPError) {
+                return {
+                    isValid: false,
+                    warnings: [],
+                    errors: [error.message],
+                    memoryValidation: { isValid: false, warnings: [] }
+                };
+            }
+            return {
+                isValid: false,
+                warnings: [],
+                errors: [`Validation failed: ${error instanceof Error ? error.message : String(error)}`],
+                memoryValidation: { isValid: false, warnings: [] }
+            };
+        }
+    },
+    /**
+     * Prepares filtering context information for debugging and monitoring
+     */
+    createFilteringContext(args, result) {
+        // Build input object, only including defined properties to satisfy exactOptionalPropertyTypes
+        const input = {
+            hasFilter: !!args.filter,
+            hasFilterId: !!args.filterId,
+        };
+        if (args.projectId !== undefined) {
+            input.projectId = args.projectId;
+        }
+        if (args.page !== undefined) {
+            input.page = args.page;
+        }
+        if (args.perPage !== undefined) {
+            input.perPage = args.perPage;
+        }
+        if (args.search !== undefined) {
+            input.search = args.search;
+        }
+        if (args.sort !== undefined) {
+            input.sort = args.sort;
+        }
+        const output = {
+            taskCount: result.tasks?.length || 0,
+            serverSideFilteringUsed: result.metadata?.serverSideFilteringUsed || false,
+            serverSideFilteringAttempted: result.metadata?.serverSideFilteringAttempted || false,
+            clientSideFiltering: result.metadata?.clientSideFiltering || false,
+            filteringNote: result.metadata?.filteringNote || '',
+        };
+        if (result.memoryInfo !== undefined) {
+            output.memoryInfo = result.memoryInfo;
+        }
+        return {
+            input,
+            output,
+            performance: {
+                timestamp: new Date().toISOString()
+            }
+        };
+    },
+    /**
+     * Analyzes filtering performance and provides recommendations
+     */
+    analyzeFilteringPerformance(args, result) {
+        const recommendations = [];
+        const issues = [];
+        let isOptimal = true;
+        // Check for server-side filtering usage
+        if (args.filter && !result.metadata?.serverSideFilteringUsed) {
+            if (result.metadata?.serverSideFilteringAttempted) {
+                issues.push('Server-side filtering was attempted but failed, falling back to client-side');
+                recommendations.push('Consider simplifying the filter syntax for better server-side compatibility');
+            }
+            else {
+                recommendations.push('Consider enabling server-side filtering for better performance with large datasets');
+            }
+            isOptimal = false;
+        }
+        // Check page size efficiency
+        if (args.perPage && args.perPage > 500) {
+            issues.push('Large page size may impact performance');
+            recommendations.push('Consider using smaller page sizes (<= 500) for better performance');
+            isOptimal = false;
+        }
+        // Check memory usage
+        if (result.memoryInfo && result.memoryInfo.actualCount > result.memoryInfo.maxAllowed) {
+            issues.push('Task count exceeds recommended memory limits');
+            recommendations.push('Apply more specific filters or use pagination to reduce memory usage');
+            isOptimal = false;
+        }
+        // Check search efficiency
+        if (args.search && args.search.length < 3) {
+            recommendations.push('Search terms should be at least 3 characters for better results');
+        }
+        return {
+            isOptimal,
+            recommendations,
+            issues
+        };
+    },
+};
+//# sourceMappingURL=TaskFilteringOrchestrator.js.map

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

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

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

@@ -0,0 +1,41 @@
+/**
+ * Filter evaluation functions for tasks
+ */
+import type { components } from '../../../types/generated/vikunja-openapi';
+import type { FilterCondition, FilterGroup, FilterExpression } from '../../../types/filters';
+/** `models.Task` per the OpenAPI spec — the task shape filters evaluate against. */
+type Task = components['schemas']['models.Task'];
+/**
+ * Evaluates a filter condition against a task
+ */
+export declare function evaluateCondition(task: Task, condition: FilterCondition): boolean;
+/**
+ * Evaluates comparison operators
+ */
+export declare function evaluateComparison(actual: unknown, operator: string, expected: unknown): boolean;
+/**
+ * Evaluates date comparisons (supports relative dates like "now+7d")
+ */
+export declare function evaluateDateComparison(actual: string, operator: string, expected: string): boolean;
+/**
+ * Parses relative date strings (e.g., "now+7d", "now-1w")
+ */
+export declare function parseRelativeDate(dateStr: string): Date | null;
+/**
+ * Evaluates string comparisons
+ */
+export declare function evaluateStringComparison(actual: string, operator: string, expected: string): boolean;
+/**
+ * Evaluates array comparisons (for assignees and labels)
+ */
+export declare function evaluateArrayComparison(actual: number[], operator: string, expected: number[]): boolean;
+/**
+ * Evaluates a filter group against a task
+ */
+export declare function evaluateGroup(task: Task, group: FilterGroup): boolean;
+/**
+ * Applies a filter expression to a list of tasks
+ */
+export declare function applyFilter(tasks: Task[], expression: FilterExpression): Task[];
+export {};
+//# sourceMappingURL=evaluators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evaluators.d.ts","sourceRoot":"","sources":["../../../../src/tools/tasks/filtering/evaluators.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE7F,oFAAoF;AACpF,KAAK,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC;AAEjD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,GAAG,OAAO,CA4EjF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAiBhG;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAuBlG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CA8C9D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAYpG;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAWvG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAMrE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI,EAAE,CAU/E"}