add_task_comment
Add markdown-formatted comments to specific tasks in Dart project management without altering task descriptions, enhancing task clarity and collaboration.
Instructions
Add a comment to an existing task without modifying the task description. Comments support markdown formatting.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| taskId | Yes | The 12-character alphanumeric ID of the task | |
| text | Yes | The full content of the comment, which can include markdown formatting. |
Implementation Reference
- index.ts:474-484 (handler)The switch case in the CallToolRequestSchema handler that implements the logic for the 'add_task_comment' tool: validates taskId, constructs comment data, calls CommentService.addTaskComment, and returns the JSON stringified result.
case ADD_TASK_COMMENT_TOOL.name: { const taskId = getIdValidated(args.taskId); const text = args.text; const commentData = { taskId, text } as CommentCreate; const comment = await CommentService.addTaskComment({ item: commentData, }); return { content: [{ type: "text", text: JSON.stringify(comment, null, 2) }], }; } - tools.ts:369-389 (schema)The Tool object definition for 'add_task_comment', specifying the name, description, and inputSchema with required taskId and text parameters.
export const ADD_TASK_COMMENT_TOOL: Tool = { name: "add_task_comment", description: "Add a comment to an existing task without modifying the task description. Comments support markdown formatting.", inputSchema: { type: "object", properties: { taskId: { type: "string", description: "The 12-character alphanumeric ID of the task", pattern: "^[a-zA-Z0-9]{12}$", }, text: { type: "string", description: "The full content of the comment, which can include markdown formatting.", }, }, required: ["taskId", "text"], }, }; - index.ts:192-214 (registration)The TOOLS array registers ADD_TASK_COMMENT_TOOL among other tools, which is provided in response to ListToolsRequestSchema.
const TOOLS = [ // Config GET_CONFIG_TOOL, // Tasks CREATE_TASK_TOOL, LIST_TASKS_TOOL, GET_TASK_TOOL, UPDATE_TASK_TOOL, DELETE_TASK_TOOL, // Docs CREATE_DOC_TOOL, LIST_DOCS_TOOL, GET_DOC_TOOL, UPDATE_DOC_TOOL, DELETE_DOC_TOOL, // Comments ADD_TASK_COMMENT_TOOL, LIST_TASK_COMMENTS_TOOL, // Other GET_DARTBOARD_TOOL, GET_FOLDER_TOOL, GET_VIEW_TOOL, ]; - index.ts:35-52 (registration)Import statement that brings ADD_TASK_COMMENT_TOOL into index.ts for use in handlers and registration.
import { ADD_TASK_COMMENT_TOOL, CREATE_DOC_TOOL, CREATE_TASK_TOOL, DELETE_DOC_TOOL, DELETE_TASK_TOOL, GET_CONFIG_TOOL, GET_DARTBOARD_TOOL, GET_DOC_TOOL, GET_FOLDER_TOOL, GET_TASK_TOOL, GET_VIEW_TOOL, LIST_DOCS_TOOL, LIST_TASK_COMMENTS_TOOL, LIST_TASKS_TOOL, UPDATE_DOC_TOOL, UPDATE_TASK_TOOL, } from "./tools.js";