@pcircle/claude-code-buddy-mcp 2.3.1

package/dist/db/QueryCache.js

@@ -0,0 +1,229 @@
+import { createHash } from 'crypto';
+import { logger } from '../utils/logger.js';
+export class QueryCache {
+    cache;
+    maxSize;
+    defaultTTL;
+    debug;
+    hits = 0;
+    misses = 0;
+    cleanupInterval;
+    cleanupErrorCount = 0;
+    MAX_CONSECUTIVE_CLEANUP_ERRORS = 5;
+    constructor(options = {}) {
+        this.maxSize = options.maxSize || 1000;
+        this.defaultTTL = options.defaultTTL || 5 * 60 * 1000;
+        this.debug = options.debug || false;
+        this.cache = new Map();
+        this.cleanupInterval = setInterval(() => {
+            try {
+                this.cleanup();
+                this.cleanupErrorCount = 0;
+            }
+            catch (error) {
+                this.cleanupErrorCount++;
+                logger.error('[QueryCache] Cleanup error:', {
+                    error: error instanceof Error ? error.message : String(error),
+                    stack: error instanceof Error ? error.stack : undefined,
+                    consecutiveErrors: this.cleanupErrorCount,
+                });
+                if (this.cleanupErrorCount >= this.MAX_CONSECUTIVE_CLEANUP_ERRORS) {
+                    logger.error(`[QueryCache] Cleanup failed ${this.cleanupErrorCount} times consecutively - destroying cache`, {
+                        maxErrors: this.MAX_CONSECUTIVE_CLEANUP_ERRORS,
+                        cacheSize: this.cache.size,
+                    });
+                    if (this.cleanupInterval) {
+                        clearInterval(this.cleanupInterval);
+                        this.cleanupInterval = undefined;
+                    }
+                    this.destroy();
+                }
+            }
+        }, 60 * 1000);
+        if (this.debug) {
+            logger.debug('[QueryCache] Initialized', {
+                maxSize: this.maxSize,
+                defaultTTL: this.defaultTTL,
+            });
+        }
+    }
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.misses++;
+            if (this.debug) {
+                logger.debug('[QueryCache] Miss', { key });
+            }
+            return undefined;
+        }
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            this.misses++;
+            if (this.debug) {
+                logger.debug('[QueryCache] Expired', { key });
+            }
+            return undefined;
+        }
+        entry.lastAccessed = Date.now();
+        this.hits++;
+        if (this.debug) {
+            logger.debug('[QueryCache] Hit', { key });
+        }
+        return entry.value;
+    }
+    set(key, value, ttl) {
+        if (this.cache.size >= this.maxSize) {
+            this.evictLRU();
+        }
+        const expiresAt = Date.now() + (ttl || this.defaultTTL);
+        const size = this.estimateSize(value);
+        this.cache.set(key, {
+            value,
+            expiresAt,
+            lastAccessed: Date.now(),
+            size,
+        });
+        if (this.debug) {
+            logger.debug('[QueryCache] Set', { key, ttl: ttl || this.defaultTTL, size });
+        }
+    }
+    delete(key) {
+        const deleted = this.cache.delete(key);
+        if (this.debug && deleted) {
+            logger.debug('[QueryCache] Delete', { key });
+        }
+        return deleted;
+    }
+    clear() {
+        const prevSize = this.cache.size;
+        this.cache.clear();
+        this.hits = 0;
+        this.misses = 0;
+        if (this.debug) {
+            logger.debug('[QueryCache] Clear', { entriesCleared: prevSize });
+        }
+    }
+    invalidatePattern(pattern) {
+        let count = 0;
+        for (const key of this.cache.keys()) {
+            const keyStr = String(key);
+            if (pattern.test(keyStr)) {
+                this.cache.delete(key);
+                count++;
+            }
+        }
+        if (this.debug) {
+            logger.debug('[QueryCache] Pattern invalidation', {
+                pattern: pattern.source,
+                invalidated: count,
+            });
+        }
+        return count;
+    }
+    has(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return false;
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    getStats() {
+        const totalAccesses = this.hits + this.misses;
+        const hitRate = totalAccesses > 0 ? (this.hits / totalAccesses) * 100 : 0;
+        const entries = Array.from(this.cache.values());
+        const memoryUsage = entries.reduce((sum, entry) => sum + entry.size, 0);
+        const accessTimes = entries.map(entry => entry.lastAccessed);
+        return {
+            hits: this.hits,
+            misses: this.misses,
+            hitRate: Math.round(hitRate * 100) / 100,
+            size: this.cache.size,
+            maxSize: this.maxSize,
+            memoryUsage,
+            oldestEntry: accessTimes.length > 0 ? Math.min(...accessTimes) : null,
+            newestEntry: accessTimes.length > 0 ? Math.max(...accessTimes) : null,
+        };
+    }
+    get size() {
+        return this.cache.size;
+    }
+    cleanup() {
+        const now = Date.now();
+        let removed = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            if (now > entry.expiresAt) {
+                this.cache.delete(key);
+                removed++;
+            }
+        }
+        if (this.debug && removed > 0) {
+            logger.debug('[QueryCache] Cleanup', { removed });
+        }
+        return removed;
+    }
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+        }
+        this.clear();
+        if (this.debug) {
+            logger.debug('[QueryCache] Destroyed');
+        }
+    }
+    dispose() {
+        this.destroy();
+    }
+    static generateKey(query, params) {
+        const serialized = JSON.stringify({ query, params: params || [] });
+        return createHash('sha256').update(serialized).digest('hex').slice(0, 16);
+    }
+    evictLRU() {
+        let lruKey = null;
+        let lruTime = Infinity;
+        for (const [key, entry] of this.cache.entries()) {
+            if (entry.lastAccessed < lruTime) {
+                lruTime = entry.lastAccessed;
+                lruKey = key;
+            }
+        }
+        if (lruKey !== null) {
+            this.cache.delete(lruKey);
+            if (this.debug) {
+                logger.debug('[QueryCache] LRU eviction', { key: lruKey });
+            }
+        }
+    }
+    estimateSize(value) {
+        try {
+            const json = JSON.stringify(value);
+            return json.length * 2;
+        }
+        catch {
+            return 1024;
+        }
+    }
+}
+export class DatabaseQueryCache extends QueryCache {
+    constructor(options = {}) {
+        super({
+            maxSize: options.maxSize || 1000,
+            defaultTTL: options.defaultTTL || 5 * 60 * 1000,
+            debug: options.debug || false,
+        });
+    }
+    async cachedQuery(query, params, executor, ttl) {
+        const key = QueryCache.generateKey(query, params);
+        const cached = this.get(key);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const result = await executor();
+        this.set(key, result, ttl);
+        return result;
+    }
+}
+//# sourceMappingURL=QueryCache.js.map

