jira-pilot 2.0.4 → 2.1.0

package/package.json

@@ -1,23 +1,27 @@
 {
     "name": "jira-pilot",
-    "version": "2.0.4",
+    "version": "2.1.0",
     "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",
+    "main": "dist/src/index.js",
     "type": "module",
     "bin": {
-        "jira": "./bin/jira.js",
-        "jira-pilot": "./bin/jira.js"
+        "jira": "./dist/bin/jira.js",
+        "jira-pilot": "./dist/bin/jira.js"
     },
     "scripts": {
-        "start": "node bin/jira.js",
-        "mcp": "node bin/jira.js mcp",
+        "build": "tsc",
+        "start": "node dist/bin/jira.js",
+        "start:dev": "tsx bin/jira.ts",
+        "mcp": "node dist/bin/jira.js mcp",
+        "mcp:dev": "tsx bin/jira.ts mcp",
         "test": "vitest run",
         "test:watch": "vitest",
         "test:coverage": "vitest run --coverage",
-        "link": "npm link"
+        "link": "npm link",
+        "typecheck": "tsc --noEmit"
     },
     "engines": {
-        "node": ">=18.0.0"
+        "node": ">=20.0.0"
     },
     "files": [
         "bin/",
@@ -74,18 +78,20 @@
     "homepage": "https://github.com/Aarul5/jira-pilot#readme",
     "license": "ISC",
     "dependencies": {
-        "@modelcontextprotocol/sdk": "^0.6.0",
-        "axios": "^1.6.0",
+        "@modelcontextprotocol/sdk": "^1.26.0",
+        "axios": "^1.13.5",
         "chalk": "^5.3.0",
-        "commander": "^11.1.0",
-        "conf": "^12.0.0",
+        "cli-table3": "^0.6.5",
+        "commander": "^14.0.3",
         "enquirer": "^2.4.1",
-        "open": "^10.0.0",
-        "ora": "^8.0.0",
-        "table": "^6.8.0"
+        "open": "^11.0.0",
+        "ora": "^9.3.0"
     },
     "devDependencies": {
+        "@types/node": "^25.2.3",
         "@vitest/coverage-v8": "^4.0.18",
+        "tsx": "^4.21.0",
+        "typescript": "^5.9.3",
         "vitest": "^4.0.18"
     }
 }

package/src/commands/ai-actions/{plan.js → plan.ts}

@@ -7,7 +7,7 @@ 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) {
+export async function planAction(epicKey: string, options: any) {
     const check = validateIssueKey(epicKey);
     if (!check.valid) { console.error(chalk.red(check.message)); return; }
 
@@ -33,7 +33,7 @@ export async function planAction(epicKey, options) {
         console.log(chalk.cyan(`\nProposed Breakdown for ${epicKey} (${summary}):\n`));
 
         // Let user select items to create
-        const choices = plan.map((item, index) => ({
+        const choices = plan.map((item: any, index: number) => ({
             name: `${item.type}: ${item.summary}`,
             value: index, // store index to retrieve item
             checked: true
@@ -43,16 +43,16 @@ export async function planAction(epicKey, options) {
             type: 'multiselect',
             name: 'selectedIndices',
             message: 'Select issues to create:',
-            choices: choices.map((c, i) => ({ ...c, value: i })), // ensure value is index
-            result(names) {
+            choices: choices.map((c: any, i: number) => ({ ...c, value: i })), // ensure value is index
+            result(names: any) {
                 // map names back to indices
-                return names.map(name => this.map(name)); // 'this.map' returns value (index)
+                return names.map((name: any) => (this as any).map(name)); // 'this.map' returns value (index)
             }
-        });
+        }) as any;
 
         // Loop through selected and create
         // Convert map result (object/array) to array of indices
-        const indicesToCreate = Object.values(selectedIndices);
+        const indicesToCreate = Object.values(selectedIndices) as number[];
 
         if (indicesToCreate.length === 0) {
             console.log(chalk.yellow('No items selected.'));
@@ -71,7 +71,7 @@ export async function planAction(epicKey, options) {
                     fields: {
                         project: { key: projectKey },
                         summary: item.summary,
-                        description: item.description, // Simple string, Jira converts to ADF or accepts text depending on config. 
+                        // description: item.description, // Simple string, Jira converts to ADF or accepts text depending on config. 
                         // Note: v3 API often needs ADF. If description is simple text, it might fail.
                         // We should construct a basic paragraph ADF document.
                         description: {
@@ -113,7 +113,7 @@ export async function planAction(epicKey, options) {
 
         console.log(chalk.green(`\nDone! Created ${results.length} issues linked to ${epicKey}.`));
 
-    } catch (e) {
+    } catch (e: any) {
         handleCommandError(spinner, e, `Failed to plan ${epicKey}`);
     }
 }

package/src/commands/ai-actions/{review.js → review.ts}

@@ -9,7 +9,7 @@ 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) {
+export async function reviewAction(issueKey: string, options: any) {
     const check = validateIssueKey(issueKey);
     if (!check.valid) { console.error(chalk.red(check.message)); return; }
 
@@ -96,7 +96,7 @@ export async function reviewAction(issueKey, options) {
         console.log(review);
         console.log(chalk.dim(`\nPR Link: ${pr.html_url}`));
 
-    } catch (e) {
+    } catch (e: any) {
         handleCommandError(spinner, e, `Failed to review ${issueKey}`);
     }
 }

package/src/commands/ai-actions/{standup.js → standup.ts}

@@ -5,7 +5,7 @@ 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) {
+export async function standupAction(options: any) {
     const spinner = ora('Analyzing your recent activity...').start();
 
     try {
@@ -20,12 +20,12 @@ export async function standupAction(options) {
         const yesterdayJql = `assignee = currentUser() AND updated >= -1d ORDER BY updated DESC`;
 
         const yesterdayIssuesRes = await api.get(`/search?jql=${encodeURIComponent(yesterdayJql)}&fields=summary,status,comment,worklog`);
-        const yesterdayIssues = yesterdayIssuesRes.issues.map(i => `- ${i.key} ${i.fields.summary} (${i.fields.status.name})`).join('\n');
+        const yesterdayIssues = yesterdayIssuesRes.issues.map((i: any) => `- ${i.key} ${i.fields.summary} (${i.fields.status.name})`).join('\n');
 
         // 3. Fetch Issues Assigned for Today (In Progress or To Do)
         const todayJql = `assignee = currentUser() AND statusCategory IN ("To Do", "In Progress") ORDER BY priority DESC`;
         const todayIssuesRes = await api.get(`/search?jql=${encodeURIComponent(todayJql)}&fields=summary,status,priority`);
-        const todayIssues = todayIssuesRes.issues.map(i => `- ${i.key} ${i.fields.summary} [${i.fields.priority.name}]`).join('\n');
+        const todayIssues = todayIssuesRes.issues.map((i: any) => `- ${i.key} ${i.fields.summary} [${i.fields.priority.name}]`).join('\n');
 
         spinner.text = 'Generating standup report...';
 
@@ -36,7 +36,7 @@ export async function standupAction(options) {
         console.log(chalk.green(`\n📢 Standup Report for ${displayName}:\n`));
         console.log(report);
 
-    } catch (e) {
+    } catch (e: any) {
         handleCommandError(spinner, e, 'Failed to generate standup');
     }
 }

package/src/commands/{ai.js → ai.ts}

@@ -11,7 +11,7 @@ import { reviewAction } from './ai-actions/review.js';
 import { planAction } from './ai-actions/plan.js';
 import { standupAction } from './ai-actions/standup.js';
 
-export function registerAiCommand(program) {
+export function registerAiCommand(program: Command) {
     const aiCmd = new Command('ai')
         .description('AI Helper commands')
         .addHelpText('after', `
@@ -26,7 +26,7 @@ Common Actions:
         .command('summarize')
         .description('Summarize an issue using AI')
         .argument('<issueKey>', 'Jira Issue Key')
-        .action(async (issueKey) => {
+        .action(async (issueKey: string) => {
             const check = validateIssueKey(issueKey);
             if (!check.valid) { console.error(chalk.red(check.message)); return; }
             const spinner = ora(`Fetching issue ${issueKey}...`).start();
@@ -39,7 +39,7 @@ Common Actions:
                     ? 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}`)
+                    .map((c: any) => `${c.author.displayName}: ${typeof c.body === 'object' ? parseADF(c.body) : c.body}`)
                     .join('\n');
 
                 const prompt = `
@@ -60,7 +60,7 @@ Provide a concise summary of the current status, key discussion points, and next
                 console.log(chalk.green(`\n🤖 AI Summary for ${issueKey}:\n`));
                 console.log(aiResponse);
 
-            } catch (e) {
+            } catch (e: any) {
                 handleCommandError(spinner, e, `Failed to summarize ${issueKey}`);
             }
         });
@@ -77,7 +77,7 @@ Examples:
   $ jira ai draft -i "login fails, returns 500, only on mobile"
   $ jira ai draft -i "add dark mode toggle" -t story
         `)
-        .action(async (options) => {
+        .action(async (options: any) => {
             try {
                 let bulletPoints = options.input;
 
@@ -86,8 +86,8 @@ Examples:
                         type: 'input',
                         name: 'inputNotes',
                         message: 'Enter your bullet points or rough notes:',
-                        validate: (val) => val.trim().length > 0 || 'Input cannot be empty'
-                    });
+                        validate: (val: any) => val.trim().length > 0 || 'Input cannot be empty'
+                    }) as any;
                     bulletPoints = inputNotes;
                 }
 
@@ -122,7 +122,7 @@ Keep it professional and concise. Output in plain text (not markdown headers, us
                 console.log(aiResponse);
                 console.log(chalk.grey('\nTip: Copy this into "jira issue create" or use it as a starting point.'));
 
-            } catch (e) {
+            } catch (e: any) {
                 handleCommandError(null, e, 'Failed to generate draft');
             }
         });
@@ -132,7 +132,7 @@ Keep it professional and concise. Output in plain text (not markdown headers, us
         .command('suggest')
         .description('Suggest next actions for an issue based on its context')
         .argument('<issueKey>', 'Jira Issue Key')
-        .action(async (issueKey) => {
+        .action(async (issueKey: string) => {
             const check = validateIssueKey(issueKey);
             if (!check.valid) { console.error(chalk.red(check.message)); return; }
             const spinner = ora(`Analyzing issue ${issueKey}...`).start();
@@ -149,7 +149,7 @@ Keep it professional and concise. Output in plain text (not markdown headers, us
                 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}`)
+                    .map((c: any) => `${c.author.displayName}: ${typeof c.body === 'object' ? parseADF(c.body) : c.body}`)
                     .join('\n');
 
                 spinner.text = 'Generating suggestions...';
@@ -183,7 +183,7 @@ Keep suggestions actionable and concise.
                 console.log(chalk.green(`\n💡 AI Suggestions for ${issueKey}:\n`));
                 console.log(aiResponse);
 
-            } catch (e) {
+            } catch (e: any) {
                 handleCommandError(spinner, e, `Failed to suggest for ${issueKey}`);
             }
         });

package/src/commands/{board.js → board.ts}

@@ -1,11 +1,11 @@
 import { Command } from 'commander';
 import chalk from 'chalk';
-import { table } from 'table';
+import Table from 'cli-table3';
 import { api } from '../services/api-service.js';
 import ora from 'ora';
 import { handleCommandError } from '../utils/error-handler.js';
 
-export function registerBoardCommand(program) {
+export function registerBoardCommand(program: Command) {
     const boardCmd = new Command('board')
         .description('Manage Jira boards')
         .addHelpText('after', `
@@ -21,7 +21,7 @@ Common Actions:
         .option('-t, --type <type>', 'Filter by board type (scrum, kanban, simple)')
         .option('-l, --limit <n>', 'Max results', '50')
         .option('-o, --output <format>', 'Output format (json)')
-        .action(async (options) => {
+        .action(async (options: any) => {
             const spinner = ora('Fetching boards...').start();
             try {
                 const params = new URLSearchParams();
@@ -43,19 +43,19 @@ Common Actions:
                 }
 
                 if (options.output === 'json') {
-                    console.log(JSON.stringify(data.values.map(b => ({
+                    console.log(JSON.stringify(data.values.map((b: any) => ({
                         id: b.id, name: b.name,
                         type: b.type, project: b.location?.projectKey || null
                     })), null, 2));
                     return;
                 }
 
-                const tableData = [
-                    [chalk.bold('ID'), chalk.bold('Name'), chalk.bold('Type'), chalk.bold('Project')]
-                ];
+                const table = new Table({
+                    head: [chalk.bold('ID'), chalk.bold('Name'), chalk.bold('Type'), chalk.bold('Project')]
+                });
 
-                data.values.forEach(b => {
-                    tableData.push([
+                data.values.forEach((b: any) => {
+                    table.push([
                         b.id,
                         b.name,
                         b.type,
@@ -63,10 +63,10 @@ Common Actions:
                     ]);
                 });
 
-                console.log(table(tableData));
+                console.log(table.toString());
                 console.log(chalk.grey(`Showing ${data.values.length} board(s)`));
 
-            } catch (e) {
+            } catch (e: any) {
                 handleCommandError(spinner, e, 'Failed to list boards');
             }
         });

package/src/commands/bulk.ts

@@ -0,0 +1,230 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import enquirer from 'enquirer';
+import { api } from '../services/api-service.js';
+import { handleCommandError } from '../utils/error-handler.js';
+
+export function registerBulkCommand(program: Command) {
+    const bulkCmd = new Command('bulk')
+        .description('Bulk operations on Jira issues')
+        .addHelpText('after', `
+Common Actions:
+  $ jira bulk transition -j "project = PROJ AND status = 'To Do'" -s "In Progress"
+        `);
+
+    // ── BULK TRANSITION ──────────────────────────────────────────────
+    bulkCmd
+        .command('transition')
+        .description('Transition multiple issues matching a JQL filter')
+        .requiredOption('-j, --jql <query>', 'JQL query to select issues')
+        .option('-s, --status <name>', 'Target status name')
+        .option('-y, --yes', 'Skip confirmation prompt')
+        .option('-l, --limit <n>', 'Max issues to process', '50')
+        .addHelpText('after', `
+Examples:
+  $ jira bulk transition -j "project = PROJ AND status = 'To Do'" -s "In Progress"
+  $ jira bulk transition -j "assignee = currentUser() AND status = Review" -s Done -y
+        `)
+        .action(async (options: any) => {
+            const spinner = ora('Finding matching issues...').start();
+            try {
+                const data = await api.post('/search/jql', {
+                    jql: options.jql,
+                    maxResults: parseInt(options.limit),
+                    fields: ['summary', 'status']
+                });
+                spinner.stop();
+
+                if (!data.issues || data.issues.length === 0) {
+                    console.log(chalk.yellow('No issues match the query.'));
+                    return;
+                }
+
+                console.log(chalk.bold(`\nFound ${data.issues.length} issue(s):\n`));
+                data.issues.forEach((i: any) => {
+                    console.log(`  ${chalk.cyan(i.key)} ${i.fields.summary} [${i.fields.status.name}]`);
+                });
+
+                let targetStatus = options.status;
+
+                if (!targetStatus) {
+                    // Get transitions from the first issue to show available statuses
+                    const transData = await api.get(`/issue/${data.issues[0].key}/transitions`);
+                    const { Select } = enquirer as any;
+                    const statusSelect = new Select({
+                        name: 'status',
+                        message: 'Target status',
+                        choices: transData.transitions.map((t: any) => ({ name: t.name, message: t.name }))
+                    });
+                    targetStatus = await statusSelect.run();
+                }
+
+                if (!options.yes) {
+                    const { Confirm } = enquirer as any;
+                    const confirm = new Confirm({
+                        name: 'proceed',
+                        message: `Transition ${data.issues.length} issue(s) to "${targetStatus}"?`
+                    });
+                    if (!await confirm.run()) {
+                        console.log(chalk.yellow('Cancelled.'));
+                        return;
+                    }
+                }
+
+                const transSpinner = ora(`Transitioning ${data.issues.length} issue(s)...`).start();
+                let success = 0;
+                let failed = 0;
+
+                for (const issue of data.issues) {
+                    try {
+                        const transData = await api.get(`/issue/${issue.key}/transitions`);
+                        const transition = transData.transitions.find(
+                            (t: any) => t.name.toLowerCase() === targetStatus.toLowerCase()
+                        );
+
+                        if (transition) {
+                            await api.post(`/issue/${issue.key}/transitions`, {
+                                transition: { id: transition.id }
+                            });
+                            success++;
+                        } else {
+                            failed++;
+                        }
+                    } catch {
+                        failed++;
+                    }
+                    transSpinner.text = `Transitioning... (${success + failed}/${data.issues.length})`;
+                }
+
+                transSpinner.succeed(`Done: ${chalk.green(`${success} succeeded`)}, ${failed > 0 ? chalk.red(`${failed} failed`) : '0 failed'}`);
+
+            } catch (e: any) {
+                handleCommandError(spinner, e, 'Bulk transition failed');
+            }
+        });
+
+    // ── BULK ASSIGN ──────────────────────────────────────────────────
+    bulkCmd
+        .command('assign')
+        .description('Assign multiple issues')
+        .requiredOption('-j, --jql <query>', 'JQL query')
+        .option('-a, --assignee <id>', 'AccountId or "me"')
+        .option('-y, --yes', 'Skip confirmation')
+        .action(async (options: any) => {
+            const spinner = ora('Finding issues...').start();
+            try {
+                const data = await api.post('/search/jql', {
+                    jql: options.jql,
+                    maxResults: 50,
+                    fields: ['summary', 'assignee']
+                });
+                spinner.stop();
+
+                if (!data.issues?.length) {
+                    console.log(chalk.yellow('No issues found.'));
+                    return;
+                }
+
+                console.log(chalk.bold(`Found ${data.issues.length} issue(s):`));
+                data.issues.forEach((i: any) => console.log(`  ${i.key}: ${i.fields.summary} (${i.fields.assignee?.displayName || 'Unassigned'})`));
+
+                let assigneeId = options.assignee;
+                if (!assigneeId) {
+                    const { userId } = await enquirer.prompt({
+                        type: 'input',
+                        name: 'userId',
+                        message: 'Enter Account ID (or "me"):',
+                        validate: (val: string) => val.length > 0
+                    }) as any;
+                    assigneeId = userId;
+                }
+
+                if (assigneeId === 'me') {
+                    const me = await api.get('/myself');
+                    assigneeId = me.accountId;
+                }
+
+                if (!options.yes) {
+                    const { confirm } = await enquirer.prompt({
+                        type: 'confirm',
+                        name: 'confirm',
+                        message: `Assign ${data.issues.length} issues to ${assigneeId}?`
+                    }) as any;
+                    if (!confirm) return;
+                }
+
+                const processSpinner = ora('Assigning...').start();
+                for (const issue of data.issues) {
+                    await api.put(`/issue/${issue.key}/assignee`, { accountId: assigneeId });
+                }
+                processSpinner.succeed('Bulk assign complete.');
+
+            } catch (e: any) {
+                handleCommandError(spinner, e, 'Bulk assign failed');
+            }
+        });
+
+    // ── BULK LABEL ───────────────────────────────────────────────────
+    bulkCmd
+        .command('label')
+        .description('Add or remove labels from multiple issues')
+        .requiredOption('-j, --jql <query>', 'JQL query')
+        .option('--add <labels>', 'Comma-separated labels to add')
+        .option('--remove <labels>', 'Comma-separated labels to remove')
+        .option('-y, --yes', 'Skip confirmation')
+        .action(async (options: any) => {
+            if (!options.add && !options.remove) {
+                console.log(chalk.red('Must specify --add or --remove'));
+                return;
+            }
+
+            const spinner = ora('Finding issues...').start();
+            try {
+                const data = await api.post('/search/jql', {
+                    jql: options.jql,
+                    maxResults: 50,
+                    fields: ['summary', 'labels']
+                });
+                spinner.stop();
+
+                if (!data.issues?.length) {
+                    console.log(chalk.yellow('No issues found.'));
+                    return;
+                }
+
+                console.log(chalk.bold(`Found ${data.issues.length} issue(s).`));
+
+                if (!options.yes) {
+                    const { confirm } = await enquirer.prompt({
+                        type: 'confirm',
+                        name: 'confirm',
+                        message: `Update labels for ${data.issues.length} issues?`
+                    }) as any;
+                    if (!confirm) return;
+                }
+
+                const processSpinner = ora('Updating labels...').start();
+                const addList = options.add ? options.add.split(',').map((l: string) => l.trim()) : [];
+                const removeList = options.remove ? options.remove.split(',').map((l: string) => l.trim()) : [];
+
+                for (const issue of data.issues) {
+                    const currentLabels = issue.fields.labels || [];
+                    let newLabels = new Set(currentLabels);
+
+                    addList.forEach((l: string) => newLabels.add(l));
+                    removeList.forEach((l: string) => newLabels.delete(l));
+
+                    await api.put(`/issue/${issue.key}`, {
+                        fields: { labels: Array.from(newLabels) }
+                    });
+                }
+                processSpinner.succeed('Bulk labels updated.');
+
+            } catch (e: any) {
+                handleCommandError(spinner, e, 'Bulk label failed');
+            }
+        });
+
+    program.addCommand(bulkCmd);
+}