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

package/dungeons/vertical/community-schema.json

@@ -441,6 +441,9 @@
     },
     {
       "event": "account deactivated",
+      "isChurnEvent": true,
+      "returnLikelihood": 0.15,
+      "isStrictEvent": true,
       "properties": {
         "reason": [
           "lost_interest",
@@ -452,54 +455,6 @@
       }
     }
   ],
-  "superProps": {
-    "subscription_tier": [
-      "free",
-      "supporter",
-      "pro"
-    ],
-    "platform": [
-      "ios",
-      "android",
-      "web"
-    ],
-    "content_hub": [
-      "gaming",
-      "anime",
-      "movies",
-      "tv",
-      "comics",
-      "music"
-    ]
-  },
-  "userProps": {
-    "role": [
-      "reader",
-      "contributor",
-      "moderator",
-      "creator"
-    ],
-    "contributor_level": [
-      "newcomer"
-    ],
-    "articles_created": [
-      0
-    ],
-    "reputation_score": {
-      "$range": [
-        20,
-        76
-      ]
-    },
-    "preferred_hub": [
-      "gaming",
-      "anime",
-      "movies",
-      "tv",
-      "comics",
-      "music"
-    ]
-  },
   "funnels": [
     {
       "sequence": [
@@ -508,6 +463,7 @@
         "article viewed",
         "discussion posted"
       ],
+      "name": "Onboarding Flow",
       "isFirstFunnel": true,
       "conversionRate": 40,
       "timeToConvert": 72,
@@ -519,6 +475,7 @@
         "article published",
         "comment posted"
       ],
+      "name": "Content Creation",
       "conversionRate": 35,
       "timeToConvert": 48,
       "weight": 5
@@ -530,6 +487,7 @@
         "comment posted",
         "discussion posted"
       ],
+      "name": "Engagement Loop",
       "conversionRate": 30,
       "timeToConvert": 96,
       "weight": 4
@@ -540,6 +498,7 @@
         "profile updated",
         "notification received"
       ],
+      "name": "Creator to Supporter",
       "conversionRate": 45,
       "timeToConvert": 168,
       "weight": 2
@@ -549,9 +508,72 @@
         "report submitted",
         "moderation action"
       ],
+      "name": "Moderation Pipeline",
       "conversionRate": 60,
       "timeToConvert": 48,
       "weight": 2
     }
-  ]
+  ],
+  "superProps": {
+    "subscription_tier": [
+      "free",
+      "supporter",
+      "pro"
+    ],
+    "Platform": [
+      "ios",
+      "android",
+      "web"
+    ],
+    "content_hub": [
+      "gaming",
+      "anime",
+      "movies",
+      "tv",
+      "comics",
+      "music"
+    ]
+  },
+  "userProps": {
+    "role": [
+      "reader",
+      "contributor",
+      "moderator",
+      "creator"
+    ],
+    "contributor_level": [
+      "newcomer"
+    ],
+    "articles_created": [
+      0
+    ],
+    "reputation_score": {
+      "$range": [
+        20,
+        76
+      ]
+    },
+    "preferred_hub": [
+      "gaming",
+      "anime",
+      "movies",
+      "tv",
+      "comics",
+      "music"
+    ]
+  },
+  "scdProps": {
+    "contributor_level": {
+      "type": "user",
+      "frequency": "month",
+      "timing": "fuzzy",
+      "max": 8,
+      "values": [
+        "newcomer",
+        "regular",
+        "trusted",
+        "admin"
+      ]
+    }
+  }
 }

package/dungeons/vertical/community.js

@@ -1,16 +1,23 @@
+// ── TWEAK THESE ──
+const SEED = "dm4-community";
+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 = "dm4-community";
 dayjs.extend(utc);
 const chance = u.initChance(SEED);
-const num_users = 5_000;
-const days = 100;
 const NOW = dayjs();
-const DATASET_START = NOW.subtract(days, "days");
+const DATASET_START = NOW.subtract(num_days, "days");
 
 /** @typedef  {import("../../types").Dungeon} Config */
 
