@danielsimonjr/memoryjs 1.0.0

package/dist/core/HierarchyManager.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Hierarchy Manager
+ *
+ * Handles entity hierarchy operations (parent-child relationships).
+ * Extracted from EntityManager (Phase 4: Consolidate God Objects).
+ *
+ * @module core/HierarchyManager
+ */
+import type { Entity, KnowledgeGraph } from '../types/index.js';
+import type { GraphStorage } from './GraphStorage.js';
+/**
+ * Manages hierarchical relationships between entities.
+ */
+export declare class HierarchyManager {
+    private storage;
+    constructor(storage: GraphStorage);
+    /**
+     * Set the parent of an entity.
+     *
+     * Validates:
+     * - Entity and parent exist
+     * - Setting parent won't create a cycle
+     *
+     * @param entityName - Entity to set parent for
+     * @param parentName - Parent entity name (null to remove parent)
+     * @returns Updated entity
+     * @throws {EntityNotFoundError} If entity or parent not found
+     * @throws {CycleDetectedError} If setting parent would create a cycle
+     */
+    setEntityParent(entityName: string, parentName: string | null): Promise<Entity>;
+    /**
+     * Check if setting a parent would create a cycle in the hierarchy.
+     *
+     * @param graph - Knowledge graph
+     * @param entityName - Entity to set parent for
+     * @param parentName - Proposed parent
+     * @returns True if cycle would be created
+     */
+    private wouldCreateCycle;
+    /**
+     * Get the immediate children of an entity.
+     *
+     * @param entityName - Parent entity name
+     * @returns Array of child entities
+     * @throws {EntityNotFoundError} If entity not found
+     */
+    getChildren(entityName: string): Promise<Entity[]>;
+    /**
+     * Get the parent of an entity.
+     *
+     * @param entityName - Entity name
+     * @returns Parent entity or null if no parent
+     * @throws {EntityNotFoundError} If entity not found
+     */
+    getParent(entityName: string): Promise<Entity | null>;
+    /**
+     * Get all ancestors of an entity (parent, grandparent, etc.).
+     *
+     * @param entityName - Entity name
+     * @returns Array of ancestor entities (ordered from immediate parent to root)
+     * @throws {EntityNotFoundError} If entity not found
+     */
+    getAncestors(entityName: string): Promise<Entity[]>;
+    /**
+     * Get all descendants of an entity (children, grandchildren, etc.).
+     *
+     * Uses breadth-first traversal.
+     *
+     * @param entityName - Entity name
+     * @returns Array of descendant entities
+     * @throws {EntityNotFoundError} If entity not found
+     */
+    getDescendants(entityName: string): Promise<Entity[]>;
+    /**
+     * Get the entire subtree rooted at an entity (entity + all descendants).
+     *
+     * Includes relations between entities in the subtree.
+     *
+     * @param entityName - Root entity name
+     * @returns Knowledge graph containing subtree
+     * @throws {EntityNotFoundError} If entity not found
+     */
+    getSubtree(entityName: string): Promise<KnowledgeGraph>;
+    /**
+     * Get root entities (entities with no parent).
+     *
+     * @returns Array of root entities
+     */
+    getRootEntities(): Promise<Entity[]>;
+    /**
+     * Get the depth of an entity in the hierarchy.
+     *
+     * Root entities have depth 0, their children depth 1, etc.
+     *
+     * @param entityName - Entity name
+     * @returns Depth (number of ancestors)
+     * @throws {EntityNotFoundError} If entity not found
+     */
+    getEntityDepth(entityName: string): Promise<number>;
+    /**
+     * Move an entity to a new parent (maintaining its descendants).
+     *
+     * Alias for setEntityParent.
+     *
+     * @param entityName - Entity to move
+     * @param newParentName - New parent name (null to make root)
+     * @returns Updated entity
+     */
+    moveEntity(entityName: string, newParentName: string | null): Promise<Entity>;
+}
+//# sourceMappingURL=HierarchyManager.d.ts.map

