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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.learning-journey-studio-onboarding",
-  "version": "3.7.5",
+  "version": "3.7.7",
   "description": "Learning journey track for first 30 minutes in ContractSpec Studio.",
   "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.5",
-    "@contractspec/lib.schema": "3.7.5",
-    "@contractspec/module.learning-journey": "3.7.5"
+    "@contractspec/lib.contracts-spec": "4.0.0",
+    "@contractspec/lib.schema": "3.7.6",
+    "@contractspec/module.learning-journey": "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/studio-onboarding.docblock.ts

@@ -2,16 +2,16 @@ import type { DocBlock } from '@contractspec/lib.contracts-spec';
 import { registerDocBlocks } from '@contractspec/lib.contracts-spec';
 
 const studioOnboardingDocBlocks: DocBlock[] = [
-  {
-    id: 'docs.learning-journey.studio-onboarding',
-    title: 'Learning Journey — Studio Getting Started',
-    summary:
-      'Track that guides a new Studio user through template spawn, spec edit, regeneration, playground, and evolution.',
-    kind: 'reference',
-    visibility: 'public',
-    route: '/docs/learning-journey/studio-onboarding',
-    tags: ['learning', 'onboarding', 'studio'],
-    body: `## Track
+	{
+		id: 'docs.learning-journey.studio-onboarding',
+		title: 'Learning Journey — Studio Getting Started',
+		summary:
+			'Track that guides a new Studio user through template spawn, spec edit, regeneration, playground, and evolution.',
+		kind: 'reference',
+		visibility: 'public',
+		route: '/docs/learning-journey/studio-onboarding',
+		tags: ['learning', 'onboarding', 'studio'],
+		body: `## Track
 - **Key**: \`studio_getting_started\`
 - **Persona**: new Studio developer, first 30 minutes
 - **Goal**: instantiate template → edit spec → regenerate → play → run evolution
@@ -32,7 +32,7 @@ XP: 20/20/20/20/30 with bonus 25 XP if completed within 48h (streak rule). Badge
   - \`learning.onboarding.getProgress\` to render progress
   - \`learning.onboarding.recordEvent\` to advance from bus events
 - Events should be emitted by Studio surfaces (template creation, spec save, regeneration, playground session start, evolution apply).`,
-  },
+	},
 ];
 
 registerDocBlocks(studioOnboardingDocBlocks);

package/src/example.ts

