@contractspec/example.product-intent 0.0.0-canary-20260206014742 → 1.57.0

package/.turbo/turbo-build$colon$bundle.log

@@ -1,28 +1,36 @@
 $ tsdown
 ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
 ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/product-intent/tsdown.config.js 
-ℹ entry: src/example.ts, src/index.ts, src/load-evidence.ts, src/script.ts, src/sync-actions.ts
+ℹ entry: src/example.ts, src/index.ts, src/load-evidence.ts, src/posthog-signals.ts, src/script.ts, src/sync-actions.ts
 ℹ target: esnext
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ Cleaning 16 files
-ℹ dist/script.js                6.38 kB │ gzip: 2.23 kB
-ℹ dist/sync-actions.js          5.71 kB │ gzip: 2.02 kB
-ℹ dist/load-evidence.js         2.31 kB │ gzip: 1.02 kB
-ℹ dist/example.js               0.81 kB │ gzip: 0.44 kB
-ℹ dist/index.js                 0.27 kB │ gzip: 0.15 kB
-ℹ dist/script.js.map           11.38 kB │ gzip: 3.65 kB
-ℹ dist/sync-actions.js.map     10.31 kB │ gzip: 3.30 kB
-ℹ dist/load-evidence.js.map     4.01 kB │ gzip: 1.65 kB
-ℹ dist/example.js.map           1.22 kB │ gzip: 0.63 kB
-ℹ dist/load-evidence.d.ts.map   0.25 kB │ gzip: 0.18 kB
-ℹ dist/example.d.ts.map         0.13 kB │ gzip: 0.13 kB
-ℹ dist/load-evidence.d.ts       0.75 kB │ gzip: 0.41 kB
-ℹ dist/index.d.ts               0.32 kB │ gzip: 0.17 kB
-ℹ dist/example.d.ts             0.25 kB │ gzip: 0.17 kB
-ℹ dist/script.d.ts              0.01 kB │ gzip: 0.03 kB
-ℹ dist/sync-actions.d.ts        0.01 kB │ gzip: 0.03 kB
-ℹ 16 files, total: 44.11 kB
+ℹ Cleaning 28 files
+ℹ dist/posthog-signals.js                           6.96 kB │ gzip: 2.20 kB
+ℹ dist/script.js                                    6.55 kB │ gzip: 2.29 kB
+ℹ dist/sync-actions.js                              5.88 kB │ gzip: 2.07 kB
+ℹ dist/load-evidence.js                             2.67 kB │ gzip: 1.12 kB
+ℹ dist/example.js                                   0.81 kB │ gzip: 0.44 kB
+ℹ dist/index.js                                     0.50 kB │ gzip: 0.21 kB
+ℹ dist/posthog-signals.js.map                      14.02 kB │ gzip: 4.15 kB
+ℹ dist/script.js.map                               11.64 kB │ gzip: 3.74 kB
+ℹ dist/sync-actions.js.map                         10.53 kB │ gzip: 3.37 kB
+ℹ dist/load-evidence.js.map                         4.79 kB │ gzip: 1.86 kB
+ℹ dist/libs/analytics/dist/funnel/analyzer.js.map   3.65 kB │ gzip: 1.39 kB
+ℹ dist/libs/analytics/dist/funnel/analyzer.js       2.00 kB │ gzip: 0.84 kB
+ℹ dist/example.js.map                               1.22 kB │ gzip: 0.63 kB
+ℹ dist/libs/analytics/dist/types.d.ts.map           0.95 kB │ gzip: 0.48 kB
+ℹ dist/posthog-signals.d.ts.map                     0.37 kB │ gzip: 0.23 kB
+ℹ dist/load-evidence.d.ts.map                       0.37 kB │ gzip: 0.23 kB
+ℹ dist/example.d.ts.map                             0.13 kB │ gzip: 0.13 kB
+ℹ dist/load-evidence.d.ts                           1.10 kB │ gzip: 0.49 kB
+ℹ dist/posthog-signals.d.ts                         1.00 kB │ gzip: 0.43 kB
+ℹ dist/index.d.ts                                   0.67 kB │ gzip: 0.24 kB
+ℹ dist/example.d.ts                                 0.25 kB │ gzip: 0.17 kB
+ℹ dist/script.d.ts                                  0.01 kB │ gzip: 0.03 kB
+ℹ dist/sync-actions.d.ts                            0.01 kB │ gzip: 0.03 kB
+ℹ dist/libs/analytics/dist/types.d.ts               0.50 kB │ gzip: 0.28 kB
+ℹ 24 files, total: 76.58 kB
 src/load-evidence.ts (1:15) [UNRESOLVED_IMPORT] Warning: Could not resolve 'node:fs' in src/load-evidence.ts
    ╭─[ src/load-evidence.ts:1:16 ]
    │
@@ -73,7 +81,6 @@ src/script.ts (2:17) [UNRESOLVED_IMPORT] Warning: Could not resolve 'no
    │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
 ───╯
 
-✔ Build complete in 12262ms
 src/script.ts (3:30) [UNRESOLVED_IMPORT] Warning: Could not resolve 'node:url' in src/script.ts
    ╭─[ src/script.ts:3:31 ]
    │
