clawdb 0.1.0

The cognitive database for AI agents — unified memory, semantic retrieval, branching, sync, and governance.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

//! `TransactionLog`: append-only log of committed transaction records.

use uuid::Uuid;
use std::collections::VecDeque;
use std::sync::Mutex;

/// A single entry in the transaction log.
#[derive(Debug, Clone)]
pub struct TransactionLogEntry {
    pub tx_id: Uuid,
    pub session_id: Uuid,
    pub committed_at: i64,
    pub write_set: Vec<String>,
}

/// Append-only in-memory transaction log (production would persist to WAL).
pub struct TransactionLog {
    entries: Mutex<VecDeque<TransactionLogEntry>>,
    max_entries: usize,
}

impl TransactionLog {
    /// Creates a new `TransactionLog` with a rolling window of `max_entries`.
    pub fn new(max_entries: usize) -> Self {
        Self {
            entries: Mutex::new(VecDeque::new()),
            max_entries,
        }
    }

    /// Appends a committed transaction entry to the log.
    pub fn append(&self, entry: TransactionLogEntry) {
        let mut log = self.entries.lock().expect("transaction log lock poisoned");
        if log.len() >= self.max_entries {
            log.pop_front();
        }
        log.push_back(entry);
    }

    /// Returns a snapshot of all current log entries.
    pub fn snapshot(&self) -> Vec<TransactionLogEntry> {
        self.entries
            .lock()
            .expect("transaction log lock poisoned")
            .iter()
            .cloned()
            .collect()
    }

    /// Returns the number of entries currently in the log.
    pub fn len(&self) -> usize {
        self.entries.lock().expect("transaction log lock poisoned").len()
    }

    /// Returns `true` if the log is empty.
    pub fn is_empty(&self) -> bool {
        self.len() == 0
    }
}

impl Default for TransactionLog {
    fn default() -> Self {
        Self::new(10_000)
    }
}