jira-ai 0.4.1 → 0.4.2

package/dist/cli.js

@@ -17,6 +17,7 @@ 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 { getPersonWorklogCommand } from './commands/get-person-worklog.js';
 import { aboutCommand } from './commands/about.js';
 import { authCommand } from './commands/auth.js';
 import { listOrganizations, useOrganizationCommand, removeOrganizationCommand } from './commands/organization.js';
@@ -26,7 +27,7 @@ import { hasCredentials } from './lib/auth-storage.js';
 import { CliError } from './types/errors.js';
 import { CommandError } from './lib/errors.js';
 import { ui } from './lib/ui.js';
-import { validateOptions, CreateTaskSchema, AddCommentSchema, UpdateDescriptionSchema, RunJqlSchema, IssueKeySchema, ProjectKeySchema } from './lib/validation.js';
+import { validateOptions, CreateTaskSchema, AddCommentSchema, UpdateDescriptionSchema, RunJqlSchema, GetPersonWorklogSchema, TimeframeSchema, IssueKeySchema, ProjectKeySchema } from './lib/validation.js';
 import { realpathSync } from 'fs';
 // Load environment variables
 // @ts-ignore - quiet option exists but is not in types
@@ -36,7 +37,7 @@ const program = new Command();
 program
     .name('jira-ai')
     .description('CLI tool for interacting with Atlassian Jira')
-    .version('0.3.22')
+    .version('0.4.2')
     .option('-o, --organization <alias>', 'Override the active Jira organization');
 // Hook to handle the global option before any command runs
 program.on('option:organization', (alias) => {
@@ -222,6 +223,17 @@ program
     .command('get-issue-statistics <task-ids>')
     .description('Show time metrics and lifecycle of issues (comma-separated keys)')
     .action(withPermission('get-issue-statistics', getIssueStatisticsCommand));
+// Get person worklog command
+program
+    .command('get-person-worklog <person> <timeframe>')
+    .description('Retrieve and display worklogs for a specific person within a given timeframe')
+    .option('--group-by-issue', 'Group the output by issue')
+    .action(withPermission('get-person-worklog', getPersonWorklogCommand, {
+    schema: GetPersonWorklogSchema,
+    validateArgs: (args) => {
+        validateOptions(TimeframeSchema, args[1]);
+    }
+}));
 // About command (always allowed)
 program
     .command('about')

package/dist/commands/get-person-worklog.js

@@ -0,0 +1,61 @@
+import chalk from 'chalk';
+import { ui } from '../lib/ui.js';
+import { getIssueWorklogs, getJiraClient } from '../lib/jira-client.js';
+import { parseTimeframe, formatDateForJql } from '../lib/utils.js';
+import { formatWorklogs } from '../lib/formatters.js';
+import { CommandError } from '../lib/errors.js';
+export async function getPersonWorklogCommand(person, timeframe, options) {
+    ui.startSpinner(`Fetching worklogs for ${person}...`);
+    try {
+        const { startDate, endDate } = parseTimeframe(timeframe);
+        const startJql = formatDateForJql(startDate);
+        const endJql = formatDateForJql(endDate);
+        // 1. Search for issues where the person has tracked time in the timeframe
+        // We use a broader search first to find relevant issues
+        const jql = `worklogAuthor = "${person}" AND worklogDate >= "${startJql}" AND worklogDate <= "${endJql}"`;
+        // We need to fetch issues with their summaries
+        const client = getJiraClient();
+        const issueResponse = await client.issueSearch.searchForIssuesUsingJqlEnhancedSearch({
+            jql,
+            fields: ['summary'],
+            maxResults: 100,
+        });
+        const issues = issueResponse.issues || [];
+        if (issues.length === 0) {
+            ui.stopSpinner();
+            console.log(chalk.yellow(`
+No worklogs found for ${person} between ${startJql} and ${endJql}.
+`));
+            return;
+        }
+        const allWorklogs = [];
+        // 2. For each issue, fetch all worklogs and filter in-memory
+        for (const issue of issues) {
+            const worklogs = await getIssueWorklogs(issue.key);
+            const filteredWorklogs = worklogs.filter(w => {
+                const matchesPerson = w.author.accountId === person || w.author.emailAddress === person;
+                const worklogDate = new Date(w.started);
+                const matchesDate = worklogDate >= startDate && worklogDate <= endDate;
+                return matchesPerson && matchesDate;
+            });
+            filteredWorklogs.forEach(w => {
+                allWorklogs.push({
+                    ...w,
+                    summary: issue.fields?.summary || '',
+                });
+            });
+        }
+        ui.stopSpinner();
+        if (allWorklogs.length === 0) {
+            console.log(chalk.yellow(`
+No worklogs found for ${person} after detailed filtering.
+`));
+            return;
+        }
+        console.log(formatWorklogs(allWorklogs, options.groupByIssue));
+    }
+    catch (error) {
+        ui.failSpinner(`Failed to fetch worklogs: ${error.message}`);
+        throw new CommandError(error.message);
+    }
+}

package/dist/lib/formatters.js

@@ -330,3 +330,33 @@ export function formatUsers(users) {
     output += table.toString() + '\n';
     return output;
 }
+/**
+ * Format worklogs list
+ */
+export function formatWorklogs(worklogs, groupByIssue = false) {
+    if (worklogs.length === 0) {
+        return chalk.yellow('\nNo worklogs found for the given person and timeframe.\n');
+    }
+    // Sort worklogs by date (started)
+    let sortedWorklogs = [...worklogs].sort((a, b) => new Date(a.started).getTime() - new Date(b.started).getTime());
+    if (groupByIssue) {
+        sortedWorklogs.sort((a, b) => a.issueKey.localeCompare(b.issueKey));
+    }
+    const table = createTable(['Date', 'Issue Key', 'Summary', 'Time Spent', 'Worklog Comment'], [12, 12, 30, 12, 45]);
+    let totalSeconds = 0;
+    sortedWorklogs.forEach((w) => {
+        totalSeconds += w.timeSpentSeconds;
+        table.push([
+            w.started.split('T')[0],
+            chalk.cyan(w.issueKey),
+            truncate(w.summary, 30),
+            w.timeSpent,
+            truncate(w.comment || '', 45),
+        ]);
+    });
+    const totalHours = (totalSeconds / 3600).toFixed(2);
+    let output = '\n' + chalk.bold('Worklogs') + '\n\n';
+    output += table.toString() + '\n';
+    output += chalk.bold(`Total time tracked: ${totalHours}h`) + '\n';
+    return output;
+}

package/dist/lib/jira-client.js

@@ -454,3 +454,27 @@ export async function getUsers(projectKey) {
         host: client.config.host || 'N/A',
     }));
 }
