sjat/boma
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
boma/roles
History
sjat 1da117d65b docs(review): 2026-06-11 repo audit — fix build-wave doc drift 
/review-repo run at 67f2aba. Auto-fixed 5 safe doc-drift items left by the
base(firewall)+dev_env build wave: README/playbook/role notes that still called
the roles "empty/not built", plus README tree gaps and the reciprocal ADR-021
cross-links in ADR-016/020.

18 open findings reported (not fixed). Headline: `make lint` is red on `main`
(site.yml imports the non-existent docker_host role) and an ADR-004 <-> ADR-022
backup-scope contradiction. Deferral checklist clean (0 stale-deferred); 7 of
12 prior findings confirmed resolved. See docs/reviews/2026-06-11-review.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-11 14:48:00 +02:00
..
base feat(base): add ssh-from-control management-plane source (ADR-021) 2026-06-09 17:43:55 +02:00
dev_env dev_env: install Node.js from pinned tarball, drop npm bloat 2026-06-11 14:21:33 +02:00
README.md docs(review): 2026-06-11 repo audit — fix build-wave doc drift 2026-06-11 14:48:00 +02:00

README.md

roles/

Local Ansible roles. No Galaxy roles — every role is written and maintained here (ADR-003). Scaffold new ones with make new-role NAME=<name>; never create the directory structure by hand.

Each role must have: a molecule/default/ scenario (Debian 13), a populated README.md, and a filled-in meta/main.yml. Conventions: CLAUDE.md and docs/runbooks/new-role.md.

Current state: base is partially built — its firewall concern (nftables) is implemented and tested; the other concerns (SSH hardening, fail2ban, auditd, packages, users) are not yet built. docker_host does not exist yet. dev_env (interactive developer environment) is built and applied. See STATUS.md for the authoritative breakdown.