@contractspec/example.learning-journey-duo-drills 3.7.19 → 4.0.1

package/.turbo/turbo-build.log

@@ -1,34 +1,35 @@
-$ contractspec-bun-build prebuild
-$ bun run build:bundle && bun run build:types
-$ contractspec-bun-build transpile
-[contractspec-bun-build] transpile target=bun root=src entries=6 noBundle=false
-Bundled 6 modules in 27ms
-
-  docs/duo-drills.docblock.js               1.30 KB    (entry point)
-  ./index.js                                3.74 KB    (entry point)
-  docs/index.js                             1.30 KB    (entry point)
-  ./example.js                              0.73 KB    (entry point)
-  ./learning-journey-duo-drills.feature.js  461 bytes  (entry point)
-  ./track.js                                1.30 KB    (entry point)
-
-[contractspec-bun-build] transpile target=node root=src entries=6 noBundle=false
-Bundled 6 modules in 31ms
-
-  docs/duo-drills.docblock.js               1.28 KB    (entry point)
-  ./index.js                                3.72 KB    (entry point)
-  docs/index.js                             1.28 KB    (entry point)
-  ./example.js                              0.72 KB    (entry point)
-  ./learning-journey-duo-drills.feature.js  453 bytes  (entry point)
-  ./track.js                                1.29 KB    (entry point)
-
-[contractspec-bun-build] transpile target=browser root=src entries=6 noBundle=false
-Bundled 6 modules in 23ms
-
-  docs/duo-drills.docblock.js               1.28 KB    (entry point)
-  ./index.js                                3.72 KB    (entry point)
-  docs/index.js                             1.28 KB    (entry point)
-  ./example.js                              0.72 KB    (entry point)
-  ./learning-journey-duo-drills.feature.js  453 bytes  (entry point)
-  ./track.js                                1.29 KB    (entry point)
-
-$ contractspec-bun-build types
+
+$ contractspec-bun-build prebuild
+$ bun run build:bundle && bun run build:types
+$ contractspec-bun-build transpile
+[contractspec-bun-build] transpile target=bun root=src entries=6 noBundle=false
+Bundled 6 modules in 14ms
+
+  docs/duo-drills.docblock.js               1.30 KB    (entry point)
+  ./index.js                                4.27 KB    (entry point)
+  docs/index.js                             1.30 KB    (entry point)
+  ./example.js                              0.71 KB    (entry point)
+  ./learning-journey-duo-drills.feature.js  470 bytes  (entry point)
+  ./track.js                                1.83 KB    (entry point)
+
+[contractspec-bun-build] transpile target=node root=src entries=6 noBundle=false
+Bundled 6 modules in 12ms
+
+  docs/duo-drills.docblock.js               1.28 KB    (entry point)
+  ./index.js                                4.25 KB    (entry point)
+  docs/index.js                             1.28 KB    (entry point)
+  ./example.js                              0.70 KB    (entry point)
+  ./learning-journey-duo-drills.feature.js  462 bytes  (entry point)
+  ./track.js                                1.82 KB    (entry point)
+
+[contractspec-bun-build] transpile target=browser root=src entries=6 noBundle=false
+Bundled 6 modules in 12ms
+
+  docs/duo-drills.docblock.js               1.28 KB    (entry point)
+  ./index.js                                4.25 KB    (entry point)
+  docs/index.js                             1.28 KB    (entry point)
+  ./example.js                              0.70 KB    (entry point)
+  ./learning-journey-duo-drills.feature.js  462 bytes  (entry point)
+  ./track.js                                1.82 KB    (entry point)
+
+$ contractspec-bun-build types

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @contractspec/example.learning-journey-duo-drills
 
+## 4.0.1
+
+### Patch Changes
+
+- chore: auto-bump internal dependents
+- Updated dependencies because of chore: auto-bump internal dependents
+- Updated dependencies because of Add FormSpec layout hints, semantic field rendering, and portable text/textarea input-group addons.
+- Updated dependencies because of Add ThemeSpec light/dark modes and a design-system Tailwind bridge for CSS variables, presets, CSS text, and OKLCH color pass-through.
+- Updated dependencies because of Add a canonical typed result system for ContractSpec success and failure propagation across operations, workflows, jobs, server adapters, MCP, GraphQL, and React clients.
+  - @contractspec/module.learning-journey@4.0.1
+  - @contractspec/lib.contracts-spec@5.5.0
+
+## 4.0.0
+
+### Major Changes
+
+- Redesign the learning system around the adaptive journey runtime and repair shared learning sandbox presentation wiring.
+  - Packages: @contractspec/module.learning-journey (major), @contractspec/module.examples (patch), @contractspec/example.learning-journey-ambient-coach (major), @contractspec/example.learning-journey-crm-onboarding (major), @contractspec/example.learning-journey-duo-drills (major), @contractspec/example.learning-journey-platform-tour (major), @contractspec/example.learning-journey-quest-challenges (major), @contractspec/example.learning-journey-registry (major), @contractspec/example.learning-journey-studio-onboarding (major), @contractspec/example.learning-journey-ui-coaching (major), @contractspec/example.learning-journey-ui-gamified (major), @contractspec/example.learning-journey-ui-onboarding (major), @contractspec/example.learning-journey-ui-shared (major), @contractspec/example.learning-patterns (major)
+  - Migration: Replace the old onboarding-centric learning contracts and local example progress logic with the canonical adaptive `learning.journey.*` runtime.; Use the shared learning registry mapping/data helpers so supported learning sandbox templates resolve the shared presentation set consistently.
+
+### Patch Changes
+
+- Updated dependencies because of Add a family-aware ContractSpec Adoption Engine, expand contract authoring targets across CLI and VS Code tooling, and refresh release-facing schema and policy artifacts for downstream workspaces.
+- Updated dependencies because of Improve app-config, theme, and feature authoring with explicit validation APIs, first-class theme discovery and scaffolding, and key-based app-config generation across contracts, workspace tooling, and the CLI.
+- Updated dependencies because of Refresh root, package, website, and LLM-facing docs so Connect, Builder, release capsules, and the current contracts-spec export surface stay aligned.
+- Updated dependencies because of Persist canonical knowledge payload text during indexing and align the retrieval/query docs with the corrected behavior.
+- Updated dependencies because of Redesign the learning system around the adaptive journey runtime and repair shared learning sandbox presentation wiring.
+  - @contractspec/lib.contracts-spec@5.4.0
+  - @contractspec/module.learning-journey@4.0.0
+
 ## 3.7.19
 
 ### Patch Changes

