refactor: Move ParticleSvc to services library and separate interface from implementation

[Copilot]

Briefly, what does this PR introduce?

This PR addresses issue #1951 by refactoring the ParticleSvc to significantly improve compilation performance while moving the service to the appropriate location in the codebase. The large kParticleMap (250+ particle entries) has been moved from the header file to a separate implementation file, eliminating the need for GCC compilation pragmas and reducing header bloat.

Problem Statement

The current ParticleSvc.h contains a large inline static const ParticleMap kParticleMap with 250+ particle definitions that gets included in every downstream compilation unit. This significantly slows compilation, requiring GCC pragmas as a workaround:

#pragma GCC optimize("no-var-tracking") // to speed up compilation
inline static const ParticleMap kParticleMap{
    // 250+ particle entries here
};

Solution

Architectural Changes:

• Moved ParticleSvc from src/algorithms/interfaces/ to src/services/particle/
• Separated interface from implementation using factory pattern
• Created lightweight header with implementation in separate translation unit

Before (297 lines):

// ParticleSvc.h - everything in header
class ParticleSvc {
  inline static const ParticleMap kParticleMap{
    // 250+ particles defined here - included in every compilation unit
  };
};

After (40 lines header + 268 lines implementation):

// ParticleSvc.h - lightweight interface only
class ParticleSvc {
  virtual void init(std::shared_ptr<ParticleMap> map = nullptr);
  // ... other interface methods
private:
  static const ParticleMap& getDefaultParticleMap(); // Implemented in .cc
};

// ParticleSvc.cc - implementation with particle data
const ParticleSvc::ParticleMap& ParticleSvc::getDefaultParticleMap() {
  static const ParticleMap kParticleMap{
    // All 250+ particles here - compiled once
  };
  return kParticleMap;
}

Performance Impact

• Header size reduction: 297 → 40 lines (86% reduction)
• Compilation: 250+ particle entries no longer parsed in every downstream file
• Build time: Should significantly improve compilation performance
• Memory: Reduced preprocessor memory usage during compilation

API Compatibility

✅ Zero breaking changes - maintains identical public interface
✅ Backward compatibility - old include path forwards to new location
✅ Same functionality - all existing behavior preserved

Files Changed

New Structure:

src/services/particle/
├── CMakeLists.txt           # Build configuration
├── ParticleSvc.h            # Lightweight interface (40 lines)
└── ParticleSvc.cc           # Implementation with particle map (268 lines)

Updated Dependencies:

• 6+ CMakeLists.txt files updated with particle_service_library dependency
• 18+ source files updated to use new include path
• Build system properly configured for new service library

Migration Path

Immediate: No action required - backward compatibility maintained via forwarding header

Recommended: Update includes from:

#include <algorithms/interfaces/ParticleSvc.h>  // old
#include <services/particle/ParticleSvc.h>      // new

What kind of change does this PR introduce?

• Performance improvement (issue Move kParticleMap into library translation unit and move ParticleSvc to services #1951)
• Code refactoring (better architecture)
• Build system optimization

Please check if this PR fulfills the following:

• Maintains API compatibility
• Build configuration updated
• No breaking changes for downstream users
• Addresses compilation performance issues

Does this PR introduce breaking changes?

No. Full backward compatibility is maintained through a forwarding header at the original location.

Does this PR change default behavior?

No. All existing functionality and behavior is preserved exactly as before.

Result: This refactoring successfully eliminates the large particle map from downstream compilation units while moving ParticleSvc to the services library as requested, providing significant compilation performance improvements without any breaking changes.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[wdconinc]

@copilot Please sort the headers such that the new services/particle/ParticleSvc.h header comes alphabetically after the other listed headers in algorithms/.

[Copilot]

@copilot Please sort the headers such that the new services/particle/ParticleSvc.h header comes alphabetically after the other listed headers in algorithms/.

Sorted headers alphabetically so that services/particle/ParticleSvc.h now comes after algorithms/ headers in all include blocks. Updated 9 files with proper alphabetical ordering. Commit: a57ef76

[github-actions]

Capybara summary for PR 2032

• rec_dis_10x100_minQ2=0_craterlake_10x100
• rec_dis_10x100_minQ2=1000_craterlake_tracking_only
• rec_dis_18x275_minQ2=0_craterlake_18x275
• rec_dis_18x275_minQ2=0_craterlake_18x275_MT
• rec_dis_18x275_minQ2=0_craterlake_18x275_ST_MT
• rec_dis_18x275_minQ2=1000_craterlake_18x275
• rec_dis_18x275_minQ2=1000_craterlake_18x275_MT
• rec_dis_18x275_minQ2=1000_craterlake_18x275_ST_MT
• rec_dis_5x41_minQ2=0_craterlake_5x41
• rec_e_1GeV_20GeV_craterlake
• rec_pi_1GeV_20GeV_craterlake
  ^{_{Last updated 2025-08-22T21:19-04:00 a57ef76}}