@ohos-ports/nx 23.2.1-beta.0 → 23.3.0-beta.0

package/dist/src/command-line/release/changelog.js

@@ -0,0 +1,907 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.releaseChangelogCLIHandler = void 0;
+exports.isChangelogEffectivelyEnabled = isChangelogEffectivelyEnabled;
+exports.createAPI = createAPI;
+const tslib_1 = require("tslib");
+const pc = tslib_1.__importStar(require("picocolors"));
+const prompt_helpers_1 = require("../../utils/prompt-helpers");
+const node_fs_1 = require("node:fs");
+const semver_1 = require("semver");
+const tmp_1 = require("tmp");
+const nx_json_1 = require("../../config/nx-json");
+const tree_1 = require("../../generators/tree");
+const file_map_utils_1 = require("../../project-graph/file-map-utils");
+const project_graph_1 = require("../../project-graph/project-graph");
+const utils_1 = require("../../tasks-runner/utils");
+const handle_errors_1 = require("../../utils/handle-errors");
+const is_ci_1 = require("../../utils/is-ci");
+const output_1 = require("../../utils/output");
+const path_1 = require("../../utils/path");
+const workspace_root_1 = require("../../utils/workspace-root");
+const commit_utils_1 = require("./changelog/commit-utils");
+const version_plan_filtering_1 = require("./changelog/version-plan-filtering");
+const version_plan_utils_1 = require("./changelog/version-plan-utils");
+const config_1 = require("./config/config");
+const deep_merge_json_1 = require("./config/deep-merge-json");
+const version_plans_1 = require("./config/version-plans");
+const git_1 = require("./utils/git");
+const launch_editor_1 = require("./utils/launch-editor");
+const markdown_1 = require("./utils/markdown");
+const print_changes_1 = require("./utils/print-changes");
+const print_config_1 = require("./utils/print-config");
+const release_graph_1 = require("./utils/release-graph");
+const remote_release_client_1 = require("./utils/remote-release-clients/remote-release-client");
+const resolve_changelog_renderer_1 = require("./utils/resolve-changelog-renderer");
+const resolve_nx_json_error_message_1 = require("./utils/resolve-nx-json-error-message");
+const shared_1 = require("./utils/shared");
+const version_plan_utils_2 = require("./utils/version-plan-utils");
+/**
+ * Determines whether a changelog configuration will actually produce any output.
+ * A changelog config is effectively enabled when it would produce a changelog file
+ * or create a remote release.
+ */
+function isChangelogEffectivelyEnabled(config) {
+    if (!config) {
+        return false;
+    }
+    return config.file !== false || config.createRelease !== false;
+}
+const releaseChangelogCLIHandler = (args) => (0, handle_errors_1.handleErrors)(args.verbose, () => createAPI({}, false)(args));
+exports.releaseChangelogCLIHandler = releaseChangelogCLIHandler;
+function createAPI(overrideReleaseConfig, ignoreNxJsonConfig) {
+    /**
+     * NOTE: This function is also exported for programmatic usage and forms part of the public API
+     * of Nx. We intentionally do not wrap the implementation with handleErrors because users need
+     * to have control over their own error handling when using the API.
+     */
+    return async function releaseChangelog(args) {
+        const projectGraph = await (0, project_graph_1.createProjectGraphAsync)({ exitOnError: true });
+        const overriddenConfig = overrideReleaseConfig ?? {};
+        const userProvidedReleaseConfig = ignoreNxJsonConfig
+            ? overriddenConfig
+            : (0, deep_merge_json_1.deepMergeJson)((0, nx_json_1.readNxJson)().release ?? {}, overriddenConfig);
+        // Apply default configuration to any optional user configuration
+        const { error: configError, nxReleaseConfig } = await (0, config_1.createNxReleaseConfig)(projectGraph, await (0, file_map_utils_1.createProjectFileMapUsingProjectGraph)(projectGraph), userProvidedReleaseConfig);
+        if (configError) {
+            return await (0, config_1.handleNxReleaseConfigError)(configError);
+        }
+        // --print-config exits directly as it is not designed to be combined with any other programmatic operations
+        if (args.printConfig) {
+            return (0, print_config_1.printConfigAndExit)({
+                userProvidedReleaseConfig,
+                nxReleaseConfig,
+                isDebug: args.printConfig === 'debug',
+            });
+        }
+        // The nx release top level command will always override these three git args. This is how we can tell
+        // if the top level release command was used or if the user is using the changelog subcommand.
+        // If the user explicitly overrides these args, then it doesn't matter if the top level config is set,
+        // as all of the git options would be overridden anyway.
+        if ((args.gitCommit === undefined ||
+            args.gitTag === undefined ||
+            args.stageChanges === undefined) &&
+            userProvidedReleaseConfig.git) {
+            const nxJsonMessage = await (0, resolve_nx_json_error_message_1.resolveNxJsonConfigErrorMessage)([
+                'release',
+                'git',
+            ]);
+            output_1.output.error({
+                title: `The "release.git" property in nx.json may not be used with the "nx release changelog" subcommand or programmatic API. Instead, configure git options for subcommands directly with "release.version.git" and "release.changelog.git".`,
+                bodyLines: [nxJsonMessage],
+            });
+            process.exit(1);
+        }
+        const tree = new tree_1.FsTree(workspace_root_1.workspaceRoot, args.verbose);
+        // Use pre-built release graph if provided, otherwise create a new one
+        const releaseGraph = args.releaseGraph ||
+            (await (0, release_graph_1.createReleaseGraph)({
+                tree,
+                projectGraph,
+                nxReleaseConfig,
+                filters: {
+                    projects: args.projects,
+                    groups: args.groups,
+                },
+                firstRelease: args.firstRelease,
+                verbose: args.verbose,
+            }));
+        // Display filter log if filters were applied (only when graph was created, not reused)
+        if (!args.releaseGraph &&
+            releaseGraph.filterLog &&
+            process.env.NX_RELEASE_INTERNAL_SUPPRESS_FILTER_LOG !== 'true') {
+            output_1.output.note(releaseGraph.filterLog);
+        }
+        // Programmatic API consumers can force changelog generation to run even when the resolved
+        // configuration is considered effectively disabled (e.g. when they have disabled changelog
+        // file writing and remote release creation because they consume the returned changelog
+        // contents in memory instead)
+        const changelogGenerationEnabled = args.forceChangelogGeneration ||
+            isChangelogEffectivelyEnabled(nxReleaseConfig.changelog.workspaceChangelog) ||
+            Object.values(nxReleaseConfig.groups).some((g) => isChangelogEffectivelyEnabled(g.changelog));
+        if (!changelogGenerationEnabled) {
+            output_1.output.warn({
+                title: `Changelogs are disabled. No changelog entries will be generated`,
+                bodyLines: [
+                    `To explicitly enable changelog generation, configure "release.changelog.workspaceChangelog" or "release.changelog.projectChangelogs" in nx.json.`,
+                ],
+            });
+            return {};
+        }
+        let rawVersionPlans = await (0, version_plans_1.readRawVersionPlans)();
+        if (args.deleteVersionPlans === undefined) {
+            // default to deleting version plans in this command instead of after versioning
+            args.deleteVersionPlans = true;
+        }
+        const useAutomaticFromRef = nxReleaseConfig.changelog?.automaticFromRef || args.firstRelease;
+        /**
+         * For determining the versions to use within changelog files, there are a few different possibilities:
+         * - the user is using the nx CLI, and therefore passes a single --version argument which represents the version for any and all changelog
+         * files which will be generated (i.e. both the workspace changelog, and all project changelogs, depending on which of those has been enabled)
+         * - the user is using the nxReleaseChangelog API programmatically, and:
+         *   - passes only a version property
+         *     - this works in the same way as described above for the CLI
+         *   - passes only a versionData object
+         *     - this is a special case where the user is providing a version for each project, and therefore the version argument is not needed
+         *     - NOTE: it is not possible to generate a workspace level changelog with only a versionData object, and this will produce an error
+         *   - passes both a version and a versionData object
+         *     - in this case, the version property will be used as the reference for the workspace changelog, and the versionData object will be used
+         *    to generate project changelogs
+         */
+        const { workspaceChangelogVersion, projectsVersionData } = resolveChangelogVersions(args, releaseGraph);
+        const to = args.to || 'HEAD';
+        const toSHA = await (0, git_1.getCommitHash)(to);
+        const headSHA = to === 'HEAD' ? toSHA : await (0, git_1.getCommitHash)('HEAD');
+        // Resolve the from SHA once for reuse across different contexts
+        const fromSHA = await (0, version_plan_filtering_1.resolveWorkspaceChangelogFromSHA)({
+            args,
+            nxReleaseConfig,
+            useAutomaticFromRef,
+            resolveRepositoryTags: releaseGraph.resolveRepositoryTags.bind(releaseGraph),
+        });
+        // Filter version plans based on resolveVersionPlans option
+        const shouldFilterVersionPlans = args.resolveVersionPlans === 'using-from-and-to';
+        if (shouldFilterVersionPlans && rawVersionPlans.length > 0 && fromSHA) {
+            rawVersionPlans = await (0, version_plan_filtering_1.filterVersionPlansByCommitRange)(rawVersionPlans, fromSHA, toSHA, args.verbose);
+            if (args.verbose) {
+                console.log(`Using version plans committed between ${fromSHA} and ${toSHA}`);
+            }
+        }
+        // Set resolved version plans on groups
+        await (0, version_plans_1.setResolvedVersionPlansOnGroups)(rawVersionPlans, releaseGraph.releaseGroups, Object.keys(projectGraph.nodes), args.verbose);
+        // Validate version plans against the filter after resolution
+        const versionPlanValidationError = (0, version_plan_utils_2.validateResolvedVersionPlansAgainstFilter)(releaseGraph.releaseGroups, releaseGraph.releaseGroupToFilteredProjects);
+        if (versionPlanValidationError) {
+            output_1.output.error(versionPlanValidationError);
+            process.exit(1);
+        }
+        /**
+         * Extract the preid from the workspace version and the project versions
+         */
+        const workspacePreid = workspaceChangelogVersion
+            ? extractPreid(workspaceChangelogVersion)
+            : undefined;
+        const projectsPreid = Object.fromEntries(Object.entries(projectsVersionData).map(([projectName, v]) => [
+            projectName,
+            v.newVersion ? extractPreid(v.newVersion) : undefined,
+        ]));
+        /**
+         * Protect the user against attempting to create a new commit when recreating an old release changelog,
+         * this seems like it would always be unintentional.
+         */
+        const autoCommitEnabled = args.gitCommit ?? nxReleaseConfig.changelog.git.commit;
+        if (autoCommitEnabled && headSHA !== toSHA) {
+            throw new Error(`You are attempting to recreate the changelog for an old release, but you have enabled auto-commit mode. Please disable auto-commit mode by updating your nx.json, or passing --git-commit=false`);
+        }
+        const commitMessage = args.gitCommitMessage || nxReleaseConfig.changelog.git.commitMessage;
+        const commitMessageValues = (0, shared_1.createCommitMessageValues)(releaseGraph.releaseGroups, releaseGraph.releaseGroupToFilteredProjects, projectsVersionData, commitMessage);
+        // Resolve any git tags as early as possible so that we can hard error in case of any duplicates before reaching the actual git command
+        const gitTagValues = (args.gitTag ?? nxReleaseConfig.changelog.git.tag)
+            ? (0, shared_1.createGitTagValues)(releaseGraph.releaseGroups, releaseGraph.releaseGroupToFilteredProjects, projectsVersionData)
+            : [];
+        (0, shared_1.handleDuplicateGitTags)(gitTagValues);
+        const postGitTasks = [];
+        const workspaceChangelogChanges = await resolveWorkspaceChangelogChanges({
+            releaseGraph,
+            nxReleaseConfig,
+            args,
+            workspacePreid,
+            projectsPreid,
+            useAutomaticFromRef,
+            toSHA,
+            fromSHA,
+        });
+        const workspaceChangelog = await generateChangelogForWorkspace({
+            tree,
+            args,
+            nxReleaseConfig,
+            workspaceChangelogVersion,
+            changes: workspaceChangelogChanges,
+        });
+        // Add the post git task (e.g. create a remote release) for the workspace changelog, if applicable
+        if (workspaceChangelog && workspaceChangelog.postGitTask) {
+            postGitTasks.push(workspaceChangelog.postGitTask);
+        }
+        /**
+         * Create a cache for from SHA resolution to avoid duplicate git operations
+         */
+        const fromSHACache = new Map();
+        // Cache the workspace from SHA if available
+        if (fromSHA) {
+            fromSHACache.set('workspace', fromSHA);
+        }
+        // Helper function to get cached from SHA or resolve and cache it
+        const getCachedFromSHA = async (cacheKey, pattern, templateValues, preid, checkAllBranchesWhen, requireSemver, strictPreid, projectRoot) => {
+            if (fromSHACache.has(cacheKey)) {
+                return fromSHACache.get(cacheKey);
+            }
+            const sha = await (0, version_plan_filtering_1.resolveChangelogFromSHA)({
+                fromRef: args.from,
+                tagPattern: pattern,
+                tagPatternValues: templateValues,
+                resolveRepositoryTags: releaseGraph.resolveRepositoryTags.bind(releaseGraph),
+                checkAllBranchesWhen,
+                preid,
+                requireSemver,
+                strictPreid,
+                useAutomaticFromRef,
+                projectRoot,
+            });
+            fromSHACache.set(cacheKey, sha);
+            return sha;
+        };
+        /**
+         * Compute any additional dependency bumps up front because there could be cases of circular dependencies,
+         * and figuring them out during the main iteration would be too late.
+         */
+        const projectToAdditionalDependencyBumps = new Map();
+        for (const releaseGroup of releaseGraph.releaseGroups) {
+            if (releaseGroup.projectsRelationship !== 'independent') {
+                continue;
+            }
+            for (const project of releaseGroup.projects) {
+                // If the project does not have any changes, do not process its dependents
+                if (!projectsVersionData[project] ||
+                    projectsVersionData[project].newVersion === null) {
+                    continue;
+                }
+                const dependentProjects = (projectsVersionData[project].dependentProjects || [])
+                    .map((dep) => {
+                    return {
+                        dependencyName: dep.source,
+                        newVersion: projectsVersionData[dep.source]?.newVersion ?? null,
+                    };
+                })
+                    .filter((b) => b.newVersion !== null);
+                for (const dependent of dependentProjects) {
+                    const additionalDependencyBumpsForProject = projectToAdditionalDependencyBumps.has(dependent.dependencyName)
+                        ? projectToAdditionalDependencyBumps.get(dependent.dependencyName)
+                        : [];
+                    additionalDependencyBumpsForProject.push({
+                        dependencyName: project,
+                        newVersion: projectsVersionData[project].newVersion,
+                    });
+                    projectToAdditionalDependencyBumps.set(dependent.dependencyName, additionalDependencyBumpsForProject);
+                }
+            }
+        }
+        const allProjectChangelogs = {};
+        for (const releaseGroup of releaseGraph.releaseGroups) {
+            const config = releaseGroup.changelog;
+            // The entire feature is disabled at the release group level, exit early
+            if (config === false) {
+                continue;
+            }
+            const projects = args.projects?.length
+                ? // If the user has passed a list of projects, we need to use the filtered list of projects within the release group, plus any dependents
+                    Array.from(new Set(Array.from(releaseGraph.releaseGroupToFilteredProjects.get(releaseGroup)).flatMap((project) => {
+                        return [
+                            project,
+                            ...(projectsVersionData[project]?.dependentProjects.map((dep) => dep.source) || []),
+                        ];
+                    })))
+                : // Otherwise, we use the full list of projects within the release group
+                    releaseGroup.projects;
+            const projectNodes = projects.map((name) => projectGraph.nodes[name]);
+            if (releaseGroup.projectsRelationship === 'independent') {
+                for (const project of projectNodes) {
+                    if (!projectsVersionData[project.name] ||
+                        (projectsVersionData[project.name].newVersion === null &&
+                            !projectsVersionData[project.name].dockerVersion)) {
+                        continue;
+                    }
+                    let changes = null;
+                    if (releaseGroup.resolvedVersionPlans) {
+                        changes = (0, version_plan_utils_1.createChangesFromProjectsVersionPlans)(releaseGroup.resolvedVersionPlans, project.name);
+                    }
+                    else {
+                        const projectCacheKey = `${releaseGroup.name}:${project.name}`;
+                        const fromSHA = await getCachedFromSHA(projectCacheKey, releaseGroup.releaseTag.pattern, {
+                            projectName: project.name,
+                            releaseGroupName: releaseGroup.name,
+                        }, projectsPreid[project.name], releaseGroup.releaseTag.checkAllBranchesWhen, releaseGroup.releaseTag.requireSemver, releaseGroup.releaseTag.strictPreid, project.data.root);
+                        let commits;
+                        let fromRef = fromSHA;
+                        if (!fromRef && useAutomaticFromRef) {
+                            // For automatic from ref, we already have it cached
+                            fromRef = fromSHACache.get(projectCacheKey);
+                            if (fromRef) {
+                                commits = await filterProjectCommits({
+                                    fromSHA: fromRef,
+                                    toSHA,
+                                    projectPath: project.data.root,
+                                });
+                                fromRef = commits[0]?.shortHash;
+                                if (args.verbose) {
+                                    console.log(`Determined --from ref for ${project.name} from the first commit in which it exists: ${fromRef}`);
+                                }
+                            }
+                        }
+                        if (!fromRef && !commits) {
+                            throw new Error(`Unable to determine the previous git tag. If this is the first release of your workspace, use the --first-release option or set the "release.changelog.automaticFromRef" config property in nx.json to generate a changelog from the first commit. Otherwise, be sure to configure the "release.releaseTag.pattern" property in nx.json to match the structure of your repository's git tags.`);
+                        }
+                        if (!commits) {
+                            commits = await filterProjectCommits({
+                                fromSHA: fromRef,
+                                toSHA,
+                                projectPath: project.data.root,
+                            });
+                        }
+                        const { fileMap } = await (0, file_map_utils_1.createFileMapUsingProjectGraph)(projectGraph);
+                        const fileToProjectMap = (0, commit_utils_1.createFileToProjectMap)(fileMap.projectFileMap);
+                        changes = (0, commit_utils_1.createChangesFromCommits)(commits, fileMap, fileToProjectMap, nxReleaseConfig.conventionalCommits);
+                    }
+                    const projectChangelogs = await generateChangelogForProjects({
+                        tree,
+                        args,
+                        changes,
+                        projectsVersionData,
+                        releaseGroup,
+                        projects: [project],
+                        nxReleaseConfig,
+                        projectToAdditionalDependencyBumps,
+                    });
+                    if (projectChangelogs) {
+                        for (const [projectName, projectChangelog] of Object.entries(projectChangelogs)) {
+                            // Add the post git task (e.g. create a remote release) for the project changelog, if applicable
+                            if (projectChangelog.postGitTask) {
+                                postGitTasks.push(projectChangelog.postGitTask);
+                            }
+                            allProjectChangelogs[projectName] = projectChangelog;
+                        }
+                    }
+                }
+            }
+            else {
+                let changes = [];
+                if (releaseGroup.resolvedVersionPlans) {
+                    // This is identical to workspace changelog for fixed groups
+                    changes = (0, version_plan_utils_1.createChangesFromGroupVersionPlans)(releaseGroup.resolvedVersionPlans);
+                }
+                else {
+                    const groupCacheKey = `${releaseGroup.name}:fixed`;
+                    const fromSHA = await getCachedFromSHA(groupCacheKey, releaseGroup.releaseTag.pattern, {
+                        releaseGroupName: releaseGroup.name,
+                    }, workspacePreid ?? projectsPreid?.[Object.keys(projectsPreid)[0]], releaseGroup.releaseTag.checkAllBranchesWhen, releaseGroup.releaseTag.requireSemver, releaseGroup.releaseTag.strictPreid);
+                    if (!fromSHA) {
+                        throw new Error(`Unable to determine the previous git tag. If this is the first release of your release group, use the --first-release option or set the "release.changelog.automaticFromRef" config property in nx.json to generate a changelog from the first commit. Otherwise, be sure to configure the "release.releaseTag.pattern" property in nx.json to match the structure of your repository's git tags.`);
+                    }
+                    if (args.verbose && useAutomaticFromRef && !args.from) {
+                        console.log(`Determined release group --from ref from the first commit in the workspace: ${fromSHA}`);
+                    }
+                    const { fileMap } = await (0, file_map_utils_1.createFileMapUsingProjectGraph)(projectGraph);
+                    const fileToProjectMap = (0, commit_utils_1.createFileToProjectMap)(fileMap.projectFileMap);
+                    const commits = await getCommits(fromSHA, toSHA);
+                    changes = (0, commit_utils_1.createChangesFromCommits)(commits, fileMap, fileToProjectMap, nxReleaseConfig.conventionalCommits);
+                }
+                const projectChangelogs = await generateChangelogForProjects({
+                    tree,
+                    args,
+                    changes,
+                    projectsVersionData,
+                    releaseGroup,
+                    projects: projectNodes,
+                    nxReleaseConfig,
+                    projectToAdditionalDependencyBumps,
+                });
+                if (projectChangelogs) {
+                    for (const [projectName, projectChangelog] of Object.entries(projectChangelogs)) {
+                        // Add the post git task (e.g. create a remote release) for the project changelog, if applicable
+                        if (projectChangelog.postGitTask) {
+                            postGitTasks.push(projectChangelog.postGitTask);
+                        }
+                        allProjectChangelogs[projectName] = projectChangelog;
+                    }
+                }
+            }
+        }
+        await applyChangesAndExit(args, nxReleaseConfig, tree, toSHA, postGitTasks, commitMessageValues, gitTagValues, releaseGraph);
+        return {
+            workspaceChangelog,
+            projectChangelogs: allProjectChangelogs,
+        };
+    };
+}
+function resolveChangelogVersions(args, releaseGraph) {
+    if (!args.version && !args.versionData) {
+        throw new Error(`You must provide a version string and/or a versionData object.`);
+    }
+    const versionData = releaseGraph.releaseGroups.reduce((versionData, releaseGroup) => {
+        const releaseGroupProjectNames = Array.from(releaseGraph.releaseGroupToFilteredProjects.get(releaseGroup));
+        for (const projectName of releaseGroupProjectNames) {
+            if (!args.versionData) {
+                versionData[projectName] = {
+                    dockerVersion: args.version,
+                    newVersion: args.version,
+                    currentVersion: '', // not relevant within changelog/commit generation
+                    dependentProjects: [], // not relevant within changelog/commit generation
+                };
+                continue;
+            }
+            /**
+             * In the case where a versionData object was provided, we need to make sure all projects are present,
+             * otherwise it suggests a filtering mismatch between the version and changelog command invocations.
+             */
+            if (!args.versionData[projectName]) {
+                throw new Error(`The provided versionData object does not contain a version for project "${projectName}". This suggests a filtering mismatch between the version and changelog command invocations. Please ensure that you have used the same "group" or "project" filter between commands.`);
+            }
+        }
+        return versionData;
+    }, args.versionData || {});
+    return {
+        workspaceChangelogVersion: args.version,
+        projectsVersionData: versionData,
+    };
+}
+// Can be overridden to something more specific as we resolve the remote release client within nested logic
+let remoteReleaseProviderName;
+// If already set, and not the same as the remote release client, append
+function applyRemoteReleaseProviderName(newRemoteReleaseProviderName) {
+    if (remoteReleaseProviderName) {
+        if (remoteReleaseProviderName !== newRemoteReleaseProviderName) {
+            remoteReleaseProviderName = `${remoteReleaseProviderName}/${newRemoteReleaseProviderName}`;
+        }
+    }
+    else {
+        remoteReleaseProviderName = newRemoteReleaseProviderName;
+    }
+}
+async function applyChangesAndExit(args, nxReleaseConfig, tree, toSHA, postGitTasks, commitMessageValues, gitTagValues, releaseGraph) {
+    let latestCommit = toSHA;
+    const changes = tree.listChanges();
+    /**
+     * In the case where we are expecting changelog file updates, but there is nothing
+     * to flush from the tree, we exit early. This could happen we using conventional
+     * commits, for example.
+     */
+    const changelogFilesEnabled = checkChangelogFilesEnabled(nxReleaseConfig);
+    if (changelogFilesEnabled && !changes.length) {
+        output_1.output.warn({
+            title: `No changes detected for changelogs`,
+            bodyLines: [
+                `No changes were detected for any changelog files, so no changelog entries will be generated.`,
+            ],
+        });
+        if (!postGitTasks.length) {
+            // No post git tasks (e.g. remote release creation) to perform so we can just exit
+            return;
+        }
+        if ((0, is_ci_1.isCI)()) {
+            output_1.output.warn({
+                title: `Skipped ${remoteReleaseProviderName ?? 'remote'} release creation because no changes were detected for any changelog files.`,
+            });
+            return;
+        }
+        /**
+         * Prompt the user to see if they want to create a remote release anyway.
+         * We know that the user has configured remote releases because we have postGitTasks.
+         */
+        const shouldCreateRemoteReleaseAnyway = await promptForRemoteRelease();
+        if (!shouldCreateRemoteReleaseAnyway) {
+            return;
+        }
+        for (const postGitTask of postGitTasks) {
+            await postGitTask(latestCommit);
+        }
+        return;
+    }
+    const changedFiles = changes.map((f) => f.path);
+    let deletedFiles = [];
+    if (args.deleteVersionPlans) {
+        const planFiles = new Set();
+        releaseGraph.releaseGroups.forEach((group) => {
+            const filteredProjects = releaseGraph.releaseGroupToFilteredProjects.get(group);
+            if (group.resolvedVersionPlans) {
+                // Check each version plan individually to see if it should be deleted
+                const plansToDelete = [];
+                for (const plan of group.resolvedVersionPlans) {
+                    // Only delete if ALL projects in the version plan are being filtered/released
+                    if ((0, version_plan_utils_2.areAllVersionPlanProjectsFiltered)(plan, group, filteredProjects)) {
+                        plansToDelete.push(plan);
+                    }
+                }
+                // Delete the plans that only affect filtered projects
+                plansToDelete.forEach((plan) => {
+                    if (!args.dryRun) {
+                        (0, node_fs_1.rmSync)(plan.absolutePath, { recursive: true, force: true });
+                        if (args.verbose) {
+                            console.log(`Removing ${plan.relativePath}`);
+                        }
+                    }
+                    else {
+                        if (args.verbose) {
+                            console.log(`Would remove ${plan.relativePath}, but --dry-run was set`);
+                        }
+                    }
+                    planFiles.add(plan.relativePath);
+                });
+            }
+        });
+        deletedFiles = Array.from(planFiles);
+    }
+    // Generate a new commit for the changes, if configured to do so
+    if (args.gitCommit ?? nxReleaseConfig.changelog.git.commit) {
+        await (0, shared_1.commitChanges)({
+            changedFiles,
+            deletedFiles,
+            isDryRun: !!args.dryRun,
+            isVerbose: !!args.verbose,
+            gitCommitMessages: commitMessageValues,
+            gitCommitArgs: args.gitCommitArgs || nxReleaseConfig.changelog.git.commitArgs,
+        });
+        // Resolve the commit we just made
+        latestCommit = await (0, git_1.getCommitHash)('HEAD');
+    }
+    else if ((args.stageChanges ?? nxReleaseConfig.changelog.git.stageChanges) &&
+        changes.length) {
+        output_1.output.logSingleLine(`Staging changed files with git`);
+        await (0, git_1.gitAdd)({
+            changedFiles,
+            deletedFiles,
+            dryRun: args.dryRun,
+            verbose: args.verbose,
+        });
+    }
+    // Generate a one or more git tags for the changes, if configured to do so
+    if (args.gitTag ?? nxReleaseConfig.changelog.git.tag) {
+        output_1.output.logSingleLine(`Tagging commit with git`);
+        for (const tag of gitTagValues) {
+            await (0, git_1.gitTag)({
+                tag,
+                message: args.gitTagMessage || nxReleaseConfig.changelog.git.tagMessage,
+                additionalArgs: args.gitTagArgs || nxReleaseConfig.changelog.git.tagArgs,
+                dryRun: args.dryRun,
+                verbose: args.verbose,
+            });
+        }
+    }
+    if (args.gitPush ?? nxReleaseConfig.changelog.git.push) {
+        output_1.output.logSingleLine(`Pushing to git remote "${args.gitRemote ?? 'origin'}"`);
+        await (0, git_1.gitPush)({
+            gitRemote: args.gitRemote,
+            dryRun: args.dryRun,
+            verbose: args.verbose,
+            additionalArgs: args.gitPushArgs || nxReleaseConfig.changelog.git.pushArgs,
+        });
+    }
+    // Run any post-git tasks in series
+    for (const postGitTask of postGitTasks) {
+        await postGitTask(latestCommit);
+    }
+    return;
+}
+async function generateChangelogForWorkspace({ tree, args, nxReleaseConfig, workspaceChangelogVersion, changes, }) {
+    const config = nxReleaseConfig.changelog.workspaceChangelog;
+    // The entire feature is disabled at the workspace level, exit early
+    if (config === false) {
+        return;
+    }
+    // If explicitly null it must mean that no changes were detected (e.g. when using conventional commits), so do nothing
+    if (workspaceChangelogVersion === null) {
+        return;
+    }
+    // The user explicitly passed workspaceChangelog=true but does not have a workspace changelog config in nx.json
+    if (!config) {
+        throw new Error(`Workspace changelog is enabled but no configuration was provided. Please provide a workspaceChangelog object in your nx.json`);
+    }
+    if (Object.entries(nxReleaseConfig.groups).length > 1) {
+        output_1.output.warn({
+            title: `Workspace changelog is enabled, but you have multiple release groups configured. This is not supported, so workspace changelog will be disabled.`,
+            bodyLines: [
+                `A single workspace version cannot be determined when defining multiple release groups because versions can differ between each group.`,
+                `Project level changelogs can be enabled with the "release.changelog.projectChangelogs" property.`,
+            ],
+        });
+        return;
+    }
+    if (Object.values(nxReleaseConfig.groups)[0].projectsRelationship ===
+        'independent') {
+        output_1.output.warn({
+            title: `Workspace changelog is enabled, but you have configured an independent projects relationship. This is not supported, so workspace changelog will be disabled.`,
+            bodyLines: [
+                `A single workspace version cannot be determined when using independent projects because versions can differ between each project.`,
+                `Project level changelogs can be enabled with the "release.changelog.projectChangelogs" property.`,
+            ],
+        });
+        return;
+    }
+    // Only trigger interactive mode for the workspace changelog if the user explicitly requested it via "all" or "workspace"
+    const interactive = args.interactive === 'all' || args.interactive === 'workspace';
+    const dryRun = !!args.dryRun;
+    const gitRemote = args.gitRemote;
+    const ChangelogRendererClass = (0, resolve_changelog_renderer_1.resolveChangelogRenderer)(config.renderer);
+    let interpolatedTreePath = config.file || '';
+    if (interpolatedTreePath) {
+        interpolatedTreePath = (0, utils_1.interpolate)(interpolatedTreePath, {
+            projectName: '', // n/a for the workspace changelog
+            projectRoot: '', // n/a for the workspace changelog
+            workspaceRoot: '', // within the tree, workspaceRoot is the root
+        });
+    }
+    const releaseVersion = new shared_1.ReleaseVersion({
+        version: workspaceChangelogVersion,
+        releaseTagPattern: nxReleaseConfig.releaseTag.pattern,
+        releaseGroupName: Object.keys(nxReleaseConfig.groups)[0],
+    });
+    if (interpolatedTreePath) {
+        const prefix = dryRun ? 'Previewing' : 'Generating';
+        output_1.output.log({
+            title: `${prefix} an entry in ${interpolatedTreePath} for ${pc.white(releaseVersion.gitTag)}`,
+        });
+    }
+    const remoteReleaseClient = await (0, remote_release_client_1.createRemoteReleaseClient)(config.createRelease, gitRemote);
+    applyRemoteReleaseProviderName(remoteReleaseClient.remoteReleaseProviderName);
+    const changelogRenderer = new ChangelogRendererClass({
+        changes,
+        changelogEntryVersion: releaseVersion.rawVersion,
+        project: null,
+        isVersionPlans: !!nxReleaseConfig.versionPlans,
+        entryWhenNoChanges: config.entryWhenNoChanges,
+        changelogRenderOptions: config.renderOptions,
+        conventionalCommitsConfig: nxReleaseConfig.conventionalCommits,
+        remoteReleaseClient,
+    });
+    let contents = await changelogRenderer.render();
+    /**
+     * If interactive mode, make the changelog contents available for the user to modify in their editor of choice,
+     * in a similar style to git interactive rebases/merges.
+     */
+    if (interactive) {
+        const tmpDir = (0, tmp_1.dirSync)().name;
+        const changelogPath = (0, path_1.joinPathFragments)(tmpDir, 
+        // Include the tree path in the name so that it is easier to identify which changelog file is being edited
+        `PREVIEW__${interpolatedTreePath.replace(/\//g, '_')}`);
+        (0, node_fs_1.writeFileSync)(changelogPath, contents);
+        await (0, launch_editor_1.launchEditor)(changelogPath);
+        contents = (0, node_fs_1.readFileSync)(changelogPath, 'utf-8');
+    }
+    if (interpolatedTreePath) {
+        let rootChangelogContents = tree.exists(interpolatedTreePath)
+            ? tree.read(interpolatedTreePath).toString()
+            : '';
+        if (rootChangelogContents && !args.replaceExistingContents) {
+            // NOTE: right now existing releases are always expected to be in markdown format, but in the future we could potentially support others via a custom parser option
+            const changelogReleases = (0, markdown_1.parseChangelogMarkdown)(rootChangelogContents).releases;
+            const existingVersionToUpdate = changelogReleases.find((r) => r.version === releaseVersion.rawVersion);
+            if (existingVersionToUpdate) {
+                rootChangelogContents = rootChangelogContents.replace(`## ${releaseVersion.rawVersion}\n\n\n${existingVersionToUpdate.body}`, contents);
+            }
+            else {
+                // No existing version, simply prepend the new release to the top of the file
+                rootChangelogContents = `${contents}\n\n${rootChangelogContents}`;
+            }
+        }
+        else {
+            // No existing changelog contents, or replaceExistingContents is true, simply use the generated contents directly
+            rootChangelogContents = contents;
+        }
+        tree.write(interpolatedTreePath, rootChangelogContents);
+        (0, print_changes_1.printAndFlushChanges)(tree, !!dryRun, 3, false, shared_1.noDiffInChangelogMessage);
+    }
+    const postGitTask = args.createRelease !== false && config.createRelease
+        ? remoteReleaseClient.createPostGitTask(releaseVersion, contents, dryRun)
+        : null;
+    return {
+        releaseVersion,
+        contents,
+        postGitTask,
+    };
+}
+async function generateChangelogForProjects({ tree, args, changes, projectsVersionData, releaseGroup, projects, nxReleaseConfig, projectToAdditionalDependencyBumps, }) {
+    const config = releaseGroup.changelog;
+    // The entire feature is disabled at the release group level, exit early
+    if (config === false) {
+        return;
+    }
+    // Only trigger interactive mode for the project changelog if the user explicitly requested it via "all" or "projects"
+    const interactive = args.interactive === 'all' || args.interactive === 'projects';
+    const dryRun = !!args.dryRun;
+    const gitRemote = args.gitRemote;
+    const ChangelogRendererClass = (0, resolve_changelog_renderer_1.resolveChangelogRenderer)(config.renderer);
+    // Maximum of one remote release client per release group
+    const remoteReleaseClient = await (0, remote_release_client_1.createRemoteReleaseClient)(config.createRelease, gitRemote);
+    applyRemoteReleaseProviderName(remoteReleaseClient.remoteReleaseProviderName);
+    const projectChangelogs = {};
+    for (const project of projects) {
+        let interpolatedTreePath = config.file || '';
+        if (interpolatedTreePath) {
+            interpolatedTreePath = (0, utils_1.interpolate)(interpolatedTreePath, {
+                projectName: project.name,
+                projectRoot: project.data.root,
+                workspaceRoot: '', // within the tree, workspaceRoot is the root
+            });
+        }
+        /**
+         * newVersion will be null in the case that no changes were detected (e.g. in conventional commits mode),
+         * no changelog entry is relevant in that case.
+         */
+        if (!projectsVersionData[project.name] ||
+            (projectsVersionData[project.name].newVersion === null &&
+                !projectsVersionData[project.name].dockerVersion)) {
+            continue;
+        }
+        const preferDockerVersion = (0, shared_1.shouldPreferDockerVersionForReleaseGroup)(releaseGroup);
+        const releaseVersion = new shared_1.ReleaseVersion({
+            version: (preferDockerVersion === true || preferDockerVersion === 'both') &&
+                projectsVersionData[project.name].dockerVersion
+                ? projectsVersionData[project.name].dockerVersion
+                : projectsVersionData[project.name].newVersion,
+            releaseTagPattern: releaseGroup.releaseTag.pattern,
+            projectName: project.name,
+            releaseGroupName: releaseGroup.name,
+        });
+        if (interpolatedTreePath) {
+            const prefix = dryRun ? 'Previewing' : 'Generating';
+            output_1.output.log({
+                title: `${prefix} an entry in ${interpolatedTreePath} for ${pc.white(releaseVersion.gitTag)}`,
+            });
+        }
+        const changelogRenderer = new ChangelogRendererClass({
+            changes,
+            changelogEntryVersion: releaseVersion.rawVersion,
+            project: project.name,
+            entryWhenNoChanges: typeof config.entryWhenNoChanges === 'string'
+                ? (0, utils_1.interpolate)(config.entryWhenNoChanges, {
+                    projectName: project.name,
+                    projectRoot: project.data.root,
+                    workspaceRoot: '', // within the tree, workspaceRoot is the root
+                })
+                : false,
+            changelogRenderOptions: config.renderOptions,
+            isVersionPlans: !!releaseGroup.versionPlans,
+            conventionalCommitsConfig: nxReleaseConfig.conventionalCommits,
+            dependencyBumps: projectToAdditionalDependencyBumps.get(project.name),
+            remoteReleaseClient,
+        });
+        let contents = await changelogRenderer.render();
+        /**
+         * If interactive mode, make the changelog contents available for the user to modify in their editor of choice,
+         * in a similar style to git interactive rebases/merges.
+         */
+        if (interactive) {
+            const tmpDir = (0, tmp_1.dirSync)().name;
+            const changelogPath = (0, path_1.joinPathFragments)(tmpDir, 
+            // Include the tree path in the name so that it is easier to identify which changelog file is being edited
+            `PREVIEW__${interpolatedTreePath.replace(/\//g, '_')}`);
+            (0, node_fs_1.writeFileSync)(changelogPath, contents);
+            await (0, launch_editor_1.launchEditor)(changelogPath);
+            contents = (0, node_fs_1.readFileSync)(changelogPath, 'utf-8');
+        }
+        if (interpolatedTreePath) {
+            let changelogContents = tree.exists(interpolatedTreePath)
+                ? tree.read(interpolatedTreePath).toString()
+                : '';
+            if (changelogContents) {
+                // NOTE: right now existing releases are always expected to be in markdown format, but in the future we could potentially support others via a custom parser option
+                const changelogReleases = (0, markdown_1.parseChangelogMarkdown)(changelogContents).releases;
+                const existingVersionToUpdate = changelogReleases.find((r) => r.version === releaseVersion.rawVersion);
+                if (existingVersionToUpdate) {
+                    changelogContents = changelogContents.replace(`## ${releaseVersion.rawVersion}\n\n\n${existingVersionToUpdate.body}`, contents);
+                }
+                else {
+                    // No existing version, simply prepend the new release to the top of the file
+                    changelogContents = `${contents}\n\n${changelogContents}`;
+                }
+            }
+            else {
+                // No existing changelog contents, simply create a new one using the generated contents
+                changelogContents = contents;
+            }
+            tree.write(interpolatedTreePath, changelogContents);
+            (0, print_changes_1.printAndFlushChanges)(tree, !!dryRun, 3, false, shared_1.noDiffInChangelogMessage, 
+            // Only print the change for the current changelog file at this point
+            (f) => f.path === interpolatedTreePath);
+        }
+        const postGitTask = args.createRelease !== false && config.createRelease
+            ? remoteReleaseClient.createPostGitTask(releaseVersion, contents, dryRun)
+            : null;
+        projectChangelogs[project.name] = {
+            releaseVersion,
+            contents,
+            postGitTask,
+        };
+    }
+    return projectChangelogs;
+}
+function checkChangelogFilesEnabled(nxReleaseConfig) {
+    if (nxReleaseConfig.changelog.workspaceChangelog &&
+        nxReleaseConfig.changelog.workspaceChangelog.file) {
+        return true;
+    }
+    for (const releaseGroup of Object.values(nxReleaseConfig.groups)) {
+        if (releaseGroup.changelog && releaseGroup.changelog.file) {
+            return true;
+        }
+    }
+    return false;
+}
+async function getCommits(fromSHA, toSHA) {
+    const rawCommits = await (0, git_1.getGitDiff)(fromSHA, toSHA);
+    // Parse as conventional commits
+    return (0, git_1.parseCommits)(rawCommits);
+}
+async function filterProjectCommits({ fromSHA, toSHA, projectPath, }) {
+    const allCommits = await getCommits(fromSHA, toSHA);
+    return allCommits.filter((c) => c.affectedFiles.find((f) => f.startsWith(projectPath)));
+}
+async function promptForRemoteRelease() {
+    return (0, prompt_helpers_1.confirmationPrompt)({
+        message: `Do you want to create a ${remoteReleaseProviderName ?? 'remote'} release anyway?`,
+        // Cancelling declines the release rather than failing the run.
+        onCancel: () => false,
+    });
+}
+async function resolveWorkspaceChangelogChanges({ releaseGraph, nxReleaseConfig, args, workspacePreid, projectsPreid, useAutomaticFromRef, toSHA, fromSHA, }) {
+    // NOTE: If there are multiple release groups, we'll just skip the workspace changelog anyway.
+    const versionPlansEnabledForWorkspaceChangelog = releaseGraph.releaseGroups[0]?.resolvedVersionPlans;
+    // Derive changes from version plan files
+    if (versionPlansEnabledForWorkspaceChangelog) {
+        return resolveWorkspaceChangelogFromVersionPlans(releaseGraph);
+    }
+    // Derive changes from commits
+    return resolveWorkspaceChangelogFromCommits({
+        nxReleaseConfig,
+        args,
+        workspacePreid,
+        projectsPreid,
+        useAutomaticFromRef,
+        toSHA,
+        fromSHA,
+    });
+}
+function resolveWorkspaceChangelogFromVersionPlans(releaseGraph) {
+    const firstReleaseGroup = releaseGraph.releaseGroups[0];
+    // We only produce a workspace changelog in the case of a single, fixed relationship release group
+    if (releaseGraph.releaseGroups.length !== 1 ||
+        firstReleaseGroup?.projectsRelationship !== 'fixed') {
+        return [];
+    }
+    const versionPlans = firstReleaseGroup.resolvedVersionPlans;
+    return (0, version_plan_utils_1.createChangesFromGroupVersionPlans)(versionPlans);
+}
+async function resolveWorkspaceChangelogFromCommits({ nxReleaseConfig, args, workspacePreid, projectsPreid, useAutomaticFromRef, toSHA, fromSHA, }) {
+    // Use the cached fromSHA if available, otherwise throw an error
+    if (!fromSHA) {
+        throw new Error(`Unable to determine the previous git tag. If this is the first release of your workspace, use the --first-release option or set the "release.changelog.automaticFromRef" config property in nx.json to generate a changelog from the first commit. Otherwise, be sure to configure the "release.releaseTag.pattern" property in nx.json to match the structure of your repository's git tags.`);
+    }
+    const workspaceChangelogFromSHA = fromSHA;
+    const commits = await getCommits(workspaceChangelogFromSHA, toSHA);
+    // For workspace changelog, all commits affect all projects
+    return (0, commit_utils_1.filterHiddenChanges)(commits.map((c) => (0, commit_utils_1.mapCommitToChange)(c, '*')), nxReleaseConfig.conventionalCommits);
+}
+function extractPreid(version) {
+    if (!(0, shared_1.isPrerelease)(version)) {
+        return undefined;
+    }
+    const preid = (0, semver_1.prerelease)(version)?.[0];
+    if (typeof preid === 'string') {
+        if (preid.trim() === '') {
+            return undefined;
+        }
+        return preid;
+    }
+    if (typeof preid === 'number') {
+        return preid.toString();
+    }
+    return undefined;
+}