@contractspec/example.personalization 0.0.0-canary-20260113170453

package/CHANGELOG.md

@@ -0,0 +1,408 @@
+# @contractspec/example.personalization
+
+## 0.0.0-canary-20260113170453
+
+### Minor Changes
+
+- caf8701: feat: add cli vibe command to run workflow
+- c69b849: feat: add api web services (mcp & website)
+- 42b8d78: feat: add cli `contractspec vibe` workflow to simplify usage
+- fd38e85: feat: auto-fix contractspec issues
+
+### Patch Changes
+
+- e7ded36: feat: improve stability (adding ts-morph)
+- c231a8b: test: improve workspace stability
+- Updated dependencies [e7ded36]
+- Updated dependencies [caf8701]
+- Updated dependencies [c69b849]
+- Updated dependencies [c231a8b]
+- Updated dependencies [42b8d78]
+- Updated dependencies [fd38e85]
+  - @contractspec/lib.workflow-composer@0.0.0-canary-20260113170453
+  - @contractspec/lib.personalization@0.0.0-canary-20260113170453
+  - @contractspec/lib.overlay-engine@0.0.0-canary-20260113170453
+  - @contractspec/lib.contracts@0.0.0-canary-20260113170453
+  - @contractspec/lib.logger@0.0.0-canary-20260113170453
+
+## 1.46.2
+
+### Patch Changes
+
+- 7e21625: feat: library services (landing page & api)
+- Updated dependencies [7e21625]
+  - @contractspec/lib.workflow-composer@1.46.2
+  - @contractspec/lib.personalization@1.46.2
+  - @contractspec/lib.overlay-engine@1.46.2
+  - @contractspec/lib.contracts@1.46.2
+  - @contractspec/lib.logger@1.46.2
+
+## 1.46.1
+
+### Patch Changes
+
+- 2d8a72b: fix: mcp for presentation
+- Updated dependencies [2d8a72b]
+  - @contractspec/lib.workflow-composer@1.46.1
+  - @contractspec/lib.personalization@1.46.1
+  - @contractspec/lib.overlay-engine@1.46.1
+  - @contractspec/lib.contracts@1.46.1
+  - @contractspec/lib.logger@1.46.1
+
+## 1.46.0
+
+### Minor Changes
+
+- 07cb19b: feat: feat: cleaude code & opencode integrations
+
+### Patch Changes
+
+- Updated dependencies [07cb19b]
+  - @contractspec/lib.workflow-composer@1.46.0
+  - @contractspec/lib.personalization@1.46.0
+  - @contractspec/lib.overlay-engine@1.46.0
+  - @contractspec/lib.contracts@1.46.0
+  - @contractspec/lib.logger@1.46.0
+
+## 1.45.6
+
+### Patch Changes
+
+- a913074: feat: improve ai agents rules management"
+- Updated dependencies [a913074]
+  - @contractspec/lib.workflow-composer@1.45.6
+  - @contractspec/lib.personalization@1.45.6
+  - @contractspec/lib.overlay-engine@1.45.6
+  - @contractspec/lib.contracts@1.45.6
+  - @contractspec/lib.logger@1.45.6
+
+## 1.45.5
+
+### Patch Changes
+
+- 9ddd7fa: feat: improve versioning
+- Updated dependencies [9ddd7fa]
+  - @contractspec/lib.workflow-composer@1.45.5
+  - @contractspec/lib.personalization@1.45.5
+  - @contractspec/lib.overlay-engine@1.45.5
+  - @contractspec/lib.contracts@1.45.5
+  - @contractspec/lib.logger@1.45.5
+
+## 1.45.4
+
+### Patch Changes
+
+- fix: github action
+- Updated dependencies
+  - @contractspec/lib.workflow-composer@1.45.4
+  - @contractspec/lib.personalization@1.45.4
+  - @contractspec/lib.overlay-engine@1.45.4
+  - @contractspec/lib.contracts@1.45.4
+  - @contractspec/lib.logger@1.45.4
+
+## 1.45.3
+
+### Patch Changes
+
+- e74ea9e: feat: version management
+- Updated dependencies [e74ea9e]
+  - @contractspec/lib.workflow-composer@1.45.3
+  - @contractspec/lib.personalization@1.45.3
+  - @contractspec/lib.overlay-engine@1.45.3
+  - @contractspec/lib.contracts@1.45.3
+  - @contractspec/lib.logger@1.45.3
+
+## 1.45.2
+
+### Patch Changes
+
+- 39ca241: code cleaning
+- Updated dependencies [39ca241]
+  - @contractspec/lib.workflow-composer@1.45.2
+  - @contractspec/lib.personalization@1.45.2
+  - @contractspec/lib.overlay-engine@1.45.2
+  - @contractspec/lib.contracts@1.45.2
+  - @contractspec/lib.logger@1.45.2
+
+## 1.45.1
+
+### Patch Changes
+
+- feat: improve app config and examples contracts
+- Updated dependencies
+  - @contractspec/lib.workflow-composer@1.45.1
+  - @contractspec/lib.personalization@1.45.1
+  - @contractspec/lib.overlay-engine@1.45.1
+  - @contractspec/lib.contracts@1.45.1
+  - @contractspec/lib.logger@1.45.1
+  - @contractspec/lib.schema@1.45.1
+
+## 1.45.0
+
+### Minor Changes
+
+- e73ca1d: feat: improve app config and examples contracts
+  feat: Contract layers support (features, examples, app-configs)
+
+  ### New CLI Commands
+  - `contractspec list layers` - List all contract layers with filtering
+
+  ### Enhanced Commands
+  - `contractspec ci` - New `layers` check category validates features/examples/config
+  - `contractspec doctor` - New `layers` health checks
+  - `contractspec integrity` - Now shows layer statistics
+
+  ### New APIs
+  - `discoverLayers()` - Scan workspace for all layer files
+  - `scanExampleSource()` - Parse ExampleSpec from source code
+  - `isExampleFile()` - Check if file is an example spec
+
+### Patch Changes
+
+- Updated dependencies [e73ca1d]
+  - @contractspec/lib.workflow-composer@1.45.0
+  - @contractspec/lib.personalization@1.45.0
+  - @contractspec/lib.overlay-engine@1.45.0
+  - @contractspec/lib.contracts@1.45.0
+  - @contractspec/lib.logger@1.45.0
+  - @contractspec/lib.schema@1.45.0
+
+## 1.44.1
+
+### Patch Changes
+
+- 3c594fb: fix
+- Updated dependencies [3c594fb]
+  - @contractspec/lib.workflow-composer@1.44.1
+  - @contractspec/lib.personalization@1.44.1
+  - @contractspec/lib.overlay-engine@1.44.1
+  - @contractspec/lib.contracts@1.44.1
+  - @contractspec/lib.logger@1.44.1
+  - @contractspec/lib.schema@1.44.1
+
+## 1.44.0
+
+### Minor Changes
+
+- 5f3a868: chore: isolate branding to contractspec.io
+
+### Patch Changes
+
+- Updated dependencies [5f3a868]
+  - @contractspec/lib.workflow-composer@1.44.0
+  - @contractspec/lib.personalization@1.44.0
+  - @contractspec/lib.overlay-engine@1.44.0
+  - @contractspec/lib.contracts@1.44.0
+  - @contractspec/lib.logger@1.44.0
+  - @contractspec/lib.schema@1.44.0
+
+## 1.43.4
+
+### Patch Changes
+
+- 9216062: fix: cross-platform compatibility
+- Updated dependencies [9216062]
+  - @contractspec/lib.workflow-composer@1.43.4
+  - @contractspec/lib.personalization@1.43.4
+  - @contractspec/lib.overlay-engine@1.43.4
+  - @contractspec/lib.contracts@1.43.4
+  - @contractspec/lib.logger@1.43.3
+  - @contractspec/lib.schema@1.43.3
+
+## 1.43.3
+
+### Patch Changes
+
+- 24d9759: improve documentation
+- Updated dependencies [24d9759]
+  - @contractspec/lib.workflow-composer@1.43.3
+  - @contractspec/lib.personalization@1.43.3
+  - @contractspec/lib.overlay-engine@1.43.3
+  - @contractspec/lib.contracts@1.43.3
+  - @contractspec/lib.logger@1.43.2
+  - @contractspec/lib.schema@1.43.2
+
+## 1.43.2
+
+### Patch Changes
+
+- e147271: fix: improve stability
+- Updated dependencies [e147271]
+  - @contractspec/lib.workflow-composer@1.43.2
+  - @contractspec/lib.personalization@1.43.2
+  - @contractspec/lib.overlay-engine@1.43.2
+  - @contractspec/lib.contracts@1.43.2
+  - @contractspec/lib.logger@1.43.1
+  - @contractspec/lib.schema@1.43.1
+
+## 1.43.1
+
+### Patch Changes
+
+- Updated dependencies [f28fdad]
+  - @contractspec/lib.contracts@1.43.1
+  - @contractspec/lib.overlay-engine@1.43.1
+  - @contractspec/lib.personalization@1.43.1
+  - @contractspec/lib.workflow-composer@1.43.1
+
+## 1.43.0
+
+### Minor Changes
+
+- 042d072: feat: schema declaration using json schema, including zod
+
+### Patch Changes
+
+- Updated dependencies [042d072]
+  - @contractspec/lib.workflow-composer@1.43.0
+  - @contractspec/lib.personalization@1.43.0
+  - @contractspec/lib.overlay-engine@1.43.0
+  - @contractspec/lib.contracts@1.43.0
+  - @contractspec/lib.logger@1.43.0
+  - @contractspec/lib.schema@1.43.0
+
+## 1.42.10
+
+### Patch Changes
+
+- 1e6a0f1: fix: mcp server
+- Updated dependencies [1e6a0f1]
+  - @contractspec/lib.workflow-composer@1.42.10
+  - @contractspec/lib.personalization@1.42.10
+  - @contractspec/lib.overlay-engine@1.42.10
+  - @contractspec/lib.contracts@1.42.10
+  - @contractspec/lib.logger@1.42.10
+  - @contractspec/lib.schema@1.42.10
+
+## 1.42.9
+
+### Patch Changes
+
+- 9281db7: fix ModelRegistry
+- Updated dependencies [9281db7]
+  - @contractspec/lib.workflow-composer@1.42.9
+  - @contractspec/lib.personalization@1.42.9
+  - @contractspec/lib.overlay-engine@1.42.9
+  - @contractspec/lib.contracts@1.42.9
+  - @contractspec/lib.logger@1.42.9
+  - @contractspec/lib.schema@1.42.9
+
+## 1.42.8
+
+### Patch Changes
+
+- e07b5ac: fix
+- Updated dependencies [e07b5ac]
+  - @contractspec/lib.workflow-composer@1.42.8
+  - @contractspec/lib.personalization@1.42.8
+  - @contractspec/lib.overlay-engine@1.42.8
+  - @contractspec/lib.contracts@1.42.8
+  - @contractspec/lib.logger@1.42.8
+  - @contractspec/lib.schema@1.42.8
+
+## 1.42.7
+
+### Patch Changes
+
+- e9b575d: fix release
+- Updated dependencies [e9b575d]
+  - @contractspec/lib.workflow-composer@1.42.7
+  - @contractspec/lib.personalization@1.42.7
+  - @contractspec/lib.overlay-engine@1.42.7
+  - @contractspec/lib.contracts@1.42.7
+  - @contractspec/lib.logger@1.42.7
+  - @contractspec/lib.schema@1.42.7
+
+## 1.42.6
+
+### Patch Changes
+
+- 1500242: fix tooling
+- Updated dependencies [1500242]
+  - @contractspec/lib.workflow-composer@1.42.6
+  - @contractspec/lib.personalization@1.42.6
+  - @contractspec/lib.overlay-engine@1.42.6
+  - @contractspec/lib.contracts@1.42.6
+  - @contractspec/lib.logger@1.42.6
+  - @contractspec/lib.schema@1.42.6
+
+## 1.42.5
+
+### Patch Changes
+
+- 1299719: fix vscode
+- Updated dependencies [1299719]
+  - @contractspec/lib.workflow-composer@1.42.5
+  - @contractspec/lib.personalization@1.42.5
+  - @contractspec/lib.overlay-engine@1.42.5
+  - @contractspec/lib.contracts@1.42.5
+  - @contractspec/lib.logger@1.42.5
+  - @contractspec/lib.schema@1.42.5
+
+## 1.42.4
+
+### Patch Changes
+
+- ac28b99: fix: generate from openapi
+- Updated dependencies [ac28b99]
+  - @contractspec/lib.workflow-composer@1.42.4
+  - @contractspec/lib.personalization@1.42.4
+  - @contractspec/lib.overlay-engine@1.42.4
+  - @contractspec/lib.contracts@1.42.4
+  - @contractspec/lib.logger@1.42.4
+  - @contractspec/lib.schema@1.42.4
+
+## 1.42.3
+
+### Patch Changes
+
+- 3f5d015: fix(tooling): cicd
+- Updated dependencies [3f5d015]
+  - @contractspec/lib.contracts@1.42.3
+  - @contractspec/lib.logger@1.42.3
+  - @contractspec/lib.overlay-engine@1.42.3
+  - @contractspec/lib.personalization@1.42.3
+  - @contractspec/lib.schema@1.42.3
+  - @contractspec/lib.workflow-composer@1.42.3
+
+## 1.42.2
+
+### Patch Changes
+
+- 1f9ac4c: fix
+- Updated dependencies [1f9ac4c]
+  - @contractspec/lib.contracts@1.42.2
+  - @contractspec/lib.logger@1.42.2
+  - @contractspec/lib.overlay-engine@1.42.2
+  - @contractspec/lib.personalization@1.42.2
+  - @contractspec/lib.schema@1.42.2
+  - @contractspec/lib.workflow-composer@1.42.2
+
+## 1.42.1
+
+### Patch Changes
+
+- f043995: Fix release
+- Updated dependencies [f043995]
+  - @contractspec/lib.workflow-composer@1.42.1
+  - @contractspec/lib.personalization@1.42.1
+  - @contractspec/lib.overlay-engine@1.42.1
+  - @contractspec/lib.contracts@1.42.1
+  - @contractspec/lib.logger@1.42.1
+  - @contractspec/lib.schema@1.42.1
+
+## 1.42.0
+
+### Minor Changes
+
+- 8eefd9c: initial release
+
+### Patch Changes
+
+- Updated dependencies [8eefd9c]
+  - @contractspec/lib.contracts@1.42.0
+  - @contractspec/lib.logger@1.42.0
+  - @contractspec/lib.overlay-engine@1.42.0
+  - @contractspec/lib.personalization@1.42.0
+  - @contractspec/lib.schema@1.42.0
+  - @contractspec/lib.workflow-composer@1.42.0

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/dist/behavior-tracking.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"behavior-tracking.d.ts","names":[],"sources":["../src/behavior-tracking.ts"],"sourcesContent":[],"mappings":";iBAasB,0BAAA,CAAA,GAA8B"}

