jira-ai 0.3.12 → 0.3.13

package/dist/cli.js

@@ -14,6 +14,7 @@ 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 { getIssueStatisticsCommand } from './commands/get-issue-statistics.js';
 import { aboutCommand } from './commands/about.js';
 import { authCommand } from './commands/auth.js';
 import { isCommandAllowed, getAllowedCommands } from './lib/settings.js';
@@ -161,6 +162,11 @@ 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 }));
+// Get issue statistics command
+program
+    .command('get-issue-statistics <task-ids>')
+    .description('Show time metrics and lifecycle of issues (comma-separated keys)')
+    .action(withPermission('get-issue-statistics', getIssueStatisticsCommand));
 // About command (always allowed)
 program
     .command('about')

package/dist/commands/get-issue-statistics.js

@@ -0,0 +1,29 @@
+import chalk from 'chalk';
+import { getIssueStatistics } from '../lib/jira-client.js';
+import { formatIssueStatistics } from '../lib/formatters.js';
+import { ui } from '../lib/ui.js';
+export async function getIssueStatisticsCommand(taskIds) {
+    const ids = taskIds.split(',').map(id => id.trim()).filter(id => id !== '');
+    if (ids.length === 0) {
+        console.error(chalk.red('Please provide at least one issue ID.'));
+        return;
+    }
+    ui.startSpinner(`Fetching statistics for ${ids.length} issue(s)...`);
+    const results = [];
+    for (const id of ids) {
+        try {
+            const stats = await getIssueStatistics(id);
+            results.push(stats);
+        }
+        catch (error) {
+            console.error(chalk.red(`\nFailed to fetch statistics for ${id}: ${error.message}`));
+        }
+    }
+    if (results.length > 0) {
+        ui.succeedSpinner(chalk.green('Statistics retrieved'));
+        console.log(formatIssueStatistics(results));
+    }
+    else {
+        ui.failSpinner('Failed to retrieve statistics');
+    }
+}

package/dist/lib/formatters.js

@@ -1,6 +1,6 @@
 import chalk from 'chalk';
 import Table from 'cli-table3';
-import { formatTimestamp, truncate } from './utils.js';
+import { formatTimestamp, truncate, formatDuration } from './utils.js';
 /**
  * Create a styled table
  */
@@ -231,3 +231,40 @@ export function formatProjectIssueTypes(projectKey, issueTypes) {
     }
     return output;
 }
+/**
+ * Format issue statistics
+ */
+export function formatIssueStatistics(statsList) {
+    if (statsList.length === 0) {
+        return chalk.yellow('No statistics to display.');
+    }
+    const table = createTable([
+        'Key',
+        'Summary',
+        'Time Logged',
+        'Estimate',
+        'Status Breakdown'
+    ], [12, 30, 15, 15, 40]);
+    statsList.forEach((stats) => {
+        // Breakdown of time spent in each unique status
+        const breakdown = Object.entries(stats.statusDurations)
+            .map(([status, seconds]) => `${status}: ${formatDuration(seconds, 24)}`)
+            .join('\n');
+        const timeSpentStr = formatDuration(stats.timeSpentSeconds, 8);
+        const estimateStr = formatDuration(stats.originalEstimateSeconds, 8);
+        // Highlight if time spent exceeds estimate
+        const timeSpentFormatted = stats.timeSpentSeconds > stats.originalEstimateSeconds && stats.originalEstimateSeconds > 0
+            ? chalk.red(timeSpentStr)
+            : chalk.green(timeSpentStr);
+        table.push([
+            chalk.cyan(stats.key),
+            truncate(stats.summary, 30),
+            timeSpentFormatted,
+            estimateStr,
+            breakdown
+        ]);
+    });
+    let output = '\n' + chalk.bold('Issue Statistics') + '\n\n';
+    output += table.toString() + '\n';
+    return output;
+}

package/dist/lib/jira-client.js

@@ -1,5 +1,5 @@
 import { Version3Client } from 'jira.js';
