@contractspec/example.learning-journey-duo-drills 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 28ms
+Bundled 6 modules in 23ms
 
   docs/duo-drills.docblock.js               1.45 KB  (entry point)
   ./index.js                                4.78 KB  (entry point)
@@ -13,7 +13,7 @@ Bundled 6 modules in 28ms
   ./track.js                                1.80 KB  (entry point)
 
 [contractspec-bun-build] transpile target=node root=src entries=6 noBundle=false
-Bundled 6 modules in 36ms
+Bundled 6 modules in 20ms
 
   docs/duo-drills.docblock.js               1.43 KB  (entry point)
   ./index.js                                4.76 KB  (entry point)
@@ -23,7 +23,7 @@ Bundled 6 modules in 36ms
   ./track.js                                1.79 KB  (entry point)
 
 [contractspec-bun-build] transpile target=browser root=src entries=6 noBundle=false
-Bundled 6 modules in 53ms
+Bundled 6 modules in 14ms
 
   docs/duo-drills.docblock.js               1.43 KB  (entry point)
   ./index.js                                4.76 KB  (entry point)

package/AGENTS.md

@@ -1,31 +1,53 @@
-# AI Agent Guide -- `@contractspec/example.learning-journey-duo-drills`
+# AI Agent Guide — `@contractspec/example.learning-journey-duo-drills`
 
 Scope: `packages/examples/learning-journey-duo-drills/*`
 
-Demonstrates drill-based learning with spaced repetition (SRS), XP rewards, and streak hooks.
+Drill-based learning journey example with SRS, XP, and streak hooks.
 
 ## 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
 
-- Drill-based learning track with SRS scheduling
-- XP and streak gamification hooks
-- 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-duo-drills.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` -- duo drills track definition
+- Export `.` resolves through `./src/index.ts`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/duo-drills.docblock` resolves through `./src/docs/duo-drills.docblock.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./learning-journey-duo-drills.feature` resolves through `./src/learning-journey-duo-drills.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-duo-drills
 
+## 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,41 +1,69 @@
 # @contractspec/example.learning-journey-duo-drills
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
+**Drill-based learning journey example with SRS, XP, and streak hooks.**
 
-Drill-based learning journey example that demonstrates short SRS-driven drills, XP, and streak hooks. Tracks are defined in `src/track.ts` and can be reused for language, finance, or ContractSpec concept drills.
+## What This Demonstrates
 
-## What it shows
+- Drill-based learning track with SRS scheduling.
+- XP and streak gamification hooks.
+- 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.
 
-- Event-driven steps (`drill.session.completed`, `drill.card.mastered`)
-- Count-based completion (reach accuracy threshold across multiple sessions)
-- SRS mastery-based completion (master N cards in a skill)
-- XP per card/session and daily streak (via registry progress logic)
+## Running Locally
 
-## How to run
+From `packages/examples/learning-journey-duo-drills`:
+- `bun run dev`
+- `bun run build`
+- `bun run test`
+- `bun run typecheck`
 
-1. Build dependencies: `bun install`
-2. Run tests: `bun test packages/examples/learning-journey-duo-drills`
-3. Use the registry helper to emit events:
+## Usage
 
-```ts
-import {
-  recordEvent,
-  getProgress,
-} from '@contractspec/example.learning-journey-registry/api';
-import { drillTracks } from '@contractspec/example.learning-journey-duo-drills/track';
+Use `@contractspec/example.learning-journey-duo-drills` as a reference implementation, or import its exported surfaces into a workspace that composes ContractSpec examples and bundles.
 
-recordEvent({
-  name: 'drill.session.completed',
-  learnerId: 'u1',
-  payload: { accuracyBucket: 'high' },
-});
-// ...
-const progress = getProgress('drills_language_basics', 'u1');
-```
+## Architecture
 
-## Adapting
+- `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-duo-drills.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.
 
-- Swap skills/cards to represent language vocab, budgeting basics, or ContractSpec concepts.
-- Tune count thresholds, mastery requirements, and XP rewards per step.
-- Wire real drill events into the registry or your own progression handler.
+## Public Entry Points
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/duo-drills.docblock` resolves through `./src/docs/duo-drills.docblock.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./learning-journey-duo-drills.feature` resolves through `./src/learning-journey-duo-drills.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

@@ -58,6 +58,22 @@ var example = defineExample({
 });
 var example_default = example;
 
