mcp-taskflow 0.1.0

package/dist/data/schemas.d.ts.map

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

package/dist/data/schemas.js

@@ -0,0 +1,265 @@
+/**
+ * Zod schemas for runtime validation
+ *
+ * These schemas validate all external input from MCP clients.
+ * TypeScript types alone provide no runtime protection!
+ */
+import { z } from 'zod';
+/**
+ * Task status validation
+ * Allowlist validation - only these 4 values permitted.
+ */
+export const TaskStatusSchema = z.enum(['pending', 'in_progress', 'completed', 'blocked']);
+/**
+ * Task dependency schema
+ * NOTE: The 'name' field is computed at runtime for display purposes
+ */
+export const TaskDependencySchema = z.object({
+    taskId: z.string().uuid(), // Validate GUID format to prevent injection
+});
+/**
+ * Related file type enum
+ * Allowlist validation - only permitted file relationship types.
+ */
+export const RelatedFileTypeSchema = z.enum(['TO_MODIFY', 'REFERENCE', 'CREATE', 'DEPENDENCY', 'OTHER']);
+/**
+ * Related file schema
+ * Note: Paths will be sanitized separately before file operations.
+ */
+export const RelatedFileSchema = z.object({
+    path: z.string().min(1).max(1000), // Max path length prevents DoS
+    type: RelatedFileTypeSchema,
+    description: z.string().max(1000).optional().nullable(),
+    lineStart: z.number().int().min(1).optional().nullable(),
+    lineEnd: z.number().int().min(1).optional().nullable(),
+});
+/**
+ * Main task item schema
+ * Validates all task fields with strict limits to prevent malformed data.
+ */
+export const TaskItemSchema = z.object({
+    id: z.string().uuid(),
+    name: z.string().min(1, 'Task name cannot be empty').max(500, 'Task name too long'),
+    description: z.string().max(5000, 'Description too long'),
+    notes: z.string().max(5000).optional().nullable(),
+    status: TaskStatusSchema,
+    dependencies: z.array(TaskDependencySchema).default([]),
+    createdAt: z.string().datetime(), // ISO 8601 format
+    updatedAt: z.string().datetime(), // ISO 8601 format
+    completedAt: z.string().datetime().optional().nullable(),
+    summary: z.string().max(5000).optional().nullable(),
+    relatedFiles: z.array(RelatedFileSchema).default([]),
+    analysisResult: z.string().max(20000).optional().nullable(),
+    agent: z.string().max(200).optional().nullable(),
+    implementationGuide: z.string().max(10000).optional().nullable(),
+    verificationCriteria: z.string().max(5000).optional().nullable(),
+});
+/**
+ * Task document schema (root JSON structure)
+ * Version field used for schema migration support.
+ */
+export const TaskDocumentSchema = z.object({
+    version: z.string().regex(/^\d+\.\d+$/, 'Version must be format X.Y'),
+    tasks: z.array(TaskItemSchema).default([]),
+});
+/**
+ * Update mode validation
+ */
+export const UpdateModeSchema = z.enum(['append', 'overwrite', 'selective', 'clearAllTasks']);
+// ============================================================================
+// MCP Tool Parameter Schemas (Input Validation)
+// ============================================================================
+/**
+ * create_task / plan_task parameters
+ * Strict validation on input to ensure data integrity.
+ */
+export const CreateTaskParamsSchema = z.object({
+    name: z.string()
+        .min(1, 'Task name required')
+        .max(500, 'Task name exceeds maximum length of 500 characters'),
+    description: z.string()
+        .min(1, 'Task description required')
+        .max(5000, 'Description exceeds maximum length of 5000 characters'),
+    dependencies: z.array(z.string().max(500)).optional(),
+    relatedFiles: z.array(RelatedFileSchema).optional(),
+    implementationGuide: z.string().max(10000).optional().nullable(),
+    verificationCriteria: z.string().max(5000).optional().nullable(),
+    notes: z.string().max(5000).optional().nullable(),
+    agent: z.string().max(200).optional().nullable(),
+});
+/**
+ * update_task parameters
+ * Validates task ID is GUID, all fields optional for partial update.
+ */
+export const UpdateTaskParamsSchema = z.object({
+    taskId: z.string().uuid('Task ID must be a valid GUID'),
+    name: z.string().min(1).max(500).optional().nullable(),
+    description: z.string().max(5000).optional().nullable(),
+    dependencies: z.array(z.string().max(500)).optional().nullable(),
+    relatedFiles: z.array(RelatedFileSchema).optional().nullable(),
+    implementationGuide: z.string().max(10000).optional().nullable(),
+    verificationCriteria: z.string().max(5000).optional().nullable(),
+    notes: z.string().max(5000).optional().nullable(),
+});
+/**
+ * split_tasks parameters
+ * Validates array of tasks and update mode.
+ */
+export const SplitTasksParamsSchema = z.object({
+    updateMode: UpdateModeSchema,
+    tasks: z.array(CreateTaskParamsSchema)
+        .min(1, 'At least one task required')
+        .max(100, 'Maximum 100 tasks per split operation'),
+    globalAnalysisResult: z.string().max(20000).optional().nullable(),
+});
+/**
+ * list_tasks parameters
+ */
+export const ListTasksParamsSchema = z.object({
+    status: z.enum(['all', 'pending', 'in_progress', 'completed', 'blocked']).default('all'),
+});
+/**
+ * query_task parameters
+ * Pagination limits prevent excessive result sets.
+ */
+export const QueryTaskParamsSchema = z.object({
+    query: z.string().min(1, 'Query cannot be empty').max(500),
+    isId: z.boolean().default(false),
+    page: z.number().int().min(1).default(1),
+    pageSize: z.number().int().min(1).max(100).default(10), // Max 100 per page prevents DoS
+});
+/**
+ * get_task_detail parameters
+ */
+export const GetTaskDetailParamsSchema = z.object({
+    taskId: z.string().uuid('Task ID must be a valid GUID'),
+});
+/**
+ * execute_task parameters
+ */
+export const ExecuteTaskParamsSchema = z.object({
+    taskId: z.string().uuid('Task ID must be a valid GUID'),
+});
+/**
+ * verify_task parameters
+ */
+export const VerifyTaskParamsSchema = z.object({
+    taskId: z.string().uuid('Task ID must be a valid GUID'),
+    score: z.number().int().min(0).max(100, 'Score must be between 0-100'),
+    summary: z.string().min(1).max(2000),
+});
+/**
+ * delete_task parameters
+ */
+export const DeleteTaskParamsSchema = z.object({
+    taskId: z.string().uuid('Task ID must be a valid GUID'),
+});
+/**
+ * clear_all_tasks parameters
+ */
+export const ClearAllTasksParamsSchema = z.object({
+    confirm: z.boolean().default(false),
+});
+/**
+ * analyze_task parameters
+ */
+export const AnalyzeTaskParamsSchema = z.object({
+    summary: z.string().min(1).max(5000, 'Summary exceeds maximum length'),
+    initialConcept: z.string().min(1).max(20000, 'Initial concept exceeds maximum length'),
+    previousAnalysis: z.string().max(20000).optional().nullable(),
+});
+/**
+ * reflect_task parameters
+ */
+export const ReflectTaskParamsSchema = z.object({
+    summary: z.string().min(1).max(5000, 'Summary exceeds maximum length'),
+    analysis: z.string().min(1).max(20000, 'Analysis exceeds maximum length'),
+});
+/**
+ * plan_task parameters
+ */
+export const PlanTaskParamsSchema = z.object({
+    description: z.string().min(1, 'Description required').max(10000),
+    requirements: z.string().max(10000).optional().nullable(),
+    existingTasksReference: z.boolean().default(false),
+});
+/**
+ * research_mode parameters
+ */
+export const ResearchModeParamsSchema = z.object({
+    topic: z.string().min(1, 'Topic required').max(1000),
+    previousState: z.string().max(20000),
+    currentState: z.string().min(1, 'Current state required').max(20000),
+    nextSteps: z.string().min(1, 'Next steps required').max(20000),
+});
+/**
+ * process_thought parameters
+ */
+export const ProcessThoughtParamsSchema = z.object({
+    thought: z.string().min(1, 'Thought content required').max(5000),
+    thoughtNumber: z.number().int().min(1),
+    totalThoughts: z.number().int().min(1),
+    stage: z.string().min(1).max(100),
+    tags: z.array(z.string().max(50)).max(20).optional().nullable(),
+    axiomsUsed: z.array(z.string().max(200)).max(10).optional().nullable(),
+    assumptionsChallenged: z.array(z.string().max(200)).max(10).optional().nullable(),
+    nextThoughtNeeded: z.boolean().default(false),
+}).refine(data => data.thoughtNumber <= data.totalThoughts, {
+    message: 'Thought number cannot exceed total thoughts',
+    path: ['thoughtNumber'],
+});
+/**
+ * init_project_rules parameters
+ */
+export const InitProjectRulesParamsSchema = z.object({
+// No parameters - this tool initializes default rules
+});
+/**
+ * get_server_info parameters
+ */
+export const GetServerInfoParamsSchema = z.object({
+// No parameters - returns server metadata
+});
+// ============================================================================
+// Validation Helper Functions
+// ============================================================================
+/**
+ * Validate and parse a task document from unknown data
+ * Use this for all JSON file reads to ensure data integrity.
+ *
+ * @param data - Unknown data from file or external source
+ * @returns Validated TaskDocument
+ * @throws ZodError if validation fails
+ */
+export function validateTaskDocument(data) {
+    return TaskDocumentSchema.parse(data);
+}
+/**
+ * Safely validate a task document, returning success/error result
+ *
+ * @param data - Unknown data from file or external source
+ * @returns { success: true, data: TaskDocument } or { success: false, error: ZodError }
+ */
+export function safeValidateTaskDocument(data) {
+    return TaskDocumentSchema.safeParse(data);
+}
+/**
+ * Validate a single task item
+ *
+ * @param data - Unknown data
+ * @returns Validated TaskItem
+ * @throws ZodError if validation fails
+ */
+export function validateTaskItem(data) {
+    return TaskItemSchema.parse(data);
+}
+/**
+ * Create an empty task document
+ */
+export function createEmptyTaskDocument() {
+    return {
+        version: '1.0',
+        tasks: [],
+    };
+}
+//# sourceMappingURL=schemas.js.map

