@lssm/module.learning-journey 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217073102

package/dist/contracts/operations.d.ts

@@ -1,138 +1,138 @@
-import * as _lssm_lib_schema557 from "@lssm/lib.schema";
+import * as _lssm_lib_schema1372 from "@lssm/lib.schema";
 import * as _lssm_lib_contracts31 from "@lssm/lib.contracts";
 
 //#region src/contracts/operations.d.ts
 /**
  * Enroll in a course.
  */
-declare const EnrollInCourseContract: _lssm_lib_contracts31.ContractSpec<_lssm_lib_schema557.SchemaModel<{
+declare const EnrollInCourseContract: _lssm_lib_contracts31.ContractSpec<_lssm_lib_schema1372.SchemaModel<{
   courseId: {
-    type: _lssm_lib_schema557.FieldType<string, string>;
+    type: _lssm_lib_schema1372.FieldType<string, string>;
     isOptional: false;
   };
-}>, _lssm_lib_schema557.SchemaModel<{
+}>, _lssm_lib_schema1372.SchemaModel<{
   id: {
-    type: _lssm_lib_schema557.FieldType<string, string>;
+    type: _lssm_lib_schema1372.FieldType<string, string>;
     isOptional: false;
   };
   learnerId: {
-    type: _lssm_lib_schema557.FieldType<string, string>;
+    type: _lssm_lib_schema1372.FieldType<string, string>;
     isOptional: false;
   };
   courseId: {
-    type: _lssm_lib_schema557.FieldType<string, string>;
+    type: _lssm_lib_schema1372.FieldType<string, string>;
     isOptional: false;
   };
   status: {
-    type: _lssm_lib_schema557.FieldType<string, string>;
+    type: _lssm_lib_schema1372.FieldType<string, string>;
     isOptional: false;
   };
   progress: {
-    type: _lssm_lib_schema557.FieldType<number, number>;
+    type: _lssm_lib_schema1372.FieldType<number, number>;
     isOptional: false;
   };
   startedAt: {
-    type: _lssm_lib_schema557.FieldType<Date, string>;
+    type: _lssm_lib_schema1372.FieldType<Date, string>;
     isOptional: true;
   };
   completedAt: {
-    type: _lssm_lib_schema557.FieldType<Date, string>;
+    type: _lssm_lib_schema1372.FieldType<Date, string>;
     isOptional: true;
   };
 }>, undefined>;
 /**
  * Complete a lesson.
  */
-declare const CompleteLessonContract: _lssm_lib_contracts31.ContractSpec<_lssm_lib_schema557.SchemaModel<{
+declare const CompleteLessonContract: _lssm_lib_contracts31.ContractSpec<_lssm_lib_schema1372.SchemaModel<{
   lessonId: {
-    type: _lssm_lib_schema557.FieldType<string, string>;
+    type: _lssm_lib_schema1372.FieldType<string, string>;
     isOptional: false;
   };
   score: {
-    type: _lssm_lib_schema557.FieldType<number, number>;
+    type: _lssm_lib_schema1372.FieldType<number, number>;
     isOptional: true;
   };
   timeSpent: {
-    type: _lssm_lib_schema557.FieldType<number, number>;
+    type: _lssm_lib_schema1372.FieldType<number, number>;
     isOptional: false;
   };
-}>, _lssm_lib_schema557.SchemaModel<{
+}>, _lssm_lib_schema1372.SchemaModel<{
   success: {
-    type: _lssm_lib_schema557.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema1372.FieldType<boolean, boolean>;
     isOptional: false;
   };
   xpEarned: {
-    type: _lssm_lib_schema557.FieldType<number, number>;
+    type: _lssm_lib_schema1372.FieldType<number, number>;
     isOptional: true;
   };
 }>, undefined>;
 /**
  * Submit a card review.
  */
-declare const SubmitCardReviewContract: _lssm_lib_contracts31.ContractSpec<_lssm_lib_schema557.SchemaModel<{
+declare const SubmitCardReviewContract: _lssm_lib_contracts31.ContractSpec<_lssm_lib_schema1372.SchemaModel<{
   cardId: {
-    type: _lssm_lib_schema557.FieldType<string, string>;
+    type: _lssm_lib_schema1372.FieldType<string, string>;
     isOptional: false;
   };
   rating: {
-    type: _lssm_lib_schema557.FieldType<string, string>;
+    type: _lssm_lib_schema1372.FieldType<string, string>;
     isOptional: false;
   };
   responseTimeMs: {
-    type: _lssm_lib_schema557.FieldType<number, number>;
+    type: _lssm_lib_schema1372.FieldType<number, number>;
     isOptional: true;
   };
-}>, _lssm_lib_schema557.SchemaModel<{
+}>, _lssm_lib_schema1372.SchemaModel<{
   success: {
-    type: _lssm_lib_schema557.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema1372.FieldType<boolean, boolean>;
     isOptional: false;
   };
   xpEarned: {
-    type: _lssm_lib_schema557.FieldType<number, number>;
+    type: _lssm_lib_schema1372.FieldType<number, number>;
     isOptional: true;
   };
 }>, undefined>;
 /**
  * Get cards due for review.
  */
-declare const GetDueCardsContract: _lssm_lib_contracts31.ContractSpec<_lssm_lib_schema557.SchemaModel<{
+declare const GetDueCardsContract: _lssm_lib_contracts31.ContractSpec<_lssm_lib_schema1372.SchemaModel<{
   deckId: {
-    type: _lssm_lib_schema557.FieldType<string, string>;
+    type: _lssm_lib_schema1372.FieldType<string, string>;
     isOptional: true;
   };
   limit: {
-    type: _lssm_lib_schema557.FieldType<number, number>;
+    type: _lssm_lib_schema1372.FieldType<number, number>;
     isOptional: true;
   };
-}>, _lssm_lib_schema557.SchemaModel<{
+}>, _lssm_lib_schema1372.SchemaModel<{
   cards: {
-    type: _lssm_lib_schema557.SchemaModel<{
+    type: _lssm_lib_schema1372.SchemaModel<{
       id: {
-        type: _lssm_lib_schema557.FieldType<string, string>;
+        type: _lssm_lib_schema1372.FieldType<string, string>;
         isOptional: false;
       };
       deckId: {
-        type: _lssm_lib_schema557.FieldType<string, string>;
+        type: _lssm_lib_schema1372.FieldType<string, string>;
         isOptional: false;
       };
       front: {
-        type: _lssm_lib_schema557.FieldType<string, string>;
+        type: _lssm_lib_schema1372.FieldType<string, string>;
         isOptional: false;
       };
       back: {
-        type: _lssm_lib_schema557.FieldType<string, string>;
+        type: _lssm_lib_schema1372.FieldType<string, string>;
         isOptional: false;
       };
       hints: {
-        type: _lssm_lib_schema557.FieldType<unknown, unknown>;
+        type: _lssm_lib_schema1372.FieldType<unknown, unknown>;
         isOptional: true;
       };
       isDue: {
-        type: _lssm_lib_schema557.FieldType<boolean, boolean>;
+        type: _lssm_lib_schema1372.FieldType<boolean, boolean>;
         isOptional: false;
       };
       nextReviewAt: {
-        type: _lssm_lib_schema557.FieldType<Date, string>;
+        type: _lssm_lib_schema1372.FieldType<Date, string>;
         isOptional: true;
       };
     }>;
@@ -140,96 +140,96 @@ declare const GetDueCardsContract: _lssm_lib_contracts31.ContractSpec<_lssm_lib_
     isOptional: false;
   };
   total: {
-    type: _lssm_lib_schema557.FieldType<number, number>;
+    type: _lssm_lib_schema1372.FieldType<number, number>;
     isOptional: false;
   };
 }>, undefined>;
 /**
  * Get learner dashboard.
  */
-declare const GetLearnerDashboardContract: _lssm_lib_contracts31.ContractSpec<_lssm_lib_schema557.SchemaModel<{
+declare const GetLearnerDashboardContract: _lssm_lib_contracts31.ContractSpec<_lssm_lib_schema1372.SchemaModel<{
   learnerId: {
-    type: _lssm_lib_schema557.FieldType<string, string>;
+    type: _lssm_lib_schema1372.FieldType<string, string>;
     isOptional: true;
   };
-}>, _lssm_lib_schema557.SchemaModel<{
+}>, _lssm_lib_schema1372.SchemaModel<{
   learner: {
-    type: _lssm_lib_schema557.SchemaModel<{
+    type: _lssm_lib_schema1372.SchemaModel<{
       id: {
-        type: _lssm_lib_schema557.FieldType<string, string>;
+        type: _lssm_lib_schema1372.FieldType<string, string>;
         isOptional: false;
       };
       userId: {
-        type: _lssm_lib_schema557.FieldType<string, string>;
+        type: _lssm_lib_schema1372.FieldType<string, string>;
         isOptional: false;
       };
       displayName: {
-        type: _lssm_lib_schema557.FieldType<string, string>;
+        type: _lssm_lib_schema1372.FieldType<string, string>;
         isOptional: true;
       };
       level: {
-        type: _lssm_lib_schema557.FieldType<number, number>;
+        type: _lssm_lib_schema1372.FieldType<number, number>;
         isOptional: false;
       };
       totalXp: {
-        type: _lssm_lib_schema557.FieldType<number, number>;
+        type: _lssm_lib_schema1372.FieldType<number, number>;
         isOptional: false;
       };
       currentStreak: {
-        type: _lssm_lib_schema557.FieldType<number, number>;
+        type: _lssm_lib_schema1372.FieldType<number, number>;
         isOptional: false;
       };
       longestStreak: {
-        type: _lssm_lib_schema557.FieldType<number, number>;
+        type: _lssm_lib_schema1372.FieldType<number, number>;
         isOptional: false;
       };
       createdAt: {
-        type: _lssm_lib_schema557.FieldType<Date, string>;
+        type: _lssm_lib_schema1372.FieldType<Date, string>;
         isOptional: false;
       };
     }>;
     isOptional: false;
   };
   currentStreak: {
-    type: _lssm_lib_schema557.FieldType<number, number>;
+    type: _lssm_lib_schema1372.FieldType<number, number>;
     isOptional: false;
   };
   dailyXpGoal: {
-    type: _lssm_lib_schema557.FieldType<number, number>;
+    type: _lssm_lib_schema1372.FieldType<number, number>;
     isOptional: false;
   };
   dailyXpProgress: {
-    type: _lssm_lib_schema557.FieldType<number, number>;
+    type: _lssm_lib_schema1372.FieldType<number, number>;
     isOptional: false;
   };
   activeEnrollments: {
-    type: _lssm_lib_schema557.SchemaModel<{
+    type: _lssm_lib_schema1372.SchemaModel<{
       id: {
-        type: _lssm_lib_schema557.FieldType<string, string>;
+        type: _lssm_lib_schema1372.FieldType<string, string>;
         isOptional: false;
       };
       learnerId: {
-        type: _lssm_lib_schema557.FieldType<string, string>;
+        type: _lssm_lib_schema1372.FieldType<string, string>;
         isOptional: false;
       };
       courseId: {
-        type: _lssm_lib_schema557.FieldType<string, string>;
+        type: _lssm_lib_schema1372.FieldType<string, string>;
         isOptional: false;
       };
       status: {
-        type: _lssm_lib_schema557.FieldType<string, string>;
+        type: _lssm_lib_schema1372.FieldType<string, string>;
         isOptional: false;
       };
       progress: {
-        type: _lssm_lib_schema557.FieldType<number, number>;
+        type: _lssm_lib_schema1372.FieldType<number, number>;
         isOptional: false;
       };
       startedAt: {
-        type: _lssm_lib_schema557.FieldType<Date, string>;
+        type: _lssm_lib_schema1372.FieldType<Date, string>;
         isOptional: true;
       };
       completedAt: {
-        type: _lssm_lib_schema557.FieldType<Date, string>;
+        type: _lssm_lib_schema1372.FieldType<Date, string>;
         isOptional: true;
       };
     }>;
@@ -237,33 +237,33 @@ declare const GetLearnerDashboardContract: _lssm_lib_contracts31.ContractSpec<_l
     isOptional: false;
   };
   recentAchievements: {
-    type: _lssm_lib_schema557.SchemaModel<{
+    type: _lssm_lib_schema1372.SchemaModel<{
       id: {
-        type: _lssm_lib_schema557.FieldType<string, string>;
+        type: _lssm_lib_schema1372.FieldType<string, string>;
         isOptional: false;
       };
       key: {
-        type: _lssm_lib_schema557.FieldType<string, string>;
+        type: _lssm_lib_schema1372.FieldType<string, string>;
         isOptional: false;
       };
       name: {
-        type: _lssm_lib_schema557.FieldType<string, string>;
+        type: _lssm_lib_schema1372.FieldType<string, string>;
         isOptional: false;
       };
       description: {
-        type: _lssm_lib_schema557.FieldType<string, string>;
+        type: _lssm_lib_schema1372.FieldType<string, string>;
         isOptional: false;
       };
       icon: {
-        type: _lssm_lib_schema557.FieldType<string, string>;
+        type: _lssm_lib_schema1372.FieldType<string, string>;
         isOptional: true;
       };
       xpReward: {
-        type: _lssm_lib_schema557.FieldType<number, number>;
+        type: _lssm_lib_schema1372.FieldType<number, number>;
         isOptional: false;
       };
       unlockedAt: {
-        type: _lssm_lib_schema557.FieldType<Date, string>;
+        type: _lssm_lib_schema1372.FieldType<Date, string>;
         isOptional: true;
       };
     }>;
@@ -271,7 +271,7 @@ declare const GetLearnerDashboardContract: _lssm_lib_contracts31.ContractSpec<_l
     isOptional: false;
   };
   dueCardCount: {
-    type: _lssm_lib_schema557.FieldType<number, number>;
+    type: _lssm_lib_schema1372.FieldType<number, number>;
     isOptional: false;
   };
 }>, undefined>;

package/dist/contracts/operations.js

@@ -1 +1,151 @@
-import{n as e,t}from"../libs/contracts/dist/spec.js";import"../libs/contracts/dist/index.js";import{LEARNING_JOURNEY_OWNERS as n}from"./shared.js";import{CompleteLessonInput as r,EnrollInCourseInput as i,EnrollmentModel as a,GetDueCardsInput as o,GetDueCardsOutput as s,GetLearnerDashboardInput as c,LearnerDashboardModel as l,SubmitCardReviewInput as u,SuccessOutput as d}from"./models.js";const f=t({meta:{name:`learning.enroll`,version:1,stability:`stable`,owners:[...n],tags:[`learning`,`enrollment`],description:`Enroll in a course.`,goal:`Start learning a new course.`,context:`Called when a learner wants to start a course.`},io:{input:i,output:a,errors:{COURSE_NOT_FOUND:{description:`Course does not exist`,http:404,gqlCode:`COURSE_NOT_FOUND`,when:`Course ID is invalid`},ALREADY_ENROLLED:{description:`Already enrolled in course`,http:409,gqlCode:`ALREADY_ENROLLED`,when:`Learner is already enrolled`}}},policy:{auth:`user`}}),p=t({meta:{name:`learning.completeLesson`,version:1,stability:`stable`,owners:[...n],tags:[`learning`,`progress`],description:`Mark a lesson as completed.`,goal:`Record lesson completion and earn XP.`,context:`Called when a learner finishes a lesson.`},io:{input:r,output:d,errors:{LESSON_NOT_FOUND:{description:`Lesson does not exist`,http:404,gqlCode:`LESSON_NOT_FOUND`,when:`Lesson ID is invalid`},NOT_ENROLLED:{description:`Not enrolled in course`,http:403,gqlCode:`NOT_ENROLLED`,when:`Learner is not enrolled in the course`}}},policy:{auth:`user`}}),m=t({meta:{name:`learning.submitCardReview`,version:1,stability:`stable`,owners:[...n],tags:[`learning`,`flashcards`],description:`Submit a flashcard review.`,goal:`Record review and update SRS schedule.`,context:`Called when reviewing flashcards.`},io:{input:u,output:d,errors:{CARD_NOT_FOUND:{description:`Card does not exist`,http:404,gqlCode:`CARD_NOT_FOUND`,when:`Card ID is invalid`},INVALID_RATING:{description:`Invalid rating`,http:400,gqlCode:`INVALID_RATING`,when:`Rating must be AGAIN, HARD, GOOD, or EASY`}}},policy:{auth:`user`}}),h=e({meta:{name:`learning.getDueCards`,version:1,stability:`stable`,owners:[...n],tags:[`learning`,`flashcards`],description:`Get flashcards due for review.`,goal:`Get the next batch of cards to review.`,context:`Called when starting a review session.`},io:{input:o,output:s},policy:{auth:`user`}}),g=e({meta:{name:`learning.getDashboard`,version:1,stability:`stable`,owners:[...n],tags:[`learning`,`dashboard`],description:`Get learner dashboard data.`,goal:`Display learner progress and stats.`,context:`Called when viewing the learning dashboard.`},io:{input:c,output:l},policy:{auth:`user`}});export{p as CompleteLessonContract,f as EnrollInCourseContract,h as GetDueCardsContract,g as GetLearnerDashboardContract,m as SubmitCardReviewContract};
+import { defineCommand, defineQuery } from "../libs/contracts/dist/spec.js";
+import "../libs/contracts/dist/index.js";
+import { LEARNING_JOURNEY_OWNERS } from "./shared.js";
+import { CompleteLessonInput, EnrollInCourseInput, EnrollmentModel, GetDueCardsInput, GetDueCardsOutput, GetLearnerDashboardInput, LearnerDashboardModel, SubmitCardReviewInput, SuccessOutput } from "./models.js";
+
+//#region src/contracts/operations.ts
+/**
+* Enroll in a course.
+*/
+const EnrollInCourseContract = defineCommand({
+	meta: {
+		name: "learning.enroll",
+		version: 1,
+		stability: "stable",
+		owners: [...LEARNING_JOURNEY_OWNERS],
+		tags: ["learning", "enrollment"],
+		description: "Enroll in a course.",
+		goal: "Start learning a new course.",
+		context: "Called when a learner wants to start a course."
+	},
+	io: {
+		input: EnrollInCourseInput,
+		output: EnrollmentModel,
+		errors: {
+			COURSE_NOT_FOUND: {
+				description: "Course does not exist",
+				http: 404,
+				gqlCode: "COURSE_NOT_FOUND",
+				when: "Course ID is invalid"
+			},
+			ALREADY_ENROLLED: {
+				description: "Already enrolled in course",
+				http: 409,
+				gqlCode: "ALREADY_ENROLLED",
+				when: "Learner is already enrolled"
+			}
+		}
+	},
+	policy: { auth: "user" }
+});
+/**
+* Complete a lesson.
+*/
+const CompleteLessonContract = defineCommand({
+	meta: {
+		name: "learning.completeLesson",
+		version: 1,
+		stability: "stable",
+		owners: [...LEARNING_JOURNEY_OWNERS],
+		tags: ["learning", "progress"],
+		description: "Mark a lesson as completed.",
+		goal: "Record lesson completion and earn XP.",
+		context: "Called when a learner finishes a lesson."
+	},
+	io: {
+		input: CompleteLessonInput,
+		output: SuccessOutput,
+		errors: {
+			LESSON_NOT_FOUND: {
+				description: "Lesson does not exist",
+				http: 404,
+				gqlCode: "LESSON_NOT_FOUND",
+				when: "Lesson ID is invalid"
+			},
+			NOT_ENROLLED: {
+				description: "Not enrolled in course",
+				http: 403,
+				gqlCode: "NOT_ENROLLED",
+				when: "Learner is not enrolled in the course"
+			}
+		}
+	},
+	policy: { auth: "user" }
+});
+/**
+* Submit a card review.
+*/
+const SubmitCardReviewContract = defineCommand({
+	meta: {
+		name: "learning.submitCardReview",
+		version: 1,
+		stability: "stable",
+		owners: [...LEARNING_JOURNEY_OWNERS],
+		tags: ["learning", "flashcards"],
+		description: "Submit a flashcard review.",
+		goal: "Record review and update SRS schedule.",
+		context: "Called when reviewing flashcards."
+	},
+	io: {
+		input: SubmitCardReviewInput,
+		output: SuccessOutput,
+		errors: {
+			CARD_NOT_FOUND: {
+				description: "Card does not exist",
+				http: 404,
+				gqlCode: "CARD_NOT_FOUND",
+				when: "Card ID is invalid"
+			},
+			INVALID_RATING: {
+				description: "Invalid rating",
+				http: 400,
+				gqlCode: "INVALID_RATING",
+				when: "Rating must be AGAIN, HARD, GOOD, or EASY"
+			}
+		}
+	},
+	policy: { auth: "user" }
+});
+/**
+* Get cards due for review.
+*/
+const GetDueCardsContract = defineQuery({
+	meta: {
+		name: "learning.getDueCards",
+		version: 1,
+		stability: "stable",
+		owners: [...LEARNING_JOURNEY_OWNERS],
+		tags: ["learning", "flashcards"],
+		description: "Get flashcards due for review.",
+		goal: "Get the next batch of cards to review.",
+		context: "Called when starting a review session."
+	},
+	io: {
+		input: GetDueCardsInput,
+		output: GetDueCardsOutput
+	},
+	policy: { auth: "user" }
+});
+/**
+* Get learner dashboard.
+*/
+const GetLearnerDashboardContract = defineQuery({
+	meta: {
+		name: "learning.getDashboard",
+		version: 1,
+		stability: "stable",
+		owners: [...LEARNING_JOURNEY_OWNERS],
+		tags: ["learning", "dashboard"],
+		description: "Get learner dashboard data.",
+		goal: "Display learner progress and stats.",
+		context: "Called when viewing the learning dashboard."
+	},
+	io: {
+		input: GetLearnerDashboardInput,
+		output: LearnerDashboardModel
+	},
+	policy: { auth: "user" }
+});
+
+//#endregion
+export { CompleteLessonContract, EnrollInCourseContract, GetDueCardsContract, GetLearnerDashboardContract, SubmitCardReviewContract };

package/dist/contracts/shared.js

@@ -1 +1,5 @@
-const e=[`modules.learning-journey`];export{e as LEARNING_JOURNEY_OWNERS};
+//#region src/contracts/shared.ts
+const LEARNING_JOURNEY_OWNERS = ["modules.learning-journey"];
+
+//#endregion
+export { LEARNING_JOURNEY_OWNERS };

package/dist/docs/index.js

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

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

@@ -1,4 +1,22 @@
-import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contracts/dist/docs/index.js";e([{id:`docs.learning-journey.engine`,title:`Learning Journey Engine`,summary:`Tracks learners, tracks/modules/steps, progress, quizzes, streaks, XP, and AI coaching hooks for product-integrated onboarding.`,kind:`reference`,visibility:`public`,route:`/docs/learning-journey/engine`,tags:[`learning`,`onboarding`,`journey`,`education`],body:`## Capabilities
+import { registerDocBlocks } from "../libs/contracts/dist/docs/registry.js";
+import "../libs/contracts/dist/docs/index.js";
+
+//#region src/docs/learning-journey.docblock.ts
+registerDocBlocks([
+	{
+		id: "docs.learning-journey.engine",
+		title: "Learning Journey Engine",
+		summary: "Tracks learners, tracks/modules/steps, progress, quizzes, streaks, XP, and AI coaching hooks for product-integrated onboarding.",
+		kind: "reference",
+		visibility: "public",
+		route: "/docs/learning-journey/engine",
+		tags: [
+			"learning",
+			"onboarding",
+			"journey",
+			"education"
+		],
+		body: `## Capabilities
 
 - **Entities**: Learner, Track, Module, Step, Progress, Quiz, Flashcard, AI Coach, Gamification (XP, streaks, badges).
 - **Contracts**: enroll/resume/advance steps, complete quizzes, record streaks, assign XP, fetch progress dashboards, onboarding list/progress/recordEvent.
@@ -42,7 +60,17 @@ const updated = streak.compute({ lastActiveAt: new Date(), today: new Date() });
 - Avoid storing PII in content; keep org/user scoping for multi-tenant isolation.
 - Emit analytics and audit logs for completions; respect \`prefers-reduced-motion\` in UIs consuming these specs.
 - Track completion bonuses: \`completionXpBonus\`, \`completionBadgeKey\`, optional \`streakHoursWindow\` + \`streakBonusXp\`.
-`},{id:`docs.learning-journey.goal`,title:`Learning Journey — Goal`,summary:`Why the learning journey engine exists and the outcomes it targets.`,kind:`goal`,visibility:`public`,route:`/docs/learning-journey/goal`,tags:[`learning`,`goal`],body:`## Why it matters
+`
+	},
+	{
+		id: "docs.learning-journey.goal",
+		title: "Learning Journey — Goal",
+		summary: "Why the learning journey engine exists and the outcomes it targets.",
+		kind: "goal",
+		visibility: "public",
+		route: "/docs/learning-journey/goal",
+		tags: ["learning", "goal"],
+		body: `## Why it matters
 - Provides a regenerable onboarding/education engine tied to product signals.
 - Keeps tracks, steps, quizzes, and gamification consistent across surfaces.
 
@@ -52,7 +80,17 @@ const updated = streak.compute({ lastActiveAt: new Date(), today: new Date() });
 
 ## Success criteria
 - Journey changes regenerate UI/API/events without drift.
-- Analytics/audit hooks exist for completions and streaks.`},{id:`docs.learning-journey.usage`,title:`Learning Journey — Usage`,summary:`How to compose, bind, and regenerate journeys safely.`,kind:`usage`,visibility:`public`,route:`/docs/learning-journey/usage`,tags:[`learning`,`usage`],body:`## Setup
+- Analytics/audit hooks exist for completions and streaks.`
+	},
+	{
+		id: "docs.learning-journey.usage",
+		title: "Learning Journey — Usage",
+		summary: "How to compose, bind, and regenerate journeys safely.",
+		kind: "usage",
+		visibility: "public",
+		route: "/docs/learning-journey/usage",
+		tags: ["learning", "usage"],
+		body: `## Setup
 1) Include \`learningJourneyEntities\` in schema composition.
 2) Register contracts/events from \`@lssm/module.learning-journey\`.
 3) Bind steps to real product events (e.g., deal.created, run.completed).
@@ -65,7 +103,21 @@ const updated = streak.compute({ lastActiveAt: new Date(), today: new Date() });
 ## Guardrails
 - Avoid hardcoded progression; keep engines declarative.
 - Emit analytics/audit for completions; respect user locale/accessibility in presentations.
-- Keep content free of PII; scope learners by org/tenant.`},{id:`docs.learning-journey.constraints`,title:`Learning Journey — Constraints & Safety`,summary:`Internal guardrails for progression, telemetry, and regeneration semantics.`,kind:`reference`,visibility:`internal`,route:`/docs/learning-journey/constraints`,tags:[`learning`,`constraints`,`internal`],body:`## Constraints
+- Keep content free of PII; scope learners by org/tenant.`
+	},
+	{
+		id: "docs.learning-journey.constraints",
+		title: "Learning Journey — Constraints & Safety",
+		summary: "Internal guardrails for progression, telemetry, and regeneration semantics.",
+		kind: "reference",
+		visibility: "internal",
+		route: "/docs/learning-journey/constraints",
+		tags: [
+			"learning",
+			"constraints",
+			"internal"
+		],
+		body: `## Constraints
 - Progression (tracks/modules/steps) and engines (SRS, streaks, XP) must stay declarative in spec.
 - Events to emit: learner.enrolled, step.completed, quiz.scored, streak.reset, xp.awarded.
 - Regeneration should not change scoring/streak rules without explicit spec change.
@@ -77,4 +129,8 @@ const updated = streak.compute({ lastActiveAt: new Date(), today: new Date() });
 ## Verification
 - Add fixtures for streak/XP rule changes and quiz scoring.
 - Ensure Notifications/Audit wiring persists for completions; analytics emitted for progress.
-- Use Feature Flags to trial new tracks or reward rules; default safe/off.`}]);
+- Use Feature Flags to trial new tracks or reward rules; default safe/off.`
+	}
+]);
+
+//#endregion

package/dist/engines/index.js

@@ -1 +1,5 @@
-import{DEFAULT_SRS_CONFIG as e,SRSEngine as t,srsEngine as n}from"./srs.js";import{DEFAULT_XP_CONFIG as r,XPEngine as i,xpEngine as a}from"./xp.js";import{DEFAULT_STREAK_CONFIG as o,StreakEngine as s,streakEngine as c}from"./streak.js";export{e as DEFAULT_SRS_CONFIG,o as DEFAULT_STREAK_CONFIG,r as DEFAULT_XP_CONFIG,t as SRSEngine,s as StreakEngine,i as XPEngine,n as srsEngine,c as streakEngine,a as xpEngine};
+import { DEFAULT_SRS_CONFIG, SRSEngine, srsEngine } from "./srs.js";
+import { DEFAULT_XP_CONFIG, XPEngine, xpEngine } from "./xp.js";
+import { DEFAULT_STREAK_CONFIG, StreakEngine, streakEngine } from "./streak.js";
+
+export { DEFAULT_SRS_CONFIG, DEFAULT_STREAK_CONFIG, DEFAULT_XP_CONFIG, SRSEngine, StreakEngine, XPEngine, srsEngine, streakEngine, xpEngine };