specweave 0.17.16 → 0.17.19

package/dist/plugins/specweave-jira/lib/jira-epic-sync.js

@@ -0,0 +1,274 @@
+/**
+ * JIRA Epic Sync - Hierarchical synchronization for Epic folder structure
+ *
+ * Architecture:
+ * - Epic (FS-001) → JIRA Epic
+ * - Increment (0001-core-framework) → JIRA Story (with Epic Link field)
+ *
+ * This implements the Universal Hierarchy architecture for JIRA.
+ */
+import * as fs from 'fs-extra';
+import * as path from 'path';
+import * as yaml from 'yaml';
+export class JiraEpicSync {
+    constructor(client, specsDir, projectKey) {
+        this.client = client;
+        this.specsDir = specsDir;
+        this.projectKey = projectKey;
+    }
+    /**
+     * Sync Epic folder to JIRA (Epic + Stories)
+     */
+    async syncEpicToJira(epicId) {
+        console.log(`\n🔄 Syncing Epic ${epicId} to JIRA...`);
+        // 1. Load Epic README.md
+        const epicFolder = await this.findEpicFolder(epicId);
+        if (!epicFolder) {
+            throw new Error(`Epic ${epicId} not found in ${this.specsDir}`);
+        }
+        const readmePath = path.join(epicFolder, 'README.md');
+        const epicData = await this.parseEpicReadme(readmePath);
+        console.log(`   📦 Epic: ${epicData.title}`);
+        console.log(`   📊 Increments: ${epicData.total_increments}`);
+        // 2. Create or update JIRA Epic
+        let epicKey = epicData.external_tools.jira.key;
+        let epicUrl = epicData.external_tools.jira.url;
+        if (!epicKey) {
+            console.log(`   🚀 Creating JIRA Epic...`);
+            const epic = await this.createEpic(epicData);
+            epicKey = epic.key;
+            epicUrl = epic.url;
+            console.log(`   ✅ Created Epic ${epicKey}`);
+            // Update Epic README with JIRA key
+            await this.updateEpicReadme(readmePath, {
+                type: 'epic',
+                key: epicKey,
+                url: epicUrl,
+            });
+        }
+        else {
+            console.log(`   ♻️  Updating existing Epic ${epicKey}...`);
+            await this.updateEpic(epicKey, epicData);
+            console.log(`   ✅ Updated Epic ${epicKey}`);
+        }
+        // 3. Sync each increment as JIRA Story
+        let storiesCreated = 0;
+        let storiesUpdated = 0;
+        console.log(`\n   📝 Syncing ${epicData.increments.length} increments...`);
+        for (const increment of epicData.increments) {
+            const incrementFile = path.join(epicFolder, `${increment.id}.md`);
+            if (!(await fs.pathExists(incrementFile))) {
+                console.log(`   ⚠️  Increment file not found: ${increment.id}.md`);
+                continue;
+            }
+            const incrementData = await this.parseIncrementFile(incrementFile);
+            const existingStory = increment.external.jira;
+            if (!existingStory) {
+                // Create new Story
+                const storyKey = await this.createStory(epicData.id, incrementData, epicKey);
+                storiesCreated++;
+                console.log(`   ✅ Created Story ${storyKey} for ${increment.id}`);
+                // Update Epic README and Increment file
+                await this.updateIncrementExternalLink(readmePath, incrementFile, increment.id, storyKey);
+            }
+            else {
+                // Update existing Story
+                await this.updateStory(epicData.id, existingStory, incrementData, epicKey);
+                storiesUpdated++;
+                console.log(`   ♻️  Updated Story ${existingStory} for ${increment.id}`);
+            }
+        }
+        console.log(`\n✅ Epic sync complete!`);
+        console.log(`   Epic: ${epicUrl}`);
+        console.log(`   Stories created: ${storiesCreated}`);
+        console.log(`   Stories updated: ${storiesUpdated}`);
+        return {
+            epicKey: epicKey,
+            epicUrl: epicUrl,
+            storiesCreated,
+            storiesUpdated,
+        };
+    }
+    /**
+     * Find Epic folder by ID (FS-001 or just 001)
+     */
+    async findEpicFolder(epicId) {
+        const normalizedId = epicId.startsWith('FS-')
+            ? epicId
+            : `FS-${epicId.padStart(3, '0')}`;
+        const folders = await fs.readdir(this.specsDir);
+        for (const folder of folders) {
+            if (folder.startsWith(normalizedId)) {
+                return path.join(this.specsDir, folder);
+            }
+        }
+        return null;
+    }
+    /**
+     * Parse Epic README.md to extract frontmatter
+     */
+    async parseEpicReadme(readmePath) {
+        const content = await fs.readFile(readmePath, 'utf-8');
+        const match = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!match) {
+            throw new Error('Epic README.md missing YAML frontmatter');
+        }
+        const frontmatter = yaml.parse(match[1]);
+        return frontmatter;
+    }
+    /**
+     * Parse increment file to extract title and overview
+     */
+    async parseIncrementFile(filePath) {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const match = content.match(/^---\n([\s\S]*?)\n---/);
+        let frontmatter = { id: '', epic: '' };
+        let bodyContent = content;
+        if (match) {
+            frontmatter = yaml.parse(match[1]);
+            bodyContent = content.slice(match[0].length).trim();
+        }
+        // Extract title
+        const titleMatch = bodyContent.match(/^#\s+(.+)$/m);
+        const title = titleMatch
+            ? titleMatch[1].trim()
+            : frontmatter.id || path.basename(filePath, '.md');
+        // Extract overview (first paragraph after title)
+        const overviewMatch = bodyContent.match(/^#[^\n]+\n+([^\n]+)/);
+        const overview = overviewMatch
+            ? overviewMatch[1].trim()
+            : 'No overview available';
+        return {
+            id: frontmatter.id,
+            title,
+            overview,
+            content: bodyContent,
+            frontmatter,
+        };
+    }
+    /**
+     * Create JIRA Epic
+     */
+    async createEpic(epic) {
+        const summary = `[${epic.id}] ${epic.title}`;
+        const description = `Epic: ${epic.title}\n\nProgress: ${epic.completed_increments}/${epic.total_increments} increments (${epic.progress})\n\nPriority: ${epic.priority}\nStatus: ${epic.status}`;
+        const issueData = {
+            issueType: 'Epic',
+            summary,
+            description,
+            priority: this.mapPriorityToJira(epic.priority),
+            labels: ['epic-sync', epic.id.toLowerCase()],
+        };
+        const issue = await this.client.createIssue(issueData, this.projectKey);
+        return {
+            key: issue.key,
+            url: issue.self.replace('/rest/api/3/issue/', '/browse/'),
+        };
+    }
+    /**
+     * Update JIRA Epic
+     */
+    async updateEpic(epicKey, epic) {
+        const summary = `[${epic.id}] ${epic.title}`;
+        const description = `Epic: ${epic.title}\n\nProgress: ${epic.completed_increments}/${epic.total_increments} increments (${epic.progress})\n\nPriority: ${epic.priority}\nStatus: ${epic.status}`;
+        await this.client.updateIssue({
+            key: epicKey,
+            summary,
+            description,
+            priority: this.mapPriorityToJira(epic.priority),
+            labels: ['epic-sync', epic.id.toLowerCase()],
+        });
+    }
+    /**
+     * Create JIRA Story for increment
+     */
+    async createStory(epicId, increment, epicKey) {
+        const summary = `[${epicId}] ${increment.title}`;
+        const description = `${increment.overview}\n\n---\n\n**Increment**: ${increment.id}\n**Epic**: ${epicId} (${epicKey})\n\n🤖 Auto-created by SpecWeave Epic Sync`;
+        const issueData = {
+            issueType: 'Story',
+            summary,
+            description,
+            epicKey, // Link to Epic via Epic Link field
+            labels: ['increment', 'epic-sync'],
+        };
+        const issue = await this.client.createIssue(issueData, this.projectKey);
+        return issue.key;
+    }
+    /**
+     * Update JIRA Story for increment
+     */
+    async updateStory(epicId, storyKey, increment, epicKey) {
+        const summary = `[${epicId}] ${increment.title}`;
+        const description = `${increment.overview}\n\n---\n\n**Increment**: ${increment.id}\n**Epic**: ${epicId} (${epicKey})\n\n🤖 Auto-updated by SpecWeave Epic Sync`;
+        await this.client.updateIssue({
+            key: storyKey,
+            summary,
+            description,
+            labels: ['increment', 'epic-sync'],
+        });
+    }
+    /**
+     * Map SpecWeave priority to JIRA priority
+     */
+    mapPriorityToJira(priority) {
+        const map = {
+            P0: 'Highest',
+            P1: 'High',
+            P2: 'Medium',
+            P3: 'Low',
+        };
+        return map[priority] || 'Medium';
+    }
+    /**
+     * Update Epic README.md with JIRA Epic key
+     */
+    async updateEpicReadme(readmePath, jira) {
+        const content = await fs.readFile(readmePath, 'utf-8');
+        const match = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!match) {
+            throw new Error('Epic README.md missing YAML frontmatter');
+        }
+        const frontmatter = yaml.parse(match[1]);
+        frontmatter.external_tools.jira = jira;
+        const newFrontmatter = yaml.stringify(frontmatter);
+        const newContent = content.replace(/^---\n[\s\S]*?\n---/, `---\n${newFrontmatter}---`);
+        await fs.writeFile(readmePath, newContent, 'utf-8');
+    }
+    /**
+     * Update increment external link in both Epic README and increment file
+     */
+    async updateIncrementExternalLink(readmePath, incrementFile, incrementId, storyKey) {
+        const storyUrl = `https://${this.client['credentials'].domain}/browse/${storyKey}`;
+        // 1. Update Epic README.md
+        const readmeContent = await fs.readFile(readmePath, 'utf-8');
+        const readmeMatch = readmeContent.match(/^---\n([\s\S]*?)\n---/);
+        if (readmeMatch) {
+            const frontmatter = yaml.parse(readmeMatch[1]);
+            const increment = frontmatter.increments.find((inc) => inc.id === incrementId);
+            if (increment) {
+                increment.external.jira = storyKey;
+                const newFrontmatter = yaml.stringify(frontmatter);
+                const newContent = readmeContent.replace(/^---\n[\s\S]*?\n---/, `---\n${newFrontmatter}---`);
+                await fs.writeFile(readmePath, newContent, 'utf-8');
+            }
+        }
+        // 2. Update increment file frontmatter
+        const incrementContent = await fs.readFile(incrementFile, 'utf-8');
+        const incrementMatch = incrementContent.match(/^---\n([\s\S]*?)\n---/);
+        if (incrementMatch) {
+            const frontmatter = yaml.parse(incrementMatch[1]);
+            if (!frontmatter.external) {
+                frontmatter.external = {};
+            }
+            frontmatter.external.jira = {
+                story: storyKey,
+                url: storyUrl,
+            };
+            const newFrontmatter = yaml.stringify(frontmatter);
+            const newContent = incrementContent.replace(/^---\n[\s\S]*?\n---/, `---\n${newFrontmatter}---`);
+            await fs.writeFile(incrementFile, newContent, 'utf-8');
+        }
+    }
+}
+//# sourceMappingURL=jira-epic-sync.js.map

