@k-system/tickr-mcp 0.8.5 → 0.9.0

package/dist/debug-logger.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Zkontroluje zda je debug logování zapnuté (TICKR_DEBUG=true|1).
+ */
+export declare function isDebugEnabled(): boolean;
+/**
+ * Zaloguje MCP tool call do ~/.tickr/mcp-debug.log.
+ * Pokud debug není zapnutý, funkce je no-op.
+ * Pokud zápis selže, tiše ignoruje — debug log nesmí způsobit crash.
+ */
+export declare function debugLog(toolName: string, params: Record<string, unknown>, responseStatus: "ok" | "error", durationMs: number): void;
+//# sourceMappingURL=debug-logger.d.ts.map

package/dist/debug-logger.js

@@ -0,0 +1,52 @@
+import { appendFileSync, statSync, renameSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const MAX_LOG_SIZE = 10 * 1024 * 1024; // 10 MB
+const MAX_PARAMS_LENGTH = 200;
+let _debugEnabled = null;
+/**
+ * Zkontroluje zda je debug logování zapnuté (TICKR_DEBUG=true|1).
+ */
+export function isDebugEnabled() {
+    if (_debugEnabled === null) {
+        const val = process.env.TICKR_DEBUG;
+        _debugEnabled = val === "true" || val === "1";
+    }
+    return _debugEnabled;
+}
+/**
+ * Zaloguje MCP tool call do ~/.tickr/mcp-debug.log.
+ * Pokud debug není zapnutý, funkce je no-op.
+ * Pokud zápis selže, tiše ignoruje — debug log nesmí způsobit crash.
+ */
+export function debugLog(toolName, params, responseStatus, durationMs) {
+    if (!isDebugEnabled())
+        return;
+    try {
+        const dir = join(homedir(), ".tickr");
+        mkdirSync(dir, { recursive: true });
+        const logPath = join(dir, "mcp-debug.log");
+        // Rotace — pokud soubor > 10 MB, přejmenuj na .log.old
+        try {
+            const stats = statSync(logPath);
+            if (stats.size > MAX_LOG_SIZE) {
+                renameSync(logPath, logPath + ".old");
+            }
+        }
+        catch {
+            // Soubor ještě neexistuje — ok
+        }
+        // Zkrátit params na max 200 znaků
+        let paramsStr = JSON.stringify(params);
+        if (paramsStr.length > MAX_PARAMS_LENGTH) {
+            paramsStr = paramsStr.slice(0, MAX_PARAMS_LENGTH - 3) + "...";
+        }
+        const timestamp = new Date().toISOString();
+        const line = `[${timestamp}] [${toolName}] params=${paramsStr} → ${responseStatus} (${durationMs}ms)\n`;
+        appendFileSync(logPath, line, "utf-8");
+    }
+    catch {
+        // Tiše ignoruj — debug log nesmí způsobit crash
+    }
+}
+//# sourceMappingURL=debug-logger.js.map

package/dist/server.js

@@ -2,6 +2,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { loadConfig } from "./config.js";
 import { ApiClient } from "./api-client.js";
+import { debugLog, isDebugEnabled } from "./debug-logger.js";
 // Tools
 import { registerCreateTicket } from "./tools/create-ticket.js";
 import { registerListTickets } from "./tools/list-tickets.js";
@@ -95,6 +96,30 @@ export async function startServer() {
         name: "tickr",
         version: "0.1.5",
     });
+    // Debug logging — obalení server.tool pro automatické logování všech tool callů
+    if (isDebugEnabled()) {
+        const originalTool = server.tool.bind(server);
+        const wrappedTool = function (...args) {
+            // server.tool má více overloadů — handler je vždy poslední argument
+            const handlerIndex = args.length - 1;
+            const name = args[0];
+            const originalHandler = args[handlerIndex];
+            args[handlerIndex] = async (params, extra) => {
+                const start = Date.now();
+                try {
+                    const result = await originalHandler(params, extra);
+                    debugLog(name, (params ?? {}), result.isError ? "error" : "ok", Date.now() - start);
+                    return result;
+                }
+                catch (err) {
+                    debugLog(name, (params ?? {}), "error", Date.now() - start);
+                    throw err;
+                }
+            };
+            return originalTool.apply(server, args);
+        };
+        server.tool = wrappedTool;
+    }
     // Registrace tools
     registerCreateTicket(server, api);
     registerListTickets(server, api);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k-system/tickr-mcp",
-  "version": "0.8.5",
+  "version": "0.9.0",
   "description": "MCP server for Tickr project management — 56 tools + setup CLI wizard",
   "type": "module",
   "main": "./dist/index.js",