fix: skip uncorrectable RAPL counter wraps

[davidberenstein1957]

Closes #1309

What changed

RAPLFile.delta() now re-checks the wrap correction: if the corrected reading is still below the previous one, the sample is dropped (zero energy delta, zero power) with a warning, instead of emitting a negative energy delta.

Why

max_energy_range_uj is set to 0 whenever it cannot be read (codecarbon/core/rapl.py:45). The comment claims wrap detection is then disabled, but only the correction was disabled — the wrap branch still ran and produced energy_delta = energy - last_energy, a large negative value (up to -1.19e-3 kWh for a 2^32 uJ package domain). That flows unchecked into _total_energy / _total_cpu_energy, and the abs() in Power.from_energies_and_delay masks it in the power column.

The same guard also covers the other sources of a backwards counter: driver resets, suspend/resume, and the _get_value() transient-error fallback that returns 0. It mirrors what codecarbon/core/windows_emi.py:566-574 already does for EMI.

Dropping a sample loses at most one interval of genuine energy — strictly better than subtracting an hour's worth. Systems where max_energy_range_uj is readable are unaffected.

Verification

tests/test_rapl_permissions.py:

• test_rapl_wraparound_without_max_skips_sample — fails on master (energy_delta.kWh is about -1.11e-3), passes here.
• test_rapl_wraparound_with_max_is_corrected — pins the existing wrap correction against regression.

uv run pytest tests/test_rapl_permissions.py -q → 2 passed, 2 skipped (the pre-existing Linux-only cases). black --check clean; ruff reports only pre-existing findings in the touched files.

Merge order

This should land before the rapl_include_dram change: DRAM domains have smaller max ranges and wrap far more often, which makes this defect fire much more frequently.

🤖 Generated with Claude Code

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 91.62%. Comparing base (3ec31a0) to head (f59ac22).

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1321      +/-   ##
==========================================
+ Coverage   91.43%   91.62%   +0.18%     
==========================================
  Files          49       49              
  Lines        5057     5072      +15     
==========================================
+ Hits         4624     4647      +23     
+ Misses        433      425       -8     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.