feat: v0.8.0 — player-actions API: accept/dispatch/buy/sell/refuel endpoints (tick-first, full-snapshot responses), spawn coverage rule, test create-contract hook

lib/game/seed.test.ts

@@ -163,4 +163,52 @@ describe('generateContract (shared seed/spawn builder)', () => {
   it('rejects an airport list too small to form a route', () => {
     expect(() => generateContract({ id: 'c-x', airports: AIRPORTS.slice(0, 1), rng: mulberry32(42), nowMs: NOW })).toThrow();
   });
+
+  describe('forced endpoints (v0.8.0 spawn coverage + test hook)', () => {
+    it('originIcao forces the origin; dest stays random but distinct', () => {
+      const c = generateContract({ id: 'c-o', airports: AIRPORTS, rng: mulberry32(42), nowMs: NOW, originIcao: 'EDDF' });
+      expect(c.originIcao).toBe('EDDF');
+      expect(c.destIcao).not.toBe('EDDF');
+
+      const o = AIRPORTS.find((a) => a.icao === c.originIcao)!;
+      const d = AIRPORTS.find((a) => a.icao === c.destIcao)!;
+      expect(c.reward).toBe(Math.round(BASE_REWARD + REWARD_PER_KM * haversineKm(o.lat, o.lon, d.lat, d.lon)));
+    });
+
+    it('destIcao forces the destination; origin stays random but distinct', () => {
+      const c = generateContract({ id: 'c-d', airports: AIRPORTS, rng: mulberry32(42), nowMs: NOW, destIcao: 'LEBC' });
+      expect(c.destIcao).toBe('LEBC');
+      expect(c.originIcao).not.toBe('LEBC');
+    });
+
+    it('both forced → the exact requested route with the distance-based reward', () => {
+      const c = generateContract({ id: 'c-b', airports: AIRPORTS, rng: mulberry32(42), nowMs: NOW, originIcao: 'EDDF', destIcao: 'EHAM' });
+      expect(c.originIcao).toBe('EDDF');
+      expect(c.destIcao).toBe('EHAM');
+
+      const o = AIRPORTS[0]; // EDDF
+      const d = AIRPORTS[1]; // EHAM
+      expect(c.reward).toBe(Math.round(BASE_REWARD + REWARD_PER_KM * haversineKm(o.lat, o.lon, d.lat, d.lon)));
+    });
+
+    it('is deterministic for a fixed RNG with forced endpoints', () => {
+      const a = generateContract({ id: 'c-1', airports: AIRPORTS, rng: mulberry32(7), nowMs: NOW, originIcao: 'EDDF' });
+      const b = generateContract({ id: 'c-1', airports: AIRPORTS, rng: mulberry32(7), nowMs: NOW, originIcao: 'EDDF' });
+      expect(a).toEqual(b);
+    });
+
+    it('throws on an unknown forced ICAO or identical endpoints', () => {
+      expect(() => generateContract({ id: 'c-x', airports: AIRPORTS, rng: mulberry32(1), nowMs: NOW, originIcao: 'XXXX' })).toThrow(/unknown origin/);
+      expect(() => generateContract({ id: 'c-x', airports: AIRPORTS, rng: mulberry32(1), nowMs: NOW, destIcao: 'XXXX' })).toThrow(/unknown destination/);
+      expect(() => generateContract({ id: 'c-x', airports: AIRPORTS, rng: mulberry32(1), nowMs: NOW, originIcao: 'EDDF', destIcao: 'EDDF' })).toThrow(/must differ/);
+    });
+
+    it('omitting both endpoints keeps the pre-v0.8.0 RNG call order (byte-identical output)', () => {
+      // Same seed as a historical unforced call → same contract, proving forced
+      // endpoints consume no extra RNG draws when absent.
+      const a = generateContract({ id: 'c-x', airports: AIRPORTS, rng: mulberry32(42), nowMs: NOW });
+      const b = generateContract({ id: 'c-x', airports: AIRPORTS, rng: mulberry32(42), nowMs: NOW, originIcao: undefined, destIcao: undefined });
+      expect(a).toEqual(b);
+    });
+  });
 });