@vitalyostanin/youtrack-mcp 0.13.1 → 0.13.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Vitaly Ostanin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.js

@@ -1,13 +1,42 @@
 #!/usr/bin/env node
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { YoutrackServer } from "./src/server.js";
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { YoutrackServer } from './src/server.js';
+function readManifest() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        resolve(here, 'package.json'),
+        resolve(here, '..', 'package.json'),
+    ];
+    for (const path of candidates) {
+        try {
+            const raw = readFileSync(path, 'utf8');
+            return JSON.parse(raw);
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    return { name: '@vitalyostanin/youtrack-mcp', version: 'unknown' };
+}
+function maybePrintVersionAndExit() {
+    const argv = process.argv.slice(2);
+    if (argv.includes('--version') || argv.includes('-v')) {
+        const manifest = readManifest();
+        console.log(`${manifest.name} ${manifest.version}`);
+        process.exit(0);
+    }
+}
 async function main() {
+    maybePrintVersionAndExit();
     const transport = new StdioServerTransport();
     const server = new YoutrackServer();
     await server.connect(transport);
 }
 main().catch((error) => {
-    console.error("YouTrack MCP server crashed", error);
+    console.error('YouTrack MCP server crashed', error);
     process.exit(1);
 });
 //# sourceMappingURL=index.js.map

package/dist/package.json

@@ -1,81 +1,82 @@
 {
-    "name": "@vitalyostanin/youtrack-mcp",
-    "version": "0.13.1",
-    "scripts": {
-        "build": "tsc -p tsconfig.json",
-        "postbuild": "chmod +x dist/index.js",
-        "dev": "tsc -p tsconfig.json --watch",
-        "start": "node dist/index.js",
-        "dev:watch": "tsc -p tsconfig.json --watch",
-        "lint": "eslint . --cache --cache-location node_modules/.cache/eslint/",
-        "lint:fix": "eslint . --fix --cache --cache-location node_modules/.cache/eslint/",
-        "format": "eslint . --fix --cache --cache-location node_modules/.cache/eslint/",
-        "typecheck": "tsc -p tsconfig.json --noEmit",
-        "test": "vitest run",
-        "test:watch": "vitest",
-        "test:coverage": "vitest run --coverage",
-        "prepublishOnly": "npm run lint && npm test && npm run build"
-    },
-    "keywords": [
-        "mcp",
-        "model-context-protocol",
-        "youtrack",
-        "jetbrains",
-        "issue-tracking",
-        "work-items",
-        "time-tracking",
-        "claude"
-    ],
-    "author": "Vitaly Ostanin <vitaly.ostanin@mail.ru>",
-    "license": "MIT",
-    "description": "MCP server for comprehensive YouTrack integration: issues, work items with reports, user activity search, knowledge base, projects and users",
-    "type": "module",
-    "engines": {
-        "node": ">=22.13.0"
-    },
-    "bin": {
-        "youtrack-mcp": "dist/index.js"
-    },
-    "homepage": "https://github.com/VitalyOstanin/youtrack-mcp#readme",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/VitalyOstanin/youtrack-mcp.git"
-    },
-    "bugs": {
-        "url": "https://github.com/VitalyOstanin/youtrack-mcp/issues"
-    },
-    "files": [
-        "dist/**/*.js",
-        "dist/**/*.d.ts",
-        "dist/**/*.json",
-        "README.md",
-        "README-ru.md"
-    ],
-    "publishConfig": {
-        "access": "public"
-    },
-    "overrides": {
-        "ip-address": "^10.2.0"
-    },
-    "dependencies": {
-        "@modelcontextprotocol/sdk": "^1.29.0",
-        "@vitalyostanin/mutex-pool": "^0.0.3",
-        "axios": "^1.16.0",
-        "form-data": "^4.0.1",
-        "luxon": "^3.5.0",
-        "stream-json": "^2.1.0",
-        "zod": "^4.4.3"
-    },
-    "devDependencies": {
-        "@eslint/js": "^10.0.1",
-        "@types/luxon": "^3.7.1",
-        "@types/node": "^25.6.0",
-        "@vitest/coverage-v8": "^4.1.5",
-        "eslint": "^10.3.0",
-        "nock": "^14.0.14",
-        "typescript": "^6.0.3",
-        "typescript-eslint": "^8.59.2",
-        "vitest": "^4.1.5",
-        "zod-to-json-schema": "^3.25.2"
-    }
+  "name": "@vitalyostanin/youtrack-mcp",
+  "version": "0.13.2",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "postbuild": "chmod +x dist/index.js && cp package.json dist/package.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "start": "node dist/index.js",
+    "typecheck": "tsc -p tsconfig.json",
+    "lint": "eslint . --cache --cache-location node_modules/.cache/eslint/",
+    "lint:fix": "eslint . --fix --cache --cache-location node_modules/.cache/eslint/",
+    "format": "npm run --silent lint:fix",
+    "test": "timeout 600 vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "timeout 600 vitest run --coverage",
+    "prepublishOnly": "npm run lint && npm run typecheck && npm run test && npm audit --omit=dev --audit-level=high && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "youtrack",
+    "jetbrains",
+    "issue-tracking",
+    "work-items",
+    "time-tracking",
+    "claude"
+  ],
+  "author": "Vitaly Ostanin <vitaly.ostanin@mail.ru>",
+  "license": "MIT",
+  "description": "MCP server for comprehensive YouTrack integration: issues, work items with reports, user activity search, knowledge base, projects and users",
+  "type": "module",
+  "engines": {
+    "node": ">=22.13.0",
+    "npm": ">=10.0.0"
+  },
+  "packageManager": "npm@11.12.1",
+  "bin": {
+    "youtrack-mcp": "dist/index.js"
+  },
+  "homepage": "https://github.com/VitalyOstanin/youtrack-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/VitalyOstanin/youtrack-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/VitalyOstanin/youtrack-mcp/issues"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "dist/**/*.json",
+    "README.md",
+    "README-ru.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "overrides": {
+    "ip-address": "^10.2.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@vitalyostanin/mutex-pool": "^0.0.3",
+    "axios": "^1.16.0",
+    "form-data": "^4.0.1",
+    "luxon": "^3.5.0",
+    "stream-json": "^2.1.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/luxon": "^3.7.1",
+    "@types/node": "^25.6.0",
+    "@vitest/coverage-v8": "^4.1.5",
+    "eslint": "^10.3.0",
+    "nock": "^14.0.14",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.59.2",
+    "vitest": "^4.1.5"
+  }
 }

