@ak--47/dungeon-master 1.5.0 → 1.5.1

package/dungeons/technical/hook-helpers-verify.js

@@ -1,28 +1,40 @@
-/**
- * Phase 3 hook-helpers verification fixture.
+// ── IMPORTS ──
+import dayjs from 'dayjs';
+import {
+	binUsersByEventCount,
+	scalePropertyValue,
+	injectBurst,
+	cloneEvent,
+} from '../../lib/hook-helpers/index.js';
+/** @typedef {import("../../types").Dungeon} Config */
+
+// ── OVERVIEW ──
+/*
+ * NAME:       hook-helpers-verify
+ * PURPOSE:    Phase 3 fixture — exercises binUsersByEventCount + scalePropertyValue + injectBurst atoms
+ * SCALE:      1,000 users, ~120K events, 30 days
+ * EVENTS (2): Browse, Purchase
+ * FUNNELS (0): none
  *
- * Exercises three atoms inside one `everything` hook:
+ * Verified by DuckDB queries against the events output (see
+ * scripts/verify-runner.mjs + the Phase 3 verification gate notes in the plan).
+ */
+
+// ── HOOK STORIES ──
+/*
+ * Inside one `everything` hook:
  *   1. `binUsersByEventCount` — classify users into "casual" / "engaged" / "power"
  *      based on their count of `Browse` events.
  *   2. `scalePropertyValue` — engaged users get 2x `amount` on Purchase events;
  *      power users get 3x.
  *   3. `injectBurst` — power users also get a burst of 5 cloned `Browse` events
  *      around the midpoint of their stream.
- *
- * Verified by DuckDB queries against the events output (see
- * scripts/verify-runner.mjs + the Phase 3 verification gate notes in the plan).
  */
 
-import dayjs from 'dayjs';
-import {
-	binUsersByEventCount,
-	scalePropertyValue,
-	injectBurst,
-	cloneEvent,
-} from '../../lib/hook-helpers/index.js';
-
+// ── SCALE ──
 const FIXED_NOW = dayjs('2024-02-02').unix();
 
