@contractspec/example.product-intent 3.7.17 → 3.7.19

package/dist/load-evidence.js

@@ -1,314 +1,6 @@
 // @bun
-// 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()} \u2192 ${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 \u2014 ${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 "fs";
-import path from "path";
-import { fileURLToPath } from "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()} \u2192 ${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 \u2014 ${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"fs";import Y from"path";import{fileURLToPath as w}from"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/docs/index.js

@@ -1,34 +1,10 @@
-// src/docs/product-intent.docblock.ts
-import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
-var blocks = [
-  {
-    id: "docs.examples.product-intent",
-    title: "Product Intent Discovery",
-    summary: "Evidence-ingestion example for turning product signals into prompt-ready discovery outputs.",
-    kind: "reference",
-    visibility: "public",
-    route: "/docs/examples/product-intent",
-    tags: ["product-intent", "discovery", "evidence", "example"],
-    body: `## Included assets
+import{registerDocBlocks as m}from"@contractspec/lib.contracts-spec/docs";var f=[{id:"docs.examples.product-intent",title:"Product Intent Discovery",summary:"Evidence-ingestion example for turning product signals into prompt-ready discovery outputs.",kind:"reference",visibility:"public",route:"/docs/examples/product-intent",tags:["product-intent","discovery","evidence","example"],body:`## Included assets
 - Product-intent feature and example manifest.
 - Evidence loading helpers and PostHog signal ingestion.
 - Sync actions and script entrypoints for discovery workflows.
 
 ## Use case
-Use this example when you need a lightweight pattern for evidence-backed product discovery before it becomes a larger workflow or template.`
-  },
-  {
-    id: "docs.examples.product-intent.usage",
-    title: "Product Intent Usage",
-    summary: "How to use the product-intent example for evidence ingestion.",
-    kind: "usage",
-    visibility: "public",
-    route: "/docs/examples/product-intent/usage",
-    tags: ["product-intent", "usage"],
-    body: `## Usage
+Use this example when you need a lightweight pattern for evidence-backed product discovery before it becomes a larger workflow or template.`},{id:"docs.examples.product-intent.usage",title:"Product Intent Usage",summary:"How to use the product-intent example for evidence ingestion.",kind:"usage",visibility:"public",route:"/docs/examples/product-intent/usage",tags:["product-intent","usage"],body:`## Usage
 1. Load evidence sources with the helpers in this package.
 2. Transform product signals into the product-intent workflow inputs.
-3. Export the resulting discovery outputs into the next planning step or agent prompt.`
-  }
-];
-registerDocBlocks(blocks);
+3. Export the resulting discovery outputs into the next planning step or agent prompt.`}];m(f);

package/dist/node/docs/product-intent.docblock.js

@@ -1,34 +1,10 @@
-// src/docs/product-intent.docblock.ts
-import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
-var blocks = [
-  {
-    id: "docs.examples.product-intent",
-    title: "Product Intent Discovery",
-    summary: "Evidence-ingestion example for turning product signals into prompt-ready discovery outputs.",
-    kind: "reference",
-    visibility: "public",
-    route: "/docs/examples/product-intent",
-    tags: ["product-intent", "discovery", "evidence", "example"],
-    body: `## Included assets
+import{registerDocBlocks as f}from"@contractspec/lib.contracts-spec/docs";var h=[{id:"docs.examples.product-intent",title:"Product Intent Discovery",summary:"Evidence-ingestion example for turning product signals into prompt-ready discovery outputs.",kind:"reference",visibility:"public",route:"/docs/examples/product-intent",tags:["product-intent","discovery","evidence","example"],body:`## Included assets
 - Product-intent feature and example manifest.
 - Evidence loading helpers and PostHog signal ingestion.
 - Sync actions and script entrypoints for discovery workflows.
 
 ## Use case
-Use this example when you need a lightweight pattern for evidence-backed product discovery before it becomes a larger workflow or template.`
-  },
-  {
-    id: "docs.examples.product-intent.usage",
-    title: "Product Intent Usage",
-    summary: "How to use the product-intent example for evidence ingestion.",
-    kind: "usage",
-    visibility: "public",
-    route: "/docs/examples/product-intent/usage",
-    tags: ["product-intent", "usage"],
-    body: `## Usage
+Use this example when you need a lightweight pattern for evidence-backed product discovery before it becomes a larger workflow or template.`},{id:"docs.examples.product-intent.usage",title:"Product Intent Usage",summary:"How to use the product-intent example for evidence ingestion.",kind:"usage",visibility:"public",route:"/docs/examples/product-intent/usage",tags:["product-intent","usage"],body:`## Usage
 1. Load evidence sources with the helpers in this package.
 2. Transform product signals into the product-intent workflow inputs.
-3. Export the resulting discovery outputs into the next planning step or agent prompt.`
-  }
-];
-registerDocBlocks(blocks);
+3. Export the resulting discovery outputs into the next planning step or agent prompt.`}];f(h);

package/dist/node/example.js

@@ -1,33 +1 @@
-// src/example.ts
-import { defineExample } from "@contractspec/lib.contracts-spec/examples";
-var example = defineExample({
-  meta: {
-    key: "product-intent",
-    version: "1.0.0",
-    title: "Product Intent Discovery",
-    description: "Evidence ingestion and product-intent workflow for PM discovery.",
-    kind: "script",
-    visibility: "public",
-    stability: "experimental",
-    owners: ["@platform.core"],
-    tags: ["product-intent", "discovery", "pm", "evidence", "llm"]
-  },
-  docs: {
-    rootDocId: "docs.examples.product-intent",
-    usageDocId: "docs.examples.product-intent.usage"
-  },
-  entrypoints: {
-    packageName: "@contractspec/example.product-intent",
-    docs: "./docs"
-  },
-  surfaces: {
-    templates: false,
-    sandbox: { enabled: false, modes: [] },
-    studio: { enabled: false, installable: false },
-    mcp: { enabled: false }
-  }
-});
-var example_default = example;
-export {
-  example_default as default
-};
+import{defineExample as g}from"@contractspec/lib.contracts-spec/examples";var h=g({meta:{key:"product-intent",version:"1.0.0",title:"Product Intent Discovery",description:"Evidence ingestion and product-intent workflow for PM discovery.",kind:"script",visibility:"public",stability:"experimental",owners:["@platform.core"],tags:["product-intent","discovery","pm","evidence","llm"]},docs:{rootDocId:"docs.examples.product-intent",usageDocId:"docs.examples.product-intent.usage"},entrypoints:{packageName:"@contractspec/example.product-intent",docs:"./docs"},surfaces:{templates:!1,sandbox:{enabled:!1,modes:[]},studio:{enabled:!1,installable:!1},mcp:{enabled:!1}}}),q=h;export{q as default};