package/dist/core/HierarchyManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HierarchyManager.d.ts","sourceRoot":"","sources":["../../src/core/HierarchyManager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAA0B,MAAM,mBAAmB,CAAC;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD;;GAEG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,YAAY;IAEzC;;;;;;;;;;;;OAYG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAgCrF;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;;;;;OAMG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAWxD;;;;;;OAMG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAgB3D;;;;;;OAMG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmBzD;;;;;;;;OAQG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwB3D;;;;;;;;OAQG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAuB7D;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAK1C;;;;;;;;OAQG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKzD;;;;;;;;OAQG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;CAGpF"}

package/dist/core/HierarchyManager.js

@@ -0,0 +1,225 @@
+/**
+ * Hierarchy Manager
+ *
+ * Handles entity hierarchy operations (parent-child relationships).
+ * Extracted from EntityManager (Phase 4: Consolidate God Objects).
+ *
+ * @module core/HierarchyManager
+ */
+import { EntityNotFoundError, CycleDetectedError } from '../utils/errors.js';
+/**
+ * Manages hierarchical relationships between entities.
+ */
+export class HierarchyManager {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * Set the parent of an entity.
+     *
+     * Validates:
+     * - Entity and parent exist
+     * - Setting parent won't create a cycle
+     *
+     * @param entityName - Entity to set parent for
+     * @param parentName - Parent entity name (null to remove parent)
+     * @returns Updated entity
+     * @throws {EntityNotFoundError} If entity or parent not found
+     * @throws {CycleDetectedError} If setting parent would create a cycle
+     */
+    async setEntityParent(entityName, parentName) {
+        // Use read-only graph for validation checks
+        const readGraph = await this.storage.loadGraph();
+        const entityExists = readGraph.entities.find(e => e.name === entityName);
+        if (!entityExists) {
+            throw new EntityNotFoundError(entityName);
+        }
+        // If setting a parent, validate it exists and doesn't create a cycle
+        if (parentName !== null) {
+            const parent = readGraph.entities.find(e => e.name === parentName);
+            if (!parent) {
+                throw new EntityNotFoundError(parentName);
+            }
+            // Check for cycles
+            if (this.wouldCreateCycle(readGraph, entityName, parentName)) {
+                throw new CycleDetectedError(entityName, parentName);
+            }
+        }
+        // Get mutable copy for write operation
+        const graph = await this.storage.getGraphForMutation();
+        const entity = graph.entities.find(e => e.name === entityName);
+        entity.parentId = parentName || undefined;
+        entity.lastModified = new Date().toISOString();
+        await this.storage.saveGraph(graph);
+        return entity;
+    }
+    /**
+     * Check if setting a parent would create a cycle in the hierarchy.
+     *
+     * @param graph - Knowledge graph
+     * @param entityName - Entity to set parent for
+     * @param parentName - Proposed parent
+     * @returns True if cycle would be created
+     */
+    wouldCreateCycle(graph, entityName, parentName) {
+        const visited = new Set();
+        let current = parentName;
+        while (current) {
+            if (visited.has(current)) {
+                return true; // Cycle detected in existing hierarchy
+            }
+            if (current === entityName) {
+                return true; // Would create a cycle
+            }
+            visited.add(current);
+            const currentEntity = graph.entities.find(e => e.name === current);
+            current = currentEntity?.parentId;
+        }
+        return false;
+    }
+    /**
+     * Get the immediate children of an entity.
+     *
+     * @param entityName - Parent entity name
+     * @returns Array of child entities
+     * @throws {EntityNotFoundError} If entity not found
+     */
+    async getChildren(entityName) {
+        const graph = await this.storage.loadGraph();
+        // Verify entity exists
+        if (!graph.entities.find(e => e.name === entityName)) {
+            throw new EntityNotFoundError(entityName);
+        }
+        return graph.entities.filter(e => e.parentId === entityName);
+    }
+    /**
+     * Get the parent of an entity.
+     *
+     * @param entityName - Entity name
+     * @returns Parent entity or null if no parent
+     * @throws {EntityNotFoundError} If entity not found
+     */
+    async getParent(entityName) {
+        const graph = await this.storage.loadGraph();
+        const entity = graph.entities.find(e => e.name === entityName);
+        if (!entity) {
+            throw new EntityNotFoundError(entityName);
+        }
+        if (!entity.parentId) {
+            return null;
+        }
+        const parent = graph.entities.find(e => e.name === entity.parentId);
+        return parent || null;
+    }
+    /**
+     * Get all ancestors of an entity (parent, grandparent, etc.).
+     *
+     * @param entityName - Entity name
+     * @returns Array of ancestor entities (ordered from immediate parent to root)
+     * @throws {EntityNotFoundError} If entity not found
+     */
+    async getAncestors(entityName) {
+        const graph = await this.storage.loadGraph();
+        const ancestors = [];
+        let current = graph.entities.find(e => e.name === entityName);
+        if (!current) {
+            throw new EntityNotFoundError(entityName);
+        }
+        while (current.parentId) {
+            const parent = graph.entities.find(e => e.name === current.parentId);
+            if (!parent)
+                break;
+            ancestors.push(parent);
+            current = parent;
+        }
+        return ancestors;
+    }
+    /**
+     * Get all descendants of an entity (children, grandchildren, etc.).
+     *
+     * Uses breadth-first traversal.
+     *
+     * @param entityName - Entity name
+     * @returns Array of descendant entities
+     * @throws {EntityNotFoundError} If entity not found
+     */
+    async getDescendants(entityName) {
+        const graph = await this.storage.loadGraph();
+        // Verify entity exists
+        if (!graph.entities.find(e => e.name === entityName)) {
+            throw new EntityNotFoundError(entityName);
+        }
+        const descendants = [];
+        const toProcess = [entityName];
+        while (toProcess.length > 0) {
+            const current = toProcess.shift();
+            const children = graph.entities.filter(e => e.parentId === current);
+            for (const child of children) {
+                descendants.push(child);
+                toProcess.push(child.name);
+            }
+        }
+        return descendants;
+    }
+    /**
+     * Get the entire subtree rooted at an entity (entity + all descendants).
+     *
+     * Includes relations between entities in the subtree.
+     *
+     * @param entityName - Root entity name
+     * @returns Knowledge graph containing subtree
+     * @throws {EntityNotFoundError} If entity not found
+     */
+    async getSubtree(entityName) {
+        const graph = await this.storage.loadGraph();
+        const entity = graph.entities.find(e => e.name === entityName);
+        if (!entity) {
+            throw new EntityNotFoundError(entityName);
+        }
+        const descendants = await this.getDescendants(entityName);
+        const subtreeEntities = [entity, ...descendants];
+        const subtreeEntityNames = new Set(subtreeEntities.map(e => e.name));
+        // Include relations between entities in the subtree
+        const subtreeRelations = graph.relations.filter(r => subtreeEntityNames.has(r.from) && subtreeEntityNames.has(r.to));
+        return {
+            entities: subtreeEntities,
+            relations: subtreeRelations,
+        };
+    }
+    /**
+     * Get root entities (entities with no parent).
+     *
+     * @returns Array of root entities
+     */
+    async getRootEntities() {
+        const graph = await this.storage.loadGraph();
+        return graph.entities.filter(e => !e.parentId);
+    }
+    /**
+     * Get the depth of an entity in the hierarchy.
+     *
+     * Root entities have depth 0, their children depth 1, etc.
+     *
+     * @param entityName - Entity name
+     * @returns Depth (number of ancestors)
+     * @throws {EntityNotFoundError} If entity not found
+     */
+    async getEntityDepth(entityName) {
+        const ancestors = await this.getAncestors(entityName);
+        return ancestors.length;
+    }
+    /**
+     * Move an entity to a new parent (maintaining its descendants).
+     *
+     * Alias for setEntityParent.
+     *
+     * @param entityName - Entity to move
+     * @param newParentName - New parent name (null to make root)
+     * @returns Updated entity
+     */
+    async moveEntity(entityName, newParentName) {
+        return await this.setEntityParent(entityName, newParentName);
+    }
+}
+//# sourceMappingURL=HierarchyManager.js.map

