Files
git.stella-ops.org/docs/features/unchecked/airgap/time-anchoring-for-offline-environments.md

1.7 KiB

Time Anchoring for Offline Environments

Module

AirGap

Status

IMPLEMENTED

Description

Time anchoring module with anchor loader, token parser, staleness calculator, and sealed startup validation for air-gapped environments. Includes HLC (Hybrid Logical Clock) merge services for multi-node sync.

Implementation Details

  • Time module: src/AirGap/StellaOps.AirGap.Time/ -- dedicated time anchoring service
  • Controllers: src/AirGap/StellaOps.AirGap.Time/Controllers/ -- time anchor API controllers
  • Services: src/AirGap/StellaOps.AirGap.Time/Services/ -- HLC merge, staleness calculation, anchor loading
  • Parsing: src/AirGap/StellaOps.AirGap.Time/Parsing/ -- time anchor token parsing
  • Models: src/AirGap/StellaOps.AirGap.Time/Models/ -- time anchor data models
  • Stores: src/AirGap/StellaOps.AirGap.Time/Stores/ -- time anchor state stores
  • Config: src/AirGap/StellaOps.AirGap.Time/Config/ -- time anchor configuration
  • Hooks: src/AirGap/StellaOps.AirGap.Time/Hooks/ -- time-related event hooks
  • Health: src/AirGap/StellaOps.AirGap.Time/Health/ -- time health checks
  • Fixtures: src/AirGap/StellaOps.AirGap.Time/fixtures/ -- deterministic time test data
  • Tests: src/AirGap/__Tests/StellaOps.AirGap.Time.Tests/
  • Attestor timestamping: src/Attestor/__Libraries/StellaOps.Attestor.Timestamping/TimeCorrelationValidator.Validate.cs, TimeCorrelationStatus.cs
  • Source: Feature matrix scan

E2E Test Plan

  • Verify time anchor loading from sealed bundles
  • Test token parsing extracts correct anchor timestamps
  • Test staleness calculator produces correct durations
  • Verify HLC merge service handles multi-node sync correctly
  • Test health checks report time anchor status