specweave 0.28.19 → 0.28.22

package/plugins/specweave-github/lib/github-status-sync.js

@@ -26,6 +26,9 @@ class GitHubStatusSync {
   /**
    * Update GitHub issue status
    *
+   * Preserves existing labels that are not status-related.
+   * Only replaces labels that start with "status:" prefix.
+   *
    * @param issueNumber - GitHub issue number
    * @param status - New status (state and labels)
    */
@@ -37,10 +40,43 @@ class GitHubStatusSync {
       state: status.state
     };
     if (status.labels && status.labels.length > 0) {
-      updateData.labels = status.labels;
+      const currentLabels = await this.getCurrentLabels(issueNumber);
+      const preservedLabels = currentLabels.filter(
+        (label) => !label.startsWith("status:")
+      );
+      const newStatusLabels = status.labels.filter(
+        (label) => label.startsWith("status:")
+      );
+      const newOtherLabels = status.labels.filter(
+        (label) => !label.startsWith("status:")
+      );
+      const mergedLabels = [.../* @__PURE__ */ new Set([
+        ...preservedLabels,
+        ...newStatusLabels,
+        ...newOtherLabels
+      ])];
+      updateData.labels = mergedLabels;
     }
     await this.octokit.rest.issues.update(updateData);
   }
+  /**
+   * Get current labels from GitHub issue
+   *
+   * @param issueNumber - GitHub issue number
+   * @returns Array of current label names
+   */
+  async getCurrentLabels(issueNumber) {
+    try {
+      const response = await this.octokit.rest.issues.get({
+        owner: this.owner,
+        repo: this.repo,
+        issue_number: issueNumber
+      });
+      return response.data.labels.map((label) => typeof label === "string" ? label : label.name).filter(Boolean);
+    } catch {
+      return [];
+    }
+  }
   /**
    * Post status change comment to GitHub issue
    *

package/plugins/specweave-github/lib/github-status-sync.ts

@@ -53,6 +53,9 @@ export class GitHubStatusSync {
   /**
    * Update GitHub issue status
    *
+   * Preserves existing labels that are not status-related.
+   * Only replaces labels that start with "status:" prefix.
+   *
    * @param issueNumber - GitHub issue number
    * @param status - New status (state and labels)
    */
