@contractspec/lib.evolution 1.44.0

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { AnomalySeverity, EvolutionConfig, IntentPattern, OperationCoordinate, OperationMetricSample, OptimizationHint, PatternConfidence, SpecAnomaly, SpecSuggestion, SpecSuggestionFilters, SpecSuggestionProposal, SpecSuggestionRepository, SpecSuggestionWriter, SpecUsageStats, SuggestionEvidence, SuggestionStatus } from "./types.js";
+import { SpecAnalyzer, SpecAnalyzerOptions } from "./analyzer/spec-analyzer.js";
+import { GenerateSpecOptions, SpecGenerator, SpecGeneratorOptions, SpecPatch } from "./generator/spec-generator.js";
+import { AISpecGenerator, AISpecGeneratorConfig, createAISpecGenerator } from "./generator/ai-spec-generator.js";
+import { FileSystemSuggestionWriter, FileSystemSuggestionWriterOptions, InMemorySpecSuggestionRepository, SpecSuggestionOrchestrator, SpecSuggestionOrchestratorOptions } from "./approval/integration.js";
+export { AISpecGenerator, AISpecGeneratorConfig, AnomalySeverity, EvolutionConfig, FileSystemSuggestionWriter, FileSystemSuggestionWriterOptions, GenerateSpecOptions, InMemorySpecSuggestionRepository, IntentPattern, OperationCoordinate, OperationMetricSample, OptimizationHint, PatternConfidence, SpecAnalyzer, SpecAnalyzerOptions, SpecAnomaly, SpecGenerator, SpecGeneratorOptions, SpecPatch, SpecSuggestion, SpecSuggestionFilters, SpecSuggestionOrchestrator, SpecSuggestionOrchestratorOptions, SpecSuggestionProposal, SpecSuggestionRepository, SpecSuggestionWriter, SpecUsageStats, SuggestionEvidence, SuggestionStatus, createAISpecGenerator };

package/dist/index.js

@@ -0,0 +1,6 @@
+import { SpecAnalyzer } from "./analyzer/spec-analyzer.js";
+import { SpecGenerator } from "./generator/spec-generator.js";
+import { AISpecGenerator, createAISpecGenerator } from "./generator/ai-spec-generator.js";
+import { FileSystemSuggestionWriter, InMemorySpecSuggestionRepository, SpecSuggestionOrchestrator } from "./approval/integration.js";
+
+export { AISpecGenerator, FileSystemSuggestionWriter, InMemorySpecSuggestionRepository, SpecAnalyzer, SpecGenerator, SpecSuggestionOrchestrator, createAISpecGenerator };

package/dist/types.d.ts

