@contractspec/lib.personalization 0.0.0-canary-20260113162409

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,30 @@
+# @contractspec/lib.personalization
+
+Website: https://contractspec.io/
+
+
+Composable behavior tracking and personalization primitives for ContractSpec applications. The library provides trackers that capture feature usage, analyzers that transform raw events into adaptation hints, and adapters that feed personalized overlays or workflow tweaks.
+
+## Modules
+
+- `tracker` – lightweight tracker helpers that record field/feature/workflow usage.
+- `store` – store abstractions plus an in-memory implementation.
+- `analyzer` – stateless analyzers that convert usage data into insights.
+- `adapter` – bridges insights into OverlaySpecs or WorkflowComposer extensions.
+
+See `docs/tech/personalization/behavior-tracking.md` for full usage notes.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

package/dist/adapter.d.ts

@@ -0,0 +1,22 @@
+import { BehaviorInsights } from "./types.js";
+import { OverlaySpec } from "@contractspec/lib.overlay-engine";
+
+//#region src/adapter.d.ts
+interface OverlaySuggestionOptions {
+  overlayId: string;
+  tenantId: string;
+  capability: string;
+  userId?: string;
+  role?: string;
+  version?: string;
+}
+interface WorkflowAdaptation {
+  workflow: string;
+  step: string;
+  note: string;
+}
+declare function insightsToOverlaySuggestion(insights: BehaviorInsights, options: OverlaySuggestionOptions): OverlaySpec | null;
+declare function insightsToWorkflowAdaptations(insights: BehaviorInsights): WorkflowAdaptation[];
+//#endregion
+export { OverlaySuggestionOptions, WorkflowAdaptation, insightsToOverlaySuggestion, insightsToWorkflowAdaptations };
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","names":[],"sources":["../src/adapter.ts"],"sourcesContent":[],"mappings":";;;;UAMiB,wBAAA;;EAAA,QAAA,EAAA,MAAA;EASA,UAAA,EAAA,MAAA;EAMD,MAAA,CAAA,EAAA,MAAA;EACJ,IAAA,CAAA,EAAA,MAAA;EACD,OAAA,CAAA,EAAA,MAAA;;AACG,UATG,kBAAA,CASH;EAuCE,QAAA,EAAA,MAAA;;;;iBA1CA,2BAAA,WACJ,2BACD,2BACR;iBAuCa,6BAAA,WACJ,mBACT"}

package/dist/adapter.js

@@ -0,0 +1,42 @@
+//#region src/adapter.ts
+function insightsToOverlaySuggestion(insights, options) {
+	const modifications = [];
+	insights.suggestedHiddenFields.forEach((field) => {
+		modifications.push({
+			type: "hideField",
+			field,
+			reason: "Automatically hidden because usage is near zero"
+		});
+	});
+	if (insights.frequentlyUsedFields.length) modifications.push({
+		type: "reorderFields",
+		fields: insights.frequentlyUsedFields
+	});
+	if (!modifications.length) return null;
+	return {
+		overlayId: options.overlayId,
+		version: options.version ?? "1.0.0",
+		appliesTo: {
+			tenantId: options.tenantId,
+			capability: options.capability,
+			userId: options.userId,
+			role: options.role
+		},
+		modifications,
+		metadata: {
+			generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			automated: true
+		}
+	};
+}
+function insightsToWorkflowAdaptations(insights) {
+	return insights.workflowBottlenecks.map((bottleneck) => ({
+		workflow: bottleneck.workflow,
+		step: bottleneck.step,
+		note: `High drop rate (${Math.round(bottleneck.dropRate * 100)}%) detected`
+	}));
+}
+
+//#endregion
+export { insightsToOverlaySuggestion, insightsToWorkflowAdaptations };
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","names":[],"sources":["../src/adapter.ts"],"sourcesContent":["import type {\n  OverlayModification,\n  OverlaySpec,\n} from '@contractspec/lib.overlay-engine';\nimport type { BehaviorInsights } from './types';\n\nexport interface OverlaySuggestionOptions {\n  overlayId: string;\n  tenantId: string;\n  capability: string;\n  userId?: string;\n  role?: string;\n  version?: string;\n}\n\nexport interface WorkflowAdaptation {\n  workflow: string;\n  step: string;\n  note: string;\n}\n\nexport function insightsToOverlaySuggestion(\n  insights: BehaviorInsights,\n  options: OverlaySuggestionOptions\n): OverlaySpec | null {\n  const modifications: OverlayModification[] = [];\n\n  insights.suggestedHiddenFields.forEach((field) => {\n    modifications.push({\n      type: 'hideField',\n      field,\n      reason: 'Automatically hidden because usage is near zero',\n    });\n  });\n\n  if (insights.frequentlyUsedFields.length) {\n    modifications.push({\n      type: 'reorderFields',\n      fields: insights.frequentlyUsedFields,\n    });\n  }\n\n  if (!modifications.length) {\n    return null;\n  }\n\n  return {\n    overlayId: options.overlayId,\n    version: options.version ?? '1.0.0',\n    appliesTo: {\n      tenantId: options.tenantId,\n      capability: options.capability,\n      userId: options.userId,\n      role: options.role,\n    },\n    modifications,\n    metadata: {\n      generatedAt: new Date().toISOString(),\n      automated: true,\n    },\n  };\n}\n\nexport function insightsToWorkflowAdaptations(\n  insights: BehaviorInsights\n): WorkflowAdaptation[] {\n  return insights.workflowBottlenecks.map((bottleneck) => ({\n    workflow: bottleneck.workflow,\n    step: bottleneck.step,\n    note: `High drop rate (${Math.round(bottleneck.dropRate * 100)}%) detected`,\n  }));\n}\n"],"mappings":";AAqBA,SAAgB,4BACd,UACA,SACoB;CACpB,MAAM,gBAAuC,EAAE;AAE/C,UAAS,sBAAsB,SAAS,UAAU;AAChD,gBAAc,KAAK;GACjB,MAAM;GACN;GACA,QAAQ;GACT,CAAC;GACF;AAEF,KAAI,SAAS,qBAAqB,OAChC,eAAc,KAAK;EACjB,MAAM;EACN,QAAQ,SAAS;EAClB,CAAC;AAGJ,KAAI,CAAC,cAAc,OACjB,QAAO;AAGT,QAAO;EACL,WAAW,QAAQ;EACnB,SAAS,QAAQ,WAAW;EAC5B,WAAW;GACT,UAAU,QAAQ;GAClB,YAAY,QAAQ;GACpB,QAAQ,QAAQ;GAChB,MAAM,QAAQ;GACf;EACD;EACA,UAAU;GACR,8BAAa,IAAI,MAAM,EAAC,aAAa;GACrC,WAAW;GACZ;EACF;;AAGH,SAAgB,8BACd,UACsB;AACtB,QAAO,SAAS,oBAAoB,KAAK,gBAAgB;EACvD,UAAU,WAAW;EACrB,MAAM,WAAW;EACjB,MAAM,mBAAmB,KAAK,MAAM,WAAW,WAAW,IAAI,CAAC;EAChE,EAAE"}

package/dist/analyzer.d.ts

@@ -0,0 +1,23 @@
+import { BehaviorInsights } from "./types.js";
+import { BehaviorStore } from "./store.js";
+
+//#region src/analyzer.d.ts
+interface BehaviorAnalyzerOptions {
+  fieldInactivityThreshold?: number;
+  minSamples?: number;
+}
+interface AnalyzeParams {
+  tenantId: string;
+  userId?: string;
+  role?: string;
+  windowMs?: number;
+}
+declare class BehaviorAnalyzer {
+  private readonly store;
+  private readonly options;
+  constructor(store: BehaviorStore, options?: BehaviorAnalyzerOptions);
+  analyze(params: AnalyzeParams): Promise<BehaviorInsights>;
+}
+//#endregion
+export { AnalyzeParams, BehaviorAnalyzer, BehaviorAnalyzerOptions };
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","names":[],"sources":["../src/analyzer.ts"],"sourcesContent":[],"mappings":";;;;UAGiB,uBAAA;;EAAA,UAAA,CAAA,EAAA,MAAA;AAKjB;AASa,UATI,aAAA,CASY;EAED,QAAA,EAAA,MAAA;EACE,MAAA,CAAA,EAAA,MAAA;EAGN,IAAA,CAAA,EAAA,MAAA;EAAwB,QAAA,CAAA,EAAA,MAAA;;AAAD,cANlC,gBAAA,CAMkC;;;qBAJnB,yBACE;kBAGN,gBAAgB,QAAQ"}

