cadrumo.core.storage_materialization module

Explicit filesystem materialization for the configured storage topology.

Reading cadrumo.core.config is intentionally non-mutating. Callers that need the on-disk topology opt into it through this module instead.

STORAGE_ROOT_MODE: Final[int]

Permission mode ensure_storage_tree() requests on the state root.

ensure_storage_tree(settings=None)

Validate explicit storage dependencies and materialize owned defaults.

This is the sole opt-in topology materialization boundary. Settings and derived-path reads never enter it implicitly. Operator-selected directory overrides must already exist; the application-owned root and derived defaults are provisioned idempotently.

Return type:

Path

Parameters:

settings (Settings | None)