specweave 0.17.13 → 0.17.16

package/dist/src/core/cicd/state-manager.js

@@ -0,0 +1,197 @@
+/**
+ * CI/CD Monitor State Manager
+ *
+ * Manages persistent state for workflow monitoring, failure detection,
+ * and deduplication. Uses file-based storage with locking to prevent
+ * concurrent write corruption.
+ */
+import * as fs from 'fs-extra';
+import * as path from 'path';
+import { DEFAULT_STATE } from './types';
+/**
+ * State file path (relative to project root)
+ */
+const STATE_FILE = '.specweave/state/cicd-monitor.json';
+/**
+ * Lock file path (prevents concurrent writes)
+ */
+const LOCK_FILE = '.specweave/state/cicd-monitor.lock';
+/**
+ * Lock timeout (milliseconds)
+ */
+const LOCK_TIMEOUT = 5000;
+/**
+ * StateManager - Manages CI/CD monitor persistent state
+ *
+ * Features:
+ * - File-based JSON storage
+ * - File locking to prevent corruption
+ * - Automatic directory creation
+ * - State migration support
+ * - Deduplication tracking
+ */
+export class StateManager {
+    /**
+     * Create state manager
+     *
+     * @param rootDir - Project root directory (defaults to cwd)
+     */
+    constructor(rootDir = process.cwd()) {
+        this.statePath = path.join(rootDir, STATE_FILE);
+        this.lockPath = path.join(rootDir, LOCK_FILE);
+    }
+    /**
+     * Load state from disk
+     *
+     * @returns Current state (or default if file doesn't exist)
+     */
+    async loadState() {
+        try {
+            // Ensure directory exists
+            await fs.ensureDir(path.dirname(this.statePath));
+            // Check if state file exists
+            if (!(await fs.pathExists(this.statePath))) {
+                // Initialize with default state
+                await this.saveState(DEFAULT_STATE);
+                return { ...DEFAULT_STATE };
+            }
+            // Read and parse state
+            const content = await fs.readFile(this.statePath, 'utf-8');
+            const state = JSON.parse(content);
+            // Validate state structure
+            if (!state.failures || !state.version) {
+                console.warn('Invalid state file, resetting to default');
+                return { ...DEFAULT_STATE };
+            }
+            return state;
+        }
+        catch (error) {
+            console.error('Error loading state:', error);
+            return { ...DEFAULT_STATE };
+        }
+    }
+    /**
+     * Save state to disk with file locking
+     *
+     * @param state - State to save
+     */
+    async saveState(state) {
+        // Acquire lock
+        await this.acquireLock();
+        try {
+            // Ensure directory exists
+            await fs.ensureDir(path.dirname(this.statePath));
+            // Write state atomically (write to temp, then rename)
+            const tempPath = `${this.statePath}.tmp`;
+            await fs.writeFile(tempPath, JSON.stringify(state, null, 2), 'utf-8');
+            await fs.rename(tempPath, this.statePath);
+        }
+        finally {
+            // Always release lock
+            await this.releaseLock();
+        }
+    }
+    /**
+     * Mark failure as processed (deduplication)
+     *
+     * @param runId - Workflow run ID
+     */
+    async markProcessed(runId) {
+        const state = await this.loadState();
+        if (state.failures[runId]) {
+            state.failures[runId].processed = true;
+            state.totalProcessed++;
+            await this.saveState(state);
+        }
+    }
+    /**
+     * Get last poll timestamp
+     *
+     * @returns ISO 8601 timestamp or null
+     */
+    async getLastPoll() {
+        const state = await this.loadState();
+        return state.lastPoll;
+    }
+    /**
+     * Update last poll timestamp to now
+     */
+    async updateLastPoll() {
+        const state = await this.loadState();
+        state.lastPoll = new Date().toISOString();
+        await this.saveState(state);
+    }
+    /**
+     * Add failure record
+     *
+     * @param failure - Failure record to add
+     */
+    async addFailure(failure) {
+        const state = await this.loadState();
+        // Check for duplicate
+        if (state.failures[failure.runId]) {
+            console.log(`Failure ${failure.runId} already tracked, skipping`);
+            return;
+        }
+        // Add failure
+        state.failures[failure.runId] = failure;
+        state.totalFailures++;
+        await this.saveState(state);
+    }
+    /**
+     * Get all unprocessed failures
+     *
+     * @returns Array of unprocessed failure records
+     */
+    async getUnprocessedFailures() {
+        const state = await this.loadState();
+        return Object.values(state.failures).filter((failure) => !failure.processed);
+    }
+    /**
+     * Acquire file lock (with timeout)
+     *
+     * Prevents concurrent writes from corrupting state file.
+     */
+    async acquireLock() {
+        const startTime = Date.now();
+        while (true) {
+            try {
+                // Try to create lock file (exclusive)
+                await fs.writeFile(this.lockPath, process.pid.toString(), {
+                    flag: 'wx'
+                });
+                // Lock acquired!
+                return;
+            }
+            catch (error) {
+                // Lock file already exists
+                if (error.code === 'EEXIST') {
+                    // Check for timeout
+                    if (Date.now() - startTime > LOCK_TIMEOUT) {
+                        // Force release stale lock
+                        console.warn('Lock timeout, forcing release');
+                        await this.releaseLock();
+                        continue;
+                    }
+                    // Wait and retry
+                    await new Promise((resolve) => setTimeout(resolve, 50));
+                    continue;
+                }
+                // Other error
+                throw error;
+            }
+        }
+    }
+    /**
+     * Release file lock
+     */
+    async releaseLock() {
+        try {
+            await fs.remove(this.lockPath);
+        }
+        catch (error) {
+            // Ignore errors (lock file might not exist)
+        }
+    }
+}
+//# sourceMappingURL=state-manager.js.map

