ocr-provenance-mcp 1.0.0

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

@@ -0,0 +1,394 @@
+/**
+ * Statistics operations for DatabaseService
+ *
+ * Handles database statistics retrieval.
+ */
+import { statSync } from 'fs';
+/**
+ * Get database statistics
+ *
+ * @param db - Database connection
+ * @param name - Database name
+ * @param path - Database file path
+ * @returns DatabaseStats - Live statistics from database
+ */
+export function getStats(db, name, path) {
+    const docStats = db
+        .prepare(`
+    SELECT
+      COUNT(*) FILTER (WHERE status = 'pending') as pending,
+      COUNT(*) FILTER (WHERE status = 'processing') as processing,
+      COUNT(*) FILTER (WHERE status = 'complete') as complete,
+      COUNT(*) FILTER (WHERE status = 'failed') as failed,
+      COUNT(*) as total
+    FROM documents
+  `)
+        .get();
+    const chunkStats = db
+        .prepare(`
+    SELECT
+      COUNT(*) FILTER (WHERE embedding_status = 'pending') as pending,
+      COUNT(*) FILTER (WHERE embedding_status = 'complete') as complete,
+      COUNT(*) FILTER (WHERE embedding_status = 'failed') as failed,
+      COUNT(*) as total
+    FROM chunks
+  `)
+        .get();
+    const otherCounts = db
+        .prepare(`
+    SELECT
+      (SELECT COUNT(*) FROM ocr_results) as ocr_count,
+      (SELECT COUNT(*) FROM embeddings) as embedding_count,
+      (SELECT COUNT(*) FROM provenance) as provenance_count,
+      (SELECT COUNT(*) FROM images) as image_count,
+      (SELECT COUNT(*) FROM extractions) as extraction_count,
+      (SELECT COUNT(*) FROM form_fills) as form_fill_count,
+      (SELECT COUNT(*) FROM comparisons) as comparison_count,
+      (SELECT COUNT(*) FROM clusters) as cluster_count
+  `)
+        .get();
+    const embeddingCount = otherCounts.embedding_count;
+    const qualityCosts = db
+        .prepare(`
+    SELECT
+      (SELECT AVG(parse_quality_score) FROM ocr_results WHERE parse_quality_score IS NOT NULL) as avg_quality,
+      (SELECT MIN(parse_quality_score) FROM ocr_results WHERE parse_quality_score IS NOT NULL) as min_quality,
+      (SELECT MAX(parse_quality_score) FROM ocr_results WHERE parse_quality_score IS NOT NULL) as max_quality,
+      (SELECT COUNT(parse_quality_score) FROM ocr_results WHERE parse_quality_score IS NOT NULL) as quality_count,
+      (SELECT COALESCE(SUM(cost_cents), 0) FROM ocr_results) as total_ocr_cost,
+      (SELECT COALESCE(SUM(cost_cents), 0) FROM form_fills) as total_form_fill_cost
+  `)
+        .get();
+    const stats = statSync(path);
+    const avgChunksPerDocument = docStats.total > 0 ? chunkStats.total / docStats.total : 0;
+    const avgEmbeddingsPerChunk = chunkStats.total > 0 ? embeddingCount / chunkStats.total : 0;
+    return {
+        name,
+        total_documents: docStats.total,
+        documents_by_status: {
+            pending: docStats.pending,
+            processing: docStats.processing,
+            complete: docStats.complete,
+            failed: docStats.failed,
+        },
+        total_ocr_results: otherCounts.ocr_count,
+        total_chunks: chunkStats.total,
+        chunks_by_embedding_status: {
+            pending: chunkStats.pending,
+            complete: chunkStats.complete,
+            failed: chunkStats.failed,
+        },
+        total_embeddings: embeddingCount,
+        total_images: otherCounts.image_count,
+        total_extractions: otherCounts.extraction_count,
+        total_form_fills: otherCounts.form_fill_count,
+        total_comparisons: otherCounts.comparison_count,
+        total_clusters: otherCounts.cluster_count,
+        total_provenance: otherCounts.provenance_count,
+        storage_size_bytes: stats.size,
+        avg_chunks_per_document: avgChunksPerDocument,
+        avg_embeddings_per_chunk: avgEmbeddingsPerChunk,
+        ocr_quality: {
+            avg: qualityCosts.avg_quality,
+            min: qualityCosts.min_quality,
+            max: qualityCosts.max_quality,
+            scored_count: qualityCosts.quality_count,
+        },
+        costs: {
+            total_ocr_cost_cents: qualityCosts.total_ocr_cost,
+            total_form_fill_cost_cents: qualityCosts.total_form_fill_cost,
+            total_cost_cents: qualityCosts.total_ocr_cost + qualityCosts.total_form_fill_cost,
+        },
+    };
+}
+/**
+ * Update metadata counts from actual table counts
+ *
+ * @param db - Database connection
+ */
+export function updateMetadataCounts(db) {
+    const now = new Date().toISOString();
+    // M-2: Single query for all counts instead of 4 separate COUNT(*) scans
+    const counts = db
+        .prepare(`
+    SELECT
+      (SELECT COUNT(*) FROM documents) as doc_count,
+      (SELECT COUNT(*) FROM ocr_results) as ocr_count,
+      (SELECT COUNT(*) FROM chunks) as chunk_count,
+      (SELECT COUNT(*) FROM embeddings) as emb_count
+  `)
+        .get();
+    db.prepare(`
+    UPDATE database_metadata
+    SET total_documents = ?, total_ocr_results = ?, total_chunks = ?,
+        total_embeddings = ?, last_modified_at = ?
+    WHERE id = 1
+  `).run(counts.doc_count, counts.ocr_count, counts.chunk_count, counts.emb_count, now);
+}
+/**
+ * Update metadata last_modified_at timestamp
+ *
+ * @param db - Database connection
+ */
+export function updateMetadataModified(db) {
+    const now = new Date().toISOString();
+    const stmt = db.prepare(`
+    UPDATE database_metadata SET last_modified_at = ? WHERE id = 1
+  `);
+    stmt.run(now);
+}
+/**
+ * Get strftime format string for the given bucket type
+ */
+function getBucketFormat(bucket) {
+    switch (bucket) {
+        case 'hourly':
+            return '%Y-%m-%d %H:00';
+        case 'daily':
+            return '%Y-%m-%d';
+        case 'weekly':
+            return '%Y-W%W';
+        case 'monthly':
+            return '%Y-%m';
+    }
+}
+/** Whitelist of valid table names for timeline stats queries */
+const VALID_TIMELINE_TABLES = new Set(['documents', 'chunks', 'embeddings', 'images', 'ocr_results']);
+/** Whitelist of valid date column names for timeline stats queries */
+const VALID_DATE_COLUMNS = new Set(['created_at', 'processing_completed_at']);
+/**
+ * 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 function getTimelineStats(db, options) {
+    const format = getBucketFormat(options.bucket);
+    const conditions = [];
+    const params = [];
+    // Build metric-specific query
+    let table;
+    let dateColumn;
+    let selectExpr;
+    switch (options.metric) {
+        case 'documents':
+            table = 'documents';
+            dateColumn = 'created_at';
+            selectExpr = 'COUNT(*) as count';
+            break;
+        case 'pages':
+            table = 'documents';
+            dateColumn = 'created_at';
+            selectExpr = 'COALESCE(SUM(page_count), 0) as count';
+            break;
+        case 'chunks':
+            table = 'chunks';
+            dateColumn = 'created_at';
+            selectExpr = 'COUNT(*) as count';
+            break;
+        case 'embeddings':
+            table = 'embeddings';
+            dateColumn = 'created_at';
+            selectExpr = 'COUNT(*) as count';
+            break;
+        case 'images':
+            table = 'images';
+            dateColumn = 'created_at';
+            selectExpr = 'COUNT(*) as count';
+            break;
+        case 'cost':
+            table = 'ocr_results';
+            dateColumn = 'processing_completed_at';
+            selectExpr = 'COALESCE(SUM(cost_cents), 0) as count';
+            break;
+    }
+    // Whitelist validation for SQL-interpolated identifiers
+    if (!VALID_TIMELINE_TABLES.has(table)) {
+        throw new Error(`Invalid timeline table: ${table}`);
+    }
+    if (!VALID_DATE_COLUMNS.has(dateColumn)) {
+        throw new Error(`Invalid date column: ${dateColumn}`);
+    }
+    if (options.created_after) {
+        conditions.push(`${dateColumn} >= ?`);
+        params.push(options.created_after);
+    }
+    if (options.created_before) {
+        conditions.push(`${dateColumn} <= ?`);
+        params.push(options.created_before);
+    }
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+    const sql = `
+    SELECT
+      strftime('${format}', ${dateColumn}) as period,
+      ${selectExpr}
+    FROM ${table}
+    ${whereClause}
+    GROUP BY period
+    ORDER BY period ASC
+  `;
+    const rows = db.prepare(sql).all(...params);
+    // Filter out null periods (rows with null dateColumn values)
+    return rows
+        .filter((r) => r.period !== null)
+        .map((r) => ({
+        period: r.period,
+        count: r.count,
+    }));
+}
+/**
+ * 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 function getQualityTrends(db, options) {
+    const format = getBucketFormat(options.bucket);
+    const groupBy = options.group_by || 'none';
+    // Whitelist validation for group_by parameter (used in SQL branching)
+    const VALID_GROUP_BY = new Set(['none', 'ocr_mode', 'processor']);
+    if (!VALID_GROUP_BY.has(groupBy)) {
+        throw new Error(`Invalid group_by value: ${groupBy}`);
+    }
+    const conditions = [];
+    const params = [];
+    if (groupBy === 'processor') {
+        // Use provenance table for processor grouping
+        conditions.push('processing_quality_score IS NOT NULL');
+        if (options.created_after) {
+            conditions.push('created_at >= ?');
+            params.push(options.created_after);
+        }
+        if (options.created_before) {
+            conditions.push('created_at <= ?');
+            params.push(options.created_before);
+        }
+        const whereClause = `WHERE ${conditions.join(' AND ')}`;
+        const sql = `
+      SELECT
+        strftime('${format}', created_at) as period,
+        processor as grp,
+        AVG(processing_quality_score) as avg_quality,
+        MIN(processing_quality_score) as min_quality,
+        MAX(processing_quality_score) as max_quality,
+        COUNT(*) as sample_count
+      FROM provenance
+      ${whereClause}
+      GROUP BY period, grp
+      ORDER BY period ASC, grp ASC
+    `;
+        const rows = db.prepare(sql).all(...params);
+        return rows
+            .filter((r) => r.period !== null)
+            .map((r) => ({
+            period: r.period,
+            avg_quality: Math.round(r.avg_quality * 100) / 100,
+            min_quality: Math.round(r.min_quality * 100) / 100,
+            max_quality: Math.round(r.max_quality * 100) / 100,
+            sample_count: r.sample_count,
+            group: r.grp,
+        }));
+    }
+    else {
+        // Use ocr_results table for no grouping or ocr_mode grouping
+        conditions.push('parse_quality_score IS NOT NULL');
+        if (options.created_after) {
+            conditions.push('processing_completed_at >= ?');
+            params.push(options.created_after);
+        }
+        if (options.created_before) {
+            conditions.push('processing_completed_at <= ?');
+            params.push(options.created_before);
+        }
+        const whereClause = `WHERE ${conditions.join(' AND ')}`;
+        const groupByColumn = groupBy === 'ocr_mode' ? ', datalab_mode' : '';
+        const selectGroup = groupBy === 'ocr_mode' ? ', datalab_mode as grp' : '';
+        const sql = `
+      SELECT
+        strftime('${format}', processing_completed_at) as period
+        ${selectGroup},
+        AVG(parse_quality_score) as avg_quality,
+        MIN(parse_quality_score) as min_quality,
+        MAX(parse_quality_score) as max_quality,
+        COUNT(*) as sample_count
+      FROM ocr_results
+      ${whereClause}
+      GROUP BY period${groupByColumn}
+      ORDER BY period ASC${groupBy === 'ocr_mode' ? ', grp ASC' : ''}
+    `;
+        const rows = db.prepare(sql).all(...params);
+        return rows
+            .filter((r) => r.period !== null)
+            .map((r) => ({
+            period: r.period,
+            avg_quality: Math.round(r.avg_quality * 100) / 100,
+            min_quality: Math.round(r.min_quality * 100) / 100,
+            max_quality: Math.round(r.max_quality * 100) / 100,
+            sample_count: r.sample_count,
+            ...(groupBy === 'ocr_mode' && r.grp !== undefined ? { group: r.grp } : {}),
+        }));
+    }
+}
+/**
+ * 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 function getThroughputAnalytics(db, options) {
+    const format = getBucketFormat(options.bucket);
+    const conditions = [];
+    const params = [];
+    if (options.created_after) {
+        conditions.push('p.created_at >= ?');
+        params.push(options.created_after);
+    }
+    if (options.created_before) {
+        conditions.push('p.created_at <= ?');
+        params.push(options.created_before);
+    }
+    const extraWhere = conditions.length > 0 ? `AND ${conditions.join(' AND ')}` : '';
+    // Use a single query with conditional aggregation across types
+    const sql = `
+    SELECT
+      strftime('${format}', p.created_at) as period,
+      COALESCE(SUM(CASE WHEN p.type = 'OCR_RESULT' THEN 1 ELSE 0 END), 0) as pages_processed,
+      COALESCE(SUM(CASE WHEN p.type = 'EMBEDDING' THEN 1 ELSE 0 END), 0) as embeddings_generated,
+      COALESCE(SUM(CASE WHEN p.type = 'IMAGE' THEN 1 ELSE 0 END), 0) as images_processed,
+      COALESCE(SUM(CASE WHEN p.type = 'OCR_RESULT' THEN p.processing_duration_ms ELSE 0 END), 0) as total_ocr_duration_ms,
+      COALESCE(SUM(CASE WHEN p.type = 'EMBEDDING' THEN p.processing_duration_ms ELSE 0 END), 0) as total_embedding_duration_ms
+    FROM provenance p
+    WHERE p.type IN ('OCR_RESULT', 'EMBEDDING', 'IMAGE')
+      ${extraWhere}
+    GROUP BY period
+    ORDER BY period ASC
+  `;
+    // Duplicate params for each condition usage (they apply once)
+    const rows = db.prepare(sql).all(...params);
+    return rows
+        .filter((r) => r.period !== null)
+        .map((r) => ({
+        period: r.period,
+        pages_processed: r.pages_processed,
+        embeddings_generated: r.embeddings_generated,
+        images_processed: r.images_processed,
+        total_ocr_duration_ms: r.total_ocr_duration_ms,
+        total_embedding_duration_ms: r.total_embedding_duration_ms,
+        avg_ms_per_page: r.pages_processed > 0
+            ? Math.round((r.total_ocr_duration_ms / r.pages_processed) * 100) / 100
+            : 0,
+        avg_ms_per_embedding: r.embeddings_generated > 0
+            ? Math.round((r.total_embedding_duration_ms / r.embeddings_generated) * 100) / 100
+            : 0,
+    }));
+}
+//# sourceMappingURL=stats-operations.js.map

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

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

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

@@ -0,0 +1,76 @@
+/**
+ * Tag Operations for DatabaseService
+ *
+ * Provides CRUD operations for tags and entity_tags tables.
+ * Tags are user-defined annotations for cross-entity tagging.
+ *
+ * @module database/tag-operations
+ */
+import type Database from 'better-sqlite3';
+export interface Tag {
+    id: string;
+    name: string;
+    description: string | null;
+    color: string | null;
+    created_at: string;
+}
+export interface TagWithCount extends Tag {
+    usage_count: number;
+}
+export interface EntityTagResult {
+    entity_id: string;
+    entity_type: string;
+    tags: string[];
+}
+export declare const VALID_ENTITY_TYPES: readonly ["document", "chunk", "image", "extraction", "cluster"];
+export type EntityType = (typeof VALID_ENTITY_TYPES)[number];
+/**
+ * Create a new tag
+ * @throws Error if tag name already exists
+ */
+export declare function createTag(db: Database.Database, tag: {
+    name: string;
+    description?: string;
+    color?: string;
+}): Tag;
+/**
+ * Get a tag by its name
+ */
+export declare function getTagByName(db: Database.Database, name: string): Tag | null;
+/**
+ * Get all tags
+ */
+export declare function getAllTags(db: Database.Database): Tag[];
+/**
+ * Get all tags with usage counts
+ */
+export declare function getTagsWithCounts(db: Database.Database): TagWithCount[];
+/**
+ * Apply a tag to an entity
+ * @returns The entity_tags record ID
+ * @throws Error if tag/entity_tag combination already exists
+ */
+export declare function applyTag(db: Database.Database, tagId: string, entityId: string, entityType: string): string;
+/**
+ * Remove a tag from an entity
+ * @returns true if a row was deleted, false if nothing to remove
+ */
+export declare function removeTag(db: Database.Database, tagId: string, entityId: string, entityType: string): boolean;
+/**
+ * Get all tags for an entity
+ */
+export declare function getTagsForEntity(db: Database.Database, entityId: string, entityType: string): Tag[];
+/**
+ * Search for entities that have specified tags
+ *
+ * @param tagNames - Array of tag names to search for
+ * @param entityType - Optional filter by entity type
+ * @param matchAll - If true, entity must have ALL tags. If false, ANY tag matches.
+ */
+export declare function searchByTags(db: Database.Database, tagNames: string[], entityType?: string, matchAll?: boolean): EntityTagResult[];
+/**
+ * Delete a tag and all its entity associations (CASCADE)
+ * @returns The number of entity_tag associations that were removed
+ */
+export declare function deleteTag(db: Database.Database, tagId: string): number;
+//# sourceMappingURL=tag-operations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tag-operations.d.ts","sourceRoot":"","sources":["../../../../src/services/storage/database/tag-operations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAO3C,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAa,SAAQ,GAAG;IACvC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAGD,eAAO,MAAM,kBAAkB,kEAAmE,CAAC;AACnG,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAM7D;;;GAGG;AACH,wBAAgB,SAAS,CACvB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,GAAG,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D,GAAG,CAuBL;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAG5E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,GAAG,EAAE,CAEvD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,YAAY,EAAE,CAWvE;AAMD;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAmBR;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAOT;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,GAAG,EAAE,CAUP;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,MAAM,EAAE,EAClB,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,OAAO,GACjB,eAAe,EAAE,CAsDnB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAatE"}

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

