cc-agentic-framework 1.14.1

package/dist/lib/jira/field-mapper.js

@@ -0,0 +1,346 @@
+/**
+ * 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
+ */
+/**
+ * Priority mapping from local codes to Jira names
+ */
+const PRIORITY_MAP = {
+    P0: 'Highest',
+    P1: 'High',
+    P2: 'Medium',
+    P3: 'Low',
+    P4: 'Lowest',
+    Highest: 'Highest',
+    High: 'High',
+    Medium: 'Medium',
+    Low: 'Low',
+    Lowest: 'Lowest',
+};
+/**
+ * Reverse priority mapping from Jira names to local codes
+ */
+const REVERSE_PRIORITY_MAP = {
+    Highest: 'P0',
+    High: 'P1',
+    Medium: 'P2',
+    Low: 'P3',
+    Lowest: 'P4',
+};
+/**
+ * Document type to Jira issue type mapping
+ */
+const ISSUE_TYPE_MAP = {
+    story: 'Story',
+    task: 'Task',
+    bug: 'Bug',
+    spike: 'Task',
+    epic: 'Epic',
+};
+/**
+ * Reverse issue type mapping from Jira to local
+ */
+const REVERSE_ISSUE_TYPE_MAP = {
+    Story: 'story',
+    Task: 'task',
+    Bug: 'bug',
+    Epic: 'epic',
+};
+/**
+ * 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 const FIELD_MAPPINGS = [
+    // Basic fields
+    {
+        local: 'title',
+        jira: 'summary',
+    },
+    {
+        local: 'jira-description',
+        jira: 'description',
+    },
+    {
+        local: 'jira-ticketId',
+        jira: 'key',
+    },
+    // Issue type (CREATE only, immutable)
+    {
+        local: 'documentType',
+        jira: 'issuetype.name',
+        transform: (value) => ISSUE_TYPE_MAP[String(value).toLowerCase()] || 'Story',
+        reverseTransform: (value) => REVERSE_ISSUE_TYPE_MAP[String(value)] || 'story',
+    },
+    // Project (CREATE only, immutable)
+    {
+        local: 'jira-project',
+        jira: 'project.key',
+    },
+    // Priority
+    {
+        local: 'priority',
+        jira: 'priority.name',
+        transform: (value) => PRIORITY_MAP[String(value)] || 'Medium',
+        reverseTransform: (value) => REVERSE_PRIORITY_MAP[String(value)] || String(value),
+    },
+    // Labels (combine labels and tags)
+    {
+        local: 'jira-labels',
+        jira: 'labels',
+        transform: (value) => {
+            const arr = Array.isArray(value) ? value : [value];
+            return arr.map((v) => String(v).trim());
+        },
+        reverseTransform: (value) => (Array.isArray(value) ? value : []),
+    },
+    // Component
+    {
+        local: 'jira-component',
+        jira: 'components',
+        transform: (value) => {
+            const components = Array.isArray(value) ? value : [value];
+            return components.map((name) => ({ name: String(name).trim() }));
+        },
+        reverseTransform: (value) => {
+            if (!value || !Array.isArray(value) || value.length === 0)
+                return null;
+            const components = value;
+            return components.length === 1 ? components[0].name : components.map((c) => c.name);
+        },
+    },
+    // Epic link
+    {
+        local: 'jira-parent',
+        jira: 'parent.key',
+    },
+    // Status
+    {
+        local: 'jira-status',
+        jira: 'status.name',
+    },
+    // Assignee
+    {
+        local: 'jira-assignee',
+        jira: 'assignee.emailAddress',
+    },
+    // Reporter
+    {
+        local: 'jira-reporter',
+        jira: 'reporter.emailAddress',
+    },
+    // Dates
+    {
+        local: 'jira-created',
+        jira: 'created',
+        transform: (value) => String(value),
+        reverseTransform: (value) => {
+            // Convert ISO datetime to date only
+            const strValue = String(value);
+            return strValue ? strValue.split('T')[0] : null;
+        },
+    },
+    {
+        local: 'jira-updated',
+        jira: 'updated',
+        transform: (value) => String(value),
+        reverseTransform: (value) => {
+            // Convert ISO datetime to date only
+            const strValue = String(value);
+            return strValue ? strValue.split('T')[0] : null;
+        },
+    },
+];
+/**
+ * Get a nested field value from an object using dot notation
+ *
+ * @param obj - Object to access
+ * @param path - Dot-separated path (e.g., "issuetype.name")
+ * @returns Field value or undefined
+ *
+ * @example
+ * ```typescript
+ * const obj = { issuetype: { name: "Story" } };
+ * getNestedField(obj, "issuetype.name"); // "Story"
+ * ```
+ */
+function getNestedField(obj, path) {
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined) {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * Set a nested field value in an object using dot notation
+ *
+ * @param obj - Object to modify
+ * @param path - Dot-separated path (e.g., "issuetype.name")
+ * @param value - Value to set
+ *
+ * @example
+ * ```typescript
+ * const obj = {};
+ * setNestedField(obj, "issuetype.name", "Story");
+ * // obj = { issuetype: { name: "Story" } }
+ * ```
+ */
+function setNestedField(obj, path, value) {
+    const parts = path.split('.');
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (!(part in current)) {
+            current[part] = {};
+        }
+        current = current[part];
+    }
+    current[parts[parts.length - 1]] = value;
+}
+/**
+ * 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 function mapLocalToJira(localData, mode = 'update') {
+    const jiraFields = {};
+    // Immutable fields only for CREATE mode
+    const immutableFields = ['documentType', 'jira-project'];
+    for (const mapping of FIELD_MAPPINGS) {
+        const { local, jira, transform } = mapping;
+        // Skip immutable fields in UPDATE mode
+        if (mode === 'update' && immutableFields.includes(local)) {
+            continue;
+        }
+        // Skip if local field doesn't exist
+        if (!(local in localData)) {
+            continue;
+        }
+        const localValue = localData[local];
+        // Skip null/undefined values
+        if (localValue === null || localValue === undefined) {
+            continue;
+        }
+        // Apply transformation if provided
+        const jiraValue = transform ? transform(localValue) : localValue;
+        // Set Jira field (handles nested paths)
+        setNestedField(jiraFields, jira, jiraValue);
+    }
+    return jiraFields;
+}
+/**
+ * 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 function mapJiraToLocal(jiraData) {
+    const localData = {};
+    // Handle top-level key field
+    if (jiraData.key) {
+        localData['jira-ticketId'] = jiraData.key;
+    }
+    // Extract fields from Jira issue structure
+    const fields = jiraData.fields || jiraData;
+    for (const mapping of FIELD_MAPPINGS) {
+        const { local, jira, reverseTransform } = mapping;
+        // Get Jira field value (handles nested paths)
+        const jiraValue = getNestedField(fields, jira);
+        // Skip if Jira field doesn't exist
+        if (jiraValue === null || jiraValue === undefined) {
+            continue;
+        }
+        // Apply reverse transformation if provided
+        const localValue = reverseTransform ? reverseTransform(jiraValue) : jiraValue;
+        // Skip null values after transformation
+        if (localValue === null || localValue === undefined) {
+            continue;
+        }
+        localData[local] = localValue;
+    }
+    return localData;
+}
+/**
+ * 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 function mergeLabelsAndTags(localData) {
+    const labels = new Set();
+    // Add from labels field
+    if (localData.labels) {
+        const labelList = Array.isArray(localData.labels)
+            ? localData.labels
+            : [localData.labels];
+        labelList.forEach((label) => labels.add(String(label).trim()));
+    }
+    // Add from tags field
+    if (localData.tags) {
+        const tagList = Array.isArray(localData.tags) ? localData.tags : [localData.tags];
+        tagList.forEach((tag) => labels.add(String(tag).trim()));
+    }
+    return Array.from(labels);
+}
+//# sourceMappingURL=field-mapper.js.map

package/dist/lib/jira/field-mapper.js.map

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

package/dist/lib/jira/jira-client.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Jira client configuration
+ */
+export interface JiraClientConfig {
+    baseUrl: string;
+    email: string;
+    apiToken: string;
+    delayMs?: number;
+}
+/**
+ * Jira issue representation
+ */
+export interface JiraIssue {
+    key: string;
+    id?: string;
+    self?: string;
+    fields: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Jira search results
+ */
+export interface JiraSearchResults {
+    issues: JiraIssue[];
+    startAt: number;
+    maxResults: number;
+    total: number;
+}
+/**
+ * Custom Jira API error class
+ */
+export declare class JiraApiError extends Error {
+    status?: number;
+    statusText?: string;
+    data?: unknown;
+    constructor(message: string, status?: number, statusText?: string, data?: unknown);
+}
+/**
+ * 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 declare class JiraClient {
+    private axiosInstance;
+    private config;
+    private lastRequestTime;
+    private readonly MAX_RETRIES;
+    private readonly DEFAULT_RETRY_DELAY;
+    constructor(config: JiraClientConfig);
+    /**
+     * Enforce rate limiting delay between requests
+     */
+    private enforceRateLimit;
+    /**
+     * Sleep for specified milliseconds
+     */
+    private sleep;
+    /**
+     * Handle API errors and convert to JiraApiError
+     */
+    private handleError;
+    /**
+     * Determine if an error is retryable (429 rate limit)
+     */
+    private isRetryableError;
+    /**
+     * Get retry delay from response headers or use default
+     */
+    private getRetryDelay;
+    /**
+     * Execute request with retry logic for rate limiting
+     */
+    private executeWithRetry;
+    /**
+     * 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
+     */
+    createIssue(fields: Record<string, unknown>): Promise<string>;
+    /**
+     * 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
+     */
+    updateIssue(issueKey: string, fields: Record<string, unknown>): Promise<void>;
+    /**
+     * 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
+     */
+    getIssue(issueKey: string, expand?: string[]): Promise<JiraIssue>;
+    /**
+     * 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
+     */
+    searchIssues(jql: string, startAt?: number, maxResults?: number, fields?: string[]): Promise<JiraSearchResults>;
+}
+//# sourceMappingURL=jira-client.d.ts.map

package/dist/lib/jira/jira-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-client.d.ts","sourceRoot":"","sources":["../../../src/lib/jira/jira-client.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAOlF;AAED;;;;;;;;;;GAUG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAK;IACjC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAQ;gBAEhC,MAAM,EAAE,gBAAgB;IAkCpC;;OAEG;YACW,gBAAgB;IAgB9B;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,WAAW;IA2CnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAmBrB;;OAEG;YACW,gBAAgB;IAsB9B;;;;;;OAMG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBnE;;;;;;OAMG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBnF;;;;;;;OAOG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAmBvE;;;;;;;;;OASG;IACG,YAAY,CAChB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAU,EACnB,UAAU,GAAE,MAAW,EACvB,MAAM,CAAC,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,iBAAiB,CAAC;CAuB9B"}