package/dist/core/HierarchyManager.js.map

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

package/dist/core/ManagerContext.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Manager Context
+ *
+ * Central context holding all manager instances with lazy initialization.
+ * Provides direct manager access for toolHandlers.
+ * Phase 4: Removed convenience methods - use managers directly.
+ *
+ * @module core/ManagerContext
+ */
+import { GraphStorage } from './GraphStorage.js';
+import { EntityManager } from './EntityManager.js';
+import { RelationManager } from './RelationManager.js';
+import { ObservationManager } from './ObservationManager.js';
+import { HierarchyManager } from './HierarchyManager.js';
+import { GraphTraversal } from './GraphTraversal.js';
+import { SearchManager } from '../search/SearchManager.js';
+import { RankedSearch } from '../search/RankedSearch.js';
+import { SemanticSearch } from '../search/index.js';
+import { IOManager } from '../features/IOManager.js';
+import { TagManager } from '../features/TagManager.js';
+import { AnalyticsManager } from '../features/AnalyticsManager.js';
+import { CompressionManager } from '../features/CompressionManager.js';
+import { ArchiveManager } from '../features/ArchiveManager.js';
+/**
+ * Context holding all manager instances with lazy initialization.
+ * Provides direct manager access for toolHandlers.
+ */
+export declare class ManagerContext {
+    readonly storage: GraphStorage;
+    private readonly savedSearchesFilePath;
+    private readonly tagAliasesFilePath;
+    private _entityManager?;
+    private _relationManager?;
+    private _observationManager?;
+    private _hierarchyManager?;
+    private _graphTraversal?;
+    private _searchManager?;
+    private _semanticSearch?;
+    private _rankedSearch?;
+    private _ioManager?;
+    private _tagManager?;
+    private _analyticsManager?;
+    private _compressionManager?;
+    private _archiveManager?;
+    constructor(memoryFilePath: string);
+    /** EntityManager - Entity CRUD and tag operations */
+    get entityManager(): EntityManager;
+    /** RelationManager - Relation CRUD */
+    get relationManager(): RelationManager;
+    /** ObservationManager - Observation CRUD */
+    get observationManager(): ObservationManager;
+    /** HierarchyManager - Entity hierarchy operations */
+    get hierarchyManager(): HierarchyManager;
+    /** GraphTraversal - Phase 4 Sprint 6-8: Graph traversal algorithms */
+    get graphTraversal(): GraphTraversal;
+    /** SearchManager - All search operations */
+    get searchManager(): SearchManager;
+    /**
+     * SemanticSearch - Phase 4 Sprint 12: Semantic similarity search.
+     * Returns null if no embedding provider is configured.
+     */
+    get semanticSearch(): SemanticSearch | null;
+    /** RankedSearch - Phase 11: TF-IDF/BM25 ranked search for hybrid search */
+    get rankedSearch(): RankedSearch;
+    /** IOManager - Import, export, and backup operations */
+    get ioManager(): IOManager;
+    /** TagManager - Tag alias management */
+    get tagManager(): TagManager;
+    /** AnalyticsManager - Graph statistics and validation */
+    get analyticsManager(): AnalyticsManager;
+    /** CompressionManager - Duplicate detection and entity merging */
+    get compressionManager(): CompressionManager;
+    /** ArchiveManager - Entity archival operations */
+    get archiveManager(): ArchiveManager;
+}
+//# sourceMappingURL=ManagerContext.d.ts.map

