@contractspec/example.personalization 1.44.0

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { runBehaviorTrackingExample } from "./behavior-tracking.js";
+import example from "./example.js";
+import { runOverlayCustomizationExample } from "./overlay-customization.js";
+import { composeTenantWorkflowExample, logTenantWorkflowSteps } from "./workflow-extension.js";
+export { composeTenantWorkflowExample, example, logTenantWorkflowSteps, runBehaviorTrackingExample, runOverlayCustomizationExample };

package/dist/index.js

@@ -0,0 +1,7 @@
+import { runBehaviorTrackingExample } from "./behavior-tracking.js";
+import example_default from "./example.js";
+import { runOverlayCustomizationExample } from "./overlay-customization.js";
+import { composeTenantWorkflowExample, logTenantWorkflowSteps } from "./workflow-extension.js";
+import "./docs/index.js";
+
+export { composeTenantWorkflowExample, example_default as example, logTenantWorkflowSteps, runBehaviorTrackingExample, runOverlayCustomizationExample };

package/dist/libs/contracts/src/capabilities/capabilities.d.ts

@@ -0,0 +1,9 @@
+//#region ../../libs/contracts/src/capabilities/capabilities.d.ts
+
+interface CapabilityRef {
+  key: string;
+  version: number;
+}
+//#endregion
+export { CapabilityRef };
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/libs/contracts/src/capabilities/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/capabilities/capabilities.ts"],"sourcesContent":[],"mappings":";;UAqCiB,aAAA"}

package/dist/libs/contracts/src/docs/registry.d.ts

@@ -0,0 +1,8 @@
+//#region ../../libs/contracts/src/docs/registry.d.ts
+
+type DocId = string & {
+  __docId: true;
+};
+//#endregion
+export { DocId };
+//# sourceMappingURL=registry.d.ts.map

package/dist/libs/contracts/src/docs/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/docs/registry.ts"],"sourcesContent":[],"mappings":";;KASY,KAAA"}

package/dist/libs/contracts/src/events.d.ts

@@ -0,0 +1 @@
+import "./registry.js";

package/dist/libs/contracts/src/experiments/spec-resolver.d.ts

@@ -0,0 +1,3 @@
+import "../resources.js";
+import "../types.js";
+import "../operations/index.js";

package/dist/libs/contracts/src/experiments/spec.d.ts

@@ -0,0 +1,9 @@
+//#region ../../libs/contracts/src/experiments/spec.d.ts
+
+interface ExperimentRef {
+  key: string;
+  version?: number;
+}
+//#endregion
+export { ExperimentRef };
+//# sourceMappingURL=spec.d.ts.map

package/dist/libs/contracts/src/experiments/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/experiments/spec.ts"],"sourcesContent":[],"mappings":";;UAMiB,aAAA"}

package/dist/libs/contracts/src/features/index.d.ts

@@ -0,0 +1,4 @@
+import { OpRef } from "./types.js";
+import "./registry.js";
+import "./install.js";
+import "./validation.js";

package/dist/libs/contracts/src/features/install.d.ts

@@ -0,0 +1,4 @@
+import "../operations/registry.js";
+import "./types.js";
+import "./registry.js";
+import "../presentations/index.js";

package/dist/libs/contracts/src/features/registry.d.ts

@@ -0,0 +1 @@
+import "./types.js";

package/dist/libs/contracts/src/features/types.d.ts

@@ -0,0 +1,13 @@
+import "../operations/index.js";
+
+//#region ../../libs/contracts/src/features/types.d.ts
+
+interface OpRef {
+  /** Operation key (OperationSpec.meta.key). */
+  key: string;
+  /** Operation version (OperationSpec.meta.version). */
+  version: number;
+}
+//#endregion
+export { OpRef };
+//# sourceMappingURL=types.d.ts.map

package/dist/libs/contracts/src/features/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/features/types.ts"],"sourcesContent":[],"mappings":";;;;UASiB,KAAA"}

package/dist/libs/contracts/src/features/validation.d.ts

