feat: replies to comments

A comment can answer another one (replyTo), one level deep: answering a
reply joins the same thread, and it must be on the same ticket. Whoever
wrote the comment gets a new REPLIED notification, and the activity says
"respondió a un comentario".

A comment deleted while it has replies stays, without its text
(deleted: true), so the thread still reads; it goes with its last reply
and does not count in commentCount.

The ticket page shows threads with their replies indented and a
"Responder" box; REST, GraphQL and the MCP (add_comment, get_issue) take
and show replyTo. Existing comments are unchanged. Docs, Word and PDF
updated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

apps/mcp/src/app/api/taskstream.schema.ts

@@ -635,7 +635,7 @@ export interface paths {
         /** Comments of the ticket (oldest first) */
         get: operations["IssuesController_listComments"];
         put?: never;
-        /** Comment on the ticket */
+        /** Comment on the ticket, or answer a comment (replyTo) */
         post: operations["IssuesController_addComment"];
         delete?: never;
         options?: never;
@@ -2087,7 +2087,15 @@ export interface components {
             /** Format: uuid */
             issueId: string;
             author: components["schemas"]["UserRefDto"];
+            /** @description Empty on a deleted comment kept for its replies */
             body: string;
+            /**
+             * Format: uuid
+             * @description The top-level comment it answers; null for a top-level one
+             */
+            replyTo: string | null;
+            /** @description Deleted, but kept (without its text) while it has replies */
+            deleted: boolean;
             /** Format: date-time */
             createdAt: string;
             /** Format: date-time */
@@ -2098,9 +2106,14 @@ export interface components {
             items: components["schemas"]["CommentDto"][];
             total: number;
         };
-        CommentBodyDto: {
+        AddCommentDto: {
             /** @example Reproducido en Safari 17. */
             body: string;
+            /**
+             * Format: uuid
+             * @description Comment it answers (one level: answering a reply joins its thread)
+             */
+            replyTo?: string;
         };
         AttachFileDto: {
             /**
@@ -2114,6 +2127,10 @@ export interface components {
              */
             commentId?: string;
         };
+        CommentBodyDto: {
+            /** @example Reproducido en Safari 17. */
+            body: string;
+        };
         /** @enum {string} */
         ReleaseStatus: "PLANNED" | "RELEASED" | "ARCHIVED";
         ReleaseDto: {
@@ -2250,7 +2267,7 @@ export interface components {
             goodFirst: components["schemas"]["ShowcaseIssueDto"][];
         };
         /** @enum {string} */
-        NotificationKind: "ASSIGNED" | "STATUS_CHANGED" | "QA_FAILED" | "COMMENTED" | "MENTIONED" | "WATCHED" | "ADDED_TO_PROJECT" | "REMINDER";
+        NotificationKind: "ASSIGNED" | "STATUS_CHANGED" | "QA_FAILED" | "COMMENTED" | "MENTIONED" | "REPLIED" | "WATCHED" | "ADDED_TO_PROJECT" | "REMINDER";
         NotificationDto: {
             id: string;
             kind: components["schemas"]["NotificationKind"];
@@ -5497,7 +5514,7 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["CommentBodyDto"];
+                "application/json": components["schemas"]["AddCommentDto"];
             };
         };
         responses: {

apps/mcp/src/app/tools/issues.resolver.ts

@@ -224,9 +224,10 @@ export class IssuesResolver {
             )
           ).items.map((c) => ({
             id: c.id,
-            author: c.author.name,
+            replyTo: c.replyTo,
+            author: c.deleted ? null : c.author.name,
             at: c.createdAt,
-            body: c.body,
+            body: c.deleted ? '(deleted; kept for its replies)' : c.body,
           }))
         : undefined;
       const history = params.withHistory
@@ -411,19 +412,27 @@ export class IssuesResolver {
 
   @Tool({
     name: 'add_comment',
-    description: 'Comment on a ticket (decisions, explanations, steps).',
+    description:
+      'Comment on a ticket (decisions, explanations, steps), or answer a comment with replyTo (one level: answering a reply joins its thread).',
     paramsSchema: z.object({
       issue: issueRef,
       body: z.string().min(1).max(20000),
+      replyTo: z
+        .string()
+        .optional()
+        .describe('Id of the comment it answers (see get_issue)'),
     }),
     annotations: WRITE,
   })
-  comment({ issue, body }: { issue: string; body: string }, ctx: McpContext) {
+  comment(
+    { issue, body, replyTo }: { issue: string; body: string; replyTo?: string },
+    ctx: McpContext,
+  ) {
     return toolResult(() =>
       this.api.data(
         this.api.as(ctx).POST('/api/issues/{issue}/comments', {
           params: { path: { issue } },
-          body: { body },
+          body: { body, replyTo },
         }),
       ),
     );