@ameshkin/ticket-mate 0.1.20

package/public/utils/bug-reporter.js

@@ -0,0 +1,189 @@
+/**
+ * Bug Reporter for Orchestrator Integration
+ *
+ * When encountering bugs, automatically reports them to orchestrator API
+ * and stores results in a todo folder for later review.
+ */
+import { reportToOrchestrator, isOrchestratorEnabled, getOrchestratorConfig } from "../integrations/orchestrator-client";
+import { getErrorMessage } from "../types/common";
+import { mkdir, writeFile } from "fs/promises";
+import { join } from "path";
+import { logger } from "./logger";
+/**
+ * Report a bug to orchestrator and save to todo folder
+ */
+export async function reportBug(error, context = {}, severity = "medium") {
+    const bugId = `bug-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+    const timestamp = new Date().toISOString();
+    const errorDetails = typeof error === "string"
+        ? { message: error, name: "Error" }
+        : {
+            message: getErrorMessage(error),
+            stack: error instanceof Error ? error.stack : undefined,
+            name: error instanceof Error ? error.name : "Error",
+        };
+    const bugReport = {
+        id: bugId,
+        timestamp,
+        error: errorDetails,
+        context,
+        severity,
+        status: "pending",
+    };
+    try {
+        // Check if orchestrator is enabled
+        if (!isOrchestratorEnabled()) {
+            logger.warn("Orchestrator not enabled, saving bug report locally only", { bugId });
+            bugReport.status = "failed";
+            bugReport.context.orchestratorError = "Orchestrator not enabled";
+        }
+        else {
+            // Attempt to report to orchestrator
+            try {
+                const orchestratorConfig = getOrchestratorConfig();
+                const reportPayload = {
+                    success: false,
+                    error: errorDetails.message,
+                    details: {
+                        type: "bug",
+                        timestamp,
+                        error: errorDetails,
+                        context,
+                        severity,
+                        source: "ticket-mate",
+                    },
+                };
+                logger.info("Reporting bug to orchestrator", { bugId, severity });
+                const response = await reportToOrchestrator(bugId, reportPayload);
+                bugReport.status = "reported";
+                bugReport.orchestratorResponse = response;
+                logger.info("Bug reported to orchestrator successfully", { bugId });
+            }
+            catch (orchestratorError) {
+                logger.error("Failed to report bug to orchestrator", {
+                    bugId,
+                    error: orchestratorError.message,
+                });
+                bugReport.status = "failed";
+                bugReport.context.orchestratorError = orchestratorError.message;
+            }
+        }
+        // Always save to local todo folder
+        const todoFolderPath = await saveBugToTodoFolder(bugReport);
+        bugReport.localPath = todoFolderPath;
+        logger.info("Bug report saved", { bugId, path: todoFolderPath, status: bugReport.status });
+        return bugReport;
+    }
+    catch (saveError) {
+        logger.error("Failed to save bug report", {
+            bugId,
+            error: saveError.message,
+        });
+        bugReport.status = "failed";
+        bugReport.context.saveError = saveError.message;
+        return bugReport;
+    }
+}
+/**
+ * Save bug report to todo folder
+ */
+async function saveBugToTodoFolder(bugReport) {
+    const todoFolder = ".orchestrator/todo/bugs";
+    const bugFileName = `${bugReport.id}.json`;
+    const bugFilePath = join(todoFolder, bugFileName);
+    try {
+        // Ensure todo folder exists
+        await mkdir(todoFolder, { recursive: true });
+        // Write bug report as JSON
+        await writeFile(bugFilePath, JSON.stringify(bugReport, null, 2), "utf-8");
+        // Also create a markdown summary for easier reading
+        const markdownPath = join(todoFolder, `${bugReport.id}.md`);
+        const markdownContent = generateBugMarkdown(bugReport);
+        await writeFile(markdownPath, markdownContent, "utf-8");
+        return bugFilePath;
+    }
+    catch (error) {
+        throw new Error(`Failed to save bug report to ${bugFilePath}: ${getErrorMessage(error)}`);
+    }
+}
+/**
+ * Generate markdown summary of bug report
+ */
+function generateBugMarkdown(bugReport) {
+    const lines = [];
+    lines.push(`# Bug Report: ${bugReport.id}`);
+    lines.push("");
+    lines.push(`**Timestamp:** ${bugReport.timestamp}`);
+    lines.push(`**Severity:** ${bugReport.severity}`);
+    lines.push(`**Status:** ${bugReport.status}`);
+    lines.push("");
+    lines.push("## Error");
+    lines.push("");
+    lines.push(`**Message:** ${bugReport.error.message}`);
+    if (bugReport.error.name) {
+        lines.push(`**Type:** ${bugReport.error.name}`);
+    }
+    if (bugReport.error.stack) {
+        lines.push("");
+        lines.push("**Stack Trace:**");
+        lines.push("```");
+        lines.push(bugReport.error.stack);
+        lines.push("```");
+    }
+    if (Object.keys(bugReport.context).length > 0) {
+        lines.push("");
+        lines.push("## Context");
+        lines.push("");
+        for (const [key, value] of Object.entries(bugReport.context)) {
+            if (key === "orchestratorError" || key === "saveError") {
+                lines.push(`**${key}:** \`${value}\``);
+            }
+            else {
+                lines.push(`**${key}:** ${typeof value === "object" ? JSON.stringify(value, null, 2) : value}`);
+            }
+        }
+    }
+    if (bugReport.orchestratorResponse) {
+        lines.push("");
+        lines.push("## Orchestrator Response");
+        lines.push("");
+        lines.push("```json");
+        lines.push(JSON.stringify(bugReport.orchestratorResponse, null, 2));
+        lines.push("```");
+    }
+    if (bugReport.localPath) {
+        lines.push("");
+        lines.push(`**Local Path:** \`${bugReport.localPath}\``);
+    }
+    return lines.join("\n");
+}
+/**
+ * Wrapper function to catch and report errors
+ */
+export async function withBugReporting(fn, context = {}, severity = "medium") {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        // Report the bug
+        await reportBug(error, context, severity);
+        // Re-throw to maintain original error behavior
+        if (error instanceof Error) {
+            throw error;
+        }
+        throw new Error(getErrorMessage(error));
+    }
+}
+/**
+ * Synchronous wrapper for bug reporting (for non-async contexts)
+ */
+export function reportBugSync(error, context = {}, severity = "medium") {
+    // Fire and forget - don't await to avoid blocking
+    reportBug(error, context, severity).catch((reportError) => {
+        logger.error("Failed to report bug (async)", {
+            originalError: typeof error === "string" ? error : getErrorMessage(error),
+            reportError: getErrorMessage(reportError),
+        });
+    });
+}
+//# sourceMappingURL=bug-reporter.js.map

