@contractspec/example.learning-patterns 3.7.5 → 3.7.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -77,6 +77,68 @@ var example = defineExample({
77
77
  });
78
78
  var example_default = example;
79
79
 
80
+ // src/learning-patterns.feature.ts
81
+ import { defineFeature } from "@contractspec/lib.contracts-spec";
82
+ var LearningPatternsFeature = defineFeature({
83
+ meta: {
84
+ key: "learning-patterns",
85
+ version: "1.0.0",
86
+ title: "Learning Patterns",
87
+ description: "Learning archetypes (drills, ambient-coach, quests) via event-driven track specs",
88
+ domain: "learning-journey",
89
+ owners: ["@examples"],
90
+ tags: ["learning", "patterns", "archetypes", "tracks"],
91
+ stability: "experimental"
92
+ },
93
+ telemetry: [{ key: "learning-patterns.telemetry", version: "1.0.0" }],
94
+ docs: [
95
+ "docs.examples.learning-patterns.goal",
96
+ "docs.examples.learning-patterns.reference"
97
+ ]
98
+ });
99
+
100
+ // src/tracks/ambient-coach.ts
101
+ var ambientCoachTrack = {
102
+ id: "learning_patterns_ambient_coach_basics",
103
+ name: "Ambient Coach Basics",
104
+ description: "Contextual tips triggered by behavior events.",
105
+ targetUserSegment: "learner",
106
+ targetRole: "individual",
107
+ totalXp: 30,
108
+ steps: [
109
+ {
110
+ id: "tip_shown",
111
+ title: "See a contextual tip",
112
+ order: 1,
113
+ completion: { kind: "event", eventName: LEARNING_EVENTS.COACH_TIP_SHOWN },
114
+ xpReward: 10
115
+ },
116
+ {
117
+ id: "tip_acknowledged",
118
+ title: "Acknowledge a tip",
119
+ order: 2,
120
+ completion: {
121
+ kind: "event",
122
+ eventName: LEARNING_EVENTS.COACH_TIP_ACKNOWLEDGED
123
+ },
124
+ xpReward: 10
125
+ },
126
+ {
127
+ id: "tip_action_taken",
128
+ title: "Take an action from a tip",
129
+ order: 3,
130
+ completion: {
131
+ kind: "event",
132
+ eventName: LEARNING_EVENTS.COACH_TIP_ACTION_TAKEN
133
+ },
134
+ xpReward: 10
135
+ }
136
+ ]
137
+ };
138
+ var ambientCoachTracks = [
139
+ ambientCoachTrack
140
+ ];
141
+
80
142
  // src/tracks/drills.ts
