cc-agentic-framework 1.14.1

package/dist/lib/global-skills-manager.js

@@ -0,0 +1,180 @@
+import fs from "fs-extra";
+import path from "path";
+import os from "os";
+/**
+ * Manages global skills deployed to ~/.claude/skills/
+ * Handles deployment, removal, and tracking of globally available skills
+ */
+export class GlobalSkillsManager {
+    manifestFileName = ".global-skills-manifest.json";
+    /**
+     * Get the path to the global skills directory (~/.claude/skills/)
+     * @returns Absolute path to global skills directory
+     */
+    static getGlobalSkillsPath() {
+        return path.join(os.homedir(), ".claude", "skills");
+    }
+    /**
+     * Ensure the global skills directory exists
+     * Creates ~/.claude/skills/ if it doesn't exist
+     */
+    async ensureGlobalSkillsDir() {
+        const globalSkillsPath = GlobalSkillsManager.getGlobalSkillsPath();
+        try {
+            await fs.ensureDir(globalSkillsPath);
+        }
+        catch (error) {
+            throw new Error(`Failed to create global skills directory at ${globalSkillsPath}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        }
+    }
+    /**
+     * Get the full path to the global skills manifest
+     * @returns Absolute path to .global-skills-manifest.json
+     */
+    getManifestPath() {
+        return path.join(GlobalSkillsManager.getGlobalSkillsPath(), this.manifestFileName);
+    }
+    /**
+     * Read the global skills manifest
+     * Creates an empty manifest if it doesn't exist
+     * @returns The parsed GlobalSkillsManifest
+     */
+    async readManifest() {
+        const manifestPath = this.getManifestPath();
+        // Create empty manifest if it doesn't exist
+        if (!(await fs.pathExists(manifestPath))) {
+            const emptyManifest = {
+                version: "1.0.0",
+                skills: {},
+                updatedAt: new Date().toISOString(),
+            };
+            await this.writeManifest(emptyManifest);
+            return emptyManifest;
+        }
+        try {
+            const manifest = (await fs.readJson(manifestPath));
+            return manifest;
+        }
+        catch (error) {
+            throw new Error(`Failed to parse global skills manifest at ${manifestPath}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        }
+    }
+    /**
+     * Write the global skills manifest to disk
+     * @param manifest - The GlobalSkillsManifest to write
+     * @throws Error if write operation fails
+     */
+    async writeManifest(manifest) {
+        const manifestPath = this.getManifestPath();
+        try {
+            await this.ensureGlobalSkillsDir();
+            await fs.writeJson(manifestPath, manifest, { spaces: 2 });
+        }
+        catch (error) {
+            throw new Error(`Failed to write global skills manifest to ${manifestPath}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        }
+    }
+    /**
+     * Deploy a skill directory from source to global location
+     * @param sourcePath - Full path to source skill directory
+     * @param skillId - Unique skill identifier
+     * @param metadata - Skill metadata (description, module, etc.)
+     * @throws Error if deployment fails
+     */
+    async deploySkill(sourcePath, skillId, metadata) {
+        // Validate source path exists
+        if (!(await fs.pathExists(sourcePath))) {
+            throw new Error(`Source skill directory not found: ${sourcePath}`);
+        }
+        const stats = await fs.stat(sourcePath);
+        if (!stats.isDirectory()) {
+            throw new Error(`Source path is not a directory: ${sourcePath}`);
+        }
+        // Ensure global skills directory exists
+        await this.ensureGlobalSkillsDir();
+        // Destination path
+        const globalSkillsPath = GlobalSkillsManager.getGlobalSkillsPath();
+        const destPath = path.join(globalSkillsPath, skillId);
+        try {
+            // Copy skill directory, filtering out .DS_Store files
+            await fs.copy(sourcePath, destPath, {
+                overwrite: true,
+                filter: (src) => {
+                    return !src.endsWith(".DS_Store");
+                },
+            });
+            // Update manifest
+            const manifest = await this.readManifest();
+            const now = new Date().toISOString();
+            const skillInfo = {
+                id: skillId,
+                name: metadata.name || skillId,
+                description: metadata.description || "",
+                scope: metadata.scope || "shared",
+                deployedAt: now,
+                deployedFrom: metadata.deployedFrom || "",
+                sourceModule: metadata.sourceModule || "",
+                version: metadata.version,
+                capabilities: metadata.capabilities,
+            };
+            manifest.skills[skillId] = skillInfo;
+            manifest.updatedAt = now;
+            await this.writeManifest(manifest);
+        }
+        catch (error) {
+            throw new Error(`Failed to deploy skill ${skillId} from ${sourcePath} to ${destPath}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        }
+    }
+    /**
+     * Remove a skill from the global location
+     * @param skillId - Unique skill identifier
+     * @throws Error if removal fails
+     */
+    async removeSkill(skillId) {
+        const globalSkillsPath = GlobalSkillsManager.getGlobalSkillsPath();
+        const skillPath = path.join(globalSkillsPath, skillId);
+        // Check if skill exists
+        if (!(await fs.pathExists(skillPath))) {
+            throw new Error(`Global skill not found: ${skillId} at ${skillPath}`);
+        }
+        try {
+            // Remove skill directory
+            await fs.remove(skillPath);
+            // Update manifest
+            const manifest = await this.readManifest();
+            delete manifest.skills[skillId];
+            manifest.updatedAt = new Date().toISOString();
+            await this.writeManifest(manifest);
+        }
+        catch (error) {
+            throw new Error(`Failed to remove global skill ${skillId} from ${skillPath}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        }
+    }
+    /**
+     * List all global skills
+     * @returns Array of GlobalSkillInfo for all deployed skills
+     */
+    async listSkills() {
+        const manifest = await this.readManifest();
+        return Object.values(manifest.skills);
+    }
+    /**
+     * Check if a skill exists in the global location
+     * @param skillId - Unique skill identifier
+     * @returns True if skill exists, false otherwise
+     */
+    async skillExists(skillId) {
+        const manifest = await this.readManifest();
+        return skillId in manifest.skills;
+    }
+    /**
+     * Get information about a specific global skill
+     * @param skillId - Unique skill identifier
+     * @returns GlobalSkillInfo if skill exists, null otherwise
+     */
+    async getSkillInfo(skillId) {
+        const manifest = await this.readManifest();
+        return manifest.skills[skillId] || null;
+    }
+}
+//# sourceMappingURL=global-skills-manager.js.map

package/dist/lib/global-skills-manager.js.map

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

package/dist/lib/jira/acceptance-criteria.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Acceptance Criteria Extractor and Formatter
+ *
+ * Extracts acceptance criteria from markdown and formats for Jira.
+ * Supports both Jira wiki markup and ADF (Atlassian Document Format).
+ *
+ * Based on: modules/jira/src/jira/export_to_jira.py
+ */
+/**
+ * ADF (Atlassian Document Format) types
+ */
+export interface AdfDocument {
+    version: number;
+    type: 'doc';
+    content: AdfNode[];
+}
+export interface AdfNode {
+    type: string;
+    content?: AdfNode[];
+    text?: string;
+    marks?: AdfMark[];
+}
+export interface AdfMark {
+    type: string;
+}
+/**
+ * Extract acceptance criteria from markdown body.
+ *
+ * Looks for "## Acceptance Criteria" section and extracts all "Verify" lines.
+ *
+ * Supports formats:
+ * - - *Verify* text
+ * - - **Verify** text
+ * - - Verify text
+ * - * Verify text
+ *
+ * @param markdown - The markdown content to parse
+ * @returns Array of criteria text (without "Verify" prefix)
+ */
+export declare function extractAcceptanceCriteria(markdown: string): string[];
+/**
+ * Format acceptance criteria as Jira wiki markup bullet list.
+ *
+ * Format: * *Verify* criterion text (asterisk for bullet, asterisks for italic)
+ *
+ * @param criteria - Array of criteria text (without "Verify" prefix)
+ * @returns Wiki markup string with formatted bullets
+ */
+export declare function formatAsJiraWiki(criteria: string[]): string;
+/**
+ * Format acceptance criteria as ADF (Atlassian Document Format).
+ *
+ * Creates a bullet list with "Verify" prefix in italics.
+ *
+ * @param criteria - Array of criteria text (without "Verify" prefix)
+ * @returns ADF document structure
+ */
+export declare function formatAsAdf(criteria: string[]): AdfDocument;
+/**
+ * Parse existing Jira AC field content.
+ *
+ * Extracts criteria from Jira wiki markup or plain text format.
+ *
+ * Supports:
+ * - * *Verify* text
+ * - * **Verify** text
+ * - * Verify text
+ * - - *Verify* text
+ * - - **Verify** text
+ * - - Verify text
+ *
+ * @param jiraAc - Jira AC field content (wiki markup or plain text)
+ * @returns Array of criteria text (without "Verify" prefix)
+ */
+export declare function parseJiraAcField(jiraAc: string | null | undefined): string[];
+//# sourceMappingURL=acceptance-criteria.d.ts.map

package/dist/lib/jira/acceptance-criteria.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acceptance-criteria.d.ts","sourceRoot":"","sources":["../../../src/lib/jira/acceptance-criteria.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,KAAK,CAAC;IACZ,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAyCpE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAe3D;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,CA+B3D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAmC5E"}

package/dist/lib/jira/acceptance-criteria.js

@@ -0,0 +1,163 @@
+/**
+ * Acceptance Criteria Extractor and Formatter
+ *
+ * Extracts acceptance criteria from markdown and formats for Jira.
+ * Supports both Jira wiki markup and ADF (Atlassian Document Format).
+ *
+ * Based on: modules/jira/src/jira/export_to_jira.py
+ */
+/**
+ * Extract acceptance criteria from markdown body.
+ *
+ * Looks for "## Acceptance Criteria" section and extracts all "Verify" lines.
+ *
+ * Supports formats:
+ * - - *Verify* text
+ * - - **Verify** text
+ * - - Verify text
+ * - * Verify text
+ *
+ * @param markdown - The markdown content to parse
+ * @returns Array of criteria text (without "Verify" prefix)
+ */
+export function extractAcceptanceCriteria(markdown) {
+    const criteria = [];
+    // Find acceptance criteria section (case-insensitive)
+    const acSectionPattern = /##\s+Acceptance Criteria.*?(?=\n##|$)/is;
+    const match = markdown.match(acSectionPattern);
+    if (!match) {
+        return criteria;
+    }
+    const acSection = match[0];
+    // Split into lines and process each line
+    const lines = acSection.split('\n');
+    for (const line of lines) {
+        // Try to match different Verify formats
+        // Pattern 1: - **Verify** text or * **Verify** text
+        let criterionMatch = line.match(/^[\s]*[-*]\s+\*\*Verify\*\*\s+(.+)$/i);
+        if (criterionMatch) {
+            criteria.push(criterionMatch[1].trim());
+            continue;
+        }
+        // Pattern 2: - *Verify* text or * *Verify* text
+        criterionMatch = line.match(/^[\s]*[-*]\s+\*Verify\*\s+(.+)$/i);
+        if (criterionMatch) {
+            criteria.push(criterionMatch[1].trim());
+            continue;
+        }
+        // Pattern 3: - Verify text or * Verify text
+        criterionMatch = line.match(/^[\s]*[-*]\s+Verify\s+(.+)$/i);
+        if (criterionMatch) {
+            criteria.push(criterionMatch[1].trim());
+            continue;
+        }
+    }
+    return criteria;
+}
+/**
+ * Format acceptance criteria as Jira wiki markup bullet list.
+ *
+ * Format: * *Verify* criterion text (asterisk for bullet, asterisks for italic)
+ *
+ * @param criteria - Array of criteria text (without "Verify" prefix)
+ * @returns Wiki markup string with formatted bullets
+ */
+export function formatAsJiraWiki(criteria) {
+    if (criteria.length === 0) {
+        return '';
+    }
+    const lines = [];
+    for (const criterion of criteria) {
+        // Format: * *Verify* text
+        // * = bullet point
+        // *Verify* = italicized "Verify"
+        lines.push(`* *Verify* ${criterion}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format acceptance criteria as ADF (Atlassian Document Format).
+ *
+ * Creates a bullet list with "Verify" prefix in italics.
+ *
+ * @param criteria - Array of criteria text (without "Verify" prefix)
+ * @returns ADF document structure
+ */
+export function formatAsAdf(criteria) {
+    const listItems = criteria.map((criterion) => ({
+        type: 'listItem',
+        content: [
+            {
+                type: 'paragraph',
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Verify ',
+                        marks: [{ type: 'em' }],
+                    },
+                    {
+                        type: 'text',
+                        text: criterion,
+                    },
+                ],
+            },
+        ],
+    }));
+    return {
+        version: 1,
+        type: 'doc',
+        content: [
+            {
+                type: 'bulletList',
+                content: listItems,
+            },
+        ],
+    };
+}
+/**
+ * Parse existing Jira AC field content.
+ *
+ * Extracts criteria from Jira wiki markup or plain text format.
+ *
+ * Supports:
+ * - * *Verify* text
+ * - * **Verify** text
+ * - * Verify text
+ * - - *Verify* text
+ * - - **Verify** text
+ * - - Verify text
+ *
+ * @param jiraAc - Jira AC field content (wiki markup or plain text)
+ * @returns Array of criteria text (without "Verify" prefix)
+ */
+export function parseJiraAcField(jiraAc) {
+    if (!jiraAc || jiraAc.trim() === '') {
+        return [];
+    }
+    const criteria = [];
+    // Split into lines and process each line
+    const lines = jiraAc.split('\n');
+    for (const line of lines) {
+        // Try to match different Verify formats
+        // Pattern 1: - **Verify** text or * **Verify** text
+        let criterionMatch = line.match(/^[\s]*[-*]\s+\*\*Verify\*\*\s+(.+)$/i);
+        if (criterionMatch) {
+            criteria.push(criterionMatch[1].trim());
+            continue;
+        }
+        // Pattern 2: - *Verify* text or * *Verify* text
+        criterionMatch = line.match(/^[\s]*[-*]\s+\*Verify\*\s+(.+)$/i);
+        if (criterionMatch) {
+            criteria.push(criterionMatch[1].trim());
+            continue;
+        }
+        // Pattern 3: - Verify text or * Verify text
+        criterionMatch = line.match(/^[\s]*[-*]\s+Verify\s+(.+)$/i);
+        if (criterionMatch) {
+            criteria.push(criterionMatch[1].trim());
+            continue;
+        }
+    }
+    return criteria;
+}
+//# sourceMappingURL=acceptance-criteria.js.map

package/dist/lib/jira/acceptance-criteria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acceptance-criteria.js","sourceRoot":"","sources":["../../../src/lib/jira/acceptance-criteria.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsBH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACxD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,sDAAsD;IACtD,MAAM,gBAAgB,GAAG,yCAAyC,CAAC;IACnE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAE/C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAE3B,yCAAyC;IACzC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,wCAAwC;QACxC,oDAAoD;QACpD,IAAI,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACxE,IAAI,cAAc,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACxC,SAAS;QACX,CAAC;QAED,gDAAgD;QAChD,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAChE,IAAI,cAAc,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACxC,SAAS;QACX,CAAC;QAED,4CAA4C;QAC5C,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC5D,IAAI,cAAc,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACxC,SAAS;QACX,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAkB;IACjD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;QACjC,0BAA0B;QAC1B,mBAAmB;QACnB,iCAAiC;QACjC,KAAK,CAAC,IAAI,CAAC,cAAc,SAAS,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,QAAkB;IAC5C,MAAM,SAAS,GAAc,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACxD,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,SAAS;wBACf,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;qBACxB;oBACD;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,SAAS;qBAChB;iBACF;aACF;SACF;KACF,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,KAAK;QACX,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,SAAS;aACnB;SACF;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAiC;IAChE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACpC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,yCAAyC;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,wCAAwC;QACxC,oDAAoD;QACpD,IAAI,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACxE,IAAI,cAAc,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACxC,SAAS;QACX,CAAC;QAED,gDAAgD;QAChD,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAChE,IAAI,cAAc,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACxC,SAAS;QACX,CAAC;QAED,4CAA4C;QAC5C,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC5D,IAAI,cAAc,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACxC,SAAS;QACX,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,132 @@
+import { JiraClient } from './jira-client.js';
+/**
+ * Export mode: CREATE or UPDATE
+ */
+export declare enum ExportMode {
+    CREATE = "create",
+    UPDATE = "update"
+}
+/**
+ * Options for exporting tickets
+ */
+export interface ExportOptions {
+    /** Dry-run mode: validate without making API calls */
+    dryRun?: boolean;
+    /** Force CREATE mode (override auto-detection) */
+    forceCreate?: boolean;
+    /** Force UPDATE mode (override auto-detection) */
+    forceUpdate?: boolean;
+    /** Delay between batch exports in milliseconds */
+    delayMs?: number;
+}
+/**
+ * Result of exporting a ticket
+ */
+export interface ExportResult {
+    /** Whether the export was successful */
+    success: boolean;
+    /** Export mode used (CREATE or UPDATE) */
+    mode: ExportMode;
+    /** Jira issue key (e.g., DAPM-1234) */
+    issueKey?: string;
+    /** Jira issue URL */
+    issueUrl?: string;
+    /** Number of acceptance criteria exported */
+    criteriaCount?: number;
+    /** File path that was exported */
+    filePath: string;
+    /** Whether this was a dry run */
+    dryRun?: boolean;
+    /** Error message if export failed */
+    error?: string;
+}
+/**
+ * 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 declare class ExportEngine {
+    private jiraClient;
+    private wikiConverter;
+    private baseUrl;
+    constructor(jiraClient: JiraClient, baseUrl?: string);
+    /**
+     * 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: Record<string, unknown>): ExportMode;
+    /**
+     * 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: Record<string, unknown>, description: string, mode: ExportMode): Record<string, unknown>;
+    /**
+     * 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
+     */
+    exportTicket(filePath: string, options?: ExportOptions): Promise<ExportResult>;
+    /**
+     * 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
+     */
+    batchExport(filePaths: string[], options?: ExportOptions): Promise<ExportResult[]>;
+    /**
+     * Validate frontmatter for mode-specific requirements
+     *
+     * @param frontmatter - Parsed frontmatter data
+     * @param mode - Export mode
+     * @throws Error if validation fails
+     */
+    private validateForMode;
+    /**
+     * Update local file with Jira metadata after CREATE
+     *
+     * @param filePath - Path to file
+     * @param issueKey - Jira issue key
+     * @param issueUrl - Jira issue URL
+     */
+    private updateLocalFileAfterCreate;
+    /**
+     * Update local file with exportedDate after UPDATE
+     *
+     * @param filePath - Path to file
+     */
+    private updateLocalFileAfterUpdate;
+    /**
+     * Sleep for specified milliseconds
+     */
+    private sleep;
+}
+//# sourceMappingURL=export-engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export-engine.d.ts","sourceRoot":"","sources":["../../../src/lib/jira/export-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAM9C;;GAEG;AACH,oBAAY,UAAU;IACpB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kDAAkD;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,IAAI,EAAE,UAAU,CAAC;IACjB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAkCD;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY;IAIX,OAAO,CAAC,UAAU;IAH9B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,OAAO,CAAS;gBAEJ,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM;IAM5D;;;;;;;;OAQG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU;IAY5D;;;;;;;;;;OAUG;IACH,eAAe,CACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,UAAU,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAgD1B;;;;;;;;;OASG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IA0GxF;;;;;;;;;OASG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA4B5F;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAmCvB;;;;;;OAMG;YACW,0BAA0B;IAcxC;;;;OAIG;YACW,0BAA0B;IAQxC;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}