@@ -85,7 +92,8 @@ src/script.ts (3:30) [UNRESOLVED_IMPORT] Warning: Could not resolve 'no
 ───╯
 
 [PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
-  - tsdown:external (82%)
-  - rolldown-plugin-dts:generate (18%)
+  - tsdown:external (76%)
+  - rolldown-plugin-dts:generate (24%)
 See https://rolldown.rs/options/checks#plugintimings for more details.
 
+✔ Build complete in 21052ms

package/.turbo/turbo-build.log

@@ -3,27 +3,35 @@ $ tsc --noEmit
 $ tsdown
 ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
 ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/product-intent/tsdown.config.js 
-ℹ entry: src/example.ts, src/index.ts, src/load-evidence.ts, src/script.ts, src/sync-actions.ts
+ℹ entry: src/example.ts, src/index.ts, src/load-evidence.ts, src/posthog-signals.ts, src/script.ts, src/sync-actions.ts
 ℹ target: esnext
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ dist/script.js                6.38 kB │ gzip: 2.23 kB
-ℹ dist/sync-actions.js          5.71 kB │ gzip: 2.02 kB
-ℹ dist/load-evidence.js         2.31 kB │ gzip: 1.02 kB
-ℹ dist/example.js               0.81 kB │ gzip: 0.44 kB
-ℹ dist/index.js                 0.27 kB │ gzip: 0.15 kB
-ℹ dist/script.js.map           11.38 kB │ gzip: 3.65 kB
-ℹ dist/sync-actions.js.map     10.31 kB │ gzip: 3.30 kB
-ℹ dist/load-evidence.js.map     4.01 kB │ gzip: 1.65 kB
-ℹ dist/example.js.map           1.22 kB │ gzip: 0.63 kB
-ℹ dist/load-evidence.d.ts.map   0.25 kB │ gzip: 0.18 kB
-ℹ dist/example.d.ts.map         0.13 kB │ gzip: 0.13 kB
-ℹ dist/load-evidence.d.ts       0.75 kB │ gzip: 0.41 kB
-ℹ dist/index.d.ts               0.32 kB │ gzip: 0.17 kB
-ℹ dist/example.d.ts             0.25 kB │ gzip: 0.17 kB
-ℹ dist/script.d.ts              0.01 kB │ gzip: 0.03 kB
-ℹ dist/sync-actions.d.ts        0.01 kB │ gzip: 0.03 kB
-ℹ 16 files, total: 44.11 kB
+ℹ dist/posthog-signals.js                           6.96 kB │ gzip: 2.20 kB
+ℹ dist/script.js                                    6.55 kB │ gzip: 2.29 kB
+ℹ dist/sync-actions.js                              5.88 kB │ gzip: 2.07 kB
+ℹ dist/load-evidence.js                             2.67 kB │ gzip: 1.12 kB
+ℹ dist/example.js                                   0.81 kB │ gzip: 0.44 kB
+ℹ dist/index.js                                     0.50 kB │ gzip: 0.21 kB
+ℹ dist/posthog-signals.js.map                      14.02 kB │ gzip: 4.15 kB
+ℹ dist/script.js.map                               11.64 kB │ gzip: 3.74 kB
+ℹ dist/sync-actions.js.map                         10.53 kB │ gzip: 3.37 kB
+ℹ dist/load-evidence.js.map                         4.79 kB │ gzip: 1.86 kB
+ℹ dist/libs/analytics/dist/funnel/analyzer.js.map   3.65 kB │ gzip: 1.39 kB
+ℹ dist/libs/analytics/dist/funnel/analyzer.js       2.00 kB │ gzip: 0.84 kB
+ℹ dist/example.js.map                               1.22 kB │ gzip: 0.63 kB
+ℹ dist/libs/analytics/dist/types.d.ts.map           0.95 kB │ gzip: 0.48 kB
+ℹ dist/posthog-signals.d.ts.map                     0.37 kB │ gzip: 0.23 kB
+ℹ dist/load-evidence.d.ts.map                       0.37 kB │ gzip: 0.23 kB
+ℹ dist/example.d.ts.map                             0.13 kB │ gzip: 0.13 kB
+ℹ dist/load-evidence.d.ts                           1.10 kB │ gzip: 0.49 kB
+ℹ dist/posthog-signals.d.ts                         1.00 kB │ gzip: 0.43 kB
+ℹ dist/index.d.ts                                   0.67 kB │ gzip: 0.24 kB
+ℹ dist/example.d.ts                                 0.25 kB │ gzip: 0.17 kB
+ℹ dist/script.d.ts                                  0.01 kB │ gzip: 0.03 kB
+ℹ dist/sync-actions.d.ts                            0.01 kB │ gzip: 0.03 kB
+ℹ dist/libs/analytics/dist/types.d.ts               0.50 kB │ gzip: 0.28 kB
+ℹ 24 files, total: 76.58 kB
 src/load-evidence.ts (1:15) [UNRESOLVED_IMPORT] Warning: Could not resolve 'node:fs' in src/load-evidence.ts
    ╭─[ src/load-evidence.ts:1:16 ]
    │
@@ -85,8 +93,8 @@ src/script.ts (3:30) [UNRESOLVED_IMPORT] Warning: Could not resolve 'no
 ───╯
 
 [PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
-  - rolldown-plugin-dts:generate (55%)
-  - tsdown:external (45%)
+✔ Build complete in 23955ms
+  - rolldown-plugin-dts:generate (51%)
+  - tsdown:external (48%)
 See https://rolldown.rs/options/checks#plugintimings for more details.
 
-✔ Build complete in 9777ms

package/CHANGELOG.md

@@ -1,19 +1,23 @@
 # @contractspec/example.product-intent
 
-## 0.0.0-canary-20260206014742
+## 1.57.0
 
 ### Minor Changes
 
+- 8ecf3c1: Add typed PostHog read APIs and readers across contracts, providers, metering, evolution, analytics, observability, and examples.
 - a119963: Add project-management integrations (Linear, Jira, Notion), sync helpers for product intent outputs, and expose the new integration category across workspace tooling.
 - 11a5a05: feat: improve product intent
 
 ### Patch Changes
 
 - 47c48c2: Refine product-intent contracts, add core/module orchestration and bundle wiring, and expand tests/examples.
+- Updated dependencies [8ecf3c1]
 - Updated dependencies [47c48c2]
 - Updated dependencies [a119963]
+- Updated dependencies [4651e06]
+- Updated dependencies [ad9d10a]
 - Updated dependencies [11a5a05]
-  - @contractspec/lib.contracts@0.0.0-canary-20260206014742
-  - @contractspec/lib.product-intent-utils@0.0.0-canary-20260206014742
-  - @contractspec/integration.providers-impls@0.0.0-canary-20260206014742
-  - @contractspec/lib.ai-agent@0.0.0-canary-20260206014742
+  - @contractspec/lib.contracts@1.57.0
+  - @contractspec/integration.providers-impls@1.57.0
+  - @contractspec/lib.product-intent-utils@1.57.0
+  - @contractspec/lib.ai-agent@1.57.0

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 import example from "./example.js";
-import { DEFAULT_CHUNK_SIZE, DEFAULT_EVIDENCE_ROOT, DEFAULT_TRANSCRIPT_DIRS, EvidenceLoadOptions, loadEvidenceChunks } from "./load-evidence.js";
-export { DEFAULT_CHUNK_SIZE, DEFAULT_EVIDENCE_ROOT, DEFAULT_TRANSCRIPT_DIRS, type EvidenceLoadOptions, example, loadEvidenceChunks };
+import { PosthogEvidenceOptions, loadPosthogEvidenceChunks, resolvePosthogEvidenceOptionsFromEnv } from "./posthog-signals.js";
+import { DEFAULT_CHUNK_SIZE, DEFAULT_EVIDENCE_ROOT, DEFAULT_TRANSCRIPT_DIRS, EvidenceLoadOptions, EvidenceLoadWithSignalsOptions, loadEvidenceChunks, loadEvidenceChunksWithSignals } from "./load-evidence.js";
+export { DEFAULT_CHUNK_SIZE, DEFAULT_EVIDENCE_ROOT, DEFAULT_TRANSCRIPT_DIRS, type EvidenceLoadOptions, type EvidenceLoadWithSignalsOptions, type PosthogEvidenceOptions, example, loadEvidenceChunks, loadEvidenceChunksWithSignals, loadPosthogEvidenceChunks, resolvePosthogEvidenceOptionsFromEnv };

package/dist/index.js

@@ -1,4 +1,5 @@
 import example from "./example.js";
-import { DEFAULT_CHUNK_SIZE, DEFAULT_EVIDENCE_ROOT, DEFAULT_TRANSCRIPT_DIRS, loadEvidenceChunks } from "./load-evidence.js";
+import { loadPosthogEvidenceChunks, resolvePosthogEvidenceOptionsFromEnv } from "./posthog-signals.js";
+import { DEFAULT_CHUNK_SIZE, DEFAULT_EVIDENCE_ROOT, DEFAULT_TRANSCRIPT_DIRS, loadEvidenceChunks, loadEvidenceChunksWithSignals } from "./load-evidence.js";
 
-export { DEFAULT_CHUNK_SIZE, DEFAULT_EVIDENCE_ROOT, DEFAULT_TRANSCRIPT_DIRS, example, loadEvidenceChunks };
+export { DEFAULT_CHUNK_SIZE, DEFAULT_EVIDENCE_ROOT, DEFAULT_TRANSCRIPT_DIRS, example, loadEvidenceChunks, loadEvidenceChunksWithSignals, loadPosthogEvidenceChunks, resolvePosthogEvidenceOptionsFromEnv };

package/dist/libs/analytics/dist/funnel/analyzer.js

@@ -0,0 +1,64 @@
+//#region ../../libs/analytics/dist/funnel/analyzer.js
+var FunnelAnalyzer = class {
+	analyze(events, definition) {
+		const windowMs = (definition.windowHours ?? 72) * 60 * 60 * 1e3;
+		const eventsByUser = groupByUser(events);
+		const stepCounts = definition.steps.map(() => 0);
+		for (const userEvents of eventsByUser.values()) this.evaluateUser(userEvents, definition.steps, windowMs).forEach((hit, stepIdx) => {
+			if (hit) stepCounts[stepIdx] = (stepCounts[stepIdx] ?? 0) + 1;
+		});
+		const totalUsers = eventsByUser.size;
+		return {
+			definition,
+			totalUsers,
+			steps: definition.steps.map((step, index) => {
+				const prevCount = index === 0 ? totalUsers : stepCounts[index - 1] || 1;
+				const count = stepCounts[index] ?? 0;
+				const conversionRate = prevCount === 0 ? 0 : Number((count / prevCount).toFixed(3));
+				return {
+					step,
+					count,
+					conversionRate,
+					dropOffRate: Number((1 - conversionRate).toFixed(3))
+				};
+			})
+		};
+	}
+	evaluateUser(events, steps, windowMs) {
+		const sorted = [...events].sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+		const completion = Array(steps.length).fill(false);
+		let cursor = 0;
+		let anchorTime;
+		for (const event of sorted) {
+			const step = steps[cursor];
+			if (!step) break;
+			if (event.name !== step.eventName) continue;
+			if (step.match && !step.match(event)) continue;
+			const eventTime = new Date(event.timestamp).getTime();
+			if (cursor === 0) {
+				anchorTime = eventTime;
+				completion[cursor] = true;
+				cursor += 1;
+				continue;
+			}
+			if (anchorTime && eventTime - anchorTime <= windowMs) {
+				completion[cursor] = true;
+				cursor += 1;
+			}
+		}
+		return completion;
+	}
+};
+function groupByUser(events) {
+	const map = /* @__PURE__ */ new Map();
+	for (const event of events) {
+		const list = map.get(event.userId) ?? [];
+		list.push(event);
+		map.set(event.userId, list);
+	}
+	return map;
+}
+
+//#endregion
+export { FunnelAnalyzer };
+//# sourceMappingURL=analyzer.js.map

package/dist/libs/analytics/dist/funnel/analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.js","names":[],"sources":["../../../../../../../libs/analytics/dist/funnel/analyzer.js"],"sourcesContent":["//#region src/funnel/analyzer.ts\nvar FunnelAnalyzer = class {\n\tanalyze(events, definition) {\n\t\tconst windowMs = (definition.windowHours ?? 72) * 60 * 60 * 1e3;\n\t\tconst eventsByUser = groupByUser(events);\n\t\tconst stepCounts = definition.steps.map(() => 0);\n\t\tfor (const userEvents of eventsByUser.values()) this.evaluateUser(userEvents, definition.steps, windowMs).forEach((hit, stepIdx) => {\n\t\t\tif (hit) stepCounts[stepIdx] = (stepCounts[stepIdx] ?? 0) + 1;\n\t\t});\n\t\tconst totalUsers = eventsByUser.size;\n\t\treturn {\n\t\t\tdefinition,\n\t\t\ttotalUsers,\n\t\t\tsteps: definition.steps.map((step, index) => {\n\t\t\t\tconst prevCount = index === 0 ? totalUsers : stepCounts[index - 1] || 1;\n\t\t\t\tconst count = stepCounts[index] ?? 0;\n\t\t\t\tconst conversionRate = prevCount === 0 ? 0 : Number((count / prevCount).toFixed(3));\n\t\t\t\treturn {\n\t\t\t\t\tstep,\n\t\t\t\t\tcount,\n\t\t\t\t\tconversionRate,\n\t\t\t\t\tdropOffRate: Number((1 - conversionRate).toFixed(3))\n\t\t\t\t};\n\t\t\t})\n\t\t};\n\t}\n\tevaluateUser(events, steps, windowMs) {\n\t\tconst sorted = [...events].sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());\n\t\tconst completion = Array(steps.length).fill(false);\n\t\tlet cursor = 0;\n\t\tlet anchorTime;\n\t\tfor (const event of sorted) {\n\t\t\tconst step = steps[cursor];\n\t\t\tif (!step) break;\n\t\t\tif (event.name !== step.eventName) continue;\n\t\t\tif (step.match && !step.match(event)) continue;\n\t\t\tconst eventTime = new Date(event.timestamp).getTime();\n\t\t\tif (cursor === 0) {\n\t\t\t\tanchorTime = eventTime;\n\t\t\t\tcompletion[cursor] = true;\n\t\t\t\tcursor += 1;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (anchorTime && eventTime - anchorTime <= windowMs) {\n\t\t\t\tcompletion[cursor] = true;\n\t\t\t\tcursor += 1;\n\t\t\t}\n\t\t}\n\t\treturn completion;\n\t}\n};\nfunction groupByUser(events) {\n\tconst map = /* @__PURE__ */ new Map();\n\tfor (const event of events) {\n\t\tconst list = map.get(event.userId) ?? [];\n\t\tlist.push(event);\n\t\tmap.set(event.userId, list);\n\t}\n\treturn map;\n}\n\n//#endregion\nexport { FunnelAnalyzer };\n//# sourceMappingURL=analyzer.js.map"],"mappings":";AACA,IAAI,iBAAiB,MAAM;CAC1B,QAAQ,QAAQ,YAAY;EAC3B,MAAM,YAAY,WAAW,eAAe,MAAM,KAAK,KAAK;EAC5D,MAAM,eAAe,YAAY,OAAO;EACxC,MAAM,aAAa,WAAW,MAAM,UAAU,EAAE;AAChD,OAAK,MAAM,cAAc,aAAa,QAAQ,CAAE,MAAK,aAAa,YAAY,WAAW,OAAO,SAAS,CAAC,SAAS,KAAK,YAAY;AACnI,OAAI,IAAK,YAAW,YAAY,WAAW,YAAY,KAAK;IAC3D;EACF,MAAM,aAAa,aAAa;AAChC,SAAO;GACN;GACA;GACA,OAAO,WAAW,MAAM,KAAK,MAAM,UAAU;IAC5C,MAAM,YAAY,UAAU,IAAI,aAAa,WAAW,QAAQ,MAAM;IACtE,MAAM,QAAQ,WAAW,UAAU;IACnC,MAAM,iBAAiB,cAAc,IAAI,IAAI,QAAQ,QAAQ,WAAW,QAAQ,EAAE,CAAC;AACnF,WAAO;KACN;KACA;KACA;KACA,aAAa,QAAQ,IAAI,gBAAgB,QAAQ,EAAE,CAAC;KACpD;KACA;GACF;;CAEF,aAAa,QAAQ,OAAO,UAAU;EACrC,MAAM,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,IAAI,KAAK,EAAE,UAAU,CAAC,SAAS,GAAG,IAAI,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC;EAC5G,MAAM,aAAa,MAAM,MAAM,OAAO,CAAC,KAAK,MAAM;EAClD,IAAI,SAAS;EACb,IAAI;AACJ,OAAK,MAAM,SAAS,QAAQ;GAC3B,MAAM,OAAO,MAAM;AACnB,OAAI,CAAC,KAAM;AACX,OAAI,MAAM,SAAS,KAAK,UAAW;AACnC,OAAI,KAAK,SAAS,CAAC,KAAK,MAAM,MAAM,CAAE;GACtC,MAAM,YAAY,IAAI,KAAK,MAAM,UAAU,CAAC,SAAS;AACrD,OAAI,WAAW,GAAG;AACjB,iBAAa;AACb,eAAW,UAAU;AACrB,cAAU;AACV;;AAED,OAAI,cAAc,YAAY,cAAc,UAAU;AACrD,eAAW,UAAU;AACrB,cAAU;;;AAGZ,SAAO;;;AAGT,SAAS,YAAY,QAAQ;CAC5B,MAAM,sBAAsB,IAAI,KAAK;AACrC,MAAK,MAAM,SAAS,QAAQ;EAC3B,MAAM,OAAO,IAAI,IAAI,MAAM,OAAO,IAAI,EAAE;AACxC,OAAK,KAAK,MAAM;AAChB,MAAI,IAAI,MAAM,QAAQ,KAAK;;AAE5B,QAAO"}

package/dist/libs/analytics/dist/types.d.ts

@@ -0,0 +1,22 @@
+//#region ../../libs/analytics/dist/types.d.ts
+//#region src/types.d.ts
+interface AnalyticsEvent {
+  name: string;
+  userId: string;
+  tenantId?: string;
+  timestamp: string | Date;
+  properties?: Record<string, unknown>;
+}
+interface FunnelStep {
+  id: string;
+  eventName: string;
+  match?: (event: AnalyticsEvent) => boolean;
+}
+interface FunnelDefinition {
+  name: string;
+  steps: FunnelStep[];
+  windowHours?: number;
+}
+//#endregion
+export { FunnelDefinition };
+//# sourceMappingURL=types.d.ts.map

package/dist/libs/analytics/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":["AnalyticsEvent","Date","Record","name","userId","tenantId","timestamp","properties","FunnelStep","id","eventName","match","event","FunnelDefinition","steps","windowHours","FunnelStepResult","step","count","conversionRate","dropOffRate","FunnelAnalysis","definition","totalUsers","CohortEvent","amount","CohortDefinition","bucket","periods","startDate","CohortStats","cohortKey","users","retention","ltv","CohortAnalysis","cohorts","ChurnSignal","score","drivers","GrowthMetric","current","previous","target","GrowthHypothesis","statement","metric","confidence","impact"],"sources":["../../../../../../libs/analytics/dist/types.d.ts"],"mappings":";;UACUA,cAAAA;EACRG,IAAAA;EACAC,MAAAA;EACAC,QAAAA;EACAC,SAAAA,WAAoBL,IAAAA;EACpBM,UAAAA,GAAaL,MAAAA;AAAAA;AAAAA,UAELM,UAAAA;EACRC,EAAAA;EACAC,SAAAA;EACAC,KAAAA,IAASC,KAAAA,EAAOZ,cAAAA;AAAAA;AAAAA,UAERa,gBAAAA;EACRV,IAAAA;EACAW,KAAAA,EAAON,UAAAA;EACPO,WAAAA;AAAAA"}

package/dist/load-evidence.d.ts

@@ -1,3 +1,4 @@
+import { PosthogEvidenceOptions } from "./posthog-signals.js";
 import { EvidenceChunk } from "@contractspec/lib.contracts/product-intent/types";
 
 //#region src/load-evidence.d.ts
@@ -9,11 +10,15 @@ interface EvidenceLoadOptions {
   transcriptDirs?: string[];
   chunkSize?: number;
 }
+interface EvidenceLoadWithSignalsOptions extends EvidenceLoadOptions {
+  posthog?: PosthogEvidenceOptions;
+}
 /**
  * Load all transcript files under the given directories and return
  * EvidenceChunk objects ready for prompt formatting.
  */
 declare function loadEvidenceChunks(options?: EvidenceLoadOptions): EvidenceChunk[];
+declare function loadEvidenceChunksWithSignals(options?: EvidenceLoadWithSignalsOptions): Promise<EvidenceChunk[]>;
 //#endregion
-export { DEFAULT_CHUNK_SIZE, DEFAULT_EVIDENCE_ROOT, DEFAULT_TRANSCRIPT_DIRS, EvidenceLoadOptions, loadEvidenceChunks };
+export { DEFAULT_CHUNK_SIZE, DEFAULT_EVIDENCE_ROOT, DEFAULT_TRANSCRIPT_DIRS, EvidenceLoadOptions, EvidenceLoadWithSignalsOptions, loadEvidenceChunks, loadEvidenceChunksWithSignals };
 //# sourceMappingURL=load-evidence.d.ts.map

package/dist/load-evidence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-evidence.d.ts","names":[],"sources":["../src/load-evidence.ts"],"mappings":";;;cAOa,qBAAA;AAAA,cACA,uBAAA;AAAA,cACA,kBAAA;AAAA,UAEI,mBAAA;EACf,YAAA;EACA,cAAA;EACA,SAAA;AAAA;;;;;iBAyCc,kBAAA,CACd,OAAA,GAAS,mBAAA,GACR,aAAA"}
+{"version":3,"file":"load-evidence.d.ts","names":[],"sources":["../src/load-evidence.ts"],"mappings":";;;;cASa,qBAAA;AAAA,cACA,uBAAA;AAAA,cACA,kBAAA;AAAA,UAEI,mBAAA;EACf,YAAA;EACA,cAAA;EACA,SAAA;AAAA;AAAA,UAGe,8BAAA,SAAuC,mBAAA;EACtD,OAAA,GAAU,sBAAA;AAAA;;AATZ;;;iBAkDgB,kBAAA,CACd,OAAA,GAAS,mBAAA,GACR,aAAA;AAAA,iBAuBmB,6BAAA,CACpB,OAAA,GAAS,8BAAA,GACR,OAAA,CAAQ,aAAA"}

package/dist/load-evidence.js

@@ -1,3 +1,4 @@
+import { loadPosthogEvidenceChunks } from "./posthog-signals.js";
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -62,7 +63,13 @@ function loadEvidenceChunks(options = {}) {
 	}
 	return chunks;
 }
+async function loadEvidenceChunksWithSignals(options = {}) {
+	const baseChunks = loadEvidenceChunks(options);
+	if (!options.posthog) return baseChunks;
+	const posthogChunks = await loadPosthogEvidenceChunks(options.posthog);
+	return [...baseChunks, ...posthogChunks];
+}
 
 //#endregion
-export { DEFAULT_CHUNK_SIZE, DEFAULT_EVIDENCE_ROOT, DEFAULT_TRANSCRIPT_DIRS, loadEvidenceChunks };
+export { DEFAULT_CHUNK_SIZE, DEFAULT_EVIDENCE_ROOT, DEFAULT_TRANSCRIPT_DIRS, loadEvidenceChunks, loadEvidenceChunksWithSignals };
 //# sourceMappingURL=load-evidence.js.map

package/dist/load-evidence.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-evidence.js","names":[],"sources":["../src/load-evidence.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { EvidenceChunk } from '@contractspec/lib.contracts/product-intent/types';\n\nconst MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));\n\nexport const DEFAULT_EVIDENCE_ROOT = path.join(MODULE_DIR, '../evidence');\nexport const DEFAULT_TRANSCRIPT_DIRS = ['interviews', 'tickets', 'public'];\nexport const DEFAULT_CHUNK_SIZE = 800;\n\nexport interface EvidenceLoadOptions {\n  evidenceRoot?: string;\n  transcriptDirs?: string[];\n  chunkSize?: number;\n}\n\n/**\n * Remove YAML front matter from a file. Synthetic interview and ticket\n * files include a YAML header delimited by triple dashes.\n */\nfunction stripYamlFrontMatter(contents: string): string {\n  const start = contents.indexOf('---');\n  if (start === -1) return contents;\n  const end = contents.indexOf('---', start + 3);\n  if (end === -1) return contents;\n  return contents.slice(end + 3).trimStart();\n}\n\n/**\n * Split a transcript into fixed-size chunks.\n */\nfunction chunkTranscript(\n  fileId: string,\n  text: string,\n  chunkSize: number\n): EvidenceChunk[] {\n  const chunks: EvidenceChunk[] = [];\n  const clean = text.trim();\n  for (let offset = 0, idx = 0; offset < clean.length; idx += 1) {\n    const slice = clean.slice(offset, offset + chunkSize);\n    chunks.push({\n      chunkId: `${fileId}#c_${String(idx).padStart(2, '0')}`,\n      text: slice,\n      meta: { source: fileId },\n    });\n    offset += chunkSize;\n  }\n  return chunks;\n}\n\n/**\n * Load all transcript files under the given directories and return\n * EvidenceChunk objects ready for prompt formatting.\n */\nexport function loadEvidenceChunks(\n  options: EvidenceLoadOptions = {}\n): EvidenceChunk[] {\n  const evidenceRoot = options.evidenceRoot ?? DEFAULT_EVIDENCE_ROOT;\n  const transcriptDirs = options.transcriptDirs ?? DEFAULT_TRANSCRIPT_DIRS;\n  const chunkSize = options.chunkSize ?? DEFAULT_CHUNK_SIZE;\n\n  const chunks: EvidenceChunk[] = [];\n  for (const dir of transcriptDirs) {\n    const fullDir = path.join(evidenceRoot, dir);\n    if (!fs.existsSync(fullDir)) continue;\n    for (const fileName of fs.readdirSync(fullDir)) {\n      const ext = path.extname(fileName).toLowerCase();\n      if (ext !== '.md') continue;\n      const filePath = path.join(fullDir, fileName);\n      const raw = fs.readFileSync(filePath, 'utf8');\n      const withoutFrontMatter = stripYamlFrontMatter(raw);\n      const baseId = path.parse(fileName).name;\n      const fileChunks = chunkTranscript(baseId, withoutFrontMatter, chunkSize);\n      chunks.push(...fileChunks);\n    }\n  }\n  return chunks;\n}\n"],"mappings":";;;;;AAKA,MAAM,aAAa,KAAK,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAE/D,MAAa,wBAAwB,KAAK,KAAK,YAAY,cAAc;AACzE,MAAa,0BAA0B;CAAC;CAAc;CAAW;CAAS;AAC1E,MAAa,qBAAqB;;;;;AAYlC,SAAS,qBAAqB,UAA0B;CACtD,MAAM,QAAQ,SAAS,QAAQ,MAAM;AACrC,KAAI,UAAU,GAAI,QAAO;CACzB,MAAM,MAAM,SAAS,QAAQ,OAAO,QAAQ,EAAE;AAC9C,KAAI,QAAQ,GAAI,QAAO;AACvB,QAAO,SAAS,MAAM,MAAM,EAAE,CAAC,WAAW;;;;;AAM5C,SAAS,gBACP,QACA,MACA,WACiB;CACjB,MAAM,SAA0B,EAAE;CAClC,MAAM,QAAQ,KAAK,MAAM;AACzB,MAAK,IAAI,SAAS,GAAG,MAAM,GAAG,SAAS,MAAM,QAAQ,OAAO,GAAG;EAC7D,MAAM,QAAQ,MAAM,MAAM,QAAQ,SAAS,UAAU;AACrD,SAAO,KAAK;GACV,SAAS,GAAG,OAAO,KAAK,OAAO,IAAI,CAAC,SAAS,GAAG,IAAI;GACpD,MAAM;GACN,MAAM,EAAE,QAAQ,QAAQ;GACzB,CAAC;AACF,YAAU;;AAEZ,QAAO;;;;;;AAOT,SAAgB,mBACd,UAA+B,EAAE,EAChB;CACjB,MAAM,eAAe,QAAQ,gBAAgB;CAC7C,MAAM,iBAAiB,QAAQ,kBAAkB;CACjD,MAAM,YAAY,QAAQ,aAAa;CAEvC,MAAM,SAA0B,EAAE;AAClC,MAAK,MAAM,OAAO,gBAAgB;EAChC,MAAM,UAAU,KAAK,KAAK,cAAc,IAAI;AAC5C,MAAI,CAAC,GAAG,WAAW,QAAQ,CAAE;AAC7B,OAAK,MAAM,YAAY,GAAG,YAAY,QAAQ,EAAE;AAE9C,OADY,KAAK,QAAQ,SAAS,CAAC,aAAa,KACpC,MAAO;GACnB,MAAM,WAAW,KAAK,KAAK,SAAS,SAAS;GAE7C,MAAM,qBAAqB,qBADf,GAAG,aAAa,UAAU,OAAO,CACO;GACpD,MAAM,SAAS,KAAK,MAAM,SAAS,CAAC;GACpC,MAAM,aAAa,gBAAgB,QAAQ,oBAAoB,UAAU;AACzE,UAAO,KAAK,GAAG,WAAW;;;AAG9B,QAAO"}
+{"version":3,"file":"load-evidence.js","names":[],"sources":["../src/load-evidence.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { EvidenceChunk } from '@contractspec/lib.contracts/product-intent/types';\nimport type { PosthogEvidenceOptions } from './posthog-signals';\nimport { loadPosthogEvidenceChunks } from './posthog-signals';\n\nconst MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));\n\nexport const DEFAULT_EVIDENCE_ROOT = path.join(MODULE_DIR, '../evidence');\nexport const DEFAULT_TRANSCRIPT_DIRS = ['interviews', 'tickets', 'public'];\nexport const DEFAULT_CHUNK_SIZE = 800;\n\nexport interface EvidenceLoadOptions {\n  evidenceRoot?: string;\n  transcriptDirs?: string[];\n  chunkSize?: number;\n}\n\nexport interface EvidenceLoadWithSignalsOptions extends EvidenceLoadOptions {\n  posthog?: PosthogEvidenceOptions;\n}\n\n/**\n * Remove YAML front matter from a file. Synthetic interview and ticket\n * files include a YAML header delimited by triple dashes.\n */\nfunction stripYamlFrontMatter(contents: string): string {\n  const start = contents.indexOf('---');\n  if (start === -1) return contents;\n  const end = contents.indexOf('---', start + 3);\n  if (end === -1) return contents;\n  return contents.slice(end + 3).trimStart();\n}\n\n/**\n * Split a transcript into fixed-size chunks.\n */\nfunction chunkTranscript(\n  fileId: string,\n  text: string,\n  chunkSize: number\n): EvidenceChunk[] {\n  const chunks: EvidenceChunk[] = [];\n  const clean = text.trim();\n  for (let offset = 0, idx = 0; offset < clean.length; idx += 1) {\n    const slice = clean.slice(offset, offset + chunkSize);\n    chunks.push({\n      chunkId: `${fileId}#c_${String(idx).padStart(2, '0')}`,\n      text: slice,\n      meta: { source: fileId },\n    });\n    offset += chunkSize;\n  }\n  return chunks;\n}\n\n/**\n * Load all transcript files under the given directories and return\n * EvidenceChunk objects ready for prompt formatting.\n */\nexport function loadEvidenceChunks(\n  options: EvidenceLoadOptions = {}\n): EvidenceChunk[] {\n  const evidenceRoot = options.evidenceRoot ?? DEFAULT_EVIDENCE_ROOT;\n  const transcriptDirs = options.transcriptDirs ?? DEFAULT_TRANSCRIPT_DIRS;\n  const chunkSize = options.chunkSize ?? DEFAULT_CHUNK_SIZE;\n\n  const chunks: EvidenceChunk[] = [];\n  for (const dir of transcriptDirs) {\n    const fullDir = path.join(evidenceRoot, dir);\n    if (!fs.existsSync(fullDir)) continue;\n    for (const fileName of fs.readdirSync(fullDir)) {\n      const ext = path.extname(fileName).toLowerCase();\n      if (ext !== '.md') continue;\n      const filePath = path.join(fullDir, fileName);\n      const raw = fs.readFileSync(filePath, 'utf8');\n      const withoutFrontMatter = stripYamlFrontMatter(raw);\n      const baseId = path.parse(fileName).name;\n      const fileChunks = chunkTranscript(baseId, withoutFrontMatter, chunkSize);\n      chunks.push(...fileChunks);\n    }\n  }\n  return chunks;\n}\n\nexport async function loadEvidenceChunksWithSignals(\n  options: EvidenceLoadWithSignalsOptions = {}\n): Promise<EvidenceChunk[]> {\n  const baseChunks = loadEvidenceChunks(options);\n  if (!options.posthog) return baseChunks;\n  const posthogChunks = await loadPosthogEvidenceChunks(options.posthog);\n  return [...baseChunks, ...posthogChunks];\n}\n"],"mappings":";;;;;;AAOA,MAAM,aAAa,KAAK,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAE/D,MAAa,wBAAwB,KAAK,KAAK,YAAY,cAAc;AACzE,MAAa,0BAA0B;CAAC;CAAc;CAAW;CAAS;AAC1E,MAAa,qBAAqB;;;;;AAgBlC,SAAS,qBAAqB,UAA0B;CACtD,MAAM,QAAQ,SAAS,QAAQ,MAAM;AACrC,KAAI,UAAU,GAAI,QAAO;CACzB,MAAM,MAAM,SAAS,QAAQ,OAAO,QAAQ,EAAE;AAC9C,KAAI,QAAQ,GAAI,QAAO;AACvB,QAAO,SAAS,MAAM,MAAM,EAAE,CAAC,WAAW;;;;;AAM5C,SAAS,gBACP,QACA,MACA,WACiB;CACjB,MAAM,SAA0B,EAAE;CAClC,MAAM,QAAQ,KAAK,MAAM;AACzB,MAAK,IAAI,SAAS,GAAG,MAAM,GAAG,SAAS,MAAM,QAAQ,OAAO,GAAG;EAC7D,MAAM,QAAQ,MAAM,MAAM,QAAQ,SAAS,UAAU;AACrD,SAAO,KAAK;GACV,SAAS,GAAG,OAAO,KAAK,OAAO,IAAI,CAAC,SAAS,GAAG,IAAI;GACpD,MAAM;GACN,MAAM,EAAE,QAAQ,QAAQ;GACzB,CAAC;AACF,YAAU;;AAEZ,QAAO;;;;;;AAOT,SAAgB,mBACd,UAA+B,EAAE,EAChB;CACjB,MAAM,eAAe,QAAQ,gBAAgB;CAC7C,MAAM,iBAAiB,QAAQ,kBAAkB;CACjD,MAAM,YAAY,QAAQ,aAAa;CAEvC,MAAM,SAA0B,EAAE;AAClC,MAAK,MAAM,OAAO,gBAAgB;EAChC,MAAM,UAAU,KAAK,KAAK,cAAc,IAAI;AAC5C,MAAI,CAAC,GAAG,WAAW,QAAQ,CAAE;AAC7B,OAAK,MAAM,YAAY,GAAG,YAAY,QAAQ,EAAE;AAE9C,OADY,KAAK,QAAQ,SAAS,CAAC,aAAa,KACpC,MAAO;GACnB,MAAM,WAAW,KAAK,KAAK,SAAS,SAAS;GAE7C,MAAM,qBAAqB,qBADf,GAAG,aAAa,UAAU,OAAO,CACO;GACpD,MAAM,SAAS,KAAK,MAAM,SAAS,CAAC;GACpC,MAAM,aAAa,gBAAgB,QAAQ,oBAAoB,UAAU;AACzE,UAAO,KAAK,GAAG,WAAW;;;AAG9B,QAAO;;AAGT,eAAsB,8BACpB,UAA0C,EAAE,EAClB;CAC1B,MAAM,aAAa,mBAAmB,QAAQ;AAC9C,KAAI,CAAC,QAAQ,QAAS,QAAO;CAC7B,MAAM,gBAAgB,MAAM,0BAA0B,QAAQ,QAAQ;AACtE,QAAO,CAAC,GAAG,YAAY,GAAG,cAAc"}

