nx 20.8.4 → 22.7.7

package/src/command-line/release/version/release-group-processor.js

@@ -1,1048 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReleaseGroupProcessor = exports.BUMP_TYPE_REASON_TEXT = void 0;
-const semver = require("semver");
-const config_1 = require("../config/config");
-const git_1 = require("../utils/git");
-const resolve_semver_specifier_1 = require("../utils/resolve-semver-specifier");
-const version_1 = require("../version");
-const derive_specifier_from_conventional_commits_1 = require("./derive-specifier-from-conventional-commits");
-const deriver_specifier_from_version_plans_1 = require("./deriver-specifier-from-version-plans");
-const project_logger_1 = require("./project-logger");
-const resolve_current_version_1 = require("./resolve-current-version");
-const topological_sort_1 = require("./topological-sort");
-const version_actions_1 = require("./version-actions");
-exports.BUMP_TYPE_REASON_TEXT = {
-    DEPENDENCY_WAS_BUMPED: ', because a dependency was bumped, ',
-    USER_SPECIFIER: ', from the given specifier, ',
-    PROMPTED_USER_SPECIFIER: ', from the prompted specifier, ',
-    CONVENTIONAL_COMMITS: ', derived from conventional commits data, ',
-    VERSION_PLANS: ', read from version plan {versionPlanPath}, ',
-    DEPENDENCY_ACROSS_GROUPS_WAS_BUMPED: ', because a dependency project belonging to another release group was bumped, ',
-    OTHER_PROJECT_IN_FIXED_GROUP_WAS_BUMPED_DUE_TO_DEPENDENCY: ', because of a dependency-only bump to another project in the same fixed release group, ',
-};
-class ReleaseGroupProcessor {
-    constructor(tree, projectGraph, nxReleaseConfig, releaseGroups, releaseGroupToFilteredProjects, options) {
-        this.tree = tree;
-        this.projectGraph = projectGraph;
-        this.nxReleaseConfig = nxReleaseConfig;
-        this.releaseGroups = releaseGroups;
-        this.releaseGroupToFilteredProjects = releaseGroupToFilteredProjects;
-        this.options = options;
-        /**
-         * Stores the relationships between release groups, including their dependencies
-         * and dependents. This is used for determining processing order and propagating
-         * version changes between related groups.
-         */
-        this.groupGraph = new Map();
-        /**
-         * Tracks which release groups have already been processed to avoid
-         * processing them multiple times. Used during the group traversal.
-         */
-        this.processedGroups = new Set();
-        /**
-         * Keeps track of which projects have already had their versions bumped.
-         * This is used to avoid redundant version bumping and to determine which
-         * projects need their dependencies updated.
-         */
-        this.bumpedProjects = new Set();
-        /**
-         * Cache of release groups sorted in topological order to ensure dependencies
-         * are processed before dependents. Computed once and reused throughout processing.
-         */
-        this.sortedReleaseGroups = [];
-        /**
-         * Maps each release group to its projects sorted in topological order.
-         * Ensures projects are processed after their dependencies within each group.
-         */
-        this.sortedProjects = new Map();
-        /**
-         * Track the unique afterAllProjectsVersioned functions involved in the current versioning process,
-         * so that we can ensure they are only invoked once per versioning execution.
-         */
-        this.uniqueAfterAllProjectsVersioned = new Map();
-        /**
-         * Track the versionActions for each project so that we can invoke certain instance methods.
-         */
-        this.projectsToVersionActions = new Map();
-        /**
-         * versionData that will ultimately be returned to the nx release version handler by getVersionData()
-         */
-        this.versionData = new Map();
-        /**
-         * Set of all projects that are configured in the nx release config.
-         * Used to validate dependencies and identify projects that should be updated.
-         */
-        this.allProjectsConfiguredForNxRelease = new Set();
-        /**
-         * Set of projects that will be processed in the current run.
-         * This is potentially a subset of allProjectsConfiguredForNxRelease based on filters
-         * and dependency relationships.
-         */
-        this.allProjectsToProcess = new Set();
-        /**
-         * Caches the current version of each project to avoid repeated disk/registry/git tag lookups.
-         * Often used during new version calculation. Will be null if the current version resolver is set to 'none'.
-         */
-        this.cachedCurrentVersions = new Map();
-        /**
-         * Caches git tag information for projects that resolve their version from git tags.
-         * This avoids performing expensive git operations multiple times for the same project.
-         */
-        this.cachedLatestMatchingGitTag = new Map();
-        /**
-         * Temporary storage for dependent project names while building the dependency graph.
-         * This is used as an intermediate step before creating the full dependent projects data.
-         */
-        this.tmpCachedDependentProjects = new Map();
-        /**
-         * Resolve the data regarding dependent projects for each project upfront so that it remains accurate
-         * even after updates are applied to manifests.
-         */
-        this.originalDependentProjectsPerProject = new Map();
-        /**
-         * In the case of fixed release groups that are configured to resolve the current version from a registry
-         * or a git tag, it would be a waste of time and resources to resolve the current version for each individual
-         * project, therefore we maintain a cache of the current version for each applicable fixed release group here.
-         */
-        this.currentVersionsPerFixedReleaseGroup = new Map();
-        /**
-         * Cache of project loggers for each project.
-         */
-        this.projectLoggers = new Map();
-        /**
-         * Track any version plan files that have been processed so that we can delete them after versioning is complete,
-         * while leaving any unprocessed files in place.
-         */
-        this.processedVersionPlanFiles = new Set();
-        /**
-         * Certain configuration options can be overridden at the project level, and otherwise fall back to the release group level.
-         * Many also have a specific default value if nothing is set at either level. To avoid applying this hierarchy for each project
-         * every time such a configuration option is needed, we cache the result per project here.
-         */
-        this.finalConfigsByProject = new Map();
-        /**
-         * Maps each project to its release group for quick O(1) lookups.
-         * This avoids having to scan through all release groups to find a project.
-         */
-        this.projectToReleaseGroup = new Map();
-        /**
-         * Maps each project to its dependents (projects that depend on it).
-         * This is the inverse of the projectToDependencies map and enables
-         * efficient lookup of dependent projects for propagating version changes.
-         */
-        this.projectToDependents = new Map();
-        /**
-         * Maps each project to its dependencies (projects it depends on).
-         * Used for building dependency graphs and determining processing order.
-         */
-        this.projectToDependencies = new Map();
-        /**
-         * Caches the updateDependents setting for each project to avoid repeated
-         * lookups and calculations. This determines if dependent projects should
-         * be automatically updated when a dependency changes.
-         */
-        this.projectToUpdateDependentsSetting = new Map();
-        /**
-         * To match legacy versioning behavior in the case of semver versions with leading "v" characters,
-         * e.g. "v1.0.0", we strip the leading "v" and use the rest of the string as the user given specifier
-         * to ensure that it is valid. If it is a non-semver version, we just use the string as is.
-         *
-         * TODO: re-evaluate if this is definitely what we want... Maybe we can just delegate isValid to the
-         * version actions implementation during prompting?
-         */
-        if (options.userGivenSpecifier?.startsWith('v')) {
-            const userGivenSpecifierWithoutLeadingV = options.userGivenSpecifier?.replace(/^v/, '');
-            if (semver.valid(userGivenSpecifierWithoutLeadingV)) {
-                this.userGivenSpecifier = userGivenSpecifierWithoutLeadingV;
-            }
-        }
-        else {
-            this.userGivenSpecifier = options.userGivenSpecifier;
-        }
-    }
-    /**
-     * Initialize the processor by building the group graph and preparing for processing.
-     * This method must be called before processGroups().
-     */
-    async init() {
-        // Precompute project to release group mapping for O(1) lookups
-        this.setupProjectReleaseGroupMapping();
-        // Setup projects to process and resolve version actions
-        await this.setupProjectsToProcess();
-        // Precompute dependency relationships
-        await this.precomputeDependencyRelationships();
-        // Process dependency graph to find dependents to process
-        this.findDependentsToProcess();
-        // Build the group graph structure
-        for (const group of this.releaseGroups) {
-            this.groupGraph.set(group.name, {
-                group,
-                dependencies: new Set(),
-                dependents: new Set(),
-            });
-        }
-        // Process each project within each release group
-        for (const [, releaseGroupNode] of this.groupGraph) {
-            for (const projectName of releaseGroupNode.group.projects) {
-                const projectGraphNode = this.projectGraph.nodes[projectName];
-                // Check if the project has been filtered out of explicit versioning before continuing any further
-                if (!this.allProjectsToProcess.has(projectName)) {
-                    continue;
-                }
-                const versionActions = this.getVersionActionsForProject(projectName);
-                const finalConfigForProject = this.getFinalConfigForProject(projectName);
-                let latestMatchingGitTag;
-                const releaseTagPattern = releaseGroupNode.group.releaseTagPattern;
-                // Cache the last matching git tag for relevant projects
-                if (finalConfigForProject.currentVersionResolver === 'git-tag') {
-                    latestMatchingGitTag = await (0, git_1.getLatestGitTagForPattern)(releaseTagPattern, {
-                        projectName: projectGraphNode.name,
-                    }, releaseGroupNode.group.releaseTagPatternCheckAllBranchesWhen);
-                    this.cachedLatestMatchingGitTag.set(projectName, latestMatchingGitTag);
-                }
-                // Cache the current version for the project
-                const currentVersion = await (0, resolve_current_version_1.resolveCurrentVersion)(this.tree, projectGraphNode, releaseGroupNode.group, versionActions, this.projectLoggers.get(projectName), this.currentVersionsPerFixedReleaseGroup, finalConfigForProject, releaseTagPattern, latestMatchingGitTag);
-                this.cachedCurrentVersions.set(projectName, currentVersion);
-            }
-            // Ensure that there is an entry in versionData for each project being processed, even if they don't end up being bumped
-            for (const projectName of this.allProjectsToProcess) {
-                this.versionData.set(projectName, {
-                    currentVersion: this.getCurrentCachedVersionForProject(projectName),
-                    newVersion: null,
-                    dependentProjects: this.getOriginalDependentProjects(projectName),
-                });
-            }
-        }
-        // Build the dependency relationships between groups
-        this.buildGroupDependencyGraph();
-        // Topologically sort the release groups and projects for efficient processing
-        this.sortedReleaseGroups = this.topologicallySortReleaseGroups();
-        // Sort projects within each release group
-        for (const group of this.releaseGroups) {
-            this.sortedProjects.set(group.name, this.topologicallySortProjects(group));
-        }
-        // Populate the dependent projects data
-        await this.populateDependentProjectsData();
-    }
-    /**
-     * Setup mapping from project to release group and cache updateDependents settings
-     */
-    setupProjectReleaseGroupMapping() {
-        for (const group of this.releaseGroups) {
-            for (const project of group.projects) {
-                this.projectToReleaseGroup.set(project, group);
-                // Cache updateDependents setting relevant for each project
-                const updateDependents = group.version
-                    ?.updateDependents || 'auto';
-                this.projectToUpdateDependentsSetting.set(project, updateDependents);
-            }
-        }
-    }
-    /**
-     * Determine which projects should be processed and resolve their version actions
-     */
-    async setupProjectsToProcess() {
-        // Track the projects being directly versioned
-        let projectsToProcess = new Set();
-        // Precompute all projects in nx release config
-        for (const [groupName, group] of Object.entries(this.nxReleaseConfig.groups)) {
-            for (const project of group.projects) {
-                this.allProjectsConfiguredForNxRelease.add(project);
-                // Create a project logger for the project
-                this.projectLoggers.set(project, new project_logger_1.ProjectLogger(project));
-                // If group filtering is applied and the current group is captured by the filter, add the project to the projectsToProcess
-                if (this.options.filters.groups?.includes(groupName)) {
-                    projectsToProcess.add(project);
-                    // Otherwise, if project filtering is applied and the current project is captured by the filter, add the project to the projectsToProcess
-                }
-                else if (this.options.filters.projects?.includes(project)) {
-                    projectsToProcess.add(project);
-                }
-                const projectGraphNode = this.projectGraph.nodes[project];
-                /**
-                 * Try and resolve a cached ReleaseGroupWithName for the project. It may not be present
-                 * if the user filtered by group and excluded this parent group from direct versioning,
-                 * so fallback to the release group config and apply the name manually.
-                 */
-                let releaseGroup = this.projectToReleaseGroup.get(project);
-                if (!releaseGroup) {
-                    releaseGroup = {
-                        ...group,
-                        name: groupName,
-                        resolvedVersionPlans: false,
-                    };
-                }
-                // Resolve the final configuration for the project
-                const finalConfigForProject = this.resolveFinalConfigForProject(releaseGroup, projectGraphNode);
-                this.finalConfigsByProject.set(project, finalConfigForProject);
-                const { versionActionsPath, versionActions, afterAllProjectsVersioned, } = await (0, version_actions_1.resolveVersionActionsForProject)(this.tree, releaseGroup, projectGraphNode, finalConfigForProject);
-                if (!this.uniqueAfterAllProjectsVersioned.has(versionActionsPath)) {
-                    this.uniqueAfterAllProjectsVersioned.set(versionActionsPath, afterAllProjectsVersioned);
-                }
-                this.projectsToVersionActions.set(project, versionActions);
-            }
-        }
-        // If no filters are applied, process all projects
-        if (!this.options.filters.groups?.length &&
-            !this.options.filters.projects?.length) {
-            projectsToProcess = this.allProjectsConfiguredForNxRelease;
-        }
-        // If no projects are set to be processed, throw an error. This should be impossible because the filter validation in version.ts should have already caught this
-        if (projectsToProcess.size === 0) {
-            throw new Error('No projects are set to be processed, please report this as a bug on https://github.com/nrwl/nx/issues');
-        }
-        this.allProjectsToProcess = new Set(projectsToProcess);
-    }
-    /**
-     * Find all dependents that should be processed due to dependency updates
-     */
-    findDependentsToProcess() {
-        const projectsToProcess = Array.from(this.allProjectsToProcess);
-        const allTrackedDependents = new Set();
-        const dependentsToProcess = new Set();
-        // BFS traversal of dependency graph to find all transitive dependents
-        let currentLevel = [...projectsToProcess];
-        while (currentLevel.length > 0) {
-            const nextLevel = [];
-            // Get all dependents for the current level at once
-            const dependents = this.getAllNonImplicitDependents(currentLevel);
-            // Process each dependent
-            for (const dep of dependents) {
-                // Skip if we've already seen this dependent or it's already in projectsToProcess
-                if (allTrackedDependents.has(dep) ||
-                    this.allProjectsToProcess.has(dep)) {
-                    continue;
-                }
-                // Track that we've seen this dependent
-                allTrackedDependents.add(dep);
-                // If both the dependent and its dependency have updateDependents='auto',
-                // add the dependent to the projects to process
-                if (this.hasAutoUpdateDependents(dep)) {
-                    // Check if any of its dependencies in the current level have auto update
-                    const hasDependencyWithAutoUpdate = currentLevel.some((proj) => this.hasAutoUpdateDependents(proj) &&
-                        this.getProjectDependents(proj).has(dep));
-                    if (hasDependencyWithAutoUpdate) {
-                        dependentsToProcess.add(dep);
-                    }
-                }
-                // Add to next level for traversal
-                nextLevel.push(dep);
-            }
-            // Move to next level
-            currentLevel = nextLevel;
-        }
-        // Add all dependents that should be processed to allProjectsToProcess
-        dependentsToProcess.forEach((dep) => this.allProjectsToProcess.add(dep));
-    }
-    buildGroupDependencyGraph() {
-        for (const [releaseGroupName, releaseGroupNode] of this.groupGraph) {
-            for (const projectName of releaseGroupNode.group.projects) {
-                const projectDeps = this.getProjectDependencies(projectName);
-                for (const dep of projectDeps) {
-                    const dependencyGroup = this.getReleaseGroupNameForProject(dep);
-                    if (dependencyGroup && dependencyGroup !== releaseGroupName) {
-                        releaseGroupNode.dependencies.add(dependencyGroup);
-                        this.groupGraph
-                            .get(dependencyGroup)
-                            .dependents.add(releaseGroupName);
-                    }
-                }
-            }
-        }
-    }
-    async populateDependentProjectsData() {
-        for (const [projectName, dependentProjectNames] of this
-            .tmpCachedDependentProjects) {
-            const dependentProjectsData = [];
-            for (const dependentProjectName of dependentProjectNames) {
-                const versionActions = this.getVersionActionsForProject(dependentProjectName);
-                const { currentVersion, dependencyCollection } = await versionActions.readCurrentVersionOfDependency(this.tree, this.projectGraph, projectName);
-                dependentProjectsData.push({
-                    source: dependentProjectName,
-                    target: projectName,
-                    type: 'static',
-                    dependencyCollection,
-                    rawVersionSpec: currentVersion,
-                });
-            }
-            this.originalDependentProjectsPerProject.set(projectName, dependentProjectsData);
-        }
-    }
-    getReleaseGroupNameForProject(projectName) {
-        const group = this.projectToReleaseGroup.get(projectName);
-        return group ? group.name : null;
-    }
-    getNextGroup() {
-        for (const [groupName, groupNode] of this.groupGraph) {
-            if (!this.processedGroups.has(groupName) &&
-                Array.from(groupNode.dependencies).every((dep) => this.processedGroups.has(dep))) {
-                return groupName;
-            }
-        }
-        return null;
-    }
-    async processGroups() {
-        const processOrder = [];
-        // Use the topologically sorted groups instead of getNextGroup
-        for (const nextGroup of this.sortedReleaseGroups) {
-            // Skip groups that have already been processed (could happen with circular dependencies)
-            if (this.processedGroups.has(nextGroup)) {
-                continue;
-            }
-            const allDependenciesProcessed = Array.from(this.groupGraph.get(nextGroup).dependencies).every((dep) => this.processedGroups.has(dep));
-            if (!allDependenciesProcessed) {
-                // If we encounter a group whose dependencies aren't all processed,
-                // it means there's a circular dependency that our topological sort broke.
-                // We need to process any unprocessed dependencies first.
-                for (const dep of this.groupGraph.get(nextGroup).dependencies) {
-                    if (!this.processedGroups.has(dep)) {
-                        await this.processGroup(dep);
-                        this.processedGroups.add(dep);
-                        processOrder.push(dep);
-                    }
-                }
-            }
-            await this.processGroup(nextGroup);
-            this.processedGroups.add(nextGroup);
-            processOrder.push(nextGroup);
-        }
-        return processOrder;
-    }
-    flushAllProjectLoggers() {
-        for (const projectLogger of this.projectLoggers.values()) {
-            projectLogger.flush();
-        }
-    }
-    deleteProcessedVersionPlanFiles() {
-        for (const versionPlanPath of this.processedVersionPlanFiles) {
-            this.tree.delete(versionPlanPath);
-        }
-    }
-    getVersionData() {
-        return Object.fromEntries(this.versionData);
-    }
-    /**
-     * Invoke the afterAllProjectsVersioned functions for each unique versionActions type.
-     * This can be useful for performing actions like updating a workspace level lock file.
-     *
-     * Because the tree has already been flushed to disk at this point, each afterAllProjectsVersioned
-     * function is responsible for returning the list of changed and deleted files that it affected.
-     *
-     * The root level `release.version.versionActionsOptions` is what is passed in here because this
-     * is a one time action for the whole workspace. Release group and project level overrides are
-     * not applicable.
-     */
-    async afterAllProjectsVersioned(rootVersionActionsOptions) {
-        const changedFiles = new Set();
-        const deletedFiles = new Set();
-        for (const [, afterAllProjectsVersioned] of this
-            .uniqueAfterAllProjectsVersioned) {
-            const { changedFiles: changedFilesForVersionActions, deletedFiles: deletedFilesForVersionActions, } = await afterAllProjectsVersioned(this.tree.root, {
-                dryRun: this.options.dryRun,
-                verbose: this.options.verbose,
-                rootVersionActionsOptions,
-            });
-            for (const file of changedFilesForVersionActions) {
-                changedFiles.add(file);
-            }
-            for (const file of deletedFilesForVersionActions) {
-                deletedFiles.add(file);
-            }
-        }
-        return {
-            changedFiles: Array.from(changedFiles),
-            deletedFiles: Array.from(deletedFiles),
-        };
-    }
-    async processGroup(releaseGroupName) {
-        const groupNode = this.groupGraph.get(releaseGroupName);
-        const bumped = await this.bumpVersions(groupNode.group);
-        // Flush the project loggers for the group
-        for (const project of groupNode.group.projects) {
-            const projectLogger = this.getProjectLoggerForProject(project);
-            projectLogger.flush();
-        }
-        if (bumped) {
-            await this.propagateChangesToDependentGroups(releaseGroupName);
-        }
-    }
-    async propagateChangesToDependentGroups(changedReleaseGroupName) {
-        const changedGroupNode = this.groupGraph.get(changedReleaseGroupName);
-        for (const depGroupName of changedGroupNode.dependents) {
-            if (!this.processedGroups.has(depGroupName)) {
-                await this.propagateChanges(depGroupName, changedReleaseGroupName);
-            }
-        }
-    }
-    async bumpVersions(releaseGroup) {
-        if (releaseGroup.projectsRelationship === 'fixed') {
-            return this.bumpFixedVersionGroup(releaseGroup);
-        }
-        else {
-            return this.bumpIndependentVersionGroup(releaseGroup);
-        }
-    }
-    async bumpFixedVersionGroup(releaseGroup) {
-        if (releaseGroup.projects.length === 0) {
-            return false;
-        }
-        let bumped = false;
-        const firstProject = releaseGroup.projects[0];
-        const { newVersionInput, newVersionInputReason, newVersionInputReasonData, } = await this.determineVersionBumpForProject(releaseGroup, firstProject);
-        if (newVersionInput === 'none') {
-            // No direct bump for this group, but we may still need to bump if a dependency group has been bumped
-            let bumpedByDependency = false;
-            // Use sorted projects to check for dependencies in processed groups
-            const sortedProjects = this.sortedProjects.get(releaseGroup.name) || [];
-            // Iterate through each project in the release group in topological order
-            for (const project of sortedProjects) {
-                const dependencies = this.projectGraph.dependencies[project] || [];
-                for (const dep of dependencies) {
-                    const depGroup = this.getReleaseGroupNameForProject(dep.target);
-                    if (depGroup &&
-                        depGroup !== releaseGroup.name &&
-                        this.processedGroups.has(depGroup)) {
-                        const depGroupBumpType = await this.getFixedReleaseGroupBumpType(depGroup);
-                        // If a dependency group has been bumped, determine if it should trigger a bump in this group
-                        if (depGroupBumpType !== 'none') {
-                            bumpedByDependency = true;
-                            const depBumpType = this.determineSideEffectBump(releaseGroup, depGroupBumpType);
-                            await this.bumpVersionForProject(project, depBumpType, 'DEPENDENCY_ACROSS_GROUPS_WAS_BUMPED', {});
-                            this.bumpedProjects.add(project);
-                            // Update any dependencies in the manifest
-                            await this.updateDependenciesForProject(project);
-                        }
-                    }
-                }
-            }
-            // If any project in the group was bumped due to dependency changes, we must bump all projects in the fixed group
-            if (bumpedByDependency) {
-                // Update all projects in topological order
-                for (const project of sortedProjects) {
-                    if (!this.bumpedProjects.has(project)) {
-                        await this.bumpVersionForProject(project, 'patch', 'OTHER_PROJECT_IN_FIXED_GROUP_WAS_BUMPED_DUE_TO_DEPENDENCY', {});
-                        // Ensure the bump for remaining projects
-                        this.bumpedProjects.add(project);
-                        await this.updateDependenciesForProject(project);
-                    }
-                }
-            }
-            else {
-                /**
-                 * No projects in the group are being bumped, but as it stands only the first project would have an appropriate log,
-                 * therefore add in an extra log for each additional project in the group, and we also need to make sure that the
-                 * versionData is fully populated.
-                 */
-                for (const project of releaseGroup.projects) {
-                    this.versionData.set(project, {
-                        currentVersion: this.getCurrentCachedVersionForProject(project),
-                        newVersion: null,
-                        dependentProjects: this.getOriginalDependentProjects(project),
-                    });
-                    if (project === firstProject) {
-                        continue;
-                    }
-                    const projectLogger = this.getProjectLoggerForProject(project);
-                    projectLogger.buffer(`🚫 Skipping versioning for ${project} as it is a part of a fixed release group with ${firstProject} and no dependency bumps were detected`);
-                }
-            }
-            return bumpedByDependency;
-        }
-        const { newVersion } = await this.calculateNewVersion(firstProject, newVersionInput, newVersionInputReason, newVersionInputReasonData);
-        // Use sorted projects for processing projects in the right order
-        const sortedProjects = this.sortedProjects.get(releaseGroup.name) || releaseGroup.projects;
-        // First, update versions for all projects in the fixed group in topological order
-        for (const project of sortedProjects) {
-            const versionActions = this.getVersionActionsForProject(project);
-            const projectLogger = this.getProjectLoggerForProject(project);
-            const currentVersion = this.getCurrentCachedVersionForProject(project);
-            // The first project's version was determined above, so this log is only appropriate for the remaining projects
-            if (project !== firstProject) {
-                projectLogger.buffer(`❓ Applied version ${newVersion} directly, because the project is a member of a fixed release group containing ${firstProject}`);
-            }
-            /**
-             * Update the project's version based on the implementation details of the configured VersionActions
-             * and display any returned log messages to the user.
-             */
-            const logMessages = await versionActions.updateProjectVersion(this.tree, newVersion);
-            for (const logMessage of logMessages) {
-                projectLogger.buffer(logMessage);
-            }
-            this.bumpedProjects.add(project);
-            bumped = true;
-            // Populate version data for each project
-            this.versionData.set(project, {
-                currentVersion,
-                newVersion,
-                dependentProjects: this.getOriginalDependentProjects(project),
-            });
-        }
-        // Then, update dependencies for all projects in the fixed group, also in topological order
-        if (bumped) {
-            for (const project of sortedProjects) {
-                await this.updateDependenciesForProject(project);
-            }
-        }
-        return bumped;
-    }
-    async bumpIndependentVersionGroup(releaseGroup) {
-        const releaseGroupFilteredProjects = this.releaseGroupToFilteredProjects.get(releaseGroup);
-        let bumped = false;
-        const projectBumpTypes = new Map();
-        const projectsToUpdate = new Set();
-        // First pass: Determine bump types
-        for (const project of this.allProjectsToProcess) {
-            const { newVersionInput: bumpType, newVersionInputReason: bumpTypeReason, newVersionInputReasonData: bumpTypeReasonData, } = await this.determineVersionBumpForProject(releaseGroup, project);
-            projectBumpTypes.set(project, {
-                bumpType,
-                bumpTypeReason,
-                bumpTypeReasonData,
-            });
-            if (bumpType !== 'none') {
-                projectsToUpdate.add(project);
-            }
-        }
-        // Second pass: Update versions using topologically sorted projects
-        // This ensures dependencies are processed before dependents
-        const sortedProjects = this.sortedProjects.get(releaseGroup.name) || [];
-        // Process projects in topological order
-        for (const project of sortedProjects) {
-            if (projectsToUpdate.has(project) &&
-                releaseGroupFilteredProjects.has(project)) {
-                const { bumpType: finalBumpType, bumpTypeReason: finalBumpTypeReason, bumpTypeReasonData: finalBumpTypeReasonData, } = projectBumpTypes.get(project);
-                if (finalBumpType !== 'none') {
-                    await this.bumpVersionForProject(project, finalBumpType, finalBumpTypeReason, finalBumpTypeReasonData);
-                    this.bumpedProjects.add(project);
-                    bumped = true;
-                }
-            }
-        }
-        // Third pass: Update dependencies also in topological order
-        for (const project of sortedProjects) {
-            if (projectsToUpdate.has(project) &&
-                releaseGroupFilteredProjects.has(project)) {
-                await this.updateDependenciesForProject(project);
-            }
-        }
-        return bumped;
-    }
-    async determineVersionBumpForProject(releaseGroup, projectName) {
-        // User given specifier has the highest precedence
-        if (this.userGivenSpecifier) {
-            return {
-                newVersionInput: this.userGivenSpecifier,
-                newVersionInputReason: 'USER_SPECIFIER',
-                newVersionInputReasonData: {},
-            };
-        }
-        const projectGraphNode = this.projectGraph.nodes[projectName];
-        const projectLogger = this.getProjectLoggerForProject(projectName);
-        const cachedFinalConfigForProject = this.getCachedFinalConfigForProject(projectName);
-        if (cachedFinalConfigForProject.specifierSource === 'conventional-commits') {
-            const currentVersion = this.getCurrentCachedVersionForProject(projectName);
-            const bumpType = await (0, derive_specifier_from_conventional_commits_1.deriveSpecifierFromConventionalCommits)(this.nxReleaseConfig, this.projectGraph, projectLogger, releaseGroup, projectGraphNode, !!semver.prerelease(currentVersion ?? ''), this.cachedLatestMatchingGitTag.get(projectName), cachedFinalConfigForProject.fallbackCurrentVersionResolver, this.options.preid);
-            return {
-                newVersionInput: bumpType,
-                newVersionInputReason: 'CONVENTIONAL_COMMITS',
-                newVersionInputReasonData: {},
-            };
-        }
-        // Resolve the semver relative bump via version-plans
-        if (releaseGroup.versionPlans) {
-            const currentVersion = this.getCurrentCachedVersionForProject(projectName);
-            const { bumpType, versionPlanPath } = await (0, deriver_specifier_from_version_plans_1.deriveSpecifierFromVersionPlan)(projectLogger, releaseGroup, projectGraphNode, currentVersion);
-            if (bumpType !== 'none') {
-                this.processedVersionPlanFiles.add(versionPlanPath);
-            }
-            return {
-                newVersionInput: bumpType,
-                newVersionInputReason: 'VERSION_PLANS',
-                newVersionInputReasonData: {
-                    versionPlanPath,
-                },
-            };
-        }
-        // Only add the release group name to the log if it is one set by the user, otherwise it is useless noise
-        const maybeLogReleaseGroup = (log) => {
-            if (releaseGroup.name === config_1.IMPLICIT_DEFAULT_RELEASE_GROUP) {
-                return log;
-            }
-            return `${log} within release group "${releaseGroup.name}"`;
-        };
-        if (cachedFinalConfigForProject.specifierSource === 'prompt') {
-            let specifier;
-            if (releaseGroup.projectsRelationship === 'independent') {
-                specifier = await (0, resolve_semver_specifier_1.resolveSemverSpecifierFromPrompt)(`${maybeLogReleaseGroup(`What kind of change is this for project "${projectName}"`)}?`, `${maybeLogReleaseGroup(`What is the exact version for project "${projectName}"`)}?`);
-            }
-            else {
-                specifier = await (0, resolve_semver_specifier_1.resolveSemverSpecifierFromPrompt)(`${maybeLogReleaseGroup(`What kind of change is this for the ${releaseGroup.projects.length} matched projects(s)`)}?`, `${maybeLogReleaseGroup(`What is the exact version for the ${releaseGroup.projects.length} matched project(s)`)}?`);
-            }
-            return {
-                newVersionInput: specifier,
-                newVersionInputReason: 'PROMPTED_USER_SPECIFIER',
-                newVersionInputReasonData: {},
-            };
-        }
-        throw new Error(`Unhandled version bump config, please report this as a bug on https://github.com/nrwl/nx/issues`);
-    }
-    getVersionActionsForProject(projectName) {
-        const versionActions = this.projectsToVersionActions.get(projectName);
-        if (!versionActions) {
-            throw new Error(`No versionActions found for project ${projectName}, please report this as a bug on https://github.com/nrwl/nx/issues`);
-        }
-        return versionActions;
-    }
-    getFinalConfigForProject(projectName) {
-        const finalConfig = this.finalConfigsByProject.get(projectName);
-        if (!finalConfig) {
-            throw new Error(`No final config found for project ${projectName}, please report this as a bug on https://github.com/nrwl/nx/issues`);
-        }
-        return finalConfig;
-    }
-    getProjectLoggerForProject(projectName) {
-        const projectLogger = this.projectLoggers.get(projectName);
-        if (!projectLogger) {
-            throw new Error(`No project logger found for project ${projectName}, please report this as a bug on https://github.com/nrwl/nx/issues`);
-        }
-        return projectLogger;
-    }
-    getCurrentCachedVersionForProject(projectName) {
-        return this.cachedCurrentVersions.get(projectName);
-    }
-    getCachedFinalConfigForProject(projectName) {
-        const cachedFinalConfig = this.finalConfigsByProject.get(projectName);
-        if (!cachedFinalConfig) {
-            throw new Error(`Unexpected error: No cached config found for project ${projectName}, please report this as a bug on https://github.com/nrwl/nx/issues`);
-        }
-        return cachedFinalConfig;
-    }
-    /**
-     * Apply project and release group precedence and default values, as well as validate the final configuration,
-     * ready to be cached.
-     */
-    resolveFinalConfigForProject(releaseGroup, projectGraphNode) {
-        const releaseGroupVersionConfig = releaseGroup.version;
-        const projectVersionConfig = projectGraphNode.data.release?.version;
-        /**
-         * specifierSource
-         *
-         * If the user has provided a specifier, it always takes precedence,
-         * so the effective specifier source is 'prompt', regardless of what
-         * the project or release group config says.
-         */
-        const specifierSource = this.userGivenSpecifier
-            ? 'prompt'
-            : projectVersionConfig?.specifierSource ??
-                releaseGroupVersionConfig?.specifierSource ??
-                'prompt';
-        /**
-         * versionPrefix, defaults to auto
-         */
-        const versionPrefix = projectVersionConfig?.versionPrefix ??
-            releaseGroupVersionConfig?.versionPrefix ??
-            'auto';
-        if (versionPrefix && !version_1.validReleaseVersionPrefixes.includes(versionPrefix)) {
-            throw new Error(`Invalid value for versionPrefix: "${versionPrefix}"
-
-Valid values are: ${version_1.validReleaseVersionPrefixes
-                .map((s) => `"${s}"`)
-                .join(', ')}`);
-        }
-        /**
-         * currentVersionResolver, defaults to disk
-         */
-        const currentVersionResolver = projectVersionConfig?.currentVersionResolver ??
-            releaseGroupVersionConfig?.currentVersionResolver ??
-            'disk';
-        if (specifierSource === 'conventional-commits' &&
-            currentVersionResolver !== 'git-tag') {
-            throw new Error(`Invalid currentVersionResolver "${currentVersionResolver}" provided for project "${projectGraphNode.name}". Must be "git-tag" when "specifierSource" is "conventional-commits"`);
-        }
-        /**
-         * currentVersionResolverMetadata, defaults to {}
-         */
-        const currentVersionResolverMetadata = projectVersionConfig?.currentVersionResolverMetadata ??
-            releaseGroupVersionConfig?.currentVersionResolverMetadata ??
-            {};
-        /**
-         * preserveLocalDependencyProtocols
-         *
-         * This was false by default in legacy versioning, but is true by default now.
-         */
-        const preserveLocalDependencyProtocols = projectVersionConfig?.preserveLocalDependencyProtocols ??
-            releaseGroupVersionConfig?.preserveLocalDependencyProtocols ??
-            true;
-        /**
-         * fallbackCurrentVersionResolver, defaults to disk when performing a first release, otherwise undefined
-         */
-        const fallbackCurrentVersionResolver = projectVersionConfig?.fallbackCurrentVersionResolver ??
-            releaseGroupVersionConfig?.fallbackCurrentVersionResolver ??
-            // Always fall back to disk if this is the first release
-            (this.options.firstRelease ? 'disk' : undefined);
-        /**
-         * versionActionsOptions, defaults to {}
-         */
-        const versionActionsOptions = projectVersionConfig?.versionActionsOptions ??
-            releaseGroupVersionConfig?.versionActionsOptions ??
-            {};
-        const manifestRootsToUpdate = projectVersionConfig?.manifestRootsToUpdate ??
-            releaseGroupVersionConfig?.manifestRootsToUpdate ??
-            [];
-        return {
-            specifierSource,
-            currentVersionResolver,
-            currentVersionResolverMetadata,
-            fallbackCurrentVersionResolver,
-            versionPrefix,
-            preserveLocalDependencyProtocols,
-            versionActionsOptions,
-            manifestRootsToUpdate,
-        };
-    }
-    async calculateNewVersion(project, newVersionInput, // any arbitrary string, whether or not it is valid is dependent upon the version actions implementation
-    newVersionInputReason, newVersionInputReasonData) {
-        const currentVersion = this.getCurrentCachedVersionForProject(project);
-        const versionActions = this.getVersionActionsForProject(project);
-        const { newVersion, logText } = await versionActions.calculateNewVersion(currentVersion, newVersionInput, newVersionInputReason, newVersionInputReasonData, this.options.preid);
-        const projectLogger = this.getProjectLoggerForProject(project);
-        projectLogger.buffer(logText);
-        return { currentVersion, newVersion };
-    }
-    async updateDependenciesForProject(projectName) {
-        if (!this.allProjectsToProcess.has(projectName)) {
-            throw new Error(`Unable to find ${projectName} in allProjectsToProcess, please report this as a bug on https://github.com/nrwl/nx/issues`);
-        }
-        const versionActions = this.getVersionActionsForProject(projectName);
-        const cachedFinalConfigForProject = this.getCachedFinalConfigForProject(projectName);
-        const dependenciesToUpdate = {};
-        const dependencies = this.projectGraph.dependencies[projectName] || [];
-        for (const dep of dependencies) {
-            if (this.allProjectsToProcess.has(dep.target) &&
-                this.bumpedProjects.has(dep.target)) {
-                const targetVersionData = this.versionData.get(dep.target);
-                if (targetVersionData) {
-                    const { currentVersion: currentDependencyVersion } = await versionActions.readCurrentVersionOfDependency(this.tree, this.projectGraph, dep.target);
-                    if (!currentDependencyVersion) {
-                        continue;
-                    }
-                    // If preserveLocalDependencyProtocols is true, and the dependency uses a local dependency protocol, skip updating the dependency
-                    if (cachedFinalConfigForProject.preserveLocalDependencyProtocols &&
-                        (await versionActions.isLocalDependencyProtocol(currentDependencyVersion))) {
-                        continue;
-                    }
-                    let finalPrefix = '';
-                    if (cachedFinalConfigForProject.versionPrefix === 'auto') {
-                        const prefixMatch = currentDependencyVersion?.match(/^([~^=])/);
-                        finalPrefix = prefixMatch ? prefixMatch[1] : '';
-                    }
-                    else if (['~', '^', '='].includes(cachedFinalConfigForProject.versionPrefix)) {
-                        finalPrefix = cachedFinalConfigForProject.versionPrefix;
-                    }
-                    // Remove any existing prefix from the new version before applying the finalPrefix
-                    const cleanNewVersion = targetVersionData.newVersion.replace(/^[~^=]/, '');
-                    dependenciesToUpdate[dep.target] = `${finalPrefix}${cleanNewVersion}`;
-                }
-            }
-        }
-        const projectLogger = this.getProjectLoggerForProject(projectName);
-        const logMessages = await versionActions.updateProjectDependencies(this.tree, this.projectGraph, dependenciesToUpdate);
-        for (const logMessage of logMessages) {
-            projectLogger.buffer(logMessage);
-        }
-    }
-    async bumpVersionForProject(projectName, bumpType, bumpTypeReason, bumpTypeReasonData) {
-        const projectLogger = this.getProjectLoggerForProject(projectName);
-        if (bumpType === 'none') {
-            projectLogger.buffer(`⏩ Skipping bump for ${projectName} as bump type is "none"`);
-            return;
-        }
-        const versionActions = this.getVersionActionsForProject(projectName);
-        const { currentVersion, newVersion } = await this.calculateNewVersion(projectName, bumpType, bumpTypeReason, bumpTypeReasonData);
-        /**
-         * Update the project's version based on the implementation details of the configured VersionActions
-         * and display any returned log messages to the user.
-         */
-        const logMessages = await versionActions.updateProjectVersion(this.tree, newVersion);
-        for (const logMessage of logMessages) {
-            projectLogger.buffer(logMessage);
-        }
-        // Update version data and bumped projects
-        this.versionData.set(projectName, {
-            currentVersion,
-            newVersion,
-            dependentProjects: this.getOriginalDependentProjects(projectName),
-        });
-        this.bumpedProjects.add(projectName);
-        // Find the release group for this project
-        const releaseGroupName = this.getReleaseGroupNameForProject(projectName);
-        if (!releaseGroupName) {
-            projectLogger.buffer(`⚠️ Cannot find release group for ${projectName}, skipping dependent updates`);
-            return;
-        }
-        const releaseGroup = this.groupGraph.get(releaseGroupName).group;
-        const releaseGroupVersionConfig = releaseGroup.version;
-        // Get updateDependents from the release group level config
-        const updateDependents = releaseGroupVersionConfig?.updateDependents ||
-            'auto';
-        // Only update dependencies for dependents if the group's updateDependents is 'auto'
-        if (updateDependents === 'auto') {
-            const dependents = this.getNonImplicitDependentsForProject(projectName);
-            await this.updateDependenciesForDependents(dependents);
-            for (const dependent of dependents) {
-                if (this.allProjectsToProcess.has(dependent) &&
-                    !this.bumpedProjects.has(dependent)) {
-                    await this.bumpVersionForProject(dependent, 'patch', 'DEPENDENCY_WAS_BUMPED', {});
-                }
-            }
-        }
-        else {
-            const releaseGroupText = releaseGroupName !== config_1.IMPLICIT_DEFAULT_RELEASE_GROUP
-                ? ` in release group "${releaseGroupName}" `
-                : ' ';
-            projectLogger.buffer(`⏩ Skipping dependent updates as "updateDependents"${releaseGroupText}is not "auto"`);
-        }
-    }
-    async updateDependenciesForDependents(dependents) {
-        for (const dependent of dependents) {
-            if (!this.allProjectsToProcess.has(dependent)) {
-                throw new Error(`Unable to find project "${dependent}" in allProjectsToProcess, please report this as a bug on https://github.com/nrwl/nx/issues`);
-            }
-            await this.updateDependenciesForProject(dependent);
-        }
-    }
-    getOriginalDependentProjects(project) {
-        return this.originalDependentProjectsPerProject.get(project) || [];
-    }
-    async propagateChanges(releaseGroupName, changedDependencyGroup) {
-        const releaseGroup = this.groupGraph.get(releaseGroupName).group;
-        const releaseGroupFilteredProjects = this.releaseGroupToFilteredProjects.get(releaseGroup);
-        // Get updateDependents from the release group level config
-        const releaseGroupVersionConfig = releaseGroup.version;
-        const updateDependents = releaseGroupVersionConfig?.updateDependents ||
-            'auto';
-        // If updateDependents is not 'auto', skip propagating changes to this group
-        if (updateDependents !== 'auto') {
-            const projectLogger = this.getProjectLoggerForProject(releaseGroupFilteredProjects.values().next().value);
-            projectLogger.buffer(`⏩ Skipping dependency updates for release group "${releaseGroupName}" as "updateDependents" is not "auto"`);
-            return;
-        }
-        let groupBumped = false;
-        let bumpType = 'none';
-        if (releaseGroup.projectsRelationship === 'fixed') {
-            // For fixed groups, we only need to check one project
-            const project = releaseGroupFilteredProjects[0];
-            const dependencies = this.projectGraph.dependencies[project] || [];
-            const hasDependencyInChangedGroup = dependencies.some((dep) => this.getReleaseGroupNameForProject(dep.target) ===
-                changedDependencyGroup);
-            if (hasDependencyInChangedGroup) {
-                const dependencyBumpType = await this.getFixedReleaseGroupBumpType(changedDependencyGroup);
-                bumpType = this.determineSideEffectBump(releaseGroup, dependencyBumpType);
-                groupBumped = bumpType !== 'none';
-            }
-        }
-        if (groupBumped) {
-            for (const project of releaseGroupFilteredProjects) {
-                if (!this.bumpedProjects.has(project)) {
-                    await this.bumpVersionForProject(project, bumpType, 'DEPENDENCY_ACROSS_GROUPS_WAS_BUMPED', {});
-                    this.bumpedProjects.add(project);
-                }
-            }
-        }
-    }
-    async getFixedReleaseGroupBumpType(releaseGroupName) {
-        const releaseGroup = this.groupGraph.get(releaseGroupName).group;
-        const releaseGroupFilteredProjects = this.releaseGroupToFilteredProjects.get(releaseGroup);
-        if (releaseGroupFilteredProjects.size === 0) {
-            return 'none';
-        }
-        const { newVersionInput } = await this.determineVersionBumpForProject(releaseGroup, 
-        // It's a fixed release group, so we can just pick any project in the group
-        releaseGroupFilteredProjects.values().next().value);
-        return newVersionInput;
-    }
-    // TODO: Support influencing the side effect bump in a future version, always patch for now like in legacy versioning
-    determineSideEffectBump(releaseGroup, dependencyBumpType) {
-        const sideEffectBump = 'patch';
-        return sideEffectBump;
-    }
-    getProjectDependents(project) {
-        return this.projectToDependents.get(project) || new Set();
-    }
-    getAllNonImplicitDependents(projects) {
-        return projects
-            .flatMap((project) => {
-            const dependentProjectNames = this.getNonImplicitDependentsForProject(project);
-            this.tmpCachedDependentProjects.set(project, dependentProjectNames);
-            return dependentProjectNames;
-        })
-            .filter((dep) => !this.allProjectsToProcess.has(dep));
-    }
-    getNonImplicitDependentsForProject(project) {
-        // Use the cached dependents for O(1) lookup instead of O(n) scan
-        return Array.from(this.getProjectDependents(project));
-    }
-    hasAutoUpdateDependents(projectName) {
-        return this.projectToUpdateDependentsSetting.get(projectName) === 'auto';
-    }
-    topologicallySortReleaseGroups() {
-        // Get all release group names
-        const groupNames = Array.from(this.groupGraph.keys());
-        // Function to get dependencies of a group
-        const getGroupDependencies = (groupName) => {
-            const groupNode = this.groupGraph.get(groupName);
-            if (!groupNode) {
-                return [];
-            }
-            return Array.from(groupNode.dependencies);
-        };
-        // Perform topological sort
-        return (0, topological_sort_1.topologicalSort)(groupNames, getGroupDependencies);
-    }
-    topologicallySortProjects(releaseGroup) {
-        // For fixed relationship groups, the order doesn't matter since all projects will
-        // be versioned identically, but we still sort them for consistency
-        const projects = releaseGroup.projects.filter((p) => 
-        // Only include projects that are in allProjectsToProcess
-        this.allProjectsToProcess.has(p));
-        // Function to get dependencies of a project that are in the same release group
-        const getProjectDependenciesInSameGroup = (project) => {
-            const deps = this.getProjectDependencies(project);
-            // Only include dependencies that are in the same release group and in allProjectsToProcess
-            return Array.from(deps).filter((dep) => this.getReleaseGroupNameForProject(dep) === releaseGroup.name &&
-                this.allProjectsToProcess.has(dep));
-        };
-        // Perform topological sort
-        return (0, topological_sort_1.topologicalSort)(projects, getProjectDependenciesInSameGroup);
-    }
-    /**
-     * Precompute project -> dependents/dependencies relationships for O(1) lookups
-     */
-    async precomputeDependencyRelationships() {
-        for (const projectName of this.allProjectsConfiguredForNxRelease) {
-            const versionActions = this.projectsToVersionActions.get(projectName);
-            // Create a new set for this project's dependencies
-            if (!this.projectToDependencies.has(projectName)) {
-                this.projectToDependencies.set(projectName, new Set());
-            }
-            const deps = await versionActions.readDependencies(this.tree, this.projectGraph);
-            for (const dep of deps) {
-                // Skip dependencies not covered by nx release
-                if (!this.allProjectsConfiguredForNxRelease.has(dep.target)) {
-                    continue;
-                }
-                // Add this dependency to the project's dependencies
-                this.projectToDependencies.get(projectName).add(dep.target);
-                // Add this project as a dependent of the target
-                if (!this.projectToDependents.has(dep.target)) {
-                    this.projectToDependents.set(dep.target, new Set());
-                }
-                this.projectToDependents.get(dep.target).add(projectName);
-            }
-        }
-    }
-    getProjectDependencies(project) {
-        return this.projectToDependencies.get(project) || new Set();
-    }
-}
-exports.ReleaseGroupProcessor = ReleaseGroupProcessor;