@lssm/lib.evolution 0.4.0 → 1.41.0

package/dist/analyzer/spec-analyzer.js

@@ -1,2 +1 @@
-import"../observability/dist/index.js";import{e}from"../lifecycle/dist/types/stages.js";import"../lifecycle/dist/index.js";import{randomUUID as t}from"node:crypto";const n={minSampleSize:50,errorRateThreshold:.05,latencyP99ThresholdMs:750};var r=class{logger;minSampleSize;errorRateThreshold;latencyP99ThresholdMs;throughputDropThreshold;constructor(e={}){this.logger=e.logger,this.minSampleSize=e.minSampleSize??n.minSampleSize,this.errorRateThreshold=e.errorRateThreshold??n.errorRateThreshold,this.latencyP99ThresholdMs=e.latencyP99ThresholdMs??n.latencyP99ThresholdMs,this.throughputDropThreshold=e.throughputDropThreshold??.2}analyzeSpecUsage(e){if(!e.length)return this.logger?.debug(`SpecAnalyzer.analyzeSpecUsage.skip`,{reason:`no-samples`}),[];let t=new Map;for(let n of e){let e=this.operationKey(n),r=t.get(e)??[];r.push(n),t.set(e,r)}return[...t.values()].filter(e=>{let t=e.length>=this.minSampleSize;return t||this.logger?.debug(`SpecAnalyzer.analyzeSpecUsage.skipOperation`,{operation:this.operationKey(e[0]),sampleSize:e.length,minSampleSize:this.minSampleSize}),t}).map(e=>this.buildUsageStats(e))}detectAnomalies(e,t){let n=[];if(!e.length)return this.logger?.debug(`SpecAnalyzer.detectAnomalies.skip`,{reason:`no-stats`}),n;let r=new Map((t??[]).map(e=>[this.operationKey(e.operation),e]));for(let t of e){let e=[];if(t.errorRate>=this.errorRateThreshold){e.push({type:`telemetry`,description:`Error rate ${t.errorRate.toFixed(2)} exceeded threshold ${this.errorRateThreshold}`,data:{errorRate:t.errorRate}}),n.push({operation:t.operation,severity:this.toSeverity(t.errorRate/this.errorRateThreshold),metric:`error-rate`,description:`Error rate spike`,detectedAt:new Date,threshold:this.errorRateThreshold,observedValue:t.errorRate,evidence:e});continue}if(t.p99LatencyMs>=this.latencyP99ThresholdMs){e.push({type:`telemetry`,description:`P99 latency ${t.p99LatencyMs}ms exceeded threshold ${this.latencyP99ThresholdMs}ms`,data:{p99LatencyMs:t.p99LatencyMs}}),n.push({operation:t.operation,severity:this.toSeverity(t.p99LatencyMs/this.latencyP99ThresholdMs),metric:`latency`,description:`Latency regression detected`,detectedAt:new Date,threshold:this.latencyP99ThresholdMs,observedValue:t.p99LatencyMs,evidence:e});continue}let i=r.get(this.operationKey(t.operation));if(i){let r=(i.totalCalls-t.totalCalls)/i.totalCalls;r>=this.throughputDropThreshold&&(e.push({type:`telemetry`,description:`Throughput dropped by ${(r*100).toFixed(1)}% compared to baseline`,data:{baselineCalls:i.totalCalls,currentCalls:t.totalCalls}}),n.push({operation:t.operation,severity:this.toSeverity(r/this.throughputDropThreshold),metric:`throughput`,description:`Usage drop detected`,detectedAt:new Date,threshold:this.throughputDropThreshold,observedValue:r,evidence:e}))}}return n}toIntentPatterns(e,n){let r=new Map(n.map(e=>[this.operationKey(e.operation),e]));return e.map(e=>{let n=r.get(this.operationKey(e.operation)),i={score:Math.min(1,(e.observedValue??0)/(e.threshold??1)),sampleSize:n?.totalCalls??0,pValue:void 0};return{id:t(),type:this.mapMetricToIntent(e.metric),description:e.description,operation:e.operation,confidence:i,metadata:{observedValue:e.observedValue,threshold:e.threshold},evidence:e.evidence}})}suggestOptimizations(e,t,n){let r=new Map(this.groupByOperation(t)),i=[];for(let t of e){let e=this.operationKey(t.operation),a=r.get(e)??[];for(let e of a)if(e.metric===`latency`)i.push(this.applyLifecycleContext({operation:t.operation,category:`performance`,summary:`Latency regression detected`,justification:`P99 latency at ${t.p99LatencyMs}ms`,recommendedActions:[`Add batching or caching layer`,`Replay golden tests to capture slow inputs`]},n?.stage));else if(e.metric===`error-rate`){let e=Object.entries(t.topErrors).sort((e,t)=>t[1]-e[1])[0]?.[0];i.push(this.applyLifecycleContext({operation:t.operation,category:`error-handling`,summary:`Error spike detected`,justification:e?`Dominant error code ${e}`:`Increase in failures`,recommendedActions:[`Generate regression spec from failing payloads`,`Add policy guardrails before rollout`]},n?.stage))}else e.metric===`throughput`&&i.push(this.applyLifecycleContext({operation:t.operation,category:`performance`,summary:`Throughput drop detected`,justification:`Significant traffic reduction relative to baseline`,recommendedActions:[`Validate routing + feature flag bucketing`,`Backfill spec variant to rehydrate demand`]},n?.stage))}return i}operationKey(e){let t=`operation`in e?e.operation:e;return`${t.name}.v${t.version}${t.tenantId?`@${t.tenantId}`:``}`}buildUsageStats(e){let t=e.map(e=>e.durationMs).sort((e,t)=>e-t),n=e.filter(e=>!e.success),r=e.length,a=(r-n.length)/r,o=n.length/r,s=t.reduce((e,t)=>e+t,0)/r,c=n.reduce((e,t)=>(t.errorCode&&(e[t.errorCode]=(e[t.errorCode]??0)+1),e),{}),l=e.map(e=>e.timestamp.getTime()),u=new Date(Math.min(...l)),d=new Date(Math.max(...l));return{operation:e[0].operation,totalCalls:r,successRate:a,errorRate:o,averageLatencyMs:s,p95LatencyMs:i(t,.95),p99LatencyMs:i(t,.99),maxLatencyMs:Math.max(...t),lastSeenAt:d,windowStart:u,windowEnd:d,topErrors:c}}toSeverity(e){return e>=2?`high`:e>=1.3?`medium`:`low`}mapMetricToIntent(e){switch(e){case`error-rate`:return`error-spike`;case`latency`:return`latency-regression`;case`throughput`:return`throughput-drop`;default:return`schema-mismatch`}}groupByOperation(e){let t=new Map;for(let n of e){let e=this.operationKey(n.operation),r=t.get(e)??[];r.push(n),t.set(e,r)}return t}applyLifecycleContext(e,t){if(t===void 0)return e;let n=o[a(t)]?.[e.category];return n?{...e,lifecycleStage:t,lifecycleNotes:n.message,recommendedActions:s([...e.recommendedActions,...n.supplementalActions])}:{...e,lifecycleStage:t}}};function i(e,t){return e.length?e.length===1?e[0]:e[Math.min(e.length-1,Math.floor(t*e.length))]:0}const a=t=>t<=2?`early`:t===e.ProductMarketFit?`pmf`:t===e.GrowthScaleUp||t===e.ExpansionPlatform?`scale`:`mature`,o={early:{performance:{message:`Favor guardrails that protect learning velocity before heavy rewrites.`,supplementalActions:[`Wrap risky changes behind progressive delivery flags`]},"error-handling":{message:`Make failures loud and recoverable so you can learn faster.`,supplementalActions:[`Add auto-rollbacks or manual kill switches`]}},pmf:{performance:{message:`Stabilize the core use case to avoid regressions while demand grows.`,supplementalActions:[`Instrument regression tests on critical specs`]}},scale:{performance:{message:`Prioritize resilience and multi-tenant safety as volumes expand.`,supplementalActions:[`Introduce workload partitioning or isolation per tenant`]},"error-handling":{message:`Contain blast radius with policy fallbacks and circuit breakers.`,supplementalActions:[`Add circuit breakers to high-risk operations`]}},mature:{performance:{message:`Optimize for margins and predictable SLAs.`,supplementalActions:[`Capture unit-cost impacts alongside latency fixes`]},"error-handling":{message:`Prevent regressions with automated regression specs before deploy.`,supplementalActions:[`Run auto-evolution simulations on renewal scenarios`]}}},s=e=>{let t=new Set,n=[];for(let r of e)t.has(r)||(t.add(r),n.push(r));return n};export{r as SpecAnalyzer};
-//# sourceMappingURL=spec-analyzer.js.map
+import"@lssm/lib.observability";import{randomUUID as e}from"node:crypto";import{LifecycleStage as t}from"@lssm/lib.lifecycle";const n={minSampleSize:50,errorRateThreshold:.05,latencyP99ThresholdMs:750};var r=class{logger;minSampleSize;errorRateThreshold;latencyP99ThresholdMs;throughputDropThreshold;constructor(e={}){this.logger=e.logger,this.minSampleSize=e.minSampleSize??n.minSampleSize,this.errorRateThreshold=e.errorRateThreshold??n.errorRateThreshold,this.latencyP99ThresholdMs=e.latencyP99ThresholdMs??n.latencyP99ThresholdMs,this.throughputDropThreshold=e.throughputDropThreshold??.2}analyzeSpecUsage(e){if(!e.length)return this.logger?.debug(`SpecAnalyzer.analyzeSpecUsage.skip`,{reason:`no-samples`}),[];let t=new Map;for(let n of e){let e=this.operationKey(n),r=t.get(e)??[];r.push(n),t.set(e,r)}return[...t.values()].filter(e=>{let t=e.length>=this.minSampleSize;return t||this.logger?.debug(`SpecAnalyzer.analyzeSpecUsage.skipOperation`,{operation:this.operationKey(e[0]),sampleSize:e.length,minSampleSize:this.minSampleSize}),t}).map(e=>this.buildUsageStats(e))}detectAnomalies(e,t){let n=[];if(!e.length)return this.logger?.debug(`SpecAnalyzer.detectAnomalies.skip`,{reason:`no-stats`}),n;let r=new Map((t??[]).map(e=>[this.operationKey(e.operation),e]));for(let t of e){let e=[];if(t.errorRate>=this.errorRateThreshold){e.push({type:`telemetry`,description:`Error rate ${t.errorRate.toFixed(2)} exceeded threshold ${this.errorRateThreshold}`,data:{errorRate:t.errorRate}}),n.push({operation:t.operation,severity:this.toSeverity(t.errorRate/this.errorRateThreshold),metric:`error-rate`,description:`Error rate spike`,detectedAt:new Date,threshold:this.errorRateThreshold,observedValue:t.errorRate,evidence:e});continue}if(t.p99LatencyMs>=this.latencyP99ThresholdMs){e.push({type:`telemetry`,description:`P99 latency ${t.p99LatencyMs}ms exceeded threshold ${this.latencyP99ThresholdMs}ms`,data:{p99LatencyMs:t.p99LatencyMs}}),n.push({operation:t.operation,severity:this.toSeverity(t.p99LatencyMs/this.latencyP99ThresholdMs),metric:`latency`,description:`Latency regression detected`,detectedAt:new Date,threshold:this.latencyP99ThresholdMs,observedValue:t.p99LatencyMs,evidence:e});continue}let i=r.get(this.operationKey(t.operation));if(i){let r=(i.totalCalls-t.totalCalls)/i.totalCalls;r>=this.throughputDropThreshold&&(e.push({type:`telemetry`,description:`Throughput dropped by ${(r*100).toFixed(1)}% compared to baseline`,data:{baselineCalls:i.totalCalls,currentCalls:t.totalCalls}}),n.push({operation:t.operation,severity:this.toSeverity(r/this.throughputDropThreshold),metric:`throughput`,description:`Usage drop detected`,detectedAt:new Date,threshold:this.throughputDropThreshold,observedValue:r,evidence:e}))}}return n}toIntentPatterns(t,n){let r=new Map(n.map(e=>[this.operationKey(e.operation),e]));return t.map(t=>{let n=r.get(this.operationKey(t.operation)),i={score:Math.min(1,(t.observedValue??0)/(t.threshold??1)),sampleSize:n?.totalCalls??0,pValue:void 0};return{id:e(),type:this.mapMetricToIntent(t.metric),description:t.description,operation:t.operation,confidence:i,metadata:{observedValue:t.observedValue,threshold:t.threshold},evidence:t.evidence}})}suggestOptimizations(e,t,n){let r=new Map(this.groupByOperation(t)),i=[];for(let t of e){let e=this.operationKey(t.operation),a=r.get(e)??[];for(let e of a)if(e.metric===`latency`)i.push(this.applyLifecycleContext({operation:t.operation,category:`performance`,summary:`Latency regression detected`,justification:`P99 latency at ${t.p99LatencyMs}ms`,recommendedActions:[`Add batching or caching layer`,`Replay golden tests to capture slow inputs`]},n?.stage));else if(e.metric===`error-rate`){let e=Object.entries(t.topErrors).sort((e,t)=>t[1]-e[1])[0]?.[0];i.push(this.applyLifecycleContext({operation:t.operation,category:`error-handling`,summary:`Error spike detected`,justification:e?`Dominant error code ${e}`:`Increase in failures`,recommendedActions:[`Generate regression spec from failing payloads`,`Add policy guardrails before rollout`]},n?.stage))}else e.metric===`throughput`&&i.push(this.applyLifecycleContext({operation:t.operation,category:`performance`,summary:`Throughput drop detected`,justification:`Significant traffic reduction relative to baseline`,recommendedActions:[`Validate routing + feature flag bucketing`,`Backfill spec variant to rehydrate demand`]},n?.stage))}return i}operationKey(e){let t=`operation`in e?e.operation:e;return`${t.name}.v${t.version}${t.tenantId?`@${t.tenantId}`:``}`}buildUsageStats(e){let t=e.map(e=>e.durationMs).sort((e,t)=>e-t),n=e.filter(e=>!e.success),r=e.length,a=(r-n.length)/r,o=n.length/r,s=t.reduce((e,t)=>e+t,0)/r,c=n.reduce((e,t)=>(t.errorCode&&(e[t.errorCode]=(e[t.errorCode]??0)+1),e),{}),l=e.map(e=>e.timestamp.getTime()),u=new Date(Math.min(...l)),d=new Date(Math.max(...l));return{operation:e[0].operation,totalCalls:r,successRate:a,errorRate:o,averageLatencyMs:s,p95LatencyMs:i(t,.95),p99LatencyMs:i(t,.99),maxLatencyMs:Math.max(...t),lastSeenAt:d,windowStart:u,windowEnd:d,topErrors:c}}toSeverity(e){return e>=2?`high`:e>=1.3?`medium`:`low`}mapMetricToIntent(e){switch(e){case`error-rate`:return`error-spike`;case`latency`:return`latency-regression`;case`throughput`:return`throughput-drop`;default:return`schema-mismatch`}}groupByOperation(e){let t=new Map;for(let n of e){let e=this.operationKey(n.operation),r=t.get(e)??[];r.push(n),t.set(e,r)}return t}applyLifecycleContext(e,t){if(t===void 0)return e;let n=o[a(t)]?.[e.category];return n?{...e,lifecycleStage:t,lifecycleNotes:n.message,recommendedActions:s([...e.recommendedActions,...n.supplementalActions])}:{...e,lifecycleStage:t}}};function i(e,t){return e.length?e.length===1?e[0]:e[Math.min(e.length-1,Math.floor(t*e.length))]:0}const a=e=>e<=2?`early`:e===t.ProductMarketFit?`pmf`:e===t.GrowthScaleUp||e===t.ExpansionPlatform?`scale`:`mature`,o={early:{performance:{message:`Favor guardrails that protect learning velocity before heavy rewrites.`,supplementalActions:[`Wrap risky changes behind progressive delivery flags`]},"error-handling":{message:`Make failures loud and recoverable so you can learn faster.`,supplementalActions:[`Add auto-rollbacks or manual kill switches`]}},pmf:{performance:{message:`Stabilize the core use case to avoid regressions while demand grows.`,supplementalActions:[`Instrument regression tests on critical specs`]}},scale:{performance:{message:`Prioritize resilience and multi-tenant safety as volumes expand.`,supplementalActions:[`Introduce workload partitioning or isolation per tenant`]},"error-handling":{message:`Contain blast radius with policy fallbacks and circuit breakers.`,supplementalActions:[`Add circuit breakers to high-risk operations`]}},mature:{performance:{message:`Optimize for margins and predictable SLAs.`,supplementalActions:[`Capture unit-cost impacts alongside latency fixes`]},"error-handling":{message:`Prevent regressions with automated regression specs before deploy.`,supplementalActions:[`Run auto-evolution simulations on renewal scenarios`]}}},s=e=>{let t=new Set,n=[];for(let r of e)t.has(r)||(t.add(r),n.push(r));return n};export{r as SpecAnalyzer};

