@levinariy.fedorov/youtrack-mcp 0.1.1 → 0.2.1

package/README.md

@@ -16,7 +16,7 @@ MCP-сервер прямо в продукте, и если он у вас ес
   "mcpServers": {
     "youtrack": {
       "command": "npx",
-      "args": ["-y", "@levinariy.fedorov/youtrack-mcp@0.1.1"]
+      "args": ["-y", "@levinariy.fedorov/youtrack-mcp@0.2.0"]
     }
   }
 }
@@ -28,7 +28,9 @@ MCP-сервер прямо в продукте, и если он у вас ес
 ## Вход
 
 Токен — постоянный токен YouTrack из профиля пользователя. Принимается только
-потоком: в аргументе он осел бы в истории оболочки и был бы виден в списке процессов.
+потоком: в аргументе он осел бы в истории оболочки и был бы виден в списке
+процессов. Флаг `--token-stdin` нужен лишь в живом терминале, где команда иначе
+молча ждала бы ввод; при передаче через конвейер он не обязателен.
 
 ```powershell
 "<токен>" | npx @levinariy.fedorov/youtrack-mcp login --base-url https://youtrack.example.com --token-stdin
@@ -50,6 +52,10 @@ npx @levinariy.fedorov/youtrack-mcp profiles
 | --- | --- |
 | `read_issue` | Задача целиком: поля, комментарии, вложения, связи — одним вызовом |
 | `search_issues` | Поиск запросом YouTrack; только идентификатор, тема и поля |
+| `add_comment` | Комментарий: заказчику или ограниченного круга |
+| `update_issue` | Поля, статус, тема, описание |
+| `create_issue` | Новая задача в проекте |
+| `log_work` | Списание времени |
 | `whoami` | Учётная запись, от имени которой идут вызовы |
 
 Ответы структурированные: у каждого инструмента объявлен `outputSchema`, и
@@ -65,6 +71,27 @@ npx @levinariy.fedorov/youtrack-mcp profiles
 Пустые поля не отдаются: «поля нет» и «поле не заполнено» для читающего одно и то
 же, а два десятка пустых строк в каждом ответе — потраченный впустую контекст.
 
+### Запись
+
+`add_comment` без `visibleTo` публикует комментарий, видимый всем, кто видит задачу, —
+включая заказчика; отозвать его нельзя. `visibleTo` ограничивает круг: `group:Название`
+или логин. Своего понятия «внутренний» здесь нет: в одной инсталляции это группа
+сотрудников, в другой — конкретные люди, и угадывать за вас значило бы иногда
+показать заказчику написанное не ему.
+
+`update_issue` принимает поля по их именам в YouTrack. Тип значения выводится из
+самой задачи: пользователь задаётся логином, справочник — значением, дата — как
+`2026-09-30`, период — как `2h`. Статус, если он машина состояний, переводится
+командой, а не присваиванием: присвоенное значение YouTrack молча игнорирует, и
+задача осталась бы в прежнем состоянии при успешном на вид ответе. Недопустимый
+переход возвращает ошибку со списком доступных из текущего состояния, а не
+«Недопустимое значение».
+
+Возвращается задача целиком после изменения — workflow мог поправить соседние поля.
+
+Сообщения YouTrack приходят с кириллицей, экранированной числовыми ссылками HTML;
+здесь они раскодированы, иначе ошибка выглядела бы набором `&#1054;`.
+
 Инструментов чтения конфигурации нет и не будет: токен не должен попадать в
 контекст модели.
 
@@ -89,6 +116,16 @@ npm run typecheck
 Собранный `dist` в репозитории не хранится: его делает `prepare` — при публикации
 и при установке пакета из git.
 
+## Выпуск версии
+
+Публикует GitLab CI по тегу: поднимите версию в `package.json`, закоммитьте,
+повесьте тег `vX.Y.Z` и запушьте его. Пайплайн сверит тег с версией, прогонит
+проверки и опубликует пакет. Пуш в ветку ничего не публикует.
+
+Токен для публикации лежит в переменной `NPM_TOKEN`: это granular access token
+npm с правом publish и разрешённым обходом двухфакторки — ввести одноразовый код
+в пайплайне некому.
+
 ## Лицензия
 
 MIT.

package/dist/bin.js

@@ -14,7 +14,7 @@ const USAGE = `youtrack-mcp — MCP-сервер для YouTrack.
 
 Ключи login:
   --base-url <URL>    адрес YouTrack
-  --token-stdin       прочитать токен из stdin
+  --token-stdin       ждать токен из stdin в интерактивном терминале
   --profile <имя>     профиль (по умолчанию default)
   --set-default       сделать профиль основным
 `;