+// src/learning-journey-duo-drills.feature.ts
+import { defineFeature } from "@contractspec/lib.contracts-spec";
+var LearningJourneyDuoDrillsFeature = defineFeature({
+  meta: {
+    key: "learning-journey-duo-drills",
+    version: "1.0.0",
+    title: "Learning Journey: Duo Drills",
+    description: "Drill-based learning with spaced repetition, XP, and streaks",
+    domain: "learning-journey",
+    owners: ["@examples"],
+    tags: ["learning", "drills", "srs", "gamification"],
+    stability: "experimental"
+  },
+  docs: ["docs.learning-journey.duo-drills"]
+});
+
 // src/track.ts
 var drillsLanguageBasicsTrack = {
   id: "drills_language_basics",
@@ -116,22 +132,6 @@ var drillsLanguageBasicsTrack = {
 var drillTracks = [
   drillsLanguageBasicsTrack
 ];
-
-// src/learning-journey-duo-drills.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var LearningJourneyDuoDrillsFeature = defineFeature({
-  meta: {
-    key: "learning-journey-duo-drills",
-    version: "1.0.0",
-    title: "Learning Journey: Duo Drills",
-    description: "Drill-based learning with spaced repetition, XP, and streaks",
-    domain: "learning-journey",
-    owners: ["@examples"],
-    tags: ["learning", "drills", "srs", "gamification"],
-    stability: "experimental"
-  },
-  docs: ["docs.learning-journey.duo-drills"]
-});
 export {
   example_default as example,
   drillsLanguageBasicsTrack,

package/dist/index.d.ts

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

package/dist/index.js

@@ -59,6 +59,22 @@ var example = defineExample({
 });
 var example_default = example;
 
+// src/learning-journey-duo-drills.feature.ts
+import { defineFeature } from "@contractspec/lib.contracts-spec";
+var LearningJourneyDuoDrillsFeature = defineFeature({
+  meta: {
+    key: "learning-journey-duo-drills",
+    version: "1.0.0",
+    title: "Learning Journey: Duo Drills",
+    description: "Drill-based learning with spaced repetition, XP, and streaks",
+    domain: "learning-journey",
+    owners: ["@examples"],
+    tags: ["learning", "drills", "srs", "gamification"],
+    stability: "experimental"
+  },
+  docs: ["docs.learning-journey.duo-drills"]
+});
+
 // src/track.ts
 var drillsLanguageBasicsTrack = {
   id: "drills_language_basics",
@@ -117,22 +133,6 @@ var drillsLanguageBasicsTrack = {
 var drillTracks = [
   drillsLanguageBasicsTrack
 ];
-
-// src/learning-journey-duo-drills.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var LearningJourneyDuoDrillsFeature = defineFeature({
-  meta: {
-    key: "learning-journey-duo-drills",
-    version: "1.0.0",
-    title: "Learning Journey: Duo Drills",
-    description: "Drill-based learning with spaced repetition, XP, and streaks",
-    domain: "learning-journey",
-    owners: ["@examples"],
-    tags: ["learning", "drills", "srs", "gamification"],
-    stability: "experimental"
-  },
-  docs: ["docs.learning-journey.duo-drills"]
-});
 export {
   example_default as example,
   drillsLanguageBasicsTrack,

package/dist/node/index.js

@@ -58,6 +58,22 @@ var example = defineExample({
 });
 var example_default = example;
 
+// src/learning-journey-duo-drills.feature.ts
+import { defineFeature } from "@contractspec/lib.contracts-spec";
+var LearningJourneyDuoDrillsFeature = defineFeature({
+  meta: {
+    key: "learning-journey-duo-drills",
+    version: "1.0.0",
+    title: "Learning Journey: Duo Drills",
+    description: "Drill-based learning with spaced repetition, XP, and streaks",
+    domain: "learning-journey",
+    owners: ["@examples"],
+    tags: ["learning", "drills", "srs", "gamification"],
+    stability: "experimental"
+  },
+  docs: ["docs.learning-journey.duo-drills"]
+});
+
 // src/track.ts
 var drillsLanguageBasicsTrack = {
   id: "drills_language_basics",
@@ -116,22 +132,6 @@ var drillsLanguageBasicsTrack = {
 var drillTracks = [
   drillsLanguageBasicsTrack
 ];
-
-// src/learning-journey-duo-drills.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var LearningJourneyDuoDrillsFeature = defineFeature({
-  meta: {
-    key: "learning-journey-duo-drills",
-    version: "1.0.0",
-    title: "Learning Journey: Duo Drills",
-    description: "Drill-based learning with spaced repetition, XP, and streaks",
-    domain: "learning-journey",
-    owners: ["@examples"],
-    tags: ["learning", "drills", "srs", "gamification"],
-    stability: "experimental"
-  },
-  docs: ["docs.learning-journey.duo-drills"]
-});
 export {
   example_default as example,
   drillsLanguageBasicsTrack,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.learning-journey-duo-drills",
-  "version": "3.7.6",
+  "version": "3.7.10",
   "description": "Drill-based learning journey example with SRS, XP, and streak hooks.",
   "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/duo-drills.docblock.ts

@@ -2,16 +2,16 @@ import type { DocBlock } from '@contractspec/lib.contracts-spec/docs';
 import { registerDocBlocks } from '@contractspec/lib.contracts-spec/docs';
 
 const duoDrillsDocBlocks: DocBlock[] = [
-  {
-    id: 'docs.learning-journey.duo-drills',
-    title: 'Learning Journey — Duo Drills',
-    summary:
-      'Short drill/SRS example with XP and streak hooks for language, finance, or ContractSpec concept drills.',
-    kind: 'reference',
-    visibility: 'public',
-    route: '/docs/learning-journey/duo-drills',
-    tags: ['learning', 'drills', 'srs', 'xp'],
-    body: `## Track
+	{
+		id: 'docs.learning-journey.duo-drills',
+		title: 'Learning Journey — Duo Drills',
+		summary:
+			'Short drill/SRS example with XP and streak hooks for language, finance, or ContractSpec concept drills.',
+		kind: 'reference',
+		visibility: 'public',
+		route: '/docs/learning-journey/duo-drills',
+		tags: ['learning', 'drills', 'srs', 'xp'],
+		body: `## Track
 - **Key**: \`drills_language_basics\`
 - **Persona**: learner running quick drills (language/finance/spec concepts)
 - **Goal**: complete first session, maintain high-accuracy sessions, master cards in the first skill
@@ -27,7 +27,7 @@ XP: 20 + 30 + 40. Streak: daily session completion can be used to drive streak r
 - Tracks export from \`@contractspec/example.learning-journey-duo-drills/track\`.
 - Use registry helper \`recordEvent\` to advance steps from drill/session events.
 - SRS mastery events should include payload: \`{ skillId, mastery }\`.`,
-  },
+	},
 ];
 
 registerDocBlocks(duoDrillsDocBlocks);

package/src/example.ts

@@ -1,31 +1,31 @@
 import { defineExample } from '@contractspec/lib.contracts-spec';
 
 const example = defineExample({
-  meta: {
-    key: 'learning-journey-duo-drills',
-    version: '1.0.0',
-    title: 'Learning Journey — Duo Drills',
-    description:
-      'Short drill/SRS example with XP and streak hooks for language, finance, or ContractSpec concept drills.',
-    kind: 'template',
-    visibility: 'public',
-    stability: 'experimental',
-    owners: ['@platform.core'],
-    tags: ['learning', 'drills', 'srs', 'xp'],
-  },
-  docs: {
-    rootDocId: 'docs.learning-journey.duo-drills',
-  },
-  entrypoints: {
-    packageName: '@contractspec/example.learning-journey-duo-drills',
-    docs: './docs',
-  },
-  surfaces: {
-    templates: true,
-    sandbox: { enabled: true, modes: ['playground', 'markdown'] },
-    studio: { enabled: true, installable: true },
-    mcp: { enabled: true },
-  },
+	meta: {
+		key: 'learning-journey-duo-drills',
+		version: '1.0.0',
+		title: 'Learning Journey — Duo Drills',
+		description:
+			'Short drill/SRS example with XP and streak hooks for language, finance, or ContractSpec concept drills.',
+		kind: 'template',
+		visibility: 'public',
+		stability: 'experimental',
+		owners: ['@platform.core'],
+		tags: ['learning', 'drills', 'srs', 'xp'],
+	},
+	docs: {
+		rootDocId: 'docs.learning-journey.duo-drills',
+	},
+	entrypoints: {
+		packageName: '@contractspec/example.learning-journey-duo-drills',
+		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-duo-drills.feature';
 export { default as example } from './example';
+export * from './learning-journey-duo-drills.feature';
+export * from './track';
 import './docs';

package/src/learning-journey-duo-drills.feature.ts

@@ -1,16 +1,16 @@
 import { defineFeature } from '@contractspec/lib.contracts-spec';
 
 export const LearningJourneyDuoDrillsFeature = defineFeature({
-  meta: {
-    key: 'learning-journey-duo-drills',
-    version: '1.0.0',
-    title: 'Learning Journey: Duo Drills',
-    description: 'Drill-based learning with spaced repetition, XP, and streaks',
-    domain: 'learning-journey',
-    owners: ['@examples'],
-    tags: ['learning', 'drills', 'srs', 'gamification'],
-    stability: 'experimental',
-  },
+	meta: {
+		key: 'learning-journey-duo-drills',
+		version: '1.0.0',
+		title: 'Learning Journey: Duo Drills',
+		description: 'Drill-based learning with spaced repetition, XP, and streaks',
+		domain: 'learning-journey',
+		owners: ['@examples'],
+		tags: ['learning', 'drills', 'srs', 'gamification'],
+		stability: 'experimental',
+	},
 
-  docs: ['docs.learning-journey.duo-drills'],
+	docs: ['docs.learning-journey.duo-drills'],
 });

package/src/track.test.ts

@@ -3,104 +3,104 @@ import { describe, expect, it } from 'bun:test';
 import { drillsLanguageBasicsTrack } from './track';
 
 interface TestEvent {
-  name: string;
-  payload?: Record<string, unknown>;
-  occurredAt?: Date;
+	name: string;
+	payload?: Record<string, unknown>;
+	occurredAt?: Date;
 }
 
 const matchesFilter = (
-  filter: Record<string, unknown> | undefined,
-  payload: Record<string, unknown> | undefined
+	filter: Record<string, unknown> | undefined,
+	payload: Record<string, unknown> | undefined
 ) => {
-  if (!filter) return true;
-  if (!payload) return false;
-  return Object.entries(filter).every(([key, value]) => payload[key] === value);
+	if (!filter) return true;
+	if (!payload) return false;
+	return Object.entries(filter).every(([key, value]) => payload[key] === value);
 };
 
 interface StepState {
-  id: string;
-  status: 'PENDING' | 'COMPLETED';
-  occurrences: number;
-  masteryCount: number;
+	id: string;
+	status: 'PENDING' | 'COMPLETED';
+	occurrences: number;
+	masteryCount: number;
 }
 
 describe('duo drills track', () => {
-  it('advances on session completion, accuracy counts, and SRS mastery', () => {
-    const events: TestEvent[] = [
-      {
-        name: 'drill.session.completed',
-        payload: { accuracyBucket: 'high' },
-      },
-      {
-        name: 'drill.session.completed',
-        payload: { accuracyBucket: 'high' },
-      },
-      {
-        name: 'drill.session.completed',
-        payload: { accuracyBucket: 'high' },
-      },
-      ...Array.from({ length: 5 }).map<TestEvent>(() => ({
-        name: 'drill.card.mastered',
-        payload: { skillId: 'language_basics', mastery: 0.9 },
-      })),
-    ];
+	it('advances on session completion, accuracy counts, and SRS mastery', () => {
+		const events: TestEvent[] = [
+			{
+				name: 'drill.session.completed',
+				payload: { accuracyBucket: 'high' },
+			},
+			{
+				name: 'drill.session.completed',
+				payload: { accuracyBucket: 'high' },
+			},
+			{
+				name: 'drill.session.completed',
+				payload: { accuracyBucket: 'high' },
+			},
+			...Array.from({ length: 5 }).map<TestEvent>(() => ({
+				name: 'drill.card.mastered',
+				payload: { skillId: 'language_basics', mastery: 0.9 },
+			})),
+		];
 
-    const progress: StepState[] =
-      drillsLanguageBasicsTrack.steps.map<StepState>((step) => ({
-        id: step.id,
-        status: 'PENDING',
-        occurrences: 0,
-        masteryCount: 0,
-      }));
+		const progress: StepState[] =
+			drillsLanguageBasicsTrack.steps.map<StepState>((step) => ({
+				id: step.id,
+				status: 'PENDING',
+				occurrences: 0,
+				masteryCount: 0,
+			}));
 
-    events.forEach((event) => {
-      drillsLanguageBasicsTrack.steps.forEach((stepSpec, index) => {
-        const step = progress[index];
-        if (!step || step.status === 'COMPLETED') return;
-        const completion = stepSpec.completion;
-        if ((completion.kind ?? 'event') === 'event') {
-          if (completion.eventName !== event.name) return;
-          if (
-            matchesFilter(
-              completion.payloadFilter,
-              event.payload as Record<string, unknown> | undefined
-            )
-          ) {
-            step.status = 'COMPLETED';
-          }
-          return;
-        }
-        if (completion.kind === 'count') {
-          if (
-            completion.eventName === event.name &&
-            matchesFilter(
-              completion.payloadFilter,
-              event.payload as Record<string, unknown> | undefined
-            )
-          ) {
-            step.occurrences = step.occurrences + 1;
-            if (step.occurrences >= completion.atLeast) {
-              step.status = 'COMPLETED';
-            }
-          }
-          return;
-        }
-        if (completion.kind === 'srs_mastery') {
-          if (completion.eventName !== event.name) return;
-          if (!matchesFilter(completion.payloadFilter, event.payload)) return;
-          const masteryValue = (
-            event.payload as Record<string, unknown> | undefined
-          )?.[completion.masteryField ?? 'mastery'];
-          if (typeof masteryValue !== 'number') return;
-          if (masteryValue < completion.minimumMastery) return;
-          step.masteryCount = step.masteryCount + 1;
-          if (step.masteryCount >= (completion.requiredCount ?? 1)) {
-            step.status = 'COMPLETED';
-          }
-        }
-      });
-    });
+		events.forEach((event) => {
+			drillsLanguageBasicsTrack.steps.forEach((stepSpec, index) => {
+				const step = progress[index];
+				if (!step || step.status === 'COMPLETED') return;
+				const completion = stepSpec.completion;
+				if ((completion.kind ?? 'event') === 'event') {
+					if (completion.eventName !== event.name) return;
+					if (
+						matchesFilter(
+							completion.payloadFilter,
+							event.payload as Record<string, unknown> | undefined
+						)
+					) {
+						step.status = 'COMPLETED';
+					}
+					return;
+				}
+				if (completion.kind === 'count') {
+					if (
+						completion.eventName === event.name &&
+						matchesFilter(
+							completion.payloadFilter,
+							event.payload as Record<string, unknown> | undefined
+						)
+					) {
+						step.occurrences = step.occurrences + 1;
+						if (step.occurrences >= completion.atLeast) {
+							step.status = 'COMPLETED';
+						}
+					}
+					return;
+				}
+				if (completion.kind === 'srs_mastery') {
+					if (completion.eventName !== event.name) return;
+					if (!matchesFilter(completion.payloadFilter, event.payload)) return;
+					const masteryValue = (
+						event.payload as Record<string, unknown> | undefined
+					)?.[completion.masteryField ?? 'mastery'];
+					if (typeof masteryValue !== 'number') return;
+					if (masteryValue < completion.minimumMastery) return;
+					step.masteryCount = step.masteryCount + 1;
+					if (step.masteryCount >= (completion.requiredCount ?? 1)) {
+						step.status = 'COMPLETED';
+					}
+				}
+			});
+		});
 
-    expect(progress.every((s) => s.status === 'COMPLETED')).toBeTrue();
-  });
+		expect(progress.every((s) => s.status === 'COMPLETED')).toBeTrue();
+	});
 });

package/src/track.ts

@@ -1,62 +1,62 @@
 import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';
 
 export const drillsLanguageBasicsTrack: LearningJourneyTrackSpec = {
-  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: 0.8,
-        requiredCount: 5,
-        skillIdField: 'skillId',
-        masteryField: 'mastery',
-        payloadFilter: { skillId: 'language_basics' },
-      },
-      xpReward: 40,
-      metadata: { surface: 'srs', skill: 'language_basics' },
-    },
-  ],
+	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: 0.8,
+				requiredCount: 5,
+				skillIdField: 'skillId',
+				masteryField: 'mastery',
+				payloadFilter: { skillId: 'language_basics' },
+			},
+			xpReward: 40,
+			metadata: { surface: 'srs', skill: 'language_basics' },
+		},
+	],
 };
 
 export const drillTracks: LearningJourneyTrackSpec[] = [
-  drillsLanguageBasicsTrack,
+	drillsLanguageBasicsTrack,
 ];

package/tsconfig.json

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