@levinariy.fedorov/youtrack-mcp 0.1.0 → 0.2.0

package/README.md

@@ -16,7 +16,7 @@ MCP-сервер прямо в продукте, и если он у вас ес
   "mcpServers": {
     "youtrack": {
       "command": "npx",
-      "args": ["-y", "@levinariy.fedorov/youtrack-mcp@0.1.0"]
+      "args": ["-y", "@levinariy.fedorov/youtrack-mcp@0.2.0"]
     }
   }
 }
@@ -50,14 +50,18 @@ npx @levinariy.fedorov/youtrack-mcp profiles
 | --- | --- |
 | `read_issue` | Задача целиком: поля, комментарии, вложения, связи — одним вызовом |
 | `search_issues` | Поиск запросом YouTrack; только идентификатор, тема и поля |
+| `add_comment` | Комментарий: заказчику или ограниченного круга |
+| `update_issue` | Поля, статус, тема, описание |
+| `create_issue` | Новая задача в проекте |
+| `log_work` | Списание времени |
 | `whoami` | Учётная запись, от имени которой идут вызовы |
 
 Ответы структурированные: у каждого инструмента объявлен `outputSchema`, и
 вызывающий получает объект, а не JSON внутри текста.
 
 `read_issue` отдаёт поля плоской картой (`fields["Type"]`), у комментария —
-булево `public` вместо разбора видимости, у вложения — комментарий, к которому оно
-приложено. Даты приходят датами: у YouTrack они лежат миллисекундами эпохи и от
+булево `public` вместо разбора видимости, у вложения — `commentId` того комментария,
+к которому оно приложено (нет поля — приложено к самой задаче). Даты приходят датами: у YouTrack они лежат миллисекундами эпохи и от
 обычного целого неотличимы, поэтому тип поля запрашивается вместе со значением.
 С `attachments: true` файлы скачиваются на диск и получают `path`: содержимое в
 ответ не попадает, читать файл — отдельный шаг.
@@ -65,6 +69,27 @@ npx @levinariy.fedorov/youtrack-mcp profiles
 Пустые поля не отдаются: «поля нет» и «поле не заполнено» для читающего одно и то
 же, а два десятка пустых строк в каждом ответе — потраченный впустую контекст.
 
+### Запись
+
+`add_comment` без `visibleTo` публикует комментарий, видимый всем, кто видит задачу, —
+включая заказчика; отозвать его нельзя. `visibleTo` ограничивает круг: `group:Название`
+или логин. Своего понятия «внутренний» здесь нет: в одной инсталляции это группа
+сотрудников, в другой — конкретные люди, и угадывать за вас значило бы иногда
+показать заказчику написанное не ему.
+
+`update_issue` принимает поля по их именам в YouTrack. Тип значения выводится из
+самой задачи: пользователь задаётся логином, справочник — значением, дата — как
+`2026-09-30`, период — как `2h`. Статус, если он машина состояний, переводится
+командой, а не присваиванием: присвоенное значение YouTrack молча игнорирует, и
+задача осталась бы в прежнем состоянии при успешном на вид ответе. Недопустимый
+переход возвращает ошибку со списком доступных из текущего состояния, а не
+«Недопустимое значение».
+
+Возвращается задача целиком после изменения — workflow мог поправить соседние поля.
+
+Сообщения YouTrack приходят с кириллицей, экранированной числовыми ссылками HTML;
+здесь они раскодированы, иначе ошибка выглядела бы набором `О`.
+
 Инструментов чтения конфигурации нет и не будет: токен не должен попадать в
 контекст модели.
 

package/dist/client.js

@@ -16,17 +16,34 @@ export class YouTrackError extends Error {
         this.name = "YouTrackError";
     }
 }
