jira-pilot 2.0.2 → 2.0.3

package/README.md

@@ -1,6 +1,6 @@
 # Jira Pilot ✈️
 
-**The AI-Powered Jira CLI for Humans and Agents.**
+**The AI-Powered Jira CLI and MCP Server for Humans and Agents.**
 
 `jira-pilot` is a next-generation CLI that combines traditional developer tools with modern AI capabilities.
 

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "jira-pilot",
-    "version": "2.0.2",
-    "description": "AI-powered Jira CLI for humans and agents — manage issues, sprints, boards with interactive wizards, multi-provider AI (OpenAI/Gemini/Anthropic), and an 8-tool MCP server for AI assistants",
+    "version": "2.0.3",
+    "description": "AI-powered Jira CLI and MCP server for humans and agents — manage issues, sprints, boards with interactive wizards, multi-provider AI (OpenAI/Gemini/Anthropic), and an 8-tool MCP server for AI assistants",
     "main": "src/index.js",
     "type": "module",
     "bin": {

package/src/commands/ai-actions/plan.js

@@ -5,6 +5,7 @@ import { api } from '../../services/api-service.js';
 import { aiService } from '../../services/ai-service.js';
 import { validateIssueKey } from '../../utils/validators.js';
 import { parseADF } from '../../utils/adf-parser.js';
+import { handleCommandError } from '../../utils/error-handler.js';
 
 export async function planAction(epicKey, options) {
     const check = validateIssueKey(epicKey);
@@ -113,7 +114,6 @@ export async function planAction(epicKey, options) {
         console.log(chalk.green(`\nDone! Created ${results.length} issues linked to ${epicKey}.`));
 
     } catch (e) {
-        spinner.stop();
-        console.error(chalk.red(`Error: ${e.message}`));
+        handleCommandError(spinner, e, `Failed to plan ${epicKey}`);
     }
 }

package/src/commands/ai-actions/review.js

@@ -7,6 +7,7 @@ import { aiService } from '../../services/ai-service.js';
 import { validateIssueKey } from '../../utils/validators.js';
 import { getCredentials } from '../../utils/config.js';
 import { parseADF } from '../../utils/adf-parser.js';
+import { handleCommandError } from '../../utils/error-handler.js';
 
 export async function reviewAction(issueKey, options) {
     const check = validateIssueKey(issueKey);
@@ -96,14 +97,6 @@ export async function reviewAction(issueKey, options) {
         console.log(chalk.dim(`\nPR Link: ${pr.html_url}`));
 
     } catch (e) {
-        spinner.stop();
-        if (e.response?.status === 404) {
-            console.error(chalk.red(`Resource not found (Issue or Repo). Check permissions.`));
-        } else if (e.response?.status === 401) {
-            console.error(chalk.red(`GitHub/Jira Authentication failed. Check your tokens.`));
-        } else {
-            console.error(chalk.red(`Error: ${e.message}`));
-            if (e.response?.data) console.error(chalk.dim(JSON.stringify(e.response.data)));
-        }
+        handleCommandError(spinner, e, `Failed to review ${issueKey}`);
     }
 }

package/src/commands/ai-actions/standup.js

@@ -3,6 +3,7 @@ import ora from 'ora';
 import { api } from '../../services/api-service.js';
 import { aiService } from '../../services/ai-service.js';
 import { parseADF } from '../../utils/adf-parser.js';
+import { handleCommandError } from '../../utils/error-handler.js';
 
 export async function standupAction(options) {
     const spinner = ora('Analyzing your recent activity...').start();
@@ -36,7 +37,6 @@ export async function standupAction(options) {
         console.log(report);
 
     } catch (e) {
-        spinner.stop();
-        console.error(chalk.red(`Error: ${e.message}`));
+        handleCommandError(spinner, e, 'Failed to generate standup');
     }
 }

package/src/commands/ai.js

@@ -6,6 +6,7 @@ import { api } from '../services/api-service.js';
 import { aiService } from '../services/ai-service.js';
 import { parseADF } from '../utils/adf-parser.js';
 import { validateIssueKey } from '../utils/validators.js';
+import { handleCommandError } from '../utils/error-handler.js';
 import { reviewAction } from './ai-actions/review.js';
 import { planAction } from './ai-actions/plan.js';
 import { standupAction } from './ai-actions/standup.js';
@@ -60,17 +61,7 @@ Provide a concise summary of the current status, key discussion points, and next
                 console.log(aiResponse);
 
             } catch (e) {
-                spinner.stop();
-                if (e.response && e.response.config && e.response.config.url.includes('/issue/')) {
-                    console.error(chalk.red(`\nError: Issue "${issueKey}" not found.`));
-                } else {
-                    console.error(chalk.red('\nFailed to generate summary:'));
-                    if (e.response) {
-                        console.error(chalk.red(`API Error ${e.response.status}: `), e.response.data);
-                    } else {
-                        console.error(chalk.red(e.message));
-                    }
-                }
+                handleCommandError(spinner, e, `Failed to summarize ${issueKey}`);
             }
         });
 