@@ -0,0 +1 @@
+import "./types.js";

package/dist/libs/contracts/src/install.d.ts

@@ -0,0 +1,6 @@
+import "./resources.js";
+import "./types.js";
+import "./events.js";
+import "./operations/registry.js";
+import "./operations/index.js";
+import "zod";

package/dist/libs/contracts/src/operations/index.d.ts

@@ -0,0 +1,2 @@
+import "./operation.js";
+import "./registry.js";

package/dist/libs/contracts/src/operations/operation.d.ts

@@ -0,0 +1,2 @@
+import "../resources.js";
+import "../events.js";

package/dist/libs/contracts/src/operations/registry.d.ts

@@ -0,0 +1,4 @@
+import "../resources.js";
+import "../types.js";
+import "./operation.js";
+import "../install.js";

package/dist/libs/contracts/src/ownership.d.ts

@@ -0,0 +1,60 @@
+import { DocId } from "./docs/registry.js";
+
+//#region ../../libs/contracts/src/ownership.d.ts
+declare const StabilityEnum: {
+  readonly Idea: "idea";
+  readonly InCreation: "in_creation";
+  readonly Experimental: "experimental";
+  readonly Beta: "beta";
+  readonly Stable: "stable";
+  readonly Deprecated: "deprecated";
+};
+type Stability = (typeof StabilityEnum)[keyof typeof StabilityEnum];
+declare const OwnersEnum: {
+  readonly PlatformCore: "platform.core";
+  readonly PlatformSigil: "platform.sigil";
+  readonly PlatformMarketplace: "platform.marketplace";
+  readonly PlatformMessaging: "platform.messaging";
+  readonly PlatformContent: "platform.content";
+  readonly PlatformFeatureFlags: "platform.featureflags";
+  readonly PlatformFinance: "platform.finance";
+};
+type Owner = (typeof OwnersEnum)[keyof typeof OwnersEnum] | (string & {});
+declare const TagsEnum: {
+  readonly Spots: "spots";
+  readonly Collectivity: "collectivity";
+  readonly Marketplace: "marketplace";
+  readonly Sellers: "sellers";
+  readonly Auth: "auth";
+  readonly Login: "login";
+  readonly Signup: "signup";
+  readonly Guide: "guide";
+  readonly Docs: "docs";
+  readonly I18n: "i18n";
+  readonly Incident: "incident";
+  readonly Automation: "automation";
+  readonly Hygiene: "hygiene";
+};
+type Tag = (typeof TagsEnum)[keyof typeof TagsEnum] | (string & {});
+interface OwnerShipMeta {
+  /** Breaking changes => bump version */
+  version: number;
+  /** Fully-qualified spec key (e.g., "sigil.beginSignup") */
+  key: string;
+  /** Human-friendly spec title (e.g., "Signup begin") */
+  title?: string;
+  /** Short human-friendly summary */
+  description: string;
+  domain?: string;
+  /** Lifecycle marker for comms & tooling */
+  stability: Stability;
+  /** Owners for CODEOWNERS / on-call / approvals */
+  owners: Owner[];
+  /** Search tags, grouping, docs navigation */
+  tags: Tag[];
+  /** Doc block(s) for this operation. */
+  docId?: DocId[];
+}
+//#endregion
+export { OwnerShipMeta };
+//# sourceMappingURL=ownership.d.ts.map

