@k-system/tickr-mcp 0.1.5 → 0.2.0

package/dist/formatters.js

@@ -5,6 +5,7 @@ export function formatTicketMarkdown(t) {
         "",
         `| Field | Value |`,
         `|-------|-------|`,
+        `| Id | ${t.id} |`,
         `| Type | ${t.type} |`,
         `| Status | ${t.status} |`,
         `| Priority | ${t.priority} |`,

package/dist/index.js

@@ -26,6 +26,30 @@ 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";
+// Phase 2 — Skupina A: Workflow & Status Management
+import { registerListStatuses } from "./tools/list-statuses.js";
+import { registerListTransitions } from "./tools/list-transitions.js";
+import { registerCreateStatus } from "./tools/create-status.js";
+import { registerDeleteStatus } from "./tools/delete-status.js";
+import { registerApplyPreset } from "./tools/apply-preset.js";
+// Phase 2 — Skupina B: Project Management
+import { registerListProjects } from "./tools/list-projects.js";
+import { registerGetProject } from "./tools/get-project.js";
+import { registerCreateProject } from "./tools/create-project.js";
+// Phase 2 — Skupina C: Ticket Operations
+import { registerDeleteTicket } from "./tools/delete-ticket.js";
+import { registerGetBoard } from "./tools/get-board.js";
+import { registerGetMyTasks } from "./tools/get-my-tasks.js";
+import { registerListComments } from "./tools/list-comments.js";
+// Phase 2 — Skupina D: Attachments
+import { registerListAttachments } from "./tools/list-attachments.js";
+import { registerDeleteAttachment } from "./tools/delete-attachment.js";
+// Phase 2 — Skupina E: Cycles & Epics CRUD
+import { registerCreateCycle } from "./tools/create-cycle.js";
+import { registerCreateEpic } from "./tools/create-epic.js";
+// Phase 2 — Skupina F: Implementation Items
+import { registerCreateImplementationItem } from "./tools/create-implementation-item.js";
+import { registerDeleteImplementationItem } from "./tools/delete-implementation-item.js";
 // Resources
 import { registerTicketResource } from "./resources/ticket-resource.js";
 import { registerProjectResource } from "./resources/project-resource.js";
@@ -59,6 +83,30 @@ async function main() {
     registerWhoami(server, api);
     registerAddRelation(server, api);
     registerRemoveRelation(server, api);
+    // Phase 2 — Skupina A: Workflow & Status Management
+    registerListStatuses(server, api);
+    registerListTransitions(server, api);
+    registerCreateStatus(server, api);
+    registerDeleteStatus(server, api);
+    registerApplyPreset(server, api);
+    // Phase 2 — Skupina B: Project Management
+    registerListProjects(server, api);
+    registerGetProject(server, api);
+    registerCreateProject(server, api);
+    // Phase 2 — Skupina C: Ticket Operations
+    registerDeleteTicket(server, api);
+    registerGetBoard(server, api);
+    registerGetMyTasks(server, api);
+    registerListComments(server, api);
+    // Phase 2 — Skupina D: Attachments
+    registerListAttachments(server, api);
+    registerDeleteAttachment(server, api);
+    // Phase 2 — Skupina E: Cycles & Epics CRUD
+    registerCreateCycle(server, api);
+    registerCreateEpic(server, api);
+    // Phase 2 — Skupina F: Implementation Items
+    registerCreateImplementationItem(server, api);
+    registerDeleteImplementationItem(server, api);
     // Registrace resources
     registerTicketResource(server, api);
     registerProjectResource(server, api);

package/dist/tools/apply-preset.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 registerApplyPreset(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=apply-preset.d.ts.map

package/dist/tools/apply-preset.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export function registerApplyPreset(server, api) {
+    server.tool("apply_preset", "Apply a workflow preset to a project (replaces current statuses and transitions)", {
+        project: z.string().describe("Project slug"),
+        preset_id: z.string().describe("Preset ID to apply"),
+    }, async (params) => {
+        try {
+            await api.post(`/api/projects/${params.project}/apply-preset`, { presetId: params.preset_id });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Preset "${params.preset_id}" applied to project ${params.project}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=apply-preset.js.map

package/dist/tools/complete-dev-task.js

@@ -5,12 +5,14 @@ export function registerCompleteDevTask(server, api) {
         summary: z.string().describe("Summary of what was done"),
         branch: z.string().optional().describe("Git branch name"),
         commit_hash: z.string().optional().describe("Last commit SHA"),
+        files_changed: z.array(z.string()).optional().describe("List of changed file paths"),
     }, async (params) => {
         try {
             await api.post(`/api/dev-queue/complete/${params.assignment_id}`, {
-                resultSummary: params.summary,
+                resultSummary: params.summary.replace(/\\n/g, "\n"),
                 branchName: params.branch ?? null,
                 commitHash: params.commit_hash ?? null,
+                filesChanged: params.files_changed ?? null,
             });
             return {
                 content: [

package/dist/tools/create-cycle.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 registerCreateCycle(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=create-cycle.d.ts.map

package/dist/tools/create-cycle.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+export function registerCreateCycle(server, api) {
+    server.tool("create_cycle", "Create a new cycle (sprint) in a project", {
+        project: z.string().describe("Project slug"),
+        name: z.string().describe("Cycle name"),
+        startDate: z.string().describe("Start date (ISO 8601, e.g. '2026-03-15')"),
+        endDate: z.string().describe("End date (ISO 8601, e.g. '2026-03-29')"),
+    }, async (params) => {
+        try {
+            const result = await api.post(`/api/projects/${params.project}/cycles`, {
+                name: params.name,
+                startDate: params.startDate,
+                endDate: params.endDate,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Created cycle #${result.number}${result.name ? ` "${result.name}"` : ""} (${result.id})`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=create-cycle.js.map

package/dist/tools/create-epic.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 registerCreateEpic(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=create-epic.d.ts.map

package/dist/tools/create-epic.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+export function registerCreateEpic(server, api) {
+    server.tool("create_epic", "Create a new epic in a project", {
+        project: z.string().describe("Project slug"),
+        name: z.string().describe("Epic name"),
+        description: z.string().optional().describe("Epic description"),
+        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)"),
+    }, async (params) => {
+        try {
+            const result = await api.post(`/api/projects/${params.project}/epics`, {
+                name: params.name,
+                description: params.description,
+                color: params.color,
+                startDate: params.start_date,
+                targetDate: params.target_date,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Created epic "${result.name}" (${result.id})`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=create-epic.js.map

package/dist/tools/create-implementation-item.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 registerCreateImplementationItem(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=create-implementation-item.d.ts.map

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

@@ -0,0 +1,32 @@
+import { z } from "zod";
+export function registerCreateImplementationItem(server, api) {
+    server.tool("create_implementation_item", "Add a new implementation item to a ticket", {
+        number: z.string().describe("Ticket display number, e.g. 'TKR-42' (legacy) or 'TKR-BUG-0042' (typed)"),
+        area: z.string().describe("Area: Database, API, Frontend, MCP, etc."),
+        fileOrDetail: z.string().describe("Specific file path or description of the work"),
+        note: z.string().optional().describe("Additional note"),
+    }, async (params) => {
+        try {
+            const result = await api.post(`/api/tickets/${params.number}/items`, {
+                area: params.area,
+                fileOrDetail: params.fileOrDetail,
+                note: params.note?.replace(/\\n/g, "\n"),
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Added implementation item "${result.area}: ${result.fileOrDetail}" to ${params.number}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=create-implementation-item.js.map

package/dist/tools/create-project.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 registerCreateProject(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=create-project.d.ts.map

package/dist/tools/create-project.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+export function registerCreateProject(server, api) {
+    server.tool("create_project", "Create a new project", {
+        name: z.string().describe("Project display name"),
+        slug: z.string().describe("URL-safe project slug (unique)"),
+        prefix: z.string().describe("Ticket prefix, e.g. 'VLX', 'TKR'"),
+        description: z.string().optional().describe("Project description"),
+    }, async (params) => {
+        try {
+            const result = await api.post("/api/projects", {
+                name: params.name,
+                slug: params.slug,
+                prefix: params.prefix,
+                description: params.description,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Created project "${result.name}" (${result.slug})`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=create-project.js.map

package/dist/tools/create-status.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 registerCreateStatus(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=create-status.d.ts.map

package/dist/tools/create-status.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+export function registerCreateStatus(server, api) {
+    server.tool("create_status", "Create a new workflow status in a project", {
+        project: z.string().describe("Project slug"),
+        name: z.string().describe("Status display name"),
+        slug: z.string().describe("Status slug (URL-safe identifier)"),
+        emoji: z.string().optional().describe("Emoji icon for the status"),
+        color: z.string().describe("Hex color code, e.g. '#3b82f6'"),
+        category: z.string().describe("Category: backlog, active, done, cancelled"),
+        sortOrder: z.number().describe("Sort order (0-based)"),
+        isDefault: z.boolean().optional().default(false).describe("Whether this is the default status for new tickets"),
+        isTerminal: z.boolean().optional().default(false).describe("Whether this is a terminal (closed) status"),
+    }, async (params) => {
+        try {
+            const result = await api.post(`/api/projects/${params.project}/statuses`, {
+                name: params.name,
+                slug: params.slug,
+                emoji: params.emoji,
+                color: params.color,
+                category: params.category,
+                sortOrder: params.sortOrder,
+                isDefault: params.isDefault,
+                isTerminal: params.isTerminal,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Created status "${result.name}" (${result.id})`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=create-status.js.map

package/dist/tools/delete-attachment.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 registerDeleteAttachment(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=delete-attachment.d.ts.map

package/dist/tools/delete-attachment.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export function registerDeleteAttachment(server, api) {
+    server.tool("delete_attachment", "Delete an attachment from a ticket", {
+        number: z.string().describe("Ticket display number, e.g. 'TKR-42' (legacy) or 'TKR-BUG-0042' (typed)"),
+        attachment_id: z.string().describe("Attachment ID to delete"),
+    }, async (params) => {
+        try {
+            await api.delete(`/api/tickets/${params.number}/attachments/${params.attachment_id}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Attachment ${params.attachment_id} deleted from ${params.number}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=delete-attachment.js.map

package/dist/tools/delete-implementation-item.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 registerDeleteImplementationItem(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=delete-implementation-item.d.ts.map

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

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export function registerDeleteImplementationItem(server, api) {
+    server.tool("delete_implementation_item", "Delete an implementation item from a ticket", {
+        number: z.string().describe("Ticket display number, e.g. 'TKR-42' (legacy) or 'TKR-BUG-0042' (typed)"),
+        item_id: z.string().describe("Implementation item ID to delete"),
+    }, async (params) => {
+        try {
+            await api.delete(`/api/tickets/${params.number}/items/${params.item_id}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Implementation item ${params.item_id} deleted from ${params.number}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=delete-implementation-item.js.map

package/dist/tools/delete-status.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 registerDeleteStatus(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=delete-status.d.ts.map

package/dist/tools/delete-status.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export function registerDeleteStatus(server, api) {
+    server.tool("delete_status", "Delete a workflow status from a project", {
+        project: z.string().describe("Project slug"),
+        status_id: z.string().describe("Status ID to delete"),
+    }, async (params) => {
+        try {
+            await api.delete(`/api/projects/${params.project}/statuses/${params.status_id}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Status ${params.status_id} deleted from project ${params.project}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=delete-status.js.map

package/dist/tools/delete-ticket.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 registerDeleteTicket(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=delete-ticket.d.ts.map

package/dist/tools/delete-ticket.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+export function registerDeleteTicket(server, api) {
+    server.tool("delete_ticket", "Delete a ticket by display number", {
+        number: z.string().describe("Ticket display number, e.g. 'TKR-42' (legacy) or 'TKR-BUG-0042' (typed)"),
+    }, async (params) => {
+        try {
+            await api.delete(`/api/tickets/${params.number}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Ticket ${params.number} deleted`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=delete-ticket.js.map

package/dist/tools/get-board.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 registerGetBoard(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=get-board.d.ts.map

package/dist/tools/get-board.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+export function registerGetBoard(server, api) {
+    server.tool("get_board", "Get kanban board view for a project (tickets grouped by status columns)", {
+        project: z.string().describe("Project slug"),
+    }, async (params) => {
+        try {
+            const columns = await api.get(`/api/projects/${params.project}/board`);
+            const lines = [];
+            for (const col of columns) {
+                const emoji = col.statusEmoji ? `${col.statusEmoji} ` : "";
+                lines.push(`## ${emoji}${col.status} (${col.tickets.length})`);
+                lines.push("");
+                if (col.tickets.length === 0) {
+                    lines.push("_No tickets_");
+                }
+                else {
+                    lines.push("| Ticket | Title | Priority | Assignee | Scope |");
+                    lines.push("|--------|-------|----------|----------|-------|");
+                    for (const t of col.tickets) {
+                        lines.push(`| ${t.displayNumber} | ${t.title} | ${t.priority} | ${t.assigneeName || "-"} | ${t.scope || "-"} |`);
+                    }
+                }
+                lines.push("");
+            }
+            return {
+                content: [{ type: "text", text: lines.join("\n") || "Board is empty." }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-board.js.map

package/dist/tools/get-my-tasks.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 registerGetMyTasks(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=get-my-tasks.d.ts.map

package/dist/tools/get-my-tasks.js

@@ -0,0 +1,20 @@
+export function registerGetMyTasks(server, api) {
+    server.tool("get_my_tasks", "Get tickets assigned to the current user across all projects", {}, async () => {
+        try {
+            const tickets = await api.get("/api/my-tasks");
+            const text = tickets
+                .map((t) => `${t.displayNumber} [${t.status}] ${t.title} (${t.priority}, ${t.scope || "-"})`)
+                .join("\n");
+            return {
+                content: [{ type: "text", text: text || "No tasks assigned to you." }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-my-tasks.js.map

package/dist/tools/get-project.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 registerGetProject(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=get-project.d.ts.map

package/dist/tools/get-project.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import { formatProjectMarkdown } from "../formatters.js";
+export function registerGetProject(server, api) {
+    server.tool("get_project", "Get project detail by slug", {
+        slug: z.string().describe("Project slug, e.g. 'tickr'"),
+    }, async (params) => {
+        try {
+            const project = await api.get(`/api/projects/${params.slug}`);
+            const md = formatProjectMarkdown(project);
+            return { content: [{ type: "text", text: md }] };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-project.js.map

package/dist/tools/list-attachments.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 registerListAttachments(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=list-attachments.d.ts.map

package/dist/tools/list-attachments.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+export function registerListAttachments(server, api) {
+    server.tool("list_attachments", "List attachments on a ticket", {
+        number: z.string().describe("Ticket display number, e.g. 'TKR-42' (legacy) or 'TKR-BUG-0042' (typed)"),
+    }, async (params) => {
+        try {
+            const attachments = await api.get(`/api/tickets/${params.number}/attachments`);
+            if (attachments.length === 0) {
+                return {
+                    content: [{ type: "text", text: "No attachments on this ticket." }],
+                };
+            }
+            const lines = [
+                "| # | File | Type | Size | Uploaded By | Date |",
+                "|---|------|------|------|-------------|------|",
+                ...attachments.map((a, i) => `| ${i + 1} | ${a.fileName} | ${a.contentType} | ${formatSize(a.size)} | ${a.createdByName || "-"} | ${a.createdAt} |`),
+            ];
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+//# sourceMappingURL=list-attachments.js.map

package/dist/tools/list-comments.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 registerListComments(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=list-comments.d.ts.map

package/dist/tools/list-comments.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+export function registerListComments(server, api) {
+    server.tool("list_comments", "List comments on a ticket", {
+        number: z.string().describe("Ticket display number, e.g. 'TKR-42' (legacy) or 'TKR-BUG-0042' (typed)"),
+    }, async (params) => {
+        try {
+            const comments = await api.get(`/api/tickets/${params.number}/comments`);
+            if (comments.length === 0) {
+                return {
+                    content: [{ type: "text", text: "No comments on this ticket." }],
+                };
+            }
+            const lines = [];
+            for (const c of comments) {
+                lines.push(`**${c.authorName}** (${c.createdAt}):`);
+                lines.push(c.text);
+                lines.push("");
+            }
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=list-comments.js.map

package/dist/tools/list-projects.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 registerListProjects(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=list-projects.d.ts.map

package/dist/tools/list-projects.js

@@ -0,0 +1,22 @@
+export function registerListProjects(server, api) {
+    server.tool("list_projects", "List all projects accessible to the current user", {}, async () => {
+        try {
+            const projects = await api.get("/api/projects");
+            const lines = [
+                "| Name | Slug | Prefix | Scope Tags | Ticket Types |",
+                "|------|------|--------|------------|--------------|",
+                ...projects.map((p) => `| ${p.name} | ${p.slug} | ${p.prefix} | ${p.scopeTags?.join(", ") || "-"} | ${p.ticketTypes?.join(", ") || "-"} |`),
+            ];
+            return {
+                content: [{ type: "text", text: lines.join("\n") || "No projects found." }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=list-projects.js.map

package/dist/tools/list-statuses.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 registerListStatuses(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=list-statuses.d.ts.map

package/dist/tools/list-statuses.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+export function registerListStatuses(server, api) {
+    server.tool("list_statuses", "List workflow statuses for a project", {
+        project: z.string().describe("Project slug"),
+    }, async (params) => {
+        try {
+            const statuses = await api.get(`/api/projects/${params.project}/statuses`);
+            const lines = [
+                "| # | Name | Slug | Emoji | Color | Category | Default | Terminal |",
+                "|---|------|------|-------|-------|----------|---------|----------|",
+                ...statuses.map((s, i) => `| ${i + 1} | ${s.name} | ${s.slug} | ${s.emoji || "-"} | ${s.color} | ${s.category} | ${s.isDefault ? "Yes" : "No"} | ${s.isTerminal ? "Yes" : "No"} |`),
+            ];
+            return {
+                content: [{ type: "text", text: lines.join("\n") || "No statuses found." }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=list-statuses.js.map

package/dist/tools/list-transitions.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 registerListTransitions(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=list-transitions.d.ts.map

package/dist/tools/list-transitions.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+export function registerListTransitions(server, api) {
+    server.tool("list_transitions", "List workflow transitions for a project", {
+        project: z.string().describe("Project slug"),
+    }, async (params) => {
+        try {
+            const transitions = await api.get(`/api/projects/${params.project}/transitions`);
+            const lines = [
+                "| # | From | To | Allowed Roles |",
+                "|---|------|----|---------------|",
+                ...transitions.map((t, i) => `| ${i + 1} | ${t.fromStatusName} | ${t.toStatusName} | ${t.allowedRoles?.join(", ") || "-"} |`),
+            ];
+            return {
+                content: [{ type: "text", text: lines.join("\n") || "No transitions found." }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=list-transitions.js.map

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

@@ -11,7 +11,7 @@ export function registerUpdateImplementationItem(server, api) {
         try {
             await api.patch(`/api/tickets/${params.number}/items/${params.item_index}`, {
                 status: params.status,
-                note: params.note,
+                note: params.note?.replace(/\\n/g, "\n"),
             });
             return {
                 content: [

package/package.json

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