@contractspec/example.personalization 3.7.6 → 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=8 noBundle=false
-Bundled 8 modules in 17ms
+Bundled 8 modules in 5ms
 
   ./behavior-tracking.js            1.33 KB  (entry point)
   ./index.js                        7.60 KB  (entry point)
@@ -15,7 +15,7 @@ Bundled 8 modules in 17ms
   ./workflow-extension.js           1.59 KB  (entry point)
 
 [contractspec-bun-build] transpile target=node root=src entries=8 noBundle=false
-Bundled 8 modules in 7ms
+Bundled 8 modules in 5ms
 
   ./behavior-tracking.js            1.32 KB  (entry point)
   ./index.js                        7.59 KB  (entry point)
@@ -27,7 +27,7 @@ Bundled 8 modules in 7ms
   ./workflow-extension.js           1.58 KB  (entry point)
 
 [contractspec-bun-build] transpile target=browser root=src entries=8 noBundle=false
-Bundled 8 modules in 7ms
+Bundled 8 modules in 17ms
 
   ./behavior-tracking.js            1.32 KB  (entry point)
   ./index.js                        7.59 KB  (entry point)

package/AGENTS.md

@@ -1,32 +1,56 @@
-# AI Agent Guide -- `@contractspec/example.personalization`
+# AI Agent Guide — `@contractspec/example.personalization`
 
 Scope: `packages/examples/personalization/*`
 
-Personalization examples: behavior tracking, overlay customization, and workflow extension.
+Personalization examples: behavior tracking, overlay customization, workflow extension.
 
 ## Quick Context
 
-- **Layer**: example
-- **Related Packages**: `lib.personalization`, `lib.overlay-engine`, `lib.workflow-composer`, `lib.contracts-spec`, `lib.logger`
+- Layer: `example`.
+- Package visibility: published package.
+- Primary consumers are example explorers, template authors, and documentation readers.
+- Related packages: `@contractspec/lib.contracts-spec`, `@contractspec/lib.logger`, `@contractspec/lib.overlay-engine`, `@contractspec/lib.personalization`, `@contractspec/lib.workflow-composer`, `@contractspec/tool.bun`, ...
 
-## What This Demonstrates
+## Architecture
 
-- Behavior tracking integration pattern
-- Overlay customization via overlay-engine
-- Workflow extension via workflow-composer
-- Multi-lib composition in a single example
+- `src/behavior-tracking.ts` is part of the package's public or composition surface.
+- `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/overlay-customization.ts` is part of the package's public or composition surface.
+- `src/personalization.feature.ts` defines a feature entrypoint.
+- `src/workflow-extension.ts` is part of the package's public or composition surface.
 
-## Public Exports
+## Public Surface
 
-- `.` -- root barrel
-- `./behavior-tracking` -- tracking patterns
-- `./overlay-customization` -- overlay config
-- `./workflow-extension` -- workflow extension
-- `./docs`, `./example`
+- Export `.` resolves through `./src/index.ts`.
+- Export `./behavior-tracking` resolves through `./src/behavior-tracking.ts`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/personalization.docblock` resolves through `./src/docs/personalization.docblock.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./overlay-customization` resolves through `./src/overlay-customization.ts`.
+- Export `./personalization.feature` resolves through `./src/personalization.feature.ts`.
+- Export `./workflow-extension` resolves through `./src/workflow-extension.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/lib.logger`, `@contractspec/lib.overlay-engine`, `@contractspec/lib.personalization`, `@contractspec/lib.workflow-composer`, `@contractspec/tool.bun`, ....
+- Changes here can affect downstream packages such as `@contractspec/lib.contracts-spec`, `@contractspec/lib.logger`, `@contractspec/lib.overlay-engine`, `@contractspec/lib.personalization`, `@contractspec/lib.workflow-composer`, `@contractspec/tool.bun`, ...
 
 ## Local Commands
 
-- Build: `bun run build`
-- Dev: `bun run dev`
-- Test: `bun test --pass-with-no-tests`
-- 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 --pass-with-no-tests
+- `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/README.md

@@ -1,27 +1,72 @@
 # @contractspec/example.personalization
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
-**Personalization patterns** -- behavior tracking, overlay customization, and workflow extension examples.
+**Personalization examples: behavior tracking, overlay customization, workflow extension.**
 
 ## What This Demonstrates
 
-- Behavior tracking with the personalization lib tracker
-- Overlay customization using the overlay-engine
-- Workflow extension patterns for adaptive UX
+- Behavior tracking integration pattern.
+- Overlay customization via overlay-engine.
+- Workflow extension via workflow-composer.
+- Multi-lib composition in a single example.
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/docs/` contains docblocks and documentation-facing exports.
 
-## Exports
+## Running Locally
 
-- `.` -- aggregated re-exports
-- `./behavior-tracking` -- behavior tracking example
-- `./overlay-customization` -- overlay customization example
-- `./workflow-extension` -- workflow extension example
-- `./docs` -- DocBlock documentation
-- `./example` -- example spec definition
+From `packages/examples/personalization`:
+- `bun run dev`
+- `bun run build`
+- `bun run test`
+- `bun run typecheck`
 
 ## Usage
 
-```ts
-import { behaviorTrackingExample } from "@contractspec/example.personalization/behavior-tracking";
-import { overlayCustomizationExample } from "@contractspec/example.personalization/overlay-customization";
-```
+Use `@contractspec/example.personalization` as a reference implementation, or import its exported surfaces into a workspace that composes ContractSpec examples and bundles.
+
+## Architecture
+
+- `src/behavior-tracking.ts` is part of the package's public or composition surface.
+- `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/overlay-customization.ts` is part of the package's public or composition surface.
+- `src/personalization.feature.ts` defines a feature entrypoint.
+- `src/workflow-extension.ts` is part of the package's public or composition surface.
+
+## Public Entry Points
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./behavior-tracking` resolves through `./src/behavior-tracking.ts`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/personalization.docblock` resolves through `./src/docs/personalization.docblock.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./overlay-customization` resolves through `./src/overlay-customization.ts`.
+- Export `./personalization.feature` resolves through `./src/personalization.feature.ts`.
+- Export `./workflow-extension` resolves through `./src/workflow-extension.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 --pass-with-no-tests
+- `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/lib.logger`, `@contractspec/lib.overlay-engine`, `@contractspec/lib.personalization`, `@contractspec/lib.workflow-composer`, ...

