ocr-provenance-mcp 1.0.0

package/dist/services/storage/database/static-operations.js

@@ -0,0 +1,218 @@
+/**
+ * Static operations for DatabaseService - database lifecycle: create, open, list, delete, exists.
+ */
+import Database from 'better-sqlite3';
+import { statSync, existsSync, mkdirSync, readdirSync, unlinkSync, writeFileSync, chmodSync, rmSync, } from 'fs';
+import { createRequire } from 'module';
+import { join } from 'path';
+import { initializeDatabase, migrateToLatest, verifySchema, configurePragmas, } from '../migrations.js';
+import { DatabaseError, DatabaseErrorCode } from './types.js';
+import { DEFAULT_STORAGE_PATH, validateName, getDatabasePath } from './helpers.js';
+const require = createRequire(import.meta.url);
+/**
+ * Create a new database
+ * @throws DatabaseError if name is invalid or database already exists
+ */
+export function createDatabase(name, description, storagePath) {
+    validateName(name);
+    const basePath = storagePath ?? DEFAULT_STORAGE_PATH;
+    const dbPath = getDatabasePath(name, storagePath);
+    if (!existsSync(basePath)) {
+        mkdirSync(basePath, { recursive: true, mode: 0o700 });
+    }
+    if (existsSync(dbPath)) {
+        throw new DatabaseError(`Database "${name}" already exists at ${dbPath}`, DatabaseErrorCode.DATABASE_ALREADY_EXISTS);
+    }
+    writeFileSync(dbPath, '', { mode: 0o600 });
+    chmodSync(dbPath, 0o600);
+    let db;
+    try {
+        db = new Database(dbPath);
+    }
+    catch (error) {
+        try {
+            unlinkSync(dbPath);
+        }
+        catch (cleanupErr) {
+            console.error('[static-operations] Failed to clean up db file after creation error:', cleanupErr instanceof Error ? cleanupErr.message : String(cleanupErr));
+        }
+        throw new DatabaseError(`Failed to create database "${name}": ${String(error)}`, DatabaseErrorCode.PERMISSION_DENIED, error);
+    }
+    try {
+        initializeDatabase(db);
+    }
+    catch (error) {
+        db.close();
+        try {
+            unlinkSync(dbPath);
+        }
+        catch (cleanupErr) {
+            console.error('[static-operations] Failed to clean up db file after init error:', cleanupErr instanceof Error ? cleanupErr.message : String(cleanupErr));
+        }
+        throw error;
+    }
+    try {
+        const stmt = db.prepare(`UPDATE database_metadata SET database_name = ?, database_version = ? WHERE id = 1`);
+        stmt.run(description ? `${name}: ${description}` : name, '1.0.0');
+    }
+    catch (error) {
+        db.close();
+        try {
+            unlinkSync(dbPath);
+        }
+        catch (cleanupErr) {
+            console.error('[static-operations] Failed to clean up db file after metadata error:', cleanupErr instanceof Error ? cleanupErr.message : String(cleanupErr));
+        }
+        throw new DatabaseError(`Failed to set database metadata: ${String(error)}`, DatabaseErrorCode.SCHEMA_MISMATCH, error);
+    }
+    return { db, name, path: dbPath };
+}
+/**
+ * Open an existing database
+ * @throws DatabaseError if database doesn't exist or schema is invalid
+ */
+export function openDatabase(name, storagePath) {
+    validateName(name);
+    const dbPath = getDatabasePath(name, storagePath);
+    if (!existsSync(dbPath)) {
+        throw new DatabaseError(`Database "${name}" not found at ${dbPath}`, DatabaseErrorCode.DATABASE_NOT_FOUND);
+    }
+    let db;
+    try {
+        db = new Database(dbPath);
+    }
+    catch (error) {
+        throw new DatabaseError(`Failed to open database "${name}": ${String(error)}`, DatabaseErrorCode.DATABASE_LOCKED, error);
+    }
+    try {
+        const sqliteVec = require('sqlite-vec');
+        sqliteVec.load(db);
+    }
+    catch (error) {
+        db.close();
+        throw new DatabaseError(`Failed to load sqlite-vec extension: ${String(error)}. Ensure sqlite-vec is installed for your platform (npm install sqlite-vec-linux-x64 or sqlite-vec-darwin-arm64 or sqlite-vec-win32-x64).`, DatabaseErrorCode.EXTENSION_LOAD_FAILED, error);
+    }
+    // Configure per-connection pragmas (FK enforcement, synchronous, cache_size)
+    // These are NOT persistent in SQLite -- must be set on every connection open
+    try {
+        configurePragmas(db);
+    }
+    catch (error) {
+        db.close();
+        throw error;
+    }
+    try {
+        migrateToLatest(db);
+    }
+    catch (error) {
+        db.close();
+        throw error;
+    }
+    const verification = verifySchema(db);
+    if (!verification.valid) {
+        db.close();
+        throw new DatabaseError(`Database schema verification failed. Missing tables: ${verification.missingTables.join(', ')}. Missing indexes: ${verification.missingIndexes.join(', ')}`, DatabaseErrorCode.SCHEMA_MISMATCH);
+    }
+    return { db, name, path: dbPath };
+}
+/** List all available databases */
+export function listDatabases(storagePath) {
+    const basePath = storagePath ?? DEFAULT_STORAGE_PATH;
+    if (!existsSync(basePath))
+        return [];
+    const files = readdirSync(basePath).filter((f) => f.endsWith('.db'));
+    const databases = [];
+    for (const file of files) {
+        const name = file.replace('.db', '');
+        const dbPath = join(basePath, file);
+        try {
+            const stats = statSync(dbPath);
+            const db = new Database(dbPath, { readonly: true });
+            try {
+                const row = db
+                    .prepare(`
+          SELECT database_name, created_at, last_modified_at,
+                 total_documents, total_ocr_results, total_chunks, total_embeddings
+          FROM database_metadata WHERE id = 1
+        `)
+                    .get();
+                if (row) {
+                    databases.push({
+                        name,
+                        path: dbPath,
+                        size_bytes: stats.size,
+                        created_at: row.created_at,
+                        last_modified_at: row.last_modified_at,
+                        total_documents: row.total_documents,
+                        total_ocr_results: row.total_ocr_results,
+                        total_chunks: row.total_chunks,
+                        total_embeddings: row.total_embeddings,
+                    });
+                }
+            }
+            finally {
+                db.close();
+            }
+        }
+        catch (error) {
+            console.error(`[static-operations] Failed to read database "${file}": ${error instanceof Error ? error.message : String(error)}`);
+            continue;
+        }
+    }
+    return databases;
+}
+/** Delete a database - throws DatabaseError if database doesn't exist */
+export function deleteDatabase(name, storagePath) {
+    validateName(name);
+    const dbPath = getDatabasePath(name, storagePath);
+    if (!existsSync(dbPath)) {
+        throw new DatabaseError(`Database "${name}" not found at ${dbPath}`, DatabaseErrorCode.DATABASE_NOT_FOUND);
+    }
+    // Before deleting the DB file, query for document IDs to clean up image directories
+    try {
+        const db = new Database(dbPath, { readonly: true });
+        try {
+            const basePath = storagePath ?? join(dbPath, '..'); // parent of .db file
+            const imagesBaseDir = join(basePath, 'images');
+            if (existsSync(imagesBaseDir)) {
+                // Query all document IDs — image dirs are created per-document during OCR
+                const docs = db.prepare('SELECT id FROM documents').all();
+                for (const { id } of docs) {
+                    const imageDir = join(imagesBaseDir, id);
+                    if (existsSync(imageDir)) {
+                        try {
+                            rmSync(imageDir, { recursive: true, force: true });
+                        }
+                        catch (error) {
+                            console.error(`[static-operations] Failed to delete image directory ${imageDir}: ${error instanceof Error ? error.message : String(error)}`);
+                        }
+                    }
+                }
+            }
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch (error) {
+        console.error(`[static-operations] Failed to query database ${dbPath} for image cleanup (DB may be corrupt or missing tables): ${error instanceof Error ? error.message : String(error)}`);
+    }
+    unlinkSync(dbPath);
+    for (const suffix of ['-wal', '-shm']) {
+        const path = `${dbPath}${suffix}`;
+        if (existsSync(path))
+            unlinkSync(path);
+    }
+}
+/** Check if a database exists */
+export function databaseExists(name, storagePath) {
+    try {
+        validateName(name);
+    }
+    catch (error) {
+        console.error('[static-operations] Invalid database name:', error instanceof Error ? error.message : String(error));
+        return false;
+    }
+    return existsSync(getDatabasePath(name, storagePath));
+}
+//# sourceMappingURL=static-operations.js.map

package/dist/services/storage/database/static-operations.js.map

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

package/dist/services/storage/database/stats-operations.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Statistics operations for DatabaseService
+ *
+ * Handles database statistics retrieval.
+ */
+import Database from 'better-sqlite3';
+import { DatabaseStats } from './types.js';
+/**
+ * Get database statistics
+ *
+ * @param db - Database connection
+ * @param name - Database name
+ * @param path - Database file path
+ * @returns DatabaseStats - Live statistics from database
+ */
+export declare function getStats(db: Database.Database, name: string, path: string): DatabaseStats;
+/**
+ * Update metadata counts from actual table counts
+ *
+ * @param db - Database connection
+ */
+export declare function updateMetadataCounts(db: Database.Database): void;
+/**
+ * Update metadata last_modified_at timestamp
+ *
+ * @param db - Database connection
+ */
+export declare function updateMetadataModified(db: Database.Database): void;
+export type TimelineBucket = 'hourly' | 'daily' | 'weekly' | 'monthly';
+export type TimelineMetric = 'documents' | 'pages' | 'chunks' | 'embeddings' | 'images' | 'cost';
+export interface TimelineStatsOptions {
+    bucket: TimelineBucket;
+    metric: TimelineMetric;
+    created_after?: string;
+    created_before?: string;
+}
+export interface TimelineDataPoint {
+    period: string;
+    count: number;
+    total?: number;
+}
+/**
+ * Get processing volume over time buckets for various metrics.
+ *
+ * @param db - Database connection
+ * @param options - Bucket type, metric, optional date range
+ * @returns Array of { period, count, total? } data points
+ */
+export declare function getTimelineStats(db: Database.Database, options: TimelineStatsOptions): TimelineDataPoint[];
+export interface QualityTrendOptions {
+    bucket: TimelineBucket;
+    group_by?: 'none' | 'ocr_mode' | 'processor';
+    created_after?: string;
+    created_before?: string;
+}
+export interface QualityTrendDataPoint {
+    period: string;
+    avg_quality: number;
+    min_quality: number;
+    max_quality: number;
+    sample_count: number;
+    group?: string;
+}
+/**
+ * Get quality score trends over time, optionally grouped by OCR mode or processor.
+ *
+ * Uses ocr_results.parse_quality_score for ocr_mode grouping,
+ * and provenance.processing_quality_score for processor grouping.
+ *
+ * @param db - Database connection
+ * @param options - Bucket type, group_by, optional date range
+ * @returns Array of quality trend data points
+ */
+export declare function getQualityTrends(db: Database.Database, options: QualityTrendOptions): QualityTrendDataPoint[];
+export interface ThroughputOptions {
+    bucket: TimelineBucket;
+    created_after?: string;
+    created_before?: string;
+}
+export interface ThroughputDataPoint {
+    period: string;
+    pages_processed: number;
+    embeddings_generated: number;
+    images_processed: number;
+    total_ocr_duration_ms: number;
+    total_embedding_duration_ms: number;
+    avg_ms_per_page: number;
+    avg_ms_per_embedding: number;
+}
+/**
+ * Get processing throughput metrics per time bucket.
+ *
+ * Queries provenance table for OCR_RESULT, EMBEDDING, and IMAGE types
+ * to compute per-bucket throughput rates.
+ *
+ * @param db - Database connection
+ * @param options - Bucket type, optional date range
+ * @returns Array of throughput data points per bucket
+ */
+export declare function getThroughputAnalytics(db: Database.Database, options: ThroughputOptions): ThroughputDataPoint[];
+//# sourceMappingURL=stats-operations.d.ts.map

package/dist/services/storage/database/stats-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats-operations.d.ts","sourceRoot":"","sources":["../../../../src/services/storage/database/stats-operations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAkIzF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAwBhE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAMlE;AAMD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AACvE,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEjG,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAwBD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,oBAAoB,GAC5B,iBAAiB,EAAE,CAiFrB;AAMD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,mBAAmB,GAC3B,qBAAqB,EAAE,CAgHzB;AAMD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,cAAc,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,2BAA2B,EAAE,MAAM,CAAC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,iBAAiB,GACzB,mBAAmB,EAAE,CA4DvB"}