jira-pilot 2.0.1 → 2.0.3

package/bin/jira.js

@@ -1,56 +1,63 @@
 #!/usr/bin/env node
-import { Command } from 'commander';
-import chalk from 'chalk';
-import { readFileSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-
-// Load package.json for version
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
-
-const program = new Command();
-
-program
-    .name('jira')
-    .description('AI-powered Jira CLI for humans and agents')
-    .version(pkg.version)
-    .addHelpText('after', `
-Examples:
-  $ jira issue list
-  $ jira issue view PROJ-123
-  $ jira issue create
-  $ jira board list
-  $ jira sprint list --board 123
-  $ jira ai summarize PROJ-123
-    `);
-
-import { registerConfigCommand } from '../src/commands/config.js';
-import { registerIssueCommand } from '../src/commands/issue.js';
-import { registerProjectCommand } from '../src/commands/project.js';
-import { registerSprintCommand } from '../src/commands/sprint.js';
-import { registerBoardCommand } from '../src/commands/board.js';
-import { registerGitCommand } from '../src/commands/git.js';
-import { registerAiCommand } from '../src/commands/ai.js';
-import { registerMcpCommand } from '../src/commands/mcp.js';
-
-// Register Commands
-registerConfigCommand(program);
-registerIssueCommand(program);
-registerProjectCommand(program);
-registerSprintCommand(program);
-registerBoardCommand(program);
-registerGitCommand(program);
-registerAiCommand(program);
-registerMcpCommand(program);
-
-program.on('command:*', () => {
-    console.error(chalk.red('Invalid command: %s\nSee --help for a list of available commands.'), program.args.join(' '));
-    process.exit(1);
-});
-
-if (!process.argv.slice(2).length) {
-    program.outputHelp();
-}
-
-program.parse(process.argv);
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+// Load package.json for version
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+
+const program = new Command();
+
+program
+    .name('jira')
+    .description('AI-powered Jira CLI for humans and agents')
+    .version(pkg.version)
+    .addHelpText('after', `
+Examples:
+  $ jira dashboard
+  $ jira issue list
+  $ jira issue view PROJ-123
+  $ jira issue create
+  $ jira issue search "login bug"
+  $ jira board list
+  $ jira sprint list --board 123
+  $ jira bulk transition -j "project = PROJ" -s Done
+  $ jira ai summarize PROJ-123
+    `);
+
+import { registerConfigCommand } from '../src/commands/config.js';
+import { registerIssueCommand } from '../src/commands/issue.js';
+import { registerProjectCommand } from '../src/commands/project.js';
+import { registerSprintCommand } from '../src/commands/sprint.js';
+import { registerBoardCommand } from '../src/commands/board.js';
+import { registerGitCommand } from '../src/commands/git.js';
+import { registerAiCommand } from '../src/commands/ai.js';
+import { registerMcpCommand } from '../src/commands/mcp.js';
+import { registerBulkCommand } from '../src/commands/bulk.js';
+import { registerDashboardCommand } from '../src/commands/dashboard.js';
+
+// Register Commands
+registerConfigCommand(program);
+registerIssueCommand(program);
+registerProjectCommand(program);
+registerSprintCommand(program);
+registerBoardCommand(program);
+registerGitCommand(program);
+registerAiCommand(program);
+registerMcpCommand(program);
+registerBulkCommand(program);
+registerDashboardCommand(program);
+
+program.on('command:*', () => {
+    console.error(chalk.red('Invalid command: %s\nSee --help for a list of available commands.'), program.args.join(' '));
+    process.exit(1);
+});
+
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}
+
+program.parse(process.argv);

package/package.json

