@lssm/example.learning-journey-platform-tour 0.0.0-canary-20251213172311

package/.turbo/turbo-build.log

@@ -0,0 +1,19 @@
+$ 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-platform-tour/tsdown.config.js 
+ℹ entry: src/example.ts, src/index.ts, src/track.ts, src/contracts/index.ts, src/docs/index.ts, src/docs/platform-tour.docblock.ts, src/handlers/demo.handlers.ts, src/presentations/index.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/contracts/index.js              2.81 kB │ gzip: 0.91 kB
+ℹ dist/track.js                        2.18 kB │ gzip: 0.80 kB
+ℹ dist/docs/platform-tour.docblock.js  1.38 kB │ gzip: 0.73 kB
+ℹ dist/index.js                        0.92 kB │ gzip: 0.31 kB
+ℹ dist/presentations/index.js          0.78 kB │ gzip: 0.37 kB
+ℹ dist/example.js                      0.63 kB │ gzip: 0.35 kB
+ℹ dist/handlers/demo.handlers.js       0.45 kB │ gzip: 0.30 kB
+ℹ dist/docs/index.js                   0.04 kB │ gzip: 0.06 kB
+ℹ 8 files, total: 9.18 kB
+✔ Build complete in 69ms
+$ tsc --noEmit

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# @lssm/example.learning-journey-platform-tour
+
+## 0.0.0-canary-20251213172311
+
+### Patch Changes
+
+- Updated dependencies [3086383]
+  - @lssm/lib.contracts@0.0.0-canary-20251213172311
+  - @lssm/lib.schema@0.0.0-canary-20251213172311
+  - @lssm/module.learning-journey@0.0.0-canary-20251213172311

package/README.md

@@ -0,0 +1,40 @@
+# @lssm/example.learning-journey-platform-tour
+
+Learning Journey example that tours platform primitives.
+
+## Track
+
+- **Key**: `platform_primitives_tour`
+- **Persona**: platform developer
+- **XP**: 7 steps × 20 XP + 20 bonus
+- **Badge**: `platform_primitives`
+
+## Steps & Events
+
+1. `identity_rbac` → `org.member.added`
+2. `event_bus_audit` → `audit_log.created`
+3. `notifications` → `notification.sent`
+4. `jobs_scheduler` → `job.completed`
+5. `feature_flags` → `flag.toggled`
+6. `files_attachments` → `attachment.attached`
+7. `usage_metering` → `usage.recorded`
+
+## Usage
+
+- Import track specs:  
+  `import { platformLearningTracks } from '@lssm/example.learning-journey-platform-tour/track'`
+- Contracts/handlers for demos:  
+  `import { GetPlatformTourTrack, RecordPlatformTourEvent } from '@lssm/example.learning-journey-platform-tour/contracts'`  
+  `import { emitPlatformTourEvent } from '@lssm/example.learning-journey-platform-tour/handlers/demo.handlers'`
+- Presentations (react/markdown/json targets):  
+  `import { platformTourPresentations } from '@lssm/example.learning-journey-platform-tour/presentations'`
+- Register via onboarding API:
+  - `learning.onboarding.listTracks`
+  - `learning.onboarding.getProgress`
+  - `learning.onboarding.recordEvent` wired from each module’s events
+- Map module events (identity, audit-trail, notifications, jobs, feature-flags, files, metering) into `recordEvent`.
+
+## Docs
+
+- Docblock: `src/docs/platform-tour.docblock.ts`
+- Route suggestion: `/docs/learning-journey/platform-tour`

package/dist/contracts/index.js

