bluntjira 0.1.0 → 0.2.0

package/README.md

@@ -23,12 +23,12 @@ bluntjira подключает Jira к AI-приложению через MCP.
 Открой терминал и выполни:
 
 ```bash
-npx -y bluntjira@0.1.0 login
+npx -y bluntjira@0.2.0 login
 ```
 
 Введи адрес Jira, логин и пароль. Используй полный HTTPS-адрес, например `https://jira.example.com` или `https://jira.example.com/jira`. При вводе пароля символы не отображаются.
 
-Пароль не сохраняется. Данные сессии останутся на компьютере, чтобы не входить заново при каждом запуске.
+Логин и пароль сохраняются на компьютере в открытом виде, сервер входит в Jira автоматически и сам обновляет сессию, когда она истекает.
 
 ### 2. Добавь сервер в AI-приложение
 
@@ -39,13 +39,13 @@ npx -y bluntjira@0.1.0 login
   "mcpServers": {
     "bluntjira": {
       "command": "npx",
-      "args": ["-y", "bluntjira@0.1.0"]
+      "args": ["-y", "bluntjira@0.2.0"]
     }
   }
 }
 ```
 
-Расположение настроек зависит от приложения. Если оно предлагает отдельные поля вместо JSON, укажи `npx` в поле команды, а `-y` и `bluntjira@0.1.0` в аргументах.
+Расположение настроек зависит от приложения. Если оно предлагает отдельные поля вместо JSON, укажи `npx` в поле команды, а `-y` и `bluntjira@0.2.0` в аргументах.
 
 Перезапусти приложение или переподключи сервер в настройках MCP.
 
@@ -64,7 +64,7 @@ npx -y bluntjira@0.1.0 login
 
 Помощник может изменять реальные задачи от твоего имени. Включи подтверждение действий в настройках AI-приложения, если оно это поддерживает. Если создание задачи или отправка комментария завершились ошибкой, проверь Jira перед повтором: действие могло успеть выполниться.
 
-Данные сессии хранятся в `~/.bluntjira/settings.json` и дают доступ к Jira. Не передавай этот файл другим и не добавляй его в Git.
+Логин и пароль хранятся в `~/.bluntjira/settings.json` (права 600) открытым текстом и дают доступ к Jira. Не передавай этот файл другим и не добавляй его в Git.
 
 ## Если не работает
 
@@ -72,11 +72,11 @@ npx -y bluntjira@0.1.0 login
 |---|---|
 | Команда `npx` не найдена | Установи Node.js 24+ с npm и перезапусти терминал и AI-приложение |
 | Не удаётся войти | Проверь адрес, логин, пароль и подключение к корпоративной сети. При CAPTCHA сначала войди в Jira через браузер. Вход только через SSO не поддерживается |
-| Сессия истекла | Снова выполни `npx -y bluntjira@0.1.0 login`, затем переподключи сервер в AI-приложении |
+| Ошибка входа (401) | Пароль изменился: снова выполни `npx -y bluntjira@0.2.0 login`, затем переподключи сервер в AI-приложении |
 | Нет доступа к проекту или задаче | Проверь, доступны ли они твоей учётной записи в самой Jira |
 | После ошибки доступа запросы приостановлены | Проверь вход, права и CAPTCHA. Пауза длится пять минут |
 
-Если проблема остаётся, создай [issue](https://github.com/danillittle/bluntjira/issues). Укажи версию Node.js, AI-приложение и текст ошибки. Не прикладывай пароль или данные сессии.
+Если проблема остаётся, создай [issue](https://github.com/danillittle/bluntjira/issues). Укажи версию Node.js, AI-приложение и текст ошибки. Не прикладывай пароль или содержимое settings.json.
 
 ## Для разработчиков
 

package/dist/index.js

@@ -1,16 +1,17 @@
 #!/usr/bin/env node
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { JiraClient, loadJiraConfig } from "./jira-client.js";
+import { JiraClient, loadJiraCredentials } from "./jira-client.js";
 import { registerTools } from "./tools.js";
-import { LoginError, runLogin } from "./login.js";
+import { authenticateSession, LoginError, runLogin } from "./login.js";
 import { readSettings, SettingsError } from "./settings.js";
 // Source: https://github.com/modelcontextprotocol/typescript-sdk/blob/v1.x/docs/server.md#stdio
 async function main() {
     const settings = await readSettings();
-    const config = loadJiraConfig(settings);
-    const server = new McpServer({ name: "bluntjira", version: "0.1.0" });
-    const jira = new JiraClient(config);
+    const credentials = loadJiraCredentials(settings);
+    const authenticate = () => authenticateSession(credentials.url, credentials.username, credentials.password);
+    const server = new McpServer({ name: "bluntjira", version: "0.2.0" });
+    const jira = new JiraClient({ url: credentials.url }, { reauth: authenticate });
     registerTools(server, jira);
     let stopping = false;
     async function shutdown() {
@@ -53,7 +54,7 @@ if (process.argv[2] === "login") {
 }
 else {
     main().catch((error) => {
-        const message = error instanceof SettingsError || (error instanceof Error && error.message.startsWith("Invalid Jira settings:"))
+        const message = error instanceof SettingsError || error instanceof LoginError || (error instanceof Error && error.message.startsWith("Invalid Jira settings:"))
             ? error.message
             : "Unable to start bluntjira";
         process.stderr.write(`${message}\n`);

package/dist/jira-client.js

@@ -1,6 +1,6 @@
 import { setTimeout as delay } from "node:timers/promises";
 import { z } from "zod";
-import { sessionCookieSchema } from "./cookie.js";
+import { LoginError } from "./login.js";
 const nonEmptyString = z.string().refine((value) => value.trim().length > 0);
 // URL parsing normalizes the path; keep Jira's context path when appending REST paths.
 // Source: https://zod.dev/api#refine
@@ -19,8 +19,8 @@ const jiraUrl = nonEmptyString.refine((value) => {
 }).transform((value) => new URL(value).href.replace(/\/+$/, ""));
 const settingsSchema = z.object({
     JIRA_URL: jiraUrl,
-    JIRA_COOKIE_NAME: sessionCookieSchema.shape.name,
-    JIRA_COOKIE_VALUE: sessionCookieSchema.shape.value,
+    JIRA_USERNAME: nonEmptyString,
+    JIRA_PASSWORD: z.string().min(1),
 });
 const retryableStatuses = new Set([429, 502, 503, 504]);
 const authCooldownMs = 5 * 60_000;
@@ -42,7 +42,13 @@ export class JiraClient {
     #config;
     #fetch;
     #timeoutMs;
-    #cookie;
+    #cookie = "";
+    #cookieValue = "";
+    // Shared so concurrent expired requests trigger a single login.
+    #loginInFlight;
+    // Jira refused the credentials: stop retrying until restart to avoid CAPTCHA lockouts.
+    #loginRejected = false;
+    #reauth;
     #activeRequests = new Set();
     #closed = false;
     #now;
@@ -55,7 +61,11 @@ export class JiraClient {
         this.#timeoutMs = options.timeoutMs ?? 30_000;
         this.#now = options.now ?? Date.now;
         this.#wait = options.wait ?? ((ms, signal) => delay(ms, undefined, { signal }));
-        this.#cookie = `${config.cookieName}=${config.cookieValue}`;
+        if (config.cookieName && config.cookieValue) {
+            this.#cookie = `${config.cookieName}=${config.cookieValue}`;
+            this.#cookieValue = config.cookieValue;
+        }
+        this.#reauth = options.reauth;
     }
     close() {
         this.#closed = true;
@@ -103,7 +113,7 @@ export class JiraClient {
         // Redact before truncating: a partial credential must not survive the limit.
         const secrets = [
             this.#cookie,
-            this.#config.cookieValue,
+            this.#cookieValue,
         ].filter(Boolean).sort((a, b) => b.length - a.length);
         for (const secret of secrets) {
             value = value.replaceAll(secret, "[REDACTED]");
@@ -145,6 +155,34 @@ export class JiraClient {
             throw new JiraRequestError(`Jira requests paused for ${Math.ceil(remaining / 1000)} seconds after HTTP ${this.#authStatus}. Check credentials, permissions and CAPTCHA; no HTTP request was sent.`, "cooldown", this.#authStatus);
         }
     }
