backlog-mcp-server 0.18.0 → 0.18.1

package/README.ja.md

@@ -469,6 +469,22 @@ MAX_TOKENS=10000
 
 > 注：これはベストエフォートの緩和策であり、保証された強制ではありません。
 
+### ログ出力
+
+ログは **stderr** に出力されます（stdio トランスポートでは stdout が JSON-RPC のストリームに使われるため）。
+
+| 変数        | 説明                                                                                                                                                                        |
+| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `LOG_LEVEL` | `fatal` / `error` / `warn` / `info` / `debug` / `trace` / `silent`。既定は `NODE_ENV` が `production`（未設定時もこれに含まれる）のとき `error`、それ以外は `debug`。認識できない値は通知した上で既定値にフォールバックします。 |
+
+出力**フォーマット**は引き続き `NODE_ENV` が決めます（`production` 以外では `pino-pretty` が利用可能なら人間向けの整形出力に切り替わります）。ログ量を変えたいときは `NODE_ENV` ではなく `LOG_LEVEL` を設定してください。デプロイ先で構造化 JSON のまま保てます。
+
+`pino-pretty` は開発用の依存なので、公開されている npm パッケージにもコンテナイメージにも含まれていません。そのため、これらでは `NODE_ENV` の値に関わらず常に構造化 JSON が出力され、出力を変えられるのは `LOG_LEVEL` だけです。
+
+```
+LOG_LEVEL=info node build/index.js --transport http
+```
+
 ### 完全なカスタム設定例
 
 このセクションでは、複数の環境変数を使用した高度な設定を示します。これらは実験的な機能であり、すべてのMCPクライアントでサポートされているとは限りません。これはMCP標準仕様の一部ではなく、注意して使用する必要があります。

package/README.md

@@ -586,6 +586,22 @@ If a response exceeds the limit, it will be truncated with a warning.
 
 > Note: This is a best-effort mitigation, not a guaranteed enforcement.
 
+### Logging
+
+The server logs to **stderr** (stdout carries the JSON-RPC stream on the stdio transport).
+
+| Variable    | Description                                                                                                                                                                                             |
+| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `LOG_LEVEL` | `fatal`, `error`, `warn`, `info`, `debug`, `trace` or `silent`. Defaults to `error` when `NODE_ENV` is `production` — which is also the default when `NODE_ENV` is unset — and to `debug` otherwise. An unrecognised value is reported and the default is used. |
+
+`NODE_ENV` still selects the output *format*: any value other than `production` switches to human-readable `pino-pretty` output when that package is available. Use `LOG_LEVEL`, not `NODE_ENV`, to change how much is logged, so that a deployment keeps structured JSON:
+
+`pino-pretty` is a development dependency, so neither the published npm package nor the container image carries a copy. In those, logs are structured JSON whatever `NODE_ENV` says, and `LOG_LEVEL` is the only setting that changes the output.
+
+```
+LOG_LEVEL=info node build/index.js --transport http
+```
+
 ### Full Custom Configuration Example
 
 This section demonstrates advanced configuration using multiple environment variables. These are experimental features and may not be supported across all MCP clients. This is not part of the MCP standard specification and should be used with caution.

package/build/auth/oauthRoutes.js

