agentic-qe 3.3.4 → 3.4.0

package/v3/dist/memory/crdt/convergence-tracker.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Convergence Tracker Implementation
+ *
+ * Tracks the state of multiple CRDT stores to determine when they have
+ * converged to the same state. Used for monitoring distributed system health
+ * and ensuring eventual consistency.
+ *
+ * @module memory/crdt/convergence-tracker
+ */
+import type { ConvergenceTracker, ConvergenceTrackerConfig, ConvergenceStatus, NodeStateSnapshot } from './types.js';
+/**
+ * Create a new Convergence Tracker
+ *
+ * @param config - Tracker configuration
+ * @returns Convergence Tracker instance
+ *
+ * @example
+ * ```typescript
+ * const tracker = createConvergenceTracker();
+ *
+ * // Record state from each node
+ * tracker.recordNodeState('node-1', store1.getState());
+ * tracker.recordNodeState('node-2', store2.getState());
+ *
+ * // Check if they've converged
+ * if (tracker.hasConverged()) {
+ *   console.log('All nodes have same state!');
+ * }
+ * ```
+ */
+export declare function createConvergenceTracker(config?: ConvergenceTrackerConfig): ConvergenceTracker;
+/**
+ * Convergence metrics for monitoring
+ */
+export interface ConvergenceMetrics {
+    /** Average time to convergence (ms) */
+    averageConvergenceTime: number | null;
+    /** Number of convergence events recorded */
+    convergenceCount: number;
+    /** Time since tracking started (ms) */
+    trackingDuration: number;
+    /** Percentage of time system was converged */
+    convergenceRatio: number;
+}
+/**
+ * Extended tracker with metrics collection
+ */
+export interface MetricsConvergenceTracker extends ConvergenceTracker {
+    /** Get convergence metrics */
+    getMetrics(): ConvergenceMetrics;
+    /** Reset metrics (keeps node tracking) */
+    resetMetrics(): void;
+}
+/**
+ * Create a convergence tracker with metrics collection
+ */
+export declare function createMetricsConvergenceTracker(config?: ConvergenceTrackerConfig): MetricsConvergenceTracker;
+export type { ConvergenceTracker, ConvergenceTrackerConfig, ConvergenceStatus, NodeStateSnapshot, };
+//# sourceMappingURL=convergence-tracker.d.ts.map

package/v3/dist/memory/crdt/convergence-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convergence-tracker.d.ts","sourceRoot":"","sources":["../../../src/memory/crdt/convergence-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAsGpB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,CAAC,EAAE,wBAAwB,GAChC,kBAAkB,CAkLpB;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,4CAA4C;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE,8BAA8B;IAC9B,UAAU,IAAI,kBAAkB,CAAC;IACjC,0CAA0C;IAC1C,YAAY,IAAI,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,CAAC,EAAE,wBAAwB,GAChC,yBAAyB,CAuE3B;AAMD,YAAY,EACV,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,GAClB,CAAC"}

package/v3/dist/memory/crdt/convergence-tracker.js

