stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
9586006404279ce95d9f4fb4ec9c65a052aff98f
git.stella-ops.org/docs/features/checked/cli/doctor-cli-command-group.md
master e9aeadc040 save checkpoint
2026-02-14 09:11:48 +02:00

2.3 KiB
Raw Blame History

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