vikunja-mcp-ng 0.4.0

package/dist/tools/tasks/bulk/BulkOperationValidator.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Validation and preprocessing utilities for bulk operations
+ */
+export interface BulkUpdateArgs {
+    taskIds?: number[];
+    field?: string;
+    value?: unknown;
+}
+export interface BulkDeleteArgs {
+    taskIds?: number[];
+}
+export interface BulkCreateTaskData {
+    title: string;
+    description?: string;
+    dueDate?: string;
+    startDate?: string;
+    endDate?: string;
+    priority?: number;
+    labels?: number[];
+    assignees?: number[];
+    repeatAfter?: number;
+    repeatMode?: 'day' | 'week' | 'month' | 'year';
+}
+export interface BulkCreateArgs {
+    projectId?: number;
+    tasks?: BulkCreateTaskData[];
+}
+/**
+ * Validator for bulk update operations
+ */
+export declare const bulkOperationValidator: {
+    /**
+     * Validate bulk update arguments
+     */
+    validateBulkUpdate(args: BulkUpdateArgs): void;
+    /**
+     * Validate and preprocess field value for bulk update
+     */
+    preprocessFieldValue(args: BulkUpdateArgs): void;
+    /**
+     * Validate field and value constraints
+     */
+    validateFieldConstraints(args: BulkUpdateArgs): void;
+    /**
+     * Validate bulk delete arguments
+     */
+    validateBulkDelete(args: BulkDeleteArgs): void;
+    /**
+     * Validate bulk create arguments
+     */
+    validateBulkCreate(args: BulkCreateArgs): void;
+};
+//# sourceMappingURL=BulkOperationValidator.d.ts.map

package/dist/tools/tasks/bulk/BulkOperationValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BulkOperationValidator.d.ts","sourceRoot":"","sources":["../../../../src/tools/tasks/bulk/BulkOperationValidator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;CAChD;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAkDD;;GAEG;AACH,eAAO,MAAM,sBAAsB;IACjC;;OAEG;6BACsB,cAAc,GAAG,IAAI;IA0B9C;;OAEG;+BACwB,cAAc,GAAG,IAAI;IA0BhD;;OAEG;mCAC4B,cAAc,GAAG,IAAI;IAkFpD;;OAEG;6BACsB,cAAc,GAAG,IAAI;IAkB9C;;OAEG;6BACsB,cAAc,GAAG,IAAI;CAoD/C,CAAC"}

package/dist/tools/tasks/bulk/BulkOperationValidator.js

