Skip to content

docs: update README, add ADR-007 and ADR-008#40

Merged
CybotTM merged 3 commits into
mainfrom
docs/update-readme-and-adrs
Feb 25, 2026
Merged

docs: update README, add ADR-007 and ADR-008#40
CybotTM merged 3 commits into
mainfrom
docs/update-readme-and-adrs

Conversation

@CybotTM
Copy link
Copy Markdown
Member

@CybotTM CybotTM commented Feb 25, 2026

Summary

  • Fix outdated README claim about missing tests (493+ tests exist)
  • Update installation section to document generic make install-<tool> pattern for all 89 cataloged tools
  • Update Python version requirement from 3.9+ to 3.14+
  • Add ADR-007: Generic Tool Installation Architecture (catalog JSON + generic installers + install_tool.sh)
  • Add ADR-008: Makefile Pattern Target Fallback Chain (dedicated script → install_tool.sh → error)
  • Update ADR index and catalog/README.md

Test plan

  • No functional changes — documentation only
  • All 492 tests pass
  • ADR files verified non-empty

Fix outdated README claim about missing tests (493 tests exist).
Update Python version requirement to 3.14+ per pyproject.toml.
Update installation section to document generic make install-<tool>
pattern for all 89 cataloged tools. Document upgrade-%, uninstall-%,
and reconcile-% pattern targets with fallback chain.

Add ADR-007 documenting the generic tool installation architecture
(catalog JSON + generic installers + install_tool.sh orchestrator).

Add ADR-008 documenting the Makefile pattern target fallback chain
(dedicated script -> install_tool.sh -> error).

Update ADR index and catalog/README.md to reflect current architecture.

Signed-off-by: Sebastian Mendel <info@sebastianmendel.de>
@gemini-code-assist
Copy link
Copy Markdown

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

- Fix test count from 493+ to 490+ in README
- Fix fd.json example in ADR-007 to use shfmt (actual github_release_binary user)
- Add missing installers to ADR-007 Tier 2 table (docker_plugin, github_clone, npm_self_update)
- Document auto/reconciliation install method in ADR-007
- Add upgrade/update naming note to ADR-008

Signed-off-by: Sebastian Mendel <info@sebastianmendel.de>
Signed-off-by: Sebastian Mendel <info@sebastianmendel.de>
@CybotTM CybotTM merged commit 43eac2e into main Feb 25, 2026
11 checks passed
@CybotTM CybotTM deleted the docs/update-readme-and-adrs branch March 16, 2026 10:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant