@monoes/memory 1.0.19 → 1.0.21

package/dist/migration-transform.js

@@ -0,0 +1,124 @@
+/**
+ * Batch processing and legacy-entry transformation for MemoryMigrator.
+ * File-size sweep: split out of migration.ts. Mixed into
+ * MemoryMigrator.prototype at the bottom of migration.ts.
+ *
+ * @module v1/memory/migration-transform
+ */
+import { createDefaultEntry, } from './types.js';
+export const migrationTransformMethods = {
+    async processBatch(batch) {
+        for (const legacyEntry of batch) {
+            try {
+                // Validate if enabled
+                if (this.config.validateData) {
+                    const validation = this.validateEntry(legacyEntry);
+                    if (!validation.valid) {
+                        if (this.config.continueOnError) {
+                            this.addError(legacyEntry.key || 'unknown', validation.reason || 'Validation failed', 'VALIDATION_ERROR', false);
+                            this.progress.skipped++;
+                            continue;
+                        }
+                        else {
+                            throw new Error(validation.reason);
+                        }
+                    }
+                }
+                // Transform to new format
+                const newEntry = await this.transformEntry(legacyEntry);
+                // Store in target
+                await this.target.store(newEntry);
+                this.progress.migrated++;
+            }
+            catch (error) {
+                if (this.config.continueOnError) {
+                    this.addError(legacyEntry.key || 'unknown', error.message, 'STORE_ERROR', true);
+                    this.progress.failed++;
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+    },
+    async transformEntry(legacy) {
+        // Map namespace if configured
+        let namespace = legacy.namespace || 'default';
+        if (this.config.namespaceMapping?.[namespace]) {
+            namespace = this.config.namespaceMapping[namespace];
+        }
+        // Determine content
+        const content = typeof legacy.value === 'string' ? legacy.value : JSON.stringify(legacy.value);
+        // Map type if configured
+        let type = 'semantic';
+        if (legacy.metadata?.type && typeof legacy.metadata.type === 'string') {
+            if (this.config.typeMapping?.[legacy.metadata.type]) {
+                type = this.config.typeMapping[legacy.metadata.type];
+            }
+            else if (this.isValidMemoryType(legacy.metadata.type)) {
+                type = legacy.metadata.type;
+            }
+        }
+        // Parse timestamps
+        const createdAt = this.parseTimestamp(legacy.createdAt || legacy.created_at || legacy.timestamp);
+        const updatedAt = this.parseTimestamp(legacy.updatedAt || legacy.updated_at || legacy.timestamp);
+        const input = {
+            key: legacy.key,
+            content,
+            type,
+            namespace,
+            tags: legacy.tags || [],
+            metadata: {
+                ...legacy.metadata,
+                migrated: true,
+                migrationSource: this.config.source,
+                migrationTimestamp: Date.now(),
+                originalValue: legacy.value,
+            },
+        };
+        const entry = createDefaultEntry(input);
+        entry.createdAt = createdAt;
+        entry.updatedAt = updatedAt;
+        // Generate embedding if configured
+        if (this.config.generateEmbeddings && this.embeddingGenerator) {
+            try {
+                entry.embedding = await this.embeddingGenerator(content);
+            }
+            catch (error) {
+                // Log but don't fail
+                this.emit('migration:warning', {
+                    message: `Failed to generate embedding for ${legacy.key}: ${error.message}`,
+                });
+            }
+        }
+        return entry;
+    },
+    validateEntry(entry) {
+        if (!entry.key || typeof entry.key !== 'string') {
+            return { valid: false, reason: 'Missing or invalid key' };
+        }
+        if (entry.value === undefined) {
+            return { valid: false, reason: 'Missing value' };
+        }
+        if (entry.key.length > 500) {
+            return { valid: false, reason: 'Key too long (max 500 chars)' };
+        }
+        return { valid: true };
+    },
+    isValidMemoryType(type) {
+        // 'procedural' kept here for legacy migration compatibility only —
+        // it is no longer a valid MemoryType (procedural memory removed).
+        return ['episodic', 'semantic', 'procedural', 'working', 'cache'].includes(type);
+    },
+    parseTimestamp(value) {
+        if (!value)
+            return Date.now();
+        if (typeof value === 'number') {
+            // Handle both milliseconds and seconds
+            return value > 1e12 ? value : value * 1000;
+        }
+        const parsed = Date.parse(value);
+        return Number.isNaN(parsed) ? Date.now() : parsed;
+    },
+};
+//# sourceMappingURL=migration-transform.js.map

package/dist/migration-transform.js.map

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

package/dist/migration.d.ts

@@ -5,11 +5,24 @@
  * to the unified memory system (any IMemoryBackend — SQLite via
  * better-sqlite3/sql.js as of 2026-07).
  *
+ * File-size sweep: the class's method BODIES are grouped into sibling
+ * modules — legacy source loaders (SQLite/Markdown/JSON/swarm/distributed) in
+ * migration-loaders.ts, and batch processing + legacy-entry transformation in
+ * migration-transform.ts — mixed onto MemoryMigrator.prototype below. Each
+ * stays a real method here (same signature, same visibility) so callers and
+ * TypeScript see no difference; the body is just
+ * `return theSiblingImpl.call(this, ...args)`. Fields those bodies read/write
+ * moved from `private` to `protected` (compile-time only; no runtime change)
+ * — TypeScript allows a standalone function typed `this: MemoryMigrator` to
+ * reach `protected` members but not `private` ones, so `protected` is the
+ * minimum visibility the split needs.
+ *
  * @module v1/memory/migration
  */
 import { EventEmitter } from 'node:events';
-import type { IMemoryBackend } from './types.js';
-import { type EmbeddingGenerator, type MigrationConfig, type MigrationProgress, type MigrationResult, type MigrationSource } from './types.js';
+import { type LegacyEntry } from './migration-loaders.js';
+import type { EmbeddingGenerator, IMemoryBackend, MemoryEntry, MigrationConfig, MigrationProgress, MigrationResult, MigrationSource } from './types.js';
+export type { LegacyEntry };
 /**
  * Memory Migration Manager
  *
@@ -22,10 +35,10 @@ import { type EmbeddingGenerator, type MigrationConfig, type MigrationProgress,
  * - DistributedMemory instances
  */
 export declare class MemoryMigrator extends EventEmitter {
-    private config;
-    private target;
-    private embeddingGenerator?;
-    private progress;
+    protected config: MigrationConfig;
+    protected target: IMemoryBackend;
+    protected embeddingGenerator?: EmbeddingGenerator;
+    protected progress: MigrationProgress;
     constructor(target: IMemoryBackend, config: Partial<MigrationConfig>, embeddingGenerator?: EmbeddingGenerator);
     /**
      * Run the migration
@@ -35,25 +48,28 @@ export declare class MemoryMigrator extends EventEmitter {
      * Get current migration progress
      */
     getProgress(): MigrationProgress;
-    private loadFromSource;
-    private loadFromSQLite;
-    private safeJsonParse;
-    private loadFromMarkdown;
-    private loadFromJSON;
-    private loadFromMemoryManager;
-    private loadFromSwarmMemory;
-    private loadFromDistributedMemory;
-    private processBatch;
-    private transformEntry;
+    protected loadFromSource(): Promise<LegacyEntry[]>;
+    protected loadFromSQLite(): Promise<LegacyEntry[]>;
+    protected safeJsonParse<T>(value: string | undefined, fallback: T): T;
+    protected loadFromMarkdown(): Promise<LegacyEntry[]>;
+    protected loadFromJSON(filePathOverride?: string): Promise<LegacyEntry[]>;
+    protected loadFromMemoryManager(): Promise<LegacyEntry[]>;
+    protected loadFromSwarmMemory(): Promise<LegacyEntry[]>;
+    protected loadFromDistributedMemory(): Promise<LegacyEntry[]>;
+    protected walkDirectory(dir: string, extension: string): Promise<string[]>;
+    protected parseMarkdownEntry(filePath: string, content: string, basePath: string): LegacyEntry | null;
+    protected processBatch(batch: LegacyEntry[]): Promise<void>;
+    protected transformEntry(legacy: LegacyEntry): Promise<MemoryEntry>;
     private initializeProgress;
-    private validateEntry;
-    private addError;
-    private parseTimestamp;
-    private isValidMemoryType;
+    protected validateEntry(entry: LegacyEntry): {
+        valid: boolean;
+        reason?: string;
+    };
+    protected addError(entryId: string, message: string, code: string, recoverable: boolean): void;
+    protected parseTimestamp(value: string | number | undefined): number;
+    protected isValidMemoryType(type: string): boolean;
     private estimateTimeRemaining;
     private generateSummary;
-    private walkDirectory;
-    private parseMarkdownEntry;
 }
 /**
  * Convenience function to create a migrator

package/dist/migration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../src/migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAEL,KAAK,kBAAkB,EAIvB,KAAK,eAAe,EAEpB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,YAAY,CAAC;AA6BpB;;;;;;;;;;GAUG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,kBAAkB,CAAC,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAoB;IAEpC,YACE,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,EAChC,kBAAkB,CAAC,EAAE,kBAAkB,EAOxC;IAED;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,CAuDxC;IAED;;OAEG;IACH,WAAW,IAAI,iBAAiB,CAE/B;YAIa,cAAc;YAmBd,cAAc;IA8D5B,OAAO,CAAC,aAAa;YASP,gBAAgB;YAyBhB,YAAY;YA+BZ,qBAAqB;YAuBrB,mBAAmB;YAmCnB,yBAAyB;YAOzB,YAAY;YA4CZ,cAAc;IAgE5B,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,eAAe;YA6BT,aAAa;IAuB3B,OAAO,CAAC,kBAAkB;CA0D3B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAO,CAAC,eAAe,CAAM,EACtC,kBAAkB,CAAC,EAAE,kBAAkB,GACtC,cAAc,CAEhB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACzD,OAAO,GAAE,OAAO,CAAC,eAAe,CAAM,EACtC,kBAAkB,CAAC,EAAE,kBAAkB,GACtC,OAAO,CAAC,eAAe,EAAE,CAAC,CAU5B;eAEc,cAAc"}
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../src/migration.ts"],"names":[],"mappings":"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"}

package/dist/migration.js

@@ -5,12 +5,23 @@
  * to the unified memory system (any IMemoryBackend — SQLite via
  * better-sqlite3/sql.js as of 2026-07).
  *
+ * File-size sweep: the class's method BODIES are grouped into sibling
+ * modules — legacy source loaders (SQLite/Markdown/JSON/swarm/distributed) in
+ * migration-loaders.ts, and batch processing + legacy-entry transformation in
+ * migration-transform.ts — mixed onto MemoryMigrator.prototype below. Each
+ * stays a real method here (same signature, same visibility) so callers and
+ * TypeScript see no difference; the body is just
+ * `return theSiblingImpl.call(this, ...args)`. Fields those bodies read/write
+ * moved from `private` to `protected` (compile-time only; no runtime change)
+ * — TypeScript allows a standalone function typed `this: MemoryMigrator` to
+ * reach `protected` members but not `private` ones, so `protected` is the
+ * minimum visibility the split needs.
+ *
  * @module v1/memory/migration
  */
 import { EventEmitter } from 'node:events';
-import { promises as fs } from 'node:fs';
-import * as path from 'node:path';
-import { createDefaultEntry, } from './types.js';
+import { migrationLoaderMethods } from './migration-loaders.js';
+import { migrationTransformMethods } from './migration-transform.js';
 /**
  * Default migration configuration
  */
@@ -93,277 +104,43 @@ export class MemoryMigrator extends EventEmitter {
     getProgress() {
         return { ...this.progress };
     }
-    // ===== Source Loaders =====
+    // ===== Source Loaders (bodies live in migration-loaders.ts) =====
     async loadFromSource() {
-        switch (this.config.source) {
-            case 'sqlite':
-                return this.loadFromSQLite();
-            case 'markdown':
-                return this.loadFromMarkdown();
-            case 'json':
-                return this.loadFromJSON();
-            case 'memory-manager':
-                return this.loadFromMemoryManager();
-            case 'monoswarm-memory':
-                return this.loadFromSwarmMemory();
-            case 'distributed-memory':
-                return this.loadFromDistributedMemory();
-            default:
-                throw new Error(`Unknown migration source: ${this.config.source}`);
-        }
+        return migrationLoaderMethods.loadFromSource.call(this);
     }
     async loadFromSQLite() {
-        const dbPath = this.config.sourcePath;
-        // A .json-suffixed "sqlite" source is actually an exported JSON dump —
-        // route it through the real JSON loader instead of opening it as a DB.
-        if (dbPath.endsWith('.json')) {
-            return this.loadFromJSON();
-        }
-        let Database;
-        try {
-            const mod = await import('better-sqlite3');
-            Database = mod.default;
-        }
-        catch (error) {
-            throw new Error(`Cannot read SQLite source "${dbPath}": better-sqlite3 is not available (${error.message})`);
-        }
-        let db;
-        try {
-            db = new Database(dbPath, { readonly: true, fileMustExist: true });
-        }
-        catch (error) {
-            throw new Error(`Failed to open SQLite database "${dbPath}": ${error.message}`);
-        }
-        try {
-            const tables = db
-                .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='memory_entries'")
-                .all();
-            if (tables.length === 0) {
-                throw new Error(`SQLite source "${dbPath}" has no "memory_entries" table — not a recognized memory backend database`);
-            }
-            const rows = db.prepare('SELECT * FROM memory_entries').all();
-            return rows.map((row) => ({
-                id: row.id,
-                key: row.key,
-                value: row.content,
-                namespace: row.namespace,
-                tags: this.safeJsonParse(row.tags, []),
-                metadata: this.safeJsonParse(row.metadata, {}),
-                createdAt: row.created_at,
-                updatedAt: row.updated_at,
-            }));
-        }
-        finally {
-            db.close();
-        }
+        return migrationLoaderMethods.loadFromSQLite.call(this);
     }
     safeJsonParse(value, fallback) {
-        if (!value)
-            return fallback;
-        try {
-            return JSON.parse(value);
-        }
-        catch {
-            return fallback;
-        }
+        return migrationLoaderMethods.safeJsonParse.call(this, value, fallback);
     }
     async loadFromMarkdown() {
-        const entries = [];
-        const basePath = this.config.sourcePath;
-        try {
-            const files = await this.walkDirectory(basePath, '.md');
-            for (const filePath of files) {
-                try {
-                    const content = await fs.readFile(filePath, 'utf-8');
-                    const entry = this.parseMarkdownEntry(filePath, content, basePath);
-                    if (entry) {
-                        entries.push(entry);
-                    }
-                }
-                catch (error) {
-                    this.addError(filePath, error.message, 'PARSE_ERROR', true);
-                }
-            }
-            return entries;
-        }
-        catch (error) {
-            throw new Error(`Failed to load Markdown: ${error.message}`);
-        }
+        return migrationLoaderMethods.loadFromMarkdown.call(this);
     }
     async loadFromJSON(filePathOverride) {
-        const filePath = filePathOverride ?? this.config.sourcePath;
-        try {
-            const content = await fs.readFile(filePath, 'utf-8');
-            const data = JSON.parse(content);
-            // Handle different JSON formats
-            if (Array.isArray(data)) {
-                return data;
-            }
-            else if (data.entries) {
-                return data.entries;
-            }
-            else if (typeof data === 'object') {
-                // Assume it's a namespace -> entries map
-                const entries = [];
-                for (const [namespace, namespaceEntries] of Object.entries(data)) {
-                    if (Array.isArray(namespaceEntries)) {
-                        for (const entry of namespaceEntries) {
-                            entries.push({ ...entry, namespace });
-                        }
-                    }
-                }
-                return entries;
-            }
-            return [];
-        }
-        catch (error) {
-            throw new Error(`Failed to load JSON: ${error.message}`);
-        }
+        return migrationLoaderMethods.loadFromJSON.call(this, filePathOverride);
     }
     async loadFromMemoryManager() {
-        // Would integrate with existing MemoryManager instance
-        // For now, try to load from common paths
-        const possiblePaths = ['./memory/memory-store.json', './.swarm/memory.db', './memory.json'];
-        for (const p of possiblePaths) {
-            try {
-                const fullPath = path.resolve(this.config.sourcePath, p);
-                await fs.access(fullPath);
-                // #85: read the verified fullPath, not this.config.sourcePath — the
-                // latter is the search directory, so readFile() on it throws EISDIR,
-                // the catch swallowed it, and the migration silently returned [].
-                // `await` is required: a bare `return promise` inside try/catch does
-                // not route rejections through the catch below.
-                const stat = await fs.stat(fullPath);
-                if (!stat.isFile())
-                    continue;
-                return await this.loadFromJSON(fullPath);
-            }
-            catch { }
-        }
-        return [];
+        return migrationLoaderMethods.loadFromMemoryManager.call(this);
     }
     async loadFromSwarmMemory() {
-        // Would integrate with SwarmMemory partitions
-        const entries = [];
-        const basePath = this.config.sourcePath;
-        try {
-            // Check for swarm memory directory structure
-            const partitionsPath = path.join(basePath, '.swarm', 'memory');
-            const files = await this.walkDirectory(partitionsPath, '.json');
-            for (const filePath of files) {
-                try {
-                    const content = await fs.readFile(filePath, 'utf-8');
-                    const data = JSON.parse(content);
-                    // Extract namespace from file path
-                    const relativePath = path.relative(partitionsPath, filePath);
-                    const namespace = path.dirname(relativePath).replace(/\\/g, '/');
-                    if (Array.isArray(data)) {
-                        entries.push(...data.map((e) => ({ ...e, namespace })));
-                    }
-                    else if (data.entries) {
-                        entries.push(...data.entries.map((e) => ({ ...e, namespace })));
-                    }
-                }
-                catch (error) {
-                    this.addError(filePath, error.message, 'PARSE_ERROR', true);
-                }
-            }
-            return entries;
-        }
-        catch (_error) {
-            return [];
-        }
+        return migrationLoaderMethods.loadFromSwarmMemory.call(this);
     }
     async loadFromDistributedMemory() {
-        // Would integrate with DistributedMemorySystem nodes
-        return this.loadFromSwarmMemory(); // Similar structure
+        return migrationLoaderMethods.loadFromDistributedMemory.call(this);
     }
-    // ===== Batch Processing =====
+    async walkDirectory(dir, extension) {
+        return migrationLoaderMethods.walkDirectory.call(this, dir, extension);
+    }
+    parseMarkdownEntry(filePath, content, basePath) {
+        return migrationLoaderMethods.parseMarkdownEntry.call(this, filePath, content, basePath);
+    }
+    // ===== Batch Processing (bodies live in migration-transform.ts) =====
     async processBatch(batch) {
-        for (const legacyEntry of batch) {
-            try {
-                // Validate if enabled
-                if (this.config.validateData) {
-                    const validation = this.validateEntry(legacyEntry);
-                    if (!validation.valid) {
-                        if (this.config.continueOnError) {
-                            this.addError(legacyEntry.key || 'unknown', validation.reason || 'Validation failed', 'VALIDATION_ERROR', false);
-                            this.progress.skipped++;
-                            continue;
-                        }
-                        else {
-                            throw new Error(validation.reason);
-                        }
-                    }
-                }
-                // Transform to new format
-                const newEntry = await this.transformEntry(legacyEntry);
-                // Store in target
-                await this.target.store(newEntry);
-                this.progress.migrated++;
-            }
-            catch (error) {
-                if (this.config.continueOnError) {
-                    this.addError(legacyEntry.key || 'unknown', error.message, 'STORE_ERROR', true);
-                    this.progress.failed++;
-                }
-                else {
-                    throw error;
-                }
-            }
-        }
+        return migrationTransformMethods.processBatch.call(this, batch);
     }
     async transformEntry(legacy) {
-        // Map namespace if configured
-        let namespace = legacy.namespace || 'default';
-        if (this.config.namespaceMapping?.[namespace]) {
-            namespace = this.config.namespaceMapping[namespace];
-        }
-        // Determine content
-        const content = typeof legacy.value === 'string' ? legacy.value : JSON.stringify(legacy.value);
-        // Map type if configured
-        let type = 'semantic';
-        if (legacy.metadata?.type && typeof legacy.metadata.type === 'string') {
-            if (this.config.typeMapping?.[legacy.metadata.type]) {
-                type = this.config.typeMapping[legacy.metadata.type];
-            }
-            else if (this.isValidMemoryType(legacy.metadata.type)) {
-                type = legacy.metadata.type;
-            }
-        }
-        // Parse timestamps
-        const createdAt = this.parseTimestamp(legacy.createdAt || legacy.created_at || legacy.timestamp);
-        const updatedAt = this.parseTimestamp(legacy.updatedAt || legacy.updated_at || legacy.timestamp);
-        const input = {
-            key: legacy.key,
-            content,
-            type,
-            namespace,
-            tags: legacy.tags || [],
-            metadata: {
-                ...legacy.metadata,
-                migrated: true,
-                migrationSource: this.config.source,
-                migrationTimestamp: Date.now(),
-                originalValue: legacy.value,
-            },
-        };
-        const entry = createDefaultEntry(input);
-        entry.createdAt = createdAt;
-        entry.updatedAt = updatedAt;
-        // Generate embedding if configured
-        if (this.config.generateEmbeddings && this.embeddingGenerator) {
-            try {
-                entry.embedding = await this.embeddingGenerator(content);
-            }
-            catch (error) {
-                // Log but don't fail
-                this.emit('migration:warning', {
-                    message: `Failed to generate embedding for ${legacy.key}: ${error.message}`,
-                });
-            }
-        }
-        return entry;
+        return migrationTransformMethods.transformEntry.call(this, legacy);
     }
     // ===== Helper Methods =====
     initializeProgress() {
@@ -380,16 +157,7 @@ export class MemoryMigrator extends EventEmitter {
         };
     }
     validateEntry(entry) {
-        if (!entry.key || typeof entry.key !== 'string') {
-            return { valid: false, reason: 'Missing or invalid key' };
-        }
-        if (entry.value === undefined) {
-            return { valid: false, reason: 'Missing value' };
-        }
-        if (entry.key.length > 500) {
-            return { valid: false, reason: 'Key too long (max 500 chars)' };
-        }
-        return { valid: true };
+        return migrationTransformMethods.validateEntry.call(this, entry);
     }
     addError(entryId, message, code, recoverable) {
         const error = {
@@ -402,19 +170,10 @@ export class MemoryMigrator extends EventEmitter {
         this.emit('migration:error', error);
     }
     parseTimestamp(value) {
-        if (!value)
-            return Date.now();
-        if (typeof value === 'number') {
-            // Handle both milliseconds and seconds
-            return value > 1e12 ? value : value * 1000;
-        }
-        const parsed = Date.parse(value);
-        return Number.isNaN(parsed) ? Date.now() : parsed;
+        return migrationTransformMethods.parseTimestamp.call(this, value);
     }
     isValidMemoryType(type) {
-        // 'procedural' kept here for legacy migration compatibility only —
-        // it is no longer a valid MemoryType (procedural memory removed).
-        return ['episodic', 'semantic', 'procedural', 'working', 'cache'].includes(type);
+        return migrationTransformMethods.isValidMemoryType.call(this, type);
     }
     estimateTimeRemaining(startTime, completed, total) {
         if (completed === 0)
@@ -445,78 +204,6 @@ export class MemoryMigrator extends EventEmitter {
         }
         return summary;
     }
-    async walkDirectory(dir, extension) {
-        const files = [];
-        try {
-            const entries = await fs.readdir(dir, { withFileTypes: true });
-            for (const entry of entries) {
-                const fullPath = path.join(dir, entry.name);
-                if (entry.isDirectory()) {
-                    const subFiles = await this.walkDirectory(fullPath, extension);
-                    files.push(...subFiles);
-                }
-                else if (entry.isFile() && entry.name.endsWith(extension)) {
-                    files.push(fullPath);
-                }
-            }
-        }
-        catch (_error) {
-            // Directory doesn't exist or isn't readable
-        }
-        return files;
-    }
-    parseMarkdownEntry(filePath, content, basePath) {
-        // Extract frontmatter if present
-        const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
-        const metadata = {};
-        let body = content;
-        if (frontmatterMatch) {
-            try {
-                // Simple YAML-like parsing
-                const frontmatter = frontmatterMatch[1];
-                for (const line of frontmatter.split('\n')) {
-                    const colonIndex = line.indexOf(':');
-                    if (colonIndex > 0) {
-                        const key = line.substring(0, colonIndex).trim();
-                        let value = line.substring(colonIndex + 1).trim();
-                        // Parse common types
-                        if (value === 'true')
-                            value = true;
-                        else if (value === 'false')
-                            value = false;
-                        else if (typeof value === 'string' && /^\d+$/.test(value))
-                            value = parseInt(value, 10);
-                        else if (typeof value === 'string' && value.startsWith('[') && value.endsWith(']')) {
-                            try {
-                                value = JSON.parse(value.replace(/'/g, '"'));
-                            }
-                            catch {
-                                // Keep as string
-                            }
-                        }
-                        metadata[key] = value;
-                    }
-                }
-                body = frontmatterMatch[2];
-            }
-            catch {
-                // Failed to parse frontmatter, use whole content
-            }
-        }
-        // Derive key from file path
-        const relativePath = path.relative(basePath, filePath);
-        const key = relativePath.replace(/\\/g, '/').replace(/\.md$/, '').replace(/\//g, ':');
-        // Derive namespace from directory structure
-        const namespace = path.dirname(relativePath).replace(/\\/g, '/') || 'default';
-        return {
-            key,
-            value: body.trim(),
-            namespace,
-            tags: Array.isArray(metadata.tags) ? metadata.tags : [],
-            metadata,
-            timestamp: Date.now(),
-        };
-    }
 }
 /**
  * Convenience function to create a migrator