backlog-mcp-server 0.18.0 → 0.19.0

package/build/tools/getVersionMilestoneList.d.ts

@@ -3,7 +3,7 @@ import type { Entity } from 'backlog-js';
 import { Backlog } from 'backlog-js';
 import { ToolDefinition } from '../types/tool.js';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
-declare const getVersionMilestoneListSchema: (t: DescriptionHelper["t"]) => {
+declare const getVersionMilestoneListSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
 };

package/build/tools/getWatchingListCount.d.ts

@@ -3,7 +3,7 @@ import type { Entity } from 'backlog-js';
 import { Backlog } from 'backlog-js';
 import { ToolDefinition } from '../types/tool.js';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
-declare const getWatchingListCountSchema: (t: DescriptionHelper["t"]) => {
+declare const getWatchingListCountSchema: (t: DescriptionHelper['t']) => {
     userId: z.ZodNumber;
 };
 export declare const getWatchingListCountTool: (backlog: Backlog, { t }: DescriptionHelper) => ToolDefinition<ReturnType<typeof getWatchingListCountSchema>, Entity.WatchingList.WatchingListCount>;

package/build/tools/getWatchingListItems.d.ts

@@ -3,7 +3,7 @@ import type { Entity } from 'backlog-js';
 import { Backlog } from 'backlog-js';
 import { ToolDefinition } from '../types/tool.js';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
-declare const getWatchingListItemsSchema: (t: DescriptionHelper["t"]) => {
+declare const getWatchingListItemsSchema: (t: DescriptionHelper['t']) => {
     userId: z.ZodNumber;
 };
 export declare const getWatchingListItemsTool: (backlog: Backlog, { t }: DescriptionHelper) => ToolDefinition<ReturnType<typeof getWatchingListItemsSchema>, Entity.WatchingList.WatchingListItem>;

package/build/tools/getWiki.d.ts

@@ -3,7 +3,7 @@ import type { Entity } from 'backlog-js';
 import { Backlog } from 'backlog-js';
 import { ToolDefinition } from '../types/tool.js';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
-declare const getWikiSchema: (t: DescriptionHelper["t"]) => {
+declare const getWikiSchema: (t: DescriptionHelper['t']) => {
     wikiId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
 };
 export declare const getWikiTool: (backlog: Backlog, { t }: DescriptionHelper) => ToolDefinition<ReturnType<typeof getWikiSchema>, Entity.Wiki.Wiki>;

package/build/tools/getWikiPages.d.ts

@@ -3,7 +3,7 @@ import type { Entity } from 'backlog-js';
 import { Backlog } from 'backlog-js';
 import { ToolDefinition } from '../types/tool.js';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
-declare const getWikiPagesSchema: (t: DescriptionHelper["t"]) => {
+declare const getWikiPagesSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
     keyword: z.ZodOptional<z.ZodString>;

package/build/tools/getWikisCount.d.ts

@@ -3,7 +3,7 @@ import type { Entity } from 'backlog-js';
 import { Backlog } from 'backlog-js';
 import { ToolDefinition } from '../types/tool.js';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
-declare const getWikisCountSchema: (t: DescriptionHelper["t"]) => {
+declare const getWikisCountSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
 };

package/build/tools/markNotificationAsRead.d.ts

@@ -7,7 +7,7 @@ type MarkNotificationAsReadResult = {
     message: string;
 };
 import { DescriptionHelper } from '../createDescriptionHelper.js';
-declare const markNotificationAsReadSchema: (t: DescriptionHelper["t"]) => {
+declare const markNotificationAsReadSchema: (t: DescriptionHelper['t']) => {
     id: z.ZodNumber;
 };
 export declare const MarkNotificationAsReadResultSchema: z.ZodObject<{

package/build/tools/markWatchingAsRead.d.ts

@@ -7,7 +7,7 @@ type MarkWatchingAsReadResult = {
     message: string;
 };
 import { DescriptionHelper } from '../createDescriptionHelper.js';
-declare const markWatchingAsReadSchema: (t: DescriptionHelper["t"]) => {
+declare const markWatchingAsReadSchema: (t: DescriptionHelper['t']) => {
     watchId: z.ZodNumber;
 };
 export declare const MarkWatchingAsReadResultSchema: z.ZodObject<{

package/build/tools/removeRelatedIssue.d.ts

@@ -3,7 +3,7 @@ import type { Entity } from 'backlog-js';
 import { Backlog } from 'backlog-js';
 import { ToolDefinition } from '../types/tool.js';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
-declare const removeRelatedIssueSchema: (t: DescriptionHelper["t"]) => {
+declare const removeRelatedIssueSchema: (t: DescriptionHelper['t']) => {
     issueId: z.ZodOptional<z.ZodNumber>;
     issueKey: z.ZodOptional<z.ZodString>;
     relatedIssueId: z.ZodNumber;

package/build/tools/resetUnreadNotificationCount.d.ts

@@ -2,6 +2,6 @@ import type { Entity } from 'backlog-js';
 import { Backlog } from 'backlog-js';
 import { ToolDefinition } from '../types/tool.js';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
-declare const resetUnreadNotificationCountSchema: (t: DescriptionHelper["t"]) => {};
+declare const resetUnreadNotificationCountSchema: (t: DescriptionHelper['t']) => {};
 export declare const resetUnreadNotificationCountTool: (backlog: Backlog, { t }: DescriptionHelper) => ToolDefinition<ReturnType<typeof resetUnreadNotificationCountSchema>, Entity.Notification.NotificationCount>;
 export {};

package/build/tools/shared/customFieldFiltersSchema.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { DescriptionHelper } from '../../createDescriptionHelper.js';
-export declare const buildCustomFieldFilterSchema: (t: DescriptionHelper["t"]) => z.ZodDiscriminatedUnion<[z.ZodObject<{
+export declare const buildCustomFieldFilterSchema: (t: DescriptionHelper['t']) => z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"text">;
     id: z.ZodNumber;
     value: z.ZodString;

package/build/tools/tools.js

@@ -13,6 +13,7 @@ import { getCustomFieldsTool } from './getCustomFields.js';
 import { getGitRepositoriesTool } from './getGitRepositories.js';
 import { getGitRepositoryTool } from './getGitRepository.js';
 import { getIssueTool } from './getIssue.js';
+import { getIssueAttachmentTool } from './getIssueAttachment.js';
 import { getIssueCommentsTool } from './getIssueComments.js';
 import { getIssuesTool } from './getIssues.js';
 import { getRelatedIssuesTool } from './getRelatedIssues.js';
@@ -93,6 +94,7 @@ export const allTools = (backlog, helper) => {
                 name: 'issue',
                 description: 'Tools for managing issues and their comments.',
                 enabled: false,
+                dynamicTools: [getIssueAttachmentTool(backlog, helper)],
                 tools: [
                     getIssueTool(backlog, helper),
                     getIssuesTool(backlog, helper),

package/build/tools/updateIssue.d.ts

@@ -3,7 +3,7 @@ import { Backlog } from 'backlog-js';
 import type { Entity } from 'backlog-js';
 import { ToolDefinition } from '../types/tool.js';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
-declare const updateIssueSchema: (t: DescriptionHelper["t"]) => {
+declare const updateIssueSchema: (t: DescriptionHelper['t']) => {
     issueId: z.ZodOptional<z.ZodNumber>;
     issueKey: z.ZodOptional<z.ZodString>;
     summary: z.ZodOptional<z.ZodString>;

package/build/tools/updateIssueComment.d.ts

@@ -3,7 +3,7 @@ import type { Entity } from 'backlog-js';
 import { Backlog } from 'backlog-js';
 import { ToolDefinition } from '../types/tool.js';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
-declare const updateIssueCommentSchema: (t: DescriptionHelper["t"]) => {
+declare const updateIssueCommentSchema: (t: DescriptionHelper['t']) => {
     issueId: z.ZodOptional<z.ZodNumber>;
     issueKey: z.ZodOptional<z.ZodString>;
     commentId: z.ZodNumber;

package/build/tools/updateProject.d.ts

@@ -3,7 +3,7 @@ import type { Entity } from 'backlog-js';
 import { Backlog } from 'backlog-js';
 import { ToolDefinition } from '../types/tool.js';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
-declare const updateProjectSchema: (t: DescriptionHelper["t"]) => {
+declare const updateProjectSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;

package/build/tools/updatePullRequest.d.ts

@@ -3,7 +3,7 @@ import type { Entity } from 'backlog-js';
 import { Backlog } from 'backlog-js';
 import { ToolDefinition } from '../types/tool.js';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
-declare const updatePullRequestSchema: (t: DescriptionHelper["t"]) => {
+declare const updatePullRequestSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
     repoId: z.ZodOptional<z.ZodNumber>;

package/build/tools/updatePullRequestComment.d.ts

@@ -3,7 +3,7 @@ import type { Entity } from 'backlog-js';
 import { Backlog } from 'backlog-js';
 import { ToolDefinition } from '../types/tool.js';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
-declare const updatePullRequestCommentSchema: (t: DescriptionHelper["t"]) => {
+declare const updatePullRequestCommentSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
     repoId: z.ZodOptional<z.ZodNumber>;

package/build/tools/updateVersionMilestone.d.ts

@@ -3,7 +3,7 @@ import type { Entity } from 'backlog-js';
 import { Backlog } from 'backlog-js';
 import { ToolDefinition } from '../types/tool.js';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
-declare const updateVersionMilestoneSchema: (t: DescriptionHelper["t"]) => {
+declare const updateVersionMilestoneSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
     id: z.ZodNumber;

package/build/tools/updateWatching.d.ts

@@ -3,7 +3,7 @@ import type { Entity } from 'backlog-js';
 import { Backlog } from 'backlog-js';
 import { ToolDefinition } from '../types/tool.js';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
-declare const updateWatchingSchema: (t: DescriptionHelper["t"]) => {
+declare const updateWatchingSchema: (t: DescriptionHelper['t']) => {
     watchId: z.ZodNumber;
     note: z.ZodString;
 };

package/build/tools/updateWiki.d.ts

@@ -3,7 +3,7 @@ import type { Entity } from 'backlog-js';
 import { Backlog } from 'backlog-js';
 import { ToolDefinition } from '../types/tool.js';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
-declare const updateWikiSchema: (t: DescriptionHelper["t"]) => {
+declare const updateWikiSchema: (t: DescriptionHelper['t']) => {
     wikiId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
     name: z.ZodOptional<z.ZodString>;
     content: z.ZodOptional<z.ZodString>;

package/build/types/tool.d.ts

@@ -28,7 +28,7 @@ export type ToolDefinition<Shape extends z.ZodRawShape, Result> = {
      */
     returnsList: boolean;
 };
-export declare const buildToolSchema: <T extends z.ZodRawShape>(fn: (t: DescriptionHelper["t"]) => T) => (t: DescriptionHelper["t"]) => T;
+export declare const buildToolSchema: <T extends z.ZodRawShape>(fn: (t: DescriptionHelper['t']) => T) => (t: DescriptionHelper['t']) => T;
 export type DynamicToolDefinition<Shape extends z.ZodRawShape> = {
     name: string;
     description: string;

package/build/types/toolsets.d.ts

@@ -5,7 +5,18 @@ type BaseToolset<TTool> = {
     enabled: boolean;
     tools: TTool[];
 };
-export type Toolset = BaseToolset<ToolDefinition<any, any>>;
+export type Toolset = BaseToolset<ToolDefinition<any, any>> & {
+    /**
+     * Tools of this toolset that build their own `CallToolResult`.
+     *
+     * A separate field rather than a member of `tools`, because the two are
+     * registered through different pipelines: a `ToolDefinition` is reshaped by
+     * field picking and the token limit, which a tool returning binary content
+     * must not be. Keeping them in one toolset is what makes `--enable-toolsets`
+     * and the prefix apply to both.
+     */
+    dynamicTools?: DynamicToolDefinition<any>[];
+};
 export type ToolsetGroup = {
     toolsets: Toolset[];
 };

package/build/utils/logger.js

@@ -2,10 +2,42 @@ import pino from 'pino';
 if (!process.env.NODE_ENV) {
     process.env.NODE_ENV = 'production';
 }
-const isProd = process.env.NODE_ENV === 'production';
+// Normalised the same way LOG_LEVEL is below. A strict `=== 'production'` makes
+// `Production`, or a stray space picked up from a shell or a container runtime,
+// silently mean "not production" — and that flips the default level *and* the
+// output format, with nothing logged to say so. A typo here is worth less
+// tolerance than a typo in LOG_LEVEL, not more.
+const isProd = process.env.NODE_ENV?.trim().toLowerCase() === 'production';
+// pino's levels plus `silent`. Listed here so an unusable LOG_LEVEL is caught
+// while the fallback is still available, rather than by pino throwing during
+// construction — a server that refuses to start is a worse answer to a typo in
+// an environment variable than one that logs at its default level and says so.
+const LEVELS = [
+    'fatal',
+    'error',
+    'warn',
+    'info',
+    'debug',
+    'trace',
+    'silent',
+];
+const defaultLevel = isProd ? 'error' : 'debug';
+// LOG_LEVEL decides how much is logged; NODE_ENV decides how it is formatted.
+// The two are independent questions, and conflating them bites on the HTTP
+// transport in particular: there the log stream is the only channel an operator
+// has, so raising the level to diagnose something must not also switch the
+// output to colorized, human-formatted lines that a log collector stores
+// verbatim.
+// An empty or blank LOG_LEVEL counts as not set: it is what an unset variable
+// looks like once it has been through a shell or a container runtime.
+const normalisedLevel = process.env.LOG_LEVEL?.trim().toLowerCase() || undefined;
+const requestedLevel = normalisedLevel && LEVELS.includes(normalisedLevel)
+    ? normalisedLevel
+    : undefined;
+const level = requestedLevel ?? defaultLevel;
 // Plain JSON on stderr. stdout carries the JSON-RPC stream on the stdio
 // transport, so a log line landing there would corrupt the protocol.
-const plainLogger = () => pino({ level: isProd ? 'error' : 'debug' }, pino.destination({ dest: 2, sync: false }));
+const plainLogger = () => pino({ level }, pino.destination({ dest: 2, sync: false }));
 // `pino-pretty` is a development-only dependency, so an installed copy of this
 // package does not have it. pino resolves a transport target eagerly and throws
 // synchronously when it cannot, so asking is cheaper than probing the module
@@ -13,7 +45,7 @@ const plainLogger = () => pino({ level: isProd ? 'error' : 'debug' }, pino.desti
 const prettyLogger = () => {
     try {
         return pino({
-            level: 'debug',
+            level,
             transport: {
                 target: 'pino-pretty',
                 options: {
@@ -31,3 +63,9 @@ const prettyLogger = () => {
     }
 };
 export const logger = isProd ? plainLogger() : prettyLogger();
+if (normalisedLevel && !requestedLevel) {
+    // `logger.error`, not `warn`: the level in force here is the default one,
+    // which on a deployed server swallows anything lower — and this message
+    // exists precisely for the operator whose LOG_LEVEL did not take effect.
+    logger.error({ requested: process.env.LOG_LEVEL, effective: level, supported: LEVELS }, 'Unrecognised LOG_LEVEL; falling back to the default level');
+}

package/build/utils/resolveIdOrKey.d.ts

@@ -10,9 +10,9 @@ type ResolveResult = {
 export declare const resolveIdOrKey: <E extends EntityName>(entity: E, values: {
     id?: number;
     key?: string;
-}, t: DescriptionHelper["t"]) => ResolveResult;
+}, t: DescriptionHelper['t']) => ResolveResult;
 export declare const resolveIdOrName: <E extends EntityName>(entity: E, values: {
     id?: number;
     name?: string;
-}, t: DescriptionHelper["t"]) => ResolveResult;
+}, t: DescriptionHelper['t']) => ResolveResult;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backlog-mcp-server",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "type": "module",
   "bin": {
     "backlog-mcp-server": "./build/index.js"
@@ -33,34 +33,29 @@
     "build"
   ],
   "dependencies": {
-    "@hono/node-server": "^2.0.10",
+    "@hono/node-server": "^2.1.1",
     "@modelcontextprotocol/hono": "^2.0.0",
     "@modelcontextprotocol/server": "^2.0.0",
-    "backlog-js": "^0.19.1",
+    "backlog-js": "^0.20.1",
     "env-var": "^7.5.0",
-    "hono": "^4.12.34",
-    "js-yaml": "^5.2.3",
+    "hono": "^4.13.5",
+    "js-yaml": "^5.4.1",
     "pino": "^10.3.1",
-    "yargs": "^18.0.0",
+    "yargs": "^18.1.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@eslint/js": "^10.0.1",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^26.2.0",
+    "@types/node": "^26.4.0",
     "@types/yargs": "^17.0.35",
-    "@typescript-eslint/eslint-plugin": "^8.60.1",
-    "@typescript-eslint/parser": "^8.60.1",
-    "@typescript-eslint/utils": "^8.60.1",
-    "@vitest/coverage-v8": "^4.1.8",
-    "eslint": "^10.4.1",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.6",
+    "@vitest/coverage-v8": "^4.1.11",
+    "oxfmt": "^0.65.0",
+    "oxlint": "^1.80.0",
+    "oxlint-tsgolint": "^7.0.2001",
     "pino-pretty": "^13.1.3",
-    "prettier": "^3.8.3",
-    "tsx": "^4.22.4",
-    "typescript": "^6.0.3",
-    "vitest": "^4.1.8"
+    "tsx": "^4.23.12",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
   },
   "scripts": {
     "preinstall": "npx only-allow pnpm",
@@ -69,11 +64,9 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
-    "lint": "eslint . --ext .ts",
-    "lint:fix": "eslint . --ext .ts --fix",
-    "format": "prettier --check \"**/*.{ts,tsx}\"",
-    "format:fix": "prettier --write \"**/*.{ts,tsx}\"",
-    "typecheck": "tsc --noEmit",
-    "typecheck:all": "tsc --noEmit --project tsconfig.test.json"
+    "lint": "oxlint --type-aware --type-check",
+    "lint:fix": "oxlint --type-aware --type-check --fix",
+    "format": "oxfmt --check src vitest.config.ts",
+    "format:fix": "oxfmt src vitest.config.ts"
   }
 }