@contractspec/lib.personalization 6.0.26 → 6.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.personalization",
-  "version": "6.0.26",
+  "version": "6.1.1",
   "description": "Behavior tracking, analysis, and adaptation helpers for ContractSpec personalization.",
   "keywords": [
     "contractspec",
@@ -32,16 +32,16 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.bus": "3.7.26",
+    "@contractspec/lib.bus": "3.7.28",
     "@contractspec/lib.schema": "3.7.14",
-    "@contractspec/lib.contracts-spec": "6.1.0",
-    "@contractspec/lib.knowledge": "3.8.2",
-    "@contractspec/lib.overlay-engine": "3.7.26",
+    "@contractspec/lib.contracts-spec": "6.3.0",
+    "@contractspec/lib.knowledge": "3.8.4",
+    "@contractspec/lib.overlay-engine": "3.7.28",
     "@opentelemetry/api": "^1.9.1"
   },
   "peerDependencies": {
     "@opentelemetry/api": "^1.9.1",
-    "@contractspec/lib.surface-runtime": "0.5.26"
+    "@contractspec/lib.surface-runtime": "0.5.28"
   },
   "peerDependenciesMeta": {
     "@contractspec/lib.surface-runtime": {
@@ -56,84 +56,78 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "browser": "./dist/browser/index.js",
       "bun": "./dist/index.js",
       "node": "./dist/node/index.js",
       "default": "./dist/index.js"
     },
     "./adapter": {
       "types": "./dist/adapter.d.ts",
-      "browser": "./dist/browser/adapter.js",
       "bun": "./dist/adapter.js",
       "node": "./dist/node/adapter.js",
       "default": "./dist/adapter.js"
     },
     "./analyzer": {
       "types": "./dist/analyzer.d.ts",
-      "browser": "./dist/browser/analyzer.js",
       "bun": "./dist/analyzer.js",
       "node": "./dist/node/analyzer.js",
       "default": "./dist/analyzer.js"
     },
+    "./data-view-preferences": {
+      "types": "./dist/data-view-preferences.d.ts",
+      "bun": "./dist/data-view-preferences.js",
+      "node": "./dist/node/data-view-preferences.js",
+      "default": "./dist/data-view-preferences.js"
+    },
     "./docs": {
       "types": "./dist/docs/index.d.ts",
-      "browser": "./dist/browser/docs/index.js",
       "bun": "./dist/docs/index.js",
       "node": "./dist/node/docs/index.js",
       "default": "./dist/docs/index.js"
     },
     "./docs/behavior-tracking.docblock": {
       "types": "./dist/docs/behavior-tracking.docblock.d.ts",
-      "browser": "./dist/browser/docs/behavior-tracking.docblock.js",
       "bun": "./dist/docs/behavior-tracking.docblock.js",
       "node": "./dist/node/docs/behavior-tracking.docblock.js",
       "default": "./dist/docs/behavior-tracking.docblock.js"
     },
     "./docs/overlay-engine.docblock": {
       "types": "./dist/docs/overlay-engine.docblock.d.ts",
-      "browser": "./dist/browser/docs/overlay-engine.docblock.js",
       "bun": "./dist/docs/overlay-engine.docblock.js",
       "node": "./dist/node/docs/overlay-engine.docblock.js",
       "default": "./dist/docs/overlay-engine.docblock.js"
     },
     "./docs/workflow-composition.docblock": {
       "types": "./dist/docs/workflow-composition.docblock.d.ts",
-      "browser": "./dist/browser/docs/workflow-composition.docblock.js",
       "bun": "./dist/docs/workflow-composition.docblock.js",
       "node": "./dist/node/docs/workflow-composition.docblock.js",
       "default": "./dist/docs/workflow-composition.docblock.js"
     },
     "./personalization.feature": {
       "types": "./dist/personalization.feature.d.ts",
-      "browser": "./dist/browser/personalization.feature.js",
       "bun": "./dist/personalization.feature.js",
       "node": "./dist/node/personalization.feature.js",
       "default": "./dist/personalization.feature.js"
     },
     "./preference-dimensions": {
       "types": "./dist/preference-dimensions.d.ts",
-      "browser": "./dist/browser/preference-dimensions.js",
       "bun": "./dist/preference-dimensions.js",
       "node": "./dist/node/preference-dimensions.js",
       "default": "./dist/preference-dimensions.js"
     },
     "./store": {
       "types": "./dist/store.d.ts",
-      "browser": "./dist/browser/store.js",
       "bun": "./dist/store.js",
       "node": "./dist/node/store.js",
       "default": "./dist/store.js"
     },
     "./tracker": {
       "types": "./dist/tracker.d.ts",
-      "browser": "./dist/browser/tracker.js",
       "bun": "./dist/tracker.js",
       "node": "./dist/node/tracker.js",
       "default": "./dist/tracker.js"
     },
     "./types": {
       "types": "./dist/types.d.ts",
-      "browser": "./dist/browser/types.js",
       "bun": "./dist/types.js",
       "node": "./dist/node/types.js",
       "default": "./dist/types.js"
@@ -144,84 +138,78 @@
     "exports": {
       ".": {
         "types": "./dist/index.d.ts",
-        "browser": "./dist/browser/index.js",
         "bun": "./dist/index.js",
         "node": "./dist/node/index.js",
         "default": "./dist/index.js"
       },
       "./adapter": {
         "types": "./dist/adapter.d.ts",
-        "browser": "./dist/browser/adapter.js",
         "bun": "./dist/adapter.js",
         "node": "./dist/node/adapter.js",
         "default": "./dist/adapter.js"
       },
       "./analyzer": {
         "types": "./dist/analyzer.d.ts",
-        "browser": "./dist/browser/analyzer.js",
         "bun": "./dist/analyzer.js",
         "node": "./dist/node/analyzer.js",
         "default": "./dist/analyzer.js"
       },
+      "./data-view-preferences": {
+        "types": "./dist/data-view-preferences.d.ts",
+        "bun": "./dist/data-view-preferences.js",
+        "node": "./dist/node/data-view-preferences.js",
+        "default": "./dist/data-view-preferences.js"
+      },
       "./docs": {
         "types": "./dist/docs/index.d.ts",
-        "browser": "./dist/browser/docs/index.js",
         "bun": "./dist/docs/index.js",
         "node": "./dist/node/docs/index.js",
         "default": "./dist/docs/index.js"
       },
       "./docs/behavior-tracking.docblock": {
         "types": "./dist/docs/behavior-tracking.docblock.d.ts",
-        "browser": "./dist/browser/docs/behavior-tracking.docblock.js",
         "bun": "./dist/docs/behavior-tracking.docblock.js",
         "node": "./dist/node/docs/behavior-tracking.docblock.js",
         "default": "./dist/docs/behavior-tracking.docblock.js"
       },
       "./docs/overlay-engine.docblock": {
         "types": "./dist/docs/overlay-engine.docblock.d.ts",
-        "browser": "./dist/browser/docs/overlay-engine.docblock.js",
         "bun": "./dist/docs/overlay-engine.docblock.js",
         "node": "./dist/node/docs/overlay-engine.docblock.js",
         "default": "./dist/docs/overlay-engine.docblock.js"
       },
       "./docs/workflow-composition.docblock": {
         "types": "./dist/docs/workflow-composition.docblock.d.ts",
-        "browser": "./dist/browser/docs/workflow-composition.docblock.js",
         "bun": "./dist/docs/workflow-composition.docblock.js",
         "node": "./dist/node/docs/workflow-composition.docblock.js",
         "default": "./dist/docs/workflow-composition.docblock.js"
       },
       "./personalization.feature": {
         "types": "./dist/personalization.feature.d.ts",
-        "browser": "./dist/browser/personalization.feature.js",
         "bun": "./dist/personalization.feature.js",
         "node": "./dist/node/personalization.feature.js",
         "default": "./dist/personalization.feature.js"
       },
       "./preference-dimensions": {
         "types": "./dist/preference-dimensions.d.ts",
-        "browser": "./dist/browser/preference-dimensions.js",
         "bun": "./dist/preference-dimensions.js",
         "node": "./dist/node/preference-dimensions.js",
         "default": "./dist/preference-dimensions.js"
       },
       "./store": {
         "types": "./dist/store.d.ts",
-        "browser": "./dist/browser/store.js",
         "bun": "./dist/store.js",
         "node": "./dist/node/store.js",
         "default": "./dist/store.js"
       },
       "./tracker": {
         "types": "./dist/tracker.d.ts",
-        "browser": "./dist/browser/tracker.js",
         "bun": "./dist/tracker.js",
         "node": "./dist/node/tracker.js",
         "default": "./dist/tracker.js"
       },
       "./types": {
         "types": "./dist/types.d.ts",
-        "browser": "./dist/browser/types.js",
         "bun": "./dist/types.js",
         "node": "./dist/node/types.js",
         "default": "./dist/types.js"

package/dist/browser/adapter.js

@@ -1 +0,0 @@
-function o(t,e){let r=[];if(t.suggestedHiddenFields.forEach((i)=>{r.push({type:"hideField",field:i,reason:"Automatically hidden because usage is near zero"})}),t.frequentlyUsedFields.length)r.push({type:"reorderFields",fields:t.frequentlyUsedFields});if(!r.length)return null;return{overlayId:e.overlayId,version:e.version??"1.0.0",appliesTo:{tenantId:e.tenantId,capability:e.capability,userId:e.userId,role:e.role},modifications:r,metadata:{generatedAt:new Date().toISOString(),automated:!0}}}function n(t){return t.workflowBottlenecks.map((e)=>({workflow:e.workflow,step:e.step,note:`High drop rate (${Math.round(e.dropRate*100)}%) detected`}))}export{n as insightsToWorkflowAdaptations,o as insightsToOverlaySuggestion};

package/dist/browser/analyzer.js

@@ -1 +0,0 @@
-class h{store;options;constructor(e,t={}){this.store=e;this.options=t}async analyze(e){let t={tenantId:e.tenantId,userId:e.userId,role:e.role};if(e.windowMs)t.since=Date.now()-e.windowMs;let i=await this.store.summarize(t);return y(i,this.options)}}function y(e,t){let i=t.fieldInactivityThreshold??3,d=t.minSamples??10,a=[],u=[];for(let[o,r]of Object.entries(e.fieldCounts)){if(r<=i)a.push(o);if(r>=i*4)u.push(o)}let c=Object.entries(e.workflowStepCounts).flatMap(([o,r])=>{let s=Object.values(r).reduce((n,l)=>n+l,0);if(!s||s<d)return[];return Object.entries(r).filter(([,n])=>n/s<0.4).map(([n,l])=>({workflow:o,step:n,dropRate:1-l/s}))}),f=m(e);return{unusedFields:a,suggestedHiddenFields:a.slice(0,5),frequentlyUsedFields:u.slice(0,10),workflowBottlenecks:c,layoutPreference:f}}function m(e){let t=Object.keys(e.fieldCounts).length;if(!t)return;if(t>=15)return"table";if(t>=8)return"grid";return"form"}export{h as BehaviorAnalyzer};

package/dist/browser/docs/behavior-tracking.docblock.js

@@ -1,80 +0,0 @@
-import{registerDocBlocks as d}from"@contractspec/lib.contracts-spec/docs";var f=[{id:"docs.personalization.behavior-tracking",title:"Behavior Tracking",summary:"`@contractspec/lib.personalization` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.",kind:"reference",visibility:"public",route:"/docs/personalization/behavior-tracking",tags:["personalization","behavior-tracking"],body:`# Behavior Tracking
-
-\`@contractspec/lib.personalization\` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.
-
-## Tracker
-
-\`\`\`ts
-import { createBehaviorTracker } from '@contractspec/lib.personalization';
-import { InMemoryBehaviorStore } from '@contractspec/lib.personalization/store';
-
-const tracker = createBehaviorTracker({
-  store: new InMemoryBehaviorStore(),
-  context: { tenantId: ctx.tenant.id, userId: ctx.identity.userId },
-  autoFlushIntervalMs: 5000,
-});
-
-tracker.trackFieldAccess({ operation: 'billing.createOrder', field: 'internalNotes' });
-tracker.trackFeatureUsage({ feature: 'workflow-editor', action: 'opened' });
-tracker.trackWorkflowStep({ workflow: 'invoice-approval', step: 'review', status: 'entered' });
-\`\`\`
-
-All events are buffered and flushed either when the buffer hits 25 entries or when \`autoFlushIntervalMs\` elapses. Tracked metrics flow to OpenTelemetry via the meter/counter built into the tracker.
-
-## Analyzer
-
-\`\`\`ts
-import { BehaviorAnalyzer } from '@contractspec/lib.personalization/analyzer';
-
-const analyzer = new BehaviorAnalyzer(store, { fieldInactivityThreshold: 2 });
-const insights = await analyzer.analyze({ tenantId: 'acme', userId: 'manager-42', windowMs: 7 * 24 * 60 * 60 * 1000 });
-
-/*
-{
-  unusedFields: ['internalNotes'],
-  suggestedHiddenFields: ['internalNotes'],
-  frequentlyUsedFields: ['customerReference', 'items'],
-  workflowBottlenecks: [{ workflow: 'invoice-approval', step: 'finance-review', dropRate: 0.6 }],
-  layoutPreference: 'table'
-}
-*/
-\`\`\`
-
-Use the analyzer output with the overlay adapter to generate suggestions automatically.
-
-## Adapter
-
-\`\`\`ts
-import { insightsToOverlaySuggestion } from '@contractspec/lib.personalization/adapter';
-
-const overlay = insightsToOverlaySuggestion(insights, {
-  overlayId: 'acme-order-form',
-  tenantId: 'acme',
-  capability: 'billing.createOrder',
-});
-\`\`\`
-
-When the adapter returns an overlay spec, pass it to the overlay engine to register or sign it.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-`}];d(f);export{f as personalization_behavior_tracking_DocBlocks};

package/dist/browser/docs/index.js

@@ -1,212 +0,0 @@
-import{registerDocBlocks as m}from"@contractspec/lib.contracts-spec/docs";var d=[{id:"docs.personalization.behavior-tracking",title:"Behavior Tracking",summary:"`@contractspec/lib.personalization` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.",kind:"reference",visibility:"public",route:"/docs/personalization/behavior-tracking",tags:["personalization","behavior-tracking"],body:`# Behavior Tracking
-
-\`@contractspec/lib.personalization\` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.
-
-## Tracker
-
-\`\`\`ts
-import { createBehaviorTracker } from '@contractspec/lib.personalization';
-import { InMemoryBehaviorStore } from '@contractspec/lib.personalization/store';
-
-const tracker = createBehaviorTracker({
-  store: new InMemoryBehaviorStore(),
-  context: { tenantId: ctx.tenant.id, userId: ctx.identity.userId },
-  autoFlushIntervalMs: 5000,
-});
-
-tracker.trackFieldAccess({ operation: 'billing.createOrder', field: 'internalNotes' });
-tracker.trackFeatureUsage({ feature: 'workflow-editor', action: 'opened' });
-tracker.trackWorkflowStep({ workflow: 'invoice-approval', step: 'review', status: 'entered' });
-\`\`\`
-
-All events are buffered and flushed either when the buffer hits 25 entries or when \`autoFlushIntervalMs\` elapses. Tracked metrics flow to OpenTelemetry via the meter/counter built into the tracker.
-
-## Analyzer
-
-\`\`\`ts
-import { BehaviorAnalyzer } from '@contractspec/lib.personalization/analyzer';
-
-const analyzer = new BehaviorAnalyzer(store, { fieldInactivityThreshold: 2 });
-const insights = await analyzer.analyze({ tenantId: 'acme', userId: 'manager-42', windowMs: 7 * 24 * 60 * 60 * 1000 });
-
-/*
-{
-  unusedFields: ['internalNotes'],
-  suggestedHiddenFields: ['internalNotes'],
-  frequentlyUsedFields: ['customerReference', 'items'],
-  workflowBottlenecks: [{ workflow: 'invoice-approval', step: 'finance-review', dropRate: 0.6 }],
-  layoutPreference: 'table'
-}
-*/
-\`\`\`
-
-Use the analyzer output with the overlay adapter to generate suggestions automatically.
-
-## Adapter
-
-\`\`\`ts
-import { insightsToOverlaySuggestion } from '@contractspec/lib.personalization/adapter';
-
-const overlay = insightsToOverlaySuggestion(insights, {
-  overlayId: 'acme-order-form',
-  tenantId: 'acme',
-  capability: 'billing.createOrder',
-});
-\`\`\`
-
-When the adapter returns an overlay spec, pass it to the overlay engine to register or sign it.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-`}];m(d);import{registerDocBlocks as j}from"@contractspec/lib.contracts-spec/docs";var q=[{id:"docs.personalization.overlay-engine",title:"Overlay Engine",summary:"`@contractspec/lib.overlay-engine` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.",kind:"reference",visibility:"public",route:"/docs/personalization/overlay-engine",tags:["personalization","overlay-engine"],body:`# Overlay Engine
-
-\`@contractspec/lib.overlay-engine\` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.
-
-## Key APIs
-
-- \`defineOverlay(spec)\` – helper to keep specs typed.
-- \`OverlayRegistry\` – register signed overlays and retrieve them per context.
-- \`OverlayEngine\` – apply overlays to renderable targets, emit audit events, and merge modifications deterministically.
-- \`signOverlay(spec, privateKey)\` – Ed25519/RSA-PSS signer.
-- \`verifyOverlaySignature(overlay)\` – verify public key signatures.
-- \`useOverlay(engine, params)\` – client hook that returns \`{ target, overlaysApplied }\`.
-
-## Scope Precedence
-
-Registrations are sorted by specificity:
-
-1. Tenant overlays
-2. Role overlays
-3. User overlays
-4. Device overlays
-
-Less specific overlays run first; more specific overlays override later.
-
-## Example
-
-\`\`\`ts
-const registry = new OverlayRegistry();
-const engine = new OverlayEngine({
-  registry,
-  audit: (event) => auditLogService.record(event),
-});
-
-const overlay = defineOverlay({
-  overlayId: 'acme-order-form',
-  version: '1.0.0',
-  appliesTo: {
-    capability: 'billing.createOrder',
-    tenantId: 'acme',
-  },
-  modifications: [
-    { type: 'hideField', field: 'internalNotes' },
-    { type: 'renameLabel', field: 'customerReference', newLabel: 'PO Number' },
-  ],
-});
-
-const signedOverlay = await signOverlay(overlay, privateKeyPem);
-registry.register(signedOverlay);
-
-const result = engine.apply({
-  target: { fields: baseFields },
-  capability: 'billing.createOrder',
-  tenantId: 'acme',
-  userId: 'manager-7',
-});
-\`\`\`
-
-\`result.target.fields\` now carries the hidden and renamed outputs ready for rendering.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-`}];j(q);import{registerDocBlocks as u}from"@contractspec/lib.contracts-spec/docs";var x=[{id:"docs.personalization.workflow-composition",title:"Workflow Composition",summary:"`@contractspec/lib.workflow-composer` composes base WorkflowSpecs with tenant/role/device-specific extensions, strict validation, deterministic merge ordering, metadata/annotation overlays, and orphan-graph protection for hidden-step rewrites.",kind:"reference",visibility:"public",route:"/docs/personalization/workflow-composition",tags:["personalization","workflow-composition"],body:`# Workflow Composition
-
-\`@contractspec/lib.workflow-composer\` composes base WorkflowSpecs with tenant/role/device-specific extensions.
-
-## Extensions
-
-\`\`\`ts
-import { WorkflowComposer } from '@contractspec/lib.workflow-composer';
-import { approvalStepTemplate } from '@contractspec/lib.workflow-composer/templates';
-
-const composer = new WorkflowComposer();
-
-composer.register({
-  workflow: 'billing.invoiceApproval',
-  tenantId: 'acme',
-  priority: 10,
-  customSteps: [
-    {
-      after: 'validate-invoice',
-      inject: approvalStepTemplate({
-        id: 'acme-legal-review',
-        label: 'Legal Review (ACME)',
-        description: 'Tenant-specific compliance step.',
-      }),
-      transitionFrom: 'validate-invoice',
-      transitionTo: 'final-approval',
-    },
-  ],
-  hiddenSteps: ['internal-audit'],
-  metadata: { rollout: 'tenant-acme' },
-});
-\`\`\`
-
-## Compose
-
-\`\`\`ts
-const runtimeSpec = composer.compose({
-  base: BaseInvoiceWorkflow,
-  tenantId: 'acme',
-});
-
-workflowRunner.execute(runtimeSpec, ctx);
-\`\`\`
-
-## Guarantees
-
-- Extensions are normalized in deterministic priority order before composition.
-- Duplicate injected step ids, invalid anchors, and invalid transition endpoints are rejected early.
-- Hidden-step rewrites are validated so remaining steps stay reachable from the workflow entry step.
-- \`metadata\` and \`annotations\` overlays are merged into the composed runtime workflow for downstream observability and rollout tracing.
-
-This keeps tenant overlays additive, auditable, and replay-safe.
-`}];u(x);

package/dist/browser/docs/overlay-engine.docblock.js

@@ -1,81 +0,0 @@
-import{registerDocBlocks as b}from"@contractspec/lib.contracts-spec/docs";var d=[{id:"docs.personalization.overlay-engine",title:"Overlay Engine",summary:"`@contractspec/lib.overlay-engine` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.",kind:"reference",visibility:"public",route:"/docs/personalization/overlay-engine",tags:["personalization","overlay-engine"],body:`# Overlay Engine
-
-\`@contractspec/lib.overlay-engine\` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.
-
-## Key APIs
-
-- \`defineOverlay(spec)\` – helper to keep specs typed.
-- \`OverlayRegistry\` – register signed overlays and retrieve them per context.
-- \`OverlayEngine\` – apply overlays to renderable targets, emit audit events, and merge modifications deterministically.
-- \`signOverlay(spec, privateKey)\` – Ed25519/RSA-PSS signer.
-- \`verifyOverlaySignature(overlay)\` – verify public key signatures.
-- \`useOverlay(engine, params)\` – client hook that returns \`{ target, overlaysApplied }\`.
-
-## Scope Precedence
-
-Registrations are sorted by specificity:
-
-1. Tenant overlays
-2. Role overlays
-3. User overlays
-4. Device overlays
-
-Less specific overlays run first; more specific overlays override later.
-
-## Example
-
-\`\`\`ts
-const registry = new OverlayRegistry();
-const engine = new OverlayEngine({
-  registry,
-  audit: (event) => auditLogService.record(event),
-});
-
-const overlay = defineOverlay({
-  overlayId: 'acme-order-form',
-  version: '1.0.0',
-  appliesTo: {
-    capability: 'billing.createOrder',
-    tenantId: 'acme',
-  },
-  modifications: [
-    { type: 'hideField', field: 'internalNotes' },
-    { type: 'renameLabel', field: 'customerReference', newLabel: 'PO Number' },
-  ],
-});
-
-const signedOverlay = await signOverlay(overlay, privateKeyPem);
-registry.register(signedOverlay);
-
-const result = engine.apply({
-  target: { fields: baseFields },
-  capability: 'billing.createOrder',
-  tenantId: 'acme',
-  userId: 'manager-7',
-});
-\`\`\`
-
-\`result.target.fields\` now carries the hidden and renamed outputs ready for rendering.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-`}];b(d);export{d as personalization_overlay_engine_DocBlocks};

package/dist/browser/docs/workflow-composition.docblock.js

@@ -1,53 +0,0 @@
-import{registerDocBlocks as b}from"@contractspec/lib.contracts-spec/docs";var d=[{id:"docs.personalization.workflow-composition",title:"Workflow Composition",summary:"`@contractspec/lib.workflow-composer` composes base WorkflowSpecs with tenant/role/device-specific extensions, strict validation, deterministic merge ordering, metadata/annotation overlays, and orphan-graph protection for hidden-step rewrites.",kind:"reference",visibility:"public",route:"/docs/personalization/workflow-composition",tags:["personalization","workflow-composition"],body:`# Workflow Composition
-
-\`@contractspec/lib.workflow-composer\` composes base WorkflowSpecs with tenant/role/device-specific extensions.
-
-## Extensions
-
-\`\`\`ts
-import { WorkflowComposer } from '@contractspec/lib.workflow-composer';
-import { approvalStepTemplate } from '@contractspec/lib.workflow-composer/templates';
-
-const composer = new WorkflowComposer();
-
-composer.register({
-  workflow: 'billing.invoiceApproval',
-  tenantId: 'acme',
-  priority: 10,
-  customSteps: [
-    {
-      after: 'validate-invoice',
-      inject: approvalStepTemplate({
-        id: 'acme-legal-review',
-        label: 'Legal Review (ACME)',
-        description: 'Tenant-specific compliance step.',
-      }),
-      transitionFrom: 'validate-invoice',
-      transitionTo: 'final-approval',
-    },
-  ],
-  hiddenSteps: ['internal-audit'],
-  metadata: { rollout: 'tenant-acme' },
-});
-\`\`\`
-
-## Compose
-
-\`\`\`ts
-const runtimeSpec = composer.compose({
-  base: BaseInvoiceWorkflow,
-  tenantId: 'acme',
-});
-
-workflowRunner.execute(runtimeSpec, ctx);
-\`\`\`
-
-## Guarantees
-
-- Extensions are normalized in deterministic priority order before composition.
-- Duplicate injected step ids, invalid anchors, and invalid transition endpoints are rejected early.
-- Hidden-step rewrites are validated so remaining steps stay reachable from the workflow entry step.
-- \`metadata\` and \`annotations\` overlays are merged into the composed runtime workflow for downstream observability and rollout tracing.
-
-This keeps tenant overlays additive, auditable, and replay-safe.
-`}];b(d);export{d as personalization_workflow_composition_DocBlocks};