@contractspec/example.learning-journey-platform-tour 0.0.0-canary-20260113162409

package/dist/tests/operations.test-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.test-spec.d.ts","names":[],"sources":["../../src/tests/operations.test-spec.ts"],"sourcesContent":[],"mappings":";;;cAEa,cA4BX,4BAAA,CA5BuB"}

package/dist/tests/operations.test-spec.js

@@ -0,0 +1,36 @@
+import { defineTestSpec } from "@contractspec/lib.contracts";
+
+//#region src/tests/operations.test-spec.ts
+const GetTrackTest = defineTestSpec({
+	meta: {
+		key: "learningJourney.platformTour.getTrack.test",
+		version: "1.0.0",
+		stability: "experimental",
+		owners: ["@example.learning-journey-platform-tour"],
+		description: "Test for getting platform tour track",
+		tags: ["test"]
+	},
+	target: {
+		type: "operation",
+		operation: {
+			key: "learningJourney.platformTour.getTrack",
+			version: "1.0.0"
+		}
+	},
+	scenarios: [{
+		key: "success",
+		when: { operation: { key: "learningJourney.platformTour.getTrack" } },
+		then: [{
+			type: "expectOutput",
+			match: {}
+		}]
+	}, {
+		key: "error",
+		when: { operation: { key: "learningJourney.platformTour.getTrack" } },
+		then: [{ type: "expectError" }]
+	}]
+});
+
+//#endregion
+export { GetTrackTest };
+//# sourceMappingURL=operations.test-spec.js.map

package/dist/tests/operations.test-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.test-spec.js","names":[],"sources":["../../src/tests/operations.test-spec.ts"],"sourcesContent":["import { defineTestSpec } from '@contractspec/lib.contracts';\n\nexport const GetTrackTest = defineTestSpec({\n  meta: {\n    key: 'learningJourney.platformTour.getTrack.test',\n    version: '1.0.0',\n    stability: 'experimental',\n    owners: ['@example.learning-journey-platform-tour'],\n    description: 'Test for getting platform tour track',\n    tags: ['test'],\n  },\n  target: {\n    type: 'operation',\n    operation: {\n      key: 'learningJourney.platformTour.getTrack',\n      version: '1.0.0',\n    },\n  },\n  scenarios: [\n    {\n      key: 'success',\n      when: { operation: { key: 'learningJourney.platformTour.getTrack' } },\n      then: [{ type: 'expectOutput', match: {} }],\n    },\n    {\n      key: 'error',\n      when: { operation: { key: 'learningJourney.platformTour.getTrack' } },\n      then: [{ type: 'expectError' }],\n    },\n  ],\n});\n"],"mappings":";;;AAEA,MAAa,eAAe,eAAe;CACzC,MAAM;EACJ,KAAK;EACL,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,0CAA0C;EACnD,aAAa;EACb,MAAM,CAAC,OAAO;EACf;CACD,QAAQ;EACN,MAAM;EACN,WAAW;GACT,KAAK;GACL,SAAS;GACV;EACF;CACD,WAAW,CACT;EACE,KAAK;EACL,MAAM,EAAE,WAAW,EAAE,KAAK,yCAAyC,EAAE;EACrE,MAAM,CAAC;GAAE,MAAM;GAAgB,OAAO,EAAE;GAAE,CAAC;EAC5C,EACD;EACE,KAAK;EACL,MAAM,EAAE,WAAW,EAAE,KAAK,yCAAyC,EAAE;EACrE,MAAM,CAAC,EAAE,MAAM,eAAe,CAAC;EAChC,CACF;CACF,CAAC"}

package/dist/track.d.ts

@@ -0,0 +1,8 @@
+import { LearningJourneyTrackSpec } from "@contractspec/module.learning-journey/track-spec";
+
+//#region src/track.d.ts
+declare const platformPrimitivesTourTrack: LearningJourneyTrackSpec;
+declare const platformLearningTracks: LearningJourneyTrackSpec[];
+//#endregion
+export { platformLearningTracks, platformPrimitivesTourTrack };
+//# sourceMappingURL=track.d.ts.map

