@skillsmith/core 0.5.5 → 0.5.6

package/dist/analytics/schema.js

@@ -0,0 +1,265 @@
+/**
+ * Analytics Database Schema
+ *
+ * Implements Phase 4 Product Strategy analytics infrastructure:
+ * - Epic 3: Skill usage tracking with 30-day rolling window
+ * - Epic 4: A/B testing experiment management
+ * - Epic 4: ROI metrics and dashboard data
+ *
+ * SMI-XXX: Analytics infrastructure for product strategy
+ */
+/**
+ * Analytics schema SQL for skill usage, A/B testing, and ROI tracking
+ */
+export const ANALYTICS_SCHEMA = `
+-- Skill usage events for attribution and value tracking
+CREATE TABLE IF NOT EXISTS skill_usage_events (
+  id TEXT PRIMARY KEY,
+  skill_id TEXT NOT NULL,
+  user_id TEXT NOT NULL,
+  session_id TEXT NOT NULL,
+  event_type TEXT NOT NULL CHECK(event_type IN ('activation', 'invocation', 'success', 'failure')),
+  context TEXT, -- JSON metadata about the usage context
+  value_score REAL, -- Estimated value contribution (0-1)
+  timestamp TEXT NOT NULL DEFAULT (datetime('now')),
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Indexes for usage queries
+CREATE INDEX IF NOT EXISTS idx_usage_skill_id ON skill_usage_events(skill_id);
+CREATE INDEX IF NOT EXISTS idx_usage_user_id ON skill_usage_events(user_id);
+CREATE INDEX IF NOT EXISTS idx_usage_session_id ON skill_usage_events(session_id);
+CREATE INDEX IF NOT EXISTS idx_usage_timestamp ON skill_usage_events(timestamp);
+CREATE INDEX IF NOT EXISTS idx_usage_event_type ON skill_usage_events(event_type);
+
+-- A/B testing experiments
+CREATE TABLE IF NOT EXISTS experiments (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL UNIQUE,
+  description TEXT,
+  hypothesis TEXT,
+  status TEXT NOT NULL CHECK(status IN ('draft', 'active', 'paused', 'completed')) DEFAULT 'draft',
+  variant_a TEXT NOT NULL, -- JSON config for control group
+  variant_b TEXT NOT NULL, -- JSON config for treatment group
+  start_date TEXT,
+  end_date TEXT,
+  target_sample_size INTEGER DEFAULT 100,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- User assignments to experiment variants
+CREATE TABLE IF NOT EXISTS experiment_assignments (
+  id TEXT PRIMARY KEY,
+  experiment_id TEXT NOT NULL REFERENCES experiments(id) ON DELETE CASCADE,
+  user_id TEXT NOT NULL,
+  variant TEXT NOT NULL CHECK(variant IN ('control', 'treatment')),
+  assigned_at TEXT NOT NULL DEFAULT (datetime('now')),
+  UNIQUE(experiment_id, user_id)
+);
+
+-- Experiment outcome tracking
+CREATE TABLE IF NOT EXISTS experiment_outcomes (
+  id TEXT PRIMARY KEY,
+  experiment_id TEXT NOT NULL REFERENCES experiments(id) ON DELETE CASCADE,
+  assignment_id TEXT NOT NULL REFERENCES experiment_assignments(id) ON DELETE CASCADE,
+  outcome_type TEXT NOT NULL, -- e.g., 'activation', 'usage_count', 'value_score'
+  outcome_value REAL NOT NULL,
+  metadata TEXT, -- JSON additional data
+  measured_at TEXT NOT NULL DEFAULT (datetime('now')),
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Indexes for experiment queries
+CREATE INDEX IF NOT EXISTS idx_assignments_experiment ON experiment_assignments(experiment_id);
+CREATE INDEX IF NOT EXISTS idx_assignments_user ON experiment_assignments(user_id);
+CREATE INDEX IF NOT EXISTS idx_outcomes_experiment ON experiment_outcomes(experiment_id);
+CREATE INDEX IF NOT EXISTS idx_outcomes_assignment ON experiment_outcomes(assignment_id);
+
+-- ROI metrics aggregation (materialized view equivalent)
+CREATE TABLE IF NOT EXISTS roi_metrics (
+  id TEXT PRIMARY KEY,
+  metric_type TEXT NOT NULL, -- 'daily', 'weekly', 'monthly', 'user', 'skill'
+  entity_id TEXT, -- user_id or skill_id for entity-level metrics
+  period_start TEXT NOT NULL,
+  period_end TEXT NOT NULL,
+  total_activations INTEGER DEFAULT 0,
+  total_invocations INTEGER DEFAULT 0,
+  total_successes INTEGER DEFAULT 0,
+  total_failures INTEGER DEFAULT 0,
+  avg_value_score REAL DEFAULT 0.0,
+  estimated_time_saved REAL DEFAULT 0.0, -- in minutes
+  estimated_value_usd REAL DEFAULT 0.0, -- rough ROI estimate
+  metadata TEXT, -- JSON for additional metrics
+  computed_at TEXT NOT NULL DEFAULT (datetime('now')),
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Indexes for ROI queries
+CREATE INDEX IF NOT EXISTS idx_roi_type ON roi_metrics(metric_type);
+CREATE INDEX IF NOT EXISTS idx_roi_entity ON roi_metrics(entity_id);
+CREATE INDEX IF NOT EXISTS idx_roi_period ON roi_metrics(period_start, period_end);
+CREATE INDEX IF NOT EXISTS idx_roi_computed ON roi_metrics(computed_at);
+
+-- Value attribution mappings
+CREATE TABLE IF NOT EXISTS value_attributions (
+  id TEXT PRIMARY KEY,
+  usage_event_id TEXT NOT NULL REFERENCES skill_usage_events(id) ON DELETE CASCADE,
+  skill_id TEXT NOT NULL,
+  attribution_type TEXT NOT NULL, -- 'inline', 'metadata', 'session'
+  value_dimension TEXT NOT NULL, -- 'time_saved', 'quality_improved', 'error_prevented'
+  value_amount REAL NOT NULL,
+  confidence REAL NOT NULL CHECK(confidence >= 0 AND confidence <= 1),
+  metadata TEXT, -- JSON additional context
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Indexes for attribution queries
+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,
+  stripe_price_id TEXT,  -- SMI-1062: Stripe price ID for current plan
+  status TEXT NOT NULL CHECK(status IN ('active', 'past_due', 'canceled', 'trialing', 'paused')),
+  seat_count INTEGER DEFAULT 1,  -- SMI-1067: For team/enterprise seat-based billing
+  current_period_start TEXT,
+  current_period_end TEXT,
+  canceled_at TEXT,  -- SMI-1062: When subscription was canceled
+  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);
+
+-- ============================================================================
+-- Billing Tables (SMI-1062 to SMI-1070 - Phase 6)
+-- ============================================================================
+
+-- Stripe webhook events for idempotent processing
+-- Prevents replay attacks and duplicate event handling
+CREATE TABLE IF NOT EXISTS stripe_webhook_events (
+  id TEXT PRIMARY KEY,
+  stripe_event_id TEXT UNIQUE NOT NULL,
+  event_type TEXT NOT NULL,
+  processed_at TEXT NOT NULL DEFAULT (datetime('now')),
+  payload TEXT,  -- Store full event for debugging/reconciliation
+  success INTEGER DEFAULT 1,  -- 1 for success, 0 for failure
+  error_message TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_webhook_events_stripe_id ON stripe_webhook_events(stripe_event_id);
+CREATE INDEX IF NOT EXISTS idx_webhook_events_type ON stripe_webhook_events(event_type);
+CREATE INDEX IF NOT EXISTS idx_webhook_events_processed ON stripe_webhook_events(processed_at);
+
+-- License keys linking subscriptions to JWT tokens
+-- Supports key rotation and revocation
+CREATE TABLE IF NOT EXISTS license_keys (
+  id TEXT PRIMARY KEY,
+  subscription_id TEXT NOT NULL,  -- References user_subscriptions.id
+  organization_id TEXT NOT NULL,
+  key_jwt TEXT NOT NULL,
+  key_hash TEXT NOT NULL,  -- SHA256 hash for lookup without exposing key
+  key_expiry TEXT NOT NULL,
+  is_active INTEGER DEFAULT 1,
+  generated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  revoked_at TEXT,
+  revocation_reason TEXT,
+  UNIQUE(key_hash)
+);
+
+CREATE INDEX IF NOT EXISTS idx_license_keys_subscription ON license_keys(subscription_id);
+CREATE INDEX IF NOT EXISTS idx_license_keys_org ON license_keys(organization_id);
+CREATE INDEX IF NOT EXISTS idx_license_keys_active ON license_keys(is_active);
+CREATE INDEX IF NOT EXISTS idx_license_keys_hash ON license_keys(key_hash);
+
+-- Invoices for customer self-service and billing history
+CREATE TABLE IF NOT EXISTS invoices (
+  id TEXT PRIMARY KEY,
+  customer_id TEXT NOT NULL,  -- References user_subscriptions.customer_id
+  stripe_invoice_id TEXT UNIQUE NOT NULL,
+  subscription_id TEXT,  -- References user_subscriptions.id
+  amount_cents INTEGER NOT NULL,
+  currency TEXT DEFAULT 'usd',
+  status TEXT NOT NULL CHECK(status IN ('draft', 'open', 'paid', 'void', 'uncollectible')),
+  pdf_url TEXT,
+  hosted_invoice_url TEXT,
+  invoice_number TEXT,
+  paid_at TEXT,
+  period_start TEXT,
+  period_end TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_invoices_customer ON invoices(customer_id);
+CREATE INDEX IF NOT EXISTS idx_invoices_stripe ON invoices(stripe_invoice_id);
+CREATE INDEX IF NOT EXISTS idx_invoices_status ON invoices(status);
+CREATE INDEX IF NOT EXISTS idx_invoices_subscription ON invoices(subscription_id);
+`;
+export function initializeAnalyticsSchema(db) {
+    db.exec(ANALYTICS_SCHEMA);
+}
+//# sourceMappingURL=schema.js.map

