@contractspec/example.learning-journey-quest-challenges 1.44.0

package/.turbo/turbo-build$colon$bundle.log

@@ -0,0 +1,25 @@
+$ tsdown
+ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-journey-quest-challenges/tsdown.config.js 
+ℹ entry: src/example.ts, src/index.ts, src/track.ts, src/docs/index.ts, src/docs/quest-challenges.docblock.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 16 files
+ℹ dist/docs/quest-challenges.docblock.js      1.51 kB │ gzip: 0.78 kB
+ℹ dist/track.js                               1.44 kB │ gzip: 0.76 kB
+ℹ dist/example.js                             0.82 kB │ gzip: 0.46 kB
+ℹ dist/index.js                               0.21 kB │ gzip: 0.13 kB
+ℹ dist/docs/index.js                          0.04 kB │ gzip: 0.06 kB
+ℹ dist/track.js.map                           2.70 kB │ gzip: 1.16 kB
+ℹ dist/docs/quest-challenges.docblock.js.map  1.93 kB │ gzip: 0.95 kB
+ℹ dist/example.js.map                         1.17 kB │ gzip: 0.62 kB
+ℹ dist/example.d.ts.map                       0.14 kB │ gzip: 0.13 kB
+ℹ dist/track.d.ts.map                         0.14 kB │ gzip: 0.13 kB
+ℹ dist/example.d.ts                           1.05 kB │ gzip: 0.45 kB
+ℹ dist/track.d.ts                             0.33 kB │ gzip: 0.20 kB
+ℹ dist/index.d.ts                             0.15 kB │ gzip: 0.10 kB
+ℹ dist/docs/index.d.ts                        0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/quest-challenges.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ 15 files, total: 11.66 kB
+✔ Build complete in 13446ms

package/.turbo/turbo-build.log

@@ -0,0 +1,26 @@
+$ bun build:types && bun build:bundle
+$ tsc --noEmit
+$ tsdown
+ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-journey-quest-challenges/tsdown.config.js 
+ℹ entry: src/example.ts, src/index.ts, src/track.ts, src/docs/index.ts, src/docs/quest-challenges.docblock.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/docs/quest-challenges.docblock.js      1.51 kB │ gzip: 0.78 kB
+ℹ dist/track.js                               1.44 kB │ gzip: 0.76 kB
+ℹ dist/example.js                             0.82 kB │ gzip: 0.46 kB
+ℹ dist/index.js                               0.21 kB │ gzip: 0.13 kB
+ℹ dist/docs/index.js                          0.04 kB │ gzip: 0.06 kB
+ℹ dist/track.js.map                           2.70 kB │ gzip: 1.16 kB
+ℹ dist/docs/quest-challenges.docblock.js.map  1.93 kB │ gzip: 0.95 kB
+ℹ dist/example.js.map                         1.17 kB │ gzip: 0.62 kB
+ℹ dist/example.d.ts.map                       0.14 kB │ gzip: 0.13 kB
+ℹ dist/track.d.ts.map                         0.14 kB │ gzip: 0.13 kB
+ℹ dist/example.d.ts                           1.05 kB │ gzip: 0.45 kB
+ℹ dist/track.d.ts                             0.33 kB │ gzip: 0.20 kB
+ℹ dist/index.d.ts                             0.15 kB │ gzip: 0.10 kB
+ℹ dist/docs/index.d.ts                        0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/quest-challenges.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ 15 files, total: 11.66 kB
+✔ Build complete in 14470ms

package/CHANGELOG.md

