specweave 1.0.350 → 1.0.352

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

@@ -12,6 +12,7 @@ import * as fs from '../../../src/utils/fs-native.js';
 import * as path from 'path';
 import * as yaml from 'yaml';
 import { JiraClient, JiraIssue, JiraIssueCreate } from '../../../src/integrations/jira/jira-client.js';
+import { toDescription } from './content-format-adapter.js';
 
 interface EpicFrontmatter {
   id: string;
@@ -77,11 +78,13 @@ export class JiraEpicSync {
   private client: JiraClient;
   private specsDir: string;
   private projectKey: string;
+  private domain: string;
 
-  constructor(client: JiraClient, specsDir: string, projectKey: string) {
+  constructor(client: JiraClient, specsDir: string, projectKey: string, domain?: string) {
     this.client = client;
     this.specsDir = specsDir;
     this.projectKey = projectKey;
+    this.domain = domain || (client as any)['credentials']?.domain || '';
   }
 
   /**
@@ -193,11 +196,21 @@ export class JiraEpicSync {
    * Find Epic folder by ID (FS-001 or just 001)
    */
   private async findEpicFolder(epicId: string): Promise<string | null> {
-    const normalizedId = epicId.startsWith('FS-')
+    const folders = await fs.readdir(this.specsDir);
+
+    // Try exact match first
+    for (const folder of folders) {
+      if (folder.startsWith(epicId)) {
+        return path.join(this.specsDir, folder);
+      }
+    }
+
+    // Try with project key prefix (derived from projectKey, not hardcoded FS-)
+    const prefix = `${this.projectKey}-`;
+    const normalizedId = epicId.startsWith(prefix)
       ? epicId
-      : `FS-${epicId.padStart(3, '0')}`;
+      : `${prefix}${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);
@@ -274,7 +287,8 @@ export class JiraEpicSync {
     url: string;
   }> {
     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 rawDescription = `Epic: ${epic.title}\n\nProgress: ${epic.completed_increments}/${epic.total_increments} increments (${epic.progress})\n\nPriority: ${epic.priority}\nStatus: ${epic.status}`;
+    const description = toDescription(rawDescription, this.domain) as any;
 
     const issueData: JiraIssueCreate = {
       issueType: 'Epic',
@@ -288,7 +302,7 @@ export class JiraEpicSync {
 
     return {
       key: issue.key,
-      url: issue.self.replace('/rest/api/3/issue/', '/browse/'),
+      url: issue.self.replace(/\/rest\/api\/\d+\/issue\//, '/browse/'),
     };
   }
 
@@ -297,7 +311,8 @@ export class JiraEpicSync {
    */
   private async updateEpic(epicKey: string, epic: EpicFrontmatter): Promise<void> {
     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 rawDescription = `Epic: ${epic.title}\n\nProgress: ${epic.completed_increments}/${epic.total_increments} increments (${epic.progress})\n\nPriority: ${epic.priority}\nStatus: ${epic.status}`;
+    const description = toDescription(rawDescription, this.domain) as any;
 
     await this.client.updateIssue({
       key: epicKey,

package/plugins/specweave-jira/lib/jira-field-discovery.js

@@ -0,0 +1,76 @@
+import axios from "axios";
+import { getApiBaseUrl } from "./jira-deployment-detector.js";
+const epicLinkFieldCache = /* @__PURE__ */ new Map();
+const projectStyleCache = /* @__PURE__ */ new Map();
+async function discoverEpicLinkField(domain, auth) {
+  const cached = epicLinkFieldCache.get(domain);
+  if (cached !== void 0) return cached;
+  try {
+    const baseUrl = getApiBaseUrl(domain);
+    const response = await axios.get(`${baseUrl}/field`, {
+      auth: {
+        username: auth.email,
+        password: auth.apiToken
+      },
+      headers: { Accept: "application/json" },
+      timeout: 1e4
+    });
+    const fields = response.data;
+    const epicLinkField = fields.find(
+      (f) => f.name === "Epic Link" || f.schema?.custom === "com.pyxis.greenhopper.jira:gh-epic-link"
+    );
+    const fieldId = epicLinkField?.id || null;
+    epicLinkFieldCache.set(domain, fieldId);
+    return fieldId;
+  } catch {
+    epicLinkFieldCache.set(domain, null);
+    return null;
+  }
+}
+async function detectProjectStyle(domain, projectKey, auth) {
+  const cacheKey = `${domain}:${projectKey}`;
+  const cached = projectStyleCache.get(cacheKey);
+  if (cached) return cached;
+  try {
+    const baseUrl = getApiBaseUrl(domain);
+    const response = await axios.get(`${baseUrl}/project/${projectKey}`, {
+      auth: {
+        username: auth.email,
+        password: auth.apiToken
+      },
+      headers: { Accept: "application/json" },
+      timeout: 1e4
+    });
+    const project = response.data;
+    const isNextGen = project.style === "next-gen" || project.simplified === true;
+    const style = isNextGen ? "next-gen" : "classic";
+    projectStyleCache.set(cacheKey, style);
+    return style;
+  } catch {
+    projectStyleCache.set(cacheKey, "classic");
+    return "classic";
+  }
+}
+async function getEpicLinkFieldForProject(domain, projectKey, auth) {
+  const style = await detectProjectStyle(domain, projectKey, auth);
+  if (style === "next-gen") {
+    return { field: "parent", style };
+  }
+  const epicLinkFieldId = await discoverEpicLinkField(domain, auth);
+  if (!epicLinkFieldId) {
+    throw new Error(
+      `Could not discover Epic Link custom field for ${domain}. Ensure the JIRA instance has the Epic Link field and API credentials have field read access.`
+    );
+  }
+  return { field: epicLinkFieldId, style };
+}
+function clearFieldDiscoveryCache() {
+  epicLinkFieldCache.clear();
+  projectStyleCache.clear();
+}
+export {
+  clearFieldDiscoveryCache,
+  detectProjectStyle,
+  discoverEpicLinkField,
+  getEpicLinkFieldForProject
+};

package/plugins/specweave-jira/lib/jira-field-discovery.ts

@@ -0,0 +1,139 @@
+/**
+ * JIRA Field Discovery
+ *
+ * Dynamically discovers custom field IDs (e.g., Epic Link) and
+ * detects project style (Next-gen vs Classic).
+ *
+ * Results are cached per domain/project to avoid repeated lookups.
+ *
+ * @module jira-field-discovery
+ */
+
+import axios from 'axios';
+import { getApiBaseUrl } from './jira-deployment-detector.js';
+
+/** Cache: domain → epic link field ID */
+const epicLinkFieldCache = new Map<string, string | null>();
+
+/** Cache: projectKey → project style */
+const projectStyleCache = new Map<string, 'next-gen' | 'classic'>();
+
+/**
+ * Discover the Epic Link custom field ID by querying /rest/api/field.
+ * Searches for fields with name "Epic Link" or schema type "com.pyxis.greenhopper.jira:gh-epic-link".
+ *
+ * @returns The custom field ID (e.g., "customfield_10014") or null if not found
+ */
+export async function discoverEpicLinkField(
+  domain: string,
+  auth: { email: string; apiToken: string }
+): Promise<string | null> {
+  // Check cache
+  const cached = epicLinkFieldCache.get(domain);
+  if (cached !== undefined) return cached;
+
+  try {
+    const baseUrl = getApiBaseUrl(domain);
+    const response = await axios.get(`${baseUrl}/field`, {
+      auth: {
+        username: auth.email,
+        password: auth.apiToken,
+      },
+      headers: { Accept: 'application/json' },
+      timeout: 10000,
+    });
+
+    const fields: any[] = response.data;
+
+    // Find Epic Link field by name or schema
+    const epicLinkField = fields.find(
+      (f: any) =>
+        f.name === 'Epic Link' ||
+        f.schema?.custom === 'com.pyxis.greenhopper.jira:gh-epic-link'
+    );
+
+    const fieldId = epicLinkField?.id || null;
+    epicLinkFieldCache.set(domain, fieldId);
+    return fieldId;
+  } catch {
+    epicLinkFieldCache.set(domain, null);
+    return null;
+  }
+}
+
+/**
+ * Detect whether a JIRA project uses Next-gen (Team-managed) or Classic (Company-managed) style.
+ *
+ * Next-gen projects use `parent` field for epic linking.
+ * Classic projects use a custom field (Epic Link).
+ */
+export async function detectProjectStyle(
+  domain: string,
+  projectKey: string,
+  auth: { email: string; apiToken: string }
+): Promise<'next-gen' | 'classic'> {
+  const cacheKey = `${domain}:${projectKey}`;
+  const cached = projectStyleCache.get(cacheKey);
+  if (cached) return cached;
+
+  try {
+    const baseUrl = getApiBaseUrl(domain);
+    const response = await axios.get(`${baseUrl}/project/${projectKey}`, {
+      auth: {
+        username: auth.email,
+        password: auth.apiToken,
+      },
+      headers: { Accept: 'application/json' },
+      timeout: 10000,
+    });
+
+    const project = response.data;
+
+    // Next-gen projects have style: "next-gen" or projectTypeKey: "software" with simplified: true
+    const isNextGen =
+      project.style === 'next-gen' ||
+      project.simplified === true;
+
+    const style = isNextGen ? 'next-gen' : 'classic';
+    projectStyleCache.set(cacheKey, style);
+    return style;
+  } catch {
+    // Default to classic if detection fails
+    projectStyleCache.set(cacheKey, 'classic');
+    return 'classic';
+  }
+}
+
+/**
+ * Get the correct field name/ID for linking an issue to an epic,
+ * based on project style.
+ *
+ * - Next-gen: uses `parent` field
+ * - Classic: uses the discovered Epic Link custom field ID
+ */
+export async function getEpicLinkFieldForProject(
+  domain: string,
+  projectKey: string,
+  auth: { email: string; apiToken: string }
+): Promise<{ field: 'parent' | string; style: 'next-gen' | 'classic' }> {
+  const style = await detectProjectStyle(domain, projectKey, auth);
+
+  if (style === 'next-gen') {
+    return { field: 'parent', style };
+  }
+
+  const epicLinkFieldId = await discoverEpicLinkField(domain, auth);
+  if (!epicLinkFieldId) {
+    throw new Error(
+      `Could not discover Epic Link custom field for ${domain}. ` +
+      `Ensure the JIRA instance has the Epic Link field and API credentials have field read access.`
+    );
+  }
+  return { field: epicLinkFieldId, style };
+}
+
+/** Clear caches (for testing) */
+export function clearFieldDiscoveryCache(): void {
+  epicLinkFieldCache.clear();
+  projectStyleCache.clear();
+}

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

@@ -4,6 +4,7 @@ import {
   isCustomStrategy
 } from "../../../src/core/types/sync-profile.js";
 import { getBoardIds } from "./jira-board-resolver.js";
+import { searchAllIssues } from "./jira-paginated-search.js";
 async function buildHierarchicalJQL(client, containers) {
   const clauses = [];
   for (const container of containers) {
@@ -107,6 +108,9 @@ async function fetchIssuesSimple(client, config, timeRange) {
   let jql = `project=${projectKey}`;
   jql = addTimeRangeFilter(jql, timeRange);
   console.log("\u{1F50D} Fetching issues (SIMPLE strategy):", jql);
+  if (typeof client.getAxiosClient === "function") {
+    return searchAllIssues(client.getAxiosClient(), { jql });
+  }
   return client.searchIssues({ jql });
 }
 async function fetchIssuesCustom(client, config, timeRange) {
@@ -116,6 +120,9 @@ async function fetchIssuesCustom(client, config, timeRange) {
   }
   const jql = addTimeRangeFilter(customQuery, timeRange);
   console.log("\u{1F50D} Fetching issues (CUSTOM strategy):", jql);
+  if (typeof client.getAxiosClient === "function") {
+    return searchAllIssues(client.getAxiosClient(), { jql });
+  }
   return client.searchIssues({ jql });
 }
 async function fetchIssuesFiltered(client, config, timeRange) {
@@ -126,6 +133,9 @@ async function fetchIssuesFiltered(client, config, timeRange) {
   const baseJql = await buildHierarchicalJQL(client, containers);
   const jql = addTimeRangeFilter(baseJql, timeRange);
   console.log("\u{1F50D} Fetching issues (FILTERED strategy):", jql);
+  if (typeof client.getAxiosClient === "function") {
+    return searchAllIssues(client.getAxiosClient(), { jql });
+  }
   return client.searchIssues({ jql });
 }
 export {

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

@@ -17,6 +17,7 @@ import {
 } from '../../../src/core/types/sync-profile.js';
 import { JiraClient, JiraIssue } from '../../../src/integrations/jira/jira-client.js';
 import { getBoardIds } from './jira-board-resolver.js';
+import { searchAllIssues } from './jira-paginated-search.js';
 
 /**
  * Build hierarchical JQL query from containers
@@ -222,6 +223,10 @@ async function fetchIssuesSimple(
 
   console.log('🔍 Fetching issues (SIMPLE strategy):', jql);
 
+  // Use paginated search if client exposes axios instance, otherwise fallback
+  if (typeof (client as any).getAxiosClient === 'function') {
+    return searchAllIssues((client as any).getAxiosClient(), { jql });
+  }
   return client.searchIssues({ jql });
 }
 
@@ -249,6 +254,9 @@ async function fetchIssuesCustom(
 
   console.log('🔍 Fetching issues (CUSTOM strategy):', jql);
 
+  if (typeof (client as any).getAxiosClient === 'function') {
+    return searchAllIssues((client as any).getAxiosClient(), { jql });
+  }
   return client.searchIssues({ jql });
 }
 
@@ -279,5 +287,8 @@ async function fetchIssuesFiltered(
 
   console.log('🔍 Fetching issues (FILTERED strategy):', jql);
 
+  if (typeof (client as any).getAxiosClient === 'function') {
+    return searchAllIssues((client as any).getAxiosClient(), { jql });
+  }
   return client.searchIssues({ jql });
 }

package/plugins/specweave-jira/lib/jira-multi-project-sync.js

@@ -5,6 +5,7 @@ import {
   mapUserStoryToProjects
 } from "../../../src/utils/project-mapper.js";
 import { parseSpecFile } from "../../../src/utils/spec-splitter.js";
+import { getEpicLinkFieldForProject } from "./jira-field-discovery.js";
 class JiraMultiProjectSync {
   constructor(config) {
     this.config = config;
@@ -43,14 +44,6 @@ Please verify project keys and access permissions.`
     const results = [];
     await this.validateProjects();
     const parsedSpec = await parseSpecFile(specPath);
-    const epicsByProject = /* @__PURE__ */ new Map();
-    if (this.config.autoCreateEpics !== false) {
-      for (const project of this.config.projects) {
-        const epicResult = await this.createEpicForProject(parsedSpec, project);
-        epicsByProject.set(project, epicResult.issueKey);
-        results.push(epicResult);
-      }
-    }
     const projectStories = /* @__PURE__ */ new Map();
     for (const userStory of parsedSpec.userStories) {
       if (this.config.intelligentMapping !== false) {
@@ -85,6 +78,14 @@ Please verify project keys and access permissions.`
         }
       }
     }
+    const epicsByProject = /* @__PURE__ */ new Map();
+    if (this.config.autoCreateEpics !== false) {
+      for (const projectId of projectStories.keys()) {
+        const epicResult = await this.createEpicForProject(parsedSpec, projectId);
+        epicsByProject.set(projectId, epicResult.issueKey);
+        results.push(epicResult);
+      }
+    }
     for (const [projectId, stories] of projectStories.entries()) {
       const epicKey = epicsByProject.get(projectId);
       for (const { story, confidence } of stories) {
@@ -167,7 +168,16 @@ _Classification confidence: ${(confidence * 100).toFixed(0)}%_
       issuetype: { name: this.getIssueTypeName(itemType) }
     };
     if (epicKey) {
-      issueData.parent = { key: epicKey };
+      const { field: epicField, style } = await getEpicLinkFieldForProject(
+        this.config.domain,
+        projectId,
+        { email: this.config.email, apiToken: this.config.apiToken }
+      );
+      if (style === "next-gen") {
+        issueData.parent = { key: epicKey };
+      } else {
+        issueData[epicField] = epicKey;
+      }
     }
     const issue = await this.client.createIssue(issueData);
     return {

package/plugins/specweave-jira/lib/jira-multi-project-sync.ts

@@ -23,6 +23,7 @@ import {
   mapUserStoryToProjects
 } from '../../../src/utils/project-mapper.js';
 import { parseSpecFile } from '../../../src/utils/spec-splitter.js';
+import { getEpicLinkFieldForProject } from './jira-field-discovery.js';
 
 export interface JiraMultiProjectConfig {
   domain: string;
@@ -108,18 +109,7 @@ export class JiraMultiProjectSync {
     // Parse spec
     const parsedSpec = await parseSpecFile(specPath);
 
-    // Step 1: Create epic per project (if enabled)
-    const epicsByProject = new Map<string, string>();  // projectId → epicKey
-
-    if (this.config.autoCreateEpics !== false) {
-      for (const project of this.config.projects) {
-        const epicResult = await this.createEpicForProject(parsedSpec, project);
-        epicsByProject.set(project, epicResult.issueKey);
-        results.push(epicResult);
-      }
-    }
-
-    // Step 2: Classify user stories by project
+    // Step 1: Classify user stories by project FIRST (before creating epics)
     const projectStories = new Map<string, Array<{ story: UserStory; confidence: number }>>();
 
     for (const userStory of parsedSpec.userStories) {
@@ -162,6 +152,17 @@ export class JiraMultiProjectSync {
       }
     }
 
+    // Step 2: Create epics ONLY for projects that have classified stories
+    const epicsByProject = new Map<string, string>();  // projectId → epicKey
+
+    if (this.config.autoCreateEpics !== false) {
+      for (const projectId of projectStories.keys()) {
+        const epicResult = await this.createEpicForProject(parsedSpec, projectId);
+        epicsByProject.set(projectId, epicResult.issueKey);
+        results.push(epicResult);
+      }
+    }
+
     // Step 3: Create issues in each project
     for (const [projectId, stories] of projectStories.entries()) {
       const epicKey = epicsByProject.get(projectId);
@@ -255,9 +256,19 @@ ${confidence !== undefined ? `\n_Classification confidence: ${(confidence * 100)
       issuetype: { name: this.getIssueTypeName(itemType) }
     };
 
-    // Link to epic if provided
+    // Link to epic using dynamic field discovery
     if (epicKey) {
-      issueData.parent = { key: epicKey };
+      const { field: epicField, style } = await getEpicLinkFieldForProject(
+        this.config.domain,
+        projectId,
+        { email: this.config.email, apiToken: this.config.apiToken }
+      );
+
+      if (style === 'next-gen') {
+        issueData.parent = { key: epicKey };
+      } else {
+        issueData[epicField] = epicKey;
+      }
     }
 
     const issue = await this.client.createIssue(issueData);

package/plugins/specweave-jira/lib/jira-paginated-search.js

@@ -0,0 +1,55 @@
+const DEFAULT_PAGE_SIZE = 50;
+const MAX_RETRIES = 3;
+const BASE_DELAY_MS = 1e3;
+async function searchAllIssues(client, options) {
+  const { jql, fields, maxResults = DEFAULT_PAGE_SIZE } = options;
+  const allIssues = [];
+  let startAt = 0;
+  let total = Infinity;
+  while (startAt < total) {
+    const response = await requestWithRetry(client, "/search", {
+      params: {
+        jql,
+        startAt,
+        maxResults,
+        ...fields ? { fields } : {}
+      }
+    });
+    const data = response.data;
+    total = data.total;
+    const issues = data.issues || [];
+    allIssues.push(...issues);
+    startAt += issues.length;
+    if (issues.length === 0) break;
+  }
+  return allIssues;
+}
+async function requestWithRetry(client, url, config, attempt = 0) {
+  try {
+    return await client.get(url, config);
+  } catch (error) {
+    const axiosError = error;
+    const status = axiosError.response?.status;
+    if (status === 429 && attempt < MAX_RETRIES) {
+      const retryAfterHeader = axiosError.response?.headers?.["retry-after"];
+      const retryAfterMs = retryAfterHeader ? parseInt(retryAfterHeader, 10) * 1e3 : BASE_DELAY_MS * Math.pow(2, attempt);
+      console.warn(
+        `Rate limited (429). Retry ${attempt + 1}/${MAX_RETRIES} after ${retryAfterMs}ms...`
+      );
+      await sleep(retryAfterMs);
+      return requestWithRetry(client, url, config, attempt + 1);
+    }
+    if (status === 429) {
+      throw new Error(
+        `JIRA rate limit exceeded after ${MAX_RETRIES} retries. Try again later or reduce request frequency.`
+      );
+    }
+    throw error;
+  }
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export {
+  searchAllIssues
+};

package/plugins/specweave-jira/lib/jira-paginated-search.ts

@@ -0,0 +1,108 @@
+/**
+ * JIRA Paginated Search with Rate-Limit Retry
+ *
+ * Provides a paginated JQL search that fetches all results
+ * by iterating through pages using startAt/maxResults.
+ *
+ * Includes exponential backoff retry on HTTP 429 (rate limit).
+ *
+ * @module jira-paginated-search
+ */
+
+import axios, { AxiosInstance, AxiosError } from 'axios';
+
+const DEFAULT_PAGE_SIZE = 50;
+const MAX_RETRIES = 3;
+const BASE_DELAY_MS = 1000;
+
+export interface PaginatedSearchOptions {
+  jql: string;
+  fields?: string;
+  maxResults?: number;
+}
+
+/**
+ * Search all issues matching a JQL query with full pagination.
+ * Handles rate limiting with exponential backoff.
+ *
+ * @param client - Axios instance configured with JIRA auth
+ * @param options - Search options (jql, fields, maxResults per page)
+ * @returns All matching issues across all pages
+ */
+export async function searchAllIssues(
+  client: AxiosInstance,
+  options: PaginatedSearchOptions
+): Promise<any[]> {
+  const { jql, fields, maxResults = DEFAULT_PAGE_SIZE } = options;
+  const allIssues: any[] = [];
+  let startAt = 0;
+  let total = Infinity;
+
+  while (startAt < total) {
+    const response = await requestWithRetry(client, '/search', {
+      params: {
+        jql,
+        startAt,
+        maxResults,
+        ...(fields ? { fields } : {}),
+      },
+    });
+
+    const data = response.data;
+    total = data.total;
+    const issues = data.issues || [];
+    allIssues.push(...issues);
+
+    startAt += issues.length;
+
+    // Safety: if no issues returned, break to avoid infinite loop
+    if (issues.length === 0) break;
+  }
+
+  return allIssues;
+}
+
+/**
+ * Make an HTTP GET request with exponential backoff retry on 429.
+ */
+async function requestWithRetry(
+  client: AxiosInstance,
+  url: string,
+  config: any,
+  attempt: number = 0
+): Promise<any> {
+  try {
+    return await client.get(url, config);
+  } catch (error: any) {
+    const axiosError = error as AxiosError;
+    const status = axiosError.response?.status;
+
+    if (status === 429 && attempt < MAX_RETRIES) {
+      // Read Retry-After header (seconds) or use exponential backoff
+      const retryAfterHeader = axiosError.response?.headers?.['retry-after'];
+      const retryAfterMs = retryAfterHeader
+        ? parseInt(retryAfterHeader, 10) * 1000
+        : BASE_DELAY_MS * Math.pow(2, attempt);
+
+      console.warn(
+        `Rate limited (429). Retry ${attempt + 1}/${MAX_RETRIES} after ${retryAfterMs}ms...`
+      );
+
+      await sleep(retryAfterMs);
+      return requestWithRetry(client, url, config, attempt + 1);
+    }
+
+    if (status === 429) {
+      throw new Error(
+        `JIRA rate limit exceeded after ${MAX_RETRIES} retries. ` +
+        `Try again later or reduce request frequency.`
+      );
+    }
+
+    throw error;
+  }
+}
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}

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

@@ -18,6 +18,8 @@ import {
   generateSmartSummary,
   formatForJira
 } from "../../../src/core/comment-builder.js";
+import { readIssueKey } from "./metadata-paths.js";
+import { getApiBaseUrl } from "./jira-deployment-detector.js";
 import path from "path";
 import fs from "fs/promises";
 async function syncSpecCommitsToJira(config, options) {
@@ -38,7 +40,7 @@ async function syncSpecCommitsToJira(config, options) {
       result.errors.push("No metadata.json found");
       return result;
     }
-    const jiraIssueKey = metadata.jira?.issueKey;
+    const jiraIssueKey = readIssueKey(metadata);
     if (!jiraIssueKey) {
       if (verbose) {
         console.log("No JIRA issue linked to increment");
@@ -46,7 +48,7 @@ async function syncSpecCommitsToJira(config, options) {
       return result;
     }
     const client = axios.create({
-      baseURL: `https://${config.domain}/rest/api/3`,
+      baseURL: getApiBaseUrl(config.domain),
       auth: {
         username: config.email,
         password: config.apiToken
@@ -194,7 +196,7 @@ Short update comment (JIRA format):`);
 async function postCommitBatchUpdate(config, incrementPath, commits, issueKey, repo, dryRun = false) {
   try {
     const client = axios.create({
-      baseURL: `https://${config.domain}/rest/api/3`,
+      baseURL: getApiBaseUrl(config.domain),
       auth: {
         username: config.email,
         password: config.apiToken