@contractspec/example.learning-journey-studio-onboarding 0.0.0-canary-20260113162409

package/.turbo/turbo-build$colon$bundle.log

@@ -0,0 +1,45 @@
+$ tsdown
+ℹ tsdown v0.19.0 powered by rolldown v1.0.0-beta.59
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-journey-studio-onboarding/tsdown.config.js 
+ℹ entry: src/example.ts, src/index.ts, src/learning-journey-studio-onboarding.feature.ts, src/track.ts, src/docs/index.ts, src/docs/studio-onboarding.docblock.ts, src/handlers/demo.handlers.ts, src/operations/index.ts, src/presentations/index.ts, src/tests/operations.test-spec.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 40 files
+ℹ dist/operations/index.js                                  4.34 kB │ gzip: 1.08 kB
+ℹ dist/track.js                                             2.43 kB │ gzip: 0.91 kB
+ℹ dist/learning-journey-studio-onboarding.feature.js        1.84 kB │ gzip: 0.62 kB
+ℹ dist/docs/studio-onboarding.docblock.js                   1.67 kB │ gzip: 0.83 kB
+ℹ dist/presentations/index.js                               1.63 kB │ gzip: 0.61 kB
+ℹ dist/index.js                                             1.10 kB │ gzip: 0.31 kB
+ℹ dist/example.js                                           1.04 kB │ gzip: 0.55 kB
+ℹ dist/tests/operations.test-spec.js                        0.92 kB │ gzip: 0.42 kB
+ℹ dist/handlers/demo.handlers.js                            0.83 kB │ gzip: 0.41 kB
+ℹ dist/docs/index.js                                        0.04 kB │ gzip: 0.06 kB
+ℹ dist/operations/index.js.map                              6.42 kB │ gzip: 1.59 kB
+ℹ dist/track.js.map                                         3.79 kB │ gzip: 1.24 kB
+ℹ dist/learning-journey-studio-onboarding.feature.js.map    2.92 kB │ gzip: 1.04 kB
+ℹ dist/presentations/index.js.map                           2.35 kB │ gzip: 0.90 kB
+ℹ dist/docs/studio-onboarding.docblock.js.map               2.10 kB │ gzip: 1.00 kB
+ℹ dist/handlers/demo.handlers.js.map                        1.58 kB │ gzip: 0.71 kB
+ℹ dist/example.js.map                                       1.47 kB │ gzip: 0.74 kB
+ℹ dist/tests/operations.test-spec.js.map                    1.46 kB │ gzip: 0.62 kB
+ℹ dist/operations/index.d.ts.map                            0.84 kB │ gzip: 0.32 kB
+ℹ dist/handlers/demo.handlers.d.ts.map                      0.60 kB │ gzip: 0.33 kB
+ℹ dist/learning-journey-studio-onboarding.feature.d.ts.map  0.22 kB │ gzip: 0.16 kB
+ℹ dist/presentations/index.d.ts.map                         0.21 kB │ gzip: 0.17 kB
+ℹ dist/tests/operations.test-spec.d.ts.map                  0.17 kB │ gzip: 0.14 kB
+ℹ dist/example.d.ts.map                                     0.14 kB │ gzip: 0.13 kB
+ℹ dist/track.d.ts.map                                       0.14 kB │ gzip: 0.13 kB
+ℹ dist/operations/index.d.ts                                8.83 kB │ gzip: 0.93 kB
+ℹ dist/index.d.ts                                           1.07 kB │ gzip: 0.29 kB
+ℹ dist/handlers/demo.handlers.d.ts                          0.97 kB │ gzip: 0.42 kB
+ℹ dist/presentations/index.d.ts                             0.56 kB │ gzip: 0.22 kB
+ℹ dist/learning-journey-studio-onboarding.feature.d.ts      0.52 kB │ gzip: 0.27 kB
+ℹ dist/track.d.ts                                           0.36 kB │ gzip: 0.20 kB
+ℹ dist/tests/operations.test-spec.d.ts                      0.28 kB │ gzip: 0.18 kB
+ℹ dist/example.d.ts                                         0.25 kB │ gzip: 0.17 kB
+ℹ dist/docs/index.d.ts                                      0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/studio-onboarding.docblock.d.ts                 0.01 kB │ gzip: 0.03 kB
+ℹ 35 files, total: 53.11 kB
+✔ Build complete in 20185ms

