Spread events across the week with seed-based day scheduling

Events without day restrictions always fired on Monday because
checkForEvent returns the first match. Now each standalone event
is assigned a specific scheduledDay during seed-based selection,
picking randomly from its allowed day range.

- Arc events keep definition-based day checks (ordering matters)
- "Any day" events restricted to weekdays (blockStart can't fire
  on weekends, and weekday-survival is the narrative arc)
- scheduledDay persisted in save data

Author: aviraccoon

src/state.ts

@@ -76,6 +76,8 @@ export interface EventInstance {
 	status: "pending" | "active" | "resolved";
 	/** For major events: which choice the player made. */
 	choiceId?: string;
+	/** Day index (0-6) this event is scheduled to fire on. Assigned during selection. */
+	scheduledDay?: number;
 }
 
 /**

src/systems/eventSelection.ts

@@ -9,7 +9,7 @@ import {
 	type EventTier,
 	eventPool,
 } from "../data/events";
-import type { EventInstance } from "../state";
+import { DAYS, type EventInstance } from "../state";
 import { seededRandom, seededShuffle } from "../utils/random";
 import type { PatternsData } from "./persistence";
 
@@ -166,5 +166,52 @@ export function selectEventsForSeed(
 		}
 	}
 
+	// Assign each standalone event a specific day within its allowed range.
+	// Without this, events fire on the first matching day (always Monday for
+	// "any day" events). Arc events keep their definition-based day checks
+	// since arc ordering depends on carefully designed day ranges.
+	assignScheduledDays(selected, seed);
+
 	return selected;
 }
+
+/** Salt offset for day scheduling (distinct from selection salts). */
+const SALT_SCHEDULE_DAY = 5200;
+
+/**
+ * Assigns a scheduledDay to each non-arc standalone event, picking from its
+ * allowed day range using seeded random. Arc events are skipped (their day
+ * ranges are designed for narrative ordering).
+ */
+function assignScheduledDays(events: EventInstance[], seed: number): void {
+	for (let i = 0; i < events.length; i++) {
+		const instance = events[i];
+		if (!instance) continue;
+
+		const definition = eventPool.find((e) => e.id === instance.id);
+		if (!definition || definition.arcId) continue;
+
+		// Build allowed day indices from definition
+		let allowedDays: number[];
+		if (definition.timing.day) {
+			const days = Array.isArray(definition.timing.day)
+				? definition.timing.day
+				: [definition.timing.day];
+			allowedDays = days.map((d) => DAYS.indexOf(d)).filter((idx) => idx >= 0);
+		} else {
+			// Any day: restrict to weekdays (0-4) since blockStart events can't
+			// fire on weekends (no time block transitions) and weekend scheduling
+			// doesn't fit the weekday-survival narrative arc
+			allowedDays = [0, 1, 2, 3, 4];
+		}
+
+		if (allowedDays.length === 0) continue;
+
+		// Pick one day from the range
+		const r = seededRandom(seed, SALT_SCHEDULE_DAY + i);
+		const dayIndex = allowedDays[Math.floor(r * allowedDays.length)];
+		if (dayIndex !== undefined) {
+			instance.scheduledDay = dayIndex;
+		}
+	}
+}

src/systems/events.ts

@@ -41,8 +41,10 @@ export function checkForEvent(
 		// Check phase
 		if (definition.timing.phase !== phase) continue;
 
-		// Check day
-		if (definition.timing.day) {
+		// Check day: use scheduled day if assigned, otherwise fall back to definition
+		if (instance.scheduledDay !== undefined) {
+			if (state.dayIndex !== instance.scheduledDay) continue;
+		} else if (definition.timing.day) {
 			const days = Array.isArray(definition.timing.day)
 				? definition.timing.day
 				: [definition.timing.day];

src/systems/persistence.ts

@@ -37,11 +37,12 @@ interface SavedTask {
 	succeededToday: boolean;
 }
 
-/** Persisted event instance state (status + player choice). */
+/** Persisted event instance state (status + player choice + scheduling). */
 interface SavedEventInstance {
 	id: EventId;
 	status: EventInstance["status"];
 	choiceId?: string;
+	scheduledDay?: number;
 }
 
 /** Minimal game state for persistence - no translatable content. */
@@ -168,6 +169,7 @@ function toSavedState(state: GameState): SavedState {
 			id: e.id,
 			status: e.status,
 			choiceId: e.choiceId,
+			scheduledDay: e.scheduledDay,
 		})),
 		eventFlags: state.eventFlags,
 	};
@@ -365,6 +367,7 @@ function fromSavedState(saved: SavedState): GameState {
 		id: e.id,
 		status: e.status,
 		choiceId: e.choiceId,
+		scheduledDay: e.scheduledDay,
 	}));
 
 	// Derive activeEventId from the events array