@contractspec/module.learning-journey 1.44.0

package/dist/engines/xp.js

@@ -0,0 +1,213 @@
+//#region src/engines/xp.ts
+const DEFAULT_XP_CONFIG = {
+	baseValues: {
+		lesson_complete: 10,
+		quiz_pass: 20,
+		quiz_perfect: 50,
+		flashcard_review: 1,
+		course_complete: 200,
+		module_complete: 50,
+		streak_bonus: 5,
+		achievement_unlock: 0,
+		daily_goal_complete: 15,
+		first_lesson: 25,
+		onboarding_step: 5,
+		onboarding_complete: 50
+	},
+	scoreThresholds: [
+		{
+			min: 90,
+			multiplier: 1.5
+		},
+		{
+			min: 80,
+			multiplier: 1.25
+		},
+		{
+			min: 70,
+			multiplier: 1
+		},
+		{
+			min: 60,
+			multiplier: .75
+		},
+		{
+			min: 0,
+			multiplier: .5
+		}
+	],
+	streakTiers: [
+		{
+			days: 365,
+			bonus: 50
+		},
+		{
+			days: 180,
+			bonus: 30
+		},
+		{
+			days: 90,
+			bonus: 20
+		},
+		{
+			days: 30,
+			bonus: 15
+		},
+		{
+			days: 14,
+			bonus: 10
+		},
+		{
+			days: 7,
+			bonus: 5
+		},
+		{
+			days: 3,
+			bonus: 2
+		},
+		{
+			days: 1,
+			bonus: 0
+		}
+	],
+	perfectScoreMultiplier: 1.5,
+	firstAttemptBonus: 10,
+	retryPenalty: .5,
+	speedBonusMultiplier: 1.2,
+	speedBonusThreshold: .8
+};
+var XPEngine = class {
+	config;
+	constructor(config = {}) {
+		this.config = {
+			...DEFAULT_XP_CONFIG,
+			...config,
+			baseValues: {
+				...DEFAULT_XP_CONFIG.baseValues,
+				...config.baseValues
+			},
+			scoreThresholds: config.scoreThresholds || DEFAULT_XP_CONFIG.scoreThresholds,
+			streakTiers: config.streakTiers || DEFAULT_XP_CONFIG.streakTiers
+		};
+	}
+	/**
+	* Calculate XP for an activity.
+	*/
+	calculate(input) {
+		const breakdown = [];
+		const baseXp = input.baseXp ?? this.config.baseValues[input.activity];
+		let totalXp = baseXp;
+		breakdown.push({
+			source: "base",
+			amount: baseXp
+		});
+		if (input.score !== void 0) {
+			const scoreMultiplier = this.getScoreMultiplier(input.score);
+			if (scoreMultiplier !== 1) {
+				const scoreBonus = Math.round(baseXp * (scoreMultiplier - 1));
+				totalXp += scoreBonus;
+				breakdown.push({
+					source: "score_bonus",
+					amount: scoreBonus,
+					multiplier: scoreMultiplier
+				});
+			}
+			if (input.score === 100) {
+				const perfectBonus = Math.round(baseXp * (this.config.perfectScoreMultiplier - 1));
+				totalXp += perfectBonus;
+				breakdown.push({
+					source: "perfect_score",
+					amount: perfectBonus,
+					multiplier: this.config.perfectScoreMultiplier
+				});
+			}
+		}
+		if (input.attemptNumber === 1 && !input.isRetry) {
+			totalXp += this.config.firstAttemptBonus;
+			breakdown.push({
+				source: "first_attempt",
+				amount: this.config.firstAttemptBonus
+			});
+		}
+		if (input.isRetry) {
+			const penalty = Math.round(totalXp * (1 - this.config.retryPenalty));
+			totalXp -= penalty;
+			breakdown.push({
+				source: "retry_penalty",
+				amount: -penalty,
+				multiplier: this.config.retryPenalty
+			});
+		}
+		if (input.currentStreak && input.currentStreak > 0) {
+			const streakBonus = this.getStreakBonus(input.currentStreak);
+			if (streakBonus > 0) {
+				totalXp += streakBonus;
+				breakdown.push({
+					source: "streak_bonus",
+					amount: streakBonus
+				});
+			}
+		}
+		if (baseXp > 0) totalXp = Math.max(1, totalXp);
+		return {
+			totalXp: Math.round(totalXp),
+			baseXp,
+			breakdown
+		};
+	}
+	/**
+	* Calculate streak bonus XP.
+	*/
+	calculateStreakBonus(currentStreak) {
+		const bonus = this.getStreakBonus(currentStreak);
+		return {
+			totalXp: bonus,
+			baseXp: bonus,
+			breakdown: [{
+				source: "streak_bonus",
+				amount: bonus
+			}]
+		};
+	}
+	/**
+	* Calculate XP needed for a level.
+	*/
+	getXpForLevel(level) {
+		if (level <= 1) return 0;
+		return Math.round(100 * Math.pow(level - 1, 1.5));
+	}
+	/**
+	* Get level from total XP.
+	*/
+	getLevelFromXp(totalXp) {
+		let level = 1;
+		let xpRequired = this.getXpForLevel(level + 1);
+		while (totalXp >= xpRequired && level < 1e3) {
+			level++;
+			xpRequired = this.getXpForLevel(level + 1);
+		}
+		const xpForCurrentLevel = this.getXpForLevel(level);
+		const xpForNextLevel = this.getXpForLevel(level + 1);
+		return {
+			level,
+			xpInLevel: totalXp - xpForCurrentLevel,
+			xpForNextLevel: xpForNextLevel - xpForCurrentLevel
+		};
+	}
+	getScoreMultiplier(score) {
+		for (const threshold of this.config.scoreThresholds) if (score >= threshold.min) return threshold.multiplier;
+		return 1;
+	}
+	getStreakBonus(streak) {
+		for (const tier of this.config.streakTiers) if (streak >= tier.days) return tier.bonus;
+		return 0;
+	}
+};
+/**
+* Default XP engine instance.
+*/
+const xpEngine = new XPEngine();
+
+//#endregion
+export { DEFAULT_XP_CONFIG, XPEngine, xpEngine };
+//# sourceMappingURL=xp.js.map

