jira-pilot 1.0.2 → 1.1.0

package/README.md

@@ -138,6 +138,22 @@ Once connected, you can ask Claude things like:
 
 ---
 
+## 🛠️ Testing & Verification
+
+### Testing the MCP Server
+You can test the MCP server functionality using the official [MCP Inspector](https://github.com/modelcontextprotocol/inspector):
+
+```bash
+npx @modelcontextprotocol/inspector node ./bin/jira.js mcp
+```
+
+This will launch a web interface where you can:
+1.  View available tools (`jira_list_issues`, `jira_get_issue`, `jira_create_issue`).
+2.  Execute tools and view output.
+3.  Inspect request/response logs.
+
+---
+
 ## 🛠️ Project Structure
 - `bin/`: Entry point.
 - `src/commands/`: CLI command definitions (Human UI).

package/bin/jira.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 import { Command } from 'commander';
 import chalk from 'chalk';
 import { readFileSync } from 'fs';
@@ -14,7 +14,14 @@ const program = new Command();
 program
     .name('jira')
     .description('AI-powered Jira CLI for humans and agents')
-    .version(pkg.version);
+    .version(pkg.version)
+    .addHelpText('after', `
+Examples:
+  $ jira issue list
+  $ jira issue view PROJ-123
+  $ jira sprint list --board 123
+  $ jira ai summarize PROJ-123
+    `);
 
 import { registerConfigCommand } from '../src/commands/config.js';
 import { registerIssueCommand } from '../src/commands/issue.js';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "jira-pilot",
-    "version": "1.0.2",
+    "version": "1.1.0",
     "description": "AI-powered Jira CLI for humans and agents",
     "main": "src/index.js",
     "type": "module",
@@ -16,7 +16,15 @@
         "cli",
         "ai",
         "agent",
-        "mcp"
+        "mcp",
+        "jira-client",
+        "jiracli",
+        "atlassian",
+        "jira-api",
+        "issue-tracker",
+        "task-management",
+        "command-line",
+        "typescript"
     ],
     "author": "Arul",
     "repository": {

package/src/commands/ai.js

@@ -1,13 +1,22 @@
 import { Command } from 'commander';
 import chalk from 'chalk';
 import ora from 'ora';
+import enquirer from 'enquirer';
 import { api } from '../services/api-service.js';
 import { aiService } from '../services/ai-service.js';
+import { parseADF } from '../utils/adf-parser.js';
 
 export function registerAiCommand(program) {
     const aiCmd = new Command('ai')
-        .description('AI Helper commands');
+        .description('AI Helper commands')
+        .addHelpText('after', `
+Common Actions:
+  $ jira ai summarize <KEY>         # Summarize an issue
+  $ jira ai draft                   # Draft an issue description from bullet points
+  $ jira ai suggest <KEY>           # Suggest next actions for an issue
+        `);
 
+    // ── SUMMARIZE ─────────────────────────────────────────────────────
     aiCmd
         .command('summarize')
         .description('Summarize an issue using AI')
@@ -15,24 +24,27 @@ export function registerAiCommand(program) {
         .action(async (issueKey) => {
             const spinner = ora(`Fetching issue ${issueKey}...`).start();
             try {
-                // Fetch issue details and comments
                 const issue = await api.get(`/issue/${issueKey}?fields=summary,description,comment`);
                 spinner.text = 'Generating summary...';
 
                 const summary = issue.fields.summary;
-                const description = issue.fields.description || 'No description';
-                const comments = issue.fields.comment.comments.map(c => `${c.author.displayName}: ${c.body}`).join('\n');
+                const description = issue.fields.description
+                    ? parseADF(issue.fields.description)
+                    : 'No description';
+                const comments = (issue.fields.comment?.comments || [])
+                    .map(c => `${c.author.displayName}: ${typeof c.body === 'object' ? parseADF(c.body) : c.body}`)
+                    .join('\n');
 
                 const prompt = `
-            You are a helpful Jira assistant. Please summarize the following Jira issue.
-            
-            Title: ${summary}
-            Description: ${description}
-            
-            Comments:
-            ${comments}
-            
-            Provide a concise summary of the current status, key discussion points, and next steps if clear.
+You are a helpful Jira assistant. Please summarize the following Jira issue.
+
+Title: ${summary}
+Description: ${description}
+
+Comments:
+${comments || 'No comments'}
+
+Provide a concise summary of the current status, key discussion points, and next steps if clear.
             `;
 
                 const aiResponse = await aiService.generate(prompt);
@@ -42,7 +54,7 @@ export function registerAiCommand(program) {
                 console.log(aiResponse);
 
             } catch (e) {
-                spinner.stop(); // Ensure spinner stops
+                spinner.stop();
                 if (e.response && e.response.config && e.response.config.url.includes('/issue/')) {
                     console.error(chalk.red(`\nError: Issue "${issueKey}" not found.`));
                 } else {
@@ -56,5 +68,137 @@ export function registerAiCommand(program) {
             }
         });
 
+    // ── DRAFT ─────────────────────────────────────────────────────────
+    aiCmd
+        .command('draft')
+        .description('Draft a structured issue description from bullet points')
+        .option('-i, --input <text>', 'Bullet points or rough notes (alternative to interactive prompt)')
+        .option('-t, --type <type>', 'Issue type context (bug, story, task)', 'task')
+        .addHelpText('after', `
+Examples:
+  $ jira ai draft                              # Interactive
+  $ jira ai draft -i "login fails, returns 500, only on mobile"
+  $ jira ai draft -i "add dark mode toggle" -t story
+        `)
+        .action(async (options) => {
+            try {
+                let bulletPoints = options.input;
+
+                if (!bulletPoints) {
+                    const { inputNotes } = await enquirer.prompt({
+                        type: 'input',
+                        name: 'inputNotes',
+                        message: 'Enter your bullet points or rough notes:',
+                        validate: (val) => val.trim().length > 0 || 'Input cannot be empty'
+                    });
+                    bulletPoints = inputNotes;
+                }
+
+                const issueType = options.type || 'task';
+
+                const spinner = ora('Drafting description...').start();
+
+                const prompt = `
+You are a Jira expert. Given the following rough notes/bullet points, generate a well-structured Jira issue description.
+
+Issue Type: ${issueType}
+Notes: ${bulletPoints}
+
+Format the output as follows:
+## Summary
+A clear one-line summary for the issue title.
+
+## Description
+A well-structured description with:
+- Context / Background
+- Expected Behavior (if applicable)
+- Steps to Reproduce (if it's a bug)
+- Acceptance Criteria (if it's a story)
+
+Keep it professional and concise. Output in plain text (not markdown headers, use plain labels).
+                `;
+
+                const aiResponse = await aiService.generate(prompt);
+                spinner.stop();
+
+                console.log(chalk.green('\n✍️  AI-Generated Draft:\n'));
+                console.log(aiResponse);
+                console.log(chalk.grey('\nTip: Copy this into "jira issue create" or use it as a starting point.'));
+
+            } catch (e) {
+                if (e === '' || e.message === '') {
+                    console.log(chalk.yellow('\nCancelled.'));
+                    return;
+                }
+                console.error(chalk.red('\nFailed to generate draft:'));
+                console.error(chalk.red(e.message));
+            }
+        });
+
+    // ── SUGGEST ───────────────────────────────────────────────────────
+    aiCmd
+        .command('suggest')
+        .description('Suggest next actions for an issue based on its context')
+        .argument('<issueKey>', 'Jira Issue Key')
+        .action(async (issueKey) => {
+            const spinner = ora(`Analyzing issue ${issueKey}...`).start();
+            try {
+                const issue = await api.get(`/issue/${issueKey}?fields=summary,description,status,assignee,priority,comment,issuetype`);
+
+                const summary = issue.fields.summary;
+                const description = issue.fields.description
+                    ? parseADF(issue.fields.description)
+                    : 'No description';
+                const status = issue.fields.status?.name || 'Unknown';
+                const issueType = issue.fields.issuetype?.name || 'Unknown';
+                const priority = issue.fields.priority?.name || 'None';
+                const assignee = issue.fields.assignee?.displayName || 'Unassigned';
+                const comments = (issue.fields.comment?.comments || [])
+                    .slice(-5) // Last 5 comments for context
+                    .map(c => `${c.author.displayName}: ${typeof c.body === 'object' ? parseADF(c.body) : c.body}`)
+                    .join('\n');
+
+                spinner.text = 'Generating suggestions...';
+
+                const prompt = `
+You are a senior software engineer and Jira workflow expert. Analyze the following Jira issue and suggest practical next actions.
+
+Issue Key: ${issueKey}
+Type: ${issueType}
+Status: ${status}
+Priority: ${priority}
+Assignee: ${assignee}
+Title: ${summary}
+Description: ${description}
+
+Recent Comments:
+${comments || 'No comments'}
+
+Based on the current status and context, suggest:
+1. **Immediate Next Action** — What should be done right now?
+2. **Potential Blockers** — Are there any risks or dependencies to watch?
+3. **Suggested Status Transition** — Should this issue be moved to a different status?
+4. **Recommendations** — Any other advice for this issue?
+
+Keep suggestions actionable and concise.
+                `;
+
+                const aiResponse = await aiService.generate(prompt);
+                spinner.stop();
+
+                console.log(chalk.green(`\n💡 AI Suggestions for ${issueKey}:\n`));
+                console.log(aiResponse);
+
+            } catch (e) {
+                spinner.stop();
+                if (e.response && e.response.status === 404) {
+                    console.error(chalk.red(`\nError: Issue "${issueKey}" not found.`));
+                } else {
+                    console.error(chalk.red('\nFailed to generate suggestions:'));
+                    console.error(chalk.red(e.message));
+                }
+            }
+        });
+
     program.addCommand(aiCmd);
 }

package/src/commands/config.js

@@ -47,7 +47,7 @@ export function registerConfigCommand(program) {
                         type: 'select',
                         name: 'aiProvider',
                         message: 'Select AI Provider:',
-                        choices: ['openai'], // Add 'gemini', 'anthropic' when ready
+                        choices: ['openai', 'gemini', 'anthropic'],
                         initial: current.aiProvider || 'openai',
                         skip: (state) => !state.answers.aiEnabled
                     },