@ak--47/dungeon-master 1.3.0 → 1.4.0

package/dungeons/vertical/travel.js

@@ -1,7 +1,7 @@
 // ── TWEAK THESE ──
 const SEED = "dm4-travel";
-const num_days = 100;
-const num_users = 5_000;
+const num_days = 120;
+const num_users = 10_000;
 const avg_events_per_user_per_day = 1.2;
 let token = "your-mixpanel-token";
 
@@ -16,9 +16,6 @@ import * as v from "ak-tools";
 
 dayjs.extend(utc);
 const chance = u.initChance(SEED);
-const NOW = dayjs();
-const DATASET_START = NOW.subtract(num_days, "days");
-
 /** @typedef  {import("../../types").Dungeon} Config */
 
 const hotelIds = v.range(1, 200).map(() => `HTL_${v.uid(6)}`);
@@ -32,7 +29,7 @@ const destinationCities = ["New York", "London", "Paris", "Tokyo", "Barcelona",
  * StayQuest — a hotel booking platform for business and leisure travelers.
  * Users search destinations, compare hotels, book rooms, and leave reviews.
  *
- * - 5,000 users over 100 days, ~600K events
+ * - 5,000 users over 120 days, ~600K events
  * - Segments: business travelers (weekday), leisure families, luxury, budget
  * - Core loop: search → view hotel → compare → book → stay → review
  * - Revenue: commission per booking + premium loyalty membership
@@ -48,7 +45,16 @@ const destinationCities = ["New York", "London", "Paris", "Tokyo", "Barcelona",
 
 /**
  * ═══════════════════════════════════════════════════════════════
- * ANALYTICS HOOKS (8 hooks)
+ * ANALYTICS HOOKS (10 hooks)
+ *
+ * NOTE: All cohort effects are HIDDEN — no flag stamping. Discoverable via
+ * raw-prop breakdowns (booking_window, day, segment) or behavioral cohorts.
+ *
+ * Adds 9. BOOKING TIME-TO-CONVERT (Business 1.35x faster, Budget 1.25x slower)
+ *      [funnel-post: visible only in Mixpanel funnel median TTC; cross-event
+ *      MIN→MIN SQL queries do NOT show this]
+ * and 10. HOTEL-VIEWED MAGIC NUMBER (sweet 5-10 → +30% nightly_rate;
+ * over 11+ → drop 35% of bookings).
  * ═══════════════════════════════════════════════════════════════
  *
  * ───────────────────────────────────────────────────────────────
@@ -204,12 +210,16 @@ const destinationCities = ["New York", "London", "Paris", "Tokyo", "Barcelona",
 
 /** @type {Config} */
 const config = {
+	version: 2,
 	token,
 	seed: SEED,
-	numDays: num_days,
+	datasetStart: "2026-01-01T00:00:00Z",
+	datasetEnd: "2026-05-01T23:59:59Z",
+	// numDays: num_days,
 	avgEventsPerUserPerDay: avg_events_per_user_per_day,
 	numUsers: num_users,
-	hasAnonIds: false,
+	hasAnonIds: true,
+	avgDevicePerUser: 2,
 	hasSessionIds: true,
 	format: "json",
 	gzip: true,
@@ -242,6 +252,7 @@ const config = {
 			event: "account created",
 			weight: 1,
 			isFirstEvent: true,
+			isAuthEvent: true,
 			properties: {
 				signup_source: ["organic", "google", "instagram", "tripadvisor", "referral", "email_campaign"],
 			},
@@ -639,11 +650,25 @@ const config = {
 			}
 		}
 
-		// ── HOOK 8: REPEAT DESTINATION CLUSTERING (funnel-pre) ─
-		// conversionRate modifications moved to everything hook (event filtering)
-		// to avoid dilution by organic events
-		if (type === "funnel-pre") {
-			// prop-setting only; no conversionRate changes
+		// HOOK 9 (T2C): BOOKING TIME-TO-CONVERT (funnel-post)
+		// Business travelers complete the Search-to-Book funnel 1.35x faster
+		// (factor 0.74); leisure_family/budget customers 1.25x slower (1.25).
+		if (type === "funnel-post") {
+			const segment = meta?.profile?.customer_segment;
+			if (Array.isArray(record) && record.length > 1) {
+				const factor = (
+					segment === "business_traveler" ? 0.74 :
+					segment === "budget_hunter" || segment === "leisure_family" ? 1.25 :
+					1.0
+				);
+				if (factor !== 1.0) {
+					for (let i = 1; i < record.length; i++) {
+						const prev = dayjs(record[i - 1].time);
+						const newGap = Math.round(dayjs(record[i].time).diff(prev) * factor);
+						record[i].time = prev.add(newGap, "milliseconds").toISOString();
+					}
+				}
+			}
 		}
 
 		// ── HOOK 1: WEEKEND LEISURE SURGE ────────────
@@ -686,10 +711,11 @@ const config = {
 			});
 
 			// ── HOOK 2: ADVANCE BOOKING DISCOUNT ─────
+			const datasetEndForBooking = dayjs.unix(meta.datasetEnd);
 			events.forEach(e => {
 				if (e.event === "booking completed") {
 					const eventTime = dayjs(e.time);
-					const daysUntilEnd = NOW.diff(eventTime, "days");
+					const daysUntilEnd = datasetEndForBooking.diff(eventTime, "days");
 					if (daysUntilEnd > 21) {
 						e.booking_window = "advance";
 						e.nightly_rate = Math.floor((e.nightly_rate || 150) * 0.8);
@@ -705,12 +731,11 @@ const config = {
 			// business_traveler or luxury_seeker to simulate their lower funnel
 			// conversion (was conversionRate * 1.3 / 1.15 in funnel-pre)
 			const segment = profile && profile.customer_segment;
-			if (segment !== "business_traveler" && segment !== "luxury_seeker") {
+			if (segment !== "business_traveler" && segment !== "luxury_seeker"
+					&& chance.bool({ likelihood: 25 })) {
 				for (let i = events.length - 1; i >= 0; i--) {
 					if (events[i].event === "booking completed") {
-						if (chance.bool({ likelihood: 25 })) {
-							events.splice(i, 1);
-						}
+						events.splice(i, 1);
 					}
 				}
 			}
@@ -776,7 +801,8 @@ const config = {
 				}
 			}
 
-			// ── HOOK 6: REVIEW QUALITY BY STAY RATING ────────
+			// HOOK 6: REVIEW QUALITY BY STAY RATING — high avg ratings get
+			// review_length 1.5x; low avg ratings get 0.5x. Mutates raw prop.
 			let totalRating = 0;
 			let ratingCount = 0;
 			events.forEach(e => {
@@ -796,6 +822,26 @@ const config = {
 				}
 			});
 
+			// HOOK 10: HOTEL-VIEWED MAGIC NUMBER (in-funnel, no flags)
+			// Sweet 5-10 hotel-viewed events → +30% on booking nightly_rate
+			// (decisive comparison shoppers book higher-tier rooms).
+			// Over 11+ → drop 35% of booking-completed events (analysis
+			// paralysis blocks conversion).
+			const hotelViews = events.filter(e => e.event === "hotel viewed").length;
+			if (hotelViews >= 5 && hotelViews <= 10) {
+				events.forEach(e => {
+					if (e.event === "booking completed" && typeof e.nightly_rate === "number") {
+						e.nightly_rate = Math.round(e.nightly_rate * 1.3);
+					}
+				});
+			} else if (hotelViews >= 11) {
+				for (let i = events.length - 1; i >= 0; i--) {
+					if (events[i].event === "booking completed" && chance.bool({ likelihood: 35 })) {
+						events.splice(i, 1);
+					}
+				}
+			}
+
 			return record;
 		}
 

package/index.js

@@ -25,7 +25,7 @@ import { makeMirror } from './lib/generators/mirror.js';
 import { makeGroupProfile, makeProfile } from './lib/generators/profiles.js';
 
 // Utilities
-import { initChance } from './lib/utils/utils.js';
+import { initChance, setDatasetNow } from './lib/utils/utils.js';
 
 // External dependencies
 import dayjs from "dayjs";
@@ -33,12 +33,8 @@ import utc from "dayjs/plugin/utc.js";
 import { timer } from 'ak-tools';
 import { dataLogger as logger } from './lib/utils/logger.js';
 
-// Initialize dayjs and time constants
+// Initialize dayjs (window anchors are now resolved per-config in config-validator)
 dayjs.extend(utc);
-const FIXED_NOW = dayjs('2024-02-02').unix();
-global.FIXED_NOW = FIXED_NOW;
-let FIXED_BEGIN = dayjs.unix(FIXED_NOW).subtract(90, 'd').unix();
-global.FIXED_BEGIN = FIXED_BEGIN;
 
 
 /**
@@ -134,18 +130,21 @@ async function runDungeon(config) {
 			initChance(config.seed);
 		}
 
-		// Step 1: Validate and enrich configuration
+		// Step 1: Validate and enrich configuration (resolves dataset window)
 		validatedConfig = validateDungeonConfig(config);
 
-		// Compute FIXED_BEGIN from validated numDays
-		const configNumDays = validatedConfig.numDays || 30;
-		const fixedBegin = dayjs.unix(FIXED_NOW).subtract(configNumDays, 'd').unix();
+		// validateDungeonConfig always resolves these to unix seconds, but the
+		// public Dungeon type accepts string | number on input. Narrow here.
+		const fixedNow = /** @type {number} */ (validatedConfig.datasetEnd);
+		const fixedBegin = /** @type {number} */ (validatedConfig.datasetStart);
 
-		// Keep globals for backwards compatibility with tests/dungeons that read them
-		global.FIXED_BEGIN = fixedBegin;
+		// Anchor the wall-clock-free reference used by date()/day() helpers in
+		// dungeon configs. Without this, those factories produce values relative
+		// to process-start, which leaks wall-clock time into the output.
+		setDatasetNow(fixedNow);
 
 		// Step 2: Create context with validated config (pass time constants explicitly)
-		const context = createContext(validatedConfig, null, { fixedNow: FIXED_NOW, fixedBegin });
+		const context = createContext(validatedConfig, null, { fixedNow, fixedBegin });
 
 		// Step 3: Initialize storage containers
 		const storageManager = new StorageManager(context);
@@ -237,11 +236,12 @@ async function generateAdSpendData(context) {
 	const { config, storage } = context;
 	const { numDays } = config;
 
-	const timeShift = context.TIME_SHIFT_SECONDS;
 	for (let day = 0; day < numDays; day++) {
-		const fixedDay = dayjs.unix(context.FIXED_BEGIN).add(day, 'day').unix();
-		const shiftedDay = Math.min(fixedDay + timeShift, context.MAX_TIME);
-		const targetDay = dayjs.unix(shiftedDay).toISOString();
+		const dayUnix = Math.min(
+			dayjs.unix(context.FIXED_BEGIN).add(day, 'day').unix(),
+			context.FIXED_NOW
+		);
+		const targetDay = dayjs.unix(dayUnix).toISOString();
 		const adSpendEvents = await makeAdSpend(context, targetDay);
 
 		if (adSpendEvents.length > 0) {