+/**
+ * Возвращает человеческий текст ошибки.
+ *
+ * YouTrack экранирует кириллицу числовыми ссылками HTML, и без обратного
+ * преобразования сообщение приезжает набором `О` — бесполезным и для
+ * человека, и для модели.
+ */
+function unescapeEntities(text) {
+    return text
+        .replace(/&#(\d+);/g, (_, code) => String.fromCodePoint(Number(code)))
+        .replace(/&#x([0-9a-f]+);/gi, (_, code) => String.fromCodePoint(Number.parseInt(code, 16)))
+        .replace(/"/g, '"')
+        .replace(/'/g, "'")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&amp;/g, "&");
+}
 function describe(status, body) {
     try {
         const parsed = JSON.parse(body);
         const text = parsed.error_description ?? parsed.error;
         if (text)
-            return text;
+            return unescapeEntities(text);
     }
     catch {
         // YouTrack отвечает и просто текстом — тогда берём его как есть.
     }
-    return body.trim().slice(0, 500) || `HTTP ${status}`;
+    return unescapeEntities(body.trim()).slice(0, 500) || `HTTP ${status}`;
 }
 export class YouTrackClient {
     credentials;

package/dist/index.d.ts

@@ -9,4 +9,6 @@ export { AuthError, configPath, listProfiles, readConfig, removeProfile, resolve
 export type { Config, Credentials, ProfileInfo } from "./config.js";
 export { me, readIssue, searchIssues } from "./issues.js";
 export type { Attachment, Comment, Found, Issue, Link, Person, ReadOptions } from "./issues.js";
+export { addComment, createIssue, logWork, updateIssue } from "./write.js";
+export type { Audience, NewIssue, PostedComment, UpdateRequest, WorkItem } from "./write.js";
 export { createServer } from "./server.js";

package/dist/index.js

@@ -7,4 +7,5 @@
 export { YouTrackClient, YouTrackError } from "./client.js";
 export { AuthError, configPath, listProfiles, readConfig, removeProfile, resolveCredentials, saveProfile, setDefaultProfile } from "./config.js";
 export { me, readIssue, searchIssues } from "./issues.js";
+export { addComment, createIssue, logWork, updateIssue } from "./write.js";
 export { createServer } from "./server.js";

package/dist/issues.d.ts

@@ -16,8 +16,8 @@ export type Attachment = {
     name: string;
     mimeType: string;
     size: number;
-    /** Комментарий, к которому приложен файл, либо null — если к самой задаче. */
-    commentId: string | null;
+    /** Комментарий, к которому приложен файл. Нет поля — файл приложен к самой задаче. */
+    commentId?: string;
     /** Путь на диске. Появляется, только если файлы просили скачать. */
     path?: string;
 };
@@ -38,7 +38,8 @@ export type Issue = {
     reporter: Person;
     created: string;
     updated: string;
-    resolved: string | null;
+    /** Когда задача решена. Нет поля — не решена. */
+    resolved?: string;
     /** Значения полей задачи по именам: Type, State, Business solution, Priority. */
     fields: Record<string, string>;
     comments: Comment[];

package/dist/issues.js

@@ -88,7 +88,7 @@ function toIssue(raw, baseUrl) {
         reporter: person(raw.reporter),
         created: moment(raw.created) ?? "",
         updated: moment(raw.updated) ?? "",
-        resolved: moment(raw.resolved),
+        ...(moment(raw.resolved) === null ? {} : { resolved: moment(raw.resolved) }),
         fields: collectFields(raw),
         comments: (raw.comments ?? []).map((comment) => ({
             id: comment.id ?? "",
@@ -104,7 +104,7 @@ function toIssue(raw, baseUrl) {
             name: attachment.name ?? "",
             mimeType: attachment.mimeType ?? "",
             size: attachment.size ?? 0,
-            commentId: attachment.comment?.id ?? null
+            ...(attachment.comment?.id ? { commentId: attachment.comment.id } : {})
         })),
         links: (raw.links ?? [])
             .filter((link) => (link.issues ?? []).length > 0)

package/dist/server.js

@@ -3,6 +3,7 @@ import { z } from "zod";
 import { YouTrackClient } from "./client.js";
 import { resolveCredentials } from "./config.js";
 import { me, readIssue, searchIssues } from "./issues.js";
+import { addComment, createIssue, logWork, updateIssue } from "./write.js";
 /**
  * Клиенты живут по имени профиля: конфигурацию незачем перечитывать на каждый
  * вызов, а профилей всё равно единицы.
@@ -31,7 +32,9 @@ const IssueSchema = z.object({
     reporter: PersonSchema,
     created: z.string(),
     updated: z.string(),
-    resolved: z.string().nullable(),
+    // Не nullable и не union: оба дают type: ["string","null"], а часть MCP-клиентов
+    // читает type только как строку. Нерешённая задача — поле просто отсутствует.
+    resolved: z.string().optional(),
     fields: z.record(z.string(), z.string()),
     comments: z.array(z.object({
         id: z.string(),
@@ -45,7 +48,7 @@ const IssueSchema = z.object({
         name: z.string(),
         mimeType: z.string(),
         size: z.number(),
-        commentId: z.string().nullable(),
+        commentId: z.string().optional(),
         path: z.string().optional()
     })),
     links: z.array(z.object({ type: z.string(), issues: z.array(z.object({ id: z.string(), summary: z.string() })) }))
@@ -87,6 +90,97 @@ export function createServer() {
         const issues = await searchIssues(await clientFor(profile), query, limit);
         return { content: [{ type: "text", text: `Найдено задач: ${issues.length}` }], structuredContent: { issues } };
     });
+    server.registerTool("add_comment", {
+        title: "Прокомментировать задачу",
+        description: "Публикует комментарий. Без `visibleTo` его увидит каждый, кто видит задачу, — включая заказчика; " +
+            "это ответ, а не заметка, и отозвать его нельзя. " +
+            "`visibleTo` ограничивает круг: `group:Название` — группой, иначе логин, `me` — вами. " +
+            "Через `profile` комментарий публикуется от сервисной учётки.",
+        inputSchema: {
+            id: z.string().describe("Идентификатор задачи, например PROJ-1234"),
+            text: z.string().min(1).describe("Текст комментария в разметке YouTrack"),
+            visibleTo: z
+                .array(z.string())
+                .optional()
+                .describe("Кому виден комментарий: `group:Название` или логин. Пусто — виден всем, включая заказчика."),
+            profile: profileArg
+        },
+        outputSchema: { id: z.string(), created: z.string(), public: z.boolean() },
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
+    }, async ({ id, text, visibleTo, profile }) => {
+        const comment = await addComment(await clientFor(profile), id, text, visibleTo ?? []);
+        return {
+            content: [{ type: "text", text: comment.public ? "Опубликован комментарий, видимый заказчику." : "Опубликована внутренняя заметка." }],
+            structuredContent: comment
+        };
+    });
+    server.registerTool("update_issue", {
+        title: "Изменить поля задачи",
+        description: "Меняет поля задачи по их именам в YouTrack: `{\"State\": \"Analysis\", \"Assignee\": \"ivan.petrov\"}`. " +
+            "Пользователь задаётся логином, справочник и статус — значением, дата — как 2026-09-07, пустая строка очищает поле. " +
+            "Возвращает задачу целиком после изменения: workflow мог поправить соседние поля или отклонить переход, " +
+            "и увидеть это надо по факту, а не по намерению.",
+        inputSchema: {
+            id: z.string().describe("Идентификатор задачи, например PROJ-1234"),
+            fields: z.record(z.string(), z.string()).optional().describe("Поля задачи по именам"),
+            summary: z.string().optional().describe("Новая тема"),
+            description: z.string().optional().describe("Новое описание — заменяет прежнее целиком"),
+            profile: profileArg
+        },
+        outputSchema: IssueSchema.shape,
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true }
+    }, async ({ id, fields, summary, description, profile }) => {
+        const issue = await updateIssue(await clientFor(profile), id, {
+            ...(fields === undefined ? {} : { fields }),
+            ...(summary === undefined ? {} : { summary }),
+            ...(description === undefined ? {} : { description })
+        });
+        return { content: [{ type: "text", text: `${issue.id}: ${issue.summary}` }], structuredContent: issue };
+    });
+    server.registerTool("create_issue", {
+        title: "Создать задачу",
+        description: "Заводит задачу в проекте по его короткому имени. Поля выставляются вторым шагом, поэтому ошибка в одном из них " +
+            "не оставит задачу недосозданной — она будет создана, а поле названо в ошибке.",
+        inputSchema: {
+            project: z.string().describe("Короткое имя проекта, например PROJ"),
+            summary: z.string().min(1).describe("Тема задачи"),
+            description: z.string().optional().describe("Описание в разметке YouTrack"),
+            fields: z.record(z.string(), z.string()).optional().describe("Поля задачи по именам"),
+            profile: profileArg
+        },
+        outputSchema: IssueSchema.shape,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
+    }, async ({ project, summary, description, fields, profile }) => {
+        const issue = await createIssue(await clientFor(profile), {
+            project,
+            summary,
+            ...(description === undefined ? {} : { description }),
+            ...(fields === undefined ? {} : { fields })
+        });
+        return { content: [{ type: "text", text: `Создана ${issue.id}: ${issue.summary}` }], structuredContent: issue };
+    });
+    server.registerTool("log_work", {
+        title: "Списать время",
+        description: "Добавляет запись о работе. Минуты целые, дата — день, к которому относится работа (по умолчанию сегодня): " +
+            "списание задним числом здесь обычное дело. Прежние записи не трогает, каждый вызов добавляет новую.",
+        inputSchema: {
+            id: z.string().describe("Идентификатор задачи, например PROJ-1234"),
+            minutes: z.number().int().min(1).describe("Сколько минут списать"),
+            date: z.string().optional().describe("День работы в формате 2026-09-07; по умолчанию сегодня"),
+            text: z.string().optional().describe("Что было сделано"),
+            type: z.string().optional().describe("Тип работы, если он настроен в YouTrack"),
+            profile: profileArg
+        },
+        outputSchema: { id: z.string(), minutes: z.number(), date: z.string(), text: z.string() },
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
+    }, async ({ id, minutes, date, text, type, profile }) => {
+        const item = await logWork(await clientFor(profile), id, minutes, {
+            ...(date === undefined ? {} : { date }),
+            ...(text === undefined ? {} : { text }),
+            ...(type === undefined ? {} : { type })
+        });
+        return { content: [{ type: "text", text: `Списано ${item.minutes} мин за ${item.date}.` }], structuredContent: item };
+    });
     server.registerTool("whoami", {
         title: "Кто я в YouTrack",
         description: "Учётная запись, от имени которой идут вызовы. Нужна там, где скилл ставит Assignee на себя.",

package/dist/write.d.ts

@@ -0,0 +1,50 @@
+import type { YouTrackClient } from "./client.js";
+import { type Issue } from "./issues.js";
+/**
+ * Кому виден комментарий.
+ *
+ * Пустой список значит «всем, кто видит задачу», то есть и заказчику. Строка
+ * вида `group:Название` ограничивает группой, всё остальное считается логином.
+ * Своего понятия «внутренний» здесь нет намеренно: в одной инсталляции это
+ * группа сотрудников, в другой — конкретные люди, и угадывать за пользователя
+ * значило бы иногда показывать заказчику то, что писали не ему.
+ */
+export type Audience = string[];
+export type PostedComment = {
+    id: string;
+    created: string;
+    /** Виден заказчику. */
+    public: boolean;
+};
+export declare function addComment(client: YouTrackClient, issueId: string, text: string, audience?: Audience): Promise<PostedComment>;
+export type UpdateRequest = {
+    /** Поля задачи по именам, как они называются в YouTrack. Пустая строка очищает поле. */
+    fields?: Record<string, string>;
+    summary?: string;
+    description?: string;
+};
+export declare function updateIssue(client: YouTrackClient, issueId: string, request: UpdateRequest): Promise<Issue>;
+export type NewIssue = {
+    project: string;
+    summary: string;
+    description?: string;
+    fields?: Record<string, string>;
+};
+export declare function createIssue(client: YouTrackClient, request: NewIssue): Promise<Issue>;
+export type WorkItem = {
+    id: string;
+    minutes: number;
+    date: string;
+    text: string;
+};
+/**
+ * Списывает время.
+ *
+ * Дата — день, к которому относится работа: списание задним числом обычное дело,
+ * а по умолчанию берётся сегодняшний.
+ */
+export declare function logWork(client: YouTrackClient, issueId: string, minutes: number, options?: {
+    date?: string;
+    text?: string;
+    type?: string;
+}): Promise<WorkItem>;

package/dist/write.js

@@ -0,0 +1,203 @@
+import { YouTrackError } from "./client.js";
+import { readIssue } from "./issues.js";
+async function resolveAudience(client, audience) {
+    const groups = [];
+    const users = [];
+    for (const raw of audience) {
+        const target = raw.trim();
+        if (target === "")
+            continue;
+        if (target.toLowerCase().startsWith("group:")) {
+            const name = target.slice("group:".length).trim();
+            const found = await client.get("/api/groups", { fields: "id,name", $top: 1000 });
+            const group = found.find((item) => item.name.toLowerCase() === name.toLowerCase());
+            if (!group)
+                throw new YouTrackError(`Группы «${name}» нет в YouTrack. Доступные: ${found.map((g) => g.name).join(", ")}.`, 404);
+            groups.push({ id: group.id });
+            continue;
+        }
+        const login = target.toLowerCase() === "me" ? undefined : target;
+        const user = login
+            ? await client.get("/api/users", { fields: "id,login", query: login, $top: 1 }).then((list) => list[0])
+            : await client.get("/api/users/me", { fields: "id" });
+        if (!user)
+            throw new YouTrackError(`Пользователя «${target}» нет в YouTrack.`, 404);
+        users.push({ id: user.id });
+    }
+    if (groups.length === 0 && users.length === 0)
+        return undefined;
+    return {
+        $type: "LimitedVisibility",
+        ...(groups.length > 0 ? { permittedGroups: groups } : {}),
+        ...(users.length > 0 ? { permittedUsers: users } : {})
+    };
+}
+export async function addComment(client, issueId, text, audience = []) {
+    const visibility = await resolveAudience(client, audience);
+    const body = { text, ...(visibility ? { visibility } : {}) };
+    const created = await client.post(`/api/issues/${encodeURIComponent(issueId)}/comments`, body, { fields: "id,created,visibility($type)" });
+    return {
+        id: created.id ?? "",
+        created: created.created ? new Date(created.created).toISOString() : "",
+        public: created.visibility?.$type !== "LimitedVisibility"
+    };
+}
+/**
+ * Готовит значение поля к записи.
+ *
+ * YouTrack принимает разные формы в зависимости от типа поля, и ошибиться легко:
+ * пользователь задаётся логином, перечисление — именем, дата — миллисекундами.
+ * Тип берётся у самой задачи, а не угадывается по имени поля.
+ */
+function toFieldValue(fieldType, value) {
+    if (value === "")
+        return null;
+    switch (fieldType) {
+        case "user[1]":
+            return { login: value };
+        case "integer":
+        case "float":
+            return Number(value);
+        case "date":
+        case "date and time": {
+            const parsed = Date.parse(value);
+            if (Number.isNaN(parsed))
+                throw new YouTrackError(`«${value}» не похоже на дату: нужен формат 2026-09-07.`, 400);
+            return parsed;
+        }
+        case "period":
+            return { presentation: value };
+        case "string":
+        case "text":
+            return value;
+        default:
+            // enum, state, ownedField, version, build и прочие справочники — по имени.
+            return { name: value };
+    }
+}
+export async function updateIssue(client, issueId, request) {
+    const path = `/api/issues/${encodeURIComponent(issueId)}`;
+    const body = {};
+    if (request.summary !== undefined)
+        body.summary = request.summary;
+    if (request.description !== undefined)
+        body.description = request.description;
+    const wanted = Object.entries(request.fields ?? {});
+    const transitions = [];
+    if (wanted.length > 0) {
+        const current = await client.get(path, {
+            fields: "customFields($type,name,projectCustomField(canBeEmpty,field(fieldType(id))))"
+        });
+        const known = new Map((current.customFields ?? []).map((field) => [field.name ?? "", field]));
+        const assignments = [];
+        for (const [name, value] of wanted) {
+            const field = known.get(name);
+            if (!field) {
+                throw new YouTrackError(`Поля «${name}» нет в этой задаче. Есть: ${[...known.keys()].filter(Boolean).join(", ")}.`, 400);
+            }
+            // Машина состояний не принимает присваивание: записанное значение она молча
+            // игнорирует, а переход выполняет только команда. Тихо потерянный статус
+            // хуже ошибки, поэтому такие поля идут отдельным путём.
+            if (field.$type === "StateMachineIssueCustomField") {
+                if (value === "")
+                    throw new YouTrackError(`Поле «${name}» — машина состояний, очистить его нельзя.`, 400);
+                transitions.push([name, value]);
+                continue;
+            }
+            // Обязательное поле молча не очистится: YouTrack ответит «Недопустимое
+            // значение», по которому не понять, что дело в обязательности.
+            if (value === "" && field.projectCustomField?.canBeEmpty === false) {
+                throw new YouTrackError(`Поле «${name}» нельзя очистить: в этом проекте оно обязательное.`, 400);
+            }
+            assignments.push({
+                name,
+                $type: field.$type,
+                value: toFieldValue(field.projectCustomField?.field?.fieldType?.id, value)
+            });
+        }
+        if (assignments.length > 0)
+            body.customFields = assignments;
+    }
+    if (Object.keys(body).length === 0 && transitions.length === 0) {
+        throw new YouTrackError("Нечего менять: не передано ни одного поля.", 400);
+    }
+    if (Object.keys(body).length > 0)
+        await client.post(path, body, { fields: "id" });
+    // Переходы применяются по одному: YouTrack отвечает на команду ошибкой, и по
+    // ней видно, какой именно переход не разрешён из текущего состояния.
+    for (const [name, value] of transitions) {
+        try {
+            await client.post("/api/commands", { query: `${name} ${value}`, issues: [{ idReadable: issueId }] }, { fields: "issues(idReadable)" });
+        }
+        catch (error) {
+            // Ответ YouTrack на отклонённый переход не называет ни текущего состояния,
+            // ни доступных: без них следующая попытка будет такой же слепой.
+            const field = await client.get(`/api/issues/${encodeURIComponent(issueId)}/customFields/${encodeURIComponent(name)}`, { fields: "value(name),possibleEvents(presentation)" });
+            const available = (field.possibleEvents ?? []).map((event) => event.presentation).filter(Boolean);
+            throw new YouTrackError(`Из состояния «${field.value?.name ?? "?"}» нельзя перейти в «${value}». Доступны: ${available.join(", ") || "нет ни одного"}.`, 400);
+        }
+    }
+    // Возвращаем задачу целиком: вызывающему важно увидеть, что получилось на
+    // самом деле — workflow мог поправить соседние поля или отклонить переход.
+    return readIssue(client, issueId);
+}
+export async function createIssue(client, request) {
+    const projects = await client.get("/api/admin/projects", {
+        fields: "id,shortName",
+        query: request.project,
+        $top: 100
+    });
+    const project = projects.find((item) => item.shortName.toLowerCase() === request.project.toLowerCase());
+    if (!project)
+        throw new YouTrackError(`Проекта «${request.project}» нет или он недоступен.`, 404);
+    const created = await client.post("/api/issues", {
+        project: { id: project.id },
+        summary: request.summary,
+        ...(request.description === undefined ? {} : { description: request.description })
+    }, { fields: "idReadable" });
+    const id = created.idReadable;
+    if (!id)
+        throw new YouTrackError("YouTrack создал задачу, но не вернул её номер.", 500);
+    // Поля выставляются вторым шагом: при создании YouTrack принимает не все, а
+    // частично применённый набор хуже понятной ошибки на конкретном поле.
+    if (request.fields && Object.keys(request.fields).length > 0) {
+        return updateIssue(client, id, { fields: request.fields });
+    }
+    return readIssue(client, id);
+}
+/**
+ * Списывает время.
+ *
+ * Дата — день, к которому относится работа: списание задним числом обычное дело,
+ * а по умолчанию берётся сегодняшний.
+ */
+export async function logWork(client, issueId, minutes, options = {}) {
+    if (!Number.isInteger(minutes) || minutes <= 0)
+        throw new YouTrackError("Списывать можно только целые минуты больше нуля.", 400);
+    const date = options.date ? Date.parse(options.date) : Date.now();
+    if (Number.isNaN(date))
+        throw new YouTrackError(`«${options.date}» не похоже на дату: нужен формат 2026-09-07.`, 400);
+    let type;
+    if (options.type) {
+        const types = await client.get("/api/admin/timeTrackingSettings/workItemTypes", {
+            fields: "id,name",
+            $top: 100
+        });
+        const found = types.find((item) => item.name.toLowerCase() === options.type?.toLowerCase());
+        if (!found)
+            throw new YouTrackError(`Типа работы «${options.type}» нет. Есть: ${types.map((t) => t.name).join(", ")}.`, 404);
+        type = { id: found.id };
+    }
+    const created = await client.post(`/api/issues/${encodeURIComponent(issueId)}/timeTracking/workItems`, {
+        duration: { minutes },
+        date,
+        ...(options.text === undefined ? {} : { text: options.text }),
+        ...(type ? { type } : {})
+    }, { fields: "id,duration(minutes),date,text" });
+    return {
+        id: created.id ?? "",
+        minutes: created.duration?.minutes ?? minutes,
+        date: created.date ? new Date(created.date).toISOString().slice(0, 10) : "",
+        text: created.text ?? ""
+    };
+}

package/package.json

@@ -1,8 +1,8 @@
 {
 	"name": "@levinariy.fedorov/youtrack-mcp",
-	"version": "0.1.0",
+	"version": "0.2.0",
 	"type": "module",
-	"description": "MCP-сервер и библиотека для YouTrack: задача целиком одним вызовом — поля, комментарии, вложения, связи.",
+	"description": "MCP-сервер и библиотека для YouTrack: чтение задачи целиком, комментарии, поля и статусы, списание времени.",
 	"keywords": [
 		"mcp",
 		"model-context-protocol",