aimeat 1.2.0

package/dist/src/services/stats.js

@@ -0,0 +1,124 @@
+const TRACKED_COUNTERS = [
+    'requests_total', 'memory_writes', 'memory_reads',
+    'consent_grants', 'consent_revocations',
+    'schema_validations', 'schema_validation_failures',
+    'auth_failures_total', 'rate_limit_hits_total', 'scope_denials_total',
+];
+const LATENCY_WINDOW_SIZE = 1000;
+export class StatsCollector {
+    counters = new Map();
+    methods = new Map();
+    statuses = new Map();
+    dailyHistory = new Map();
+    startedAt = new Date().toISOString();
+    // Tunnel state
+    tunnelCounters = new Map();
+    tunnelGauges = new Map();
+    // Mailbox state
+    mailboxCounters = new Map();
+    mailboxGauges = new Map();
+    // Delivery latency rolling window
+    latencySamples = [];
+    increment(name) {
+        this.counters.set(name, (this.counters.get(name) ?? 0) + 1);
+        const day = new Date().toISOString().split('T')[0];
+        if (!this.dailyHistory.has(day))
+            this.dailyHistory.set(day, new Map());
+        const dayMap = this.dailyHistory.get(day);
+        dayMap.set(name, (dayMap.get(name) ?? 0) + 1);
+    }
+    incrementMethod(method) {
+        this.methods.set(method, (this.methods.get(method) ?? 0) + 1);
+    }
+    incrementStatus(code) {
+        const bucket = code < 400 ? '2xx' : code < 500 ? '4xx' : '5xx';
+        this.statuses.set(bucket, (this.statuses.get(bucket) ?? 0) + 1);
+    }
+    incrementTunnel(name) {
+        this.tunnelCounters.set(name, (this.tunnelCounters.get(name) ?? 0) + 1);
+    }
+    setTunnelGauge(name, value) {
+        this.tunnelGauges.set(name, value);
+    }
+    incrementMailbox(name) {
+        this.mailboxCounters.set(name, (this.mailboxCounters.get(name) ?? 0) + 1);
+    }
+    setMailboxGauge(name, value) {
+        this.mailboxGauges.set(name, value);
+    }
+    recordDeliveryLatency(ms) {
+        this.latencySamples.push(ms);
+        if (this.latencySamples.length > LATENCY_WINDOW_SIZE) {
+            this.latencySamples = this.latencySamples.slice(-LATENCY_WINDOW_SIZE);
+        }
+    }
+    computeLatencyStats() {
+        const samples = this.latencySamples;
+        if (samples.length === 0)
+            return { avg: 0, p95: 0 };
+        const sum = samples.reduce((a, b) => a + b, 0);
+        const avg = sum / samples.length;
+        const sorted = [...samples].sort((a, b) => a - b);
+        const p95Index = Math.ceil(0.95 * sorted.length) - 1;
+        const p95 = sorted[p95Index];
+        return { avg, p95 };
+    }
+    snapshot() {
+        const daily = {};
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - 90);
+        const cutoffStr = cutoff.toISOString().split('T')[0];
+        for (const [day, counters] of this.dailyHistory) {
+            if (day < cutoffStr) {
+                this.dailyHistory.delete(day);
+                continue;
+            }
+            daily[day] = Object.fromEntries(counters);
+        }
+        const latency = this.computeLatencyStats();
+        return {
+            uptime_seconds: Math.floor((Date.now() - new Date(this.startedAt).getTime()) / 1000),
+            started_at: this.startedAt,
+            requests_total: this.counters.get('requests_total') ?? 0,
+            requests_by_method: Object.fromEntries(this.methods),
+            requests_by_status: Object.fromEntries(this.statuses),
+            memory_writes: this.counters.get('memory_writes') ?? 0,
+            memory_reads: this.counters.get('memory_reads') ?? 0,
+            consent_grants: this.counters.get('consent_grants') ?? 0,
+            consent_revocations: this.counters.get('consent_revocations') ?? 0,
+            schema_validations: this.counters.get('schema_validations') ?? 0,
+            schema_validation_failures: this.counters.get('schema_validation_failures') ?? 0,
+            daily_history: daily,
+            tunnel: {
+                connections_active: this.tunnelGauges.get('connections_active') ?? 0,
+                connections_total: this.tunnelCounters.get('connections_total') ?? 0,
+                disconnections_total: this.tunnelCounters.get('disconnections_total') ?? 0,
+                reconnects_total: this.tunnelCounters.get('reconnects_total') ?? 0,
+                messages_sent_total: this.tunnelCounters.get('messages_sent_total') ?? 0,
+                messages_received_total: this.tunnelCounters.get('messages_received_total') ?? 0,
+                delivery_failures_total: this.tunnelCounters.get('delivery_failures_total') ?? 0,
+                delivery_latency_avg_ms: latency.avg,
+                delivery_latency_p95_ms: latency.p95,
+                heartbeat_misses_total: this.tunnelCounters.get('heartbeat_misses_total') ?? 0,
+                mailbox_fallbacks_total: this.tunnelCounters.get('mailbox_fallbacks_total') ?? 0,
+            },
+            mailbox: {
+                items_total: this.mailboxGauges.get('items_total') ?? 0,
+                bytes_total: this.mailboxGauges.get('bytes_total') ?? 0,
+                enqueued_total: this.mailboxCounters.get('enqueued_total') ?? 0,
+                delivered_total: this.mailboxCounters.get('delivered_total') ?? 0,
+                expired_total: this.mailboxCounters.get('expired_total') ?? 0,
+                quota_rejections_total: this.mailboxCounters.get('quota_rejections_total') ?? 0,
+                oldest_item_age_seconds: this.mailboxGauges.get('oldest_item_age_seconds') ?? 0,
+            },
+            auth_failures_total: this.counters.get('auth_failures_total') ?? 0,
+            rate_limit_hits_total: this.counters.get('rate_limit_hits_total') ?? 0,
+            scope_denials_total: this.counters.get('scope_denials_total') ?? 0,
+        };
+    }
+}
+// Singleton pattern for use in services that can't accept constructor params
+let _instance = null;
+export function getStats() { return _instance; }
+export function initStats() { _instance = new StatsCollector(); return _instance; }
+//# sourceMappingURL=stats.js.map

