@danielsimonjr/memory-mcp 12.2.3 → 12.5.2

package/dist/search/SavedSearchManager.d.ts

@@ -1,79 +0,0 @@
-/**
- * Saved Search Manager
- *
- * Manages persistent saved searches with JSONL storage.
- *
- * @module search/SavedSearchManager
- */
-import type { SavedSearch, KnowledgeGraph } from '../types/index.js';
-import type { BasicSearch } from './BasicSearch.js';
-/**
- * Manages saved search queries with usage tracking.
- */
-export declare class SavedSearchManager {
-    private savedSearchesFilePath;
-    private basicSearch;
-    constructor(savedSearchesFilePath: string, basicSearch: BasicSearch);
-    /**
-     * Load all saved searches from JSONL file.
-     *
-     * @returns Array of saved searches
-     */
-    private loadSavedSearches;
-    /**
-     * Save searches to JSONL file.
-     *
-     * @param searches - Array of saved searches
-     */
-    private saveSavedSearches;
-    /**
-     * Save a search query for later reuse.
-     *
-     * @param search - Search parameters (without createdAt, useCount, lastUsed)
-     * @returns The newly created saved search
-     * @throws Error if search name already exists
-     */
-    saveSearch(search: Omit<SavedSearch, 'createdAt' | 'useCount' | 'lastUsed'>): Promise<SavedSearch>;
-    /**
-     * List all saved searches.
-     *
-     * @returns Array of all saved searches
-     */
-    listSavedSearches(): Promise<SavedSearch[]>;
-    /**
-     * Get a specific saved search by name.
-     *
-     * @param name - Search name
-     * @returns Saved search or null if not found
-     */
-    getSavedSearch(name: string): Promise<SavedSearch | null>;
-    /**
-     * Execute a saved search by name.
-     *
-     * Updates usage statistics (lastUsed, useCount) before executing.
-     *
-     * @param name - Search name
-     * @returns Search results as knowledge graph
-     * @throws Error if search not found
-     */
-    executeSavedSearch(name: string): Promise<KnowledgeGraph>;
-    /**
-     * Delete a saved search.
-     *
-     * @param name - Search name
-     * @returns True if deleted, false if not found
-     */
-    deleteSavedSearch(name: string): Promise<boolean>;
-    /**
-     * Update a saved search.
-     *
-     * Cannot update name, createdAt, useCount, or lastUsed fields.
-     *
-     * @param name - Search name
-     * @param updates - Partial search with fields to update
-     * @returns Updated saved search
-     * @throws Error if search not found
-     */
-    updateSavedSearch(name: string, updates: Partial<Omit<SavedSearch, 'name' | 'createdAt' | 'useCount' | 'lastUsed'>>): Promise<SavedSearch>;
-}
-//# sourceMappingURL=SavedSearchManager.d.ts.map

package/dist/search/SavedSearchManager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SavedSearchManager.d.ts","sourceRoot":"","sources":["../../src/search/SavedSearchManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;GAEG;AACH,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,qBAAqB;IAC7B,OAAO,CAAC,WAAW;gBADX,qBAAqB,EAAE,MAAM,EAC7B,WAAW,EAAE,WAAW;IAGlC;;;;OAIG;YACW,iBAAiB;IAa/B;;;;OAIG;YACW,iBAAiB;IAK/B;;;;;;OAMG;IACG,UAAU,CACd,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC,GAC/D,OAAO,CAAC,WAAW,CAAC;IAoBvB;;;;OAIG;IACG,iBAAiB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAIjD;;;;;OAKG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK/D;;;;;;;;OAQG;IACG,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAsB/D;;;;;OAKG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAavD;;;;;;;;;OASG;IACG,iBAAiB,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC,GAClF,OAAO,CAAC,WAAW,CAAC;CAcxB"}

package/dist/search/SavedSearchManager.js