package/public/utils/bug-reporter.js.map

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

package/public/utils/filesystem.d.ts

@@ -0,0 +1,32 @@
+/**
+ * File System Operations for Progress Files
+
+ */
+/**
+ * Ensure directory exists, creating it if necessary
+ */
+export declare function ensureDirectory(dir: string): Promise<void>;
+/**
+ * Read progress file content
+ */
+export declare function readProgressFile(path: string): Promise<string | null>;
+/**
+ * Write progress file content
+ */
+export declare function writeProgressFile(path: string, content: string): Promise<void>;
+/**
+ * Get progress file path for an issue
+ *
+ * Standard structure: `.orchestrator/tickets/{type}/{key}-{slug}.md`
+ */
+export declare function getProgressFilePath(issueKey: string, baseDir: string, options?: {
+    status?: string | null;
+    type?: string | null;
+    title?: string | null;
+    epicKey?: string;
+}): string;
+/**
+ * Check if file exists
+ */
+export declare function fileExists(path: string): boolean;
+//# sourceMappingURL=filesystem.d.ts.map

package/public/utils/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/utils/filesystem.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;GAEG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAU3E;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CACb,GACL,MAAM,CA4BR;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD"}

package/public/utils/filesystem.js

@@ -0,0 +1,78 @@
+/**
+ * File System Operations for Progress Files
+
+ */
+import { mkdir, readFile, writeFile } from "fs/promises";
+import { join, dirname } from "path";
+import { existsSync } from "fs";
+import { slugify } from "./string";
+/**
+ * Ensure directory exists, creating it if necessary
+ */
+export async function ensureDirectory(dir) {
+    if (!existsSync(dir)) {
+        await mkdir(dir, { recursive: true });
+    }
+}
+/**
+ * Read progress file content
+ */
+export async function readProgressFile(path) {
+    try {
+        const content = await readFile(path, "utf-8");
+        return content;
+    }
+    catch (error) {
+        if (error && typeof error === 'object' && 'code' in error && error.code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    }
+}
+/**
+ * Write progress file content
+ */
+export async function writeProgressFile(path, content) {
+    // Ensure directory exists
+    const dir = dirname(path);
+    await ensureDirectory(dir);
+    // Write file
+    await writeFile(path, content, "utf-8");
+}
+/**
+ * Get progress file path for an issue
+ *
+ * Standard structure: `.orchestrator/tickets/{type}/{key}-{slug}.md`
+ */
+export function getProgressFilePath(issueKey, baseDir, options = {}) {
+    const { status, type, title } = options;
+    const isDone = status && (status.toLowerCase() === 'done' ||
+        status.toLowerCase() === 'completed' ||
+        status.toLowerCase() === 'closed');
+    // Determine subdirectory based on type
+    let typeDir = "stories";
+    if (type) {
+        const typeLower = type.toLowerCase();
+        if (typeLower.includes("bug"))
+            typeDir = "bugs";
+        else if (typeLower.includes("epic"))
+            typeDir = "epics";
+        else if (typeLower.includes("task"))
+            typeDir = "tasks";
+    }
+    // Handle "Done" tickets
+    if (isDone) {
+        typeDir = join(typeDir, "finished");
+    }
+    // Generate filename: {key}-{slug}.md
+    const slug = title ? `-${slugify(title)}` : "";
+    const fileName = `${issueKey}${slug}.md`;
+    return join(baseDir, "tickets", typeDir, fileName);
+}
+/**
+ * Check if file exists
+ */
+export function fileExists(path) {
+    return existsSync(path);
+}
+//# sourceMappingURL=filesystem.js.map

package/public/utils/filesystem.js.map

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

package/public/utils/formatCurrency.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Format a number as a currency string.
+ * uses Intl.NumberFormat for locale-aware formatting.
+ *
+ * @param amount - The numeric amount to format (e.g., 1234.56)
+ * @param currency - The ISO 4217 currency code (default: 'USD')
+ * @param locale - The BCP 47 language tag (default: 'en-US')
+ * @returns The formatted currency string
+ */
+export declare function formatCurrency(amount: number, currency?: string, locale?: string): string;
+//# sourceMappingURL=formatCurrency.d.ts.map

package/public/utils/formatCurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatCurrency.d.ts","sourceRoot":"","sources":["../../src/utils/formatCurrency.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC1B,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAc,EACxB,MAAM,GAAE,MAAgB,GACzB,MAAM,CAgBR"}

package/public/utils/formatCurrency.js

@@ -0,0 +1,27 @@
+/**
+ * Format a number as a currency string.
+ * uses Intl.NumberFormat for locale-aware formatting.
+ *
+ * @param amount - The numeric amount to format (e.g., 1234.56)
+ * @param currency - The ISO 4217 currency code (default: 'USD')
+ * @param locale - The BCP 47 language tag (default: 'en-US')
+ * @returns The formatted currency string
+ */
+export function formatCurrency(amount, currency = "USD", locale = "en-US") {
+    // Guard against non-finite numbers to prevent hydration mismatches or display errors
+    if (!Number.isFinite(amount)) {
+        return "N/A";
+    }
+    try {
+        return new Intl.NumberFormat(locale, {
+            style: "currency",
+            currency: currency,
+        }).format(amount);
+    }
+    catch (error) {
+        // Fallback in case of invalid locale/currency code to prevent crashes
+        console.warn(`[formatCurrency] Error formatting: ${error}`);
+        return `${amount} ${currency}`;
+    }
+}
+//# sourceMappingURL=formatCurrency.js.map

package/public/utils/formatCurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatCurrency.js","sourceRoot":"","sources":["../../src/utils/formatCurrency.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC1B,MAAc,EACd,WAAmB,KAAK,EACxB,SAAiB,OAAO;IAExB,qFAAqF;IACrF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,CAAC;QACD,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE;YACjC,KAAK,EAAE,UAAU;YACjB,QAAQ,EAAE,QAAQ;SACrB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,sEAAsE;QACtE,OAAO,CAAC,IAAI,CAAC,sCAAsC,KAAK,EAAE,CAAC,CAAC;QAC5D,OAAO,GAAG,MAAM,IAAI,QAAQ,EAAE,CAAC;IACnC,CAAC;AACL,CAAC"}

package/public/utils/instruction-writer.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Instruction Writer
+ *
+ * Writes instructions to .orchestrator/instructions folder
+ */
+export interface InstructionPayload {
+    issueKey: string;
+    summary: string;
+    description?: string;
+    status?: string;
+    assignee?: string;
+    priority?: string;
+    labels?: string[];
+    issueType?: string;
+    epicKey?: string;
+    progressFilePath?: string;
+    taskFolderPath?: string;
+    branchName?: string;
+}
+export interface Instruction {
+    instructionId: string;
+    type: 'start-work';
+    payload: InstructionPayload;
+    source: 'ticket-mate';
+    timestamp: string;
+}
+/**
+ * Write instruction to .orchestrator/instructions folder
+ */
+export declare function writeInstruction(issueKey: string, payload: InstructionPayload, projectRoot?: string): Promise<string>;
+/**
+ * Create missing keys report
+ */
+export declare function createMissingKeysReport(missingKeys: string[], projectRoot?: string): Promise<string>;
+//# sourceMappingURL=instruction-writer.d.ts.map

package/public/utils/instruction-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruction-writer.d.ts","sourceRoot":"","sources":["../../src/utils/instruction-writer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,kBAAkB,EAC3B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAwCjB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EAAE,EACrB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAiCjB"}

package/public/utils/instruction-writer.js

@@ -0,0 +1,84 @@
+/**
+ * Instruction Writer
+ *
+ * Writes instructions to .orchestrator/instructions folder
+ */
+import { writeFile, mkdir } from "fs/promises";
+import { join } from "path";
+import { existsSync } from "fs";
+import { logger } from "./logger";
+import { getErrorMessage } from "../types/common";
+/**
+ * Write instruction to .orchestrator/instructions folder
+ */
+export async function writeInstruction(issueKey, payload, projectRoot) {
+    try {
+        // Determine base directory
+        const baseDir = projectRoot || process.cwd();
+        const instructionsDir = join(baseDir, '.orchestrator', 'instructions');
+        // Ensure directory exists
+        if (!existsSync(instructionsDir)) {
+            await mkdir(instructionsDir, { recursive: true });
+        }
+        // Create instruction
+        const instructionId = `start-work-${issueKey}-${Date.now()}`;
+        const instruction = {
+            instructionId,
+            type: 'start-work',
+            payload,
+            source: 'ticket-mate',
+            timestamp: new Date().toISOString(),
+        };
+        // Write to JSON file
+        const fileName = `${instructionId}.json`;
+        const filePath = join(instructionsDir, fileName);
+        await writeFile(filePath, JSON.stringify(instruction, null, 2), 'utf-8');
+        logger.info('Instruction written', {
+            issueKey,
+            instructionId,
+            filePath,
+        });
+        return filePath;
+    }
+    catch (error) {
+        logger.error('Failed to write instruction', {
+            issueKey,
+            error: getErrorMessage(error),
+        });
+        throw error;
+    }
+}
+/**
+ * Create missing keys report
+ */
+export async function createMissingKeysReport(missingKeys, projectRoot) {
+    try {
+        const baseDir = projectRoot || process.cwd();
+        const reportsDir = join(baseDir, '.orchestrator', 'reports');
+        // Ensure directory exists
+        if (!existsSync(reportsDir)) {
+            await mkdir(reportsDir, { recursive: true });
+        }
+        const report = {
+            reportId: `missing-keys-${Date.now()}`,
+            timestamp: new Date().toISOString(),
+            missingKeys,
+            message: `Found ${missingKeys.length} missing Jira keys. These should be created via webhooks.`,
+        };
+        const fileName = `missing-keys-${Date.now()}.json`;
+        const filePath = join(reportsDir, fileName);
+        await writeFile(filePath, JSON.stringify(report, null, 2), 'utf-8');
+        logger.info('Missing keys report created', {
+            missingKeysCount: missingKeys.length,
+            filePath,
+        });
+        return filePath;
+    }
+    catch (error) {
+        logger.error('Failed to create missing keys report', {
+            error: getErrorMessage(error),
+        });
+        throw error;
+    }
+}
+//# sourceMappingURL=instruction-writer.js.map

package/public/utils/instruction-writer.js.map

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

package/public/utils/jira-keys.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Jira Key Extraction Utilities
+ *
+ * Extract Jira issue keys from text (branch names, commit messages, etc.)
+ */
+/**
+ * Extract Jira issue keys from text
+ *
+ * @param text - Text to search (branch name, commit message, etc.)
+ * @param projectKey - Optional project key to filter by (e.g., "NOVA", "PROJ")
+ * @returns Array of unique Jira issue keys found
+ *
+ * @example
+ * extractJiraKeys("feature/NOVA-123-add-checkout") // ["NOVA-123"]
+ * extractJiraKeys("NOVA-123 and NOVA-456", "NOVA") // ["NOVA-123", "NOVA-456"]
+ */
+export declare function extractJiraKeys(text: string, projectKey?: string): string[];
+/**
+ * Check if text contains at least one Jira key
+ */
+export declare function hasJiraKey(text: string, projectKey?: string): boolean;
+/**
+ * Extract the first Jira key from text
+ */
+export declare function extractFirstJiraKey(text: string, projectKey?: string): string | null;
+//# sourceMappingURL=jira-keys.d.ts.map

package/public/utils/jira-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-keys.d.ts","sourceRoot":"","sources":["../../src/utils/jira-keys.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAkB3E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAErE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGpF"}

package/public/utils/jira-keys.js

@@ -0,0 +1,46 @@
+/**
+ * Jira Key Extraction Utilities
+ *
+ * Extract Jira issue keys from text (branch names, commit messages, etc.)
+ */
+/**
+ * Extract Jira issue keys from text
+ *
+ * @param text - Text to search (branch name, commit message, etc.)
+ * @param projectKey - Optional project key to filter by (e.g., "NOVA", "PROJ")
+ * @returns Array of unique Jira issue keys found
+ *
+ * @example
+ * extractJiraKeys("feature/NOVA-123-add-checkout") // ["NOVA-123"]
+ * extractJiraKeys("NOVA-123 and NOVA-456", "NOVA") // ["NOVA-123", "NOVA-456"]
+ */
+export function extractJiraKeys(text, projectKey) {
+    if (!text || typeof text !== "string") {
+        return [];
+    }
+    // Pattern: PROJECT-123 (case-insensitive)
+    const pattern = projectKey
+        ? new RegExp(`\\b${projectKey}-\\d+\\b`, "gi")
+        : /\b[A-Za-z]+-\d+\b/gi;
+    const matches = text.match(pattern);
+    if (!matches) {
+        return [];
+    }
+    // Normalize to uppercase and remove duplicates
+    const keys = matches.map((key) => key.toUpperCase());
+    return Array.from(new Set(keys));
+}
+/**
+ * Check if text contains at least one Jira key
+ */
+export function hasJiraKey(text, projectKey) {
+    return extractJiraKeys(text, projectKey).length > 0;
+}
+/**
+ * Extract the first Jira key from text
+ */
+export function extractFirstJiraKey(text, projectKey) {
+    const keys = extractJiraKeys(text, projectKey);
+    return keys.length > 0 ? keys[0] : null;
+}
+//# sourceMappingURL=jira-keys.js.map

package/public/utils/jira-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-keys.js","sourceRoot":"","sources":["../../src/utils/jira-keys.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,UAAmB;IAC/D,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,0CAA0C;IAC1C,MAAM,OAAO,GAAG,UAAU;QACxB,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,UAAU,UAAU,EAAE,IAAI,CAAC;QAC9C,CAAC,CAAC,qBAAqB,CAAC;IAE1B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,+CAA+C;IAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IACrD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,UAAmB;IAC1D,OAAO,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,UAAmB;IACnE,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/C,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC"}

package/public/utils/jiraAvatar.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Jira Avatar Utilities
+ *
+ * Extracts instance name from Jira base URL and generates avatar fallbacks
+ */
+/**
+ * Extract the instance name from a Jira base URL
+ * Examples:
+ *   "https://mycompany.atlassian.net" -> "M"
+ *   "https://acme.atlassian.net" -> "A"
+ *   "https://jira.example.com" -> "J"
+ */
+export declare function getJiraInstanceName(baseUrl: string | null | undefined): string | null;
+/**
+ * Get avatar URL from Jira API
+ * Jira REST API v3: GET /rest/api/3/myself
+ * Returns user profile with avatarUrls
+ */
+export declare function getJiraUserAvatar(baseUrl: string, accessToken: string): Promise<string | null>;
+//# sourceMappingURL=jiraAvatar.d.ts.map

package/public/utils/jiraAvatar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jiraAvatar.d.ts","sourceRoot":"","sources":["../../src/utils/jiraAvatar.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAyBrF;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6CxB"}