@contractspec/example.product-intent 3.7.6 → 3.7.10

package/.turbo/turbo-build.log

@@ -2,30 +2,32 @@ $ contractspec-bun-build prebuild
 $ bun run prebuild && bun run build:bundle && bun run build:types
 $ contractspec-bun-build prebuild
 $ contractspec-bun-build transpile
-[contractspec-bun-build] transpile target=bun root=src entries=9 noBundle=false
-Bundled 9 modules in 26ms
+[contractspec-bun-build] transpile target=bun root=src entries=10 noBundle=false
+Bundled 10 modules in 46ms
 
   docs/index.js                     1.41 KB   (entry point)
+  ./script.js                       16.50 KB  (entry point)
   ./sync-actions.js                 15.97 KB  (entry point)
   docs/product-intent.docblock.js   1.41 KB   (entry point)
-  ./index.js                        11.44 KB  (entry point)
+  ./index.js                        14.46 KB  (entry point)
   ./example.js                      0.95 KB   (entry point)
-  ./product-intent.feature.js       0.60 KB   (entry point)
-  ./script.js                       16.50 KB  (entry point)
   ./load-evidence.js                9.86 KB   (entry point)
   ./posthog-signals.js              7.59 KB   (entry point)
+  ./product-intent.discovery.js     3.0 KB    (entry point)
+  ./product-intent.feature.js       0.60 KB   (entry point)
 
-[contractspec-bun-build] transpile target=node root=src entries=9 noBundle=false
-Bundled 9 modules in 21ms
+[contractspec-bun-build] transpile target=node root=src entries=10 noBundle=false
+Bundled 10 modules in 46ms
 
   docs/index.js                     1.40 KB   (entry point)
+  ./script.js                       16.51 KB  (entry point)
   ./sync-actions.js                 15.97 KB  (entry point)
   docs/product-intent.docblock.js   1.40 KB   (entry point)
-  ./index.js                        11.44 KB  (entry point)
+  ./index.js                        14.46 KB  (entry point)
   ./example.js                      0.94 KB   (entry point)
-  ./product-intent.feature.js       0.59 KB   (entry point)
-  ./script.js                       16.51 KB  (entry point)
   ./load-evidence.js                9.86 KB   (entry point)
   ./posthog-signals.js              7.58 KB   (entry point)
+  ./product-intent.discovery.js     3.0 KB    (entry point)
+  ./product-intent.feature.js       0.59 KB   (entry point)
 
 $ contractspec-bun-build types

package/AGENTS.md

@@ -1,33 +1,57 @@
-# AI Agent Guide -- `@contractspec/example.product-intent`
+# AI Agent Guide — `@contractspec/example.product-intent`
 
 Scope: `packages/examples/product-intent/*`
 
-Product intent example: evidence ingestion, PostHog signal extraction, and prompt-ready outputs for PM discovery.
+Product intent example: evidence ingestion and prompt-ready outputs.
 
 ## Quick Context
 
-- **Layer**: example
-- **Related Packages**: `lib.contracts-spec`, `lib.contracts-integrations`, `lib.ai-agent`, `lib.product-intent-utils`, `integration.providers-impls`
+- Layer: `example`.
+- Package visibility: published package.
+- Primary consumers are example explorers, template authors, and documentation readers.
+- Related packages: `@contractspec/integration.providers-impls`, `@contractspec/lib.ai-agent`, `@contractspec/lib.analytics`, `@contractspec/lib.contracts-integrations`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.product-intent-utils`, ...
 
-## What This Demonstrates
+## Architecture
 
-- Evidence loading and ingestion pipeline
-- PostHog signal extraction for product analytics
-- Action synchronization across tools
-- Script-based execution pattern
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/load-evidence.test.ts` is part of the package's public or composition surface.
+- `src/load-evidence.ts` is part of the package's public or composition surface.
+- `src/posthog-signals.ts` is part of the package's public or composition surface.
+- `src/product-intent.feature.ts` defines a feature entrypoint.
 
-## Public Exports
+## Public Surface
 
