@lssm/example.learning-journey-registry 0.0.0-canary-20251217060834 → 0.0.0-canary-20251217073102

package/.turbo/turbo-build.log

@@ -1,65 +1,55 @@
-$ bun build:bundle && bun build:types
-$ tsdown
-ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
-ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-journey-registry/tsdown.config.js 
-ℹ entry: src/api-types.ts, src/api.ts, src/example.ts, src/index.ts, src/learning-journey-registry.feature.ts, src/progress-store.ts, src/tracks.ts, src/docs/index.ts, src/docs/learning-journey-registry.docblock.ts, src/presentations/index.ts, src/ui/LearningMiniApp.tsx, src/ui/index.ts
-ℹ target: esnext
-ℹ tsconfig: tsconfig.json
-ℹ Build start
-ℹ dist/api.js                                                                     3.28 kB │ gzip: 1.37 kB
-ℹ dist/ui/LearningMiniApp.js                                                      1.88 kB │ gzip: 0.70 kB
-ℹ dist/tracks.js                                                                  1.30 kB │ gzip: 0.50 kB
-ℹ dist/index.js                                                                   1.23 kB │ gzip: 0.42 kB
-ℹ dist/docs/learning-journey-registry.docblock.js                                 1.20 kB │ gzip: 0.62 kB
-ℹ dist/presentations/index.js                                                     0.99 kB │ gzip: 0.39 kB
-ℹ dist/learning-journey-registry.feature.js                                       0.86 kB │ gzip: 0.36 kB
-ℹ dist/example.js                                                                 0.52 kB │ gzip: 0.32 kB
-ℹ dist/progress-store.js                                                          0.43 kB │ gzip: 0.29 kB
-ℹ dist/ui/index.js                                                                0.19 kB │ gzip: 0.11 kB
-ℹ dist/docs/index.js                                                              0.05 kB │ gzip: 0.07 kB
-ℹ dist/api-types.js                                                               0.00 kB │ gzip: 0.02 kB
-ℹ dist/libs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js  16.51 kB │ gzip: 7.15 kB
-ℹ dist/libs/contracts/dist/docs/tech/schema/README.docblock.js                   10.97 kB │ gzip: 4.28 kB
-ℹ dist/libs/contracts/dist/docs/tech/lifecycle-stage-system.docblock.js           9.65 kB │ gzip: 3.77 kB
-ℹ dist/libs/contracts/dist/docs/tech/llm/llm-integration.docblock.js              9.10 kB │ gzip: 3.41 kB
-ℹ dist/libs/contracts/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js               8.74 kB │ gzip: 2.67 kB
-ℹ dist/libs/contracts/dist/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js           5.91 kB │ gzip: 2.61 kB
-ℹ dist/libs/contracts/dist/docs/tech/templates/runtime.docblock.js                5.62 kB │ gzip: 2.58 kB
-ℹ dist/libs/contracts/dist/docs/tech/workflows/overview.docblock.js               5.42 kB │ gzip: 2.25 kB
-ℹ dist/libs/contracts/dist/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js    4.35 kB │ gzip: 2.05 kB
-ℹ dist/libs/contracts/dist/docs/tech/telemetry-ingest.docblock.js                 3.89 kB │ gzip: 1.69 kB
-ℹ dist/libs/contracts/dist/docs/tech/vscode-extension.docblock.js                 3.58 kB │ gzip: 1.38 kB
-ℹ dist/libs/contracts/dist/docs/PUBLISHING.docblock.js                            3.42 kB │ gzip: 1.58 kB
-ℹ dist/libs/contracts/dist/docs/tech/auth/better-auth-nextjs.docblock.js          3.34 kB │ gzip: 1.45 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/learning-journeys.docblock.js         3.07 kB │ gzip: 1.38 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/platform-admin-panel.docblock.js      3.03 kB │ gzip: 1.32 kB
-ℹ dist/libs/contracts/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js     2.98 kB │ gzip: 1.52 kB
-ℹ dist/libs/contracts/dist/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js   2.81 kB │ gzip: 1.41 kB
-ℹ dist/libs/contracts/dist/docs/tech/presentation-runtime.docblock.js             2.73 kB │ gzip: 1.30 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/project-routing.docblock.js           2.49 kB │ gzip: 1.11 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/team-invitations.docblock.js          2.13 kB │ gzip: 1.03 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/workspaces.docblock.js                1.89 kB │ gzip: 0.93 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/learning-events.docblock.js           1.78 kB │ gzip: 0.87 kB
-ℹ dist/libs/contracts/dist/docs/tech/contracts/openapi-export.docblock.js         1.70 kB │ gzip: 0.89 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/project-access-teams.docblock.js      1.57 kB │ gzip: 0.77 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/workspace-ops.docblock.js             1.47 kB │ gzip: 0.73 kB
-ℹ dist/libs/contracts/dist/docs/index.js                                          1.42 kB │ gzip: 0.47 kB
-ℹ dist/libs/contracts/dist/docs/tech/mcp-endpoints.docblock.js                    1.23 kB │ gzip: 0.68 kB
-ℹ dist/libs/contracts/dist/docs/presentations.js                                  1.14 kB │ gzip: 0.56 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/sandbox-unlogged.docblock.js          0.89 kB │ gzip: 0.55 kB
-ℹ dist/libs/contracts/dist/docs/registry.js                                       0.63 kB │ gzip: 0.39 kB
-ℹ dist/tracks.d.ts                                                                1.69 kB │ gzip: 0.55 kB
-ℹ dist/index.d.ts                                                                 1.17 kB │ gzip: 0.34 kB
-ℹ dist/ui/LearningMiniApp.d.ts                                                    1.15 kB │ gzip: 0.50 kB
-ℹ dist/api-types.d.ts                                                             1.03 kB │ gzip: 0.46 kB
-ℹ dist/example.d.ts                                                               0.96 kB │ gzip: 0.39 kB
-ℹ dist/progress-store.d.ts                                                        0.64 kB │ gzip: 0.29 kB
-ℹ dist/presentations/index.d.ts                                                   0.56 kB │ gzip: 0.21 kB
-ℹ dist/api.d.ts                                                                   0.52 kB │ gzip: 0.27 kB
-ℹ dist/learning-journey-registry.feature.d.ts                                     0.35 kB │ gzip: 0.22 kB
-ℹ dist/ui/index.d.ts                                                              0.17 kB │ gzip: 0.09 kB
-ℹ dist/docs/index.d.ts                                                            0.01 kB │ gzip: 0.03 kB
-ℹ dist/docs/learning-journey-registry.docblock.d.ts                               0.01 kB │ gzip: 0.03 kB
-ℹ 54 files, total: 143.63 kB
-✔ Build complete in 8907ms
-$ tsc --noEmit
+
+$ bun build:bundle && bun build:types
+$ tsdown
+ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
+ℹ config file: /Users/tboutron/Documents/clients/lssm/monorepo-lssm/packages/contractspec/packages/examples/learning-journey-registry/tsdown.config.js (unrun)
+ℹ entry: src/api-types.ts, src/api.ts, src/example.ts, src/index.ts, src/learning-journey-registry.feature.ts, src/progress-store.ts, src/tracks.ts, src/docs/index.ts, src/docs/learning-journey-registry.docblock.ts, src/presentations/index.ts, src/ui/LearningMiniApp.tsx, src/ui/index.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 57 files
+ℹ dist/api.js                                                                    3.28 kB │ gzip: 1.37 kB
+ℹ dist/ui/LearningMiniApp.js                                                     1.88 kB │ gzip: 0.70 kB
+ℹ dist/tracks.js                                                                 1.30 kB │ gzip: 0.50 kB
+ℹ dist/index.js                                                                  1.23 kB │ gzip: 0.42 kB
+ℹ dist/docs/learning-journey-registry.docblock.js                                1.21 kB │ gzip: 0.63 kB
+ℹ dist/presentations/index.js                                                    0.99 kB │ gzip: 0.39 kB
+ℹ dist/learning-journey-registry.feature.js                                      0.86 kB │ gzip: 0.36 kB
+ℹ dist/example.js                                                                0.52 kB │ gzip: 0.32 kB
+ℹ dist/progress-store.js                                                         0.43 kB │ gzip: 0.29 kB
+ℹ dist/ui/index.js                                                               0.19 kB │ gzip: 0.11 kB
+ℹ dist/docs/index.js                                                             0.05 kB │ gzip: 0.07 kB
+ℹ dist/api-types.js                                                              0.00 kB │ gzip: 0.02 kB
+ℹ dist/libs/contracts/src/docs/accessibility_wcag_compliance_specs.docblock.js  16.53 kB │ gzip: 7.16 kB
+ℹ dist/libs/contracts/src/docs/tech/schema/README.docblock.js                   10.99 kB │ gzip: 4.29 kB
+ℹ dist/libs/contracts/src/docs/tech/lifecycle-stage-system.docblock.js           9.67 kB │ gzip: 3.78 kB
+ℹ dist/libs/contracts/src/docs/tech/llm/llm-integration.docblock.js              9.12 kB │ gzip: 3.42 kB
+ℹ dist/libs/contracts/src/docs/tech/PHASE_1_QUICKSTART.docblock.js               8.76 kB │ gzip: 2.68 kB
+ℹ dist/libs/contracts/src/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js           5.93 kB │ gzip: 2.61 kB
+ℹ dist/libs/contracts/src/docs/tech/templates/runtime.docblock.js                5.63 kB │ gzip: 2.58 kB
+ℹ dist/libs/contracts/src/docs/tech/workflows/overview.docblock.js               5.44 kB │ gzip: 2.26 kB
+ℹ dist/libs/contracts/src/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js    4.37 kB │ gzip: 2.06 kB
+ℹ dist/libs/contracts/src/docs/tech/telemetry-ingest.docblock.js                 3.90 kB │ gzip: 1.70 kB
+ℹ dist/libs/contracts/src/docs/tech/vscode-extension.docblock.js                 3.60 kB │ gzip: 1.39 kB
+ℹ dist/libs/contracts/src/docs/PUBLISHING.docblock.js                            3.43 kB │ gzip: 1.59 kB
+ℹ dist/libs/contracts/src/docs/tech/auth/better-auth-nextjs.docblock.js          3.35 kB │ gzip: 1.45 kB
+ℹ dist/libs/contracts/src/docs/tech/studio/learning-journeys.docblock.js         3.08 kB │ gzip: 1.39 kB
+ℹ dist/libs/contracts/src/docs/tech/studio/platform-admin-panel.docblock.js      3.04 kB │ gzip: 1.33 kB
+ℹ dist/libs/contracts/src/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js     3.00 kB │ gzip: 1.53 kB
+ℹ dist/libs/contracts/src/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js   2.83 kB │ gzip: 1.41 kB
+ℹ dist/libs/contracts/src/docs/tech/presentation-runtime.docblock.js             2.75 kB │ gzip: 1.30 kB
+ℹ dist/libs/contracts/src/docs/tech/studio/project-routing.docblock.js           2.50 kB │ gzip: 1.12 kB
+ℹ dist/libs/contracts/src/docs/tech/studio/team-invitations.docblock.js          2.14 kB │ gzip: 1.04 kB
+ℹ dist/libs/contracts/src/docs/tech/studio/workspaces.docblock.js                1.90 kB │ gzip: 0.94 kB
+ℹ dist/libs/contracts/src/docs/tech/studio/learning-events.docblock.js           1.79 kB │ gzip: 0.88 kB
+ℹ dist/libs/contracts/src/docs/tech/contracts/openapi-export.docblock.js         1.72 kB │ gzip: 0.90 kB
+ℹ dist/libs/contracts/src/docs/tech/studio/project-access-teams.docblock.js      1.58 kB │ gzip: 0.78 kB
+ℹ dist/libs/contracts/src/docs/index.js                                          1.54 kB │ gzip: 0.52 kB
+ℹ dist/libs/contracts/src/docs/tech/studio/workspace-ops.docblock.js             1.49 kB │ gzip: 0.73 kB
+ℹ dist/libs/contracts/src/docs/tech/mcp-endpoints.docblock.js                    1.24 kB │ gzip: 0.68 kB
+ℹ dist/libs/contracts/src/docs/presentations.js                                  1.23 kB │ gzip: 0.59 kB
+ℹ dist/libs/contracts/src/docs/tech/studio/sandbox-unlogged.docblock.js          0.90 kB │ gzip: 0.56 kB
+ℹ dist/libs/contracts/src/docs/registry.js                                       0.74 kB │ gzip: 0.42 kB
+ℹ 42 files, total: 136.15 kB
+✔ Build complete in 29ms
+$ tsc --noEmit

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # @lssm/example.learning-journey-registry
 
