@levinariy.fedorov/youtrack-mcp 0.2.0 → 0.2.1

package/README.md

@@ -28,7 +28,9 @@ MCP-сервер прямо в продукте, и если он у вас ес
 ## Вход
 
 Токен — постоянный токен YouTrack из профиля пользователя. Принимается только
-потоком: в аргументе он осел бы в истории оболочки и был бы виден в списке процессов.
+потоком: в аргументе он осел бы в истории оболочки и был бы виден в списке
+процессов. Флаг `--token-stdin` нужен лишь в живом терминале, где команда иначе
+молча ждала бы ввод; при передаче через конвейер он не обязателен.
 
 ```powershell
 "<токен>" | npx @levinariy.fedorov/youtrack-mcp login --base-url https://youtrack.example.com --token-stdin
@@ -114,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/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

@@ -183,9 +183,10 @@ export function createServer() {
     });
     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/package.json

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