@contractspec/lib.evolution 3.7.5 → 3.7.7

package/README.md

@@ -1,53 +1,65 @@
 # @contractspec/lib.evolution
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
+**AI-powered contract evolution engine.**
 
-**Safe regeneration for ContractSpec** — Evolve specs automatically while preserving invariants.
+## What It Provides
 
-Auto-evolution utilities that analyze telemetry, suggest spec improvements, and route changes through approval workflows. Regenerate code safely, one module at a time.
+- **Layer**: lib.
+- **Consumers**: example-shared-ui, bundles.
+- **Key dependencies**: ai-agent, contracts-spec, lifecycle, observability, schema.
+- Related ContractSpec packages include `@contractspec/lib.ai-agent`, `@contractspec/lib.ai-providers`, `@contractspec/lib.contracts-integrations`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.lifecycle`, `@contractspec/lib.observability`, ...
 
-## Capabilities:
-
-- Analyze telemetry to find anomalous specs
-- Convert detected intent into spec suggestions
-- Route suggestions through the AI approval workflow
-- Persist approved specs back into the codebase
-
-> Phase 3 anchor library – pairs with `@contractspec/lib.observability` and `@contractspec/lib.growth`.
-
-## Usage
-
-```ts
-import {
-  SpecAnalyzer,
-  SpecGenerator,
-  SpecSuggestionOrchestrator,
-} from '@contractspec/lib.evolution';
-
-const analyzer = new SpecAnalyzer();
-const stats = analyzer.analyzeSpecUsage(samples);
-const anomalies = analyzer.detectAnomalies(stats);
-
-const generator = new SpecGenerator({ getSpec });
-const suggestion = generator.generateFromIntent(anomalies[0]);
-
-await orchestrator.submit(suggestion, { agent: 'auto-evolve' });
-```
-
-See `app/docs/libraries/evolution` in `@contractspec/app.web-contractspec-landing` for full docs.
+## Installation
 
+`npm install @contractspec/lib.evolution`
 
+or
 
+`bun add @contractspec/lib.evolution`
 
+## Usage
 
+Import the root entrypoint from `@contractspec/lib.evolution`, or choose a documented subpath when you only need one part of the package surface.
 
+## Architecture
 
+- `src/analyzer` is part of the package's public or composition surface.
+- `src/approval` is part of the package's public or composition surface.
+- `src/generator` is part of the package's public or composition surface.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `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 --pass-with-no-tests
+- `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.
+- Add changesets and apply pending fixes.
+- Resolve lint, build, and type errors across nine packages.
+- Add AI provider ranking system with ranking-driven model selection.
 
+## Notes
 
+- Evolution strategies affect contract migration paths; changes can break existing migrations.
+- Depends on multiple core libs — verify compatibility when updating any dependency.
+- Strategy selection logic must remain deterministic and auditable.

package/dist/analyzer/spec-analyzer.d.ts

@@ -1,5 +1,5 @@
-import { Logger } from '@contractspec/lib.observability';
 import { LifecycleStage } from '@contractspec/lib.lifecycle';
+import { Logger } from '@contractspec/lib.observability';
 import { type IntentPattern, type OperationMetricSample, type OptimizationHint, type SpecAnomaly, type SpecUsageStats } from '../types';
 export interface SpecAnalyzerOptions {
     logger?: Logger;

package/dist/generator/ai-spec-generator.d.ts

@@ -1,5 +1,5 @@
+import type { ModelSelectionContext, ModelSelector } from '@contractspec/lib.ai-providers/selector-types';
 import type { LanguageModel } from 'ai';
-import type { ModelSelector, ModelSelectionContext } from '@contractspec/lib.ai-providers/selector-types';
 import type { EvolutionConfig, IntentPattern, SpecSuggestion } from '../types';
 /**
  * Configuration for the AI-powered spec generator.

package/dist/generator/spec-generator.d.ts

@@ -1,6 +1,6 @@
 import type { AnyOperationSpec, OperationSpec, ResourceRefDescriptor } from '@contractspec/lib.contracts-spec';
-import type { AnySchemaModel } from '@contractspec/lib.schema';
 import { Logger } from '@contractspec/lib.observability';
+import type { AnySchemaModel } from '@contractspec/lib.schema';
 import { type EvolutionConfig, type IntentPattern, type OperationCoordinate, type SpecSuggestion, type SpecSuggestionProposal, type SuggestionStatus } from '../types';
 export interface SpecGeneratorOptions {
     config?: EvolutionConfig;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export * from './types';
-export * from './analyzer/spec-analyzer';
 export * from './analyzer/posthog-telemetry-reader';
-export * from './generator/spec-generator';
-export * from './generator/ai-spec-generator';
+export * from './analyzer/spec-analyzer';
 export * from './approval/integration';
+export * from './generator/ai-spec-generator';
+export * from './generator/spec-generator';
+export * from './types';