ocr-provenance-mcp 1.0.0

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

@@ -0,0 +1,89 @@
+/**
+ * Document Lock Operations
+ *
+ * Provides database operations for document-level locking to prevent
+ * concurrent edits. Supports exclusive and shared lock types with
+ * automatic expiry via TTL.
+ *
+ * CRITICAL: NEVER use console.log() - stdout is reserved for JSON-RPC protocol.
+ *
+ * @module database/lock-operations
+ */
+// ═══════════════════════════════════════════════════════════════════════════════
+// LOCK OPERATIONS
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Acquire a lock on a document.
+ *
+ * Exclusive locks prevent any other lock. Shared locks allow other shared
+ * locks but block exclusive locks. Expired locks are cleaned up first.
+ *
+ * @param conn - Database connection
+ * @param params - Lock parameters
+ * @returns The acquired lock row
+ * @throws Error if document not found or lock conflict
+ */
+export function acquireLock(conn, params) {
+    // Validate document exists
+    const doc = conn.prepare('SELECT id FROM documents WHERE id = ?').get(params.document_id);
+    if (!doc) {
+        throw new Error(`Document not found: ${params.document_id}`);
+    }
+    // Clean expired locks first
+    conn.prepare(`DELETE FROM document_locks WHERE expires_at < datetime('now')`).run();
+    // Check for existing lock
+    const existing = conn.prepare('SELECT * FROM document_locks WHERE document_id = ?').get(params.document_id);
+    if (existing) {
+        // Same user can re-acquire their own lock
+        if (existing.user_id === params.user_id) {
+            // Update existing lock
+            const ttlMinutes = params.ttl_minutes ?? 30;
+            conn.prepare(`
+        UPDATE document_locks
+        SET session_id = ?, lock_type = ?, reason = ?, acquired_at = datetime('now'), expires_at = datetime('now', '+' || ? || ' minutes')
+        WHERE document_id = ?
+      `).run(params.session_id, params.lock_type, params.reason ?? null, ttlMinutes, params.document_id);
+            return conn.prepare('SELECT * FROM document_locks WHERE document_id = ?').get(params.document_id);
+        }
+        if (existing.lock_type === 'exclusive') {
+            throw new Error(`Document ${params.document_id} is exclusively locked by user ${existing.user_id} until ${existing.expires_at}`);
+        }
+        if (params.lock_type === 'exclusive') {
+            throw new Error(`Cannot acquire exclusive lock: document ${params.document_id} has a shared lock by user ${existing.user_id}`);
+        }
+    }
+    const ttlMinutes = params.ttl_minutes ?? 30;
+    conn.prepare(`
+    INSERT OR REPLACE INTO document_locks (document_id, user_id, session_id, lock_type, reason, acquired_at, expires_at)
+    VALUES (?, ?, ?, ?, ?, datetime('now'), datetime('now', '+' || ? || ' minutes'))
+  `).run(params.document_id, params.user_id, params.session_id, params.lock_type, params.reason ?? null, ttlMinutes);
+    return conn.prepare('SELECT * FROM document_locks WHERE document_id = ?').get(params.document_id);
+}
+/**
+ * Release a lock on a document.
+ *
+ * @param conn - Database connection
+ * @param documentId - Document ID
+ * @throws Error if no lock found
+ */
+export function releaseLock(conn, documentId) {
+    const existing = conn.prepare('SELECT * FROM document_locks WHERE document_id = ?').get(documentId);
+    if (!existing) {
+        throw new Error(`No lock found for document: ${documentId}`);
+    }
+    conn.prepare('DELETE FROM document_locks WHERE document_id = ?').run(documentId);
+}
+/**
+ * Get the current lock status for a document.
+ * Cleans up expired locks before checking.
+ *
+ * @param conn - Database connection
+ * @param documentId - Document ID
+ * @returns Lock row or null if no active lock
+ */
+export function getLockStatus(conn, documentId) {
+    // Clean expired locks first
+    conn.prepare(`DELETE FROM document_locks WHERE expires_at < datetime('now')`).run();
+    return conn.prepare('SELECT * FROM document_locks WHERE document_id = ?').get(documentId) ?? null;
+}
+//# sourceMappingURL=lock-operations.js.map

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

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

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