@@ -0,0 +1,216 @@
+"use strict";
+/**
+ * Validation and preprocessing utilities for bulk operations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bulkOperationValidator = void 0;
+const types_1 = require("../../../types");
+const validation_1 = require("../validation");
+const constants_1 = require("../constants");
+/**
+ * Coerce a labels/assignees value into a number array.
+ *
+ * The bulk-update `value` field is loosely typed (z.unknown), and an MCP
+ * client with a stale cached schema may send the array as a JSON string
+ * ("[3,8]") or a comma-separated string ("3,8") instead of a real array.
+ * Returns the value unchanged when it cannot be coerced, so that
+ * validateFieldConstraints still reports a clear error.
+ */
+function coerceToNumberArray(value) {
+    const toNumbers = (arr) => arr.map((item) => typeof item === 'string' && item.trim() !== '' && !Number.isNaN(Number(item))
+        ? Number(item)
+        : item);
+    if (Array.isArray(value)) {
+        return toNumbers(value);
+    }
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        if (trimmed === '') {
+            return value;
+        }
+        if (trimmed.startsWith('[')) {
+            try {
+                const parsed = JSON.parse(trimmed);
+                if (Array.isArray(parsed)) {
+                    return toNumbers(parsed);
+                }
+            }
+            catch {
+                // Not valid JSON; fall through to comma-separated handling.
+            }
+        }
+        const parts = trimmed
+            .split(',')
+            .map((part) => part.trim())
+            .filter((part) => part !== '');
+        if (parts.length > 0 && parts.every((part) => !Number.isNaN(Number(part)))) {
+            return parts.map((part) => Number(part));
+        }
+    }
+    return value;
+}
+/**
+ * Validator for bulk update operations
+ */
+exports.bulkOperationValidator = {
+    /**
+     * Validate bulk update arguments
+     */
+    validateBulkUpdate(args) {
+        if (!args.taskIds || args.taskIds.length === 0) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'taskIds array is required for bulk update operation');
+        }
+        if (!args.field) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'field is required for bulk update operation');
+        }
+        if (args.value === undefined) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'value is required for bulk update operation');
+        }
+        if (args.taskIds.length > constants_1.MAX_BULK_OPERATION_TASKS) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Too many tasks for bulk operation. Maximum allowed: ${constants_1.MAX_BULK_OPERATION_TASKS}. Consider breaking into smaller batches.`);
+        }
+        args.taskIds.forEach((id) => (0, validation_1.validateId)(id, 'task ID'));
+    },
+    /**
+     * Validate and preprocess field value for bulk update
+     */
+    preprocessFieldValue(args) {
+        // Preprocess value to handle type coercion from MCP
+        if (args.field === 'done' && typeof args.value === 'string') {
+            if (args.value === 'true') {
+                args.value = true;
+            }
+            else if (args.value === 'false') {
+                args.value = false;
+            }
+        }
+        // Handle numeric fields that come as strings
+        if (args.field && ['priority', 'project_id', 'repeat_after'].includes(args.field) && typeof args.value === 'string') {
+            const numValue = Number(args.value);
+            if (!isNaN(numValue)) {
+                args.value = numValue;
+            }
+        }
+        // labels and assignees expect a number[]; coerce a stringified array
+        // ("[3,8]" or "3,8") that a stale client schema may send so a valid
+        // value is not rejected as "must be an array of numbers".
+        if (args.field && ['labels', 'assignees'].includes(args.field)) {
+            args.value = coerceToNumberArray(args.value);
+        }
+    },
+    /**
+     * Validate field and value constraints
+     */
+    validateFieldConstraints(args) {
+        const allowedFields = [
+            'done',
+            'priority',
+            'due_date',
+            'start_date',
+            'end_date',
+            'project_id',
+            'assignees',
+            'labels',
+            'repeat_after',
+            'repeat_mode',
+        ];
+        if (!args.field || !allowedFields.includes(args.field)) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Invalid field: ${args.field || 'undefined'}. Allowed fields: ${allowedFields.join(', ')}`);
+        }
+        // Field-specific validation
+        if (args.field === 'priority' && typeof args.value === 'number') {
+            if (args.value < 0 || args.value > 5) {
+                throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Priority must be between 0 and 5');
+            }
+        }
+        if (args.field === 'due_date' && typeof args.value === 'string') {
+            (0, validation_1.validateDateString)(args.value, 'due_date');
+        }
+        if (args.field === 'start_date' && typeof args.value === 'string') {
+            (0, validation_1.validateDateString)(args.value, 'start_date');
+        }
+        if (args.field === 'end_date' && typeof args.value === 'string') {
+            (0, validation_1.validateDateString)(args.value, 'end_date');
+        }
+        if (args.field === 'project_id' && typeof args.value === 'number') {
+            (0, validation_1.validateId)(args.value, 'project_id');
+        }
+        if (['assignees', 'labels'].includes(args.field)) {
+            if (!Array.isArray(args.value)) {
+                throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `${args.field} must be an array of numbers`);
+            }
+            const valueArray = args.value;
+            valueArray.forEach((id) => (0, validation_1.validateId)(id, `${args.field} ID`));
+        }
+        if (args.field === 'done') {
+            if (typeof args.value !== 'boolean') {
+                throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'done field must be a boolean value (true or false)');
+            }
+        }
+        // Recurring field validation
+        if (args.field === 'repeat_after' && typeof args.value === 'number' && args.value < 0) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'repeat_after must be a non-negative number');
+        }
+        if (args.field === 'repeat_mode' && typeof args.value === 'string') {
+            // Valid modes are exactly the keys of REPEAT_MODE_MAP (constants.ts),
+            // which mirrors the API's TaskRepeatMode integer enum (default=0,
+            // month=1, from_current=2). Previously this accepted 'day'/'week'/'year'
+            // (which reach the API unconverted as raw strings) while rejecting the
+            // legitimate 'default'/'from_current'.
+            const validModes = Object.keys(constants_1.REPEAT_MODE_MAP);
+            if (!validModes.includes(args.value)) {
+                throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Invalid repeat_mode: ${args.value}. Valid modes: ${validModes.join(', ')}`);
+            }
+        }
+    },
+    /**
+     * Validate bulk delete arguments
+     */
+    validateBulkDelete(args) {
+        if (!args.taskIds || args.taskIds.length === 0) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'taskIds array is required for bulk delete operation');
+        }
+        if (args.taskIds.length > constants_1.MAX_BULK_OPERATION_TASKS) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Too many tasks for bulk operation. Maximum allowed: ${constants_1.MAX_BULK_OPERATION_TASKS}. Consider breaking into smaller batches.`);
+        }
+        args.taskIds.forEach((id) => (0, validation_1.validateId)(id, 'task ID'));
+    },
+    /**
+     * Validate bulk create arguments
+     */
+    validateBulkCreate(args) {
+        if (!args.projectId) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'projectId is required for bulk create operation');
+        }
+        (0, validation_1.validateId)(args.projectId, 'projectId');
+        if (!args.tasks || args.tasks.length === 0) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'tasks array is required and must contain at least one task');
+        }
+        if (args.tasks.length > constants_1.MAX_BULK_OPERATION_TASKS) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Too many tasks for bulk operation. Maximum allowed: ${constants_1.MAX_BULK_OPERATION_TASKS}. Consider breaking into smaller batches.`);
+        }
+        // Validate all tasks have required fields
+        args.tasks.forEach((task, index) => {
+            if (!task.title || task.title.trim() === '') {
+                throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Task at index ${index} must have a non-empty title`);
+            }
+            // Validate optional fields
+            if (task.dueDate) {
+                (0, validation_1.validateDateString)(task.dueDate, `tasks[${index}].dueDate`);
+            }
+            if (task.startDate) {
+                (0, validation_1.validateDateString)(task.startDate, `tasks[${index}].startDate`);
+            }
+            if (task.endDate) {
+                (0, validation_1.validateDateString)(task.endDate, `tasks[${index}].endDate`);
+            }
+            if (task.assignees) {
+                task.assignees.forEach((id) => (0, validation_1.validateId)(id, `tasks[${index}].assignee ID`));
+            }
+            if (task.labels) {
+                task.labels.forEach((id) => (0, validation_1.validateId)(id, `tasks[${index}].label ID`));
+            }
+        });
+    }
+};
+//# sourceMappingURL=BulkOperationValidator.js.map