package/dist/browser/example.js

@@ -1 +1 @@
-import{defineExample as g}from"@contractspec/lib.contracts-spec";var h=g({meta:{key:"learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey — Duo Drills",description:"Short drill/SRS example with XP and streak hooks for language, finance, or ContractSpec concept drills.",kind:"template",visibility:"public",stability:"experimental",owners:["@platform.core"],tags:["learning","drills","srs","xp"]},docs:{rootDocId:"docs.learning-journey.duo-drills"},entrypoints:{packageName:"@contractspec/example.learning-journey-duo-drills",docs:"./docs"},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["playground","markdown"]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}}),q=h;export{q as default};
+import{defineExample as b}from"@contractspec/lib.contracts-spec/examples";var c=b({meta:{key:"examples.learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey Duo Drills",description:"Drill-based learning journey example with SRS, XP, and streak hooks.",kind:"template",visibility:"experimental",stability:"experimental",owners:["@contractspec-core"],tags:["package","examples","learning-journey-duo-drills"]},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["playground","specs"]},studio:{enabled:!1,installable:!1},mcp:{enabled:!1}},entrypoints:{packageName:"@contractspec/example.learning-journey-duo-drills"}}),h=c;export{h as default,c as ExamplesLearningJourneyDuoDrillsExample};

package/dist/browser/index.js

