TaskFlow MCP

Instructions

Implementation Reference

• src/tools/TaskFlowTools.ts:664-667 (handler)

  MCP tool handler: extracts optional requestIds from args and calls TaskFlowService.archiveCompletedRequests
  async archive_completed_requests(args: any) { const { requestIds } = args ?? {}; return service.archiveCompletedRequests(requestIds); },
• src/tools/TaskFlowTools.ts:490-507 (schema)

  Tool specification including name, description, and input schema for optional requestIds array.
  export const ARCHIVE_COMPLETED_REQUESTS_TOOL: Tool = { name: "archive_completed_requests", description: "Archive completed requests to a separate file to keep the active tasks file clean.\n\n" + "If 'requestIds' is provided, only those specific completed requests will be archived.\n" + "If 'requestIds' is not provided, all completed requests will be archived.\n\n" + "This addresses the need to keep active tasks file uncluttered by moving completed work to archive storage.", inputSchema: { type: "object", properties: { requestIds: { type: "array", items: { type: "string" }, description: "Optional array of specific request IDs to archive. If not provided, all completed requests will be archived." }, }, }, };
• src/services/TaskFlowService.ts:829-886 (helper)

  Core service method implementing the archiving logic: loads active tasks and archive files, identifies completed requests, moves them to archive file, saves both files, returns summary.
  public async archiveCompletedRequests(requestIds?: string[], mode: "manual" | "auto" = "manual") { await this.loadTasks(); const archive = await this.loadArchive(); let requestsToArchive: RequestEntry[]; if (requestIds && requestIds.length > 0) { // Archive specific requests requestsToArchive = this.data.requests.filter(req => requestIds.includes(req.requestId) && req.completed ); if (requestsToArchive.length === 0) { return { status: "no_completed_requests", message: "No completed requests found with the specified IDs." }; } } else { // Archive all completed requests requestsToArchive = this.data.requests.filter(req => req.completed); if (requestsToArchive.length === 0) { return { status: "no_completed_requests", message: "No completed requests found to archive." }; } } // Convert to archived format and add to archive const archivedRequests = requestsToArchive.map(req => this.createArchivedRequest(req)); archive.archivedRequests.push(...archivedRequests); // Update archive info archive.archiveInfo.lastArchivedAt = new Date().toISOString(); archive.archiveInfo.totalArchivedRequests = archive.archivedRequests.length; // Remove archived requests from active tasks this.data.requests = this.data.requests.filter(req => !requestsToArchive.some(archived => archived.requestId === req.requestId) ); await this.saveArchive(archive); await this.saveTasks(); return { status: "archived", archivedCount: archivedRequests.length, archivedRequests: archivedRequests.map(req => ({ requestId: req.originalRequestId, originalRequest: req.originalRequest, archivedAt: req.archivedAt })), message: `Successfully archived ${archivedRequests.length} completed request(s).`, archiveFilePath: ARCHIVE_FILE_PATH }; }
• src/server/TaskFlowServer.ts:63-89 (registration)

  Server registration: tool is included in the list returned by listTools handler, and handlers are bound via taskflowHandlers(service).
  this.server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [ PLAN_TASK_TOOL, GET_NEXT_TASK_TOOL, MARK_TASK_DONE_TOOL, OPEN_TASK_DETAILS_TOOL, LIST_REQUESTS_TOOL, ADD_TASKS_TO_REQUEST_TOOL, UPDATE_TASK_TOOL, DELETE_TASK_TOOL, ADD_SUBTASKS_TOOL, MARK_SUBTASK_DONE_TOOL, UPDATE_SUBTASK_TOOL, DELETE_SUBTASK_TOOL, EXPORT_TASK_STATUS_TOOL, ADD_NOTE_TOOL, UPDATE_NOTE_TOOL, DELETE_NOTE_TOOL, ADD_DEPENDENCY_TOOL, GET_PROMPTS_TOOL, SET_PROMPTS_TOOL, UPDATE_PROMPTS_TOOL, REMOVE_PROMPTS_TOOL, ARCHIVE_COMPLETED_REQUESTS_TOOL, LIST_ARCHIVED_REQUESTS_TOOL, RESTORE_ARCHIVED_REQUEST_TOOL, ],
• src/tools/TaskFlowTools.ts:664-667 (registration)

  Handler function provided by taskflowHandlers, dynamically routed in server CallToolRequestSchema handler.
  async archive_completed_requests(args: any) { const { requestIds } = args ?? {}; return service.archiveCompletedRequests(requestIds); },