@contractspec/lib.evolution 1.57.0 → 1.58.0

package/dist/types.d.ts

@@ -0,0 +1,128 @@
+import type { OperationSpec, OpKind, ResourceRefDescriptor } from '@contractspec/lib.contracts';
+import type { AnySchemaModel } from '@contractspec/lib.schema';
+import type { LifecycleStage } from '@contractspec/lib.lifecycle';
+export type AnomalySeverity = 'low' | 'medium' | 'high';
+export type SuggestionStatus = 'pending' | 'approved' | 'rejected';
+export interface OperationCoordinate {
+    key: string;
+    version: string;
+    tenantId?: string;
+}
+export 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>;
+}
+export 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>;
+}
+export interface SuggestionEvidence {
+    type: 'telemetry' | 'user-feedback' | 'simulation' | 'test';
+    description: string;
+    data?: Record<string, unknown>;
+}
+export interface SpecAnomaly {
+    operation: OperationCoordinate;
+    severity: AnomalySeverity;
+    metric: 'latency' | 'error-rate' | 'throughput' | 'policy' | 'schema';
+    description: string;
+    detectedAt: Date;
+    threshold?: number;
+    observedValue?: number;
+    evidence: SuggestionEvidence[];
+}
+export interface PatternConfidence {
+    score: number;
+    sampleSize: number;
+    pValue?: number;
+}
+export 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[];
+}
+export interface SpecSuggestionProposal {
+    summary: string;
+    rationale: string;
+    changeType: 'new-spec' | 'revision' | 'policy-update' | 'schema-update';
+    kind?: OpKind;
+    spec?: OperationSpec<AnySchemaModel, AnySchemaModel | ResourceRefDescriptor<boolean>>;
+    diff?: string;
+    metadata?: Record<string, unknown>;
+}
+export 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;
+    };
+}
+export interface EvolutionConfig {
+    minConfidence?: number;
+    autoApproveThreshold?: number;
+    maxSuggestionsPerOperation?: number;
+    requireApproval?: boolean;
+    maxConcurrentExperiments?: number;
+}
+export interface SpecSuggestionFilters {
+    status?: SuggestionStatus;
+    operationKey?: string;
+}
+export 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[]>;
+}
+export interface SpecSuggestionWriter {
+    write(suggestion: SpecSuggestion): Promise<string>;
+}
+export interface OptimizationHint {
+    operation: OperationCoordinate;
+    category: 'schema' | 'policy' | 'performance' | 'error-handling';
+    summary: string;
+    justification: string;
+    recommendedActions: string[];
+    lifecycleStage?: LifecycleStage;
+    lifecycleNotes?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,MAAM,EACN,qBAAqB,EACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AACxD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAEnE,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,mBAAmB,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,IAAI,CAAC;IACjB,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,GAAG,eAAe,GAAG,YAAY,GAAG,MAAM,CAAC;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EACA,oBAAoB,GACpB,aAAa,GACb,mBAAmB,GACnB,gBAAgB,GAChB,iBAAiB,GACjB,iBAAiB,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,UAAU,GAAG,UAAU,GAAG,eAAe,GAAG,eAAe,CAAC;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,aAAa,CAClB,cAAc,EACd,cAAc,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAChD,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,QAAQ,EAAE,sBAAsB,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE;QACV,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,MAAM,CAAC,EAAE,gBAAgB,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IACzD,YAAY,CACV,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,gBAAgB,EACxB,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,IAAI,CAAA;KAAE,GACjE,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,IAAI,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,aAAa,GAAG,gBAAgB,CAAC;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.evolution",
-  "version": "1.57.0",
+  "version": "1.58.0",
   "description": "AI-powered contract evolution engine",
   "keywords": [
     "contractspec",
@@ -18,43 +18,47 @@
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
-    "build": "bun build:types && bun build:bundle",
-    "build:bundle": "tsdown",
-    "build:types": "tsc --noEmit",
-    "dev": "bun build:bundle --watch",
+    "build": "bun run prebuild && bun run build:bundle && bun run build:types",
+    "build:bundle": "contractspec-bun-build transpile",
+    "build:types": "contractspec-bun-build types",
+    "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
     "lint:fix": "eslint src --fix",
     "lint:check": "eslint src",
-    "test": "bun test"
+    "test": "bun test",
+    "prebuild": "contractspec-bun-build prebuild",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "ai": "6.0.73",
     "zod": "^4.3.5",
-    "@contractspec/lib.ai-agent": "1.57.0",
-    "@contractspec/lib.contracts": "1.57.0",
-    "@contractspec/lib.lifecycle": "1.57.0",
-    "@contractspec/lib.observability": "1.57.0",
-    "@contractspec/lib.schema": "1.57.0"
+    "@contractspec/lib.ai-agent": "1.58.0",
+    "@contractspec/lib.contracts": "1.58.0",
+    "@contractspec/lib.lifecycle": "1.58.0",
+    "@contractspec/lib.observability": "1.58.0",
+    "@contractspec/lib.schema": "1.58.0"
   },
   "peerDependencies": {
     "@prisma/client": "7.3.0"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.57.0",
-    "@contractspec/tool.typescript": "1.57.0",
-    "tsdown": "^0.20.3",
-    "typescript": "^5.9.3"
+    "@contractspec/tool.typescript": "1.58.0",
+    "typescript": "^5.9.3",
+    "@contractspec/tool.bun": "1.57.0"
   },
   "exports": {
-    ".": "./dist/index.mjs",
-    "./*": "./*"
+    ".": "./src/index.ts"
   },
   "publishConfig": {
     "access": "public",
     "exports": {
-      ".": "./dist/index.js",
-      "./*": "./*"
+      ".": {
+        "types": "./dist/index.d.ts",
+        "bun": "./dist/index.js",
+        "node": "./dist/node/index.mjs",
+        "default": "./dist/index.js"
+      }
     },
     "registry": "https://registry.npmjs.org/"
   },

package/dist/analyzer/posthog-telemetry-reader.d.mts

@@ -1,24 +0,0 @@
-import { OperationCoordinate, OperationMetricSample, SpecUsageStats } from "../types.mjs";
-import { AnalyticsReader, DateRangeInput } from "@contractspec/lib.contracts/integrations/providers/analytics";
-
-//#region src/analyzer/posthog-telemetry-reader.d.ts
-interface ReadOperationSamplesInput {
-  operations?: OperationCoordinate[];
-  dateRange?: DateRangeInput;
-  limit?: number;
-}
-interface PosthogTelemetryReaderOptions {
-  eventPrefix?: string;
-}
-declare class PosthogTelemetryReader {
-  private readonly reader;
-  private readonly eventPrefix;
-  constructor(reader: AnalyticsReader, options?: PosthogTelemetryReaderOptions);
-  readOperationSamples(input: ReadOperationSamplesInput): Promise<OperationMetricSample[]>;
-  readAnomalyBaseline(operation: OperationCoordinate, windowDays?: number): Promise<SpecUsageStats | null>;
-  private readTopErrors;
-  private queryHogQL;
-}
-//#endregion
-export { PosthogTelemetryReader, PosthogTelemetryReaderOptions, ReadOperationSamplesInput };
-//# sourceMappingURL=posthog-telemetry-reader.d.mts.map

package/dist/analyzer/posthog-telemetry-reader.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"posthog-telemetry-reader.d.mts","names":[],"sources":["../../src/analyzer/posthog-telemetry-reader.ts"],"mappings":";;;;UAWiB,yBAAA;EACf,UAAA,GAAa,mBAAA;EACb,SAAA,GAAY,cAAA;EACZ,KAAA;AAAA;AAAA,UAGe,6BAAA;EACf,WAAA;AAAA;AAAA,cAGW,sBAAA;EAAA,iBACM,MAAA;EAAA,iBACA,WAAA;cAGf,MAAA,EAAQ,eAAA,EACR,OAAA,GAAS,6BAAA;EAML,oBAAA,CACJ,KAAA,EAAO,yBAAA,GACN,OAAA,CAAQ,qBAAA;EAwBL,mBAAA,CACJ,SAAA,EAAW,mBAAA,EACX,UAAA,YACC,OAAA,CAAQ,cAAA;EAAA,QAkCG,aAAA;EAAA,QAiCA,UAAA;AAAA"}

