/**
* handlers/subtaskHandlers.ts
* Handlers for subtask operations within reminders
*/
import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
import type { Subtask, SubtasksToolArgs } from '../../types/index.js';
import { handleAsyncOperation } from '../../utils/errorHandling.js';
import { reminderRepository } from '../../utils/reminderRepository.js';
import {
addSubtask,
getSubtaskProgress,
parseSubtasks,
removeSubtask,
reorderSubtasks,
toggleSubtask,
updateSubtask,
} from '../../utils/subtaskUtils.js';
import {
CreateSubtaskSchema,
DeleteSubtaskSchema,
ReadSubtasksSchema,
ReorderSubtasksSchema,
ToggleSubtaskSchema,
UpdateSubtaskSchema,
} from '../../validation/schemas.js';
import { extractAndValidateArgs, formatSuccessMessage } from './shared.js';
/**
* Formats a single subtask for display
*/
const formatSubtaskMarkdown = (subtask: Subtask, index: number): string => {
const checkbox = subtask.isCompleted ? '[x]' : '[ ]';
return `${index + 1}. ${checkbox} ${subtask.title} (ID: ${subtask.id})`;
};
/**
* Formats subtasks list with progress
*/
const formatSubtasksListMarkdown = (
reminderTitle: string,
subtasks: Subtask[],
): string => {
const lines: string[] = [];
const progress = getSubtaskProgress(subtasks);
lines.push(`### Subtasks for "${reminderTitle}"`);
lines.push('');
lines.push(
`**Progress:** ${progress.completed}/${progress.total} (${progress.percentage}%)`,
);
lines.push('');
if (subtasks.length === 0) {
lines.push('No subtasks found.');
} else {
subtasks.forEach((subtask, index) => {
lines.push(formatSubtaskMarkdown(subtask, index));
});
}
return lines.join('\n');
};
export const handleReadSubtasks = async (
args: SubtasksToolArgs,
): Promise<CallToolResult> => {
return handleAsyncOperation(async () => {
const validatedArgs = extractAndValidateArgs(args, ReadSubtasksSchema);
const reminder = await reminderRepository.findReminderById(
validatedArgs.reminderId,
);
const subtasks = parseSubtasks(reminder.notes);
return formatSubtasksListMarkdown(reminder.title, subtasks);
}, 'read subtasks');
};
export const handleCreateSubtask = async (
args: SubtasksToolArgs,
): Promise<CallToolResult> => {
return handleAsyncOperation(async () => {
const validatedArgs = extractAndValidateArgs(args, CreateSubtaskSchema);
const reminder = await reminderRepository.findReminderById(
validatedArgs.reminderId,
);
const { notes: updatedNotes, subtask } = addSubtask(
validatedArgs.title,
reminder.notes,
);
await reminderRepository.updateReminder({
id: validatedArgs.reminderId,
notes: updatedNotes,
});
return formatSuccessMessage(
'created',
'subtask',
subtask.title,
subtask.id,
);
}, 'create subtask');
};
export const handleUpdateSubtask = async (
args: SubtasksToolArgs,
): Promise<CallToolResult> => {
return handleAsyncOperation(async () => {
const validatedArgs = extractAndValidateArgs(args, UpdateSubtaskSchema);
const reminder = await reminderRepository.findReminderById(
validatedArgs.reminderId,
);
const updatedNotes = updateSubtask(
validatedArgs.subtaskId,
{
title: validatedArgs.title,
isCompleted: validatedArgs.completed,
},
reminder.notes,
);
await reminderRepository.updateReminder({
id: validatedArgs.reminderId,
notes: updatedNotes,
});
return `✅ Updated subtask with ID ${validatedArgs.subtaskId}`;
}, 'update subtask');
};
export const handleDeleteSubtask = async (
args: SubtasksToolArgs,
): Promise<CallToolResult> => {
return handleAsyncOperation(async () => {
const validatedArgs = extractAndValidateArgs(args, DeleteSubtaskSchema);
const reminder = await reminderRepository.findReminderById(
validatedArgs.reminderId,
);
const updatedNotes = removeSubtask(validatedArgs.subtaskId, reminder.notes);
await reminderRepository.updateReminder({
id: validatedArgs.reminderId,
notes: updatedNotes,
});
return `✅ Deleted subtask with ID ${validatedArgs.subtaskId}`;
}, 'delete subtask');
};
export const handleToggleSubtask = async (
args: SubtasksToolArgs,
): Promise<CallToolResult> => {
return handleAsyncOperation(async () => {
const validatedArgs = extractAndValidateArgs(args, ToggleSubtaskSchema);
const reminder = await reminderRepository.findReminderById(
validatedArgs.reminderId,
);
const { notes: updatedNotes, subtask } = toggleSubtask(
validatedArgs.subtaskId,
reminder.notes,
);
await reminderRepository.updateReminder({
id: validatedArgs.reminderId,
notes: updatedNotes,
});
const status = subtask.isCompleted ? 'completed' : 'uncompleted';
return `✅ Subtask "${subtask.title}" marked as ${status}`;
}, 'toggle subtask');
};
export const handleReorderSubtasks = async (
args: SubtasksToolArgs,
): Promise<CallToolResult> => {
return handleAsyncOperation(async () => {
const validatedArgs = extractAndValidateArgs(args, ReorderSubtasksSchema);
const reminder = await reminderRepository.findReminderById(
validatedArgs.reminderId,
);
const updatedNotes = reorderSubtasks(validatedArgs.order, reminder.notes);
await reminderRepository.updateReminder({
id: validatedArgs.reminderId,
notes: updatedNotes,
});
return `✅ Reordered ${validatedArgs.order.length} subtasks`;
}, 'reorder subtasks');
};
