@contractspec/example.learning-patterns 3.7.5 → 3.7.7

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=10 noBundle=false
-Bundled 10 modules in 27ms
+Bundled 10 modules in 47ms
 
   docs/index.js                        1.15 KB    (entry point)
   ./index.js                           6.53 KB    (entry point)
@@ -17,7 +17,7 @@ Bundled 10 modules in 27ms
   ./events.js                          496 bytes  (entry point)
 
 [contractspec-bun-build] transpile target=node root=src entries=10 noBundle=false
-Bundled 10 modules in 12ms
+Bundled 10 modules in 30ms
 
   docs/index.js                        1.14 KB    (entry point)
   ./index.js                           6.52 KB    (entry point)
@@ -31,7 +31,7 @@ Bundled 10 modules in 12ms
   ./events.js                          488 bytes  (entry point)
 
 [contractspec-bun-build] transpile target=browser root=src entries=10 noBundle=false
-Bundled 10 modules in 64ms
+Bundled 10 modules in 35ms
 
   docs/index.js                        1.14 KB    (entry point)
   ./index.js                           6.52 KB    (entry point)

package/AGENTS.md

@@ -1,30 +1,58 @@
-# AI Agent Guide -- `@contractspec/example.learning-patterns`
+# AI Agent Guide — `@contractspec/example.learning-patterns`
 
 Scope: `packages/examples/learning-patterns/*`
 
-Drills, ambient coach, and quest learning patterns powered by the Learning Journey module (event-driven, deterministic).
+Example: drills + ambient coach + quests learning patterns, powered by Learning Journey (event-driven, deterministic).
 
 ## Quick Context
 
