@contractspec/lib.evolution 0.0.0-canary-20260113162409

package/dist/approval/integration.d.mts

@@ -0,0 +1,44 @@
+import { SpecSuggestion, SpecSuggestionFilters, SpecSuggestionRepository, SpecSuggestionWriter, SuggestionStatus } from "../types.mjs";
+import { AgentSessionState } from "../ai-agent/src/types.mjs";
+import { ApprovalWorkflow } from "../ai-agent/src/approval/workflow.mjs";
+import "../ai-agent/src/approval/index.mjs";
+
+//#region src/approval/integration.d.ts
+interface SpecSuggestionOrchestratorOptions {
+  repository: SpecSuggestionRepository;
+  approval?: ApprovalWorkflow;
+  writer?: SpecSuggestionWriter;
+}
+declare class SpecSuggestionOrchestrator {
+  private readonly options;
+  constructor(options: SpecSuggestionOrchestratorOptions);
+  submit(suggestion: SpecSuggestion, session?: AgentSessionState, approvalReason?: string): Promise<SpecSuggestion>;
+  approve(id: string, reviewer: string, notes?: string): Promise<void>;
+  reject(id: string, reviewer: string, notes?: string): Promise<void>;
+  list(filters?: SpecSuggestionFilters): Promise<SpecSuggestion[]>;
+  private ensureSuggestion;
+}
+interface FileSystemSuggestionWriterOptions {
+  outputDir?: string;
+  filenameTemplate?: (suggestion: SpecSuggestion) => string;
+}
+declare class FileSystemSuggestionWriter implements SpecSuggestionWriter {
+  private readonly outputDir;
+  private readonly filenameTemplate;
+  constructor(options?: FileSystemSuggestionWriterOptions);
+  write(suggestion: SpecSuggestion): Promise<string>;
+}
+declare class InMemorySpecSuggestionRepository implements SpecSuggestionRepository {
+  private readonly items;
+  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[]>;
+}
+//#endregion
+export { FileSystemSuggestionWriter, FileSystemSuggestionWriterOptions, InMemorySpecSuggestionRepository, SpecSuggestionOrchestrator, SpecSuggestionOrchestratorOptions };
+//# sourceMappingURL=integration.d.mts.map

