Skip to main content

second_brain_core/
write_queue.rs

1/// The directory under the data dir where writes wait for the daemon; the
2/// MCP server, the daemon's write gate and its replayer all use it.
3pub const DIR_NAME: &str = "queue";
4
5/// `<19-digit unix nanos>-<uuid>.json`; no other name in the directory is
6/// an entry, so a file still being written under a temporary name is never
7/// read.
8pub fn is_entry_name(name: &str) -> bool {
9    let Some(stem) = name.strip_suffix(".json") else {
10        return false;
11    };
12    let Some((nanos, id)) = stem.split_at_checked(19) else {
13        return false;
14    };
15    nanos.bytes().all(|b| b.is_ascii_digit())
16        && id
17            .strip_prefix('-')
18            .is_some_and(|id| id.len() == 36 && uuid::Uuid::parse_str(id).is_ok())
19}
20
21#[cfg(test)]
22mod tests {
23    use super::*;
24
25    #[test]
26    fn only_timestamped_uuid_json_names_are_entries() {
27        let id = "0b5c2f9e-5d0e-4c1a-9a57-0c7f4f1f2a10";
28        assert!(is_entry_name(&format!("1793505622000000000-{id}.json")));
29        for name in [
30            "projects.json".to_string(),
31            ".lock".to_string(),
32            format!("1793505622000000000-{id}.json.tmp"),
33            format!("179350562200000000-{id}.json"),
34            format!("1793505622000000000-{id}.unreadable"),
35            "1793505622000000000-not-a-uuid.json".to_string(),
36        ] {
37            assert!(!is_entry_name(&name), "{name}");
38        }
39    }
40}