@@ -1,145 +0,0 @@
-/**
- * Saved Search Manager
- *
- * Manages persistent saved searches with JSONL storage.
- *
- * @module search/SavedSearchManager
- */
-import * as fs from 'fs/promises';
-/**
- * Manages saved search queries with usage tracking.
- */
-export class SavedSearchManager {
-    savedSearchesFilePath;
-    basicSearch;
-    constructor(savedSearchesFilePath, basicSearch) {
-        this.savedSearchesFilePath = savedSearchesFilePath;
-        this.basicSearch = basicSearch;
-    }
-    /**
-     * Load all saved searches from JSONL file.
-     *
-     * @returns Array of saved searches
-     */
-    async loadSavedSearches() {
-        try {
-            const data = await fs.readFile(this.savedSearchesFilePath, 'utf-8');
-            const lines = data.split('\n').filter((line) => line.trim() !== '');
-            return lines.map((line) => JSON.parse(line));
-        }
-        catch (error) {
-            if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
-                return [];
-            }
-            throw error;
-        }
-    }
-    /**
-     * Save searches to JSONL file.
-     *
-     * @param searches - Array of saved searches
-     */
-    async saveSavedSearches(searches) {
-        const lines = searches.map(s => JSON.stringify(s));
-        await fs.writeFile(this.savedSearchesFilePath, lines.join('\n'));
-    }
-    /**
-     * Save a search query for later reuse.
-     *
-     * @param search - Search parameters (without createdAt, useCount, lastUsed)
-     * @returns The newly created saved search
-     * @throws Error if search name already exists
-     */
-    async saveSearch(search) {
-        const searches = await this.loadSavedSearches();
-        // Check if name already exists
-        if (searches.some(s => s.name === search.name)) {
-            throw new Error(`Saved search with name "${search.name}" already exists`);
-        }
-        const newSearch = {
-            ...search,
-            createdAt: new Date().toISOString(),
-            useCount: 0,
-        };
-        searches.push(newSearch);
-        await this.saveSavedSearches(searches);
-        return newSearch;
-    }
-    /**
-     * List all saved searches.
-     *
-     * @returns Array of all saved searches
-     */
-    async listSavedSearches() {
-        return await this.loadSavedSearches();
-    }
-    /**
-     * Get a specific saved search by name.
-     *
-     * @param name - Search name
-     * @returns Saved search or null if not found
-     */
-    async getSavedSearch(name) {
-        const searches = await this.loadSavedSearches();
-        return searches.find(s => s.name === name) || null;
-    }
-    /**
-     * Execute a saved search by name.
-     *
-     * Updates usage statistics (lastUsed, useCount) before executing.
-     *
-     * @param name - Search name
-     * @returns Search results as knowledge graph
-     * @throws Error if search not found
-     */
-    async executeSavedSearch(name) {
-        const searches = await this.loadSavedSearches();
-        const search = searches.find(s => s.name === name);
-        if (!search) {
-            throw new Error(`Saved search "${name}" not found`);
-        }
-        // Update usage statistics
-        search.lastUsed = new Date().toISOString();
-        search.useCount++;
-        await this.saveSavedSearches(searches);
-        // Execute the search using BasicSearch
-        return await this.basicSearch.searchNodes(search.query, search.tags, search.minImportance, search.maxImportance);
-    }
-    /**
-     * Delete a saved search.
-     *
-     * @param name - Search name
-     * @returns True if deleted, false if not found
-     */
-    async deleteSavedSearch(name) {
-        const searches = await this.loadSavedSearches();
-        const initialLength = searches.length;
-        const filtered = searches.filter(s => s.name !== name);
-        if (filtered.length === initialLength) {
-            return false; // Search not found
-        }
-        await this.saveSavedSearches(filtered);
-        return true;
-    }
-    /**
-     * Update a saved search.
-     *
-     * Cannot update name, createdAt, useCount, or lastUsed fields.
-     *
-     * @param name - Search name
-     * @param updates - Partial search with fields to update
-     * @returns Updated saved search
-     * @throws Error if search not found
-     */
-    async updateSavedSearch(name, updates) {
-        const searches = await this.loadSavedSearches();
-        const search = searches.find(s => s.name === name);
-        if (!search) {
-            throw new Error(`Saved search "${name}" not found`);
-        }
-        // Apply updates
-        Object.assign(search, updates);
-        await this.saveSavedSearches(searches);
-        return search;
-    }
-}