package/dist/approval/integration.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.d.mts","names":[],"sources":["../../src/approval/integration.ts"],"sourcesContent":[],"mappings":";;;;;;UAYiB,iCAAA;cACH;aACD;EAFI,MAAA,CAAA,EAGN,oBAHM;;AAEJ,cAIA,0BAAA,CAJA;EACF,iBAAA,OAAA;EAAoB,WAAA,CAAA,OAAA,EAIS,iCAJT;EAGlB,MAAA,CAAA,UAAA,EAIG,cAJuB,EAAA,OAAA,CAAA,EAKzB,iBALyB,EAAA,cAAA,CAAA,EAAA,MAAA,CAAA,EAMZ,OANY,CAMZ,cANY,CAAA;EACC,OAAA,CAAA,EAAA,EAAA,MAAA,EAAA,QAAA,EAAA,MAAA,EAAA,KAAA,CAAA,EAAA,MAAA,CAAA,EAwBoB,OAxBpB,CAAA,IAAA,CAAA;EAGxB,MAAA,CAAA,EAAA,EAAA,MAAA,EAAA,QAAA,EAAA,MAAA,EAAA,KAAA,CAAA,EAAA,MAAA,CAAA,EA0C2C,OA1C3C,CAAA,IAAA,CAAA;EACF,IAAA,CAAA,OAAA,CAAA,EAiDG,qBAjDH,CAAA,EAiDwB,OAjDxB,CAiDwB,cAjDxB,EAAA,CAAA;EACa,QAAA,gBAAA;;AAmBiC,UAwC3C,iCAAA,CAxC2C;EAqBD,SAAA,CAAA,EAAA,MAAA;EAQ1C,gBAAA,CAAA,EAAA,CAAA,UAAA,EAaiB,cAbjB,EAAA,GAAA,MAAA;;AAAqB,cAgBzB,0BAAA,YAAsC,oBAhBb,CAAA;EAAA,iBAAA,SAAA;EAWrB,iBAAA,gBAAA;EAKJ,WAAA,CAAA,OAA2B,CAA3B,EAMU,iCANiB;EAMjB,KAAA,CAAA,UAAA,EAUG,cAVH,CAAA,EAUoB,OAVpB,CAAA,MAAA,CAAA;;AAUoB,cAU9B,gCAAA,YAA4C,wBAVd,CAAA;EAhBQ,iBAAA,KAAA;EAAoB,MAAA,CAAA,UAAA,EA6B5C,cA7B4C,CAAA,EA6B3B,OA7B2B,CAAA,IAAA,CAAA;EA0B1D,OAAA,CAAA,EAAA,EAAA,MAAA,CAAA,EAOgB,OAPhB,CAOwB,cAPS,GAAA,SAAA,CAAA;EAGnB,YAAA,CAAA,EAAA,EAAA,MAAA,EAAA,MAAA,EAUf,gBAVe,EAAA,QAUf,CAVe,EAAA;IAAiB,QAAA,CAAA,EAAA,MAAA;IAIP,KAAA,CAAA,EAAA,MAAA;IAAR,SAAA,CAAA,EAOmC,IAPnC;EAMjB,CAAA,CAAA,EAEP,OAFO,CAAA,IAAA,CAAA;EACoD,IAAA,CAAA,OAAA,CAAA,EAgBzC,qBAhByC,CAAA,EAgBpB,OAhBoB,CAgBpB,cAhBoB,EAAA,CAAA"}

package/dist/approval/integration.mjs