@@ -213,12 +220,12 @@ const communityIds = v.range(1, 30).map(() => `COMM_${v.uid(4)}`);
  * articles and high community reputation scores.
  *
  * -------------------------------------------------------------------
- * 8. PRO SUBSCRIBER CONTENT CREATION LIFT (funnel-pre hook)
+ * 8. PRO SUBSCRIBER CONTENT CREATION LIFT (everything hook)
  * -------------------------------------------------------------------
  *
- * PATTERN: Users with subscription_tier "pro" get 1.5x conversion
- * rate on the Content Creation funnel. Pro users have analytics and
- * tools that help them publish more effectively.
+ * PATTERN: Free-tier users drop 35% of final funnel step events
+ * ("comment posted"), creating a visible conversion gap between
+ * paid and free users. Pro/supporter users keep all their events.
  *
  * HOW TO FIND IT IN MIXPANEL:
  *
@@ -244,15 +251,15 @@ const communityIds = v.range(1, 30).map(() => `COMM_${v.uid(4)}`);
  * Edit War Detection            | edit_quality        | 3.0      | 1.5     | 0.5x
  * Lurker Churn                  | events after day 10 | 100%     | 40%     | 0.4x
  * Creator Profiles              | reputation_score    | 25       | 90      | 3.6x
- * Pro Content Creation Lift     | funnel conversion   | 35%      | 52%     | 1.5x
+ * Pro Content Creation Lift     | funnel conversion   | 35%      | 52%     | ~1.5x
  */
 
 /** @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,
@@ -269,10 +276,16 @@ const config = {
 	hasAdSpend: false,
 	percentUsersBornInDataset: 35,
 	hasAvatar: true,
-	batchSize: 2_500_000,
 	concurrency: 1,
 	writeToDisk: false,
-	scdProps: {},
+	scdProps: {
+		contributor_level: {
+			values: ["newcomer", "regular", "trusted", "admin"],
+			frequency: "month",
+			timing: "fuzzy",
+			max: 8
+		}
+	},
 	mirrorProps: {},
 	lookupTables: [],
 
@@ -498,7 +511,7 @@ const config = {
 	// -- SuperProps ----------------------------------------------------
 	superProps: {
 		subscription_tier: ["free", "free", "free", "free", "supporter", "pro"],
-		platform: ["ios", "android", "web"],
+		Platform: ["ios", "android", "web"],
 		content_hub: ["gaming", "anime", "movies", "tv", "comics", "music"],
 	},
 
@@ -509,6 +522,9 @@ const config = {
 		articles_created: [0],
 		reputation_score: u.weighNumRange(0, 100, 0.3, 25),
 		preferred_hub: ["gaming", "anime", "movies", "tv", "comics", "music"],
+		subscription_tier: ["free", "free", "free", "free", "supporter", "pro"],
+		Platform: ["ios", "android", "web"],
+		content_hub: ["gaming", "anime", "movies", "tv", "comics", "music"],
 	},
 
 	// -- Phase 2: Personas --------------------------------------------
@@ -679,18 +695,9 @@ const config = {
 			}
 		}
 
-		// -- HOOK 8: PRO SUBSCRIBER CONTENT CREATION LIFT (funnel-pre)
-		// Pro subscribers convert 1.5x better through content creation.
-		if (type === "funnel-pre") {
-			if (meta && meta.profile) {
-				const tier = meta.profile.subscription_tier;
-				if (tier === "pro") {
-					record.conversionRate = Math.min(record.conversionRate * 1.5, 95);
-				} else if (tier === "supporter") {
-					record.conversionRate = Math.min(record.conversionRate * 1.2, 90);
-				}
-			}
-		}
+		// -- HOOK 8: PRO SUBSCRIBER CONTENT CREATION LIFT
+		// Conversion differences handled in everything hook via event filtering.
+		// (funnel-pre conversionRate modifications are diluted by organic events)
 
 		// -- HOOK 1: WEEKEND CONTENT SURGE (event) --------------------
 		// Articles published on weekends get 1.5x word_count.
@@ -719,8 +726,28 @@ const config = {
 
 		// -- EVERYTHING HOOKS -----------------------------------------
 		if (type === "everything") {
-			const events = record;
+			let events = record;
 			if (!events.length) return record;
+			const profile = meta && meta.profile ? meta.profile : {};
+
+			// -- SUPERPROP STAMPING -----------------------------------
+			// Stamp superProp values from profile onto every event so
+			// they stay consistent per-user instead of randomizing per-event.
+			events.forEach(e => {
+				if (profile.subscription_tier) e.subscription_tier = profile.subscription_tier;
+				if (profile.Platform) e.Platform = profile.Platform;
+				if (profile.content_hub) e.content_hub = profile.content_hub;
+			});
+
+			// -- HOOK 8: PRO SUBSCRIBER CONTENT CREATION LIFT ---------
+			// Free-tier users drop 35% of final funnel step events to
+			// create visible conversion gap vs paid subscribers.
+			if (profile.subscription_tier !== "pro" && profile.subscription_tier !== "supporter") {
+				events = events.filter(e => {
+					if (e.event === "comment posted" && chance.bool({ likelihood: 35 })) return false;
+					return true;
+				});
+			}
 
 			// -- HOOK 3: POWER CREATOR ENGAGEMENT LIFT ----------------
 			// Users with >20 article_published events get 3x upvote_count.
@@ -739,7 +766,7 @@ const config = {
 
 			// -- HOOK 4: DISCUSSION DEPTH BY CONTRIBUTOR TYPE ---------
 			// Active contributors get cloned comment_posted events.
-			if (meta && meta.profile && meta.profile.segment === "active_contributor") {
+			if (profile.segment === "active_contributor") {
 				const templateComment = events.find(e => e.event === "comment posted");
 				if (templateComment) {
 					const existingComments = events.filter(e => e.event === "comment posted");
@@ -778,7 +805,7 @@ const config = {
 				}
 			}
 
-			return record;
+			return events;
 		}
 
 		return record;

package/dungeons/vertical/devtools-schema.json

@@ -463,6 +463,9 @@
     },
     {
       "event": "account deactivated",
+      "isChurnEvent": true,
+      "returnLikelihood": 0.15,
+      "isStrictEvent": true,
       "properties": {
         "reason": [
           "switched_provider",
@@ -475,53 +478,6 @@
       }
     }
   ],
-  "superProps": {
-    "subscription_tier": [
-      "free",
-      "team",
-      "business",
-      "enterprise"
-    ],
-    "platform": [
-      "web",
-      "desktop_app",
-      "cli"
-    ],
-    "language": [
-      "javascript",
-      "python",
-      "go",
-      "rust",
-      "java",
-      "typescript"
-    ]
-  },
-  "userProps": {
-    "dev_role": [
-      "full_stack"
-    ],
-    "segment": [
-      "full_stack"
-    ],
-    "team_size": [
-      41,
-      35,
-      9,
-      13,
-      21
-    ],
-    "repos_connected": [
-      0
-    ],
-    "org_name": [
-      "personal"
-    ],
-    "experience_level": [
-      "junior",
-      "mid",
-      "senior"
-    ]
-  },
   "funnels": [
     {
       "sequence": [
@@ -530,6 +486,7 @@
         "pipeline configured",
         "build completed"
       ],
+      "name": "Onboarding",
       "isFirstFunnel": true,
       "conversionRate": 45,
       "timeToConvert": 72,
@@ -541,6 +498,7 @@
         "deployment completed",
         "monitoring dashboard viewed"
       ],
+      "name": "Build-Deploy Pipeline",
       "conversionRate": 40,
       "timeToConvert": 48,
       "weight": 5
@@ -552,6 +510,7 @@
         "build completed",
         "deployment completed"
       ],
+      "name": "PR Review Flow",
       "conversionRate": 35,
       "timeToConvert": 72,
       "weight": 4
@@ -562,6 +521,7 @@
         "incident created",
         "incident resolved"
       ],
+      "name": "Incident Response",
       "conversionRate": 50,
       "timeToConvert": 24,
       "weight": 3
@@ -572,9 +532,70 @@
         "billing updated",
         "collaboration invited"
       ],
+      "name": "Upgrade Path",
       "conversionRate": 20,
       "timeToConvert": 168,
       "weight": 2
     }
-  ]
+  ],
+  "superProps": {
+    "subscription_tier": [
+      "free",
+      "team",
+      "business",
+      "enterprise"
+    ],
+    "Platform": [
+      "web",
+      "desktop_app",
+      "cli"
+    ],
+    "language": [
+      "javascript",
+      "python",
+      "go",
+      "rust",
+      "java",
+      "typescript"
+    ]
+  },
+  "userProps": {
+    "dev_role": [
+      "full_stack"
+    ],
+    "segment": [
+      "full_stack"
+    ],
+    "team_size": [
+      41,
+      35,
+      9,
+      13,
+      21
+    ],
+    "repos_connected": [
+      0
+    ],
+    "org_name": [
+      "personal"
+    ],
+    "experience_level": [
+      "junior",
+      "mid",
+      "senior"
+    ]
+  },
+  "scdProps": {
+    "subscription_tier": {
+      "type": "user",
+      "frequency": "month",
+      "timing": "fuzzy",
+      "max": 6,
+      "values": [
+        "free",
+        "pro",
+        "enterprise"
+      ]
+    }
+  }
 }

package/dungeons/vertical/devtools.js

@@ -1,16 +1,23 @@
+// ── TWEAK THESE ──
+const SEED = "dm4-devtools";
+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 = "dm4-devtools";
 dayjs.extend(utc);
 const chance = u.initChance(SEED);
-const num_users = 5_000;
-const days = 100;
 const NOW = dayjs();
-const DATASET_START = NOW.subtract(days, "days");
+const DATASET_START = NOW.subtract(num_days, "days");
 
 /** @typedef  {import("../../types").Dungeon} Config */
 
