Repository reference

Project root

5 files▾

Overview

Start with the product brief and repository contract.

1▾

README.md
project root

Build and packaging

Native build graph and Python packaging entry points.

2▾

Repository policy

Ignore rules and licensing metadata for the whole project.

2▾

Python wrapper

6 files▾

Entry points

Package marker and the Python CLI command surface.

2▾

Configuration

Default values and runtime settings for the Python wrapper.

2▾

Output

Terminal printing and report shaping for Python-facing flows.

2▾

Native commands

8 files▾

Entry point

Top-level native executable dispatch.

1▾

main.cpp
src

Check command

Interface and implementation for inspection-only checks.

2▾

Doctor command

Interface and implementation for diagnosis and repair flows.

2▾

Planned commands

Reserved files for build, setup, and validate behaviors.

3▾

Native core

16 files▾

Reporting and process

Core report types and subprocess execution primitives.

3▾

Platform and hardware detection

Host, driver, GPU, and CUDA environment discovery.

8▾

Repair and build helpers

Configuration, repo patching, and builder orchestration.

5▾

Kernels and UI

9 files▾

Elementwise kernel

Simple elementwise CUDA sample and shared declarations.

2▾

Memory benchmark

Memory transfer benchmarking kernels and declarations.

2▾

Reduction kernel

Reduction sample kernels and matching headers.

2▾

UI layer

Terminal placeholders and native report rendering.

3▾

Automation and tests

11 files▾

Automation

Bootstrap helpers and Docker environments for local reproduction.

3▾

C++ tests

Native coverage for CUDA environment, driver, and GPU probes.

3▾

Python tests

CLI, configuration, and report-output verification in Python.

3▾

Vendored placeholders

Reserved directories for future third-party dependencies.

2▾

NVIDIA driver health probe

Implementedv0.0.0

src/core/driver.cpp

The driver probe treats `nvidia-smi` as the minimal prerequisite for driver visibility. If it is missing, the status is `missing`; if the command exists but the query fails, the status is `issue`; otherwise the probe reports the driver version.

driver.hpp process.cpp

Behavior

Probe commandbash

nvidia-smi --query-gpu=driver_version --format=csv,noheader

Missing `nvidia-smi` becomes a `missing` status.
A failed query becomes an `issue` status.
A non-empty version string becomes an `ok` status with the detected version embedded in the message.

include/core/driver.hpp

include/core/gpu.hpp

Related files

Core contract

include/core/driver.hpp

Declares the driver detection probe.

Core implementation

src/core/process.cpp

Implements PATH scanning, shell command execution, output trimming, and exit code decoding.