@@ -0,0 +1,126 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import "@contractspec/lib.ai-agent/approval";
+
+//#region src/approval/integration.ts
+var SpecSuggestionOrchestrator = class {
+	constructor(options) {
+		this.options = options;
+	}
+	async submit(suggestion, session, approvalReason) {
+		await this.options.repository.create(suggestion);
+		if (session && this.options.approval) await this.options.approval.requestApproval({
+			sessionId: session.sessionId,
+			agentId: session.agentId,
+			tenantId: session.tenantId,
+			toolName: "evolution.apply_suggestion",
+			toolCallId: suggestion.id,
+			toolArgs: { suggestionId: suggestion.id },
+			reason: approvalReason ?? suggestion.proposal.summary,
+			payload: { suggestionId: suggestion.id }
+		});
+		return suggestion;
+	}
+	async approve(id, reviewer, notes) {
+		const suggestion = await this.ensureSuggestion(id);
+		await this.options.repository.updateStatus(id, "approved", {
+			reviewer,
+			notes,
+			decidedAt: /* @__PURE__ */ new Date()
+		});
+		if (this.options.writer) await this.options.writer.write({
+			...suggestion,
+			status: "approved",
+			approvals: {
+				reviewer,
+				notes,
+				decidedAt: /* @__PURE__ */ new Date(),
+				status: "approved"
+			}
+		});
+	}
+	async reject(id, reviewer, notes) {
+		await this.options.repository.updateStatus(id, "rejected", {
+			reviewer,
+			notes,
+			decidedAt: /* @__PURE__ */ new Date()
+		});
+	}
+	list(filters) {
+		return this.options.repository.list(filters);
+	}
+	async ensureSuggestion(id) {
+		const suggestion = await this.options.repository.getById(id);
+		if (!suggestion) throw new Error(`Spec suggestion ${id} not found`);
+		return suggestion;
+	}
+};
+var FileSystemSuggestionWriter = class {
+	outputDir;
+	filenameTemplate;
+	constructor(options = {}) {
+		this.outputDir = options.outputDir ?? join(process.cwd(), "packages/libs/contracts/src/generated");
+		this.filenameTemplate = options.filenameTemplate ?? ((suggestion) => `${suggestion.target?.key ?? suggestion.intent.id}.v${suggestion.target?.version ?? "next"}.suggestion.json`);
+	}
+	async write(suggestion) {
+		await mkdir(this.outputDir, { recursive: true });
+		const filename = this.filenameTemplate(suggestion);
+		const filepath = join(this.outputDir, filename);
+		const payload = serializeSuggestion(suggestion);
+		await writeFile(filepath, JSON.stringify(payload, null, 2));
+		return filepath;
+	}
+};
+var InMemorySpecSuggestionRepository = class {
+	items = /* @__PURE__ */ new Map();
+	async create(suggestion) {
+		this.items.set(suggestion.id, suggestion);
+	}
+	async getById(id) {
+		return this.items.get(id);
+	}
+	async updateStatus(id, status, metadata) {
+		const suggestion = await this.getById(id);
+		if (!suggestion) return;
+		this.items.set(id, {
+			...suggestion,
+			status,
+			approvals: {
+				reviewer: metadata?.reviewer,
+				notes: metadata?.notes,
+				decidedAt: metadata?.decidedAt,
+				status
+			}
+		});
+	}
+	async list(filters) {
+		const values = [...this.items.values()];
+		if (!filters) return values;
+		return values.filter((item) => {
+			if (filters.status && item.status !== filters.status) return false;
+			if (filters.operationKey && item.target?.key !== filters.operationKey) return false;
+			return true;
+		});
+	}
+};
+function serializeSuggestion(suggestion) {
+	const { proposal, ...rest } = suggestion;
+	const { spec, ...proposalRest } = proposal;
+	return {
+		...rest,
+		proposal: {
+			...proposalRest,
+			specMeta: spec?.meta
+		},
+		createdAt: suggestion.createdAt.toISOString(),
+		intent: {
+			...suggestion.intent,
+			confidence: { ...suggestion.intent.confidence },
+			evidence: suggestion.intent.evidence
+		}
+	};
+}
+
+//#endregion
+export { FileSystemSuggestionWriter, InMemorySpecSuggestionRepository, SpecSuggestionOrchestrator };
+//# sourceMappingURL=integration.mjs.map

