@lssm/example.learning-journey-registry 0.0.0-canary-20251217060834 → 0.0.0-canary-20251217072406

package/dist/api.js

@@ -1 +1,170 @@
-import{learningJourneyTracks as e}from"./tracks.js";import{getLearnerTracks as t,getTrackResolver as n,initProgress as r}from"./progress-store.js";const i=n(e),a=(e,t)=>e?t?Object.entries(e).every(([e,n])=>t[e]===n):!1:!0,o=(e,t)=>e.eventName!==t.name||e.eventVersion!==void 0&&t.version!==void 0&&e.eventVersion!==t.version||e.sourceModule&&t.sourceModule&&e.sourceModule!==t.sourceModule?!1:a(e.payloadFilter,t.payload),s=(e,t,n,r)=>{if(e.kind===`count`){if(!o(e,t))return{matched:!1};let i=(n.occurrences??0)+1;return{matched:(e.withinHours===void 0||!!(r&&t.occurredAt&&(t.occurredAt.getTime()-r.getTime())/(1e3*60*60)<=e.withinHours))&&i>=e.atLeast,occurrences:i}}if(e.kind===`time_window`)return!o(e,t)||e.withinHoursOfStart!==void 0&&r&&t.occurredAt&&(t.occurredAt.getTime()-r.getTime())/(1e3*60*60)>e.withinHoursOfStart?{matched:!1}:{matched:!0};if(e.kind===`srs_mastery`){if(t.name!==e.eventName)return{matched:!1};let r=t.payload;if(!a(e.payloadFilter,r))return{matched:!1};let i=e.skillIdField??`skillId`,o=e.masteryField??`mastery`,s=r?.[i],c=r?.[o];if(s===void 0||c===void 0||typeof c!=`number`||c<e.minimumMastery)return{matched:!1};let l=(n.masteryCount??0)+1;return{matched:l>=(e.requiredCount??1),masteryCount:l}}return{matched:o(e,t)}},c=(e,t)=>{if(!e||!t)return{};let n=t.getTime(),r=n;e.unlockOnDay!==void 0&&(r=n+(e.unlockOnDay-1)*24*60*60*1e3),e.unlockAfterHours!==void 0&&(r=n+e.unlockAfterHours*60*60*1e3);let i=new Date(r);return{availableAt:i,dueAt:e.dueWithinHours===void 0?void 0:new Date(i.getTime()+e.dueWithinHours*60*60*1e3)}},l=e=>{let t=e.length||1,n=e.filter(e=>e.status===`COMPLETED`).length;return Math.round(n/t*100)},u=(e,t)=>{if(t.isCompleted)return t;let n=new Date,r=t.startedAt??n,i=(n.getTime()-r.getTime())/(1e3*60*60),a=t.xpEarned,{completionRewards:o,streakRule:s}=e;return o?.xpBonus&&(a+=o.xpBonus),s?.hoursWindow!==void 0&&i<=s.hoursWindow&&s.bonusXp&&(a+=s.bonusXp),{...t,xpEarned:a,isCompleted:!0,completedAt:n,lastActivityAt:n}},d=n=>{let r=n?t(n):void 0;return{tracks:e,progress:n&&r?Array.from(r.values()):[]}},f=(e,n)=>{let a=i(e);if(!a)return;let o=t(n),s=o.get(e)??r(n,a);return o.set(e,s),s},p=n=>{let i=n.trackId===void 0?e:e.filter(e=>e.id===n.trackId),a=[],o=n.occurredAt??new Date;for(let e of i){let i=t(n.learnerId),d=i.get(e.id)??r(n.learnerId,e),f=d.startedAt??o,p=d.startedAt===void 0,m=d.steps.map(t=>{if(t.status===`COMPLETED`)return t;let r=e.steps.find(e=>e.id===t.id);if(!r)return t;let{availableAt:i,dueAt:a}=c(r.availability,f);if(i&&o<i||a&&o>a)return{...t,availableAt:i,dueAt:a};let l=s(r.completion,n,t,f);return l.matched?(p=!0,{...t,status:`COMPLETED`,xpEarned:r.xpReward??0,completedAt:o,triggeringEvent:n.name,eventPayload:n.payload,occurrences:l.occurrences??t.occurrences,masteryCount:l.masteryCount??t.masteryCount,availableAt:i,dueAt:a}):((l.occurrences!==void 0||l.masteryCount!==void 0)&&(p=!0),{...t,occurrences:l.occurrences??t.occurrences,masteryCount:l.masteryCount??t.masteryCount,availableAt:i,dueAt:a})});if(!p)continue;let h=m.reduce((e,t)=>e+t.xpEarned,0)+(e.totalXp??0),g={...d,steps:m,xpEarned:h,startedAt:f,lastActivityAt:o,progress:l(m)};m.every(e=>e.status===`COMPLETED`)&&(g=u(e,g)),i.set(e.id,g),a.push(g)}return a};export{f as getProgress,d as listTracks,p as recordEvent};
+import { learningJourneyTracks } from "./tracks.js";
+import { getLearnerTracks, getTrackResolver, initProgress } from "./progress-store.js";
+
+//#region src/api.ts
+const getTrack = getTrackResolver(learningJourneyTracks);
+const matchesFilter = (filter, payload) => {
+	if (!filter) return true;
+	if (!payload) return false;
+	return Object.entries(filter).every(([key, value]) => payload[key] === value);
+};
+const matchesBaseEvent = (condition, event) => {
+	if (condition.eventName !== event.name) return false;
+	if (condition.eventVersion !== void 0 && event.version !== void 0) {
+		if (condition.eventVersion !== event.version) return false;
+	}
+	if (condition.sourceModule && event.sourceModule && condition.sourceModule !== event.sourceModule) return false;
+	return matchesFilter(condition.payloadFilter, event.payload);
+};
+const matchesCondition = (condition, event, step, trackStartedAt) => {
+	if (condition.kind === "count") {
+		if (!matchesBaseEvent(condition, event)) return { matched: false };
+		const occurrences = (step.occurrences ?? 0) + 1;
+		return {
+			matched: (condition.withinHours === void 0 || Boolean(trackStartedAt && event.occurredAt && (event.occurredAt.getTime() - trackStartedAt.getTime()) / (1e3 * 60 * 60) <= condition.withinHours)) && occurrences >= condition.atLeast,
+			occurrences
+		};
+	}
+	if (condition.kind === "time_window") {
+		if (!matchesBaseEvent(condition, event)) return { matched: false };
+		if (condition.withinHoursOfStart !== void 0 && trackStartedAt && event.occurredAt) {
+			if ((event.occurredAt.getTime() - trackStartedAt.getTime()) / (1e3 * 60 * 60) > condition.withinHoursOfStart) return { matched: false };
+		}
+		return { matched: true };
+	}
+	if (condition.kind === "srs_mastery") {
+		if (event.name !== condition.eventName) return { matched: false };
+		const payload = event.payload;
+		if (!matchesFilter(condition.payloadFilter, payload)) return { matched: false };
+		const skillKey = condition.skillIdField ?? "skillId";
+		const masteryKey = condition.masteryField ?? "mastery";
+		const skillId = payload?.[skillKey];
+		const masteryValue = payload?.[masteryKey];
+		if (skillId === void 0 || masteryValue === void 0) return { matched: false };
+		if (typeof masteryValue !== "number") return { matched: false };
+		if (masteryValue < condition.minimumMastery) return { matched: false };
+		const masteryCount = (step.masteryCount ?? 0) + 1;
+		return {
+			matched: masteryCount >= (condition.requiredCount ?? 1),
+			masteryCount
+		};
+	}
+	return { matched: matchesBaseEvent(condition, event) };
+};
+const getAvailability = (availability, startedAt) => {
+	if (!availability || !startedAt) return {};
+	const baseTime = startedAt.getTime();
+	let unlockTime = baseTime;
+	if (availability.unlockOnDay !== void 0) unlockTime = baseTime + (availability.unlockOnDay - 1) * 24 * 60 * 60 * 1e3;
+	if (availability.unlockAfterHours !== void 0) unlockTime = baseTime + availability.unlockAfterHours * 60 * 60 * 1e3;
+	const availableAt = new Date(unlockTime);
+	return {
+		availableAt,
+		dueAt: availability.dueWithinHours !== void 0 ? new Date(availableAt.getTime() + availability.dueWithinHours * 60 * 60 * 1e3) : void 0
+	};
+};
+const computeProgressPercent = (steps) => {
+	const total = steps.length || 1;
+	const done = steps.filter((s) => s.status === "COMPLETED").length;
+	return Math.round(done / total * 100);
+};
+const applyTrackCompletionBonuses = (track, progress) => {
+	if (progress.isCompleted) return progress;
+	const completedAt = /* @__PURE__ */ new Date();
+	const startedAt = progress.startedAt ?? completedAt;
+	const hoursElapsed = (completedAt.getTime() - startedAt.getTime()) / (1e3 * 60 * 60);
+	let xpEarned = progress.xpEarned;
+	const { completionRewards, streakRule } = track;
+	if (completionRewards?.xpBonus) xpEarned += completionRewards.xpBonus;
+	if (streakRule?.hoursWindow !== void 0 && hoursElapsed <= streakRule.hoursWindow && streakRule.bonusXp) xpEarned += streakRule.bonusXp;
+	return {
+		...progress,
+		xpEarned,
+		isCompleted: true,
+		completedAt,
+		lastActivityAt: completedAt
+	};
+};
+const listTracks = (learnerId) => {
+	const progressMap = learnerId ? getLearnerTracks(learnerId) : void 0;
+	return {
+		tracks: learningJourneyTracks,
+		progress: learnerId && progressMap ? Array.from(progressMap.values()) : []
+	};
+};
+const getProgress = (trackId, learnerId) => {
+	const track = getTrack(trackId);
+	if (!track) return void 0;
+	const map = getLearnerTracks(learnerId);
+	const existing = map.get(trackId) ?? initProgress(learnerId, track);
+	map.set(trackId, existing);
+	return existing;
+};
+const recordEvent = (event) => {
+	const targets = event.trackId !== void 0 ? learningJourneyTracks.filter((t) => t.id === event.trackId) : learningJourneyTracks;
+	const updated = [];
+	const eventTime = event.occurredAt ?? /* @__PURE__ */ new Date();
+	for (const track of targets) {
+		const map = getLearnerTracks(event.learnerId);
+		const current = map.get(track.id) ?? initProgress(event.learnerId, track);
+		const startedAt = current.startedAt ?? eventTime;
+		let changed = current.startedAt === void 0;
+		const steps = current.steps.map((step) => {
+			if (step.status === "COMPLETED") return step;
+			const spec = track.steps.find((s) => s.id === step.id);
+			if (!spec) return step;
+			const { availableAt, dueAt } = getAvailability(spec.availability, startedAt);
+			if (availableAt && eventTime < availableAt) return {
+				...step,
+				availableAt,
+				dueAt
+			};
+			if (dueAt && eventTime > dueAt) return {
+				...step,
+				availableAt,
+				dueAt
+			};
+			const result = matchesCondition(spec.completion, event, step, startedAt);
+			if (result.matched) {
+				changed = true;
+				return {
+					...step,
+					status: "COMPLETED",
+					xpEarned: spec.xpReward ?? 0,
+					completedAt: eventTime,
+					triggeringEvent: event.name,
+					eventPayload: event.payload,
+					occurrences: result.occurrences ?? step.occurrences,
+					masteryCount: result.masteryCount ?? step.masteryCount,
+					availableAt,
+					dueAt
+				};
+			}
+			if (result.occurrences !== void 0 || result.masteryCount !== void 0) changed = true;
+			return {
+				...step,
+				occurrences: result.occurrences ?? step.occurrences,
+				masteryCount: result.masteryCount ?? step.masteryCount,
+				availableAt,
+				dueAt
+			};
+		});
+		if (!changed) continue;
+		const xpEarned = steps.reduce((sum, s) => sum + s.xpEarned, 0) + (track.totalXp ?? 0);
+		let progress = {
+			...current,
+			steps,
+			xpEarned,
+			startedAt,
+			lastActivityAt: eventTime,
+			progress: computeProgressPercent(steps)
+		};
+		if (steps.every((s) => s.status === "COMPLETED")) progress = applyTrackCompletionBonuses(track, progress);
+		map.set(track.id, progress);
+		updated.push(progress);
+	}
+	return updated;
+};
+
+//#endregion
+export { getProgress, listTracks, recordEvent };

