@contractspec/example.learning-journey-quest-challenges 3.7.6 → 3.7.10

package/.turbo/turbo-build.log

@@ -3,7 +3,7 @@ $ bun run prebuild && bun run build:bundle && bun run build:types
 $ contractspec-bun-build prebuild
 $ contractspec-bun-build transpile
 [contractspec-bun-build] transpile target=bun root=src entries=6 noBundle=false
-Bundled 6 modules in 29ms
+Bundled 6 modules in 16ms
 
   docs/index.js                                   1.53 KB  (entry point)
   ./index.js                                      4.57 KB  (entry point)
@@ -13,7 +13,7 @@ Bundled 6 modules in 29ms
   ./track.js                                      1.43 KB  (entry point)
 
 [contractspec-bun-build] transpile target=node root=src entries=6 noBundle=false
-Bundled 6 modules in 13ms
+Bundled 6 modules in 27ms
 
   docs/index.js                                   1.50 KB  (entry point)
   ./index.js                                      4.53 KB  (entry point)
@@ -23,7 +23,7 @@ Bundled 6 modules in 13ms
   ./track.js                                      1.42 KB  (entry point)
 
 [contractspec-bun-build] transpile target=browser root=src entries=6 noBundle=false
-Bundled 6 modules in 26ms
+Bundled 6 modules in 15ms
 
   docs/index.js                                   1.50 KB  (entry point)
   ./index.js                                      4.53 KB  (entry point)

package/AGENTS.md

@@ -1,31 +1,53 @@
-# AI Agent Guide -- `@contractspec/example.learning-journey-quest-challenges`
+# AI Agent Guide — `@contractspec/example.learning-journey-quest-challenges`
 
 Scope: `packages/examples/learning-journey-quest-challenges/*`
 
-Demonstrates time-bound quest and challenge-based learning with deadlines and completion tracking.
+Time-bound quest/challenge learning journey example.
 
 ## Quick Context
 
-- **Layer**: example
-- **Related Packages**: `module.learning-journey`, `lib.contracts-spec`
+- Layer: `example`.
+- Package visibility: published package.
+- Primary consumers are example explorers, template authors, and documentation readers.
+- Related packages: `@contractspec/lib.contracts-spec`, `@contractspec/module.learning-journey`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
 
-## What This Demonstrates
+## Architecture
 
-- Quest/challenge track with time-bound objectives
-- Completion tracking and deadline enforcement
-- Lightweight track + example pattern
-- Integration with the learning-journey module
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/learning-journey-quest-challenges.feature.ts` defines a feature entrypoint.
+- `src/track.test.ts` is part of the package's public or composition surface.
+- `src/track.ts` is part of the package's public or composition surface.
 
-## Public Exports
+## Public Surface
 
-- `.` -- root barrel
-- `./docs` -- DocBlock documentation
-- `./example` -- runnable example entry point
-- `./track` -- quest challenges track definition
+- Export `.` resolves through `./src/index.ts`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/quest-challenges.docblock` resolves through `./src/docs/quest-challenges.docblock.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./learning-journey-quest-challenges.feature` resolves through `./src/learning-journey-quest-challenges.feature.ts`.
+- Export `./track` resolves through `./src/track.ts`.
+
+## Guardrails
+
+- Keep the example package demonstrative, buildable, and aligned with the exported feature surface.
+- Do not add hidden production assumptions that are not actually implemented in the example.
+- Changes here can affect downstream packages such as `@contractspec/lib.contracts-spec`, `@contractspec/module.learning-journey`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
+- Changes here can affect downstream packages such as `@contractspec/lib.contracts-spec`, `@contractspec/module.learning-journey`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
 
 ## Local Commands
 
-- Build: `bun run build`
-- Dev: `bun run dev`
-- Test: `bun test`
-- Typecheck: `bun run typecheck`
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @contractspec/example.learning-journey-quest-challenges
 
+## 3.7.10
+
+### Patch Changes
+
+- 1a44cb6: feat: improve examples to increase coverage of Contracts type
+- Updated dependencies [1a44cb6]
+  - @contractspec/module.learning-journey@3.7.10
+  - @contractspec/lib.contracts-spec@4.1.2
+
+## 3.7.9
+
+### Patch Changes
+
+- fix: release
+- Updated dependencies
+  - @contractspec/module.learning-journey@3.7.9
+  - @contractspec/lib.contracts-spec@4.1.1
+
 ## 3.7.6
 
 ### Patch Changes