@@ -0,0 +1,178 @@
+# @contractspec/example.learning-journey-quest-challenges
+
+## 1.44.0
+
+### Minor Changes
+
+- 5f3a868: chore: isolate branding to contractspec.io
+
+### Patch Changes
+
+- Updated dependencies [5f3a868]
+  - @contractspec/module.learning-journey@1.44.0
+  - @contractspec/lib.contracts@1.44.0
+  - @contractspec/lib.schema@1.44.0
+
+## 1.43.4
+
+### Patch Changes
+
+- 9216062: fix: cross-platform compatibility
+- Updated dependencies [9216062]
+  - @contractspec/module.learning-journey@1.43.4
+  - @contractspec/lib.contracts@1.43.4
+  - @contractspec/lib.schema@1.43.3
+
+## 1.43.3
+
+### Patch Changes
+
+- 24d9759: improve documentation
+- Updated dependencies [24d9759]
+  - @contractspec/module.learning-journey@1.43.3
+  - @contractspec/lib.contracts@1.43.3
+  - @contractspec/lib.schema@1.43.2
+
+## 1.43.2
+
+### Patch Changes
+
+- e147271: fix: improve stability
+- Updated dependencies [e147271]
+  - @contractspec/module.learning-journey@1.43.2
+  - @contractspec/lib.contracts@1.43.2
+  - @contractspec/lib.schema@1.43.1
+
+## 1.43.1
+
+### Patch Changes
+
+- Updated dependencies [f28fdad]
+  - @contractspec/lib.contracts@1.43.1
+  - @contractspec/module.learning-journey@1.43.1
+
+## 1.43.0
+
+### Minor Changes
+
+- 042d072: feat: schema declaration using json schema, including zod
+
+### Patch Changes
+
+- Updated dependencies [042d072]
+  - @contractspec/module.learning-journey@1.43.0
+  - @contractspec/lib.contracts@1.43.0
+  - @contractspec/lib.schema@1.43.0
+
+## 1.42.10
+
+### Patch Changes
+
+- 1e6a0f1: fix: mcp server
+- Updated dependencies [1e6a0f1]
+  - @contractspec/module.learning-journey@1.42.10
+  - @contractspec/lib.contracts@1.42.10
+  - @contractspec/lib.schema@1.42.10
+
+## 1.42.9
+
+### Patch Changes
+
+- 9281db7: fix ModelRegistry
+- Updated dependencies [9281db7]
+  - @contractspec/module.learning-journey@1.42.9
+  - @contractspec/lib.contracts@1.42.9
+  - @contractspec/lib.schema@1.42.9
+
+## 1.42.8
+
+### Patch Changes
+
+- e07b5ac: fix
+- Updated dependencies [e07b5ac]
+  - @contractspec/module.learning-journey@1.42.8
+  - @contractspec/lib.contracts@1.42.8
+  - @contractspec/lib.schema@1.42.8
+
+## 1.42.7
+
+### Patch Changes
+
+- e9b575d: fix release
+- Updated dependencies [e9b575d]
+  - @contractspec/module.learning-journey@1.42.7
+  - @contractspec/lib.contracts@1.42.7
+  - @contractspec/lib.schema@1.42.7
+
+## 1.42.6
+
+### Patch Changes
+
+- 1500242: fix tooling
+- Updated dependencies [1500242]
+  - @contractspec/module.learning-journey@1.42.6
+  - @contractspec/lib.contracts@1.42.6
+  - @contractspec/lib.schema@1.42.6
+
+## 1.42.5
+
+### Patch Changes
+
+- 1299719: fix vscode
+- Updated dependencies [1299719]
+  - @contractspec/module.learning-journey@1.42.5
+  - @contractspec/lib.contracts@1.42.5
+  - @contractspec/lib.schema@1.42.5
+
+## 1.42.4
+
+### Patch Changes
+
+- ac28b99: fix: generate from openapi
+- Updated dependencies [ac28b99]
+  - @contractspec/module.learning-journey@1.42.4
+  - @contractspec/lib.contracts@1.42.4
+  - @contractspec/lib.schema@1.42.4
+
+## 1.42.3
+
+### Patch Changes
+
+- 3f5d015: fix(tooling): cicd
+- Updated dependencies [3f5d015]
+  - @contractspec/lib.contracts@1.42.3
+  - @contractspec/lib.schema@1.42.3
+  - @contractspec/module.learning-journey@1.42.3
+
+## 1.42.2
+
+### Patch Changes
+
+- 1f9ac4c: fix
+- Updated dependencies [1f9ac4c]
+  - @contractspec/lib.contracts@1.42.2
+  - @contractspec/lib.schema@1.42.2
+  - @contractspec/module.learning-journey@1.42.2
+
+## 1.42.1
+
+### Patch Changes
+
+- f043995: Fix release
+- Updated dependencies [f043995]
+  - @contractspec/module.learning-journey@1.42.1
+  - @contractspec/lib.contracts@1.42.1
+  - @contractspec/lib.schema@1.42.1
+
+## 1.42.0
+
+### Minor Changes
+
+- 8eefd9c: initial release
+
+### Patch Changes
+
+- Updated dependencies [8eefd9c]
+  - @contractspec/lib.contracts@1.42.0
+  - @contractspec/lib.schema@1.42.0
+  - @contractspec/module.learning-journey@1.42.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,30 @@
+# @contractspec/example.learning-journey-quest-challenges
+
+Website: https://contractspec.io/
+
+
+Time-bound challenge/quest example (7-day money reset) showing day-based unlocks and event-driven completion.
+
+## What it shows
+
+- Track steps that unlock by day since quest start
+- Event-based completions for each day
+- XP per day with completion bonus when finished within duration
+- Optional recap via SRS mastery events
+
+## How to run
+
+1. `bun test packages/examples/learning-journey-quest-challenges`
+2. Emit events in order with `recordEvent` from the registry:
+
+```ts
+recordEvent({ name: 'accounts.mapped', learnerId: 'u1' });
+recordEvent({ name: 'transactions.categorized', learnerId: 'u1' });
+// ...
+```
+
+## Adapting
+
+- Swap events for your vertical (coliving integration week, artisan onboarding).
+- Adjust unlock windows via `availability.unlockOnDay`.
+- Tweak XP/bonus and add recap SRS mastery after completion.

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