-## 0.0.0-canary-20251217060834
+## 0.0.0-canary-20251217073102
 
 ### Minor Changes
 
@@ -9,14 +9,16 @@
 ### Patch Changes
 
 - Updated dependencies [66a5dfd]
-  - @lssm/example.learning-journey-ambient-coach@0.0.0-canary-20251217060834
-  - @lssm/example.learning-journey-crm-onboarding@0.0.0-canary-20251217060834
-  - @lssm/example.learning-journey-duo-drills@0.0.0-canary-20251217060834
-  - @lssm/example.learning-journey-platform-tour@0.0.0-canary-20251217060834
-  - @lssm/example.learning-journey-quest-challenges@0.0.0-canary-20251217060834
-  - @lssm/example.learning-journey-studio-onboarding@0.0.0-canary-20251217060834
-  - @lssm/example.learning-journey-ui-coaching@0.0.0-canary-20251217060834
-  - @lssm/example.learning-journey-ui-gamified@0.0.0-canary-20251217060834
-  - @lssm/example.learning-journey-ui-onboarding@0.0.0-canary-20251217060834
-  - @lssm/example.learning-journey-ui-shared@0.0.0-canary-20251217060834
-  - @lssm/module.learning-journey@0.0.0-canary-20251217060834
+  - @lssm/example.learning-journey-ambient-coach@0.0.0-canary-20251217073102
+  - @lssm/example.learning-journey-crm-onboarding@0.0.0-canary-20251217073102
+  - @lssm/example.learning-journey-duo-drills@0.0.0-canary-20251217073102
+  - @lssm/example.learning-journey-platform-tour@0.0.0-canary-20251217073102
+  - @lssm/example.learning-journey-quest-challenges@0.0.0-canary-20251217073102
+  - @lssm/example.learning-journey-studio-onboarding@0.0.0-canary-20251217073102
+  - @lssm/example.learning-journey-ui-coaching@0.0.0-canary-20251217073102
+  - @lssm/example.learning-journey-ui-gamified@0.0.0-canary-20251217073102
+  - @lssm/example.learning-journey-ui-onboarding@0.0.0-canary-20251217073102
+  - @lssm/example.learning-journey-ui-shared@0.0.0-canary-20251217073102
+  - @lssm/lib.contracts@0.0.0-canary-20251217073102
+  - @lssm/lib.schema@0.0.0-canary-20251217073102
+  - @lssm/module.learning-journey@0.0.0-canary-20251217073102

