feat(freshness): enhance diagnostics and update snapshot structure

- Introduced a new Diagnostics struct to capture transaction visibility state and activity state.
- Updated BuildSnapshot function to return diagnostics alongside snapshot, completeness, and sampling.
- Enhanced test cases to validate the new diagnostics data.
- Updated frontend components to utilize the new diagnostics information for improved user feedback on freshness context.

This change improves the observability of transaction activity and enhances the user experience by providing clearer insights into the freshness of data.

backend/api/track1/bridge_status_data.go

@@ -132,7 +132,7 @@ func (s *Server) BuildBridgeStatusData(ctx context.Context) map[string]interface
 		data["operator_verify"] = ov
 	}
 	if s.freshnessLoader != nil {
-		if snapshot, completeness, sampling, err := s.freshnessLoader(ctx); err == nil && snapshot != nil {
+		if snapshot, completeness, sampling, diagnostics, err := s.freshnessLoader(ctx); err == nil && snapshot != nil {
 			subsystems := map[string]interface{}{
 				"rpc_head": map[string]interface{}{
 					"status":       chainStatusFromProbe(p138),
@@ -194,6 +194,9 @@ func (s *Server) BuildBridgeStatusData(ctx context.Context) map[string]interface
 			data["freshness"] = snapshot
 			data["subsystems"] = subsystems
 			data["sampling"] = sampling
+			if diagnostics != nil {
+				data["diagnostics"] = diagnostics
+			}
 			data["mode"] = map[string]interface{}{
 				"kind":        modeKind,
 				"updated_at":  now,

backend/api/track1/ccip_health_test.go

@@ -147,7 +147,7 @@ func TestBuildBridgeStatusDataIncludesCCIPRelay(t *testing.T) {
 	t.Setenv("MISSION_CONTROL_CCIP_JSON", "")
 
 	s := &Server{
-		freshnessLoader: func(context.Context) (*freshness.Snapshot, *freshness.SummaryCompleteness, *freshness.Sampling, error) {
+		freshnessLoader: func(context.Context) (*freshness.Snapshot, *freshness.SummaryCompleteness, *freshness.Sampling, *freshness.Diagnostics, error) {
 			now := time.Now().UTC().Format(time.RFC3339)
 			head := int64(16)
 			txBlock := int64(12)
@@ -187,6 +187,14 @@ func TestBuildBridgeStatusDataIncludesCCIPRelay(t *testing.T) {
 					BlocksFeed:       freshness.CompletenessComplete,
 				},
 				&freshness.Sampling{StatsGeneratedAt: &now},
+				&freshness.Diagnostics{
+					TxVisibilityState: "lagging",
+					ActivityState:     "fresh_head_stale_transaction_visibility",
+					Source:            freshness.SourceReported,
+					Confidence:        freshness.ConfidenceMedium,
+					Provenance:        freshness.ProvenanceComposite,
+					Completeness:      freshness.CompletenessPartial,
+				},
 				nil
 		},
 	}
@@ -201,6 +209,7 @@ func TestBuildBridgeStatusDataIncludesCCIPRelay(t *testing.T) {
 	require.True(t, ok)
 	require.Equal(t, true, probe["ok"])
 	require.Contains(t, got, "freshness")
+	require.Contains(t, got, "diagnostics")
 	require.Contains(t, got, "subsystems")
 	require.Contains(t, got, "mode")
 }
@@ -245,8 +254,8 @@ func TestBuildBridgeStatusDataDegradesWhenNamedRelayFails(t *testing.T) {
 	t.Setenv("CCIP_RELAY_HEALTH_URLS", "mainnet="+mainnet.URL+"/healthz,bsc="+bad.URL+"/healthz")
 
 	s := &Server{
-		freshnessLoader: func(context.Context) (*freshness.Snapshot, *freshness.SummaryCompleteness, *freshness.Sampling, error) {
-			return nil, nil, nil, nil
+		freshnessLoader: func(context.Context) (*freshness.Snapshot, *freshness.SummaryCompleteness, *freshness.Sampling, *freshness.Diagnostics, error) {
+			return nil, nil, nil, nil, nil
 		},
 	}
 	got := s.BuildBridgeStatusData(context.Background())

backend/api/track1/endpoints.go

@@ -21,13 +21,13 @@ var track1HashPattern = regexp.MustCompile(`^0x[a-fA-F0-9]{64}$`)
 // Server handles Track 1 endpoints (uses RPC gateway from lib)
 type Server struct {
 	rpcGateway      *gateway.RPCGateway
-	freshnessLoader func(ctx context.Context) (*freshness.Snapshot, *freshness.SummaryCompleteness, *freshness.Sampling, error)
+	freshnessLoader func(ctx context.Context) (*freshness.Snapshot, *freshness.SummaryCompleteness, *freshness.Sampling, *freshness.Diagnostics, error)
 }
 
 // NewServer creates a new Track 1 server
 func NewServer(
 	rpcGateway *gateway.RPCGateway,
-	freshnessLoader func(ctx context.Context) (*freshness.Snapshot, *freshness.SummaryCompleteness, *freshness.Sampling, error),
+	freshnessLoader func(ctx context.Context) (*freshness.Snapshot, *freshness.SummaryCompleteness, *freshness.Sampling, *freshness.Diagnostics, error),
 ) *Server {
 	return &Server{
 		rpcGateway:      rpcGateway,