@klority/mcp-server 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,97 @@
1
+ import { z } from "zod";
2
+ export function registerPrompts(server, client) {
3
+ // 1. Implement Story Workflow
4
+ server.prompt("implement-story", "Prepare comprehensive implementation context for an assigned Klority task, user story, or bug ticket.", {
5
+ taskId: z.string().describe("Task UUID or custom key (e.g., KLOR-104)")
6
+ }, async ({ taskId }) => {
7
+ try {
8
+ const task = await client.getTask(taskId);
9
+ const key = task.customId || task.id;
10
+ return {
11
+ messages: [
12
+ {
13
+ role: "user",
14
+ content: {
15
+ type: "text",
16
+ text: `You are implementing the following Klority task:
17
+
18
+ Title: [${key}] ${task.title}
19
+ Type: ${task.type || "Story"} | Priority: ${task.priority || "Normal"}
20
+
21
+ Requirements & Acceptance Criteria:
22
+ ${task.description || "No description provided."}
23
+
24
+ Instructions:
25
+ 1. Examine the requirements carefully and check for edge cases or ambiguities.
26
+ 2. If specifications mention Wiki PRDs or QA criteria, use \`klority_search_wiki\` or \`klority_get_qa_criteria\` to pull additional architectural constraints.
27
+ 3. Write production-ready code fulfilling 100% of the acceptance criteria.
28
+ 4. Generate corresponding unit/integration test suites.
29
+ 5. Once complete, call \`klority_update_task_status\` or \`klority_add_task_comment\` to log your implementation summary.`
30
+ }
31
+ }
32
+ ]
33
+ };
34
+ }
35
+ catch (err) {
36
+ return {
37
+ messages: [
38
+ {
39
+ role: "user",
40
+ content: {
41
+ type: "text",
42
+ text: `Could not load task ${taskId}: ${err.message}`
43
+ }
44
+ }
45
+ ]
46
+ };
47
+ }
48
+ });
49
+ // 2. Generate Acceptance Tests Prompt
50
+ server.prompt("generate-acceptance-tests", "Generate automated test suites (Playwright / Jest) based on Klority QA test cases and criteria.", {
51
+ taskIdOrQuery: z.string().describe("Task key or search keyword for feature acceptance criteria")
52
+ }, async ({ taskIdOrQuery }) => {
53
+ return {
54
+ messages: [
55
+ {
56
+ role: "user",
57
+ content: {
58
+ type: "text",
59
+ text: `Please generate an automated test suite for "${taskIdOrQuery}".
60
+
61
+ Steps:
62
+ 1. Use \`klority_get_qa_criteria\` with query "${taskIdOrQuery}" to fetch defined test cases, steps, preconditions, and expected results.
63
+ 2. Write clean, idiomatic test suites (e.g. Playwright E2E or Jest unit tests) mapping 1:1 with each Klority test case.
64
+ 3. Ensure every test has descriptive names matching Klority Test Case IDs.
65
+ 4. After executing tests locally, format the results so they can be recorded via \`klority_record_test_runs\`.`
66
+ }
67
+ }
68
+ ]
69
+ };
70
+ });
71
+ // 3. Sprint Standup Summary
72
+ server.prompt("sprint-standup-summary", "Generate a concise, professional engineering standup summary for the active sprint in a project.", {
73
+ projectId: z.string().describe("Project UUID or Project Key")
74
+ }, async ({ projectId }) => {
75
+ return {
76
+ messages: [
77
+ {
78
+ role: "user",
79
+ content: {
80
+ type: "text",
81
+ text: `Generate a daily standup summary for project ${projectId}.
82
+
83
+ Steps:
84
+ 1. Call \`klority_search_tasks\` for project "${projectId}".
85
+ 2. Group the tasks into:
86
+ - ✅ Completed (Done)
87
+ - 🚧 In Progress
88
+ - ⏳ Blocked / Needs Attention
89
+ - 📋 Up Next / Backlog
90
+ 3. Format as a clean bulleted Markdown update suitable for Slack or team email.`
91
+ }
92
+ }
93
+ ]
94
+ };
95
+ });
96
+ }
97
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,eAAe,CAAC,MAAiB,EAAE,MAAqB;IACtE,8BAA8B;IAC9B,MAAM,CAAC,MAAM,CACX,iBAAiB,EACjB,uGAAuG,EACvG;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;KACxE,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC;YAErC,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE;4BACP,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE;;UAEZ,GAAG,KAAK,IAAI,CAAC,KAAK;QACpB,IAAI,CAAC,IAAI,IAAI,OAAO,gBAAgB,IAAI,CAAC,QAAQ,IAAI,QAAQ;;;EAGnE,IAAI,CAAC,WAAW,IAAI,0BAA0B;;;;;;;0HAO0E;yBAC3G;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE;4BACP,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,uBAAuB,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE;yBACtD;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,sCAAsC;IACtC,MAAM,CAAC,MAAM,CACX,2BAA2B,EAC3B,iGAAiG,EACjG;QACE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;KACjG,EACD,KAAK,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE;QAC1B,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,gDAAgD,aAAa;;;iDAGhC,aAAa;;;+GAGiD;qBAClG;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,4BAA4B;IAC5B,MAAM,CAAC,MAAM,CACX,wBAAwB,EACxB,kGAAkG,EAClG;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;KAC9D,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACtB,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,gDAAgD,SAAS;;;gDAG7B,SAAS;;;;;;gFAMuB;qBACnE;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,4 @@
1
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import { KlorityClient } from "../client.js";
3
+ export declare function registerResources(server: McpServer, client: KlorityClient): void;
4
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,QAgGzE"}
@@ -0,0 +1,86 @@
1
+ import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ export function registerResources(server, client) {
3
+ // 1. Workspace Summary Resource (Fixed URI)
4
+ server.resource("klority_workspace_summary", "klority://workspace/overview", async (uri) => {
5
+ try {
6
+ const auth = await client.verifyAuth();
7
+ const content = [
8
+ `# Workspace: ${auth.workspace.name} (${auth.workspace.slug})`,
9
+ `**User**: ${auth.user.name} (${auth.user.email})`,
10
+ `\n### Accessible Projects (${auth.projects.length})`,
11
+ auth.projects.map((p) => `- **[${p.key}]** ${p.name} (ID: \`${p.id}\`)`).join("\n")
12
+ ].join("\n");
13
+ return {
14
+ contents: [{
15
+ uri: uri.href,
16
+ mimeType: "text/markdown",
17
+ text: content
18
+ }]
19
+ };
20
+ }
21
+ catch (err) {
22
+ return {
23
+ contents: [{
24
+ uri: uri.href,
25
+ mimeType: "text/plain",
26
+ text: `Failed to load workspace overview: ${err.message}`
27
+ }]
28
+ };
29
+ }
30
+ });
31
+ // 2. Task Details Resource Template
32
+ const taskTemplate = new ResourceTemplate("klority://tasks/{taskId}", { list: undefined });
33
+ server.resource("klority_task_resource", taskTemplate, async (uri, { taskId }) => {
34
+ try {
35
+ const task = await client.getTask(String(taskId));
36
+ const key = task.customId || task.id;
37
+ const text = [
38
+ `# [${key}] ${task.title}`,
39
+ `**Type**: ${task.type || "Task"} | **Priority**: ${task.priority || "Normal"}`,
40
+ `**ID**: \`${task.id}\``,
41
+ `\n### Description`,
42
+ task.description || "*(No description provided)*"
43
+ ].join("\n");
44
+ return {
45
+ contents: [{
46
+ uri: uri.href,
47
+ mimeType: "text/markdown",
48
+ text
49
+ }]
50
+ };
51
+ }
52
+ catch (err) {
53
+ return {
54
+ contents: [{
55
+ uri: uri.href,
56
+ mimeType: "text/plain",
57
+ text: `Failed to load task ${taskId}: ${err.message}`
58
+ }]
59
+ };
60
+ }
61
+ });
62
+ // 3. Wiki Page Resource Template
63
+ const pageTemplate = new ResourceTemplate("klority://pages/{pageId}", { list: undefined });
64
+ server.resource("klority_page_resource", pageTemplate, async (uri, { pageId }) => {
65
+ try {
66
+ const page = await client.getPage(String(pageId));
67
+ return {
68
+ contents: [{
69
+ uri: uri.href,
70
+ mimeType: "text/markdown",
71
+ text: `# ${page.title}\n\n${page.content || "*(empty document)*"}`
72
+ }]
73
+ };
74
+ }
75
+ catch (err) {
76
+ return {
77
+ contents: [{
78
+ uri: uri.href,
79
+ mimeType: "text/plain",
80
+ text: `Failed to load page ${pageId}: ${err.message}`
81
+ }]
82
+ };
83
+ }
84
+ });
85
+ }
86
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import { KlorityClient } from "../client.js";
3
+ export declare function registerCRMTools(server: McpServer, client: KlorityClient): void;
4
+ //# sourceMappingURL=crm.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"crm.d.ts","sourceRoot":"","sources":["../../src/tools/crm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,QAqCxE"}
@@ -0,0 +1,32 @@
1
+ import { z } from "zod";
2
+ export function registerCRMTools(server, client) {
3
+ server.tool("klority_search_crm", "Search customer CRM accounts, deals in pipeline, or contacts in Klority for commercial and client context.", {
4
+ query: z.string().describe("Company name, contact name, or deal title to search"),
5
+ entity: z.enum(["deal", "company", "contact"]).optional().describe("Filter by entity type (default: all)")
6
+ }, async ({ query, entity }) => {
7
+ try {
8
+ const res = await client.searchCRM(query, entity);
9
+ if (!res.results || res.results.length === 0) {
10
+ return {
11
+ content: [{ type: "text", text: `No CRM records found matching "${query}".` }]
12
+ };
13
+ }
14
+ const formatted = res.results.map((r) => `- **[${r.type.toUpperCase()}] ${r.name || r.title}**\n *ID*: \`${r.id}\`${r.stage ? ` | *Stage*: ${r.stage}` : ""}${r.value ? ` | *Value*: $${r.value}` : ""}${r.email ? ` | *Email*: ${r.email}` : ""}`).join("\n\n");
15
+ return {
16
+ content: [
17
+ {
18
+ type: "text",
19
+ text: `### Found ${res.results.length} CRM Record(s):\n\n${formatted}`
20
+ }
21
+ ]
22
+ };
23
+ }
24
+ catch (err) {
25
+ return {
26
+ isError: true,
27
+ content: [{ type: "text", text: `Error searching CRM: ${err.message}` }]
28
+ };
29
+ }
30
+ });
31
+ }
32
+ //# sourceMappingURL=crm.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"crm.js","sourceRoot":"","sources":["../../src/tools/crm.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,MAAqB;IACvE,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,4GAA4G,EAC5G;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;QACjF,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;KAC3G,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAClD,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7C,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kCAAkC,KAAK,IAAI,EAAE,CAAC;iBAC/E,CAAC;YACJ,CAAC;YAED,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAC3C,QAAQ,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,iBAAiB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3M,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAEf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,aAAa,GAAG,CAAC,OAAO,CAAC,MAAM,sBAAsB,SAAS,EAAE;qBACvE;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;aACzE,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,4 @@
1
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import { KlorityClient } from "../client.js";
3
+ export declare function registerQATools(server: McpServer, client: KlorityClient): void;
4
+ //# sourceMappingURL=qa.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"qa.d.ts","sourceRoot":"","sources":["../../src/tools/qa.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,QAoHvE"}
@@ -0,0 +1,102 @@
1
+ import { z } from "zod";
2
+ export function registerQATools(server, client) {
3
+ // 1. Get QA Test Cases and Acceptance Criteria
4
+ server.tool("klority_get_qa_criteria", "Fetch QA test cases, acceptance criteria, preconditions, and execution steps to generate matching test suites (Jest, Playwright, Vitest).", {
5
+ query: z.string().optional().describe("Search term, module name, or task reference"),
6
+ projectId: z.string().optional().describe("Filter by Project UUID")
7
+ }, async ({ query, projectId }) => {
8
+ try {
9
+ const res = await client.getQACriteria({ query, projectId });
10
+ if (!res.testCases || res.testCases.length === 0) {
11
+ return {
12
+ content: [{ type: "text", text: `No test cases found${query ? ` matching "${query}"` : ""}.` }]
13
+ };
14
+ }
15
+ const casesFormatted = res.testCases.map(tc => {
16
+ const key = tc.customId || tc.id.slice(0, 8);
17
+ let stepsText = "";
18
+ if (Array.isArray(tc.steps) && tc.steps.length > 0) {
19
+ stepsText = "\n *Steps*:\n" + tc.steps.map((s, idx) => ` ${idx + 1}. ${s.step || s.action} ➔ Expected: ${s.expected || s.result}`).join("\n");
20
+ }
21
+ return `- **[${key}] ${tc.title}**\n *Status*: \`${tc.status}\` | *Priority*: ${tc.priority} | *Validation*: ${tc.validationType || "Functional"}\n *ID*: \`${tc.id}\`${tc.preconditions ? `\n *Preconditions*: ${tc.preconditions}` : ""}${stepsText}${tc.expectedResult ? `\n *Overall Expected*: ${tc.expectedResult}` : ""}`;
22
+ }).join("\n\n");
23
+ return {
24
+ content: [
25
+ {
26
+ type: "text",
27
+ text: `### Found ${res.testCases.length} Test Case(s):\n\n${casesFormatted}`
28
+ }
29
+ ]
30
+ };
31
+ }
32
+ catch (err) {
33
+ return {
34
+ isError: true,
35
+ content: [{ type: "text", text: `Error fetching QA criteria: ${err.message}` }]
36
+ };
37
+ }
38
+ });
39
+ // 2. Create Test Case
40
+ server.tool("klority_create_test_case", "Define a formal test case in the Klority QA repository with preconditions, execution steps, and expected results.", {
41
+ projectId: z.string().describe("Project UUID"),
42
+ moduleId: z.string().optional().describe("Module UUID within the QA repository"),
43
+ title: z.string().min(1).describe("Test case title"),
44
+ description: z.string().optional().describe("Objective and scope of the test case"),
45
+ priority: z.enum(["Low", "Medium", "High", "Critical"]).default("Medium"),
46
+ preconditions: z.string().optional().describe("System state or environment setup required before testing"),
47
+ steps: z.array(z.object({
48
+ step: z.string().describe("Action to perform"),
49
+ expected: z.string().describe("Expected outcome of this step")
50
+ })).optional().describe("Ordered array of step-by-step instructions")
51
+ }, async (args) => {
52
+ try {
53
+ const created = await client.createTestCase(args);
54
+ const key = created.customId || created.id;
55
+ return {
56
+ content: [
57
+ {
58
+ type: "text",
59
+ text: `✅ **Test Case Created!**\n- **Key**: ${key}\n- **Title**: ${created.title}\n- **ID**: \`${created.id}\``
60
+ }
61
+ ]
62
+ };
63
+ }
64
+ catch (err) {
65
+ return {
66
+ isError: true,
67
+ content: [{ type: "text", text: `Error creating test case: ${err.message}` }]
68
+ };
69
+ }
70
+ });
71
+ // 3. Record Test Execution Runs
72
+ server.tool("klority_record_test_runs", "Ingest automated or manual test execution results (Passed, Failed, Blocked) directly into Klority QA test cycles.", {
73
+ projectId: z.string().describe("Project UUID"),
74
+ testCycleName: z.string().default("MCP Automated Run").describe("Name for the test cycle in Klority"),
75
+ testCycleId: z.string().optional().describe("Existing Test Cycle UUID to append runs to"),
76
+ results: z.array(z.object({
77
+ testCaseId: z.string().describe("Test Case UUID"),
78
+ status: z.enum(["Passed", "Failed", "Blocked"]).describe("Test outcome"),
79
+ executionTimeMs: z.number().optional().describe("Execution duration in milliseconds"),
80
+ comment: z.string().optional().describe("Execution log or failure stack trace")
81
+ })).min(1).describe("Array of test results to record")
82
+ }, async (args) => {
83
+ try {
84
+ const res = await client.recordTestRuns(args);
85
+ return {
86
+ content: [
87
+ {
88
+ type: "text",
89
+ text: `✅ **Recorded ${res.runsRecorded} Test Run(s) in Klority!**\n- **Cycle ID**: \`${res.testCycleId}\``
90
+ }
91
+ ]
92
+ };
93
+ }
94
+ catch (err) {
95
+ return {
96
+ isError: true,
97
+ content: [{ type: "text", text: `Error recording test runs: ${err.message}` }]
98
+ };
99
+ }
100
+ });
101
+ }
102
+ //# sourceMappingURL=qa.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"qa.js","sourceRoot":"","sources":["../../src/tools/qa.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import { KlorityClient } from "../client.js";
3
+ export declare function registerTaskTools(server: McpServer, client: KlorityClient): void;
4
+ //# sourceMappingURL=tasks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/tools/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,QA6MzE"}
@@ -0,0 +1,172 @@
1
+ import { z } from "zod";
2
+ export function registerTaskTools(server, client) {
3
+ // 1. Search Tasks
4
+ server.tool("klority_search_tasks", "Search and filter Agile tasks, user stories, and bugs in Klority by keyword, project, or sprint.", {
5
+ query: z.string().optional().describe("Search keywords for task title or description"),
6
+ projectId: z.string().optional().describe("Filter by specific Project ID or UUID"),
7
+ sprintId: z.string().optional().describe("Filter by Sprint ID (e.g., active sprint)"),
8
+ limit: z.number().min(1).max(100).default(25).describe("Maximum number of tasks to return (default: 25)")
9
+ }, async ({ query, projectId, sprintId, limit }) => {
10
+ try {
11
+ const res = await client.searchTasks({ query, projectId, sprintId, limit });
12
+ if (!res.tasks || res.tasks.length === 0) {
13
+ return {
14
+ content: [{ type: "text", text: "No matching tasks found." }]
15
+ };
16
+ }
17
+ const taskSummaries = res.tasks.map(t => {
18
+ const key = t.customId || t.id.slice(0, 8);
19
+ return `- **[${key}]** ${t.title}\n *Type*: ${t.type || "Task"} | *Priority*: ${t.priority || "Medium"} | *ID*: \`${t.id}\``;
20
+ }).join("\n\n");
21
+ return {
22
+ content: [
23
+ {
24
+ type: "text",
25
+ text: `### Found ${res.tasks.length} task(s):\n\n${taskSummaries}`
26
+ }
27
+ ]
28
+ };
29
+ }
30
+ catch (err) {
31
+ return {
32
+ isError: true,
33
+ content: [{ type: "text", text: `Error searching tasks: ${err.message}` }]
34
+ };
35
+ }
36
+ });
37
+ // 2. Get Task Details
38
+ server.tool("klority_get_task", "Get full details, description, acceptance criteria, comments, and status for a specific Klority task by ID or custom key (e.g. KLOR-104).", {
39
+ taskId: z.string().describe("Task UUID or custom ticket identifier (e.g. KLOR-104)")
40
+ }, async ({ taskId }) => {
41
+ try {
42
+ const task = await client.getTask(taskId);
43
+ const key = task.customId || task.id;
44
+ const details = [
45
+ `# [${key}] ${task.title}`,
46
+ `**Type**: ${task.type || "Task"} | **Priority**: ${task.priority || "Normal"} | **Sprint**: ${task.sprintId || "Backlog"}`,
47
+ `**ID**: \`${task.id}\``,
48
+ `\n### Description`,
49
+ task.description || "*(No description provided)*",
50
+ task.labels && task.labels.length > 0 ? `\n**Labels**: ${task.labels.join(", ")}` : "",
51
+ task.comments && task.comments.length > 0
52
+ ? `\n### Recent Comments (${task.comments.length})\n` + task.comments.map(c => `> **${c.authorName || "User"}** (${new Date(c.createdAt).toLocaleDateString()}):\n> ${c.content}`).join("\n\n")
53
+ : ""
54
+ ].filter(Boolean).join("\n");
55
+ return {
56
+ content: [{ type: "text", text: details }]
57
+ };
58
+ }
59
+ catch (err) {
60
+ return {
61
+ isError: true,
62
+ content: [{ type: "text", text: `Error retrieving task ${taskId}: ${err.message}` }]
63
+ };
64
+ }
65
+ });
66
+ // 3. Create Task
67
+ server.tool("klority_create_task", "Create a new task, story, or bug in Klority directly on the project backlog or current sprint.", {
68
+ projectId: z.string().describe("Project UUID or project key where task should be created"),
69
+ title: z.string().min(1).describe("Task title / summary"),
70
+ description: z.string().describe("Detailed description, markdown content, or acceptance criteria"),
71
+ type: z.enum(["Story", "Task", "Bug", "Epic"]).default("Task").describe("Issue type"),
72
+ priority: z.enum(["Low", "Normal", "High", "Urgent"]).default("Normal").describe("Task priority"),
73
+ sprintId: z.string().optional().describe("Sprint UUID to assign directly into a sprint"),
74
+ labels: z.array(z.string()).optional().describe("Tags / labels for the task")
75
+ }, async (args) => {
76
+ try {
77
+ const created = await client.createTask(args);
78
+ const key = created.customId || created.id;
79
+ return {
80
+ content: [
81
+ {
82
+ type: "text",
83
+ text: `✅ **Task Created Successfully!**\n- **Key**: ${key}\n- **Title**: ${created.title}\n- **ID**: \`${created.id}\`\n- **Type**: ${created.type}`
84
+ }
85
+ ]
86
+ };
87
+ }
88
+ catch (err) {
89
+ return {
90
+ isError: true,
91
+ content: [{ type: "text", text: `Error creating task: ${err.message}` }]
92
+ };
93
+ }
94
+ });
95
+ // 4. Update Task Status
96
+ server.tool("klority_update_task_status", "Transition a task to another board column (e.g., In Progress, Review, Done) and optionally post an explanation comment.", {
97
+ taskId: z.string().describe("Task UUID or custom identifier"),
98
+ columnId: z.string().optional().describe("Destination Column UUID"),
99
+ comment: z.string().optional().describe("Optional note explaining the status change or agent progress")
100
+ }, async ({ taskId, columnId, comment }) => {
101
+ try {
102
+ await client.updateTaskStatus(taskId, columnId, comment);
103
+ return {
104
+ content: [
105
+ {
106
+ type: "text",
107
+ text: `✅ **Task Updated Successfully** (ID: \`${taskId}\`)${comment ? `\n> Comment added: "${comment}"` : ""}`
108
+ }
109
+ ]
110
+ };
111
+ }
112
+ catch (err) {
113
+ return {
114
+ isError: true,
115
+ content: [{ type: "text", text: `Error updating task status: ${err.message}` }]
116
+ };
117
+ }
118
+ });
119
+ // 5. Add Task Comment
120
+ server.tool("klority_add_task_comment", "Add a comment or discussion reply to a Klority task thread.", {
121
+ taskId: z.string().describe("Task UUID or custom identifier"),
122
+ content: z.string().min(1).describe("Comment content in Markdown format")
123
+ }, async ({ taskId, content }) => {
124
+ try {
125
+ const res = await client.addTaskComment(taskId, content);
126
+ return {
127
+ content: [
128
+ {
129
+ type: "text",
130
+ text: `✅ **Comment Posted to Task ${taskId}**`
131
+ }
132
+ ]
133
+ };
134
+ }
135
+ catch (err) {
136
+ return {
137
+ isError: true,
138
+ content: [{ type: "text", text: `Error adding comment: ${err.message}` }]
139
+ };
140
+ }
141
+ });
142
+ // 6. List Sprints
143
+ server.tool("klority_list_sprints", "List sprints for a given project, including status (active, future, closed) and dates.", {
144
+ projectId: z.string().describe("Project UUID"),
145
+ state: z.enum(["active", "future", "closed"]).optional().describe("Filter by sprint status")
146
+ }, async ({ projectId, state }) => {
147
+ try {
148
+ const res = await client.listSprints(projectId, state);
149
+ if (!res.sprints || res.sprints.length === 0) {
150
+ return {
151
+ content: [{ type: "text", text: `No ${state || ""} sprints found for project ${projectId}.` }]
152
+ };
153
+ }
154
+ const sprintList = res.sprints.map((s) => `- **${s.name}** [Status: \`${s.status}\`]\n *ID*: \`${s.id}\`${s.startDate ? ` | *Dates*: ${new Date(s.startDate).toLocaleDateString()} -> ${new Date(s.endDate).toLocaleDateString()}` : ""}${s.goal ? `\n *Goal*: ${s.goal}` : ""}`).join("\n\n");
155
+ return {
156
+ content: [
157
+ {
158
+ type: "text",
159
+ text: `### Sprints for Project:\n\n${sprintList}`
160
+ }
161
+ ]
162
+ };
163
+ }
164
+ catch (err) {
165
+ return {
166
+ isError: true,
167
+ content: [{ type: "text", text: `Error listing sprints: ${err.message}` }]
168
+ };
169
+ }
170
+ });
171
+ }
172
+ //# sourceMappingURL=tasks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/tools/tasks.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import { KlorityClient } from "../client.js";
3
+ export declare function registerWikiTools(server: McpServer, client: KlorityClient): void;
4
+ //# sourceMappingURL=wiki.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wiki.d.ts","sourceRoot":"","sources":["../../src/tools/wiki.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,QAyGzE"}