specweave 0.13.5 → 0.14.0

package/plugins/specweave-jira/lib/jira-spec-sync.js

@@ -1,268 +1,233 @@
-/**
- * Jira Spec Sync
- *
- * CORRECT ARCHITECTURE:
- * - Syncs .specweave/docs/internal/specs/spec-*.md ↔ Jira Epics
- * - NOT increments ↔ Jira Issues (that was wrong!)
- *
- * Mapping:
- * - Spec → Jira Epic
- * - User Story → Jira Story (subtask of epic)
- * - Acceptance Criteria → Checklist in Story description
- *
- * @module jira-spec-sync
- */
-import { SpecMetadataManager } from '../../../src/core/specs/spec-metadata-manager.js';
-import { SpecParser } from '../../../src/core/specs/spec-parser.js';
-import axios from 'axios';
-export class JiraSpecSync {
-    constructor(config, projectRoot = process.cwd()) {
-        this.specManager = new SpecMetadataManager(projectRoot);
-        this.config = config;
-        // Create Jira API client
-        this.client = axios.create({
-            baseURL: `https://${config.domain}/rest/api/3`,
-            auth: {
-                username: config.email,
-                password: config.apiToken
-            },
-            headers: {
-                'Accept': 'application/json',
-                'Content-Type': 'application/json'
-            }
+import { SpecMetadataManager } from "../../../src/core/specs/spec-metadata-manager.js";
+import { SpecParser } from "../../../src/core/specs/spec-parser.js";
+import axios from "axios";
+class JiraSpecSync {
+  constructor(config, projectRoot = process.cwd()) {
+    this.specManager = new SpecMetadataManager(projectRoot);
+    this.config = config;
+    this.client = axios.create({
+      baseURL: `https://${config.domain}/rest/api/3`,
+      auth: {
+        username: config.email,
+        password: config.apiToken
+      },
+      headers: {
+        "Accept": "application/json",
+        "Content-Type": "application/json"
+      }
+    });
+  }
+  /**
+   * Sync spec to Jira Epic (CREATE or UPDATE)
+   */
+  async syncSpecToJira(specId) {
+    console.log(`
+\u{1F504} Syncing spec ${specId} to Jira Epic...`);
+    try {
+      const spec = await this.specManager.loadSpec(specId);
+      if (!spec) {
+        return {
+          success: false,
+          specId,
+          provider: "jira",
+          error: `Spec ${specId} not found`
+        };
+      }
+      const existingLink = spec.metadata.externalLinks?.jira;
+      let epic;
+      if (existingLink?.epicKey) {
+        console.log(`   Found existing Jira Epic ${existingLink.epicKey}`);
+        epic = await this.updateJiraEpic(existingLink.epicKey, spec);
+      } else {
+        console.log("   Creating new Jira Epic...");
+        epic = await this.createJiraEpic(spec);
+        await this.specManager.linkToExternal(specId, "jira", {
+          id: epic.key,
+          url: epic.url,
+          projectKey: this.config.projectKey,
+          domain: this.config.domain
         });
+      }
+      const changes = await this.syncUserStories(epic.key, spec);
+      console.log("\u2705 Sync complete!");
+      return {
+        success: true,
+        specId,
+        provider: "jira",
+        externalId: epic.key,
+        url: epic.url,
+        changes
+      };
+    } catch (error) {
+      console.error("\u274C Error syncing to Jira:", error);
+      return {
+        success: false,
+        specId,
+        provider: "jira",
+        error: error instanceof Error ? error.message : "Unknown error"
+      };
     }
-    /**
-     * Sync spec to Jira Epic (CREATE or UPDATE)
-     */
-    async syncSpecToJira(specId) {
-        console.log(`\n🔄 Syncing spec ${specId} to Jira Epic...`);
-        try {
-            // 1. Load spec
-            const spec = await this.specManager.loadSpec(specId);
-            if (!spec) {
-                return {
-                    success: false,
-                    specId,
-                    provider: 'jira',
-                    error: `Spec ${specId} not found`
-                };
-            }
-            // 2. Check if spec already linked to Jira Epic
-            const existingLink = spec.metadata.externalLinks?.jira;
-            let epic;
-            if (existingLink?.epicKey) {
-                // UPDATE existing epic
-                console.log(`   Found existing Jira Epic ${existingLink.epicKey}`);
-                epic = await this.updateJiraEpic(existingLink.epicKey, spec);
-            }
-            else {
-                // CREATE new epic
-                console.log('   Creating new Jira Epic...');
-                epic = await this.createJiraEpic(spec);
-                // Link spec to epic
-                await this.specManager.linkToExternal(specId, 'jira', {
-                    id: epic.key,
-                    url: epic.url,
-                    projectKey: this.config.projectKey,
-                    domain: this.config.domain
-                });
-            }
-            // 3. Sync user stories as Jira Stories
-            const changes = await this.syncUserStories(epic.key, spec);
-            console.log('✅ Sync complete!');
-            return {
-                success: true,
-                specId,
-                provider: 'jira',
-                externalId: epic.key,
-                url: epic.url,
-                changes
-            };
-        }
-        catch (error) {
-            console.error('❌ Error syncing to Jira:', error);
-            return {
-                success: false,
-                specId,
-                provider: 'jira',
-                error: error instanceof Error ? error.message : 'Unknown error'
-            };
-        }
-    }
-    /**
-     * Sync FROM Jira Epic to spec (bidirectional)
-     */
-    async syncFromJira(specId) {
-        console.log(`\n🔄 Syncing FROM Jira to spec ${specId}...`);
-        try {
-            // 1. Load spec
-            const spec = await this.specManager.loadSpec(specId);
-            if (!spec) {
-                return {
-                    success: false,
-                    specId,
-                    provider: 'jira',
-                    error: `Spec ${specId} not found`
-                };
-            }
-            // 2. Get Jira Epic link
-            const jiraLink = spec.metadata.externalLinks?.jira;
-            if (!jiraLink?.epicKey) {
-                return {
-                    success: false,
-                    specId,
-                    provider: 'jira',
-                    error: 'Spec not linked to Jira Epic'
-                };
-            }
-            // 3. Fetch Jira Epic state
-            const epic = await this.fetchJiraEpic(jiraLink.epicKey);
-            // 4. Detect conflicts
-            const conflicts = await this.detectConflicts(spec, epic);
-            if (conflicts.length === 0) {
-                console.log('✅ No conflicts - spec and Jira in sync');
-                return {
-                    success: true,
-                    specId,
-                    provider: 'jira',
-                    externalId: epic.key,
-                    url: epic.url
-                };
-            }
-            console.log(`⚠️  Detected ${conflicts.length} conflict(s)`);
-            // 5. Resolve conflicts (Jira wins by default for now)
-            await this.resolveConflicts(spec, conflicts);
-            console.log('✅ Sync FROM Jira complete!');
-            return {
-                success: true,
-                specId,
-                provider: 'jira',
-                externalId: epic.key,
-                url: epic.url,
-                conflicts
-            };
-        }
-        catch (error) {
-            console.error('❌ Error syncing FROM Jira:', error);
-            return {
-                success: false,
-                specId,
-                provider: 'jira',
-                error: error instanceof Error ? error.message : 'Unknown error'
-            };
-        }
-    }
-    /**
-     * Create new Jira Epic for spec
-     */
-    async createJiraEpic(spec) {
-        const epicSummary = `[${spec.metadata.id.toUpperCase()}] ${spec.metadata.title}`;
-        const epicDescription = this.generateEpicDescription(spec);
-        const payload = {
-            fields: {
-                project: {
-                    key: this.config.projectKey
-                },
-                summary: epicSummary,
-                description: epicDescription,
-                issuetype: {
-                    name: 'Epic'
-                },
-                labels: [`spec:${spec.metadata.id}`, `priority:${spec.metadata.priority}`]
-            }
-        };
-        const response = await this.client.post('/issue', payload);
-        const epicData = response.data;
-        const epicKey = epicData.key;
-        const epicUrl = `https://${this.config.domain}/browse/${epicKey}`;
-        console.log(`   ✅ Created Jira Epic ${epicKey}: ${epicUrl}`);
+  }
+  /**
+   * Sync FROM Jira Epic to spec (bidirectional)
+   */
+  async syncFromJira(specId) {
+    console.log(`
+\u{1F504} Syncing FROM Jira to spec ${specId}...`);
+    try {
+      const spec = await this.specManager.loadSpec(specId);
+      if (!spec) {
         return {
-            id: epicData.id,
-            key: epicKey,
-            summary: epicSummary,
-            description: epicDescription,
-            status: { name: 'To Do' },
-            url: epicUrl
+          success: false,
+          specId,
+          provider: "jira",
+          error: `Spec ${specId} not found`
         };
-    }
-    /**
-     * Update existing Jira Epic
-     */
-    async updateJiraEpic(epicKey, spec) {
-        const epicSummary = `[${spec.metadata.id.toUpperCase()}] ${spec.metadata.title}`;
-        const epicDescription = this.generateEpicDescription(spec);
-        const payload = {
-            fields: {
-                summary: epicSummary,
-                description: epicDescription
-            }
+      }
+      const jiraLink = spec.metadata.externalLinks?.jira;
+      if (!jiraLink?.epicKey) {
+        return {
+          success: false,
+          specId,
+          provider: "jira",
+          error: "Spec not linked to Jira Epic"
         };
-        await this.client.put(`/issue/${epicKey}`, payload);
-        // Fetch updated epic
-        const response = await this.client.get(`/issue/${epicKey}`);
-        const epicData = response.data;
-        console.log(`   ✅ Updated Jira Epic ${epicKey}`);
+      }
+      const epic = await this.fetchJiraEpic(jiraLink.epicKey);
+      const conflicts = await this.detectConflicts(spec, epic);
+      if (conflicts.length === 0) {
+        console.log("\u2705 No conflicts - spec and Jira in sync");
         return {
-            id: epicData.id,
-            key: epicKey,
-            summary: epicData.fields.summary,
-            description: epicData.fields.description,
-            status: epicData.fields.status,
-            url: `https://${this.config.domain}/browse/${epicKey}`
+          success: true,
+          specId,
+          provider: "jira",
+          externalId: epic.key,
+          url: epic.url
         };
+      }
+      console.log(`\u26A0\uFE0F  Detected ${conflicts.length} conflict(s)`);
+      await this.resolveConflicts(spec, conflicts);
+      console.log("\u2705 Sync FROM Jira complete!");
+      return {
+        success: true,
+        specId,
+        provider: "jira",
+        externalId: epic.key,
+        url: epic.url,
+        conflicts
+      };
+    } catch (error) {
+      console.error("\u274C Error syncing FROM Jira:", error);
+      return {
+        success: false,
+        specId,
+        provider: "jira",
+        error: error instanceof Error ? error.message : "Unknown error"
+      };
     }
-    /**
-     * Sync user stories as Jira Stories
-     */
-    async syncUserStories(epicKey, spec) {
-        const created = [];
-        const updated = [];
-        const deleted = [];
-        if (!spec.metadata.userStories || spec.metadata.userStories.length === 0) {
-            console.log('   ℹ️  No user stories to sync');
-            return { created, updated, deleted };
-        }
-        console.log(`   Syncing ${spec.metadata.userStories.length} user stories...`);
-        for (const us of spec.metadata.userStories) {
-            // Create or update Jira Story for each user story
-            const storySummary = `[${us.id}] ${us.title}`;
-            const storyDescription = this.generateStoryDescription(us);
-            // Check if story already exists (by searching for US-ID in summary)
-            const existingStory = await this.findStoryByTitle(us.id);
-            if (existingStory) {
-                // UPDATE existing story
-                await this.updateStory(existingStory.key, {
-                    summary: storySummary,
-                    description: storyDescription,
-                    status: us.status === 'done' ? 'Done' : us.status === 'in-progress' ? 'In Progress' : 'To Do'
-                });
-                updated.push(us.id);
-                console.log(`   ✅ Updated ${us.id}`);
-            }
-            else {
-                // CREATE new story
-                const newStory = await this.createStory({
-                    summary: storySummary,
-                    description: storyDescription,
-                    epicLink: epicKey,
-                    labels: [`user-story`, `spec:${spec.metadata.id}`, `priority:${us.priority}`]
-                });
-                created.push(us.id);
-                console.log(`   ✅ Created ${us.id} → Story ${newStory.key}`);
-            }
-        }
-        return { created, updated, deleted };
+  }
+  /**
+   * Create new Jira Epic for spec
+   */
+  async createJiraEpic(spec) {
+    const epicSummary = `[${spec.metadata.id.toUpperCase()}] ${spec.metadata.title}`;
+    const epicDescription = this.generateEpicDescription(spec);
+    const payload = {
+      fields: {
+        project: {
+          key: this.config.projectKey
+        },
+        summary: epicSummary,
+        description: epicDescription,
+        issuetype: {
+          name: "Epic"
+        },
+        labels: [`spec:${spec.metadata.id}`, `priority:${spec.metadata.priority}`]
+      }
+    };
+    const response = await this.client.post("/issue", payload);
+    const epicData = response.data;
+    const epicKey = epicData.key;
+    const epicUrl = `https://${this.config.domain}/browse/${epicKey}`;
+    console.log(`   \u2705 Created Jira Epic ${epicKey}: ${epicUrl}`);
+    return {
+      id: epicData.id,
+      key: epicKey,
+      summary: epicSummary,
+      description: epicDescription,
+      status: { name: "To Do" },
+      url: epicUrl
+    };
+  }
+  /**
+   * Update existing Jira Epic
+   */
+  async updateJiraEpic(epicKey, spec) {
+    const epicSummary = `[${spec.metadata.id.toUpperCase()}] ${spec.metadata.title}`;
+    const epicDescription = this.generateEpicDescription(spec);
+    const payload = {
+      fields: {
+        summary: epicSummary,
+        description: epicDescription
+      }
+    };
+    await this.client.put(`/issue/${epicKey}`, payload);
+    const response = await this.client.get(`/issue/${epicKey}`);
+    const epicData = response.data;
+    console.log(`   \u2705 Updated Jira Epic ${epicKey}`);
+    return {
+      id: epicData.id,
+      key: epicKey,
+      summary: epicData.fields.summary,
+      description: epicData.fields.description,
+      status: epicData.fields.status,
+      url: `https://${this.config.domain}/browse/${epicKey}`
+    };
+  }
+  /**
+   * Sync user stories as Jira Stories
+   */
+  async syncUserStories(epicKey, spec) {
+    const created = [];
+    const updated = [];
+    const deleted = [];
+    if (!spec.metadata.userStories || spec.metadata.userStories.length === 0) {
+      console.log("   \u2139\uFE0F  No user stories to sync");
+      return { created, updated, deleted };
+    }
+    console.log(`   Syncing ${spec.metadata.userStories.length} user stories...`);
+    for (const us of spec.metadata.userStories) {
+      const storySummary = `[${us.id}] ${us.title}`;
+      const storyDescription = this.generateStoryDescription(us);
+      const existingStory = await this.findStoryByTitle(us.id);
+      if (existingStory) {
+        await this.updateStory(existingStory.key, {
+          summary: storySummary,
+          description: storyDescription,
+          status: us.status === "done" ? "Done" : us.status === "in-progress" ? "In Progress" : "To Do"
+        });
+        updated.push(us.id);
+        console.log(`   \u2705 Updated ${us.id}`);
+      } else {
+        const newStory = await this.createStory({
+          summary: storySummary,
+          description: storyDescription,
+          epicLink: epicKey,
+          labels: [`user-story`, `spec:${spec.metadata.id}`, `priority:${us.priority}`]
+        });
+        created.push(us.id);
+        console.log(`   \u2705 Created ${us.id} \u2192 Story ${newStory.key}`);
+      }
     }
-    /**
-     * Generate epic description from spec
-     */
-    generateEpicDescription(spec) {
-        const progress = spec.metadata.progress;
-        const progressText = progress
-            ? `*Progress*: ${progress.percentComplete}% (${progress.completedUserStories}/${progress.totalUserStories} user stories)`
-            : '*Progress*: N/A';
-        return `
+    return { created, updated, deleted };
+  }
+  /**
+   * Generate epic description from spec
+   */
+  generateEpicDescription(spec) {
+    const progress = spec.metadata.progress;
+    const progressText = progress ? `*Progress*: ${progress.percentComplete}% (${progress.completedUserStories}/${progress.totalUserStories} user stories)` : "*Progress*: N/A";
+    return `
 h1. ${spec.metadata.title}
 
 *Spec ID*: ${spec.metadata.id}
@@ -282,18 +247,16 @@ ${spec.metadata.userStories?.length || 0} user stories tracked in this epic.
 
 ----
 
-🤖 *Auto-synced from SpecWeave*
-Last updated: ${new Date().toISOString()}
+\u{1F916} *Auto-synced from SpecWeave*
+Last updated: ${(/* @__PURE__ */ new Date()).toISOString()}
 `.trim();
-    }
-    /**
-     * Generate story description from user story
-     */
-    generateStoryDescription(us) {
-        const acList = us.acceptanceCriteria
-            .map(ac => `* ${ac.status === 'done' ? '(/)' : '(x)'} ${ac.description}`)
-            .join('\n');
-        return `
+  }
+  /**
+   * Generate story description from user story
+   */
+  generateStoryDescription(us) {
+    const acList = us.acceptanceCriteria.map((ac) => `* ${ac.status === "done" ? "(/)" : "(x)"} ${ac.description}`).join("\n");
+    return `
 h2. User Story
 
 ${us.title}
@@ -307,150 +270,148 @@ ${acList}
 *Priority*: ${us.priority}
 *Status*: ${us.status}
 
-🤖 *Auto-synced from SpecWeave*
+\u{1F916} *Auto-synced from SpecWeave*
 `.trim();
+  }
+  /**
+   * Detect conflicts between spec and Jira
+   */
+  async detectConflicts(spec, epic) {
+    const conflicts = [];
+    const expectedSummary = `[${spec.metadata.id.toUpperCase()}] ${spec.metadata.title}`;
+    if (epic.summary !== expectedSummary) {
+      conflicts.push({
+        type: "metadata",
+        field: "title",
+        localValue: spec.metadata.title,
+        remoteValue: epic.summary,
+        resolution: "remote-wins",
+        description: "Epic summary differs from spec title"
+      });
     }
-    /**
-     * Detect conflicts between spec and Jira
-     */
-    async detectConflicts(spec, epic) {
-        const conflicts = [];
-        // Compare epic summary
-        const expectedSummary = `[${spec.metadata.id.toUpperCase()}] ${spec.metadata.title}`;
-        if (epic.summary !== expectedSummary) {
-            conflicts.push({
-                type: 'metadata',
-                field: 'title',
-                localValue: spec.metadata.title,
-                remoteValue: epic.summary,
-                resolution: 'remote-wins',
-                description: 'Epic summary differs from spec title'
-            });
-        }
-        // TODO: Compare user stories and their statuses
-        return conflicts;
-    }
-    /**
-     * Resolve conflicts
-     */
-    async resolveConflicts(spec, conflicts) {
-        for (const conflict of conflicts) {
-            if (conflict.resolution === 'remote-wins') {
-                console.log(`   🔄 Resolving: ${conflict.description} (Jira wins)`);
-                // Update spec metadata from Jira
-                if (conflict.field === 'title') {
-                    await this.specManager.saveMetadata(spec.metadata.id, {
-                        title: conflict.remoteValue
-                    });
-                }
-            }
+    return conflicts;
+  }
+  /**
+   * Resolve conflicts
+   */
+  async resolveConflicts(spec, conflicts) {
+    for (const conflict of conflicts) {
+      if (conflict.resolution === "remote-wins") {
+        console.log(`   \u{1F504} Resolving: ${conflict.description} (Jira wins)`);
+        if (conflict.field === "title") {
+          await this.specManager.saveMetadata(spec.metadata.id, {
+            title: conflict.remoteValue
+          });
         }
+      }
     }
-    /**
-     * Fetch Jira Epic details
-     */
-    async fetchJiraEpic(epicKey) {
-        const response = await this.client.get(`/issue/${epicKey}`);
-        const epicData = response.data;
-        return {
-            id: epicData.id,
-            key: epicKey,
-            summary: epicData.fields.summary,
-            description: epicData.fields.description,
-            status: epicData.fields.status,
-            url: `https://${this.config.domain}/browse/${epicKey}`
-        };
-    }
-    /**
-     * Find story by title pattern
-     */
-    async findStoryByTitle(usId) {
-        const jql = `project = ${this.config.projectKey} AND summary ~ "[${usId}]" AND issuetype = Story`;
-        const response = await this.client.get('/search', {
-            params: {
-                jql,
-                maxResults: 1,
-                fields: 'summary,description,status,labels'
-            }
-        });
-        const issues = response.data.issues;
-        return issues.length > 0 ? {
-            id: issues[0].id,
-            key: issues[0].key,
-            summary: issues[0].fields.summary,
-            description: issues[0].fields.description,
-            status: issues[0].fields.status,
-            labels: issues[0].fields.labels || []
-        } : null;
+  }
+  /**
+   * Fetch Jira Epic details
+   */
+  async fetchJiraEpic(epicKey) {
+    const response = await this.client.get(`/issue/${epicKey}`);
+    const epicData = response.data;
+    return {
+      id: epicData.id,
+      key: epicKey,
+      summary: epicData.fields.summary,
+      description: epicData.fields.description,
+      status: epicData.fields.status,
+      url: `https://${this.config.domain}/browse/${epicKey}`
+    };
+  }
+  /**
+   * Find story by title pattern
+   */
+  async findStoryByTitle(usId) {
+    const jql = `project = ${this.config.projectKey} AND summary ~ "[${usId}]" AND issuetype = Story`;
+    const response = await this.client.get("/search", {
+      params: {
+        jql,
+        maxResults: 1,
+        fields: "summary,description,status,labels"
+      }
+    });
+    const issues = response.data.issues;
+    return issues.length > 0 ? {
+      id: issues[0].id,
+      key: issues[0].key,
+      summary: issues[0].fields.summary,
+      description: issues[0].fields.description,
+      status: issues[0].fields.status,
+      labels: issues[0].fields.labels || []
+    } : null;
+  }
+  /**
+   * Create Jira Story
+   */
+  async createStory(story) {
+    const payload = {
+      fields: {
+        project: {
+          key: this.config.projectKey
+        },
+        summary: story.summary,
+        description: story.description,
+        issuetype: {
+          name: "Story"
+        },
+        labels: story.labels,
+        // Link to epic (field name may vary by Jira configuration)
+        customfield_10014: story.epicLink
+        // Epic Link field (adjust if needed)
+      }
+    };
+    const response = await this.client.post("/issue", payload);
+    const storyData = response.data;
+    return {
+      id: storyData.id,
+      key: storyData.key,
+      summary: story.summary,
+      description: story.description,
+      status: { name: "To Do" },
+      labels: story.labels
+    };
+  }
+  /**
+   * Update Jira Story
+   */
+  async updateStory(storyKey, updates) {
+    const payload = {
+      fields: {}
+    };
+    if (updates.summary) {
+      payload.fields.summary = updates.summary;
     }
-    /**
-     * Create Jira Story
-     */
-    async createStory(story) {
-        const payload = {
-            fields: {
-                project: {
-                    key: this.config.projectKey
-                },
-                summary: story.summary,
-                description: story.description,
-                issuetype: {
-                    name: 'Story'
-                },
-                labels: story.labels,
-                // Link to epic (field name may vary by Jira configuration)
-                customfield_10014: story.epicLink // Epic Link field (adjust if needed)
-            }
-        };
-        const response = await this.client.post('/issue', payload);
-        const storyData = response.data;
-        return {
-            id: storyData.id,
-            key: storyData.key,
-            summary: story.summary,
-            description: story.description,
-            status: { name: 'To Do' },
-            labels: story.labels
-        };
+    if (updates.description) {
+      payload.fields.description = updates.description;
     }
-    /**
-     * Update Jira Story
-     */
-    async updateStory(storyKey, updates) {
-        const payload = {
-            fields: {}
-        };
-        if (updates.summary) {
-            payload.fields.summary = updates.summary;
-        }
-        if (updates.description) {
-            payload.fields.description = updates.description;
-        }
-        await this.client.put(`/issue/${storyKey}`, payload);
-        // Handle status transition if needed
-        if (updates.status) {
-            await this.transitionIssue(storyKey, updates.status);
-        }
+    await this.client.put(`/issue/${storyKey}`, payload);
+    if (updates.status) {
+      await this.transitionIssue(storyKey, updates.status);
     }
-    /**
-     * Transition issue to new status
-     */
-    async transitionIssue(issueKey, targetStatus) {
-        // Get available transitions
-        const transitionsResponse = await this.client.get(`/issue/${issueKey}/transitions`);
-        const transitions = transitionsResponse.data.transitions;
-        // Find transition matching target status
-        const transition = transitions.find((t) => t.to.name.toLowerCase() === targetStatus.toLowerCase());
-        if (!transition) {
-            console.warn(`   ⚠️  Cannot transition ${issueKey} to ${targetStatus} (no valid transition)`);
-            return;
-        }
-        // Execute transition
-        await this.client.post(`/issue/${issueKey}/transitions`, {
-            transition: {
-                id: transition.id
-            }
-        });
+  }
+  /**
+   * Transition issue to new status
+   */
+  async transitionIssue(issueKey, targetStatus) {
+    const transitionsResponse = await this.client.get(`/issue/${issueKey}/transitions`);
+    const transitions = transitionsResponse.data.transitions;
+    const transition = transitions.find(
+      (t) => t.to.name.toLowerCase() === targetStatus.toLowerCase()
+    );
+    if (!transition) {
+      console.warn(`   \u26A0\uFE0F  Cannot transition ${issueKey} to ${targetStatus} (no valid transition)`);
+      return;
     }
+    await this.client.post(`/issue/${issueKey}/transitions`, {
+      transition: {
+        id: transition.id
+      }
+    });
+  }
 }
-//# sourceMappingURL=jira-spec-sync.js.map
+export {
+  JiraSpecSync
+};