@contractspec/example.product-intent 3.7.6 → 3.7.10

package/dist/product-intent.discovery.d.ts

@@ -0,0 +1,4 @@
+export declare const ProductIntentDiscoverySpec: import("@contractspec/lib.contracts-spec/product-intent/spec").ProductIntentSpec<{
+    evidenceRoot: string;
+    analyticsProvider: string;
+}>;

package/dist/product-intent.discovery.js

@@ -0,0 +1,76 @@
+// @bun
+// 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
+};

package/dist/script.js

@@ -1,7 +1,7 @@
 // @bun
 // src/posthog-signals.ts
-import { FunnelAnalyzer } from "@contractspec/lib.analytics/funnel";
 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);

package/dist/sync-actions.js

@@ -1,7 +1,7 @@
 // @bun
 // src/posthog-signals.ts
-import { FunnelAnalyzer } from "@contractspec/lib.analytics/funnel";
 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);
@@ -307,6 +307,9 @@ async function loadEvidenceChunksWithSignals(options = {}) {
 }
 
 // src/sync-actions.ts
+import { JiraProjectManagementProvider } from "@contractspec/integration.providers-impls/impls/jira";
+import { LinearProjectManagementProvider } from "@contractspec/integration.providers-impls/impls/linear";
+import { NotionProjectManagementProvider } from "@contractspec/integration.providers-impls/impls/notion";
 import { createAgentJsonRunner } from "@contractspec/lib.ai-agent/agent/json-runner";
 import {
   buildProjectManagementSyncPayload,
@@ -316,9 +319,6 @@ import {
   impactEngine,
   suggestPatch
 } from "@contractspec/lib.product-intent-utils";
-import { LinearProjectManagementProvider } from "@contractspec/integration.providers-impls/impls/linear";
-import { JiraProjectManagementProvider } from "@contractspec/integration.providers-impls/impls/jira";
-import { NotionProjectManagementProvider } from "@contractspec/integration.providers-impls/impls/notion";
 var QUESTION = "Which activation and onboarding friction should we prioritize next?";
 function resolveProvider() {
   const raw = (process.env.CONTRACTSPEC_PM_PROVIDER ?? "").toLowerCase();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.product-intent",
-  "version": "3.7.6",
+  "version": "3.7.10",
   "description": "Product intent example: evidence ingestion and prompt-ready outputs.",
   "keywords": [
     "contractspec",
@@ -48,6 +48,12 @@
       "node": "./dist/node/posthog-signals.js",
       "default": "./dist/posthog-signals.js"
     },
+    "./product-intent.discovery": {
+      "types": "./dist/product-intent.discovery.d.ts",
+      "bun": "./dist/product-intent.discovery.js",
+      "node": "./dist/node/product-intent.discovery.js",
+      "default": "./dist/product-intent.discovery.js"
+    },
     "./product-intent.feature": {
       "types": "./dist/product-intent.feature.d.ts",
       "bun": "./dist/product-intent.feature.js",
@@ -76,23 +82,24 @@
     "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
-    "lint:fix": "eslint src --fix",
-    "lint:check": "eslint src",
+    "lint:fix": "biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .",
+    "lint:check": "biome check .",
     "test": "bun test",
     "prebuild": "contractspec-bun-build prebuild",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.contracts-spec": "3.7.6",
-    "@contractspec/lib.contracts-integrations": "3.7.6",
-    "@contractspec/lib.ai-agent": "7.0.6",
-    "@contractspec/lib.product-intent-utils": "3.7.6",
-    "@contractspec/integration.providers-impls": "3.7.6"
+    "@contractspec/lib.analytics": "3.7.10",
+    "@contractspec/lib.contracts-spec": "4.1.2",
+    "@contractspec/lib.contracts-integrations": "3.8.2",
+    "@contractspec/lib.ai-agent": "7.0.10",
+    "@contractspec/lib.product-intent-utils": "3.7.10",
+    "@contractspec/integration.providers-impls": "3.8.2"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.6",
+    "@contractspec/tool.typescript": "3.7.8",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.7.6"
+    "@contractspec/tool.bun": "3.7.8"
   },
   "publishConfig": {
     "access": "public",
@@ -133,6 +140,12 @@
         "node": "./dist/node/posthog-signals.js",
         "default": "./dist/posthog-signals.js"
       },
+      "./product-intent.discovery": {
+        "types": "./dist/product-intent.discovery.d.ts",
+        "bun": "./dist/product-intent.discovery.js",
+        "node": "./dist/node/product-intent.discovery.js",
+        "default": "./dist/product-intent.discovery.js"
+      },
       "./product-intent.feature": {
         "types": "./dist/product-intent.feature.d.ts",
         "bun": "./dist/product-intent.feature.js",

package/src/contracts.test.ts

@@ -0,0 +1,14 @@
+import { describe, expect, test } from 'bun:test';
+import { ProductIntentDiscoverySpec, ProductIntentFeature } from './index';
+
+describe('@contractspec/example.product-intent', () => {
+	test('exports the canonical product intent spec', () => {
+		expect(ProductIntentDiscoverySpec.meta.key).toBe(
+			'product-intent.discovery.activation'
+		);
+		expect(ProductIntentDiscoverySpec.question).toContain('activation');
+		expect(ProductIntentDiscoverySpec.tickets?.tickets).toHaveLength(1);
+		expect(ProductIntentDiscoverySpec.tasks?.tasks).toHaveLength(2);
+		expect(ProductIntentFeature.meta.key).toBe('product-intent');
+	});
+});

package/src/docs/product-intent.docblock.ts

@@ -2,36 +2,36 @@ import type { DocBlock } from '@contractspec/lib.contracts-spec/docs';
 import { registerDocBlocks } from '@contractspec/lib.contracts-spec/docs';
 
 const blocks: DocBlock[] = [
-  {
-    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
+	{
+		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
+	},
+	{
+		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);

package/src/example.ts

@@ -1,32 +1,32 @@
 import { defineExample } from '@contractspec/lib.contracts-spec/examples';
 
 const 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 },
-  },
+	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 },
+	},
 });
 
 export default example;