@@ -0,0 +1 @@
+import "./quest-challenges.docblock.js";

package/dist/docs/quest-challenges.docblock.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/quest-challenges.docblock.js

@@ -0,0 +1,38 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/quest-challenges.docblock.ts
+registerDocBlocks([{
+	id: "docs.learning-journey.quest-challenges",
+	title: "Learning Journey — Quest Challenges",
+	summary: "Time-bound challenge pattern (7-day money reset) with day unlocks and event-driven completion.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/learning-journey/quest-challenges",
+	tags: [
+		"learning",
+		"quest",
+		"challenge"
+	],
+	body: `## Track
+- **Key**: \`money_reset_7day\`
+- **Duration**: 7 days, steps unlock day by day
+
+## Steps & Events
+- Day 1 \`day1_map_accounts\` → event \`accounts.mapped\`
+- Day 2 \`day2_categorize_transactions\` → event \`transactions.categorized\`
+- Day 3 \`day3_define_goals\` → event \`goals.created\`
+- Day 4 \`day4_setup_recurring_savings\` → event \`recurring_rule.created\`
+- Day 5 \`day5_review_subscriptions\` → event \`subscription.flagged_or_cancelled\`
+- Day 6 \`day6_plan_emergency\` → event \`emergency_plan.completed\`
+- Day 7 \`day7_review_commit\` → event \`quest.review.completed\`
+
+XP: 15 per day, completion bonus 30 if finished within duration. Optional recap via SRS after completion.
+
+## Usage
+- Exported via \`@contractspec/example.learning-journey-quest-challenges/track\`.
+- Step availability uses \`availability.unlockOnDay\` to gate days.
+- Registry progression handles event matching and XP application.`
+}]);
+
+//#endregion
+//# sourceMappingURL=quest-challenges.docblock.js.map

package/dist/docs/quest-challenges.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quest-challenges.docblock.js","names":[],"sources":["../../src/docs/quest-challenges.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst questDocBlocks: DocBlock[] = [\n  {\n    id: 'docs.learning-journey.quest-challenges',\n    title: 'Learning Journey — Quest Challenges',\n    summary:\n      'Time-bound challenge pattern (7-day money reset) with day unlocks and event-driven completion.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/learning-journey/quest-challenges',\n    tags: ['learning', 'quest', 'challenge'],\n    body: `## Track\n- **Key**: \\`money_reset_7day\\`\n- **Duration**: 7 days, steps unlock day by day\n\n## Steps & Events\n- Day 1 \\`day1_map_accounts\\` → event \\`accounts.mapped\\`\n- Day 2 \\`day2_categorize_transactions\\` → event \\`transactions.categorized\\`\n- Day 3 \\`day3_define_goals\\` → event \\`goals.created\\`\n- Day 4 \\`day4_setup_recurring_savings\\` → event \\`recurring_rule.created\\`\n- Day 5 \\`day5_review_subscriptions\\` → event \\`subscription.flagged_or_cancelled\\`\n- Day 6 \\`day6_plan_emergency\\` → event \\`emergency_plan.completed\\`\n- Day 7 \\`day7_review_commit\\` → event \\`quest.review.completed\\`\n\nXP: 15 per day, completion bonus 30 if finished within duration. Optional recap via SRS after completion.\n\n## Usage\n- Exported via \\`@contractspec/example.learning-journey-quest-challenges/track\\`.\n- Step availability uses \\`availability.unlockOnDay\\` to gate days.\n- Registry progression handles event matching and XP application.`,\n  },\n];\n\nregisterDocBlocks(questDocBlocks);\n"],"mappings":";;;AAmCA,kBAhCmC,CACjC;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAY;EAAS;EAAY;CACxC,MAAM;;;;;;;;;;;;;;;;;;;CAmBP,CACF,CAEgC"}