package/dist/engines/xp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xp.js","names":["DEFAULT_XP_CONFIG: XPConfig","breakdown: XPBreakdown[]"],"sources":["../../src/engines/xp.ts"],"sourcesContent":["/**\n * XP (Experience Points) Engine\n *\n * Calculates XP rewards for various learning activities.\n */\n\n// ============ Types ============\n\nexport type XPActivityType =\n  | 'lesson_complete'\n  | 'quiz_pass'\n  | 'quiz_perfect'\n  | 'flashcard_review'\n  | 'course_complete'\n  | 'module_complete'\n  | 'streak_bonus'\n  | 'achievement_unlock'\n  | 'daily_goal_complete'\n  | 'first_lesson'\n  | 'onboarding_step'\n  | 'onboarding_complete';\n\nexport interface XPCalculationInput {\n  /** Type of activity */\n  activity: XPActivityType;\n  /** Base XP for the activity (from content config) */\n  baseXp?: number;\n  /** Score achieved (0-100) for scored activities */\n  score?: number;\n  /** Current streak (for streak bonuses) */\n  currentStreak?: number;\n  /** Time spent in seconds */\n  timeSpent?: number;\n  /** Attempt number (for quizzes) */\n  attemptNumber?: number;\n  /** Whether this is a retry */\n  isRetry?: boolean;\n}\n\nexport interface XPResult {\n  /** Total XP earned */\n  totalXp: number;\n  /** Base XP before bonuses */\n  baseXp: number;\n  /** Breakdown of XP sources */\n  breakdown: XPBreakdown[];\n}\n\nexport interface XPBreakdown {\n  /** Source of XP */\n  source: string;\n  /** XP amount */\n  amount: number;\n  /** Multiplier applied */\n  multiplier?: number;\n}\n\nexport interface XPConfig {\n  /** Base XP values for each activity */\n  baseValues: Record<XPActivityType, number>;\n  /** Score thresholds for bonus XP */\n  scoreThresholds: { min: number; multiplier: number }[];\n  /** Streak bonus tiers */\n  streakTiers: { days: number; bonus: number }[];\n  /** Perfect score bonus multiplier */\n  perfectScoreMultiplier: number;\n  /** First attempt bonus */\n  firstAttemptBonus: number;\n  /** Retry penalty multiplier */\n  retryPenalty: number;\n  /** Speed bonus (complete under expected time) */\n  speedBonusMultiplier: number;\n  /** Speed bonus threshold (percentage of expected time) */\n  speedBonusThreshold: number;\n}\n\n// ============ Default Configuration ============\n\nexport const DEFAULT_XP_CONFIG: XPConfig = {\n  baseValues: {\n    lesson_complete: 10,\n    quiz_pass: 20,\n    quiz_perfect: 50,\n    flashcard_review: 1,\n    course_complete: 200,\n    module_complete: 50,\n    streak_bonus: 5,\n    achievement_unlock: 0, // XP comes from achievement\n    daily_goal_complete: 15,\n    first_lesson: 25,\n    onboarding_step: 5,\n    onboarding_complete: 50,\n  },\n  scoreThresholds: [\n    { min: 90, multiplier: 1.5 },\n    { min: 80, multiplier: 1.25 },\n    { min: 70, multiplier: 1.0 },\n    { min: 60, multiplier: 0.75 },\n    { min: 0, multiplier: 0.5 },\n  ],\n  streakTiers: [\n    { days: 365, bonus: 50 },\n    { days: 180, bonus: 30 },\n    { days: 90, bonus: 20 },\n    { days: 30, bonus: 15 },\n    { days: 14, bonus: 10 },\n    { days: 7, bonus: 5 },\n    { days: 3, bonus: 2 },\n    { days: 1, bonus: 0 },\n  ],\n  perfectScoreMultiplier: 1.5,\n  firstAttemptBonus: 10,\n  retryPenalty: 0.5,\n  speedBonusMultiplier: 1.2,\n  speedBonusThreshold: 0.8,\n};\n\n// ============ XP Engine ============\n\nexport class XPEngine {\n  private config: XPConfig;\n\n  constructor(config: Partial<XPConfig> = {}) {\n    this.config = {\n      ...DEFAULT_XP_CONFIG,\n      ...config,\n      baseValues: { ...DEFAULT_XP_CONFIG.baseValues, ...config.baseValues },\n      scoreThresholds:\n        config.scoreThresholds || DEFAULT_XP_CONFIG.scoreThresholds,\n      streakTiers: config.streakTiers || DEFAULT_XP_CONFIG.streakTiers,\n    };\n  }\n\n  /**\n   * Calculate XP for an activity.\n   */\n  calculate(input: XPCalculationInput): XPResult {\n    const breakdown: XPBreakdown[] = [];\n\n    // Get base XP\n    const baseXp = input.baseXp ?? this.config.baseValues[input.activity];\n    let totalXp = baseXp;\n\n    breakdown.push({\n      source: 'base',\n      amount: baseXp,\n    });\n\n    // Apply score-based multiplier\n    if (input.score !== undefined) {\n      const scoreMultiplier = this.getScoreMultiplier(input.score);\n      if (scoreMultiplier !== 1.0) {\n        const scoreBonus = Math.round(baseXp * (scoreMultiplier - 1));\n        totalXp += scoreBonus;\n        breakdown.push({\n          source: 'score_bonus',\n          amount: scoreBonus,\n          multiplier: scoreMultiplier,\n        });\n      }\n\n      // Perfect score bonus\n      if (input.score === 100) {\n        const perfectBonus = Math.round(\n          baseXp * (this.config.perfectScoreMultiplier - 1)\n        );\n        totalXp += perfectBonus;\n        breakdown.push({\n          source: 'perfect_score',\n          amount: perfectBonus,\n          multiplier: this.config.perfectScoreMultiplier,\n        });\n      }\n    }\n\n    // First attempt bonus\n    if (input.attemptNumber === 1 && !input.isRetry) {\n      totalXp += this.config.firstAttemptBonus;\n      breakdown.push({\n        source: 'first_attempt',\n        amount: this.config.firstAttemptBonus,\n      });\n    }\n\n    // Retry penalty\n    if (input.isRetry) {\n      const penalty = Math.round(totalXp * (1 - this.config.retryPenalty));\n      totalXp -= penalty;\n      breakdown.push({\n        source: 'retry_penalty',\n        amount: -penalty,\n        multiplier: this.config.retryPenalty,\n      });\n    }\n\n    // Streak bonus\n    if (input.currentStreak && input.currentStreak > 0) {\n      const streakBonus = this.getStreakBonus(input.currentStreak);\n      if (streakBonus > 0) {\n        totalXp += streakBonus;\n        breakdown.push({\n          source: 'streak_bonus',\n          amount: streakBonus,\n        });\n      }\n    }\n\n    // Ensure XP is at least 1 (if base was > 0)\n    if (baseXp > 0) {\n      totalXp = Math.max(1, totalXp);\n    }\n\n    return {\n      totalXp: Math.round(totalXp),\n      baseXp,\n      breakdown,\n    };\n  }\n\n  /**\n   * Calculate streak bonus XP.\n   */\n  calculateStreakBonus(currentStreak: number): XPResult {\n    const bonus = this.getStreakBonus(currentStreak);\n    return {\n      totalXp: bonus,\n      baseXp: bonus,\n      breakdown: [\n        {\n          source: 'streak_bonus',\n          amount: bonus,\n        },\n      ],\n    };\n  }\n\n  /**\n   * Calculate XP needed for a level.\n   */\n  getXpForLevel(level: number): number {\n    // Exponential growth formula\n    // Level 1: 0 XP\n    // Level 2: 100 XP\n    // Level 3: 300 XP\n    // etc.\n    if (level <= 1) return 0;\n    return Math.round(100 * Math.pow(level - 1, 1.5));\n  }\n\n  /**\n   * Get level from total XP.\n   */\n  getLevelFromXp(totalXp: number): {\n    level: number;\n    xpInLevel: number;\n    xpForNextLevel: number;\n  } {\n    let level = 1;\n    let xpRequired = this.getXpForLevel(level + 1);\n\n    while (totalXp >= xpRequired && level < 1000) {\n      level++;\n      xpRequired = this.getXpForLevel(level + 1);\n    }\n\n    const xpForCurrentLevel = this.getXpForLevel(level);\n    const xpForNextLevel = this.getXpForLevel(level + 1);\n\n    return {\n      level,\n      xpInLevel: totalXp - xpForCurrentLevel,\n      xpForNextLevel: xpForNextLevel - xpForCurrentLevel,\n    };\n  }\n\n  // ============ Helpers ============\n\n  private getScoreMultiplier(score: number): number {\n    for (const threshold of this.config.scoreThresholds) {\n      if (score >= threshold.min) {\n        return threshold.multiplier;\n      }\n    }\n    return 1.0;\n  }\n\n  private getStreakBonus(streak: number): number {\n    for (const tier of this.config.streakTiers) {\n      if (streak >= tier.days) {\n        return tier.bonus;\n      }\n    }\n    return 0;\n  }\n}\n\n/**\n * Default XP engine instance.\n */\nexport const xpEngine = new XPEngine();\n"],"mappings":";AA8EA,MAAaA,oBAA8B;CACzC,YAAY;EACV,iBAAiB;EACjB,WAAW;EACX,cAAc;EACd,kBAAkB;EAClB,iBAAiB;EACjB,iBAAiB;EACjB,cAAc;EACd,oBAAoB;EACpB,qBAAqB;EACrB,cAAc;EACd,iBAAiB;EACjB,qBAAqB;EACtB;CACD,iBAAiB;EACf;GAAE,KAAK;GAAI,YAAY;GAAK;EAC5B;GAAE,KAAK;GAAI,YAAY;GAAM;EAC7B;GAAE,KAAK;GAAI,YAAY;GAAK;EAC5B;GAAE,KAAK;GAAI,YAAY;GAAM;EAC7B;GAAE,KAAK;GAAG,YAAY;GAAK;EAC5B;CACD,aAAa;EACX;GAAE,MAAM;GAAK,OAAO;GAAI;EACxB;GAAE,MAAM;GAAK,OAAO;GAAI;EACxB;GAAE,MAAM;GAAI,OAAO;GAAI;EACvB;GAAE,MAAM;GAAI,OAAO;GAAI;EACvB;GAAE,MAAM;GAAI,OAAO;GAAI;EACvB;GAAE,MAAM;GAAG,OAAO;GAAG;EACrB;GAAE,MAAM;GAAG,OAAO;GAAG;EACrB;GAAE,MAAM;GAAG,OAAO;GAAG;EACtB;CACD,wBAAwB;CACxB,mBAAmB;CACnB,cAAc;CACd,sBAAsB;CACtB,qBAAqB;CACtB;AAID,IAAa,WAAb,MAAsB;CACpB,AAAQ;CAER,YAAY,SAA4B,EAAE,EAAE;AAC1C,OAAK,SAAS;GACZ,GAAG;GACH,GAAG;GACH,YAAY;IAAE,GAAG,kBAAkB;IAAY,GAAG,OAAO;IAAY;GACrE,iBACE,OAAO,mBAAmB,kBAAkB;GAC9C,aAAa,OAAO,eAAe,kBAAkB;GACtD;;;;;CAMH,UAAU,OAAqC;EAC7C,MAAMC,YAA2B,EAAE;EAGnC,MAAM,SAAS,MAAM,UAAU,KAAK,OAAO,WAAW,MAAM;EAC5D,IAAI,UAAU;AAEd,YAAU,KAAK;GACb,QAAQ;GACR,QAAQ;GACT,CAAC;AAGF,MAAI,MAAM,UAAU,QAAW;GAC7B,MAAM,kBAAkB,KAAK,mBAAmB,MAAM,MAAM;AAC5D,OAAI,oBAAoB,GAAK;IAC3B,MAAM,aAAa,KAAK,MAAM,UAAU,kBAAkB,GAAG;AAC7D,eAAW;AACX,cAAU,KAAK;KACb,QAAQ;KACR,QAAQ;KACR,YAAY;KACb,CAAC;;AAIJ,OAAI,MAAM,UAAU,KAAK;IACvB,MAAM,eAAe,KAAK,MACxB,UAAU,KAAK,OAAO,yBAAyB,GAChD;AACD,eAAW;AACX,cAAU,KAAK;KACb,QAAQ;KACR,QAAQ;KACR,YAAY,KAAK,OAAO;KACzB,CAAC;;;AAKN,MAAI,MAAM,kBAAkB,KAAK,CAAC,MAAM,SAAS;AAC/C,cAAW,KAAK,OAAO;AACvB,aAAU,KAAK;IACb,QAAQ;IACR,QAAQ,KAAK,OAAO;IACrB,CAAC;;AAIJ,MAAI,MAAM,SAAS;GACjB,MAAM,UAAU,KAAK,MAAM,WAAW,IAAI,KAAK,OAAO,cAAc;AACpE,cAAW;AACX,aAAU,KAAK;IACb,QAAQ;IACR,QAAQ,CAAC;IACT,YAAY,KAAK,OAAO;IACzB,CAAC;;AAIJ,MAAI,MAAM,iBAAiB,MAAM,gBAAgB,GAAG;GAClD,MAAM,cAAc,KAAK,eAAe,MAAM,cAAc;AAC5D,OAAI,cAAc,GAAG;AACnB,eAAW;AACX,cAAU,KAAK;KACb,QAAQ;KACR,QAAQ;KACT,CAAC;;;AAKN,MAAI,SAAS,EACX,WAAU,KAAK,IAAI,GAAG,QAAQ;AAGhC,SAAO;GACL,SAAS,KAAK,MAAM,QAAQ;GAC5B;GACA;GACD;;;;;CAMH,qBAAqB,eAAiC;EACpD,MAAM,QAAQ,KAAK,eAAe,cAAc;AAChD,SAAO;GACL,SAAS;GACT,QAAQ;GACR,WAAW,CACT;IACE,QAAQ;IACR,QAAQ;IACT,CACF;GACF;;;;;CAMH,cAAc,OAAuB;AAMnC,MAAI,SAAS,EAAG,QAAO;AACvB,SAAO,KAAK,MAAM,MAAM,KAAK,IAAI,QAAQ,GAAG,IAAI,CAAC;;;;;CAMnD,eAAe,SAIb;EACA,IAAI,QAAQ;EACZ,IAAI,aAAa,KAAK,cAAc,QAAQ,EAAE;AAE9C,SAAO,WAAW,cAAc,QAAQ,KAAM;AAC5C;AACA,gBAAa,KAAK,cAAc,QAAQ,EAAE;;EAG5C,MAAM,oBAAoB,KAAK,cAAc,MAAM;EACnD,MAAM,iBAAiB,KAAK,cAAc,QAAQ,EAAE;AAEpD,SAAO;GACL;GACA,WAAW,UAAU;GACrB,gBAAgB,iBAAiB;GAClC;;CAKH,AAAQ,mBAAmB,OAAuB;AAChD,OAAK,MAAM,aAAa,KAAK,OAAO,gBAClC,KAAI,SAAS,UAAU,IACrB,QAAO,UAAU;AAGrB,SAAO;;CAGT,AAAQ,eAAe,QAAwB;AAC7C,OAAK,MAAM,QAAQ,KAAK,OAAO,YAC7B,KAAI,UAAU,KAAK,KACjB,QAAO,KAAK;AAGhB,SAAO;;;;;;AAOX,MAAa,WAAW,IAAI,UAAU"}

