docs(site): install the current release from the public channel - #19
Merged
Merged
Conversation
❌ Deploy Preview for clinquant-croquembouche-2fa149 failed.
|
The installation page advertised terraphim-ai GitHub assets pinned at 1.20.5,
a Homebrew formula that does not exist, and a Cargo package name that is not
published. Following any of them failed.
* quick install, Homebrew and Cargo commands corrected; the tap carries
terraphim-agent and terraphim-grep, so the fabricated terraphim-ai formula
is gone
* per-platform download links point at downloads.terraphim.ai and carry the
version, matching how the release is actually published
* versions advanced from 1.20.5/1.21.9 to 1.21.16, including config.toml so
the homepage version selector and release links agree
* server and library bindings moved to their own section, since they are not
published through the client installer
* troubleshooting documents the installer's exit codes, including the
checksum-mismatch code, and no longer suggests skip-verify as a remedy
Verified: zola build succeeds; all seven generated download URLs match the live
stable-v2.json manifest; no stale brew or cargo command remains in content/ or
themes/.
The site is served from Cloudflare Pages (deploy.yml), but pull requests were still judged by a Netlify integration that reports failure on every commit, including already-merged PRs #15 and #18. Those four checks were the only checks on PR #19, so every pull request looked broken. Changes: - validate.yml: a pull-request gate that builds the site with the same pinned Zola, verifies the build produced pages, and checks the release channel. - check-release-links.py: confirms the version the site advertises is the version downloads.terraphim.ai serves, and that every asset the site links to resolves with a non-trivial size. - deploy.yml: pin the Zola download with --fail, serialise production deploys with a concurrency group, and verify the deployed site actually serves the release version committed to the repository before the job reports success. Verified locally: `zola build` produces 272 HTML pages; the channel checker fails on current main (advertises 1.20.5, channel serves 1.21.16) and passes on the docs/install-current-release content (1.21.16, all targets resolve).
AlexMikhalev
force-pushed
the
docs/install-current-release
branch
from
September 27, 2026 13:34
5efddea to
18f63cc
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
Every documented install path on the site was wrong. The installation page
advertised GitHub assets pinned at 1.20.5, a
terraphim-aiHomebrew formulathat does not exist in the tap, and
cargo install terraphim-cli, a packagename that is not published. The releases page still announced v1.21.9, and the
homepage's version selector defaulted to 1.20.5, so all seven of its generated
download links 404'd.
Change
terraphim-agentandterraphim-grep; the fabricatedterraphim-aiformulais gone from every page
downloads.terraphim.aiand carry theversion, matching how the release is actually published
content/,themes/WarpDrive/templates/index.htmlandconfig.toml, so the homepageversion selector, the release-tag links and the download links agree
terraphim-clients, the repository that publishesthese binaries
not published through the client installer
checksum-mismatch code, and no longer suggests
--skip-verifyas a remedyTest evidence
zola buildsucceeds (44 pages, 4 sections), and the seven download URLs thehomepage generates were compared against the live manifest:
No stale brew or cargo command remains anywhere in
content/orthemes/.Depends on
Purely documentation. The quick-install command it advertises starts resolving
the current release once terraphim/terraphim-ai#964 is merged.