@@ -0,0 +1,325 @@
+/**
+ * Convergence Tracker Implementation
+ *
+ * Tracks the state of multiple CRDT stores to determine when they have
+ * converged to the same state. Used for monitoring distributed system health
+ * and ensuring eventual consistency.
+ *
+ * @module memory/crdt/convergence-tracker
+ */
+// =============================================================================
+// Default Configuration
+// =============================================================================
+const DEFAULT_CONFIG = {
+    historyRetentionMs: 60_000, // 1 minute
+    staleThresholdMs: 30_000, // 30 seconds
+};
+// =============================================================================
+// Hash Utilities
+// =============================================================================
+/**
+ * Generate a content-based hash of CRDT store state for quick comparison.
+ * This hash is based on the *semantic value* of the CRDTs (what they evaluate to),
+ * not the internal representations, so that stores with equivalent data produce
+ * the same hash regardless of how they arrived at that state.
+ *
+ * Not cryptographic - just for detecting differences.
+ */
+function hashState(state) {
+    const parts = [];
+    // Hash registers by their current value (timestamp/nodeId determine winner, but we
+    // compare the result - if both have same winner, they have same value)
+    for (const [key, reg] of Object.entries(state.registers)) {
+        // Include value, timestamp, and nodeId - these together determine the LWW winner
+        parts.push(`r:${key}:${JSON.stringify(reg.value)}:${reg.timestamp}:${reg.nodeId}`);
+    }
+    // Hash G-Counters by their TOTAL value (not per-node breakdown)
+    // Two stores are converged if they produce the same sum, even if the internal
+    // per-node counts differ (e.g., one has extra nodes with count 0)
+    for (const [key, counter] of Object.entries(state.gCounters)) {
+        const total = Object.values(counter.counts).reduce((sum, c) => sum + c, 0);
+        // Also include non-zero counts to detect semantic differences
+        const nonZeroCounts = Object.entries(counter.counts)
+            .filter(([_, count]) => count > 0)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([nodeId, count]) => `${nodeId}=${count}`)
+            .join(',');
+        parts.push(`g:${key}:${total}:{${nonZeroCounts}}`);
+    }
+    // Hash PN-Counters by their NET value (positive - negative)
+    // Two stores are converged if they evaluate to the same number
+    for (const [key, counter] of Object.entries(state.pnCounters)) {
+        const posTotal = Object.values(counter.positive.counts).reduce((sum, c) => sum + c, 0);
+        const negTotal = Object.values(counter.negative.counts).reduce((sum, c) => sum + c, 0);
+        const netValue = posTotal - negTotal;
+        // Include non-zero contributions for semantic comparison
+        const nonZeroPos = Object.entries(counter.positive.counts)
+            .filter(([_, count]) => count > 0)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([nodeId, count]) => `${nodeId}=+${count}`)
+            .join(',');
+        const nonZeroNeg = Object.entries(counter.negative.counts)
+            .filter(([_, count]) => count > 0)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([nodeId, count]) => `${nodeId}=-${count}`)
+            .join(',');
+        parts.push(`p:${key}:${netValue}:{${nonZeroPos}|${nonZeroNeg}}`);
+    }
+    // Hash OR-Sets by their active elements (elements with at least one non-tombstoned tag)
+    for (const [key, set] of Object.entries(state.sets)) {
+        // Compute active elements: elements where at least one tag is not tombstoned
+        const activeElements = [];
+        for (const [elem, tags] of Object.entries(set.elements)) {
+            const tombstoneTags = new Set(set.tombstones[elem] || []);
+            const hasActiveTag = tags.some(tag => !tombstoneTags.has(tag));
+            if (hasActiveTag) {
+                activeElements.push(elem);
+            }
+        }
+        activeElements.sort();
+        parts.push(`s:${key}:[${activeElements.join(',')}]`);
+    }
+    // Sort for consistency
+    parts.sort();
+    // Simple hash: join and get a fingerprint
+    const joined = parts.join('|');
+    let hash = 0;
+    for (let i = 0; i < joined.length; i++) {
+        const char = joined.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash = hash & hash; // Convert to 32-bit integer
+    }
+    // Return hash without version - version is per-node and shouldn't affect convergence check
+    return hash.toString(16);
+}
+// =============================================================================
+// Convergence Tracker Implementation
+// =============================================================================
+/**
+ * Create a new Convergence Tracker
+ *
+ * @param config - Tracker configuration
+ * @returns Convergence Tracker instance
+ *
+ * @example
+ * ```typescript
+ * const tracker = createConvergenceTracker();
+ *
+ * // Record state from each node
+ * tracker.recordNodeState('node-1', store1.getState());
+ * tracker.recordNodeState('node-2', store2.getState());
+ *
+ * // Check if they've converged
+ * if (tracker.hasConverged()) {
+ *   console.log('All nodes have same state!');
+ * }
+ * ```
+ */
+export function createConvergenceTracker(config) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    const { historyRetentionMs, staleThresholdMs } = cfg;
+    // Track node states: nodeId -> latest snapshot
+    const nodeStates = new Map();
+    // Track state history for each node: nodeId -> array of snapshots
+    const stateHistory = new Map();
+    // Track last convergence time
+    let lastConvergenceTime = null;
+    /**
+     * Clean up old history entries
+     */
+    function cleanupHistory() {
+        const now = Date.now();
+        const cutoff = now - historyRetentionMs;
+        for (const [nodeId, history] of stateHistory) {
+            const filtered = history.filter((s) => s.timestamp >= cutoff);
+            if (filtered.length !== history.length) {
+                stateHistory.set(nodeId, filtered);
+            }
+        }
+    }
+    /**
+     * Check if a node is stale (hasn't reported recently)
+     */
+    function isNodeStale(snapshot) {
+        return Date.now() - snapshot.timestamp > staleThresholdMs;
+    }
+    return {
+        recordNodeState(nodeId, state) {
+            const snapshot = {
+                nodeId,
+                version: state.version,
+                timestamp: Date.now(),
+                stateHash: hashState(state),
+            };
+            // Update current state
+            nodeStates.set(nodeId, snapshot);
+            // Add to history
+            if (!stateHistory.has(nodeId)) {
+                stateHistory.set(nodeId, []);
+            }
+            stateHistory.get(nodeId).push(snapshot);
+            // Cleanup old history
+            cleanupHistory();
+            // Check if convergence just happened
+            if (this.hasConverged()) {
+                lastConvergenceTime = Date.now();
+            }
+        },
+        hasConverged() {
+            if (nodeStates.size < 2) {
+                return true; // Single node is always converged with itself
+            }
+            // Get non-stale nodes
+            const activeSnapshots = [];
+            for (const snapshot of nodeStates.values()) {
+                if (!isNodeStale(snapshot)) {
+                    activeSnapshots.push(snapshot);
+                }
+            }
+            if (activeSnapshots.length < 2) {
+                return true; // Only one active node
+            }
+            // Check if all active nodes have the same hash
+            const firstHash = activeSnapshots[0].stateHash;
+            return activeSnapshots.every((s) => s.stateHash === firstHash);
+        },
+        getStatus() {
+            const activeSnapshots = [];
+            const staleSnapshots = [];
+            for (const snapshot of nodeStates.values()) {
+                if (isNodeStale(snapshot)) {
+                    staleSnapshots.push(snapshot);
+                }
+                else {
+                    activeSnapshots.push(snapshot);
+                }
+            }
+            // Find max version
+            let maxVersion = 0;
+            let minVersion = Number.MAX_SAFE_INTEGER;
+            for (const snapshot of activeSnapshots) {
+                maxVersion = Math.max(maxVersion, snapshot.version);
+                minVersion = Math.min(minVersion, snapshot.version);
+            }
+            if (activeSnapshots.length === 0) {
+                minVersion = 0;
+            }
+            // Find lagging nodes
+            const laggingNodes = [];
+            if (activeSnapshots.length > 1) {
+                const maxHash = activeSnapshots.reduce((best, s) => (s.version > best.version ? s : best), activeSnapshots[0]).stateHash;
+                for (const snapshot of activeSnapshots) {
+                    if (snapshot.stateHash !== maxHash) {
+                        laggingNodes.push(snapshot.nodeId);
+                    }
+                }
+            }
+            // Add stale nodes as lagging
+            for (const snapshot of staleSnapshots) {
+                laggingNodes.push(snapshot.nodeId);
+            }
+            const converged = laggingNodes.length === 0 && activeSnapshots.length > 0;
+            return {
+                converged,
+                nodeCount: nodeStates.size,
+                syncedNodes: activeSnapshots.length - laggingNodes.filter((id) => !staleSnapshots.some((s) => s.nodeId === id)).length,
+                laggingNodes,
+                lastConvergenceTime,
+                maxVersion,
+                minVersion,
+            };
+        },
+        getLaggingNodes() {
+            return this.getStatus().laggingNodes;
+        },
+        getTimeSinceConvergence() {
+            if (lastConvergenceTime === null) {
+                return null;
+            }
+            return Date.now() - lastConvergenceTime;
+        },
+        removeNode(nodeId) {
+            nodeStates.delete(nodeId);
+            stateHistory.delete(nodeId);
+        },
+        clear() {
+            nodeStates.clear();
+            stateHistory.clear();
+            lastConvergenceTime = null;
+        },
+        getTrackedNodes() {
+            return Array.from(nodeStates.keys());
+        },
+        isTracking(nodeId) {
+            return nodeStates.has(nodeId);
+        },
+        getNodeVersion(nodeId) {
+            const snapshot = nodeStates.get(nodeId);
+            return snapshot?.version ?? null;
+        },
+    };
+}
+/**
+ * Create a convergence tracker with metrics collection
+ */
+export function createMetricsConvergenceTracker(config) {
+    const baseTracker = createConvergenceTracker(config);
+    // Metrics tracking
+    const startTime = Date.now();
+    let convergenceCount = 0;
+    let totalConvergedTime = 0;
+    let lastStateChangeTime = startTime;
+    let wasConverged = true;
+    const convergenceTimes = [];
+    // Wrap recordNodeState to track metrics
+    const originalRecord = baseTracker.recordNodeState.bind(baseTracker);
+    return {
+        ...baseTracker,
+        recordNodeState(nodeId, state) {
+            const wasConvergedBefore = baseTracker.hasConverged();
+            originalRecord(nodeId, state);
+            const isConvergedNow = baseTracker.hasConverged();
+            const now = Date.now();
+            // Track state changes
+            if (wasConvergedBefore !== isConvergedNow) {
+                const duration = now - lastStateChangeTime;
+                if (wasConvergedBefore) {
+                    // Was converged, now diverged
+                    totalConvergedTime += duration;
+                }
+                else {
+                    // Was diverged, now converged
+                    convergenceCount++;
+                    convergenceTimes.push(duration);
+                }
+                lastStateChangeTime = now;
+                wasConverged = isConvergedNow;
+            }
+        },
+        getMetrics() {
+            const now = Date.now();
+            const trackingDuration = now - startTime;
+            // Add current state duration
+            let convergedTime = totalConvergedTime;
+            if (wasConverged) {
+                convergedTime += now - lastStateChangeTime;
+            }
+            return {
+                averageConvergenceTime: convergenceTimes.length > 0
+                    ? convergenceTimes.reduce((a, b) => a + b, 0) / convergenceTimes.length
+                    : null,
+                convergenceCount,
+                trackingDuration,
+                convergenceRatio: trackingDuration > 0 ? convergedTime / trackingDuration : 1,
+            };
+        },
+        resetMetrics() {
+            convergenceCount = 0;
+            totalConvergedTime = 0;
+            convergenceTimes.length = 0;
+            lastStateChangeTime = Date.now();
+            wasConverged = baseTracker.hasConverged();
+        },
+    };
+}
+//# sourceMappingURL=convergence-tracker.js.map

