@contractspec/example.learning-journey-platform-tour 3.7.6 → 3.7.10

package/dist/presentations/index.js

@@ -104,8 +104,8 @@ var platformLearningTracks = [
 ];
 
 // src/operations/index.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
 import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var OWNERS = ["examples.learning-journey.platform-tour"];
 var StepModel = defineSchemaModel({
   name: "PlatformTourStep",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.learning-journey-platform-tour",
-  "version": "3.7.6",
+  "version": "3.7.10",
   "description": "Learning journey track covering ContractSpec platform primitives.",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -85,20 +85,20 @@
     "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.6",
-    "@contractspec/lib.schema": "3.7.6",
-    "@contractspec/module.learning-journey": "3.7.6"
+    "@contractspec/lib.contracts-spec": "4.1.2",
+    "@contractspec/lib.schema": "3.7.8",
+    "@contractspec/module.learning-journey": "3.7.10"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.6",
+    "@contractspec/tool.typescript": "3.7.8",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.7.6"
+    "@contractspec/tool.bun": "3.7.8"
   },
   "publishConfig": {
     "exports": {

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

@@ -2,16 +2,16 @@ import type { DocBlock } from '@contractspec/lib.contracts-spec/docs';
 import { registerDocBlocks } from '@contractspec/lib.contracts-spec/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
+	{
+		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
@@ -34,7 +34,7 @@ XP: 20 per step, 20 bonus XP upon completion.
   - \`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

@@ -1,33 +1,33 @@
 import { defineExample } from '@contractspec/lib.contracts-spec';
 
 const example = defineExample({
-  meta: {
-    key: 'learning-journey-platform-tour',
-    version: '1.0.0',
-    title: 'Learning Journey — Platform Tour',
-    description:
-      'Learning journey track + contracts + presentations for a platform tour.',
-    kind: 'template',
-    visibility: 'public',
-    stability: 'experimental',
-    owners: ['@platform.core'],
-    tags: ['learning', 'journey', 'platform-tour'],
-  },
-  docs: {
-    rootDocId: 'docs.examples.platform-tour',
-    goalDocId: 'docs.examples.platform-tour.goal',
-    usageDocId: 'docs.examples.platform-tour.usage',
-  },
-  entrypoints: {
-    packageName: '@contractspec/example.learning-journey-platform-tour',
-    docs: './docs',
-  },
-  surfaces: {
-    templates: true,
-    sandbox: { enabled: true, modes: ['markdown', 'playground'] },
-    studio: { enabled: true, installable: true },
-    mcp: { enabled: true },
-  },
+	meta: {
+		key: 'learning-journey-platform-tour',
+		version: '1.0.0',
+		title: 'Learning Journey — Platform Tour',
+		description:
+			'Learning journey track + contracts + presentations for a platform tour.',
+		kind: 'template',
+		visibility: 'public',
+		stability: 'experimental',
+		owners: ['@platform.core'],
+		tags: ['learning', 'journey', 'platform-tour'],
+	},
+	docs: {
+		rootDocId: 'docs.examples.platform-tour',
+		goalDocId: 'docs.examples.platform-tour.goal',
+		usageDocId: 'docs.examples.platform-tour.usage',
+	},
+	entrypoints: {
+		packageName: '@contractspec/example.learning-journey-platform-tour',
+		docs: './docs',
+	},
+	surfaces: {
+		templates: true,
+		sandbox: { enabled: true, modes: ['markdown', 'playground'] },
+		studio: { enabled: true, installable: true },
+		mcp: { enabled: true },
+	},
 });
 
 export default example;

package/src/handlers/demo.handlers.ts

@@ -1,50 +1,50 @@
 import { platformPrimitivesTourTrack } 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 platformTourEvents = [
-  'org.member.added',
-  'audit_log.created',
-  'notification.sent',
-  'job.completed',
-  'flag.toggled',
-  'attachment.attached',
-  'usage.recorded',
+	'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
+	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;
+	const event: LearningJourneyEvent = {
+		learnerId,
+		name: eventName,
+		occurredAt,
+		payload,
+		trackId: platformPrimitivesTourTrack.id,
+	};
+	return record ? record(event) : event;
 };
 
 export const emitAllPlatformTourEvents = (
-  params: EmitParams,
-  record?: RecordEvent
+	params: EmitParams,
+	record?: RecordEvent
 ) =>
-  platformTourEvents.map((name) => emitPlatformTourEvent(name, params, record));
+	platformTourEvents.map((name) => emitPlatformTourEvent(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-platform-tour.feature';
-export { default as example } from './example';
+export * from './operations';
+export * from './presentations';
+export * from './track';

package/src/learning-journey-platform-tour.feature.ts

@@ -10,59 +10,59 @@ import { defineFeature } from '@contractspec/lib.contracts-spec';
  * platform-specific tour track operations and presentations.
  */
 export const LearningJourneyPlatformTourFeature = defineFeature({
-  meta: {
-    key: 'learning-journey-platform-tour',
-    version: '1.0.0',
-    title: 'Learning Journey: Platform Tour',
-    description:
-      'Platform primitives tour journey for exploring ContractSpec core features',
-    domain: 'learning-journey',
-    owners: ['@examples.learning-journey.platform-tour'],
-    tags: ['learning', 'platform', 'tour', 'journey'],
-    stability: 'experimental',
-  },
+	meta: {
+		key: 'learning-journey-platform-tour',
+		version: '1.0.0',
+		title: 'Learning Journey: Platform Tour',
+		description:
+			'Platform primitives tour journey for exploring ContractSpec core features',
+		domain: 'learning-journey',
+		owners: ['@examples.learning-journey.platform-tour'],
+		tags: ['learning', 'platform', 'tour', 'journey'],
+		stability: 'experimental',
+	},
 
-  // All contract operations included in this feature
-  operations: [
-    { key: 'learningJourney.platformTour.recordEvent', version: '1.0.0' },
-    { key: 'learningJourney.platformTour.getTrack', version: '1.0.0' },
-  ],
+	// All contract operations included in this feature
+	operations: [
+		{ key: 'learningJourney.platformTour.recordEvent', version: '1.0.0' },
+		{ key: 'learningJourney.platformTour.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.platform.track', version: '1.0.0' },
-    { key: 'learning.journey.platform.widget', version: '1.0.0' },
-  ],
+	// Presentations associated with this feature
+	presentations: [
+		{ key: 'learning.journey.platform.track', version: '1.0.0' },
+		{ key: 'learning.journey.platform.widget', version: '1.0.0' },
+	],
 
-  // Link operations to their primary presentations
-  opToPresentation: [
-    {
-      op: { key: 'learningJourney.platformTour.getTrack', version: '1.0.0' },
-      pres: { key: 'learning.journey.platform.track', version: '1.0.0' },
-    },
-  ],
+	// Link operations to their primary presentations
+	opToPresentation: [
+		{
+			op: { key: 'learningJourney.platformTour.getTrack', version: '1.0.0' },
+			pres: { key: 'learning.journey.platform.track', version: '1.0.0' },
+		},
+	],
 
-  // Target requirements for multi-surface rendering
-  presentationsTargets: [
-    {
-      key: 'learning.journey.platform.track',
-      version: '1.0.0',
-      targets: ['react', 'markdown', 'application/json'],
-    },
-    {
-      key: 'learning.journey.platform.widget',
-      version: '1.0.0',
-      targets: ['react'],
-    },
-  ],
+	// Target requirements for multi-surface rendering
+	presentationsTargets: [
+		{
+			key: 'learning.journey.platform.track',
+			version: '1.0.0',
+			targets: ['react', 'markdown', 'application/json'],
+		},
+		{
+			key: 'learning.journey.platform.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.platform-tour'],
+	docs: ['docs.learning-journey.platform-tour'],
 });

package/src/operations/index.test.ts

@@ -1,49 +1,48 @@
 import { describe, expect, it } from 'bun:test';
-
+import type { PlatformEvent } from '../handlers/demo.handlers';
 import {
-  GetPlatformTourTrack,
-  RecordPlatformTourEvent,
-  platformTourContracts,
-} from './index';
+	emitPlatformTourEvent,
+	platformTourEvents,
+} from '../handlers/demo.handlers';
 import { platformPrimitivesTourTrack } from '../track';
 import {
-  emitPlatformTourEvent,
-  platformTourEvents,
-} from '../handlers/demo.handlers';
-import type { PlatformEvent } from '../handlers/demo.handlers';
+	GetPlatformTourTrack,
+	platformTourContracts,
+	RecordPlatformTourEvent,
+} from './index';
 
 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.key).toBe(
-      'learningJourney.platformTour.getTrack'
-    );
-  });
+	it('exposes track metadata', () => {
+		expect(platformTourContracts.track.id).toBe('platform_primitives_tour');
+		expect(platformTourContracts.track.steps.length).toBeGreaterThan(0);
+		expect(GetPlatformTourTrack.meta.key).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');
+	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);
+		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}`);
-    }
+		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();
-  });
+		const result = await emitPlatformTourEvent(eventName, {
+			learnerId: 'demo-learner',
+		});
+		expect(result).toBeDefined();
+	});
 
-  it('exposes record event contract', () => {
-    expect(RecordPlatformTourEvent.meta.key).toBe(
-      'learningJourney.platformTour.recordEvent'
-    );
-  });
+	it('exposes record event contract', () => {
+		expect(RecordPlatformTourEvent.meta.key).toBe(
+			'learningJourney.platformTour.recordEvent'
+		);
+	});
 });

package/src/operations/index.ts

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