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

package/dist/tracks/ambient-coach.js

@@ -0,0 +1,48 @@
+import { LEARNING_EVENTS } from "../events.js";
+
+//#region src/tracks/ambient-coach.ts
+const ambientCoachTrack = {
+	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
+		}
+	]
+};
+const ambientCoachTracks = [ambientCoachTrack];
+
+//#endregion
+export { ambientCoachTrack, ambientCoachTracks };
+//# sourceMappingURL=ambient-coach.js.map

package/dist/tracks/ambient-coach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambient-coach.js","names":[],"sources":["../../src/tracks/ambient-coach.ts"],"sourcesContent":["import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';\nimport { LEARNING_EVENTS } from '../events';\n\nexport const ambientCoachTrack: LearningJourneyTrackSpec = {\n  id: 'learning_patterns_ambient_coach_basics',\n  name: 'Ambient Coach Basics',\n  description: 'Contextual tips triggered by behavior events.',\n  targetUserSegment: 'learner',\n  targetRole: 'individual',\n  totalXp: 30,\n  steps: [\n    {\n      id: 'tip_shown',\n      title: 'See a contextual tip',\n      order: 1,\n      completion: { kind: 'event', eventName: LEARNING_EVENTS.COACH_TIP_SHOWN },\n      xpReward: 10,\n    },\n    {\n      id: 'tip_acknowledged',\n      title: 'Acknowledge a tip',\n      order: 2,\n      completion: {\n        kind: 'event',\n        eventName: LEARNING_EVENTS.COACH_TIP_ACKNOWLEDGED,\n      },\n      xpReward: 10,\n    },\n    {\n      id: 'tip_action_taken',\n      title: 'Take an action from a tip',\n      order: 3,\n      completion: {\n        kind: 'event',\n        eventName: LEARNING_EVENTS.COACH_TIP_ACTION_TAKEN,\n      },\n      xpReward: 10,\n    },\n  ],\n};\n\nexport const ambientCoachTracks: LearningJourneyTrackSpec[] = [\n  ambientCoachTrack,\n];\n"],"mappings":";;;AAGA,MAAa,oBAA8C;CACzD,IAAI;CACJ,MAAM;CACN,aAAa;CACb,mBAAmB;CACnB,YAAY;CACZ,SAAS;CACT,OAAO;EACL;GACE,IAAI;GACJ,OAAO;GACP,OAAO;GACP,YAAY;IAAE,MAAM;IAAS,WAAW,gBAAgB;IAAiB;GACzE,UAAU;GACX;EACD;GACE,IAAI;GACJ,OAAO;GACP,OAAO;GACP,YAAY;IACV,MAAM;IACN,WAAW,gBAAgB;IAC5B;GACD,UAAU;GACX;EACD;GACE,IAAI;GACJ,OAAO;GACP,OAAO;GACP,YAAY;IACV,MAAM;IACN,WAAW,gBAAgB;IAC5B;GACD,UAAU;GACX;EACF;CACF;AAED,MAAa,qBAAiD,CAC5D,kBACD"}

package/dist/tracks/drills.d.ts

@@ -0,0 +1,8 @@
+import { LearningJourneyTrackSpec } from "@contractspec/module.learning-journey/track-spec";
+
+//#region src/tracks/drills.d.ts
+declare const drillsTrack: LearningJourneyTrackSpec;
+declare const drillTracks: LearningJourneyTrackSpec[];
+//#endregion
+export { drillTracks, drillsTrack };
+//# sourceMappingURL=drills.d.ts.map

package/dist/tracks/drills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drills.d.ts","names":[],"sources":["../../src/tracks/drills.ts"],"sourcesContent":[],"mappings":";;;cAGa,aAAa;cA+Cb,aAAa"}

package/dist/tracks/drills.js