@@ -0,0 +1 @@
+import{platformPrimitivesTourTrack as e}from"../track.js";import{ScalarTypeEnum as t,defineSchemaModel as n}from"@lssm/lib.schema";import{defineCommand as r,defineQuery as i}from"@lssm/lib.contracts";const a=[`examples.learning-journey.platform-tour`],o=n({name:`PlatformTourStep`,description:`Step metadata for platform primitives tour`,fields:{id:{type:t.String_unsecure(),isOptional:!1},title:{type:t.String_unsecure(),isOptional:!1},description:{type:t.String_unsecure(),isOptional:!0},completionEvent:{type:t.String_unsecure(),isOptional:!1},sourceModule:{type:t.String_unsecure(),isOptional:!0},xpReward:{type:t.Int_unsecure(),isOptional:!0},order:{type:t.Int_unsecure(),isOptional:!0}}}),s=n({name:`PlatformTourTrack`,description:`Platform primitives tour track definition`,fields:{id:{type:t.String_unsecure(),isOptional:!1},name:{type:t.String_unsecure(),isOptional:!1},description:{type:t.String_unsecure(),isOptional:!0},totalXp:{type:t.Int_unsecure(),isOptional:!0},completionXpBonus:{type:t.Int_unsecure(),isOptional:!0},completionBadgeKey:{type:t.String_unsecure(),isOptional:!0},streakHoursWindow:{type:t.Int_unsecure(),isOptional:!0},streakBonusXp:{type:t.Int_unsecure(),isOptional:!0},steps:{type:o,isArray:!0,isOptional:!1}}}),c=n({name:`PlatformTourTrackResponse`,description:`Response wrapper for platform tour track`,fields:{track:{type:s,isOptional:!1}}}),l=n({name:`PlatformTourRecordEventInput`,description:`Emit a demo event to advance platform tour steps`,fields:{learnerId:{type:t.String_unsecure(),isOptional:!1},eventName:{type:t.String_unsecure(),isOptional:!1},payload:{type:t.JSON(),isOptional:!0},occurredAt:{type:t.DateTime(),isOptional:!0}}}),u=n({name:`PlatformTourSuccess`,description:`Generic success response`,fields:{success:{type:t.Boolean(),isOptional:!1}}}),d=i({meta:{name:`learningJourney.platformTour.getTrack`,version:1,stability:`experimental`,owners:[...a],tags:[`learning`,`platform`,`tour`],description:`Fetch platform primitives tour track definition.`,goal:`Expose track metadata to UIs and templates.`,context:`Called by Studio/Playground to render journey steps.`},io:{input:n({name:`PlatformTourTrackInput`,description:`Track input`,fields:{}}),output:c},policy:{auth:`user`}}),f=r({meta:{name:`learningJourney.platformTour.recordEvent`,version:1,stability:`experimental`,owners:[...a],tags:[`learning`,`platform`,`tour`],description:`Record an event to advance platform tour progress.`,goal:`Advance steps via domain events in demo/sandbox contexts.`,context:`Called by handlers or demo scripts to emit step completion events.`},io:{input:l,output:u},policy:{auth:`user`}}),p={GetPlatformTourTrack:d,RecordPlatformTourEvent:f,track:e};export{d as GetPlatformTourTrack,s as PlatformTourTrackModel,f as RecordPlatformTourEvent,p as platformTourContracts};

package/dist/docs/index.js

@@ -0,0 +1 @@
+import"./platform-tour.docblock.js";

package/dist/docs/platform-tour.docblock.js

