Struct Config 

pub struct Config {
    pub scope: ScopeConfig,
    pub kinds: KindsConfig,
    pub statuses: StatusesConfig,
    pub identity: IdentityConfig,
    pub schema: SchemaConfig,
    pub rules: RulesConfig,
    pub parser: ParserConfig,
    pub detection: DetectionConfig,
    pub output: OutputConfig,
    pub report: ReportConfig,
}

Root configuration deserialized from nodex.toml.

Fields

scope: ScopeConfig

kinds: KindsConfig

statuses: StatusesConfig

identity: IdentityConfig

schema: SchemaConfig

rules: RulesConfig

parser: ParserConfig

detection: DetectionConfig

output: OutputConfig

report: ReportConfig

Implementations

impl Config

pub fn load(root: &Path) -> Result<Self>

Load config from a nodex.toml file. Returns default config if not found.

Config is validated for internal consistency before it is returned, so downstream code can assume that enums / cross_field references are well-formed.

pub fn validate(&self) -> Result<()>

Validate internal consistency. Called automatically by load().

Rejects definitions that would otherwise only surface as confusing runtime behaviour:

• enums on collection-valued built-in fields (tags, supersedes, implements, related) — these cannot be validated against a scalar set, so silent ignore would trap users who typed the obvious syntax and saw no effect.
• enums.status / enums.kind values that are not in the corresponding global allowed list.
• cross_field.when expressions that don’t parse.
• cross_field.when’s LHS and cross_field.require referring to a field name that is not a built-in scalar and is not declared in the override’s types / enums / required.

pub fn types_for(&self, kind: &str) -> BTreeMap<String, FieldType>

Merged view: return every field-type constraint that applies to a given kind (global + first matching override). Scaffold and rules use this so every declared constraint is honoured once.

pub fn enums_for(&self, kind: &str) -> BTreeMap<String, Vec<String>>

Merged view: every enum constraint that applies to a given kind.

pub fn cross_field_for(&self, kind: &str) -> Vec<CrossFieldSpec>

Merged view: every cross-field constraint that applies to a given kind. Global and override entries accumulate; an override never silently drops a global rule.

pub fn is_terminal(&self, status: &str) -> bool

Check whether a status string is terminal.

pub fn is_orphan_ok_kind(&self, kind: &str) -> bool

Whether nodes of the given kind are exempt from orphan detection.

Driven by detection.orphan_ok_kinds. Pairs with the per-instance node.orphan_ok opt-out so callers can express both “this entire kind is leaf-by-design” and “this specific document is exceptional”. Named to mirror the field and the per-node flag, paralleling is_terminal ↔ statuses.terminal.

pub fn required_for(&self, kind: &str) -> &[String]

Get required fields for a given kind. Falls back to the global schema.required list when no override matches.

pub fn schema_override_for(&self, kind: &str) -> Option<&SchemaOverride>

Find the schema override that applies to a given kind, if any.

pub fn initial_status_for(&self, kind: &str) -> &str

The status value that tool-level actions (scaffold, migrate) should write when they create a new document of a given kind.

Walks from the narrowest declaration to the broadest: per-kind override’s enums.status, then the global schema.enums.status, then statuses.allowed. The first hit’s first() wins. Config::validate guarantees each of these is either absent or non-empty, and that any enums.status covers the four lifecycle targets — so the result is always in-vocabulary and the invariant holding migrate / scaffold together with check never breaks.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Config

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Config

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Config

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.