@contractspec/example.learning-patterns 1.44.0

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.
Files changed (49) hide show
  1. package/.turbo/turbo-build$colon$bundle.log +39 -0
  2. package/.turbo/turbo-build.log +40 -0
  3. package/CHANGELOG.md +178 -0
  4. package/LICENSE +21 -0
  5. package/README.md +15 -0
  6. package/dist/docs/index.d.ts +1 -0
  7. package/dist/docs/index.js +1 -0
  8. package/dist/docs/learning-patterns.docblock.d.ts +1 -0
  9. package/dist/docs/learning-patterns.docblock.js +31 -0
  10. package/dist/docs/learning-patterns.docblock.js.map +1 -0
  11. package/dist/events.d.ts +16 -0
  12. package/dist/events.d.ts.map +1 -0
  13. package/dist/events.js +16 -0
  14. package/dist/events.js.map +1 -0
  15. package/dist/example.d.ts +33 -0
  16. package/dist/example.d.ts.map +1 -0
  17. package/dist/example.js +35 -0
  18. package/dist/example.js.map +1 -0
  19. package/dist/index.d.ts +6 -0
  20. package/dist/index.js +9 -0
  21. package/dist/tracks/ambient-coach.d.ts +8 -0
  22. package/dist/tracks/ambient-coach.d.ts.map +1 -0
  23. package/dist/tracks/ambient-coach.js +48 -0
  24. package/dist/tracks/ambient-coach.js.map +1 -0
  25. package/dist/tracks/drills.d.ts +8 -0
  26. package/dist/tracks/drills.d.ts.map +1 -0
  27. package/dist/tracks/drills.js +54 -0
  28. package/dist/tracks/drills.js.map +1 -0
  29. package/dist/tracks/index.d.ts +4 -0
  30. package/dist/tracks/index.js +5 -0
  31. package/dist/tracks/quests.d.ts +8 -0
  32. package/dist/tracks/quests.d.ts.map +1 -0
  33. package/dist/tracks/quests.js +56 -0
  34. package/dist/tracks/quests.js.map +1 -0
  35. package/example.ts +1 -0
  36. package/package.json +68 -0
  37. package/src/docs/index.ts +1 -0
  38. package/src/docs/learning-patterns.docblock.ts +30 -0
  39. package/src/events.ts +16 -0
  40. package/src/example.ts +24 -0
  41. package/src/index.ts +10 -0
  42. package/src/learning-patterns.test.ts +256 -0
  43. package/src/tracks/ambient-coach.ts +44 -0
  44. package/src/tracks/drills.ts +51 -0
  45. package/src/tracks/index.ts +3 -0
  46. package/src/tracks/quests.ts +44 -0
  47. package/tsconfig.json +19 -0
  48. package/tsconfig.tsbuildinfo +1 -0
  49. package/tsdown.config.js +7 -0
