@ameshkin/ticket-mate 0.1.20

package/public/batch/batch-execute.js

@@ -0,0 +1,182 @@
+/**
+ * Batch Execute
+
+ *
+ * Execute multiple tickets sequentially (for safety) with queue management.
+ */
+import { executeTicket } from "../ai/workflow";
+import { logger } from "../utils/logger";
+import { getErrorMessage } from "../types/common";
+/**
+ * Execute multiple tickets sequentially
+ *
+ * Sequential execution ensures safety and prevents conflicts.
+ *
+ * @param tickets Array of ticket keys to execute
+ * @param options Execution options
+ * @returns Batch execution result
+ */
+export async function batchExecute(tickets, options) {
+    const { repoRoot, baseDir = ".orchestrator", dryRun = false, skipTests = false, continueOnError = true, } = options;
+    logger.info("Starting batch execution", {
+        ticketCount: tickets.length,
+        dryRun,
+        repoRoot,
+    });
+    const startTime = Date.now();
+    const results = [];
+    const errors = [];
+    for (let i = 0; i < tickets.length; i++) {
+        const ticketKey = tickets[i];
+        logger.info("Processing ticket", {
+            ticketKey,
+            progress: `${i + 1}/${tickets.length}`,
+        });
+        try {
+            const result = await executeTicket({
+                ticketKey,
+                repoRoot,
+                baseDir,
+                dryRun,
+                skipTests,
+            });
+            results.push({ ticketKey, result });
+            if (result.success) {
+                logger.info("Ticket executed successfully", { ticketKey });
+            }
+            else {
+                logger.warn("Ticket execution failed", {
+                    ticketKey,
+                    error: result.error,
+                });
+                if (!continueOnError) {
+                    logger.error("Stopping batch execution due to error", { ticketKey });
+                    break;
+                }
+            }
+        }
+        catch (error) {
+            logger.error("Ticket execution error", {
+                ticketKey,
+                error: getErrorMessage(error),
+            });
+            errors.push({
+                ticketKey,
+                error: getErrorMessage(error),
+            });
+            if (!continueOnError) {
+                logger.error("Stopping batch execution due to error", { ticketKey });
+                break;
+            }
+        }
+    }
+    const duration = Date.now() - startTime;
+    const successful = results.filter((r) => r.result.success).length;
+    const failed = results.length - successful + errors.length;
+    const batchResult = {
+        success: failed === 0,
+        total: tickets.length,
+        successful,
+        failed,
+        results,
+        errors,
+        duration,
+    };
+    logger.info("Batch execution completed", {
+        total: batchResult.total,
+        successful: batchResult.successful,
+        failed: batchResult.failed,
+        duration,
+    });
+    return batchResult;
+}
+/**
+ * Queue management for batch execution
+ */
+export class ExecutionQueue {
+    queue = [];
+    processing = false;
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Add ticket to queue
+     */
+    enqueue(ticketKey) {
+        if (!this.queue.includes(ticketKey)) {
+            this.queue.push(ticketKey);
+            logger.debug("Ticket added to queue", { ticketKey, queueSize: this.queue.length });
+        }
+    }
+    /**
+     * Add multiple tickets to queue
+     */
+    enqueueMany(ticketKeys) {
+        for (const ticketKey of ticketKeys) {
+            this.enqueue(ticketKey);
+        }
+    }
+    /**
+     * Remove ticket from queue
+     */
+    dequeue() {
+        return this.queue.shift();
+    }
+    /**
+     * Get queue size
+     */
+    size() {
+        return this.queue.length;
+    }
+    /**
+     * Check if queue is empty
+     */
+    isEmpty() {
+        return this.queue.length === 0;
+    }
+    /**
+     * Clear queue
+     */
+    clear() {
+        this.queue = [];
+        logger.info("Queue cleared");
+    }
+    /**
+     * Process queue
+     */
+    async process() {
+        if (this.processing) {
+            throw new Error("Queue is already being processed");
+        }
+        if (this.isEmpty()) {
+            return {
+                success: true,
+                total: 0,
+                successful: 0,
+                failed: 0,
+                results: [],
+                errors: [],
+                duration: 0,
+            };
+        }
+        this.processing = true;
+        logger.info("Processing execution queue", { queueSize: this.queue.length });
+        try {
+            const tickets = [...this.queue];
+            this.clear();
+            const result = await batchExecute(tickets, this.options);
+            return result;
+        }
+        finally {
+            this.processing = false;
+        }
+    }
+    /**
+     * Check if queue is being processed
+     */
+    isProcessing() {
+        return this.processing;
+    }
+}
+//# sourceMappingURL=batch-execute.js.map