@@ -1,31 +1,31 @@
 import { defineExample } from '@contractspec/lib.contracts-spec';
 
 const example = defineExample({
-  meta: {
-    key: 'learning-journey-studio-onboarding',
-    version: '1.0.0',
-    title: 'Learning Journey — Studio Getting Started',
-    description:
-      'Onboarding track guiding a new Studio user through template spawn, spec edit, regeneration, playground, and evolution.',
-    kind: 'template',
-    visibility: 'public',
-    stability: 'experimental',
-    owners: ['@platform.core'],
-    tags: ['learning', 'onboarding', 'studio'],
-  },
-  docs: {
-    rootDocId: 'docs.learning-journey.studio-onboarding',
-  },
-  entrypoints: {
-    packageName: '@contractspec/example.learning-journey-studio-onboarding',
-    docs: './docs',
-  },
-  surfaces: {
-    templates: true,
-    sandbox: { enabled: true, modes: ['playground', 'markdown'] },
-    studio: { enabled: true, installable: true },
-    mcp: { enabled: true },
-  },
+	meta: {
+		key: 'learning-journey-studio-onboarding',
+		version: '1.0.0',
+		title: 'Learning Journey — Studio Getting Started',
+		description:
+			'Onboarding track guiding a new Studio user through template spawn, spec edit, regeneration, playground, and evolution.',
+		kind: 'template',
+		visibility: 'public',
+		stability: 'experimental',
+		owners: ['@platform.core'],
+		tags: ['learning', 'onboarding', 'studio'],
+	},
+	docs: {
+		rootDocId: 'docs.learning-journey.studio-onboarding',
+	},
+	entrypoints: {
+		packageName: '@contractspec/example.learning-journey-studio-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,48 +1,48 @@
 import { studioGettingStartedTrack } from '../track';
 
 interface EmitParams {
-  learnerId: string;
-  occurredAt?: Date;
+	learnerId: string;
+	occurredAt?: Date;
 }
 
 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 studioOnboardingEvents = [
-  'studio.template.instantiated',
-  'spec.changed',
-  'regeneration.completed',
-  'playground.session.started',
-  'studio.evolution.applied',
+	'studio.template.instantiated',
+	'spec.changed',
+	'regeneration.completed',
+	'playground.session.started',
+	'studio.evolution.applied',
 ] as const;
 
 export type StudioEvent = (typeof studioOnboardingEvents)[number];
 
 export const emitStudioOnboardingEvent = (
-  eventName: StudioEvent,
-  { learnerId, occurredAt = new Date() }: EmitParams,
-  record?: RecordEvent
+	eventName: StudioEvent,
+	{ learnerId, occurredAt = new Date() }: EmitParams,
+	record?: RecordEvent
 ) => {
-  const event: LearningJourneyEvent = {
-    learnerId,
-    name: eventName,
-    occurredAt,
-    trackId: studioGettingStartedTrack.id,
-  };
-  return record ? record(event) : event;
+	const event: LearningJourneyEvent = {
+		learnerId,
+		name: eventName,
+		occurredAt,
+		trackId: studioGettingStartedTrack.id,
+	};
+	return record ? record(event) : event;
 };
 
 export const emitAllStudioOnboardingEvents = (
-  params: EmitParams,
-  record?: RecordEvent
+	params: EmitParams,
+	record?: RecordEvent
 ) =>
-  studioOnboardingEvents.map((name) =>
-    emitStudioOnboardingEvent(name, params, record)
-  );
+	studioOnboardingEvents.map((name) =>
+		emitStudioOnboardingEvent(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-studio-onboarding.feature';
-export { default as example } from './example';
+export * from './operations';
+export * from './presentations';
+export * from './track';

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

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

package/src/operations/index.test.ts

@@ -1,49 +1,48 @@
 import { describe, expect, it } from 'bun:test';
-
+import type { StudioEvent } from '../handlers/demo.handlers';
 import {
-  GetStudioOnboardingTrack,
-  RecordStudioOnboardingEvent,
-  studioOnboardingContracts,
-} from './index';
+	emitStudioOnboardingEvent,
+	studioOnboardingEvents,
+} from '../handlers/demo.handlers';
 import { studioGettingStartedTrack } from '../track';
 import {
-  emitStudioOnboardingEvent,
-  studioOnboardingEvents,
-} from '../handlers/demo.handlers';
-import type { StudioEvent } from '../handlers/demo.handlers';
+	GetStudioOnboardingTrack,
+	RecordStudioOnboardingEvent,
+	studioOnboardingContracts,
+} from './index';
 
 describe('studio onboarding contracts', () => {
-  it('exposes track metadata', () => {
-    expect(studioOnboardingContracts.track.id).toBe('studio_getting_started');
-    expect(studioOnboardingContracts.track.steps.length).toBeGreaterThan(0);
-    expect(GetStudioOnboardingTrack.meta.key).toBe(
-      'learningJourney.studioOnboarding.getTrack'
-    );
-  });
+	it('exposes track metadata', () => {
+		expect(studioOnboardingContracts.track.id).toBe('studio_getting_started');
+		expect(studioOnboardingContracts.track.steps.length).toBeGreaterThan(0);
+		expect(GetStudioOnboardingTrack.meta.key).toBe(
+			'learningJourney.studioOnboarding.getTrack'
+		);
+	});
 
-  it('allows recording events via demo handler', async () => {
-    const step = studioGettingStartedTrack.steps[0];
-    expect(step).toBeDefined();
-    if (!step) throw new Error('Expected at least one onboarding step');
+	it('allows recording events via demo handler', async () => {
+		const step = studioGettingStartedTrack.steps[0];
+		expect(step).toBeDefined();
+		if (!step) throw new Error('Expected at least one onboarding step');
 
-    const eventName = step.completion.eventName;
-    const isStudioEvent = (value: string): value is StudioEvent =>
-      studioOnboardingEvents.includes(value as StudioEvent);
+		const eventName = step.completion.eventName;
+		const isStudioEvent = (value: string): value is StudioEvent =>
+			studioOnboardingEvents.includes(value as StudioEvent);
 
-    expect(isStudioEvent(eventName)).toBe(true);
-    if (!isStudioEvent(eventName)) {
-      throw new Error(`Unexpected event name: ${eventName}`);
-    }
+		expect(isStudioEvent(eventName)).toBe(true);
+		if (!isStudioEvent(eventName)) {
+			throw new Error(`Unexpected event name: ${eventName}`);
+		}
 
-    const result = await emitStudioOnboardingEvent(eventName, {
-      learnerId: 'demo-learner',
-    });
-    expect(result).toBeDefined();
-  });
+		const result = await emitStudioOnboardingEvent(eventName, {
+			learnerId: 'demo-learner',
+		});
+		expect(result).toBeDefined();
+	});
 
-  it('exposes record event contract', () => {
-    expect(RecordStudioOnboardingEvent.meta.key).toBe(
-      'learningJourney.studioOnboarding.recordEvent'
-    );
-  });
+	it('exposes record event contract', () => {
+		expect(RecordStudioOnboardingEvent.meta.key).toBe(
+			'learningJourney.studioOnboarding.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 { studioGettingStartedTrack } from '../track';
 
 const OWNERS = ['examples.learning-journey.studio-onboarding'] as const;
 
 const StepModel = defineSchemaModel({
-  name: 'StudioOnboardingStep',
-  description: 'Step metadata for Studio onboarding 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: 'StudioOnboardingStep',
+	description: 'Step metadata for Studio onboarding 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 StudioOnboardingTrackModel = defineSchemaModel({
-  name: 'StudioOnboardingTrack',
-  description: 'Studio 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: 'StudioOnboardingTrack',
+	description: 'Studio 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: 'StudioOnboardingTrackResponse',
-  description: 'Response wrapper for studio onboarding track',
-  fields: {
-    track: { type: StudioOnboardingTrackModel, isOptional: false },
-  },
+	name: 'StudioOnboardingTrackResponse',
+	description: 'Response wrapper for studio onboarding track',
+	fields: {
+		track: { type: StudioOnboardingTrackModel, isOptional: false },
+	},
 });
 
 const RecordDemoEventInput = defineSchemaModel({
-  name: 'StudioOnboardingRecordEventInput',
-  description: 'Emit a demo event to advance Studio 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: 'StudioOnboardingRecordEventInput',
+	description: 'Emit a demo event to advance Studio 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: 'StudioOnboardingSuccess',
-  description: 'Generic success response',
-  fields: {
-    success: { type: ScalarTypeEnum.Boolean(), isOptional: false },
-  },
+	name: 'StudioOnboardingSuccess',
+	description: 'Generic success response',
+	fields: {
+		success: { type: ScalarTypeEnum.Boolean(), isOptional: false },
+	},
 });
 
 export const GetStudioOnboardingTrack = defineQuery({
-  meta: {
-    key: 'learningJourney.studioOnboarding.getTrack',
-    version: '1.0.0',
-    stability: 'experimental',
-    owners: [...OWNERS],
-    tags: ['learning', 'onboarding', 'studio'],
-    description: 'Fetch the Studio onboarding track definition.',
-    goal: 'Expose track metadata to UIs and templates.',
-    context: 'Called by Studio/Playground to render journey steps.',
-  },
-  io: {
-    input: defineSchemaModel({
-      name: 'StudioOnboardingTrackInput',
-      description: 'Track input',
-      fields: {},
-    }),
-    output: TrackResponseModel,
-  },
-  policy: { auth: 'user' },
+	meta: {
+		key: 'learningJourney.studioOnboarding.getTrack',
+		version: '1.0.0',
+		stability: 'experimental',
+		owners: [...OWNERS],
+		tags: ['learning', 'onboarding', 'studio'],
+		description: 'Fetch the Studio onboarding track definition.',
+		goal: 'Expose track metadata to UIs and templates.',
+		context: 'Called by Studio/Playground to render journey steps.',
+	},
+	io: {
+		input: defineSchemaModel({
+			name: 'StudioOnboardingTrackInput',
+			description: 'Track input',
+			fields: {},
+		}),
+		output: TrackResponseModel,
+	},
+	policy: { auth: 'user' },
 });
 
 export const RecordStudioOnboardingEvent = defineCommand({
-  meta: {
-    key: 'learningJourney.studioOnboarding.recordEvent',
-    version: '1.0.0',
-    stability: 'experimental',
-    owners: [...OWNERS],
-    tags: ['learning', 'onboarding', 'studio'],
-    description: 'Record an event to advance Studio 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.studioOnboarding.recordEvent',
+		version: '1.0.0',
+		stability: 'experimental',
+		owners: [...OWNERS],
+		tags: ['learning', 'onboarding', 'studio'],
+		description: 'Record an event to advance Studio 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 studioOnboardingContracts = {
-  GetStudioOnboardingTrack,
-  RecordStudioOnboardingEvent,
-  track: studioGettingStartedTrack,
+	GetStudioOnboardingTrack,
+	RecordStudioOnboardingEvent,
+	track: studioGettingStartedTrack,
 };