@contractspec/lib.evolution 1.56.1 → 1.58.0

package/dist/generator/ai-spec-generator.mjs

@@ -1,186 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { Output, generateText } from "ai";
-import * as z from "zod";
-
-//#region src/generator/ai-spec-generator.ts
-/**
-* Zod schema for AI-generated spec suggestions.
-*/
-const SpecSuggestionProposalSchema = z.object({
-	summary: z.string().describe("Brief summary of the proposed change"),
-	rationale: z.string().describe("Detailed explanation of why this change is needed"),
-	changeType: z.enum([
-		"new-spec",
-		"revision",
-		"policy-update",
-		"schema-update"
-	]).describe("Type of change being proposed"),
-	recommendedActions: z.array(z.string()).describe("List of specific actions to implement the change"),
-	estimatedImpact: z.enum([
-		"low",
-		"medium",
-		"high"
-	]).describe("Estimated impact of implementing this change"),
-	riskLevel: z.enum([
-		"low",
-		"medium",
-		"high"
-	]).describe("Risk level associated with this change"),
-	diff: z.string().optional().describe("Optional diff or code snippet showing the change")
-});
-/**
-* AI-powered spec generator using AI SDK v6.
-*
-* Uses structured output (Output.object) to generate
-* well-formed spec suggestions from intent patterns.
-*/
-var AISpecGenerator = class {
-	model;
-	config;
-	systemPrompt;
-	constructor(options) {
-		this.model = options.model;
-		this.config = options.evolutionConfig ?? {};
-		this.systemPrompt = options.systemPrompt ?? `You are a ContractSpec evolution expert. Your role is to analyze telemetry data, anomalies, and usage patterns to suggest improvements to API contracts and specifications.
-
-When generating suggestions:
-1. Be specific and actionable
-2. Consider backwards compatibility
-3. Prioritize stability and reliability
-4. Explain the rationale clearly
-5. Estimate impact and risk accurately`;
-	}
-	/**
-	* Generate a spec suggestion from an intent pattern using AI.
-	*/
-	async generateFromIntent(intent, options = {}) {
-		const prompt = this.buildPrompt(intent, options);
-		const { output } = await generateText({
-			model: this.model,
-			system: this.systemPrompt,
-			prompt,
-			output: Output.object({ schema: SpecSuggestionProposalSchema })
-		});
-		return this.buildSuggestion(intent, output);
-	}
-	/**
-	* Generate multiple suggestions for a batch of intents.
-	*/
-	async generateBatch(intents, options = {}) {
-		const maxConcurrent = options.maxConcurrent ?? 3;
-		const results = [];
-		for (let i = 0; i < intents.length; i += maxConcurrent) {
-			const batch = intents.slice(i, i + maxConcurrent);
-			const batchResults = await Promise.all(batch.map((intent) => this.generateFromIntent(intent)));
-			results.push(...batchResults);
-		}
-		return results;
-	}
-	/**
-	* Validate and enhance an existing suggestion using AI.
-	*/
-	async enhanceSuggestion(suggestion) {
-		const prompt = `Review and enhance this spec suggestion:
-
-Intent: ${suggestion.intent.type} - ${suggestion.intent.description}
-Current Summary: ${suggestion.proposal.summary}
-Current Rationale: ${suggestion.proposal.rationale}
-
-Evidence:
-${suggestion.evidence.map((e) => `- ${e.type}: ${e.description}`).join("\n")}
-
-Please provide an improved version with more specific recommendations.`;
-		const { output } = await generateText({
-			model: this.model,
-			system: this.systemPrompt,
-			prompt,
-			output: Output.object({ schema: SpecSuggestionProposalSchema })
-		});
-		return {
-			...suggestion,
-			proposal: {
-				...suggestion.proposal,
-				summary: output.summary,
-				rationale: output.rationale,
-				changeType: output.changeType,
-				diff: output.diff,
-				metadata: {
-					...suggestion.proposal.metadata,
-					aiEnhanced: true,
-					recommendedActions: output.recommendedActions,
-					estimatedImpact: output.estimatedImpact,
-					riskLevel: output.riskLevel
-				}
-			}
-		};
-	}
-	buildPrompt(intent, options) {
-		const parts = [
-			`Analyze this intent pattern and generate a spec suggestion:`,
-			``,
-			`Intent Type: ${intent.type}`,
-			`Description: ${intent.description}`,
-			`Confidence: ${(intent.confidence.score * 100).toFixed(0)}% (sample size: ${intent.confidence.sampleSize})`
-		];
-		if (intent.operation) parts.push(`Operation: ${intent.operation.key} v${intent.operation.version}`);
-		if (intent.evidence.length > 0) {
-			parts.push(``, `Evidence:`);
-			for (const evidence of intent.evidence) parts.push(`- [${evidence.type}] ${evidence.description}`);
-		}
-		if (intent.metadata) parts.push(``, `Metadata: ${JSON.stringify(intent.metadata, null, 2)}`);
-		if (options.existingSpec) parts.push(``, `Existing Spec:`, "```json", JSON.stringify(options.existingSpec, null, 2), "```");
-		if (options.additionalContext) parts.push(``, `Additional Context:`, options.additionalContext);
-		return parts.join("\n");
-	}
-	buildSuggestion(intent, aiOutput) {
-		const now = /* @__PURE__ */ new Date();
-		const proposal = {
-			summary: aiOutput.summary,
-			rationale: aiOutput.rationale,
-			changeType: aiOutput.changeType,
-			diff: aiOutput.diff,
-			metadata: {
-				aiGenerated: true,
-				recommendedActions: aiOutput.recommendedActions,
-				estimatedImpact: aiOutput.estimatedImpact,
-				riskLevel: aiOutput.riskLevel
-			}
-		};
-		return {
-			id: randomUUID(),
-			intent,
-			target: intent.operation,
-			proposal,
-			confidence: intent.confidence.score,
-			priority: this.calculatePriority(intent, aiOutput),
-			createdAt: now,
-			createdBy: "ai-spec-generator",
-			status: this.determineInitialStatus(intent),
-			evidence: intent.evidence,
-			tags: ["ai-generated", intent.type]
-		};
-	}
-	calculatePriority(intent, aiOutput) {
-		const impactScore = aiOutput.estimatedImpact === "high" ? 1 : aiOutput.estimatedImpact === "medium" ? .5 : .25;
-		const intentScore = intent.confidence.score;
-		const urgency = intent.type === "error-spike" ? .3 : intent.type === "latency-regression" ? .2 : 0;
-		const combined = impactScore * .4 + intentScore * .4 + urgency;
-		if (combined >= .7) return "high";
-		if (combined >= .4) return "medium";
-		return "low";
-	}
-	determineInitialStatus(intent) {
-		if (this.config.autoApproveThreshold && intent.confidence.score >= this.config.autoApproveThreshold && !this.config.requireApproval) return "approved";
-		return "pending";
-	}
-};
-/**
-* Create an AI-powered spec generator.
-*/
-function createAISpecGenerator(config) {
-	return new AISpecGenerator(config);
-}
-
-//#endregion
-export { AISpecGenerator, createAISpecGenerator };
-//# sourceMappingURL=ai-spec-generator.mjs.map

