@contractspec/example.learning-journey-studio-onboarding 1.57.0 → 1.59.0

package/dist/learning-journey-studio-onboarding.feature.js

@@ -1,75 +1,51 @@
+// @bun
+// src/learning-journey-studio-onboarding.feature.ts
 import { defineFeature } from "@contractspec/lib.contracts";
-
-//#region src/learning-journey-studio-onboarding.feature.ts
-/**
-* Learning Journey Studio Onboarding Feature Module Specification
-*
-* Defines the feature module for Studio onboarding journey.
-*/
-/**
-* Learning Journey Studio Onboarding feature module that bundles
-* Studio-specific onboarding track operations and presentations.
-*/
-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"
-	},
-	operations: [{
-		key: "learningJourney.studioOnboarding.recordEvent",
-		version: "1.0.0"
-	}, {
-		key: "learningJourney.studioOnboarding.getTrack",
-		version: "1.0.0"
-	}],
-	events: [],
-	presentations: [{
-		key: "learning.journey.studio.track",
-		version: "1.0.0"
-	}, {
-		key: "learning.journey.studio.widget",
-		version: "1.0.0"
-	}],
-	opToPresentation: [{
-		op: {
-			key: "learningJourney.studioOnboarding.getTrack",
-			version: "1.0.0"
-		},
-		pres: {
-			key: "learning.journey.studio.track",
-			version: "1.0.0"
-		}
-	}],
-	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"]
-	}],
-	capabilities: { requires: [{
-		key: "identity",
-		version: "1.0.0"
-	}] }
+var 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"
+  },
+  operations: [
+    { key: "learningJourney.studioOnboarding.recordEvent", version: "1.0.0" },
+    { key: "learningJourney.studioOnboarding.getTrack", version: "1.0.0" }
+  ],
+  events: [],
+  presentations: [
+    { key: "learning.journey.studio.track", version: "1.0.0" },
+    { key: "learning.journey.studio.widget", version: "1.0.0" }
+  ],
+  opToPresentation: [
+    {
+      op: {
+        key: "learningJourney.studioOnboarding.getTrack",
+        version: "1.0.0"
+      },
+      pres: { key: "learning.journey.studio.track", version: "1.0.0" }
+    }
+  ],
+  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"]
+    }
+  ],
+  capabilities: {
+    requires: [{ key: "identity", version: "1.0.0" }]
+  }
 });
-
-//#endregion
-export { LearningJourneyStudioOnboardingFeature };
-//# sourceMappingURL=learning-journey-studio-onboarding.feature.js.map
+export {
+  LearningJourneyStudioOnboardingFeature
+};

package/dist/node/docs/index.js

