@lssm/example.learning-journey-crm-onboarding 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-crm-onboarding/tsdown.config.js 
+ℹ entry: src/example.ts, src/index.ts, src/track.ts, src/contracts/index.ts, src/docs/crm-onboarding.docblock.ts, src/docs/index.ts, src/handlers/demo.handlers.ts, src/presentations/index.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/contracts/index.js               2.79 kB │ gzip: 0.92 kB
+ℹ dist/track.js                         1.94 kB │ gzip: 0.69 kB
+ℹ dist/docs/crm-onboarding.docblock.js  1.27 kB │ gzip: 0.67 kB
+ℹ dist/index.js                         0.91 kB │ gzip: 0.31 kB
+ℹ dist/presentations/index.js           0.77 kB │ gzip: 0.37 kB
+ℹ dist/example.js                       0.55 kB │ gzip: 0.35 kB
+ℹ dist/handlers/demo.handlers.js        0.41 kB │ gzip: 0.26 kB
+ℹ dist/docs/index.js                    0.04 kB │ gzip: 0.06 kB
+ℹ 8 files, total: 8.68 kB
+✔ Build complete in 42ms
+$ tsc --noEmit

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# @lssm/example.learning-journey-crm-onboarding
+
+## 0.0.0-canary-20251213172311
+
+### Patch Changes
+
+- Updated dependencies [3086383]
+  - @lssm/example.crm-pipeline@0.0.0-canary-20251213172311
+  - @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,39 @@
+# @lssm/example.learning-journey-crm-onboarding
+
+Learning Journey example that guides a CRM user to first closed-won deal.
+
+## Track
+
+- **Key**: `crm_first_win`
+- **Persona**: CRM adopter
+- **XP**: 15/20/20/20/30/30 + 25 bonus
+- **Badge**: `crm_first_win`
+
+## Steps & Events
+
+1. `create_pipeline` → `pipeline.created`
+2. `create_contact_and_company` → `contact.created`
+3. `create_first_deal` → `deal.created`
+4. `move_deal_in_pipeline` → `deal.moved`
+5. `close_deal_won` → `deal.won`
+6. `setup_follow_up` → `task.completed` (type: follow_up)
+
+## Usage
+
+- Import track specs:  
+  `import { crmLearningTracks } from '@lssm/example.learning-journey-crm-onboarding/track'`
+- Contracts/handlers for demos:  
+  `import { GetCrmOnboardingTrack, RecordCrmOnboardingEvent } from '@lssm/example.learning-journey-crm-onboarding/contracts'`  
+  `import { emitCrmOnboardingEvent } from '@lssm/example.learning-journey-crm-onboarding/handlers/demo.handlers'`
+- Presentations (react/markdown/json targets):  
+  `import { crmOnboardingPresentations } from '@lssm/example.learning-journey-crm-onboarding/presentations'`
+- Register via onboarding API:
+  - `learning.onboarding.listTracks`
+  - `learning.onboarding.getProgress`
+  - `learning.onboarding.recordEvent` wired from CRM events
+- Requires CRM pipeline example events to be emitted for completion.
+
+## Docs
+
+- Docblock: `src/docs/crm-onboarding.docblock.ts`
+- Route suggestion: `/docs/learning-journey/crm-onboarding`

package/dist/contracts/index.js

