@ckeditor/ckeditor5-dev-ci 53.3.2 → 53.4.0

package/README.md

@@ -8,7 +8,121 @@ Utils for [CKEditor 5](https://ckeditor.com) CI builds.
 
 Contains tools for sending Slack notifications by Travis or 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": "53.4.0",
   "description": "Utils used on various Continuous Integration services.",
   "keywords": [],
   "author": "CKSource (http://cksource.com/)",
@@ -36,7 +36,6 @@
   },
   "dependencies": {
     "@octokit/rest": "^22.0.0",
-    "minimist": "^1.2.8",
     "slack-notify": "^2.0.6"
   }
 }