package/dist/approval/integration.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.mjs","names":[],"sources":["../../src/approval/integration.ts"],"sourcesContent":["import { mkdir, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { ApprovalWorkflow } from '@contractspec/lib.ai-agent/approval';\nimport type { AgentSessionState } from '@contractspec/lib.ai-agent/types';\nimport {\n  type SpecSuggestion,\n  type SpecSuggestionFilters,\n  type SpecSuggestionRepository,\n  type SpecSuggestionWriter,\n  type SuggestionStatus,\n} from '../types';\n\nexport interface SpecSuggestionOrchestratorOptions {\n  repository: SpecSuggestionRepository;\n  approval?: ApprovalWorkflow;\n  writer?: SpecSuggestionWriter;\n}\n\nexport class SpecSuggestionOrchestrator {\n  constructor(private readonly options: SpecSuggestionOrchestratorOptions) {}\n\n  async submit(\n    suggestion: SpecSuggestion,\n    session?: AgentSessionState,\n    approvalReason?: string\n  ) {\n    await this.options.repository.create(suggestion);\n    if (session && this.options.approval) {\n      // AI SDK v6: requestApproval takes a single params object\n      await this.options.approval.requestApproval({\n        sessionId: session.sessionId,\n        agentId: session.agentId,\n        tenantId: session.tenantId,\n        toolName: 'evolution.apply_suggestion',\n        toolCallId: suggestion.id,\n        toolArgs: { suggestionId: suggestion.id },\n        reason: approvalReason ?? suggestion.proposal.summary,\n        payload: { suggestionId: suggestion.id },\n      });\n    }\n    return suggestion;\n  }\n\n  async approve(id: string, reviewer: string, notes?: string) {\n    const suggestion = await this.ensureSuggestion(id);\n    await this.options.repository.updateStatus(id, 'approved', {\n      reviewer,\n      notes,\n      decidedAt: new Date(),\n    });\n    if (this.options.writer) {\n      await this.options.writer.write({\n        ...suggestion,\n        status: 'approved',\n        approvals: {\n          reviewer,\n          notes,\n          decidedAt: new Date(),\n          status: 'approved',\n        },\n      });\n    }\n  }\n\n  async reject(id: string, reviewer: string, notes?: string) {\n    await this.options.repository.updateStatus(id, 'rejected', {\n      reviewer,\n      notes,\n      decidedAt: new Date(),\n    });\n  }\n\n  list(filters?: SpecSuggestionFilters) {\n    return this.options.repository.list(filters);\n  }\n\n  private async ensureSuggestion(id: string) {\n    const suggestion = await this.options.repository.getById(id);\n    if (!suggestion) throw new Error(`Spec suggestion ${id} not found`);\n    return suggestion;\n  }\n}\n\nexport interface FileSystemSuggestionWriterOptions {\n  outputDir?: string;\n  filenameTemplate?: (suggestion: SpecSuggestion) => string;\n}\n\nexport class FileSystemSuggestionWriter implements SpecSuggestionWriter {\n  private readonly outputDir: string;\n  private readonly filenameTemplate: NonNullable<\n    FileSystemSuggestionWriterOptions['filenameTemplate']\n  >;\n\n  constructor(options: FileSystemSuggestionWriterOptions = {}) {\n    this.outputDir =\n      options.outputDir ??\n      join(process.cwd(), 'packages/libs/contracts/src/generated');\n    this.filenameTemplate =\n      options.filenameTemplate ??\n      ((suggestion) =>\n        `${suggestion.target?.key ?? suggestion.intent.id}.v${suggestion.target?.version ?? 'next'}.suggestion.json`);\n  }\n\n  async write(suggestion: SpecSuggestion): Promise<string> {\n    await mkdir(this.outputDir, { recursive: true });\n    const filename = this.filenameTemplate(suggestion);\n    const filepath = join(this.outputDir, filename);\n    const payload = serializeSuggestion(suggestion);\n    await writeFile(filepath, JSON.stringify(payload, null, 2));\n    return filepath;\n  }\n}\n\nexport class InMemorySpecSuggestionRepository implements SpecSuggestionRepository {\n  private readonly items = new Map<string, SpecSuggestion>();\n\n  async create(suggestion: SpecSuggestion): Promise<void> {\n    this.items.set(suggestion.id, suggestion);\n  }\n\n  async getById(id: string): Promise<SpecSuggestion | undefined> {\n    return this.items.get(id);\n  }\n\n  async updateStatus(\n    id: string,\n    status: SuggestionStatus,\n    metadata?: { reviewer?: string; notes?: string; decidedAt?: Date }\n  ): Promise<void> {\n    const suggestion = await this.getById(id);\n    if (!suggestion) return;\n    this.items.set(id, {\n      ...suggestion,\n      status,\n      approvals: {\n        reviewer: metadata?.reviewer,\n        notes: metadata?.notes,\n        decidedAt: metadata?.decidedAt,\n        status,\n      },\n    });\n  }\n\n  async list(filters?: SpecSuggestionFilters) {\n    const values = [...this.items.values()];\n    if (!filters) return values;\n    return values.filter((item) => {\n      if (filters.status && item.status !== filters.status) return false;\n      if (filters.operationKey && item.target?.key !== filters.operationKey)\n        return false;\n      return true;\n    });\n  }\n}\n\nfunction serializeSuggestion(suggestion: SpecSuggestion) {\n  const { proposal, ...rest } = suggestion;\n  const { spec, ...proposalRest } = proposal;\n  return {\n    ...rest,\n    proposal: {\n      ...proposalRest,\n      specMeta: spec?.meta,\n    },\n    createdAt: suggestion.createdAt.toISOString(),\n    intent: {\n      ...suggestion.intent,\n      confidence: { ...suggestion.intent.confidence },\n      evidence: suggestion.intent.evidence,\n    },\n  };\n}\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nfunction deserializeSuggestion(payload: unknown): SpecSuggestion | undefined {\n  if (!payload || typeof payload !== 'object') return undefined;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const raw = payload as Record<string, any>;\n  return {\n    ...raw,\n    createdAt: raw.createdAt ? new Date(raw.createdAt) : new Date(),\n    intent: {\n      ...raw.intent,\n      confidence: raw.intent?.confidence,\n      evidence: raw.intent?.evidence ?? [],\n    },\n    proposal: {\n      ...raw.proposal,\n      metadata: {\n        ...(raw.proposal?.metadata ?? {}),\n        specMeta: raw.proposal?.specMeta,\n      },\n    },\n  } as SpecSuggestion;\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,56 @@
+import { EvolutionConfig, IntentPattern, SpecSuggestion } from "../types.mjs";
+import { LanguageModel } from "ai";
+
+//#region src/generator/ai-spec-generator.d.ts
+
+/**
+ * Configuration for the AI-powered spec generator.
+ */
+interface AISpecGeneratorConfig {
+  /** AI SDK language model */
+  model: LanguageModel;
+  /** Evolution configuration */
+  evolutionConfig?: EvolutionConfig;
+  /** Custom system prompt */
+  systemPrompt?: string;
+}
+/**
+ * AI-powered spec generator using AI SDK v6.
+ *
+ * Uses structured output (Output.object) to generate
+ * well-formed spec suggestions from intent patterns.
+ */
+declare class AISpecGenerator {
+  private readonly model;
+  private readonly config;
+  private readonly systemPrompt;
+  constructor(options: AISpecGeneratorConfig);
+  /**
+   * Generate a spec suggestion from an intent pattern using AI.
+   */
+  generateFromIntent(intent: IntentPattern, options?: {
+    additionalContext?: string;
+    existingSpec?: Record<string, unknown>;
+  }): Promise<SpecSuggestion>;
+  /**
+   * Generate multiple suggestions for a batch of intents.
+   */
+  generateBatch(intents: IntentPattern[], options?: {
+    maxConcurrent?: number;
+  }): Promise<SpecSuggestion[]>;
+  /**
+   * Validate and enhance an existing suggestion using AI.
+   */
+  enhanceSuggestion(suggestion: SpecSuggestion): Promise<SpecSuggestion>;
+  private buildPrompt;
+  private buildSuggestion;
+  private calculatePriority;
+  private determineInitialStatus;
+}
+/**
+ * Create an AI-powered spec generator.
+ */
+declare function createAISpecGenerator(config: AISpecGeneratorConfig): AISpecGenerator;
+//#endregion
+export { AISpecGenerator, AISpecGeneratorConfig, createAISpecGenerator };
+//# sourceMappingURL=ai-spec-generator.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-spec-generator.d.mts","names":[],"sources":["../../src/generator/ai-spec-generator.ts"],"sourcesContent":[],"mappings":";;;;;;;AA2CA;AAea,UAfI,qBAAA,CAeW;EAKL;EAmBX,KAAA,EArCH,aAqCG;EAGS;EAER,eAAA,CAAA,EAxCO,eAwCP;EAAR;EAoBQ,YAAA,CAAA,EAAA,MAAA;;;;;;;AA4Lb;cA7Oa,eAAA;;;;uBAKU;;;;6BAmBX;;mBAGS;MAEhB,QAAQ;;;;yBAoBA;;MAER,QAAQ;;;;gCAmByB,iBAAiB,QAAQ;;;;;;;;;iBAuK/C,qBAAA,SACN,wBACP"}

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

@@ -0,0 +1,186 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,46 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,121 @@
+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

@@ -0,0 +1 @@
+{"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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"}