@@ -708,14 +726,17 @@
   feat: Contract layers support (features, examples, app-configs)
 
   ### New CLI Commands
+
   - `contractspec list layers` - List all contract layers with filtering
 
   ### Enhanced Commands
+
   - `contractspec ci` - New `layers` check category validates features/examples/config
   - `contractspec doctor` - New `layers` health checks
   - `contractspec integrity` - Now shows layer statistics
 
   ### New APIs
+
   - `discoverLayers()` - Scan workspace for all layer files
   - `scanExampleSource()` - Parse ExampleSpec from source code
   - `isExampleFile()` - Check if file is an example spec

package/README.md

@@ -1,30 +1,69 @@
 # @contractspec/example.learning-journey-quest-challenges
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
+**Time-bound quest/challenge learning journey example.**
 
-Time-bound challenge/quest example (7-day money reset) showing day-based unlocks and event-driven completion.
+## What This Demonstrates
 
-## What it shows
+- Quest/challenge track with time-bound objectives.
+- Completion tracking and deadline enforcement.
+- Lightweight track + example pattern.
+- Integration with the learning-journey module.
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/docs/` contains docblocks and documentation-facing exports.
 
-- 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
+## Running Locally
 
-## How to run
+From `packages/examples/learning-journey-quest-challenges`:
+- `bun run dev`
+- `bun run build`
+- `bun run test`
+- `bun run typecheck`
 
-1. `bun test packages/examples/learning-journey-quest-challenges`
-2. Emit events in order with `recordEvent` from the registry:
+## Usage
 
-```ts
-recordEvent({ name: 'accounts.mapped', learnerId: 'u1' });
-recordEvent({ name: 'transactions.categorized', learnerId: 'u1' });
-// ...
-```
+Use `@contractspec/example.learning-journey-quest-challenges` as a reference implementation, or import its exported surfaces into a workspace that composes ContractSpec examples and bundles.
 
-## Adapting
+## Architecture
 
-- 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.
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/learning-journey-quest-challenges.feature.ts` defines a feature entrypoint.
+- `src/track.test.ts` is part of the package's public or composition surface.
+- `src/track.ts` is part of the package's public or composition surface.
+
+## Public Entry Points
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/quest-challenges.docblock` resolves through `./src/docs/quest-challenges.docblock.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./learning-journey-quest-challenges.feature` resolves through `./src/learning-journey-quest-challenges.feature.ts`.
+- Export `./track` resolves through `./src/track.ts`.
+
+## Local Commands
+
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
+
+## Recent Updates
+
+- Replace eslint+prettier by biomejs to optimize speed.
+- Missing contract layers.
+
+## Notes
+
+- Works alongside `@contractspec/lib.contracts-spec`, `@contractspec/module.learning-journey`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.

package/dist/browser/index.js

@@ -61,6 +61,22 @@ var example = defineExample({
 });
 var example_default = example;
 
+// src/learning-journey-quest-challenges.feature.ts
+import { defineFeature } from "@contractspec/lib.contracts-spec";
+var LearningJourneyQuestChallengesFeature = defineFeature({
+  meta: {
+    key: "learning-journey-quest-challenges",
+    version: "1.0.0",
+    title: "Learning Journey: Quest Challenges",
+    description: "Quest and challenge-based learning with deadlines and completion tracking",
+    domain: "learning-journey",
+    owners: ["@examples"],
+    tags: ["learning", "quests", "challenges", "gamification"],
+    stability: "experimental"
+  },
+  docs: ["docs.learning-journey.quest-challenges"]
+});
+
 // src/track.ts
 var dayStep = (id, day, eventName, description) => ({
   id,
@@ -93,22 +109,6 @@ var moneyResetQuestTrack = {
   ]
 };
 var questTracks = [moneyResetQuestTrack];
-
-// src/learning-journey-quest-challenges.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var LearningJourneyQuestChallengesFeature = defineFeature({
-  meta: {
-    key: "learning-journey-quest-challenges",
-    version: "1.0.0",
-    title: "Learning Journey: Quest Challenges",
-    description: "Quest and challenge-based learning with deadlines and completion tracking",
-    domain: "learning-journey",
-    owners: ["@examples"],
-    tags: ["learning", "quests", "challenges", "gamification"],
-    stability: "experimental"
-  },
-  docs: ["docs.learning-journey.quest-challenges"]
-});
 export {
   questTracks,
   moneyResetQuestTrack,

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export * from './track';
-export * from './learning-journey-quest-challenges.feature';
 export { default as example } from './example';
+export * from './learning-journey-quest-challenges.feature';
+export * from './track';
 import './docs';

package/dist/index.js

@@ -62,6 +62,22 @@ var example = defineExample({
 });
 var example_default = example;
 
+// src/learning-journey-quest-challenges.feature.ts
+import { defineFeature } from "@contractspec/lib.contracts-spec";
+var LearningJourneyQuestChallengesFeature = defineFeature({
+  meta: {
+    key: "learning-journey-quest-challenges",
+    version: "1.0.0",
+    title: "Learning Journey: Quest Challenges",
+    description: "Quest and challenge-based learning with deadlines and completion tracking",
+    domain: "learning-journey",
+    owners: ["@examples"],
+    tags: ["learning", "quests", "challenges", "gamification"],
+    stability: "experimental"
+  },
+  docs: ["docs.learning-journey.quest-challenges"]
+});
+
 // src/track.ts
 var dayStep = (id, day, eventName, description) => ({
   id,
@@ -94,22 +110,6 @@ var moneyResetQuestTrack = {
   ]
 };
 var questTracks = [moneyResetQuestTrack];
-
-// src/learning-journey-quest-challenges.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var LearningJourneyQuestChallengesFeature = defineFeature({
-  meta: {
-    key: "learning-journey-quest-challenges",
-    version: "1.0.0",
-    title: "Learning Journey: Quest Challenges",
-    description: "Quest and challenge-based learning with deadlines and completion tracking",
-    domain: "learning-journey",
-    owners: ["@examples"],
-    tags: ["learning", "quests", "challenges", "gamification"],
-    stability: "experimental"
-  },
-  docs: ["docs.learning-journey.quest-challenges"]
-});
 export {
   questTracks,
   moneyResetQuestTrack,

package/dist/node/index.js

@@ -61,6 +61,22 @@ var example = defineExample({
 });
 var example_default = example;
 
+// src/learning-journey-quest-challenges.feature.ts
+import { defineFeature } from "@contractspec/lib.contracts-spec";
+var LearningJourneyQuestChallengesFeature = defineFeature({
+  meta: {
+    key: "learning-journey-quest-challenges",
+    version: "1.0.0",
+    title: "Learning Journey: Quest Challenges",
+    description: "Quest and challenge-based learning with deadlines and completion tracking",
+    domain: "learning-journey",
+    owners: ["@examples"],
+    tags: ["learning", "quests", "challenges", "gamification"],
+    stability: "experimental"
+  },
+  docs: ["docs.learning-journey.quest-challenges"]
+});
+
 // src/track.ts
 var dayStep = (id, day, eventName, description) => ({
   id,
@@ -93,22 +109,6 @@ var moneyResetQuestTrack = {
   ]
 };
 var questTracks = [moneyResetQuestTrack];
-
-// src/learning-journey-quest-challenges.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var LearningJourneyQuestChallengesFeature = defineFeature({
-  meta: {
-    key: "learning-journey-quest-challenges",
-    version: "1.0.0",
-    title: "Learning Journey: Quest Challenges",
-    description: "Quest and challenge-based learning with deadlines and completion tracking",
-    domain: "learning-journey",
-    owners: ["@examples"],
-    tags: ["learning", "quests", "challenges", "gamification"],
-    stability: "experimental"
-  },
-  docs: ["docs.learning-journey.quest-challenges"]
-});
 export {
   questTracks,
   moneyResetQuestTrack,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.learning-journey-quest-challenges",
-  "version": "3.7.6",
+  "version": "3.7.10",
   "description": "Time-bound quest/challenge learning journey example.",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -57,20 +57,20 @@
     "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
-    "lint:fix": "eslint src --fix",
-    "lint:check": "eslint src",
+    "lint:fix": "biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .",
+    "lint:check": "biome check .",
     "test": "bun test",
     "prebuild": "contractspec-bun-build prebuild",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/module.learning-journey": "3.7.6",
-    "@contractspec/lib.contracts-spec": "3.7.6"
+    "@contractspec/module.learning-journey": "3.7.10",
+    "@contractspec/lib.contracts-spec": "4.1.2"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.6",
+    "@contractspec/tool.typescript": "3.7.8",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.7.6"
+    "@contractspec/tool.bun": "3.7.8"
   },
   "publishConfig": {
     "exports": {

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

@@ -2,16 +2,16 @@ import type { DocBlock } from '@contractspec/lib.contracts-spec/docs';
 import { registerDocBlocks } from '@contractspec/lib.contracts-spec/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
+	{
+		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
 
@@ -30,7 +30,7 @@ XP: 15 per day, completion bonus 30 if finished within duration. Optional recap
 - 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

@@ -1,31 +1,31 @@
 import { defineExample } from '@contractspec/lib.contracts-spec';
 
 const example = defineExample({
-  meta: {
-    key: 'learning-journey-quest-challenges',
-    version: '1.0.0',
-    title: 'Learning Journey — Quest Challenges',
-    description:
-      'Quest/challenge pattern: multi-step goals with progress events, rewards, and streak hooks.',
-    kind: 'template',
-    visibility: 'public',
-    stability: 'experimental',
-    owners: ['@platform.core'],
-    tags: ['learning', 'quests', 'challenges'],
-  },
-  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 },
-  },
+	meta: {
+		key: 'learning-journey-quest-challenges',
+		version: '1.0.0',
+		title: 'Learning Journey — Quest Challenges',
+		description:
+			'Quest/challenge pattern: multi-step goals with progress events, rewards, and streak hooks.',
+		kind: 'template',
+		visibility: 'public',
+		stability: 'experimental',
+		owners: ['@platform.core'],
+		tags: ['learning', 'quests', 'challenges'],
+	},
+	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 },
+	},
 });
 
 export default example;

package/src/index.ts

@@ -1,4 +1,4 @@
-export * from './track';
-export * from './learning-journey-quest-challenges.feature';
 export { default as example } from './example';
+export * from './learning-journey-quest-challenges.feature';
+export * from './track';
 import './docs';

package/src/learning-journey-quest-challenges.feature.ts

@@ -1,17 +1,17 @@
 import { defineFeature } from '@contractspec/lib.contracts-spec';
 
 export const LearningJourneyQuestChallengesFeature = defineFeature({
-  meta: {
-    key: 'learning-journey-quest-challenges',
-    version: '1.0.0',
-    title: 'Learning Journey: Quest Challenges',
-    description:
-      'Quest and challenge-based learning with deadlines and completion tracking',
-    domain: 'learning-journey',
-    owners: ['@examples'],
-    tags: ['learning', 'quests', 'challenges', 'gamification'],
-    stability: 'experimental',
-  },
+	meta: {
+		key: 'learning-journey-quest-challenges',
+		version: '1.0.0',
+		title: 'Learning Journey: Quest Challenges',
+		description:
+			'Quest and challenge-based learning with deadlines and completion tracking',
+		domain: 'learning-journey',
+		owners: ['@examples'],
+		tags: ['learning', 'quests', 'challenges', 'gamification'],
+		stability: 'experimental',
+	},
 
-  docs: ['docs.learning-journey.quest-challenges'],
+	docs: ['docs.learning-journey.quest-challenges'],
 });

package/src/track.test.ts

@@ -3,50 +3,50 @@ import { describe, expect, it } from 'bun:test';
 import { moneyResetQuestTrack } from './track';
 
 const addDays = (date: Date, days: number) =>
-  new Date(date.getTime() + days * 24 * 60 * 60 * 1000);
+	new Date(date.getTime() + days * 24 * 60 * 60 * 1000);
 
 type StepStatus = 'PENDING' | 'COMPLETED';
 
 describe('quest challenges track', () => {
-  it('unlocks by day and completes within window', () => {
-    const start = new Date('2024-01-01T09:00:00Z');
-    const events = [
-      { name: 'accounts.mapped', dayOffset: 0 },
-      { name: 'transactions.categorized', dayOffset: 1 },
-      { name: 'goals.created', dayOffset: 2 },
-      { name: 'recurring_rule.created', dayOffset: 3 },
-      { name: 'subscription.flagged_or_cancelled', dayOffset: 4 },
-      { name: 'emergency_plan.completed', dayOffset: 5 },
-      { name: 'quest.review.completed', dayOffset: 6 },
-    ];
+	it('unlocks by day and completes within window', () => {
+		const start = new Date('2024-01-01T09:00:00Z');
+		const events = [
+			{ name: 'accounts.mapped', dayOffset: 0 },
+			{ name: 'transactions.categorized', dayOffset: 1 },
+			{ name: 'goals.created', dayOffset: 2 },
+			{ name: 'recurring_rule.created', dayOffset: 3 },
+			{ name: 'subscription.flagged_or_cancelled', dayOffset: 4 },
+			{ name: 'emergency_plan.completed', dayOffset: 5 },
+			{ name: 'quest.review.completed', dayOffset: 6 },
+		];
 
-    const progress = moneyResetQuestTrack.steps.map((step) => ({
-      id: step.id,
-      status: 'PENDING' as StepStatus,
-    }));
+		const progress = moneyResetQuestTrack.steps.map((step) => ({
+			id: step.id,
+			status: 'PENDING' as StepStatus,
+		}));
 
-    events.forEach((evt) => {
-      const now = addDays(start, evt.dayOffset);
-      moneyResetQuestTrack.steps.forEach((spec, idx) => {
-        const step = progress[idx];
-        if (!step || step.status === 'COMPLETED') return;
-        const availableAt =
-          spec.availability?.unlockOnDay !== undefined
-            ? addDays(start, spec.availability.unlockOnDay - 1)
-            : start;
-        if (now < availableAt) return;
-        const within =
-          spec.completion.kind === 'time_window' &&
-          spec.completion.withinHoursOfStart !== undefined
-            ? (now.getTime() - start.getTime()) / (1000 * 60 * 60) <=
-              spec.completion.withinHoursOfStart
-            : true;
-        if (!within) return;
-        if (spec.completion.eventName !== evt.name) return;
-        step.status = 'COMPLETED';
-      });
-    });
+		events.forEach((evt) => {
+			const now = addDays(start, evt.dayOffset);
+			moneyResetQuestTrack.steps.forEach((spec, idx) => {
+				const step = progress[idx];
+				if (!step || step.status === 'COMPLETED') return;
+				const availableAt =
+					spec.availability?.unlockOnDay !== undefined
+						? addDays(start, spec.availability.unlockOnDay - 1)
+						: start;
+				if (now < availableAt) return;
+				const within =
+					spec.completion.kind === 'time_window' &&
+					spec.completion.withinHoursOfStart !== undefined
+						? (now.getTime() - start.getTime()) / (1000 * 60 * 60) <=
+							spec.completion.withinHoursOfStart
+						: true;
+				if (!within) return;
+				if (spec.completion.eventName !== evt.name) return;
+				step.status = 'COMPLETED';
+			});
+		});
 
-    expect(progress.every((s) => s.status === 'COMPLETED')).toBeTrue();
-  });
+		expect(progress.every((s) => s.status === 'COMPLETED')).toBeTrue();
+	});
 });

package/src/track.ts

@@ -1,76 +1,76 @@
 import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';
 
 const dayStep = (
-  id: string,
-  day: number,
-  eventName: string,
-  description: string
+	id: string,
+	day: number,
+	eventName: string,
+	description: string
 ): LearningJourneyTrackSpec['steps'][number] => ({
-  id,
-  title: `Day ${day}`,
-  description,
-  availability: { unlockOnDay: day },
-  completion: {
-    kind: 'time_window',
-    eventName,
-    withinHoursOfStart: (day + 1) * 24, // allow grace through next day
-  },
-  xpReward: 15,
-  metadata: { day },
+	id,
+	title: `Day ${day}`,
+	description,
+	availability: { unlockOnDay: day },
+	completion: {
+		kind: 'time_window',
+		eventName,
+		withinHoursOfStart: (day + 1) * 24, // allow grace through next day
+	},
+	xpReward: 15,
+	metadata: { day },
 });
 
 export const moneyResetQuestTrack: LearningJourneyTrackSpec = {
-  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.'
-    ),
-  ],
+	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.'
+		),
+	],
 };
 
 export const questTracks: LearningJourneyTrackSpec[] = [moneyResetQuestTrack];

package/tsconfig.json

@@ -1,9 +1,9 @@
 {
-  "extends": "@contractspec/tool.typescript/react-library.json",
-  "include": ["src"],
-  "exclude": ["node_modules"],
-  "compilerOptions": {
-    "rootDir": "src",
-    "outDir": "dist"
-  }
+	"extends": "@contractspec/tool.typescript/react-library.json",
+	"include": ["src"],
+	"exclude": ["node_modules"],
+	"compilerOptions": {
+		"rootDir": "src",
+		"outDir": "dist"
+	}
 }

package/tsdown.config.js

@@ -1,16 +1,10 @@
-import { defineConfig, moduleLibrary, withDevExports } from '@contractspec/tool.bun';
+import {
+	defineConfig,
+	moduleLibrary,
+	withDevExports,
+} from '@contractspec/tool.bun';
 
 export default defineConfig(() => ({
-  ...moduleLibrary,
-  ...withDevExports,
+	...moduleLibrary,
+	...withDevExports,
 }));
-
-
-
-
-
-
-
-
-
-