kaizen-cli 0.1.44

Distributable agent observability: real-time-tailable sessions, agile-style retros, and repo-level improvement (Cursor, Claude Code, Codex). SQLite, redact before any sync you enable.
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

// SPDX-License-Identifier: AGPL-3.0-or-later
//! Cheap per-connection SQLite revision tracking for live Web updates.

use anyhow::Result;
use serde_json::{Value, json};
use std::path::{Path, PathBuf};
use std::time::UNIX_EPOCH;

#[derive(Default)]
pub(super) struct Subscription {
    workspace: Option<String>,
    revision: Option<Revision>,
}

#[derive(Clone, Copy, Debug, Eq, PartialEq)]
struct Revision {
    database: FileStamp,
    wal: FileStamp,
}

#[derive(Clone, Copy, Debug, Default, Eq, PartialEq)]
struct FileStamp {
    len: u64,
    modified_ns: u128,
}

impl Subscription {
    pub(super) fn set(&mut self, workspace: Option<String>) -> Result<()> {
        self.revision = workspace.as_deref().map(revision).transpose()?;
        self.workspace = workspace;
        Ok(())
    }

    pub(super) fn clear(&mut self) {
        self.workspace = None;
        self.revision = None;
    }

    pub(super) fn is_active(&self) -> bool {
        self.workspace.is_some()
    }

    pub(super) fn changed(&mut self) -> Option<Value> {
        let workspace = self.workspace.as_deref()?;
        let next = revision(workspace).ok()?;
        if self.revision == Some(next) {
            return None;
        }
        self.revision = Some(next);
        Some(json!({"type":"changed", "workspace":workspace}))
    }
}

fn revision(workspace: &str) -> Result<Revision> {
    let database = crate::core::workspace::db_path(Path::new(workspace))?;
    let wal = sidecar(&database, "-wal");
    Ok(Revision {
        database: stamp(&database),
        wal: stamp(&wal),
    })
}

fn sidecar(database: &Path, suffix: &str) -> PathBuf {
    PathBuf::from(format!("{}{suffix}", database.to_string_lossy()))
}

fn stamp(path: &Path) -> FileStamp {
    path.metadata().map_or_else(
        |_| FileStamp::default(),
        |meta| FileStamp {
            len: meta.len(),
            modified_ns: meta.modified().ok().and_then(since_epoch).unwrap_or(0),
        },
    )
}

fn since_epoch(time: std::time::SystemTime) -> Option<u128> {
    time.duration_since(UNIX_EPOCH)
        .ok()
        .map(|value| value.as_nanos())
}