build(deps): bump oxsecurity/megalinter/flavors/documentation from 9.6.0 to 10.0.0

[dependabot]

Bumps oxsecurity/megalinter/flavors/documentation from 9.6.0 to 10.0.0.

Release notes

Sourced from oxsecurity/megalinter/flavors/documentation's releases.

v10.0.0

What's Changed

• Breaking changes

  • Removed 14 deprecated or long-disabled linters, and the API, MAKEFILE and PUPPET descriptors, which had no other linter left. MegaLinter does not provide Makefile and Puppet linting anymore. See the new Removed linters page for the full list and suggested replacements. (#8606)
  • REPOSITORY_GITLEAKS has been removed: migrate to REPOSITORY_BETTERLEAKS, which reads your existing .gitleaks.toml and .gitleaksignore files unchanged. (#8606)
  • Existing .mega-linter.yml files keep working: configuration variables of removed linters are simply ignored (a single notice lists any found in your configuration) and remain valid in the JSON schema. (#8606)
  • API Reporter payload v2 replaces the v1 payload: metric series are renamed (linter_run_* becomes megalinter_linter_run_*, plus new run-level megalinter_run_* series), and the old docs/grafana dashboards are superseded. Re-provision the new dashboards with npx mega-linter-runner --upload-dashboards grafana — see the migration notes. Legacy NOTIF_API_* variables remain supported as aliases. (#8661)
  • Linters now time out after 5 minutes by default (LINTER_TIMEOUT_SECONDS: 300): a linter exceeding it is killed and reported as an error (exit code 124) instead of running (or hanging) unbounded. If some of your linters legitimately run longer, raise the limit globally with LINTER_TIMEOUT_SECONDS, per linter with <LINTER_KEY>_TIMEOUT_SECONDS, or restore the previous unbounded behavior with value 0. (#8665)

• Core

  • Coding agents integration: MegaLinter can now be driven by Claude Code, Cursor CLI, GitHub Copilot CLI, Codex and many other coding agents — see the new Coding Agents documentation page (#8614)
    • Install the MegaLinter agent skills with npx skills add oxsecurity/megalinter
    • Then ask your agent to set up MegaLinter (megalinter-setup), watch CI or local runs (megalinter-check) or fix lint errors (megalinter-fix)
    • Before the first local run, the skills now make sure the user is aware that MegaLinter is Docker-based and needs a good computer configuration and internet connection (the image download can weigh several GB), and suggest watching CI results instead when that is a problem
    • Local runs launched by the skills now cap PARALLEL_PROCESS_NUMBER to 4 on local computers (CI runs keep one parallel linter process per CPU core), so linting does not saturate the machine
    • Local runs launched by the skills now always activate the JSON reporter (not generated by default) to read results reliably, and fall back to the report folder configuration then the console output instead of waiting for report files that a repository configuration may have disabled
  • Excluded directories are now forwarded to project-mode linters, massively speeding up local runs, fixes #8645
    • Linters that scan the whole workspace by themselves (REPOSITORY_TRIVY, REPOSITORY_CHECKOV, REPOSITORY_GRYPE, REPOSITORY_TRUFFLEHOG, REPOSITORY_SEMGREP and 50+ others) used to crawl everything, including build caches and node_modules: a seconds-long CI lint could take hours on a local checkout
    • MegaLinter now automatically passes the excluded directories (defaults, EXCLUDED_DIRECTORIES, ADDITIONAL_EXCLUDED_DIRECTORIES, and directories detected in FILTER_REGEX_EXCLUDE) to each of these linters, through its native exclusion flags or a generated ignore/config file
    • Every forwarded exclusion is logged in the linter's console section, and the ">300 gitignored files" performance warning now names the heaviest directories it found
    • Opt out globally with FORWARD_EXCLUDED_DIRECTORIES: false, or per linter with <LINTER_KEY>_FORWARD_EXCLUDED_DIRECTORIES: false
  • Default excluded directories now also include common build/cache folders: .wireit, .turbo, .nx, .yarn/cache, .pnpm-store, .parcel-cache, .angular, and the Salesforce CLI .sf / .sfdx state folders (#8646)
  • New per-linter timeout: a linter still running after 5 minutes (LINTER_TIMEOUT_SECONDS: 300 by default) is killed along with all its child processes and reported as an error (exit code 124) with an actionable message, while the other linters keep running. Raise the limit globally with LINTER_TIMEOUT_SECONDS, per linter with <LINTER_KEY>_TIMEOUT_SECONDS, or disable it with value 0 (#8665)
  • New prerun analysis mode (mega-linter-runner --prerun, or MEGALINTER_PRERUN=true environment variable): MegaLinter identifies active linters and collects files, then stops before running any linter and suggests configuration improvements, in the console and in megalinter-reports/prerun-report.json (#8653)
    • Suggested exclusions: top-level directories containing only gitignored files (safe: linting scope is unchanged, and project-mode linters stop scanning them), and well-known generated/vendored folder names (site, dist, vendor...) still containing lintable files (to confirm by the user)
    • A lighter matching flavor is also suggested when available
    • The megalinter-check agent skill uses it on the first local run to tune .mega-linter.yml with the user before the real lint
    • Fixed a performance issue where detecting .gitignored files enumerated every individual file inside large ignored folders (node_modules, build output...) instead of stopping at the folder boundary, which could make the file collection step (including prerun) take several minutes on big repositories
  • Much lighter Docker images: the main image download shrinks by 9%, flavors by 9% to 22%, and standalone megalinter-only-* images are 35% to 65% smaller (#8621)

    • If your PRE_COMMANDS compile native code: the compilation toolchain is no longer shipped in the images, install it back with apk add --no-cache gcc make musl-dev

    • Main and flavor images, compressed download size on ghcr.io, linux/amd64 (before = v9.6.0, so deltas also include the linters removed in this version):

      Image	Before	After	Delta
      megalinter (main)	4.55 GB	4.13 GB	-9%
      megalinter-c_cpp	1.61 GB	1.35 GB	-16%
      megalinter-ci_light	724 MB	657 MB	-9%
      megalinter-cupcake	2.52 GB	2.24 GB	-11%
      megalinter-documentation	1.47 GB	1.21 GB	-18%
      megalinter-dotnet	2.23 GB	1.86 GB	-17%
      megalinter-dotnetweb	2.25 GB	1.88 GB	-17%
      megalinter-formatters	936 MB	849 MB	-9%
      megalinter-go	1.55 GB	1.35 GB	-13%
      megalinter-java	1.59 GB	1.32 GB	-17%
      megalinter-javascript	1.49 GB	1.23 GB	-18%
      megalinter-php	1.51 GB	1.26 GB	-17%
      megalinter-python	1.61 GB	1.26 GB	-22%
      megalinter-ruby	1.49 GB	1.22 GB	-18%
      megalinter-rust	1.99 GB	1.80 GB	-10%

... (truncated)

Changelog

Sourced from oxsecurity/megalinter/flavors/documentation's changelog.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased] (beta, main branch content)

Note: Can be used with oxsecurity/megalinter@beta in your GitHub Action mega-linter.yml file, or with oxsecurity/megalinter:beta docker image

• Breaking changes

• Core

• New linters

  • biome, one fast toolchain linting, formatting and sorting imports of JavaScript, TypeScript, JSX, TSX, JSON, CSS and GraphQL files, available as JAVASCRIPT_BIOME, TYPESCRIPT_BIOME, JSX_BIOME, TSX_BIOME, JSON_BIOME, CSS_BIOME and GRAPHQL_BIOME
    • Activated only when a biome.json or biome.jsonc configuration file is found in the repository
    • Supports APPLY_FIXES (safe fixes with --write) and native SARIF output
    • EXCLUDED_DIRECTORIES are forwarded in project lint mode through a generated configuration extending the workspace one

• Disabled linters

  • COFFEE_COFFEELINT is disabled: CoffeeScript tooling is discontinued, and coffeelint can not receive EXCLUDED_DIRECTORIES in project lint mode (it has no exclusion option and reads .coffeelintignore only from its working directory). The linter will be removed in a future version

• Re-enabled linters

  • spectral is back as API_SPECTRAL, together with the API descriptor, to lint your OpenAPI, AsyncAPI and Arazzo specifications (#8717)
    • It was removed in v10.0.0 because it crashed at startup on every run: the cause has been found and fixed
    • Nothing to change in your configuration: API_SPECTRAL works again in ENABLE_LINTERS / DISABLE_LINTERS, and the default ruleset file is still .spectral.yaml

• Deprecated linters

• Removed linters

• Media

• Linters enhancements

  • CLOJURE_CLJSTYLE now forwards EXCLUDED_DIRECTORIES through its native repeatable --ignore argument, instead of a temporary .cljstyle written in your repository. Exclusions are now also applied when your repository already has a .cljstyle config, whose own ignore patterns are preserved
  • SQL_SQLFLUFF does not receive EXCLUDED_DIRECTORIES in project lint mode anymore: sqlfluff reads path exclusions only from a .sqlfluffignore, .sqlfluff or pyproject.toml located inside the analyzed sources, where MegaLinter used to write a temporary file. List the directories to skip in your own .sqlfluffignore, or keep the default list_of_files lint mode where MegaLinter filters the files itself
  • SARIF output is now available for 13 more linters: zizmor, bicep_linter, cppcheck, clj-kondo, roslynator, htmlhint, protolint, sqlfluff, swiftlint, osv-scanner, trufflehog, jscpd and lintr. Enable it the same way as any other SARIF-capable linter, with SARIF_REPORTER: true (optionally scoped with SARIF_REPORTER_LINTERS)
    • The 4 Salesforce Code Analyzer engines (SALESFORCE_CODE_ANALYZER_APEX, _AURA, _LWC, _FLOW) also gained SARIF output: their report switches from CSV to SARIF automatically when SARIF reporting is requested
    • csharp_roslynator is bumped from 0.12.0 to 0.13.0, the first release including its SARIF output support
    • clj-kondo's upstream SARIF output currently nests the regionclj-kondo/clj-kondo#2345
  • Prettier linters (JSON_PRETTIER, YAML_PRETTIER, JAVASCRIPT_PRETTIER, TYPESCRIPT_PRETTIER) now tell you how to install a Prettier plugin when one declared in your .prettierrc fails to load with Cannot find package ... imported from noop.js (#6980)
    • Prettier v3 resolves plugins with a native ESM import() from the workspace and ignores NODE_PATH, so plugins installed with the default cwd: root land in /node-deps where Prettier never looks for them
    • The guidance surfaced in the log is to install them through <LINTER_KEY>_PRE_COMMANDS with cwd: workspace, which keeps plain package names in .prettierrc so the very same config still works when you run Prettier locally without MegaLinter

• Fixes

  • Fixed random crashes of project-mode linters (REPOSITORY_TRIVY, REPOSITORY_GRYPE, REPOSITORY_SYFT…) caused by MegaLinter writing temporary ignore files inside the analyzed sources: a file appearing then disappearing while another linter walked the repository aborted its scan (walk dir error: ... no such file or directory). MegaLinter now writes only in REPORT_OUTPUT_FOLDER, never in your sources
  • REPORT_OUTPUT_FOLDER is now always excluded from what linters analyze, even when you override EXCLUDED_DIRECTORIES, and even when the folder does not exist yet when a linter starts
  • The API reporter variables (API_REPORTER, API_REPORTER_URL…) are not flagged as deprecated anymore in the configuration JSON schema: they were collateral damage of the removal of the API descriptor in v10.0.0, and IDEs displayed them as obsolete

... (truncated)

Commits

• 15e5b45 Release MegaLinter v10.0.0
• 861855a megalinter-setup skill: enforce ghcr.io image references in upgrade mode (#8694)
• 572dc81 [automation] Auto-update linters version, help and documentation (#8695)
• 2f62977 Refresh OX Security PR comment banner and home page banner (#8692)
• 3b8c632 chore(deps): update dependency mongodb/kingfisher to v1.112.0 (#8691)
• 7efac01 chore(deps): update mstruebing/editorconfig-checker docker tag to v3.10.0 (#8...
• 8cea326 Make custom flavor generator output pass MegaLinter (#8686)
• a057dcb [automation] Auto-update linters version, help and documentation (#8690)
• 6dece72 chore(deps): update dependency virtualenv to v21.7.2 (#8683)
• 08a6d16 docs: highlight impactful contributors in the Special thanks section (#8688)
• Additional commits viewable in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

---

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

[github-actions]

✅MegaLinter analysis: Success

Descriptor	Linter	Files	Fixed	Errors	Max errors	Warnings	Elapsed time
✅ ACTION	actionlint	1		0		0	0.04s
✅ ACTION	zizmor	1	0	0		0	1.57s
✅ REPOSITORY	betterleaks	yes		no		no	1.02s
✅ REPOSITORY	checkov	yes		no		no	15.81s
✅ REPOSITORY	git_diff	yes		no		no	0.08s
✅ REPOSITORY	osv-scanner	yes		no		no	0.8s
✅ REPOSITORY	secretlint	yes		no		no	2.39s
✅ REPOSITORY	syft	yes		no		no	1.89s
✅ REPOSITORY	trivy-sbom	yes		no		no	0.83s
✅ SPELL	lychee	1		0		0	0.09s
✅ YAML	prettier	1	0	0		0	0.47s
✅ YAML	v8r	1		0		0	1.92s
✅ YAML	yamllint	1		0		0	0.74s

Notices

⚠️ Your configuration references items that have been removed from MegaLinter and are ignored: REPOSITORY_GITLEAKS. See Removed linters to find their replacements.

See detailed reports in MegaLinter artifacts
Set VALIDATE_ALL_CODEBASE: true in mega-linter.yml to validate all sources, not only the diff

Show us your support by starring ⭐ the repository

[gwarf]

Reviewed the v9 → v10.0.0 bump against the pinned SHAs (ef3e84b vs 15e5b45), not the latest docs.

Blocking finding: one env var in the workflow goes silently inert.

REPOSITORY_GITLEAKS was removed in v10.0.0. Its replacement REPOSITORY_BETTERLEAKS is present in the documentation flavor (descriptor_flavors: all_flavors at 15e5b45), so secret scanning itself keeps running and per the release notes betterleaks reads the existing .gitleaksignore unchanged.

What breaks is the scoping line in .github/workflows/mega-linter.yml:

REPOSITORY_GITLEAKS_PR_COMMITS_SCAN: ${{ github.event_name == 'pull_request' }}

v10 ignores config vars of removed linters (one notice in the log, no error), and REPOSITORY_BETTERLEAKS_PR_COMMITS_SCAN defaults to false at the pinned SHA. Net effect after merge: every PR runs a full-workspace secret scan instead of a PR-commits-only scan. Slower, and it can surface pre-existing findings that the current PR-scoped setup never looked at.

Fix is a rename:

REPOSITORY_BETTERLEAKS_PR_COMMITS_SCAN: ${{ github.event_name == 'pull_request' }}

Non-blocking notes

• KICS is also gone in v10 (repository descriptor diff between the two SHAs). Not referenced in this workflow, so nothing to change.
• The other entries in DISABLE_LINTERS (REPOSITORY_GRYPE, REPOSITORY_TRIVY, REPOSITORY_TRUFFLEHOG, SPELL_CSPELL, CSS_STYLELINT, BASH_EXEC) and DISABLE: COPYPASTE all still exist in v10. No action.
• New default LINTER_TIMEOUT_SECONDS: 300. Current runs finish in about 1m20s total, so no exposure.
• Green CI here proves less than it looks: VALIDATE_ALL_CODEBASE resolves to false on both the push (non-main ref) and pull_request events, so neither run linted the full codebase under v10. The first real full-codebase v10 run happens on the push to main after merge.

Recommendation: land the REPOSITORY_BETTERLEAKS_PR_COMMITS_SCAN rename first (separate commit on main, so dependabot can keep rebasing this branch), then merge this bump.