@contractspec/example.learning-journey-platform-tour 0.0.0-canary-20260113162409

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 (56) hide show
  1. package/.turbo/turbo-build$colon$bundle.log +45 -0
  2. package/.turbo/turbo-build.log +46 -0
  3. package/CHANGELOG.md +330 -0
  4. package/LICENSE +21 -0
  5. package/README.md +43 -0
  6. package/dist/docs/index.d.ts +1 -0
  7. package/dist/docs/index.js +1 -0
  8. package/dist/docs/platform-tour.docblock.d.ts +1 -0
  9. package/dist/docs/platform-tour.docblock.js +42 -0
  10. package/dist/docs/platform-tour.docblock.js.map +1 -0
  11. package/dist/example.d.ts +7 -0
  12. package/dist/example.d.ts.map +1 -0
  13. package/dist/example.js +46 -0
  14. package/dist/example.js.map +1 -0
  15. package/dist/handlers/demo.handlers.d.ts +25 -0
  16. package/dist/handlers/demo.handlers.d.ts.map +1 -0
  17. package/dist/handlers/demo.handlers.js +27 -0
  18. package/dist/handlers/demo.handlers.js.map +1 -0
  19. package/dist/index.d.ts +7 -0
  20. package/dist/index.js +9 -0
  21. package/dist/learning-journey-platform-tour.feature.d.ts +12 -0
  22. package/dist/learning-journey-platform-tour.feature.d.ts.map +1 -0
  23. package/dist/learning-journey-platform-tour.feature.js +75 -0
  24. package/dist/learning-journey-platform-tour.feature.js.map +1 -0
  25. package/dist/operations/index.d.ts +271 -0
  26. package/dist/operations/index.d.ts.map +1 -0
  27. package/dist/operations/index.js +176 -0
  28. package/dist/operations/index.js.map +1 -0
  29. package/dist/presentations/index.d.ts +9 -0
  30. package/dist/presentations/index.d.ts.map +1 -0
  31. package/dist/presentations/index.js +55 -0
  32. package/dist/presentations/index.js.map +1 -0
  33. package/dist/tests/operations.test-spec.d.ts +7 -0
  34. package/dist/tests/operations.test-spec.d.ts.map +1 -0
  35. package/dist/tests/operations.test-spec.js +36 -0
  36. package/dist/tests/operations.test-spec.js.map +1 -0
  37. package/dist/track.d.ts +8 -0
  38. package/dist/track.d.ts.map +1 -0
  39. package/dist/track.js +106 -0
  40. package/dist/track.js.map +1 -0
  41. package/example.ts +1 -0
  42. package/package.json +66 -0
  43. package/src/docs/index.ts +1 -0
  44. package/src/docs/platform-tour.docblock.ts +40 -0
  45. package/src/example.ts +33 -0
  46. package/src/handlers/demo.handlers.ts +50 -0
  47. package/src/index.ts +7 -0
  48. package/src/learning-journey-platform-tour.feature.ts +66 -0
  49. package/src/operations/index.test.ts +49 -0
  50. package/src/operations/index.ts +122 -0
  51. package/src/presentations/index.ts +51 -0
  52. package/src/tests/operations.test-spec.ts +31 -0
  53. package/src/track.ts +106 -0
  54. package/tsconfig.json +9 -0
  55. package/tsconfig.tsbuildinfo +1 -0
  56. package/tsdown.config.js +17 -0