package/dist/analyzer/posthog-telemetry-reader.mjs

@@ -1,225 +0,0 @@
-//#region src/analyzer/posthog-telemetry-reader.ts
-var PosthogTelemetryReader = class {
-	reader;
-	eventPrefix;
-	constructor(reader, options = {}) {
-		this.reader = reader;
-		this.eventPrefix = options.eventPrefix ?? "observability";
-	}
-	async readOperationSamples(input) {
-		return mapOperationSamples(await this.queryHogQL({
-			query: [
-				"select",
-				"  properties.operation as operationKey,",
-				"  properties.version as version,",
-				"  properties.durationMs as durationMs,",
-				"  properties.success as success,",
-				"  properties.errorCode as errorCode,",
-				"  properties.tenantId as tenantId,",
-				"  properties.traceId as traceId,",
-				"  properties.metadata as metadata,",
-				"  timestamp as timestamp",
-				"from events",
-				`where ${buildOperationWhereClause(this.eventPrefix, input)}`,
-				"order by timestamp desc",
-				`limit ${input.limit ?? 1e3}`
-			].join("\n"),
-			values: buildOperationValues(input)
-		}));
-	}
-	async readAnomalyBaseline(operation, windowDays = 7) {
-		const dateRange = buildWindowRange(windowDays);
-		const stats = mapBaselineStats(await this.queryHogQL({
-			query: [
-				"select",
-				"  count() as totalCalls,",
-				"  avg(properties.durationMs) as averageLatencyMs,",
-				"  quantile(0.95)(properties.durationMs) as p95LatencyMs,",
-				"  quantile(0.99)(properties.durationMs) as p99LatencyMs,",
-				"  max(properties.durationMs) as maxLatencyMs,",
-				"  sum(if(properties.success = 1, 1, 0)) as successCount,",
-				"  sum(if(properties.success = 0, 1, 0)) as errorCount",
-				"from events",
-				`where ${buildOperationWhereClause(this.eventPrefix, {
-					operations: [operation],
-					dateRange
-				})}`
-			].join("\n"),
-			values: buildOperationValues({
-				operations: [operation],
-				dateRange
-			})
-		}), operation, dateRange);
-		if (!stats) return null;
-		const topErrors = await this.readTopErrors(operation, dateRange);
-		return {
-			...stats,
-			topErrors
-		};
-	}
-	async readTopErrors(operation, dateRange) {
-		return mapRows(await this.queryHogQL({
-			query: [
-				"select",
-				"  properties.errorCode as errorCode,",
-				"  count() as errorCount",
-				"from events",
-				`where ${buildOperationWhereClause(this.eventPrefix, {
-					operations: [operation],
-					dateRange
-				})} and properties.success = 0`,
-				"group by errorCode",
-				"order by errorCount desc",
-				"limit 5"
-			].join("\n"),
-			values: buildOperationValues({
-				operations: [operation],
-				dateRange
-			})
-		})).reduce((acc, row) => {
-			const code = asString(row.errorCode);
-			if (!code) return acc;
-			acc[code] = asNumber(row.errorCount);
-			return acc;
-		}, {});
-	}
-	async queryHogQL(input) {
-		if (!this.reader.queryHogQL) throw new Error("Analytics reader does not support HogQL queries.");
-		return this.reader.queryHogQL(input);
-	}
-};
-function buildOperationWhereClause(eventPrefix, input) {
-	const clauses = [`event = '${eventPrefix}.operation'`];
-	if (input.operations?.length) clauses.push(`(${buildOperationFilters(input.operations)})`);
-	if (input.dateRange?.from) clauses.push("timestamp >= {dateFrom}");
-	if (input.dateRange?.to) clauses.push("timestamp < {dateTo}");
-	return clauses.join(" and ");
-}
-function buildOperationValues(input) {
-	const values = {
-		dateFrom: toIsoString(input.dateRange?.from),
-		dateTo: toIsoString(input.dateRange?.to)
-	};
-	input.operations?.forEach((op, index) => {
-		values[`operationKey${index}`] = op.key;
-		values[`operationVersion${index}`] = op.version;
-		if (op.tenantId) values[`operationTenant${index}`] = op.tenantId;
-	});
-	return values;
-}
-function buildOperationFilters(operations) {
-	return operations.map((op, index) => {
-		const clauses = [`properties.operation = {operationKey${index}}`, `properties.version = {operationVersion${index}}`];
-		if (op.tenantId) clauses.push(`properties.tenantId = {operationTenant${index}}`);
-		return `(${clauses.join(" and ")})`;
-	}).join(" or ");
-}
-function mapOperationSamples(result) {
-	return mapRows(result).flatMap((row) => {
-		const operationKey = asString(row.operationKey);
-		const version = asString(row.version);
-		const timestamp = asDate(row.timestamp);
-		if (!operationKey || !version || !timestamp) return [];
-		return [{
-			operation: {
-				key: operationKey,
-				version,
-				tenantId: asOptionalString(row.tenantId) ?? void 0
-			},
-			durationMs: asNumber(row.durationMs),
-			success: asBoolean(row.success),
-			timestamp,
-			errorCode: asOptionalString(row.errorCode) ?? void 0,
-			traceId: asOptionalString(row.traceId) ?? void 0,
-			metadata: isRecord(row.metadata) ? row.metadata : void 0
-		}];
-	});
-}
-function mapBaselineStats(result, operation, dateRange) {
-	const row = mapRows(result)[0];
-	if (!row) return null;
-	const totalCalls = asNumber(row.totalCalls);
-	if (!totalCalls) return null;
-	const successCount = asNumber(row.successCount);
-	const errorCount = asNumber(row.errorCount);
-	return {
-		operation,
-		totalCalls,
-		successRate: totalCalls ? successCount / totalCalls : 0,
-		errorRate: totalCalls ? errorCount / totalCalls : 0,
-		averageLatencyMs: asNumber(row.averageLatencyMs),
-		p95LatencyMs: asNumber(row.p95LatencyMs),
-		p99LatencyMs: asNumber(row.p99LatencyMs),
-		maxLatencyMs: asNumber(row.maxLatencyMs),
-		lastSeenAt: /* @__PURE__ */ new Date(),
-		windowStart: toDate(dateRange.from) ?? /* @__PURE__ */ new Date(),
-		windowEnd: toDate(dateRange.to) ?? /* @__PURE__ */ new Date(),
-		topErrors: {}
-	};
-}
-function mapRows(result) {
-	if (!Array.isArray(result.results) || !Array.isArray(result.columns)) return [];
-	const columns = result.columns;
-	return result.results.flatMap((row) => {
-		if (!Array.isArray(row)) return [];
-		const record = {};
-		columns.forEach((column, index) => {
-			record[column] = row[index];
-		});
-		return [record];
-	});
-}
-function buildWindowRange(windowDays) {
-	const windowEnd = /* @__PURE__ */ new Date();
-	return {
-		from: /* @__PURE__ */ new Date(windowEnd.getTime() - windowDays * 24 * 60 * 60 * 1e3),
-		to: windowEnd
-	};
-}
-function asString(value) {
-	if (typeof value === "string" && value.trim()) return value;
-	if (typeof value === "number") return String(value);
-	return null;
-}
-function asOptionalString(value) {
-	if (typeof value === "string") return value;
-	if (typeof value === "number") return String(value);
-	return null;
-}
-function asNumber(value) {
-	if (typeof value === "number" && Number.isFinite(value)) return value;
-	if (typeof value === "string" && value.trim()) {
-		const parsed = Number(value);
-		if (Number.isFinite(parsed)) return parsed;
-	}
-	return 0;
-}
-function asBoolean(value) {
-	if (typeof value === "boolean") return value;
-	if (typeof value === "number") return value !== 0;
-	if (typeof value === "string") return value.toLowerCase() === "true";
-	return false;
-}
-function asDate(value) {
-	if (value instanceof Date) return value;
-	if (typeof value === "string" || typeof value === "number") {
-		const date = new Date(value);
-		if (!Number.isNaN(date.getTime())) return date;
-	}
-	return null;
-}
-function toIsoString(value) {
-	if (!value) return void 0;
-	return typeof value === "string" ? value : value.toISOString();
-}
-function toDate(value) {
-	if (!value) return null;
-	return value instanceof Date ? value : new Date(value);
-}
-function isRecord(value) {
-	return typeof value === "object" && value !== null;
-}
-
-//#endregion
-export { PosthogTelemetryReader };
-//# sourceMappingURL=posthog-telemetry-reader.mjs.map