package/dist/analytics/schema.js.map

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

package/dist/analytics/storage.d.ts

@@ -0,0 +1,82 @@
+/**
+ * SMI-914: Analytics Storage with SQLite
+ * SMI-898: Path traversal protection for database paths
+ *
+ * Provides persistent storage for skill usage events with:
+ * - SQLite database in ~/.skillsmith/analytics.db
+ * - 30-day rolling window for data retention
+ * - Efficient indexes for querying by skill and timestamp
+ * - Secure path validation to prevent path traversal attacks
+ */
+import type { SkillUsageEvent, SkillMetrics } from './types.js';
+/**
+ * SQLite storage for skill usage analytics
+ */
+export declare class AnalyticsStorage {
+    private db;
+    /**
+     * @deprecated Use AnalyticsStorage.create(dbPath) — async factory with WASM fallback.
+     * This constructor always throws to prevent silent data loss.
+     */
+    constructor(_dbPath?: string);
+    /**
+     * Async factory — supports both native and WASM SQLite.
+     *
+     * @param dbPath - Optional custom database path (defaults to ~/.skillsmith/analytics.db)
+     * @returns Fully initialised AnalyticsStorage instance
+     * @throws Error if dbPath contains path traversal attempt
+     *
+     * @see SMI-898: Path traversal protection
+     * - Validates custom dbPath against path traversal attacks
+     * - Rejects paths with ".." or outside allowed directories
+     */
+    static create(dbPath?: string): Promise<AnalyticsStorage>;
+    /**
+     * Initialize database schema
+     */
+    private initSchema;
+    /**
+     * Record a skill usage event
+     *
+     * @param event - The usage event to record
+     */
+    recordEvent(event: SkillUsageEvent): void;
+    /**
+     * Get all events for a skill
+     *
+     * @param skillId - The skill identifier
+     * @param limit - Maximum number of events to return
+     * @returns Array of usage events
+     */
+    getEventsForSkill(skillId: string, limit?: number): SkillUsageEvent[];
+    /**
+     * Get aggregated metrics for a skill
+     *
+     * @param skillId - The skill identifier
+     * @returns Aggregated metrics or null if no data
+     */
+    getMetricsForSkill(skillId: string): SkillMetrics | null;
+    /**
+     * Delete events older than retention period
+     *
+     * @returns Number of deleted events
+     */
+    cleanup(): number;
+    /**
+     * Get total event count
+     *
+     * @returns Number of stored events
+     */
+    getEventCount(): number;
+    /**
+     * Get event count by outcome
+     *
+     * @returns Object with counts per outcome type
+     */
+    getOutcomeCounts(): Record<string, number>;
+    /**
+     * Close database connection
+     */
+    close(): void;
+}
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/analytics/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAc/D;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,EAAE,CAAW;IAErB;;;OAGG;gBACS,OAAO,CAAC,EAAE,MAAM;IAO5B;;;;;;;;;;OAUG;WACU,MAAM,CAAC,MAAM,GAAE,MAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkC7E;;OAEG;IACH,OAAO,CAAC,UAAU;IAmBlB;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAezC;;;;;;OAMG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,GAAG,eAAe,EAAE;IAY1E;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAiBxD;;;;OAIG;IACH,OAAO,IAAI,MAAM;IAMjB;;;;OAIG;IACH,aAAa,IAAI,MAAM;IAOvB;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAgB1C;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/analytics/storage.js