package/dist/search/SearchFilterChain.d.ts

@@ -1,120 +0,0 @@
-/**
- * Search Filter Chain
- *
- * Centralizes filter logic for all search implementations to eliminate
- * duplicate filtering code across BasicSearch, BooleanSearch, FuzzySearch,
- * and RankedSearch.
- *
- * @module search/SearchFilterChain
- */
-import type { Entity } from '../types/index.js';
-import { type ValidatedPagination } from '../utils/index.js';
-/**
- * Search filter configuration options.
- * All filters are optional - entities pass if filter is not specified.
- */
-export interface SearchFilters {
-    /** Tags to filter by (any match) */
-    tags?: string[];
-    /** Minimum importance (0-10, inclusive) */
-    minImportance?: number;
-    /** Maximum importance (0-10, inclusive) */
-    maxImportance?: number;
-    /** Entity type to filter by (exact match) */
-    entityType?: string;
-    /** Created after date (ISO 8601, inclusive) */
-    createdAfter?: string;
-    /** Created before date (ISO 8601, inclusive) */
-    createdBefore?: string;
-    /** Modified after date (ISO 8601, inclusive) */
-    modifiedAfter?: string;
-    /** Modified before date (ISO 8601, inclusive) */
-    modifiedBefore?: string;
-}
-/**
- * Centralized filter chain for all search implementations.
- * Ensures consistent filtering behavior across search types.
- *
- * @example
- * ```typescript
- * const filters: SearchFilters = { tags: ['important'], minImportance: 5 };
- * const filtered = SearchFilterChain.applyFilters(entities, filters);
- * const pagination = SearchFilterChain.validatePagination(0, 50);
- * const result = SearchFilterChain.paginate(filtered, pagination);
- * ```
- */
-export declare class SearchFilterChain {
-    /**
-     * Applies all filters to an array of entities.
-     * Entities must pass ALL specified filters to be included.
-     *
-     * @param entities - Entities to filter
-     * @param filters - Filter criteria to apply
-     * @returns Filtered entities array
-     */
-    static applyFilters(entities: readonly Entity[], filters: SearchFilters): Entity[];
-    /**
-     * Checks if an entity passes all active filters.
-     * Short-circuits on first failing filter for performance.
-     *
-     * @param entity - Entity to check
-     * @param filters - Filter criteria
-     * @param normalizedSearchTags - Pre-normalized search tags (for efficiency)
-     * @returns true if entity passes all filters
-     */
-    static entityPassesFilters(entity: Entity, filters: SearchFilters, normalizedSearchTags?: string[]): boolean;
-    /**
-     * Checks if any filters are actually specified.
-     * Used for early return optimization.
-     *
-     * @param filters - Filter criteria to check
-     * @returns true if at least one filter is active
-     */
-    static hasActiveFilters(filters: SearchFilters): boolean;
-    /**
-     * Validates and returns pagination parameters.
-     * Delegates to paginationUtils.validatePagination.
-     *
-     * @param offset - Starting position
-     * @param limit - Maximum results
-     * @returns Validated pagination object
-     */
-    static validatePagination(offset?: number, limit?: number): ValidatedPagination;
-    /**
-     * Applies pagination to a filtered result set.
-     *
-     * @param entities - Entities to paginate
-     * @param pagination - Validated pagination parameters
-     * @returns Paginated slice of entities
-     */
-    static paginate(entities: Entity[], pagination: ValidatedPagination): Entity[];
-    /**
-     * Convenience method to apply both filters and pagination in one call.
-     *
-     * @param entities - Entities to process
-     * @param filters - Filter criteria
-     * @param offset - Pagination offset
-     * @param limit - Pagination limit
-     * @returns Filtered and paginated entities
-     */
-    static filterAndPaginate(entities: Entity[], filters: SearchFilters, offset?: number, limit?: number): Entity[];
-    /**
-     * Applies tag filter only. Useful when other filters are handled separately.
-     *
-     * @param entities - Entities to filter
-     * @param tags - Tags to filter by
-     * @returns Filtered entities
-     */
-    static filterByTags(entities: Entity[], tags?: string[]): Entity[];
-    /**
-     * Applies importance filter only. Useful when other filters are handled separately.
-     *
-     * @param entities - Entities to filter
-     * @param minImportance - Minimum importance
-     * @param maxImportance - Maximum importance
-     * @returns Filtered entities
-     */
-    static filterByImportance(entities: Entity[], minImportance?: number, maxImportance?: number): Entity[];
-}
-export type { ValidatedPagination };
-//# sourceMappingURL=SearchFilterChain.d.ts.map

