@skillsmith/core 0.1.0

package/dist/src/repositories/IndexerRepository.d.ts

@@ -0,0 +1,126 @@
+/**
+ * SMI-628: IndexerRepository - Database operations for skill indexing
+ *
+ * Provides:
+ * - Upsert skills with conflict resolution on repo_url
+ * - Track last_indexed_at for incremental updates
+ * - Store raw SKILL.md content for re-parsing
+ * - Batch operations for efficient bulk indexing
+ */
+import type { Database as DatabaseType } from 'better-sqlite3';
+import type { Skill, TrustTier } from '../types/skill.js';
+import type { SkillMetadata } from '../indexer/GitHubIndexer.js';
+/**
+ * Extended skill with indexing metadata
+ */
+export interface IndexedSkill extends Skill {
+    /**
+     * When the skill was last indexed from source
+     */
+    lastIndexedAt: string;
+    /**
+     * SHA of the source file for change detection
+     */
+    sourceSha: string | null;
+    /**
+     * Path to the source file in the repository
+     */
+    sourceFilePath: string | null;
+    /**
+     * Raw content of the SKILL.md file
+     */
+    rawContent: string | null;
+}
+/**
+ * Upsert result
+ */
+export interface UpsertResult {
+    /**
+     * Whether this was an insert (true) or update (false)
+     */
+    inserted: boolean;
+    /**
+     * The resulting skill
+     */
+    skill: IndexedSkill;
+    /**
+     * Whether the content changed (for updates)
+     */
+    contentChanged: boolean;
+}
+/**
+ * Batch upsert result
+ */
+export interface BatchUpsertResult {
+    /**
+     * Total skills processed
+     */
+    total: number;
+    /**
+     * Number of new skills inserted
+     */
+    inserted: number;
+    /**
+     * Number of existing skills updated
+     */
+    updated: number;
+    /**
+     * Number of skills unchanged (same SHA)
+     */
+    unchanged: number;
+    /**
+     * Any errors that occurred
+     */
+    errors: Array<{
+        repoUrl: string;
+        error: string;
+    }>;
+}
+/**
+ * Repository for indexer-specific database operations
+ */
+export declare class IndexerRepository {
+    private db;
+    private migrationApplied;
+    constructor(db: DatabaseType);
+    private stmts;
+    /**
+     * Ensure the indexer columns exist
+     */
+    private ensureMigration;
+    private prepareStatements;
+    /**
+     * Convert a database row to an IndexedSkill object
+     */
+    private rowToSkill;
+    /**
+     * Upsert a skill from indexer metadata
+     */
+    upsertFromMetadata(metadata: SkillMetadata, trustTier?: TrustTier): UpsertResult;
+    /**
+     * Batch upsert skills from indexer metadata
+     */
+    batchUpsertFromMetadata(metadataList: SkillMetadata[]): BatchUpsertResult;
+    /**
+     * Find skills that need reindexing
+     */
+    findNeedingReindex(olderThan?: string, limit?: number): IndexedSkill[];
+    /**
+     * Find skill by repository URL
+     */
+    findByRepoUrl(repoUrl: string): IndexedSkill | null;
+    /**
+     * Find skill by source SHA
+     */
+    findBySha(sha: string): IndexedSkill | null;
+    /**
+     * Get all indexed skills with pagination
+     */
+    findAllIndexed(limit?: number, offset?: number): IndexedSkill[];
+    /**
+     * Calculate quality score from metadata
+     */
+    private calculateQualityScore;
+}
+export default IndexerRepository;
+//# sourceMappingURL=IndexerRepository.d.ts.map

package/dist/src/repositories/IndexerRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexerRepository.d.ts","sourceRoot":"","sources":["../../../src/repositories/IndexerRepository.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAa,MAAM,gBAAgB,CAAA;AAEzE,OAAO,KAAK,EAAE,KAAK,EAAoB,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAEhE;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,KAAK;IACzC;;OAEG;IACH,aAAa,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAExB;;OAEG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAE7B;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAA;IAEjB;;OAEG;IACH,KAAK,EAAE,YAAY,CAAA;IAEnB;;OAEG;IACH,cAAc,EAAE,OAAO,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IAEf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAClD;AAmBD;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,gBAAgB,CAAQ;gBAEpB,EAAE,EAAE,YAAY;IAM5B,OAAO,CAAC,KAAK,CAQZ;IAED;;OAEG;IACH,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,iBAAiB;IA2DzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAmBlB;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,YAAY;IAgEhF;;OAEG;IACH,uBAAuB,CAAC,YAAY,EAAE,aAAa,EAAE,GAAG,iBAAiB;IAkCzE;;OAEG;IACH,kBAAkB,CAAC,SAAS,GAAE,MAAkB,EAAE,KAAK,SAAM,GAAG,YAAY,EAAE;IAK9E;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAKnD;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAK3C;;OAEG;IACH,cAAc,CAAC,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,YAAY,EAAE;IAKtD;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAuC9B;AAED,eAAe,iBAAiB,CAAA"}