@@ -1 +1 @@
-import{registerDocBlocks as e}from"@contractspec/lib.contracts-spec/docs";var i=[{id:"docs.learning-journey.duo-drills",title:"Learning Journey — Duo Drills",summary:"Short drill/SRS example with XP and streak hooks for language, finance, or ContractSpec concept drills.",kind:"reference",visibility:"public",route:"/docs/learning-journey/duo-drills",tags:["learning","drills","srs","xp"],body:'## Track\n- **Key**: `drills_language_basics`\n- **Persona**: learner running quick drills (language/finance/spec concepts)\n- **Goal**: complete first session, maintain high-accuracy sessions, master cards in the first skill\n\n## Steps & Conditions\n1) `complete_first_session` → event `drill.session.completed`\n2) `reach_accuracy_threshold` → count 3 sessions with payload `accuracyBucket: "high"` (within default window)\n3) `unlock_new_skill` → SRS mastery: `drill.card.mastered` events with `mastery >= 0.8`, count 5 cards\n\nXP: 20 + 30 + 40. Streak: daily session completion can be used to drive streak rewards.\n\n## Wiring\n- Tracks export from `@contractspec/example.learning-journey-duo-drills/track`.\n- Use registry helper `recordEvent` to advance steps from drill/session events.\n- SRS mastery events should include payload: `{ skillId, mastery }`.'}];e(i);import{defineExample as s}from"@contractspec/lib.contracts-spec";var a=s({meta:{key:"learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey — Duo Drills",description:"Short drill/SRS example with XP and streak hooks for language, finance, or ContractSpec concept drills.",kind:"template",visibility:"public",stability:"experimental",owners:["@platform.core"],tags:["learning","drills","srs","xp"]},docs:{rootDocId:"docs.learning-journey.duo-drills"},entrypoints:{packageName:"@contractspec/example.learning-journey-duo-drills",docs:"./docs"},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["playground","markdown"]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}}),r=a;import{defineFeature as t}from"@contractspec/lib.contracts-spec";var u=t({meta:{key:"learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey: Duo Drills",description:"Drill-based learning with spaced repetition, XP, and streaks",domain:"learning-journey",owners:["@examples"],tags:["learning","drills","srs","gamification"],stability:"experimental"},docs:["docs.learning-journey.duo-drills"]});var l={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"}}]},g=[l];export{r as example,l as drillsLanguageBasicsTrack,g as drillTracks,u as LearningJourneyDuoDrillsFeature};
+import{registerDocBlocks as e}from"@contractspec/lib.contracts-spec/docs";var t=[{id:"docs.learning-journey.duo-drills",title:"Learning Journey — Duo Drills",summary:"Short drill/SRS example with XP and streak hooks for language, finance, or ContractSpec concept drills.",kind:"reference",visibility:"public",route:"/docs/learning-journey/duo-drills",tags:["learning","drills","srs","xp"],body:'## Track\n- **Key**: `drills_language_basics`\n- **Persona**: learner running quick drills (language/finance/spec concepts)\n- **Goal**: complete first session, maintain high-accuracy sessions, master cards in the first skill\n\n## Steps & Conditions\n1) `complete_first_session` → event `drill.session.completed`\n2) `reach_accuracy_threshold` → count 3 sessions with payload `accuracyBucket: "high"` (within default window)\n3) `unlock_new_skill` → SRS mastery: `drill.card.mastered` events with `mastery >= 0.8`, count 5 cards\n\nXP: 20 + 30 + 40. Streak: daily session completion can be used to drive streak rewards.\n\n## Wiring\n- Tracks export from `@contractspec/example.learning-journey-duo-drills/track`.\n- Use registry helper `recordEvent` to advance steps from drill/session events.\n- SRS mastery events should include payload: `{ skillId, mastery }`.'}];e(t);import{defineExample as i}from"@contractspec/lib.contracts-spec/examples";var s=i({meta:{key:"examples.learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey Duo Drills",description:"Drill-based learning journey example with SRS, XP, and streak hooks.",kind:"template",visibility:"experimental",stability:"experimental",owners:["@contractspec-core"],tags:["package","examples","learning-journey-duo-drills"]},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["playground","specs"]},studio:{enabled:!1,installable:!1},mcp:{enabled:!1}},entrypoints:{packageName:"@contractspec/example.learning-journey-duo-drills"}}),r=s;import{defineFeature as a}from"@contractspec/lib.contracts-spec/features";var m=a({meta:{key:"learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey: Duo Drills",description:"Drill-based learning with spaced repetition, XP, and streaks",domain:"learning-journey",owners:["@examples"],tags:["learning","drills","srs","gamification"],stability:"experimental"},docs:["docs.learning-journey.duo-drills"]});var c={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:{xp: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"},branches:[{key:"fast_track",when:{kind:"event",eventName:"drill.session.completed",payloadFilter:{accuracyBucket:"high"}},blockStepIds:["reach_accuracy_threshold"],reward:{xp:10}},{key:"guided_practice",when:{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,prerequisites:[{kind:"branch_selected",stepId:"complete_first_session",branchKey:"guided_practice"}],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,prerequisiteMode:"any",prerequisites:[{kind:"step_completed",stepId:"reach_accuracy_threshold"},{kind:"branch_selected",stepId:"complete_first_session",branchKey:"fast_track"}],completion:{kind:"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"}}]},k=[c];export{r as example,c as drillsLanguageBasicsTrack,k as drillTracks,m as LearningJourneyDuoDrillsFeature,s as ExamplesLearningJourneyDuoDrillsExample};

package/dist/browser/learning-journey-duo-drills.feature.js

@@ -1 +1 @@
-import{defineFeature as g}from"@contractspec/lib.contracts-spec";var j=g({meta:{key:"learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey: Duo Drills",description:"Drill-based learning with spaced repetition, XP, and streaks",domain:"learning-journey",owners:["@examples"],tags:["learning","drills","srs","gamification"],stability:"experimental"},docs:["docs.learning-journey.duo-drills"]});export{j as LearningJourneyDuoDrillsFeature};
+import{defineFeature as g}from"@contractspec/lib.contracts-spec/features";var j=g({meta:{key:"learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey: Duo Drills",description:"Drill-based learning with spaced repetition, XP, and streaks",domain:"learning-journey",owners:["@examples"],tags:["learning","drills","srs","gamification"],stability:"experimental"},docs:["docs.learning-journey.duo-drills"]});export{j as LearningJourneyDuoDrillsFeature};

package/dist/browser/track.js

@@ -1 +1 @@
-var e={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"}}]},s=[e];export{e as drillsLanguageBasicsTrack,s as drillTracks};
+var e={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:{xp: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"},branches:[{key:"fast_track",when:{kind:"event",eventName:"drill.session.completed",payloadFilter:{accuracyBucket:"high"}},blockStepIds:["reach_accuracy_threshold"],reward:{xp:10}},{key:"guided_practice",when:{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,prerequisites:[{kind:"branch_selected",stepId:"complete_first_session",branchKey:"guided_practice"}],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,prerequisiteMode:"any",prerequisites:[{kind:"step_completed",stepId:"reach_accuracy_threshold"},{kind:"branch_selected",stepId:"complete_first_session",branchKey:"fast_track"}],completion:{kind:"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"}}]},s=[e];export{e as drillsLanguageBasicsTrack,s as drillTracks};

package/dist/example.d.ts

@@ -1,2 +1,3 @@
-declare const example: import("@contractspec/lib.contracts-spec").ExampleSpec;
-export default example;
+declare const ExamplesLearningJourneyDuoDrillsExample: import("@contractspec/lib.contracts-spec").ExampleSpec;
+export default ExamplesLearningJourneyDuoDrillsExample;
+export { ExamplesLearningJourneyDuoDrillsExample };

package/dist/example.js

@@ -1,2 +1,2 @@
 // @bun
-import{defineExample as g}from"@contractspec/lib.contracts-spec";var h=g({meta:{key:"learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey \u2014 Duo Drills",description:"Short drill/SRS example with XP and streak hooks for language, finance, or ContractSpec concept drills.",kind:"template",visibility:"public",stability:"experimental",owners:["@platform.core"],tags:["learning","drills","srs","xp"]},docs:{rootDocId:"docs.learning-journey.duo-drills"},entrypoints:{packageName:"@contractspec/example.learning-journey-duo-drills",docs:"./docs"},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["playground","markdown"]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}}),q=h;export{q as default};
+import{defineExample as b}from"@contractspec/lib.contracts-spec/examples";var c=b({meta:{key:"examples.learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey Duo Drills",description:"Drill-based learning journey example with SRS, XP, and streak hooks.",kind:"template",visibility:"experimental",stability:"experimental",owners:["@contractspec-core"],tags:["package","examples","learning-journey-duo-drills"]},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["playground","specs"]},studio:{enabled:!1,installable:!1},mcp:{enabled:!1}},entrypoints:{packageName:"@contractspec/example.learning-journey-duo-drills"}}),h=c;export{h as default,c as ExamplesLearningJourneyDuoDrillsExample};

package/dist/index.d.ts

@@ -2,3 +2,4 @@ export { default as example } from './example';
 export * from './learning-journey-duo-drills.feature';
 export * from './track';
 import './docs';
+export * from './example';

package/dist/index.js

@@ -1,2 +1,2 @@
 // @bun
-import{registerDocBlocks as e}from"@contractspec/lib.contracts-spec/docs";var i=[{id:"docs.learning-journey.duo-drills",title:"Learning Journey \u2014 Duo Drills",summary:"Short drill/SRS example with XP and streak hooks for language, finance, or ContractSpec concept drills.",kind:"reference",visibility:"public",route:"/docs/learning-journey/duo-drills",tags:["learning","drills","srs","xp"],body:'## Track\n- **Key**: `drills_language_basics`\n- **Persona**: learner running quick drills (language/finance/spec concepts)\n- **Goal**: complete first session, maintain high-accuracy sessions, master cards in the first skill\n\n## Steps & Conditions\n1) `complete_first_session` \u2192 event `drill.session.completed`\n2) `reach_accuracy_threshold` \u2192 count 3 sessions with payload `accuracyBucket: "high"` (within default window)\n3) `unlock_new_skill` \u2192 SRS mastery: `drill.card.mastered` events with `mastery >= 0.8`, count 5 cards\n\nXP: 20 + 30 + 40. Streak: daily session completion can be used to drive streak rewards.\n\n## Wiring\n- Tracks export from `@contractspec/example.learning-journey-duo-drills/track`.\n- Use registry helper `recordEvent` to advance steps from drill/session events.\n- SRS mastery events should include payload: `{ skillId, mastery }`.'}];e(i);import{defineExample as s}from"@contractspec/lib.contracts-spec";var a=s({meta:{key:"learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey \u2014 Duo Drills",description:"Short drill/SRS example with XP and streak hooks for language, finance, or ContractSpec concept drills.",kind:"template",visibility:"public",stability:"experimental",owners:["@platform.core"],tags:["learning","drills","srs","xp"]},docs:{rootDocId:"docs.learning-journey.duo-drills"},entrypoints:{packageName:"@contractspec/example.learning-journey-duo-drills",docs:"./docs"},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["playground","markdown"]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}}),r=a;import{defineFeature as t}from"@contractspec/lib.contracts-spec";var u=t({meta:{key:"learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey: Duo Drills",description:"Drill-based learning with spaced repetition, XP, and streaks",domain:"learning-journey",owners:["@examples"],tags:["learning","drills","srs","gamification"],stability:"experimental"},docs:["docs.learning-journey.duo-drills"]});var l={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"}}]},g=[l];export{r as example,l as drillsLanguageBasicsTrack,g as drillTracks,u as LearningJourneyDuoDrillsFeature};
+import{registerDocBlocks as e}from"@contractspec/lib.contracts-spec/docs";var t=[{id:"docs.learning-journey.duo-drills",title:"Learning Journey \u2014 Duo Drills",summary:"Short drill/SRS example with XP and streak hooks for language, finance, or ContractSpec concept drills.",kind:"reference",visibility:"public",route:"/docs/learning-journey/duo-drills",tags:["learning","drills","srs","xp"],body:'## Track\n- **Key**: `drills_language_basics`\n- **Persona**: learner running quick drills (language/finance/spec concepts)\n- **Goal**: complete first session, maintain high-accuracy sessions, master cards in the first skill\n\n## Steps & Conditions\n1) `complete_first_session` \u2192 event `drill.session.completed`\n2) `reach_accuracy_threshold` \u2192 count 3 sessions with payload `accuracyBucket: "high"` (within default window)\n3) `unlock_new_skill` \u2192 SRS mastery: `drill.card.mastered` events with `mastery >= 0.8`, count 5 cards\n\nXP: 20 + 30 + 40. Streak: daily session completion can be used to drive streak rewards.\n\n## Wiring\n- Tracks export from `@contractspec/example.learning-journey-duo-drills/track`.\n- Use registry helper `recordEvent` to advance steps from drill/session events.\n- SRS mastery events should include payload: `{ skillId, mastery }`.'}];e(t);import{defineExample as i}from"@contractspec/lib.contracts-spec/examples";var s=i({meta:{key:"examples.learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey Duo Drills",description:"Drill-based learning journey example with SRS, XP, and streak hooks.",kind:"template",visibility:"experimental",stability:"experimental",owners:["@contractspec-core"],tags:["package","examples","learning-journey-duo-drills"]},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["playground","specs"]},studio:{enabled:!1,installable:!1},mcp:{enabled:!1}},entrypoints:{packageName:"@contractspec/example.learning-journey-duo-drills"}}),r=s;import{defineFeature as a}from"@contractspec/lib.contracts-spec/features";var m=a({meta:{key:"learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey: Duo Drills",description:"Drill-based learning with spaced repetition, XP, and streaks",domain:"learning-journey",owners:["@examples"],tags:["learning","drills","srs","gamification"],stability:"experimental"},docs:["docs.learning-journey.duo-drills"]});var c={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:{xp: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"},branches:[{key:"fast_track",when:{kind:"event",eventName:"drill.session.completed",payloadFilter:{accuracyBucket:"high"}},blockStepIds:["reach_accuracy_threshold"],reward:{xp:10}},{key:"guided_practice",when:{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,prerequisites:[{kind:"branch_selected",stepId:"complete_first_session",branchKey:"guided_practice"}],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,prerequisiteMode:"any",prerequisites:[{kind:"step_completed",stepId:"reach_accuracy_threshold"},{kind:"branch_selected",stepId:"complete_first_session",branchKey:"fast_track"}],completion:{kind:"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"}}]},k=[c];export{r as example,c as drillsLanguageBasicsTrack,k as drillTracks,m as LearningJourneyDuoDrillsFeature,s as ExamplesLearningJourneyDuoDrillsExample};

package/dist/learning-journey-duo-drills.feature.js

@@ -1,2 +1,2 @@
 // @bun
-import{defineFeature as g}from"@contractspec/lib.contracts-spec";var j=g({meta:{key:"learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey: Duo Drills",description:"Drill-based learning with spaced repetition, XP, and streaks",domain:"learning-journey",owners:["@examples"],tags:["learning","drills","srs","gamification"],stability:"experimental"},docs:["docs.learning-journey.duo-drills"]});export{j as LearningJourneyDuoDrillsFeature};
+import{defineFeature as g}from"@contractspec/lib.contracts-spec/features";var j=g({meta:{key:"learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey: Duo Drills",description:"Drill-based learning with spaced repetition, XP, and streaks",domain:"learning-journey",owners:["@examples"],tags:["learning","drills","srs","gamification"],stability:"experimental"},docs:["docs.learning-journey.duo-drills"]});export{j as LearningJourneyDuoDrillsFeature};

package/dist/node/example.js

@@ -1 +1 @@
-import{defineExample as g}from"@contractspec/lib.contracts-spec";var h=g({meta:{key:"learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey — Duo Drills",description:"Short drill/SRS example with XP and streak hooks for language, finance, or ContractSpec concept drills.",kind:"template",visibility:"public",stability:"experimental",owners:["@platform.core"],tags:["learning","drills","srs","xp"]},docs:{rootDocId:"docs.learning-journey.duo-drills"},entrypoints:{packageName:"@contractspec/example.learning-journey-duo-drills",docs:"./docs"},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["playground","markdown"]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}}),q=h;export{q as default};
+import{defineExample as b}from"@contractspec/lib.contracts-spec/examples";var c=b({meta:{key:"examples.learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey Duo Drills",description:"Drill-based learning journey example with SRS, XP, and streak hooks.",kind:"template",visibility:"experimental",stability:"experimental",owners:["@contractspec-core"],tags:["package","examples","learning-journey-duo-drills"]},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["playground","specs"]},studio:{enabled:!1,installable:!1},mcp:{enabled:!1}},entrypoints:{packageName:"@contractspec/example.learning-journey-duo-drills"}}),h=c;export{h as default,c as ExamplesLearningJourneyDuoDrillsExample};

