Files
git.stella-ops.org/docs/features/checked/scanner/runtime-timeline-api.md
2026-02-14 09:11:48 +02:00

37 lines
1.8 KiB
Markdown

# Runtime Timeline API
## Module
Scanner
## Status
VERIFIED
## Description
Provides a chronological timeline of runtime observations (RuntimeTimeline model, TimelineBuilder, RuntimePosture enum) with an API endpoint. Distinct from "Runtime Reachability Collection" which is about gathering data, not the timeline visualization API.
## Implementation Details
- **Timeline Model**:
- `src/Scanner/__Libraries/StellaOps.Scanner.Analyzers.Native/RuntimeCapture/Timeline/RuntimeTimeline.cs` - `RuntimeTimeline` model representing a chronological sequence of runtime observations with `RuntimePosture` classification
- **Timeline Builder**:
- `src/Scanner/__Libraries/StellaOps.Scanner.Analyzers.Native/RuntimeCapture/Timeline/TimelineBuilder.cs` - `TimelineBuilder` constructs timeline instances from raw runtime observations, ordering events chronologically and computing posture
- **Tests**:
- `src/Scanner/__Tests/StellaOps.Scanner.Analyzers.Native.Library.Tests/RuntimeCapture/Timeline/TimelineBuilderTests.cs` - Unit tests for timeline construction and posture computation
## E2E Test Plan
- [ ] Build a runtime timeline from a set of native runtime observations and verify events are ordered chronologically
- [ ] Verify the `RuntimePosture` enum correctly classifies the overall runtime posture based on observation patterns
- [ ] Verify timeline entries include observation timestamps, source types, and observation counts
- [ ] Submit runtime observations over time and verify the timeline reflects the temporal progression accurately
- [ ] Verify the timeline API endpoint returns the timeline in a serializable format with correct pagination support
---
## Verification
| Check | Result |
|-------|--------|
| Tier 0 - Source files exist | PASS |
| Tier 1 - Build + code review | PASS |
| Tier 2 - Integration tests | PASS |
| Verified | 2026-02-13T18:10:00Z |