@@ -132,12 +123,7 @@ Keep it professional and concise. Output in plain text (not markdown headers, us
                 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));
+                handleCommandError(null, e, 'Failed to generate draft');
             }
         });
 
@@ -198,13 +184,7 @@ Keep suggestions actionable and concise.
                 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));
-                }
+                handleCommandError(spinner, e, `Failed to suggest for ${issueKey}`);
             }
         });
 

package/src/commands/git.js

@@ -5,6 +5,7 @@ import { api } from '../services/api-service.js';
 import ora from 'ora';
 import enquirer from 'enquirer';
 import { validateIssueKey } from '../utils/validators.js';
+import { handleCommandError } from '../utils/error-handler.js';
 
 export function registerGitCommand(program) {
     const gitCmd = new Command('git')
@@ -50,12 +51,7 @@ export function registerGitCommand(program) {
                 }
 
             } catch (e) {
-                spinner.fail('Failed to fetch issue');
-                if (e.response) {
-                    console.error(chalk.red(`Error ${e.response.status}: `), e.response.data);
-                } else {
-                    console.error(chalk.red(e.message));
-                }
+                handleCommandError(spinner, e, 'Failed to create branch');
             }
         });
 

package/src/commands/issue.js

@@ -146,12 +146,7 @@ Examples:
                 console.log(table(tableData));
 
             } catch (e) {
-                spinner.fail('Failed to list issues');
-                if (e.response) {
-                    console.error(chalk.red(`Error ${e.response.status}: `), e.response.data);
-                } else {
-                    console.error(chalk.red(e.message));
-                }
+                handleCommandError(spinner, e, 'Failed to list issues');
             }
         });
 
@@ -202,16 +197,7 @@ Examples:
                 }
                 console.log('');
             } catch (e) {
-                spinner.fail('Failed to fetch issue');
-                if (e.response) {
-                    if (e.response.status === 404) {
-                        console.error(chalk.red(`Issue "${issueKey}" not found.`));
-                    } else {
-                        console.error(chalk.red(`Error ${e.response.status}: `), e.response.data);
-                    }
-                } else {
-                    console.error(chalk.red(e.message));
-                }
+                handleCommandError(spinner, e, 'Failed to fetch issue');
             }
         });
 
@@ -481,17 +467,7 @@ Examples:
                 console.log(chalk.grey(`View it: jira issue view ${result.key}`));
 
             } catch (e) {
-                if (e === '' || e.message === '') {
-                    // User cancelled prompt (Ctrl+C)
-                    console.log(chalk.yellow('\nCancelled.'));
-                    return;
-                }
-                console.error(chalk.red('\nFailed to create issue:'));
-                if (e.response) {
-                    console.error(chalk.red(`Error ${e.response.status}: `), JSON.stringify(e.response.data, null, 2));
-                } else {
-                    console.error(chalk.red(e.message));
-                }
+                handleCommandError(spinner, e, 'Failed to create issue');
             }
         });
 
