mega-linter-runner 9.0.2-beta202510062317.0 → 9.0.2-beta202510070454.0

package/generators/mega-linter-custom-flavor/index.js

@@ -84,7 +84,7 @@ Example: 'megalinter-custom-flavor-python-light'
 
   writing() {
     this._generateFlavorConfig();
-    this._generateGitHubWorkflow();
+    this._generateGitHubWorkflows();
     this._generateGitHubAction();
     this._generateReadme();
   }
@@ -132,12 +132,17 @@ Example: 'megalinter-custom-flavor-python-light'
     );
   }
 
-  _generateGitHubWorkflow() {
+  _generateGitHubWorkflows() {
     this.fs.copyTpl(
       this.templatePath("megalinter-custom-flavor-builder.yml"),
       this.destinationPath("./.github/workflows/megalinter-custom-flavor-builder.yml"),
       {}
     );
+    this.fs.copyTpl(
+      this.templatePath("check-new-megalinter-version.yml"),
+      this.destinationPath("./.github/workflows/check-new-megalinter-version.yml"),
+      {}
+    );
   }
 
   _generateGitHubAction() {

package/generators/mega-linter-custom-flavor/templates/README.md

@@ -8,11 +8,55 @@ It is built from official MegaLinter images, but is maintained on <%= CUSTOM_FLA
 
 <%= CUSTOM_FLAVOR_LINTERS_WITH_LINKS %>
 
-## How to generate the flavor
+## How to use the custom flavor
+
+Follow [MegaLinter installation guide](https://megalinter.io/latest/install-assisted/), and replace related elements in the workflow.
+
+- GitHub Action: On MegaLinter step in .github/workflows/mega-linter.yml, define `uses: <%= CUSTOM_FLAVOR_GITHUB_ACTION %>@main`
+- Docker image: Replace official MegaLinter image with `<%= DOCKER_IMAGE_VERSION %>`
+
+## How the flavor is generated and updated
+
+This custom flavor is automatically kept up to date with MegaLinter releases:
+
+1. **Automatic version sync**: The `check-new-megalinter-version` workflow runs daily, checks for new MegaLinter releases, and automatically creates matching releases in this repository.
+
+2. **Automated builds**: Each release triggers the `megalinter-custom-flavor-builder` workflow, which:
+   - Builds a Docker image with only the selected linters
+   - Publishes to GitHub Container Registry (ghcr.io)
+   - Optionally publishes to Docker Hub (if credentials are configured)
 
-Create a GitHub release on your repo, it will generate and publish your custom flavor using the MegaLinter custom Flavor Builder matching the tag name of your release (example: `9.0.0`)
+3. **Available image tags**:
+   - Release tags (e.g., `v9.0.0`): Built from MegaLinter releases
+   - `beta` tag: Built from non-main branch pushes for testing
+   - `latest` tag: Points to the most recent release
 
-You can also generate a custom flavor using MegaLinter Custom Flavor by pushing on any branch or manually run the workflow `megalinter-custom-flavor-builder.yml`.
+## Configuration requirements
+
+### Required: Personal Access Token
+
+For automatic version checking to work, a `PAT_TOKEN` secret must be configured as a **repository-scoped fine-grained token** with:
+- **Repository access**: Only select repositories (select this repository)
+- **Repository permissions**:
+  - Contents: Read and write
+  - Actions: Read and write
+
+See the [Custom Flavors documentation](https://megalinter.io/beta/custom-flavors/) for detailed setup instructions.
+
+### Optional: Docker Hub publishing
+
+To publish to Docker Hub in addition to ghcr.io, configure:
+- `DOCKERHUB_REPO` variable (e.g., your Docker Hub username)
+- `DOCKERHUB_USERNAME` secret
+- `DOCKERHUB_PASSWORD` secret
+
+## How to generate the flavor manually
+
+If you need to manually trigger a build:
+
+1. **Create a GitHub release**: Creates a versioned build matching the tag name (e.g., `v9.0.0`)
+2. **Push to any branch** (except main): Builds a `beta` tagged image for testing
+3. **Manually run the workflow**: Go to Actions > Build & Push MegaLinter Custom Flavor > Run workflow
 
 See [full Custom Flavors documentation](https://megalinter.io/beta/custom-flavors/).
 
@@ -20,7 +64,7 @@ See [full Custom Flavors documentation](https://megalinter.io/beta/custom-flavor
 
 Follow [MegaLinter installation guide](https://megalinter.io/latest/install-assisted/), and replace related elements in the workflow.
 
-- GitHub Action: On MegaLinter step in .github/workflows/mega-linter.yml, define `uses: <%= CUSTOM_FLAVOR_GITHUB_ACTION %>@main`
-- Docker image: Replace official MegaLinter image by `<%= DOCKER_IMAGE_VERSION %>`
+- **GitHub Action**: On MegaLinter step in `.github/workflows/mega-linter.yml`, define `uses: <%= CUSTOM_FLAVOR_GITHUB_ACTION %>@main`
+- **Docker image**: Replace official MegaLinter image with `<%= DOCKER_IMAGE_VERSION %>`
 
 [![MegaLinter is graciously provided by OX Security](https://raw.githubusercontent.com/oxsecurity/megalinter/main/docs/assets/images/ox-banner.png)](https://www.ox.security/?ref=megalinter)

package/generators/mega-linter-custom-flavor/templates/check-new-megalinter-version.yml

@@ -0,0 +1,281 @@
+# =============================================================
+# Check for New MegaLinter Version Workflow
+#
+# This workflow checks daily for new versions of the MegaLinter
+# custom-builder action and creates a release if a new version is found.
+#
+# Usage:
+# - Runs daily at 00:00 UTC via schedule
+# - Can be manually triggered via workflow_dispatch
+# - Compares MegaLinter tags with current repository tags
+# - Creates a new release if a new MegaLinter version is detected
+#
+# The workflow will:
+# 1. Fetch all tags from oxsecurity/megalinter repository
+# 2. Fetch all tags from the current repository
+# 3. Find new tags that exist in MegaLinter but not in current repo
+# 4. Create a release with the new version tag
+# 5. The release will trigger megalinter-custom-flavor-builder.yml
+#
+# Required permissions:
+#   - contents: write (to create releases and tags)
+#
+# Required repository secrets:
+#   - PAT_TOKEN: Personal Access Token with 'contents' and 'actions' permissions
+#     This is required to trigger the builder workflow. Without it, the workflow
+#     will fail and the release will be deleted (to be recreated once the token is set).
+#
+# To create a Fine-grained PAT (recommended - more secure):
+#   1. Go to GitHub Settings > Developer settings > Personal access tokens > Fine-grained tokens
+#   2. Click "Generate new token"
+#   3. Give it a descriptive name (e.g., "MegaLinter Auto-Release")
+#   4. Set expiration (e.g., 90 days or 1 year)
+#   5. Under "Repository access", select "Only select repositories"
+#   6. Choose this repository (megalinter-custom-flavor-npm-groovy-lint)
+#   7. Under "Permissions" > "Repository permissions":
+#      - Contents: Read and write
+#      - Actions: Read and write
+#   8. Click "Generate token" and copy the token
+#   9. In your repository, go to Settings > Secrets and variables > Actions
+#   10. Click "New repository secret"
+#   11. Name: PAT_TOKEN, Value: paste your token
+# =============================================================
+
+name: Check for New MegaLinter Version
+
+on:
+  schedule:
+    # Run daily at 00:00 UTC
+    - cron: "0 0 * * *"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  check-new-version:
+    name: Check for New MegaLinter Version
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Fetch MegaLinter Repository Tags
+        id: fetch-megalinter-tags
+        run: |
+          echo "Fetching tags from oxsecurity/megalinter..."
+
+          # Fetch all tags from MegaLinter repository (filtering for version tags only)
+          MEGALINTER_TAGS=$(git ls-remote --tags --refs https://github.com/oxsecurity/megalinter.git | \
+            grep -E 'refs/tags/v[0-9]+\.[0-9]+\.[0-9]+$' | \
+            sed 's/.*refs\/tags\///' | \
+            sort -V | \
+            tail -n 20)
+
+          echo "Latest MegaLinter tags:"
+          echo "$MEGALINTER_TAGS"
+
+          # Get the latest tag
+          LATEST_MEGALINTER_TAG=$(echo "$MEGALINTER_TAGS" | tail -n 1)
+          echo "latest_tag=$LATEST_MEGALINTER_TAG" >> $GITHUB_OUTPUT
+
+          # Save all tags to a file
+          echo "$MEGALINTER_TAGS" > megalinter_tags.txt
+
+      - name: Fetch Current Repository Tags
+        id: fetch-repo-tags
+        run: |
+          echo "Fetching tags from current repository..."
+
+          # Fetch all version tags from current repository
+          REPO_TAGS=$(git tag -l 'v*' | sort -V)
+
+          echo "Current repository tags:"
+          echo "$REPO_TAGS"
+
+          # Get the latest tag from current repository
+          if [ -z "$REPO_TAGS" ]; then
+            LATEST_REPO_TAG=""
+            echo "No existing tags in repository"
+          else
+            LATEST_REPO_TAG=$(echo "$REPO_TAGS" | tail -n 1)
+            echo "Latest repository tag: $LATEST_REPO_TAG"
+          fi
+
+          echo "latest_repo_tag=$LATEST_REPO_TAG" >> $GITHUB_OUTPUT
+
+      - name: Find New Version
+        id: find-new-version
+        run: |
+          echo "Comparing versions..."
+
+          LATEST_MEGALINTER_TAG="${{ steps.fetch-megalinter-tags.outputs.latest_tag }}"
+          LATEST_REPO_TAG="${{ steps.fetch-repo-tags.outputs.latest_repo_tag }}"
+
+          echo "Latest MegaLinter tag: $LATEST_MEGALINTER_TAG"
+          echo "Latest repository tag: $LATEST_REPO_TAG"
+
+          # Function to compare semantic versions
+          version_greater_than() {
+            # Remove 'v' prefix for comparison
+            ver1="${1#v}"
+            ver2="${2#v}"
+            
+            # Use sort -V to compare versions
+            if [ "$(printf '%s\n' "$ver1" "$ver2" | sort -V | tail -n1)" = "$ver1" ] && [ "$ver1" != "$ver2" ]; then
+              return 0  # ver1 > ver2
+            else
+              return 1  # ver1 <= ver2
+            fi
+          }
+
+          # Check if we should create a new release
+          if [ -z "$LATEST_REPO_TAG" ]; then
+            echo "No existing tags in repository. Will create release for $LATEST_MEGALINTER_TAG"
+            echo "new_version_found=true" >> $GITHUB_OUTPUT
+            echo "new_version=$LATEST_MEGALINTER_TAG" >> $GITHUB_OUTPUT
+          elif version_greater_than "$LATEST_MEGALINTER_TAG" "$LATEST_REPO_TAG"; then
+            echo "✅ New version found! $LATEST_MEGALINTER_TAG > $LATEST_REPO_TAG"
+            echo "new_version_found=true" >> $GITHUB_OUTPUT
+            echo "new_version=$LATEST_MEGALINTER_TAG" >> $GITHUB_OUTPUT
+          else
+            echo "ℹ️ No new version. Repository is up to date."
+            echo "new_version_found=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Create Release for New Version
+        if: steps.find-new-version.outputs.new_version_found == 'true'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NEW_VERSION: ${{ steps.find-new-version.outputs.new_version }}
+        run: |
+          echo "Creating release for version $NEW_VERSION..."
+
+          # Create a release using GitHub CLI (will also create the tag)
+          gh release create "$NEW_VERSION" \
+            --title "MegaLinter Custom Flavor $NEW_VERSION" \
+            --notes "Automated release to sync with MegaLinter version $NEW_VERSION.
+
+          This release was automatically created to build a custom MegaLinter flavor based on the upstream MegaLinter release $NEW_VERSION.
+
+          For more information about changes in this version, see the [MegaLinter changelog](https://github.com/oxsecurity/megalinter/releases/tag/$NEW_VERSION)." \
+            --latest
+
+      - name: Trigger Custom Flavor Builder Workflow
+        if: steps.find-new-version.outputs.new_version_found == 'true'
+        env:
+          # Use PAT_TOKEN if available, otherwise fall back to GITHUB_TOKEN
+          # Note: GITHUB_TOKEN doesn't have permission to trigger workflows
+          GITHUB_TOKEN: ${{ secrets.PAT_TOKEN || secrets.GITHUB_TOKEN }}
+        run: |
+          echo "Triggering megalinter-custom-flavor-builder workflow..."
+
+          NEW_VERSION="${{ steps.find-new-version.outputs.new_version }}"
+
+          # Trigger the workflow using GitHub CLI and capture output
+          set +e  # Don't exit immediately on error
+          gh workflow run megalinter-custom-flavor-builder.yml \
+            --ref main \
+            --field megalinter-version="$NEW_VERSION" \
+            --field is-latest="true" \
+            2>&1 | tee workflow_trigger.log
+          EXIT_CODE=$?
+          set -e  # Re-enable exit on error
+
+          # Check for errors in the output
+          if grep -q "could not create workflow dispatch event" workflow_trigger.log || \
+             grep -q "Resource not accessible by integration" workflow_trigger.log || \
+             grep -q "HTTP 403" workflow_trigger.log || \
+             [ $EXIT_CODE -ne 0 ]; then
+            
+            echo "::error::❌ Failed to trigger workflow!"
+            echo ""
+            cat workflow_trigger.log
+            echo ""
+            
+            if grep -q "Resource not accessible by integration" workflow_trigger.log || grep -q "HTTP 403" workflow_trigger.log; then
+              echo "::error::The workflow could not be triggered due to insufficient token permissions."
+              echo "::error::"
+              echo "::error::Deleting the release so it can be recreated once PAT_TOKEN is configured..."
+              
+              # Delete the release and tag that was just created
+              gh release delete "$NEW_VERSION" --yes --cleanup-tag 2>&1 || echo "::warning::Could not delete release (it may not exist or already be deleted)"
+              
+              echo "::error::"
+              echo "::error::⚠️ PAT_TOKEN is REQUIRED to create releases and trigger the builder workflow."
+              echo "::error::"
+              echo "::error::To fix this, create a Fine-grained Personal Access Token (recommended - more secure):"
+              echo "::error::1. Go to: https://github.com/settings/personal-access-tokens/new"
+              echo "::error::2. Token name: 'MegaLinter Auto-Release'"
+              echo "::error::3. Expiration: Choose 90 days or 1 year"
+              echo "::error::4. Repository access: Select 'Only select repositories'"
+              echo "::error::5. Choose repository: ${{ github.repository }}"
+              echo "::error::6. Repository permissions:"
+              echo "::error::   - Contents: Read and write"
+              echo "::error::   - Actions: Read and write"
+              echo "::error::7. Click 'Generate token' and copy it"
+              echo "::error::8. Go to: https://github.com/${{ github.repository }}/settings/secrets/actions"
+              echo "::error::9. Click 'New repository secret'"
+              echo "::error::10. Name: 'PAT_TOKEN', Value: paste your token"
+              echo "::error::"
+              echo "::error::Once configured, run this workflow again (manually or wait for the next scheduled run)."
+            fi
+            
+            exit 1
+          fi
+
+          echo "✅ Builder workflow triggered successfully with version: $NEW_VERSION"
+
+      - name: Summary
+        if: always()
+        run: |
+          echo "## Check for New MegaLinter Version Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+
+          LATEST_MEGALINTER_TAG="${{ steps.fetch-megalinter-tags.outputs.latest_tag }}"
+          LATEST_REPO_TAG="${{ steps.fetch-repo-tags.outputs.latest_repo_tag }}"
+
+          if [ "${{ steps.find-new-version.outputs.new_version_found }}" == "true" ]; then
+            echo "✅ New version found: **${{ steps.find-new-version.outputs.new_version }}**" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "A new release has been created, which will trigger the custom flavor builder workflow." >> $GITHUB_STEP_SUMMARY
+            
+            # Check if PAT_TOKEN is configured
+            if [ -z "${{ secrets.PAT_TOKEN }}" ]; then
+              echo "" >> $GITHUB_STEP_SUMMARY
+              echo "### ⚠️ REQUIRED: Configure PAT_TOKEN" >> $GITHUB_STEP_SUMMARY
+              echo "" >> $GITHUB_STEP_SUMMARY
+              echo "**PAT_TOKEN is required to trigger the builder workflow and create releases.**" >> $GITHUB_STEP_SUMMARY
+              echo "" >> $GITHUB_STEP_SUMMARY
+              echo "Without it, releases will be automatically deleted and the workflow will fail." >> $GITHUB_STEP_SUMMARY
+              echo "" >> $GITHUB_STEP_SUMMARY
+              echo "**To create a Fine-grained Personal Access Token (recommended - more secure):**" >> $GITHUB_STEP_SUMMARY
+              echo "1. Go to [GitHub Settings > Personal access tokens > Fine-grained tokens](https://github.com/settings/personal-access-tokens/new)" >> $GITHUB_STEP_SUMMARY
+              echo "2. Token name: \`MegaLinter Auto-Release\`" >> $GITHUB_STEP_SUMMARY
+              echo "3. Expiration: Choose 90 days or 1 year" >> $GITHUB_STEP_SUMMARY
+              echo "4. Repository access: **Only select repositories**" >> $GITHUB_STEP_SUMMARY
+              echo "5. Choose repository: \`${{ github.repository }}\`" >> $GITHUB_STEP_SUMMARY
+              echo "6. Repository permissions:" >> $GITHUB_STEP_SUMMARY
+              echo "   - **Contents**: Read and write" >> $GITHUB_STEP_SUMMARY
+              echo "   - **Actions**: Read and write" >> $GITHUB_STEP_SUMMARY
+              echo "7. Click **Generate token** and copy it" >> $GITHUB_STEP_SUMMARY
+              echo "8. Go to [Repository Settings > Secrets](https://github.com/${{ github.repository }}/settings/secrets/actions)" >> $GITHUB_STEP_SUMMARY
+              echo "9. Click **New repository secret**" >> $GITHUB_STEP_SUMMARY
+              echo "10. Name: \`PAT_TOKEN\`, Value: paste your token" >> $GITHUB_STEP_SUMMARY
+            fi
+          else
+            echo "ℹ️ No new versions found. Repository is up to date with MegaLinter." >> $GITHUB_STEP_SUMMARY
+          fi
+
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "**Version Comparison:**" >> $GITHUB_STEP_SUMMARY
+          echo "- Latest MegaLinter version: **$LATEST_MEGALINTER_TAG**" >> $GITHUB_STEP_SUMMARY
+
+          if [ -n "$LATEST_REPO_TAG" ]; then
+            echo "- Latest repository version: **$LATEST_REPO_TAG**" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "- Latest repository version: **No tags found**" >> $GITHUB_STEP_SUMMARY
+          fi

package/generators/mega-linter-custom-flavor/templates/megalinter-custom-flavor-builder.yml

@@ -30,6 +30,16 @@ on:
   release:
     types: [edited, published]
   workflow_dispatch:
+    inputs:
+      megalinter-version:
+        description: "MegaLinter version to build (e.g., v7.5.0)"
+        required: false
+        type: string
+      is-latest:
+        description: "Mark this version as latest"
+        required: false
+        type: boolean
+        default: false
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -45,10 +55,38 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
+      - name: Determine MegaLinter Version Tag
+        id: determine-tag
+        run: |
+          if [ -n "${{ inputs.megalinter-version }}" ]; then
+            TAG="${{ inputs.megalinter-version }}"
+            echo "Using workflow input version: $TAG"
+          elif [ "${{ github.event_name }}" == "release" ]; then
+            TAG="${{ github.event.release.tag_name }}"
+            echo "Using release tag: $TAG"
+          else
+            TAG="beta"
+            echo "Using default tag: $TAG"
+          fi
+          echo "tag=$TAG" >> $GITHUB_OUTPUT
+
+          # Determine is-latest flag
+          if [ "${{ github.event_name }}" == "workflow_dispatch" ]; then
+            IS_LATEST="${{ inputs.is-latest }}"
+            echo "Using workflow input is-latest: $IS_LATEST"
+          elif [ "${{ github.event_name }}" == "release" ]; then
+            IS_LATEST="true"
+            echo "Release event - is-latest: true"
+          else
+            IS_LATEST="false"
+            echo "Default is-latest: false"
+          fi
+          echo "is-latest=$IS_LATEST" >> $GITHUB_OUTPUT
+
       - name: Log in to GitHub Container Registry
         uses: docker/login-action@v3
         with:
@@ -68,8 +106,8 @@ jobs:
       - name: Build MegaLinter Custom Flavor
         uses: oxsecurity/megalinter/flavors/custom-builder@main
         with:
-          megalinter-custom-flavor-builder-tag: ${{ github.event_name == 'release' && github.event.release.tag_name || 'beta' }}
-          is-latest: ${{ github.event_name == 'release' && 'true' || 'false' }}
+          megalinter-custom-flavor-builder-tag: ${{ steps.determine-tag.outputs.tag }}
+          is-latest: ${{ steps.determine-tag.outputs.is-latest }}
           upload-to-ghcr: "true"
           upload-to-dockerhub: ${{ secrets.DOCKERHUB_USERNAME != '' && secrets.DOCKERHUB_PASSWORD != '' && 'true' || 'false' }}
           dockerhub-repo: ${{ vars.DOCKERHUB_REPO }}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mega-linter-runner",
-  "version": "9.0.2-beta202510062317.0",
+  "version": "9.0.2-beta202510070454.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/oxsecurity/megalinter.git"