[Message Prioritization] - Add currentReplicaNumber metadata for message prioritization

[csudharsanan]

Issues

• My PR addresses the following Helix issues and references them in the PR description:

  Fixes Prioritize upward state transitions to improve recovery time #3042

Description

• Here are some details about my PR, including screenshots of any UI changes:

  Enhances Helix's message generation phase to prioritize upward state transitions from non-second top states to second top or top states.

Tests

• The following tests are written for this issue:

  TestPrioritizationMessageGeneration

• The following is the result of the "mvn test" command on the appropriate module:

Changes that Break Backward Compatibility (Optional)

• My PR contains changes that break backward compatibility or previous assumptions for certain methods or API. They include:

N/A

Documentation (Optional)

N/A

Commits

• My commits all reference appropriate Apache Helix GitHub issues in their subject lines. In addition, my commits follow the guidelines from "How to write a good git commit message":
  1. Subject is separated from body by a blank line
  2. Subject is limited to 50 characters (not including Jira issue reference)
  3. Subject does not end with a period
  4. Subject uses the imperative mood ("add", not "adding")
  5. Body wraps at 72 characters
  6. Body explains "what" and "why", not "how"

Code Quality

• My diff has been formatted using helix-style.xml
  (helix-style-intellij.xml if IntelliJ IDE is used)

[csudharsanan]

New test results.

[INFO] Tests run: 6, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.801 s - in org.apache.helix.controller.stages.TestPrioritizationMessageGeneration
[INFO] 
[INFO] Results:
[INFO] 
[INFO] Tests run: 6, Failures: 0, Errors: 0, Skipped: 0
[INFO] 
[INFO] 
[INFO] --- jacoco:0.8.6:report (generate-code-coverage-report) @ helix-core ---
[INFO] Loading execution data file /Users/csudhars/helix/helix-core/target/jacoco.exec
[INFO] Analyzed bundle 'Apache Helix :: Core' with 960 classes
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  11.204 s
[INFO] Finished at: 2025-06-05T18:54:24-07:00
[INFO] ------------------------------------------------------------------------

[xyuanlu]

Generally LGTM, please address format issue and some code clean

[csudharsanan]

Generally LGTM, please address format issue and some code clean

Hey @xyuanlu updated the PR after the last comment. could you please approve this when you get a chance. thanks

[xyuanlu]

LGTM. Thanks for addressing all comments :D

[csudharsanan]

Thanks for the review. The PR is approved by @xyuanlu . Final commit message: "Add currentReplicaNumber metadata for message prioritization by client".