package/public/batch/batch-execute.js.map

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

package/public/batch/batch-sync.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Batch Sync Operations
+
+ *
+ * Sync multiple tickets in parallel with progress tracking and error aggregation
+ */
+import type { SyncResult } from "../types";
+/**
+ * Batch sync options
+ */
+export interface BatchSyncOptions {
+    ticketKeys: string[];
+    baseDir?: string;
+    maxConcurrency?: number;
+    onProgress?: (progress: BatchProgress) => void;
+}
+/**
+ * Batch progress information
+ */
+export interface BatchProgress {
+    total: number;
+    completed: number;
+    failed: number;
+    current?: string;
+}
+/**
+ * Batch result
+ */
+export interface BatchResult {
+    total: number;
+    successful: number;
+    failed: number;
+    results: Array<{
+        ticketKey: string;
+        success: boolean;
+        result?: SyncResult;
+        error?: string;
+    }>;
+}
+/**
+ * Batch sync multiple tickets
+ *
+ * Syncs tickets in parallel (with concurrency limit) and aggregates results
+ */
+export declare function batchSync(options: BatchSyncOptions): Promise<BatchResult>;
+//# sourceMappingURL=batch-sync.d.ts.map

package/public/batch/batch-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-sync.d.ts","sourceRoot":"","sources":["../../src/batch/batch-sync.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,UAAU,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAkF/E"}

package/public/batch/batch-sync.js

@@ -0,0 +1,83 @@
+/**
+ * Batch Sync Operations
+
+ *
+ * Sync multiple tickets in parallel with progress tracking and error aggregation
+ */
+import { getJiraConfig } from "../config/config";
+import { syncSingleTicket } from "../sync/sync-engine";
+import { logger } from "../utils/logger";
+import { startOperation, recordSuccess, recordFailure } from "../observability/metrics";
+import { getErrorMessage } from "../types/common";
+/**
+ * Batch sync multiple tickets
+ *
+ * Syncs tickets in parallel (with concurrency limit) and aggregates results
+ */
+export async function batchSync(options) {
+    const { ticketKeys, baseDir = ".orchestrator", maxConcurrency = 5, onProgress, } = options;
+    const config = getJiraConfig();
+    const results = [];
+    let completed = 0;
+    let failed = 0;
+    // Process tickets in batches
+    for (let i = 0; i < ticketKeys.length; i += maxConcurrency) {
+        const batch = ticketKeys.slice(i, i + maxConcurrency);
+        const batchPromises = batch.map(async (ticketKey) => {
+            const stopTiming = startOperation("batch_sync");
+            try {
+                if (onProgress) {
+                    onProgress({
+                        total: ticketKeys.length,
+                        completed,
+                        failed,
+                        current: ticketKey,
+                    });
+                }
+                const result = await syncSingleTicket(ticketKey, config, {
+                    baseDir,
+                    generateReports: false,
+                    generateIndex: false,
+                });
+                stopTiming();
+                recordSuccess("batch_sync");
+                completed++;
+                results.push({
+                    ticketKey,
+                    success: result.success,
+                    result,
+                });
+                return { ticketKey, success: true, result };
+            }
+            catch (error) {
+                stopTiming();
+                recordFailure("batch_sync", getErrorMessage(error));
+                failed++;
+                completed++;
+                const errorResult = {
+                    ticketKey,
+                    success: false,
+                    error: getErrorMessage(error),
+                };
+                results.push(errorResult);
+                logger.error("Batch sync failed for ticket", { ticketKey, error: getErrorMessage(error) });
+                return errorResult;
+            }
+        });
+        await Promise.all(batchPromises);
+        if (onProgress) {
+            onProgress({
+                total: ticketKeys.length,
+                completed,
+                failed,
+            });
+        }
+    }
+    return {
+        total: ticketKeys.length,
+        successful: results.filter((r) => r.success).length,
+        failed,
+        results,
+    };
+}
+//# sourceMappingURL=batch-sync.js.map

