Skip to content

[Feature/adaptive rl doc] created the adaptive rl doctor solving issue 290 - #301

Closed
LazyKaddu wants to merge 4 commits into
StellarResearch:mainfrom
LazyKaddu:feature/adaptive-rl-doc
Closed

LazyKaddu wants to merge 4 commits into
StellarResearch:mainfrom
LazyKaddu:feature/adaptive-rl-doc

Conversation

@LazyKaddu

Copy link
Copy Markdown

Resolves #290

Summary of Changes

  • Core Diagnostic Engine: Created SystemDoctor in src/adaptive_rl/diagnostics/doctor.py to evaluate 10 distinct categories of local environment health.
  • Implemented 10 Diagnostic Checks: Added automated verifications for Python versions (3.10 to 3.12), hardware acceleration (CUDA/MPS), core and GUI dependencies, custom Gymnasium environment registration, model checkpoint serialization, Git repository state, I/O write permissions, YAML config structural integrity, and classical planner pathfinding execution.
  • CLI Integration: Registered the adaptive-rl doctor command in src/adaptive_rl/cli.py using Typer.
  • Rich Output & Remediation: Formatted terminal output using Rich (green checkmarks, yellow warnings, red crosses) and paired failures with exact, actionable remediation commands (e.g., specific pip commands).
  • JSON Export & Exit Codes: Added a --json flag to export a machine-readable structural diagnostic report, and wired the command to return a non-zero exit code (sys.exit(1)) on critical failures.
  • Unit Tests: Added tests/test_doctor.py providing isolated unit tests using unittest.mock to verify the diagnostic logic, JSON schema, and Typer CLI exit codes.
  • Documentation: Updated README.md and introduced docs/GETTING_STARTED.md to prominently document the system doctor as a first-step troubleshooting tool.

Verification

  • pytest tests/ passes
  • ruff check src/ tests/ passes
  • mypy src/ passes

@LazyKaddu LazyKaddu closed this Oct 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Engineering] Add a full-system health check and adaptive-rl doctor command

1 participant