package/dist/behavior-tracking.js

@@ -0,0 +1,48 @@
+import { createBehaviorTracker } from "@contractspec/lib.personalization/tracker";
+import { InMemoryBehaviorStore } from "@contractspec/lib.personalization/store";
+import { BehaviorAnalyzer } from "@contractspec/lib.personalization/analyzer";
+import { LogLevel, Logger } from "@contractspec/lib.logger";
+
+//#region src/behavior-tracking.ts
+const logger = new Logger({
+	level: process.env.NODE_ENV === "production" ? LogLevel.INFO : LogLevel.DEBUG,
+	environment: process.env.NODE_ENV || "development",
+	enableColors: process.env.NODE_ENV !== "production"
+});
+async function runBehaviorTrackingExample() {
+	const store = new InMemoryBehaviorStore();
+	const tracker = createBehaviorTracker({
+		store,
+		context: {
+			tenantId: "acme",
+			userId: "user-123"
+		}
+	});
+	tracker.trackFieldAccess({
+		operation: "billing.createOrder",
+		field: "internalNotes"
+	});
+	tracker.trackFieldAccess({
+		operation: "billing.createOrder",
+		field: "customerReference"
+	});
+	tracker.trackFeatureUsage({
+		feature: "workflow-editor",
+		action: "opened"
+	});
+	tracker.trackWorkflowStep({
+		workflow: "invoice-approval",
+		step: "review",
+		status: "entered"
+	});
+	await tracker.flush();
+	const insights = await new BehaviorAnalyzer(store).analyze({
+		tenantId: "acme",
+		userId: "user-123"
+	});
+	logger.info("Behavior insights computed", { insights });
+}
+
+//#endregion
+export { runBehaviorTrackingExample };
+//# sourceMappingURL=behavior-tracking.js.map

