@k-system/tickr-mcp 0.4.0 → 0.5.0

package/dist/server.js

@@ -76,6 +76,15 @@ import { registerListProjectMembers } from "./tools/list-project-members.js";
 import { registerAddProjectMember } from "./tools/add-project-member.js";
 import { registerUpdateProjectMemberRole } from "./tools/update-project-member-role.js";
 import { registerRemoveProjectMember } from "./tools/remove-project-member.js";
+// ADR-0030: Releases
+import { registerCreateRelease } from "./tools/create-release.js";
+import { registerGetRelease } from "./tools/get-release.js";
+import { registerListReleases } from "./tools/list-releases.js";
+import { registerUpdateRelease } from "./tools/update-release.js";
+import { registerPublishRelease } from "./tools/publish-release.js";
+import { registerAddReleaseTicket } from "./tools/add-release-ticket.js";
+import { registerRemoveReleaseTicket } from "./tools/remove-release-ticket.js";
+import { registerGenerateReleaseNotes } from "./tools/generate-release-notes.js";
 // Resources
 import { registerTicketResource } from "./resources/ticket-resource.js";
 import { registerProjectResource } from "./resources/project-resource.js";
@@ -160,6 +169,15 @@ export async function startServer() {
     registerAddProjectMember(server, api);
     registerUpdateProjectMemberRole(server, api);
     registerRemoveProjectMember(server, api);
+    // ADR-0030: Releases
+    registerCreateRelease(server, api);
+    registerGetRelease(server, api);
+    registerListReleases(server, api);
+    registerUpdateRelease(server, api);
+    registerPublishRelease(server, api);
+    registerAddReleaseTicket(server, api);
+    registerRemoveReleaseTicket(server, api);
+    registerGenerateReleaseNotes(server, api);
     // Registrace resources
     registerTicketResource(server, api);
     registerProjectResource(server, api);

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

package/dist/tools/add-release-ticket.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+export function registerAddReleaseTicket(server, api) {
+    server.tool("add_release_ticket", "Link a ticket to a release", {
+        project: z.string().describe("Project slug"),
+        release_id: z.string().describe("UUID of the release"),
+        ticket_number: z.string().describe("Ticket display number, e.g. 'TKR-42' or 'TKR-BUG-0042'"),
+    }, async (params) => {
+        try {
+            await api.post(`/api/projects/${params.project}/releases/${params.release_id}/tickets`, { ticketNumber: params.ticket_number });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Ticket ${params.ticket_number} added to release ${params.release_id}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=add-release-ticket.js.map

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

package/dist/tools/create-release.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+export function registerCreateRelease(server, api) {
+    server.tool("create_release", "Create a new release in a project", {
+        project: z.string().describe("Project slug, e.g. 'tickr'"),
+        version: z.string().describe("Semantic version, e.g. '1.6.0'"),
+        name: z.string().optional().describe("Human-readable release name"),
+        git_tag: z.string().optional().describe("Git tag name, e.g. 'v1.6.0'"),
+        cycle_id: z.string().optional().describe("UUID of linked cycle (sprint)"),
+    }, async (params) => {
+        try {
+            const result = await api.post(`/api/projects/${params.project}/releases`, {
+                version: params.version,
+                name: params.name,
+                gitTag: params.git_tag,
+                cycleId: params.cycle_id,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Created release ${result.version} (id: ${result.id})`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=create-release.js.map

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

package/dist/tools/generate-release-notes.js

@@ -0,0 +1,66 @@
+import { z } from "zod";
+export function registerGenerateReleaseNotes(server, api) {
+    server.tool("generate_release_notes", "Generate markdown release notes from linked tickets (client-side generation)", {
+        project: z.string().describe("Project slug"),
+        release_id: z.string().describe("UUID of the release"),
+    }, async (params) => {
+        try {
+            const r = await api.get(`/api/projects/${params.project}/releases/${params.release_id}`);
+            const lines = [
+                `# Release ${r.version}${r.name ? ` — ${r.name}` : ""}`,
+                "",
+            ];
+            if (!r.tickets?.length) {
+                lines.push("No tickets linked to this release.");
+                return {
+                    content: [{ type: "text", text: lines.join("\n") }],
+                };
+            }
+            // Seskupit tickety podle typu
+            const grouped = {};
+            for (const t of r.tickets) {
+                const key = t.type.toLowerCase();
+                if (!grouped[key])
+                    grouped[key] = [];
+                grouped[key].push(t);
+            }
+            // Pořadí sekcí a labely
+            const sectionOrder = [
+                ["feature", "Features"],
+                ["adr", "Architecture Decisions"],
+                ["bug", "Bug Fixes"],
+                ["task", "Tasks"],
+            ];
+            for (const [typeKey, sectionTitle] of sectionOrder) {
+                const tickets = grouped[typeKey];
+                if (!tickets?.length)
+                    continue;
+                lines.push(`## ${sectionTitle}`, "");
+                for (const t of tickets) {
+                    lines.push(`- **${t.displayNumber}** ${t.title}`);
+                }
+                lines.push("");
+            }
+            // Ostatní typy, které nejsou ve standardním pořadí
+            for (const [typeKey, tickets] of Object.entries(grouped)) {
+                if (sectionOrder.some(([k]) => k === typeKey))
+                    continue;
+                lines.push(`## ${typeKey.charAt(0).toUpperCase() + typeKey.slice(1)}`, "");
+                for (const t of tickets) {
+                    lines.push(`- **${t.displayNumber}** ${t.title}`);
+                }
+                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=generate-release-notes.js.map

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

package/dist/tools/get-release.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+export function registerGetRelease(server, api) {
+    server.tool("get_release", "Get full release detail including linked tickets", {
+        project: z.string().describe("Project slug"),
+        release_id: z.string().describe("UUID of the release"),
+    }, async (params) => {
+        try {
+            const r = await api.get(`/api/projects/${params.project}/releases/${params.release_id}`);
+            const lines = [
+                `# Release ${r.version}${r.name ? ` — ${r.name}` : ""}`,
+                "",
+                `| Field | Value |`,
+                `|-------|-------|`,
+                `| Id | ${r.id} |`,
+                `| Status | ${r.status} |`,
+                `| Git Tag | ${r.gitTag || "-"} |`,
+                `| Published | ${r.publishedAt || "-"} |`,
+                `| Created | ${r.createdAt} |`,
+                `| Updated | ${r.updatedAt} |`,
+            ];
+            if (r.notes) {
+                lines.push("", "## Notes", "", r.notes);
+            }
+            if (r.tickets?.length > 0) {
+                lines.push("", "## Tickets", "", "| Number | Type | Title | Status |", "|--------|------|-------|--------|");
+                for (const t of r.tickets) {
+                    lines.push(`| ${t.displayNumber} | ${t.type} | ${t.title} | ${t.status} |`);
+                }
+            }
+            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=get-release.js.map

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

package/dist/tools/list-releases.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+export function registerListReleases(server, api) {
+    server.tool("list_releases", "List releases in a project with optional status filter", {
+        project: z.string().describe("Project slug"),
+        status: z.string().optional().describe("Filter by status: draft, published, archived"),
+    }, async (params) => {
+        try {
+            const qs = new URLSearchParams();
+            if (params.status)
+                qs.set("status", params.status);
+            const qsStr = qs.toString();
+            const path = `/api/projects/${params.project}/releases${qsStr ? `?${qsStr}` : ""}`;
+            const releases = await api.get(path);
+            if (!releases.length) {
+                return {
+                    content: [{ type: "text", text: "No releases found." }],
+                };
+            }
+            const lines = [
+                "| Version | Name | Status | Tag | Tickets | Published | Created |",
+                "|---------|------|--------|-----|---------|-----------|---------|",
+            ];
+            for (const r of releases) {
+                lines.push(`| ${r.version} | ${r.name || "-"} | ${r.status} | ${r.gitTag || "-"} | ${r.ticketCount} | ${r.publishedAt || "-"} | ${r.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,
+            };
+        }
+    });
+}
+//# sourceMappingURL=list-releases.js.map

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

package/dist/tools/publish-release.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export function registerPublishRelease(server, api) {
+    server.tool("publish_release", "Publish a draft release — sets status to published and records publishedAt timestamp", {
+        project: z.string().describe("Project slug"),
+        release_id: z.string().describe("UUID of the release to publish"),
+    }, async (params) => {
+        try {
+            await api.post(`/api/projects/${params.project}/releases/${params.release_id}/publish`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Release ${params.release_id} published in project ${params.project}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=publish-release.js.map

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

package/dist/tools/remove-release-ticket.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+export function registerRemoveReleaseTicket(server, api) {
+    server.tool("remove_release_ticket", "Remove a ticket from a release", {
+        project: z.string().describe("Project slug"),
+        release_id: z.string().describe("UUID of the release"),
+        ticket_id: z.string().describe("UUID of the ticket to remove from the release"),
+    }, async (params) => {
+        try {
+            await api.delete(`/api/projects/${params.project}/releases/${params.release_id}/tickets/${params.ticket_id}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Ticket ${params.ticket_id} removed from release ${params.release_id}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=remove-release-ticket.js.map

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

package/dist/tools/update-release.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+export function registerUpdateRelease(server, api) {
+    server.tool("update_release", "Update a release (name, notes, status)", {
+        project: z.string().describe("Project slug"),
+        release_id: z.string().describe("UUID of the release to update"),
+        name: z.string().optional().describe("New release name"),
+        notes: z.string().optional().describe("Release notes (markdown)"),
+        status: z.string().optional().describe("New status: draft, published, archived"),
+    }, async (params) => {
+        try {
+            const body = {};
+            if (params.name !== undefined)
+                body.name = params.name;
+            if (params.notes !== undefined)
+                body.notes = params.notes?.replace(/\\n/g, "\n");
+            if (params.status !== undefined)
+                body.status = params.status;
+            await api.put(`/api/projects/${params.project}/releases/${params.release_id}`, body);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Release ${params.release_id} updated in project ${params.project}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=update-release.js.map

package/package.json

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