save checkpoint

docs/features/checked/cli/doctor-cli-command-group.md

@@ -0,0 +1,42 @@
+# 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`