@lssm/example.learning-journey-registry 0.0.0-canary-20251217083314 → 1.41.0

package/.turbo/turbo-build.log

@@ -1,55 +1,53 @@
-
-$ 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
+$ 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.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 57ms
+$ tsc --noEmit

package/dist/api.js

@@ -1,170 +1 @@
-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 };
+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};

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,38 +1 @@
-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
+import{registerDocBlocks as e}from"../libs/contracts/src/docs/registry.js";import"../libs/contracts/src/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."}]);

package/dist/example.js

@@ -1,34 +1 @@
-//#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 };
+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};

package/dist/index.js

@@ -1,13 +1 @@
-import { crmLearningTracks } from "./examples/learning-journey-crm-onboarding/dist/track.js";
-import { platformLearningTracks } from "./examples/learning-journey-platform-tour/dist/track.js";
-import { studioLearningTracks } from "./examples/learning-journey-studio-onboarding/dist/track.js";
-import { learningJourneyTracks, mapStep, mapTrackSpecToDto, onboardingTrackCatalog } from "./tracks.js";
-import { getProgress, listTracks, recordEvent } from "./api.js";
-import example_default from "./example.js";
-import "./docs/index.js";
-import { LearningTrackDetailPresentation, LearningTrackListPresentation, LearningTrackProgressWidgetPresentation, learningJourneyPresentations } from "./presentations/index.js";
-import { LearningJourneyRegistryFeature } from "./learning-journey-registry.feature.js";
-import { LearningMiniApp, getLearningTemplateIds, isLearningTemplate } from "./ui/LearningMiniApp.js";
-import "./ui/index.js";
-
-export { LearningJourneyRegistryFeature, LearningMiniApp, LearningTrackDetailPresentation, LearningTrackListPresentation, LearningTrackProgressWidgetPresentation, crmLearningTracks, example_default as example, getLearningTemplateIds, getProgress, isLearningTemplate, learningJourneyPresentations, learningJourneyTracks, listTracks, mapStep, mapTrackSpecToDto, onboardingTrackCatalog, platformLearningTracks, recordEvent, studioLearningTracks };
+import{crmLearningTracks as e,learningJourneyTracks as t,mapStep as n,mapTrackSpecToDto as r,onboardingTrackCatalog as i,platformLearningTracks as a,studioLearningTracks as o}from"./tracks.js";import{getProgress as s,listTracks as c,recordEvent as l}from"./api.js";import u from"./example.js";import"./docs/index.js";import{LearningTrackDetailPresentation as d,LearningTrackListPresentation as f,LearningTrackProgressWidgetPresentation as p,learningJourneyPresentations as m}from"./presentations/index.js";import{LearningJourneyRegistryFeature as h}from"./learning-journey-registry.feature.js";import{LearningMiniApp as g,getLearningTemplateIds as _,isLearningTemplate as v}from"./ui/LearningMiniApp.js";import"./ui/index.js";export{h as LearningJourneyRegistryFeature,g as LearningMiniApp,d as LearningTrackDetailPresentation,f as LearningTrackListPresentation,p as LearningTrackProgressWidgetPresentation,e as crmLearningTracks,u as example,_ as getLearningTemplateIds,s as getProgress,v as isLearningTemplate,m as learningJourneyPresentations,t as learningJourneyTracks,c as listTracks,n as mapStep,r as mapTrackSpecToDto,i as onboardingTrackCatalog,a as platformLearningTracks,l as recordEvent,o as studioLearningTracks};

package/dist/learning-journey-registry.feature.js

@@ -1,66 +1 @@
-//#region src/learning-journey-registry.feature.ts
-/**
-* Learning Journey Registry feature module that bundles
-* the shared presentations for learning journey tracks.
-*/
-const LearningJourneyRegistryFeature = {
-	meta: {
-		key: "learning-journey-registry",
-		title: "Learning Journey Registry",
-		description: "Shared registry and presentations for learning journey tracks",
-		domain: "learning-journey",
-		owners: ["@learning-team"],
-		tags: [
-			"learning",
-			"journey",
-			"onboarding",
-			"registry"
-		],
-		stability: "experimental"
-	},
-	operations: [],
-	events: [],
-	presentations: [
-		{
-			name: "learning.journey.track_list",
-			version: 1
-		},
-		{
-			name: "learning.journey.track_detail",
-			version: 1
-		},
-		{
-			name: "learning.journey.progress_widget",
-			version: 1
-		}
-	],
-	opToPresentation: [],
-	presentationsTargets: [
-		{
-			name: "learning.journey.track_list",
-			version: 1,
-			targets: ["react", "markdown"]
-		},
-		{
-			name: "learning.journey.track_detail",
-			version: 1,
-			targets: [
-				"react",
-				"markdown",
-				"application/json"
-			]
-		},
-		{
-			name: "learning.journey.progress_widget",
-			version: 1,
-			targets: ["react"]
-		}
-	],
-	capabilities: { requires: [{
-		key: "identity",
-		version: 1
-	}] }
-};
-
-//#endregion
-export { LearningJourneyRegistryFeature };
+const e={meta:{key:`learning-journey-registry`,title:`Learning Journey Registry`,description:`Shared registry and presentations for learning journey tracks`,domain:`learning-journey`,owners:[`@learning-team`],tags:[`learning`,`journey`,`onboarding`,`registry`],stability:`experimental`},operations:[],events:[],presentations:[{name:`learning.journey.track_list`,version:1},{name:`learning.journey.track_detail`,version:1},{name:`learning.journey.progress_widget`,version:1}],opToPresentation:[],presentationsTargets:[{name:`learning.journey.track_list`,version:1,targets:[`react`,`markdown`]},{name:`learning.journey.track_detail`,version:1,targets:[`react`,`markdown`,`application/json`]},{name:`learning.journey.progress_widget`,version:1,targets:[`react`]}],capabilities:{requires:[{key:`identity`,version:1}]}};export{e as LearningJourneyRegistryFeature};

