@contractspec/module.product-intent-core 3.7.6 → 3.7.7

package/README.md

@@ -1,17 +1,61 @@
 # @contractspec/module.product-intent-core
 
-Website: https://contractspec.io/
+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.
+**Core product intent orchestration and adapters.**
 
-## What it provides
+## 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.
+- **Layer**: module.
+- **Consumers**: bundles (contractspec-studio), apps (web-landing).
+- Related ContractSpec packages include `@contractspec/lib.contracts-spec`, `@contractspec/lib.product-intent-utils`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
+- Related ContractSpec packages include `@contractspec/lib.contracts-spec`, `@contractspec/lib.product-intent-utils`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
 
 ## Installation
 
-```bash
-bun add @contractspec/module.product-intent-core
-```
+`npm install @contractspec/module.product-intent-core`
+
+or
+
+`bun add @contractspec/module.product-intent-core`
+
+## Usage
+
+Import the root entrypoint from `@contractspec/module.product-intent-core`, or choose a documented subpath when you only need one part of the package surface.
+
+## Architecture
+
+- `src/evidence/` contains evidence ingestion and normalization helpers.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/orchestrator` is part of the package's public or composition surface.
+- `src/types.ts` is shared public type definitions.
+
+## Public Entry Points
+
+- Export `.` resolves through `./src/index.ts`.
+
+## Local Commands
+
+- `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.
+
+## Notes
+
+- Depends on `lib.product-intent-utils` for shared utilities -- keep orchestration logic here, primitives in the lib.
+- Intent resolution must be idempotent; re-processing the same input should yield the same spec output.
+- Adapter interfaces are the extension point; new integrations go through the adapter pattern.

package/dist/browser/index.js

@@ -22,10 +22,10 @@ var createKeywordEvidenceFetcher = (chunks, options = {}) => async ({
   return maxChunks ? results.slice(0, maxChunks) : results;
 };
 // src/orchestrator/product-intent-orchestrator.ts
+import { ProductIntentRegistry } from "@contractspec/lib.contracts-spec/product-intent/registry";
 import {
   ContractSpecPatchModel
 } from "@contractspec/lib.contracts-spec/product-intent/types";
-import { ProductIntentRegistry } from "@contractspec/lib.contracts-spec/product-intent/registry";
 import {
   formatEvidenceForModel,
   impactEngine,

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export * from './types';
 export * from './evidence/keyword-retriever';
 export * from './orchestrator/product-intent-orchestrator';
+export * from './types';

package/dist/index.js

@@ -23,10 +23,10 @@ var createKeywordEvidenceFetcher = (chunks, options = {}) => async ({
   return maxChunks ? results.slice(0, maxChunks) : results;
 };
 // src/orchestrator/product-intent-orchestrator.ts
+import { ProductIntentRegistry } from "@contractspec/lib.contracts-spec/product-intent/registry";
 import {
   ContractSpecPatchModel
 } from "@contractspec/lib.contracts-spec/product-intent/types";
-import { ProductIntentRegistry } from "@contractspec/lib.contracts-spec/product-intent/registry";
 import {
   formatEvidenceForModel,
   impactEngine,

package/dist/node/index.js

@@ -22,10 +22,10 @@ var createKeywordEvidenceFetcher = (chunks, options = {}) => async ({
   return maxChunks ? results.slice(0, maxChunks) : results;
 };
 // src/orchestrator/product-intent-orchestrator.ts
+import { ProductIntentRegistry } from "@contractspec/lib.contracts-spec/product-intent/registry";
 import {
   ContractSpecPatchModel
 } from "@contractspec/lib.contracts-spec/product-intent/types";
-import { ProductIntentRegistry } from "@contractspec/lib.contracts-spec/product-intent/registry";
 import {
   formatEvidenceForModel,
   impactEngine,

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

@@ -1,6 +1,6 @@
-import { type ContractPatchIntent, type ContractSpecPatch, type EvidenceChunk, type ImpactReport, type InsightExtraction, type OpportunityBrief, type TaskPack } from '@contractspec/lib.contracts-spec/product-intent/types';
-import type { ProductIntentSpec } from '@contractspec/lib.contracts-spec/product-intent/spec';
 import { ProductIntentRegistry } from '@contractspec/lib.contracts-spec/product-intent/registry';
+import type { ProductIntentSpec } from '@contractspec/lib.contracts-spec/product-intent/spec';
+import { type ContractPatchIntent, type ContractSpecPatch, type EvidenceChunk, type ImpactReport, type InsightExtraction, type OpportunityBrief, type TaskPack } from '@contractspec/lib.contracts-spec/product-intent/types';
 import type { ProductIntentOrchestratorOptions, ProductIntentOrchestratorParams } from '../types';
 export declare class ProductIntentOrchestrator<Context = unknown> {
     private options;

package/dist/types.d.ts

@@ -1,6 +1,5 @@
-import type { EvidenceChunk } from '@contractspec/lib.contracts-spec/product-intent/types';
 import type { ProductIntentMeta } from '@contractspec/lib.contracts-spec/product-intent/spec';
-import type { ContractPatchIntent, ContractSpecPatch, ImpactReport, InsightExtraction, OpportunityBrief, TaskPack } from '@contractspec/lib.contracts-spec/product-intent/types';
+import type { ContractPatchIntent, ContractSpecPatch, EvidenceChunk, ImpactReport, InsightExtraction, OpportunityBrief, TaskPack } from '@contractspec/lib.contracts-spec/product-intent/types';
 export interface ProductIntentModelRunner {
     generateJson: (prompt: string) => Promise<string>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/module.product-intent-core",
-  "version": "3.7.6",
+  "version": "3.7.7",
   "description": "Core product intent orchestration and adapters",
   "keywords": [
     "contractspec",
@@ -25,15 +25,15 @@
     "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.product-intent-utils": "3.7.6"
+    "@contractspec/lib.contracts-spec": "4.0.0",
+    "@contractspec/lib.product-intent-utils": "3.7.7"
   },
   "devDependencies": {
     "@contractspec/tool.typescript": "3.7.6",