@skillsmith/core 0.5.5 → 0.5.6

package/dist/analytics/AnalyticsRepository.js

@@ -0,0 +1,245 @@
+/**
+ * AnalyticsRepository - CRUD operations for analytics data
+ *
+ * Provides type-safe access to:
+ * - Usage event tracking
+ * - Experiment management
+ * - ROI metrics storage
+ * - Value attribution
+ */
+import { randomUUID } from 'crypto';
+import { rowToUsageEvent, rowToExperiment, rowToAssignment, rowToOutcome, rowToROIMetrics, } from './AnalyticsRepository.helpers.js';
+/**
+ * Repository for analytics operations
+ */
+export class AnalyticsRepository {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    // ==================== Usage Events ====================
+    /**
+     * Record a skill usage event
+     * SMI-992: Explicitly set timestamp from JS Date for fake timer compatibility
+     */
+    recordUsageEvent(input) {
+        const id = randomUUID();
+        const context = input.context ? JSON.stringify(input.context) : null;
+        // SMI-992: Use JavaScript Date instead of SQLite datetime('now') for testability
+        const timestamp = new Date().toISOString();
+        const stmt = this.db.prepare(`
+      INSERT INTO skill_usage_events (id, skill_id, user_id, session_id, event_type, context, value_score, timestamp)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        stmt.run(id, input.skillId, input.userId, input.sessionId, input.eventType, context, input.valueScore ?? null, timestamp);
+        return this.getUsageEvent(id);
+    }
+    /**
+     * Get a usage event by ID
+     */
+    getUsageEvent(id) {
+        const row = this.db.prepare('SELECT * FROM skill_usage_events WHERE id = ?').get(id);
+        if (!row)
+            return null;
+        return rowToUsageEvent(row);
+    }
+    /**
+     * Get usage events for a skill within a time period
+     */
+    getUsageEventsForSkill(skillId, startDate, endDate) {
+        const rows = this.db
+            .prepare(`SELECT * FROM skill_usage_events
+         WHERE skill_id = ? AND timestamp >= ? AND timestamp <= ?
+         ORDER BY timestamp DESC`)
+            .all(skillId, startDate, endDate);
+        return rows.map(rowToUsageEvent);
+    }
+    /**
+     * Get usage events for a user
+     */
+    getUsageEventsForUser(userId, startDate, endDate) {
+        const rows = this.db
+            .prepare(`SELECT * FROM skill_usage_events
+         WHERE user_id = ? AND timestamp >= ? AND timestamp <= ?
+         ORDER BY timestamp DESC`)
+            .all(userId, startDate, endDate);
+        return rows.map(rowToUsageEvent);
+    }
+    /**
+     * Get all usage events within a time period
+     */
+    getAllUsageEvents(startDate, endDate) {
+        const rows = this.db
+            .prepare(`SELECT * FROM skill_usage_events
+         WHERE timestamp >= ? AND timestamp <= ?
+         ORDER BY timestamp DESC`)
+            .all(startDate, endDate);
+        return rows.map(rowToUsageEvent);
+    }
+    /**
+     * Delete usage events older than the retention period (30 days default)
+     */
+    cleanupOldEvents(retentionDays = 30) {
+        const cutoffDate = new Date();
+        cutoffDate.setDate(cutoffDate.getDate() - retentionDays);
+        const cutoff = cutoffDate.toISOString();
+        const result = this.db.prepare('DELETE FROM skill_usage_events WHERE timestamp < ?').run(cutoff);
+        return result.changes;
+    }
+    // ==================== Experiments ====================
+    /**
+     * Create a new experiment
+     */
+    createExperiment(input) {
+        const id = randomUUID();
+        const variantA = JSON.stringify(input.variantA);
+        const variantB = JSON.stringify(input.variantB);
+        const stmt = this.db.prepare(`
+      INSERT INTO experiments (id, name, description, hypothesis, variant_a, variant_b, target_sample_size)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `);
+        stmt.run(id, input.name, input.description ?? null, input.hypothesis ?? null, variantA, variantB, input.targetSampleSize ?? 100);
+        return this.getExperiment(id);
+    }
+    /**
+     * Get an experiment by ID
+     */
+    getExperiment(id) {
+        const row = this.db.prepare('SELECT * FROM experiments WHERE id = ?').get(id);
+        if (!row)
+            return null;
+        return rowToExperiment(row);
+    }
+    /**
+     * Get experiment by name
+     */
+    getExperimentByName(name) {
+        const row = this.db.prepare('SELECT * FROM experiments WHERE name = ?').get(name);
+        if (!row)
+            return null;
+        return rowToExperiment(row);
+    }
+    /**
+     * Update experiment status
+     */
+    updateExperimentStatus(id, status) {
+        const result = this.db
+            .prepare("UPDATE experiments SET status = ?, updated_at = datetime('now') WHERE id = ?")
+            .run(status, id);
+        return result.changes > 0;
+    }
+    /**
+     * Get all active experiments
+     */
+    getActiveExperiments() {
+        const rows = this.db
+            .prepare("SELECT * FROM experiments WHERE status = 'active' ORDER BY created_at DESC")
+            .all();
+        return rows.map(rowToExperiment);
+    }
+    // ==================== Experiment Assignments ====================
+    /**
+     * Assign a user to an experiment variant
+     */
+    assignUserToExperiment(experimentId, userId, variant) {
+        const id = randomUUID();
+        const stmt = this.db.prepare(`
+      INSERT INTO experiment_assignments (id, experiment_id, user_id, variant)
+      VALUES (?, ?, ?, ?)
+      ON CONFLICT(experiment_id, user_id) DO UPDATE SET variant = excluded.variant
+    `);
+        stmt.run(id, experimentId, userId, variant);
+        const row = this.db
+            .prepare('SELECT * FROM experiment_assignments WHERE experiment_id = ? AND user_id = ?')
+            .get(experimentId, userId);
+        return rowToAssignment(row);
+    }
+    /**
+     * Get user's assignment for an experiment
+     */
+    getUserAssignment(experimentId, userId) {
+        const row = this.db
+            .prepare('SELECT * FROM experiment_assignments WHERE experiment_id = ? AND user_id = ?')
+            .get(experimentId, userId);
+        if (!row)
+            return null;
+        return rowToAssignment(row);
+    }
+    /**
+     * Get all assignments for an experiment
+     */
+    getExperimentAssignments(experimentId) {
+        const rows = this.db
+            .prepare('SELECT * FROM experiment_assignments WHERE experiment_id = ?')
+            .all(experimentId);
+        return rows.map(rowToAssignment);
+    }
+    // ==================== Experiment Outcomes ====================
+    /**
+     * Record an experiment outcome
+     */
+    recordOutcome(input) {
+        const id = randomUUID();
+        const metadata = input.metadata ? JSON.stringify(input.metadata) : null;
+        const stmt = this.db.prepare(`
+      INSERT INTO experiment_outcomes (id, experiment_id, assignment_id, outcome_type, outcome_value, metadata)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `);
+        stmt.run(id, input.experimentId, input.assignmentId, input.outcomeType, input.outcomeValue, metadata);
+        const row = this.db
+            .prepare('SELECT * FROM experiment_outcomes WHERE id = ?')
+            .get(id);
+        return rowToOutcome(row);
+    }
+    /**
+     * Get outcomes for an experiment
+     */
+    getExperimentOutcomes(experimentId) {
+        const rows = this.db
+            .prepare('SELECT * FROM experiment_outcomes WHERE experiment_id = ? ORDER BY measured_at DESC')
+            .all(experimentId);
+        return rows.map(rowToOutcome);
+    }
+    // ==================== ROI Metrics ====================
+    /**
+     * Store computed ROI metrics
+     */
+    storeROIMetrics(metrics) {
+        const id = randomUUID();
+        const metadata = metrics.metadata ? JSON.stringify(metrics.metadata) : null;
+        const stmt = this.db.prepare(`
+      INSERT INTO roi_metrics (
+        id, metric_type, entity_id, period_start, period_end,
+        total_activations, total_invocations, total_successes, total_failures,
+        avg_value_score, estimated_time_saved, estimated_value_usd, metadata
+      )
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        stmt.run(id, metrics.metricType, metrics.entityId ?? null, metrics.periodStart, metrics.periodEnd, metrics.totalActivations, metrics.totalInvocations, metrics.totalSuccesses, metrics.totalFailures, metrics.avgValueScore, metrics.estimatedTimeSaved, metrics.estimatedValueUsd, metadata);
+        const row = this.db.prepare('SELECT * FROM roi_metrics WHERE id = ?').get(id);
+        return rowToROIMetrics(row);
+    }
+    /**
+     * Get ROI metrics for a period
+     */
+    getROIMetrics(metricType, startDate, endDate) {
+        const rows = this.db
+            .prepare(`SELECT * FROM roi_metrics
+         WHERE metric_type = ? AND period_start >= ? AND period_end <= ?
+         ORDER BY period_start DESC`)
+            .all(metricType, startDate, endDate);
+        return rows.map(rowToROIMetrics);
+    }
+    /**
+     * Get ROI metrics for a specific entity (user or skill)
+     */
+    getEntityROIMetrics(entityId, startDate, endDate) {
+        const rows = this.db
+            .prepare(`SELECT * FROM roi_metrics
+         WHERE entity_id = ? AND period_start >= ? AND period_end <= ?
+         ORDER BY period_start DESC`)
+            .all(entityId, startDate, endDate);
+        return rows.map(rowToROIMetrics);
+    }
+}
+//# sourceMappingURL=AnalyticsRepository.js.map

package/dist/analytics/AnalyticsRepository.js.map

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

package/dist/analytics/AnalyticsRepository.types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * AnalyticsRepository Internal Types
+ *
+ * Raw database row types used for type-safe parsing of external database data.
+ * These are internal types for the repository implementation.
+ */
+/**
+ * Raw database row type for skill_usage_events table
+ * Used for type-safe parsing of external database data
+ */
+export interface UsageEventRow {
+    id: string;
+    skill_id: string;
+    user_id: string;
+    session_id: string;
+    event_type: string;
+    context: string | null;
+    value_score: number | null;
+    timestamp: string;
+    created_at: string;
+}
+/**
+ * Raw database row type for experiments table
+ */
+export interface ExperimentRow {
+    id: string;
+    name: string;
+    description: string | null;
+    hypothesis: string | null;
+    status: string;
+    variant_a: string;
+    variant_b: string;
+    start_date: string | null;
+    end_date: string | null;
+    target_sample_size: number;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Raw database row type for experiment_assignments table
+ */
+export interface ExperimentAssignmentRow {
+    id: string;
+    experiment_id: string;
+    user_id: string;
+    variant: string;
+    assigned_at: string;
+}
+/**
+ * Raw database row type for experiment_outcomes table
+ */
+export interface ExperimentOutcomeRow {
+    id: string;
+    experiment_id: string;
+    assignment_id: string;
+    outcome_type: string;
+    outcome_value: number;
+    metadata: string | null;
+    measured_at: string;
+    created_at: string;
+}
+/**
+ * Raw database row type for roi_metrics table
+ */
+export interface ROIMetricsRow {
+    id: string;
+    metric_type: string;
+    entity_id: string | null;
+    period_start: string;
+    period_end: string;
+    total_activations: number;
+    total_invocations: number;
+    total_successes: number;
+    total_failures: number;
+    avg_value_score: number;
+    estimated_time_saved: number;
+    estimated_value_usd: number;
+    metadata: string | null;
+    computed_at: string;
+    created_at: string;
+}
+//# sourceMappingURL=AnalyticsRepository.types.d.ts.map

package/dist/analytics/AnalyticsRepository.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsRepository.types.d.ts","sourceRoot":"","sources":["../../src/analytics/AnalyticsRepository.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAA;IACV,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,EAAE,MAAM,CAAA;IACzB,iBAAiB,EAAE,MAAM,CAAA;IACzB,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;CACnB"}

package/dist/analytics/AnalyticsRepository.types.js

@@ -0,0 +1,8 @@
+/**
+ * AnalyticsRepository Internal Types
+ *
+ * Raw database row types used for type-safe parsing of external database data.
+ * These are internal types for the repository implementation.
+ */
+export {};
+//# sourceMappingURL=AnalyticsRepository.types.js.map

package/dist/analytics/AnalyticsRepository.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsRepository.types.js","sourceRoot":"","sources":["../../src/analytics/AnalyticsRepository.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/analytics/ExperimentService.d.ts

@@ -0,0 +1,70 @@
+/**
+ * ExperimentService - Epic 4: A/B Testing Infrastructure
+ *
+ * Implements:
+ * - Experiment assignment system with balanced randomization
+ * - Outcome tracking and data collection
+ * - Basic statistical analysis
+ * - Experiment lifecycle management
+ */
+import type { Database as DatabaseType } from '../db/database-interface.js';
+import type { Experiment, ExperimentInput, ExperimentAssignment, ExperimentVariant, ExperimentOutcome, OutcomeInput, ExperimentAnalysis } from './types.js';
+export declare class ExperimentService {
+    private repo;
+    constructor(db: DatabaseType);
+    /**
+     * Create a new experiment
+     */
+    createExperiment(input: ExperimentInput): Experiment;
+    /**
+     * Start an experiment
+     */
+    startExperiment(experimentId: string): boolean;
+    /**
+     * Pause an experiment
+     */
+    pauseExperiment(experimentId: string): boolean;
+    /**
+     * Complete an experiment
+     */
+    completeExperiment(experimentId: string): boolean;
+    /**
+     * Assign a user to an experiment (with balanced randomization)
+     */
+    assignUser(experimentId: string, userId: string): ExperimentAssignment;
+    /**
+     * Get user's variant for an experiment
+     */
+    getUserVariant(experimentId: string, userId: string): ExperimentVariant | null;
+    /**
+     * Record an experiment outcome
+     */
+    recordOutcome(input: OutcomeInput): ExperimentOutcome;
+    /**
+     * Analyze experiment results
+     */
+    analyzeExperiment(experimentId: string): ExperimentAnalysis;
+    /**
+     * Get all active experiments
+     */
+    getActiveExperiments(): Experiment[];
+    private calculateStats;
+    /**
+     * Simplified t-test (for demonstration purposes)
+     * In production, use a proper statistics library
+     */
+    private tTest;
+    /**
+     * Normal CDF approximation (Zelen & Severo 1964)
+     */
+    private normalCDF;
+    /**
+     * Calculate 95% confidence interval for difference in means
+     */
+    private calculateConfidenceInterval;
+    /**
+     * Make a recommendation based on statistical analysis
+     */
+    private makeRecommendation;
+}
+//# sourceMappingURL=ExperimentService.d.ts.map

package/dist/analytics/ExperimentService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExperimentService.d.ts","sourceRoot":"","sources":["../../src/analytics/ExperimentService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE3E,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAEnB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,IAAI,CAAqB;gBAErB,EAAE,EAAE,YAAY;IAI5B;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU;IAIpD;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAa9C;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAI9C;;OAEG;IACH,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAIjD;;OAEG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,oBAAoB;IA0BtE;;OAEG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAK9E;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,iBAAiB;IAIrD;;OAEG;IACH,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,kBAAkB;IA8E3D;;OAEG;IACH,oBAAoB,IAAI,UAAU,EAAE;IAMpC,OAAO,CAAC,cAAc;IAYtB;;;OAGG;IACH,OAAO,CAAC,KAAK;IA6Bb;;OAEG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IA0BnC;;OAEG;IACH,OAAO,CAAC,kBAAkB;CA0C3B"}

package/dist/analytics/ExperimentService.js

@@ -0,0 +1,251 @@
+/**
+ * ExperimentService - Epic 4: A/B Testing Infrastructure
+ *
+ * Implements:
+ * - Experiment assignment system with balanced randomization
+ * - Outcome tracking and data collection
+ * - Basic statistical analysis
+ * - Experiment lifecycle management
+ */
+import { AnalyticsRepository } from './AnalyticsRepository.js';
+export class ExperimentService {
+    repo;
+    constructor(db) {
+        this.repo = new AnalyticsRepository(db);
+    }
+    /**
+     * Create a new experiment
+     */
+    createExperiment(input) {
+        return this.repo.createExperiment(input);
+    }
+    /**
+     * Start an experiment
+     */
+    startExperiment(experimentId) {
+        const experiment = this.repo.getExperiment(experimentId);
+        if (!experiment) {
+            throw new Error(`Experiment not found: ${experimentId}`);
+        }
+        if (experiment.status !== 'draft') {
+            throw new Error(`Cannot start experiment in status: ${experiment.status}`);
+        }
+        return this.repo.updateExperimentStatus(experimentId, 'active');
+    }
+    /**
+     * Pause an experiment
+     */
+    pauseExperiment(experimentId) {
+        return this.repo.updateExperimentStatus(experimentId, 'paused');
+    }
+    /**
+     * Complete an experiment
+     */
+    completeExperiment(experimentId) {
+        return this.repo.updateExperimentStatus(experimentId, 'completed');
+    }
+    /**
+     * Assign a user to an experiment (with balanced randomization)
+     */
+    assignUser(experimentId, userId) {
+        // Check if user is already assigned
+        const existing = this.repo.getUserAssignment(experimentId, userId);
+        if (existing) {
+            return existing;
+        }
+        // Get current assignments to maintain balance
+        const assignments = this.repo.getExperimentAssignments(experimentId);
+        const controlCount = assignments.filter((a) => a.variant === 'control').length;
+        const treatmentCount = assignments.filter((a) => a.variant === 'treatment').length;
+        // Assign to the variant with fewer users, or randomize if equal
+        let variant;
+        if (controlCount < treatmentCount) {
+            variant = 'control';
+        }
+        else if (treatmentCount < controlCount) {
+            variant = 'treatment';
+        }
+        else {
+            // Equal, randomize
+            variant = Math.random() < 0.5 ? 'control' : 'treatment';
+        }
+        return this.repo.assignUserToExperiment(experimentId, userId, variant);
+    }
+    /**
+     * Get user's variant for an experiment
+     */
+    getUserVariant(experimentId, userId) {
+        const assignment = this.repo.getUserAssignment(experimentId, userId);
+        return assignment?.variant ?? null;
+    }
+    /**
+     * Record an experiment outcome
+     */
+    recordOutcome(input) {
+        return this.repo.recordOutcome(input);
+    }
+    /**
+     * Analyze experiment results
+     */
+    analyzeExperiment(experimentId) {
+        const experiment = this.repo.getExperiment(experimentId);
+        if (!experiment) {
+            throw new Error(`Experiment not found: ${experimentId}`);
+        }
+        const assignments = this.repo.getExperimentAssignments(experimentId);
+        const outcomes = this.repo.getExperimentOutcomes(experimentId);
+        // Group assignments by variant
+        const controlAssignments = assignments.filter((a) => a.variant === 'control');
+        const treatmentAssignments = assignments.filter((a) => a.variant === 'treatment');
+        // Group outcomes by variant
+        const controlOutcomes = outcomes.filter((o) => {
+            const assignment = assignments.find((a) => a.id === o.assignmentId);
+            return assignment?.variant === 'control';
+        });
+        const treatmentOutcomes = outcomes.filter((o) => {
+            const assignment = assignments.find((a) => a.id === o.assignmentId);
+            return assignment?.variant === 'treatment';
+        });
+        // Calculate statistics for each outcome type
+        const outcomeTypes = new Set(outcomes.map((o) => o.outcomeType));
+        const controlStats = {};
+        const treatmentStats = {};
+        const pValues = {};
+        const confidenceIntervals = {};
+        for (const outcomeType of outcomeTypes) {
+            const controlValues = controlOutcomes
+                .filter((o) => o.outcomeType === outcomeType)
+                .map((o) => o.outcomeValue);
+            const treatmentValues = treatmentOutcomes
+                .filter((o) => o.outcomeType === outcomeType)
+                .map((o) => o.outcomeValue);
+            controlStats[outcomeType] = this.calculateStats(controlValues);
+            treatmentStats[outcomeType] = this.calculateStats(treatmentValues);
+            // Simple t-test (simplified, not production-ready)
+            pValues[outcomeType] = this.tTest(controlValues, treatmentValues);
+            // 95% confidence interval for difference
+            confidenceIntervals[outcomeType] = this.calculateConfidenceInterval(controlValues, treatmentValues);
+        }
+        // Make recommendation
+        const recommendation = this.makeRecommendation(pValues, controlStats, treatmentStats, assignments.length, experiment.targetSampleSize);
+        return {
+            experimentId,
+            experimentName: experiment.name,
+            controlGroup: {
+                sampleSize: controlAssignments.length,
+                outcomes: controlStats,
+            },
+            treatmentGroup: {
+                sampleSize: treatmentAssignments.length,
+                outcomes: treatmentStats,
+            },
+            pValues,
+            confidenceIntervals,
+            recommendation,
+        };
+    }
+    /**
+     * Get all active experiments
+     */
+    getActiveExperiments() {
+        return this.repo.getActiveExperiments();
+    }
+    // ==================== Private Statistical Methods ====================
+    calculateStats(values) {
+        if (values.length === 0) {
+            return { mean: 0, stdDev: 0 };
+        }
+        const mean = values.reduce((sum, val) => sum + val, 0) / values.length;
+        const variance = values.reduce((sum, val) => sum + Math.pow(val - mean, 2), 0) / values.length;
+        const stdDev = Math.sqrt(variance);
+        return { mean, stdDev };
+    }
+    /**
+     * Simplified t-test (for demonstration purposes)
+     * In production, use a proper statistics library
+     */
+    tTest(control, treatment) {
+        if (control.length === 0 || treatment.length === 0) {
+            return 1.0; // No difference if no data
+        }
+        const controlStats = this.calculateStats(control);
+        const treatmentStats = this.calculateStats(treatment);
+        // Pooled standard deviation
+        const pooledStdDev = Math.sqrt((Math.pow(controlStats.stdDev, 2) + Math.pow(treatmentStats.stdDev, 2)) / 2);
+        if (pooledStdDev === 0) {
+            return controlStats.mean === treatmentStats.mean ? 1.0 : 0.0;
+        }
+        // T-statistic
+        const t = (treatmentStats.mean - controlStats.mean) /
+            (pooledStdDev * Math.sqrt(1 / control.length + 1 / treatment.length));
+        // Very simplified p-value estimation (not accurate for production)
+        // In production, use a proper t-distribution table or library
+        const pValue = 2 * (1 - this.normalCDF(Math.abs(t)));
+        return Math.max(0, Math.min(1, pValue));
+    }
+    /**
+     * Normal CDF approximation (Zelen & Severo 1964)
+     */
+    normalCDF(z) {
+        const t = 1 / (1 + 0.2316419 * Math.abs(z));
+        const d = 0.3989423 * Math.exp((-z * z) / 2);
+        const prob = d * t * (0.3193815 + t * (-0.3565638 + t * (1.781478 + t * (-1.821256 + t * 1.330274))));
+        return z > 0 ? 1 - prob : prob;
+    }
+    /**
+     * Calculate 95% confidence interval for difference in means
+     */
+    calculateConfidenceInterval(control, treatment) {
+        if (control.length === 0 || treatment.length === 0) {
+            return { lower: 0, upper: 0 };
+        }
+        const controlStats = this.calculateStats(control);
+        const treatmentStats = this.calculateStats(treatment);
+        const diff = treatmentStats.mean - controlStats.mean;
+        const pooledStdDev = Math.sqrt((Math.pow(controlStats.stdDev, 2) + Math.pow(treatmentStats.stdDev, 2)) / 2);
+        const standardError = pooledStdDev * Math.sqrt(1 / control.length + 1 / treatment.length);
+        // 95% CI using 1.96 (z-score for 95%)
+        const margin = 1.96 * standardError;
+        return {
+            lower: diff - margin,
+            upper: diff + margin,
+        };
+    }
+    /**
+     * Make a recommendation based on statistical analysis
+     */
+    makeRecommendation(pValues, controlStats, treatmentStats, currentSampleSize, targetSampleSize) {
+        // Check if we have enough data
+        if (currentSampleSize < targetSampleSize) {
+            return 'continue';
+        }
+        // Check for statistical significance (p < 0.05)
+        const significantOutcomes = Object.entries(pValues).filter(([_, p]) => p < 0.05);
+        if (significantOutcomes.length === 0) {
+            return 'inconclusive';
+        }
+        // Check direction of effect for significant outcomes
+        let treatmentBetter = 0;
+        let controlBetter = 0;
+        for (const [outcomeType] of significantOutcomes) {
+            const controlMean = controlStats[outcomeType].mean;
+            const treatmentMean = treatmentStats[outcomeType].mean;
+            if (treatmentMean > controlMean) {
+                treatmentBetter++;
+            }
+            else {
+                controlBetter++;
+            }
+        }
+        if (treatmentBetter > controlBetter) {
+            return 'stop_treatment_wins';
+        }
+        else if (controlBetter > treatmentBetter) {
+            return 'stop_control_wins';
+        }
+        else {
+            return 'inconclusive';
+        }
+    }
+}
+//# sourceMappingURL=ExperimentService.js.map