package/dist/libs/contracts/src/docs/PUBLISHING.docblock.js

@@ -0,0 +1,76 @@
+import{registerDocBlocks as e}from"./registry.js";e([{id:`docs.PUBLISHING`,title:`Publishing ContractSpec Libraries`,summary:`This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).`,kind:`reference`,visibility:`public`,route:`/docs/PUBLISHING`,tags:[`PUBLISHING`],body:`# Publishing ContractSpec Libraries
+
+This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).
+
+## Release Tracks
+
+| Track | Branch | npm Tag | Frequency | Versioning | Use Case |
+|-------|--------|---------|-----------|------------|----------|
+| **Stable** | \`release\` | \`latest\` | Manual | SemVer (e.g., \`1.7.4\`) | Production, external users |
+| **Canary** | \`main\` | \`canary\` | Every Push | Snapshot (e.g., \`1.7.4-canary...\`) | Dev, internal testing |
+
+## Prerequisites
+
+- ✅ \`NPM_TOKEN\` secret is configured in GitHub (owner or automation token with _publish_ scope).
+- ✅ \`GITHUB_TOKEN\` (built-in) has permissions to create PRs (enabled by default in new repos).
+- ✅ For stable releases: \`release\` branch exists and is protected.
+
+## Canary Workflow (Automatic)
+
+Every commit pushed to \`main\` triggers the \`.github/workflows/publish-canary.yml\` workflow.
+
+1. **Trigger**: Push to \`main\`.
+2. **Versioning**: Runs \`changeset version --snapshot canary\` to generate a temporary snapshot version.
+3. **Publish**: Packages are published to npm with the \`canary\` tag using \`changeset publish --tag canary\`.
+
+### Consuming Canary Builds
+
+To install the latest bleeding-edge version:
+
+\`\`\`bash
+npm install @lssm/lib.contracts@canary
+# or
+bun add @lssm/lib.contracts@canary
+\`\`\`
+
+## Stable Release Workflow (Manual)
+
+Stable releases are managed via the \`release\` branch using the standard [Changesets Action](https://github.com/changesets/action).
+
+1. **Develop on \`main\`**: Create features and fixes.
+2. **Add Changesets**: Run \`bun changeset\` to document changes and impact (major/minor/patch).
+3. **Merge to \`release\`**: When ready to ship, open a PR from \`main\` to \`release\` or merge manually.
+4. **"Version Packages" PR**:
+   - The GitHub Action detects new changesets and automatically creates a Pull Request titled **"Version Packages"**.
+   - This PR contains the version bumps and updated \`CHANGELOG.md\` files.
+5. **Merge & Publish**:
+   - Review and merge the "Version Packages" PR.
+   - The Action runs again, detects the versions have been bumped, builds the libraries, and publishes them to npm with the \`latest\` tag.
+
+### Publishing Steps
+
+1. Ensure all changesets are present on \`main\`.
+2. Merge \`main\` into \`release\`:
+   \`\`\`bash
+   git checkout release
+   git pull origin release
+   git merge main
+   git push origin release
+   \`\`\`
+3. Go to GitHub Pull Requests. You will see a **"Version Packages"** PR created by the bot.
+4. Merge that PR.
+5. The release is now live on npm!
+
+## Manual Verification (Optional)
+
+Before publishing a new version you can run:
+
+\`\`\`bash
+bun run build:not-apps
+npx npm-packlist --json packages/libs/contracts
+\`\`\`
+
+## Rollback
+
+If a publish fails mid-way, re-run the workflow once the issue is fixed. Already published packages are skipped automatically. Use \`npm deprecate <package>@<version>\` if we need to warn consumers about a broken release.
+`}]);