@contractspec/module.product-intent-core 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,17 @@
+# @contractspec/module.product-intent-core
+
+Website: https://contractspec.io/
+
+Core orchestration logic for the product-intent workflow. This module wires evidence retrieval, prompt execution, and validators into a deterministic discovery pipeline.
+
+## What it provides
+
+- A `ProductIntentOrchestrator` that runs the discovery loop end-to-end.
+- A keyword-based evidence fetcher for deterministic retrieval.
+- Type-safe interfaces for model runners and orchestration options.
+
+## Installation
+
+```bash
+bun add @contractspec/module.product-intent-core
+```

package/dist/evidence/keyword-retriever.d.ts

@@ -0,0 +1,16 @@
+import { EvidenceChunk } from "@contractspec/lib.contracts/product-intent/types";
+
+//#region src/evidence/keyword-retriever.d.ts
+interface KeywordEvidenceOptions {
+  minScore?: number;
+}
+declare const createKeywordEvidenceFetcher: (chunks: EvidenceChunk[], options?: KeywordEvidenceOptions) => ({
+  query,
+  maxChunks
+}: {
+  query: string;
+  maxChunks?: number;
+}) => Promise<EvidenceChunk[]>;
+//#endregion
+export { KeywordEvidenceOptions, createKeywordEvidenceFetcher };
+//# sourceMappingURL=keyword-retriever.d.ts.map

package/dist/evidence/keyword-retriever.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-retriever.d.ts","names":[],"sources":["../../src/evidence/keyword-retriever.ts"],"mappings":";;;UAEiB,sBAAA;EACf,QAAA;AAAA;AAAA,cAUW,4BAAA,GACV,MAAA,EAAQ,aAAA,IAAiB,OAAA,GAAS,sBAAA;EAC5B,KAAA;EAAA;AAAA;EAIL,KAAA;EACA,SAAA;AAAA,MACE,OAAA,CAAQ,aAAA"}

package/dist/evidence/keyword-retriever.js

@@ -0,0 +1,23 @@
+//#region src/evidence/keyword-retriever.ts
+const normalizeTokens = (value) => value.toLowerCase().split(/[^a-z0-9]+/g).map((token) => token.trim()).filter((token) => token.length > 2);
+const createKeywordEvidenceFetcher = (chunks, options = {}) => async ({ query, maxChunks }) => {
+	const tokens = normalizeTokens(query);
+	if (tokens.length === 0) return maxChunks ? chunks.slice(0, maxChunks) : [...chunks];
+	const scored = chunks.map((chunk) => {
+		const haystack = chunk.text.toLowerCase();
+		return {
+			chunk,
+			score: tokens.reduce((total, token) => total + (haystack.includes(token) ? 1 : 0), 0)
+		};
+	}).filter((item) => item.score >= (options.minScore ?? 1));
+	scored.sort((a, b) => {
+		if (b.score !== a.score) return b.score - a.score;
+		return a.chunk.chunkId.localeCompare(b.chunk.chunkId);
+	});
+	const results = scored.map((item) => item.chunk);
+	return maxChunks ? results.slice(0, maxChunks) : results;
+};
+
+//#endregion
+export { createKeywordEvidenceFetcher };
+//# sourceMappingURL=keyword-retriever.js.map