@@ -0,0 +1,54 @@
+import { LEARNING_EVENTS } from "../events.js";
+
+//#region src/tracks/drills.ts
+const drillsTrack = {
+	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: .8,
+				requiredCount: 5,
+				skillIdField: "skillId",
+				masteryField: "mastery"
+			},
+			xpReward: 20
+		}
+	]
+};
+const drillTracks = [drillsTrack];
+
+//#endregion
+export { drillTracks, drillsTrack };
+//# sourceMappingURL=drills.js.map

package/dist/tracks/drills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drills.js","names":[],"sources":["../../src/tracks/drills.ts"],"sourcesContent":["import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';\nimport { LEARNING_EVENTS } from '../events';\n\nexport const drillsTrack: LearningJourneyTrackSpec = {\n  id: 'learning_patterns_drills_basics',\n  name: 'Drills Basics',\n  description: 'Short drill sessions with an SRS-style mastery step.',\n  targetUserSegment: 'learner',\n  targetRole: 'individual',\n  totalXp: 50,\n  steps: [\n    {\n      id: 'complete_first_session',\n      title: 'Complete your first session',\n      order: 1,\n      completion: {\n        kind: 'event',\n        eventName: LEARNING_EVENTS.DRILL_SESSION_COMPLETED,\n      },\n      xpReward: 10,\n    },\n    {\n      id: 'hit_accuracy_threshold',\n      title: 'Hit high accuracy 3 times',\n      order: 2,\n      completion: {\n        kind: 'count',\n        eventName: LEARNING_EVENTS.DRILL_SESSION_COMPLETED,\n        atLeast: 3,\n        payloadFilter: { accuracyBucket: 'high' },\n      },\n      xpReward: 20,\n    },\n    {\n      id: 'master_cards',\n      title: 'Master 5 cards',\n      order: 3,\n      completion: {\n        kind: 'srs_mastery',\n        eventName: LEARNING_EVENTS.DRILL_CARD_MASTERED,\n        minimumMastery: 0.8,\n        requiredCount: 5,\n        skillIdField: 'skillId',\n        masteryField: 'mastery',\n      },\n      xpReward: 20,\n    },\n  ],\n};\n\nexport const drillTracks: LearningJourneyTrackSpec[] = [drillsTrack];\n"],"mappings":";;;AAGA,MAAa,cAAwC;CACnD,IAAI;CACJ,MAAM;CACN,aAAa;CACb,mBAAmB;CACnB,YAAY;CACZ,SAAS;CACT,OAAO;EACL;GACE,IAAI;GACJ,OAAO;GACP,OAAO;GACP,YAAY;IACV,MAAM;IACN,WAAW,gBAAgB;IAC5B;GACD,UAAU;GACX;EACD;GACE,IAAI;GACJ,OAAO;GACP,OAAO;GACP,YAAY;IACV,MAAM;IACN,WAAW,gBAAgB;IAC3B,SAAS;IACT,eAAe,EAAE,gBAAgB,QAAQ;IAC1C;GACD,UAAU;GACX;EACD;GACE,IAAI;GACJ,OAAO;GACP,OAAO;GACP,YAAY;IACV,MAAM;IACN,WAAW,gBAAgB;IAC3B,gBAAgB;IAChB,eAAe;IACf,cAAc;IACd,cAAc;IACf;GACD,UAAU;GACX;EACF;CACF;AAED,MAAa,cAA0C,CAAC,YAAY"}

package/dist/tracks/index.d.ts

@@ -0,0 +1,4 @@
+import { drillTracks, drillsTrack } from "./drills.js";
+import { ambientCoachTrack, ambientCoachTracks } from "./ambient-coach.js";
+import { questTrack, questTracks } from "./quests.js";
+export { ambientCoachTrack, ambientCoachTracks, drillTracks, drillsTrack, questTrack, questTracks };

package/dist/tracks/index.js

@@ -0,0 +1,5 @@
+import { drillTracks, drillsTrack } from "./drills.js";
+import { ambientCoachTrack, ambientCoachTracks } from "./ambient-coach.js";
+import { questTrack, questTracks } from "./quests.js";
+
+export { ambientCoachTrack, ambientCoachTracks, drillTracks, drillsTrack, questTrack, questTracks };

