Date: 2026-09-10

Settings files and precedence

Settings precedence is determined by the current configuration loader, CLI arguments, environment handling, project state, and policy. It is version-specific.

Use the current implementation

When values conflict, reproduce the issue with one source at a time: command-line option, environment value, project .compass state, then authentication/policy. Use nova --help and diagnostic logging to identify the selected value.

Boundaries and safety

Do not rely on undocumented precedence or put secrets in a committed settings file.