package/dist/src/services/stats.js.map

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

package/dist/src/services/sync-health.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Sync Health & Peer Priority — monitors sync infrastructure health
+ * and computes peer priority scores for sync ordering.
+ * Per RFC v1.6 §32.6.3 (throttling) and §32.6.4 (peer priority).
+ */
+import type { Storage } from '../storage/interface.js';
+import type { PeerInfo } from '../services/federation.js';
+export interface SyncHealthMetrics {
+    queueDepth: number;
+    avgSyncDurationMs: number;
+    failureRate: number;
+    activeSyncs: number;
+    throttled: boolean;
+    throttleReason: string | null;
+    lastCheckedAt: string;
+}
+export interface PeerPriority {
+    peerId: string;
+    nodeId: string;
+    score: number;
+    factors: {
+        statusWeight: number;
+        failureWeight: number;
+        lastSyncAge: number;
+        recencyWeight: number;
+    };
+}
+/** Record a sync duration sample. */
+export declare function recordSyncDuration(durationMs: number): void;
+/** Record a sync attempt. */
+export declare function recordSyncAttempt(success: boolean): void;
+/** Increment/decrement active sync count. */
+export declare function incrementActiveSyncs(): void;
+export declare function decrementActiveSyncs(): void;
+/**
+ * Get current sync health metrics.
+ */
+export declare function getSyncHealthMetrics(storage: Storage): Promise<SyncHealthMetrics>;
+/**
+ * Check if sync operations should be throttled.
+ */
+export declare function isSyncThrottled(): boolean;
+/**
+ * Compute peer priority scores for sync ordering.
+ * Higher score = higher priority (should sync first).
+ *
+ * Factors (per §32.6.4):
+ * - Peer status (active > degraded)
+ * - Consecutive failure count (fewer failures = higher priority)
+ * - Time since last successful sync (longer = higher priority)
+ */
+export declare function computePeerPriorities(peers: Map<string, PeerInfo>): PeerPriority[];
+//# sourceMappingURL=sync-health.d.ts.map