package/.turbo/turbo-build.log

@@ -0,0 +1,46 @@
+$ bun build:types && bun build:bundle
+$ tsc --noEmit
+$ tsdown
+ℹ tsdown v0.19.0 powered by rolldown v1.0.0-beta.59
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-journey-studio-onboarding/tsdown.config.js 
+ℹ entry: src/example.ts, src/index.ts, src/learning-journey-studio-onboarding.feature.ts, src/track.ts, src/docs/index.ts, src/docs/studio-onboarding.docblock.ts, src/handlers/demo.handlers.ts, src/operations/index.ts, src/presentations/index.ts, src/tests/operations.test-spec.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/operations/index.js                                  4.34 kB │ gzip: 1.08 kB
+ℹ dist/track.js                                             2.43 kB │ gzip: 0.91 kB
+ℹ dist/learning-journey-studio-onboarding.feature.js        1.84 kB │ gzip: 0.62 kB
+ℹ dist/docs/studio-onboarding.docblock.js                   1.67 kB │ gzip: 0.83 kB
+ℹ dist/presentations/index.js                               1.63 kB │ gzip: 0.61 kB
+ℹ dist/index.js                                             1.10 kB │ gzip: 0.31 kB
+ℹ dist/example.js                                           1.04 kB │ gzip: 0.55 kB
+ℹ dist/tests/operations.test-spec.js                        0.92 kB │ gzip: 0.42 kB
+ℹ dist/handlers/demo.handlers.js                            0.83 kB │ gzip: 0.41 kB
+ℹ dist/docs/index.js                                        0.04 kB │ gzip: 0.06 kB
+ℹ dist/operations/index.js.map                              6.42 kB │ gzip: 1.59 kB
+ℹ dist/track.js.map                                         3.79 kB │ gzip: 1.24 kB
+ℹ dist/learning-journey-studio-onboarding.feature.js.map    2.92 kB │ gzip: 1.04 kB
+ℹ dist/presentations/index.js.map                           2.35 kB │ gzip: 0.90 kB
+ℹ dist/docs/studio-onboarding.docblock.js.map               2.10 kB │ gzip: 1.00 kB
+ℹ dist/handlers/demo.handlers.js.map                        1.58 kB │ gzip: 0.71 kB
+ℹ dist/example.js.map                                       1.47 kB │ gzip: 0.74 kB
+ℹ dist/tests/operations.test-spec.js.map                    1.46 kB │ gzip: 0.62 kB
+ℹ dist/operations/index.d.ts.map                            0.84 kB │ gzip: 0.32 kB
+ℹ dist/handlers/demo.handlers.d.ts.map                      0.60 kB │ gzip: 0.33 kB
+ℹ dist/learning-journey-studio-onboarding.feature.d.ts.map  0.22 kB │ gzip: 0.16 kB
+ℹ dist/presentations/index.d.ts.map                         0.21 kB │ gzip: 0.17 kB
+ℹ dist/tests/operations.test-spec.d.ts.map                  0.17 kB │ gzip: 0.14 kB
+ℹ dist/example.d.ts.map                                     0.14 kB │ gzip: 0.13 kB
+ℹ dist/track.d.ts.map                                       0.14 kB │ gzip: 0.13 kB
+ℹ dist/operations/index.d.ts                                8.83 kB │ gzip: 0.93 kB
+ℹ dist/index.d.ts                                           1.07 kB │ gzip: 0.29 kB
+ℹ dist/handlers/demo.handlers.d.ts                          0.97 kB │ gzip: 0.42 kB
+ℹ dist/presentations/index.d.ts                             0.56 kB │ gzip: 0.22 kB
+ℹ dist/learning-journey-studio-onboarding.feature.d.ts      0.52 kB │ gzip: 0.27 kB
+ℹ dist/track.d.ts                                           0.36 kB │ gzip: 0.20 kB
+ℹ dist/tests/operations.test-spec.d.ts                      0.28 kB │ gzip: 0.18 kB
+ℹ dist/example.d.ts                                         0.25 kB │ gzip: 0.17 kB
+ℹ dist/docs/index.d.ts                                      0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/studio-onboarding.docblock.d.ts                 0.01 kB │ gzip: 0.03 kB
+ℹ 35 files, total: 53.11 kB
+✔ Build complete in 26953ms

