2.3 KiB
2.3 KiB
Determinism Gate Testing Infrastructure
Module
__Libraries
Status
VERIFIED
Description
Dedicated determinism testing library and TestKit deterministic helpers for CI-gated canonical output verification.
Implementation Details
- TestKit:
src/__Libraries/StellaOps.TestKit/-- comprehensive shared test kit with TestCategories, DeterministicRandom, DeterministicTime, CanonicalJsonAssert, SnapshotAssert, BlastRadiusTestRunner/Validator, ConnectorTestBase hierarchy (HttpFixture, LiveSchema, Resilience, Security), FixtureUpdater, EnvironmentProfile, SkewTestRunner, EvidenceChainAssert/Reporter, IntentAttribute/TestIntents, SchemaVersionMatrix, StabilityMetrics/TestRunner, OTelContractAssert, LogContractAssert, MetricsContractAssert, CacheIdempotencyTests, FlakyToDeterministicPattern, QueryDeterminismTests, StorageConcurrencyTests/IdempotencyTests, WebServiceTestBase - Testing.Determinism:
src/__Libraries/StellaOps.Testing.Determinism/-- determinism-specific test infrastructure (referenced but directory may be integrated into TestKit) - Determinism.Abstractions:
src/__Libraries/StellaOps.Determinism.Abstractions/--IGuidProvider(SystemGuidProvider/SequentialGuidProvider),ResolverBoundaryAttribute,RequiresCanonicalizationAttribute,DeterministicOutputAttribute,DeterminismServiceCollectionExtensions(AddSystemTimeProvider, AddSystemGuidProvider, AddDeterminismDefaults) - Source: Feature matrix scan
E2E Test Plan
- Verify
CanonicalJsonAssertdetects non-deterministic JSON serialization (e.g., unordered keys) - Verify
SnapshotAssertcompares golden snapshots and reports diffs - Test
DeterministicRandomproduces repeatable sequences with same seed - Test
DeterministicTimeprovides controlled time progression - Verify
SequentialGuidProviderreturns predictable GUID sequence with counter in last 4 bytes - Test
BlastRadiusTestRunnervalidates change scope within expected boundaries - Verify
StorageIdempotencyTestsconfirm repeated writes produce identical results - Test
FlakyToDeterministicPatternconverts non-deterministic tests to deterministic equivalents
Verification
- Verified: 2026-02-13T20:30:00Z
- Run: run-001
- Tier: Tier 2d (Library/Internal)
- Verdict: PASS