package/dist/libs/contracts/src/ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.d.ts","names":[],"sources":["../../../../../../libs/contracts/src/ownership.ts"],"sourcesContent":[],"mappings":";;;cAIa;;EAAA,SAAA,UAOH,EAAA,aAAA;EACE,SAAA,YAAS,EAAA,cAAW;EAGnB,SAAA,IAQH,EAAA,MAAA;EACE,SAAK,MAAA,EAAA,QACL;EAMC,SAAA,UAcH,EAAA,YAAA;AACV,CAAA;AAIiB,KAtCL,SAAA,GAsCkB,CAAA,OAtCE,aAsCF,CAAA,CAAA,MAAA,OAtC8B,aAsC9B,CAAA;AAWjB,cA9CA,UA8CA,EAAA;EAEH,SAAA,YAAA,EAAA,eAAA;EAEF,SAAA,aAAA,EAAA,gBAAA;EAGE,SAAA,mBAAA,EAAA,sBAAA;EAAK,SAAA,iBAAA,EAAA,oBAAA;;;;;KA5CH,KAAA,WACA,yBAAyB;cAMxB;;;;;;;;;;;;;;;KAeD,GAAA,WAAc,uBAAuB;UAIhC,aAAA;;;;;;;;;;;aAWJ;;UAEH;;QAEF;;UAGE"}

package/dist/libs/contracts/src/presentations/index.d.ts

@@ -0,0 +1,2 @@
+import "./transform-engine.js";
+import "./registry.js";

package/dist/libs/contracts/src/presentations/registry.d.ts

@@ -0,0 +1 @@
+import "../registry.js";

package/dist/libs/contracts/src/presentations/transform-engine.d.ts

@@ -0,0 +1 @@
+import "react";

package/dist/libs/contracts/src/registry.d.ts

@@ -0,0 +1 @@
+import "./types.js";

package/dist/libs/contracts/src/resources.d.ts

@@ -0,0 +1 @@
+import "zod";

package/dist/libs/contracts/src/types.d.ts

@@ -0,0 +1,2 @@
+import "./experiments/spec-resolver.js";
+import "./events.js";

package/dist/libs/contracts/src/workflow/spec.d.ts

@@ -0,0 +1,88 @@
+import { OwnerShipMeta } from "../ownership.js";
+import { CapabilityRef } from "../capabilities/capabilities.js";
+import { ExperimentRef } from "../experiments/spec.js";
+import { OpRef } from "../features/types.js";
+import "../features/index.js";
+
+//#region ../../libs/contracts/src/workflow/spec.d.ts
+/**
+ * Reference to a form spec declared in {@link FormRegistry}.
+ */
+interface FormRef {
+  key: string;
+  version: number;
+}
+type StepType = 'human' | 'automation' | 'decision';
+type GuardConditionKind = 'policy' | 'expression';
+interface GuardCondition {
+  type: GuardConditionKind;
+  /** Policy name or expression string depending on the type. */
+  value: string;
+}
+interface RetryPolicy {
+  maxAttempts: number;
+  backoff: 'linear' | 'exponential';
+  delayMs: number;
+  /** Optional max delay cap for exponential backoff. */
+  maxDelayMs?: number;
+}
+interface StepAction {
+  /** Operation executed for automation steps. */
+  operation?: OpRef;
+  /** Form rendered for human input steps. */
+  form?: FormRef;
+}
+interface Step {
+  id: string;
+  type: StepType;
+  label: string;
+  description?: string;
+  action?: StepAction;
+  guard?: GuardCondition;
+  timeoutMs?: number;
+  retry?: RetryPolicy;
+  /** Integration slot identifiers required before this step can execute. */
+  requiredIntegrations?: string[];
+  /** Capabilities that must be enabled for this step to execute. */
+  requiredCapabilities?: CapabilityRef[];
+}
+interface Transition {
+  from: string;
+  to: string;
+  label?: string;
+  /** Expression evaluated against workflow data (e.g., `data.approved === true`). */
+  condition?: string;
+}
+interface SLA {
+  totalDurationMs?: number;
+  stepDurationMs?: Record<string, number>;
+}
+interface CompensationStep {
+  stepId: string;
+  operation: OpRef;
+  description?: string;
+}
+interface CompensationStrategy {
+  trigger?: 'on_failure' | 'manual';
+  steps: CompensationStep[];
+}
+interface WorkflowDefinition {
+  steps: Step[];
+  transitions: Transition[];
+  /** Optional explicit entry step. Defaults to the first step when omitted. */
+  entryStepId?: string;
+  sla?: SLA;
+  compensation?: CompensationStrategy;
+}
+type WorkflowMeta = OwnerShipMeta;
+interface WorkflowSpec {
+  meta: WorkflowMeta;
+  definition: WorkflowDefinition;
+  policy?: {
+    flags?: string[];
+  };
+  experiments?: ExperimentRef[];
+}
+//#endregion
+export { WorkflowSpec };
+//# sourceMappingURL=spec.d.ts.map