package/dist/api.js

@@ -1 +1,170 @@
-import{learningJourneyTracks as e}from"./tracks.js";import{getLearnerTracks as t,getTrackResolver as n,initProgress as r}from"./progress-store.js";const i=n(e),a=(e,t)=>e?t?Object.entries(e).every(([e,n])=>t[e]===n):!1:!0,o=(e,t)=>e.eventName!==t.name||e.eventVersion!==void 0&&t.version!==void 0&&e.eventVersion!==t.version||e.sourceModule&&t.sourceModule&&e.sourceModule!==t.sourceModule?!1:a(e.payloadFilter,t.payload),s=(e,t,n,r)=>{if(e.kind===`count`){if(!o(e,t))return{matched:!1};let i=(n.occurrences??0)+1;return{matched:(e.withinHours===void 0||!!(r&&t.occurredAt&&(t.occurredAt.getTime()-r.getTime())/(1e3*60*60)<=e.withinHours))&&i>=e.atLeast,occurrences:i}}if(e.kind===`time_window`)return!o(e,t)||e.withinHoursOfStart!==void 0&&r&&t.occurredAt&&(t.occurredAt.getTime()-r.getTime())/(1e3*60*60)>e.withinHoursOfStart?{matched:!1}:{matched:!0};if(e.kind===`srs_mastery`){if(t.name!==e.eventName)return{matched:!1};let r=t.payload;if(!a(e.payloadFilter,r))return{matched:!1};let i=e.skillIdField??`skillId`,o=e.masteryField??`mastery`,s=r?.[i],c=r?.[o];if(s===void 0||c===void 0||typeof c!=`number`||c<e.minimumMastery)return{matched:!1};let l=(n.masteryCount??0)+1;return{matched:l>=(e.requiredCount??1),masteryCount:l}}return{matched:o(e,t)}},c=(e,t)=>{if(!e||!t)return{};let n=t.getTime(),r=n;e.unlockOnDay!==void 0&&(r=n+(e.unlockOnDay-1)*24*60*60*1e3),e.unlockAfterHours!==void 0&&(r=n+e.unlockAfterHours*60*60*1e3);let i=new Date(r);return{availableAt:i,dueAt:e.dueWithinHours===void 0?void 0:new Date(i.getTime()+e.dueWithinHours*60*60*1e3)}},l=e=>{let t=e.length||1,n=e.filter(e=>e.status===`COMPLETED`).length;return Math.round(n/t*100)},u=(e,t)=>{if(t.isCompleted)return t;let n=new Date,r=t.startedAt??n,i=(n.getTime()-r.getTime())/(1e3*60*60),a=t.xpEarned,{completionRewards:o,streakRule:s}=e;return o?.xpBonus&&(a+=o.xpBonus),s?.hoursWindow!==void 0&&i<=s.hoursWindow&&s.bonusXp&&(a+=s.bonusXp),{...t,xpEarned:a,isCompleted:!0,completedAt:n,lastActivityAt:n}},d=n=>{let r=n?t(n):void 0;return{tracks:e,progress:n&&r?Array.from(r.values()):[]}},f=(e,n)=>{let a=i(e);if(!a)return;let o=t(n),s=o.get(e)??r(n,a);return o.set(e,s),s},p=n=>{let i=n.trackId===void 0?e:e.filter(e=>e.id===n.trackId),a=[],o=n.occurredAt??new Date;for(let e of i){let i=t(n.learnerId),d=i.get(e.id)??r(n.learnerId,e),f=d.startedAt??o,p=d.startedAt===void 0,m=d.steps.map(t=>{if(t.status===`COMPLETED`)return t;let r=e.steps.find(e=>e.id===t.id);if(!r)return t;let{availableAt:i,dueAt:a}=c(r.availability,f);if(i&&o<i||a&&o>a)return{...t,availableAt:i,dueAt:a};let l=s(r.completion,n,t,f);return l.matched?(p=!0,{...t,status:`COMPLETED`,xpEarned:r.xpReward??0,completedAt:o,triggeringEvent:n.name,eventPayload:n.payload,occurrences:l.occurrences??t.occurrences,masteryCount:l.masteryCount??t.masteryCount,availableAt:i,dueAt:a}):((l.occurrences!==void 0||l.masteryCount!==void 0)&&(p=!0),{...t,occurrences:l.occurrences??t.occurrences,masteryCount:l.masteryCount??t.masteryCount,availableAt:i,dueAt:a})});if(!p)continue;let h=m.reduce((e,t)=>e+t.xpEarned,0)+(e.totalXp??0),g={...d,steps:m,xpEarned:h,startedAt:f,lastActivityAt:o,progress:l(m)};m.every(e=>e.status===`COMPLETED`)&&(g=u(e,g)),i.set(e.id,g),a.push(g)}return a};export{f as getProgress,d as listTracks,p as recordEvent};
+import { learningJourneyTracks } from "./tracks.js";
+import { getLearnerTracks, getTrackResolver, initProgress } from "./progress-store.js";
+
+//#region src/api.ts
+const getTrack = getTrackResolver(learningJourneyTracks);
+const matchesFilter = (filter, payload) => {
+	if (!filter) return true;
+	if (!payload) return false;
+	return Object.entries(filter).every(([key, value]) => payload[key] === value);
+};
+const matchesBaseEvent = (condition, event) => {
+	if (condition.eventName !== event.name) return false;
+	if (condition.eventVersion !== void 0 && event.version !== void 0) {
+		if (condition.eventVersion !== event.version) return false;
+	}
+	if (condition.sourceModule && event.sourceModule && condition.sourceModule !== event.sourceModule) return false;
+	return matchesFilter(condition.payloadFilter, event.payload);
+};
+const matchesCondition = (condition, event, step, trackStartedAt) => {
+	if (condition.kind === "count") {
+		if (!matchesBaseEvent(condition, event)) return { matched: false };
+		const occurrences = (step.occurrences ?? 0) + 1;
+		return {
+			matched: (condition.withinHours === void 0 || Boolean(trackStartedAt && event.occurredAt && (event.occurredAt.getTime() - trackStartedAt.getTime()) / (1e3 * 60 * 60) <= condition.withinHours)) && occurrences >= condition.atLeast,
+			occurrences
+		};
+	}
+	if (condition.kind === "time_window") {
+		if (!matchesBaseEvent(condition, event)) return { matched: false };
+		if (condition.withinHoursOfStart !== void 0 && trackStartedAt && event.occurredAt) {
+			if ((event.occurredAt.getTime() - trackStartedAt.getTime()) / (1e3 * 60 * 60) > condition.withinHoursOfStart) return { matched: false };
+		}
+		return { matched: true };
+	}
+	if (condition.kind === "srs_mastery") {
+		if (event.name !== condition.eventName) return { matched: false };
+		const payload = event.payload;
+		if (!matchesFilter(condition.payloadFilter, payload)) return { matched: false };
+		const skillKey = condition.skillIdField ?? "skillId";
+		const masteryKey = condition.masteryField ?? "mastery";
+		const skillId = payload?.[skillKey];
+		const masteryValue = payload?.[masteryKey];
+		if (skillId === void 0 || masteryValue === void 0) return { matched: false };
+		if (typeof masteryValue !== "number") return { matched: false };
+		if (masteryValue < condition.minimumMastery) return { matched: false };
+		const masteryCount = (step.masteryCount ?? 0) + 1;
+		return {
+			matched: masteryCount >= (condition.requiredCount ?? 1),
+			masteryCount
+		};
+	}
+	return { matched: matchesBaseEvent(condition, event) };
+};
+const getAvailability = (availability, startedAt) => {
+	if (!availability || !startedAt) return {};
+	const baseTime = startedAt.getTime();
+	let unlockTime = baseTime;
+	if (availability.unlockOnDay !== void 0) unlockTime = baseTime + (availability.unlockOnDay - 1) * 24 * 60 * 60 * 1e3;
+	if (availability.unlockAfterHours !== void 0) unlockTime = baseTime + availability.unlockAfterHours * 60 * 60 * 1e3;
+	const availableAt = new Date(unlockTime);
+	return {
+		availableAt,
+		dueAt: availability.dueWithinHours !== void 0 ? new Date(availableAt.getTime() + availability.dueWithinHours * 60 * 60 * 1e3) : void 0
+	};
+};
+const computeProgressPercent = (steps) => {
+	const total = steps.length || 1;
+	const done = steps.filter((s) => s.status === "COMPLETED").length;
+	return Math.round(done / total * 100);
+};
+const applyTrackCompletionBonuses = (track, progress) => {
+	if (progress.isCompleted) return progress;
+	const completedAt = /* @__PURE__ */ new Date();
+	const startedAt = progress.startedAt ?? completedAt;
+	const hoursElapsed = (completedAt.getTime() - startedAt.getTime()) / (1e3 * 60 * 60);
+	let xpEarned = progress.xpEarned;
+	const { completionRewards, streakRule } = track;
+	if (completionRewards?.xpBonus) xpEarned += completionRewards.xpBonus;
+	if (streakRule?.hoursWindow !== void 0 && hoursElapsed <= streakRule.hoursWindow && streakRule.bonusXp) xpEarned += streakRule.bonusXp;
+	return {
+		...progress,
+		xpEarned,
+		isCompleted: true,
+		completedAt,
+		lastActivityAt: completedAt
+	};
+};
+const listTracks = (learnerId) => {
+	const progressMap = learnerId ? getLearnerTracks(learnerId) : void 0;
+	return {
+		tracks: learningJourneyTracks,
+		progress: learnerId && progressMap ? Array.from(progressMap.values()) : []
+	};
+};
+const getProgress = (trackId, learnerId) => {
+	const track = getTrack(trackId);
+	if (!track) return void 0;
+	const map = getLearnerTracks(learnerId);
+	const existing = map.get(trackId) ?? initProgress(learnerId, track);
+	map.set(trackId, existing);
+	return existing;
+};
+const recordEvent = (event) => {
+	const targets = event.trackId !== void 0 ? learningJourneyTracks.filter((t) => t.id === event.trackId) : learningJourneyTracks;
+	const updated = [];
+	const eventTime = event.occurredAt ?? /* @__PURE__ */ new Date();
+	for (const track of targets) {
+		const map = getLearnerTracks(event.learnerId);
+		const current = map.get(track.id) ?? initProgress(event.learnerId, track);
+		const startedAt = current.startedAt ?? eventTime;
+		let changed = current.startedAt === void 0;
+		const steps = current.steps.map((step) => {
+			if (step.status === "COMPLETED") return step;
+			const spec = track.steps.find((s) => s.id === step.id);
+			if (!spec) return step;
+			const { availableAt, dueAt } = getAvailability(spec.availability, startedAt);
+			if (availableAt && eventTime < availableAt) return {
+				...step,
+				availableAt,
+				dueAt
+			};
+			if (dueAt && eventTime > dueAt) return {
+				...step,
+				availableAt,
+				dueAt
+			};
+			const result = matchesCondition(spec.completion, event, step, startedAt);
+			if (result.matched) {
+				changed = true;
+				return {
+					...step,
+					status: "COMPLETED",
+					xpEarned: spec.xpReward ?? 0,
+					completedAt: eventTime,
+					triggeringEvent: event.name,
+					eventPayload: event.payload,
+					occurrences: result.occurrences ?? step.occurrences,
+					masteryCount: result.masteryCount ?? step.masteryCount,
+					availableAt,
+					dueAt
+				};
+			}
+			if (result.occurrences !== void 0 || result.masteryCount !== void 0) changed = true;
+			return {
+				...step,
+				occurrences: result.occurrences ?? step.occurrences,
+				masteryCount: result.masteryCount ?? step.masteryCount,
+				availableAt,
+				dueAt
+			};
+		});
+		if (!changed) continue;
+		const xpEarned = steps.reduce((sum, s) => sum + s.xpEarned, 0) + (track.totalXp ?? 0);
+		let progress = {
+			...current,
+			steps,
+			xpEarned,
+			startedAt,
+			lastActivityAt: eventTime,
+			progress: computeProgressPercent(steps)
+		};
+		if (steps.every((s) => s.status === "COMPLETED")) progress = applyTrackCompletionBonuses(track, progress);
+		map.set(track.id, progress);
+		updated.push(progress);
+	}
+	return updated;
+};
+
+//#endregion
+export { getProgress, listTracks, recordEvent };