package/dist/docs/index.js

@@ -1 +1 @@
-import"./learning-journey-registry.docblock.js";
+import "./learning-journey-registry.docblock.js";

package/dist/docs/learning-journey-registry.docblock.js

@@ -1 +1,38 @@
-import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contracts/dist/docs/index.js";e([{id:`docs.learning-journey.registry`,title:`Learning Journey — Example Track Registry`,summary:`Aggregates learning journey example tracks (Studio onboarding, Platform tour, CRM first win, Drills, Ambient Coach, Quest challenges).`,kind:`usage`,visibility:`public`,route:`/docs/learning-journey/registry`,tags:[`learning`,`registry`,`onboarding`],body:"## Tracks\n- `studio_getting_started` (Studio onboarding)\n- `platform_primitives_tour` (Platform primitives)\n- `crm_first_win` (CRM pipeline onboarding)\n- `drills_language_basics` (Drills & SRS)\n- `money_ambient_coach`, `coliving_ambient_coach` (Ambient tips)\n- `money_reset_7day` (Quest/challenge)\n\n## Exports\n- `learningJourneyTracks` — raw specs\n- `onboardingTrackCatalog` — DTOs aligned with onboarding API\n- `mapTrackSpecToDto` — helper to map individual tracks\n\n## Wiring\n- Use with onboarding API contracts:\n  - `learning.onboarding.listTracks`\n  - `learning.onboarding.getProgress`\n  - `learning.onboarding.recordEvent`\n- Intended for registry/adapters in Studio UI or services that surface tracks."}]);
+import { registerDocBlocks } from "../libs/contracts/dist/docs/registry.js";
+import "../libs/contracts/dist/docs/index.js";
+
+//#region src/docs/learning-journey-registry.docblock.ts
+registerDocBlocks([{
+	id: "docs.learning-journey.registry",
+	title: "Learning Journey — Example Track Registry",
+	summary: "Aggregates learning journey example tracks (Studio onboarding, Platform tour, CRM first win, Drills, Ambient Coach, Quest challenges).",
+	kind: "usage",
+	visibility: "public",
+	route: "/docs/learning-journey/registry",
+	tags: [
+		"learning",
+		"registry",
+		"onboarding"
+	],
+	body: `## Tracks
+- \`studio_getting_started\` (Studio onboarding)
+- \`platform_primitives_tour\` (Platform primitives)
+- \`crm_first_win\` (CRM pipeline onboarding)
+- \`drills_language_basics\` (Drills & SRS)
+- \`money_ambient_coach\`, \`coliving_ambient_coach\` (Ambient tips)
+- \`money_reset_7day\` (Quest/challenge)
+
+## Exports
+- \`learningJourneyTracks\` — raw specs
+- \`onboardingTrackCatalog\` — DTOs aligned with onboarding API
+- \`mapTrackSpecToDto\` — helper to map individual tracks
+
+## Wiring
+- Use with onboarding API contracts:
+  - \`learning.onboarding.listTracks\`
+  - \`learning.onboarding.getProgress\`
+  - \`learning.onboarding.recordEvent\`
+- Intended for registry/adapters in Studio UI or services that surface tracks.`
+}]);
+
+//#endregion