package/dist/example.d.ts

@@ -0,0 +1,33 @@
+//#region src/example.d.ts
+declare const example: {
+  readonly id: "learning-journey-quest-challenges";
+  readonly title: "Learning Journey — Quest Challenges";
+  readonly summary: "Quest/challenge pattern: multi-step goals with progress events, rewards, and streak hooks.";
+  readonly tags: readonly ["learning", "quests", "challenges"];
+  readonly kind: "template";
+  readonly visibility: "public";
+  readonly docs: {
+    readonly rootDocId: "docs.learning-journey.quest-challenges";
+  };
+  readonly entrypoints: {
+    readonly packageName: "@contractspec/example.learning-journey-quest-challenges";
+    readonly docs: "./docs";
+  };
+  readonly surfaces: {
+    readonly templates: true;
+    readonly sandbox: {
+      readonly enabled: true;
+      readonly modes: readonly ["playground", "markdown"];
+    };
+    readonly studio: {
+      readonly enabled: true;
+      readonly installable: true;
+    };
+    readonly mcp: {
+      readonly enabled: true;
+    };
+  };
+};
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";cAAM;EAAA,SAAA,EAqBI,EAAA,mCAAA"}

package/dist/example.js

@@ -0,0 +1,35 @@
+//#region src/example.ts
+const example = {
+	id: "learning-journey-quest-challenges",
+	title: "Learning Journey — Quest Challenges",
+	summary: "Quest/challenge pattern: multi-step goals with progress events, rewards, and streak hooks.",
+	tags: [
+		"learning",
+		"quests",
+		"challenges"
+	],
+	kind: "template",
+	visibility: "public",
+	docs: { rootDocId: "docs.learning-journey.quest-challenges" },
+	entrypoints: {
+		packageName: "@contractspec/example.learning-journey-quest-challenges",
+		docs: "./docs"
+	},
+	surfaces: {
+		templates: true,
+		sandbox: {
+			enabled: true,
+			modes: ["playground", "markdown"]
+		},
+		studio: {
+			enabled: true,
+			installable: true
+		},
+		mcp: { enabled: true }
+	}
+};
+var example_default = example;
+
+//#endregion
+export { example_default as default };
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["const example = {\n  id: 'learning-journey-quest-challenges',\n  title: 'Learning Journey — Quest Challenges',\n  summary:\n    'Quest/challenge pattern: multi-step goals with progress events, rewards, and streak hooks.',\n  tags: ['learning', 'quests', 'challenges'],\n  kind: 'template',\n  visibility: 'public',\n  docs: {\n    rootDocId: 'docs.learning-journey.quest-challenges',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.learning-journey-quest-challenges',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['playground', 'markdown'] },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n} as const;\n\nexport default example;\n"],"mappings":";AAAA,MAAM,UAAU;CACd,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;EAAC;EAAY;EAAU;EAAa;CAC1C,MAAM;CACN,YAAY;CACZ,MAAM,EACJ,WAAW,0CACZ;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,cAAc,WAAW;GAAE;EAC7D,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import example from "./example.js";
+import { moneyResetQuestTrack, questTracks } from "./track.js";
+export { example, moneyResetQuestTrack, questTracks };

package/dist/index.js

@@ -0,0 +1,5 @@
+import example_default from "./example.js";
+import { moneyResetQuestTrack, questTracks } from "./track.js";
+import "./docs/index.js";
+
+export { example_default as example, moneyResetQuestTrack, questTracks };

package/dist/track.d.ts

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

package/dist/track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.d.ts","names":[],"sources":["../src/track.ts"],"sourcesContent":[],"mappings":";;;cAqBa,sBAAsB;cAsDtB,aAAa"}

package/dist/track.js

