Documentation

Domains / homebrew-management

Homebrew management domain

One Homebrew tap: one entity per formula or cask, tied to the real Ruby file.

Use it when: You maintain a public or private Homebrew tap.

cumaru install agent <agent> --domain homebrew-management

Pillars

PillarLifetimeHolds
formulae/DurableOne entity per Formula/<name>.rb.
casks/DurableOne entity per Casks/<token>.rb.
release/DurableProcedures that change what the tap ships; bump.md ships with the domain.

Roles

  • Admin: full access to entities, procedures, and the .rb files.

Lifecycle

  • Git history is the release log; individual releases are not recorded.
  • cumaru coverage counts reference rows against Formula/*.rb and Casks/*.rb.

Skills

No domain-specific skills. The universal skills apply.

Bootstrap

Ships a domain bootstrap: record the tap in the root tag, inventory the .rb files, and create one confirmed entity per package.

Domain rules

  • targets: lists packages.
  • Versions and checksums live only in the .rb file.
  • The package-change discipline requires checksum verification and audit, install, and test before a package commit.

Example: Bump a formula

  1. Load formulae/<name>/index.md, then release/bump.md.
  2. Update the url and sha256 in Formula/<name>.rb; verify the checksum against the downloaded artifact.
  3. Pass audit, install, and test through the tap clone, then update the entity.

Source: domain.md, config.yaml, roles, skills at revision 37ad79f. The example is a summary of the shipped recipes, not CLI output.

Back to the comparison