cc-agentic-framework 1.14.1

package/dist/lib/jira/jira-client.js

@@ -0,0 +1,255 @@
+import axios from 'axios';
+/**
+ * Custom Jira API error class
+ */
+export class JiraApiError extends Error {
+    status;
+    statusText;
+    data;
+    constructor(message, status, statusText, data) {
+        super(message);
+        this.name = 'JiraApiError';
+        this.status = status;
+        this.statusText = statusText;
+        this.data = data;
+    }
+}
+/**
+ * Jira API client for interacting with Jira REST API v2
+ *
+ * Features:
+ * - Basic Authentication with email and API token
+ * - CRUD operations on issues
+ * - JQL search support
+ * - Rate limiting with configurable delay
+ * - Automatic retry on 429 (rate limit) responses
+ * - Error handling for 401, 404, 400, and 500 errors
+ */
+export class JiraClient {
+    axiosInstance;
+    config;
+    lastRequestTime = 0;
+    MAX_RETRIES = 3;
+    DEFAULT_RETRY_DELAY = 1000; // 1 second
+    constructor(config) {
+        // Validate required config
+        if (!config.baseUrl) {
+            throw new Error('JiraClientConfig: baseUrl is required');
+        }
+        if (!config.email) {
+            throw new Error('JiraClientConfig: email is required');
+        }
+        if (!config.apiToken) {
+            throw new Error('JiraClientConfig: apiToken is required');
+        }
+        this.config = {
+            ...config,
+            baseUrl: config.baseUrl.replace(/\/$/, ''), // Strip trailing slash
+        };
+        // Create axios instance with Jira-specific configuration
+        const axiosConfig = {
+            baseURL: this.config.baseUrl,
+            timeout: 30000, // 30 seconds
+            auth: {
+                username: this.config.email,
+                password: this.config.apiToken,
+            },
+            headers: {
+                'Content-Type': 'application/json',
+                'Accept': 'application/json',
+            },
+        };
+        this.axiosInstance = axios.create(axiosConfig);
+    }
+    /**
+     * Enforce rate limiting delay between requests
+     */
+    async enforceRateLimit() {
+        if (!this.config.delayMs || this.config.delayMs <= 0) {
+            return;
+        }
+        const now = Date.now();
+        const timeSinceLastRequest = now - this.lastRequestTime;
+        if (timeSinceLastRequest < this.config.delayMs) {
+            const waitTime = this.config.delayMs - timeSinceLastRequest;
+            await this.sleep(waitTime);
+        }
+        this.lastRequestTime = Date.now();
+    }
+    /**
+     * Sleep for specified milliseconds
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Handle API errors and convert to JiraApiError
+     */
+    handleError(error) {
+        const isAxiosLike = axios.isAxiosError(error) || error.isAxiosError === true;
+        if (isAxiosLike) {
+            const axiosError = error;
+            // Handle timeout errors
+            if (axiosError.code === 'ECONNABORTED') {
+                throw new JiraApiError('Request timeout');
+            }
+            // Handle network errors
+            if (axiosError.code === 'ENOTFOUND' || axiosError.code === 'ECONNREFUSED') {
+                throw new JiraApiError('Network error');
+            }
+            // Handle response errors
+            if (axiosError.response) {
+                const { status, statusText, data } = axiosError.response;
+                let message = statusText || 'Request failed';
+                // Extract error message from Jira response
+                if (data) {
+                    const errorData = data;
+                    if (errorData.errorMessages && Array.isArray(errorData.errorMessages)) {
+                        message = errorData.errorMessages.join(', ');
+                    }
+                    else if (errorData.message) {
+                        message = errorData.message;
+                    }
+                }
+                throw new JiraApiError(message, status, statusText, data);
+            }
+            // Handle request errors
+            throw new JiraApiError(axiosError.message);
+        }
+        // Handle non-axios errors
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        throw new JiraApiError(errorMessage);
+    }
+    /**
+     * Determine if an error is retryable (429 rate limit)
+     */
+    isRetryableError(error) {
+        const isAxiosLike = axios.isAxiosError(error) || error.isAxiosError === true;
+        if (!isAxiosLike) {
+            return false;
+        }
+        const axiosError = error;
+        if (!axiosError.response) {
+            return false;
+        }
+        const status = axiosError.response.status;
+        // Only retry on rate limit (429)
+        return status === 429;
+    }
+    /**
+     * Get retry delay from response headers or use default
+     */
+    getRetryDelay(error) {
+        const isAxiosLike = axios.isAxiosError(error) || error.isAxiosError === true;
+        if (isAxiosLike) {
+            const axiosError = error;
+            if (axiosError.response?.headers) {
+                const retryAfter = axiosError.response.headers['retry-after'];
+                if (retryAfter) {
+                    const seconds = parseInt(retryAfter, 10);
+                    if (!isNaN(seconds)) {
+                        return seconds * 1000; // Convert to milliseconds
+                    }
+                }
+            }
+        }
+        return this.DEFAULT_RETRY_DELAY;
+    }
+    /**
+     * Execute request with retry logic for rate limiting
+     */
+    async executeWithRetry(requestFn, attempt = 0) {
+        try {
+            return await requestFn();
+        }
+        catch (error) {
+            const shouldRetry = this.isRetryableError(error);
+            if (shouldRetry && attempt < this.MAX_RETRIES) {
+                const delay = this.getRetryDelay(error);
+                await this.sleep(delay);
+                // Retry the request
+                return this.executeWithRetry(requestFn, attempt + 1);
+            }
+            // No more retries or non-retryable error
+            this.handleError(error);
+        }
+    }
+    /**
+     * Create a new Jira issue
+     *
+     * @param fields - Issue fields (project, summary, description, issuetype, etc.)
+     * @returns Issue key (e.g., "PROJ-123")
+     * @throws JiraApiError on failure
+     */
+    async createIssue(fields) {
+        await this.enforceRateLimit();
+        return this.executeWithRetry(async () => {
+            const response = await this.axiosInstance.post('/rest/api/2/issue', { fields }, {});
+            if (response.status !== 201) {
+                throw new JiraApiError(`Failed to create issue: HTTP ${response.status}`, response.status);
+            }
+            return response.data.key;
+        });
+    }
+    /**
+     * Update an existing Jira issue
+     *
+     * @param issueKey - Issue key (e.g., "PROJ-123")
+     * @param fields - Fields to update (summary, description, etc.)
+     * @throws JiraApiError on failure
+     */
+    async updateIssue(issueKey, fields) {
+        await this.enforceRateLimit();
+        return this.executeWithRetry(async () => {
+            const response = await this.axiosInstance.put(`/rest/api/2/issue/${issueKey}`, { fields }, {});
+            if (response.status !== 200 && response.status !== 204) {
+                throw new JiraApiError(`Failed to update issue ${issueKey}: HTTP ${response.status}`, response.status);
+            }
+        });
+    }
+    /**
+     * Get a Jira issue by key
+     *
+     * @param issueKey - Issue key (e.g., "PROJ-123")
+     * @param expand - Optional fields to expand (e.g., ["changelog", "renderedFields"])
+     * @returns Jira issue object
+     * @throws JiraApiError on failure
+     */
+    async getIssue(issueKey, expand) {
+        await this.enforceRateLimit();
+        return this.executeWithRetry(async () => {
+            const params = {};
+            if (expand && expand.length > 0) {
+                params.expand = expand.join(',');
+            }
+            const response = await this.axiosInstance.get(`/rest/api/2/issue/${issueKey}`, { params });
+            return response.data;
+        });
+    }
+    /**
+     * Search for Jira issues using JQL (Jira Query Language)
+     *
+     * @param jql - JQL query string (e.g., 'project = PROJ AND status = "To Do"')
+     * @param startAt - Starting index for pagination (default: 0)
+     * @param maxResults - Maximum results to return (default: 50)
+     * @param fields - Optional list of fields to return
+     * @returns Search results with issues array and pagination info
+     * @throws JiraApiError on failure
+     */
+    async searchIssues(jql, startAt = 0, maxResults = 50, fields) {
+        await this.enforceRateLimit();
+        return this.executeWithRetry(async () => {
+            const payload = {
+                jql,
+                startAt,
+                maxResults,
+            };
+            if (fields && fields.length > 0) {
+                payload.fields = fields;
+            }
+            const response = await this.axiosInstance.post('/rest/api/2/search', payload, {});
+            return response.data;
+        });
+    }
+}
+//# sourceMappingURL=jira-client.js.map

