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

//! High-level frostx operations.
//!
//! Each submodule composes config loading, scanning, pipeline evaluation, and
//! state management into a single callable unit. The `frostx` binary is a thin
//! adapter over these functions; other applications can call them directly.

/// `frostx check` - inspect a project without running actions.
pub mod check;
/// `frostx doctor` - validate `frostx.toml` for correctness.
pub mod doctor;
/// `frostx gc` - remove orphaned state files.
pub mod gc;
/// `frostx init` - create `frostx.toml` with a generated UUID.
pub mod init;
/// `frostx projects` - manage the tracked-project registry.
pub mod projects;
/// `frostx run` - execute the inactivity pipeline.
pub mod run;
/// `frostx scan` - walk a directory tree and report all managed projects.
pub mod scan;

use std::path::PathBuf;

/// Shared context passed to all operation functions.
#[allow(clippy::struct_excessive_bools)]
#[derive(Debug, Clone)]
pub struct FrostxOpts {
    /// Show what would happen without executing any actions.
    pub dry_run: bool,
    /// Increase output verbosity.
    pub verbose: bool,
    /// Suppress all output except errors.
    pub quiet: bool,
    /// Skip interactive confirmations.
    pub yes: bool,
    /// Override the `frostx.toml` path.
    pub config_override: Option<PathBuf>,
    /// Config library directory.
    pub library_dir: PathBuf,
    /// State directory (`$XDG_DATA_HOME/frostx/`).
    pub state_dir: PathBuf,
    /// Synthetic inactivity duration that overrides the filesystem scan result.
    pub pretend_inactive: Option<crate::config::duration::Duration>,
}