package/src/index.ts

@@ -1,18 +1,19 @@
 export { default as example } from './example';
-export {
-  DEFAULT_CHUNK_SIZE,
-  DEFAULT_EVIDENCE_ROOT,
-  DEFAULT_TRANSCRIPT_DIRS,
-  loadEvidenceChunks,
-  loadEvidenceChunksWithSignals,
-} from './load-evidence';
 export type {
-  EvidenceLoadOptions,
-  EvidenceLoadWithSignalsOptions,
+	EvidenceLoadOptions,
+	EvidenceLoadWithSignalsOptions,
 } from './load-evidence';
 export {
-  loadPosthogEvidenceChunks,
-  resolvePosthogEvidenceOptionsFromEnv,
-} from './posthog-signals';
+	DEFAULT_CHUNK_SIZE,
+	DEFAULT_EVIDENCE_ROOT,
+	DEFAULT_TRANSCRIPT_DIRS,
+	loadEvidenceChunks,
+	loadEvidenceChunksWithSignals,
+} from './load-evidence';
 export type { PosthogEvidenceOptions } from './posthog-signals';
+export {
+	loadPosthogEvidenceChunks,
+	resolvePosthogEvidenceOptionsFromEnv,
+} from './posthog-signals';
+export * from './product-intent.discovery';
 export * from './product-intent.feature';

package/src/load-evidence.test.ts