package/dist/src/core/cicd/state-manager.js.map

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

package/dist/src/core/cicd/types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * CI/CD Monitoring Type Definitions
+ *
+ * Core types for GitHub Actions workflow monitoring, failure detection,
+ * and state management.
+ */
+/**
+ * GitHub Actions workflow run status
+ */
+export type WorkflowStatus = 'queued' | 'in_progress' | 'completed';
+/**
+ * GitHub Actions workflow run conclusion
+ */
+export type WorkflowConclusion = 'success' | 'failure' | 'cancelled' | 'skipped' | 'timed_out' | 'action_required' | 'neutral';
+/**
+ * Workflow run metadata from GitHub API
+ */
+export interface WorkflowRun {
+    /** Unique run ID */
+    id: number;
+    /** Workflow name (e.g., "CI", "Deploy") */
+    name: string;
+    /** Run number (sequential per workflow) */
+    run_number: number;
+    /** Git commit SHA */
+    head_sha: string;
+    /** Branch name */
+    head_branch: string;
+    /** Run status */
+    status: WorkflowStatus;
+    /** Run conclusion (only when status=completed) */
+    conclusion: WorkflowConclusion | null;
+    /** ISO 8601 timestamp */
+    created_at: string;
+    /** ISO 8601 timestamp */
+    updated_at: string;
+    /** HTML URL to view run */
+    html_url: string;
+    /** GitHub repository (owner/repo) */
+    repository: string;
+}
+/**
+ * Failure record stored in state
+ */
+export interface FailureRecord {
+    /** Workflow run ID */
+    runId: number;
+    /** Workflow name */
+    workflowName: string;
+    /** Git commit SHA */
+    commitSha: string;
+    /** Branch name */
+    branch: string;
+    /** Failure timestamp */
+    detectedAt: string;
+    /** Processing status */
+    processed: boolean;
+    /** Analysis status */
+    analyzed: boolean;
+    /** Fix applied status */
+    fixed: boolean;
+    /** GitHub URL */
+    url: string;
+}
+/**
+ * CI/CD monitor state
+ */
+export interface CICDMonitorState {
+    /** Last poll timestamp (ISO 8601) */
+    lastPoll: string | null;
+    /** Failure records (keyed by run ID) */
+    failures: Record<number, FailureRecord>;
+    /** Total failures detected */
+    totalFailures: number;
+    /** Total failures processed */
+    totalProcessed: number;
+    /** Total failures fixed */
+    totalFixed: number;
+    /** Monitor version (for migrations) */
+    version: string;
+}
+/**
+ * State manager interface
+ */
+export interface IStateManager {
+    /**
+     * Load state from disk
+     */
+    loadState(): Promise<CICDMonitorState>;
+    /**
+     * Save state to disk
+     */
+    saveState(state: CICDMonitorState): Promise<void>;
+    /**
+     * Mark failure as processed (deduplication)
+     */
+    markProcessed(runId: number): Promise<void>;
+    /**
+     * Get last poll timestamp
+     */
+    getLastPoll(): Promise<string | null>;
+    /**
+     * Update last poll timestamp
+     */
+    updateLastPoll(): Promise<void>;
+    /**
+     * Add failure record
+     */
+    addFailure(failure: FailureRecord): Promise<void>;
+    /**
+     * Get all unprocessed failures
+     */
+    getUnprocessedFailures(): Promise<FailureRecord[]>;
+}
+/**
+ * Default empty state
+ */
+export declare const DEFAULT_STATE: CICDMonitorState;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/cicd/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/cicd/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,aAAa,GACb,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,SAAS,GACT,WAAW,GACX,SAAS,GACT,WAAW,GACX,iBAAiB,GACjB,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oBAAoB;IACpB,EAAE,EAAE,MAAM,CAAC;IAEX,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IAEb,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IAEnB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IAEjB,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IAEpB,iBAAiB;IACjB,MAAM,EAAE,cAAc,CAAC;IAEvB,kDAAkD;IAClD,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAEtC,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IAEnB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IAEnB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IAEjB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IAEd,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IAErB,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAElB,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IAEf,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IAEnB,wBAAwB;IACxB,SAAS,EAAE,OAAO,CAAC;IAEnB,sBAAsB;IACtB,QAAQ,EAAE,OAAO,CAAC;IAElB,yBAAyB;IACzB,KAAK,EAAE,OAAO,CAAC;IAEf,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAExC,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAC;IAEtB,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAC;IAEvB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IAEnB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEvC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEtC;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD;;OAEG;IACH,sBAAsB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,gBAO3B,CAAC"}