package/v3/dist/memory/crdt/convergence-tracker.js.map

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

package/v3/dist/memory/crdt/crdt-store.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Unified CRDT Store Implementation
+ *
+ * A unified store managing multiple CRDT types with support for:
+ * - Full state replication
+ * - Delta-based incremental sync
+ * - Change event emission
+ * - Type-safe access to different CRDT types
+ *
+ * @module memory/crdt/crdt-store
+ */
+import type { CRDTStore, CRDTStoreConfig, CRDTStoreState, CRDTStoreDelta } from './types.js';
+/**
+ * Create a new CRDT Store
+ *
+ * @param config - Store configuration
+ * @returns CRDT Store instance
+ *
+ * @example
+ * ```typescript
+ * const store = createCRDTStore({ nodeId: 'agent-1' });
+ *
+ * // Use registers
+ * store.setRegister('config', { maxAgents: 100 });
+ *
+ * // Use counters
+ * store.incrementCounter('tasks-completed');
+ *
+ * // Use sets
+ * store.addToSet('active-agents', 'agent-1');
+ *
+ * // Merge with another store
+ * store.merge(otherStore);
+ * ```
+ */
+export declare function createCRDTStore(config: CRDTStoreConfig): CRDTStore;
+/**
+ * Create a CRDT Store from existing state
+ *
+ * @param nodeId - Unique identifier for this node
+ * @param existingState - State to restore from
+ * @param config - Additional configuration
+ * @returns CRDT Store instance
+ */
+export declare function createCRDTStoreFromState(nodeId: string, existingState: CRDTStoreState, config?: Partial<CRDTStoreConfig>): CRDTStore;
+/**
+ * Check if a value is a valid CRDT Store state
+ */
+export declare function isCRDTStoreState(value: unknown): value is CRDTStoreState;
+/**
+ * Check if a value is a valid CRDT Store delta
+ */
+export declare function isCRDTStoreDelta(value: unknown): value is CRDTStoreDelta;
+export type { CRDTStore, CRDTStoreConfig, CRDTStoreState, CRDTStoreDelta };
+//# sourceMappingURL=crdt-store.d.ts.map

package/v3/dist/memory/crdt/crdt-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crdt-store.d.ts","sourceRoot":"","sources":["../../../src/memory/crdt/crdt-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,cAAc,EAaf,MAAM,YAAY,CAAC;AAqBpB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CA0jBlE;AAMD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,cAAc,EAC7B,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAChC,SAAS,CAIX;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAexE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAYxE;AAMD,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC"}