@danielsimonjr/memory-mcp 11.0.1 → 11.1.1

package/dist/core/GraphEventEmitter.js

@@ -1,346 +0,0 @@
-/**
- * Graph Event Emitter
- *
- * Phase 10 Sprint 2: Provides event-based notifications for graph changes.
- * Enables loose coupling between graph operations and dependent systems
- * like search indexes, analytics, and external integrations.
- *
- * @module core/GraphEventEmitter
- */
-/**
- * Phase 10 Sprint 2: Event emitter for graph change notifications.
- *
- * Provides a type-safe event system for subscribing to and emitting
- * graph change events. Supports wildcard listeners for all events.
- *
- * @example
- * ```typescript
- * const emitter = new GraphEventEmitter();
- *
- * // Listen to specific event types
- * emitter.on('entity:created', (event) => {
- *   console.log(`Entity ${event.entity.name} created`);
- * });
- *
- * // Listen to all events
- * emitter.onAny((event) => {
- *   console.log(`Event: ${event.type}`);
- * });
- *
- * // Emit an event
- * emitter.emitEntityCreated(entity);
- *
- * // Remove listener
- * const unsubscribe = emitter.on('entity:deleted', handler);
- * unsubscribe();
- * ```
- */
-export class GraphEventEmitter {
-    /**
-     * Map of event types to their registered listeners.
-     */
-    listeners = new Map();
-    /**
-     * Listeners that receive all events regardless of type.
-     */
-    wildcardListeners = new Set();
-    /**
-     * Whether to suppress errors from listeners (default: true).
-     * When true, listener errors are logged but don't stop event propagation.
-     */
-    suppressListenerErrors = true;
-    /**
-     * Create a new GraphEventEmitter instance.
-     *
-     * @param options - Optional configuration
-     */
-    constructor(options) {
-        if (options?.suppressListenerErrors !== undefined) {
-            this.suppressListenerErrors = options.suppressListenerErrors;
-        }
-    }
-    // ==================== Subscription Methods ====================
-    /**
-     * Subscribe to a specific event type.
-     *
-     * @template K - The event type key
-     * @param eventType - The event type to listen for
-     * @param listener - Callback function to invoke when event occurs
-     * @returns Unsubscribe function to remove the listener
-     *
-     * @example
-     * ```typescript
-     * const unsubscribe = emitter.on('entity:created', (event) => {
-     *   console.log(`Created: ${event.entity.name}`);
-     * });
-     *
-     * // Later: unsubscribe();
-     * ```
-     */
-    on(eventType, listener) {
-        if (!this.listeners.has(eventType)) {
-            this.listeners.set(eventType, new Set());
-        }
-        this.listeners.get(eventType).add(listener);
-        // Return unsubscribe function
-        return () => {
-            this.off(eventType, listener);
-        };
-    }
-    /**
-     * Unsubscribe from a specific event type.
-     *
-     * @template K - The event type key
-     * @param eventType - The event type to unsubscribe from
-     * @param listener - The listener function to remove
-     */
-    off(eventType, listener) {
-        const listeners = this.listeners.get(eventType);
-        if (listeners) {
-            listeners.delete(listener);
-        }
-    }
-    /**
-     * Subscribe to all event types.
-     *
-     * @param listener - Callback function to invoke for any event
-     * @returns Unsubscribe function to remove the listener
-     *
-     * @example
-     * ```typescript
-     * emitter.onAny((event) => {
-     *   console.log(`Event: ${event.type} at ${event.timestamp}`);
-     * });
-     * ```
-     */
-    onAny(listener) {
-        this.wildcardListeners.add(listener);
-        return () => {
-            this.offAny(listener);
-        };
-    }
-    /**
-     * Unsubscribe from all events.
-     *
-     * @param listener - The listener function to remove
-     */
-    offAny(listener) {
-        this.wildcardListeners.delete(listener);
-    }
-    /**
-     * Subscribe to an event type, but only receive the first occurrence.
-     *
-     * @template K - The event type key
-     * @param eventType - The event type to listen for once
-     * @param listener - Callback function to invoke once
-     * @returns Unsubscribe function to cancel before event occurs
-     */
-    once(eventType, listener) {
-        const wrappedListener = ((event) => {
-            this.off(eventType, wrappedListener);
-            listener(event);
-        });
-        return this.on(eventType, wrappedListener);
-    }
-    /**
-     * Remove all listeners for all event types.
-     */
-    removeAllListeners() {
-        this.listeners.clear();
-        this.wildcardListeners.clear();
-    }
-    /**
-     * Get the count of listeners for a specific event type.
-     *
-     * @param eventType - The event type to count listeners for
-     * @returns Number of listeners registered
-     */
-    listenerCount(eventType) {
-        if (eventType) {
-            return (this.listeners.get(eventType)?.size ?? 0) + this.wildcardListeners.size;
-        }
-        // Count all listeners
-        let count = this.wildcardListeners.size;
-        for (const listeners of this.listeners.values()) {
-            count += listeners.size;
-        }
-        return count;
-    }
-    // ==================== Emit Methods ====================
-    /**
-     * Emit an event to all registered listeners.
-     *
-     * @param event - The event to emit
-     */
-    emit(event) {
-        // Notify type-specific listeners
-        const typeListeners = this.listeners.get(event.type);
-        if (typeListeners) {
-            for (const listener of typeListeners) {
-                this.invokeListener(listener, event);
-            }
-        }
-        // Notify wildcard listeners
-        for (const listener of this.wildcardListeners) {
-            this.invokeListener(listener, event);
-        }
-    }
-    /**
-     * Emit an entity:created event.
-     *
-     * @param entity - The entity that was created
-     */
-    emitEntityCreated(entity) {
-        const event = {
-            type: 'entity:created',
-            timestamp: new Date().toISOString(),
-            entity,
-        };
-        this.emit(event);
-    }
-    /**
-     * Emit an entity:updated event.
-     *
-     * @param entityName - Name of the updated entity
-     * @param changes - The changes that were applied
-     * @param previousValues - Optional previous values before update
-     */
-    emitEntityUpdated(entityName, changes, previousValues) {
-        const event = {
-            type: 'entity:updated',
-            timestamp: new Date().toISOString(),
-            entityName,
-            changes,
-            previousValues,
-        };
-        this.emit(event);
-    }
-    /**
-     * Emit an entity:deleted event.
-     *
-     * @param entityName - Name of the deleted entity
-     * @param entity - Optional entity data before deletion
-     */
-    emitEntityDeleted(entityName, entity) {
-        const event = {
-            type: 'entity:deleted',
-            timestamp: new Date().toISOString(),
-            entityName,
-            entity,
-        };
-        this.emit(event);
-    }
-    /**
-     * Emit a relation:created event.
-     *
-     * @param relation - The relation that was created
-     */
-    emitRelationCreated(relation) {
-        const event = {
-            type: 'relation:created',
-            timestamp: new Date().toISOString(),
-            relation,
-        };
-        this.emit(event);
-    }
-    /**
-     * Emit a relation:deleted event.
-     *
-     * @param from - Source entity name
-     * @param to - Target entity name
-     * @param relationType - Type of the deleted relation
-     */
-    emitRelationDeleted(from, to, relationType) {
-        const event = {
-            type: 'relation:deleted',
-            timestamp: new Date().toISOString(),
-            from,
-            to,
-            relationType,
-        };
-        this.emit(event);
-    }
-    /**
-     * Emit an observation:added event.
-     *
-     * @param entityName - Name of the entity
-     * @param observations - Observations that were added
-     */
-    emitObservationAdded(entityName, observations) {
-        if (observations.length === 0)
-            return;
-        const event = {
-            type: 'observation:added',
-            timestamp: new Date().toISOString(),
-            entityName,
-            observations,
-        };
-        this.emit(event);
-    }
-    /**
-     * Emit an observation:deleted event.
-     *
-     * @param entityName - Name of the entity
-     * @param observations - Observations that were deleted
-     */
-    emitObservationDeleted(entityName, observations) {
-        if (observations.length === 0)
-            return;
-        const event = {
-            type: 'observation:deleted',
-            timestamp: new Date().toISOString(),
-            entityName,
-            observations,
-        };
-        this.emit(event);
-    }
-    /**
-     * Emit a graph:saved event.
-     *
-     * @param entityCount - Number of entities in the saved graph
-     * @param relationCount - Number of relations in the saved graph
-     */
-    emitGraphSaved(entityCount, relationCount) {
-        const event = {
-            type: 'graph:saved',
-            timestamp: new Date().toISOString(),
-            entityCount,
-            relationCount,
-        };
-        this.emit(event);
-    }
-    /**
-     * Emit a graph:loaded event.
-     *
-     * @param entityCount - Number of entities in the loaded graph
-     * @param relationCount - Number of relations in the loaded graph
-     */
-    emitGraphLoaded(entityCount, relationCount) {
-        const event = {
-            type: 'graph:loaded',
-            timestamp: new Date().toISOString(),
-            entityCount,
-            relationCount,
-        };
-        this.emit(event);
-    }
-    // ==================== Helper Methods ====================
-    /**
-     * Safely invoke a listener, optionally catching errors.
-     * @private
-     */
-    invokeListener(listener, event) {
-        if (this.suppressListenerErrors) {
-            try {
-                listener(event);
-            }
-            catch (error) {
-                // Log but don't propagate errors from listeners
-                console.error(`GraphEventEmitter: Listener error for ${event.type}:`, error);
-            }
-        }
-        else {
-            listener(event);
-        }
-    }
-}