package/dist/lib/jira/jira-client.js.map

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

package/dist/lib/jira/sync-engine.d.ts

@@ -0,0 +1,154 @@
+/**
+ * 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 { JiraClient } from './jira-client.js';
+/**
+ * Sync mode types
+ */
+export type SyncMode = 'create' | 'update' | 'download';
+/**
+ * Field change tracking
+ */
+export interface FieldChange {
+    /** Field name */
+    field: string;
+    /** Old value (before sync) */
+    oldValue: unknown;
+    /** New value (after sync) */
+    newValue: unknown;
+}
+/**
+ * Conflict information
+ */
+export interface Conflict {
+    /** Field name with conflict */
+    field: string;
+    /** Local value */
+    localValue: unknown;
+    /** Remote (Jira) value */
+    remoteValue: unknown;
+    /** Resolution strategy */
+    resolution: 'local' | 'remote' | 'manual';
+}
+/**
+ * Sync result
+ */
+export interface SyncResult {
+    /** Whether sync was successful */
+    success: boolean;
+    /** Sync mode used */
+    mode: SyncMode;
+    /** Source path/key */
+    source: string;
+    /** Destination path/key */
+    destination: string;
+    /** List of field changes made */
+    changes: FieldChange[];
+    /** Conflicts detected (if any) */
+    conflicts?: Conflict[];
+    /** Error message (if failed) */
+    error?: string;
+    /** Whether this was a dry run */
+    dryRun?: boolean;
+}
+/**
+ * Sync options
+ */
+export interface SyncOptions {
+    /** Dry-run mode: preview without making changes */
+    dryRun?: boolean;
+    /** Force sync without conflict check */
+    force?: boolean;
+    /** Conflict resolution strategy */
+    conflictResolution?: 'local' | 'remote' | 'ask';
+}
+/**
+ * Sync Engine - Orchestrates bidirectional sync between local and Jira
+ */
+export declare class SyncEngine {
+    private jiraClient;
+    private wikiConverter;
+    private baseUrl;
+    constructor(jiraClient: JiraClient, baseUrl?: string);
+    /**
+     * Sync local ticket to Jira (CREATE or UPDATE mode)
+     *
+     * @param filePath - Path to local markdown ticket
+     * @param options - Sync options
+     * @returns Sync result
+     */
+    syncToJira(filePath: string, options?: SyncOptions): Promise<SyncResult>;
+    /**
+     * 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
+     */
+    syncFromJira(jiraKey: string, outputPath: string, options?: SyncOptions): Promise<SyncResult>;
+    /**
+     * 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
+     */
+    detectConflicts(filePath: string, jiraKey: string): Promise<Conflict[]>;
+    /**
+     * 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
+     */
+    private detectConflictsFromJira;
+    /**
+     * 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
+     */
+    private compareFields;
+    /**
+     * Compare two values for equality (handles arrays and objects)
+     *
+     * @param a - First value
+     * @param b - Second value
+     * @returns True if equal
+     */
+    private valuesEqual;
+}
+/**
+ * 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 declare function syncToJira(filePath: string, jiraClient: JiraClient, options?: SyncOptions): Promise<SyncResult>;
+/**
+ * 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 declare function syncFromJira(jiraKey: string, outputPath: string, jiraClient: JiraClient, options?: SyncOptions): Promise<SyncResult>;
+//# sourceMappingURL=sync-engine.d.ts.map

package/dist/lib/jira/sync-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-engine.d.ts","sourceRoot":"","sources":["../../../src/lib/jira/sync-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAa,MAAM,kBAAkB,CAAC;AAQzD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,6BAA6B;IAC7B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,0BAA0B;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,0BAA0B;IAC1B,UAAU,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,IAAI,EAAE,QAAQ,CAAC;IACf,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,kCAAkC;IAClC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mCAAmC;IACnC,kBAAkB,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;CACjD;AAOD;;GAEG;AACH,qBAAa,UAAU;IAIT,OAAO,CAAC,UAAU;IAH9B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,OAAO,CAAS;gBAEJ,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM;IAK5D;;;;;;OAMG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IA2LlF;;;;;;;OAOG;IACG,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC;IAkFtB;;;;;;;;;OASG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAmB7E;;;;;;OAMG;YACW,uBAAuB;IAqBrC;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IA0CrB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;CAyBpB;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAGrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAGrB"}