package/package.json

@@ -1,20 +1,19 @@
 {
   "name": "@vitalyostanin/youtrack-mcp",
-  "version": "0.13.1",
+  "version": "0.13.2",
   "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "postbuild": "chmod +x dist/index.js",
-    "dev": "tsc -p tsconfig.json --watch",
+    "build": "tsc -p tsconfig.build.json",
+    "postbuild": "chmod +x dist/index.js && cp package.json dist/package.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
     "start": "node dist/index.js",
-    "dev:watch": "tsc -p tsconfig.json --watch",
+    "typecheck": "tsc -p tsconfig.json",
     "lint": "eslint . --cache --cache-location node_modules/.cache/eslint/",
     "lint:fix": "eslint . --fix --cache --cache-location node_modules/.cache/eslint/",
-    "format": "eslint . --fix --cache --cache-location node_modules/.cache/eslint/",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run",
+    "format": "npm run --silent lint:fix",
+    "test": "timeout 600 vitest run",
     "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "prepublishOnly": "npm run lint && npm test && npm run build"
+    "test:coverage": "timeout 600 vitest run --coverage",
+    "prepublishOnly": "npm run lint && npm run typecheck && npm run test && npm audit --omit=dev --audit-level=high && npm run build"
   },
   "keywords": [
     "mcp",
@@ -31,8 +30,10 @@
   "description": "MCP server for comprehensive YouTrack integration: issues, work items with reports, user activity search, knowledge base, projects and users",
   "type": "module",
   "engines": {
-    "node": ">=22.13.0"
+    "node": ">=22.13.0",
+    "npm": ">=10.0.0"
   },
+  "packageManager": "npm@11.12.1",
   "bin": {
     "youtrack-mcp": "dist/index.js"
   },
@@ -49,7 +50,8 @@
     "dist/**/*.d.ts",
     "dist/**/*.json",
     "README.md",
-    "README-ru.md"
+    "README-ru.md",
+    "LICENSE"
   ],
   "publishConfig": {
     "access": "public"
@@ -75,7 +77,6 @@
     "nock": "^14.0.14",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.59.2",
-    "vitest": "^4.1.5",
-    "zod-to-json-schema": "^3.25.2"
+    "vitest": "^4.1.5"
   }
 }

