@vitalyostanin/youtrack-mcp 0.2.0 → 0.3.0

package/README-ru.md

@@ -3,7 +3,18 @@
 [![CI](https://github.com/VitalyOstanin/youtrack-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/VitalyOstanin/youtrack-mcp/actions/workflows/ci.yml)
 [![npm version](https://img.shields.io/npm/v/@vitalyostanin/youtrack-mcp.svg)](https://www.npmjs.com/package/@vitalyostanin/youtrack-mcp)
 
-MCP сервер для полноценной интеграции с YouTrack. Управление задачами, учёт трудозатрат с детальными отчётами, поиск по активности пользователей, работа со статьями базы знаний, доступ к проектам и пользователям. Поддержка учёта времени с конфигурацией праздников/предпраздничных дней, пакетные операции и структурированные ответы для AI-клиентов.
+MCP сервер для полноценной интеграции с YouTrack со следующими возможностями:
+
+- **Управление задачами** - создание, обновление, комментирование, назначение, изменение статуса, пакетные операции
+- **Управление вложениями** - загрузка файлов (до 10), скачивание по подписанным URL, удаление
+- **Учёт трудозатрат** - создание записей с идемпотентными операциями, массовое создание за период
+- **Детальные отчёты по времени** - сводные отчёты, анализ отклонений, статистика по пользователям
+- **Расширенный поиск** - поиск задач по активности пользователей с быстрым/точным режимами фильтрации
+- **История изменений** - полный журнал активности задач с фильтрацией и пагинацией
+- **База знаний** - создание, обновление, поиск статей с иерархической структурой
+- **Доступ к пользователям и проектам** - получение информации о пользователях и проектах
+- **Пакетные операции** - эффективная обработка до 50 задач одновременно
+- **Дополнительные возможности** - поддержка Markdown, сворачиваемые секции, конфигурация праздников, алиасы пользователей
 
 ## Содержание
 
@@ -232,6 +243,9 @@ env = { "YOUTRACK_URL" = "https://youtrack.example.com", "YOUTRACK_TOKEN" = "per
 | `issue_update` | Обновление существующей задачи. **Использование:** Изменение summary, description, родительской задачи. **Примечание:** для изменения исполнителя используйте `issue_assign`. Пустая строка в `parentIssueId` удаляет родителя. **Возвращает:** стандартные поля обновленной задачи | `issueId` — ID или код задачи, опционально `summary`, `description`, `parentIssueId` (пустая строка очищает родителя), `usesMarkdown` |
 | `issue_assign` | Назначение исполнителя для задачи. **Использование:** Изменение исполнителя задачи. Поддерживает алиас `me` для текущего пользователя. **Возвращает:** стандартные поля обновленной задачи | `issueId` — ID или код задачи, `assigneeLogin` — логин исполнителя или `me` |
 | `issue_comment_create` | Добавление комментария к задаче. **Использование:** Оставлять комментарии, заметки, обсуждения в задачах. Поддерживает Markdown. **Возвращает:** поля комментария - id, text, textPreview, usesMarkdown, author, created, updated | `issueId` — ID или код задачи, `text` — текст комментария, опционально `usesMarkdown` |
+| `issue_comment_update` | Обновление существующего комментария. **Использование:** Редактирование текста комментария, изменение режима форматирования, исправление опечаток. Поддерживает Markdown. **Возвращает:** поля комментария - id, text, textPreview, usesMarkdown, author, created, updated, commentUrl | `issueId` — ID или код задачи, `commentId` — ID комментария, опционально `text`, `usesMarkdown`, `muteUpdateNotifications` |
+| `issue_activities` | Получение истории изменений задачи (активности). **Использование:** Просмотр полной истории задачи, отслеживание изменений полей во времени, мониторинг кто и когда что изменил, анализ эволюции задачи, аудит модификаций. **Возвращает:** Элементы активности с временными метками (ISO datetime), авторами, категориями, типами изменений и деталями изменений (добавленные/удалённые значения). Поддерживает фильтрацию по автору, диапазону дат и категориям активности. **Примечание:** Возвращает предопределённые поля - id, timestamp, author (id, login, name), category (id), target (text), добавленные значения, удалённые значения, тип активности. Полезно для понимания жизненного цикла задачи, отслеживания модификаций полей, просмотра истории комментариев и анализа паттернов совместной работы. | `issueId` — код задачи, опционально `author` (логин пользователя), `startDate` (формат YYYY-MM-DD, timestamp или Date), `endDate`, `categories` (через запятую: `CustomFieldCategory` для изменений полей, `CommentsCategory` для комментариев, `AttachmentsCategory` для вложений, `LinksCategory` для связей, `VcsChangeActivityCategory` для VCS изменений, `WorkItemsActivityCategory` для трудозатрат), `limit` (макс 200), `skip` для пагинации |
+| `issue_change_state` | Изменение состояния/статуса задачи через переходы workflow. **Использование:** Перемещение задач через состояния рабочего процесса (например, 'Открыта' → 'В работе'). Автоматически определяет доступные переходы и валидирует запрошенное изменение состояния. Регистронезависимое сопоставление имён состояний. **Возвращает:** информацию о предыдущем состоянии, новом состоянии и использованном переходе | `issueId` — код задачи, `stateName` — имя целевого состояния (например, 'В работе', 'Открыта', 'Исправлена', 'Проверена'). Регистронезависимое |
 | `issue_search_by_user_activity` | Поиск задач по активности пользователей в заданный период. **Использование:** Поиск задач, где пользователи обновляли, были упомянуты, создавали, были назначены или комментировали. Поддерживает два режима фильтрации: `issue_updated` (по умолчанию, быстрый) использует поле issue.updated, `user_activity` (медленный, точный) проверяет фактические даты активности пользователя, включая комментарии, упоминания и историю изменений полей. **Когда использовать точный режим:** когда нужна точная дата участия пользователя (например, когда пользователь был исполнителем, но позже был изменён). **Возвращает:** краткую информацию о задачах (id, idReadable, summary, project, parent, assignee) без description для уменьшения размера ответа. В режиме `user_activity` включает поле `lastActivityDate` с точной датой последней активности пользователя. Результаты отсортированы по времени активности (новые первыми). Поддерживает пагинацию. **Ограничение:** по умолчанию 100 задач, макс 200 | `userLogins[]` — массив логинов пользователей для поиска активности (updater, mentions, reporter, assignee, commenter), опционально `startDate` (формат YYYY-MM-DD или timestamp), `endDate`, `dateFilterMode` (`issue_updated` или `user_activity`), `limit` (по умолчанию 100, макс 200), `skip` для пагинации |
 
 ### Трудозатраты

package/README.md

@@ -3,7 +3,18 @@
 [![CI](https://github.com/VitalyOstanin/youtrack-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/VitalyOstanin/youtrack-mcp/actions/workflows/ci.yml)
 [![npm version](https://img.shields.io/npm/v/@vitalyostanin/youtrack-mcp.svg)](https://www.npmjs.com/package/@vitalyostanin/youtrack-mcp)
 
-MCP server for comprehensive YouTrack integration. Manage issues, track work items with detailed reports, search by user activity, work with knowledge base articles, and access projects and users. Supports time tracking with holiday/pre-holiday configuration, batch operations, and structured responses for AI clients.
+MCP server for comprehensive YouTrack integration with the following capabilities:
+
+- **Issue management** - create, update, comment, assign, change state, batch operations
+- **Attachment management** - upload files (up to 10), download with signed URLs, delete
+- **Work items tracking** - create entries with idempotent operations, batch creation for periods
+- **Detailed time reports** - summary reports, deviation analysis, multi-user statistics
+- **Advanced search** - find issues by user activity with fast/precise filtering modes
+- **Change history** - complete issue activity log with filtering and pagination
+- **Knowledge base** - create, update, search articles with hierarchical structure
+- **User and project access** - retrieve information about users and projects
+- **Batch operations** - efficient processing of up to 50 issues simultaneously
+- **Additional features** - Markdown support, folded sections, holiday configuration, user aliases
 
 ## Table of Contents
 
@@ -230,6 +241,9 @@ All tools return `structuredContent` with a `success` flag and payload formatted
 | `issue_update` | Update existing issue | `issueId`, optionally `summary`, `description`, `parentIssueId` (empty string clears parent), `usesMarkdown` |
 | `issue_assign` | Assign issue to user | `issueId`, `assigneeLogin` (login or `me`) |
 | `issue_comment_create` | Add comment to issue | `issueId`, `text` — comment text, optionally `usesMarkdown` |
+| `issue_comment_update` | Update existing comment | `issueId`, `commentId`, optionally `text`, `usesMarkdown`, `muteUpdateNotifications` |
+| `issue_activities` | Get issue change history | `issueId` — issue code, optionally `author` (login), `startDate` (YYYY-MM-DD, timestamp, or Date), `endDate`, `categories` (comma-separated: `CustomFieldCategory` for field changes, `CommentsCategory` for comments, `AttachmentsCategory` for attachments, `LinksCategory` for links, `VcsChangeActivityCategory` for VCS changes, `WorkItemsActivityCategory` for work items), `limit` (max 200), `skip` for pagination. Returns activity items with timestamps (ISO datetime), authors, categories, and change details (added/removed values). Useful for tracking field modifications, reviewing comment history, and analyzing collaboration patterns |
+| `issue_change_state` | Change issue state/status through workflow transitions | `issueId` — issue code, `stateName` — target state name (e.g., 'In Progress', 'Open', 'Fixed', 'Verified'). Case-insensitive. Automatically discovers available transitions and validates requested state change. Returns information about previous state, new state, and transition used. Use for moving issues through workflow states |
 | `issue_search_by_user_activity` | Search issues with user activity | `userLogins[]` — array of user logins, optionally `startDate`, `endDate`, `dateFilterMode` (`issue_updated` fast mode or `user_activity` precise mode), `limit` (default 100, max 200). Finds issues where users updated, mentioned, reported, assigned, or commented. Fast mode filters by issue.updated field; precise mode checks actual user activity dates including comments, mentions, and field changes history (e.g., when user was assignee but later changed). In precise mode, returns `lastActivityDate` field. Sorted by activity time (newest first) |
 | `issue_attachments_list` | Get list of attachments | `issueId` — issue code |
 | `issue_attachment_get` | Get attachment info | `issueId`, `attachmentId` |

package/dist/src/server.js

@@ -1,6 +1,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { registerServiceInfoTool } from "./tools/service-info.js";
 import { registerIssueTools } from "./tools/issue-tools.js";
+import { registerIssueActivityTools } from "./tools/issue-activity-tools.js";
 import { registerIssueSearchTools } from "./tools/issue-search-tools.js";
 import { registerWorkitemTools } from "./tools/workitem-tools.js";
 import { registerWorkitemReportTools } from "./tools/workitem-report-tools.js";
@@ -12,13 +13,14 @@ import { registerAttachmentTools } from "./tools/attachment-tools.js";
 import { YoutrackClient } from "./youtrack-client.js";
 import { loadConfig } from "./config.js";
 import { initializeTimezone } from "./utils/date.js";
+import { VERSION } from "./version.js";
 export class YoutrackServer {
     server;
     client;
     constructor() {
         this.server = new McpServer({
             name: "youtrack-mcp",
-            version: "0.2.0",
+            version: VERSION,
         }, {
             capabilities: {
                 tools: {
@@ -32,6 +34,7 @@ export class YoutrackServer {
         this.client = new YoutrackClient(config);
         registerServiceInfoTool(this.server, this.client);
         registerIssueTools(this.server, this.client);
+        registerIssueActivityTools(this.server, this.client);
         registerIssueSearchTools(this.server, this.client);
         registerWorkitemTools(this.server, this.client);
         registerWorkitemReportTools(this.server, this.client);

package/dist/src/tools/article-tools.js

@@ -9,7 +9,10 @@ const articleListArgs = {
 };
 const articleCreateArgs = {
     summary: z.string().min(1).describe("Article title"),
-    content: z.string().optional().describe("Article content"),
+    content: z
+        .string()
+        .optional()
+        .describe("Article content. Supports folded sections: <details> <summary>Title</summary>Content</details>"),
     parentArticleId: z.string().optional().describe("Parent article ID"),
     projectId: z.string().optional().describe("Project ID"),
     usesMarkdown: z.boolean().optional().describe("Use Markdown formatting"),
@@ -18,7 +21,10 @@ const articleCreateArgs = {
 const articleUpdateArgs = {
     articleId: z.string().min(1).describe("Article ID"),
     summary: z.string().optional().describe("New title"),
-    content: z.string().optional().describe("New content"),
+    content: z
+        .string()
+        .optional()
+        .describe("New content. Supports folded sections: <details> <summary>Title</summary>Content</details>"),
     usesMarkdown: z.boolean().optional().describe("Use Markdown formatting"),
     returnRendered: z.boolean().optional().describe("Return rendered content preview"),
 };
@@ -54,7 +60,7 @@ export function registerArticleTools(server, client) {
             return errorResponse;
         }
     });
-    server.tool("article_create", "Create article in YouTrack knowledge base. Note: Response includes predefined fields only - id, idReadable, summary, content, contentPreview, usesMarkdown, parentArticle (id, idReadable), project (id, shortName, name).", articleCreateArgs, async (rawInput) => {
+    server.tool("article_create", "Create article in YouTrack knowledge base. Supports markdown with folded sections (<details>/<summary>) in content. Note: Response includes predefined fields only - id, idReadable, summary, content, contentPreview, usesMarkdown, parentArticle (id, idReadable), project (id, shortName, name).", articleCreateArgs, async (rawInput) => {
         try {
             const payload = articleCreateSchema.parse(rawInput);
             const article = await client.createArticle({
@@ -73,7 +79,7 @@ export function registerArticleTools(server, client) {
             return errorResponse;
         }
     });
-    server.tool("article_update", "Update existing article. Note: Response includes predefined fields only - id, idReadable, summary, content, contentPreview, usesMarkdown, parentArticle (id, idReadable), project (id, shortName, name).", articleUpdateArgs, async (rawInput) => {
+    server.tool("article_update", "Update existing article. Supports markdown with folded sections (<details>/<summary>) in content. Note: Response includes predefined fields only - id, idReadable, summary, content, contentPreview, usesMarkdown, parentArticle (id, idReadable), project (id, shortName, name).", articleUpdateArgs, async (rawInput) => {
         try {
             const payload = articleUpdateSchema.parse(rawInput);
             if (payload.summary === undefined && payload.content === undefined) {

package/dist/src/tools/issue-activity-tools.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { YoutrackClient } from "../youtrack-client.js";
+export declare function registerIssueActivityTools(server: McpServer, client: YoutrackClient): void;
+//# sourceMappingURL=issue-activity-tools.d.ts.map

package/dist/src/tools/issue-activity-tools.js

@@ -0,0 +1,78 @@
+import { z } from "zod";
+import { toolError, toolSuccess } from "../utils/tool-response.js";
+import { mapActivityItems } from "../utils/mappers.js";
+import { toIsoDateString } from "../utils/date.js";
+// Zod args definition
+const issueActivitiesArgs = {
+    issueId: z.string().min(1).describe("Issue code (e.g., PROJ-123)"),
+    author: z.string().optional().describe("Filter by author login (e.g., 'john.doe')"),
+    startDate: z
+        .union([z.string(), z.number(), z.date()])
+        .optional()
+        .describe("Start date for filtering (format: YYYY-MM-DD, timestamp, or Date object)"),
+    endDate: z
+        .union([z.string(), z.number(), z.date()])
+        .optional()
+        .describe("End date for filtering (format: YYYY-MM-DD, timestamp, or Date object)"),
+    categories: z
+        .string()
+        .optional()
+        .describe("Filter by activity categories (comma-separated). Common values: 'CustomFieldCategory' (field changes), 'CommentsCategory' (comments), 'AttachmentsCategory' (attachments), 'LinksCategory' (links), 'VcsChangeActivityCategory' (VCS changes), 'WorkItemsActivityCategory' (work items). Note: Currently not implemented in API call - reserved for future use."),
+    limit: z
+        .number()
+        .int()
+        .positive()
+        .max(200)
+        .optional()
+        .describe("Maximum number of activities to return (default: no limit, max: 200)"),
+    skip: z.number().int().min(0).optional().describe("Number of activities to skip for pagination (default: 0)"),
+};
+const issueActivitiesSchema = z.object(issueActivitiesArgs);
+export function registerIssueActivityTools(server, client) {
+    server.tool("issue_activities", "Get issue change history (activities). Use for: Viewing complete issue history, tracking field changes over time, monitoring who changed what and when, analyzing issue evolution, auditing modifications. Returns: Activity items with timestamps (ISO datetime), authors, categories, change types, and change details (added/removed values). Supports filtering by author, date range, and activity categories. Note: Returns predefined fields only - id, timestamp, author (id, login, name), category (id), target (text), added values, removed values, activity type. Useful for understanding issue lifecycle, tracking field modifications, reviewing comment history, and analyzing collaboration patterns.", issueActivitiesArgs, async (rawInput) => {
+        try {
+            const input = issueActivitiesSchema.parse(rawInput);
+            // Convert dates to timestamps if provided
+            const startTimestamp = input.startDate ? new Date(input.startDate).getTime() : undefined;
+            const endTimestamp = input.endDate ? new Date(input.endDate).getTime() : undefined;
+            // Get activities from client
+            const activities = await client.getIssueActivities(input.issueId, {
+                author: input.author,
+                startDate: startTimestamp,
+                endDate: endTimestamp,
+            });
+            // Map activities to include ISO datetime strings
+            const mappedActivities = mapActivityItems(activities);
+            // Apply pagination if specified
+            const skip = input.skip ?? 0;
+            const { limit } = input;
+            let paginatedActivities = mappedActivities;
+            if (skip > 0 || limit !== undefined) {
+                const start = skip;
+                const end = limit !== undefined ? skip + limit : undefined;
+                paginatedActivities = mappedActivities.slice(start, end);
+            }
+            const payload = {
+                activities: paginatedActivities,
+                issueId: input.issueId,
+                filters: {
+                    author: input.author,
+                    startDate: input.startDate ? toIsoDateString(input.startDate) : undefined,
+                    endDate: input.endDate ? toIsoDateString(input.endDate) : undefined,
+                    categories: input.categories,
+                },
+                pagination: {
+                    returned: paginatedActivities.length,
+                    total: mappedActivities.length,
+                    limit: input.limit,
+                    skip: input.skip ?? 0,
+                },
+            };
+            return toolSuccess(payload);
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+}
+//# sourceMappingURL=issue-activity-tools.js.map

package/dist/src/tools/issue-tools.js

@@ -15,7 +15,10 @@ const issueIdsSchema = z.object(issueIdsArgs);
 const issueCreateArgs = {
     projectId: z.string().min(1).describe("Project ID (YouTrack internal id)"),
     summary: z.string().min(1).describe("Brief issue description"),
-    description: z.string().optional().describe("Full description"),
+    description: z
+        .string()
+        .optional()
+        .describe("Full description. Supports folded sections: <details> <summary>Title</summary>Content</details>"),
     parentIssueId: z.string().optional().describe("Parent issue ID"),
     assigneeLogin: z.string().optional().describe("Assignee login or me"),
     usesMarkdown: z.boolean().optional().describe("Use Markdown formatting"),
@@ -24,7 +27,10 @@ const issueCreateSchema = z.object(issueCreateArgs);
 const issueUpdateArgs = {
     issueId: z.string().min(1).describe("Issue ID or code"),
     summary: z.string().optional().describe("New summary"),
-    description: z.string().optional().describe("New description"),
+    description: z
+        .string()
+        .optional()
+        .describe("New description. Supports folded sections: <details> <summary>Title</summary>Content</details>"),
     parentIssueId: z.string().optional().describe("New parent or empty string to remove"),
     usesMarkdown: z.boolean().optional().describe("Use Markdown formatting"),
 };
@@ -36,10 +42,32 @@ const issueAssignArgs = {
 const issueAssignSchema = z.object(issueAssignArgs);
 const issueCommentCreateArgs = {
     issueId: z.string().min(1).describe("Issue ID or code"),
-    text: z.string().min(1).describe("Comment text"),
+    text: z
+        .string()
+        .min(1)
+        .describe("Comment text. Supports folded sections for hiding large blocks (logs, code): <details> <summary>Title</summary>Content</details>"),
     usesMarkdown: z.boolean().optional().describe("Use Markdown formatting"),
 };
 const issueCommentCreateSchema = z.object(issueCommentCreateArgs);
+const issueCommentUpdateArgs = {
+    issueId: z.string().min(1).describe("Issue ID or code"),
+    commentId: z.string().min(1).describe("Comment ID"),
+    text: z
+        .string()
+        .optional()
+        .describe("New comment text. Supports folded sections: <details> <summary>Title</summary>Content</details>"),
+    usesMarkdown: z.boolean().optional().describe("Use Markdown formatting"),
+    muteUpdateNotifications: z.boolean().optional().describe("Do not send update notifications"),
+};
+const issueCommentUpdateSchema = z.object(issueCommentUpdateArgs);
+const issueChangeStateArgs = {
+    issueId: z.string().min(1).describe("Issue code (e.g., BC-9205)"),
+    stateName: z
+        .string()
+        .min(1)
+        .describe("Target state name (e.g., 'In Progress', 'Open', 'Fixed', 'Verified'). Case-insensitive."),
+};
+const issueChangeStateSchema = z.object(issueChangeStateArgs);
 export function registerIssueTools(server, client) {
     server.tool("issue_lookup", "Get brief information about YouTrack issue. Note: Returns predefined fields only - id, idReadable, summary, description, wikifiedDescription, usesMarkdown, project (id, shortName, name), parent (id, idReadable), assignee (id, login, name). Custom fields are not included.", issueIdArgs, async (rawInput) => {
         try {
@@ -65,7 +93,7 @@ export function registerIssueTools(server, client) {
             return errorResponse;
         }
     });
-    server.tool("issue_comments", "Get issue comments. Note: Returns predefined fields only - id, text, textPreview, usesMarkdown, author (id, login, name), created, updated.", issueIdArgs, async (rawInput) => {
+    server.tool("issue_comments", "Get issue comments. Note: Returns predefined fields only - id, text, textPreview, usesMarkdown, author (id, login, name), created, updated, commentUrl (direct link to comment).", issueIdArgs, async (rawInput) => {
         try {
             const payload = issueIdSchema.parse(rawInput);
             const comments = await client.getIssueComments(payload.issueId);
@@ -77,7 +105,7 @@ export function registerIssueTools(server, client) {
             return errorResponse;
         }
     });
-    server.tool("issue_create", "Create new issue in YouTrack. Note: Response includes standard fields only (id, idReadable, summary, description, wikifiedDescription, usesMarkdown, project, parent, assignee). Custom fields are not included.", issueCreateArgs, async (rawInput) => {
+    server.tool("issue_create", "Create new issue in YouTrack. Supports markdown with folded sections (<details>/<summary>) in description. Note: Response includes standard fields only (id, idReadable, summary, description, wikifiedDescription, usesMarkdown, project, parent, assignee). Custom fields are not included.", issueCreateArgs, async (rawInput) => {
         try {
             const payload = issueCreateSchema.parse(rawInput);
             const issue = await client.createIssue({
@@ -96,7 +124,7 @@ export function registerIssueTools(server, client) {
             return errorResponse;
         }
     });
-    server.tool("issue_update", "Update existing issue. Note: Response includes standard fields only (id, idReadable, summary, description, wikifiedDescription, usesMarkdown, project, parent, assignee). Custom fields are not included.", issueUpdateArgs, async (rawInput) => {
+    server.tool("issue_update", "Update existing issue. Supports markdown with folded sections (<details>/<summary>) in description. Note: Response includes standard fields only (id, idReadable, summary, description, wikifiedDescription, usesMarkdown, project, parent, assignee). Custom fields are not included.", issueUpdateArgs, async (rawInput) => {
         try {
             const payload = issueUpdateSchema.parse(rawInput);
             if (payload.summary === undefined &&
@@ -134,7 +162,7 @@ export function registerIssueTools(server, client) {
             return errorResponse;
         }
     });
-    server.tool("issue_comment_create", "Add comment to issue. Note: Response includes comment fields - id, text, textPreview, usesMarkdown, author (id, login, name), created, updated.", issueCommentCreateArgs, async (rawInput) => {
+    server.tool("issue_comment_create", "Add comment to issue. Supports markdown with folded sections (<details>/<summary>) for hiding logs, code examples, etc. Note: Response includes comment fields - id, text, textPreview, usesMarkdown, author (id, login, name), created, updated, commentUrl (direct link to comment).", issueCommentCreateArgs, async (rawInput) => {
         try {
             const payload = issueCommentCreateSchema.parse(rawInput);
             const comment = await client.createIssueComment({
@@ -150,6 +178,27 @@ export function registerIssueTools(server, client) {
             return errorResponse;
         }
     });
+    server.tool("issue_comment_update", "Update existing issue comment. Supports markdown with folded sections (<details>/<summary>). Note: Response includes comment fields - id, text, textPreview, usesMarkdown, author (id, login, name), created, updated, commentUrl (direct link to comment). Use for: Editing comment text, changing formatting mode, correcting typos in comments.", issueCommentUpdateArgs, async (rawInput) => {
+        try {
+            const payload = issueCommentUpdateSchema.parse(rawInput);
+            if (payload.text === undefined && payload.usesMarkdown === undefined) {
+                throw new Error("At least one field (text or usesMarkdown) must be provided for update");
+            }
+            const result = await client.updateIssueComment({
+                issueId: payload.issueId,
+                commentId: payload.commentId,
+                text: payload.text,
+                usesMarkdown: payload.usesMarkdown,
+                muteUpdateNotifications: payload.muteUpdateNotifications,
+            });
+            const response = toolSuccess(result);
+            return response;
+        }
+        catch (error) {
+            const errorResponse = toolError(error);
+            return errorResponse;
+        }
+    });
     server.tool("issues_lookup", "Get brief information about multiple YouTrack issues (batch mode, max 50). Note: Returns predefined fields only - id, idReadable, summary, description, wikifiedDescription, usesMarkdown, project (id, shortName, name), parent (id, idReadable), assignee (id, login, name). Custom fields are not included.", issueIdsArgs, async (rawInput) => {
         try {
             const payload = issueIdsSchema.parse(rawInput);
@@ -174,7 +223,7 @@ export function registerIssueTools(server, client) {
             return errorResponse;
         }
     });
-    server.tool("issues_comments", "Get comments for multiple YouTrack issues (batch mode, max 50). Note: Returns predefined fields only - id, text, textPreview, usesMarkdown, author (id, login, name), created, updated.", issueIdsArgs, async (rawInput) => {
+    server.tool("issues_comments", "Get comments for multiple YouTrack issues (batch mode, max 50). Note: Returns predefined fields only - id, text, textPreview, usesMarkdown, author (id, login, name), created, updated, commentUrl (direct link to comment).", issueIdsArgs, async (rawInput) => {
         try {
             const payload = issueIdsSchema.parse(rawInput);
             const result = await client.getMultipleIssuesComments(payload.issueIds);
@@ -186,5 +235,20 @@ export function registerIssueTools(server, client) {
             return errorResponse;
         }
     });
+    server.tool("issue_change_state", "Change issue state/status using state machine transitions. Use for: Moving issues through workflow states (e.g., from 'Open' to 'In Progress'), updating issue status, triggering state transitions. Note: Only valid transitions are allowed based on current state and workflow rules. The tool automatically discovers available transitions and validates the requested state change. Returns information about the previous state, new state, and the transition used.", issueChangeStateArgs, async (rawInput) => {
+        try {
+            const payload = issueChangeStateSchema.parse(rawInput);
+            const result = await client.changeIssueState({
+                issueId: payload.issueId,
+                stateName: payload.stateName,
+            });
+            const response = toolSuccess(result);
+            return response;
+        }
+        catch (error) {
+            const errorResponse = toolError(error);
+            return errorResponse;
+        }
+    });
 }
 //# sourceMappingURL=issue-tools.js.map

package/dist/src/tools/service-info.js

@@ -1,5 +1,6 @@
 import { ZodError } from "zod";
 import { loadConfig, enrichConfigWithRedaction } from "../config.js";
+import { VERSION } from "../version.js";
 export function registerServiceInfoTool(server, client) {
     server.tool("service_info", "Get YouTrack integration status and environment configuration", async () => {
         try {
@@ -8,7 +9,7 @@ export function registerServiceInfoTool(server, client) {
             const payload = {
                 service: {
                     name: "youtrack-mcp",
-                    version: "0.1.0",
+                    version: VERSION,
                 },
                 configuration: enrichConfigWithRedaction(config),
             };

package/dist/src/tools/workitem-tools.js

@@ -24,7 +24,10 @@ const workItemCreateArgs = {
     date: dateInput.describe("Date"),
     minutes: z.number().int().positive().describe("Minutes"),
     summary: z.string().optional().describe("Brief text"),
-    description: z.string().optional().describe("Description"),
+    description: z
+        .string()
+        .optional()
+        .describe("Description. Supports folded sections: <details> <summary>Title</summary>Content</details>"),
     usesMarkdown: z.boolean().optional().describe("Use Markdown formatting"),
 };
 const workItemCreateSchema = z.object(workItemCreateArgs);
@@ -32,7 +35,10 @@ const workItemIdempotentArgs = {
     issueId: z.string().min(1).describe("Issue ID"),
     date: dateInput.describe("Date"),
     minutes: z.number().int().positive().describe("Minutes"),
-    description: z.string().min(1).describe("Text to search for existing work item"),
+    description: z
+        .string()
+        .min(1)
+        .describe("Text to search for existing work item. Supports folded sections: <details> <summary>Title</summary>Content</details>"),
     usesMarkdown: z.boolean().optional().describe("Use Markdown formatting"),
 };
 const workItemIdempotentSchema = z.object(workItemIdempotentArgs);
@@ -42,7 +48,10 @@ const workItemUpdateArgs = {
     date: dateInput.optional().describe("New date"),
     minutes: z.number().int().positive().optional().describe("New minutes"),
     summary: z.string().optional().describe("New text"),
-    description: z.string().optional().describe("New description"),
+    description: z
+        .string()
+        .optional()
+        .describe("New description. Supports folded sections: <details> <summary>Title</summary>Content</details>"),
     usesMarkdown: z.boolean().optional().describe("Use Markdown formatting"),
 };
 const workItemUpdateSchema = z.object(workItemUpdateArgs);
@@ -57,7 +66,10 @@ const workItemsPeriodArgs = {
     endDate: dateInput.describe("Period end date"),
     minutes: z.number().int().positive().describe("Minutes per day"),
     summary: z.string().optional().describe("Brief text"),
-    description: z.string().optional().describe("Description"),
+    description: z
+        .string()
+        .optional()
+        .describe("Description. Supports folded sections: <details> <summary>Title</summary>Content</details>"),
     usesMarkdown: z.boolean().optional().describe("Use Markdown formatting"),
     excludeWeekends: z.boolean().optional().describe("Exclude weekends"),
     excludeHolidays: z.boolean().optional().describe("Exclude holidays"),
@@ -120,7 +132,7 @@ export function registerWorkitemTools(server, client) {
             return errorResponse;
         }
     });
-    server.tool("workitem_create", "Create work item record. Note: Response includes predefined fields only - id, date, duration (minutes, presentation), text, textPreview, usesMarkdown, description, issue (id, idReadable), author (id, login, name, email).", workItemCreateArgs, async (rawInput) => {
+    server.tool("workitem_create", "Create work item record. Supports markdown with folded sections (<details>/<summary>) in description. Note: Response includes predefined fields only - id, date, duration (minutes, presentation), text, textPreview, usesMarkdown, description, issue (id, idReadable), author (id, login, name, email).", workItemCreateArgs, async (rawInput) => {
         try {
             const payload = workItemCreateSchema.parse(rawInput);
             const item = await client.createWorkItemMapped({
@@ -139,7 +151,7 @@ export function registerWorkitemTools(server, client) {
             return errorResponse;
         }
     });
-    server.tool("workitem_create_idempotent", "Create work item record if similar one does not exist. Note: Response includes predefined fields only - id, date, duration (minutes, presentation), text, textPreview, usesMarkdown, description, issue (id, idReadable), author (id, login, name, email).", workItemIdempotentArgs, async (rawInput) => {
+    server.tool("workitem_create_idempotent", "Create work item record if similar one does not exist. Supports markdown with folded sections (<details>/<summary>) in description. Note: Response includes predefined fields only - id, date, duration (minutes, presentation), text, textPreview, usesMarkdown, description, issue (id, idReadable), author (id, login, name, email).", workItemIdempotentArgs, async (rawInput) => {
         try {
             const payload = workItemIdempotentSchema.parse(rawInput);
             const item = await client.createWorkItemIdempotent({
@@ -157,7 +169,7 @@ export function registerWorkitemTools(server, client) {
             return errorResponse;
         }
     });
-    server.tool("workitem_update", "Update work item record. Note: Response includes predefined fields only - id, date, duration (minutes, presentation), text, textPreview, usesMarkdown, description, issue (id, idReadable), author (id, login, name, email).", workItemUpdateArgs, async (rawInput) => {
+    server.tool("workitem_update", "Update work item record. Supports markdown with folded sections (<details>/<summary>) in description. Note: Response includes predefined fields only - id, date, duration (minutes, presentation), text, textPreview, usesMarkdown, description, issue (id, idReadable), author (id, login, name, email).", workItemUpdateArgs, async (rawInput) => {
         try {
             const payload = workItemUpdateSchema.parse(rawInput);
             if (payload.date === undefined &&
@@ -195,7 +207,7 @@ export function registerWorkitemTools(server, client) {
             return errorResponse;
         }
     });
-    server.tool("workitems_create_period", "Create work items for period. Note: Created work items include predefined fields only - id, date, duration (minutes, presentation), text, textPreview, usesMarkdown, description, issue (id, idReadable), author (id, login, name, email).", workItemsPeriodArgs, async (rawInput) => {
+    server.tool("workitems_create_period", "Create work items for period. Supports markdown with folded sections (<details>/<summary>) in description. Note: Created work items include predefined fields only - id, date, duration (minutes, presentation), text, textPreview, usesMarkdown, description, issue (id, idReadable), author (id, login, name, email).", workItemsPeriodArgs, async (rawInput) => {
         try {
             const payload = workItemsPeriodSchema.parse(rawInput);
             const result = await client.createWorkItemsForPeriod({

package/dist/src/types.d.ts

@@ -186,6 +186,13 @@ export interface IssueCommentCreateInput {
     text: string;
     usesMarkdown?: boolean;
 }
+export interface IssueCommentUpdateInput {
+    issueId: string;
+    commentId: string;
+    text?: string;
+    usesMarkdown?: boolean;
+    muteUpdateNotifications?: boolean;
+}
 export interface YoutrackActivityItem {
     id: string;
     timestamp: number;
@@ -211,6 +218,11 @@ export interface YoutrackActivityItem {
 export interface IssueCommentCreatePayload {
     comment: MappedYoutrackIssueComment;
 }
+export interface IssueCommentUpdatePayload {
+    comment: MappedYoutrackIssueComment;
+    issueId: string;
+    commentId: string;
+}
 export interface WorkItemReportDay {
     date: string;
     expectedMinutes: number;
@@ -430,4 +442,87 @@ export interface AttachmentDeletePayload {
     attachmentId: string;
     attachmentName: string;
 }
+export interface YoutrackStateEvent {
+    id: string;
+    presentation: string;
+    $type?: string;
+}
+export interface YoutrackCustomFieldValue {
+    id?: string;
+    name?: string;
+    presentation?: string;
+    $type?: string;
+}
+export interface YoutrackCustomField {
+    id: string;
+    name: string;
+    value?: YoutrackCustomFieldValue;
+    possibleEvents?: YoutrackStateEvent[];
+    $type: string;
+}
+export interface YoutrackStateField extends YoutrackCustomField {
+    $type: "StateMachineIssueCustomField";
+    possibleEvents: YoutrackStateEvent[];
+}
+export interface YoutrackSimpleStateField extends YoutrackCustomField {
+    $type: "StateIssueCustomField";
+    value?: {
+        id: string;
+        name: string;
+        presentation?: string;
+        $type: "StateBundleElement";
+    };
+}
+export interface IssueChangeStateInput {
+    issueId: string;
+    stateName: string;
+}
+export interface IssueChangeStatePayload {
+    issueId: string;
+    previousState?: string;
+    newState: string;
+    transitionUsed?: string;
+}
+export interface MappedYoutrackActivityItem {
+    id: string;
+    timestamp: string;
+    author?: {
+        id: string;
+        login: string;
+        name?: string;
+    };
+    category?: {
+        id: string;
+    };
+    target?: {
+        text?: string;
+    };
+    added?: Array<{
+        name?: string;
+        id?: string;
+        login?: string;
+    }>;
+    removed?: Array<{
+        name?: string;
+        id?: string;
+        login?: string;
+    }>;
+    $type?: string;
+}
+export interface IssueActivitiesPayload {
+    activities: MappedYoutrackActivityItem[];
+    issueId: string;
+    filters?: {
+        author?: string;
+        startDate?: string;
+        endDate?: string;
+        categories?: string;
+    };
+    pagination?: {
+        returned: number;
+        total: number;
+        limit?: number;
+        skip?: number;
+    };
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/src/utils/mappers.d.ts

@@ -1,4 +1,4 @@
-import type { YoutrackAttachment, YoutrackIssue, YoutrackIssueComment, YoutrackIssueDetails, YoutrackWorkItem, MappedYoutrackAttachment } from "../types.js";
+import type { YoutrackActivityItem, YoutrackAttachment, YoutrackIssue, YoutrackIssueComment, YoutrackIssueDetails, YoutrackWorkItem, MappedYoutrackAttachment } from "../types.js";
 /**
  * Convert timestamp in milliseconds to ISO date string (YYYY-MM-DD)
  */
@@ -7,6 +7,10 @@ export declare function timestampToIsoDate(timestamp: number | null | undefined)
  * Convert timestamp in milliseconds to ISO datetime string (YYYY-MM-DDTHH:mm:ss.sssZ)
  */
 export declare function timestampToIsoDateTime(timestamp: number | null | undefined): string | undefined;
+/**
+ * Generate comment URL for direct navigation
+ */
+export declare function generateCommentUrl(baseUrl: string, issueId: string, commentId: string): string;
 /**
  * Mapped issue with ISO date strings
  * Issue type doesn't have date fields, so it's the same as YoutrackIssue
@@ -32,6 +36,7 @@ export interface MappedYoutrackWorkItem extends Omit<YoutrackWorkItem, "date"> {
 export interface MappedYoutrackIssueComment extends Omit<YoutrackIssueComment, "created" | "updated"> {
     created: string;
     updated?: string;
+    commentUrl?: string;
 }
 /**
  * Map YoutrackIssue to MappedYoutrackIssue
@@ -48,7 +53,7 @@ export declare function mapWorkItem(item: YoutrackWorkItem): MappedYoutrackWorkI
 /**
  * Map YoutrackIssueComment to MappedYoutrackIssueComment
  */
-export declare function mapComment(comment: YoutrackIssueComment): MappedYoutrackIssueComment;
+export declare function mapComment(comment: YoutrackIssueComment, baseUrl?: string, issueId?: string): MappedYoutrackIssueComment;
 /**
  * Map array of issues
  */
@@ -60,7 +65,7 @@ export declare function mapWorkItems(items: YoutrackWorkItem[]): MappedYoutrackW
 /**
  * Map array of comments
  */
-export declare function mapComments(comments: YoutrackIssueComment[]): MappedYoutrackIssueComment[];
+export declare function mapComments(comments: YoutrackIssueComment[], baseUrl?: string, issueId?: string): MappedYoutrackIssueComment[];
 /**
  * Format file size in bytes to human-readable format
  */
@@ -73,4 +78,41 @@ export declare function mapAttachment(attachment: YoutrackAttachment): MappedYou
  * Map array of attachments
  */
 export declare function mapAttachments(attachments: YoutrackAttachment[]): MappedYoutrackAttachment[];
+/**
+ * Mapped activity item with ISO datetime strings
+ */
+export interface MappedYoutrackActivityItem {
+    id: string;
+    timestamp: string;
+    author?: {
+        id: string;
+        login: string;
+        name?: string;
+    };
+    category?: {
+        id: string;
+    };
+    target?: {
+        text?: string;
+    };
+    added?: Array<{
+        name?: string;
+        id?: string;
+        login?: string;
+    }>;
+    removed?: Array<{
+        name?: string;
+        id?: string;
+        login?: string;
+    }>;
+    $type?: string;
+}
+/**
+ * Map YoutrackActivityItem to MappedYoutrackActivityItem
+ */
+export declare function mapActivityItem(activity: YoutrackActivityItem): MappedYoutrackActivityItem;
+/**
+ * Map array of activity items
+ */
+export declare function mapActivityItems(activities: YoutrackActivityItem[]): MappedYoutrackActivityItem[];
 //# sourceMappingURL=mappers.d.ts.map

package/dist/src/utils/mappers.js

@@ -23,6 +23,12 @@ export function timestampToIsoDateTime(timestamp) {
     }
     return DateTime.fromMillis(timestamp).toISO() ?? undefined;
 }
+/**
+ * Generate comment URL for direct navigation
+ */
+export function generateCommentUrl(baseUrl, issueId, commentId) {
+    return `${baseUrl}/issue/${issueId}#focus=Comments-${commentId}.0-0`;
+}
 /**
  * Map YoutrackIssue to MappedYoutrackIssue
  */
@@ -55,11 +61,12 @@ export function mapWorkItem(item) {
 /**
  * Map YoutrackIssueComment to MappedYoutrackIssueComment
  */
-export function mapComment(comment) {
+export function mapComment(comment, baseUrl, issueId) {
     const mapped = {
         ...comment,
         created: timestampToIsoDateTime(comment.created) ?? "",
         updated: timestampToIsoDateTime(comment.updated),
+        commentUrl: baseUrl && issueId ? generateCommentUrl(baseUrl, issueId, comment.id) : undefined,
     };
     return mapped;
 }
@@ -78,8 +85,8 @@ export function mapWorkItems(items) {
 /**
  * Map array of comments
  */
-export function mapComments(comments) {
-    return comments.map(mapComment);
+export function mapComments(comments, baseUrl, issueId) {
+    return comments.map((comment) => mapComment(comment, baseUrl, issueId));
 }
 /**
  * Format file size in bytes to human-readable format
@@ -123,4 +130,25 @@ export function mapAttachment(attachment) {
 export function mapAttachments(attachments) {
     return attachments.map(mapAttachment);
 }
+/**
+ * Map YoutrackActivityItem to MappedYoutrackActivityItem
+ */
+export function mapActivityItem(activity) {
+    return {
+        id: activity.id,
+        timestamp: timestampToIsoDateTime(activity.timestamp) ?? "",
+        author: activity.author,
+        category: activity.category,
+        target: activity.target,
+        added: activity.added,
+        removed: activity.removed,
+        $type: activity.$type,
+    };
+}
+/**
+ * Map array of activity items
+ */
+export function mapActivityItems(activities) {
+    return activities.map(mapActivityItem);
+}
 //# sourceMappingURL=mappers.js.map

package/dist/src/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/src/version.js

@@ -0,0 +1,3 @@
+import packageJson from "../package.json" with { type: "json" };
+export const VERSION = packageJson.version;
+//# sourceMappingURL=version.js.map

package/dist/src/youtrack-client.d.ts

@@ -1,5 +1,5 @@
 import { type MappedYoutrackIssueComment, type MappedYoutrackWorkItem } from "./utils/mappers.js";
-import type { ArticleCreateInput, ArticleListPayload, ArticlePayload, ArticleSearchInput, ArticleSearchPayload, ArticleUpdateInput, AttachmentDeleteInput, AttachmentDeletePayload, AttachmentDownloadPayload, AttachmentPayload, AttachmentsListPayload, AttachmentUploadInput, AttachmentUploadPayload, IssueCommentsPayload, IssueCommentCreateInput, IssueDetailsPayload, IssueLookupPayload, IssueSearchInput, IssueSearchPayload, IssuesCommentsPayload, IssuesDetailsPayload, IssuesLookupPayload, WorkItemBulkResultPayload, WorkItemDeletePayload, WorkItemInvalidDay, WorkItemReportPayload, WorkItemUsersReportPayload, YoutrackActivityItem, YoutrackConfig, YoutrackIssueAssignInput, YoutrackIssueCreateInput, YoutrackIssueUpdateInput, YoutrackProject, YoutrackProjectListPayload, YoutrackUser, YoutrackUserListPayload, YoutrackWorkItem, YoutrackWorkItemCreateInput, YoutrackWorkItemIdempotentCreateInput, YoutrackWorkItemPeriodCreateInput, YoutrackWorkItemReportOptions, YoutrackWorkItemUpdateInput } from "./types.js";
+import type { ArticleCreateInput, ArticleListPayload, ArticlePayload, ArticleSearchInput, ArticleSearchPayload, ArticleUpdateInput, AttachmentDeleteInput, AttachmentDeletePayload, AttachmentDownloadPayload, AttachmentPayload, AttachmentsListPayload, AttachmentUploadInput, AttachmentUploadPayload, IssueChangeStateInput, IssueChangeStatePayload, IssueCommentsPayload, IssueCommentCreateInput, IssueCommentUpdateInput, IssueCommentUpdatePayload, IssueDetailsPayload, IssueLookupPayload, IssueSearchInput, IssueSearchPayload, IssuesCommentsPayload, IssuesDetailsPayload, IssuesLookupPayload, WorkItemBulkResultPayload, WorkItemDeletePayload, WorkItemInvalidDay, WorkItemReportPayload, WorkItemUsersReportPayload, YoutrackActivityItem, YoutrackConfig, YoutrackCustomField, YoutrackIssueAssignInput, YoutrackIssueCreateInput, YoutrackIssueUpdateInput, YoutrackProject, YoutrackProjectListPayload, YoutrackUser, YoutrackUserListPayload, YoutrackWorkItem, YoutrackWorkItemCreateInput, YoutrackWorkItemIdempotentCreateInput, YoutrackWorkItemPeriodCreateInput, YoutrackWorkItemReportOptions, YoutrackWorkItemUpdateInput } from "./types.js";
 export declare class YoutrackClient {
     private readonly config;
     private readonly http;
@@ -19,6 +19,7 @@ export declare class YoutrackClient {
     createIssueComment(input: IssueCommentCreateInput): Promise<{
         comment: MappedYoutrackIssueComment;
     }>;
+    updateIssueComment(input: IssueCommentUpdateInput): Promise<IssueCommentUpdatePayload>;
     getIssueActivities(issueId: string, { author, startDate, endDate }?: {
         author?: string;
         startDate?: number;
@@ -82,5 +83,7 @@ export declare class YoutrackClient {
     private getIssueRaw;
     private getWorkItemById;
     private resolveReportBoundary;
+    getIssueCustomFields(issueId: string): Promise<YoutrackCustomField[]>;
+    changeIssueState(input: IssueChangeStateInput): Promise<IssueChangeStatePayload>;
 }
 //# sourceMappingURL=youtrack-client.d.ts.map

package/dist/src/youtrack-client.js

@@ -177,7 +177,7 @@ export class YoutrackClient {
             const response = await this.http.get(`/api/issues/${issueId}/comments`, {
                 params: { fields: defaultFields.comments },
             });
-            const mappedComments = mapComments(response.data);
+            const mappedComments = mapComments(response.data, this.config.baseUrl, issueId);
             const payload = { comments: mappedComments };
             return payload;
         }
@@ -196,7 +196,7 @@ export class YoutrackClient {
             const response = await this.http.post(`/api/issues/${input.issueId}/comments`, body, {
                 params: { fields: defaultFields.comments },
             });
-            const mappedComment = mapComment(response.data);
+            const mappedComment = mapComment(response.data, this.config.baseUrl, input.issueId);
             const payload = { comment: mappedComment };
             return payload;
         }
@@ -204,6 +204,36 @@ export class YoutrackClient {
             throw this.normalizeError(error);
         }
     }
+    async updateIssueComment(input) {
+        const body = {};
+        if (input.text !== undefined) {
+            body.text = input.text;
+        }
+        if (input.usesMarkdown !== undefined) {
+            body.usesMarkdown = input.usesMarkdown;
+        }
+        // Validate that at least one field is provided
+        if (Object.keys(body).length === 0) {
+            throw new YoutrackClientError("At least one field (text or usesMarkdown) must be provided for update");
+        }
+        const params = { fields: defaultFields.comments };
+        if (input.muteUpdateNotifications) {
+            params.muteUpdateNotifications = true;
+        }
+        try {
+            const response = await this.http.post(`/api/issues/${input.issueId}/comments/${input.commentId}`, body, { params });
+            const mappedComment = mapComment(response.data, this.config.baseUrl, input.issueId);
+            const payload = {
+                comment: mappedComment,
+                issueId: input.issueId,
+                commentId: input.commentId,
+            };
+            return payload;
+        }
+        catch (error) {
+            throw this.normalizeError(error);
+        }
+    }
     async getIssueActivities(issueId, { author, startDate, endDate } = {}) {
         const categories = "CustomFieldCategory,CommentsCategory";
         const fields = "id,timestamp,author(id,login,name),category(id),target(text),added(name,id,login),removed(name,id,login),$type";
@@ -395,7 +425,7 @@ export class YoutrackClient {
         const errors = [];
         for (const result of results) {
             if (result.success) {
-                commentsByIssue[result.issueId] = mapComments(result.comments);
+                commentsByIssue[result.issueId] = mapComments(result.comments, this.config.baseUrl, result.issueId);
                 continue;
             }
             errors.push({ issueId: result.issueId, error: result.error });
@@ -1175,12 +1205,15 @@ export class YoutrackClient {
             }
             const fallbackMessage = typeof error.message === "string" && error.message.length > 0 ? error.message : undefined;
             const finalMessage = responseMessage ?? fallbackMessage ?? "Unknown error";
-            return new YoutrackClientError(`YouTrack API error: ${finalMessage}`, status, data);
+            const clientError = new YoutrackClientError(`YouTrack API error: ${finalMessage}`, status, data);
+            return clientError;
         }
         if (error instanceof Error) {
-            return new YoutrackClientError(error.message);
+            const errorFromMessage = new YoutrackClientError(error.message);
+            return errorFromMessage;
         }
-        return new YoutrackClientError(String(error));
+        const stringError = new YoutrackClientError(String(error));
+        return stringError;
     }
     async resolveAssignee(login) {
         if (login === "me") {
@@ -1216,5 +1249,97 @@ export class YoutrackClient {
         const boundary = toIsoDateString(target);
         return boundary;
     }
+    // State change methods
+    async getIssueCustomFields(issueId) {
+        try {
+            const response = await this.http.get(`/api/issues/${issueId}/customFields`, {
+                params: {
+                    fields: "id,name,value(id,name,presentation),$type,possibleEvents(id,presentation)",
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw this.normalizeError(error);
+        }
+    }
+    async changeIssueState(input) {
+        try {
+            // Get state field
+            const customFields = await this.getIssueCustomFields(input.issueId);
+            const stateField = customFields.find((field) => (field.$type === "StateMachineIssueCustomField" || field.$type === "StateIssueCustomField") &&
+                field.name === "State");
+            if (!stateField) {
+                throw new YoutrackClientError("State field not found for this issue");
+            }
+            const previousState = stateField.value?.presentation ?? stateField.value?.name ?? "Unknown";
+            // Handle StateMachineIssueCustomField (workflow-based)
+            if (stateField.$type === "StateMachineIssueCustomField") {
+                const stateMachineField = stateField;
+                if (stateMachineField.possibleEvents.length === 0) {
+                    throw new YoutrackClientError("No state transitions available for this issue");
+                }
+                const targetStateLower = input.stateName.toLowerCase();
+                const matchingEvent = stateMachineField.possibleEvents.find((event) => event.presentation.toLowerCase() === targetStateLower || event.id.toLowerCase() === targetStateLower);
+                if (!matchingEvent) {
+                    const availableStates = stateMachineField.possibleEvents.map((e) => e.presentation).join(", ");
+                    throw new YoutrackClientError(`State transition to '${input.stateName}' is not available. Available transitions: ${availableStates}`);
+                }
+                // Execute state transition via event
+                const body = {
+                    event: {
+                        id: matchingEvent.id,
+                        presentation: matchingEvent.presentation,
+                        $type: "Event",
+                    },
+                };
+                await this.http.post(`/api/issues/${input.issueId}/fields/${stateField.id}`, body);
+                return {
+                    issueId: input.issueId,
+                    previousState,
+                    newState: matchingEvent.presentation,
+                    transitionUsed: matchingEvent.id,
+                };
+            }
+            // Handle StateIssueCustomField (simple bundle-based)
+            if (stateField.$type === "StateIssueCustomField") {
+                // Note: We set state by name directly without pre-validation for performance.
+                // Invalid state names will be rejected by YouTrack API with appropriate error.
+                const body = {
+                    customFields: [
+                        {
+                            name: "State",
+                            $type: "StateIssueCustomField",
+                            value: {
+                                name: input.stateName,
+                                $type: "StateBundleElement",
+                            },
+                        },
+                    ],
+                };
+                try {
+                    await this.http.post(`/api/issues/${input.issueId}`, body);
+                }
+                catch (error) {
+                    const normalized = this.normalizeError(error);
+                    // Enhance error message if state name is invalid
+                    if (normalized.status === 400 || normalized.status === 422) {
+                        const enhancedError = new YoutrackClientError(`Failed to set state to '${input.stateName}'. The state may not exist for this project. Original error: ${normalized.message}`, normalized.status, normalized.details);
+                        throw enhancedError;
+                    }
+                    throw normalized;
+                }
+                return {
+                    issueId: input.issueId,
+                    previousState,
+                    newState: input.stateName,
+                };
+            }
+            throw new YoutrackClientError(`Unsupported state field type: ${stateField.$type}`);
+        }
+        catch (error) {
+            throw this.normalizeError(error);
+        }
+    }
 }
 //# sourceMappingURL=youtrack-client.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vitalyostanin/youtrack-mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "postbuild": "chmod +x dist/index.js",
@@ -25,6 +25,9 @@
   "license": "MIT",
   "description": "MCP server for comprehensive YouTrack integration: issues, work items with reports, user activity search, knowledge base, projects and users",
   "type": "module",
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "bin": {
     "youtrack-mcp": "dist/index.js"
   },