package/dist/analyzer.js

@@ -0,0 +1,55 @@
+//#region src/analyzer.ts
+const DEFAULT_THRESHOLD = 3;
+var BehaviorAnalyzer = class {
+	constructor(store, options = {}) {
+		this.store = store;
+		this.options = options;
+	}
+	async analyze(params) {
+		const query = {
+			tenantId: params.tenantId,
+			userId: params.userId,
+			role: params.role
+		};
+		if (params.windowMs) query.since = Date.now() - params.windowMs;
+		return buildInsights(await this.store.summarize(query), this.options);
+	}
+};
+function buildInsights(summary, options) {
+	const threshold = options.fieldInactivityThreshold ?? DEFAULT_THRESHOLD;
+	const minSamples = options.minSamples ?? 10;
+	const ignoredFields = [];
+	const frequentlyUsedFields = [];
+	for (const [field, count] of Object.entries(summary.fieldCounts)) {
+		if (count <= threshold) ignoredFields.push(field);
+		if (count >= threshold * 4) frequentlyUsedFields.push(field);
+	}
+	const workflowBottlenecks = Object.entries(summary.workflowStepCounts).flatMap(([workflow, steps]) => {
+		const total = Object.values(steps).reduce((acc, value) => acc + value, 0);
+		if (!total || total < minSamples) return [];
+		return Object.entries(steps).filter(([, count]) => count / total < .4).map(([step, count]) => ({
+			workflow,
+			step,
+			dropRate: 1 - count / total
+		}));
+	});
+	const layoutPreference = detectLayout(summary);
+	return {
+		unusedFields: ignoredFields,
+		suggestedHiddenFields: ignoredFields.slice(0, 5),
+		frequentlyUsedFields: frequentlyUsedFields.slice(0, 10),
+		workflowBottlenecks,
+		layoutPreference
+	};
+}
+function detectLayout(summary) {
+	const fieldCount = Object.keys(summary.fieldCounts).length;
+	if (!fieldCount) return;
+	if (fieldCount >= 15) return "table";
+	if (fieldCount >= 8) return "grid";
+	return "form";
+}
+
+//#endregion
+export { BehaviorAnalyzer };
+//# sourceMappingURL=analyzer.js.map

package/dist/analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.js","names":[],"sources":["../src/analyzer.ts"],"sourcesContent":["import type { BehaviorStore } from './store';\nimport type { BehaviorInsights, BehaviorQuery, BehaviorSummary } from './types';\n\nexport interface BehaviorAnalyzerOptions {\n  fieldInactivityThreshold?: number;\n  minSamples?: number;\n}\n\nexport interface AnalyzeParams {\n  tenantId: string;\n  userId?: string;\n  role?: string;\n  windowMs?: number;\n}\n\nconst DEFAULT_THRESHOLD = 3;\n\nexport class BehaviorAnalyzer {\n  constructor(\n    private readonly store: BehaviorStore,\n    private readonly options: BehaviorAnalyzerOptions = {}\n  ) {}\n\n  async analyze(params: AnalyzeParams): Promise<BehaviorInsights> {\n    const query: BehaviorQuery = {\n      tenantId: params.tenantId,\n      userId: params.userId,\n      role: params.role,\n    };\n\n    if (params.windowMs) {\n      query.since = Date.now() - params.windowMs;\n    }\n\n    const summary = await this.store.summarize(query);\n    return buildInsights(summary, this.options);\n  }\n}\n\nfunction buildInsights(\n  summary: BehaviorSummary,\n  options: BehaviorAnalyzerOptions\n): BehaviorInsights {\n  const threshold = options.fieldInactivityThreshold ?? DEFAULT_THRESHOLD;\n  const minSamples = options.minSamples ?? 10;\n\n  const ignoredFields: string[] = [];\n  const frequentlyUsedFields: string[] = [];\n\n  for (const [field, count] of Object.entries(summary.fieldCounts)) {\n    if (count <= threshold) {\n      ignoredFields.push(field);\n    }\n    if (count >= threshold * 4) {\n      frequentlyUsedFields.push(field);\n    }\n  }\n\n  const workflowBottlenecks = Object.entries(\n    summary.workflowStepCounts\n  ).flatMap(([workflow, steps]) => {\n    const total = Object.values(steps).reduce((acc, value) => acc + value, 0);\n    if (!total || total < minSamples) {\n      return [];\n    }\n    return Object.entries(steps)\n      .filter(([, count]) => count / total < 0.4)\n      .map(([step, count]) => ({\n        workflow,\n        step,\n        dropRate: 1 - count / total,\n      }));\n  });\n\n  const layoutPreference = detectLayout(summary);\n\n  return {\n    unusedFields: ignoredFields,\n    suggestedHiddenFields: ignoredFields.slice(0, 5),\n    frequentlyUsedFields: frequentlyUsedFields.slice(0, 10),\n    workflowBottlenecks,\n    layoutPreference,\n  };\n}\n\nfunction detectLayout(\n  summary: BehaviorSummary\n): BehaviorInsights['layoutPreference'] {\n  const fieldCount = Object.keys(summary.fieldCounts).length;\n  if (!fieldCount) {\n    return undefined;\n  }\n\n  if (fieldCount >= 15) {\n    return 'table';\n  }\n  if (fieldCount >= 8) {\n    return 'grid';\n  }\n  return 'form';\n}\n"],"mappings":";AAeA,MAAM,oBAAoB;AAE1B,IAAa,mBAAb,MAA8B;CAC5B,YACE,AAAiB,OACjB,AAAiB,UAAmC,EAAE,EACtD;EAFiB;EACA;;CAGnB,MAAM,QAAQ,QAAkD;EAC9D,MAAM,QAAuB;GAC3B,UAAU,OAAO;GACjB,QAAQ,OAAO;GACf,MAAM,OAAO;GACd;AAED,MAAI,OAAO,SACT,OAAM,QAAQ,KAAK,KAAK,GAAG,OAAO;AAIpC,SAAO,cADS,MAAM,KAAK,MAAM,UAAU,MAAM,EACnB,KAAK,QAAQ;;;AAI/C,SAAS,cACP,SACA,SACkB;CAClB,MAAM,YAAY,QAAQ,4BAA4B;CACtD,MAAM,aAAa,QAAQ,cAAc;CAEzC,MAAM,gBAA0B,EAAE;CAClC,MAAM,uBAAiC,EAAE;AAEzC,MAAK,MAAM,CAAC,OAAO,UAAU,OAAO,QAAQ,QAAQ,YAAY,EAAE;AAChE,MAAI,SAAS,UACX,eAAc,KAAK,MAAM;AAE3B,MAAI,SAAS,YAAY,EACvB,sBAAqB,KAAK,MAAM;;CAIpC,MAAM,sBAAsB,OAAO,QACjC,QAAQ,mBACT,CAAC,SAAS,CAAC,UAAU,WAAW;EAC/B,MAAM,QAAQ,OAAO,OAAO,MAAM,CAAC,QAAQ,KAAK,UAAU,MAAM,OAAO,EAAE;AACzE,MAAI,CAAC,SAAS,QAAQ,WACpB,QAAO,EAAE;AAEX,SAAO,OAAO,QAAQ,MAAM,CACzB,QAAQ,GAAG,WAAW,QAAQ,QAAQ,GAAI,CAC1C,KAAK,CAAC,MAAM,YAAY;GACvB;GACA;GACA,UAAU,IAAI,QAAQ;GACvB,EAAE;GACL;CAEF,MAAM,mBAAmB,aAAa,QAAQ;AAE9C,QAAO;EACL,cAAc;EACd,uBAAuB,cAAc,MAAM,GAAG,EAAE;EAChD,sBAAsB,qBAAqB,MAAM,GAAG,GAAG;EACvD;EACA;EACD;;AAGH,SAAS,aACP,SACsC;CACtC,MAAM,aAAa,OAAO,KAAK,QAAQ,YAAY,CAAC;AACpD,KAAI,CAAC,WACH;AAGF,KAAI,cAAc,GAChB,QAAO;AAET,KAAI,cAAc,EAChB,QAAO;AAET,QAAO"}