package/public/batch/batch-sync.js.map

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

package/public/cache/cache.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Caching & Performance
+
+ *
+ * Cache Jira API responses and ticket briefs with TTL-based invalidation.
+ * Optional Redis backend support via interface.
+ */
+/**
+ * Cache interface for optional Redis backend
+ */
+export interface CacheBackend {
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, ttlSeconds: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+/**
+ * Cache manager
+ */
+export declare class Cache {
+    private backend;
+    private enabled;
+    constructor(backend?: CacheBackend, enabled?: boolean);
+    /**
+     * Get value from cache
+     */
+    get<T>(key: string): Promise<T | null>;
+    /**
+     * Set value in cache
+     */
+    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    /**
+     * Delete value from cache
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Clear all cache entries
+     */
+    clear(): Promise<void>;
+    /**
+     * Enable or disable cache
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Check if cache is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Generate cache key for Jira issue
+     */
+    static keyForIssue(issueKey: string): string;
+    /**
+     * Generate cache key for ticket brief
+     */
+    static keyForBrief(ticketKey: string): string;
+    /**
+     * Generate cache key for Jira API endpoint
+     */
+    static keyForEndpoint(endpoint: string, params?: Record<string, any>): string;
+}
+/**
+ * Get or create global cache instance
+ */
+export declare function getCache(backend?: CacheBackend, enabled?: boolean): Cache;
+//# sourceMappingURL=cache.d.ts.map

package/public/cache/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/cache/cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA8ED;;GAEG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,OAAO,CAAU;gBAEb,OAAO,CAAC,EAAE,YAAY,EAAE,OAAO,GAAE,OAAc;IAK3D;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAmB5C;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,GAAE,MAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7E;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKlC;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI5C;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAI7C;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM;CAI9E;AAOD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,OAAO,GAAE,OAAc,GAAG,KAAK,CAK/E"}

package/public/cache/cache.js

@@ -0,0 +1,198 @@
+/**
+ * Caching & Performance
+
+ *
+ * Cache Jira API responses and ticket briefs with TTL-based invalidation.
+ * Optional Redis backend support via interface.
+ */
+import { logger } from "../utils/logger";
+import { getErrorMessage } from "../types/common";
+/**
+ * In-memory cache implementation
+ */
+class MemoryCache {
+    cache = new Map();
+    cleanupInterval = null;
+    constructor() {
+        // Cleanup expired entries every minute
+        this.cleanupInterval = setInterval(() => {
+            this.cleanup();
+        }, 60000);
+    }
+    async get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return null;
+        }
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            return null;
+        }
+        return entry.value;
+    }
+    async set(key, value, ttlSeconds) {
+        const expiresAt = Date.now() + ttlSeconds * 1000;
+        this.cache.set(key, {
+            value,
+            expiresAt,
+            createdAt: Date.now(),
+        });
+    }
+    async delete(key) {
+        this.cache.delete(key);
+    }
+    async clear() {
+        this.cache.clear();
+    }
+    cleanup() {
+        const now = Date.now();
+        for (const [key, entry] of this.cache.entries()) {
+            if (now > entry.expiresAt) {
+                this.cache.delete(key);
+            }
+        }
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        return {
+            size: this.cache.size,
+            entries: this.cache.size,
+        };
+    }
+    /**
+     * Destroy cache and cleanup interval
+     */
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        this.cache.clear();
+    }
+}
+/**
+ * Cache manager
+ */
+export class Cache {
+    backend;
+    enabled;
+    constructor(backend, enabled = true) {
+        this.backend = backend || new MemoryCache();
+        this.enabled = enabled;
+    }
+    /**
+     * Get value from cache
+     */
+    async get(key) {
+        if (!this.enabled) {
+            return null;
+        }
+        try {
+            const value = await this.backend.get(key);
+            if (value !== null) {
+                logger.debug("Cache hit", { key });
+            }
+            else {
+                logger.debug("Cache miss", { key });
+            }
+            return value;
+        }
+        catch (error) {
+            logger.error("Cache get error", { key, error: getErrorMessage(error) });
+            return null;
+        }
+    }
+    /**
+     * Set value in cache
+     */
+    async set(key, value, ttlSeconds = 3600) {
+        if (!this.enabled) {
+            return;
+        }
+        try {
+            await this.backend.set(key, value, ttlSeconds);
+            logger.debug("Cache set", { key, ttlSeconds });
+        }
+        catch (error) {
+            logger.error("Cache set error", { key, error: getErrorMessage(error) });
+        }
+    }
+    /**
+     * Delete value from cache
+     */
+    async delete(key) {
+        if (!this.enabled) {
+            return;
+        }
+        try {
+            await this.backend.delete(key);
+            logger.debug("Cache delete", { key });
+        }
+        catch (error) {
+            logger.error("Cache delete error", { key, error: getErrorMessage(error) });
+        }
+    }
+    /**
+     * Clear all cache entries
+     */
+    async clear() {
+        if (!this.enabled) {
+            return;
+        }
+        try {
+            await this.backend.clear();
+            logger.info("Cache cleared");
+        }
+        catch (error) {
+            logger.error("Cache clear error", { error: getErrorMessage(error) });
+        }
+    }
+    /**
+     * Enable or disable cache
+     */
+    setEnabled(enabled) {
+        this.enabled = enabled;
+        logger.info("Cache enabled", { enabled });
+    }
+    /**
+     * Check if cache is enabled
+     */
+    isEnabled() {
+        return this.enabled;
+    }
+    /**
+     * Generate cache key for Jira issue
+     */
+    static keyForIssue(issueKey) {
+        return `jira:issue:${issueKey}`;
+    }
+    /**
+     * Generate cache key for ticket brief
+     */
+    static keyForBrief(ticketKey) {
+        return `brief:${ticketKey}`;
+    }
+    /**
+     * Generate cache key for Jira API endpoint
+     */
+    static keyForEndpoint(endpoint, params) {
+        const paramStr = params ? `:${JSON.stringify(params)}` : "";
+        return `api:${endpoint}${paramStr}`;
+    }
+}
+/**
+ * Global cache instance
+ */
+let globalCache = null;
+/**
+ * Get or create global cache instance
+ */
+export function getCache(backend, enabled = true) {
+    if (!globalCache) {
+        globalCache = new Cache(backend, enabled);
+    }
+    return globalCache;
+}
+//# sourceMappingURL=cache.js.map

