@lssm/example.learning-journey-registry 0.0.0-canary-20251212224228 → 0.0.0-canary-20251213172311

package/.turbo/turbo-build.log

@@ -2,7 +2,7 @@ $ bun build:bundle && bun build:types
 $ tsdown
 ℹ tsdown v0.17.0 powered by rolldown v1.0.0-beta.53
 ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-journey-registry/tsdown.config.js 
-ℹ entry: src/api-types.ts, src/api.ts, src/index.ts, src/progress-store.ts, src/tracks.ts, src/docs/index.ts, src/docs/learning-journey-registry.docblock.ts, src/presentations/index.ts, src/ui/LearningMiniApp.tsx, src/ui/index.ts
+ℹ entry: src/api-types.ts, src/api.ts, src/example.ts, src/index.ts, src/progress-store.ts, src/tracks.ts, src/docs/index.ts, src/docs/learning-journey-registry.docblock.ts, src/presentations/index.ts, src/ui/LearningMiniApp.tsx, src/ui/index.ts
 ℹ target: esnext
 ℹ tsconfig: tsconfig.json
 ℹ Build start
@@ -10,8 +10,9 @@ $ tsdown
 ℹ dist/ui/LearningMiniApp.js                                                     1.88 kB │ gzip: 0.70 kB
 ℹ dist/tracks.js                                                                 1.30 kB │ gzip: 0.50 kB
 ℹ dist/docs/learning-journey-registry.docblock.js                                1.21 kB │ gzip: 0.63 kB
-ℹ dist/index.js                                                                  1.06 kB │ gzip: 0.37 kB
+ℹ dist/index.js                                                                  1.10 kB │ gzip: 0.38 kB
 ℹ dist/presentations/index.js                                                    0.99 kB │ gzip: 0.39 kB
+ℹ dist/example.js                                                                0.52 kB │ gzip: 0.32 kB
 ℹ dist/progress-store.js                                                         0.43 kB │ gzip: 0.29 kB
 ℹ dist/ui/index.js                                                               0.19 kB │ gzip: 0.11 kB
 ℹ dist/docs/index.js                                                             0.05 kB │ gzip: 0.07 kB
@@ -24,14 +25,17 @@ $ tsdown
 ℹ dist/libs/contracts/src/docs/tech/templates/runtime.docblock.js                5.63 kB │ gzip: 2.58 kB
 ℹ dist/libs/contracts/src/docs/tech/workflows/overview.docblock.js               5.44 kB │ gzip: 2.26 kB
 ℹ dist/libs/contracts/src/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js    4.37 kB │ gzip: 2.06 kB
+ℹ dist/libs/contracts/src/docs/tech/telemetry-ingest.docblock.js                 3.90 kB │ gzip: 1.70 kB
+ℹ dist/libs/contracts/src/docs/tech/vscode-extension.docblock.js                 3.60 kB │ gzip: 1.39 kB
 ℹ dist/libs/contracts/src/docs/PUBLISHING.docblock.js                            3.43 kB │ gzip: 1.59 kB
 ℹ dist/libs/contracts/src/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js     3.00 kB │ gzip: 1.53 kB
 ℹ dist/libs/contracts/src/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js   2.83 kB │ gzip: 1.41 kB
 ℹ dist/libs/contracts/src/docs/tech/presentation-runtime.docblock.js             2.75 kB │ gzip: 1.30 kB
+ℹ dist/libs/contracts/src/docs/tech/contracts/openapi-export.docblock.js         1.72 kB │ gzip: 0.90 kB
+ℹ dist/libs/contracts/src/docs/tech/mcp-endpoints.docblock.js                    1.24 kB │ gzip: 0.68 kB
 ℹ dist/libs/contracts/src/docs/presentations.js                                  1.23 kB │ gzip: 0.59 kB
-ℹ dist/libs/contracts/src/docs/tech/mcp-endpoints.docblock.js                    1.07 kB │ gzip: 0.61 kB
-ℹ dist/libs/contracts/src/docs/index.js                                          0.85 kB │ gzip: 0.35 kB
+ℹ dist/libs/contracts/src/docs/index.js                                          0.99 kB │ gzip: 0.39 kB
 ℹ dist/libs/contracts/src/docs/registry.js                                       0.74 kB │ gzip: 0.42 kB
