kemdicode-mcp 1.15.0

package/dist/kanban/kanban-store.d.ts

@@ -0,0 +1,236 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import { KanbanTask, CreateTaskInput, UpdateTaskInput, TaskEvent, TaskFilter, BoardSummary } from './types.js';
+/**
+ * Create a new task on the Kanban board
+ *
+ * @description Creates a new task with the provided input, stores it in Redis,
+ *              sets up blocking relationships, and emits a task-created event
+ * @param {CreateTaskInput} input - Task creation parameters
+ * @param {string} input.sessionId - Session ID for the task
+ * @param {string} input.title - Task title (max 200 chars)
+ * @param {string} [input.description] - Detailed task description
+ * @param {TaskPriority} [input.priority='normal'] - Task priority level
+ * @param {string} input.createdBy - Agent ID creating the task
+ * @param {string[]} [input.blockedBy] - Task IDs that block this task
+ * @param {string[]} [input.relatedFiles] - Related file paths
+ * @param {string[]} [input.labels] - Task labels for categorization
+ * @param {number} [input.estimatedMinutes] - Estimated completion time
+ * @returns {Promise<KanbanTask>} The created task with generated ID and timestamps
+ *
+ * @example
+ * ```typescript
+ * const task = await createTask({
+ *   sessionId: 'session-123',
+ *   title: 'Implement authentication',
+ *   priority: 'high',
+ *   createdBy: 'agent-1',
+ *   labels: ['feature', 'auth'],
+ * });
+ * ```
+ */
+export declare function createTask(input: CreateTaskInput): Promise<KanbanTask>;
+/**
+ * Retrieve a task by its unique identifier
+ *
+ * @description Fetches a task from Redis by ID, deserializing JSON fields
+ *              (blockedBy, blocks, relatedFiles, labels)
+ * @param {string} taskId - Unique task identifier (UUID)
+ * @returns {Promise<KanbanTask | null>} The task if found, null otherwise
+ *
+ * @example
+ * ```typescript
+ * const task = await getTask('550e8400-e29b-41d4-a716-446655440000');
+ * if (task) {
+ *   console.log(`Task: ${task.title}, Status: ${task.status}`);
+ * }
+ * ```
+ */
+export declare function getTask(taskId: string): Promise<KanbanTask | null>;
+/**
+ * Update an existing task with new values
+ *
+ * @description Updates task fields, handles status transitions (emitting events),
+ *              manages blocking relationships, and persists changes to Redis
+ * @param {string} taskId - Unique task identifier
+ * @param {UpdateTaskInput} update - Fields to update
+ * @param {string} agentId - Agent ID performing the update
+ * @returns {Promise<KanbanTask | null>} Updated task or null if not found
+ * @throws {Error} Never throws - returns null on failure
+ *
+ * @example
+ * ```typescript
+ * const updated = await updateTask('task-123', {
+ *   status: 'in_progress',
+ *   priority: 'high',
+ * }, 'agent-1');
+ * ```
+ */
+export declare function updateTask(taskId: string, update: UpdateTaskInput, agentId: string): Promise<KanbanTask | null>;
+/**
+ * Claim a task for an agent (self-assignment)
+ *
+ * @description Allows an agent to claim an unassigned, unblocked task.
+ *              Sets the agent as assignee and transitions status to 'in_progress'.
+ *              Verifies blocking tasks are completed before allowing claim.
+ *              Uses atomic Lua script to prevent race conditions.
+ * @param {string} taskId - Task ID to claim
+ * @param {string} agentId - Agent ID claiming the task
+ * @returns {Promise<KanbanTask | null>} Claimed task or null if not found
+ * @throws {Error} If task is already assigned to another agent
+ * @throws {Error} If task is blocked by incomplete tasks
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const task = await claimTask('task-123', 'agent-1');
+ *   console.log(`Claimed: ${task?.title}`);
+ * } catch (error) {
+ *   console.error('Cannot claim:', error.message);
+ * }
+ * ```
+ */
+export declare function claimTask(taskId: string, agentId: string): Promise<KanbanTask | null>;
+/**
+ * Assign a task to a specific agent (supervisor action)
+ *
+ * @description Supervisors can assign tasks to any agent, overriding current assignment.
+ *              Updates agent indices and emits task-assigned event.
+ * @param {string} taskId - Task ID to assign
+ * @param {string} assigneeId - Target agent ID to assign the task to
+ * @param {string} supervisorId - Supervisor agent ID making the assignment
+ * @returns {Promise<KanbanTask | null>} Assigned task or null if not found
+ *
+ * @example
+ * ```typescript
+ * const task = await assignTask('task-123', 'worker-agent', 'supervisor-agent');
+ * ```
+ */
+export declare function assignTask(taskId: string, assigneeId: string, supervisorId: string): Promise<KanbanTask | null>;
+/**
+ * List tasks from a session with optional filtering
+ *
+ * @description Retrieves tasks sorted by priority, applying optional filters
+ *              for status, priority, assignee, blocked state, and labels
+ * @param {string} sessionId - Session ID to list tasks from
+ * @param {TaskFilter} [filter] - Optional filter criteria
+ * @param {TaskStatus|TaskStatus[]} [filter.status] - Filter by status(es)
+ * @param {TaskPriority|TaskPriority[]} [filter.priority] - Filter by priority(ies)
+ * @param {string} [filter.assignee] - Filter by assigned agent
+ * @param {boolean} [filter.unassigned] - Show only unassigned tasks
+ * @param {boolean} [filter.blocked] - Filter by blocked state
+ * @param {string[]} [filter.labels] - Filter by labels (any match)
+ * @param {number} [limit=50] - Maximum number of tasks to return
+ * @returns {Promise<KanbanTask[]>} Array of matching tasks sorted by priority
+ *
+ * @example
+ * ```typescript
+ * // Get all high-priority unassigned tasks
+ * const tasks = await listTasks('session-123', {
+ *   priority: 'high',
+ *   unassigned: true,
+ *   blocked: false,
+ * });
+ * ```
+ */
+export declare function listTasks(sessionId: string, filter?: TaskFilter, limit?: number): Promise<KanbanTask[]>;
+/**
+ * Get comprehensive Kanban board summary statistics
+ *
+ * @description Aggregates task data to provide board overview including
+ *              counts by status/priority, agent workload, and recent activity
+ * @param {string} sessionId - Session ID to get summary for
+ * @returns {Promise<BoardSummary>} Board summary with statistics and recent events
+ *
+ * @example
+ * ```typescript
+ * const summary = await getBoardSummary('session-123');
+ * console.log(`Total: ${summary.totalTasks}, In Progress: ${summary.byStatus.in_progress}`);
+ * console.log(`Blocked: ${summary.blockedTasks}, Unassigned: ${summary.unassignedTasks}`);
+ * ```
+ */
+export declare function getBoardSummary(sessionId: string): Promise<BoardSummary>;
+/**
+ * Permanently delete a task from the Kanban board
+ *
+ * @description Removes task data, updates all indices, and cleans up
+ *              blocking relationships with other tasks
+ * @param {string} taskId - Task ID to delete
+ * @returns {Promise<boolean>} True if task was deleted, false if not found
+ *
+ * @example
+ * ```typescript
+ * const deleted = await deleteTask('task-123');
+ * if (deleted) {
+ *   console.log('Task removed');
+ * }
+ * ```
+ */
+export declare function deleteTask(taskId: string): Promise<boolean>;
+/**
+ * Subscribe to real-time Kanban board events
+ *
+ * @description Creates a Redis Pub/Sub subscription for task events.
+ *              Returns an unsubscribe function for cleanup.
+ * @param {Function} callback - Function called with each TaskEvent
+ * @returns {Function} Unsubscribe function to stop receiving events
+ *
+ * @example
+ * ```typescript
+ * const unsubscribe = subscribeToEvents((event) => {
+ *   console.log(`Event: ${event.type} on task ${event.taskId}`);
+ * });
+ *
+ * // Later, to stop listening:
+ * unsubscribe();
+ * ```
+ */
+export declare function subscribeToEvents(callback: (event: TaskEvent) => void): () => void;
+/**
+ * Get all tasks assigned to a specific agent
+ *
+ * @description Retrieves all tasks currently assigned to the given agent
+ *              across all sessions
+ * @param {string} agentId - Agent ID to get tasks for
+ * @returns {Promise<KanbanTask[]>} Array of tasks assigned to the agent
+ *
+ * @example
+ * ```typescript
+ * const myTasks = await getAgentTasks('agent-1');
+ * const inProgress = myTasks.filter(t => t.status === 'in_progress');
+ * ```
+ */
+export declare function getAgentTasks(agentId: string): Promise<KanbanTask[]>;
+/**
+ * Get tasks available for claiming (unassigned, unblocked, in backlog)
+ *
+ * @description Convenience method to find tasks that agents can immediately
+ *              claim and start working on
+ * @param {string} sessionId - Session ID to search in
+ * @returns {Promise<KanbanTask[]>} Array of available tasks sorted by priority
+ *
+ * @example
+ * ```typescript
+ * const available = await getAvailableTasks('session-123');
+ * if (available.length > 0) {
+ *   await claimTask(available[0].id, 'agent-1');
+ * }
+ * ```
+ */
+export declare function getAvailableTasks(sessionId: string): Promise<KanbanTask[]>;
+//# sourceMappingURL=kanban-store.d.ts.map

package/dist/kanban/kanban-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kanban-store.d.ts","sourceRoot":"","sources":["../../src/kanban/kanban-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAcH,OAAO,EACL,UAAU,EAGV,eAAe,EACf,eAAe,EACf,SAAS,EACT,UAAU,EACV,YAAY,EAMb,MAAM,YAAY,CAAC;AAkBpB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CA8D5E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA6BxE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAqI5B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA4H3F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAwB5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,UAAU,EACnB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,UAAU,EAAE,CAAC,CAsDvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA8D9E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA+BjE;AA0DD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI,CAsFlF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAY1E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAEhF"}