package/dist/node/index.js

@@ -1 +1 @@
-import{registerDocBlocks as e}from"@contractspec/lib.contracts-spec/docs";var i=[{id:"docs.learning-journey.duo-drills",title:"Learning Journey — Duo Drills",summary:"Short drill/SRS example with XP and streak hooks for language, finance, or ContractSpec concept drills.",kind:"reference",visibility:"public",route:"/docs/learning-journey/duo-drills",tags:["learning","drills","srs","xp"],body:'## Track\n- **Key**: `drills_language_basics`\n- **Persona**: learner running quick drills (language/finance/spec concepts)\n- **Goal**: complete first session, maintain high-accuracy sessions, master cards in the first skill\n\n## Steps & Conditions\n1) `complete_first_session` → event `drill.session.completed`\n2) `reach_accuracy_threshold` → count 3 sessions with payload `accuracyBucket: "high"` (within default window)\n3) `unlock_new_skill` → SRS mastery: `drill.card.mastered` events with `mastery >= 0.8`, count 5 cards\n\nXP: 20 + 30 + 40. Streak: daily session completion can be used to drive streak rewards.\n\n## Wiring\n- Tracks export from `@contractspec/example.learning-journey-duo-drills/track`.\n- Use registry helper `recordEvent` to advance steps from drill/session events.\n- SRS mastery events should include payload: `{ skillId, mastery }`.'}];e(i);import{defineExample as s}from"@contractspec/lib.contracts-spec";var a=s({meta:{key:"learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey — Duo Drills",description:"Short drill/SRS example with XP and streak hooks for language, finance, or ContractSpec concept drills.",kind:"template",visibility:"public",stability:"experimental",owners:["@platform.core"],tags:["learning","drills","srs","xp"]},docs:{rootDocId:"docs.learning-journey.duo-drills"},entrypoints:{packageName:"@contractspec/example.learning-journey-duo-drills",docs:"./docs"},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["playground","markdown"]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}}),r=a;import{defineFeature as t}from"@contractspec/lib.contracts-spec";var u=t({meta:{key:"learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey: Duo Drills",description:"Drill-based learning with spaced repetition, XP, and streaks",domain:"learning-journey",owners:["@examples"],tags:["learning","drills","srs","gamification"],stability:"experimental"},docs:["docs.learning-journey.duo-drills"]});var l={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"}}]},g=[l];export{r as example,l as drillsLanguageBasicsTrack,g as drillTracks,u as LearningJourneyDuoDrillsFeature};
+import{registerDocBlocks as e}from"@contractspec/lib.contracts-spec/docs";var t=[{id:"docs.learning-journey.duo-drills",title:"Learning Journey — Duo Drills",summary:"Short drill/SRS example with XP and streak hooks for language, finance, or ContractSpec concept drills.",kind:"reference",visibility:"public",route:"/docs/learning-journey/duo-drills",tags:["learning","drills","srs","xp"],body:'## Track\n- **Key**: `drills_language_basics`\n- **Persona**: learner running quick drills (language/finance/spec concepts)\n- **Goal**: complete first session, maintain high-accuracy sessions, master cards in the first skill\n\n## Steps & Conditions\n1) `complete_first_session` → event `drill.session.completed`\n2) `reach_accuracy_threshold` → count 3 sessions with payload `accuracyBucket: "high"` (within default window)\n3) `unlock_new_skill` → SRS mastery: `drill.card.mastered` events with `mastery >= 0.8`, count 5 cards\n\nXP: 20 + 30 + 40. Streak: daily session completion can be used to drive streak rewards.\n\n## Wiring\n- Tracks export from `@contractspec/example.learning-journey-duo-drills/track`.\n- Use registry helper `recordEvent` to advance steps from drill/session events.\n- SRS mastery events should include payload: `{ skillId, mastery }`.'}];e(t);import{defineExample as i}from"@contractspec/lib.contracts-spec/examples";var s=i({meta:{key:"examples.learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey Duo Drills",description:"Drill-based learning journey example with SRS, XP, and streak hooks.",kind:"template",visibility:"experimental",stability:"experimental",owners:["@contractspec-core"],tags:["package","examples","learning-journey-duo-drills"]},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["playground","specs"]},studio:{enabled:!1,installable:!1},mcp:{enabled:!1}},entrypoints:{packageName:"@contractspec/example.learning-journey-duo-drills"}}),r=s;import{defineFeature as a}from"@contractspec/lib.contracts-spec/features";var m=a({meta:{key:"learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey: Duo Drills",description:"Drill-based learning with spaced repetition, XP, and streaks",domain:"learning-journey",owners:["@examples"],tags:["learning","drills","srs","gamification"],stability:"experimental"},docs:["docs.learning-journey.duo-drills"]});var c={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:{xp: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"},branches:[{key:"fast_track",when:{kind:"event",eventName:"drill.session.completed",payloadFilter:{accuracyBucket:"high"}},blockStepIds:["reach_accuracy_threshold"],reward:{xp:10}},{key:"guided_practice",when:{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,prerequisites:[{kind:"branch_selected",stepId:"complete_first_session",branchKey:"guided_practice"}],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,prerequisiteMode:"any",prerequisites:[{kind:"step_completed",stepId:"reach_accuracy_threshold"},{kind:"branch_selected",stepId:"complete_first_session",branchKey:"fast_track"}],completion:{kind:"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"}}]},k=[c];export{r as example,c as drillsLanguageBasicsTrack,k as drillTracks,m as LearningJourneyDuoDrillsFeature,s as ExamplesLearningJourneyDuoDrillsExample};

package/dist/node/learning-journey-duo-drills.feature.js

@@ -1 +1 @@
-import{defineFeature as g}from"@contractspec/lib.contracts-spec";var j=g({meta:{key:"learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey: Duo Drills",description:"Drill-based learning with spaced repetition, XP, and streaks",domain:"learning-journey",owners:["@examples"],tags:["learning","drills","srs","gamification"],stability:"experimental"},docs:["docs.learning-journey.duo-drills"]});export{j as LearningJourneyDuoDrillsFeature};
+import{defineFeature as g}from"@contractspec/lib.contracts-spec/features";var j=g({meta:{key:"learning-journey-duo-drills",version:"1.0.0",title:"Learning Journey: Duo Drills",description:"Drill-based learning with spaced repetition, XP, and streaks",domain:"learning-journey",owners:["@examples"],tags:["learning","drills","srs","gamification"],stability:"experimental"},docs:["docs.learning-journey.duo-drills"]});export{j as LearningJourneyDuoDrillsFeature};

package/dist/node/track.js

@@ -1 +1 @@
-var e={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"}}]},s=[e];export{e as drillsLanguageBasicsTrack,s as drillTracks};
+var e={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:{xp: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"},branches:[{key:"fast_track",when:{kind:"event",eventName:"drill.session.completed",payloadFilter:{accuracyBucket:"high"}},blockStepIds:["reach_accuracy_threshold"],reward:{xp:10}},{key:"guided_practice",when:{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,prerequisites:[{kind:"branch_selected",stepId:"complete_first_session",branchKey:"guided_practice"}],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,prerequisiteMode:"any",prerequisites:[{kind:"step_completed",stepId:"reach_accuracy_threshold"},{kind:"branch_selected",stepId:"complete_first_session",branchKey:"fast_track"}],completion:{kind:"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"}}]},s=[e];export{e as drillsLanguageBasicsTrack,s as drillTracks};

package/dist/track.d.ts

@@ -1,3 +1,3 @@
-import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';
-export declare const drillsLanguageBasicsTrack: LearningJourneyTrackSpec;
-export declare const drillTracks: LearningJourneyTrackSpec[];
+import type { JourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';
+export declare const drillsLanguageBasicsTrack: JourneyTrackSpec;
+export declare const drillTracks: JourneyTrackSpec[];

package/dist/track.js

@@ -1,2 +1,2 @@
 // @bun
-var e={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"}}]},s=[e];export{e as drillsLanguageBasicsTrack,s as drillTracks};
+var e={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:{xp: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"},branches:[{key:"fast_track",when:{kind:"event",eventName:"drill.session.completed",payloadFilter:{accuracyBucket:"high"}},blockStepIds:["reach_accuracy_threshold"],reward:{xp:10}},{key:"guided_practice",when:{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,prerequisites:[{kind:"branch_selected",stepId:"complete_first_session",branchKey:"guided_practice"}],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,prerequisiteMode:"any",prerequisites:[{kind:"step_completed",stepId:"reach_accuracy_threshold"},{kind:"branch_selected",stepId:"complete_first_session",branchKey:"fast_track"}],completion:{kind:"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"}}]},s=[e];export{e as drillsLanguageBasicsTrack,s as drillTracks};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.learning-journey-duo-drills",
-  "version": "3.7.19",
+  "version": "4.0.1",
   "description": "Drill-based learning journey example with SRS, XP, and streak hooks.",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -64,13 +64,13 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/module.learning-journey": "3.7.18",
-    "@contractspec/lib.contracts-spec": "5.3.0"
+    "@contractspec/module.learning-journey": "4.0.1",
+    "@contractspec/lib.contracts-spec": "5.5.0"
   },
   "devDependencies": {
     "@contractspec/tool.typescript": "3.7.13",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.7.14"
+    "@contractspec/tool.bun": "3.7.15"
   },
   "publishConfig": {
     "exports": {

package/src/example.ts

@@ -1,31 +1,28 @@
-import { defineExample } from '@contractspec/lib.contracts-spec';
+import { defineExample } from '@contractspec/lib.contracts-spec/examples';
 
-const example = defineExample({
+const ExamplesLearningJourneyDuoDrillsExample = defineExample({
 	meta: {
-		key: 'learning-journey-duo-drills',
+		key: 'examples.learning-journey-duo-drills',
 		version: '1.0.0',
-		title: 'Learning Journey — Duo Drills',
+		title: 'Learning Journey Duo Drills',
 		description:
-			'Short drill/SRS example with XP and streak hooks for language, finance, or ContractSpec concept drills.',
+			'Drill-based learning journey example with SRS, XP, and streak hooks.',
 		kind: 'template',
-		visibility: 'public',
+		visibility: 'experimental',
 		stability: 'experimental',
-		owners: ['@platform.core'],
-		tags: ['learning', 'drills', 'srs', 'xp'],
+		owners: ['@contractspec-core'],
+		tags: ['package', 'examples', 'learning-journey-duo-drills'],
 	},
-	docs: {
-		rootDocId: 'docs.learning-journey.duo-drills',
+	surfaces: {
+		templates: true,
+		sandbox: { enabled: true, modes: ['playground', 'specs'] },
+		studio: { enabled: false, installable: false },
+		mcp: { enabled: false },
 	},
 	entrypoints: {
 		packageName: '@contractspec/example.learning-journey-duo-drills',
-		docs: './docs',
-	},
-	surfaces: {
-		templates: true,
-		sandbox: { enabled: true, modes: ['playground', 'markdown'] },
-		studio: { enabled: true, installable: true },
-		mcp: { enabled: true },
 	},
 });
 
-export default example;
+export default ExamplesLearningJourneyDuoDrillsExample;
+export { ExamplesLearningJourneyDuoDrillsExample };

package/src/index.ts

@@ -2,3 +2,5 @@ export { default as example } from './example';
 export * from './learning-journey-duo-drills.feature';
 export * from './track';
 import './docs';
+
+export * from './example';

package/src/learning-journey-duo-drills.feature.ts

@@ -1,4 +1,4 @@
-import { defineFeature } from '@contractspec/lib.contracts-spec';
+import { defineFeature } from '@contractspec/lib.contracts-spec/features';
 
 export const LearningJourneyDuoDrillsFeature = defineFeature({
 	meta: {

package/src/track.test.ts

@@ -1,106 +1,37 @@
 import { describe, expect, it } from 'bun:test';
-
+import {
+	createJourneyProgressState,
+	projectJourneyProgress,
+	recordJourneyEvent,
+} from '@contractspec/module.learning-journey/runtime';
 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>(() => ({
+	it('supports both the fast-track branch and mastery completion', () => {
+		let state = createJourneyProgressState(drillsLanguageBasicsTrack);
+		state = recordJourneyEvent(drillsLanguageBasicsTrack, state, {
+			name: 'drill.session.completed',
+			payload: { accuracyBucket: 'high' },
+		});
+
+		const afterDiagnostic = projectJourneyProgress(
+			drillsLanguageBasicsTrack,
+			state
+		);
+		expect(afterDiagnostic.blockedStepIds).toEqual([
+			'reach_accuracy_threshold',
+		]);
+		expect(afterDiagnostic.currentStepId).toBe('unlock_new_skill');
+
+		for (let index = 0; index < 5; index++) {
+			state = recordJourneyEvent(drillsLanguageBasicsTrack, state, {
 				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();
+		expect(
+			projectJourneyProgress(drillsLanguageBasicsTrack, state).isCompleted
+		).toBeTrue();
 	});
 });

package/src/track.ts

@@ -1,6 +1,6 @@
-import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';
+import type { JourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';
 
-export const drillsLanguageBasicsTrack: LearningJourneyTrackSpec = {
+export const drillsLanguageBasicsTrack: JourneyTrackSpec = {
 	id: 'drills_language_basics',
 	name: 'Language Basics Drills',
 	description:
@@ -8,7 +8,7 @@ export const drillsLanguageBasicsTrack: LearningJourneyTrackSpec = {
 	targetUserSegment: 'learner',
 	targetRole: 'individual',
 	totalXp: 50,
-	completionRewards: { xpBonus: 25 },
+	completionRewards: { xp: 25 },
 	steps: [
 		{
 			id: 'complete_first_session',
@@ -19,6 +19,25 @@ export const drillsLanguageBasicsTrack: LearningJourneyTrackSpec = {
 				kind: 'event',
 				eventName: 'drill.session.completed',
 			},
+			branches: [
+				{
+					key: 'fast_track',
+					when: {
+						kind: 'event',
+						eventName: 'drill.session.completed',
+						payloadFilter: { accuracyBucket: 'high' },
+					},
+					blockStepIds: ['reach_accuracy_threshold'],
+					reward: { xp: 10 },
+				},
+				{
+					key: 'guided_practice',
+					when: {
+						kind: 'event',
+						eventName: 'drill.session.completed',
+					},
+				},
+			],
 			xpReward: 20,
 			metadata: { surface: 'drills' },
 		},
@@ -27,6 +46,13 @@ export const drillsLanguageBasicsTrack: LearningJourneyTrackSpec = {
 			title: 'Hit high accuracy in sessions',
 			description: 'Achieve three high-accuracy sessions to build confidence.',
 			order: 2,
+			prerequisites: [
+				{
+					kind: 'branch_selected',
+					stepId: 'complete_first_session',
+					branchKey: 'guided_practice',
+				},
+			],
 			completion: {
 				kind: 'count',
 				eventName: 'drill.session.completed',
@@ -42,8 +68,20 @@ export const drillsLanguageBasicsTrack: LearningJourneyTrackSpec = {
 			description:
 				'Reach mastery on at least five cards in the first skill to unlock the next one.',
 			order: 3,
+			prerequisiteMode: 'any',
+			prerequisites: [
+				{
+					kind: 'step_completed',
+					stepId: 'reach_accuracy_threshold',
+				},
+				{
+					kind: 'branch_selected',
+					stepId: 'complete_first_session',
+					branchKey: 'fast_track',
+				},
+			],
 			completion: {
-				kind: 'srs_mastery',
+				kind: 'mastery',
 				eventName: 'drill.card.mastered',
 				minimumMastery: 0.8,
 				requiredCount: 5,
@@ -57,6 +95,4 @@ export const drillsLanguageBasicsTrack: LearningJourneyTrackSpec = {
 	],
 };
 
-export const drillTracks: LearningJourneyTrackSpec[] = [
-	drillsLanguageBasicsTrack,
-];
+export const drillTracks: JourneyTrackSpec[] = [drillsLanguageBasicsTrack];