jira-pilot 1.0.1 → 1.0.2

package/README.md

@@ -87,7 +87,7 @@ jira issue list --export json  # Creates issues-TIMESTAMP.json
 jira issue list --export md    # Creates issues-TIMESTAMP.md
 
 # Combine filters and export (Power User)
-jira issue list --project TRAIN --assignee <assignee_name> --status Done --export json
+jira issue list --project "project-name" --assignee "assignee_name" --status Done --export json
 ```
 
 ### Projects & Sprints

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';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "jira-pilot",
-    "version": "1.0.1",
+    "version": "1.0.2",
     "description": "AI-powered Jira CLI for humans and agents",
     "main": "src/index.js",
     "type": "module",

package/src/commands/ai.js

@@ -42,8 +42,17 @@ export function registerAiCommand(program) {
                 console.log(aiResponse);
 
             } catch (e) {
-                spinner.fail('Failed to generate summary');
-                console.error(chalk.red(e.message));
+                spinner.stop(); // Ensure spinner stops
+                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));
+                    }
+                }
             }
         });
 

package/src/commands/config.js

@@ -36,6 +36,27 @@ export function registerConfigCommand(program) {
                         name: 'apiToken',
                         message: 'Jira API Token:',
                         initial: current.apiToken ? '*****' : undefined
+                    },
+                    {
+                        type: 'confirm',
+                        name: 'aiEnabled',
+                        message: 'Enable AI features?',
+                        initial: current.aiEnabled || false
+                    },
+                    {
+                        type: 'select',
+                        name: 'aiProvider',
+                        message: 'Select AI Provider:',
+                        choices: ['openai'], // Add 'gemini', 'anthropic' when ready
+                        initial: current.aiProvider || 'openai',
+                        skip: (state) => !state.answers.aiEnabled
+                    },
+                    {
+                        type: 'password',
+                        name: 'aiKey',
+                        message: 'AI API Key:',
+                        initial: current.aiKey ? '*****' : undefined,
+                        skip: (state) => !state.answers.aiEnabled
                     }
                 ]);
 
@@ -87,5 +108,47 @@ export function registerConfigCommand(program) {
             console.log(chalk.green('Credentials cleared.'));
         });
 
+    const aiConfigCmd = new Command('ai')
+        .description('Manage AI settings');
+
+    aiConfigCmd
+        .command('enable')
+        .description('Enable AI features')
+        .action(async () => {
+            const current = getCredentials();
+            let key = current.aiKey;
+
+            if (!key) {
+                const response = await enquirer.prompt({
+                    type: 'password',
+                    name: 'aiKey',
+                    message: 'Enter AI API Key:'
+                });
+                key = response.aiKey;
+            }
+
+            setCredentials({ aiEnabled: true, aiKey: key });
+            console.log(chalk.green('AI features enabled!'));
+        });
+
+    aiConfigCmd
+        .command('disable')
+        .description('Disable AI features')
+        .action(() => {
+            setCredentials({ aiEnabled: false });
+            console.log(chalk.yellow('AI features disabled.'));
+        });
+
+    aiConfigCmd
+        .command('status')
+        .description('Check AI feature status')
+        .action(() => {
+            const { aiEnabled, aiProvider } = getCredentials();
+            console.log(`AI Enabled: ${aiEnabled ? chalk.green('Yes') : chalk.red('No')}`);
+            console.log(`Provider: ${aiProvider || 'None'}`);
+        });
+
+    configCmd.addCommand(aiConfigCmd);
+
     program.addCommand(configCmd);
 }

package/src/commands/issue.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 { parseADF } from '../utils/adf-parser.js';
 
 export function registerIssueCommand(program) {
     const issueCmd = new Command('issue')
@@ -38,9 +39,9 @@ export function registerIssueCommand(program) {
 
                 const searchApi = '/search/jql';
                 const body = {
-                    jql: jql || '',
+                    jql: jql || 'created is not empty',
                     maxResults: parseInt(options.limit),
-                    fields: ['summary', 'status', 'assignee', 'created', 'updated']
+                    fields: ['summary', 'status', 'assignee', 'created', 'updated', 'description']
                 };
 
                 const data = await api.post(searchApi, body);
@@ -84,7 +85,7 @@ export function registerIssueCommand(program) {
                 }
 
                 const tableData = [
-                    [chalk.bold('Key'), chalk.bold('Summary'), chalk.bold('Status'), chalk.bold('Assignee')]
+                    [chalk.bold('Key'), chalk.bold('Summary'), chalk.bold('Status'), chalk.bold('Assignee'), chalk.bold('Created'), chalk.bold('Updated')]
                 ];
 
                 data.issues.forEach(i => {
@@ -92,7 +93,9 @@ export function registerIssueCommand(program) {
                         chalk.cyan(i.key),
                         i.fields.summary ? (i.fields.summary.length > 50 ? i.fields.summary.substring(0, 47) + '...' : i.fields.summary) : '',
                         i.fields.status ? i.fields.status.name : '',
-                        i.fields.assignee ? i.fields.assignee.displayName : 'Unassigned'
+                        i.fields.assignee ? i.fields.assignee.displayName : 'Unassigned',
+                        i.fields.created ? i.fields.created.split('T')[0] : '',
+                        i.fields.updated ? i.fields.updated.split('T')[0] : ''
                     ]);
                 });
 
@@ -108,5 +111,45 @@ export function registerIssueCommand(program) {
             }
         });
 
+    issueCmd
+        .command('view')
+        .description('View issue details')
+        .argument('<issueKey>', 'Issue Key')
+        .action(async (issueKey) => {
+            const spinner = ora(`Fetching issue ${issueKey}...`).start();
+            try {
+                const issue = await api.get(`/issue/${issueKey}`);
+                spinner.stop();
+
+                console.log(chalk.bold(`\n${issue.key}: ${issue.fields.summary}`));
+                console.log(chalk.grey(`${issue.fields.issuetype.name} - ${issue.fields.status.name} - ${issue.fields.priority ? issue.fields.priority.name : 'No Priority'}`));
+                console.log(chalk.bold('\nDescription:'));
+                console.log(parseADF(issue.fields.description) || 'No description provided.');
+
+                if (issue.fields.assignee) {
+                    console.log(chalk.bold('\nAssignee: ') + issue.fields.assignee.displayName);
+                }
+
+                if (issue.fields.comment && issue.fields.comment.comments.length > 0) {
+                    console.log(chalk.bold('\nComments:'));
+                    issue.fields.comment.comments.forEach(c => {
+                        console.log(chalk.cyan(c.author.displayName) + ': ' + c.body);
+                    });
+                }
+                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));
+                }
+            }
+        });
+
     program.addCommand(issueCmd);
 }

package/src/commands/sprint.js

@@ -37,7 +37,41 @@ export function registerSprintCommand(program) {
                 // Using full path:
                 const match = jiraUrl.match(/^https?:\/\/(.+?)(\/|$)/);
                 const domain = match ? match[0].replace(/\/$/, '') : jiraUrl;
-                const fullUrl = `${domain}/rest/agile/1.0/board/${options.board}/sprint?state=${options.state}`;
+
+                let boardId = options.board;
+
+                // If board option is not a number, try to look it up using the Board Name/Key
+                if (isNaN(boardId)) {
+                    spinner.text = `Looking up board "${options.board}"...`;
+                    const boardSearchUrl = `${domain}/rest/agile/1.0/board?name=${encodeURIComponent(options.board)}`;
+                    const boardData = await api.get(boardSearchUrl);
+
+                    if (!boardData.values || boardData.values.length === 0) {
+                        // Fallback: It might be a project key. Let's try searching for boards associated with this project.
+                        // But the API doesn't support projectKey filter directly on /board easily without iterating.
+                        // For now, fail if name match doesn't work.
+                        throw new Error(`Board with name "${options.board}" not found. Please provide the numeric Board ID.`);
+                    }
+
+                    // Strict match or pick first? Let's pick the first one but warn if multiple
+                    if (boardData.values.length > 1) {
+                        // Try to find exact match
+                        const exact = boardData.values.find(b => b.name.toLowerCase() === options.board.toLowerCase());
+                        if (exact) {
+                            boardId = exact.id;
+                        } else {
+                            // Just pick first? Or error?
+                            // Let's pick first but log
+                            console.log(chalk.yellow(`\nMultiple boards found for "${options.board}". Using "${boardData.values[0].name}" (ID: ${boardData.values[0].id}).`));
+                            boardId = boardData.values[0].id;
+                        }
+                    } else {
+                        boardId = boardData.values[0].id;
+                    }
+                    spinner.text = `Fetching sprints for board ${options.board} (ID: ${boardId})...`;
+                }
+
+                const fullUrl = `${domain}/rest/agile/1.0/board/${boardId}/sprint?state=${options.state}`;
 
                 const data = await api.get(fullUrl);
                 spinner.stop();
@@ -65,7 +99,12 @@ export function registerSprintCommand(program) {
             } catch (e) {
                 spinner.fail('Failed to list sprints');
                 if (e.response) {
-                    console.error(chalk.red(`Error ${e.response.status}: `), e.response.data);
+                    if (e.response.status === 404) {
+                        console.error(chalk.red(`\nError: Board with ID "${options.board}" not found or you do not have permission to view it.`));
+                        console.error(chalk.grey('Tip: Verify the Board ID in your Jira URL: /jira/software/c/projects/KEY/boards/ID'));
+                    } else {
+                        console.error(chalk.red(`Error ${e.response.status}: `), e.response.data);
+                    }
                 } else {
                     console.error(chalk.red(e.message));
                 }

package/src/services/ai-service.js

@@ -5,10 +5,14 @@ export class AiService {
     constructor() { }
 
     async generate(prompt) {
-        const { aiKey, aiProvider } = getCredentials();
+        const { aiKey, aiProvider, aiEnabled } = getCredentials();
+
+        if (!aiEnabled) {
+            throw new Error('AI features are disabled. Run "jira config ai enable" to enable.');
+        }
 
         if (!aiKey) {
-            throw new Error('AI API Key not configured. Run "jira config setup" or manually set it in config.');
+            throw new Error('AI API Key not configured. Run "jira config ai enable" or "jira config setup".');
         }
 
         // Basic implementation for OpenAI - extensible for others

package/src/utils/adf-parser.js

@@ -0,0 +1,49 @@
+export function parseADF(content) {
+    if (!content) return '';
+    if (typeof content === 'string') return content;
+
+    if (content.type === 'doc') {
+        return content.content.map(node => parseNode(node)).join('\n');
+    }
+
+    return JSON.stringify(content);
+}
+
+function parseNode(node) {
+    if (!node) return '';
+
+    switch (node.type) {
+        case 'paragraph':
+            return parseParagraph(node);
+        case 'text':
+            return node.text;
+        case 'bulletList':
+            return parseList(node, '•');
+        case 'orderedList':
+            return parseList(node, '1.');
+        case 'heading':
+            return `\n${'#'.repeat(node.attrs?.level || 1)} ${node.content.map(c => parseNode(c)).join('')}\n`;
+        case 'codeBlock':
+            return `\n\`\`\`${node.attrs?.language || ''}\n${node.content.map(c => c.text).join('')}\n\`\`\`\n`;
+        case 'blockquote':
+            return `> ${node.content.map(c => parseNode(c)).join('')}`;
+        default:
+            if (node.content) {
+                return node.content.map(c => parseNode(c)).join('');
+            }
+            return ''; // Unknown node, skip or fallback
+    }
+}
+
+function parseParagraph(node) {
+    if (!node.content) return '\n';
+    return node.content.map(c => parseNode(c)).join('') + '\n';
+}
+
+function parseList(node, marker) {
+    if (!node.content) return '';
+    return node.content.map((item, index) => {
+        const prefix = marker === '1.' ? `${index + 1}. ` : `${marker} `;
+        return `${prefix}${item.content.map(c => parseNode(c)).join('')}`;
+    }).join('\n') + '\n';
+}

package/src/utils/config.js

@@ -18,6 +18,10 @@ const schema = {
     aiProvider: {
         type: 'string',
         default: 'openai'
+    },
+    aiEnabled: {
+        type: 'boolean',
+        default: false
     }
 };
 
@@ -32,16 +36,18 @@ export const getCredentials = () => {
         email: config.get('email'),
         apiToken: config.get('apiToken'),
         aiKey: config.get('aiKey'),
-        aiProvider: config.get('aiProvider')
+        aiProvider: config.get('aiProvider'),
+        aiEnabled: config.get('aiEnabled')
     };
 };
 
-export const setCredentials = ({ jiraUrl, email, apiToken, aiKey, aiProvider }) => {
+export const setCredentials = ({ jiraUrl, email, apiToken, aiKey, aiProvider, aiEnabled }) => {
     if (jiraUrl) config.set('jiraUrl', jiraUrl);
     if (email) config.set('email', email);
     if (apiToken) config.set('apiToken', apiToken);
     if (aiKey) config.set('aiKey', aiKey);
     if (aiProvider) config.set('aiProvider', aiProvider);
+    if (typeof aiEnabled !== 'undefined') config.set('aiEnabled', aiEnabled);
 };
 
 export const clearCredentials = () => {