package/dist/docs/index.js

@@ -1 +1 @@
-import"./learning-journey-registry.docblock.js";
+import "./learning-journey-registry.docblock.js";

package/dist/docs/learning-journey-registry.docblock.js

@@ -1 +1,38 @@
-import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contracts/dist/docs/index.js";e([{id:`docs.learning-journey.registry`,title:`Learning Journey — Example Track Registry`,summary:`Aggregates learning journey example tracks (Studio onboarding, Platform tour, CRM first win, Drills, Ambient Coach, Quest challenges).`,kind:`usage`,visibility:`public`,route:`/docs/learning-journey/registry`,tags:[`learning`,`registry`,`onboarding`],body:"## Tracks\n- `studio_getting_started` (Studio onboarding)\n- `platform_primitives_tour` (Platform primitives)\n- `crm_first_win` (CRM pipeline onboarding)\n- `drills_language_basics` (Drills & SRS)\n- `money_ambient_coach`, `coliving_ambient_coach` (Ambient tips)\n- `money_reset_7day` (Quest/challenge)\n\n## Exports\n- `learningJourneyTracks` — raw specs\n- `onboardingTrackCatalog` — DTOs aligned with onboarding API\n- `mapTrackSpecToDto` — helper to map individual tracks\n\n## Wiring\n- Use with onboarding API contracts:\n  - `learning.onboarding.listTracks`\n  - `learning.onboarding.getProgress`\n  - `learning.onboarding.recordEvent`\n- Intended for registry/adapters in Studio UI or services that surface tracks."}]);
+import { registerDocBlocks } from "../libs/contracts/dist/docs/registry.js";
+import "../libs/contracts/dist/docs/index.js";
+
+//#region src/docs/learning-journey-registry.docblock.ts
+registerDocBlocks([{
+	id: "docs.learning-journey.registry",
+	title: "Learning Journey — Example Track Registry",
+	summary: "Aggregates learning journey example tracks (Studio onboarding, Platform tour, CRM first win, Drills, Ambient Coach, Quest challenges).",
+	kind: "usage",
+	visibility: "public",
+	route: "/docs/learning-journey/registry",
+	tags: [
+		"learning",
+		"registry",
+		"onboarding"
+	],
+	body: `## Tracks
+- \`studio_getting_started\` (Studio onboarding)
+- \`platform_primitives_tour\` (Platform primitives)
+- \`crm_first_win\` (CRM pipeline onboarding)
+- \`drills_language_basics\` (Drills & SRS)
+- \`money_ambient_coach\`, \`coliving_ambient_coach\` (Ambient tips)
+- \`money_reset_7day\` (Quest/challenge)
+
+## Exports
+- \`learningJourneyTracks\` — raw specs
+- \`onboardingTrackCatalog\` — DTOs aligned with onboarding API
+- \`mapTrackSpecToDto\` — helper to map individual tracks
+
+## Wiring
+- Use with onboarding API contracts:
+  - \`learning.onboarding.listTracks\`
+  - \`learning.onboarding.getProgress\`
+  - \`learning.onboarding.recordEvent\`
+- Intended for registry/adapters in Studio UI or services that surface tracks.`
+}]);
+
+//#endregion

