@skillsmith/core 0.5.4 → 0.5.6

package/dist/analysis/worker-types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * SMI-1308: Worker Pool Type Definitions
+ *
+ * Type definitions for the worker thread pool.
+ * Extracted from worker-pool.ts for better modularity.
+ *
+ * @see docs/internal/architecture/multi-language-analysis.md
+ * @module analysis/worker-types
+ */
+import type { ParseResult } from './types.js';
+import type { AnalysisMetrics } from './metrics.js';
+/**
+ * Task to be parsed by a worker
+ */
+export interface ParseTask {
+    /** Path to the file */
+    filePath: string;
+    /** File content to parse */
+    content: string;
+    /** Programming language */
+    language: string;
+}
+/**
+ * Result from a worker parse operation
+ */
+export interface WorkerResult {
+    /** Path to the file */
+    filePath: string;
+    /** Parse result */
+    result: ParseResult;
+    /** Time taken to parse in milliseconds */
+    durationMs: number;
+    /** Error message if parsing failed */
+    error?: string;
+}
+/**
+ * Options for ParserWorkerPool
+ */
+export interface WorkerPoolOptions {
+    /** Number of workers in pool (default: CPU cores - 1) */
+    poolSize?: number;
+    /** Minimum batch size to use workers (default: 10) */
+    minBatchForWorkers?: number;
+    /** Custom metrics instance (uses default if not provided) */
+    metrics?: AnalysisMetrics;
+}
+/**
+ * Worker pool statistics
+ */
+export interface WorkerPoolStats {
+    poolSize: number;
+    activeWorkers: number;
+    queuedTasks: number;
+    utilization: number;
+}
+/**
+ * Internal task queue item
+ */
+export interface QueuedTask {
+    task: ParseTask;
+    resolve: (r: WorkerResult) => void;
+    reject: (e: Error) => void;
+}
+//# sourceMappingURL=worker-types.d.ts.map

package/dist/analysis/worker-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-types.d.ts","sourceRoot":"","sources":["../../src/analysis/worker-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAEnD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,mBAAmB;IACnB,MAAM,EAAE,WAAW,CAAA;IACnB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,eAAe,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAA;IAClC,MAAM,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAA;CAC3B"}

package/dist/analysis/worker-types.js

@@ -0,0 +1,11 @@
+/**
+ * SMI-1308: Worker Pool Type Definitions
+ *
+ * Type definitions for the worker thread pool.
+ * Extracted from worker-pool.ts for better modularity.
+ *
+ * @see docs/internal/architecture/multi-language-analysis.md
+ * @module analysis/worker-types
+ */
+export {};
+//# sourceMappingURL=worker-types.js.map

package/dist/analysis/worker-types.js.map

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

package/dist/analysis/worker-utils.d.ts