-- **Layer**: example
-- **Related Packages**: `lib.contracts-spec`, `module.learning-journey`
-
-## What This Demonstrates
-
-- Three distinct learning track patterns: drills, ambient-coach, quests
-- Event-driven track progression
-- Deterministic state transitions via the Learning Journey module
-
-## Public Exports
-
-- `.` -- root barrel
-- `./tracks` -- ambient-coach, drills, quests
-- `./events` -- track lifecycle events
-- `./docs`, `./example`
+- 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`.
+
+## Architecture
+
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/events.ts` is package-level event definitions.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/learning-patterns.feature.ts` defines a feature entrypoint.
+- `src/learning-patterns.test.ts` is part of the package's public or composition surface.
+- `src/tracks` is part of the package's public or composition surface.
+
+## Public Surface
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/learning-patterns.docblock` resolves through `./src/docs/learning-patterns.docblock.ts`.
+- Export `./events` resolves through `./src/events.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./learning-patterns.feature` resolves through `./src/learning-patterns.feature.ts`.
+- Export `./tracks` resolves through `./src/tracks/index.ts`.
+- Export `./tracks/ambient-coach` resolves through `./src/tracks/ambient-coach.ts`.
+- Export `./tracks/drills` resolves through `./src/tracks/drills.ts`.
+- Export `./tracks/quests` resolves through `./src/tracks/quests.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,14 @@
 # @contractspec/example.learning-patterns
 
+## 3.7.6
+
+### Patch Changes
+
+- fix: release manifest
+- Updated dependencies
+  - @contractspec/module.learning-journey@3.7.6
+  - @contractspec/lib.contracts-spec@3.7.6
+
 ## 3.7.5
 
 ### Patch Changes

package/README.md

@@ -1,15 +1,73 @@
-# `@contractspec/example.learning-patterns`
+# @contractspec/example.learning-patterns
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
+**Example: drills + ambient coach + quests learning patterns, powered by Learning Journey (event-driven, deterministic).**
 
-Spec-first learning archetypes designed to be **domain-agnostic**:\n+\n+- **Drills + SRS** (Duolingo-like)\n+- **Ambient Coach** (contextual tips)\n+- **Quests** (3–7 day arcs)\n+\n+All progress is **event-driven** and compatible with `@contractspec/module.learning-journey` track specs.\n+\n+## Exports\n+\n+- `tracks/*`: ready-to-use `LearningJourneyTrackSpec[]`\n+- `events`: event name constants used by the tracks\n+\n+## Running tests\n+\n+```bash\n+bun test\n+```\n+
+## What This Demonstrates
 
+- Three distinct learning track patterns: drills, ambient-coach, quests.
+- Event-driven track progression.
+- Deterministic state transitions via the Learning Journey module.
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/docs/` contains docblocks and documentation-facing exports.
 
+## Running Locally
 
+From `packages/examples/learning-patterns`:
+- `bun run dev`
+- `bun run build`
+- `bun run test`
+- `bun run typecheck`
 
+## Usage
 
+Use `@contractspec/example.learning-patterns` as a reference implementation, or import its exported surfaces into a workspace that composes ContractSpec examples and bundles.
 
+## Architecture
 
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/events.ts` is package-level event definitions.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/learning-patterns.feature.ts` defines a feature entrypoint.
+- `src/learning-patterns.test.ts` is part of the package's public or composition surface.
+- `src/tracks` 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/learning-patterns.docblock` resolves through `./src/docs/learning-patterns.docblock.ts`.
+- Export `./events` resolves through `./src/events.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./learning-patterns.feature` resolves through `./src/learning-patterns.feature.ts`.
+- Export `./tracks` resolves through `./src/tracks/index.ts`.
+- Export `./tracks/ambient-coach` resolves through `./src/tracks/ambient-coach.ts`.
+- Export `./tracks/drills` resolves through `./src/tracks/drills.ts`.
+- Export `./tracks/quests` resolves through `./src/tracks/quests.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

@@ -77,6 +77,68 @@ var example = defineExample({
 });
 var example_default = example;
 
+// src/learning-patterns.feature.ts
+import { defineFeature } from "@contractspec/lib.contracts-spec";
+var LearningPatternsFeature = defineFeature({
+  meta: {
+    key: "learning-patterns",
+    version: "1.0.0",
+    title: "Learning Patterns",
+    description: "Learning archetypes (drills, ambient-coach, quests) via event-driven track specs",
+    domain: "learning-journey",
+    owners: ["@examples"],
+    tags: ["learning", "patterns", "archetypes", "tracks"],
+    stability: "experimental"
+  },
+  telemetry: [{ key: "learning-patterns.telemetry", version: "1.0.0" }],
+  docs: [
+    "docs.examples.learning-patterns.goal",
+    "docs.examples.learning-patterns.reference"
+  ]
+});
+
+// src/tracks/ambient-coach.ts
+var ambientCoachTrack = {
+  id: "learning_patterns_ambient_coach_basics",
+  name: "Ambient Coach Basics",
+  description: "Contextual tips triggered by behavior events.",
+  targetUserSegment: "learner",
+  targetRole: "individual",
+  totalXp: 30,
+  steps: [
+    {
+      id: "tip_shown",
+      title: "See a contextual tip",
+      order: 1,
+      completion: { kind: "event", eventName: LEARNING_EVENTS.COACH_TIP_SHOWN },
+      xpReward: 10
+    },
+    {
+      id: "tip_acknowledged",
+      title: "Acknowledge a tip",
+      order: 2,
+      completion: {
+        kind: "event",
+        eventName: LEARNING_EVENTS.COACH_TIP_ACKNOWLEDGED
+      },
+      xpReward: 10
+    },
+    {
+      id: "tip_action_taken",
+      title: "Take an action from a tip",
+      order: 3,
+      completion: {
+        kind: "event",
+        eventName: LEARNING_EVENTS.COACH_TIP_ACTION_TAKEN
+      },
+      xpReward: 10
+    }
+  ]
+};
+var ambientCoachTracks = [
+  ambientCoachTrack
+];
+
 // src/tracks/drills.ts
 var drillsTrack = {
   id: "learning_patterns_drills_basics",
@@ -126,48 +188,6 @@ var drillsTrack = {
 };
 var drillTracks = [drillsTrack];
 
-// src/tracks/ambient-coach.ts
-var ambientCoachTrack = {
-  id: "learning_patterns_ambient_coach_basics",
-  name: "Ambient Coach Basics",
-  description: "Contextual tips triggered by behavior events.",
-  targetUserSegment: "learner",
-  targetRole: "individual",
-  totalXp: 30,
-  steps: [
-    {
-      id: "tip_shown",
-      title: "See a contextual tip",
-      order: 1,
-      completion: { kind: "event", eventName: LEARNING_EVENTS.COACH_TIP_SHOWN },
-      xpReward: 10
-    },
-    {
-      id: "tip_acknowledged",
-      title: "Acknowledge a tip",
-      order: 2,
-      completion: {
-        kind: "event",
-        eventName: LEARNING_EVENTS.COACH_TIP_ACKNOWLEDGED
-      },
-      xpReward: 10
-    },
-    {
-      id: "tip_action_taken",
-      title: "Take an action from a tip",
-      order: 3,
-      completion: {
-        kind: "event",
-        eventName: LEARNING_EVENTS.COACH_TIP_ACTION_TAKEN
-      },
-      xpReward: 10
-    }
-  ]
-};
-var ambientCoachTracks = [
-  ambientCoachTrack
-];
-
 // src/tracks/quests.ts
 var questTrack = {
   id: "learning_patterns_quest_7day",
@@ -209,25 +229,6 @@ var questTrack = {
   ]
 };
 var questTracks = [questTrack];
-// src/learning-patterns.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var LearningPatternsFeature = defineFeature({
-  meta: {
-    key: "learning-patterns",
-    version: "1.0.0",
-    title: "Learning Patterns",
-    description: "Learning archetypes (drills, ambient-coach, quests) via event-driven track specs",
-    domain: "learning-journey",
-    owners: ["@examples"],
-    tags: ["learning", "patterns", "archetypes", "tracks"],
-    stability: "experimental"
-  },
-  telemetry: [{ key: "learning-patterns.telemetry", version: "1.0.0" }],
-  docs: [
-    "docs.examples.learning-patterns.goal",
-    "docs.examples.learning-patterns.reference"
-  ]
-});
 export {
   questTracks,
   questTrack,

package/dist/browser/tracks/index.js

@@ -11,6 +11,48 @@ var LEARNING_EVENTS = {
   QUEST_STEP_COMPLETED: "quest.step.completed"
 };
 
+// src/tracks/ambient-coach.ts
+var ambientCoachTrack = {
+  id: "learning_patterns_ambient_coach_basics",
+  name: "Ambient Coach Basics",
+  description: "Contextual tips triggered by behavior events.",
+  targetUserSegment: "learner",
+  targetRole: "individual",
+  totalXp: 30,
+  steps: [
+    {
+      id: "tip_shown",
+      title: "See a contextual tip",
+      order: 1,
+      completion: { kind: "event", eventName: LEARNING_EVENTS.COACH_TIP_SHOWN },
+      xpReward: 10
+    },
+    {
+      id: "tip_acknowledged",
+      title: "Acknowledge a tip",
+      order: 2,
+      completion: {
+        kind: "event",
+        eventName: LEARNING_EVENTS.COACH_TIP_ACKNOWLEDGED
+      },
+      xpReward: 10
+    },
+    {
+      id: "tip_action_taken",
+      title: "Take an action from a tip",
+      order: 3,
+      completion: {
+        kind: "event",
+        eventName: LEARNING_EVENTS.COACH_TIP_ACTION_TAKEN
+      },
+      xpReward: 10
+    }
+  ]
+};
+var ambientCoachTracks = [
+  ambientCoachTrack
+];
+
 // src/tracks/drills.ts
 var drillsTrack = {
   id: "learning_patterns_drills_basics",
@@ -60,48 +102,6 @@ var drillsTrack = {
 };
 var drillTracks = [drillsTrack];
 
-// src/tracks/ambient-coach.ts
-var ambientCoachTrack = {
-  id: "learning_patterns_ambient_coach_basics",
-  name: "Ambient Coach Basics",
-  description: "Contextual tips triggered by behavior events.",
-  targetUserSegment: "learner",
-  targetRole: "individual",
-  totalXp: 30,
-  steps: [
-    {
-      id: "tip_shown",
-      title: "See a contextual tip",
-      order: 1,
-      completion: { kind: "event", eventName: LEARNING_EVENTS.COACH_TIP_SHOWN },
-      xpReward: 10
-    },
-    {
-      id: "tip_acknowledged",
-      title: "Acknowledge a tip",
-      order: 2,
-      completion: {
-        kind: "event",
-        eventName: LEARNING_EVENTS.COACH_TIP_ACKNOWLEDGED
-      },
-      xpReward: 10
-    },
-    {
-      id: "tip_action_taken",
-      title: "Take an action from a tip",
-      order: 3,
-      completion: {
-        kind: "event",
-        eventName: LEARNING_EVENTS.COACH_TIP_ACTION_TAKEN
-      },
-      xpReward: 10
-    }
-  ]
-};
-var ambientCoachTracks = [
-  ambientCoachTrack
-];
-
 // src/tracks/quests.ts
 var questTrack = {
   id: "learning_patterns_quest_7day",

package/dist/index.d.ts

@@ -4,7 +4,7 @@
  * Domain-agnostic learning archetypes implemented as Learning Journey tracks.
  */
 export * from './events';