-ℹ 26 files, total: 93.60 kB
-✔ Build complete in 45ms
+ℹ 30 files, total: 103.69 kB
+✔ Build complete in 48ms
 $ tsc --noEmit

package/CHANGELOG.md

@@ -1,17 +1,17 @@
 # @lssm/example.learning-journey-registry
 
-## 0.0.0-canary-20251212224228
+## 0.0.0-canary-20251213172311
 
 ### Patch Changes
 
-- @lssm/example.learning-journey.crm-onboarding@0.0.0-canary-20251212224228
-- @lssm/example.learning-journey-ui-coaching@0.0.0-canary-20251212224228
-- @lssm/example.learning-journey-ui-gamified@0.0.0-canary-20251212224228
-- @lssm/example.learning-journey-ui-onboarding@0.0.0-canary-20251212224228
-- @lssm/example.learning-journey-ui-shared@0.0.0-canary-20251212224228
-- @lssm/example.learning-journey.ambient-coach@0.0.0-canary-20251212224228
-- @lssm/example.learning-journey.duo-drills@0.0.0-canary-20251212224228
-- @lssm/example.learning-journey.platform-tour@0.0.0-canary-20251212224228
-- @lssm/example.learning-journey.quest-challenges@0.0.0-canary-20251212224228
-- @lssm/example.learning-journey.studio-onboarding@0.0.0-canary-20251212224228
-- @lssm/module.learning-journey@0.0.0-canary-20251212224228
+- @lssm/example.learning-journey-crm-onboarding@0.0.0-canary-20251213172311
+- @lssm/example.learning-journey-ui-coaching@0.0.0-canary-20251213172311
+- @lssm/example.learning-journey-ui-gamified@0.0.0-canary-20251213172311
+- @lssm/example.learning-journey-ui-onboarding@0.0.0-canary-20251213172311
+- @lssm/example.learning-journey-ui-shared@0.0.0-canary-20251213172311
+- @lssm/example.learning-journey-ambient-coach@0.0.0-canary-20251213172311
+- @lssm/example.learning-journey-duo-drills@0.0.0-canary-20251213172311
+- @lssm/example.learning-journey-platform-tour@0.0.0-canary-20251213172311
+- @lssm/example.learning-journey-quest-challenges@0.0.0-canary-20251213172311
+- @lssm/example.learning-journey-studio-onboarding@0.0.0-canary-20251213172311
+- @lssm/module.learning-journey@0.0.0-canary-20251213172311

package/dist/example.js

