[PWGCF] Hadron Associated Particle Correlation Task added

[rahulverma012]

Adds a new hadron-associated particle correlation task with same-event and mixed-event analysis for hadrons, identified particles, and resonances, including configurable selections, PID, QA, and correlation histograms.

[github-actions]

O2 linter results: ❌ 0 errors, ⚠️ 1 warnings, 🔕 2 disabled

[alibuild]

Error while checking build/O2Physics/code-check for 6030614 at 2026-10-06 20:38:

## sw/BUILD/O2Physics-code-check-latest/log
--
========== List of issues found ==========
++ echo 'Found 2 errors and 6 warnings.'
Found 2 errors and 6 warnings.
++ [[ 2 -gt 0 ]]
++ cat /sw/BUILD/2f1ac3c6480ef753c0d0b8909055da6efd9c5463/O2Physics-code-check/errors.txt
PWGCF/TwoParticleCorrelations/Tasks/hParticleCorrelation.cxx:3307:9: error: variable 'nTrigger' set but not used [clang-diagnostic-unused-but-set-variable,-warnings-as-errors]
PWGCF/TwoParticleCorrelations/Tasks/hParticleCorrelation.cxx:3501:7: error: Value stored to 'nTrack' is never read [clang-analyzer-deadcode.DeadStores,-warnings-as-errors]
++ [[ 6 -gt 0 ]]
++ cat /sw/BUILD/2f1ac3c6480ef753c0d0b8909055da6efd9c5463/O2Physics-code-check/warnings.txt
PWGCF/TwoParticleCorrelations/Tasks/hParticleCorrelation.cxx:2835:38: warning: repeated branch body in conditional chain [bugprone-branch-clone]
PWGCF/TwoParticleCorrelations/Tasks/hParticleCorrelation.cxx:2843:69: warning: repeated branch body in conditional chain [bugprone-branch-clone]
PWGCF/TwoParticleCorrelations/Tasks/hParticleCorrelation.cxx:2855:70: warning: repeated branch body in conditional chain [bugprone-branch-clone]
PWGCF/TwoParticleCorrelations/Tasks/hParticleCorrelation.cxx:4564:38: warning: repeated branch body in conditional chain [bugprone-branch-clone]
PWGCF/TwoParticleCorrelations/Tasks/hParticleCorrelation.cxx:4572:69: warning: repeated branch body in conditional chain [bugprone-branch-clone]
PWGCF/TwoParticleCorrelations/Tasks/hParticleCorrelation.cxx:4584:70: warning: repeated branch body in conditional chain [bugprone-branch-clone]
++ [[ 2 -gt 0 ]]
++ exit 1
--

Full log here.