@ak--47/dungeon-master 1.4.2 → 1.4.3

package/dungeons/vertical/logistics.js

@@ -261,7 +261,7 @@ const supplierIds = v.range(1, 150).map(() => `SUP_${v.uid(6)}`);
  * PATTERN: Users with 5-15 "inventory checked" events sit in the
  * "engaged-but-focused" sweet spot — every "purchase order created"
  * event gets quantity boosted ~25%. Users with 16 or more inventory
- * checks are over-engaged (paralysis); ~30% of their "purchase order
+ * checks are over-engaged (paralysis); ~60% of their "purchase order
  * created" events are dropped. No flag is stamped — discoverable only
  * by binning users on inventory-check COUNT and comparing PO totals.
  *
@@ -283,12 +283,43 @@ const supplierIds = v.range(1, 150).map(() => `SUP_${v.uid(6)}`);
  *   - Event: "purchase order created"
  *   - Measure: Total events per user
  *   - Compare cohort C vs cohort A
- *   - Expected: cohort C has ~ 30% fewer POs per user
+ *   - Expected: cohort C has ~ 60% fewer POs per user
  *
  * REAL-WORLD ANALOGUE: A focused operations team that monitors
  * stock just enough places larger, more confident orders; an
  * obsessive checker is paralysed and orders less.
  *
+ * -------------------------------------------------------------------
+ * 10. ONBOARDING TIME-TO-CONVERT (funnel-post hook)
+ * -------------------------------------------------------------------
+ *
+ * PATTERN: Enterprise-tier users complete the Onboarding funnel
+ * 1.4x faster (time gaps scaled by 0.71). Small-business and trial
+ * users complete it 1.3x slower (gaps scaled by 1.3). The hook
+ * iterates over the funnel-post event array, compresses or stretches
+ * the inter-step time gaps based on the user's company_tier from
+ * meta.profile, then rewrites each event's timestamp.
+ *
+ * HOW TO FIND IT IN MIXPANEL:
+ *
+ *   Report 1: Onboarding TTC by Company Tier
+ *   - Report type: Funnels
+ *   - Steps: "account created" -> "inventory checked" -> "integration connected" -> "report generated"
+ *   - Breakdown: user property "company_tier"
+ *   - Metric: Median time to convert
+ *   - Expected: enterprise median TTC ~ 0.71x of small_business/trial TTC
+ *     (e.g., enterprise ~ 36h vs small_business ~ 66h)
+ *
+ *   NOTE: This effect is visible ONLY in Mixpanel funnel median TTC.
+ *   Cross-event MIN->MIN SQL queries on raw events do NOT show this
+ *   because funnel-post mutates timestamps after event generation but
+ *   before storage.
+ *
+ * REAL-WORLD ANALOGUE: Enterprise customers have dedicated IT teams
+ * and onboarding specialists who move through setup, integration,
+ * and first reporting much faster than small businesses configuring
+ * the platform themselves.
+ *
  * ===================================================================
  * EXPECTED METRICS SUMMARY
  * ===================================================================
@@ -304,7 +335,8 @@ const supplierIds = v.range(1, 150).map(() => `SUP_${v.uid(6)}`);
  * Enterprise Profiles         | warehouse_count     | 3        | 10      | 3.3x
  * Small-Biz Conversion Drop   | funnel conversion   | 30%      | 20%     | 0.65x
  * Inventory-Check Magic Num   | sweet PO quantity   | 1x       | 1.25x   | 1.25x
- * Inventory-Check Magic Num   | over POs/user       | 1x       | 0.7x    | -30%
+ * Inventory-Check Magic Num   | over POs/user       | 1x       | 0.4x    | -60%
+ * Onboarding TTC              | funnel median TTC   | 1x       | 0.71x   | 1.4x faster (enterprise)
  */
 
 /** @type {Config} */
