# Doctor CLI Command Group

## Module
Cli

## Status
IMPLEMENTED

## Description
Top-level `stella doctor` CLI command group providing CLI parity with Doctor web UI, including watch mode for continuous monitoring, per-environment health filtering, export capabilities for health reports, fix execution from CLI, and historical trend reporting.

## Implementation Details
- **Command Group**: `src/Cli/StellaOps.Cli/Commands/DoctorCommandGroup.cs` -- `DoctorCommandGroup` (internal static class)
- **Doctor Engine**: Uses `StellaOps.Doctor.Engine` library for diagnostic checks
- **Doctor Export**: Uses `StellaOps.Doctor.Export` for report export
- **Doctor Packs**: Uses `StellaOps.Doctor.Packs` for diagnostic packs
- **Doctor Plugins**: Uses `StellaOps.Doctor.Plugins` for extensible health checks
- **Commands**:
  - `stella doctor` / `stella doctor run` -- run diagnostic checks. Options: `--category <cat>`, `--tag <tag>`, `--format table|json`, `--verbose`
  - `stella doctor list` -- list available diagnostic checks
  - `stella doctor export --output <path>` -- export health report
  - `stella doctor fix <check-id>` -- execute auto-fix for a failed check
- **Output**: Uses `StellaOps.Doctor.Output` for formatted console output

## E2E Test Plan
- [ ] Run `stella doctor` and verify diagnostic checks run with pass/fail/warn status
- [ ] Run `stella doctor --category connectivity` and verify category filtering
- [ ] Run `stella doctor --tag critical` and verify tag filtering
- [ ] Run `stella doctor list` and verify available checks listed with descriptions
- [ ] Run `stella doctor export --output ./health-report.json` and verify report exported
- [ ] Run `stella doctor fix <check-id>` and verify auto-fix execution
- [ ] Run `stella doctor --format json` and verify structured output
- [ ] Verify `--verbose` shows detailed check execution info