@ninebix/nmt-system 1.0.0

package/dist/src/storage/probabilistic-store.js

@@ -0,0 +1,257 @@
+/**
+ * Probabilistic Store - Persistent storage for probabilistic ontology modules
+ *
+ * Handles persistence for:
+ * - AttractorModel (미래 끌개)
+ * - FourStageLearningSystem (4단계 학습)
+ * - ProbabilisticNeuronManager (확률적 뉴런)
+ * - DynamicEmbeddingManager (동적 차원)
+ *
+ * @module storage/probabilistic-store
+ */
+import { Level } from 'level';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+/**
+ * Unified storage for all probabilistic ontology modules
+ */
+export class ProbabilisticStore {
+    db;
+    dataDir;
+    initialized = false;
+    // Storage keys
+    static KEYS = {
+        ATTRACTORS: 'probabilistic:attractors',
+        LEARNING: 'probabilistic:learning',
+        NEURONS: 'probabilistic:neurons',
+        DIMENSIONS: 'probabilistic:dimensions',
+        META: 'probabilistic:meta',
+    };
+    constructor(options) {
+        this.dataDir = options.dataDir;
+        this.db = new Level(path.join(this.dataDir, 'probabilistic'), {
+            valueEncoding: 'json'
+        });
+    }
+    /**
+     * Initialize store
+     */
+    async init() {
+        if (this.initialized)
+            return;
+        await fs.mkdir(this.dataDir, { recursive: true });
+        await this.db.open();
+        this.initialized = true;
+        // Initialize meta if not exists
+        try {
+            await this.db.get(ProbabilisticStore.KEYS.META);
+        }
+        catch {
+            await this.db.put(ProbabilisticStore.KEYS.META, JSON.stringify({
+                version: '1.0.0',
+                createdAt: new Date().toISOString(),
+                lastUpdated: new Date().toISOString(),
+            }));
+        }
+    }
+    /**
+     * Close store
+     */
+    async close() {
+        if (!this.initialized)
+            return;
+        await this.db.close();
+        this.initialized = false;
+    }
+    // ==================== Attractor Storage ====================
+    /**
+     * Save attractor model state
+     */
+    async saveAttractors(data) {
+        await this.db.put(ProbabilisticStore.KEYS.ATTRACTORS, JSON.stringify({
+            ...data,
+            savedAt: new Date().toISOString(),
+        }));
+        await this.updateMeta();
+    }
+    /**
+     * Load attractor model state
+     */
+    async loadAttractors() {
+        try {
+            const data = await this.db.get(ProbabilisticStore.KEYS.ATTRACTORS);
+            return JSON.parse(data);
+        }
+        catch {
+            return null;
+        }
+    }
+    // ==================== Learning Storage ====================
+    /**
+     * Save learning system state
+     */
+    async saveLearning(data) {
+        await this.db.put(ProbabilisticStore.KEYS.LEARNING, JSON.stringify({
+            ...data,
+            savedAt: new Date().toISOString(),
+        }));
+        await this.updateMeta();
+    }
+    /**
+     * Load learning system state
+     */
+    async loadLearning() {
+        try {
+            const data = await this.db.get(ProbabilisticStore.KEYS.LEARNING);
+            return JSON.parse(data);
+        }
+        catch {
+            return null;
+        }
+    }
+    // ==================== Probabilistic Neurons Storage ====================
+    /**
+     * Save probabilistic neurons state
+     */
+    async saveNeurons(data) {
+        await this.db.put(ProbabilisticStore.KEYS.NEURONS, JSON.stringify({
+            ...data,
+            savedAt: new Date().toISOString(),
+        }));
+        await this.updateMeta();
+    }
+    /**
+     * Load probabilistic neurons state
+     */
+    async loadNeurons() {
+        try {
+            const data = await this.db.get(ProbabilisticStore.KEYS.NEURONS);
+            return JSON.parse(data);
+        }
+        catch {
+            return null;
+        }
+    }
+    // ==================== Dimensions Storage ====================
+    /**
+     * Save dynamic dimensions state
+     */
+    async saveDimensions(data) {
+        await this.db.put(ProbabilisticStore.KEYS.DIMENSIONS, JSON.stringify({
+            ...data,
+            savedAt: new Date().toISOString(),
+        }));
+        await this.updateMeta();
+    }
+    /**
+     * Load dynamic dimensions state
+     */
+    async loadDimensions() {
+        try {
+            const data = await this.db.get(ProbabilisticStore.KEYS.DIMENSIONS);
+            return JSON.parse(data);
+        }
+        catch {
+            return null;
+        }
+    }
+    // ==================== Bulk Operations ====================
+    /**
+     * Save all probabilistic module states
+     */
+    async saveAll(states) {
+        const batch = this.db.batch();
+        if (states.attractors) {
+            batch.put(ProbabilisticStore.KEYS.ATTRACTORS, JSON.stringify({
+                ...states.attractors,
+                savedAt: new Date().toISOString(),
+            }));
+        }
+        if (states.learning) {
+            batch.put(ProbabilisticStore.KEYS.LEARNING, JSON.stringify({
+                ...states.learning,
+                savedAt: new Date().toISOString(),
+            }));
+        }
+        if (states.neurons) {
+            batch.put(ProbabilisticStore.KEYS.NEURONS, JSON.stringify({
+                ...states.neurons,
+                savedAt: new Date().toISOString(),
+            }));
+        }
+        if (states.dimensions) {
+            batch.put(ProbabilisticStore.KEYS.DIMENSIONS, JSON.stringify({
+                ...states.dimensions,
+                savedAt: new Date().toISOString(),
+            }));
+        }
+        await batch.write();
+        await this.updateMeta();
+    }
+    /**
+     * Load all probabilistic module states
+     */
+    async loadAll() {
+        const [attractors, learning, neurons, dimensions] = await Promise.all([
+            this.loadAttractors(),
+            this.loadLearning(),
+            this.loadNeurons(),
+            this.loadDimensions(),
+        ]);
+        return { attractors, learning, neurons, dimensions };
+    }
+    /**
+     * Clear all probabilistic data
+     */
+    async clear() {
+        const batch = this.db.batch();
+        batch.del(ProbabilisticStore.KEYS.ATTRACTORS);
+        batch.del(ProbabilisticStore.KEYS.LEARNING);
+        batch.del(ProbabilisticStore.KEYS.NEURONS);
+        batch.del(ProbabilisticStore.KEYS.DIMENSIONS);
+        await batch.write();
+        await this.updateMeta();
+    }
+    // ==================== Meta Operations ====================
+    async updateMeta() {
+        const meta = await this.getMeta();
+        meta.lastUpdated = new Date().toISOString();
+        await this.db.put(ProbabilisticStore.KEYS.META, JSON.stringify(meta));
+    }
+    async getMeta() {
+        try {
+            const data = await this.db.get(ProbabilisticStore.KEYS.META);
+            return JSON.parse(data);
+        }
+        catch {
+            return {
+                version: '1.0.0',
+                createdAt: new Date().toISOString(),
+                lastUpdated: new Date().toISOString(),
+            };
+        }
+    }
+    /**
+     * Get storage statistics
+     */
+    async getStats() {
+        const meta = await this.getMeta();
+        const [attractors, learning, neurons, dimensions] = await Promise.all([
+            this.loadAttractors(),
+            this.loadLearning(),
+            this.loadNeurons(),
+            this.loadDimensions(),
+        ]);
+        return {
+            hasAttractors: attractors !== null,
+            hasLearning: learning !== null,
+            hasNeurons: neurons !== null,
+            hasDimensions: dimensions !== null,
+            lastUpdated: meta.lastUpdated,
+        };
+    }
+}
+export function createProbabilisticStore(options) {
+    return new ProbabilisticStore(options);
+}
+//# sourceMappingURL=probabilistic-store.js.map