+// ── KNOBS (tweak these to reshape stories) ──
 const BINS = {
 	casual: [0, 5],
 	engaged: [5, 15],
@@ -32,7 +44,46 @@ const BINS = {
 const SCALE_BY_BIN = { casual: 1, engaged: 2, power: 3 };
 const BURST_COUNT_BY_BIN = { casual: 0, engaged: 0, power: 5 };
 
-export default {
+// ── HELPER FUNCTIONS ──
+function handleEverythingHooks(record, meta) {
+	// 1. Classify the user via cohort atom
+	const bin = binUsersByEventCount(record, 'Browse', BINS);
+	if (!bin) return record;
+
+	// Stamp the bin onto each Purchase so verification queries can group by it
+	// without re-deriving. Non-flag-stamping: this property is config-defined when
+	// dungeons add `cohort` to Purchase.properties; here we accept the small bend
+	// for the verification fixture so DuckDB queries are clean.
+	for (const ev of record) {
+		if (ev.event === 'Purchase') ev.cohort = bin;
+	}
+
+	// 2. Scale Purchase amounts via mutate atom (engaged 2x, power 3x)
+	const factor = SCALE_BY_BIN[bin] || 1;
+	if (factor !== 1) {
+		scalePropertyValue(record, e => e.event === 'Purchase', 'amount', factor);
+	}
+
+	// 3. Power users get a Browse burst clustered at the dataset midpoint
+	const burstCount = BURST_COUNT_BY_BIN[bin] || 0;
+	if (burstCount > 0 && record.length) {
+		const midUnixMs = (meta.datasetStart + (meta.datasetEnd - meta.datasetStart) / 2) * 1000;
+		// Use the user's first Browse as a clone template so we honor the schema.
+		const template = record.find(e => e.event === 'Browse');
+		if (template) {
+			const tpl = cloneEvent(template, { cohort: bin });
+			injectBurst(record, tpl, burstCount, midUnixMs, 60 * 60 * 1000); // ±1h spread
+		}
+	}
+
+	// Re-sort by time after burst injection so downstream pipeline sees ordered events.
+	record.sort((a, b) => (a.time < b.time ? -1 : a.time > b.time ? 1 : 0));
+	return record;
+}
+
+// ── CONFIG ──
+/** @type {Config} */
+const config = {
 	name: 'hook-helpers-verify',
 	seed: 'phase3-helpers-verify',
 	datasetStart: FIXED_NOW - 30 * 86400,
@@ -40,7 +91,6 @@ export default {
 	numUsers: 1_000,
 	avgEventsPerUserPerDay: 4,
 	percentUsersBornInDataset: 30,
-	hasAnonIds: false,
 	format: 'json',
 	concurrency: 1,
 	writeToDisk: true,
@@ -51,39 +101,8 @@ export default {
 	],
 	hook: function (record, type, meta) {
 		if (type !== 'everything' || !Array.isArray(record)) return record;
-
-		// 1. Classify the user via cohort atom
-		const bin = binUsersByEventCount(record, 'Browse', BINS);
-		if (!bin) return record;
-
-		// Stamp the bin onto each Purchase so verification queries can group by it
-		// without re-deriving. Non-flag-stamping: this property is config-defined when
-		// dungeons add `cohort` to Purchase.properties; here we accept the small bend
-		// for the verification fixture so DuckDB queries are clean.
-		for (const ev of record) {
-			if (ev.event === 'Purchase') ev.cohort = bin;
-		}
-
-		// 2. Scale Purchase amounts via mutate atom (engaged 2x, power 3x)
-		const factor = SCALE_BY_BIN[bin] || 1;
-		if (factor !== 1) {
-			scalePropertyValue(record, e => e.event === 'Purchase', 'amount', factor);
-		}
-
-		// 3. Power users get a Browse burst clustered at the dataset midpoint
-		const burstCount = BURST_COUNT_BY_BIN[bin] || 0;
-		if (burstCount > 0 && record.length) {
-			const midUnixMs = (meta.datasetStart + (meta.datasetEnd - meta.datasetStart) / 2) * 1000;
-			// Use the user's first Browse as a clone template so we honor the schema.
-			const template = record.find(e => e.event === 'Browse');
-			if (template) {
-				const tpl = cloneEvent(template, { cohort: bin });
-				injectBurst(record, tpl, burstCount, midUnixMs, 60 * 60 * 1000); // ±1h spread
-			}
-		}
-
-		// Re-sort by time after burst injection so downstream pipeline sees ordered events.
-		record.sort((a, b) => (a.time < b.time ? -1 : a.time > b.time ? 1 : 0));
-		return record;
+		return handleEverythingHooks(record, meta);
 	},
 };
+
+export default config;

package/dungeons/technical/identity-model-verify.js

@@ -1,16 +1,23 @@
-/**
- * Phase 2 identity model — verification fixture (intentionally simple).
- *
- * 1K born-in-dataset users with isAuthEvent on `Sign Up` (the stitch step) and a
- * 3-step first funnel. Dataset window pinned for determinism. avgDevicePerUser:2
- * exercises the multi-device sticky-per-session model. Used by phase 2 verification
- * gate (DuckDB queries against the events output).
- */
-
+// ── IMPORTS ──
 import dayjs from 'dayjs';
 
+// ── OVERVIEW ──
+/*
+ * NAME:       identity-model-verify
+ * PURPOSE:    Phase 2 identity model verification fixture (intentionally simple).
+ *             1K born-in-dataset users with isAuthEvent on `Sign Up` (the stitch
+ *             step) and a 3-step first funnel. avgDevicePerUser:2 exercises the
+ *             multi-device sticky-per-session model. Used by the phase 2
+ *             verification gate (DuckDB queries against the events output).
+ * SCALE:      1,000 users, ~90K events, 30 days
+ * EVENTS (6): Browse (5) > Save Item (2) > Land (1) > View Pricing (1) > Sign Up (1) > Onboarding (1)
+ * FUNNELS (1): Acquisition: Land → View Pricing → Sign Up → Onboarding (80%, attempts 0-2)
+ */
+
+// ── SCALE ──
 const FIXED_NOW = dayjs('2024-02-02').unix();
 
+// ── CONFIG ──
 export default {
 	name: 'identity-model-verify',
 	seed: 'phase2-identity-verify',
@@ -19,9 +26,12 @@ export default {
 	numUsers: 1_000,
 	avgEventsPerUserPerDay: 3,
 	percentUsersBornInDataset: 100,
-	hasAnonIds: true,
-	avgDevicePerUser: 2,
-	hasSessionIds: true,
+	switches: {
+		hasSessionIds: true,
+	},
+	identity: {
+		avgDevicePerUser: 2,
+	},
 	format: 'json',
 	concurrency: 1,
 	writeToDisk: true,

package/dungeons/technical/mirror-strategies.js

@@ -1,49 +1,47 @@
-// ── TWEAK THESE ──
-const SEED = "mirror-strategies";
-const num_days = 30;
-const num_users = 500;
-const avg_events_per_user_per_day = 2;
-let token = "";
-
-// ── env overrides ──
-if (process.env.MP_TOKEN) token = process.env.MP_TOKEN;
+// ── IMPORTS ──
+import { weighNumRange } from "../../lib/utils/utils.js";
+/** @typedef {import("../../types").Dungeon} Config */
 
-/**
- * Mirror Strategies — tests all 4 mirror data strategies.
- *
- * Exercises: create, update, fill, delete mirror transformations.
- * Each mirror prop targets a different event and uses a different
- * strategy so the output can be diffed against the original data.
- *
- * - 500 users, 30K events, 30 days
- * - 5 simple events, no funnels, no hooks
+// ── OVERVIEW ──
+/*
+ * NAME:       mirror-strategies
+ * PURPOSE:    exercises all 4 mirrorProps strategies (create, update, fill, delete)
+ * SCALE:      500 users, ~30K events, 30 days
+ * EVENTS (5): page view, checkout, profile update, subscription change, login
+ * FUNNELS (0): none
  */
 
-import Chance from 'chance';
-let chance = new Chance();
-import { weighNumRange, weighChoices } from "../../lib/utils/utils.js";
+// ── SCALE ──
+const SEED = "mirror-strategies";
+const NUM_DAYS = 30;
+const NUM_USERS = 500;
+const EVENTS_PER_DAY = 2;
+const token = process.env.MP_TOKEN || "";
 
-/** @typedef {import("../../types").Dungeon} Config */
-/** @type {import('../../types').Dungeon} */
+// ── CONFIG ──
+/** @type {Config} */
 const config = {
-	token,
 	seed: SEED,
-	numDays: num_days,
-	avgEventsPerUserPerDay: avg_events_per_user_per_day,
-	numUsers: num_users,
+	numDays: NUM_DAYS,
+	avgEventsPerUserPerDay: EVENTS_PER_DAY,
+	numUsers: NUM_USERS,
 	format: "json",
-	region: "US",
-	hasAnonIds: false,
-	hasSessionIds: false,
-	hasAdSpend: false,
-	hasLocation: false,
-	hasAndroidDevices: false,
-	hasIOSDevices: false,
-	hasDesktopDevices: false,
-	hasBrowser: false,
-	hasCampaigns: false,
-	isAnonymous: false,
-	alsoInferFunnels: false,
+	credentials: {
+		token,
+		region: "US",
+	},
+	switches: {
+		hasSessionIds: false,
+		hasAdSpend: false,
+		hasLocation: false,
+		hasAndroidDevices: false,
+		hasIOSDevices: false,
+		hasDesktopDevices: false,
+		hasBrowser: false,
+		hasCampaigns: false,
+		isAnonymous: false,
+		alsoInferFunnels: false,
+	},
 	concurrency: 1,
 	writeToDisk: false,
 

package/dungeons/technical/nested-objects.js

@@ -1,35 +1,31 @@
-// ── TWEAK THESE ──
-const SEED = "dm4-nested-objects";
-const num_days = 30;
-const num_users = 500;
-const avg_events_per_user_per_day = 2;
-let token = "";
-
-// ── env overrides ──
-if (process.env.MP_TOKEN) token = process.env.MP_TOKEN;
-
-import Chance from 'chance';
-let chance = new Chance();
+// ── IMPORTS ──
+import Chance from "chance";
 import dayjs from "dayjs";
 import utc from "dayjs/plugin/utc.js";
 dayjs.extend(utc);
-import { uid, comma } from 'ak-tools';
-import { weighNumRange, date, integer, weighChoices } from "../../lib/utils/utils.js";
-
+import { weighNumRange, integer } from "../../lib/utils/utils.js";
 /** @typedef {import("../../types").Dungeon} Config */
-/**
- * ═══════════════════════════════════════════════════════════════
- * TECHNICAL TEST: Nested Objects & High Cardinality
- * ═══════════════════════════════════════════════════════════════
- *
- * Tests Mixpanel's handling of:
- * - Array-of-object event properties (cart items, search results, form fields)
- * - Deeply nested object properties (metadata.browser.name, etc.)
- * - High cardinality string properties (10K product IDs, unique session IDs)
- *
- * 500 users, 30K events, 30 days. No hooks.
+
+// ── OVERVIEW ──
+/*
+ * NAME:       nested-objects
+ * PURPOSE:    Exercises array-of-object event properties, deeply nested object
+ *             properties, and high-cardinality string properties.
+ * SCALE:      500 users, ~30K events, 30 days
+ * EVENTS (4): checkout, search performed, form submitted, page view
+ * FUNNELS (0): none
  */
 
+// ── SCALE ──
+const SEED = "dm4-nested-objects";
+const NUM_DAYS = 30;
+const NUM_USERS = 500;
+const EVENTS_PER_DAY = 2;
+const token = process.env.MP_TOKEN || "";
+
+const chance = new Chance();
+
+// ── DATA ARRAYS ──
 const productCategories = ["electronics", "books", "clothing", "home", "garden", "toys", "sports", "automotive", "beauty", "health", "grocery", "jewelry", "shoes", "tools", "office"];
 const browsers = ["Chrome", "Firefox", "Safari", "Edge", "Opera", "Brave"];
 const browserVersions = ["120.0", "121.0", "119.0", "118.0", "117.0", "116.0", "115.0"];
@@ -38,98 +34,7 @@ const osList = ["Windows 11", "macOS 14", "iOS 17", "Android 14", "Linux", "Chro
 const cities = ["New York", "London", "Tokyo", "Berlin", "Sydney", "Toronto", "Paris", "Mumbai", "Seoul", "Mexico City", "Cairo", "Lagos", "Dubai", "Bangkok", "Istanbul"];
 const countries = ["US", "UK", "JP", "DE", "AU", "CA", "FR", "IN", "KR", "MX", "EG", "NG", "AE", "TH", "TR"];
 
-/** @type {import('../../types').Dungeon} */
-const config = {
-	token,
-	seed: SEED,
-	name: "nested-objects",
-	numDays: num_days,
-	avgEventsPerUserPerDay: avg_events_per_user_per_day,
-	numUsers: num_users,
-	format: 'json',
-	region: "US",
-	hasAnonIds: false,
-	hasSessionIds: false,
-	hasAdSpend: false,
-	hasLocation: false,
-	hasAndroidDevices: false,
-	hasIOSDevices: false,
-	hasDesktopDevices: true,
-	hasBrowser: false,
-	hasCampaigns: false,
-	isAnonymous: false,
-	alsoInferFunnels: false,
-	concurrency: 1,
-	writeToDisk: false,
-
-	events: [
-		{
-			event: "checkout",
-			weight: 3,
-			properties: {
-				// Array of objects: cart items
-				cart: makeCartItems(),
-				total_amount: weighNumRange(10, 2000, .25),
-				currency: ["USD", "EUR", "GBP", "JPY", "CAD"],
-				// High cardinality: unique session per event
-				session_id: () => chance.guid(),
-				// Deeply nested metadata
-				metadata: makeMetadata(),
-			}
-		},
-		{
-			event: "search performed",
-			weight: 5,
-			properties: {
-				query: ["laptop", "shoes", "headphones", "jacket", "phone case", "coffee maker", "backpack", "monitor", "keyboard", "mouse"],
-				// Array of objects: search results
-				results: makeSearchResults(),
-				result_count: weighNumRange(0, 50),
-				// High cardinality product ID
-				top_result_id: () => `prod_${integer(1, 10000)}`,
-				session_id: () => chance.guid(),
-				metadata: makeMetadata(),
-			}
-		},
-		{
-			event: "form submitted",
-			weight: 4,
-			properties: {
-				form_name: ["checkout", "signup", "contact", "feedback", "settings", "profile"],
-				// Array of objects: form fields
-				fields: makeFormFields(),
-				submission_valid: [true, true, true, false],
-				session_id: () => chance.guid(),
-				metadata: makeMetadata(),
-			}
-		},
-		{
-			event: "page view",
-			weight: 8,
-			properties: {
-				page: ["/", "/products", "/cart", "/search", "/account", "/help", "/about"],
-				// High cardinality
-				product_id: () => `prod_${integer(1, 10000)}`,
-				session_id: () => chance.guid(),
-				metadata: makeMetadata(),
-			}
-		},
-	],
-	funnels: [],
-	superProps: {},
-	userProps: {
-		plan: ["free", "basic", "pro", "enterprise"],
-	},
-	scdProps: {},
-	mirrorProps: {},
-	groupKeys: [],
-	groupProps: {},
-	lookupTables: [],
-	hook: function (record, type, meta) {
-		return record;
-	}
-};
-
+// ── HELPER FUNCTIONS ──
 /**
  * Generates an array-of-objects property for cart items.
  * Each cart has 1-5 items with product_id, name, price, quantity, category.
@@ -215,4 +120,100 @@ function makeMetadata() {
 	};
 }
 
+// ── CONFIG ──
+/** @type {Config} */
+const config = {
+	seed: SEED,
+	name: "nested-objects",
+	numDays: NUM_DAYS,
+	avgEventsPerUserPerDay: EVENTS_PER_DAY,
+	numUsers: NUM_USERS,
+	format: 'json',
+	credentials: {
+		token,
+		region: "US",
+	},
+	switches: {
+		hasSessionIds: false,
+		hasAdSpend: false,
+		hasLocation: false,
+		hasAndroidDevices: false,
+		hasIOSDevices: false,
+		hasDesktopDevices: true,
+		hasBrowser: false,
+		hasCampaigns: false,
+		isAnonymous: false,
+		alsoInferFunnels: false,
+	},
+	concurrency: 1,
+	writeToDisk: false,
+
+	events: [
+		{
+			event: "checkout",
+			weight: 3,
+			properties: {
+				// Array of objects: cart items
+				cart: makeCartItems(),
+				total_amount: weighNumRange(10, 2000, .25),
+				currency: ["USD", "EUR", "GBP", "JPY", "CAD"],
+				// High cardinality: unique session per event
+				session_id: () => chance.guid(),
+				// Deeply nested metadata
+				metadata: makeMetadata(),
+			}
+		},
+		{
+			event: "search performed",
+			weight: 5,
+			properties: {
+				query: ["laptop", "shoes", "headphones", "jacket", "phone case", "coffee maker", "backpack", "monitor", "keyboard", "mouse"],
+				// Array of objects: search results
+				results: makeSearchResults(),
+				result_count: weighNumRange(0, 50),
+				// High cardinality product ID
+				top_result_id: () => `prod_${integer(1, 10000)}`,
+				session_id: () => chance.guid(),
+				metadata: makeMetadata(),
+			}
+		},
+		{
+			event: "form submitted",
+			weight: 4,
+			properties: {
+				form_name: ["checkout", "signup", "contact", "feedback", "settings", "profile"],
+				// Array of objects: form fields
+				fields: makeFormFields(),
+				submission_valid: [true, true, true, false],
+				session_id: () => chance.guid(),
+				metadata: makeMetadata(),
+			}
+		},
+		{
+			event: "page view",
+			weight: 8,
+			properties: {
+				page: ["/", "/products", "/cart", "/search", "/account", "/help", "/about"],
+				// High cardinality
+				product_id: () => `prod_${integer(1, 10000)}`,
+				session_id: () => chance.guid(),
+				metadata: makeMetadata(),
+			}
+		},
+	],
+	funnels: [],
+	superProps: {},
+	userProps: {
+		plan: ["free", "basic", "pro", "enterprise"],
+	},
+	scdProps: {},
+	mirrorProps: {},
+	groupKeys: [],
+	groupProps: {},
+	lookupTables: [],
+	hook: function (record, type, meta) {
+		return record;
+	}
+};
+
 export default config;

package/dungeons/technical/pattern-aggregate-by-bin.js

@@ -1,15 +1,29 @@
-/**
- * Phase 4 reference dungeon — aggregate per user, by bin.
- *
- * Users in the high-Browse cohort have 4× higher Purchase amounts on average;
- * mid cohort 2×; low cohort 1×. Verified via the aggregatePerUser emulator.
- */
-
+// ── IMPORTS ──
 import dayjs from 'dayjs';
 import { applyAggregateByBin } from '../../lib/hook-patterns/index.js';
 
+// ── OVERVIEW ──
+/*
+ * NAME:       pattern-aggregate-by-bin
+ * PURPOSE:    Phase 4 reference fixture — aggregate per user, by bin. Users in
+ *             the high-Browse cohort have 4× higher Purchase amounts on average;
+ *             mid 2×; low 1×. Verified via the aggregatePerUser emulator.
+ * SCALE:      1,000 users, ~180K events, 30 days
+ * EVENTS (2): Browse (6) > Purchase (2)
+ * FUNNELS (0): none
+ */
+
+// ── HOOK STORIES ──
+/*
+ * PATTERN: Bin users by Browse count (low 0-5, mid 5-15, high 15+);
+ * scale Purchase `amount` by {low:1, mid:2, high:4}. Verified via
+ * the aggregatePerUser emulator.
+ */
+
+// ── SCALE ──
 const FIXED_NOW = dayjs('2024-02-02').unix();
 
+// ── CONFIG ──
 export default {
 	name: 'pattern-agg-by-bin',
 	seed: 'phase4-aggbybin',
@@ -18,7 +32,6 @@ export default {
 	numUsers: 1_000,
 	avgEventsPerUserPerDay: 6,
 	percentUsersBornInDataset: 30,
-	hasAnonIds: false,
 	format: 'json',
 	concurrency: 1,
 	writeToDisk: true,

package/dungeons/technical/pattern-attributed-by-source.js

@@ -1,16 +1,31 @@
-/**
- * Phase 4 reference dungeon — conversions attributed by source.
- *
- * Touch events carry one of three random sources; conversions are stamped with
- * the user's first-touch source weighted google:facebook:twitter = 10:5:1.
- * Verified via the attributedBy emulator.
- */
-
+// ── IMPORTS ──
 import dayjs from 'dayjs';
 import { applyAttributedBySource } from '../../lib/hook-patterns/index.js';
 
+// ── OVERVIEW ──
+/*
+ * NAME:       pattern-attributed-by-source
+ * PURPOSE:    Phase 4 reference fixture — conversions attributed by source.
+ *             Touch events carry one of three random sources; conversions are
+ *             stamped with the user's first-touch source weighted
+ *             google:facebook:twitter = 10:5:1. Verified via the attributedBy
+ *             emulator.
+ * SCALE:      1,000 users, ~120K events, 30 days
+ * EVENTS (2): Touch (5) > Convert (2)
+ * FUNNELS (0): none
+ */
+
+// ── HOOK STORIES ──
+/*
+ * PATTERN: First-touch attribution — stamp each Convert event with the
+ * source of the user's first Touch, weighted google:facebook:twitter =
+ * 10:5:1. Verified via the attributedBy emulator.
+ */
+
+// ── SCALE ──
 const FIXED_NOW = dayjs('2024-02-02').unix();
 
+// ── CONFIG ──
 export default {
 	name: 'pattern-attributed-by-source',
 	seed: 'phase4-attrib',
@@ -19,7 +34,6 @@ export default {
 	numUsers: 1_000,
 	avgEventsPerUserPerDay: 4,
 	percentUsersBornInDataset: 50,
-	hasAnonIds: false,
 	format: 'json',
 	concurrency: 1,
 	writeToDisk: true,

package/dungeons/technical/pattern-frequency-by-frequency.js

@@ -1,15 +1,29 @@
-/**
- * Phase 4 reference dungeon — frequency × frequency.
- *
- * Engages users into low / mid / high "Browse" cohorts; high-cohort users get 3×
- * Purchase events. Verified by the Phase 4 patterns test + verify-runner.
- */
-
+// ── IMPORTS ──
 import dayjs from 'dayjs';
 import { applyFrequencyByFrequency } from '../../lib/hook-patterns/index.js';
 
+// ── OVERVIEW ──
+/*
+ * NAME:       pattern-frequency-by-frequency
+ * PURPOSE:    Phase 4 reference fixture — frequency × frequency. Engages users
+ *             into low/mid/high "Browse" cohorts; high-cohort users get 3×
+ *             Purchase events. Verified by the Phase 4 patterns test + verify-runner.
+ * SCALE:      1,000 users, ~180K events, 30 days
+ * EVENTS (2): Browse (6) > Purchase (2)
+ * FUNNELS (0): none
+ */
+
+// ── HOOK STORIES ──
+/*
+ * PATTERN: Bin users by Browse count (low 0-5, mid 5-15, high 15+);
+ * scale Purchase event count by {low:1, mid:2, high:3}. Verified via
+ * the frequencyByFrequency emulator.
+ */
+
+// ── SCALE ──
 const FIXED_NOW = dayjs('2024-02-02').unix();
 
+// ── CONFIG ──
 export default {
 	name: 'pattern-freq-by-freq',
 	seed: 'phase4-freqxfreq',
@@ -18,7 +32,6 @@ export default {
 	numUsers: 1_000,
 	avgEventsPerUserPerDay: 6,
 	percentUsersBornInDataset: 30,
-	hasAnonIds: false,
 	format: 'json',
 	concurrency: 1,
 	writeToDisk: true,