@@ -60,21 +63,74 @@ export class GitHubStatusSync {
     issueNumber: number,
     status: ExternalStatus
   ): Promise<void> {
-    const updateData: any = {
+    const updateData: {
+      owner: string;
+      repo: string;
+      issue_number: number;
+      state: 'open' | 'closed';
+      labels?: string[];
+    } = {
       owner: this.owner,
       repo: this.repo,
       issue_number: issueNumber,
-      state: status.state
+      state: status.state as 'open' | 'closed'
     };
 
-    // Add labels if provided
+    // Merge labels - preserve non-status labels, replace status labels
     if (status.labels && status.labels.length > 0) {
-      updateData.labels = status.labels;
+      // Fetch current labels to preserve non-status ones
+      const currentLabels = await this.getCurrentLabels(issueNumber);
+
+      // Filter out status-related labels (start with "status:")
+      const preservedLabels = currentLabels.filter(
+        label => !label.startsWith('status:')
+      );
+
+      // Get new status labels from the provided status
+      const newStatusLabels = status.labels.filter(
+        label => label.startsWith('status:')
+      );
+
+      // Get non-status labels from the provided status (e.g., priority, type)
+      const newOtherLabels = status.labels.filter(
+        label => !label.startsWith('status:')
+      );
+
+      // Combine: preserved non-status + new status + new other labels
+      const mergedLabels = [...new Set([
+        ...preservedLabels,
+        ...newStatusLabels,
+        ...newOtherLabels
+      ])];
+
+      updateData.labels = mergedLabels;
     }
 
     await this.octokit.rest.issues.update(updateData);
   }
 
+  /**
+   * Get current labels from GitHub issue
+   *
+   * @param issueNumber - GitHub issue number
+   * @returns Array of current label names
+   */
+  private async getCurrentLabels(issueNumber: number): Promise<string[]> {
+    try {
+      const response = await this.octokit.rest.issues.get({
+        owner: this.owner,
+        repo: this.repo,
+        issue_number: issueNumber
+      });
+
+      return response.data.labels
+        .map((label: any) => (typeof label === 'string' ? label : label.name))
+        .filter(Boolean) as string[];
+    } catch {
+      return [];
+    }
+  }
+
   /**
    * Post status change comment to GitHub issue
    *

package/plugins/specweave-github/lib/increment-issue-builder.js

@@ -207,6 +207,24 @@ class IncrementIssueBuilder {
     body += `---
 
 `;
+    const storyTasks = incrementData.tasks.filter(
+      (t) => t.userStories.includes(story.id) || t.userStories.some((us) => us.toUpperCase() === story.id.toUpperCase())
+    );
+    if (storyTasks.length > 0) {
+      body += `## Tasks
+
+`;
+      const completedTasks = storyTasks.filter((t) => t.completed).length;
+      body += `Progress: ${completedTasks}/${storyTasks.length} tasks
+
+`;
+      for (const task of storyTasks) {
+        const checkbox = task.completed ? "[x]" : "[ ]";
+        body += `- ${checkbox} **${task.id}**: ${task.title}
+`;
+      }
+      body += "\n---\n\n";
+    }
     body += `## Implementation
 
 `;
@@ -225,8 +243,10 @@ class IncrementIssueBuilder {
     body += `\u{1F916} Auto-synced by SpecWeave Increment Sync`;
     const labels = ["specweave", "user-story"];
     if (incrementData.frontmatter.type) {
-      labels.push(incrementData.frontmatter.type);
+      labels.push(incrementData.frontmatter.type.toLowerCase());
     }
+    const priority = story.priority?.toLowerCase() || incrementData.frontmatter.priority?.toLowerCase() || "p2";
+    labels.push(priority);
     return { title, body, labels };
   }
   /**
@@ -338,10 +358,11 @@ class IncrementIssueBuilder {
 
 `;
     body += `\u{1F916} Auto-synced by SpecWeave Increment Sync`;
-    const labels = ["specweave", "increment", "enhancement"];
-    if (incrementData.frontmatter.type) {
-      labels.push(incrementData.frontmatter.type);
-    }
+    const labels = ["specweave", "increment"];
+    const typeLabel = incrementData.frontmatter.type?.toLowerCase() || "enhancement";
+    labels.push(typeLabel);
+    const priority = incrementData.frontmatter.priority?.toLowerCase() || "p2";
+    labels.push(priority);
     return { title, body, labels };
   }
   /**

package/plugins/specweave-github/lib/increment-issue-builder.ts

@@ -22,6 +22,7 @@ export interface IncrementFrontmatter {
   type?: string;
   status?: string;
   created?: string;
+  priority?: string;
 }
 
 export interface AcceptanceCriterion {
@@ -37,6 +38,7 @@ export interface UserStory {
   iWant: string;
   soThat: string;
   acceptanceCriteria: AcceptanceCriterion[];
+  priority?: string;
 }
 
 export interface Task {
@@ -322,6 +324,24 @@ export class IncrementIssueBuilder {
 
     body += `---\n\n`;
 
+    // Tasks for this user story
+    const storyTasks = incrementData.tasks.filter(t =>
+      t.userStories.includes(story.id) ||
+      t.userStories.some(us => us.toUpperCase() === story.id.toUpperCase())
+    );
+
+    if (storyTasks.length > 0) {
+      body += `## Tasks\n\n`;
+      const completedTasks = storyTasks.filter(t => t.completed).length;
+      body += `Progress: ${completedTasks}/${storyTasks.length} tasks\n\n`;
+
+      for (const task of storyTasks) {
+        const checkbox = task.completed ? '[x]' : '[ ]';
+        body += `- ${checkbox} **${task.id}**: ${task.title}\n`;
+      }
+      body += '\n---\n\n';
+    }
+
     // Link to increment
     body += `## Implementation\n\n`;
     if (githubRepo) {
@@ -335,10 +355,16 @@ export class IncrementIssueBuilder {
 
     // Labels
     const labels = ['specweave', 'user-story'];
+
+    // Add type label if available
     if (incrementData.frontmatter.type) {
-      labels.push(incrementData.frontmatter.type);
+      labels.push(incrementData.frontmatter.type.toLowerCase());
     }
 
+    // Add priority label (from story or default to p2)
+    const priority = story.priority?.toLowerCase() || incrementData.frontmatter.priority?.toLowerCase() || 'p2';
+    labels.push(priority);
+
     return { title, body, labels };
   }
 
@@ -438,10 +464,15 @@ export class IncrementIssueBuilder {
     body += `🤖 Auto-synced by SpecWeave Increment Sync`;
 
     // Labels
-    const labels = ['specweave', 'increment', 'enhancement'];
-    if (incrementData.frontmatter.type) {
-      labels.push(incrementData.frontmatter.type);
-    }
+    const labels = ['specweave', 'increment'];
+
+    // Add type label (default to 'enhancement' if not specified)
+    const typeLabel = incrementData.frontmatter.type?.toLowerCase() || 'enhancement';
+    labels.push(typeLabel);
+
+    // Add priority label (default to 'p2' if not specified)
+    const priority = incrementData.frontmatter.priority?.toLowerCase() || 'p2';
+    labels.push(priority);
 
     return { title, body, labels };
   }

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

@@ -132,6 +132,7 @@ class JiraSpecSync {
   async createJiraEpic(spec) {
     const epicSummary = `[${spec.metadata.id.toUpperCase()}] ${spec.metadata.title}`;
     const epicDescription = this.generateEpicDescription(spec);
+    const issueType = this.mapTypeToJira(spec.metadata.type, "Epic");
     const payload = {
       fields: {
         project: {
@@ -140,9 +141,13 @@ class JiraSpecSync {
         summary: epicSummary,
         description: epicDescription,
         issuetype: {
-          name: "Epic"
+          name: issueType
         },
-        labels: [`spec:${spec.metadata.id}`, `priority:${spec.metadata.priority}`]
+        labels: [`spec:${spec.metadata.id}`, `priority:${spec.metadata.priority}`],
+        // Set native JIRA priority field (P0→Highest, P1→High, P2→Medium, P3→Low)
+        priority: {
+          name: this.mapPriorityToJira(spec.metadata.priority)
+        }
       }
     };
     const response = await this.client.post("/issue", payload);
@@ -213,7 +218,8 @@ class JiraSpecSync {
           summary: storySummary,
           description: storyDescription,
           epicLink: epicKey,
-          labels: [`user-story`, `spec:${spec.metadata.id}`, `priority:${us.priority}`]
+          labels: [`user-story`, `spec:${spec.metadata.id}`, `priority:${us.priority}`],
+          priority: us.priority
         });
         created.push(us.id);
         console.log(`   \u2705 Created ${us.id} \u2192 Story ${newStory.key}`);
@@ -347,6 +353,7 @@ ${acList}
    * Create Jira Story
    */
   async createStory(story) {
+    const issueType = this.mapTypeToJira(story.type, "Story");
     const payload = {
       fields: {
         project: {
@@ -355,12 +362,16 @@ ${acList}
         summary: story.summary,
         description: story.description,
         issuetype: {
-          name: "Story"
+          name: issueType
         },
         labels: story.labels,
         // Link to epic (field name may vary by Jira configuration)
-        customfield_10014: story.epicLink
+        customfield_10014: story.epicLink,
         // Epic Link field (adjust if needed)
+        // Set native JIRA priority field
+        priority: {
+          name: this.mapPriorityToJira(story.priority)
+        }
       }
     };
     const response = await this.client.post("/issue", payload);
@@ -411,6 +422,43 @@ ${acList}
       }
     });
   }
