HLC Status and Timeline Query CLI Commands

Module

Cli

Status

IMPLEMENTED

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

1.6 KiB Raw Blame History