package/dist/example.js

@@ -1 +1,34 @@
-var e={id:`learning-journey-registry`,title:`Learning Journey Registry`,summary:`Registry of learning journey tracks + presentations + UI mini-app bindings.`,tags:[`learning`,`journey`,`registry`],kind:`library`,visibility:`public`,docs:{rootDocId:`docs.examples.learning-journey-registry`},entrypoints:{packageName:`@lssm/example.learning-journey-registry`,docs:`./docs`},surfaces:{templates:!0,sandbox:{enabled:!0,modes:[`markdown`,`specs`]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}};export{e as default};
+//#region src/example.ts
+const example = {
+	id: "learning-journey-registry",
+	title: "Learning Journey Registry",
+	summary: "Registry of learning journey tracks + presentations + UI mini-app bindings.",
+	tags: [
+		"learning",
+		"journey",
+		"registry"
+	],
+	kind: "library",
+	visibility: "public",
+	docs: { rootDocId: "docs.examples.learning-journey-registry" },
+	entrypoints: {
+		packageName: "@lssm/example.learning-journey-registry",
+		docs: "./docs"
+	},
+	surfaces: {
+		templates: true,
+		sandbox: {
+			enabled: true,
+			modes: ["markdown", "specs"]
+		},
+		studio: {
+			enabled: true,
+			installable: true
+		},
+		mcp: { enabled: true }
+	}
+};
+var example_default = example;
+
+//#endregion
+export { example_default as default };

package/dist/examples/learning-journey-ambient-coach/src/track.js

@@ -0,0 +1,41 @@
+//#region ../learning-journey-ambient-coach/src/track.ts
+const makeTipStep = (id, tipId, description) => ({
+	id,
+	title: `Resolve tip: ${tipId}`,
+	description,
+	completion: {
+		kind: "event",
+		eventName: "coach.tip.follow_up_action_taken",
+		payloadFilter: { tipId }
+	},
+	xpReward: 20,
+	metadata: { tipId }
+});
+const moneyAmbientCoachTrack = {
+	id: "money_ambient_coach",
+	name: "Ambient Coach — Money",
+	description: "Subtle coaching for money patterns (cash buffer, goals, saving rhythm).",
+	targetUserSegment: "money_user",
+	totalXp: 60,
+	steps: [
+		makeTipStep("cash_buffer_too_high", "cash_buffer_too_high", "Suggest sweeping excess cash into goals."),
+		makeTipStep("no_savings_goal", "no_savings_goal", "Prompt setting a first savings goal."),
+		makeTipStep("irregular_savings", "irregular_savings", "Recommend recurring saves after irregular deposits.")
+	]
+};
+const colivingAmbientCoachTrack = {
+	id: "coliving_ambient_coach",
+	name: "Ambient Coach — Coliving",
+	description: "Contextual tips for healthy coliving habits.",
+	targetUserSegment: "coliving",
+	totalXp: 60,
+	steps: [
+		makeTipStep("noise_late_evening", "noise_late_evening", "Suggest updating quiet hours to reduce evening noise."),
+		makeTipStep("guest_frequency_high", "guest_frequency_high", "Set guest frequency expectations for the house."),
+		makeTipStep("shared_space_conflicts", "shared_space_conflicts", "Offer a shared-space checklist to reduce conflicts.")
+	]
+};
+const ambientCoachTracks = [moneyAmbientCoachTrack, colivingAmbientCoachTrack];
+
+//#endregion
+export { ambientCoachTracks };

package/dist/examples/learning-journey-crm-onboarding/dist/track.js

@@ -0,0 +1,98 @@
+//#region ../learning-journey-crm-onboarding/dist/track.js
+const crmFirstWinTrack = {
+	id: "crm_first_win",
+	productId: "crm-pipeline",
+	name: "CRM First Win",
+	description: "Guide a new CRM user from empty pipeline to first closed-won deal.",
+	targetUserSegment: "crm_adopter",
+	targetRole: "sales",
+	totalXp: 135,
+	streakRule: {
+		hoursWindow: 72,
+		bonusXp: 25
+	},
+	completionRewards: {
+		xpBonus: 25,
+		badgeKey: "crm_first_win"
+	},
+	steps: [
+		{
+			id: "create_pipeline",
+			title: "Create pipeline & stages",
+			description: "Create a pipeline with baseline stages.",
+			order: 1,
+			completion: {
+				eventName: "pipeline.created",
+				sourceModule: "@lssm/example.crm-pipeline"
+			},
+			xpReward: 15,
+			metadata: { surface: "pipeline" }
+		},
+		{
+			id: "create_contact_and_company",
+			title: "Create contact and company",
+			description: "Add your first contact and associated company.",
+			order: 2,
+			completion: {
+				eventName: "contact.created",
+				sourceModule: "@lssm/example.crm-pipeline"
+			},
+			xpReward: 20,
+			metadata: { surface: "contacts" }
+		},
+		{
+			id: "create_first_deal",
+			title: "Log first deal",
+			description: "Create your first deal in the pipeline.",
+			order: 3,
+			completion: {
+				eventName: "deal.created",
+				sourceModule: "@lssm/example.crm-pipeline"
+			},
+			xpReward: 20,
+			metadata: { surface: "deals" }
+		},
+		{
+			id: "move_deal_in_pipeline",
+			title: "Move a deal across stages",
+			description: "Move a deal across at least three stages.",
+			order: 4,
+			completion: {
+				eventName: "deal.moved",
+				sourceModule: "@lssm/example.crm-pipeline"
+			},
+			xpReward: 20,
+			metadata: { surface: "deals" }
+		},
+		{
+			id: "close_deal_won",
+			title: "Close a deal as won",
+			description: "Close a deal as won to hit first revenue.",
+			order: 5,
+			completion: {
+				eventName: "deal.won",
+				sourceModule: "@lssm/example.crm-pipeline"
+			},
+			xpReward: 30,
+			metadata: { surface: "deals" }
+		},
+		{
+			id: "setup_follow_up",
+			title: "Create follow-up task",
+			description: "Create a follow-up task and notification for a contact or deal.",
+			order: 6,
+			completion: {
+				eventName: "task.completed",
+				sourceModule: "@lssm/example.crm-pipeline",
+				payloadFilter: { type: "follow_up" }
+			},
+			xpReward: 30,
+			metadata: { surface: "tasks" }
+		}
+	],
+	metadata: { surfacedIn: ["crm/dashboard", "crm/pipeline"] }
+};
+const crmLearningTracks = [crmFirstWinTrack];
+
+//#endregion
+export { crmLearningTracks };

package/dist/examples/learning-journey-duo-drills/src/track.js

@@ -0,0 +1,65 @@
+//#region ../learning-journey-duo-drills/src/track.ts
+const drillsLanguageBasicsTrack = {
+	id: "drills_language_basics",
+	name: "Language Basics Drills",
+	description: "Short SRS-driven drills to master a first skill, modeled after Duolingo-style sessions.",
+	targetUserSegment: "learner",
+	targetRole: "individual",
+	totalXp: 50,
+	completionRewards: { xpBonus: 25 },
+	steps: [
+		{
+			id: "complete_first_session",
+			title: "Complete first drill session",
+			description: "Finish a drill session to get started.",
+			order: 1,
+			completion: {
+				kind: "event",
+				eventName: "drill.session.completed"
+			},
+			xpReward: 20,
+			metadata: { surface: "drills" }
+		},
+		{
+			id: "reach_accuracy_threshold",
+			title: "Hit high accuracy in sessions",
+			description: "Achieve three high-accuracy sessions to build confidence.",
+			order: 2,
+			completion: {
+				kind: "count",
+				eventName: "drill.session.completed",
+				atLeast: 3,
+				payloadFilter: { accuracyBucket: "high" }
+			},
+			xpReward: 30,
+			metadata: {
+				metric: "accuracy",
+				target: ">=85%"
+			}
+		},
+		{
+			id: "unlock_new_skill",
+			title: "Master core cards in first skill",
+			description: "Reach mastery on at least five cards in the first skill to unlock the next one.",
+			order: 3,
+			completion: {
+				kind: "srs_mastery",
+				eventName: "drill.card.mastered",
+				minimumMastery: .8,
+				requiredCount: 5,
+				skillIdField: "skillId",
+				masteryField: "mastery",
+				payloadFilter: { skillId: "language_basics" }
+			},
+			xpReward: 40,
+			metadata: {
+				surface: "srs",
+				skill: "language_basics"
+			}
+		}
+	]
+};
+const drillTracks = [drillsLanguageBasicsTrack];
+
+//#endregion
+export { drillTracks };