package/dist/src/core/cicd/types.js

@@ -0,0 +1,18 @@
+/**
+ * CI/CD Monitoring Type Definitions
+ *
+ * Core types for GitHub Actions workflow monitoring, failure detection,
+ * and state management.
+ */
+/**
+ * Default empty state
+ */
+export const DEFAULT_STATE = {
+    lastPoll: null,
+    failures: {},
+    totalFailures: 0,
+    totalProcessed: 0,
+    totalFixed: 0,
+    version: '1.0.0'
+};
+//# sourceMappingURL=types.js.map

package/dist/src/core/cicd/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/cicd/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2JH;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAqB;IAC7C,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,EAAE;IACZ,aAAa,EAAE,CAAC;IAChB,cAAc,EAAE,CAAC;IACjB,UAAU,EAAE,CAAC;IACb,OAAO,EAAE,OAAO;CACjB,CAAC"}

package/dist/src/core/cicd/workflow-monitor.d.ts

@@ -0,0 +1,98 @@
+/**
+ * CI/CD Workflow Monitor
+ *
+ * Monitors GitHub Actions workflows for failures by polling the GitHub API
+ * every 60 seconds. Uses conditional requests and rate limit handling for
+ * efficient API usage.
+ */
+import { StateManager } from './state-manager';
+/**
+ * Monitor configuration
+ */
+export interface MonitorConfig {
+    /** GitHub API token */
+    token: string;
+    /** Repository owner */
+    owner: string;
+    /** Repository name */
+    repo: string;
+    /** Poll interval (milliseconds, default: 60000 = 60s) */
+    pollInterval?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * Poll result
+ */
+export interface PollResult {
+    /** Total runs checked */
+    totalRuns: number;
+    /** New failures detected */
+    newFailures: number;
+    /** Failures already tracked */
+    duplicates: number;
+    /** HTTP status code */
+    statusCode: number;
+    /** Rate limit remaining */
+    rateLimitRemaining: number;
+}
+/**
+ * WorkflowMonitor - Polls GitHub Actions for workflow failures
+ *
+ * Features:
+ * - Polls every 60 seconds (configurable)
+ * - Detects failed workflow runs within 2 minutes
+ * - Uses conditional requests (If-Modified-Since) to reduce API calls
+ * - Handles rate limiting with exponential backoff
+ * - Deduplicates failures via StateManager
+ * - Extracts comprehensive workflow metadata
+ */
+export declare class WorkflowMonitor {
+    private octokit;
+    private stateManager;
+    private config;
+    private pollingTimer;
+    private lastModified;
+    private isPolling;
+    /**
+     * Create workflow monitor
+     *
+     * @param config - Monitor configuration
+     * @param stateManager - State manager instance (optional, creates new if not provided)
+     */
+    constructor(config: MonitorConfig, stateManager?: StateManager);
+    /**
+     * Start monitoring (begins polling)
+     */
+    start(): void;
+    /**
+     * Stop monitoring (stops polling)
+     */
+    stop(): void;
+    /**
+     * Check if monitor is running
+     */
+    isRunning(): boolean;
+    /**
+     * Poll GitHub Actions API for workflow runs
+     *
+     * @returns Poll result with statistics
+     */
+    poll(): Promise<PollResult>;
+    /**
+     * Extract failure record from GitHub workflow run
+     *
+     * @param run - GitHub workflow run data
+     * @returns Failure record for state storage
+     */
+    private extractFailureRecord;
+    /**
+     * Sleep for specified milliseconds
+     */
+    private sleep;
+    /**
+     * Debug logging
+     */
+    private log;
+}
+//# sourceMappingURL=workflow-monitor.d.ts.map

package/dist/src/core/cicd/workflow-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-monitor.d.ts","sourceRoot":"","sources":["../../../../src/core/cicd/workflow-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAQ/C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IAEd,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IAEd,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IAEb,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IAEpB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IAEnB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IAEnB,2BAA2B;IAC3B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,SAAS,CAAS;IAE1B;;;;;OAKG;gBAED,MAAM,EAAE,aAAa,EACrB,YAAY,GAAE,YAAiC;IAoBjD;;OAEG;IACH,KAAK,IAAI,IAAI;IAwBb;;OAEG;IACH,IAAI,IAAI,IAAI;IAiBZ;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IA6GjC;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ"}

package/dist/src/core/cicd/workflow-monitor.js

@@ -0,0 +1,215 @@
+/**
+ * CI/CD Workflow Monitor
+ *
+ * Monitors GitHub Actions workflows for failures by polling the GitHub API
+ * every 60 seconds. Uses conditional requests and rate limit handling for
+ * efficient API usage.
+ */
+import { Octokit } from '@octokit/rest';
+import { StateManager } from './state-manager';
+/**
+ * WorkflowMonitor - Polls GitHub Actions for workflow failures
+ *
+ * Features:
+ * - Polls every 60 seconds (configurable)
+ * - Detects failed workflow runs within 2 minutes
+ * - Uses conditional requests (If-Modified-Since) to reduce API calls
+ * - Handles rate limiting with exponential backoff
+ * - Deduplicates failures via StateManager
+ * - Extracts comprehensive workflow metadata
+ */
+export class WorkflowMonitor {
+    /**
+     * Create workflow monitor
+     *
+     * @param config - Monitor configuration
+     * @param stateManager - State manager instance (optional, creates new if not provided)
+     */
+    constructor(config, stateManager = new StateManager()) {
+        this.pollingTimer = null;
+        this.lastModified = null;
+        this.isPolling = false;
+        // Validate config
+        if (!config.token) {
+            throw new Error('GitHub token is required');
+        }
+        if (!config.owner || !config.repo) {
+            throw new Error('Repository owner and name are required');
+        }
+        this.config = {
+            ...config,
+            pollInterval: config.pollInterval ?? 60000, // Default: 60s
+            debug: config.debug ?? false
+        };
+        this.octokit = new Octokit({ auth: config.token });
+        this.stateManager = stateManager;
+    }
+    /**
+     * Start monitoring (begins polling)
+     */
+    start() {
+        if (this.isPolling) {
+            this.log('Monitor already running');
+            return;
+        }
+        this.log('Starting monitor...');
+        this.isPolling = true;
+        // Initial poll
+        this.poll().catch((error) => {
+            console.error('Initial poll failed:', error);
+        });
+        // Schedule recurring polls
+        this.pollingTimer = setInterval(() => {
+            this.poll().catch((error) => {
+                console.error('Poll failed:', error);
+            });
+        }, this.config.pollInterval);
+        this.log(`Monitor started (polling every ${this.config.pollInterval}ms)`);
+    }
+    /**
+     * Stop monitoring (stops polling)
+     */
+    stop() {
+        if (!this.isPolling) {
+            this.log('Monitor not running');
+            return;
+        }
+        this.log('Stopping monitor...');
+        if (this.pollingTimer) {
+            clearInterval(this.pollingTimer);
+            this.pollingTimer = null;
+        }
+        this.isPolling = false;
+        this.log('Monitor stopped');
+    }
+    /**
+     * Check if monitor is running
+     */
+    isRunning() {
+        return this.isPolling;
+    }
+    /**
+     * Poll GitHub Actions API for workflow runs
+     *
+     * @returns Poll result with statistics
+     */
+    async poll() {
+        this.log('Polling GitHub Actions API...');
+        try {
+            // Build request headers
+            const headers = {};
+            if (this.lastModified) {
+                headers['If-Modified-Since'] = this.lastModified;
+            }
+            // Fetch workflow runs
+            const response = await this.octokit.rest.actions.listWorkflowRunsForRepo({
+                owner: this.config.owner,
+                repo: this.config.repo,
+                status: 'completed', // Only completed runs
+                per_page: 100, // Max per page
+                headers
+            });
+            // Extract rate limit info
+            const rateLimitRemaining = parseInt(response.headers['x-ratelimit-remaining'] || '0', 10);
+            this.log(`Rate limit remaining: ${rateLimitRemaining}`);
+            // Handle 304 Not Modified (no new runs)
+            // Note: Octokit types response.status as 200, but API can return 304
+            if (response.status === 304) {
+                this.log('No new workflow runs (304 Not Modified)');
+                return {
+                    totalRuns: 0,
+                    newFailures: 0,
+                    duplicates: 0,
+                    statusCode: 304,
+                    rateLimitRemaining
+                };
+            }
+            // Update Last-Modified header for next request
+            if (response.headers['last-modified']) {
+                this.lastModified = response.headers['last-modified'];
+            }
+            // Filter failed runs
+            const failedRuns = response.data.workflow_runs.filter((run) => run.conclusion === 'failure');
+            this.log(`Found ${failedRuns.length} failed runs (of ${response.data.workflow_runs.length} total)`);
+            // Process failures
+            let newFailures = 0;
+            let duplicates = 0;
+            for (const run of failedRuns) {
+                const failure = this.extractFailureRecord(run);
+                // Check if already tracked
+                const state = await this.stateManager.loadState();
+                if (state.failures[run.id]) {
+                    duplicates++;
+                    continue;
+                }
+                // Add new failure
+                await this.stateManager.addFailure(failure);
+                newFailures++;
+                this.log(`New failure detected: ${run.name} (run #${run.run_number})`);
+            }
+            // Update last poll timestamp
+            await this.stateManager.updateLastPoll();
+            return {
+                totalRuns: response.data.workflow_runs.length,
+                newFailures,
+                duplicates,
+                statusCode: response.status,
+                rateLimitRemaining
+            };
+        }
+        catch (error) {
+            // Handle rate limiting (429)
+            if (error.status === 429) {
+                const retryAfter = parseInt(error.response?.headers['retry-after'] || '60', 10);
+                console.warn(`Rate limited! Retry after ${retryAfter}s`);
+                // Exponential backoff
+                await this.sleep(retryAfter * 1000);
+                // Retry poll
+                return this.poll();
+            }
+            // Handle other errors
+            console.error('Poll error:', error.message);
+            return {
+                totalRuns: 0,
+                newFailures: 0,
+                duplicates: 0,
+                statusCode: error.status || 500,
+                rateLimitRemaining: 0
+            };
+        }
+    }
+    /**
+     * Extract failure record from GitHub workflow run
+     *
+     * @param run - GitHub workflow run data
+     * @returns Failure record for state storage
+     */
+    extractFailureRecord(run) {
+        return {
+            runId: run.id,
+            workflowName: run.name,
+            commitSha: run.head_sha,
+            branch: run.head_branch,
+            detectedAt: new Date().toISOString(),
+            processed: false,
+            analyzed: false,
+            fixed: false,
+            url: run.html_url
+        };
+    }
+    /**
+     * Sleep for specified milliseconds
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Debug logging
+     */
+    log(message) {
+        if (this.config.debug) {
+            console.log(`[WorkflowMonitor] ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=workflow-monitor.js.map

package/dist/src/core/cicd/workflow-monitor.js.map

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