+/**
+ * Get all worklogs for an issue
+ */
+export async function getIssueWorklogs(issueIdOrKey) {
+    const client = getJiraClient();
+    const response = await client.issueWorklogs.getIssueWorklog({
+        issueIdOrKey,
+    });
+    return (response.worklogs || []).map((w) => ({
+        id: w.id || '',
+        author: {
+            accountId: w.author?.accountId || '',
+            displayName: w.author?.displayName || 'Unknown',
+            emailAddress: w.author?.emailAddress,
+        },
+        comment: convertADFToMarkdown(w.comment),
+        created: w.created || '',
+        updated: w.updated || '',
+        started: w.started || '',
+        timeSpent: w.timeSpent || '',
+        timeSpentSeconds: w.timeSpentSeconds || 0,
+        issueKey: issueIdOrKey,
+    }));
+}

package/dist/lib/utils.js

@@ -128,3 +128,26 @@ export function formatDuration(seconds, hoursPerDay = 24) {
         parts.push(`${m}m`);
     return parts.length > 0 ? parts.join(' ') : '0m';
 }
+/**
+ * Parse relative timeframe (e.g., '7d', '30d') into start and end dates
+ */
+export function parseTimeframe(timeframe) {
+    const match = timeframe.match(/^(\d+)d$/);
+    if (!match) {
+        throw new CommandError('Invalid timeframe format. Use e.g., "7d" or "30d".');
+    }
+    const days = parseInt(match[1], 10);
+    const endDate = new Date();
+    const startDate = new Date();
+    startDate.setDate(endDate.getDate() - days);
+    // Set to start of day for startDate and end of day for endDate to be inclusive
+    startDate.setHours(0, 0, 0, 0);
+    endDate.setHours(23, 59, 59, 999);
+    return { startDate, endDate };
+}
+/**
+ * Format Date object to JQL compatible string (YYYY-MM-DD)
+ */
+export function formatDateForJql(date) {
+    return date.toISOString().split('T')[0];
+}

package/dist/lib/validation.js

@@ -68,3 +68,7 @@ export const UpdateDescriptionSchema = z.object({
 export const RunJqlSchema = z.object({
     limit: NumericStringSchema.optional(),
 });
+export const TimeframeSchema = z.string().regex(/^\d+d$/, 'Timeframe must be in format like "7d" or "30d"');
+export const GetPersonWorklogSchema = z.object({
+    groupByIssue: z.boolean().optional(),
+});

package/package.json

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

package/settings.yaml

@@ -11,10 +11,11 @@ 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, transition, add-label-to-issue, delete-label-from-issue
+# 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, list-colleagues, get-person-worklog
 commands:
   - me
   - get-issue-statistics
+  - get-person-worklog
   # Uncomment below to allow all commands
   # - all
   # - task-with-details