package/dist/search/SearchFilterChain.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SearchFilterChain.d.ts","sourceRoot":"","sources":["../../src/search/SearchFilterChain.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAML,KAAK,mBAAmB,EACzB,MAAM,mBAAmB,CAAC;AAE3B;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;;OAOG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,EAAE;IAgBlF;;;;;;;;OAQG;IACH,MAAM,CAAC,mBAAmB,CACxB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,EACtB,oBAAoB,CAAC,EAAE,MAAM,EAAE,GAC9B,OAAO;IAsDV;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO;IAaxD;;;;;;;OAOG;IACH,MAAM,CAAC,kBAAkB,CAAC,MAAM,GAAE,MAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,mBAAmB;IAIlF;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,mBAAmB,GAAG,MAAM,EAAE;IAI9E;;;;;;;;OAQG;IACH,MAAM,CAAC,iBAAiB,CACtB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,aAAa,EACtB,MAAM,GAAE,MAAU,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,EAAE;IAMX;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAclE;;;;;;;OAOG;IACH,MAAM,CAAC,kBAAkB,CACvB,QAAQ,EAAE,MAAM,EAAE,EAClB,aAAa,CAAC,EAAE,MAAM,EACtB,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,EAAE;CASZ;AAGD,YAAY,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/search/SearchFilterChain.js

