@contractspec/example.learning-journey-platform-tour 3.7.18 → 4.0.0

package/dist/presentations/index.js

@@ -1,2 +1,2 @@
 // @bun
-var i={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"]}},_=[i];import{defineCommand as n,defineQuery as s}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as e,ScalarTypeEnum as t}from"@contractspec/lib.schema";var o=["examples.learning-journey.platform-tour"],c=e({name:"PlatformTourStep",description:"Step metadata for platform primitives tour",fields:{id:{type:t.String_unsecure(),isOptional:!1},title:{type:t.String_unsecure(),isOptional:!1},description:{type:t.String_unsecure(),isOptional:!0},completionEvent:{type:t.String_unsecure(),isOptional:!1},sourceModule:{type:t.String_unsecure(),isOptional:!0},xpReward:{type:t.Int_unsecure(),isOptional:!0},order:{type:t.Int_unsecure(),isOptional:!0}}}),a=e({name:"PlatformTourTrack",description:"Platform primitives tour track definition",fields:{id:{type:t.String_unsecure(),isOptional:!1},name:{type:t.String_unsecure(),isOptional:!1},description:{type:t.String_unsecure(),isOptional:!0},totalXp:{type:t.Int_unsecure(),isOptional:!0},completionXpBonus:{type:t.Int_unsecure(),isOptional:!0},completionBadgeKey:{type:t.String_unsecure(),isOptional:!0},streakHoursWindow:{type:t.Int_unsecure(),isOptional:!0},streakBonusXp:{type:t.Int_unsecure(),isOptional:!0},steps:{type:c,isArray:!0,isOptional:!1}}}),g=e({name:"PlatformTourTrackResponse",description:"Response wrapper for platform tour track",fields:{track:{type:a,isOptional:!1}}}),l=e({name:"PlatformTourRecordEventInput",description:"Emit a demo event to advance platform tour steps",fields:{learnerId:{type:t.String_unsecure(),isOptional:!1},eventName:{type:t.String_unsecure(),isOptional:!1},payload:{type:t.JSON(),isOptional:!0},occurredAt:{type:t.DateTime(),isOptional:!0}}}),u=e({name:"PlatformTourSuccess",description:"Generic success response",fields:{success:{type:t.Boolean(),isOptional:!1}}}),f=s({meta:{key:"learningJourney.platformTour.getTrack",version:"1.0.0",stability:"experimental",owners:[...o],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:e({name:"PlatformTourTrackInput",description:"Track input",fields:{}}),output:g},policy:{auth:"user"}}),p=n({meta:{key:"learningJourney.platformTour.recordEvent",version:"1.0.0",stability:"experimental",owners:[...o],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:l,output:u},policy:{auth:"user"}}),R={GetPlatformTourTrack:f,RecordPlatformTourEvent:p,track:i};import{definePresentation as r,StabilityEnum as m}from"@contractspec/lib.contracts-spec";var d={domain:"learning-journey",title:"Platform Tour",owners:["@examples.learning-journey.platform-tour"],tags:["learning","platform","tour"],stability:m.Experimental,goal:"Visualize platform tour progress",context:"Used in platform tour dashboard and widgets"},b=r({meta:{key:"learning.journey.platform.track",version:"1.0.0",description:"Platform primitives tour track detail",...d},source:{type:"component",framework:"react",componentKey:"LearningTrackDetail",props:a},targets:["react","markdown","application/json"]}),v=r({meta:{key:"learning.journey.platform.widget",version:"1.0.0",description:"Compact widget for platform tour progress",...d},source:{type:"component",framework:"react",componentKey:"LearningTrackProgressWidget"},targets:["react"]}),J=[b,v];export{J as platformTourPresentations,v as PlatformTourWidgetPresentation,b as PlatformTourTrackPresentation};
+var a={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:{xp: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,prerequisites:[{kind:"step_completed",stepId:"identity_rbac"}],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,prerequisites:[{kind:"step_completed",stepId:"event_bus_audit"}],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,prerequisites:[{kind:"step_completed",stepId:"notifications"}],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,prerequisites:[{kind:"step_completed",stepId:"jobs_scheduler"}],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,prerequisites:[{kind:"step_completed",stepId:"feature_flags"}],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,prerequisites:[{kind:"step_completed",stepId:"files_attachments"}],completion:{eventName:"usage.recorded",sourceModule:"@contractspec/lib.metering"},xpReward:20,metadata:{surface:"metering"}}],metadata:{surfacedIn:["studio/learning","platform/dev-center"]}},v=[a];import{defineCommand as s,defineQuery as n}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as t,ScalarTypeEnum as e}from"@contractspec/lib.schema";import{JourneyTrackModel as c}from"@contractspec/module.learning-journey/contracts/journey";var r=["examples.learning-journey.platform-tour"],i=c,p=t({name:"PlatformTourTrackResponse",description:"Response wrapper for platform tour track",fields:{track:{type:i,isOptional:!1}}}),l=t({name:"PlatformTourRecordEventInput",description:"Emit a demo event to advance platform tour steps",fields:{learnerId:{type:e.String_unsecure(),isOptional:!1},eventName:{type:e.String_unsecure(),isOptional:!1},payload:{type:e.JSON(),isOptional:!0},occurredAt:{type:e.DateTime(),isOptional:!0}}}),u=t({name:"PlatformTourSuccess",description:"Generic success response",fields:{success:{type:e.Boolean(),isOptional:!1}}}),m=n({meta:{key:"learningJourney.platformTour.getTrack",version:"1.0.0",stability:"experimental",owners:[...r],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:t({name:"PlatformTourTrackInput",description:"Track input",fields:{}}),output:p},policy:{auth:"user"}}),g=s({meta:{key:"learningJourney.platformTour.recordEvent",version:"1.0.0",stability:"experimental",owners:[...r],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:l,output:u},policy:{auth:"user"}}),q={GetPlatformTourTrack:m,RecordPlatformTourEvent:g,track:a};import{definePresentation as d,StabilityEnum as f}from"@contractspec/lib.contracts-spec";var o={domain:"learning-journey",title:"Platform Tour",owners:["@examples.learning-journey.platform-tour"],tags:["learning","platform","tour"],stability:f.Experimental,goal:"Visualize platform tour progress",context:"Used in platform tour dashboard and widgets"},_=d({meta:{key:"learning.journey.platform.track",version:"1.0.0",description:"Platform primitives tour track detail",...o},source:{type:"component",framework:"react",componentKey:"LearningTrackDetail",props:i},targets:["react","markdown","application/json"]}),b=d({meta:{key:"learning.journey.platform.widget",version:"1.0.0",description:"Compact widget for platform tour progress",...o},source:{type:"component",framework:"react",componentKey:"LearningTrackProgressWidget"},targets:["react"]}),y=[_,b];export{y as platformTourPresentations,b as PlatformTourWidgetPresentation,_ as PlatformTourTrackPresentation};

