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

package/dungeons/vertical/community.js

@@ -2,7 +2,7 @@
 const SEED = "dm4-community";
 const num_days = 100;
 const num_users = 5_000;
-const avg_events_per_user = 120;
+const avg_events_per_user_per_day = 1.2;
 let token = "your-mixpanel-token";
 
 // ── env overrides ──
@@ -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 wiki/article IDs at module level
@@ -56,7 +53,16 @@ const communityIds = v.range(1, 30).map(() => `COMM_${v.uid(4)}`);
 
 /**
  * ===================================================================
- * ANALYTICS HOOKS (8 hooks)
+ * ANALYTICS HOOKS (10 hooks)
+ *
+ * NOTE: All cohort effects are HIDDEN — no flag stamping. Discoverable via
+ * raw-prop breakdowns (day, content_hub, subscription_tier) or behavioral cohorts.
+ *
+ * Adds 9. CONTENT CREATION TIME-TO-CONVERT (Pro 1.3x faster, Free 1.25x slower)
+ *      [funnel-post: visible only in Mixpanel funnel median TTC; cross-event
+ *      MIN→MIN SQL queries do NOT show this]
+ * and 10. ARTICLE-PUBLISHED MAGIC NUMBER (sweet 2-5 → +35% upvote_count;
+ * over 6+ → drop 25% upvote events).
  * ===================================================================
  *
  * -------------------------------------------------------------------
@@ -73,9 +79,9 @@ const communityIds = v.range(1, 30).map(() => `COMM_${v.uid(4)}`);
  *   - Report type: Insights
  *   - Event: "article published"
  *   - Measure: Average of "word_count"
- *   - Breakdown: "is_weekend"
- *   - Expected: is_weekend=true should show ~1.5x avg word_count vs false
- *     (true ~ 2250, false ~ 1500)
+ *   - Breakdown: Day of Week
+ *   - Expected: Sat/Sun ~ 1.5x avg word_count vs weekdays
+ *     (weekend ~ 3325, weekday ~ 2218)
  *
  * REAL-WORLD ANALOGUE: Community wikis see longer, more thoughtful
  * contributions on weekends when creators have uninterrupted time.
@@ -258,8 +264,10 @@ const communityIds = v.range(1, 30).map(() => `COMM_${v.uid(4)}`);
 const config = {
 	token,
 	seed: SEED,
-	numDays: num_days,
-	numEvents: num_users * avg_events_per_user,
+	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,
 	hasSessionIds: true,
@@ -274,7 +282,6 @@ const config = {
 	hasCampaigns: false,
 	isAnonymous: false,
 	hasAdSpend: false,
-	percentUsersBornInDataset: 35,
 	hasAvatar: true,
 	concurrency: 1,
 	writeToDisk: false,
@@ -307,7 +314,6 @@ const config = {
 				content_hub: ["gaming", "anime", "movies", "tv", "comics", "music"],
 				view_count: u.weighNumRange(1, 100, 0.4, 50),
 				time_on_page_sec: u.weighNumRange(5, 600, 0.4, 45),
-				is_weekend: [false],
 			},
 		},
 		{
@@ -319,8 +325,6 @@ const config = {
 				word_count: u.weighNumRange(200, 5000, 0.4, 1500),
 				has_images: [true, true, true, false],
 				category: ["lore", "character", "episode_guide", "review", "tutorial", "news"],
-				is_weekend: [false],
-				poll_enabled: [false],
 			},
 		},
 		{
@@ -695,37 +699,30 @@ const config = {
 			}
 		}
 
-		// -- 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.
-		if (type === "event") {
-			if (record.event === "article published" || record.event === "article viewed") {
-				const dow = dayjs(record.time).day();
-				if (dow === 0 || dow === 6) {
-					record.is_weekend = true;
-					if (record.word_count) {
-						record.word_count = Math.floor(record.word_count * 1.5);
+		// HOOK 9 (T2C): CONTENT CREATION TIME-TO-CONVERT (funnel-post)
+		// Pro/supporter subscribers complete the Content Creation funnel
+		// 1.3x faster (factor 0.77); Free 1.25x slower (factor 1.25).
+		if (type === "funnel-post") {
+			const segment = meta?.profile?.subscription_tier;
+			if (Array.isArray(record) && record.length > 1) {
+				const factor = (
+					segment === "pro" || segment === "supporter" ? 0.77 :
+					segment === "free" ? 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 2: TRENDING TOPIC WINDOW (event) ----------------
-			// Days 35-50: gaming hub articles get 2x view_count.
-			const TREND_START = DATASET_START.add(35, "days");
-			const TREND_END = DATASET_START.add(50, "days");
-			const eventTime = dayjs(record.time);
-			if (record.event === "article viewed" && eventTime.isAfter(TREND_START) && eventTime.isBefore(TREND_END)) {
-				if (record.content_hub === "gaming") {
-					record.view_count = Math.floor((record.view_count || 50) * 2);
-				}
-			}
 		}
 
 		// -- EVERYTHING HOOKS -----------------------------------------
 		if (type === "everything") {
+			const datasetStart = dayjs.unix(meta.datasetStart);
 			let events = record;
 			if (!events.length) return record;
 			const profile = meta && meta.profile ? meta.profile : {};
@@ -739,6 +736,34 @@ const config = {
 				if (profile.content_hub) e.content_hub = profile.content_hub;
 			});
 
+			// HOOK 1: WEEKEND CONTENT SURGE — articles on Sat/Sun get
+			// word_count 1.5x. Mutates raw prop. No flag.
+			for (const e of events) {
+				if (e.event === 'article published' || e.event === 'article viewed') {
+					const dow = new Date(e.time).getUTCDay();
+					if ((dow === 0 || dow === 6) && e.word_count) {
+						e.word_count = Math.floor(e.word_count * 1.5);
+					}
+				}
+			}
+
+			// -- HOOK 2: TRENDING TOPIC WINDOW -------------------------
+			// Days 35-50: gaming hub articles get 2x view_count.
+			// Runs after superProp stamping so content_hub is the
+			// profile's consistent value, not the random event-level one.
+			const TREND_START = datasetStart.add(35, "days");
+			const TREND_END = datasetStart.add(50, "days");
+			if (profile.content_hub === "gaming") {
+				events.forEach(e => {
+					if (e.event === "article viewed") {
+						const eventTime = dayjs(e.time);
+						if (eventTime.isAfter(TREND_START) && eventTime.isBefore(TREND_END)) {
+							e.view_count = Math.floor((e.view_count || 50) * 2);
+						}
+					}
+				});
+			}
+
 			// -- 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.
@@ -793,8 +818,8 @@ const config = {
 				});
 			}
 
-			// -- HOOK 6: LURKER CHURN ---------------------------------
-			// Users with <5 total events lose 60% after day 10.
+			// HOOK 6: LURKER CHURN — users with <5 events lose 60% after
+			// day 10. No flag.
 			if (events.length < 5 && events.length > 0) {
 				const firstEventTime = dayjs(events[0].time);
 				const cutoff = firstEventTime.add(10, "days");
@@ -805,6 +830,25 @@ const config = {
 				}
 			}
 
+			// HOOK 10: ARTICLE-PUBLISHED MAGIC NUMBER (no flags)
+			// Sweet 2-5 articles published → +35% on upvote_count for
+			// upvote-given events. Over 6+ → drop 25% of upvote-given events
+			// (over-publishing dilutes signal). No flag.
+			const articleCount = events.filter(e => e.event === "article published").length;
+			if (articleCount >= 2 && articleCount <= 5) {
+				events.forEach(e => {
+					if (e.event === "upvote given" && typeof e.upvote_count === "number") {
+						e.upvote_count = Math.round(e.upvote_count * 1.35);
+					}
+				});
+			} else if (articleCount >= 6) {
+				for (let i = events.length - 1; i >= 0; i--) {
+					if (events[i].event === "upvote given" && chance.bool({ likelihood: 25 })) {
+						events.splice(i, 1);
+					}
+				}
+			}
+
 			return events;
 		}