@@ -0,0 +1,88 @@
+/**
+ * Obligation Operations for DatabaseService
+ *
+ * Provides CRUD and query operations for the obligations table.
+ * Obligations track contract deadlines, deliverables, and compliance items.
+ *
+ * @module database/obligation-operations
+ */
+import type Database from 'better-sqlite3';
+export interface Obligation {
+    id: string;
+    document_id: string;
+    extraction_id: string | null;
+    obligation_type: string;
+    description: string;
+    responsible_party: string | null;
+    due_date: string | null;
+    recurring: string | null;
+    status: string;
+    source_chunk_id: string | null;
+    source_page: number | null;
+    confidence: number;
+    created_at: string;
+    metadata_json: string;
+}
+export declare const OBLIGATION_TYPES: readonly ["payment", "delivery", "notification", "renewal", "termination", "compliance", "reporting", "approval", "other"];
+export declare const OBLIGATION_STATUSES: readonly ["active", "fulfilled", "overdue", "waived", "expired"];
+export type ObligationType = (typeof OBLIGATION_TYPES)[number];
+export type ObligationStatus = (typeof OBLIGATION_STATUSES)[number];
+export interface CreateObligationParams {
+    document_id: string;
+    extraction_id?: string | null;
+    obligation_type: ObligationType;
+    description: string;
+    responsible_party?: string | null;
+    due_date?: string | null;
+    recurring?: string | null;
+    status?: ObligationStatus;
+    source_chunk_id?: string | null;
+    source_page?: number | null;
+    confidence?: number;
+    metadata_json?: string;
+}
+export interface ListObligationsFilters {
+    document_id?: string;
+    obligation_type?: ObligationType;
+    status?: ObligationStatus;
+    due_before?: string;
+    due_after?: string;
+    responsible_party?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface CalendarOptions {
+    months_ahead?: number;
+    status?: ObligationStatus;
+    document_id?: string;
+}
+export interface CalendarMonth {
+    month: string;
+    obligations: Obligation[];
+}
+/**
+ * Create a new obligation
+ */
+export declare function createObligation(db: Database.Database, params: CreateObligationParams): Obligation;
+/**
+ * List obligations with optional filters
+ */
+export declare function listObligations(db: Database.Database, filters: ListObligationsFilters): {
+    obligations: Obligation[];
+    total: number;
+};
+/**
+ * Update obligation status
+ * @throws Error if obligation not found
+ */
+export declare function updateObligationStatus(db: Database.Database, id: string, status: ObligationStatus, reason?: string): Obligation;
+/**
+ * Get obligations grouped by month for calendar view
+ */
+export declare function getObligationCalendar(db: Database.Database, options: CalendarOptions): CalendarMonth[];
+/**
+ * Mark active obligations with past due dates as overdue
+ * @returns Number of obligations marked overdue
+ */
+export declare function markOverdueObligations(db: Database.Database): number;
+//# sourceMappingURL=obligation-operations.d.ts.map

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

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

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

@@ -0,0 +1,206 @@
+/**
+ * Obligation Operations for DatabaseService
+ *
+ * Provides CRUD and query operations for the obligations table.
+ * Obligations track contract deadlines, deliverables, and compliance items.
+ *
+ * @module database/obligation-operations
+ */
+import { v4 as uuidv4 } from 'uuid';
+export const OBLIGATION_TYPES = [
+    'payment', 'delivery', 'notification', 'renewal',
+    'termination', 'compliance', 'reporting', 'approval', 'other',
+];
+export const OBLIGATION_STATUSES = [
+    'active', 'fulfilled', 'overdue', 'waived', 'expired',
+];
+// =============================================================================
+// CREATE
+// =============================================================================
+/**
+ * Create a new obligation
+ */
+export function createObligation(db, params) {
+    const id = uuidv4();
+    const now = new Date().toISOString();
+    db.prepare(`
+    INSERT INTO obligations (id, document_id, extraction_id, obligation_type, description,
+      responsible_party, due_date, recurring, status, source_chunk_id, source_page,
+      confidence, created_at, metadata_json)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(id, params.document_id, params.extraction_id ?? null, params.obligation_type, params.description, params.responsible_party ?? null, params.due_date ?? null, params.recurring ?? null, params.status ?? 'active', params.source_chunk_id ?? null, params.source_page ?? null, params.confidence ?? 1.0, now, params.metadata_json ?? '{}');
+    return {
+        id,
+        document_id: params.document_id,
+        extraction_id: params.extraction_id ?? null,
+        obligation_type: params.obligation_type,
+        description: params.description,
+        responsible_party: params.responsible_party ?? null,
+        due_date: params.due_date ?? null,
+        recurring: params.recurring ?? null,
+        status: params.status ?? 'active',
+        source_chunk_id: params.source_chunk_id ?? null,
+        source_page: params.source_page ?? null,
+        confidence: params.confidence ?? 1.0,
+        created_at: now,
+        metadata_json: params.metadata_json ?? '{}',
+    };
+}
+// =============================================================================
+// LIST WITH FILTERS
+// =============================================================================
+/**
+ * List obligations with optional filters
+ */
+export function listObligations(db, filters) {
+    const conditions = [];
+    const queryParams = [];
+    if (filters.document_id) {
+        conditions.push('o.document_id = ?');
+        queryParams.push(filters.document_id);
+    }
+    if (filters.obligation_type) {
+        conditions.push('o.obligation_type = ?');
+        queryParams.push(filters.obligation_type);
+    }
+    if (filters.status) {
+        conditions.push('o.status = ?');
+        queryParams.push(filters.status);
+    }
+    if (filters.due_before) {
+        conditions.push('o.due_date IS NOT NULL AND o.due_date <= ?');
+        queryParams.push(filters.due_before);
+    }
+    if (filters.due_after) {
+        conditions.push('o.due_date IS NOT NULL AND o.due_date >= ?');
+        queryParams.push(filters.due_after);
+    }
+    if (filters.responsible_party) {
+        conditions.push('o.responsible_party = ?');
+        queryParams.push(filters.responsible_party);
+    }
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+    const countRow = db.prepare(`SELECT COUNT(*) as cnt FROM obligations o ${whereClause}`).get(...queryParams);
+    const limit = filters.limit ?? 50;
+    const offset = filters.offset ?? 0;
+    const obligations = db.prepare(`
+    SELECT o.* FROM obligations o
+    ${whereClause}
+    ORDER BY o.due_date ASC NULLS LAST, o.created_at DESC
+    LIMIT ? OFFSET ?
+  `).all(...queryParams, limit, offset);
+    return { obligations, total: countRow.cnt };
+}
+// =============================================================================
+// UPDATE STATUS
+// =============================================================================
+/**
+ * Update obligation status
+ * @throws Error if obligation not found
+ */
+export function updateObligationStatus(db, id, status, reason) {
+    const existing = db.prepare('SELECT * FROM obligations WHERE id = ?').get(id);
+    if (!existing) {
+        throw new Error(`Obligation not found: ${id}`);
+    }
+    // Update metadata with status change reason if provided
+    let metadata = {};
+    try {
+        metadata = JSON.parse(existing.metadata_json || '{}');
+    }
+    catch {
+        metadata = {};
+    }
+    if (reason) {
+        const statusHistory = metadata.status_history ?? [];
+        statusHistory.push({
+            from: existing.status,
+            to: status,
+            reason,
+            changed_at: new Date().toISOString(),
+        });
+        metadata.status_history = statusHistory;
+    }
+    db.prepare(`
+    UPDATE obligations SET status = ?, metadata_json = ? WHERE id = ?
+  `).run(status, JSON.stringify(metadata), id);
+    return {
+        ...existing,
+        status,
+        metadata_json: JSON.stringify(metadata),
+    };
+}
+// =============================================================================
+// CALENDAR VIEW
+// =============================================================================
+/**
+ * Get obligations grouped by month for calendar view
+ */
+export function getObligationCalendar(db, options) {
+    const monthsAhead = options.months_ahead ?? 3;
+    const now = new Date();
+    const endDate = new Date(now);
+    endDate.setMonth(endDate.getMonth() + monthsAhead);
+    const conditions = [
+        'o.due_date IS NOT NULL',
+        'o.due_date >= ?',
+        'o.due_date <= ?',
+    ];
+    const queryParams = [
+        now.toISOString(),
+        endDate.toISOString(),
+    ];
+    if (options.status) {
+        conditions.push('o.status = ?');
+        queryParams.push(options.status);
+    }
+    if (options.document_id) {
+        conditions.push('o.document_id = ?');
+        queryParams.push(options.document_id);
+    }
+    const whereClause = `WHERE ${conditions.join(' AND ')}`;
+    const obligations = db.prepare(`
+    SELECT o.* FROM obligations o
+    ${whereClause}
+    ORDER BY o.due_date ASC
+  `).all(...queryParams);
+    // Group by month
+    const monthMap = new Map();
+    for (const ob of obligations) {
+        if (!ob.due_date)
+            continue;
+        const month = ob.due_date.substring(0, 7); // YYYY-MM
+        const existing = monthMap.get(month);
+        if (existing) {
+            existing.push(ob);
+        }
+        else {
+            monthMap.set(month, [ob]);
+        }
+    }
+    // Convert to sorted array
+    const result = [];
+    for (const [month, obs] of monthMap.entries()) {
+        result.push({ month, obligations: obs });
+    }
+    result.sort((a, b) => a.month.localeCompare(b.month));
+    return result;
+}
+// =============================================================================
+// MARK OVERDUE
+// =============================================================================
+/**
+ * Mark active obligations with past due dates as overdue
+ * @returns Number of obligations marked overdue
+ */
+export function markOverdueObligations(db) {
+    const result = db.prepare(`
+    UPDATE obligations
+    SET status = 'overdue'
+    WHERE due_date < datetime('now')
+      AND status = 'active'
+      AND due_date IS NOT NULL
+  `).run();
+    return result.changes;
+}
+//# sourceMappingURL=obligation-operations.js.map

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * OCR Result operations for DatabaseService
+ *
+ * Handles all CRUD operations for OCR results.
+ */
+import Database from 'better-sqlite3';
+import { OCRResult } from '../../../models/document.js';
+/**
+ * Insert an OCR result
+ *
+ * @param db - Database connection
+ * @param result - OCR result data
+ * @param updateMetadataCounts - Callback to update metadata counts
+ * @returns string - The OCR result ID
+ */
+export declare function insertOCRResult(db: Database.Database, result: OCRResult, updateMetadataCounts: () => void): string;
+/**
+ * Get an OCR result by ID
+ *
+ * @param db - Database connection
+ * @param id - OCR result ID
+ * @returns OCRResult | null - The OCR result or null if not found
+ */
+export declare function getOCRResult(db: Database.Database, id: string): OCRResult | null;
+/**
+ * Get OCR result by document ID
+ *
+ * @param db - Database connection
+ * @param documentId - Document ID
+ * @returns OCRResult | null - The OCR result or null if not found
+ */
+export declare function getOCRResultByDocumentId(db: Database.Database, documentId: string): OCRResult | null;
+//# sourceMappingURL=ocr-operations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ocr-operations.d.ts","sourceRoot":"","sources":["../../../../src/services/storage/database/ocr-operations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAKxD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,SAAS,EACjB,oBAAoB,EAAE,MAAM,IAAI,GAC/B,MAAM,CAmCR;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAIhF;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,UAAU,EAAE,MAAM,GACjB,SAAS,GAAG,IAAI,CAIlB"}

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

@@ -0,0 +1,70 @@
+/**
+ * OCR Result operations for DatabaseService
+ *
+ * Handles all CRUD operations for OCR results.
+ */
+import { runWithForeignKeyCheck } from './helpers.js';
+import { rowToOCRResult } from './converters.js';
+/**
+ * Insert an OCR result
+ *
+ * @param db - Database connection
+ * @param result - OCR result data
+ * @param updateMetadataCounts - Callback to update metadata counts
+ * @returns string - The OCR result ID
+ */
+export function insertOCRResult(db, result, updateMetadataCounts) {
+    const stmt = db.prepare(`
+    INSERT INTO ocr_results (
+      id, provenance_id, document_id, extracted_text, text_length,
+      datalab_request_id, datalab_mode, parse_quality_score, page_count,
+      cost_cents, content_hash, processing_started_at, processing_completed_at,
+      processing_duration_ms, json_blocks, extras_json
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `);
+    runWithForeignKeyCheck(stmt, [
+        result.id,
+        result.provenance_id,
+        result.document_id,
+        result.extracted_text,
+        result.text_length,
+        result.datalab_request_id,
+        result.datalab_mode,
+        result.parse_quality_score,
+        result.page_count,
+        result.cost_cents,
+        result.content_hash,
+        result.processing_started_at,
+        result.processing_completed_at,
+        result.processing_duration_ms,
+        result.json_blocks ?? null,
+        result.extras_json ?? null,
+    ], `inserting OCR result: document_id "${result.document_id}" or provenance_id "${result.provenance_id}" does not exist`);
+    updateMetadataCounts();
+    return result.id;
+}
+/**
+ * Get an OCR result by ID
+ *
+ * @param db - Database connection
+ * @param id - OCR result ID
+ * @returns OCRResult | null - The OCR result or null if not found
+ */
+export function getOCRResult(db, id) {
+    const stmt = db.prepare('SELECT * FROM ocr_results WHERE id = ?');
+    const row = stmt.get(id);
+    return row ? rowToOCRResult(row) : null;
+}
+/**
+ * Get OCR result by document ID
+ *
+ * @param db - Database connection
+ * @param documentId - Document ID
+ * @returns OCRResult | null - The OCR result or null if not found
+ */
+export function getOCRResultByDocumentId(db, documentId) {
+    const stmt = db.prepare('SELECT * FROM ocr_results WHERE document_id = ?');
+    const row = stmt.get(documentId);
+    return row ? rowToOCRResult(row) : null;
+}
+//# sourceMappingURL=ocr-operations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ocr-operations.js","sourceRoot":"","sources":["../../../../src/services/storage/database/ocr-operations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,EAAqB,EACrB,MAAiB,EACjB,oBAAgC;IAEhC,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;;GAOvB,CAAC,CAAC;IAEH,sBAAsB,CACpB,IAAI,EACJ;QACE,MAAM,CAAC,EAAE;QACT,MAAM,CAAC,aAAa;QACpB,MAAM,CAAC,WAAW;QAClB,MAAM,CAAC,cAAc;QACrB,MAAM,CAAC,WAAW;QAClB,MAAM,CAAC,kBAAkB;QACzB,MAAM,CAAC,YAAY;QACnB,MAAM,CAAC,mBAAmB;QAC1B,MAAM,CAAC,UAAU;QACjB,MAAM,CAAC,UAAU;QACjB,MAAM,CAAC,YAAY;QACnB,MAAM,CAAC,qBAAqB;QAC5B,MAAM,CAAC,uBAAuB;QAC9B,MAAM,CAAC,sBAAsB;QAC7B,MAAM,CAAC,WAAW,IAAI,IAAI;QAC1B,MAAM,CAAC,WAAW,IAAI,IAAI;KAC3B,EACD,sCAAsC,MAAM,CAAC,WAAW,uBAAuB,MAAM,CAAC,aAAa,kBAAkB,CACtH,CAAC;IAEF,oBAAoB,EAAE,CAAC;IACvB,OAAO,MAAM,CAAC,EAAE,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,EAAqB,EAAE,EAAU;IAC5D,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC;IAClE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAA6B,CAAC;IACrD,OAAO,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,EAAqB,EACrB,UAAkB;IAElB,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,iDAAiD,CAAC,CAAC;IAC3E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAA6B,CAAC;IAC7D,OAAO,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC"}

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

@@ -0,0 +1,72 @@
+/**
+ * Playbook Operations for DatabaseService
+ *
+ * Provides CRUD operations for the playbooks table and clause comparison.
+ * Playbooks define preferred contract terms for deviation detection.
+ *
+ * @module database/playbook-operations
+ */
+import type Database from 'better-sqlite3';
+import type { ContractClause } from '../../clm/contract-schemas.js';
+export type { ContractClause };
+export interface Playbook {
+    id: string;
+    name: string;
+    description: string | null;
+    clauses_json: string;
+    created_at: string;
+    updated_at: string;
+    created_by: string | null;
+}
+export interface PlaybookWithClauses extends Omit<Playbook, 'clauses_json'> {
+    clauses: ContractClause[];
+}
+export interface ClauseComparisonResult {
+    clause_name: string;
+    severity: 'critical' | 'major' | 'minor';
+    status: 'match' | 'alternative_match' | 'deviation' | 'missing';
+    preferred_text: string;
+    matched_text: string | null;
+    matched_chunk_id: string | null;
+    matched_page: number | null;
+    details: string;
+}
+export interface PlaybookComparisonResult {
+    playbook_id: string;
+    playbook_name: string;
+    document_id: string;
+    total_clauses: number;
+    matches: number;
+    alternative_matches: number;
+    deviations: number;
+    missing: number;
+    compliance_score: number;
+    clause_results: ClauseComparisonResult[];
+}
+/**
+ * Create a new playbook with clauses
+ */
+export declare function createPlaybook(db: Database.Database, params: {
+    name: string;
+    description?: string | null;
+    clauses: ContractClause[];
+    created_by?: string | null;
+}): PlaybookWithClauses;
+/**
+ * Get a playbook by ID
+ * @throws Error if not found
+ */
+export declare function getPlaybook(db: Database.Database, id: string): PlaybookWithClauses;
+/**
+ * List all playbooks
+ */
+export declare function listPlaybooks(db: Database.Database): PlaybookWithClauses[];
+/**
+ * Compare document text against a playbook's clauses.
+ *
+ * For each clause in the playbook, searches the document's chunks for matching
+ * content using simple text matching (case-insensitive indexOf). Returns
+ * deviations where neither preferred text nor alternatives are found.
+ */
+export declare function compareWithPlaybook(db: Database.Database, documentId: string, playbookId: string): PlaybookComparisonResult;
+//# sourceMappingURL=playbook-operations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"playbook-operations.d.ts","sourceRoot":"","sources":["../../../../src/services/storage/database/playbook-operations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC;IACzE,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;IACzC,MAAM,EAAE,OAAO,GAAG,mBAAmB,GAAG,WAAW,GAAG,SAAS,CAAC;IAChE,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,sBAAsB,EAAE,CAAC;CAC1C;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE;IACN,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,GACA,mBAAmB,CA2BrB;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,mBAAmB,CAsBlF;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,mBAAmB,EAAE,CAsB1E;AAMD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,wBAAwB,CA8D1B"}