@contractspec/example.learning-patterns 1.56.1 → 1.58.0

package/.turbo/turbo-build.log

@@ -1,40 +1,44 @@
-$ bun build:types && bun build:bundle
-$ tsc --noEmit
-$ tsdown
-ℹ tsdown v0.19.0 powered by rolldown v1.0.0-beta.59
-ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-patterns/tsdown.config.js 
-ℹ entry: src/events.ts, src/example.ts, src/index.ts, src/docs/index.ts, src/docs/learning-patterns.docblock.ts, src/tracks/ambient-coach.ts, src/tracks/drills.ts, src/tracks/index.ts, src/tracks/quests.ts
-ℹ target: esnext
-ℹ tsconfig: tsconfig.json
-ℹ Build start
-ℹ dist/tracks/drills.js                        1.21 kB │ gzip: 0.59 kB
-ℹ dist/docs/learning-patterns.docblock.js      1.15 kB │ gzip: 0.57 kB
-ℹ dist/tracks/quests.js                        1.11 kB │ gzip: 0.48 kB
-ℹ dist/tracks/ambient-coach.js                 1.07 kB │ gzip: 0.48 kB
-ℹ dist/example.js                              0.92 kB │ gzip: 0.49 kB
-ℹ dist/events.js                               0.53 kB │ gzip: 0.31 kB
-ℹ dist/index.js                                0.50 kB │ gzip: 0.20 kB
-ℹ dist/tracks/index.js                         0.29 kB │ gzip: 0.12 kB
-ℹ dist/docs/index.js                           0.04 kB │ gzip: 0.06 kB
-ℹ dist/tracks/drills.js.map                    2.05 kB │ gzip: 0.84 kB
-ℹ dist/tracks/quests.js.map                    1.87 kB │ gzip: 0.73 kB
-ℹ dist/tracks/ambient-coach.js.map             1.77 kB │ gzip: 0.73 kB
-ℹ dist/docs/learning-patterns.docblock.js.map  1.65 kB │ gzip: 0.74 kB
-ℹ dist/example.js.map                          1.35 kB │ gzip: 0.68 kB
-ℹ dist/events.js.map                           0.82 kB │ gzip: 0.45 kB
-ℹ dist/events.d.ts.map                         0.20 kB │ gzip: 0.16 kB
-ℹ dist/tracks/ambient-coach.d.ts.map           0.16 kB │ gzip: 0.14 kB
-ℹ dist/tracks/drills.d.ts.map                  0.14 kB │ gzip: 0.13 kB
-ℹ dist/tracks/quests.d.ts.map                  0.14 kB │ gzip: 0.13 kB
-ℹ dist/example.d.ts.map                        0.14 kB │ gzip: 0.13 kB
-ℹ dist/events.d.ts                             0.73 kB │ gzip: 0.36 kB
-ℹ dist/index.d.ts                              0.46 kB │ gzip: 0.19 kB
-ℹ dist/tracks/ambient-coach.d.ts               0.36 kB │ gzip: 0.20 kB
-ℹ dist/tracks/drills.d.ts                      0.32 kB │ gzip: 0.19 kB
-ℹ dist/tracks/quests.d.ts                      0.32 kB │ gzip: 0.19 kB
-ℹ dist/tracks/index.d.ts                       0.29 kB │ gzip: 0.12 kB
-ℹ dist/example.d.ts                            0.25 kB │ gzip: 0.17 kB
-ℹ dist/docs/index.d.ts                         0.01 kB │ gzip: 0.03 kB
-ℹ dist/docs/learning-patterns.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
-ℹ 29 files, total: 19.87 kB
-✔ Build complete in 22131ms
+$ contractspec-bun-build prebuild
+$ bun run prebuild && bun run build:bundle && bun run build:types
+$ contractspec-bun-build prebuild
+$ contractspec-bun-build transpile
+[contractspec-bun-build] transpile target=bun root=src entries=9
+Bundled 9 modules in 35ms
+
+  docs/index.js                        1.15 KB    (entry point)
+  ./index.js                           5.81 KB    (entry point)
+  docs/learning-patterns.docblock.js   1.15 KB    (entry point)
+  ./example.js                         0.89 KB    (entry point)
+  tracks/index.js                      3.78 KB    (entry point)
+  tracks/quests.js                     1.53 KB    (entry point)
+  tracks/ambient-coach.js              1.51 KB    (entry point)
+  tracks/drills.js                     1.70 KB    (entry point)
+  ./events.js                          496 bytes  (entry point)
+
+[contractspec-bun-build] transpile target=node root=src entries=9
+Bundled 9 modules in 20ms
+
+  docs/index.js                        1.13 KB    (entry point)
+  ./index.js                           5.80 KB    (entry point)
+  docs/learning-patterns.docblock.js   1.13 KB    (entry point)
+  ./example.js                         0.88 KB    (entry point)
+  tracks/index.js                      3.78 KB    (entry point)
+  tracks/quests.js                     1.53 KB    (entry point)
+  tracks/ambient-coach.js              1.50 KB    (entry point)
+  tracks/drills.js                     1.69 KB    (entry point)
+  ./events.js                          488 bytes  (entry point)
+
+[contractspec-bun-build] transpile target=browser root=src entries=9
+Bundled 9 modules in 20ms
+
+  docs/index.js                        1.13 KB    (entry point)
+  ./index.js                           5.80 KB    (entry point)
+  docs/learning-patterns.docblock.js   1.13 KB    (entry point)
+  ./example.js                         0.88 KB    (entry point)
+  tracks/index.js                      3.78 KB    (entry point)
+  tracks/quests.js                     1.53 KB    (entry point)
+  tracks/ambient-coach.js              1.50 KB    (entry point)
+  tracks/drills.js                     1.69 KB    (entry point)
+  ./events.js                          488 bytes  (entry point)
+
+$ contractspec-bun-build types

package/.turbo/turbo-prebuild.log

@@ -0,0 +1 @@
+$ contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @contractspec/example.learning-patterns
 
+## 1.58.0
+
+### Minor Changes
+
+- d1f0fd0: chore: Migrate non-app package builds from tsdown to shared Bun tooling, add `@contractspec/tool.bun`, and standardize `prebuild`/`build`/`typecheck` with platform-aware exports and `tsc` declaration emission into `dist`.
+
+### Patch Changes
+
+- Updated dependencies [d1f0fd0]
+- Updated dependencies [4355a9e]
+  - @contractspec/module.learning-journey@1.58.0
+  - @contractspec/lib.contracts@1.58.0
+
+## 1.57.0
+
+### Minor Changes
+
+- 11a5a05: feat: improve product intent
+
+### Patch Changes
+
+- Updated dependencies [8ecf3c1]
+- Updated dependencies [47c48c2]
+- Updated dependencies [a119963]
+- Updated dependencies [4651e06]
+- Updated dependencies [ad9d10a]
+- Updated dependencies [11a5a05]
+  - @contractspec/lib.contracts@1.57.0
+  - @contractspec/module.learning-journey@1.57.0
+
 ## 1.56.1
 
 ### Patch Changes

package/dist/browser/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/browser/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/browser/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/browser/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/browser/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/browser/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
+};

package/dist/browser/tracks/drills.js

@@ -0,0 +1,65 @@
+// 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/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];
+export {
+  drillsTrack,
+  drillTracks
+};