package/dist/track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.d.ts","names":[],"sources":["../src/track.ts"],"sourcesContent":[],"mappings":";;;cAEa,6BAA6B;cAqG7B,wBAAwB"}

package/dist/track.js

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

package/dist/track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.js","names":[],"sources":["../src/track.ts"],"sourcesContent":["import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';\n\nexport const platformPrimitivesTourTrack: LearningJourneyTrackSpec = {\n  id: 'platform_primitives_tour',\n  productId: 'contractspec-platform',\n  name: 'Platform Primitives Tour',\n  description:\n    'Hands-on tour across identity, audit, notifications, jobs, flags, files, and metering.',\n  targetUserSegment: 'platform_developer',\n  targetRole: 'developer',\n  totalXp: 140,\n  completionRewards: { xpBonus: 20, badgeKey: 'platform_primitives' },\n  steps: [\n    {\n      id: 'identity_rbac',\n      title: 'Create org and member',\n      description: 'Create an org and add at least one member.',\n      order: 1,\n      completion: {\n        eventName: 'org.member.added',\n        sourceModule: '@contractspec/lib.identity-rbac',\n      },\n      xpReward: 20,\n      metadata: { surface: 'identity' },\n    },\n    {\n      id: 'event_bus_audit',\n      title: 'Emit an auditable event',\n      description: 'Emit an event that lands in the audit log.',\n      order: 2,\n      completion: {\n        eventName: 'audit_log.created',\n        sourceModule: '@contractspec/module.audit-trail',\n      },\n      xpReward: 20,\n      metadata: { surface: 'bus+audit' },\n    },\n    {\n      id: 'notifications',\n      title: 'Send a notification',\n      description: 'Send yourself a notification and verify delivery.',\n      order: 3,\n      completion: {\n        eventName: 'notification.sent',\n        sourceModule: '@contractspec/module.notifications',\n      },\n      xpReward: 20,\n      metadata: { surface: 'notifications' },\n    },\n    {\n      id: 'jobs_scheduler',\n      title: 'Schedule and run a job',\n      description: 'Schedule a background job and let it run once.',\n      order: 4,\n      completion: {\n        eventName: 'job.completed',\n        sourceModule: '@contractspec/lib.jobs',\n      },\n      xpReward: 20,\n      metadata: { surface: 'jobs' },\n    },\n    {\n      id: 'feature_flags',\n      title: 'Create and toggle a feature flag',\n      description: 'Create a feature flag and toggle it at least once.',\n      order: 5,\n      completion: {\n        eventName: 'flag.toggled',\n        sourceModule: '@contractspec/lib.feature-flags',\n      },\n      xpReward: 20,\n      metadata: { surface: 'feature-flags' },\n    },\n    {\n      id: 'files_attachments',\n      title: 'Attach a file',\n      description: 'Upload and attach a file to any entity.',\n      order: 6,\n      completion: {\n        eventName: 'attachment.attached',\n        sourceModule: '@contractspec/lib.files',\n      },\n      xpReward: 20,\n      metadata: { surface: 'files' },\n    },\n    {\n      id: 'usage_metering',\n      title: 'Record usage',\n      description: 'Emit a usage metric (regeneration, agent run, or similar).',\n      order: 7,\n      completion: {\n        eventName: 'usage.recorded',\n        sourceModule: '@contractspec/lib.metering',\n      },\n      xpReward: 20,\n      metadata: { surface: 'metering' },\n    },\n  ],\n  metadata: {\n    surfacedIn: ['studio/learning', 'platform/dev-center'],\n  },\n};\n\nexport const platformLearningTracks: LearningJourneyTrackSpec[] = [\n  platformPrimitivesTourTrack,\n];\n"],"mappings":";AAEA,MAAa,8BAAwD;CACnE,IAAI;CACJ,WAAW;CACX,MAAM;CACN,aACE;CACF,mBAAmB;CACnB,YAAY;CACZ,SAAS;CACT,mBAAmB;EAAE,SAAS;EAAI,UAAU;EAAuB;CACnE,OAAO;EACL;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,OAAO;GACP,YAAY;IACV,WAAW;IACX,cAAc;IACf;GACD,UAAU;GACV,UAAU,EAAE,SAAS,YAAY;GAClC;EACD;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,OAAO;GACP,YAAY;IACV,WAAW;IACX,cAAc;IACf;GACD,UAAU;GACV,UAAU,EAAE,SAAS,aAAa;GACnC;EACD;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,OAAO;GACP,YAAY;IACV,WAAW;IACX,cAAc;IACf;GACD,UAAU;GACV,UAAU,EAAE,SAAS,iBAAiB;GACvC;EACD;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,OAAO;GACP,YAAY;IACV,WAAW;IACX,cAAc;IACf;GACD,UAAU;GACV,UAAU,EAAE,SAAS,QAAQ;GAC9B;EACD;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,OAAO;GACP,YAAY;IACV,WAAW;IACX,cAAc;IACf;GACD,UAAU;GACV,UAAU,EAAE,SAAS,iBAAiB;GACvC;EACD;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,OAAO;GACP,YAAY;IACV,WAAW;IACX,cAAc;IACf;GACD,UAAU;GACV,UAAU,EAAE,SAAS,SAAS;GAC/B;EACD;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,OAAO;GACP,YAAY;IACV,WAAW;IACX,cAAc;IACf;GACD,UAAU;GACV,UAAU,EAAE,SAAS,YAAY;GAClC;EACF;CACD,UAAU,EACR,YAAY,CAAC,mBAAmB,sBAAsB,EACvD;CACF;AAED,MAAa,yBAAqD,CAChE,4BACD"}

