@skillsmith/core 0.2.0 → 2.0.0

package/dist/src/analysis/worker-pool.js

@@ -0,0 +1,418 @@
+/**
+ * SMI-1308: Worker Thread Pool for Parallel File Parsing
+ * SMI-1337: Added metrics integration
+ *
+ * Uses Node.js worker_threads for true parallelism,
+ * bypassing the single-threaded event loop limitation.
+ *
+ * @see docs/architecture/multi-language-analysis.md
+ * @module analysis/worker-pool
+ */
+import { Worker, isMainThread, parentPort, workerData } from 'worker_threads';
+import os from 'os';
+import { EventEmitter } from 'events';
+import { getAnalysisMetrics } from './metrics.js';
+export class ParserWorkerPool extends EventEmitter {
+    workers = [];
+    taskQueue = [];
+    activeWorkers = 0;
+    poolSize;
+    minBatchForWorkers;
+    metrics;
+    disposed = false;
+    // SMI-1330/1331: Cache router to avoid recreation on each parseInline call
+    router = null;
+    routerPromise = null;
+    constructor(options = {}) {
+        super();
+        this.poolSize = options.poolSize ?? Math.max(1, os.cpus().length - 1);
+        this.minBatchForWorkers = options.minBatchForWorkers ?? 10;
+        this.metrics = options.metrics ?? getAnalysisMetrics();
+    }
+    /**
+     * SMI-1330/1331: Get or create shared router instance
+     * Lazily initializes the router on first use and caches it
+     */
+    async getRouter() {
+        if (this.router)
+            return this.router;
+        if (this.routerPromise)
+            return this.routerPromise;
+        this.routerPromise = this.initializeRouter();
+        this.router = await this.routerPromise;
+        return this.router;
+    }
+    /**
+     * SMI-1330/1331: Initialize router with all adapters
+     */
+    async initializeRouter() {
+        const { LanguageRouter } = await import('./router.js');
+        const { TypeScriptAdapter } = await import('./adapters/typescript.js');
+        const { PythonAdapter } = await import('./adapters/python.js');
+        const { GoAdapter } = await import('./adapters/go.js');
+        const { RustAdapter } = await import('./adapters/rust.js');
+        const { JavaAdapter } = await import('./adapters/java.js');
+        const router = new LanguageRouter();
+        router.registerAdapter(new TypeScriptAdapter());
+        router.registerAdapter(new PythonAdapter());
+        router.registerAdapter(new GoAdapter());
+        router.registerAdapter(new RustAdapter());
+        router.registerAdapter(new JavaAdapter());
+        return router;
+    }
+    /**
+     * Parse files in parallel using worker threads
+     *
+     * SMI-1337: Records worker pool metrics.
+     *
+     * @param tasks - Array of parse tasks
+     * @returns Array of worker results
+     * @throws Error if pool has been disposed
+     *
+     * @example
+     * ```typescript
+     * const results = await pool.parseFiles([
+     *   { filePath: 'a.ts', content: 'export const a = 1', language: 'typescript' },
+     *   { filePath: 'b.ts', content: 'export const b = 2', language: 'typescript' },
+     * ])
+     * ```
+     */
+    async parseFiles(tasks) {
+        if (this.disposed) {
+            throw new Error('Worker pool has been disposed');
+        }
+        if (tasks.length === 0) {
+            return [];
+        }
+        // SMI-1337: Update worker pool metrics
+        this.metrics.updateWorkerPool(this.activeWorkers, this.taskQueue.length, this.poolSize);
+        // For small batches, parse inline (worker overhead not worth it)
+        if (tasks.length < this.minBatchForWorkers) {
+            const results = await this.parseInline(tasks);
+            this.recordParseMetrics(results);
+            return results;
+        }
+        const results = await this.parseWithWorkers(tasks);
+        this.recordParseMetrics(results);
+        return results;
+    }
+    /**
+     * Record parse metrics for completed results
+     * SMI-1337: Helper to record metrics after parsing
+     */
+    recordParseMetrics(results) {
+        for (const result of results) {
+            if (result.error) {
+                this.metrics.recordError('worker_parse_error', result.filePath.split('.').pop());
+            }
+            else {
+                // Extract language from file extension
+                const ext = result.filePath.split('.').pop()?.toLowerCase();
+                const language = this.getLanguageFromExtension(ext);
+                if (language) {
+                    this.metrics.recordFileParsed(language);
+                    this.metrics.recordParseDuration(language, result.durationMs);
+                }
+            }
+        }
+        // Update memory usage after batch processing
+        this.metrics.updateMemoryUsage();
+    }
+    /**
+     * Get language from file extension
+     * SMI-1337: Helper for metrics
+     */
+    getLanguageFromExtension(ext) {
+        if (!ext)
+            return undefined;
+        const extensionToLanguage = {
+            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',
+        };
+        return extensionToLanguage[ext];
+    }
+    /**
+     * Parse files inline (no workers)
+     *
+     * Used for small batches where worker overhead exceeds benefit.
+     * SMI-1330/1331: Uses cached router to avoid recreation overhead
+     */
+    async parseInline(tasks) {
+        const results = [];
+        // SMI-1330/1331: Get shared router instance
+        const router = await this.getRouter();
+        for (const task of tasks) {
+            const start = performance.now();
+            try {
+                const adapter = router.tryGetAdapter(task.filePath);
+                if (adapter) {
+                    const result = adapter.parseFile(task.content, task.filePath);
+                    results.push({
+                        filePath: task.filePath,
+                        result,
+                        durationMs: performance.now() - start,
+                    });
+                }
+                else {
+                    // Unsupported file type
+                    results.push({
+                        filePath: task.filePath,
+                        result: { imports: [], exports: [], functions: [] },
+                        durationMs: performance.now() - start,
+                        error: `Unsupported file type: ${task.filePath}`,
+                    });
+                }
+            }
+            catch (error) {
+                results.push({
+                    filePath: task.filePath,
+                    result: { imports: [], exports: [], functions: [] },
+                    durationMs: performance.now() - start,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Parse files using worker threads
+     *
+     * Chunks tasks across available workers for parallel processing.
+     */
+    async parseWithWorkers(tasks) {
+        // Chunk tasks for workers
+        const chunkSize = Math.ceil(tasks.length / this.poolSize);
+        const chunks = this.chunkArray(tasks, chunkSize);
+        const results = await Promise.all(chunks.map((chunk) => this.dispatchToWorker(chunk)));
+        return results.flat();
+    }
+    /**
+     * Dispatch a chunk of tasks to a worker
+     */
+    async dispatchToWorker(tasks) {
+        return new Promise((resolve, reject) => {
+            // Create inline worker with basic regex-based parsing
+            // Full adapter-based parsing happens in main thread for accuracy
+            const workerCode = `
+        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);
+      `;
+            const worker = new Worker(workerCode, {
+                eval: true,
+                workerData: { tasks },
+            });
+            const timeout = setTimeout(() => {
+                worker.terminate();
+                reject(new Error('Worker timed out after 30 seconds'));
+            }, 30000);
+            worker.on('message', (results) => {
+                clearTimeout(timeout);
+                worker.terminate();
+                resolve(results);
+            });
+            worker.on('error', (error) => {
+                clearTimeout(timeout);
+                worker.terminate();
+                reject(error);
+            });
+            worker.on('exit', (code) => {
+                clearTimeout(timeout);
+                if (code !== 0) {
+                    reject(new Error(`Worker exited with code ${code}`));
+                }
+            });
+        });
+    }
+    /**
+     * Chunk an array into smaller arrays
+     */
+    chunkArray(array, size) {
+        const chunks = [];
+        for (let i = 0; i < array.length; i += size) {
+            chunks.push(array.slice(i, i + size));
+        }
+        return chunks;
+    }
+    /**
+     * Get pool statistics
+     *
+     * SMI-1337: Also updates metrics.
+     *
+     * @returns Current pool statistics
+     */
+    getStats() {
+        const utilization = this.poolSize > 0 ? this.activeWorkers / this.poolSize : 0;
+        // SMI-1337: Update metrics when stats are requested
+        this.metrics.updateWorkerPool(this.activeWorkers, this.taskQueue.length, this.poolSize);
+        return {
+            poolSize: this.poolSize,
+            activeWorkers: this.activeWorkers,
+            queuedTasks: this.taskQueue.length,
+            utilization,
+        };
+    }
+    /**
+     * Dispose of worker pool
+     *
+     * Terminates all workers and clears the task queue.
+     * SMI-1330/1331: Also disposes cached router
+     */
+    dispose() {
+        this.disposed = true;
+        for (const worker of this.workers) {
+            worker.terminate();
+        }
+        this.workers = [];
+        this.taskQueue = [];
+        // SMI-1330/1331: Clean up cached router
+        if (this.router) {
+            this.router.dispose();
+            this.router = null;
+            this.routerPromise = null;
+        }
+    }
+}
+// Export for worker thread context detection
+export { isMainThread, parentPort, workerData };
+//# sourceMappingURL=worker-pool.js.map

package/dist/src/analysis/worker-pool.js.map

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

package/dist/src/analytics/schema.d.ts

@@ -11,7 +11,7 @@
 /**
  * Analytics schema SQL for skill usage, A/B testing, and ROI tracking
  */
-export declare const ANALYTICS_SCHEMA = "\n-- Skill usage events for attribution and value tracking\nCREATE TABLE IF NOT EXISTS skill_usage_events (\n  id TEXT PRIMARY KEY,\n  skill_id TEXT NOT NULL,\n  user_id TEXT NOT NULL,\n  session_id TEXT NOT NULL,\n  event_type TEXT NOT NULL CHECK(event_type IN ('activation', 'invocation', 'success', 'failure')),\n  context TEXT, -- JSON metadata about the usage context\n  value_score REAL, -- Estimated value contribution (0-1)\n  timestamp TEXT NOT NULL DEFAULT (datetime('now')),\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Indexes for usage queries\nCREATE INDEX IF NOT EXISTS idx_usage_skill_id ON skill_usage_events(skill_id);\nCREATE INDEX IF NOT EXISTS idx_usage_user_id ON skill_usage_events(user_id);\nCREATE INDEX IF NOT EXISTS idx_usage_session_id ON skill_usage_events(session_id);\nCREATE INDEX IF NOT EXISTS idx_usage_timestamp ON skill_usage_events(timestamp);\nCREATE INDEX IF NOT EXISTS idx_usage_event_type ON skill_usage_events(event_type);\n\n-- A/B testing experiments\nCREATE TABLE IF NOT EXISTS experiments (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL UNIQUE,\n  description TEXT,\n  hypothesis TEXT,\n  status TEXT NOT NULL CHECK(status IN ('draft', 'active', 'paused', 'completed')) DEFAULT 'draft',\n  variant_a TEXT NOT NULL, -- JSON config for control group\n  variant_b TEXT NOT NULL, -- JSON config for treatment group\n  start_date TEXT,\n  end_date TEXT,\n  target_sample_size INTEGER DEFAULT 100,\n  created_at TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- User assignments to experiment variants\nCREATE TABLE IF NOT EXISTS experiment_assignments (\n  id TEXT PRIMARY KEY,\n  experiment_id TEXT NOT NULL REFERENCES experiments(id) ON DELETE CASCADE,\n  user_id TEXT NOT NULL,\n  variant TEXT NOT NULL CHECK(variant IN ('control', 'treatment')),\n  assigned_at TEXT NOT NULL DEFAULT (datetime('now')),\n  UNIQUE(experiment_id, user_id)\n);\n\n-- Experiment outcome tracking\nCREATE TABLE IF NOT EXISTS experiment_outcomes (\n  id TEXT PRIMARY KEY,\n  experiment_id TEXT NOT NULL REFERENCES experiments(id) ON DELETE CASCADE,\n  assignment_id TEXT NOT NULL REFERENCES experiment_assignments(id) ON DELETE CASCADE,\n  outcome_type TEXT NOT NULL, -- e.g., 'activation', 'usage_count', 'value_score'\n  outcome_value REAL NOT NULL,\n  metadata TEXT, -- JSON additional data\n  measured_at TEXT NOT NULL DEFAULT (datetime('now')),\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Indexes for experiment queries\nCREATE INDEX IF NOT EXISTS idx_assignments_experiment ON experiment_assignments(experiment_id);\nCREATE INDEX IF NOT EXISTS idx_assignments_user ON experiment_assignments(user_id);\nCREATE INDEX IF NOT EXISTS idx_outcomes_experiment ON experiment_outcomes(experiment_id);\nCREATE INDEX IF NOT EXISTS idx_outcomes_assignment ON experiment_outcomes(assignment_id);\n\n-- ROI metrics aggregation (materialized view equivalent)\nCREATE TABLE IF NOT EXISTS roi_metrics (\n  id TEXT PRIMARY KEY,\n  metric_type TEXT NOT NULL, -- 'daily', 'weekly', 'monthly', 'user', 'skill'\n  entity_id TEXT, -- user_id or skill_id for entity-level metrics\n  period_start TEXT NOT NULL,\n  period_end TEXT NOT NULL,\n  total_activations INTEGER DEFAULT 0,\n  total_invocations INTEGER DEFAULT 0,\n  total_successes INTEGER DEFAULT 0,\n  total_failures INTEGER DEFAULT 0,\n  avg_value_score REAL DEFAULT 0.0,\n  estimated_time_saved REAL DEFAULT 0.0, -- in minutes\n  estimated_value_usd REAL DEFAULT 0.0, -- rough ROI estimate\n  metadata TEXT, -- JSON for additional metrics\n  computed_at TEXT NOT NULL DEFAULT (datetime('now')),\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Indexes for ROI queries\nCREATE INDEX IF NOT EXISTS idx_roi_type ON roi_metrics(metric_type);\nCREATE INDEX IF NOT EXISTS idx_roi_entity ON roi_metrics(entity_id);\nCREATE INDEX IF NOT EXISTS idx_roi_period ON roi_metrics(period_start, period_end);\nCREATE INDEX IF NOT EXISTS idx_roi_computed ON roi_metrics(computed_at);\n\n-- Value attribution mappings\nCREATE TABLE IF NOT EXISTS value_attributions (\n  id TEXT PRIMARY KEY,\n  usage_event_id TEXT NOT NULL REFERENCES skill_usage_events(id) ON DELETE CASCADE,\n  skill_id TEXT NOT NULL,\n  attribution_type TEXT NOT NULL, -- 'inline', 'metadata', 'session'\n  value_dimension TEXT NOT NULL, -- 'time_saved', 'quality_improved', 'error_prevented'\n  value_amount REAL NOT NULL,\n  confidence REAL NOT NULL CHECK(confidence >= 0 AND confidence <= 1),\n  metadata TEXT, -- JSON additional context\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Indexes for attribution queries\nCREATE INDEX IF NOT EXISTS idx_attributions_event ON value_attributions(usage_event_id);\nCREATE INDEX IF NOT EXISTS idx_attributions_skill ON value_attributions(skill_id);\nCREATE INDEX IF NOT EXISTS idx_attributions_type ON value_attributions(attribution_type);\n";
+export declare const ANALYTICS_SCHEMA = "\n-- Skill usage events for attribution and value tracking\nCREATE TABLE IF NOT EXISTS skill_usage_events (\n  id TEXT PRIMARY KEY,\n  skill_id TEXT NOT NULL,\n  user_id TEXT NOT NULL,\n  session_id TEXT NOT NULL,\n  event_type TEXT NOT NULL CHECK(event_type IN ('activation', 'invocation', 'success', 'failure')),\n  context TEXT, -- JSON metadata about the usage context\n  value_score REAL, -- Estimated value contribution (0-1)\n  timestamp TEXT NOT NULL DEFAULT (datetime('now')),\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Indexes for usage queries\nCREATE INDEX IF NOT EXISTS idx_usage_skill_id ON skill_usage_events(skill_id);\nCREATE INDEX IF NOT EXISTS idx_usage_user_id ON skill_usage_events(user_id);\nCREATE INDEX IF NOT EXISTS idx_usage_session_id ON skill_usage_events(session_id);\nCREATE INDEX IF NOT EXISTS idx_usage_timestamp ON skill_usage_events(timestamp);\nCREATE INDEX IF NOT EXISTS idx_usage_event_type ON skill_usage_events(event_type);\n\n-- A/B testing experiments\nCREATE TABLE IF NOT EXISTS experiments (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL UNIQUE,\n  description TEXT,\n  hypothesis TEXT,\n  status TEXT NOT NULL CHECK(status IN ('draft', 'active', 'paused', 'completed')) DEFAULT 'draft',\n  variant_a TEXT NOT NULL, -- JSON config for control group\n  variant_b TEXT NOT NULL, -- JSON config for treatment group\n  start_date TEXT,\n  end_date TEXT,\n  target_sample_size INTEGER DEFAULT 100,\n  created_at TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- User assignments to experiment variants\nCREATE TABLE IF NOT EXISTS experiment_assignments (\n  id TEXT PRIMARY KEY,\n  experiment_id TEXT NOT NULL REFERENCES experiments(id) ON DELETE CASCADE,\n  user_id TEXT NOT NULL,\n  variant TEXT NOT NULL CHECK(variant IN ('control', 'treatment')),\n  assigned_at TEXT NOT NULL DEFAULT (datetime('now')),\n  UNIQUE(experiment_id, user_id)\n);\n\n-- Experiment outcome tracking\nCREATE TABLE IF NOT EXISTS experiment_outcomes (\n  id TEXT PRIMARY KEY,\n  experiment_id TEXT NOT NULL REFERENCES experiments(id) ON DELETE CASCADE,\n  assignment_id TEXT NOT NULL REFERENCES experiment_assignments(id) ON DELETE CASCADE,\n  outcome_type TEXT NOT NULL, -- e.g., 'activation', 'usage_count', 'value_score'\n  outcome_value REAL NOT NULL,\n  metadata TEXT, -- JSON additional data\n  measured_at TEXT NOT NULL DEFAULT (datetime('now')),\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Indexes for experiment queries\nCREATE INDEX IF NOT EXISTS idx_assignments_experiment ON experiment_assignments(experiment_id);\nCREATE INDEX IF NOT EXISTS idx_assignments_user ON experiment_assignments(user_id);\nCREATE INDEX IF NOT EXISTS idx_outcomes_experiment ON experiment_outcomes(experiment_id);\nCREATE INDEX IF NOT EXISTS idx_outcomes_assignment ON experiment_outcomes(assignment_id);\n\n-- ROI metrics aggregation (materialized view equivalent)\nCREATE TABLE IF NOT EXISTS roi_metrics (\n  id TEXT PRIMARY KEY,\n  metric_type TEXT NOT NULL, -- 'daily', 'weekly', 'monthly', 'user', 'skill'\n  entity_id TEXT, -- user_id or skill_id for entity-level metrics\n  period_start TEXT NOT NULL,\n  period_end TEXT NOT NULL,\n  total_activations INTEGER DEFAULT 0,\n  total_invocations INTEGER DEFAULT 0,\n  total_successes INTEGER DEFAULT 0,\n  total_failures INTEGER DEFAULT 0,\n  avg_value_score REAL DEFAULT 0.0,\n  estimated_time_saved REAL DEFAULT 0.0, -- in minutes\n  estimated_value_usd REAL DEFAULT 0.0, -- rough ROI estimate\n  metadata TEXT, -- JSON for additional metrics\n  computed_at TEXT NOT NULL DEFAULT (datetime('now')),\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Indexes for ROI queries\nCREATE INDEX IF NOT EXISTS idx_roi_type ON roi_metrics(metric_type);\nCREATE INDEX IF NOT EXISTS idx_roi_entity ON roi_metrics(entity_id);\nCREATE INDEX IF NOT EXISTS idx_roi_period ON roi_metrics(period_start, period_end);\nCREATE INDEX IF NOT EXISTS idx_roi_computed ON roi_metrics(computed_at);\n\n-- Value attribution mappings\nCREATE TABLE IF NOT EXISTS value_attributions (\n  id TEXT PRIMARY KEY,\n  usage_event_id TEXT NOT NULL REFERENCES skill_usage_events(id) ON DELETE CASCADE,\n  skill_id TEXT NOT NULL,\n  attribution_type TEXT NOT NULL, -- 'inline', 'metadata', 'session'\n  value_dimension TEXT NOT NULL, -- 'time_saved', 'quality_improved', 'error_prevented'\n  value_amount REAL NOT NULL,\n  confidence REAL NOT NULL CHECK(confidence >= 0 AND confidence <= 1),\n  metadata TEXT, -- JSON additional context\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Indexes for attribution queries\nCREATE INDEX IF NOT EXISTS idx_attributions_event ON value_attributions(usage_event_id);\nCREATE INDEX IF NOT EXISTS idx_attributions_skill ON value_attributions(skill_id);\nCREATE INDEX IF NOT EXISTS idx_attributions_type ON value_attributions(attribution_type);\n\n-- ============================================================================\n-- Quota Management Tables (SMI-XXXX)\n-- ============================================================================\n\n-- Monthly usage quotas per customer/license\n-- Tracks API call usage against tier limits\nCREATE TABLE IF NOT EXISTS usage_quotas (\n  id TEXT PRIMARY KEY,\n  customer_id TEXT NOT NULL,\n  license_tier TEXT NOT NULL CHECK(license_tier IN ('community', 'individual', 'team', 'enterprise')),\n  billing_period_start TEXT NOT NULL,\n  billing_period_end TEXT NOT NULL,\n  api_calls_limit INTEGER NOT NULL,\n  api_calls_used INTEGER DEFAULT 0,\n  last_warning_threshold INTEGER DEFAULT 0, -- 0, 80, 90, or 100\n  last_warning_sent_at TEXT,\n  created_at TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at TEXT NOT NULL DEFAULT (datetime('now')),\n  UNIQUE(customer_id, billing_period_start)\n);\n\n-- Indexes for quota queries\nCREATE INDEX IF NOT EXISTS idx_quotas_customer ON usage_quotas(customer_id);\nCREATE INDEX IF NOT EXISTS idx_quotas_period ON usage_quotas(billing_period_start, billing_period_end);\nCREATE INDEX IF NOT EXISTS idx_quotas_tier ON usage_quotas(license_tier);\n\n-- Individual API call events for detailed tracking\n-- Used for quota enforcement and analytics\nCREATE TABLE IF NOT EXISTS api_call_events (\n  id TEXT PRIMARY KEY,\n  customer_id TEXT NOT NULL,\n  license_key_hash TEXT, -- SHA256 hash of license key for lookup\n  tool_name TEXT NOT NULL,\n  endpoint TEXT,\n  cost INTEGER DEFAULT 1, -- Some operations may cost multiple quota units\n  success INTEGER DEFAULT 1, -- 1 for success, 0 for failure\n  latency_ms INTEGER,\n  session_id TEXT,\n  metadata TEXT, -- JSON for additional context\n  timestamp TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Indexes for API call queries\nCREATE INDEX IF NOT EXISTS idx_api_calls_customer ON api_call_events(customer_id);\nCREATE INDEX IF NOT EXISTS idx_api_calls_timestamp ON api_call_events(timestamp);\nCREATE INDEX IF NOT EXISTS idx_api_calls_license ON api_call_events(license_key_hash);\nCREATE INDEX IF NOT EXISTS idx_api_calls_tool ON api_call_events(tool_name);\n\n-- User subscriptions for billing integration\n-- Links customers to Stripe subscriptions\nCREATE TABLE IF NOT EXISTS user_subscriptions (\n  id TEXT PRIMARY KEY,\n  customer_id TEXT NOT NULL UNIQUE,\n  email TEXT NOT NULL,\n  tier TEXT NOT NULL CHECK(tier IN ('community', 'individual', 'team', 'enterprise')),\n  stripe_customer_id TEXT,\n  stripe_subscription_id TEXT,\n  status TEXT NOT NULL CHECK(status IN ('active', 'past_due', 'canceled', 'trialing', 'paused')),\n  current_period_start TEXT,\n  current_period_end TEXT,\n  last_active_at TEXT,\n  created_at TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Indexes for subscription queries\nCREATE INDEX IF NOT EXISTS idx_subs_customer ON user_subscriptions(customer_id);\nCREATE INDEX IF NOT EXISTS idx_subs_stripe ON user_subscriptions(stripe_customer_id);\nCREATE INDEX IF NOT EXISTS idx_subs_status ON user_subscriptions(status);\nCREATE INDEX IF NOT EXISTS idx_subs_tier ON user_subscriptions(tier);\nCREATE INDEX IF NOT EXISTS idx_subs_last_active ON user_subscriptions(last_active_at);\n";
 /**
  * Apply analytics schema to a database
  */

package/dist/src/analytics/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/analytics/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB,o0JA2G5B,CAAA;AAED;;GAEG;AACH,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE9D,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAEhE"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/analytics/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB,4gQAmL5B,CAAA;AAED;;GAEG;AACH,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE9D,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAEhE"}

package/dist/src/analytics/schema.js

@@ -118,6 +118,78 @@ CREATE TABLE IF NOT EXISTS value_attributions (
 CREATE INDEX IF NOT EXISTS idx_attributions_event ON value_attributions(usage_event_id);
 CREATE INDEX IF NOT EXISTS idx_attributions_skill ON value_attributions(skill_id);
 CREATE INDEX IF NOT EXISTS idx_attributions_type ON value_attributions(attribution_type);
+
+-- ============================================================================
+-- Quota Management Tables (SMI-XXXX)
+-- ============================================================================
+
+-- Monthly usage quotas per customer/license
+-- Tracks API call usage against tier limits
+CREATE TABLE IF NOT EXISTS usage_quotas (
+  id TEXT PRIMARY KEY,
+  customer_id TEXT NOT NULL,
+  license_tier TEXT NOT NULL CHECK(license_tier IN ('community', 'individual', 'team', 'enterprise')),
+  billing_period_start TEXT NOT NULL,
+  billing_period_end TEXT NOT NULL,
+  api_calls_limit INTEGER NOT NULL,
+  api_calls_used INTEGER DEFAULT 0,
+  last_warning_threshold INTEGER DEFAULT 0, -- 0, 80, 90, or 100
+  last_warning_sent_at TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  UNIQUE(customer_id, billing_period_start)
+);
+
+-- Indexes for quota queries
+CREATE INDEX IF NOT EXISTS idx_quotas_customer ON usage_quotas(customer_id);
+CREATE INDEX IF NOT EXISTS idx_quotas_period ON usage_quotas(billing_period_start, billing_period_end);
+CREATE INDEX IF NOT EXISTS idx_quotas_tier ON usage_quotas(license_tier);
+
+-- Individual API call events for detailed tracking
+-- Used for quota enforcement and analytics
+CREATE TABLE IF NOT EXISTS api_call_events (
+  id TEXT PRIMARY KEY,
+  customer_id TEXT NOT NULL,
+  license_key_hash TEXT, -- SHA256 hash of license key for lookup
+  tool_name TEXT NOT NULL,
+  endpoint TEXT,
+  cost INTEGER DEFAULT 1, -- Some operations may cost multiple quota units
+  success INTEGER DEFAULT 1, -- 1 for success, 0 for failure
+  latency_ms INTEGER,
+  session_id TEXT,
+  metadata TEXT, -- JSON for additional context
+  timestamp TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Indexes for API call queries
+CREATE INDEX IF NOT EXISTS idx_api_calls_customer ON api_call_events(customer_id);
+CREATE INDEX IF NOT EXISTS idx_api_calls_timestamp ON api_call_events(timestamp);
+CREATE INDEX IF NOT EXISTS idx_api_calls_license ON api_call_events(license_key_hash);
+CREATE INDEX IF NOT EXISTS idx_api_calls_tool ON api_call_events(tool_name);
+
+-- User subscriptions for billing integration
+-- Links customers to Stripe subscriptions
+CREATE TABLE IF NOT EXISTS user_subscriptions (
+  id TEXT PRIMARY KEY,
+  customer_id TEXT NOT NULL UNIQUE,
+  email TEXT NOT NULL,
+  tier TEXT NOT NULL CHECK(tier IN ('community', 'individual', 'team', 'enterprise')),
+  stripe_customer_id TEXT,
+  stripe_subscription_id TEXT,
+  status TEXT NOT NULL CHECK(status IN ('active', 'past_due', 'canceled', 'trialing', 'paused')),
+  current_period_start TEXT,
+  current_period_end TEXT,
+  last_active_at TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Indexes for subscription queries
+CREATE INDEX IF NOT EXISTS idx_subs_customer ON user_subscriptions(customer_id);
+CREATE INDEX IF NOT EXISTS idx_subs_stripe ON user_subscriptions(stripe_customer_id);
+CREATE INDEX IF NOT EXISTS idx_subs_status ON user_subscriptions(status);
+CREATE INDEX IF NOT EXISTS idx_subs_tier ON user_subscriptions(tier);
+CREATE INDEX IF NOT EXISTS idx_subs_last_active ON user_subscriptions(last_active_at);
 `;
 export function initializeAnalyticsSchema(db) {
     db.exec(ANALYTICS_SCHEMA);

package/dist/src/analytics/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/analytics/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2G/B,CAAA;AAOD,MAAM,UAAU,yBAAyB,CAAC,EAAgB;IACxD,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;AAC3B,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/analytics/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmL/B,CAAA;AAOD,MAAM,UAAU,yBAAyB,CAAC,EAAgB;IACxD,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;AAC3B,CAAC"}

package/dist/src/api/cache.d.ts

@@ -54,6 +54,8 @@ export declare class ApiCache {
     private hits;
     private misses;
     private evictions;
+    private operationCount;
+    private readonly PRUNE_INTERVAL;
     constructor(config?: CacheConfig);
     /**
      * Generate cache key from endpoint and parameters
@@ -84,13 +86,34 @@ export declare class ApiCache {
      */
     prune(): number;
     /**
-     * Invalidate entries matching a pattern
+     * Invalidate entries matching a pattern.
+     *
+     * When a string is provided, it is treated as a literal string and
+     * special RegExp characters are escaped to prevent RegExp injection.
+     * To use regex patterns, pass a RegExp object directly.
+     *
+     * @param pattern - Literal string to match or RegExp for pattern matching
+     * @returns Number of entries invalidated
+     *
+     * @example
+     * ```typescript
+     * // Literal string matching (special chars are escaped)
+     * cache.invalidatePattern('search:user.name') // Matches exactly 'search:user.name'
+     *
+     * // RegExp for pattern matching
+     * cache.invalidatePattern(/^search:/) // Matches all keys starting with 'search:'
+     * ```
      */
     invalidatePattern(pattern: string | RegExp): number;
     /**
      * Get cache statistics
      */
     getStats(): CacheStats;
+    /**
+     * Automatically prune expired entries every PRUNE_INTERVAL operations.
+     * SMI-1262: Prevents expired entries from accumulating until maxEntries is reached.
+     */
+    private maybeAutoPrune;
     /**
      * Evict least recently used entries
      */

package/dist/src/api/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/api/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAI9C,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,WAAW,CAAS;IAG5B,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,SAAS,CAAI;gBAET,MAAM,GAAE,WAAgB;IAOpC;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAa5E;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAsBlC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,OAAO,WAAW,GAAG,IAAI;IAiB3E;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAUzB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,KAAK,IAAI,MAAM;IAcf;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAcnD;;OAEG;IACH,QAAQ,IAAI,UAAU;IAWtB;;OAEG;IACH,OAAO,CAAC,cAAc;CAwBvB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,QAAQ,CAE1D;AAOD;;GAEG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAKzC;AAED,eAAe,QAAQ,CAAA"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/api/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiCH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAI9C,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,WAAW,CAAS;IAG5B,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,SAAS,CAAI;IAGrB,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAM;gBAEzB,MAAM,GAAE,WAAgB;IAOpC;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAa5E;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAuBlC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,OAAO,WAAW,GAAG,IAAI;IAmB3E;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAUzB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,KAAK,IAAI,MAAM;IAcf;;;;;;;;;;;;;;;;;;OAkBG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAcnD;;OAEG;IACH,QAAQ,IAAI,UAAU;IAWtB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;IACH,OAAO,CAAC,cAAc;CAwBvB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,QAAQ,CAE1D;AAOD;;GAEG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAKzC;AAED,eAAe,QAAQ,CAAA"}