package/dist/db/QueryCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryCache.js","sourceRoot":"","sources":["../../src/db/QueryCache.ts"],"names":[],"mappings":"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"}

package/dist/errors/index.d.ts

@@ -0,0 +1,62 @@
+export declare enum ErrorCode {
+    VALIDATION_FAILED = "VALIDATION_FAILED",
+    INVALID_INPUT = "INVALID_INPUT",
+    INVALID_RANGE = "INVALID_RANGE",
+    INVALID_FORMAT = "INVALID_FORMAT",
+    REQUIRED_FIELD_MISSING = "REQUIRED_FIELD_MISSING",
+    NOT_INITIALIZED = "NOT_INITIALIZED",
+    ALREADY_INITIALIZED = "ALREADY_INITIALIZED",
+    INVALID_STATE = "INVALID_STATE",
+    OPERATION_NOT_ALLOWED = "OPERATION_NOT_ALLOWED",
+    RESOURCE_NOT_FOUND = "RESOURCE_NOT_FOUND",
+    ENTITY_NOT_FOUND = "ENTITY_NOT_FOUND",
+    TASK_NOT_FOUND = "TASK_NOT_FOUND",
+    TOOL_NOT_FOUND = "TOOL_NOT_FOUND",
+    CONFIGURATION_INVALID = "CONFIGURATION_INVALID",
+    CONFIGURATION_MISSING = "CONFIGURATION_MISSING",
+    API_KEY_MISSING = "API_KEY_MISSING",
+    UNSUPPORTED_OPTION = "UNSUPPORTED_OPTION",
+    OPERATION_FAILED = "OPERATION_FAILED",
+    INITIALIZATION_FAILED = "INITIALIZATION_FAILED",
+    EXECUTION_FAILED = "EXECUTION_FAILED",
+    DIMENSION_MISMATCH = "DIMENSION_MISMATCH",
+    EXTERNAL_SERVICE_ERROR = "EXTERNAL_SERVICE_ERROR",
+    API_REQUEST_FAILED = "API_REQUEST_FAILED",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    TIMEOUT_ERROR = "TIMEOUT_ERROR"
+}
+export declare class BaseError extends Error {
+    readonly code: ErrorCode;
+    readonly context?: Record<string, unknown>;
+    readonly timestamp: Date;
+    constructor(message: string, code: ErrorCode, context?: Record<string, unknown>);
+    toJSON(): Record<string, unknown>;
+}
+export declare class ValidationError extends BaseError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+export declare class StateError extends BaseError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+export declare class NotFoundError extends BaseError {
+    constructor(message: string, resourceType?: string, resourceId?: string, context?: Record<string, unknown>);
+}
+export declare class ConfigurationError extends BaseError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+export declare class OperationError extends BaseError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+export declare class ExternalServiceError extends BaseError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+export declare function isBaseError(error: unknown): error is BaseError;
+export declare function isValidationError(error: unknown): error is ValidationError;
+export declare function isStateError(error: unknown): error is StateError;
+export declare function isNotFoundError(error: unknown): error is NotFoundError;
+export declare function isConfigurationError(error: unknown): error is ConfigurationError;
+export declare function isOperationError(error: unknown): error is OperationError;
+export declare function isExternalServiceError(error: unknown): error is ExternalServiceError;
+export declare function getErrorMessage(error: unknown): string;
+export declare function getErrorCode(error: unknown): ErrorCode | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"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"}

