@skillsmith/core 0.5.5 → 0.5.6

package/dist/repositories/SyncHistoryRepository.js

@@ -0,0 +1,235 @@
+/**
+ * SyncHistoryRepository - Tracks sync operation history
+ *
+ * Records each sync run with timing, counts, and status for monitoring.
+ */
+/**
+ * Generate a unique ID for sync runs
+ */
+function generateSyncId() {
+    const timestamp = new Date()
+        .toISOString()
+        .replace(/[-:T.Z]/g, '')
+        .slice(0, 14);
+    const random = Math.random().toString(36).slice(2, 8);
+    return `sync-${timestamp}-${random}`;
+}
+/**
+ * Repository for sync history tracking
+ */
+export class SyncHistoryRepository {
+    db;
+    stmts;
+    constructor(db) {
+        this.db = db;
+        this.ensureTable();
+        this.prepareStatements();
+    }
+    /**
+     * Ensure sync_history table exists
+     */
+    ensureTable() {
+        const tableExists = this.db
+            .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='sync_history'")
+            .get();
+        if (!tableExists) {
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS sync_history (
+          id TEXT PRIMARY KEY,
+          started_at TEXT NOT NULL,
+          completed_at TEXT,
+          status TEXT NOT NULL DEFAULT 'running' CHECK(status IN ('running', 'success', 'failed', 'partial')),
+          skills_added INTEGER DEFAULT 0,
+          skills_updated INTEGER DEFAULT 0,
+          skills_unchanged INTEGER DEFAULT 0,
+          error_message TEXT,
+          duration_ms INTEGER,
+          created_at TEXT NOT NULL DEFAULT (datetime('now'))
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_sync_history_started ON sync_history(started_at DESC);
+        CREATE INDEX IF NOT EXISTS idx_sync_history_status ON sync_history(status);
+      `);
+        }
+    }
+    prepareStatements() {
+        this.stmts = {
+            insert: this.db.prepare(`
+        INSERT INTO sync_history (id, started_at, status)
+        VALUES (?, ?, 'running')
+      `),
+            complete: this.db.prepare(`
+        UPDATE sync_history
+        SET completed_at = ?, status = ?, skills_added = ?, skills_updated = ?, skills_unchanged = ?, duration_ms = ?
+        WHERE id = ?
+      `),
+            fail: this.db.prepare(`
+        UPDATE sync_history
+        SET completed_at = ?, status = 'failed', error_message = ?, duration_ms = ?
+        WHERE id = ?
+      `),
+            getById: this.db.prepare(`
+        SELECT * FROM sync_history WHERE id = ?
+      `),
+            getHistory: this.db.prepare(`
+        SELECT * FROM sync_history ORDER BY started_at DESC LIMIT ?
+      `),
+            getLastSuccessful: this.db.prepare(`
+        SELECT * FROM sync_history WHERE status = 'success' ORDER BY started_at DESC LIMIT 1
+      `),
+            getRunning: this.db.prepare(`
+        SELECT * FROM sync_history WHERE status = 'running'
+      `),
+            deleteOld: this.db.prepare(`
+        DELETE FROM sync_history WHERE started_at < ?
+      `),
+            count: this.db.prepare(`
+        SELECT COUNT(*) as count FROM sync_history
+      `),
+        };
+    }
+    rowToEntry(row) {
+        return {
+            id: row.id,
+            startedAt: row.started_at,
+            completedAt: row.completed_at,
+            status: row.status,
+            skillsAdded: row.skills_added,
+            skillsUpdated: row.skills_updated,
+            skillsUnchanged: row.skills_unchanged,
+            errorMessage: row.error_message,
+            durationMs: row.duration_ms,
+            createdAt: row.created_at,
+        };
+    }
+    /**
+     * Start a new sync run
+     * @returns The sync run ID
+     */
+    startRun() {
+        const id = generateSyncId();
+        const startedAt = new Date().toISOString();
+        this.stmts.insert.run(id, startedAt);
+        return id;
+    }
+    /**
+     * Complete a sync run successfully
+     */
+    completeRun(id, result) {
+        const completedAt = new Date().toISOString();
+        const entry = this.stmts.getById.get(id);
+        if (!entry) {
+            throw new Error(`Sync run not found: ${id}`);
+        }
+        const durationMs = new Date(completedAt).getTime() - new Date(entry.started_at).getTime();
+        // Determine status based on results
+        const status = result.skillsAdded > 0 || result.skillsUpdated > 0 ? 'success' : 'success';
+        this.stmts.complete.run(completedAt, status, result.skillsAdded, result.skillsUpdated, result.skillsUnchanged, durationMs, id);
+    }
+    /**
+     * Mark a sync run as partially complete (some errors)
+     */
+    completeRunPartial(id, result, errorMessage) {
+        const completedAt = new Date().toISOString();
+        const entry = this.stmts.getById.get(id);
+        if (!entry) {
+            throw new Error(`Sync run not found: ${id}`);
+        }
+        const durationMs = new Date(completedAt).getTime() - new Date(entry.started_at).getTime();
+        // Use raw SQL for partial status since we need to include error
+        this.db
+            .prepare(`
+      UPDATE sync_history
+      SET completed_at = ?, status = 'partial', skills_added = ?, skills_updated = ?, skills_unchanged = ?, error_message = ?, duration_ms = ?
+      WHERE id = ?
+    `)
+            .run(completedAt, result.skillsAdded, result.skillsUpdated, result.skillsUnchanged, errorMessage, durationMs, id);
+    }
+    /**
+     * Mark a sync run as failed
+     */
+    failRun(id, error) {
+        const completedAt = new Date().toISOString();
+        const entry = this.stmts.getById.get(id);
+        if (!entry) {
+            throw new Error(`Sync run not found: ${id}`);
+        }
+        const durationMs = new Date(completedAt).getTime() - new Date(entry.started_at).getTime();
+        this.stmts.fail.run(completedAt, error, durationMs, id);
+    }
+    /**
+     * Get a specific sync run by ID
+     */
+    getById(id) {
+        const row = this.stmts.getById.get(id);
+        return row ? this.rowToEntry(row) : null;
+    }
+    /**
+     * Get sync history (most recent first)
+     */
+    getHistory(limit = 10) {
+        const rows = this.stmts.getHistory.all(limit);
+        return rows.map((row) => this.rowToEntry(row));
+    }
+    /**
+     * Get the last successful sync run
+     */
+    getLastSuccessful() {
+        const row = this.stmts.getLastSuccessful.get();
+        return row ? this.rowToEntry(row) : null;
+    }
+    /**
+     * Get any currently running sync operations
+     */
+    getRunning() {
+        const rows = this.stmts.getRunning.all();
+        return rows.map((row) => this.rowToEntry(row));
+    }
+    /**
+     * Check if a sync is currently running
+     */
+    isRunning() {
+        return this.getRunning().length > 0;
+    }
+    /**
+     * Clean up old history entries
+     * @param daysToKeep Number of days of history to retain
+     */
+    cleanup(daysToKeep = 30) {
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - daysToKeep);
+        const result = this.stmts.deleteOld.run(cutoff.toISOString());
+        return result.changes;
+    }
+    /**
+     * Get total count of history entries
+     */
+    count() {
+        const result = this.stmts.count.get();
+        return result.count;
+    }
+    /**
+     * Get sync statistics
+     */
+    getStats() {
+        const stats = this.db
+            .prepare(`
+      SELECT
+        COUNT(*) as total_runs,
+        SUM(CASE WHEN status = 'success' THEN 1 ELSE 0 END) as successful_runs,
+        SUM(CASE WHEN status = 'failed' THEN 1 ELSE 0 END) as failed_runs,
+        MAX(CASE WHEN status = 'success' THEN completed_at ELSE NULL END) as last_success_at,
+        AVG(CASE WHEN status = 'success' THEN duration_ms ELSE NULL END) as avg_duration_ms
+      FROM sync_history
+    `)
+            .get();
+        return {
+            totalRuns: stats.total_runs,
+            successfulRuns: stats.successful_runs ?? 0,
+            failedRuns: stats.failed_runs ?? 0,
+            lastSuccessAt: stats.last_success_at,
+            averageDurationMs: stats.avg_duration_ms ? Math.round(stats.avg_duration_ms) : null,
+        };
+    }
+}
+//# sourceMappingURL=SyncHistoryRepository.js.map

package/dist/repositories/SyncHistoryRepository.js.map

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

package/dist/repositories/quarantine/ApprovalRepository.d.ts

@@ -0,0 +1,148 @@
+/**
+ * SMI-2277: Approval Repository
+ *
+ * Persists multi-approval state to SQLite instead of in-memory Map.
+ * This ensures pending approvals survive service restarts.
+ *
+ * @module @skillsmith/core/repositories/quarantine/ApprovalRepository
+ */
+import type { Database as DatabaseType } from '../../db/database-interface.js';
+/**
+ * Database row for quarantine_approvals table
+ */
+export interface ApprovalRow {
+    id: string;
+    skill_id: string;
+    reviewer_id: string;
+    reviewer_email: string;
+    decision: 'approved' | 'rejected';
+    reason: string | null;
+    created_at: string;
+    completed_at: string | null;
+    required_approvals: number;
+    is_complete: number;
+}
+/**
+ * Domain object for a recorded approval
+ */
+export interface ApprovalEntry {
+    id: string;
+    skillId: string;
+    reviewerId: string;
+    reviewerEmail: string;
+    decision: 'approved' | 'rejected';
+    reason: string | null;
+    createdAt: string;
+    completedAt: string | null;
+    requiredApprovals: number;
+    isComplete: boolean;
+}
+/**
+ * Input for recording a new approval
+ */
+export interface RecordApprovalInput {
+    skillId: string;
+    reviewerId: string;
+    reviewerEmail: string;
+    decision: 'approved' | 'rejected';
+    reason?: string;
+    requiredApprovals?: number;
+}
+/**
+ * Repository for persisting multi-approval workflow state.
+ *
+ * Replaces the in-memory Map<string, MultiApprovalStatus> with
+ * database-backed storage to survive service restarts.
+ *
+ * @example
+ * ```typescript
+ * const repo = new ApprovalRepository(db)
+ *
+ * // Record a reviewer's approval
+ * repo.recordApproval({
+ *   skillId: 'quarantine-123',
+ *   reviewerId: 'user-456',
+ *   reviewerRole: 'reviewer@example.com',
+ *   decision: 'approved',
+ *   reason: 'Code verified safe',
+ * })
+ *
+ * // Check if enough approvals have been collected
+ * const complete = repo.isComplete('quarantine-123')
+ * ```
+ */
+export declare class ApprovalRepository {
+    private db;
+    constructor(db: DatabaseType);
+    /**
+     * Ensure the quarantine_approvals table exists
+     */
+    private ensureTableExists;
+    /**
+     * Record a new approval or rejection for a quarantine entry
+     *
+     * @param input - Approval details
+     * @returns The created approval entry
+     * @throws Error if reviewer has already submitted for this skill
+     */
+    recordApproval(input: RecordApprovalInput): ApprovalEntry;
+    /**
+     * Get all approvals for a quarantine entry (both pending and complete)
+     *
+     * @param skillId - The quarantine entry ID
+     * @returns All approval entries for this skill
+     */
+    getApprovals(skillId: string): ApprovalEntry[];
+    /**
+     * Get only pending (non-complete) approvals for a quarantine entry
+     *
+     * @param skillId - The quarantine entry ID
+     * @returns Pending approval entries
+     */
+    getPendingApprovals(skillId: string): ApprovalEntry[];
+    /**
+     * Check if a specific reviewer has already submitted for a skill
+     *
+     * @param skillId - The quarantine entry ID
+     * @param reviewerId - The reviewer's user ID
+     * @returns True if the reviewer already has a pending approval
+     */
+    hasReviewerApproved(skillId: string, reviewerId: string): boolean;
+    /**
+     * Check if the required number of approvals have been reached
+     *
+     * @param skillId - The quarantine entry ID
+     * @param requiredApprovals - Number of approvals needed (default: 2)
+     * @returns True if approval count meets or exceeds required
+     */
+    isComplete(skillId: string, requiredApprovals?: number): boolean;
+    /**
+     * Mark all pending approvals for a skill as complete
+     *
+     * @param skillId - The quarantine entry ID
+     * @returns Number of rows updated
+     */
+    markComplete(skillId: string): number;
+    /**
+     * Delete all approvals for a skill (for cleanup/reset/cancellation)
+     *
+     * @param skillId - The quarantine entry ID
+     * @returns Number of rows deleted
+     */
+    clearApprovals(skillId: string): number;
+    /**
+     * Get the timestamp of the first pending approval for timeout checks
+     *
+     * @param skillId - The quarantine entry ID
+     * @returns ISO date string of the first approval, or null if none
+     */
+    getWorkflowStartTime(skillId: string): string | null;
+    /**
+     * Get the count of pending approvals for a skill
+     *
+     * @param skillId - The quarantine entry ID
+     * @returns Count of pending approved entries
+     */
+    getPendingApprovalCount(skillId: string): number;
+}
+//# sourceMappingURL=ApprovalRepository.d.ts.map

package/dist/repositories/quarantine/ApprovalRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApprovalRepository.d.ts","sourceRoot":"","sources":["../../../src/repositories/quarantine/ApprovalRepository.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAQ9E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,UAAU,GAAG,UAAU,CAAA;IACjC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,UAAU,GAAG,UAAU,CAAA;IACjC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,iBAAiB,EAAE,MAAM,CAAA;IACzB,UAAU,EAAE,OAAO,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,UAAU,GAAG,UAAU,CAAA;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAyDD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,EAAE,CAAc;gBAEZ,EAAE,EAAE,YAAY;IAK5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;;;;OAMG;IACH,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,aAAa;IAuBzD;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE;IAM9C;;;;;OAKG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE;IAMrD;;;;;;OAMG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAMjE;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,GAAE,MAAU,GAAG,OAAO;IAQnE;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAMrC;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAMvC;;;;;OAKG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQpD;;;;;OAKG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAOjD"}

package/dist/repositories/quarantine/ApprovalRepository.js

@@ -0,0 +1,212 @@
+/**
+ * SMI-2277: Approval Repository
+ *
+ * Persists multi-approval state to SQLite instead of in-memory Map.
+ * This ensures pending approvals survive service restarts.
+ *
+ * @module @skillsmith/core/repositories/quarantine/ApprovalRepository
+ */
+import { randomUUID } from 'crypto';
+import { initializeQuarantineApprovalsSchema } from '../../db/quarantine-approvals-schema.js';
+// ============================================================================
+// SQL Queries
+// ============================================================================
+const INSERT_APPROVAL_QUERY = `
+  INSERT INTO quarantine_approvals (
+    id, skill_id, reviewer_id, reviewer_email, decision, reason,
+    created_at, required_approvals, is_complete
+  )
+  VALUES (?, ?, ?, ?, ?, ?, datetime('now') || 'Z', ?, 0)
+`;
+const SELECT_BY_SKILL_ID_QUERY = `
+  SELECT * FROM quarantine_approvals
+  WHERE skill_id = ?
+  ORDER BY created_at ASC
+`;
+const SELECT_PENDING_BY_SKILL_ID_QUERY = `
+  SELECT * FROM quarantine_approvals
+  WHERE skill_id = ? AND is_complete = 0
+  ORDER BY created_at ASC
+`;
+const COUNT_PENDING_APPROVALS_QUERY = `
+  SELECT COUNT(*) as count FROM quarantine_approvals
+  WHERE skill_id = ? AND is_complete = 0 AND decision = 'approved'
+`;
+const CHECK_REVIEWER_EXISTS_QUERY = `
+  SELECT id FROM quarantine_approvals
+  WHERE skill_id = ? AND reviewer_id = ? AND is_complete = 0
+`;
+const MARK_COMPLETE_QUERY = `
+  UPDATE quarantine_approvals
+  SET is_complete = 1, completed_at = datetime('now') || 'Z'
+  WHERE skill_id = ? AND is_complete = 0
+`;
+const DELETE_BY_SKILL_ID_QUERY = `
+  DELETE FROM quarantine_approvals WHERE skill_id = ?
+`;
+const SELECT_FIRST_PENDING_QUERY = `
+  SELECT created_at FROM quarantine_approvals
+  WHERE skill_id = ? AND is_complete = 0
+  ORDER BY created_at ASC
+  LIMIT 1
+`;
+// ============================================================================
+// Repository Implementation
+// ============================================================================
+/**
+ * Repository for persisting multi-approval workflow state.
+ *
+ * Replaces the in-memory Map<string, MultiApprovalStatus> with
+ * database-backed storage to survive service restarts.
+ *
+ * @example
+ * ```typescript
+ * const repo = new ApprovalRepository(db)
+ *
+ * // Record a reviewer's approval
+ * repo.recordApproval({
+ *   skillId: 'quarantine-123',
+ *   reviewerId: 'user-456',
+ *   reviewerRole: 'reviewer@example.com',
+ *   decision: 'approved',
+ *   reason: 'Code verified safe',
+ * })
+ *
+ * // Check if enough approvals have been collected
+ * const complete = repo.isComplete('quarantine-123')
+ * ```
+ */
+export class ApprovalRepository {
+    db;
+    constructor(db) {
+        this.db = db;
+        this.ensureTableExists();
+    }
+    /**
+     * Ensure the quarantine_approvals table exists
+     */
+    ensureTableExists() {
+        initializeQuarantineApprovalsSchema(this.db);
+    }
+    /**
+     * Record a new approval or rejection for a quarantine entry
+     *
+     * @param input - Approval details
+     * @returns The created approval entry
+     * @throws Error if reviewer has already submitted for this skill
+     */
+    recordApproval(input) {
+        const id = randomUUID();
+        const requiredApprovals = input.requiredApprovals ?? 2;
+        this.db
+            .prepare(INSERT_APPROVAL_QUERY)
+            .run(id, input.skillId, input.reviewerId, input.reviewerEmail, input.decision, input.reason ?? null, requiredApprovals);
+        const row = this.db
+            .prepare('SELECT * FROM quarantine_approvals WHERE id = ?')
+            .get(id);
+        return rowToEntry(row);
+    }
+    /**
+     * Get all approvals for a quarantine entry (both pending and complete)
+     *
+     * @param skillId - The quarantine entry ID
+     * @returns All approval entries for this skill
+     */
+    getApprovals(skillId) {
+        const rows = this.db.prepare(SELECT_BY_SKILL_ID_QUERY).all(skillId);
+        return rows.map(rowToEntry);
+    }
+    /**
+     * Get only pending (non-complete) approvals for a quarantine entry
+     *
+     * @param skillId - The quarantine entry ID
+     * @returns Pending approval entries
+     */
+    getPendingApprovals(skillId) {
+        const rows = this.db.prepare(SELECT_PENDING_BY_SKILL_ID_QUERY).all(skillId);
+        return rows.map(rowToEntry);
+    }
+    /**
+     * Check if a specific reviewer has already submitted for a skill
+     *
+     * @param skillId - The quarantine entry ID
+     * @param reviewerId - The reviewer's user ID
+     * @returns True if the reviewer already has a pending approval
+     */
+    hasReviewerApproved(skillId, reviewerId) {
+        const row = this.db.prepare(CHECK_REVIEWER_EXISTS_QUERY).get(skillId, reviewerId);
+        return !!row;
+    }
+    /**
+     * Check if the required number of approvals have been reached
+     *
+     * @param skillId - The quarantine entry ID
+     * @param requiredApprovals - Number of approvals needed (default: 2)
+     * @returns True if approval count meets or exceeds required
+     */
+    isComplete(skillId, requiredApprovals = 2) {
+        const { count } = this.db.prepare(COUNT_PENDING_APPROVALS_QUERY).get(skillId);
+        return count >= requiredApprovals;
+    }
+    /**
+     * Mark all pending approvals for a skill as complete
+     *
+     * @param skillId - The quarantine entry ID
+     * @returns Number of rows updated
+     */
+    markComplete(skillId) {
+        const result = this.db.prepare(MARK_COMPLETE_QUERY).run(skillId);
+        return result.changes;
+    }
+    /**
+     * Delete all approvals for a skill (for cleanup/reset/cancellation)
+     *
+     * @param skillId - The quarantine entry ID
+     * @returns Number of rows deleted
+     */
+    clearApprovals(skillId) {
+        const result = this.db.prepare(DELETE_BY_SKILL_ID_QUERY).run(skillId);
+        return result.changes;
+    }
+    /**
+     * Get the timestamp of the first pending approval for timeout checks
+     *
+     * @param skillId - The quarantine entry ID
+     * @returns ISO date string of the first approval, or null if none
+     */
+    getWorkflowStartTime(skillId) {
+        const row = this.db.prepare(SELECT_FIRST_PENDING_QUERY).get(skillId);
+        return row?.created_at ?? null;
+    }
+    /**
+     * Get the count of pending approvals for a skill
+     *
+     * @param skillId - The quarantine entry ID
+     * @returns Count of pending approved entries
+     */
+    getPendingApprovalCount(skillId) {
+        const { count } = this.db.prepare(COUNT_PENDING_APPROVALS_QUERY).get(skillId);
+        return count;
+    }
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Convert a database row to a domain object
+ */
+function rowToEntry(row) {
+    return {
+        id: row.id,
+        skillId: row.skill_id,
+        reviewerId: row.reviewer_id,
+        reviewerEmail: row.reviewer_email,
+        decision: row.decision,
+        reason: row.reason,
+        createdAt: row.created_at,
+        completedAt: row.completed_at,
+        requiredApprovals: row.required_approvals,
+        isComplete: row.is_complete === 1,
+    };
+}
+//# sourceMappingURL=ApprovalRepository.js.map

package/dist/repositories/quarantine/ApprovalRepository.js.map

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