package/dist/generator/ai-spec-generator.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ai-spec-generator.mjs","names":[],"sources":["../../src/generator/ai-spec-generator.ts"],"sourcesContent":["import type { LanguageModel } from 'ai';\nimport { generateText, Output } from 'ai';\nimport * as z from 'zod';\nimport { randomUUID } from 'node:crypto';\nimport type {\n  EvolutionConfig,\n  IntentPattern,\n  SpecSuggestion,\n  SpecSuggestionProposal,\n  SuggestionStatus,\n} from '../types';\n\n/**\n * Zod schema for AI-generated spec suggestions.\n */\nconst SpecSuggestionProposalSchema = z.object({\n  summary: z.string().describe('Brief summary of the proposed change'),\n  rationale: z\n    .string()\n    .describe('Detailed explanation of why this change is needed'),\n  changeType: z\n    .enum(['new-spec', 'revision', 'policy-update', 'schema-update'])\n    .describe('Type of change being proposed'),\n  recommendedActions: z\n    .array(z.string())\n    .describe('List of specific actions to implement the change'),\n  estimatedImpact: z\n    .enum(['low', 'medium', 'high'])\n    .describe('Estimated impact of implementing this change'),\n  riskLevel: z\n    .enum(['low', 'medium', 'high'])\n    .describe('Risk level associated with this change'),\n  diff: z\n    .string()\n    .optional()\n    .describe('Optional diff or code snippet showing the change'),\n});\n\ntype AIGeneratedProposal = z.infer<typeof SpecSuggestionProposalSchema>;\n\n/**\n * Configuration for the AI-powered spec generator.\n */\nexport interface AISpecGeneratorConfig {\n  /** AI SDK language model */\n  model: LanguageModel;\n  /** Evolution configuration */\n  evolutionConfig?: EvolutionConfig;\n  /** Custom system prompt */\n  systemPrompt?: string;\n}\n\n/**\n * AI-powered spec generator using AI SDK v6.\n *\n * Uses structured output (Output.object) to generate\n * well-formed spec suggestions from intent patterns.\n */\nexport class AISpecGenerator {\n  private readonly model: LanguageModel;\n  private readonly config: EvolutionConfig;\n  private readonly systemPrompt: string;\n\n  constructor(options: AISpecGeneratorConfig) {\n    this.model = options.model;\n    this.config = options.evolutionConfig ?? {};\n    this.systemPrompt =\n      options.systemPrompt ??\n      `You are a ContractSpec evolution expert. Your role is to analyze telemetry data, anomalies, and usage patterns to suggest improvements to API contracts and specifications.\n\nWhen generating suggestions:\n1. Be specific and actionable\n2. Consider backwards compatibility\n3. Prioritize stability and reliability\n4. Explain the rationale clearly\n5. Estimate impact and risk accurately`;\n  }\n\n  /**\n   * Generate a spec suggestion from an intent pattern using AI.\n   */\n  async generateFromIntent(\n    intent: IntentPattern,\n    options: {\n      additionalContext?: string;\n      existingSpec?: Record<string, unknown>;\n    } = {}\n  ): Promise<SpecSuggestion> {\n    const prompt = this.buildPrompt(intent, options);\n\n    // AI SDK v6: Output.object() only takes { schema }\n    const { output } = await generateText({\n      model: this.model,\n      system: this.systemPrompt,\n      prompt,\n      output: Output.object({\n        schema: SpecSuggestionProposalSchema,\n      }),\n    });\n\n    return this.buildSuggestion(intent, output);\n  }\n\n  /**\n   * Generate multiple suggestions for a batch of intents.\n   */\n  async generateBatch(\n    intents: IntentPattern[],\n    options: { maxConcurrent?: number } = {}\n  ): Promise<SpecSuggestion[]> {\n    const maxConcurrent = options.maxConcurrent ?? 3;\n    const results: SpecSuggestion[] = [];\n\n    // Process in batches to avoid overwhelming the API\n    for (let i = 0; i < intents.length; i += maxConcurrent) {\n      const batch = intents.slice(i, i + maxConcurrent);\n      const batchResults = await Promise.all(\n        batch.map((intent) => this.generateFromIntent(intent))\n      );\n      results.push(...batchResults);\n    }\n\n    return results;\n  }\n\n  /**\n   * Validate and enhance an existing suggestion using AI.\n   */\n  async enhanceSuggestion(suggestion: SpecSuggestion): Promise<SpecSuggestion> {\n    const prompt = `Review and enhance this spec suggestion:\n\nIntent: ${suggestion.intent.type} - ${suggestion.intent.description}\nCurrent Summary: ${suggestion.proposal.summary}\nCurrent Rationale: ${suggestion.proposal.rationale}\n\nEvidence:\n${suggestion.evidence.map((e) => `- ${e.type}: ${e.description}`).join('\\n')}\n\nPlease provide an improved version with more specific recommendations.`;\n\n    // AI SDK v6: Output.object() only takes { schema }\n    const { output } = await generateText({\n      model: this.model,\n      system: this.systemPrompt,\n      prompt,\n      output: Output.object({\n        schema: SpecSuggestionProposalSchema,\n      }),\n    });\n\n    return {\n      ...suggestion,\n      proposal: {\n        ...suggestion.proposal,\n        summary: output.summary,\n        rationale: output.rationale,\n        changeType: output.changeType,\n        diff: output.diff,\n        metadata: {\n          ...suggestion.proposal.metadata,\n          aiEnhanced: true,\n          recommendedActions: output.recommendedActions,\n          estimatedImpact: output.estimatedImpact,\n          riskLevel: output.riskLevel,\n        },\n      },\n    };\n  }\n\n  private buildPrompt(\n    intent: IntentPattern,\n    options: {\n      additionalContext?: string;\n      existingSpec?: Record<string, unknown>;\n    }\n  ): string {\n    const parts = [\n      `Analyze this intent pattern and generate a spec suggestion:`,\n      ``,\n      `Intent Type: ${intent.type}`,\n      `Description: ${intent.description}`,\n      `Confidence: ${(intent.confidence.score * 100).toFixed(0)}% (sample size: ${intent.confidence.sampleSize})`,\n    ];\n\n    if (intent.operation) {\n      parts.push(\n        `Operation: ${intent.operation.key} v${intent.operation.version}`\n      );\n    }\n\n    if (intent.evidence.length > 0) {\n      parts.push(``, `Evidence:`);\n      for (const evidence of intent.evidence) {\n        parts.push(`- [${evidence.type}] ${evidence.description}`);\n      }\n    }\n\n    if (intent.metadata) {\n      parts.push(``, `Metadata: ${JSON.stringify(intent.metadata, null, 2)}`);\n    }\n\n    if (options.existingSpec) {\n      parts.push(\n        ``,\n        `Existing Spec:`,\n        '```json',\n        JSON.stringify(options.existingSpec, null, 2),\n        '```'\n      );\n    }\n\n    if (options.additionalContext) {\n      parts.push(``, `Additional Context:`, options.additionalContext);\n    }\n\n    return parts.join('\\n');\n  }\n\n  private buildSuggestion(\n    intent: IntentPattern,\n    aiOutput: AIGeneratedProposal\n  ): SpecSuggestion {\n    const now = new Date();\n\n    const proposal: SpecSuggestionProposal = {\n      summary: aiOutput.summary,\n      rationale: aiOutput.rationale,\n      changeType: aiOutput.changeType,\n      diff: aiOutput.diff,\n      metadata: {\n        aiGenerated: true,\n        recommendedActions: aiOutput.recommendedActions,\n        estimatedImpact: aiOutput.estimatedImpact,\n        riskLevel: aiOutput.riskLevel,\n      },\n    };\n\n    return {\n      id: randomUUID(),\n      intent,\n      target: intent.operation,\n      proposal,\n      confidence: intent.confidence.score,\n      priority: this.calculatePriority(intent, aiOutput),\n      createdAt: now,\n      createdBy: 'ai-spec-generator',\n      status: this.determineInitialStatus(intent),\n      evidence: intent.evidence,\n      tags: ['ai-generated', intent.type],\n    };\n  }\n\n  private calculatePriority(\n    intent: IntentPattern,\n    aiOutput: AIGeneratedProposal\n  ): 'low' | 'medium' | 'high' {\n    // Combine AI assessment with intent severity\n    const impactScore =\n      aiOutput.estimatedImpact === 'high'\n        ? 1\n        : aiOutput.estimatedImpact === 'medium'\n          ? 0.5\n          : 0.25;\n\n    const intentScore = intent.confidence.score;\n    const urgency =\n      intent.type === 'error-spike'\n        ? 0.3\n        : intent.type === 'latency-regression'\n          ? 0.2\n          : 0;\n\n    const combined = impactScore * 0.4 + intentScore * 0.4 + urgency;\n\n    if (combined >= 0.7) return 'high';\n    if (combined >= 0.4) return 'medium';\n    return 'low';\n  }\n\n  private determineInitialStatus(intent: IntentPattern): SuggestionStatus {\n    // Auto-approve high-confidence, low-risk suggestions if configured\n    if (\n      this.config.autoApproveThreshold &&\n      intent.confidence.score >= this.config.autoApproveThreshold &&\n      !this.config.requireApproval\n    ) {\n      return 'approved';\n    }\n    return 'pending';\n  }\n}\n\n/**\n * Create an AI-powered spec generator.\n */\nexport function createAISpecGenerator(\n  config: AISpecGeneratorConfig\n): AISpecGenerator {\n  return new AISpecGenerator(config);\n}\n"],"mappings":"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"}

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

@@ -1,46 +0,0 @@
-import { EvolutionConfig, IntentPattern, OperationCoordinate, SpecSuggestion, SpecSuggestionProposal, SuggestionStatus } from "../types.mjs";
-import { Logger } from "@contractspec/lib.observability";
-import { AnyOperationSpec, OperationSpec, ResourceRefDescriptor } from "@contractspec/lib.contracts";
-import { AnySchemaModel } from "@contractspec/lib.schema";
-
-//#region src/generator/spec-generator.d.ts
-interface SpecGeneratorOptions {
-  config?: EvolutionConfig;
-  logger?: Logger;
-  clock?: () => Date;
-  getSpec?: (key: string, version?: string) => AnyOperationSpec | undefined;
-}
-interface GenerateSpecOptions {
-  summary?: string;
-  rationale?: string;
-  changeType?: SpecSuggestionProposal['changeType'];
-  kind?: SpecSuggestionProposal['kind'];
-  spec?: AnyOperationSpec;
-  diff?: string;
-  metadata?: Record<string, unknown>;
-  status?: SuggestionStatus;
-  tags?: string[];
-  createdBy?: string;
-}
-type SpecPatch = Partial<OperationSpec<AnySchemaModel, AnySchemaModel | ResourceRefDescriptor<boolean>>> & {
-  meta?: Partial<AnyOperationSpec['meta']>;
-};
-declare class SpecGenerator {
-  private readonly config;
-  private readonly logger?;
-  private readonly clock;
-  private readonly getSpec?;
-  constructor(options?: SpecGeneratorOptions);
-  generateFromIntent(intent: IntentPattern, options?: GenerateSpecOptions): SpecSuggestion;
-  generateVariant(operation: OperationCoordinate, patch: SpecPatch, intent: IntentPattern, options?: Omit<GenerateSpecOptions, 'spec'>): SpecSuggestion;
-  validateSuggestion(suggestion: SpecSuggestion, config?: EvolutionConfig): {
-    ok: boolean;
-    reasons: string[];
-  };
-  private intentToVerb;
-  private intentToPriority;
-  private inferChangeType;
-}
-//#endregion
-export { GenerateSpecOptions, SpecGenerator, SpecGeneratorOptions, SpecPatch };
-//# sourceMappingURL=spec-generator.d.mts.map

package/dist/generator/spec-generator.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec-generator.d.mts","names":[],"sources":["../../src/generator/spec-generator.ts"],"sourcesContent":[],"mappings":";;;;;;UAiBiB,oBAAA;WACN;EADM,MAAA,CAAA,EAEN,MAFM;EACN,KAAA,CAAA,EAAA,GAAA,GAEK,IAFL;EACA,OAAA,CAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAAA,MAAA,EAAA,GAEoC,gBAFpC,GAAA,SAAA;;AAEoC,UAG9B,mBAAA,CAH8B;EAAgB,OAAA,CAAA,EAAA,MAAA;EAG9C,SAAA,CAAA,EAAA,MAAA;EAGF,UAAA,CAAA,EAAA,sBAAA,CAAA,YAAA,CAAA;EACN,IAAA,CAAA,EAAA,sBAAA,CAAA,MAAA,CAAA;EACA,IAAA,CAAA,EAAA,gBAAA;EAEI,IAAA,CAAA,EAAA,MAAA;EACF,QAAA,CAAA,EADE,MACF,CAAA,MAAA,EAAA,OAAA,CAAA;EAAgB,MAAA,CAAA,EAAhB,gBAAgB;EAKf,IAAA,CAAA,EAAA,MAAS,EAAA;EACL,SAAA,CAAA,EAAA,MAAA;;AAAiC,KADrC,SAAA,GAAY,OACyB,CAA/C,aAA+C,CAAjC,cAAiC,EAAjB,cAAiB,GAAA,qBAAA,CAAA,OAAA,CAAA,CAAA,CAAA,GAAA;EAA/C,IAAA,CAAA,EACW,OADX,CACmB,gBADnB,CAAA,MAAA,CAAA,CAAA;CADsB;AAEH,cAER,aAAA,CAFQ;EAAR,iBAAA,MAAA;EAAO,iBAAA,MAAA;EAEP,iBAAa,KAAA;EAMH,iBAAA,OAAA;EAQX,WAAA,CAAA,OAAA,CAAA,EARW,oBAQX;EACC,kBAAA,CAAA,MAAA,EADD,aACC,EAAA,OAAA,CAAA,EAAA,mBAAA,CAAA,EACR,cADQ;EACR,eAAA,CAAA,SAAA,EAyCU,mBAzCV,EAAA,KAAA,EA0CM,SA1CN,EAAA,MAAA,EA2CO,aA3CP,EAAA,OAAA,CAAA,EA4CQ,IA5CR,CA4Ca,mBA5Cb,EAAA,MAAA,CAAA,CAAA,EA4C8C,cA5C9C;EAyCU,kBAAA,CAAA,UAAA,EAmBC,cAnBD,EAAA,MAAA,CAAA,EAoBH,eApBG,CAAA,EAAA;IACJ,EAAA,EAAA,OAAA;IACC,OAAA,EAAA,MAAA,EAAA;EACM,CAAA;EAAL,QAAA,YAAA;EAAsC,QAAA,gBAAA;EAgBnC,QAAA,eAAA"}

package/dist/generator/spec-generator.mjs

@@ -1,121 +0,0 @@
-import { Logger } from "@contractspec/lib.observability";
-import { randomUUID } from "node:crypto";
-
-//#region src/generator/spec-generator.ts
-var SpecGenerator = class {
-	config;
-	logger;
-	clock;
-	getSpec;
-	constructor(options = {}) {
-		this.config = options.config ?? {};
-		this.logger = options.logger;
-		this.clock = options.clock ?? (() => /* @__PURE__ */ new Date());
-		this.getSpec = options.getSpec;
-	}
-	generateFromIntent(intent, options = {}) {
-		const now = this.clock();
-		const summary = options.summary ?? `${this.intentToVerb(intent.type)} ${intent.operation?.key ?? "operation"}`;
-		const rationale = options.rationale ?? [intent.description, intent.metadata?.observedValue ? `Observed ${intent.metadata.observedValue}` : void 0].filter(Boolean).join(" — ");
-		return {
-			id: randomUUID(),
-			intent,
-			target: intent.operation,
-			proposal: {
-				summary,
-				rationale,
-				changeType: options.changeType ?? this.inferChangeType(intent),
-				kind: options.kind,
-				spec: options.spec,
-				diff: options.diff,
-				metadata: options.metadata
-			},
-			confidence: intent.confidence.score,
-			priority: this.intentToPriority(intent),
-			createdAt: now,
-			createdBy: options.createdBy ?? "auto-evolution",
-			status: options.status ?? "pending",
-			evidence: intent.evidence,
-			tags: options.tags
-		};
-	}
-	generateVariant(operation, patch, intent, options = {}) {
-		if (!this.getSpec) throw new Error("SpecGenerator requires getSpec() to generate variants");
-		const base = this.getSpec(operation.key, operation.version);
-		if (!base) throw new Error(`Cannot generate variant; spec ${operation.key}.v${operation.version} not found`);
-		const merged = mergeContract(base, patch);
-		return this.generateFromIntent(intent, {
-			...options,
-			spec: merged
-		});
-	}
-	validateSuggestion(suggestion, config = this.config) {
-		const reasons = [];
-		if (config.minConfidence != null && suggestion.confidence < config.minConfidence) reasons.push(`Confidence ${suggestion.confidence.toFixed(2)} below minimum ${config.minConfidence}`);
-		if (config.requireApproval && suggestion.status === "approved") reasons.push("Suggestion cannot be auto-approved when approval is required");
-		if (suggestion.proposal.spec && !suggestion.proposal.spec.meta?.key) reasons.push("Proposal spec must include meta.key");
-		if (!suggestion.proposal.summary) reasons.push("Proposal summary is required");
-		const ok = reasons.length === 0;
-		if (!ok) this.logger?.warn("SpecGenerator.validateSuggestion.failed", {
-			suggestionId: suggestion.id,
-			reasons
-		});
-		return {
-			ok,
-			reasons
-		};
-	}
-	intentToVerb(intent) {
-		switch (intent) {
-			case "error-spike": return "Stabilize";
-			case "latency-regression": return "Optimize";
-			case "missing-operation": return "Introduce";
-			case "throughput-drop": return "Rebalance";
-			default: return "Adjust";
-		}
-	}
-	intentToPriority(intent) {
-		const severity = intent.confidence.score;
-		if (intent.type === "error-spike" || severity >= .8) return "high";
-		if (severity >= .5) return "medium";
-		return "low";
-	}
-	inferChangeType(intent) {
-		switch (intent.type) {
-			case "missing-operation": return "new-spec";
-			case "schema-mismatch": return "schema-update";
-			case "error-spike": return "policy-update";
-			default: return "revision";
-		}
-	}
-};
-function mergeContract(base, patch) {
-	return {
-		...base,
-		...patch,
-		meta: {
-			...base.meta,
-			...patch.meta
-		},
-		io: {
-			...base.io,
-			...patch.io
-		},
-		policy: {
-			...base.policy,
-			...patch.policy
-		},
-		telemetry: {
-			...base.telemetry,
-			...patch.telemetry
-		},
-		sideEffects: {
-			...base.sideEffects,
-			...patch.sideEffects
-		}
-	};
-}
-
-//#endregion
-export { SpecGenerator };
-//# sourceMappingURL=spec-generator.mjs.map

package/dist/generator/spec-generator.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec-generator.mjs","names":[],"sources":["../../src/generator/spec-generator.ts"],"sourcesContent":["import type {\n  AnyOperationSpec,\n  OperationSpec,\n  ResourceRefDescriptor,\n} from '@contractspec/lib.contracts';\nimport type { AnySchemaModel } from '@contractspec/lib.schema';\nimport { Logger } from '@contractspec/lib.observability';\nimport { randomUUID } from 'node:crypto';\nimport {\n  type EvolutionConfig,\n  type IntentPattern,\n  type OperationCoordinate,\n  type SpecSuggestion,\n  type SpecSuggestionProposal,\n  type SuggestionStatus,\n} from '../types';\n\nexport interface SpecGeneratorOptions {\n  config?: EvolutionConfig;\n  logger?: Logger;\n  clock?: () => Date;\n  getSpec?: (key: string, version?: string) => AnyOperationSpec | undefined;\n}\n\nexport interface GenerateSpecOptions {\n  summary?: string;\n  rationale?: string;\n  changeType?: SpecSuggestionProposal['changeType'];\n  kind?: SpecSuggestionProposal['kind'];\n  spec?: AnyOperationSpec;\n  diff?: string;\n  metadata?: Record<string, unknown>;\n  status?: SuggestionStatus;\n  tags?: string[];\n  createdBy?: string;\n}\n\nexport type SpecPatch = Partial<\n  OperationSpec<AnySchemaModel, AnySchemaModel | ResourceRefDescriptor<boolean>>\n> & { meta?: Partial<AnyOperationSpec['meta']> };\n\nexport class SpecGenerator {\n  private readonly config: EvolutionConfig;\n  private readonly logger?: Logger;\n  private readonly clock: () => Date;\n  private readonly getSpec?: SpecGeneratorOptions['getSpec'];\n\n  constructor(options: SpecGeneratorOptions = {}) {\n    this.config = options.config ?? {};\n    this.logger = options.logger;\n    this.clock = options.clock ?? (() => new Date());\n    this.getSpec = options.getSpec;\n  }\n\n  generateFromIntent(\n    intent: IntentPattern,\n    options: GenerateSpecOptions = {}\n  ): SpecSuggestion {\n    const now = this.clock();\n    const summary =\n      options.summary ??\n      `${this.intentToVerb(intent.type)} ${intent.operation?.key ?? 'operation'}`;\n    const rationale =\n      options.rationale ??\n      [\n        intent.description,\n        intent.metadata?.observedValue\n          ? `Observed ${intent.metadata.observedValue}`\n          : undefined,\n      ]\n        .filter(Boolean)\n        .join(' — ');\n\n    const suggestion: SpecSuggestion = {\n      id: randomUUID(),\n      intent,\n      target: intent.operation,\n      proposal: {\n        summary,\n        rationale,\n        changeType: options.changeType ?? this.inferChangeType(intent),\n        kind: options.kind,\n        spec: options.spec,\n        diff: options.diff,\n        metadata: options.metadata,\n      },\n      confidence: intent.confidence.score,\n      priority: this.intentToPriority(intent),\n      createdAt: now,\n      createdBy: options.createdBy ?? 'auto-evolution',\n      status: options.status ?? 'pending',\n      evidence: intent.evidence,\n      tags: options.tags,\n    };\n    return suggestion;\n  }\n\n  generateVariant(\n    operation: OperationCoordinate,\n    patch: SpecPatch,\n    intent: IntentPattern,\n    options: Omit<GenerateSpecOptions, 'spec'> = {}\n  ) {\n    if (!this.getSpec) {\n      throw new Error('SpecGenerator requires getSpec() to generate variants');\n    }\n    const base = this.getSpec(operation.key, operation.version);\n    if (!base) {\n      throw new Error(\n        `Cannot generate variant; spec ${operation.key}.v${operation.version} not found`\n      );\n    }\n    const merged = mergeContract(base, patch);\n    return this.generateFromIntent(intent, { ...options, spec: merged });\n  }\n\n  validateSuggestion(\n    suggestion: SpecSuggestion,\n    config: EvolutionConfig = this.config\n  ) {\n    const reasons: string[] = [];\n    if (\n      config.minConfidence != null &&\n      suggestion.confidence < config.minConfidence\n    ) {\n      reasons.push(\n        `Confidence ${suggestion.confidence.toFixed(2)} below minimum ${config.minConfidence}`\n      );\n    }\n    if (config.requireApproval && suggestion.status === 'approved') {\n      reasons.push(\n        'Suggestion cannot be auto-approved when approval is required'\n      );\n    }\n    if (suggestion.proposal.spec && !suggestion.proposal.spec.meta?.key) {\n      reasons.push('Proposal spec must include meta.key');\n    }\n    if (!suggestion.proposal.summary) {\n      reasons.push('Proposal summary is required');\n    }\n    const ok = reasons.length === 0;\n    if (!ok) {\n      this.logger?.warn('SpecGenerator.validateSuggestion.failed', {\n        suggestionId: suggestion.id,\n        reasons,\n      });\n    }\n    return { ok, reasons };\n  }\n\n  private intentToVerb(intent: IntentPattern['type']) {\n    switch (intent) {\n      case 'error-spike':\n        return 'Stabilize';\n      case 'latency-regression':\n        return 'Optimize';\n      case 'missing-operation':\n        return 'Introduce';\n      case 'throughput-drop':\n        return 'Rebalance';\n      default:\n        return 'Adjust';\n    }\n  }\n\n  private intentToPriority(intent: IntentPattern) {\n    const severity = intent.confidence.score;\n    if (intent.type === 'error-spike' || severity >= 0.8) return 'high';\n    if (severity >= 0.5) return 'medium';\n    return 'low';\n  }\n\n  private inferChangeType(\n    intent: IntentPattern\n  ): SpecSuggestionProposal['changeType'] {\n    switch (intent.type) {\n      case 'missing-operation':\n        return 'new-spec';\n      case 'schema-mismatch':\n        return 'schema-update';\n      case 'error-spike':\n        return 'policy-update';\n      default:\n        return 'revision';\n    }\n  }\n}\n\nfunction mergeContract(\n  base: AnyOperationSpec,\n  patch: SpecPatch\n): AnyOperationSpec {\n  return {\n    ...base,\n    ...patch,\n    meta: { ...base.meta, ...patch.meta },\n    io: {\n      ...base.io,\n      ...patch.io,\n    },\n    policy: {\n      ...base.policy,\n      ...patch.policy,\n    },\n    telemetry: {\n      ...base.telemetry,\n      ...patch.telemetry,\n    },\n    sideEffects: {\n      ...base.sideEffects,\n      ...patch.sideEffects,\n    },\n  } as AnyOperationSpec;\n}\n"],"mappings":"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"}

package/dist/index.d.mts

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

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

package/dist/types.d.mts

@@ -1,132 +0,0 @@
-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: string;
-  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.mts.map

package/dist/types.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.mts","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"}