+  /**
+   * Map SpecWeave priority to JIRA priority name
+   *
+   * JIRA standard priority names: Highest, High, Medium, Low, Lowest
+   */
+  mapPriorityToJira(priority) {
+    if (!priority) return "Medium";
+    const map = {
+      P0: "Highest",
+      P1: "High",
+      P2: "Medium",
+      P3: "Low",
+      p0: "Highest",
+      p1: "High",
+      p2: "Medium",
+      p3: "Low"
+    };
+    return map[priority] || "Medium";
+  }
+  /**
+   * Map SpecWeave type to JIRA issue type
+   *
+   * Supports: Epic, Story, Bug, Task
+   */
+  mapTypeToJira(type, defaultType = "Story") {
+    if (!type) return defaultType;
+    const normalizedType = type.toLowerCase();
+    const map = {
+      bug: "Bug",
+      feature: "Epic",
+      epic: "Epic",
+      story: "Story",
+      task: "Task",
+      enhancement: "Story"
+    };
+    return map[normalizedType] || defaultType;
+  }
 }
 export {
   JiraSpecSync

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

@@ -223,7 +223,19 @@ export class JiraSpecSync {
     const epicSummary = `[${spec.metadata.id.toUpperCase()}] ${spec.metadata.title}`;
     const epicDescription = this.generateEpicDescription(spec);
 
-    const payload = {
+    // Determine issue type based on spec type (supports Bug for bug-type specs)
+    const issueType = this.mapTypeToJira(spec.metadata.type, 'Epic');
+
+    const payload: {
+      fields: {
+        project: { key: string };
+        summary: string;
+        description: string;
+        issuetype: { name: string };
+        labels: string[];
+        priority?: { name: string };
+      };
+    } = {
       fields: {
         project: {
           key: this.config.projectKey
@@ -231,9 +243,13 @@ export class JiraSpecSync {
         summary: epicSummary,
         description: epicDescription,
         issuetype: {
-          name: 'Epic'
+          name: issueType
         },
-        labels: [`spec:${spec.metadata.id}`, `priority:${spec.metadata.priority}`]
+        labels: [`spec:${spec.metadata.id}`, `priority:${spec.metadata.priority}`],
+        // Set native JIRA priority field (P0→Highest, P1→High, P2→Medium, P3→Low)
+        priority: {
+          name: this.mapPriorityToJira(spec.metadata.priority)
+        }
       }
     };
 
@@ -329,7 +345,8 @@ export class JiraSpecSync {
           summary: storySummary,
           description: storyDescription,
           epicLink: epicKey,
-          labels: [`user-story`, `spec:${spec.metadata.id}`, `priority:${us.priority}`]
+          labels: [`user-story`, `spec:${spec.metadata.id}`, `priority:${us.priority}`],
+          priority: us.priority
         });
 
         created.push(us.id);
@@ -497,8 +514,23 @@ ${acList}
     description: string;
     epicLink: string;
     labels: string[];
+    priority?: string;
+    type?: string;
   }): Promise<JiraStory> {
-    const payload = {
+    // Determine issue type (supports Bug for bug-type stories)
+    const issueType = this.mapTypeToJira(story.type, 'Story');
+
+    const payload: {
+      fields: {
+        project: { key: string };
+        summary: string;
+        description: string;
+        issuetype: { name: string };
+        labels: string[];
+        customfield_10014: string;
+        priority?: { name: string };
+      };
+    } = {
       fields: {
         project: {
           key: this.config.projectKey
@@ -506,11 +538,15 @@ ${acList}
         summary: story.summary,
         description: story.description,
         issuetype: {
-          name: 'Story'
+          name: issueType
         },
         labels: story.labels,
         // Link to epic (field name may vary by Jira configuration)
-        customfield_10014: story.epicLink // Epic Link field (adjust if needed)
+        customfield_10014: story.epicLink, // Epic Link field (adjust if needed)
+        // Set native JIRA priority field
+        priority: {
+          name: this.mapPriorityToJira(story.priority)
+        }
       }
     };
 
@@ -579,4 +615,48 @@ ${acList}
       }
     });
   }
+
+  /**
+   * Map SpecWeave priority to JIRA priority name
+   *
+   * JIRA standard priority names: Highest, High, Medium, Low, Lowest
+   */
+  private mapPriorityToJira(priority?: string): string {
+    if (!priority) return 'Medium';
+
+    const map: Record<string, string> = {
+      P0: 'Highest',
+      P1: 'High',
+      P2: 'Medium',
+      P3: 'Low',
+      p0: 'Highest',
+      p1: 'High',
+      p2: 'Medium',
+      p3: 'Low'
+    };
+
+    return map[priority] || 'Medium';
+  }
+
+  /**
+   * Map SpecWeave type to JIRA issue type
+   *
+   * Supports: Epic, Story, Bug, Task
+   */
+  private mapTypeToJira(type?: string, defaultType: string = 'Story'): string {
+    if (!type) return defaultType;
+
+    const normalizedType = type.toLowerCase();
+
+    const map: Record<string, string> = {
+      bug: 'Bug',
+      feature: 'Epic',
+      epic: 'Epic',
+      story: 'Story',
+      task: 'Task',
+      enhancement: 'Story'
+    };
+
+    return map[normalizedType] || defaultType;
+  }
 }

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

