lucasgelfond/zerobrew
67.8
Adequate · 14 November 2026
31k
lines of production code
Rust
primary language
5
measurements over time
What this system is
Features
Add homepage styling and responsive layout
The site now includes a complete visual design for the homepage, featuring a responsive layout that adapts to different screen sizes. This change introduces a new CSS architecture with semantic tokens for colors, spacing, and typography, alongside component-specific styles for the header, footer, hero section, installation panels, and summary cards. A JavaScript module powers interactive elements on the homepage, such as tabbed installation commands with keyboard navigation and clipboard copying functionality. Additionally, new assets including a favicon, Ferris mascot image, and decorative wave graphics have been added to support the new visual identity.
site/src/assets · high confidence
Added demo script for recording installation and usage walkthroughs
A new shell script (assets/demo.sh) has been added to facilitate recording asciinema demos. This script automates a sequence of actions including initializing the tool, updating packages, installing and uninstalling imagemagick, and running a zbx command, providing a consistent baseline for demonstrating the product's functionality.
assets · high confidence
Implement Homebrew-compatible keg linking and bottle configuration installation
The cellar module now handles keg installation and prefix linking with behavior that matches Homebrew. It installs default configuration files from bottles into the prefix (preserving user edits by appending \.default\ to conflicting files) and links keg directories (\bin\, \sbin\, \lib\, \include\, \share\, \etc\) using Homebrew's specific rules for shared paths, locale directories, and application bundles. The \libexec\ directory is explicitly excluded from linking to prevent cross-formula collisions, and the system now detects missing dynamic libraries for installed kegs on macOS to warn users of broken dependencies.
_zb\io/src/cellar · high confidence
Initial Eleventy site configuration
The site now uses Eleventy as its static site generator, configured to build content from the 'src' directory into '\_site'. The configuration sets up passthrough copying for static assets and redirect rules, establishing the foundational structure for the website's frontend shell.
site · high confidence
Initial core library structure for package management
The \zb\_core\ library has been introduced to provide the foundational components for the package manager. This includes a \Context\ struct that defines default system paths (rooted at \/opt/zerobrew\) and concurrency limits for downloads and builds. A comprehensive \Error\ enum is added to handle specific failure modes such as checksum mismatches, link conflicts, unsupported bottles, and dependency cycles. Additionally, the \formula\ module exposes types for managing formula states (like \KegOnly\) and logic for selecting compatible macOS bottles.
_zb\core/src · high confidence
Initial release of zerobrew
This entry marks the initial release of zerobrew, a package manager for macOS and Linux that applies a uv-style architecture to Homebrew formulae. The release includes the core CLI (\zb\), a benchmarking tool (\zbx\), and a Justfile-based development workflow. It introduces features such as formula post-install step execution, CA bundle caching, \zb doctor\ for state diagnosis, \zb upgrade\ for package updates, and \zb bundle\ for Brewfile support. The installer script supports environment variable overrides and shell configuration management, while the project establishes its repository structure under the \zerobrewhq\ organization with comprehensive documentation, licensing, and community guidelines.
(repo-wide) · high confidence
Initial site structure with homepage and redirects
The site now includes a basic Eleventy shell with a homepage layout and specific URL redirects. Users visiting /install, /discord, or /github are automatically redirected to the corresponding external resources (the ZeroBrew install script, Discord server, and GitHub repository) via 302 redirects. The homepage itself is rendered using a base layout and includes a home shell component.
site/src · high confidence
Introduce build plan and system detection logic
The build module now exposes a \BuildPlan\ struct and a \detect\_build\_system\ function that determines the build system (CMake, Meson, Autoconf, or RubyFormula) based on a formula's source URL and build dependencies. This allows the package manager to automatically identify how to compile source packages, with CMake and Meson prioritized when their respective tools are listed as build dependencies, and Autoconf inferred from standard tarball extensions.
_zb\core/src/build · high confidence
Introduce content-addressed blob cache and versioned SQLite store for package management
The storage layer now uses a new \BlobCache\ to store downloaded package archives (blobs) by their SHA-256 hash, ensuring atomic writes via temporary files and automatic cleanup on failure. Package metadata and installation state are persisted in a new SQLite database (\db.rs\) that includes schema versioning with migration support and downgrade protection. The \Store\ component manages unpacked package entries with locking and staged publishing to ensure consistency during installation.
_zb\io/src/storage · high confidence
Introduce source-build support with environment setup and execution
The \zb\_io\ module now includes a new \build\ submodule that enables building packages from source. This adds a \BuildExecutor\ to orchestrate the download, extraction, and execution of Ruby-based build shims, alongside an \environment\ module that configures build variables (such as \PATH\, \PKG\_CONFIG\_PATH\, and \CFLAGS\) and detects the number of available CPUs. The implementation also introduces a \source\ module for downloading and extracting source tarballs with SHA-256 verification, and a \shim.rb\ file that provides a Homebrew-compatible Ruby DSL for formula execution. Also in this area: Formula shim now supports generating shell completions for PowerShell.
(repo-wide) · high confidence
New CLI commands for package management, diagnostics, and automation
The \zb\ CLI now includes a comprehensive set of new commands to manage packages and system state. Users can bundle installations and configurations using \zb bundle\ (with \install\ and \dump\ subcommands) to manage Brewfile manifests. System health can be diagnosed and repaired with \zb doctor\, and stale data can be cleaned up via \zb gc\. Package updates are handled by \zb outdated\ (supporting \--quiet\, \--verbose\, and \--json\ flags) and \zb upgrade\, which also supports \--build-from-source\ and \--no-link\ options. Existing workflows are enhanced with \zb update\ to clear the API cache, \zb info\ for human-readable installation timestamps, and \zb run\ for temporary package execution with automatic environment setup. Migration from Homebrew is streamlined with \zb migrate\, and the system can be fully reset with \zb reset\. Additional utilities include \zb completion\ for shell integration, \zb list\ for installed packages, and \zb uninstall\ supporting multiple packages and an \--all\ flag.
_zb\cli/src/commands · high confidence
New archive extraction module with streaming support and security validation
Added a new \zb\_io/src/extraction\ module that provides functions to detect and unpack compressed archives (Gzip, Xz, Zstd, and Zip) into a destination directory. The implementation supports streaming extraction from readers, allowing archives to be unpacked while still downloading, and includes path validation checks to prevent directory traversal vulnerabilities during extraction.
_zb\io/src/extraction · high confidence
New in-place binary and text patching for Linux and macOS bottles
The patching subsystem has been rewritten to support in-place relocation of Homebrew bottles on both Linux and macOS. On Linux, it now patches ELF binaries (updating RPATH, RUNPATH, and the dynamic linker interpreter) and text files, including PHP archives (PHARs) which are automatically re-signed after placeholder replacement. On macOS, it rewrites Mach-O load commands (install names, dylib paths, rpaths) in place, preserving code signatures and handling cases where new paths exceed the original slot size by falling back to \install\_name\_tool\. Both platforms share a common text-patching engine that preserves file permissions and handles scripts with binary payloads.
_zb\io/src/extraction/patch · high confidence
New modular download subsystem with parallel execution and registry authentication
The download logic in \zb\_io/src/network/download\ has been restructured into a new modular architecture (\auth.rs\, \parallel.rs\, \single.rs\, \mod.rs\) that introduces parallel bottle downloading and pre-fetched authentication for container registries. Users benefit from faster install times due to concurrent downloads (limited to 20 connections) and reduced latency from pre-authorizing requests to GHCR. The system also supports mirror fallbacks via the \HOMEBREW\_BOTTLE\_MIRRORS\ environment variable and includes robust retry logic with backoff for transient network errors.
_zb\io/src/network/download · high confidence
Scaffold Eleventy frontend shell with homepage components
Added the foundational Eleventy layout and homepage components for the site, including a base HTML template with accessibility features (skip-link, semantic tags), a responsive header and footer, and specific homepage sections for hero branding, installation instructions with copy-to-clipboard functionality, and benchmark visualizations.
_site/src/\includes · high confidence
Zerobrew CLI initial release with package management and diagnostics
The \zb\ command-line interface is now available, providing a Homebrew-compatible package manager. Users can install, uninstall, and upgrade formulas and casks, including support for building from source and managing Brewfiles. The CLI includes diagnostic tools like \zb doctor\ for state repair, \zb outdated\ for checking versions, and \zb run\ for executing temporary commands. Initialization (\zb init\) handles directory setup and shell configuration, with specific safeguards for macOS Mach-O path limits. The interface supports verbose/quiet modes, configurable concurrency, and provides helpful suggestions for missing formulas.
_zb\cli/src · high confidence
Architecture
Restructured CLI binaries into src/bin/ with dedicated zbx wrapper
The CLI entry points have been reorganized to follow the src/bin/ convention, introducing zb.rs as the main executable and zbx.rs as a dedicated wrapper for the 'run' command. The zb binary now serves as the central dispatcher for all subcommands (including init, install, bundle, uninstall, doctor, update, outdated, upgrade, and reset), handling argument parsing, logging initialization, and installer setup. The new zbx binary provides a convenient way to execute commands from installed formulas without linking them by directly invoking zb run with the provided arguments.
_zb\cli/src/bin · high confidence
Behavioural changes
Formula parsing and dependency resolution overhaul
The formula core has been restructured into submodules to support new Homebrew API features and fix cross-platform dependency handling. Users benefit from declarative post-install step parsing, which allows the system to execute specific setup actions defined in the formula API. Dependency resolution now correctly handles \uses\_from\_macos\ dependencies on Linux and respects \keg-only\ designations, ensuring that packages marked as keg-only (especially those with macOS-specific reasons) are not incorrectly linked or selected on non-macOS platforms. Additionally, bottle selection logic has been improved to prefer compatible macOS versions and restrict Linux bottle fallbacks by architecture, while also recording the build prefix for pinned bottles to ensure correct path resolution.
_zb\core/src/formula · high confidence
In-process CA bundle generation replaces external script execution
The post-install CA bundle builder now constructs the bundle in-process using Rust libraries instead of spawning the external \post-install\ shell script. On macOS, it uses the Security framework to validate keychain certificates, while on all platforms it parses PEM data and checks certificate purposes and expiration times using \x509\_parser\. This change ensures the generated bundle is byte-identical to the script's output but avoids the overhead of hundreds of subprocess calls, significantly reducing build time. The cache key now includes the script's hash to ensure compatibility if the script changes.
_zb\_io/src/installer/post\_install/ca\bundle · high confidence
Post-install steps now run with C locale and build CA bundles in-process
Post-installation steps now execute with the \LC\_ALL=C\ locale to ensure deterministic behavior, particularly for scripts like \ca-certificates\ that rely on glob sorting. Additionally, the installer can now build the CA certificate bundle in-process for known scripts, falling back to the external script only when the in-process builder cannot handle the specific script. Also in this area: Skip keg links that point back into the prefix or sibling kegs; Cache the CA bundle to speed up post-install steps; Formula post-install steps are now executed after installation.
_zb\_io/src/installer/post\install · high confidence
Fixes
Added CA bundle fixtures and post-install build script
The \zb\_io/fixtures/ca-bundle\ directory now includes a collection of PEM certificate fixtures (such as \root-ca.pem\, \expired-ca.pem\, and \eku-client-ca.pem\) and two versions of a \post-install\ shell script. These additions provide the necessary test data and the logic to build a CA bundle from system and Mozilla certificates, supporting the validation of certificate trust chains and expiration handling.
_zb\io/fixtures · high confidence
Installer refactored into submodules with improved bottle handling and state repair
The install logic in \zb\_io/src/installer/install\ has been split into dedicated submodules (\bottle\, \source\, \plan\, \upgrade\, \uninstall\, \post\_install\, \doctor\) to improve maintainability. This change introduces best-effort install planning that skips already-installed dependencies, ensures \etc\ and \var\ files are installed into the prefix, and rewrites Linuxbrew bottle paths. It also adds a \doctor\ diagnostic tool to detect and repair state issues like orphaned cellars, broken symlinks, and misnamed records, while making \zb upgrade\ idempotent and safe against download failures by prefetching bottles before uninstalling the old version.
_zb\io/src/installer/install · high confidence
Test coverage
Added Homebrew API contract tests; Added integration and parity tests for zb\_cli.
Dependencies
Initial dependency configuration for Rust workspace and site build
This change introduces the dependency manifests for the project's Rust workspace (zb\_cli, zb\_core, zb\_io) and the Eleventy-based site build. The Rust workspace sets a Minimum Supported Rust Version (MSRV) of 1.96 and configures core libraries including tokio, serde, clap, reqwest (with rustls TLS backend), and rusqlite. The site configuration adds @11ty/eleventy for static site generation and wrangler for deployment.
(dependencies) · high confidence
Housekeeping
Updated benchmark results for October 2026
Added benchmark logs, JSON data, and Markdown summaries for October 7, 8, and 12, 2026. These files record performance comparisons between Homebrew and zerobrew across 100 packages, capturing metrics such as cold and warm installation times and speedup ratios under varying network bandwidth conditions.
results · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 62 → 68 (+5.6)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 55 → 67 (+12.6)
- Architecture 91 → 91 (+0.0)
- Maturity 64 → 63 (-0.6)
- Readiness 69 → 69 (-0.3)
- Security 65 → 72 (+7.5)
- Performance 100 → 100 (+0.0)
Resolved (22)
- Duplicated block (10 lines × 2) (zb_cli/src/init.rs)
- Duplicated block (10 lines × 2) (zb_io/src/cellar/materialize.rs)
- Duplicated block (6 lines × 2) (zb_io/src/network/tap_formula.rs)
- Duplicated block (6 lines × 7) (zb_io/src/cellar/link.rs)
- Duplicated block (7 lines × 3) (zb_io/src/cellar/link.rs)
- High CVE: [GHSA redacted] (site/pnpm-lock.yaml)
- Hotspot: zb_cli/src/bin/zb.rs (zb_cli/src/bin/zb.rs)
- Medium advisory (unsound): RUSTSEC-2026-0395 (Cargo.lock)
- Medium advisory (unsound): RUSTSEC-2026-0396 (Cargo.lock)
- Medium advisory (unsound): RUSTSEC-2026-0397 (Cargo.lock)
- Medium advisory (unsound): RUSTSEC-2026-0399 (Cargo.lock)
- Medium advisory (unsound): RUSTSEC-2026-0400 (Cargo.lock)
- Medium advisory (unsound): RUSTSEC-2026-0401 (Cargo.lock)
- Medium advisory (unsound): RUSTSEC-2026-0402 (Cargo.lock)
- Medium advisory (unsound): RUSTSEC-2026-0404 (Cargo.lock)
- Medium advisory (unsound): RUSTSEC-2026-0405 (Cargo.lock)
- Medium advisory (unsound): RUSTSEC-2026-0406 (Cargo.lock)
- Medium vulnerability: RUSTSEC-2026-0391 (Cargo.lock)
- Medium vulnerability: RUSTSEC-2026-0398 (Cargo.lock)
- Medium vulnerability: RUSTSEC-2026-0410 (Cargo.lock)
- …and 2 more
New (55)
- Duplicated block (10 lines × 2) (zb_io/src/cellar/materialize.rs)
- Duplicated block (11 lines × 2) (zb_cli/src/init.rs)
- Duplicated block (6 lines × 2) (zb_cli/src/commands/install.rs)
- Duplicated block (6 lines × 2) (zb_io/src/network/api.rs)
- Duplicated block (6 lines × 2) (zb_io/src/network/tap_formula.rs)
- Duplicated block (6 lines × 7) (zb_io/src/cellar/link.rs)
- Duplicated block (60–61 lines × 2) (zb_cli/src/commands/install.rs)
- Duplicated block (7 lines × 3) (zb_io/src/cellar/link.rs)
- Duplicated block (8–9 lines × 2) (zb_io/src/installer/post_install/font_cache.rs)
- Duplicated block (9 lines × 2) (zb_cli/src/commands/install.rs)
- Edited copies of one member (3 members, 11+ corresponding lines) (zb_io/src/cellar/link.rs)
- Edited copies of one member (3 members, 19+ corresponding lines) (zb_io/src/storage/db.rs)
- Edited copy of a member (15 corresponding lines) (zb_io/src/installer/post_install/steps.rs)
- Edited copy of a member (19 corresponding lines) (zb_io/src/network/cache.rs)
- Edited copy of a member (24 corresponding lines) (zb_io/src/network/tap_formula.rs)
- Edited copy of a member (25 corresponding lines) (zb_io/src/installer/post_install/steps.rs)
- Edited copy of a member (27 corresponding lines) (zb_io/src/network/tap_formula.rs)
- Edited copy of a member (4 corresponding lines) (zb_io/src/network/cache.rs)
- Edited copy of a member (56 corresponding lines) (zb_io/src/installer/install/plan.rs)
- Edited copy of a member (7 corresponding lines) (zb_io/src/extraction/patch/macho.rs)
- …and 35 more
Changes since last survey
- 10 commits — 4 feature/other, 6 fixes
By area
- (root) — 3 commits
- zb_io/src — 3 commits
- zb_cli/src — 2 commits
- zb_cli/tests — 1 commit
- zb_core/src — 1 commit
Notable commits
- fix: fix(deps): bump zstd to 0.14.3
- fix: fix(parity): update homebrew once per run and wait on its lock
- fix: fix(shim.rb): fixing failing install due to build class and cd
- fix: fix(zb_cli): include build dependency on install when installing no-bottle formulae
- fix: fix(zb_cli): keep installing the Brewfile when a post-install fails
- fix: fix(zb_io): prune stale font cache keys and clear the cache dir on restore
- change: bundle: record the formula named in the post-install error
- change: docs: changelog for man pages, doctor and zstd
- change: docs: changelog for the fontconfig cache
- change: perf(zb_io): cache fontconfig's fc-cache output between installs
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
lucasgelfond/zerobrew was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 14 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit cb288c08ccfdbfe11c68412207225da2128b4eb4 — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-e1a3b69fc8ee.