-- `.` -- root barrel
-- `./load-evidence` -- evidence ingestion
-- `./posthog-signals` -- PostHog signal extraction
-- `./sync-actions` -- action synchronization
-- `./script` -- runnable script
-- `./example`
+- Export `.` resolves through `./src/index.ts`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/product-intent.docblock` resolves through `./src/docs/product-intent.docblock.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./load-evidence` resolves through `./src/load-evidence.ts`.
+- Export `./posthog-signals` resolves through `./src/posthog-signals.ts`.
+- Export `./product-intent.feature` resolves through `./src/product-intent.feature.ts`.
+- Export `./script` resolves through `./src/script.ts`.
+- Export `./sync-actions` resolves through `./src/sync-actions.ts`.
+
+## Guardrails
+
+- Keep the example package demonstrative, buildable, and aligned with the exported feature surface.
+- Do not add hidden production assumptions that are not actually implemented in the example.
+- Changes here can affect downstream packages such as `@contractspec/integration.providers-impls`, `@contractspec/lib.ai-agent`, `@contractspec/lib.analytics`, `@contractspec/lib.contracts-integrations`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.product-intent-utils`, ....
+- Changes here can affect downstream packages such as `@contractspec/integration.providers-impls`, `@contractspec/lib.ai-agent`, `@contractspec/lib.analytics`, `@contractspec/lib.contracts-integrations`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.product-intent-utils`, ...
 
 ## Local Commands
 
-- Build: `bun run build`
-- Dev: `bun run dev`
-- Test: `bun test`
-- Typecheck: `bun run typecheck`
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @contractspec/example.product-intent
 
+## 3.7.10
+
+### Patch Changes
+
+- 1a44cb6: feat: improve examples to increase coverage of Contracts type
+- Updated dependencies [1a44cb6]
+  - @contractspec/integration.providers-impls@3.8.2
+  - @contractspec/lib.contracts-integrations@3.8.2
+  - @contractspec/lib.product-intent-utils@3.7.10
+  - @contractspec/lib.contracts-spec@4.1.2
+  - @contractspec/lib.analytics@3.7.10
+  - @contractspec/lib.ai-agent@7.0.10
+
+## 3.7.9
+
+### Patch Changes
+
+- fix: release
+- Updated dependencies
+  - @contractspec/integration.providers-impls@3.8.1
+  - @contractspec/lib.contracts-integrations@3.8.1
+  - @contractspec/lib.product-intent-utils@3.7.9
+  - @contractspec/lib.contracts-spec@4.1.1
+  - @contractspec/lib.analytics@3.7.9
+  - @contractspec/lib.ai-agent@7.0.9
+
 ## 3.7.6
 
 ### Patch Changes

package/README.md

@@ -1,58 +1,77 @@
-# Product Intent Example
+# @contractspec/example.product-intent
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
-Minimal example showing a transcript-to-tickets workflow with evidence-backed citations and a deterministic impact report.
+**Product intent example: evidence ingestion and prompt-ready outputs.**
 
-## What it demonstrates
+## What This Demonstrates
 
-- Loading interview, ticket, and public thread transcripts from `evidence/`.
-- Chunking transcripts into evidence chunks with stable ids.
-- Extracting evidence findings with exact-quote citations.
-- Grouping problems linked to evidence finding IDs.
-- Generating tickets with evidence links + acceptance criteria.
-- Producing a deterministic impact report from the patch intent.
+- Canonical `product-intent` export via `ProductIntentDiscoverySpec`.
+- Evidence loading and ingestion pipeline.
+- PostHog signal extraction for product analytics.
+- Action synchronization across tools.
+- Script-based execution pattern.
+- `src/docs/` contains docblocks and documentation-facing exports.
 
-## Running the script
+## Running Locally
 
-From the repository root:
+From `packages/examples/product-intent`:
+- `bun run dev`
+- `bun run build`
+- `bun run test`
+- `bun run typecheck`
 
-```bash
-bun install
-export CONTRACTSPEC_AI_PROVIDER="mistral" # or openai/anthropic/gemini/ollama
-export MISTRAL_API_KEY="your_key"          # if using mistral
-# export OPENAI_API_KEY="your_key"         # if using openai
-# export CONTRACTSPEC_AI_MODEL="model-id"  # optional override
-# export CONTRACTSPEC_AI_TEMPERATURE="0"   # default is 0 for determinism
-# export CONTRACTSPEC_AI_MAX_ATTEMPTS="2"  # retry invalid JSON
-bun tsx packages/examples/product-intent/src/script.ts
-```
+## Usage
 
-You should see evidence findings, problems, tickets, a patch intent generated by the AI provider, and a deterministic impact report.
-If validation fails, inspect the JSONL trace log and artifacts in `packages/examples/product-intent/logs/run-*/`.
+Use `@contractspec/example.product-intent` as a reference implementation, or import its exported surfaces into a workspace that composes ContractSpec examples and bundles.
 
-## Sync actions to project management tools
+## Architecture
 
-This example can convert tickets into shareable work items and sync them to Linear, Jira Cloud, or Notion:
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/load-evidence.test.ts` is part of the package's public or composition surface.
+- `src/load-evidence.ts` is part of the package's public or composition surface.
+- `src/posthog-signals.ts` is part of the package's public or composition surface.
+- `src/product-intent.discovery.ts` defines the exported product-intent spec.
+- `src/product-intent.feature.ts` defines a feature entrypoint.
 