@@ -0,0 +1 @@
+var e={id:`learning-journey-registry`,title:`Learning Journey Registry`,summary:`Registry of learning journey tracks + presentations + UI mini-app bindings.`,tags:[`learning`,`journey`,`registry`],kind:`library`,visibility:`public`,docs:{rootDocId:`docs.examples.learning-journey-registry`},entrypoints:{packageName:`@lssm/example.learning-journey-registry`,docs:`./docs`},surfaces:{templates:!0,sandbox:{enabled:!0,modes:[`markdown`,`specs`]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}};export{e as default};

package/dist/index.js

@@ -1 +1 @@
-import{crmLearningTracks as e,learningJourneyTracks as t,mapStep as n,mapTrackSpecToDto as r,onboardingTrackCatalog as i,platformLearningTracks as a,studioLearningTracks as o}from"./tracks.js";import{getProgress as s,listTracks as c,recordEvent as l}from"./api.js";import"./docs/index.js";import{LearningTrackDetailPresentation as u,LearningTrackListPresentation as d,LearningTrackProgressWidgetPresentation as f,learningJourneyPresentations as p}from"./presentations/index.js";import{LearningMiniApp as m,getLearningTemplateIds as h,isLearningTemplate as g}from"./ui/LearningMiniApp.js";import"./ui/index.js";export{m as LearningMiniApp,u as LearningTrackDetailPresentation,d as LearningTrackListPresentation,f as LearningTrackProgressWidgetPresentation,e as crmLearningTracks,h as getLearningTemplateIds,s as getProgress,g as isLearningTemplate,p as learningJourneyPresentations,t as learningJourneyTracks,c as listTracks,n as mapStep,r as mapTrackSpecToDto,i as onboardingTrackCatalog,a as platformLearningTracks,l as recordEvent,o as studioLearningTracks};
+import{crmLearningTracks as e,learningJourneyTracks as t,mapStep as n,mapTrackSpecToDto as r,onboardingTrackCatalog as i,platformLearningTracks as a,studioLearningTracks as o}from"./tracks.js";import{getProgress as s,listTracks as c,recordEvent as l}from"./api.js";import u from"./example.js";import"./docs/index.js";import{LearningTrackDetailPresentation as d,LearningTrackListPresentation as f,LearningTrackProgressWidgetPresentation as p,learningJourneyPresentations as m}from"./presentations/index.js";import{LearningMiniApp as h,getLearningTemplateIds as g,isLearningTemplate as _}from"./ui/LearningMiniApp.js";import"./ui/index.js";export{h as LearningMiniApp,d as LearningTrackDetailPresentation,f as LearningTrackListPresentation,p as LearningTrackProgressWidgetPresentation,e as crmLearningTracks,u as example,g as getLearningTemplateIds,s as getProgress,_ as isLearningTemplate,m as learningJourneyPresentations,t as learningJourneyTracks,c as listTracks,n as mapStep,r as mapTrackSpecToDto,i as onboardingTrackCatalog,a as platformLearningTracks,l as recordEvent,o as studioLearningTracks};

package/dist/libs/contracts/src/docs/index.js

@@ -1 +1 @@
-import{docBlockToPresentationSpec as e,docBlockToPresentationV2 as t,docBlocksToPresentationRoutes as n}from"./presentations.js";import{DocRegistry as r,defaultDocRegistry as i,registerDocBlocks as a}from"./registry.js";import"./PUBLISHING.docblock.js";import"./accessibility_wcag_compliance_specs.docblock.js";import"./tech/PHASE_1_QUICKSTART.docblock.js";import"./tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js";import"./tech/PHASE_3_AUTO_EVOLUTION.docblock.js";import"./tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js";import"./tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js";import"./tech/lifecycle-stage-system.docblock.js";import"./tech/presentation-runtime.docblock.js";import"./tech/schema/README.docblock.js";import"./tech/templates/runtime.docblock.js";import"./tech/workflows/overview.docblock.js";import"./tech/mcp-endpoints.docblock.js";
+import{docBlockToPresentationSpec as e,docBlockToPresentationV2 as t,docBlocksToPresentationRoutes as n}from"./presentations.js";import{DocRegistry as r,defaultDocRegistry as i,registerDocBlocks as a}from"./registry.js";import"./PUBLISHING.docblock.js";import"./accessibility_wcag_compliance_specs.docblock.js";import"./tech/PHASE_1_QUICKSTART.docblock.js";import"./tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js";import"./tech/PHASE_3_AUTO_EVOLUTION.docblock.js";import"./tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js";import"./tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js";import"./tech/lifecycle-stage-system.docblock.js";import"./tech/presentation-runtime.docblock.js";import"./tech/schema/README.docblock.js";import"./tech/templates/runtime.docblock.js";import"./tech/workflows/overview.docblock.js";import"./tech/mcp-endpoints.docblock.js";import"./tech/vscode-extension.docblock.js";import"./tech/telemetry-ingest.docblock.js";import"./tech/contracts/openapi-export.docblock.js";

package/dist/libs/contracts/src/docs/tech/contracts/openapi-export.docblock.js

@@ -0,0 +1,38 @@
+import{registerDocBlocks as e}from"../../registry.js";e([{id:`docs.tech.contracts.openapi-export`,title:`OpenAPI export (OpenAPI 3.1) from SpecRegistry`,summary:`Generate a deterministic OpenAPI document from a SpecRegistry using jsonSchemaForSpec + REST transport metadata.`,kind:`reference`,visibility:`public`,route:`/docs/tech/contracts/openapi-export`,tags:[`contracts`,`openapi`,`rest`],body:`## OpenAPI export (OpenAPI 3.1) from SpecRegistry
+
+### Purpose
+
+ContractSpec specs can be exported into an **OpenAPI 3.1** document for tooling (SDK generation, docs, gateways).
+
+The export is **spec-first**:
+
+- Uses \`jsonSchemaForSpec(spec)\` for input/output JSON Schema (from SchemaModel → zod → JSON Schema)
+- Uses \`spec.transport.rest.method/path\` when present
+- Falls back to deterministic defaults:
+  - Method: \`POST\` for commands, \`GET\` for queries
+  - Path: \`defaultRestPath(name, version)\` → \`/<dot/name>/v<version>\`
+
+### Library API
+
+- Function: \`openApiForRegistry(registry, options?)\`
+- Location: \`@lssm/lib.contracts/openapi\`
+
+### CLI
+
+Export OpenAPI from a registry module:
+
+\`\`\`bash
+contractspec openapi --registry ./src/registry.ts --out ./openapi.json
+\`\`\`
+
+The registry module must export one of:
+
+- \`registry: SpecRegistry\`
+- \`default(): SpecRegistry | Promise<SpecRegistry>\`
+- \`createRegistry(): SpecRegistry | Promise<SpecRegistry>\`
+
+### Notes / limitations (current)
+
+- Responses are generated as a basic \`200\` response (plus schemas when available).
+- Query (GET) inputs are currently represented as a JSON request body when an input schema exists.
+- Errors are not yet expanded into OpenAPI responses; that will be added when we standardize error envelopes.`}]);

package/dist/libs/contracts/src/docs/tech/mcp-endpoints.docblock.js

@@ -1 +1 @@
-import{registerDocBlocks as e}from"../registry.js";e([{id:`docs.tech.mcp.endpoints`,title:`ContractSpec MCP endpoints`,summary:`Dedicated MCP servers for docs, CLI usage, and internal development.`,kind:`reference`,visibility:`mixed`,route:`/docs/tech/mcp/endpoints`,tags:[`mcp`,`docs`,`cli`,`internal`],body:"# ContractSpec MCP endpoints\n\nThree dedicated MCP servers keep AI agents efficient and scoped:\n\n- **Docs MCP**: `/api/mcp/docs` — exposes DocBlocks as resources + presentations. Tool: `docs.search`.\n- **CLI MCP**: `/api/mcp/cli` — surfaces CLI quickstart/reference/README and suggests commands. Tool: `cli.suggestCommand`.\n- **Internal MCP**: `/api/mcp/internal` — internal routing hints and playbook. Tool: `internal.describe`.\n\n### Usage notes\n- Transports are HTTP POST (streamable HTTP); SSE is disabled.\n- Resources are namespaced (`docs://*`, `cli://*`, `internal://*`) and are read-only.\n- Prompts mirror each surface (navigator, usage, bootstrap) for quick agent onboarding.\n- GraphQL remains at `/graphql`; health at `/health`.\n"}]);
+import{registerDocBlocks as e}from"../registry.js";e([{id:`docs.tech.mcp.endpoints`,title:`ContractSpec MCP endpoints`,summary:`Dedicated MCP servers for docs, CLI usage, and internal development.`,kind:`reference`,visibility:`mixed`,route:`/docs/tech/mcp/endpoints`,tags:[`mcp`,`docs`,`cli`,`internal`],body:"# ContractSpec MCP endpoints\n\nThree dedicated MCP servers keep AI agents efficient and scoped:\n\n- **Docs MCP**: `/api/mcp/docs` — exposes DocBlocks as resources + presentations. Tool: `docs.search`.\n- **CLI MCP**: `/api/mcp/cli` — surfaces CLI quickstart/reference/README and suggests commands. Tool: `cli.suggestCommand`.\n- **Internal MCP**: `/api/mcp/internal` — internal routing hints, playbook, and example registry access. Tool: `internal.describe`.\n\n### Usage notes\n- Transports are HTTP POST (streamable HTTP); SSE is disabled.\n- Resources are namespaced (`docs://*`, `cli://*`, `internal://*`) and are read-only.\n- Internal MCP also exposes the examples registry via `examples://*` resources:\n  - `examples://list?q=<query>`\n  - `examples://example/<id>`\n- Prompts mirror each surface (navigator, usage, bootstrap) for quick agent onboarding.\n- GraphQL remains at `/graphql`; health at `/health`.\n"}]);

package/dist/libs/contracts/src/docs/tech/telemetry-ingest.docblock.js

@@ -0,0 +1,122 @@
+import{registerDocBlocks as e}from"../registry.js";e([{id:`docs.tech.telemetry.ingest`,title:`Telemetry Ingest Endpoint`,summary:`Server-side telemetry ingestion for ContractSpec clients (VS Code extension, CLI, etc.).`,kind:`reference`,visibility:`internal`,route:`/docs/tech/telemetry/ingest`,tags:[`telemetry`,`api`,`posthog`,`analytics`],body:`# Telemetry Ingest Endpoint
+
+The ContractSpec API provides a telemetry ingest endpoint for clients to send product analytics events.
+
+## Endpoint
+
+\`\`\`
+POST /api/telemetry/ingest
+\`\`\`
+
+## Request
+
+\`\`\`json
+{
+  "event": "contractspec.vscode.command_run",
+  "distinct_id": "client-uuid",
+  "properties": {
+    "command": "validate"
+  },
+  "timestamp": "2024-01-15T10:30:00.000Z"
+}
+\`\`\`
+
+### Headers
+
+| Header | Description |
+|--------|-------------|
+| \`x-contractspec-client-id\` | Optional client identifier (used as fallback for distinct_id) |
+| \`Content-Type\` | Must be \`application/json\` |
+
+### Body
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| \`event\` | string | Yes | Event name (e.g., \`contractspec.vscode.activated\`) |
+| \`distinct_id\` | string | Yes | Anonymous client identifier |
+| \`properties\` | object | No | Event properties |
+| \`timestamp\` | string | No | ISO 8601 timestamp |
+
+## Response
+
+\`\`\`json
+{
+  "success": true
+}
+\`\`\`
+
+## Configuration
+
+The endpoint requires \`POSTHOG_PROJECT_KEY\` environment variable to be set. If not configured, events are accepted but not forwarded.
+
+| Environment Variable | Description | Default |
+|---------------------|-------------|---------|
+| \`POSTHOG_HOST\` | PostHog host URL | \`https://eu.posthog.com\` |
+| \`POSTHOG_PROJECT_KEY\` | PostHog project API key | (required) |
+
+## Privacy
+
+- No PII is collected or stored
+- \`distinct_id\` is an anonymous client-generated UUID
+- File paths and source code are never included in events
+- Respects VS Code telemetry settings on the client side
+
+## Events
+
+### Extension Events
+
+| Event | Description | Properties |
+|-------|-------------|------------|
+| \`contractspec.vscode.activated\` | Extension activated | \`version\` |
+| \`contractspec.vscode.command_run\` | Command executed | \`command\` |
+| \`contractspec.vscode.mcp_call\` | MCP call made | \`endpoint\`, \`tool\` |
+
+### API Events
+
+| Event | Description | Properties |
+|-------|-------------|------------|
+| \`contractspec.api.mcp_request\` | MCP request processed | \`endpoint\`, \`method\`, \`success\`, \`duration_ms\` |
+`},{id:`docs.tech.telemetry.hybrid`,title:`Hybrid Telemetry Model`,summary:`How ContractSpec clients choose between direct PostHog and API-routed telemetry.`,kind:`usage`,visibility:`internal`,route:`/docs/tech/telemetry/hybrid`,tags:[`telemetry`,`architecture`,`posthog`],body:`# Hybrid Telemetry Model
+
+ContractSpec uses a hybrid telemetry model where clients can send events either directly to PostHog or via the API server.
+
+## Decision Flow
+
+\`\`\`
+Is contractspec.api.baseUrl configured?
+├── Yes → Send via /api/telemetry/ingest
+└── No → Is posthogProjectKey configured?
+    ├── Yes → Send directly to PostHog
+    └── No → Telemetry disabled
+\`\`\`
+
+## Benefits
+
+### Direct PostHog
+- No server dependency
+- Works offline (with batching)
+- Lower latency
+
+### Via API
+- Centralized key management (no client-side keys)
+- Server-side enrichment and validation
+- Rate limiting and abuse prevention
+- Easier migration to other providers
+
+## Recommendation
+
+- **Development**: Use direct PostHog with a dev project key
+- **Production**: Route via API for better governance
+
+## Future: OpenTelemetry
+
+The current PostHog implementation is behind a simple interface that can be swapped for OpenTelemetry:
+
+\`\`\`typescript
+interface TelemetryClient {
+  send(event: TelemetryEvent): Promise<void>;
+}
+\`\`\`
+
+This allows future migration without changing client code.
+`}]);

package/dist/libs/contracts/src/docs/tech/vscode-extension.docblock.js

@@ -0,0 +1,68 @@
+import{registerDocBlocks as e}from"../registry.js";e([{id:`docs.tech.vscode.extension`,title:`ContractSpec VS Code Extension`,summary:`VS Code extension for spec-first development with validation, scaffolding, and MCP integration.`,kind:`reference`,visibility:`public`,route:`/docs/tech/vscode/extension`,tags:[`vscode`,`extension`,`tooling`,`dx`],body:`# ContractSpec VS Code Extension
+
+The ContractSpec VS Code extension provides spec-first development tooling directly in your editor.
+
+## Features
+
+- **Real-time Validation**: Get instant feedback on spec errors and warnings as you save files
+- **Build/Scaffold**: Generate handler and component skeletons from specs (no AI required)
+- **Spec Explorer**: List and navigate all specs in your workspace
+- **Dependency Analysis**: Visualize spec dependencies and detect cycles
+- **MCP Integration**: Search ContractSpec documentation via Model Context Protocol
+- **Snippets**: Code snippets for common ContractSpec patterns
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| \`ContractSpec: Validate Current Spec\` | Validate the currently open spec file |
+| \`ContractSpec: Validate All Specs\` | Validate all spec files in the workspace |
+| \`ContractSpec: Build/Scaffold\` | Generate handler/component from the current spec |
+| \`ContractSpec: List All Specs\` | Show all specs in the workspace |
+| \`ContractSpec: Analyze Dependencies\` | Analyze and visualize spec dependencies |
+| \`ContractSpec: Search Docs (MCP)\` | Search documentation via MCP |
+
+## Configuration
+
+| Setting | Description | Default |
+|---------|-------------|---------|
+| \`contractspec.api.baseUrl\` | Base URL for ContractSpec API (enables MCP + remote telemetry) | \`""\` |
+| \`contractspec.telemetry.posthogHost\` | PostHog host URL for direct telemetry | \`"https://eu.posthog.com"\` |
+| \`contractspec.telemetry.posthogProjectKey\` | PostHog project key for direct telemetry | \`""\` |
+| \`contractspec.validation.onSave\` | Run validation on save | \`true\` |
+| \`contractspec.validation.onOpen\` | Run validation on open | \`true\` |
+
+## Architecture
+
+The extension uses:
+- \`@lssm/module.contractspec-workspace\` for pure analysis + templates
+- \`@lssm/bundle.contractspec-workspace\` for workspace services + adapters
+
+This allows the extension to work without requiring the CLI to be installed.
+
+## Telemetry
+
+The extension uses a hybrid telemetry approach:
+1. If \`contractspec.api.baseUrl\` is configured → send to API \`/api/telemetry/ingest\`
+2. Otherwise → send directly to PostHog (if project key configured)
+
+Telemetry respects VS Code's telemetry settings. No file paths, source code, or PII is collected.
+`},{id:`docs.tech.vscode.snippets`,title:`ContractSpec Snippets`,summary:`Code snippets for common ContractSpec patterns in VS Code.`,kind:`reference`,visibility:`public`,route:`/docs/tech/vscode/snippets`,tags:[`vscode`,`snippets`,`dx`],body:`# ContractSpec Snippets
+
+The VS Code extension includes snippets for common ContractSpec patterns.
+
+## Available Snippets
+
+| Prefix | Description |
+|--------|-------------|
+| \`contractspec-command\` | Create a new command (write operation) |
+| \`contractspec-query\` | Create a new query (read-only operation) |
+| \`contractspec-event\` | Create a new event |
+| \`contractspec-docblock\` | Create a new DocBlock |
+| \`contractspec-telemetry\` | Create a new TelemetrySpec |
+| \`contractspec-presentation\` | Create a new Presentation |
+
+## Usage
+
+Type the prefix in a TypeScript file and press Tab to expand the snippet. Tab through the placeholders to fill in your values.
+`}]);

package/dist/tracks.js

@@ -1 +1 @@
-import{crmLearningTracks as e}from"@lssm/example.learning-journey.crm-onboarding/track";import{drillTracks as t}from"@lssm/example.learning-journey.duo-drills/track";import{ambientCoachTracks as n}from"@lssm/example.learning-journey.ambient-coach/track";import{questTracks as r}from"@lssm/example.learning-journey.quest-challenges/track";import{platformLearningTracks as i}from"@lssm/example.learning-journey.platform-tour/track";import{studioLearningTracks as a}from"@lssm/example.learning-journey.studio-onboarding/track";const o=e=>({id:e.id,title:e.title,description:e.description,completionEvent:e.completion.eventName,completionCondition:e.completion,xpReward:e.xpReward,isRequired:e.isRequired,canSkip:e.canSkip,actionUrl:e.actionUrl,actionLabel:e.actionLabel,availability:e.availability,metadata:e.metadata}),s=e=>({id:e.id,name:e.name,description:e.description,productId:e.productId,targetUserSegment:e.targetUserSegment,targetRole:e.targetRole,totalXp:e.totalXp,streakRule:e.streakRule,completionRewards:e.completionRewards,steps:e.steps.map(o),metadata:e.metadata}),c=[...a,...i,...e,...t,...n,...r],l=c.map(s);export{e as crmLearningTracks,c as learningJourneyTracks,o as mapStep,s as mapTrackSpecToDto,l as onboardingTrackCatalog,i as platformLearningTracks,a as studioLearningTracks};
+import{crmLearningTracks as e}from"@lssm/example.learning-journey-crm-onboarding/track";import{drillTracks as t}from"@lssm/example.learning-journey-duo-drills/track";import{ambientCoachTracks as n}from"@lssm/example.learning-journey-ambient-coach/track";import{questTracks as r}from"@lssm/example.learning-journey-quest-challenges/track";import{platformLearningTracks as i}from"@lssm/example.learning-journey-platform-tour/track";import{studioLearningTracks as a}from"@lssm/example.learning-journey-studio-onboarding/track";const o=e=>({id:e.id,title:e.title,description:e.description,completionEvent:e.completion.eventName,completionCondition:e.completion,xpReward:e.xpReward,isRequired:e.isRequired,canSkip:e.canSkip,actionUrl:e.actionUrl,actionLabel:e.actionLabel,availability:e.availability,metadata:e.metadata}),s=e=>({id:e.id,name:e.name,description:e.description,productId:e.productId,targetUserSegment:e.targetUserSegment,targetRole:e.targetRole,totalXp:e.totalXp,streakRule:e.streakRule,completionRewards:e.completionRewards,steps:e.steps.map(o),metadata:e.metadata}),c=[...a,...i,...e,...t,...n,...r],l=c.map(s);export{e as crmLearningTracks,c as learningJourneyTracks,o as mapStep,s as mapTrackSpecToDto,l as onboardingTrackCatalog,i as platformLearningTracks,a as studioLearningTracks};

package/example.ts

@@ -0,0 +1 @@
+export { default } from './src/example';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.learning-journey-registry",
-  "version": "0.0.0-canary-20251212224228",
+  "version": "0.0.0-canary-20251213172311",
   "description": "Registry that aggregates learning journey example tracks.",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,6 +11,7 @@
     "./api-types": "./src/api-types.ts",
     "./docs": "./src/docs/index.ts",
     "./docs/learning-journey-registry.docblock": "./src/docs/learning-journey-registry.docblock.ts",
+    "./example": "./src/example.ts",
     "./presentations": "./src/presentations/index.ts",
     "./progress-store": "./src/progress-store.ts",
     "./tracks": "./src/tracks.ts",
@@ -30,12 +31,12 @@
     "lint:check": "eslint src"
   },
   "dependencies": {
-    "@lssm/example.learning-journey.ambient-coach": "workspace:*",
-    "@lssm/example.learning-journey.duo-drills": "workspace:*",
-    "@lssm/example.learning-journey.crm-onboarding": "workspace:*",
-    "@lssm/example.learning-journey.platform-tour": "workspace:*",
-    "@lssm/example.learning-journey.quest-challenges": "workspace:*",
-    "@lssm/example.learning-journey.studio-onboarding": "workspace:*",
+    "@lssm/example.learning-journey-ambient-coach": "workspace:*",
+    "@lssm/example.learning-journey-duo-drills": "workspace:*",
+    "@lssm/example.learning-journey-crm-onboarding": "workspace:*",
+    "@lssm/example.learning-journey-platform-tour": "workspace:*",
+    "@lssm/example.learning-journey-quest-challenges": "workspace:*",
+    "@lssm/example.learning-journey-studio-onboarding": "workspace:*",
     "@lssm/example.learning-journey-ui-shared": "workspace:*",
     "@lssm/example.learning-journey-ui-gamified": "workspace:*",
     "@lssm/example.learning-journey-ui-onboarding": "workspace:*",
@@ -61,6 +62,7 @@
       "./api-types": "./dist/api-types.js",
       "./docs": "./dist/docs/index.js",
       "./docs/learning-journey-registry.docblock": "./dist/docs/learning-journey-registry.docblock.js",
+      "./example": "./dist/example.js",
       "./presentations": "./dist/presentations/index.js",
       "./progress-store": "./dist/progress-store.js",
       "./tracks": "./dist/tracks.js",

package/src/example.ts

@@ -0,0 +1,26 @@
+const example = {
+  id: 'learning-journey-registry',
+  title: 'Learning Journey Registry',
+  summary:
+    'Registry of learning journey tracks + presentations + UI mini-app bindings.',
+  tags: ['learning', 'journey', 'registry'],
+  kind: 'library',
+  visibility: 'public',
+  docs: {
+    rootDocId: 'docs.examples.learning-journey-registry',
+  },
+  entrypoints: {
+    packageName: '@lssm/example.learning-journey-registry',
+    docs: './docs',
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ['markdown', 'specs'] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true },
+  },
+} as const;
+
+export default example;
+
+