package/dist/evidence/keyword-retriever.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-retriever.js","names":[],"sources":["../../src/evidence/keyword-retriever.ts"],"sourcesContent":["import type { EvidenceChunk } from '@contractspec/lib.contracts/product-intent/types';\n\nexport interface KeywordEvidenceOptions {\n  minScore?: number;\n}\n\nconst normalizeTokens = (value: string): string[] =>\n  value\n    .toLowerCase()\n    .split(/[^a-z0-9]+/g)\n    .map((token) => token.trim())\n    .filter((token) => token.length > 2);\n\nexport const createKeywordEvidenceFetcher =\n  (chunks: EvidenceChunk[], options: KeywordEvidenceOptions = {}) =>\n  async ({\n    query,\n    maxChunks,\n  }: {\n    query: string;\n    maxChunks?: number;\n  }): Promise<EvidenceChunk[]> => {\n    const tokens = normalizeTokens(query);\n    if (tokens.length === 0) {\n      return maxChunks ? chunks.slice(0, maxChunks) : [...chunks];\n    }\n\n    const scored = chunks\n      .map((chunk) => {\n        const haystack = chunk.text.toLowerCase();\n        const score = tokens.reduce(\n          (total, token) => total + (haystack.includes(token) ? 1 : 0),\n          0\n        );\n        return { chunk, score };\n      })\n      .filter((item) => item.score >= (options.minScore ?? 1));\n\n    scored.sort((a, b) => {\n      if (b.score !== a.score) return b.score - a.score;\n      return a.chunk.chunkId.localeCompare(b.chunk.chunkId);\n    });\n\n    const results = scored.map((item) => item.chunk);\n    return maxChunks ? results.slice(0, maxChunks) : results;\n  };\n"],"mappings":";AAMA,MAAM,mBAAmB,UACvB,MACG,aAAa,CACb,MAAM,cAAc,CACpB,KAAK,UAAU,MAAM,MAAM,CAAC,CAC5B,QAAQ,UAAU,MAAM,SAAS,EAAE;AAExC,MAAa,gCACV,QAAyB,UAAkC,EAAE,KAC9D,OAAO,EACL,OACA,gBAI8B;CAC9B,MAAM,SAAS,gBAAgB,MAAM;AACrC,KAAI,OAAO,WAAW,EACpB,QAAO,YAAY,OAAO,MAAM,GAAG,UAAU,GAAG,CAAC,GAAG,OAAO;CAG7D,MAAM,SAAS,OACZ,KAAK,UAAU;EACd,MAAM,WAAW,MAAM,KAAK,aAAa;AAKzC,SAAO;GAAE;GAAO,OAJF,OAAO,QAClB,OAAO,UAAU,SAAS,SAAS,SAAS,MAAM,GAAG,IAAI,IAC1D,EACD;GACsB;GACvB,CACD,QAAQ,SAAS,KAAK,UAAU,QAAQ,YAAY,GAAG;AAE1D,QAAO,MAAM,GAAG,MAAM;AACpB,MAAI,EAAE,UAAU,EAAE,MAAO,QAAO,EAAE,QAAQ,EAAE;AAC5C,SAAO,EAAE,MAAM,QAAQ,cAAc,EAAE,MAAM,QAAQ;GACrD;CAEF,MAAM,UAAU,OAAO,KAAK,SAAS,KAAK,MAAM;AAChD,QAAO,YAAY,QAAQ,MAAM,GAAG,UAAU,GAAG"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { ProductIntentModelRunner, ProductIntentOrchestratorOptions, ProductIntentOrchestratorParams } from "./types.js";
+import { KeywordEvidenceOptions, createKeywordEvidenceFetcher } from "./evidence/keyword-retriever.js";
+import { ProductIntentOrchestrator } from "./orchestrator/product-intent-orchestrator.js";
+export { KeywordEvidenceOptions, ProductIntentModelRunner, ProductIntentOrchestrator, ProductIntentOrchestratorOptions, ProductIntentOrchestratorParams, createKeywordEvidenceFetcher };

package/dist/index.js

@@ -0,0 +1,4 @@
+import { createKeywordEvidenceFetcher } from "./evidence/keyword-retriever.js";
+import { ProductIntentOrchestrator } from "./orchestrator/product-intent-orchestrator.js";
+
+export { ProductIntentOrchestrator, createKeywordEvidenceFetcher };

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