-```bash
-export CONTRACTSPEC_PM_PROVIDER="linear" # or jira/notion
-export CONTRACTSPEC_PM_DRY_RUN="true"    # set to false to create real items
-export LINEAR_API_KEY="your_key"
-export LINEAR_TEAM_ID="team_id"
-export LINEAR_PROJECT_ID="project_id"    # optional
-export LINEAR_LABEL_IDS="label1,label2"  # optional
+## Public Entry Points
 
-# Jira Cloud
-# export JIRA_SITE_URL="https://acme.atlassian.net"
-# export JIRA_EMAIL="user@acme.com"
-# export JIRA_API_TOKEN="jira_token"
-# export JIRA_PROJECT_KEY="PM"
+- Export `.` resolves through `./src/index.ts`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/product-intent.docblock` resolves through `./src/docs/product-intent.docblock.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./load-evidence` resolves through `./src/load-evidence.ts`.
+- Export `./posthog-signals` resolves through `./src/posthog-signals.ts`.
+- Export `./product-intent.discovery` resolves through `./src/product-intent.discovery.ts`.
+- Export `./product-intent.feature` resolves through `./src/product-intent.feature.ts`.
+- Export `./script` resolves through `./src/script.ts`.
+- Export `./sync-actions` resolves through `./src/sync-actions.ts`.
+- The package publishes 9 total export subpaths; keep docs aligned with `package.json`.
 
-# Notion
-# export NOTION_API_KEY="secret"
-# export NOTION_DATABASE_ID="database_id"
-# export NOTION_SUMMARY_PARENT_PAGE_ID="parent_page_id" # optional
+## Local Commands
 
-bun tsx packages/examples/product-intent/src/sync-actions.ts
-```
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
+
+## Recent Updates
+
+- Replace eslint+prettier by biomejs to optimize speed.
+- Stability.
+- Missing contract layers.
+
+## Notes
+
+- Works alongside `@contractspec/integration.providers-impls`, `@contractspec/lib.ai-agent`, `@contractspec/lib.analytics`, `@contractspec/lib.contracts-integrations`, `@contractspec/lib.contracts-spec`, ...

package/dist/contracts.test.d.ts

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

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 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, } from './load-evidence';
-export { loadPosthogEvidenceChunks, resolvePosthogEvidenceOptionsFromEnv, } from './posthog-signals';
+export { 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/dist/index.js

@@ -31,8 +31,8 @@ var example = defineExample({
 var example_default = example;
 
 // 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);
@@ -337,6 +337,79 @@ async function loadEvidenceChunksWithSignals(options = {}) {
   return [...baseChunks, ...posthogChunks];
 }
 
+// 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"]
+      }
+    ]
+  }
+});
+
 // src/product-intent.feature.ts
 import { defineFeature } from "@contractspec/lib.contracts-spec";
 var ProductIntentFeature = defineFeature({
@@ -360,6 +433,7 @@ export {
   loadEvidenceChunks,
   example_default as example,
   ProductIntentFeature,
+  ProductIntentDiscoverySpec,
   DEFAULT_TRANSCRIPT_DIRS,
   DEFAULT_EVIDENCE_ROOT,
   DEFAULT_CHUNK_SIZE

package/dist/load-evidence.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/node/index.js

@@ -30,8 +30,8 @@ var example = defineExample({
 var example_default = example;
 
 // 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);
@@ -336,6 +336,79 @@ async function loadEvidenceChunksWithSignals(options = {}) {
   return [...baseChunks, ...posthogChunks];
 }
 
+// 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"]
+      }
+    ]
+  }
+});
+
 // src/product-intent.feature.ts
 import { defineFeature } from "@contractspec/lib.contracts-spec";
 var ProductIntentFeature = defineFeature({
@@ -359,6 +432,7 @@ export {
   loadEvidenceChunks,
   example_default as example,
   ProductIntentFeature,
+  ProductIntentDiscoverySpec,
   DEFAULT_TRANSCRIPT_DIRS,
   DEFAULT_EVIDENCE_ROOT,
   DEFAULT_CHUNK_SIZE

package/dist/node/load-evidence.js

@@ -1,6 +1,6 @@
 // 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/node/posthog-signals.js

@@ -1,6 +1,6 @@
 // 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/node/product-intent.discovery.js

@@ -0,0 +1,75 @@
+// 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/node/script.js

@@ -1,6 +1,6 @@
 // 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/node/sync-actions.js

@@ -1,6 +1,6 @@
 // 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);
@@ -306,6 +306,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,
@@ -315,9 +318,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/dist/posthog-signals.d.ts

@@ -1,6 +1,6 @@
+import type { FunnelDefinition } from '@contractspec/lib.analytics';
 import type { AnalyticsReader, DateRangeInput } from '@contractspec/lib.contracts-integrations';
 import type { EvidenceChunk } from '@contractspec/lib.contracts-spec/product-intent/types';
-import type { FunnelDefinition } from '@contractspec/lib.analytics';
 export interface PosthogEvidenceOptions {
     reader: AnalyticsReader;
     dateRange?: DateRangeInput;

package/dist/posthog-signals.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);