@@ -0,0 +1,39 @@
1
+ $ tsdown
2
+ ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
3
+ ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-patterns/tsdown.config.js
4
+ ℹ entry: src/events.ts, src/example.ts, src/index.ts, src/tracks/ambient-coach.ts, src/tracks/drills.ts, src/tracks/index.ts, src/tracks/quests.ts, src/docs/index.ts, src/docs/learning-patterns.docblock.ts
5
+ ℹ target: esnext
6
+ ℹ tsconfig: tsconfig.json
7
+ ℹ Build start
8
+ ℹ Cleaning 31 files
9
+ ℹ dist/tracks/drills.js 1.21 kB │ gzip: 0.59 kB
10
+ ℹ dist/docs/learning-patterns.docblock.js 1.15 kB │ gzip: 0.57 kB
11
+ ℹ dist/tracks/quests.js 1.11 kB │ gzip: 0.48 kB
12
+ ℹ dist/tracks/ambient-coach.js 1.07 kB │ gzip: 0.48 kB
13
+ ℹ dist/example.js 0.74 kB │ gzip: 0.41 kB
14
+ ℹ dist/events.js 0.53 kB │ gzip: 0.31 kB
15
+ ℹ dist/index.js 0.50 kB │ gzip: 0.20 kB
16
+ ℹ dist/tracks/index.js 0.29 kB │ gzip: 0.12 kB
17
+ ℹ dist/docs/index.js 0.04 kB │ gzip: 0.06 kB
18
+ ℹ dist/tracks/drills.js.map 2.13 kB │ gzip: 0.85 kB
19
+ ℹ dist/tracks/quests.js.map 1.96 kB │ gzip: 0.74 kB
20
+ ℹ dist/tracks/ambient-coach.js.map 1.86 kB │ gzip: 0.74 kB
21
+ ℹ dist/docs/learning-patterns.docblock.js.map 1.65 kB │ gzip: 0.74 kB
22
+ ℹ dist/example.js.map 1.09 kB │ gzip: 0.58 kB
23
+ ℹ dist/events.js.map 0.82 kB │ gzip: 0.45 kB
24
+ ℹ dist/events.d.ts.map 0.20 kB │ gzip: 0.16 kB
25
+ ℹ dist/tracks/ambient-coach.d.ts.map 0.16 kB │ gzip: 0.14 kB
26
+ ℹ dist/example.d.ts.map 0.14 kB │ gzip: 0.13 kB
27
+ ℹ dist/tracks/drills.d.ts.map 0.14 kB │ gzip: 0.13 kB
28
+ ℹ dist/tracks/quests.d.ts.map 0.14 kB │ gzip: 0.13 kB
29
+ ℹ dist/example.d.ts 0.97 kB │ gzip: 0.40 kB
30
+ ℹ dist/events.d.ts 0.73 kB │ gzip: 0.36 kB
31
+ ℹ dist/index.d.ts 0.46 kB │ gzip: 0.19 kB
32
+ ℹ dist/tracks/ambient-coach.d.ts 0.36 kB │ gzip: 0.20 kB
33
+ ℹ dist/tracks/drills.d.ts 0.32 kB │ gzip: 0.19 kB
34
+ ℹ dist/tracks/quests.d.ts 0.32 kB │ gzip: 0.19 kB
35
+ ℹ dist/tracks/index.d.ts 0.29 kB │ gzip: 0.12 kB
36
+ ℹ dist/docs/index.d.ts 0.01 kB │ gzip: 0.03 kB
37
+ ℹ dist/docs/learning-patterns.docblock.d.ts 0.01 kB │ gzip: 0.03 kB
38
+ ℹ 29 files, total: 20.41 kB
39
+ ✔ Build complete in 12112ms
@@ -0,0 +1,40 @@
1
+ $ bun build:types && bun build:bundle
2
+ $ tsc --noEmit
3
+ $ tsdown
4
+ ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
5
+ ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-patterns/tsdown.config.js
6
+ ℹ 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
7
+ ℹ target: esnext
8
+ ℹ tsconfig: tsconfig.json
9
+ ℹ Build start
10
+ ℹ dist/tracks/drills.js 1.21 kB │ gzip: 0.59 kB
11
+ ℹ dist/docs/learning-patterns.docblock.js 1.15 kB │ gzip: 0.57 kB
12
+ ℹ dist/tracks/quests.js 1.11 kB │ gzip: 0.48 kB
13
+ ℹ dist/tracks/ambient-coach.js 1.07 kB │ gzip: 0.48 kB
14
+ ℹ dist/example.js 0.74 kB │ gzip: 0.41 kB
15
+ ℹ dist/events.js 0.53 kB │ gzip: 0.31 kB
16
+ ℹ dist/index.js 0.50 kB │ gzip: 0.20 kB
17
+ ℹ dist/tracks/index.js 0.29 kB │ gzip: 0.12 kB
18
+ ℹ dist/docs/index.js 0.04 kB │ gzip: 0.06 kB
19
+ ℹ dist/tracks/drills.js.map 2.13 kB │ gzip: 0.85 kB
20
+ ℹ dist/tracks/quests.js.map 1.96 kB │ gzip: 0.74 kB
21
+ ℹ dist/tracks/ambient-coach.js.map 1.86 kB │ gzip: 0.74 kB
22
+ ℹ dist/docs/learning-patterns.docblock.js.map 1.65 kB │ gzip: 0.74 kB
23
+ ℹ dist/example.js.map 1.09 kB │ gzip: 0.58 kB
24
+ ℹ dist/events.js.map 0.82 kB │ gzip: 0.45 kB
25
+ ℹ dist/events.d.ts.map 0.20 kB │ gzip: 0.16 kB
26
+ ℹ dist/tracks/ambient-coach.d.ts.map 0.16 kB │ gzip: 0.14 kB
27
+ ℹ dist/example.d.ts.map 0.14 kB │ gzip: 0.13 kB
28
+ ℹ dist/tracks/drills.d.ts.map 0.14 kB │ gzip: 0.13 kB
29
+ ℹ dist/tracks/quests.d.ts.map 0.14 kB │ gzip: 0.13 kB
30
+ ℹ dist/example.d.ts 0.97 kB │ gzip: 0.40 kB
31
+ ℹ dist/events.d.ts 0.73 kB │ gzip: 0.36 kB
32
+ ℹ dist/index.d.ts 0.46 kB │ gzip: 0.19 kB
33
+ ℹ dist/tracks/ambient-coach.d.ts 0.36 kB │ gzip: 0.20 kB
34
+ ℹ dist/tracks/drills.d.ts 0.32 kB │ gzip: 0.19 kB
35
+ ℹ dist/tracks/quests.d.ts 0.32 kB │ gzip: 0.19 kB
36
+ ℹ dist/tracks/index.d.ts 0.29 kB │ gzip: 0.12 kB
37
+ ℹ dist/docs/index.d.ts 0.01 kB │ gzip: 0.03 kB
38
+ ℹ dist/docs/learning-patterns.docblock.d.ts 0.01 kB │ gzip: 0.03 kB
39
+ ℹ 29 files, total: 20.41 kB
40
+ ✔ Build complete in 14309ms
package/CHANGELOG.md ADDED
@@ -0,0 +1,178 @@
1
+ # @contractspec/example.learning-patterns
2
+
3
+ ## 1.44.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 5f3a868: chore: isolate branding to contractspec.io
8
+
9
+ ### Patch Changes
10
+
11
+ - Updated dependencies [5f3a868]
12
+ - @contractspec/module.learning-journey@1.44.0
13
+ - @contractspec/lib.contracts@1.44.0
14
+ - @contractspec/lib.schema@1.44.0
15
+
16
+ ## 1.43.3
17
+
18
+ ### Patch Changes
19
+
20
+ - 9216062: fix: cross-platform compatibility
21
+ - Updated dependencies [9216062]
22
+ - @contractspec/module.learning-journey@1.43.4
23
+ - @contractspec/lib.contracts@1.43.4
24
+ - @contractspec/lib.schema@1.43.3
25
+
26
+ ## 1.43.2
27
+
28
+ ### Patch Changes
29
+
30
+ - 24d9759: improve documentation
31
+ - Updated dependencies [24d9759]
32
+ - @contractspec/module.learning-journey@1.43.3
33
+ - @contractspec/lib.contracts@1.43.3
34
+ - @contractspec/lib.schema@1.43.2
35
+
36
+ ## 1.43.2
37
+
38
+ ### Patch Changes
39
+
40
+ - e147271: fix: improve stability
41
+ - Updated dependencies [e147271]
42
+ - @contractspec/module.learning-journey@1.43.2
43
+ - @contractspec/lib.contracts@1.43.2
44
+ - @contractspec/lib.schema@1.43.1
45
+
46
+ ## 1.43.1
47
+
48
+ ### Patch Changes
49
+
50
+ - Updated dependencies [f28fdad]
51
+ - @contractspec/lib.contracts@1.43.1
52
+ - @contractspec/module.learning-journey@1.43.1
53
+
54
+ ## 1.43.0
55
+
56
+ ### Minor Changes
57
+
58
+ - 042d072: feat: schema declaration using json schema, including zod
59
+
60
+ ### Patch Changes
61
+
62
+ - Updated dependencies [042d072]
63
+ - @contractspec/module.learning-journey@1.43.0
64
+ - @contractspec/lib.contracts@1.43.0
65
+ - @contractspec/lib.schema@1.43.0
66
+
67
+ ## 1.42.9
68
+
69
+ ### Patch Changes
70
+
71
+ - 1e6a0f1: fix: mcp server
72
+ - Updated dependencies [1e6a0f1]
73
+ - @contractspec/module.learning-journey@1.42.10
74
+ - @contractspec/lib.contracts@1.42.10
75
+ - @contractspec/lib.schema@1.42.10
76
+
77
+ ## 1.42.8
78
+
79
+ ### Patch Changes
80
+
81
+ - 9281db7: fix ModelRegistry
82
+ - Updated dependencies [9281db7]
83
+ - @contractspec/module.learning-journey@1.42.9
84
+ - @contractspec/lib.contracts@1.42.9
85
+ - @contractspec/lib.schema@1.42.9
86
+
87
+ ## 1.42.7
88
+
89
+ ### Patch Changes
90
+
91
+ - e07b5ac: fix
92
+ - Updated dependencies [e07b5ac]
93
+ - @contractspec/module.learning-journey@1.42.8
94
+ - @contractspec/lib.contracts@1.42.8
95
+ - @contractspec/lib.schema@1.42.8
96
+
97
+ ## 1.42.6
98
+
99
+ ### Patch Changes
100
+
101
+ - e9b575d: fix release
102
+ - Updated dependencies [e9b575d]
103
+ - @contractspec/module.learning-journey@1.42.7
104
+ - @contractspec/lib.contracts@1.42.7
105
+ - @contractspec/lib.schema@1.42.7
106
+
107
+ ## 1.42.5
108
+
109
+ ### Patch Changes
110
+
111
+ - 1500242: fix tooling
112
+ - Updated dependencies [1500242]
113
+ - @contractspec/module.learning-journey@1.42.6
114
+ - @contractspec/lib.contracts@1.42.6
115
+ - @contractspec/lib.schema@1.42.6
116
+
117
+ ## 1.42.4
118
+
119
+ ### Patch Changes
120
+
121
+ - 1299719: fix vscode
122
+ - Updated dependencies [1299719]
123
+ - @contractspec/module.learning-journey@1.42.5
124
+ - @contractspec/lib.contracts@1.42.5
125
+ - @contractspec/lib.schema@1.42.5
126
+
127
+ ## 1.42.3
128
+
129
+ ### Patch Changes
130
+
131
+ - ac28b99: fix: generate from openapi
132
+ - Updated dependencies [ac28b99]
133
+ - @contractspec/module.learning-journey@1.42.4
134
+ - @contractspec/lib.contracts@1.42.4
135
+ - @contractspec/lib.schema@1.42.4
136
+
137
+ ## 1.42.2
138
+
139
+ ### Patch Changes
140
+
141
+ - 3f5d015: fix(tooling): cicd
142
+ - Updated dependencies [3f5d015]
143
+ - @contractspec/lib.contracts@1.42.3
144
+ - @contractspec/lib.schema@1.42.3
145
+ - @contractspec/module.learning-journey@1.42.3
146
+
147
+ ## 1.42.2
148
+
149
+ ### Patch Changes
150
+
151
+ - 1f9ac4c: fix
152
+ - Updated dependencies [1f9ac4c]
153
+ - @contractspec/lib.contracts@1.42.2
154
+ - @contractspec/lib.schema@1.42.2
155
+ - @contractspec/module.learning-journey@1.42.2
156
+
157
+ ## 1.42.1
158
+
159
+ ### Patch Changes
160
+
161
+ - f043995: Fix release
162
+ - Updated dependencies [f043995]
163
+ - @contractspec/module.learning-journey@1.42.1
164
+ - @contractspec/lib.contracts@1.42.1
165
+ - @contractspec/lib.schema@1.42.1
166
+
167
+ ## 1.42.0
168
+
169
+ ### Minor Changes
170
+
171
+ - 8eefd9c: initial release
172
+
173
+ ### Patch Changes
174
+
175
+ - Updated dependencies [8eefd9c]
176
+ - @contractspec/lib.contracts@1.42.0
177
+ - @contractspec/lib.schema@1.42.0
178
+ - @contractspec/module.learning-journey@1.42.0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Chaman Ventures, SASU
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,15 @@
1
+ # `@contractspec/example.learning-patterns`
2
+
3
+ Website: https://contractspec.io/
4
+
5
+
6
+ Spec-first learning archetypes designed to be **domain-agnostic**:\n+\n+- **Drills + SRS** (Duolingo-like)\n+- **Ambient Coach** (contextual tips)\n+- **Quests** (3–7 day arcs)\n+\n+All progress is **event-driven** and compatible with `@contractspec/module.learning-journey` track specs.\n+\n+## Exports\n+\n+- `tracks/*`: ready-to-use `LearningJourneyTrackSpec[]`\n+- `events`: event name constants used by the tracks\n+\n+## Running tests\n+\n+```bash\n+bun test\n+```\n+
7
+
8
+
9
+
10
+
11
+
12
+
13
+
14
+
15
+
@@ -0,0 +1 @@
1
+ export { };
@@ -0,0 +1 @@
1
+ import "./learning-patterns.docblock.js";
@@ -0,0 +1 @@
1
+ export { };
@@ -0,0 +1,31 @@
1
+ import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
2
+
3
+ //#region src/docs/learning-patterns.docblock.ts
4
+ registerDocBlocks([{
5
+ id: "docs.examples.learning-patterns.goal",
6
+ title: "Learning Patterns — Goal",
7
+ summary: "Domain-agnostic drills, ambient coaching, and quests built on Learning Journey.",
8
+ kind: "goal",
9
+ visibility: "public",
10
+ route: "/docs/examples/learning-patterns/goal",
11
+ tags: [
12
+ "learning",
13
+ "drills",
14
+ "quests",
15
+ "coaching"
16
+ ],
17
+ body: `## Why it matters
18
+ - Demonstrates multiple learning archetypes without vertical coupling.\n- Progress is event-driven (no client-side hacks).\n- SRS logic is deterministic and testable.`
19
+ }, {
20
+ id: "docs.examples.learning-patterns.reference",
21
+ title: "Learning Patterns — Reference",
22
+ summary: "Track specs and event names exported by the learning patterns example.",
23
+ kind: "reference",
24
+ visibility: "public",
25
+ route: "/docs/examples/learning-patterns",
26
+ tags: ["learning", "reference"],
27
+ body: `## Tracks\n- Drills + SRS\n- Ambient Coach\n- Quests\n\n## Events\n- drill.*\n- coach.*\n- quest.*`
28
+ }]);
29
+
30
+ //#endregion
31
+ //# sourceMappingURL=learning-patterns.docblock.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"learning-patterns.docblock.js","names":[],"sources":["../../src/docs/learning-patterns.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst docBlocks: DocBlock[] = [\n {\n id: 'docs.examples.learning-patterns.goal',\n title: 'Learning Patterns — Goal',\n summary:\n 'Domain-agnostic drills, ambient coaching, and quests built on Learning Journey.',\n kind: 'goal',\n visibility: 'public',\n route: '/docs/examples/learning-patterns/goal',\n tags: ['learning', 'drills', 'quests', 'coaching'],\n body: `## Why it matters\n- Demonstrates multiple learning archetypes without vertical coupling.\\n- Progress is event-driven (no client-side hacks).\\n- SRS logic is deterministic and testable.`,\n },\n {\n id: 'docs.examples.learning-patterns.reference',\n title: 'Learning Patterns — Reference',\n summary:\n 'Track specs and event names exported by the learning patterns example.',\n kind: 'reference',\n visibility: 'public',\n route: '/docs/examples/learning-patterns',\n tags: ['learning', 'reference'],\n body: `## Tracks\\n- Drills + SRS\\n- Ambient Coach\\n- Quests\\n\\n## Events\\n- drill.*\\n- coach.*\\n- quest.*`,\n },\n];\n\nregisterDocBlocks(docBlocks);\n"],"mappings":";;;AA6BA,kBA1B8B,CAC5B;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAY;EAAU;EAAU;EAAW;CAClD,MAAM;;CAEP,EACD;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,YAAY,YAAY;CAC/B,MAAM;CACP,CACF,CAE2B"}
@@ -0,0 +1,16 @@
1
+ //#region src/events.d.ts
2
+ declare const LEARNING_EVENTS: {
3
+ readonly DRILL_CARD_ANSWERED: "drill.card.answered";
4
+ readonly DRILL_SESSION_COMPLETED: "drill.session.completed";
5
+ readonly DRILL_CARD_MASTERED: "drill.card.mastered";
6
+ readonly COACH_TIP_TRIGGERED: "coach.tip.triggered";
7
+ readonly COACH_TIP_SHOWN: "coach.tip.shown";
8
+ readonly COACH_TIP_ACKNOWLEDGED: "coach.tip.acknowledged";
9
+ readonly COACH_TIP_ACTION_TAKEN: "coach.tip.actionTaken";
10
+ readonly QUEST_STARTED: "quest.started";
11
+ readonly QUEST_STEP_COMPLETED: "quest.step.completed";
12
+ };
13
+ type LearningEventName = (typeof LEARNING_EVENTS)[keyof typeof LEARNING_EVENTS];
14
+ //#endregion
15
+ export { LEARNING_EVENTS, LearningEventName };
16
+ //# sourceMappingURL=events.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"events.d.ts","names":[],"sources":["../src/events.ts"],"sourcesContent":[],"mappings":";cAAa;EAAA,SAAA,mBAYH,EAAA,qBAAA;EAEE,SAAA,uBACF,EAAA,yBAA8B;;;;;;;;;KAD5B,iBAAA,WACF,8BAA8B"}
package/dist/events.js ADDED
@@ -0,0 +1,16 @@
1
+ //#region src/events.ts
2
+ const LEARNING_EVENTS = {
3
+ DRILL_CARD_ANSWERED: "drill.card.answered",
4
+ DRILL_SESSION_COMPLETED: "drill.session.completed",
5
+ DRILL_CARD_MASTERED: "drill.card.mastered",
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
+ QUEST_STARTED: "quest.started",
11
+ QUEST_STEP_COMPLETED: "quest.step.completed"
12
+ };
13
+
14
+ //#endregion
15
+ export { LEARNING_EVENTS };
16
+ //# sourceMappingURL=events.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"events.js","names":[],"sources":["../src/events.ts"],"sourcesContent":["export const LEARNING_EVENTS = {\n DRILL_CARD_ANSWERED: 'drill.card.answered',\n DRILL_SESSION_COMPLETED: 'drill.session.completed',\n DRILL_CARD_MASTERED: 'drill.card.mastered',\n\n COACH_TIP_TRIGGERED: 'coach.tip.triggered',\n COACH_TIP_SHOWN: 'coach.tip.shown',\n COACH_TIP_ACKNOWLEDGED: 'coach.tip.acknowledged',\n COACH_TIP_ACTION_TAKEN: 'coach.tip.actionTaken',\n\n QUEST_STARTED: 'quest.started',\n QUEST_STEP_COMPLETED: 'quest.step.completed',\n} as const;\n\nexport type LearningEventName =\n (typeof LEARNING_EVENTS)[keyof typeof LEARNING_EVENTS];\n"],"mappings":";AAAA,MAAa,kBAAkB;CAC7B,qBAAqB;CACrB,yBAAyB;CACzB,qBAAqB;CAErB,qBAAqB;CACrB,iBAAiB;CACjB,wBAAwB;CACxB,wBAAwB;CAExB,eAAe;CACf,sBAAsB;CACvB"}
@@ -0,0 +1,33 @@
1
+ //#region src/example.d.ts
2
+ declare const example: {
3
+ readonly id: "learning-patterns";
4
+ readonly title: "Learning Patterns";
5
+ readonly summary: "Domain-agnostic learning archetypes implemented as Learning Journey tracks.";
6
+ readonly tags: readonly ["learning", "journey", "patterns"];
7
+ readonly kind: "library";
8
+ readonly visibility: "public";
9
+ readonly docs: {
10
+ readonly rootDocId: "docs.examples.learning-patterns";
11
+ };
12
+ readonly entrypoints: {
13
+ readonly packageName: "@contractspec/example.learning-patterns";
14
+ readonly docs: "./docs";
15
+ };
16
+ readonly surfaces: {
17
+ readonly templates: true;
18
+ readonly sandbox: {
19
+ readonly enabled: true;
20
+ readonly modes: readonly ["markdown", "specs"];
21
+ };
22
+ readonly studio: {
23
+ readonly enabled: true;
24
+ readonly installable: true;
25
+ };
26
+ readonly mcp: {
27
+ readonly enabled: true;
28
+ };
29
+ };
30
+ };
31
+ //#endregion
32
+ export { example as default };
33
+ //# sourceMappingURL=example.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";cAAM;EAAA,SAAA,EAqBI,EAAA,mBAAA"}
@@ -0,0 +1,35 @@
1
+ //#region src/example.ts
2
+ const example = {
3
+ id: "learning-patterns",
4
+ title: "Learning Patterns",
5
+ summary: "Domain-agnostic learning archetypes implemented as Learning Journey tracks.",
6
+ tags: [
7
+ "learning",
8
+ "journey",
9
+ "patterns"
10
+ ],
11
+ kind: "library",
12
+ visibility: "public",
13
+ docs: { rootDocId: "docs.examples.learning-patterns" },
14
+ entrypoints: {
15
+ packageName: "@contractspec/example.learning-patterns",
16
+ docs: "./docs"
17
+ },
18
+ surfaces: {
19
+ templates: true,
20
+ sandbox: {
21
+ enabled: true,
22
+ modes: ["markdown", "specs"]
23
+ },
24
+ studio: {
25
+ enabled: true,
26
+ installable: true
27
+ },
28
+ mcp: { enabled: true }
29
+ }
30
+ };
31
+ var example_default = example;
32
+
33
+ //#endregion
34
+ export { example_default as default };
35
+ //# sourceMappingURL=example.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["const example = {\n id: 'learning-patterns',\n title: 'Learning Patterns',\n summary:\n 'Domain-agnostic learning archetypes implemented as Learning Journey tracks.',\n tags: ['learning', 'journey', 'patterns'],\n kind: 'library',\n visibility: 'public',\n docs: {\n rootDocId: 'docs.examples.learning-patterns',\n },\n entrypoints: {\n packageName: '@contractspec/example.learning-patterns',\n docs: './docs',\n },\n surfaces: {\n templates: true,\n sandbox: { enabled: true, modes: ['markdown', 'specs'] },\n studio: { enabled: true, installable: true },\n mcp: { enabled: true },\n },\n} as const;\n\nexport default example;\n"],"mappings":";AAAA,MAAM,UAAU;CACd,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;EAAC;EAAY;EAAW;EAAW;CACzC,MAAM;CACN,YAAY;CACZ,MAAM,EACJ,WAAW,mCACZ;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,YAAY,QAAQ;GAAE;EACxD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}
@@ -0,0 +1,6 @@
1
+ import { LEARNING_EVENTS, LearningEventName } from "./events.js";
2
+ import example from "./example.js";
3
+ import { drillTracks, drillsTrack } from "./tracks/drills.js";
4
+ import { ambientCoachTrack, ambientCoachTracks } from "./tracks/ambient-coach.js";
5
+ import { questTrack, questTracks } from "./tracks/quests.js";
6
+ export { LEARNING_EVENTS, LearningEventName, ambientCoachTrack, ambientCoachTracks, drillTracks, drillsTrack, example, questTrack, questTracks };
package/dist/index.js ADDED
@@ -0,0 +1,9 @@
1
+ import { LEARNING_EVENTS } from "./events.js";
2
+ import example_default from "./example.js";
3
+ import { drillTracks, drillsTrack } from "./tracks/drills.js";
4
+ import { ambientCoachTrack, ambientCoachTracks } from "./tracks/ambient-coach.js";
5
+ import { questTrack, questTracks } from "./tracks/quests.js";
6
+ import "./tracks/index.js";
7
+ import "./docs/index.js";
8
+
9
+ export { LEARNING_EVENTS, ambientCoachTrack, ambientCoachTracks, drillTracks, drillsTrack, example_default as example, questTrack, questTracks };
@@ -0,0 +1,8 @@
1
+ import { LearningJourneyTrackSpec } from "@contractspec/module.learning-journey/track-spec";
2
+
3
+ //#region src/tracks/ambient-coach.d.ts
4
+ declare const ambientCoachTrack: LearningJourneyTrackSpec;
5
+ declare const ambientCoachTracks: LearningJourneyTrackSpec[];
6
+ //#endregion
7
+ export { ambientCoachTrack, ambientCoachTracks };
8
+ //# sourceMappingURL=ambient-coach.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ambient-coach.d.ts","names":[],"sources":["../../src/tracks/ambient-coach.ts"],"sourcesContent":[],"mappings":";;;cAGa,mBAAmB;cAsCnB,oBAAoB"}
@@ -0,0 +1,48 @@
1
+ import { LEARNING_EVENTS } from "../events.js";
2
+
3
+ //#region src/tracks/ambient-coach.ts
4
+ const ambientCoachTrack = {
5
+ id: "learning_patterns_ambient_coach_basics",
6
+ name: "Ambient Coach Basics",
7
+ description: "Contextual tips triggered by behavior events.",
8
+ targetUserSegment: "learner",
9
+ targetRole: "individual",
10
+ totalXp: 30,
11
+ steps: [
12
+ {
13
+ id: "tip_shown",
14
+ title: "See a contextual tip",
15
+ order: 1,
16
+ completion: {
17
+ kind: "event",
18
+ eventName: LEARNING_EVENTS.COACH_TIP_SHOWN
19
+ },
20
+ xpReward: 10
21
+ },
22
+ {
23
+ id: "tip_acknowledged",
24
+ title: "Acknowledge a tip",
25
+ order: 2,
26
+ completion: {
27
+ kind: "event",
28
+ eventName: LEARNING_EVENTS.COACH_TIP_ACKNOWLEDGED
29
+ },
30
+ xpReward: 10
31
+ },
32
+ {
33
+ id: "tip_action_taken",
34
+ title: "Take an action from a tip",
35
+ order: 3,
36
+ completion: {
37
+ kind: "event",
38
+ eventName: LEARNING_EVENTS.COACH_TIP_ACTION_TAKEN
39
+ },
40
+ xpReward: 10
41
+ }
42
+ ]
43
+ };
44
+ const ambientCoachTracks = [ambientCoachTrack];
45
+
46
+ //#endregion
47
+ export { ambientCoachTrack, ambientCoachTracks };
48
+ //# sourceMappingURL=ambient-coach.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ambient-coach.js","names":["ambientCoachTrack: LearningJourneyTrackSpec","ambientCoachTracks: LearningJourneyTrackSpec[]"],"sources":["../../src/tracks/ambient-coach.ts"],"sourcesContent":["import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';\nimport { LEARNING_EVENTS } from '../events';\n\nexport const ambientCoachTrack: LearningJourneyTrackSpec = {\n id: 'learning_patterns_ambient_coach_basics',\n name: 'Ambient Coach Basics',\n description: 'Contextual tips triggered by behavior events.',\n targetUserSegment: 'learner',\n targetRole: 'individual',\n totalXp: 30,\n steps: [\n {\n id: 'tip_shown',\n title: 'See a contextual tip',\n order: 1,\n completion: { kind: 'event', eventName: LEARNING_EVENTS.COACH_TIP_SHOWN },\n xpReward: 10,\n },\n {\n id: 'tip_acknowledged',\n title: 'Acknowledge a tip',\n order: 2,\n completion: {\n kind: 'event',\n eventName: LEARNING_EVENTS.COACH_TIP_ACKNOWLEDGED,\n },\n xpReward: 10,\n },\n {\n id: 'tip_action_taken',\n title: 'Take an action from a tip',\n order: 3,\n completion: {\n kind: 'event',\n eventName: LEARNING_EVENTS.COACH_TIP_ACTION_TAKEN,\n },\n xpReward: 10,\n },\n ],\n};\n\nexport const ambientCoachTracks: LearningJourneyTrackSpec[] = [\n ambientCoachTrack,\n];\n"],"mappings":";;;AAGA,MAAaA,oBAA8C;CACzD,IAAI;CACJ,MAAM;CACN,aAAa;CACb,mBAAmB;CACnB,YAAY;CACZ,SAAS;CACT,OAAO;EACL;GACE,IAAI;GACJ,OAAO;GACP,OAAO;GACP,YAAY;IAAE,MAAM;IAAS,WAAW,gBAAgB;IAAiB;GACzE,UAAU;GACX;EACD;GACE,IAAI;GACJ,OAAO;GACP,OAAO;GACP,YAAY;IACV,MAAM;IACN,WAAW,gBAAgB;IAC5B;GACD,UAAU;GACX;EACD;GACE,IAAI;GACJ,OAAO;GACP,OAAO;GACP,YAAY;IACV,MAAM;IACN,WAAW,gBAAgB;IAC5B;GACD,UAAU;GACX;EACF;CACF;AAED,MAAaC,qBAAiD,CAC5D,kBACD"}
@@ -0,0 +1,8 @@
1
+ import { LearningJourneyTrackSpec } from "@contractspec/module.learning-journey/track-spec";
2
+
3
+ //#region src/tracks/drills.d.ts
4
+ declare const drillsTrack: LearningJourneyTrackSpec;
5
+ declare const drillTracks: LearningJourneyTrackSpec[];
6
+ //#endregion
7
+ export { drillTracks, drillsTrack };
8
+ //# sourceMappingURL=drills.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"drills.d.ts","names":[],"sources":["../../src/tracks/drills.ts"],"sourcesContent":[],"mappings":";;;cAGa,aAAa;cA+Cb,aAAa"}
@@ -0,0 +1,54 @@
1
+ import { LEARNING_EVENTS } from "../events.js";
2
+
3
+ //#region src/tracks/drills.ts
4
+ const drillsTrack = {
5
+ id: "learning_patterns_drills_basics",
6
+ name: "Drills Basics",
7
+ description: "Short drill sessions with an SRS-style mastery step.",
8
+ targetUserSegment: "learner",
9
+ targetRole: "individual",
10
+ totalXp: 50,
11
+ steps: [
12
+ {
13
+ id: "complete_first_session",
14
+ title: "Complete your first session",
15
+ order: 1,
16
+ completion: {
17
+ kind: "event",
18
+ eventName: LEARNING_EVENTS.DRILL_SESSION_COMPLETED
19
+ },
20
+ xpReward: 10
21
+ },
22
+ {
23
+ id: "hit_accuracy_threshold",
24
+ title: "Hit high accuracy 3 times",
25
+ order: 2,
26
+ completion: {
27
+ kind: "count",
28
+ eventName: LEARNING_EVENTS.DRILL_SESSION_COMPLETED,
29
+ atLeast: 3,
30
+ payloadFilter: { accuracyBucket: "high" }
31
+ },
32
+ xpReward: 20
33
+ },
34
+ {
35
+ id: "master_cards",
36
+ title: "Master 5 cards",
37
+ order: 3,
38
+ completion: {
39
+ kind: "srs_mastery",
40
+ eventName: LEARNING_EVENTS.DRILL_CARD_MASTERED,
41
+ minimumMastery: .8,
42
+ requiredCount: 5,
43
+ skillIdField: "skillId",
44
+ masteryField: "mastery"
45
+ },
46
+ xpReward: 20
47
+ }
48
+ ]
49
+ };
50
+ const drillTracks = [drillsTrack];
51
+
52
+ //#endregion
53
+ export { drillTracks, drillsTrack };
54
+ //# sourceMappingURL=drills.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"drills.js","names":["drillsTrack: LearningJourneyTrackSpec","drillTracks: LearningJourneyTrackSpec[]"],"sources":["../../src/tracks/drills.ts"],"sourcesContent":["import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';\nimport { LEARNING_EVENTS } from '../events';\n\nexport const drillsTrack: LearningJourneyTrackSpec = {\n id: 'learning_patterns_drills_basics',\n name: 'Drills Basics',\n description: 'Short drill sessions with an SRS-style mastery step.',\n targetUserSegment: 'learner',\n targetRole: 'individual',\n totalXp: 50,\n steps: [\n {\n id: 'complete_first_session',\n title: 'Complete your first session',\n order: 1,\n completion: {\n kind: 'event',\n eventName: LEARNING_EVENTS.DRILL_SESSION_COMPLETED,\n },\n xpReward: 10,\n },\n {\n id: 'hit_accuracy_threshold',\n title: 'Hit high accuracy 3 times',\n order: 2,\n completion: {\n kind: 'count',\n eventName: LEARNING_EVENTS.DRILL_SESSION_COMPLETED,\n atLeast: 3,\n payloadFilter: { accuracyBucket: 'high' },\n },\n xpReward: 20,\n },\n {\n id: 'master_cards',\n title: 'Master 5 cards',\n order: 3,\n completion: {\n kind: 'srs_mastery',\n eventName: LEARNING_EVENTS.DRILL_CARD_MASTERED,\n minimumMastery: 0.8,\n requiredCount: 5,\n skillIdField: 'skillId',\n masteryField: 'mastery',\n },\n xpReward: 20,\n },\n ],\n};\n\nexport const drillTracks: LearningJourneyTrackSpec[] = [drillsTrack];\n"],"mappings":";;;AAGA,MAAaA,cAAwC;CACnD,IAAI;CACJ,MAAM;CACN,aAAa;CACb,mBAAmB;CACnB,YAAY;CACZ,SAAS;CACT,OAAO;EACL;GACE,IAAI;GACJ,OAAO;GACP,OAAO;GACP,YAAY;IACV,MAAM;IACN,WAAW,gBAAgB;IAC5B;GACD,UAAU;GACX;EACD;GACE,IAAI;GACJ,OAAO;GACP,OAAO;GACP,YAAY;IACV,MAAM;IACN,WAAW,gBAAgB;IAC3B,SAAS;IACT,eAAe,EAAE,gBAAgB,QAAQ;IAC1C;GACD,UAAU;GACX;EACD;GACE,IAAI;GACJ,OAAO;GACP,OAAO;GACP,YAAY;IACV,MAAM;IACN,WAAW,gBAAgB;IAC3B,gBAAgB;IAChB,eAAe;IACf,cAAc;IACd,cAAc;IACf;GACD,UAAU;GACX;EACF;CACF;AAED,MAAaC,cAA0C,CAAC,YAAY"}
@@ -0,0 +1,4 @@
1
+ import { drillTracks, drillsTrack } from "./drills.js";
2
+ import { ambientCoachTrack, ambientCoachTracks } from "./ambient-coach.js";
3
+ import { questTrack, questTracks } from "./quests.js";
4
+ export { ambientCoachTrack, ambientCoachTracks, drillTracks, drillsTrack, questTrack, questTracks };
@@ -0,0 +1,5 @@
1
+ import { drillTracks, drillsTrack } from "./drills.js";
2
+ import { ambientCoachTrack, ambientCoachTracks } from "./ambient-coach.js";
3
+ import { questTrack, questTracks } from "./quests.js";
4
+
5
+ export { ambientCoachTrack, ambientCoachTracks, drillTracks, drillsTrack, questTrack, questTracks };