package/public/cache/cache.js.map

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

package/public/cache/etag.d.ts

@@ -0,0 +1,51 @@
+/**
+ * ETag Support for Jira API
+ *
+ * Implements ETag-based conditional requests to reduce API calls.
+ */
+/**
+ * ETag manager
+ */
+export declare class ETagManager {
+    private cache;
+    /**
+     * Get ETag for a resource
+     */
+    getETag(key: string): Promise<string | null>;
+    /**
+     * Set ETag for a resource
+     */
+    setETag(key: string, etag: string, lastModified?: string): Promise<void>;
+    /**
+     * Build If-None-Match header for conditional request
+     */
+    buildConditionalHeaders(key: string): Promise<Record<string, string>>;
+    /**
+     * Check if response is not modified (304)
+     */
+    isNotModified(statusCode: number): boolean;
+    /**
+     * Extract ETag from response headers
+     */
+    extractETag(headers: Headers | Record<string, string>): string | null;
+    /**
+     * Extract Last-Modified from response headers
+     */
+    extractLastModified(headers: Headers | Record<string, string>): string | null;
+    /**
+     * Process response and update ETag cache
+     */
+    processResponse(key: string, response: Response, data?: any): Promise<{
+        notModified: boolean;
+        data?: any;
+    }>;
+    /**
+     * Clear ETag for a resource
+     */
+    clearETag(key: string): Promise<void>;
+}
+/**
+ * Get or create global ETag manager
+ */
+export declare function getETagManager(): ETagManager;
+//# sourceMappingURL=etag.d.ts.map

package/public/cache/etag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"etag.d.ts","sourceRoot":"","sources":["../../src/cache/etag.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAc;IAE3B;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKlD;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9E;;OAEG;IACG,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAU3E;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI1C;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI;IAarE;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI;IAQ7E;;OAEG;IACG,eAAe,CACnB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,QAAQ,EAClB,IAAI,CAAC,EAAE,GAAG,GACT,OAAO,CAAC;QAAE,WAAW,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IAgBhD;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAI5C;AAOD;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAK5C"}