package/dist/errors/index.js

@@ -0,0 +1,124 @@
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["VALIDATION_FAILED"] = "VALIDATION_FAILED";
+    ErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+    ErrorCode["INVALID_RANGE"] = "INVALID_RANGE";
+    ErrorCode["INVALID_FORMAT"] = "INVALID_FORMAT";
+    ErrorCode["REQUIRED_FIELD_MISSING"] = "REQUIRED_FIELD_MISSING";
+    ErrorCode["NOT_INITIALIZED"] = "NOT_INITIALIZED";
+    ErrorCode["ALREADY_INITIALIZED"] = "ALREADY_INITIALIZED";
+    ErrorCode["INVALID_STATE"] = "INVALID_STATE";
+    ErrorCode["OPERATION_NOT_ALLOWED"] = "OPERATION_NOT_ALLOWED";
+    ErrorCode["RESOURCE_NOT_FOUND"] = "RESOURCE_NOT_FOUND";
+    ErrorCode["ENTITY_NOT_FOUND"] = "ENTITY_NOT_FOUND";
+    ErrorCode["TASK_NOT_FOUND"] = "TASK_NOT_FOUND";
+    ErrorCode["TOOL_NOT_FOUND"] = "TOOL_NOT_FOUND";
+    ErrorCode["CONFIGURATION_INVALID"] = "CONFIGURATION_INVALID";
+    ErrorCode["CONFIGURATION_MISSING"] = "CONFIGURATION_MISSING";
+    ErrorCode["API_KEY_MISSING"] = "API_KEY_MISSING";
+    ErrorCode["UNSUPPORTED_OPTION"] = "UNSUPPORTED_OPTION";
+    ErrorCode["OPERATION_FAILED"] = "OPERATION_FAILED";
+    ErrorCode["INITIALIZATION_FAILED"] = "INITIALIZATION_FAILED";
+    ErrorCode["EXECUTION_FAILED"] = "EXECUTION_FAILED";
+    ErrorCode["DIMENSION_MISMATCH"] = "DIMENSION_MISMATCH";
+    ErrorCode["EXTERNAL_SERVICE_ERROR"] = "EXTERNAL_SERVICE_ERROR";
+    ErrorCode["API_REQUEST_FAILED"] = "API_REQUEST_FAILED";
+    ErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    ErrorCode["TIMEOUT_ERROR"] = "TIMEOUT_ERROR";
+})(ErrorCode || (ErrorCode = {}));
+export class BaseError extends Error {
+    code;
+    context;
+    timestamp;
+    constructor(message, code, context) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.context = context;
+        this.timestamp = new Date();
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            context: this.context,
+            timestamp: this.timestamp.toISOString(),
+            stack: this.stack,
+        };
+    }
+}
+export class ValidationError extends BaseError {
+    constructor(message, context) {
+        super(message, ErrorCode.VALIDATION_FAILED, context);
+    }
+}
+export class StateError extends BaseError {
+    constructor(message, context) {
+        super(message, ErrorCode.INVALID_STATE, context);
+    }
+}
+export class NotFoundError extends BaseError {
+    constructor(message, resourceType, resourceId, context) {
+        super(message, ErrorCode.RESOURCE_NOT_FOUND, {
+            resourceType,
+            resourceId,
+            ...context,
+        });
+    }
+}
+export class ConfigurationError extends BaseError {
+    constructor(message, context) {
+        super(message, ErrorCode.CONFIGURATION_INVALID, context);
+    }
+}
+export class OperationError extends BaseError {
+    constructor(message, context) {
+        super(message, ErrorCode.OPERATION_FAILED, context);
+    }
+}
+export class ExternalServiceError extends BaseError {
+    constructor(message, context) {
+        super(message, ErrorCode.EXTERNAL_SERVICE_ERROR, context);
+    }
+}
+export function isBaseError(error) {
+    return error instanceof BaseError;
+}
+export function isValidationError(error) {
+    return error instanceof ValidationError;
+}
+export function isStateError(error) {
+    return error instanceof StateError;
+}
+export function isNotFoundError(error) {
+    return error instanceof NotFoundError;
+}
+export function isConfigurationError(error) {
+    return error instanceof ConfigurationError;
+}
+export function isOperationError(error) {
+    return error instanceof OperationError;
+}
+export function isExternalServiceError(error) {
+    return error instanceof ExternalServiceError;
+}
+export function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    return String(error);
+}
+export function getErrorCode(error) {
+    if (isBaseError(error)) {
+        return error.code;
+    }
+    return undefined;
+}
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"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"}

