Struct AppConfig 

pub struct AppConfig {
    pub log_dir: Option<PathBuf>,
    pub log_dir_source: LogDirSource,
    pub log_enabled: bool,
    pub prompt_preview_chars: usize,
    /* private fields */
}

Application-wide configuration resolved from environment variables.

Log directory resolution order:

1. ALC_LOG_DIR env var (explicit override)
2. ~/.algocline/logs (home-based default)
3. $XDG_STATE_HOME/algocline/logs or ~/.local/state/algocline/logs
4. Current working directory (sandbox fallback)
5. None — stderr-only mode (no file logging)

Application root directory resolution:

1. ALC_HOME env var (explicit override — same pattern as CARGO_HOME / RUSTUP_HOME).
2. ~/.algocline/ — home-based default.
3. ./.algocline/ — fallback when HOME is not available (unusual).

• ALC_LOG_LEVEL: full (default) or off.
• ALC_PROMPT_PREVIEW_CHARS: char count for alc_status(pending_filter="preview") prompt truncation. Falls back to algocline_engine::DEFAULT_PROMPT_PREVIEW_CHARS when unset or unparseable. Setting 0 yields empty previews — if you want no prompt at all, use the "meta" preset instead.

Fields

log_dir: Option<PathBuf>

Resolved log directory, or None if no writable directory is available.

log_dir_source: LogDirSource

log_enabled: bool

prompt_preview_chars: usize

Char count for alc_status prompt_preview truncation.

Implementations

impl AppConfig

pub fn from_env() -> Self

Build from environment variables (single resolution point).

pub fn app_dir(&self) -> Arc<AppDir>

Shared handle to the resolved application root directory.

pub fn with_app_dir(self, root: PathBuf) -> Self

Override the application root directory — intended for tests that need to redirect every ~/.algocline/ access to a tempdir.

pub fn resolve_home() -> Option<PathBuf>

Resolve the user’s home directory for facilities that legitimately need real ~ access (e.g. ~/.ssh/ key detection in gh_credentials::check_ssh_keys).

This is the single Service-layer HOME-read site aside from Self::resolve_app_dir itself. Every other caller in crates/algocline-app/src/service/** MUST route through this fn (or resolve_app_dir / AppDir) so check-invariants Inv-1 keeps a single-source-of-truth whitelist. Returns None on sandboxes where HOME cannot be resolved (mirroring resolve_app_dir’s fallback path).

Trait Implementations

impl Clone for AppConfig

fn clone(&self) -> AppConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AppConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.