feat: v0.7.0 — server-authoritative sim engine: tick-on-read clock (time-scale + pause via POST /api/sim), contract expiry + market spawn, analytic plane movement/finalization

lib/game/seed.ts

@@ -57,7 +57,7 @@ export interface SeedData {
   plane: SeedPlane;
   contracts: SeedContract[];
   account: { cash: number; reputation: number };
-  simState: { clockMs: number; timeScale: number; paused: false };
+  simState: { clockMs: number; timeScale: number; paused: false; lastRealTickMs: number };
 }
 
 // --- Tunables (documented so future revenue/cost work can build on them) ---
@@ -73,6 +73,10 @@ export const HUB_ICAO = 'EDDF'; // Frankfurt Main
 export const CONTRACT_COUNT_MIN = 8;
 export const CONTRACT_COUNT_MAX = 12; // inclusive
 
+// Market target (v0.7.0): the sim engine tops open contracts back up to this
+// count after expiries, so the job board never runs dry.
+export const MARKET_TARGET_OPEN_CONTRACTS = 10;
+
 // Reward formula (v0.6.0 — deliberately simple; real revenue/cost modeling is a
 // later increment): reward = BASE_REWARD + REWARD_PER_KM * great-circle km.
 export const BASE_REWARD = 500;
@@ -88,6 +92,50 @@ export function rewardForDistanceKm(km: number): number {
   return Math.round(BASE_REWARD + REWARD_PER_KM * km);
 }
 
+// Shared contract generator, used by BOTH the first-run seed and the runtime
+// market spawn (v0.7.0) so spawned contracts match seeded ones exactly: random
+// distinct airports from the dataset, distance-based reward, cargo flavor,
+// deadline now + 6–72h game time (or now + deadlineOffsetMs when given — used by
+// the e2e test hook to force a near-term expiry). The RNG call order per contract
+// is fixed: origin, dest, cargoType, cargoCount, [deadline window].
+export function generateContract(input: {
+  id: string;
+  airports: SeedAirport[];
+  rng: Rng;
+  nowMs: number;
+  deadlineOffsetMs?: number;
+}): SeedContract {
+  const { airports, rng, nowMs } = input;
+  if (airports.length < 2) throw new Error('contract generation needs at least two airports');
+
+  const oi = Math.floor(rng() * airports.length);
+  let di = Math.floor(rng() * airports.length);
+  if (di === oi) di = (di + 1) % airports.length;
+  const origin = airports[oi];
+  const dest = airports[di];
+
+  const km = haversineKm(origin.lat, origin.lon, dest.lat, dest.lon);
+  const cargoType = CARGO_TYPES[Math.floor(rng() * CARGO_TYPES.length)];
+  // Passengers up to the ATR 72's ~68 seats; other cargo in pallets.
+  const cargoCount =
+    cargoType === 'Passengers' ? 1 + Math.floor(rng() * 68) : 1 + Math.floor(rng() * 50);
+  const deadlineMs =
+    input.deadlineOffsetMs ?? (DEADLINE_MIN_HOURS + rng() * (DEADLINE_MAX_HOURS - DEADLINE_MIN_HOURS)) * 3_600_000;
+
+  return {
+    id: input.id,
+    originIcao: origin.icao,
+    destIcao: dest.icao,
+    reward: rewardForDistanceKm(km),
+    cargoType,
+    cargoCount,
+    deadlineSimTime: Math.round(nowMs + deadlineMs),
+    status: 'open',
+    planeId: null,
+    createdSimTime: nowMs,
+  };
+}
+
 function pickHub(airports: SeedAirport[]): SeedAirport {
   return airports.find((a) => a.icao === HUB_ICAO) ?? airports[0];
 }
@@ -116,41 +164,19 @@ export function buildSeed(input: {
   };
 
   const count = CONTRACT_COUNT_MIN + Math.floor(rng() * (CONTRACT_COUNT_MAX - CONTRACT_COUNT_MIN + 1));
+  // Stable index-based ids for the seed set; runtime-generated entities must use
+  // random UUIDs to avoid colliding with these.
   const contracts: SeedContract[] = [];
   for (let i = 0; i < count; i++) {
-    // Stable index-based ids for the seed set; runtime-generated entities must
-    // use random UUIDs to avoid colliding with these.
-    const oi = Math.floor(rng() * airports.length);
-    let di = Math.floor(rng() * airports.length);
-    if (di === oi) di = (di + 1) % airports.length;
-    const origin = airports[oi];
-    const dest = airports[di];
-
-    const km = haversineKm(origin.lat, origin.lon, dest.lat, dest.lon);
-    const cargoType = CARGO_TYPES[Math.floor(rng() * CARGO_TYPES.length)];
-    // Passengers up to the ATR 72's ~68 seats; other cargo in pallets.
-    const cargoCount =
-      cargoType === 'Passengers' ? 1 + Math.floor(rng() * 68) : 1 + Math.floor(rng() * 50);
-    const deadlineMs = (DEADLINE_MIN_HOURS + rng() * (DEADLINE_MAX_HOURS - DEADLINE_MIN_HOURS)) * 3_600_000;
-
-    contracts.push({
-      id: `contract-${i + 1}`,
-      originIcao: origin.icao,
-      destIcao: dest.icao,
-      reward: rewardForDistanceKm(km),
-      cargoType,
-      cargoCount,
-      deadlineSimTime: Math.round(nowMs + deadlineMs),
-      status: 'open',
-      planeId: null,
-      createdSimTime: nowMs,
-    });
+    contracts.push(generateContract({ id: `contract-${i + 1}`, airports, rng, nowMs }));
   }
 
   return {
     plane,
     contracts,
     account: { cash: STARTING_CASH, reputation: STARTING_REPUTATION },
-    simState: { clockMs: nowMs, timeScale: 1, paused: false },
+    // lastRealTickMs starts at the seed moment so the first tick-on-read advances
+    // by ~0 instead of treating "time since install" as elapsed play time.
+    simState: { clockMs: nowMs, timeScale: 1, paused: false, lastRealTickMs: nowMs },
   };
 }