@@ -1,91 +1,91 @@
-{
-    "name": "jira-pilot",
-    "version": "2.0.1",
-    "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",
-    "main": "src/index.js",
-    "type": "module",
-    "bin": {
-        "jira": "./bin/jira.js",
-        "jira-pilot": "./bin/jira.js"
-    },
-    "scripts": {
-        "start": "node bin/jira.js",
-        "mcp": "node bin/jira.js mcp",
-        "test": "vitest run",
-        "test:watch": "vitest",
-        "test:coverage": "vitest run --coverage",
-        "link": "npm link"
-    },
-    "engines": {
-        "node": ">=18.0.0"
-    },
-    "files": [
-        "bin/",
-        "src/",
-        "README.md",
-        "LICENSE"
-    ],
-    "keywords": [
-        "jira",
-        "cli",
-        "jira-cli",
-        "jira-client",
-        "jira-api",
-        "atlassian",
-        "atlassian-jira",
-        "ai",
-        "ai-cli",
-        "openai",
-        "gemini",
-        "anthropic",
-        "claude",
-        "gpt",
-        "mcp",
-        "model-context-protocol",
-        "ai-agent",
-        "agent",
-        "issue-tracker",
-        "project-management",
-        "task-management",
-        "sprint",
-        "kanban",
-        "scrum",
-        "agile",
-        "command-line",
-        "interactive",
-        "terminal",
-        "developer-tools",
-        "devtools",
-        "productivity",
-        "workflow",
-        "git-integration"
-    ],
-    "author": {
-        "name": "Arul",
-        "url": "https://github.com/Aarul5"
-    },
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/Aarul5/jira-pilot.git"
-    },
-    "bugs": {
-        "url": "https://github.com/Aarul5/jira-pilot/issues"
-    },
-    "homepage": "https://github.com/Aarul5/jira-pilot#readme",
-    "license": "ISC",
-    "dependencies": {
-        "@modelcontextprotocol/sdk": "^0.6.0",
-        "axios": "^1.6.0",
-        "chalk": "^5.3.0",
-        "commander": "^11.1.0",
-        "conf": "^12.0.0",
-        "enquirer": "^2.4.1",
-        "open": "^10.0.0",
-        "ora": "^8.0.0",
-        "table": "^6.8.0"
-    },
-    "devDependencies": {
-        "@vitest/coverage-v8": "^4.0.18",
-        "vitest": "^4.0.18"
-    }
+{
+    "name": "jira-pilot",
+    "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": {
+        "jira": "./bin/jira.js",
+        "jira-pilot": "./bin/jira.js"
+    },
+    "scripts": {
+        "start": "node bin/jira.js",
+        "mcp": "node bin/jira.js mcp",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "test:coverage": "vitest run --coverage",
+        "link": "npm link"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "files": [
+        "bin/",
+        "src/",
+        "README.md",
+        "LICENSE"
+    ],
+    "keywords": [
+        "jira",
+        "cli",
+        "jira-cli",
+        "jira-client",
+        "jira-api",
+        "atlassian",
+        "atlassian-jira",
+        "ai",
+        "ai-cli",
+        "openai",
+        "gemini",
+        "anthropic",
+        "claude",
+        "gpt",
+        "mcp",
+        "model-context-protocol",
+        "ai-agent",
+        "agent",
+        "issue-tracker",
+        "project-management",
+        "task-management",
+        "sprint",
+        "kanban",
+        "scrum",
+        "agile",
+        "command-line",
+        "interactive",
+        "terminal",
+        "developer-tools",
+        "devtools",
+        "productivity",
+        "workflow",
+        "git-integration"
+    ],
+    "author": {
+        "name": "Arul",
+        "url": "https://github.com/Aarul5"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/Aarul5/jira-pilot.git"
+    },
+    "bugs": {
+        "url": "https://github.com/Aarul5/jira-pilot/issues"
+    },
+    "homepage": "https://github.com/Aarul5/jira-pilot#readme",
+    "license": "ISC",
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^0.6.0",
+        "axios": "^1.6.0",
+        "chalk": "^5.3.0",
+        "commander": "^11.1.0",
+        "conf": "^12.0.0",
+        "enquirer": "^2.4.1",
+        "open": "^10.0.0",
+        "ora": "^8.0.0",
+        "table": "^6.8.0"
+    },
+    "devDependencies": {
+        "@vitest/coverage-v8": "^4.0.18",
+        "vitest": "^4.0.18"
+    }
 }

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

