@skillsmith/core 0.1.0

package/dist/src/cache/lru.js

@@ -0,0 +1,105 @@
+/**
+ * SMI-585: L1 In-Memory LRU Cache
+ * Fast in-memory cache for frequently accessed search results
+ */
+import { LRUCache } from 'lru-cache';
+export class L1Cache {
+    cache;
+    hits = 0;
+    misses = 0;
+    constructor(maxSize = 100) {
+        this.cache = new LRUCache({
+            max: maxSize,
+            // Items expire after 5 minutes in L1
+            ttl: 5 * 60 * 1000,
+            updateAgeOnGet: true,
+        });
+    }
+    /**
+     * Generate cache key from query and filters
+     */
+    static generateKey(query, filters) {
+        // Normalize query: lowercase, trim, collapse whitespace
+        const normalizedQuery = query.toLowerCase().trim().replace(/\s+/g, ' ');
+        // Sort and stringify filters for consistent keys
+        const sortedFilters = filters
+            ? JSON.stringify(Object.keys(filters)
+                .sort()
+                .reduce((acc, key) => {
+                acc[key] = filters[key];
+                return acc;
+            }, {}))
+            : '';
+        return `search:${normalizedQuery}:${sortedFilters}`;
+    }
+    /**
+     * Get cached search results
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (entry) {
+            this.hits++;
+            return entry;
+        }
+        this.misses++;
+        return undefined;
+    }
+    /**
+     * Store search results in cache
+     */
+    set(key, results, totalCount) {
+        this.cache.set(key, {
+            results,
+            totalCount,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Check if key exists in cache
+     */
+    has(key) {
+        return this.cache.has(key);
+    }
+    /**
+     * Delete specific cache entry
+     */
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    /**
+     * Clear all cache entries
+     */
+    clear() {
+        this.cache.clear();
+        this.hits = 0;
+        this.misses = 0;
+    }
+    /**
+     * Invalidate all search-related entries
+     * Called when the skill index is updated
+     */
+    invalidateAll() {
+        this.clear();
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        const total = this.hits + this.misses;
+        return {
+            hits: this.hits,
+            misses: this.misses,
+            hitRate: total > 0 ? this.hits / total : 0,
+            size: this.cache.size,
+            maxSize: this.cache.max,
+        };
+    }
+    /**
+     * Prune expired entries
+     */
+    prune() {
+        this.cache.purgeStale();
+    }
+}
+export default L1Cache;
+//# sourceMappingURL=lru.js.map

package/dist/src/cache/lru.js.map

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

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

@@ -0,0 +1,59 @@
+/**
+ * SMI-585: L2 SQLite Persistent Cache
+ * Persistent cache layer with configurable TTL
+ */
+import type { SearchResult, SearchCacheEntry, CacheStats } from './lru.js';
+export interface L2CacheOptions {
+    dbPath: string;
+    ttlSeconds?: number;
+}
+export declare class L2Cache {
+    private db;
+    private readonly ttlSeconds;
+    private hits;
+    private misses;
+    private stmts;
+    constructor(options: L2CacheOptions);
+    private initTable;
+    private prepareStatements;
+    /**
+     * Get cached search results
+     */
+    get(key: string): SearchCacheEntry | undefined;
+    /**
+     * Store search results in cache
+     */
+    set(key: string, results: SearchResult[], totalCount: number): void;
+    /**
+     * Check if key exists and is not expired
+     */
+    has(key: string): boolean;
+    /**
+     * Delete specific cache entry
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear all cache entries
+     */
+    clear(): void;
+    /**
+     * Invalidate all entries (called when index updates)
+     */
+    invalidateAll(): void;
+    /**
+     * Remove expired entries
+     */
+    prune(): number;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats & {
+        expiredCount: number;
+    };
+    /**
+     * Close database connection
+     */
+    close(): void;
+}
+export default L2Cache;
+//# sourceMappingURL=sqlite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../../src/cache/sqlite.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAG1E,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,MAAM,CAAI;IAGlB,OAAO,CAAC,KAAK,CAOZ;gBAEW,OAAO,EAAE,cAAc;IAOnC,OAAO,CAAC,SAAS;IAiBjB,OAAO,CAAC,iBAAiB;IA+BzB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IA4B9C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAUnE;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAMzB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAK5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;OAEG;IACH,KAAK,IAAI,MAAM;IAMf;;OAEG;IACH,QAAQ,IAAI,UAAU,GAAG;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE;IAejD;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED,eAAe,OAAO,CAAA"}

package/dist/src/cache/sqlite.js

@@ -0,0 +1,159 @@
+/**
+ * SMI-585: L2 SQLite Persistent Cache
+ * Persistent cache layer with configurable TTL
+ */
+import Database from 'better-sqlite3';
+import { isValidCacheKey } from './CacheEntry.js';
+export class L2Cache {
+    db;
+    ttlSeconds;
+    hits = 0;
+    misses = 0;
+    // Prepared statements (created once, reused for performance)
+    stmts;
+    constructor(options) {
+        this.db = new Database(options.dbPath);
+        this.ttlSeconds = options.ttlSeconds ?? 3600; // 1 hour default
+        this.initTable();
+        this.stmts = this.prepareStatements();
+    }
+    initTable() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS search_cache (
+        cache_key TEXT PRIMARY KEY,
+        results_json TEXT NOT NULL,
+        total_count INTEGER NOT NULL,
+        created_at INTEGER NOT NULL,
+        expires_at INTEGER NOT NULL
+      )
+    `);
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_cache_expires
+      ON search_cache(expires_at)
+    `);
+    }
+    prepareStatements() {
+        return {
+            get: this.db.prepare(`
+        SELECT results_json, total_count, created_at
+        FROM search_cache
+        WHERE cache_key = ? AND expires_at > ?
+      `),
+            set: this.db.prepare(`
+        INSERT OR REPLACE INTO search_cache
+        (cache_key, results_json, total_count, created_at, expires_at)
+        VALUES (?, ?, ?, ?, ?)
+      `),
+            has: this.db.prepare(`
+        SELECT 1 FROM search_cache
+        WHERE cache_key = ? AND expires_at > ?
+      `),
+            delete: this.db.prepare(`
+        DELETE FROM search_cache WHERE cache_key = ?
+      `),
+            prune: this.db.prepare(`
+        DELETE FROM search_cache WHERE expires_at <= ?
+      `),
+            stats: this.db.prepare(`
+        SELECT
+          COUNT(*) as total,
+          SUM(CASE WHEN expires_at <= ? THEN 1 ELSE 0 END) as expired
+        FROM search_cache
+      `),
+        };
+    }
+    /**
+     * Get cached search results
+     */
+    get(key) {
+        if (!isValidCacheKey(key)) {
+            this.misses++;
+            return undefined;
+        }
+        const now = Math.floor(Date.now() / 1000);
+        const row = this.stmts.get.get(key, now);
+        if (row) {
+            this.hits++;
+            return {
+                results: JSON.parse(row.results_json),
+                totalCount: row.total_count,
+                timestamp: row.created_at * 1000,
+            };
+        }
+        this.misses++;
+        return undefined;
+    }
+    /**
+     * Store search results in cache
+     */
+    set(key, results, totalCount) {
+        if (!isValidCacheKey(key)) {
+            throw new Error('Invalid cache key');
+        }
+        const now = Math.floor(Date.now() / 1000);
+        const expiresAt = now + this.ttlSeconds;
+        this.stmts.set.run(key, JSON.stringify(results), totalCount, now, expiresAt);
+    }
+    /**
+     * Check if key exists and is not expired
+     */
+    has(key) {
+        if (!isValidCacheKey(key))
+            return false;
+        const now = Math.floor(Date.now() / 1000);
+        return this.stmts.has.get(key, now) !== undefined;
+    }
+    /**
+     * Delete specific cache entry
+     */
+    delete(key) {
+        const result = this.stmts.delete.run(key);
+        return result.changes > 0;
+    }
+    /**
+     * Clear all cache entries
+     */
+    clear() {
+        this.db.exec('DELETE FROM search_cache');
+        this.hits = 0;
+        this.misses = 0;
+    }
+    /**
+     * Invalidate all entries (called when index updates)
+     */
+    invalidateAll() {
+        this.clear();
+    }
+    /**
+     * Remove expired entries
+     */
+    prune() {
+        const now = Math.floor(Date.now() / 1000);
+        const result = this.stmts.prune.run(now);
+        return result.changes;
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        const total = this.hits + this.misses;
+        const now = Math.floor(Date.now() / 1000);
+        const counts = this.stmts.stats.get(now);
+        return {
+            hits: this.hits,
+            misses: this.misses,
+            hitRate: total > 0 ? this.hits / total : 0,
+            size: counts.total - (counts.expired ?? 0),
+            maxSize: -1, // -1 indicates no limit for L2
+            expiredCount: counts.expired ?? 0,
+        };
+    }
+    /**
+     * Close database connection
+     */
+    close() {
+        this.db.close();
+    }
+}
+export default L2Cache;
+//# sourceMappingURL=sqlite.js.map

package/dist/src/cache/sqlite.js.map

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

package/dist/src/db/quarantine-schema.d.ts

@@ -0,0 +1,81 @@
+/**
+ * SMI-865: Quarantine Management System Database Schema
+ *
+ * Provides database schema for skill quarantine management:
+ * - Quarantine table with severity levels and review status
+ * - Indexes for efficient querying
+ * - Migration support for existing databases
+ *
+ * Severity Categories:
+ * - MALICIOUS: Permanent quarantine, security threat detected
+ * - SUSPICIOUS: Manual review required before import
+ * - RISKY: Can import with warnings displayed
+ * - LOW_QUALITY: Can import with reduced quality score
+ */
+import type { Database as DatabaseType } from 'better-sqlite3';
+/**
+ * Severity levels for quarantined skills
+ */
+export type QuarantineSeverity = 'MALICIOUS' | 'SUSPICIOUS' | 'RISKY' | 'LOW_QUALITY';
+/**
+ * Review status for quarantined skills
+ */
+export type QuarantineReviewStatus = 'pending' | 'approved' | 'rejected';
+/**
+ * Quarantine severity descriptions and policies
+ */
+export declare const QUARANTINE_SEVERITY_POLICIES: {
+    readonly MALICIOUS: {
+        readonly level: 4;
+        readonly description: "Permanent quarantine - security threat detected";
+        readonly allowImport: false;
+        readonly requiresReview: true;
+        readonly autoReject: false;
+    };
+    readonly SUSPICIOUS: {
+        readonly level: 3;
+        readonly description: "Manual review required before import";
+        readonly allowImport: false;
+        readonly requiresReview: true;
+        readonly autoReject: false;
+    };
+    readonly RISKY: {
+        readonly level: 2;
+        readonly description: "Can import with warnings displayed";
+        readonly allowImport: true;
+        readonly requiresReview: false;
+        readonly autoReject: false;
+    };
+    readonly LOW_QUALITY: {
+        readonly level: 1;
+        readonly description: "Can import with reduced quality score";
+        readonly allowImport: true;
+        readonly requiresReview: false;
+        readonly autoReject: false;
+    };
+};
+/**
+ * SQL statement to create the quarantine table
+ */
+export declare const QUARANTINE_SCHEMA_SQL = "\n-- SMI-865: Quarantine table for skill security management\nCREATE TABLE IF NOT EXISTS quarantine (\n  id TEXT PRIMARY KEY,\n  skill_id TEXT NOT NULL,\n  source TEXT NOT NULL,\n  quarantine_reason TEXT NOT NULL,\n  severity TEXT NOT NULL CHECK(severity IN ('MALICIOUS', 'SUSPICIOUS', 'RISKY', 'LOW_QUALITY')),\n  detected_patterns TEXT DEFAULT '[]', -- JSON array of detected security patterns\n  quarantine_date TEXT NOT NULL DEFAULT (datetime('now')),\n  reviewed_by TEXT,\n  review_status TEXT NOT NULL CHECK(review_status IN ('pending', 'approved', 'rejected')) DEFAULT 'pending',\n  review_notes TEXT,\n  review_date TEXT,\n  created_at TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Indexes for efficient querying\nCREATE INDEX IF NOT EXISTS idx_quarantine_skill_id ON quarantine(skill_id);\nCREATE INDEX IF NOT EXISTS idx_quarantine_severity ON quarantine(severity);\nCREATE INDEX IF NOT EXISTS idx_quarantine_review_status ON quarantine(review_status);\nCREATE INDEX IF NOT EXISTS idx_quarantine_source ON quarantine(source);\nCREATE INDEX IF NOT EXISTS idx_quarantine_date ON quarantine(quarantine_date);\nCREATE INDEX IF NOT EXISTS idx_quarantine_reviewed_by ON quarantine(reviewed_by);\n";
+/**
+ * Initialize the quarantine schema in the database
+ *
+ * @param db - Database connection
+ */
+export declare function initializeQuarantineSchema(db: DatabaseType): void;
+/**
+ * Check if the quarantine table exists
+ *
+ * @param db - Database connection
+ * @returns True if quarantine table exists
+ */
+export declare function hasQuarantineTable(db: DatabaseType): boolean;
+/**
+ * Run quarantine schema migration if needed
+ *
+ * @param db - Database connection
+ * @returns True if migration was run
+ */
+export declare function migrateQuarantineSchema(db: DatabaseType): boolean;
+//# sourceMappingURL=quarantine-schema.d.ts.map

package/dist/src/db/quarantine-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quarantine-schema.d.ts","sourceRoot":"","sources":["../../../src/db/quarantine-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE9D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,YAAY,GAAG,OAAO,GAAG,aAAa,CAAA;AAErF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAA;AAExE;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6B/B,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,qBAAqB,+uCAyBjC,CAAA;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAK5D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAMjE"}

package/dist/src/db/quarantine-schema.js

@@ -0,0 +1,110 @@
+/**
+ * SMI-865: Quarantine Management System Database Schema
+ *
+ * Provides database schema for skill quarantine management:
+ * - Quarantine table with severity levels and review status
+ * - Indexes for efficient querying
+ * - Migration support for existing databases
+ *
+ * Severity Categories:
+ * - MALICIOUS: Permanent quarantine, security threat detected
+ * - SUSPICIOUS: Manual review required before import
+ * - RISKY: Can import with warnings displayed
+ * - LOW_QUALITY: Can import with reduced quality score
+ */
+/**
+ * Quarantine severity descriptions and policies
+ */
+export const QUARANTINE_SEVERITY_POLICIES = {
+    MALICIOUS: {
+        level: 4,
+        description: 'Permanent quarantine - security threat detected',
+        allowImport: false,
+        requiresReview: true,
+        autoReject: false,
+    },
+    SUSPICIOUS: {
+        level: 3,
+        description: 'Manual review required before import',
+        allowImport: false,
+        requiresReview: true,
+        autoReject: false,
+    },
+    RISKY: {
+        level: 2,
+        description: 'Can import with warnings displayed',
+        allowImport: true,
+        requiresReview: false,
+        autoReject: false,
+    },
+    LOW_QUALITY: {
+        level: 1,
+        description: 'Can import with reduced quality score',
+        allowImport: true,
+        requiresReview: false,
+        autoReject: false,
+    },
+};
+/**
+ * SQL statement to create the quarantine table
+ */
+export const QUARANTINE_SCHEMA_SQL = `
+-- SMI-865: Quarantine table for skill security management
+CREATE TABLE IF NOT EXISTS quarantine (
+  id TEXT PRIMARY KEY,
+  skill_id TEXT NOT NULL,
+  source TEXT NOT NULL,
+  quarantine_reason TEXT NOT NULL,
+  severity TEXT NOT NULL CHECK(severity IN ('MALICIOUS', 'SUSPICIOUS', 'RISKY', 'LOW_QUALITY')),
+  detected_patterns TEXT DEFAULT '[]', -- JSON array of detected security patterns
+  quarantine_date TEXT NOT NULL DEFAULT (datetime('now')),
+  reviewed_by TEXT,
+  review_status TEXT NOT NULL CHECK(review_status IN ('pending', 'approved', 'rejected')) DEFAULT 'pending',
+  review_notes TEXT,
+  review_date TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Indexes for efficient querying
+CREATE INDEX IF NOT EXISTS idx_quarantine_skill_id ON quarantine(skill_id);
+CREATE INDEX IF NOT EXISTS idx_quarantine_severity ON quarantine(severity);
+CREATE INDEX IF NOT EXISTS idx_quarantine_review_status ON quarantine(review_status);
+CREATE INDEX IF NOT EXISTS idx_quarantine_source ON quarantine(source);
+CREATE INDEX IF NOT EXISTS idx_quarantine_date ON quarantine(quarantine_date);
+CREATE INDEX IF NOT EXISTS idx_quarantine_reviewed_by ON quarantine(reviewed_by);
+`;
+/**
+ * Initialize the quarantine schema in the database
+ *
+ * @param db - Database connection
+ */
+export function initializeQuarantineSchema(db) {
+    db.exec(QUARANTINE_SCHEMA_SQL);
+}
+/**
+ * Check if the quarantine table exists
+ *
+ * @param db - Database connection
+ * @returns True if quarantine table exists
+ */
+export function hasQuarantineTable(db) {
+    const result = db
+        .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='quarantine'")
+        .get();
+    return !!result;
+}
+/**
+ * Run quarantine schema migration if needed
+ *
+ * @param db - Database connection
+ * @returns True if migration was run
+ */
+export function migrateQuarantineSchema(db) {
+    if (!hasQuarantineTable(db)) {
+        initializeQuarantineSchema(db);
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=quarantine-schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quarantine-schema.js","sourceRoot":"","sources":["../../../src/db/quarantine-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAcH;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,SAAS,EAAE;QACT,KAAK,EAAE,CAAC;QACR,WAAW,EAAE,iDAAiD;QAC9D,WAAW,EAAE,KAAK;QAClB,cAAc,EAAE,IAAI;QACpB,UAAU,EAAE,KAAK;KAClB;IACD,UAAU,EAAE;QACV,KAAK,EAAE,CAAC;QACR,WAAW,EAAE,sCAAsC;QACnD,WAAW,EAAE,KAAK;QAClB,cAAc,EAAE,IAAI;QACpB,UAAU,EAAE,KAAK;KAClB;IACD,KAAK,EAAE;QACL,KAAK,EAAE,CAAC;QACR,WAAW,EAAE,oCAAoC;QACjD,WAAW,EAAE,IAAI;QACjB,cAAc,EAAE,KAAK;QACrB,UAAU,EAAE,KAAK;KAClB;IACD,WAAW,EAAE;QACX,KAAK,EAAE,CAAC;QACR,WAAW,EAAE,uCAAuC;QACpD,WAAW,EAAE,IAAI;QACjB,cAAc,EAAE,KAAK;QACrB,UAAU,EAAE,KAAK;KAClB;CACO,CAAA;AAEV;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;CAyBpC,CAAA;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,EAAgB;IACzD,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAA;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAgB;IACjD,MAAM,MAAM,GAAG,EAAE;SACd,OAAO,CAAC,yEAAyE,CAAC;SAClF,GAAG,EAAE,CAAA;IACR,OAAO,CAAC,CAAC,MAAM,CAAA;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,EAAgB;IACtD,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5B,0BAA0B,CAAC,EAAE,CAAC,CAAA;QAC9B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

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

@@ -0,0 +1,65 @@
+/**
+ * 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 type { Database as BetterSqliteDatabase } from 'better-sqlite3';
+export type DatabaseType = BetterSqliteDatabase;
+export declare const SCHEMA_VERSION = 2;
+/**
+ * SQL statements for creating the database schema
+ */
+export declare const SCHEMA_SQL = "\n-- Enable WAL mode for better concurrent performance\nPRAGMA journal_mode = WAL;\nPRAGMA synchronous = NORMAL;\nPRAGMA cache_size = -64000; -- 64MB cache\nPRAGMA temp_store = MEMORY;\n\n-- Schema version tracking\nCREATE TABLE IF NOT EXISTS schema_version (\n  version INTEGER PRIMARY KEY,\n  applied_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Skills table - main storage for discovered skills\nCREATE TABLE IF NOT EXISTS skills (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL,\n  description TEXT,\n  author TEXT,\n  repo_url TEXT UNIQUE,\n  quality_score REAL CHECK(quality_score IS NULL OR (quality_score >= 0 AND quality_score <= 1)),\n  trust_tier TEXT CHECK(trust_tier IN ('verified', 'community', 'experimental', 'unknown')) DEFAULT 'unknown',\n  tags TEXT DEFAULT '[]', -- JSON array of tags\n  created_at TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- FTS5 virtual table for full-text search with BM25 ranking\nCREATE VIRTUAL TABLE IF NOT EXISTS skills_fts USING fts5(\n  name,\n  description,\n  tags,\n  author,\n  content='skills',\n  content_rowid='rowid',\n  tokenize='porter unicode61'\n);\n\n-- Triggers to keep FTS index in sync with skills table\nCREATE TRIGGER IF NOT EXISTS skills_ai AFTER INSERT ON skills BEGIN\n  INSERT INTO skills_fts(rowid, name, description, tags, author)\n  VALUES (NEW.rowid, NEW.name, NEW.description, NEW.tags, NEW.author);\nEND;\n\nCREATE TRIGGER IF NOT EXISTS skills_ad AFTER DELETE ON skills BEGIN\n  INSERT INTO skills_fts(skills_fts, rowid, name, description, tags, author)\n  VALUES ('delete', OLD.rowid, OLD.name, OLD.description, OLD.tags, OLD.author);\nEND;\n\nCREATE TRIGGER IF NOT EXISTS skills_au AFTER UPDATE ON skills BEGIN\n  INSERT INTO skills_fts(skills_fts, rowid, name, description, tags, author)\n  VALUES ('delete', OLD.rowid, OLD.name, OLD.description, OLD.tags, OLD.author);\n  INSERT INTO skills_fts(rowid, name, description, tags, author)\n  VALUES (NEW.rowid, NEW.name, NEW.description, NEW.tags, NEW.author);\nEND;\n\n-- Sources table - tracks where skills are discovered from\nCREATE TABLE IF NOT EXISTS sources (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL,\n  type TEXT NOT NULL CHECK(type IN ('github', 'gitlab', 'local', 'registry')),\n  url TEXT NOT NULL UNIQUE,\n  last_sync_at TEXT,\n  is_active INTEGER NOT NULL DEFAULT 1,\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Categories table - hierarchical organization of skills\nCREATE TABLE IF NOT EXISTS categories (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL UNIQUE,\n  description TEXT,\n  parent_id TEXT REFERENCES categories(id) ON DELETE SET NULL,\n  skill_count INTEGER NOT NULL DEFAULT 0,\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Skill-Category junction table\nCREATE TABLE IF NOT EXISTS skill_categories (\n  skill_id TEXT NOT NULL REFERENCES skills(id) ON DELETE CASCADE,\n  category_id TEXT NOT NULL REFERENCES categories(id) ON DELETE CASCADE,\n  PRIMARY KEY (skill_id, category_id)\n);\n\n-- Cache table for search results and API responses\nCREATE TABLE IF NOT EXISTS cache (\n  key TEXT PRIMARY KEY,\n  value TEXT NOT NULL,\n  expires_at INTEGER, -- Unix timestamp, NULL for no expiry\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Indexes for common query patterns\nCREATE INDEX IF NOT EXISTS idx_skills_author ON skills(author);\nCREATE INDEX IF NOT EXISTS idx_skills_trust_tier ON skills(trust_tier);\nCREATE INDEX IF NOT EXISTS idx_skills_quality_score ON skills(quality_score);\nCREATE INDEX IF NOT EXISTS idx_skills_updated_at ON skills(updated_at);\nCREATE INDEX IF NOT EXISTS idx_skills_created_at ON skills(created_at);\nCREATE INDEX IF NOT EXISTS idx_sources_type ON sources(type);\nCREATE INDEX IF NOT EXISTS idx_sources_is_active ON sources(is_active);\nCREATE INDEX IF NOT EXISTS idx_categories_parent ON categories(parent_id);\nCREATE INDEX IF NOT EXISTS idx_cache_expires ON cache(expires_at);\n\n-- SMI-733: Audit logs table for security monitoring\n-- See: docs/security/index.md \u00A73 Audit Logging\nCREATE TABLE IF NOT EXISTS audit_logs (\n  id TEXT PRIMARY KEY,\n  event_type TEXT NOT NULL,\n  timestamp TEXT NOT NULL DEFAULT (datetime('now')),\n  actor TEXT,\n  resource TEXT,\n  action TEXT,\n  result TEXT,\n  metadata TEXT,\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE INDEX IF NOT EXISTS idx_audit_event_type ON audit_logs(event_type);\nCREATE INDEX IF NOT EXISTS idx_audit_timestamp ON audit_logs(timestamp);\nCREATE INDEX IF NOT EXISTS idx_audit_resource ON audit_logs(resource);\nCREATE INDEX IF NOT EXISTS idx_audit_result ON audit_logs(result);\nCREATE INDEX IF NOT EXISTS idx_audit_actor ON audit_logs(actor);\n";
+/**
+ * Migration definitions for schema upgrades
+ */
+export interface Migration {
+    version: number;
+    description: string;
+    sql: string;
+}
+export declare const MIGRATIONS: Migration[];
+/**
+ * SMI-974: Migration SQL for adding FTS5 to existing database
+ * Run separately as FTS5 creation can fail if table exists
+ */
+export declare const FTS5_MIGRATION_SQL = "\n-- Create FTS5 virtual table if not exists\nCREATE VIRTUAL TABLE IF NOT EXISTS skills_fts USING fts5(\n  name,\n  description,\n  tags,\n  author,\n  content='skills',\n  content_rowid='rowid',\n  tokenize='porter unicode61'\n);\n\n-- Populate FTS from existing skills (safe to run multiple times)\nINSERT OR IGNORE INTO skills_fts(rowid, name, description, tags, author)\nSELECT rowid, name, description, tags, author FROM skills;\n";
+/**
+ * Initialize the database with the complete schema
+ */
+export declare function initializeSchema(db: DatabaseType): void;
+/**
+ * Get the current schema version from the database
+ */
+export declare function getSchemaVersion(db: DatabaseType): number;
+/**
+ * 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 declare function runMigrations(db: DatabaseType): number;
+/**
+ * Create a new database connection with proper configuration
+ * This initializes the full schema - use openDatabase for existing databases
+ */
+export declare function createDatabase(path?: string): DatabaseType;
+/**
+ * SMI-974: Open an existing database and run any pending migrations
+ * Use this for databases that may have been created by different versions
+ */
+export declare function openDatabase(path: string): DatabaseType;
+/**
+ * SMI-974: Run migrations with error handling for existing columns
+ */
+export declare function runMigrationsSafe(db: DatabaseType): number;
+/**
+ * Close the database connection safely
+ */
+export declare function closeDatabase(db: DatabaseType): void;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/db/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAEtE,MAAM,MAAM,YAAY,GAAG,oBAAoB,CAAA;AAE/C,eAAO,MAAM,cAAc,IAAI,CAAA;AAE/B;;GAEG;AACH,eAAO,MAAM,UAAU,8oJA0HtB,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,eAAO,MAAM,UAAU,EAAE,SAAS,EAoBjC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,wbAe9B,CAAA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAMvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,GAAG,MAAM,CASzD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,MAAM,CAyBtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,MAAmB,GAAG,YAAY,CAUtE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CA2BvD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY,GAAG,MAAM,CAqC1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAEpD"}