package/dist/evolution/ABTestManager.d.ts

@@ -0,0 +1,21 @@
+import type { ABTestExperiment, ABTestVariant, ABTestAssignment, ABTestResults } from './types.js';
+export interface CreateExperimentOptions {
+    durationDays?: number;
+    minSampleSize?: number;
+    significanceLevel?: number;
+    secondaryMetrics?: string[];
+}
+export declare class ABTestManager {
+    private experiments;
+    private assignments;
+    private metrics;
+    private analyzer;
+    createExperiment(id: string, name: string, variants: ABTestVariant[], trafficSplit: number[], successMetric: 'quality_score' | 'cost' | 'duration' | 'user_satisfaction', options?: CreateExperimentOptions): ABTestExperiment;
+    startExperiment(experimentId: string): void;
+    assignVariant(experimentId: string, agentId: string): ABTestAssignment;
+    private hashToVariant;
+    addMetric(experimentId: string, variantName: string, metrics: Record<string, number>): void;
+    analyzeResults(experimentId: string): ABTestResults;
+    getExperiment(experimentId: string): ABTestExperiment | undefined;
+}
+//# sourceMappingURL=ABTestManager.d.ts.map

package/dist/evolution/ABTestManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ABTestManager.d.ts","sourceRoot":"","sources":["../../src/evolution/ABTestManager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,aAAa,EAEd,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,uBAAuB;IAKtC,YAAY,CAAC,EAAE,MAAM,CAAC;IAMtB,aAAa,CAAC,EAAE,MAAM,CAAC;IAMvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAK3B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAOD,qBAAa,aAAa;IACxB,OAAO,CAAC,WAAW,CAA4C;IAC/D,OAAO,CAAC,WAAW,CAA8C;IACjE,OAAO,CAAC,OAAO,CAAiE;IAChF,OAAO,CAAC,QAAQ,CAAkD;IAalE,gBAAgB,CACd,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,aAAa,EAAE,EACzB,YAAY,EAAE,MAAM,EAAE,EACtB,aAAa,EAAE,eAAe,GAAG,MAAM,GAAG,UAAU,GAAG,mBAAmB,EAC1E,OAAO,GAAE,uBAA4B,GACpC,gBAAgB;IAgDnB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAsB3C,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB;IA4CtE,OAAO,CAAC,aAAa;IAyBrB,SAAS,CACP,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,IAAI;IAoBP,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa;IAyHnD,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;CAGlE"}

