@release-change/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present Victor Brito
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,278 @@
+# @release-change/cli
+
+Fully automated version management, changelog management and package publishing with a focus on monorepos, pre-releases and major version zero
+
+![License: MIT](https://img.shields.io/github/license/release-change/release-change)
+[![ESM-only package](https://img.shields.io/badge/package-ESM--only-ffe536)](https://nodejs.org/api/esm.html)
+[![Conventional Commits 1.0.0](https://img.shields.io/badge/Conventional%20Commits-1.0.0-%23FE5196?logo=conventionalcommits&logoColor=white)](https://conventionalcommits.org)
+[![Formatted with Biome](https://img.shields.io/badge/Formatted_with-Biome-60a5fa?style=flat&logo=biome)](https://biomejs.dev/)
+![NPM latest version](https://img.shields.io/npm/v/%40release-change%2Fcli/latest)
+![Node support](https://img.shields.io/node/v/%40release-change%2Fcli)
+![Build status](https://img.shields.io/github/actions/workflow/status/release-change/release-change/run-tests.yml)
+
+**release-change** automates the release workflow, determining the next version number, generating release notes and publishing the package.
+
+## How does it work?
+
+release-change uses the commit messages to determine the type of change in the codebase. It automatically determines the next [semantic version](https://semver.org).
+
+It uses the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) specification. The following table shows which release type is got from which commit message when `release-change` runs:
+
+| Commit message                                                                                              | Release type                                                                                          |
+|-------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|
+| `fix: prevent racing of requests`                                                                           | Patch (fix release)                                                                                   |
+| `feat(lang): add Polish language`                                                                           | Minor (feature release)                                                                               |
+| `chore!: drop support for Node 6`                                                                           | Major (breaking release)                                                                              |
+| `chore: drop support for Node 6`<br><br>`BREAKING CHANGE: use JavaScript features not available in Node 6.` | Major (breaking release, note that the `BREAKING CHANGE: ` token must be in the footer of the commit) |
+
+It is meant to be integrated in a CI environment. For each new commit added to one of the release branches (for example: `main`), with `git push`, a pull request merging or a merging from another branch, a CI build is triggered and runs the `release-change` command to make a release if there are codebase changes since the last release which affect the package functionalities.
+
+## Requirements
+
+To use release-change, you need:
+- to host your code in a GitHub repository,
+- to use GitHub Actions,
+- Git 2.48.1+,
+- a [Node.js](https://nodejs.org) which meets the [version requirements](../../SECURITY.md#supported-nodejs-versions),
+- a package manager which meets the [version requirements](../../SECURITY.md#supported-package-manager-versions).
+
+## Installation
+
+Install package for Node.js:
+```
+pnpm add --save-dev @release-change/cli
+```
+You can also install it using `npm`:
+```
+npm install --save-dev @release-change/cli
+```
+
+## Usage
+
+Use the following command to run release-change in the CI environment:
+```
+pnpx release-change
+```
+If you are using `npm`:
+```
+npx release-change
+```
+
+## Documentation
+
+### CI configuration
+
+release-change requires access to the project repository. The Git authentication is set with the `RELEASE_TOKEN` environment variable, which is a [GitHub personal access token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens).
+
+Here are examples of the workflow configuration (the file must be saved in the `.github/workflows/` directory):
+- using `pnpm`:
+  ```yaml
+  name: Release
+  
+  on:
+    push:
+      branches:
+        - main
+  
+  permissions:
+    contents: read # for checkout
+  
+  jobs:
+    release:
+      name: Release
+      runs-on: ubuntu-latest
+      permissions:
+        contents: write # to be able to publish a GitHub release
+        issues: write # to be able to comment on issues
+        pull-requests: write # to be able to comment on pull requests
+        id-token: write # to enable use of OpenID Connect to publish to NPM with provenance
+      steps:
+        - name: Checkout
+          uses: actions/checkout@v5
+          with:
+            fetch-depth: 0 # to clone the whole Git history
+        - name: Install pnpm
+          uses: pnpm/action-setup@v4
+          with:
+            version: 10
+        - name: Setup Node.js
+          uses: actions/setup-node@v5
+          with:
+            node-version: "lts/*"
+            cache: "pnpm"
+        - name: Install dependencies
+          run: pnpm install
+        - name: Release
+          env:
+            RELEASE_TOKEN: ${{ secrets.RELEASE_TOKEN }}
+            ISSUE_PR_TOKEN: ${{ secrets.GITHUB_TOKEN }} # to be able to comment on issues and pull requests, close issues and tag pull requests using the GitHub Actions bot
+            NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+            NPM_CONFIG_PROVENANCE: true # to be able to publish to NPM with provenance
+          run: pnpx release-change
+  ```
+- using `npm`:
+  ```yaml
+  name: Release
+  
+  on:
+    push:
+      branches:
+        - main
+  
+  permissions:
+    contents: read # for checkout
+  
+  jobs:
+    release:
+      name: Release
+      runs-on: ubuntu-latest
+      permissions:
+        contents: write # to be able to publish a GitHub release
+        issues: write # to be able to comment on issues
+        pull-requests: write # to be able to comment on pull requests
+        id-token: write # to enable use of OpenID Connect to publish to NPM with provenance
+      steps:
+        - name: Checkout
+          uses: actions/checkout@v5
+          with:
+            fetch-depth: 0 # to clone the whole Git history
+        - name: Setup Node.js
+          uses: actions/setup-node@v5
+          with:
+            node-version: "lts/*"
+            cache: "npm"
+        - name: Install dependencies
+          run: npm clean-install
+        - name: Release
+          env:
+            RELEASE_TOKEN: ${{ secrets.RELEASE_TOKEN }}
+            ISSUE_PR_TOKEN: ${{ secrets.GITHUB_TOKEN }} # to be able to comment on issues and pull requests, close issues and tag pull requests using the GitHub Actions bot
+            NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+            NPM_CONFIG_PROVENANCE: true # to be able to publish to NPM with provenance
+          run: npx release-change
+  ```
+
+### Configuration
+
+#### Configuration file
+
+release-change’s options can be set via a `release-change.config.json` file, written in JSON and placed at the root of the project.
+
+Alternatively, some options can be set via CLI arguments.
+
+The following examples are the same:
+- via `release-change.config.json` file:
+  ```json
+  {
+    "branches": ["main", "next"]
+  }
+  ```
+- via CLI arguments:
+  ```
+  release-change --branches main next
+  ```
+
+#### Options
+
+##### branches
+
+Type: `array`  
+Default: `["alpha", "beta", "main", "master", "next"]`  
+CLI arguments: `-b`, `--branches`
+
+The branches on which releases should happen.
+
+##### repositoryUrl
+
+Type: `string`  
+Default: `repository` property in `package.json` file  
+CLI arguments: `-r`, `--repository-url`
+
+The Git repository URL.
+
+##### remoteName
+
+Type: `string`  
+Default: `"origin"`  
+CLI arguments: `--remote-name`
+
+The remote repository name.
+
+##### debug
+
+Type: `boolean`  
+Default: `false`  
+CLI arguments: `--debug`
+
+Output debugging information.
+
+##### dryRun
+
+Type: `boolean`  
+Default: `false`  
+CLI arguments: `-d`, `--dry-run`
+
+The goal of the dry-run mode is to get a preview of the pending release. The dry-run mode skips the release and the publication steps but checks the repository push permissions.
+
+##### releaseType
+
+Type: `object`  
+Default:
+```
+{
+  alpha: {
+    channel: "alpha",
+    prerelease: true,
+    prereleaseIdentifier: "alpha"
+  },
+  beta: {
+    channel: "beta",
+    prerelease: true,
+    prereleaseIdentifier: "beta"
+  },
+  main: {
+    channel: "default"
+  },
+  master: {
+    channel: "default"
+  },
+  next: {
+    channel: "next",
+    prerelease: true,
+    prereleaseIdentifier: "rc"
+  }
+}
+```
+
+Sets an object whose properties are the names of the branches on which the releases should happen. Each branch property is an object with the following properties (all of them are optional):
+- `channel`: the distribution tag associated with the releases when publishing to NPM, which will use the default distribution tag (`"latest"`) if the value is `"default"`, the value provided otherwise;
+- `prerelease`: `true` if the release should be treated like a pre-release (e.g.: for unstable versions), `false` otherwise;
+- `prereleaseIdentifier`: the identifier to use when tagging a pre-release version (for example, `"beta"` if the pre-release should be tagged as something like `2.0.0-beta.1`).
+
+##### dependencyUpdateMethod
+
+Type: `string` or `null`  
+Default: `"pin"` if it is a monorepo, `null` otherwise
+
+This optional option sets a string telling how dependencies in each `package.json` file of the monorepo should be updated as far as the monorepo packages are concerned. Its value can be one of the following:
+- `"pin"`: the dependencies will be updated using their exact new version (e.g.: `"@my-monorepo/my-package": "1.2.3"`);
+- `"caret-range"`: the dependencies will be updated using their new version within a caret range (e.g.: `"@my-monorepo/my-package": "^1.2.3"`);
+- `"tilde-range"`: the dependencies will be updated using their new version within a tilde range (e.g.: `"@my-monorepo/my-package": "~1.2.3"`);
+- `"workspace"`: the dependencies will be updated using the `workspace` keyword (e.g.: `"@my-monorepo/my-package": "workspace:*"`).
+
+If the repository is not a monorepo, the option is ignored.
+
+##### npmPublish
+
+Type: `false`  
+Default: see below
+
+This optional option, when set, can only be `false`. When this option is set, no packages are published to the NPM registry at all; however, the next release is still released and the `package.json` files are still updated. When the option is not set, the publication of each package depends on whether the `private` property in the `package.json` files is set to `true` or not.
+
+## Get help
+
+- [Stack Overflow](https://stackoverflow.com/questions/tagged/release-change)
+
+## Copyright & licence
+
+© 2025-present Victor Brito — Released under the [MIT licence](./LICENSE).

package/bin/index.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { checkRequirements } from "../dist/index.js";
+
+checkRequirements();

package/configuration-schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Configuration",
+  "description": "The configuration which is contained inside the `release-change.config.json` file",
+  "type": "object",
+  "properties": {
+    "$schema": "string",
+    "branches": {
+      "description": "The branches on which releases should happen",
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "minItems": 1
+    },
+    "repositoryUrl": {
+      "description": "The Git repository URL",
+      "type": "string"
+    },
+    "remoteName": {
+      "description": "The remote repository name",
+      "type": "string"
+    },
+    "debug": {
+      "description": "Output debugging information",
+      "type": "boolean"
+    },
+    "dryRun": {
+      "description": "Whether to activate the dry-run mode or not",
+      "type": "boolean"
+    },
+    "releaseType": {
+      "description": "The release type configuration on the branches on which the releases should happen",
+      "type": "object",
+      "patternProperties": {
+        "description": "The name of the branch used as a property key",
+        "\\S+": {
+          "type": "object",
+          "properties": {
+            "channel": {
+              "description": "The distribution tag associated with the releases when publishing to NPM",
+              "type": "string"
+            },
+            "prerelease": {
+              "description": "Whether the release should be treated like a pre-release or not",
+              "type": "boolean"
+            },
+            "prereleaseIdentifier": {
+              "description": "The identifier to use when tagging a pre-release version",
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "dependencyUpdateMethod": {
+      "description": "The method to use to update internal dependencies in a monorepo",
+      "enum": ["pin", "caret-range", "tilde-range", "workspace", null]
+    },
+    "npmPublish": {
+      "description": "To prevent package publishing to NPM",
+      "const": false
+    }
+  },
+  "additionalProperties": false
+}

package/dist/check-requirements.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Checks whether Node and Git versions match the versions required.
+ */
+export declare const checkRequirements: () => Promise<void>;
+//# sourceMappingURL=check-requirements.d.ts.map

package/dist/check-requirements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-requirements.d.ts","sourceRoot":"","sources":["../src/check-requirements.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,IAAI,CAuBtD,CAAC"}

package/dist/check-requirements.js

@@ -0,0 +1,32 @@
+import process from "node:process";
+import { setLogger } from "@release-change/logger";
+import { coerce } from "@release-change/semver";
+import { runCommandSync } from "@release-change/shared";
+import { cli } from "./cli.js";
+import { isGitVersionCompatible } from "./is-git-version-compatible.js";
+import { isNodeVersionCompatible } from "./is-node-version-compatible.js";
+import { GIT_MIN_VERSION, REQUIRED_NODE_VERSIONS } from "./constants.js";
+/**
+ * Checks whether Node and Git versions match the versions required.
+ */
+export const checkRequirements = async () => {
+    const logger = setLogger();
+    logger.setScope("cli");
+    const { version } = process;
+    if (!isNodeVersionCompatible(version.replace("v", ""), REQUIRED_NODE_VERSIONS)) {
+        const formattedRequiredNodeVersions = new Intl.ListFormat("en-GB", {
+            style: "long",
+            type: "disjunction"
+        }).format(REQUIRED_NODE_VERSIONS.replaceAll(/\^([.0-9]+)/gi, "$1+").split(" || "));
+        const foundVersion = version.replace("v", "");
+        logger.logError(`Required one of the following Node versions: ${formattedRequiredNodeVersions}. Found ${foundVersion}.`);
+        process.exit(1);
+    }
+    const gitVersion = coerce(runCommandSync("git", ["--version"]).stdout);
+    if (!gitVersion || !isGitVersionCompatible(gitVersion.version)) {
+        logger.logError(`Git version ${GIT_MIN_VERSION} required. Found ${gitVersion?.version ?? null}.`);
+        process.exit(1);
+    }
+    process.exitCode = await cli();
+};
+//# sourceMappingURL=check-requirements.js.map

package/dist/check-requirements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-requirements.js","sourceRoot":"","sources":["../src/check-requirements.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAEzE;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,IAAmB,EAAE;IACzD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvB,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC5B,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,sBAAsB,CAAC,EAAE,CAAC;QAC/E,MAAM,6BAA6B,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE;YACjE,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,aAAa;SACpB,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC,UAAU,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACnF,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,QAAQ,CACb,gDAAgD,6BAA6B,WAAW,YAAY,GAAG,CACxG,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACvE,IAAI,CAAC,UAAU,IAAI,CAAC,sBAAsB,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/D,MAAM,CAAC,QAAQ,CACb,eAAe,eAAe,oBAAoB,UAAU,EAAE,OAAO,IAAI,IAAI,GAAG,CACjF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,QAAQ,GAAG,MAAM,GAAG,EAAE,CAAC;AACjC,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Runs the CLI
+ * @return The exit code.
+ */
+export declare const cli: () => Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,eAAO,MAAM,GAAG,QAAa,OAAO,CAAC,MAAM,CAqB1C,CAAC"}

package/dist/cli.js

@@ -0,0 +1,32 @@
+import process from "node:process";
+import { parseCliOptions } from "./parse-cli-options.js";
+import { run } from "./run.js";
+import { showHelp } from "./show-help.js";
+import { showVersion } from "./show-version.js";
+/**
+ * Runs the CLI
+ * @return The exit code.
+ */
+export const cli = async () => {
+    const { argv, cwd, env } = process;
+    const args = argv.slice(2);
+    const parsedCliOptions = parseCliOptions(args);
+    const { help, version, ...cliOptions } = parsedCliOptions;
+    const context = {
+        cwd: cwd(),
+        env,
+        config: { debug: Boolean(cliOptions.debug) },
+        errors: []
+    };
+    if (help) {
+        showHelp();
+        return 0;
+    }
+    if (version) {
+        showVersion();
+        return 0;
+    }
+    await run(cliOptions, context);
+    return Number(process.exitCode ?? 0);
+};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAGA,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,IAAqB,EAAE;IAC7C,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAS,CAAC;IACnC,MAAM,gBAAgB,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,UAAU,EAAE,GAAG,gBAAgB,CAAC;IAC1D,MAAM,OAAO,GAAgB;QAC3B,GAAG,EAAE,GAAG,EAAE;QACV,GAAG;QACH,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE;QAC5C,MAAM,EAAE,EAAE;KACX,CAAC;IACF,IAAI,IAAI,EAAE,CAAC;QACT,QAAQ,EAAE,CAAC;QACX,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,WAAW,EAAE,CAAC;QACd,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC,CAAC"}

package/dist/cli.types.d.ts

@@ -0,0 +1,8 @@
+declare const letters: readonly ["a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v", "w", "x", "y", "z"];
+type Letter = (typeof letters)[number];
+type Alias = `-${Lowercase<Letter> | Uppercase<Letter>}`;
+type Flag = `--${string}`;
+export type CliOptionCommand = Alias | Flag;
+export type Args = (Alias | Flag | string)[];
+export {};
+//# sourceMappingURL=cli.types.d.ts.map

package/dist/cli.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.types.d.ts","sourceRoot":"","sources":["../src/cli.types.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,OAAO,6IA2BH,CAAC;AACX,KAAK,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AACvC,KAAK,KAAK,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;AACzD,KAAK,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;AAC1B,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,IAAI,CAAC;AAC5C,MAAM,MAAM,IAAI,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC"}

package/dist/cli.types.js

@@ -0,0 +1,30 @@
+const letters = [
+    "a",
+    "b",
+    "c",
+    "d",
+    "e",
+    "f",
+    "g",
+    "h",
+    "i",
+    "j",
+    "k",
+    "l",
+    "m",
+    "n",
+    "o",
+    "p",
+    "q",
+    "r",
+    "s",
+    "t",
+    "u",
+    "v",
+    "w",
+    "x",
+    "y",
+    "z"
+];
+export {};
+//# sourceMappingURL=cli.types.js.map

package/dist/cli.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.types.js","sourceRoot":"","sources":["../src/cli.types.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,GAAG;IACd,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;CACK,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,53 @@
+export declare const REQUIRED_NODE_VERSIONS: string;
+export declare const GIT_MIN_VERSION = "2.48.1";
+export declare const TAB: string;
+export declare const AVAILABLE_CLI_OPTIONS: {
+    readonly branches: {
+        readonly cliOptionName: "branches";
+        readonly flag: "--branches";
+        readonly alias: "-b";
+        readonly description: "Git branches to release from";
+        readonly type: "array";
+    };
+    readonly repositoryUrl: {
+        readonly cliOptionName: "repositoryUrl";
+        readonly flag: "--repository-url";
+        readonly alias: "-r";
+        readonly description: "Git repository URL";
+        readonly type: "string";
+    };
+    readonly remoteName: {
+        readonly cliOptionName: "remoteName";
+        readonly flag: "--remote-name";
+        readonly description: "Remote Git repository name";
+        readonly type: "string";
+    };
+    readonly debug: {
+        readonly cliOptionName: "debug";
+        readonly flag: "--debug";
+        readonly description: "Output debugging information";
+        readonly type: "boolean";
+    };
+    readonly dryRun: {
+        readonly cliOptionName: "dryRun";
+        readonly flag: "--dry-run";
+        readonly alias: "-d";
+        readonly description: "Skip release and publishing";
+        readonly type: "boolean";
+    };
+    readonly version: {
+        readonly cliOptionName: "version";
+        readonly flag: "--version";
+        readonly alias: "-v";
+        readonly description: "Show version number";
+        readonly type: "boolean";
+    };
+    readonly help: {
+        readonly cliOptionName: "help";
+        readonly flag: "--help";
+        readonly alias: "-h";
+        readonly description: "Show help";
+        readonly type: "boolean";
+    };
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,sBAAsB,QAAqC,CAAC;AACzE,eAAO,MAAM,eAAe,WAAW,CAAC;AACxC,eAAO,MAAM,GAAG,QAAgB,CAAC;AACjC,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDxB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,54 @@
+import { ROOT_PACKAGE_MANIFEST } from "@release-change/shared";
+export const REQUIRED_NODE_VERSIONS = ROOT_PACKAGE_MANIFEST.engines.node;
+export const GIT_MIN_VERSION = "2.48.1";
+export const TAB = " ".repeat(2);
+export const AVAILABLE_CLI_OPTIONS = {
+    branches: {
+        cliOptionName: "branches",
+        flag: "--branches",
+        alias: "-b",
+        description: "Git branches to release from",
+        type: "array"
+    },
+    repositoryUrl: {
+        cliOptionName: "repositoryUrl",
+        flag: "--repository-url",
+        alias: "-r",
+        description: "Git repository URL",
+        type: "string"
+    },
+    remoteName: {
+        cliOptionName: "remoteName",
+        flag: "--remote-name",
+        description: "Remote Git repository name",
+        type: "string"
+    },
+    debug: {
+        cliOptionName: "debug",
+        flag: "--debug",
+        description: "Output debugging information",
+        type: "boolean"
+    },
+    dryRun: {
+        cliOptionName: "dryRun",
+        flag: "--dry-run",
+        alias: "-d",
+        description: "Skip release and publishing",
+        type: "boolean"
+    },
+    version: {
+        cliOptionName: "version",
+        flag: "--version",
+        alias: "-v",
+        description: "Show version number",
+        type: "boolean"
+    },
+    help: {
+        cliOptionName: "help",
+        flag: "--help",
+        alias: "-h",
+        description: "Show help",
+        type: "boolean"
+    }
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC;AACzE,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC;AACxC,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACjC,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ,EAAE;QACR,aAAa,EAAE,UAAU;QACzB,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,8BAA8B;QAC3C,IAAI,EAAE,OAAO;KACd;IACD,aAAa,EAAE;QACb,aAAa,EAAE,eAAe;QAC9B,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,oBAAoB;QACjC,IAAI,EAAE,QAAQ;KACf;IACD,UAAU,EAAE;QACV,aAAa,EAAE,YAAY;QAC3B,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,4BAA4B;QACzC,IAAI,EAAE,QAAQ;KACf;IACD,KAAK,EAAE;QACL,aAAa,EAAE,OAAO;QACtB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,8BAA8B;QAC3C,IAAI,EAAE,SAAS;KAChB;IACD,MAAM,EAAE;QACN,aAAa,EAAE,QAAQ;QACvB,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,6BAA6B;QAC1C,IAAI,EAAE,SAAS;KAChB;IACD,OAAO,EAAE;QACP,aAAa,EAAE,SAAS;QACxB,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,qBAAqB;QAClC,IAAI,EAAE,SAAS;KAChB;IACD,IAAI,EAAE;QACJ,aAAa,EAAE,MAAM;QACrB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,WAAW;QACxB,IAAI,EAAE,SAAS;KAChB;CACO,CAAC"}

package/dist/display-cli-options.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Displays the CLI options when running the CLI with the `--help` or `-h` options.
+ * @return The CLI options, with their alias (if available), flag, description and type.
+ */
+export declare const displayCliOptions: () => string;
+//# sourceMappingURL=display-cli-options.d.ts.map

package/dist/display-cli-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-cli-options.d.ts","sourceRoot":"","sources":["../src/display-cli-options.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAO,MAwBpC,CAAC"}

package/dist/display-cli-options.js

@@ -0,0 +1,24 @@
+import { AVAILABLE_CLI_OPTIONS, TAB } from "./constants.js";
+/**
+ * Displays the CLI options when running the CLI with the `--help` or `-h` options.
+ * @return The CLI options, with their alias (if available), flag, description and type.
+ */
+export const displayCliOptions = () => {
+    const availableCliOptionsValues = Object.values(AVAILABLE_CLI_OPTIONS);
+    const aliasMaxLength = Math.max(...availableCliOptionsValues.map(cliOption => "alias" in cliOption && cliOption.alias ? cliOption.alias.length : 0));
+    const flagMaxLength = Math.max(...availableCliOptionsValues.map(option => option.flag.length));
+    const descriptionMaxLength = Math.max(...availableCliOptionsValues.map(cliOption => cliOption.description.length));
+    const typeMaxLength = Math.max(...availableCliOptionsValues.map(option => option.type.length)) + 2;
+    const header = "Options";
+    const cliOptions = [];
+    for (const cliOption of availableCliOptionsValues) {
+        const alias = "alias" in cliOption ? `${cliOption.alias}, ` : " ".repeat(aliasMaxLength + 2);
+        const cliOptionName = `${TAB}${alias}${cliOption.flag.padEnd(flagMaxLength, " ")}`;
+        const description = `${cliOption.description.padEnd(descriptionMaxLength, " ")}`;
+        const type = `[${cliOption.type}]`.padStart(typeMaxLength, " ");
+        const cliOptionElements = [cliOptionName, description, type];
+        cliOptions.push(cliOptionElements.join(TAB));
+    }
+    return `${header}\n${cliOptions.join("\n")}`;
+};
+//# sourceMappingURL=display-cli-options.js.map

package/dist/display-cli-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-cli-options.js","sourceRoot":"","sources":["../src/display-cli-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAE5D;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAW,EAAE;IAC5C,MAAM,yBAAyB,GAAG,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACvE,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAC7B,GAAG,yBAAyB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAC3C,OAAO,IAAI,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CACrE,CACF,CAAC;IACF,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,yBAAyB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/F,MAAM,oBAAoB,GAAG,IAAI,CAAC,GAAG,CACnC,GAAG,yBAAyB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAC5E,CAAC;IACF,MAAM,aAAa,GACjB,IAAI,CAAC,GAAG,CAAC,GAAG,yBAAyB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;IAC/E,MAAM,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,SAAS,IAAI,yBAAyB,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,OAAO,IAAI,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;QAC7F,MAAM,aAAa,GAAG,GAAG,GAAG,GAAG,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,EAAE,CAAC;QACnF,MAAM,WAAW,GAAG,GAAG,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,oBAAoB,EAAE,GAAG,CAAC,EAAE,CAAC;QACjF,MAAM,IAAI,GAAG,IAAI,SAAS,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QAChE,MAAM,iBAAiB,GAAG,CAAC,aAAa,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;QAC7D,UAAU,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,GAAG,MAAM,KAAK,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC/C,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { checkRequirements } from "./check-requirements.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { checkRequirements } from "./check-requirements.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/is-git-version-compatible.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Checks whether the version of Git installed matches the minimal version required.
+ * @param gitVersion - The Git version installed.
+ * @return `true` if the version installed matches the minimal version required, `false` otherwise.
+ */
+export declare const isGitVersionCompatible: (gitVersion: string) => boolean;
+//# sourceMappingURL=is-git-version-compatible.d.ts.map

package/dist/is-git-version-compatible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-git-version-compatible.d.ts","sourceRoot":"","sources":["../src/is-git-version-compatible.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,YAAY,MAAM,KAAG,OAE3D,CAAC"}

package/dist/is-git-version-compatible.js

@@ -0,0 +1,11 @@
+import { gte } from "@release-change/semver";
+import { GIT_MIN_VERSION } from "./constants.js";
+/**
+ * Checks whether the version of Git installed matches the minimal version required.
+ * @param gitVersion - The Git version installed.
+ * @return `true` if the version installed matches the minimal version required, `false` otherwise.
+ */
+export const isGitVersionCompatible = (gitVersion) => {
+    return gte(gitVersion, GIT_MIN_VERSION);
+};
+//# sourceMappingURL=is-git-version-compatible.js.map

package/dist/is-git-version-compatible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-git-version-compatible.js","sourceRoot":"","sources":["../src/is-git-version-compatible.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,UAAkB,EAAW,EAAE;IACpE,OAAO,GAAG,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;AAC1C,CAAC,CAAC"}

package/dist/is-node-version-compatible.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Checks whether the version of Node installed matches the versions required by `engines.node` in root `package.json`.
+ * @param nodeVersion - The Node version installed.
+ * @param nodeVersionsRequired - The versions required by `engines.node` in root `package.json`.
+ * @return `true` if the version installed matches the versions required, `false` otherwise.
+ */
+export declare const isNodeVersionCompatible: (nodeVersion: string, nodeVersionsRequired: string) => boolean;
+//# sourceMappingURL=is-node-version-compatible.d.ts.map

package/dist/is-node-version-compatible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-node-version-compatible.d.ts","sourceRoot":"","sources":["../src/is-node-version-compatible.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,aAAa,MAAM,EACnB,sBAAsB,MAAM,KAC3B,OAEF,CAAC"}

package/dist/is-node-version-compatible.js

@@ -0,0 +1,11 @@
+import { satisfies } from "@release-change/semver";
+/**
+ * Checks whether the version of Node installed matches the versions required by `engines.node` in root `package.json`.
+ * @param nodeVersion - The Node version installed.
+ * @param nodeVersionsRequired - The versions required by `engines.node` in root `package.json`.
+ * @return `true` if the version installed matches the versions required, `false` otherwise.
+ */
+export const isNodeVersionCompatible = (nodeVersion, nodeVersionsRequired) => {
+    return satisfies(nodeVersion, nodeVersionsRequired);
+};
+//# sourceMappingURL=is-node-version-compatible.js.map

package/dist/is-node-version-compatible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-node-version-compatible.js","sourceRoot":"","sources":["../src/is-node-version-compatible.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,WAAmB,EACnB,oBAA4B,EACnB,EAAE;IACX,OAAO,SAAS,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;AACtD,CAAC,CAAC"}

package/dist/parse-cli-options.d.ts

@@ -0,0 +1,9 @@
+import type { ParsedCliOptions } from "@release-change/shared";
+import type { Args } from "./cli.types.js";
+/**
+ * Parses the CLI options run from the CLI.
+ * @param args - The arguments from the process.
+ * @return The CLI options as defined by `AVAILABLE_CLI_OPTIONS`.
+ */
+export declare const parseCliOptions: (args: Args) => ParsedCliOptions;
+//# sourceMappingURL=parse-cli-options.d.ts.map

package/dist/parse-cli-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-cli-options.d.ts","sourceRoot":"","sources":["../src/parse-cli-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,IAAI,EAAoB,MAAM,gBAAgB,CAAC;AAI7D;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,IAAI,KAAG,gBAiD5C,CAAC"}

package/dist/parse-cli-options.js

@@ -0,0 +1,54 @@
+import { AVAILABLE_CLI_OPTIONS } from "./constants.js";
+/**
+ * Parses the CLI options run from the CLI.
+ * @param args - The arguments from the process.
+ * @return The CLI options as defined by `AVAILABLE_CLI_OPTIONS`.
+ */
+export const parseCliOptions = (args) => {
+    const allowedCliOptions = Object.values(AVAILABLE_CLI_OPTIONS).reduce((acc, cliOption) => {
+        acc[cliOption.flag] =
+            cliOption;
+        if ("alias" in cliOption && cliOption.alias) {
+            acc[cliOption.alias] =
+                cliOption;
+        }
+        return acc;
+    }, {});
+    const parsedCliOptions = {};
+    let currentCliOption = null;
+    for (const arg of args) {
+        if (arg.startsWith("-")) {
+            if (!(arg in allowedCliOptions))
+                continue;
+            const allowedCliOption = allowedCliOptions[arg];
+            if (allowedCliOption) {
+                const { cliOptionName, type } = allowedCliOption;
+                currentCliOption = cliOptionName;
+                switch (type) {
+                    case "array":
+                        Object.assign(parsedCliOptions, { [currentCliOption]: [] });
+                        break;
+                    case "string":
+                        Object.assign(parsedCliOptions, { [currentCliOption]: "" });
+                        break;
+                    default:
+                        Object.assign(parsedCliOptions, { [currentCliOption]: true });
+                        break;
+                }
+            }
+        }
+        else {
+            if (currentCliOption && currentCliOption in parsedCliOptions) {
+                const parsedCliOption = parsedCliOptions[currentCliOption];
+                if (typeof parsedCliOption !== "undefined") {
+                    if (Array.isArray(parsedCliOption))
+                        parsedCliOption.push(arg);
+                    else if (typeof parsedCliOption === "string")
+                        Object.assign(parsedCliOptions, { [currentCliOption]: arg });
+                }
+            }
+        }
+    }
+    return parsedCliOptions;
+};
+//# sourceMappingURL=parse-cli-options.js.map

package/dist/parse-cli-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-cli-options.js","sourceRoot":"","sources":["../src/parse-cli-options.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAU,EAAoB,EAAE;IAC9D,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,MAAM,CACnE,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE;QACjB,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;YACjB,SAA+E,CAAC;QAClF,IAAI,OAAO,IAAI,SAAS,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YAC5C,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC;gBAClB,SAA+E,CAAC;QACpF,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,EACD,EAGC,CACF,CAAC;IACF,MAAM,gBAAgB,GAAqB,EAAE,CAAC;IAC9C,IAAI,gBAAgB,GAA8C,IAAI,CAAC;IACvE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,GAAG,IAAI,iBAAiB,CAAC;gBAAE,SAAS;YAC1C,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,GAAuB,CAAC,CAAC;YACpE,IAAI,gBAAgB,EAAE,CAAC;gBACrB,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC;gBACjD,gBAAgB,GAAG,aAAa,CAAC;gBACjC,QAAQ,IAAI,EAAE,CAAC;oBACb,KAAK,OAAO;wBACV,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;wBAC5D,MAAM;oBACR,KAAK,QAAQ;wBACX,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;wBAC5D,MAAM;oBACR;wBACE,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;wBAC9D,MAAM;gBACV,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,gBAAgB,IAAI,gBAAgB,IAAI,gBAAgB,EAAE,CAAC;gBAC7D,MAAM,eAAe,GAAG,gBAAgB,CAAC,gBAA0C,CAAC,CAAC;gBACrF,IAAI,OAAO,eAAe,KAAK,WAAW,EAAE,CAAC;oBAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC;wBAAE,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;yBACzD,IAAI,OAAO,eAAe,KAAK,QAAQ;wBAC1C,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC,CAAC"}

package/dist/run.d.ts

@@ -0,0 +1,8 @@
+import type { CliOptions, ContextBase } from "@release-change/shared";
+/**
+ * Runs the CLI.
+ * @param cliOptions - The CLI options.
+ * @param contextBase - The already known context where the CLI is running.
+ */
+export declare const run: (cliOptions: CliOptions, contextBase: ContextBase) => Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAW,WAAW,EAAE,MAAM,wBAAwB,CAAC;AA0B/E;;;;GAIG;AACH,eAAO,MAAM,GAAG,GAAU,YAAY,UAAU,EAAE,aAAa,WAAW,KAAG,OAAO,CAAC,IAAI,CAmExF,CAAC"}

package/dist/run.js

@@ -0,0 +1,84 @@
+import { configureCiEnvironment, isUsableCiEnvironment } from "@release-change/ci";
+import { getReleaseType } from "@release-change/commit-analyser";
+import { debugConfig, getConfig } from "@release-change/config";
+import { getPackages, isMonorepo } from "@release-change/get-packages";
+import { COMMITTER_EMAIL, COMMITTER_NAME, checkBranch, checkPushPermissions, checkRepository, getBranchName, getCommitsSinceRef } from "@release-change/git";
+import { closeIssue, getRelatedPullRequestsAndIssues, postFailComment, postSuccessComment, tagPullRequestAndIssue } from "@release-change/github";
+import { addErrorToContext, checkErrorType, setLogger } from "@release-change/logger";
+import { publish, setLastRelease, setNextRelease } from "@release-change/release";
+import { WORKSPACE_NAME, WORKSPACE_VERSION } from "@release-change/shared";
+/**
+ * Runs the CLI.
+ * @param cliOptions - The CLI options.
+ * @param contextBase - The already known context where the CLI is running.
+ */
+export const run = async (cliOptions, contextBase) => {
+    const logger = setLogger(contextBase.config.debug);
+    logger.setScope("cli");
+    logger.logInfo(`Running ${WORKSPACE_NAME} version ${WORKSPACE_VERSION}…`);
+    const packages = await getPackages(contextBase);
+    const config = await getConfig(cliOptions, isMonorepo(packages));
+    const branch = getBranchName(contextBase, logger);
+    const ci = configureCiEnvironment(contextBase.env);
+    const context = {
+        ...contextBase,
+        branch,
+        config,
+        ci,
+        packages,
+        releaseInfos: []
+    };
+    await checkRepository(context, logger);
+    if (isUsableCiEnvironment(context)) {
+        Object.assign(context.env, {
+            GIT_AUTHOR_NAME: COMMITTER_NAME,
+            GIT_AUTHOR_EMAIL: COMMITTER_EMAIL,
+            GIT_COMMITTER_NAME: COMMITTER_NAME,
+            GIT_COMMITTER_EMAIL: COMMITTER_EMAIL
+        });
+        debugConfig(context);
+        checkBranch(context);
+        await checkPushPermissions(context.config.repositoryUrl, context);
+        setLastRelease(context);
+        const commits = getCommitsSinceRef(context);
+        context.commits = commits;
+        const releaseType = getReleaseType(commits, context);
+        setNextRelease(releaseType, context);
+        if (context.nextRelease) {
+            const { debug, dryRun } = context.config;
+            if (debug) {
+                logger.setDebugScope("cli:run");
+                logger.logDebug(`Dry-run mode enabled: ${dryRun}`);
+            }
+            if (dryRun) {
+                logger.logWarn("The dry-run mode is enabled; therefore, the release will not be published.");
+            }
+            else {
+                await getRelatedPullRequestsAndIssues(commits, context);
+                const { references } = context;
+                try {
+                    await publish(context);
+                    if (references) {
+                        for (const reference of references) {
+                            const { number, isPullRequest } = reference;
+                            await postSuccessComment(reference, context);
+                            if (!isPullRequest)
+                                await closeIssue(number, context);
+                            await tagPullRequestAndIssue(reference, context);
+                        }
+                    }
+                }
+                catch (error) {
+                    logger.logError(checkErrorType(error));
+                    addErrorToContext(error, context);
+                    if (references) {
+                        for (const reference of references) {
+                            await postFailComment(reference, context);
+                        }
+                    }
+                }
+            }
+        }
+    }
+};
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"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"}

package/dist/show-help.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Shows the help for the `release-change` command.
+ */
+export declare const showHelp: () => void;
+//# sourceMappingURL=show-help.d.ts.map

package/dist/show-help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show-help.d.ts","sourceRoot":"","sources":["../src/show-help.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,eAAO,MAAM,QAAQ,QAAO,IAO3B,CAAC"}

package/dist/show-help.js

@@ -0,0 +1,16 @@
+import { setLogger } from "@release-change/logger";
+import { WORKSPACE_NAME } from "@release-change/shared";
+import { displayCliOptions } from "./display-cli-options.js";
+import { TAB } from "./constants.js";
+/**
+ * Shows the help for the `release-change` command.
+ */
+export const showHelp = () => {
+    const logger = setLogger();
+    const intro = "Runs automated package release and publishing";
+    const usage = `Usage:\n${TAB}${WORKSPACE_NAME} [options]`;
+    const cliOptions = displayCliOptions();
+    const output = [intro, usage, cliOptions].join("\n".repeat(2));
+    logger.logWithoutFormatting(output);
+};
+//# sourceMappingURL=show-help.js.map

package/dist/show-help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show-help.js","sourceRoot":"","sources":["../src/show-help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAErC;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAS,EAAE;IACjC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,+CAA+C,CAAC;IAC9D,MAAM,KAAK,GAAG,WAAW,GAAG,GAAG,cAAc,YAAY,CAAC;IAC1D,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC,CAAC"}

package/dist/show-version.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Shows the current version of `release-change`.
+ */
+export declare const showVersion: () => void;
+//# sourceMappingURL=show-version.d.ts.map

package/dist/show-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show-version.d.ts","sourceRoot":"","sources":["../src/show-version.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,WAAW,QAAO,IAG9B,CAAC"}

package/dist/show-version.js

@@ -0,0 +1,10 @@
+import { setLogger } from "@release-change/logger";
+import { WORKSPACE_VERSION } from "@release-change/shared";
+/**
+ * Shows the current version of `release-change`.
+ */
+export const showVersion = () => {
+    const logger = setLogger();
+    logger.logWithoutFormatting(`v${WORKSPACE_VERSION}`);
+};
+//# sourceMappingURL=show-version.js.map

package/dist/show-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show-version.js","sourceRoot":"","sources":["../src/show-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAS,EAAE;IACpC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,CAAC,oBAAoB,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;AACvD,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@release-change/cli",
+  "version": "0.1.0",
+  "description": "Fully automated version management, changelog management and package publishing with a focus on monorepos, pre-releases and major version zero",
+  "keywords": [
+    "automation",
+    "changelog",
+    "cli",
+    "major-version-zero",
+    "monorepo",
+    "package",
+    "pre-release",
+    "publish",
+    "release",
+    "release-automation",
+    "release-workflow",
+    "semantic",
+    "semantic-version",
+    "semver",
+    "semver-release",
+    "tags",
+    "version",
+    "versioning"
+  ],
+  "homepage": "https://github.com/release-change/release-change",
+  "bugs": {
+    "url": "https://github.com/release-change/release-change/issues"
+  },
+  "author": "Victor Brito (https://victor-brito.dev)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/release-change/release-change.git"
+  },
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "configuration-schema.json",
+    "dist"
+  ],
+  "exports": {
+    "import": "./dist/index.js",
+    "types": "./dist/index.d.ts"
+  },
+  "bin": {
+    "release-change": "./bin/index.js"
+  },
+  "engines": {
+    "node": "^20.18.3 || ^22.12.0 || ^24.0.0",
+    "npm": ">=10.8.2",
+    "pnpm": ">=10.28.0"
+  },
+  "dependencies": {
+    "@release-change/ci": "0.1.0",
+    "@release-change/commit-analyser": "0.1.0",
+    "@release-change/config": "0.1.0",
+    "@release-change/git": "0.1.0",
+    "@release-change/get-packages": "0.1.0",
+    "@release-change/github": "0.1.0",
+    "@release-change/logger": "0.1.0",
+    "@release-change/semver": "0.1.0",
+    "@release-change/shared": "0.1.0",
+    "@release-change/release": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch --preserveWatchOutput & vitest",
+    "release-change": "./bin/index.js"
+  }
+}