package/dist/behavior-tracking.js

@@ -1,9 +1,9 @@
 // @bun
 // src/behavior-tracking.ts
-import { createBehaviorTracker } from "@contractspec/lib.personalization/tracker";
-import { InMemoryBehaviorStore } from "@contractspec/lib.personalization/store";
-import { BehaviorAnalyzer } from "@contractspec/lib.personalization/analyzer";
 import { Logger, LogLevel } from "@contractspec/lib.logger";
+import { BehaviorAnalyzer } from "@contractspec/lib.personalization/analyzer";
+import { InMemoryBehaviorStore } from "@contractspec/lib.personalization/store";
+import { createBehaviorTracker } from "@contractspec/lib.personalization/tracker";
 var logger = new Logger({
   level: LogLevel.INFO,
   environment: "production",

package/dist/browser/behavior-tracking.js

@@ -1,8 +1,8 @@
 // src/behavior-tracking.ts
-import { createBehaviorTracker } from "@contractspec/lib.personalization/tracker";
-import { InMemoryBehaviorStore } from "@contractspec/lib.personalization/store";
-import { BehaviorAnalyzer } from "@contractspec/lib.personalization/analyzer";
 import { Logger, LogLevel } from "@contractspec/lib.logger";
+import { BehaviorAnalyzer } from "@contractspec/lib.personalization/analyzer";
+import { InMemoryBehaviorStore } from "@contractspec/lib.personalization/store";
+import { createBehaviorTracker } from "@contractspec/lib.personalization/tracker";
 var logger = new Logger({
   level: LogLevel.INFO,
   environment: "production",

package/dist/browser/index.js

@@ -1,8 +1,8 @@
 // src/behavior-tracking.ts
-import { createBehaviorTracker } from "@contractspec/lib.personalization/tracker";
-import { InMemoryBehaviorStore } from "@contractspec/lib.personalization/store";
-import { BehaviorAnalyzer } from "@contractspec/lib.personalization/analyzer";
 import { Logger, LogLevel } from "@contractspec/lib.logger";
+import { BehaviorAnalyzer } from "@contractspec/lib.personalization/analyzer";
+import { InMemoryBehaviorStore } from "@contractspec/lib.personalization/store";
+import { createBehaviorTracker } from "@contractspec/lib.personalization/tracker";
 var logger = new Logger({
   level: LogLevel.INFO,
   environment: "production",
@@ -112,13 +112,13 @@ var example = defineExample({
 var example_default = example;
 
 // src/overlay-customization.ts
-import { defineOverlay } from "@contractspec/lib.overlay-engine/spec";
-import { signOverlay } from "@contractspec/lib.overlay-engine/signer";
+import { Logger as Logger2, LogLevel as LogLevel2 } from "@contractspec/lib.logger";
 import {
   OverlayEngine,
   OverlayRegistry
 } from "@contractspec/lib.overlay-engine";
-import { Logger as Logger2, LogLevel as LogLevel2 } from "@contractspec/lib.logger";
+import { signOverlay } from "@contractspec/lib.overlay-engine/signer";
+import { defineOverlay } from "@contractspec/lib.overlay-engine/spec";
 var logger2 = new Logger2({
   level: LogLevel2.INFO,
   environment: "production",
@@ -162,10 +162,30 @@ async function runOverlayCustomizationExample() {
   logger2.info("Overlay applied", { fields: result.target.fields });
 }
 
+// src/personalization.feature.ts
+import { defineFeature } from "@contractspec/lib.contracts-spec";
+var PersonalizationFeature = defineFeature({
+  meta: {
+    key: "personalization",
+    version: "1.0.0",
+    title: "Personalization Patterns",
+    description: "Behavior tracking, overlay customization, and workflow extension patterns",
+    domain: "personalization",
+    owners: ["@examples"],
+    tags: ["personalization", "behavior", "overlay", "workflow"],
+    stability: "experimental"
+  },
+  telemetry: [{ key: "personalization.telemetry", version: "1.0.0" }],
+  docs: [
+    "docs.examples.personalization",
+    "docs.examples.personalization.usage"
+  ]
+});
+
 // src/workflow-extension.ts
 import { StabilityEnum } from "@contractspec/lib.contracts-spec";
-import { WorkflowComposer } from "@contractspec/lib.workflow-composer";
 import { Logger as Logger3, LogLevel as LogLevel3 } from "@contractspec/lib.logger";
+import { WorkflowComposer } from "@contractspec/lib.workflow-composer";
 var logger3 = new Logger3({
   level: LogLevel3.INFO,
   environment: "production",
@@ -218,26 +238,6 @@ function logTenantWorkflowSteps(workflow) {
     steps: workflow.definition.steps.map((step) => step.id)
   });
 }
-
-// src/personalization.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var PersonalizationFeature = defineFeature({
-  meta: {
-    key: "personalization",
-    version: "1.0.0",
-    title: "Personalization Patterns",
-    description: "Behavior tracking, overlay customization, and workflow extension patterns",
-    domain: "personalization",
-    owners: ["@examples"],
-    tags: ["personalization", "behavior", "overlay", "workflow"],
-    stability: "experimental"
-  },
-  telemetry: [{ key: "personalization.telemetry", version: "1.0.0" }],
-  docs: [
-    "docs.examples.personalization",
-    "docs.examples.personalization.usage"
-  ]
-});
 export {
   runOverlayCustomizationExample,
   runBehaviorTrackingExample,

package/dist/browser/overlay-customization.js

@@ -1,11 +1,11 @@
 // src/overlay-customization.ts
-import { defineOverlay } from "@contractspec/lib.overlay-engine/spec";
-import { signOverlay } from "@contractspec/lib.overlay-engine/signer";
+import { Logger, LogLevel } from "@contractspec/lib.logger";
 import {
   OverlayEngine,
   OverlayRegistry
 } from "@contractspec/lib.overlay-engine";
-import { Logger, LogLevel } from "@contractspec/lib.logger";
+import { signOverlay } from "@contractspec/lib.overlay-engine/signer";
+import { defineOverlay } from "@contractspec/lib.overlay-engine/spec";
 var logger = new Logger({
   level: LogLevel.INFO,
   environment: "production",

package/dist/browser/workflow-extension.js

@@ -1,7 +1,7 @@
 // src/workflow-extension.ts
 import { StabilityEnum } from "@contractspec/lib.contracts-spec";
-import { WorkflowComposer } from "@contractspec/lib.workflow-composer";
 import { Logger, LogLevel } from "@contractspec/lib.logger";
+import { WorkflowComposer } from "@contractspec/lib.workflow-composer";
 var logger = new Logger({
   level: LogLevel.INFO,
   environment: "production",

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export * from './behavior-tracking';
+export { default as example } from './example';
 export * from './overlay-customization';
-export * from './workflow-extension';
 export * from './personalization.feature';
-export { default as example } from './example';
+export * from './workflow-extension';
 import './docs';

package/dist/index.js

@@ -1,9 +1,9 @@
 // @bun
 // src/behavior-tracking.ts
-import { createBehaviorTracker } from "@contractspec/lib.personalization/tracker";
-import { InMemoryBehaviorStore } from "@contractspec/lib.personalization/store";
-import { BehaviorAnalyzer } from "@contractspec/lib.personalization/analyzer";
 import { Logger, LogLevel } from "@contractspec/lib.logger";
+import { BehaviorAnalyzer } from "@contractspec/lib.personalization/analyzer";
+import { InMemoryBehaviorStore } from "@contractspec/lib.personalization/store";
+import { createBehaviorTracker } from "@contractspec/lib.personalization/tracker";
 var logger = new Logger({
   level: LogLevel.INFO,
   environment: "production",
@@ -113,13 +113,13 @@ var example = defineExample({
 var example_default = example;
 
 // src/overlay-customization.ts
-import { defineOverlay } from "@contractspec/lib.overlay-engine/spec";
-import { signOverlay } from "@contractspec/lib.overlay-engine/signer";
+import { Logger as Logger2, LogLevel as LogLevel2 } from "@contractspec/lib.logger";
 import {
   OverlayEngine,
   OverlayRegistry
 } from "@contractspec/lib.overlay-engine";
-import { Logger as Logger2, LogLevel as LogLevel2 } from "@contractspec/lib.logger";
+import { signOverlay } from "@contractspec/lib.overlay-engine/signer";
+import { defineOverlay } from "@contractspec/lib.overlay-engine/spec";
 var logger2 = new Logger2({
   level: LogLevel2.INFO,
   environment: "production",
@@ -163,10 +163,30 @@ async function runOverlayCustomizationExample() {
   logger2.info("Overlay applied", { fields: result.target.fields });
 }
 
+// src/personalization.feature.ts
+import { defineFeature } from "@contractspec/lib.contracts-spec";
+var PersonalizationFeature = defineFeature({
+  meta: {
+    key: "personalization",
+    version: "1.0.0",
+    title: "Personalization Patterns",
+    description: "Behavior tracking, overlay customization, and workflow extension patterns",
+    domain: "personalization",
+    owners: ["@examples"],
+    tags: ["personalization", "behavior", "overlay", "workflow"],
+    stability: "experimental"
+  },
+  telemetry: [{ key: "personalization.telemetry", version: "1.0.0" }],
+  docs: [
+    "docs.examples.personalization",
+    "docs.examples.personalization.usage"
+  ]
+});
+
 // src/workflow-extension.ts
 import { StabilityEnum } from "@contractspec/lib.contracts-spec";
-import { WorkflowComposer } from "@contractspec/lib.workflow-composer";
 import { Logger as Logger3, LogLevel as LogLevel3 } from "@contractspec/lib.logger";
+import { WorkflowComposer } from "@contractspec/lib.workflow-composer";
 var logger3 = new Logger3({
   level: LogLevel3.INFO,
   environment: "production",
@@ -219,26 +239,6 @@ function logTenantWorkflowSteps(workflow) {
     steps: workflow.definition.steps.map((step) => step.id)
   });
 }
-
-// src/personalization.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var PersonalizationFeature = defineFeature({
-  meta: {
-    key: "personalization",
-    version: "1.0.0",
-    title: "Personalization Patterns",
-    description: "Behavior tracking, overlay customization, and workflow extension patterns",
-    domain: "personalization",
-    owners: ["@examples"],
-    tags: ["personalization", "behavior", "overlay", "workflow"],
-    stability: "experimental"
-  },
-  telemetry: [{ key: "personalization.telemetry", version: "1.0.0" }],
-  docs: [
-    "docs.examples.personalization",
-    "docs.examples.personalization.usage"
-  ]
-});
 export {
   runOverlayCustomizationExample,
   runBehaviorTrackingExample,

package/dist/node/behavior-tracking.js

@@ -1,8 +1,8 @@
 // src/behavior-tracking.ts
-import { createBehaviorTracker } from "@contractspec/lib.personalization/tracker";
-import { InMemoryBehaviorStore } from "@contractspec/lib.personalization/store";
-import { BehaviorAnalyzer } from "@contractspec/lib.personalization/analyzer";
 import { Logger, LogLevel } from "@contractspec/lib.logger";
+import { BehaviorAnalyzer } from "@contractspec/lib.personalization/analyzer";
+import { InMemoryBehaviorStore } from "@contractspec/lib.personalization/store";
+import { createBehaviorTracker } from "@contractspec/lib.personalization/tracker";
 var logger = new Logger({
   level: LogLevel.INFO,
   environment: "production",

package/dist/node/index.js

@@ -1,8 +1,8 @@
 // src/behavior-tracking.ts
-import { createBehaviorTracker } from "@contractspec/lib.personalization/tracker";
-import { InMemoryBehaviorStore } from "@contractspec/lib.personalization/store";
-import { BehaviorAnalyzer } from "@contractspec/lib.personalization/analyzer";
 import { Logger, LogLevel } from "@contractspec/lib.logger";
+import { BehaviorAnalyzer } from "@contractspec/lib.personalization/analyzer";
+import { InMemoryBehaviorStore } from "@contractspec/lib.personalization/store";
+import { createBehaviorTracker } from "@contractspec/lib.personalization/tracker";
 var logger = new Logger({
   level: LogLevel.INFO,
   environment: "production",
@@ -112,13 +112,13 @@ var example = defineExample({
 var example_default = example;
 
 // src/overlay-customization.ts
-import { defineOverlay } from "@contractspec/lib.overlay-engine/spec";
-import { signOverlay } from "@contractspec/lib.overlay-engine/signer";
+import { Logger as Logger2, LogLevel as LogLevel2 } from "@contractspec/lib.logger";
 import {
   OverlayEngine,
   OverlayRegistry
 } from "@contractspec/lib.overlay-engine";
-import { Logger as Logger2, LogLevel as LogLevel2 } from "@contractspec/lib.logger";
+import { signOverlay } from "@contractspec/lib.overlay-engine/signer";
+import { defineOverlay } from "@contractspec/lib.overlay-engine/spec";
 var logger2 = new Logger2({
   level: LogLevel2.INFO,
   environment: "production",
@@ -162,10 +162,30 @@ async function runOverlayCustomizationExample() {
   logger2.info("Overlay applied", { fields: result.target.fields });
 }
 
+// src/personalization.feature.ts
+import { defineFeature } from "@contractspec/lib.contracts-spec";
+var PersonalizationFeature = defineFeature({
+  meta: {
+    key: "personalization",
+    version: "1.0.0",
+    title: "Personalization Patterns",
+    description: "Behavior tracking, overlay customization, and workflow extension patterns",
+    domain: "personalization",
+    owners: ["@examples"],
+    tags: ["personalization", "behavior", "overlay", "workflow"],
+    stability: "experimental"
+  },
+  telemetry: [{ key: "personalization.telemetry", version: "1.0.0" }],
+  docs: [
+    "docs.examples.personalization",
+    "docs.examples.personalization.usage"
+  ]
+});
+
 // src/workflow-extension.ts
 import { StabilityEnum } from "@contractspec/lib.contracts-spec";
-import { WorkflowComposer } from "@contractspec/lib.workflow-composer";
 import { Logger as Logger3, LogLevel as LogLevel3 } from "@contractspec/lib.logger";
+import { WorkflowComposer } from "@contractspec/lib.workflow-composer";
 var logger3 = new Logger3({
   level: LogLevel3.INFO,
   environment: "production",
@@ -218,26 +238,6 @@ function logTenantWorkflowSteps(workflow) {
     steps: workflow.definition.steps.map((step) => step.id)
   });
 }
-
-// src/personalization.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var PersonalizationFeature = defineFeature({
-  meta: {
-    key: "personalization",
-    version: "1.0.0",
-    title: "Personalization Patterns",
-    description: "Behavior tracking, overlay customization, and workflow extension patterns",
-    domain: "personalization",
-    owners: ["@examples"],
-    tags: ["personalization", "behavior", "overlay", "workflow"],
-    stability: "experimental"
-  },
-  telemetry: [{ key: "personalization.telemetry", version: "1.0.0" }],
-  docs: [
-    "docs.examples.personalization",
-    "docs.examples.personalization.usage"
-  ]
-});
 export {
   runOverlayCustomizationExample,
   runBehaviorTrackingExample,

package/dist/node/overlay-customization.js

@@ -1,11 +1,11 @@
 // src/overlay-customization.ts
-import { defineOverlay } from "@contractspec/lib.overlay-engine/spec";
-import { signOverlay } from "@contractspec/lib.overlay-engine/signer";
+import { Logger, LogLevel } from "@contractspec/lib.logger";
 import {
   OverlayEngine,
   OverlayRegistry
 } from "@contractspec/lib.overlay-engine";
-import { Logger, LogLevel } from "@contractspec/lib.logger";
+import { signOverlay } from "@contractspec/lib.overlay-engine/signer";
+import { defineOverlay } from "@contractspec/lib.overlay-engine/spec";
 var logger = new Logger({
   level: LogLevel.INFO,
   environment: "production",

package/dist/node/workflow-extension.js

@@ -1,7 +1,7 @@
 // src/workflow-extension.ts
 import { StabilityEnum } from "@contractspec/lib.contracts-spec";
-import { WorkflowComposer } from "@contractspec/lib.workflow-composer";
 import { Logger, LogLevel } from "@contractspec/lib.logger";
+import { WorkflowComposer } from "@contractspec/lib.workflow-composer";
 var logger = new Logger({
   level: LogLevel.INFO,
   environment: "production",

package/dist/overlay-customization.js

@@ -1,12 +1,12 @@
 // @bun
 // src/overlay-customization.ts
-import { defineOverlay } from "@contractspec/lib.overlay-engine/spec";
-import { signOverlay } from "@contractspec/lib.overlay-engine/signer";
+import { Logger, LogLevel } from "@contractspec/lib.logger";
 import {
   OverlayEngine,
   OverlayRegistry
 } from "@contractspec/lib.overlay-engine";
-import { Logger, LogLevel } from "@contractspec/lib.logger";
+import { signOverlay } from "@contractspec/lib.overlay-engine/signer";
+import { defineOverlay } from "@contractspec/lib.overlay-engine/spec";
 var logger = new Logger({
   level: LogLevel.INFO,
   environment: "production",

package/dist/workflow-extension.js

@@ -1,8 +1,8 @@
 // @bun
 // src/workflow-extension.ts
 import { StabilityEnum } from "@contractspec/lib.contracts-spec";
-import { WorkflowComposer } from "@contractspec/lib.workflow-composer";
 import { Logger, LogLevel } from "@contractspec/lib.logger";
+import { WorkflowComposer } from "@contractspec/lib.workflow-composer";
 var logger = new Logger({
   level: LogLevel.INFO,
   environment: "production",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.personalization",
-  "version": "3.7.6",
+  "version": "3.7.7",
   "description": "Personalization examples: behavior tracking, overlay customization, workflow extension.",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -71,17 +71,17 @@
     "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 --pass-with-no-tests",
     "prebuild": "contractspec-bun-build prebuild",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.personalization": "6.0.6",
-    "@contractspec/lib.overlay-engine": "3.7.6",
-    "@contractspec/lib.workflow-composer": "3.7.6",
-    "@contractspec/lib.contracts-spec": "3.7.6",
+    "@contractspec/lib.personalization": "6.0.7",
+    "@contractspec/lib.overlay-engine": "3.7.7",
+    "@contractspec/lib.workflow-composer": "3.7.7",
+    "@contractspec/lib.contracts-spec": "4.0.0",
     "@contractspec/lib.logger": "3.7.6"
   },
   "devDependencies": {

package/src/behavior-tracking.ts

@@ -1,47 +1,47 @@
-import { createBehaviorTracker } from '@contractspec/lib.personalization/tracker';
-import { InMemoryBehaviorStore } from '@contractspec/lib.personalization/store';
-import { BehaviorAnalyzer } from '@contractspec/lib.personalization/analyzer';
 import { Logger, LogLevel } from '@contractspec/lib.logger';
+import { BehaviorAnalyzer } from '@contractspec/lib.personalization/analyzer';
+import { InMemoryBehaviorStore } from '@contractspec/lib.personalization/store';
+import { createBehaviorTracker } from '@contractspec/lib.personalization/tracker';
 
 const logger = new Logger({
-  level: process.env.NODE_ENV === 'production' ? LogLevel.INFO : LogLevel.DEBUG,
-  environment:
-    (process.env.NODE_ENV as 'production' | 'development' | 'test') ||
-    'development',
-  enableColors: process.env.NODE_ENV !== 'production',
+	level: process.env.NODE_ENV === 'production' ? LogLevel.INFO : LogLevel.DEBUG,
+	environment:
+		(process.env.NODE_ENV as 'production' | 'development' | 'test') ||
+		'development',
+	enableColors: process.env.NODE_ENV !== 'production',
 });
 
 export async function runBehaviorTrackingExample(): Promise<void> {
-  const store = new InMemoryBehaviorStore();
-  const tracker = createBehaviorTracker({
-    store,
-    context: {
-      tenantId: 'acme',
-      userId: 'user-123',
-    },
-  });
+	const store = new InMemoryBehaviorStore();
+	const tracker = createBehaviorTracker({
+		store,
+		context: {
+			tenantId: 'acme',
+			userId: 'user-123',
+		},
+	});
 
-  tracker.trackFieldAccess({
-    operation: 'billing.createOrder',
-    field: 'internalNotes',
-  });
-  tracker.trackFieldAccess({
-    operation: 'billing.createOrder',
-    field: 'customerReference',
-  });
-  tracker.trackFeatureUsage({ feature: 'workflow-editor', action: 'opened' });
-  tracker.trackWorkflowStep({
-    workflow: 'invoice-approval',
-    step: 'review',
-    status: 'entered',
-  });
-  await tracker.flush();
+	tracker.trackFieldAccess({
+		operation: 'billing.createOrder',
+		field: 'internalNotes',
+	});
+	tracker.trackFieldAccess({
+		operation: 'billing.createOrder',
+		field: 'customerReference',
+	});
+	tracker.trackFeatureUsage({ feature: 'workflow-editor', action: 'opened' });
+	tracker.trackWorkflowStep({
+		workflow: 'invoice-approval',
+		step: 'review',
+		status: 'entered',
+	});
+	await tracker.flush();
 
-  const analyzer = new BehaviorAnalyzer(store);
-  const insights = await analyzer.analyze({
-    tenantId: 'acme',
-    userId: 'user-123',
-  });
+	const analyzer = new BehaviorAnalyzer(store);
+	const insights = await analyzer.analyze({
+		tenantId: 'acme',
+		userId: 'user-123',
+	});
 
-  logger.info('Behavior insights computed', { insights });
+	logger.info('Behavior insights computed', { insights });
 }

package/src/docs/personalization.docblock.ts

@@ -2,27 +2,27 @@ import type { DocBlock } from '@contractspec/lib.contracts-spec/docs';
 import { registerDocBlocks } from '@contractspec/lib.contracts-spec/docs';
 
 const blocks: DocBlock[] = [
-  {
-    id: 'docs.examples.personalization',
-    title: 'Personalization Patterns (example)',
-    summary:
-      'Behavior tracking, overlay-driven UI tweaks, and tenant workflow extension patterns.',
-    kind: 'reference',
-    visibility: 'public',
-    route: '/docs/examples/personalization',
-    tags: ['personalization', 'overlays', 'workflows', 'example'],
-    body: `## Includes\n- Behavior tracking + insight analysis.\n- Overlay customization (hide fields, rename labels).\n- Workflow extension (inject tenant-specific steps).\n\n## Guardrails\n- Keep tracking events structured and non-PII.\n- Keep overlays signed and scoped.\n- Keep workflow composition deterministic.`,
-  },
-  {
-    id: 'docs.examples.personalization.usage',
-    title: 'Personalization — Usage',
-    summary: 'How to run the small examples and swap adapters.',
-    kind: 'usage',
-    visibility: 'public',
-    route: '/docs/examples/personalization/usage',
-    tags: ['personalization', 'usage'],
-    body: `## Usage\n- Call \`runBehaviorTrackingExample()\` for insights.\n- Call \`runOverlayCustomizationExample()\` to apply overlays.\n- Call \`composeTenantWorkflowExample()\` and \`logTenantWorkflowSteps()\` to inspect steps.\n\n## Notes\n- Replace in-memory stores with app-layer storage.\n- Keep PII out of logs and markdown outputs.`,
-  },
+	{
+		id: 'docs.examples.personalization',
+		title: 'Personalization Patterns (example)',
+		summary:
+			'Behavior tracking, overlay-driven UI tweaks, and tenant workflow extension patterns.',
+		kind: 'reference',
+		visibility: 'public',
+		route: '/docs/examples/personalization',
+		tags: ['personalization', 'overlays', 'workflows', 'example'],
+		body: `## Includes\n- Behavior tracking + insight analysis.\n- Overlay customization (hide fields, rename labels).\n- Workflow extension (inject tenant-specific steps).\n\n## Guardrails\n- Keep tracking events structured and non-PII.\n- Keep overlays signed and scoped.\n- Keep workflow composition deterministic.`,
+	},
+	{
+		id: 'docs.examples.personalization.usage',
+		title: 'Personalization — Usage',
+		summary: 'How to run the small examples and swap adapters.',
+		kind: 'usage',
+		visibility: 'public',
+		route: '/docs/examples/personalization/usage',
+		tags: ['personalization', 'usage'],
+		body: `## Usage\n- Call \`runBehaviorTrackingExample()\` for insights.\n- Call \`runOverlayCustomizationExample()\` to apply overlays.\n- Call \`composeTenantWorkflowExample()\` and \`logTenantWorkflowSteps()\` to inspect steps.\n\n## Notes\n- Replace in-memory stores with app-layer storage.\n- Keep PII out of logs and markdown outputs.`,
+	},
 ];
 
 registerDocBlocks(blocks);

package/src/example.ts

@@ -1,32 +1,32 @@
 import { defineExample } from '@contractspec/lib.contracts-spec';
 
 const example = defineExample({
-  meta: {
-    key: 'personalization',
-    version: '1.0.0',
-    title: 'Personalization Patterns',
-    description:
-      'Small examples for behavior tracking, overlay-based UI customization, and tenant workflow extension.',
-    kind: 'library',
-    visibility: 'public',
-    stability: 'experimental',
-    owners: ['@platform.core'],
-    tags: ['personalization', 'overlays', 'behavior', 'workflows'],
-  },
-  docs: {
-    rootDocId: 'docs.examples.personalization',
-    usageDocId: 'docs.examples.personalization.usage',
-  },
-  entrypoints: {
-    packageName: '@contractspec/example.personalization',
-    docs: './docs',
-  },
-  surfaces: {
-    templates: true,
-    sandbox: { enabled: true, modes: ['markdown', 'specs'] },
-    studio: { enabled: true, installable: true },
-    mcp: { enabled: true },
-  },
+	meta: {
+		key: 'personalization',
+		version: '1.0.0',
+		title: 'Personalization Patterns',
+		description:
+			'Small examples for behavior tracking, overlay-based UI customization, and tenant workflow extension.',
+		kind: 'library',
+		visibility: 'public',
+		stability: 'experimental',
+		owners: ['@platform.core'],
+		tags: ['personalization', 'overlays', 'behavior', 'workflows'],
+	},
+	docs: {
+		rootDocId: 'docs.examples.personalization',
+		usageDocId: 'docs.examples.personalization.usage',
+	},
+	entrypoints: {
+		packageName: '@contractspec/example.personalization',
+		docs: './docs',
+	},
+	surfaces: {
+		templates: true,
+		sandbox: { enabled: true, modes: ['markdown', 'specs'] },
+		studio: { enabled: true, installable: true },
+		mcp: { enabled: true },
+	},
 });
 
 export default example;

package/src/index.ts

@@ -1,6 +1,6 @@
 export * from './behavior-tracking';
+export { default as example } from './example';
 export * from './overlay-customization';
-export * from './workflow-extension';
 export * from './personalization.feature';
-export { default as example } from './example';
+export * from './workflow-extension';
 import './docs';

package/src/overlay-customization.ts

@@ -1,57 +1,57 @@
-import { defineOverlay } from '@contractspec/lib.overlay-engine/spec';
-import { signOverlay } from '@contractspec/lib.overlay-engine/signer';
+import { Logger, LogLevel } from '@contractspec/lib.logger';
 import {
-  OverlayEngine,
-  OverlayRegistry,
+	OverlayEngine,
+	OverlayRegistry,
 } from '@contractspec/lib.overlay-engine';
-import { Logger, LogLevel } from '@contractspec/lib.logger';
+import { signOverlay } from '@contractspec/lib.overlay-engine/signer';
+import { defineOverlay } from '@contractspec/lib.overlay-engine/spec';
 
 const logger = new Logger({
-  level: process.env.NODE_ENV === 'production' ? LogLevel.INFO : LogLevel.DEBUG,
-  environment:
-    (process.env.NODE_ENV as 'production' | 'development' | 'test') ||
-    'development',
-  enableColors: process.env.NODE_ENV !== 'production',
+	level: process.env.NODE_ENV === 'production' ? LogLevel.INFO : LogLevel.DEBUG,
+	environment:
+		(process.env.NODE_ENV as 'production' | 'development' | 'test') ||
+		'development',
+	enableColors: process.env.NODE_ENV !== 'production',
 });
 
 export async function runOverlayCustomizationExample(): Promise<void> {
-  const registry = new OverlayRegistry({ allowUnsigned: true });
-  const engine = new OverlayEngine({ registry });
+	const registry = new OverlayRegistry({ allowUnsigned: true });
+	const engine = new OverlayEngine({ registry });
 
-  const overlay = defineOverlay({
-    overlayId: 'demo-overlay',
-    version: '1.0.0',
-    appliesTo: {
-      capability: 'billing.createOrder',
-      tenantId: 'demo',
-    },
-    modifications: [
-      { type: 'hideField', field: 'internalNotes' },
-      {
-        type: 'renameLabel',
-        field: 'customerReference',
-        newLabel: 'PO Number',
-      },
-    ],
-  });
+	const overlay = defineOverlay({
+		overlayId: 'demo-overlay',
+		version: '1.0.0',
+		appliesTo: {
+			capability: 'billing.createOrder',
+			tenantId: 'demo',
+		},
+		modifications: [
+			{ type: 'hideField', field: 'internalNotes' },
+			{
+				type: 'renameLabel',
+				field: 'customerReference',
+				newLabel: 'PO Number',
+			},
+		],
+	});
 
-  const signed = await signOverlay(overlay, process.env.PRIVATE_KEY_PEM ?? '');
-  registry.register(signed);
+	const signed = await signOverlay(overlay, process.env.PRIVATE_KEY_PEM ?? '');
+	registry.register(signed);
 
-  const result = engine.apply({
-    target: {
-      fields: [
-        {
-          key: 'customerReference',
-          label: 'Customer Reference',
-          visible: true,
-        },
-        { key: 'internalNotes', label: 'Internal Notes', visible: true },
-      ],
-    },
-    capability: 'billing.createOrder',
-    tenantId: 'demo',
-  });
+	const result = engine.apply({
+		target: {
+			fields: [
+				{
+					key: 'customerReference',
+					label: 'Customer Reference',
+					visible: true,
+				},
+				{ key: 'internalNotes', label: 'Internal Notes', visible: true },
+			],
+		},
+		capability: 'billing.createOrder',
+		tenantId: 'demo',
+	});
 
-  logger.info('Overlay applied', { fields: result.target.fields });
+	logger.info('Overlay applied', { fields: result.target.fields });
 }

package/src/personalization.feature.ts

@@ -1,22 +1,22 @@
 import { defineFeature } from '@contractspec/lib.contracts-spec';
 
 export const PersonalizationFeature = defineFeature({
-  meta: {
-    key: 'personalization',
-    version: '1.0.0',
-    title: 'Personalization Patterns',
-    description:
-      'Behavior tracking, overlay customization, and workflow extension patterns',
-    domain: 'personalization',
-    owners: ['@examples'],
-    tags: ['personalization', 'behavior', 'overlay', 'workflow'],
-    stability: 'experimental',
-  },
+	meta: {
+		key: 'personalization',
+		version: '1.0.0',
+		title: 'Personalization Patterns',
+		description:
+			'Behavior tracking, overlay customization, and workflow extension patterns',
+		domain: 'personalization',
+		owners: ['@examples'],
+		tags: ['personalization', 'behavior', 'overlay', 'workflow'],
+		stability: 'experimental',
+	},
 
-  telemetry: [{ key: 'personalization.telemetry', version: '1.0.0' }],
+	telemetry: [{ key: 'personalization.telemetry', version: '1.0.0' }],
 
-  docs: [
-    'docs.examples.personalization',
-    'docs.examples.personalization.usage',
-  ],
+	docs: [
+		'docs.examples.personalization',
+		'docs.examples.personalization.usage',
+	],
 });

package/src/workflow-extension.ts

@@ -1,63 +1,63 @@
 import { StabilityEnum } from '@contractspec/lib.contracts-spec';
 import type { WorkflowSpec } from '@contractspec/lib.contracts-spec/workflow/spec';
-import { WorkflowComposer } from '@contractspec/lib.workflow-composer';
 import { Logger, LogLevel } from '@contractspec/lib.logger';
+import { WorkflowComposer } from '@contractspec/lib.workflow-composer';
 
 const logger = new Logger({
-  level: process.env.NODE_ENV === 'production' ? LogLevel.INFO : LogLevel.DEBUG,
-  environment:
-    (process.env.NODE_ENV as 'production' | 'development' | 'test') ||
-    'development',
-  enableColors: process.env.NODE_ENV !== 'production',
+	level: process.env.NODE_ENV === 'production' ? LogLevel.INFO : LogLevel.DEBUG,
+	environment:
+		(process.env.NODE_ENV as 'production' | 'development' | 'test') ||
+		'development',
+	enableColors: process.env.NODE_ENV !== 'production',
 });
 
 const BaseWorkflow: WorkflowSpec = {
-  meta: {
-    key: 'billing.invoiceApproval',
-    version: '1.0.0',
-    title: 'Invoice Approval',
-    owners: [],
-    tags: [],
-    description: '',
-    domain: 'billing',
-    stability: StabilityEnum.Stable,
-  },
-  definition: {
-    steps: [
-      { id: 'validate-invoice', type: 'automation', label: 'Validate Invoice' },
-      { id: 'final-approval', type: 'human', label: 'Final Approval' },
-    ],
-    transitions: [{ from: 'validate-invoice', to: 'final-approval' }],
-  },
+	meta: {
+		key: 'billing.invoiceApproval',
+		version: '1.0.0',
+		title: 'Invoice Approval',
+		owners: [],
+		tags: [],
+		description: '',
+		domain: 'billing',
+		stability: StabilityEnum.Stable,
+	},
+	definition: {
+		steps: [
+			{ id: 'validate-invoice', type: 'automation', label: 'Validate Invoice' },
+			{ id: 'final-approval', type: 'human', label: 'Final Approval' },
+		],
+		transitions: [{ from: 'validate-invoice', to: 'final-approval' }],
+	},
 };
 
 export function composeTenantWorkflowExample(): WorkflowSpec {
-  const composer = new WorkflowComposer();
-  composer.register({
-    workflow: 'billing.invoiceApproval',
-    tenantId: 'acme',
-    customSteps: [
-      {
-        after: 'validate-invoice',
-        inject: {
-          id: 'acme-legal',
-          type: 'human',
-          label: 'ACME Legal Review',
-        },
-        transitionTo: 'final-approval',
-      },
-    ],
-  });
+	const composer = new WorkflowComposer();
+	composer.register({
+		workflow: 'billing.invoiceApproval',
+		tenantId: 'acme',
+		customSteps: [
+			{
+				after: 'validate-invoice',
+				inject: {
+					id: 'acme-legal',
+					type: 'human',
+					label: 'ACME Legal Review',
+				},
+				transitionTo: 'final-approval',
+			},
+		],
+	});
 
-  return composer.compose({
-    base: BaseWorkflow,
-    tenantId: 'acme',
-  });
+	return composer.compose({
+		base: BaseWorkflow,
+		tenantId: 'acme',
+	});
 }
 
 export function logTenantWorkflowSteps(workflow: WorkflowSpec): void {
-  logger.info('Tenant workflow composed', {
-    workflow: workflow.meta.key,
-    steps: workflow.definition.steps.map((step) => step.id),
-  });
+	logger.info('Tenant workflow composed', {
+		workflow: workflow.meta.key,
+		steps: workflow.definition.steps.map((step) => step.id),
+	});
 }

package/tsconfig.json

@@ -1,17 +1,19 @@
 {
-  "extends": "@contractspec/tool.typescript/react-library.json",
-  "include": ["src"],
-  "exclude": ["node_modules", "dist"],
-  "compilerOptions": {
-    "outDir": "dist",
-    "paths": {
-      "@contractspec/lib.personalization/*": ["../../libs/personalization/src/*"],
-      "@contractspec/lib.contracts-spec/*": ["../../libs/contracts/src/*"],
-      "@contractspec/lib.contracts-spec": ["../../libs/contracts/src/index.ts"],
-      "@contractspec/lib.overlay-engine/*": ["../../libs/overlay-engine/src/*"],
-      "@contractspec/lib.overlay-engine": ["../../libs/overlay-engine/src/index.ts"]
-    }
-  }
+	"extends": "@contractspec/tool.typescript/react-library.json",
+	"include": ["src"],
+	"exclude": ["node_modules", "dist"],
+	"compilerOptions": {
+		"outDir": "dist",
+		"paths": {
+			"@contractspec/lib.personalization/*": [
+				"../../libs/personalization/src/*"
+			],
+			"@contractspec/lib.contracts-spec/*": ["../../libs/contracts/src/*"],
+			"@contractspec/lib.contracts-spec": ["../../libs/contracts/src/index.ts"],
+			"@contractspec/lib.overlay-engine/*": ["../../libs/overlay-engine/src/*"],
+			"@contractspec/lib.overlay-engine": [
+				"../../libs/overlay-engine/src/index.ts"
+			]
+		}
+	}
 }
-
-

package/tsdown.config.js

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