fix

apps/api/internal/httpapi/v1_openapi.go

@@ -929,7 +929,8 @@ paths:
                         processed_product_id: bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
                         raw_product_id: cccccccc-cccc-cccc-cccc-cccccccccccc
                         status: processed
-                        category: '50'
+                        category: Cookers
+                        category_id: '50'
                         category_name: Cookers
                         title: VOX electric cooker EHT 6020 WG
                         name: VOX electric cooker EHT 6020 WG
@@ -6278,12 +6279,15 @@ components:
       type: object
       description: |
         One COMPLETED legacy process line (A1 / public contract). Successful items
-        expose category as categories.unique_id, a description string that may
-        include category formula HTML (h1/h2/h3/h4, p, ul — never a JSON array),
-        SEO meta_title / meta_description (plain text), optional eprel object or
+        expose category as the human-readable display name (category_id holds
+        categories.unique_id), a description string that may include category formula
+        HTML (h1/h2/h3/h4, p, ul — never a JSON array), optional SEO meta_title /
+        meta_description (plain text; omitted for A1 cohort), optional eprel object or
         null, clean attributes, images, and dual-mode ids.
         Product display name is title; additive name mirrors the same processed title
         (dual-mode for scorecards / legacy clients that read name).
+        Property order prefers human-readable fields first (ean, title, category,
+        description, attributes, images, eprel) with internal ids last.
       required:
       - ean
       properties:
@@ -6308,6 +6312,14 @@ components:
             raw_products.id for this job line. Use with POST /process raw_product_ids
             or dashboard catalog APIs. Present whenever the job product row exists.
         category:
+          type: string
+          nullable: true
+          description: |
+            Human-readable category display name (same value as category_name when
+            resolved). Prefer this for UI. Machine unique_id is category_id.
+            ASSUMPTION: historically this field held categories.unique_id; clients
+            that need the opaque id must read category_id (additive).
+        category_id:
           type: string
           nullable: true
           description: |
@@ -6316,7 +6328,8 @@ components:
         category_name:
           type: string
           nullable: true
-          description: Human-readable category display name (not the unique_id).
+          description: |
+            Human-readable category display name (mirrors category when both are set).
         title:
           type: string
           nullable: true
@@ -6335,12 +6348,14 @@ components:
           description: |
             SEO title. Filled from processing meta or synthesized from title / category
             when empty so successful items are not left with null meta.
+            Omitted for A1 cohort (SEO meta is not used).
         meta_description:
           type: string
           nullable: true
           description: |
             SEO description (word-safe truncate). Distinct from body description when
             possible; synthesized from plain description when DB meta is empty.
+            Omitted for A1 cohort (SEO meta is not used).
         description:
           type: string
           nullable: true
@@ -6466,7 +6481,8 @@ components:
             processed_product_id: bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
             raw_product_id: cccccccc-cccc-cccc-cccc-cccccccccccc
             status: processed
-            category: '50'
+            category: Cookers
+            category_id: '50'
             category_name: Cookers
             title: VOX electric cooker EHT 6020 WG
             name: VOX electric cooker EHT 6020 WG