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

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

@@ -0,0 +1,91 @@
+$ tsdown
+ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/product-intent/tsdown.config.js 
+ℹ entry: src/example.ts, src/index.ts, src/load-evidence.ts, src/script.ts, src/sync-actions.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 16 files
+ℹ dist/script.js                6.38 kB │ gzip: 2.23 kB
+ℹ dist/sync-actions.js          5.71 kB │ gzip: 2.02 kB
+ℹ dist/load-evidence.js         2.31 kB │ gzip: 1.02 kB
+ℹ dist/example.js               0.81 kB │ gzip: 0.44 kB
+ℹ dist/index.js                 0.27 kB │ gzip: 0.15 kB
+ℹ dist/script.js.map           11.38 kB │ gzip: 3.65 kB
+ℹ dist/sync-actions.js.map     10.31 kB │ gzip: 3.30 kB
+ℹ dist/load-evidence.js.map     4.01 kB │ gzip: 1.65 kB
+ℹ dist/example.js.map           1.22 kB │ gzip: 0.63 kB
+ℹ dist/load-evidence.d.ts.map   0.25 kB │ gzip: 0.18 kB
+ℹ dist/example.d.ts.map         0.13 kB │ gzip: 0.13 kB
+ℹ dist/load-evidence.d.ts       0.75 kB │ gzip: 0.41 kB
+ℹ dist/index.d.ts               0.32 kB │ gzip: 0.17 kB
+ℹ dist/example.d.ts             0.25 kB │ gzip: 0.17 kB
+ℹ dist/script.d.ts              0.01 kB │ gzip: 0.03 kB
+ℹ dist/sync-actions.d.ts        0.01 kB │ gzip: 0.03 kB
+ℹ 16 files, total: 44.11 kB
+src/load-evidence.ts (1:15) [UNRESOLVED_IMPORT] Warning: Could not resolve 'node:fs' in src/load-evidence.ts
+   ╭─[ src/load-evidence.ts:1:16 ]
+   │
+ 1 │ import fs from 'node:fs';
+   │                ────┬────  
+   │                    ╰────── Module not found, treating it as an external dependency
+   │ 
+   │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+───╯
+
+src/load-evidence.ts (2:17) [UNRESOLVED_IMPORT] Warning: Could not resolve 'node:path' in src/load-evidence.ts
+   ╭─[ src/load-evidence.ts:2:18 ]
+   │
+ 2 │ import path from 'node:path';
+   │                  ─────┬─────  
+   │                       ╰─────── Module not found, treating it as an external dependency
+   │ 
+   │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+───╯
+
+src/load-evidence.ts (3:30) [UNRESOLVED_IMPORT] Warning: Could not resolve 'node:url' in src/load-evidence.ts
+   ╭─[ src/load-evidence.ts:3:31 ]
+   │
+ 3 │ import { fileURLToPath } from 'node:url';
+   │                               ─────┬────  
+   │                                    ╰────── Module not found, treating it as an external dependency
+   │ 
+   │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+───╯
+
+src/script.ts (1:15) [UNRESOLVED_IMPORT] Warning: Could not resolve 'node:fs' in src/script.ts
+   ╭─[ src/script.ts:1:16 ]
+   │
+ 1 │ import fs from 'node:fs';
+   │                ────┬────  
+   │                    ╰────── Module not found, treating it as an external dependency
+   │ 
+   │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+───╯
+
+src/script.ts (2:17) [UNRESOLVED_IMPORT] Warning: Could not resolve 'node:path' in src/script.ts
+   ╭─[ src/script.ts:2:18 ]
+   │
+ 2 │ import path from 'node:path';
+   │                  ─────┬─────  
+   │                       ╰─────── Module not found, treating it as an external dependency
+   │ 
+   │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+───╯
+
+✔ Build complete in 12262ms
+src/script.ts (3:30) [UNRESOLVED_IMPORT] Warning: Could not resolve 'node:url' in src/script.ts
+   ╭─[ src/script.ts:3:31 ]
+   │
+ 3 │ import { fileURLToPath } from 'node:url';
+   │                               ─────┬────  
+   │                                    ╰────── Module not found, treating it as an external dependency
+   │ 
+   │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+───╯
+
+[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
+  - tsdown:external (82%)
+  - rolldown-plugin-dts:generate (18%)
+See https://rolldown.rs/options/checks#plugintimings for more details.
+

package/.turbo/turbo-build.log

@@ -0,0 +1,92 @@
+$ bun build:types && bun build:bundle
+$ tsc --noEmit
+$ tsdown
+ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/product-intent/tsdown.config.js 
+ℹ entry: src/example.ts, src/index.ts, src/load-evidence.ts, src/script.ts, src/sync-actions.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/script.js                6.38 kB │ gzip: 2.23 kB
+ℹ dist/sync-actions.js          5.71 kB │ gzip: 2.02 kB
+ℹ dist/load-evidence.js         2.31 kB │ gzip: 1.02 kB
+ℹ dist/example.js               0.81 kB │ gzip: 0.44 kB
+ℹ dist/index.js                 0.27 kB │ gzip: 0.15 kB
+ℹ dist/script.js.map           11.38 kB │ gzip: 3.65 kB
+ℹ dist/sync-actions.js.map     10.31 kB │ gzip: 3.30 kB
+ℹ dist/load-evidence.js.map     4.01 kB │ gzip: 1.65 kB
+ℹ dist/example.js.map           1.22 kB │ gzip: 0.63 kB
+ℹ dist/load-evidence.d.ts.map   0.25 kB │ gzip: 0.18 kB
+ℹ dist/example.d.ts.map         0.13 kB │ gzip: 0.13 kB
+ℹ dist/load-evidence.d.ts       0.75 kB │ gzip: 0.41 kB
+ℹ dist/index.d.ts               0.32 kB │ gzip: 0.17 kB
+ℹ dist/example.d.ts             0.25 kB │ gzip: 0.17 kB
+ℹ dist/script.d.ts              0.01 kB │ gzip: 0.03 kB
+ℹ dist/sync-actions.d.ts        0.01 kB │ gzip: 0.03 kB
+ℹ 16 files, total: 44.11 kB
+src/load-evidence.ts (1:15) [UNRESOLVED_IMPORT] Warning: Could not resolve 'node:fs' in src/load-evidence.ts
+   ╭─[ src/load-evidence.ts:1:16 ]
+   │
+ 1 │ import fs from 'node:fs';
+   │                ────┬────  
+   │                    ╰────── Module not found, treating it as an external dependency
+   │ 
+   │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+───╯
+
+src/load-evidence.ts (2:17) [UNRESOLVED_IMPORT] Warning: Could not resolve 'node:path' in src/load-evidence.ts
+   ╭─[ src/load-evidence.ts:2:18 ]
+   │
+ 2 │ import path from 'node:path';
+   │                  ─────┬─────  
+   │                       ╰─────── Module not found, treating it as an external dependency
+   │ 
+   │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+───╯
+
+src/load-evidence.ts (3:30) [UNRESOLVED_IMPORT] Warning: Could not resolve 'node:url' in src/load-evidence.ts
+   ╭─[ src/load-evidence.ts:3:31 ]
+   │
+ 3 │ import { fileURLToPath } from 'node:url';
+   │                               ─────┬────  
+   │                                    ╰────── Module not found, treating it as an external dependency
+   │ 
+   │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+───╯
+
+src/script.ts (1:15) [UNRESOLVED_IMPORT] Warning: Could not resolve 'node:fs' in src/script.ts
+   ╭─[ src/script.ts:1:16 ]
+   │
+ 1 │ import fs from 'node:fs';
+   │                ────┬────  
+   │                    ╰────── Module not found, treating it as an external dependency
+   │ 
+   │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+───╯
+
+src/script.ts (2:17) [UNRESOLVED_IMPORT] Warning: Could not resolve 'node:path' in src/script.ts
+   ╭─[ src/script.ts:2:18 ]
+   │
+ 2 │ import path from 'node:path';
+   │                  ─────┬─────  
+   │                       ╰─────── Module not found, treating it as an external dependency
+   │ 
+   │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+───╯
+
+src/script.ts (3:30) [UNRESOLVED_IMPORT] Warning: Could not resolve 'node:url' in src/script.ts
+   ╭─[ src/script.ts:3:31 ]
+   │
+ 3 │ import { fileURLToPath } from 'node:url';
+   │                               ─────┬────  
+   │                                    ╰────── Module not found, treating it as an external dependency
+   │ 
+   │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+───╯
+
+[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
+  - rolldown-plugin-dts:generate (55%)
+  - tsdown:external (45%)
+See https://rolldown.rs/options/checks#plugintimings for more details.
+
+✔ Build complete in 9777ms

package/CHANGELOG.md

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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# Product Intent Example
+
+Website: https://contractspec.io/
+
+Minimal example showing a transcript-to-tickets workflow with evidence-backed citations and a deterministic impact report.
+
+## What it 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.
+
+## Running the script
+
+From the repository root:
+
+```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
+```
+
+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-*/`.
+
+## Sync actions to project management tools
+
+This example can convert tickets into shareable work items and sync them to Linear, Jira Cloud, or Notion:
+
+```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
+
+# 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"
+
+# Notion
+# export NOTION_API_KEY="secret"
+# export NOTION_DATABASE_ID="database_id"
+# export NOTION_SUMMARY_PARENT_PAGE_ID="parent_page_id" # optional
+
+bun tsx packages/examples/product-intent/src/sync-actions.ts
+```

package/dist/example.d.ts

@@ -0,0 +1,7 @@
+import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
+
+//#region src/example.d.ts
+declare const example: _contractspec_lib_contracts0.ExampleSpec;
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"mappings":";;;cAEM,OAAA,EAsBJ,4BAAA,CAtBW,WAAA"}

package/dist/example.js

@@ -0,0 +1,39 @@
+import { defineExample } from "@contractspec/lib.contracts";
+
+//#region src/example.ts
+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"
+		]
+	},
+	entrypoints: { packageName: "@contractspec/example.product-intent" },
+	surfaces: {
+		templates: false,
+		sandbox: {
+			enabled: false,
+			modes: []
+		},
+		studio: {
+			enabled: false,
+			installable: false
+		},
+		mcp: { enabled: false }
+	}
+});
+
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["import { defineExample } from '@contractspec/lib.contracts';\n\nconst example = defineExample({\n  meta: {\n    key: 'product-intent',\n    version: '1.0.0',\n    title: 'Product Intent Discovery',\n    description:\n      'Evidence ingestion and product-intent workflow for PM discovery.',\n    kind: 'script',\n    visibility: 'public',\n    stability: 'experimental',\n    owners: ['@platform.core'],\n    tags: ['product-intent', 'discovery', 'pm', 'evidence', 'llm'],\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.product-intent',\n  },\n  surfaces: {\n    templates: false,\n    sandbox: { enabled: false, modes: [] },\n    studio: { enabled: false, installable: false },\n    mcp: { enabled: false },\n  },\n});\n\nexport default example;\n"],"mappings":";;;AAEA,MAAM,UAAU,cAAc;CAC5B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,iBAAiB;EAC1B,MAAM;GAAC;GAAkB;GAAa;GAAM;GAAY;GAAM;EAC/D;CACD,aAAa,EACX,aAAa,wCACd;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAO,OAAO,EAAE;GAAE;EACtC,QAAQ;GAAE,SAAS;GAAO,aAAa;GAAO;EAC9C,KAAK,EAAE,SAAS,OAAO;EACxB;CACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import example from "./example.js";
+import { DEFAULT_CHUNK_SIZE, DEFAULT_EVIDENCE_ROOT, DEFAULT_TRANSCRIPT_DIRS, EvidenceLoadOptions, loadEvidenceChunks } from "./load-evidence.js";
+export { DEFAULT_CHUNK_SIZE, DEFAULT_EVIDENCE_ROOT, DEFAULT_TRANSCRIPT_DIRS, type EvidenceLoadOptions, example, loadEvidenceChunks };

package/dist/index.js

@@ -0,0 +1,4 @@
+import example from "./example.js";
+import { DEFAULT_CHUNK_SIZE, DEFAULT_EVIDENCE_ROOT, DEFAULT_TRANSCRIPT_DIRS, loadEvidenceChunks } from "./load-evidence.js";
+
+export { DEFAULT_CHUNK_SIZE, DEFAULT_EVIDENCE_ROOT, DEFAULT_TRANSCRIPT_DIRS, example, loadEvidenceChunks };

package/dist/load-evidence.d.ts

@@ -0,0 +1,19 @@
+import { EvidenceChunk } from "@contractspec/lib.contracts/product-intent/types";
+
+//#region src/load-evidence.d.ts
+declare const DEFAULT_EVIDENCE_ROOT: string;
+declare const DEFAULT_TRANSCRIPT_DIRS: string[];
+declare const DEFAULT_CHUNK_SIZE = 800;
+interface EvidenceLoadOptions {
+  evidenceRoot?: string;
+  transcriptDirs?: string[];
+  chunkSize?: number;
+}
+/**
+ * Load all transcript files under the given directories and return
+ * EvidenceChunk objects ready for prompt formatting.
+ */
+declare function loadEvidenceChunks(options?: EvidenceLoadOptions): EvidenceChunk[];
+//#endregion
+export { DEFAULT_CHUNK_SIZE, DEFAULT_EVIDENCE_ROOT, DEFAULT_TRANSCRIPT_DIRS, EvidenceLoadOptions, loadEvidenceChunks };
+//# sourceMappingURL=load-evidence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"load-evidence.d.ts","names":[],"sources":["../src/load-evidence.ts"],"mappings":";;;cAOa,qBAAA;AAAA,cACA,uBAAA;AAAA,cACA,kBAAA;AAAA,UAEI,mBAAA;EACf,YAAA;EACA,cAAA;EACA,SAAA;AAAA;;;;;iBAyCc,kBAAA,CACd,OAAA,GAAS,mBAAA,GACR,aAAA"}

package/dist/load-evidence.js

@@ -0,0 +1,68 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+//#region src/load-evidence.ts
+const MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
+const DEFAULT_EVIDENCE_ROOT = path.join(MODULE_DIR, "../evidence");
+const DEFAULT_TRANSCRIPT_DIRS = [
+	"interviews",
+	"tickets",
+	"public"
+];
+const DEFAULT_CHUNK_SIZE = 800;
+/**
+* Remove YAML front matter from a file. Synthetic interview and ticket
+* files include a YAML header delimited by triple dashes.
+*/
+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();
+}
+/**
+* Split a transcript into fixed-size chunks.
+*/
+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;
+}
+/**
+* Load all transcript files under the given directories and return
+* EvidenceChunk objects ready for prompt formatting.
+*/
+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)) {
+			if (path.extname(fileName).toLowerCase() !== ".md") continue;
+			const filePath = path.join(fullDir, fileName);
+			const withoutFrontMatter = stripYamlFrontMatter(fs.readFileSync(filePath, "utf8"));
+			const baseId = path.parse(fileName).name;
+			const fileChunks = chunkTranscript(baseId, withoutFrontMatter, chunkSize);
+			chunks.push(...fileChunks);
+		}
+	}
+	return chunks;
+}
+
+//#endregion
+export { DEFAULT_CHUNK_SIZE, DEFAULT_EVIDENCE_ROOT, DEFAULT_TRANSCRIPT_DIRS, loadEvidenceChunks };
+//# sourceMappingURL=load-evidence.js.map

package/dist/load-evidence.js.map

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

package/dist/script.d.ts

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

package/dist/script.js

@@ -0,0 +1,171 @@
+import { loadEvidenceChunks } from "./load-evidence.js";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { createAgentJsonRunner } from "@contractspec/lib.ai-agent";
+import { extractEvidence, generateTickets, groupProblems, impactEngine, suggestPatch } from "@contractspec/lib.product-intent-utils";
+
+//#region src/script.ts
+const QUESTION = "Which activation and onboarding friction should we prioritize next?";
+const DEFAULT_PROVIDER = "openai";
+const DEFAULT_MODEL = "gpt-5.2";
+const DEFAULT_TEMPERATURE = 0;
+const DEFAULT_MAX_ATTEMPTS = 2;
+const MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
+const REPO_ROOT = path.resolve(MODULE_DIR, "../../../..");
+const REPO_SCAN_FILES = [
+	"packages/examples/product-intent/src/load-evidence.ts",
+	"packages/examples/product-intent/src/script.ts",
+	"packages/libs/contracts/src/product-intent/contract-patch-intent.ts",
+	"packages/libs/contracts/src/product-intent/spec.ts",
+	"packages/libs/product-intent-utils/src/impact-engine.ts"
+];
+function collectRepoFiles(root, files) {
+	const collected = [];
+	for (const relativePath of files) {
+		const fullPath = path.join(root, relativePath);
+		if (!fs.existsSync(fullPath)) continue;
+		const content = fs.readFileSync(fullPath, "utf8");
+		collected.push({
+			path: relativePath,
+			content
+		});
+	}
+	return collected;
+}
+function resolveProviderName() {
+	const raw = process.env.CONTRACTSPEC_AI_PROVIDER ?? process.env.AI_PROVIDER ?? DEFAULT_PROVIDER;
+	const normalized = raw.toLowerCase();
+	const allowed = [
+		"openai",
+		"anthropic",
+		"mistral",
+		"gemini",
+		"ollama"
+	];
+	if (!allowed.includes(normalized)) throw new Error(`Unsupported AI provider '${raw}'. Allowed: ${allowed.join(", ")}`);
+	return normalized;
+}
+function resolveApiKey(provider) {
+	switch (provider) {
+		case "openai": return process.env.OPENAI_API_KEY;
+		case "anthropic": return process.env.ANTHROPIC_API_KEY;
+		case "mistral": return process.env.MISTRAL_API_KEY;
+		case "gemini": return process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY;
+		case "ollama": return;
+	}
+}
+function resolveTemperature() {
+	const raw = process.env.CONTRACTSPEC_AI_TEMPERATURE ?? process.env.AI_TEMPERATURE;
+	if (!raw) return DEFAULT_TEMPERATURE;
+	const value = Number.parseFloat(raw);
+	return Number.isNaN(value) ? DEFAULT_TEMPERATURE : value;
+}
+function resolveMaxAttempts() {
+	const raw = process.env.CONTRACTSPEC_AI_MAX_ATTEMPTS ?? process.env.AI_MAX_ATTEMPTS;
+	if (!raw) return DEFAULT_MAX_ATTEMPTS;
+	const value = Number.parseInt(raw, 10);
+	return Number.isNaN(value) ? DEFAULT_MAX_ATTEMPTS : Math.max(1, value);
+}
+function writeArtifact(dir, name, contents) {
+	const filePath = path.join(dir, name);
+	fs.writeFileSync(filePath, contents, "utf8");
+	return filePath;
+}
+function createPipelineLogger(logDir, runId) {
+	const tracePath = path.join(logDir, "trace.jsonl");
+	return { log(entry) {
+		const baseName = `${entry.stage}-attempt-${entry.attempt}-${entry.phase}`;
+		const payload = {
+			runId,
+			stage: entry.stage,
+			phase: entry.phase,
+			attempt: entry.attempt,
+			timestamp: entry.timestamp
+		};
+		if (entry.prompt) payload.promptPath = path.relative(REPO_ROOT, writeArtifact(logDir, `${baseName}.prompt.txt`, entry.prompt));
+		if (entry.response) payload.responsePath = path.relative(REPO_ROOT, writeArtifact(logDir, `${baseName}.response.txt`, entry.response));
+		if (entry.error) payload.errorPath = path.relative(REPO_ROOT, writeArtifact(logDir, `${baseName}.error.txt`, entry.error));
+		fs.appendFileSync(tracePath, `${JSON.stringify(payload)}\n`, "utf8");
+	} };
+}
+async function main() {
+	const provider = resolveProviderName();
+	const temperature = resolveTemperature();
+	const maxAttempts = resolveMaxAttempts();
+	const apiKey = resolveApiKey(provider);
+	const proxyUrl = process.env.CONTRACTSPEC_AI_PROXY_URL;
+	const organizationId = process.env.CONTRACTSPEC_ORG_ID;
+	const baseUrl = process.env.OLLAMA_BASE_URL;
+	const model = process.env.CONTRACTSPEC_AI_MODEL ?? process.env.AI_MODEL ?? (provider === "mistral" ? DEFAULT_MODEL : void 0);
+	if (provider !== "ollama" && !apiKey && !proxyUrl && !organizationId) throw new Error(`Missing API credentials for ${provider}. Set the provider API key or CONTRACTSPEC_AI_PROXY_URL.`);
+	const runId = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+	const logDir = path.join(MODULE_DIR, "../logs", `run-${runId}`);
+	fs.mkdirSync(logDir, { recursive: true });
+	const logger = createPipelineLogger(logDir, runId);
+	const modelRunner = await createAgentJsonRunner({
+		provider: {
+			provider,
+			model,
+			apiKey,
+			baseUrl,
+			proxyUrl,
+			organizationId
+		},
+		temperature,
+		system: "You are a product discovery analyst. Respond with strict JSON only and use exact quotes for citations."
+	});
+	console.log(`AI provider: ${provider}`);
+	console.log(`Model: ${model ?? "(provider default)"}`);
+	console.log(`Temperature: ${temperature}`);
+	console.log(`Max attempts: ${maxAttempts}`);
+	console.log(`Trace log: ${path.relative(REPO_ROOT, logDir)}/trace.jsonl`);
+	const evidenceChunks = loadEvidenceChunks();
+	console.log(`Loaded ${evidenceChunks.length} evidence chunks`);
+	const findings = await extractEvidence(evidenceChunks, QUESTION, {
+		maxFindings: 12,
+		modelRunner,
+		logger,
+		maxAttempts
+	});
+	console.log("\nEvidence findings:\n");
+	console.log(JSON.stringify(findings, null, 2));
+	const problems = await groupProblems(findings, QUESTION, {
+		modelRunner,
+		logger,
+		maxAttempts
+	});
+	console.log("\nProblems:\n");
+	console.log(JSON.stringify(problems, null, 2));
+	const tickets = await generateTickets(problems, findings, QUESTION, {
+		modelRunner,
+		logger,
+		maxAttempts
+	});
+	console.log("\nTickets:\n");
+	console.log(JSON.stringify(tickets, null, 2));
+	if (!tickets[0]) {
+		console.log("\nNo tickets generated.");
+		return;
+	}
+	const patchIntent = await suggestPatch(tickets[0], {
+		modelRunner,
+		logger,
+		maxAttempts
+	});
+	console.log("\nPatch intent:\n");
+	console.log(JSON.stringify(patchIntent, null, 2));
+	const impact = impactEngine(patchIntent, {
+		repoFiles: collectRepoFiles(REPO_ROOT, REPO_SCAN_FILES),
+		maxHitsPerChange: 3
+	});
+	console.log("\nImpact report (deterministic):\n");
+	console.log(JSON.stringify(impact, null, 2));
+}
+main().catch((error) => {
+	console.error(error);
+	process.exitCode = 1;
+});
+
+//#endregion
+//# sourceMappingURL=script.js.map