Skip to content

The cross-harness, self-improving memory layer for AI agents. Join our community: https://discord.com/invite/zdNChS2fBu

Clarify Homebrew vector mirror release contract

Justin D'Souzaa573a9e2f367
diff --git a/cli/beacon/.goreleaser.yaml b/cli/beacon/.goreleaser.yaml
index 24955f88..bc2552f3 100644
--- a/cli/beacon/.goreleaser.yaml
+++ b/cli/beacon/.goreleaser.yaml
@@ -237,9 +237,10 @@ brews:
# which Homebrew never links into the prefix -- so it cannot collide on a bin/vector
# symlink either. FindVector looks there first; see internal/endpoint/asymptote.
#
- # os: mac because the mirror only carries Vector's macOS tarballs; renders as
- # `depends_on "..." if OS.mac?`. Homebrew-on-Linux installs Beacon with no
- # dependency and uses the vector.dev package, as the docs say.
+ # os: mac because Beacon only bundles the tap's Vector mirror for macOS.
+ # Homebrew-on-Linux installs Beacon with no dependency and uses the vector.dev
+ # package, as the docs say. The mirror formula itself still carries Linux URLs
+ # so Homebrew's cross-platform tap validation can load it.
dependencies:
- name: asymptote-labs/tap/beacon-vector
os: mac
diff --git a/cli/beacon/goreleaser_brew_test.go b/cli/beacon/goreleaser_brew_test.go
index 7b5ffd06..33568726 100644
--- a/cli/beacon/goreleaser_brew_test.go
+++ b/cli/beacon/goreleaser_brew_test.go
@@ -70,9 +70,10 @@ func TestHomebrewFormulaNeverDependsOnAFormulaNamedVector(t *testing.T) {
// nothing else finds it. Renaming the formula on either side alone leaves `brew install
// beacon` installing a Vector that `beacon endpoint connect` cannot see.
//
-// The dependency is macOS-only because the mirror only carries Vector's macOS tarballs.
-// Dropping that guard would break Homebrew-on-Linux installs of Beacon outright, which is
-// how the tap's macOS-only vector.rb behaved before the rename.
+// The dependency is macOS-only because Beacon bundles the tap's Vector mirror only on
+// macOS. Homebrew-on-Linux installs Beacon without a Vector dependency and uses the
+// vector.dev package path documented for Linux instead. The mirror formula itself still
+// carries Linux URLs so Homebrew's cross-platform tap validation can load it.
func TestHomebrewFormulaDependsOnTheVectorMirrorFindVectorLooksFor(t *testing.T) {
want := "asymptote-labs/tap/" + asymptote.TapVectorFormula
for _, brew := range loadBrewConfig(t).Brews {
@@ -86,9 +87,10 @@ func TestHomebrewFormulaDependsOnTheVectorMirrorFindVectorLooksFor(t *testing.T)
}
found = true
if dep.OS != "mac" {
- t.Errorf("brew %q depends on %q with os %q, want %q: the mirror carries only "+
- "Vector's macOS tarballs, so an unguarded dependency breaks Homebrew-on-Linux "+
- "installs of Beacon", brew.Name, dep.Name, dep.OS, "mac")
+ t.Errorf("brew %q depends on %q with os %q, want %q: Beacon bundles the "+
+ "tap's Vector mirror only on macOS; Homebrew-on-Linux installs Beacon "+
+ "without a Vector dependency and uses the vector.dev package path instead",
+ brew.Name, dep.Name, dep.OS, "mac")
}
}
if !found {