@@ -0,0 +1,49 @@
+/**
+ * SMI-1308: Worker Pool Utilities
+ *
+ * Utility functions for the worker thread pool.
+ * Extracted from worker-pool.ts for better modularity.
+ *
+ * @see docs/internal/architecture/multi-language-analysis.md
+ * @module analysis/worker-utils
+ */
+/**
+ * Map of file extensions to language names
+ * Used for metrics recording
+ */
+export declare const EXTENSION_TO_LANGUAGE: Record<string, string>;
+/**
+ * Get language from file extension
+ *
+ * @param ext - File extension (without leading dot)
+ * @returns Language name or undefined if not supported
+ *
+ * @example
+ * ```typescript
+ * getLanguageFromExtension('ts') // 'typescript'
+ * getLanguageFromExtension('py') // 'python'
+ * getLanguageFromExtension('unknown') // undefined
+ * ```
+ */
+export declare function getLanguageFromExtension(ext?: string): string | undefined;
+/**
+ * Chunk an array into smaller arrays of specified size
+ *
+ * @param array - Array to chunk
+ * @param size - Maximum size of each chunk
+ * @returns Array of chunks
+ *
+ * @example
+ * ```typescript
+ * chunkArray([1, 2, 3, 4, 5], 2) // [[1, 2], [3, 4], [5]]
+ * ```
+ */
+export declare function chunkArray<T>(array: T[], size: number): T[][];
+/**
+ * Worker code template for inline parsing
+ *
+ * This code runs inside worker threads to perform basic regex-based parsing.
+ * Full adapter-based parsing happens in main thread for accuracy.
+ */
+export declare const WORKER_PARSE_CODE = "\nconst { parentPort, workerData } = require('worker_threads');\n\nfunction processTask(task) {\n  const start = Date.now();\n  try {\n    const result = {\n      imports: [],\n      exports: [],\n      functions: [],\n    };\n\n    const lines = task.content.split('\\n');\n    for (let i = 0; i < lines.length; i++) {\n      const line = lines[i];\n\n      // Detect imports (TypeScript/JavaScript)\n      if (/^import\\s/.test(line) || /^from\\s/.test(line)) {\n        const moduleMatch = line.match(/from\\s+['\"]([^'\"]+)['\"]/);\n        result.imports.push({\n          module: moduleMatch ? moduleMatch[1] : line.trim(),\n          namedImports: [],\n          isTypeOnly: /^import\\s+type/.test(line),\n          sourceFile: task.filePath,\n          line: i + 1,\n        });\n      }\n\n      // Detect imports (Python)\n      if (/^import\\s+\\w/.test(line) || /^from\\s+\\w/.test(line)) {\n        const moduleMatch = line.match(/^(?:from\\s+)?(\\w+(?:\\.\\w+)*)/);\n        if (moduleMatch && !result.imports.some(imp => imp.line === i + 1)) {\n          result.imports.push({\n            module: moduleMatch[1],\n            namedImports: [],\n            isTypeOnly: false,\n            sourceFile: task.filePath,\n            line: i + 1,\n          });\n        }\n      }\n\n      // Detect imports (Go)\n      if (/^\\s*\"[^\"]+\"/.test(line) || /^import\\s+/.test(line)) {\n        const pathMatch = line.match(/\"([^\"]+)\"/);\n        if (pathMatch) {\n          result.imports.push({\n            module: pathMatch[1],\n            namedImports: [],\n            isTypeOnly: false,\n            sourceFile: task.filePath,\n            line: i + 1,\n          });\n        }\n      }\n\n      // Detect functions (TypeScript/JavaScript)\n      const tsFuncMatch = line.match(/^(export\\s+)?(async\\s+)?function\\s+(\\w+)/);\n      if (tsFuncMatch) {\n        result.functions.push({\n          name: tsFuncMatch[3],\n          parameterCount: 0,\n          isAsync: !!tsFuncMatch[2],\n          isExported: !!tsFuncMatch[1],\n          sourceFile: task.filePath,\n          line: i + 1,\n        });\n      }\n\n      // Detect functions (Python)\n      const pyFuncMatch = line.match(/^(async\\s+)?def\\s+(\\w+)/);\n      if (pyFuncMatch) {\n        result.functions.push({\n          name: pyFuncMatch[2],\n          parameterCount: 0,\n          isAsync: !!pyFuncMatch[1],\n          isExported: !pyFuncMatch[2].startsWith('_'),\n          sourceFile: task.filePath,\n          line: i + 1,\n        });\n      }\n\n      // Detect functions (Go)\n      const goFuncMatch = line.match(/^func\\s+(?:\\([^)]+\\)\\s+)?(\\w+)/);\n      if (goFuncMatch) {\n        const isExported = goFuncMatch[1][0] === goFuncMatch[1][0].toUpperCase();\n        result.functions.push({\n          name: goFuncMatch[1],\n          parameterCount: 0,\n          isAsync: false,\n          isExported: isExported,\n          sourceFile: task.filePath,\n          line: i + 1,\n        });\n      }\n\n      // Detect exports (TypeScript/JavaScript)\n      if (/^export\\s+(default\\s+)?(const|let|var|class|function|interface|type|enum)/.test(line)) {\n        const exportMatch = line.match(/^export\\s+(default\\s+)?(const|let|var|class|function|interface|type|enum)\\s+(\\w+)/);\n        if (exportMatch) {\n          result.exports.push({\n            name: exportMatch[3],\n            kind: exportMatch[2] === 'function' ? 'function' :\n                  exportMatch[2] === 'class' ? 'class' :\n                  exportMatch[2] === 'interface' ? 'interface' :\n                  exportMatch[2] === 'type' ? 'type' :\n                  exportMatch[2] === 'enum' ? 'enum' : 'variable',\n            isDefault: !!exportMatch[1],\n            sourceFile: task.filePath,\n            line: i + 1,\n          });\n        }\n      }\n    }\n\n    return {\n      filePath: task.filePath,\n      result,\n      durationMs: Date.now() - start,\n    };\n  } catch (error) {\n    return {\n      filePath: task.filePath,\n      result: { imports: [], exports: [], functions: [] },\n      durationMs: Date.now() - start,\n      error: error.message || String(error),\n    };\n  }\n}\n\nconst results = workerData.tasks.map(processTask);\nparentPort.postMessage(results);\n";
+//# sourceMappingURL=worker-utils.d.ts.map