package/CHANGELOG.md

@@ -0,0 +1,330 @@
+# @contractspec/example.learning-journey-studio-onboarding
+
+## 0.0.0-canary-20260113162409
+
+### Minor Changes
+
+- caf8701: feat: add cli vibe command to run workflow
+- c69b849: feat: add api web services (mcp & website)
+- 42b8d78: feat: add cli `contractspec vibe` workflow to simplify usage
+- fd38e85: feat: auto-fix contractspec issues
+
+### Patch Changes
+
+- e7ded36: feat: improve stability (adding ts-morph)
+- c231a8b: test: improve workspace stability
+- Updated dependencies [e7ded36]
+- Updated dependencies [caf8701]
+- Updated dependencies [c69b849]
+- Updated dependencies [c231a8b]
+- Updated dependencies [42b8d78]
+- Updated dependencies [fd38e85]
+  - @contractspec/module.learning-journey@0.0.0-canary-20260113162409
+  - @contractspec/lib.contracts@0.0.0-canary-20260113162409
+  - @contractspec/lib.schema@0.0.0-canary-20260113162409
+
+## 1.46.2
+
+### Patch Changes
+
+- 7e21625: feat: library services (landing page & api)
+- Updated dependencies [7e21625]
+  - @contractspec/module.learning-journey@1.46.2
+  - @contractspec/lib.contracts@1.46.2
+  - @contractspec/lib.schema@1.46.2
+
+## 1.46.1
+
+### Patch Changes
+
+- 2d8a72b: fix: mcp for presentation
+- Updated dependencies [2d8a72b]
+  - @contractspec/module.learning-journey@1.46.1
+  - @contractspec/lib.contracts@1.46.1
+  - @contractspec/lib.schema@1.46.1
+
+## 1.46.0
+
+### Minor Changes
+
+- 07cb19b: feat: feat: cleaude code & opencode integrations
+
+### Patch Changes
+
+- Updated dependencies [07cb19b]
+  - @contractspec/module.learning-journey@1.46.0
+  - @contractspec/lib.contracts@1.46.0
+  - @contractspec/lib.schema@1.46.0
+
+## 1.45.6
+
+### Patch Changes
+
+- a913074: feat: improve ai agents rules management"
+- Updated dependencies [a913074]
+  - @contractspec/module.learning-journey@1.45.6
+  - @contractspec/lib.contracts@1.45.6
+  - @contractspec/lib.schema@1.45.6
+
+## 1.45.5
+
+### Patch Changes
+
+- 9ddd7fa: feat: improve versioning
+- Updated dependencies [9ddd7fa]
+  - @contractspec/module.learning-journey@1.45.5
+  - @contractspec/lib.contracts@1.45.5
+  - @contractspec/lib.schema@1.45.5
+
+## 1.45.4
+
+### Patch Changes
+
+- fix: github action
+- Updated dependencies
+  - @contractspec/module.learning-journey@1.45.4
+  - @contractspec/lib.contracts@1.45.4
+  - @contractspec/lib.schema@1.45.4
+
+## 1.45.3
+
+### Patch Changes
+
+- e74ea9e: feat: version management
+- Updated dependencies [e74ea9e]
+  - @contractspec/module.learning-journey@1.45.3
+  - @contractspec/lib.contracts@1.45.3
+  - @contractspec/lib.schema@1.45.3
+
+## 1.45.2
+
+### Patch Changes
+
+- 39ca241: code cleaning
+- Updated dependencies [39ca241]
+  - @contractspec/module.learning-journey@1.45.2
+  - @contractspec/lib.contracts@1.45.2
+
+## 1.45.1
+
+### Patch Changes
+
+- feat: improve app config and examples contracts
+- Updated dependencies
+  - @contractspec/module.learning-journey@1.45.1
+  - @contractspec/lib.contracts@1.45.1
+  - @contractspec/lib.schema@1.45.1
+
+## 1.45.0
+
+### Minor Changes
+
+- e73ca1d: feat: improve app config and examples contracts
+  feat: Contract layers support (features, examples, app-configs)
+
+  ### New CLI Commands
+  - `contractspec list layers` - List all contract layers with filtering
+
+  ### Enhanced Commands
+  - `contractspec ci` - New `layers` check category validates features/examples/config
+  - `contractspec doctor` - New `layers` health checks
+  - `contractspec integrity` - Now shows layer statistics
+
+  ### New APIs
+  - `discoverLayers()` - Scan workspace for all layer files
+  - `scanExampleSource()` - Parse ExampleSpec from source code
+  - `isExampleFile()` - Check if file is an example spec
+
+### Patch Changes
+
+- Updated dependencies [e73ca1d]
+  - @contractspec/module.learning-journey@1.45.0
+  - @contractspec/lib.contracts@1.45.0
+  - @contractspec/lib.schema@1.45.0
+
+## 1.44.1
+
+### Patch Changes
+
+- 3c594fb: fix
+- Updated dependencies [3c594fb]
+  - @contractspec/module.learning-journey@1.44.1
+  - @contractspec/lib.contracts@1.44.1
+  - @contractspec/lib.schema@1.44.1
+
+## 1.44.0
+
+### Minor Changes
+
+- 5f3a868: chore: isolate branding to contractspec.io
+
+### Patch Changes
+
+- Updated dependencies [5f3a868]
+  - @contractspec/module.learning-journey@1.44.0
+  - @contractspec/lib.contracts@1.44.0
+  - @contractspec/lib.schema@1.44.0
+
+## 1.43.3
+
+### Patch Changes
+
+- 9216062: fix: cross-platform compatibility
+- Updated dependencies [9216062]
+  - @contractspec/module.learning-journey@1.43.4
+  - @contractspec/lib.contracts@1.43.4
+  - @contractspec/lib.schema@1.43.3
+
+## 1.43.2
+
+### Patch Changes
+
+- 24d9759: improve documentation
+- Updated dependencies [24d9759]
+  - @contractspec/module.learning-journey@1.43.3
+  - @contractspec/lib.contracts@1.43.3
+  - @contractspec/lib.schema@1.43.2
+
+## 1.43.2
+
+### Patch Changes
+
+- e147271: fix: improve stability
+- Updated dependencies [e147271]
+  - @contractspec/module.learning-journey@1.43.2
+  - @contractspec/lib.contracts@1.43.2
+  - @contractspec/lib.schema@1.43.1
+
+## 1.43.1
+
+### Patch Changes
+
+- Updated dependencies [f28fdad]
+  - @contractspec/lib.contracts@1.43.1
+  - @contractspec/module.learning-journey@1.43.1
+
+## 1.43.0
+
+### Minor Changes
+
+- 042d072: feat: schema declaration using json schema, including zod
+
+### Patch Changes
+
+- Updated dependencies [042d072]
+  - @contractspec/module.learning-journey@1.43.0
+  - @contractspec/lib.contracts@1.43.0
+  - @contractspec/lib.schema@1.43.0
+
+## 1.42.10
+
+### Patch Changes
+
+- 1e6a0f1: fix: mcp server
+- Updated dependencies [1e6a0f1]
+  - @contractspec/module.learning-journey@1.42.10
+  - @contractspec/lib.contracts@1.42.10
+  - @contractspec/lib.schema@1.42.10
+
+## 1.42.9
+
+### Patch Changes
+
+- 9281db7: fix ModelRegistry
+- Updated dependencies [9281db7]
+  - @contractspec/module.learning-journey@1.42.9
+  - @contractspec/lib.contracts@1.42.9
+  - @contractspec/lib.schema@1.42.9
+
+## 1.42.8
+
+### Patch Changes
+
+- e07b5ac: fix
+- Updated dependencies [e07b5ac]
+  - @contractspec/module.learning-journey@1.42.8
+  - @contractspec/lib.contracts@1.42.8
+  - @contractspec/lib.schema@1.42.8
+
+## 1.42.7
+
+### Patch Changes
+
+- e9b575d: fix release
+- Updated dependencies [e9b575d]
+  - @contractspec/module.learning-journey@1.42.7
+  - @contractspec/lib.contracts@1.42.7
+  - @contractspec/lib.schema@1.42.7
+
+## 1.42.6
+
+### Patch Changes
+
+- 1500242: fix tooling
+- Updated dependencies [1500242]
+  - @contractspec/module.learning-journey@1.42.6
+  - @contractspec/lib.contracts@1.42.6
+  - @contractspec/lib.schema@1.42.6
+
+## 1.42.5
+
+### Patch Changes
+
+- 1299719: fix vscode
+- Updated dependencies [1299719]
+  - @contractspec/module.learning-journey@1.42.5
+  - @contractspec/lib.contracts@1.42.5
+  - @contractspec/lib.schema@1.42.5
+
+## 1.42.4
+
+### Patch Changes
+
+- ac28b99: fix: generate from openapi
+- Updated dependencies [ac28b99]
+  - @contractspec/module.learning-journey@1.42.4
+  - @contractspec/lib.contracts@1.42.4
+  - @contractspec/lib.schema@1.42.4
+
+## 1.42.3
+
+### Patch Changes
+
+- 3f5d015: fix(tooling): cicd
+- Updated dependencies [3f5d015]
+  - @contractspec/lib.contracts@1.42.3
+  - @contractspec/lib.schema@1.42.3
+  - @contractspec/module.learning-journey@1.42.3
+
+## 1.42.2
+
+### Patch Changes
+
+- 1f9ac4c: fix
+- Updated dependencies [1f9ac4c]
+  - @contractspec/lib.contracts@1.42.2
+  - @contractspec/lib.schema@1.42.2
+  - @contractspec/module.learning-journey@1.42.2
+
+## 1.42.1
+
+### Patch Changes
+
+- f043995: Fix release
+- Updated dependencies [f043995]
+  - @contractspec/module.learning-journey@1.42.1
+  - @contractspec/lib.contracts@1.42.1
+  - @contractspec/lib.schema@1.42.1
+
+## 1.42.0
+
+### Minor Changes
+
+- 8eefd9c: initial release
+
+### Patch Changes
+
+- Updated dependencies [8eefd9c]
+  - @contractspec/lib.contracts@1.42.0
+  - @contractspec/lib.schema@1.42.0
+  - @contractspec/module.learning-journey@1.42.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,41 @@
+# @contractspec/example.learning-journey-studio-onboarding
+
+Website: https://contractspec.io/
+
+
+Learning Journey example focused on the first 30 minutes inside ContractSpec Studio.
+
+## Track
+
+- **Key**: `studio_getting_started`
+- **Persona**: new Studio developer
+- **XP**: 20/20/20/20/30 + 25 bonus within 48h
+- **Badge**: `studio_first_30m`
+
+## Steps & Events
+
+1. `choose_template` → `studio.template.instantiated`
+2. `edit_spec` → `spec.changed` (scope: sandbox)
+3. `regenerate_app` → `regeneration.completed`
+4. `play_in_playground` → `playground.session.started`
+5. `try_evolution_mode` → `studio.evolution.applied`
+
+## Usage
+
+- Import track specs:  
+  `import { studioLearningTracks } from '@contractspec/example.learning-journey-studio-onboarding/track'`
+- Contracts/handlers for demos:  
+  `import { GetStudioOnboardingTrack, RecordStudioOnboardingEvent } from '@contractspec/example.learning-journey-studio-onboarding/contracts'`  
+  `import { emitStudioOnboardingEvent } from '@contractspec/example.learning-journey-studio-onboarding/handlers/demo.handlers'`
+- Presentations (react/markdown/json targets):  
+  `import { studioOnboardingPresentations } from '@contractspec/example.learning-journey-studio-onboarding/presentations'`
+- Register with Learning Journey surfaces via onboarding API:
+  - `learning.onboarding.listTracks` to surface catalog
+  - `learning.onboarding.getProgress` to show status
+  - `learning.onboarding.recordEvent` in event-bus handlers to advance steps
+- Wire events from Studio surfaces (template spawn, spec save, regeneration, playground session start, evolution apply) to `recordEvent`.
+
+## Docs
+
+- Docblock: `src/docs/studio-onboarding.docblock.ts`
+- Route suggestion: `/docs/learning-journey/studio-onboarding`

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

