Struct OutputRootConfig 

pub struct OutputRootConfig {
    pub root_dir: PathBuf,
    pub per_entity_subtree: bool,
    pub entity_code: Option<String>,
}

Output routing config for the enhanced orchestrator’s file-writer.

In single-entity mode (default) OutputRootConfig::flat preserves the pre-v5.0 layout: all generated files land directly under root_dir.

In group-audit shard mode, the runner sets per_entity_subtree: true and entity_code: Some(code) so each entity’s archive is written under {root_dir}/entities/{code}/, leaving {root_dir}/ itself available for group-wide artifacts (consolidated FS, aggregate summary, etc).

Fields

root_dir: PathBuf

Root output directory as configured by the caller.

per_entity_subtree: bool

When true, output is routed under {root_dir}/entities/{entity_code}/ so group-wide artifacts (consolidated FS, summary) can live alongside per-entity shard archives at {root_dir}/.

entity_code: Option<String>

Entity code identifying the shard. Ignored when per_entity_subtree is false. When per_entity_subtree is true but this is None, OutputRootConfig::effective_dir safely falls back to root_dir.

Implementations

impl OutputRootConfig

pub fn flat(root_dir: impl Into<PathBuf>) -> Self

Flat single-entity layout: files written directly under root_dir.

pub fn per_entity( root_dir: impl Into<PathBuf>, entity_code: impl Into<String>, ) -> Self

Per-entity subtree layout: files written under {root_dir}/entities/{entity_code}/.

pub fn effective_dir(&self) -> PathBuf

Resolve the effective output_dir path for the file-writer. This is the directory into which all the existing write_* helpers compose their .join("subdir") paths.

Defensive fallback: if per_entity_subtree is true but entity_code is None, we revert to root_dir rather than write into a nameless {root_dir}/entities/ directory.

pub fn root_path(&self) -> &Path

Root directory borrowed as a &Path — useful for group-wide artifacts (consolidated FS, aggregate summary) that must sit alongside the per-entity subtrees rather than inside one of them.

Trait Implementations

impl Clone for OutputRootConfig

fn clone(&self) -> OutputRootConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OutputRootConfig

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

Formats the value using the given formatter.

impl Default for OutputRootConfig

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for OutputRootConfig

fn eq(&self, other: &OutputRootConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for OutputRootConfig

impl StructuralPartialEq for OutputRootConfig