package/dist/core/ManagerContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManagerContext.d.ts","sourceRoot":"","sources":["../../src/core/ManagerContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,cAAc,EAA6C,MAAM,oBAAoB,CAAC;AAC/F,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAG/D;;;GAGG;AACH,qBAAa,cAAc;IAGzB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAG5C,OAAO,CAAC,cAAc,CAAC,CAAgB;IACvC,OAAO,CAAC,gBAAgB,CAAC,CAAkB;IAC3C,OAAO,CAAC,mBAAmB,CAAC,CAAqB;IACjD,OAAO,CAAC,iBAAiB,CAAC,CAAmB;IAC7C,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,OAAO,CAAC,cAAc,CAAC,CAAgB;IACvC,OAAO,CAAC,eAAe,CAAC,CAAwB;IAChD,OAAO,CAAC,aAAa,CAAC,CAAe;IACrC,OAAO,CAAC,UAAU,CAAC,CAAY;IAC/B,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,iBAAiB,CAAC,CAAmB;IAC7C,OAAO,CAAC,mBAAmB,CAAC,CAAqB;IACjD,OAAO,CAAC,eAAe,CAAC,CAAiB;gBAE7B,cAAc,EAAE,MAAM;IAclC,qDAAqD;IACrD,IAAI,aAAa,IAAI,aAAa,CAEjC;IAED,sCAAsC;IACtC,IAAI,eAAe,IAAI,eAAe,CAErC;IAED,4CAA4C;IAC5C,IAAI,kBAAkB,IAAI,kBAAkB,CAE3C;IAED,qDAAqD;IACrD,IAAI,gBAAgB,IAAI,gBAAgB,CAEvC;IAED,sEAAsE;IACtE,IAAI,cAAc,IAAI,cAAc,CAEnC;IAED,4CAA4C;IAC5C,IAAI,aAAa,IAAI,aAAa,CAEjC;IAED;;;OAGG;IACH,IAAI,cAAc,IAAI,cAAc,GAAG,IAAI,CAa1C;IAED,2EAA2E;IAC3E,IAAI,YAAY,IAAI,YAAY,CAE/B;IAED,wDAAwD;IACxD,IAAI,SAAS,IAAI,SAAS,CAEzB;IAED,wCAAwC;IACxC,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED,yDAAyD;IACzD,IAAI,gBAAgB,IAAI,gBAAgB,CAEvC;IAED,kEAAkE;IAClE,IAAI,kBAAkB,IAAI,kBAAkB,CAE3C;IAED,kDAAkD;IAClD,IAAI,cAAc,IAAI,cAAc,CAEnC;CACF"}