package/dist/analyzer/posthog-telemetry-reader.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"posthog-telemetry-reader.mjs","names":[],"sources":["../../src/analyzer/posthog-telemetry-reader.ts"],"sourcesContent":["import type {\n  AnalyticsReader,\n  AnalyticsQueryResult,\n  DateRangeInput,\n} from '@contractspec/lib.contracts/integrations/providers/analytics';\nimport type {\n  OperationCoordinate,\n  OperationMetricSample,\n  SpecUsageStats,\n} from '../types';\n\nexport interface ReadOperationSamplesInput {\n  operations?: OperationCoordinate[];\n  dateRange?: DateRangeInput;\n  limit?: number;\n}\n\nexport interface PosthogTelemetryReaderOptions {\n  eventPrefix?: string;\n}\n\nexport class PosthogTelemetryReader {\n  private readonly reader: AnalyticsReader;\n  private readonly eventPrefix: string;\n\n  constructor(\n    reader: AnalyticsReader,\n    options: PosthogTelemetryReaderOptions = {}\n  ) {\n    this.reader = reader;\n    this.eventPrefix = options.eventPrefix ?? 'observability';\n  }\n\n  async readOperationSamples(\n    input: ReadOperationSamplesInput\n  ): Promise<OperationMetricSample[]> {\n    const result = await this.queryHogQL({\n      query: [\n        'select',\n        '  properties.operation as operationKey,',\n        '  properties.version as version,',\n        '  properties.durationMs as durationMs,',\n        '  properties.success as success,',\n        '  properties.errorCode as errorCode,',\n        '  properties.tenantId as tenantId,',\n        '  properties.traceId as traceId,',\n        '  properties.metadata as metadata,',\n        '  timestamp as timestamp',\n        'from events',\n        `where ${buildOperationWhereClause(this.eventPrefix, input)}`,\n        'order by timestamp desc',\n        `limit ${input.limit ?? 1000}`,\n      ].join('\\n'),\n      values: buildOperationValues(input),\n    });\n\n    return mapOperationSamples(result);\n  }\n\n  async readAnomalyBaseline(\n    operation: OperationCoordinate,\n    windowDays = 7\n  ): Promise<SpecUsageStats | null> {\n    const dateRange = buildWindowRange(windowDays);\n    const baseResult = await this.queryHogQL({\n      query: [\n        'select',\n        '  count() as totalCalls,',\n        '  avg(properties.durationMs) as averageLatencyMs,',\n        '  quantile(0.95)(properties.durationMs) as p95LatencyMs,',\n        '  quantile(0.99)(properties.durationMs) as p99LatencyMs,',\n        '  max(properties.durationMs) as maxLatencyMs,',\n        '  sum(if(properties.success = 1, 1, 0)) as successCount,',\n        '  sum(if(properties.success = 0, 1, 0)) as errorCount',\n        'from events',\n        `where ${buildOperationWhereClause(this.eventPrefix, {\n          operations: [operation],\n          dateRange,\n        })}`,\n      ].join('\\n'),\n      values: buildOperationValues({\n        operations: [operation],\n        dateRange,\n      }),\n    });\n\n    const stats = mapBaselineStats(baseResult, operation, dateRange);\n    if (!stats) return null;\n\n    const topErrors = await this.readTopErrors(operation, dateRange);\n    return {\n      ...stats,\n      topErrors,\n    };\n  }\n\n  private async readTopErrors(\n    operation: OperationCoordinate,\n    dateRange: DateRangeInput\n  ): Promise<Record<string, number>> {\n    const result = await this.queryHogQL({\n      query: [\n        'select',\n        '  properties.errorCode as errorCode,',\n        '  count() as errorCount',\n        'from events',\n        `where ${buildOperationWhereClause(this.eventPrefix, {\n          operations: [operation],\n          dateRange,\n        })} and properties.success = 0`,\n        'group by errorCode',\n        'order by errorCount desc',\n        'limit 5',\n      ].join('\\n'),\n      values: buildOperationValues({\n        operations: [operation],\n        dateRange,\n      }),\n    });\n\n    const rows = mapRows(result);\n    return rows.reduce<Record<string, number>>((acc, row) => {\n      const code = asString(row.errorCode);\n      if (!code) return acc;\n      acc[code] = asNumber(row.errorCount);\n      return acc;\n    }, {});\n  }\n\n  private async queryHogQL(input: {\n    query: string;\n    values: Record<string, unknown>;\n  }): Promise<AnalyticsQueryResult> {\n    if (!this.reader.queryHogQL) {\n      throw new Error('Analytics reader does not support HogQL queries.');\n    }\n    return this.reader.queryHogQL(input);\n  }\n}\n\nfunction buildOperationWhereClause(\n  eventPrefix: string,\n  input: { operations?: OperationCoordinate[]; dateRange?: DateRangeInput }\n): string {\n  const clauses = [`event = '${eventPrefix}.operation'`];\n  if (input.operations?.length) {\n    clauses.push(`(${buildOperationFilters(input.operations)})`);\n  }\n  if (input.dateRange?.from) {\n    clauses.push('timestamp >= {dateFrom}');\n  }\n  if (input.dateRange?.to) {\n    clauses.push('timestamp < {dateTo}');\n  }\n  return clauses.join(' and ');\n}\n\nfunction buildOperationValues(input: {\n  operations?: OperationCoordinate[];\n  dateRange?: DateRangeInput;\n}): Record<string, unknown> {\n  const values: Record<string, unknown> = {\n    dateFrom: toIsoString(input.dateRange?.from),\n    dateTo: toIsoString(input.dateRange?.to),\n  };\n  input.operations?.forEach((op, index) => {\n    values[`operationKey${index}`] = op.key;\n    values[`operationVersion${index}`] = op.version;\n    if (op.tenantId) {\n      values[`operationTenant${index}`] = op.tenantId;\n    }\n  });\n  return values;\n}\n\nfunction buildOperationFilters(operations: OperationCoordinate[]): string {\n  return operations\n    .map((op, index) => {\n      const clauses = [\n        `properties.operation = {operationKey${index}}`,\n        `properties.version = {operationVersion${index}}`,\n      ];\n      if (op.tenantId) {\n        clauses.push(`properties.tenantId = {operationTenant${index}}`);\n      }\n      return `(${clauses.join(' and ')})`;\n    })\n    .join(' or ');\n}\n\nfunction mapOperationSamples(\n  result: AnalyticsQueryResult\n): OperationMetricSample[] {\n  const rows = mapRows(result);\n  return rows.flatMap((row) => {\n    const operationKey = asString(row.operationKey);\n    const version = asString(row.version);\n    const timestamp = asDate(row.timestamp);\n    if (!operationKey || !version || !timestamp) {\n      return [];\n    }\n    return [\n      {\n        operation: {\n          key: operationKey,\n          version,\n          tenantId: asOptionalString(row.tenantId) ?? undefined,\n        },\n        durationMs: asNumber(row.durationMs),\n        success: asBoolean(row.success),\n        timestamp,\n        errorCode: asOptionalString(row.errorCode) ?? undefined,\n        traceId: asOptionalString(row.traceId) ?? undefined,\n        metadata: isRecord(row.metadata) ? row.metadata : undefined,\n      },\n    ];\n  });\n}\n\nfunction mapBaselineStats(\n  result: AnalyticsQueryResult,\n  operation: OperationCoordinate,\n  dateRange: DateRangeInput\n): SpecUsageStats | null {\n  const rows = mapRows(result);\n  const row = rows[0];\n  if (!row) return null;\n  const totalCalls = asNumber(row.totalCalls);\n  if (!totalCalls) return null;\n  const successCount = asNumber(row.successCount);\n  const errorCount = asNumber(row.errorCount);\n  return {\n    operation,\n    totalCalls,\n    successRate: totalCalls ? successCount / totalCalls : 0,\n    errorRate: totalCalls ? errorCount / totalCalls : 0,\n    averageLatencyMs: asNumber(row.averageLatencyMs),\n    p95LatencyMs: asNumber(row.p95LatencyMs),\n    p99LatencyMs: asNumber(row.p99LatencyMs),\n    maxLatencyMs: asNumber(row.maxLatencyMs),\n    lastSeenAt: new Date(),\n    windowStart: toDate(dateRange.from) ?? new Date(),\n    windowEnd: toDate(dateRange.to) ?? new Date(),\n    topErrors: {},\n  };\n}\n\nfunction mapRows(result: AnalyticsQueryResult): Record<string, unknown>[] {\n  if (!Array.isArray(result.results) || !Array.isArray(result.columns)) {\n    return [];\n  }\n  const columns = result.columns;\n  return result.results.flatMap((row) => {\n    if (!Array.isArray(row)) return [];\n    const record: Record<string, unknown> = {};\n    columns.forEach((column, index) => {\n      record[column] = row[index];\n    });\n    return [record];\n  });\n}\n\nfunction buildWindowRange(windowDays: number): DateRangeInput {\n  const windowEnd = new Date();\n  const windowStart = new Date(\n    windowEnd.getTime() - windowDays * 24 * 60 * 60 * 1000\n  );\n  return {\n    from: windowStart,\n    to: windowEnd,\n  };\n}\n\nfunction asString(value: unknown): string | null {\n  if (typeof value === 'string' && value.trim()) return value;\n  if (typeof value === 'number') return String(value);\n  return null;\n}\n\nfunction asOptionalString(value: unknown): string | null {\n  if (typeof value === 'string') return value;\n  if (typeof value === 'number') return String(value);\n  return null;\n}\n\nfunction asNumber(value: unknown): number {\n  if (typeof value === 'number' && Number.isFinite(value)) return value;\n  if (typeof value === 'string' && value.trim()) {\n    const parsed = Number(value);\n    if (Number.isFinite(parsed)) return parsed;\n  }\n  return 0;\n}\n\nfunction asBoolean(value: unknown): boolean {\n  if (typeof value === 'boolean') return value;\n  if (typeof value === 'number') return value !== 0;\n  if (typeof value === 'string') return value.toLowerCase() === 'true';\n  return false;\n}\n\nfunction asDate(value: unknown): Date | null {\n  if (value instanceof Date) return value;\n  if (typeof value === 'string' || typeof value === 'number') {\n    const date = new Date(value);\n    if (!Number.isNaN(date.getTime())) return date;\n  }\n  return null;\n}\n\nfunction toIsoString(value?: string | Date): string | undefined {\n  if (!value) return undefined;\n  return typeof value === 'string' ? value : value.toISOString();\n}\n\nfunction toDate(value?: string | Date): Date | null {\n  if (!value) return null;\n  return value instanceof Date ? value : new Date(value);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n"],"mappings":"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"}

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