@@ -0,0 +1,191 @@
+/**
+ * SMI-914: Analytics Storage with SQLite
+ * SMI-898: Path traversal protection for database paths
+ *
+ * Provides persistent storage for skill usage events with:
+ * - SQLite database in ~/.skillsmith/analytics.db
+ * - 30-day rolling window for data retention
+ * - Efficient indexes for querying by skill and timestamp
+ * - Secure path validation to prevent path traversal attacks
+ */
+import { createDatabaseAsync } from '../db/createDatabase.js';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { existsSync, mkdirSync } from 'fs';
+import { RETENTION_DAYS, MS_PER_DAY } from './constants.js';
+import { validateDbPath } from '../security/pathValidation.js';
+/**
+ * Default directory for analytics data
+ */
+const ANALYTICS_DIR = join(homedir(), '.skillsmith');
+/**
+ * Default database file path
+ */
+const ANALYTICS_DB = join(ANALYTICS_DIR, 'analytics.db');
+/**
+ * SQLite storage for skill usage analytics
+ */
+export class AnalyticsStorage {
+    db;
+    /**
+     * @deprecated Use AnalyticsStorage.create(dbPath) — async factory with WASM fallback.
+     * This constructor always throws to prevent silent data loss.
+     */
+    constructor(_dbPath) {
+        throw new Error('[AnalyticsStorage] Cannot construct synchronously. ' +
+            'Use await AnalyticsStorage.create(dbPath) instead.');
+    }
+    /**
+     * Async factory — supports both native and WASM SQLite.
+     *
+     * @param dbPath - Optional custom database path (defaults to ~/.skillsmith/analytics.db)
+     * @returns Fully initialised AnalyticsStorage instance
+     * @throws Error if dbPath contains path traversal attempt
+     *
+     * @see SMI-898: Path traversal protection
+     * - Validates custom dbPath against path traversal attacks
+     * - Rejects paths with ".." or outside allowed directories
+     */
+    static async create(dbPath = ANALYTICS_DB) {
+        let resolvedPath = dbPath;
+        // SMI-898: Validate custom paths for path traversal
+        if (dbPath !== ANALYTICS_DB) {
+            const validation = validateDbPath(dbPath, {
+                allowInMemory: true,
+                allowTempDir: true,
+            });
+            if (!validation.valid) {
+                throw new Error(`Invalid analytics database path: ${validation.error}. ` +
+                    'Path must be within ~/.skillsmith, ~/.claude, or temp directories.');
+            }
+            resolvedPath = validation.resolvedPath;
+        }
+        // Ensure directory exists (skip for in-memory)
+        if (resolvedPath !== ':memory:') {
+            const dir = dirname(resolvedPath);
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+        }
+        const instance = Object.create(AnalyticsStorage.prototype);
+        instance.db = await createDatabaseAsync(resolvedPath);
+        instance.initSchema();
+        return instance;
+    }
+    /**
+     * Initialize database schema
+     */
+    initSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS usage_events (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        skill_id TEXT NOT NULL,
+        user_id TEXT NOT NULL,
+        timestamp INTEGER NOT NULL,
+        task_duration INTEGER NOT NULL,
+        outcome TEXT NOT NULL CHECK(outcome IN ('success', 'error', 'abandoned')),
+        context_hash TEXT NOT NULL,
+        created_at INTEGER DEFAULT (strftime('%s', 'now') * 1000)
+      );
+      CREATE INDEX IF NOT EXISTS idx_skill_id ON usage_events(skill_id);
+      CREATE INDEX IF NOT EXISTS idx_timestamp ON usage_events(timestamp);
+      CREATE INDEX IF NOT EXISTS idx_user_id ON usage_events(user_id);
+      CREATE INDEX IF NOT EXISTS idx_outcome ON usage_events(outcome);
+    `);
+    }
+    /**
+     * Record a skill usage event
+     *
+     * @param event - The usage event to record
+     */
+    recordEvent(event) {
+        const stmt = this.db.prepare(`
+      INSERT INTO usage_events (skill_id, user_id, timestamp, task_duration, outcome, context_hash)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `);
+        stmt.run(event.skillId, event.userId, event.timestamp, event.taskDuration, event.outcome, event.contextHash);
+    }
+    /**
+     * Get all events for a skill
+     *
+     * @param skillId - The skill identifier
+     * @param limit - Maximum number of events to return
+     * @returns Array of usage events
+     */
+    getEventsForSkill(skillId, limit = 100) {
+        const stmt = this.db.prepare(`
+      SELECT id, skill_id as skillId, user_id as userId, timestamp,
+             task_duration as taskDuration, outcome, context_hash as contextHash
+      FROM usage_events
+      WHERE skill_id = ?
+      ORDER BY timestamp DESC
+      LIMIT ?
+    `);
+        return stmt.all(skillId, limit);
+    }
+    /**
+     * Get aggregated metrics for a skill
+     *
+     * @param skillId - The skill identifier
+     * @returns Aggregated metrics or null if no data
+     */
+    getMetricsForSkill(skillId) {
+        const stmt = this.db.prepare(`
+      SELECT
+        skill_id as skillId,
+        COUNT(*) as totalInvocations,
+        CAST(SUM(CASE WHEN outcome = 'success' THEN 1 ELSE 0 END) AS REAL) / COUNT(*) as successRate,
+        AVG(task_duration) as avgTaskDuration,
+        COUNT(DISTINCT user_id) as uniqueUsers,
+        MAX(timestamp) as lastUsed
+      FROM usage_events
+      WHERE skill_id = ?
+      GROUP BY skill_id
+    `);
+        const result = stmt.get(skillId);
+        return result ?? null;
+    }
+    /**
+     * Delete events older than retention period
+     *
+     * @returns Number of deleted events
+     */
+    cleanup() {
+        const cutoff = Date.now() - RETENTION_DAYS * MS_PER_DAY;
+        const result = this.db.prepare('DELETE FROM usage_events WHERE timestamp < ?').run(cutoff);
+        return result.changes;
+    }
+    /**
+     * Get total event count
+     *
+     * @returns Number of stored events
+     */
+    getEventCount() {
+        const result = this.db.prepare('SELECT COUNT(*) as count FROM usage_events').get();
+        return result?.count ?? 0;
+    }
+    /**
+     * Get event count by outcome
+     *
+     * @returns Object with counts per outcome type
+     */
+    getOutcomeCounts() {
+        const stmt = this.db.prepare(`
+      SELECT outcome, COUNT(*) as count
+      FROM usage_events
+      GROUP BY outcome
+    `);
+        const rows = stmt.all();
+        return rows.reduce((acc, row) => {
+            acc[row.outcome] = row.count;
+            return acc;
+        }, {});
+    }
+    /**
+     * Close database connection
+     */
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/analytics/storage.js.map

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