package/dist/docs/behavior-tracking.docblock.d.ts

@@ -0,0 +1,7 @@
+import { DocBlock } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/behavior-tracking.docblock.d.ts
+declare const personalization_behavior_tracking_DocBlocks: DocBlock[];
+//#endregion
+export { personalization_behavior_tracking_DocBlocks };
+//# sourceMappingURL=behavior-tracking.docblock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"behavior-tracking.docblock.d.ts","names":[],"sources":["../../src/docs/behavior-tracking.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,6CAA6C"}

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

@@ -0,0 +1,18 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/behavior-tracking.docblock.ts
+const personalization_behavior_tracking_DocBlocks = [{
+	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\n\n`@contractspec/lib.personalization` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.\n\n## Tracker\n\n```ts\nimport { createBehaviorTracker } from '@contractspec/lib.personalization';\nimport { InMemoryBehaviorStore } from '@contractspec/lib.personalization/store';\n\nconst tracker = createBehaviorTracker({\n  store: new InMemoryBehaviorStore(),\n  context: { tenantId: ctx.tenant.id, userId: ctx.identity.userId },\n  autoFlushIntervalMs: 5000,\n});\n\ntracker.trackFieldAccess({ operation: 'billing.createOrder', field: 'internalNotes' });\ntracker.trackFeatureUsage({ feature: 'workflow-editor', action: 'opened' });\ntracker.trackWorkflowStep({ workflow: 'invoice-approval', step: 'review', status: 'entered' });\n```\n\nAll 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.\n\n## Analyzer\n\n```ts\nimport { BehaviorAnalyzer } from '@contractspec/lib.personalization/analyzer';\n\nconst analyzer = new BehaviorAnalyzer(store, { fieldInactivityThreshold: 2 });\nconst insights = await analyzer.analyze({ tenantId: 'acme', userId: 'manager-42', windowMs: 7 * 24 * 60 * 60 * 1000 });\n\n/*\n{\n  unusedFields: ['internalNotes'],\n  suggestedHiddenFields: ['internalNotes'],\n  frequentlyUsedFields: ['customerReference', 'items'],\n  workflowBottlenecks: [{ workflow: 'invoice-approval', step: 'finance-review', dropRate: 0.6 }],\n  layoutPreference: 'table'\n}\n*/\n```\n\nUse the analyzer output with the overlay adapter to generate suggestions automatically.\n\n## Adapter\n\n```ts\nimport { insightsToOverlaySuggestion } from '@contractspec/lib.personalization/adapter';\n\nconst overlay = insightsToOverlaySuggestion(insights, {\n  overlayId: 'acme-order-form',\n  tenantId: 'acme',\n  capability: 'billing.createOrder',\n});\n```\n\nWhen the adapter returns an overlay spec, pass it to the overlay engine to register or sign it.\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n"
+}];
+registerDocBlocks(personalization_behavior_tracking_DocBlocks);
+
+//#endregion
+export { personalization_behavior_tracking_DocBlocks };
+//# sourceMappingURL=behavior-tracking.docblock.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"behavior-tracking.docblock.js","names":[],"sources":["../../src/docs/behavior-tracking.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nexport const personalization_behavior_tracking_DocBlocks: DocBlock[] = [\n  {\n    id: 'docs.personalization.behavior-tracking',\n    title: 'Behavior Tracking',\n    summary:\n      '`@contractspec/lib.personalization` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/personalization/behavior-tracking',\n    tags: ['personalization', 'behavior-tracking'],\n    body: \"# Behavior Tracking\\n\\n`@contractspec/lib.personalization` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.\\n\\n## Tracker\\n\\n```ts\\nimport { createBehaviorTracker } from '@contractspec/lib.personalization';\\nimport { InMemoryBehaviorStore } from '@contractspec/lib.personalization/store';\\n\\nconst tracker = createBehaviorTracker({\\n  store: new InMemoryBehaviorStore(),\\n  context: { tenantId: ctx.tenant.id, userId: ctx.identity.userId },\\n  autoFlushIntervalMs: 5000,\\n});\\n\\ntracker.trackFieldAccess({ operation: 'billing.createOrder', field: 'internalNotes' });\\ntracker.trackFeatureUsage({ feature: 'workflow-editor', action: 'opened' });\\ntracker.trackWorkflowStep({ workflow: 'invoice-approval', step: 'review', status: 'entered' });\\n```\\n\\nAll 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.\\n\\n## Analyzer\\n\\n```ts\\nimport { BehaviorAnalyzer } from '@contractspec/lib.personalization/analyzer';\\n\\nconst analyzer = new BehaviorAnalyzer(store, { fieldInactivityThreshold: 2 });\\nconst insights = await analyzer.analyze({ tenantId: 'acme', userId: 'manager-42', windowMs: 7 * 24 * 60 * 60 * 1000 });\\n\\n/*\\n{\\n  unusedFields: ['internalNotes'],\\n  suggestedHiddenFields: ['internalNotes'],\\n  frequentlyUsedFields: ['customerReference', 'items'],\\n  workflowBottlenecks: [{ workflow: 'invoice-approval', step: 'finance-review', dropRate: 0.6 }],\\n  layoutPreference: 'table'\\n}\\n*/\\n```\\n\\nUse the analyzer output with the overlay adapter to generate suggestions automatically.\\n\\n## Adapter\\n\\n```ts\\nimport { insightsToOverlaySuggestion } from '@contractspec/lib.personalization/adapter';\\n\\nconst overlay = insightsToOverlaySuggestion(insights, {\\n  overlayId: 'acme-order-form',\\n  tenantId: 'acme',\\n  capability: 'billing.createOrder',\\n});\\n```\\n\\nWhen the adapter returns an overlay spec, pass it to the overlay engine to register or sign it.\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\",\n  },\n];\nregisterDocBlocks(personalization_behavior_tracking_DocBlocks);\n"],"mappings":";;;AAGA,MAAa,8CAA0D,CACrE;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,mBAAmB,oBAAoB;CAC9C,MAAM;CACP,CACF;AACD,kBAAkB,4CAA4C"}

package/dist/docs/index.d.ts

@@ -0,0 +1,3 @@
+import "./behavior-tracking.docblock.js";
+import "./overlay-engine.docblock.js";
+import "./workflow-composition.docblock.js";

package/dist/docs/index.js

@@ -0,0 +1,3 @@
+import "./behavior-tracking.docblock.js";
+import "./overlay-engine.docblock.js";
+import "./workflow-composition.docblock.js";

package/dist/docs/overlay-engine.docblock.d.ts

@@ -0,0 +1,7 @@
+import { DocBlock } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/overlay-engine.docblock.d.ts
+declare const personalization_overlay_engine_DocBlocks: DocBlock[];
+//#endregion
+export { personalization_overlay_engine_DocBlocks };
+//# sourceMappingURL=overlay-engine.docblock.d.ts.map

package/dist/docs/overlay-engine.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-engine.docblock.d.ts","names":[],"sources":["../../src/docs/overlay-engine.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,0CAA0C"}

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