package/dist/src/__tests__/config.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=config.test.d.ts.map

package/dist/src/__tests__/config.test.js

@@ -1,47 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import { mkdtempSync, rmSync, existsSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join, resolve } from "node:path";
-import { loadConfig, enrichConfigWithRedaction } from "../config.js";
-describe("loadConfig", () => {
-    let tmp;
-    const oldEnv = { ...process.env };
-    beforeEach(() => {
-        tmp = mkdtempSync(join(tmpdir(), "yt-cfg-"));
-        process.env = {
-            YOUTRACK_URL: "https://yt.example.com",
-            YOUTRACK_TOKEN: "perm:test-token",
-        };
-    });
-    afterEach(() => {
-        rmSync(tmp, { recursive: true, force: true });
-        process.env = { ...oldEnv };
-    });
-    it("uses cwd by default for outputDir", () => {
-        const cfg = loadConfig();
-        expect(cfg.outputDir).toBe(resolve(process.cwd()));
-    });
-    it("honors YOUTRACK_OUTPUT_DIR", () => {
-        process.env.YOUTRACK_OUTPUT_DIR = tmp;
-        const cfg = loadConfig();
-        expect(cfg.outputDir).toBe(resolve(tmp));
-    });
-    it("creates outputDir if missing", () => {
-        const sub = join(tmp, "missing-subdir");
-        process.env.YOUTRACK_OUTPUT_DIR = sub;
-        loadConfig();
-        expect(existsSync(sub)).toBe(true);
-    });
-    it("throws when YOUTRACK_TOKEN is missing", () => {
-        delete process.env.YOUTRACK_TOKEN;
-        expect(() => loadConfig()).toThrow();
-    });
-    it("redacts token via enrichConfigWithRedaction", () => {
-        const cfg = loadConfig();
-        const redacted = enrichConfigWithRedaction(cfg);
-        expect(redacted.hasToken).toBe(true);
-        expect(redacted.token).toBeUndefined();
-        expect(redacted.outputDir).toBe(cfg.outputDir);
-    });
-});
-//# sourceMappingURL=config.test.js.map

package/dist/src/__tests__/setup.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=setup.d.ts.map

package/dist/src/__tests__/setup.js

@@ -1,12 +0,0 @@
-import { afterAll, afterEach, beforeAll } from "vitest";
-import nock from "nock";
-beforeAll(() => {
-    nock.disableNetConnect();
-});
-afterEach(() => {
-    nock.cleanAll();
-});
-afterAll(() => {
-    nock.enableNetConnect();
-});
-//# sourceMappingURL=setup.js.map

package/dist/src/__tests__/smoke.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=smoke.test.d.ts.map

package/dist/src/__tests__/smoke.test.js

@@ -1,7 +0,0 @@
-import { describe, it, expect } from "vitest";
-describe("smoke", () => {
-    it("vitest is wired", () => {
-        expect(1 + 1).toBe(2);
-    });
-});
-//# sourceMappingURL=smoke.test.js.map

package/dist/src/__tests__/youtrack-client.delete-link.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=youtrack-client.delete-link.test.d.ts.map

package/dist/src/__tests__/youtrack-client.delete-link.test.js