-export * from './tracks';
-export * from './learning-patterns.feature';
 export { default as example } from './example';
+export * from './learning-patterns.feature';
+export * from './tracks';
 import './docs';

package/dist/index.js

@@ -78,6 +78,68 @@ var example = defineExample({
 });
 var example_default = example;
 
+// src/learning-patterns.feature.ts
+import { defineFeature } from "@contractspec/lib.contracts-spec";
+var LearningPatternsFeature = defineFeature({
+  meta: {
+    key: "learning-patterns",
+    version: "1.0.0",
+    title: "Learning Patterns",
+    description: "Learning archetypes (drills, ambient-coach, quests) via event-driven track specs",
+    domain: "learning-journey",
+    owners: ["@examples"],
+    tags: ["learning", "patterns", "archetypes", "tracks"],
+    stability: "experimental"
+  },
+  telemetry: [{ key: "learning-patterns.telemetry", version: "1.0.0" }],
+  docs: [
+    "docs.examples.learning-patterns.goal",
+    "docs.examples.learning-patterns.reference"
+  ]
+});
+
+// src/tracks/ambient-coach.ts
+var ambientCoachTrack = {
+  id: "learning_patterns_ambient_coach_basics",
+  name: "Ambient Coach Basics",
+  description: "Contextual tips triggered by behavior events.",
+  targetUserSegment: "learner",
+  targetRole: "individual",
+  totalXp: 30,
+  steps: [
+    {
+      id: "tip_shown",
+      title: "See a contextual tip",
+      order: 1,
+      completion: { kind: "event", eventName: LEARNING_EVENTS.COACH_TIP_SHOWN },
+      xpReward: 10
+    },
+    {
+      id: "tip_acknowledged",
+      title: "Acknowledge a tip",
+      order: 2,
+      completion: {
+        kind: "event",
+        eventName: LEARNING_EVENTS.COACH_TIP_ACKNOWLEDGED
+      },
+      xpReward: 10
+    },
+    {
+      id: "tip_action_taken",
+      title: "Take an action from a tip",
+      order: 3,
+      completion: {
+        kind: "event",
+        eventName: LEARNING_EVENTS.COACH_TIP_ACTION_TAKEN
+      },
+      xpReward: 10
+    }
+  ]
+};
+var ambientCoachTracks = [
+  ambientCoachTrack
+];
+
 // src/tracks/drills.ts
 var drillsTrack = {
   id: "learning_patterns_drills_basics",
@@ -127,48 +189,6 @@ var drillsTrack = {
 };
 var drillTracks = [drillsTrack];
 
-// src/tracks/ambient-coach.ts
-var ambientCoachTrack = {
-  id: "learning_patterns_ambient_coach_basics",
-  name: "Ambient Coach Basics",
-  description: "Contextual tips triggered by behavior events.",
-  targetUserSegment: "learner",
-  targetRole: "individual",
-  totalXp: 30,
-  steps: [
-    {
-      id: "tip_shown",
-      title: "See a contextual tip",
-      order: 1,
-      completion: { kind: "event", eventName: LEARNING_EVENTS.COACH_TIP_SHOWN },
-      xpReward: 10
-    },
-    {
-      id: "tip_acknowledged",
-      title: "Acknowledge a tip",
-      order: 2,
-      completion: {
-        kind: "event",
-        eventName: LEARNING_EVENTS.COACH_TIP_ACKNOWLEDGED
-      },
-      xpReward: 10
-    },
-    {
-      id: "tip_action_taken",
-      title: "Take an action from a tip",
-      order: 3,
-      completion: {
-        kind: "event",
-        eventName: LEARNING_EVENTS.COACH_TIP_ACTION_TAKEN
-      },
-      xpReward: 10
-    }
-  ]
-};
-var ambientCoachTracks = [
-  ambientCoachTrack
-];
-
 // src/tracks/quests.ts
 var questTrack = {
   id: "learning_patterns_quest_7day",
@@ -210,25 +230,6 @@ var questTrack = {
   ]
 };
 var questTracks = [questTrack];
-// src/learning-patterns.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var LearningPatternsFeature = defineFeature({
-  meta: {
-    key: "learning-patterns",
-    version: "1.0.0",
-    title: "Learning Patterns",
-    description: "Learning archetypes (drills, ambient-coach, quests) via event-driven track specs",
-    domain: "learning-journey",
-    owners: ["@examples"],
-    tags: ["learning", "patterns", "archetypes", "tracks"],
-    stability: "experimental"
-  },
-  telemetry: [{ key: "learning-patterns.telemetry", version: "1.0.0" }],
-  docs: [
-    "docs.examples.learning-patterns.goal",
-    "docs.examples.learning-patterns.reference"
-  ]
-});
 export {
   questTracks,
   questTrack,