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

package/dungeons/vertical/education.js

@@ -1,16 +1,23 @@
+// ── TWEAK THESE ──
+const SEED = "harness-education";
+const num_days = 100;
+const num_users = 5_000;
+const avg_events_per_user = 120;
+let token = "your-mixpanel-token";
+
+// ── env overrides ──
+if (process.env.MP_TOKEN) token = process.env.MP_TOKEN;
+
 import dayjs from "dayjs";
 import utc from "dayjs/plugin/utc.js";
 import "dotenv/config";
 import * as u from "../../lib/utils/utils.js";
 import * as v from "ak-tools";
 
-const SEED = "harness-education";
 dayjs.extend(utc);
 const chance = u.initChance(SEED);
-const num_users = 5_000;
-const days = 100;
 
-/** @typedef  {import("../types.d.ts").Dungeon} Config */
+/** @typedef  {import("../../types").Dungeon} Config */
 
 /**
  * ═══════════════════════════════════════════════════════════════════════════════
@@ -183,10 +190,10 @@ const problemIds = v.range(1, 601).map(n => `problem_${v.uid(6)}`);
 
 /** @type {Config} */
 const config = {
-	token: "",
+	token,
 	seed: SEED,
-	numDays: days,
-	numEvents: num_users * 120,
+	numDays: num_days,
+	numEvents: num_users * avg_events_per_user,
 	numUsers: num_users,
 	hasAnonIds: false,
 	hasSessionIds: true,
@@ -203,7 +210,6 @@ const config = {
 	hasAdSpend: false,
 	percentUsersBornInDataset: 50,
 	hasAvatar: true,
-	batchSize: 2_500_000,
 	concurrency: 1,
 	writeToDisk: false,
 
@@ -437,10 +443,24 @@ const config = {
 	],
 
 	superProps: {
-		platform: ["Web", "iOS", "Android", "iPad"],
+		Platform: ["Web", "iOS", "Android", "iPad"],
 	},
 
-	scdProps: {},
+	scdProps: {
+		enrollment_status: {
+			values: ["enrolled", "active", "completed", "dropped"],
+			frequency: "month",
+			timing: "fuzzy",
+			max: 6
+		},
+		course_status: {
+			values: ["draft", "published", "archived", "deprecated"],
+			frequency: "month",
+			timing: "fixed",
+			max: 6,
+			type: "course_id"
+		}
+	},
 
 	userProps: {
 		"account_type": ["student", "student", "student", "student", "student", "student", "student", "student", "instructor"],
@@ -453,6 +473,7 @@ const config = {
 		"instructor_rating": [0],
 		"learning_goal": ["none"],
 		"study_hours_per_week": [0],
+		"Platform": ["Web", "iOS", "Android", "iPad"],
 	},
 
 	groupKeys: [
@@ -492,7 +513,7 @@ const config = {
 	 */
 	hook: function (record, type, meta) {
 		const NOW = dayjs();
-		const DATASET_START = NOW.subtract(days, 'days');
+		const DATASET_START = NOW.subtract(num_days, 'days');
 
 		// ═══════════════════════════════════════════════════════════════════
 		// Hook #1: STUDENT VS INSTRUCTOR PROFILES
@@ -608,8 +629,16 @@ const config = {
 		// ═══════════════════════════════════════════════════════════════════
 		if (type === "everything") {
 			const userEvents = record;
+			const profile = meta.profile;
 			const firstEventTime = userEvents.length > 0 ? dayjs(userEvents[0].time) : null;
 
+			// ── Stamp superProps from profile so they stay consistent per user ──
+			if (profile) {
+				userEvents.forEach((event) => {
+					if (profile.Platform !== undefined) event.Platform = profile.Platform;
+				});
+			}
+
 			// ---------------------------------------------------------------
 			// First pass: identify user patterns
 			// ---------------------------------------------------------------
@@ -707,7 +736,7 @@ const config = {
 			}
 
 			// Hook #7: FREE VS PAID - reinforce the subscription effect on certificates
-			const subStatus = meta && meta.profile ? meta.profile.subscription_status : "free";
+			const subStatus = profile ? profile.subscription_status : "free";
 			if (subStatus === "free") {
 				// Free users lose 55% of their certificates (simulating lower completion)
 				for (let i = userEvents.length - 1; i >= 0; i--) {
@@ -765,17 +794,11 @@ const config = {
 		// Hook #7: FREE VS PAID COURSES (funnel-pre)
 		// ═══════════════════════════════════════════════════════════════════
 		if (type === "funnel-pre") {
-			// Target funnels containing course completion events
+			// Hook #7: FREE VS PAID — prop tagging only
+			// conversionRate manipulation removed; the everything hook handles
+			// the completion gap by dropping 55% of free-user certificates
 			if (meta && meta.profile && meta.funnel) {
-				const subscriptionStatus = meta.profile.subscription_status;
-
-				if (subscriptionStatus === "free") {
-					// Free users convert at 0.5x rate
-					record.conversionRate = (record.conversionRate || 0.25) * 0.5;
-				} else if (subscriptionStatus === "monthly" || subscriptionStatus === "annual") {
-					// Paid subscribers convert at 1.5x rate
-					record.conversionRate = (record.conversionRate || 0.25) * 1.5;
-				}
+				// no-op: kept for future prop-setting if needed
 			}
 		}
 

package/dungeons/vertical/fintech-schema.json

@@ -5,8 +5,8 @@
       "isFirstEvent": true,
       "properties": {
         "account_type": [
-          "business",
-          "personal"
+          "personal",
+          "business"
         ],
         "signup_channel": [
           "app",
@@ -22,14 +22,14 @@
       "properties": {
         "session_duration_sec": {
           "$range": [
-            131,
-            471
+            115,
+            487
           ]
         },
         "pages_viewed": [
           5,
-          4,
-          6
+          10,
+          4
         ],
         "month_end_anxiety": [
           false
@@ -140,9 +140,10 @@
             2710
           ]
         },
-        "auto_pay": {
-          "$type": "array"
-        },
+        "auto_pay": [
+          false,
+          true
+        ],
         "missed_payment": [
           false
         ],
@@ -235,7 +236,8 @@
           ]
         },
         "action": [
-          "buy"
+          "buy",
+          "sell"
         ],
         "premium_returns": [
           false
@@ -316,13 +318,12 @@
           ]
         },
         "interest_rate": [
-          4,
-          14,
-          7,
           17,
           10,
           18,
-          8
+          8,
+          9,
+          6
         ]
       }
     },
@@ -336,13 +337,13 @@
           "premium"
         ],
         "new_tier": [
-          "premium",
-          "plus"
+          "plus",
+          "premium"
         ],
         "monthly_fee": [
-          14.99,
           4.99,
-          9.99
+          9.99,
+          14.99
         ]
       }
     },
@@ -363,9 +364,10 @@
           "transfer",
           "technical"
         ],
-        "resolved": {
-          "$type": "array"
-        },
+        "resolved": [
+          false,
+          true
+        ],
         "fraud_sequence": [
           false
         ]
@@ -383,9 +385,10 @@
           "security",
           "promo"
         ],
-        "action_taken": {
-          "$type": "array"
-        }
+        "action_taken": [
+          false,
+          true
+        ]
       }
     },
     {
@@ -399,15 +402,15 @@
           "partner_offer"
         ],
         "value": [
+          74,
+          39,
           23,
-          22,
-          58,
-          67,
-          26,
-          28,
-          29,
-          47,
-          20
+          30,
+          60,
+          73,
+          46,
+          25,
+          27
         ],
         "premium_reward": [
           false
@@ -415,71 +418,6 @@
       }
     }
   ],