package/dist/approval/integration.js

@@ -1,2 +1 @@
-import"../ai-agent/dist/approval/index.js";import{mkdir as e,writeFile as t}from"node:fs/promises";import{join as n}from"node:path";var r=class{constructor(e){this.options=e}async submit(e,t,n){return await this.options.repository.create(e),t&&this.options.approval&&await this.options.approval.requestApproval(t,n??e.proposal.summary,{suggestionId:e.id}),e}async approve(e,t,n){let r=await this.ensureSuggestion(e);await this.options.repository.updateStatus(e,`approved`,{reviewer:t,notes:n,decidedAt:new Date}),this.options.writer&&await this.options.writer.write({...r,status:`approved`,approvals:{reviewer:t,notes:n,decidedAt:new Date,status:`approved`}})}async reject(e,t,n){await this.options.repository.updateStatus(e,`rejected`,{reviewer:t,notes:n,decidedAt:new Date})}list(e){return this.options.repository.list(e)}async ensureSuggestion(e){let t=await this.options.repository.getById(e);if(!t)throw Error(`Spec suggestion ${e} not found`);return t}},i=class{outputDir;filenameTemplate;constructor(e={}){this.outputDir=e.outputDir??n(process.cwd(),`packages/contractspec/packages/libs/contracts/src/generated`),this.filenameTemplate=e.filenameTemplate??(e=>`${e.target?.name??e.intent.id}.v${e.target?.version??`next`}.suggestion.json`)}async write(r){await e(this.outputDir,{recursive:!0});let i=this.filenameTemplate(r),a=n(this.outputDir,i),s=o(r);return await t(a,JSON.stringify(s,null,2)),a}},a=class{items=new Map;async create(e){this.items.set(e.id,e)}async getById(e){return this.items.get(e)}async updateStatus(e,t,n){let r=await this.getById(e);r&&this.items.set(e,{...r,status:t,approvals:{reviewer:n?.reviewer,notes:n?.notes,decidedAt:n?.decidedAt,status:t}})}async list(e){let t=[...this.items.values()];return e?t.filter(t=>!(e.status&&t.status!==e.status||e.operationName&&t.target?.name!==e.operationName)):t}};function o(e){let{proposal:t,...n}=e,{spec:r,...i}=t;return{...n,proposal:{...i,specMeta:r?.meta},createdAt:e.createdAt.toISOString(),intent:{...e.intent,confidence:{...e.intent.confidence},evidence:e.intent.evidence}}}export{i as FileSystemSuggestionWriter,a as InMemorySpecSuggestionRepository,r as SpecSuggestionOrchestrator};
-//# sourceMappingURL=integration.js.map
+import{mkdir as e,writeFile as t}from"node:fs/promises";import{join as n}from"node:path";import"@lssm/lib.ai-agent/approval";var r=class{constructor(e){this.options=e}async submit(e,t,n){return await this.options.repository.create(e),t&&this.options.approval&&await this.options.approval.requestApproval({sessionId:t.sessionId,agentId:t.agentId,tenantId:t.tenantId,toolName:`evolution.apply_suggestion`,toolCallId:e.id,toolArgs:{suggestionId:e.id},reason:n??e.proposal.summary,payload:{suggestionId:e.id}}),e}async approve(e,t,n){let r=await this.ensureSuggestion(e);await this.options.repository.updateStatus(e,`approved`,{reviewer:t,notes:n,decidedAt:new Date}),this.options.writer&&await this.options.writer.write({...r,status:`approved`,approvals:{reviewer:t,notes:n,decidedAt:new Date,status:`approved`}})}async reject(e,t,n){await this.options.repository.updateStatus(e,`rejected`,{reviewer:t,notes:n,decidedAt:new Date})}list(e){return this.options.repository.list(e)}async ensureSuggestion(e){let t=await this.options.repository.getById(e);if(!t)throw Error(`Spec suggestion ${e} not found`);return t}},i=class{outputDir;filenameTemplate;constructor(e={}){this.outputDir=e.outputDir??n(process.cwd(),`packages/libs/contracts/src/generated`),this.filenameTemplate=e.filenameTemplate??(e=>`${e.target?.name??e.intent.id}.v${e.target?.version??`next`}.suggestion.json`)}async write(r){await e(this.outputDir,{recursive:!0});let i=this.filenameTemplate(r),a=n(this.outputDir,i),s=o(r);return await t(a,JSON.stringify(s,null,2)),a}},a=class{items=new Map;async create(e){this.items.set(e.id,e)}async getById(e){return this.items.get(e)}async updateStatus(e,t,n){let r=await this.getById(e);r&&this.items.set(e,{...r,status:t,approvals:{reviewer:n?.reviewer,notes:n?.notes,decidedAt:n?.decidedAt,status:t}})}async list(e){let t=[...this.items.values()];return e?t.filter(t=>!(e.status&&t.status!==e.status||e.operationName&&t.target?.name!==e.operationName)):t}};function o(e){let{proposal:t,...n}=e,{spec:r,...i}=t;return{...n,proposal:{...i,specMeta:r?.meta},createdAt:e.createdAt.toISOString(),intent:{...e.intent,confidence:{...e.intent.confidence},evidence:e.intent.evidence}}}export{i as FileSystemSuggestionWriter,a as InMemorySpecSuggestionRepository,r as SpecSuggestionOrchestrator};

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