package/dist/plugins/specweave-jira/lib/jira-epic-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-epic-sync.js","sourceRoot":"","sources":["../../../../plugins/specweave-jira/lib/jira-epic-sync.ts"],"names":[],"mappings":"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"}

package/dist/plugins/specweave-jira/lib/jira-status-sync.d.ts

@@ -0,0 +1,56 @@
+/**
+ * JIRA Status Sync
+ *
+ * Synchronizes SpecWeave increment statuses with JIRA issue statuses.
+ *
+ * JIRA Status Transitions:
+ * - Uses JIRA transitions API to change issue status
+ * - Available transitions depend on workflow configuration
+ * - Must fetch available transitions before applying
+ *
+ * @module jira-status-sync
+ */
+/**
+ * External status representation (JIRA-specific)
+ */
+export interface ExternalStatus {
+    state: string;
+    labels?: string[];
+}
+/**
+ * JIRA Status Sync
+ *
+ * Handles status synchronization with JIRA issues.
+ */
+export declare class JiraStatusSync {
+    private client;
+    private domain;
+    private projectKey;
+    constructor(domain: string, email: string, apiToken: string, projectKey: string);
+    /**
+     * Get current status from JIRA issue
+     *
+     * @param issueKey - JIRA issue key (e.g., PROJ-123)
+     * @returns Current issue status
+     */
+    getStatus(issueKey: string): Promise<ExternalStatus>;
+    /**
+     * Update JIRA issue status via transitions
+     *
+     * JIRA requires using transitions to change status.
+     * Cannot directly set status field.
+     *
+     * @param issueKey - JIRA issue key (e.g., PROJ-123)
+     * @param status - Desired status
+     */
+    updateStatus(issueKey: string, status: ExternalStatus): Promise<void>;
+    /**
+     * Post comment about status change to JIRA issue
+     *
+     * @param issueKey - JIRA issue key (e.g., PROJ-123)
+     * @param oldStatus - Previous SpecWeave status
+     * @param newStatus - New SpecWeave status
+     */
+    postStatusComment(issueKey: string, oldStatus: string, newStatus: string): Promise<void>;
+}
+//# sourceMappingURL=jira-status-sync.d.ts.map