@@ -33,25 +33,31 @@ class JiraStatusSync {
    * JIRA requires using transitions to change status.
    * Cannot directly set status field.
    *
+   * Handles missing transitions gracefully by logging a warning
+   * instead of throwing an error.
+   *
    * @param issueKey - JIRA issue key (e.g., PROJ-123)
    * @param status - Desired status
+   * @returns true if transition succeeded, false if not available
    */
   async updateStatus(issueKey, status) {
     const transitionsResponse = await this.client.get(`/issue/${issueKey}/transitions`);
     const transitions = transitionsResponse.data.transitions;
     const targetTransition = transitions.find(
-      (t) => t.to.name === status.state
+      (t) => t.to.name.toLowerCase() === status.state.toLowerCase()
     );
     if (!targetTransition) {
-      throw new Error(
-        `Transition to ${status.state} not available for ${issueKey}. Available transitions: ${transitions.map((t) => t.to.name).join(", ")}`
+      console.warn(
+        `\u26A0\uFE0F  Cannot transition ${issueKey} to "${status.state}". Available transitions: ${transitions.map((t) => t.to.name).join(", ")}. This may be expected if your JIRA workflow doesn't support this status.`
       );
+      return false;
     }
     await this.client.post(`/issue/${issueKey}/transitions`, {
       transition: {
         id: targetTransition.id
       }
     });
+    return true;
   }
   /**
    * Post comment about status change to JIRA issue

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

@@ -85,24 +85,31 @@ export class JiraStatusSync {
    * JIRA requires using transitions to change status.
    * Cannot directly set status field.
    *
+   * Handles missing transitions gracefully by logging a warning
+   * instead of throwing an error.
+   *
    * @param issueKey - JIRA issue key (e.g., PROJ-123)
    * @param status - Desired status
+   * @returns true if transition succeeded, false if not available
    */
-  async updateStatus(issueKey: string, status: ExternalStatus): Promise<void> {
+  async updateStatus(issueKey: string, status: ExternalStatus): Promise<boolean> {
     // 1. Get available transitions for this issue
     const transitionsResponse = await this.client.get(`/issue/${issueKey}/transitions`);
     const transitions: JiraTransition[] = transitionsResponse.data.transitions;
 
-    // 2. Find transition that leads to desired status
+    // 2. Find transition that leads to desired status (case-insensitive)
     const targetTransition = transitions.find(
-      (t) => t.to.name === status.state
+      (t) => t.to.name.toLowerCase() === status.state.toLowerCase()
     );
 
     if (!targetTransition) {
-      throw new Error(
-        `Transition to ${status.state} not available for ${issueKey}. ` +
-        `Available transitions: ${transitions.map(t => t.to.name).join(', ')}`
+      // Log warning instead of throwing - workflow may not support this transition
+      console.warn(
+        `⚠️  Cannot transition ${issueKey} to "${status.state}". ` +
+        `Available transitions: ${transitions.map(t => t.to.name).join(', ')}. ` +
+        `This may be expected if your JIRA workflow doesn't support this status.`
       );
+      return false;
     }
 
     // 3. Execute transition
@@ -111,6 +118,8 @@ export class JiraStatusSync {
         id: targetTransition.id
       }
     });
+
+    return true;
   }
 
   /**