@@ -0,0 +1,132 @@
+import { LifecycleStage } from "@contractspec/lib.lifecycle";
+import { OpKind, OperationSpec, ResourceRefDescriptor } from "@contractspec/lib.contracts";
+import { AnySchemaModel } from "@contractspec/lib.schema";
+
+//#region src/types.d.ts
+type AnomalySeverity = 'low' | 'medium' | 'high';
+type SuggestionStatus = 'pending' | 'approved' | 'rejected';
+interface OperationCoordinate {
+  key: string;
+  version: number;
+  tenantId?: string;
+}
+interface OperationMetricSample {
+  operation: OperationCoordinate;
+  durationMs: number;
+  success: boolean;
+  timestamp: Date;
+  payloadSizeBytes?: number;
+  errorCode?: string;
+  errorMessage?: string;
+  actor?: string;
+  channel?: string;
+  traceId?: string;
+  metadata?: Record<string, unknown>;
+}
+interface SpecUsageStats {
+  operation: OperationCoordinate;
+  totalCalls: number;
+  successRate: number;
+  errorRate: number;
+  averageLatencyMs: number;
+  p95LatencyMs: number;
+  p99LatencyMs: number;
+  maxLatencyMs: number;
+  lastSeenAt: Date;
+  windowStart: Date;
+  windowEnd: Date;
+  topErrors: Record<string, number>;
+}
+interface SuggestionEvidence {
+  type: 'telemetry' | 'user-feedback' | 'simulation' | 'test';
+  description: string;
+  data?: Record<string, unknown>;
+}
+interface SpecAnomaly {
+  operation: OperationCoordinate;
+  severity: AnomalySeverity;
+  metric: 'latency' | 'error-rate' | 'throughput' | 'policy' | 'schema';
+  description: string;
+  detectedAt: Date;
+  threshold?: number;
+  observedValue?: number;
+  evidence: SuggestionEvidence[];
+}
+interface PatternConfidence {
+  score: number;
+  sampleSize: number;
+  pValue?: number;
+}
+interface IntentPattern {
+  id: string;
+  type: 'latency-regression' | 'error-spike' | 'missing-operation' | 'chained-intent' | 'throughput-drop' | 'schema-mismatch';
+  description: string;
+  operation?: OperationCoordinate;
+  confidence: PatternConfidence;
+  metadata?: Record<string, unknown>;
+  evidence: SuggestionEvidence[];
+}
+interface SpecSuggestionProposal {
+  summary: string;
+  rationale: string;
+  changeType: 'new-spec' | 'revision' | 'policy-update' | 'schema-update';
+  kind?: OpKind;
+  spec?: OperationSpec<AnySchemaModel, AnySchemaModel | ResourceRefDescriptor<boolean>>;
+  diff?: string;
+  metadata?: Record<string, unknown>;
+}
+interface SpecSuggestion {
+  id: string;
+  intent: IntentPattern;
+  target?: OperationCoordinate;
+  proposal: SpecSuggestionProposal;
+  confidence: number;
+  createdAt: Date;
+  createdBy: string;
+  status: SuggestionStatus;
+  evidence: SuggestionEvidence[];
+  priority: 'low' | 'medium' | 'high';
+  tags?: string[];
+  approvals?: {
+    reviewer?: string;
+    notes?: string;
+    decidedAt?: Date;
+    status?: SuggestionStatus;
+  };
+}
+interface EvolutionConfig {
+  minConfidence?: number;
+  autoApproveThreshold?: number;
+  maxSuggestionsPerOperation?: number;
+  requireApproval?: boolean;
+  maxConcurrentExperiments?: number;
+}
+interface SpecSuggestionFilters {
+  status?: SuggestionStatus;
+  operationKey?: string;
+}
+interface SpecSuggestionRepository {
+  create(suggestion: SpecSuggestion): Promise<void>;
+  getById(id: string): Promise<SpecSuggestion | undefined>;
+  updateStatus(id: string, status: SuggestionStatus, metadata?: {
+    reviewer?: string;
+    notes?: string;
+    decidedAt?: Date;
+  }): Promise<void>;
+  list(filters?: SpecSuggestionFilters): Promise<SpecSuggestion[]>;
+}
+interface SpecSuggestionWriter {
+  write(suggestion: SpecSuggestion): Promise<string>;
+}
+interface OptimizationHint {
+  operation: OperationCoordinate;
+  category: 'schema' | 'policy' | 'performance' | 'error-handling';
+  summary: string;
+  justification: string;
+  recommendedActions: string[];
+  lifecycleStage?: LifecycleStage;
+  lifecycleNotes?: string;
+}
+//#endregion
+export { AnomalySeverity, EvolutionConfig, IntentPattern, OperationCoordinate, OperationMetricSample, OptimizationHint, PatternConfidence, SpecAnomaly, SpecSuggestion, SpecSuggestionFilters, SpecSuggestionProposal, SpecSuggestionRepository, SpecSuggestionWriter, SpecUsageStats, SuggestionEvidence, SuggestionStatus };
+//# 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"],"sourcesContent":[],"mappings":";;;;;KAQY,eAAA;KACA,gBAAA;AADA,UAGK,mBAAA,CAHU;EACf,GAAA,EAAA,MAAA;EAEK,OAAA,EAAA,MAAA;EAMA,QAAA,CAAA,EAAA,MAAA;;AAIJ,UAJI,qBAAA,CAIJ;EAOA,SAAA,EAVA,mBAUA;EAAM,UAAA,EAAA,MAAA;EAGF,OAAA,EAAA,OAAA;EACJ,SAAA,EAXA,IAWA;EAQC,gBAAA,CAAA,EAAA,MAAA;EACC,SAAA,CAAA,EAAA,MAAA;EACF,YAAA,CAAA,EAAA,MAAA;EACA,KAAA,CAAA,EAAA,MAAA;EAAM,OAAA,CAAA,EAAA,MAAA;EAGF,OAAA,CAAA,EAAA,MAAA;EAMA,QAAA,CAAA,EAxBJ,MAwBe,CAAA,MAAA,EAAA,OAAA,CAAA;;AAEhB,UAvBK,cAAA,CAuBL;EAGE,SAAA,EAzBD,mBAyBC;EAGF,UAAA,EAAA,MAAA;EAAkB,WAAA,EAAA,MAAA;EAGb,SAAA,EAAA,MAAA;EAMA,gBAAa,EAAA,MAAA;EAUhB,YAAA,EAAA,MAAA;EACA,YAAA,EAAA,MAAA;EACD,YAAA,EAAA,MAAA;EACD,UAAA,EA1CE,IA0CF;EAAkB,WAAA,EAzCf,IAyCe;EAGb,SAAA,EA3CJ,IA2CI;EAIR,SAAA,EA9CI,MA8CJ,CAAA,MAAA,EAAA,MAAA,CAAA;;AAGL,UA9Ca,kBAAA,CA8Cb;EAAiB,IAAA,EAAA,WAAA,GAAA,eAAA,GAAA,YAAA,GAAA,MAAA;EAFZ,WAAA,EAAA,MAAA;EAKI,IAAA,CAAA,EA9CJ,MA8CI,CAAA,MAAA,EAAA,OAAA,CAAA;;AAGI,UA9CA,WAAA,CA8Cc;EAErB,SAAA,EA/CG,mBA+CH;EACC,QAAA,EA/CC,eA+CD;EACC,MAAA,EAAA,SAAA,GAAA,YAAA,GAAA,YAAA,GAAA,QAAA,GAAA,QAAA;EAEC,WAAA,EAAA,MAAA;EAEH,UAAA,EAjDI,IAiDJ;EACE,SAAA,CAAA,EAAA,MAAA;EAMI,aAAA,CAAA,EAAA,MAAA;EACH,QAAA,EAtDD,kBAsDC,EAAA;;AAII,UAvDA,iBAAA,CAuDe;EAQf,KAAA,EAAA,MAAA;EAKA,UAAA,EAAA,MAAA;EACI,MAAA,CAAA,EAAA,MAAA;;AACU,UAhEd,aAAA,CAgEc;EAAR,EAAA,EAAA,MAAA;EAGX,IAAA,EAAA,oBAAA,GAAA,aAAA,GAAA,mBAAA,GAAA,gBAAA,GAAA,iBAAA,GAAA,iBAAA;EACoD,WAAA,EAAA,MAAA;EAC3D,SAAA,CAAA,EA3DS,mBA2DT;EACY,UAAA,EA3DH,iBA2DG;EAAgC,QAAA,CAAA,EA1DpC,MA0DoC,CAAA,MAAA,EAAA,OAAA,CAAA;EAAR,QAAA,EAzD7B,kBAyD6B,EAAA;;AAGxB,UAzDA,sBAAA,CA0DG;EAGH,OAAA,EAAA,MAAA;;;SAzDR;SACA,cACL,gBACA,iBAAiB;;aAGR;;UAGI,cAAA;;UAEP;WACC;YACC;;aAEC;;UAEH;YACE;;;;;;gBAMI;aACH;;;UAII,eAAA;;;;;;;UAQA,qBAAA;WACN;;;UAIM,wBAAA;qBACI,iBAAiB;uBACf,QAAQ;mCAGnB;;;gBACoD;MAC3D;iBACY,wBAAwB,QAAQ;;UAGhC,oBAAA;oBACG,iBAAiB;;UAGpB,gBAAA;aACJ;;;;;mBAKM"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@contractspec/lib.evolution",
+  "version": "1.44.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "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": {
+    "ai": "6.0.3",
+    "zod": "^4.1.13",
+    "@contractspec/lib.ai-agent": "1.44.0",
+    "@contractspec/lib.contracts": "1.44.0",
+    "@contractspec/lib.lifecycle": "1.44.0",
+    "@contractspec/lib.observability": "1.44.0",
+    "@contractspec/lib.schema": "1.44.0"
+  },
+  "peerDependencies": {
+    "@prisma/client": "7.2.0"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "1.44.0",
+    "@contractspec/tool.typescript": "1.44.0",
+    "tsdown": "^0.18.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/libs/evolution"
+  },
+  "homepage": "https://contractspec.io"
+}