+    async #login(signal) {
+        signal.throwIfAborted();
+        if (this.#loginRejected || !this.#reauth) {
+            throw new JiraRequestError("Jira rejected the stored credentials. Run `bluntjira login` and restart the MCP server.", "http", 401);
+        }
+        const reauth = this.#reauth;
+        this.#loginInFlight ??= reauth().then((session) => {
+            this.#cookie = `${session.cookieName}=${session.cookieValue}`;
+            this.#cookieValue = session.cookieValue;
+        }).catch((error) => {
+            if (error instanceof LoginError && error.rejected)
+                this.#loginRejected = true;
+            throw error;
+        }).finally(() => { this.#loginInFlight = undefined; });
+        // shortcut: an aborted request stops waiting but the shared login runs on (<=30s), upgrade if that matters.
+        const aborted = new Promise((_resolve, reject) => {
+            signal.addEventListener("abort", () => reject(signal.reason), { once: true });
+        });
+        try {
+            await Promise.race([this.#loginInFlight, aborted]);
+        }
+        catch (error) {
+            if (signal.aborted)
+                throw error;
+            // "cooldown" kind: the request was never sent, so it must not be reported as an unknown write outcome.
+            throw new JiraRequestError(`Jira login failed: ${error instanceof LoginError ? error.message : "unknown error"}. Run \`bluntjira login\` if the credentials changed.`, "cooldown", error instanceof LoginError && error.rejected ? 401 : undefined);
+        }
+    }
     #retryDelay(attempt, response) {
         const backoff = 1000 * 2 ** attempt + Math.floor(Math.random() * 251);
         const value = response.headers.get("Retry-After");
@@ -159,21 +197,31 @@ export class JiraClient {
         this.#activeRequests.add(controller);
         const deadline = this.#now() + this.#timeoutMs;
         const timeout = setTimeout(() => controller.abort(), this.#timeoutMs);
+        let reauthenticated = false;
         try {
-            for (let attempt = 0;; attempt++) {
+            for (let attempt = 0;;) {
                 this.#assertAvailable();
                 controller.signal.throwIfAborted();
+                if (!this.#cookie && this.#reauth)
+                    await this.#login(controller.signal);
                 const response = await this.#fetch(`${this.#config.url}/rest/api/2${path}`, {
                     method: options.method ?? "GET",
                     headers: {
                         Accept: "application/json",
-                        Cookie: this.#cookie,
+                        ...(this.#cookie ? { Cookie: this.#cookie } : {}),
                         ...(options.body === undefined ? {} : { "Content-Type": "application/json" }),
                     },
                     ...(options.body === undefined ? {} : { body: JSON.stringify(options.body) }),
                     redirect: "manual",
                     signal: controller.signal,
                 });
+                // Renew an expired session once per request; 401 means nothing was executed, so retrying is safe even for writes.
+                if (response.status === 401 && this.#reauth && !reauthenticated && !this.#loginRejected) {
+                    reauthenticated = true;
+                    void response.body?.cancel().catch(() => { });
+                    await this.#login(controller.signal);
+                    continue;
+                }
                 // Pause immediately on headers, even if reading the error body later fails.
                 if (response.status === 401 || response.status === 403) {
                     this.#authStatus = response.status;
@@ -190,6 +238,7 @@ export class JiraClient {
                     if (options.write || !retryableStatuses.has(response.status) || attempt >= 2)
                         throw failure;
                     const waitMs = this.#retryDelay(attempt, response);
+                    attempt++;
                     // Never retry earlier than Retry-After to fit our time budget.
                     if (waitMs >= deadline - this.#now())
                         throw failure;
@@ -226,7 +275,7 @@ export class JiraClient {
     }
 }
 /** Validate stored Jira settings; never include their values in errors. */
-export function loadJiraConfig(settings) {
+export function loadJiraCredentials(settings) {
     const result = settingsSchema.safeParse(settings);
     if (!result.success) {
         // Raw Zod issues can include input values. Expose only known setting names.
@@ -235,7 +284,7 @@ export function loadJiraConfig(settings) {
     }
     return {
         url: result.data.JIRA_URL,
-        cookieName: result.data.JIRA_COOKIE_NAME,
-        cookieValue: result.data.JIRA_COOKIE_VALUE,
+        username: result.data.JIRA_USERNAME,
+        password: result.data.JIRA_PASSWORD,
     };
 }

package/dist/login.js

@@ -7,12 +7,18 @@ import { StringDecoder } from "node:string_decoder";
 import { sessionCookieSchema } from "./cookie.js";
 // Only messages constructed by login itself are safe to print in the CLI.
 export class LoginError extends Error {
+    rejected;
+    // True when Jira refused the credentials themselves (not a network or format problem).
+    constructor(message, rejected = false) {
+        super(message);
+        this.rejected = rejected;
+    }
 }
-export function serializeSession(session) {
+export function serializeCredentials(credentials) {
     return `${JSON.stringify({
-        JIRA_URL: session.url,
-        JIRA_COOKIE_NAME: session.cookieName,
-        JIRA_COOKIE_VALUE: session.cookieValue,
+        JIRA_URL: credentials.url,
+        JIRA_USERNAME: credentials.username,
+        JIRA_PASSWORD: credentials.password,
     }, null, 2)}\n`;
 }
 export async function authenticateSession(url, user, password, fetcher = globalThis.fetch) {
@@ -40,7 +46,7 @@ export async function authenticateSession(url, user, password, fetcher = globalT
         });
         if (!response.ok) {
             void response.body?.cancel().catch(() => { });
-            throw new LoginError(`Jira login failed (HTTP ${response.status})`);
+            throw new LoginError(`Jira login failed (HTTP ${response.status})`, response.status === 401 || response.status === 403);
         }
         let payload;
         try {
@@ -70,11 +76,11 @@ export async function authenticateSession(url, user, password, fetcher = globalT
         clearTimeout(timeout);
     }
 }
-export async function saveSession(session, filePath = path.join(homedir(), ".bluntjira", "settings.json")) {
+export async function saveCredentials(credentials, filePath = path.join(homedir(), ".bluntjira", "settings.json")) {
     const directory = path.dirname(filePath);
     await mkdir(directory, { recursive: true, mode: 0o700 });
     await chmod(directory, 0o700);
-    await writeFile(filePath, serializeSession(session), { mode: 0o600 });
+    await writeFile(filePath, serializeCredentials(credentials), { mode: 0o600 });
     await chmod(filePath, 0o600);
 }
 export async function readHidden(prompt, input = stdin, output = stdout) {
@@ -124,8 +130,9 @@ export async function runLogin() {
         if (!url || !user || !password)
             throw new LoginError("Jira URL, username, and password are required");
         const session = await authenticateSession(url, user, password);
-        await saveSession(session);
-        stdout.write(`Jira session saved to ${path.join(homedir(), ".bluntjira", "settings.json")} (permissions 600). Run login again after the session expires.\n`);
+        // Login is verified first so a typo never overwrites working settings.
+        await saveCredentials({ url: session.url, username: user, password });
+        stdout.write(`Jira credentials saved to ${path.join(homedir(), ".bluntjira", "settings.json")} (permissions 600). The server logs in automatically.\n`);
     }
     finally {
         terminal.close();

package/dist/settings.js

@@ -31,7 +31,7 @@ export async function readSettings(filePath = settingsPath()) {
     const settings = parsed;
     return {
         ...(typeof settings.JIRA_URL === "string" ? { JIRA_URL: settings.JIRA_URL } : {}),
-        ...(typeof settings.JIRA_COOKIE_NAME === "string" ? { JIRA_COOKIE_NAME: settings.JIRA_COOKIE_NAME } : {}),
-        ...(typeof settings.JIRA_COOKIE_VALUE === "string" ? { JIRA_COOKIE_VALUE: settings.JIRA_COOKIE_VALUE } : {}),
+        ...(typeof settings.JIRA_USERNAME === "string" ? { JIRA_USERNAME: settings.JIRA_USERNAME } : {}),
+        ...(typeof settings.JIRA_PASSWORD === "string" ? { JIRA_PASSWORD: settings.JIRA_PASSWORD } : {}),
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bluntjira",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Jira REST API v2 MCP server over stdio",
   "type": "module",
   "license": "MIT",