@lssm/example.learning-journey-registry 0.0.0-canary-20251217083314 → 1.41.0

package/CHANGELOG.md

@@ -1,24 +0,0 @@
-# @lssm/example.learning-journey-registry
-
-## 0.0.0-canary-20251217083314
-
-### Minor Changes
-
-- 66a5dfd: initial release
-
-### Patch Changes
-
-- Updated dependencies [66a5dfd]
-  - @lssm/example.learning-journey-ambient-coach@0.0.0-canary-20251217083314
-  - @lssm/example.learning-journey-crm-onboarding@0.0.0-canary-20251217083314
-  - @lssm/example.learning-journey-duo-drills@0.0.0-canary-20251217083314
-  - @lssm/example.learning-journey-platform-tour@0.0.0-canary-20251217083314
-  - @lssm/example.learning-journey-quest-challenges@0.0.0-canary-20251217083314
-  - @lssm/example.learning-journey-studio-onboarding@0.0.0-canary-20251217083314
-  - @lssm/example.learning-journey-ui-coaching@0.0.0-canary-20251217083314
-  - @lssm/example.learning-journey-ui-gamified@0.0.0-canary-20251217083314
-  - @lssm/example.learning-journey-ui-onboarding@0.0.0-canary-20251217083314
-  - @lssm/example.learning-journey-ui-shared@0.0.0-canary-20251217083314
-  - @lssm/lib.contracts@0.0.0-canary-20251217083314
-  - @lssm/lib.schema@0.0.0-canary-20251217083314
-  - @lssm/module.learning-journey@0.0.0-canary-20251217083314

package/dist/api-types.d.ts

@@ -1,40 +0,0 @@
-import { LearningJourneyTrackSpec } from "@lssm/module.learning-journey/track-spec";
-
-//#region src/api-types.d.ts
-interface LearningEvent {
-  name: string;
-  version?: number;
-  sourceModule?: string;
-  payload?: Record<string, unknown>;
-  occurredAt?: Date;
-  learnerId: string;
-  trackId?: string;
-}
-type StepStatus = 'PENDING' | 'COMPLETED';
-interface StepProgress {
-  id: string;
-  status: StepStatus;
-  xpEarned: number;
-  completedAt?: Date;
-  triggeringEvent?: string;
-  eventPayload?: Record<string, unknown>;
-  occurrences?: number;
-  counterStartedAt?: Date;
-  availableAt?: Date;
-  dueAt?: Date;
-  masteryCount?: number;
-}
-interface TrackProgress {
-  learnerId: string;
-  trackId: string;
-  progress: number;
-  isCompleted: boolean;
-  xpEarned: number;
-  startedAt?: Date;
-  completedAt?: Date;
-  lastActivityAt?: Date;
-  steps: StepProgress[];
-}
-type TrackResolver = (trackId: string) => LearningJourneyTrackSpec | undefined;
-//#endregion
-export { LearningEvent, StepProgress, StepStatus, TrackProgress, TrackResolver };

package/dist/api.d.ts

@@ -1,12 +0,0 @@
-import { LearningEvent, TrackProgress } from "./api-types.js";
-import { LearningJourneyTrackSpec } from "@lssm/module.learning-journey/track-spec";
-
-//#region src/api.d.ts
-declare const listTracks: (learnerId?: string) => {
-  tracks: LearningJourneyTrackSpec[];
-  progress: TrackProgress[];
-};
-declare const getProgress: (trackId: string, learnerId: string) => TrackProgress | undefined;
-declare const recordEvent: (event: LearningEvent) => TrackProgress[];
-//#endregion
-export { getProgress, listTracks, recordEvent };

package/dist/docs/index.d.ts

@@ -1 +0,0 @@
-export { };

package/dist/docs/learning-journey-registry.docblock.d.ts

@@ -1 +0,0 @@
-export { };

package/dist/example.d.ts

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

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

@@ -1,41 +0,0 @@
-//#region ../learning-journey-ambient-coach/dist/track.js
-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

@@ -1,98 +0,0 @@
-//#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/dist/track.js

@@ -1,65 +0,0 @@
-//#region ../learning-journey-duo-drills/dist/track.js
-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

@@ -1,105 +0,0 @@
-//#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/dist/track.js

@@ -1,35 +0,0 @@
-//#region ../learning-journey-quest-challenges/dist/track.js
-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 };

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

