bijux-cli 0.3.6

Command-line runtime for automation, plugin-driven tools, and interactive workflows with structured output.
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

#![forbid(unsafe_code)]
//! State diagnostics query model and resolver.

use std::fs;
use std::path::{Path, PathBuf};

/// File-system status for a single state path.
#[derive(Debug, Clone, PartialEq, Eq)]
#[allow(clippy::struct_excessive_bools)]
pub struct StatePathStatus {
    /// Absolute or resolved path.
    pub path: PathBuf,
    /// Whether the path exists.
    pub exists: bool,
    /// Whether the path is a regular file.
    pub is_file: bool,
    /// Whether the path is a directory.
    pub is_dir: bool,
    /// File size in bytes.
    pub size_bytes: u64,
    /// Whether the path can be read by the current process.
    pub readable: bool,
    /// Whether the path can be written by the current process.
    pub writable: bool,
}

/// Structured state diagnostics queried from runtime state paths.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct StateDiagnosticsQuery {
    /// Config file status.
    pub config: StatePathStatus,
    /// History file status.
    pub history: StatePathStatus,
    /// Plugin registry status.
    pub plugins_registry: StatePathStatus,
    /// Memory file status.
    pub memory: StatePathStatus,
}

fn parent_dir_is_writable(path: &Path) -> bool {
    let mut cursor = path.parent();
    while let Some(parent) = cursor {
        if let Ok(metadata) = fs::metadata(parent) {
            return metadata.is_dir() && !metadata.permissions().readonly();
        }
        cursor = parent.parent();
    }
    false
}

fn state_path_status(path: &Path) -> StatePathStatus {
    let metadata = fs::metadata(path);
    StatePathStatus {
        path: path.to_path_buf(),
        exists: metadata.is_ok(),
        is_file: metadata.as_ref().is_ok_and(std::fs::Metadata::is_file),
        is_dir: metadata.as_ref().is_ok_and(std::fs::Metadata::is_dir),
        size_bytes: metadata.as_ref().map_or(0_u64, |entry| entry.len()),
        readable: fs::read(path).is_ok(),
        writable: if path.exists() {
            fs::OpenOptions::new().append(true).open(path).is_ok()
        } else {
            parent_dir_is_writable(path)
        },
    }
}

/// Query state diagnostics from resolved runtime paths.
#[must_use]
pub fn state_diagnostics_query(
    config: &Path,
    history: &Path,
    plugins_registry: &Path,
    memory: &Path,
) -> StateDiagnosticsQuery {
    StateDiagnosticsQuery {
        config: state_path_status(config),
        history: state_path_status(history),
        plugins_registry: state_path_status(plugins_registry),
        memory: state_path_status(memory),
    }
}