@@ -1,35 +0,0 @@
-import { IntentPattern, OperationMetricSample, OptimizationHint, SpecAnomaly, SpecUsageStats } from "../types.mjs";
-import { Logger } from "@contractspec/lib.observability";
-import { LifecycleStage } from "@contractspec/lib.lifecycle";
-
-//#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.mts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"spec-analyzer.d.mts","names":[],"sources":["../../src/analyzer/spec-analyzer.ts"],"mappings":";;;;;UAciB,mBAAA;EACf,MAAA,GAAS,MAAA;EACT,aAAA;EACA,kBAAA;EACA,qBAAA;EACA,uBAAA;AAAA;AAAA,cAcW,YAAA;EAAA,iBACM,MAAA;EAAA,iBACA,aAAA;EAAA,iBACA,kBAAA;EAAA,iBACA,qBAAA;EAAA,iBACA,uBAAA;cAEL,OAAA,GAAS,mBAAA;EAUrB,gBAAA,CAAiB,OAAA,EAAS,qBAAA,KAA0B,cAAA;EAmCpD,eAAA,CACE,KAAA,EAAO,cAAA,IACP,QAAA,GAAW,cAAA,KACV,WAAA;EAqFH,gBAAA,CACE,SAAA,EAAW,WAAA,IACX,KAAA,EAAO,cAAA,KACN,aAAA;EA6BH,oBAAA,CACE,KAAA,EAAO,cAAA,IACP,SAAA,EAAW,WAAA,IACX,gBAAA;IAAqB,KAAA,EAAO,cAAA;EAAA,IAC3B,gBAAA;EAAA,QAsEK,YAAA;EAAA,QAcA,eAAA;EAAA,QAoCA,UAAA;EAAA,QAMA,iBAAA;EAAA,QAeA,gBAAA;EAAA,QAaA,qBAAA;AAAA"}