package/dist/libs/contracts/src/workflow/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/workflow/spec.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AASiB,UAAA,OAAA,CAAO;EAKZ,GAAA,EAAA,MAAQ;EASR,OAAA,EAAA,MAAA;AAEZ;AAMiB,KAjBL,QAAA,GAiBgB,OAAA,GAAA,YAAA,GAAA,UAAA;AAeX,KAvBL,kBAAA,GAuBS,QAAA,GAAA,YAAA;AAEb,UAvBS,cAAA,CAuBT;EAGG,IAAA,EAzBH,kBAyBG;EACD;EAEA,KAAA,EAAA,MAAA;;AAI4B,UA3BrB,WAAA,CA2BqB;EAGrB,WAAA,EAAU,MAAA;EAQV,OAAG,EAAA,QAAA,GAED,aAAM;EAGR,OAAA,EAAA,MAAA;EAMA;EAKA,UAAA,CAAA,EAAA,MAAA;;AAEF,UAhDE,UAAA,CAgDF;EAGP;EACS,SAAA,CAAA,EAlDH,KAkDG;EAAoB;EAGzB,IAAA,CAAA,EAnDH,OAmDG;AAEZ;AACQ,UAnDS,IAAA,CAmDT;EACM,EAAA,EAAA,MAAA;EAEE,IAAA,EApDR,QAoDQ;EAAa,KAAA,EAAA,MAAA;;WAjDlB;UACD;;UAEA;;;;yBAIe;;UAGR,UAAA;;;;;;;UAQA,GAAA;;mBAEE;;UAGF,gBAAA;;aAEJ;;;UAII,oBAAA;;SAER;;UAGQ,kBAAA;SACR;eACM;;;QAGP;iBACS;;KAGL,YAAA,GAAe;UAEV,YAAA;QACT;cACM;;;;gBAEE"}

package/dist/overlay-customization.d.ts

@@ -0,0 +1,5 @@
+//#region src/overlay-customization.d.ts
+declare function runOverlayCustomizationExample(): Promise<void>;
+//#endregion
+export { runOverlayCustomizationExample };
+//# sourceMappingURL=overlay-customization.d.ts.map

package/dist/overlay-customization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-customization.d.ts","names":[],"sources":["../src/overlay-customization.ts"],"sourcesContent":[],"mappings":";iBAgBsB,8BAAA,CAAA,GAAkC"}

package/dist/overlay-customization.js

@@ -0,0 +1,50 @@
+import { LogLevel, Logger } from "@contractspec/lib.logger";
+import { defineOverlay } from "@contractspec/lib.overlay-engine/spec";
+import { signOverlay } from "@contractspec/lib.overlay-engine/signer";
+import { OverlayEngine, OverlayRegistry } from "@contractspec/lib.overlay-engine";
+
+//#region src/overlay-customization.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"
+});
+async function runOverlayCustomizationExample() {
+	const registry = new OverlayRegistry({ allowUnsigned: true });
+	const engine = new OverlayEngine({ registry });
+	const signed = await signOverlay(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"
+		}]
+	}), 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 });
+}
+
+//#endregion
+export { runOverlayCustomizationExample };
+//# sourceMappingURL=overlay-customization.js.map

