Files
git.stella-ops.org/docs/features/unchecked/cli/doctor-cli-command-group.md

1.8 KiB

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