package/dist/src/services/sync-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-health.d.ts","sourceRoot":"","sources":["../../../src/services/sync-health.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAI1D,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAiBD,qCAAqC;AACrC,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAK3D;AAED,6BAA6B;AAC7B,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAGxD;AAED,6CAA6C;AAC7C,wBAAgB,oBAAoB,IAAI,IAAI,CAAuB;AACnE,wBAAgB,oBAAoB,IAAI,IAAI,CAAwD;AAEpG;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqCvF;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC3B,YAAY,EAAE,CA2ChB"}

package/dist/src/services/sync-health.js

@@ -0,0 +1,122 @@
+/**
+ * Sync Health & Peer Priority — monitors sync infrastructure health
+ * and computes peer priority scores for sync ordering.
+ * Per RFC v1.6 §32.6.3 (throttling) and §32.6.4 (peer priority).
+ */
+import { getPeerSyncState } from './catalogue-sync.js';
+import { logger } from '../utils/logger.js';
+/** Track sync durations for average calculation. */
+const syncDurations = [];
+const MAX_DURATION_SAMPLES = 100;
+/** Track current active sync count. */
+let activeSyncCount = 0;
+/** Track sync attempts and failures for rate calculation. */
+let totalSyncAttempts = 0;
+let totalSyncFailures = 0;
+/** Whether throttling is currently active. */
+let isThrottled = false;
+let throttleReason = null;
+/** Record a sync duration sample. */
+export function recordSyncDuration(durationMs) {
+    syncDurations.push(durationMs);
+    if (syncDurations.length > MAX_DURATION_SAMPLES) {
+        syncDurations.shift();
+    }
+}
+/** Record a sync attempt. */
+export function recordSyncAttempt(success) {
+    totalSyncAttempts++;
+    if (!success)
+        totalSyncFailures++;
+}
+/** Increment/decrement active sync count. */
+export function incrementActiveSyncs() { activeSyncCount++; }
+export function decrementActiveSyncs() { activeSyncCount = Math.max(0, activeSyncCount - 1); }
+/**
+ * Get current sync health metrics.
+ */
+export async function getSyncHealthMetrics(storage) {
+    const queueDepth = await storage.replicationQueueSize();
+    const avgDuration = syncDurations.length > 0
+        ? syncDurations.reduce((a, b) => a + b, 0) / syncDurations.length
+        : 0;
+    const failureRate = totalSyncAttempts > 0
+        ? totalSyncFailures / totalSyncAttempts
+        : 0;
+    // Throttling rules per §32.6.3
+    const shouldThrottle = queueDepth > 1000 || failureRate > 0.5 || activeSyncCount > 10;
+    if (shouldThrottle && !isThrottled) {
+        isThrottled = true;
+        throttleReason = queueDepth > 1000
+            ? `Queue depth ${queueDepth} exceeds 1000`
+            : failureRate > 0.5
+                ? `Failure rate ${(failureRate * 100).toFixed(1)}% exceeds 50%`
+                : `Active syncs ${activeSyncCount} exceeds 10`;
+        logger.warn('Sync throttling activated', { reason: throttleReason });
+    }
+    else if (!shouldThrottle && isThrottled) {
+        isThrottled = false;
+        throttleReason = null;
+        logger.info('Sync throttling deactivated — conditions cleared');
+    }
+    return {
+        queueDepth,
+        avgSyncDurationMs: Math.round(avgDuration),
+        failureRate: Math.round(failureRate * 1000) / 1000,
+        activeSyncs: activeSyncCount,
+        throttled: isThrottled,
+        throttleReason,
+        lastCheckedAt: new Date().toISOString(),
+    };
+}
+/**
+ * Check if sync operations should be throttled.
+ */
+export function isSyncThrottled() {
+    return isThrottled;
+}
+/**
+ * Compute peer priority scores for sync ordering.
+ * Higher score = higher priority (should sync first).
+ *
+ * Factors (per §32.6.4):
+ * - Peer status (active > degraded)
+ * - Consecutive failure count (fewer failures = higher priority)
+ * - Time since last successful sync (longer = higher priority)
+ */
+export function computePeerPriorities(peers) {
+    const priorities = [];
+    const now = Date.now();
+    for (const [peerId, peer] of peers) {
+        if (peer.status !== 'active' && peer.status !== 'degraded')
+            continue;
+        const syncState = getPeerSyncState(peerId);
+        // Status weight: active peers get full priority, degraded peers get half
+        const statusWeight = peer.status === 'active' ? 1.0 : 0.5;
+        // Failure weight: decreases with consecutive failures (0 failures = 1.0, 10+ = 0.0)
+        const failureWeight = Math.max(0, 1.0 - (syncState.consecutiveFailures / 10));
+        // Last sync age in hours (older = higher recency weight)
+        const lastSyncAge = syncState.lastSyncAt
+            ? (now - new Date(syncState.lastSyncAt).getTime()) / 3_600_000
+            : 999; // Never synced = very high priority
+        // Recency weight: normalized 0-1 where older = higher (cap at 168h / 1 week)
+        const recencyWeight = Math.min(lastSyncAge / 168, 1.0);
+        // Composite score
+        const score = (statusWeight * 0.3) + (failureWeight * 0.3) + (recencyWeight * 0.4);
+        priorities.push({
+            peerId,
+            nodeId: peer.nodeId,
+            score,
+            factors: {
+                statusWeight,
+                failureWeight,
+                lastSyncAge: Math.round(lastSyncAge * 10) / 10,
+                recencyWeight: Math.round(recencyWeight * 1000) / 1000,
+            },
+        });
+    }
+    // Sort by score descending (highest priority first)
+    priorities.sort((a, b) => b.score - a.score);
+    return priorities;
+}
+//# sourceMappingURL=sync-health.js.map

