@danielsimonjr/memoryjs 1.0.0 → 1.1.0

package/dist/features/ArchiveManager.js

@@ -1,282 +0,0 @@
-/**
- * Archive Manager
- *
- * Handles archiving (removal) of entities based on criteria.
- * Archives are stored as compressed files for space-efficient long-term storage.
- * Extracted from EntityManager (Phase 4: Consolidate God Objects).
- * Enhanced with brotli compression in Phase 3 Sprint 5.
- *
- * @module features/ArchiveManager
- */
-import { promises as fs } from 'fs';
-import { dirname, join } from 'path';
-import { compress, COMPRESSION_CONFIG, checkCancellation, createProgressReporter, createProgress, } from '../utils/index.js';
-/**
- * Manages archive operations for the knowledge graph.
- *
- * Archives are stored as brotli-compressed files in the `.archives` directory.
- * Maximum compression quality is used for optimal long-term storage.
- */
-export class ArchiveManager {
-    storage;
-    archiveDir;
-    constructor(storage) {
-        this.storage = storage;
-        const filePath = this.storage.getFilePath();
-        const dir = dirname(filePath);
-        this.archiveDir = join(dir, '.archives');
-    }
-    /**
-     * Archive old or low-importance entities.
-     *
-     * Entities matching ANY of the criteria are archived:
-     * - lastModified older than olderThan date
-     * - importance less than importanceLessThan
-     * - has at least one tag from tags array
-     *
-     * By default, archived entities are saved to a compressed file before
-     * being removed from the active graph. Use `saveToFile: false` to
-     * skip creating the archive file.
-     *
-     * Phase 9B: Supports progress tracking and cancellation via options.
-     *
-     * @param criteria - Archiving criteria
-     * @param options - Archive options (dryRun, saveToFile, onProgress, signal)
-     * @returns Archive result with count, entity names, and compression stats
-     * @throws {OperationCancelledError} If operation is cancelled via signal (Phase 9B)
-     *
-     * @example
-     * ```typescript
-     * // Archive old entities with compression
-     * const result = await manager.archiveEntities({
-     *   olderThan: '2023-01-01T00:00:00Z',
-     *   importanceLessThan: 3
-     * });
-     * console.log(`Archived ${result.archived} entities`);
-     * console.log(`Compressed from ${result.originalSize} to ${result.compressedSize} bytes`);
-     *
-     * // Preview without making changes
-     * const preview = await manager.archiveEntities(criteria, { dryRun: true });
-     *
-     * // With progress tracking and cancellation (Phase 9B)
-     * const controller = new AbortController();
-     * const result = await manager.archiveEntities(criteria, {
-     *   signal: controller.signal,
-     *   onProgress: (p) => console.log(`${p.percentage}% complete`),
-     * });
-     * ```
-     */
-    async archiveEntities(criteria, options = {}) {
-        // Handle legacy boolean argument (backward compatibility)
-        const opts = typeof options === 'boolean'
-            ? { dryRun: options, saveToFile: true }
-            : { saveToFile: true, ...options };
-        // Check for early cancellation
-        checkCancellation(opts.signal, 'archiveEntities');
-        // Setup progress reporter
-        const reportProgress = createProgressReporter(opts.onProgress);
-        reportProgress?.(createProgress(0, 100, 'archiveEntities'));
-        // Use read-only graph for analysis
-        const readGraph = await this.storage.loadGraph();
-        const toArchive = [];
-        const totalEntities = readGraph.entities.length;
-        let processedEntities = 0;
-        // Phase 1: Identify entities to archive (0-40% progress)
-        reportProgress?.(createProgress(5, 100, 'analyzing entities'));
-        for (const entity of readGraph.entities) {
-            // Check for cancellation periodically
-            checkCancellation(opts.signal, 'archiveEntities');
-            let shouldArchive = false;
-            // Check age criteria
-            if (criteria.olderThan && entity.lastModified) {
-                const entityDate = new Date(entity.lastModified);
-                const cutoffDate = new Date(criteria.olderThan);
-                if (entityDate < cutoffDate) {
-                    shouldArchive = true;
-                }
-            }
-            // Check importance criteria
-            if (criteria.importanceLessThan !== undefined) {
-                if (entity.importance === undefined || entity.importance < criteria.importanceLessThan) {
-                    shouldArchive = true;
-                }
-            }
-            // Check tag criteria (must have at least one matching tag)
-            if (criteria.tags && criteria.tags.length > 0) {
-                const normalizedCriteriaTags = criteria.tags.map(t => t.toLowerCase());
-                const entityTags = (entity.tags || []).map(t => t.toLowerCase());
-                const hasMatchingTag = normalizedCriteriaTags.some(tag => entityTags.includes(tag));
-                if (hasMatchingTag) {
-                    shouldArchive = true;
-                }
-            }
-            if (shouldArchive) {
-                toArchive.push(entity);
-            }
-            processedEntities++;
-            // Map analysis progress (0-100%) to overall progress (0-40%)
-            const analysisProgress = totalEntities > 0 ? Math.round((processedEntities / totalEntities) * 40) : 40;
-            reportProgress?.(createProgress(analysisProgress, 100, 'analyzing entities'));
-        }
-        reportProgress?.(createProgress(40, 100, 'analysis complete'));
-        // Dry run - return preview without changes
-        if (opts.dryRun) {
-            reportProgress?.(createProgress(100, 100, 'archiveEntities'));
-            return {
-                archived: toArchive.length,
-                entityNames: toArchive.map(e => e.name),
-            };
-        }
-        // No entities to archive
-        if (toArchive.length === 0) {
-            reportProgress?.(createProgress(100, 100, 'archiveEntities'));
-            return {
-                archived: 0,
-                entityNames: [],
-            };
-        }
-        // Check for cancellation before archiving
-        checkCancellation(opts.signal, 'archiveEntities');
-        // Phase 2: Save to compressed archive file (40-80% progress)
-        let archivePath;
-        let originalSize;
-        let compressedSize;
-        let compressionRatio;
-        if (opts.saveToFile) {
-            reportProgress?.(createProgress(50, 100, 'compressing archive'));
-            const archiveResult = await this.saveToArchive(toArchive);
-            archivePath = archiveResult.archivePath;
-            originalSize = archiveResult.originalSize;
-            compressedSize = archiveResult.compressedSize;
-            compressionRatio = archiveResult.compressionRatio;
-            reportProgress?.(createProgress(80, 100, 'archive saved'));
-        }
-        else {
-            reportProgress?.(createProgress(80, 100, 'skipped archive file'));
-        }
-        // Check for cancellation before graph modification
-        checkCancellation(opts.signal, 'archiveEntities');
-        // Phase 3: Remove from main graph (80-100% progress)
-        reportProgress?.(createProgress(85, 100, 'updating graph'));
-        // Get mutable copy for write operation
-        const graph = await this.storage.getGraphForMutation();
-        // Remove archived entities from main graph
-        const archiveNames = new Set(toArchive.map(e => e.name));
-        graph.entities = graph.entities.filter(e => !archiveNames.has(e.name));
-        graph.relations = graph.relations.filter(r => !archiveNames.has(r.from) && !archiveNames.has(r.to));
-        await this.storage.saveGraph(graph);
-        // Report completion
-        reportProgress?.(createProgress(100, 100, 'archiveEntities'));
-        return {
-            archived: toArchive.length,
-            entityNames: toArchive.map(e => e.name),
-            archivePath,
-            originalSize,
-            compressedSize,
-            compressionRatio,
-        };
-    }
-    /**
-     * Save entities to a compressed archive file.
-     *
-     * Creates a brotli-compressed file in the `.archives` directory
-     * with maximum compression quality for space efficiency.
-     *
-     * @param entities - Entities to archive
-     * @returns Archive file path and compression statistics
-     */
-    async saveToArchive(entities) {
-        // Ensure archive directory exists
-        await fs.mkdir(this.archiveDir, { recursive: true });
-        // Generate timestamp-based filename
-        const timestamp = new Date().toISOString()
-            .replace(/:/g, '-')
-            .replace(/\./g, '-')
-            .replace('T', '_')
-            .replace('Z', '');
-        const archivePath = join(this.archiveDir, `archive_${timestamp}.jsonl.br`);
-        // Serialize entities to JSONL format
-        const content = entities.map(e => JSON.stringify(e)).join('\n');
-        // Compress with maximum quality for archives
-        const compressionResult = await compress(content, {
-            quality: COMPRESSION_CONFIG.BROTLI_QUALITY_ARCHIVE,
-            mode: 'text',
-        });
-        // Write compressed archive
-        await fs.writeFile(archivePath, compressionResult.compressed);
-        // Write metadata file
-        const metadataPath = `${archivePath}.meta.json`;
-        const metadata = {
-            timestamp: new Date().toISOString(),
-            entityCount: entities.length,
-            entityNames: entities.map(e => e.name),
-            compressed: true,
-            compressionFormat: 'brotli',
-            originalSize: compressionResult.originalSize,
-            compressedSize: compressionResult.compressedSize,
-            compressionRatio: compressionResult.ratio,
-        };
-        await fs.writeFile(metadataPath, JSON.stringify(metadata, null, 2));
-        return {
-            archivePath,
-            originalSize: compressionResult.originalSize,
-            compressedSize: compressionResult.compressedSize,
-            compressionRatio: compressionResult.ratio,
-        };
-    }
-    /**
-     * List all available archives.
-     *
-     * @returns Array of archive information with compression details
-     */
-    async listArchives() {
-        try {
-            try {
-                await fs.access(this.archiveDir);
-            }
-            catch {
-                return [];
-            }
-            const files = await fs.readdir(this.archiveDir);
-            const archiveFiles = files.filter(f => f.startsWith('archive_') &&
-                (f.endsWith('.jsonl') || f.endsWith('.jsonl.br')) &&
-                !f.endsWith('.meta.json'));
-            const archives = [];
-            for (const fileName of archiveFiles) {
-                const filePath = join(this.archiveDir, fileName);
-                const metadataPath = `${filePath}.meta.json`;
-                try {
-                    const metadataContent = await fs.readFile(metadataPath, 'utf-8');
-                    const metadata = JSON.parse(metadataContent);
-                    archives.push({
-                        fileName,
-                        filePath,
-                        timestamp: metadata.timestamp,
-                        entityCount: metadata.entityCount,
-                        compressed: metadata.compressed ?? fileName.endsWith('.br'),
-                        originalSize: metadata.originalSize,
-                        compressedSize: metadata.compressedSize,
-                        compressionRatio: metadata.compressionRatio,
-                    });
-                }
-                catch {
-                    // Skip archives without valid metadata
-                    continue;
-                }
-            }
-            // Sort by timestamp (newest first)
-            archives.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
-            return archives;
-        }
-        catch {
-            return [];
-        }
-    }
-    /**
-     * Get the path to the archives directory.
-     */
-    getArchiveDir() {
-        return this.archiveDir;
-    }
-}
-//# sourceMappingURL=ArchiveManager.js.map

