Struct ProvenanceConfig 

pub struct ProvenanceConfig {
    pub enabled: bool,
    pub track_all: bool,
}

[provenance] — master switch for the value-lineage engine (src/extensions/provenance.rs).

The engine is already inert until a provenance -m NAME call arms it, so enabled = true (the default) costs one relaxed atomic load per hook site and nothing else. Setting enabled = false refuses arming entirely: provenance -m reports the engine as disabled and no hook can ever fire, which is the setting to use on a machine where the ledger must not exist at all.

[provenance]
enabled = false

track_all = true skips the arming step entirely — every parameter write and every shell function records a chain:

[provenance]
track_all = true

ZSHRS_PROVENANCE=0 in the environment overrides the config and disables the engine regardless of these fields; ZSHRS_PROVENANCE_ALL=1 / =0 overrides track_all alone.

Fields

enabled: bool

Allow provenance -m NAME to arm the lineage ledger.

track_all: bool

Track everything, with no -m call: every parameter the shell writes and every shell function it defines or calls arms itself. Off by default — with it on, the engine is armed from the first line of the first rc file, so every hook does real work for the life of the shell. ZSHRS_PROVENANCE_ALL=1 / =0 overrides this field; enabled = false still wins over both.

Trait Implementations

impl Clone for ProvenanceConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProvenanceConfig

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

Formats the value using the given formatter.

impl Default for ProvenanceConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ProvenanceConfig

where ProvenanceConfig: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.