package/dist/analysis/worker-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-utils.d.ts","sourceRoot":"","sources":["../../src/analysis/worker-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAexD,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAM7D;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,srIAoI7B,CAAA"}

package/dist/analysis/worker-utils.js

@@ -0,0 +1,206 @@
+/**
+ * SMI-1308: Worker Pool Utilities
+ *
+ * Utility functions for the worker thread pool.
+ * Extracted from worker-pool.ts for better modularity.
+ *
+ * @see docs/internal/architecture/multi-language-analysis.md
+ * @module analysis/worker-utils
+ */
+/**
+ * Map of file extensions to language names
+ * Used for metrics recording
+ */
+export const EXTENSION_TO_LANGUAGE = {
+    ts: 'typescript',
+    tsx: 'typescript',
+    mts: 'typescript',
+    cts: 'typescript',
+    js: 'javascript',
+    jsx: 'javascript',
+    mjs: 'javascript',
+    cjs: 'javascript',
+    py: 'python',
+    pyi: 'python',
+    pyw: 'python',
+    go: 'go',
+    rs: 'rust',
+    java: 'java',
+};
+/**
+ * Get language from file extension
+ *
+ * @param ext - File extension (without leading dot)
+ * @returns Language name or undefined if not supported
+ *
+ * @example
+ * ```typescript
+ * getLanguageFromExtension('ts') // 'typescript'
+ * getLanguageFromExtension('py') // 'python'
+ * getLanguageFromExtension('unknown') // undefined
+ * ```
+ */
+export function getLanguageFromExtension(ext) {
+    if (!ext)
+        return undefined;
+    return EXTENSION_TO_LANGUAGE[ext];
+}
+/**
+ * Chunk an array into smaller arrays of specified size
+ *
+ * @param array - Array to chunk
+ * @param size - Maximum size of each chunk
+ * @returns Array of chunks
+ *
+ * @example
+ * ```typescript
+ * chunkArray([1, 2, 3, 4, 5], 2) // [[1, 2], [3, 4], [5]]
+ * ```
+ */
+export function chunkArray(array, size) {
+    const chunks = [];
+    for (let i = 0; i < array.length; i += size) {
+        chunks.push(array.slice(i, i + size));
+    }
+    return chunks;
+}
+/**
+ * Worker code template for inline parsing
+ *
+ * This code runs inside worker threads to perform basic regex-based parsing.
+ * Full adapter-based parsing happens in main thread for accuracy.
+ */
+export const WORKER_PARSE_CODE = `
+const { parentPort, workerData } = require('worker_threads');
+
+function processTask(task) {
+  const start = Date.now();
+  try {
+    const result = {
+      imports: [],
+      exports: [],
+      functions: [],
+    };
+
+    const lines = task.content.split('\\n');
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+
+      // Detect imports (TypeScript/JavaScript)
+      if (/^import\\s/.test(line) || /^from\\s/.test(line)) {
+        const moduleMatch = line.match(/from\\s+['"]([^'"]+)['"]/);
+        result.imports.push({
+          module: moduleMatch ? moduleMatch[1] : line.trim(),
+          namedImports: [],
+          isTypeOnly: /^import\\s+type/.test(line),
+          sourceFile: task.filePath,
+          line: i + 1,
+        });
+      }
+
+      // Detect imports (Python)
+      if (/^import\\s+\\w/.test(line) || /^from\\s+\\w/.test(line)) {
+        const moduleMatch = line.match(/^(?:from\\s+)?(\\w+(?:\\.\\w+)*)/);
+        if (moduleMatch && !result.imports.some(imp => imp.line === i + 1)) {
+          result.imports.push({
+            module: moduleMatch[1],
+            namedImports: [],
+            isTypeOnly: false,
+            sourceFile: task.filePath,
+            line: i + 1,
+          });
+        }
+      }
+
+      // Detect imports (Go)
+      if (/^\\s*"[^"]+"/.test(line) || /^import\\s+/.test(line)) {
+        const pathMatch = line.match(/"([^"]+)"/);
+        if (pathMatch) {
+          result.imports.push({
+            module: pathMatch[1],
+            namedImports: [],
+            isTypeOnly: false,
+            sourceFile: task.filePath,
+            line: i + 1,
+          });
+        }
+      }
+
+      // Detect functions (TypeScript/JavaScript)
+      const tsFuncMatch = line.match(/^(export\\s+)?(async\\s+)?function\\s+(\\w+)/);
+      if (tsFuncMatch) {
+        result.functions.push({
+          name: tsFuncMatch[3],
+          parameterCount: 0,
+          isAsync: !!tsFuncMatch[2],
+          isExported: !!tsFuncMatch[1],
+          sourceFile: task.filePath,
+          line: i + 1,
+        });
+      }
+
+      // Detect functions (Python)
+      const pyFuncMatch = line.match(/^(async\\s+)?def\\s+(\\w+)/);
+      if (pyFuncMatch) {
+        result.functions.push({
+          name: pyFuncMatch[2],
+          parameterCount: 0,
+          isAsync: !!pyFuncMatch[1],
+          isExported: !pyFuncMatch[2].startsWith('_'),
+          sourceFile: task.filePath,
+          line: i + 1,
+        });
+      }
+
+      // Detect functions (Go)
+      const goFuncMatch = line.match(/^func\\s+(?:\\([^)]+\\)\\s+)?(\\w+)/);
+      if (goFuncMatch) {
+        const isExported = goFuncMatch[1][0] === goFuncMatch[1][0].toUpperCase();
+        result.functions.push({
+          name: goFuncMatch[1],
+          parameterCount: 0,
+          isAsync: false,
+          isExported: isExported,
+          sourceFile: task.filePath,
+          line: i + 1,
+        });
+      }
+
+      // Detect exports (TypeScript/JavaScript)
+      if (/^export\\s+(default\\s+)?(const|let|var|class|function|interface|type|enum)/.test(line)) {
+        const exportMatch = line.match(/^export\\s+(default\\s+)?(const|let|var|class|function|interface|type|enum)\\s+(\\w+)/);
+        if (exportMatch) {
+          result.exports.push({
+            name: exportMatch[3],
+            kind: exportMatch[2] === 'function' ? 'function' :
+                  exportMatch[2] === 'class' ? 'class' :
+                  exportMatch[2] === 'interface' ? 'interface' :
+                  exportMatch[2] === 'type' ? 'type' :
+                  exportMatch[2] === 'enum' ? 'enum' : 'variable',
+            isDefault: !!exportMatch[1],
+            sourceFile: task.filePath,
+            line: i + 1,
+          });
+        }
+      }
+    }
+
+    return {
+      filePath: task.filePath,
+      result,
+      durationMs: Date.now() - start,
+    };
+  } catch (error) {
+    return {
+      filePath: task.filePath,
+      result: { imports: [], exports: [], functions: [] },
+      durationMs: Date.now() - start,
+      error: error.message || String(error),
+    };
+  }
+}
+
+const results = workerData.tasks.map(processTask);
+parentPort.postMessage(results);
+`;
+//# sourceMappingURL=worker-utils.js.map

