yantrikdb 0.23.0

Cognitive memory engine for persistent AI systems
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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

/// Platform-aware time utilities.
/// On native targets, uses `std::time::SystemTime` / `Instant`.
/// On wasm32, uses `js_sys::Date::now()`.
///
/// **v0.10 Phase 0:** `now_secs`/`now_ms` are the engine's SEMANTIC
/// wall-clock seam. Under the non-default `testing` cargo feature they
/// consult the injectable test clock (`crate::testing::set_test_clock`)
/// so decay / aged-status / rate-limiter traces can script time
/// deterministically. Production builds compile straight to the system
/// clock. The monotonic [`Instant`] below is for deadlines/timing and is
/// intentionally NOT overridable.

/// The real system clock, never overridden (used by the test-clock's own
/// `advance` bootstrap; not for engine semantics).
#[cfg(not(target_arch = "wasm32"))]
pub fn real_now_secs() -> f64 {
    std::time::SystemTime::now()
        .duration_since(std::time::UNIX_EPOCH)
        .unwrap()
        .as_secs_f64()
}

#[cfg(target_arch = "wasm32")]
pub fn real_now_secs() -> f64 {
    js_sys::Date::now() / 1000.0
}

pub fn now_secs() -> f64 {
    #[cfg(feature = "testing")]
    if let Some(t) = crate::testing::test_clock() {
        return t;
    }
    real_now_secs()
}

/// Milliseconds since epoch — derives from the SAME override as
/// [`now_secs`] (sol Q2 containment: the two must never disagree).
pub fn now_ms() -> u64 {
    (now_secs() * 1000.0) as u64
}

/// Monotonic-ish instant for measuring elapsed time.
///
/// **Use this, not `std::time::Instant`, anywhere the engine's own code
/// paths can reach.** `std::time::Instant::now()` panics on
/// wasm32-unknown-unknown ("time not implemented on this platform"), and
/// the panic is an `unreachable` trap with no message — the browser build
/// died inside `DeltaIndex::append_inner` on the very first `record()`
/// with nothing but a stack address to go on. `Copy` + `elapsed()` are
/// here so a `std::time::Instant` field or local can be swapped for this
/// one without touching the surrounding logic.
#[cfg(not(target_arch = "wasm32"))]
#[derive(Debug, Clone, Copy)]
pub struct Instant(std::time::Instant);

#[cfg(not(target_arch = "wasm32"))]
impl Instant {
    pub fn now() -> Self {
        Instant(std::time::Instant::now())
    }
    pub fn elapsed(&self) -> std::time::Duration {
        self.0.elapsed()
    }
    pub fn elapsed_ms(&self) -> u64 {
        self.0.elapsed().as_millis() as u64
    }
}

#[cfg(target_arch = "wasm32")]
#[derive(Debug, Clone, Copy)]
pub struct Instant(f64);

#[cfg(target_arch = "wasm32")]
impl Instant {
    pub fn now() -> Self {
        Instant(js_sys::Date::now())
    }
    pub fn elapsed(&self) -> std::time::Duration {
        std::time::Duration::from_secs_f64((js_sys::Date::now() - self.0).max(0.0) / 1000.0)
    }
    pub fn elapsed_ms(&self) -> u64 {
        (js_sys::Date::now() - self.0).max(0.0) as u64
    }
}