@@ -0,0 +1,36 @@
+//#region src/track.ts
+const dayStep = (id, day, eventName, description) => ({
+	id,
+	title: `Day ${day}`,
+	description,
+	availability: { unlockOnDay: day },
+	completion: {
+		kind: "time_window",
+		eventName,
+		withinHoursOfStart: (day + 1) * 24
+	},
+	xpReward: 15,
+	metadata: { day }
+});
+const moneyResetQuestTrack = {
+	id: "money_reset_7day",
+	name: "7-day Money Reset",
+	description: "Time-bound quest to reset personal finances over a focused week.",
+	targetUserSegment: "money_user",
+	totalXp: 105,
+	completionRewards: { xpBonus: 30 },
+	steps: [
+		dayStep("day1_map_accounts", 1, "accounts.mapped", "Map bank and card accounts."),
+		dayStep("day2_categorize_transactions", 2, "transactions.categorized", "Categorize recent transactions."),
+		dayStep("day3_define_goals", 3, "goals.created", "Define at least one savings goal."),
+		dayStep("day4_setup_recurring_savings", 4, "recurring_rule.created", "Set a recurring savings rule."),
+		dayStep("day5_review_subscriptions", 5, "subscription.flagged_or_cancelled", "Review subscriptions and flag or cancel wasteful ones."),
+		dayStep("day6_plan_emergency", 6, "emergency_plan.completed", "Draft an emergency plan and target buffer."),
+		dayStep("day7_review_commit", 7, "quest.review.completed", "Review week outcomes and commit to the next month.")
+	]
+};
+const questTracks = [moneyResetQuestTrack];
+
+//#endregion
+export { moneyResetQuestTrack, questTracks };
+//# sourceMappingURL=track.js.map

package/dist/track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.js","names":["moneyResetQuestTrack: LearningJourneyTrackSpec","questTracks: LearningJourneyTrackSpec[]"],"sources":["../src/track.ts"],"sourcesContent":["import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';\n\nconst dayStep = (\n  id: string,\n  day: number,\n  eventName: string,\n  description: string\n): LearningJourneyTrackSpec['steps'][number] => ({\n  id,\n  title: `Day ${day}`,\n  description,\n  availability: { unlockOnDay: day },\n  completion: {\n    kind: 'time_window',\n    eventName,\n    withinHoursOfStart: (day + 1) * 24, // allow grace through next day\n  },\n  xpReward: 15,\n  metadata: { day },\n});\n\nexport const moneyResetQuestTrack: LearningJourneyTrackSpec = {\n  id: 'money_reset_7day',\n  name: '7-day Money Reset',\n  description:\n    'Time-bound quest to reset personal finances over a focused week.',\n  targetUserSegment: 'money_user',\n  totalXp: 105,\n  completionRewards: { xpBonus: 30 },\n  steps: [\n    dayStep(\n      'day1_map_accounts',\n      1,\n      'accounts.mapped',\n      'Map bank and card accounts.'\n    ),\n    dayStep(\n      'day2_categorize_transactions',\n      2,\n      'transactions.categorized',\n      'Categorize recent transactions.'\n    ),\n    dayStep(\n      'day3_define_goals',\n      3,\n      'goals.created',\n      'Define at least one savings goal.'\n    ),\n    dayStep(\n      'day4_setup_recurring_savings',\n      4,\n      'recurring_rule.created',\n      'Set a recurring savings rule.'\n    ),\n    dayStep(\n      'day5_review_subscriptions',\n      5,\n      'subscription.flagged_or_cancelled',\n      'Review subscriptions and flag or cancel wasteful ones.'\n    ),\n    dayStep(\n      'day6_plan_emergency',\n      6,\n      'emergency_plan.completed',\n      'Draft an emergency plan and target buffer.'\n    ),\n    dayStep(\n      'day7_review_commit',\n      7,\n      'quest.review.completed',\n      'Review week outcomes and commit to the next month.'\n    ),\n  ],\n};\n\nexport const questTracks: LearningJourneyTrackSpec[] = [moneyResetQuestTrack];\n"],"mappings":";AAEA,MAAM,WACJ,IACA,KACA,WACA,iBAC+C;CAC/C;CACA,OAAO,OAAO;CACd;CACA,cAAc,EAAE,aAAa,KAAK;CAClC,YAAY;EACV,MAAM;EACN;EACA,qBAAqB,MAAM,KAAK;EACjC;CACD,UAAU;CACV,UAAU,EAAE,KAAK;CAClB;AAED,MAAaA,uBAAiD;CAC5D,IAAI;CACJ,MAAM;CACN,aACE;CACF,mBAAmB;CACnB,SAAS;CACT,mBAAmB,EAAE,SAAS,IAAI;CAClC,OAAO;EACL,QACE,qBACA,GACA,mBACA,8BACD;EACD,QACE,gCACA,GACA,4BACA,kCACD;EACD,QACE,qBACA,GACA,iBACA,oCACD;EACD,QACE,gCACA,GACA,0BACA,gCACD;EACD,QACE,6BACA,GACA,qCACA,yDACD;EACD,QACE,uBACA,GACA,4BACA,6CACD;EACD,QACE,sBACA,GACA,0BACA,qDACD;EACF;CACF;AAED,MAAaC,cAA0C,CAAC,qBAAqB"}

