specweave 0.17.1 → 0.17.3

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

@@ -1,282 +1,260 @@
-/**
- * JIRA Spec Commit Sync
- *
- * Posts commit/PR comments to JIRA issues linked to living docs specs.
- * This enables traceability from spec user stories to actual code changes.
- */
-import axios from 'axios';
-import { getRecentCommits, detectRepository, getCommitUrl, findPRForCommit, getLastSyncCommit, updateLastSyncCommit, } from '../../../src/utils/git-utils.js';
-import { getSpecTaskMapping, getCompletedUserStories, } from '../../../src/core/spec-task-mapper.js';
-import { buildUserStoryComment, buildCommitBatchComment, buildShortComment, generateSmartSummary, formatForJira, } from '../../../src/core/comment-builder.js';
-import path from 'path';
-import fs from 'fs/promises';
-/**
- * Sync commits for completed user stories to JIRA epic/story
- */
-export async function syncSpecCommitsToJira(config, options) {
-    const { incrementPath, dryRun = false, verbose = false } = options;
-    const result = {
-        success: true,
-        commentsPosted: 0,
-        errors: [],
-        commits: [],
-        userStories: [],
-    };
+import axios from "axios";
+import {
+  getRecentCommits,
+  detectRepository,
+  getCommitUrl,
+  findPRForCommit,
+  getLastSyncCommit,
+  updateLastSyncCommit
+} from "../../../src/utils/git-utils.js";
+import {
+  getSpecTaskMapping,
+  getCompletedUserStories
+} from "../../../src/core/spec-task-mapper.js";
+import {
+  buildUserStoryComment,
+  buildCommitBatchComment,
+  buildShortComment,
+  generateSmartSummary,
+  formatForJira
+} from "../../../src/core/comment-builder.js";
+import path from "path";
+import fs from "fs/promises";
+async function syncSpecCommitsToJira(config, options) {
+  const { incrementPath, dryRun = false, verbose = false } = options;
+  const result = {
+    success: true,
+    commentsPosted: 0,
+    errors: [],
+    commits: [],
+    userStories: []
+  };
+  try {
+    const metadataPath = path.join(incrementPath, "metadata.json");
+    let metadata;
     try {
-        // 1. Check if increment has JIRA issue linked
-        const metadataPath = path.join(incrementPath, 'metadata.json');
-        let metadata;
-        try {
-            metadata = JSON.parse(await fs.readFile(metadataPath, 'utf-8'));
-        }
-        catch {
-            result.errors.push('No metadata.json found');
-            return result;
-        }
-        const jiraIssueKey = metadata.jira?.issueKey;
-        if (!jiraIssueKey) {
-            if (verbose) {
-                console.log('No JIRA issue linked to increment');
-            }
-            return result;
-        }
-        // 2. Create JIRA client
-        const 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',
-            },
-        });
-        // 3. Detect repository
-        const repo = await detectRepository('origin', incrementPath);
-        if (!repo) {
-            result.errors.push('Git repository not found');
-            result.success = false;
-            return result;
-        }
-        // 4. Get spec-task mapping
-        const mapping = await getSpecTaskMapping(incrementPath);
-        if (!mapping) {
-            if (verbose) {
-                console.log('No spec mapping found for increment');
-            }
-            return result;
-        }
-        // 5. Get completed user stories
-        const completedUserStories = getCompletedUserStories(mapping);
-        if (completedUserStories.length === 0) {
-            if (verbose) {
-                console.log('No completed user stories');
-            }
-            return result;
-        }
-        result.userStories = completedUserStories;
-        // 6. Get recent commits (since last sync)
-        const lastSyncCommit = await getLastSyncCommit(metadataPath);
-        const commits = lastSyncCommit
-            ? await getRecentCommits(undefined, lastSyncCommit, incrementPath)
-            : await getRecentCommits('7.days', undefined, incrementPath);
-        if (commits.length === 0) {
-            if (verbose) {
-                console.log('No new commits since last sync');
+      metadata = JSON.parse(await fs.readFile(metadataPath, "utf-8"));
+    } catch {
+      result.errors.push("No metadata.json found");
+      return result;
+    }
+    const jiraIssueKey = metadata.jira?.issueKey;
+    if (!jiraIssueKey) {
+      if (verbose) {
+        console.log("No JIRA issue linked to increment");
+      }
+      return result;
+    }
+    const 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"
+      }
+    });
+    const repo = await detectRepository("origin", incrementPath);
+    if (!repo) {
+      result.errors.push("Git repository not found");
+      result.success = false;
+      return result;
+    }
+    const mapping = await getSpecTaskMapping(incrementPath);
+    if (!mapping) {
+      if (verbose) {
+        console.log("No spec mapping found for increment");
+      }
+      return result;
+    }
+    const completedUserStories = getCompletedUserStories(mapping);
+    if (completedUserStories.length === 0) {
+      if (verbose) {
+        console.log("No completed user stories");
+      }
+      return result;
+    }
+    result.userStories = completedUserStories;
+    const lastSyncCommit = await getLastSyncCommit(metadataPath);
+    const commits = lastSyncCommit ? await getRecentCommits(void 0, lastSyncCommit, incrementPath) : await getRecentCommits("7.days", void 0, incrementPath);
+    if (commits.length === 0) {
+      if (verbose) {
+        console.log("No new commits since last sync");
+      }
+      return result;
+    }
+    result.commits = commits;
+    for (const commit of commits) {
+      commit.url = getCommitUrl(commit, repo);
+    }
+    for (const userStory of completedUserStories) {
+      try {
+        const relatedTasks = mapping.tasks.filter(
+          (t) => t.userStories.includes(userStory.id)
+        );
+        const pullRequests = [];
+        if (repo.provider === "github") {
+          for (const commit of commits.slice(0, 3)) {
+            const pr = await findPRForCommit(commit.sha, repo.owner, repo.repo);
+            if (pr && !pullRequests.find((p) => p.number === pr.number)) {
+              pullRequests.push(pr);
             }
-            return result;
+          }
         }
-        result.commits = commits;
-        // Add commit URLs
-        for (const commit of commits) {
-            commit.url = getCommitUrl(commit, repo);
+        const summary = generateSmartSummary(commits, relatedTasks);
+        const commentContent = {
+          userStory,
+          tasks: relatedTasks,
+          commits,
+          pullRequests,
+          summary
+        };
+        const formattedComment = buildUserStoryComment(commentContent, repo);
+        const jiraComment = formatForJira(formattedComment);
+        if (verbose) {
+          console.log(`
+Comment for ${userStory.id} (JIRA format):`);
+          console.log(jiraComment);
+          console.log("\n---\n");
         }
-        // 7. Post comments for each completed user story
-        for (const userStory of completedUserStories) {
-            try {
-                // Get tasks for this user story
-                const relatedTasks = mapping.tasks.filter(t => t.userStories.includes(userStory.id));
-                // Find PRs for commits (optional, best effort)
-                const pullRequests = [];
-                if (repo.provider === 'github') {
-                    for (const commit of commits.slice(0, 3)) {
-                        const pr = await findPRForCommit(commit.sha, repo.owner, repo.repo);
-                        if (pr && !pullRequests.find(p => p.number === pr.number)) {
-                            pullRequests.push(pr);
-                        }
+        if (!dryRun) {
+          await client.post(`/issue/${jiraIssueKey}/comment`, {
+            body: {
+              type: "doc",
+              version: 1,
+              content: [
+                {
+                  type: "paragraph",
+                  content: [
+                    {
+                      type: "text",
+                      text: jiraComment
                     }
+                  ]
                 }
-                // Build comment
-                const summary = generateSmartSummary(commits, relatedTasks);
-                const commentContent = {
-                    userStory,
-                    tasks: relatedTasks,
-                    commits,
-                    pullRequests,
-                    summary,
-                };
-                const formattedComment = buildUserStoryComment(commentContent, repo);
-                const jiraComment = formatForJira(formattedComment);
-                if (verbose) {
-                    console.log(`\nComment for ${userStory.id} (JIRA format):`);
-                    console.log(jiraComment);
-                    console.log('\n---\n');
-                }
-                // Post comment to JIRA
-                if (!dryRun) {
-                    await client.post(`/issue/${jiraIssueKey}/comment`, {
-                        body: {
-                            type: 'doc',
-                            version: 1,
-                            content: [
-                                {
-                                    type: 'paragraph',
-                                    content: [
-                                        {
-                                            type: 'text',
-                                            text: jiraComment,
-                                        },
-                                    ],
-                                },
-                            ],
-                        },
-                    });
-                    result.commentsPosted++;
-                }
-                else {
-                    result.commentsPosted++;
-                }
-            }
-            catch (error) {
-                result.errors.push(`Failed to post comment for ${userStory.id}: ${error.message}`);
+              ]
             }
+          });
+          result.commentsPosted++;
+        } else {
+          result.commentsPosted++;
         }
-        // 8. If no user stories completed but there are commits, post a simple update
-        if (completedUserStories.length === 0 && commits.length > 0) {
-            try {
-                const summary = `Work in progress: ${commits.length} commit${commits.length > 1 ? 's' : ''}`;
-                const formattedComment = buildShortComment(commits, repo, summary);
-                const jiraComment = formatForJira(formattedComment);
-                if (verbose) {
-                    console.log(`\nShort update comment (JIRA format):`);
-                    console.log(jiraComment);
-                    console.log('\n---\n');
-                }
-                if (!dryRun) {
-                    await client.post(`/issue/${jiraIssueKey}/comment`, {
-                        body: {
-                            type: 'doc',
-                            version: 1,
-                            content: [
-                                {
-                                    type: 'paragraph',
-                                    content: [
-                                        {
-                                            type: 'text',
-                                            text: jiraComment,
-                                        },
-                                    ],
-                                },
-                            ],
-                        },
-                    });
-                    result.commentsPosted++;
-                }
-                else {
-                    result.commentsPosted++;
-                }
-            }
-            catch (error) {
-                result.errors.push(`Failed to post short update: ${error.message}`);
-            }
-        }
-        // 9. Update last sync commit
-        if (!dryRun && commits.length > 0) {
-            await updateLastSyncCommit(metadataPath, commits[0].sha);
-        }
+      } catch (error) {
+        result.errors.push(`Failed to post comment for ${userStory.id}: ${error.message}`);
+      }
     }
-    catch (error) {
-        result.success = false;
-        result.errors.push(error.message);
-    }
-    return result;
-}
-/**
- * Post batch commit update to JIRA issue
- */
-export async function postCommitBatchUpdate(config, incrementPath, commits, issueKey, repo, dryRun = false) {
-    try {
-        const 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',
-            },
-        });
-        // Add commit URLs
-        for (const commit of commits) {
-            commit.url = getCommitUrl(commit, repo);
-        }
-        // Build and post comment
-        const formattedComment = buildCommitBatchComment(commits, repo, true);
+    if (completedUserStories.length === 0 && commits.length > 0) {
+      try {
+        const summary = `Work in progress: ${commits.length} commit${commits.length > 1 ? "s" : ""}`;
+        const formattedComment = buildShortComment(commits, repo, summary);
         const jiraComment = formatForJira(formattedComment);
+        if (verbose) {
+          console.log(`
+Short update comment (JIRA format):`);
+          console.log(jiraComment);
+          console.log("\n---\n");
+        }
         if (!dryRun) {
-            await client.post(`/issue/${issueKey}/comment`, {
-                body: {
-                    type: 'doc',
-                    version: 1,
-                    content: [
-                        {
-                            type: 'paragraph',
-                            content: [
-                                {
-                                    type: 'text',
-                                    text: jiraComment,
-                                },
-                            ],
-                        },
-                    ],
-                },
-            });
+          await client.post(`/issue/${jiraIssueKey}/comment`, {
+            body: {
+              type: "doc",
+              version: 1,
+              content: [
+                {
+                  type: "paragraph",
+                  content: [
+                    {
+                      type: "text",
+                      text: jiraComment
+                    }
+                  ]
+                }
+              ]
+            }
+          });
+          result.commentsPosted++;
+        } else {
+          result.commentsPosted++;
         }
-        return true;
+      } catch (error) {
+        result.errors.push(`Failed to post short update: ${error.message}`);
+      }
     }
-    catch (error) {
-        console.error(`Failed to post batch update: ${error.message}`);
-        return false;
+    if (!dryRun && commits.length > 0) {
+      await updateLastSyncCommit(metadataPath, commits[0].sha);
     }
+  } catch (error) {
+    result.success = false;
+    result.errors.push(error.message);
+  }
+  return result;
 }
-/**
- * Check if spec commit sync is enabled in config
- */
-export async function isSpecCommitSyncEnabled(projectRoot) {
-    try {
-        const configPath = path.join(projectRoot, '.specweave', 'config.json');
-        const config = JSON.parse(await fs.readFile(configPath, 'utf-8'));
-        return config.sync?.settings?.postCommitComments !== false;
+async function postCommitBatchUpdate(config, incrementPath, commits, issueKey, repo, dryRun = false) {
+  try {
+    const 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"
+      }
+    });
+    for (const commit of commits) {
+      commit.url = getCommitUrl(commit, repo);
     }
-    catch {
-        return true; // Default: enabled
+    const formattedComment = buildCommitBatchComment(commits, repo, true);
+    const jiraComment = formatForJira(formattedComment);
+    if (!dryRun) {
+      await client.post(`/issue/${issueKey}/comment`, {
+        body: {
+          type: "doc",
+          version: 1,
+          content: [
+            {
+              type: "paragraph",
+              content: [
+                {
+                  type: "text",
+                  text: jiraComment
+                }
+              ]
+            }
+          ]
+        }
+      });
     }
+    return true;
+  } catch (error) {
+    console.error(`Failed to post batch update: ${error.message}`);
+    return false;
+  }
 }
-/**
- * Get JIRA issue key from spec metadata
- */
-export async function getJiraIssueForSpec(specPath) {
-    try {
-        const content = await fs.readFile(specPath, 'utf-8');
-        // Extract JIRA issue from frontmatter or body
-        // Pattern: **JIRA Epic**: PROJ-123
-        const match = content.match(/\*\*JIRA Epic\*\*:\s*([A-Z]+-\d+)/);
-        return match ? match[1] : null;
-    }
-    catch {
-        return null;
-    }
+async function isSpecCommitSyncEnabled(projectRoot) {
+  try {
+    const configPath = path.join(projectRoot, ".specweave", "config.json");
+    const config = JSON.parse(await fs.readFile(configPath, "utf-8"));
+    return config.sync?.settings?.postCommitComments !== false;
+  } catch {
+    return true;
+  }
+}
+async function getJiraIssueForSpec(specPath) {
+  try {
+    const content = await fs.readFile(specPath, "utf-8");
+    const match = content.match(/\*\*JIRA Epic\*\*:\s*([A-Z]+-\d+)/);
+    return match ? match[1] : null;
+  } catch {
+    return null;
+  }
 }
-//# sourceMappingURL=jira-spec-commit-sync.js.map
+export {
+  getJiraIssueForSpec,
+  isSpecCommitSyncEnabled,
+  postCommitBatchUpdate,
+  syncSpecCommitsToJira
+};