@contractspec/example.learning-patterns 1.56.1 → 1.58.0

package/dist/index.js

@@ -1,9 +1,222 @@
-import { LEARNING_EVENTS } from "./events.js";
-import example_default from "./example.js";
-import { drillTracks, drillsTrack } from "./tracks/drills.js";
-import { ambientCoachTrack, ambientCoachTracks } from "./tracks/ambient-coach.js";
-import { questTrack, questTracks } from "./tracks/quests.js";
-import "./tracks/index.js";
-import "./docs/index.js";
-
-export { LEARNING_EVENTS, ambientCoachTrack, ambientCoachTracks, drillTracks, drillsTrack, example_default as example, questTrack, questTracks };
+// @bun
+// src/docs/learning-patterns.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var docBlocks = [
+  {
+    id: "docs.examples.learning-patterns.goal",
+    title: "Learning Patterns \u2014 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.
+- Progress is event-driven (no client-side hacks).
+- SRS logic is deterministic and testable.`
+  },
+  {
+    id: "docs.examples.learning-patterns.reference",
+    title: "Learning Patterns \u2014 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
+- Drills + SRS
+- Ambient Coach
+- Quests
+
+## Events
+- drill.*
+- coach.*
+- quest.*`
+  }
+];
+registerDocBlocks(docBlocks);
+// src/events.ts
+var 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"
+};
+
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var 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 }
+  }
+});
+var example_default = example;
+
+// src/tracks/drills.ts
+var 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: 0.8,
+        requiredCount: 5,
+        skillIdField: "skillId",
+        masteryField: "mastery"
+      },
+      xpReward: 20
+    }
+  ]
+};
+var drillTracks = [drillsTrack];
+
+// src/tracks/ambient-coach.ts
+var 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
+    }
+  ]
+};
+var ambientCoachTracks = [
+  ambientCoachTrack
+];
+
+// src/tracks/quests.ts
+var 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
+    }
+  ]
+};
+var questTracks = [questTrack];
+export {
+  questTracks,
+  questTrack,
+  example_default as example,
+  drillsTrack,
+  drillTracks,
+  ambientCoachTracks,
+  ambientCoachTrack,
+  LEARNING_EVENTS
+};

package/dist/learning-patterns.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=learning-patterns.test.d.ts.map

package/dist/learning-patterns.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-patterns.test.d.ts","sourceRoot":"","sources":["../src/learning-patterns.test.ts"],"names":[],"mappings":""}

package/dist/node/docs/index.js

@@ -0,0 +1,36 @@
+// src/docs/learning-patterns.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var docBlocks = [
+  {
+    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.
+- Progress is event-driven (no client-side hacks).
+- 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
+- Drills + SRS
+- Ambient Coach
+- Quests
+
+## Events
+- drill.*
+- coach.*
+- quest.*`
+  }
+];
+registerDocBlocks(docBlocks);

package/dist/node/docs/learning-patterns.docblock.js

@@ -0,0 +1,36 @@
+// src/docs/learning-patterns.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var docBlocks = [
+  {
+    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.
+- Progress is event-driven (no client-side hacks).
+- 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
+- Drills + SRS
+- Ambient Coach
+- Quests
+
+## Events
+- drill.*
+- coach.*
+- quest.*`
+  }
+];
+registerDocBlocks(docBlocks);

package/dist/node/events.js

@@ -0,0 +1,15 @@
+// src/events.ts
+var 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"
+};
+export {
+  LEARNING_EVENTS
+};

package/dist/node/example.js

@@ -0,0 +1,32 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var 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 }
+  }
+});
+var example_default = example;
+export {
+  example_default as default
+};

package/dist/node/index.js

@@ -0,0 +1,221 @@
+// src/docs/learning-patterns.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var docBlocks = [
+  {
+    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.
+- Progress is event-driven (no client-side hacks).
+- 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
+- Drills + SRS
+- Ambient Coach
+- Quests
+
+## Events
+- drill.*
+- coach.*
+- quest.*`
+  }
+];
+registerDocBlocks(docBlocks);
+// src/events.ts
+var 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"
+};
+
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var 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 }
+  }
+});
+var example_default = example;
+
+// src/tracks/drills.ts
+var 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: 0.8,
+        requiredCount: 5,
+        skillIdField: "skillId",
+        masteryField: "mastery"
+      },
+      xpReward: 20
+    }
+  ]
+};
+var drillTracks = [drillsTrack];
+
+// src/tracks/ambient-coach.ts
+var 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
+    }
+  ]
+};
+var ambientCoachTracks = [
+  ambientCoachTrack
+];
+
+// src/tracks/quests.ts
+var 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
+    }
+  ]
+};
+var questTracks = [questTrack];
+export {
+  questTracks,
+  questTrack,
+  example_default as example,
+  drillsTrack,
+  drillTracks,
+  ambientCoachTracks,
+  ambientCoachTrack,
+  LEARNING_EVENTS
+};

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

@@ -0,0 +1,58 @@
+// src/events.ts
+var 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"
+};
+
+// src/tracks/ambient-coach.ts
+var 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
+    }
+  ]
+};
+var ambientCoachTracks = [
+  ambientCoachTrack
+];
+export {
+  ambientCoachTracks,
+  ambientCoachTrack
+};