package/dist/features/ArchiveManager.js.map

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

package/dist/features/CompressionManager.d.ts

@@ -1,119 +0,0 @@
-/**
- * Compression Manager
- *
- * Handles duplicate detection, entity merging, and graph compression.
- * Extracted from SearchManager (Phase 4: Consolidate God Objects).
- *
- * @module features/CompressionManager
- */
-import type { Entity, GraphCompressionResult, KnowledgeGraph, LongRunningOperationOptions } from '../types/index.js';
-import type { GraphStorage } from '../core/GraphStorage.js';
-/**
- * Manages compression operations for the knowledge graph.
- */
-export declare class CompressionManager {
-    private storage;
-    constructor(storage: GraphStorage);
-    /**
-     * Prepare an entity for efficient similarity comparisons.
-     * Pre-computes all normalized data to avoid repeated computation.
-     *
-     * Phase 12 Sprint 1: Added nameHash for fast bucketing.
-     *
-     * @param entity - The entity to prepare
-     * @returns PreparedEntity with pre-computed data including hash
-     */
-    private prepareEntity;
-    /**
-     * Prepare multiple entities for efficient similarity comparisons.
-     * Use this before batch comparison operations.
-     *
-     * @param entities - Entities to prepare
-     * @returns Map of entity name to PreparedEntity
-     */
-    private prepareEntities;
-    /**
-     * Calculate similarity between two entities using multiple heuristics.
-     *
-     * Uses configurable weights defined in SIMILARITY_WEIGHTS constant.
-     * See SIMILARITY_WEIGHTS for the breakdown of scoring factors.
-     *
-     * NOTE: For batch comparisons, use prepareEntities() + calculatePreparedSimilarity() for better performance.
-     *
-     * @param e1 - First entity
-     * @param e2 - Second entity
-     * @returns Similarity score from 0 (completely different) to 1 (identical)
-     */
-    calculateEntitySimilarity(e1: Entity, e2: Entity): number;
-    /**
-     * Efficiently calculate intersection size of two Sets without creating a new Set.
-     * Iterates over the smaller set for O(min(m,n)) complexity.
-     */
-    private setIntersectionSize;
-    /**
-     * Calculate similarity between two prepared entities.
-     * OPTIMIZED: Uses pre-computed Sets to avoid O(n) set creation per comparison.
-     *
-     * @param p1 - First prepared entity
-     * @param p2 - Second prepared entity
-     * @returns Similarity score from 0 (completely different) to 1 (identical)
-     */
-    private calculatePreparedSimilarity;
-    /**
-     * Find duplicate entities in the graph based on similarity threshold.
-     *
-     * OPTIMIZED: Uses bucketing strategies to reduce O(n²) comparisons:
-     * 1. Buckets entities by entityType (only compare same types)
-     * 2. Within each type, buckets by name prefix (first 2 chars normalized)
-     * 3. Only compares entities within same or adjacent buckets
-     *
-     * Phase 9B: Supports progress tracking and cancellation via LongRunningOperationOptions.
-     *
-     * Complexity: O(n·k) where k is average bucket size (typically << n)
-     *
-     * @param threshold - Similarity threshold (0.0 to 1.0), default DEFAULT_DUPLICATE_THRESHOLD
-     * @param options - Optional progress/cancellation options (Phase 9B)
-     * @returns Array of duplicate groups (each group has similar entities)
-     * @throws {OperationCancelledError} If operation is cancelled via signal (Phase 9B)
-     */
-    findDuplicates(threshold?: number, options?: LongRunningOperationOptions): Promise<string[][]>;
-    /**
-     * Merge a group of entities into a single entity.
-     *
-     * Merging strategy:
-     * - First entity is kept (or renamed to targetName)
-     * - Observations: Union of all observations
-     * - Tags: Union of all tags
-     * - Importance: Maximum importance value
-     * - createdAt: Earliest date
-     * - lastModified: Current timestamp
-     * - Relations: Redirected to kept entity, duplicates removed
-     *
-     * @param entityNames - Names of entities to merge (first one is kept)
-     * @param targetName - Optional new name for merged entity (default: first entity name)
-     * @param options - Optional configuration
-     * @param options.graph - Pre-loaded graph to use (avoids reload)
-     * @param options.skipSave - If true, don't save (caller will save)
-     * @returns The merged entity
-     * @throws {InsufficientEntitiesError} If less than 2 entities provided
-     * @throws {EntityNotFoundError} If any entity not found
-     */
-    mergeEntities(entityNames: string[], targetName?: string, options?: {
-        graph?: KnowledgeGraph;
-        skipSave?: boolean;
-    }): Promise<Entity>;
-    /**
-     * Compress the knowledge graph by finding and merging duplicates.
-     * OPTIMIZED: Loads graph once, performs all merges, saves once.
-     *
-     * Phase 9B: Supports progress tracking and cancellation via LongRunningOperationOptions.
-     *
-     * @param threshold - Similarity threshold for duplicate detection (0.0 to 1.0), default DEFAULT_DUPLICATE_THRESHOLD
-     * @param dryRun - If true, only report what would be compressed without applying changes
-     * @param options - Optional progress/cancellation options (Phase 9B)
-     * @returns Compression result with statistics
-     * @throws {OperationCancelledError} If operation is cancelled via signal (Phase 9B)
-     */
-    compressGraph(threshold?: number, dryRun?: boolean, options?: LongRunningOperationOptions): Promise<GraphCompressionResult>;
-}
-//# sourceMappingURL=CompressionManager.d.ts.map

package/dist/features/CompressionManager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CompressionManager.d.ts","sourceRoot":"","sources":["../../src/features/CompressionManager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAY,sBAAsB,EAAE,cAAc,EAAE,2BAA2B,EAAkB,MAAM,mBAAmB,CAAC;AAC/I,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAW5D;;GAEG;AACH,qBAAa,kBAAkB;IACjB,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,YAAY;IAEzC;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IAYrB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAQvB;;;;;;;;;;;OAWG;IACH,yBAAyB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM;IAwCzD;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;;;;;;OAOG;IACH,OAAO,CAAC,2BAA2B;IAoCnC;;;;;;;;;;;;;;;;OAgBG;IACG,cAAc,CAClB,SAAS,GAAE,MAAoC,EAC/C,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IA0GtB;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EAAE,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,cAAc,CAAC;QACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACf,GACL,OAAO,CAAC,MAAM,CAAC;IA8FlB;;;;;;;;;;;OAWG;IACG,aAAa,CACjB,SAAS,GAAE,MAAoC,EAC/C,MAAM,GAAE,OAAe,EACvB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,sBAAsB,CAAC;CAgHnC"}