@ak--47/dungeon-master 1.0.0 → 1.1.0

package/dungeons/vertical/insurance-application-schema.json

@@ -0,0 +1,466 @@
+{
+  "events": [
+    {
+      "event": "account created",
+      "isFirstEvent": true,
+      "properties": {
+        "signup_source": [
+          "web",
+          "mobile",
+          "agent_referral",
+          "partner"
+        ],
+        "account_type": [
+          "individual",
+          "family",
+          "business"
+        ]
+      }
+    },
+    {
+      "event": "page viewed",
+      "weight": 10,
+      "properties": {
+        "page_name": [
+          "home",
+          "quotes",
+          "coverage_options",
+          "claims",
+          "faq",
+          "profile",
+          "payment",
+          "documents"
+        ],
+        "referrer": [
+          "direct",
+          "google",
+          "email",
+          "social_media"
+        ]
+      }
+    },
+    {
+      "event": "quote requested",
+      "weight": 5,
+      "properties": {
+        "coverage_level": [
+          "basic",
+          "standard",
+          "premium"
+        ],
+        "deductible": {
+          "$range": [
+            443,
+            4473
+          ]
+        }
+      }
+    },
+    {
+      "event": "quote received",
+      "weight": 4,
+      "properties": {
+        "monthly_premium": {
+          "$range": [
+            164,
+            651
+          ]
+        },
+        "coverage_amount": {
+          "$range": [
+            79151,
+            430388
+          ]
+        },
+        "quote_comparison_count": [
+          2,
+          4
+        ]
+      }
+    },
+    {
+      "event": "application started",
+      "weight": 4,
+      "properties": {
+        "coverage_level": [
+          "basic",
+          "standard",
+          "premium"
+        ],
+        "estimated_premium": {
+          "$range": [
+            175,
+            646
+          ]
+        }
+      }
+    },
+    {
+      "event": "application step completed",
+      "weight": 6,
+      "properties": {
+        "step_name": [
+          "personal_info",
+          "coverage_selection",
+          "medical_history",
+          "vehicle_info",
+          "beneficiary",
+          "review"
+        ],
+        "step_number": {
+          "$range": [
+            1,
+            5
+          ]
+        },
+        "time_on_step_sec": {
+          "$range": [
+            121,
+            491
+          ]
+        }
+      }
+    },
+    {
+      "event": "document uploaded",
+      "weight": 3,
+      "properties": {
+        "document_type": [
+          "drivers_license",
+          "proof_of_address",
+          "vehicle_registration",
+          "medical_records",
+          "property_photos"
+        ],
+        "file_size_kb": {
+          "$range": [
+            552,
+            4345
+          ]
+        }
+      }
+    },
+    {
+      "event": "application submitted",
+      "weight": 3,
+      "properties": {
+        "documents_attached": [
+          4
+        ],
+        "application_time_min": {
+          "$range": [
+            17,
+            47
+          ]
+        }
+      }
+    },
+    {
+      "event": "application approved",
+      "weight": 2,
+      "properties": {
+        "approved_premium": {
+          "$range": [
+            130,
+            648
+          ]
+        },
+        "approval_time_hours": {
+          "$range": [
+            8,
+            61
+          ]
+        }
+      }
+    },
+    {
+      "event": "policy activated",
+      "weight": 2,
+      "properties": {
+        "policy_term_months": [
+          6,
+          12,
+          24
+        ],
+        "effective_date_offset_days": [
+          10,
+          23,
+          21,
+          22,
+          19,
+          14,
+          18
+        ]
+      }
+    },
+    {
+      "event": "claim filed",
+      "weight": 2,
+      "properties": {
+        "claim_type": [
+          "collision",
+          "theft",
+          "water_damage",
+          "fire",
+          "medical",
+          "liability"
+        ],
+        "estimated_amount": {
+          "$range": [
+            5885,
+            43341
+          ]
+        }
+      }
+    },
+    {
+      "event": "claim status checked",
+      "weight": 4,
+      "properties": {
+        "claim_status": [
+          "submitted",
+          "under_review",
+          "approved",
+          "denied",
+          "payment_pending"
+        ],
+        "days_since_filed": [
+          48,
+          20,
+          42,
+          12,
+          35,
+          27,
+          47,
+          21
+        ]
+      }
+    },
+    {
+      "event": "payment made",
+      "weight": 5,
+      "properties": {
+        "payment_method": [
+          "credit_card",
+          "bank_transfer",
+          "auto_pay",
+          "check"
+        ],
+        "amount": {
+          "$range": [
+            181,
+            677
+          ]
+        },
+        "payment_status": [
+          "success",
+          "failed"
+        ]
+      }
+    },
+    {
+      "event": "support ticket created",
+      "weight": 4,
+      "properties": {
+        "issue_category": [
+          "billing",
+          "claims",
+          "coverage",
+          "technical",
+          "policy_change"
+        ],
+        "priority": [
+          "low",
+          "medium",
+          "high"
+        ],
+        "channel": [
+          "chat",
+          "phone",
+          "email",
+          "web_form"
+        ],
+        "pre_release_bug": [
+          false
+        ]
+      }
+    },
+    {
+      "event": "support ticket resolved",
+      "weight": 3,
+      "properties": {
+        "resolution_type": [
+          "self_service",
+          "agent_assisted",
+          "escalated",
+          "auto_resolved"
+        ],
+        "satisfaction_score": [
+          3,
+          2,
+          4
+        ],
+        "resolution_time_hours": [
+          53,
+          50,
+          57,
+          52,
+          20,
+          54,
+          36,
+          17
+        ]
+      }
+    },
+    {
+      "event": "coverage reviewed",
+      "weight": 4,
+      "properties": {
+        "current_premium": {
+          "$range": [
+            183,
+            666
+          ]
+        },
+        "coverage_adequate": [
+          true,
+          false
+        ]
+      }
+    },
+    {
+      "event": "profile updated",
+      "weight": 2,
+      "properties": {
+        "field_updated": [
+          "address",
+          "phone",
+          "email",
+          "beneficiary",
+          "payment_method",
+          "vehicle_info"
+        ]
+      }
+    },
+    {
+      "event": "renewal completed",
+      "weight": 2,
+      "properties": {
+        "renewal_premium": {
+          "$range": [
+            162,
+            651
+          ]
+        },
+        "premium_change_pct": [
+          14,
+          -4,
+          6
+        ],
+        "auto_renewed": [
+          true,
+          false
+        ]
+      }
+    }
+  ],
+  "superProps": {
+    "platform": [
+      "web",
+      "ios",
+      "android"
+    ],
+    "insurance_type": [
+      "auto",
+      "home",
+      "life",
+      "health",
+      "renters"
+    ],
+    "app_version": [
+      "2.10"
+    ]
+  },
+  "userProps": {
+    "age_range": [
+      "18-25",
+      "26-35",
+      "36-45",
+      "46-55",
+      "56-65",
+      "65+"
+    ],
+    "risk_profile": [
+      "low",
+      "medium",
+      "high"
+    ],
+    "policy_count": [
+      3
+    ],
+    "lifetime_premium": {
+      "$range": [
+        8131,
+        43291
+      ]
+    },
+    "preferred_contact": [
+      "email",
+      "phone",
+      "app_notification"
+    ]
+  },
+  "funnels": [
+    {
+      "sequence": [
+        "account created",
+        "page viewed",
+        "quote requested"
+      ],
+      "isFirstFunnel": true,
+      "conversionRate": 85,
+      "timeToConvert": 0.5
+    },
+    {
+      "sequence": [
+        "application started",
+        "application step completed",
+        "document uploaded",
+        "application submitted"
+      ],
+      "conversionRate": 60,
+      "timeToConvert": 48,
+      "weight": 4
+    },
+    {
+      "sequence": [
+        "application submitted",
+        "application approved",
+        "policy activated"
+      ],
+      "conversionRate": 70,
+      "timeToConvert": 72,
+      "weight": 3
+    },
+    {
+      "sequence": [
+        "claim filed",
+        "claim status checked",
+        "support ticket created"
+      ],
+      "conversionRate": 50,
+      "timeToConvert": 24,
+      "weight": 2
+    },
+    {
+      "sequence": [
+        "coverage reviewed",
+        "payment made",
+        "renewal completed"
+      ],
+      "conversionRate": 65,
+      "timeToConvert": 72,
+      "weight": 3
+    }
+  ]
+}

