@ameshkin/ticket-mate 0.1.20

package/public/utils/jiraAvatar.js

@@ -0,0 +1,78 @@
+/**
+ * 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 function getJiraInstanceName(baseUrl) {
+    if (!baseUrl)
+        return null;
+    try {
+        const url = new URL(baseUrl);
+        const hostname = url.hostname;
+        // Extract subdomain from atlassian.net
+        if (hostname.includes('.atlassian.net')) {
+            const subdomain = hostname.split('.atlassian.net')[0];
+            return subdomain.charAt(0).toUpperCase();
+        }
+        // For custom domains, use first letter of domain
+        const domainParts = hostname.split('.');
+        const mainDomain = domainParts[domainParts.length - 2] || hostname;
+        return mainDomain.charAt(0).toUpperCase();
+    }
+    catch {
+        // If URL parsing fails, try to extract first letter from the string
+        const match = baseUrl.match(/https?:\/\/([^.]+)/);
+        if (match && match[1]) {
+            return match[1].charAt(0).toUpperCase();
+        }
+        return null;
+    }
+}
+/**
+ * Get avatar URL from Jira API
+ * Jira REST API v3: GET /rest/api/3/myself
+ * Returns user profile with avatarUrls
+ */
+export async function getJiraUserAvatar(baseUrl, accessToken) {
+    try {
+        // Construct API URL - handle both cloud and server
+        let apiUrl;
+        if (baseUrl.includes('.atlassian.net')) {
+            // Cloud: need cloudId, but we can try the base URL first
+            // For cloud, we'd need cloudId, so this might not work directly
+            // But we can try the accessible-resources approach
+            apiUrl = `${baseUrl}/rest/api/3/myself`;
+        }
+        else {
+            // Server/Data Center
+            apiUrl = `${baseUrl}/rest/api/3/myself`;
+        }
+        const response = await fetch(apiUrl, {
+            headers: {
+                Authorization: `Bearer ${accessToken}`,
+                Accept: 'application/json',
+            },
+        });
+        if (!response.ok) {
+            return null;
+        }
+        const data = await response.json();
+        // Prefer larger avatars, fall back to smaller ones
+        return (data.avatarUrls?.['48x48'] ||
+            data.avatarUrls?.['32x32'] ||
+            data.avatarUrls?.['24x24'] ||
+            data.avatarUrls?.['16x16'] ||
+            null);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=jiraAvatar.js.map

package/public/utils/jiraAvatar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jiraAvatar.js","sourceRoot":"","sources":["../../src/utils/jiraAvatar.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAkC;IACpE,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAE9B,uCAAuC;QACvC,IAAI,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACxC,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;YACtD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3C,CAAC;QAED,iDAAiD;QACjD,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,QAAQ,CAAC;QACnE,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,oEAAoE;QACpE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAClD,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,WAAmB;IAEnB,IAAI,CAAC;QACH,mDAAmD;QACnD,IAAI,MAAc,CAAC;QACnB,IAAI,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACvC,yDAAyD;YACzD,gEAAgE;YAChE,mDAAmD;YACnD,MAAM,GAAG,GAAG,OAAO,oBAAoB,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,qBAAqB;YACrB,MAAM,GAAG,GAAG,OAAO,oBAAoB,CAAC;QAC1C,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE;YACnC,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,WAAW,EAAE;gBACtC,MAAM,EAAE,kBAAkB;aAC3B;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAO/B,CAAC;QAEF,mDAAmD;QACnD,OAAO,CACL,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC;YAC1B,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC;YAC1B,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC;YAC1B,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC;YAC1B,IAAI,CACL,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/public/utils/logger.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Simple logging utility
+ *
+ * Provides structured logging with levels and optional JSON output for CI/CD.
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface LoggerOptions {
+    level?: LogLevel;
+    json?: boolean;
+    prefix?: string;
+}
+declare class Logger {
+    private level;
+    private json;
+    private prefix;
+    constructor(options?: LoggerOptions);
+    private shouldLog;
+    private formatMessage;
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+}
+/**
+ * Default logger instance
+ */
+export declare const logger: Logger;
+/**
+ * Create a logger with custom options
+ */
+export declare function createLogger(options: LoggerOptions): Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AASD,cAAM,MAAM;IACV,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,IAAI,CAAU;IACtB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,aAAkB;IAMvC,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,aAAa;IA2BrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAG7D;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,QAAe,CAAC;AAEnC;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAE3D"}

package/public/utils/logger.js

@@ -0,0 +1,73 @@
+/**
+ * Simple logging utility
+ *
+ * Provides structured logging with levels and optional JSON output for CI/CD.
+ */
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+class Logger {
+    level;
+    json;
+    prefix;
+    constructor(options = {}) {
+        this.level = options.level || (process.env.NODE_ENV === "production" ? "info" : "debug");
+        this.json = options.json || process.env.TICKET_MATE_JSON_LOGS === "true";
+        this.prefix = options.prefix || "ticket-mate";
+    }
+    shouldLog(level) {
+        return LOG_LEVELS[level] >= LOG_LEVELS[this.level];
+    }
+    formatMessage(level, message, data) {
+        if (!this.shouldLog(level)) {
+            return;
+        }
+        if (this.json) {
+            const logEntry = {
+                timestamp: new Date().toISOString(),
+                level,
+                prefix: this.prefix,
+                message,
+                ...data,
+            };
+            console.log(JSON.stringify(logEntry));
+        }
+        else {
+            const prefix = `[${this.prefix}]`;
+            const levelStr = level.toUpperCase().padEnd(5);
+            const formatted = `${prefix} ${levelStr} ${message}`;
+            if (data) {
+                console.log(formatted, data);
+            }
+            else {
+                console.log(formatted);
+            }
+        }
+    }
+    debug(message, data) {
+        this.formatMessage("debug", message, data);
+    }
+    info(message, data) {
+        this.formatMessage("info", message, data);
+    }
+    warn(message, data) {
+        this.formatMessage("warn", message, data);
+    }
+    error(message, data) {
+        this.formatMessage("error", message, data);
+    }
+}
+/**
+ * Default logger instance
+ */
+export const logger = new Logger();
+/**
+ * Create a logger with custom options
+ */
+export function createLogger(options) {
+    return new Logger(options);
+}
+//# sourceMappingURL=logger.js.map

package/public/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,MAAM,UAAU,GAA6B;IAC3C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,MAAM;IACF,KAAK,CAAW;IAChB,IAAI,CAAU;IACd,MAAM,CAAS;IAEvB,YAAY,UAAyB,EAAE;QACrC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACzF,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,MAAM,CAAC;QACzE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC;IAChD,CAAC;IAEO,SAAS,CAAC,KAAe;QAC/B,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;IAEO,aAAa,CAAC,KAAe,EAAE,OAAe,EAAE,IAA8B;QACpF,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,QAAQ,GAAG;gBACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,KAAK;gBACL,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO;gBACP,GAAG,IAAI;aACR,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC/C,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;YAErD,IAAI,IAAI,EAAE,CAAC;gBACT,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAA8B;QACnD,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAA8B;QAClD,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAA8B;QAClD,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAA8B;QACnD,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;AAEnC;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAsB;IACjD,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC"}

package/public/utils/path-migration.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Path Migration Utility
+ *
+ * Handles migration from legacy .ticket-mate/ paths to canonical .orchestrator/ paths.
+ */
+export declare function ensureOrchestratorPath(root: string): void;
+//# sourceMappingURL=path-migration.d.ts.map

package/public/utils/path-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-migration.d.ts","sourceRoot":"","sources":["../../src/utils/path-migration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAsDzD"}

package/public/utils/path-migration.js

@@ -0,0 +1,57 @@
+/**
+ * Path Migration Utility
+ *
+ * Handles migration from legacy .ticket-mate/ paths to canonical .orchestrator/ paths.
+ */
+import { existsSync, renameSync, mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { logger } from './logger';
+export function ensureOrchestratorPath(root) {
+    const legacyPath = join(root, '.ticket-mate');
+    const canonicalPath = join(root, '.orchestrator');
+    // If canonical path exists, we are good (even if legacy exists, we ignore it based on precedence)
+    if (existsSync(canonicalPath)) {
+        return;
+    }
+    // If legacy path exists but canonical doesn't, migrate
+    if (existsSync(legacyPath)) {
+        console.log('\n📦 Migrating legacy .ticket-mate/ to .orchestrator/...');
+        try {
+            // 1. Create .orchestrator directory
+            mkdirSync(canonicalPath, { recursive: true });
+            // 2. Move tickets folder if it exists
+            const legacyTickets = join(legacyPath, 'tickets');
+            const canonicalTickets = join(canonicalPath, 'tickets');
+            if (existsSync(legacyTickets)) {
+                renameSync(legacyTickets, canonicalTickets);
+            }
+            // 3. Move config if it exists
+            const legacyConfig = join(legacyPath, 'config.json');
+            const canonicalConfig = join(canonicalPath, 'config.json');
+            if (existsSync(legacyConfig)) {
+                renameSync(legacyConfig, canonicalConfig);
+            }
+            // 4. Mark migration complete
+            const migrationNote = `# Legacy Migration
+      
+This folder was migrated from .ticket-mate/ to .orchestrator/ on ${new Date().toISOString()}.
+Please use .orchestrator/ for all future operations.
+`;
+            mkdirSync(join(canonicalPath, 'migrations'), { recursive: true });
+            writeFileSync(join(canonicalPath, 'migrations', 'legacy_moved.md'), migrationNote);
+            // 5. Leave a deprecation notice in the old folder
+            writeFileSync(join(legacyPath, 'DEPRECATED.md'), '# DEPRECATED\n\nThis folder is deprecated. Please use .orchestrator/ instead.\nContents have been migrated.');
+            console.log('✅ Migration complete. Please update your .gitignore to include .orchestrator/\n');
+            logger.info('Migrated legacy .ticket-mate to .orchestrator', { root });
+        }
+        catch (error) {
+            console.error('❌ Migration failed:', error);
+            logger.error('Migration failed', { error });
+            // Don't crash, just let the command try to initialize strictly if needed
+        }
+    }
+    else {
+        // Neither exists - do nothing, let commands initialize strictly as needed
+    }
+}
+//# sourceMappingURL=path-migration.js.map

package/public/utils/path-migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-migration.js","sourceRoot":"","sources":["../../src/utils/path-migration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,UAAU,sBAAsB,CAAC,IAAY;IAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAElD,kGAAkG;IAClG,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC5B,OAAO;IACX,CAAC;IAED,uDAAuD;IACvD,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;QAExE,IAAI,CAAC;YACD,oCAAoC;YACpC,SAAS,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE9C,sCAAsC;YACtC,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YAClD,MAAM,gBAAgB,GAAG,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;YAExD,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC5B,UAAU,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;YAChD,CAAC;YAED,8BAA8B;YAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;YACrD,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;YAC3D,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC3B,UAAU,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;YAC9C,CAAC;YAED,6BAA6B;YAC7B,MAAM,aAAa,GAAG;;mEAEiC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;;CAE1F,CAAC;YACU,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAClE,aAAa,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,EAAE,iBAAiB,CAAC,EAAE,aAAa,CAAC,CAAC;YAEnF,kDAAkD;YAClD,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,EAAE,6GAA6G,CAAC,CAAC;YAEhK,OAAO,CAAC,GAAG,CAAC,iFAAiF,CAAC,CAAC;YAC/F,MAAM,CAAC,IAAI,CAAC,+CAA+C,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;YAC5C,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5C,yEAAyE;QAC7E,CAAC;IACL,CAAC;SAAM,CAAC;QACJ,0EAA0E;IAC9E,CAAC;AACL,CAAC"}

package/public/utils/progress-reporter.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Progress Reporter
+
+ *
+ * Reports detailed progress during work execution to orchestrator
+ */
+export type ProgressState = "starting" | "syncing" | "folder_created" | "building" | "testing" | "complete" | "error";
+export interface ProgressReport {
+    ticketKey: string;
+    state: ProgressState;
+    step: string;
+    progress: number;
+    message?: string;
+    errors?: string[];
+    remainingWork?: string[];
+    metadata?: Record<string, any>;
+}
+/**
+ * Report progress to orchestrator
+ */
+export declare function reportProgress(ticketKey: string, state: ProgressState, step: string, progress: number, options?: {
+    message?: string;
+    errors?: string[];
+    remainingWork?: string[];
+    metadata?: Record<string, any>;
+}): Promise<void>;
+/**
+ * Helper functions for common progress states
+ */
+export declare const progressHelpers: {
+    starting: (ticketKey: string, message?: string) => Promise<void>;
+    syncing: (ticketKey: string, message?: string) => Promise<void>;
+    folderCreated: (ticketKey: string, folderPath: string, message?: string) => Promise<void>;
+    building: (ticketKey: string, step: string, progress: number, message?: string) => Promise<void>;
+    testing: (ticketKey: string, message?: string) => Promise<void>;
+    complete: (ticketKey: string, message?: string, remainingWork?: string[]) => Promise<void>;
+    error: (ticketKey: string, error: string, errors?: string[], remainingWork?: string[]) => Promise<void>;
+};
+//# sourceMappingURL=progress-reporter.d.ts.map

package/public/utils/progress-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-reporter.d.ts","sourceRoot":"","sources":["../../src/utils/progress-reporter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,SAAS,GACT,gBAAgB,GAChB,UAAU,GACV,SAAS,GACT,UAAU,GACV,OAAO,CAAC;AAEZ,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC3B,GACL,OAAO,CAAC,IAAI,CAAC,CA0Cf;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;0BACJ,MAAM,YAAY,MAAM;yBAGzB,MAAM,YAAY,MAAM;+BAGlB,MAAM,cAAc,MAAM,YAAY,MAAM;0BASjD,MAAM,QAAQ,MAAM,YAAY,MAAM,YAAY,MAAM;yBASzD,MAAM,YAAY,MAAM;0BAGvB,MAAM,YAAY,MAAM,kBAAkB,MAAM,EAAE;uBASrD,MAAM,SAAS,MAAM,WAAW,MAAM,EAAE,kBAAkB,MAAM,EAAE;CAQtF,CAAC"}

package/public/utils/progress-reporter.js

@@ -0,0 +1,66 @@
+/**
+ * Progress Reporter
+
+ *
+ * Reports detailed progress during work execution to orchestrator
+ */
+import { reportToOrchestrator, isOrchestratorEnabled } from "../integrations/orchestrator-client";
+import { logger } from "./logger";
+import { getErrorMessage } from "../types/common";
+/**
+ * Report progress to orchestrator
+ */
+export async function reportProgress(ticketKey, state, step, progress, options = {}) {
+    if (!isOrchestratorEnabled()) {
+        logger.debug("Orchestrator not enabled, skipping progress report", { ticketKey, state });
+        return;
+    }
+    try {
+        const progressReport = {
+            ticketKey,
+            state,
+            step,
+            progress: Math.max(0, Math.min(100, progress)), // Clamp to 0-100
+            message: options.message,
+            errors: options.errors,
+            remainingWork: options.remainingWork,
+            metadata: options.metadata,
+        };
+        const instructionId = `progress-${ticketKey}-${Date.now()}`;
+        // Cast to any since OrchestratorResponse doesn't have details field
+        // The orchestrator API endpoint should handle both result reports and progress updates
+        await reportToOrchestrator(instructionId, {
+            success: state !== "error",
+            message: options.message || step,
+            details: progressReport,
+        });
+        logger.info("Reported progress to orchestrator", {
+            ticketKey,
+            state,
+            step,
+            progress,
+        });
+    }
+    catch (error) {
+        logger.warn("Failed to report progress to orchestrator", {
+            ticketKey,
+            state,
+            error: getErrorMessage(error),
+        });
+        // Don't throw - this is non-critical
+    }
+}
+/**
+ * Helper functions for common progress states
+ */
+export const progressHelpers = {
+    starting: (ticketKey, message) => reportProgress(ticketKey, "starting", "Initializing work", 0, { message }),
+    syncing: (ticketKey, message) => reportProgress(ticketKey, "syncing", "Syncing ticket from Jira", 20, { message }),
+    folderCreated: (ticketKey, folderPath, message) => reportProgress(ticketKey, "folder_created", "Task folder created", 40, { message, metadata: { folderPath } }),
+    building: (ticketKey, step, progress, message) => reportProgress(ticketKey, "building", step, 40 + (progress * 0.4), // 40-80% range
+    { message }),
+    testing: (ticketKey, message) => reportProgress(ticketKey, "testing", "Running tests", 80, { message }),
+    complete: (ticketKey, message, remainingWork) => reportProgress(ticketKey, "complete", "Work completed", 100, { message, remainingWork }),
+    error: (ticketKey, error, errors, remainingWork) => reportProgress(ticketKey, "error", "Error occurred", 0, { message: error, errors, remainingWork }),
+};
+//# sourceMappingURL=progress-reporter.js.map

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

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

package/public/utils/project-code-generator.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Jira Project Code Generator
+ *
+ * WHAT IS A JIRA PROJECT CODE?
+ * =============================
+ * A Jira project code (also called "project key") is a short identifier that Jira uses
+ * to identify projects. It appears in every ticket ID.
+ *
+ * Examples:
+ * - Project: "Agent Handler" → Code: "AGE" → Tickets: "AGE-123", "AGE-456"
+ * - Project: "NOVA" → Code: "NOVA" → Tickets: "NOVA-789", "NOVA-101"
+ * - Project: "NextCrumbs" → Code: "NXT" → Tickets: "NXT-234"
+ *
+ * Rules:
+ * - Must be 2-10 uppercase letters/numbers
+ * - Must be unique within your Jira instance
+ * - Cannot be changed after project creation
+ *
+ * WHAT THIS FUNCTION DOES:
+ * ========================
+ * Takes a project slug (like "agent-handler") and optionally a display name (like "Agent Handler")
+ * and generates a valid Jira project code (like "AGE").
+ *
+ * It uses a smart algorithm:
+ * 1. First checks known mappings (e.g., "nova" → "NOVA")
+ * 2. Then tries to extract from display name (e.g., "Agent Handler" → "AH" or "AGE")
+ * 3. Finally falls back to slug processing (e.g., "agent-handler" → "AGE")
+ *
+ * Examples:
+ * - generateProjectCode("agent-handler", "Agent Handler") → "AGE"
+ * - generateProjectCode("nova", "NOVA") → "NOVA"
+ * - generateProjectCode("my-awesome-project", "My Awesome Project") → "MAP"
+ * - generateProjectCode("test") → "TEST" (or "TE" if too short)
+ */
+/**
+ * Generate a Jira project code from a project slug and optional display name
+ *
+ * @param slug - Project slug (e.g., "agent-handler", "nova")
+ * @param displayName - Optional display name (e.g., "Agent Handler", "NOVA")
+ * @returns A valid Jira project code (2-10 uppercase alphanumeric characters)
+ *
+ * @example
+ * ```typescript
+ * generateProjectCode("agent-handler", "Agent Handler") // Returns: "AGE"
+ * generateProjectCode("nova") // Returns: "NOVA"
+ * generateProjectCode("my-project", "My Project") // Returns: "MP"
+ * ```
+ */
+export declare function generateProjectCode(slug: string, displayName?: string): string;
+/**
+ * Validate if a string is a valid Jira project code
+ *
+ * Jira project codes must be:
+ * - 2-10 characters long
+ * - Uppercase letters and numbers only (A-Z, 0-9)
+ *
+ * @param code - The code to validate
+ * @returns true if valid, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isValidProjectCode("AGE") // Returns: true
+ * isValidProjectCode("NOVA") // Returns: true
+ * isValidProjectCode("a") // Returns: false (too short)
+ * isValidProjectCode("INVALID-CODE") // Returns: false (contains hyphen)
+ * isValidProjectCode("toolongcode123") // Returns: false (too long, lowercase)
+ * ```
+ */
+export declare function isValidProjectCode(code: string): boolean;
+/**
+ * Suggest a project code with validation and fallback
+ *
+ * This is the main function you should use. It generates a code and ensures it's valid.
+ * If the generated code is invalid, it creates a safe fallback.
+ *
+ * @param slug - Project slug (e.g., "agent-handler")
+ * @param displayName - Optional display name (e.g., "Agent Handler")
+ * @returns A valid Jira project code (guaranteed to be 2-10 uppercase alphanumeric)
+ *
+ * @example
+ * ```typescript
+ * suggestProjectCode("agent-handler", "Agent Handler") // Returns: "AGE"
+ * suggestProjectCode("nova") // Returns: "NOVA"
+ * suggestProjectCode("test-project") // Returns: "TP" or "TEST" (depending on logic)
+ * ```
+ */
+export declare function suggestProjectCode(slug: string, displayName?: string): string;
+//# sourceMappingURL=project-code-generator.d.ts.map

package/public/utils/project-code-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-code-generator.d.ts","sourceRoot":"","sources":["../../src/utils/project-code-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAoBH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CA8E9E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAsC7E"}