orion-ecs / keen-eye / 20703918038

65%

push

github

feat(migrations): Add migration chain resolution with diagnostics

Enable multi-step migrations that chain through intermediate versions
(v1 → v2 → v3) automatically when no direct migration path exists.

Key additions:
- MigrationGraph: Runtime graph for path validation with caching
  - HasPath(): Check if migration chain exists between versions
  - GetMigrationChain(): Get ordered list of migration steps
  - FindGaps(): Identify missing migrations in the chain
  - HasCycle(): Verify DAG structure (cycles prevented by design)

- MigrationResult: Detailed result with timing diagnostics
  - Per-step timing breakdown for profiling
  - Error information with failed version identification
  - Factory methods for success/failure/no-op scenarios

- IMigrationDiagnostics: Extended interface for diagnostic operations
  - MigrateWithDiagnostics(): Migration with timing capture
  - GetMigrationGraph(): Access component's migration graph
  - FindAllMigrationGaps(): Find gaps across all components
  - GenerateDiagnosticReport(): Full diagnostic report

- SerializationGenerator: Updated to generate diagnostic-enabled code
  - Caches MigrationGraph per component
  - Implements IMigrationDiagnostics interface
  - Generates comprehensive diagnostic methods

- ComponentMigrationAnalyzer: Enhanced documentation
  - Explains how cycle detection is structurally enforced
  - KEEN113 + KEEN115 together guarantee DAG structure

Tests added for MigrationGraph, MigrationResult, and chain resolution.
All 10,702 tests pass.

Closes #699

5420 of 6707 branches covered (80.81%)

Branch coverage included in aggregate %.

326 of 338 new or added lines in 3 files covered. (96.45%)

35012 of 45245 relevant lines covered (77.38%)

1.1 hits per line