0, 'next' => 1, 'later' => 2, ); private const COMPARISON_ORDER = array( 'regressed' => 0, 'new' => 1, 'unchanged' => 2, 'resolved' => 3, ); private const SEVERITY_ORDER = array( 'critical' => 0, 'high' => 1, 'medium' => 2, 'low' => 3, 'info' => 4, 'none' => 5, ); private const STATUS_ORDER = array( 'fail' => 0, 'error' => 1, 'warning' => 2, 'not_tested' => 3, 'info' => 4, 'pass' => 5, ); /** * @param array $finding Finding projection. */ public function band( array $finding ): ?string { $status = isset( $finding['status'] ) && is_string( $finding['status'] ) ? $finding['status'] : ''; $severity = isset( $finding['severity'] ) && is_string( $finding['severity'] ) ? $finding['severity'] : ''; if ( in_array( $status, array( 'pass', 'info' ), true ) ) { return null; } if ( 'fail' === $status && in_array( $severity, array( 'critical', 'high' ), true ) ) { return 'now'; } if ( 'fail' === $status || 'error' === $status || ( 'warning' === $status && in_array( $severity, array( 'critical', 'high', 'medium' ), true ) ) ) { return 'next'; } return 'later'; } /** * @param list> $findings Projected Findings. * @return list|null}> */ public function actions( array $findings ): array { $actions = array(); foreach ( $findings as $index => $finding ) { $band = $this->band( $finding ); if ( null === $band || ! isset( $finding['check_id'] ) || ! is_string( $finding['check_id'] ) ) { continue; } $acknowledgement = isset( $finding['acknowledgement'] ) && is_array( $finding['acknowledgement'] ) ? $finding['acknowledgement'] : null; if ( 'now' !== $band && 'suppressed' === ( $acknowledgement['decision'] ?? null ) ) { continue; } $actions[] = array( 'finding_index' => $index, 'check_id' => $finding['check_id'], 'priority_band' => $band, 'effort_band' => isset( $finding['effort_band'] ) && is_string( $finding['effort_band'] ) ? $finding['effort_band'] : 'unknown', 'comparison_state' => isset( $finding['comparison_state'] ) && is_string( $finding['comparison_state'] ) ? $finding['comparison_state'] : 'new', 'acknowledgement' => $acknowledgement, '_severity' => isset( $finding['severity'] ) && is_string( $finding['severity'] ) ? $finding['severity'] : 'none', '_status' => isset( $finding['status'] ) && is_string( $finding['status'] ) ? $finding['status'] : 'not_tested', ); } usort( $actions, array( $this, 'compare' ) ); return array_map( static function ( array $action ): array { unset( $action['_severity'], $action['_status'] ); return $action; }, $actions ); } /** * @param array $left Left action. * @param array $right Right action. */ private function compare( array $left, array $right ): int { $left_order = array( self::BAND_ORDER[ (string) $left['priority_band'] ] ?? 9, self::COMPARISON_ORDER[ (string) $left['comparison_state'] ] ?? 9, self::SEVERITY_ORDER[ (string) $left['_severity'] ] ?? 9, self::STATUS_ORDER[ (string) $left['_status'] ] ?? 9, (string) $left['check_id'], ); $right_order = array( self::BAND_ORDER[ (string) $right['priority_band'] ] ?? 9, self::COMPARISON_ORDER[ (string) $right['comparison_state'] ] ?? 9, self::SEVERITY_ORDER[ (string) $right['_severity'] ] ?? 9, self::STATUS_ORDER[ (string) $right['_status'] ] ?? 9, (string) $right['check_id'], ); return $left_order <=> $right_order; } }