@@ -0,0 +1 @@
+import{registerDocBlocks as e}from"@lssm/lib.contracts/docs";e([{id:`docs.learning-journey.platform-tour`,title:`Learning Journey — Platform Primitives Tour`,summary:`Cross-module tour that touches identity, audit, notifications, jobs, feature flags, files, and metering.`,kind:`reference`,visibility:`public`,route:`/docs/learning-journey/platform-tour`,tags:[`learning`,`platform`,`onboarding`],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 `@lssm/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."}]);

package/dist/example.js

@@ -0,0 +1 @@
+var e={id:`learning-journey-platform-tour`,title:`Learning Journey — Platform Tour`,summary:`Learning journey track + contracts + presentations for a platform tour.`,tags:[`learning`,`journey`,`platform-tour`],kind:`template`,visibility:`public`,docs:{rootDocId:`docs.examples.platform-tour`,goalDocId:`docs.examples.platform-tour.goal`,usageDocId:`docs.examples.platform-tour.usage`},entrypoints:{packageName:`@lssm/example.learning-journey-platform-tour`,docs:`./docs`},surfaces:{templates:!0,sandbox:{enabled:!0,modes:[`markdown`,`playground`]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}};export{e as default};

package/dist/handlers/demo.handlers.js

@@ -0,0 +1 @@
+import{platformPrimitivesTourTrack as e}from"../track.js";const t=[`org.member.added`,`audit_log.created`,`notification.sent`,`job.completed`,`flag.toggled`,`attachment.attached`,`usage.recorded`],n=(t,{learnerId:n,occurredAt:r=new Date,payload:i},a)=>{let o={learnerId:n,name:t,occurredAt:r,payload:i,trackId:e.id};return a?a(o):o},r=(e,r)=>t.map(t=>n(t,e,r));export{r as emitAllPlatformTourEvents,n as emitPlatformTourEvent,t as platformTourEvents};

package/dist/index.js

@@ -0,0 +1 @@
+import e from"./example.js";import{platformLearningTracks as t,platformPrimitivesTourTrack as n}from"./track.js";import"./docs/index.js";import{GetPlatformTourTrack as r,PlatformTourTrackModel as i,RecordPlatformTourEvent as a,platformTourContracts as o}from"./contracts/index.js";import{emitAllPlatformTourEvents as s,emitPlatformTourEvent as c,platformTourEvents as l}from"./handlers/demo.handlers.js";import{PlatformTourTrackPresentation as u,PlatformTourWidgetPresentation as d,platformTourPresentations as f}from"./presentations/index.js";export{r as GetPlatformTourTrack,i as PlatformTourTrackModel,u as PlatformTourTrackPresentation,d as PlatformTourWidgetPresentation,a as RecordPlatformTourEvent,s as emitAllPlatformTourEvents,c as emitPlatformTourEvent,e as example,t as platformLearningTracks,n as platformPrimitivesTourTrack,o as platformTourContracts,l as platformTourEvents,f as platformTourPresentations};

package/dist/presentations/index.js

@@ -0,0 +1 @@
+import{PlatformTourTrackModel as e}from"../contracts/index.js";const t={domain:`learning-journey`,owners:[`examples.learning-journey.platform-tour`],tags:[`learning`,`platform`,`tour`]},n={meta:{name:`learning.journey.platform.track`,version:1,description:`Platform primitives tour track detail`,...t},source:{type:`component`,framework:`react`,componentKey:`LearningTrackDetail`,props:e},targets:[`react`,`markdown`,`application/json`]},r={meta:{name:`learning.journey.platform.widget`,version:1,description:`Compact widget for platform tour progress`,...t},source:{type:`component`,framework:`react`,componentKey:`LearningTrackProgressWidget`},targets:[`react`]},i=[n,r];export{n as PlatformTourTrackPresentation,r as PlatformTourWidgetPresentation,i as platformTourPresentations};

package/dist/track.js

@@ -0,0 +1 @@
+const e={id:`platform_primitives_tour`,productId:`contractspec-platform`,name:`Platform Primitives Tour`,description:`Hands-on tour across identity, audit, notifications, jobs, flags, files, and metering.`,targetUserSegment:`platform_developer`,targetRole:`developer`,totalXp:140,completionRewards:{xpBonus:20,badgeKey:`platform_primitives`},steps:[{id:`identity_rbac`,title:`Create org and member`,description:`Create an org and add at least one member.`,order:1,completion:{eventName:`org.member.added`,sourceModule:`@lssm/lib.identity-rbac`},xpReward:20,metadata:{surface:`identity`}},{id:`event_bus_audit`,title:`Emit an auditable event`,description:`Emit an event that lands in the audit log.`,order:2,completion:{eventName:`audit_log.created`,sourceModule:`@lssm/module.audit-trail`},xpReward:20,metadata:{surface:`bus+audit`}},{id:`notifications`,title:`Send a notification`,description:`Send yourself a notification and verify delivery.`,order:3,completion:{eventName:`notification.sent`,sourceModule:`@lssm/module.notifications`},xpReward:20,metadata:{surface:`notifications`}},{id:`jobs_scheduler`,title:`Schedule and run a job`,description:`Schedule a background job and let it run once.`,order:4,completion:{eventName:`job.completed`,sourceModule:`@lssm/lib.jobs`},xpReward:20,metadata:{surface:`jobs`}},{id:`feature_flags`,title:`Create and toggle a feature flag`,description:`Create a feature flag and toggle it at least once.`,order:5,completion:{eventName:`flag.toggled`,sourceModule:`@lssm/lib.feature-flags`},xpReward:20,metadata:{surface:`feature-flags`}},{id:`files_attachments`,title:`Attach a file`,description:`Upload and attach a file to any entity.`,order:6,completion:{eventName:`attachment.attached`,sourceModule:`@lssm/lib.files`},xpReward:20,metadata:{surface:`files`}},{id:`usage_metering`,title:`Record usage`,description:`Emit a usage metric (regeneration, agent run, or similar).`,order:7,completion:{eventName:`usage.recorded`,sourceModule:`@lssm/lib.metering`},xpReward:20,metadata:{surface:`metering`}}],metadata:{surfacedIn:[`studio/learning`,`platform/dev-center`]}},t=[e];export{t as platformLearningTracks,e as platformPrimitivesTourTrack};

package/example.ts

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@lssm/example.learning-journey-platform-tour",
+  "version": "0.0.0-canary-20251213172311",
+  "description": "Learning journey track covering ContractSpec platform primitives.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./contracts": "./src/contracts/index.ts",
+    "./docs": "./src/docs/index.ts",
+    "./docs/platform-tour.docblock": "./src/docs/platform-tour.docblock.ts",
+    "./example": "./src/example.ts",
+    "./handlers/demo.handlers": "./src/handlers/demo.handlers.ts",
+    "./presentations": "./src/presentations/index.ts",
+    "./track": "./src/track.ts",
+    "./*": "./*"
+  },
+  "scripts": {
+    "build": "bun build:bundle && bun build:types",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src"
+  },
+  "dependencies": {
+    "@lssm/lib.contracts": "workspace:*",
+    "@lssm/lib.schema": "workspace:*",
+    "@lssm/module.learning-journey": "workspace:*"
+  },
+  "devDependencies": {
+    "@lssm/tool.tsdown": "workspace:*",
+    "@lssm/tool.typescript": "workspace:*",
+    "tsdown": "^0.17.0",
+    "typescript": "^5.9.3"
+  },
+  "module": "./dist/index.js",
+  "publishConfig": {
+    "exports": {
+      ".": "./dist/index.js",
+      "./contracts": "./dist/contracts/index.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/platform-tour.docblock": "./dist/docs/platform-tour.docblock.js",
+      "./example": "./dist/example.js",
+      "./handlers/demo.handlers": "./dist/handlers/demo.handlers.js",
+      "./presentations": "./dist/presentations/index.js",
+      "./track": "./dist/track.js",
+      "./*": "./*"
+    }
+  }
+}

package/src/contracts/index.test.ts

@@ -0,0 +1,49 @@
+import { describe, expect, it } from 'bun:test';
+
+import {
+  GetPlatformTourTrack,
+  RecordPlatformTourEvent,
+  platformTourContracts,
+} from './index';
+import { platformPrimitivesTourTrack } from '../track';
+import {
+  emitPlatformTourEvent,
+  platformTourEvents,
+} from '../handlers/demo.handlers';
+import type { PlatformEvent } from '../handlers/demo.handlers';
+
+describe('platform tour contracts', () => {
+  it('exposes track metadata', () => {
+    expect(platformTourContracts.track.id).toBe('platform_primitives_tour');
+    expect(platformTourContracts.track.steps.length).toBeGreaterThan(0);
+    expect(GetPlatformTourTrack.meta.name).toBe(
+      'learningJourney.platformTour.getTrack'
+    );
+  });
+
+  it('allows recording events via demo handler', async () => {
+    const [step] = platformPrimitivesTourTrack.steps;
+    expect(step).toBeDefined();
+    if (!step) throw new Error('Expected at least one platform tour step');
+
+    const eventName = step.completion.eventName;
+    const isPlatformEvent = (value: string): value is PlatformEvent =>
+      platformTourEvents.includes(value as PlatformEvent);
+
+    expect(isPlatformEvent(eventName)).toBe(true);
+    if (!isPlatformEvent(eventName)) {
+      throw new Error(`Unexpected event name: ${eventName}`);
+    }
+
+    const result = await emitPlatformTourEvent(eventName, {
+      learnerId: 'demo-learner',
+    });
+    expect(result).toBeDefined();
+  });
+
+  it('exposes record event contract', () => {
+    expect(RecordPlatformTourEvent.meta.name).toBe(
+      'learningJourney.platformTour.recordEvent'
+    );
+  });
+});

package/src/contracts/index.ts

@@ -0,0 +1,122 @@
+import { ScalarTypeEnum, defineSchemaModel } from '@lssm/lib.schema';
+import { defineCommand, defineQuery } from '@lssm/lib.contracts';
+
+import { platformPrimitivesTourTrack } from '../track';
+
+const OWNERS = ['examples.learning-journey.platform-tour'] as const;
+
+const StepModel = defineSchemaModel({
+  name: 'PlatformTourStep',
+  description: 'Step metadata for platform primitives tour',
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    completionEvent: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
+    sourceModule: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    xpReward: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    order: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+  },
+});
+
+export const PlatformTourTrackModel = defineSchemaModel({
+  name: 'PlatformTourTrack',
+  description: 'Platform primitives tour track definition',
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    totalXp: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    completionXpBonus: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: true,
+    },
+    completionBadgeKey: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true,
+    },
+    streakHoursWindow: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: true,
+    },
+    streakBonusXp: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    steps: { type: StepModel, isArray: true, isOptional: false },
+  },
+});
+
+const TrackResponseModel = defineSchemaModel({
+  name: 'PlatformTourTrackResponse',
+  description: 'Response wrapper for platform tour track',
+  fields: {
+    track: { type: PlatformTourTrackModel, isOptional: false },
+  },
+});
+
+const RecordDemoEventInput = defineSchemaModel({
+  name: 'PlatformTourRecordEventInput',
+  description: 'Emit a demo event to advance platform tour steps',
+  fields: {
+    learnerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    eventName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    payload: { type: ScalarTypeEnum.JSON(), isOptional: true },
+    occurredAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+  },
+});
+
+const SuccessModel = defineSchemaModel({
+  name: 'PlatformTourSuccess',
+  description: 'Generic success response',
+  fields: {
+    success: { type: ScalarTypeEnum.Boolean(), isOptional: false },
+  },
+});
+
+export const GetPlatformTourTrack = defineQuery({
+  meta: {
+    name: 'learningJourney.platformTour.getTrack',
+    version: 1,
+    stability: 'experimental',
+    owners: [...OWNERS],
+    tags: ['learning', 'platform', 'tour'],
+    description: 'Fetch platform primitives tour track definition.',
+    goal: 'Expose track metadata to UIs and templates.',
+    context: 'Called by Studio/Playground to render journey steps.',
+  },
+  io: {
+    input: defineSchemaModel({
+      name: 'PlatformTourTrackInput',
+      description: 'Track input',
+      fields: {},
+    }),
+    output: TrackResponseModel,
+  },
+  policy: { auth: 'user' },
+});
+
+export const RecordPlatformTourEvent = defineCommand({
+  meta: {
+    name: 'learningJourney.platformTour.recordEvent',
+    version: 1,
+    stability: 'experimental',
+    owners: [...OWNERS],
+    tags: ['learning', 'platform', 'tour'],
+    description: 'Record an event to advance platform tour progress.',
+    goal: 'Advance steps via domain events in demo/sandbox contexts.',
+    context:
+      'Called by handlers or demo scripts to emit step completion events.',
+  },
+  io: {
+    input: RecordDemoEventInput,
+    output: SuccessModel,
+  },
+  policy: { auth: 'user' },
+});
+
+export const platformTourContracts = {
+  GetPlatformTourTrack,
+  RecordPlatformTourEvent,
+  track: platformPrimitivesTourTrack,
+};

package/src/docs/index.ts

@@ -0,0 +1 @@
+import './platform-tour.docblock';

package/src/docs/platform-tour.docblock.ts

@@ -0,0 +1,40 @@
+import type { DocBlock } from '@lssm/lib.contracts/docs';
+import { registerDocBlocks } from '@lssm/lib.contracts/docs';
+
+const platformTourDocBlocks: DocBlock[] = [
+  {
+    id: 'docs.learning-journey.platform-tour',
+    title: 'Learning Journey — Platform Primitives Tour',
+    summary:
+      'Cross-module tour that touches identity, audit, notifications, jobs, feature flags, files, and metering.',
+    kind: 'reference',
+    visibility: 'public',
+    route: '/docs/learning-journey/platform-tour',
+    tags: ['learning', 'platform', 'onboarding'],
+    body: `## Track
+- **Key**: \`platform_primitives_tour\`
+- **Persona**: platform developer exploring primitives
+- **Goal**: Touch each cross-cutting module once, event-driven completion
+
+## Steps & Events
+1) \`identity_rbac\` → \`org.member.added\`
+2) \`event_bus_audit\` → \`audit_log.created\`
+3) \`notifications\` → \`notification.sent\`
+4) \`jobs_scheduler\` → \`job.completed\`
+5) \`feature_flags\` → \`flag.toggled\`
+6) \`files_attachments\` → \`attachment.attached\`
+7) \`usage_metering\` → \`usage.recorded\`
+
+XP: 20 per step, 20 bonus XP upon completion.
+
+## Wiring
+- Tracks export from \`@lssm/example.learning-journey-platform-tour/track\`.
+- Use onboarding API to surface progress:
+  - \`learning.onboarding.listTracks\`
+  - \`learning.onboarding.getProgress\`
+  - \`learning.onboarding.recordEvent\` wired from each module's event bus handlers.
+- Align event payloads with modules: identity-rbac, audit-trail, notifications, jobs, feature-flags, files, metering.`,
+  },
+];
+
+registerDocBlocks(platformTourDocBlocks);

package/src/example.ts

@@ -0,0 +1,27 @@
+const example = {
+  id: 'learning-journey-platform-tour',
+  title: 'Learning Journey — Platform Tour',
+  summary: 'Learning journey track + contracts + presentations for a platform tour.',
+  tags: ['learning', 'journey', 'platform-tour'],
+  kind: 'template',
+  visibility: 'public',
+  docs: {
+    rootDocId: 'docs.examples.platform-tour',
+    goalDocId: 'docs.examples.platform-tour.goal',
+    usageDocId: 'docs.examples.platform-tour.usage',
+  },
+  entrypoints: {
+    packageName: '@lssm/example.learning-journey-platform-tour',
+    docs: './docs',
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ['markdown', 'playground'] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true },
+  },
+} as const;
+
+export default example;
+
+

