gulpjs · phated · Sep 27, 2026 · Sep 27, 2026 · Sep 27, 2026
diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
@@ -0,0 +1,22 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/javascript-node
+{
+  "name": "Node.js",
+  // Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+  "image": "mcr.microsoft.com/devcontainers/javascript-node:1-22-bookworm"
+
+  // Features to add to the dev container. More info: https://containers.dev/features.
+  // "features": {},
+
+  // Use 'forwardPorts' to make a list of ports inside the container available locally.
+  // "forwardPorts": [],
+
+  // Use 'postCreateCommand' to run commands after the container is created.
+  // "postCreateCommand": "yarn install",
+
+  // Configure tool-specific properties.
+  // "customizations": {},
+
+  // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+  // "remoteUser": "root"
+}
diff --git a/.eslintignore b/.eslintignore
diff --git a/.eslintrc b/.eslintrc
diff --git a/.github/workflows/dev.yml b/.github/workflows/dev.yml
@@ -3,51 +3,38 @@ on:
   pull_request:
   push:
     branches:
-      - master
       - main
 env:
   CI: true
 
 jobs:
-  prettier:
-    name: Format code
-    runs-on: ubuntu-latest
-    if: ${{ github.event_name == 'push' }}
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v2
-
-      - name: Prettier
-        uses: gulpjs/prettier_action@v3.0
-        with:
-          commit_message: 'chore: Run prettier'
-          prettier_options: '--write .'
-
   test:
     name: Tests for Node ${{ matrix.node }} on ${{ matrix.os }}
     runs-on: ${{ matrix.os }}
 
     strategy:
       fail-fast: false
       matrix:
-        node: [10, 12, 14, 16, 18, 20, 22, 24]
-        os: [ubuntu-latest, windows-latest, macos-13]
+        node: [22, 24, 26]
+        os: [ubuntu-latest, windows-latest, macos-latest]
 
     steps:
       - name: Clone repository
-        uses: actions/checkout@v2
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
       - name: Set Node.js version
-        uses: actions/setup-node@v2
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
         with:
           node-version: ${{ matrix.node }}
 
-      - run: node --version
-      - run: npm --version
+      - name: Check node version
+        run: node --version
+
+      - name: Check npm version
+        run: npm --version
 
       - name: Install npm dependencies
-        run: npm install
+        run: npm ci
 
       - name: Run lint
         run: npm run lint
@@ -56,31 +43,24 @@ jobs:
         # Run test without coverage because a behavior about esm is different with nyc or not
         run: npm test
 
+      - name: Check format
+        run: npm run format-check
+
+      - name: Coveralls
+        uses: coverallsapp/github-action@8d6379e14d29928660c4ba802d8e85393440b329 # v2.3.8
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          flag-name: ${{matrix.os}}-node-${{ matrix.node }}
+          parallel: true
+
   coveralls:
     needs: test
     name: Finish up
 
     runs-on: ubuntu-latest
     steps:
-      - name: Clone repository
-        uses: actions/checkout@v2
-
-      - name: Set Node.js version
-        uses: actions/setup-node@v2
-        with:
-          # Coverage with LTS version
-          node-version: 18
-
-      - run: node --version
-      - run: npm --version
-
-      - name: Install npm dependencies
-        run: npm install
-
-      - name: Run coverage
-        run: npm run cover
-
-      - name: Coveralls
-        uses: coverallsapp/github-action@v1.1.2
+      - name: Coveralls Finished
+        uses: coverallsapp/github-action@8d6379e14d29928660c4ba802d8e85393440b329 # v2.3.8
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
+          parallel-finished: true
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -2,15 +2,17 @@ name: release
 on:
   push:
     branches:
-      - master
       - main
 
 jobs:
   release-please:
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      issues: write
+      pull-requests: write
     steps:
-      - uses: GoogleCloudPlatform/release-please-action@v2
+      - uses: googleapis/release-please-action@45996ed1f6d02564a971a2fa1b5860e934307cf7 # v5.0.0
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           release-type: node
-          package-name: release-please-action
diff --git a/.gitignore b/.gitignore
@@ -9,10 +9,57 @@ components
 coverage
 .coveralls.yml
 .nyc_output
