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
| Pillar | Lifetime | Holds |
|---|---|---|
formulae/ | Durable | One entity per Formula/<name>.rb. |
casks/ | Durable | One entity per Casks/<token>.rb. |
release/ | Durable | Procedures 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
- Load formulae/<name>/index.md, then release/bump.md.
- Update the url and sha256 in Formula/<name>.rb; verify the checksum against the downloaded artifact.
- 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.