feat(metrics): Add sustained and fast energy impact ranking

[bigtomcat6]

Summary

This branch improves Energy Impact metric reporting by introducing sustained-energy
ranking and clearer provisional labeling.

• Add a sustained energy window and separate fast-vs-sustained impact scoring logic so sustained activity is no longer collapsed into only transient spikes.
• Rank both fast and sustained impact values so ordering in Energy Impact views reflects the stronger of the two profiles.
• Label provisional impact values explicitly when the underlying score should be treated as non-final or non-committal.
• Propagate the new behavior across publication state, sampling, statistics, and presentation models, and update unit tests to cover the new ranking and presentation paths.

How to test

• Review changes in:
  • Sources/MacActivityApp/Models/EnergyImpactPresentation.swift
  • Sources/MacActivityCore/Metrics/Providers/EnergyImpactPublicationState.swift
  • Sources/MacActivityCore/Metrics/Providers/EnergyImpactSampler.swift
  • Sources/MacActivityCore/Metrics/Providers/EnergyImpactStatistics.swift
  • Sources/MacActivityCore/Metrics/Providers/EnergyImpactTypes.swift
• Run focused tests (environment-specific):
  • swift test --filter EnergyImpact (blocked in this sandbox due Swift toolchain cache permission errors: /Users/how/.cache/clang/ModuleCache)

Release impact

• Type: Added
• Release note: Energy Impact now supports sustained impact ranking alongside fast impact ranking, with provisional labels shown for low-confidence values so users can distinguish stable energy behavior from transient spikes.

Checklist

• I have seen this code, I have run this code, and I take responsibility for this code.
• PR title follows type(scope): Summary.
• Tests or a clear manual verification path are included.
• User-facing changes include release-note wording or Release impact: None.

[bigtomcat6]

@codex review

[codecov]

Codecov Report

❌ Patch coverage is 99.22879% with 3 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...tyCore/Metrics/Providers/EnergyImpactSampler.swift	99.01%	2 Missing ⚠️
...ore/Metrics/Providers/EnergyImpactStatistics.swift	99.06%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ccd862433f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[bigtomcat6]

reviewed