package/dist/features/KeywordExtractor.d.ts

@@ -1,61 +0,0 @@
-/**
- * Keyword Extractor
- *
- * Phase 11: Extracts and scores keywords from text
- * for lexical search enhancement.
- *
- * @module features/KeywordExtractor
- */
-/**
- * A keyword with importance score.
- */
-export interface ScoredKeyword {
-    keyword: string;
-    score: number;
-    positions: number[];
-}
-/**
- * Keyword Extractor extracts and scores keywords from text.
- *
- * Features:
- * - Position-based scoring (earlier = more important)
- * - Domain-specific keyword boosting
- * - Length-based scoring (longer words often more specific)
- * - Stopword filtering
- *
- * @example
- * ```typescript
- * const extractor = new KeywordExtractor();
- * const keywords = extractor.extract('The software project was completed on time');
- * // Returns scored keywords sorted by importance
- * ```
- */
-export declare class KeywordExtractor {
-    private stopwords;
-    private domainBoosts;
-    constructor();
-    /**
-     * Extract keywords with scores from text.
-     */
-    extract(text: string): ScoredKeyword[];
-    private tokenize;
-    private isKeyword;
-    private calculateScore;
-    /**
-     * Extract top N keywords.
-     */
-    extractTop(text: string, n: number): string[];
-    /**
-     * Add custom domain boost for a keyword.
-     */
-    addDomainBoost(keyword: string, boost: number): void;
-    /**
-     * Remove a domain boost.
-     */
-    removeDomainBoost(keyword: string): boolean;
-    /**
-     * Get all domain boosts.
-     */
-    getDomainBoosts(): Map<string, number>;
-}
-//# sourceMappingURL=KeywordExtractor.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"KeywordExtractor.d.ts","sourceRoot":"","sources":["../../src/features/KeywordExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,YAAY,CAAsB;;IA2B1C;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE;IAyBtC,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,cAAc;IAiBtB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAM7C;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpD;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI3C;;OAEG;IACH,eAAe,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;CAGvC"}