package/dist/analysis/worker-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-utils.js","sourceRoot":"","sources":["../../src/analysis/worker-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,EAAE,EAAE,YAAY;IAChB,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,YAAY;IACjB,EAAE,EAAE,YAAY;IAChB,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,YAAY;IACjB,EAAE,EAAE,QAAQ;IACZ,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,QAAQ;IACb,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,MAAM;CACb,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAY;IACnD,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAC1B,OAAO,qBAAqB,CAAC,GAAG,CAAC,CAAA;AACnC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAI,KAAU,EAAE,IAAY;IACpD,MAAM,MAAM,GAAU,EAAE,CAAA;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAA;IACvC,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoIhC,CAAA"}

package/dist/analytics/AnalyticsRepository.d.ts

@@ -0,0 +1,97 @@
+/**
+ * AnalyticsRepository - CRUD operations for analytics data
+ *
+ * Provides type-safe access to:
+ * - Usage event tracking
+ * - Experiment management
+ * - ROI metrics storage
+ * - Value attribution
+ */
+import type { Database as DatabaseType } from '../db/database-interface.js';
+import type { UsageEvent, UsageEventInput, Experiment, ExperimentInput, ExperimentAssignment, ExperimentOutcome, OutcomeInput, ROIMetrics, ExperimentVariant, ExperimentStatus } from './types.js';
+export type { UsageEventRow, ExperimentRow, ExperimentAssignmentRow, ExperimentOutcomeRow, ROIMetricsRow, } from './AnalyticsRepository.types.js';
+/**
+ * Repository for analytics operations
+ */
+export declare class AnalyticsRepository {
+    private db;
+    constructor(db: DatabaseType);
+    /**
+     * Record a skill usage event
+     * SMI-992: Explicitly set timestamp from JS Date for fake timer compatibility
+     */
+    recordUsageEvent(input: UsageEventInput): UsageEvent;
+    /**
+     * Get a usage event by ID
+     */
+    getUsageEvent(id: string): UsageEvent | null;
+    /**
+     * Get usage events for a skill within a time period
+     */
+    getUsageEventsForSkill(skillId: string, startDate: string, endDate: string): UsageEvent[];
+    /**
+     * Get usage events for a user
+     */
+    getUsageEventsForUser(userId: string, startDate: string, endDate: string): UsageEvent[];
+    /**
+     * Get all usage events within a time period
+     */
+    getAllUsageEvents(startDate: string, endDate: string): UsageEvent[];
+    /**
+     * Delete usage events older than the retention period (30 days default)
+     */
+    cleanupOldEvents(retentionDays?: number): number;
+    /**
+     * Create a new experiment
+     */
+    createExperiment(input: ExperimentInput): Experiment;
+    /**
+     * Get an experiment by ID
+     */
+    getExperiment(id: string): Experiment | null;
+    /**
+     * Get experiment by name
+     */
+    getExperimentByName(name: string): Experiment | null;
+    /**
+     * Update experiment status
+     */
+    updateExperimentStatus(id: string, status: ExperimentStatus): boolean;
+    /**
+     * Get all active experiments
+     */
+    getActiveExperiments(): Experiment[];
+    /**
+     * Assign a user to an experiment variant
+     */
+    assignUserToExperiment(experimentId: string, userId: string, variant: ExperimentVariant): ExperimentAssignment;
+    /**
+     * Get user's assignment for an experiment
+     */
+    getUserAssignment(experimentId: string, userId: string): ExperimentAssignment | null;
+    /**
+     * Get all assignments for an experiment
+     */
+    getExperimentAssignments(experimentId: string): ExperimentAssignment[];
+    /**
+     * Record an experiment outcome
+     */
+    recordOutcome(input: OutcomeInput): ExperimentOutcome;
+    /**
+     * Get outcomes for an experiment
+     */
+    getExperimentOutcomes(experimentId: string): ExperimentOutcome[];
+    /**
+     * Store computed ROI metrics
+     */
+    storeROIMetrics(metrics: Omit<ROIMetrics, 'id' | 'createdAt'>): ROIMetrics;
+    /**
+     * Get ROI metrics for a period
+     */
+    getROIMetrics(metricType: string, startDate: string, endDate: string): ROIMetrics[];
+    /**
+     * Get ROI metrics for a specific entity (user or skill)
+     */
+    getEntityROIMetrics(entityId: string, startDate: string, endDate: string): ROIMetrics[];
+}
+//# sourceMappingURL=AnalyticsRepository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsRepository.d.ts","sourceRoot":"","sources":["../../src/analytics/AnalyticsRepository.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE3E,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAGnB,YAAY,EACV,aAAa,EACb,aAAa,EACb,uBAAuB,EACvB,oBAAoB,EACpB,aAAa,GACd,MAAM,gCAAgC,CAAA;AAkBvC;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,EAAE,CAAc;gBAEZ,EAAE,EAAE,YAAY;IAM5B;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU;IAyBpD;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAS5C;;OAEG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE;IAYzF;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE;IAYvF;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE;IAYnE;;OAEG;IACH,gBAAgB,CAAC,aAAa,GAAE,MAAW,GAAG,MAAM;IAYpD;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU;IAuBpD;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAS5C;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IASpD;;OAEG;IACH,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO;IAQrE;;OAEG;IACH,oBAAoB,IAAI,UAAU,EAAE;IAUpC;;OAEG;IACH,sBAAsB,CACpB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GACzB,oBAAoB;IAkBvB;;OAEG;IACH,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IASpF;;OAEG;IACH,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAUtE;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,iBAAiB;IAyBrD;;OAEG;IACH,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAYhE;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,UAAU;IAiC1E;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE;IAYnF;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE;CAWxF"}

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

