Skip to content

Document public packaging installation channels - #1038

Merged
ndizazzo merged 2 commits into
mainfrom
codex/issue-971-packaging-docs
Jul 21, 2026
Merged

Document public packaging installation channels#1038
ndizazzo merged 2 commits into
mainfrom
codex/issue-971-packaging-docs

Conversation

@ndizazzo

@ndizazzo ndizazzo commented Jul 21, 2026

Copy link
Copy Markdown
Collaborator

Closes #971.

  • replaces the nonexistent Homebrew tap with the published release-formula/local-tap flow
  • documents public Ubuntu, Arch, checksum, SBOM, and GHCR locations
  • links the public mesh-packaging repository from the project README
  • dispatches future releases to the canonical mesh-packaging repository

Published availability validated for v0.73.1:

  • Homebrew install/test/style on Apple Silicon
  • CPU deb install and command smoke on Ubuntu 24.04 arm64 and emulated amd64
  • all 47 release assets anonymously reachable with a complete aggregate checksum
  • all 11 immutable and 11 moving GHCR tags anonymously inspectable

Local validation:

  • just test-all completed repository consistency, formatting, Clippy, Rust tests, lint, and typecheck; its UI stage reported three unrelated 5-second app-tabs timeouts (950 passed), while all affected files passed with one worker (148/148)
  • UI production build
  • website production build
  • Playwright smoke: 2 passed, 1 skipped

Summary by CodeRabbit

  • Documentation
    • Added Linux “Native packages and containers” guidance for Ubuntu .deb and Arch .pkg.tar.zst downloads with SHA256 verification, plus OCI image usage and tag details.
    • Updated macOS installation instructions with a versioned Homebrew “release asset” flow for Apple Silicon.
    • Refreshed installation/overview content (including README) to direct users to the packaging repository for formulas, assets, checksums, SBOMs, and OCI images.
  • Installation UI
    • Updated the install-method terminal tabs to default to the curl command and removed the brew option.

@github-actions
github-actions Bot requested a review from i386 July 21, 2026 17:53
@coderabbitai

coderabbitai Bot commented Jul 21, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: fd0fa05c-56b4-47d5-b7a6-d13aaa56622f

📥 Commits

Reviewing files that changed from the base of the PR and between da6099b and 6c2853f.

📒 Files selected for processing (3)
  • .github/workflows/release.yml
  • RELEASE.md
  • website/src/docs/pages/installing-linux.md
🚧 Files skipped from review as they are similar to previous changes (2)
  • website/src/docs/pages/installing-linux.md
  • .github/workflows/release.yml

📝 Walkthrough

Walkthrough

Release packaging dispatches now target mesh-packaging. README and website installation guidance describe its versioned artifacts, while platform instructions cover Linux packages, OCI images, and macOS formulas. The terminal install UI defaults to curl and removes the brew option.

Changes

Packaging distribution alignment

Layer / File(s) Summary
Release dispatch routing
.github/workflows/release.yml, RELEASE.md
The release workflow and release documentation now identify Mesh-LLM/mesh-packaging as the packaging dispatch target and GHCR producer while retaining the legacy token name.
Distribution source guidance
README.md, website/src/docs/pages/installing-mesh.md
Documentation identifies mesh-packaging as the source for formulas, packages, checksums, SBOMs, and OCI images.
Platform installation instructions
website/src/docs/pages/installing-linux.md, website/src/docs/pages/installing-macos.md
Linux and macOS guides document versioned package and formula installation flows, verification, container tags, and platform limitations.
Terminal install method UI
website/src/_includes/components/cta-terminal.njk
The terminal component defaults to curl and removes the brew tab and template.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

Suggested reviewers: i386, ivgolovach, michaelneale

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title succinctly reflects the main change: documenting public packaging installation channels.
Linked Issues check ✅ Passed The PR replaces the broken Homebrew tap command with the published release-formula/local-tap flow required by #971.
Out of Scope Changes check ✅ Passed The changes stay aligned with packaging/install documentation and release dispatch updates, with no clear unrelated additions.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/issue-971-packaging-docs

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
.github/workflows/release.yml (1)

1458-1464: 🗄️ Data Integrity & Integration | 🟠 Major | ⚡ Quick win

Update the dispatch token contract for mesh-packaging. MESH_AGENT_IMAGES_DISPATCH_TOKEN and RELEASE.md still describe access to Mesh-LLM/mesh-agent-images, but this workflow now dispatches to Mesh-LLM/mesh-packaging. Re-scope the token or rename/update the secret and docs so the dispatch can succeed.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.github/workflows/release.yml around lines 1458 - 1464, Update the
cross-repository dispatch contract in the release workflow so the token
configuration, validation message, and related RELEASE.md documentation
consistently target Mesh-LLM/mesh-packaging instead of
Mesh-LLM/mesh-agent-images. Preserve the existing GH_TOKEN usage and dispatch
behavior while renaming or re-scoping the secret as needed.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@website/src/docs/pages/installing-linux.md`:
- Around line 25-30: Add concise Ubuntu and Arch command examples to the
native-package section, covering release-asset selection/download, fetching the
matching .sha256 sidecar, verifying with sha256sum --check, and installing the
local .deb or .pkg.tar.zst via apt install or pacman -U. Use placeholders or
clearly indicate that users must substitute the asset URL matching their distro,
architecture, and backend suffix, while preserving the existing release-assets
workflow.

---

Outside diff comments:
In @.github/workflows/release.yml:
- Around line 1458-1464: Update the cross-repository dispatch contract in the
release workflow so the token configuration, validation message, and related
RELEASE.md documentation consistently target Mesh-LLM/mesh-packaging instead of
Mesh-LLM/mesh-agent-images. Preserve the existing GH_TOKEN usage and dispatch
behavior while renaming or re-scoping the secret as needed.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 74c7137e-c1e5-4bf0-8a32-cc014f26127d

📥 Commits

Reviewing files that changed from the base of the PR and between ac0ea92 and da6099b.

📒 Files selected for processing (6)
  • .github/workflows/release.yml
  • README.md
  • website/src/_includes/components/cta-terminal.njk
  • website/src/docs/pages/installing-linux.md
  • website/src/docs/pages/installing-macos.md
  • website/src/docs/pages/installing-mesh.md
💤 Files with no reviewable changes (1)
  • website/src/_includes/components/cta-terminal.njk

Comment thread website/src/docs/pages/installing-linux.md
@ndizazzo

Copy link
Copy Markdown
Collaborator Author

Addressed CodeRabbit’s outside-diff dispatch-contract finding in 6c2853f. RELEASE.md and the workflow diagnostic now target Mesh-LLM/mesh-packaging. The legacy MESH_AGENT_IMAGES_DISPATCH_TOKEN lookup name is intentionally retained for existing organization-secret compatibility, but its documented and enforced scope is Contents write on Mesh-LLM/mesh-packaging; GH_TOKEN, payload, and dispatch behavior are unchanged.

@ndizazzo
ndizazzo merged commit a6c7ddb into main Jul 21, 2026
18 checks passed
@ndizazzo
ndizazzo deleted the codex/issue-971-packaging-docs branch July 21, 2026 18:04
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.

There is no homebrew tap repo

1 participant