@claude-flow/memory 3.0.0-alpha.10 → 3.0.0-alpha.12

package/dist/rvf-learning-store.js

@@ -0,0 +1,295 @@
+/**
+ * RvfLearningStore - Persistent storage for SONA learning artifacts
+ *
+ * Stores patterns, LoRA adapters, EWC state, and trajectories in a
+ * binary-header JSON-lines file format for fast append and rebuild.
+ *
+ * File format:
+ *   4-byte magic "RVLS" + newline
+ *   One JSON record per line: {"type":"pattern"|"lora"|"ewc"|"trajectory","data":{...}}
+ *
+ * @module @claude-flow/memory/rvf-learning-store
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// ===== Constants =====
+const MAGIC_HEADER = 'RVLS';
+const DEFAULT_DIMENSIONS = 64;
+const DEFAULT_AUTO_PERSIST_MS = 30_000;
+// ===== Helpers =====
+function ensureDirectory(filePath) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+// ===== RvfLearningStore =====
+/**
+ * Persistent store for SONA learning artifacts.
+ *
+ * Maintains in-memory maps for fast reads and flushes to a JSON-lines
+ * file with a binary header on persist(). On initialize(), the file is
+ * read line-by-line to rebuild state.
+ *
+ * @example
+ * ```typescript
+ * const store = new RvfLearningStore({ storePath: './data/learning.rvls' });
+ * await store.initialize();
+ *
+ * await store.savePatterns([{ id: 'p1', type: 'query_response', ... }]);
+ * await store.persist();
+ * await store.close();
+ * ```
+ */
+export class RvfLearningStore {
+    config;
+    patterns = new Map();
+    loraAdapters = new Map();
+    ewcState = null;
+    trajectories = [];
+    dirty = false;
+    initialized = false;
+    autoPersistTimer = null;
+    constructor(config) {
+        this.config = {
+            storePath: config.storePath,
+            dimensions: config.dimensions ?? DEFAULT_DIMENSIONS,
+            autoPersistInterval: config.autoPersistInterval ?? DEFAULT_AUTO_PERSIST_MS,
+            verbose: config.verbose ?? false,
+        };
+    }
+    /**
+     * Initialize the store by loading any existing data from disk.
+     * Creates the parent directory if it does not exist.
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        ensureDirectory(this.config.storePath);
+        if (fs.existsSync(this.config.storePath)) {
+            await this.loadFromDisk();
+        }
+        if (this.config.autoPersistInterval > 0) {
+            this.autoPersistTimer = setInterval(() => void this.persist().catch(() => { }), this.config.autoPersistInterval);
+            // Allow the process to exit even if the timer is active
+            if (this.autoPersistTimer.unref) {
+                this.autoPersistTimer.unref();
+            }
+        }
+        this.initialized = true;
+        this.log('Store initialized');
+    }
+    // ===== Pattern operations =====
+    /**
+     * Save or update patterns. Existing patterns with matching IDs are
+     * overwritten; new patterns are added.
+     *
+     * @returns The number of patterns stored
+     */
+    async savePatterns(patterns) {
+        this.ensureInitialized();
+        let count = 0;
+        for (const pattern of patterns) {
+            this.patterns.set(pattern.id, { ...pattern });
+            count++;
+        }
+        this.dirty = true;
+        return count;
+    }
+    /** Load all patterns currently held in memory */
+    async loadPatterns() {
+        this.ensureInitialized();
+        return Array.from(this.patterns.values());
+    }
+    /** Return the number of stored patterns */
+    async getPatternCount() {
+        this.ensureInitialized();
+        return this.patterns.size;
+    }
+    // ===== LoRA operations =====
+    /** Save or update a LoRA adapter record */
+    async saveLoraAdapter(record) {
+        this.ensureInitialized();
+        this.loraAdapters.set(record.id, { ...record });
+        this.dirty = true;
+    }
+    /** Load all LoRA adapter records */
+    async loadLoraAdapters() {
+        this.ensureInitialized();
+        return Array.from(this.loraAdapters.values());
+    }
+    /** Delete a LoRA adapter by ID */
+    async deleteLoraAdapter(id) {
+        this.ensureInitialized();
+        const existed = this.loraAdapters.delete(id);
+        if (existed)
+            this.dirty = true;
+        return existed;
+    }
+    // ===== EWC operations =====
+    /** Save EWC state (replaces any existing state) */
+    async saveEwcState(record) {
+        this.ensureInitialized();
+        this.ewcState = { ...record };
+        this.dirty = true;
+    }
+    /** Load the EWC state, or null if none has been stored */
+    async loadEwcState() {
+        this.ensureInitialized();
+        return this.ewcState ? { ...this.ewcState } : null;
+    }
+    // ===== Trajectory operations =====
+    /** Append a trajectory record (append-only, never overwritten) */
+    async appendTrajectory(record) {
+        this.ensureInitialized();
+        this.trajectories.push({ ...record });
+        this.dirty = true;
+    }
+    /**
+     * Return stored trajectories, newest first.
+     * @param limit Maximum number to return (default: all)
+     */
+    async getTrajectories(limit) {
+        this.ensureInitialized();
+        const sorted = [...this.trajectories].reverse();
+        return limit !== undefined ? sorted.slice(0, limit) : sorted;
+    }
+    /** Return the number of stored trajectories */
+    async getTrajectoryCount() {
+        this.ensureInitialized();
+        return this.trajectories.length;
+    }
+    // ===== Lifecycle =====
+    /**
+     * Flush all in-memory state to disk. The entire file is rewritten
+     * to ensure consistency (patterns may have been updated in-place).
+     */
+    async persist() {
+        if (!this.dirty)
+            return;
+        ensureDirectory(this.config.storePath);
+        const lines = [MAGIC_HEADER];
+        // Patterns
+        for (const pattern of this.patterns.values()) {
+            lines.push(JSON.stringify({ type: 'pattern', data: pattern }));
+        }
+        // LoRA adapters
+        for (const lora of this.loraAdapters.values()) {
+            lines.push(JSON.stringify({ type: 'lora', data: lora }));
+        }
+        // EWC state
+        if (this.ewcState) {
+            lines.push(JSON.stringify({ type: 'ewc', data: this.ewcState }));
+        }
+        // Trajectories
+        for (const traj of this.trajectories) {
+            lines.push(JSON.stringify({ type: 'trajectory', data: traj }));
+        }
+        const content = lines.join('\n') + '\n';
+        const tmpPath = this.config.storePath + '.tmp';
+        await fs.promises.writeFile(tmpPath, content, 'utf-8');
+        await fs.promises.rename(tmpPath, this.config.storePath);
+        this.dirty = false;
+        this.log(`Persisted: ${this.patterns.size} patterns, ${this.loraAdapters.size} LoRA, ${this.trajectories.length} trajectories`);
+    }
+    /** Persist and release resources */
+    async close() {
+        if (this.autoPersistTimer) {
+            clearInterval(this.autoPersistTimer);
+            this.autoPersistTimer = null;
+        }
+        if (this.dirty) {
+            await this.persist();
+        }
+        this.initialized = false;
+        this.log('Store closed');
+    }
+    // ===== Stats =====
+    /** Return summary statistics about the store */
+    async getStats() {
+        this.ensureInitialized();
+        let fileSizeBytes = 0;
+        try {
+            const stat = await fs.promises.stat(this.config.storePath);
+            fileSizeBytes = stat.size;
+        }
+        catch {
+            // File may not exist yet if nothing has been persisted
+        }
+        return {
+            patterns: this.patterns.size,
+            loraAdapters: this.loraAdapters.size,
+            trajectories: this.trajectories.length,
+            hasEwcState: this.ewcState !== null,
+            fileSizeBytes,
+        };
+    }
+    // ===== Private =====
+    async loadFromDisk() {
+        let content;
+        try {
+            content = await fs.promises.readFile(this.config.storePath, 'utf-8');
+        }
+        catch {
+            return;
+        }
+        const lines = content.split('\n').filter((l) => l.trim().length > 0);
+        if (lines.length === 0)
+            return;
+        // Verify magic header
+        if (lines[0] !== MAGIC_HEADER) {
+            this.log(`Warning: invalid magic header "${lines[0]}", expected "${MAGIC_HEADER}"`);
+            return;
+        }
+        let parsed = 0;
+        let errors = 0;
+        for (let i = 1; i < lines.length; i++) {
+            try {
+                const record = JSON.parse(lines[i]);
+                this.applyRecord(record);
+                parsed++;
+            }
+            catch {
+                errors++;
+                this.log(`Warning: failed to parse line ${i + 1}`);
+            }
+        }
+        this.log(`Loaded from disk: ${parsed} records, ${errors} errors`);
+    }
+    applyRecord(record) {
+        switch (record.type) {
+            case 'pattern': {
+                const p = record.data;
+                this.patterns.set(p.id, p);
+                break;
+            }
+            case 'lora': {
+                const l = record.data;
+                this.loraAdapters.set(l.id, l);
+                break;
+            }
+            case 'ewc': {
+                this.ewcState = record.data;
+                break;
+            }
+            case 'trajectory': {
+                this.trajectories.push(record.data);
+                break;
+            }
+            default:
+                this.log(`Warning: unknown record type "${record.type}"`);
+        }
+    }
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error('RvfLearningStore has not been initialized. Call initialize() first.');
+        }
+    }
+    log(message) {
+        if (this.config.verbose) {
+            // eslint-disable-next-line no-console
+            console.log(`[RvfLearningStore] ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=rvf-learning-store.js.map

package/dist/rvf-learning-store.js.map

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

package/dist/rvf-migration.d.ts

@@ -0,0 +1,45 @@
+/** Options for controlling the migration process. */
+export interface RvfMigrationOptions {
+    verbose?: boolean;
+    /** Entries per batch (default 500). */
+    batchSize?: number;
+    /** Embedding dimensions for target RVF file (default 1536). */
+    dimensions?: number;
+    onProgress?: (progress: {
+        current: number;
+        total: number;
+        phase: string;
+    }) => void;
+}
+/** Result returned after a migration completes. */
+export interface RvfMigrationResult {
+    success: boolean;
+    entriesMigrated: number;
+    sourceFormat: string;
+    targetFormat: string;
+    durationMs: number;
+    errors: string[];
+}
+/**
+ * Bidirectional migration utility between RVF and legacy memory formats.
+ *
+ * All methods are static — no instantiation required.
+ */
+export declare class RvfMigrator {
+    /** Migrate a JSON memory file to RVF format. */
+    static fromJsonFile(jsonPath: string, rvfPath: string, options?: RvfMigrationOptions): Promise<RvfMigrationResult>;
+    /** Migrate a SQLite (better-sqlite3 / sql.js) database to RVF. */
+    static fromSqlite(dbPath: string, rvfPath: string, options?: RvfMigrationOptions): Promise<RvfMigrationResult>;
+    /** Export an RVF file back to a JSON array (backward compatibility). */
+    static toJsonFile(rvfPath: string, jsonPath: string): Promise<RvfMigrationResult>;
+    /**
+     * Detect file format by magic bytes.
+     * - RVF\0 (0x52 0x56 0x46 0x00) -> 'rvf'
+     * - SQLi  (0x53 0x51 0x4C 0x69) -> 'sqlite'
+     * - Leading [ or {              -> 'json'
+     */
+    static detectFormat(filePath: string): Promise<'rvf' | 'json' | 'sqlite' | 'unknown'>;
+    /** Auto-detect source format and migrate to RVF. */
+    static autoMigrate(sourcePath: string, targetRvfPath: string, options?: RvfMigrationOptions): Promise<RvfMigrationResult>;
+}
+//# sourceMappingURL=rvf-migration.d.ts.map

package/dist/rvf-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rvf-migration.d.ts","sourceRoot":"","sources":["../src/rvf-migration.ts"],"names":[],"mappings":"AAYA,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACpF;AAED,mDAAmD;AACnD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AA6ID;;;;GAIG;AACH,qBAAa,WAAW;IACtB,gDAAgD;WACnC,YAAY,CACvB,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GACnE,OAAO,CAAC,kBAAkB,CAAC;IAY9B,kEAAkE;WACrD,UAAU,CACrB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GACjE,OAAO,CAAC,kBAAkB,CAAC;IAW9B,wEAAwE;WAC3D,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAavF;;;;;OAKG;WACU,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAc3F,oDAAoD;WACvC,WAAW,CACtB,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAC3E,OAAO,CAAC,kBAAkB,CAAC;CAU/B"}

package/dist/rvf-migration.js

@@ -0,0 +1,254 @@
+/**
+ * RVF Migration Utility — bidirectional migration between RVF and legacy
+ * formats (JSON files, sql.js / better-sqlite3 databases).
+ * @module @claude-flow/memory/rvf-migration
+ */
+import { readFile, writeFile, rename, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { RvfBackend } from './rvf-backend.js';
+import { generateMemoryId } from './types.js';
+// -- Internal helpers -------------------------------------------------------
+function fillDefaults(raw) {
+    const now = Date.now();
+    return {
+        id: raw.id ?? generateMemoryId(),
+        key: raw.key ?? '',
+        content: raw.content ?? '',
+        type: raw.type ?? 'semantic',
+        namespace: raw.namespace ?? 'default',
+        tags: raw.tags ?? [],
+        metadata: raw.metadata ?? {},
+        ownerId: raw.ownerId,
+        accessLevel: raw.accessLevel ?? 'private',
+        createdAt: raw.createdAt ?? now,
+        updatedAt: raw.updatedAt ?? now,
+        expiresAt: raw.expiresAt,
+        version: raw.version ?? 1,
+        references: raw.references ?? [],
+        accessCount: raw.accessCount ?? 0,
+        lastAccessedAt: raw.lastAccessedAt ?? now,
+        embedding: deserializeEmbedding(raw.embedding),
+    };
+}
+function deserializeEmbedding(value) {
+    if (!value)
+        return undefined;
+    if (value instanceof Float32Array)
+        return value;
+    if (value instanceof Buffer || value instanceof Uint8Array) {
+        if (value.byteLength === 0)
+            return undefined;
+        const out = new Float32Array(value.byteLength / 4);
+        const view = new DataView(value.buffer, value.byteOffset, value.byteLength);
+        for (let i = 0; i < out.length; i++)
+            out[i] = view.getFloat32(i * 4, true);
+        return out;
+    }
+    if (Array.isArray(value))
+        return new Float32Array(value);
+    return undefined;
+}
+function serializeForJson(entry) {
+    return { ...entry, embedding: entry.embedding ? Array.from(entry.embedding) : undefined };
+}
+function validateMigrationPath(p) {
+    if (!p || typeof p !== 'string')
+        throw new Error('Path must be a non-empty string');
+    if (p.includes('\0'))
+        throw new Error('Path contains null bytes');
+}
+async function ensureDir(filePath) {
+    validateMigrationPath(filePath);
+    const dir = dirname(resolve(filePath));
+    if (!existsSync(dir))
+        await mkdir(dir, { recursive: true });
+}
+async function atomicWrite(targetPath, data) {
+    validateMigrationPath(targetPath);
+    const abs = resolve(targetPath);
+    const tmp = abs + '.tmp.' + Date.now();
+    await ensureDir(abs);
+    await writeFile(tmp, data, typeof data === 'string' ? 'utf-8' : undefined);
+    await rename(tmp, abs);
+}
+function mkResult(success, entriesMigrated, sourceFormat, targetFormat, startMs, errors) {
+    return { success, entriesMigrated, sourceFormat, targetFormat, durationMs: Date.now() - startMs, errors };
+}
+function normalizeSqliteRow(row) {
+    const out = { ...row };
+    for (const col of ['tags', 'metadata', 'references']) {
+        if (typeof out[col] === 'string') {
+            try {
+                out[col] = JSON.parse(out[col]);
+            }
+            catch {
+                out[col] = col === 'metadata' ? {} : [];
+            }
+        }
+    }
+    return out;
+}
+async function readSqliteRows(dbPath) {
+    // Attempt better-sqlite3
+    try {
+        const mod = await import('better-sqlite3');
+        const Database = mod.default ?? mod;
+        const db = new Database(dbPath, { readonly: true });
+        try {
+            return db.prepare('SELECT * FROM memory_entries').all();
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch { /* unavailable */ }
+    // Attempt sql.js
+    try {
+        const mod = await import('sql.js');
+        const SQL = await (mod.default ?? mod)();
+        const db = new SQL.Database(await readFile(dbPath));
+        try {
+            const stmt = db.prepare('SELECT * FROM memory_entries');
+            const rows = [];
+            while (stmt.step())
+                rows.push(stmt.getAsObject());
+            stmt.free();
+            return rows;
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch { /* unavailable */ }
+    throw new Error('Cannot read SQLite: install better-sqlite3 or sql.js');
+}
+// -- Batch migration helper -------------------------------------------------
+async function migrateBatches(items, rvfPath, options, normalize) {
+    const batchSize = options.batchSize ?? 500;
+    const dimensions = options.dimensions ?? 1536;
+    const backend = new RvfBackend({ databasePath: rvfPath, dimensions, verbose: options.verbose });
+    await backend.initialize();
+    let migrated = 0;
+    const errors = [];
+    try {
+        for (let i = 0; i < items.length; i += batchSize) {
+            const batch = items.slice(i, i + batchSize);
+            const entries = [];
+            for (const item of batch) {
+                try {
+                    entries.push(fillDefaults(normalize ? normalize(item) : item));
+                }
+                catch (e) {
+                    errors.push(`Entry ${item.id ?? i}: ${e.message}`);
+                }
+            }
+            if (entries.length > 0) {
+                await backend.bulkInsert(entries);
+                migrated += entries.length;
+            }
+            options.onProgress?.({ current: Math.min(i + batchSize, items.length), total: items.length, phase: 'migrating' });
+        }
+    }
+    finally {
+        await backend.shutdown();
+    }
+    return { migrated, errors };
+}
+/**
+ * Bidirectional migration utility between RVF and legacy memory formats.
+ *
+ * All methods are static — no instantiation required.
+ */
+export class RvfMigrator {
+    /** Migrate a JSON memory file to RVF format. */
+    static async fromJsonFile(jsonPath, rvfPath, options = {}) {
+        const start = Date.now();
+        const raw = await readFile(jsonPath, 'utf-8');
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (e) {
+            return mkResult(false, 0, 'json', 'rvf', start, [`Invalid JSON: ${e.message}`]);
+        }
+        const items = Array.isArray(parsed) ? parsed : [parsed];
+        const { migrated, errors } = await migrateBatches(items, rvfPath, options);
+        if (options.verbose)
+            console.log(`[RvfMigrator] Migrated ${migrated} entries from JSON to RVF`);
+        return mkResult(errors.length === 0, migrated, 'json', 'rvf', start, errors);
+    }
+    /** Migrate a SQLite (better-sqlite3 / sql.js) database to RVF. */
+    static async fromSqlite(dbPath, rvfPath, options = {}) {
+        const start = Date.now();
+        let rows;
+        try {
+            rows = await readSqliteRows(dbPath);
+        }
+        catch (e) {
+            return mkResult(false, 0, 'sqlite', 'rvf', start, [e.message]);
+        }
+        options.onProgress?.({ current: 0, total: rows.length, phase: 'reading' });
+        const { migrated, errors } = await migrateBatches(rows, rvfPath, options, normalizeSqliteRow);
+        if (options.verbose)
+            console.log(`[RvfMigrator] Migrated ${migrated} entries from SQLite to RVF`);
+        return mkResult(errors.length === 0, migrated, 'sqlite', 'rvf', start, errors);
+    }
+    /** Export an RVF file back to a JSON array (backward compatibility). */
+    static async toJsonFile(rvfPath, jsonPath) {
+        const start = Date.now();
+        const backend = new RvfBackend({ databasePath: rvfPath });
+        await backend.initialize();
+        let entries;
+        try {
+            entries = await backend.query({ type: 'hybrid', limit: Number.MAX_SAFE_INTEGER });
+        }
+        finally {
+            await backend.shutdown();
+        }
+        const warnings = [];
+        if (entries.length === 0)
+            warnings.push('Source RVF file contained no entries');
+        await atomicWrite(jsonPath, JSON.stringify(entries.map(serializeForJson), null, 2));
+        return mkResult(true, entries.length, 'rvf', 'json', start, warnings);
+    }
+    /**
+     * Detect file format by magic bytes.
+     * - RVF\0 (0x52 0x56 0x46 0x00) -> 'rvf'
+     * - SQLi  (0x53 0x51 0x4C 0x69) -> 'sqlite'
+     * - Leading [ or {              -> 'json'
+     */
+    static async detectFormat(filePath) {
+        if (!existsSync(filePath))
+            return 'unknown';
+        const fd = await import('node:fs').then(m => m.promises.open(filePath, 'r'));
+        try {
+            const buf = Buffer.alloc(16);
+            await fd.read(buf, 0, 16, 0);
+            if (buf[0] === 0x52 && buf[1] === 0x56 && buf[2] === 0x46 && buf[3] === 0x00)
+                return 'rvf';
+            if (buf[0] === 0x53 && buf[1] === 0x51 && buf[2] === 0x4C && buf[3] === 0x69)
+                return 'sqlite';
+            const head = buf.toString('utf-8').trimStart();
+            if (head.startsWith('[') || head.startsWith('{'))
+                return 'json';
+            return 'unknown';
+        }
+        finally {
+            await fd.close();
+        }
+    }
+    /** Auto-detect source format and migrate to RVF. */
+    static async autoMigrate(sourcePath, targetRvfPath, options = {}) {
+        const format = await RvfMigrator.detectFormat(sourcePath);
+        if (options.verbose)
+            console.log(`[RvfMigrator] Detected source format: ${format}`);
+        switch (format) {
+            case 'json': return RvfMigrator.fromJsonFile(sourcePath, targetRvfPath, options);
+            case 'sqlite': return RvfMigrator.fromSqlite(sourcePath, targetRvfPath, options);
+            case 'rvf': return { success: true, entriesMigrated: 0, sourceFormat: 'rvf', targetFormat: 'rvf', durationMs: 0, errors: [] };
+            default: return { success: false, entriesMigrated: 0, sourceFormat: 'unknown', targetFormat: 'rvf', durationMs: 0, errors: [`Unrecognized format: ${sourcePath}`] };
+        }
+    }
+}
+//# sourceMappingURL=rvf-migration.js.map

package/dist/rvf-migration.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-flow/memory",
-  "version": "3.0.0-alpha.10",
+  "version": "3.0.0-alpha.12",
   "type": "module",
   "description": "Memory module - AgentDB unification, HNSW indexing, vector search, hybrid SQLite+AgentDB backend (ADR-009)",
   "main": "dist/index.js",
@@ -15,7 +15,7 @@
     "build": "tsc"
   },
   "dependencies": {
-    "agentdb": "2.0.0-alpha.3.6",
+    "agentdb": "^3.0.0-alpha.10",
     "sql.js": "^1.10.3"
   },
   "optionalDependencies": {