@@ -1,93 +0,0 @@
-import { describe, it, expect, vi } from "vitest";
-import { YoutrackClient } from "../youtrack-client.js";
-const config = {
-    baseUrl: "https://yt.test",
-    token: "perm:test",
-    defaultProject: "BC",
-    outputDir: "/tmp",
-    timezone: "UTC",
-};
-function getHttp(client) {
-    return client.http;
-}
-function methodNotAllowed() {
-    return {
-        isAxiosError: true,
-        message: "Request failed with status code 405",
-        response: { status: 405, data: { error: "method_not_allowed" } },
-    };
-}
-describe("deleteIssueLink subtask fallback", () => {
-    it("uses linkToDelete.issue.idReadable when targetId is missing", async () => {
-        const client = new YoutrackClient(config);
-        const http = getHttp(client);
-        vi.spyOn(http, "delete").mockRejectedValue(methodNotAllowed());
-        vi.spyOn(client, "getIssueLinks").mockResolvedValue({
-            issueId: "BC-1",
-            links: [
-                {
-                    id: "L1",
-                    direction: "OUTWARD",
-                    linkType: { name: "Subtask", id: "lt-sub" },
-                    issue: { idReadable: "BC-99", id: "1-99", summary: "s" },
-                },
-            ],
-        });
-        let captured;
-        vi.spyOn(http, "post").mockImplementation((...args) => {
-            captured = { url: String(args[0]), body: args[1] };
-            return Promise.resolve({ data: {} });
-        });
-        await client.deleteIssueLink({ issueId: "BC-1", linkId: "L1" });
-        expect(captured?.url).toBe("/api/commands");
-        expect(captured?.body.query).toBe("remove subtask of BC-99");
-        const issues = captured?.body.issues;
-        expect(issues[0].idReadable).toBe("BC-1");
-    });
-    it("uses provided targetId when given (regular link)", async () => {
-        const client = new YoutrackClient(config);
-        const http = getHttp(client);
-        vi.spyOn(http, "delete").mockRejectedValue(methodNotAllowed());
-        vi.spyOn(client, "getIssueLinks").mockResolvedValue({
-            issueId: "BC-1",
-            links: [
-                {
-                    id: "L1",
-                    direction: "OUTWARD",
-                    linkType: {
-                        name: "Relates",
-                        id: "lt-rel",
-                        outwardName: "relates to",
-                        inwardName: "relates to",
-                    },
-                    issue: { idReadable: "BC-99", id: "1-99", summary: "s" },
-                },
-            ],
-        });
-        let captured;
-        vi.spyOn(http, "post").mockImplementation((...args) => {
-            captured = { body: args[1] };
-            return Promise.resolve({ data: {} });
-        });
-        await client.deleteIssueLink({ issueId: "BC-1", linkId: "L1", targetId: "BC-7" });
-        expect(String(captured?.body.query)).toContain("BC-7");
-    });
-    it("throws when neither input.targetId nor link payload provide a target", async () => {
-        const client = new YoutrackClient(config);
-        const http = getHttp(client);
-        vi.spyOn(http, "delete").mockRejectedValue(methodNotAllowed());
-        vi.spyOn(client, "getIssueLinks").mockResolvedValue({
-            issueId: "BC-1",
-            links: [
-                {
-                    id: "L1",
-                    direction: "OUTWARD",
-                    linkType: { name: "Subtask", id: "lt-sub" },
-                    issue: { idReadable: "", id: "1-99", summary: "s" },
-                },
-            ],
-        });
-        await expect(client.deleteIssueLink({ issueId: "BC-1", linkId: "L1" })).rejects.toThrow(/Cannot determine target issue id/);
-    });
-});
-//# sourceMappingURL=youtrack-client.delete-link.test.js.map

package/dist/src/__tests__/youtrack-client.normalize-error.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=youtrack-client.normalize-error.test.d.ts.map

package/dist/src/__tests__/youtrack-client.normalize-error.test.js