-  "superProps": {
-    "account_tier": [
-      "plus",
-      "basic",
-      "premium"
-    ],
-    "platform": [
-      "ios",
-      "android",
-      "web"
-    ],
-    "low_balance_churn": [
-      false
-    ]
-  },
-  "userProps": {
-    "credit_score_range": [
-      "300-579",
-      "580-669",
-      "670-739",
-      "740-799",
-      "800-850"
-    ],
-    "income_bracket": [
-      "under_30k",
-      "30k_50k",
-      "50k_75k",
-      "75k_100k",
-      "100k_150k",
-      "over_150k"
-    ],
-    "account_age_months": {
-      "$range": [
-        17,
-        46
-      ]
-    },
-    "total_balance": {
-      "$range": [
-        16006,
-        83008
-      ]
-    },
-    "has_direct_deposit": {
-      "$type": "array"
-    },
-    "account_segment": [
-      "personal"
-    ],
-    "employee_count": [
-      0
-    ],
-    "annual_revenue": [
-      0
-    ],
-    "industry": [
-      ""
-    ],
-    "age_range": [
-      ""
-    ],
-    "life_stage": [
-      ""
-    ]
-  },
   "funnels": [
     {
       "sequence": [
@@ -559,5 +497,134 @@
       "conversionRate": 25,
       "timeToConvert": 10
     }
-  ]
+  ],
+  "superProps": {
+    "account_tier": [
+      "basic",
+      "plus",
+      "premium"
+    ],
+    "Platform": [
+      "ios",
+      "android",
+      "web"
+    ],
+    "low_balance_churn": [
+      false
+    ]
+  },
+  "userProps": {
+    "credit_score_range": [
+      "300-579",
+      "580-669",
+      "670-739",
+      "740-799",
+      "800-850"
+    ],
+    "income_bracket": [
+      "under_30k",
+      "30k_50k",
+      "50k_75k",
+      "75k_100k",
+      "100k_150k",
+      "over_150k"
+    ],
+    "account_age_months": {
+      "$range": [
+        15,
+        44
+      ]
+    },
+    "total_balance": {
+      "$range": [
+        16006,
+        83008
+      ]
+    },
+    "has_direct_deposit": [
+      false,
+      true
+    ],
+    "account_segment": [
+      "personal"
+    ],
+    "employee_count": [
+      0
+    ],
+    "annual_revenue": [
+      0
+    ],
+    "industry": [
+      ""
+    ],
+    "age_range": [
+      ""
+    ],
+    "life_stage": [
+      ""
+    ]
+  },
+  "groupKeys": [
+    {
+      "key": "household_id",
+      "count": 500,
+      "affectsEvents": [
+        "transaction completed",
+        "transfer sent",
+        "bill paid",
+        "savings goal set"
+      ]
+    }
+  ],
+  "groupProps": {
+    "household_id": {
+      "household_size": {
+        "$range": [
+          1,
+          6
+        ]
+      },
+      "combined_income": {
+        "$range": [
+          61633,
+          263131
+        ]
+      },
+      "financial_health_score": {
+        "$range": [
+          12,
+          81
+        ]
+      },
+      "primary_bank": [
+        "NexBank_only",
+        "multi_bank"
+      ]
+    }
+  },
+  "scdProps": {
+    "account_tier": {
+      "type": "user",
+      "frequency": "month",
+      "timing": "fuzzy",
+      "max": 6,
+      "values": [
+        "basic",
+        "plus",
+        "premium"
+      ]
+    },
+    "risk_category": {
+      "type": "household_id",
+      "frequency": "month",
+      "timing": "fixed",
+      "max": 8,
+      "values": [
+        "low",
+        "medium",
+        "high",
+        "critical"
+      ]
+    }
+  }
 }

