@contractspec/example.product-intent 3.7.17 → 3.7.18

package/dist/node/load-evidence.js

@@ -1,313 +1,5 @@
-// src/posthog-signals.ts
-import { PosthogAnalyticsProvider } from "@contractspec/integration.providers-impls/impls/posthog";
-import { FunnelAnalyzer } from "@contractspec/lib.analytics/funnel";
-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 result = 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(`
-`),
-    values: {
-      dateFrom: range.from.toISOString(),
-      dateTo: range.to.toISOString(),
-      ...eventFilter.values
-    }
-  });
-  const rows = mapRows(result);
-  if (rows.length === 0)
-    return null;
-  const lines = rows.map((row) => {
-    const name = asString(row.eventName) ?? "unknown";
-    const total = asNumber(row.total);
-    return `- ${name}: ${total}`;
-  });
-  return {
-    chunkId: `posthog:event_summary:${range.from.toISOString()}`,
-    text: [
-      `PostHog event summary (${range.from.toISOString()} → ${range.to.toISOString()}):`,
-      ...lines
-    ].join(`
-`),
-    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) {
-    const response = await options.reader.getEvents({
-      event: eventName,
-      dateRange: {
-        from: range.from,
-        to: range.to
-      },
-      limit: options.limit ?? 500
-    });
-    response.results.forEach((event) => {
-      events.push({
-        name: event.event,
-        userId: event.distinctId,
-        tenantId: typeof event.properties?.tenantId === "string" ? event.properties.tenantId : undefined,
-        timestamp: event.timestamp,
-        properties: event.properties
-      });
-    });
-  }
-  if (events.length === 0)
-    return null;
-  const analyzer = new FunnelAnalyzer;
-  const analysis = analyzer.analyze(events, options.funnel);
-  const lines = analysis.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(`
-`),
-    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;
-  const lines = response.results.map((flag) => {
-    const key = flag.key ?? "unknown";
-    const active = flag.active ? "active" : "inactive";
-    return `- ${key}: ${active}`;
-  });
-  return {
-    chunkId: "posthog:feature_flags",
-    text: ["PostHog feature flags:", ...lines].join(`
-`),
-    meta: {
-      source: "posthog",
-      kind: "feature_flags"
-    }
-  };
-}
-function resolveRange(dateRange) {
-  const now = new Date;
-  const from = dateRange?.from instanceof Date ? dateRange.from : dateRange?.from ? new Date(dateRange.from) : new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
-  const to = dateRange?.to instanceof Date ? dateRange.to : dateRange?.to ? new Date(dateRange.to) : now;
-  return { from, to };
-}
-function buildEventFilter(eventNames) {
-  if (!eventNames || eventNames.length === 0)
-    return {};
-  if (eventNames.length === 1) {
-    return {
-      clause: "event = {event0}",
-      values: { event0: eventNames[0] }
-    };
-  }
-  const values = {};
-  const clauses = eventNames.map((eventName, index) => {
-    values[`event${index}`] = eventName;
-    return `event = {event${index}}`;
-  });
-  return {
-    clause: `(${clauses.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 = new Date;
-  const from = new Date(now.getTime() - lookbackDays * 24 * 60 * 60 * 1000);
-  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
-    }))
-  } : undefined;
-  const reader = new PosthogAnalyticsProvider({
-    host: process.env.POSTHOG_HOST,
-    projectId,
-    personalApiKey
-  });
-  return {
-    reader,
-    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;
-  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 === undefined)
-    return fallback;
-  return value.toLowerCase() === "true";
-}
-
-// src/load-evidence.ts
-import fs from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-var MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
-var DEFAULT_EVIDENCE_ROOT = path.join(MODULE_DIR, "../evidence");
-var DEFAULT_TRANSCRIPT_DIRS = ["interviews", "tickets", "public"];
-var DEFAULT_CHUNK_SIZE = 800;
-function stripYamlFrontMatter(contents) {
-  const start = contents.indexOf("---");
-  if (start === -1)
-    return contents;
-  const end = contents.indexOf("---", start + 3);
-  if (end === -1)
-    return contents;
-  return contents.slice(end + 3).trimStart();
-}
-function chunkTranscript(fileId, text, chunkSize) {
-  const chunks = [];
-  const clean = text.trim();
-  for (let offset = 0, idx = 0;offset < clean.length; idx += 1) {
-    const slice = clean.slice(offset, offset + chunkSize);
-    chunks.push({
-      chunkId: `${fileId}#c_${String(idx).padStart(2, "0")}`,
-      text: slice,
-      meta: { source: fileId }
-    });
-    offset += chunkSize;
-  }
-  return chunks;
-}
-function loadEvidenceChunks(options = {}) {
-  const evidenceRoot = options.evidenceRoot ?? DEFAULT_EVIDENCE_ROOT;
-  const transcriptDirs = options.transcriptDirs ?? DEFAULT_TRANSCRIPT_DIRS;
-  const chunkSize = options.chunkSize ?? DEFAULT_CHUNK_SIZE;
-  const chunks = [];
-  for (const dir of transcriptDirs) {
-    const fullDir = path.join(evidenceRoot, dir);
-    if (!fs.existsSync(fullDir))
-      continue;
-    for (const fileName of fs.readdirSync(fullDir)) {
-      const ext = path.extname(fileName).toLowerCase();
-      if (ext !== ".md")
-        continue;
-      const filePath = path.join(fullDir, fileName);
-      const raw = fs.readFileSync(filePath, "utf8");
-      const withoutFrontMatter = stripYamlFrontMatter(raw);
-      const baseId = path.parse(fileName).name;
-      const fileChunks = chunkTranscript(baseId, withoutFrontMatter, chunkSize);
-      chunks.push(...fileChunks);
-    }
-  }
-  return chunks;
-}
-async function loadEvidenceChunksWithSignals(options = {}) {
-  const baseChunks = loadEvidenceChunks(options);
-  if (!options.posthog)
-    return baseChunks;
-  const posthogChunks = await loadPosthogEvidenceChunks(options.posthog);
-  return [...baseChunks, ...posthogChunks];
-}
-export {
-  loadEvidenceChunksWithSignals,
-  loadEvidenceChunks,
-  DEFAULT_TRANSCRIPT_DIRS,
-  DEFAULT_EVIDENCE_ROOT,
-  DEFAULT_CHUNK_SIZE
-};
+import{PosthogAnalyticsProvider as U}from"@contractspec/integration.providers-impls/impls/posthog";import{FunnelAnalyzer as _}from"@contractspec/lib.analytics/funnel";async function L(q){let G=[],J=C(q.dateRange),Q=await A(q,J);if(Q)G.push(Q);let W=await T(q,J);if(W)G.push(W);let X=await x(q);if(X)G.push(X);return G}async function A(q,G){if(!q.reader.queryHogQL)return null;let J=D(q.eventNames),Q=q.limit??10,W=await q.reader.queryHogQL({query:["select","  event as eventName,","  count() as total","from events","where timestamp >= {dateFrom} and timestamp < {dateTo}",J.clause?`and ${J.clause}`:"","group by eventName","order by total desc",`limit ${Q}`].filter(Boolean).join(`
+`),values:{dateFrom:G.from.toISOString(),dateTo:G.to.toISOString(),...J.values}}),X=I(W);if(X.length===0)return null;let B=X.map(($)=>{let V=F($.eventName)??"unknown",H=S($.total);return`- ${V}: ${H}`});return{chunkId:`posthog:event_summary:${G.from.toISOString()}`,text:[`PostHog event summary (${G.from.toISOString()} → ${G.to.toISOString()}):`,...B].join(`
+`),meta:{source:"posthog",kind:"event_summary",dateFrom:G.from.toISOString(),dateTo:G.to.toISOString()}}}async function T(q,G){if(!q.funnel)return null;if(!q.reader.getEvents)return null;let J=[],Q=q.funnel.steps.map(($)=>$.eventName);for(let $ of Q)(await q.reader.getEvents({event:$,dateRange:{from:G.from,to:G.to},limit:q.limit??500})).results.forEach((H)=>{J.push({name:H.event,userId:H.distinctId,tenantId:typeof H.properties?.tenantId==="string"?H.properties.tenantId:void 0,timestamp:H.timestamp,properties:H.properties})});if(J.length===0)return null;let B=new _().analyze(J,q.funnel).steps.map(($)=>{return`- ${$.step.eventName}: ${$.count} (conversion ${$.conversionRate}, drop-off ${$.dropOffRate})`});return{chunkId:`posthog:funnel:${q.funnel.name}`,text:[`PostHog funnel analysis — ${q.funnel.name}:`,...B].join(`
+`),meta:{source:"posthog",kind:"funnel",funnelName:q.funnel.name,dateFrom:G.from.toISOString(),dateTo:G.to.toISOString()}}}async function x(q){if(!q.includeFeatureFlags)return null;if(!q.reader.getFeatureFlags)return null;let G=await q.reader.getFeatureFlags({limit:10});if(!G.results.length)return null;return{chunkId:"posthog:feature_flags",text:["PostHog feature flags:",...G.results.map((Q)=>{let W=Q.key??"unknown",X=Q.active?"active":"inactive";return`- ${W}: ${X}`})].join(`
+`),meta:{source:"posthog",kind:"feature_flags"}}}function C(q){let G=new Date,J=q?.from instanceof Date?q.from:q?.from?new Date(q.from):new Date(G.getTime()-2592000000),Q=q?.to instanceof Date?q.to:q?.to?new Date(q.to):G;return{from:J,to:Q}}function D(q){if(!q||q.length===0)return{};if(q.length===1)return{clause:"event = {event0}",values:{event0:q[0]}};let G={};return{clause:`(${q.map((Q,W)=>{return G[`event${W}`]=Q,`event = {event${W}}`}).join(" or ")})`,values:G}}function I(q){if(!Array.isArray(q.results)||!Array.isArray(q.columns))return[];let G=q.columns;return q.results.flatMap((J)=>{if(!Array.isArray(J))return[];let Q={};return G.forEach((W,X)=>{Q[W]=J[X]}),[Q]})}function F(q){if(typeof q==="string"&&q.trim())return q;if(typeof q==="number")return String(q);return null}function S(q){if(typeof q==="number"&&Number.isFinite(q))return q;if(typeof q==="string"&&q.trim()){let G=Number(q);if(Number.isFinite(G))return G}return 0}function c(q={}){let G=process.env.POSTHOG_PROJECT_ID,J=process.env.POSTHOG_PERSONAL_API_KEY;if(!G||!J)return null;let Q=z("POSTHOG_EVIDENCE_LOOKBACK_DAYS",q.defaultLookbackDays??30),W=z("POSTHOG_EVIDENCE_LIMIT",q.defaultLimit??10),X=new Date,B=new Date(X.getTime()-Q*24*60*60*1000),$=O("POSTHOG_EVIDENCE_EVENTS"),V=O("POSTHOG_EVIDENCE_FUNNEL_STEPS"),H=V&&V.length?{name:"posthog-evidence-funnel",steps:V.map((Z,j)=>({id:`step_${j+1}`,eventName:Z}))}:void 0;return{reader:new U({host:process.env.POSTHOG_HOST,projectId:G,personalApiKey:J}),dateRange:{from:B,to:X},eventNames:$,limit:W,funnel:H,includeFeatureFlags:b("POSTHOG_EVIDENCE_FEATURE_FLAGS",!0)}}function O(q){let G=process.env[q];if(!G)return;return G.split(",").map((J)=>J.trim()).filter(Boolean)}function z(q,G){let J=process.env[q];if(!J)return G;let Q=Number(J);return Number.isFinite(Q)?Q:G}function b(q,G){let J=process.env[q];if(J===void 0)return G;return J.toLowerCase()==="true"}import K from"node:fs";import Y from"node:path";import{fileURLToPath as w}from"node:url";var y=Y.dirname(w(import.meta.url)),E=Y.join(y,"../evidence"),R=["interviews","tickets","public"],N=800;function h(q){let G=q.indexOf("---");if(G===-1)return q;let J=q.indexOf("---",G+3);if(J===-1)return q;return q.slice(J+3).trimStart()}function k(q,G,J){let Q=[],W=G.trim();for(let X=0,B=0;X<W.length;B+=1){let $=W.slice(X,X+J);Q.push({chunkId:`${q}#c_${String(B).padStart(2,"0")}`,text:$,meta:{source:q}}),X+=J}return Q}function m(q={}){let G=q.evidenceRoot??E,J=q.transcriptDirs??R,Q=q.chunkSize??N,W=[];for(let X of J){let B=Y.join(G,X);if(!K.existsSync(B))continue;for(let $ of K.readdirSync(B)){if(Y.extname($).toLowerCase()!==".md")continue;let H=Y.join(B,$),M=K.readFileSync(H,"utf8"),Z=h(M),j=Y.parse($).name,P=k(j,Z,Q);W.push(...P)}}return W}async function l(q={}){let G=m(q);if(!q.posthog)return G;let J=await L(q.posthog);return[...G,...J]}export{l as loadEvidenceChunksWithSignals,m as loadEvidenceChunks,R as DEFAULT_TRANSCRIPT_DIRS,E as DEFAULT_EVIDENCE_ROOT,N as DEFAULT_CHUNK_SIZE};