-import { convertADFToMarkdown } from './utils.js';
+import { calculateStatusStatistics, convertADFToMarkdown } from './utils.js';
 import { loadCredentials } from './auth-storage.js';
 let jiraClient = null;
 /**
@@ -324,3 +324,25 @@ export async function removeIssueLabels(taskId, labels) {
         },
     });
 }
+/**
+ * Get issue statistics including status transitions and time tracking
+ */
+export async function getIssueStatistics(issueIdOrKey) {
+    const client = getJiraClient();
+    const issue = await client.issues.getIssue({
+        issueIdOrKey,
+        expand: 'changelog',
+        fields: ['summary', 'status', 'timetracking', 'created'],
+    });
+    const histories = issue.changelog?.histories || [];
+    const statusName = issue.fields.status?.name || 'Unknown';
+    const statusDurations = calculateStatusStatistics(issue.fields.created, histories, statusName);
+    return {
+        key: issue.key || '',
+        summary: issue.fields.summary || '',
+        timeSpentSeconds: issue.fields.timetracking?.timeSpentSeconds || 0,
+        originalEstimateSeconds: issue.fields.timetracking?.originalEstimateSeconds || 0,
+        statusDurations,
+        currentStatus: statusName,
+    };
+}

package/dist/lib/utils.js

@@ -67,3 +67,64 @@ export function convertADFToMarkdown(content) {
         return JSON.stringify(content, null, 2);
     }
 }
+/**
+ * Calculate time spent in each status
+ */
+export function calculateStatusStatistics(created, histories, currentStatus, now = Date.now()) {
+    const stats = {};
+    // Sort histories by date
+    const sortedHistories = [...histories].sort((a, b) => new Date(a.created).getTime() - new Date(b.created).getTime());
+    let lastTransitionTime = new Date(created).getTime();
+    let lastStatus = '';
+    const statusHistories = sortedHistories.filter(h => h.items.some((item) => item.field === 'status'));
+    if (statusHistories.length > 0) {
+        const firstStatusItem = statusHistories[0].items.find((item) => item.field === 'status');
+        lastStatus = firstStatusItem.fromString;
+    }
+    else {
+        lastStatus = currentStatus;
+    }
+    for (const history of statusHistories) {
+        const statusItem = history.items.find((item) => item.field === 'status');
+        if (!statusItem)
+            continue;
+        const transitionTime = new Date(history.created).getTime();
+        const durationSeconds = Math.max(0, Math.floor((transitionTime - lastTransitionTime) / 1000));
+        stats[lastStatus] = (stats[lastStatus] || 0) + durationSeconds;
+        lastStatus = statusItem.toString;
+        lastTransitionTime = transitionTime;
+    }
+    // Add time for the current status
+    const finalDurationSeconds = Math.max(0, Math.floor((now - lastTransitionTime) / 1000));
+    stats[lastStatus] = (stats[lastStatus] || 0) + finalDurationSeconds;
+    return stats;
+}
+/**
+ * Format duration in seconds to Jira human-readable format
+ * @param seconds - Duration in seconds
+ * @param hoursPerDay - Hours in a working day (default 24 for brutto time)
+ */
+export function formatDuration(seconds, hoursPerDay = 24) {
+    if (seconds <= 0)
+        return '0m';
+    const daysPerWeek = hoursPerDay === 24 ? 7 : 5;
+    const secondsInDay = hoursPerDay * 3600;
+    const secondsInWeek = daysPerWeek * secondsInDay;
+    const w = Math.floor(seconds / secondsInWeek);
+    seconds %= secondsInWeek;
+    const d = Math.floor(seconds / secondsInDay);
+    seconds %= secondsInDay;
+    const h = Math.floor(seconds / 3600);
+    seconds %= 3600;
+    const m = Math.floor(seconds / 60);
+    const parts = [];
+    if (w > 0)
+        parts.push(`${w}w`);
+    if (d > 0)
+        parts.push(`${d}d`);
+    if (h > 0)
+        parts.push(`${h}h`);
+    if (m > 0)
+        parts.push(`${m}m`);
+    return parts.length > 0 ? parts.join(' ') : '0m';
+}

package/package.json

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

package/settings.yaml

@@ -11,9 +11,10 @@ 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, 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
 commands:
   - me
+  - get-issue-statistics
   # Uncomment below to allow all commands
   # - all
   # - task-with-details