# CLI Observability Dashboard Commands

## Module
Cli

## Status
VERIFIED

## Description
Real-time observability commands providing health/SLO/burn-rate dashboards with TUI rendering, distributed trace inspection, and log querying with pagination and evidence links.

## Implementation Details
- **Command Handlers**: `src/Cli/StellaOps.Cli/Commands/CommandHandlers.cs` -- observability command handlers
- **Observability Client**: `src/Cli/StellaOps.Cli/Services/ObservabilityClient.cs` / `IObservabilityClient.cs` -- API client for observability data
- **Telemetry**: `src/Cli/StellaOps.Cli/Telemetry/` -- CLI telemetry integration
- **Commands**:
  - `stella obs health` -- health dashboard with system status
  - `stella obs slo` -- SLO compliance dashboard with burn-rate metrics
  - `stella obs trace <trace-id>` -- inspect distributed trace
  - `stella obs logs` -- query logs with filtering and pagination. Options: `--service`, `--level`, `--from`, `--to`, `--limit`
- **TUI**: Uses Spectre.Console for rich terminal rendering of dashboards

## E2E Test Plan
- [ ] Run `stella obs health` and verify health dashboard with component status
- [ ] Run `stella obs slo` and verify SLO metrics with burn-rate indicators
- [ ] Run `stella obs trace <trace-id>` and verify trace spans displayed
- [ ] Run `stella obs logs --service policy --level error --limit 50` and verify filtered log output
- [ ] Verify log pagination with `--offset` and `--limit`
- [ ] Verify evidence links in log entries are clickable/actionable
- [ ] Verify `--format json` output for automation

## 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, 238 tests pass in StellaOps.Cli.Formatting.Tests
- **Tier 2d (Integration)**: pass -- targeted integration tests confirm behavioral correctness
- **Test Project**: `src/Cli/__Tests/StellaOps.Cli.Formatting.Tests/StellaOps.Cli.Formatting.Tests.csproj`
- **Evidence**: `docs/qa/feature-checks/runs/cli/cli-observability-dashboard-commands/run-001/tier2-integration-check.json`