package/dist/evolution/ABTestManager.js

@@ -0,0 +1,183 @@
+import crypto from 'crypto';
+import { StatisticalAnalyzer } from './StatisticalAnalyzer.js';
+import { ValidationError, NotFoundError } from '../errors/index.js';
+export class ABTestManager {
+    experiments = new Map();
+    assignments = new Map();
+    metrics = new Map();
+    analyzer = new StatisticalAnalyzer();
+    createExperiment(id, name, variants, trafficSplit, successMetric, options = {}) {
+        if (variants.length !== trafficSplit.length) {
+            throw new ValidationError('Variants and traffic split must have same length', {
+                component: 'ABTestManager',
+                method: 'createExperiment',
+                variantsLength: variants.length,
+                trafficSplitLength: trafficSplit.length,
+                constraint: 'variants.length === trafficSplit.length',
+            });
+        }
+        const sum = trafficSplit.reduce((acc, val) => acc + val, 0);
+        if (Math.abs(sum - 1.0) > 0.001) {
+            throw new ValidationError('Traffic split must sum to 1.0', {
+                component: 'ABTestManager',
+                method: 'createExperiment',
+                actualSum: sum,
+                constraint: 'sum(trafficSplit) === 1.0',
+            });
+        }
+        const experiment = {
+            id,
+            name,
+            description: name,
+            variants,
+            trafficSplit,
+            successMetric,
+            secondaryMetrics: options.secondaryMetrics,
+            durationDays: options.durationDays ?? 7,
+            minSampleSize: options.minSampleSize ?? 30,
+            significanceLevel: options.significanceLevel ?? 0.05,
+            status: 'draft',
+        };
+        this.experiments.set(id, experiment);
+        this.assignments.set(id, []);
+        this.metrics.set(id, new Map());
+        return experiment;
+    }
+    startExperiment(experimentId) {
+        const experiment = this.experiments.get(experimentId);
+        if (!experiment) {
+            throw new NotFoundError(`Experiment ${experimentId} not found`, 'experiment', experimentId, { availableExperiments: Array.from(this.experiments.keys()) });
+        }
+        experiment.status = 'running';
+        experiment.startedAt = new Date();
+    }
+    assignVariant(experimentId, agentId) {
+        const experiment = this.experiments.get(experimentId);
+        if (!experiment) {
+            throw new NotFoundError(`Experiment ${experimentId} not found`, 'experiment', experimentId, { availableExperiments: Array.from(this.experiments.keys()) });
+        }
+        const assignments = this.assignments.get(experimentId);
+        const existing = assignments.find((a) => a.agentId === agentId);
+        if (existing) {
+            return existing;
+        }
+        const variantIndex = this.hashToVariant(`${experimentId}:${agentId}`, experiment.trafficSplit);
+        const assignment = {
+            id: `${experimentId}:${agentId}`,
+            experimentId,
+            agentId,
+            variantName: experiment.variants[variantIndex].name,
+            assignedAt: new Date(),
+        };
+        assignments.push(assignment);
+        return assignment;
+    }
+    hashToVariant(key, trafficSplit) {
+        const hash = crypto.createHash('md5').update(key).digest('hex');
+        const hashInt = parseInt(hash.substring(0, 8), 16);
+        const normalizedHash = (hashInt % 100000) / 100000;
+        let cumulative = 0;
+        for (let i = 0; i < trafficSplit.length; i++) {
+            cumulative += trafficSplit[i];
+            if (normalizedHash < cumulative) {
+                return i;
+            }
+        }
+        return trafficSplit.length - 1;
+    }
+    addMetric(experimentId, variantName, metrics) {
+        if (!this.metrics.has(experimentId)) {
+            this.metrics.set(experimentId, new Map());
+        }
+        const experimentMetrics = this.metrics.get(experimentId);
+        if (!experimentMetrics.has(variantName)) {
+            experimentMetrics.set(variantName, []);
+        }
+        experimentMetrics.get(variantName).push(metrics);
+    }
+    analyzeResults(experimentId) {
+        const experiment = this.experiments.get(experimentId);
+        if (!experiment) {
+            throw new NotFoundError(`Experiment ${experimentId} not found`, 'experiment', experimentId, { availableExperiments: Array.from(this.experiments.keys()) });
+        }
+        const experimentMetrics = this.metrics.get(experimentId);
+        if (!experimentMetrics) {
+            throw new NotFoundError(`No metrics found for experiment ${experimentId}`, 'experimentMetrics', experimentId, {
+                experiment: experimentId,
+                availableMetrics: Array.from(this.metrics.keys())
+            });
+        }
+        const variantStats = {};
+        for (const variant of experiment.variants) {
+            const metrics = experimentMetrics.get(variant.name) || [];
+            const successMetricValues = metrics.map((m) => m[experiment.successMetric] || 0);
+            if (successMetricValues.length === 0) {
+                variantStats[variant.name] = {
+                    variantName: variant.name,
+                    sampleSize: 0,
+                    successRate: 0,
+                    mean: 0,
+                    stdDev: 0,
+                    confidenceInterval: [0, 0],
+                };
+                continue;
+            }
+            const mean = this.analyzer.calculateMean(successMetricValues);
+            const stdDev = this.analyzer.calculateStdDev(successMetricValues);
+            const ci = this.analyzer.calculateConfidenceInterval(successMetricValues);
+            variantStats[variant.name] = {
+                variantName: variant.name,
+                sampleSize: successMetricValues.length,
+                successRate: mean,
+                mean,
+                stdDev,
+                confidenceInterval: ci,
+            };
+        }
+        const variantNames = experiment.variants.map((v) => v.name);
+        const control = experimentMetrics.get(variantNames[0]) || [];
+        const treatment = experimentMetrics.get(variantNames[1]) || [];
+        const controlValues = control.map((m) => m[experiment.successMetric] || 0);
+        const treatmentValues = treatment.map((m) => m[experiment.successMetric] || 0);
+        let pValue = 1.0;
+        let effectSize = 0;
+        let winner = null;
+        let recommendation = '';
+        if (controlValues.length >= experiment.minSampleSize &&
+            treatmentValues.length >= experiment.minSampleSize) {
+            const tTest = this.analyzer.welchTTest(controlValues, treatmentValues);
+            effectSize = this.analyzer.calculateEffectSize(controlValues, treatmentValues);
+            pValue = tTest.pValue;
+            if (pValue < experiment.significanceLevel) {
+                const controlMean = this.analyzer.calculateMean(controlValues);
+                const treatmentMean = this.analyzer.calculateMean(treatmentValues);
+                winner = treatmentMean > controlMean ? variantNames[1] : variantNames[0];
+                recommendation = `Statistically significant difference detected (p=${pValue.toFixed(4)}). Winner: ${winner}`;
+            }
+            else {
+                recommendation = 'No statistically significant difference detected';
+            }
+        }
+        else {
+            recommendation = `Insufficient data. Need at least ${experiment.minSampleSize} samples per variant.`;
+        }
+        const results = {
+            experimentId,
+            winner,
+            confidence: 1 - pValue,
+            variantStats,
+            statisticalTests: {
+                testType: 't-test',
+                pValue,
+                effectSize,
+                confidenceInterval: [0, 0],
+            },
+            recommendation,
+        };
+        return results;
+    }
+    getExperiment(experimentId) {
+        return this.experiments.get(experimentId);
+    }
+}
+//# sourceMappingURL=ABTestManager.js.map