# Doctor CLI Command Group

## Module
Cli

## Status
VERIFIED

## 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

## Verification

- **Verified**: 2026-02-13T15:30:00Z
- **Tier 0 (Source)**: pass -- all referenced source files exist on disk
- **Tier 1 (Build)**: pass -- module builds cleanly, 339 tests pass in StellaOps.Cli.Plugins.Tests
- **Tier 2d (Integration)**: pass -- targeted integration tests confirm behavioral correctness
- **Test Project**: `src/Cli/__Tests/StellaOps.Cli.Plugins.Tests/StellaOps.Cli.Plugins.Tests.csproj`
- **Evidence**: `docs/qa/feature-checks/runs/cli/doctor-cli-command-group/run-001/tier2-integration-check.json`