package/dist/example.js

@@ -1 +1,34 @@
-var e={id:`learning-journey-registry`,title:`Learning Journey Registry`,summary:`Registry of learning journey tracks + presentations + UI mini-app bindings.`,tags:[`learning`,`journey`,`registry`],kind:`library`,visibility:`public`,docs:{rootDocId:`docs.examples.learning-journey-registry`},entrypoints:{packageName:`@lssm/example.learning-journey-registry`,docs:`./docs`},surfaces:{templates:!0,sandbox:{enabled:!0,modes:[`markdown`,`specs`]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}};export{e as default};
+//#region src/example.ts
+const example = {
+	id: "learning-journey-registry",
+	title: "Learning Journey Registry",
+	summary: "Registry of learning journey tracks + presentations + UI mini-app bindings.",
+	tags: [
+		"learning",
+		"journey",
+		"registry"
+	],
+	kind: "library",
+	visibility: "public",
+	docs: { rootDocId: "docs.examples.learning-journey-registry" },
+	entrypoints: {
+		packageName: "@lssm/example.learning-journey-registry",
+		docs: "./docs"
+	},
+	surfaces: {
+		templates: true,
+		sandbox: {
+			enabled: true,
+			modes: ["markdown", "specs"]
+		},
+		studio: {
+			enabled: true,
+			installable: true
+		},
+		mcp: { enabled: true }
+	}
+};
+var example_default = example;
+
+//#endregion
+export { example_default as default };

package/dist/examples/learning-journey-ambient-coach/src/track.js

@@ -0,0 +1,41 @@
+//#region ../learning-journey-ambient-coach/src/track.ts
+const makeTipStep = (id, tipId, description) => ({
+	id,
+	title: `Resolve tip: ${tipId}`,
+	description,
+	completion: {
+		kind: "event",
+		eventName: "coach.tip.follow_up_action_taken",
+		payloadFilter: { tipId }
+	},
+	xpReward: 20,
+	metadata: { tipId }
+});
+const moneyAmbientCoachTrack = {
+	id: "money_ambient_coach",
+	name: "Ambient Coach — Money",
+	description: "Subtle coaching for money patterns (cash buffer, goals, saving rhythm).",
+	targetUserSegment: "money_user",
+	totalXp: 60,
+	steps: [
+		makeTipStep("cash_buffer_too_high", "cash_buffer_too_high", "Suggest sweeping excess cash into goals."),
+		makeTipStep("no_savings_goal", "no_savings_goal", "Prompt setting a first savings goal."),
+		makeTipStep("irregular_savings", "irregular_savings", "Recommend recurring saves after irregular deposits.")
+	]
+};
+const colivingAmbientCoachTrack = {
+	id: "coliving_ambient_coach",
+	name: "Ambient Coach — Coliving",
+	description: "Contextual tips for healthy coliving habits.",
+	targetUserSegment: "coliving",
+	totalXp: 60,
+	steps: [
+		makeTipStep("noise_late_evening", "noise_late_evening", "Suggest updating quiet hours to reduce evening noise."),
+		makeTipStep("guest_frequency_high", "guest_frequency_high", "Set guest frequency expectations for the house."),
+		makeTipStep("shared_space_conflicts", "shared_space_conflicts", "Offer a shared-space checklist to reduce conflicts.")
+	]
+};
+const ambientCoachTracks = [moneyAmbientCoachTrack, colivingAmbientCoachTrack];
+
+//#endregion
+export { ambientCoachTracks };

package/dist/examples/learning-journey-crm-onboarding/dist/track.js

@@ -0,0 +1,98 @@
+//#region ../learning-journey-crm-onboarding/dist/track.js
+const crmFirstWinTrack = {
+	id: "crm_first_win",
+	productId: "crm-pipeline",
+	name: "CRM First Win",
+	description: "Guide a new CRM user from empty pipeline to first closed-won deal.",
+	targetUserSegment: "crm_adopter",
+	targetRole: "sales",
+	totalXp: 135,
+	streakRule: {
+		hoursWindow: 72,
+		bonusXp: 25
+	},
+	completionRewards: {
+		xpBonus: 25,
+		badgeKey: "crm_first_win"
+	},
+	steps: [
+		{
+			id: "create_pipeline",
+			title: "Create pipeline & stages",
+			description: "Create a pipeline with baseline stages.",
+			order: 1,
+			completion: {
+				eventName: "pipeline.created",
+				sourceModule: "@lssm/example.crm-pipeline"
+			},
+			xpReward: 15,
+			metadata: { surface: "pipeline" }
+		},
+		{
+			id: "create_contact_and_company",
+			title: "Create contact and company",
+			description: "Add your first contact and associated company.",
+			order: 2,
+			completion: {
+				eventName: "contact.created",
+				sourceModule: "@lssm/example.crm-pipeline"
+			},
+			xpReward: 20,
+			metadata: { surface: "contacts" }
+		},
+		{
+			id: "create_first_deal",
+			title: "Log first deal",
+			description: "Create your first deal in the pipeline.",
+			order: 3,
+			completion: {
+				eventName: "deal.created",
+				sourceModule: "@lssm/example.crm-pipeline"
+			},
+			xpReward: 20,
+			metadata: { surface: "deals" }
+		},
+		{
+			id: "move_deal_in_pipeline",
+			title: "Move a deal across stages",
+			description: "Move a deal across at least three stages.",
+			order: 4,
+			completion: {
+				eventName: "deal.moved",
+				sourceModule: "@lssm/example.crm-pipeline"
+			},
+			xpReward: 20,
+			metadata: { surface: "deals" }
+		},
+		{
+			id: "close_deal_won",
+			title: "Close a deal as won",
+			description: "Close a deal as won to hit first revenue.",
+			order: 5,
+			completion: {
+				eventName: "deal.won",
+				sourceModule: "@lssm/example.crm-pipeline"
+			},
+			xpReward: 30,
+			metadata: { surface: "deals" }
+		},
+		{
+			id: "setup_follow_up",
+			title: "Create follow-up task",
+			description: "Create a follow-up task and notification for a contact or deal.",
+			order: 6,
+			completion: {
+				eventName: "task.completed",
+				sourceModule: "@lssm/example.crm-pipeline",
+				payloadFilter: { type: "follow_up" }
+			},
+			xpReward: 30,
+			metadata: { surface: "tasks" }
+		}
+	],
+	metadata: { surfacedIn: ["crm/dashboard", "crm/pipeline"] }
+};
+const crmLearningTracks = [crmFirstWinTrack];
+
+//#endregion
+export { crmLearningTracks };

package/dist/examples/learning-journey-duo-drills/src/track.js

@@ -0,0 +1,65 @@
+//#region ../learning-journey-duo-drills/src/track.ts
+const drillsLanguageBasicsTrack = {
+	id: "drills_language_basics",
+	name: "Language Basics Drills",
+	description: "Short SRS-driven drills to master a first skill, modeled after Duolingo-style sessions.",
+	targetUserSegment: "learner",
+	targetRole: "individual",
+	totalXp: 50,
+	completionRewards: { xpBonus: 25 },
+	steps: [
+		{
+			id: "complete_first_session",
+			title: "Complete first drill session",
+			description: "Finish a drill session to get started.",
+			order: 1,
+			completion: {
+				kind: "event",
+				eventName: "drill.session.completed"
+			},
+			xpReward: 20,
+			metadata: { surface: "drills" }
+		},
+		{
+			id: "reach_accuracy_threshold",
+			title: "Hit high accuracy in sessions",
+			description: "Achieve three high-accuracy sessions to build confidence.",
+			order: 2,
+			completion: {
+				kind: "count",
+				eventName: "drill.session.completed",
+				atLeast: 3,
+				payloadFilter: { accuracyBucket: "high" }
+			},
+			xpReward: 30,
+			metadata: {
+				metric: "accuracy",
+				target: ">=85%"
+			}
+		},
+		{
+			id: "unlock_new_skill",
+			title: "Master core cards in first skill",
+			description: "Reach mastery on at least five cards in the first skill to unlock the next one.",
+			order: 3,
+			completion: {
+				kind: "srs_mastery",
+				eventName: "drill.card.mastered",
+				minimumMastery: .8,
+				requiredCount: 5,
+				skillIdField: "skillId",
+				masteryField: "mastery",
+				payloadFilter: { skillId: "language_basics" }
+			},
+			xpReward: 40,
+			metadata: {
+				surface: "srs",
+				skill: "language_basics"
+			}
+		}
+	]
+};
+const drillTracks = [drillsLanguageBasicsTrack];
+
+//#endregion
+export { drillTracks };

package/dist/examples/learning-journey-platform-tour/dist/track.js

@@ -0,0 +1,105 @@
+//#region ../learning-journey-platform-tour/dist/track.js
+const platformPrimitivesTourTrack = {
+	id: "platform_primitives_tour",
+	productId: "contractspec-platform",
+	name: "Platform Primitives Tour",
+	description: "Hands-on tour across identity, audit, notifications, jobs, flags, files, and metering.",
+	targetUserSegment: "platform_developer",
+	targetRole: "developer",
+	totalXp: 140,
+	completionRewards: {
+		xpBonus: 20,
+		badgeKey: "platform_primitives"
+	},
+	steps: [
+		{
+			id: "identity_rbac",
+			title: "Create org and member",
+			description: "Create an org and add at least one member.",
+			order: 1,
+			completion: {
+				eventName: "org.member.added",
+				sourceModule: "@lssm/lib.identity-rbac"
+			},
+			xpReward: 20,
+			metadata: { surface: "identity" }
+		},
+		{
+			id: "event_bus_audit",
+			title: "Emit an auditable event",
+			description: "Emit an event that lands in the audit log.",
+			order: 2,
+			completion: {
+				eventName: "audit_log.created",
+				sourceModule: "@lssm/module.audit-trail"
+			},
+			xpReward: 20,
+			metadata: { surface: "bus+audit" }
+		},
+		{
+			id: "notifications",
+			title: "Send a notification",
+			description: "Send yourself a notification and verify delivery.",
+			order: 3,
+			completion: {
+				eventName: "notification.sent",
+				sourceModule: "@lssm/module.notifications"
+			},
+			xpReward: 20,
+			metadata: { surface: "notifications" }
+		},
+		{
+			id: "jobs_scheduler",
+			title: "Schedule and run a job",
+			description: "Schedule a background job and let it run once.",
+			order: 4,
+			completion: {
+				eventName: "job.completed",
+				sourceModule: "@lssm/lib.jobs"
+			},
+			xpReward: 20,
+			metadata: { surface: "jobs" }
+		},
+		{
+			id: "feature_flags",
+			title: "Create and toggle a feature flag",
+			description: "Create a feature flag and toggle it at least once.",
+			order: 5,
+			completion: {
+				eventName: "flag.toggled",
+				sourceModule: "@lssm/lib.feature-flags"
+			},
+			xpReward: 20,
+			metadata: { surface: "feature-flags" }
+		},
+		{
+			id: "files_attachments",
+			title: "Attach a file",
+			description: "Upload and attach a file to any entity.",
+			order: 6,
+			completion: {
+				eventName: "attachment.attached",
+				sourceModule: "@lssm/lib.files"
+			},
+			xpReward: 20,
+			metadata: { surface: "files" }
+		},
+		{
+			id: "usage_metering",
+			title: "Record usage",
+			description: "Emit a usage metric (regeneration, agent run, or similar).",
+			order: 7,
+			completion: {
+				eventName: "usage.recorded",
+				sourceModule: "@lssm/lib.metering"
+			},
+			xpReward: 20,
+			metadata: { surface: "metering" }
+		}
+	],
+	metadata: { surfacedIn: ["studio/learning", "platform/dev-center"] }
+};
+const platformLearningTracks = [platformPrimitivesTourTrack];
+
+//#endregion
+export { platformLearningTracks };

package/dist/examples/learning-journey-quest-challenges/src/track.js

@@ -0,0 +1,35 @@
+//#region ../learning-journey-quest-challenges/src/track.ts
+const dayStep = (id, day, eventName, description) => ({
+	id,
+	title: `Day ${day}`,
+	description,
+	availability: { unlockOnDay: day },
+	completion: {
+		kind: "time_window",
+		eventName,
+		withinHoursOfStart: (day + 1) * 24
+	},
+	xpReward: 15,
+	metadata: { day }
+});
+const moneyResetQuestTrack = {
+	id: "money_reset_7day",
+	name: "7-day Money Reset",
+	description: "Time-bound quest to reset personal finances over a focused week.",
+	targetUserSegment: "money_user",
+	totalXp: 105,
+	completionRewards: { xpBonus: 30 },
+	steps: [
+		dayStep("day1_map_accounts", 1, "accounts.mapped", "Map bank and card accounts."),
+		dayStep("day2_categorize_transactions", 2, "transactions.categorized", "Categorize recent transactions."),
+		dayStep("day3_define_goals", 3, "goals.created", "Define at least one savings goal."),
+		dayStep("day4_setup_recurring_savings", 4, "recurring_rule.created", "Set a recurring savings rule."),
+		dayStep("day5_review_subscriptions", 5, "subscription.flagged_or_cancelled", "Review subscriptions and flag or cancel wasteful ones."),
+		dayStep("day6_plan_emergency", 6, "emergency_plan.completed", "Draft an emergency plan and target buffer."),
+		dayStep("day7_review_commit", 7, "quest.review.completed", "Review week outcomes and commit to the next month.")
+	]
+};
+const questTracks = [moneyResetQuestTrack];
+
+//#endregion
+export { questTracks };