@ckeditor/ckeditor5-dev-ci 53.3.2 → 54.0.0

package/README.md

@@ -6,9 +6,123 @@ CKEditor 5 CI utilities
 
 Utils for [CKEditor 5](https://ckeditor.com) CI builds.
 
-Contains tools for sending Slack notifications by Travis or Circle CI.
+Contains tools for sending Slack notifications by Circle CI.
 
-More information about development tools packages can be found at the following URL: <https://github.com/ckeditor/ckeditor5-dev>.
+## Available scripts
+
+These commands accept a mix of environment variables and command line arguments. Environment variables are preferred when the value comes from the CI environment or is sensitive (like tokens). Command line arguments are preferred when the value is static or local to a given repository.
+
+> [!WARNING]
+> Tokens are passed as environment variables to avoid exposing sensitive credentials in shell history, CI logs, or shared configuration files.
+
+- ⚙️ **`ckeditor5-dev-ci-circle-disable-auto-cancel-builds`**
+
+  Disables the _“Auto-cancel redundant workflows”_ option in CircleCI for a given repository.
+  Useful during release processes to prevent CircleCI from canceling the workflow triggered by the release commit itself.
+
+  **Environment variables:**
+  - `CKE5_CIRCLE_TOKEN` &mdash; CircleCI API token used for authentication.
+
+  **Parameters:**
+  - `--organization` &mdash; GitHub organization name.
+  - `--repository` &mdash; GitHub repository name.
+
+- ⚙️ **`ckeditor5-dev-ci-circle-enable-auto-cancel-builds`**
+
+  Enables the _“Auto-cancel redundant workflows”_ option in CircleCI for a given repository.
+  Should be used after a release workflow that temporarily disables this option using the `ckeditor5-dev-ci-circle-disable-auto-cancel-builds` script.
+
+  **Environment variables:**
+  - `CKE5_CIRCLE_TOKEN` &mdash; CircleCI API token used for authentication.
+
+  **Parameters:**
+  - `--organization` &mdash; GitHub organization name.
+  - `--repository` &mdash; GitHub repository name.
+
+- ⚙️ **`ckeditor5-dev-ci-circle-workflow-notifier`**
+
+  Waits for all jobs in the **current CircleCI workflow** to finish (success or error) and then runs a final command (the "notifier").
+  Intended to run as a **dedicated job** in your workflow. The script itself handles waiting – you typically don’t add `requires` on this job.
+
+  **Environment variables:**
+  - `CKE5_CIRCLE_TOKEN` &mdash; CircleCI API token used for authentication.
+
+  **CircleCI-provided variables:**
+  - `CIRCLE_WORKFLOW_ID` &mdash; ID of the current workflow.
+  - `CIRCLE_JOB` &mdash; Name of the current job.
+
+  **Parameters:**
+  - `--task` &mdash; Command to execute at the end; default: `pnpm ckeditor5-dev-ci-notify-circle-status`.
+  - `--ignore` &mdash; Job name to ignore when waiting (repeatable; can be passed multiple times).
+
+- ⚙️ **`ckeditor5-dev-ci-is-job-triggered-by-member`**
+
+  Verifies that a **CircleCI approval job** was approved by a user who belongs to a specified GitHub team.
+  Uses CircleCI and GitHub APIs to check the approver against the team membership.
+
+  **Environment variables:**
+  - `CKE5_CIRCLE_TOKEN` &mdash; CircleCI API token used for authentication.
+  - `CKE5_GITHUB_TOKEN` &mdash; GitHub token used to query team membership.
+
+  **CircleCI-provided variables:**
+  - `CIRCLE_WORKFLOW_ID` &mdash; ID of the current workflow.
+
+  **Parameters:**
+  - `--job` &mdash; Name of the approval job to verify.
+  - `--organization` &mdash; GitHub organization name.
+  - `--team` &mdash; GitHub team name (slug) to validate against.
+
+- ⚙️ **`ckeditor5-dev-ci-is-workflow-restarted`**
+
+  Checks whether the current CircleCI workflow has been **restarted**.
+  If a restart is detected, the script exits with a zero exit code, allowing the pipeline to continue conditionally.
+
+  **Environment variables:**
+  - `CKE5_CIRCLE_TOKEN` &mdash; CircleCI API token used for authentication.
+
+  **CircleCI-provided variables:**
+  - `CIRCLE_WORKFLOW_ID` &mdash; ID of the current workflow (set by CircleCI).
+
+- ⚙️ **`ckeditor5-dev-ci-notify-circle-status`**
+
+  Sends a Slack notification summarizing the current CircleCI build/workflow status.
+  For failed builds, fetches the commit author via the GitHub API (works with private repositories).
+
+  **Environment variables:**
+  - `CKE5_GITHUB_TOKEN` &mdash; GitHub token with the `repo` scope, used to fetch commit author.
+  - `CKE5_CIRCLE_TOKEN` &mdash; CircleCI API token used for API calls.
+  - `CKE5_SLACK_WEBHOOK_URL` &mdash; Incoming Webhook URL for the Slack channel receiving notifications.
+
+  **CircleCI-provided variables:**
+  - `CIRCLE_BRANCH` &mdash; The number of the current build.
+  - `CIRCLE_PROJECT_REPONAME` &mdash; Repository name.
+  - `CIRCLE_PROJECT_USERNAME` &mdash; Organization/user name.
+  - `CIRCLE_SHA1` &mdash; Commit SHA of the current build.
+  - `CIRCLE_WORKFLOW_ID` &mdash; ID of the current workflow.
+
+  **Parameters:**
+  - `--pipeline-id` &mdash Value of Circle's `<< pipeline.number >>` parameter ([read more](https://circleci.com/docs/guides/orchestrate/pipeline-variables/#pipeline-values)).
+  - `--trigger-repository-slug` &mdash; `<org>/<repo>` to construct the commit URL when provided with `--trigger-commit-hash`. Useful when a pipeline was triggered via a different repository.
+  - `--trigger-commit-hash` &mdash; Commit SHA to construct the commit URL. Useful when a pipeline was triggered via a different repository.
+  - `--hide-author` &mdash; `"true"`/`"false"` to hide the author in Slack.
+
+- ⚙️ **`ckeditor5-dev-ci-trigger-circle-build`**
+
+  Triggers a **new CircleCI pipeline** for a specified repository.
+  Commonly used to initiate release or follow-up pipelines from an existing workflow.
+
+  **Environment variables:**
+  - `CKE5_CIRCLE_TOKEN` &mdash; CircleCI API token used for authentication.
+
+  **CircleCI-provided variables:**
+  - `CIRCLE_BRANCH` &mdash; Git branch of the currently processed pipeline.
+  - `CIRCLE_SHA1` &mdash; Full commit SHA of the currently processed pipeline.
+
+  **Parameters:**
+  - `--slug` &mdash; Repository slug (`org/name`) where the new pipeline will be started.
+  - `--trigger-repository-slug` &mdash; *(Optional)* Repository slug (`org/name`) that triggered the new pipeline.
+    Can be omitted if it matches `--slug`.
+  - `--release-branch` &mdash; *(Optional)* Branch that leads the release process.
 
 ## Changelog
 

package/bin/circle-disable-auto-cancel-builds.js

@@ -5,6 +5,7 @@
  * For licensing, see LICENSE.md.
  */
 
+import { parseArgs } from 'util';
 import circleUpdateAutoCancelBuilds from '../lib/circle-update-auto-cancel-builds.js';
 
 /**
@@ -13,26 +14,33 @@ import circleUpdateAutoCancelBuilds from '../lib/circle-update-auto-cancel-build
  * It's needed when triggering a release process via CI to avoid canceling the release workflow by pushing
  * a new commit (the released one) that will trigger a new pipeline.
  *
- * In order to integrate the action in your pipeline, you need prepare a few environment variables:
+ * In order to integrate the action in your pipeline, you need prepare a few CLI or environment variables:
  *
- *   - CKE5_CIRCLE_TOKEN - an authorization token to talk to CircleCI REST API.
- *   - CKE5_GITHUB_ORGANIZATION - your GitHub organization.
- *   - CKE5_GITHUB_REPOSITORY - your GitHub repository.
+ *   - `CKE5_CIRCLE_TOKEN` - an authorization token to talk to CircleCI REST API.
+ *   - `--organization` - a GitHub organization.
+ *   - `--repository` - a GitHub repository.
  *
  * Example usage:
- * CKE5_CIRCLE_TOKEN=... ckeditor5-dev-ci-circle-disable-auto-cancel-builds
+ * CKE5_CIRCLE_TOKEN=... ckeditor5-dev-ci-circle-disable-auto-cancel-builds --organization ... --repository ...
  */
 
-const {
-	CKE5_CIRCLE_TOKEN,
-	CKE5_GITHUB_ORGANIZATION,
-	CKE5_GITHUB_REPOSITORY
-} = process.env;
+const { values: cliOptions } = parseArgs( {
+	options: {
+		organization: {
+			type: 'string',
+			default: process.env.CKE5_GITHUB_ORGANIZATION
+		},
+		repository: {
+			type: 'string',
+			default: process.env.CKE5_GITHUB_REPOSITORY
+		}
+	}
+} );
 
 const options = {
-	circleToken: CKE5_CIRCLE_TOKEN,
-	githubOrganization: CKE5_GITHUB_ORGANIZATION,
-	githubRepository: CKE5_GITHUB_REPOSITORY,
+	circleToken: process.env.CKE5_CIRCLE_TOKEN,
+	githubOrganization: cliOptions.organization,
+	githubRepository: cliOptions.repository,
 	newValue: false
 };
 

package/bin/circle-enable-auto-cancel-builds.js

@@ -5,6 +5,7 @@
  * For licensing, see LICENSE.md.
  */
 
+import { parseArgs } from 'util';
 import circleUpdateAutoCancelBuilds from '../lib/circle-update-auto-cancel-builds.js';
 
 /**
@@ -13,26 +14,33 @@ import circleUpdateAutoCancelBuilds from '../lib/circle-update-auto-cancel-build
  * It should be done only if a release workflow uses the `ckeditor5-dev-ci-circle-disable-auto-cancel-builds`
  * script to disable the same option.
  *
- * In order to integrate the action in your pipeline, you need prepare a few environment variables:
+ * In order to integrate the action in your pipeline, you need prepare a few CLI or environment variables:
  *
- *   - CKE5_CIRCLE_TOKEN - an authorization token to talk to CircleCI REST API.
- *   - CKE5_GITHUB_ORGANIZATION - your GitHub organization.
- *   - CKE5_GITHUB_REPOSITORY - your GitHub repository.
+ *   - `CKE5_CIRCLE_TOKEN` - an authorization token to talk to CircleCI REST API.
+ *   - `--organization` - a GitHub organization.
+ *   - `--repository` - a GitHub repository.
  *
  * Example usage:
- * CKE5_CIRCLE_TOKEN=... ckeditor5-dev-ci-circle-enable-auto-cancel-builds
+ * CKE5_CIRCLE_TOKEN=... ckeditor5-dev-ci-circle-enable-auto-cancel-builds --organization ... --repository ...
  */
 
-const {
-	CKE5_CIRCLE_TOKEN,
-	CKE5_GITHUB_ORGANIZATION,
-	CKE5_GITHUB_REPOSITORY
-} = process.env;
+const { values: cliOptions } = parseArgs( {
+	options: {
+		organization: {
+			type: 'string',
+			default: process.env.CKE5_GITHUB_ORGANIZATION
+		},
+		repository: {
+			type: 'string',
+			default: process.env.CKE5_GITHUB_REPOSITORY
+		}
+	}
+} );
 
 const options = {
-	circleToken: CKE5_CIRCLE_TOKEN,
-	githubOrganization: CKE5_GITHUB_ORGANIZATION,
-	githubRepository: CKE5_GITHUB_REPOSITORY,
+	circleToken: process.env.CKE5_CIRCLE_TOKEN,
+	githubOrganization: cliOptions.organization,
+	githubRepository: cliOptions.repository,
 	newValue: true
 };
 

package/bin/circle-workflow-notifier.js

@@ -5,8 +5,8 @@
  * For licensing, see LICENSE.md.
  */
 
+import { parseArgs } from 'util';
 import { execSync } from 'child_process';
-import minimist from 'minimist';
 import processJobStatuses from '../lib/process-job-statuses.js';
 import isWorkflowFinished from '../lib/utils/is-workflow-finished.js';
 
@@ -35,7 +35,7 @@ import isWorkflowFinished from '../lib/utils/is-workflow-finished.js';
 // See: https://github.com/ckeditor/ckeditor5/issues/16403.
 //
 // By defining the `--ignore` option, you can skip waiting for particular jobs.
-// You can also specify jobs to ignore
+// You can also specify jobs to ignore.
 //
 // Let's consider the example below:
 //   ┌─────┐     ┌─────┐
@@ -54,7 +54,7 @@ import isWorkflowFinished from '../lib/utils/is-workflow-finished.js';
 // The assumption is that "Job D" is the approval job. To ignore it and its children, you can execute
 // the notifier like this:
 //
-// $ ckeditor5-dev-ci-circle-workflow-notifier --ignore "Job D" --ignore "Job E"
+// $ ckeditor5-dev-ci-circle-workflow-notifier --ignore="Job D" --ignore="Job E"
 
 const {
 	/**
@@ -67,7 +67,19 @@ const {
 	CIRCLE_JOB
 } = process.env;
 
-const { task, ignore } = parseArguments( process.argv.slice( 2 ) );
+const { values: { task, ignore } } = parseArgs( {
+	options: {
+		task: {
+			type: 'string',
+			default: 'pnpm ckeditor5-dev-ci-notify-circle-status'
+		},
+		ignore: {
+			type: 'string',
+			multiple: true,
+			default: []
+		}
+	}
+} );
 
 waitForOtherJobsAndSendNotification()
 	.catch( err => {
@@ -113,33 +125,3 @@ async function getOtherJobsData() {
 
 	return data.items.filter( job => job.name !== CIRCLE_JOB );
 }
-
-/**
- * @param {Array.<string>} args
- * @returns {object} result
- * @returns {string} result.task
- * @returns {Array.<string>} result.ignore
- */
-function parseArguments( args ) {
-	const config = {
-		string: [
-			'task',
-			'ignore'
-		],
-
-		default: {
-			task: 'pnpm ckeditor5-dev-ci-notify-circle-status',
-			ignore: []
-		}
-	};
-
-	let { task, ignore } = minimist( args, config );
-
-	if ( typeof ignore === 'string' ) {
-		ignore = [ ignore ];
-	}
-
-	ignore = ignore.flatMap( item => item.split( ',' ) );
-
-	return { task, ignore };
-}

package/bin/is-job-triggered-by-member.js

@@ -5,40 +5,49 @@
  * For licensing, see LICENSE.md.
  */
 
+import { parseArgs } from 'util';
 import isJobTriggeredByMember from '../lib/is-job-triggered-by-member.js';
 
 /**
  * This script checks if a user that approved an approval job could do that.
  *
- * In order to integrate the action in your pipeline, you need prepare a few environment variables:
+ * In order to integrate the action in your pipeline, you need prepare a few CLI or environment variables:
  *
- *   - CIRCLE_WORKFLOW_ID - provided by default by CircleCI and keeps a unique id of the CI build.
- *   - CKE5_CIRCLE_TOKEN - an authorization token to talk to CircleCI REST API.
- *   - CKE5_CIRCLE_APPROVAL_JOB_NAME - a job name to verify.
- *   - CKE5_GITHUB_TOKEN - a GitHub token used for authorization a request.
- *   - CKE5_GITHUB_TEAM_SLUG - a GitHub team slug that defines accounts that could approve the job.
- *   - CKE5_GITHUB_ORGANIZATION - your GitHub organization.
+ *   - `CIRCLE_WORKFLOW_ID` - provided by default by CircleCI and keeps a unique id of the CI build.
+ *   - `CKE5_CIRCLE_TOKEN` - an authorization token to talk to CircleCI REST API.
+ *   - `CKE5_GITHUB_TOKEN` - a GitHub token used for authorization a request.
+ *   - `--team` - a GitHub team name (slug) that defines accounts that could approve the job.
+ *   - `--organization` - your GitHub organization.
+ *  - `--job` - a job name to verify.
  *
  * Example usage:
  * CKE5_CIRCLE_TOKEN=... ckeditor5-dev-ci-is-job-triggered-by-member
  */
 
-const {
-	CIRCLE_WORKFLOW_ID,
-	CKE5_CIRCLE_TOKEN,
-	CKE5_CIRCLE_APPROVAL_JOB_NAME,
-	CKE5_GITHUB_TOKEN,
-	CKE5_GITHUB_TEAM_SLUG,
-	CKE5_GITHUB_ORGANIZATION
-} = process.env;
+const { values: cliOptions } = parseArgs( {
+	options: {
+		job: {
+			type: 'string',
+			default: process.env.CKE5_CIRCLE_APPROVAL_JOB_NAME
+		},
+		organization: {
+			type: 'string',
+			default: process.env.CKE5_GITHUB_ORGANIZATION
+		},
+		team: {
+			type: 'string',
+			default: process.env.CKE5_GITHUB_TEAM_SLUG
+		}
+	}
+} );
 
 const options = {
-	circleToken: CKE5_CIRCLE_TOKEN,
-	circleWorkflowId: CIRCLE_WORKFLOW_ID,
-	circleApprovalJobName: CKE5_CIRCLE_APPROVAL_JOB_NAME,
-	githubOrganization: CKE5_GITHUB_ORGANIZATION,
-	githubTeamSlug: CKE5_GITHUB_TEAM_SLUG,
-	githubToken: CKE5_GITHUB_TOKEN
+	circleToken: process.env.CKE5_CIRCLE_TOKEN,
+	circleWorkflowId: process.env.CIRCLE_WORKFLOW_ID,
+	circleApprovalJobName: cliOptions.job,
+	githubOrganization: cliOptions.organization,
+	githubTeamSlug: cliOptions.team,
+	githubToken: process.env.CKE5_GITHUB_TOKEN
 };
 
 isJobTriggeredByMember( options )

package/bin/notify-circle-status.js

@@ -5,6 +5,7 @@
  * For licensing, see LICENSE.md.
  */
 
+import { parseArgs } from 'util';
 import slackNotify from 'slack-notify';
 import formatMessage from '../lib/format-message.js';
 
@@ -14,11 +15,6 @@ import formatMessage from '../lib/format-message.js';
 // Described environment variables starting with "CKE5" should be added by the integrator.
 
 const {
-	/**
-	 * Required. Value of Circle's `pipeline.number` variable.
-	 */
-	CKE5_PIPELINE_NUMBER,
-
 	/**
 	 * Required. Token to a Github account with the scope: "repos". It is required for obtaining an author of
 	 * the commit if the build failed. The repository can be private and we can't use the public API.
@@ -35,28 +31,49 @@ const {
 	 */
 	CKE5_SLACK_WEBHOOK_URL,
 
-	/**
-	 * Optional. If both are defined, the script will use the URL as the commit URL.
-	 * Otherwise, URL will be constructed using current repository data.
-	 */
-	CKE5_TRIGGER_REPOSITORY_SLUG,
-	CKE5_TRIGGER_COMMIT_HASH,
-
-	/**
-	 * Optional. If set to "true", commit author will be hidden.
-	 * See: https://github.com/ckeditor/ckeditor5/issues/9252.
-	 */
-	CKE5_SLACK_NOTIFY_HIDE_AUTHOR,
-
 	// Variables that are available by default in Circle environment.
 	CIRCLE_BRANCH,
-	CIRCLE_BUILD_NUM,
 	CIRCLE_PROJECT_REPONAME,
 	CIRCLE_PROJECT_USERNAME,
 	CIRCLE_SHA1,
 	CIRCLE_WORKFLOW_ID
 } = process.env;
 
+const { values: cliArguments } = parseArgs( {
+	options: {
+		/**
+		 * Required. Value of Circle's `pipeline.number` variable.
+		 * Unfortunately, it does not overlap with `CIRCLE_BUILD_NUM`.
+		 */
+		'pipeline-id': {
+			type: 'string',
+			default: process.env.CKE5_PIPELINE_NUMBER
+		},
+
+		/**
+		 * Optional. If both are defined, the script will use the URL as the commit URL.
+		 * Otherwise, URL will be constructed using the current repository data.
+		 */
+		'trigger-repository-slug': {
+			type: 'string',
+			default: process.env.CKE5_TRIGGER_REPOSITORY_SLUG
+		},
+		'trigger-commit-hash': {
+			type: 'string',
+			default: process.env.CKE5_TRIGGER_COMMIT_HASH
+		},
+
+		/**
+		 * Optional. If set to "true" or "1", commit author will be hidden.
+		 * See: https://github.com/ckeditor/ckeditor5/issues/9252.
+		 */
+		'hide-author': {
+			type: 'string',
+			default: process.env.CKE5_SLACK_NOTIFY_HIDE_AUTHOR
+		}
+	}
+} );
+
 notifyCircleStatus();
 
 async function notifyCircleStatus() {
@@ -68,12 +85,16 @@ async function notifyCircleStatus() {
 		throw new Error( 'Missing environment variable: CKE5_SLACK_WEBHOOK_URL' );
 	}
 
+	if ( !CKE5_CIRCLE_TOKEN ) {
+		throw new Error( 'Missing environment variable: CKE5_CIRCLE_TOKEN' );
+	}
+
 	const jobData = await getJobData();
 	const buildUrl = [
 		'https://app.circleci.com/pipelines/github',
 		CIRCLE_PROJECT_USERNAME,
 		CIRCLE_PROJECT_REPONAME,
-		CKE5_PIPELINE_NUMBER,
+		cliArguments[ 'pipeline-id' ],
 		'workflows',
 		CIRCLE_WORKFLOW_ID
 	].join( '/' );
@@ -91,7 +112,7 @@ async function notifyCircleStatus() {
 		triggeringCommitUrl: getTriggeringCommitUrl(),
 		startTime: Math.ceil( ( new Date( jobData.started_at ) ).getTime() / 1000 ),
 		endTime: Math.ceil( ( new Date() ) / 1000 ),
-		shouldHideAuthor: CKE5_SLACK_NOTIFY_HIDE_AUTHOR === 'true'
+		shouldHideAuthor: isTrueLike( cliArguments[ 'hide-author' ] )
 	} );
 
 	return slackNotify( CKE5_SLACK_WEBHOOK_URL )
@@ -105,7 +126,7 @@ async function getJobData() {
 		CIRCLE_PROJECT_USERNAME,
 		CIRCLE_PROJECT_REPONAME,
 		'job',
-		CIRCLE_BUILD_NUM
+		cliArguments[ 'pipeline-id' ]
 	].join( '/' );
 
 	const fetchOptions = {
@@ -120,9 +141,12 @@ async function getJobData() {
 function getTriggeringCommitUrl() {
 	let repoSlug, hash;
 
-	if ( CKE5_TRIGGER_REPOSITORY_SLUG && CKE5_TRIGGER_COMMIT_HASH ) {
-		repoSlug = CKE5_TRIGGER_REPOSITORY_SLUG.trim();
-		hash = CKE5_TRIGGER_COMMIT_HASH.trim();
+	const cliRepoSlug = cliArguments[ 'trigger-repository-slug' ];
+	const cliCommitHash = cliArguments[ 'trigger-commit-hash' ];
+
+	if ( cliRepoSlug && cliCommitHash ) {
+		repoSlug = cliRepoSlug.trim();
+		hash = cliCommitHash.trim();
 	} else {
 		repoSlug = [ CIRCLE_PROJECT_USERNAME, CIRCLE_PROJECT_REPONAME ].join( '/' );
 		hash = CIRCLE_SHA1;
@@ -130,3 +154,7 @@ function getTriggeringCommitUrl() {
 
 	return [ 'https://github.com', repoSlug, 'commit', hash ].join( '/' );
 }
+
+function isTrueLike( value ) {
+	return value === true || value === 1 || value === '1' || value === 'true';
+}

package/bin/trigger-circle-build.js

@@ -5,43 +5,53 @@
  * For licensing, see LICENSE.md.
  */
 
+import { parseArgs } from 'util';
 import triggerCircleBuild from '../lib/trigger-circle-build.js';
 
 /**
  * This script triggers a new CircleCI build.
  *
- * In order to integrate the action in your pipeline, you need prepare a few environment variables:
+ * In order to integrate the action in your pipeline, you need prepare a few CLI or environment variables:
  *
- *   - CIRCLE_BRANCH - provided by default by CircleCI and keeps the git branch of processed build.
- *   - CKE5_COMMIT_SHA1 - a full commit identifier of the processed the build.
- *   - CKE5_CIRCLE_TOKEN - an authorization token to talk to CircleCI REST API.
- *   - CKE5_GITHUB_REPOSITORY_SLUG - a repository slug (org/name) where a new build will be started.
- *   - CKE5_GITHUB_RELEASE_BRANCH - (optional) define a branch that leads the release process.
- *   - CKE5_GITHUB_TRIGGER_REPOSITORY_SLUG - (optional) a repository slug (org/name) that triggers a new build.
+ *   - `CIRCLE_BRANCH` - provided by default by CircleCI and keeps the git branch of processed pipeline.
+ *   - `CIRCLE_SHA1` - provided by default by CircleCI and keeps a full commit identifier of the processed the pipeline.
+ *   - `CKE5_CIRCLE_TOKEN` - an authorization token to talk to CircleCI REST API.
+ *   - `--slug` - a repository slug (org/name) where a new pipeline will be started.
+ *   - `--trigger-repository-slug` - (optional) a repository slug (org/name) that triggers a new pipeline.
+ *     Can be skipped when overlaps with `--slug`.
+ *   - `--release-branch` - (optional) define a branch that leads the release process.
  *
  * Example usage:
  * CKE5_CIRCLE_TOKEN=... ckeditor5-dev-ci-trigger-circle-build
  */
 
-const {
-	CKE5_COMMIT_SHA1,
-	CIRCLE_BRANCH,
-	CKE5_CIRCLE_TOKEN,
-	CKE5_GITHUB_RELEASE_BRANCH,
-	CKE5_GITHUB_REPOSITORY_SLUG,
-	CKE5_GITHUB_TRIGGER_REPOSITORY_SLUG
-} = process.env;
+const { values: cliOptions } = parseArgs( {
+	options: {
+		slug: {
+			type: 'string',
+			default: process.env.CKE5_GITHUB_REPOSITORY_SLUG
+		},
+		'trigger-repository-slug': {
+			type: 'string',
+			default: process.env.CKE5_GITHUB_TRIGGER_REPOSITORY_SLUG
+		},
+		'release-branch': {
+			type: 'string',
+			default: process.env.CKE5_GITHUB_RELEASE_BRANCH
+		}
+	}
+} );
 
 const options = {
-	circleToken: CKE5_CIRCLE_TOKEN,
-	commit: CKE5_COMMIT_SHA1,
-	branch: CIRCLE_BRANCH,
-	releaseBranch: CKE5_GITHUB_RELEASE_BRANCH,
-	repositorySlug: CKE5_GITHUB_REPOSITORY_SLUG
+	circleToken: process.env.CKE5_CIRCLE_TOKEN,
+	commit: process.env.CIRCLE_SHA1,
+	branch: process.env.CIRCLE_BRANCH,
+	releaseBranch: cliOptions[ 'release-branch' ],
+	repositorySlug: cliOptions.slug
 };
 
-if ( CKE5_GITHUB_TRIGGER_REPOSITORY_SLUG ) {
-	options.triggerRepositorySlug = CKE5_GITHUB_TRIGGER_REPOSITORY_SLUG;
+if ( cliOptions[ 'trigger-repository-slug' ] ) {
+	options.triggerRepositorySlug = cliOptions[ 'trigger-repository-slug' ];
 }
 
 triggerCircleBuild( options )

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-dev-ci",
-  "version": "53.3.2",
+  "version": "54.0.0",
   "description": "Utils used on various Continuous Integration services.",
   "keywords": [],
   "author": "CKSource (http://cksource.com/)",
@@ -13,7 +13,7 @@
     "directory": "packages/ckeditor5-dev-ci"
   },
   "engines": {
-    "node": ">=22.0.0",
+    "node": ">=24.11.0",
     "npm": ">=5.7.1"
   },
   "type": "module",
@@ -23,11 +23,8 @@
     "lib"
   ],
   "bin": {
-    "ckeditor5-dev-ci-notify-travis-status": "bin/notify-travis-status.js",
     "ckeditor5-dev-ci-notify-circle-status": "bin/notify-circle-status.js",
     "ckeditor5-dev-ci-circle-workflow-notifier": "bin/circle-workflow-notifier.js",
-    "ckeditor5-dev-ci-allocate-swap-memory": "bin/allocate-swap-memory.sh",
-    "ckeditor5-dev-ci-install-latest-chrome": "bin/install-latest-chrome.sh",
     "ckeditor5-dev-ci-is-job-triggered-by-member": "bin/is-job-triggered-by-member.js",
     "ckeditor5-dev-ci-is-workflow-restarted": "bin/is-workflow-restarted.js",
     "ckeditor5-dev-ci-trigger-circle-build": "bin/trigger-circle-build.js",
@@ -36,7 +33,6 @@
   },
   "dependencies": {
     "@octokit/rest": "^22.0.0",
-    "minimist": "^1.2.8",
     "slack-notify": "^2.0.6"
   }
 }

package/bin/allocate-swap-memory.sh

@@ -1,21 +0,0 @@
-#!/bin/bash
-
-# @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
-# For licensing, see LICENSE.md.
-
-echo "Allocating swap memory to prevent running out of RAM."
-
-# Remove existing swap so that allocating new swap does not throw.
-sudo swapoff -a
-
-# Create a 4 gigabyte swapfile.
-sudo fallocate -l 4G /swapfile
-
-# Secure the swapfile by restricting access to root.
-sudo chmod 600 /swapfile
-
-# Mark the file as a swap space.
-sudo mkswap /swapfile
-
-# Enable the swap.
-sudo swapon /swapfile

package/bin/install-latest-chrome.sh

@@ -1,13 +0,0 @@
-#!/bin/bash
-
-# @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
-# For licensing, see LICENSE.md.
-
-echo "Installing the latest Chrome."
-
-sudo apt-get update
-sudo apt-get install lsb-release libappindicator3-1
-curl -L -o google-chrome.deb https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
-sudo dpkg -i google-chrome.deb
-sudo sed -i 's|HERE/chrome"|HERE/chrome" --no-sandbox|g' /opt/google/chrome/google-chrome
-rm google-chrome.deb

package/bin/notify-travis-status.js

@@ -1,111 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md.
- */
-
-import formatMessage from '../lib/format-message.js';
-import slackNotify from 'slack-notify';
-
-const ALLOWED_BRANCHES = [
-	'stable',
-	'master'
-];
-
-const ALLOWED_EVENTS = [
-	'push',
-	'cron',
-	'api'
-];
-
-// This script assumes that is being executed on Travis CI.
-// Described environment variables should be added by the integrator.
-
-const {
-	/**
-	 * POSIX timestamps created when the script has begun and ended the job.
-	 * Timestamps should be in seconds instead of milliseconds.
-	 */
-	START_TIME,
-	END_TIME,
-
-	/**
-	 * Token to a Github account with the scope: "repos". It is required for obtaining an author of
-	 * the commit if the build failed. The repository can be private and we can't use the public API.
-	 */
-	GITHUB_TOKEN,
-
-	/**
-	 * Required. Webhook URL of the Slack channel where the notification should be sent.
-	 */
-	SLACK_WEBHOOK_URL,
-
-	/**
-	 * Optional. If defined, the script will use the URL as the commit URL.
-	 * Otherwise, URL will be constructed using current repository data.
-	 */
-	SLACK_NOTIFY_COMMIT_URL,
-
-	/**
-	 * Optional. If set to "true", commit author will be hidden.
-	 * See: https://github.com/ckeditor/ckeditor5/issues/9252.
-	 */
-	SLACK_NOTIFY_HIDE_AUTHOR,
-
-	// Variables that are available by default in Travis environment.
-	TRAVIS_BRANCH,
-	TRAVIS_COMMIT,
-	TRAVIS_EVENT_TYPE,
-	TRAVIS_JOB_NUMBER,
-	TRAVIS_JOB_WEB_URL,
-	TRAVIS_REPO_SLUG,
-	TRAVIS_TEST_RESULT
-} = process.env;
-
-notifyTravisStatus();
-
-async function notifyTravisStatus() {
-	// Send a notification only for main branches...
-	if ( !ALLOWED_BRANCHES.includes( TRAVIS_BRANCH ) ) {
-		console.log( `Aborting slack notification due to an invalid branch (${ TRAVIS_BRANCH }).` );
-
-		process.exit();
-	}
-
-	// ...and an event that triggered the build is correct...
-	if ( !ALLOWED_EVENTS.includes( TRAVIS_EVENT_TYPE ) ) {
-		console.log( `Aborting slack notification due to an invalid event type (${ TRAVIS_EVENT_TYPE }).` );
-
-		process.exit();
-	}
-
-	// ...and for builds that failed.
-	if ( TRAVIS_TEST_RESULT == 0 ) {
-		console.log( 'The build did not fail. The notification will not be sent.' );
-
-		process.exit();
-	}
-
-	const [ repositoryOwner, repositoryName ] = TRAVIS_REPO_SLUG.split( '/' );
-
-	const message = await formatMessage( {
-		slackMessageUsername: 'Travis CI',
-		iconUrl: 'https://a.slack-edge.com/66f9/img/services/travis_36.png',
-		repositoryOwner,
-		repositoryName,
-		branch: TRAVIS_BRANCH,
-		buildTitle: 'Job number',
-		buildUrl: TRAVIS_JOB_WEB_URL,
-		buildId: '#' + TRAVIS_JOB_NUMBER,
-		githubToken: GITHUB_TOKEN,
-		triggeringCommitUrl: SLACK_NOTIFY_COMMIT_URL || `https://github.com/${ TRAVIS_REPO_SLUG }/commit/${ TRAVIS_COMMIT }`,
-		startTime: Number( START_TIME ),
-		endTime: Number( END_TIME ),
-		shouldHideAuthor: SLACK_NOTIFY_HIDE_AUTHOR === 'true'
-	} );
-
-	return slackNotify( SLACK_WEBHOOK_URL )
-		.send( message )
-		.catch( err => console.log( 'API error occurred:', err ) );
-}