@@ -0,0 +1,28 @@
+/**
+ * AnalyticsRepository Helpers
+ *
+ * Helper functions for transforming database rows to domain objects.
+ */
+import type { UsageEvent, Experiment, ExperimentAssignment, ExperimentOutcome, ROIMetrics } from './types.js';
+import type { UsageEventRow, ExperimentRow, ExperimentAssignmentRow, ExperimentOutcomeRow, ROIMetricsRow } from './AnalyticsRepository.types.js';
+/**
+ * Convert a usage event row to a UsageEvent object
+ */
+export declare function rowToUsageEvent(row: UsageEventRow): UsageEvent;
+/**
+ * Convert a database row to an Experiment object
+ */
+export declare function rowToExperiment(row: ExperimentRow): Experiment;
+/**
+ * Convert an assignment row to an ExperimentAssignment object
+ */
+export declare function rowToAssignment(row: ExperimentAssignmentRow): ExperimentAssignment;
+/**
+ * Convert an outcome row to an ExperimentOutcome object
+ */
+export declare function rowToOutcome(row: ExperimentOutcomeRow): ExperimentOutcome;
+/**
+ * Convert a ROI metrics row to a ROIMetrics object
+ */
+export declare function rowToROIMetrics(row: ROIMetricsRow): ROIMetrics;
+//# sourceMappingURL=AnalyticsRepository.helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsRepository.helpers.d.ts","sourceRoot":"","sources":["../../src/analytics/AnalyticsRepository.helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,UAAU,EAEV,UAAU,EAEV,oBAAoB,EAEpB,iBAAiB,EACjB,UAAU,EAEX,MAAM,YAAY,CAAA;AAEnB,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,uBAAuB,EACvB,oBAAoB,EACpB,aAAa,EACd,MAAM,gCAAgC,CAAA;AAEvC;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,CAY9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,CAe9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,uBAAuB,GAAG,oBAAoB,CAQlF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,oBAAoB,GAAG,iBAAiB,CAWzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,CAkB9D"}

