@k-system/tickr-mcp 0.1.4 → 0.1.5

package/dist/formatters.js

@@ -37,6 +37,12 @@ export function formatTicketMarkdown(t) {
             lines.push(`| ${i} | ${item.area} | ${item.fileOrDetail} | ${item.status} | ${item.note || "-"} |`);
         });
     }
+    if (t.relations && t.relations.length > 0) {
+        lines.push("", "## Relations", "", "| Type | Direction | Ticket | Title | Status |", "|------|-----------|--------|-------|--------|");
+        for (const r of t.relations) {
+            lines.push(`| ${r.type} | ${r.direction} | ${r.displayNumber} | ${r.title} | ${r.status} |`);
+        }
+    }
     if (t.comments?.length > 0) {
         lines.push("", "## Comments", "");
         for (const c of t.comments) {

package/dist/index.js

@@ -24,6 +24,8 @@ import { registerAssignEpic } from "./tools/assign-epic.js";
 import { registerPollDevQueue } from "./tools/poll-dev-queue.js";
 import { registerCompleteDevTask } from "./tools/complete-dev-task.js";
 import { registerWhoami } from "./tools/whoami.js";
+import { registerAddRelation } from "./tools/add-relation.js";
+import { registerRemoveRelation } from "./tools/remove-relation.js";
 // Resources
 import { registerTicketResource } from "./resources/ticket-resource.js";
 import { registerProjectResource } from "./resources/project-resource.js";
@@ -55,6 +57,8 @@ async function main() {
     registerPollDevQueue(server, api);
     registerCompleteDevTask(server, api);
     registerWhoami(server, api);
+    registerAddRelation(server, api);
+    registerRemoveRelation(server, api);
     // Registrace resources
     registerTicketResource(server, api);
     registerProjectResource(server, api);

package/dist/tools/add-comment.js

@@ -5,9 +5,9 @@ export function registerAddComment(server, api) {
         text: z.string().describe("Comment text (markdown)"),
     }, async (params) => {
         try {
-            await api.post(`/api/tickets/${params.number}/comments`, {
-                text: params.text,
-            });
+            // Unescapovat double-escaped newlines z MCP tool parametrů
+            const text = params.text.replace(/\\n/g, "\n");
+            await api.post(`/api/tickets/${params.number}/comments`, { text });
             return {
                 content: [
                     { type: "text", text: `Comment added to ${params.number}` },

package/dist/tools/add-relation.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+export declare function registerAddRelation(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=add-relation.d.ts.map

package/dist/tools/add-relation.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+export function registerAddRelation(server, api) {
+    server.tool("add_relation", "Create a relation between two tickets (blocks, relates_to, duplicates)", {
+        source_number: z.string().describe("Source ticket display number, e.g. 'TKR-42' or 'TKR-BUG-0042'"),
+        target_number: z.string().describe("Target ticket display number"),
+        type: z.enum(["blocks", "relates_to", "duplicates"]).describe("Relation type: 'blocks' means source blocks target"),
+    }, async (params) => {
+        try {
+            const result = await api.post(`/api/tickets/${params.source_number}/relations`, {
+                targetDisplayNumber: params.target_number,
+                type: params.type,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Relation created: ${params.source_number} --${params.type}--> ${params.target_number}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=add-relation.js.map

package/dist/tools/create-ticket.js

@@ -10,19 +10,21 @@ export function registerCreateTicket(server, api) {
         affected_parts: z.array(z.string()).optional(),
     }, async (params) => {
         try {
-            const ticket = await api.post(`/api/projects/${params.project}/tickets`, {
+            // Unescapovat double-escaped newlines z MCP tool parametrů
+            const content = params.content?.replace(/\\n/g, "\n");
+            const result = await api.post(`/api/projects/${params.project}/tickets`, {
                 type: params.type,
                 title: params.title,
                 scope: params.scope,
                 priority: params.priority,
-                content: params.content,
+                content,
                 affectedParts: params.affected_parts,
             });
             return {
                 content: [
                     {
                         type: "text",
-                        text: `Created ${ticket.displayNumber}: ${ticket.title}`,
+                        text: `Created ${result.number}: ${params.title}`,
                     },
                 ],
             };

package/dist/tools/get-ticket.js

@@ -6,6 +6,14 @@ export function registerGetTicket(server, api) {
     }, async (params) => {
         try {
             const ticket = await api.get(`/api/tickets/${params.number}`);
+            // Načti relace zvlášť — API vrací relace na samostatném endpointu
+            try {
+                const relations = await api.get(`/api/tickets/${params.number}/relations`);
+                ticket.relations = relations;
+            }
+            catch {
+                // Relace nejsou kritické — pokud selžou, pokračuj bez nich
+            }
             const md = formatTicketMarkdown(ticket);
             return { content: [{ type: "text", text: md }] };
         }

package/dist/tools/remove-relation.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+export declare function registerRemoveRelation(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=remove-relation.d.ts.map

package/dist/tools/remove-relation.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export function registerRemoveRelation(server, api) {
+    server.tool("remove_relation", "Remove a relation from a ticket by relation ID", {
+        source_number: z.string().describe("Ticket display number that owns the relation, e.g. 'TKR-42'"),
+        relation_id: z.string().describe("Relation UUID to remove (from get_ticket relations list)"),
+    }, async (params) => {
+        try {
+            await api.delete(`/api/tickets/${params.source_number}/relations/${params.relation_id}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Relation ${params.relation_id} removed from ${params.source_number}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=remove-relation.js.map

package/dist/tools/update-ticket.js

@@ -11,6 +11,9 @@ export function registerUpdateTicket(server, api) {
     }, async (params) => {
         try {
             const { number, ...updates } = params;
+            // Unescapovat double-escaped newlines z MCP tool parametrů
+            if (updates.content)
+                updates.content = updates.content.replace(/\\n/g, "\n");
             const ticket = await api.put(`/api/tickets/${number}`, updates);
             return {
                 content: [

package/dist/types.d.ts

@@ -1,4 +1,14 @@
 /** Sdílené typy pro MCP server */
+export interface TicketRelation {
+    id: string;
+    type: string;
+    direction: string;
+    displayNumber: string;
+    title: string;
+    status: string;
+    statusColor: string | null;
+    createdAt: string;
+}
 export interface Ticket {
     id: string;
     projectId: string;
@@ -16,6 +26,7 @@ export interface Ticket {
     affectedParts: string[] | string | null;
     implementationItems: ImplementationItem[];
     comments: Comment[];
+    relations?: TicketRelation[];
     createdAt: string;
     updatedAt: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k-system/tickr-mcp",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "MCP server for Tickr project management — 17 tools for ticket CRUD, triage, labels, cycles, epics",
   "type": "module",
   "main": "./dist/index.js",