@skillsmith/core 0.1.0

package/dist/src/db/schema.js

@@ -0,0 +1,318 @@
+/**
+ * SMI-577: SQLite Database Schema with FTS5
+ *
+ * Implements the core database schema for Skillsmith including:
+ * - Skills table with full metadata
+ * - FTS5 virtual table for full-text search
+ * - Sources, Categories, and Cache tables
+ * - WAL mode for performance
+ * - Indexes for common query patterns
+ */
+import Database from 'better-sqlite3';
+export const SCHEMA_VERSION = 2;
+/**
+ * SQL statements for creating the database schema
+ */
+export const SCHEMA_SQL = `
+-- Enable WAL mode for better concurrent performance
+PRAGMA journal_mode = WAL;
+PRAGMA synchronous = NORMAL;
+PRAGMA cache_size = -64000; -- 64MB cache
+PRAGMA temp_store = MEMORY;
+
+-- Schema version tracking
+CREATE TABLE IF NOT EXISTS schema_version (
+  version INTEGER PRIMARY KEY,
+  applied_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Skills table - main storage for discovered skills
+CREATE TABLE IF NOT EXISTS skills (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  description TEXT,
+  author TEXT,
+  repo_url TEXT UNIQUE,
+  quality_score REAL CHECK(quality_score IS NULL OR (quality_score >= 0 AND quality_score <= 1)),
+  trust_tier TEXT CHECK(trust_tier IN ('verified', 'community', 'experimental', 'unknown')) DEFAULT 'unknown',
+  tags TEXT DEFAULT '[]', -- JSON array of tags
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- FTS5 virtual table for full-text search with BM25 ranking
+CREATE VIRTUAL TABLE IF NOT EXISTS skills_fts USING fts5(
+  name,
+  description,
+  tags,
+  author,
+  content='skills',
+  content_rowid='rowid',
+  tokenize='porter unicode61'
+);
+
+-- Triggers to keep FTS index in sync with skills table
+CREATE TRIGGER IF NOT EXISTS skills_ai AFTER INSERT ON skills BEGIN
+  INSERT INTO skills_fts(rowid, name, description, tags, author)
+  VALUES (NEW.rowid, NEW.name, NEW.description, NEW.tags, NEW.author);
+END;
+
+CREATE TRIGGER IF NOT EXISTS skills_ad AFTER DELETE ON skills BEGIN
+  INSERT INTO skills_fts(skills_fts, rowid, name, description, tags, author)
+  VALUES ('delete', OLD.rowid, OLD.name, OLD.description, OLD.tags, OLD.author);
+END;
+
+CREATE TRIGGER IF NOT EXISTS skills_au AFTER UPDATE ON skills BEGIN
+  INSERT INTO skills_fts(skills_fts, rowid, name, description, tags, author)
+  VALUES ('delete', OLD.rowid, OLD.name, OLD.description, OLD.tags, OLD.author);
+  INSERT INTO skills_fts(rowid, name, description, tags, author)
+  VALUES (NEW.rowid, NEW.name, NEW.description, NEW.tags, NEW.author);
+END;
+
+-- Sources table - tracks where skills are discovered from
+CREATE TABLE IF NOT EXISTS sources (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  type TEXT NOT NULL CHECK(type IN ('github', 'gitlab', 'local', 'registry')),
+  url TEXT NOT NULL UNIQUE,
+  last_sync_at TEXT,
+  is_active INTEGER NOT NULL DEFAULT 1,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Categories table - hierarchical organization of skills
+CREATE TABLE IF NOT EXISTS categories (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL UNIQUE,
+  description TEXT,
+  parent_id TEXT REFERENCES categories(id) ON DELETE SET NULL,
+  skill_count INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Skill-Category junction table
+CREATE TABLE IF NOT EXISTS skill_categories (
+  skill_id TEXT NOT NULL REFERENCES skills(id) ON DELETE CASCADE,
+  category_id TEXT NOT NULL REFERENCES categories(id) ON DELETE CASCADE,
+  PRIMARY KEY (skill_id, category_id)
+);
+
+-- Cache table for search results and API responses
+CREATE TABLE IF NOT EXISTS cache (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL,
+  expires_at INTEGER, -- Unix timestamp, NULL for no expiry
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Indexes for common query patterns
+CREATE INDEX IF NOT EXISTS idx_skills_author ON skills(author);
+CREATE INDEX IF NOT EXISTS idx_skills_trust_tier ON skills(trust_tier);
+CREATE INDEX IF NOT EXISTS idx_skills_quality_score ON skills(quality_score);
+CREATE INDEX IF NOT EXISTS idx_skills_updated_at ON skills(updated_at);
+CREATE INDEX IF NOT EXISTS idx_skills_created_at ON skills(created_at);
+CREATE INDEX IF NOT EXISTS idx_sources_type ON sources(type);
+CREATE INDEX IF NOT EXISTS idx_sources_is_active ON sources(is_active);
+CREATE INDEX IF NOT EXISTS idx_categories_parent ON categories(parent_id);
+CREATE INDEX IF NOT EXISTS idx_cache_expires ON cache(expires_at);
+
+-- SMI-733: Audit logs table for security monitoring
+-- See: docs/security/index.md §3 Audit Logging
+CREATE TABLE IF NOT EXISTS audit_logs (
+  id TEXT PRIMARY KEY,
+  event_type TEXT NOT NULL,
+  timestamp TEXT NOT NULL DEFAULT (datetime('now')),
+  actor TEXT,
+  resource TEXT,
+  action TEXT,
+  result TEXT,
+  metadata TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_audit_event_type ON audit_logs(event_type);
+CREATE INDEX IF NOT EXISTS idx_audit_timestamp ON audit_logs(timestamp);
+CREATE INDEX IF NOT EXISTS idx_audit_resource ON audit_logs(resource);
+CREATE INDEX IF NOT EXISTS idx_audit_result ON audit_logs(result);
+CREATE INDEX IF NOT EXISTS idx_audit_actor ON audit_logs(actor);
+`;
+export const MIGRATIONS = [
+    {
+        version: 1,
+        description: 'Initial schema creation',
+        sql: SCHEMA_SQL,
+    },
+    {
+        version: 2,
+        description: 'SMI-974: Add missing columns for Phase 5 imported databases',
+        sql: `
+-- Add updated_at column if missing (for Phase 5 imported databases)
+ALTER TABLE skills ADD COLUMN updated_at TEXT NOT NULL DEFAULT (datetime('now'));
+
+-- Add source column if missing (from import scripts)
+ALTER TABLE skills ADD COLUMN source TEXT;
+
+-- Add stars column if missing (from import scripts)
+ALTER TABLE skills ADD COLUMN stars INTEGER;
+`,
+    },
+];
+/**
+ * SMI-974: Migration SQL for adding FTS5 to existing database
+ * Run separately as FTS5 creation can fail if table exists
+ */
+export const FTS5_MIGRATION_SQL = `
+-- Create FTS5 virtual table if not exists
+CREATE VIRTUAL TABLE IF NOT EXISTS skills_fts USING fts5(
+  name,
+  description,
+  tags,
+  author,
+  content='skills',
+  content_rowid='rowid',
+  tokenize='porter unicode61'
+);
+
+-- Populate FTS from existing skills (safe to run multiple times)
+INSERT OR IGNORE INTO skills_fts(rowid, name, description, tags, author)
+SELECT rowid, name, description, tags, author FROM skills;
+`;
+/**
+ * Initialize the database with the complete schema
+ */
+export function initializeSchema(db) {
+    db.exec(SCHEMA_SQL);
+    // Record the schema version
+    const stmt = db.prepare('INSERT OR REPLACE INTO schema_version (version) VALUES (?)');
+    stmt.run(SCHEMA_VERSION);
+}
+/**
+ * Get the current schema version from the database
+ */
+export function getSchemaVersion(db) {
+    try {
+        const result = db.prepare('SELECT MAX(version) as version FROM schema_version').get();
+        return result?.version ?? 0;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Run pending migrations to upgrade the schema
+ * Handles duplicate column errors gracefully since the initial schema
+ * already includes all columns, but migrations need to support databases
+ * created by other means (e.g., Phase 5 import scripts)
+ */
+export function runMigrations(db) {
+    const currentVersion = getSchemaVersion(db);
+    let migrationsRun = 0;
+    for (const migration of MIGRATIONS) {
+        if (migration.version > currentVersion) {
+            // Execute each statement separately to handle duplicate column errors
+            const statements = migration.sql.split(';').filter((s) => s.trim());
+            for (const stmt of statements) {
+                try {
+                    db.exec(stmt);
+                }
+                catch (error) {
+                    // Ignore "duplicate column" errors - column already exists from initial schema
+                    const msg = error instanceof Error ? error.message : String(error);
+                    if (!msg.includes('duplicate column')) {
+                        throw error;
+                    }
+                }
+            }
+            db.prepare('INSERT INTO schema_version (version) VALUES (?)').run(migration.version);
+            migrationsRun++;
+        }
+    }
+    return migrationsRun;
+}
+/**
+ * Create a new database connection with proper configuration
+ * This initializes the full schema - use openDatabase for existing databases
+ */
+export function createDatabase(path = ':memory:') {
+    const db = new Database(path);
+    // Enable foreign keys
+    db.pragma('foreign_keys = ON');
+    // Initialize schema
+    initializeSchema(db);
+    return db;
+}
+/**
+ * SMI-974: Open an existing database and run any pending migrations
+ * Use this for databases that may have been created by different versions
+ */
+export function openDatabase(path) {
+    const db = new Database(path);
+    // Enable foreign keys
+    db.pragma('foreign_keys = ON');
+    // Check if schema_version table exists
+    const hasSchemaVersion = db
+        .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='schema_version'")
+        .get();
+    if (!hasSchemaVersion) {
+        // Database has no version tracking - assume it's a Phase 5 import or similar
+        // Create schema_version table and set to version 1
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS schema_version (
+        version INTEGER PRIMARY KEY,
+        applied_at TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+      INSERT OR IGNORE INTO schema_version (version) VALUES (1);
+    `);
+    }
+    // Run pending migrations safely
+    runMigrationsSafe(db);
+    return db;
+}
+/**
+ * SMI-974: Run migrations with error handling for existing columns
+ */
+export function runMigrationsSafe(db) {
+    const currentVersion = getSchemaVersion(db);
+    let migrationsRun = 0;
+    for (const migration of MIGRATIONS) {
+        if (migration.version > currentVersion) {
+            try {
+                // Try to run migration, but handle "duplicate column" errors gracefully
+                const statements = migration.sql.split(';').filter((s) => s.trim());
+                for (const stmt of statements) {
+                    try {
+                        db.exec(stmt);
+                    }
+                    catch (error) {
+                        // Ignore "duplicate column" errors - column already exists
+                        const msg = error instanceof Error ? error.message : String(error);
+                        if (!msg.includes('duplicate column')) {
+                            throw error;
+                        }
+                    }
+                }
+                db.prepare('INSERT INTO schema_version (version) VALUES (?)').run(migration.version);
+                migrationsRun++;
+            }
+            catch (error) {
+                // Log but don't fail on migration errors
+                console.warn(`Migration ${migration.version} failed:`, error);
+            }
+        }
+    }
+    // Try to create FTS5 table (may already exist)
+    try {
+        db.exec(FTS5_MIGRATION_SQL);
+    }
+    catch {
+        // FTS5 may already exist or have issues - that's ok
+    }
+    return migrationsRun;
+}
+/**
+ * Close the database connection safely
+ */
+export function closeDatabase(db) {
+    db.close();
+}
+//# sourceMappingURL=schema.js.map

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

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

package/dist/src/embeddings/index.d.ts

@@ -0,0 +1,158 @@
+/**
+ * SMI-584: Semantic Embeddings Service
+ * SMI-754: Added fallback mode for deterministic mock embeddings
+ * SMI-1127: Lazy loading of @xenova/transformers to avoid CLI crashes from sharp
+ *
+ * Uses all-MiniLM-L6-v2 model for fast, accurate skill embeddings.
+ * Supports fallback mode for tests and when model unavailable.
+ *
+ * @see ADR-009: Embedding Service Fallback Strategy
+ */
+type FeatureExtractionPipeline = {
+    (text: string, options?: {
+        pooling?: string;
+        normalize?: boolean;
+    }): Promise<{
+        data: Float32Array;
+    }>;
+};
+export interface EmbeddingResult {
+    skillId: string;
+    embedding: Float32Array;
+    text: string;
+}
+export interface SimilarityResult {
+    skillId: string;
+    score: number;
+}
+/**
+ * Options for EmbeddingService initialization
+ */
+export interface EmbeddingServiceOptions {
+    /** Path to SQLite database for caching embeddings */
+    dbPath?: string;
+    /**
+     * Force fallback mode (deterministic mock embeddings).
+     * If not specified, checks SKILLSMITH_USE_MOCK_EMBEDDINGS env var,
+     * then falls back to real embeddings.
+     */
+    useFallback?: boolean;
+}
+/**
+ * Generate a deterministic hash from text for mock embeddings.
+ * Uses a simple but effective string hashing algorithm.
+ */
+declare function hashText(text: string): number;
+/**
+ * Generate deterministic mock embedding based on text content.
+ * Produces consistent vectors for the same input text.
+ */
+declare function generateMockEmbedding(text: string, dimension: number): Float32Array;
+export declare class EmbeddingService {
+    private model;
+    private modelPromise;
+    private modelLoadFailed;
+    private db;
+    private readonly modelName;
+    private readonly embeddingDim;
+    private readonly useFallback;
+    /**
+     * Create an EmbeddingService instance.
+     *
+     * @param optionsOrDbPath - Options object or legacy dbPath string
+     *
+     * @example
+     * // Real embeddings (default)
+     * const service = new EmbeddingService({ dbPath: './cache.db' });
+     *
+     * @example
+     * // Forced fallback mode for tests
+     * const service = new EmbeddingService({ useFallback: true });
+     *
+     * @example
+     * // Environment-controlled (set SKILLSMITH_USE_MOCK_EMBEDDINGS=true)
+     * const service = new EmbeddingService();
+     */
+    constructor(optionsOrDbPath?: string | EmbeddingServiceOptions);
+    /**
+     * Check if service is running in fallback (mock) mode
+     */
+    isUsingFallback(): boolean;
+    private initEmbeddingTable;
+    /**
+     * Check if the transformers module is available without loading it.
+     * This is a synchronous check that returns the current known state.
+     *
+     * @returns true if module is loaded, false if loading failed, undefined if not yet attempted
+     */
+    static isTransformersAvailable(): boolean | undefined;
+    /**
+     * Check if embeddings functionality is available.
+     * Attempts to load the transformers module if not yet loaded.
+     *
+     * @returns true if embeddings can be used, false otherwise
+     */
+    static checkAvailability(): Promise<boolean>;
+    /**
+     * Get the error that occurred when loading the transformers module, if any.
+     */
+    static getTransformersLoadError(): Error | null;
+    /**
+     * Lazily load the embedding model.
+     * Returns null if in fallback mode or if model loading fails.
+     */
+    loadModel(): Promise<FeatureExtractionPipeline | null>;
+    /**
+     * Generate embedding for a single text.
+     * Uses real ONNX model when available, falls back to deterministic mock otherwise.
+     */
+    embed(text: string): Promise<Float32Array>;
+    /**
+     * Batch embed multiple texts efficiently.
+     * In fallback mode, processes synchronously for speed.
+     */
+    embedBatch(texts: Array<{
+        id: string;
+        text: string;
+    }>): Promise<EmbeddingResult[]>;
+    /**
+     * Store embedding in SQLite cache
+     */
+    storeEmbedding(skillId: string, embedding: Float32Array, text: string): void;
+    /**
+     * Retrieve cached embedding
+     */
+    getEmbedding(skillId: string): Float32Array | null;
+    /**
+     * Get all cached embeddings
+     */
+    getAllEmbeddings(): Map<string, Float32Array>;
+    /**
+     * Compute cosine similarity between two embeddings
+     */
+    cosineSimilarity(a: Float32Array, b: Float32Array): number;
+    /**
+     * Find most similar skills to a query embedding
+     */
+    findSimilar(queryEmbedding: Float32Array, topK?: number): SimilarityResult[];
+    /**
+     * Pre-compute embeddings for all skills in database
+     */
+    precomputeEmbeddings(skills: Array<{
+        id: string;
+        name: string;
+        description: string;
+    }>): Promise<number>;
+    /**
+     * Close database connection
+     */
+    close(): void;
+}
+export declare const testUtils: {
+    /** Generate a deterministic mock embedding (for testing) */
+    generateMockEmbedding: typeof generateMockEmbedding;
+    /** Generate a hash from text (for testing) */
+    hashText: typeof hashText;
+};
+export default EmbeddingService;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/embeddings/index.d.ts.map

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