package/dungeons/vertical/fintech.js

@@ -1,15 +1,22 @@
+// ── TWEAK THESE ──
+const SEED = "harness-fintech";
+const num_days = 100;
+const num_users = 5_000;
+const avg_events_per_user = 120;
+let token = "your-mixpanel-token";
+
+// ── env overrides ──
+if (process.env.MP_TOKEN) token = process.env.MP_TOKEN;
+
 import dayjs from "dayjs";
 import utc from "dayjs/plugin/utc.js";
 import "dotenv/config";
 import * as u from "../../lib/utils/utils.js";
 
-const SEED = "harness-fintech";
 dayjs.extend(utc);
 const chance = u.initChance(SEED);
-const num_users = 5_000;
-const days = 100;
 
-/** @typedef  {import("../types.d.ts").Dungeon} Config */
+/** @typedef  {import("../../types").Dungeon} Config */
 
 /**
  * ===================================================================
@@ -129,10 +136,10 @@ const days = 100;
 
 /** @type {Config} */
 const config = {
-	token: "",
+	token,
 	seed: SEED,
-	numDays: days,
-	numEvents: num_users * 120,
+	numDays: num_days,
+	numEvents: num_users * avg_events_per_user,
 	numUsers: num_users,
 	hasAnonIds: false,
 	hasSessionIds: true,
@@ -151,11 +158,24 @@ const config = {
 
 	hasAvatar: true,
 
-	batchSize: 2_500_000,
 	concurrency: 1,
 	writeToDisk: false,
 
-	scdProps: {},
+	scdProps: {
+		account_tier: {
+			values: ["basic", "plus", "premium"],
+			frequency: "month",
+			timing: "fuzzy",
+			max: 6
+		},
+		risk_category: {
+			values: ["low", "medium", "high", "critical"],
+			frequency: "month",
+			timing: "fixed",
+			max: 8,
+			type: "household_id"
+		}
+	},
 
 	funnels: [
 		{
@@ -387,11 +407,14 @@ const config = {
 
 	superProps: {
 		account_tier: ["basic", "basic", "basic", "plus", "plus", "premium"],
-		platform: ["ios", "android", "web"],
+		Platform: ["ios", "android", "web"],
 		low_balance_churn: [false],
 	},
 
 	userProps: {
+		account_tier: ["basic", "basic", "basic", "plus", "plus", "premium"],
+		Platform: ["ios", "android", "web"],
+		low_balance_churn: [false],
 		"credit_score_range": ["300-579", "580-669", "670-739", "740-799", "800-850"],
 		"income_bracket": ["under_30k", "30k_50k", "50k_75k", "75k_100k", "100k_150k", "over_150k"],
 		"account_age_months": u.weighNumRange(1, 60, 0.5, 12),
@@ -436,7 +459,7 @@ const config = {
 	 */
 	hook: function (record, type, meta) {
 		const NOW = dayjs();
-		const DATASET_START = NOW.subtract(days, "days");
+		const DATASET_START = NOW.subtract(num_days, "days");
 
 		// ===============================================================
 		// Hook #1: PERSONAL VS BUSINESS ACCOUNTS (user)
@@ -568,6 +591,15 @@ const config = {
 		// ===============================================================
 		if (type === "everything") {
 			const userEvents = record;
+
+			// Stamp superProps from profile for consistency
+			const profile = meta.profile;
+			userEvents.forEach(e => {
+				e.account_tier = profile.account_tier;
+				e.Platform = profile.Platform;
+				e.low_balance_churn = profile.low_balance_churn;
+			});
+
 			const firstEventTime = userEvents.length > 0 ? dayjs(userEvents[0].time) : null;
 
 			// -----------------------------------------------------------