@@ -0,0 +1,178 @@
+/**
+ * Tag Operations for DatabaseService
+ *
+ * Provides CRUD operations for tags and entity_tags tables.
+ * Tags are user-defined annotations for cross-entity tagging.
+ *
+ * @module database/tag-operations
+ */
+import { v4 as uuidv4 } from 'uuid';
+// Valid entity types for tagging
+export const VALID_ENTITY_TYPES = ['document', 'chunk', 'image', 'extraction', 'cluster'];
+// ═══════════════════════════════════════════════════════════════════════════════
+// TAG CRUD
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Create a new tag
+ * @throws Error if tag name already exists
+ */
+export function createTag(db, tag) {
+    const id = uuidv4();
+    const now = new Date().toISOString();
+    try {
+        db.prepare(`INSERT INTO tags (id, name, description, color, created_at)
+       VALUES (?, ?, ?, ?, ?)`).run(id, tag.name, tag.description ?? null, tag.color ?? null, now);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('UNIQUE constraint failed')) {
+            throw new Error(`Tag with name "${tag.name}" already exists`);
+        }
+        throw error;
+    }
+    return {
+        id,
+        name: tag.name,
+        description: tag.description ?? null,
+        color: tag.color ?? null,
+        created_at: now,
+    };
+}
+/**
+ * Get a tag by its name
+ */
+export function getTagByName(db, name) {
+    const row = db.prepare('SELECT * FROM tags WHERE name = ?').get(name);
+    return row ?? null;
+}
+/**
+ * Get all tags
+ */
+export function getAllTags(db) {
+    return db.prepare('SELECT * FROM tags ORDER BY name LIMIT 10000').all();
+}
+/**
+ * Get all tags with usage counts
+ */
+export function getTagsWithCounts(db) {
+    return db
+        .prepare(`SELECT t.*, COUNT(et.id) as usage_count
+       FROM tags t
+       LEFT JOIN entity_tags et ON et.tag_id = t.id
+       GROUP BY t.id
+       ORDER BY t.name
+       LIMIT 10000`)
+        .all();
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// ENTITY TAG OPERATIONS
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Apply a tag to an entity
+ * @returns The entity_tags record ID
+ * @throws Error if tag/entity_tag combination already exists
+ */
+export function applyTag(db, tagId, entityId, entityType) {
+    const id = uuidv4();
+    const now = new Date().toISOString();
+    try {
+        db.prepare(`INSERT INTO entity_tags (id, tag_id, entity_id, entity_type, created_at)
+       VALUES (?, ?, ?, ?, ?)`).run(id, tagId, entityId, entityType, now);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('UNIQUE constraint failed')) {
+            throw new Error(`Tag is already applied to this ${entityType} (entity_id: ${entityId})`);
+        }
+        throw error;
+    }
+    return id;
+}
+/**
+ * Remove a tag from an entity
+ * @returns true if a row was deleted, false if nothing to remove
+ */
+export function removeTag(db, tagId, entityId, entityType) {
+    const result = db
+        .prepare(`DELETE FROM entity_tags WHERE tag_id = ? AND entity_id = ? AND entity_type = ?`)
+        .run(tagId, entityId, entityType);
+    return result.changes > 0;
+}
+/**
+ * Get all tags for an entity
+ */
+export function getTagsForEntity(db, entityId, entityType) {
+    return db
+        .prepare(`SELECT t.*
+       FROM tags t
+       INNER JOIN entity_tags et ON et.tag_id = t.id
+       WHERE et.entity_id = ? AND et.entity_type = ?
+       ORDER BY t.name`)
+        .all(entityId, entityType);
+}
+/**
+ * Search for entities that have specified tags
+ *
+ * @param tagNames - Array of tag names to search for
+ * @param entityType - Optional filter by entity type
+ * @param matchAll - If true, entity must have ALL tags. If false, ANY tag matches.
+ */
+export function searchByTags(db, tagNames, entityType, matchAll) {
+    if (tagNames.length === 0) {
+        return [];
+    }
+    const placeholders = tagNames.map(() => '?').join(',');
+    const params = [...tagNames];
+    let entityTypeClause = '';
+    if (entityType) {
+        entityTypeClause = 'AND et.entity_type = ?';
+        params.push(entityType);
+    }
+    const havingClause = matchAll
+        ? `HAVING COUNT(DISTINCT t.name) = ?`
+        : '';
+    if (matchAll) {
+        params.push(tagNames.length);
+    }
+    const sql = `
+    SELECT et.entity_id, et.entity_type,
+      (SELECT JSON_GROUP_ARRAY(sub.name) FROM (
+        SELECT DISTINCT t2.name
+        FROM tags t2
+        INNER JOIN entity_tags et2 ON et2.tag_id = t2.id
+        WHERE et2.entity_id = et.entity_id AND et2.entity_type = et.entity_type
+        AND t2.name IN (${placeholders})
+      ) sub) as tag_names
+    FROM entity_tags et
+    INNER JOIN tags t ON t.id = et.tag_id
+    WHERE t.name IN (${placeholders})
+    ${entityTypeClause}
+    GROUP BY et.entity_id, et.entity_type
+    ${havingClause}
+    ORDER BY et.entity_id
+    LIMIT 10000
+  `;
+    // Parameters: tagNames for subquery IN, then tagNames + entityType? + matchCount? for outer query
+    const allParams = [...tagNames, ...params];
+    const rows = db.prepare(sql).all(...allParams);
+    return rows.map((row) => ({
+        entity_id: row.entity_id,
+        entity_type: row.entity_type,
+        tags: JSON.parse(row.tag_names),
+    }));
+}
+/**
+ * Delete a tag and all its entity associations (CASCADE)
+ * @returns The number of entity_tag associations that were removed
+ */
+export function deleteTag(db, tagId) {
+    // Count associations before delete (CASCADE will remove them)
+    const countRow = db
+        .prepare('SELECT COUNT(*) as cnt FROM entity_tags WHERE tag_id = ?')
+        .get(tagId);
+    const associationCount = countRow.cnt;
+    const result = db.prepare('DELETE FROM tags WHERE id = ?').run(tagId);
+    if (result.changes === 0) {
+        throw new Error(`Tag not found: ${tagId}`);
+    }
+    return associationCount;
+}
+//# sourceMappingURL=tag-operations.js.map

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

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