package/dist/behavior-tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"behavior-tracking.js","names":[],"sources":["../src/behavior-tracking.ts"],"sourcesContent":["import { createBehaviorTracker } from '@contractspec/lib.personalization/tracker';\nimport { InMemoryBehaviorStore } from '@contractspec/lib.personalization/store';\nimport { BehaviorAnalyzer } from '@contractspec/lib.personalization/analyzer';\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 runBehaviorTrackingExample(): Promise<void> {\n  const store = new InMemoryBehaviorStore();\n  const tracker = createBehaviorTracker({\n    store,\n    context: {\n      tenantId: 'acme',\n      userId: 'user-123',\n    },\n  });\n\n  tracker.trackFieldAccess({\n    operation: 'billing.createOrder',\n    field: 'internalNotes',\n  });\n  tracker.trackFieldAccess({\n    operation: 'billing.createOrder',\n    field: 'customerReference',\n  });\n  tracker.trackFeatureUsage({ feature: 'workflow-editor', action: 'opened' });\n  tracker.trackWorkflowStep({\n    workflow: 'invoice-approval',\n    step: 'review',\n    status: 'entered',\n  });\n  await tracker.flush();\n\n  const analyzer = new BehaviorAnalyzer(store);\n  const insights = await analyzer.analyze({\n    tenantId: 'acme',\n    userId: 'user-123',\n  });\n\n  logger.info('Behavior insights computed', { insights });\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,eAAsB,6BAA4C;CAChE,MAAM,QAAQ,IAAI,uBAAuB;CACzC,MAAM,UAAU,sBAAsB;EACpC;EACA,SAAS;GACP,UAAU;GACV,QAAQ;GACT;EACF,CAAC;AAEF,SAAQ,iBAAiB;EACvB,WAAW;EACX,OAAO;EACR,CAAC;AACF,SAAQ,iBAAiB;EACvB,WAAW;EACX,OAAO;EACR,CAAC;AACF,SAAQ,kBAAkB;EAAE,SAAS;EAAmB,QAAQ;EAAU,CAAC;AAC3E,SAAQ,kBAAkB;EACxB,UAAU;EACV,MAAM;EACN,QAAQ;EACT,CAAC;AACF,OAAM,QAAQ,OAAO;CAGrB,MAAM,WAAW,MADA,IAAI,iBAAiB,MAAM,CACZ,QAAQ;EACtC,UAAU;EACV,QAAQ;EACT,CAAC;AAEF,QAAO,KAAK,8BAA8B,EAAE,UAAU,CAAC"}

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

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