@@ -0,0 +1 @@
+import "./studio-onboarding.docblock.js";

package/dist/docs/studio-onboarding.docblock.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/studio-onboarding.docblock.js

@@ -0,0 +1,40 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts";
+
+//#region src/docs/studio-onboarding.docblock.ts
+registerDocBlocks([{
+	id: "docs.learning-journey.studio-onboarding",
+	title: "Learning Journey — Studio Getting Started",
+	summary: "Track that guides a new Studio user through template spawn, spec edit, regeneration, playground, and evolution.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/learning-journey/studio-onboarding",
+	tags: [
+		"learning",
+		"onboarding",
+		"studio"
+	],
+	body: `## Track
+- **Key**: \`studio_getting_started\`
+- **Persona**: new Studio developer, first 30 minutes
+- **Goal**: instantiate template → edit spec → regenerate → play → run evolution
+
+## Steps & Events
+1) \`choose_template\` → event \`studio.template.instantiated\`
+2) \`edit_spec\` → event \`spec.changed\` (scope: sandbox)
+3) \`regenerate_app\` → event \`regeneration.completed\`
+4) \`play_in_playground\` → event \`playground.session.started\`
+5) \`try_evolution_mode\` → event \`studio.evolution.applied\`
+
+XP: 20/20/20/20/30 with bonus 25 XP if completed within 48h (streak rule). Badge: \`studio_first_30m\`.
+
+## Wiring
+- Tracks export from \`@contractspec/example.learning-journey-studio-onboarding/track\`.
+- Use onboarding API:
+  - \`learning.onboarding.listTracks\` to surface catalog
+  - \`learning.onboarding.getProgress\` to render progress
+  - \`learning.onboarding.recordEvent\` to advance from bus events
+- Events should be emitted by Studio surfaces (template creation, spec save, regeneration, playground session start, evolution apply).`
+}]);
+
+//#endregion
+//# sourceMappingURL=studio-onboarding.docblock.js.map

