@skillsmith/core 0.1.0

package/dist/src/analytics/schema.js

@@ -0,0 +1,125 @@
+/**
+ * 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);
+`;
+export function initializeAnalyticsSchema(db) {
+    db.exec(ANALYTICS_SCHEMA);
+}
+//# sourceMappingURL=schema.js.map

package/dist/src/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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2G/B,CAAA;AAOD,MAAM,UAAU,yBAAyB,CAAC,EAAgB;IACxD,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;AAC3B,CAAC"}

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

@@ -0,0 +1,76 @@
+/**
+ * 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;
+    /**
+     * Create an analytics storage instance
+     *
+     * @param dbPath - Optional custom database path (defaults to ~/.skillsmith/analytics.db)
+     * @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
+     */
+    constructor(dbPath?: string);
+    /**
+     * 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/src/analytics/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/analytics/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAc/D;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,EAAE,CAAmB;IAE7B;;;;;;;;;OASG;gBACS,MAAM,GAAE,MAAqB;IAgCzC;;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/src/analytics/storage.js

@@ -0,0 +1,180 @@
+/**
+ * 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 Database from 'better-sqlite3';
+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;
+    /**
+     * Create an analytics storage instance
+     *
+     * @param dbPath - Optional custom database path (defaults to ~/.skillsmith/analytics.db)
+     * @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
+     */
+    constructor(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 });
+            }
+        }
+        this.db = new Database(resolvedPath);
+        this.initSchema();
+    }
+    /**
+     * 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/src/analytics/storage.js.map

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

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

@@ -0,0 +1,277 @@
+/**
+ * Type definitions for Analytics Infrastructure
+ *
+ * Covers:
+ * - Skill usage events and attribution
+ * - A/B testing experiments
+ * - ROI metrics and dashboards
+ */
+/**
+ * Skill usage event types
+ */
+export type UsageEventType = 'activation' | 'invocation' | 'success' | 'failure';
+/**
+ * Skill usage event
+ */
+export interface UsageEvent {
+    id: string;
+    skillId: string;
+    userId: string;
+    sessionId: string;
+    eventType: UsageEventType;
+    context?: Record<string, unknown>;
+    valueScore?: number;
+    timestamp: string;
+    createdAt: string;
+}
+/**
+ * Input for creating a usage event
+ */
+export interface UsageEventInput {
+    skillId: string;
+    userId: string;
+    sessionId: string;
+    eventType: UsageEventType;
+    context?: Record<string, unknown>;
+    valueScore?: number;
+}
+/**
+ * Experiment status
+ */
+export type ExperimentStatus = 'draft' | 'active' | 'paused' | 'completed';
+/**
+ * Experiment variant
+ */
+export type ExperimentVariant = 'control' | 'treatment';
+/**
+ * A/B testing experiment
+ */
+export interface Experiment {
+    id: string;
+    name: string;
+    description?: string;
+    hypothesis?: string;
+    status: ExperimentStatus;
+    variantA: Record<string, unknown>;
+    variantB: Record<string, unknown>;
+    startDate?: string;
+    endDate?: string;
+    targetSampleSize: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Input for creating an experiment
+ */
+export interface ExperimentInput {
+    name: string;
+    description?: string;
+    hypothesis?: string;
+    variantA: Record<string, unknown>;
+    variantB: Record<string, unknown>;
+    targetSampleSize?: number;
+}
+/**
+ * Experiment assignment
+ */
+export interface ExperimentAssignment {
+    id: string;
+    experimentId: string;
+    userId: string;
+    variant: ExperimentVariant;
+    assignedAt: string;
+}
+/**
+ * Experiment outcome measurement
+ */
+export interface ExperimentOutcome {
+    id: string;
+    experimentId: string;
+    assignmentId: string;
+    outcomeType: string;
+    outcomeValue: number;
+    metadata?: Record<string, unknown>;
+    measuredAt: string;
+    createdAt: string;
+}
+/**
+ * Input for recording an outcome
+ */
+export interface OutcomeInput {
+    experimentId: string;
+    assignmentId: string;
+    outcomeType: string;
+    outcomeValue: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * ROI metric types
+ */
+export type ROIMetricType = 'daily' | 'weekly' | 'monthly' | 'user' | 'skill';
+/**
+ * ROI metrics
+ */
+export interface ROIMetrics {
+    id: string;
+    metricType: ROIMetricType;
+    entityId?: string;
+    periodStart: string;
+    periodEnd: string;
+    totalActivations: number;
+    totalInvocations: number;
+    totalSuccesses: number;
+    totalFailures: number;
+    avgValueScore: number;
+    estimatedTimeSaved: number;
+    estimatedValueUsd: number;
+    metadata?: Record<string, unknown>;
+    computedAt: string;
+    createdAt: string;
+}
+/**
+ * Value attribution types
+ */
+export type AttributionType = 'inline' | 'metadata' | 'session';
+/**
+ * Value dimensions for ROI calculation
+ */
+export type ValueDimension = 'time_saved' | 'quality_improved' | 'error_prevented';
+/**
+ * Value attribution
+ */
+export interface ValueAttribution {
+    id: string;
+    usageEventId: string;
+    skillId: string;
+    attributionType: AttributionType;
+    valueDimension: ValueDimension;
+    valueAmount: number;
+    confidence: number;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+}
+/**
+ * Usage analytics summary for a time period
+ */
+export interface UsageAnalyticsSummary {
+    periodStart: string;
+    periodEnd: string;
+    totalEvents: number;
+    eventsByType: Record<UsageEventType, number>;
+    uniqueUsers: number;
+    uniqueSkills: number;
+    avgValueScore: number;
+    topSkills: Array<{
+        skillId: string;
+        count: number;
+    }>;
+}
+/**
+ * Experiment analysis results
+ */
+export interface ExperimentAnalysis {
+    experimentId: string;
+    experimentName: string;
+    controlGroup: {
+        sampleSize: number;
+        outcomes: Record<string, {
+            mean: number;
+            stdDev: number;
+        }>;
+    };
+    treatmentGroup: {
+        sampleSize: number;
+        outcomes: Record<string, {
+            mean: number;
+            stdDev: number;
+        }>;
+    };
+    pValues: Record<string, number>;
+    confidenceIntervals: Record<string, {
+        lower: number;
+        upper: number;
+    }>;
+    recommendation: 'continue' | 'stop_control_wins' | 'stop_treatment_wins' | 'inconclusive';
+}
+/**
+ * ROI dashboard data
+ */
+export interface ROIDashboard {
+    user?: {
+        userId: string;
+        totalTimeSaved: number;
+        estimatedValueUsd: number;
+        topSkills: Array<{
+            skillId: string;
+            skillName: string;
+            timeSaved: number;
+        }>;
+        weeklyTrend: Array<{
+            week: string;
+            timeSaved: number;
+        }>;
+    };
+    stakeholder?: {
+        totalUsers: number;
+        totalActivations: number;
+        avgTimeSavedPerUser: number;
+        totalEstimatedValue: number;
+        adoptionRate: number;
+        skillLeaderboard: Array<{
+            skillId: string;
+            skillName: string;
+            userCount: number;
+            totalValue: number;
+        }>;
+    };
+}
+/**
+ * Export format options
+ */
+export type ExportFormat = 'json' | 'csv' | 'pdf';
+/**
+ * Export options
+ */
+export interface ExportOptions {
+    format: ExportFormat;
+    startDate?: string;
+    endDate?: string;
+    includeCharts?: boolean;
+}
+/**
+ * SMI-914: Skill Usage Event tracking types
+ *
+ * These types support per-skill usage analytics with:
+ * - Anonymized user tracking (no PII)
+ * - Task duration measurement
+ * - Success/error/abandoned outcomes
+ * - 30-day rolling window storage
+ */
+/**
+ * Outcome of a skill invocation
+ */
+export type SkillUsageOutcome = 'success' | 'error' | 'abandoned';
+/**
+ * Individual skill usage event (anonymized)
+ */
+export interface SkillUsageEvent {
+    id?: number;
+    skillId: string;
+    userId: string;
+    timestamp: number;
+    taskDuration: number;
+    outcome: SkillUsageOutcome;
+    contextHash: string;
+}
+/**
+ * Aggregated metrics for a skill
+ */
+export interface SkillMetrics {
+    skillId: string;
+    totalInvocations: number;
+    successRate: number;
+    avgTaskDuration: number;
+    uniqueUsers: number;
+    lastUsed: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/analytics/types.js

@@ -0,0 +1,10 @@
+/**
+ * Type definitions for Analytics Infrastructure
+ *
+ * Covers:
+ * - Skill usage events and attribution
+ * - A/B testing experiments
+ * - ROI metrics and dashboards
+ */
+export {};
+//# sourceMappingURL=types.js.map