package/dist/data/schemas.js.map

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

package/dist/data/taskSearchService.d.ts

@@ -0,0 +1,110 @@
+/**
+ * TaskSearchService - Search and query functionality for tasks
+ *
+ * Provides:
+ * - Full-text search across task fields
+ * - Filtering by status
+ * - Pagination with offset/limit
+ * - Multiple sorting options
+ * - Regex safety
+ */
+import { type TaskItem, type TaskStatus } from './schemas.js';
+/**
+ * Sort field options
+ */
+export type SortField = 'name' | 'createdAt' | 'updatedAt' | 'status';
+/**
+ * Sort direction
+ */
+export type SortDirection = 'asc' | 'desc';
+/**
+ * Search query parameters
+ */
+export interface SearchQuery {
+    /** Text to search for in name, description, notes */
+    query?: string | null;
+    /** Filter by task status */
+    status?: TaskStatus | null;
+    /** Page number (1-based) */
+    page?: number;
+    /** Items per page (default: 10, max: 1000) */
+    pageSize?: number;
+    /** Field to sort by */
+    sortBy?: SortField;
+    /** Sort direction */
+    sortDirection?: SortDirection;
+}
+/**
+ * Paginated search results
+ */
+export interface SearchResults {
+    /** Tasks matching the query */
+    tasks: TaskItem[];
+    /** Total number of matching tasks (before pagination) */
+    total: number;
+    /** Current page number (1-based) */
+    page: number;
+    /** Items per page */
+    pageSize: number;
+    /** Total number of pages */
+    totalPages: number;
+    /** Whether there are more pages */
+    hasMore: boolean;
+}
+/**
+ * TaskSearchService - Provides search and query functionality
+ *
+ * Input validation and safe regex usage.
+ */
+export declare class TaskSearchService {
+    /**
+     * Search tasks with filtering, pagination, and sorting
+     *
+     * @param tasks - All tasks to search
+     * @param query - Search parameters
+     * @returns Paginated search results
+     */
+    search(tasks: TaskItem[], query?: SearchQuery): SearchResults;
+    /**
+     * Filter tasks by text query (case-insensitive search across name, description, notes)
+     *
+     * @param tasks - Tasks to filter
+     * @param query - Search query string
+     * @returns Filtered tasks
+     */
+    private filterByQuery;
+    /**
+     * Filter tasks by status
+     *
+     * @param tasks - Tasks to filter
+     * @param status - Status to filter by
+     * @returns Filtered tasks
+     */
+    private filterByStatus;
+    /**
+     * Sort tasks by specified field and direction
+     *
+     * @param tasks - Tasks to sort
+     * @param sortBy - Field to sort by
+     * @param direction - Sort direction
+     * @returns Sorted tasks (new array)
+     */
+    private sortTasks;
+    /**
+     * Paginate tasks
+     *
+     * @param tasks - Sorted tasks to paginate
+     * @param page - Page number (1-based)
+     * @param pageSize - Items per page
+     * @returns Slice of tasks for the requested page
+     */
+    private paginate;
+    /**
+     * Validate and normalize page size
+     *
+     * @param pageSize - Requested page size
+     * @returns Validated page size (within bounds)
+     */
+    private validatePageSize;
+}
+//# sourceMappingURL=taskSearchService.d.ts.map

