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/db/schema.ts

@@ -14,6 +14,10 @@ export const planes = sqliteTable('planes', {
   contractId: text('contract_id'),
   lat: real('lat').notNull(),
   lon: real('lon').notNull(),
+  // Sim-clock departure time of the current flight (null when available). While
+  // flying, `fuel` is frozen at its departure value — live position/fuel are pure
+  // functions of the clock (lib/sim/movement.ts), recomputed on read.
+  departureSimTime: integer('departure_sim_time'),
 });
 
 export const contracts = sqliteTable('contracts', {
@@ -24,7 +28,9 @@ export const contracts = sqliteTable('contracts', {
   cargoType: text('cargo_type').notNull(),
   cargoCount: integer('cargo_count').notNull(),
   deadlineSimTime: integer('deadline_sim_time').notNull(),
-  status: text('status', { enum: ['open', 'accepted', 'completed'] }).notNull(),
+  // 'expired' = an open contract whose deadline passed (v0.7.0). Accepted/
+  // in-flight contracts never expire — they complete.
+  status: text('status', { enum: ['open', 'accepted', 'completed', 'expired'] }).notNull(),
   planeId: text('plane_id'),
   createdSimTime: integer('created_sim_time').notNull(),
 });
@@ -38,6 +44,9 @@ export const simState = sqliteTable('sim_state', {
   clockMs: integer('clock_ms').notNull(),
   timeScale: real('time_scale').notNull(),
   paused: integer('paused', { mode: 'boolean' }).notNull(),
+  // Real-time (Date.now()) of the last tick — the tick-on-read engine advances
+  // clockMs by (now - lastRealTickMs) × timeScale, clamped per tick.
+  lastRealTickMs: integer('last_real_tick_ms').notNull(),
 });
 
 export type PlaneRow = typeof planes.$inferSelect;