-*.orig
-.idea
-sandbox
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# TypeScript v1 declaration files
+typings/
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+
+# next.js build output
+.next
+
+# Garbage files
+.DS_Store
+
+# Test results
+test.xunit
 test/out-fixtures/*
+!test/fixtures/errors/bad-gulp-version/node_modules/
+!test/fixtures/config/theming/UNSUPPORTED_GULP_VERSION/node_modules/
 test/output/
 test/watch-*.txt
+
+# Manpage
 gulp.1
diff --git a/.npmrc b/.npmrc
diff --git a/LICENSE b/LICENSE
@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015, 2017-2020, 2022-2023 Blaine Bublitz <blaine.bublitz@gmail.com> and Eric Schoffstall <yo@contra.io>
+Copyright (c) 2015, 2017-2020, 2022-2023, 2026 Blaine Bublitz <blaine.bublitz@gmail.com> and Eric Schoffstall <yo@contra.io>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

diff --git a/README.md b/README.md
@@ -26,14 +26,14 @@ npm install --global gulp-cli
 
 When listing tasks with the `gulp -T` command, gulp-cli displays some custom metadata as defined upon task functions. Currently supported properties:
 
-* `task.description` - String of the description to display.
+- `task.description` - String of the description to display.
 
 ```js
 function clean() { ... }
 clean.description = 'Cleans up generated files.';
 ```
 
-* `task.flags` - Object with key/value pairs being flag/description to display.
+- `task.flags` - Object with key/value pairs being flag/description to display.
 
 ```js
 function build() { ... }
@@ -69,6 +69,7 @@ Just running `gulp` will execute the task `default`. If there is no
 `default` task, gulp will error.
 
 ## Completion
+
 > Thanks to the grunt team, specifically Tyler Kellen
 
 To enable tasks auto-completion in shell you should add `eval "$(gulp --completion=shell)"` in your `.shellrc` file.
@@ -105,25 +106,25 @@ A configuration file from the current working directory (`cwd`) or above are sel
 
 Supported configurations properties:
 
-| Property           | Description |
-|--------------------|-------------|
-| description        | Top-level description of the project/gulpfile (Replaces "Tasks for ~/path/of/gulpfile.js") |
-| gulpfile           | Set a default gulpfile |
-| preload            | An array of modules to preload before running the gulpfile. Any relative paths will be resolved against the `--cwd` directory (if you don't want that behavior, use absolute paths) |
-| nodeFlags          | An array of flags used to forcibly respawn the process upon startup. For example, if you always want your gulpfiles to run in node's harmony mode, you can set `--harmony` here |
-| flags.continue     | Continue execution of tasks upon failure by default. |
-| flags.compactTasks | Reduce the output of task dependency tree by default. |
-| flags.tasksDepth   | Set default depth of task dependency tree. |
-| flags.silent       | Silence logging by default |
-| flags.series       | Run tasks given on the CLI in series (the default is parallel) |
-| message(data)      | A function used to translate messages that pass through gulp-cli. Can receive an object like `{ tag: Symbol(), ...props }` where the `tag` is a symbol from `@gulpjs/messages`. The string returned from this function will be logged. If `false` is explicitly returned, no message will be logged. |
+| Property           | Description                                                                                                                                                                                                                                                                                                  |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| description        | Top-level description of the project/gulpfile (Replaces "Tasks for ~/path/of/gulpfile.js")                                                                                                                                                                                                                   |
+| gulpfile           | Set a default gulpfile                                                                                                                                                                                                                                                                                       |
+| preload            | An array of modules to preload before running the gulpfile. Any relative paths will be resolved against the `--cwd` directory (if you don't want that behavior, use absolute paths)                                                                                                                          |
+| nodeFlags          | An array of flags used to forcibly respawn the process upon startup. For example, if you always want your gulpfiles to run in node's harmony mode, you can set `--harmony` here                                                                                                                              |
+| flags.continue     | Continue execution of tasks upon failure by default.                                                                                                                                                                                                                                                         |
+| flags.compactTasks | Reduce the output of task dependency tree by default.                                                                                                                                                                                                                                                        |
+| flags.tasksDepth   | Set default depth of task dependency tree.                                                                                                                                                                                                                                                                   |
+| flags.silent       | Silence logging by default                                                                                                                                                                                                                                                                                   |
+| flags.series       | Run tasks given on the CLI in series (the default is parallel)                                                                                                                                                                                                                                               |
+| message(data)      | A function used to translate messages that pass through gulp-cli. Can receive an object like `{ tag: Symbol(), ...props }` where the `tag` is a symbol from `@gulpjs/messages`. The string returned from this function will be logged. If `false` is explicitly returned, no message will be logged.         |
 | timestamp(data)    | A function used to provide timestamps for gulp-cli. Can receive an object like `{ tag: Symbol(), ...props }` where the `tag` is a symbol from `@gulpjs/messages`. The string returned from this function will be output before any messages. If `false` is explicitly returned, no timestamp will be output. |
 
 ## Flags
 
 gulp has very few flags to know about. All other flags are for tasks to use if needed.
 
-__Some flags only work with gulp 4 and will be ignored when invoked against gulp 3.__
+**Some flags only work with gulp 4 and will be ignored when invoked against gulp 3.**
 
 <table>
   <thead>
@@ -222,6 +223,16 @@ __Some flags only work with gulp 4 and will be ignored when invoked against gulp
   </tbody>
 </table>
 
+## Strict No LLM / No AI Policy
+
+No LLMs for issues.
+
+No LLMs for patches / pull requests.
+
+No LLMs for comments on the bug tracker, including translation.
+
+English is encouraged, but not required. You are welcome to post in your native language and rely on others to have their own translation tools of choice to interpret your words.
+
 ## License
 
 MIT
@@ -235,9 +246,9 @@ MIT
 [npm-url]: https://www.npmjs.com/package/gulp-cli
 [npm-image]: https://img.shields.io/npm/v/gulp-cli.svg?style=flat-square
 
-[ci-url]: https://github.com/gulpjs/gulp-cli/actions?query=workflow:dev
-[ci-image]: https://img.shields.io/github/actions/workflow/status/gulpjs/gulp-cli/dev.yml?branch=master&style=flat-square
+[ci-url]: https://github.com/gulpjs/gulp-cli/actions/workflows/dev.yml
+[ci-image]: https://img.shields.io/github/actions/workflow/status/gulpjs/gulp-cli/dev.yml?style=flat-square
 
 [coveralls-url]: https://coveralls.io/r/gulpjs/gulp-cli
-[coveralls-image]: https://img.shields.io/coveralls/gulpjs/gulp-cli.svg?style=flat-square
+[coveralls-image]: https://img.shields.io/coveralls/gulpjs/gulp-cli/main.svg?style=flat-square
 <!-- prettier-ignore-end -->
diff --git a/bin/gulp.js b/bin/gulp.js
@@ -1,5 +1,5 @@
 #!/usr/bin/env node
 
-'use strict';
+"use strict";
 
-require('../')();
+require("../")();
diff --git a/completion/README.md b/completion/README.md
@@ -1,4 +1,5 @@
 # Completion for gulp
+
 > Thanks to the grunt team, specifically Tyler Kellen
 
 To enable tasks auto-completion in shell you should add `eval "$(gulp --completion=shell)"` in your `.shellrc` file.