package/dist/track.d.ts

@@ -1,3 +1,3 @@
-import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';
-export declare const platformPrimitivesTourTrack: LearningJourneyTrackSpec;
-export declare const platformLearningTracks: LearningJourneyTrackSpec[];
+import type { JourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';
+export declare const platformPrimitivesTourTrack: JourneyTrackSpec;
+export declare const platformLearningTracks: JourneyTrackSpec[];

package/dist/track.js

@@ -1,2 +1,2 @@
 // @bun
-var e={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"]}},t=[e];export{e as platformPrimitivesTourTrack,t as platformLearningTracks};
+var e={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:{xp: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,prerequisites:[{kind:"step_completed",stepId:"identity_rbac"}],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,prerequisites:[{kind:"step_completed",stepId:"event_bus_audit"}],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,prerequisites:[{kind:"step_completed",stepId:"notifications"}],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,prerequisites:[{kind:"step_completed",stepId:"jobs_scheduler"}],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,prerequisites:[{kind:"step_completed",stepId:"feature_flags"}],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,prerequisites:[{kind:"step_completed",stepId:"files_attachments"}],completion:{eventName:"usage.recorded",sourceModule:"@contractspec/lib.metering"},xpReward:20,metadata:{surface:"metering"}}],metadata:{surfacedIn:["studio/learning","platform/dev-center"]}},t=[e];export{e as platformPrimitivesTourTrack,t as platformLearningTracks};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.learning-journey-platform-tour",
-  "version": "3.7.18",
+  "version": "4.0.0",
   "description": "Learning journey track covering ContractSpec platform primitives.",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -91,9 +91,9 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.contracts-spec": "5.2.0",
+    "@contractspec/lib.contracts-spec": "5.4.0",
     "@contractspec/lib.schema": "3.7.14",
-    "@contractspec/module.learning-journey": "3.7.17"
+    "@contractspec/module.learning-journey": "4.0.0"
   },
   "devDependencies": {
     "@contractspec/tool.typescript": "3.7.13",

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

@@ -29,10 +29,10 @@ 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.
+- Use adaptive journey API to surface progress:
+  - \`learning.journey.listTracks\`
+  - \`learning.journey.getProgress\`
+  - \`learning.journey.recordEvent\` wired from each module's event bus handlers.
 - Align event payloads with modules: identity-rbac, audit-trail, notifications, jobs, feature-flags, files, metering.`,
 	},
 ];

package/src/operations/index.ts

@@ -1,57 +1,17 @@
 import { defineCommand, defineQuery } from '@contractspec/lib.contracts-spec';
 import { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';
+import { JourneyTrackModel } from '@contractspec/module.learning-journey/contracts/journey';
 
 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 },
