@ak--47/dungeon-master 1.5.4 → 1.6.0

package/dungeons/vertical/education.js

@@ -1,964 +0,0 @@
-// ── IMPORTS ──
-import dayjs from "dayjs";
-import utc from "dayjs/plugin/utc.js";
-dayjs.extend(utc);
-import "dotenv/config";
-import * as u from "../../lib/utils/utils.js";
-import * as v from "ak-tools";
-/** @typedef  {import("../../types").Dungeon} Config */
-
-// ── OVERVIEW ──
-/*
- * NAME:       LearnPath
- * APP:        Online learning platform modeled after Coursera, Khan Academy,
- *             and Udemy. Self-paced and cohort-based courses with quizzes,
- *             assignments, certificates, and a social study layer. Two-sided
- *             marketplace: ~89% students, ~11% instructors.
- * SCALE:      10,000 users, ~1.4M events, 121 days (2026-01-01 → 2026-05-01)
- * CORE LOOP:  account registered → course enrolled → lecture started/completed → quiz → certificate
- *
- * EVENTS (17):
- *   lecture started (18) > lecture completed (14) > practice problem solved (12)
- *   > quiz started (10) > resource downloaded (9) > course enrolled (8)
- *   > quiz completed (8) > discussion posted (7) > assignment submitted (6)
- *   > assignment graded (5) > help requested (4) > study group joined (4)
- *   > instructor feedback given (3) > course reviewed (3) > certificate earned (2)
- *   > subscription purchased (2) > account registered (1)
- *
- * FUNNELS (7):
- *   - Onboarding:               account registered → course enrolled → lecture started (75%)
- *   - Learning Loop:            lecture started → lecture completed → practice problem solved (70%, reentry)
- *   - Assessment:               quiz started → quiz completed → assignment submitted (55%, reentry)
- *   - Course Completion:        course enrolled → lecture completed → quiz completed → certificate earned (30%)
- *   - Social Learning:          discussion posted → study group joined → resource downloaded (50%, AI Study Buddy A/B)
- *   - Instructor Interaction:   assignment submitted → assignment graded → instructor feedback given (45%)
- *   - Support/Monetization:     help requested → subscription purchased → course reviewed (35%)
- *
- * USER PROPS:  account_type, subscription_status, learning_style, education_level, timezone, courses_created, teaching_experience_years, instructor_rating, learning_goal, study_hours_per_week, Platform
- * SUPER PROPS: Platform
- * SCD PROPS:   enrollment_status (enrolled/active/completed/dropped, monthly fuzzy, max 6), course_status (draft/published/archived/deprecated, monthly fixed, max 6, type: course_id)
- * GROUPS:      course_id (150 courses), group_id (300 study groups)
- */
-
-// ── HOOK STORIES ──
-/*
- * ---------------------------------------------------------------
- * 1. STUDENT VS INSTRUCTOR PROFILES (user)
- * ---------------------------------------------------------------
- *
- * PATTERN: Instructor profiles get teaching attributes
- * (courses_created, teaching_experience_years, instructor_rating).
- * Students get learning attributes (learning_goal,
- * study_hours_per_week). Two-sided marketplace at ~89% students,
- * ~11% instructors.
- *
- * HOW TO FIND IT IN MIXPANEL:
- *
- *   Report 1: Account Mix
- *   - Report type: Insights
- *   - Event: any event
- *   - Measure: Unique users
- *   - Breakdown: "account_type"
- *   - Expected: ~89% students, ~11% instructors
- *
- *   Report 2: Instructor-Driven Feedback
- *   - Report type: Insights
- *   - Event: "instructor feedback given"
- *   - Measure: Total per user (average)
- *   - Breakdown: "account_type"
- *   - Expected: instructors dominate feedback volume; students rarely emit
- *
- * REAL-WORLD ANALOGUE: Two-sided learning marketplaces have
- * fundamentally different role personas — teachers create supply,
- * learners consume it.
- *
- * ---------------------------------------------------------------
- * 2. DEADLINE CRAMMING (everything)
- * ---------------------------------------------------------------
- *
- * PATTERN: Assignments submitted on Sun/Mon are rushed — 60% are late
- * (raw is_late prop set true at 60% likelihood) vs ~20% baseline. Quiz
- * scores on Sun/Mon drop by 25 points. No flag — discover via Day of Week
- * breakdown.
- *
- * HOW TO FIND IT IN MIXPANEL:
- *
- *   Report 1: Late Submission Rate by Day of Week
- *   - Report type: Insights
- *   - Event: "assignment submitted"
- *   - Measure: count where is_late=true / total
- *   - Breakdown: Day of Week
- *   - Expected: Sun/Mon ~ 60% late vs other days ~ 20%
- *
- *   Report 2: Quiz Score by Day of Week
- *   - Report type: Insights
- *   - Event: "quiz completed"
- *   - Measure: Average of "score_percent"
- *   - Breakdown: Day of Week
- *   - Expected: Sun/Mon ~ 25, other days ~ 49 (-25 pts)
- *
- * REAL-WORLD ANALOGUE: Procrastination clusters submissions at the
- * deadline weekend and hammers performance.
- *
- * ---------------------------------------------------------------
- * 3. NOTES MAGIC NUMBER (everything, in-funnel)
- * ---------------------------------------------------------------
- *
- * PATTERN: Sweet 5-8 lectures with notes_taken=true → +30% quiz
- * score_percent (cap 100) and 40% chance of bonus cloned certificate.
- * Over 9+ → 35% of certificate-earned events drop (over-noted but
- * stuck in study mode). No flag.
- *
- * HOW TO FIND IT IN MIXPANEL:
- *
- *   Report 1: Quiz Score by Notes-Taken Bucket
- *   - Cohort A: users with 5-8 "lecture completed" where notes_taken=true
- *   - Cohort B: users with 0-4
- *   - Event: "quiz completed"
- *   - Measure: Average of "score_percent"
- *   - Expected: A ~ 1.3x B
- *
- *   Report 2: Certificates per User on Heavy Note-Takers
- *   - Cohort C: users with >= 9 notes-taken lectures
- *   - Cohort A: users with 5-8
- *   - Event: "certificate earned"
- *   - Measure: Total per user
- *   - Expected: C ~ 35% fewer certificates per user vs A
- *
- * REAL-WORLD ANALOGUE: Active note-taking lifts quiz performance, but
- * obsessive note-taking signals "stuck in study mode" without finishing.
- *
- * ---------------------------------------------------------------
- * 4. STUDY GROUP RETENTION (everything)
- * ---------------------------------------------------------------
- *
- * PATTERN: Users who join a study group within 10 days get bonus
- * discussion events. Non-joiners with low quiz scores (<60) churn
- * hard at day 14 — all later events are removed.
- *
- * HOW TO FIND IT IN MIXPANEL:
- *
- *   Report 1: D14 Retention by Early Group Join Cohort
- *   - Cohort A: users who fired "study group joined" within first 10 days
- *   - Cohort B: users with no early study group joined
- *   - Compare D14 retention (any event past d14) per cohort
- *   - Expected: A ~ 90%+ vs B (with low quiz scores) ~ 30%
- *
- *   Report 2: Discussion Volume by Group Cohort
- *   - Cohort A vs B (as above)
- *   - Event: "discussion posted"
- *   - Measure: Total per user
- *   - Expected: A posts substantially more
- *
- * REAL-WORLD ANALOGUE: Social learning ties create accountability
- * and dramatically reduce drop-off in cohort-based courses.
- *
- * ---------------------------------------------------------------
- * 5. HINT DEPENDENCY (event)
- * ---------------------------------------------------------------
- *
- * PATTERN: On "practice problem solved", hint_used=true gets difficulty
- * forced to "easy" 60% of the time. hint_used=false gets difficulty forced
- * to "hard" 40% of the time. No flag — discover via difficulty breakdown
- * filtered by hint_used.
- *
- * HOW TO FIND IT IN MIXPANEL:
- *
- *   Report 1: Easy Problem Mix for Hint Users
- *   - Report type: Insights
- *   - Event: "practice problem solved"
- *   - Measure: Total
- *   - Filter: "hint_used" = true
- *   - Breakdown: "difficulty"
- *   - Expected: ~60% easy (vs ~33% baseline)
- *
- *   Report 2: Hard Problem Mix for Independent Solvers
- *   - Report type: Insights
- *   - Event: "practice problem solved"
- *   - Measure: Total
- *   - Filter: "hint_used" = false
- *   - Breakdown: "difficulty"
- *   - Expected: ~40% hard (vs ~33% baseline)
- *
- * REAL-WORLD ANALOGUE: Learners who lean on hints get nudged toward
- * easier work, while those who push through unaided self-select
- * into harder material.
- *
- * ---------------------------------------------------------------
- * 6. SEMESTER-END SPIKE (everything)
- * ---------------------------------------------------------------
- *
- * PATTERN: Days 75-85 simulate semester crunch. quiz_started, quiz_completed,
- * and assignment_submitted events are duplicated at an 80% rate. No flag —
- * discover via line chart of those event volumes by day.
- *
- * HOW TO FIND IT IN MIXPANEL:
- *
- *   Report 1: Assessment Volume Over Time
- *   - Report type: Insights
- *   - Events: "quiz started" + "quiz completed" + "assignment submitted"
- *   - Measure: Total
- *   - Line chart by day
- *   - Expected: ~2x volume spike on days 75-85
- *
- * REAL-WORLD ANALOGUE: Semester-end deadlines reliably produce a
- * massive last-minute surge in student activity.
- *
- * ---------------------------------------------------------------
- * 7. FREE VS PAID COURSES (funnel-pre + everything)
- * ---------------------------------------------------------------
- *
- * PATTERN: Free users get 0.5x funnel conversion rate on the cert funnel only; paid
- * subscribers get 1.5x. Free users also lose 55% of their
- * certificates, producing a ~2.2x completion gap.
- *
- * HOW TO FIND IT IN MIXPANEL:
- *
- *   Report 1: Course Completion Funnel by Subscription
- *   - Report type: Funnels
- *   - Steps: "course enrolled" -> "lecture completed" -> "quiz completed" -> "certificate earned"
- *   - Breakdown: "subscription_status"
- *   - Expected: free ~ 15% completion, paid ~ 33% (~2.2x gap)
- *
- *   Report 2: Certificates Earned per User
- *   - Report type: Insights
- *   - Event: "certificate earned"
- *   - Measure: Total per user (average)
- *   - Breakdown: "subscription_status"
- *   - Expected: paid subscribers earn substantially more certificates
- *
- * REAL-WORLD ANALOGUE: Paid commitment correlates strongly with
- * follow-through; free learners drop off long before completion.
- *
- * ---------------------------------------------------------------
- * 8. PLAYBACK SPEED CORRELATION (event + everything)
- * ---------------------------------------------------------------
- *
- * PATTERN: Speed learners (>=2.0x speed on 3+ lectures) get 0.6x
- * watch_time and a paradoxical +8 quiz score boost. Thorough
- * learners (<=1.0x) get 1.4x watch_time.
- *
- * HOW TO FIND IT IN MIXPANEL:
- *
- *   Report 1: Watch Time by Playback Speed
- *   - Report type: Insights
- *   - Event: "lecture completed"
- *   - Measure: Average of "watch_time_mins"
- *   - Breakdown: "playback_speed"
- *   - Expected: speed >= 2.0 ~ 0.6x baseline; speed <= 1.0 ~ 1.4x baseline
- *
- *   Report 2: Quiz Score by Speed Learner Cohort
- *   - Cohort A: users with 3+ "lecture completed" events at playback_speed >= 2.0
- *   - Cohort B: rest
- *   - Event: "quiz completed"
- *   - Measure: Average of "score_percent"
- *   - Expected: A ~ +8 pts vs B
- *
- * REAL-WORLD ANALOGUE: Power users who watch lectures at 2x speed
- * tend to be domain-confident and outperform on assessments
- * despite spending less time.
- *
- * ---------------------------------------------------------------
- * 9. COURSE COMPLETION TIME-TO-CONVERT (everything)
- * ---------------------------------------------------------------
- *
- * PATTERN: Annual subscribers complete the course-completion funnel
- * 2x faster (factor 0.5); Free users 1.8x slower (factor 1.8).
- * Applied in the everything hook by scaling the enrolled-to-cert
- * gap on the raw events. Stronger factors compensate for the
- * composition effect from H7's conversion-rate gating.
- *
- * HOW TO FIND IT IN MIXPANEL:
- *
- *   Report 1: Course Completion Median Time-to-Convert by Subscription
- *   - Funnels > "course enrolled" -> "lecture completed" -> "quiz completed" -> "certificate earned"
- *   - Measure: Median time to convert
- *   - Breakdown: subscription_status
- *   - Expected: annual < monthly < free (direction)
- *
- *   Also visible via cross-event SQL: MIN("course enrolled" time) to
- *   MIN("certificate earned" time) per user, broken down by
- *   subscription_status. Annual < monthly < free.
- *
- * REAL-WORLD ANALOGUE: Paid commitment accelerates throughput.
- *
- * ---------------------------------------------------------------
- * 10. SOCIAL LEARNING EXPERIMENT (funnel experiment)
- * ---------------------------------------------------------------
- *
- * PATTERN: A/B experiment on the Social Learning funnel (discussion
- * posted → study group joined → resource downloaded). "AI Study
- * Buddy" variant boosts conversion 1.4x and speeds TTC to 0.85x.
- * Activates 30 days before dataset end.
- *
- * HOW TO FIND IT IN MIXPANEL:
- *
- *   Report 1: $experiment_started by Variant
- *   - Report type: Insights
- *   - Event: "$experiment_started"
- *   - Measure: Total
- *   - Breakdown: "$experiment_name" and "Variant"
- *   - Expected: ~50% Control, ~50% AI Study Buddy
- *
- *   Report 2: Social Learning Funnel by Variant
- *   - Report type: Funnels
- *   - Steps: "discussion posted" → "study group joined" → "resource downloaded"
- *   - Breakdown: Variant
- *   - Expected: AI Study Buddy ~ 1.4x conversion vs Control
- *
- * REAL-WORLD ANALOGUE: AI-powered study companions boost social
- * engagement and resource discovery in cohort-based courses.
- *
- * ===============================================================
- * EXPECTED METRICS SUMMARY
- * ===============================================================
- *
- * Hook                    | Metric                | Baseline | Hook Effect  | Ratio
- * ------------------------|-----------------------|----------|--------------|------
- * Student vs Instructor   | Profile attributes    | generic  | role-specific| n/a
- * Deadline Cramming       | Sun/Mon quiz score    | 1x       | -25 pt       | -38%
- * Notes Magic Number      | sweet quiz score      | 1x       | 1.3x         | 1.3x
- * Notes Magic Number      | over certificates/user| 1x       | 0.65x        | -35%
- * Study Group Retention   | D14 retention         | ~ 40%    | ~ 90%        | 2.3x
- * Hint Dependency         | easy problem rate (hint) | 33%   | ~ 60%        | 1.8x
- * Semester-End Spike      | Assessment volume     | 1x       | ~ 2x         | 2x
- * Free vs Paid            | Course completion     | 15%      | 33%          | 2.2x
- * Playback Speed          | Quiz score (speed)    | ~ 65     | ~ 73         | +8 pt
- * Course Completion T2C   | median min by tier    | 1x       | 0.5x/1.8x    | ~ 3.6x range
- * Social Learning Exp     | AI variant conversion | 1x       | 1.4x         | 1.4x
- * Social Learning Exp     | AI variant TTC        | 1x       | 0.85x        | -15%
- */
-
-// ── SCALE ──
-const SEED = "harness-education";
-const NUM_USERS = 10_000;
-const DATASET_START = "2026-01-01T00:00:00Z";
-const DATASET_END = "2026-05-01T23:59:59Z";
-const EVENTS_PER_DAY = 1.2;
-const token = process.env.MP_TOKEN || "your-mixpanel-token";
-
-const chance = u.initChance(SEED);
-
-// ── KNOBS (tweak these to reshape stories) ──
-const HINT_EASY_LIKELIHOOD = 60;
-const HINT_HARD_LIKELIHOOD = 40;
-
-const SPEED_FAST_THRESHOLD = 2.0;
-const SPEED_FAST_WATCH_FACTOR = 0.6;
-const SPEED_FAST_WATCH_MIN = 3;
-const SPEED_SLOW_THRESHOLD = 1.0;
-const SPEED_SLOW_WATCH_FACTOR = 1.4;
-const SPEED_SLOW_WATCH_MAX = 90;
-const SPEED_LECTURE_COUNT_THRESHOLD = 3;
-const SPEED_QUIZ_BOOST_POINTS = 8;
-
-const FREE_FUNNEL_CONV_FACTOR = 0.5;
-const PAID_FUNNEL_CONV_FACTOR = 1.5;
-const FREE_CERT_DROP_LIKELIHOOD = 55;
-
-const NOTES_SWEET_MIN = 5;
-const NOTES_SWEET_MAX = 8;
-const NOTES_OVER_THRESHOLD = 9;
-const NOTES_QUIZ_BOOST = 1.3;
-const NOTES_BONUS_CERT_LIKELIHOOD = 40;
-const NOTES_OVER_CERT_DROP_LIKELIHOOD = 35;
-
-const SEMESTER_SPIKE_START_DAY = 75;
-const SEMESTER_SPIKE_END_DAY = 85;
-const SEMESTER_SPIKE_LIKELIHOOD = 80;
-
-const TTC_ANNUAL_FACTOR = 0.5;
-const TTC_FREE_FACTOR = 1.8;
-
-const STUDY_GROUP_EARLY_DAYS = 10;
-const STUDY_GROUP_LOW_QUIZ_THRESHOLD = 60;
-const STUDY_GROUP_CHURN_CUTOFF_DAYS = 14;
-const STUDY_GROUP_DISCUSSION_CLONE_LIKELIHOOD = 60;
-
-const DEADLINE_LATE_LIKELIHOOD = 60;
-const DEADLINE_QUIZ_PENALTY = 25;
-
-// ── DATA ARRAYS ──
-// Generate consistent IDs for lookup tables and event properties
-const courseIds = v.range(1, 151).map(n => `course_${v.uid(6)}`);
-const quizIds = v.range(1, 401).map(n => `quiz_${v.uid(6)}`);
-const groupIds = v.range(1, 301).map(n => `group_${v.uid(6)}`);
-const lectureIds = v.range(1, 501).map(n => `lecture_${v.uid(6)}`);
-const assignmentIds = v.range(1, 201).map(n => `assignment_${v.uid(6)}`);
-const problemIds = v.range(1, 601).map(n => `problem_${v.uid(6)}`);
-
-// ── HELPER FUNCTIONS ──
-function handleUserHooks(record) {
-	// H1: STUDENT VS INSTRUCTOR PROFILES — role-based attributes.
-	if (record.account_type === "instructor") {
-		record.courses_created = chance.integer({ min: 1, max: 15 });
-		record.teaching_experience_years = chance.integer({ min: 1, max: 20 });
-		record.instructor_rating = Math.round((chance.floating({ min: 3.0, max: 5.0 }) + Number.EPSILON) * 100) / 100;
-	} else {
-		record.learning_goal = chance.pickone(["career_change", "skill_upgrade", "hobby", "degree_requirement"]);
-		record.study_hours_per_week = chance.integer({ min: 2, max: 30 });
-	}
-	return record;
-}
-
-function handleEventHooks(record) {
-	// H5: HINT DEPENDENCY — hint users get 60% easy problems; non-hint
-	// users get 40% hard problems. Mutates difficulty (raw).
-	if (record.event === "practice problem solved") {
-		if (record.hint_used === true && chance.bool({ likelihood: HINT_EASY_LIKELIHOOD })) {
-			record.difficulty = "easy";
-		} else if (record.hint_used === false && chance.bool({ likelihood: HINT_HARD_LIKELIHOOD })) {
-			record.difficulty = "hard";
-		}
-	}
-	// H8 (event): PLAYBACK SPEED — speed learners (>= 2.0x) get
-	// watch_time_mins compressed 0.6x; thorough learners (<= 1.0x) get 1.4x.
-	if (record.event === "lecture completed") {
-		const speed = record.playback_speed;
-		if (speed >= SPEED_FAST_THRESHOLD && record.watch_time_mins !== undefined) {
-			record.watch_time_mins = Math.max(SPEED_FAST_WATCH_MIN, Math.floor(record.watch_time_mins * SPEED_FAST_WATCH_FACTOR));
-		} else if (speed !== undefined && speed <= SPEED_SLOW_THRESHOLD && record.watch_time_mins !== undefined) {
-			record.watch_time_mins = Math.min(SPEED_SLOW_WATCH_MAX, Math.floor(record.watch_time_mins * SPEED_SLOW_WATCH_FACTOR));
-		}
-	}
-	return record;
-}
-
-function handleFunnelPreHooks(record, meta) {
-	// H7: FREE VS PAID — free users get 0.5x conversion rate; paid
-	// subscribers get 1.5x. Scoped to the course-completion funnel ONLY
-	// (sequence ending in "certificate earned") to avoid displacing standalone
-	// events for paid users and triggering unintended churn in H4.
-	const isCertFunnel = Array.isArray(meta?.funnel?.sequence) &&
-		meta.funnel.sequence.includes("certificate earned");
-	if (isCertFunnel) {
-		const subStatus = meta?.profile?.subscription_status;
-		if (subStatus === "free") {
-			record.conversionRate = Math.round(record.conversionRate * FREE_FUNNEL_CONV_FACTOR);
-		} else if (subStatus === "monthly" || subStatus === "annual") {
-			record.conversionRate = Math.min(100, Math.round(record.conversionRate * PAID_FUNNEL_CONV_FACTOR));
-		}
-	}
-	return record;
-}
-
-function handleEverythingHooks(record, meta) {
-	const datasetStart = dayjs.unix(meta.datasetStart);
-	const userEvents = record;
-	const profile = meta.profile;
-	const firstEventTime = userEvents.length > 0 ? dayjs(userEvents[0].time) : null;
-
-	if (profile) {
-		userEvents.forEach((event) => {
-			if (profile.Platform !== undefined) event.Platform = profile.Platform;
-		});
-	}
-
-	let notesTakenCount = 0;
-	let joinedStudyGroupEarly = false;
-	let hasLowQuizScore = false;
-	let speedLectureCount = 0;
-
-	userEvents.forEach((event) => {
-		const eventTime = dayjs(event.time);
-		const daysSinceStart = firstEventTime ? eventTime.diff(firstEventTime, 'days', true) : 0;
-		if (event.event === "lecture completed" && event.notes_taken === true) notesTakenCount++;
-		if (event.event === "study group joined" && daysSinceStart <= STUDY_GROUP_EARLY_DAYS) joinedStudyGroupEarly = true;
-		if (event.event === "quiz completed" && event.score_percent < STUDY_GROUP_LOW_QUIZ_THRESHOLD) hasLowQuizScore = true;
-		if (event.event === "lecture completed" && event.playback_speed >= SPEED_FAST_THRESHOLD) speedLectureCount++;
-	});
-
-	// H3 + H10: NOTES MAGIC NUMBER (in-funnel, no flags)
-	// Sweet 5-8 notes-taken lectures → +30% quiz score_percent (cap 100).
-	// Over 9+ → drop 35% of certificate-earned events (over-noted but
-	// can't synthesize; gets stuck in "study mode").
-	if (notesTakenCount >= NOTES_SWEET_MIN && notesTakenCount <= NOTES_SWEET_MAX) {
-		userEvents.forEach((event) => {
-			if (event.event === "quiz completed" && event.score_percent !== undefined) {
-				event.score_percent = Math.min(100, Math.round(event.score_percent * NOTES_QUIZ_BOOST));
-			}
-		});
-		if (chance.bool({ likelihood: NOTES_BONUS_CERT_LIKELIHOOD })) {
-			const lastEvent = userEvents[userEvents.length - 1];
-			const certTemplate = userEvents.find(e => e.event === "certificate earned");
-			if (lastEvent && certTemplate) {
-				userEvents.push({
-					...certTemplate,
-					time: dayjs(lastEvent.time).add(chance.integer({ min: 1, max: 5 }), 'days').toISOString(),
-					user_id: lastEvent.user_id,
-					course_id: chance.pickone(courseIds),
-					completion_time_days: chance.integer({ min: 14, max: 90 }),
-					final_grade: chance.integer({ min: 80, max: 100 }),
-				});
-			}
-		}
-	} else if (notesTakenCount >= NOTES_OVER_THRESHOLD) {
-		// Over-noters: drop 35% of certificates (stuck in study mode)
-		for (let i = userEvents.length - 1; i >= 0; i--) {
-			if (userEvents[i].event === "certificate earned" && chance.bool({ likelihood: NOTES_OVER_CERT_DROP_LIKELIHOOD })) {
-				userEvents.splice(i, 1);
-			}
-		}
-	}
-
-	// H8 (cont): Speed learners (3+ lectures at 2.0x) score +8 on quizzes.
-	if (speedLectureCount >= SPEED_LECTURE_COUNT_THRESHOLD) {
-		userEvents.forEach((event) => {
-			if (event.event === "quiz completed" && event.score_percent !== undefined) {
-				event.score_percent = Math.min(100, event.score_percent + SPEED_QUIZ_BOOST_POINTS);
-			}
-		});
-	}
-
-	// H6: SEMESTER-END SPIKE — duplicate quiz/assignment events
-	// in days 75-85 window. No flag — discover via line chart.
-	const duplicates = [];
-	const spikableEvents = ["quiz started", "quiz completed", "assignment submitted"];
-	userEvents.forEach((event) => {
-		if (spikableEvents.includes(event.event) && event.time) {
-			const dayInDataset = dayjs.utc(event.time).diff(datasetStart, 'days', true);
-			if (dayInDataset >= SEMESTER_SPIKE_START_DAY && dayInDataset <= SEMESTER_SPIKE_END_DAY && chance.bool({ likelihood: SEMESTER_SPIKE_LIKELIHOOD })) {
-				const dup = JSON.parse(JSON.stringify(event));
-				dup.time = dayjs(event.time).add(chance.integer({ min: 5, max: 120 }), 'minutes').toISOString();
-				duplicates.push(dup);
-			}
-		}
-	});
-	if (duplicates.length > 0) userEvents.push(...duplicates);
-
-	const subStatus = profile ? profile.subscription_status : "free";
-
-	// H9 (T2C): COURSE COMPLETION TIME-TO-CONVERT (everything)
-	// Annual subscribers complete the cert funnel 2x faster (factor 0.5);
-	// Free users 1.8x slower (factor 1.8). For each "certificate earned"
-	// event, find the nearest preceding "course enrolled" and scale the gap.
-	// Runs BEFORE cert-dropping (H7) so TTC adjustments aren't masked by
-	// survivorship bias from the 55% free cert removal.
-	{
-		const ttcFactor = (
-			subStatus === "annual" ? TTC_ANNUAL_FACTOR :
-			subStatus === "free" ? TTC_FREE_FACTOR :
-			1.0
-		);
-		if (ttcFactor !== 1.0) {
-			// Collect all "course enrolled" times (sorted) for binary lookup
-			const enrolledTimes = userEvents
-				.filter(e => e.event === "course enrolled")
-				.map(e => dayjs(e.time))
-				.sort((a, b) => a.valueOf() - b.valueOf());
-
-			if (enrolledTimes.length > 0) {
-				for (const event of userEvents) {
-					if (event.event === "certificate earned") {
-						const certTime = dayjs(event.time);
-						// Find the latest enrolled time before this cert
-						let anchor = null;
-						for (let k = enrolledTimes.length - 1; k >= 0; k--) {
-							if (enrolledTimes[k].isBefore(certTime)) {
-								anchor = enrolledTimes[k];
-								break;
-							}
-						}
-						if (anchor) {
-							const gap = certTime.diff(anchor);
-							const newGap = Math.round(gap * ttcFactor);
-							event.time = anchor.add(newGap, "milliseconds").toISOString();
-						}
-					}
-				}
-			}
-		}
-	}
-
-	// H7: FREE VS PAID — free users lose 55% of certificates.
-	if (subStatus === "free") {
-		for (let i = userEvents.length - 1; i >= 0; i--) {
-			if (userEvents[i].event === "certificate earned" && chance.bool({ likelihood: FREE_CERT_DROP_LIKELIHOOD })) {
-				userEvents.splice(i, 1);
-			}
-		}
-	}
-
-	// H4: STUDY GROUP RETENTION — non-joiners with low scores lose
-	// all post-day-14 events. Joiners get extra cloned discussion events.
-	if (!joinedStudyGroupEarly && hasLowQuizScore) {
-		const churnCutoff = firstEventTime ? firstEventTime.add(STUDY_GROUP_CHURN_CUTOFF_DAYS, 'days') : null;
-		for (let i = userEvents.length - 1; i >= 0; i--) {
-			if (churnCutoff && dayjs(userEvents[i].time).isAfter(churnCutoff)) {
-				userEvents.splice(i, 1);
-			}
-		}
-	} else if (joinedStudyGroupEarly) {
-		const lastEvent = userEvents[userEvents.length - 1];
-		const discussionTemplate = userEvents.find(e => e.event === "discussion posted");
-		if (lastEvent && discussionTemplate && chance.bool({ likelihood: STUDY_GROUP_DISCUSSION_CLONE_LIKELIHOOD })) {
-			userEvents.push({
-				...discussionTemplate,
-				time: dayjs(lastEvent.time).add(chance.integer({ min: 1, max: 3 }), 'days').toISOString(),
-				user_id: lastEvent.user_id,
-				course_id: chance.pickone(courseIds),
-				post_type: chance.pickone(["question", "answer", "comment"]),
-				word_count: chance.integer({ min: 20, max: 400 }),
-			});
-		}
-	}
-
-	// H2: DEADLINE CRAMMING — Sun/Mon assignment_submitted events
-	// flip is_late to true 60% of the time and quiz_completed score_percent
-	// drops 25 points. Mutates raw is_late + score_percent.
-	for (const event of userEvents) {
-		if (event.event === "assignment submitted" && event.time) {
-			const dow = new Date(event.time).getUTCDay();
-			if (dow === 0 || dow === 1) {
-				event.is_late = chance.bool({ likelihood: DEADLINE_LATE_LIKELIHOOD });
-			}
-		}
-	}
-	userEvents.forEach((event) => {
-		if (event.event === "quiz completed" && event.time) {
-			const dow = new Date(event.time).getUTCDay();
-			if ((dow === 0 || dow === 1) && event.score_percent !== undefined) {
-				event.score_percent = Math.max(0, event.score_percent - DEADLINE_QUIZ_PENALTY);
-			}
-		}
-	});
-
-	return record;
-}
-
-// ── CONFIG ──
-/** @type {Config} */
-const config = {
-	version: 2,
-	seed: SEED,
-	datasetStart: DATASET_START,
-	datasetEnd: DATASET_END,
-	avgEventsPerUserPerDay: EVENTS_PER_DAY,
-	numUsers: NUM_USERS,
-	format: "json",
-	gzip: true,
-	credentials: {
-		token,
-	},
-	switches: {
-		hasSessionIds: true,
-		alsoInferFunnels: false,
-		hasLocation: true,
-		hasAndroidDevices: true,
-		hasIOSDevices: true,
-		hasDesktopDevices: true,
-		hasBrowser: false,
-		hasCampaigns: false,
-		isAnonymous: false,
-		hasAdSpend: false,
-		hasAvatar: true,
-	},
-	identity: {
-		avgDevicePerUser: 2,
-	},
-	concurrency: 1,
-	writeToDisk: false,
-
-	funnels: [
-		{
-			sequence: ["account registered", "course enrolled", "lecture started"],
-			isFirstFunnel: true,
-			conversionRate: 75,
-			timeToConvert: 1,
-		},
-		{
-			// Core learning loop: students watch lectures and do practice problems constantly
-			sequence: ["lecture started", "lecture completed", "practice problem solved"],
-			conversionRate: 70,
-			timeToConvert: 4,
-			weight: 5,
-			reentry: true,
-		},
-		{
-			// Assessment flow: quizzes and assignments after studying
-			sequence: ["quiz started", "quiz completed", "assignment submitted"],
-			conversionRate: 55,
-			timeToConvert: 8,
-			weight: 3,
-			reentry: true,
-		},
-		{
-			// Course completion journey: enroll → complete → earn certificate
-			sequence: ["course enrolled", "lecture completed", "quiz completed", "certificate earned"],
-			conversionRate: 30,
-			timeToConvert: 48,
-			weight: 2,
-		},
-		{
-			// Social learning: discussions and study groups
-			sequence: ["discussion posted", "study group joined", "resource downloaded"],
-			conversionRate: 50,
-			timeToConvert: 12,
-			weight: 2,
-			experiment: {
-				name: "AI Study Buddy",
-				variants: [
-					{ name: "Control" },
-					{ name: "AI Study Buddy", conversionMultiplier: 1.4, ttcMultiplier: 0.85 },
-				],
-				startDaysBeforeEnd: 30,
-			},
-		},
-		{
-			// Instructor interaction loop
-			sequence: ["assignment submitted", "assignment graded", "instructor feedback given"],
-			conversionRate: 45,
-			timeToConvert: 24,
-			weight: 2,
-		},
-		{
-			// Support and monetization
-			sequence: ["help requested", "subscription purchased", "course reviewed"],
-			conversionRate: 35,
-			timeToConvert: 24,
-			weight: 1,
-		},
-	],
-
-	events: [
-		{
-			event: "account registered",
-			weight: 1,
-			isFirstEvent: true,
-			isAuthEvent: true,
-			properties: {
-				"account_type": ["instructor", "instructor", "instructor", "instructor", "instructor", "instructor", "student"],
-				"signup_source": ["organic", "referral", "school_partnership", "social_ad"],
-			}
-		},
-		{
-			event: "course enrolled",
-			weight: 8,
-			isStrictEvent: false,
-			properties: {
-				"course_id": courseIds,
-				"course_category": ["CS", "Math", "Science", "Business", "Arts", "Languages"],
-				"difficulty": ["beginner", "intermediate", "advanced"],
-				"is_free": [false, false, false, true, true],
-			}
-		},
-		{
-			event: "lecture started",
-			weight: 18,
-			properties: {
-				"course_id": courseIds,
-				"lecture_id": lectureIds,
-				"lecture_duration_mins": u.weighNumRange(5, 60, 0.8, 20),
-				"module_number": u.weighNumRange(1, 12),
-			}
-		},
-		{
-			event: "lecture completed",
-			weight: 14,
-			isStrictEvent: false,
-			properties: {
-				"course_id": courseIds,
-				"lecture_id": lectureIds,
-				"watch_time_mins": u.weighNumRange(3, 60, 0.8, 20),
-				"playback_speed": [0.75, 1.0, 1.0, 1.0, 1.25, 1.5, 2.0],
-				"notes_taken": [false, false, true],
-			}
-		},
-		{
-			event: "quiz started",
-			weight: 10,
-			isStrictEvent: false,
-			properties: {
-				"course_id": courseIds,
-				"quiz_id": quizIds,
-				"quiz_type": ["practice", "graded", "final_exam"],
-				"question_count": u.weighNumRange(5, 50, 0.7, 15),
-			}
-		},
-		{
-			event: "quiz completed",
-			weight: 8,
-			isStrictEvent: false,
-			properties: {
-				"course_id": courseIds,
-				"quiz_id": quizIds,
-				"score_percent": u.weighNumRange(0, 100, 1.2, 50),
-				"time_spent_mins": u.weighNumRange(3, 120, 0.6, 25),
-				"attempts": u.weighNumRange(1, 5, 0.5, 3),
-			}
-		},
-		{
-			event: "assignment submitted",
-			weight: 6,
-			isStrictEvent: false,
-			properties: {
-				"course_id": courseIds,
-				"assignment_id": assignmentIds,
-				"submission_type": ["text", "code", "file", "project"],
-				"word_count": u.weighNumRange(100, 5000, 0.6, 500),
-				"is_late": [false, false, false, false, true],
-			}
-		},
-		{
-			event: "assignment graded",
-			weight: 5,
-			properties: {
-				"course_id": courseIds,
-				"assignment_id": assignmentIds,
-				"grade": ["A", "B", "C", "D", "F"],
-				"feedback_length": u.weighNumRange(0, 500, 0.5, 100),
-				"grader": ["instructor", "peer", "auto"],
-			}
-		},
-		{
-			event: "discussion posted",
-			weight: 7,
-			isStrictEvent: false,
-			properties: {
-				"course_id": courseIds,
-				"post_type": ["question", "answer", "comment"],
-				"word_count": u.weighNumRange(10, 500, 0.6, 80),
-			}
-		},
-		{
-			event: "certificate earned",
-			weight: 2,
-			isStrictEvent: false,
-			properties: {
-				"course_id": courseIds,
-				"completion_time_days": u.weighNumRange(7, 180, 0.5, 45),
-				"final_grade": u.weighNumRange(60, 100, 1.2, 30),
-			}
-		},
-		{
-			event: "study group joined",
-			weight: 4,
-			isStrictEvent: false,
-			properties: {
-				"group_id": groupIds,
-				"group_size": u.weighNumRange(3, 20, 0.7, 8),
-				"group_type": ["study_circle", "project_team", "tutoring"],
-			}
-		},
-		{
-			event: "resource downloaded",
-			weight: 9,
-			properties: {
-				"resource_type": ["pdf", "slides", "code_sample", "dataset", "cheat_sheet"],
-				"course_id": courseIds,
-			}
-		},
-		{
-			event: "instructor feedback given",
-			weight: 3,
-			properties: {
-				"course_id": courseIds,
-				"feedback_type": ["written", "video", "rubric"],
-				"response_time_hours": u.weighNumRange(1, 72, 0.5, 15),
-			}
-		},
-		{
-			event: "course reviewed",
-			weight: 3,
-			properties: {
-				"course_id": courseIds,
-				"rating": u.weighNumRange(1, 5, 1.5, 3),
-				"review_length": u.weighNumRange(10, 1000, 0.5, 100),
-				"would_recommend": [false, false, false, true, true, true, true, true, true, true],
-			}
-		},
-		{
-			event: "subscription purchased",
-			weight: 2,
-			properties: {
-				"plan": ["monthly", "annual", "lifetime"],
-				"price": [19.99, 149.99, 499.99],
-			}
-		},
-		{
-			event: "help requested",
-			weight: 4,
-			properties: {
-				"topic": ["technical", "content", "billing", "accessibility"],
-				"channel": ["chat", "email", "forum"],
-			}
-		},
-		{
-			event: "practice problem solved",
-			weight: 12,
-			isStrictEvent: false,
-			properties: {
-				"course_id": courseIds,
-				"problem_id": problemIds,
-				"difficulty": ["easy", "medium", "hard"],
-				"time_to_solve_sec": u.weighNumRange(10, 3600, 0.5, 300),
-				"hint_used": [false, false, true],
-			}
-		},
-	],
-
-	superProps: {
-		Platform: ["Web", "iOS", "Android", "iPad"],
-	},
-
-	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"],
-		"subscription_status": ["free", "free", "free", "monthly", "annual"],
-		"learning_style": ["visual", "reading", "hands_on", "auditory"],
-		"education_level": ["high_school", "bachelors", "masters", "phd", "self_taught"],
-		"timezone": ["US_Eastern", "US_Pacific", "US_Central", "Europe", "Asia"],
-		"courses_created": [0],
-		"teaching_experience_years": [0],
-		"instructor_rating": [0],
-		"learning_goal": ["none"],
-		"study_hours_per_week": [0],
-		"Platform": ["Web", "iOS", "Android", "iPad"],
-	},
-
-	groupKeys: [
-		["course_id", 150, ["course enrolled", "lecture started", "lecture completed", "quiz completed", "certificate earned"]],
-		["group_id", 300, ["study group joined", "discussion posted"]],
-	],
-
-	groupProps: {
-		course_id: {
-			"title": () => `${chance.pickone(["Introduction to", "Advanced", "Mastering", "Fundamentals of", "Applied"])} ${chance.pickone(["Algorithms", "Data Science", "Machine Learning", "Statistics", "Web Development", "Calculus", "Biology", "Economics", "Design Thinking", "Creative Writing"])}`,
-			"instructor_count": u.weighNumRange(1, 5, 0.5, 2),
-			"total_enrolled": u.weighNumRange(50, 5000, 0.6, 500),
-			"avg_rating": u.weighNumRange(3, 5, 1.5, 1),
-		},
-		group_id: {
-			"name": () => `${chance.pickone(["Study", "Learning", "Focus", "Peer", "Cohort"])} ${chance.pickone(["Circle", "Squad", "Team", "Hub", "Group"])} ${chance.character({ alpha: true, casing: "upper" })}${chance.integer({ min: 1, max: 99 })}`,
-			"member_count": u.weighNumRange(3, 20, 0.7, 8),
-			"focus_area": ["CS", "Math", "Science", "Business", "Arts", "Languages"],
-		}
-	},
-
-	lookupTables: [],
-
-	hook(record, type, meta) {
-		if (type === "user") return handleUserHooks(record);
-		if (type === "event") return handleEventHooks(record);
-		if (type === "funnel-pre") return handleFunnelPreHooks(record, meta);
-		if (type === "everything") return handleEverythingHooks(record, meta);
-		return record;
-	}
-};
-
-export default config;