@@ -6,11 +6,11 @@ import { loadEvidenceChunks } from './load-evidence';
 const moduleDir = path.dirname(fileURLToPath(import.meta.url));
 
 describe('loadEvidenceChunks', () => {
-  it('loads evidence chunks from the example dataset', () => {
-    const evidenceRoot = path.join(moduleDir, '../evidence');
-    const chunks = loadEvidenceChunks({ evidenceRoot, chunkSize: 2000 });
+	it('loads evidence chunks from the example dataset', () => {
+		const evidenceRoot = path.join(moduleDir, '../evidence');
+		const chunks = loadEvidenceChunks({ evidenceRoot, chunkSize: 2000 });
 
-    expect(chunks.length).toBeGreaterThan(0);
-    expect(chunks.some((chunk) => chunk.chunkId.startsWith('INT-'))).toBe(true);
-  });
+		expect(chunks.length).toBeGreaterThan(0);
+		expect(chunks.some((chunk) => chunk.chunkId.startsWith('INT-'))).toBe(true);
+	});
 });

package/src/load-evidence.ts

@@ -12,13 +12,13 @@ export const DEFAULT_TRANSCRIPT_DIRS = ['interviews', 'tickets', 'public'];
 export const DEFAULT_CHUNK_SIZE = 800;
 
 export interface EvidenceLoadOptions {
-  evidenceRoot?: string;
-  transcriptDirs?: string[];
-  chunkSize?: number;
+	evidenceRoot?: string;
+	transcriptDirs?: string[];
+	chunkSize?: number;
 }
 
 export interface EvidenceLoadWithSignalsOptions extends EvidenceLoadOptions {
-  posthog?: PosthogEvidenceOptions;
+	posthog?: PosthogEvidenceOptions;
 }
 
 /**
@@ -26,33 +26,33 @@ export interface EvidenceLoadWithSignalsOptions extends EvidenceLoadOptions {
  * files include a YAML header delimited by triple dashes.
  */
 function stripYamlFrontMatter(contents: string): string {
-  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();
+	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();
 }
 
 /**
  * Split a transcript into fixed-size chunks.
  */
 function chunkTranscript(
-  fileId: string,
-  text: string,
-  chunkSize: number
+	fileId: string,
+	text: string,
+	chunkSize: number
 ): EvidenceChunk[] {
-  const chunks: EvidenceChunk[] = [];
-  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;
+	const chunks: EvidenceChunk[] = [];
+	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;
 }
 
 /**
@@ -60,35 +60,35 @@ function chunkTranscript(
  * EvidenceChunk objects ready for prompt formatting.
  */
 export function loadEvidenceChunks(
-  options: EvidenceLoadOptions = {}
+	options: EvidenceLoadOptions = {}
 ): EvidenceChunk[] {
-  const evidenceRoot = options.evidenceRoot ?? DEFAULT_EVIDENCE_ROOT;
-  const transcriptDirs = options.transcriptDirs ?? DEFAULT_TRANSCRIPT_DIRS;
-  const chunkSize = options.chunkSize ?? DEFAULT_CHUNK_SIZE;
+	const evidenceRoot = options.evidenceRoot ?? DEFAULT_EVIDENCE_ROOT;
+	const transcriptDirs = options.transcriptDirs ?? DEFAULT_TRANSCRIPT_DIRS;
+	const chunkSize = options.chunkSize ?? DEFAULT_CHUNK_SIZE;
 
-  const chunks: EvidenceChunk[] = [];
-  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;
+	const chunks: EvidenceChunk[] = [];
+	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;
 }
 
 export async function loadEvidenceChunksWithSignals(
-  options: EvidenceLoadWithSignalsOptions = {}
+	options: EvidenceLoadWithSignalsOptions = {}
 ): Promise<EvidenceChunk[]> {
-  const baseChunks = loadEvidenceChunks(options);
-  if (!options.posthog) return baseChunks;
-  const posthogChunks = await loadPosthogEvidenceChunks(options.posthog);
-  return [...baseChunks, ...posthogChunks];
+	const baseChunks = loadEvidenceChunks(options);
+	if (!options.posthog) return baseChunks;
+	const posthogChunks = await loadPosthogEvidenceChunks(options.posthog);
+	return [...baseChunks, ...posthogChunks];
 }