package/dist/node/posthog-signals.js

@@ -1,248 +1,5 @@
-// src/posthog-signals.ts
-import { PosthogAnalyticsProvider } from "@contractspec/integration.providers-impls/impls/posthog";
-import { FunnelAnalyzer } from "@contractspec/lib.analytics/funnel";
-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 result = 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(`
-`),
-    values: {
-      dateFrom: range.from.toISOString(),
-      dateTo: range.to.toISOString(),
-      ...eventFilter.values
-    }
-  });
-  const rows = mapRows(result);
-  if (rows.length === 0)
-    return null;
-  const lines = rows.map((row) => {
-    const name = asString(row.eventName) ?? "unknown";
-    const total = asNumber(row.total);
-    return `- ${name}: ${total}`;
-  });
-  return {
-    chunkId: `posthog:event_summary:${range.from.toISOString()}`,
-    text: [
-      `PostHog event summary (${range.from.toISOString()} → ${range.to.toISOString()}):`,
-      ...lines
-    ].join(`
-`),
-    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) {
-    const response = await options.reader.getEvents({
-      event: eventName,
-      dateRange: {
-        from: range.from,
-        to: range.to
-      },
-      limit: options.limit ?? 500
-    });
-    response.results.forEach((event) => {
-      events.push({
-        name: event.event,
-        userId: event.distinctId,
-        tenantId: typeof event.properties?.tenantId === "string" ? event.properties.tenantId : undefined,
-        timestamp: event.timestamp,
-        properties: event.properties
-      });
-    });
-  }
-  if (events.length === 0)
-    return null;
-  const analyzer = new FunnelAnalyzer;
-  const analysis = analyzer.analyze(events, options.funnel);
-  const lines = analysis.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(`
-`),
-    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;
-  const lines = response.results.map((flag) => {
-    const key = flag.key ?? "unknown";
-    const active = flag.active ? "active" : "inactive";
-    return `- ${key}: ${active}`;
-  });
-  return {
-    chunkId: "posthog:feature_flags",
-    text: ["PostHog feature flags:", ...lines].join(`
-`),
-    meta: {
-      source: "posthog",
-      kind: "feature_flags"
-    }
-  };
-}
-function resolveRange(dateRange) {
-  const now = new Date;
-  const from = dateRange?.from instanceof Date ? dateRange.from : dateRange?.from ? new Date(dateRange.from) : new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
-  const to = dateRange?.to instanceof Date ? dateRange.to : dateRange?.to ? new Date(dateRange.to) : now;
-  return { from, to };
-}
-function buildEventFilter(eventNames) {
-  if (!eventNames || eventNames.length === 0)
-    return {};
-  if (eventNames.length === 1) {
-    return {
-      clause: "event = {event0}",
-      values: { event0: eventNames[0] }
-    };
-  }
-  const values = {};
-  const clauses = eventNames.map((eventName, index) => {
-    values[`event${index}`] = eventName;
-    return `event = {event${index}}`;
-  });
-  return {
-    clause: `(${clauses.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 = new Date;
-  const from = new Date(now.getTime() - lookbackDays * 24 * 60 * 60 * 1000);
-  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
-    }))
-  } : undefined;
-  const reader = new PosthogAnalyticsProvider({
-    host: process.env.POSTHOG_HOST,
-    projectId,
-    personalApiKey
-  });
-  return {
-    reader,
-    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;
-  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 === undefined)
-    return fallback;
-  return value.toLowerCase() === "true";
-}
-export {
-  resolvePosthogEvidenceOptionsFromEnv,
-  loadPosthogEvidenceChunks
-};
+import{PosthogAnalyticsProvider as Z}from"@contractspec/integration.providers-impls/impls/posthog";import{FunnelAnalyzer as _}from"@contractspec/lib.analytics/funnel";async function x(q){let G=[],H=D(q.dateRange),J=await $(q,H);if(J)G.push(J);let L=await z(q,H);if(L)G.push(L);let M=await B(q);if(M)G.push(M);return G}async function $(q,G){if(!q.reader.queryHogQL)return null;let H=j(q.eventNames),J=q.limit??10,L=await q.reader.queryHogQL({query:["select","  event as eventName,","  count() as total","from events","where timestamp >= {dateFrom} and timestamp < {dateTo}",H.clause?`and ${H.clause}`:"","group by eventName","order by total desc",`limit ${J}`].filter(Boolean).join(`
+`),values:{dateFrom:G.from.toISOString(),dateTo:G.to.toISOString(),...H.values}}),M=C(L);if(M.length===0)return null;let U=M.map((O)=>{let T=I(O.eventName)??"unknown",Q=K(O.total);return`- ${T}: ${Q}`});return{chunkId:`posthog:event_summary:${G.from.toISOString()}`,text:[`PostHog event summary (${G.from.toISOString()} → ${G.to.toISOString()}):`,...U].join(`
+`),meta:{source:"posthog",kind:"event_summary",dateFrom:G.from.toISOString(),dateTo:G.to.toISOString()}}}async function z(q,G){if(!q.funnel)return null;if(!q.reader.getEvents)return null;let H=[],J=q.funnel.steps.map((O)=>O.eventName);for(let O of J)(await q.reader.getEvents({event:O,dateRange:{from:G.from,to:G.to},limit:q.limit??500})).results.forEach((Q)=>{H.push({name:Q.event,userId:Q.distinctId,tenantId:typeof Q.properties?.tenantId==="string"?Q.properties.tenantId:void 0,timestamp:Q.timestamp,properties:Q.properties})});if(H.length===0)return null;let U=new _().analyze(H,q.funnel).steps.map((O)=>{return`- ${O.step.eventName}: ${O.count} (conversion ${O.conversionRate}, drop-off ${O.dropOffRate})`});return{chunkId:`posthog:funnel:${q.funnel.name}`,text:[`PostHog funnel analysis — ${q.funnel.name}:`,...U].join(`
+`),meta:{source:"posthog",kind:"funnel",funnelName:q.funnel.name,dateFrom:G.from.toISOString(),dateTo:G.to.toISOString()}}}async function B(q){if(!q.includeFeatureFlags)return null;if(!q.reader.getFeatureFlags)return null;let G=await q.reader.getFeatureFlags({limit:10});if(!G.results.length)return null;return{chunkId:"posthog:feature_flags",text:["PostHog feature flags:",...G.results.map((J)=>{let L=J.key??"unknown",M=J.active?"active":"inactive";return`- ${L}: ${M}`})].join(`
+`),meta:{source:"posthog",kind:"feature_flags"}}}function D(q){let G=new Date,H=q?.from instanceof Date?q.from:q?.from?new Date(q.from):new Date(G.getTime()-2592000000),J=q?.to instanceof Date?q.to:q?.to?new Date(q.to):G;return{from:H,to:J}}function j(q){if(!q||q.length===0)return{};if(q.length===1)return{clause:"event = {event0}",values:{event0:q[0]}};let G={};return{clause:`(${q.map((J,L)=>{return G[`event${L}`]=J,`event = {event${L}}`}).join(" or ")})`,values:G}}function C(q){if(!Array.isArray(q.results)||!Array.isArray(q.columns))return[];let G=q.columns;return q.results.flatMap((H)=>{if(!Array.isArray(H))return[];let J={};return G.forEach((L,M)=>{J[L]=H[M]}),[J]})}function I(q){if(typeof q==="string"&&q.trim())return q;if(typeof q==="number")return String(q);return null}function K(q){if(typeof q==="number"&&Number.isFinite(q))return q;if(typeof q==="string"&&q.trim()){let G=Number(q);if(Number.isFinite(G))return G}return 0}function F(q={}){let G=process.env.POSTHOG_PROJECT_ID,H=process.env.POSTHOG_PERSONAL_API_KEY;if(!G||!H)return null;let J=W("POSTHOG_EVIDENCE_LOOKBACK_DAYS",q.defaultLookbackDays??30),L=W("POSTHOG_EVIDENCE_LIMIT",q.defaultLimit??10),M=new Date,U=new Date(M.getTime()-J*24*60*60*1000),O=V("POSTHOG_EVIDENCE_EVENTS"),T=V("POSTHOG_EVIDENCE_FUNNEL_STEPS"),Q=T&&T.length?{name:"posthog-evidence-funnel",steps:T.map((X,Y)=>({id:`step_${Y+1}`,eventName:X}))}:void 0;return{reader:new Z({host:process.env.POSTHOG_HOST,projectId:G,personalApiKey:H}),dateRange:{from:U,to:M},eventNames:O,limit:L,funnel:Q,includeFeatureFlags:P("POSTHOG_EVIDENCE_FEATURE_FLAGS",!0)}}function V(q){let G=process.env[q];if(!G)return;return G.split(",").map((H)=>H.trim()).filter(Boolean)}function W(q,G){let H=process.env[q];if(!H)return G;let J=Number(H);return Number.isFinite(J)?J:G}function P(q,G){let H=process.env[q];if(H===void 0)return G;return H.toLowerCase()==="true"}export{F as resolvePosthogEvidenceOptionsFromEnv,x as loadPosthogEvidenceChunks};

package/dist/node/product-intent.discovery.js

@@ -1,75 +1 @@
-// src/product-intent.discovery.ts
-import {
-  OwnersEnum,
-  StabilityEnum
-} from "@contractspec/lib.contracts-spec/ownership";
-import { defineProductIntentSpec } from "@contractspec/lib.contracts-spec/product-intent/spec";
-var ProductIntentDiscoverySpec = defineProductIntentSpec({
-  id: "product-intent.discovery.activation",
-  meta: {
-    key: "product-intent.discovery.activation",
-    version: "1.0.0",
-    title: "Product Intent Discovery",
-    description: "Discovery contract for activation friction using transcripts, analytics signals, and generated tasks.",
-    domain: "product",
-    owners: [OwnersEnum.PlatformCore],
-    tags: ["product-intent", "discovery", "activation", "analytics"],
-    stability: StabilityEnum.Experimental,
-    goal: "Prioritize the next activation improvement with grounded evidence.",
-    context: "Evidence is collected from interview transcripts, support tickets, and PostHog funnels before turning into task-ready outputs."
-  },
-  question: "Which activation and onboarding friction should we prioritize next?",
-  runtimeContext: {
-    evidenceRoot: "packages/examples/product-intent/evidence",
-    analyticsProvider: "posthog"
-  },
-  tickets: {
-    tickets: [
-      {
-        ticketId: "PI-101",
-        title: "Add a guided onboarding checklist",
-        summary: "Give new users an explicit checklist after signup so they can see the next activation milestone.",
-        evidenceIds: ["INT-002", "INT-014", "PH-dropoff-checkout"],
-        acceptanceCriteria: [
-          "Users see a checklist within the first session.",
-          "Checklist completion is tracked in analytics."
-        ],
-        priority: "high",
-        tags: ["activation", "onboarding"]
-      }
-    ]
-  },
-  tasks: {
-    packId: "product-intent.discovery.activation.tasks",
-    patchId: "product-intent.discovery.activation.patch",
-    overview: "Introduce a checklist-driven onboarding path and instrument it for activation measurement.",
-    tasks: [
-      {
-        id: "task-ui-checklist",
-        title: "Model the onboarding checklist surface",
-        surface: ["ui", "docs"],
-        why: "The product intent needs a visible activation guide and matching contract docs.",
-        acceptance: [
-          "A checklist surface is defined in contracts.",
-          "Documentation explains the activation milestone mapping."
-        ],
-        agentPrompt: "Add the onboarding checklist contract surface and document the milestone states."
-      },
-      {
-        id: "task-analytics-checklist",
-        title: "Track checklist completion events",
-        surface: ["api", "tests"],
-        why: "Success must be measurable after rollout.",
-        acceptance: [
-          "Checklist completion emits analytics events.",
-          "Tests cover the event contract and payload shape."
-        ],
-        agentPrompt: "Emit activation checklist events and add test coverage for the telemetry payloads.",
-        dependsOn: ["task-ui-checklist"]
-      }
-    ]
-  }
-});
-export {
-  ProductIntentDiscoverySpec
-};
+import{OwnersEnum as g,StabilityEnum as h}from"@contractspec/lib.contracts-spec/ownership";import{defineProductIntentSpec as j}from"@contractspec/lib.contracts-spec/product-intent/spec";var v=j({id:"product-intent.discovery.activation",meta:{key:"product-intent.discovery.activation",version:"1.0.0",title:"Product Intent Discovery",description:"Discovery contract for activation friction using transcripts, analytics signals, and generated tasks.",domain:"product",owners:[g.PlatformCore],tags:["product-intent","discovery","activation","analytics"],stability:h.Experimental,goal:"Prioritize the next activation improvement with grounded evidence.",context:"Evidence is collected from interview transcripts, support tickets, and PostHog funnels before turning into task-ready outputs."},question:"Which activation and onboarding friction should we prioritize next?",runtimeContext:{evidenceRoot:"packages/examples/product-intent/evidence",analyticsProvider:"posthog"},tickets:{tickets:[{ticketId:"PI-101",title:"Add a guided onboarding checklist",summary:"Give new users an explicit checklist after signup so they can see the next activation milestone.",evidenceIds:["INT-002","INT-014","PH-dropoff-checkout"],acceptanceCriteria:["Users see a checklist within the first session.","Checklist completion is tracked in analytics."],priority:"high",tags:["activation","onboarding"]}]},tasks:{packId:"product-intent.discovery.activation.tasks",patchId:"product-intent.discovery.activation.patch",overview:"Introduce a checklist-driven onboarding path and instrument it for activation measurement.",tasks:[{id:"task-ui-checklist",title:"Model the onboarding checklist surface",surface:["ui","docs"],why:"The product intent needs a visible activation guide and matching contract docs.",acceptance:["A checklist surface is defined in contracts.","Documentation explains the activation milestone mapping."],agentPrompt:"Add the onboarding checklist contract surface and document the milestone states."},{id:"task-analytics-checklist",title:"Track checklist completion events",surface:["api","tests"],why:"Success must be measurable after rollout.",acceptance:["Checklist completion emits analytics events.","Tests cover the event contract and payload shape."],agentPrompt:"Emit activation checklist events and add test coverage for the telemetry payloads.",dependsOn:["task-ui-checklist"]}]}});export{v as ProductIntentDiscoverySpec};

package/dist/node/product-intent.feature.js

@@ -1,19 +1 @@
-// src/product-intent.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var ProductIntentFeature = defineFeature({
-  meta: {
-    key: "product-intent",
-    version: "1.0.0",
-    title: "Product Intent",
-    description: "Evidence ingestion, PostHog signals, and transcript-to-tickets discovery workflow",
-    domain: "product",
-    owners: ["@examples"],
-    tags: ["product", "intent", "evidence", "posthog"],
-    stability: "experimental"
-  },
-  telemetry: [{ key: "product-intent.telemetry", version: "1.0.0" }],
-  docs: []
-});
-export {
-  ProductIntentFeature
-};
+import{defineFeature as g}from"@contractspec/lib.contracts-spec";var j=g({meta:{key:"product-intent",version:"1.0.0",title:"Product Intent",description:"Evidence ingestion, PostHog signals, and transcript-to-tickets discovery workflow",domain:"product",owners:["@examples"],tags:["product","intent","evidence","posthog"],stability:"experimental"},telemetry:[{key:"product-intent.telemetry",version:"1.0.0"}],docs:[]});export{j as ProductIntentFeature};