package/example.ts

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@contractspec/example.learning-journey-quest-challenges",
+  "version": "1.44.0",
+  "description": "Time-bound quest/challenge learning journey example.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/quest-challenges.docblock": "./dist/docs/quest-challenges.docblock.js",
+    "./example": "./dist/example.js",
+    "./track": "./dist/track.js",
+    "./*": "./*"
+  },
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@contractspec/module.learning-journey": "1.44.0",
+    "@contractspec/lib.schema": "1.44.0",
+    "@contractspec/lib.contracts": "1.44.0"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "1.44.0",
+    "@contractspec/tool.typescript": "1.44.0",
+    "tsdown": "^0.18.3",
+    "typescript": "^5.9.3"
+  },
+  "module": "./dist/index.js",
+  "publishConfig": {
+    "exports": {
+      ".": "./dist/index.js",
+      "./example": "./dist/example.js",
+      "./track": "./dist/track.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/quest-challenges.docblock": "./dist/docs/quest-challenges.docblock.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/learning-journey-quest-challenges"
+  },
+  "homepage": "https://contractspec.io"
+}

package/src/docs/index.ts

@@ -0,0 +1 @@
+import './quest-challenges.docblock';

package/src/docs/quest-challenges.docblock.ts

@@ -0,0 +1,36 @@
+import type { DocBlock } from '@contractspec/lib.contracts/docs';
+import { registerDocBlocks } from '@contractspec/lib.contracts/docs';
+
+const questDocBlocks: DocBlock[] = [
+  {
+    id: 'docs.learning-journey.quest-challenges',
+    title: 'Learning Journey — Quest Challenges',
+    summary:
+      'Time-bound challenge pattern (7-day money reset) with day unlocks and event-driven completion.',
+    kind: 'reference',
+    visibility: 'public',
+    route: '/docs/learning-journey/quest-challenges',
+    tags: ['learning', 'quest', 'challenge'],
+    body: `## Track
+- **Key**: \`money_reset_7day\`
+- **Duration**: 7 days, steps unlock day by day
+
+## Steps & Events
+- Day 1 \`day1_map_accounts\` → event \`accounts.mapped\`
+- Day 2 \`day2_categorize_transactions\` → event \`transactions.categorized\`
+- Day 3 \`day3_define_goals\` → event \`goals.created\`
+- Day 4 \`day4_setup_recurring_savings\` → event \`recurring_rule.created\`
+- Day 5 \`day5_review_subscriptions\` → event \`subscription.flagged_or_cancelled\`
+- Day 6 \`day6_plan_emergency\` → event \`emergency_plan.completed\`
+- Day 7 \`day7_review_commit\` → event \`quest.review.completed\`
+
+XP: 15 per day, completion bonus 30 if finished within duration. Optional recap via SRS after completion.
+
+## Usage
+- Exported via \`@contractspec/example.learning-journey-quest-challenges/track\`.
+- Step availability uses \`availability.unlockOnDay\` to gate days.
+- Registry progression handles event matching and XP application.`,
+  },
+];
+
+registerDocBlocks(questDocBlocks);

package/src/example.ts

@@ -0,0 +1,24 @@
+const example = {
+  id: 'learning-journey-quest-challenges',
+  title: 'Learning Journey — Quest Challenges',
+  summary:
+    'Quest/challenge pattern: multi-step goals with progress events, rewards, and streak hooks.',
+  tags: ['learning', 'quests', 'challenges'],
+  kind: 'template',
+  visibility: 'public',
+  docs: {
+    rootDocId: 'docs.learning-journey.quest-challenges',
+  },
+  entrypoints: {
+    packageName: '@contractspec/example.learning-journey-quest-challenges',
+    docs: './docs',
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ['playground', 'markdown'] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true },
+  },
+} as const;
+
+export default example;

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './track';
+export { default as example } from './example';
+import './docs';