@@ -1,185 +0,0 @@
-/**
- * Search Filter Chain
- *
- * Centralizes filter logic for all search implementations to eliminate
- * duplicate filtering code across BasicSearch, BooleanSearch, FuzzySearch,
- * and RankedSearch.
- *
- * @module search/SearchFilterChain
- */
-import { normalizeTags, hasMatchingTag, isWithinImportanceRange, validatePagination, applyPagination, } from '../utils/index.js';
-/**
- * Centralized filter chain for all search implementations.
- * Ensures consistent filtering behavior across search types.
- *
- * @example
- * ```typescript
- * const filters: SearchFilters = { tags: ['important'], minImportance: 5 };
- * const filtered = SearchFilterChain.applyFilters(entities, filters);
- * const pagination = SearchFilterChain.validatePagination(0, 50);
- * const result = SearchFilterChain.paginate(filtered, pagination);
- * ```
- */
-export class SearchFilterChain {
-    /**
-     * Applies all filters to an array of entities.
-     * Entities must pass ALL specified filters to be included.
-     *
-     * @param entities - Entities to filter
-     * @param filters - Filter criteria to apply
-     * @returns Filtered entities array
-     */
-    static applyFilters(entities, filters) {
-        // Early return if no filters are active
-        if (!this.hasActiveFilters(filters)) {
-            return [...entities];
-        }
-        // Pre-normalize tags once for efficiency
-        const normalizedSearchTags = filters.tags?.length
-            ? normalizeTags(filters.tags)
-            : undefined;
-        return entities.filter(entity => this.entityPassesFilters(entity, filters, normalizedSearchTags));
-    }
-    /**
-     * Checks if an entity passes all active filters.
-     * Short-circuits on first failing filter for performance.
-     *
-     * @param entity - Entity to check
-     * @param filters - Filter criteria
-     * @param normalizedSearchTags - Pre-normalized search tags (for efficiency)
-     * @returns true if entity passes all filters
-     */
-    static entityPassesFilters(entity, filters, normalizedSearchTags) {
-        // Tag filter - check if entity has any matching tag
-        if (normalizedSearchTags && normalizedSearchTags.length > 0) {
-            if (!entity.tags || entity.tags.length === 0) {
-                return false;
-            }
-            const entityTags = normalizeTags(entity.tags);
-            const hasMatch = normalizedSearchTags.some(tag => entityTags.includes(tag));
-            if (!hasMatch) {
-                return false;
-            }
-        }
-        // Importance filter
-        if (!isWithinImportanceRange(entity.importance, filters.minImportance, filters.maxImportance)) {
-            return false;
-        }
-        // Entity type filter
-        if (filters.entityType && entity.entityType !== filters.entityType) {
-            return false;
-        }
-        // Created date filter
-        if (filters.createdAfter || filters.createdBefore) {
-            if (!entity.createdAt) {
-                return false;
-            }
-            const createdAt = new Date(entity.createdAt);
-            if (filters.createdAfter && createdAt < new Date(filters.createdAfter)) {
-                return false;
-            }
-            if (filters.createdBefore && createdAt > new Date(filters.createdBefore)) {
-                return false;
-            }
-        }
-        // Modified date filter
-        if (filters.modifiedAfter || filters.modifiedBefore) {
-            if (!entity.lastModified) {
-                return false;
-            }
-            const modifiedAt = new Date(entity.lastModified);
-            if (filters.modifiedAfter && modifiedAt < new Date(filters.modifiedAfter)) {
-                return false;
-            }
-            if (filters.modifiedBefore && modifiedAt > new Date(filters.modifiedBefore)) {
-                return false;
-            }
-        }
-        return true;
-    }
-    /**
-     * Checks if any filters are actually specified.
-     * Used for early return optimization.
-     *
-     * @param filters - Filter criteria to check
-     * @returns true if at least one filter is active
-     */
-    static hasActiveFilters(filters) {
-        return !!((filters.tags && filters.tags.length > 0) ||
-            filters.minImportance !== undefined ||
-            filters.maxImportance !== undefined ||
-            filters.entityType ||
-            filters.createdAfter ||
-            filters.createdBefore ||
-            filters.modifiedAfter ||
-            filters.modifiedBefore);
-    }
-    /**
-     * Validates and returns pagination parameters.
-     * Delegates to paginationUtils.validatePagination.
-     *
-     * @param offset - Starting position
-     * @param limit - Maximum results
-     * @returns Validated pagination object
-     */
-    static validatePagination(offset = 0, limit) {
-        return validatePagination(offset, limit);
-    }
-    /**
-     * Applies pagination to a filtered result set.
-     *
-     * @param entities - Entities to paginate
-     * @param pagination - Validated pagination parameters
-     * @returns Paginated slice of entities
-     */
-    static paginate(entities, pagination) {
-        return applyPagination(entities, pagination);
-    }
-    /**
-     * Convenience method to apply both filters and pagination in one call.
-     *
-     * @param entities - Entities to process
-     * @param filters - Filter criteria
-     * @param offset - Pagination offset
-     * @param limit - Pagination limit
-     * @returns Filtered and paginated entities
-     */
-    static filterAndPaginate(entities, filters, offset = 0, limit) {
-        const filtered = this.applyFilters(entities, filters);
-        const pagination = this.validatePagination(offset, limit);
-        return this.paginate(filtered, pagination);
-    }
-    /**
-     * Applies tag filter only. Useful when other filters are handled separately.
-     *
-     * @param entities - Entities to filter
-     * @param tags - Tags to filter by
-     * @returns Filtered entities
-     */
-    static filterByTags(entities, tags) {
-        if (!tags || tags.length === 0) {
-            return entities;
-        }
-        const normalizedTags = normalizeTags(tags);
-        return entities.filter(entity => {
-            if (!entity.tags || entity.tags.length === 0) {
-                return false;
-            }
-            return hasMatchingTag(entity.tags, normalizedTags);
-        });
-    }
-    /**
-     * Applies importance filter only. Useful when other filters are handled separately.
-     *
-     * @param entities - Entities to filter
-     * @param minImportance - Minimum importance
-     * @param maxImportance - Maximum importance
-     * @returns Filtered entities
-     */
-    static filterByImportance(entities, minImportance, maxImportance) {
-        if (minImportance === undefined && maxImportance === undefined) {
-            return entities;
-        }
-        return entities.filter(entity => isWithinImportanceRange(entity.importance, minImportance, maxImportance));
-    }
-}