@@ -0,0 +1 @@
+import{crmFirstWinTrack 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.crm-onboarding`],o=n({name:`CrmOnboardingStep`,description:`Step metadata for CRM first win journey`,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:`CrmOnboardingTrack`,description:`CRM onboarding 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:`CrmOnboardingTrackResponse`,description:`Response wrapper for CRM onboarding track`,fields:{track:{type:s,isOptional:!1}}}),l=n({name:`CrmOnboardingRecordEventInput`,description:`Emit a demo event to advance CRM onboarding 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:`CrmOnboardingSuccess`,description:`Generic success response`,fields:{success:{type:t.Boolean(),isOptional:!1}}}),d=i({meta:{name:`learningJourney.crmOnboarding.getTrack`,version:1,stability:`experimental`,owners:[...a],tags:[`learning`,`crm`,`onboarding`],description:`Fetch CRM first win track definition.`,goal:`Expose track metadata to UIs and templates.`,context:`Called by Studio/Playground to render journey steps.`},io:{input:n({name:`CrmOnboardingTrackInput`,description:`Track input`,fields:{}}),output:c},policy:{auth:`user`}}),f=r({meta:{name:`learningJourney.crmOnboarding.recordEvent`,version:1,stability:`experimental`,owners:[...a],tags:[`learning`,`crm`,`onboarding`],description:`Record an event to advance CRM onboarding 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={GetCrmOnboardingTrack:d,RecordCrmOnboardingEvent:f,track:e};export{s as CrmOnboardingTrackModel,d as GetCrmOnboardingTrack,f as RecordCrmOnboardingEvent,p as crmOnboardingContracts};

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

@@ -0,0 +1 @@
+import{registerDocBlocks as e}from"@lssm/lib.contracts/docs";e([{id:`docs.learning-journey.crm-onboarding`,title:`Learning Journey — CRM First Win`,summary:`Onboarding track for the CRM Pipeline example that drives users to first closed-won deal.`,kind:`reference`,visibility:`public`,route:`/docs/learning-journey/crm-onboarding`,tags:[`learning`,`crm`,`onboarding`],body:"## Track\n- **Key**: `crm_first_win`\n- **Persona**: CRM adopter\n- **Goal**: From empty CRM to first closed-won deal with follow-up\n\n## Steps & Events\n1) `create_pipeline` → `pipeline.created`\n2) `create_contact_and_company` → `contact.created`\n3) `create_first_deal` → `deal.created`\n4) `move_deal_in_pipeline` → `deal.moved`\n5) `close_deal_won` → `deal.won`\n6) `setup_follow_up` → `task.completed` (type: follow_up)\n\nXP: 15/20/20/20/30/30 with 25 bonus within 72h. Badge: `crm_first_win`.\n\n## Wiring\n- Depends on `@lssm/example.crm-pipeline` events.\n- Tracks export from `@lssm/example.learning-journey-crm-onboarding/track`.\n- Use onboarding API:\n  - `learning.onboarding.listTracks`\n  - `learning.onboarding.getProgress`\n  - `learning.onboarding.recordEvent` wired from CRM event bus handlers.\n- Surface in CRM dashboard/pipeline UI to guide new users."}]);

package/dist/docs/index.js

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

package/dist/example.js

@@ -0,0 +1 @@
+var e={id:`learning-journey-crm-onboarding`,title:`Learning Journey — CRM First Win`,summary:`Onboarding track for CRM Pipeline driving users from empty CRM to first closed-won deal.`,tags:[`learning`,`crm`,`onboarding`],kind:`template`,visibility:`public`,docs:{rootDocId:`docs.learning-journey.crm-onboarding`},entrypoints:{packageName:`@lssm/example.learning-journey-crm-onboarding`,docs:`./docs`},surfaces:{templates:!0,sandbox:{enabled:!0,modes:[`playground`,`markdown`]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}};export{e as default};

package/dist/handlers/demo.handlers.js

@@ -0,0 +1 @@
+import{crmFirstWinTrack as e}from"../track.js";const t=[`pipeline.created`,`contact.created`,`deal.created`,`deal.moved`,`deal.won`,`task.completed`],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{t as crmOnboardingEvents,r as emitAllCrmOnboardingEvents,n as emitCrmOnboardingEvent};

package/dist/index.js

@@ -0,0 +1 @@
+import e from"./example.js";import{crmFirstWinTrack as t,crmLearningTracks as n}from"./track.js";import"./docs/index.js";import{CrmOnboardingTrackModel as r,GetCrmOnboardingTrack as i,RecordCrmOnboardingEvent as a,crmOnboardingContracts as o}from"./contracts/index.js";import{crmOnboardingEvents as s,emitAllCrmOnboardingEvents as c,emitCrmOnboardingEvent as l}from"./handlers/demo.handlers.js";import{CrmOnboardingTrackPresentation as u,CrmOnboardingWidgetPresentation as d,crmOnboardingPresentations as f}from"./presentations/index.js";export{r as CrmOnboardingTrackModel,u as CrmOnboardingTrackPresentation,d as CrmOnboardingWidgetPresentation,i as GetCrmOnboardingTrack,a as RecordCrmOnboardingEvent,t as crmFirstWinTrack,n as crmLearningTracks,o as crmOnboardingContracts,s as crmOnboardingEvents,f as crmOnboardingPresentations,c as emitAllCrmOnboardingEvents,l as emitCrmOnboardingEvent,e as example};

package/dist/presentations/index.js

@@ -0,0 +1 @@
+import{CrmOnboardingTrackModel as e}from"../contracts/index.js";const t={domain:`learning-journey`,owners:[`examples.learning-journey.crm-onboarding`],tags:[`learning`,`crm`,`onboarding`]},n={meta:{name:`learning.journey.crm.track`,version:1,description:`CRM first win track detail`,...t},source:{type:`component`,framework:`react`,componentKey:`LearningTrackDetail`,props:e},targets:[`react`,`markdown`,`application/json`]},r={meta:{name:`learning.journey.crm.widget`,version:1,description:`Compact widget for CRM onboarding progress`,...t},source:{type:`component`,framework:`react`,componentKey:`LearningTrackProgressWidget`},targets:[`react`]},i=[n,r];export{n as CrmOnboardingTrackPresentation,r as CrmOnboardingWidgetPresentation,i as crmOnboardingPresentations};

package/dist/track.js

@@ -0,0 +1 @@
+const e={id:`crm_first_win`,productId:`crm-pipeline`,name:`CRM First Win`,description:`Guide a new CRM user from empty pipeline to first closed-won deal.`,targetUserSegment:`crm_adopter`,targetRole:`sales`,totalXp:135,streakRule:{hoursWindow:72,bonusXp:25},completionRewards:{xpBonus:25,badgeKey:`crm_first_win`},steps:[{id:`create_pipeline`,title:`Create pipeline & stages`,description:`Create a pipeline with baseline stages.`,order:1,completion:{eventName:`pipeline.created`,sourceModule:`@lssm/example.crm-pipeline`},xpReward:15,metadata:{surface:`pipeline`}},{id:`create_contact_and_company`,title:`Create contact and company`,description:`Add your first contact and associated company.`,order:2,completion:{eventName:`contact.created`,sourceModule:`@lssm/example.crm-pipeline`},xpReward:20,metadata:{surface:`contacts`}},{id:`create_first_deal`,title:`Log first deal`,description:`Create your first deal in the pipeline.`,order:3,completion:{eventName:`deal.created`,sourceModule:`@lssm/example.crm-pipeline`},xpReward:20,metadata:{surface:`deals`}},{id:`move_deal_in_pipeline`,title:`Move a deal across stages`,description:`Move a deal across at least three stages.`,order:4,completion:{eventName:`deal.moved`,sourceModule:`@lssm/example.crm-pipeline`},xpReward:20,metadata:{surface:`deals`}},{id:`close_deal_won`,title:`Close a deal as won`,description:`Close a deal as won to hit first revenue.`,order:5,completion:{eventName:`deal.won`,sourceModule:`@lssm/example.crm-pipeline`},xpReward:30,metadata:{surface:`deals`}},{id:`setup_follow_up`,title:`Create follow-up task`,description:`Create a follow-up task and notification for a contact or deal.`,order:6,completion:{eventName:`task.completed`,sourceModule:`@lssm/example.crm-pipeline`,payloadFilter:{type:`follow_up`}},xpReward:30,metadata:{surface:`tasks`}}],metadata:{surfacedIn:[`crm/dashboard`,`crm/pipeline`]}},t=[e];export{e as crmFirstWinTrack,t as crmLearningTracks};

package/example.ts

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@lssm/example.learning-journey-crm-onboarding",
+  "version": "0.0.0-canary-20251213172311",
+  "description": "Learning journey track that onboards users to the CRM pipeline example.",
+  "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/crm-onboarding.docblock": "./src/docs/crm-onboarding.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:*",
+    "@lssm/example.crm-pipeline": "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/crm-onboarding.docblock": "./dist/docs/crm-onboarding.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 {
+  GetCrmOnboardingTrack,
+  RecordCrmOnboardingEvent,
+  crmOnboardingContracts,
+} from './index';
+import { crmFirstWinTrack } from '../track';
+import {
+  crmOnboardingEvents,
+  emitCrmOnboardingEvent,
+} from '../handlers/demo.handlers';
+import type { CrmEvent } from '../handlers/demo.handlers';
+
+describe('crm onboarding contracts', () => {
+  it('exposes track metadata', () => {
+    expect(crmOnboardingContracts.track.id).toBe('crm_first_win');
+    expect(crmOnboardingContracts.track.steps.length).toBeGreaterThan(0);
+    expect(GetCrmOnboardingTrack.meta.name).toBe(
+      'learningJourney.crmOnboarding.getTrack'
+    );
+  });
+
+  it('allows recording events via demo handler', async () => {
+    const [step] = crmFirstWinTrack.steps;
+    expect(step).toBeDefined();
+    if (!step) throw new Error('Expected at least one CRM onboarding step');
+
+    const eventName = step.completion.eventName;
+    const isCrmEvent = (value: string): value is CrmEvent =>
+      crmOnboardingEvents.includes(value as CrmEvent);
+
+    expect(isCrmEvent(eventName)).toBe(true);
+    if (!isCrmEvent(eventName)) {
+      throw new Error(`Unexpected event name: ${eventName}`);
+    }
+
+    const result = await emitCrmOnboardingEvent(eventName, {
+      learnerId: 'demo-learner',
+    });
+    expect(result).toBeDefined();
+  });
+
+  it('exposes record event contract', () => {
+    expect(RecordCrmOnboardingEvent.meta.name).toBe(
+      'learningJourney.crmOnboarding.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 { crmFirstWinTrack } from '../track';
+
+const OWNERS = ['examples.learning-journey.crm-onboarding'] as const;
+
+const StepModel = defineSchemaModel({
+  name: 'CrmOnboardingStep',
+  description: 'Step metadata for CRM first win journey',
+  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 CrmOnboardingTrackModel = defineSchemaModel({
+  name: 'CrmOnboardingTrack',
+  description: 'CRM onboarding 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: 'CrmOnboardingTrackResponse',
+  description: 'Response wrapper for CRM onboarding track',
+  fields: {
+    track: { type: CrmOnboardingTrackModel, isOptional: false },
+  },
+});
+
+const RecordDemoEventInput = defineSchemaModel({
+  name: 'CrmOnboardingRecordEventInput',
+  description: 'Emit a demo event to advance CRM onboarding 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: 'CrmOnboardingSuccess',
+  description: 'Generic success response',
+  fields: {
+    success: { type: ScalarTypeEnum.Boolean(), isOptional: false },
+  },
+});
+
+export const GetCrmOnboardingTrack = defineQuery({
+  meta: {
+    name: 'learningJourney.crmOnboarding.getTrack',
+    version: 1,
+    stability: 'experimental',
+    owners: [...OWNERS],
+    tags: ['learning', 'crm', 'onboarding'],
+    description: 'Fetch CRM first win track definition.',
+    goal: 'Expose track metadata to UIs and templates.',
+    context: 'Called by Studio/Playground to render journey steps.',
+  },
+  io: {
+    input: defineSchemaModel({
+      name: 'CrmOnboardingTrackInput',
+      description: 'Track input',
+      fields: {},
+    }),
+    output: TrackResponseModel,
+  },
+  policy: { auth: 'user' },
+});
+
+export const RecordCrmOnboardingEvent = defineCommand({
+  meta: {
+    name: 'learningJourney.crmOnboarding.recordEvent',
+    version: 1,
+    stability: 'experimental',
+    owners: [...OWNERS],
+    tags: ['learning', 'crm', 'onboarding'],
+    description: 'Record an event to advance CRM onboarding 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 crmOnboardingContracts = {
+  GetCrmOnboardingTrack,
+  RecordCrmOnboardingEvent,
+  track: crmFirstWinTrack,
+};

package/src/docs/crm-onboarding.docblock.ts

@@ -0,0 +1,40 @@
+import type { DocBlock } from '@lssm/lib.contracts/docs';
+import { registerDocBlocks } from '@lssm/lib.contracts/docs';
+
+const crmOnboardingDocBlocks: DocBlock[] = [
+  {
+    id: 'docs.learning-journey.crm-onboarding',
+    title: 'Learning Journey — CRM First Win',
+    summary:
+      'Onboarding track for the CRM Pipeline example that drives users to first closed-won deal.',
+    kind: 'reference',
+    visibility: 'public',
+    route: '/docs/learning-journey/crm-onboarding',
+    tags: ['learning', 'crm', 'onboarding'],
+    body: `## Track
+- **Key**: \`crm_first_win\`
+- **Persona**: CRM adopter
+- **Goal**: From empty CRM to first closed-won deal with follow-up
+
+## Steps & Events
+1) \`create_pipeline\` → \`pipeline.created\`
+2) \`create_contact_and_company\` → \`contact.created\`
+3) \`create_first_deal\` → \`deal.created\`
+4) \`move_deal_in_pipeline\` → \`deal.moved\`
+5) \`close_deal_won\` → \`deal.won\`
+6) \`setup_follow_up\` → \`task.completed\` (type: follow_up)
+
+XP: 15/20/20/20/30/30 with 25 bonus within 72h. Badge: \`crm_first_win\`.
+
+## Wiring
+- Depends on \`@lssm/example.crm-pipeline\` events.
+- Tracks export from \`@lssm/example.learning-journey-crm-onboarding/track\`.
+- Use onboarding API:
+  - \`learning.onboarding.listTracks\`
+  - \`learning.onboarding.getProgress\`
+  - \`learning.onboarding.recordEvent\` wired from CRM event bus handlers.
+- Surface in CRM dashboard/pipeline UI to guide new users.`,
+  },
+];
+
+registerDocBlocks(crmOnboardingDocBlocks);

package/src/docs/index.ts

@@ -0,0 +1 @@
+import './crm-onboarding.docblock';

package/src/example.ts

@@ -0,0 +1,26 @@
+const example = {
+  id: 'learning-journey-crm-onboarding',
+  title: 'Learning Journey — CRM First Win',
+  summary:
+    'Onboarding track for CRM Pipeline driving users from empty CRM to first closed-won deal.',
+  tags: ['learning', 'crm', 'onboarding'],
+  kind: 'template',
+  visibility: 'public',
+  docs: {
+    rootDocId: 'docs.learning-journey.crm-onboarding',
+  },
+  entrypoints: {
+    packageName: '@lssm/example.learning-journey-crm-onboarding',
+    docs: './docs',
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ['playground', 'markdown'] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true },
+  },
+} as const;
+
+export default example;
+
+

package/src/handlers/demo.handlers.ts

@@ -0,0 +1,51 @@
+import { crmFirstWinTrack } 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 crmOnboardingEvents = [
+  'pipeline.created',
+  'contact.created',
+  'deal.created',
+  'deal.moved',
+  'deal.won',
+  'task.completed',
+] as const;
+
+export type CrmEvent = (typeof crmOnboardingEvents)[number];
+
+export const emitCrmOnboardingEvent = (
+  eventName: CrmEvent,
+  { learnerId, occurredAt = new Date(), payload }: EmitParams,
+  record?: RecordEvent
+) => {
+  const event: LearningJourneyEvent = {
+    learnerId,
+    name: eventName,
+    occurredAt,
+    payload,
+    trackId: crmFirstWinTrack.id,
+  };
+  return record ? record(event) : event;
+};
+
+export const emitAllCrmOnboardingEvents = (
+  params: EmitParams,
+  record?: RecordEvent
+) =>
+  crmOnboardingEvents.map((name) =>
+    emitCrmOnboardingEvent(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 { CrmOnboardingTrackModel } from '../contracts';
+
+const baseMeta: Pick<PresentationV2Meta, 'domain' | 'owners' | 'tags'> = {
+  domain: 'learning-journey',
+  owners: ['examples.learning-journey.crm-onboarding'],
+  tags: ['learning', 'crm', 'onboarding'],
+};
+
+export const CrmOnboardingTrackPresentation: PresentationDescriptorV2 = {
+  meta: {
+    name: 'learning.journey.crm.track',
+    version: 1,
+    description: 'CRM first win track detail',
+    ...baseMeta,
+  },
+  source: {
+    type: 'component',
+    framework: 'react',
+    componentKey: 'LearningTrackDetail',
+    props: CrmOnboardingTrackModel,
+  },
+  targets: ['react', 'markdown', 'application/json'],
+};
+
+export const CrmOnboardingWidgetPresentation: PresentationDescriptorV2 = {
+  meta: {
+    name: 'learning.journey.crm.widget',
+    version: 1,
+    description: 'Compact widget for CRM onboarding progress',
+    ...baseMeta,
+  },
+  source: {
+    type: 'component',
+    framework: 'react',
+    componentKey: 'LearningTrackProgressWidget',
+  },
+  targets: ['react'],
+};
+
+export const crmOnboardingPresentations = [
+  CrmOnboardingTrackPresentation,
+  CrmOnboardingWidgetPresentation,
+];

package/src/track.ts

@@ -0,0 +1,95 @@
+import type { LearningJourneyTrackSpec } from '@lssm/module.learning-journey/track-spec';
+
+export const crmFirstWinTrack: LearningJourneyTrackSpec = {
+  id: 'crm_first_win',
+  productId: 'crm-pipeline',
+  name: 'CRM First Win',
+  description:
+    'Guide a new CRM user from empty pipeline to first closed-won deal.',
+  targetUserSegment: 'crm_adopter',
+  targetRole: 'sales',
+  totalXp: 135,
+  streakRule: { hoursWindow: 72, bonusXp: 25 },
+  completionRewards: { xpBonus: 25, badgeKey: 'crm_first_win' },
+  steps: [
+    {
+      id: 'create_pipeline',
+      title: 'Create pipeline & stages',
+      description: 'Create a pipeline with baseline stages.',
+      order: 1,
+      completion: {
+        eventName: 'pipeline.created',
+        sourceModule: '@lssm/example.crm-pipeline',
+      },
+      xpReward: 15,
+      metadata: { surface: 'pipeline' },
+    },
+    {
+      id: 'create_contact_and_company',
+      title: 'Create contact and company',
+      description: 'Add your first contact and associated company.',
+      order: 2,
+      completion: {
+        eventName: 'contact.created',
+        sourceModule: '@lssm/example.crm-pipeline',
+      },
+      xpReward: 20,
+      metadata: { surface: 'contacts' },
+    },
+    {
+      id: 'create_first_deal',
+      title: 'Log first deal',
+      description: 'Create your first deal in the pipeline.',
+      order: 3,
+      completion: {
+        eventName: 'deal.created',
+        sourceModule: '@lssm/example.crm-pipeline',
+      },
+      xpReward: 20,
+      metadata: { surface: 'deals' },
+    },
+    {
+      id: 'move_deal_in_pipeline',
+      title: 'Move a deal across stages',
+      description: 'Move a deal across at least three stages.',
+      order: 4,
+      completion: {
+        eventName: 'deal.moved',
+        sourceModule: '@lssm/example.crm-pipeline',
+      },
+      xpReward: 20,
+      metadata: { surface: 'deals' },
+    },
+    {
+      id: 'close_deal_won',
+      title: 'Close a deal as won',
+      description: 'Close a deal as won to hit first revenue.',
+      order: 5,
+      completion: {
+        eventName: 'deal.won',
+        sourceModule: '@lssm/example.crm-pipeline',
+      },
+      xpReward: 30,
+      metadata: { surface: 'deals' },
+    },
+    {
+      id: 'setup_follow_up',
+      title: 'Create follow-up task',
+      description:
+        'Create a follow-up task and notification for a contact or deal.',
+      order: 6,
+      completion: {
+        eventName: 'task.completed',
+        sourceModule: '@lssm/example.crm-pipeline',
+        payloadFilter: { type: 'follow_up' },
+      },
+      xpReward: 30,
+      metadata: { surface: 'tasks' },
+    },
+  ],
+  metadata: {
+    surfacedIn: ['crm/dashboard', 'crm/pipeline'],
+  },
+};
+
+export const crmLearningTracks: LearningJourneyTrackSpec[] = [crmFirstWinTrack];

package/tsconfig.json

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