package/dist/docs/studio-onboarding.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-onboarding.docblock.js","names":[],"sources":["../../src/docs/studio-onboarding.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts';\nimport { registerDocBlocks } from '@contractspec/lib.contracts';\n\nconst studioOnboardingDocBlocks: DocBlock[] = [\n  {\n    id: 'docs.learning-journey.studio-onboarding',\n    title: 'Learning Journey — Studio Getting Started',\n    summary:\n      'Track that guides a new Studio user through template spawn, spec edit, regeneration, playground, and evolution.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/learning-journey/studio-onboarding',\n    tags: ['learning', 'onboarding', 'studio'],\n    body: `## Track\n- **Key**: \\`studio_getting_started\\`\n- **Persona**: new Studio developer, first 30 minutes\n- **Goal**: instantiate template → edit spec → regenerate → play → run evolution\n\n## Steps & Events\n1) \\`choose_template\\` → event \\`studio.template.instantiated\\`\n2) \\`edit_spec\\` → event \\`spec.changed\\` (scope: sandbox)\n3) \\`regenerate_app\\` → event \\`regeneration.completed\\`\n4) \\`play_in_playground\\` → event \\`playground.session.started\\`\n5) \\`try_evolution_mode\\` → event \\`studio.evolution.applied\\`\n\nXP: 20/20/20/20/30 with bonus 25 XP if completed within 48h (streak rule). Badge: \\`studio_first_30m\\`.\n\n## Wiring\n- Tracks export from \\`@contractspec/example.learning-journey-studio-onboarding/track\\`.\n- Use onboarding API:\n  - \\`learning.onboarding.listTracks\\` to surface catalog\n  - \\`learning.onboarding.getProgress\\` to render progress\n  - \\`learning.onboarding.recordEvent\\` to advance from bus events\n- Events should be emitted by Studio surfaces (template creation, spec save, regeneration, playground session start, evolution apply).`,\n  },\n];\n\nregisterDocBlocks(studioOnboardingDocBlocks);\n"],"mappings":";;;AAqCA,kBAlC8C,CAC5C;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAY;EAAc;EAAS;CAC1C,MAAM;;;;;;;;;;;;;;;;;;;;;CAqBP,CACF,CAE2C"}