package/dist/analytics/AnalyticsRepository.helpers.js

@@ -0,0 +1,90 @@
+/**
+ * AnalyticsRepository Helpers
+ *
+ * Helper functions for transforming database rows to domain objects.
+ */
+/**
+ * Convert a usage event row to a UsageEvent object
+ */
+export function rowToUsageEvent(row) {
+    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 ?? undefined,
+        timestamp: row.timestamp,
+        createdAt: row.created_at,
+    };
+}
+/**
+ * Convert a database row to an Experiment object
+ */
+export function rowToExperiment(row) {
+    return {
+        id: row.id,
+        name: row.name,
+        description: row.description ?? undefined,
+        hypothesis: row.hypothesis ?? undefined,
+        status: row.status,
+        variantA: JSON.parse(row.variant_a),
+        variantB: JSON.parse(row.variant_b),
+        startDate: row.start_date ?? undefined,
+        endDate: row.end_date ?? undefined,
+        targetSampleSize: row.target_sample_size,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+/**
+ * Convert an assignment row to an ExperimentAssignment object
+ */
+export function rowToAssignment(row) {
+    return {
+        id: row.id,
+        experimentId: row.experiment_id,
+        userId: row.user_id,
+        variant: row.variant,
+        assignedAt: row.assigned_at,
+    };
+}
+/**
+ * Convert an outcome row to an ExperimentOutcome object
+ */
+export function rowToOutcome(row) {
+    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,
+    };
+}
+/**
+ * Convert a ROI metrics row to a ROIMetrics object
+ */
+export function rowToROIMetrics(row) {
+    return {
+        id: row.id,
+        metricType: row.metric_type,
+        entityId: row.entity_id ?? undefined,
+        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.helpers.js.map

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

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