topmark.config.resolution package index¶

Layered config-resolution helpers for TopMark.

This subpackage contains the config-side resolution logic that bridges TOML source resolution and effective per-path config construction.

Responsibilities

define config provenance layer models
construct ConfigLayer records from resolved TOML sources
merge config provenance layers in stable precedence order
select which layers apply to a target path
build mutable config drafts, including effective per-path drafts
populate staged config-validation logs (TOML-source, merged-config) during layered resolution

This subpackage is intentionally separate from topmark.toml.resolution:

topmark.toml.resolution discovers and resolves TOML sources plus source-local TOML options
topmark.config.resolution turns layered TOML fragments into config provenance layers and merges them into mutable config drafts

Runtime-only override application is handled elsewhere (for example in topmark.config.overrides and topmark.runtime.*).

Config-validation diagnostics are collected as staged validation logs and are not flattened within this layer; flattening is performed at reporting and output boundaries.

Immediate children in this package¶

topmark.config.resolution.bridge: Bridge helpers between TOML source resolution and config draft construction.
topmark.config.resolution.layers: Config provenance layer models and construction helpers.
topmark.config.resolution.merge: Layer applicability and merge helpers for config resolution.
topmark.config.resolution.synthetic: Synthetic configuration provenance markers.