package/dist/tracks/quests.d.ts

@@ -0,0 +1,8 @@
+import { LearningJourneyTrackSpec } from "@contractspec/module.learning-journey/track-spec";
+
+//#region src/tracks/quests.d.ts
+declare const questTrack: LearningJourneyTrackSpec;
+declare const questTracks: LearningJourneyTrackSpec[];
+//#endregion
+export { questTrack, questTracks };
+//# sourceMappingURL=quests.d.ts.map

package/dist/tracks/quests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quests.d.ts","names":[],"sources":["../../src/tracks/quests.ts"],"sourcesContent":[],"mappings":";;;cAGa,YAAY;cAwCZ,aAAa"}

package/dist/tracks/quests.js

@@ -0,0 +1,56 @@
+import { LEARNING_EVENTS } from "../events.js";
+
+//#region src/tracks/quests.ts
+const questTrack = {
+	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
+		}
+	]
+};
+const questTracks = [questTrack];
+
+//#endregion
+export { questTrack, questTracks };
+//# sourceMappingURL=quests.js.map

package/dist/tracks/quests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quests.js","names":[],"sources":["../../src/tracks/quests.ts"],"sourcesContent":["import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';\nimport { LEARNING_EVENTS } from '../events';\n\nexport const questTrack: LearningJourneyTrackSpec = {\n  id: 'learning_patterns_quest_7day',\n  name: 'Quest (7-day)',\n  description: 'Time-bounded quest with day unlocks.',\n  targetUserSegment: 'learner',\n  targetRole: 'individual',\n  totalXp: 70,\n  steps: [\n    {\n      id: 'day1_start',\n      title: 'Start the quest',\n      order: 1,\n      completion: { kind: 'event', eventName: LEARNING_EVENTS.QUEST_STARTED },\n      xpReward: 10,\n    },\n    {\n      id: 'day1_complete',\n      title: 'Complete day 1 step',\n      order: 2,\n      completion: {\n        kind: 'event',\n        eventName: LEARNING_EVENTS.QUEST_STEP_COMPLETED,\n      },\n      availability: { unlockOnDay: 1, dueWithinHours: 48 },\n      xpReward: 10,\n    },\n    {\n      id: 'day2_complete',\n      title: 'Complete day 2 step',\n      order: 3,\n      completion: {\n        kind: 'event',\n        eventName: LEARNING_EVENTS.QUEST_STEP_COMPLETED,\n      },\n      availability: { unlockOnDay: 2, dueWithinHours: 48 },\n      xpReward: 10,\n    },\n  ],\n};\n\nexport const questTracks: LearningJourneyTrackSpec[] = [questTrack];\n"],"mappings":";;;AAGA,MAAa,aAAuC;CAClD,IAAI;CACJ,MAAM;CACN,aAAa;CACb,mBAAmB;CACnB,YAAY;CACZ,SAAS;CACT,OAAO;EACL;GACE,IAAI;GACJ,OAAO;GACP,OAAO;GACP,YAAY;IAAE,MAAM;IAAS,WAAW,gBAAgB;IAAe;GACvE,UAAU;GACX;EACD;GACE,IAAI;GACJ,OAAO;GACP,OAAO;GACP,YAAY;IACV,MAAM;IACN,WAAW,gBAAgB;IAC5B;GACD,cAAc;IAAE,aAAa;IAAG,gBAAgB;IAAI;GACpD,UAAU;GACX;EACD;GACE,IAAI;GACJ,OAAO;GACP,OAAO;GACP,YAAY;IACV,MAAM;IACN,WAAW,gBAAgB;IAC5B;GACD,cAAc;IAAE,aAAa;IAAG,gBAAgB;IAAI;GACpD,UAAU;GACX;EACF;CACF;AAED,MAAa,cAA0C,CAAC,WAAW"}

