40 lines
2.1 KiB
Markdown
40 lines
2.1 KiB
Markdown
# 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`
|