Skip to main content

kaizen/core/
paths.rs

1// SPDX-License-Identifier: AGPL-3.0-or-later
2//! Shared path helpers (used by `workspace` and `machine_registry` to avoid import cycles).
3
4use anyhow::Result;
5use std::path::{Path, PathBuf};
6
7/// `KAIZEN_HOME` or `~/.kaizen` (requires `HOME`), or `None` if undiscoverable.
8pub fn kaizen_dir() -> Option<PathBuf> {
9    std::env::var("KAIZEN_HOME")
10        .ok()
11        .map(PathBuf::from)
12        .or_else(|| {
13            std::env::var("HOME")
14                .ok()
15                .map(|home| PathBuf::from(home).join(".kaizen"))
16        })
17}
18
19/// `/Users/lucas/Projects/kaizen` → `Users-lucas-Projects-kaizen`
20pub fn workspace_slug(path: &Path) -> String {
21    path.to_string_lossy()
22        .trim_start_matches('/')
23        .replace('/', "-")
24}
25
26/// `~/.kaizen/projects/<slug>/` (or `$KAIZEN_HOME/projects/<slug>/`), created on demand.
27pub fn project_data_dir(workspace: &Path) -> Result<PathBuf> {
28    let home = kaizen_dir().ok_or_else(|| anyhow::anyhow!("KAIZEN_HOME / HOME unset"))?;
29    let canon = std::fs::canonicalize(workspace).unwrap_or_else(|_| workspace.to_path_buf());
30    let slug = workspace_slug(&canon);
31    let dir = home.join("projects").join(slug);
32    std::fs::create_dir_all(&dir)?;
33    Ok(dir)
34}
35
36pub fn canonical(path: &Path) -> PathBuf {
37    std::fs::canonicalize(path).unwrap_or_else(|_| absolute(path))
38}
39
40fn absolute(path: &Path) -> PathBuf {
41    if path.is_absolute() {
42        return path.to_path_buf();
43    }
44    std::env::current_dir()
45        .map(|cwd| cwd.join(path))
46        .unwrap_or_else(|_| path.to_path_buf())
47}
48
49#[cfg(test)]
50pub(crate) mod test_lock {
51    use std::sync::{Mutex, OnceLock};
52
53    static LOCK: OnceLock<Mutex<()>> = OnceLock::new();
54
55    pub fn global() -> &'static Mutex<()> {
56        LOCK.get_or_init(|| Mutex::new(()))
57    }
58}