stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity

save checkpoint

Browse Source
This commit is contained in:
master
2026-02-14 09:11:48 +02:00
parent 9ca2de05df
commit e9aeadc040
1512 changed files with 30863 additions and 4728 deletions
Download Patch File Download Diff File Expand all files Collapse all files

39
docs/features/checked/cli/hlc-status-and-timeline-query-cli-commands.md Normal file
View File

@@ -0,0 +1,39 @@
# 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`