jira-pilot 2.0.0 → 2.0.2

package/src/commands/ai.js

@@ -1,204 +1,232 @@
-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')
-        .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')
-        .argument('<issueKey>', 'Jira Issue Key')
-        .action(async (issueKey) => {
-            const spinner = ora(`Fetching issue ${issueKey}...`).start();
-            try {
-                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
-                    ? 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 || 'No comments'}
-
-Provide a concise summary of the current status, key discussion points, and next steps if clear.
-            `;
-
-                const aiResponse = await aiService.generate(prompt);
-                spinner.stop();
-
-                console.log(chalk.green(`\n🤖 AI Summary for ${issueKey}:\n`));
-                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));
-                    }
-                }
-            }
-        });
-
-    // ── 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);
-}
+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';
+import { validateIssueKey } from '../utils/validators.js';
+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) {
+    const aiCmd = new Command('ai')
+        .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')
+        .argument('<issueKey>', 'Jira Issue Key')
+        .action(async (issueKey) => {
+            const check = validateIssueKey(issueKey);
+            if (!check.valid) { console.error(chalk.red(check.message)); return; }
+            const spinner = ora(`Fetching issue ${issueKey}...`).start();
+            try {
+                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
+                    ? 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 || 'No comments'}
+
+Provide a concise summary of the current status, key discussion points, and next steps if clear.
+            `;
+
+                const aiResponse = await aiService.generate(prompt);
+                spinner.stop();
+
+                console.log(chalk.green(`\n🤖 AI Summary for ${issueKey}:\n`));
+                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));
+                    }
+                }
+            }
+        });
+
+    // ── 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 check = validateIssueKey(issueKey);
+            if (!check.valid) { console.error(chalk.red(check.message)); return; }
+            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));
+                }
+            }
+        });
+
+    // ── REVIEW ────────────────────────────────────────────────────────
+    aiCmd
+        .command('review')
+        .description('Analyze linked code/PRs for an issue')
+        .argument('<issueKey>', 'Jira Issue Key')
+        .action(reviewAction);
+
+    // ── PLAN ──────────────────────────────────────────────────────────
+    aiCmd
+        .command('plan')
+        .description('Break down an Epic into child stories/tasks')
+        .argument('<epicKey>', 'Epic Issue Key')
+        .action(planAction);
+
+    // ── STANDUP ───────────────────────────────────────────────────────
+    aiCmd
+        .command('standup')
+        .description('Generate a daily standup report from activity')
+        .action(standupAction);
+
+    program.addCommand(aiCmd);
+}

package/src/commands/board.js

@@ -1,66 +1,75 @@
-import { Command } from 'commander';
-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 registerBoardCommand(program) {
-    const boardCmd = new Command('board')
-        .description('Manage Jira boards')
-        .addHelpText('after', `
-Common Actions:
-  $ jira board list                   # List all boards
-  $ jira board list -p PROJ           # List boards for a project
-        `);
-
-    boardCmd
-        .command('list')
-        .description('List Jira boards')
-        .option('-p, --project <key>', 'Filter by project key')
-        .option('-t, --type <type>', 'Filter by board type (scrum, kanban, simple)')
-        .option('-l, --limit <n>', 'Max results', '50')
-        .action(async (options) => {
-            const spinner = ora('Fetching boards...').start();
-            try {
-                const params = new URLSearchParams();
-                params.set('maxResults', options.limit);
-
-                if (options.project) {
-                    params.set('projectKeyOrId', options.project);
-                }
-                if (options.type) {
-                    params.set('type', options.type);
-                }
-
-                const data = await api.agileGet(`/board?${params.toString()}`);
-                spinner.stop();
-
-                if (!data.values || data.values.length === 0) {
-                    console.log(chalk.yellow('No boards found.'));
-                    return;
-                }
-
-                const tableData = [
-                    [chalk.bold('ID'), chalk.bold('Name'), chalk.bold('Type'), chalk.bold('Project')]
-                ];
-
-                data.values.forEach(b => {
-                    tableData.push([
-                        b.id,
-                        b.name,
-                        b.type,
-                        b.location?.projectKey || '-'
-                    ]);
-                });
-
-                console.log(table(tableData));
-                console.log(chalk.grey(`Showing ${data.values.length} board(s)`));
-
-            } catch (e) {
-                handleCommandError(spinner, e, 'Failed to list boards');
-            }
-        });
-
-    program.addCommand(boardCmd);
-}
+import { Command } from 'commander';
+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 registerBoardCommand(program) {
+    const boardCmd = new Command('board')
+        .description('Manage Jira boards')
+        .addHelpText('after', `
+Common Actions:
+  $ jira board list                   # List all boards
+  $ jira board list -p PROJ           # List boards for a project
+        `);
+
+    boardCmd
+        .command('list')
+        .description('List Jira boards')
+        .option('-p, --project <key>', 'Filter by project key')
+        .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) => {
+            const spinner = ora('Fetching boards...').start();
+            try {
+                const params = new URLSearchParams();
+                params.set('maxResults', options.limit);
+
+                if (options.project) {
+                    params.set('projectKeyOrId', options.project);
+                }
+                if (options.type) {
+                    params.set('type', options.type);
+                }
+
+                const data = await api.agileGet(`/board?${params.toString()}`);
+                spinner.stop();
+
+                if (!data.values || data.values.length === 0) {
+                    console.log(chalk.yellow('No boards found.'));
+                    return;
+                }
+
+                if (options.output === 'json') {
+                    console.log(JSON.stringify(data.values.map(b => ({
+                        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')]
+                ];
+
+                data.values.forEach(b => {
+                    tableData.push([
+                        b.id,
+                        b.name,
+                        b.type,
+                        b.location?.projectKey || '-'
+                    ]);
+                });
+
+                console.log(table(tableData));
+                console.log(chalk.grey(`Showing ${data.values.length} board(s)`));
+
+            } catch (e) {
+                handleCommandError(spinner, e, 'Failed to list boards');
+            }
+        });
+
+    program.addCommand(boardCmd);
+}