@contractspec/example.learning-journey-crm-onboarding 3.7.5 → 3.7.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.learning-journey-crm-onboarding",
-  "version": "3.7.5",
+  "version": "3.7.7",
   "description": "Learning journey track that onboards users to the CRM pipeline example.",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -85,21 +85,21 @@
     "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
-    "lint:fix": "eslint src --fix",
-    "lint:check": "eslint src",
+    "lint:fix": "biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .",
+    "lint:check": "biome check .",
     "prebuild": "contractspec-bun-build prebuild",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.contracts-spec": "3.7.5",
-    "@contractspec/lib.schema": "3.7.5",
-    "@contractspec/module.learning-journey": "3.7.5",
-    "@contractspec/example.crm-pipeline": "3.7.5"
+    "@contractspec/lib.contracts-spec": "4.0.0",
+    "@contractspec/lib.schema": "3.7.6",
+    "@contractspec/module.learning-journey": "3.7.7",
+    "@contractspec/example.crm-pipeline": "3.7.7"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.5",
+    "@contractspec/tool.typescript": "3.7.6",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.7.5"
+    "@contractspec/tool.bun": "3.7.6"
   },
   "publishConfig": {
     "exports": {

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

@@ -2,16 +2,16 @@ import type { DocBlock } from '@contractspec/lib.contracts-spec/docs';
 import { registerDocBlocks } from '@contractspec/lib.contracts-spec/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
+	{
+		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
@@ -34,7 +34,7 @@ XP: 15/20/20/20/30/30 with 25 bonus within 72h. Badge: \`crm_first_win\`.
   - \`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/example.ts

@@ -1,31 +1,31 @@
 import { defineExample } from '@contractspec/lib.contracts-spec';
 
 const example = defineExample({
-  meta: {
-    key: 'learning-journey-crm-onboarding',
-    version: '1.0.0',
-    title: 'Learning Journey — CRM First Win',
-    description:
-      'Onboarding track for CRM Pipeline driving users from empty CRM to first closed-won deal.',
-    kind: 'template',
-    visibility: 'public',
-    stability: 'experimental',
-    owners: ['@platform.core'],
-    tags: ['learning', 'crm', 'onboarding'],
-  },
-  docs: {
-    rootDocId: 'docs.learning-journey.crm-onboarding',
-  },
-  entrypoints: {
-    packageName: '@contractspec/example.learning-journey-crm-onboarding',
-    docs: './docs',
-  },
-  surfaces: {
-    templates: true,
-    sandbox: { enabled: true, modes: ['playground', 'markdown'] },
-    studio: { enabled: true, installable: true },
-    mcp: { enabled: true },
-  },
+	meta: {
+		key: 'learning-journey-crm-onboarding',
+		version: '1.0.0',
+		title: 'Learning Journey — CRM First Win',
+		description:
+			'Onboarding track for CRM Pipeline driving users from empty CRM to first closed-won deal.',
+		kind: 'template',
+		visibility: 'public',
+		stability: 'experimental',
+		owners: ['@platform.core'],
+		tags: ['learning', 'crm', 'onboarding'],
+	},
+	docs: {
+		rootDocId: 'docs.learning-journey.crm-onboarding',
+	},
+	entrypoints: {
+		packageName: '@contractspec/example.learning-journey-crm-onboarding',
+		docs: './docs',
+	},
+	surfaces: {
+		templates: true,
+		sandbox: { enabled: true, modes: ['playground', 'markdown'] },
+		studio: { enabled: true, installable: true },
+		mcp: { enabled: true },
+	},
 });
 
 export default example;

package/src/handlers/demo.handlers.ts

@@ -1,51 +1,51 @@
 import { crmFirstWinTrack } from '../track';
 
 interface EmitParams {
-  learnerId: string;
-  occurredAt?: Date;
-  payload?: Record<string, unknown>;
+	learnerId: string;
+	occurredAt?: Date;
+	payload?: Record<string, unknown>;
 }
 
 interface LearningJourneyEvent {
-  learnerId: string;
-  name: string;
-  occurredAt: Date;
-  trackId: string;
-  payload?: Record<string, unknown>;
+	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',
+	'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
+	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;
+	const event: LearningJourneyEvent = {
+		learnerId,
+		name: eventName,
+		occurredAt,
+		payload,
+		trackId: crmFirstWinTrack.id,
+	};
+	return record ? record(event) : event;
 };
 
 export const emitAllCrmOnboardingEvents = (
-  params: EmitParams,
-  record?: RecordEvent
+	params: EmitParams,
+	record?: RecordEvent
 ) =>
-  crmOnboardingEvents.map((name) =>
-    emitCrmOnboardingEvent(name, params, record)
-  );
+	crmOnboardingEvents.map((name) =>
+		emitCrmOnboardingEvent(name, params, record)
+	);

package/src/index.ts

@@ -1,7 +1,7 @@
-export * from './track';
 export * from './docs';
-export * from './operations';
+export { default as example } from './example';
 export * from './handlers/demo.handlers';
-export * from './presentations';
 export * from './learning-journey-crm-onboarding.feature';
-export { default as example } from './example';
+export * from './operations';
+export * from './presentations';
+export * from './track';

package/src/learning-journey-crm-onboarding.feature.ts

@@ -10,59 +10,59 @@ import { defineFeature } from '@contractspec/lib.contracts-spec';
  * CRM-specific onboarding track operations and presentations.
  */
 export const LearningJourneyCrmOnboardingFeature = defineFeature({
-  meta: {
-    key: 'learning-journey-crm-onboarding',
-    title: 'Learning Journey: CRM Onboarding',
-    description:
-      'CRM first-win onboarding journey with step-by-step guidance for new CRM users',
-    domain: 'learning-journey',
-    owners: ['@examples.learning-journey.crm-onboarding'],
-    tags: ['learning', 'crm', 'onboarding', 'journey'],
-    stability: 'experimental',
-    version: '1.0.0',
-  },
+	meta: {
+		key: 'learning-journey-crm-onboarding',
+		title: 'Learning Journey: CRM Onboarding',
+		description:
+			'CRM first-win onboarding journey with step-by-step guidance for new CRM users',
+		domain: 'learning-journey',
+		owners: ['@examples.learning-journey.crm-onboarding'],
+		tags: ['learning', 'crm', 'onboarding', 'journey'],
+		stability: 'experimental',
+		version: '1.0.0',
+	},
 
-  // All contract operations included in this feature
-  operations: [
-    { key: 'learningJourney.crmOnboarding.recordEvent', version: '1.0.0' },
-    { key: 'learningJourney.crmOnboarding.getTrack', version: '1.0.0' },
-  ],
+	// All contract operations included in this feature
+	operations: [
+		{ key: 'learningJourney.crmOnboarding.recordEvent', version: '1.0.0' },
+		{ key: 'learningJourney.crmOnboarding.getTrack', version: '1.0.0' },
+	],
 
-  // Events emitted by this feature
-  events: [],
+	// Events emitted by this feature
+	events: [],
 
-  // Presentations associated with this feature
-  presentations: [
-    { key: 'learning.journey.crm.track', version: '1.0.0' },
-    { key: 'learning.journey.crm.widget', version: '1.0.0' },
-  ],
+	// Presentations associated with this feature
+	presentations: [
+		{ key: 'learning.journey.crm.track', version: '1.0.0' },
+		{ key: 'learning.journey.crm.widget', version: '1.0.0' },
+	],
 
-  // Link operations to their primary presentations
-  opToPresentation: [
-    {
-      op: { key: 'learningJourney.crmOnboarding.getTrack', version: '1.0.0' },
-      pres: { key: 'learning.journey.crm.track', version: '1.0.0' },
-    },
-  ],
+	// Link operations to their primary presentations
+	opToPresentation: [
+		{
+			op: { key: 'learningJourney.crmOnboarding.getTrack', version: '1.0.0' },
+			pres: { key: 'learning.journey.crm.track', version: '1.0.0' },
+		},
+	],
 
-  // Target requirements for multi-surface rendering
-  presentationsTargets: [
-    {
-      key: 'learning.journey.crm.track',
-      version: '1.0.0',
-      targets: ['react', 'markdown', 'application/json'],
-    },
-    {
-      key: 'learning.journey.crm.widget',
-      version: '1.0.0',
-      targets: ['react'],
-    },
-  ],
+	// Target requirements for multi-surface rendering
+	presentationsTargets: [
+		{
+			key: 'learning.journey.crm.track',
+			version: '1.0.0',
+			targets: ['react', 'markdown', 'application/json'],
+		},
+		{
+			key: 'learning.journey.crm.widget',
+			version: '1.0.0',
+			targets: ['react'],
+		},
+	],
 
-  // Capability requirements
-  capabilities: {
-    requires: [{ key: 'identity', version: '1.0.0' }],
-  },
+	// Capability requirements
+	capabilities: {
+		requires: [{ key: 'identity', version: '1.0.0' }],
+	},
 
-  docs: ['docs.learning-journey.crm-onboarding'],
+	docs: ['docs.learning-journey.crm-onboarding'],
 });

package/src/operations/index.test.ts

@@ -1,49 +1,48 @@
 import { describe, expect, it } from 'bun:test';
-
+import type { CrmEvent } from '../handlers/demo.handlers';
 import {
-  GetCrmOnboardingTrack,
-  RecordCrmOnboardingEvent,
-  crmOnboardingContracts,
-} from './index';
+	crmOnboardingEvents,
+	emitCrmOnboardingEvent,
+} from '../handlers/demo.handlers';
 import { crmFirstWinTrack } from '../track';
 import {
-  crmOnboardingEvents,
-  emitCrmOnboardingEvent,
-} from '../handlers/demo.handlers';
-import type { CrmEvent } from '../handlers/demo.handlers';
+	crmOnboardingContracts,
+	GetCrmOnboardingTrack,
+	RecordCrmOnboardingEvent,
+} from './index';
 
 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.key).toBe(
-      'learningJourney.crmOnboarding.getTrack'
-    );
-  });
+	it('exposes track metadata', () => {
+		expect(crmOnboardingContracts.track.id).toBe('crm_first_win');
+		expect(crmOnboardingContracts.track.steps.length).toBeGreaterThan(0);
+		expect(GetCrmOnboardingTrack.meta.key).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');
+	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);
+		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}`);
-    }
+		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();
-  });
+		const result = await emitCrmOnboardingEvent(eventName, {
+			learnerId: 'demo-learner',
+		});
+		expect(result).toBeDefined();
+	});
 