package/dist/example.d.ts

@@ -0,0 +1,7 @@
+import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
+
+//#region src/example.d.ts
+declare const example: _contractspec_lib_contracts0.ExampleSpec;
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";;;cAEM,SA0BJ,4BAAA,CA1BW"}

package/dist/example.js

@@ -0,0 +1,42 @@
+import { defineExample } from "@contractspec/lib.contracts";
+
+//#region src/example.ts
+const example = defineExample({
+	meta: {
+		key: "learning-journey-studio-onboarding",
+		version: "1.0.0",
+		title: "Learning Journey — Studio Getting Started",
+		description: "Onboarding track guiding a new Studio user through template spawn, spec edit, regeneration, playground, and evolution.",
+		kind: "template",
+		visibility: "public",
+		stability: "experimental",
+		owners: ["@platform.core"],
+		tags: [
+			"learning",
+			"onboarding",
+			"studio"
+		]
+	},
+	docs: { rootDocId: "docs.learning-journey.studio-onboarding" },
+	entrypoints: {
+		packageName: "@contractspec/example.learning-journey-studio-onboarding",
+		docs: "./docs"
+	},
+	surfaces: {
+		templates: true,
+		sandbox: {
+			enabled: true,
+			modes: ["playground", "markdown"]
+		},
+		studio: {
+			enabled: true,
+			installable: true
+		},
+		mcp: { enabled: true }
+	}
+});
+var example_default = example;
+
+//#endregion
+export { example_default as default };
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +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-studio-onboarding',\n    version: '1.0.0',\n    title: 'Learning Journey — Studio Getting Started',\n    description:\n      'Onboarding track guiding a new Studio user through template spawn, spec edit, regeneration, playground, and evolution.',\n    kind: 'template',\n    visibility: 'public',\n    stability: 'experimental',\n    owners: ['@platform.core'],\n    tags: ['learning', 'onboarding', 'studio'],\n  },\n  docs: {\n    rootDocId: 'docs.learning-journey.studio-onboarding',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.learning-journey-studio-onboarding',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['playground', 'markdown'] },\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;GAAc;GAAS;EAC3C;CACD,MAAM,EACJ,WAAW,2CACZ;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,cAAc,WAAW;GAAE;EAC7D,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF,CAAC;AAEF,sBAAe"}