package/src/handlers/demo.handlers.ts

@@ -0,0 +1,50 @@
+import { platformPrimitivesTourTrack } from '../track';
+
+interface EmitParams {
+  learnerId: string;
+  occurredAt?: Date;
+  payload?: Record<string, unknown>;
+}
+
+interface LearningJourneyEvent {
+  learnerId: string;
+  name: string;
+  occurredAt: Date;
+  trackId: string;
+  payload?: Record<string, unknown>;
+}
+
+type RecordEvent = (event: LearningJourneyEvent) => unknown;
+
+export const platformTourEvents = [
+  'org.member.added',
+  'audit_log.created',
+  'notification.sent',
+  'job.completed',
+  'flag.toggled',
+  'attachment.attached',
+  'usage.recorded',
+] as const;
+
+export type PlatformEvent = (typeof platformTourEvents)[number];
+
+export const emitPlatformTourEvent = (
+  eventName: PlatformEvent,
+  { learnerId, occurredAt = new Date(), payload }: EmitParams,
+  record?: RecordEvent
+) => {
+  const event: LearningJourneyEvent = {
+    learnerId,
+    name: eventName,
+    occurredAt,
+    payload,
+    trackId: platformPrimitivesTourTrack.id,
+  };
+  return record ? record(event) : event;
+};
+
+export const emitAllPlatformTourEvents = (
+  params: EmitParams,
+  record?: RecordEvent
+) =>
+  platformTourEvents.map((name) => emitPlatformTourEvent(name, params, record));