@@ -0,0 +1,23 @@
+import { ProductIntentOrchestratorOptions, ProductIntentOrchestratorParams } from "../types.js";
+import { ContractPatchIntent, ContractSpecPatch, EvidenceChunk, ImpactReport, InsightExtraction, OpportunityBrief, TaskPack } from "@contractspec/lib.contracts/product-intent/types";
+import { ProductIntentRegistry } from "@contractspec/lib.contracts/product-intent/registry";
+import { ProductIntentSpec } from "@contractspec/lib.contracts/product-intent/spec";
+
+//#region src/orchestrator/product-intent-orchestrator.d.ts
+declare class ProductIntentOrchestrator<Context = unknown> {
+  private options;
+  private registry;
+  constructor(options: ProductIntentOrchestratorOptions<Context>, registry?: ProductIntentRegistry);
+  getRegistry(): ProductIntentRegistry;
+  runDiscovery(params: ProductIntentOrchestratorParams<Context>): Promise<ProductIntentSpec<Context>>;
+  protected extractInsights(question: string, evidence: EvidenceChunk[], _context?: Context): Promise<InsightExtraction>;
+  protected synthesiseBrief(question: string, insights: InsightExtraction, evidence: EvidenceChunk[], _context?: Context): Promise<OpportunityBrief>;
+  protected generatePatchIntent(brief: OpportunityBrief, _context?: Context): Promise<ContractPatchIntent>;
+  protected generatePatch(intent: ContractPatchIntent, baseSpecSnippet?: string): Promise<ContractSpecPatch>;
+  protected generateImpactReport(intent: ContractPatchIntent, _patch: ContractSpecPatch, _compilerOutputText?: string): Promise<ImpactReport>;
+  protected generateTasks(brief: OpportunityBrief, intent: ContractPatchIntent, impact: ImpactReport, repoContext?: string): Promise<TaskPack>;
+  private runModel;
+}
+//#endregion
+export { ProductIntentOrchestrator };
+//# sourceMappingURL=product-intent-orchestrator.d.ts.map

package/dist/orchestrator/product-intent-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-intent-orchestrator.d.ts","names":[],"sources":["../../src/orchestrator/product-intent-orchestrator.ts"],"mappings":";;;;;;cA+Ba,yBAAA;EAAA,QACH,OAAA;EAAA,QACA,QAAA;cAGN,OAAA,EAAS,gCAAA,CAAiC,OAAA,GAC1C,QAAA,GAAW,qBAAA;EAMb,WAAA,CAAA,GAAe,qBAAA;EAIT,YAAA,CACJ,MAAA,EAAQ,+BAAA,CAAgC,OAAA,IACvC,OAAA,CAAQ,iBAAA,CAAkB,OAAA;EAAA,UAwEb,eAAA,CACd,QAAA,UACA,QAAA,EAAU,aAAA,IACV,QAAA,GAAW,OAAA,GACV,OAAA,CAAQ,iBAAA;EAAA,UAOK,eAAA,CACd,QAAA,UACA,QAAA,EAAU,iBAAA,EACV,QAAA,EAAU,aAAA,IACV,QAAA,GAAW,OAAA,GACV,OAAA,CAAQ,gBAAA;EAAA,UAYK,mBAAA,CACd,KAAA,EAAO,gBAAA,EACP,QAAA,GAAW,OAAA,GACV,OAAA,CAAQ,mBAAA;EAAA,UAOK,aAAA,CACd,MAAA,EAAQ,mBAAA,EACR,eAAA,YACC,OAAA,CAAQ,iBAAA;EAAA,UAUK,oBAAA,CACd,MAAA,EAAQ,mBAAA,EACR,MAAA,EAAQ,iBAAA,EACR,mBAAA,YACC,OAAA,CAAQ,YAAA;EAAA,UAIK,aAAA,CACd,KAAA,EAAO,gBAAA,EACP,MAAA,EAAQ,mBAAA,EACR,MAAA,EAAQ,YAAA,EACR,WAAA,YACC,OAAA,CAAQ,QAAA;EAAA,QAcG,QAAA;AAAA"}

package/dist/orchestrator/product-intent-orchestrator.js