@@ -119,7 +119,7 @@ export function createOAuthRoutes(config, store, mcpPath) {
         const declaredApplicationType = body.application_type ?? undefined;
         if (declaredApplicationType !== undefined &&
             !APPLICATION_TYPES.includes(declaredApplicationType)) {
-            return c.json(oauthError('invalid_client_metadata', `Unsupported application_type: ${String(declaredApplicationType)}. Supported: ${APPLICATION_TYPES.join(', ')}`), 400);
+            return c.json(oauthError('invalid_client_metadata', `Unsupported application_type: ${JSON.stringify(declaredApplicationType)}. Supported: ${APPLICATION_TYPES.join(', ')}`), 400);
         }
         const applicationType = resolveApplicationType(declaredApplicationType, redirectUris);
         if (applicationType === 'web') {

package/build/backlog/customFields.js

@@ -49,20 +49,23 @@ export function customFieldFiltersToPayload(customFields) {
                 break;
             }
             case 'list': {
-                if (Array.isArray(field.value)) {
-                    const values = field.value.filter((value) => Number.isFinite(value));
-                    if (values.length > 0) {
-                        result[`${baseKey}[]`] = values;
-                    }
-                }
-                else if (Number.isFinite(field.value)) {
-                    result[baseKey] = field.value;
+                // Always an array, single value included. Backlog matches a list custom
+                // field only on the indexed parameters `customField_1[0]=…`, which
+                // `Request.toQueryString` produces from an array under a `customField_`
+                // key. A bare `customField_1=…` is not matched, and neither is the
+                // `customField_1[][0]=…` that a `[]` suffix on this key would produce.
+                // Neither is rejected either — the filter is silently ignored and every
+                // issue comes back, so the caller cannot tell a filtered query from an
+                // unfiltered one.
+                const values = (Array.isArray(field.value) ? field.value : [field.value]).filter((value) => Number.isFinite(value));
+                if (values.length > 0) {
+                    result[baseKey] = values;
                 }
                 break;
             }
             default: {
                 const exhaustiveCheck = field;
-                throw new Error(`Unsupported custom field filter type: ${exhaustiveCheck}`);
+                throw new Error(`Unsupported custom field filter type: ${JSON.stringify(exhaustiveCheck)}`);
             }
         }
     }

package/build/httpMcpServer.js

@@ -16,6 +16,14 @@ export const runHttpMcpServer = async (options) => {
     const app = new Hono();
     const isLocalhostBind = LOCALHOST_BINDS.includes(host);
     const oauthEnabled = !!(oauthConfig && tokenStore);
+    // Registered before the Host and Origin guards so that it stays reachable
+    // under an allow list. A load balancer health check addresses the target
+    // directly and puts its address in `Host` — AWS ALB gives no way to override
+    // it — so a guarded `/health` can only ever answer 403, leaving an operator
+    // to choose between dropping the allow list and treating 403 as healthy.
+    // Exempting it costs nothing: the response is constant and reaches no state,
+    // so there is nothing here for a rebinding page to reach either.
+    app.get('/health', (c) => c.json({ status: 'healthy', timestamp: new Date().toISOString(), version }));
     // DNS rebinding protection. `Host` is the actual defense: a rebinding page
     // reaches us carrying its own hostname, which the allow list rejects.
     if (allowedHosts?.length) {
@@ -36,7 +44,6 @@ export const runHttpMcpServer = async (options) => {
     else if (isLocalhostBind && !allowedHosts?.length) {
         app.use('*', localhostOriginValidation());
     }
-    app.get('/health', (c) => c.json({ status: 'healthy', timestamp: new Date().toISOString(), version }));
     if (oauthEnabled) {
         const { createOAuthRoutes } = await import('./auth/oauthRoutes.js');
         const { createBearerAuthMiddleware } = await import('./auth/bearerAuthMiddleware.js');

package/build/loadDescriptionOverrides.js

@@ -69,8 +69,8 @@ export function loadDescriptionOverrides(options) {
             continue;
         if (outcome.status === 'unreadable') {
             // `logger.error`, not `warn`: the logger runs at level `error` unless
-            // NODE_ENV says otherwise, so a warning here would never reach the user
-            // this message exists for.
+            // LOG_LEVEL or NODE_ENV says otherwise, so a warning here would never
+            // reach the user this message exists for.
             logger.error({ err: outcome.error, filePath }, 'Could not read the description override file; continuing with the built-in defaults');
             return {};
         }

package/build/tools/addDocument.d.ts

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

package/build/tools/addDocument.js

@@ -28,7 +28,7 @@ const addDocumentSchema = buildToolSchema((t) => ({
 }));
 export const addDocumentTool = (backlog, { t }) => {
     return {
-        name: 'addDocument',
+        name: 'add_document',
         description: t('TOOL_ADD_DOCUMENT_DESCRIPTION', 'Adds a new document to the specified project.'),
         schema: z.object(addDocumentSchema(t)),
         returnsList: false,

package/build/tools/addIssue.d.ts

@@ -3,7 +3,7 @@ import { Backlog } from 'backlog-js';
 import { z } from 'zod';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
 import { ToolDefinition } from '../types/tool.js';
-declare const addIssueSchema: (t: DescriptionHelper["t"]) => {
+declare const addIssueSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodNumber;
     summary: z.ZodString;
     issueTypeId: z.ZodNumber;

package/build/tools/addIssueComment.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 addIssueCommentSchema: (t: DescriptionHelper["t"]) => {
+declare const addIssueCommentSchema: (t: DescriptionHelper['t']) => {
     issueId: z.ZodOptional<z.ZodNumber>;
     issueKey: z.ZodOptional<z.ZodString>;
     content: z.ZodString;

package/build/tools/addProject.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 addProjectSchema: (t: DescriptionHelper["t"]) => {
+declare const addProjectSchema: (t: DescriptionHelper['t']) => {
     name: z.ZodString;
     key: z.ZodString;
     chartEnabled: z.ZodOptional<z.ZodBoolean>;

package/build/tools/addPullRequest.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 addPullRequestSchema: (t: DescriptionHelper["t"]) => {
+declare const addPullRequestSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
     repoId: z.ZodOptional<z.ZodNumber>;

package/build/tools/addPullRequestComment.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 addPullRequestCommentSchema: (t: DescriptionHelper["t"]) => {
+declare const addPullRequestCommentSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
     repoId: z.ZodOptional<z.ZodNumber>;

package/build/tools/addRelatedIssue.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 addRelatedIssueSchema: (t: DescriptionHelper["t"]) => {
+declare const addRelatedIssueSchema: (t: DescriptionHelper['t']) => {
     issueId: z.ZodOptional<z.ZodNumber>;
     issueKey: z.ZodOptional<z.ZodString>;
     targetIssueId: z.ZodNumber;

package/build/tools/addVersionMilestone.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 addVersionMilestoneSchema: (t: DescriptionHelper["t"]) => {
+declare const addVersionMilestoneSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
     name: z.ZodString;

package/build/tools/addWatching.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 addWatchingSchema: (t: DescriptionHelper["t"]) => {
+declare const addWatchingSchema: (t: DescriptionHelper['t']) => {
     issueIdOrKey: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
     note: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 };

package/build/tools/addWiki.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 addWikiSchema: (t: DescriptionHelper["t"]) => {
+declare const addWikiSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodNumber;
     name: z.ZodString;
     content: z.ZodString;

package/build/tools/countIssues.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 countIssuesSchema: (t: DescriptionHelper["t"]) => {
+declare const countIssuesSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
     issueTypeId: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
     categoryId: z.ZodOptional<z.ZodArray<z.ZodNumber>>;

package/build/tools/deleteIssue.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 deleteIssueSchema: (t: DescriptionHelper["t"]) => {
+declare const deleteIssueSchema: (t: DescriptionHelper['t']) => {
     issueId: z.ZodOptional<z.ZodNumber>;
     issueKey: z.ZodOptional<z.ZodString>;
 };

package/build/tools/deleteProject.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 deleteProjectSchema: (t: DescriptionHelper["t"]) => {
+declare const deleteProjectSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
 };

package/build/tools/deleteVersion.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 deleteVersionSchema: (t: DescriptionHelper["t"]) => {
+declare const deleteVersionSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
     id: z.ZodNumber;

package/build/tools/deleteWatching.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 deleteWatchingSchema: (t: DescriptionHelper["t"]) => {
+declare const deleteWatchingSchema: (t: DescriptionHelper['t']) => {
     watchId: z.ZodNumber;
 };
 export declare const deleteWatchingTool: (backlog: Backlog, { t }: DescriptionHelper) => ToolDefinition<ReturnType<typeof deleteWatchingSchema>, Entity.WatchingList.WatchingListItem>;

package/build/tools/getCategories.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 getCategoriesSchema: (t: DescriptionHelper["t"]) => {
+declare const getCategoriesSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
 };

package/build/tools/getCustomFields.d.ts

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

package/build/tools/getDocument.d.ts

@@ -3,7 +3,7 @@ import { Backlog } from 'backlog-js';
 import { z } from 'zod';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
 import { ToolDefinition } from '../types/tool.js';
-declare const getDocumentSchema: (t: DescriptionHelper["t"]) => {
+declare const getDocumentSchema: (t: DescriptionHelper['t']) => {
     documentId: z.ZodString;
 };
 export declare const getDocumentTool: (backlog: Backlog, { t }: DescriptionHelper) => ToolDefinition<ReturnType<typeof getDocumentSchema>, Entity.Document.Document>;

package/build/tools/getDocumentTree.d.ts

@@ -3,7 +3,7 @@ import { Backlog } from 'backlog-js';
 import { z } from 'zod';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
 import { ToolDefinition } from '../types/tool.js';
-declare const getDocumentTreeSchema: (t: DescriptionHelper["t"]) => {
+declare const getDocumentTreeSchema: (t: DescriptionHelper['t']) => {
     projectIdOrKey: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
 };
 export declare const getDocumentTreeTool: (backlog: Backlog, { t }: DescriptionHelper) => ToolDefinition<ReturnType<typeof getDocumentTreeSchema>, Entity.Document.DocumentTree>;

package/build/tools/getDocuments.d.ts

@@ -3,7 +3,7 @@ import { Backlog } from 'backlog-js';
 import { z } from 'zod';
 import { DescriptionHelper } from '../createDescriptionHelper.js';
 import { ToolDefinition } from '../types/tool.js';
-declare const getDocumentsSchema: (t: DescriptionHelper["t"]) => {
+declare const getDocumentsSchema: (t: DescriptionHelper['t']) => {
     projectIds: z.ZodArray<z.ZodNumber>;
     offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 };

package/build/tools/getGitRepositories.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 getGitRepositoriesSchema: (t: DescriptionHelper["t"]) => {
+declare const getGitRepositoriesSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
 };

package/build/tools/getGitRepository.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 getGitRepositorySchema: (t: DescriptionHelper["t"]) => {
+declare const getGitRepositorySchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
     repoId: z.ZodOptional<z.ZodNumber>;

package/build/tools/getIssue.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 getIssueSchema: (t: DescriptionHelper["t"]) => {
+declare const getIssueSchema: (t: DescriptionHelper['t']) => {
     issueId: z.ZodOptional<z.ZodNumber>;
     issueKey: z.ZodOptional<z.ZodString>;
 };

package/build/tools/getIssueComments.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 getIssueCommentsSchema: (t: DescriptionHelper["t"]) => {
+declare const getIssueCommentsSchema: (t: DescriptionHelper['t']) => {
     issueId: z.ZodOptional<z.ZodNumber>;
     issueKey: z.ZodOptional<z.ZodString>;
     minId: z.ZodOptional<z.ZodNumber>;

package/build/tools/getIssueTypes.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 getIssueTypesSchema: (t: DescriptionHelper["t"]) => {
+declare const getIssueTypesSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
 };

package/build/tools/getIssues.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 getIssuesSchema: (t: DescriptionHelper["t"]) => {
+declare const getIssuesSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
     issueTypeId: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
     categoryId: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
@@ -25,25 +25,25 @@ declare const getIssuesSchema: (t: DescriptionHelper["t"]) => {
     updatedSince: z.ZodOptional<z.ZodString>;
     updatedUntil: z.ZodOptional<z.ZodString>;
     sort: z.ZodOptional<z.ZodEnum<{
-        version: "version";
-        priority: "priority";
-        summary: "summary";
-        startDate: "startDate";
-        dueDate: "dueDate";
-        estimatedHours: "estimatedHours";
         actualHours: "actualHours";
-        issueType: "issueType";
-        status: "status";
         assignee: "assignee";
+        attachment: "attachment";
         category: "category";
-        milestone: "milestone";
-        createdUser: "createdUser";
+        childIssue: "childIssue";
         created: "created";
-        updatedUser: "updatedUser";
-        updated: "updated";
-        attachment: "attachment";
+        createdUser: "createdUser";
+        dueDate: "dueDate";
+        estimatedHours: "estimatedHours";
+        issueType: "issueType";
+        milestone: "milestone";
+        priority: "priority";
         sharedFile: "sharedFile";
-        childIssue: "childIssue";
+        startDate: "startDate";
+        status: "status";
+        summary: "summary";
+        updated: "updated";
+        updatedUser: "updatedUser";
+        version: "version";
     }>>;
     order: z.ZodOptional<z.ZodEnum<{
         asc: "asc";

package/build/tools/getMyself.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 getMyselfSchema: (t: DescriptionHelper["t"]) => {};
+declare const getMyselfSchema: (t: DescriptionHelper['t']) => {};
 export declare const getMyselfTool: (backlog: Backlog, { t }: DescriptionHelper) => ToolDefinition<ReturnType<typeof getMyselfSchema>, Entity.User.User>;
 export {};

package/build/tools/getNotifications.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 getNotificationsSchema: (t: DescriptionHelper["t"]) => {
+declare const getNotificationsSchema: (t: DescriptionHelper['t']) => {
     minId: z.ZodOptional<z.ZodNumber>;
     maxId: z.ZodOptional<z.ZodNumber>;
     count: z.ZodOptional<z.ZodNumber>;

package/build/tools/getNotificationsCount.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 getNotificationsCountSchema: (t: DescriptionHelper["t"]) => {
+declare const getNotificationsCountSchema: (t: DescriptionHelper['t']) => {
     alreadyRead: z.ZodBoolean;
     resourceAlreadyRead: z.ZodBoolean;
 };

package/build/tools/getPriorities.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 getPrioritiesSchema: (t: DescriptionHelper["t"]) => {};
+declare const getPrioritiesSchema: (t: DescriptionHelper['t']) => {};
 export declare const getPrioritiesTool: (backlog: Backlog, { t }: DescriptionHelper) => ToolDefinition<ReturnType<typeof getPrioritiesSchema>, Entity.Issue.Priority>;
 export {};

package/build/tools/getProject.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 getProjectSchema: (t: DescriptionHelper["t"]) => {
+declare const getProjectSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
 };

package/build/tools/getProjectList.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 getProjectListSchema: (t: DescriptionHelper["t"]) => {
+declare const getProjectListSchema: (t: DescriptionHelper['t']) => {
     archived: z.ZodOptional<z.ZodBoolean>;
     all: z.ZodOptional<z.ZodBoolean>;
 };

package/build/tools/getProjectUsers.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 getProjectUsersSchema: (t: DescriptionHelper["t"]) => {
+declare const getProjectUsersSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
 };

package/build/tools/getPullRequest.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 getPullRequestSchema: (t: DescriptionHelper["t"]) => {
+declare const getPullRequestSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
     repoId: z.ZodOptional<z.ZodNumber>;

package/build/tools/getPullRequestComments.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 getPullRequestCommentsSchema: (t: DescriptionHelper["t"]) => {
+declare const getPullRequestCommentsSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
     repoId: z.ZodOptional<z.ZodNumber>;

package/build/tools/getPullRequests.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 getPullRequestsSchema: (t: DescriptionHelper["t"]) => {
+declare const getPullRequestsSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
     repoId: z.ZodOptional<z.ZodNumber>;

package/build/tools/getPullRequestsCount.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 getPullRequestsCountSchema: (t: DescriptionHelper["t"]) => {
+declare const getPullRequestsCountSchema: (t: DescriptionHelper['t']) => {
     projectId: z.ZodOptional<z.ZodNumber>;
     projectKey: z.ZodOptional<z.ZodString>;
     repoId: z.ZodOptional<z.ZodNumber>;

package/build/tools/getRelatedIssues.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 getRelatedIssuesSchema: (t: DescriptionHelper["t"]) => {
+declare const getRelatedIssuesSchema: (t: DescriptionHelper['t']) => {
     issueId: z.ZodOptional<z.ZodNumber>;
     issueKey: z.ZodOptional<z.ZodString>;
 };

package/build/tools/getResolutions.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 getResolutionsSchema: (t: DescriptionHelper["t"]) => {};
+declare const getResolutionsSchema: (t: DescriptionHelper['t']) => {};
 export declare const getResolutionsTool: (backlog: Backlog, { t }: DescriptionHelper) => ToolDefinition<ReturnType<typeof getResolutionsSchema>, Entity.Issue.Resolution>;
 export {};

package/build/tools/getSpace.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 getSpaceSchema: (t: DescriptionHelper["t"]) => {};
+declare const getSpaceSchema: (t: DescriptionHelper['t']) => {};
 export declare const getSpaceTool: (backlog: Backlog, { t }: DescriptionHelper) => ToolDefinition<ReturnType<typeof getSpaceSchema>, Entity.Space.Space>;
 export {};

package/build/tools/getSpaceActivities.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 getSpaceActivitiesSchema: (t: DescriptionHelper["t"]) => {
+declare const getSpaceActivitiesSchema: (t: DescriptionHelper['t']) => {
     activityTypeId: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         Undefined: number;
         IssueCreated: number;

package/build/tools/getUserRecentUpdates.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 getUserRecentUpdatesSchema: (t: DescriptionHelper["t"]) => {
+declare const getUserRecentUpdatesSchema: (t: DescriptionHelper['t']) => {
     userId: z.ZodNumber;
     activityTypeId: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         Undefined: number;

package/build/tools/getUserStarsCount.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 getUserStarsCountSchema: (t: DescriptionHelper["t"]) => {
+declare const getUserStarsCountSchema: (t: DescriptionHelper['t']) => {
     userId: z.ZodNumber;
     since: z.ZodOptional<z.ZodString>;
     until: z.ZodOptional<z.ZodString>;

package/build/tools/getUsers.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 getUsersSchema: (t: DescriptionHelper["t"]) => {};
+declare const getUsersSchema: (t: DescriptionHelper['t']) => {};
 export declare const getUsersTool: (backlog: Backlog, { t }: DescriptionHelper) => ToolDefinition<ReturnType<typeof getUsersSchema>, Entity.User.User>;
 export {};

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/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/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.18.1",
   "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",
     "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"
   }
 }