@synergenius/flowweaver-pack-github-actions 0.1.2 → 0.1.4

package/dist/target.d.ts

@@ -18,6 +18,8 @@ import type { ExportOptions, ExportArtifacts, DeployInstructions } from '@synerg
 export declare class GitHubActionsTarget extends BaseCICDTarget {
     readonly name = "github-actions";
     readonly description = "GitHub Actions workflow YAML (.github/workflows/)";
+    /** Accumulated warnings for the current export run */
+    private _warnings;
     readonly deploySchema: {
         runner: {
             type: "string";
@@ -44,6 +46,14 @@ export declare class GitHubActionsTarget extends BaseCICDTarget {
     private renderWorkflowYAML;
     private renderTriggers;
     private renderJob;
+    /**
+     * Parse a timeout string like "30m", "1h", "1h30m" into minutes.
+     */
+    private parseTimeoutMinutes;
+    /**
+     * Translate GitLab-style CI variable conditions to GitHub Actions expressions.
+     */
+    private translateCondition;
     private renderStep;
     private renderCacheStep;
     /**

package/dist/target.js

@@ -21,6 +21,8 @@ import * as path from 'path';
 export class GitHubActionsTarget extends BaseCICDTarget {
     name = 'github-actions';
     description = 'GitHub Actions workflow YAML (.github/workflows/)';
+    /** Accumulated warnings for the current export run */
+    _warnings = [];
     deploySchema = {
         runner: { type: 'string', description: 'GitHub runner label', default: 'ubuntu-latest' },
     };
@@ -30,6 +32,7 @@ export class GitHubActionsTarget extends BaseCICDTarget {
         label: { type: 'string', description: 'Step display name' },
     };
     async generate(options) {
+        this._warnings = [];
         const filePath = path.resolve(options.sourceFile);
         const outputDir = path.resolve(options.outputDir);
         // Parse the workflow file to get AST
@@ -72,6 +75,7 @@ export class GitHubActionsTarget extends BaseCICDTarget {
             target: this.name,
             workflowName: options.displayName || targetWorkflows[0].name,
             entryPoint: files[0].relativePath,
+            warnings: this._warnings.length > 0 ? this._warnings : undefined,
         };
     }
     getDeployInstructions(_artifacts) {
@@ -105,6 +109,18 @@ export class GitHubActionsTarget extends BaseCICDTarget {
         doc.name = ast.name;
         // on: triggers
         doc.on = this.renderTriggers(ast.options?.cicd?.triggers || []);
+        // env (workflow-level, from @variables)
+        if (ast.options?.cicd?.variables && Object.keys(ast.options.cicd.variables).length > 0) {
+            doc.env = { ...ast.options.cicd.variables };
+        }
+        // Warn about @includes (GitLab CI only)
+        if (ast.options?.cicd?.includes && ast.options.cicd.includes.length > 0) {
+            this._warnings.push(`@includes: GitHub Actions has no equivalent to GitLab CI includes. Use reusable workflows (workflow_call) or composite actions instead.`);
+        }
+        // Warn about @before_script at workflow level (no GH Actions equivalent)
+        if (ast.options?.cicd?.beforeScript && ast.options.cicd.beforeScript.length > 0) {
+            this._warnings.push(`Workflow-level @before_script: GitHub Actions has no global before_script. It has been applied per-job instead.`);
+        }
         // concurrency
         if (ast.options?.cicd?.concurrency) {
             doc.concurrency = {
@@ -182,12 +198,63 @@ export class GitHubActionsTarget extends BaseCICDTarget {
     }
     renderJob(job, ast) {
         const jobObj = {};
-        // runs-on
-        jobObj['runs-on'] = job.runner || 'ubuntu-latest';
+        // runs-on (tags override: self-hosted + tag labels)
+        if (job.tags && job.tags.length > 0) {
+            jobObj['runs-on'] = ['self-hosted', ...job.tags];
+        }
+        else {
+            jobObj['runs-on'] = job.runner || 'ubuntu-latest';
+        }
         // needs
         if (job.needs.length > 0) {
             jobObj.needs = job.needs;
         }
+        // continue-on-error (from @job allow_failure)
+        if (job.allowFailure) {
+            jobObj['continue-on-error'] = true;
+        }
+        // timeout-minutes (from @job timeout, parse "30m" → 30, "1h" → 60)
+        if (job.timeout) {
+            jobObj['timeout-minutes'] = this.parseTimeoutMinutes(job.timeout);
+        }
+        // retry: no native equivalent in GitHub Actions
+        if (job.retry !== undefined && job.retry > 0) {
+            this._warnings.push(`@job ${job.id} retry=${job.retry}: GitHub Actions has no native job-level retry. Use "Re-run failed jobs" in the UI or the nick-fields/retry action for step-level retry.`);
+        }
+        // coverage: no native equivalent in GitHub Actions
+        if (job.coverage) {
+            this._warnings.push(`@job ${job.id} coverage: GitHub Actions has no native coverage regex. Use a coverage action (e.g. codecov/codecov-action) instead.`);
+        }
+        // extends: no native equivalent in GitHub Actions (GitLab CI only)
+        if (job.extends) {
+            this._warnings.push(`@job ${job.id} extends="${job.extends}": GitHub Actions has no native extends. Use reusable workflows or composite actions instead.`);
+        }
+        // if: conditional (from @job rules)
+        if (job.rules && job.rules.length > 0) {
+            // Combine all rule conditions with || (GitHub Actions only supports a single `if:`)
+            const conditions = job.rules
+                .filter(r => r.if)
+                .map(r => this.translateCondition(r.if));
+            if (conditions.length === 1) {
+                jobObj.if = conditions[0];
+            }
+            else if (conditions.length > 1) {
+                jobObj.if = conditions.map(c => `(${c})`).join(' || ');
+            }
+            // Warn about rule properties that don't translate to GitHub Actions
+            const hasWhen = job.rules.some(r => r.when);
+            const hasChanges = job.rules.some(r => r.changes && r.changes.length > 0);
+            if (hasWhen) {
+                this._warnings.push(`@job ${job.id} rules when=: GitHub Actions has no native when (manual/delayed/always). Use workflow_dispatch for manual triggers.`);
+            }
+            if (hasChanges) {
+                this._warnings.push(`@job ${job.id} rules changes=: GitHub Actions handles path filtering via on.push.paths, not per-job. Use dorny/paths-filter for per-job path filtering.`);
+            }
+        }
+        // env (from @job variables or @variables)
+        if (job.variables && Object.keys(job.variables).length > 0) {
+            jobObj.env = { ...job.variables };
+        }
         // environment
         if (job.environment) {
             const envConfig = ast.options?.cicd?.environments?.find((e) => e.name === job.environment);
@@ -246,6 +313,13 @@ export class GitHubActionsTarget extends BaseCICDTarget {
         if (job.cache) {
             steps.push(this.renderCacheStep(job.cache));
         }
+        // before_script as a setup step
+        if (job.beforeScript && job.beforeScript.length > 0) {
+            steps.push({
+                name: 'Setup',
+                run: job.beforeScript.join('\n'),
+            });
+        }
         // Node steps
         for (const step of job.steps) {
             steps.push(this.renderStep(step));
@@ -266,9 +340,66 @@ export class GitHubActionsTarget extends BaseCICDTarget {
                 steps.push(uploadStep);
             }
         }
+        // reports: junit → test-reporter, coverage → codecov
+        if (job.reports && job.reports.length > 0) {
+            for (const report of job.reports) {
+                if (report.type === 'junit') {
+                    steps.push({
+                        name: 'Test Report',
+                        uses: 'dorny/test-reporter@v1',
+                        if: 'always()',
+                        with: {
+                            name: 'Test Results',
+                            path: report.path,
+                            reporter: 'java-junit',
+                        },
+                    });
+                }
+                else if (report.type === 'cobertura' || report.type === 'coverage') {
+                    steps.push({
+                        name: 'Upload Coverage',
+                        uses: 'codecov/codecov-action@v4',
+                        with: { files: report.path },
+                    });
+                }
+                else {
+                    steps.push({
+                        name: `Upload ${report.type} report`,
+                        uses: 'actions/upload-artifact@v4',
+                        with: {
+                            name: `${report.type}-report`,
+                            path: report.path,
+                        },
+                    });
+                }
+            }
+        }
         jobObj.steps = steps;
         return jobObj;
     }
+    /**
+     * Parse a timeout string like "30m", "1h", "1h30m" into minutes.
+     */
+    parseTimeoutMinutes(timeout) {
+        let minutes = 0;
+        const hourMatch = timeout.match(/(\d+)h/);
+        const minMatch = timeout.match(/(\d+)m/);
+        if (hourMatch)
+            minutes += parseInt(hourMatch[1], 10) * 60;
+        if (minMatch)
+            minutes += parseInt(minMatch[1], 10);
+        return minutes || 60; // default 60 if unparseable
+    }
+    /**
+     * Translate GitLab-style CI variable conditions to GitHub Actions expressions.
+     */
+    translateCondition(condition) {
+        return condition
+            .replace(/\$CI_COMMIT_BRANCH/g, "github.ref_name")
+            .replace(/\$CI_COMMIT_TAG/g, "startsWith(github.ref, 'refs/tags/')")
+            .replace(/\$CI_PIPELINE_SOURCE/g, "github.event_name")
+            .replace(/==/g, '==');
+    }
     renderStep(step) {
         const mapping = this.resolveActionMapping(step, 'github-actions');
         if (mapping?.githubAction) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synergenius/flowweaver-pack-github-actions",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "GitHub Actions CI/CD export target for Flow Weaver",
   "keywords": [
     "flowweaver-marketplace-pack",
@@ -35,9 +35,9 @@
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {
-    "typescript": "^5.0.0",
-    "@synergenius/flow-weaver": "^0.17.1",
-    "@types/node": "^20.0.0"
+    "@synergenius/flow-weaver": "^0.17.4",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
   },
   "license": "SEE LICENSE IN LICENSE",
   "repository": {