jira-pilot 2.1.3 → 2.2.0

package/src/server/mcp-server.ts

@@ -1,18 +1,54 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import {
+    CallToolRequestSchema,
+    ListToolsRequestSchema,
+    ListPromptsRequestSchema,
+    GetPromptRequestSchema,
+    ListResourceTemplatesRequestSchema,
+    ListResourcesRequestSchema,
+    ReadResourceRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
 import { api } from "../services/api-service.js";
 import { textToADF } from "../utils/text-to-adf.js";
+import { readFileSync, existsSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { API } from "../utils/api-paths.js";
+
+// Load package.json for version
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+function getPackageVersion() {
+    const candidates = [
+        join(__dirname, "../../package.json"),
+        join(__dirname, "../../../package.json"),
+        join(process.cwd(), "package.json"),
+    ];
+
+    for (const p of candidates) {
+        if (!existsSync(p)) continue;
+        try {
+            const pkg = JSON.parse(readFileSync(p, "utf-8"));
+            if (typeof pkg.version === "string" && pkg.version) return pkg.version;
+        } catch { /* ignore */ }
+    }
+    return "0.0.0";
+}
+
+const version = getPackageVersion();
 
 // Initialize MCP Server
 const server = new Server(
     {
         name: "jira-pilot",
-        version: "1.0.0",
+        version: version,
     },
     {
         capabilities: {
             tools: {},
+            prompts: { listChanged: true },
+            resources: { subscribe: false, listChanged: true },
         },
     }
 );
@@ -200,6 +236,175 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
     };
 });
 
