Files
6krrt/config/config.local.yaml.example
adlee-was-taken 17d7b72c37 feat(config): gitignored config.local.yaml overlay
WIP checkpoint committed by Claude while Atlas was still in its final
verification wave. Committed early deliberately: 11 files were sitting
uncommitted with two of them untracked, and untracked files in this tree have
been destroyed twice today by agent git cleanup -- the user's
multi-provider-support plan and a config.local.yaml holding their tariff.
Protecting the work cost nothing; losing it would have cost a whole plan.

Deployment-specific values previously lived as an UNCOMMITTED modification to
the tracked config/config.yaml. That arrangement failed seven times in one
session: three agent checkout/stash/restore calls, two `git commit -am` sweeps
that each needed a history rewrite, one ordinary branch switch, and one
cleanup during this very plan. Once a value is correctly absent from git,
every checkout, switch, pull and rebase wipes it -- that is the intended fix
behaving as designed, which is what makes the arrangement itself the bug.

load_config now deep-merges an optional config/config.local.yaml over the base
before validation, so every consumer inherits it (poller, feedback,
eval_proficiency, seed_local_dispatch_energy, admin, dispatcher). Mappings
deep-merge; lists replace wholesale; the MERGED result is validated once so
extra="forbid" still catches an overlay typo.

The admin portal now writes to the overlay and never to config/config.yaml.
An operator changing a knob in a loopback-only portal is making a local
operational decision, not a project decision -- someone changing a project
default edits config.yaml and commits it through git. This also removes the
shadowing trap by construction rather than guarding against it.

config/config.yaml stops being dirty in normal operation, which removes the
condition behind every clobbering above.

NOTE: final verification wave had not reported when this was committed. The
suite was green at 1155 before it started; Atlas may amend or add commits on
top.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VRQXz5SYZYVWscxS1QqF6U
2026-09-04 18:29:23 -04:00

17 lines
702 B
Plaintext

# config.local.yaml — machine-local overrides
#
# This file is gitignored. It takes precedence over config/config.yaml when
# load_config() merges the overlay, so place deployment-specific or personal
# secrets and knobs here instead of editing the tracked config.yaml:
# - local_energy.enabled + local_energy.tariff_usd_per_kwh
# - host-specific classifier.base_url / verification.base_url
# - any value you change between machines but want to keep in the repo default
#
# Only the keys you want to override need to be present — the rest come from
# config/config.yaml.
# Example: enable local energy metering on your dev machine.
# local_energy:
# enabled: true
# tariff_usd_per_kwh: 0.159