@@ -208,12 +215,13 @@ const repoIds = v.range(1, 150).map(() => `REPO_${v.uid(6)}`);
  * manage organization-wide CI/CD infrastructure.
  *
  * ---------------------------------------------------------------
- * 8. ENTERPRISE BUILD-DEPLOY FUNNEL LIFT (funnel-pre hook)
+ * 8. ENTERPRISE BUILD-DEPLOY FUNNEL LIFT (everything hook)
  * ---------------------------------------------------------------
  *
- * PATTERN: Users with subscription_tier "enterprise" get 1.5x
- * conversion rate on the build-deploy pipeline funnel. Enterprise
- * customers have dedicated support and optimized pipelines.
+ * PATTERN: Free-tier users drop 35% of final funnel step events
+ * ("monitoring dashboard viewed"), creating a visible conversion
+ * gap between paid and free users. Enterprise/business users keep
+ * all their events.
  *
  * HOW TO FIND IT IN MIXPANEL:
  *
@@ -240,15 +248,15 @@ const repoIds = v.range(1, 150).map(() => `REPO_${v.uid(6)}`);
  * OSS -> Paid Conversion      | team tier events    | 0%       | 30%     | -
  * Post-Outage Recovery        | deploys/day         | 50       | 100+    | 2x+
  * DevOps Lead Profiles        | team_size           | 10       | 30      | 3x
