Framework.Overlay.SupersedenceVisualizer (Framework v0.5.0)

View Source

Supersedence Visualizer for observability overlay.

Visualizes :navigated → :render supersedence relationships to debug navigation flows. Essential for understanding UI state transitions and troubleshooting navigation issues.

Features

  • Navigation flow visualization
  • Supersedence relationship mapping
  • Timing analysis between navigation events
  • Orphaned navigation detection
  • Navigation pattern analysis

Summary

Functions

Analyze navigation patterns and performance.

Get navigation flow for a specific session or request.

Get recent navigations for supersedence analysis.

Get supersedence pairs for navigation flows.

Functions

analyze_navigation_patterns(time_window_hours \\ 24)

Analyze navigation patterns and performance.

Provides aggregate analysis of navigation flows for optimization.

Parameters

  • time_window_hours: Analysis window in hours (default 24)

Returns

Analysis report with navigation metrics and patterns

get_navigation_flow(correlation_id, correlation_type \\ :session_id)

Get navigation flow for a specific session or request.

Shows complete navigation timeline for debugging user flows.

Parameters

  • correlation_id: session_id, client_id, or request_id
  • correlation_type: :session_id | :client_id | :request_id

Returns

Chronological navigation flow with supersedence relationships

get_orphaned_navigations(age_threshold_minutes \\ 5, limit \\ 100, include_demo_events \\ false)

Get orphaned navigation events.

Finds :navigated events without corresponding :render events, which may indicate navigation issues or incomplete flows.

Parameters

  • age_threshold_minutes: How old orphaned events must be (default 5)
  • limit: Maximum orphaned events to return (default 100)

Returns

List of orphaned navigation events with diagnostic information

get_recent_navigations(opts \\ [])

Get recent navigations for supersedence analysis.

get_supersedence_pairs(limit \\ 50, filters \\ %{})

Get supersedence pairs for navigation flows.

Returns matched :navigated → :render pairs with timing and metadata.

Parameters

  • limit: Maximum pairs to return (default 50)
  • filters: Optional filtering criteria
    • navigation_id: Specific navigation ID
    • request_id: Filter by request ID
    • time_range: {from, to} datetime range

Returns

List of supersedence relationships with timing analysis