package/dist/core/ManagerContext.js

@@ -0,0 +1,129 @@
+/**
+ * Manager Context
+ *
+ * Central context holding all manager instances with lazy initialization.
+ * Provides direct manager access for toolHandlers.
+ * Phase 4: Removed convenience methods - use managers directly.
+ *
+ * @module core/ManagerContext
+ */
+import path from 'path';
+import { createStorageFromPath } from './StorageFactory.js';
+import { EntityManager } from './EntityManager.js';
+import { RelationManager } from './RelationManager.js';
+import { ObservationManager } from './ObservationManager.js';
+import { HierarchyManager } from './HierarchyManager.js';
+import { GraphTraversal } from './GraphTraversal.js';
+import { SearchManager } from '../search/SearchManager.js';
+import { RankedSearch } from '../search/RankedSearch.js';
+import { SemanticSearch, createEmbeddingService, createVectorStore } from '../search/index.js';
+import { IOManager } from '../features/IOManager.js';
+import { TagManager } from '../features/TagManager.js';
+import { AnalyticsManager } from '../features/AnalyticsManager.js';
+import { CompressionManager } from '../features/CompressionManager.js';
+import { ArchiveManager } from '../features/ArchiveManager.js';
+import { getEmbeddingConfig } from '../utils/constants.js';
+/**
+ * Context holding all manager instances with lazy initialization.
+ * Provides direct manager access for toolHandlers.
+ */
+export class ManagerContext {
+    // Type as GraphStorage for manager compatibility; actual instance may be SQLiteStorage
+    // which implements the same interface via duck typing
+    storage;
+    savedSearchesFilePath;
+    tagAliasesFilePath;
+    // Lazy-initialized managers
+    _entityManager;
+    _relationManager;
+    _observationManager;
+    _hierarchyManager;
+    _graphTraversal;
+    _searchManager;
+    _semanticSearch;
+    _rankedSearch;
+    _ioManager;
+    _tagManager;
+    _analyticsManager;
+    _compressionManager;
+    _archiveManager;
+    constructor(memoryFilePath) {
+        // Derive paths for saved searches and tag aliases
+        const dir = path.dirname(memoryFilePath);
+        const basename = path.basename(memoryFilePath, path.extname(memoryFilePath));
+        this.savedSearchesFilePath = path.join(dir, `${basename}-saved-searches.jsonl`);
+        this.tagAliasesFilePath = path.join(dir, `${basename}-tag-aliases.jsonl`);
+        // Use StorageFactory to respect MEMORY_STORAGE_TYPE environment variable
+        // Type assertion: SQLiteStorage implements same interface as GraphStorage
+        this.storage = createStorageFromPath(memoryFilePath);
+    }
+    // ==================== MANAGER ACCESSORS ====================
+    // Use these for direct manager access in toolHandlers
+    /** EntityManager - Entity CRUD and tag operations */
+    get entityManager() {
+        return (this._entityManager ??= new EntityManager(this.storage));
+    }
+    /** RelationManager - Relation CRUD */
+    get relationManager() {
+        return (this._relationManager ??= new RelationManager(this.storage));
+    }
+    /** ObservationManager - Observation CRUD */
+    get observationManager() {
+        return (this._observationManager ??= new ObservationManager(this.storage));
+    }
+    /** HierarchyManager - Entity hierarchy operations */
+    get hierarchyManager() {
+        return (this._hierarchyManager ??= new HierarchyManager(this.storage));
+    }
+    /** GraphTraversal - Phase 4 Sprint 6-8: Graph traversal algorithms */
+    get graphTraversal() {
+        return (this._graphTraversal ??= new GraphTraversal(this.storage));
+    }
+    /** SearchManager - All search operations */
+    get searchManager() {
+        return (this._searchManager ??= new SearchManager(this.storage, this.savedSearchesFilePath));
+    }
+    /**
+     * SemanticSearch - Phase 4 Sprint 12: Semantic similarity search.
+     * Returns null if no embedding provider is configured.
+     */
+    get semanticSearch() {
+        if (this._semanticSearch === undefined) {
+            const config = getEmbeddingConfig();
+            const embeddingService = createEmbeddingService(config);
+            if (embeddingService) {
+                const vectorStore = createVectorStore('jsonl'); // Use in-memory for now
+                this._semanticSearch = new SemanticSearch(embeddingService, vectorStore);
+            }
+            else {
+                this._semanticSearch = null;
+            }
+        }
+        return this._semanticSearch;
+    }
+    /** RankedSearch - Phase 11: TF-IDF/BM25 ranked search for hybrid search */
+    get rankedSearch() {
+        return (this._rankedSearch ??= new RankedSearch(this.storage));
+    }
+    /** IOManager - Import, export, and backup operations */
+    get ioManager() {
+        return (this._ioManager ??= new IOManager(this.storage));
+    }
+    /** TagManager - Tag alias management */
+    get tagManager() {
+        return (this._tagManager ??= new TagManager(this.tagAliasesFilePath));
+    }
+    /** AnalyticsManager - Graph statistics and validation */
+    get analyticsManager() {
+        return (this._analyticsManager ??= new AnalyticsManager(this.storage));
+    }
+    /** CompressionManager - Duplicate detection and entity merging */
+    get compressionManager() {
+        return (this._compressionManager ??= new CompressionManager(this.storage));
+    }
+    /** ArchiveManager - Entity archival operations */
+    get archiveManager() {
+        return (this._archiveManager ??= new ArchiveManager(this.storage));
+    }
+}
+//# sourceMappingURL=ManagerContext.js.map

