Add nf-co2footprint plugin for emissions tracking

[edmundmiller]

Summary

Enables CO2 footprint tracking during nf-test runs and uploads reports to S3 for analysis.

• Adds [email protected] plugin to test configuration
• Uploads all CO2 trace files to S3 after each test shard completes
• Organizes reports by date/branch/profile/shard for easy querying with DuckDB

Changes

Configuration

• tests/config/nf-test.config: Added nf-co2footprint plugin

CI/CD

• .github/workflows/nf-test.yml: Added S3 upload step for CO2 reports
  • Finds all co2footprint_trace*.txt files per shard
  • Uploads to s3://nf-core-resource-optimization/co2reports/modules/YYYY-MM-DD/branch-name/profile/shard/
  • Runs even if tests fail (uses if: always())

S3 Report Structure

Reports are organized for analysis:

s3://nf-core-resource-optimization/co2reports/modules/
  └── 2025-10-29/
      └── co2-footprint-tracking/
          └── docker/
              └── 1/
                  ├── co2footprint_trace.txt
                  └── co2footprint_trace_*.txt

Report Format

Each trace file contains TSV data with:

• task_id, status, name
• energy_consumption, CO2e, CO2e_market, carbon_intensity
• %cpu, memory, realtime, cpus
• powerdraw_cpu, cpu_model

Testing

• Verify plugin loads successfully
• Confirm CO2 reports are generated during test runs
• Check S3 uploads complete successfully
• Validate report structure for DuckDB compatibility

Refs: #9291

🤖 Generated with Claude Code

Co-Authored-By: Claude [email protected]