package/dist/docs/personalization.docblock.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/personalization.docblock.js

@@ -0,0 +1,30 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/personalization.docblock.ts
+registerDocBlocks([{
+	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.`
+}]);
+
+//#endregion
+//# sourceMappingURL=personalization.docblock.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"personalization.docblock.js","names":[],"sources":["../../src/docs/personalization.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst blocks: DocBlock[] = [\n  {\n    id: 'docs.examples.personalization',\n    title: 'Personalization Patterns (example)',\n    summary:\n      'Behavior tracking, overlay-driven UI tweaks, and tenant workflow extension patterns.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/personalization',\n    tags: ['personalization', 'overlays', 'workflows', 'example'],\n    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.`,\n  },\n  {\n    id: 'docs.examples.personalization.usage',\n    title: 'Personalization — Usage',\n    summary: 'How to run the small examples and swap adapters.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/examples/personalization/usage',\n    tags: ['personalization', 'usage'],\n    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.`,\n  },\n];\n\nregisterDocBlocks(blocks);\n"],"mappings":";;;AA2BA,kBAxB2B,CACzB;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAmB;EAAY;EAAa;EAAU;CAC7D,MAAM;CACP,EACD;CACE,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,mBAAmB,QAAQ;CAClC,MAAM;CACP,CACF,CAEwB"}

package/dist/example.d.ts

@@ -0,0 +1,8 @@
+import { ExampleSpec } from "./libs/contracts/src/examples/types.js";
+import "./libs/contracts/src/index.js";
+
+//#region src/example.d.ts
+declare const example: ExampleSpec;
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";;;;cAEM,SA2BJ"}

package/dist/example.js

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

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["import { defineExample } from '@contractspec/lib.contracts';\n\nconst example = defineExample({\n  meta: {\n    key: 'personalization',\n    version: '1.0.0',\n    title: 'Personalization Patterns',\n    description:\n      'Small examples for behavior tracking, overlay-based UI customization, and tenant workflow extension.',\n    kind: 'library',\n    visibility: 'public',\n    stability: 'experimental',\n    owners: ['@platform.core'],\n    tags: ['personalization', 'overlays', 'behavior', 'workflows'],\n  },\n  docs: {\n    rootDocId: 'docs.examples.personalization',\n    usageDocId: 'docs.examples.personalization.usage',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.personalization',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['markdown', 'specs'] },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n});\n\nexport default example;\n"],"mappings":";;;AAEA,MAAM,UAAU,cAAc;CAC5B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,iBAAiB;EAC1B,MAAM;GAAC;GAAmB;GAAY;GAAY;GAAY;EAC/D;CACD,MAAM;EACJ,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,YAAY,QAAQ;GAAE;EACxD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF,CAAC;AAEF,sBAAe"}

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/app-config/branding.d.ts

@@ -0,0 +1,20 @@
+//#region ../../libs/contracts/src/app-config/branding.d.ts
+interface BrandingAssetRef {
+  type: 'logo' | 'logo-dark' | 'favicon' | 'og-image';
+  url?: string;
+  dimensions?: {
+    width: number;
+    height: number;
+  };
+}
+interface BrandingDefaults {
+  appNameKey: string;
+  assets?: BrandingAssetRef[];
+  colorTokens?: {
+    primary?: string;
+    secondary?: string;
+  };
+}
+//#endregion
+export { BrandingDefaults };
+//# sourceMappingURL=branding.d.ts.map

package/dist/libs/contracts/src/app-config/branding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/app-config/branding.ts"],"sourcesContent":[],"mappings":";UAAiB,gBAAA;EAAA,IAAA,EAAA,MAAA,GAAA,WAAgB,GAAA,SAAA,GAAA,UAAA;EAMhB,GAAA,CAAA,EAAA,MAAA;;;;;;UAAA,gBAAA;;WAEN"}

package/dist/libs/contracts/src/app-config/lifecycle.d.ts

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

package/dist/libs/contracts/src/app-config/runtime.d.ts

@@ -0,0 +1,9 @@
+import "../features/index.js";
+import "../data-views/index.js";
+import "../workflow/spec.js";
+import "../policy/registry.js";
+import "../themes.js";
+import "../integrations/spec.js";
+import "../integrations/connection.js";
+import "../knowledge/spec.js";
+import "./spec.js";