-  it('exposes record event contract', () => {
-    expect(RecordCrmOnboardingEvent.meta.key).toBe(
-      'learningJourney.crmOnboarding.recordEvent'
-    );
-  });
+	it('exposes record event contract', () => {
+		expect(RecordCrmOnboardingEvent.meta.key).toBe(
+			'learningJourney.crmOnboarding.recordEvent'
+		);
+	});
 });

package/src/operations/index.ts

@@ -1,122 +1,122 @@
-import { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';
 import { defineCommand, defineQuery } from '@contractspec/lib.contracts-spec';
+import { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';
 
 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 },
-  },
+	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 },
-  },
+	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 },
-  },
+	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 },
-  },
+	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 },
-  },
+	name: 'CrmOnboardingSuccess',
+	description: 'Generic success response',
+	fields: {
+		success: { type: ScalarTypeEnum.Boolean(), isOptional: false },
+	},
 });
 
 export const GetCrmOnboardingTrack = defineQuery({
-  meta: {
-    key: 'learningJourney.crmOnboarding.getTrack',
-    version: '1.0.0',
-    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' },
+	meta: {
+		key: 'learningJourney.crmOnboarding.getTrack',
+		version: '1.0.0',
+		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: {
-    key: 'learningJourney.crmOnboarding.recordEvent',
-    version: '1.0.0',
-    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' },
+	meta: {
+		key: 'learningJourney.crmOnboarding.recordEvent',
+		version: '1.0.0',
+		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,
+	GetCrmOnboardingTrack,
+	RecordCrmOnboardingEvent,
+	track: crmFirstWinTrack,
 };