When a numbered ADR announces a rename Old->New, flag design-doc lines where Old still appears in present tense — skipping the announcing ADR, lines that also name New, and historical/negation cues, and rejecting ADR-NNN tokens as terms. Structural cousin of stale-deferred; run by /review-repo. Zero findings on the current tree (the Traefik->Caddy ripple edits have landed). Consumes the 2026-06-14 KEEP-OPEN signal in docs/FRICTION.md. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| capacity-scan.py | ||
| check-tags.py | ||
| check-vault-encrypted.sh | ||
| check-vault.py | ||
| friction-scan.py | ||
| README.md | ||
| repo-scan.py | ||
| tf_to_inventory.py | ||
| vault-pass-client.sh | ||
scripts/
Small helper scripts. Python standard library only — no third-party
dependencies (keeps them runnable anywhere without a venv). One deliberate
exception: check-vault.py is a vault tool that needs the ansible venv (PyYAML +
ansible-vault) and rbw, so it is not run-anywhere by design.
tf_to_inventory.py— readsterraform output -jsonon stdin and writes an Ansiblehosts.yml. Invoked bymake tf-inventory. Data contract: ADR-009.check-vault.py— validates a vault file's structure (decrypts in-memory; valid YAML; secrets under the nestedvault:map; no empty leaves) and prints a values-masked view. Invoked bymake check-vaultand aftermake edit-vault.vault-pass-client.sh— fetches the master vault password from Vaultwarden viarbw. Wired asvault_password_file(ADR-002).check-vault-encrypted.sh— pre-commit guard: fails if avault.ymlholds plaintext secrets.check-tags.py— enforces the closed tag vocabulary (tests/tags.yml) and that each role import in a play carries its role-name tag. Invoked bymake lint. See ADR-019.repo-scan.py— Phase-0 deterministic scan for/review-repo(markers, broken refs, unencrypted vaults, inventory).capacity-scan.py— deterministic capacity facts for/capacity-review: parses the machine-readable tables indocs/hardware/reference.md, computes per-node allocated-vs-physical rollups, and cross-checks workload hostnames against Terraform output / Ansible inventory for drift. Emits JSON. See ADR-012.