@contractspec/example.personalization 1.57.0 → 1.59.0

package/.turbo/turbo-build.log

@@ -1,40 +1,38 @@
-$ bun build:types && bun build:bundle
-$ tsc --noEmit
-$ tsdown
-ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
-ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/personalization/tsdown.config.js 
-ℹ entry: src/behavior-tracking.ts, src/example.ts, src/index.ts, src/overlay-customization.ts, src/workflow-extension.ts, src/docs/index.ts, src/docs/personalization.docblock.ts
-ℹ target: esnext
-ℹ tsconfig: tsconfig.json
-ℹ Build start
-ℹ Cleaning 1 files
-ℹ dist/workflow-extension.js                 1.67 kB │ gzip: 0.71 kB
-ℹ dist/overlay-customization.js              1.57 kB │ gzip: 0.68 kB
-ℹ dist/docs/personalization.docblock.js      1.48 kB │ gzip: 0.70 kB
-ℹ dist/behavior-tracking.js                  1.43 kB │ gzip: 0.62 kB
-ℹ dist/example.js                            0.99 kB │ gzip: 0.52 kB
-ℹ dist/index.js                              0.44 kB │ gzip: 0.19 kB
-ℹ dist/docs/index.js                         0.04 kB │ gzip: 0.06 kB
-ℹ dist/workflow-extension.js.map             2.80 kB │ gzip: 1.16 kB
-ℹ dist/overlay-customization.js.map          2.55 kB │ gzip: 1.08 kB
-ℹ dist/behavior-tracking.js.map              2.23 kB │ gzip: 0.94 kB
-ℹ dist/docs/personalization.docblock.js.map  1.98 kB │ gzip: 0.89 kB
-ℹ dist/example.js.map                        1.46 kB │ gzip: 0.71 kB
-ℹ dist/workflow-extension.d.ts.map           0.19 kB │ gzip: 0.16 kB
-ℹ dist/overlay-customization.d.ts.map        0.15 kB │ gzip: 0.14 kB
-ℹ dist/behavior-tracking.d.ts.map            0.14 kB │ gzip: 0.13 kB
-ℹ dist/example.d.ts.map                      0.13 kB │ gzip: 0.13 kB
-ℹ dist/index.d.ts                            0.41 kB │ gzip: 0.18 kB
-ℹ dist/workflow-extension.d.ts               0.37 kB │ gzip: 0.21 kB
-ℹ dist/example.d.ts                          0.25 kB │ gzip: 0.17 kB
-ℹ dist/overlay-customization.d.ts            0.21 kB │ gzip: 0.15 kB
-ℹ dist/behavior-tracking.d.ts                0.20 kB │ gzip: 0.15 kB
-ℹ dist/docs/index.d.ts                       0.01 kB │ gzip: 0.03 kB
-ℹ dist/docs/personalization.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
-ℹ 23 files, total: 20.71 kB
-[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
-  - tsdown:external (59%)
-  - rolldown-plugin-dts:generate (27%)
-See https://rolldown.rs/options/checks#plugintimings for more details.
+$ contractspec-bun-build prebuild
+$ 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=7
+Bundled 7 modules in 47ms
 
-✔ Build complete in 26223ms
+  ./behavior-tracking.js            1.33 KB  (entry point)
+  ./index.js                        6.90 KB  (entry point)
+  docs/index.js                     1.47 KB  (entry point)
+  docs/personalization.docblock.js  1.47 KB  (entry point)
+  ./example.js                      0.99 KB  (entry point)
+  ./overlay-customization.js        1.53 KB  (entry point)
+  ./workflow-extension.js           1.58 KB  (entry point)
+
+[contractspec-bun-build] transpile target=node root=src entries=7
+Bundled 7 modules in 24ms
+
+  ./behavior-tracking.js            1.32 KB  (entry point)
+  ./index.js                        6.89 KB  (entry point)
+  docs/index.js                     1.46 KB  (entry point)
+  docs/personalization.docblock.js  1.46 KB  (entry point)
+  ./example.js                      0.98 KB  (entry point)
+  ./overlay-customization.js        1.53 KB  (entry point)
+  ./workflow-extension.js           1.58 KB  (entry point)
+
+[contractspec-bun-build] transpile target=browser root=src entries=7
+Bundled 7 modules in 25ms
+
+  ./behavior-tracking.js            1.32 KB  (entry point)
+  ./index.js                        6.89 KB  (entry point)
+  docs/index.js                     1.46 KB  (entry point)
+  docs/personalization.docblock.js  1.46 KB  (entry point)
+  ./example.js                      0.98 KB  (entry point)
+  ./overlay-customization.js        1.53 KB  (entry point)
+  ./workflow-extension.js           1.58 KB  (entry point)
+
+$ contractspec-bun-build types

package/.turbo/turbo-prebuild.log

@@ -0,0 +1 @@
+$ contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @contractspec/example.personalization
 
+## 1.59.0
+
+### Minor Changes
+
+- 1a0cf44: fix: publishConfig not supported by bun
+
+### Patch Changes
+
+- Updated dependencies [1a0cf44]
+  - @contractspec/lib.workflow-composer@1.59.0
+  - @contractspec/lib.personalization@1.59.0
+  - @contractspec/lib.overlay-engine@1.59.0
+  - @contractspec/lib.contracts@1.59.0
+  - @contractspec/lib.logger@1.59.0
+
+## 1.58.0
+
+### Minor Changes
+
+- d1f0fd0: chore: Migrate non-app package builds from tsdown to shared Bun tooling, add `@contractspec/tool.bun`, and standardize `prebuild`/`build`/`typecheck` with platform-aware exports and `tsc` declaration emission into `dist`.
+
+### Patch Changes
+
+- Updated dependencies [d1f0fd0]
+- Updated dependencies [4355a9e]
+  - @contractspec/lib.workflow-composer@1.58.0
+  - @contractspec/lib.personalization@1.58.0
+  - @contractspec/lib.overlay-engine@1.58.0
+  - @contractspec/lib.contracts@1.58.0
+  - @contractspec/lib.logger@1.58.0
+
 ## 1.57.0
 
 ### Minor Changes

package/dist/behavior-tracking.d.ts

@@ -1,5 +1,2 @@
-//#region src/behavior-tracking.d.ts
-declare function runBehaviorTrackingExample(): Promise<void>;
-//#endregion
-export { runBehaviorTrackingExample };
+export declare function runBehaviorTrackingExample(): Promise<void>;
 //# sourceMappingURL=behavior-tracking.d.ts.map

package/dist/behavior-tracking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"behavior-tracking.d.ts","names":[],"sources":["../src/behavior-tracking.ts"],"mappings":";iBAasB,0BAAA,CAAA,GAA8B,OAAA"}
+{"version":3,"file":"behavior-tracking.d.ts","sourceRoot":"","sources":["../src/behavior-tracking.ts"],"names":[],"mappings":"AAaA,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CAiChE"}

