stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
cf5b72974f923126944f4dcd47e85864ebb31a3b
git.stella-ops.org/docs/features/unchecked/cli/hlc-status-and-timeline-query-cli-commands.md

1.6 KiB
Raw Blame History

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