- * Enterprise Funnel Lift      | funnel conversion   | 40%      | 60%     | 1.5x
+ * Enterprise Funnel Lift      | funnel conversion   | 40%      | 60%     | ~1.5x
  */
 
 /** @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,
@@ -265,10 +273,16 @@ const config = {
 	hasAdSpend: false,
 	percentUsersBornInDataset: 35,
 	hasAvatar: true,
-	batchSize: 2_500_000,
 	concurrency: 1,
 	writeToDisk: false,
-	scdProps: {},
+	scdProps: {
+		subscription_tier: {
+			values: ["free", "pro", "enterprise"],
+			frequency: "month",
+			timing: "fuzzy",
+			max: 6
+		}
+	},
 	mirrorProps: {},
 	lookupTables: [],
 
@@ -501,7 +515,7 @@ const config = {
 	// -- SuperProps --------------------------------------------
 	superProps: {
 		subscription_tier: ["free", "free", "free", "team", "team", "business", "enterprise"],
-		platform: ["web", "web", "desktop_app", "cli"],
+		Platform: ["web", "web", "desktop_app", "cli"],
 		language: ["javascript", "python", "go", "rust", "java", "typescript"],
 	},
 
@@ -513,6 +527,9 @@ const config = {
 		repos_connected: [0],
 		org_name: ["personal"],
 		experience_level: ["junior", "junior", "mid", "mid", "mid", "senior", "senior"],
+		subscription_tier: ["free", "free", "free", "team", "team", "business", "enterprise"],
+		Platform: ["web", "web", "desktop_app", "cli"],
+		language: ["javascript", "python", "go", "rust", "java", "typescript"],
 	},
 
 	// -- Phase 2: Personas ------------------------------------
@@ -720,19 +737,9 @@ const config = {
 			}
 		}
 
-		// -- HOOK 8: ENTERPRISE BUILD-DEPLOY FUNNEL LIFT (funnel-pre)
-		// Enterprise subscribers convert 1.5x through build-deploy pipeline.
-		// Business subscribers get a smaller lift.
-		if (type === "funnel-pre") {
-			if (meta && meta.profile) {
-				const tier = meta.profile.subscription_tier;
-				if (tier === "enterprise") {
-					record.conversionRate = Math.min(record.conversionRate * 1.5, 95);
-				} else if (tier === "business") {
-					record.conversionRate = Math.min(record.conversionRate * 1.2, 90);
-				}
-			}
-		}
+		// -- HOOK 8: ENTERPRISE BUILD-DEPLOY FUNNEL LIFT
+		// Conversion differences handled in everything hook via event filtering.
+		// (funnel-pre conversionRate modifications are diluted by organic events)
 
 		// -- HOOK 1: BUILD FAILURE CASCADE (event) ----------------
 		// Failed builds get 2x duration (retries take longer).
@@ -756,8 +763,28 @@ const config = {
 
 		// -- EVERYTHING HOOKS -------------------------------------
 		if (type === "everything") {
-			const events = record;
+			let events = record;
 			if (!events.length) return record;
+			const profile = meta && meta.profile ? meta.profile : {};
+
+			// -- SUPERPROP STAMPING -------------------------------
+			// Stamp superProp values from profile onto every event so
+			// they stay consistent per-user instead of randomizing per-event.
+			events.forEach(e => {
+				if (profile.subscription_tier) e.subscription_tier = profile.subscription_tier;
+				if (profile.Platform) e.Platform = profile.Platform;
+				if (profile.language) e.language = profile.language;
+			});
+
+			// -- HOOK 8: ENTERPRISE BUILD-DEPLOY FUNNEL LIFT ------
+			// Free-tier users drop 35% of final funnel step events to
+			// create visible conversion gap vs paid subscribers.
+			if (profile.subscription_tier !== "enterprise" && profile.subscription_tier !== "business") {
+				events = events.filter(e => {
+					if (e.event === "monitoring dashboard viewed" && chance.bool({ likelihood: 35 })) return false;
+					return true;
+				});
+			}
 
 			// -- HOOK 3: COPILOT PR VELOCITY ----------------------
 			// Users with ai_assist="copilot" on any PR get 1.5x more PRs.
@@ -799,7 +826,7 @@ const config = {
 
 			// -- HOOK 5: OPEN SOURCE -> PAID CONVERSION -----------
 			// OSS users with >15 events get 30% of events converted to "team" tier.
-			if (meta && meta.profile && meta.profile.segment === "oss_user" && events.length > 15) {
+			if (profile.segment === "oss_user" && events.length > 15) {
 				const conversionPoint = Math.floor(events.length * 0.7);
 				for (let i = conversionPoint; i < events.length; i++) {
 					events[i].subscription_tier = "team";
@@ -827,7 +854,7 @@ const config = {
 				}
 			});
 
-			return record;
+			return events;
 		}
 
 		return record;