@@ -38,18 +38,34 @@ async function login(argv) {
     if (!baseUrl)
         throw new AuthError("Нужен --base-url: адрес YouTrack.");
     // Токен принимаем только потоком: в аргументе он осядет в истории оболочки и
-    // будет виден в списке процессов.
-    if (!values["token-stdin"])
-        throw new AuthError("Токен передаётся через --token-stdin, аргументом — никогда.");
+    // будет виден в списке процессов. Требовать при этом ещё и --token-stdin
+    // незачем — другого способа всё равно нет. Флаг остаётся ради явности, но
+    // сам по себе решает только одно: ждать ли ввода в живом терминале, где
+    // молчаливое ожидание выглядит зависанием.
+    if (process.stdin.isTTY && !values["token-stdin"]) {
+        throw new AuthError("Токен передаётся потоком. Либо направьте его в stdin, либо добавьте --token-stdin и введите вручную.");
+    }
     const token = await readStdin();
     if (token === "")
-        throw new AuthError("Пустой токен.");
+        throw new AuthError("Пустой токен: в stdin ничего не пришло.");
+    // Токен уходит в заголовок HTTP, а туда пролезают только однобайтовые символы.
+    // Без этой проверки кириллица в токене роняет запрос сообщением про ByteString,
+    // по которому не догадаться, что дело в самом токене.
+    if (!/^[\x21-\x7e]+$/.test(token)) {
+        throw new AuthError("Токен содержит недопустимые символы: постоянный токен YouTrack состоит из латиницы, цифр и знаков препинания.");
+    }
+    // Сначала проверяем, потом сохраняем: профиль с негодным токеном в файле хуже,
+    // чем его отсутствие — он выглядит настроенным и ломается позже и не там.
     const profile = values.profile ?? "default";
+    const user = await me(new YouTrackClient({ baseUrl: baseUrl.replace(/\/+$/, ""), token }));
+    // Негодный токен YouTrack не отвергает: он отвечает от лица гостя, и логин
+    // выглядит удавшимся ровно до первой попытки что-нибудь записать.
+    if (user.guest) {
+        throw new AuthError("YouTrack не принял токен: ответ пришёл от гостевой учётной записи. Проверьте, что токен скопирован целиком и не отозван.");
+    }
     await saveProfile(profile, { baseUrl, token });
     if (values["set-default"])
         await setDefaultProfile(profile);
-    const { credentials } = await resolveCredentials(profile);
-    const user = await me(new YouTrackClient(credentials));
     process.stdout.write(`Профиль «${profile}» сохранён: ${user.name} (${user.login}) на ${baseUrl}\n`);
 }
 async function status() {

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

@@ -61,4 +61,5 @@ export type Found = {
 export declare function searchIssues(client: YouTrackClient, query: string, limit?: number): Promise<Found[]>;
 export declare function me(client: YouTrackClient): Promise<Person & {
     email: string;
+    guest: boolean;
 }>;

package/dist/issues.js

@@ -139,6 +139,10 @@ export async function searchIssues(client, query, limit = 50) {
     });
 }
 export async function me(client) {
-    const raw = await client.get("/api/users/me", { fields: "login,fullName,email" });
-    return { ...person(raw), email: raw.email ?? "" };
+    // Поле guest спрашивается не из любопытства: с негодным токеном YouTrack не
+    // отвечает ошибкой, а представляется гостем — и вызов выглядит удавшимся.
+    const raw = await client.get("/api/users/me", {
+        fields: "login,fullName,email,guest"
+    });
+    return { ...person(raw), email: raw.email ?? "", guest: raw.guest === true };
 }

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";
 /**
  * Клиенты живут по имени профиля: конфигурацию незачем перечитывать на каждый
  * вызов, а профилей всё равно единицы.
@@ -89,11 +90,103 @@ 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 на себя.",
+        description: "Учётная запись, от имени которой идут вызовы. Нужна там, где скилл ставит Assignee на себя. " +
+            "`guest: true` означает, что токен не принят и YouTrack отвечает анонимно: писать от такого имени нельзя.",
         inputSchema: { profile: profileArg },
-        outputSchema: { login: z.string(), name: z.string(), email: z.string() },
+        outputSchema: { login: z.string(), name: z.string(), email: z.string(), guest: z.boolean() },
         annotations: { readOnlyHint: true, openWorldHint: true }
     }, async ({ profile }) => {
         const user = await me(await clientFor(profile));

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.1",
+	"version": "0.2.1",
 	"type": "module",
-	"description": "MCP-сервер и библиотека для YouTrack: задача целиком одним вызовом — поля, комментарии, вложения, связи.",
+	"description": "MCP-сервер и библиотека для YouTrack: чтение задачи целиком, комментарии, поля и статусы, списание времени.",
 	"keywords": [
 		"mcp",
 		"model-context-protocol",