cc-agentic-framework 1.14.1

package/dist/lib/jira/sync-engine.js

@@ -0,0 +1,420 @@
+/**
+ * Sync Engine - Bidirectional synchronization between local tickets and Jira
+ *
+ * Features:
+ * - CREATE: Push new local tickets to Jira
+ * - UPDATE: Push local changes to existing Jira issues
+ * - DOWNLOAD: Pull Jira issues to local markdown files
+ * - Conflict detection with field-level granularity
+ * - Dry-run mode for safe previews
+ *
+ * @module lib/jira/sync-engine
+ */
+import { WikiConverter } from './wiki-converter.js';
+import { extractAcceptanceCriteria, formatAsJiraWiki } from './acceptance-criteria.js';
+import { parseFrontmatter, stringifyFrontmatter } from '../common/yaml-frontmatter.js';
+import { mapLocalToJira, mapJiraToLocal, mergeLabelsAndTags } from './field-mapper.js';
+import fs from 'fs-extra';
+import path from 'path';
+/**
+ * Jira custom field IDs
+ */
+const ACCEPTANCE_CRITERIA_FIELD_ID = 'customfield_13608';
+/**
+ * Sync Engine - Orchestrates bidirectional sync between local and Jira
+ */
+export class SyncEngine {
+    jiraClient;
+    wikiConverter;
+    baseUrl;
+    constructor(jiraClient, baseUrl) {
+        this.jiraClient = jiraClient;
+        this.wikiConverter = new WikiConverter();
+        this.baseUrl = baseUrl || jiraClient['config']?.baseUrl || '';
+    }
+    /**
+     * Sync local ticket to Jira (CREATE or UPDATE mode)
+     *
+     * @param filePath - Path to local markdown ticket
+     * @param options - Sync options
+     * @returns Sync result
+     */
+    async syncToJira(filePath, options = {}) {
+        try {
+            // Read and parse local file
+            const content = await fs.readFile(filePath, 'utf-8');
+            const parsed = parseFrontmatter(content);
+            const frontmatter = parsed.data;
+            const body = parsed.content;
+            // Determine mode based on jira-ticketId
+            const jiraTicketId = frontmatter['jira-ticketId'];
+            const mode = !jiraTicketId || jiraTicketId === '' || jiraTicketId === 'null' ? 'create' : 'update';
+            // Detect conflicts if UPDATE mode and not forced
+            if (mode === 'update' && !options.force) {
+                const conflicts = await this.detectConflicts(filePath, jiraTicketId);
+                if (conflicts.length > 0) {
+                    return {
+                        success: false,
+                        mode,
+                        source: filePath,
+                        destination: jiraTicketId,
+                        changes: [],
+                        conflicts,
+                        error: `Detected ${conflicts.length} conflict(s). Use --force to override.`,
+                    };
+                }
+            }
+            // Extract acceptance criteria
+            const acceptanceCriteria = extractAcceptanceCriteria(body);
+            // Convert markdown to Jira wiki markup
+            const jiraDescription = this.wikiConverter.convert(body, {
+                removeTitle: true,
+                removeHorizontalRules: true,
+                removeMetadataLine: true,
+                removeDescriptionHeading: true,
+                removeAcceptanceCriteria: true,
+                convertBoldLabelsToHeadings: true,
+            });
+            // Map local data to Jira fields
+            const localWithDescription = {
+                ...frontmatter,
+                'jira-description': jiraDescription,
+            };
+            // Merge labels and tags
+            const mergedLabels = mergeLabelsAndTags(frontmatter);
+            if (mergedLabels.length > 0) {
+                localWithDescription['jira-labels'] = mergedLabels;
+            }
+            const jiraFields = mapLocalToJira(localWithDescription, mode);
+            // Add project for CREATE mode
+            if (mode === 'create') {
+                jiraFields.project = { key: frontmatter['jira-project'] || 'DAPM' };
+            }
+            // Track changes
+            const changes = [];
+            // Dry-run mode: return without making API calls
+            if (options.dryRun) {
+                // Generate preview changes
+                Object.keys(jiraFields).forEach((field) => {
+                    changes.push({
+                        field,
+                        oldValue: mode === 'update' ? '(existing)' : null,
+                        newValue: jiraFields[field],
+                    });
+                });
+                return {
+                    success: true,
+                    mode,
+                    source: filePath,
+                    destination: mode === 'create' ? '(new issue)' : jiraTicketId,
+                    changes,
+                    dryRun: true,
+                };
+            }
+            // Execute CREATE or UPDATE
+            let issueKey;
+            let issueUrl;
+            if (mode === 'create') {
+                // Create new issue
+                issueKey = await this.jiraClient.createIssue(jiraFields);
+                issueUrl = `${this.baseUrl}/browse/${issueKey}`;
+                changes.push({ field: 'jira-ticketId', oldValue: null, newValue: issueKey }, { field: 'jira-url', oldValue: null, newValue: issueUrl });
+                // Update acceptance criteria if any
+                if (acceptanceCriteria.length > 0) {
+                    const acWiki = formatAsJiraWiki(acceptanceCriteria);
+                    await this.jiraClient.updateIssue(issueKey, {
+                        [ACCEPTANCE_CRITERIA_FIELD_ID]: acWiki,
+                    });
+                    changes.push({
+                        field: 'acceptance-criteria',
+                        oldValue: null,
+                        newValue: `${acceptanceCriteria.length} items`,
+                    });
+                }
+                // Update local file with Jira metadata
+                const exportDate = new Date().toISOString().split('T')[0];
+                const updatedContent = stringifyFrontmatter({
+                    ...frontmatter,
+                    'jira-ticketId': issueKey,
+                    'jira-url': issueUrl,
+                    exportedDate: exportDate,
+                }, parsed.content);
+                await fs.writeFile(filePath, updatedContent, 'utf-8');
+            }
+            else {
+                // Update existing issue
+                issueKey = jiraTicketId;
+                issueUrl = `${this.baseUrl}/browse/${issueKey}`;
+                await this.jiraClient.updateIssue(issueKey, jiraFields);
+                // Track field changes
+                Object.keys(jiraFields).forEach((field) => {
+                    changes.push({
+                        field,
+                        oldValue: '(previous)',
+                        newValue: jiraFields[field],
+                    });
+                });
+                // Update acceptance criteria if any
+                if (acceptanceCriteria.length > 0) {
+                    const acWiki = formatAsJiraWiki(acceptanceCriteria);
+                    await this.jiraClient.updateIssue(issueKey, {
+                        [ACCEPTANCE_CRITERIA_FIELD_ID]: acWiki,
+                    });
+                    changes.push({
+                        field: 'acceptance-criteria',
+                        oldValue: '(previous)',
+                        newValue: `${acceptanceCriteria.length} items`,
+                    });
+                }
+                // Update exportedDate in local file
+                const exportDate = new Date().toISOString().split('T')[0];
+                const updatedContent = stringifyFrontmatter({
+                    ...frontmatter,
+                    exportedDate: exportDate,
+                }, parsed.content);
+                await fs.writeFile(filePath, updatedContent, 'utf-8');
+            }
+            return {
+                success: true,
+                mode,
+                source: filePath,
+                destination: issueKey,
+                changes,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                mode: 'create',
+                source: filePath,
+                destination: '(failed)',
+                changes: [],
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Sync Jira issue to local markdown file (DOWNLOAD mode)
+     *
+     * @param jiraKey - Jira issue key (e.g., "DAPM-1234")
+     * @param outputPath - Path to save local markdown file
+     * @param options - Sync options
+     * @returns Sync result
+     */
+    async syncFromJira(jiraKey, outputPath, options = {}) {
+        try {
+            // Fetch Jira issue
+            const jiraIssue = await this.jiraClient.getIssue(jiraKey);
+            // Detect conflicts if file exists and not forced
+            if ((await fs.pathExists(outputPath)) && !options.force) {
+                const conflicts = await this.detectConflictsFromJira(outputPath, jiraIssue);
+                if (conflicts.length > 0) {
+                    return {
+                        success: false,
+                        mode: 'download',
+                        source: jiraKey,
+                        destination: outputPath,
+                        changes: [],
+                        conflicts,
+                        error: `Detected ${conflicts.length} conflict(s). Use --force to override.`,
+                    };
+                }
+            }
+            // Map Jira fields to local data
+            const localData = mapJiraToLocal(jiraIssue);
+            // Add Jira URL
+            localData['jira-url'] = `${this.baseUrl}/browse/${jiraKey}`;
+            // Convert Jira wiki description to markdown
+            // Note: For now, we use the description as-is
+            // TODO: Implement Jira wiki → markdown conversion when needed
+            const jiraDescription = String(jiraIssue.fields?.description || '');
+            const markdownDescription = jiraDescription;
+            // Track changes
+            const changes = [];
+            Object.keys(localData).forEach((field) => {
+                changes.push({
+                    field,
+                    oldValue: null,
+                    newValue: localData[field],
+                });
+            });
+            // Dry-run mode: return without writing file
+            if (options.dryRun) {
+                return {
+                    success: true,
+                    mode: 'download',
+                    source: jiraKey,
+                    destination: outputPath,
+                    changes,
+                    dryRun: true,
+                };
+            }
+            // Build markdown content
+            const content = stringifyFrontmatter(localData, markdownDescription);
+            // Write to file
+            await fs.ensureDir(path.dirname(outputPath));
+            await fs.writeFile(outputPath, content, 'utf-8');
+            return {
+                success: true,
+                mode: 'download',
+                source: jiraKey,
+                destination: outputPath,
+                changes,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                mode: 'download',
+                source: jiraKey,
+                destination: outputPath,
+                changes: [],
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Detect conflicts between local file and Jira issue
+     *
+     * Compares local frontmatter with remote Jira fields to identify conflicts.
+     * A conflict exists when both local and remote have changed since last sync.
+     *
+     * @param filePath - Path to local markdown file
+     * @param jiraKey - Jira issue key
+     * @returns Array of detected conflicts
+     */
+    async detectConflicts(filePath, jiraKey) {
+        try {
+            // Read local file
+            const content = await fs.readFile(filePath, 'utf-8');
+            const parsed = parseFrontmatter(content);
+            const localData = parsed.data;
+            // Fetch Jira issue
+            const jiraIssue = await this.jiraClient.getIssue(jiraKey);
+            const remoteData = mapJiraToLocal(jiraIssue);
+            // Detect conflicts
+            return this.compareFields(localData, remoteData);
+        }
+        catch (_error) {
+            // If fetching fails, no conflicts (assume local is source of truth)
+            return [];
+        }
+    }
+    /**
+     * Detect conflicts between local file and Jira issue object
+     *
+     * @param filePath - Path to local markdown file
+     * @param jiraIssue - Jira issue object
+     * @returns Array of detected conflicts
+     */
+    async detectConflictsFromJira(filePath, jiraIssue) {
+        try {
+            // Read local file
+            const content = await fs.readFile(filePath, 'utf-8');
+            const parsed = parseFrontmatter(content);
+            const localData = parsed.data;
+            // Map Jira to local
+            const remoteData = mapJiraToLocal(jiraIssue);
+            // Detect conflicts
+            return this.compareFields(localData, remoteData);
+        }
+        catch (_error) {
+            // If reading fails, no conflicts (assume Jira is source of truth)
+            return [];
+        }
+    }
+    /**
+     * Compare local and remote fields to detect conflicts
+     *
+     * @param localData - Local frontmatter data
+     * @param remoteData - Remote Jira data (mapped to local format)
+     * @returns Array of conflicts
+     */
+    compareFields(localData, remoteData) {
+        const conflicts = [];
+        // Fields to compare
+        const fieldsToCompare = [
+            'title',
+            'priority',
+            'jira-status',
+            'jira-assignee',
+            'jira-labels',
+            'jira-component',
+        ];
+        for (const field of fieldsToCompare) {
+            const localValue = localData[field];
+            const remoteValue = remoteData[field];
+            // Skip if both are null/undefined
+            if ((localValue === null || localValue === undefined) &&
+                (remoteValue === null || remoteValue === undefined)) {
+                continue;
+            }
+            // Detect conflict if values differ
+            if (!this.valuesEqual(localValue, remoteValue)) {
+                conflicts.push({
+                    field,
+                    localValue,
+                    remoteValue,
+                    resolution: 'manual', // Default to manual resolution
+                });
+            }
+        }
+        return conflicts;
+    }
+    /**
+     * Compare two values for equality (handles arrays and objects)
+     *
+     * @param a - First value
+     * @param b - Second value
+     * @returns True if equal
+     */
+    valuesEqual(a, b) {
+        // Handle null/undefined
+        if (a === null || a === undefined) {
+            return b === null || b === undefined;
+        }
+        if (b === null || b === undefined) {
+            return false;
+        }
+        // Handle arrays
+        if (Array.isArray(a) && Array.isArray(b)) {
+            if (a.length !== b.length)
+                return false;
+            const sortedA = [...a].sort();
+            const sortedB = [...b].sort();
+            return sortedA.every((val, idx) => val === sortedB[idx]);
+        }
+        // Handle objects
+        if (typeof a === 'object' && typeof b === 'object') {
+            return JSON.stringify(a) === JSON.stringify(b);
+        }
+        // Primitive comparison
+        return a === b;
+    }
+}
+/**
+ * Standalone function to sync local ticket to Jira
+ *
+ * @param filePath - Path to local markdown ticket
+ * @param jiraClient - Jira client instance
+ * @param options - Sync options
+ * @returns Sync result
+ */
+export async function syncToJira(filePath, jiraClient, options = {}) {
+    const engine = new SyncEngine(jiraClient);
+    return engine.syncToJira(filePath, options);
+}
+/**
+ * Standalone function to sync Jira issue to local file
+ *
+ * @param jiraKey - Jira issue key
+ * @param outputPath - Path to save local markdown file
+ * @param jiraClient - Jira client instance
+ * @param options - Sync options
+ * @returns Sync result
+ */
+export async function syncFromJira(jiraKey, outputPath, jiraClient, options = {}) {
+    const engine = new SyncEngine(jiraClient);
+    return engine.syncFromJira(jiraKey, outputPath, options);
+}
+//# sourceMappingURL=sync-engine.js.map

package/dist/lib/jira/sync-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-engine.js","sourceRoot":"","sources":["../../../src/lib/jira/sync-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AAmExB;;GAEG;AACH,MAAM,4BAA4B,GAAG,mBAAmB,CAAC;AAEzD;;GAEG;AACH,MAAM,OAAO,UAAU;IAID;IAHZ,aAAa,CAAgB;IAC7B,OAAO,CAAS;IAExB,YAAoB,UAAsB,EAAE,OAAgB;QAAxC,eAAU,GAAV,UAAU,CAAY;QACxC,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,IAAK,UAA2D,CAAC,QAAQ,CAAC,EAAE,OAAO,IAAI,EAAE,CAAC;IAClH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,UAAuB,EAAE;QAC1D,IAAI,CAAC;YACH,4BAA4B;YAC5B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACzC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;YAChC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;YAE5B,wCAAwC;YACxC,MAAM,YAAY,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC;YAClD,MAAM,IAAI,GACR,CAAC,YAAY,IAAI,YAAY,KAAK,EAAE,IAAI,YAAY,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;YAExF,iDAAiD;YACjD,IAAI,IAAI,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACxC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,YAAsB,CAAC,CAAC;gBAE/E,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzB,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,IAAI;wBACJ,MAAM,EAAE,QAAQ;wBAChB,WAAW,EAAE,YAAsB;wBACnC,OAAO,EAAE,EAAE;wBACX,SAAS;wBACT,KAAK,EAAE,YAAY,SAAS,CAAC,MAAM,wCAAwC;qBAC5E,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,8BAA8B;YAC9B,MAAM,kBAAkB,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;YAE3D,uCAAuC;YACvC,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE;gBACvD,WAAW,EAAE,IAAI;gBACjB,qBAAqB,EAAE,IAAI;gBAC3B,kBAAkB,EAAE,IAAI;gBACxB,wBAAwB,EAAE,IAAI;gBAC9B,wBAAwB,EAAE,IAAI;gBAC9B,2BAA2B,EAAE,IAAI;aAClC,CAAC,CAAC;YAEH,gCAAgC;YAChC,MAAM,oBAAoB,GAA4B;gBACpD,GAAG,WAAW;gBACd,kBAAkB,EAAE,eAAe;aACpC,CAAC;YAEF,wBAAwB;YACxB,MAAM,YAAY,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;YACrD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,oBAAoB,CAAC,aAAa,CAAC,GAAG,YAAY,CAAC;YACrD,CAAC;YAED,MAAM,UAAU,GAAG,cAAc,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;YAE9D,8BAA8B;YAC9B,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtB,UAAU,CAAC,OAAO,GAAG,EAAE,GAAG,EAAE,WAAW,CAAC,cAAc,CAAC,IAAI,MAAM,EAAE,CAAC;YACtE,CAAC;YAED,gBAAgB;YAChB,MAAM,OAAO,GAAkB,EAAE,CAAC;YAElC,gDAAgD;YAChD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,2BAA2B;gBAC3B,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;oBACxC,OAAO,CAAC,IAAI,CAAC;wBACX,KAAK;wBACL,QAAQ,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI;wBACjD,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC;qBAC5B,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;gBAEH,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,IAAI;oBACJ,MAAM,EAAE,QAAQ;oBAChB,WAAW,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAE,YAAuB;oBACzE,OAAO;oBACP,MAAM,EAAE,IAAI;iBACb,CAAC;YACJ,CAAC;YAED,2BAA2B;YAC3B,IAAI,QAAgB,CAAC;YACrB,IAAI,QAAgB,CAAC;YAErB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtB,mBAAmB;gBACnB,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;gBACzD,QAAQ,GAAG,GAAG,IAAI,CAAC,OAAO,WAAW,QAAQ,EAAE,CAAC;gBAEhD,OAAO,CAAC,IAAI,CACV,EAAE,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAC9D,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAC1D,CAAC;gBAEF,oCAAoC;gBACpC,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAClC,MAAM,MAAM,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;oBACpD,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,QAAQ,EAAE;wBAC1C,CAAC,4BAA4B,CAAC,EAAE,MAAM;qBACvC,CAAC,CAAC;oBAEH,OAAO,CAAC,IAAI,CAAC;wBACX,KAAK,EAAE,qBAAqB;wBAC5B,QAAQ,EAAE,IAAI;wBACd,QAAQ,EAAE,GAAG,kBAAkB,CAAC,MAAM,QAAQ;qBAC/C,CAAC,CAAC;gBACL,CAAC;gBAED,uCAAuC;gBACvC,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC1D,MAAM,cAAc,GAAG,oBAAoB,CACzC;oBACE,GAAG,WAAW;oBACd,eAAe,EAAE,QAAQ;oBACzB,UAAU,EAAE,QAAQ;oBACpB,YAAY,EAAE,UAAU;iBACzB,EACD,MAAM,CAAC,OAAO,CACf,CAAC;gBACF,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,wBAAwB;gBACxB,QAAQ,GAAG,YAAsB,CAAC;gBAClC,QAAQ,GAAG,GAAG,IAAI,CAAC,OAAO,WAAW,QAAQ,EAAE,CAAC;gBAEhD,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;gBAExD,sBAAsB;gBACtB,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;oBACxC,OAAO,CAAC,IAAI,CAAC;wBACX,KAAK;wBACL,QAAQ,EAAE,YAAY;wBACtB,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC;qBAC5B,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;gBAEH,oCAAoC;gBACpC,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAClC,MAAM,MAAM,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;oBACpD,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,QAAQ,EAAE;wBAC1C,CAAC,4BAA4B,CAAC,EAAE,MAAM;qBACvC,CAAC,CAAC;oBAEH,OAAO,CAAC,IAAI,CAAC;wBACX,KAAK,EAAE,qBAAqB;wBAC5B,QAAQ,EAAE,YAAY;wBACtB,QAAQ,EAAE,GAAG,kBAAkB,CAAC,MAAM,QAAQ;qBAC/C,CAAC,CAAC;gBACL,CAAC;gBAED,oCAAoC;gBACpC,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC1D,MAAM,cAAc,GAAG,oBAAoB,CACzC;oBACE,GAAG,WAAW;oBACd,YAAY,EAAE,UAAU;iBACzB,EACD,MAAM,CAAC,OAAO,CACf,CAAC;gBACF,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;YACxD,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI;gBACJ,MAAM,EAAE,QAAQ;gBAChB,WAAW,EAAE,QAAQ;gBACrB,OAAO;aACR,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,QAAQ;gBAChB,WAAW,EAAE,UAAU;gBACvB,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,YAAY,CAChB,OAAe,EACf,UAAkB,EAClB,UAAuB,EAAE;QAEzB,IAAI,CAAC;YACH,mBAAmB;YACnB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAE1D,iDAAiD;YACjD,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACxD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;gBAE5E,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzB,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,IAAI,EAAE,UAAU;wBAChB,MAAM,EAAE,OAAO;wBACf,WAAW,EAAE,UAAU;wBACvB,OAAO,EAAE,EAAE;wBACX,SAAS;wBACT,KAAK,EAAE,YAAY,SAAS,CAAC,MAAM,wCAAwC;qBAC5E,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,gCAAgC;YAChC,MAAM,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;YAE5C,eAAe;YACf,SAAS,CAAC,UAAU,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,WAAW,OAAO,EAAE,CAAC;YAE5D,4CAA4C;YAC5C,8CAA8C;YAC9C,8DAA8D;YAC9D,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC;YACpE,MAAM,mBAAmB,GAAG,eAAe,CAAC;YAE5C,gBAAgB;YAChB,MAAM,OAAO,GAAkB,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;gBACvC,OAAO,CAAC,IAAI,CAAC;oBACX,KAAK;oBACL,QAAQ,EAAE,IAAI;oBACd,QAAQ,EAAE,SAAS,CAAC,KAAK,CAAC;iBAC3B,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,4CAA4C;YAC5C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,IAAI,EAAE,UAAU;oBAChB,MAAM,EAAE,OAAO;oBACf,WAAW,EAAE,UAAU;oBACvB,OAAO;oBACP,MAAM,EAAE,IAAI;iBACb,CAAC;YACJ,CAAC;YAED,yBAAyB;YACzB,MAAM,OAAO,GAAG,oBAAoB,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;YAErE,gBAAgB;YAChB,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;YAC7C,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAEjD,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,OAAO;gBACf,WAAW,EAAE,UAAU;gBACvB,OAAO;aACR,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,OAAO;gBACf,WAAW,EAAE,UAAU;gBACvB,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,eAAe,CAAC,QAAgB,EAAE,OAAe;QACrD,IAAI,CAAC;YACH,kBAAkB;YAClB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACzC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC;YAE9B,mBAAmB;YACnB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC1D,MAAM,UAAU,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;YAE7C,mBAAmB;YACnB,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,oEAAoE;YACpE,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,uBAAuB,CACnC,QAAgB,EAChB,SAAoB;QAEpB,IAAI,CAAC;YACH,kBAAkB;YAClB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACzC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC;YAE9B,oBAAoB;YACpB,MAAM,UAAU,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;YAE7C,mBAAmB;YACnB,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,kEAAkE;YAClE,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,aAAa,CACnB,SAAkC,EAClC,UAAmC;QAEnC,MAAM,SAAS,GAAe,EAAE,CAAC;QAEjC,oBAAoB;QACpB,MAAM,eAAe,GAAG;YACtB,OAAO;YACP,UAAU;YACV,aAAa;YACb,eAAe;YACf,aAAa;YACb,gBAAgB;SACjB,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;YACpC,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YAEtC,kCAAkC;YAClC,IACE,CAAC,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,SAAS,CAAC;gBACjD,CAAC,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,SAAS,CAAC,EACnD,CAAC;gBACD,SAAS;YACX,CAAC;YAED,mCAAmC;YACnC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,CAAC;gBAC/C,SAAS,CAAC,IAAI,CAAC;oBACb,KAAK;oBACL,UAAU;oBACV,WAAW;oBACX,UAAU,EAAE,QAAQ,EAAE,+BAA+B;iBACtD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACK,WAAW,CAAC,CAAU,EAAE,CAAU;QACxC,wBAAwB;QACxB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,gBAAgB;QAChB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAC;YACxC,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC9B,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3D,CAAC;QAED,iBAAiB;QACjB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YACnD,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC;QAED,uBAAuB;QACvB,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAgB,EAChB,UAAsB,EACtB,UAAuB,EAAE;IAEzB,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAe,EACf,UAAkB,EAClB,UAAsB,EACtB,UAAuB,EAAE;IAEzB,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC"}

package/dist/lib/jira/wiki-converter.d.ts

@@ -0,0 +1,133 @@
+/**
+ * WikiConverter - Converts Markdown to Jira Wiki Markup
+ *
+ * Migrated from: modules/jira/src/jira/export_to_jira.py (MarkdownToJiraConverter)
+ *
+ * Conversion Rules:
+ * - Headers: # → h1., ## → h2., ### → h3.
+ * - Bold: **text** → *text*
+ * - Italic: _text_ → _text_ (preserved)
+ * - Inline code: `code` → {{code}}
+ * - Code blocks: ```lang → {code:lang}, ``` → {code}
+ * - Links: [text](url) → [text|url]
+ * - Lists: - item → * item, 1. item → # item
+ *
+ * Optional cleanup (matching Python implementation):
+ * - Remove title (first h1 heading)
+ * - Remove horizontal rules (---)
+ * - Remove metadata lines
+ * - Convert bold labels to h3 headings
+ */
+export interface WikiConverterOptions {
+    /** Remove the first h1 heading (title) */
+    removeTitle?: boolean;
+    /** Remove horizontal rules (---) */
+    removeHorizontalRules?: boolean;
+    /** Remove metadata line (Type: Task | Status: ...) */
+    removeMetadataLine?: boolean;
+    /** Remove Description heading */
+    removeDescriptionHeading?: boolean;
+    /** Remove Acceptance Criteria section */
+    removeAcceptanceCriteria?: boolean;
+    /** Convert bold labels (e.g., **Context:**) to h3 headings */
+    convertBoldLabelsToHeadings?: boolean;
+}
+export declare class WikiConverter {
+    /**
+     * Convert markdown to Jira wiki markup
+     *
+     * @param markdown - Markdown text to convert
+     * @param options - Optional cleanup and conversion options
+     * @returns Jira wiki markup text
+     */
+    convert(markdown: string, options?: WikiConverterOptions): string;
+    /**
+     * Remove title (first h1 heading)
+     */
+    private removeTitle;
+    /**
+     * Remove horizontal rules (---)
+     */
+    private removeHorizontalRules;
+    /**
+     * Remove metadata line (Type: Task | Status: Ready For Review | Priority: P1 | Effort: 5 points)
+     */
+    private removeMetadataLine;
+    /**
+     * Remove "Description" heading (Jira provides this section already)
+     */
+    private removeDescriptionHeading;
+    /**
+     * Remove Acceptance Criteria section (from ## Acceptance Criteria to end or next ##)
+     */
+    private removeAcceptanceCriteria;
+    /**
+     * Convert section headers formatted as bold to h3 headings
+     *
+     * Examples:
+     * - **Context:** → h3. Context
+     * - **Requirements:** → h3. Requirements
+     * - **Technical Notes:** → h3. Technical Notes
+     */
+    private convertBoldLabelsToHeadings;
+    /**
+     * Convert markdown headers to Jira wiki headers
+     *
+     * - # Header → h1. Header
+     * - ## Header → h2. Header
+     * - ### Header → h3. Header
+     */
+    private convertHeaders;
+    /**
+     * Convert bold formatting from markdown to Jira wiki
+     *
+     * - **text** → *text*
+     * - ***text*** → *text* (multiple asterisks normalized)
+     *
+     * Note: Jira uses single asterisk for bold, not double
+     */
+    private convertBold;
+    /**
+     * Convert links from markdown to Jira wiki format
+     *
+     * - [text](url) → [text|url]
+     *
+     * Note: Uses non-greedy matching to handle nested brackets
+     */
+    private convertLinks;
+    /**
+     * Convert fenced code blocks to Jira wiki format
+     *
+     * - ```language → {code:language}
+     * - ``` → {code}
+     * - Closing ``` → {code}
+     */
+    private convertCodeBlocks;
+    /**
+     * Convert inline code from markdown to Jira wiki format
+     *
+     * - `code` → {{code}}
+     *
+     * Note: Code blocks are converted first, so backticks inside {code}...{code}
+     * blocks are protected from conversion
+     */
+    private convertInlineCode;
+    /**
+     * Convert lists from markdown to Jira wiki format
+     *
+     * - Unordered: - item → * item
+     * - Ordered: 1. item → # item
+     *
+     * Preserves indentation for nested lists
+     */
+    private convertLists;
+}
+/**
+ * Convenience function to convert markdown to Jira wiki markup
+ *
+ * @param markdown - Markdown text to convert
+ * @param options - Optional conversion options
+ * @returns Jira wiki markup text
+ */
+export declare function convertMarkdownToJiraWiki(markdown: string, options?: WikiConverterOptions): string;
+//# sourceMappingURL=wiki-converter.d.ts.map

package/dist/lib/jira/wiki-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-converter.d.ts","sourceRoot":"","sources":["../../../src/lib/jira/wiki-converter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,oBAAoB;IACnC,0CAA0C;IAC1C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oCAAoC;IACpC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iCAAiC;IACjC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,yCAAyC;IACzC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,8DAA8D;IAC9D,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;AAED,qBAAa,aAAa;IACxB;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM;IAsDrE;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAI7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAIhC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAIhC;;;;;;;OAOG;IACH,OAAO,CAAC,2BAA2B;IAInC;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;IAUnB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAMpB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAezB;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IAuCzB;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;CAarB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,MAAM,CAGR"}