@vitalyostanin/youtrack-mcp 0.4.0 → 0.5.0

package/README-ru.md

@@ -6,6 +6,7 @@
 MCP сервер для полноценной интеграции с YouTrack со следующими возможностями:
 
 - **Управление задачами** - создание, обновление, комментирование, назначение, изменение статуса, пакетные операции
+- **Звездочки для задач** - отметка важных задач звездочками, массовое добавление (до 50), список отмеченных задач
 - **Управление вложениями** - загрузка файлов (до 10), скачивание по подписанным URL, удаление
 - **Учёт трудозатрат** - создание записей с идемпотентными операциями, массовое создание за период
 - **Детальные отчёты по времени** - сводные отчёты, анализ отклонений, статистика по пользователям
@@ -30,6 +31,7 @@ MCP сервер для полноценной интеграции с YouTrack
   - [Инструменты MCP](#инструменты-mcp)
     - [Сервис](#сервис)
     - [Задачи](#задачи)
+    - [Звездочки задач](#звездочки-задач)
     - [Трудозатраты](#трудозатраты)
     - [Пользователи и проекты](#пользователи-и-проекты)
     - [Статьи](#статьи)
@@ -280,6 +282,16 @@ env = { "YOUTRACK_URL" = "https://youtrack.example.com", "YOUTRACK_TOKEN" = "per
 | `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` для пагинации |
 
+### Звездочки задач
+
+| Tool | Описание | Основные параметры |
+| --- | --- | --- |
+| `issue_star` | Добавление звездочки к задаче для текущего пользователя. **Использование:** Отметка важных задач, добавление задач в список наблюдения, быстрый доступ к часто используемым задачам. **Возвращает:** подтверждение статуса звездочки с issueId и флагом starred. **Примечание:** Идемпотентная операция - возвращает успех, даже если задача уже отмечена звездочкой | `issueId` — код задачи (например, `PROJ-123`) |
+| `issue_unstar` | Удаление звездочки у задачи для текущего пользователя. **Использование:** Удаление задач из списка наблюдения, очистка ненужных звездочек, управление списком отмеченных задач. **Возвращает:** подтверждение операции снятия звездочки с issueId и флагом starred. **Примечание:** Идемпотентная операция - возвращает успех, даже если задача не была отмечена звездочкой | `issueId` — код задачи |
+| `issues_star_batch` | Добавление звездочек к нескольким задачам (пакетный режим, макс 50 задач). **Использование:** Массовая отметка важных задач, пакетное добавление в список наблюдения, обработка нескольких задач одновременно, быстрая настройка списка отмеченных задач. **Возвращает:** объект с массивами `successful` (отмеченные задачи) и `failed` (ошибки с ID задач). **Примечание:** Операции обрабатываются с ограничением конкурентности (10 одновременных запросов) для предотвращения перегрузки API. Возможен частичный успех - некоторые задачи могут быть обработаны успешно, а другие - нет | `issueIds[]` — массив кодов задач (например, `['PROJ-123', 'PROJ-124']`), макс 50 |
+| `issues_unstar_batch` | Удаление звездочек у нескольких задач (пакетный режим, макс 50 задач). **Использование:** Массовая очистка списка наблюдения, пакетное удаление ненужных звездочек, обработка нескольких задач одновременно, управление списком отмеченных задач. **Возвращает:** объект с массивами `successful` (задачи с удаленными звездочками) и `failed` (ошибки с ID задач). **Примечание:** Операции обрабатываются с ограничением конкурентности (10 одновременных запросов) для предотвращения перегрузки API. Возможен частичный успех - некоторые задачи могут быть обработаны успешно, а другие - нет | `issueIds[]` — массив кодов задач, макс 50 |
+| `issues_starred_list` | Получение всех отмеченных звездочками задач для текущего пользователя. **Использование:** Просмотр списка наблюдения, получение часто используемых задач, поиск всех отмеченных важных задач, проверка наличия звездочек у задач. **Возвращает:** массив отмеченных задач (краткий формат без description) и общее количество. **Примечание:** Ограничено 200 задачами за запрос. Результаты включают только базовую информацию (id, idReadable, summary, project, parent, assignee) без description для уменьшения размера ответа. Опциональное поле message в ответах star/unstar предоставляет информацию о статусе операции (например, 'Issue already starred', 'Issue starred successfully') | Опционально `limit` — максимальное количество задач (по умолчанию 50, макс 200), `skip` — количество задач для пропуска при пагинации (по умолчанию 0) |
+
 ### Трудозатраты
 
 | Tool | Описание | Основные параметры |

package/README.md

@@ -6,6 +6,7 @@
 MCP server for comprehensive YouTrack integration with the following capabilities:
 
 - **Issue management** - create, update, comment, assign, change state, batch operations
+- **Issue starring** - mark important issues with stars, batch starring (up to 50), list starred issues
 - **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
@@ -30,6 +31,7 @@ MCP server for comprehensive YouTrack integration with the following capabilitie
   - [MCP Tools](#mcp-tools)
     - [Service](#service)
     - [Issues](#issues)
+    - [Issue Stars](#issue-stars)
     - [Work Items](#work-items)
     - [Users and Projects](#users-and-projects)
     - [Articles](#articles)
@@ -283,6 +285,16 @@ All tools return `structuredContent` with a `success` flag and payload formatted
 | `issue_attachment_upload` | Upload files to issue | `issueId`, `filePaths[]` — array of file paths (max 10), optionally `muteUpdateNotifications` |
 | `issue_attachment_delete` | Delete attachment (requires confirmation) | `issueId`, `attachmentId`, `confirmation` (must be `true`) |
 
+### Issue Stars
+
+| Tool | Description | Main Parameters |
+| --- | --- | --- |
+| `issue_star` | Add star to issue for current user | `issueId` — issue code (e.g., PROJ-123). Idempotent operation - returns success even if already starred |
+| `issue_unstar` | Remove star from issue for current user | `issueId` — issue code. Idempotent operation - returns success even if not currently starred |
+| `issues_star_batch` | Add stars to multiple issues (batch mode, max 50) | `issueIds[]` — array of issue codes (max 50). Returns object with `successful` and `failed` arrays. Processes with concurrency limit (10 concurrent requests) |
+| `issues_unstar_batch` | Remove stars from multiple issues (batch mode, max 50) | `issueIds[]` — array of issue codes (max 50). Returns object with `successful` and `failed` arrays. Processes with concurrency limit (10 concurrent requests) |
+| `issues_starred_list` | Get all starred issues for current user | Optionally `limit` (default 50, max 200), `skip` for pagination. Returns array of starred issues with basic information (id, idReadable, summary, project, parent, assignee) without description fields |
+
 ### Work Items
 
 | Tool | Description | Main Parameters |

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@vitalyostanin/youtrack-mcp",
-    "version": "0.4.0",
+    "version": "0.5.0",
     "scripts": {
         "build": "tsc -p tsconfig.json",
         "postbuild": "chmod +x dist/index.js",
@@ -51,6 +51,7 @@
     },
     "dependencies": {
         "@modelcontextprotocol/sdk": "^1.20.0",
+        "@vitalyostanin/mutex-pool": "^0.0.3",
         "axios": "^1.12.2",
         "form-data": "^4.0.1",
         "luxon": "^3.5.0",

package/dist/src/server.js

@@ -10,6 +10,7 @@ import { registerArticleSearchTools } from "./tools/article-search-tools.js";
 import { registerUserTools } from "./tools/user-tools.js";
 import { registerProjectTools } from "./tools/project-tools.js";
 import { registerAttachmentTools } from "./tools/attachment-tools.js";
+import { registerIssueStarTools } from "./tools/issue-star-tools.js";
 import { YoutrackClient } from "./youtrack-client.js";
 import { loadConfig } from "./config.js";
 import { initializeTimezone } from "./utils/date.js";
@@ -43,6 +44,7 @@ export class YoutrackServer {
         registerUserTools(this.server, this.client);
         registerProjectTools(this.server, this.client);
         registerAttachmentTools(this.server, this.client);
+        registerIssueStarTools(this.server, this.client);
     }
     async connect(transport) {
         await this.server.connect(transport);

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

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

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

@@ -0,0 +1,67 @@
+import { z } from "zod";
+import { toolSuccess, toolError } from "../utils/tool-response.js";
+/**
+ * Creates a tool handler with standard error handling
+ */
+function createToolHandler(handler) {
+    return async (args) => {
+        try {
+            const result = await handler(args);
+            const response = toolSuccess(result);
+            return response;
+        }
+        catch (error) {
+            const errorResponse = toolError(error);
+            return errorResponse;
+        }
+    };
+}
+/**
+ * Register issue star management tools
+ */
+export function registerIssueStarTools(server, client) {
+    // Tool: issue_star
+    server.tool("issue_star", "Add star to YouTrack issue for current user. Use for: Marking important issues, Adding issues to watchlist, Quick access to frequently used issues. Returns: Confirmation of star status with issueId and starred flag. Note: If issue is already starred, returns success without making changes (idempotent operation).", {
+        issueId: z.string().min(1).describe("Issue code (e.g., PROJ-123)"),
+    }, createToolHandler(async (args) => client.starIssue(args.issueId)));
+    // Tool: issue_unstar
+    server.tool("issue_unstar", "Remove star from YouTrack issue for current user. Use for: Removing issues from watchlist, Cleaning up unneeded stars, Managing starred issues list. Returns: Confirmation of unstar operation with issueId and starred flag. Note: If issue is not currently starred, returns success without making changes (idempotent operation).", {
+        issueId: z.string().min(1).describe("Issue code (e.g., PROJ-123)"),
+    }, createToolHandler(async (args) => client.unstarIssue(args.issueId)));
+    // Tool: issues_star_batch
+    server.tool("issues_star_batch", "Add stars to multiple YouTrack issues (batch mode, max 50 issues). Use for: Bulk marking important issues, Batch adding to watchlist, Processing multiple issues at once, Quick setup of starred issues list. Returns: Object with 'successful' array (starred issues) and 'failed' array (errors with issue IDs). Note: Operations are processed with concurrency limit (10 concurrent requests) to prevent API overload. Partial success is possible - some issues may succeed while others fail.", {
+        issueIds: z
+            .array(z.string().min(1))
+            .min(1)
+            .max(50)
+            .describe("Array of issue codes (e.g., ['PROJ-123', 'PROJ-124']), max 50"),
+    }, createToolHandler(async (args) => client.starIssues(args.issueIds)));
+    // Tool: issues_unstar_batch
+    server.tool("issues_unstar_batch", "Remove stars from multiple YouTrack issues (batch mode, max 50 issues). Use for: Bulk cleanup of watchlist, Batch removal of unneeded stars, Processing multiple issues at once, Managing starred issues list. Returns: Object with 'successful' array (unstarred issues) and 'failed' array (errors with issue IDs). Note: Operations are processed with concurrency limit (10 concurrent requests) to prevent API overload. Partial success is possible - some issues may succeed while others fail.", {
+        issueIds: z
+            .array(z.string().min(1))
+            .min(1)
+            .max(50)
+            .describe("Array of issue codes (e.g., ['PROJ-123', 'PROJ-124']), max 50"),
+    }, createToolHandler(async (args) => client.unstarIssues(args.issueIds)));
+    // Tool: issues_starred_list
+    server.tool("issues_starred_list", "Get all starred issues for current user with pagination. Use for: Viewing watchlist, Getting frequently used issues, Finding all marked important issues, Checking which issues are starred. Returns: Array of starred issues (brief format without description fields), returnedCount (count of issues in current page), and pagination info. Note: Default limit is 50 issues, max 200. Results include basic issue information only (id, idReadable, summary, project, parent, assignee) without description fields to reduce payload size. The optional message field in star/unstar responses provides status information about the operation (e.g., 'Issue already starred', 'Issue starred successfully').", {
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .max(200)
+            .optional()
+            .describe("Maximum number of issues to return (default: 50, max: 200)"),
+        skip: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe("Number of issues to skip for pagination (default: 0)"),
+    }, createToolHandler(async (args) => client.getStarredIssues({
+        limit: args.limit,
+        skip: args.skip,
+    })));
+}
+//# sourceMappingURL=issue-star-tools.js.map

package/dist/src/types.d.ts

@@ -24,6 +24,10 @@ export interface YoutrackProject {
     shortName: string;
     name?: string;
 }
+export interface YoutrackIssueWatchers {
+    hasStar: boolean;
+    $type: string;
+}
 export interface YoutrackIssue {
     id: string;
     idReadable: string;
@@ -37,6 +41,7 @@ export interface YoutrackIssue {
         id?: string;
     } | null;
     assignee?: YoutrackUser | null;
+    watchers?: YoutrackIssueWatchers | null;
 }
 export interface YoutrackIssueCreateInput {
     project: string;
@@ -527,4 +532,41 @@ export interface IssueActivitiesPayload {
         skip?: number;
     };
 }
+export interface YoutrackIssueWatcher {
+    id: string;
+    user: YoutrackUser;
+    isStarred: boolean;
+    $type: string;
+}
+export interface IssueStarInput {
+    issueId: string;
+}
+export interface IssueStarBatchInput {
+    issueIds: string[];
+}
+export interface IssueStarPayload {
+    issueId: string;
+    starred: boolean;
+    message?: string;
+}
+export interface IssueStarBatchPayload {
+    successful: Array<{
+        issueId: string;
+        starred: boolean;
+    }>;
+    failed: Array<{
+        issueId: string;
+        error: string;
+    }>;
+}
+export interface PaginationInfo {
+    returned: number;
+    limit: number;
+    skip: number;
+}
+export interface IssuesStarredPayload {
+    issues: MappedYoutrackIssue[];
+    returnedCount: number;
+    pagination: PaginationInfo;
+}
 //# sourceMappingURL=types.d.ts.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, IssueChangeStateInput, IssueChangeStatePayload, IssueCommentsPayload, IssueCommentCreateInput, IssueCommentUpdateInput, IssueCommentUpdatePayload, IssueDetailsPayload, IssueLookupPayload, IssueSearchInput, IssueSearchPayload, IssuesCommentsPayload, IssuesDetailsPayload, IssuesLookupPayload, WorkItemBulkResultPayload, WorkItemDeletePayload, WorkItemInvalidDay, WorkItemReportPayload, WorkItemUsersReportPayload, YoutrackActivityItem, YoutrackConfig, YoutrackCustomField, YoutrackIssueAssignInput, YoutrackIssueComment, YoutrackIssueCreateInput, YoutrackIssueDetails, 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, IssueStarBatchPayload, IssueStarPayload, IssuesStarredPayload, WorkItemBulkResultPayload, WorkItemDeletePayload, WorkItemInvalidDay, WorkItemReportPayload, WorkItemUsersReportPayload, YoutrackActivityItem, YoutrackConfig, YoutrackCustomField, YoutrackIssueAssignInput, YoutrackIssueComment, YoutrackIssueCreateInput, YoutrackIssueDetails, YoutrackIssueUpdateInput, YoutrackProject, YoutrackProjectListPayload, YoutrackUser, YoutrackUserListPayload, YoutrackWorkItem, YoutrackWorkItemCreateInput, YoutrackWorkItemIdempotentCreateInput, YoutrackWorkItemPeriodCreateInput, YoutrackWorkItemReportOptions, YoutrackWorkItemUpdateInput } from "./types.js";
 export declare class YoutrackClient {
     private readonly config;
     private readonly http;
@@ -7,6 +7,14 @@ export declare class YoutrackClient {
     private readonly usersByLogin;
     private readonly projectsByShortName;
     constructor(config: YoutrackConfig);
+    /**
+     * Process items with concurrency limit using MutexPool
+     * @param items - Array of items to process
+     * @param processor - Async function to process each item
+     * @param limit - Maximum number of concurrent operations (default: 10)
+     * @returns Array of results in original order
+     */
+    private processBatch;
     getCurrentUser(): Promise<YoutrackUser>;
     getUserByLogin(login: string): Promise<YoutrackUser | null>;
     listUsers(): Promise<YoutrackUserListPayload>;
@@ -101,5 +109,32 @@ export declare class YoutrackClient {
     private resolveReportBoundary;
     getIssueCustomFields(issueId: string): Promise<YoutrackCustomField[]>;
     changeIssueState(input: IssueChangeStateInput): Promise<IssueChangeStatePayload>;
+    /**
+     * Get watchers list for an issue (internal method)
+     */
+    private getIssueWatchers;
+    /**
+     * Add star to an issue (idempotent)
+     */
+    starIssue(issueId: string): Promise<IssueStarPayload>;
+    /**
+     * Remove star from an issue (idempotent)
+     */
+    unstarIssue(issueId: string): Promise<IssueStarPayload>;
+    /**
+     * Add stars to multiple issues with concurrency limiting (max 50 issues)
+     */
+    starIssues(issueIds: string[]): Promise<IssueStarBatchPayload>;
+    /**
+     * Remove stars from multiple issues with concurrency limiting (max 50 issues)
+     */
+    unstarIssues(issueIds: string[]): Promise<IssueStarBatchPayload>;
+    /**
+     * Get all starred issues for current user with pagination
+     */
+    getStarredIssues(options?: {
+        limit?: number;
+        skip?: number;
+    }): Promise<IssuesStarredPayload>;
 }
 //# sourceMappingURL=youtrack-client.d.ts.map

package/dist/src/youtrack-client.js

@@ -1,15 +1,62 @@
 import axios from "axios";
 import FormData from "form-data";
 import fs from "fs";
+import { MutexPool } from "@vitalyostanin/mutex-pool";
 import { calculateTotalMinutes, enumerateDateRange, filterWorkingDays, getDayBounds, groupWorkItemsByDate, isWeekend, minutesToHours, parseDateInput, toIsoDateString, validateDateRange, } from "./utils/date.js";
 import { mapAttachment, mapAttachments, mapComment, mapComments, mapIssue, mapIssueBrief, mapIssueDetails, mapWorkItem, mapWorkItems, } from "./utils/mappers.js";
 const DEFAULT_PAGE_SIZE = 200;
 const DEFAULT_EXPECTED_MINUTES = 8 * 60;
 const defaultFields = {
-    issue: "id,idReadable,summary,description,wikifiedDescription,usesMarkdown,project(id,shortName,name),parent(id,idReadable),assignee(id,login,name)",
-    issueSearch: "id,idReadable,summary,description,wikifiedDescription,usesMarkdown,project(id,shortName,name),parent(id,idReadable),assignee(id,login,name)",
-    issueSearchBrief: "id,idReadable,summary,project(id,shortName,name),parent(id,idReadable),assignee(id,login,name)",
-    issueDetails: "id,idReadable,summary,description,wikifiedDescription,usesMarkdown,created,updated,resolved,project(id,shortName,name),parent(id,idReadable),assignee(id,login,name),reporter(id,login,name),updater(id,login,name)",
+    issue: [
+        "id",
+        "idReadable",
+        "summary",
+        "description",
+        "wikifiedDescription",
+        "usesMarkdown",
+        "project(id,shortName,name)",
+        "parent(id,idReadable)",
+        "assignee(id,login,name)",
+        "watchers(hasStar)",
+    ].join(","),
+    issueSearch: [
+        "id",
+        "idReadable",
+        "summary",
+        "description",
+        "wikifiedDescription",
+        "usesMarkdown",
+        "project(id,shortName,name)",
+        "parent(id,idReadable)",
+        "assignee(id,login,name)",
+        "watchers(hasStar)",
+    ].join(","),
+    issueSearchBrief: [
+        "id",
+        "idReadable",
+        "summary",
+        "project(id,shortName,name)",
+        "parent(id,idReadable)",
+        "assignee(id,login,name)",
+        "watchers(hasStar)",
+    ].join(","),
+    issueDetails: [
+        "id",
+        "idReadable",
+        "summary",
+        "description",
+        "wikifiedDescription",
+        "usesMarkdown",
+        "created",
+        "updated",
+        "resolved",
+        "project(id,shortName,name)",
+        "parent(id,idReadable)",
+        "assignee(id,login,name)",
+        "reporter(id,login,name)",
+        "updater(id,login,name)",
+        "watchers(hasStar)",
+    ].join(","),
     issueDetailsLight: "id,idReadable,updated,updater(login)",
     comments: "id,text,textPreview,usesMarkdown,author(id,login,name),created,updated",
     commentsLight: "id,author(login),created,text",
@@ -53,6 +100,26 @@ export class YoutrackClient {
             throw normalized;
         });
     }
+    /**
+     * Process items with concurrency limit using MutexPool
+     * @param items - Array of items to process
+     * @param processor - Async function to process each item
+     * @param limit - Maximum number of concurrent operations (default: 10)
+     * @returns Array of results in original order
+     */
+    async processBatch(items, processor, limit = 10) {
+        const pool = new MutexPool(limit);
+        const results = new Array(items.length);
+        // Submit all jobs to the pool
+        items.forEach((item, index) => {
+            pool.start(async () => {
+                results[index] = await processor(item);
+            });
+        });
+        // Wait for all jobs to complete
+        await pool.allJobsFinished();
+        return results;
+    }
     async getCurrentUser() {
         if (this.cachedCurrentUser) {
             return this.cachedCurrentUser;
@@ -103,7 +170,8 @@ export class YoutrackClient {
             response.data.forEach((user) => {
                 this.usersByLogin.set(user.login, user);
             });
-            return { users: response.data };
+            const payload = { users: response.data };
+            return payload;
         }
         catch (error) {
             throw this.normalizeError(error);
@@ -122,7 +190,8 @@ export class YoutrackClient {
                     this.projectsByShortName.set(project.shortName, project);
                 }
             });
-            return { projects: response.data };
+            const payload = { projects: response.data };
+            return payload;
         }
         catch (error) {
             throw this.normalizeError(error);
@@ -362,10 +431,11 @@ export class YoutrackClient {
                     });
                 }
             }
-            return {
+            const payload = {
                 issues: foundIssues.map(mapIssue),
                 errors: errors.length ? errors : undefined,
             };
+            return payload;
         }
         catch (error) {
             throw this.normalizeError(error);
@@ -397,10 +467,11 @@ export class YoutrackClient {
                     });
                 }
             }
-            return {
+            const payload = {
                 issues: foundIssues.map(mapIssueDetails),
                 errors: errors.length ? errors : undefined,
             };
+            return payload;
         }
         catch (error) {
             throw this.normalizeError(error);
@@ -434,8 +505,8 @@ export class YoutrackClient {
         if (!issueIds.length) {
             return { commentsByIssue: {}, errors: [] };
         }
-        // Make parallel requests for all issues
-        const promises = issueIds.map(async (issueId) => {
+        // Make parallel requests for all issues with concurrency limiting
+        const results = await this.processBatch(issueIds, async (issueId) => {
             try {
                 const response = await this.http.get(`/api/issues/${issueId}/comments`, {
                     params: { fields: defaultFields.comments },
@@ -446,8 +517,7 @@ export class YoutrackClient {
                 const normalized = this.normalizeError(error);
                 return { issueId, error: normalized.message, success: false };
             }
-        });
-        const results = await Promise.all(promises);
+        }, 10);
         const commentsByIssue = {};
         const errors = [];
         for (const result of results) {
@@ -457,10 +527,11 @@ export class YoutrackClient {
             }
             errors.push({ issueId: result.issueId, error: result.error });
         }
-        return {
+        const payload = {
             commentsByIssue,
             errors: errors.length ? errors : undefined,
         };
+        return payload;
     }
     /**
      * Light version of getMultipleIssuesComments() that fetches only minimal comment fields
@@ -470,8 +541,8 @@ export class YoutrackClient {
         if (!issueIds.length) {
             return {};
         }
-        // Make parallel requests for all issues
-        const promises = issueIds.map(async (issueId) => {
+        // Make parallel requests for all issues with concurrency limiting
+        const results = await this.processBatch(issueIds, async (issueId) => {
             try {
                 const response = await this.http.get(`/api/issues/${issueId}/comments`, {
                     params: { fields: defaultFields.commentsLight },
@@ -482,15 +553,15 @@ export class YoutrackClient {
                 // Silently ignore errors in light mode - return empty array
                 return { issueId, success: false };
             }
-        });
-        const results = await Promise.all(promises);
+        }, 10);
         const commentsByIssue = {};
         for (const result of results) {
             if (result.success) {
                 commentsByIssue[result.issueId] = result.comments;
             }
         }
-        return commentsByIssue;
+        const payload = commentsByIssue;
+        return payload;
     }
     async searchIssuesByUserActivity(input) {
         const mode = input.dateFilterMode ?? "issue_updated";
@@ -601,9 +672,11 @@ export class YoutrackClient {
                 this.getIssuesDetailsLight(issueIds),
                 this.getMultipleIssuesCommentsLight(issueIds),
             ]);
-            // Get activities for each issue
-            const activitiesPromises = issueIds.map((issueId) => this.getIssueActivities(issueId));
-            const activitiesResults = await Promise.all(activitiesPromises);
+            // Get activities for each issue with concurrency limiting
+            const activitiesResults = await this.processBatch(issueIds, async (issueId) => {
+                const activities = await this.getIssueActivities(issueId);
+                return activities;
+            }, 10);
             // Process each issue to determine lastActivityDate
             const issuesWithActivity = this.filterIssuesByUserActivity(candidateIssues, detailsLight, commentsLight, activitiesResults, input);
             // Apply pagination
@@ -657,8 +730,10 @@ export class YoutrackClient {
                         this.getIssuesDetailsLight(issueIds),
                         this.getMultipleIssuesCommentsLight(issueIds),
                     ]);
-                    const activitiesPromises = issueIds.map((issueId) => this.getIssueActivities(issueId));
-                    const activitiesResults = await Promise.all(activitiesPromises);
+                    const activitiesResults = await this.processBatch(issueIds, async (issueId) => {
+                        const activities = await this.getIssueActivities(issueId);
+                        return activities;
+                    }, 10);
                     const issuesWithActivity = this.filterIssuesByUserActivity(candidateIssues, detailsLight, commentsLight, activitiesResults, input);
                     const skip = input.skip ?? 0;
                     const limit = input.limit ?? 100;
@@ -828,27 +903,28 @@ export class YoutrackClient {
         return limitedItems;
     }
     async getWorkItemsForUsers(logins, params = {}) {
-        const promises = logins.map((login) => this.listWorkItems({
+        const results = await this.processBatch(logins, async (login) => await this.listWorkItems({
             author: login,
             startDate: params.startDate,
             endDate: params.endDate,
             issueId: params.issueId,
-        }));
-        const results = await Promise.all(promises);
+        }), 10);
         const allItems = results.flat();
-        return allItems;
+        const payload = allItems;
+        return payload;
     }
     async listAllUsersWorkItems(params = {}) {
         const workItems = await this.listWorkItems({
             ...params,
             allUsers: true,
         });
-        return workItems;
+        const payload = workItems;
+        return payload;
     }
     async listRecentWorkItems(params = {}) {
         const limit = params.limit ?? 50;
         const users = params.users ?? [(await this.getCurrentUser()).login];
-        const promises = users.map(async (login) => {
+        const results = await this.processBatch(users, async (login) => {
             const requestParams = {
                 fields: defaultFields.workItems,
                 author: login,
@@ -865,8 +941,7 @@ export class YoutrackClient {
             catch (error) {
                 throw this.normalizeError(error);
             }
-        });
-        const results = await Promise.all(promises);
+        }, 10);
         const allItems = results.flat();
         const sortedByUpdated = allItems.sort((left, right) => {
             const leftTimestamp = left.updated ?? left.date;
@@ -874,7 +949,8 @@ export class YoutrackClient {
             return rightTimestamp - leftTimestamp;
         });
         const limitedItems = sortedByUpdated.slice(0, limit);
-        return limitedItems;
+        const payload = limitedItems;
+        return payload;
     }
     async createWorkItem(input) {
         const body = {
@@ -898,8 +974,8 @@ export class YoutrackClient {
         }
     }
     async createWorkItemMapped(input) {
-        const result = await this.createWorkItem(input);
-        const mappedWorkItem = mapWorkItem(result);
+        const workItem = await this.createWorkItem(input);
+        const mappedWorkItem = mapWorkItem(workItem);
         return mappedWorkItem;
     }
     async deleteWorkItem(issueId, workItemId) {
@@ -922,7 +998,7 @@ export class YoutrackClient {
         const summary = input.summary ?? existing.text ?? existing.description ?? "";
         const description = input.description ?? existing.description ?? existing.text ?? "";
         await this.deleteWorkItem(input.issueId, input.workItemId);
-        return await this.createWorkItem({
+        const workItem = await this.createWorkItem({
             issueId: input.issueId,
             date,
             minutes,
@@ -930,12 +1006,13 @@ export class YoutrackClient {
             description,
             usesMarkdown: input.usesMarkdown ?? existing.usesMarkdown,
         });
+        return workItem;
     }
     async createWorkItemsForPeriod(input) {
         validateDateRange(input.startDate, input.endDate);
         const dates = enumerateDateRange(input.startDate, input.endDate);
         const filteredDates = filterWorkingDays(dates, input.excludeWeekends ?? true, input.excludeHolidays ?? true, input.holidays ?? []);
-        const results = await Promise.all(filteredDates.map(async (dateIso) => {
+        const results = await this.processBatch(filteredDates, async (dateIso) => {
             try {
                 const item = await this.createWorkItem({
                     issueId: input.issueId,
@@ -951,7 +1028,7 @@ export class YoutrackClient {
                 const normalized = this.normalizeError(error);
                 return { success: false, date: dateIso, reason: normalized.message };
             }
-        }));
+        }, 10);
         const created = [];
         const failed = [];
         for (const result of results) {
@@ -961,10 +1038,11 @@ export class YoutrackClient {
             }
             failed.push({ date: result.date, reason: result.reason });
         }
-        return {
+        const payload = {
             created: mapWorkItems(created),
             failed,
         };
+        return payload;
     }
     async createWorkItemIdempotent(input) {
         const { start, end } = getDayBounds(input.date);
@@ -989,8 +1067,8 @@ export class YoutrackClient {
             description: input.description,
             usesMarkdown: input.usesMarkdown,
         });
-        const mappedWorkItem = mapWorkItem(item);
-        return mappedWorkItem;
+        const mappedItem = mapWorkItem(item);
+        return mappedItem;
     }
     async generateWorkItemReport(options = {}) {
         const workItems = await this.listWorkItems({
@@ -1079,10 +1157,11 @@ export class YoutrackClient {
     }
     async generateInvalidWorkItemReport(options = {}) {
         const report = await this.generateWorkItemReport(options);
-        return report.invalidDays;
+        const { invalidDays } = report;
+        return invalidDays;
     }
     async generateUsersWorkItemReports(logins, options = {}) {
-        const promises = logins.map(async (login) => {
+        const reports = await this.processBatch(logins, async (login) => {
             const report = await this.generateWorkItemReport({
                 ...options,
                 author: login,
@@ -1093,9 +1172,9 @@ export class YoutrackClient {
                 invalidDays: report.invalidDays,
                 period: report.period,
             };
-        });
-        const reports = await Promise.all(promises);
-        return { reports };
+        }, 10);
+        const payload = { reports };
+        return payload;
     }
     async getArticle(articleId) {
         try {
@@ -1132,8 +1211,8 @@ export class YoutrackClient {
                 },
             });
             const articles = response.data;
-            const payload = { articles };
-            return payload;
+            const articlesPayload = { articles };
+            return articlesPayload;
         }
         catch (error) {
             throw this.normalizeError(error);
@@ -1162,8 +1241,8 @@ export class YoutrackClient {
                 params,
             });
             const article = response.data;
-            const payload = { article };
-            return payload;
+            const articlePayload = { article };
+            return articlePayload;
         }
         catch (error) {
             throw this.normalizeError(error);
@@ -1189,8 +1268,8 @@ export class YoutrackClient {
                 params,
             });
             const article = response.data;
-            const payload = { article };
-            return payload;
+            const articlePayload = { article };
+            return articlePayload;
         }
         catch (error) {
             throw this.normalizeError(error);
@@ -1219,7 +1298,8 @@ export class YoutrackClient {
                     ...(input.limit ? { top: input.limit } : {}),
                 },
             });
-            return { articles: response.data, query: input.query };
+            const searchPayload = { articles: response.data, query: input.query };
+            return searchPayload;
         }
         catch (error) {
             throw this.normalizeError(error);
@@ -1231,10 +1311,11 @@ export class YoutrackClient {
                 params: { fields: defaultFields.attachments },
             });
             const mapped = mapAttachments(response.data);
-            return {
+            const payload = {
                 attachments: mapped,
                 issueId,
             };
+            return payload;
         }
         catch (error) {
             throw this.normalizeError(error);
@@ -1246,10 +1327,11 @@ export class YoutrackClient {
                 params: { fields: defaultFields.attachment },
             });
             const mapped = mapAttachment(response.data);
-            return {
+            const payload = {
                 attachment: mapped,
                 issueId,
             };
+            return payload;
         }
         catch (error) {
             throw this.normalizeError(error);
@@ -1266,11 +1348,12 @@ export class YoutrackClient {
             }
             const downloadUrl = `${this.config.baseUrl}${attachment.url}`;
             const mapped = mapAttachment(attachment);
-            return {
+            const payload = {
                 attachment: mapped,
                 downloadUrl,
                 issueId,
             };
+            return payload;
         }
         catch (error) {
             throw this.normalizeError(error);
@@ -1300,10 +1383,11 @@ export class YoutrackClient {
                 headers: formData.getHeaders(),
             });
             const mapped = mapAttachments(response.data);
-            return {
+            const payload = {
                 uploaded: mapped,
                 issueId: input.issueId,
             };
+            return payload;
         }
         catch (error) {
             throw this.normalizeError(error);
@@ -1319,12 +1403,13 @@ export class YoutrackClient {
         // Perform deletion
         try {
             await this.http.delete(`/api/issues/${input.issueId}/attachments/${input.attachmentId}`);
-            return {
+            const payload = {
                 deleted: true,
                 issueId: input.issueId,
                 attachmentId: input.attachmentId,
                 attachmentName: attachmentInfo.attachment.name,
             };
+            return payload;
         }
         catch (error) {
             throw this.normalizeError(error);
@@ -1349,15 +1434,15 @@ export class YoutrackClient {
             }
             const fallbackMessage = typeof error.message === "string" && error.message.length > 0 ? error.message : undefined;
             const finalMessage = responseMessage ?? fallbackMessage ?? "Unknown error";
-            const clientError = new YoutrackClientError(`YouTrack API error: ${finalMessage}`, status, data);
-            return clientError;
+            const normalizedError = new YoutrackClientError(`YouTrack API error: ${finalMessage}`, status, data);
+            return normalizedError;
         }
         if (error instanceof Error) {
-            const errorFromMessage = new YoutrackClientError(error.message);
-            return errorFromMessage;
+            const normalizedError = new YoutrackClientError(error.message);
+            return normalizedError;
         }
-        const stringError = new YoutrackClientError(String(error));
-        return stringError;
+        const normalizedError = new YoutrackClientError(String(error));
+        return normalizedError;
     }
     async resolveAssignee(login) {
         if (login === "me") {
@@ -1373,15 +1458,15 @@ export class YoutrackClient {
         const response = await this.http.get(`/api/issues/${issueId}`, {
             params: { fields: defaultFields.issue },
         });
-        const issue = response.data;
-        return issue;
+        const rawIssue = response.data;
+        return rawIssue;
     }
     async getWorkItemById(workItemId) {
         const response = await this.http.get(`/api/workItems/${workItemId}`, {
             params: { fields: defaultFields.workItem },
         });
-        const workItem = response.data;
-        return workItem;
+        const rawWorkItem = response.data;
+        return rawWorkItem;
     }
     resolveReportBoundary(items, mode) {
         if (!items.length) {
@@ -1390,8 +1475,8 @@ export class YoutrackClient {
         }
         const timestamps = items.map((item) => item.date);
         const target = mode === "min" ? Math.min(...timestamps) : Math.max(...timestamps);
-        const boundary = toIsoDateString(target);
-        return boundary;
+        const boundaryDate = toIsoDateString(target);
+        return boundaryDate;
     }
     // State change methods
     async getIssueCustomFields(issueId) {
@@ -1401,7 +1486,8 @@ export class YoutrackClient {
                     fields: "id,name,value(id,name,presentation),$type,possibleEvents(id,presentation)",
                 },
             });
-            return response.data;
+            const customFields = response.data;
+            return customFields;
         }
         catch (error) {
             throw this.normalizeError(error);
@@ -1438,12 +1524,13 @@ export class YoutrackClient {
                     },
                 };
                 await this.http.post(`/api/issues/${input.issueId}/fields/${stateField.id}`, body);
-                return {
+                const payload = {
                     issueId: input.issueId,
                     previousState,
                     newState: matchingEvent.presentation,
                     transitionUsed: matchingEvent.id,
                 };
+                return payload;
             }
             // Handle StateIssueCustomField (simple bundle-based)
             if (stateField.$type === "StateIssueCustomField") {
@@ -1473,11 +1560,12 @@ export class YoutrackClient {
                     }
                     throw normalized;
                 }
-                return {
+                const payload = {
                     issueId: input.issueId,
                     previousState,
                     newState: input.stateName,
                 };
+                return payload;
             }
             throw new YoutrackClientError(`Unsupported state field type: ${stateField.$type}`);
         }
@@ -1485,5 +1573,175 @@ export class YoutrackClient {
             throw this.normalizeError(error);
         }
     }
+    // Issue star management methods
+    /**
+     * Get watchers list for an issue (internal method)
+     */
+    async getIssueWatchers(issueId) {
+        try {
+            const response = await this.http.get(`/api/issues/${issueId}/watchers/issueWatchers`, {
+                params: { fields: "id,user(id,login,name),isStarred,$type" },
+            });
+            const watchers = response.data;
+            return watchers;
+        }
+        catch (error) {
+            throw this.normalizeError(error);
+        }
+    }
+    /**
+     * Add star to an issue (idempotent)
+     */
+    async starIssue(issueId) {
+        try {
+            const currentUser = await this.getCurrentUser();
+            const watchers = await this.getIssueWatchers(issueId);
+            const existingWatcher = watchers.find((w) => w.user.id === currentUser.id && w.isStarred);
+            if (existingWatcher) {
+                const payload = {
+                    issueId,
+                    starred: true,
+                    message: "Issue already starred",
+                };
+                return payload;
+            }
+            const body = {
+                user: { id: currentUser.id },
+                isStarred: true,
+            };
+            await this.http.post(`/api/issues/${issueId}/watchers/issueWatchers`, body);
+            const payload = {
+                issueId,
+                starred: true,
+                message: "Issue starred successfully",
+            };
+            return payload;
+        }
+        catch (error) {
+            throw this.normalizeError(error);
+        }
+    }
+    /**
+     * Remove star from an issue (idempotent)
+     */
+    async unstarIssue(issueId) {
+        try {
+            const currentUser = await this.getCurrentUser();
+            const watchers = await this.getIssueWatchers(issueId);
+            const existingWatcher = watchers.find((w) => w.user.id === currentUser.id && w.isStarred);
+            if (!existingWatcher) {
+                const payload = {
+                    issueId,
+                    starred: false,
+                    message: "Issue not starred",
+                };
+                return payload;
+            }
+            await this.http.delete(`/api/issues/${issueId}/watchers/issueWatchers/${existingWatcher.id}`);
+            const payload = {
+                issueId,
+                starred: false,
+                message: "Issue unstarred successfully",
+            };
+            return payload;
+        }
+        catch (error) {
+            throw this.normalizeError(error);
+        }
+    }
+    /**
+     * Add stars to multiple issues with concurrency limiting (max 50 issues)
+     */
+    async starIssues(issueIds) {
+        if (issueIds.length > 50) {
+            throw new YoutrackClientError("Maximum 50 issues allowed per batch operation");
+        }
+        const results = await this.processBatch(issueIds, async (issueId) => {
+            try {
+                const result = await this.starIssue(issueId);
+                return { success: true, issueId, starred: result.starred };
+            }
+            catch (error) {
+                const normalized = this.normalizeError(error);
+                return { success: false, issueId, error: normalized.message };
+            }
+        }, 10);
+        const successful = [];
+        const failed = [];
+        for (const result of results) {
+            if (result.success) {
+                successful.push({ issueId: result.issueId, starred: result.starred });
+                continue;
+            }
+            failed.push({ issueId: result.issueId, error: result.error });
+        }
+        const payload = {
+            successful,
+            failed,
+        };
+        return payload;
+    }
+    /**
+     * Remove stars from multiple issues with concurrency limiting (max 50 issues)
+     */
+    async unstarIssues(issueIds) {
+        if (issueIds.length > 50) {
+            throw new YoutrackClientError("Maximum 50 issues allowed per batch operation");
+        }
+        const results = await this.processBatch(issueIds, async (issueId) => {
+            try {
+                const result = await this.unstarIssue(issueId);
+                return { success: true, issueId, starred: result.starred };
+            }
+            catch (error) {
+                const normalized = this.normalizeError(error);
+                return { success: false, issueId, error: normalized.message };
+            }
+        }, 10);
+        const successful = [];
+        const failed = [];
+        for (const result of results) {
+            if (result.success) {
+                successful.push({ issueId: result.issueId, starred: result.starred });
+                continue;
+            }
+            failed.push({ issueId: result.issueId, error: result.error });
+        }
+        const payload = {
+            successful,
+            failed,
+        };
+        return payload;
+    }
+    /**
+     * Get all starred issues for current user with pagination
+     */
+    async getStarredIssues(options = {}) {
+        try {
+            const limit = options.limit ?? 50; // Default to 50 instead of 200
+            const skip = options.skip ?? 0;
+            const response = await this.http.get("/api/issues", {
+                params: {
+                    fields: defaultFields.issueSearchBrief, // Use brief fields without description
+                    query: "has: star",
+                    $top: Math.min(limit, DEFAULT_PAGE_SIZE),
+                    $skip: skip,
+                },
+            });
+            const payload = {
+                issues: response.data.map(mapIssueBrief),
+                returnedCount: response.data.length,
+                pagination: {
+                    returned: response.data.length,
+                    limit,
+                    skip,
+                },
+            };
+            return payload;
+        }
+        catch (error) {
+            throw this.normalizeError(error);
+        }
+    }
 }
 //# sourceMappingURL=youtrack-client.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vitalyostanin/youtrack-mcp",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "postbuild": "chmod +x dist/index.js",
@@ -51,6 +51,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.20.0",
+    "@vitalyostanin/mutex-pool": "^0.0.3",
     "axios": "^1.12.2",
     "form-data": "^4.0.1",
     "luxon": "^3.5.0",