package/src/index.ts

@@ -4,3 +4,4 @@ export * from './tracks';
 export * from './api';
 export * from './presentations';
 export * from './ui';
+export { default as example } from './example';

package/src/tracks.ts

@@ -4,12 +4,12 @@ import type {
   StepAvailabilitySpec,
   StepCompletionConditionSpec,
 } from '@lssm/module.learning-journey/track-spec';
-import { crmLearningTracks } from '@lssm/example.learning-journey.crm-onboarding/track';
-import { drillTracks } from '@lssm/example.learning-journey.duo-drills/track';
-import { ambientCoachTracks } from '@lssm/example.learning-journey.ambient-coach/track';
-import { questTracks } from '@lssm/example.learning-journey.quest-challenges/track';
-import { platformLearningTracks } from '@lssm/example.learning-journey.platform-tour/track';
-import { studioLearningTracks } from '@lssm/example.learning-journey.studio-onboarding/track';
+import { crmLearningTracks } from '@lssm/example.learning-journey-crm-onboarding/track';
+import { drillTracks } from '@lssm/example.learning-journey-duo-drills/track';
+import { ambientCoachTracks } from '@lssm/example.learning-journey-ambient-coach/track';
+import { questTracks } from '@lssm/example.learning-journey-quest-challenges/track';
+import { platformLearningTracks } from '@lssm/example.learning-journey-platform-tour/track';
+import { studioLearningTracks } from '@lssm/example.learning-journey-studio-onboarding/track';
 
 export interface OnboardingStepDto {
   id: string;

package/src/ui/LearningMiniApp.tsx

@@ -119,4 +119,3 @@ export function isLearningTemplate(
 export function getLearningTemplateIds(): LearningTemplateId[] {
   return Object.keys(TEMPLATE_TO_TRACK) as LearningTemplateId[];
 }
-

package/src/ui/index.ts

@@ -3,4 +3,3 @@ export {
   isLearningTemplate,
   getLearningTemplateIds,
 } from './LearningMiniApp';
-