@contractspec/example.learning-journey-duo-drills 1.44.0

package/src/track.test.ts

@@ -0,0 +1,106 @@
+import { describe, expect, it } from 'bun:test';
+
+import { drillsLanguageBasicsTrack } from './track';
+
+interface TestEvent {
+  name: string;
+  payload?: Record<string, unknown>;
+  occurredAt?: Date;
+}
+
+const matchesFilter = (
+  filter: Record<string, unknown> | undefined,
+  payload: Record<string, unknown> | undefined
+) => {
+  if (!filter) return true;
+  if (!payload) return false;
+  return Object.entries(filter).every(([key, value]) => payload[key] === value);
+};
+
+interface StepState {
+  id: string;
+  status: 'PENDING' | 'COMPLETED';
+  occurrences: number;
+  masteryCount: number;
+}
+
+describe('duo drills track', () => {
+  it('advances on session completion, accuracy counts, and SRS mastery', () => {
+    const events: TestEvent[] = [
+      {
+        name: 'drill.session.completed',
+        payload: { accuracyBucket: 'high' },
+      },
+      {
+        name: 'drill.session.completed',
+        payload: { accuracyBucket: 'high' },
+      },
+      {
+        name: 'drill.session.completed',
+        payload: { accuracyBucket: 'high' },
+      },
+      ...Array.from({ length: 5 }).map<TestEvent>(() => ({
+        name: 'drill.card.mastered',
+        payload: { skillId: 'language_basics', mastery: 0.9 },
+      })),
+    ];
+
+    const progress: StepState[] =
+      drillsLanguageBasicsTrack.steps.map<StepState>((step) => ({
+        id: step.id,
+        status: 'PENDING',
+        occurrences: 0,
+        masteryCount: 0,
+      }));
+
+    events.forEach((event) => {
+      drillsLanguageBasicsTrack.steps.forEach((stepSpec, index) => {
+        const step = progress[index];
+        if (!step || step.status === 'COMPLETED') return;
+        const completion = stepSpec.completion;
+        if ((completion.kind ?? 'event') === 'event') {
+          if (completion.eventName !== event.name) return;
+          if (
+            matchesFilter(
+              completion.payloadFilter,
+              event.payload as Record<string, unknown> | undefined
+            )
+          ) {
+            step.status = 'COMPLETED';
+          }
+          return;
+        }
+        if (completion.kind === 'count') {
+          if (
+            completion.eventName === event.name &&
+            matchesFilter(
+              completion.payloadFilter,
+              event.payload as Record<string, unknown> | undefined
+            )
+          ) {
+            step.occurrences = step.occurrences + 1;
+            if (step.occurrences >= completion.atLeast) {
+              step.status = 'COMPLETED';
+            }
+          }
+          return;
+        }
+        if (completion.kind === 'srs_mastery') {
+          if (completion.eventName !== event.name) return;
+          if (!matchesFilter(completion.payloadFilter, event.payload)) return;
+          const masteryValue = (
+            event.payload as Record<string, unknown> | undefined
+          )?.[completion.masteryField ?? 'mastery'];
+          if (typeof masteryValue !== 'number') return;
+          if (masteryValue < completion.minimumMastery) return;
+          step.masteryCount = step.masteryCount + 1;
+          if (step.masteryCount >= (completion.requiredCount ?? 1)) {
+            step.status = 'COMPLETED';
+          }
+        }
+      });
+    });
+
+    expect(progress.every((s) => s.status === 'COMPLETED')).toBeTrue();
+  });
+});

package/src/track.ts

@@ -0,0 +1,62 @@
+import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';
+
+export const drillsLanguageBasicsTrack: LearningJourneyTrackSpec = {
+  id: 'drills_language_basics',
+  name: 'Language Basics Drills',
+  description:
+    'Short SRS-driven drills to master a first skill, modeled after Duolingo-style sessions.',
+  targetUserSegment: 'learner',
+  targetRole: 'individual',
+  totalXp: 50,
+  completionRewards: { xpBonus: 25 },
+  steps: [
+    {
+      id: 'complete_first_session',
+      title: 'Complete first drill session',
+      description: 'Finish a drill session to get started.',
+      order: 1,
+      completion: {
+        kind: 'event',
+        eventName: 'drill.session.completed',
+      },
+      xpReward: 20,
+      metadata: { surface: 'drills' },
+    },
+    {
+      id: 'reach_accuracy_threshold',
+      title: 'Hit high accuracy in sessions',
+      description: 'Achieve three high-accuracy sessions to build confidence.',
+      order: 2,
+      completion: {
+        kind: 'count',
+        eventName: 'drill.session.completed',
+        atLeast: 3,
+        payloadFilter: { accuracyBucket: 'high' },
+      },
+      xpReward: 30,
+      metadata: { metric: 'accuracy', target: '>=85%' },
+    },
+    {
+      id: 'unlock_new_skill',
+      title: 'Master core cards in first skill',
+      description:
+        'Reach mastery on at least five cards in the first skill to unlock the next one.',
+      order: 3,
+      completion: {
+        kind: 'srs_mastery',
+        eventName: 'drill.card.mastered',
+        minimumMastery: 0.8,
+        requiredCount: 5,
+        skillIdField: 'skillId',
+        masteryField: 'mastery',
+        payloadFilter: { skillId: 'language_basics' },
+      },
+      xpReward: 40,
+      metadata: { surface: 'srs', skill: 'language_basics' },
+    },
+  ],
+};
+
+export const drillTracks: LearningJourneyTrackSpec[] = [
+  drillsLanguageBasicsTrack,
+];

package/tsconfig.json

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