package/src/index.ts

@@ -0,0 +1,6 @@
+export * from './track';
+export * from './docs';
+export * from './contracts';
+export * from './handlers/demo.handlers';
+export * from './presentations';
+export { default as example } from './example';

package/src/presentations/index.ts

@@ -0,0 +1,47 @@
+import type {
+  PresentationDescriptorV2,
+  PresentationV2Meta,
+} from '@lssm/lib.contracts';
+import { PlatformTourTrackModel } from '../contracts';
+
+const baseMeta: Pick<PresentationV2Meta, 'domain' | 'owners' | 'tags'> = {
+  domain: 'learning-journey',
+  owners: ['examples.learning-journey.platform-tour'],
+  tags: ['learning', 'platform', 'tour'],
+};
+
+export const PlatformTourTrackPresentation: PresentationDescriptorV2 = {
+  meta: {
+    name: 'learning.journey.platform.track',
+    version: 1,
+    description: 'Platform primitives tour track detail',
+    ...baseMeta,
+  },
+  source: {
+    type: 'component',
+    framework: 'react',
+    componentKey: 'LearningTrackDetail',
+    props: PlatformTourTrackModel,
+  },
+  targets: ['react', 'markdown', 'application/json'],
+};
+
+export const PlatformTourWidgetPresentation: PresentationDescriptorV2 = {
+  meta: {
+    name: 'learning.journey.platform.widget',
+    version: 1,
+    description: 'Compact widget for platform tour progress',
+    ...baseMeta,
+  },
+  source: {
+    type: 'component',
+    framework: 'react',
+    componentKey: 'LearningTrackProgressWidget',
+  },
+  targets: ['react'],
+};
+
+export const platformTourPresentations = [
+  PlatformTourTrackPresentation,
+  PlatformTourWidgetPresentation,
+];

