[Tooling] Use Release Version from ReleasesV2 in Code Freeze (#24929)

* Add release version validation during code freeze

* Use the version passed to the lane as the source of truth

* Update code freeze lane documentation

* Add improvements based on PR comments

---------

Co-authored-by: Olivier Halligon <[email protected]>

Author: iangmaia

.buildkite/release-pipelines/code-freeze.yml

@@ -22,7 +22,7 @@ steps:
       bundle exec fastlane run configure_apply
 
       echo '--- :shipit: Run code freeze'
-      bundle exec fastlane code_freeze skip_confirm:true
+      bundle exec fastlane code_freeze version:"${RELEASE_VERSION}" skip_confirm:true
     retry:
       manual:
         # If those jobs fail, one should always prefer re-triggering a new build from ReleaseV2 rather than retrying the individual job from Buildkite

fastlane/lanes/release.rb

@@ -9,16 +9,33 @@
   # - Extracts the Release Notes
   # - Freezes the GitHub milestone and enables the GitHub branch protection for the new branch
   #
-  # @option [Boolean] skip_confirm (default: false) If true, avoids any interactive prompt
+  # @param [Boolean] skip_confirm (default: false) If true, avoids any interactive prompt
+  # @param [String] version (optional) The version to use for the new release version to code freeze for.
+  #                 Typically auto-provided by ReleasesV2. If nil, computes the new version based on current one.
   #
-  desc 'Executes the initial steps needed during code freeze'
-  lane :code_freeze do |options|
+  lane :code_freeze do |skip_confirm: false, version: nil|
     ensure_git_status_clean
 
     # Check out the up-to-date default branch, the designated starting point for the code freeze
     Fastlane::Helper::GitHelper.checkout_and_pull(DEFAULT_BRANCH)
 
-    release_branch_name = compute_release_branch_name(options: options, version: release_version_next)
+    # Use provided version from release tool, or fall back to computed version
+    computed_version = release_version_next
+    provided_version = version
+    new_version = provided_version || computed_version
+
+    # Warn if provided version differs from computed version
+    if provided_version && provided_version != computed_version
+      warning_message = <<~WARNING
+        ⚠️ Version mismatch: The explicitly-provided version was '#{provided_version}' while new computed version would have been '#{computed_version}'.
+        If this is unexpected, you might want to investigate the discrepency.
+        Continuing with the explicitly-provided verison '#{provided_version}'.
+      WARNING
+      UI.important(warning_message)
+      buildkite_annotate(style: 'warning', context: 'code-freeze-version-mismatch', message: warning_message) if is_ci
+    end
+
+    release_branch_name = compute_release_branch_name(options: { version: version, skip_confirm: skip_confirm }, version: new_version)
     ensure_branch_does_not_exist!(release_branch_name)
 
     # The `release_version_next` is used as the `new internal release version` value because the external and internal
@@ -28,14 +45,12 @@
       • New release branch from #{DEFAULT_BRANCH}: #{release_branch_name}
 
       • Current release version and build code: #{release_version_current} (#{build_code_current}).
-      • New release version and build code: #{release_version_next} (#{build_code_code_freeze}).
+      • New release version and build code: #{new_version} (#{build_code_code_freeze}).
     MESSAGE
 
     UI.important(message)
 
-    skip_user_confirmation = options[:skip_confirm]
-
-    UI.user_error!('Aborted by user request') unless skip_user_confirmation || UI.confirm('Do you want to continue?')
+    UI.user_error!('Aborted by user request') unless skip_confirm || UI.confirm('Do you want to continue?')
 
     UI.message 'Creating release branch...'
     Fastlane::Helper::GitHelper.create_branch(release_branch_name, from: DEFAULT_BRANCH)
@@ -51,8 +66,6 @@
 
     commit_version_and_build_files
 
-    new_version = release_version_current
-
     release_notes_source_path = File.join(PROJECT_ROOT_FOLDER, 'RELEASE-NOTES.txt')
     extract_release_notes_for_version(
       version: new_version,