package/dist/entities/ai.d.ts

@@ -0,0 +1,232 @@
+import * as _contractspec_lib_schema747 from "@contractspec/lib.schema";
+
+//#region src/entities/ai.d.ts
+/**
+ * Learning style enum.
+ */
+declare const LearningStyleEnum: _contractspec_lib_schema747.EntityEnumDef;
+/**
+ * Recommendation type enum.
+ */
+declare const RecommendationTypeEnum: _contractspec_lib_schema747.EntityEnumDef;
+/**
+ * LearnerProfile entity - AI personalization profile.
+ */
+declare const LearnerProfileEntity: _contractspec_lib_schema747.EntitySpec<{
+  id: _contractspec_lib_schema747.EntityScalarField;
+  learnerId: _contractspec_lib_schema747.EntityScalarField;
+  learningStyle: _contractspec_lib_schema747.EntityEnumField;
+  preferredDifficulty: _contractspec_lib_schema747.EntityScalarField;
+  preferredSessionLength: _contractspec_lib_schema747.EntityScalarField;
+  interests: _contractspec_lib_schema747.EntityScalarField;
+  goals: _contractspec_lib_schema747.EntityScalarField;
+  pacePreference: _contractspec_lib_schema747.EntityScalarField;
+  bestTimeOfDay: _contractspec_lib_schema747.EntityScalarField;
+  averageSessionLength: _contractspec_lib_schema747.EntityScalarField;
+  daysActivePerWeek: _contractspec_lib_schema747.EntityScalarField;
+  avgQuizScore: _contractspec_lib_schema747.EntityScalarField;
+  avgLessonCompletionTime: _contractspec_lib_schema747.EntityScalarField;
+  strengths: _contractspec_lib_schema747.EntityScalarField;
+  weaknesses: _contractspec_lib_schema747.EntityScalarField;
+  lastAnalyzedAt: _contractspec_lib_schema747.EntityScalarField;
+  metadata: _contractspec_lib_schema747.EntityScalarField;
+  createdAt: _contractspec_lib_schema747.EntityScalarField;
+  updatedAt: _contractspec_lib_schema747.EntityScalarField;
+  learner: _contractspec_lib_schema747.EntityRelationField;
+}>;
+/**
+ * SkillMap entity - tracks skill proficiency.
+ */
+declare const SkillMapEntity: _contractspec_lib_schema747.EntitySpec<{
+  id: _contractspec_lib_schema747.EntityScalarField;
+  learnerId: _contractspec_lib_schema747.EntityScalarField;
+  skillId: _contractspec_lib_schema747.EntityScalarField;
+  skillName: _contractspec_lib_schema747.EntityScalarField;
+  skillCategory: _contractspec_lib_schema747.EntityScalarField;
+  level: _contractspec_lib_schema747.EntityScalarField;
+  confidence: _contractspec_lib_schema747.EntityScalarField;
+  lessonsCompleted: _contractspec_lib_schema747.EntityScalarField;
+  quizzesCompleted: _contractspec_lib_schema747.EntityScalarField;
+  practiceTime: _contractspec_lib_schema747.EntityScalarField;
+  lastPracticedAt: _contractspec_lib_schema747.EntityScalarField;
+  learningVelocity: _contractspec_lib_schema747.EntityScalarField;
+  predictedTimeToMastery: _contractspec_lib_schema747.EntityScalarField;
+  createdAt: _contractspec_lib_schema747.EntityScalarField;
+  updatedAt: _contractspec_lib_schema747.EntityScalarField;
+  learner: _contractspec_lib_schema747.EntityRelationField;
+}>;
+/**
+ * LearningPath entity - AI-generated learning paths.
+ */
+declare const LearningPathEntity: _contractspec_lib_schema747.EntitySpec<{
+  id: _contractspec_lib_schema747.EntityScalarField;
+  learnerId: _contractspec_lib_schema747.EntityScalarField;
+  name: _contractspec_lib_schema747.EntityScalarField;
+  description: _contractspec_lib_schema747.EntityScalarField;
+  goal: _contractspec_lib_schema747.EntityScalarField;
+  steps: _contractspec_lib_schema747.EntityScalarField;
+  currentStepIndex: _contractspec_lib_schema747.EntityScalarField;
+  progress: _contractspec_lib_schema747.EntityScalarField;
+  completedSteps: _contractspec_lib_schema747.EntityScalarField;
+  totalSteps: _contractspec_lib_schema747.EntityScalarField;
+  generatedAt: _contractspec_lib_schema747.EntityScalarField;
+  adaptedFrom: _contractspec_lib_schema747.EntityScalarField;
+  generationParams: _contractspec_lib_schema747.EntityScalarField;
+  adaptationHistory: _contractspec_lib_schema747.EntityScalarField;
+  isActive: _contractspec_lib_schema747.EntityScalarField;
+  isCompleted: _contractspec_lib_schema747.EntityScalarField;
+  startedAt: _contractspec_lib_schema747.EntityScalarField;
+  completedAt: _contractspec_lib_schema747.EntityScalarField;
+  estimatedCompletionDate: _contractspec_lib_schema747.EntityScalarField;
+  createdAt: _contractspec_lib_schema747.EntityScalarField;
+  updatedAt: _contractspec_lib_schema747.EntityScalarField;
+  learner: _contractspec_lib_schema747.EntityRelationField;
+}>;
+/**
+ * Recommendation entity - AI-powered learning recommendations.
+ */
+declare const RecommendationEntity: _contractspec_lib_schema747.EntitySpec<{
+  id: _contractspec_lib_schema747.EntityScalarField;
+  learnerId: _contractspec_lib_schema747.EntityScalarField;
+  type: _contractspec_lib_schema747.EntityEnumField;
+  itemId: _contractspec_lib_schema747.EntityScalarField;
+  itemType: _contractspec_lib_schema747.EntityScalarField;
+  score: _contractspec_lib_schema747.EntityScalarField;
+  confidence: _contractspec_lib_schema747.EntityScalarField;
+  reason: _contractspec_lib_schema747.EntityScalarField;
+  factors: _contractspec_lib_schema747.EntityScalarField;
+  status: _contractspec_lib_schema747.EntityScalarField;
+  viewedAt: _contractspec_lib_schema747.EntityScalarField;
+  acceptedAt: _contractspec_lib_schema747.EntityScalarField;
+  dismissedAt: _contractspec_lib_schema747.EntityScalarField;
+  feedback: _contractspec_lib_schema747.EntityScalarField;
+  feedbackRating: _contractspec_lib_schema747.EntityScalarField;
+  expiresAt: _contractspec_lib_schema747.EntityScalarField;
+  createdAt: _contractspec_lib_schema747.EntityScalarField;
+  updatedAt: _contractspec_lib_schema747.EntityScalarField;
+  learner: _contractspec_lib_schema747.EntityRelationField;
+}>;
+/**
+ * LearningGap entity - identified knowledge gaps.
+ */
+declare const LearningGapEntity: _contractspec_lib_schema747.EntitySpec<{
+  id: _contractspec_lib_schema747.EntityScalarField;
+  learnerId: _contractspec_lib_schema747.EntityScalarField;
+  skillId: _contractspec_lib_schema747.EntityScalarField;
+  skillName: _contractspec_lib_schema747.EntityScalarField;
+  severity: _contractspec_lib_schema747.EntityScalarField;
+  confidence: _contractspec_lib_schema747.EntityScalarField;
+  evidence: _contractspec_lib_schema747.EntityScalarField;
+  relatedQuestions: _contractspec_lib_schema747.EntityScalarField;
+  suggestedRemediation: _contractspec_lib_schema747.EntityScalarField;
+  remediationProgress: _contractspec_lib_schema747.EntityScalarField;
+  status: _contractspec_lib_schema747.EntityScalarField;
+  resolvedAt: _contractspec_lib_schema747.EntityScalarField;
+  detectedAt: _contractspec_lib_schema747.EntityScalarField;
+  createdAt: _contractspec_lib_schema747.EntityScalarField;
+  updatedAt: _contractspec_lib_schema747.EntityScalarField;
+  learner: _contractspec_lib_schema747.EntityRelationField;
+}>;
+declare const aiEntities: (_contractspec_lib_schema747.EntitySpec<{
+  id: _contractspec_lib_schema747.EntityScalarField;
+  learnerId: _contractspec_lib_schema747.EntityScalarField;
+  learningStyle: _contractspec_lib_schema747.EntityEnumField;
+  preferredDifficulty: _contractspec_lib_schema747.EntityScalarField;
+  preferredSessionLength: _contractspec_lib_schema747.EntityScalarField;
+  interests: _contractspec_lib_schema747.EntityScalarField;
+  goals: _contractspec_lib_schema747.EntityScalarField;
+  pacePreference: _contractspec_lib_schema747.EntityScalarField;
+  bestTimeOfDay: _contractspec_lib_schema747.EntityScalarField;
+  averageSessionLength: _contractspec_lib_schema747.EntityScalarField;
+  daysActivePerWeek: _contractspec_lib_schema747.EntityScalarField;
+  avgQuizScore: _contractspec_lib_schema747.EntityScalarField;
+  avgLessonCompletionTime: _contractspec_lib_schema747.EntityScalarField;
+  strengths: _contractspec_lib_schema747.EntityScalarField;
+  weaknesses: _contractspec_lib_schema747.EntityScalarField;
+  lastAnalyzedAt: _contractspec_lib_schema747.EntityScalarField;
+  metadata: _contractspec_lib_schema747.EntityScalarField;
+  createdAt: _contractspec_lib_schema747.EntityScalarField;
+  updatedAt: _contractspec_lib_schema747.EntityScalarField;
+  learner: _contractspec_lib_schema747.EntityRelationField;
+}> | _contractspec_lib_schema747.EntitySpec<{
+  id: _contractspec_lib_schema747.EntityScalarField;
+  learnerId: _contractspec_lib_schema747.EntityScalarField;
+  skillId: _contractspec_lib_schema747.EntityScalarField;
+  skillName: _contractspec_lib_schema747.EntityScalarField;
+  skillCategory: _contractspec_lib_schema747.EntityScalarField;
+  level: _contractspec_lib_schema747.EntityScalarField;
+  confidence: _contractspec_lib_schema747.EntityScalarField;
+  lessonsCompleted: _contractspec_lib_schema747.EntityScalarField;
+  quizzesCompleted: _contractspec_lib_schema747.EntityScalarField;
+  practiceTime: _contractspec_lib_schema747.EntityScalarField;
+  lastPracticedAt: _contractspec_lib_schema747.EntityScalarField;
+  learningVelocity: _contractspec_lib_schema747.EntityScalarField;
+  predictedTimeToMastery: _contractspec_lib_schema747.EntityScalarField;
+  createdAt: _contractspec_lib_schema747.EntityScalarField;
+  updatedAt: _contractspec_lib_schema747.EntityScalarField;
+  learner: _contractspec_lib_schema747.EntityRelationField;
+}> | _contractspec_lib_schema747.EntitySpec<{
+  id: _contractspec_lib_schema747.EntityScalarField;
+  learnerId: _contractspec_lib_schema747.EntityScalarField;
+  name: _contractspec_lib_schema747.EntityScalarField;
+  description: _contractspec_lib_schema747.EntityScalarField;
+  goal: _contractspec_lib_schema747.EntityScalarField;
+  steps: _contractspec_lib_schema747.EntityScalarField;
+  currentStepIndex: _contractspec_lib_schema747.EntityScalarField;
+  progress: _contractspec_lib_schema747.EntityScalarField;
+  completedSteps: _contractspec_lib_schema747.EntityScalarField;
+  totalSteps: _contractspec_lib_schema747.EntityScalarField;
+  generatedAt: _contractspec_lib_schema747.EntityScalarField;
+  adaptedFrom: _contractspec_lib_schema747.EntityScalarField;
+  generationParams: _contractspec_lib_schema747.EntityScalarField;
+  adaptationHistory: _contractspec_lib_schema747.EntityScalarField;
+  isActive: _contractspec_lib_schema747.EntityScalarField;
+  isCompleted: _contractspec_lib_schema747.EntityScalarField;
+  startedAt: _contractspec_lib_schema747.EntityScalarField;
+  completedAt: _contractspec_lib_schema747.EntityScalarField;
+  estimatedCompletionDate: _contractspec_lib_schema747.EntityScalarField;
+  createdAt: _contractspec_lib_schema747.EntityScalarField;
+  updatedAt: _contractspec_lib_schema747.EntityScalarField;
+  learner: _contractspec_lib_schema747.EntityRelationField;
+}> | _contractspec_lib_schema747.EntitySpec<{
+  id: _contractspec_lib_schema747.EntityScalarField;
+  learnerId: _contractspec_lib_schema747.EntityScalarField;
+  type: _contractspec_lib_schema747.EntityEnumField;
+  itemId: _contractspec_lib_schema747.EntityScalarField;
+  itemType: _contractspec_lib_schema747.EntityScalarField;
+  score: _contractspec_lib_schema747.EntityScalarField;
+  confidence: _contractspec_lib_schema747.EntityScalarField;
+  reason: _contractspec_lib_schema747.EntityScalarField;
+  factors: _contractspec_lib_schema747.EntityScalarField;
+  status: _contractspec_lib_schema747.EntityScalarField;
+  viewedAt: _contractspec_lib_schema747.EntityScalarField;
+  acceptedAt: _contractspec_lib_schema747.EntityScalarField;
+  dismissedAt: _contractspec_lib_schema747.EntityScalarField;
+  feedback: _contractspec_lib_schema747.EntityScalarField;
+  feedbackRating: _contractspec_lib_schema747.EntityScalarField;
+  expiresAt: _contractspec_lib_schema747.EntityScalarField;
+  createdAt: _contractspec_lib_schema747.EntityScalarField;
+  updatedAt: _contractspec_lib_schema747.EntityScalarField;
+  learner: _contractspec_lib_schema747.EntityRelationField;
+}> | _contractspec_lib_schema747.EntitySpec<{
+  id: _contractspec_lib_schema747.EntityScalarField;
+  learnerId: _contractspec_lib_schema747.EntityScalarField;
+  skillId: _contractspec_lib_schema747.EntityScalarField;
+  skillName: _contractspec_lib_schema747.EntityScalarField;
+  severity: _contractspec_lib_schema747.EntityScalarField;
+  confidence: _contractspec_lib_schema747.EntityScalarField;
+  evidence: _contractspec_lib_schema747.EntityScalarField;
+  relatedQuestions: _contractspec_lib_schema747.EntityScalarField;
+  suggestedRemediation: _contractspec_lib_schema747.EntityScalarField;
+  remediationProgress: _contractspec_lib_schema747.EntityScalarField;
+  status: _contractspec_lib_schema747.EntityScalarField;
+  resolvedAt: _contractspec_lib_schema747.EntityScalarField;
+  detectedAt: _contractspec_lib_schema747.EntityScalarField;
+  createdAt: _contractspec_lib_schema747.EntityScalarField;
+  updatedAt: _contractspec_lib_schema747.EntityScalarField;
+  learner: _contractspec_lib_schema747.EntityRelationField;
+}>)[];
+declare const aiEnums: _contractspec_lib_schema747.EntityEnumDef[];
+//#endregion
+export { LearnerProfileEntity, LearningGapEntity, LearningPathEntity, LearningStyleEnum, RecommendationEntity, RecommendationTypeEnum, SkillMapEntity, aiEntities, aiEnums };
+//# sourceMappingURL=ai.d.ts.map