@@ -0,0 +1,119 @@
+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 { 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);
+    if (!check.valid) { console.error(chalk.red(check.message)); return; }
+
+    const spinner = ora(`Fetching Epic ${epicKey}...`).start();
+
+    try {
+        const issue = await api.get(`/issue/${epicKey}`);
+        const summary = issue.fields.summary;
+        const description = issue.fields.description ? parseADF(issue.fields.description) : 'No description';
+        const projectKey = issue.fields.project.key;
+
+        spinner.text = 'AI is breaking down the Epic...';
+
+        const plan = await aiService.breakdownEpic(summary, description);
+
+        spinner.stop();
+
+        if (!plan || plan.length === 0) {
+            console.log(chalk.yellow('AI could not generate a plan.'));
+            return;
+        }
+
+        console.log(chalk.cyan(`\nProposed Breakdown for ${epicKey} (${summary}):\n`));
+
+        // Let user select items to create
+        const choices = plan.map((item, index) => ({
+            name: `${item.type}: ${item.summary}`,
+            value: index, // store index to retrieve item
+            checked: true
+        }));
+
+        const { selectedIndices } = await enquirer.prompt({
+            type: 'multiselect',
+            name: 'selectedIndices',
+            message: 'Select issues to create:',
+            choices: choices.map((c, i) => ({ ...c, value: i })), // ensure value is index
+            result(names) {
+                // map names back to indices
+                return names.map(name => this.map(name)); // 'this.map' returns value (index)
+            }
+        });
+
+        // Loop through selected and create
+        // Convert map result (object/array) to array of indices
+        const indicesToCreate = Object.values(selectedIndices);
+
+        if (indicesToCreate.length === 0) {
+            console.log(chalk.yellow('No items selected.'));
+            return;
+        }
+
+        console.log(chalk.dim('\nCreating issues...'));
+
+        const results = [];
+        for (const idx of indicesToCreate) {
+            const item = plan[idx];
+            const itemSpinner = ora(`Creating ${item.type}: ${item.summary}`).start();
+
+            try {
+                const payload = {
+                    fields: {
+                        project: { key: projectKey },
+                        summary: item.summary,
+                        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: {
+                            version: 1,
+                            type: 'doc',
+                            content: [{
+                                type: 'paragraph',
+                                content: [{ type: 'text', text: item.description || '' }]
+                            }]
+                        },
+                        issuetype: { name: item.type },
+                        parent: { key: epicKey } // Try to link to Epic
+                    }
+                };
+
+                const res = await api.post('/issue', payload);
+                itemSpinner.succeed(`${res.key} created.`);
+                results.push(res.key);
+            } catch (e) {
+                itemSpinner.fail(`Failed to create ${item.summary}.`);
+                // Fallback: try without description if ADF error
+                try {
+                    const payloadNoDesc = {
+                        fields: {
+                            project: { key: projectKey },
+                            summary: item.summary,
+                            issuetype: { name: item.type },
+                            parent: { key: epicKey }
+                        }
+                    };
+                    const res = await api.post('/issue', payloadNoDesc);
+                    itemSpinner.succeed(`${res.key} created (without description).`);
+                    results.push(res.key);
+                } catch (e2) {
+                    // ignore
+                }
+            }
+        }
+
+        console.log(chalk.green(`\nDone! Created ${results.length} issues linked to ${epicKey}.`));
+
+    } catch (e) {
+        handleCommandError(spinner, e, `Failed to plan ${epicKey}`);
+    }
+}

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