package/example.ts

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

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@contractspec/example.learning-journey-platform-tour",
+  "version": "0.0.0-canary-20260113162409",
+  "description": "Learning journey track covering ContractSpec platform primitives.",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/platform-tour.docblock": "./dist/docs/platform-tour.docblock.js",
+    "./example": "./dist/example.js",
+    "./handlers/demo.handlers": "./dist/handlers/demo.handlers.js",
+    "./learning-journey-platform-tour.feature": "./dist/learning-journey-platform-tour.feature.js",
+    "./operations": "./dist/operations/index.js",
+    "./presentations": "./dist/presentations/index.js",
+    "./tests/operations.test-spec": "./dist/tests/operations.test-spec.js",
+    "./track": "./dist/track.js",
+    "./*": "./*"
+  },
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "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": {
+    "@contractspec/lib.contracts": "0.0.0-canary-20260113162409",
+    "@contractspec/lib.schema": "0.0.0-canary-20260113162409",
+    "@contractspec/module.learning-journey": "0.0.0-canary-20260113162409"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "0.0.0-canary-20260113162409",
+    "@contractspec/tool.typescript": "0.0.0-canary-20260113162409",
+    "tsdown": "^0.19.0",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "exports": {
+      ".": "./dist/index.js",
+      "./contracts": "./dist/contracts/index.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/platform-tour.docblock": "./dist/docs/platform-tour.docblock.js",
+      "./example": "./dist/example.js",
+      "./handlers/demo.handlers": "./dist/handlers/demo.handlers.js",
+      "./learning-journey-platform-tour.feature": "./dist/learning-journey-platform-tour.feature.js",
+      "./presentations": "./dist/presentations/index.js",
+      "./track": "./dist/track.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/learning-journey-platform-tour"
+  },
+  "homepage": "https://contractspec.io"
+}

package/src/docs/index.ts

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

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

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

package/src/example.ts

@@ -0,0 +1,33 @@
+import { defineExample } from '@contractspec/lib.contracts';
+
+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 },
+  },
+});
+
+export default example;

package/src/handlers/demo.handlers.ts

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

package/src/index.ts

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

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