@@ -1,71 +0,0 @@
-import { describe, it, expect, vi } from "vitest";
-import { YoutrackClient } from "../youtrack-client.js";
-const config = {
-    baseUrl: "https://yt.test",
-    token: "perm:test",
-    defaultProject: "BC",
-    outputDir: "/tmp",
-    timezone: "UTC",
-};
-function getHttp(client) {
-    return client.http;
-}
-function makeAxiosError(status, data) {
-    return {
-        isAxiosError: true,
-        message: `Request failed with status code ${status}`,
-        response: { status, data },
-    };
-}
-describe("normalizeError details whitelist", () => {
-    it("strips unknown keys (stack, pii) from response.data", async () => {
-        const client = new YoutrackClient(config);
-        vi.spyOn(getHttp(client), "get").mockRejectedValue(makeAxiosError(400, {
-            error: "bad_request",
-            error_description: "issue not found",
-            stack: "internal: org.youtrack...",
-            pii: "user@example.com",
-        }));
-        let captured;
-        try {
-            await client.getIssue("BC-1");
-            throw new Error("expected failure");
-        }
-        catch (err) {
-            captured = err;
-        }
-        expect(captured?.status).toBe(400);
-        expect(captured?.details).toEqual({
-            error: "bad_request",
-            error_description: "issue not found",
-        });
-        expect(captured?.details).not.toHaveProperty("stack");
-        expect(captured?.details).not.toHaveProperty("pii");
-    });
-    it("returns undefined details when nothing in the whitelist matches", async () => {
-        const client = new YoutrackClient(config);
-        vi.spyOn(getHttp(client), "get").mockRejectedValue(makeAxiosError(500, { stack: "x", trace: "y" }));
-        try {
-            await client.getIssue("BC-1");
-            throw new Error("expected failure");
-        }
-        catch (err) {
-            const e = err;
-            expect(e.status).toBe(500);
-            expect(e.details).toBeUndefined();
-        }
-    });
-    it("keeps numeric code and message strings", async () => {
-        const client = new YoutrackClient(config);
-        vi.spyOn(getHttp(client), "get").mockRejectedValue(makeAxiosError(403, { code: 403, message: "forbidden", debug: { ip: "1.2.3.4" } }));
-        try {
-            await client.getIssue("BC-1");
-            throw new Error("expected failure");
-        }
-        catch (err) {
-            const e = err;
-            expect(e.details).toEqual({ code: 403, message: "forbidden" });
-        }
-    });
-});
-//# sourceMappingURL=youtrack-client.normalize-error.test.js.map

package/dist/src/__tests__/youtrack-client.process-batch.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=youtrack-client.process-batch.test.d.ts.map

package/dist/src/__tests__/youtrack-client.process-batch.test.js

@@ -1,63 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { YoutrackClient } from "../youtrack-client.js";
-function asPrivate(c) {
-    return c;
-}
-const config = {
-    baseUrl: "https://yt.test",
-    token: "perm:test-token",
-    timezone: "UTC",
-    outputDir: "/tmp",
-};
-describe("processBatch", () => {
-    it("returns results in original order", async () => {
-        const c = asPrivate(new YoutrackClient(config));
-        const results = await c.processBatch([1, 2, 3], async (n) => n * 10);
-        expect(results).toEqual([10, 20, 30]);
-    });
-    it("respects concurrency limit", async () => {
-        const c = asPrivate(new YoutrackClient(config));
-        let inFlight = 0;
-        let maxInFlight = 0;
-        await c.processBatch(Array.from({ length: 12 }, (_, i) => i), async () => {
-            inFlight += 1;
-            maxInFlight = Math.max(maxInFlight, inFlight);
-            await new Promise((r) => setTimeout(r, 5));
-            inFlight -= 1;
-        }, 3);
-        expect(maxInFlight).toBeLessThanOrEqual(3);
-    });
-    it("rethrows a single error directly", async () => {
-        const c = asPrivate(new YoutrackClient(config));
-        const err = new Error("boom");
-        await expect(c.processBatch([1], async () => {
-            throw err;
-        })).rejects.toBe(err);
-    });
-    it("aggregates multiple errors into AggregateError", async () => {
-        const c = asPrivate(new YoutrackClient(config));
-        let i = 0;
-        let caught;
-        try {
-            await c.processBatch([1, 2, 3], async () => {
-                i += 1;
-                throw new Error(`fail ${i}`);
-            });
-        }
-        catch (e) {
-            caught = e;
-        }
-        expect(caught).toBeInstanceOf(AggregateError);
-        expect(caught.errors).toHaveLength(3);
-    });
-    it("does not return partial results when one job fails", async () => {
-        const c = asPrivate(new YoutrackClient(config));
-        await expect(c.processBatch([1, 2, 3], async (n) => {
-            if (n === 2) {
-                throw new Error("middle failure");
-            }
-            return n;
-        })).rejects.toThrow(/middle failure/);
-    });
-});
-//# sourceMappingURL=youtrack-client.process-batch.test.js.map

package/dist/src/__tests__/youtrack-client.read-pagination.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=youtrack-client.read-pagination.test.d.ts.map