@@ -902,7 +934,7 @@ const config = {
 
 			// -- HOOK 9: INVENTORY-CHECK MAGIC NUMBER (no flags) ------
 			// Sweet 5-15 inventory checks → +25% PO quantity.
-			// Over 16+ → drop 45% of PO created events.
+			// Over 16+ → drop 60% of PO created events (high rate to overcome persona event multiplier dilution).
 			const invCheckCount = record.filter(e => e.event === 'inventory checked').length;
 			if (invCheckCount >= 5 && invCheckCount <= 15) {
 				record.forEach(e => {
@@ -912,7 +944,7 @@ const config = {
 				});
 			} else if (invCheckCount >= 16) {
 				for (let i = record.length - 1; i >= 0; i--) {
-					if (record[i].event === 'purchase order created' && chance.bool({ likelihood: 45 })) {
+					if (record[i].event === 'purchase order created' && chance.bool({ likelihood: 60 })) {
 						record.splice(i, 1);
 					}
 				}

package/dungeons/vertical/marketplace.js

@@ -148,8 +148,9 @@ const listingIds = v.range(1, 500).map(() => `LST_${v.uid(8)}`);
  * ───────────────────────────────────────────────────────────────
  *
  * PATTERN: Users whose average response_time_hours on "message sent"
- * events is < 2 hours get additional "offer accepted" events cloned.
- * Fast responders close more deals.
+ * events is <= 4 hours get additional "offer accepted" events cloned
+ * (2x existing + 60% of offer_received). Slow responders (> 4h avg)
+ * lose 60% of offer_accepted events. Fast responders close more deals.
  *
  * HOW TO FIND IT IN MIXPANEL:
  *
@@ -885,27 +886,50 @@ const config = {
 			}
 
 			// ── HOOK 5: RESPONSE TIME → CONVERSION ───────────
-			// Users with low avg response_time on messages get extra
-			// offer_accepted clones; slow responders lose half their accepts.
-			const messages = events.filter(e => e.event === "message sent" && e.response_time_hours);
-			if (messages.length > 0) {
-				const avgResponseTime = messages.reduce((sum, m) => sum + m.response_time_hours, 0) / messages.length;
+			// Deterministic fast/slow cohorts using user hash.
+			// Fast responders (~40%): response_time_hours set to 1-4,
+			//   extra offer_accepted clones. Slow (~60%): set to 8-36,
+			//   lose 60% of offer_accepted events.
+			const msgEvents = events.filter(e => e.event === "message sent");
+			if (msgEvents.length > 0) {
+				const uid = msgEvents[0].user_id || "";
+				const isFast = (uid.charCodeAt(0) + uid.charCodeAt(uid.length - 1)) % 5 < 2; // ~40%
+				// Stamp response_time_hours to create the measurable correlation
+				msgEvents.forEach(m => {
+					m.response_time_hours = isFast
+						? chance.floating({ min: 0.5, max: 4, fixed: 1 })
+						: chance.floating({ min: 8, max: 36, fixed: 1 });
+				});
 				const templateOffer = events.find(e => e.event === "offer accepted");
-				if (avgResponseTime <= 11 && templateOffer) {
-					// Fast responders: clone every offer_received into an offer_accepted
+				if (isFast && templateOffer) {
+					// Fast responders: clone existing offer_accepted 2x each
+					const existingAccepts = events.filter(e => e.event === "offer accepted");
+					existingAccepts.forEach(accept => {
+						for (let c = 0; c < 2; c++) {
+							events.push({
+								...accept,
+								time: dayjs(accept.time).add(chance.integer({ min: 1, max: 8 }), "hours").toISOString(),
+								user_id: accept.user_id,
+								response_time_hours: chance.floating({ min: 0.1, max: 2, fixed: 1 }),
+							});
+						}
+					});
+					// Also clone from offer_received → offer_accepted
 					const offers = events.filter(e => e.event === "offer received");
 					offers.forEach(offer => {
-						events.push({
-							...templateOffer,
-							time: dayjs(offer.time).add(chance.integer({ min: 1, max: 4 }), "hours").toISOString(),
-							user_id: offer.user_id,
-							response_time_hours: chance.floating({ min: 0.1, max: 2, fixed: 1 }),
-						});
+						if (chance.bool({ likelihood: 60 })) {
+							events.push({
+								...templateOffer,
+								time: dayjs(offer.time).add(chance.integer({ min: 1, max: 6 }), "hours").toISOString(),
+								user_id: offer.user_id,
+								response_time_hours: chance.floating({ min: 0.1, max: 3, fixed: 1 }),
+							});
+						}
 					});
-				} else if (avgResponseTime >= 25 && templateOffer) {
-					// Slow responders: drop half of offer_accepted events
+				} else if (!isFast) {
+					// Slow responders: drop 60% of offer_accepted events
 					for (let i = events.length - 1; i >= 0; i--) {
-						if (events[i].event === "offer accepted" && chance.bool({ likelihood: 50 })) {
+						if (events[i].event === "offer accepted" && chance.bool({ likelihood: 60 })) {
 							events.splice(i, 1);
 						}
 					}

package/dungeons/vertical/media.js

@@ -13,6 +13,7 @@ import utc from "dayjs/plugin/utc.js";
 import "dotenv/config";
 import * as u from "../../lib/utils/utils.js";
 import * as v from "ak-tools";
+import { findFirstSequence, scaleFunnelTTC } from "../../lib/hook-helpers/timing.js";
 
 dayjs.extend(utc);
 const chance = u.initChance(SEED);
@@ -46,10 +47,9 @@ const chance = u.initChance(SEED);
  * ═══════════════════════════════════════════════════════════════════════════════
  * ANALYTICS HOOKS (10 hooks)
  *
- * Adds 10. CORE VIEWING LOOP TIME-TO-CONVERT: premium 0.71x faster, free 1.25x
- * slower (funnel-post). Discover via funnel median TTC by subscription_plan.
- * NOTE (funnel-post measurement): visible only via Mixpanel funnel median TTC.
- * Cross-event MIN→MIN SQL queries on raw events do NOT show this.
+ * Adds 10. CORE VIEWING LOOP: premium 0.67x watch_duration_min, free 1.4x
+ * (property scaling in everything hook). Discover via Insights → playback
+ * completed → Avg watch_duration_min → breakdown subscription_plan.
  * ═══════════════════════════════════════════════════════════════════════════════
  *
  * NOTE: All cohort effects are HIDDEN — discoverable only via behavioral cohorts
@@ -120,16 +120,20 @@ const chance = u.initChance(SEED);
  * 4. AD FATIGUE CHURN (everything)
  * ───────────────────────────────────────────────────────────────────────────────
  *
- * PATTERN: Free-tier users with 10+ ad impressions lose 50% of events after
- * day 45 of their lifecycle. No flag — discover via cohort retention.
+ * PATTERN: Users with 5+ ad impressions in first 45 days lose 95% of events
+ * after day 45 of their lifecycle. Applies to all tiers (not just free).
+ * No flag — discover via cohort retention. The very high drop rate overcomes
+ * the inherent ~3x activity confound (heavy-ad users are naturally much more
+ * active). Runs last in the hook chain so event-adding hooks (binge-watching,
+ * subtitle) can't re-inflate the post-d45 count.
  *
  * HOW TO FIND IT IN MIXPANEL:
  *
  *   Report 1: Retention by Ad Exposure Cohort
  *   - Report type: Retention
- *   - Cohort A: free-tier users with >= 10 "ad impression"
- *   - Cohort B: free-tier users with < 10 ads
- *   - Expected: A ~ 50% retention drop after day 45
+ *   - Cohort A: users with >= 5 "ad impression" in first 45 days
+ *   - Cohort B: users with < 5 ads
+ *   - Expected: heavy_ad avg_post_d45_events < light_ad
  *
  * REAL-WORLD ANALOGUE: Ad-supported tiers carry a tolerance ceiling.
  *
@@ -223,8 +227,10 @@ const chance = u.initChance(SEED);
  *
  * PATTERN: Users in the 4-6 recommendation-clicked sweet spot get 1.25x
  * watch_duration_min on playback-completed events. Users with 7+ rec clicks
- * are over-engaged (decision fatigue); 30% of their playback-completed events
- * drop. No flag — discover by binning users on rec-click count.
+ * are over-engaged (decision fatigue); watch_duration_min is halved and 55%
+ * of their playback-completed events are dropped. The aggressive suppression
+ * overcomes the inherent engagement confound. No flag — discover by binning
+ * users on rec-click count.
  *
  * HOW TO FIND IT IN MIXPANEL:
  *
@@ -241,12 +247,34 @@ const chance = u.initChance(SEED);
  *   - Cohort C: users with >= 7 "recommendation clicked"
  *   - Cohort A: users with 4-6
  *   - Event: "playback completed"
- *   - Measure: Total per user
- *   - Expected: C ~ 30% fewer completions per user vs A
+ *   - Measure: Average of "watch_duration_min"
+ *   - Expected: C (over) has lower avg watch_duration_min than A (sweet)
  *
  * REAL-WORLD ANALOGUE: A few good recs surface a watchworthy title; too many
  * clicks signals indecision and drives abandonment.
  *
+ * ───────────────────────────────────────────────────────────────────────────────
+ * 10. CORE VIEWING LOOP — SUBSCRIPTION PLAN PROPERTY SCALING (everything)
+ * ───────────────────────────────────────────────────────────────────────────────
+ *
+ * PATTERN: Premium subscribers have 0.67x watch_duration_min on "playback
+ * completed" (efficient viewers), free users have 1.4x (lingering viewers).
+ * Scales the existing watch_duration_min property — no flag. Applied BEFORE
+ * weekend/subtitle/rec-click hooks so each subsequent effect amplifies from
+ * the plan-adjusted base.
+ *
+ * HOW TO FIND IT IN MIXPANEL:
+ *
+ *   Report 1: Avg Watch Duration by Subscription Plan
+ *   - Report type: Insights
+ *   - Event: "playback completed"
+ *   - Measure: Average of "watch_duration_min"
+ *   - Breakdown: "subscription_plan"
+ *   - Expected: premium < standard < free, free/premium ratio >= 2x
+ *
+ * REAL-WORLD ANALOGUE: Premium subscribers binge curated content efficiently;
+ * free-tier users browse and linger with ad interruptions.
+ *
  * ═══════════════════════════════════════════════════════════════════════════════
  * EXPECTED METRICS SUMMARY
  * ═══════════════════════════════════════════════════════════════════════════════
@@ -256,13 +284,14 @@ const chance = u.initChance(SEED);
  * Genre Funnel Conversion  | documentary funnel conv | 1x       | 0.7x        | -30%
  * Binge-Watching           | completions per streak  | 1x       | ~ 1.5x      | 1.5x
  * Weekend vs Weekday       | weekend watch_duration  | 1x       | ~ 1.5x      | 1.5x
- * Ad Fatigue Churn         | retention free+10+ads   | 1x       | ~ 0.5x      | -50%
+ * Ad Fatigue Churn         | heavy_ad post_d45 events| 1x       | < light_ad  | -93%
  * New Release Spike        | blockbuster id share    | 0%       | ~ 20%       | n/a
  * Kids Profile Safety      | animation/doc share     | baseline | + 15%       | n/a
  * Rec Engine Improvement   | content-rated post day60| 1x       | ~ 1.5x      | 1.5x
  * Subtitle Users           | completion %            | 68%      | 85%         | 1.25x
  * Rec-Click Magic Number   | sweet watch duration    | 1x       | 1.25x       | 1.25x
- * Rec-Click Magic Number   | over completions/user   | 1x       | 0.7x        | -30%
+ * Rec-Click Magic Number   | over watch_duration_min | 1x       | 0.5x        | -50%
+ * Core Viewing Loop        | free/premium duration   | 1x       | >= 2x       | 2.09x
  */
 
 // Generate consistent content IDs for lookup tables and events
@@ -544,27 +573,6 @@ const config = {
 	lookupTables: [],
 
 	hook: function (record, type, meta) {
-		// Hook #10 (T2C): CORE VIEWING LOOP TIME-TO-CONVERT (funnel-post)
-		// Premium subscribers complete browse→play funnel 1.4x faster
-		// (factor 0.71); free users 1.25x slower (factor 1.25).
-		if (type === "funnel-post") {
-			const segment = meta?.profile?.subscription_plan;
-			if (Array.isArray(record) && record.length > 1) {
-				const factor = (
-					segment === "premium" ? 0.71 :
-					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();
-					}
-				}
-			}
-		}
-
 		if (type === "event") {
 			// Hook #6: KIDS PROFILE SAFETY — 15% of selections/starts get genre
 			// restricted to animation or documentary. Mutates existing genre prop.
@@ -594,6 +602,30 @@ const config = {
 				});
 			}
 
+			// HOOK 10: CORE VIEWING LOOP TTC — premium 0.67x, free 1.4x.
+			// Timestamp shift for Mixpanel funnel TTC + property scale for
+			// Insights. Applied first so weekend/subtitle/rec-click hooks
+			// amplify from the plan-adjusted base.
+			{
+				const plan = profile ? profile.subscription_plan : "free";
+				const ttcFactor = plan === "premium" ? 0.67 : plan === "free" ? 1.4 : 1.0;
+				if (ttcFactor !== 1.0) {
+					// Timestamp shift: affects Mixpanel funnel TTC
+					const viewSeq = findFirstSequence(
+						userEvents,
+						["content browsed", "content selected", "playback started", "playback completed"],
+						60 * 24 * 7
+					);
+					if (viewSeq) scaleFunnelTTC(viewSeq, ttcFactor);
+					// Property scale: affects Insights AVG reports
+					for (const e of userEvents) {
+						if (e.event === "playback completed" && typeof e.watch_duration_min === "number") {
+							e.watch_duration_min = Math.round(e.watch_duration_min * ttcFactor * 10) / 10;
+						}
+					}
+				}
+			}
+
 			// Hook #5: NEW RELEASE SPIKE — days 50-65, 20% of selections/starts
 			// switch to the blockbuster id. Mutates existing content_id/content_type props.
 			// (Moved from event hook to everything hook per L1: temporal checks belong here.)
@@ -613,6 +645,28 @@ const config = {
 				}
 			}
 
+			// Hook #10: CORE VIEWING LOOP — subscription_plan property scaling.
+			// Premium users watch more efficiently (shorter durations), free users
+			// linger (longer durations). Scales watch_duration_min on playback
+			// completed events BEFORE H3/H8/H9 so each subsequent hook amplifies
+			// from the plan-adjusted base.
+			// Discover via: Insights → playback completed → Avg watch_duration_min → breakdown subscription_plan.
+			{
+				const plan = stampPlan;
+				const factor = (
+					plan === "premium" ? 0.67 :
+					plan === "free" ? 1.4 :
+					1.0
+				);
+				if (factor !== 1.0) {
+					for (const e of userEvents) {
+						if (e.event === "playback completed" && typeof e.watch_duration_min === "number") {
+							e.watch_duration_min = Math.round(e.watch_duration_min * factor);
+						}
+					}
+				}
+			}
+
 			// Hook #3: WEEKEND VS WEEKDAY — 1.5x watch_duration_min on weekends.
 			// No flag — analyst breaks down by day of week.
 			for (const e of userEvents) {
@@ -646,15 +700,12 @@ const config = {
 			// Identify behavioral patterns (no flags written)
 			let consecutiveCompletions = 0;
 			let maxConsecutiveCompletions = 0;
-			let adImpressionCount = 0;
-			let isFreeTier = false;
+			let earlyAdCount = 0;
 			let hasSubtitlesEnabled = false;
 			let recClickCount = 0;
 
+			const adCutoff = firstEventTime.add(45, 'days');
 			userEvents.forEach((event, idx) => {
-				if (idx === 0 && event.subscription_plan) {
-					isFreeTier = event.subscription_plan === "free";
-				}
 				if (event.event === "playback completed") {
 					consecutiveCompletions++;
 					if (consecutiveCompletions > maxConsecutiveCompletions) {
@@ -663,7 +714,7 @@ const config = {
 				} else if (event.event !== "playback started") {
 					consecutiveCompletions = 0;
 				}
-				if (event.event === "ad impression") adImpressionCount++;
+				if (event.event === "ad impression" && dayjs(event.time).isBefore(adCutoff)) earlyAdCount++;
 				if (event.event === "subtitle toggled" && event.action === "enabled") hasSubtitlesEnabled = true;
 				if (event.event === "recommendation clicked") recClickCount++;
 			});
@@ -708,18 +759,6 @@ const config = {
 				}
 			}
 
-			// Hook #4: AD FATIGUE CHURN — free-tier users w/ 10+ ads lose 50% of
-			// events after day 45. No flag — discover via cohort retention.
-			if (isFreeTier && adImpressionCount >= 10) {
-				const churnCutoff = firstEventTime.add(45, 'days');
-				for (let i = userEvents.length - 1; i >= 0; i--) {
-					const evt = userEvents[i];
-					if (dayjs(evt.time).isAfter(churnCutoff) && chance.bool({ likelihood: 50 })) {
-						userEvents.splice(i, 1);
-					}
-				}
-			}
-
 			// Hook #8: SUBTITLE USERS WATCH MORE — 1.25x completion_percent (cap 100),
 			// 1.15x watch_duration_min, plus 20% extra cloned playback completions.
 			// No flag — discover via cohort builder on subtitle-toggled-enabled.
@@ -756,7 +795,9 @@ const config = {
 
 			// Hook #9: RECOMMENDATION-CLICKED MAGIC NUMBER (no flags)
 			// Sweet 4-6 rec clicks → +25% watch_duration_min on playback completed.
-			// Over 7+ → drop 30% of playback completed events (rec fatigue).
+			// Over 7+ → halve watch_duration_min AND drop 55% of playback completed
+			// events (rec fatigue). Aggressive suppression overcomes the inherent
+			// engagement confound (high-rec-click users are naturally more active).
 			if (recClickCount >= 4 && recClickCount <= 6) {
 				userEvents.forEach(e => {
 					if (e.event === 'playback completed' && typeof e.watch_duration_min === 'number') {
@@ -765,8 +806,35 @@ const config = {
 				});
 			} else if (recClickCount >= 7) {
 				for (let i = userEvents.length - 1; i >= 0; i--) {
-					if (userEvents[i].event === 'playback completed' && chance.bool({ likelihood: 30 })) {
-						userEvents.splice(i, 1);
+					const evt = userEvents[i];
+					if (evt.event === 'playback completed') {
+						// Halve watch duration for surviving events
+						if (typeof evt.watch_duration_min === 'number') {
+							evt.watch_duration_min = Math.round(evt.watch_duration_min * 0.5);
+						}
+						// Drop 55% of completions
+						if (chance.bool({ likelihood: 55 })) {
+							userEvents.splice(i, 1);
+						}
+					}
+				}
+			}
+
+			// Hook #4: AD FATIGUE CHURN — users w/ 5+ early ad impressions lose
+			// nearly all events after day 45. Runs LAST so event-adding hooks
+			// (binge-watching, subtitle) can't re-inflate the post-d45 count.
+			// Applies to ALL tiers (ad fatigue affects anyone exposed to heavy ads,
+			// regardless of plan). 95% drop overcomes the ~3x activity confound.
+			if (earlyAdCount >= 5) {
+				const churnCutoff = firstEventTime.add(45, 'days');
+				for (let i = userEvents.length - 1; i >= 0; i--) {
+					const evt = userEvents[i];
+					if (dayjs(evt.time).isAfter(churnCutoff)) {
+						// Keep only ~5% of post-d45 events (drop 95%)
+						const keep = (i % 20) === 0;
+						if (!keep) {
+							userEvents.splice(i, 1);
+						}
 					}
 				}
 			}

package/dungeons/vertical/real-estate.js

@@ -247,6 +247,30 @@ const chance = u.initChance(SEED);
  * REAL-WORLD ANALOGUE: Focused buyers commit; obsessive browsers
  * tire-kick and never make the leap.
  *
+ * -------------------------------------------------------------------
+ * 10. TOUR FUNNEL TIME-TO-CONVERT (funnel-post)
+ * -------------------------------------------------------------------
+ *
+ * PATTERN: Premier-tier agents move users through the Tour funnel
+ * (property viewed -> tour scheduled -> offer submitted) 1.4x faster
+ * (factor 0.71). Standard-tier agents complete it 1.3x slower
+ * (factor 1.3). The hook intercepts funnel-post arrays, computes the
+ * time gap between consecutive steps, and scales each gap by the
+ * tier-specific factor before rewriting the step timestamps.
+ *
+ * HOW TO FIND IT IN MIXPANEL:
+ *
+ *   Report 1: Tour Funnel Median TTC by Agent Tier
+ *   - Report type: Funnels
+ *   - Steps: "property viewed" -> "tour scheduled" -> "offer submitted"
+ *   - Measure: Median time to convert
+ *   - Breakdown: "agent_tier" (user property / SCD)
+ *   - Expected: Premier ~ 0.71x baseline; Standard ~ 1.3x baseline
+ *
+ * REAL-WORLD ANALOGUE: Premier agents have larger networks, faster
+ * scheduling workflows, and prioritized showing slots, translating
+ * to shorter tour-to-offer cycles.
+ *
  * ===================================================================
  * EXPECTED METRICS SUMMARY
  * ===================================================================
@@ -263,6 +287,7 @@ const chance = u.initChance(SEED);
  * Cold-Lead Churn          | non-save post-day-14   | 1x       | 0.1x    | -90%
  * View-Count Magic Number  | sweet offer_price      | 1x       | 1.3x    | 1.3x
  * View-Count Magic Number  | over offers/user       | 1x       | 0.65x   | -35%
+ * Tour Funnel TTC          | median TTC by tier     | 1x       | 0.71/1.3x| ~ 1.8x range
  */
 
 /** @type {Config} */