package/dist/plugins/specweave-jira/lib/jira-status-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-status-sync.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-jira/lib/jira-status-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAaD;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;gBAGzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM;IAmBpB;;;;;OAKG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAQ1D;;;;;;;;OAQG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB3E;;;;;;OAMG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;CAYjB"}

package/dist/plugins/specweave-jira/lib/jira-status-sync.js

@@ -0,0 +1,93 @@
+/**
+ * JIRA Status Sync
+ *
+ * Synchronizes SpecWeave increment statuses with JIRA issue statuses.
+ *
+ * JIRA Status Transitions:
+ * - Uses JIRA transitions API to change issue status
+ * - Available transitions depend on workflow configuration
+ * - Must fetch available transitions before applying
+ *
+ * @module jira-status-sync
+ */
+import axios from 'axios';
+/**
+ * JIRA Status Sync
+ *
+ * Handles status synchronization with JIRA issues.
+ */
+export class JiraStatusSync {
+    constructor(domain, email, apiToken, projectKey) {
+        this.domain = domain;
+        this.projectKey = projectKey;
+        // Create JIRA API client
+        this.client = axios.create({
+            baseURL: `https://${domain}/rest/api/3`,
+            auth: {
+                username: email,
+                password: apiToken
+            },
+            headers: {
+                'Accept': 'application/json',
+                'Content-Type': 'application/json'
+            }
+        });
+    }
+    /**
+     * Get current status from JIRA issue
+     *
+     * @param issueKey - JIRA issue key (e.g., PROJ-123)
+     * @returns Current issue status
+     */
+    async getStatus(issueKey) {
+        const response = await this.client.get(`/issue/${issueKey}`);
+        return {
+            state: response.data.fields.status.name
+        };
+    }
+    /**
+     * Update JIRA issue status via transitions
+     *
+     * JIRA requires using transitions to change status.
+     * Cannot directly set status field.
+     *
+     * @param issueKey - JIRA issue key (e.g., PROJ-123)
+     * @param status - Desired status
+     */
+    async updateStatus(issueKey, status) {
+        // 1. Get available transitions for this issue
+        const transitionsResponse = await this.client.get(`/issue/${issueKey}/transitions`);
+        const transitions = transitionsResponse.data.transitions;
+        // 2. Find transition that leads to desired status
+        const targetTransition = transitions.find((t) => t.to.name === status.state);
+        if (!targetTransition) {
+            throw new Error(`Transition to ${status.state} not available for ${issueKey}. ` +
+                `Available transitions: ${transitions.map(t => t.to.name).join(', ')}`);
+        }
+        // 3. Execute transition
+        await this.client.post(`/issue/${issueKey}/transitions`, {
+            transition: {
+                id: targetTransition.id
+            }
+        });
+    }
+    /**
+     * Post comment about status change to JIRA issue
+     *
+     * @param issueKey - JIRA issue key (e.g., PROJ-123)
+     * @param oldStatus - Previous SpecWeave status
+     * @param newStatus - New SpecWeave status
+     */
+    async postStatusComment(issueKey, oldStatus, newStatus) {
+        const body = `🔄 *Status Update*\n\n` +
+            `SpecWeave status changed:\n` +
+            `• *From*: ${oldStatus}\n` +
+            `• *To*: ${newStatus}\n` +
+            `• *When*: ${new Date().toISOString()}\n\n` +
+            `_Synced from SpecWeave_`;
+        await this.client.post(`/issue/${issueKey}/comment`, {
+            body
+        });
+    }
+}
+//# sourceMappingURL=jira-status-sync.js.map

