# HLC Status and Timeline Query CLI Commands

## Module
Cli

## Status
VERIFIED

## Description
CLI commands `stella hlc status` for Hybrid Logical Clock status inspection and `stella timeline query` for querying the immutable event timeline with temporal filtering and deterministic output ordering.

## Implementation Details
- **HLC Command Group**: `src/Cli/StellaOps.Cli/Commands/HlcCommandGroup.cs` -- HLC status commands
- **Timeline Commands**: `src/Cli/StellaOps.Cli/Commands/TimelineCommandGroup.cs` -- timeline query commands
- **Timestamp Commands**: `src/Cli/StellaOps.Cli/Commands/TimestampCommandGroup.cs` -- timestamp operations
- **Tests**: `src/Cli/__Tests/StellaOps.Cli.Tests/Commands/TimestampCommandTests.cs`
- **Commands**:
  - `stella hlc status` -- show Hybrid Logical Clock status (node ID, current time, drift)
  - `stella hlc now` -- get current HLC timestamp
  - `stella timeline query` -- query event timeline. Options: `--from <time>`, `--to <time>`, `--type <event-type>`, `--limit`, `--format table|json`
- **Deterministic ordering**: Timeline output uses HLC ordering for consistency

## E2E Test Plan
- [ ] Run `stella hlc status` and verify HLC status including node ID and clock drift
- [ ] Run `stella hlc now` and verify current HLC timestamp
- [ ] Run `stella timeline query` and verify event timeline displayed
- [ ] Run `stella timeline query --from 2024-01-01 --to 2024-12-31` and verify temporal filtering
- [ ] Run `stella timeline query --type verdict` and verify event type filtering
- [ ] Verify deterministic output ordering (HLC-based)
- [ ] Verify `--format json` output

## 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/hlc-status-and-timeline-query-cli-commands/run-001/tier2-integration-check.json`