81
143
  var drillsTrack = {
82
144
  id: "learning_patterns_drills_basics",
@@ -126,48 +188,6 @@ var drillsTrack = {
126
188
  };
127
189
  var drillTracks = [drillsTrack];
128
190
 
129
- // src/tracks/ambient-coach.ts
130
- var ambientCoachTrack = {
131
- id: "learning_patterns_ambient_coach_basics",
132
- name: "Ambient Coach Basics",
133
- description: "Contextual tips triggered by behavior events.",
134
- targetUserSegment: "learner",
135
- targetRole: "individual",
136
- totalXp: 30,
137
- steps: [
138
- {
139
- id: "tip_shown",
140
- title: "See a contextual tip",
141
- order: 1,
142
- completion: { kind: "event", eventName: LEARNING_EVENTS.COACH_TIP_SHOWN },
143
- xpReward: 10
144
- },
145
- {
146
- id: "tip_acknowledged",
147
- title: "Acknowledge a tip",
148
- order: 2,
149
- completion: {
150
- kind: "event",
151
- eventName: LEARNING_EVENTS.COACH_TIP_ACKNOWLEDGED
152
- },
153
- xpReward: 10
154
- },
155
- {
156
- id: "tip_action_taken",
157
- title: "Take an action from a tip",
158
- order: 3,
159
- completion: {
160
- kind: "event",
161
- eventName: LEARNING_EVENTS.COACH_TIP_ACTION_TAKEN
162
- },
163
- xpReward: 10
164
- }
165
- ]
166
- };
167
- var ambientCoachTracks = [
168
- ambientCoachTrack
169
- ];
170
-
171
191
  // src/tracks/quests.ts
172
192
  var questTrack = {
173
193
  id: "learning_patterns_quest_7day",
@@ -209,25 +229,6 @@ var questTrack = {
209
229
  ]
210
230
  };
211
231
  var questTracks = [questTrack];
212
- // src/learning-patterns.feature.ts
213
- import { defineFeature } from "@contractspec/lib.contracts-spec";
214
- var LearningPatternsFeature = defineFeature({
215
- meta: {
216
- key: "learning-patterns",
217
- version: "1.0.0",
218
- title: "Learning Patterns",
219
- description: "Learning archetypes (drills, ambient-coach, quests) via event-driven track specs",
220
- domain: "learning-journey",
221
- owners: ["@examples"],
222
- tags: ["learning", "patterns", "archetypes", "tracks"],
223
- stability: "experimental"
224
- },
225
- telemetry: [{ key: "learning-patterns.telemetry", version: "1.0.0" }],
226
- docs: [
227
- "docs.examples.learning-patterns.goal",
228
- "docs.examples.learning-patterns.reference"
229
- ]
230
- });
231
232
  export {
232
233
  questTracks,
233
234
  questTrack,
@@ -11,6 +11,48 @@ var LEARNING_EVENTS = {
11
11
  QUEST_STEP_COMPLETED: "quest.step.completed"
12
12
  };
13
13
 
14
+ // src/tracks/ambient-coach.ts
15
+ var ambientCoachTrack = {
16
+ id: "learning_patterns_ambient_coach_basics",
17
+ name: "Ambient Coach Basics",
18
+ description: "Contextual tips triggered by behavior events.",
19
+ targetUserSegment: "learner",
20
+ targetRole: "individual",
21
+ totalXp: 30,
22
+ steps: [
23
+ {
24
+ id: "tip_shown",
25
+ title: "See a contextual tip",
26
+ order: 1,
27
+ completion: { kind: "event", eventName: LEARNING_EVENTS.COACH_TIP_SHOWN },
28
+ xpReward: 10
29
+ },
30
+ {
31
+ id: "tip_acknowledged",
32
+ title: "Acknowledge a tip",
33
+ order: 2,
34
+ completion: {
35
+ kind: "event",
36
+ eventName: LEARNING_EVENTS.COACH_TIP_ACKNOWLEDGED
37
+ },
38
+ xpReward: 10
39
+ },
40
+ {
41
+ id: "tip_action_taken",
42
+ title: "Take an action from a tip",
43
+ order: 3,
44
+ completion: {
45
+ kind: "event",
46
+ eventName: LEARNING_EVENTS.COACH_TIP_ACTION_TAKEN
47
+ },
48
+ xpReward: 10
49
+ }
50
+ ]
51
+ };
52
+ var ambientCoachTracks = [
53
+ ambientCoachTrack
54
+ ];
55
+
14
56
  // src/tracks/drills.ts
15
57
  var drillsTrack = {
16
58
  id: "learning_patterns_drills_basics",
@@ -60,48 +102,6 @@ var drillsTrack = {
60
102
  };
61
103
  var drillTracks = [drillsTrack];
62
104
 
63
- // src/tracks/ambient-coach.ts
64
- var ambientCoachTrack = {
65
- id: "learning_patterns_ambient_coach_basics",
66
- name: "Ambient Coach Basics",
67
- description: "Contextual tips triggered by behavior events.",
68
- targetUserSegment: "learner",
69
- targetRole: "individual",
70
- totalXp: 30,
71
- steps: [
72
- {
73
- id: "tip_shown",
74
- title: "See a contextual tip",
75
- order: 1,
76
- completion: { kind: "event", eventName: LEARNING_EVENTS.COACH_TIP_SHOWN },
77
- xpReward: 10
78
- },
79
- {
80
- id: "tip_acknowledged",
81
- title: "Acknowledge a tip",
82
- order: 2,
83
- completion: {
84
- kind: "event",
85
- eventName: LEARNING_EVENTS.COACH_TIP_ACKNOWLEDGED
86
- },
87
- xpReward: 10
88
- },
89
- {
90
- id: "tip_action_taken",
91
- title: "Take an action from a tip",
92
- order: 3,
93
- completion: {
94
- kind: "event",
95
- eventName: LEARNING_EVENTS.COACH_TIP_ACTION_TAKEN
96
- },
97
- xpReward: 10
98
- }
99
- ]
100
- };
101
- var ambientCoachTracks = [
102
- ambientCoachTrack
103
- ];
104
-
105
105
  // src/tracks/quests.ts
106
106
  var questTrack = {
107
107
  id: "learning_patterns_quest_7day",
@@ -1,3 +1,3 @@
1
- export * from './drills';
2
1
  export * from './ambient-coach';
2
+ export * from './drills';
3
3
  export * from './quests';
@@ -12,6 +12,48 @@ var LEARNING_EVENTS = {
12
12
  QUEST_STEP_COMPLETED: "quest.step.completed"
13
13
  };
14
14
 
15
+ // src/tracks/ambient-coach.ts
16
+ var ambientCoachTrack = {
17
+ id: "learning_patterns_ambient_coach_basics",
18
+ name: "Ambient Coach Basics",
19
+ description: "Contextual tips triggered by behavior events.",
20
+ targetUserSegment: "learner",
21
+ targetRole: "individual",
22
+ totalXp: 30,
23
+ steps: [
24
+ {
25
+ id: "tip_shown",
26
+ title: "See a contextual tip",
27
+ order: 1,
28
+ completion: { kind: "event", eventName: LEARNING_EVENTS.COACH_TIP_SHOWN },
29
+ xpReward: 10
30
+ },
31
+ {
32
+ id: "tip_acknowledged",
33
+ title: "Acknowledge a tip",
34
+ order: 2,
35
+ completion: {
36
+ kind: "event",
37
+ eventName: LEARNING_EVENTS.COACH_TIP_ACKNOWLEDGED
38
+ },
39
+ xpReward: 10
40
+ },
41
+ {
42
+ id: "tip_action_taken",
43
+ title: "Take an action from a tip",
44
+ order: 3,
45
+ completion: {
46
+ kind: "event",
47
+ eventName: LEARNING_EVENTS.COACH_TIP_ACTION_TAKEN
48
+ },
49
+ xpReward: 10
50
+ }
51
+ ]
52
+ };
53
+ var ambientCoachTracks = [
54
+ ambientCoachTrack
55
+ ];
56
+
15
57
  // src/tracks/drills.ts
16
58
  var drillsTrack = {
17
59
  id: "learning_patterns_drills_basics",
@@ -61,48 +103,6 @@ var drillsTrack = {
61
103
  };
62
104
  var drillTracks = [drillsTrack];
63
105
 
64
- // src/tracks/ambient-coach.ts
65
- var ambientCoachTrack = {
66
- id: "learning_patterns_ambient_coach_basics",
67
- name: "Ambient Coach Basics",
68
- description: "Contextual tips triggered by behavior events.",
69
- targetUserSegment: "learner",
70
- targetRole: "individual",
71
- totalXp: 30,
72
- steps: [
73
- {
74
- id: "tip_shown",
75
- title: "See a contextual tip",
76
- order: 1,
77
- completion: { kind: "event", eventName: LEARNING_EVENTS.COACH_TIP_SHOWN },
78
- xpReward: 10
79
- },
80
- {
81
- id: "tip_acknowledged",
82
- title: "Acknowledge a tip",
83
- order: 2,
84
- completion: {
85
- kind: "event",
86
- eventName: LEARNING_EVENTS.COACH_TIP_ACKNOWLEDGED
87
- },
88
- xpReward: 10
89
- },
90
- {
91
- id: "tip_action_taken",
92
- title: "Take an action from a tip",
93
- order: 3,
94
- completion: {
95
- kind: "event",
96
- eventName: LEARNING_EVENTS.COACH_TIP_ACTION_TAKEN
97
- },
98
- xpReward: 10
99
- }
100
- ]
101
- };
102
- var ambientCoachTracks = [
103
- ambientCoachTrack
104
- ];
105
-
106
106
  // src/tracks/quests.ts
107
107
  var questTrack = {
108
108
  id: "learning_patterns_quest_7day",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@contractspec/example.learning-patterns",
3
- "version": "3.7.5",
3
+ "version": "3.7.7",
4
4
  "description": "Example: drills + ambient coach + quests learning patterns, powered by Learning Journey (event-driven, deterministic).",
5
5
  "type": "module",
6
6
  "types": "./dist/index.d.ts",
@@ -85,20 +85,20 @@
85
85
  "dev": "contractspec-bun-build dev",
86
86
  "clean": "rimraf dist .turbo",
87
87
  "lint": "bun lint:fix",
88
- "lint:fix": "eslint src --fix",
89
- "lint:check": "eslint src",
88
+ "lint:fix": "biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .",
89
+ "lint:check": "biome check .",
90
90
  "test": "bun test",
91
91
  "prebuild": "contractspec-bun-build prebuild",
92
92
  "typecheck": "tsc --noEmit"
93
93
  },
94
94
  "dependencies": {
95
- "@contractspec/lib.contracts-spec": "3.7.5",
96
- "@contractspec/module.learning-journey": "3.7.5"
95
+ "@contractspec/lib.contracts-spec": "4.0.0",
96
+ "@contractspec/module.learning-journey": "3.7.7"
97
97
  },
98
98
  "devDependencies": {
99
- "@contractspec/tool.typescript": "3.7.5",
99
+ "@contractspec/tool.typescript": "3.7.6",
100
100
  "typescript": "^5.9.3",
101
- "@contractspec/tool.bun": "3.7.5"
101
+ "@contractspec/tool.bun": "3.7.6"
102
102
  },
103
103
  "publishConfig": {
104
104
  "access": "public",
@@ -2,29 +2,29 @@ import type { DocBlock } from '@contractspec/lib.contracts-spec/docs';
2
2
  import { registerDocBlocks } from '@contractspec/lib.contracts-spec/docs';
3
3
 
4
4
  const docBlocks: DocBlock[] = [
5
- {
6
- id: 'docs.examples.learning-patterns.goal',
7
- title: 'Learning Patterns — Goal',
8
- summary:
9
- 'Domain-agnostic drills, ambient coaching, and quests built on Learning Journey.',
10
- kind: 'goal',
11
- visibility: 'public',
12
- route: '/docs/examples/learning-patterns/goal',
13
- tags: ['learning', 'drills', 'quests', 'coaching'],
14
- body: `## Why it matters
5
+ {
6
+ id: 'docs.examples.learning-patterns.goal',
7
+ title: 'Learning Patterns — Goal',
8
+ summary:
9
+ 'Domain-agnostic drills, ambient coaching, and quests built on Learning Journey.',
10
+ kind: 'goal',
11
+ visibility: 'public',
12
+ route: '/docs/examples/learning-patterns/goal',
13
+ tags: ['learning', 'drills', 'quests', 'coaching'],
14
+ body: `## Why it matters
15
15
  - Demonstrates multiple learning archetypes without vertical coupling.\n- Progress is event-driven (no client-side hacks).\n- SRS logic is deterministic and testable.`,
16
- },
17
- {
18
- id: 'docs.examples.learning-patterns.reference',
19
- title: 'Learning Patterns — Reference',
20
- summary:
21
- 'Track specs and event names exported by the learning patterns example.',
22
- kind: 'reference',
23
- visibility: 'public',
24
- route: '/docs/examples/learning-patterns',
25
- tags: ['learning', 'reference'],
26
- body: `## Tracks\n- Drills + SRS\n- Ambient Coach\n- Quests\n\n## Events\n- drill.*\n- coach.*\n- quest.*`,
27
- },
16
+ },
17
+ {
18
+ id: 'docs.examples.learning-patterns.reference',
19
+ title: 'Learning Patterns — Reference',
20
+ summary:
21
+ 'Track specs and event names exported by the learning patterns example.',
22
+ kind: 'reference',
23
+ visibility: 'public',
24
+ route: '/docs/examples/learning-patterns',
25
+ tags: ['learning', 'reference'],
26
+ body: `## Tracks\n- Drills + SRS\n- Ambient Coach\n- Quests\n\n## Events\n- drill.*\n- coach.*\n- quest.*`,
27
+ },
28
28
  ];
29
29
 
30
30
  registerDocBlocks(docBlocks);
package/src/events.ts CHANGED
@@ -1,16 +1,16 @@
1
1
  export const LEARNING_EVENTS = {
2
- DRILL_CARD_ANSWERED: 'drill.card.answered',
3
- DRILL_SESSION_COMPLETED: 'drill.session.completed',
4
- DRILL_CARD_MASTERED: 'drill.card.mastered',
2
+ DRILL_CARD_ANSWERED: 'drill.card.answered',
3
+ DRILL_SESSION_COMPLETED: 'drill.session.completed',
4
+ DRILL_CARD_MASTERED: 'drill.card.mastered',
5
5
 
6
- COACH_TIP_TRIGGERED: 'coach.tip.triggered',
7
- COACH_TIP_SHOWN: 'coach.tip.shown',
8
- COACH_TIP_ACKNOWLEDGED: 'coach.tip.acknowledged',
9
- COACH_TIP_ACTION_TAKEN: 'coach.tip.actionTaken',
6
+ COACH_TIP_TRIGGERED: 'coach.tip.triggered',
7
+ COACH_TIP_SHOWN: 'coach.tip.shown',
8
+ COACH_TIP_ACKNOWLEDGED: 'coach.tip.acknowledged',
9
+ COACH_TIP_ACTION_TAKEN: 'coach.tip.actionTaken',
10
10
 
11
- QUEST_STARTED: 'quest.started',
12
- QUEST_STEP_COMPLETED: 'quest.step.completed',
11
+ QUEST_STARTED: 'quest.started',
12
+ QUEST_STEP_COMPLETED: 'quest.step.completed',
13
13
  } as const;
14
14
 
15
15
  export type LearningEventName =
16
- (typeof LEARNING_EVENTS)[keyof typeof LEARNING_EVENTS];
16
+ (typeof LEARNING_EVENTS)[keyof typeof LEARNING_EVENTS];
package/src/example.ts CHANGED
@@ -1,31 +1,31 @@
1
1
  import { defineExample } from '@contractspec/lib.contracts-spec';
2
2
 
3
3
  const example = defineExample({
4
- meta: {
5
- key: 'learning-patterns',
6
- version: '1.0.0',
7
- title: 'Learning Patterns',
8
- description:
9
- 'Domain-agnostic learning archetypes implemented as Learning Journey tracks.',
10
- kind: 'library',
11
- visibility: 'public',
12
- stability: 'experimental',
13
- owners: ['@platform.core'],
14
- tags: ['learning', 'journey', 'patterns'],
15
- },
16
- docs: {
17
- rootDocId: 'docs.examples.learning-patterns',
18
- },
19
- entrypoints: {
20
- packageName: '@contractspec/example.learning-patterns',
21
- docs: './docs',
22
- },
23
- surfaces: {
24
- templates: true,
25
- sandbox: { enabled: true, modes: ['markdown', 'specs'] },
26
- studio: { enabled: true, installable: true },
27
- mcp: { enabled: true },
28
- },
4
+ meta: {
5
+ key: 'learning-patterns',
6
+ version: '1.0.0',
7
+ title: 'Learning Patterns',
8
+ description:
9
+ 'Domain-agnostic learning archetypes implemented as Learning Journey tracks.',
10
+ kind: 'library',
11
+ visibility: 'public',
12
+ stability: 'experimental',
13
+ owners: ['@platform.core'],
14
+ tags: ['learning', 'journey', 'patterns'],
15
+ },
16
+ docs: {
17
+ rootDocId: 'docs.examples.learning-patterns',
18
+ },
19
+ entrypoints: {
20
+ packageName: '@contractspec/example.learning-patterns',
21
+ docs: './docs',
22
+ },
23
+ surfaces: {
24
+ templates: true,
25
+ sandbox: { enabled: true, modes: ['markdown', 'specs'] },
26
+ studio: { enabled: true, installable: true },
27
+ mcp: { enabled: true },
28
+ },
29
29
  });
30
30
 
31
31
  export default example;
package/src/index.ts CHANGED
@@ -4,8 +4,8 @@
4
4
  * Domain-agnostic learning archetypes implemented as Learning Journey tracks.
5
5
  */
6
6
  export * from './events';
7
- export * from './tracks';
8
- export * from './learning-patterns.feature';
9
7
  export { default as example } from './example';
8
+ export * from './learning-patterns.feature';
9
+ export * from './tracks';
10
10
 
11
11
  import './docs';
@@ -1,22 +1,22 @@
1
1
  import { defineFeature } from '@contractspec/lib.contracts-spec';
2
2
 
3
3
  export const LearningPatternsFeature = defineFeature({
4
- meta: {
5
- key: 'learning-patterns',
6
- version: '1.0.0',
7
- title: 'Learning Patterns',
8
- description:
9
- 'Learning archetypes (drills, ambient-coach, quests) via event-driven track specs',
10
- domain: 'learning-journey',
11
- owners: ['@examples'],
12
- tags: ['learning', 'patterns', 'archetypes', 'tracks'],
13
- stability: 'experimental',
14
- },
4
+ meta: {
5
+ key: 'learning-patterns',
6
+ version: '1.0.0',
7
+ title: 'Learning Patterns',
8
+ description:
9
+ 'Learning archetypes (drills, ambient-coach, quests) via event-driven track specs',
10
+ domain: 'learning-journey',
11
+ owners: ['@examples'],
12
+ tags: ['learning', 'patterns', 'archetypes', 'tracks'],
13
+ stability: 'experimental',
14
+ },
15
15
 
16
- telemetry: [{ key: 'learning-patterns.telemetry', version: '1.0.0' }],
16
+ telemetry: [{ key: 'learning-patterns.telemetry', version: '1.0.0' }],
17
17
 
18
- docs: [
19
- 'docs.examples.learning-patterns.goal',
20
- 'docs.examples.learning-patterns.reference',
21
- ],
18
+ docs: [
19
+ 'docs.examples.learning-patterns.goal',
20
+ 'docs.examples.learning-patterns.reference',
21
+ ],
22
22
  });