package/dist/features/KeywordExtractor.js

@@ -1,126 +0,0 @@
-/**
- * Keyword Extractor
- *
- * Phase 11: Extracts and scores keywords from text
- * for lexical search enhancement.
- *
- * @module features/KeywordExtractor
- */
-/**
- * Keyword Extractor extracts and scores keywords from text.
- *
- * Features:
- * - Position-based scoring (earlier = more important)
- * - Domain-specific keyword boosting
- * - Length-based scoring (longer words often more specific)
- * - Stopword filtering
- *
- * @example
- * ```typescript
- * const extractor = new KeywordExtractor();
- * const keywords = extractor.extract('The software project was completed on time');
- * // Returns scored keywords sorted by importance
- * ```
- */
-export class KeywordExtractor {
-    stopwords;
-    domainBoosts;
-    constructor() {
-        this.stopwords = new Set([
-            'a', 'an', 'the', 'is', 'are', 'was', 'were', 'be', 'been',
-            'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would',
-            'could', 'should', 'can', 'to', 'of', 'in', 'for', 'on',
-            'with', 'at', 'by', 'from', 'as', 'and', 'or', 'but',
-        ]);
-        this.domainBoosts = new Map([
-            ['project', 1.5],
-            ['task', 1.5],
-            ['meeting', 1.3],
-            ['deadline', 1.4],
-            ['completed', 1.2],
-            ['started', 1.2],
-            ['person', 1.3],
-            ['company', 1.3],
-            ['team', 1.3],
-            ['release', 1.4],
-            ['feature', 1.3],
-            ['bug', 1.2],
-            ['issue', 1.2],
-            ['milestone', 1.4],
-        ]);
-    }
-    /**
-     * Extract keywords with scores from text.
-     */
-    extract(text) {
-        const words = this.tokenize(text);
-        const keywordMap = new Map();
-        for (let i = 0; i < words.length; i++) {
-            const word = words[i].toLowerCase();
-            if (this.isKeyword(word)) {
-                const existing = keywordMap.get(word);
-                if (existing) {
-                    existing.positions.push(i);
-                    existing.score += this.calculateScore(word, i, words.length);
-                }
-                else {
-                    keywordMap.set(word, {
-                        keyword: word,
-                        score: this.calculateScore(word, i, words.length),
-                        positions: [i],
-                    });
-                }
-            }
-        }
-        return Array.from(keywordMap.values())
-            .sort((a, b) => b.score - a.score);
-    }
-    tokenize(text) {
-        return text
-            .replace(/[^a-zA-Z0-9\s]/g, ' ')
-            .split(/\s+/)
-            .filter(w => w.length > 0);
-    }
-    isKeyword(word) {
-        return word.length > 2 && !this.stopwords.has(word);
-    }
-    calculateScore(word, position, totalWords) {
-        let score = 1.0;
-        // Position boost (earlier = more important)
-        const positionFactor = 1 - (position / totalWords) * 0.3;
-        score *= positionFactor;
-        // Domain boost
-        const boost = this.domainBoosts.get(word) ?? 1.0;
-        score *= boost;
-        // Length boost (longer words often more specific)
-        if (word.length > 6)
-            score *= 1.1;
-        return score;
-    }
-    /**
-     * Extract top N keywords.
-     */
-    extractTop(text, n) {
-        return this.extract(text)
-            .slice(0, n)
-            .map(k => k.keyword);
-    }
-    /**
-     * Add custom domain boost for a keyword.
-     */
-    addDomainBoost(keyword, boost) {
-        this.domainBoosts.set(keyword.toLowerCase(), boost);
-    }
-    /**
-     * Remove a domain boost.
-     */
-    removeDomainBoost(keyword) {
-        return this.domainBoosts.delete(keyword.toLowerCase());
-    }
-    /**
-     * Get all domain boosts.
-     */
-    getDomainBoosts() {
-        return new Map(this.domainBoosts);
-    }
-}