package/dist/src/services/sync-health.js.map

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

package/dist/src/services/sync-scheduler.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Sync Scheduler — coordinates catalogue sync based on sync mode.
+ * Implements bulk/instant/hybrid scheduling per RFC v1.6 §13.11.6.
+ */
+import type { AimeatConfig } from '../config.js';
+import type { Storage } from '../storage/interface.js';
+import type { PeerInfo } from '../services/federation.js';
+/**
+ * Notify the scheduler that a CSM or action change occurred.
+ * In instant/hybrid modes, this triggers batched sync.
+ */
+export declare function notifyCatalogueChange(config: AimeatConfig, storage: Storage, peers: Map<string, PeerInfo>): void;
+/**
+ * Drain the replication queue: dequeue entries and execute syncs.
+ * Respects concurrent sync limit and peer priority.
+ */
+export declare function drainSyncQueue(config: AimeatConfig, storage: Storage, peers: Map<string, PeerInfo>): Promise<void>;
+/**
+ * Start the sync scheduler. Runs scheduled sync cycles based on syncIntervalHours.
+ * Returns a cleanup function to stop the scheduler.
+ */
+export declare function startSyncScheduler(config: AimeatConfig, storage: Storage, peers: Map<string, PeerInfo>): {
+    stop: () => void;
+};
+//# sourceMappingURL=sync-scheduler.d.ts.map

package/dist/src/services/sync-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-scheduler.d.ts","sourceRoot":"","sources":["../../../src/services/sync-scheduler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAkB1D;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC3B,IAAI,CAqCN;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CAgEf;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC3B;IAAE,IAAI,EAAE,MAAM,IAAI,CAAA;CAAE,CAoCtB"}

package/dist/src/services/sync-scheduler.js