package/dist/overlay-customization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-customization.js","names":[],"sources":["../src/overlay-customization.ts"],"sourcesContent":["import { defineOverlay } from '@contractspec/lib.overlay-engine/spec';\nimport { signOverlay } from '@contractspec/lib.overlay-engine/signer';\nimport {\n  OverlayEngine,\n  OverlayRegistry,\n} from '@contractspec/lib.overlay-engine';\nimport { Logger, LogLevel } from '@contractspec/lib.logger';\n\nconst logger = new Logger({\n  level: process.env.NODE_ENV === 'production' ? LogLevel.INFO : LogLevel.DEBUG,\n  environment:\n    (process.env.NODE_ENV as 'production' | 'development' | 'test') ||\n    'development',\n  enableColors: process.env.NODE_ENV !== 'production',\n});\n\nexport async function runOverlayCustomizationExample(): Promise<void> {\n  const registry = new OverlayRegistry({ allowUnsigned: true });\n  const engine = new OverlayEngine({ registry });\n\n  const overlay = defineOverlay({\n    overlayId: 'demo-overlay',\n    version: '1.0.0',\n    appliesTo: {\n      capability: 'billing.createOrder',\n      tenantId: 'demo',\n    },\n    modifications: [\n      { type: 'hideField', field: 'internalNotes' },\n      {\n        type: 'renameLabel',\n        field: 'customerReference',\n        newLabel: 'PO Number',\n      },\n    ],\n  });\n\n  const signed = await signOverlay(overlay, process.env.PRIVATE_KEY_PEM ?? '');\n  registry.register(signed);\n\n  const result = engine.apply({\n    target: {\n      fields: [\n        {\n          key: 'customerReference',\n          label: 'Customer Reference',\n          visible: true,\n        },\n        { key: 'internalNotes', label: 'Internal Notes', visible: true },\n      ],\n    },\n    capability: 'billing.createOrder',\n    tenantId: 'demo',\n  });\n\n  logger.info('Overlay applied', { fields: result.target.fields });\n}\n"],"mappings":";;;;;;AAQA,MAAM,SAAS,IAAI,OAAO;CACxB,OAAO,QAAQ,IAAI,aAAa,eAAe,SAAS,OAAO,SAAS;CACxE,aACG,QAAQ,IAAI,YACb;CACF,cAAc,QAAQ,IAAI,aAAa;CACxC,CAAC;AAEF,eAAsB,iCAAgD;CACpE,MAAM,WAAW,IAAI,gBAAgB,EAAE,eAAe,MAAM,CAAC;CAC7D,MAAM,SAAS,IAAI,cAAc,EAAE,UAAU,CAAC;CAmB9C,MAAM,SAAS,MAAM,YAjBL,cAAc;EAC5B,WAAW;EACX,SAAS;EACT,WAAW;GACT,YAAY;GACZ,UAAU;GACX;EACD,eAAe,CACb;GAAE,MAAM;GAAa,OAAO;GAAiB,EAC7C;GACE,MAAM;GACN,OAAO;GACP,UAAU;GACX,CACF;EACF,CAAC,EAEwC,QAAQ,IAAI,mBAAmB,GAAG;AAC5E,UAAS,SAAS,OAAO;CAEzB,MAAM,SAAS,OAAO,MAAM;EAC1B,QAAQ,EACN,QAAQ,CACN;GACE,KAAK;GACL,OAAO;GACP,SAAS;GACV,EACD;GAAE,KAAK;GAAiB,OAAO;GAAkB,SAAS;GAAM,CACjE,EACF;EACD,YAAY;EACZ,UAAU;EACX,CAAC;AAEF,QAAO,KAAK,mBAAmB,EAAE,QAAQ,OAAO,OAAO,QAAQ,CAAC"}

package/dist/workflow-extension.d.ts

@@ -0,0 +1,8 @@
+import { WorkflowSpec } from "./libs/contracts/src/workflow/spec.js";
+
+//#region src/workflow-extension.d.ts
+declare function composeTenantWorkflowExample(): WorkflowSpec;
+declare function logTenantWorkflowSteps(workflow: WorkflowSpec): void;
+//#endregion
+export { composeTenantWorkflowExample, logTenantWorkflowSteps };
+//# sourceMappingURL=workflow-extension.d.ts.map

