@k-system/tickr-mcp 0.7.0 → 0.8.0

package/dist/formatters.js

@@ -12,6 +12,7 @@ export function formatTicketMarkdown(t) {
         `| Scope | ${t.scope || "-"} |`,
         `| Assignee | ${t.assigneeName || "Unassigned"} |`,
         `| Estimate | ${t.estimate || "-"} |`,
+        `| External ID | ${t.externalId || "-"} |`,
         `| Created | ${t.createdAt} |`,
         `| Updated | ${t.updatedAt} |`,
     ];
@@ -33,15 +34,15 @@ export function formatTicketMarkdown(t) {
         lines.push("", "---", "", t.content);
     }
     if (t.implementationItems?.length > 0) {
-        lines.push("", "## Implementation Items", "", "| # | Area | Detail | Status | Note |", "|---|------|--------|--------|------|");
+        lines.push("", "## Implementation Items", "", "| # | Id | Area | Detail | Status | Note |", "|---|----|------|--------|--------|------|");
         t.implementationItems.forEach((item, i) => {
-            lines.push(`| ${i} | ${item.area} | ${item.fileOrDetail} | ${item.status} | ${item.note || "-"} |`);
+            lines.push(`| ${i} | ${item.id} | ${item.area} | ${item.fileOrDetail} | ${item.status} | ${item.note || "-"} |`);
         });
     }
     if (t.relations && t.relations.length > 0) {
-        lines.push("", "## Relations", "", "| Type | Direction | Ticket | Title | Status |", "|------|-----------|--------|-------|--------|");
+        lines.push("", "## Relations", "", "| Id | Type | Direction | Ticket | Title | Status |", "|----|------|-----------|--------|-------|--------|");
         for (const r of t.relations) {
-            lines.push(`| ${r.type} | ${r.direction} | ${r.displayNumber} | ${r.title} | ${r.status} |`);
+            lines.push(`| ${r.id} | ${r.type} | ${r.direction} | ${r.displayNumber} | ${r.title} | ${r.status} |`);
         }
     }
     if (t.comments?.length > 0) {

package/dist/tools/create-epic.js

@@ -7,6 +7,7 @@ export function registerCreateEpic(server, api) {
         color: z.string().optional().describe("Epic color hex code (e.g. #6366f1)"),
         start_date: z.string().optional().describe("Start date (YYYY-MM-DD)"),
         target_date: z.string().optional().describe("Target date (YYYY-MM-DD)"),
+        external_id: z.string().optional().describe("External identifier for linking to other systems"),
     }, async (params) => {
         try {
             const result = await api.post(`/api/projects/${params.project}/epics`, {
@@ -15,6 +16,7 @@ export function registerCreateEpic(server, api) {
                 color: params.color,
                 startDate: params.start_date,
                 targetDate: params.target_date,
+                externalId: params.external_id,
             });
             return {
                 content: [

package/dist/tools/create-ticket.js

@@ -9,6 +9,7 @@ export function registerCreateTicket(server, api) {
         content: z.string().optional().describe("Markdown content (analysis, solution)"),
         affected_parts: z.array(z.string()).optional(),
         due_date: z.string().optional().describe("Due date in YYYY-MM-DD format"),
+        external_id: z.string().optional().describe("External identifier (e.g. JIRA-123, GH-456)"),
     }, async (params) => {
         try {
             // Unescapovat double-escaped newlines z MCP tool parametrů
@@ -21,6 +22,7 @@ export function registerCreateTicket(server, api) {
                 content,
                 affectedParts: params.affected_parts,
                 dueDate: params.due_date,
+                externalId: params.external_id,
             });
             return {
                 content: [

package/dist/tools/list-cycles.js

@@ -6,7 +6,7 @@ export function registerListCycles(server, api) {
         try {
             const cycles = await api.get(`/api/projects/${params.project}/cycles`);
             const text = cycles
-                .map((c) => `#${c.number}${c.name ? ` ${c.name}` : ""} [${c.status}] ${c.startDate}–${c.endDate} (${c.completedTickets}/${c.totalTickets})`)
+                .map((c) => `#${c.number}${c.name ? ` ${c.name}` : ""} (${c.id}) [${c.status}] ${c.startDate}–${c.endDate} (${c.completedTickets}/${c.totalTickets})`)
                 .join("\n");
             return {
                 content: [{ type: "text", text: text || "No cycles found." }],

package/dist/tools/list-epics.js

@@ -6,7 +6,7 @@ export function registerListEpics(server, api) {
         try {
             const epics = await api.get(`/api/projects/${params.project}/epics`);
             const text = epics
-                .map((e) => `${e.name} [${e.status}] (${e.completedTickets}/${e.totalTickets})${e.targetDate ? ` target: ${e.targetDate}` : ""}`)
+                .map((e) => `${e.name} (${e.id}) [${e.status}] (${e.completedTickets}/${e.totalTickets})${e.targetDate ? ` target: ${e.targetDate}` : ""}`)
                 .join("\n");
             return {
                 content: [{ type: "text", text: text || "No epics found." }],

package/dist/tools/list-labels.js

@@ -6,7 +6,7 @@ export function registerListLabels(server, api) {
         try {
             const labels = await api.get(`/api/projects/${params.project}/labels`);
             const text = labels
-                .map((l) => `${l.name} (${l.color})`)
+                .map((l) => `${l.name} (${l.id}) [${l.color}]`)
                 .join("\n");
             return {
                 content: [{ type: "text", text: text || "No labels configured." }],

package/dist/tools/update-epic.js

@@ -8,6 +8,7 @@ export function registerUpdateEpic(server, api) {
         color: z.string().optional().describe("New hex color code, e.g. '#6366f1'"),
         startDate: z.string().optional().describe("New start date (YYYY-MM-DD)"),
         targetDate: z.string().optional().describe("New target date (YYYY-MM-DD)"),
+        external_id: z.string().optional().describe("External identifier"),
     }, async (params) => {
         try {
             const body = {};
@@ -21,6 +22,8 @@ export function registerUpdateEpic(server, api) {
                 body.startDate = params.startDate;
             if (params.targetDate !== undefined)
                 body.targetDate = params.targetDate;
+            if (params.external_id !== undefined)
+                body.externalId = params.external_id;
             await api.put(`/api/projects/${params.project}/epics/${params.epic_id}`, body);
             return {
                 content: [

package/dist/tools/update-implementation-item.js

@@ -2,14 +2,14 @@ import { z } from "zod";
 export function registerUpdateImplementationItem(server, api) {
     server.tool("update_implementation_item", "Update an implementation item on a ticket", {
         number: z.string().describe("Ticket display number, e.g. 'TKR-42' (legacy) or 'TKR-BUG-0042' (typed)"),
-        item_index: z.number().describe("0-based index in implementation table"),
+        item_id: z.string().describe("Implementation item GUID (from get_ticket output)"),
         status: z
             .enum(["todo", "in-progress", "done", "skipped"])
             .optional(),
         note: z.string().optional(),
     }, async (params) => {
         try {
-            await api.patch(`/api/tickets/${params.number}/items/${params.item_index}`, {
+            await api.put(`/api/tickets/${params.number}/items/${params.item_id}`, {
                 status: params.status,
                 note: params.note?.replace(/\\n/g, "\n"),
             });
@@ -17,7 +17,7 @@ export function registerUpdateImplementationItem(server, api) {
                 content: [
                     {
                         type: "text",
-                        text: `Item #${params.item_index} updated on ${params.number}`,
+                        text: `Item ${params.item_id} updated on ${params.number}`,
                     },
                 ],
             };

package/dist/tools/update-ticket.js

@@ -9,13 +9,16 @@ export function registerUpdateTicket(server, api) {
         assignee: z.string().optional().describe("Username or 'unassigned'"),
         scope: z.string().optional(),
         due_date: z.string().optional().describe("Due date in YYYY-MM-DD format, or 'clear' to remove"),
+        external_id: z.string().optional().describe("External identifier (e.g. JIRA-123, GH-456)"),
     }, async (params) => {
         try {
-            const { number, due_date, ...rest } = params;
+            const { number, due_date, external_id, ...rest } = params;
             // Unescapovat double-escaped newlines z MCP tool parametrů
             if (rest.content)
                 rest.content = rest.content.replace(/\\n/g, "\n");
             const body = { ...rest };
+            if (external_id !== undefined)
+                body.externalId = external_id;
             if (due_date === "clear") {
                 body.clearDueDate = true;
             }

package/dist/types.d.ts

@@ -27,6 +27,7 @@ export interface Ticket {
     implementationItems: ImplementationItem[];
     comments: Comment[];
     relations?: TicketRelation[];
+    externalId: string | null;
     createdAt: string;
     updatedAt: string;
 }

package/package.json

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