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▾

Executable dispatcher

Implementedv0.0.0

src/main.cpp

src/main.cpp is the actual command dispatcher for the current native tool. It only recognizes `check` and `doctor` today, formats reports for terminal or JSON output, and offers an interactive prompt to apply repo fixes when a repo-level issue is detected.

check.cpp doctor.cpp report.hpp cli.py

Reference

Current CLI surfacecpp

Usage: cuda-doctor-core <check|doctor> [auto] [--json]

int main(int argc, char** argv);

What it does

Validates the accepted argument combinations.
Runs `cuda_doctor::commands::run_check()` or `run_doctor()`.
Prints terminal-friendly reports or JSON payloads.
Returns `0` for overall OK and `1` for non-OK health states.
Detects when the report contains a repo issue and offers an interactive repair prompt when the session is a real TTY.

Caveats

Current command limit

Even though the README talks about `build`, `setup`, and `validate`, this dispatcher only accepts `check` and `doctor` today.

JSON mode bypasses the human prompt path entirely, which is sensible for automation but means the auto-fix invitation only appears in human terminal sessions.

Previous

cuda_doctor/cli.py

Next

include/core/report.hpp

Related files

Command implementation

src/commands/check.cpp

Runs the platform, driver, CUDA, and GPU probes and summarizes them into a report.

Command implementation

src/commands/doctor.cpp

Extends `check` with repo scanning, optional auto-configuration, auto-fix behavior, and next-step generation.

Core contract

include/core/report.hpp

Defines the status enum, probe shape, report structure, and status-to-string helper used throughout the native code.

Python wrapper

cuda_doctor/cli.py

Python entrypoint that resolves the native binary and forwards parsed CLI arguments into it.