package/dist/workflow-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-extension.d.ts","names":[],"sources":["../src/workflow-extension.ts"],"sourcesContent":[],"mappings":";;;iBAiCgB,4BAAA,CAAA,GAAgC;iBAwBhC,sBAAA,WAAiC"}

package/dist/workflow-extension.js

@@ -0,0 +1,67 @@
+import { LogLevel, Logger } from "@contractspec/lib.logger";
+import { StabilityEnum } from "@contractspec/lib.contracts";
+import { WorkflowComposer } from "@contractspec/lib.workflow-composer";
+
+//#region src/workflow-extension.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"
+});
+const BaseWorkflow = {
+	meta: {
+		key: "billing.invoiceApproval",
+		version: 1,
+		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) {
+	logger.info("Tenant workflow composed", {
+		workflow: workflow.meta.key,
+		steps: workflow.definition.steps.map((step) => step.id)
+	});
+}
+
+//#endregion
+export { composeTenantWorkflowExample, logTenantWorkflowSteps };
+//# sourceMappingURL=workflow-extension.js.map

package/dist/workflow-extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-extension.js","names":["BaseWorkflow: WorkflowSpec"],"sources":["../src/workflow-extension.ts"],"sourcesContent":["import { StabilityEnum } from '@contractspec/lib.contracts';\nimport type { WorkflowSpec } from '@contractspec/lib.contracts/workflow/spec';\nimport { WorkflowComposer } from '@contractspec/lib.workflow-composer';\nimport { Logger, LogLevel } from '@contractspec/lib.logger';\n\nconst logger = new Logger({\n  level: process.env.NODE_ENV === 'production' ? LogLevel.INFO : LogLevel.DEBUG,\n  environment:\n    (process.env.NODE_ENV as 'production' | 'development' | 'test') ||\n    'development',\n  enableColors: process.env.NODE_ENV !== 'production',\n});\n\nconst BaseWorkflow: WorkflowSpec = {\n  meta: {\n    key: 'billing.invoiceApproval',\n    version: 1,\n    title: 'Invoice Approval',\n    owners: [],\n    tags: [],\n    description: '',\n    domain: 'billing',\n    stability: StabilityEnum.Stable,\n  },\n  definition: {\n    steps: [\n      { id: 'validate-invoice', type: 'automation', label: 'Validate Invoice' },\n      { id: 'final-approval', type: 'human', label: 'Final Approval' },\n    ],\n    transitions: [{ from: 'validate-invoice', to: 'final-approval' }],\n  },\n};\n\nexport function composeTenantWorkflowExample(): WorkflowSpec {\n  const composer = new WorkflowComposer();\n  composer.register({\n    workflow: 'billing.invoiceApproval',\n    tenantId: 'acme',\n    customSteps: [\n      {\n        after: 'validate-invoice',\n        inject: {\n          id: 'acme-legal',\n          type: 'human',\n          label: 'ACME Legal Review',\n        },\n        transitionTo: 'final-approval',\n      },\n    ],\n  });\n\n  return composer.compose({\n    base: BaseWorkflow,\n    tenantId: 'acme',\n  });\n}\n\nexport function logTenantWorkflowSteps(workflow: WorkflowSpec): void {\n  logger.info('Tenant workflow composed', {\n    workflow: workflow.meta.key,\n    steps: workflow.definition.steps.map((step) => step.id),\n  });\n}\n"],"mappings":";;;;;AAKA,MAAM,SAAS,IAAI,OAAO;CACxB,OAAO,QAAQ,IAAI,aAAa,eAAe,SAAS,OAAO,SAAS;CACxE,aACG,QAAQ,IAAI,YACb;CACF,cAAc,QAAQ,IAAI,aAAa;CACxC,CAAC;AAEF,MAAMA,eAA6B;CACjC,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,QAAQ,EAAE;EACV,MAAM,EAAE;EACR,aAAa;EACb,QAAQ;EACR,WAAW,cAAc;EAC1B;CACD,YAAY;EACV,OAAO,CACL;GAAE,IAAI;GAAoB,MAAM;GAAc,OAAO;GAAoB,EACzE;GAAE,IAAI;GAAkB,MAAM;GAAS,OAAO;GAAkB,CACjE;EACD,aAAa,CAAC;GAAE,MAAM;GAAoB,IAAI;GAAkB,CAAC;EAClE;CACF;AAED,SAAgB,+BAA6C;CAC3D,MAAM,WAAW,IAAI,kBAAkB;AACvC,UAAS,SAAS;EAChB,UAAU;EACV,UAAU;EACV,aAAa,CACX;GACE,OAAO;GACP,QAAQ;IACN,IAAI;IACJ,MAAM;IACN,OAAO;IACR;GACD,cAAc;GACf,CACF;EACF,CAAC;AAEF,QAAO,SAAS,QAAQ;EACtB,MAAM;EACN,UAAU;EACX,CAAC;;AAGJ,SAAgB,uBAAuB,UAA8B;AACnE,QAAO,KAAK,4BAA4B;EACtC,UAAU,SAAS,KAAK;EACxB,OAAO,SAAS,WAAW,MAAM,KAAK,SAAS,KAAK,GAAG;EACxD,CAAC"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@contractspec/example.personalization",
+  "version": "1.44.0",
+  "description": "Personalization examples: behavior tracking, overlay customization, workflow extension.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./behavior-tracking": "./dist/behavior-tracking.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/personalization.docblock": "./dist/docs/personalization.docblock.js",
+    "./example": "./dist/example.js",
+    "./overlay-customization": "./dist/overlay-customization.js",
+    "./workflow-extension": "./dist/workflow-extension.js",
+    "./*": "./*"
+  },
+  "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.personalization": "1.44.0",
+    "@contractspec/lib.overlay-engine": "1.44.0",
+    "@contractspec/lib.workflow-composer": "1.44.0",
+    "@contractspec/lib.schema": "1.44.0",
+    "@contractspec/lib.contracts": "1.44.0",
+    "@contractspec/lib.logger": "1.44.0"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "1.44.0",
+    "@contractspec/tool.typescript": "1.44.0",
+    "tsdown": "^0.18.3",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./behavior-tracking": "./dist/behavior-tracking.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/personalization.docblock": "./dist/docs/personalization.docblock.js",
+      "./example": "./dist/example.js",
+      "./overlay-customization": "./dist/overlay-customization.js",
+      "./workflow-extension": "./dist/workflow-extension.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "module": "./dist/index.js",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/personalization"
+  },
+  "homepage": "https://contractspec.io"
+}

