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

package/dungeons/vertical/logistics.js

@@ -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 */
 
 // Generate consistent warehouse/supplier IDs at module level
@@ -56,7 +53,12 @@ const supplierIds = v.range(1, 150).map(() => `SUP_${v.uid(6)}`);
 
 /**
  * ===================================================================
- * ANALYTICS HOOKS (8 hooks)
+ * ANALYTICS HOOKS (10 hooks)
+ *
+ * Adds 10. ONBOARDING TIME-TO-CONVERT: enterprise 0.71x faster, small_business
+ * 1.3x slower (funnel-post). Discover via Onboarding funnel median TTC by company_tier.
+ * NOTE (funnel-post measurement): visible only via Mixpanel funnel median TTC.
+ * Cross-event MIN→MIN SQL queries on raw events do NOT show this.
  * ===================================================================
  *
  * -------------------------------------------------------------------
@@ -123,6 +125,15 @@ const supplierIds = v.range(1, 150).map(() => `SUP_${v.uid(6)}`);
  *   - Breakdown: user property "company_tier"
  *   - Expected: enterprise ratio ~0.9x vs small_business baseline
  *
+ *   Report 3: Stockout-to-Inventory-Check Ratio (NORMALIZED — recommended)
+ *   - Report type: Insights (formula)
+ *   - A = "stockout alert" total, B = "inventory checked" total
+ *   - Formula: A / B
+ *   - Breakdown: user property "company_tier"
+ *   - Expected: enterprise ratio ~ 0.9x SMB ratio (10% reduction visible)
+ *   - WHY THIS METRIC: per-user counts are dominated by persona event multipliers
+ *     (enterprise has 5x baseline activity); ratio normalizes that out.
+ *
  * REAL-WORLD ANALOGUE: Enterprise operations have dedicated
  * procurement teams and predictive analytics reducing stockouts.
  *
@@ -243,6 +254,41 @@ const supplierIds = v.range(1, 150).map(() => `SUP_${v.uid(6)}`);
  * REAL-WORLD ANALOGUE: Small businesses lack dedicated IT teams,
  * leading to incomplete integration setup and lower alert adoption.
  *
+ * -------------------------------------------------------------------
+ * 9. INVENTORY-CHECK MAGIC NUMBER (everything hook)
+ * -------------------------------------------------------------------
+ *
+ * PATTERN: Users with 5-15 "inventory checked" events sit in the
+ * "engaged-but-focused" sweet spot — every "purchase order created"
+ * event gets quantity boosted ~25%. Users with 16 or more inventory
+ * checks are over-engaged (paralysis); ~30% of their "purchase order
+ * created" events are dropped. No flag is stamped — discoverable only
+ * by binning users on inventory-check COUNT and comparing PO totals.
+ *
+ * HOW TO FIND IT IN MIXPANEL:
+ *
+ *   Report 1: PO Quantity by Inventory-Check Bucket
+ *   - Report type: Insights (with cohort)
+ *   - Cohort A: users with 5-15 "inventory checked" events
+ *   - Cohort B: users with 0-4 "inventory checked" events
+ *   - Event: "purchase order created"
+ *   - Measure: Average of "quantity"
+ *   - Compare cohort A vs cohort B
+ *   - Expected: cohort A ~ 1.25x higher quantity than B
+ *
+ *   Report 2: POs per User by Browse Intensity
+ *   - Report type: Insights (with cohort)
+ *   - Cohort C: users with >= 16 "inventory checked" events
+ *   - Cohort A: users with 5-15 "inventory checked" events
+ *   - Event: "purchase order created"
+ *   - Measure: Total events per user
+ *   - Compare cohort C vs cohort A
+ *   - Expected: cohort C has ~ 30% fewer POs per user
+ *
+ * REAL-WORLD ANALOGUE: A focused operations team that monitors
+ * stock just enough places larger, more confident orders; an
+ * obsessive checker is paralysed and orders less.
+ *
  * ===================================================================
  * EXPECTED METRICS SUMMARY
  * ===================================================================
@@ -256,14 +302,18 @@ const supplierIds = v.range(1, 150).map(() => `SUP_${v.uid(6)}`);
  * Alert Fatigue               | response_time_hours | 4h       | 8-12h   | 2-3x
  * Trial Churn                 | events after wk 1   | 5        | 2.5     | 0.5x
  * Enterprise Profiles         | warehouse_count     | 3        | 10      | 3.3x
- * Small-Biz Conversion Drop  | funnel conversion   | 30%      | 20%     | 0.65x
+ * Small-Biz Conversion Drop   | funnel conversion   | 30%      | 20%     | 0.65x
+ * Inventory-Check Magic Num   | sweet PO quantity   | 1x       | 1.25x   | 1.25x
+ * Inventory-Check Magic Num   | over POs/user       | 1x       | 0.7x    | -30%
  */
 
 /** @type {Config} */
 const config = {
 	token,
 	seed: SEED,
-	numDays: num_days,
+	datasetStart: "2026-01-01T00:00:00Z",
+	datasetEnd: "2026-04-28T23:59:59Z",
+	// numDays: num_days,
 	avgEventsPerUserPerDay: avg_events_per_user_per_day,
 	numUsers: num_users,
 	hasAnonIds: false,
@@ -691,6 +741,27 @@ const config = {
 
 	// -- Hook Function ------------------------------------------------
 	hook: function (record, type, meta) {
+		// HOOK 10 (T2C): ONBOARDING TIME-TO-CONVERT (funnel-post)
+		// Enterprise tier completes Onboarding funnel 1.4x faster (factor 0.71);
+		// small_business 1.3x slower (factor 1.3).
+		if (type === "funnel-post") {
+			const segment = meta?.profile?.company_tier;
+			if (Array.isArray(record) && record.length > 1) {
+				const factor = (
+					segment === "enterprise" ? 0.71 :
+					segment === "small_business" || segment === "trial" ? 1.3 :
+					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 7: ENTERPRISE PROFILES (user) -----------------------
 		// Enterprise ops get large warehouse_count and employee_count.
 		if (type === "user") {
@@ -823,6 +894,24 @@ const config = {
 				}
 			}
 
+			// -- HOOK 9: INVENTORY-CHECK MAGIC NUMBER (no flags) ------
+			// Sweet 5-15 inventory checks → +25% PO quantity.
+			// Over 16+ → drop 30% of PO created events.
+			const invCheckCount = record.filter(e => e.event === 'inventory checked').length;
+			if (invCheckCount >= 5 && invCheckCount <= 15) {
+				record.forEach(e => {
+					if (e.event === 'purchase order created' && typeof e.quantity === 'number') {
+						e.quantity = Math.round(e.quantity * 1.25);
+					}
+				});
+			} else if (invCheckCount >= 16) {
+				for (let i = record.length - 1; i >= 0; i--) {
+					if (record[i].event === 'purchase order created' && chance.bool({ likelihood: 30 })) {
+						record.splice(i, 1);
+					}
+				}
+			}
+
 			return record;
 		}
 

package/dungeons/vertical/marketplace.js

@@ -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 */
 
 // Generate consistent seller store and listing IDs at module level
@@ -56,33 +53,33 @@ const listingIds = v.range(1, 500).map(() => `LST_${v.uid(8)}`);
 
 /**
  * ═══════════════════════════════════════════════════════════════
- * ANALYTICS HOOKS (8 hooks)
+ * ANALYTICS HOOKS (10 hooks)
+ *
+ * NOTE: All cohort effects are HIDDEN — no flag stamping. Discoverable via
+ * raw-prop breakdowns (segment, day, category) or behavioral cohorts.
+ *
+ * Adds 9. BROWSE TO PURCHASE TIME-TO-CONVERT and 10. MESSAGE-COUNT MAGIC
+ * NUMBER on top of original 8.
  * ═══════════════════════════════════════════════════════════════
  *
  * ───────────────────────────────────────────────────────────────
- * 1. FEE CHANGE IMPACT (event hook)
+ * 1. FEE CHANGE IMPACT (everything hook)
  * ───────────────────────────────────────────────────────────────
  *
  * PATTERN: After day 45 (permanent marketplace fee increase), all
  * "listing created" events get listing_fee multiplied by 1.3x.
- * Simulates the revenue impact of a platform fee adjustment.
+ * Simulates the revenue impact of a platform fee adjustment. No flag —
+ * discover via line chart of avg listing_fee over time.
  *
  * HOW TO FIND IT IN MIXPANEL:
  *
- *   Report 1: Listing Fee Before vs After Fee Change
+ *   Report 1: Listing Fee Over Time
  *   • Report type: Insights
  *   • Event: "listing created"
  *   • Measure: Average of "listing_fee"
  *   • Line chart by week
  *   • Expected: Clear step-up around day 45 from ~$15 avg to ~$20 avg
  *
- *   Report 2: Fee Change Flag Distribution
- *   • Report type: Insights
- *   • Event: "listing created"
- *   • Measure: Total
- *   • Breakdown: "fee_change"
- *   • Expected: "increased" appears only after day 45
- *
  * REAL-WORLD ANALOGUE: Marketplace platforms periodically adjust
  * commission/listing fees, impacting seller economics and behavior.
  *
@@ -238,27 +235,79 @@ const listingIds = v.range(1, 500).map(() => `LST_${v.uid(8)}`);
  * REAL-WORLD ANALOGUE: Returning buyers have established trust
  * and familiarity with the platform, converting at higher rates.
  *
+ * ───────────────────────────────────────────────────────────────
+ * 9. BROWSE TO PURCHASE TIME-TO-CONVERT (funnel-post)
+ *
+ * PATTERN: Power_seller and frequent_buyer users complete the
+ * Browse to Purchase funnel 1.4x faster (factor 0.71); window_shopper
+ * 1.4x slower (factor 1.4).
+ *
+ * HOW TO FIND IT IN MIXPANEL:
+ *
+ *   Report 1: Browse to Purchase Median Time-to-Convert by Segment
+ *   - Funnels > "item searched" -> "item viewed" -> "add to cart" -> "purchase completed"
+ *   - Measure: Median time to convert
+ *   - Breakdown: segment
+ *   - Expected: power/frequent ~ 0.71x; window ~ 1.4x
+ *
+ *   NOTE (funnel-post measurement): visible only via Mixpanel funnel
+ *   median TTC. Cross-event MIN→MIN SQL queries on raw events do NOT
+ *   show this — funnel-post adjusts gaps within funnel instances, not
+ *   across the user's full event history.
+ *
+ * ───────────────────────────────────────────────────────────────
+ * 10. MESSAGE-COUNT MAGIC NUMBER (in-funnel, everything)
+ *
+ * PATTERN: Sweet 2-5 message-sent events between item-viewed and
+ * offer-received → +35% on offer_amount of offer-received events.
+ * Over 6+ → drop 25% of purchase-completed events (haggling deadlock).
+ * No flag.
+ *
+ * HOW TO FIND IT IN MIXPANEL:
+ *
+ *   Report 1: Avg Offer Amount by Message Bucket
+ *   - Cohort A: users with 2-5 messages between item-viewed and offer-received
+ *   - Cohort B: users with 0-1
+ *   - Event: "offer received"
+ *   - Measure: Average of "offer_amount"
+ *   - Expected: A ~ 1.35x B
+ *
+ *   Report 2: Purchase Rate on Heavy Messengers
+ *   - Cohort C: users with >= 6 messages
+ *   - Cohort A: users with 2-5
+ *   - Event: "purchase completed"
+ *   - Measure: Total per user
+ *   - Expected: C ~ 25% fewer purchases per user
+ *
+ * REAL-WORLD ANALOGUE: A few quick clarifying messages close deals;
+ * extended haggling kills conversion.
+ *
  * ═══════════════════════════════════════════════════════════════
  * EXPECTED METRICS SUMMARY
  * ═══════════════════════════════════════════════════════════════
  *
- * Hook                        | Metric              | Baseline | Effect  | Ratio
- * ────────────────────────────|─────────────────────|──────────|─────────|──────
- * Fee Change Impact           | listing_fee         | $15      | $20     | 1.3x
- * Weekend Shopping Surge      | total_amount        | $60      | $72     | 1.2x
- * Seller Success → Trust      | purchases/user      | 3        | 6       | 2x
- * Electronics Category Lift   | electronics purch.  | baseline | 1.5x   | 1.5x
- * Response Time → Conversion  | offer_accepted/user | 1        | 2       | 2x
- * New Seller Churn            | events post-day-14  | 100%     | 60%     | 0.6x
- * Power Seller Profiles       | total_transactions  | 0        | 100-500 | --
- * Frequent Buyer Funnel       | funnel conversion   | 30%      | 39%     | 1.3x
+ * Hook                        | Metric              | Baseline | Effect    | Ratio
+ * ----------------------------|---------------------|----------|-----------|------
+ * Fee Change Impact           | listing_fee post-D45| 1x       | 1.3x      | 1.3x
+ * Weekend Shopping Surge      | total_amount Sat/Sun| 1x       | 1.2x      | 1.2x
+ * Seller Success → Trust      | purchases/user      | 1x       | 2x        | 2x
+ * Electronics Category Lift   | electronics purch.  | 1x       | 1.5x      | 1.5x
+ * Response Time → Conversion  | offer_accepted/user | 1x       | 2x        | 2x
+ * New Seller Churn            | events post-D14     | 1x       | 0.6x      | -40%
+ * Power Seller Profiles       | total_transactions  | 0        | 100-500   | --
+ * Frequent Buyer Funnel       | funnel conversion   | 30%      | 39%       | 1.3x
+ * Browse to Purchase T2C      | median min by segment| 1x      | 0.71/1.4x | ~ 2x range
+ * Message Magic Number        | sweet offer_amount  | 1x       | 1.35x     | 1.35x
+ * Message Magic Number        | over purchases/user | 1x       | 0.75x     | -25%
  */
 
 /** @type {Config} */
 const config = {
 	token,
 	seed: SEED,
-	numDays: num_days,
+	datasetStart: "2026-01-01T00:00:00Z",
+	datasetEnd: "2026-04-28T23:59:59Z",
+	// numDays: num_days,
 	avgEventsPerUserPerDay: avg_events_per_user_per_day,
 	numUsers: num_users,
 	hasAnonIds: false,
@@ -336,7 +385,6 @@ const config = {
 				item_count: u.weighNumRange(1, 5, 0.3),
 				payment_method: ["credit_card", "credit_card", "paypal", "apple_pay", "debit"],
 				shipping_method: ["standard", "standard", "express", "pickup"],
-				is_whale_purchase: [false],
 			},
 		},
 		{
@@ -348,7 +396,6 @@ const config = {
 				asking_price: u.weighNumRange(5, 500, 0.3, 50),
 				condition: ["new", "new", "like_new", "good", "fair"],
 				listing_fee: u.weighNumRange(5, 30, 0.5, 15),
-				fee_change: ["none"],
 			},
 		},
 		{
@@ -728,31 +775,34 @@ const config = {
 			}
 		}
 
-		// ── HOOK 8: FREQUENT BUYER FUNNEL LIFT (funnel-pre) ──
-		// (conversionRate filtering moved to everything hook)
-		if (type === "funnel-pre") {
-			// no-op: conversion filtering handled via event dropping in everything hook
-		}
-
-		// ── HOOK 1: FEE CHANGE IMPACT (event) ────────────────
-		// Listings after day 45 get 1.3x higher listing_fee.
-		if (type === "event") {
-			const FEE_CHANGE_DAY = DATASET_START.add(45, "days");
-			if (record.event === "listing created") {
-				const eventTime = dayjs(record.time);
-				if (eventTime.isAfter(FEE_CHANGE_DAY)) {
-					record.listing_fee = Math.floor((record.listing_fee || 15) * 1.3);
-					record.fee_change = "increased";
+		// HOOK 9 (T2C): BROWSE TO PURCHASE TIME-TO-CONVERT (funnel-post)
+		// Power_seller users complete Browse to Purchase funnel 1.4x faster
+		// (factor 0.71); window_shopper 1.4x slower (factor 1.4).
+		if (type === "funnel-post") {
+			const segment = meta?.profile?.segment;
+			if (Array.isArray(record) && record.length > 1) {
+				const factor = (
+					segment === "power_seller" || segment === "frequent_buyer" ? 0.71 :
+					segment === "window_shopper" ? 1.4 :
+					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 2: WEEKEND SHOPPING SURGE ───────────────
-			// Moved to the everything hook (after purchase cloning)
-			// so the 1.2x boost applies to both original AND cloned purchases.
 		}
 
+		// HOOK 1: FEE CHANGE IMPACT — moved to everything hook below.
+		// (event hook fires before bunchIntoSessions reshuffles timestamps)
+
 		// ── EVERYTHING HOOKS ─────────────────────────────────
 		if (type === "everything") {
+			const datasetStart = dayjs.unix(meta.datasetStart);
+			const FEE_CHANGE_DAY = datasetStart.add(45, "days");
 			let events = record;
 			if (!events.length) return record;
 
@@ -767,6 +817,14 @@ const config = {
 				});
 			}
 
+			// HOOK 1: FEE CHANGE IMPACT — listings after d45 get listing_fee 1.3x.
+			// In everything hook so timestamp comparison sees post-bunchIntoSessions times.
+			events.forEach(e => {
+				if (e.event === "listing created" && dayjs(e.time).isAfter(FEE_CHANGE_DAY)) {
+					e.listing_fee = Math.floor((e.listing_fee || 15) * 1.3);
+				}
+			});
+
 			// ── HOOK 8: FREQUENT BUYER CONVERSION FILTER ────
 			// Non-frequent-buyer users drop ~25% of "purchase completed"
 			// (last step of Browse to Purchase funnel) to simulate lower conversion.
@@ -851,7 +909,7 @@ const config = {
 			// ── HOOK 6: NEW SELLER CHURN ─────────────────────
 			// New sellers with <10 events lose 40% of events after day 14.
 			if (profile && profile.segment === "new_seller" && events.length < 10) {
-				const DAY_14 = DATASET_START.add(14, "days");
+				const DAY_14 = datasetStart.add(14, "days");
 				for (let i = events.length - 1; i >= 0; i--) {
 					const eventTime = dayjs(events[i].time);
 					if (eventTime.isAfter(DAY_14) && chance.bool({ likelihood: 40 })) {
@@ -860,19 +918,47 @@ const config = {
 				}
 			}
 
-			// ── HOOK 2: WEEKEND SHOPPING SURGE (everything) ─────
-			// Applied AFTER all purchase cloning (Hooks 3, 4) so the
-			// 1.2x boost hits both original and injected purchases.
+			// HOOK 2: WEEKEND SHOPPING SURGE — Sat/Sun purchases get
+			// total_amount 1.2x. Mutates raw prop. No flag.
 			events.forEach(e => {
 				if (e.event === "purchase completed") {
 					const dow = new Date(e.time).getUTCDay();
-					// Saturday=6, Sunday=0
 					if (dow === 0 || dow === 6) {
 						e.total_amount = Math.floor((e.total_amount || 60) * 1.2);
 					}
 				}
 			});
 
+			// HOOK 10: MESSAGE-COUNT MAGIC NUMBER (in-funnel, no flags)
+			// Sweet 2-5 message-sent events between item-viewed and
+			// offer-received → +35% on offer-received offer_amount/asking_price.
+			// Over 6+ → drop 25% of purchase-completed events (over-message
+			// signals haggling deadlock).
+			const itemViewed = events.find(e => e.event === "item viewed");
+			const offerReceived = events.find(e => e.event === "offer received");
+			if (itemViewed && offerReceived) {
+				const aTime = dayjs(itemViewed.time);
+				const bTime = dayjs(offerReceived.time);
+				const msgBetween = events.filter(e =>
+					e.event === "message sent" &&
+					dayjs(e.time).isAfter(aTime) &&
+					dayjs(e.time).isBefore(bTime)
+				).length;
+				if (msgBetween >= 2 && msgBetween <= 5) {
+					events.forEach(e => {
+						if (e.event === "offer received" && typeof e.offer_amount === "number") {
+							e.offer_amount = Math.round(e.offer_amount * 1.35);
+						}
+					});
+				} else if (msgBetween >= 6) {
+					for (let i = events.length - 1; i >= 0; i--) {
+						if (events[i].event === "purchase completed" && chance.bool({ likelihood: 25 })) {
+							events.splice(i, 1);
+						}
+					}
+				}
+			}
+
 			return record;
 		}