package/dist/entities/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","names":[],"sources":["../../src/entities/ai.ts"],"sourcesContent":[],"mappings":";;;;;;AAUa,cAAA,iBAKX,EAAA,2BAAA,CAL4B,aAK5B;AAKF;AAiBA;;cAjBa,wBAYX,2BAAA,CAZiC;;;;cAiBtB,kDAAoB;MA2F/B,2BAAA,CAAA;;;;;;;;;;;;;;2DA3F+B;EAAA,cAAA,+CAAA;EAgGpB,QAAA,+CAoEX;EAAA,SAAA,+CAAA;;;;;;;cApEW,4CAAc;MAoEzB,2BAAA,CAAA;;;;;;;;iEApEyB;EAAA,YAAA,+CAAA;EAyEd,eAAA,+CAgFX;EAAA,gBAAA,+CAAA;;;;;;;;;cAhFW,gDAAkB;MAgF7B,2BAAA,CAAA;;;;;;;;;;;;iEAhF6B;EAAA,iBAAA,+CAAA;EAqFlB,QAAA,+CAwEX;EAAA,WAAA,+CAAA;;;;;;;;;;;cAxEW,kDAAoB;MAwE/B,2BAAA,CAAA;;;;;;;uDAxE+B;EAAA,OAAA,+CAAA;EA6EpB,MAAA,+CA8DX;EAAA,QAAA,+CAAA;;;;;;;;;;;;;cA9DW,+CAAiB;MA8D5B,2BAAA,CAAA;;wDA9D4B;EAAA,SAAA,+CAAA;EAgEjB,QAAA,+CAMZ;EAAA,UAAA,+CAAA;;;;;;;;;;;;cANY,yCAAU;MAMtB,2BAAA,CAAA;;;;;;;+DANsB;EAAA,aAAA,+CAAA;;;;;;;;;;;;;MAAA,2BAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQV,UAAqD,+CAA9C;;;;;;;;;;;;cAAP,SAAqD,2BAAA,CAA9C,aAAA"}