package/dist/posthog-signals.d.ts

@@ -0,0 +1,22 @@
+import { FunnelDefinition } from "./libs/analytics/dist/types.js";
+import { EvidenceChunk } from "@contractspec/lib.contracts/product-intent/types";
+import { AnalyticsReader, DateRangeInput } from "@contractspec/lib.contracts/integrations/providers/analytics";
+
+//#region src/posthog-signals.d.ts
+interface PosthogEvidenceOptions {
+  reader: AnalyticsReader;
+  dateRange?: DateRangeInput;
+  eventNames?: string[];
+  limit?: number;
+  funnel?: FunnelDefinition;
+  includeFeatureFlags?: boolean;
+}
+interface PosthogEvidenceEnvOptions {
+  defaultLookbackDays?: number;
+  defaultLimit?: number;
+}
+declare function loadPosthogEvidenceChunks(options: PosthogEvidenceOptions): Promise<EvidenceChunk[]>;
+declare function resolvePosthogEvidenceOptionsFromEnv(options?: PosthogEvidenceEnvOptions): PosthogEvidenceOptions | null;
+//#endregion
+export { PosthogEvidenceEnvOptions, PosthogEvidenceOptions, loadPosthogEvidenceChunks, resolvePosthogEvidenceOptionsFromEnv };
+//# sourceMappingURL=posthog-signals.d.ts.map

