@skillsmith/core 0.1.0

package/dist/src/analytics/AnalyticsRepository.js

@@ -0,0 +1,376 @@
+/**
+ * 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';
+/**
+ * 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 {
+            id: row.id,
+            skillId: row.skill_id,
+            userId: row.user_id,
+            sessionId: row.session_id,
+            eventType: row.event_type,
+            context: row.context ? JSON.parse(row.context) : undefined,
+            valueScore: row.value_score,
+            timestamp: row.timestamp,
+            createdAt: row.created_at,
+        };
+    }
+    /**
+     * 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((row) => ({
+            id: row.id,
+            skillId: row.skill_id,
+            userId: row.user_id,
+            sessionId: row.session_id,
+            eventType: row.event_type,
+            context: row.context ? JSON.parse(row.context) : undefined,
+            valueScore: row.value_score,
+            timestamp: row.timestamp,
+            createdAt: row.created_at,
+        }));
+    }
+    /**
+     * 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((row) => ({
+            id: row.id,
+            skillId: row.skill_id,
+            userId: row.user_id,
+            sessionId: row.session_id,
+            eventType: row.event_type,
+            context: row.context ? JSON.parse(row.context) : undefined,
+            valueScore: row.value_score,
+            timestamp: row.timestamp,
+            createdAt: row.created_at,
+        }));
+    }
+    /**
+     * 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((row) => ({
+            id: row.id,
+            skillId: row.skill_id,
+            userId: row.user_id,
+            sessionId: row.session_id,
+            eventType: row.event_type,
+            context: row.context ? JSON.parse(row.context) : undefined,
+            valueScore: row.value_score,
+            timestamp: row.timestamp,
+            createdAt: row.created_at,
+        }));
+    }
+    /**
+     * 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 {
+            id: row.id,
+            name: row.name,
+            description: row.description,
+            hypothesis: row.hypothesis,
+            status: row.status,
+            variantA: JSON.parse(row.variant_a),
+            variantB: JSON.parse(row.variant_b),
+            startDate: row.start_date,
+            endDate: row.end_date,
+            targetSampleSize: row.target_sample_size,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+    /**
+     * Get experiment by name
+     */
+    getExperimentByName(name) {
+        const row = this.db.prepare('SELECT * FROM experiments WHERE name = ?').get(name);
+        if (!row)
+            return null;
+        return {
+            id: row.id,
+            name: row.name,
+            description: row.description,
+            hypothesis: row.hypothesis,
+            status: row.status,
+            variantA: JSON.parse(row.variant_a),
+            variantB: JSON.parse(row.variant_b),
+            startDate: row.start_date,
+            endDate: row.end_date,
+            targetSampleSize: row.target_sample_size,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+    /**
+     * 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((row) => ({
+            id: row.id,
+            name: row.name,
+            description: row.description,
+            hypothesis: row.hypothesis,
+            status: row.status,
+            variantA: JSON.parse(row.variant_a),
+            variantB: JSON.parse(row.variant_b),
+            startDate: row.start_date,
+            endDate: row.end_date,
+            targetSampleSize: row.target_sample_size,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        }));
+    }
+    // ==================== 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 {
+            id: row.id,
+            experimentId: row.experiment_id,
+            userId: row.user_id,
+            variant: row.variant,
+            assignedAt: row.assigned_at,
+        };
+    }
+    /**
+     * 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 {
+            id: row.id,
+            experimentId: row.experiment_id,
+            userId: row.user_id,
+            variant: row.variant,
+            assignedAt: row.assigned_at,
+        };
+    }
+    /**
+     * 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((row) => ({
+            id: row.id,
+            experimentId: row.experiment_id,
+            userId: row.user_id,
+            variant: row.variant,
+            assignedAt: row.assigned_at,
+        }));
+    }
+    // ==================== 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 {
+            id: row.id,
+            experimentId: row.experiment_id,
+            assignmentId: row.assignment_id,
+            outcomeType: row.outcome_type,
+            outcomeValue: row.outcome_value,
+            metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+            measuredAt: row.measured_at,
+            createdAt: row.created_at,
+        };
+    }
+    /**
+     * 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((row) => ({
+            id: row.id,
+            experimentId: row.experiment_id,
+            assignmentId: row.assignment_id,
+            outcomeType: row.outcome_type,
+            outcomeValue: row.outcome_value,
+            metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+            measuredAt: row.measured_at,
+            createdAt: row.created_at,
+        }));
+    }
+    // ==================== 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 this.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((row) => this.rowToROIMetrics(row));
+    }
+    /**
+     * 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((row) => this.rowToROIMetrics(row));
+    }
+    rowToROIMetrics(row) {
+        return {
+            id: row.id,
+            metricType: row.metric_type,
+            entityId: row.entity_id,
+            periodStart: row.period_start,
+            periodEnd: row.period_end,
+            totalActivations: row.total_activations,
+            totalInvocations: row.total_invocations,
+            totalSuccesses: row.total_successes,
+            totalFailures: row.total_failures,
+            avgValueScore: row.avg_value_score,
+            estimatedTimeSaved: row.estimated_time_saved,
+            estimatedValueUsd: row.estimated_value_usd,
+            metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+            computedAt: row.computed_at,
+            createdAt: row.created_at,
+        };
+    }
+}
+//# sourceMappingURL=AnalyticsRepository.js.map

package/dist/src/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/src/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 'better-sqlite3';
+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/src/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,gBAAgB,CAAA;AAE9D,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"}