@@ -0,0 +1,18 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/overlay-engine.docblock.ts
+const personalization_overlay_engine_DocBlocks = [{
+	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\n\n`@contractspec/lib.overlay-engine` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.\n\n## Key APIs\n\n- `defineOverlay(spec)` – helper to keep specs typed.\n- `OverlayRegistry` – register signed overlays and retrieve them per context.\n- `OverlayEngine` – apply overlays to renderable targets, emit audit events, and merge modifications deterministically.\n- `signOverlay(spec, privateKey)` – Ed25519/RSA-PSS signer.\n- `verifyOverlaySignature(overlay)` – verify public key signatures.\n- `useOverlay(engine, params)` – client hook that returns `{ target, overlaysApplied }`.\n\n## Scope Precedence\n\nRegistrations are sorted by specificity:\n\n1. Tenant overlays\n2. Role overlays\n3. User overlays\n4. Device overlays\n\nLess specific overlays run first; more specific overlays override later.\n\n## Example\n\n```ts\nconst registry = new OverlayRegistry();\nconst engine = new OverlayEngine({\n  registry,\n  audit: (event) => auditLogService.record(event),\n});\n\nconst overlay = defineOverlay({\n  overlayId: 'acme-order-form',\n  version: '1.0.0',\n  appliesTo: {\n    capability: 'billing.createOrder',\n    tenantId: 'acme',\n  },\n  modifications: [\n    { type: 'hideField', field: 'internalNotes' },\n    { type: 'renameLabel', field: 'customerReference', newLabel: 'PO Number' },\n  ],\n});\n\nconst signedOverlay = await signOverlay(overlay, privateKeyPem);\nregistry.register(signedOverlay);\n\nconst result = engine.apply({\n  target: { fields: baseFields },\n  capability: 'billing.createOrder',\n  tenantId: 'acme',\n  userId: 'manager-7',\n});\n```\n\n`result.target.fields` now carries the hidden and renamed outputs ready for rendering.\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n"
+}];
+registerDocBlocks(personalization_overlay_engine_DocBlocks);
+
+//#endregion
+export { personalization_overlay_engine_DocBlocks };
+//# sourceMappingURL=overlay-engine.docblock.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-engine.docblock.js","names":[],"sources":["../../src/docs/overlay-engine.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nexport const personalization_overlay_engine_DocBlocks: DocBlock[] = [\n  {\n    id: 'docs.personalization.overlay-engine',\n    title: 'Overlay Engine',\n    summary:\n      '`@contractspec/lib.overlay-engine` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/personalization/overlay-engine',\n    tags: ['personalization', 'overlay-engine'],\n    body: \"# Overlay Engine\\n\\n`@contractspec/lib.overlay-engine` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.\\n\\n## Key APIs\\n\\n- `defineOverlay(spec)` \\u2013 helper to keep specs typed.\\n- `OverlayRegistry` \\u2013 register signed overlays and retrieve them per context.\\n- `OverlayEngine` \\u2013 apply overlays to renderable targets, emit audit events, and merge modifications deterministically.\\n- `signOverlay(spec, privateKey)` \\u2013 Ed25519/RSA-PSS signer.\\n- `verifyOverlaySignature(overlay)` \\u2013 verify public key signatures.\\n- `useOverlay(engine, params)` \\u2013 client hook that returns `{ target, overlaysApplied }`.\\n\\n## Scope Precedence\\n\\nRegistrations are sorted by specificity:\\n\\n1. Tenant overlays\\n2. Role overlays\\n3. User overlays\\n4. Device overlays\\n\\nLess specific overlays run first; more specific overlays override later.\\n\\n## Example\\n\\n```ts\\nconst registry = new OverlayRegistry();\\nconst engine = new OverlayEngine({\\n  registry,\\n  audit: (event) => auditLogService.record(event),\\n});\\n\\nconst overlay = defineOverlay({\\n  overlayId: 'acme-order-form',\\n  version: '1.0.0',\\n  appliesTo: {\\n    capability: 'billing.createOrder',\\n    tenantId: 'acme',\\n  },\\n  modifications: [\\n    { type: 'hideField', field: 'internalNotes' },\\n    { type: 'renameLabel', field: 'customerReference', newLabel: 'PO Number' },\\n  ],\\n});\\n\\nconst signedOverlay = await signOverlay(overlay, privateKeyPem);\\nregistry.register(signedOverlay);\\n\\nconst result = engine.apply({\\n  target: { fields: baseFields },\\n  capability: 'billing.createOrder',\\n  tenantId: 'acme',\\n  userId: 'manager-7',\\n});\\n```\\n\\n`result.target.fields` now carries the hidden and renamed outputs ready for rendering.\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\",\n  },\n];\nregisterDocBlocks(personalization_overlay_engine_DocBlocks);\n"],"mappings":";;;AAGA,MAAa,2CAAuD,CAClE;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,mBAAmB,iBAAiB;CAC3C,MAAM;CACP,CACF;AACD,kBAAkB,yCAAyC"}

package/dist/docs/workflow-composition.docblock.d.ts

@@ -0,0 +1,7 @@
+import { DocBlock } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/workflow-composition.docblock.d.ts
+declare const personalization_workflow_composition_DocBlocks: DocBlock[];
+//#endregion
+export { personalization_workflow_composition_DocBlocks };
+//# sourceMappingURL=workflow-composition.docblock.d.ts.map

package/dist/docs/workflow-composition.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-composition.docblock.d.ts","names":[],"sources":["../../src/docs/workflow-composition.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,gDAAgD"}

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

@@ -0,0 +1,18 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/workflow-composition.docblock.ts
+const personalization_workflow_composition_DocBlocks = [{
+	id: "docs.personalization.workflow-composition",
+	title: "Workflow Composition",
+	summary: "`@contractspec/lib.workflow-composer` composes base WorkflowSpecs with tenant/role/device-specific extensions.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/personalization/workflow-composition",
+	tags: ["personalization", "workflow-composition"],
+	body: "# Workflow Composition\n\n`@contractspec/lib.workflow-composer` composes base WorkflowSpecs with tenant/role/device-specific extensions.\n\n## Extensions\n\n```ts\nimport { WorkflowComposer } from '@contractspec/lib.workflow-composer';\nimport { approvalStepTemplate } from '@contractspec/lib.workflow-composer/templates';\n\nconst composer = new WorkflowComposer();\n\ncomposer.register({\n  workflow: 'billing.invoiceApproval',\n  tenantId: 'acme',\n  priority: 10,\n  customSteps: [\n    {\n      after: 'validate-invoice',\n      inject: approvalStepTemplate({\n        id: 'acme-legal-review',\n        label: 'Legal Review (ACME)',\n        description: 'Tenant-specific compliance step.',\n      }),\n      transitionTo: 'final-approval',\n    },\n  ],\n  hiddenSteps: ['internal-audit'],\n});\n```\n\n## Compose\n\n```ts\nconst runtimeSpec = composer.compose({\n  base: BaseInvoiceWorkflow,\n  tenantId: 'acme',\n});\n\nworkflowRunner.execute(runtimeSpec, ctx);\n```\n\nThe composer uses anchor references (`after`/`before`) to place injected steps and cleans up transitions when steps are hidden.\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n"
+}];
+registerDocBlocks(personalization_workflow_composition_DocBlocks);
+
+//#endregion
+export { personalization_workflow_composition_DocBlocks };
+//# sourceMappingURL=workflow-composition.docblock.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-composition.docblock.js","names":[],"sources":["../../src/docs/workflow-composition.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nexport const personalization_workflow_composition_DocBlocks: DocBlock[] = [\n  {\n    id: 'docs.personalization.workflow-composition',\n    title: 'Workflow Composition',\n    summary:\n      '`@contractspec/lib.workflow-composer` composes base WorkflowSpecs with tenant/role/device-specific extensions.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/personalization/workflow-composition',\n    tags: ['personalization', 'workflow-composition'],\n    body: \"# Workflow Composition\\n\\n`@contractspec/lib.workflow-composer` composes base WorkflowSpecs with tenant/role/device-specific extensions.\\n\\n## Extensions\\n\\n```ts\\nimport { WorkflowComposer } from '@contractspec/lib.workflow-composer';\\nimport { approvalStepTemplate } from '@contractspec/lib.workflow-composer/templates';\\n\\nconst composer = new WorkflowComposer();\\n\\ncomposer.register({\\n  workflow: 'billing.invoiceApproval',\\n  tenantId: 'acme',\\n  priority: 10,\\n  customSteps: [\\n    {\\n      after: 'validate-invoice',\\n      inject: approvalStepTemplate({\\n        id: 'acme-legal-review',\\n        label: 'Legal Review (ACME)',\\n        description: 'Tenant-specific compliance step.',\\n      }),\\n      transitionTo: 'final-approval',\\n    },\\n  ],\\n  hiddenSteps: ['internal-audit'],\\n});\\n```\\n\\n## Compose\\n\\n```ts\\nconst runtimeSpec = composer.compose({\\n  base: BaseInvoiceWorkflow,\\n  tenantId: 'acme',\\n});\\n\\nworkflowRunner.execute(runtimeSpec, ctx);\\n```\\n\\nThe composer uses anchor references (`after`/`before`) to place injected steps and cleans up transitions when steps are hidden.\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\",\n  },\n];\nregisterDocBlocks(personalization_workflow_composition_DocBlocks);\n"],"mappings":";;;AAGA,MAAa,iDAA6D,CACxE;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,mBAAmB,uBAAuB;CACjD,MAAM;CACP,CACF;AACD,kBAAkB,+CAA+C"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import { BehaviorEvent, BehaviorEventBase, BehaviorEventType, BehaviorInsights, BehaviorQuery, BehaviorSummary, FeatureUsageEvent, FieldAccessEvent, WorkflowStepEvent } from "./types.js";
+import { OverlaySuggestionOptions, WorkflowAdaptation, insightsToOverlaySuggestion, insightsToWorkflowAdaptations } from "./adapter.js";
+import { BehaviorStore, InMemoryBehaviorStore } from "./store.js";
+import { AnalyzeParams, BehaviorAnalyzer, BehaviorAnalyzerOptions } from "./analyzer.js";
+import "./docs/index.js";
+import { BehaviorTracker, BehaviorTrackerContext, BehaviorTrackerOptions, TrackFeatureUsageInput, TrackFieldAccessInput, TrackWorkflowStepInput, createBehaviorTracker } from "./tracker.js";
+export { AnalyzeParams, BehaviorAnalyzer, BehaviorAnalyzerOptions, BehaviorEvent, BehaviorEventBase, BehaviorEventType, BehaviorInsights, BehaviorQuery, BehaviorStore, BehaviorSummary, BehaviorTracker, BehaviorTrackerContext, BehaviorTrackerOptions, FeatureUsageEvent, FieldAccessEvent, InMemoryBehaviorStore, OverlaySuggestionOptions, TrackFeatureUsageInput, TrackFieldAccessInput, TrackWorkflowStepInput, WorkflowAdaptation, WorkflowStepEvent, createBehaviorTracker, insightsToOverlaySuggestion, insightsToWorkflowAdaptations };