@@ -0,0 +1,45 @@
1
+ $ tsdown
2
+ ℹ tsdown v0.19.0 powered by rolldown v1.0.0-beta.59
3
+ ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-journey-platform-tour/tsdown.config.js
4
+ ℹ entry: src/example.ts, src/index.ts, src/learning-journey-platform-tour.feature.ts, src/track.ts, src/docs/index.ts, src/docs/platform-tour.docblock.ts, src/handlers/demo.handlers.ts, src/operations/index.ts, src/tests/operations.test-spec.ts, src/presentations/index.ts
5
+ ℹ target: esnext
6
+ ℹ tsconfig: tsconfig.json
7
+ ℹ Build start
8
+ ℹ Cleaning 40 files
9
+ ℹ dist/operations/index.js 4.26 kB │ gzip: 1.08 kB
10
+ ℹ dist/track.js 2.85 kB │ gzip: 0.91 kB
11
+ ℹ dist/learning-journey-platform-tour.feature.js 1.81 kB │ gzip: 0.62 kB
12
+ ℹ dist/docs/platform-tour.docblock.js 1.57 kB │ gzip: 0.81 kB
13
+ ℹ dist/presentations/index.js 1.49 kB │ gzip: 0.58 kB
14
+ ℹ dist/example.js 1.07 kB │ gzip: 0.52 kB
15
+ ℹ dist/index.js 1.01 kB │ gzip: 0.31 kB
16
+ ℹ dist/tests/operations.test-spec.js 0.90 kB │ gzip: 0.42 kB
17
+ ℹ dist/handlers/demo.handlers.js 0.83 kB │ gzip: 0.42 kB
18
+ ℹ dist/docs/index.js 0.04 kB │ gzip: 0.06 kB
19
+ ℹ dist/operations/index.js.map 6.35 kB │ gzip: 1.59 kB
20
+ ℹ dist/track.js.map 4.47 kB │ gzip: 1.24 kB
21
+ ℹ dist/learning-journey-platform-tour.feature.js.map 2.86 kB │ gzip: 1.02 kB
22
+ ℹ dist/presentations/index.js.map 2.17 kB │ gzip: 0.86 kB
23
+ ℹ dist/docs/platform-tour.docblock.js.map 2.01 kB │ gzip: 0.97 kB
24
+ ℹ dist/handlers/demo.handlers.js.map 1.65 kB │ gzip: 0.72 kB
25
+ ℹ dist/example.js.map 1.52 kB │ gzip: 0.72 kB
26
+ ℹ dist/tests/operations.test-spec.js.map 1.44 kB │ gzip: 0.61 kB
27
+ ℹ dist/operations/index.d.ts.map 0.84 kB │ gzip: 0.32 kB
28
+ ℹ dist/handlers/demo.handlers.d.ts.map 0.68 kB │ gzip: 0.35 kB
29
+ ℹ dist/learning-journey-platform-tour.feature.d.ts.map 0.21 kB │ gzip: 0.16 kB
30
+ ℹ dist/presentations/index.d.ts.map 0.21 kB │ gzip: 0.17 kB
31
+ ℹ dist/tests/operations.test-spec.d.ts.map 0.17 kB │ gzip: 0.14 kB
32
+ ℹ dist/example.d.ts.map 0.14 kB │ gzip: 0.13 kB
33
+ ℹ dist/track.d.ts.map 0.14 kB │ gzip: 0.13 kB
34
+ ℹ dist/operations/index.d.ts 8.79 kB │ gzip: 0.93 kB
35
+ ℹ dist/handlers/demo.handlers.d.ts 1.00 kB │ gzip: 0.43 kB
36
+ ℹ dist/index.d.ts 0.99 kB │ gzip: 0.29 kB
37
+ ℹ dist/presentations/index.d.ts 0.54 kB │ gzip: 0.22 kB
38
+ ℹ dist/learning-journey-platform-tour.feature.d.ts 0.49 kB │ gzip: 0.27 kB
39
+ ℹ dist/track.d.ts 0.37 kB │ gzip: 0.20 kB
40
+ ℹ dist/tests/operations.test-spec.d.ts 0.28 kB │ gzip: 0.18 kB
41
+ ℹ dist/example.d.ts 0.25 kB │ gzip: 0.17 kB
42
+ ℹ dist/docs/index.d.ts 0.01 kB │ gzip: 0.03 kB
43
+ ℹ dist/docs/platform-tour.docblock.d.ts 0.01 kB │ gzip: 0.03 kB
44
+ ℹ 35 files, total: 53.40 kB
45
+ ✔ Build complete in 20573ms
@@ -0,0 +1,46 @@
1
+ $ bun build:types && bun build:bundle
2
+ $ tsc --noEmit
3
+ $ tsdown
4
+ ℹ tsdown v0.19.0 powered by rolldown v1.0.0-beta.59
5
+ ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-journey-platform-tour/tsdown.config.js
6
+ ℹ entry: src/example.ts, src/index.ts, src/learning-journey-platform-tour.feature.ts, src/track.ts, src/docs/index.ts, src/docs/platform-tour.docblock.ts, src/handlers/demo.handlers.ts, src/operations/index.ts, src/presentations/index.ts, src/tests/operations.test-spec.ts
7
+ ℹ target: esnext
8
+ ℹ tsconfig: tsconfig.json
9
+ ℹ Build start
10
+ ℹ dist/operations/index.js 4.26 kB │ gzip: 1.08 kB
11
+ ℹ dist/track.js 2.85 kB │ gzip: 0.91 kB
12
+ ℹ dist/learning-journey-platform-tour.feature.js 1.81 kB │ gzip: 0.62 kB
13
+ ℹ dist/docs/platform-tour.docblock.js 1.57 kB │ gzip: 0.81 kB
14
+ ℹ dist/presentations/index.js 1.49 kB │ gzip: 0.58 kB
15
+ ℹ dist/example.js 1.07 kB │ gzip: 0.52 kB
16
+ ℹ dist/index.js 1.01 kB │ gzip: 0.31 kB
17
+ ℹ dist/tests/operations.test-spec.js 0.90 kB │ gzip: 0.42 kB
18
+ ℹ dist/handlers/demo.handlers.js 0.83 kB │ gzip: 0.42 kB
19
+ ℹ dist/docs/index.js 0.04 kB │ gzip: 0.06 kB
20
+ ℹ dist/operations/index.js.map 6.35 kB │ gzip: 1.59 kB
21
+ ℹ dist/track.js.map 4.47 kB │ gzip: 1.24 kB
22
+ ℹ dist/learning-journey-platform-tour.feature.js.map 2.86 kB │ gzip: 1.02 kB
23
+ ℹ dist/presentations/index.js.map 2.17 kB │ gzip: 0.86 kB
24
+ ℹ dist/docs/platform-tour.docblock.js.map 2.01 kB │ gzip: 0.97 kB
25
+ ℹ dist/handlers/demo.handlers.js.map 1.65 kB │ gzip: 0.72 kB
26
+ ℹ dist/example.js.map 1.52 kB │ gzip: 0.72 kB
27
+ ℹ dist/tests/operations.test-spec.js.map 1.44 kB │ gzip: 0.61 kB
28
+ ℹ dist/operations/index.d.ts.map 0.84 kB │ gzip: 0.32 kB
29
+ ℹ dist/handlers/demo.handlers.d.ts.map 0.68 kB │ gzip: 0.35 kB
30
+ ℹ dist/learning-journey-platform-tour.feature.d.ts.map 0.21 kB │ gzip: 0.16 kB
31
+ ℹ dist/presentations/index.d.ts.map 0.21 kB │ gzip: 0.17 kB
32
+ ℹ dist/tests/operations.test-spec.d.ts.map 0.17 kB │ gzip: 0.14 kB
33
+ ℹ dist/example.d.ts.map 0.14 kB │ gzip: 0.13 kB
34
+ ℹ dist/track.d.ts.map 0.14 kB │ gzip: 0.13 kB
35
+ ℹ dist/operations/index.d.ts 8.79 kB │ gzip: 0.93 kB
36
+ ℹ dist/handlers/demo.handlers.d.ts 1.00 kB │ gzip: 0.43 kB
37
+ ℹ dist/index.d.ts 0.99 kB │ gzip: 0.29 kB
38
+ ℹ dist/presentations/index.d.ts 0.54 kB │ gzip: 0.22 kB
39
+ ℹ dist/learning-journey-platform-tour.feature.d.ts 0.49 kB │ gzip: 0.26 kB
40
+ ℹ dist/track.d.ts 0.37 kB │ gzip: 0.20 kB
41
+ ℹ dist/tests/operations.test-spec.d.ts 0.28 kB │ gzip: 0.18 kB
42
+ ℹ dist/example.d.ts 0.25 kB │ gzip: 0.17 kB
43
+ ℹ dist/docs/index.d.ts 0.01 kB │ gzip: 0.03 kB
44
+ ℹ dist/docs/platform-tour.docblock.d.ts 0.01 kB │ gzip: 0.03 kB
45
+ ℹ 35 files, total: 53.40 kB
46
+ ✔ Build complete in 28781ms
package/CHANGELOG.md ADDED
@@ -0,0 +1,330 @@
1
+ # @contractspec/example.learning-journey-platform-tour
2
+
3
+ ## 0.0.0-canary-20260113162409
4
+
5
+ ### Minor Changes
6
+
7
+ - caf8701: feat: add cli vibe command to run workflow
8
+ - c69b849: feat: add api web services (mcp & website)
9
+ - 42b8d78: feat: add cli `contractspec vibe` workflow to simplify usage
10
+ - fd38e85: feat: auto-fix contractspec issues
11
+
12
+ ### Patch Changes
13
+
14
+ - e7ded36: feat: improve stability (adding ts-morph)
15
+ - c231a8b: test: improve workspace stability
16
+ - Updated dependencies [e7ded36]
17
+ - Updated dependencies [caf8701]
18
+ - Updated dependencies [c69b849]
19
+ - Updated dependencies [c231a8b]
20
+ - Updated dependencies [42b8d78]
21
+ - Updated dependencies [fd38e85]
22
+ - @contractspec/module.learning-journey@0.0.0-canary-20260113162409
23
+ - @contractspec/lib.contracts@0.0.0-canary-20260113162409
24
+ - @contractspec/lib.schema@0.0.0-canary-20260113162409
25
+
26
+ ## 1.46.2
27
+
28
+ ### Patch Changes
29
+
30
+ - 7e21625: feat: library services (landing page & api)
31
+ - Updated dependencies [7e21625]
32
+ - @contractspec/module.learning-journey@1.46.2
33
+ - @contractspec/lib.contracts@1.46.2
34
+ - @contractspec/lib.schema@1.46.2
35
+
36
+ ## 1.46.1
37
+
38
+ ### Patch Changes
39
+
40
+ - 2d8a72b: fix: mcp for presentation
41
+ - Updated dependencies [2d8a72b]
42
+ - @contractspec/module.learning-journey@1.46.1
43
+ - @contractspec/lib.contracts@1.46.1
44
+ - @contractspec/lib.schema@1.46.1
45
+
46
+ ## 1.46.0
47
+
48
+ ### Minor Changes
49
+
50
+ - 07cb19b: feat: feat: cleaude code & opencode integrations
51
+
52
+ ### Patch Changes
53
+
54
+ - Updated dependencies [07cb19b]
55
+ - @contractspec/module.learning-journey@1.46.0
56
+ - @contractspec/lib.contracts@1.46.0
57
+ - @contractspec/lib.schema@1.46.0
58
+
59
+ ## 1.45.6
60
+
61
+ ### Patch Changes
62
+
63
+ - a913074: feat: improve ai agents rules management"
64
+ - Updated dependencies [a913074]
65
+ - @contractspec/module.learning-journey@1.45.6
66
+ - @contractspec/lib.contracts@1.45.6
67
+ - @contractspec/lib.schema@1.45.6
68
+
69
+ ## 1.45.5
70
+
71
+ ### Patch Changes
72
+
73
+ - 9ddd7fa: feat: improve versioning
74
+ - Updated dependencies [9ddd7fa]
75
+ - @contractspec/module.learning-journey@1.45.5
76
+ - @contractspec/lib.contracts@1.45.5
77
+ - @contractspec/lib.schema@1.45.5
78
+
79
+ ## 1.45.4
80
+
81
+ ### Patch Changes
82
+
83
+ - fix: github action
84
+ - Updated dependencies
85
+ - @contractspec/module.learning-journey@1.45.4
86
+ - @contractspec/lib.contracts@1.45.4
87
+ - @contractspec/lib.schema@1.45.4
88
+
89
+ ## 1.45.3
90
+
91
+ ### Patch Changes
92
+
93
+ - e74ea9e: feat: version management
94
+ - Updated dependencies [e74ea9e]
95
+ - @contractspec/module.learning-journey@1.45.3
96
+ - @contractspec/lib.contracts@1.45.3
97
+ - @contractspec/lib.schema@1.45.3
98
+
99
+ ## 1.45.2
100
+
101
+ ### Patch Changes
102
+
103
+ - 39ca241: code cleaning
104
+ - Updated dependencies [39ca241]
105
+ - @contractspec/module.learning-journey@1.45.2
106
+ - @contractspec/lib.contracts@1.45.2
107
+
108
+ ## 1.45.1
109
+
110
+ ### Patch Changes
111
+
112
+ - feat: improve app config and examples contracts
113
+ - Updated dependencies
114
+ - @contractspec/module.learning-journey@1.45.1
115
+ - @contractspec/lib.contracts@1.45.1
116
+ - @contractspec/lib.schema@1.45.1
117
+
118
+ ## 1.45.0
119
+
120
+ ### Minor Changes
121
+
122
+ - e73ca1d: feat: improve app config and examples contracts
123
+ feat: Contract layers support (features, examples, app-configs)
124
+
125
+ ### New CLI Commands
126
+ - `contractspec list layers` - List all contract layers with filtering
127
+
128
+ ### Enhanced Commands
129
+ - `contractspec ci` - New `layers` check category validates features/examples/config
130
+ - `contractspec doctor` - New `layers` health checks
131
+ - `contractspec integrity` - Now shows layer statistics
132
+
133
+ ### New APIs
134
+ - `discoverLayers()` - Scan workspace for all layer files
135
+ - `scanExampleSource()` - Parse ExampleSpec from source code
136
+ - `isExampleFile()` - Check if file is an example spec
137
+
138
+ ### Patch Changes
139
+
140
+ - Updated dependencies [e73ca1d]
141
+ - @contractspec/module.learning-journey@1.45.0
142
+ - @contractspec/lib.contracts@1.45.0
143
+ - @contractspec/lib.schema@1.45.0
144
+
145
+ ## 1.44.1
146
+
147
+ ### Patch Changes
148
+
149
+ - 3c594fb: fix
150
+ - Updated dependencies [3c594fb]
151
+ - @contractspec/module.learning-journey@1.44.1
152
+ - @contractspec/lib.contracts@1.44.1
153
+ - @contractspec/lib.schema@1.44.1
154
+
155
+ ## 1.44.0
156
+
157
+ ### Minor Changes
158
+
159
+ - 5f3a868: chore: isolate branding to contractspec.io
160
+
161
+ ### Patch Changes
162
+
163
+ - Updated dependencies [5f3a868]
164
+ - @contractspec/module.learning-journey@1.44.0
165
+ - @contractspec/lib.contracts@1.44.0
166
+ - @contractspec/lib.schema@1.44.0
167
+
168
+ ## 1.43.3
169
+
170
+ ### Patch Changes
171
+
172
+ - 9216062: fix: cross-platform compatibility
173
+ - Updated dependencies [9216062]
174
+ - @contractspec/module.learning-journey@1.43.4
175
+ - @contractspec/lib.contracts@1.43.4
176
+ - @contractspec/lib.schema@1.43.3
177
+
178
+ ## 1.43.2
179
+
180
+ ### Patch Changes
181
+
182
+ - 24d9759: improve documentation
183
+ - Updated dependencies [24d9759]
184
+ - @contractspec/module.learning-journey@1.43.3
185
+ - @contractspec/lib.contracts@1.43.3
186
+ - @contractspec/lib.schema@1.43.2
187
+
188
+ ## 1.43.2
189
+
190
+ ### Patch Changes
191
+
192
+ - e147271: fix: improve stability
193
+ - Updated dependencies [e147271]
194
+ - @contractspec/module.learning-journey@1.43.2
195
+ - @contractspec/lib.contracts@1.43.2
196
+ - @contractspec/lib.schema@1.43.1
197
+
198
+ ## 1.43.1
199
+
200
+ ### Patch Changes
201
+
202
+ - Updated dependencies [f28fdad]
203
+ - @contractspec/lib.contracts@1.43.1
204
+ - @contractspec/module.learning-journey@1.43.1
205
+
206
+ ## 1.43.0
207
+
208
+ ### Minor Changes
209
+
210
+ - 042d072: feat: schema declaration using json schema, including zod
211
+
212
+ ### Patch Changes
213
+
214
+ - Updated dependencies [042d072]
215
+ - @contractspec/module.learning-journey@1.43.0
216
+ - @contractspec/lib.contracts@1.43.0
217
+ - @contractspec/lib.schema@1.43.0
218
+
219
+ ## 1.42.9
220
+
221
+ ### Patch Changes
222
+
223
+ - 1e6a0f1: fix: mcp server
224
+ - Updated dependencies [1e6a0f1]
225
+ - @contractspec/module.learning-journey@1.42.10
226
+ - @contractspec/lib.contracts@1.42.10
227
+ - @contractspec/lib.schema@1.42.10
228
+
229
+ ## 1.42.8
230
+
231
+ ### Patch Changes
232
+
233
+ - 9281db7: fix ModelRegistry
234
+ - Updated dependencies [9281db7]
235
+ - @contractspec/module.learning-journey@1.42.9
236
+ - @contractspec/lib.contracts@1.42.9
237
+ - @contractspec/lib.schema@1.42.9
238
+
239
+ ## 1.42.7
240
+
241
+ ### Patch Changes
242
+
243
+ - e07b5ac: fix
244
+ - Updated dependencies [e07b5ac]
245
+ - @contractspec/module.learning-journey@1.42.8
246
+ - @contractspec/lib.contracts@1.42.8
247
+ - @contractspec/lib.schema@1.42.8
248
+
249
+ ## 1.42.6
250
+
251
+ ### Patch Changes
252
+
253
+ - e9b575d: fix release
254
+ - Updated dependencies [e9b575d]
255
+ - @contractspec/module.learning-journey@1.42.7
256
+ - @contractspec/lib.contracts@1.42.7
257
+ - @contractspec/lib.schema@1.42.7
258
+
259
+ ## 1.42.5
260
+
261
+ ### Patch Changes
262
+
263
+ - 1500242: fix tooling
264
+ - Updated dependencies [1500242]
265
+ - @contractspec/module.learning-journey@1.42.6
266
+ - @contractspec/lib.contracts@1.42.6
267
+ - @contractspec/lib.schema@1.42.6
268
+
269
+ ## 1.42.4
270
+
271
+ ### Patch Changes
272
+
273
+ - 1299719: fix vscode
274
+ - Updated dependencies [1299719]
275
+ - @contractspec/module.learning-journey@1.42.5
276
+ - @contractspec/lib.contracts@1.42.5
277
+ - @contractspec/lib.schema@1.42.5
278
+
279
+ ## 1.42.3
280
+
281
+ ### Patch Changes
282
+
283
+ - ac28b99: fix: generate from openapi
284
+ - Updated dependencies [ac28b99]
285
+ - @contractspec/module.learning-journey@1.42.4
286
+ - @contractspec/lib.contracts@1.42.4
287
+ - @contractspec/lib.schema@1.42.4
288
+
289
+ ## 1.42.2
290
+
291
+ ### Patch Changes
292
+
293
+ - 3f5d015: fix(tooling): cicd
294
+ - Updated dependencies [3f5d015]
295
+ - @contractspec/lib.contracts@1.42.3
296
+ - @contractspec/lib.schema@1.42.3
297
+ - @contractspec/module.learning-journey@1.42.3
298
+
299
+ ## 1.42.2
300
+
301
+ ### Patch Changes
302
+
303
+ - 1f9ac4c: fix
304
+ - Updated dependencies [1f9ac4c]
305
+ - @contractspec/lib.contracts@1.42.2
306
+ - @contractspec/lib.schema@1.42.2
307
+ - @contractspec/module.learning-journey@1.42.2
308
+
309
+ ## 1.42.1
310
+
311
+ ### Patch Changes
312
+
313
+ - f043995: Fix release
314
+ - Updated dependencies [f043995]
315
+ - @contractspec/module.learning-journey@1.42.1
316
+ - @contractspec/lib.contracts@1.42.1
317
+ - @contractspec/lib.schema@1.42.1
318
+
319
+ ## 1.42.0
320
+
321
+ ### Minor Changes
322
+
323
+ - 8eefd9c: initial release
324
+
325
+ ### Patch Changes
326
+
327
+ - Updated dependencies [8eefd9c]
328
+ - @contractspec/lib.contracts@1.42.0
329
+ - @contractspec/lib.schema@1.42.0
330
+ - @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,43 @@
1
+ # @contractspec/example.learning-journey-platform-tour
2
+
3
+ Website: https://contractspec.io/
4
+
5
+
6
+ Learning Journey example that tours platform primitives.
7
+
8
+ ## Track
9
+
10
+ - **Key**: `platform_primitives_tour`
11
+ - **Persona**: platform developer
12
+ - **XP**: 7 steps × 20 XP + 20 bonus
13
+ - **Badge**: `platform_primitives`
14
+
15
+ ## Steps & Events
16
+
17
+ 1. `identity_rbac` → `org.member.added`
18
+ 2. `event_bus_audit` → `audit_log.created`
19
+ 3. `notifications` → `notification.sent`
20
+ 4. `jobs_scheduler` → `job.completed`
21
+ 5. `feature_flags` → `flag.toggled`
22
+ 6. `files_attachments` → `attachment.attached`
23
+ 7. `usage_metering` → `usage.recorded`
24
+
25
+ ## Usage
26
+
27
+ - Import track specs:
28
+ `import { platformLearningTracks } from '@contractspec/example.learning-journey-platform-tour/track'`
29
+ - Contracts/handlers for demos:
30
+ `import { GetPlatformTourTrack, RecordPlatformTourEvent } from '@contractspec/example.learning-journey-platform-tour/contracts'`
31
+ `import { emitPlatformTourEvent } from '@contractspec/example.learning-journey-platform-tour/handlers/demo.handlers'`
32
+ - Presentations (react/markdown/json targets):
33
+ `import { platformTourPresentations } from '@contractspec/example.learning-journey-platform-tour/presentations'`
34
+ - Register via onboarding API:
35
+ - `learning.onboarding.listTracks`
36
+ - `learning.onboarding.getProgress`
37
+ - `learning.onboarding.recordEvent` wired from each module’s events
38
+ - Map module events (identity, audit-trail, notifications, jobs, feature-flags, files, metering) into `recordEvent`.
39
+
40
+ ## Docs
41
+
42
+ - Docblock: `src/docs/platform-tour.docblock.ts`
43
+ - Route suggestion: `/docs/learning-journey/platform-tour`
@@ -0,0 +1 @@
1
+ export { };
@@ -0,0 +1 @@
1
+ import "./platform-tour.docblock.js";
@@ -0,0 +1 @@
1
+ export { };
@@ -0,0 +1,42 @@
1
+ import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
2
+
3
+ //#region src/docs/platform-tour.docblock.ts
4
+ registerDocBlocks([{
5
+ id: "docs.learning-journey.platform-tour",
6
+ title: "Learning Journey — Platform Primitives Tour",
7
+ summary: "Cross-module tour that touches identity, audit, notifications, jobs, feature flags, files, and metering.",
8
+ kind: "reference",
9
+ visibility: "public",
10
+ route: "/docs/learning-journey/platform-tour",
11
+ tags: [
12
+ "learning",
13
+ "platform",
14
+ "onboarding"
15
+ ],
16
+ body: `## Track
17
+ - **Key**: \`platform_primitives_tour\`
18
+ - **Persona**: platform developer exploring primitives
19
+ - **Goal**: Touch each cross-cutting module once, event-driven completion
20
+
21
+ ## Steps & Events
22
+ 1) \`identity_rbac\` → \`org.member.added\`
23
+ 2) \`event_bus_audit\` → \`audit_log.created\`
24
+ 3) \`notifications\` → \`notification.sent\`
25
+ 4) \`jobs_scheduler\` → \`job.completed\`
26
+ 5) \`feature_flags\` → \`flag.toggled\`
27
+ 6) \`files_attachments\` → \`attachment.attached\`
28
+ 7) \`usage_metering\` → \`usage.recorded\`
29
+
30
+ XP: 20 per step, 20 bonus XP upon completion.
31
+
32
+ ## Wiring
33
+ - Tracks export from \`@contractspec/example.learning-journey-platform-tour/track\`.
34
+ - Use onboarding API to surface progress:
35
+ - \`learning.onboarding.listTracks\`
36
+ - \`learning.onboarding.getProgress\`
37
+ - \`learning.onboarding.recordEvent\` wired from each module's event bus handlers.
38
+ - Align event payloads with modules: identity-rbac, audit-trail, notifications, jobs, feature-flags, files, metering.`
39
+ }]);
40
+
41
+ //#endregion
42
+ //# sourceMappingURL=platform-tour.docblock.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"platform-tour.docblock.js","names":[],"sources":["../../src/docs/platform-tour.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst platformTourDocBlocks: DocBlock[] = [\n {\n id: 'docs.learning-journey.platform-tour',\n title: 'Learning Journey — Platform Primitives Tour',\n summary:\n 'Cross-module tour that touches identity, audit, notifications, jobs, feature flags, files, and metering.',\n kind: 'reference',\n visibility: 'public',\n route: '/docs/learning-journey/platform-tour',\n tags: ['learning', 'platform', 'onboarding'],\n body: `## Track\n- **Key**: \\`platform_primitives_tour\\`\n- **Persona**: platform developer exploring primitives\n- **Goal**: Touch each cross-cutting module once, event-driven completion\n\n## Steps & Events\n1) \\`identity_rbac\\` → \\`org.member.added\\`\n2) \\`event_bus_audit\\` → \\`audit_log.created\\`\n3) \\`notifications\\` → \\`notification.sent\\`\n4) \\`jobs_scheduler\\` → \\`job.completed\\`\n5) \\`feature_flags\\` → \\`flag.toggled\\`\n6) \\`files_attachments\\` → \\`attachment.attached\\`\n7) \\`usage_metering\\` → \\`usage.recorded\\`\n\nXP: 20 per step, 20 bonus XP upon completion.\n\n## Wiring\n- Tracks export from \\`@contractspec/example.learning-journey-platform-tour/track\\`.\n- Use onboarding API to surface progress:\n - \\`learning.onboarding.listTracks\\`\n - \\`learning.onboarding.getProgress\\`\n - \\`learning.onboarding.recordEvent\\` wired from each module's event bus handlers.\n- Align event payloads with modules: identity-rbac, audit-trail, notifications, jobs, feature-flags, files, metering.`,\n },\n];\n\nregisterDocBlocks(platformTourDocBlocks);\n"],"mappings":";;;AAuCA,kBApC0C,CACxC;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAY;EAAY;EAAa;CAC5C,MAAM;;;;;;;;;;;;;;;;;;;;;;;CAuBP,CACF,CAEuC"}
@@ -0,0 +1,7 @@
1
+ import * as _contractspec_lib_contracts2 from "@contractspec/lib.contracts";
2
+
3
+ //#region src/example.d.ts
4
+ declare const example: _contractspec_lib_contracts2.ExampleSpec;
5
+ //#endregion
6
+ export { example as default };
7
+ //# sourceMappingURL=example.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";;;cAEM,SA4BJ,4BAAA,CA5BW"}
@@ -0,0 +1,46 @@
1
+ import { defineExample } from "@contractspec/lib.contracts";
2
+
3
+ //#region src/example.ts
4
+ const example = defineExample({
5
+ meta: {
6
+ key: "learning-journey-platform-tour",
7
+ version: "1.0.0",
8
+ title: "Learning Journey — Platform Tour",
9
+ description: "Learning journey track + contracts + presentations for a platform tour.",
10
+ kind: "template",
11
+ visibility: "public",
12
+ stability: "experimental",
13
+ owners: ["@platform.core"],
14
+ tags: [
15
+ "learning",
16
+ "journey",
17
+ "platform-tour"
18
+ ]
19
+ },
20
+ docs: {
21
+ rootDocId: "docs.examples.platform-tour",
22
+ goalDocId: "docs.examples.platform-tour.goal",
23
+ usageDocId: "docs.examples.platform-tour.usage"
24
+ },
25
+ entrypoints: {
26
+ packageName: "@contractspec/example.learning-journey-platform-tour",
27
+ docs: "./docs"
28
+ },
29
+ surfaces: {
30
+ templates: true,
31
+ sandbox: {
32
+ enabled: true,
33
+ modes: ["markdown", "playground"]
34
+ },
35
+ studio: {
36
+ enabled: true,
37
+ installable: true
38
+ },
39
+ mcp: { enabled: true }
40
+ }
41
+ });
42
+ var example_default = example;
43
+
44
+ //#endregion
45
+ export { example_default as default };
46
+ //# sourceMappingURL=example.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["import { defineExample } from '@contractspec/lib.contracts';\n\nconst example = defineExample({\n meta: {\n key: 'learning-journey-platform-tour',\n version: '1.0.0',\n title: 'Learning Journey — Platform Tour',\n description:\n 'Learning journey track + contracts + presentations for a platform tour.',\n kind: 'template',\n visibility: 'public',\n stability: 'experimental',\n owners: ['@platform.core'],\n tags: ['learning', 'journey', 'platform-tour'],\n },\n docs: {\n rootDocId: 'docs.examples.platform-tour',\n goalDocId: 'docs.examples.platform-tour.goal',\n usageDocId: 'docs.examples.platform-tour.usage',\n },\n entrypoints: {\n packageName: '@contractspec/example.learning-journey-platform-tour',\n docs: './docs',\n },\n surfaces: {\n templates: true,\n sandbox: { enabled: true, modes: ['markdown', 'playground'] },\n studio: { enabled: true, installable: true },\n mcp: { enabled: true },\n },\n});\n\nexport default example;\n"],"mappings":";;;AAEA,MAAM,UAAU,cAAc;CAC5B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,iBAAiB;EAC1B,MAAM;GAAC;GAAY;GAAW;GAAgB;EAC/C;CACD,MAAM;EACJ,WAAW;EACX,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,YAAY,aAAa;GAAE;EAC7D,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF,CAAC;AAEF,sBAAe"}
@@ -0,0 +1,25 @@
1
+ //#region src/handlers/demo.handlers.d.ts
2
+ interface EmitParams {
3
+ learnerId: string;
4
+ occurredAt?: Date;
5
+ payload?: Record<string, unknown>;
6
+ }
7
+ interface LearningJourneyEvent {
8
+ learnerId: string;
9
+ name: string;
10
+ occurredAt: Date;
11
+ trackId: string;
12
+ payload?: Record<string, unknown>;
13
+ }
14
+ type RecordEvent = (event: LearningJourneyEvent) => unknown;
15
+ declare const platformTourEvents: readonly ["org.member.added", "audit_log.created", "notification.sent", "job.completed", "flag.toggled", "attachment.attached", "usage.recorded"];
16
+ type PlatformEvent = (typeof platformTourEvents)[number];
17
+ declare const emitPlatformTourEvent: (eventName: PlatformEvent, {
18
+ learnerId,
19
+ occurredAt,
20
+ payload
21
+ }: EmitParams, record?: RecordEvent) => unknown;
22
+ declare const emitAllPlatformTourEvents: (params: EmitParams, record?: RecordEvent) => unknown[];
23
+ //#endregion
24
+ export { PlatformEvent, emitAllPlatformTourEvents, emitPlatformTourEvent, platformTourEvents };
25
+ //# sourceMappingURL=demo.handlers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"demo.handlers.d.ts","names":[],"sources":["../../src/handlers/demo.handlers.ts"],"sourcesContent":[],"mappings":";UAEU,UAAA;EAAA,SAAA,EAAA,MAAU;EAMV,UAAA,CAAA,EAJK,IAIL;EAQL,OAAA,CAAA,EAXO,MAWI,CAAA,MAAA,EAAA,OAAW,CAAA;AAE3B;AAUA,UApBU,oBAAA,CAoBe;EAEZ,SAAA,EAAA,MAAA;EACA,IAAA,EAAA,MAAA;EACX,UAAA,EArBY,IAqBZ;EAAA,OAAA,EAAA,MAAA;EAAA,OAAA,CAAA,EAnBU,MAmBV,CAAA,MAAA,EAAA,OAAA,CAAA;;KAhBG,WAAA,GAiBM,CAAA,KAAA,EAjBgB,oBAiBhB,EAAA,GAAA,OAAA;AAAW,cAfT,kBAeS,EAAA,SAAA,CAAA,kBAAA,EAAA,mBAAA,EAAA,mBAAA,EAAA,eAAA,EAAA,cAAA,EAAA,qBAAA,EAAA,gBAAA,CAAA;AAYT,KAjBD,aAAA,GAiBC,CAAA,OAjBuB,kBAkB1B,CAAA,CACC,MAAA,CAAA;cAjBE,mCACA;;;;GACsC,qBACxC;cAYE,oCACH,qBACC"}
@@ -0,0 +1,27 @@
1
+ import { platformPrimitivesTourTrack } from "../track.js";
2
+
3
+ //#region src/handlers/demo.handlers.ts
4
+ const platformTourEvents = [
5
+ "org.member.added",
6
+ "audit_log.created",
7
+ "notification.sent",
8
+ "job.completed",
9
+ "flag.toggled",
10
+ "attachment.attached",
11
+ "usage.recorded"
12
+ ];
13
+ const emitPlatformTourEvent = (eventName, { learnerId, occurredAt = /* @__PURE__ */ new Date(), payload }, record) => {
14
+ const event = {
15
+ learnerId,
16
+ name: eventName,
17
+ occurredAt,
18
+ payload,
19
+ trackId: platformPrimitivesTourTrack.id
20
+ };
21
+ return record ? record(event) : event;
22
+ };
23
+ const emitAllPlatformTourEvents = (params, record) => platformTourEvents.map((name) => emitPlatformTourEvent(name, params, record));
24
+
25
+ //#endregion
26
+ export { emitAllPlatformTourEvents, emitPlatformTourEvent, platformTourEvents };
27
+ //# sourceMappingURL=demo.handlers.js.map