package/example.ts

@@ -0,0 +1 @@
+export { default } from './src/example';

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@contractspec/example.learning-patterns",
+  "version": "0.0.0-canary-20260113162409",
+  "description": "Example: drills + ambient coach + quests learning patterns, powered by Learning Journey (event-driven, deterministic).",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/learning-patterns.docblock": "./dist/docs/learning-patterns.docblock.js",
+    "./events": "./dist/events.js",
+    "./example": "./dist/example.js",
+    "./tracks": "./dist/tracks/index.js",
+    "./tracks/ambient-coach": "./dist/tracks/ambient-coach.js",
+    "./tracks/drills": "./dist/tracks/drills.js",
+    "./tracks/quests": "./dist/tracks/quests.js",
+    "./*": "./*"
+  },
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@contractspec/lib.contracts": "0.0.0-canary-20260113162409",
+    "@contractspec/module.learning-journey": "0.0.0-canary-20260113162409"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "0.0.0-canary-20260113162409",
+    "@contractspec/tool.typescript": "0.0.0-canary-20260113162409",
+    "tsdown": "^0.19.0",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/learning-patterns.docblock": "./dist/docs/learning-patterns.docblock.js",
+      "./events": "./dist/events.js",
+      "./example": "./dist/example.js",
+      "./tracks": "./dist/tracks/index.js",
+      "./tracks/ambient-coach": "./dist/tracks/ambient-coach.js",
+      "./tracks/drills": "./dist/tracks/drills.js",
+      "./tracks/quests": "./dist/tracks/quests.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/learning-patterns"
+  },
+  "homepage": "https://contractspec.io"
+}

package/src/docs/index.ts

@@ -0,0 +1 @@
+import './learning-patterns.docblock';

package/src/docs/learning-patterns.docblock.ts

@@ -0,0 +1,30 @@
+import type { DocBlock } from '@contractspec/lib.contracts/docs';
+import { registerDocBlocks } from '@contractspec/lib.contracts/docs';
+
+const docBlocks: DocBlock[] = [
+  {
+    id: 'docs.examples.learning-patterns.goal',
+    title: 'Learning Patterns — Goal',
+    summary:
+      'Domain-agnostic drills, ambient coaching, and quests built on Learning Journey.',
+    kind: 'goal',
+    visibility: 'public',
+    route: '/docs/examples/learning-patterns/goal',
+    tags: ['learning', 'drills', 'quests', 'coaching'],
+    body: `## Why it matters
+- Demonstrates multiple learning archetypes without vertical coupling.\n- Progress is event-driven (no client-side hacks).\n- SRS logic is deterministic and testable.`,
+  },
+  {
+    id: 'docs.examples.learning-patterns.reference',
+    title: 'Learning Patterns — Reference',
+    summary:
+      'Track specs and event names exported by the learning patterns example.',
+    kind: 'reference',
+    visibility: 'public',
+    route: '/docs/examples/learning-patterns',
+    tags: ['learning', 'reference'],
+    body: `## Tracks\n- Drills + SRS\n- Ambient Coach\n- Quests\n\n## Events\n- drill.*\n- coach.*\n- quest.*`,
+  },
+];
+
+registerDocBlocks(docBlocks);

package/src/events.ts

@@ -0,0 +1,16 @@
+export const LEARNING_EVENTS = {
+  DRILL_CARD_ANSWERED: 'drill.card.answered',
+  DRILL_SESSION_COMPLETED: 'drill.session.completed',
+  DRILL_CARD_MASTERED: 'drill.card.mastered',
+
+  COACH_TIP_TRIGGERED: 'coach.tip.triggered',
+  COACH_TIP_SHOWN: 'coach.tip.shown',
+  COACH_TIP_ACKNOWLEDGED: 'coach.tip.acknowledged',
+  COACH_TIP_ACTION_TAKEN: 'coach.tip.actionTaken',
+
+  QUEST_STARTED: 'quest.started',
+  QUEST_STEP_COMPLETED: 'quest.step.completed',
+} as const;
+
+export type LearningEventName =
+  (typeof LEARNING_EVENTS)[keyof typeof LEARNING_EVENTS];

