api: GET /api/crew roster endpoint, OpenAPI spec updated in code

lib/openapi.ts

@@ -168,6 +168,24 @@ export const openApiSpec = {
         },
       },
     },
+    '/api/crew': {
+      get: {
+        summary: 'Crew roster',
+        description:
+          'The ship crew in join order — the starting crew (seeded on new game) plus members found while exploring planets/moons. Each member has one good and one bad trait and an origin. Auto-initializes a new game when no save exists yet.',
+        operationId: 'getCrew',
+        responses: {
+          200: {
+            description: 'Crew roster',
+            content: {
+              'application/json': {
+                schema: { type: 'array', items: { $ref: '#/components/schemas/CrewMember' } },
+              },
+            },
+          },
+        },
+      },
+    },
   },
   components: {
     schemas: {
@@ -245,6 +263,18 @@ export const openApiSpec = {
         },
         required: ['kind', 'name', 'qty'],
       },
+      CrewMember: {
+        type: 'object',
+        properties: {
+          id: { type: 'integer' },
+          name: { type: 'string' },
+          role: { type: 'string', description: 'Ship role, e.g. PILOT or ENGINEER' },
+          trait_good: { type: 'string', description: 'The member good trait' },
+          trait_bad: { type: 'string', description: 'The member bad trait' },
+          origin: { type: 'string', description: "'STARTING CREW' or '<planet>, <system>' for members found while exploring" },
+        },
+        required: ['id', 'name', 'role', 'trait_good', 'trait_bad', 'origin'],
+      },
       SystemState: {
         type: 'object',
         properties: {
@@ -278,8 +308,12 @@ export const openApiSpec = {
                 description: 'What this scan found — may be empty (some scans find nothing)',
                 items: { $ref: '#/components/schemas/FoundItem' },
               },
+              crewFound: {
+                description: 'A crew member who joined the ship on this scan (~18% of scans), null when none',
+                anyOf: [{ $ref: '#/components/schemas/CrewMember' }, { type: 'null' }],
+              },
             },
-            required: ['outcome'],
+            required: ['outcome', 'crewFound'],
           },
         ],
       },