package/dist/tools/tasks/bulk/BulkOperationValidator.js.map

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

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

@@ -0,0 +1,9 @@
+/**
+ * Bulk operations module exports
+ */
+export { BulkOperationProcessor } from './BulkOperationProcessor';
+export { bulkOperationValidator as BulkOperationValidator } from './BulkOperationValidator';
+export { bulkOperationErrorHandler as BulkOperationErrorHandler } from './BulkOperationErrorHandler';
+export { batchProcessorFactory as BatchProcessorFactory } from './BatchProcessorFactory';
+export type { BulkUpdateArgs, BulkDeleteArgs, BulkCreateArgs, BulkCreateTaskData, } from './BulkOperationValidator';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/tasks/bulk/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,sBAAsB,IAAI,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,yBAAyB,IAAI,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACrG,OAAO,EAAE,qBAAqB,IAAI,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEzF,YAAY,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,kBAAkB,GACnB,MAAM,0BAA0B,CAAC"}

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

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Bulk operations module exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BatchProcessorFactory = exports.BulkOperationErrorHandler = exports.BulkOperationValidator = exports.BulkOperationProcessor = void 0;
+var BulkOperationProcessor_1 = require("./BulkOperationProcessor");
+Object.defineProperty(exports, "BulkOperationProcessor", { enumerable: true, get: function () { return BulkOperationProcessor_1.BulkOperationProcessor; } });
+var BulkOperationValidator_1 = require("./BulkOperationValidator");
+Object.defineProperty(exports, "BulkOperationValidator", { enumerable: true, get: function () { return BulkOperationValidator_1.bulkOperationValidator; } });
+var BulkOperationErrorHandler_1 = require("./BulkOperationErrorHandler");
+Object.defineProperty(exports, "BulkOperationErrorHandler", { enumerable: true, get: function () { return BulkOperationErrorHandler_1.bulkOperationErrorHandler; } });
+var BatchProcessorFactory_1 = require("./BatchProcessorFactory");
+Object.defineProperty(exports, "BatchProcessorFactory", { enumerable: true, get: function () { return BatchProcessorFactory_1.batchProcessorFactory; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/tasks/bulk/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,mEAAkE;AAAzD,gIAAA,sBAAsB,OAAA;AAC/B,mEAA4F;AAAnF,gIAAA,sBAAsB,OAA0B;AACzD,yEAAqG;AAA5F,sIAAA,yBAAyB,OAA6B;AAC/D,iEAAyF;AAAhF,8HAAA,qBAAqB,OAAyB"}

package/dist/tools/tasks/bulk-operations-simplified.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Simplified bulk operations for tasks (~250 lines)
+ *
+ * This superseded the old bulk/ implementation (BulkOperationProcessor,
+ * BulkOperationErrorHandler, BatchProcessorFactory), which was dead code -
+ * unreachable from src/tools/index.ts or src/tools/tasks/index.ts - and has
+ * since been deleted. Only BulkOperationValidator survives from that folder,
+ * reused here for its field/value validation.
+ */
+import type { AuthManager } from '../../auth/AuthManager';
+import type { BulkUpdateArgs, BulkDeleteArgs, BulkCreateArgs, BulkCreateTaskData } from './bulk/BulkOperationValidator';
+export type { BulkUpdateArgs, BulkDeleteArgs, BulkCreateArgs, BulkCreateTaskData };
+/**
+ * Bulk-update.
+ *
+ * Scalar fields go through Vikunja's native `POST /tasks/bulk` in ONE request.
+ * The endpoint's real contract (see `models.BulkTask` in the generated OpenAPI
+ * types) is `{ task_ids, fields: string[], values: models.Task }` — the server
+ * applies exactly the listed fields and preserves everything else. The old
+ * belief that the endpoint full-replaces tasks came from node-vikunja's stale
+ * `{ task_ids, field, value }` type (democratize-technology/vikunja-mcp#46):
+ * with that malformed payload the server sees `fields: null` and applies a
+ * zero-value task. A single request also sidesteps the `database is locked`
+ * partial failures that concurrent per-task updates hit on SQLite-backed
+ * instances (democratize-technology/vikunja-mcp#79).
+ *
+ * Two server-side caveats handled here — source-verified against
+ * go-vikunja/vikunja's `pkg/models/tasks.go` and `task_assignees.go`, not
+ * just observed live behavior:
+ * - **Assignees**: `updateSingleTask()` calls `updateTaskAssignees(s,
+ *   t.Assignees, a)` *before* the `fields`-allowlist gate is even evaluated,
+ *   reconciling to whatever `values.assignees` decoded to. A scalar-only
+ *   bulk request never sets that field, so it decodes to `nil`, which trips
+ *   the unconditional full-delete branch in `task_assignees.go` for every
+ *   task in `task_ids` — regardless of what `fields` lists. So assignees are
+ *   snapshotted first and restored afterwards (see below).
+ * - **Labels**: genuinely inert, not merely unscoped — the label-sync call
+ *   in that same `updateSingleTask()` is literally commented out upstream
+ *   (`// Maybe FIXME:`, an acknowledged, unresolved refactor need), for both
+ *   `POST /tasks/bulk` and single-task `POST /tasks/{id}`. So labels always
+ *   use the dedicated per-task label endpoint, not because the bulk
+ *   endpoint clears them, but because it never touches them at all.
+ */
+export declare function bulkUpdateTasks(args: BulkUpdateArgs, authManager: AuthManager): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare function bulkDeleteTasks(args: BulkDeleteArgs, authManager: AuthManager): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare function bulkCreateTasks(args: BulkCreateArgs, authManager: AuthManager): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=bulk-operations-simplified.d.ts.map

package/dist/tools/tasks/bulk-operations-simplified.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-operations-simplified.d.ts","sourceRoot":"","sources":["../../../src/tools/tasks/bulk-operations-simplified.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAW1D,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAsCxH,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;AAyBnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAwLjJ;AAID,wBAAsB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAyBjJ;AAID,wBAAsB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAuGjJ"}