@@ -0,0 +1,66 @@
+/**
+ * Learning Journey Platform Tour Feature Module Specification
+ *
+ * Defines the feature module for platform primitives tour journey.
+ */
+import { defineFeature } from '@contractspec/lib.contracts';
+
+/**
+ * Learning Journey Platform Tour feature module that bundles
+ * 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',
+  },
+
+  // 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: [],
+
+  // 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' },
+    },
+  ],
+
+  // 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' }],
+  },
+});

package/src/operations/index.test.ts

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

package/src/operations/index.ts

@@ -0,0 +1,122 @@
+import { ScalarTypeEnum, defineSchemaModel } from '@contractspec/lib.schema';
+import { defineCommand, defineQuery } from '@contractspec/lib.contracts';
+
+import { platformPrimitivesTourTrack } from '../track';
+
+const OWNERS = ['examples.learning-journey.platform-tour'] as const;
+
+const StepModel = defineSchemaModel({
+  name: 'PlatformTourStep',
+  description: 'Step metadata for platform primitives tour',
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    completionEvent: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
+    sourceModule: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    xpReward: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    order: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+  },
+});
+
+export const PlatformTourTrackModel = defineSchemaModel({
+  name: 'PlatformTourTrack',
+  description: 'Platform primitives tour track definition',
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    totalXp: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    completionXpBonus: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: true,
+    },
+    completionBadgeKey: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true,
+    },
+    streakHoursWindow: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: true,
+    },
+    streakBonusXp: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    steps: { type: StepModel, isArray: true, isOptional: false },
+  },
+});
+
+const TrackResponseModel = defineSchemaModel({
+  name: 'PlatformTourTrackResponse',
+  description: 'Response wrapper for platform tour track',
+  fields: {
+    track: { type: PlatformTourTrackModel, isOptional: false },
+  },
+});
+
+const RecordDemoEventInput = defineSchemaModel({
+  name: 'PlatformTourRecordEventInput',
+  description: 'Emit a demo event to advance platform tour steps',
+  fields: {
+    learnerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    eventName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    payload: { type: ScalarTypeEnum.JSON(), isOptional: true },
+    occurredAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+  },
+});
+
+const SuccessModel = defineSchemaModel({
+  name: 'PlatformTourSuccess',
+  description: 'Generic success response',
+  fields: {
+    success: { type: ScalarTypeEnum.Boolean(), isOptional: false },
+  },
+});
+
+export const GetPlatformTourTrack = defineQuery({
+  meta: {
+    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' },
+});
+
+export const platformTourContracts = {
+  GetPlatformTourTrack,
+  RecordPlatformTourEvent,
+  track: platformPrimitivesTourTrack,
+};

package/src/presentations/index.ts

@@ -0,0 +1,51 @@
+import { definePresentation, StabilityEnum, type PresentationSpecMeta } from '@contractspec/lib.contracts';
+import { PlatformTourTrackModel } from '../operations';
+
+const baseMeta: Pick<
+  PresentationSpecMeta,
+  'domain' | 'owners' | 'tags' | 'title' | 'stability' | 'goal' | 'context'
+> = {
+  domain: 'learning-journey',
+  title: 'Platform Tour',
+  owners: ['@examples.learning-journey.platform-tour'],
+  tags: ['learning', 'platform', 'tour'],
+  stability: StabilityEnum.Experimental,
+  goal: 'Visualize platform tour progress',
+  context: 'Used in platform tour dashboard and widgets',
+};
+
+export const PlatformTourTrackPresentation = definePresentation({
+  meta: {
+    key: 'learning.journey.platform.track',
+    version: '1.0.0',
+    description: 'Platform primitives tour track detail',
+    ...baseMeta,
+  },
+  source: {
+    type: 'component',
+    framework: 'react',
+    componentKey: 'LearningTrackDetail',
+    props: PlatformTourTrackModel,
+  },
+  targets: ['react', 'markdown', 'application/json'],
+});
+
+export const PlatformTourWidgetPresentation = definePresentation({
+  meta: {
+    key: 'learning.journey.platform.widget',
+    version: '1.0.0',
+    description: 'Compact widget for platform tour progress',
+    ...baseMeta,
+  },
+  source: {
+    type: 'component',
+    framework: 'react',
+    componentKey: 'LearningTrackProgressWidget',
+  },
+  targets: ['react'],
+});
+
+export const platformTourPresentations = [
+  PlatformTourTrackPresentation,
+  PlatformTourWidgetPresentation,
+];