@synergenius/flowweaver-pack-github-actions 0.1.1 → 0.1.3

package/README.md

@@ -0,0 +1,62 @@
+# @synergenius/flowweaver-pack-github-actions
+
+GitHub Actions CI/CD export target for [Flow Weaver](https://github.com/synergenius-fw/flow-weaver).
+
+Generates native `.github/workflows/<name>.yml` files from Flow Weaver CI/CD workflows. No runtime dependency — outputs pure GitHub Actions YAML.
+
+## Installation
+
+```bash
+npm install @synergenius/flowweaver-pack-github-actions
+```
+
+This package is a **marketplace pack** — once installed, Flow Weaver automatically discovers it via `createTargetRegistry()`.
+
+## Usage
+
+### CLI
+
+```bash
+# Export a CI/CD workflow as GitHub Actions YAML
+npx flow-weaver export my-pipeline.ts --target github-actions
+```
+
+### Programmatic
+
+```typescript
+import { createTargetRegistry } from '@synergenius/flow-weaver/deployment';
+
+const registry = await createTargetRegistry(process.cwd());
+const gha = registry.get('github-actions');
+
+const artifacts = await gha.generate({
+  sourceFile: 'my-pipeline.ts',
+  workflowName: 'myPipeline',
+  displayName: 'my-pipeline',
+  outputDir: './dist/github-actions',
+});
+```
+
+## What it generates
+
+- `.github/workflows/<name>.yml` — Native GitHub Actions workflow
+- `SECRETS_SETUP.md` — Documentation for required secrets
+
+### Mapping
+
+| Flow Weaver | GitHub Actions |
+|-------------|---------------|
+| `[job: "name"]` annotation | Job in `jobs:` |
+| `@path` dependencies | `needs:` |
+| `@secret NAME` | `${{ secrets.NAME }}` |
+| `@cache` | `actions/cache@v4` |
+| `@artifact` | `actions/upload-artifact@v4` / `actions/download-artifact@v4` |
+| `@trigger push` | `on: push` |
+
+## Requirements
+
+- `@synergenius/flow-weaver` >= 0.14.0
+
+## License
+
+See [LICENSE](./LICENSE).

package/dist/target.d.ts

@@ -44,6 +44,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

@@ -182,12 +182,37 @@ 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);
+        }
+        // if: conditional (from @job rules)
+        if (job.rules && job.rules.length > 0) {
+            // Use the first rule's `if` condition, translate GitLab-style vars to GitHub context
+            const condition = job.rules[0].if;
+            if (condition) {
+                jobObj.if = this.translateCondition(condition);
+            }
+        }
+        // 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 +271,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 +298,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.1",
+  "version": "0.1.3",
   "description": "GitHub Actions CI/CD export target for Flow Weaver",
   "keywords": [
     "flowweaver-marketplace-pack",
@@ -36,7 +36,7 @@
   },
   "devDependencies": {
     "typescript": "^5.0.0",
-    "@synergenius/flow-weaver": "^0.14.2",
+    "@synergenius/flow-weaver": "^0.17.3",
     "@types/node": "^20.0.0"
   },
   "license": "SEE LICENSE IN LICENSE",