@@ -0,0 +1,211 @@
+/**
+ * Sync Scheduler — coordinates catalogue sync based on sync mode.
+ * Implements bulk/instant/hybrid scheduling per RFC v1.6 §13.11.6.
+ */
+import { syncCatalogueToPeer, enqueueCatalogueSync } from './catalogue-sync.js';
+import { replicateMemoryToAllPeers } from './memory-replication.js';
+import { computePeerPriorities, getSyncHealthMetrics, isSyncThrottled, incrementActiveSyncs, decrementActiveSyncs, recordSyncDuration, recordSyncAttempt, } from './sync-health.js';
+import { logger } from '../utils/logger.js';
+/** Batch window: accumulate events for 5s before flushing. */
+let batchTimer = null;
+let batchedPeerIds = new Set();
+/**
+ * Notify the scheduler that a CSM or action change occurred.
+ * In instant/hybrid modes, this triggers batched sync.
+ */
+export function notifyCatalogueChange(config, storage, peers) {
+    if (config.syncMode === 'bulk')
+        return; // Bulk mode: only scheduled syncs
+    // Collect all active peer IDs for batch sync
+    const activePeerIds = [...peers.values()]
+        .filter(p => p.status === 'active')
+        .map(p => p.nodeId);
+    for (const id of activePeerIds) {
+        batchedPeerIds.add(id);
+    }
+    // Debounce: wait syncBatchDelayMs before firing
+    if (batchTimer)
+        clearTimeout(batchTimer);
+    batchTimer = setTimeout(() => {
+        const peerIds = [...batchedPeerIds];
+        batchedPeerIds = new Set();
+        batchTimer = null;
+        if (peerIds.length === 0)
+            return;
+        // Enqueue syncs
+        for (const peerId of peerIds) {
+            enqueueCatalogueSync(peerId, config, storage).catch(err => {
+                logger.warn(`Failed to enqueue catalogue sync for peer ${peerId}`, {
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            });
+        }
+        // Immediately drain the queue
+        drainSyncQueue(config, storage, peers).catch(err => {
+            logger.error('Failed to drain sync queue after catalogue change', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        });
+    }, config.syncBatchDelayMs);
+}
+/**
+ * Drain the replication queue: dequeue entries and execute syncs.
+ * Respects concurrent sync limit and peer priority.
+ */
+export async function drainSyncQueue(config, storage, peers) {
+    if (isSyncThrottled()) {
+        logger.warn('Sync queue drain skipped — throttling active');
+        return;
+    }
+    const priorities = computePeerPriorities(peers);
+    const concurrency = config.maxConcurrentSyncs;
+    // Process top N peers by priority
+    const topPeers = priorities.slice(0, concurrency);
+    const syncPromises = topPeers.map(async (priority) => {
+        const peer = peers.get(priority.peerId);
+        if (!peer)
+            return;
+        // Dequeue entries for this peer
+        const entries = await storage.dequeueReplication(priority.peerId, 10);
+        if (entries.length === 0)
+            return;
+        incrementActiveSyncs();
+        const startTime = Date.now();
+        try {
+            // Process catalogue_sync entries
+            const catalogueEntries = entries.filter(e => e.type === 'catalogue_sync');
+            if (catalogueEntries.length > 0) {
+                const result = await syncCatalogueToPeer(peer, config, storage);
+                recordSyncAttempt(result.success);
+                if (result.success) {
+                    await storage.markReplicationSent(catalogueEntries.map(e => e.id));
+                }
+                else {
+                    await storage.markReplicationFailed(catalogueEntries.map(e => e.id));
+                }
+            }
+            // Process memory_replicate entries
+            const memoryEntries = entries.filter(e => e.type === 'memory_replicate');
+            if (memoryEntries.length > 0) {
+                // These are handled by the memory replication service
+                await storage.markReplicationSent(memoryEntries.map(e => e.id));
+            }
+            // Process trust_advisory entries
+            const trustEntries = entries.filter(e => e.type === 'trust_advisory');
+            if (trustEntries.length > 0) {
+                await storage.markReplicationSent(trustEntries.map(e => e.id));
+            }
+            recordSyncDuration(Date.now() - startTime);
+        }
+        catch (err) {
+            recordSyncAttempt(false);
+            const entryIds = entries.map(e => e.id);
+            await storage.markReplicationFailed(entryIds).catch(() => { });
+            logger.warn(`Sync queue drain failed for peer ${peer.nodeId}`, {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        finally {
+            decrementActiveSyncs();
+        }
+    });
+    await Promise.allSettled(syncPromises);
+}
+/**
+ * Start the sync scheduler. Runs scheduled sync cycles based on syncIntervalHours.
+ * Returns a cleanup function to stop the scheduler.
+ */
+export function startSyncScheduler(config, storage, peers) {
+    const BASE_INTERVAL_MS = config.syncIntervalHours * 3_600_000;
+    logger.info('Sync scheduler started', {
+        mode: config.syncMode,
+        intervalHours: config.syncIntervalHours,
+        maxConcurrentSyncs: config.maxConcurrentSyncs,
+    });
+    // Initial sync after 60 seconds (allow server startup to complete)
+    const initialTimer = setTimeout(() => {
+        runScheduledSync(config, storage, peers);
+    }, 60_000);
+    // Recurring sync with jitter (±25%)
+    function scheduleNext() {
+        const jitter = BASE_INTERVAL_MS * 0.25 * (Math.random() * 2 - 1);
+        const nextMs = Math.max(60_000, BASE_INTERVAL_MS + jitter);
+        recurringTimer = setTimeout(() => {
+            runScheduledSync(config, storage, peers);
+            scheduleNext();
+        }, nextMs);
+    }
+    let recurringTimer;
+    scheduleNext();
+    return {
+        stop() {
+            clearTimeout(initialTimer);
+            clearTimeout(recurringTimer);
+            if (batchTimer)
+                clearTimeout(batchTimer);
+            logger.info('Sync scheduler stopped');
+        },
+    };
+}
+/**
+ * Run a scheduled sync cycle.
+ * Syncs catalogue to all peers + drains replication queue + prunes old entries.
+ */
+async function runScheduledSync(config, storage, peers) {
+    try {
+        const healthMetrics = await getSyncHealthMetrics(storage);
+        if (healthMetrics.throttled) {
+            logger.warn('Scheduled sync skipped — throttling active', { reason: healthMetrics.throttleReason });
+            return;
+        }
+        logger.info('Starting scheduled sync cycle', {
+            mode: config.syncMode,
+            queueDepth: healthMetrics.queueDepth,
+        });
+        // 1. Sync catalogue to peers by priority
+        const priorities = computePeerPriorities(peers);
+        const concurrency = config.maxConcurrentSyncs;
+        for (let i = 0; i < priorities.length; i += concurrency) {
+            const batch = priorities.slice(i, i + concurrency);
+            await Promise.allSettled(batch.map(async (priority) => {
+                const peer = peers.get(priority.peerId);
+                if (!peer)
+                    return;
+                incrementActiveSyncs();
+                const start = Date.now();
+                try {
+                    const result = await syncCatalogueToPeer(peer, config, storage);
+                    recordSyncAttempt(result.success);
+                    recordSyncDuration(Date.now() - start);
+                }
+                catch {
+                    recordSyncAttempt(false);
+                }
+                finally {
+                    decrementActiveSyncs();
+                }
+            }));
+        }
+        // 2. Run memory replication cycle
+        await replicateMemoryToAllPeers(config, storage, peers).catch(err => {
+            logger.warn('Memory replication cycle failed', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        });
+        // 3. Drain any queued items
+        await drainSyncQueue(config, storage, peers);
+        // 4. Prune old queue entries
+        const pruneCutoff = new Date(Date.now() - config.replicationQueueTtlHours * 3_600_000);
+        const pruned = await storage.pruneReplicationQueue(pruneCutoff);
+        if (pruned > 0) {
+            logger.info(`Pruned ${pruned} old replication queue entries`);
+        }
+        logger.info('Scheduled sync cycle completed');
+    }
+    catch (err) {
+        logger.error('Scheduled sync cycle failed', {
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+//# sourceMappingURL=sync-scheduler.js.map

package/dist/src/services/sync-scheduler.js.map

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

package/dist/src/services/totp.d.ts

@@ -0,0 +1,31 @@
+export interface TotpConfig {
+    issuer: string;
+    algorithm: 'SHA1';
+    digits: 6;
+    period: number;
+    window: number;
+    backupCodeCount: number;
+    encryptionKey?: Buffer;
+}
+export interface TotpSetupResult {
+    secret: string;
+    uri: string;
+    qrDataUrl: string;
+    backupCodes: string[];
+    encryptedSecret: string;
+    hashedBackupCodes: string[];
+}
+export declare function setupTotp(username: string, config: TotpConfig): Promise<TotpSetupResult>;
+export declare function validateTotpCode(encryptedSecret: string, code: string, config: TotpConfig): {
+    valid: boolean;
+    delta: number | null;
+};
+export declare function validateBackupCode(code: string, hashedCodes: string[]): {
+    valid: boolean;
+    index: number;
+};
+export declare function generateBackupCodes(count: number): {
+    plain: string[];
+    hashed: string[];
+};
+//# sourceMappingURL=totp.d.ts.map

package/dist/src/services/totp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"totp.d.ts","sourceRoot":"","sources":["../../../src/services/totp.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,CAAC,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,eAAe,CAAC,CAoC1B;AAID,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,GACjB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAe1C;AAID,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EAAE,GACpB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAWnC;AAyBD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CASxF"}