package/dist/plugins/specweave-jira/lib/jira-status-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-status-sync.js","sourceRoot":"","sources":["../../../../plugins/specweave-jira/lib/jira-status-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAwB,MAAM,OAAO,CAAC;AAqB7C;;;;GAIG;AACH,MAAM,OAAO,cAAc;IAKzB,YACE,MAAc,EACd,KAAa,EACb,QAAgB,EAChB,UAAkB;QAElB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,yBAAyB;QACzB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YACzB,OAAO,EAAE,WAAW,MAAM,aAAa;YACvC,IAAI,EAAE;gBACJ,QAAQ,EAAE,KAAK;gBACf,QAAQ,EAAE,QAAQ;aACnB;YACD,OAAO,EAAE;gBACP,QAAQ,EAAE,kBAAkB;gBAC5B,cAAc,EAAE,kBAAkB;aACnC;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CAAC,QAAgB;QAC9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,QAAQ,EAAE,CAAC,CAAC;QAE7D,OAAO;YACL,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI;SACxC,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,YAAY,CAAC,QAAgB,EAAE,MAAsB;QACzD,8CAA8C;QAC9C,MAAM,mBAAmB,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,QAAQ,cAAc,CAAC,CAAC;QACpF,MAAM,WAAW,GAAqB,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC;QAE3E,kDAAkD;QAClD,MAAM,gBAAgB,GAAG,WAAW,CAAC,IAAI,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAClC,CAAC;QAEF,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,iBAAiB,MAAM,CAAC,KAAK,sBAAsB,QAAQ,IAAI;gBAC/D,0BAA0B,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvE,CAAC;QACJ,CAAC;QAED,wBAAwB;QACxB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,QAAQ,cAAc,EAAE;YACvD,UAAU,EAAE;gBACV,EAAE,EAAE,gBAAgB,CAAC,EAAE;aACxB;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,iBAAiB,CACrB,QAAgB,EAChB,SAAiB,EACjB,SAAiB;QAEjB,MAAM,IAAI,GAAG,wBAAwB;YACnC,6BAA6B;YAC7B,aAAa,SAAS,IAAI;YAC1B,WAAW,SAAS,IAAI;YACxB,aAAa,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM;YAC3C,yBAAyB,CAAC;QAE5B,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,QAAQ,UAAU,EAAE;YACnD,IAAI;SACL,CAAC,CAAC;IACL,CAAC;CACF"}