package/dist/posthog-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog-signals.d.ts","names":[],"sources":["../src/posthog-signals.ts"],"mappings":";;;;;UAaiB,sBAAA;EACf,MAAA,EAAQ,eAAA;EACR,SAAA,GAAY,cAAA;EACZ,UAAA;EACA,KAAA;EACA,MAAA,GAAS,gBAAA;EACT,mBAAA;AAAA;AAAA,UAGe,yBAAA;EACf,mBAAA;EACA,YAAA;AAAA;AAAA,iBAGoB,yBAAA,CACpB,OAAA,EAAS,sBAAA,GACR,OAAA,CAAQ,aAAA;AAAA,iBAwNK,oCAAA,CACd,OAAA,GAAS,yBAAA,GACR,sBAAA"}

package/dist/posthog-signals.js

@@ -0,0 +1,205 @@
+import { FunnelAnalyzer } from "./libs/analytics/dist/funnel/analyzer.js";
+import { PosthogAnalyticsProvider } from "@contractspec/integration.providers-impls/impls/posthog";
+
+//#region src/posthog-signals.ts
+async function loadPosthogEvidenceChunks(options) {
+	const chunks = [];
+	const range = resolveRange(options.dateRange);
+	const eventSummary = await loadEventSummary(options, range);
+	if (eventSummary) chunks.push(eventSummary);
+	const funnelEvidence = await loadFunnelEvidence(options, range);
+	if (funnelEvidence) chunks.push(funnelEvidence);
+	const featureFlags = await loadFeatureFlagEvidence(options);
+	if (featureFlags) chunks.push(featureFlags);
+	return chunks;
+}
+async function loadEventSummary(options, range) {
+	if (!options.reader.queryHogQL) return null;
+	const eventFilter = buildEventFilter(options.eventNames);
+	const limit = options.limit ?? 10;
+	const rows = mapRows(await options.reader.queryHogQL({
+		query: [
+			"select",
+			"  event as eventName,",
+			"  count() as total",
+			"from events",
+			"where timestamp >= {dateFrom} and timestamp < {dateTo}",
+			eventFilter.clause ? `and ${eventFilter.clause}` : "",
+			"group by eventName",
+			"order by total desc",
+			`limit ${limit}`
+		].filter(Boolean).join("\n"),
+		values: {
+			dateFrom: range.from.toISOString(),
+			dateTo: range.to.toISOString(),
+			...eventFilter.values
+		}
+	}));
+	if (rows.length === 0) return null;
+	const lines = rows.map((row) => {
+		return `- ${asString(row.eventName) ?? "unknown"}: ${asNumber(row.total)}`;
+	});
+	return {
+		chunkId: `posthog:event_summary:${range.from.toISOString()}`,
+		text: [`PostHog event summary (${range.from.toISOString()} → ${range.to.toISOString()}):`, ...lines].join("\n"),
+		meta: {
+			source: "posthog",
+			kind: "event_summary",
+			dateFrom: range.from.toISOString(),
+			dateTo: range.to.toISOString()
+		}
+	};
+}
+async function loadFunnelEvidence(options, range) {
+	if (!options.funnel) return null;
+	if (!options.reader.getEvents) return null;
+	const events = [];
+	const eventNames = options.funnel.steps.map((step) => step.eventName);
+	for (const eventName of eventNames) (await options.reader.getEvents({
+		event: eventName,
+		dateRange: {
+			from: range.from,
+			to: range.to
+		},
+		limit: options.limit ?? 500
+	})).results.forEach((event) => {
+		events.push({
+			name: event.event,
+			userId: event.distinctId,
+			tenantId: typeof event.properties?.tenantId === "string" ? event.properties.tenantId : void 0,
+			timestamp: event.timestamp,
+			properties: event.properties
+		});
+	});
+	if (events.length === 0) return null;
+	const lines = new FunnelAnalyzer().analyze(events, options.funnel).steps.map((step) => {
+		return `- ${step.step.eventName}: ${step.count} (conversion ${step.conversionRate}, drop-off ${step.dropOffRate})`;
+	});
+	return {
+		chunkId: `posthog:funnel:${options.funnel.name}`,
+		text: [`PostHog funnel analysis — ${options.funnel.name}:`, ...lines].join("\n"),
+		meta: {
+			source: "posthog",
+			kind: "funnel",
+			funnelName: options.funnel.name,
+			dateFrom: range.from.toISOString(),
+			dateTo: range.to.toISOString()
+		}
+	};
+}
+async function loadFeatureFlagEvidence(options) {
+	if (!options.includeFeatureFlags) return null;
+	if (!options.reader.getFeatureFlags) return null;
+	const response = await options.reader.getFeatureFlags({ limit: 10 });
+	if (!response.results.length) return null;
+	return {
+		chunkId: "posthog:feature_flags",
+		text: ["PostHog feature flags:", ...response.results.map((flag) => {
+			return `- ${flag.key ?? "unknown"}: ${flag.active ? "active" : "inactive"}`;
+		})].join("\n"),
+		meta: {
+			source: "posthog",
+			kind: "feature_flags"
+		}
+	};
+}
+function resolveRange(dateRange) {
+	const now = /* @__PURE__ */ new Date();
+	return {
+		from: dateRange?.from instanceof Date ? dateRange.from : dateRange?.from ? new Date(dateRange.from) : /* @__PURE__ */ new Date(now.getTime() - 720 * 60 * 60 * 1e3),
+		to: dateRange?.to instanceof Date ? dateRange.to : dateRange?.to ? new Date(dateRange.to) : now
+	};
+}
+function buildEventFilter(eventNames) {
+	if (!eventNames || eventNames.length === 0) return {};
+	if (eventNames.length === 1) return {
+		clause: "event = {event0}",
+		values: { event0: eventNames[0] }
+	};
+	const values = {};
+	return {
+		clause: `(${eventNames.map((eventName, index) => {
+			values[`event${index}`] = eventName;
+			return `event = {event${index}}`;
+		}).join(" or ")})`,
+		values
+	};
+}
+function mapRows(result) {
+	if (!Array.isArray(result.results) || !Array.isArray(result.columns)) return [];
+	const columns = result.columns;
+	return result.results.flatMap((row) => {
+		if (!Array.isArray(row)) return [];
+		const record = {};
+		columns.forEach((column, index) => {
+			record[column] = row[index];
+		});
+		return [record];
+	});
+}
+function asString(value) {
+	if (typeof value === "string" && value.trim()) return value;
+	if (typeof value === "number") return String(value);
+	return null;
+}
+function asNumber(value) {
+	if (typeof value === "number" && Number.isFinite(value)) return value;
+	if (typeof value === "string" && value.trim()) {
+		const parsed = Number(value);
+		if (Number.isFinite(parsed)) return parsed;
+	}
+	return 0;
+}
+function resolvePosthogEvidenceOptionsFromEnv(options = {}) {
+	const projectId = process.env.POSTHOG_PROJECT_ID;
+	const personalApiKey = process.env.POSTHOG_PERSONAL_API_KEY;
+	if (!projectId || !personalApiKey) return null;
+	const lookbackDays = resolveNumberEnv("POSTHOG_EVIDENCE_LOOKBACK_DAYS", options.defaultLookbackDays ?? 30);
+	const limit = resolveNumberEnv("POSTHOG_EVIDENCE_LIMIT", options.defaultLimit ?? 10);
+	const now = /* @__PURE__ */ new Date();
+	const from = /* @__PURE__ */ new Date(now.getTime() - lookbackDays * 24 * 60 * 60 * 1e3);
+	const eventNames = resolveCsvEnv("POSTHOG_EVIDENCE_EVENTS");
+	const funnelSteps = resolveCsvEnv("POSTHOG_EVIDENCE_FUNNEL_STEPS");
+	const funnel = funnelSteps && funnelSteps.length ? {
+		name: "posthog-evidence-funnel",
+		steps: funnelSteps.map((eventName, index) => ({
+			id: `step_${index + 1}`,
+			eventName
+		}))
+	} : void 0;
+	return {
+		reader: new PosthogAnalyticsProvider({
+			host: process.env.POSTHOG_HOST,
+			projectId,
+			personalApiKey
+		}),
+		dateRange: {
+			from,
+			to: now
+		},
+		eventNames,
+		limit,
+		funnel,
+		includeFeatureFlags: resolveBooleanEnv("POSTHOG_EVIDENCE_FEATURE_FLAGS", true)
+	};
+}
+function resolveCsvEnv(key) {
+	const value = process.env[key];
+	if (!value) return void 0;
+	return value.split(",").map((item) => item.trim()).filter(Boolean);
+}
+function resolveNumberEnv(key, fallback) {
+	const value = process.env[key];
+	if (!value) return fallback;
+	const parsed = Number(value);
+	return Number.isFinite(parsed) ? parsed : fallback;
+}
+function resolveBooleanEnv(key, fallback) {
+	const value = process.env[key];
+	if (value === void 0) return fallback;
+	return value.toLowerCase() === "true";
+}
+
+//#endregion
+export { loadPosthogEvidenceChunks, resolvePosthogEvidenceOptionsFromEnv };
+//# sourceMappingURL=posthog-signals.js.map