specweave 0.14.0 → 0.15.0

package/dist/src/integrations/jira/jira-client.js

@@ -0,0 +1,386 @@
+/**
+ * Jira API Client
+ *
+ * Supports:
+ * 1. MCP Server (Atlassian Remote MCP) - Primary
+ * 2. REST API v3 - Fallback
+ *
+ * Features:
+ * - List issues with JQL filtering (by sprint, status, etc.)
+ * - Create issues (Epic, Story, Subtask, Bug, Task)
+ * - Update issues
+ * - Get sprint information
+ */
+import { credentialsManager } from '../../core/credentials-manager.js';
+export class JiraClient {
+    constructor() {
+        this.apiVersion = '3';
+        this.useMcp = false;
+        this.credentials = credentialsManager.getJiraCredentials();
+        // Normalize domain URL
+        const domain = this.credentials.domain;
+        if (domain.startsWith('http')) {
+            this.baseUrl = domain;
+        }
+        else {
+            this.baseUrl = `https://${domain}`;
+        }
+    }
+    /**
+     * Get authorization header for REST API
+     */
+    getAuthHeader() {
+        const auth = Buffer.from(`${this.credentials.email}:${this.credentials.apiToken}`).toString('base64');
+        return `Basic ${auth}`;
+    }
+    /**
+     * Search issues using JQL
+     */
+    async searchIssues(filter = {}) {
+        const jql = filter.jql || this.buildJqlQuery(filter);
+        console.log('🔍 Querying Jira with JQL:', jql);
+        // Use the new /search/jql endpoint as per Jira Cloud API v3
+        const url = `${this.baseUrl}/rest/api/${this.apiVersion}/search/jql`;
+        const maxResults = filter.maxResults || 50;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Authorization': this.getAuthHeader(),
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({
+                jql,
+                maxResults,
+                fields: ['*all']
+            })
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Jira API Error (${response.status}): ${error}`);
+        }
+        const data = await response.json();
+        console.log(`✅ Retrieved ${data.issues.length} issues from Jira`);
+        return data.issues || [];
+    }
+    /**
+     * Build JQL query from filter
+     */
+    buildJqlQuery(filter) {
+        const conditions = [];
+        if (filter.project) {
+            conditions.push(`project = "${filter.project}"`);
+        }
+        if (filter.issueType && filter.issueType.length > 0) {
+            const types = filter.issueType.map(t => `"${t}"`).join(', ');
+            conditions.push(`issuetype IN (${types})`);
+        }
+        if (filter.status && filter.status.length > 0) {
+            const statuses = filter.status.map(s => `"${s}"`).join(', ');
+            conditions.push(`status IN (${statuses})`);
+        }
+        if (filter.sprint) {
+            if (typeof filter.sprint === 'number') {
+                conditions.push(`sprint = ${filter.sprint}`);
+            }
+            else if (filter.sprint === 'current') {
+                conditions.push(`sprint in openSprints()`);
+            }
+            else {
+                conditions.push(`sprint = "${filter.sprint}"`);
+            }
+        }
+        if (filter.assignee) {
+            conditions.push(`assignee = "${filter.assignee}"`);
+        }
+        if (filter.labels && filter.labels.length > 0) {
+            filter.labels.forEach(label => {
+                conditions.push(`labels = "${label}"`);
+            });
+        }
+        if (conditions.length === 0) {
+            // Default: return recent issues
+            return 'ORDER BY updated DESC';
+        }
+        const whereClause = conditions.join(' AND ');
+        return `${whereClause} ORDER BY updated DESC`;
+    }
+    /**
+     * Create a new issue
+     */
+    async createIssue(issue, projectKey) {
+        console.log(`🔨 Creating ${issue.issueType}: ${issue.summary}`);
+        const url = `${this.baseUrl}/rest/api/${this.apiVersion}/issue`;
+        // Build issue payload
+        const payload = {
+            fields: {
+                project: {
+                    key: projectKey
+                },
+                summary: issue.summary,
+                issuetype: {
+                    name: issue.issueType
+                }
+            }
+        };
+        // Add description (Jira uses Atlassian Document Format - ADF)
+        if (issue.description) {
+            payload.fields.description = {
+                type: 'doc',
+                version: 1,
+                content: [
+                    {
+                        type: 'paragraph',
+                        content: [
+                            {
+                                type: 'text',
+                                text: issue.description
+                            }
+                        ]
+                    }
+                ]
+            };
+        }
+        // Add priority (skip if not available in project)
+        if (issue.priority) {
+            try {
+                payload.fields.priority = {
+                    name: issue.priority
+                };
+            }
+            catch (error) {
+                // Priority field might not be available in this project
+                console.warn('⚠️  Priority field not available, skipping');
+            }
+        }
+        // Add labels
+        if (issue.labels && issue.labels.length > 0) {
+            payload.fields.labels = issue.labels;
+        }
+        // Link to parent (for Sub-tasks)
+        if (issue.parentKey) {
+            payload.fields.parent = {
+                key: issue.parentKey
+            };
+        }
+        // Link to Epic (for Stories)
+        // Note: Epic Link field varies by Jira instance, typically customfield_10014
+        if (issue.epicKey) {
+            payload.fields.customfield_10014 = issue.epicKey;
+        }
+        // Add custom fields
+        if (issue.customFields) {
+            Object.entries(issue.customFields).forEach(([key, value]) => {
+                payload.fields[key] = value;
+            });
+        }
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Authorization': this.getAuthHeader(),
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(payload)
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Jira API Error (${response.status}): ${error}`);
+        }
+        const result = await response.json();
+        console.log(`✅ Created ${issue.issueType} ${result.key}: ${issue.summary}`);
+        // Fetch full issue details
+        return this.getIssue(result.key);
+    }
+    /**
+     * Update an existing issue
+     */
+    async updateIssue(update) {
+        console.log(`🔧 Updating issue ${update.key}`);
+        const url = `${this.baseUrl}/rest/api/${this.apiVersion}/issue/${update.key}`;
+        // Build update payload
+        const payload = {
+            fields: {}
+        };
+        if (update.summary) {
+            payload.fields.summary = update.summary;
+        }
+        if (update.description !== undefined) {
+            payload.fields.description = {
+                type: 'doc',
+                version: 1,
+                content: [
+                    {
+                        type: 'paragraph',
+                        content: [
+                            {
+                                type: 'text',
+                                text: update.description
+                            }
+                        ]
+                    }
+                ]
+            };
+        }
+        if (update.priority) {
+            payload.fields.priority = {
+                name: update.priority
+            };
+        }
+        if (update.labels) {
+            payload.fields.labels = update.labels;
+        }
+        // Add custom fields
+        if (update.customFields) {
+            Object.entries(update.customFields).forEach(([key, value]) => {
+                payload.fields[key] = value;
+            });
+        }
+        const response = await fetch(url, {
+            method: 'PUT',
+            headers: {
+                'Authorization': this.getAuthHeader(),
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(payload)
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Jira API Error (${response.status}): ${error}`);
+        }
+        console.log(`✅ Updated issue ${update.key}`);
+        // Transition status if specified
+        if (update.status) {
+            await this.transitionIssue(update.key, update.status);
+        }
+        // Fetch updated issue
+        return this.getIssue(update.key);
+    }
+    /**
+     * Transition issue to a new status
+     */
+    async transitionIssue(issueKey, targetStatus) {
+        console.log(`🔀 Transitioning ${issueKey} to ${targetStatus}`);
+        // Get available transitions
+        const transitionsUrl = `${this.baseUrl}/rest/api/${this.apiVersion}/issue/${issueKey}/transitions`;
+        const transitionsResponse = await fetch(transitionsUrl, {
+            headers: {
+                'Authorization': this.getAuthHeader(),
+                'Content-Type': 'application/json'
+            }
+        });
+        if (!transitionsResponse.ok) {
+            throw new Error(`Failed to get transitions for ${issueKey}`);
+        }
+        const transitionsData = await transitionsResponse.json();
+        const transition = transitionsData.transitions.find((t) => t.to.name.toLowerCase() === targetStatus.toLowerCase());
+        if (!transition) {
+            console.warn(`⚠️  No transition found to status "${targetStatus}" for ${issueKey}`);
+            return;
+        }
+        // Execute transition
+        const response = await fetch(transitionsUrl, {
+            method: 'POST',
+            headers: {
+                'Authorization': this.getAuthHeader(),
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({
+                transition: {
+                    id: transition.id
+                }
+            })
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Failed to transition ${issueKey}: ${error}`);
+        }
+        console.log(`✅ Transitioned ${issueKey} to ${targetStatus}`);
+    }
+    /**
+     * Get issue by key
+     */
+    async getIssue(issueKey) {
+        const url = `${this.baseUrl}/rest/api/${this.apiVersion}/issue/${issueKey}`;
+        const response = await fetch(url, {
+            headers: {
+                'Authorization': this.getAuthHeader(),
+                'Content-Type': 'application/json'
+            }
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Jira API Error (${response.status}): ${error}`);
+        }
+        return response.json();
+    }
+    /**
+     * Get sprints for a board
+     */
+    async getSprints(boardId) {
+        const url = `${this.baseUrl}/rest/agile/1.0/board/${boardId}/sprint`;
+        const response = await fetch(url, {
+            headers: {
+                'Authorization': this.getAuthHeader(),
+                'Content-Type': 'application/json'
+            }
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Jira API Error (${response.status}): ${error}`);
+        }
+        const data = await response.json();
+        return data.values || [];
+    }
+    /**
+     * Get active sprints
+     */
+    async getActiveSprints(boardId) {
+        const sprints = await this.getSprints(boardId);
+        return sprints.filter(s => s.state === 'active');
+    }
+    /**
+     * Test connection to Jira
+     */
+    async testConnection() {
+        try {
+            const url = `${this.baseUrl}/rest/api/${this.apiVersion}/myself`;
+            const response = await fetch(url, {
+                headers: {
+                    'Authorization': this.getAuthHeader(),
+                    'Content-Type': 'application/json'
+                }
+            });
+            if (response.ok) {
+                const user = await response.json();
+                console.log(`✅ Jira connection successful (${user.displayName})`);
+                return true;
+            }
+            else {
+                const error = await response.text();
+                console.error(`❌ Jira connection failed (${response.status}): ${error}`);
+                return false;
+            }
+        }
+        catch (error) {
+            console.error('❌ Jira connection failed:', error);
+            return false;
+        }
+    }
+    /**
+     * Get projects accessible to the user
+     */
+    async getProjects() {
+        const url = `${this.baseUrl}/rest/api/${this.apiVersion}/project`;
+        const response = await fetch(url, {
+            headers: {
+                'Authorization': this.getAuthHeader(),
+                'Content-Type': 'application/json'
+            }
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Jira API Error (${response.status}): ${error}`);
+        }
+        return response.json();
+    }
+}
+//# sourceMappingURL=jira-client.js.map

package/dist/src/integrations/jira/jira-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-client.js","sourceRoot":"","sources":["../../../../src/integrations/jira/jira-client.ts"],"names":[],"mappings":"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"}

package/dist/src/integrations/jira/jira-incremental-mapper.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Jira Incremental Mapper - Granular Work Item Management
+ *
+ * Supports adding individual Jira items (Story, Bug, Task) to increments:
+ * - Add single story/bug/task to existing increment
+ * - Create increment from cherry-picked items across multiple Epics
+ * - Handle different work item types appropriately
+ * - Update RFC documentation when items are added
+ */
+import { JiraClient } from './jira-client.js';
+export interface WorkItem {
+    type: 'story' | 'bug' | 'task' | 'epic';
+    id: string;
+    jira_key: string;
+    jira_id: string;
+    title: string;
+    description: string;
+    status: 'planned' | 'in-progress' | 'completed';
+    priority: 'P1' | 'P2' | 'P3';
+    assignee?: string;
+    labels?: string[];
+    parent_epic?: {
+        key: string;
+        title: string;
+    };
+}
+export interface IncrementWorkItems {
+    stories: WorkItem[];
+    bugs: WorkItem[];
+    tasks: WorkItem[];
+}
+export declare class JiraIncrementalMapper {
+    private client;
+    private projectRoot;
+    private rfcGenerator;
+    constructor(client: JiraClient, projectRoot?: string);
+    /**
+     * Add a specific Jira item (Story, Bug, Task) to an existing increment
+     */
+    addItemToIncrement(incrementId: string, jiraKey: string): Promise<{
+        success: boolean;
+        message: string;
+        workItem?: WorkItem;
+    }>;
+    /**
+     * Create new increment from multiple Jira items (cherry-picked)
+     */
+    createIncrementFromItems(title: string, jiraKeys: string[]): Promise<{
+        success: boolean;
+        incrementId: string;
+        message: string;
+    }>;
+    /**
+     * List all work items in an increment grouped by type
+     */
+    getIncrementWorkItems(incrementId: string): IncrementWorkItems;
+    private mapJiraTypeToWorkItemType;
+    private createWorkItemFromIssue;
+    private addWorkItemToSpec;
+    private addWorkItemToTasks;
+    private updateRFCWithWorkItem;
+    private generateSpecFromWorkItems;
+    private generateTasksFromWorkItems;
+    private generateRFCFromWorkItems;
+    private getNextIncrementId;
+    private ensureDir;
+    private parseMarkdownWithFrontmatter;
+    private serializeMarkdownWithFrontmatter;
+    private extractTextFromJiraDescription;
+    private mapJiraStatusToSpecWeave;
+    private mapJiraPriorityToSpecWeave;
+    private slugify;
+    private generateContextManifest;
+}
+//# sourceMappingURL=jira-incremental-mapper.d.ts.map

package/dist/src/integrations/jira/jira-incremental-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-incremental-mapper.d.ts","sourceRoot":"","sources":["../../../../src/integrations/jira/jira-incremental-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAa,MAAM,kBAAkB,CAAC;AAMzD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;IAChD,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAuB;gBAE/B,MAAM,EAAE,UAAU,EAAE,WAAW,GAAE,MAAsB;IAMnE;;OAEG;IACU,kBAAkB,CAC7B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE,CAAC;IA6DtE;;OAEG;IACU,wBAAwB,CACnC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAwEtE;;OAEG;IACI,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB;IA+BrE,OAAO,CAAC,yBAAyB;IASjC,OAAO,CAAC,uBAAuB;IA2C/B,OAAO,CAAC,iBAAiB;YAyCX,kBAAkB;YAmBlB,qBAAqB;YAoBrB,yBAAyB;YA4DzB,0BAA0B;YAkB1B,wBAAwB;IA6EtC,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,4BAA4B;IAUpC,OAAO,CAAC,gCAAgC;IAKxC,OAAO,CAAC,8BAA8B;IActC,OAAO,CAAC,wBAAwB;IAQhC,OAAO,CAAC,0BAA0B;IAQlC,OAAO,CAAC,OAAO;YAID,uBAAuB;CAetC"}