Struct HostConfig 

pub struct HostConfig {
    pub workspace_root: PathBuf,
    pub extra_roots: Vec<PathBuf>,
    pub path_policy: PathPolicy,
    pub exec: ExecLimits,
    pub shell_program: String,
    pub login_shell: bool,
}

Construction-time configuration for a Host.

Fields

workspace_root: PathBuf

The path-jail root (canonicalized at Host::new).

extra_roots: Vec<PathBuf>

Additional jail roots (--add-dir), canonicalized at Host::new.

A jailed path is accepted when it resolves under workspace_root or any of these. Empty by default — the jail stays single-rooted unless a caller explicitly widens it (ADR-0008 amendment 2026-07-25).

path_policy: PathPolicy

Whether FS tools are jailed to workspace_root (default PathPolicy::Jailed).

exec: ExecLimits

Shell execution limits.

shell_program: String

The shell program to run commands through (default bash). A configurable field so a later pack / shell-detection can override it.

login_shell: bool

Run the shell as a login shell (-lc, loads the user’s profile/RC — matches all four studied harnesses) rather than -c. Default true.

Implementations

impl HostConfig

pub fn new(workspace_root: impl Into<PathBuf>) -> Self

A config for workspace_root with all defaults (jailed, bash -lc, grok limits).

Trait Implementations

impl Clone for HostConfig

fn clone(&self) -> HostConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HostConfig

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

Formats the value using the given formatter.