package/src/behavior-tracking.ts

@@ -0,0 +1,47 @@
+import { createBehaviorTracker } from '@contractspec/lib.personalization/tracker';
+import { InMemoryBehaviorStore } from '@contractspec/lib.personalization/store';
+import { BehaviorAnalyzer } from '@contractspec/lib.personalization/analyzer';
+import { Logger, LogLevel } from '@contractspec/lib.logger';
+
+const logger = new Logger({
+  level: process.env.NODE_ENV === 'production' ? LogLevel.INFO : LogLevel.DEBUG,
+  environment:
+    (process.env.NODE_ENV as 'production' | 'development' | 'test') ||
+    'development',
+  enableColors: process.env.NODE_ENV !== 'production',
+});
+
+export async function runBehaviorTrackingExample(): Promise<void> {
+  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 });
+}

package/src/docs/index.ts

@@ -0,0 +1 @@
+import './personalization.docblock';

package/src/docs/personalization.docblock.ts

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

package/src/example.ts

@@ -0,0 +1,25 @@
+const example = {
+  id: 'personalization',
+  title: 'Personalization Patterns',
+  summary:
+    'Small examples for behavior tracking, overlay-based UI customization, and tenant workflow extension.',
+  tags: ['personalization', 'overlays', 'behavior', 'workflows'],
+  kind: 'library',
+  visibility: 'public',
+  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 },
+  },
+} as const;
+
+export default example;

package/src/index.ts

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