@contractspec/module.learning-journey 3.7.15 → 3.7.17

package/dist/node/contracts/operations.js

@@ -1,326 +1 @@
-// src/contracts/models.ts
-import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
-var CourseModel = defineSchemaModel({
-  name: "Course",
-  description: "A learning course",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    difficulty: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    estimatedDuration: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: true
-    },
-    thumbnailUrl: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
-  }
-});
-var LearnerModel = defineSchemaModel({
-  name: "Learner",
-  description: "A learner profile",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    userId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    displayName: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    level: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    totalXp: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    currentStreak: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    longestStreak: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
-  }
-});
-var EnrollmentModel = defineSchemaModel({
-  name: "Enrollment",
-  description: "A course enrollment",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    learnerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    courseId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    progress: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    startedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true }
-  }
-});
-var ProgressModel = defineSchemaModel({
-  name: "LessonProgress",
-  description: "Lesson progress",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    learnerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    lessonId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    progress: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    score: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
-    timeSpent: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true }
-  }
-});
-var DeckModel = defineSchemaModel({
-  name: "Deck",
-  description: "A flashcard deck",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    cardCount: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    isPublic: { type: ScalarTypeEnum.Boolean(), isOptional: false },
-    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
-  }
-});
-var CardModel = defineSchemaModel({
-  name: "Card",
-  description: "A flashcard",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    deckId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    front: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    back: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    hints: { type: ScalarTypeEnum.JSON(), isOptional: true },
-    isDue: { type: ScalarTypeEnum.Boolean(), isOptional: false },
-    nextReviewAt: { type: ScalarTypeEnum.DateTime(), isOptional: true }
-  }
-});
-var AchievementModel = defineSchemaModel({
-  name: "Achievement",
-  description: "An achievement",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    key: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    icon: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    xpReward: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    unlockedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true }
-  }
-});
-var EnrollInCourseInput = defineSchemaModel({
-  name: "EnrollInCourseInput",
-  description: "Input for enrolling in a course",
-  fields: {
-    courseId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
-  }
-});
-var CompleteLessonInput = defineSchemaModel({
-  name: "CompleteLessonInput",
-  description: "Input for completing a lesson",
-  fields: {
-    lessonId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    score: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
-    timeSpent: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false }
-  }
-});
-var SubmitCardReviewInput = defineSchemaModel({
-  name: "SubmitCardReviewInput",
-  description: "Input for submitting a card review",
-  fields: {
-    cardId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    rating: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    responseTimeMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true }
-  }
-});
-var GetDueCardsInput = defineSchemaModel({
-  name: "GetDueCardsInput",
-  description: "Input for getting due cards",
-  fields: {
-    deckId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    limit: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true }
-  }
-});
-var GetDueCardsOutput = defineSchemaModel({
-  name: "GetDueCardsOutput",
-  description: "Output for getting due cards",
-  fields: {
-    cards: { type: CardModel, isArray: true, isOptional: false },
-    total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false }
-  }
-});
-var GetLearnerDashboardInput = defineSchemaModel({
-  name: "GetLearnerDashboardInput",
-  description: "Input for getting learner dashboard",
-  fields: {
-    learnerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
-  }
-});
-var LearnerDashboardModel = defineSchemaModel({
-  name: "LearnerDashboard",
-  description: "Learner dashboard data",
-  fields: {
-    learner: { type: LearnerModel, isOptional: false },
-    currentStreak: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    dailyXpGoal: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    dailyXpProgress: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    activeEnrollments: {
-      type: EnrollmentModel,
-      isArray: true,
-      isOptional: false
-    },
-    recentAchievements: {
-      type: AchievementModel,
-      isArray: true,
-      isOptional: false
-    },
-    dueCardCount: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false }
-  }
-});
-var SuccessOutput = defineSchemaModel({
-  name: "SuccessOutput",
-  description: "Generic success output",
-  fields: {
-    success: { type: ScalarTypeEnum.Boolean(), isOptional: false },
-    xpEarned: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true }
-  }
-});
-
-// src/contracts/shared.ts
-var LEARNING_JOURNEY_OWNERS = ["modules.learning-journey"];
-
-// src/contracts/operations.ts
-import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
-var EnrollInCourseContract = defineCommand({
-  meta: {
-    key: "learning.enroll",
-    version: "1.0.0",
-    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"
-  }
-});
-var CompleteLessonContract = defineCommand({
-  meta: {
-    key: "learning.completeLesson",
-    version: "1.0.0",
-    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"
-  }
-});
-var SubmitCardReviewContract = defineCommand({
-  meta: {
-    key: "learning.submitCardReview",
-    version: "1.0.0",
-    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"
-  }
-});
-var GetDueCardsContract = defineQuery({
-  meta: {
-    key: "learning.getDueCards",
-    version: "1.0.0",
-    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"
-  }
-});
-var GetLearnerDashboardContract = defineQuery({
-  meta: {
-    key: "learning.getDashboard",
-    version: "1.0.0",
-    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"
-  }
-});
-export {
-  SubmitCardReviewContract,
-  GetLearnerDashboardContract,
-  GetDueCardsContract,
-  EnrollInCourseContract,
-  CompleteLessonContract
-};
+import{defineSchemaModel as t,ScalarTypeEnum as e}from"@contractspec/lib.schema";var m=t({name:"Course",description:"A learning course",fields:{id:{type:e.String_unsecure(),isOptional:!1},title:{type:e.String_unsecure(),isOptional:!1},slug:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0},difficulty:{type:e.String_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},estimatedDuration:{type:e.Int_unsecure(),isOptional:!0},thumbnailUrl:{type:e.String_unsecure(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1}}}),f=t({name:"Learner",description:"A learner profile",fields:{id:{type:e.String_unsecure(),isOptional:!1},userId:{type:e.String_unsecure(),isOptional:!1},displayName:{type:e.String_unsecure(),isOptional:!0},level:{type:e.Int_unsecure(),isOptional:!1},totalXp:{type:e.Int_unsecure(),isOptional:!1},currentStreak:{type:e.Int_unsecure(),isOptional:!1},longestStreak:{type:e.Int_unsecure(),isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1}}}),n=t({name:"Enrollment",description:"A course enrollment",fields:{id:{type:e.String_unsecure(),isOptional:!1},learnerId:{type:e.String_unsecure(),isOptional:!1},courseId:{type:e.String_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},progress:{type:e.Int_unsecure(),isOptional:!1},startedAt:{type:e.DateTime(),isOptional:!0},completedAt:{type:e.DateTime(),isOptional:!0}}}),S=t({name:"LessonProgress",description:"Lesson progress",fields:{id:{type:e.String_unsecure(),isOptional:!1},learnerId:{type:e.String_unsecure(),isOptional:!1},lessonId:{type:e.String_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},progress:{type:e.Int_unsecure(),isOptional:!1},score:{type:e.Int_unsecure(),isOptional:!0},timeSpent:{type:e.Int_unsecure(),isOptional:!1},completedAt:{type:e.DateTime(),isOptional:!0}}}),I=t({name:"Deck",description:"A flashcard deck",fields:{id:{type:e.String_unsecure(),isOptional:!1},title:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0},cardCount:{type:e.Int_unsecure(),isOptional:!1},isPublic:{type:e.Boolean(),isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1}}}),O=t({name:"Card",description:"A flashcard",fields:{id:{type:e.String_unsecure(),isOptional:!1},deckId:{type:e.String_unsecure(),isOptional:!1},front:{type:e.String_unsecure(),isOptional:!1},back:{type:e.String_unsecure(),isOptional:!1},hints:{type:e.JSON(),isOptional:!0},isDue:{type:e.Boolean(),isOptional:!1},nextReviewAt:{type:e.DateTime(),isOptional:!0}}}),g=t({name:"Achievement",description:"An achievement",fields:{id:{type:e.String_unsecure(),isOptional:!1},key:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!1},icon:{type:e.String_unsecure(),isOptional:!0},xpReward:{type:e.Int_unsecure(),isOptional:!1},unlockedAt:{type:e.DateTime(),isOptional:!0}}}),a=t({name:"EnrollInCourseInput",description:"Input for enrolling in a course",fields:{courseId:{type:e.String_unsecure(),isOptional:!1}}}),p=t({name:"CompleteLessonInput",description:"Input for completing a lesson",fields:{lessonId:{type:e.String_unsecure(),isOptional:!1},score:{type:e.Int_unsecure(),isOptional:!0},timeSpent:{type:e.Int_unsecure(),isOptional:!1}}}),l=t({name:"SubmitCardReviewInput",description:"Input for submitting a card review",fields:{cardId:{type:e.String_unsecure(),isOptional:!1},rating:{type:e.String_unsecure(),isOptional:!1},responseTimeMs:{type:e.Int_unsecure(),isOptional:!0}}}),o=t({name:"GetDueCardsInput",description:"Input for getting due cards",fields:{deckId:{type:e.String_unsecure(),isOptional:!0},limit:{type:e.Int_unsecure(),isOptional:!0}}}),u=t({name:"GetDueCardsOutput",description:"Output for getting due cards",fields:{cards:{type:O,isArray:!0,isOptional:!1},total:{type:e.Int_unsecure(),isOptional:!1}}}),c=t({name:"GetLearnerDashboardInput",description:"Input for getting learner dashboard",fields:{learnerId:{type:e.String_unsecure(),isOptional:!0}}}),d=t({name:"LearnerDashboard",description:"Learner dashboard data",fields:{learner:{type:f,isOptional:!1},currentStreak:{type:e.Int_unsecure(),isOptional:!1},dailyXpGoal:{type:e.Int_unsecure(),isOptional:!1},dailyXpProgress:{type:e.Int_unsecure(),isOptional:!1},activeEnrollments:{type:n,isArray:!0,isOptional:!1},recentAchievements:{type:g,isArray:!0,isOptional:!1},dueCardCount:{type:e.Int_unsecure(),isOptional:!1}}}),i=t({name:"SuccessOutput",description:"Generic success output",fields:{success:{type:e.Boolean(),isOptional:!1},xpEarned:{type:e.Int_unsecure(),isOptional:!0}}});var s=["modules.learning-journey"];import{defineCommand as r,defineQuery as y}from"@contractspec/lib.contracts-spec";var T=r({meta:{key:"learning.enroll",version:"1.0.0",stability:"stable",owners:[...s],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:a,output:n,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"}}),v=r({meta:{key:"learning.completeLesson",version:"1.0.0",stability:"stable",owners:[...s],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:p,output:i,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"}}),C=r({meta:{key:"learning.submitCardReview",version:"1.0.0",stability:"stable",owners:[...s],tags:["learning","flashcards"],description:"Submit a flashcard review.",goal:"Record review and update SRS schedule.",context:"Called when reviewing flashcards."},io:{input:l,output:i,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"}}),b=y({meta:{key:"learning.getDueCards",version:"1.0.0",stability:"stable",owners:[...s],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:u},policy:{auth:"user"}}),M=y({meta:{key:"learning.getDashboard",version:"1.0.0",stability:"stable",owners:[...s],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:d},policy:{auth:"user"}});export{C as SubmitCardReviewContract,M as GetLearnerDashboardContract,b as GetDueCardsContract,T as EnrollInCourseContract,v as CompleteLessonContract};

package/dist/node/contracts/shared.js

@@ -1,5 +1 @@
-// src/contracts/shared.ts
-var LEARNING_JOURNEY_OWNERS = ["modules.learning-journey"];
-export {
-  LEARNING_JOURNEY_OWNERS
-};
+var n=["modules.learning-journey"];export{n as LEARNING_JOURNEY_OWNERS};

package/dist/node/docs/index.js

@@ -1,15 +1,4 @@
-// src/docs/learning-journey.docblock.ts
-import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
-var learningJourneyDocBlocks = [
-  {
-    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 as m}from"@contractspec/lib.contracts-spec/docs";var f=[{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.
@@ -39,13 +28,13 @@ var learningJourneyDocBlocks = [
 
 ## Example
 
-${"```"}ts
+\`\`\`ts
 import { learningJourneyEntities } from '@contractspec/module.learning-journey';
 import { StreakEngine } from '@contractspec/module.learning-journey/engines';
 
 const streak = new StreakEngine({ graceDays: 1 });
 const updated = streak.compute({ lastActiveAt: new Date(), today: new Date() });
-${"```"},
+\`\`\`,
 
 ## Guardrails
 
@@ -53,17 +42,7 @@ ${"```"},
 - 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.
 
@@ -73,17 +52,7 @@ ${"```"},
 
 ## 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 \`@contractspec/module.learning-journey\`.
 3) Bind steps to real product events (e.g., deal.created, run.completed).
@@ -96,17 +65,7 @@ ${"```"},
 ## 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.
@@ -118,7 +77,4 @@ ${"```"},
 ## 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.`
-  }
-];
-registerDocBlocks(learningJourneyDocBlocks);
+- Use Feature Flags to trial new tracks or reward rules; default safe/off.`}];m(f);

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

@@ -1,15 +1,4 @@
-// src/docs/learning-journey.docblock.ts
-import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
-var learningJourneyDocBlocks = [
-  {
-    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 as f}from"@contractspec/lib.contracts-spec/docs";var h=[{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.
@@ -39,13 +28,13 @@ var learningJourneyDocBlocks = [
 
 ## Example
 
-${"```"}ts
+\`\`\`ts
 import { learningJourneyEntities } from '@contractspec/module.learning-journey';
 import { StreakEngine } from '@contractspec/module.learning-journey/engines';
 
 const streak = new StreakEngine({ graceDays: 1 });
 const updated = streak.compute({ lastActiveAt: new Date(), today: new Date() });
-${"```"},
+\`\`\`,
 
 ## Guardrails
 
@@ -53,17 +42,7 @@ ${"```"},
 - 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.
 
@@ -73,17 +52,7 @@ ${"```"},
 
 ## 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 \`@contractspec/module.learning-journey\`.
 3) Bind steps to real product events (e.g., deal.created, run.completed).
@@ -96,17 +65,7 @@ ${"```"},
 ## 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.
@@ -118,7 +77,4 @@ ${"```"},
 ## 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.`
-  }
-];
-registerDocBlocks(learningJourneyDocBlocks);
+- Use Feature Flags to trial new tracks or reward rules; default safe/off.`}];f(h);