package/dist/handlers/demo.handlers.d.ts

@@ -0,0 +1,23 @@
+//#region src/handlers/demo.handlers.d.ts
+interface EmitParams {
+  learnerId: string;
+  occurredAt?: Date;
+}
+interface LearningJourneyEvent {
+  learnerId: string;
+  name: string;
+  occurredAt: Date;
+  trackId: string;
+  payload?: Record<string, unknown>;
+}
+type RecordEvent = (event: LearningJourneyEvent) => unknown;
+declare const studioOnboardingEvents: readonly ["studio.template.instantiated", "spec.changed", "regeneration.completed", "playground.session.started", "studio.evolution.applied"];
+type StudioEvent = (typeof studioOnboardingEvents)[number];
+declare const emitStudioOnboardingEvent: (eventName: StudioEvent, {
+  learnerId,
+  occurredAt
+}: EmitParams, record?: RecordEvent) => unknown;
+declare const emitAllStudioOnboardingEvents: (params: EmitParams, record?: RecordEvent) => unknown[];
+//#endregion
+export { StudioEvent, emitAllStudioOnboardingEvents, emitStudioOnboardingEvent, studioOnboardingEvents };
+//# sourceMappingURL=demo.handlers.d.ts.map

package/dist/handlers/demo.handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.handlers.d.ts","names":[],"sources":["../../src/handlers/demo.handlers.ts"],"sourcesContent":[],"mappings":";UAEU,UAAA;EAAA,SAAA,EAAA,MAAU;EAKV,UAAA,CAAA,EAHK,IAGL;AAKQ;AAKlB,UAVU,oBAAA,CAgBA;EAEE,SAAA,EAAA,MAAW;EAEV,IAAA,EAAA,MAAA;EACA,UAAA,EAlBC,IAkBD;EACX,OAAA,EAAA,MAAA;EAAA,OAAA,CAAA,EAjBU,MAiBV,CAAA,MAAA,EAAA,OAAA,CAAA;;KAdG,WAAA,GAeM,CAAA,KAAA,EAfgB,oBAehB,EAAA,GAAA,OAAA;AAAW,cAbT,sBAaS,EAAA,SAAA,CAAA,8BAAA,EAAA,cAAA,EAAA,wBAAA,EAAA,4BAAA,EAAA,0BAAA,CAAA;AAWT,KAhBD,WAAA,GAgBC,CAAA,OAhBqB,sBAiBxB,CAAA,CAAA,MACC,CAAA;cAhBE,uCACA;;;GAC6B,qBAC/B;cAWE,wCACH,qBACC"}