package/dist/index.js

@@ -0,0 +1,7 @@
+import { insightsToOverlaySuggestion, insightsToWorkflowAdaptations } from "./adapter.js";
+import { BehaviorAnalyzer } from "./analyzer.js";
+import { InMemoryBehaviorStore } from "./store.js";
+import { BehaviorTracker, createBehaviorTracker } from "./tracker.js";
+import "./docs/index.js";
+
+export { BehaviorAnalyzer, BehaviorTracker, InMemoryBehaviorStore, createBehaviorTracker, insightsToOverlaySuggestion, insightsToWorkflowAdaptations };

package/dist/store.d.ts

@@ -0,0 +1,21 @@
+import { BehaviorEvent, BehaviorQuery, BehaviorSummary } from "./types.js";
+
+//#region src/store.d.ts
+interface BehaviorStore {
+  record(event: BehaviorEvent): Promise<void> | void;
+  bulkRecord(events: BehaviorEvent[]): Promise<void> | void;
+  query(query: BehaviorQuery): Promise<BehaviorEvent[]>;
+  summarize(query: BehaviorQuery): Promise<BehaviorSummary>;
+  clear?(): Promise<void> | void;
+}
+declare class InMemoryBehaviorStore implements BehaviorStore {
+  private events;
+  record(event: BehaviorEvent): Promise<void>;
+  bulkRecord(events: BehaviorEvent[]): Promise<void>;
+  query(query: BehaviorQuery): Promise<BehaviorEvent[]>;
+  summarize(query: BehaviorQuery): Promise<BehaviorSummary>;
+  clear(): Promise<void>;
+}
+//#endregion
+export { BehaviorStore, InMemoryBehaviorStore };
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","names":[],"sources":["../src/store.ts"],"sourcesContent":[],"mappings":";;;UAEiB,aAAA;gBACD,gBAAgB;EADf,UAAA,CAAA,MAAa,EAET,aAFS,EAAA,CAAA,EAES,OAFT,CAAA,IAAA,CAAA,GAAA,IAAA;EACd,KAAA,CAAA,KAAA,EAED,aAFC,CAAA,EAEe,OAFf,CAEuB,aAFvB,EAAA,CAAA;EAAgB,SAAA,CAAA,KAAA,EAGb,aAHa,CAAA,EAGG,OAHH,CAGW,eAHX,CAAA;EACX,KAAA,GAAA,EAGT,OAHS,CAAA,IAAA,CAAA,GAAA,IAAA;;AACN,cAKF,qBAAA,YAAiC,aAL/B,CAAA;EAAwB,QAAA,MAAA;EAAR,MAAA,CAAA,KAAA,EAQT,aARS,CAAA,EAQO,OARP,CAAA,IAAA,CAAA;EACZ,UAAA,CAAA,MAAA,EAWQ,aAXR,EAAA,CAAA,EAW0B,OAX1B,CAAA,IAAA,CAAA;EAAwB,KAAA,CAAA,KAAA,EAetB,aAfsB,CAAA,EAeN,OAfM,CAeE,aAfF,EAAA,CAAA;EAAR,SAAA,CAAA,KAAA,EAmBV,aAnBU,CAAA,EAmBM,OAnBN,CAmBc,eAnBd,CAAA;EACvB,KAAA,CAAA,CAAA,EAkDK,OAlDL,CAAA,IAAA,CAAA"}

package/dist/store.js

