cc-agentic-framework 1.14.1

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

@@ -0,0 +1,332 @@
+import { WikiConverter } from './wiki-converter.js';
+import { extractAcceptanceCriteria, formatAsJiraWiki } from './acceptance-criteria.js';
+import { parseFrontmatter, updateFrontmatter } from '../common/yaml-frontmatter.js';
+import fs from 'fs-extra';
+/**
+ * Export mode: CREATE or UPDATE
+ */
+export var ExportMode;
+(function (ExportMode) {
+    ExportMode["CREATE"] = "create";
+    ExportMode["UPDATE"] = "update";
+})(ExportMode || (ExportMode = {}));
+/**
+ * Jira custom field IDs
+ */
+const ACCEPTANCE_CRITERIA_FIELD_ID = 'customfield_13608';
+/**
+ * Priority mapping from custom codes to Jira priority names
+ */
+const PRIORITY_MAP = {
+    P0: 'Highest',
+    P1: 'High',
+    P2: 'Medium',
+    P3: 'Low',
+    P4: 'Lowest',
+    Highest: 'Highest',
+    High: 'High',
+    Medium: 'Medium',
+    Low: 'Low',
+    Lowest: 'Lowest',
+};
+/**
+ * Document type to Jira issue type mapping
+ */
+const ISSUE_TYPE_MAP = {
+    story: 'Story',
+    task: 'Task',
+    bug: 'Bug',
+    spike: 'Task', // Spikes are tasks in Jira
+    epic: 'Epic',
+};
+/**
+ * ExportEngine - Orchestrates the export of tickets to Jira
+ *
+ * Features:
+ * - Auto-detects CREATE vs UPDATE mode based on jira-ticketId
+ * - Converts markdown to Jira wiki markup
+ * - Extracts and formats acceptance criteria
+ * - Updates local files with Jira metadata
+ * - Supports batch export with rate limiting
+ * - Dry-run mode for validation
+ *
+ * Migrated from: modules/jira/src/jira/export_to_jira.py (TicketExporter)
+ */
+export class ExportEngine {
+    jiraClient;
+    wikiConverter;
+    baseUrl;
+    constructor(jiraClient, baseUrl) {
+        this.jiraClient = jiraClient;
+        this.wikiConverter = new WikiConverter();
+        // Extract baseUrl from jiraClient config or use provided value
+        this.baseUrl = baseUrl || jiraClient['config']?.baseUrl || '';
+    }
+    /**
+     * Detect export mode based on frontmatter
+     *
+     * Returns CREATE if jira-ticketId is missing, null, empty, or "null" string.
+     * Returns UPDATE if jira-ticketId exists and has a valid value.
+     *
+     * @param frontmatter - Parsed frontmatter data
+     * @returns Export mode (CREATE or UPDATE)
+     */
+    detectMode(frontmatter) {
+        const ticketId = frontmatter['jira-ticketId'];
+        // CREATE if ticketId is missing, null, empty, or "null" string
+        if (!ticketId || ticketId === '' || ticketId === 'null') {
+            return ExportMode.CREATE;
+        }
+        // UPDATE if ticketId exists with a valid value
+        return ExportMode.UPDATE;
+    }
+    /**
+     * Build Jira fields from frontmatter and description
+     *
+     * For CREATE mode: Includes project and issuetype (required for creation)
+     * For UPDATE mode: Excludes project and issuetype (immutable fields)
+     *
+     * @param frontmatter - Parsed frontmatter data
+     * @param description - Jira wiki markup description
+     * @param mode - Export mode (CREATE or UPDATE)
+     * @returns Jira fields object
+     */
+    buildJiraFields(frontmatter, description, mode) {
+        const fields = {
+            summary: frontmatter.title || 'Untitled',
+            description,
+        };
+        // Add immutable fields only for CREATE mode
+        if (mode === ExportMode.CREATE) {
+            // Map documentType to Jira issue type
+            const docType = String(frontmatter.documentType || 'story').toLowerCase();
+            const issueType = ISSUE_TYPE_MAP[docType] || 'Story';
+            fields.project = { key: 'DAPM' };
+            fields.issuetype = { name: issueType };
+        }
+        // Priority mapping
+        if (frontmatter.priority) {
+            const jiraPriority = PRIORITY_MAP[String(frontmatter.priority)] || 'Medium';
+            fields.priority = { name: jiraPriority };
+        }
+        // Labels - combine labels and tags, deduplicate
+        const labels = new Set();
+        // Add from labels field
+        if (frontmatter.labels) {
+            const labelList = Array.isArray(frontmatter.labels)
+                ? frontmatter.labels
+                : [frontmatter.labels];
+            labelList.forEach((label) => labels.add(String(label).trim()));
+        }
+        // Add from tags field
+        if (frontmatter.tags) {
+            const tagList = Array.isArray(frontmatter.tags)
+                ? frontmatter.tags
+                : [frontmatter.tags];
+            tagList.forEach((tag) => labels.add(String(tag).trim()));
+        }
+        if (labels.size > 0) {
+            fields.labels = Array.from(labels);
+        }
+        return fields;
+    }
+    /**
+     * Export a single ticket to Jira
+     *
+     * Auto-detects CREATE vs UPDATE mode based on jira-ticketId in frontmatter.
+     * Can be overridden with forceCreate or forceUpdate options.
+     *
+     * @param filePath - Path to markdown ticket file
+     * @param options - Export options (dryRun, forceCreate, forceUpdate)
+     * @returns Export result
+     */
+    async exportTicket(filePath, options = {}) {
+        // Validate file exists
+        const fileExists = await fs.pathExists(filePath);
+        if (!fileExists) {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        // Read and parse file
+        const content = await fs.readFile(filePath, 'utf-8');
+        const parsed = parseFrontmatter(content);
+        const frontmatter = parsed.data;
+        const body = parsed.content;
+        // Determine export mode
+        let mode;
+        if (options.forceCreate && options.forceUpdate) {
+            throw new Error('Cannot use both forceCreate and forceUpdate options');
+        }
+        if (options.forceCreate) {
+            mode = ExportMode.CREATE;
+        }
+        else if (options.forceUpdate) {
+            mode = ExportMode.UPDATE;
+        }
+        else {
+            mode = this.detectMode(frontmatter);
+        }
+        // Validate mode-specific requirements
+        this.validateForMode(frontmatter, mode);
+        // 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,
+        });
+        // Build Jira fields
+        const fields = this.buildJiraFields(frontmatter, jiraDescription, mode);
+        // Dry-run mode: return without making API calls
+        if (options.dryRun) {
+            return {
+                success: true,
+                mode,
+                filePath,
+                dryRun: true,
+                criteriaCount: acceptanceCriteria.length,
+            };
+        }
+        // Execute CREATE or UPDATE
+        let issueKey;
+        let issueUrl;
+        if (mode === ExportMode.CREATE) {
+            // Create new issue
+            issueKey = await this.jiraClient.createIssue(fields);
+            issueUrl = `${this.baseUrl}/browse/${issueKey}`;
+            // Update acceptance criteria if any
+            if (acceptanceCriteria.length > 0) {
+                const acWiki = formatAsJiraWiki(acceptanceCriteria);
+                await this.jiraClient.updateIssue(issueKey, {
+                    [ACCEPTANCE_CRITERIA_FIELD_ID]: acWiki,
+                });
+            }
+            // Update local file with Jira metadata
+            await this.updateLocalFileAfterCreate(filePath, issueKey, issueUrl);
+        }
+        else {
+            // Update existing issue
+            issueKey = frontmatter['jira-ticketId'];
+            issueUrl = `${this.baseUrl}/browse/${issueKey}`;
+            await this.jiraClient.updateIssue(issueKey, fields);
+            // Update acceptance criteria if any
+            if (acceptanceCriteria.length > 0) {
+                const acWiki = formatAsJiraWiki(acceptanceCriteria);
+                await this.jiraClient.updateIssue(issueKey, {
+                    [ACCEPTANCE_CRITERIA_FIELD_ID]: acWiki,
+                });
+            }
+            // Update exportedDate in local file
+            await this.updateLocalFileAfterUpdate(filePath);
+        }
+        return {
+            success: true,
+            mode,
+            issueKey,
+            issueUrl,
+            criteriaCount: acceptanceCriteria.length,
+            filePath,
+        };
+    }
+    /**
+     * Batch export multiple tickets
+     *
+     * Exports tickets sequentially with optional delay between requests.
+     * Continues processing even if individual exports fail.
+     *
+     * @param filePaths - Array of file paths to export
+     * @param options - Export options (dryRun, delayMs)
+     * @returns Array of export results
+     */
+    async batchExport(filePaths, options = {}) {
+        const results = [];
+        const delayMs = options.delayMs || 0;
+        for (let i = 0; i < filePaths.length; i++) {
+            const filePath = filePaths[i];
+            try {
+                const result = await this.exportTicket(filePath, options);
+                results.push(result);
+            }
+            catch (error) {
+                results.push({
+                    success: false,
+                    mode: ExportMode.CREATE, // Default, actual mode may differ
+                    filePath,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+            // Add delay between requests (except after last one)
+            if (delayMs > 0 && i < filePaths.length - 1) {
+                await this.sleep(delayMs);
+            }
+        }
+        return results;
+    }
+    /**
+     * Validate frontmatter for mode-specific requirements
+     *
+     * @param frontmatter - Parsed frontmatter data
+     * @param mode - Export mode
+     * @throws Error if validation fails
+     */
+    validateForMode(frontmatter, mode) {
+        if (mode === ExportMode.CREATE) {
+            // CREATE mode requires documentType
+            if (!frontmatter.documentType) {
+                throw new Error('CREATE mode: Missing required field "documentType" (must be story/task/bug/spike/epic)');
+            }
+            const validTypes = ['story', 'task', 'bug', 'spike', 'epic'];
+            const docType = String(frontmatter.documentType).toLowerCase();
+            if (!validTypes.includes(docType)) {
+                throw new Error(`CREATE mode: Invalid documentType "${String(frontmatter.documentType)}" (must be ${validTypes.join('/')})`);
+            }
+        }
+        else if (mode === ExportMode.UPDATE) {
+            // UPDATE mode requires valid jira-ticketId
+            const ticketId = frontmatter['jira-ticketId'];
+            if (!ticketId || ticketId === '' || ticketId === 'null') {
+                throw new Error('UPDATE mode: Missing or null "jira-ticketId" - use forceCreate to create new ticket');
+            }
+            // Validate ticket ID format (PROJECT-NNNN)
+            if (!/^[A-Z]+-\d+$/.test(String(ticketId))) {
+                throw new Error(`UPDATE mode: Invalid ticket ID format "${String(ticketId)}" (expected: PROJECT-NNNN like DAPM-1234)`);
+            }
+        }
+    }
+    /**
+     * Update local file with Jira metadata after CREATE
+     *
+     * @param filePath - Path to file
+     * @param issueKey - Jira issue key
+     * @param issueUrl - Jira issue URL
+     */
+    async updateLocalFileAfterCreate(filePath, issueKey, issueUrl) {
+        const exportDate = new Date().toISOString().split('T')[0]; // YYYY-MM-DD
+        await updateFrontmatter(filePath, {
+            'jira-ticketId': issueKey,
+            'jira-url': issueUrl,
+            exportedDate: exportDate,
+        });
+    }
+    /**
+     * Update local file with exportedDate after UPDATE
+     *
+     * @param filePath - Path to file
+     */
+    async updateLocalFileAfterUpdate(filePath) {
+        const exportDate = new Date().toISOString().split('T')[0]; // YYYY-MM-DD
+        await updateFrontmatter(filePath, {
+            exportedDate: exportDate,
+        });
+    }
+    /**
+     * Sleep for specified milliseconds
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=export-engine.js.map

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

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

package/dist/lib/jira/field-mapper.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Field Mapper - Maps between local YAML frontmatter and Jira API fields
+ *
+ * Provides bidirectional mapping with transformation functions for:
+ * - Type conversions (string ↔ object)
+ * - Format conversions (date formats, priority codes)
+ * - Field name mappings (local YAML keys ↔ Jira REST API paths)
+ *
+ * @module lib/jira/field-mapper
+ */
+/**
+ * Field mapping configuration
+ */
+export interface FieldMapping {
+    /** Local YAML frontmatter field name */
+    local: string;
+    /** Jira API field path (dot notation for nested fields) */
+    jira: string;
+    /** Transform local → Jira (optional) */
+    transform?: (value: unknown) => unknown;
+    /** Transform Jira → local (optional) */
+    reverseTransform?: (value: unknown) => unknown;
+}
+/**
+ * Field mappings configuration
+ *
+ * Maps local YAML frontmatter fields to Jira REST API field paths.
+ * Supports nested field access using dot notation (e.g., "issuetype.name").
+ */
+export declare const FIELD_MAPPINGS: FieldMapping[];
+/**
+ * Map local YAML frontmatter data to Jira API fields
+ *
+ * Converts local frontmatter fields to Jira REST API format with:
+ * - Field name mapping (local → Jira)
+ * - Type transformations (string → object for complex fields)
+ * - Value transformations (priority codes → names)
+ *
+ * @param localData - Local YAML frontmatter data
+ * @param mode - Export mode ('create' or 'update')
+ * @returns Jira API fields object
+ *
+ * @example
+ * ```typescript
+ * const local = {
+ *   title: "User authentication",
+ *   documentType: "story",
+ *   priority: "P1"
+ * };
+ *
+ * const jiraFields = mapLocalToJira(local, 'create');
+ * // {
+ * //   summary: "User authentication",
+ * //   issuetype: { name: "Story" },
+ * //   priority: { name: "High" }
+ * // }
+ * ```
+ */
+export declare function mapLocalToJira(localData: Record<string, unknown>, mode?: 'create' | 'update'): Record<string, unknown>;
+/**
+ * Map Jira API fields to local YAML frontmatter data
+ *
+ * Converts Jira REST API response to local frontmatter format with:
+ * - Field name mapping (Jira → local)
+ * - Type transformations (object → string for simple fields)
+ * - Value transformations (priority names → codes)
+ *
+ * @param jiraData - Jira API issue fields
+ * @returns Local YAML frontmatter data
+ *
+ * @example
+ * ```typescript
+ * const jiraIssue = {
+ *   key: "DAPM-1234",
+ *   fields: {
+ *     summary: "User authentication",
+ *     issuetype: { name: "Story" },
+ *     priority: { name: "High" }
+ *   }
+ * };
+ *
+ * const local = mapJiraToLocal(jiraIssue);
+ * // {
+ * //   jira-ticketId: "DAPM-1234",
+ * //   title: "User authentication",
+ * //   documentType: "story",
+ * //   priority: "P1"
+ * // }
+ * ```
+ */
+export declare function mapJiraToLocal(jiraData: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Merge labels and tags from local data
+ *
+ * Combines labels and tags fields, deduplicates, and returns as array.
+ *
+ * @param localData - Local YAML frontmatter data
+ * @returns Deduplicated array of labels
+ */
+export declare function mergeLabelsAndTags(localData: Record<string, unknown>): string[];
+//# sourceMappingURL=field-mapper.d.ts.map

package/dist/lib/jira/field-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-mapper.d.ts","sourceRoot":"","sources":["../../../src/lib/jira/field-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACxC,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CAChD;AAkDD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EA4GxC,CAAC;AA0DF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,IAAI,GAAE,QAAQ,GAAG,QAAmB,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkCzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkCzF;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAkB/E"}