jira-pilot 2.1.2 → 2.2.0

package/src/commands/sprint.ts

@@ -1,8 +1,8 @@
 import { Command } from 'commander';
 import chalk from 'chalk';
-import Table from 'cli-table3';
+import { Table } from 'cmd-table';
 import { api } from '../services/api-service.js';
-import ora from 'ora';
+import ora from '../utils/spinner.js';
 import enquirer from 'enquirer';
 import { handleCommandError } from '../utils/error-handler.js';
 
@@ -56,11 +56,16 @@ Common Actions:
                 }
 
                 const table = new Table({
-                    head: [chalk.bold('ID'), chalk.bold('Name'), chalk.bold('State'), chalk.bold('Dates')]
+                    columns: [
+                        { name: chalk.bold('ID') },
+                        { name: chalk.bold('Name') },
+                        { name: chalk.bold('State') },
+                        { name: chalk.bold('Dates') }
+                    ]
                 });
 
                 data.values.forEach((s: any) => {
-                    table.push([
+                    table.addRow([
                         s.id,
                         s.name,
                         s.state === 'active' ? chalk.green(s.state) : s.state,
@@ -68,7 +73,7 @@ Common Actions:
                     ]);
                 });
 
-                console.log(table.toString());
+                console.log(table.render());
 
             } catch (e: any) {
                 handleCommandError(spinner, e, 'Failed to list sprints');
@@ -131,10 +136,16 @@ Examples:
                 }
 
                 const table = new Table({
-                    head: [chalk.bold('Key'), chalk.bold('Summary'), chalk.bold('Status'), chalk.bold('Assignee'), chalk.bold('Priority')]
+                    columns: [
+                        { name: chalk.bold('Key') },
+                        { name: chalk.bold('Summary') },
+                        { name: chalk.bold('Status') },
+                        { name: chalk.bold('Assignee') },
+                        { name: chalk.bold('Priority') }
+                    ]
                 });
                 issues.issues.forEach((i: any) => {
-                    table.push([
+                    table.addRow([
                         chalk.cyan(i.key),
                         i.fields.summary ? (i.fields.summary.length > 50 ? i.fields.summary.substring(0, 47) + '...' : i.fields.summary) : '',
                         i.fields.status?.name || '',
@@ -142,7 +153,7 @@ Examples:
                         i.fields.priority?.name || ''
                     ]);
                 });
-                console.log(table.toString());
+                console.log(table.render());
                 console.log(chalk.grey(`${issues.issues.length} issue(s) in sprint`));
 
             } catch (e: any) {

package/src/commands/tui.ts

@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+import { startTui } from '../tui/index.js';
+
+export function registerTuiCommand(program: Command) {
+    program
+        .command('tui')
+        .description('Start the interactive TUI mode')
+        .action(async () => {
+            startTui();
+        });
+}

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/ai-service.ts

@@ -1,4 +1,4 @@
-import axios from 'axios';
+import { HttpClient } from '../utils/http.js';
 import { getCredentials } from '../utils/config.js';
 
 export class AiService {
@@ -89,7 +89,8 @@ Today is ${new Date().toISOString().split('T')[0]}.`;
 
     async callOpenAI(key: string, prompt: string): Promise<string> {
         try {
-            const response = await axios.post('https://api.openai.com/v1/chat/completions', {
+            const client = new HttpClient();
+            const response = await client.post('https://api.openai.com/v1/chat/completions', {
                 model: 'gpt-4o',
                 messages: [{ role: 'user', content: prompt }],
                 temperature: 0.7
@@ -107,8 +108,9 @@ Today is ${new Date().toISOString().split('T')[0]}.`;
             // Gemini REST API — uses generativelanguage.googleapis.com
             const model = 'gemini-2.0-flash';
             const url = `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent?key=${key}`;
+            const client = new HttpClient();
 
-            const response = await axios.post(url, {
+            const response = await client.post(url, {
                 contents: [{
                     parts: [{ text: prompt }]
                 }],
@@ -137,7 +139,8 @@ Today is ${new Date().toISOString().split('T')[0]}.`;
     async callAnthropic(key: string, prompt: string): Promise<string> {
         try {
             // Anthropic Messages API
-            const response = await axios.post('https://api.anthropic.com/v1/messages', {
+            const client = new HttpClient();
+            const response = await client.post('https://api.anthropic.com/v1/messages', {
                 model: 'claude-sonnet-4-20250514',
                 max_tokens: 2048,
                 messages: [{ role: 'user', content: prompt }]

package/src/services/api-service.ts

@@ -1,6 +1,7 @@
-import axios from 'axios';
+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;
@@ -28,27 +29,28 @@ export class ApiService {
         const authHeader = `Basic ${Buffer.from(`${email}:${apiToken}`).toString('base64')}`;
 
         // Standard REST API v3 client
-        this.client = axios.create({
+        this.client = new HttpClient({
             baseURL: `${this._domain}/rest/api/3`,
             headers: {
                 'Authorization': authHeader,
-                'Accept': 'application/json',
-                'Content-Type': 'application/json'
+                'Accept': 'application/json'
             }
         });
 
         // Agile REST API v1 client (for boards, sprints, etc.)
-        this.agileClient = axios.create({
+        this.agileClient = new HttpClient({
             baseURL: `${this._domain}/rest/agile/1.0`,
             headers: {
                 'Authorization': authHeader,
-                'Accept': 'application/json',
-                'Content-Type': 'application/json'
+                'Accept': 'application/json'
             }
         });
+    }
 
-        // Shared response interceptor
-        const errorInterceptor = (error: any) => {
+    private async handleRequest(request: Promise<any>) {
+        try {
+            return await request;
+        } catch (error: any) {
             if (error.response) {
                 if (error.response.status === 401) {
                     console.error(chalk.red('Authentication failed. Please check your credentials using "jira config".'));
@@ -56,11 +58,8 @@ export class ApiService {
                     console.error(chalk.red('Access denied. You may not have permission for this resource.'));
                 }
             }
-            return Promise.reject(error);
-        };
-
-        this.client.interceptors.response.use((r: any) => r, errorInterceptor);
-        this.agileClient.interceptors.response.use((r: any) => r, errorInterceptor);
+            throw error;
+        }
     }
 
     /** @returns {string} The Jira domain URL */
@@ -81,28 +80,42 @@ export class ApiService {
 
     async get(url: string, config: any = {}) {
         this.ensureClient();
-        const response = await this.client.get(url, config);
+        const response = await this.handleRequest(this.client.get(url, config));
         return response.data;
     }
 
     async post(url: string, data: any, config: any = {}) {
         this.ensureClient();
-        const response = await this.client.post(url, data, config);
+        const response = await this.handleRequest(this.client.post(url, data, config));
         return response.data;
     }
 
     async put(url: string, data: any, config: any = {}) {
         this.ensureClient();
-        const response = await this.client.put(url, data, config);
+        const response = await this.handleRequest(this.client.put(url, data, config));
         return response.data;
     }
 
     async delete(url: string, config: any = {}) {
         this.ensureClient();
-        const response = await this.client.delete(url, config);
+        const response = await this.handleRequest(this.client.delete(url, config));
         return response.data;
     }
 
+    async search(jql: string, startAt: number = 0, maxResults: number = 50, nextPageToken?: string) {
+        const payload: any = {
+            jql,
+            maxResults,
+            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) {
         this.ensureClient();
         // Jira requires this header for attachments
@@ -117,7 +130,7 @@ export class ApiService {
         }
 
         const config = { headers };
-        const response = await this.client.post(url, formData, config);
+        const response = await this.handleRequest(this.client.post(url, formData, config));
         return response.data;
     }
 
@@ -125,13 +138,13 @@ export class ApiService {
 
     async agileGet(url: string, config: any = {}) {
         this.ensureClient();
-        const response = await this.agileClient.get(url, config);
+        const response = await this.handleRequest(this.agileClient.get(url, config));
         return response.data;
     }
 
     async agilePost(url: string, data: any, config: any = {}) {
         this.ensureClient();
-        const response = await this.agileClient.post(url, data, config);
+        const response = await this.handleRequest(this.agileClient.post(url, data, config));
         return response.data;
     }
 }