feat(RELEASE-2243): add file ordering for Content Gateway publishing

Checksum files (sha256sum.txt, sha256sum.txt.gpg, sha256sum.txt.sig)
are now published first, followed by the remaining files in the order
they are listed in the RPA. Each file includes an "order" field in its
metadata payload so CGW displays them in a consistent, deterministic
sequence.

Assisted-by: Cursor AI
Signed-off-by: Scott Wickersham <swickers@redhat.com>

Author: swickersh

publish-to-cgw-wrapper/publish_to_cgw_wrapper.py

@@ -204,51 +204,36 @@ def generate_metadata(
     if mirror_openshift_Push:
         shortURL_base = "/pub/cgw"
 
-    # Build file_lookup from source field (using basename of source)
-    file_lookup = {os.path.basename(file["source"]) for file in files}
-    metadata = []
+    dir_contents = set(os.listdir(content_dir))
+
+    # Checksum files first (fixed names, fixed order), then RPA files in their original order
+    checksum_files = [
+        ("sha256sum.txt", "Checksum"),
+        ("sha256sum.txt.gpg", "Checksum - GPG"),
+        ("sha256sum.txt.sig", "Checksum - Signature"),
+    ]
+
+    ordered_files = [
+        (name, label) for name, label in checksum_files if name in dir_contents
+    ] + [
+        (os.path.basename(f["source"]), os.path.basename(f["source"]))
+        for f in files
+        if os.path.basename(f["source"]) in dir_contents
+    ]
 
-    for file_name in os.listdir(content_dir):
-        if file_name in file_lookup:
-            logging.info(f"Processing file: {file_name}")
-            metadata.append(
-                {
-                    **default_values_per_component,
-                    "shortURL": f"{shortURL_base}/{product_code}/{version_name}/{file_name}",
-                    "productVersionId": version_id,
-                    "downloadURL": generate_download_url(content_dir, file_name),
-                    "label": file_name,
-                }
-            )
-        elif file_name.startswith("sha256") or file_name.startswith(component_name):
-            logging.info(f"Processing file: {file_name}")
-            label = None
-            if file_name.endswith(".gpg"):
-                label = "Checksum - GPG"
-            elif file_name.endswith(".sig"):
-                label = "Checksum - Signature"
-            elif file_name.endswith(".txt"):
-                label = "Checksum"
-
-            if label:
-                metadata.append(
-                    {
-                        **default_values_per_component,
-                        "productVersionId": version_id,
-                        "downloadURL": generate_download_url(content_dir, file_name),
-                        "shortURL": (
-                            f"{shortURL_base}/{product_code}/{version_name}/{file_name}"
-                        ),
-                        "label": label,
-                    }
-                )
-        else:
-            # Skip files that arent listed in files and aren't a checksum.
-            logging.warning(
-                f"Skipping file: {file_name} "
-                "as it's not listed in component 'files' and not a checksum."
-            )
-            continue
+    metadata = []
+    for order, (file_name, label) in enumerate(ordered_files, start=1):
+        logging.info(f"Processing file: {file_name} (order={order}, label={label})")
+        metadata.append(
+            {
+                **default_values_per_component,
+                "shortURL": f"{shortURL_base}/{product_code}/{version_name}/{file_name}",
+                "productVersionId": version_id,
+                "downloadURL": generate_download_url(content_dir, file_name),
+                "label": label,
+                "order": order,
+            }
+        )
 
     return metadata