package/src/example.ts

@@ -0,0 +1,31 @@
+import { defineExample } from '@contractspec/lib.contracts';
+
+const example = defineExample({
+  meta: {
+    key: 'learning-patterns',
+    version: '1.0.0',
+    title: 'Learning Patterns',
+    description:
+      'Domain-agnostic learning archetypes implemented as Learning Journey tracks.',
+    kind: 'library',
+    visibility: 'public',
+    stability: 'experimental',
+    owners: ['@platform.core'],
+    tags: ['learning', 'journey', 'patterns'],
+  },
+  docs: {
+    rootDocId: 'docs.examples.learning-patterns',
+  },
+  entrypoints: {
+    packageName: '@contractspec/example.learning-patterns',
+    docs: './docs',
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ['markdown', 'specs'] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true },
+  },
+});
+
+export default example;

package/src/index.ts

@@ -0,0 +1,10 @@
+/**
+ * Learning Patterns Example
+ *
+ * Domain-agnostic learning archetypes implemented as Learning Journey tracks.
+ */
+export * from './events';
+export * from './tracks';
+export { default as example } from './example';
+
+import './docs';

package/src/learning-patterns.test.ts

@@ -0,0 +1,256 @@
+import { describe, expect, it } from 'bun:test';
+
+import type {
+  LearningJourneyTrackSpec,
+  StepAvailabilitySpec,
+  StepCompletionConditionSpec,
+} from '@contractspec/module.learning-journey/track-spec';
+import { SRSEngine } from '@contractspec/module.learning-journey/engines/srs';
+import { StreakEngine } from '@contractspec/module.learning-journey/engines/streak';
+import { XPEngine } from '@contractspec/module.learning-journey/engines/xp';
+
+import { ambientCoachTrack } from './tracks/ambient-coach';
+import { drillsTrack } from './tracks/drills';
+import { questTrack } from './tracks/quests';
+import { LEARNING_EVENTS } from './events';
+
+interface LearningEvent {
+  name: string;
+  payload?: Record<string, unknown>;
+  occurredAt?: Date;
+}
+
+interface StepState {
+  id: string;
+  status: 'PENDING' | 'COMPLETED';
+  occurrences: number;
+  masteryCount: number;
+  availableAt?: Date;
+  dueAt?: Date;
+}
+
+const matchesFilter = (
+  filter: Record<string, unknown> | undefined,
+  payload: Record<string, unknown> | undefined
+): boolean => {
+  if (!filter) return true;
+  if (!payload) return false;
+  return Object.entries(filter).every(([k, v]) => payload[k] === v);
+};
+
+const getAvailability = (
+  availability: StepAvailabilitySpec | undefined,
+  startedAt: Date | undefined
+): { availableAt?: Date; dueAt?: Date } => {
+  if (!availability || !startedAt) return {};
+  const baseTime = startedAt.getTime();
+  let unlockTime = baseTime;
+  if (availability.unlockOnDay !== undefined) {
+    unlockTime =
+      baseTime + (availability.unlockOnDay - 1) * 24 * 60 * 60 * 1000;
+  }
+  if (availability.unlockAfterHours !== undefined) {
+    unlockTime = baseTime + availability.unlockAfterHours * 60 * 60 * 1000;
+  }
+  const availableAt = new Date(unlockTime);
+  const dueAt =
+    availability.dueWithinHours !== undefined
+      ? new Date(
+          availableAt.getTime() + availability.dueWithinHours * 60 * 60 * 1000
+        )
+      : undefined;
+  return { availableAt, dueAt };
+};
+
+const matchesCondition = (
+  condition: StepCompletionConditionSpec,
+  event: LearningEvent,
+  step: StepState
+): { matched: boolean; occurrences?: number; masteryCount?: number } => {
+  if ((condition.kind ?? 'event') === 'event') {
+    if (condition.eventName !== event.name) return { matched: false };
+    if (!matchesFilter(condition.payloadFilter, event.payload))
+      return { matched: false };
+    return { matched: true };
+  }
+  if (condition.kind === 'count') {
+    if (condition.eventName !== event.name) return { matched: false };
+    if (!matchesFilter(condition.payloadFilter, event.payload))
+      return { matched: false };
+    const occurrences = step.occurrences + 1;
+    return { matched: occurrences >= condition.atLeast, occurrences };
+  }
+  if (condition.kind === 'srs_mastery') {
+    if (condition.eventName !== event.name) return { matched: false };
+    if (!matchesFilter(condition.payloadFilter, event.payload))
+      return { matched: false };
+    const masteryKey = condition.masteryField ?? 'mastery';
+    const masteryValue = event.payload?.[masteryKey];
+    if (typeof masteryValue !== 'number') return { matched: false };
+    if (masteryValue < condition.minimumMastery) return { matched: false };
+    const masteryCount = step.masteryCount + 1;
+    const required = condition.requiredCount ?? 1;
+    return { matched: masteryCount >= required, masteryCount };
+  }
+  if (condition.kind === 'time_window') {
+    // For this example suite, we treat time_window as a direct match on eventName
+    if (condition.eventName !== event.name) return { matched: false };
+    return { matched: true };
+  }
+  return { matched: false };
+};
+
+function initProgress(track: LearningJourneyTrackSpec): StepState[] {
+  return track.steps.map((s) => ({
+    id: s.id,
+    status: 'PENDING',
+    occurrences: 0,
+    masteryCount: 0,
+  }));
+}
+
+function applyEvents(
+  track: LearningJourneyTrackSpec,
+  events: LearningEvent[]
+): StepState[] {
+  const steps = initProgress(track);
+  let startedAt: Date | undefined;
+  for (const event of events) {
+    const eventTime = event.occurredAt ?? new Date();
+    if (!startedAt) startedAt = eventTime;
+    for (let index = 0; index < track.steps.length; index++) {
+      const spec = track.steps[index];
+      const state = steps[index];
+      if (!spec || !state) continue;
+      if (state.status === 'COMPLETED') continue;
+      const { availableAt, dueAt } = getAvailability(
+        spec.availability,
+        startedAt
+      );
+      state.availableAt = availableAt;
+      state.dueAt = dueAt;
+      if (availableAt && eventTime < availableAt) continue;
+      if (dueAt && eventTime > dueAt) continue;
+      const res = matchesCondition(spec.completion, event, state);
+      if (res.occurrences !== undefined) state.occurrences = res.occurrences;
+      if (res.masteryCount !== undefined) state.masteryCount = res.masteryCount;
+      if (res.matched) state.status = 'COMPLETED';
+    }
+  }
+  return steps;
+}
+
+describe('@contractspec/example.learning-patterns tracks', () => {
+  it('drills track progresses via session count + mastery', () => {
+    const events: LearningEvent[] = [
+      { name: LEARNING_EVENTS.DRILL_SESSION_COMPLETED },
+      {
+        name: LEARNING_EVENTS.DRILL_SESSION_COMPLETED,
+        payload: { accuracyBucket: 'high' },
+      },
+      {
+        name: LEARNING_EVENTS.DRILL_SESSION_COMPLETED,
+        payload: { accuracyBucket: 'high' },
+      },
+      {
+        name: LEARNING_EVENTS.DRILL_SESSION_COMPLETED,
+        payload: { accuracyBucket: 'high' },
+      },
+      ...Array.from({ length: 5 }).map(() => ({
+        name: LEARNING_EVENTS.DRILL_CARD_MASTERED,
+        payload: { skillId: 's1', mastery: 0.9 },
+      })),
+    ];
+    const progress = applyEvents(drillsTrack, events);
+    expect(progress.every((s) => s.status === 'COMPLETED')).toBeTrue();
+  });
+
+  it('ambient coach track progresses via shown -> acknowledged -> actionTaken', () => {
+    const progress = applyEvents(ambientCoachTrack, [
+      { name: LEARNING_EVENTS.COACH_TIP_SHOWN },
+      { name: LEARNING_EVENTS.COACH_TIP_ACKNOWLEDGED },
+      { name: LEARNING_EVENTS.COACH_TIP_ACTION_TAKEN },
+    ]);
+    expect(progress.every((s) => s.status === 'COMPLETED')).toBeTrue();
+  });
+
+  it('quest track respects unlockOnDay availability', () => {
+    const start = new Date('2026-01-01T10:00:00.000Z');
+    const day1 = new Date('2026-01-01T12:00:00.000Z');
+    const day2 = new Date('2026-01-02T12:00:00.000Z');
+
+    // Attempt to complete steps on day1 (only day1 step should unlock)
+    const p1 = applyEvents(questTrack, [
+      { name: LEARNING_EVENTS.QUEST_STARTED, occurredAt: start },
+      { name: LEARNING_EVENTS.QUEST_STEP_COMPLETED, occurredAt: day1 },
+    ]);
+    expect(p1[0]?.status).toBe('COMPLETED');
+    expect(p1[1]?.status).toBe('COMPLETED');
+    expect(p1[2]?.status).toBe('PENDING'); // day2 step not yet available
+
+    // Now complete on day2
+    const p2 = applyEvents(questTrack, [
+      { name: LEARNING_EVENTS.QUEST_STARTED, occurredAt: start },
+      { name: LEARNING_EVENTS.QUEST_STEP_COMPLETED, occurredAt: day2 },
+    ]);
+    expect(p2[2]?.status).toBe('COMPLETED');
+  });
+});
+
+describe('@contractspec/example.learning-patterns XP + streak + SRS determinism', () => {
+  it('XP engine produces deterministic results for streak bonus inputs', () => {
+    const xp = new XPEngine();
+    const r1 = xp.calculate({
+      activity: 'lesson_complete',
+      score: 90,
+      attemptNumber: 1,
+      currentStreak: 7,
+    });
+    const r2 = xp.calculate({
+      activity: 'lesson_complete',
+      score: 90,
+      attemptNumber: 1,
+      currentStreak: 7,
+    });
+    expect(r1.totalXp).toBe(r2.totalXp);
+    expect(r1.totalXp).toBeGreaterThan(0);
+  });
+
+  it('streak engine increments on consecutive days deterministically', () => {
+    const streak = new StreakEngine({ timezone: 'UTC' });
+    const initial = {
+      currentStreak: 0,
+      longestStreak: 0,
+      lastActivityAt: null,
+      lastActivityDate: null,
+      freezesRemaining: 0,
+      freezeUsedAt: null,
+    };
+    const day1 = streak.update(
+      initial,
+      new Date('2026-01-01T10:00:00.000Z')
+    ).state;
+    const day2 = streak.update(
+      day1,
+      new Date('2026-01-02T10:00:00.000Z')
+    ).state;
+    expect(day2.currentStreak).toBe(2);
+  });
+
+  it('SRS engine nextReviewAt is deterministic for a fixed now + rating', () => {
+    const srs = new SRSEngine();
+    const now = new Date('2026-01-01T00:00:00.000Z');
+    const state = {
+      interval: 0,
+      easeFactor: 2.5,
+      repetitions: 0,
+      learningStep: 0,
+      isGraduated: false,
+      isRelearning: false,
+      lapses: 0,
+    };
+    const result = srs.calculateNextReview(state, 'GOOD', now);
+    // default learningSteps are minutes; first GOOD advances to next step (10 minutes)
+    expect(result.nextReviewAt.toISOString()).toBe('2026-01-01T00:10:00.000Z');
+  });
+});