@@ -0,0 +1,59 @@
+//#region src/store.ts
+var InMemoryBehaviorStore = class {
+	events = [];
+	async record(event) {
+		this.events.push(event);
+	}
+	async bulkRecord(events) {
+		this.events.push(...events);
+	}
+	async query(query) {
+		return filterEvents(this.events, query);
+	}
+	async summarize(query) {
+		const events = await this.query(query);
+		const summary = {
+			fieldCounts: {},
+			featureCounts: {},
+			workflowStepCounts: {},
+			totalEvents: events.length
+		};
+		events.forEach((event) => {
+			switch (event.type) {
+				case "field_access":
+					summary.fieldCounts[event.field] = (summary.fieldCounts[event.field] ?? 0) + 1;
+					break;
+				case "feature_usage":
+					summary.featureCounts[event.feature] = (summary.featureCounts[event.feature] ?? 0) + 1;
+					break;
+				case "workflow_step": {
+					const workflow = summary.workflowStepCounts[event.workflow] ??= {};
+					workflow[event.step] = (workflow[event.step] ?? 0) + 1;
+					break;
+				}
+				default: break;
+			}
+		});
+		return summary;
+	}
+	async clear() {
+		this.events = [];
+	}
+};
+function filterEvents(events, query) {
+	return events.filter((event) => {
+		if (query.tenantId && event.tenantId !== query.tenantId) return false;
+		if (query.userId && event.userId !== query.userId) return false;
+		if (query.role && event.role !== query.role) return false;
+		if (query.since && event.timestamp < query.since) return false;
+		if (query.until && event.timestamp > query.until) return false;
+		if (query.operation && event.type === "field_access" && event.operation !== query.operation) return false;
+		if (query.feature && event.type === "feature_usage" && event.feature !== query.feature) return false;
+		if (query.workflow && event.type === "workflow_step" && event.workflow !== query.workflow) return false;
+		return true;
+	});
+}
+
+//#endregion
+export { InMemoryBehaviorStore };
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","names":[],"sources":["../src/store.ts"],"sourcesContent":["import type { BehaviorEvent, BehaviorQuery, BehaviorSummary } from './types';\n\nexport interface BehaviorStore {\n  record(event: BehaviorEvent): Promise<void> | void;\n  bulkRecord(events: BehaviorEvent[]): Promise<void> | void;\n  query(query: BehaviorQuery): Promise<BehaviorEvent[]>;\n  summarize(query: BehaviorQuery): Promise<BehaviorSummary>;\n  clear?(): Promise<void> | void;\n}\n\nexport class InMemoryBehaviorStore implements BehaviorStore {\n  private events: BehaviorEvent[] = [];\n\n  async record(event: BehaviorEvent): Promise<void> {\n    this.events.push(event);\n  }\n\n  async bulkRecord(events: BehaviorEvent[]): Promise<void> {\n    this.events.push(...events);\n  }\n\n  async query(query: BehaviorQuery): Promise<BehaviorEvent[]> {\n    return filterEvents(this.events, query);\n  }\n\n  async summarize(query: BehaviorQuery): Promise<BehaviorSummary> {\n    const events = await this.query(query);\n    const summary: BehaviorSummary = {\n      fieldCounts: {},\n      featureCounts: {},\n      workflowStepCounts: {},\n      totalEvents: events.length,\n    };\n\n    events.forEach((event) => {\n      switch (event.type) {\n        case 'field_access':\n          summary.fieldCounts[event.field] =\n            (summary.fieldCounts[event.field] ?? 0) + 1;\n          break;\n        case 'feature_usage':\n          summary.featureCounts[event.feature] =\n            (summary.featureCounts[event.feature] ?? 0) + 1;\n          break;\n        case 'workflow_step': {\n          const workflow = (summary.workflowStepCounts[event.workflow] ??= {});\n          workflow[event.step] = (workflow[event.step] ?? 0) + 1;\n          break;\n        }\n        default:\n          break;\n      }\n    });\n\n    return summary;\n  }\n\n  async clear(): Promise<void> {\n    this.events = [];\n  }\n}\n\nfunction filterEvents(\n  events: BehaviorEvent[],\n  query: BehaviorQuery\n): BehaviorEvent[] {\n  return events.filter((event) => {\n    if (query.tenantId && event.tenantId !== query.tenantId) {\n      return false;\n    }\n    if (query.userId && event.userId !== query.userId) {\n      return false;\n    }\n    if (query.role && event.role !== query.role) {\n      return false;\n    }\n    if (query.since && event.timestamp < query.since) {\n      return false;\n    }\n    if (query.until && event.timestamp > query.until) {\n      return false;\n    }\n\n    if (\n      query.operation &&\n      event.type === 'field_access' &&\n      event.operation !== query.operation\n    ) {\n      return false;\n    }\n    if (\n      query.feature &&\n      event.type === 'feature_usage' &&\n      event.feature !== query.feature\n    ) {\n      return false;\n    }\n    if (\n      query.workflow &&\n      event.type === 'workflow_step' &&\n      event.workflow !== query.workflow\n    ) {\n      return false;\n    }\n    return true;\n  });\n}\n"],"mappings":";AAUA,IAAa,wBAAb,MAA4D;CAC1D,AAAQ,SAA0B,EAAE;CAEpC,MAAM,OAAO,OAAqC;AAChD,OAAK,OAAO,KAAK,MAAM;;CAGzB,MAAM,WAAW,QAAwC;AACvD,OAAK,OAAO,KAAK,GAAG,OAAO;;CAG7B,MAAM,MAAM,OAAgD;AAC1D,SAAO,aAAa,KAAK,QAAQ,MAAM;;CAGzC,MAAM,UAAU,OAAgD;EAC9D,MAAM,SAAS,MAAM,KAAK,MAAM,MAAM;EACtC,MAAM,UAA2B;GAC/B,aAAa,EAAE;GACf,eAAe,EAAE;GACjB,oBAAoB,EAAE;GACtB,aAAa,OAAO;GACrB;AAED,SAAO,SAAS,UAAU;AACxB,WAAQ,MAAM,MAAd;IACE,KAAK;AACH,aAAQ,YAAY,MAAM,UACvB,QAAQ,YAAY,MAAM,UAAU,KAAK;AAC5C;IACF,KAAK;AACH,aAAQ,cAAc,MAAM,YACzB,QAAQ,cAAc,MAAM,YAAY,KAAK;AAChD;IACF,KAAK,iBAAiB;KACpB,MAAM,WAAY,QAAQ,mBAAmB,MAAM,cAAc,EAAE;AACnE,cAAS,MAAM,SAAS,SAAS,MAAM,SAAS,KAAK;AACrD;;IAEF,QACE;;IAEJ;AAEF,SAAO;;CAGT,MAAM,QAAuB;AAC3B,OAAK,SAAS,EAAE;;;AAIpB,SAAS,aACP,QACA,OACiB;AACjB,QAAO,OAAO,QAAQ,UAAU;AAC9B,MAAI,MAAM,YAAY,MAAM,aAAa,MAAM,SAC7C,QAAO;AAET,MAAI,MAAM,UAAU,MAAM,WAAW,MAAM,OACzC,QAAO;AAET,MAAI,MAAM,QAAQ,MAAM,SAAS,MAAM,KACrC,QAAO;AAET,MAAI,MAAM,SAAS,MAAM,YAAY,MAAM,MACzC,QAAO;AAET,MAAI,MAAM,SAAS,MAAM,YAAY,MAAM,MACzC,QAAO;AAGT,MACE,MAAM,aACN,MAAM,SAAS,kBACf,MAAM,cAAc,MAAM,UAE1B,QAAO;AAET,MACE,MAAM,WACN,MAAM,SAAS,mBACf,MAAM,YAAY,MAAM,QAExB,QAAO;AAET,MACE,MAAM,YACN,MAAM,SAAS,mBACf,MAAM,aAAa,MAAM,SAEzB,QAAO;AAET,SAAO;GACP"}

package/dist/tracker.d.ts

@@ -0,0 +1,53 @@
+import { BehaviorStore } from "./store.js";
+
+//#region src/tracker.d.ts
+interface BehaviorTrackerContext {
+  tenantId: string;
+  userId?: string;
+  role?: string;
+  device?: string;
+  metadata?: Record<string, unknown>;
+}
+interface BehaviorTrackerOptions {
+  store: BehaviorStore;
+  context: BehaviorTrackerContext;
+  tracerName?: string;
+  autoFlushIntervalMs?: number;
+  bufferSize?: number;
+}
+interface TrackFieldAccessInput {
+  operation: string;
+  field: string;
+  metadata?: Record<string, unknown>;
+}
+interface TrackFeatureUsageInput {
+  feature: string;
+  action: 'opened' | 'completed' | 'dismissed';
+  metadata?: Record<string, unknown>;
+}
+interface TrackWorkflowStepInput {
+  workflow: string;
+  step: string;
+  status: 'entered' | 'completed' | 'skipped' | 'errored';
+  metadata?: Record<string, unknown>;
+}
+declare class BehaviorTracker {
+  private readonly store;
+  private readonly context;
+  private readonly tracer;
+  private readonly counter;
+  private buffer;
+  private readonly bufferSize;
+  private flushTimer?;
+  constructor(options: BehaviorTrackerOptions);
+  trackFieldAccess(input: TrackFieldAccessInput): void;
+  trackFeatureUsage(input: TrackFeatureUsageInput): void;
+  trackWorkflowStep(input: TrackWorkflowStepInput): void;
+  flush(): Promise<void>;
+  dispose(): Promise<void>;
+  private enqueue;
+}
+declare const createBehaviorTracker: (options: BehaviorTrackerOptions) => BehaviorTracker;
+//#endregion
+export { BehaviorTracker, BehaviorTrackerContext, BehaviorTrackerOptions, TrackFeatureUsageInput, TrackFieldAccessInput, TrackWorkflowStepInput, createBehaviorTracker };
+//# sourceMappingURL=tracker.d.ts.map

package/dist/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","names":[],"sources":["../src/tracker.ts"],"sourcesContent":[],"mappings":";;;UAIiB,sBAAA;;EAAA,MAAA,CAAA,EAAA,MAAA;EAQA,IAAA,CAAA,EAAA,MAAA;EAUA,MAAA,CAAA,EAAA,MAAA;EAMA,QAAA,CAAA,EAnBJ,MAmBI,CAAA,MAAA,EAAsB,OAAA,CAAA;AAMvC;AAOa,UA7BI,sBAAA,CA6BW;EAcL,KAAA,EA1Cd,aA0Cc;EAYG,OAAA,EArDf,sBAqDe;EAYC,UAAA,CAAA,EAAA,MAAA;EAYA,mBAAA,CAAA,EAAA,MAAA;EAaV,UAAA,CAAA,EAAA,MAAA;;AAOS,UAzFT,qBAAA,CAyFS;EA4Bb,SAAA,EAAA,MAAA;;aAlHA;;UAGI,sBAAA;;;aAGJ;;UAGI,sBAAA;;;;aAIJ;;cAGA,eAAA;;;;;;;;uBAcU;0BAYG;2BAYC;2BAYA;WAaV;aAOE;;;cA4BN,iCAAkC,2BAAsB"}

package/dist/tracker.js