@@ -0,0 +1,19 @@
+import{randomUUID as e}from"node:crypto";import{Output as t,generateText as n}from"ai";import*as r from"zod";const i=r.object({summary:r.string().describe(`Brief summary of the proposed change`),rationale:r.string().describe(`Detailed explanation of why this change is needed`),changeType:r.enum([`new-spec`,`revision`,`policy-update`,`schema-update`]).describe(`Type of change being proposed`),recommendedActions:r.array(r.string()).describe(`List of specific actions to implement the change`),estimatedImpact:r.enum([`low`,`medium`,`high`]).describe(`Estimated impact of implementing this change`),riskLevel:r.enum([`low`,`medium`,`high`]).describe(`Risk level associated with this change`),diff:r.string().optional().describe(`Optional diff or code snippet showing the change`)});var a=class{model;config;systemPrompt;constructor(e){this.model=e.model,this.config=e.evolutionConfig??{},this.systemPrompt=e.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`}async generateFromIntent(e,r={}){let a=this.buildPrompt(e,r),{output:o}=await n({model:this.model,system:this.systemPrompt,prompt:a,output:t.object({schema:i})});return this.buildSuggestion(e,o)}async generateBatch(e,t={}){let n=t.maxConcurrent??3,r=[];for(let t=0;t<e.length;t+=n){let i=e.slice(t,t+n),a=await Promise.all(i.map(e=>this.generateFromIntent(e)));r.push(...a)}return r}async enhanceSuggestion(e){let r=`Review and enhance this spec suggestion:
+
+Intent: ${e.intent.type} - ${e.intent.description}
+Current Summary: ${e.proposal.summary}
+Current Rationale: ${e.proposal.rationale}
+
+Evidence:
+${e.evidence.map(e=>`- ${e.type}: ${e.description}`).join(`
+`)}
+
+Please provide an improved version with more specific recommendations.`,{output:a}=await n({model:this.model,system:this.systemPrompt,prompt:r,output:t.object({schema:i})});return{...e,proposal:{...e.proposal,summary:a.summary,rationale:a.rationale,changeType:a.changeType,diff:a.diff,metadata:{...e.proposal.metadata,aiEnhanced:!0,recommendedActions:a.recommendedActions,estimatedImpact:a.estimatedImpact,riskLevel:a.riskLevel}}}}buildPrompt(e,t){let n=[`Analyze this intent pattern and generate a spec suggestion:`,``,`Intent Type: ${e.type}`,`Description: ${e.description}`,`Confidence: ${(e.confidence.score*100).toFixed(0)}% (sample size: ${e.confidence.sampleSize})`];if(e.operation&&n.push(`Operation: ${e.operation.name} v${e.operation.version}`),e.evidence.length>0){n.push(``,`Evidence:`);for(let t of e.evidence)n.push(`- [${t.type}] ${t.description}`)}return e.metadata&&n.push(``,`Metadata: ${JSON.stringify(e.metadata,null,2)}`),t.existingSpec&&n.push(``,`Existing Spec:`,"```json",JSON.stringify(t.existingSpec,null,2),"```"),t.additionalContext&&n.push(``,`Additional Context:`,t.additionalContext),n.join(`
+`)}buildSuggestion(t,n){let r=new Date,i={summary:n.summary,rationale:n.rationale,changeType:n.changeType,diff:n.diff,metadata:{aiGenerated:!0,recommendedActions:n.recommendedActions,estimatedImpact:n.estimatedImpact,riskLevel:n.riskLevel}};return{id:e(),intent:t,target:t.operation,proposal:i,confidence:t.confidence.score,priority:this.calculatePriority(t,n),createdAt:r,createdBy:`ai-spec-generator`,status:this.determineInitialStatus(t),evidence:t.evidence,tags:[`ai-generated`,t.type]}}calculatePriority(e,t){let n=t.estimatedImpact===`high`?1:t.estimatedImpact===`medium`?.5:.25,r=e.confidence.score,i=e.type===`error-spike`?.3:e.type===`latency-regression`?.2:0,a=n*.4+r*.4+i;return a>=.7?`high`:a>=.4?`medium`:`low`}determineInitialStatus(e){return this.config.autoApproveThreshold&&e.confidence.score>=this.config.autoApproveThreshold&&!this.config.requireApproval?`approved`:`pending`}};function o(e){return new a(e)}export{a as AISpecGenerator,o as createAISpecGenerator};

package/dist/generator/spec-generator.js

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

package/dist/index.js

@@ -1 +1 @@
-import{SpecAnalyzer as e}from"./analyzer/spec-analyzer.js";import{SpecGenerator as t}from"./generator/spec-generator.js";import{FileSystemSuggestionWriter as n,InMemorySpecSuggestionRepository as r,SpecSuggestionOrchestrator as i}from"./approval/integration.js";export{n as FileSystemSuggestionWriter,r as InMemorySpecSuggestionRepository,e as SpecAnalyzer,t as SpecGenerator,i as SpecSuggestionOrchestrator};
+import{SpecAnalyzer as e}from"./analyzer/spec-analyzer.js";import{SpecGenerator as t}from"./generator/spec-generator.js";import{AISpecGenerator as n,createAISpecGenerator as r}from"./generator/ai-spec-generator.js";import{FileSystemSuggestionWriter as i,InMemorySpecSuggestionRepository as a,SpecSuggestionOrchestrator as o}from"./approval/integration.js";export{n as AISpecGenerator,i as FileSystemSuggestionWriter,a as InMemorySpecSuggestionRepository,e as SpecAnalyzer,t as SpecGenerator,o as SpecSuggestionOrchestrator,r as createAISpecGenerator};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.evolution",
-  "version": "0.4.0",
+  "version": "1.41.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -19,29 +19,35 @@
     "lint": "bun lint:fix",
     "lint:fix": "eslint src --fix",
     "lint:check": "eslint src",
-    "test": "bun run"
+    "test": "bun test"
   },
   "dependencies": {
-    "@lssm/lib.ai-agent": "0.4.0",
-    "@lssm/lib.contracts": "1.11.0",
-    "@lssm/lib.lifecycle": "0.3.0",
-    "@lssm/lib.observability": "0.4.0",
-    "@lssm/lib.schema": "1.11.0"
+    "ai": "beta",
+    "zod": "^4.1.13",
+    "@lssm/lib.ai-agent": "workspace:*",
+    "@lssm/lib.contracts": "workspace:*",
+    "@lssm/lib.lifecycle": "workspace:*",
+    "@lssm/lib.observability": "workspace:*",
+    "@lssm/lib.schema": "workspace:*"
   },
   "peerDependencies": {
-    "@prisma/client": "7.0.0"
+    "@prisma/client": "7.1.0"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.12.0",
-    "@lssm/tool.typescript": "0.11.0",
-    "tsdown": "^0.16.6",
+    "@lssm/tool.tsdown": "workspace:*",
+    "@lssm/tool.typescript": "workspace:*",
+    "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },
   "exports": {
-    ".": "./dist/index.js",
+    ".": "./src/index.ts",
     "./*": "./*"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./*": "./*"
+    }
   }
 }

package/dist/ai-agent/dist/approval/index.js

@@ -1 +0,0 @@
-import"./workflow.js";

package/dist/ai-agent/dist/approval/workflow.js

@@ -1 +0,0 @@
-import{randomUUID as e}from"node:crypto";

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

@@ -1,35 +0,0 @@
-import { IntentPattern, OperationMetricSample, OptimizationHint, SpecAnomaly, SpecUsageStats } from "../types.js";
-import { LifecycleStage } from "@lssm/lib.lifecycle";
-import { Logger } from "@lssm/lib.observability";
-
-//#region src/analyzer/spec-analyzer.d.ts
-interface SpecAnalyzerOptions {
-  logger?: Logger;
-  minSampleSize?: number;
-  errorRateThreshold?: number;
-  latencyP99ThresholdMs?: number;
-  throughputDropThreshold?: number;
-}
-declare class SpecAnalyzer {
-  private readonly logger?;
-  private readonly minSampleSize;
-  private readonly errorRateThreshold;
-  private readonly latencyP99ThresholdMs;
-  private readonly throughputDropThreshold;
-  constructor(options?: SpecAnalyzerOptions);
-  analyzeSpecUsage(samples: OperationMetricSample[]): SpecUsageStats[];
-  detectAnomalies(stats: SpecUsageStats[], baseline?: SpecUsageStats[]): SpecAnomaly[];
-  toIntentPatterns(anomalies: SpecAnomaly[], stats: SpecUsageStats[]): IntentPattern[];
-  suggestOptimizations(stats: SpecUsageStats[], anomalies: SpecAnomaly[], lifecycleContext?: {
-    stage: LifecycleStage;
-  }): OptimizationHint[];
-  private operationKey;
-  private buildUsageStats;
-  private toSeverity;
-  private mapMetricToIntent;
-  private groupByOperation;
-  private applyLifecycleContext;
-}
-//#endregion
-export { SpecAnalyzer, SpecAnalyzerOptions };
-//# sourceMappingURL=spec-analyzer.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"spec-analyzer.d.ts","names":[],"sources":["../../src/analyzer/spec-analyzer.ts"],"sourcesContent":[],"mappings":";;;;;UAciB,mBAAA;WACN;EADM,aAAA,CAAA,EAAA,MAAmB;EAmBvB,kBAAY,CAAA,EAAA,MAAA;EAOF,qBAAA,CAAA,EAAA,MAAA;EAUK,uBAAA,CAAA,EAAA,MAAA;;AAmCjB,cApDE,YAAA,CAoDF;EACI,iBAAA,MAAA;EACV,iBAAA,aAAA;EAsFU,iBAAA,kBAAA;EACJ,iBAAA,qBAAA;EACN,iBAAA,uBAAA;EA8BM,WAAA,CAAA,OAAA,CAAA,EArKY,mBAqKZ;EACI,gBAAA,CAAA,OAAA,EA5Ja,qBA4Jb,EAAA,CAAA,EA5JuC,cA4JvC,EAAA;EACiB,eAAA,CAAA,KAAA,EA1HrB,cA0HqB,EAAA,EAAA,QAAA,CAAA,EAzHjB,cAyHiB,EAAA,CAAA,EAxH3B,WAwH2B,EAAA;EAC3B,gBAAA,CAAA,SAAA,EAnCU,WAmCV,EAAA,EAAA,KAAA,EAlCM,cAkCN,EAAA,CAAA,EAjCA,aAiCA,EAAA;EAAgB,oBAAA,CAAA,KAAA,EAHV,cAGU,EAAA,EAAA,SAAA,EAFN,WAEM,EAAA,EAAA,iBAAA,EAAA;WADW;MAC3B"}

package/dist/analyzer/spec-analyzer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec-analyzer.js","names":["DEFAULT_OPTIONS: Required<\n  Pick<\n    SpecAnalyzerOptions,\n    'minSampleSize' | 'errorRateThreshold' | 'latencyP99ThresholdMs'\n  >\n>","anomalies: SpecAnomaly[]","evidence: SuggestionEvidence[]","confidence: PatternConfidence","hints: OptimizationHint[]","LifecycleStage","LIFECYCLE_HINTS: Record<\n  StageBand,\n  Partial<\n    Record<\n      OptimizationHint['category'],\n      { message: string; supplementalActions: string[] }\n    >\n  >\n>","ordered: string[]"],"sources":["../../src/analyzer/spec-analyzer.ts"],"sourcesContent":["import { Logger } from '@lssm/lib.observability';\nimport { randomUUID } from 'node:crypto';\nimport { LifecycleStage } from '@lssm/lib.lifecycle';\nimport {\n  type IntentPattern,\n  type OperationCoordinate,\n  type OperationMetricSample,\n  type OptimizationHint,\n  type PatternConfidence,\n  type SpecAnomaly,\n  type SpecUsageStats,\n  type SuggestionEvidence,\n} from '../types';\n\nexport interface SpecAnalyzerOptions {\n  logger?: Logger;\n  minSampleSize?: number;\n  errorRateThreshold?: number;\n  latencyP99ThresholdMs?: number;\n  throughputDropThreshold?: number;\n}\n\nconst DEFAULT_OPTIONS: Required<\n  Pick<\n    SpecAnalyzerOptions,\n    'minSampleSize' | 'errorRateThreshold' | 'latencyP99ThresholdMs'\n  >\n> = {\n  minSampleSize: 50,\n  errorRateThreshold: 0.05,\n  latencyP99ThresholdMs: 750,\n};\n\nexport class SpecAnalyzer {\n  private readonly logger?: Logger;\n  private readonly minSampleSize: number;\n  private readonly errorRateThreshold: number;\n  private readonly latencyP99ThresholdMs: number;\n  private readonly throughputDropThreshold: number;\n\n  constructor(options: SpecAnalyzerOptions = {}) {\n    this.logger = options.logger;\n    this.minSampleSize = options.minSampleSize ?? DEFAULT_OPTIONS.minSampleSize;\n    this.errorRateThreshold =\n      options.errorRateThreshold ?? DEFAULT_OPTIONS.errorRateThreshold;\n    this.latencyP99ThresholdMs =\n      options.latencyP99ThresholdMs ?? DEFAULT_OPTIONS.latencyP99ThresholdMs;\n    this.throughputDropThreshold = options.throughputDropThreshold ?? 0.2;\n  }\n\n  analyzeSpecUsage(samples: OperationMetricSample[]): SpecUsageStats[] {\n    if (!samples.length) {\n      this.logger?.debug('SpecAnalyzer.analyzeSpecUsage.skip', {\n        reason: 'no-samples',\n      });\n      return [];\n    }\n\n    const groups = new Map<string, OperationMetricSample[]>();\n    for (const sample of samples) {\n      const key = this.operationKey(sample);\n      const arr = groups.get(key) ?? [];\n      arr.push(sample);\n      groups.set(key, arr);\n    }\n\n    const entries = [...groups.values()];\n    const usable = entries.filter((samplesForOp) => {\n      const valid = samplesForOp.length >= this.minSampleSize;\n      if (!valid) {\n        this.logger?.debug('SpecAnalyzer.analyzeSpecUsage.skipOperation', {\n          operation: this.operationKey(samplesForOp[0]!),\n          sampleSize: samplesForOp.length,\n          minSampleSize: this.minSampleSize,\n        });\n      }\n      return valid;\n    });\n\n    return usable.map((operationSamples) =>\n      this.buildUsageStats(operationSamples)\n    );\n  }\n\n  detectAnomalies(\n    stats: SpecUsageStats[],\n    baseline?: SpecUsageStats[]\n  ): SpecAnomaly[] {\n    const anomalies: SpecAnomaly[] = [];\n    if (!stats.length) {\n      this.logger?.debug('SpecAnalyzer.detectAnomalies.skip', {\n        reason: 'no-stats',\n      });\n      return anomalies;\n    }\n    const baselineByOp = new Map(\n      (baseline ?? []).map((item) => [this.operationKey(item.operation), item])\n    );\n\n    for (const stat of stats) {\n      const evidence: SuggestionEvidence[] = [];\n\n      if (stat.errorRate >= this.errorRateThreshold) {\n        evidence.push({\n          type: 'telemetry',\n          description: `Error rate ${stat.errorRate.toFixed(2)} exceeded threshold ${this.errorRateThreshold}`,\n          data: { errorRate: stat.errorRate },\n        });\n        anomalies.push({\n          operation: stat.operation,\n          severity: this.toSeverity(stat.errorRate / this.errorRateThreshold),\n          metric: 'error-rate',\n          description: 'Error rate spike',\n          detectedAt: new Date(),\n          threshold: this.errorRateThreshold,\n          observedValue: stat.errorRate,\n          evidence,\n        });\n        continue;\n      }\n\n      if (stat.p99LatencyMs >= this.latencyP99ThresholdMs) {\n        evidence.push({\n          type: 'telemetry',\n          description: `P99 latency ${stat.p99LatencyMs}ms exceeded threshold ${this.latencyP99ThresholdMs}ms`,\n          data: { p99LatencyMs: stat.p99LatencyMs },\n        });\n        anomalies.push({\n          operation: stat.operation,\n          severity: this.toSeverity(\n            stat.p99LatencyMs / this.latencyP99ThresholdMs\n          ),\n          metric: 'latency',\n          description: 'Latency regression detected',\n          detectedAt: new Date(),\n          threshold: this.latencyP99ThresholdMs,\n          observedValue: stat.p99LatencyMs,\n          evidence,\n        });\n        continue;\n      }\n\n      const baselineStat = baselineByOp.get(this.operationKey(stat.operation));\n      if (baselineStat) {\n        const drop =\n          (baselineStat.totalCalls - stat.totalCalls) / baselineStat.totalCalls;\n        if (drop >= this.throughputDropThreshold) {\n          evidence.push({\n            type: 'telemetry',\n            description: `Throughput dropped by ${(drop * 100).toFixed(1)}% compared to baseline`,\n            data: {\n              baselineCalls: baselineStat.totalCalls,\n              currentCalls: stat.totalCalls,\n            },\n          });\n          anomalies.push({\n            operation: stat.operation,\n            severity: this.toSeverity(drop / this.throughputDropThreshold),\n            metric: 'throughput',\n            description: 'Usage drop detected',\n            detectedAt: new Date(),\n            threshold: this.throughputDropThreshold,\n            observedValue: drop,\n            evidence,\n          });\n        }\n      }\n    }\n\n    return anomalies;\n  }\n\n  toIntentPatterns(\n    anomalies: SpecAnomaly[],\n    stats: SpecUsageStats[]\n  ): IntentPattern[] {\n    const statsByOp = new Map(\n      stats.map((item) => [this.operationKey(item.operation), item])\n    );\n    return anomalies.map((anomaly) => {\n      const stat = statsByOp.get(this.operationKey(anomaly.operation));\n      const confidence: PatternConfidence = {\n        score: Math.min(\n          1,\n          (anomaly.observedValue ?? 0) / (anomaly.threshold ?? 1)\n        ),\n        sampleSize: stat?.totalCalls ?? 0,\n        pValue: undefined,\n      };\n      return {\n        id: randomUUID(),\n        type: this.mapMetricToIntent(anomaly.metric),\n        description: anomaly.description,\n        operation: anomaly.operation,\n        confidence,\n        metadata: {\n          observedValue: anomaly.observedValue,\n          threshold: anomaly.threshold,\n        },\n        evidence: anomaly.evidence,\n      };\n    });\n  }\n\n  suggestOptimizations(\n    stats: SpecUsageStats[],\n    anomalies: SpecAnomaly[],\n    lifecycleContext?: { stage: LifecycleStage }\n  ): OptimizationHint[] {\n    const anomaliesByOp = new Map<string, SpecAnomaly[]>(\n      this.groupByOperation(anomalies)\n    );\n    const hints: OptimizationHint[] = [];\n\n    for (const stat of stats) {\n      const opKey = this.operationKey(stat.operation);\n      const opAnomalies = anomaliesByOp.get(opKey) ?? [];\n      for (const anomaly of opAnomalies) {\n        if (anomaly.metric === 'latency') {\n          hints.push(\n            this.applyLifecycleContext(\n              {\n                operation: stat.operation,\n                category: 'performance',\n                summary: 'Latency regression detected',\n                justification: `P99 latency at ${stat.p99LatencyMs}ms`,\n                recommendedActions: [\n                  'Add batching or caching layer',\n                  'Replay golden tests to capture slow inputs',\n                ],\n              },\n              lifecycleContext?.stage\n            )\n          );\n        } else if (anomaly.metric === 'error-rate') {\n          const topError = Object.entries(stat.topErrors).sort(\n            (a, b) => b[1] - a[1]\n          )[0]?.[0];\n          hints.push(\n            this.applyLifecycleContext(\n              {\n                operation: stat.operation,\n                category: 'error-handling',\n                summary: 'Error spike detected',\n                justification: topError\n                  ? `Dominant error code ${topError}`\n                  : 'Increase in failures',\n                recommendedActions: [\n                  'Generate regression spec from failing payloads',\n                  'Add policy guardrails before rollout',\n                ],\n              },\n              lifecycleContext?.stage\n            )\n          );\n        } else if (anomaly.metric === 'throughput') {\n          hints.push(\n            this.applyLifecycleContext(\n              {\n                operation: stat.operation,\n                category: 'performance',\n                summary: 'Throughput drop detected',\n                justification:\n                  'Significant traffic reduction relative to baseline',\n                recommendedActions: [\n                  'Validate routing + feature flag bucketing',\n                  'Backfill spec variant to rehydrate demand',\n                ],\n              },\n              lifecycleContext?.stage\n            )\n          );\n        }\n      }\n    }\n    return hints;\n  }\n\n  private operationKey(\n    op:\n      | OperationCoordinate\n      | SpecUsageStats\n      | SpecAnomaly\n      | OperationMetricSample\n  ) {\n    const coordinate =\n      'operation' in op ? (op.operation as OperationCoordinate) : op;\n    return `${coordinate.name}.v${coordinate.version}${\n      coordinate.tenantId ? `@${coordinate.tenantId}` : ''\n    }`;\n  }\n\n  private buildUsageStats(samples: OperationMetricSample[]): SpecUsageStats {\n    const durations = samples.map((s) => s.durationMs).sort((a, b) => a - b);\n    const errors = samples.filter((s) => !s.success);\n    const totalCalls = samples.length;\n    const successRate = (totalCalls - errors.length) / totalCalls;\n    const errorRate = errors.length / totalCalls;\n    const averageLatencyMs =\n      durations.reduce((sum, value) => sum + value, 0) / totalCalls;\n\n    const topErrors = errors.reduce<Record<string, number>>((acc, sample) => {\n      if (!sample.errorCode) return acc;\n      acc[sample.errorCode] = (acc[sample.errorCode] ?? 0) + 1;\n      return acc;\n    }, {});\n\n    const timestamps = samples.map((s) => s.timestamp.getTime());\n    const windowStart = new Date(Math.min(...timestamps));\n    const windowEnd = new Date(Math.max(...timestamps));\n\n    return {\n      operation: samples[0]!.operation,\n      totalCalls,\n      successRate,\n      errorRate,\n      averageLatencyMs,\n      p95LatencyMs: percentile(durations, 0.95),\n      p99LatencyMs: percentile(durations, 0.99),\n      maxLatencyMs: Math.max(...durations),\n      lastSeenAt: windowEnd,\n      windowStart,\n      windowEnd,\n      topErrors,\n    };\n  }\n\n  private toSeverity(ratio: number): SpecAnomaly['severity'] {\n    if (ratio >= 2) return 'high';\n    if (ratio >= 1.3) return 'medium';\n    return 'low';\n  }\n\n  private mapMetricToIntent(\n    metric: SpecAnomaly['metric']\n  ): IntentPattern['type'] {\n    switch (metric) {\n      case 'error-rate':\n        return 'error-spike';\n      case 'latency':\n        return 'latency-regression';\n      case 'throughput':\n        return 'throughput-drop';\n      default:\n        return 'schema-mismatch';\n    }\n  }\n\n  private groupByOperation<T extends { operation: OperationCoordinate }>(\n    items: T[]\n  ): Map<string, T[]> {\n    const map = new Map<string, T[]>();\n    for (const item of items) {\n      const key = this.operationKey(item.operation);\n      const arr = map.get(key) ?? [];\n      arr.push(item);\n      map.set(key, arr);\n    }\n    return map;\n  }\n\n  private applyLifecycleContext(\n    hint: OptimizationHint,\n    stage?: LifecycleStage\n  ): OptimizationHint {\n    if (stage === undefined) return hint;\n    const band = mapStageBand(stage);\n    const advice = LIFECYCLE_HINTS[band]?.[hint.category];\n    if (!advice) {\n      return { ...hint, lifecycleStage: stage };\n    }\n    return {\n      ...hint,\n      lifecycleStage: stage,\n      lifecycleNotes: advice.message,\n      recommendedActions: dedupeActions([\n        ...hint.recommendedActions,\n        ...advice.supplementalActions,\n      ]),\n    };\n  }\n}\n\nfunction percentile(values: number[], p: number): number {\n  if (!values.length) return 0;\n  if (values.length === 1) return values[0]!;\n  const idx = Math.min(values.length - 1, Math.floor(p * values.length));\n  return values[idx]!;\n}\n\ntype StageBand = 'early' | 'pmf' | 'scale' | 'mature';\n\nconst mapStageBand = (stage: LifecycleStage): StageBand => {\n  if (stage <= 2) return 'early';\n  if (stage === LifecycleStage.ProductMarketFit) return 'pmf';\n  if (\n    stage === LifecycleStage.GrowthScaleUp ||\n    stage === LifecycleStage.ExpansionPlatform\n  ) {\n    return 'scale';\n  }\n  return 'mature';\n};\n\nconst LIFECYCLE_HINTS: Record<\n  StageBand,\n  Partial<\n    Record<\n      OptimizationHint['category'],\n      { message: string; supplementalActions: string[] }\n    >\n  >\n> = {\n  early: {\n    performance: {\n      message:\n        'Favor guardrails that protect learning velocity before heavy rewrites.',\n      supplementalActions: [\n        'Wrap risky changes behind progressive delivery flags',\n      ],\n    },\n    'error-handling': {\n      message: 'Make failures loud and recoverable so you can learn faster.',\n      supplementalActions: ['Add auto-rollbacks or manual kill switches'],\n    },\n  },\n  pmf: {\n    performance: {\n      message:\n        'Stabilize the core use case to avoid regressions while demand grows.',\n      supplementalActions: ['Instrument regression tests on critical specs'],\n    },\n  },\n  scale: {\n    performance: {\n      message:\n        'Prioritize resilience and multi-tenant safety as volumes expand.',\n      supplementalActions: [\n        'Introduce workload partitioning or isolation per tenant',\n      ],\n    },\n    'error-handling': {\n      message:\n        'Contain blast radius with policy fallbacks and circuit breakers.',\n      supplementalActions: ['Add circuit breakers to high-risk operations'],\n    },\n  },\n  mature: {\n    performance: {\n      message: 'Optimize for margins and predictable SLAs.',\n      supplementalActions: [\n        'Capture unit-cost impacts alongside latency fixes',\n      ],\n    },\n    'error-handling': {\n      message:\n        'Prevent regressions with automated regression specs before deploy.',\n      supplementalActions: [\n        'Run auto-evolution simulations on renewal scenarios',\n      ],\n    },\n  },\n};\n\nconst dedupeActions = (actions: string[]): string[] => {\n  const seen = new Set<string>();\n  const ordered: string[] = [];\n  for (const action of actions) {\n    if (seen.has(action)) continue;\n    seen.add(action);\n    ordered.push(action);\n  }\n  return ordered;\n};\n"],"mappings":"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"}

package/dist/approval/integration.d.ts

@@ -1,43 +0,0 @@
-import { SpecSuggestion, SpecSuggestionFilters, SpecSuggestionRepository, SpecSuggestionWriter, SuggestionStatus } from "../types.js";
-import { ApprovalWorkflow } from "@lssm/lib.ai-agent/approval";
-import { AgentSessionState } from "@lssm/lib.ai-agent/types";
-
-//#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.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"integration.d.ts","names":[],"sources":["../../src/approval/integration.ts"],"sourcesContent":[],"mappings":";;;;;UAYiB,iCAAA;cACH;EADG,QAAA,CAAA,EAEJ,gBAFI;EACH,MAAA,CAAA,EAEH,oBAFG;;AAEH,cAGE,0BAAA,CAHF;EAAoB,iBAAA,OAAA;EAGlB,WAAA,CAAA,OAAA,EAC2B,iCADD;EACC,MAAA,CAAA,UAAA,EAGxB,cAHwB,EAAA,OAAA,CAAA,EAI1B,iBAJ0B,EAAA,cAAA,CAAA,EAAA,MAAA,CAAA,EAKb,OALa,CAKb,cALa,CAAA;EAGxB,OAAA,CAAA,EAAA,EAAA,MAAA,EAAA,QAAA,EAAA,MAAA,EAAA,KAAA,CAAA,EAAA,MAAA,CAAA,EAe4C,OAf5C,CAAA,IAAA,CAAA;EACF,MAAA,CAAA,EAAA,EAAA,MAAA,EAAA,QAAA,EAAA,MAAA,EAAA,KAAA,CAAA,EAAA,MAAA,CAAA,EAmC6C,OAnC7C,CAAA,IAAA,CAAA;EACa,IAAA,CAAA,OAAA,CAAA,EA0CV,qBA1CU,CAAA,EA0CW,OA1CX,CA0CW,cA1CX,EAAA,CAAA;EAAA,QAAA,gBAAA;;AAkCgC,UAmB1C,iCAAA,CAnB0C;EAQ1C,SAAA,CAAA,EAAA,MAAA;EAAqB,gBAAA,CAAA,EAAA,CAAA,UAAA,EAaJ,cAbI,EAAA,GAAA,MAAA;;AAAA,cAgBzB,0BAAA,YAAsC,oBAhBb,CAAA;EAWrB,iBAAA,SAAA;EAKJ,iBAAA,gBAA2B;EAMjB,WAAA,CAAA,OAAA,CAAA,EAAA,iCAAA;EAaG,KAAA,CAAA,UAAA,EAAA,cAAA,CAAA,EAAiB,OAAjB,CAAA,MAAA,CAAA;;AAnByB,cA6BtC,gCAAA,YACA,wBA9BsC,CAAA;EAAoB,iBAAA,KAAA;EA6B1D,MAAA,CAAA,UAAA,EAKc,cALd,CAAA,EAK+B,OAJ1C,CAAA,IAAA,CAAA;EAIyB,OAAA,CAAA,EAAA,EAAA,MAAA,CAAA,EAIE,OAJF,CAIU,cAJV,GAAA,SAAA,CAAA;EAAiB,YAAA,CAAA,EAAA,EAAA,MAAA,EAAA,MAAA,EAUhC,gBAVgC,EAAA,QAWoB,CAXpB,EAAA;IAIP,QAAA,CAAA,EAAA,MAAA;IAAR,KAAA,CAAA,EAAA,MAAA;IAMjB,SAAA,CAAA,EACoD,IADpD;EACoD,CAAA,CAAA,EAC3D,OAD2D,CAAA,IAAA,CAAA;EAC3D,IAAA,CAAA,OAAA,CAAA,EAekB,qBAflB,CAAA,EAeuC,OAfvC,CAeuC,cAfvC,EAAA,CAAA"}

package/dist/approval/integration.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"integration.js","names":["options: SpecSuggestionOrchestratorOptions"],"sources":["../../src/approval/integration.ts"],"sourcesContent":["import { mkdir, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { ApprovalWorkflow } from '@lssm/lib.ai-agent/approval';\nimport type { AgentSessionState } from '@lssm/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      await this.options.approval.requestApproval(\n        session,\n        approvalReason ?? suggestion.proposal.summary,\n        { 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(\n        process.cwd(),\n        'packages/contractspec/packages/libs/contracts/src/generated'\n      );\n    this.filenameTemplate =\n      options.filenameTemplate ??\n      ((suggestion) =>\n        `${suggestion.target?.name ?? 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\n  implements SpecSuggestionRepository\n{\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.operationName && item.target?.name !== filters.operationName)\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\nfunction deserializeSuggestion(payload: unknown): SpecSuggestion | undefined {\n  if (!payload || typeof payload !== 'object') return undefined;\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":"oIAkBA,IAAa,EAAb,KAAwC,CACtC,YAAY,EAA6D,CAA5C,KAAA,QAAA,EAE7B,MAAM,OACJ,EACA,EACA,EACA,CASA,OARA,MAAM,KAAK,QAAQ,WAAW,OAAO,EAAW,CAC5C,GAAW,KAAK,QAAQ,UAC1B,MAAM,KAAK,QAAQ,SAAS,gBAC1B,EACA,GAAkB,EAAW,SAAS,QACtC,CAAE,aAAc,EAAW,GAAI,CAChC,CAEI,EAGT,MAAM,QAAQ,EAAY,EAAkB,EAAgB,CAC1D,IAAM,EAAa,MAAM,KAAK,iBAAiB,EAAG,CAClD,MAAM,KAAK,QAAQ,WAAW,aAAa,EAAI,WAAY,CACzD,WACA,QACA,UAAW,IAAI,KAChB,CAAC,CACE,KAAK,QAAQ,QACf,MAAM,KAAK,QAAQ,OAAO,MAAM,CAC9B,GAAG,EACH,OAAQ,WACR,UAAW,CACT,WACA,QACA,UAAW,IAAI,KACf,OAAQ,WACT,CACF,CAAC,CAIN,MAAM,OAAO,EAAY,EAAkB,EAAgB,CACzD,MAAM,KAAK,QAAQ,WAAW,aAAa,EAAI,WAAY,CACzD,WACA,QACA,UAAW,IAAI,KAChB,CAAC,CAGJ,KAAK,EAAiC,CACpC,OAAO,KAAK,QAAQ,WAAW,KAAK,EAAQ,CAG9C,MAAc,iBAAiB,EAAY,CACzC,IAAM,EAAa,MAAM,KAAK,QAAQ,WAAW,QAAQ,EAAG,CAC5D,GAAI,CAAC,EAAY,MAAU,MAAM,mBAAmB,EAAG,YAAY,CACnE,OAAO,IASE,EAAb,KAAwE,CACtE,UACA,iBAIA,YAAY,EAA6C,EAAE,CAAE,CAC3D,KAAK,UACH,EAAQ,WACR,EACE,QAAQ,KAAK,CACb,8DACD,CACH,KAAK,iBACH,EAAQ,mBACN,GACA,GAAG,EAAW,QAAQ,MAAQ,EAAW,OAAO,GAAG,IAAI,EAAW,QAAQ,SAAW,OAAO,mBAGlG,MAAM,MAAM,EAA6C,CACvD,MAAM,EAAM,KAAK,UAAW,CAAE,UAAW,GAAM,CAAC,CAChD,IAAM,EAAW,KAAK,iBAAiB,EAAW,CAC5C,EAAW,EAAK,KAAK,UAAW,EAAS,CACzC,EAAU,EAAoB,EAAW,CAE/C,OADA,MAAM,EAAU,EAAU,KAAK,UAAU,EAAS,KAAM,EAAE,CAAC,CACpD,IAIE,EAAb,KAEA,CACE,MAAyB,IAAI,IAE7B,MAAM,OAAO,EAA2C,CACtD,KAAK,MAAM,IAAI,EAAW,GAAI,EAAW,CAG3C,MAAM,QAAQ,EAAiD,CAC7D,OAAO,KAAK,MAAM,IAAI,EAAG,CAG3B,MAAM,aACJ,EACA,EACA,EACe,CACf,IAAM,EAAa,MAAM,KAAK,QAAQ,EAAG,CACpC,GACL,KAAK,MAAM,IAAI,EAAI,CACjB,GAAG,EACH,SACA,UAAW,CACT,SAAU,GAAU,SACpB,MAAO,GAAU,MACjB,UAAW,GAAU,UACrB,SACD,CACF,CAAC,CAGJ,MAAM,KAAK,EAAiC,CAC1C,IAAM,EAAS,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC,CAEvC,OADK,EACE,EAAO,OAAQ,GAEpB,EADI,EAAQ,QAAU,EAAK,SAAW,EAAQ,QAC1C,EAAQ,eAAiB,EAAK,QAAQ,OAAS,EAAQ,eAG3D,CANmB,IAUzB,SAAS,EAAoB,EAA4B,CACvD,GAAM,CAAE,WAAU,GAAG,GAAS,EACxB,CAAE,OAAM,GAAG,GAAiB,EAClC,MAAO,CACL,GAAG,EACH,SAAU,CACR,GAAG,EACH,SAAU,GAAM,KACjB,CACD,UAAW,EAAW,UAAU,aAAa,CAC7C,OAAQ,CACN,GAAG,EAAW,OACd,WAAY,CAAE,GAAG,EAAW,OAAO,WAAY,CAC/C,SAAU,EAAW,OAAO,SAC7B,CACF"}

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

@@ -1,47 +0,0 @@
-import { EvolutionConfig, IntentPattern, OperationCoordinate, SpecSuggestion, SpecSuggestionProposal, SuggestionStatus } from "../types.js";
-import { ContractSpec, ResourceRefDescriptor } from "@lssm/lib.contracts";
-import { AnySchemaModel } from "@lssm/lib.schema";
-import { Logger } from "@lssm/lib.observability";
-
-//#region src/generator/spec-generator.d.ts
-type AnyContract = ContractSpec<AnySchemaModel, AnySchemaModel | ResourceRefDescriptor<boolean>>;
-interface SpecGeneratorOptions {
-  config?: EvolutionConfig;
-  logger?: Logger;
-  clock?: () => Date;
-  getSpec?: (name: string, version?: number) => AnyContract | undefined;
-}
-interface GenerateSpecOptions {
-  summary?: string;
-  rationale?: string;
-  changeType?: SpecSuggestionProposal['changeType'];
-  kind?: SpecSuggestionProposal['kind'];
-  spec?: AnyContract;
-  diff?: string;
-  metadata?: Record<string, unknown>;
-  status?: SuggestionStatus;
-  tags?: string[];
-  createdBy?: string;
-}
-type SpecPatch = Partial<ContractSpec<AnySchemaModel, AnySchemaModel | ResourceRefDescriptor<boolean>>> & {
-  meta?: Partial<AnyContract['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.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"spec-generator.d.ts","names":[],"sources":["../../src/generator/spec-generator.ts"],"sourcesContent":[],"mappings":";;;;;;KAaK,WAAA,GAAc,aACjB,gBACA,iBAAiB;UAGF,oBAAA;EALZ,MAAA,CAAA,EAMM,eANK;EACd,MAAA,CAAA,EAMS,MANT;EACA,KAAA,CAAA,EAAA,GAAA,GAMc,IANd;EAAiB,OAAA,CAAA,EAAA,CAAA,IAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAAA,MAAA,EAAA,GAO6B,WAP7B,GAAA,SAAA;;AAFY,UAYd,mBAAA,CAZc;EAKd,OAAA,CAAA,EAAA,MAAA;EACN,SAAA,CAAA,EAAA,MAAA;EACA,UAAA,CAAA,EAQI,sBARJ,CAAA,YAAA,CAAA;EACK,IAAA,CAAA,EAQP,sBARO,CAAA,MAAA,CAAA;EACgC,IAAA,CAAA,EAQvC,WARuC;EAAW,IAAA,CAAA,EAAA,MAAA;EAG1C,QAAA,CAAA,EAOJ,MAPI,CAAA,MAAmB,EAAA,OAAA,CAAA;EAGrB,MAAA,CAAA,EAKJ,gBALI;EACN,IAAA,CAAA,EAAA,MAAA,EAAA;EACA,SAAA,CAAA,EAAA,MAAA;;AAGE,KAKC,SAAA,GAAY,OALb,CAMT,YANS,CAMI,cANJ,EAMoB,cANpB,GAMqC,qBANrC,CAAA,OAAA,CAAA,CAAA,CAAA,GAAA;EAAgB,IAAA,CAAA,EAOd,OAPc,CAON,WAPM,CAAA,MAAA,CAAA,CAAA;AAK3B,CAAA;AACe,cAGF,aAAA,CAHE;EAAgB,iBAAA,MAAA;EAAiB,iBAAA,MAAA;EAA9C,iBAAA,KAAA;EADsB,iBAAA,OAAA;EAEH,WAAA,CAAA,OAAA,CAAA,EAQE,oBARF;EAAR,kBAAA,CAAA,MAAA,EAgBD,aAhBC,EAAA,OAAA,CAAA,EAiBA,mBAjBA,CAAA,EAkBR,cAlBQ;EAAO,eAAA,CAAA,SAAA,EA2DL,mBA3DK,EAAA,KAAA,EA4DT,SA5DS,EAAA,MAAA,EA6DR,aA7DQ,EAAA,OAAA,CAAA,EA8DP,IA9DO,CA8DF,mBA9DE,EAAA,MAAA,CAAA,CAAA,EA8D+B,cA9D/B;EAEP,kBAAa,CAAA,UAAA,EA4EV,cA5EU,EAAA,MAAA,CAAA,EA6Ed,eA7Ec,CAAA,EAAA;IAMH,EAAA,EAAA,OAAA;IAQX,OAAA,EAAA,MAAA,EAAA;EACC,CAAA;EACR,QAAA,YAAA;EAyCU,QAAA,gBAAA;EACJ,QAAA,eAAA"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"spec-generator.js","names":["reasons: string[]"],"sources":["../../src/generator/spec-generator.ts"],"sourcesContent":["import type { ContractSpec, ResourceRefDescriptor } from '@lssm/lib.contracts';\nimport type { AnySchemaModel } from '@lssm/lib.schema';\nimport { Logger } from '@lssm/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\ntype AnyContract = ContractSpec<\n  AnySchemaModel,\n  AnySchemaModel | ResourceRefDescriptor<boolean>\n>;\n\nexport interface SpecGeneratorOptions {\n  config?: EvolutionConfig;\n  logger?: Logger;\n  clock?: () => Date;\n  getSpec?: (name: string, version?: number) => AnyContract | undefined;\n}\n\nexport interface GenerateSpecOptions {\n  summary?: string;\n  rationale?: string;\n  changeType?: SpecSuggestionProposal['changeType'];\n  kind?: SpecSuggestionProposal['kind'];\n  spec?: AnyContract;\n  diff?: string;\n  metadata?: Record<string, unknown>;\n  status?: SuggestionStatus;\n  tags?: string[];\n  createdBy?: string;\n}\n\nexport type SpecPatch = Partial<\n  ContractSpec<AnySchemaModel, AnySchemaModel | ResourceRefDescriptor<boolean>>\n> & { meta?: Partial<AnyContract['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?.name ?? '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.name, operation.version);\n    if (!base) {\n      throw new Error(\n        `Cannot generate variant; spec ${operation.name}.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?.name) {\n      reasons.push('Proposal spec must include meta.name');\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(base: AnyContract, patch: SpecPatch): AnyContract {\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 AnyContract;\n}\n"],"mappings":"gFA0CA,IAAa,EAAb,KAA2B,CACzB,OACA,OACA,MACA,QAEA,YAAY,EAAgC,EAAE,CAAE,CAC9C,KAAK,OAAS,EAAQ,QAAU,EAAE,CAClC,KAAK,OAAS,EAAQ,OACtB,KAAK,MAAQ,EAAQ,YAAgB,IAAI,MACzC,KAAK,QAAU,EAAQ,QAGzB,mBACE,EACA,EAA+B,EAAE,CACjB,CAChB,IAAM,EAAM,KAAK,OAAO,CAClB,EACJ,EAAQ,SACR,GAAG,KAAK,aAAa,EAAO,KAAK,CAAC,GAAG,EAAO,WAAW,MAAQ,cAC3D,EACJ,EAAQ,WACR,CACE,EAAO,YACP,EAAO,UAAU,cACb,YAAY,EAAO,SAAS,gBAC5B,IAAA,GACL,CACE,OAAO,QAAQ,CACf,KAAK,MAAM,CAuBhB,MArBmC,CACjC,GAAI,GAAY,CAChB,SACA,OAAQ,EAAO,UACf,SAAU,CACR,UACA,YACA,WAAY,EAAQ,YAAc,KAAK,gBAAgB,EAAO,CAC9D,KAAM,EAAQ,KACd,KAAM,EAAQ,KACd,KAAM,EAAQ,KACd,SAAU,EAAQ,SACnB,CACD,WAAY,EAAO,WAAW,MAC9B,SAAU,KAAK,iBAAiB,EAAO,CACvC,UAAW,EACX,UAAW,EAAQ,WAAa,iBAChC,OAAQ,EAAQ,QAAU,UAC1B,SAAU,EAAO,SACjB,KAAM,EAAQ,KACf,CAIH,gBACE,EACA,EACA,EACA,EAA6C,EAAE,CAC/C,CACA,GAAI,CAAC,KAAK,QACR,MAAU,MAAM,wDAAwD,CAE1E,IAAM,EAAO,KAAK,QAAQ,EAAU,KAAM,EAAU,QAAQ,CAC5D,GAAI,CAAC,EACH,MAAU,MACR,iCAAiC,EAAU,KAAK,IAAI,EAAU,QAAQ,YACvE,CAEH,IAAM,EAAS,EAAc,EAAM,EAAM,CACzC,OAAO,KAAK,mBAAmB,EAAQ,CAAE,GAAG,EAAS,KAAM,EAAQ,CAAC,CAGtE,mBACE,EACA,EAA0B,KAAK,OAC/B,CACA,IAAMA,EAAoB,EAAE,CAE1B,EAAO,eAAiB,MACxB,EAAW,WAAa,EAAO,eAE/B,EAAQ,KACN,cAAc,EAAW,WAAW,QAAQ,EAAE,CAAC,iBAAiB,EAAO,gBACxE,CAEC,EAAO,iBAAmB,EAAW,SAAW,YAClD,EAAQ,KACN,+DACD,CAEC,EAAW,SAAS,MAAQ,CAAC,EAAW,SAAS,KAAK,MAAM,MAC9D,EAAQ,KAAK,uCAAuC,CAEjD,EAAW,SAAS,SACvB,EAAQ,KAAK,+BAA+B,CAE9C,IAAM,EAAK,EAAQ,SAAW,EAO9B,OANK,GACH,KAAK,QAAQ,KAAK,0CAA2C,CAC3D,aAAc,EAAW,GACzB,UACD,CAAC,CAEG,CAAE,KAAI,UAAS,CAGxB,aAAqB,EAA+B,CAClD,OAAQ,EAAR,CACE,IAAK,cACH,MAAO,YACT,IAAK,qBACH,MAAO,WACT,IAAK,oBACH,MAAO,YACT,IAAK,kBACH,MAAO,YACT,QACE,MAAO,UAIb,iBAAyB,EAAuB,CAC9C,IAAM,EAAW,EAAO,WAAW,MAGnC,OAFI,EAAO,OAAS,eAAiB,GAAY,GAAY,OACzD,GAAY,GAAY,SACrB,MAGT,gBACE,EACsC,CACtC,OAAQ,EAAO,KAAf,CACE,IAAK,oBACH,MAAO,WACT,IAAK,kBACH,MAAO,gBACT,IAAK,cACH,MAAO,gBACT,QACE,MAAO,cAKf,SAAS,EAAc,EAAmB,EAA+B,CACvE,MAAO,CACL,GAAG,EACH,GAAG,EACH,KAAM,CAAE,GAAG,EAAK,KAAM,GAAG,EAAM,KAAM,CACrC,GAAI,CACF,GAAG,EAAK,GACR,GAAG,EAAM,GACV,CACD,OAAQ,CACN,GAAG,EAAK,OACR,GAAG,EAAM,OACV,CACD,UAAW,CACT,GAAG,EAAK,UACR,GAAG,EAAM,UACV,CACD,YAAa,CACX,GAAG,EAAK,YACR,GAAG,EAAM,YACV,CACF"}

package/dist/index.d.ts

@@ -1,5 +0,0 @@
-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 { FileSystemSuggestionWriter, FileSystemSuggestionWriterOptions, InMemorySpecSuggestionRepository, SpecSuggestionOrchestrator, SpecSuggestionOrchestratorOptions } from "./approval/integration.js";
-export { 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 };

package/dist/lifecycle/dist/index.js

@@ -1 +0,0 @@
-import{e,n as t}from"./types/stages.js";import"./types/axes.js";import"./types/signals.js";import"./types/milestones.js";import"./utils/formatters.js";

package/dist/lifecycle/dist/types/axes.js

@@ -1,2 +0,0 @@
-(function(e){return e.Sketch=`Sketch`,e.Prototype=`Prototype`,e.Mvp=`MVP`,e.V1=`V1`,e.Ecosystem=`Ecosystem`,e})({}),function(e){return e.Solo=`Solo`,e.TinyTeam=`TinyTeam`,e.FunctionalOrg=`FunctionalOrg`,e.MultiTeam=`MultiTeam`,e.Bureaucratic=`Bureaucratic`,e}({}),function(e){return e.Bootstrapped=`Bootstrapped`,e.PreSeed=`PreSeed`,e.Seed=`Seed`,e.SeriesAorB=`SeriesAorB`,e.LateStage=`LateStage`,e}({});
-//# sourceMappingURL=axes.js.map

package/dist/lifecycle/dist/types/axes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"axes.js","names":["e"],"sources":["../../../../../lifecycle/dist/types/axes.js"],"sourcesContent":["let e=function(e){return e.Sketch=`Sketch`,e.Prototype=`Prototype`,e.Mvp=`MVP`,e.V1=`V1`,e.Ecosystem=`Ecosystem`,e}({}),t=function(e){return e.Solo=`Solo`,e.TinyTeam=`TinyTeam`,e.FunctionalOrg=`FunctionalOrg`,e.MultiTeam=`MultiTeam`,e.Bureaucratic=`Bureaucratic`,e}({}),n=function(e){return e.Bootstrapped=`Bootstrapped`,e.PreSeed=`PreSeed`,e.Seed=`Seed`,e.SeriesAorB=`SeriesAorB`,e.LateStage=`LateStage`,e}({});export{n as CapitalPhase,t as CompanyPhase,e as ProductPhase};\n//# sourceMappingURL=axes.js.map"],"mappings":"CAAM,SAAS,EAAE,CAAC,MAAO,GAAE,OAAO,SAAS,EAAE,UAAU,YAAY,EAAE,IAAI,MAAM,EAAE,GAAG,KAAK,EAAE,UAAU,YAAYA,IAAG,EAAE,CAAC,CAAG,SAAS,EAAE,CAAC,MAAO,GAAE,KAAK,OAAO,EAAE,SAAS,WAAW,EAAE,cAAc,gBAAgB,EAAE,UAAU,YAAY,EAAE,aAAa,eAAeA,GAAG,EAAE,CAAC,CAAG,SAAS,EAAE,CAAC,MAAO,GAAE,aAAa,eAAe,EAAE,QAAQ,UAAU,EAAE,KAAK,OAAO,EAAE,WAAW,aAAa,EAAE,UAAU,YAAYA,GAAG,EAAE,CAAC"}

package/dist/lifecycle/dist/types/milestones.js

@@ -1 +0,0 @@
-import"./stages.js";

package/dist/lifecycle/dist/types/signals.js

@@ -1 +0,0 @@
-import"./stages.js";

package/dist/lifecycle/dist/types/stages.js

@@ -1,2 +0,0 @@
-let e=function(e){return e[e.Exploration=0]=`Exploration`,e[e.ProblemSolutionFit=1]=`ProblemSolutionFit`,e[e.MvpEarlyTraction=2]=`MvpEarlyTraction`,e[e.ProductMarketFit=3]=`ProductMarketFit`,e[e.GrowthScaleUp=4]=`GrowthScaleUp`,e[e.ExpansionPlatform=5]=`ExpansionPlatform`,e[e.MaturityRenewal=6]=`MaturityRenewal`,e}({});e.Exploration,e.ProblemSolutionFit,e.MvpEarlyTraction,e.ProductMarketFit,e.GrowthScaleUp,e.ExpansionPlatform,e.MaturityRenewal;const t={[e.Exploration]:{id:e.Exploration,order:0,slug:`exploration`,name:`Exploration / Ideation`,question:`Is there a problem worth my time?`,signals:[`20+ discovery interviews`,`Clear problem statement`,`Named ICP`],traps:[`Branding before discovery`,`Premature tooling decisions`],focusAreas:[`Customer discovery`,`Problem definition`,`Segment clarity`]},[e.ProblemSolutionFit]:{id:e.ProblemSolutionFit,order:1,slug:`problem-solution-fit`,name:`Problem–Solution Fit`,question:`Do people care enough about this solution?`,signals:[`Prototype reuse`,`Referral energy`,`Pre-pay interest`],traps:[`“Market is huge” without users`,`Skipping qualitative loops`],focusAreas:[`Solution hypothesis`,`Value messaging`,`Feedback capture`]},[e.MvpEarlyTraction]:{id:e.MvpEarlyTraction,order:2,slug:`mvp-early-traction`,name:`MVP & Early Traction`,question:`Can we get real usage and learn fast?`,signals:[`20–50 named active users`,`Weekly releases`,`Noisy feedback`],traps:[`Overbuilt infra for 10 users`,`Undefined retention metric`],focusAreas:[`Activation`,`Cohort tracking`,`Feedback rituals`]},[e.ProductMarketFit]:{id:e.ProductMarketFit,order:3,slug:`product-market-fit`,name:`Product–Market Fit`,question:`Is this pulling us forward?`,signals:[`Retention without heroics`,`Organic word-of-mouth`,`Value stories`],traps:[`Hero growth that does not scale`,`Ignoring churn signals`],focusAreas:[`Retention`,`Reliability`,`ICP clarity`]},[e.GrowthScaleUp]:{id:e.GrowthScaleUp,order:4,slug:`growth-scale-up`,name:`Growth / Scale-up`,question:`Can we grow this repeatably?`,signals:[`Predictable channels`,`Specialized hires`,`Unit economics on track`],traps:[`Paid spend masking retention gaps`,`Infra debt blocking launches`],focusAreas:[`Ops systems`,`Growth loops`,`Reliability engineering`]},[e.ExpansionPlatform]:{id:e.ExpansionPlatform,order:5,slug:`expansion-platform`,name:`Expansion / Platform`,question:`What is the next growth curve?`,signals:[`Stable core metrics`,`Partner/API demand`,`Ecosystem pull`],traps:[`Platform theater before wedge is solid`],focusAreas:[`Partnerships`,`APIs`,`New market validation`]},[e.MaturityRenewal]:{id:e.MaturityRenewal,order:6,slug:`maturity-renewal`,name:`Maturity / Renewal`,question:`Optimize, reinvent, or sunset?`,signals:[`Margin focus`,`Portfolio bets`,`Narrative refresh`],traps:[`Assuming past success is enough`],focusAreas:[`Cost optimization`,`Reinvention bets`,`Sunset planning`]}};export{e,t as n};
-//# sourceMappingURL=stages.js.map

package/dist/lifecycle/dist/types/stages.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stages.js","names":["e","t"],"sources":["../../../../../lifecycle/dist/types/stages.js"],"sourcesContent":["let e=function(e){return e[e.Exploration=0]=`Exploration`,e[e.ProblemSolutionFit=1]=`ProblemSolutionFit`,e[e.MvpEarlyTraction=2]=`MvpEarlyTraction`,e[e.ProductMarketFit=3]=`ProductMarketFit`,e[e.GrowthScaleUp=4]=`GrowthScaleUp`,e[e.ExpansionPlatform=5]=`ExpansionPlatform`,e[e.MaturityRenewal=6]=`MaturityRenewal`,e}({});const t=[e.Exploration,e.ProblemSolutionFit,e.MvpEarlyTraction,e.ProductMarketFit,e.GrowthScaleUp,e.ExpansionPlatform,e.MaturityRenewal],n={[e.Exploration]:{id:e.Exploration,order:0,slug:`exploration`,name:`Exploration / Ideation`,question:`Is there a problem worth my time?`,signals:[`20+ discovery interviews`,`Clear problem statement`,`Named ICP`],traps:[`Branding before discovery`,`Premature tooling decisions`],focusAreas:[`Customer discovery`,`Problem definition`,`Segment clarity`]},[e.ProblemSolutionFit]:{id:e.ProblemSolutionFit,order:1,slug:`problem-solution-fit`,name:`Problem–Solution Fit`,question:`Do people care enough about this solution?`,signals:[`Prototype reuse`,`Referral energy`,`Pre-pay interest`],traps:[`“Market is huge” without users`,`Skipping qualitative loops`],focusAreas:[`Solution hypothesis`,`Value messaging`,`Feedback capture`]},[e.MvpEarlyTraction]:{id:e.MvpEarlyTraction,order:2,slug:`mvp-early-traction`,name:`MVP & Early Traction`,question:`Can we get real usage and learn fast?`,signals:[`20–50 named active users`,`Weekly releases`,`Noisy feedback`],traps:[`Overbuilt infra for 10 users`,`Undefined retention metric`],focusAreas:[`Activation`,`Cohort tracking`,`Feedback rituals`]},[e.ProductMarketFit]:{id:e.ProductMarketFit,order:3,slug:`product-market-fit`,name:`Product–Market Fit`,question:`Is this pulling us forward?`,signals:[`Retention without heroics`,`Organic word-of-mouth`,`Value stories`],traps:[`Hero growth that does not scale`,`Ignoring churn signals`],focusAreas:[`Retention`,`Reliability`,`ICP clarity`]},[e.GrowthScaleUp]:{id:e.GrowthScaleUp,order:4,slug:`growth-scale-up`,name:`Growth / Scale-up`,question:`Can we grow this repeatably?`,signals:[`Predictable channels`,`Specialized hires`,`Unit economics on track`],traps:[`Paid spend masking retention gaps`,`Infra debt blocking launches`],focusAreas:[`Ops systems`,`Growth loops`,`Reliability engineering`]},[e.ExpansionPlatform]:{id:e.ExpansionPlatform,order:5,slug:`expansion-platform`,name:`Expansion / Platform`,question:`What is the next growth curve?`,signals:[`Stable core metrics`,`Partner/API demand`,`Ecosystem pull`],traps:[`Platform theater before wedge is solid`],focusAreas:[`Partnerships`,`APIs`,`New market validation`]},[e.MaturityRenewal]:{id:e.MaturityRenewal,order:6,slug:`maturity-renewal`,name:`Maturity / Renewal`,question:`Optimize, reinvent, or sunset?`,signals:[`Margin focus`,`Portfolio bets`,`Narrative refresh`],traps:[`Assuming past success is enough`],focusAreas:[`Cost optimization`,`Reinvention bets`,`Sunset planning`]}},r=e=>{let t=Object.values(n).find(t=>t.slug===e);if(!t)throw Error(`Unknown lifecycle stage slug: ${e}`);return t.id};export{n as LIFECYCLE_STAGE_META,t as LIFECYCLE_STAGE_ORDER,e as LifecycleStage,r as getLifecycleStageBySlug};\n//# sourceMappingURL=stages.js.map"],"mappings":"AAAA,IAAI,EAAE,SAAS,EAAE,CAAC,MAAO,GAAE,EAAE,YAAY,GAAG,cAAc,EAAE,EAAE,mBAAmB,GAAG,qBAAqB,EAAE,EAAE,iBAAiB,GAAG,mBAAmB,EAAE,EAAE,iBAAiB,GAAG,mBAAmB,EAAE,EAAE,cAAc,GAAG,gBAAgB,EAAE,EAAE,kBAAkB,GAAG,oBAAoB,EAAE,EAAE,gBAAgB,GAAG,kBAAkBA,GAAG,EAAE,CAAC,CAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAxH,MAAyI,EAAE,EAAE,EAAE,aAAa,CAAC,GAAG,EAAE,YAAY,MAAM,EAAE,KAAK,cAAc,KAAK,yBAAyB,SAAS,oCAAoC,QAAQ,CAAC,2BAA2B,0BAA0B,YAAY,CAAC,MAAM,CAAC,4BAA4B,8BAA8B,CAAC,WAAW,CAAC,qBAAqB,qBAAqB,kBAAkB,CAAC,EAAE,EAAE,oBAAoB,CAAC,GAAG,EAAE,mBAAmB,MAAM,EAAE,KAAK,uBAAuB,KAAK,uBAAuB,SAAS,6CAA6C,QAAQ,CAAC,kBAAkB,kBAAkB,mBAAmB,CAAC,MAAM,CAAC,iCAAiC,6BAA6B,CAAC,WAAW,CAAC,sBAAsB,kBAAkB,mBAAmB,CAAC,EAAE,EAAE,kBAAkB,CAAC,GAAG,EAAE,iBAAiB,MAAM,EAAE,KAAK,qBAAqB,KAAK,uBAAuB,SAAS,wCAAwC,QAAQ,CAAC,2BAA2B,kBAAkB,iBAAiB,CAAC,MAAM,CAAC,+BAA+B,6BAA6B,CAAC,WAAW,CAAC,aAAa,kBAAkB,mBAAmB,CAAC,EAAE,EAAE,kBAAkB,CAAC,GAAG,EAAE,iBAAiB,MAAM,EAAE,KAAK,qBAAqB,KAAK,qBAAqB,SAAS,8BAA8B,QAAQ,CAAC,4BAA4B,wBAAwB,gBAAgB,CAAC,MAAM,CAAC,kCAAkC,yBAAyB,CAAC,WAAW,CAAC,YAAY,cAAc,cAAc,CAAC,EAAE,EAAE,eAAe,CAAC,GAAG,EAAE,cAAc,MAAM,EAAE,KAAK,kBAAkB,KAAK,oBAAoB,SAAS,+BAA+B,QAAQ,CAAC,uBAAuB,oBAAoB,0BAA0B,CAAC,MAAM,CAAC,oCAAoC,+BAA+B,CAAC,WAAW,CAAC,cAAc,eAAe,0BAA0B,CAAC,EAAE,EAAE,mBAAmB,CAAC,GAAG,EAAE,kBAAkB,MAAM,EAAE,KAAK,qBAAqB,KAAK,uBAAuB,SAAS,iCAAiC,QAAQ,CAAC,sBAAsB,qBAAqB,iBAAiB,CAAC,MAAM,CAAC,yCAAyC,CAAC,WAAW,CAAC,eAAe,OAAO,wBAAwB,CAAC,EAAE,EAAE,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,MAAM,EAAE,KAAK,mBAAmB,KAAK,qBAAqB,SAAS,iCAAiC,QAAQ,CAAC,eAAe,iBAAiB,oBAAoB,CAAC,MAAM,CAAC,kCAAkC,CAAC,WAAW,CAAC,oBAAoB,mBAAmB,kBAAkB,CAAC,CAAC"}

package/dist/lifecycle/dist/utils/formatters.js

@@ -1 +0,0 @@
-import"../types/stages.js";

package/dist/observability/dist/index.js

@@ -1 +0,0 @@
-import"./tracing/index.js";import{i as e,n as t,t as n}from"./metrics/index.js";import{n as r}from"./logging/index.js";import"./tracing/middleware.js";import"./intent/detector.js";import"./pipeline/evolution-pipeline.js";import"./pipeline/lifecycle-pipeline.js";

package/dist/observability/dist/intent/detector.js

@@ -1 +0,0 @@
-import{randomUUID as e}from"node:crypto";

package/dist/observability/dist/lifecycle/dist/index.js

@@ -1 +0,0 @@
-import"./types/stages.js";import"./utils/formatters.js";import"./types/axes.js";import"./types/signals.js";import"./types/milestones.js";

package/dist/observability/dist/lifecycle/dist/types/axes.js

@@ -1,2 +0,0 @@
-(function(e){return e.Sketch=`Sketch`,e.Prototype=`Prototype`,e.Mvp=`MVP`,e.V1=`V1`,e.Ecosystem=`Ecosystem`,e})({}),function(e){return e.Solo=`Solo`,e.TinyTeam=`TinyTeam`,e.FunctionalOrg=`FunctionalOrg`,e.MultiTeam=`MultiTeam`,e.Bureaucratic=`Bureaucratic`,e}({}),function(e){return e.Bootstrapped=`Bootstrapped`,e.PreSeed=`PreSeed`,e.Seed=`Seed`,e.SeriesAorB=`SeriesAorB`,e.LateStage=`LateStage`,e}({});
-//# sourceMappingURL=axes.js.map

package/dist/observability/dist/lifecycle/dist/types/axes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"axes.js","names":[],"sources":["../../../../../../../observability/dist/lifecycle/dist/types/axes.mjs"],"sourcesContent":["(function(e){return e.Sketch=`Sketch`,e.Prototype=`Prototype`,e.Mvp=`MVP`,e.V1=`V1`,e.Ecosystem=`Ecosystem`,e})({}),function(e){return e.Solo=`Solo`,e.TinyTeam=`TinyTeam`,e.FunctionalOrg=`FunctionalOrg`,e.MultiTeam=`MultiTeam`,e.Bureaucratic=`Bureaucratic`,e}({}),function(e){return e.Bootstrapped=`Bootstrapped`,e.PreSeed=`PreSeed`,e.Seed=`Seed`,e.SeriesAorB=`SeriesAorB`,e.LateStage=`LateStage`,e}({});\n//# sourceMappingURL=axes.mjs.map"],"mappings":"CAAC,SAAS,EAAE,CAAC,MAAO,GAAE,OAAO,SAAS,EAAE,UAAU,YAAY,EAAE,IAAI,MAAM,EAAE,GAAG,KAAK,EAAE,UAAU,YAAY,IAAI,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,MAAO,GAAE,KAAK,OAAO,EAAE,SAAS,WAAW,EAAE,cAAc,gBAAgB,EAAE,UAAU,YAAY,EAAE,aAAa,eAAe,GAAG,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,MAAO,GAAE,aAAa,eAAe,EAAE,QAAQ,UAAU,EAAE,KAAK,OAAO,EAAE,WAAW,aAAa,EAAE,UAAU,YAAY,GAAG,EAAE,CAAC"}

package/dist/observability/dist/lifecycle/dist/types/milestones.js

@@ -1 +0,0 @@
-import"./stages.js";

package/dist/observability/dist/lifecycle/dist/types/signals.js

@@ -1 +0,0 @@
-import"./stages.js";

package/dist/observability/dist/lifecycle/dist/types/stages.js

@@ -1,2 +0,0 @@
-let e=function(e){return e[e.Exploration=0]=`Exploration`,e[e.ProblemSolutionFit=1]=`ProblemSolutionFit`,e[e.MvpEarlyTraction=2]=`MvpEarlyTraction`,e[e.ProductMarketFit=3]=`ProductMarketFit`,e[e.GrowthScaleUp=4]=`GrowthScaleUp`,e[e.ExpansionPlatform=5]=`ExpansionPlatform`,e[e.MaturityRenewal=6]=`MaturityRenewal`,e}({});e.Exploration,e.ProblemSolutionFit,e.MvpEarlyTraction,e.ProductMarketFit,e.GrowthScaleUp,e.ExpansionPlatform,e.MaturityRenewal,e.Exploration,e.Exploration,e.ProblemSolutionFit,e.ProblemSolutionFit,e.MvpEarlyTraction,e.MvpEarlyTraction,e.ProductMarketFit,e.ProductMarketFit,e.GrowthScaleUp,e.GrowthScaleUp,e.ExpansionPlatform,e.ExpansionPlatform,e.MaturityRenewal,e.MaturityRenewal;
-//# sourceMappingURL=stages.js.map

package/dist/observability/dist/lifecycle/dist/types/stages.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stages.js","names":["e"],"sources":["../../../../../../../observability/dist/lifecycle/dist/types/stages.mjs"],"sourcesContent":["let e=function(e){return e[e.Exploration=0]=`Exploration`,e[e.ProblemSolutionFit=1]=`ProblemSolutionFit`,e[e.MvpEarlyTraction=2]=`MvpEarlyTraction`,e[e.ProductMarketFit=3]=`ProductMarketFit`,e[e.GrowthScaleUp=4]=`GrowthScaleUp`,e[e.ExpansionPlatform=5]=`ExpansionPlatform`,e[e.MaturityRenewal=6]=`MaturityRenewal`,e}({});const t=[e.Exploration,e.ProblemSolutionFit,e.MvpEarlyTraction,e.ProductMarketFit,e.GrowthScaleUp,e.ExpansionPlatform,e.MaturityRenewal],n={[e.Exploration]:{id:e.Exploration,order:0,slug:`exploration`,name:`Exploration / Ideation`,question:`Is there a problem worth my time?`,signals:[`20+ discovery interviews`,`Clear problem statement`,`Named ICP`],traps:[`Branding before discovery`,`Premature tooling decisions`],focusAreas:[`Customer discovery`,`Problem definition`,`Segment clarity`]},[e.ProblemSolutionFit]:{id:e.ProblemSolutionFit,order:1,slug:`problem-solution-fit`,name:`Problem–Solution Fit`,question:`Do people care enough about this solution?`,signals:[`Prototype reuse`,`Referral energy`,`Pre-pay interest`],traps:[`“Market is huge” without users`,`Skipping qualitative loops`],focusAreas:[`Solution hypothesis`,`Value messaging`,`Feedback capture`]},[e.MvpEarlyTraction]:{id:e.MvpEarlyTraction,order:2,slug:`mvp-early-traction`,name:`MVP & Early Traction`,question:`Can we get real usage and learn fast?`,signals:[`20–50 named active users`,`Weekly releases`,`Noisy feedback`],traps:[`Overbuilt infra for 10 users`,`Undefined retention metric`],focusAreas:[`Activation`,`Cohort tracking`,`Feedback rituals`]},[e.ProductMarketFit]:{id:e.ProductMarketFit,order:3,slug:`product-market-fit`,name:`Product–Market Fit`,question:`Is this pulling us forward?`,signals:[`Retention without heroics`,`Organic word-of-mouth`,`Value stories`],traps:[`Hero growth that does not scale`,`Ignoring churn signals`],focusAreas:[`Retention`,`Reliability`,`ICP clarity`]},[e.GrowthScaleUp]:{id:e.GrowthScaleUp,order:4,slug:`growth-scale-up`,name:`Growth / Scale-up`,question:`Can we grow this repeatably?`,signals:[`Predictable channels`,`Specialized hires`,`Unit economics on track`],traps:[`Paid spend masking retention gaps`,`Infra debt blocking launches`],focusAreas:[`Ops systems`,`Growth loops`,`Reliability engineering`]},[e.ExpansionPlatform]:{id:e.ExpansionPlatform,order:5,slug:`expansion-platform`,name:`Expansion / Platform`,question:`What is the next growth curve?`,signals:[`Stable core metrics`,`Partner/API demand`,`Ecosystem pull`],traps:[`Platform theater before wedge is solid`],focusAreas:[`Partnerships`,`APIs`,`New market validation`]},[e.MaturityRenewal]:{id:e.MaturityRenewal,order:6,slug:`maturity-renewal`,name:`Maturity / Renewal`,question:`Optimize, reinvent, or sunset?`,signals:[`Margin focus`,`Portfolio bets`,`Narrative refresh`],traps:[`Assuming past success is enough`],focusAreas:[`Cost optimization`,`Reinvention bets`,`Sunset planning`]}};export{e,n,t};\n//# sourceMappingURL=stages.mjs.map"],"mappings":"AAAA,IAAI,EAAE,SAAS,EAAE,CAAC,MAAO,GAAE,EAAE,YAAY,GAAG,cAAc,EAAE,EAAE,mBAAmB,GAAG,qBAAqB,EAAE,EAAE,iBAAiB,GAAG,mBAAmB,EAAE,EAAE,iBAAiB,GAAG,mBAAmB,EAAE,EAAE,cAAc,GAAG,gBAAgB,EAAE,EAAE,kBAAkB,GAAG,oBAAoB,EAAE,EAAE,gBAAgB,GAAG,kBAAkBA,GAAG,EAAE,CAAC,CAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAqB,EAAE,YAAiB,EAAE,YAA0U,EAAE,mBAAwB,EAAE,mBAA0V,EAAE,iBAAsB,EAAE,iBAA6U,EAAE,iBAAsB,EAAE,iBAA4T,EAAE,cAAmB,EAAE,cAA8U,EAAE,kBAAuB,EAAE,kBAA8S,EAAE,gBAAqB,EAAE"}

package/dist/observability/dist/lifecycle/dist/utils/formatters.js

@@ -1 +0,0 @@
-import"../types/stages.js";

package/dist/observability/dist/logging/index.js

@@ -1,2 +0,0 @@
-import{context as e,trace as t}from"@opentelemetry/api";var n=class{constructor(e){this.serviceName=e}log(n,r,i={}){let a=t.getSpan(e.active()),o=a?.spanContext().traceId,s=a?.spanContext().spanId,c={timestamp:new Date().toISOString(),service:this.serviceName,level:n,message:r,traceId:o,spanId:s,...i};console.log(JSON.stringify(c))}debug(e,t){this.log(`debug`,e,t)}info(e,t){this.log(`info`,e,t)}warn(e,t){this.log(`warn`,e,t)}error(e,t){this.log(`error`,e,t)}};new n(process.env.OTEL_SERVICE_NAME||`unknown-service`);export{n};
-//# sourceMappingURL=index.js.map

package/dist/observability/dist/logging/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":["t","e","n","r"],"sources":["../../../../../observability/dist/logging/index.mjs"],"sourcesContent":["import{context as e,trace as t}from\"@opentelemetry/api\";var n=class{constructor(e){this.serviceName=e}log(n,r,i={}){let a=t.getSpan(e.active()),o=a?.spanContext().traceId,s=a?.spanContext().spanId,c={timestamp:new Date().toISOString(),service:this.serviceName,level:n,message:r,traceId:o,spanId:s,...i};console.log(JSON.stringify(c))}debug(e,t){this.log(`debug`,e,t)}info(e,t){this.log(`info`,e,t)}warn(e,t){this.log(`warn`,e,t)}error(e,t){this.log(`error`,e,t)}};const r=new n(process.env.OTEL_SERVICE_NAME||`unknown-service`);export{n as Logger,r as logger};\n//# sourceMappingURL=index.mjs.map"],"mappings":"wDAAwD,IAAI,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,KAAK,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,EAAEA,EAAE,QAAQC,EAAE,QAAQ,CAAC,CAAC,EAAE,GAAG,aAAa,CAAC,QAAQ,EAAE,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC,UAAU,IAAI,MAAM,CAAC,aAAa,CAAC,QAAQ,KAAK,YAAY,MAAMC,EAAE,QAAQC,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,IAAI,KAAK,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,IAAI,QAAQ,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,OAAO,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,OAAO,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,IAAI,QAAQ,EAAE,EAAE,GAAW,IAAI,EAAE,QAAQ,IAAI,mBAAmB,kBAAkB"}

package/dist/observability/dist/metrics/index.js

@@ -1,2 +0,0 @@
-import{metrics as e}from"@opentelemetry/api";function t(t=`@lssm/lib.observability`){return e.getMeter(t)}function n(e,n,r){return t(r).createCounter(e,{description:n})}function r(e,n,r){return t(r).createHistogram(e,{description:n})}n(`http_requests_total`,`Total HTTP requests`),r(`http_request_duration_seconds`,`HTTP request duration`),n(`operation_errors_total`,`Total operation errors`),r(`workflow_duration_seconds`,`Workflow execution duration`);export{r as i,n,t};
-//# sourceMappingURL=index.js.map

package/dist/observability/dist/metrics/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":["e","t","n"],"sources":["../../../../../observability/dist/metrics/index.mjs"],"sourcesContent":["import{metrics as e}from\"@opentelemetry/api\";function t(t=`@lssm/lib.observability`){return e.getMeter(t)}function n(e,n,r){return t(r).createCounter(e,{description:n})}function r(e,n,r){return t(r).createUpDownCounter(e,{description:n})}function i(e,n,r){return t(r).createHistogram(e,{description:n})}const a={httpRequests:n(`http_requests_total`,`Total HTTP requests`),httpDuration:i(`http_request_duration_seconds`,`HTTP request duration`),operationErrors:n(`operation_errors_total`,`Total operation errors`),workflowDuration:i(`workflow_duration_seconds`,`Workflow execution duration`)};export{n as createCounter,i as createHistogram,r as createUpDownCounter,t as getMeter,a as standardMetrics};\n//# sourceMappingURL=index.mjs.map"],"mappings":"6CAA6C,SAAS,EAAE,EAAE,0BAA0B,CAAC,OAAOA,EAAE,SAASC,EAAE,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,EAAE,CAAC,YAAYC,EAAE,CAAC,CAAsE,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,EAAE,CAAC,YAAYA,EAAE,CAAC,CAAuB,EAAE,sBAAsB,sBAAsB,CAAc,EAAE,gCAAgC,wBAAwB,CAAiB,EAAE,yBAAyB,yBAAyB,CAAkB,EAAE,4BAA4B,8BAA8B"}

package/dist/observability/dist/pipeline/evolution-pipeline.js

@@ -1 +0,0 @@
-import"../intent/detector.js";import"node:events";

package/dist/observability/dist/pipeline/lifecycle-pipeline.js

@@ -1 +0,0 @@
-import"../metrics/index.js";import"../lifecycle/dist/utils/formatters.js";import"../lifecycle/dist/index.js";import"node:events";

package/dist/observability/dist/tracing/index.js

@@ -1 +0,0 @@
-import{context as e,trace as t}from"@opentelemetry/api";

package/dist/observability/dist/tracing/middleware.js

@@ -1 +0,0 @@
-import"./index.js";import"../metrics/index.js";

package/dist/types.d.ts

@@ -1,132 +0,0 @@
-import { ContractSpec, OpKind, ResourceRefDescriptor } from "@lssm/lib.contracts";
-import { AnySchemaModel } from "@lssm/lib.schema";
-import { LifecycleStage } from "@lssm/lib.lifecycle";
-
-//#region src/types.d.ts
-type AnomalySeverity = 'low' | 'medium' | 'high';
-type SuggestionStatus = 'pending' | 'approved' | 'rejected';
-interface OperationCoordinate {
-  name: 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?: ContractSpec<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;
-  operationName?: 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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;KAQY,eAAA;KACA,gBAAA;AADA,UAGK,mBAAA,CAHU;EACf,IAAA,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,aACL,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"}