feat(explain): implement ATLAS-WP-0004 T01+T02 — effective-config resolver + config explain
Some checks failed
validate-registry / validate (push) Has been cancelled

Activate WP-0003 and WP-0004. Add tools/effective_config.py (deterministic,
order-independent override-path resolver — path only, never a value) and
tools/config_explain.py + `make explain` to render the layer path, winning
layer, validator, owner, consumers, and secret references for any surface.*.
Verified on all 4 seeded surfaces; order-independent; no values/secrets leak.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-06-27 00:05:01 +02:00
parent 0dd38b2c49
commit 3b909338cb
6 changed files with 255 additions and 8 deletions

View File

@@ -1,7 +1,12 @@
# config-atlas — registry validation gate (ATLAS-WP-0002-T06)
# Markdown-first repo: no build/run, only validation.
# Markdown-first repo: no build/run, only validation and the explain tool.
.PHONY: validate validate-schema validate-reuse validate-whitespace
.PHONY: validate validate-schema validate-reuse validate-whitespace explain
# Effective-config override path for a surface (ATLAS-WP-0004).
# make explain SURFACE=surface.infotech.state-hub.api-config
explain:
@python3 tools/config_explain.py $(SURFACE)
# Full gate run by agents and CI.
validate: validate-schema validate-whitespace validate-reuse