package/dist/src/repositories/IndexerRepository.js

@@ -0,0 +1,270 @@
+/**
+ * SMI-628: IndexerRepository - Database operations for skill indexing
+ *
+ * Provides:
+ * - Upsert skills with conflict resolution on repo_url
+ * - Track last_indexed_at for incremental updates
+ * - Store raw SKILL.md content for re-parsing
+ * - Batch operations for efficient bulk indexing
+ */
+import { randomUUID } from 'crypto';
+/**
+ * Repository for indexer-specific database operations
+ */
+export class IndexerRepository {
+    db;
+    migrationApplied = false;
+    constructor(db) {
+        this.db = db;
+        this.ensureMigration();
+        this.prepareStatements();
+    }
+    stmts;
+    /**
+     * Ensure the indexer columns exist
+     */
+    ensureMigration() {
+        if (this.migrationApplied)
+            return;
+        // Check if columns exist
+        const columns = this.db.pragma('table_info(skills)');
+        const columnNames = columns.map((c) => c.name);
+        // Add missing columns
+        if (!columnNames.includes('last_indexed_at')) {
+            this.db.exec('ALTER TABLE skills ADD COLUMN last_indexed_at TEXT');
+        }
+        if (!columnNames.includes('source_sha')) {
+            this.db.exec('ALTER TABLE skills ADD COLUMN source_sha TEXT');
+        }
+        if (!columnNames.includes('source_file_path')) {
+            this.db.exec('ALTER TABLE skills ADD COLUMN source_file_path TEXT');
+        }
+        if (!columnNames.includes('raw_content')) {
+            this.db.exec('ALTER TABLE skills ADD COLUMN raw_content TEXT');
+        }
+        // Add index for faster lookups
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_skills_last_indexed ON skills(last_indexed_at);
+      CREATE INDEX IF NOT EXISTS idx_skills_source_sha ON skills(source_sha);
+    `);
+        this.migrationApplied = true;
+    }
+    prepareStatements() {
+        this.stmts = {
+            selectByRepoUrl: this.db.prepare(`
+        SELECT * FROM skills WHERE repo_url = ?
+      `),
+            selectBySha: this.db.prepare(`
+        SELECT * FROM skills WHERE source_sha = ?
+      `),
+            insertIndexed: this.db.prepare(`
+        INSERT INTO skills (
+          id, name, description, author, repo_url, quality_score,
+          trust_tier, tags, created_at, updated_at,
+          last_indexed_at, source_sha, source_file_path, raw_content
+        ) VALUES (
+          ?, ?, ?, ?, ?, ?,
+          ?, ?, datetime('now'), datetime('now'),
+          datetime('now'), ?, ?, ?
+        )
+      `),
+            updateIndexed: this.db.prepare(`
+        UPDATE skills SET
+          name = ?,
+          description = ?,
+          author = ?,
+          quality_score = ?,
+          trust_tier = ?,
+          tags = ?,
+          updated_at = datetime('now'),
+          last_indexed_at = datetime('now'),
+          source_sha = ?,
+          source_file_path = ?,
+          raw_content = ?
+        WHERE repo_url = ?
+      `),
+            selectNeedingReindex: this.db.prepare(`
+        SELECT * FROM skills
+        WHERE last_indexed_at IS NULL
+           OR last_indexed_at < datetime('now', ?)
+        ORDER BY last_indexed_at ASC NULLS FIRST
+        LIMIT ?
+      `),
+            selectAll: this.db.prepare(`
+        SELECT * FROM skills
+        WHERE last_indexed_at IS NOT NULL
+        ORDER BY last_indexed_at DESC
+        LIMIT ? OFFSET ?
+      `),
+            updateLastIndexed: this.db.prepare(`
+        UPDATE skills SET last_indexed_at = datetime('now') WHERE id = ?
+      `),
+        };
+    }
+    /**
+     * Convert a database row to an IndexedSkill object
+     */
+    rowToSkill(row) {
+        return {
+            id: row.id,
+            name: row.name,
+            description: row.description,
+            author: row.author,
+            repoUrl: row.repo_url,
+            qualityScore: row.quality_score,
+            trustTier: row.trust_tier,
+            tags: JSON.parse(row.tags || '[]'),
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+            lastIndexedAt: row.last_indexed_at ?? row.updated_at,
+            sourceSha: row.source_sha,
+            sourceFilePath: row.source_file_path,
+            rawContent: row.raw_content,
+        };
+    }
+    /**
+     * Upsert a skill from indexer metadata
+     */
+    upsertFromMetadata(metadata, trustTier) {
+        const existing = this.stmts.selectByRepoUrl.get(metadata.repoUrl);
+        if (existing) {
+            // Check if content changed
+            if (existing.source_sha === metadata.sha) {
+                // Just update the timestamp
+                this.stmts.updateLastIndexed.run(existing.id);
+                return {
+                    inserted: false,
+                    skill: this.rowToSkill({ ...existing, last_indexed_at: new Date().toISOString() }),
+                    contentChanged: false,
+                };
+            }
+            // Update with new content
+            const tags = JSON.stringify(metadata.tags);
+            this.stmts.updateIndexed.run(metadata.name, metadata.description, metadata.author ?? metadata.owner, this.calculateQualityScore(metadata), trustTier ?? 'unknown', tags, metadata.sha, metadata.filePath, metadata.rawContent, metadata.repoUrl);
+            const updated = this.stmts.selectByRepoUrl.get(metadata.repoUrl);
+            return {
+                inserted: false,
+                skill: this.rowToSkill(updated),
+                contentChanged: true,
+            };
+        }
+        // Insert new skill
+        const id = randomUUID();
+        const tags = JSON.stringify(metadata.tags);
+        this.stmts.insertIndexed.run(id, metadata.name, metadata.description, metadata.author ?? metadata.owner, metadata.repoUrl, this.calculateQualityScore(metadata), trustTier ?? 'unknown', tags, metadata.sha, metadata.filePath, metadata.rawContent);
+        const inserted = this.stmts.selectByRepoUrl.get(metadata.repoUrl);
+        return {
+            inserted: true,
+            skill: this.rowToSkill(inserted),
+            contentChanged: true,
+        };
+    }
+    /**
+     * Batch upsert skills from indexer metadata
+     */
+    batchUpsertFromMetadata(metadataList) {
+        const result = {
+            total: metadataList.length,
+            inserted: 0,
+            updated: 0,
+            unchanged: 0,
+            errors: [],
+        };
+        const transaction = this.db.transaction((items) => {
+            for (const metadata of items) {
+                try {
+                    const upsertResult = this.upsertFromMetadata(metadata);
+                    if (upsertResult.inserted) {
+                        result.inserted++;
+                    }
+                    else if (upsertResult.contentChanged) {
+                        result.updated++;
+                    }
+                    else {
+                        result.unchanged++;
+                    }
+                }
+                catch (error) {
+                    result.errors.push({
+                        repoUrl: metadata.repoUrl,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                }
+            }
+        });
+        transaction(metadataList);
+        return result;
+    }
+    /**
+     * Find skills that need reindexing
+     */
+    findNeedingReindex(olderThan = '-7 days', limit = 100) {
+        const rows = this.stmts.selectNeedingReindex.all(olderThan, limit);
+        return rows.map((row) => this.rowToSkill(row));
+    }
+    /**
+     * Find skill by repository URL
+     */
+    findByRepoUrl(repoUrl) {
+        const row = this.stmts.selectByRepoUrl.get(repoUrl);
+        return row ? this.rowToSkill(row) : null;
+    }
+    /**
+     * Find skill by source SHA
+     */
+    findBySha(sha) {
+        const row = this.stmts.selectBySha.get(sha);
+        return row ? this.rowToSkill(row) : null;
+    }
+    /**
+     * Get all indexed skills with pagination
+     */
+    findAllIndexed(limit = 20, offset = 0) {
+        const rows = this.stmts.selectAll.all(limit, offset);
+        return rows.map((row) => this.rowToSkill(row));
+    }
+    /**
+     * Calculate quality score from metadata
+     */
+    calculateQualityScore(metadata) {
+        let score = 0;
+        // Has description (20 points)
+        if (metadata.description && metadata.description.length > 0) {
+            score += 10;
+            if (metadata.description.length > 100)
+                score += 10;
+        }
+        // Has tags (15 points)
+        if (metadata.tags.length > 0) {
+            score += 5;
+            if (metadata.tags.length >= 3)
+                score += 5;
+            if (metadata.tags.length >= 5)
+                score += 5;
+        }
+        // Has version (10 points)
+        if (metadata.version)
+            score += 10;
+        // Has author (10 points)
+        if (metadata.author)
+            score += 10;
+        // Has license (10 points)
+        if (metadata.license)
+            score += 10;
+        // Has dependencies (10 points)
+        if (metadata.dependencies.length > 0)
+            score += 10;
+        // Has category (10 points)
+        if (metadata.category)
+            score += 10;
+        // Has documentation (15 points)
+        if (metadata.rawContent.length > 500) {
+            score += 10;
+            if (metadata.rawContent.length > 1000)
+                score += 5;
+        }
+        return Math.min(score, 100) / 100;
+    }
+}
+export default IndexerRepository;
+//# sourceMappingURL=IndexerRepository.js.map

package/dist/src/repositories/IndexerRepository.js.map

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

package/dist/src/repositories/QuarantineRepository.d.ts

@@ -0,0 +1,255 @@
+/**
+ * SMI-865: Quarantine Repository - CRUD operations for skill quarantine management
+ *
+ * Provides:
+ * - Create, Read, Update, Delete operations for quarantine entries
+ * - Review workflow management
+ * - Integration with AuditLogger for audit trail
+ * - Query filtering and pagination
+ *
+ * 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';
+import type { QuarantineSeverity, QuarantineReviewStatus } from '../db/quarantine-schema.js';
+import type { AuditLogger } from '../security/AuditLogger.js';
+/**
+ * Quarantine entry structure
+ */
+export interface QuarantineEntry {
+    id: string;
+    skillId: string;
+    source: string;
+    quarantineReason: string;
+    severity: QuarantineSeverity;
+    detectedPatterns: string[];
+    quarantineDate: string;
+    reviewedBy: string | null;
+    reviewStatus: QuarantineReviewStatus;
+    reviewNotes: string | null;
+    reviewDate: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Input for creating a quarantine entry
+ */
+export interface QuarantineCreateInput {
+    id?: string;
+    skillId: string;
+    source: string;
+    quarantineReason: string;
+    severity: QuarantineSeverity;
+    detectedPatterns?: string[];
+}
+/**
+ * Input for updating a quarantine entry
+ */
+export interface QuarantineUpdateInput {
+    quarantineReason?: string;
+    severity?: QuarantineSeverity;
+    detectedPatterns?: string[];
+    reviewedBy?: string;
+    reviewStatus?: QuarantineReviewStatus;
+    reviewNotes?: string;
+}
+/**
+ * Query filters for quarantine entries
+ */
+export interface QuarantineQueryFilter {
+    skillId?: string;
+    source?: string;
+    severity?: QuarantineSeverity;
+    reviewStatus?: QuarantineReviewStatus;
+    reviewedBy?: string;
+    since?: Date;
+    until?: Date;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Paginated results for quarantine queries
+ */
+export interface PaginatedQuarantineResults {
+    items: QuarantineEntry[];
+    total: number;
+    limit: number;
+    offset: number;
+    hasMore: boolean;
+}
+/**
+ * Quarantine statistics
+ */
+export interface QuarantineStats {
+    total: number;
+    bySeverity: Record<QuarantineSeverity, number>;
+    byStatus: Record<QuarantineReviewStatus, number>;
+    pendingReview: number;
+    oldestEntry: string | null;
+    newestEntry: string | null;
+}
+/**
+ * Review decision result
+ */
+export interface ReviewDecision {
+    approved: boolean;
+    skillId: string;
+    severity: QuarantineSeverity;
+    canImport: boolean;
+    warnings: string[];
+}
+/**
+ * Repository for quarantine CRUD operations
+ *
+ * @example
+ * ```typescript
+ * const repo = new QuarantineRepository(db, auditLogger)
+ *
+ * // Quarantine a suspicious skill
+ * const entry = repo.create({
+ *   skillId: 'community/suspicious-skill',
+ *   source: 'github',
+ *   quarantineReason: 'Obfuscated code detected',
+ *   severity: 'SUSPICIOUS',
+ *   detectedPatterns: ['eval()', 'obfuscated variables']
+ * })
+ *
+ * // Review and approve/reject
+ * const decision = repo.review(entry.id, {
+ *   reviewedBy: 'security-team',
+ *   reviewStatus: 'approved',
+ *   reviewNotes: 'Manual review confirmed safe after code analysis'
+ * })
+ * ```
+ */
+export declare class QuarantineRepository {
+    private db;
+    private auditLogger?;
+    private stmts;
+    constructor(db: DatabaseType, auditLogger?: AuditLogger);
+    /**
+     * Ensure the quarantine table exists
+     */
+    private ensureTableExists;
+    /**
+     * Prepare SQL statements for performance
+     */
+    private prepareStatements;
+    /**
+     * Convert a database row to a QuarantineEntry object
+     */
+    private rowToEntry;
+    /**
+     * Log audit event if AuditLogger is available
+     */
+    private logAudit;
+    /**
+     * Create a new quarantine entry
+     *
+     * @param input - Quarantine entry data
+     * @returns Created quarantine entry
+     */
+    create(input: QuarantineCreateInput): QuarantineEntry;
+    /**
+     * Find a quarantine entry by ID
+     *
+     * @param id - Quarantine entry ID
+     * @returns Quarantine entry or null if not found
+     */
+    findById(id: string): QuarantineEntry | null;
+    /**
+     * Find all quarantine entries for a skill
+     *
+     * @param skillId - Skill ID
+     * @returns Array of quarantine entries
+     */
+    findBySkillId(skillId: string): QuarantineEntry[];
+    /**
+     * Check if a skill is quarantined
+     *
+     * @param skillId - Skill ID
+     * @returns True if skill has any pending quarantine entries
+     */
+    isQuarantined(skillId: string): boolean;
+    /**
+     * Get the most severe quarantine entry for a skill
+     *
+     * @param skillId - Skill ID
+     * @returns Most severe quarantine entry or null
+     */
+    getMostSevere(skillId: string): QuarantineEntry | null;
+    /**
+     * Find all quarantine entries with pagination
+     *
+     * @param options - Pagination options
+     * @returns Paginated quarantine results
+     */
+    findAll(options?: {
+        limit?: number;
+        offset?: number;
+    }): PaginatedQuarantineResults;
+    /**
+     * Query quarantine entries with filters
+     *
+     * @param filter - Query filters
+     * @returns Paginated quarantine results
+     */
+    query(filter: QuarantineQueryFilter): PaginatedQuarantineResults;
+    /**
+     * Update a quarantine entry
+     *
+     * @param id - Quarantine entry ID
+     * @param input - Update data
+     * @returns Updated entry or null if not found
+     */
+    update(id: string, input: QuarantineUpdateInput): QuarantineEntry | null;
+    /**
+     * Review a quarantine entry
+     *
+     * @param id - Quarantine entry ID
+     * @param reviewInput - Review data
+     * @returns Review decision with import guidance
+     */
+    review(id: string, reviewInput: {
+        reviewedBy: string;
+        reviewStatus: QuarantineReviewStatus;
+        reviewNotes?: string;
+    }): ReviewDecision | null;
+    /**
+     * Delete a quarantine entry
+     *
+     * @param id - Quarantine entry ID
+     * @returns True if entry was deleted
+     */
+    delete(id: string): boolean;
+    /**
+     * Delete all quarantine entries for a skill
+     *
+     * @param skillId - Skill ID
+     * @returns Number of deleted entries
+     */
+    deleteBySkillId(skillId: string): number;
+    /**
+     * Get quarantine statistics
+     *
+     * @returns Quarantine statistics
+     */
+    getStats(): QuarantineStats;
+    /**
+     * Count all quarantine entries
+     *
+     * @returns Total count
+     */
+    count(): number;
+    /**
+     * Execute a function within a transaction
+     *
+     * @param fn - Function to execute
+     * @returns Result of the function
+     */
+    transaction<T>(fn: () => T): T;
+}
+//# sourceMappingURL=QuarantineRepository.d.ts.map

package/dist/src/repositories/QuarantineRepository.d.ts.map

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