Skip to content

Prefer Homebrew packages with apt fallback - #2

Merged
StreamOfRon merged 8 commits into
mainfrom
package-manager-precedence
Oct 29, 2026
Merged

StreamOfRon merged 8 commits into
mainfrom
package-manager-precedence

Conversation

@StreamOfRon

Copy link
Copy Markdown
Owner

Implements docs/superpowers/plans/2026-10-25-package-manager-precedence.md (spec: docs/superpowers/specs/2026-10-25-package-manager-precedence-design.md).

Goal: prefer Homebrew formulae on machines that have both brew and apt; apt fills the gaps; casks only on macOS.

Changes

  • Detection tasks/package_manager.yml: sets brew_available/brew_bin/brew_bin_dir by locating brew independently of ansible_facts.pkg_mgr (Linux reports pkg_mgr=apt even with Linuxbrew). Initialises brew list facts when brew is absent.
  • Resolver tasks/package_resolve.yml: side-effect-free group resolution — installs *_formulae plus apt entries promoted where a same-named brew formula exists; brew_apt_equivalents covers renamed pairs (nodejs/npm→node, kubectl→kubernetes-cli); removal (enabled: false) passes the full apt list.
  • Dispatcher tasks/package_group.yml: formulae → apt fallback → casks (macOS only). All ten group blocks in main.yml and ai-dev-tools.yml migrated to it.
  • Cask guard: ansible_facts.system == "Darwin" as first condition on the cask task.
  • git/krew: prefer brew; apt/manual paths gated on not (brew_available | bool) with sudo gating preserved.
  • Cron PATH now includes Linuxbrew bin/sbin so unattended runs detect brew.
  • Config: prefer_homebrew: true default + TUI toggle; ~/.setup-options can force apt.
  • Docs: AGENTS.md precedence convention, README mention.

Verification

  • ansible-playbook --syntax-check: clean
  • tests/test_brew_detection.yml: ok=8 failed=0
  • tests/test_package_precedence.yml: ok=40 failed=0 (8 scenarios)
  • python3 -m unittest tests.test_setup_config: 36 OK
  • pkg_mgr == "homebrew" grep across group/git/krew/list files: no hits
  • ansible-lint: no new findings vs merge-base (54→51 violations, all pre-existing classes)
  • main.yml --check runtime pass used to pin down a template recursion fix in the dispatcher

@StreamOfRon
StreamOfRon force-pushed the package-manager-precedence branch from 631b3e8 to ac2db61 Compare October 29, 2026 01:53
@StreamOfRon
StreamOfRon merged commit a9e5fcc into main Oct 29, 2026
1 check passed
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