package/src/track.ts

@@ -0,0 +1,106 @@
+import type { LearningJourneyTrackSpec } from '@lssm/module.learning-journey/track-spec';
+
+export const platformPrimitivesTourTrack: LearningJourneyTrackSpec = {
+  id: 'platform_primitives_tour',
+  productId: 'contractspec-platform',
+  name: 'Platform Primitives Tour',
+  description:
+    'Hands-on tour across identity, audit, notifications, jobs, flags, files, and metering.',
+  targetUserSegment: 'platform_developer',
+  targetRole: 'developer',
+  totalXp: 140,
+  completionRewards: { xpBonus: 20, badgeKey: 'platform_primitives' },
+  steps: [
+    {
+      id: 'identity_rbac',
+      title: 'Create org and member',
+      description: 'Create an org and add at least one member.',
+      order: 1,
+      completion: {
+        eventName: 'org.member.added',
+        sourceModule: '@lssm/lib.identity-rbac',
+      },
+      xpReward: 20,
+      metadata: { surface: 'identity' },
+    },
+    {
+      id: 'event_bus_audit',
+      title: 'Emit an auditable event',
+      description: 'Emit an event that lands in the audit log.',
+      order: 2,
+      completion: {
+        eventName: 'audit_log.created',
+        sourceModule: '@lssm/module.audit-trail',
+      },
+      xpReward: 20,
+      metadata: { surface: 'bus+audit' },
+    },
+    {
+      id: 'notifications',
+      title: 'Send a notification',
+      description: 'Send yourself a notification and verify delivery.',
+      order: 3,
+      completion: {
+        eventName: 'notification.sent',
+        sourceModule: '@lssm/module.notifications',
+      },
+      xpReward: 20,
+      metadata: { surface: 'notifications' },
+    },
+    {
+      id: 'jobs_scheduler',
+      title: 'Schedule and run a job',
+      description: 'Schedule a background job and let it run once.',
+      order: 4,
+      completion: {
+        eventName: 'job.completed',
+        sourceModule: '@lssm/lib.jobs',
+      },
+      xpReward: 20,
+      metadata: { surface: 'jobs' },
+    },
+    {
+      id: 'feature_flags',
+      title: 'Create and toggle a feature flag',
+      description: 'Create a feature flag and toggle it at least once.',
+      order: 5,
+      completion: {
+        eventName: 'flag.toggled',
+        sourceModule: '@lssm/lib.feature-flags',
+      },
+      xpReward: 20,
+      metadata: { surface: 'feature-flags' },
+    },
+    {
+      id: 'files_attachments',
+      title: 'Attach a file',
+      description: 'Upload and attach a file to any entity.',
+      order: 6,
+      completion: {
+        eventName: 'attachment.attached',
+        sourceModule: '@lssm/lib.files',
+      },
+      xpReward: 20,
+      metadata: { surface: 'files' },
+    },
+    {
+      id: 'usage_metering',
+      title: 'Record usage',
+      description: 'Emit a usage metric (regeneration, agent run, or similar).',
+      order: 7,
+      completion: {
+        eventName: 'usage.recorded',
+        sourceModule: '@lssm/lib.metering',
+      },
+      xpReward: 20,
+      metadata: { surface: 'metering' },
+    },
+  ],
+  metadata: {
+    surfacedIn: ['studio/learning', 'platform/dev-center'],
+  },
+};
+
+export const platformLearningTracks: LearningJourneyTrackSpec[] = [
+  platformPrimitivesTourTrack,
+];

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "@lssm/tool.typescript/react-library.json",
+  "include": ["src"],
+  "exclude": ["node_modules"],
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  }
+}