v0.3.15: crash fixes, NVML build fix, doctor overhaul, measurement consistency

Crash fixes:
- Fix core dump when RAPL permission denied (try/catch in C API boundary)
- Fix os.geteuid() crash on Windows
- Fix NEMB session leak on subprocess timeout
- Handle TimeoutExpired in all measurement backends

NVML / GPU:
- Pass HAVE_NVML compile definition to codegreen-nemb target (was always stubs)
- Add Windows NVML search paths
- GPU detection in doctor command

Measurement accuracy:
- Consistent capture_output across JSON/human modes (was 22% discrepancy)
- RAPL provider skips inaccessible domains instead of failing entirely
- JSON budget exit code fixed (was exit 0 when exceeded)

CLI improvements:
- Doctor checks NEMB library, energy backend, RAPL perms, GPU, live sensor test
- No silent fallbacks: refuses to run without real energy backend
- Permission check before measurement with actionable fix instructions
- JSON output: backend, domains, cv_percent, power_watts, outliers_removed
- Command grouping: Measurement/Setup/Diagnostics/Validation panels
- Config command: --edit creates user override, --reset reverts to defaults
- --include-warmup flag, --repeat validation, CV N/A for n<3
- JavaScript added to Language enum

Build & packaging:
- cmake errors visible under pip install (stderr with captured output)
- Python 3.14 classifier, min version 3.9
- Version via importlib.metadata (single source of truth)
- Config path alignment between Python CLI and NEMB C++ backend
- Production defaults in config.json

Documentation:
- 57+ doc issues fixed (license, broken commands, stale versions, help text)
- Changelog entries for v0.3.11-v0.3.15

Author: saurabh-singh-rajput

CITATION.cff

@@ -1,11 +1,13 @@
-cff-version: 1.1.0
+cff-version: 1.2.0
 message: "If you use this software, please cite it as below."
 authors:
 - family-names: Rajput
   given-names: Saurabhsingh
-orcid: https://orcid.org/0000-0002-4630-2288
-title: "CodeGreen: A Modular Energy Measurement System for Multi-Language Software"
-version: v0.1.0
+  orcid: https://orcid.org/0000-0002-4630-2288
+- family-names: Sharma
+  given-names: Tushar
+title: "CodeGreen: Towards Improving Precision and Portability in Software Energy Measurement"
+version: v0.3.15
 date-released: 2026-01-26
 url: "https://smart-dal.github.io/codegreen/"
 doi: 10.5281/zenodo.18371772

CMakeLists.txt

@@ -16,8 +16,12 @@ find_package(PkgConfig)
 find_package(Threads REQUIRED)
 
 # Optional GPU library detection
-find_library(NVML_LIBRARY nvidia-ml PATHS /usr/local/cuda/lib64 /usr/lib/x86_64-linux-gnu)
-find_path(NVML_INCLUDE_DIR nvml.h PATHS /usr/local/cuda/include /usr/include/nvidia/gdk)
+find_library(NVML_LIBRARY nvidia-ml PATHS
+    /usr/local/cuda/lib64 /usr/lib/x86_64-linux-gnu
+    "C:/Windows/System32" "$ENV{ProgramFiles}/NVIDIA Corporation/NVSMI")
+find_path(NVML_INCLUDE_DIR nvml.h PATHS
+    /usr/local/cuda/include /usr/include/nvidia/gdk
+    "$ENV{CUDA_PATH}/include")
 find_library(ROCM_SMI_LIBRARY rocm_smi64 PATHS /opt/rocm/lib)
 find_path(ROCM_SMI_INCLUDE_DIR rocm_smi.h PATHS /opt/rocm/include/rocm_smi)
 

INSTALL.md

@@ -47,8 +47,8 @@ codegreen doctor
 
 **Required:**
 - Linux (Ubuntu 20.04+, Debian 11+, Fedora 35+)
-- Python 3.8 or higher
-- CMake 3.15+
+- Python 3.9 or higher
+- CMake 3.16+
 - C++ compiler (gcc 9+ or clang 10+)
 - Make
 
@@ -137,9 +137,9 @@ codegreen info
 codegreen doctor
 ```
 
-Run benchmark:
+Test energy measurement:
 ```bash
-codegreen benchmark cpu_stress --duration 5
+codegreen run --repeat 3 -- python3 -c "sum(range(10**7))"
 ```
 
 ---

README.md

@@ -96,7 +96,7 @@ JSON (default for `--json`), CSV, Markdown table, and text summary. The JSON out
 
 Adding a new language requires only a JSON config file in `codegreen/instrumentation/configs/` plus the tree-sitter grammar. No Python code changes needed.
 
-Currently supported: Python, C, C++, JavaScript, Java.
+Currently supported: Python, C, C++, Java. JavaScript config exists but is not yet exposed via CLI.
 
 ## Benchmarking
 

codegreen/__init__.py

@@ -1,14 +1,21 @@
 """
-CodeGreen: Energy-aware software development tool
+CodeGreen: Know the true energy cost of your code.
 
-A comprehensive energy measurement and code optimization tool for developers
-and researchers who need precise, fine-grained energy consumption analysis.
+Precise, hardware-level energy measurement for any program. Reads directly
+from CPU and GPU energy counters (Intel/AMD RAPL, NVIDIA NVML, Apple
+IOReport, Windows EMI). No estimation, no modeling -- just what the
+hardware reports. Per-domain attribution, function-level profiling,
+statistical analysis, and CI/CD-ready JSON output.
 """
 
-__version__ = "0.3.14"
+try:
+    from importlib.metadata import version as _pkg_version
+    __version__ = _pkg_version("codegreen")
+except Exception:
+    __version__ = "0.3.15"  # fallback for dev/editable installs
 __author__ = "Saurabhsingh Rajput"
 __email__ = "saurabh@dal.ca"
-__description__ = "Energy-aware software development tool"
+__description__ = "Know the true energy cost of your code -- hardware-level measurement via RAPL, NVML, IOReport, EMI"
 
 # Ensure package root is on sys.path for imports
 import sys as _sys