Skip to content

docs(release): fleet-internal bless = Gitea private cargo (#3184) - #958

Open
AlexMikhalev wants to merge 1 commit into
mainfrom
task/3184-rg-release-channels-doc
Open

docs(release): fleet-internal bless = Gitea private cargo (#3184)#958
AlexMikhalev wants to merge 1 commit into
mainfrom
task/3184-rg-release-channels-doc

Conversation

@AlexMikhalev

Copy link
Copy Markdown
Contributor

Summary

Documents fleet-internal release channel policy so agents stop treating crates.io / GitHub tags as canonical for terraphim_grep / terraphim_agent.

Gitea issue: https://git.terraphim.cloud/terraphim/terraphim-ai/issues/3184
Parent ops (publish catch-up): https://git.terraphim.cloud/terraphim/terraphim-ai/issues/3183
Driver: release-guardian → ADF docs slice (docs-only PR; monorepo cargo gates abandoned)

Changes

  • NEW docs/src/release-channels.md
  • docs/src/SUMMARY.md entry
  • README note under Direct Download
  • Design gate: docs/plans/design-rg-release-channels-doc-2026-08-08.md

Policy (short)

Rank Channel Role
1 Gitea cargo owner=terraphim Canonical fleet bless (1.21.1)
2 crates.io Public mirror (may lag)
3 GitHub Releases Public binaries (may lag)

Lag on public channels = CONDITIONAL, not fleet failure.

Out of scope

  • Publishing crates.io / GH assets (#3183)
  • Dependency / toolchain / Cargo.lock edits

Test plan

  • Docs-only diff (4 files, +162)
  • No Cargo.lock / crate toml in PR
  • Human skim release-channels.md
  • Merge when happy

Closes the in-repo slice of channel skew (Gitea #3184 / parent #3183 ops).

- docs/src/release-channels.md: canonical channel precedence, blessed
  1.21.1, cargo API shape (array, no .latest), CONDITIONAL lag policy,
  temp-root path install smoke from terraphim-clients
- SUMMARY.md + README Installation Methods link
- design gate artifact under docs/plans/

Docs only — no Cargo.lock / dependency changes.
@github-actions

github-actions Bot commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

Documentation Preview

Your documentation changes have been deployed to:
https://dac8f2fe.terraphim-docs.pages.dev

This preview will be available until the PR is closed.

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.

1 participant