package/dist/data/taskSearchService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskSearchService.d.ts","sourceRoot":"","sources":["../../src/data/taskSearchService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3B,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,qBAAqB;IACrB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;CAClB;AAiBD;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,GAAE,WAAgB,GAAG,aAAa;IA+BxE;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IA8BrB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAItB;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IAgCjB;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;IAMhB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;CAiBzB"}

package/dist/data/taskSearchService.js

@@ -0,0 +1,165 @@
+/**
+ * TaskSearchService - Search and query functionality for tasks
+ *
+ * Provides:
+ * - Full-text search across task fields
+ * - Filtering by status
+ * - Pagination with offset/limit
+ * - Multiple sorting options
+ * - Regex safety
+ */
+import {} from './schemas.js';
+/**
+ * Maximum results to prevent memory exhaustion
+ */
+const MAX_PAGE_SIZE = 1000;
+/**
+ * Default page size
+ */
+const DEFAULT_PAGE_SIZE = 10;
+/**
+ * Maximum query length to keep search bounded
+ */
+const MAX_PATTERN_LENGTH = 100;
+/**
+ * TaskSearchService - Provides search and query functionality
+ *
+ * Input validation and safe regex usage.
+ */
+export class TaskSearchService {
+    /**
+     * Search tasks with filtering, pagination, and sorting
+     *
+     * @param tasks - All tasks to search
+     * @param query - Search parameters
+     * @returns Paginated search results
+     */
+    search(tasks, query = {}) {
+        // Step 1: Filter by query string (if provided)
+        let filtered = query.query
+            ? this.filterByQuery(tasks, query.query)
+            : tasks;
+        // Step 2: Filter by status (if provided)
+        if (query.status) {
+            filtered = this.filterByStatus(filtered, query.status);
+        }
+        // Step 3: Sort results
+        const sortBy = query.sortBy ?? 'createdAt';
+        const sortDirection = query.sortDirection ?? 'desc';
+        const sorted = this.sortTasks(filtered, sortBy, sortDirection);
+        // Step 4: Paginate results
+        const page = Math.max(1, query.page ?? 1);
+        const pageSize = this.validatePageSize(query.pageSize);
+        const paginated = this.paginate(sorted, page, pageSize);
+        return {
+            tasks: paginated,
+            total: sorted.length,
+            page,
+            pageSize,
+            totalPages: Math.ceil(sorted.length / pageSize),
+            hasMore: page * pageSize < sorted.length,
+        };
+    }
+    /**
+     * Filter tasks by text query (case-insensitive search across name, description, notes)
+     *
+     * @param tasks - Tasks to filter
+     * @param query - Search query string
+     * @returns Filtered tasks
+     */
+    filterByQuery(tasks, query) {
+        const trimmed = query.trim();
+        if (trimmed.length === 0) {
+            return tasks;
+        }
+        // Validate query length
+        if (trimmed.length > MAX_PATTERN_LENGTH) {
+            throw new Error(`Search query too long (max ${MAX_PATTERN_LENGTH} characters)`);
+        }
+        const normalizedQuery = trimmed.toLowerCase();
+        // Filter tasks that match in name, description, or notes
+        return tasks.filter(task => {
+            const searchableText = [
+                task.name,
+                task.description,
+                task.notes ?? '',
+            ]
+                .join(' ')
+                .toLowerCase();
+            return searchableText.includes(normalizedQuery);
+        });
+    }
+    /**
+     * Filter tasks by status
+     *
+     * @param tasks - Tasks to filter
+     * @param status - Status to filter by
+     * @returns Filtered tasks
+     */
+    filterByStatus(tasks, status) {
+        return tasks.filter(task => task.status === status);
+    }
+    /**
+     * Sort tasks by specified field and direction
+     *
+     * @param tasks - Tasks to sort
+     * @param sortBy - Field to sort by
+     * @param direction - Sort direction
+     * @returns Sorted tasks (new array)
+     */
+    sortTasks(tasks, sortBy, direction) {
+        // Create copy to avoid mutating input
+        const sorted = [...tasks];
+        sorted.sort((a, b) => {
+            let comparison = 0;
+            switch (sortBy) {
+                case 'name':
+                    comparison = a.name.localeCompare(b.name);
+                    break;
+                case 'createdAt':
+                    comparison = a.createdAt.localeCompare(b.createdAt);
+                    break;
+                case 'updatedAt':
+                    comparison = a.updatedAt.localeCompare(b.updatedAt);
+                    break;
+                case 'status':
+                    comparison = a.status.localeCompare(b.status);
+                    break;
+            }
+            return direction === 'asc' ? comparison : -comparison;
+        });
+        return sorted;
+    }
+    /**
+     * Paginate tasks
+     *
+     * @param tasks - Sorted tasks to paginate
+     * @param page - Page number (1-based)
+     * @param pageSize - Items per page
+     * @returns Slice of tasks for the requested page
+     */
+    paginate(tasks, page, pageSize) {
+        const startIndex = (page - 1) * pageSize;
+        const endIndex = startIndex + pageSize;
+        return tasks.slice(startIndex, endIndex);
+    }
+    /**
+     * Validate and normalize page size
+     *
+     * @param pageSize - Requested page size
+     * @returns Validated page size (within bounds)
+     */
+    validatePageSize(pageSize) {
+        if (pageSize === undefined || pageSize === null) {
+            return DEFAULT_PAGE_SIZE;
+        }
+        if (pageSize < 1) {
+            return DEFAULT_PAGE_SIZE;
+        }
+        if (pageSize > MAX_PAGE_SIZE) {
+            return MAX_PAGE_SIZE;
+        }
+        return Math.floor(pageSize);
+    }
+}
+//# sourceMappingURL=taskSearchService.js.map

package/dist/data/taskSearchService.js.map

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