feat(api): ship + research endpoints queue tasks with lead + helpers; mission accept is instant and free (#44)

app/api/explore/route.ts

@@ -1,5 +1,5 @@
 import { getGameDb } from '@/lib/db/client'
-import { MAX_TEAM_SIZE } from '@/lib/game/crew'
+import { parseCrewTeam } from '@/app/api/crew-team'
 import { checkExploreTarget, ExploreError, getSystemState, queueStateFromSave, saveTaskRow } from '@/lib/game/save'
 import { queueTask, TaskError } from '@/lib/game/tasks'
 
@@ -20,32 +20,16 @@ export async function POST(req: Request) {
   if (typeof planetId !== 'number' || !Number.isInteger(planetId)) {
     return Response.json({ error: 'planetId must be an integer' }, { status: 400 })
   }
-  const leadCrewId = (body as { leadCrewId?: unknown }).leadCrewId
-  if (typeof leadCrewId !== 'number' || !Number.isInteger(leadCrewId)) {
-    return Response.json({ error: 'leadCrewId must be an integer' }, { status: 400 })
-  }
-  let helperCrewIds: number[] = []
-  const rawHelpers = (body as { helperCrewIds?: unknown }).helperCrewIds
-  if (rawHelpers !== undefined) {
-    if (!Array.isArray(rawHelpers) || !rawHelpers.every((h) => typeof h === 'number' && Number.isInteger(h))) {
-      return Response.json({ error: 'helperCrewIds must be an array of integers' }, { status: 400 })
-    }
-    helperCrewIds = rawHelpers
-  }
-  // Team rules (route layer, not queueTask's): one task team, distinct members, size cap.
-  const team = [leadCrewId, ...helperCrewIds]
-  if (new Set(team).size !== team.length) {
-    return Response.json({ error: 'crew members must be unique' }, { status: 400 })
-  }
-  if (team.length > MAX_TEAM_SIZE) {
-    return Response.json({ error: `a task team holds at most ${MAX_TEAM_SIZE} crew members` }, { status: 400 })
+  const team = parseCrewTeam(body)
+  if ('error' in team) {
+    return Response.json({ error: team.error }, { status: team.status })
   }
 
   try {
     const db = await getGameDb()
     await checkExploreTarget(db, planetId) // existing pre-checks: 404 unknown body · 409 already scanned
     const state = await queueStateFromSave(db)
-    const { task } = queueTask(state, { type: 'EXPLORE', payload: { planetId }, leadCrewId, helperCrewIds })
+    const { task } = queueTask(state, { type: 'EXPLORE', payload: { planetId }, leadCrewId: team.leadCrewId, helperCrewIds: team.helperCrewIds })
     await saveTaskRow(db, task) // inventory is unchanged until the scan resolves — no hold write
     return Response.json({ ...(await getSystemState(db)), outcome: [], crewFound: null })
   } catch (err) {