@@ -0,0 +1,93 @@
+import { metrics, trace } from "@opentelemetry/api";
+
+//#region src/tracker.ts
+const DEFAULT_BUFFER_SIZE = 25;
+var BehaviorTracker = class {
+	store;
+	context;
+	tracer = trace.getTracer("lssm.personalization", "1.0.0");
+	counter = metrics.getMeter("lssm.personalization", "1.0.0").createCounter("lssm.personalization.events", { description: "Behavior events tracked for personalization" });
+	buffer = [];
+	bufferSize;
+	flushTimer;
+	constructor(options) {
+		this.store = options.store;
+		this.context = options.context;
+		this.bufferSize = options.bufferSize ?? DEFAULT_BUFFER_SIZE;
+		if (options.autoFlushIntervalMs) this.flushTimer = setInterval(() => {
+			this.flush();
+		}, options.autoFlushIntervalMs);
+	}
+	trackFieldAccess(input) {
+		const event = {
+			type: "field_access",
+			operation: input.operation,
+			field: input.field,
+			timestamp: Date.now(),
+			...this.context,
+			metadata: {
+				...this.context.metadata,
+				...input.metadata
+			}
+		};
+		this.enqueue(event);
+	}
+	trackFeatureUsage(input) {
+		const event = {
+			type: "feature_usage",
+			feature: input.feature,
+			action: input.action,
+			timestamp: Date.now(),
+			...this.context,
+			metadata: {
+				...this.context.metadata,
+				...input.metadata
+			}
+		};
+		this.enqueue(event);
+	}
+	trackWorkflowStep(input) {
+		const event = {
+			type: "workflow_step",
+			workflow: input.workflow,
+			step: input.step,
+			status: input.status,
+			timestamp: Date.now(),
+			...this.context,
+			metadata: {
+				...this.context.metadata,
+				...input.metadata
+			}
+		};
+		this.enqueue(event);
+	}
+	async flush() {
+		if (!this.buffer.length) return;
+		const events = this.buffer;
+		this.buffer = [];
+		await this.store.bulkRecord(events);
+	}
+	async dispose() {
+		if (this.flushTimer) clearInterval(this.flushTimer);
+		await this.flush();
+	}
+	enqueue(event) {
+		this.buffer.push(event);
+		this.counter.add(1, {
+			tenantId: this.context.tenantId,
+			type: event.type
+		});
+		this.tracer.startActiveSpan(`personalization.${event.type}`, (span) => {
+			span.setAttribute("tenant.id", this.context.tenantId);
+			if (this.context.userId) span.setAttribute("user.id", this.context.userId);
+			span.setAttribute("personalization.event_type", event.type);
+			span.end();
+		});
+		if (this.buffer.length >= this.bufferSize) this.flush();
+	}
+};
+const createBehaviorTracker = (options) => new BehaviorTracker(options);
+
+//#endregion
+export { BehaviorTracker, createBehaviorTracker };
+//# sourceMappingURL=tracker.js.map