-	},
-});
+export const PlatformJourneyTrackModel = JourneyTrackModel;
 
 const TrackResponseModel = defineSchemaModel({
 	name: 'PlatformTourTrackResponse',
 	description: 'Response wrapper for platform tour track',
 	fields: {
-		track: { type: PlatformTourTrackModel, isOptional: false },
+		track: { type: PlatformJourneyTrackModel, isOptional: false },
 	},
 });
 

package/src/presentations/index.ts

@@ -3,7 +3,7 @@ import {
 	type PresentationSpecMeta,
 	StabilityEnum,
 } from '@contractspec/lib.contracts-spec';
-import { PlatformTourTrackModel } from '../operations';
+import { PlatformJourneyTrackModel } from '../operations';
 
 const baseMeta: Pick<
 	PresentationSpecMeta,
@@ -29,7 +29,7 @@ export const PlatformTourTrackPresentation = definePresentation({
 		type: 'component',
 		framework: 'react',
 		componentKey: 'LearningTrackDetail',
-		props: PlatformTourTrackModel,
+		props: PlatformJourneyTrackModel,
 	},
 	targets: ['react', 'markdown', 'application/json'],
 });

package/src/track.ts

@@ -1,6 +1,6 @@
-import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';
+import type { JourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';
 
-export const platformPrimitivesTourTrack: LearningJourneyTrackSpec = {
+export const platformPrimitivesTourTrack: JourneyTrackSpec = {
 	id: 'platform_primitives_tour',
 	productId: 'contractspec-platform',
 	name: 'Platform Primitives Tour',
@@ -9,7 +9,7 @@ export const platformPrimitivesTourTrack: LearningJourneyTrackSpec = {
 	targetUserSegment: 'platform_developer',
 	targetRole: 'developer',
 	totalXp: 140,
-	completionRewards: { xpBonus: 20, badgeKey: 'platform_primitives' },
+	completionRewards: { xp: 20, badgeKey: 'platform_primitives' },
 	steps: [
 		{
 			id: 'identity_rbac',
@@ -28,6 +28,7 @@ export const platformPrimitivesTourTrack: LearningJourneyTrackSpec = {
 			title: 'Emit an auditable event',
 			description: 'Emit an event that lands in the audit log.',
 			order: 2,
+			prerequisites: [{ kind: 'step_completed', stepId: 'identity_rbac' }],
 			completion: {
 				eventName: 'audit_log.created',
 				sourceModule: '@contractspec/module.audit-trail',
@@ -40,6 +41,7 @@ export const platformPrimitivesTourTrack: LearningJourneyTrackSpec = {
 			title: 'Send a notification',
 			description: 'Send yourself a notification and verify delivery.',
 			order: 3,
+			prerequisites: [{ kind: 'step_completed', stepId: 'event_bus_audit' }],
 			completion: {
 				eventName: 'notification.sent',
 				sourceModule: '@contractspec/module.notifications',
@@ -52,6 +54,7 @@ export const platformPrimitivesTourTrack: LearningJourneyTrackSpec = {
 			title: 'Schedule and run a job',
 			description: 'Schedule a background job and let it run once.',
 			order: 4,
+			prerequisites: [{ kind: 'step_completed', stepId: 'notifications' }],
 			completion: {
 				eventName: 'job.completed',
 				sourceModule: '@contractspec/lib.jobs',
@@ -64,6 +67,7 @@ export const platformPrimitivesTourTrack: LearningJourneyTrackSpec = {
 			title: 'Create and toggle a feature flag',
 			description: 'Create a feature flag and toggle it at least once.',
 			order: 5,
+			prerequisites: [{ kind: 'step_completed', stepId: 'jobs_scheduler' }],
 			completion: {
 				eventName: 'flag.toggled',
 				sourceModule: '@contractspec/lib.feature-flags',
@@ -76,6 +80,7 @@ export const platformPrimitivesTourTrack: LearningJourneyTrackSpec = {
 			title: 'Attach a file',
 			description: 'Upload and attach a file to any entity.',
 			order: 6,
+			prerequisites: [{ kind: 'step_completed', stepId: 'feature_flags' }],
 			completion: {
 				eventName: 'attachment.attached',
 				sourceModule: '@contractspec/lib.files',
@@ -88,6 +93,7 @@ export const platformPrimitivesTourTrack: LearningJourneyTrackSpec = {
 			title: 'Record usage',
 			description: 'Emit a usage metric (regeneration, agent run, or similar).',
 			order: 7,
+			prerequisites: [{ kind: 'step_completed', stepId: 'files_attachments' }],
 			completion: {
 				eventName: 'usage.recorded',
 				sourceModule: '@contractspec/lib.metering',
@@ -101,6 +107,6 @@ export const platformPrimitivesTourTrack: LearningJourneyTrackSpec = {
 	},
 };
 
-export const platformLearningTracks: LearningJourneyTrackSpec[] = [
+export const platformLearningTracks: JourneyTrackSpec[] = [
 	platformPrimitivesTourTrack,
 ];