package/dist/features/ObservationNormalizer.d.ts

@@ -1,90 +0,0 @@
-/**
- * Observation Normalizer
- *
- * Phase 11: Transforms observations to be self-contained facts
- * through coreference resolution and temporal anchoring.
- *
- * @module features/ObservationNormalizer
- */
-import type { Entity } from '../types/index.js';
-/**
- * Options for observation normalization.
- */
-export interface NormalizationOptions {
-    /** Resolve pronouns to entity names */
-    resolveCoreferences?: boolean;
-    /** Convert relative dates to absolute dates */
-    anchorTimestamps?: boolean;
-    /** Extract and tag keywords */
-    extractKeywords?: boolean;
-    /** Reference date for relative date conversion (default: now) */
-    referenceDate?: Date;
-}
-/**
- * Result of normalizing an observation.
- */
-export interface NormalizationResult {
-    original: string;
-    normalized: string;
-    changes: string[];
-    keywords?: string[];
-}
-/**
- * Observation Normalizer transforms observations to self-contained facts.
- *
- * Applies transformations:
- * 1. Coreference resolution: 'He works' -> 'Alice works'
- * 2. Temporal anchoring: 'yesterday' -> '2026-01-07'
- * 3. Keyword extraction: Identifies important terms
- *
- * @example
- * ```typescript
- * const normalizer = new ObservationNormalizer();
- * const result = normalizer.normalize(
- *   'He started the project yesterday',
- *   { name: 'Bob', entityType: 'person', observations: [] }
- * );
- * // result.normalized = 'Bob started the project on 2026-01-07'
- * ```
- */
-export declare class ObservationNormalizer {
-    private pronounPatterns;
-    private relativeTimePatterns;
-    /**
-     * Normalize an observation for an entity.
-     */
-    normalize(observation: string, entity: Entity, options?: NormalizationOptions): NormalizationResult;
-    /**
-     * Resolve pronouns to entity name.
-     */
-    resolveCoreferences(text: string, entity: Entity): {
-        text: string;
-        changed: boolean;
-    };
-    private guessMasculine;
-    private guessFeminine;
-    /**
-     * Convert relative timestamps to absolute dates.
-     */
-    anchorTimestamps(text: string, referenceDate: Date): {
-        text: string;
-        changed: boolean;
-        replacements: string[];
-    };
-    private addDays;
-    private addMonths;
-    private formatDate;
-    private formatMonth;
-    /**
-     * Extract important keywords from text.
-     */
-    extractKeywords(text: string): string[];
-    /**
-     * Normalize all observations for an entity.
-     */
-    normalizeEntity(entity: Entity, options?: NormalizationOptions): {
-        entity: Entity;
-        results: NormalizationResult[];
-    };
-}
-//# sourceMappingURL=ObservationNormalizer.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ObservationNormalizer.d.ts","sourceRoot":"","sources":["../../src/features/ObservationNormalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+BAA+B;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iEAAiE;IACjE,aAAa,CAAC,EAAE,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,eAAe,CAIrB;IAEF,OAAO,CAAC,oBAAoB,CAU1B;IAEF;;OAEG;IACH,SAAS,CACP,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC,mBAAmB;IAuCtB;;OAEG;IACH,mBAAmB,CACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IAsCrC,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,IAAI,GAClB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE;IAoB7D,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAwBvC;;OAEG;IACH,eAAe,CACb,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,mBAAmB,EAAE,CAAA;KAAE;CAatD"}