@contractspec/module.learning-journey 3.7.6 → 3.7.7

package/dist/index.js

@@ -1,9 +1,6 @@
 // @bun
-// src/contracts/shared.ts
-var LEARNING_JOURNEY_OWNERS = ["modules.learning-journey"];
-
 // src/contracts/models.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var CourseModel = defineSchemaModel({
   name: "Course",
   description: "A learning course",
@@ -179,149 +176,12 @@ var SuccessOutput = defineSchemaModel({
   }
 });
 
-// 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"
-  }
-});
+// src/contracts/shared.ts
+var LEARNING_JOURNEY_OWNERS = ["modules.learning-journey"];
 
 // src/contracts/onboarding.ts
-import { ScalarTypeEnum as ScalarTypeEnum2, defineSchemaModel as defineSchemaModel2 } from "@contractspec/lib.schema";
-import { defineCommand as defineCommand2, defineQuery as defineQuery2 } from "@contractspec/lib.contracts-spec";
+import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
+import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
 var OnboardingStepConditionModel = defineSchemaModel2({
   name: "OnboardingStepCondition",
   description: "Structured completion condition for onboarding steps.",
@@ -476,7 +336,7 @@ var RecordOnboardingEventInput = defineSchemaModel2({
     occurredAt: { type: ScalarTypeEnum2.DateTime(), isOptional: true }
   }
 });
-var ListOnboardingTracksContract = defineQuery2({
+var ListOnboardingTracksContract = defineQuery({
   meta: {
     key: "learning.onboarding.listTracks",
     version: "1.0.0",
@@ -495,7 +355,7 @@ var ListOnboardingTracksContract = defineQuery2({
     auth: "user"
   }
 });
-var GetOnboardingProgressContract = defineQuery2({
+var GetOnboardingProgressContract = defineQuery({
   meta: {
     key: "learning.onboarding.getProgress",
     version: "1.0.0",
@@ -514,7 +374,7 @@ var GetOnboardingProgressContract = defineQuery2({
     auth: "user"
   }
 });
-var RecordOnboardingEventContract = defineCommand2({
+var RecordOnboardingEventContract = defineCommand({
   meta: {
     key: "learning.onboarding.recordEvent",
     version: "1.0.0",
@@ -547,6 +407,146 @@ var RecordOnboardingEventContract = defineCommand2({
     auth: "user"
   }
 });
+
+// src/contracts/operations.ts
+import { defineCommand as defineCommand2, defineQuery as defineQuery2 } from "@contractspec/lib.contracts-spec";
+var EnrollInCourseContract = defineCommand2({
+  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 = defineCommand2({
+  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 = defineCommand2({
+  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 = defineQuery2({
+  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 = defineQuery2({
+  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"
+  }
+});
 // src/docs/learning-journey.docblock.ts
 import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
 var learningJourneyDocBlocks = [
@@ -843,27 +843,182 @@ class SRSEngine {
         repetitions++;
         break;
     }
-    newInterval = Math.min(Math.round(newInterval), this.config.maxInterval);
-    newInterval = Math.max(1, newInterval);
+    newInterval = Math.min(Math.round(newInterval), this.config.maxInterval);
+    newInterval = Math.max(1, newInterval);
+    return {
+      interval: newInterval,
+      easeFactor: newEaseFactor,
+      repetitions,
+      nextReviewAt: this.addDays(now, newInterval),
+      learningStep,
+      isGraduated: true,
+      isRelearning,
+      lapses
+    };
+  }
+  addMinutes(date, minutes) {
+    return new Date(date.getTime() + minutes * 60 * 1000);
+  }
+  addDays(date, days) {
+    return new Date(date.getTime() + days * 24 * 60 * 60 * 1000);
+  }
+}
+var srsEngine = new SRSEngine;
+
+// src/engines/streak.ts
+var DEFAULT_STREAK_CONFIG = {
+  timezone: "UTC",
+  freezesPerMonth: 2,
+  maxFreezes: 5,
+  gracePeriodHours: 4
+};
+
+class StreakEngine {
+  config;
+  constructor(config = {}) {
+    this.config = { ...DEFAULT_STREAK_CONFIG, ...config };
+  }
+  update(state, now = new Date) {
+    const todayDate = this.getDateString(now);
+    const result = {
+      state: { ...state },
+      streakMaintained: false,
+      streakLost: false,
+      freezeUsed: false,
+      newStreak: false,
+      daysMissed: 0
+    };
+    if (!state.lastActivityDate) {
+      result.state.currentStreak = 1;
+      result.state.longestStreak = Math.max(1, state.longestStreak);
+      result.state.lastActivityAt = now;
+      result.state.lastActivityDate = todayDate;
+      result.newStreak = true;
+      result.streakMaintained = true;
+      return result;
+    }
+    if (state.lastActivityDate === todayDate) {
+      result.state.lastActivityAt = now;
+      result.streakMaintained = true;
+      return result;
+    }
+    const daysSinceActivity = this.getDaysBetween(state.lastActivityDate, todayDate);
+    if (daysSinceActivity === 1) {
+      result.state.currentStreak = state.currentStreak + 1;
+      result.state.longestStreak = Math.max(result.state.currentStreak, state.longestStreak);
+      result.state.lastActivityAt = now;
+      result.state.lastActivityDate = todayDate;
+      result.streakMaintained = true;
+      return result;
+    }
+    result.daysMissed = daysSinceActivity - 1;
+    const freezesNeeded = result.daysMissed;
+    if (freezesNeeded <= state.freezesRemaining) {
+      result.state.freezesRemaining = state.freezesRemaining - freezesNeeded;
+      result.state.freezeUsedAt = now;
+      result.state.currentStreak = state.currentStreak + 1;
+      result.state.longestStreak = Math.max(result.state.currentStreak, state.longestStreak);
+      result.state.lastActivityAt = now;
+      result.state.lastActivityDate = todayDate;
+      result.freezeUsed = true;
+      result.streakMaintained = true;
+      return result;
+    }
+    result.streakLost = true;
+    result.state.currentStreak = 1;
+    result.state.lastActivityAt = now;
+    result.state.lastActivityDate = todayDate;
+    result.newStreak = true;
+    return result;
+  }
+  checkStatus(state, now = new Date) {
+    if (!state.lastActivityDate) {
+      return {
+        isActive: false,
+        willExpireAt: null,
+        canUseFreeze: false,
+        daysUntilExpiry: 0
+      };
+    }
+    const todayDate = this.getDateString(now);
+    const daysSinceActivity = this.getDaysBetween(state.lastActivityDate, todayDate);
+    if (daysSinceActivity === 0) {
+      const tomorrow = this.addDays(now, 1);
+      tomorrow.setHours(23, 59, 59, 999);
+      return {
+        isActive: true,
+        willExpireAt: tomorrow,
+        canUseFreeze: state.freezesRemaining > 0,
+        daysUntilExpiry: 1
+      };
+    }
+    if (daysSinceActivity === 1) {
+      const endOfDay = new Date(now);
+      endOfDay.setHours(23 + this.config.gracePeriodHours, 59, 59, 999);
+      return {
+        isActive: true,
+        willExpireAt: endOfDay,
+        canUseFreeze: state.freezesRemaining > 0,
+        daysUntilExpiry: 0
+      };
+    }
+    const missedDays = daysSinceActivity - 1;
     return {
-      interval: newInterval,
-      easeFactor: newEaseFactor,
-      repetitions,
-      nextReviewAt: this.addDays(now, newInterval),
-      learningStep,
-      isGraduated: true,
-      isRelearning,
-      lapses
+      isActive: missedDays <= state.freezesRemaining,
+      willExpireAt: null,
+      canUseFreeze: missedDays <= state.freezesRemaining,
+      daysUntilExpiry: -missedDays
     };
   }
-  addMinutes(date, minutes) {
-    return new Date(date.getTime() + minutes * 60 * 1000);
+  useFreeze(state, now = new Date) {
+    if (state.freezesRemaining <= 0) {
+      return null;
+    }
+    return {
+      ...state,
+      freezesRemaining: state.freezesRemaining - 1,
+      freezeUsedAt: now
+    };
+  }
+  awardMonthlyFreezes(state) {
+    return {
+      ...state,
+      freezesRemaining: Math.min(state.freezesRemaining + this.config.freezesPerMonth, this.config.maxFreezes)
+    };
+  }
+  getInitialState() {
+    return {
+      currentStreak: 0,
+      longestStreak: 0,
+      lastActivityAt: null,
+      lastActivityDate: null,
+      freezesRemaining: this.config.freezesPerMonth,
+      freezeUsedAt: null
+    };
+  }
+  getMilestones(currentStreak) {
+    const milestones = [3, 7, 14, 30, 60, 90, 180, 365, 500, 1000];
+    const achieved = milestones.filter((m) => currentStreak >= m);
+    const next = milestones.find((m) => currentStreak < m) ?? null;
+    return { achieved, next };
+  }
+  getDateString(date) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, "0");
+    const day = String(date.getDate()).padStart(2, "0");
+    return `${year}-${month}-${day}`;
+  }
+  getDaysBetween(dateStr1, dateStr2) {
+    const date1 = new Date(dateStr1);
+    const date2 = new Date(dateStr2);
+    const diffTime = date2.getTime() - date1.getTime();
+    return Math.floor(diffTime / (1000 * 60 * 60 * 24));
   }
   addDays(date, days) {
     return new Date(date.getTime() + days * 24 * 60 * 60 * 1000);
   }
 }
-var srsEngine = new SRSEngine;
+var streakEngine = new StreakEngine;
 
 // src/i18n/catalogs/en.ts
 import { defineTranslation } from "@contractspec/lib.contracts-spec/translations";
@@ -906,18 +1061,18 @@ var enMessages = defineTranslation({
   }
 });
 
-// src/i18n/catalogs/fr.ts
+// src/i18n/catalogs/es.ts
 import { defineTranslation as defineTranslation2 } from "@contractspec/lib.contracts-spec/translations";
-var frMessages = defineTranslation2({
+var esMessages = defineTranslation2({
   meta: {
     key: "learning-journey.messages",
     version: "1.0.0",
     domain: "learning-journey",
-    description: "XP source labels (French)",
+    description: "XP source labels (Spanish)",
     owners: ["platform"],
     stability: "experimental"
   },
-  locale: "fr",
+  locale: "es",
   fallback: "en",
   messages: {
     "xp.source.base": {
@@ -925,40 +1080,40 @@ var frMessages = defineTranslation2({
       description: "XP breakdown label for base XP"
     },
     "xp.source.scoreBonus": {
-      value: "Bonus de score",
+      value: "Bonificaci\xF3n por puntuaci\xF3n",
       description: "XP breakdown label for score-based bonus"
     },
     "xp.source.perfectScore": {
-      value: "Score parfait",
+      value: "Puntuaci\xF3n perfecta",
       description: "XP breakdown label for perfect score bonus"
     },
     "xp.source.firstAttempt": {
-      value: "Premier essai",
+      value: "Primer intento",
       description: "XP breakdown label for first attempt bonus"
     },
     "xp.source.retryPenalty": {
-      value: "P\xE9nalit\xE9 de r\xE9essai",
+      value: "Penalizaci\xF3n por reintento",
       description: "XP breakdown label for retry penalty"
     },
     "xp.source.streakBonus": {
-      value: "Bonus de s\xE9rie",
+      value: "Bonificaci\xF3n por racha",
       description: "XP breakdown label for streak bonus"
     }
   }
 });
 
-// src/i18n/catalogs/es.ts
+// src/i18n/catalogs/fr.ts
 import { defineTranslation as defineTranslation3 } from "@contractspec/lib.contracts-spec/translations";
-var esMessages = defineTranslation3({
+var frMessages = defineTranslation3({
   meta: {
     key: "learning-journey.messages",
     version: "1.0.0",
     domain: "learning-journey",
-    description: "XP source labels (Spanish)",
+    description: "XP source labels (French)",
     owners: ["platform"],
     stability: "experimental"
   },
-  locale: "es",
+  locale: "fr",
   fallback: "en",
   messages: {
     "xp.source.base": {
@@ -966,23 +1121,23 @@ var esMessages = defineTranslation3({
       description: "XP breakdown label for base XP"
     },
     "xp.source.scoreBonus": {
-      value: "Bonificaci\xF3n por puntuaci\xF3n",
+      value: "Bonus de score",
       description: "XP breakdown label for score-based bonus"
     },
     "xp.source.perfectScore": {
-      value: "Puntuaci\xF3n perfecta",
+      value: "Score parfait",
       description: "XP breakdown label for perfect score bonus"
     },
     "xp.source.firstAttempt": {
-      value: "Primer intento",
+      value: "Premier essai",
       description: "XP breakdown label for first attempt bonus"
     },
     "xp.source.retryPenalty": {
-      value: "Penalizaci\xF3n por reintento",
+      value: "P\xE9nalit\xE9 de r\xE9essai",
       description: "XP breakdown label for retry penalty"
     },
     "xp.source.streakBonus": {
-      value: "Bonificaci\xF3n por racha",
+      value: "Bonus de s\xE9rie",
       description: "XP breakdown label for streak bonus"
     }
   }
@@ -1179,161 +1334,6 @@ function getXpSourceLabel(source, locale) {
   return i18nKey ? i18n.t(i18nKey) : source;
 }
 var xpEngine = new XPEngine;
-
-// src/engines/streak.ts
-var DEFAULT_STREAK_CONFIG = {
-  timezone: "UTC",
-  freezesPerMonth: 2,
-  maxFreezes: 5,
-  gracePeriodHours: 4
-};
-
-class StreakEngine {
-  config;
-  constructor(config = {}) {
-    this.config = { ...DEFAULT_STREAK_CONFIG, ...config };
-  }
-  update(state, now = new Date) {
-    const todayDate = this.getDateString(now);
-    const result = {
-      state: { ...state },
-      streakMaintained: false,
-      streakLost: false,
-      freezeUsed: false,
-      newStreak: false,
-      daysMissed: 0
-    };
-    if (!state.lastActivityDate) {
-      result.state.currentStreak = 1;
-      result.state.longestStreak = Math.max(1, state.longestStreak);
-      result.state.lastActivityAt = now;
-      result.state.lastActivityDate = todayDate;
-      result.newStreak = true;
-      result.streakMaintained = true;
-      return result;
-    }
-    if (state.lastActivityDate === todayDate) {
-      result.state.lastActivityAt = now;
-      result.streakMaintained = true;
-      return result;
-    }
-    const daysSinceActivity = this.getDaysBetween(state.lastActivityDate, todayDate);
-    if (daysSinceActivity === 1) {
-      result.state.currentStreak = state.currentStreak + 1;
-      result.state.longestStreak = Math.max(result.state.currentStreak, state.longestStreak);
-      result.state.lastActivityAt = now;
-      result.state.lastActivityDate = todayDate;
-      result.streakMaintained = true;
-      return result;
-    }
-    result.daysMissed = daysSinceActivity - 1;
-    const freezesNeeded = result.daysMissed;
-    if (freezesNeeded <= state.freezesRemaining) {
-      result.state.freezesRemaining = state.freezesRemaining - freezesNeeded;
-      result.state.freezeUsedAt = now;
-      result.state.currentStreak = state.currentStreak + 1;
-      result.state.longestStreak = Math.max(result.state.currentStreak, state.longestStreak);
-      result.state.lastActivityAt = now;
-      result.state.lastActivityDate = todayDate;
-      result.freezeUsed = true;
-      result.streakMaintained = true;
-      return result;
-    }
-    result.streakLost = true;
-    result.state.currentStreak = 1;
-    result.state.lastActivityAt = now;
-    result.state.lastActivityDate = todayDate;
-    result.newStreak = true;
-    return result;
-  }
-  checkStatus(state, now = new Date) {
-    if (!state.lastActivityDate) {
-      return {
-        isActive: false,
-        willExpireAt: null,
-        canUseFreeze: false,
-        daysUntilExpiry: 0
-      };
-    }
-    const todayDate = this.getDateString(now);
-    const daysSinceActivity = this.getDaysBetween(state.lastActivityDate, todayDate);
-    if (daysSinceActivity === 0) {
-      const tomorrow = this.addDays(now, 1);
-      tomorrow.setHours(23, 59, 59, 999);
-      return {
-        isActive: true,
-        willExpireAt: tomorrow,
-        canUseFreeze: state.freezesRemaining > 0,
-        daysUntilExpiry: 1
-      };
-    }
-    if (daysSinceActivity === 1) {
-      const endOfDay = new Date(now);
-      endOfDay.setHours(23 + this.config.gracePeriodHours, 59, 59, 999);
-      return {
-        isActive: true,
-        willExpireAt: endOfDay,
-        canUseFreeze: state.freezesRemaining > 0,
-        daysUntilExpiry: 0
-      };
-    }
-    const missedDays = daysSinceActivity - 1;
-    return {
-      isActive: missedDays <= state.freezesRemaining,
-      willExpireAt: null,
-      canUseFreeze: missedDays <= state.freezesRemaining,
-      daysUntilExpiry: -missedDays
-    };
-  }
-  useFreeze(state, now = new Date) {
-    if (state.freezesRemaining <= 0) {
-      return null;
-    }
-    return {
-      ...state,
-      freezesRemaining: state.freezesRemaining - 1,
-      freezeUsedAt: now
-    };
-  }
-  awardMonthlyFreezes(state) {
-    return {
-      ...state,
-      freezesRemaining: Math.min(state.freezesRemaining + this.config.freezesPerMonth, this.config.maxFreezes)
-    };
-  }
-  getInitialState() {
-    return {
-      currentStreak: 0,
-      longestStreak: 0,
-      lastActivityAt: null,
-      lastActivityDate: null,
-      freezesRemaining: this.config.freezesPerMonth,
-      freezeUsedAt: null
-    };
-  }
-  getMilestones(currentStreak) {
-    const milestones = [3, 7, 14, 30, 60, 90, 180, 365, 500, 1000];
-    const achieved = milestones.filter((m) => currentStreak >= m);
-    const next = milestones.find((m) => currentStreak < m) ?? null;
-    return { achieved, next };
-  }
-  getDateString(date) {
-    const year = date.getFullYear();
-    const month = String(date.getMonth() + 1).padStart(2, "0");
-    const day = String(date.getDate()).padStart(2, "0");
-    return `${year}-${month}-${day}`;
-  }
-  getDaysBetween(dateStr1, dateStr2) {
-    const date1 = new Date(dateStr1);
-    const date2 = new Date(dateStr2);
-    const diffTime = date2.getTime() - date1.getTime();
-    return Math.floor(diffTime / (1000 * 60 * 60 * 24));
-  }
-  addDays(date, days) {
-    return new Date(date.getTime() + days * 24 * 60 * 60 * 1000);
-  }
-}
-var streakEngine = new StreakEngine;
 // src/entities/ai.ts
 import {
   defineEntity,
@@ -3408,8 +3408,8 @@ var learningJourneySchemaContribution = {
 };
 
 // src/events.ts
-import { ScalarTypeEnum as ScalarTypeEnum3, defineSchemaModel as defineSchemaModel3 } from "@contractspec/lib.schema";
 import { defineEvent } from "@contractspec/lib.contracts-spec";
+import { defineSchemaModel as defineSchemaModel3, ScalarTypeEnum as ScalarTypeEnum3 } from "@contractspec/lib.schema";
 var CoursePublishedPayload = defineSchemaModel3({
   name: "CoursePublishedEventPayload",
   description: "Payload when a course is published",
@@ -3808,6 +3808,7 @@ var LearningJourneyEvents = {
   DailyGoalCompletedEvent,
   CertificateIssuedEvent
 };
+
 // src/learning-journey.feature.ts
 import { defineFeature } from "@contractspec/lib.contracts-spec";
 var LearningJourneyFeature = defineFeature({