package/dist/tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.js","names":[],"sources":["../src/tracker.ts"],"sourcesContent":["import { trace, metrics } from '@opentelemetry/api';\nimport type { BehaviorEvent } from './types';\nimport type { BehaviorStore } from './store';\n\nexport interface BehaviorTrackerContext {\n  tenantId: string;\n  userId?: string;\n  role?: string;\n  device?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface BehaviorTrackerOptions {\n  store: BehaviorStore;\n  context: BehaviorTrackerContext;\n  tracerName?: string;\n  autoFlushIntervalMs?: number;\n  bufferSize?: number;\n}\n\nconst DEFAULT_BUFFER_SIZE = 25;\n\nexport interface TrackFieldAccessInput {\n  operation: string;\n  field: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface TrackFeatureUsageInput {\n  feature: string;\n  action: 'opened' | 'completed' | 'dismissed';\n  metadata?: Record<string, unknown>;\n}\n\nexport interface TrackWorkflowStepInput {\n  workflow: string;\n  step: string;\n  status: 'entered' | 'completed' | 'skipped' | 'errored';\n  metadata?: Record<string, unknown>;\n}\n\nexport class BehaviorTracker {\n  private readonly store: BehaviorStore;\n  private readonly context: BehaviorTrackerContext;\n  private readonly tracer = trace.getTracer('lssm.personalization', '1.0.0');\n  private readonly counter = metrics\n    .getMeter('lssm.personalization', '1.0.0')\n    .createCounter('lssm.personalization.events', {\n      description: 'Behavior events tracked for personalization',\n    });\n\n  private buffer: BehaviorEvent[] = [];\n  private readonly bufferSize: number;\n  private flushTimer?: ReturnType<typeof setInterval>;\n\n  constructor(options: BehaviorTrackerOptions) {\n    this.store = options.store;\n    this.context = options.context;\n    this.bufferSize = options.bufferSize ?? DEFAULT_BUFFER_SIZE;\n\n    if (options.autoFlushIntervalMs) {\n      this.flushTimer = setInterval(() => {\n        void this.flush();\n      }, options.autoFlushIntervalMs);\n    }\n  }\n\n  trackFieldAccess(input: TrackFieldAccessInput) {\n    const event = {\n      type: 'field_access',\n      operation: input.operation,\n      field: input.field,\n      timestamp: Date.now(),\n      ...this.context,\n      metadata: { ...this.context.metadata, ...input.metadata },\n    } as BehaviorEvent;\n    this.enqueue(event);\n  }\n\n  trackFeatureUsage(input: TrackFeatureUsageInput) {\n    const event = {\n      type: 'feature_usage',\n      feature: input.feature,\n      action: input.action,\n      timestamp: Date.now(),\n      ...this.context,\n      metadata: { ...this.context.metadata, ...input.metadata },\n    } as BehaviorEvent;\n    this.enqueue(event);\n  }\n\n  trackWorkflowStep(input: TrackWorkflowStepInput) {\n    const event = {\n      type: 'workflow_step',\n      workflow: input.workflow,\n      step: input.step,\n      status: input.status,\n      timestamp: Date.now(),\n      ...this.context,\n      metadata: { ...this.context.metadata, ...input.metadata },\n    } as BehaviorEvent;\n    this.enqueue(event);\n  }\n\n  async flush(): Promise<void> {\n    if (!this.buffer.length) return;\n    const events = this.buffer;\n    this.buffer = [];\n    await this.store.bulkRecord(events);\n  }\n\n  async dispose(): Promise<void> {\n    if (this.flushTimer) {\n      clearInterval(this.flushTimer);\n    }\n    await this.flush();\n  }\n\n  private enqueue(event: BehaviorEvent) {\n    this.buffer.push(event);\n    this.counter.add(1, {\n      tenantId: this.context.tenantId,\n      type: event.type,\n    });\n\n    this.tracer.startActiveSpan(`personalization.${event.type}`, (span) => {\n      span.setAttribute('tenant.id', this.context.tenantId);\n      if (this.context.userId)\n        span.setAttribute('user.id', this.context.userId);\n      span.setAttribute('personalization.event_type', event.type);\n      span.end();\n    });\n\n    if (this.buffer.length >= this.bufferSize) {\n      void this.flush();\n    }\n  }\n}\n\nexport const createBehaviorTracker = (options: BehaviorTrackerOptions) =>\n  new BehaviorTracker(options);\n"],"mappings":";;;AAoBA,MAAM,sBAAsB;AAqB5B,IAAa,kBAAb,MAA6B;CAC3B,AAAiB;CACjB,AAAiB;CACjB,AAAiB,SAAS,MAAM,UAAU,wBAAwB,QAAQ;CAC1E,AAAiB,UAAU,QACxB,SAAS,wBAAwB,QAAQ,CACzC,cAAc,+BAA+B,EAC5C,aAAa,+CACd,CAAC;CAEJ,AAAQ,SAA0B,EAAE;CACpC,AAAiB;CACjB,AAAQ;CAER,YAAY,SAAiC;AAC3C,OAAK,QAAQ,QAAQ;AACrB,OAAK,UAAU,QAAQ;AACvB,OAAK,aAAa,QAAQ,cAAc;AAExC,MAAI,QAAQ,oBACV,MAAK,aAAa,kBAAkB;AAClC,GAAK,KAAK,OAAO;KAChB,QAAQ,oBAAoB;;CAInC,iBAAiB,OAA8B;EAC7C,MAAM,QAAQ;GACZ,MAAM;GACN,WAAW,MAAM;GACjB,OAAO,MAAM;GACb,WAAW,KAAK,KAAK;GACrB,GAAG,KAAK;GACR,UAAU;IAAE,GAAG,KAAK,QAAQ;IAAU,GAAG,MAAM;IAAU;GAC1D;AACD,OAAK,QAAQ,MAAM;;CAGrB,kBAAkB,OAA+B;EAC/C,MAAM,QAAQ;GACZ,MAAM;GACN,SAAS,MAAM;GACf,QAAQ,MAAM;GACd,WAAW,KAAK,KAAK;GACrB,GAAG,KAAK;GACR,UAAU;IAAE,GAAG,KAAK,QAAQ;IAAU,GAAG,MAAM;IAAU;GAC1D;AACD,OAAK,QAAQ,MAAM;;CAGrB,kBAAkB,OAA+B;EAC/C,MAAM,QAAQ;GACZ,MAAM;GACN,UAAU,MAAM;GAChB,MAAM,MAAM;GACZ,QAAQ,MAAM;GACd,WAAW,KAAK,KAAK;GACrB,GAAG,KAAK;GACR,UAAU;IAAE,GAAG,KAAK,QAAQ;IAAU,GAAG,MAAM;IAAU;GAC1D;AACD,OAAK,QAAQ,MAAM;;CAGrB,MAAM,QAAuB;AAC3B,MAAI,CAAC,KAAK,OAAO,OAAQ;EACzB,MAAM,SAAS,KAAK;AACpB,OAAK,SAAS,EAAE;AAChB,QAAM,KAAK,MAAM,WAAW,OAAO;;CAGrC,MAAM,UAAyB;AAC7B,MAAI,KAAK,WACP,eAAc,KAAK,WAAW;AAEhC,QAAM,KAAK,OAAO;;CAGpB,AAAQ,QAAQ,OAAsB;AACpC,OAAK,OAAO,KAAK,MAAM;AACvB,OAAK,QAAQ,IAAI,GAAG;GAClB,UAAU,KAAK,QAAQ;GACvB,MAAM,MAAM;GACb,CAAC;AAEF,OAAK,OAAO,gBAAgB,mBAAmB,MAAM,SAAS,SAAS;AACrE,QAAK,aAAa,aAAa,KAAK,QAAQ,SAAS;AACrD,OAAI,KAAK,QAAQ,OACf,MAAK,aAAa,WAAW,KAAK,QAAQ,OAAO;AACnD,QAAK,aAAa,8BAA8B,MAAM,KAAK;AAC3D,QAAK,KAAK;IACV;AAEF,MAAI,KAAK,OAAO,UAAU,KAAK,WAC7B,CAAK,KAAK,OAAO;;;AAKvB,MAAa,yBAAyB,YACpC,IAAI,gBAAgB,QAAQ"}

package/dist/types.d.ts

@@ -0,0 +1,59 @@
+//#region src/types.d.ts
+type BehaviorEventType = 'field_access' | 'feature_usage' | 'workflow_step';
+interface BehaviorEventBase {
+  id?: string;
+  tenantId: string;
+  userId?: string;
+  role?: string;
+  device?: string;
+  timestamp: number;
+  metadata?: Record<string, unknown>;
+}
+interface FieldAccessEvent extends BehaviorEventBase {
+  type: 'field_access';
+  operation: string;
+  field: string;
+}
+interface FeatureUsageEvent extends BehaviorEventBase {
+  type: 'feature_usage';
+  feature: string;
+  action: 'opened' | 'completed' | 'dismissed';
+}
+interface WorkflowStepEvent extends BehaviorEventBase {
+  type: 'workflow_step';
+  workflow: string;
+  step: string;
+  status: 'entered' | 'completed' | 'skipped' | 'errored';
+}
+type BehaviorEvent = FieldAccessEvent | FeatureUsageEvent | WorkflowStepEvent;
+interface BehaviorQuery {
+  tenantId?: string;
+  userId?: string;
+  role?: string;
+  feature?: string;
+  operation?: string;
+  workflow?: string;
+  since?: number;
+  until?: number;
+  limit?: number;
+}
+interface BehaviorSummary {
+  fieldCounts: Record<string, number>;
+  featureCounts: Record<string, number>;
+  workflowStepCounts: Record<string, Record<string, number>>;
+  totalEvents: number;
+}
+interface BehaviorInsights {
+  unusedFields: string[];
+  frequentlyUsedFields: string[];
+  suggestedHiddenFields: string[];
+  workflowBottlenecks: {
+    workflow: string;
+    step: string;
+    dropRate: number;
+  }[];
+  layoutPreference?: 'form' | 'grid' | 'list' | 'table';
+}
+//#endregion
+export { BehaviorEvent, BehaviorEventBase, BehaviorEventType, BehaviorInsights, BehaviorQuery, BehaviorSummary, FeatureUsageEvent, FieldAccessEvent, WorkflowStepEvent };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";KAAY,iBAAA;AAAA,UAKK,iBAAA,CALY;EAKZ,EAAA,CAAA,EAAA,MAAA;EAUA,QAAA,EAAA,MAAA;EAMA,MAAA,CAAA,EAAA,MAAA;EAMA,IAAA,CAAA,EAAA,MAAA;EAOL,MAAA,CAAA,EAAA,MAAA;EACR,SAAA,EAAA,MAAA;EACA,QAAA,CAAA,EAxBS,MAwBT,CAAA,MAAA,EAAA,OAAA,CAAA;;AACiB,UAtBJ,gBAAA,SAAyB,iBAsBrB,CAAA;EAEJ,IAAA,EAAA,cAAa;EAYb,SAAA,EAAA,MAAA;EACF,KAAA,EAAA,MAAA;;AAEsB,UAjCpB,iBAAA,SAA0B,iBAiCN,CAAA;EAAf,IAAA,EAAA,eAAA;EAAM,OAAA,EAAA,MAAA;EAIX,MAAA,EAAA,QAAA,GAAgB,WAAA,GAAA,WAAA;;UA/BhB,iBAAA,SAA0B;;;;;;KAO/B,aAAA,GACR,mBACA,oBACA;UAEa,aAAA;;;;;;;;;;;UAYA,eAAA;eACF;iBACE;sBACK,eAAe;;;UAIpB,gBAAA"}

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@contractspec/lib.personalization",
+  "version": "0.0.0-canary-20260113162409",
+  "description": "Behavior tracking, analysis, and adaptation helpers for ContractSpec personalization.",
+  "keywords": [
+    "contractspec",
+    "personalization",
+    "behavior",
+    "analytics",
+    "adaptation",
+    "typescript"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@contractspec/lib.bus": "0.0.0-canary-20260113162409",
+    "@contractspec/lib.schema": "0.0.0-canary-20260113162409",
+    "@contractspec/lib.contracts": "0.0.0-canary-20260113162409",
+    "@contractspec/lib.knowledge": "0.0.0-canary-20260113162409",
+    "@contractspec/lib.overlay-engine": "0.0.0-canary-20260113162409",
+    "@opentelemetry/api": "^1.9.0"
+  },
+  "peerDependencies": {
+    "@opentelemetry/api": "^1.9.0"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "0.0.0-canary-20260113162409",
+    "@contractspec/tool.typescript": "0.0.0-canary-20260113162409",
+    "tsdown": "^0.19.0",
+    "typescript": "^5.9.3"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./adapter": "./dist/adapter.js",
+    "./analyzer": "./dist/analyzer.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/behavior-tracking.docblock": "./dist/docs/behavior-tracking.docblock.js",
+    "./docs/overlay-engine.docblock": "./dist/docs/overlay-engine.docblock.js",
+    "./docs/workflow-composition.docblock": "./dist/docs/workflow-composition.docblock.js",
+    "./store": "./dist/store.js",
+    "./tracker": "./dist/tracker.js",
+    "./types": "./dist/types.js",
+    "./*": "./*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./adapter": "./dist/adapter.js",
+      "./analyzer": "./dist/analyzer.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/behavior-tracking.docblock": "./dist/docs/behavior-tracking.docblock.js",
+      "./docs/overlay-engine.docblock": "./dist/docs/overlay-engine.docblock.js",
+      "./docs/workflow-composition.docblock": "./dist/docs/workflow-composition.docblock.js",
+      "./store": "./dist/store.js",
+      "./tracker": "./dist/tracker.js",
+      "./types": "./dist/types.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/libs/personalization"
+  },
+  "homepage": "https://contractspec.io"
+}