+// ── Prompt Definitions ────────────────────────────────────────────────
+server.setRequestHandler(ListPromptsRequestSchema, async () => {
+    return {
+        prompts: [
+            {
+                name: "jira-assist",
+                description: "A system prompt to help the LLM understand how to assist with Jira tasks.",
+            },
+            {
+                name: "jira-summarize-issue",
+                description: "Summarize a specific Jira issue.",
+                arguments: [
+                    {
+                        name: "issueKey",
+                        description: "The key of the issue to summarize (e.g., PROJ-123)",
+                        required: true
+                    }
+                ]
+            }
+        ]
+    };
+});
+
+server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+
+    if (name === "jira-assist") {
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `You are Jira Pilot, an intelligent assistant for Jira.
+Your goal is to help users manage their projects, issues, and workflows efficiently.
+
+Available Tools:
+- Use 'jira_list_issues' to find issues.
+- Use 'jira_get_issue' to see details.
+- Use 'jira_create_issue', 'jira_update_issue', 'jira_transition_issue' to modify.
+
+Guidelines:
+1. Always be concise and helpful.
+2. If the user asks to "fix" something, look for relevant issues first.
+3. When creating issues, ask for clarification if fields are missing (Project, Type).
+4. Use JQL for powerful searching.`
+                    }
+                }
+            ]
+        };
+    }
+
+    if (name === "jira-summarize-issue") {
+        const issueKey = args?.issueKey;
+        if (!issueKey) {
+            throw new Error("Missing required argument: issueKey");
+        }
+
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Please fetch details for Jira issue ${issueKey} using 'jira_get_issue', and then provide a concise summary of its status, priority, and recent activity.`
+                    }
+                }
+            ]
+        };
+    }
+
+    throw new Error(`Prompt not found: ${name}. Available: jira-assist, jira-summarize-issue`);
+});
+
+// ── Resource Templates ──────────────────────────────────────────────
+server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => {
+    return {
+        resourceTemplates: []
+    };
+});
+
+// ── Resource Definitions ──────────────────────────────────────────────
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+    return {
+        resources: [
+            {
+                uri: "jira://myself",
+                name: "My Profile",
+                description: "Details of the currently authenticated user.",
+                mimeType: "application/json"
+            },
+            {
+                uri: "jira://projects",
+                name: "All Projects",
+                description: "List of all accessible Jira projects.",
+                mimeType: "application/json"
+            }
+        ]
+    };
+});
+
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const { uri } = request.params;
+
+    const createEnvelope = (type: string, data: any) => ({
+        source: "jira-pilot",
+        type,
+        data,
+        fetchedAt: new Date().toISOString()
+    });
+
+    try {
+        if (uri === "jira://myself") {
+            const myself = await api.get(API.USER.MYSELF);
+            // Mask sensitive data if needed, though 'myself' usually implies permission to see own data.
+            // keeping it simple for now, but ensuring consistent shape.
+            const safeData = {
+                accountId: myself.accountId,
+                displayName: myself.displayName,
+                active: myself.active,
+                timeZone: myself.timeZone,
+                // Only include email if present, or maybe mask it? User asked to be careful.
+                // We'll exclude email to be safe as per user request "do not include email".
+            };
+
+            return {
+                contents: [{
+                    uri,
+                    mimeType: "application/json",
+                    text: JSON.stringify(createEnvelope("myself", safeData), null, 2)
+                }]
+            };
+        }
+
+        if (uri === "jira://projects") {
+            const data = await api.get(`${API.PROJECT.SEARCH}?maxResults=50`);
+            const projects = (data.values || []).map((p: any) => ({
+                key: p.key,
+                name: p.name,
+                id: p.id,
+                style: p.style
+            }));
+
+            return {
+                contents: [{
+                    uri,
+                    mimeType: "application/json",
+                    text: JSON.stringify(createEnvelope("projects", projects), null, 2)
+                }]
+            };
+        }
+
+        throw new Error(`Resource not found: ${uri}. Available: jira://myself, jira://projects`);
+
+    } catch (e: any) {
+        // Handle Auth/Network errors specifically
+        if (e.response?.status === 401 || e.response?.status === 403) {
+            throw new Error(`Jira auth is missing or expired. Run 'jira config setup' to authenticate.`);
+        }
+        if (e.message.includes("Resource not found")) {
+            throw e; // Re-throw 404s we generated
+        }
+
+        // Upstream errors
+        const status = e.response?.status || "Unknown";
+        throw new Error(`Upstream Jira error (${status}): ${e.message}`);
+    }
+});
+
 // ── Tool Handlers ────────────────────────────────────────────────────
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params as { name: string; arguments: any };
@@ -209,7 +414,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         if (name === "jira_list_issues") {
             const jql = args.jql || "";
             const limit = args.limit || 10;
-            const data = await api.post('/search/jql', {
+            const data = await api.post(API.SEARCH.JQL, {
                 jql,
                 maxResults: limit,
                 fields: ['summary', 'status', 'assignee', 'priority', 'created', 'updated']
@@ -233,7 +438,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
         // ── jira_get_issue ──────────────────────────────────
         if (name === "jira_get_issue") {
-            const data = await api.get(`/issue/${args.issueKey}`);
+            const data = await api.get(API.ISSUE.GET(args.issueKey));
 
             // Return a cleaner summary for agents
             const result = {
@@ -284,7 +489,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 body.fields.assignee = { accountId: args.assigneeId };
             }
 
-            const data = await api.post('/issue', body);
+            const data = await api.post(API.ISSUE.BASE, body);
             return {
                 content: [{ type: "text", text: JSON.stringify({ key: data.key, self: data.self }, null, 2) }]
             };
@@ -294,8 +499,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         if (name === "jira_transition_issue") {
             if (!args.transitionId) {
                 // List available transitions
-                const transData = await api.get(`/issue/${args.issueKey}/transitions`);
-                const issue = await api.get(`/issue/${args.issueKey}?fields=summary,status`);
+                const transData = await api.get(API.ISSUE.TRANSITIONS(args.issueKey));
+                const issue = await api.get(`${API.ISSUE.GET(args.issueKey)}?fields=summary,status`);
 
                 const result = {
                     issueKey: args.issueKey,
@@ -314,7 +519,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             }
 
             // Execute transition
-            await api.post(`/issue/${args.issueKey}/transitions`, {
+            await api.post(API.ISSUE.TRANSITIONS(args.issueKey), {
                 transition: { id: args.transitionId }
             });
 
@@ -329,11 +534,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
             // Resolve "me" to actual account ID
             if (accountId === 'me') {
-                const myself = await api.get('/myself');
+                const myself = await api.get(API.USER.MYSELF);
                 accountId = myself.accountId;
             }
 
-            await api.put(`/issue/${args.issueKey}/assignee`, {
+            await api.put(API.ISSUE.ASSIGNEE(args.issueKey), {
                 accountId: accountId || null
             });
 
@@ -344,7 +549,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
         // ── jira_add_comment ────────────────────────────────
         if (name === "jira_add_comment") {
-            const data = await api.post(`/issue/${args.issueKey}/comment`, {
+            const data = await api.post(API.ISSUE.COMMENT(args.issueKey), {
                 body: textToADF(args.body)
             });
 
@@ -364,7 +569,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             if (args.assigneeId) {
                 let accId = args.assigneeId;
                 if (accId === 'me') {
-                    const myself = await api.get('/myself');
+                    const myself = await api.get(API.USER.MYSELF);
                     accId = myself.accountId;
                 } else if (accId === 'none') {
                     accId = null;
@@ -379,7 +584,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 };
             }
 
-            await api.put(`/issue/${args.issueKey}`, updateBody);
+            await api.put(API.ISSUE.GET(args.issueKey), updateBody);
 
             return {
                 content: [{ type: "text", text: JSON.stringify({ success: true, issueKey: args.issueKey }) }]
@@ -388,12 +593,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
         // ── jira_search_users ───────────────────────────────
         if (name === "jira_search_users") {
-            const users = await api.get(`/user/search?query=${encodeURIComponent(args.query)}`);
+            const users = await api.get(`${API.USER.SEARCH}?query=${encodeURIComponent(args.query)}`);
 
             const results = (users || []).map((u: any) => ({
                 accountId: u.accountId,
                 displayName: u.displayName,
-                email: u.emailAddress,
+                // Email excluded for safety
+                // email: u.emailAddress, 
                 active: u.active
             }));
 
@@ -404,11 +610,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
         // ── jira_myself ─────────────────────────────────────
         if (name === "jira_myself") {
-            const myself = await api.get('/myself');
+            const myself = await api.get(API.USER.MYSELF);
             const result = {
                 accountId: myself.accountId,
                 displayName: myself.displayName,
-                email: myself.emailAddress,
+                // Email excluded for safety
+                // email: myself.emailAddress,
                 active: myself.active,
                 timeZone: myself.timeZone
             };
@@ -421,7 +628,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         // ── jira_list_projects ──────────────────────────────
         if (name === "jira_list_projects") {
             const limit = args.limit || 50;
-            const data = await api.get(`/project/search?maxResults=${limit}`);
+            const data = await api.get(`${API.PROJECT.SEARCH}?maxResults=${limit}`);
 
             const projects = (data.values || []).map((p: any) => ({
                 key: p.key,
@@ -464,7 +671,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 body.comment = textToADF(args.comment);
             }
 
-            await api.post(`/issue/${args.issueKey}/worklog`, body);
+            await api.post(API.ISSUE.WORKLOG(args.issueKey), body);
 
             return {
                 content: [{ type: "text", text: JSON.stringify({ success: true, issueKey: args.issueKey, timeSpent: args.timeSpent }) }]
@@ -474,7 +681,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         // ── jira_create_subtask ─────────────────────────────
         if (name === "jira_create_subtask") {
             // 1. Fetch parent to get project
-            const parent = await api.get(`/issue/${args.parentKey}?fields=project`);
+            const parent = await api.get(`${API.ISSUE.GET(args.parentKey)}?fields=project`);
             const projectKey = parent.fields.project.key;
 
             // 2. Find subtask issue type
@@ -504,13 +711,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             if (args.assigneeId) {
                 let accId = args.assigneeId;
                 if (accId === 'me') {
-                    const myself = await api.get('/myself');
+                    const myself = await api.get(API.USER.MYSELF);
                     accId = myself.accountId;
                 }
                 body.fields.assignee = { accountId: accId };
             }
 
-            const data = await api.post('/issue', body);
+            const data = await api.post(API.ISSUE.BASE, body);
             return {
                 content: [{ type: "text", text: JSON.stringify({ key: data.key, self: data.self }, null, 2) }]
             };
@@ -520,15 +727,15 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         if (name === "jira_add_attachment") {
             try {
                 // Dynamically import fs/path to avoid top-level node dependencies if this runs in browser-like env (unlikely but safe)
-                const { openAsBlob } = await import('node:fs');
-                const path = await import('node:path');
+                const fs = await import("node:fs");
+                const path = await import("node:path");
 
                 const filePath = args.filePath;
-                const file = await openAsBlob(filePath);
+                const file = await fs.openAsBlob(filePath);
                 const formData = new FormData();
-                formData.append('file', file, path.default.basename(filePath));
+                formData.append("file", file, path.basename(filePath));
 
-                const result = await api.upload(`/issue/${args.issueKey}/attachments`, formData);
+                const result = await api.upload(API.ISSUE.ATTACHMENTS(args.issueKey), formData);
 
                 return {
                     content: [{ type: "text", text: JSON.stringify(result, null, 2) }]

package/src/services/api-service.ts

@@ -1,6 +1,7 @@
 import { HttpClient } from '../utils/http.js';
 import chalk from 'chalk';
 import { getCredentials } from '../utils/config.js';
+import { API } from '../utils/api-paths.js';
 
 export class ApiService {
     private client: any;
@@ -101,14 +102,18 @@ export class ApiService {
         return response.data;
     }
 
-    async search(jql: string, startAt: number = 0, maxResults: number = 50) {
-        return this.post('/search/jql', {
+    async search(jql: string, startAt: number = 0, maxResults: number = 50, nextPageToken?: string) {
+        const payload: any = {
             jql,
-            startAt,
             maxResults,
-            fields: ['summary', 'status', 'assignee', 'priority', 'issuetype', 'created', 'updated', 'project'],
-            validation: 'warn'
-        });
+            fields: ['summary', 'status', 'assignee', 'priority', 'issuetype', 'created', 'updated', 'project']
+        };
+
+        if (nextPageToken) {
+            payload.nextPageToken = nextPageToken;
+        }
+
+        return this.post(API.SEARCH.JQL, payload);
     }
 
     async upload(url: string, formData: any) {

package/src/utils/api-paths.ts

@@ -0,0 +1,32 @@
+
+export const API = {
+    SEARCH: {
+        JQL: '/search/jql',
+    },
+    ISSUE: {
+        BASE: '/issue',
+        GET: (key: string) => `/issue/${key}`,
+        TRANSITIONS: (key: string) => `/issue/${key}/transitions`,
+        COMMENT: (key: string) => `/issue/${key}/comment`,
+        ASSIGNEE: (key: string) => `/issue/${key}/assignee`,
+        WORKLOG: (key: string) => `/issue/${key}/worklog`,
+        ATTACHMENTS: (key: string) => `/issue/${key}/attachments`,
+        CREATEMETA: (projectKey: string) => `/issue/createmeta/${projectKey}/issuetypes`,
+    },
+    PROJECT: {
+        SEARCH: '/project/search',
+        GET: (key: string) => `/project/${key}`,
+        COMPONENTS: (key: string) => `/project/${key}/components`,
+        VERSIONS: (key: string) => `/project/${key}/versions`,
+    },
+    USER: {
+        MYSELF: '/myself',
+        SEARCH: '/user/search',
+    },
+    PRIORITY: {
+        ALL: '/priority',
+    },
+    SERVER: {
+        INFO: '/serverInfo',
+    }
+};