31 lines
1.6 KiB
Markdown
31 lines
1.6 KiB
Markdown
# 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
|