@generacy-ai/generacy-plugin-github-actions 0.0.0-preview-20260304013206

package/dist/plugin.js

@@ -0,0 +1,471 @@
+import { AbstractCICDPlugin } from '@generacy-ai/latency-plugin-ci-cd';
+import { createClient } from './client.js';
+import { parseConfig } from './types/config.js';
+import { triggerWorkflow, triggerWorkflowDispatch, getWorkflowId, listWorkflows } from './operations/workflows.js';
+import { getWorkflowRun, listWorkflowRuns, cancelWorkflowRun, rerunWorkflowRun, rerunFailedJobs, } from './operations/runs.js';
+import { getJobs, getJob, getJobLogs, getFailedJobs } from './operations/jobs.js';
+import { listArtifacts, getArtifact, downloadArtifact, deleteArtifact, listRepoArtifacts, } from './operations/artifacts.js';
+import { createCheckRun, updateCheckRun, getCheckRun, listCheckRuns, listCheckRunsForSuite, } from './operations/check-runs.js';
+import { createStatusPoller, pollUntilComplete, waitForRun } from './polling/status-poller.js';
+import { createEventEmitter } from './events/emitter.js';
+/**
+ * Plugin manifest declaration
+ */
+export const PLUGIN_MANIFEST = {
+    name: '@generacy-ai/generacy-plugin-github-actions',
+    version: '0.1.0',
+    provides: ['GitHubActions', 'CICDPipeline'],
+    requires: [
+        { facet: 'EventBus', optional: false },
+    ],
+    optionalRequires: [
+        { facet: 'IssueTracker', optional: true },
+    ],
+};
+/**
+ * GitHubActionsPlugin - Main plugin class
+ *
+ * Extends AbstractCICDPlugin to provide the standard CICDPipeline interface
+ * (triggerPipeline, getPipelineStatus, cancelPipeline, listPipelines) while
+ * also exposing GitHub Actions-specific functionality.
+ */
+export class GitHubActionsPlugin extends AbstractCICDPlugin {
+    client;
+    config;
+    eventEmitter;
+    issueTracker = null;
+    constructor(config, eventBus) {
+        super();
+        this.config = parseConfig(config);
+        this.client = createClient(this.config);
+        this.eventEmitter = eventBus ? createEventEmitter(eventBus) : null;
+    }
+    /**
+     * Set the issue tracker facet for optional integration
+     */
+    setIssueTracker(tracker) {
+        this.issueTracker = tracker;
+    }
+    // ==========================================================================
+    // AbstractCICDPlugin abstract method implementations
+    // ==========================================================================
+    /**
+     * Trigger a pipeline run (implements abstract method).
+     *
+     * Maps to GitHub Actions workflow dispatch.
+     */
+    async doTrigger(pipelineId, options) {
+        const ref = options?.branch ?? 'main';
+        const run = await triggerWorkflowDispatch(this.client, pipelineId, ref, options?.parameters);
+        return this.mapWorkflowRunToPipelineRun(run);
+    }
+    /**
+     * Get pipeline run status (implements abstract method).
+     *
+     * Maps to getWorkflowRun.
+     */
+    async doGetStatus(runId) {
+        const run = await getWorkflowRun(this.client, parseInt(runId, 10));
+        return this.mapWorkflowRunToPipelineRun(run);
+    }
+    /**
+     * Cancel a pipeline run (implements abstract method).
+     *
+     * Maps to cancelWorkflowRun.
+     */
+    async doCancel(runId) {
+        await cancelWorkflowRun(this.client, parseInt(runId, 10));
+    }
+    /**
+     * List available pipelines (implements abstract method).
+     *
+     * Maps to listWorkflows.
+     */
+    async doListPipelines() {
+        const workflows = await listWorkflows(this.client);
+        return workflows.map((workflow) => this.mapWorkflowToPipeline(workflow));
+    }
+    // ==========================================================================
+    // GitHub Actions-specific public API (for backwards compatibility)
+    // ==========================================================================
+    /**
+     * Trigger a workflow by filename or ID
+     */
+    async triggerWorkflow(params) {
+        return triggerWorkflow(this.client, params);
+    }
+    /**
+     * Trigger a workflow dispatch event
+     */
+    async triggerWorkflowDispatch(workflow, ref, inputs) {
+        return triggerWorkflowDispatch(this.client, workflow, ref, inputs);
+    }
+    /**
+     * Get workflow ID by filename
+     */
+    async getWorkflowId(filename) {
+        return getWorkflowId(this.client, filename);
+    }
+    // ============================================
+    // Run Monitoring & Control
+    // ============================================
+    /**
+     * Get a workflow run by ID
+     */
+    async getWorkflowRun(runId) {
+        return getWorkflowRun(this.client, runId);
+    }
+    /**
+     * List workflow runs for a workflow
+     */
+    async listWorkflowRuns(workflow, options) {
+        return listWorkflowRuns(this.client, workflow, options);
+    }
+    /**
+     * Cancel a workflow run
+     */
+    async cancelWorkflowRun(runId) {
+        return cancelWorkflowRun(this.client, runId);
+    }
+    /**
+     * Re-run a workflow
+     */
+    async rerunWorkflowRun(runId) {
+        return rerunWorkflowRun(this.client, runId);
+    }
+    /**
+     * Re-run failed jobs in a workflow
+     */
+    async rerunFailedJobs(runId) {
+        return rerunFailedJobs(this.client, runId);
+    }
+    // ============================================
+    // Job & Log Operations
+    // ============================================
+    /**
+     * Get jobs for a workflow run
+     */
+    async getJobs(runId) {
+        return getJobs(this.client, runId);
+    }
+    /**
+     * Get a specific job by ID
+     */
+    async getJob(jobId) {
+        return getJob(this.client, jobId);
+    }
+    /**
+     * Download job logs
+     */
+    async getJobLogs(jobId) {
+        return getJobLogs(this.client, jobId);
+    }
+    /**
+     * Get failed jobs from a workflow run
+     */
+    async getFailedJobs(runId) {
+        return getFailedJobs(this.client, runId);
+    }
+    // ============================================
+    // Artifact Operations
+    // ============================================
+    /**
+     * List artifacts for a workflow run
+     */
+    async listArtifacts(runId) {
+        return listArtifacts(this.client, runId);
+    }
+    /**
+     * Get an artifact by ID
+     */
+    async getArtifact(artifactId) {
+        return getArtifact(this.client, artifactId);
+    }
+    /**
+     * Download an artifact
+     */
+    async downloadArtifact(artifactId) {
+        return downloadArtifact(this.client, artifactId);
+    }
+    /**
+     * Delete an artifact
+     */
+    async deleteArtifact(artifactId) {
+        return deleteArtifact(this.client, artifactId);
+    }
+    /**
+     * List all artifacts in the repository
+     */
+    async listRepoArtifacts(options) {
+        return listRepoArtifacts(this.client, options);
+    }
+    // ============================================
+    // Check Run Operations
+    // ============================================
+    /**
+     * Create a check run
+     */
+    async createCheckRun(params) {
+        const check = await createCheckRun(this.client, params);
+        return check;
+    }
+    /**
+     * Update a check run
+     */
+    async updateCheckRun(checkRunId, params) {
+        const check = await updateCheckRun(this.client, checkRunId, params);
+        // Emit event if check is completed
+        if (params.status === 'completed' && this.eventEmitter) {
+            this.eventEmitter.emitCheckRunCompleted(check);
+        }
+        return check;
+    }
+    /**
+     * Get a check run by ID
+     */
+    async getCheckRun(checkRunId) {
+        return getCheckRun(this.client, checkRunId);
+    }
+    /**
+     * List check runs for a ref
+     */
+    async listCheckRuns(ref, options) {
+        return listCheckRuns(this.client, ref, options);
+    }
+    /**
+     * List check runs for a check suite
+     */
+    async listCheckRunsForSuite(checkSuiteId, options) {
+        return listCheckRunsForSuite(this.client, checkSuiteId, options);
+    }
+    // ============================================
+    // Polling Operations
+    // ============================================
+    /**
+     * Create a status poller
+     */
+    createPoller(config) {
+        return createStatusPoller(this.client, config);
+    }
+    /**
+     * Poll for a workflow run to complete
+     */
+    async pollUntilComplete(runId, config) {
+        const run = await pollUntilComplete(this.client, runId, {
+            ...config,
+            onComplete: async (completedRun) => {
+                config?.onComplete?.(completedRun);
+                await this.handleWorkflowComplete(completedRun);
+            },
+        });
+        return run;
+    }
+    /**
+     * Wait for a workflow run with timeout
+     */
+    async waitForRun(runId, timeoutMs, intervalMs) {
+        return waitForRun(this.client, runId, timeoutMs, intervalMs);
+    }
+    /**
+     * Start polling and return a handle
+     */
+    startPolling(runId, config) {
+        const poller = this.createPoller({
+            ...config,
+            onComplete: async (run) => {
+                config?.onComplete?.(run);
+                await this.handleWorkflowComplete(run);
+            },
+        });
+        return poller.start(runId);
+    }
+    // ============================================
+    // High-Level Operations
+    // ============================================
+    /**
+     * Trigger a workflow and wait for completion
+     */
+    async triggerAndWait(params, pollingConfig) {
+        const run = await this.triggerWorkflow(params);
+        return this.pollUntilComplete(run.id, pollingConfig);
+    }
+    /**
+     * Get the configured CI workflow name
+     */
+    getCIWorkflow() {
+        return this.config.workflows?.ci;
+    }
+    /**
+     * Get the configured deploy workflow name
+     */
+    getDeployWorkflow() {
+        return this.config.workflows?.deploy;
+    }
+    /**
+     * Get the configured test workflow name
+     */
+    getTestWorkflow() {
+        return this.config.workflows?.test;
+    }
+    // ============================================
+    // Issue Tracker Integration
+    // ============================================
+    /**
+     * Post workflow status to an issue
+     *
+     * @param issueNumber - The issue number to comment on
+     * @param run - The workflow run to report on
+     */
+    async postWorkflowStatusToIssue(issueNumber, run) {
+        if (!this.issueTracker) {
+            return;
+        }
+        const statusEmoji = this.getStatusEmoji(run.conclusion);
+        const duration = this.formatDuration(run);
+        const comment = `## ${statusEmoji} Workflow ${run.conclusion ?? 'completed'}
+
+**Workflow**: \`${run.path}\`
+**Branch**: \`${run.head_branch}\`
+**Commit**: \`${run.head_sha.substring(0, 7)}\`
+**Duration**: ${duration}
+
+[View workflow run](${run.html_url})`;
+        await this.issueTracker.addComment(String(issueNumber), comment);
+    }
+    /**
+     * Post failed workflow details to an issue
+     *
+     * @param issueNumber - The issue number to comment on
+     * @param run - The failed workflow run
+     * @param failedJobs - The failed jobs in the run
+     */
+    async postWorkflowFailureToIssue(issueNumber, run, failedJobs) {
+        if (!this.issueTracker) {
+            return;
+        }
+        const jobDetails = failedJobs
+            .map((job) => `- **${job.name}**: ${job.conclusion}`)
+            .join('\n');
+        const comment = `## :x: Workflow failed
+
+**Workflow**: \`${run.path}\`
+**Branch**: \`${run.head_branch}\`
+**Commit**: \`${run.head_sha.substring(0, 7)}\`
+
+### Failed Jobs
+${jobDetails || 'No job details available'}
+
+[View workflow run](${run.html_url})`;
+        await this.issueTracker.addComment(String(issueNumber), comment);
+    }
+    // ============================================
+    // Private Methods
+    // ============================================
+    /**
+     * Handle workflow completion - emit events and optionally comment on issues
+     */
+    async handleWorkflowComplete(run) {
+        if (!this.eventEmitter)
+            return;
+        const failedJobs = run.conclusion === 'failure'
+            ? await this.getFailedJobs(run.id)
+            : [];
+        this.eventEmitter.emitForWorkflowRun(run, failedJobs);
+    }
+    /**
+     * Get status emoji for workflow conclusion
+     */
+    getStatusEmoji(conclusion) {
+        switch (conclusion) {
+            case 'success':
+                return ':white_check_mark:';
+            case 'failure':
+                return ':x:';
+            case 'cancelled':
+                return ':no_entry_sign:';
+            case 'timed_out':
+                return ':alarm_clock:';
+            case 'skipped':
+                return ':fast_forward:';
+            default:
+                return ':grey_question:';
+        }
+    }
+    /**
+     * Format workflow duration for display
+     */
+    formatDuration(run) {
+        const startTime = run.run_started_at
+            ? new Date(run.run_started_at).getTime()
+            : new Date(run.created_at).getTime();
+        const endTime = new Date(run.updated_at).getTime();
+        const durationMs = Math.max(0, endTime - startTime);
+        const seconds = Math.floor(durationMs / 1000);
+        const minutes = Math.floor(seconds / 60);
+        const hours = Math.floor(minutes / 60);
+        if (hours > 0) {
+            return `${hours}h ${minutes % 60}m ${seconds % 60}s`;
+        }
+        if (minutes > 0) {
+            return `${minutes}m ${seconds % 60}s`;
+        }
+        return `${seconds}s`;
+    }
+    /**
+     * Map a GitHub Actions WorkflowRun to a Latency PipelineRun.
+     */
+    mapWorkflowRunToPipelineRun(run) {
+        return {
+            id: String(run.id),
+            pipelineId: run.workflow_id ? String(run.workflow_id) : run.path ?? 'unknown',
+            status: this.mapWorkflowStatus(run.status, run.conclusion),
+            createdAt: new Date(run.created_at),
+            startedAt: run.run_started_at ? new Date(run.run_started_at) : undefined,
+            completedAt: run.status === 'completed' ? new Date(run.updated_at) : undefined,
+            logsUrl: run.html_url,
+        };
+    }
+    /**
+     * Map GitHub Actions workflow status to Latency PipelineStatus.
+     */
+    mapWorkflowStatus(status, conclusion) {
+        if (status === 'completed') {
+            switch (conclusion) {
+                case 'success':
+                    return 'completed';
+                case 'failure':
+                case 'timed_out':
+                    return 'failed';
+                case 'cancelled':
+                case 'skipped':
+                    return 'cancelled';
+                default:
+                    return 'failed';
+            }
+        }
+        // Non-completed status
+        if (status === 'in_progress') {
+            return 'running';
+        }
+        // queued, requested, waiting, pending, etc.
+        return 'pending';
+    }
+    /**
+     * Map a GitHub Actions Workflow to a Latency Pipeline.
+     */
+    mapWorkflowToPipeline(workflow) {
+        return {
+            id: String(workflow.id),
+            name: workflow.name,
+            description: workflow.path,
+            defaultBranch: undefined, // Workflows don't have a default branch concept
+        };
+    }
+}
+/**
+ * Create a GitHubActionsPlugin instance
+ */
+export function createGitHubActionsPlugin(config, eventBus) {
+    return new GitHubActionsPlugin(config, eventBus);
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/polling/status-poller.d.ts

@@ -0,0 +1,58 @@
+import type { GitHubClient } from '../client.js';
+import type { WorkflowRun } from '../types/workflows.js';
+import type { PollingConfig, PollingResult, PollingHandle } from './types.js';
+/**
+ * Status poller for monitoring workflow run status changes
+ */
+export declare class StatusPoller {
+    private readonly client;
+    private readonly config;
+    private cancelled;
+    constructor(client: GitHubClient, config?: Partial<PollingConfig>);
+    /**
+     * Poll for workflow run status until it reaches a terminal state
+     *
+     * @param runId - Workflow run ID to monitor
+     * @returns Polling result with final run state
+     */
+    poll(runId: number): Promise<PollingResult>;
+    /**
+     * Start polling and return a handle for control
+     *
+     * @param runId - Workflow run ID to monitor
+     * @returns Polling handle with promise and cancel function
+     */
+    start(runId: number): PollingHandle;
+    /**
+     * Cancel any active polling
+     */
+    cancel(): void;
+    /**
+     * Delay for the specified duration
+     */
+    private delay;
+}
+/**
+ * Create a new status poller
+ */
+export declare function createStatusPoller(client: GitHubClient, config?: Partial<PollingConfig>): StatusPoller;
+/**
+ * Poll for a workflow run to complete
+ *
+ * @param client - GitHub API client
+ * @param runId - Workflow run ID
+ * @param config - Optional polling configuration
+ * @returns The completed workflow run
+ */
+export declare function pollUntilComplete(client: GitHubClient, runId: number, config?: Partial<PollingConfig>): Promise<WorkflowRun>;
+/**
+ * Wait for a workflow run with timeout
+ *
+ * @param client - GitHub API client
+ * @param runId - Workflow run ID
+ * @param timeoutMs - Maximum time to wait in milliseconds
+ * @param intervalMs - Polling interval in milliseconds
+ * @returns The workflow run (may not be complete if timeout reached)
+ */
+export declare function waitForRun(client: GitHubClient, runId: number, timeoutMs?: number, intervalMs?: number): Promise<PollingResult>;
+//# sourceMappingURL=status-poller.d.ts.map

package/dist/polling/status-poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-poller.d.ts","sourceRoot":"","sources":["../../src/polling/status-poller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIzD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG9E;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC;IAKjE;;;;;OAKG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAwEjD;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa;IAiBnC;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,YAAY,CAEd;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,OAAO,CAAC,WAAW,CAAC,CAItB;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,MAAe,EAC1B,UAAU,GAAE,MAAc,GACzB,OAAO,CAAC,aAAa,CAAC,CAqBxB"}