frostx 0.1.0

frostx monitors project directories for inactivity. Once a configured inactivity threshold elapses (e.g. "90 days since any file was modified"), frostx executes a pipeline of **actions** - e.g., checking git state, creating archives, uploading backups, deleting local copies. Automating the lifecycle of projects, frostx helps users manage disk space and maintain a clean workspace.
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

//! `frostx check` - inspect inactivity and rule trigger status.

use crate::config::state::ProjectState;
use crate::error::FrostxError;
use crate::output::{build_check_output, CheckOutput};
use crate::pipeline;
use crate::scanner;
use std::path::Path;

use super::FrostxOpts;

/// Evaluate a project's inactivity and rule trigger status without running any actions.
///
/// Loads config and state, evaluates rules, persists the updated `project_path`,
/// and returns the rendered output ready for display or further processing.
///
/// # Errors
///
/// Returns an error if the config or state cannot be loaded, or if the scan fails.
pub fn gather(path: &Path, opts: &FrostxOpts) -> Result<CheckOutput, FrostxError> {
    let config = super::init::load_config(path, opts)?;
    super::init::check_uuid_collision(&config, path, &opts.state_dir)?;

    let mut state = ProjectState::load(&opts.state_dir, config.id)?;
    state.project_path = path.canonicalize().unwrap_or_else(|_| path.to_path_buf());

    let scan = scanner::scan(path)?;
    let last_modified = opts
        .pretend_inactive
        .as_ref()
        .map_or(scan.last_modified, |d| d.subtract_from(chrono::Utc::now()));
    let inactive_seconds = (chrono::Utc::now() - last_modified).num_seconds().max(0);
    let outcomes = pipeline::evaluate(&config, &state, last_modified)?;

    let project_name = config
        .name
        .as_deref()
        .or_else(|| state.project_path.file_name().and_then(|n| n.to_str()))
        .unwrap_or("unknown");

    let out = build_check_output(
        project_name,
        config.description.as_deref(),
        path,
        config.id,
        inactive_seconds,
        &outcomes,
    );

    state.last_scan = Some(chrono::Utc::now());
    state.save(&opts.state_dir, config.id)?;

    Ok(out)
}