@@ -0,0 +1,102 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import axios from 'axios';
+import { execSync } from 'child_process';
+import { api } from '../../services/api-service.js';
+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);
+    if (!check.valid) { console.error(chalk.red(check.message)); return; }
+
+    const { githubToken } = getCredentials();
+    if (!githubToken) {
+        console.error(chalk.red('GitHub Token not found. Run "jira config setup" or manually add githubToken to config.'));
+        return;
+    }
+
+    const spinner = ora(`Fetching issue ${issueKey} and searching for PRs...`).start();
+
+    try {
+        // 1. Fetch Issue Context
+        const issue = await api.get(`/issue/${issueKey}?fields=summary,description,acceptanceCriteria`); // basic fields
+        const summary = issue.fields.summary;
+        const description = issue.fields.description ? parseADF(issue.fields.description) : 'No description';
+        const context = `Title: ${summary}\nDescription: ${description}`;
+
+        // 2. Determine GitHub Repo from local git
+        let repoOwner, repoName;
+        try {
+            const remoteUrl = execSync('git remote get-url origin', { encoding: 'utf8' }).trim();
+            // Parse: https://github.com/owner/repo.git or git@github.com:owner/repo.git
+            const match = remoteUrl.match(/github\.com[:/]([^/]+)\/([^.]+)/);
+            if (match) {
+                repoOwner = match[1];
+                repoName = match[2];
+            }
+        } catch (e) {
+            // Ignore, maybe not in a repo
+        }
+
+        if (!repoOwner || !repoName) {
+            spinner.fail('Could not detect GitHub repository from "git remote get-url origin".');
+            console.log(chalk.yellow('Ensure you are in the git repository folder.'));
+            return;
+        }
+
+        spinner.text = `Searching PRs in ${repoOwner}/${repoName} for ${issueKey}...`;
+
+        // 3. Search GitHub PRs
+        // We search for PRs that mention the issue key in title or branch name
+        const searchRes = await axios.get(`https://api.github.com/search/issues`, {
+            params: {
+                q: `repo:${repoOwner}/${repoName} is:pr ${issueKey}`
+            },
+            headers: {
+                'Authorization': `token ${githubToken}`,
+                'Accept': 'application/vnd.github.v3+json'
+            }
+        });
+
+        const prs = searchRes.data.items;
+        if (prs.length === 0) {
+            spinner.fail(`No open PRs found for ${issueKey} in ${repoOwner}/${repoName}.`);
+            return;
+        }
+
+        // Use the most recent PR
+        const pr = prs[0];
+        spinner.text = `Analyzing PR #${pr.number}: ${pr.title}...`;
+
+        // 4. Fetch Diff
+        const diffRes = await axios.get(pr.pull_request.url, {
+            headers: {
+                'Authorization': `token ${githubToken}`,
+                'Accept': 'application/vnd.github.v3.diff'
+            }
+        });
+        const diff = diffRes.data;
+
+        if (!diff) {
+            spinner.fail('Empty diff or failed to fetch diff.');
+            return;
+        }
+
+        // 5. AI Review
+        spinner.text = 'AI is reviewing the code changes...';
+        const review = await aiService.reviewCode(diff, context);
+
+        spinner.stop();
+
+        console.log(chalk.green(`\n🤖 AI Code Review for PR #${pr.number} (${issueKey}):\n`));
+        console.log(review);
+        console.log(chalk.dim(`\nPR Link: ${pr.html_url}`));
+
+    } catch (e) {
+        handleCommandError(spinner, e, `Failed to review ${issueKey}`);
+    }
+}

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

@@ -0,0 +1,42 @@
+import chalk from 'chalk';
+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();
+
+    try {
+        // 1. Fetch User Info
+        const myself = await api.get('/myself');
+        const accountId = myself.accountId;
+        const displayName = myself.displayName;
+
+        // 2. Fetch Issues Updated/Commented by User in last 24h
+        // JQL: updated >= -24h AND (assignee = currentUser() OR watcher = currentUser() OR comment ~ currentUser())
+        // Simplification: JQL: assignee = currentUser() AND updated >= -1d
+        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');
+
+        // 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');
+
+        spinner.text = 'Generating standup report...';
+
+        const report = await aiService.generateStandup(yesterdayIssues, todayIssues);
+
+        spinner.stop();
+
+        console.log(chalk.green(`\n📢 Standup Report for ${displayName}:\n`));
+        console.log(report);
+
+    } catch (e) {
+        handleCommandError(spinner, e, 'Failed to generate standup');
+    }
+}