comment_list
Read-onlyIdempotent
Fetch all comments on a task in chronological order. Provide the task ID to get the full comment history.
Instructions
List all comments on a task in chronological order.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | Task ID |
Implementation Reference
- src/tools/comments.ts:22-33 (schema)Schema/definition for the comment_list tool: name, description, annotations, and inputSchema requiring task_id (integer).
{ name: 'comment_list', description: 'List all comments on a task in chronological order.', annotations: { title: 'List Comments', readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, inputSchema: { type: 'object', properties: { task_id: { type: 'integer', description: 'Task ID' }, }, required: ['task_id'], }, }, - src/tools/comments.ts:57-64 (handler)Handler function handleCommentList that queries comments by task_id ordered by created_at ASC.
function handleCommentList(args: Record<string, unknown>) { const db = getDb(); const taskId = args.task_id as number; return db .prepare('SELECT * FROM comments WHERE task_id = ? ORDER BY created_at ASC') .all(taskId); } - src/tools/comments.ts:66-69 (registration)Exported handlers record mapping 'comment_list' to handleCommentList.
export const handlers: Record<string, ToolHandler> = { comment_add: handleCommentAdd, comment_list: handleCommentList, }; - src/index.ts:23-35 (registration)Registration of comment tool definitions (including comment_list) into ALL_TOOLS array.
const ALL_TOOLS: Tool[] = [ ...projectDefs, ...epicDefs, ...taskDefs, ...subtaskDefs, ...noteDefs, ...commentDefs, ...templateDefs, ...dashboardDefs, ...searchDefs, ...activityDefs, ...exportImportDefs, ]; - src/index.ts:37-49 (registration)Registration of comment handlers (including comment_list) into ALL_HANDLERS record.
const ALL_HANDLERS: Record<string, (args: Record<string, unknown>) => unknown> = { ...projectHandlers, ...epicHandlers, ...taskHandlers, ...subtaskHandlers, ...noteHandlers, ...commentHandlers, ...templateHandlers, ...dashboardHandlers, ...searchHandlers, ...activityHandlers, ...exportImportHandlers, };