fix: align stewards schema to array type and fix unstewardedOnly null filter

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Umberto Sgueglia <usgueglia@contractor.linuxfoundation.org>

Author: ulemons

backend/src/api/public/v1/packages/batchGetStewardship.ts

@@ -38,7 +38,7 @@ export async function batchGetStewardship(req: Request, res: Response): Promise<
         impact: detail.general.impact.impactScore,
         openVulns,
         stewardship: detail.stewardship.status,
-        stewards: null,
+        stewards: detail.stewardship.stewards,
         lastActivityAt: null,
         lastActivityDescription: null,
       }

backend/src/api/public/v1/packages/listPackages.ts

@@ -47,7 +47,7 @@ export async function listPackages(req: Request, res: Response): Promise<void> {
     if (ecosystem && p.ecosystem !== ecosystem) return false
     if (lifecycle && p.lifecycle !== lifecycle) return false
     if (busFactor1Only && p.maintainerBusFactor !== 1) return false
-    if (unstewardedOnly && p.stewardship !== 'unassigned') return false
+    if (unstewardedOnly && p.stewardship !== null && p.stewardship !== 'unassigned') return false
     if (staleOnly) {
       const lastRelease = MOCK_DETAILS[p.purl]?.general.riskSignals.lastRelease
       if (!lastRelease || new Date(lastRelease) >= staleThreshold) return false

backend/src/api/public/v1/packages/mockData.ts

@@ -9,8 +9,8 @@ export interface MockPackageListItem {
   lifecycle: Lifecycle
   maintainerBusFactor: number
   openVulns: OpenVulns
-  stewardship: StewardshipStatus
-  stewards: Steward | null
+  stewardship: StewardshipStatus | null
+  stewards: Steward[] | null
 }
 
 export interface MockPackageDetail {
@@ -60,7 +60,7 @@ export interface MockPackageDetail {
   }
   stewardship: {
     status: StewardshipStatus
-    stewards: Steward | null
+    stewards: Steward[] | null
     lastActivityAt: string | null
   }
   history: Record<string, unknown>

backend/src/api/public/v1/packages/openapi.yaml

@@ -136,9 +136,11 @@ components:
         stewardship:
           $ref: '#/components/schemas/StewardshipStatus'
         stewards:
-          description: Single steward or null. Empty in v1.
+          description: Assigned stewards or null. Empty in v1.
           oneOf:
-            - $ref: '#/components/schemas/Steward'
+            - type: array
+              items:
+                $ref: '#/components/schemas/Steward'
             - type: 'null'
         lastActivityAt:
           type:
@@ -195,9 +197,11 @@ components:
         stewardship:
           $ref: '#/components/schemas/StewardshipStatus'
         stewards:
-          description: Single assigned steward or null.
+          description: Assigned stewards or null.
           oneOf:
-            - $ref: '#/components/schemas/Steward'
+            - type: array
+              items:
+                $ref: '#/components/schemas/Steward'
             - type: 'null'
 
     # ── Package detail ───────────────────────────────────────────────────────────
@@ -419,9 +423,11 @@ components:
             status:
               $ref: '#/components/schemas/StewardshipStatus'
             stewards:
-              description: Single assigned steward or null. Null in v1.
+              description: Assigned stewards or null. Null in v1.
               oneOf:
-                - $ref: '#/components/schemas/Steward'
+                - type: array
+                  items:
+                    $ref: '#/components/schemas/Steward'
                 - type: 'null'
             lastActivityAt:
               type:

backend/src/api/public/v1/packages/types.ts

@@ -33,8 +33,8 @@ export interface StewardshipSummary {
   health: number | null
   impact: number | null
   openVulns: OpenVulns | null
-  stewardship: StewardshipStatus
-  stewards: Steward | null
+  stewardship: StewardshipStatus | null
+  stewards: Steward[] | null
   lastActivityAt: string | null
   lastActivityDescription: string | null
 }