package/dist/behavior-tracking.js

@@ -1,48 +1,45 @@
+// @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 { LogLevel, Logger } from "@contractspec/lib.logger";
-
-//#region src/behavior-tracking.ts
-const logger = new Logger({
-	level: process.env.NODE_ENV === "production" ? LogLevel.INFO : LogLevel.DEBUG,
-	environment: process.env.NODE_ENV || "development",
-	enableColors: process.env.NODE_ENV !== "production"
+import { Logger, LogLevel } from "@contractspec/lib.logger";
+var logger = new Logger({
+  level: LogLevel.DEBUG,
+  environment: "development",
+  enableColors: true
 });
 async function runBehaviorTrackingExample() {
-	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();
-	const insights = await new BehaviorAnalyzer(store).analyze({
-		tenantId: "acme",
-		userId: "user-123"
-	});
-	logger.info("Behavior insights computed", { insights });
+  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();
+  const analyzer = new BehaviorAnalyzer(store);
+  const insights = await analyzer.analyze({
+    tenantId: "acme",
+    userId: "user-123"
+  });
+  logger.info("Behavior insights computed", { insights });
 }
-
-//#endregion
-export { runBehaviorTrackingExample };
-//# sourceMappingURL=behavior-tracking.js.map
+export {
+  runBehaviorTrackingExample
+};

package/dist/browser/behavior-tracking.js

@@ -0,0 +1,44 @@
+// 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";
+var logger = new Logger({
+  level: LogLevel.DEBUG,
+  environment: "development",
+  enableColors: true
+});
+async function runBehaviorTrackingExample() {
+  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();
+  const analyzer = new BehaviorAnalyzer(store);
+  const insights = await analyzer.analyze({
+    tenantId: "acme",
+    userId: "user-123"
+  });
+  logger.info("Behavior insights computed", { insights });
+}
+export {
+  runBehaviorTrackingExample
+};

package/dist/browser/docs/index.js

@@ -0,0 +1,40 @@
+// src/docs/personalization.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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
+- Behavior tracking + insight analysis.
+- Overlay customization (hide fields, rename labels).
+- Workflow extension (inject tenant-specific steps).
+
+## Guardrails
+- Keep tracking events structured and non-PII.
+- Keep overlays signed and scoped.
+- 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
+- Call \`runBehaviorTrackingExample()\` for insights.
+- Call \`runOverlayCustomizationExample()\` to apply overlays.
+- Call \`composeTenantWorkflowExample()\` and \`logTenantWorkflowSteps()\` to inspect steps.
+
+## Notes
+- Replace in-memory stores with app-layer storage.
+- Keep PII out of logs and markdown outputs.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/browser/docs/personalization.docblock.js

@@ -0,0 +1,40 @@
+// src/docs/personalization.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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
+- Behavior tracking + insight analysis.
+- Overlay customization (hide fields, rename labels).
+- Workflow extension (inject tenant-specific steps).
+
+## Guardrails
+- Keep tracking events structured and non-PII.
+- Keep overlays signed and scoped.
+- 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
+- Call \`runBehaviorTrackingExample()\` for insights.
+- Call \`runOverlayCustomizationExample()\` to apply overlays.
+- Call \`composeTenantWorkflowExample()\` and \`logTenantWorkflowSteps()\` to inspect steps.
+
+## Notes
+- Replace in-memory stores with app-layer storage.
+- Keep PII out of logs and markdown outputs.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/browser/example.js

@@ -0,0 +1,33 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var 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 }
+  }
+});
+var example_default = example;
+export {
+  example_default as default
+};

package/dist/browser/index.js

@@ -0,0 +1,227 @@
+// 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";
+var logger = new Logger({
+  level: LogLevel.DEBUG,
+  environment: "development",
+  enableColors: true
+});
+async function runBehaviorTrackingExample() {
+  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();
+  const analyzer = new BehaviorAnalyzer(store);
+  const insights = await analyzer.analyze({
+    tenantId: "acme",
+    userId: "user-123"
+  });
+  logger.info("Behavior insights computed", { insights });
+}
+
+// src/docs/personalization.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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
+- Behavior tracking + insight analysis.
+- Overlay customization (hide fields, rename labels).
+- Workflow extension (inject tenant-specific steps).
+
+## Guardrails
+- Keep tracking events structured and non-PII.
+- Keep overlays signed and scoped.
+- 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
+- Call \`runBehaviorTrackingExample()\` for insights.
+- Call \`runOverlayCustomizationExample()\` to apply overlays.
+- Call \`composeTenantWorkflowExample()\` and \`logTenantWorkflowSteps()\` to inspect steps.
+
+## Notes
+- Replace in-memory stores with app-layer storage.
+- Keep PII out of logs and markdown outputs.`
+  }
+];
+registerDocBlocks(blocks);
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var 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 }
+  }
+});
+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 {
+  OverlayEngine,
+  OverlayRegistry
+} from "@contractspec/lib.overlay-engine";
+import { Logger as Logger2, LogLevel as LogLevel2 } from "@contractspec/lib.logger";
+var logger2 = new Logger2({
+  level: LogLevel2.DEBUG,
+  environment: "development",
+  enableColors: true
+});
+async function runOverlayCustomizationExample() {
+  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 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"
+  });
+  logger2.info("Overlay applied", { fields: result.target.fields });
+}
+
+// src/workflow-extension.ts
+import { StabilityEnum } from "@contractspec/lib.contracts";
+import { WorkflowComposer } from "@contractspec/lib.workflow-composer";
+import { Logger as Logger3, LogLevel as LogLevel3 } from "@contractspec/lib.logger";
+var logger3 = new Logger3({
+  level: LogLevel3.DEBUG,
+  environment: "development",
+  enableColors: true
+});
+var BaseWorkflow = {
+  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" }]
+  }
+};
+function composeTenantWorkflowExample() {
+  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"
+  });
+}
+function logTenantWorkflowSteps(workflow) {
+  logger3.info("Tenant workflow composed", {
+    workflow: workflow.meta.key,
+    steps: workflow.definition.steps.map((step) => step.id)
+  });
+}
+export {
+  runOverlayCustomizationExample,
+  runBehaviorTrackingExample,
+  logTenantWorkflowSteps,
+  example_default as example,
+  composeTenantWorkflowExample
+};

package/dist/browser/overlay-customization.js

@@ -0,0 +1,53 @@
+// src/overlay-customization.ts
+import { defineOverlay } from "@contractspec/lib.overlay-engine/spec";
+import { signOverlay } from "@contractspec/lib.overlay-engine/signer";
+import {
+  OverlayEngine,
+  OverlayRegistry
+} from "@contractspec/lib.overlay-engine";
+import { Logger, LogLevel } from "@contractspec/lib.logger";
+var logger = new Logger({
+  level: LogLevel.DEBUG,
+  environment: "development",
+  enableColors: true
+});
+async function runOverlayCustomizationExample() {
+  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 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"
+  });
+  logger.info("Overlay applied", { fields: result.target.fields });
+}
+export {
+  runOverlayCustomizationExample
+};