jira-ai 0.3.19 → 0.3.21

package/dist/cli.js

@@ -8,12 +8,14 @@ import { projectsCommand } from './commands/projects.js';
 import { taskWithDetailsCommand } from './commands/task-with-details.js';
 import { projectStatusesCommand } from './commands/project-statuses.js';
 import { listIssueTypesCommand } from './commands/list-issue-types.js';
+import { listColleaguesCommand } from './commands/list-colleagues.js';
 import { runJqlCommand } from './commands/run-jql.js';
 import { updateDescriptionCommand } from './commands/update-description.js';
 import { addCommentCommand } from './commands/add-comment.js';
 import { addLabelCommand } from './commands/add-label.js';
 import { deleteLabelCommand } from './commands/delete-label.js';
 import { createTaskCommand } from './commands/create-task.js';
+import { transitionCommand } from './commands/transition.js';
 import { getIssueStatisticsCommand } from './commands/get-issue-statistics.js';
 import { aboutCommand } from './commands/about.js';
 import { authCommand } from './commands/auth.js';
@@ -32,7 +34,7 @@ const program = new Command();
 program
     .name('jira-ai')
     .description('CLI tool for interacting with Atlassian Jira')
-    .version('0.3.19')
+    .version('0.3.21')
     .option('-o, --organization <alias>', 'Override the active Jira organization');
 // Hook to handle the global option before any command runs
 program.on('option:organization', (alias) => {
@@ -109,6 +111,17 @@ program
     .command('projects')
     .description('Show list of projects')
     .action(withPermission('projects', projectsCommand));
+// List colleagues command
+program
+    .command('list-colleagues [project-key]')
+    .description('Show all colleagues in the project or organization')
+    .action(withPermission('list-colleagues', listColleaguesCommand, {
+    validateArgs: (args) => {
+        if (args[0]) {
+            validateOptions(ProjectKeySchema, args[0]);
+        }
+    }
+}));
 // Task with details command
 program
     .command('task-with-details <task-id>')
@@ -195,6 +208,13 @@ program
     .requiredOption('--issue-type <type>', 'Issue type (e.g., Task, Epic, Subtask)')
     .option('--parent <key>', 'Parent issue key (required for subtasks)')
     .action(withPermission('create-task', createTaskCommand, { schema: CreateTaskSchema }));
+// Transition command
+program
+    .command('transition <task-id> <to-status>')
+    .description('Transition a Jira task to a new status')
+    .action(withPermission('transition', transitionCommand, {
+    validateArgs: (args) => validateOptions(IssueKeySchema, args[0])
+}));
 // Get issue statistics command
 program
     .command('get-issue-statistics <task-ids>')

package/dist/commands/list-colleagues.js

@@ -0,0 +1,24 @@
+import chalk from 'chalk';
+import { getUsers } from '../lib/jira-client.js';
+import { formatUsers } from '../lib/formatters.js';
+import { ui } from '../lib/ui.js';
+export async function listColleaguesCommand(projectKey) {
+    const message = projectKey
+        ? `Fetching colleagues for project ${projectKey}...`
+        : 'Fetching all active colleagues...';
+    ui.startSpinner(message);
+    try {
+        const users = await getUsers(projectKey);
+        ui.succeedSpinner(chalk.green('Colleagues retrieved'));
+        if (users.length === 0) {
+            console.log(chalk.yellow('\nNo active colleagues found.'));
+        }
+        else {
+            console.log(formatUsers(users));
+        }
+    }
+    catch (error) {
+        ui.failSpinner(chalk.red('Failed to fetch colleagues'));
+        throw error;
+    }
+}

package/dist/commands/transition.js

@@ -0,0 +1,51 @@
+import chalk from 'chalk';
+import { getIssueTransitions, transitionIssue } from '../lib/jira-client.js';
+import { CommandError } from '../lib/errors.js';
+import { ui } from '../lib/ui.js';
+export async function transitionCommand(taskId, toStatus) {
+    ui.startSpinner(`Fetching available transitions for ${taskId}...`);
+    try {
+        const transitions = await getIssueTransitions(taskId);
+        ui.stopSpinner();
+        const matchingTransitions = transitions.filter((t) => t.to.name.toLowerCase() === toStatus.toLowerCase());
+        if (matchingTransitions.length === 0) {
+            const availableStatuses = Array.from(new Set(transitions.map((t) => t.to.name))).join(', ');
+            throw new CommandError(`No transition found to status "${toStatus}" for issue ${taskId}.`, {
+                hints: [
+                    `Available destination statuses: ${availableStatuses || 'None'}`,
+                    'Check the status name and try again (it is case-insensitive).'
+                ]
+            });
+        }
+        if (matchingTransitions.length > 1) {
+            const availableTransitions = matchingTransitions.map(t => `"${t.name}" (ID: ${t.id})`).join(', ');
+            throw new CommandError(`Multiple transitions found to status "${toStatus}" for issue ${taskId}.`, {
+                hints: [
+                    `Ambiguous matches: ${availableTransitions}`,
+                    'This command currently only supports unambiguous status matching.'
+                ]
+            });
+        }
+        const transition = matchingTransitions[0];
+        ui.startSpinner(`Transitioning ${taskId} to ${transition.to.name}...`);
+        await transitionIssue(taskId, transition.id);
+        ui.succeedSpinner(chalk.green(`Issue ${taskId} successfully transitioned to ${transition.to.name}.`));
+    }
+    catch (error) {
+        if (error instanceof CommandError) {
+            throw error;
+        }
+        const hints = [];
+        if (error.message?.includes('403')) {
+            hints.push('You may not have permission to transition this issue');
+        }
+        else if (error.message?.includes('required') || (error.response?.data?.errors && Object.keys(error.response.data.errors).length > 0)) {
+            hints.push('This transition might require mandatory fields that are not yet supported by this command.');
+            if (error.response?.data?.errors) {
+                const fields = Object.keys(error.response.data.errors).join(', ');
+                hints.push(`Missing fields: ${fields}`);
+            }
+        }
+        throw new CommandError(`Failed to transition issue: ${error.message}`, { hints });
+    }
+}

package/dist/lib/formatters.js

@@ -313,3 +313,22 @@ export function formatIssueStatistics(statsList) {
     output += table.toString() + '\n';
     return output;
 }
+/**
+ * Format users list
+ */
+export function formatUsers(users) {
+    if (users.length === 0) {
+        return chalk.yellow('No users found.');
+    }
+    const table = createTable(['Display Name', 'Email', 'Account ID'], [30, 40, 30]);
+    users.forEach((user) => {
+        table.push([
+            chalk.cyan(user.displayName),
+            user.emailAddress || chalk.gray('N/A'),
+            chalk.gray(user.accountId),
+        ]);
+    });
+    let output = '\n' + chalk.bold(`Colleagues (${users.length} total)`) + '\n\n';
+    output += table.toString() + '\n';
+    return output;
+}

package/dist/lib/jira-client.js

@@ -394,3 +394,63 @@ export async function getIssueStatistics(issueIdOrKey) {
         currentStatus: statusName,
     };
 }
+/**
+ * Get available transitions for an issue
+ */
+export async function getIssueTransitions(issueIdOrKey) {
+    const client = getJiraClient();
+    const response = await client.issues.getTransitions({
+        issueIdOrKey,
+    });
+    return (response.transitions || []).map((t) => ({
+        id: t.id || '',
+        name: t.name || '',
+        to: {
+            id: t.to?.id || '',
+            name: t.to?.name || '',
+        },
+    }));
+}
+/**
+ * Perform a transition on an issue
+ */
+export async function transitionIssue(issueIdOrKey, transitionId) {
+    const client = getJiraClient();
+    await client.issues.doTransition({
+        issueIdOrKey,
+        transition: {
+            id: transitionId,
+        },
+    });
+}
+/**
+ * Get users, optionally filtered by project
+ */
+export async function getUsers(projectKey) {
+    const client = getJiraClient();
+    let users;
+    if (projectKey) {
+        users = await client.userSearch.findAssignableUsers({
+            project: projectKey,
+            maxResults: 1000,
+        });
+    }
+    else {
+        users = await client.userSearch.findUsers({
+            query: '',
+            maxResults: 1000,
+        });
+    }
+    // Filter for active users
+    return users
+        .filter((user) => user.active && user.accountType === 'atlassian')
+        .map((user) => ({
+        accountId: user.accountId || '',
+        displayName: user.displayName || '',
+        emailAddress: user.emailAddress || '',
+        active: user.active || false,
+        timeZone: user.timeZone || '',
+        // @ts-ignore
+        host: client.config.host || 'N/A',
+    }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jira-ai",
-  "version": "0.3.19",
+  "version": "0.3.21",
   "description": "AI friendly Jira CLI to save context",
   "type": "module",
   "main": "dist/cli.js",

package/settings.yaml

@@ -11,7 +11,7 @@ projects:
   # - all
 
 # Commands: List of allowed commands (use "all" to allow all commands)
-# Available commands: me, projects, task-with-details, project-statuses, list-issue-types, run-jql, update-description, add-comment, create-task, get-issue-statistics, about
+# Available commands: me, projects, task-with-details, project-statuses, list-issue-types, run-jql, update-description, add-comment, create-task, get-issue-statistics, about, transition, add-label-to-issue, delete-label-from-issue
 commands:
   - me
   - get-issue-statistics