package/dist/src/storage/probabilistic-store.js.map

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

package/dist/src/sync/change-journal.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Change Journal - Write-ahead log for state changes
+ *
+ * Tracks all state changes with sequence numbers and vector clocks
+ * for synchronization and rollback support.
+ *
+ * @module sync/change-journal
+ */
+import { Level } from 'level';
+import type { SerializedClock } from './vector-clock.js';
+/**
+ * Types of entities that can be changed
+ */
+export type ChangeEntityType = 'neuron' | 'synapse' | 'attractor' | 'pattern' | 'process' | 'dimension' | 'embedding';
+/**
+ * Types of operations
+ */
+export type ChangeOperation = 'create' | 'update' | 'delete';
+/**
+ * A single change entry in the journal
+ */
+export interface ChangeEntry {
+    /** Monotonic sequence number */
+    sequence: number;
+    /** Type of entity being changed */
+    type: ChangeEntityType;
+    /** Operation performed */
+    operation: ChangeOperation;
+    /** ID of the entity */
+    entityId: string;
+    /** Change data (null for delete) */
+    data: unknown;
+    /** Vector clock at time of change */
+    vectorClock: SerializedClock;
+    /** ISO 8601 timestamp */
+    timestamp: string;
+    /** Node that made the change */
+    nodeId: string;
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Input for appending a change (without sequence)
+ */
+export type ChangeInput = Omit<ChangeEntry, 'sequence'>;
+/**
+ * Journal statistics
+ */
+export interface JournalStats {
+    /** Total number of entries */
+    totalEntries: number;
+    /** Latest sequence number */
+    latestSequence: number;
+    /** Oldest sequence number */
+    oldestSequence: number;
+    /** Entries by type */
+    byType: Record<string, number>;
+    /** Entries by operation */
+    byOperation: Record<string, number>;
+}
+/**
+ * ChangeJournal - Persistent write-ahead log
+ *
+ * Features:
+ * - Monotonic sequence numbers
+ * - Vector clock tracking
+ * - Range queries
+ * - Compaction (remove old entries)
+ *
+ * @example
+ * ```typescript
+ * const journal = new ChangeJournal(db, 'node-1');
+ * await journal.init();
+ *
+ * const seq = await journal.append({
+ *   type: 'neuron',
+ *   operation: 'create',
+ *   entityId: 'neuron-123',
+ *   data: { content: 'Hello' },
+ *   vectorClock: clock.toJSON(),
+ *   timestamp: new Date().toISOString(),
+ *   nodeId: 'node-1'
+ * });
+ *
+ * const entries = await journal.getAfterSequence(0);
+ * ```
+ */
+export declare class ChangeJournal {
+    private db;
+    private nodeId;
+    private currentSequence;
+    private initialized;
+    private initPromise;
+    private appendLock;
+    private static readonly PREFIX;
+    private static readonly META_KEY;
+    constructor(db: Level<string, string>, nodeId: string);
+    /**
+     * Initialize the journal
+     * Thread-safe: concurrent calls will wait for the same initialization
+     */
+    init(): Promise<void>;
+    /**
+     * Internal initialization logic
+     */
+    private _doInit;
+    /**
+     * Append a new change entry (thread-safe)
+     * @returns The assigned sequence number
+     */
+    append(entry: ChangeInput): Promise<number>;
+    /**
+     * Append multiple entries atomically
+     */
+    appendBatch(entries: ChangeInput[]): Promise<number[]>;
+    /**
+     * Get a specific entry by sequence number
+     * @returns The entry or null if not found
+     * @throws {Error} If entry is corrupted
+     */
+    get(sequence: number): Promise<ChangeEntry | null>;
+    /**
+     * Get entries in a sequence range (inclusive)
+     * Uses LevelDB iterator for efficient range queries
+     */
+    getRange(fromSeq: number, toSeq: number): Promise<ChangeEntry[]>;
+    /**
+     * Get all entries after a sequence number
+     */
+    getAfterSequence(seq: number): Promise<ChangeEntry[]>;
+    /**
+     * Get entries by entity ID
+     */
+    getByEntity(entityId: string): Promise<ChangeEntry[]>;
+    /**
+     * Get entries by type
+     */
+    getByType(type: ChangeEntityType): Promise<ChangeEntry[]>;
+    /**
+     * Get the latest sequence number
+     */
+    getLatestSequence(): Promise<number>;
+    /**
+     * Get the oldest sequence number (after compaction)
+     */
+    getOldestSequence(): Promise<number>;
+    /**
+     * Compact the journal by removing entries before a sequence
+     */
+    compact(beforeSeq: number): Promise<number>;
+    /**
+     * Get journal statistics
+     */
+    getStats(): Promise<JournalStats>;
+    /**
+     * Clear all journal entries
+     */
+    clear(): Promise<void>;
+    /**
+     * Check if journal has entries
+     */
+    hasEntries(): Promise<boolean>;
+    private sequenceKey;
+    private parseSequenceKey;
+    private saveMeta;
+}
+/**
+ * Create a ChangeJournal instance
+ */
+export declare function createChangeJournal(db: Level<string, string>, nodeId: string): ChangeJournal;
+//# sourceMappingURL=change-journal.d.ts.map

package/dist/src/sync/change-journal.d.ts.map

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