@@ -1,90 +0,0 @@
-//#region ../learning-journey-studio-onboarding/dist/track.js
-const studioGettingStartedTrack = {
-	id: "studio_getting_started",
-	productId: "contractspec-studio",
-	name: "Studio Getting Started",
-	description: "First 30 minutes in Studio: create a project, edit the spec, deploy/regenerate, and try key modules.",
-	targetUserSegment: "new_studio_user",
-	targetRole: "developer",
-	totalXp: 110,
-	streakRule: {
-		hoursWindow: 48,
-		bonusXp: 25
-	},
-	completionRewards: {
-		xpBonus: 25,
-		badgeKey: "studio_first_30m"
-	},
-	steps: [
-		{
-			id: "choose_template",
-			title: "Choose a template",
-			description: "Create your first Studio project (starter template).",
-			order: 1,
-			completion: {
-				eventName: "studio.template.instantiated",
-				sourceModule: "@lssm/bundle.contractspec-studio"
-			},
-			xpReward: 20,
-			metadata: { surface: "projects" }
-		},
-		{
-			id: "edit_spec",
-			title: "Edit the spec",
-			description: "Change the spec (not generated code) and save.",
-			instructions: "Open spec editor, tweak a contract or presentation, save.",
-			order: 2,
-			completion: {
-				eventName: "spec.changed",
-				sourceModule: "@lssm/bundle.contractspec-studio"
-			},
-			xpReward: 20,
-			metadata: { surface: "spec-editor" }
-		},
-		{
-			id: "regenerate_app",
-			title: "Regenerate the app",
-			description: "Regenerate artifacts from the updated spec.",
-			order: 3,
-			completion: {
-				eventName: "regeneration.completed",
-				sourceModule: "@lssm/lib.contracts/regenerator"
-			},
-			xpReward: 20,
-			metadata: { surface: "regenerator" }
-		},
-		{
-			id: "open_canvas",
-			title: "Open the canvas",
-			description: "Visit the canvas module for your project.",
-			order: 4,
-			completion: {
-				eventName: "module.navigated",
-				sourceModule: "@lssm/bundle.contractspec-studio",
-				payloadFilter: { moduleId: "canvas" }
-			},
-			xpReward: 20,
-			metadata: { surface: "canvas" }
-		},
-		{
-			id: "try_evolution_mode",
-			title: "Try evolution mode",
-			description: "Request a change via Evolution, then regenerate.",
-			order: 5,
-			completion: {
-				eventName: "studio.evolution.applied",
-				sourceModule: "@lssm/lib.evolution"
-			},
-			xpReward: 30,
-			metadata: { surface: "evolution" }
-		}
-	],
-	metadata: {
-		persona: "first_run",
-		surfacedIn: ["studio/home", "studio/sidebar/learning"]
-	}
-};
-const studioLearningTracks = [studioGettingStartedTrack];
-
-//#endregion
-export { studioLearningTracks };

package/dist/examples/learning-journey-ui-coaching/dist/CoachingMiniApp.js

@@ -1,64 +0,0 @@
-'use client';
-
-import { Card, CardContent } from "./libs/ui-kit-web/dist/ui/card.js";
-import { useLearningProgress } from "./examples/learning-journey-ui-shared/dist/hooks/useLearningProgress.js";
-import { ViewTabs } from "./examples/learning-journey-ui-shared/dist/components/ViewTabs.js";
-import "./examples/learning-journey-ui-shared/dist/index.js";
-import { Overview } from "./views/Overview.js";
-import { Steps } from "./views/Steps.js";
-import { ProgressView } from "./views/Progress.js";
-import { Timeline } from "./views/Timeline.js";
-import { useCallback, useState } from "react";
-import { jsx, jsxs } from "react/jsx-runtime";
-
-//#region ../learning-journey-ui-coaching/dist/CoachingMiniApp.js
-function CoachingMiniApp({ track, progress: externalProgress, onStepComplete: externalOnStepComplete, onViewChange, initialView = "overview" }) {
-	const [currentView, setCurrentView] = useState(initialView);
-	const { progress: internalProgress, completeStep: internalCompleteStep } = useLearningProgress(track);
-	const progress = externalProgress ?? internalProgress;
-	const handleViewChange = useCallback((view) => {
-		setCurrentView(view);
-		onViewChange?.(view);
-	}, [onViewChange]);
-	const handleStepComplete = useCallback((stepId) => {
-		if (externalOnStepComplete) externalOnStepComplete(stepId);
-		else internalCompleteStep(stepId);
-	}, [externalOnStepComplete, internalCompleteStep]);
-	const handleStartFromOverview = useCallback(() => {
-		setCurrentView("steps");
-		onViewChange?.("steps");
-	}, [onViewChange]);
-	const renderView = () => {
-		const viewProps = {
-			track,
-			progress,
-			onStepComplete: handleStepComplete
-		};
-		switch (currentView) {
-			case "overview": return /* @__PURE__ */ jsx(Overview, {
-				...viewProps,
-				onStart: handleStartFromOverview
-			});
-			case "steps": return /* @__PURE__ */ jsx(Steps, { ...viewProps });
-			case "progress": return /* @__PURE__ */ jsx(ProgressView, { ...viewProps });
-			case "timeline": return /* @__PURE__ */ jsx(Timeline, { ...viewProps });
-			default: return /* @__PURE__ */ jsx(Overview, {
-				...viewProps,
-				onStart: handleStartFromOverview
-			});
-		}
-	};
-	return /* @__PURE__ */ jsxs("div", {
-		className: "space-y-6",
-		children: [/* @__PURE__ */ jsx(Card, { children: /* @__PURE__ */ jsx(CardContent, {
-			className: "p-4",
-			children: /* @__PURE__ */ jsx(ViewTabs, {
-				currentView,
-				onViewChange: handleViewChange
-			})
-		}) }), renderView()]
-	});
-}
-
-//#endregion
-export { CoachingMiniApp };