@@ -0,0 +1,35 @@
+// src/docs/studio-onboarding.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts";
+var studioOnboardingDocBlocks = [
+  {
+    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
+
+## Steps & Events
+1) \`choose_template\` → event \`studio.template.instantiated\`
+2) \`edit_spec\` → event \`spec.changed\` (scope: sandbox)
+3) \`regenerate_app\` → event \`regeneration.completed\`
+4) \`play_in_playground\` → event \`playground.session.started\`
+5) \`try_evolution_mode\` → event \`studio.evolution.applied\`
+
+XP: 20/20/20/20/30 with bonus 25 XP if completed within 48h (streak rule). Badge: \`studio_first_30m\`.
+
+## Wiring
+- Tracks export from \`@contractspec/example.learning-journey-studio-onboarding/track\`.
+- Use onboarding API:
+  - \`learning.onboarding.listTracks\` to surface catalog
+  - \`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/dist/node/docs/studio-onboarding.docblock.js

@@ -0,0 +1,35 @@
+// src/docs/studio-onboarding.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts";
+var studioOnboardingDocBlocks = [
+  {
+    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
+
+## Steps & Events
+1) \`choose_template\` → event \`studio.template.instantiated\`
+2) \`edit_spec\` → event \`spec.changed\` (scope: sandbox)
+3) \`regenerate_app\` → event \`regeneration.completed\`
+4) \`play_in_playground\` → event \`playground.session.started\`
+5) \`try_evolution_mode\` → event \`studio.evolution.applied\`
+
+XP: 20/20/20/20/30 with bonus 25 XP if completed within 48h (streak rule). Badge: \`studio_first_30m\`.
+
+## Wiring
+- Tracks export from \`@contractspec/example.learning-journey-studio-onboarding/track\`.
+- Use onboarding API:
+  - \`learning.onboarding.listTracks\` to surface catalog
+  - \`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/dist/node/example.js

@@ -0,0 +1,32 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var 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 }
+  }
+});
+var example_default = example;
+export {
+  example_default as default
+};

package/dist/node/handlers/demo.handlers.js

@@ -0,0 +1,107 @@
+// src/track.ts
+var studioGettingStartedTrack = {
+  id: "studio_getting_started",
+  productId: "contractspec-studio",
+  name: "Studio Getting Started",
+  description: "First 30 minutes in Studio: create a project, edit the spec, deploy/regenerate, and try key modules.",
+  targetUserSegment: "new_studio_user",
+  targetRole: "developer",
+  totalXp: 110,
+  streakRule: { hoursWindow: 48, bonusXp: 25 },
+  completionRewards: { xpBonus: 25, badgeKey: "studio_first_30m" },
+  steps: [
+    {
+      id: "choose_template",
+      title: "Choose a template",
+      description: "Create your first Studio project (starter template).",
+      order: 1,
+      completion: {
+        eventName: "studio.template.instantiated",
+        sourceModule: "@contractspec/bundle.studio"
+      },
+      xpReward: 20,
+      metadata: { surface: "projects" }
+    },
+    {
+      id: "edit_spec",
+      title: "Edit the spec",
+      description: "Change the spec (not generated code) and save.",
+      instructions: "Open spec editor, tweak a contract or presentation, save.",
+      order: 2,
+      completion: {
+        eventName: "spec.changed",
+        sourceModule: "@contractspec/bundle.studio"
+      },
+      xpReward: 20,
+      metadata: { surface: "spec-editor" }
+    },
+    {
+      id: "regenerate_app",
+      title: "Regenerate the app",
+      description: "Regenerate artifacts from the updated spec.",
+      order: 3,
+      completion: {
+        eventName: "regeneration.completed",
+        sourceModule: "@contractspec/lib.contracts/regenerator"
+      },
+      xpReward: 20,
+      metadata: { surface: "regenerator" }
+    },
+    {
+      id: "open_canvas",
+      title: "Open the canvas",
+      description: "Visit the canvas module for your project.",
+      order: 4,
+      completion: {
+        eventName: "module.navigated",
+        sourceModule: "@contractspec/bundle.studio",
+        payloadFilter: { moduleId: "canvas" }
+      },
+      xpReward: 20,
+      metadata: { surface: "canvas" }
+    },
+    {
+      id: "try_evolution_mode",
+      title: "Try evolution mode",
+      description: "Request a change via Evolution, then regenerate.",
+      order: 5,
+      completion: {
+        eventName: "studio.evolution.applied",
+        sourceModule: "@contractspec/lib.evolution"
+      },
+      xpReward: 30,
+      metadata: { surface: "evolution" }
+    }
+  ],
+  metadata: {
+    persona: "first_run",
+    surfacedIn: ["studio/home", "studio/sidebar/learning"]
+  }
+};
+var studioLearningTracks = [
+  studioGettingStartedTrack
+];
+
+// src/handlers/demo.handlers.ts
+var studioOnboardingEvents = [
+  "studio.template.instantiated",
+  "spec.changed",
+  "regeneration.completed",
+  "playground.session.started",
+  "studio.evolution.applied"
+];
+var emitStudioOnboardingEvent = (eventName, { learnerId, occurredAt = new Date }, record) => {
+  const event = {
+    learnerId,
+    name: eventName,
+    occurredAt,
+    trackId: studioGettingStartedTrack.id
+  };
+  return record ? record(event) : event;
+};
+var emitAllStudioOnboardingEvents = (params, record) => studioOnboardingEvents.map((name) => emitStudioOnboardingEvent(name, params, record));
+export {
+  studioOnboardingEvents,
+  emitStudioOnboardingEvent,
+  emitAllStudioOnboardingEvents
+};