package/dungeons/{insurance-application.js → vertical/insurance-application.js}

@@ -1,7 +1,7 @@
 import dayjs from "dayjs";
 import utc from "dayjs/plugin/utc.js";
 import "dotenv/config";
-import * as u from "../lib/utils/utils.js";
+import * as u from "../../lib/utils/utils.js";
 
 const SEED = "dm4-insurance";
 dayjs.extend(utc);
@@ -9,7 +9,7 @@ const chance = u.initChance(SEED);
 const num_users = 5_000;
 const days = 100;
 
-/** @typedef {import("../types").Dungeon} Config */
+/** @typedef {import("../../types").Dungeon} Config */
 
 /*
  * ===================================================================
@@ -49,9 +49,11 @@ const days = 100;
  * ===================================================================
  *
  * -------------------------------------------------------------------
- * 1. VERSION STAMPING (event hook)
+ * 1. VERSION STAMPING (everything hook)
  * -------------------------------------------------------------------
- * Every event gets a deterministic app_version based on its timestamp.
+ * Every event gets a deterministic app_version based on its final
+ * timestamp. Uses the everything hook (not event hook) because funnel
+ * events adjust their time AFTER the event hook runs.
  * All users shift simultaneously on release dates:
  *   - Days 0-30:    v2.10
  *   - Days 30-60:   v2.11
@@ -317,6 +319,7 @@ const config = {
 				],
 				priority: ["low", "medium", "medium", "high"],
 				channel: ["chat", "phone", "email", "web_form"],
+				pre_release_bug: [false],
 			},
 		},
 		{
@@ -424,6 +427,7 @@ const config = {
 	superProps: {
 		platform: ["web", "ios", "android"],
 		insurance_type: ["auto", "home", "life", "health", "renters"],
+		app_version: ["2.10"],
 	},
 
 	// ── User Props (set once per user) ──
@@ -441,9 +445,11 @@ const config = {
 	 *
 	 * This hook function creates 3 deliberate patterns in the data:
 	 *
-	 * 1. VERSION STAMPING (event): Every event gets a deterministic app_version
-	 *    based on its timestamp. v2.10 → v2.11 → v2.12 → v2.13.
-	 *    All users shift simultaneously on release dates.
+	 * 1. VERSION STAMPING (everything): Every event gets a deterministic app_version
+	 *    based on its final timestamp. v2.10 → v2.11 → v2.12 → v2.13.
+	 *    All users shift simultaneously on release dates. Uses the everything
+	 *    hook (not event hook) because funnel events adjust time after the
+	 *    event hook runs.
 	 *
 	 * 2. SUPPORT TICKET VOLUME (everything): Pre-v2.13 period has inflated
 	 *    support ticket volume (2-3 extra tickets per user with bug-related
@@ -457,32 +463,30 @@ const config = {
 	 */
 	hook: function (record, type, meta) {
 		// =============================================================
-		// Hook #1: VERSION STAMPING (event)
-		// Deterministic app_version on every event based on timestamp.
-		// v2.10 (days 0-30) → v2.11 (30-60) → v2.12 (60-90) → v2.13 (last 10 days)
-		// =============================================================
-		if (type === "event") {
-			const eventTime = dayjs(record.time);
-
-			if (eventTime.isBefore(V211_DATE)) {
-				record.app_version = "2.10";
-			} else if (eventTime.isBefore(V212_DATE)) {
-				record.app_version = "2.11";
-			} else if (eventTime.isBefore(V213_DATE)) {
-				record.app_version = "2.12";
-			} else {
-				record.app_version = "2.13";
-			}
-		}
-
-		// =============================================================
-		// Hook #2 & #3: SUPPORT TICKET VOLUME + APPLICATION CONVERSION
-		// (everything)
+		// Hooks #1-#3 all run in the "everything" hook so that version
+		// stamping sees final timestamps (funnel events adjust time
+		// AFTER the event hook runs).
 		// =============================================================
 		if (type === "everything") {
 			const userEvents = record;
 			if (userEvents.length === 0) return record;
 
+			// ─── Hook #1: VERSION STAMPING ───
+			// Deterministic app_version on every event based on its final timestamp.
+			// v2.10 (days 0-30) → v2.11 (30-60) → v2.12 (60-90) → v2.13 (last 10 days)
+			for (const evt of userEvents) {
+				const eventTime = dayjs(evt.time);
+				if (eventTime.isBefore(V211_DATE)) {
+					evt.app_version = "2.10";
+				} else if (eventTime.isBefore(V212_DATE)) {
+					evt.app_version = "2.11";
+				} else if (eventTime.isBefore(V213_DATE)) {
+					evt.app_version = "2.12";
+				} else {
+					evt.app_version = "2.13";
+				}
+			}
+
 			// Find a user_id from any existing event
 			const userId =
 				userEvents.find((e) => e.user_id)?.user_id ||
@@ -531,7 +535,7 @@ const config = {
 					}
 
 					userEvents.push({
-						event: "support ticket created",
+						...sourceTicket,
 						time: newTime.toISOString(),
 						user_id: userId,
 						app_version: injectedVersion,