@@ -0,0 +1,97 @@
+import { ContractSpecPatchModel } from "@contractspec/lib.contracts/product-intent/types";
+import { ProductIntentRegistry } from "@contractspec/lib.contracts/product-intent/registry";
+import { formatEvidenceForModel, impactEngine, parseStrictJSON, promptExtractInsights, promptGenerateGenericSpecOverlay, promptGeneratePatchIntent, promptGenerateTaskPack, promptSynthesizeBrief, validateInsightExtraction, validateOpportunityBrief, validatePatchIntent, validateTaskPack } from "@contractspec/lib.product-intent-utils";
+
+//#region src/orchestrator/product-intent-orchestrator.ts
+var ProductIntentOrchestrator = class {
+	options;
+	registry;
+	constructor(options, registry) {
+		this.options = options;
+		this.registry = registry ?? new ProductIntentRegistry();
+	}
+	getRegistry() {
+		return this.registry;
+	}
+	async runDiscovery(params) {
+		const { id, meta, question, context } = params;
+		const maxEvidenceChunks = params.maxEvidenceChunks ?? this.options.maxEvidenceChunks ?? 20;
+		const spec = {
+			id,
+			meta,
+			question,
+			runtimeContext: context
+		};
+		const evidence = await this.options.fetchEvidence({
+			query: question,
+			maxChunks: maxEvidenceChunks,
+			context
+		});
+		const insights = await this.extractInsights(question, evidence, context);
+		spec.insights = insights;
+		if (this.options.onInsightsGenerated) await this.options.onInsightsGenerated(insights, context);
+		const brief = await this.synthesiseBrief(question, insights, evidence, context);
+		spec.brief = brief;
+		if (this.options.onBriefSynthesised) await this.options.onBriefSynthesised(brief, context);
+		const intent = await this.generatePatchIntent(brief, context);
+		spec.patchIntent = intent;
+		if (this.options.onPatchIntentGenerated) await this.options.onPatchIntentGenerated(intent, context);
+		const patch = await this.generatePatch(intent, params.baseSpecSnippet);
+		spec.patch = patch;
+		if (this.options.onPatchGenerated) await this.options.onPatchGenerated(patch, context);
+		const impact = await this.generateImpactReport(intent, patch, params.compilerOutputText);
+		spec.impact = impact;
+		if (this.options.onImpactGenerated) await this.options.onImpactGenerated(impact, context);
+		const tasks = await this.generateTasks(brief, intent, impact, params.repoContext);
+		spec.tasks = tasks;
+		if (this.options.onTasksGenerated) await this.options.onTasksGenerated(tasks, context);
+		this.registry.set(spec);
+		return spec;
+	}
+	async extractInsights(question, evidence, _context) {
+		const prompt = promptExtractInsights({
+			question,
+			evidenceJSON: formatEvidenceForModel(evidence)
+		});
+		return validateInsightExtraction(await this.runModel(prompt), evidence);
+	}
+	async synthesiseBrief(question, insights, evidence, _context) {
+		const prompt = promptSynthesizeBrief({
+			question,
+			insightsJSON: JSON.stringify(insights, null, 2),
+			allowedChunkIds: evidence.map((chunk) => chunk.chunkId)
+		});
+		return validateOpportunityBrief(await this.runModel(prompt), evidence);
+	}
+	async generatePatchIntent(brief, _context) {
+		const prompt = promptGeneratePatchIntent({ briefJSON: JSON.stringify(brief, null, 2) });
+		return validatePatchIntent(await this.runModel(prompt));
+	}
+	async generatePatch(intent, baseSpecSnippet) {
+		const patchIntentJSON = JSON.stringify(intent, null, 2);
+		const prompt = promptGenerateGenericSpecOverlay({
+			baseSpecSnippet: baseSpecSnippet ?? "",
+			patchIntentJSON
+		});
+		return parseStrictJSON(ContractSpecPatchModel, await this.runModel(prompt));
+	}
+	async generateImpactReport(intent, _patch, _compilerOutputText) {
+		return impactEngine(intent);
+	}
+	async generateTasks(brief, intent, impact, repoContext) {
+		const prompt = promptGenerateTaskPack({
+			briefJSON: JSON.stringify(brief, null, 2),
+			patchIntentJSON: JSON.stringify(intent, null, 2),
+			impactJSON: JSON.stringify(impact, null, 2),
+			repoContext
+		});
+		return validateTaskPack(await this.runModel(prompt));
+	}
+	async runModel(prompt) {
+		return this.options.modelRunner.generateJson(prompt);
+	}
+};
+
+//#endregion
+export { ProductIntentOrchestrator };
+//# sourceMappingURL=product-intent-orchestrator.js.map