package/dist/handlers/demo.handlers.js

@@ -0,0 +1,24 @@
+import { studioGettingStartedTrack } from "../track.js";
+
+//#region src/handlers/demo.handlers.ts
+const studioOnboardingEvents = [
+	"studio.template.instantiated",
+	"spec.changed",
+	"regeneration.completed",
+	"playground.session.started",
+	"studio.evolution.applied"
+];
+const emitStudioOnboardingEvent = (eventName, { learnerId, occurredAt = /* @__PURE__ */ new Date() }, record) => {
+	const event = {
+		learnerId,
+		name: eventName,
+		occurredAt,
+		trackId: studioGettingStartedTrack.id
+	};
+	return record ? record(event) : event;
+};
+const emitAllStudioOnboardingEvents = (params, record) => studioOnboardingEvents.map((name) => emitStudioOnboardingEvent(name, params, record));
+
+//#endregion
+export { emitAllStudioOnboardingEvents, emitStudioOnboardingEvent, studioOnboardingEvents };
+//# sourceMappingURL=demo.handlers.js.map

package/dist/handlers/demo.handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.handlers.js","names":[],"sources":["../../src/handlers/demo.handlers.ts"],"sourcesContent":["import { studioGettingStartedTrack } from '../track';\n\ninterface EmitParams {\n  learnerId: string;\n  occurredAt?: Date;\n}\n\ninterface LearningJourneyEvent {\n  learnerId: string;\n  name: string;\n  occurredAt: Date;\n  trackId: string;\n  payload?: Record<string, unknown>;\n}\n\ntype RecordEvent = (event: LearningJourneyEvent) => unknown;\n\nexport const studioOnboardingEvents = [\n  'studio.template.instantiated',\n  'spec.changed',\n  'regeneration.completed',\n  'playground.session.started',\n  'studio.evolution.applied',\n] as const;\n\nexport type StudioEvent = (typeof studioOnboardingEvents)[number];\n\nexport const emitStudioOnboardingEvent = (\n  eventName: StudioEvent,\n  { learnerId, occurredAt = new Date() }: EmitParams,\n  record?: RecordEvent\n) => {\n  const event: LearningJourneyEvent = {\n    learnerId,\n    name: eventName,\n    occurredAt,\n    trackId: studioGettingStartedTrack.id,\n  };\n  return record ? record(event) : event;\n};\n\nexport const emitAllStudioOnboardingEvents = (\n  params: EmitParams,\n  record?: RecordEvent\n) =>\n  studioOnboardingEvents.map((name) =>\n    emitStudioOnboardingEvent(name, params, record)\n  );\n"],"mappings":";;;AAiBA,MAAa,yBAAyB;CACpC;CACA;CACA;CACA;CACA;CACD;AAID,MAAa,6BACX,WACA,EAAE,WAAW,6BAAa,IAAI,MAAM,IACpC,WACG;CACH,MAAM,QAA8B;EAClC;EACA,MAAM;EACN;EACA,SAAS,0BAA0B;EACpC;AACD,QAAO,SAAS,OAAO,MAAM,GAAG;;AAGlC,MAAa,iCACX,QACA,WAEA,uBAAuB,KAAK,SAC1B,0BAA0B,MAAM,QAAQ,OAAO,CAChD"}