@contractspec/example.learning-patterns 0.0.0-canary-20260113162409

package/src/tracks/ambient-coach.ts

@@ -0,0 +1,44 @@
+import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';
+import { LEARNING_EVENTS } from '../events';
+
+export const ambientCoachTrack: LearningJourneyTrackSpec = {
+  id: 'learning_patterns_ambient_coach_basics',
+  name: 'Ambient Coach Basics',
+  description: 'Contextual tips triggered by behavior events.',
+  targetUserSegment: 'learner',
+  targetRole: 'individual',
+  totalXp: 30,
+  steps: [
+    {
+      id: 'tip_shown',
+      title: 'See a contextual tip',
+      order: 1,
+      completion: { kind: 'event', eventName: LEARNING_EVENTS.COACH_TIP_SHOWN },
+      xpReward: 10,
+    },
+    {
+      id: 'tip_acknowledged',
+      title: 'Acknowledge a tip',
+      order: 2,
+      completion: {
+        kind: 'event',
+        eventName: LEARNING_EVENTS.COACH_TIP_ACKNOWLEDGED,
+      },
+      xpReward: 10,
+    },
+    {
+      id: 'tip_action_taken',
+      title: 'Take an action from a tip',
+      order: 3,
+      completion: {
+        kind: 'event',
+        eventName: LEARNING_EVENTS.COACH_TIP_ACTION_TAKEN,
+      },
+      xpReward: 10,
+    },
+  ],
+};
+
+export const ambientCoachTracks: LearningJourneyTrackSpec[] = [
+  ambientCoachTrack,
+];

package/src/tracks/drills.ts

@@ -0,0 +1,51 @@
+import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';
+import { LEARNING_EVENTS } from '../events';
+
+export const drillsTrack: LearningJourneyTrackSpec = {
+  id: 'learning_patterns_drills_basics',
+  name: 'Drills Basics',
+  description: 'Short drill sessions with an SRS-style mastery step.',
+  targetUserSegment: 'learner',
+  targetRole: 'individual',
+  totalXp: 50,
+  steps: [
+    {
+      id: 'complete_first_session',
+      title: 'Complete your first session',
+      order: 1,
+      completion: {
+        kind: 'event',
+        eventName: LEARNING_EVENTS.DRILL_SESSION_COMPLETED,
+      },
+      xpReward: 10,
+    },
+    {
+      id: 'hit_accuracy_threshold',
+      title: 'Hit high accuracy 3 times',
+      order: 2,
+      completion: {
+        kind: 'count',
+        eventName: LEARNING_EVENTS.DRILL_SESSION_COMPLETED,
+        atLeast: 3,
+        payloadFilter: { accuracyBucket: 'high' },
+      },
+      xpReward: 20,
+    },
+    {
+      id: 'master_cards',
+      title: 'Master 5 cards',
+      order: 3,
+      completion: {
+        kind: 'srs_mastery',
+        eventName: LEARNING_EVENTS.DRILL_CARD_MASTERED,
+        minimumMastery: 0.8,
+        requiredCount: 5,
+        skillIdField: 'skillId',
+        masteryField: 'mastery',
+      },
+      xpReward: 20,
+    },
+  ],
+};
+
+export const drillTracks: LearningJourneyTrackSpec[] = [drillsTrack];

package/src/tracks/index.ts

@@ -0,0 +1,3 @@
+export * from './drills';
+export * from './ambient-coach';
+export * from './quests';

package/src/tracks/quests.ts

@@ -0,0 +1,44 @@
+import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';
+import { LEARNING_EVENTS } from '../events';
+
+export const questTrack: LearningJourneyTrackSpec = {
+  id: 'learning_patterns_quest_7day',
+  name: 'Quest (7-day)',
+  description: 'Time-bounded quest with day unlocks.',
+  targetUserSegment: 'learner',
+  targetRole: 'individual',
+  totalXp: 70,
+  steps: [
+    {
+      id: 'day1_start',
+      title: 'Start the quest',
+      order: 1,
+      completion: { kind: 'event', eventName: LEARNING_EVENTS.QUEST_STARTED },
+      xpReward: 10,
+    },
+    {
+      id: 'day1_complete',
+      title: 'Complete day 1 step',
+      order: 2,
+      completion: {
+        kind: 'event',
+        eventName: LEARNING_EVENTS.QUEST_STEP_COMPLETED,
+      },
+      availability: { unlockOnDay: 1, dueWithinHours: 48 },
+      xpReward: 10,
+    },
+    {
+      id: 'day2_complete',
+      title: 'Complete day 2 step',
+      order: 3,
+      completion: {
+        kind: 'event',
+        eventName: LEARNING_EVENTS.QUEST_STEP_COMPLETED,
+      },
+      availability: { unlockOnDay: 2, dueWithinHours: 48 },
+      xpReward: 10,
+    },
+  ],
+};
+
+export const questTracks: LearningJourneyTrackSpec[] = [questTrack];

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "extends": "@contractspec/tool.typescript/react-library.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}
+
+
+
+
+
+
+
+
+
+