package/dist/orchestrator/product-intent-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-intent-orchestrator.js","names":[],"sources":["../../src/orchestrator/product-intent-orchestrator.ts"],"sourcesContent":["import {\n  type ContractPatchIntent,\n  type ContractSpecPatch,\n  ContractSpecPatchModel,\n  type EvidenceChunk,\n  type ImpactReport,\n  type InsightExtraction,\n  type OpportunityBrief,\n  type TaskPack,\n} from '@contractspec/lib.contracts/product-intent/types';\nimport type { ProductIntentSpec } from '@contractspec/lib.contracts/product-intent/spec';\nimport { ProductIntentRegistry } from '@contractspec/lib.contracts/product-intent/registry';\nimport {\n  formatEvidenceForModel,\n  impactEngine,\n  parseStrictJSON,\n  promptExtractInsights,\n  promptGenerateGenericSpecOverlay,\n  promptGeneratePatchIntent,\n  promptGenerateTaskPack,\n  promptSynthesizeBrief,\n  validateInsightExtraction,\n  validateOpportunityBrief,\n  validatePatchIntent,\n  validateTaskPack,\n} from '@contractspec/lib.product-intent-utils';\nimport type {\n  ProductIntentOrchestratorOptions,\n  ProductIntentOrchestratorParams,\n} from '../types';\n\nexport class ProductIntentOrchestrator<Context = unknown> {\n  private options: ProductIntentOrchestratorOptions<Context>;\n  private registry: ProductIntentRegistry;\n\n  constructor(\n    options: ProductIntentOrchestratorOptions<Context>,\n    registry?: ProductIntentRegistry\n  ) {\n    this.options = options;\n    this.registry = registry ?? new ProductIntentRegistry();\n  }\n\n  getRegistry(): ProductIntentRegistry {\n    return this.registry;\n  }\n\n  async runDiscovery(\n    params: ProductIntentOrchestratorParams<Context>\n  ): Promise<ProductIntentSpec<Context>> {\n    const { id, meta, question, context } = params;\n    const maxEvidenceChunks =\n      params.maxEvidenceChunks ?? this.options.maxEvidenceChunks ?? 20;\n\n    const spec: ProductIntentSpec<Context> = {\n      id,\n      meta,\n      question,\n      runtimeContext: context,\n    };\n\n    const evidence = await this.options.fetchEvidence({\n      query: question,\n      maxChunks: maxEvidenceChunks,\n      context,\n    });\n\n    const insights = await this.extractInsights(question, evidence, context);\n    spec.insights = insights;\n    if (this.options.onInsightsGenerated) {\n      await this.options.onInsightsGenerated(insights, context);\n    }\n\n    const brief = await this.synthesiseBrief(\n      question,\n      insights,\n      evidence,\n      context\n    );\n    spec.brief = brief;\n    if (this.options.onBriefSynthesised) {\n      await this.options.onBriefSynthesised(brief, context);\n    }\n\n    const intent = await this.generatePatchIntent(brief, context);\n    spec.patchIntent = intent;\n    if (this.options.onPatchIntentGenerated) {\n      await this.options.onPatchIntentGenerated(intent, context);\n    }\n\n    const patch = await this.generatePatch(intent, params.baseSpecSnippet);\n    spec.patch = patch;\n    if (this.options.onPatchGenerated) {\n      await this.options.onPatchGenerated(patch, context);\n    }\n\n    const impact = await this.generateImpactReport(\n      intent,\n      patch,\n      params.compilerOutputText\n    );\n    spec.impact = impact;\n    if (this.options.onImpactGenerated) {\n      await this.options.onImpactGenerated(impact, context);\n    }\n\n    const tasks = await this.generateTasks(\n      brief,\n      intent,\n      impact,\n      params.repoContext\n    );\n    spec.tasks = tasks;\n    if (this.options.onTasksGenerated) {\n      await this.options.onTasksGenerated(tasks, context);\n    }\n\n    this.registry.set(spec);\n    return spec;\n  }\n\n  protected async extractInsights(\n    question: string,\n    evidence: EvidenceChunk[],\n    _context?: Context\n  ): Promise<InsightExtraction> {\n    const evidenceJSON = formatEvidenceForModel(evidence);\n    const prompt = promptExtractInsights({ question, evidenceJSON });\n    const raw = await this.runModel(prompt);\n    return validateInsightExtraction(raw, evidence);\n  }\n\n  protected async synthesiseBrief(\n    question: string,\n    insights: InsightExtraction,\n    evidence: EvidenceChunk[],\n    _context?: Context\n  ): Promise<OpportunityBrief> {\n    const insightsJSON = JSON.stringify(insights, null, 2);\n    const allowedChunkIds = evidence.map((chunk) => chunk.chunkId);\n    const prompt = promptSynthesizeBrief({\n      question,\n      insightsJSON,\n      allowedChunkIds,\n    });\n    const raw = await this.runModel(prompt);\n    return validateOpportunityBrief(raw, evidence);\n  }\n\n  protected async generatePatchIntent(\n    brief: OpportunityBrief,\n    _context?: Context\n  ): Promise<ContractPatchIntent> {\n    const briefJSON = JSON.stringify(brief, null, 2);\n    const prompt = promptGeneratePatchIntent({ briefJSON });\n    const raw = await this.runModel(prompt);\n    return validatePatchIntent(raw);\n  }\n\n  protected async generatePatch(\n    intent: ContractPatchIntent,\n    baseSpecSnippet?: string\n  ): Promise<ContractSpecPatch> {\n    const patchIntentJSON = JSON.stringify(intent, null, 2);\n    const prompt = promptGenerateGenericSpecOverlay({\n      baseSpecSnippet: baseSpecSnippet ?? '',\n      patchIntentJSON,\n    });\n    const raw = await this.runModel(prompt);\n    return parseStrictJSON<ContractSpecPatch>(ContractSpecPatchModel, raw);\n  }\n\n  protected async generateImpactReport(\n    intent: ContractPatchIntent,\n    _patch: ContractSpecPatch,\n    _compilerOutputText?: string\n  ): Promise<ImpactReport> {\n    return impactEngine(intent);\n  }\n\n  protected async generateTasks(\n    brief: OpportunityBrief,\n    intent: ContractPatchIntent,\n    impact: ImpactReport,\n    repoContext?: string\n  ): Promise<TaskPack> {\n    const briefJSON = JSON.stringify(brief, null, 2);\n    const patchIntentJSON = JSON.stringify(intent, null, 2);\n    const impactJSON = JSON.stringify(impact, null, 2);\n    const prompt = promptGenerateTaskPack({\n      briefJSON,\n      patchIntentJSON,\n      impactJSON,\n      repoContext,\n    });\n    const raw = await this.runModel(prompt);\n    return validateTaskPack(raw);\n  }\n\n  private async runModel(prompt: string): Promise<string> {\n    return this.options.modelRunner.generateJson(prompt);\n  }\n}\n"],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,35 @@
+import { ContractPatchIntent, ContractSpecPatch, EvidenceChunk, ImpactReport, InsightExtraction, OpportunityBrief, TaskPack } from "@contractspec/lib.contracts/product-intent/types";
+import { ProductIntentMeta } from "@contractspec/lib.contracts/product-intent/spec";
+
+//#region src/types.d.ts
+interface ProductIntentModelRunner {
+  generateJson: (prompt: string) => Promise<string>;
+}
+interface ProductIntentOrchestratorOptions<Context = unknown> {
+  fetchEvidence: (params: {
+    query: string;
+    maxChunks?: number;
+    context?: Context;
+  }) => Promise<EvidenceChunk[]>;
+  modelRunner: ProductIntentModelRunner;
+  maxEvidenceChunks?: number;
+  onInsightsGenerated?: (insights: InsightExtraction, ctx?: Context) => Promise<void>;
+  onBriefSynthesised?: (brief: OpportunityBrief, ctx?: Context) => Promise<void>;
+  onPatchIntentGenerated?: (intent: ContractPatchIntent, ctx?: Context) => Promise<void>;
+  onPatchGenerated?: (patch: ContractSpecPatch, ctx?: Context) => Promise<void>;
+  onImpactGenerated?: (impact: ImpactReport, ctx?: Context) => Promise<void>;
+  onTasksGenerated?: (tasks: TaskPack, ctx?: Context) => Promise<void>;
+}
+interface ProductIntentOrchestratorParams<Context = unknown> {
+  id: string;
+  meta: ProductIntentMeta;
+  question: string;
+  context?: Context;
+  maxEvidenceChunks?: number;
+  baseSpecSnippet?: string;
+  compilerOutputText?: string;
+  repoContext?: string;
+}
+//#endregion
+export { ProductIntentModelRunner, ProductIntentOrchestratorOptions, ProductIntentOrchestratorParams };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;;;UAWiB,wBAAA;EACf,YAAA,GAAe,MAAA,aAAmB,OAAA;AAAA;AAAA,UAGnB,gCAAA;EACf,aAAA,GAAgB,MAAA;IACd,KAAA;IACA,SAAA;IACA,OAAA,GAAU,OAAA;EAAA,MACN,OAAA,CAAQ,aAAA;EACd,WAAA,EAAa,wBAAA;EACb,iBAAA;EACA,mBAAA,IACE,QAAA,EAAU,iBAAA,EACV,GAAA,GAAM,OAAA,KACH,OAAA;EACL,kBAAA,IACE,KAAA,EAAO,gBAAA,EACP,GAAA,GAAM,OAAA,KACH,OAAA;EACL,sBAAA,IACE,MAAA,EAAQ,mBAAA,EACR,GAAA,GAAM,OAAA,KACH,OAAA;EACL,gBAAA,IAAoB,KAAA,EAAO,iBAAA,EAAmB,GAAA,GAAM,OAAA,KAAY,OAAA;EAChE,iBAAA,IAAqB,MAAA,EAAQ,YAAA,EAAc,GAAA,GAAM,OAAA,KAAY,OAAA;EAC7D,gBAAA,IAAoB,KAAA,EAAO,QAAA,EAAU,GAAA,GAAM,OAAA,KAAY,OAAA;AAAA;AAAA,UAGxC,+BAAA;EACf,EAAA;EACA,IAAA,EAAM,iBAAA;EACN,QAAA;EACA,OAAA,GAAU,OAAA;EACV,iBAAA;EACA,eAAA;EACA,kBAAA;EACA,WAAA;AAAA"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@contractspec/module.product-intent-core",
+  "version": "0.0.0-canary-20260206014742",
+  "description": "Core product intent orchestration and adapters",
+  "keywords": [
+    "contractspec",
+    "product-intent",
+    "module",
+    "discovery",
+    "pm",
+    "ai"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@contractspec/lib.contracts": "0.0.0-canary-20260206014742",
+    "@contractspec/lib.product-intent-utils": "0.0.0-canary-20260206014742"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "0.0.0-canary-20260206014742",
+    "@contractspec/tool.typescript": "0.0.0-canary-20260206014742",
+    "tsdown": "^0.20.3",
+    "typescript": "^5.9.3"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./*": "./*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/modules/product-intent-core"
+  },
+  "homepage": "https://contractspec.io"
+}