package/dist/core/ManagerContext.js.map

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

package/dist/core/ObservationManager.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Observation Manager
+ *
+ * Handles observation CRUD operations for entities.
+ * Extracted from EntityManager (Phase 4: Consolidate God Objects).
+ *
+ * @module core/ObservationManager
+ */
+import type { GraphStorage } from './GraphStorage.js';
+/**
+ * Manages observation operations for entities in the knowledge graph.
+ */
+export declare class ObservationManager {
+    private storage;
+    constructor(storage: GraphStorage);
+    /**
+     * Add observations to multiple entities in a single batch operation.
+     *
+     * This method performs the following operations:
+     * - Adds new observations to specified entities
+     * - Filters out duplicate observations (already present)
+     * - Updates lastModified timestamp only if new observations were added
+     * - ATOMIC: All updates are saved in a single operation
+     *
+     * @param observations - Array of entity names and observations to add
+     * @returns Promise resolving to array of results showing which observations were added
+     * @throws {EntityNotFoundError} If any entity is not found
+     *
+     * @example
+     * ```typescript
+     * const manager = new ObservationManager(storage);
+     *
+     * // Add observations to multiple entities
+     * const results = await manager.addObservations([
+     *   { entityName: 'Alice', contents: ['Completed project X', 'Started project Y'] },
+     *   { entityName: 'Bob', contents: ['Joined team meeting'] }
+     * ]);
+     *
+     * // Check what was added (duplicates are filtered out)
+     * results.forEach(r => {
+     *   console.log(`${r.entityName}: added ${r.addedObservations.length} new observations`);
+     * });
+     * ```
+     */
+    addObservations(observations: {
+        entityName: string;
+        contents: string[];
+    }[]): Promise<{
+        entityName: string;
+        addedObservations: string[];
+    }[]>;
+    /**
+     * Delete observations from multiple entities in a single batch operation.
+     *
+     * This method performs the following operations:
+     * - Removes specified observations from entities
+     * - Updates lastModified timestamp only if observations were deleted
+     * - Silently ignores entities that don't exist (no error thrown)
+     * - ATOMIC: All deletions are saved in a single operation
+     *
+     * @param deletions - Array of entity names and observations to delete
+     * @returns Promise that resolves when deletion is complete
+     *
+     * @example
+     * ```typescript
+     * const manager = new ObservationManager(storage);
+     *
+     * // Delete observations from multiple entities
+     * await manager.deleteObservations([
+     *   { entityName: 'Alice', observations: ['Old observation 1', 'Old observation 2'] },
+     *   { entityName: 'Bob', observations: ['Outdated info'] }
+     * ]);
+     *
+     * // Safe to delete from non-existent entities (no error)
+     * await manager.deleteObservations([
+     *   { entityName: 'NonExistent', observations: ['Some text'] }
+     * ]); // No error thrown
+     * ```
+     */
+    deleteObservations(deletions: {
+        entityName: string;
+        observations: string[];
+    }[]): Promise<void>;
+}
+//# sourceMappingURL=ObservationManager.d.ts.map

package/dist/core/ObservationManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObservationManager.d.ts","sourceRoot":"","sources":["../../src/core/ObservationManager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD;;GAEG;AACH,qBAAa,kBAAkB;IACjB,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,YAAY;IAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,eAAe,CACnB,YAAY,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,GACzD,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAiCjE;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,kBAAkB,CACtB,SAAS,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,GAC1D,OAAO,CAAC,IAAI,CAAC;CAyBjB"}