# cc-ci server settings (phase settings) — EXAMPLE / documentation.
#
# This is a minimal, extensible server-level config for the cc-ci CI host. Copy it to the live host
# path and edit as needed:
#
#     cp settings.toml.example /etc/cc-ci/settings.toml      # (or set $CCCI_SETTINGS to any path)
#
# The live file is OPERATOR-MANAGED and not committed (a per-server host override). Every key has a
# default baked into the loader (runner/harness/settings.py), so an ABSENT file — or an absent key —
# behaves exactly as the documented default. You only need a live file to CHANGE a default.
#
# NO SECRETS in this file — config only. Secrets stay in sops.
# Stdlib TOML (tomllib): booleans are `true`/`false` (lowercase, unquoted).

[upgrade]
# When true, the upgrade-tier BASE is resolved WITHOUT canonicals: the canonical (last-green warm)
# lookup is skipped entirely and the base falls through to the no-canonical fallback — the most recent
# release TAG on main older than the PR head, with the raw main-tip only as a further fallback, then
# skip. Codifies canonicals as an optional optimization (an operator switch); does NOT affect canonical
# promotion or the `--quick` warm-reattach (those are separate, out of scope here).
#
# Default: false (this server keeps canonicals on — the optimized/robust upgrade-base path).
skip_canonicals_for_upgrade = false