jira-ai 1.3.0 → 1.4.0

package/dist/cli.js

@@ -48,6 +48,7 @@ program
     .description('CLI tool for interacting with Atlassian Jira')
     .version(getVersion())
     .option('--compact', 'Output as compact JSON')
+    .option('--dry-run', 'Preview changes without executing them')
     .addHelpText('after', () => {
     const latestVersion = checkForUpdateSync();
     if (latestVersion) {

package/dist/commands/create-task.js

@@ -6,6 +6,7 @@ import { CommandError } from '../lib/errors.js';
 import { validateOptions, CreateTaskSchema } from '../lib/validation.js';
 import { isCommandAllowed, isProjectAllowed } from '../lib/settings.js';
 import { outputResult } from '../lib/json-mode.js';
+import { isDryRun, formatDryRunResult } from '../lib/dry-run.js';
 export async function createTaskCommand(options) {
     validateOptions(CreateTaskSchema, options);
     const { title, project, issueType, parent, priority, description, descriptionFile, labels, component, fixVersion, dueDate, assignee, customField } = options;
@@ -74,6 +75,17 @@ export async function createTaskCommand(options) {
             issueFields[fieldId] = isNaN(numValue) ? rawValue : numValue;
         }
     }
+    if (isDryRun()) {
+        const changes = {
+            project,
+            summary: title,
+            issueType,
+            ...(parent !== undefined ? { parent } : {}),
+            ...issueFields,
+        };
+        formatDryRunResult('issue.create', project, changes);
+        return;
+    }
     try {
         const result = await createIssue({
             project,

package/dist/commands/transition.js

@@ -5,13 +5,14 @@ import { outputResult } from '../lib/json-mode.js';
 import { markdownToAdf } from 'marklassian';
 import { FieldResolver } from '../lib/field-resolver.js';
 import { processMentionsInADF } from '../lib/adf-mentions.js';
+import { isDryRun, formatDryRunResult } from '../lib/dry-run.js';
 export async function transitionCommand(taskId, toStatus, options) {
     // Validate mutual exclusivity of --comment and --comment-file
     if (options?.comment && options?.commentFile) {
         throw new CommandError('Cannot use both --comment and --comment-file flags simultaneously.');
     }
     // Check permissions and filters
-    await validateIssuePermissions(taskId, 'transition');
+    const currentIssue = await validateIssuePermissions(taskId, 'transition');
     try {
         const transitions = await getIssueTransitions(taskId);
         const matchingTransitions = transitions.filter((t) => t.to.name.toLowerCase() === toStatus.toLowerCase());
@@ -34,6 +35,35 @@ export async function transitionCommand(taskId, toStatus, options) {
             });
         }
         const transition = matchingTransitions[0];
+        if (isDryRun()) {
+            const changes = {
+                status: {
+                    from: currentIssue?.status?.name,
+                    to: transition.to.name,
+                },
+            };
+            if (options?.resolution !== undefined) {
+                changes.resolution = { to: options.resolution };
+            }
+            if (options?.assignee !== undefined) {
+                changes.assignee = { to: options.assignee };
+            }
+            if (options?.fixVersion !== undefined) {
+                changes.fixVersions = { to: options.fixVersion };
+            }
+            if (options?.customFields && options.customFields.length > 0) {
+                for (const entry of options.customFields) {
+                    const eqIdx = entry.indexOf('=');
+                    if (eqIdx === -1)
+                        continue;
+                    const fieldId = entry.slice(0, eqIdx).trim();
+                    const value = entry.slice(eqIdx + 1).trim();
+                    changes[fieldId] = { to: value };
+                }
+            }
+            formatDryRunResult('issue.transition', taskId, changes);
+            return;
+        }
         // Build optional payload if any options were provided
         let payload;
         if (options && Object.keys(options).some(k => options[k] !== undefined)) {

package/dist/commands/update-issue.js

@@ -6,6 +6,7 @@ import { CommandError } from '../lib/errors.js';
 import { validateOptions, UpdateIssueSchema, IssueKeySchema } from '../lib/validation.js';
 import { isCommandAllowed, isProjectAllowed } from '../lib/settings.js';
 import { outputResult } from '../lib/json-mode.js';
+import { isDryRun, formatDryRunResult } from '../lib/dry-run.js';
 export async function updateIssueCommand(issueKey, options) {
     validateOptions(IssueKeySchema, issueKey);
     validateOptions(UpdateIssueSchema, options);
@@ -16,7 +17,47 @@ export async function updateIssueCommand(issueKey, options) {
     if (!isCommandAllowed('update-issue', projectKey)) {
         throw new CommandError(`Command 'update-issue' is not allowed for project ${projectKey}.`);
     }
-    await validateIssuePermissions(issueKey, 'update-issue');
+    const currentIssue = await validateIssuePermissions(issueKey, 'update-issue');
+    if (isDryRun()) {
+        const changes = {};
+        if (options.priority !== undefined) {
+            changes.priority = { from: currentIssue?.priority, to: options.priority };
+        }
+        if (options.summary !== undefined) {
+            changes.summary = { from: currentIssue?.summary, to: options.summary };
+        }
+        if (options.labels !== undefined || options.clearLabels) {
+            const newLabels = options.clearLabels ? [] : options.labels?.split(',').map(l => l.trim()).filter(Boolean);
+            changes.labels = { from: currentIssue?.labels, to: newLabels };
+        }
+        if (options.component !== undefined) {
+            changes.components = { from: currentIssue?.components, to: options.component };
+        }
+        if (options.fixVersion !== undefined) {
+            changes.fixVersions = { from: currentIssue?.fixVersions, to: options.fixVersion };
+        }
+        if (options.dueDate !== undefined) {
+            changes.dueDate = { from: currentIssue?.duedate, to: options.dueDate };
+        }
+        if (options.assignee !== undefined) {
+            changes.assignee = { from: currentIssue?.assignee?.displayName, to: options.assignee };
+        }
+        if (options.description !== undefined || options.fromFile !== undefined) {
+            changes.description = { from: '(current)', to: '(updated)' };
+        }
+        if (options.customField && options.customField.length > 0) {
+            for (const cf of options.customField) {
+                const eqIdx = cf.indexOf('=');
+                if (eqIdx === -1)
+                    continue;
+                const fieldId = cf.slice(0, eqIdx);
+                const value = cf.slice(eqIdx + 1);
+                changes[fieldId] = { to: value };
+            }
+        }
+        formatDryRunResult('issue.update', issueKey, changes);
+        return;
+    }
     const fields = {};
     if (options.priority !== undefined) {
         if (!options.priority)

package/dist/lib/dry-run.js

@@ -0,0 +1,15 @@
+import { outputResult } from './json-mode.js';
+export function isDryRun() {
+    return process.argv.includes('--dry-run');
+}
+export function formatDryRunResult(command, target, changes, preview = {}) {
+    const result = {
+        dryRun: true,
+        command,
+        target,
+        changes,
+        preview,
+        message: 'No changes were made. Remove --dry-run to execute.',
+    };
+    outputResult(result);
+}

package/package.json

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