@@ -570,21 +546,7 @@ Examples:
                 execSpinner.succeed(chalk.green(`${issueKey} transitioned: ${currentStatus} → ${chalk.bold(targetTransition.to.name)}`));
 
             } catch (e) {
-                spinner.stop();
-                if (e === '' || e.message === '') {
-                    console.log(chalk.yellow('\nCancelled.'));
-                    return;
-                }
-                console.error(chalk.red('\nFailed to transition issue:'));
-                if (e.response) {
-                    if (e.response.status === 404) {
-                        console.error(chalk.red(`Issue "${issueKey}" not found.`));
-                    } else {
-                        console.error(chalk.red(`Error ${e.response.status}: `), e.response.data);
-                    }
-                } else {
-                    console.error(chalk.red(e.message));
-                }
+                handleCommandError(spinner, e, 'Failed to transition issue');
             }
         });
     // ── ASSIGN ────────────────────────────────────────────────────────
@@ -672,16 +634,7 @@ Examples:
                 spinner.succeed(chalk.green(`${issueKey} ${assigneeId === 'none' ? 'unassigned' : 'assigned'} successfully.`));
 
             } catch (e) {
-                if (e === '' || e.message === '') {
-                    console.log(chalk.yellow('\nCancelled.'));
-                    return;
-                }
-                console.error(chalk.red('\nFailed to assign issue:'));
-                if (e.response) {
-                    console.error(chalk.red(`Error ${e.response.status}: `), e.response.data);
-                } else {
-                    console.error(chalk.red(e.message));
-                }
+                handleCommandError(spinner, e, 'Failed to assign issue');
             }
         });
 
@@ -727,20 +680,7 @@ Examples:
                 spinner.succeed(chalk.green(`Comment added to ${issueKey}.`));
 
             } catch (e) {
-                if (e === '' || e.message === '') {
-                    console.log(chalk.yellow('\nCancelled.'));
-                    return;
-                }
-                console.error(chalk.red('\nFailed to add comment:'));
-                if (e.response) {
-                    if (e.response.status === 404) {
-                        console.error(chalk.red(`Issue "${issueKey}" not found.`));
-                    } else {
-                        console.error(chalk.red(`Error ${e.response.status}: `), e.response.data);
-                    }
-                } else {
-                    console.error(chalk.red(e.message));
-                }
+                handleCommandError(spinner, e, 'Failed to add comment');
             }
         });
 

package/src/commands/mcp.js

@@ -6,8 +6,15 @@ export function registerMcpCommand(program) {
     const mcpCmd = new Command('mcp')
         .description('Start MCP Agent Server (Stdio)')
         .action(async () => {
-            // MCP server uses stdio, so we shouldn't log anything else to stdout.
-            // We can log to stderr if needed.
+            // MCP server uses stdio for communication.
+            // If run directly in a TTY (terminal), warn the user.
+            if (process.stdin.isTTY) {
+                console.error(chalk.blue('ℹ Jira MCP Server is running...'));
+                console.error(chalk.grey('  This command is designed for AI Agents (Claude, Cursor, etc).'));
+                console.error(chalk.grey('  It communicates via JSON-RPC on stdin/stdout.'));
+                console.error(chalk.grey('  Press Ctrl+C to stop.'));
+            }
+
             try {
                 await startServer();
             } catch (e) {

package/src/commands/project.js

@@ -3,6 +3,7 @@ import chalk from 'chalk';
 import { table } from 'table';
 import { api } from '../services/api-service.js';
 import ora from 'ora';
+import { handleCommandError } from '../utils/error-handler.js';
 
 export function registerProjectCommand(program) {
     const projectCmd = new Command('project')
@@ -50,8 +51,7 @@ Common Actions:
 
                 console.log(table(tableData));
             } catch (e) {
-                spinner.fail('Failed to list projects');
-                console.error(e.message);
+                handleCommandError(spinner, e, 'Failed to list projects');
             }
         });