Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

ci: nothing in trycua/cua depends on GitHub's repo-wide Latest release (CUA-3552) (#6578)

Francesco Bonaccib4fe9c16a853
diff --git a/.github/scripts/github_release.py b/.github/scripts/github_release.py
index 8f454c351b..9ced0aa719 100644
--- a/.github/scripts/github_release.py
+++ b/.github/scripts/github_release.py
@@ -349,10 +349,6 @@ def finalize_release(
f"release {tag} is already published with different body or prerelease state"
)
verify_published_assets(api, repository, release, asset_dir)
- if make_latest:
- latest = api.get(f"repos/{repository}/releases/latest")
- if int(latest.get("id", -1)) != int(release["id"]):
- raise ReleaseError(f"published release {tag} is not the latest release")
print(f"release {tag} was already published and matches the requested state")
return dict(release)
diff --git a/.github/scripts/tests/test_no_latest_consumers.py b/.github/scripts/tests/test_no_latest_consumers.py
new file mode 100644
index 0000000000..15538f7e9b
--- /dev/null
+++ b/.github/scripts/tests/test_no_latest_consumers.py
@@ -0,0 +1,57 @@
+"""Nothing in trycua/cua may depend on GitHub's repo-wide "Latest" release.
+
+trycua/cua releases many products (cua-spaces, cua-spacesd, cua-driver-rs,
+cua-sdk, lume, ...) from one repository, so "Latest" is whichever shipped last.
+Consumers read an explicit per-product source instead: a baked version
+constant, a release list filtered by tag prefix, or a fixed-tag rolling release
+(`cua-install-latest`, `cua-spaces-latest`) that holds a feed or manifest.
+"Latest" is cosmetic (see test_release_latest_policy for who pins it)."""
+
+import re
+import subprocess
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parents[3]
+THIS = Path(__file__).resolve()
+
+# A lookup of the repo-wide Latest on trycua/cua, however it is spelled.
+CONSUMERS = [
+ re.compile(r"(trycua/cua|GITHUB_REPO\w*|\{repository\}|\{owner\}/\{repo\})[^\n]*releases/latest"),
+ re.compile(r"releases/latest[^\n]*trycua/cua"),
+ re.compile(r"github\.com/trycua/cua/releases/latest"),
+ re.compile(r"gh release view\s*(--|$)"), # no tag: resolves to Latest
+ re.compile(r"gh release download\s*(--|$)"), # no tag: resolves to Latest
+ re.compile(r"\bisLatest\b"),
+]
+
+
+def _files():
+ out = subprocess.run(
+ ["git", "ls-files", "-z"], cwd=REPO_ROOT, check=True, capture_output=True, text=True
+ ).stdout
+ for rel in filter(None, out.split("\0")):
+ path = REPO_ROOT / rel
+ if (
+ path == THIS
+ or rel.startswith((".github/release-backfill/", "blog/", "libs/spaces-sdk-swift/"))
+ or rel.endswith(("CHANGELOG.md", ".lock", ".lockb"))
+ or "/tests/" in rel
+ or not path.is_file()
+ ):
+ continue
+ try:
+ yield rel, path.read_text()
+ except (UnicodeDecodeError, OSError):
+ continue
+
+
+def test_nothing_reads_the_repo_wide_latest_release():
+ bad = []
+ for rel, text in _files():
+ for n, line in enumerate(text.splitlines(), 1):
+ if any(p.search(line) for p in CONSUMERS):
+ bad.append(f"{rel}:{n}: {line.strip()[:120]}")
+ assert not bad, (
+ "these read GitHub's repo-wide Latest release; read a per-product source instead "
+ "(baked version, tag-prefix filtered list, or a fixed-tag feed):\n" + "\n".join(bad)
+ )
diff --git a/.github/workflows/cd-rust-cua-driver.yml b/.github/workflows/cd-rust-cua-driver.yml
index 663e357c11..4e0d4e6dfa 100644
--- a/.github/workflows/cd-rust-cua-driver.yml
+++ b/.github/workflows/cd-rust-cua-driver.yml
@@ -1485,7 +1485,7 @@ jobs:
# canonical one-liners both fetch from
# raw.githubusercontent.com/trycua/cua/main/... so they always
# serve the current installer regardless of release flags
- # (prerelease excludes us from the /releases/latest/ endpoint).
+ # (no installer reads the repo-wide Latest release).
# The tag-pinned asset URLs below are a convenience for users who
# want to audit the exact installer that shipped with a release.
#
diff --git a/.github/workflows/nightly-cua-spaces.yml b/.github/workflows/nightly-cua-spaces.yml
index 0599254f98..1bc7535f51 100644
--- a/.github/workflows/nightly-cua-spaces.yml
+++ b/.github/workflows/nightly-cua-spaces.yml
@@ -382,9 +382,7 @@ jobs:
GH_TOKEN: ${{ github.token }}
run: |
set -euo pipefail
- # Never Latest, always a prerelease.
- latest="$(gh api "repos/$GITHUB_REPOSITORY/releases/latest" --jq .tag_name 2>/dev/null || true)"
- [ "$latest" != "$TAG" ] || { echo "::error::$TAG is the repository's Latest release"; exit 1; }
+ # Always a prerelease. Nothing reads the repo-wide Latest.
[ "$(gh release view "$TAG" --repo "$GITHUB_REPOSITORY" --json isPrerelease --jq .isPrerelease)" = true ] ||
{ echo "::error::$TAG is not a prerelease"; exit 1; }
# Every installer a nightly feed names, and every fixed-name download, resolves.
diff --git a/AGENTS.md b/AGENTS.md
index f2d56c1c85..aad23fb12e 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -198,6 +198,14 @@ version whose tag matches `cua-driver-rs-v*`. Both download assets from the
exact component tag; neither depends on GitHub's repository-wide "Latest"
release.
+Nothing may depend on "Latest" at all (decided 5 Nov 2026). Installers,
+update checks, the download page, docs and CI read an explicit per-product
+source: a release-managed baked version, a release list filtered by the
+product's tag prefix, or a fixed-tag rolling release that holds a feed or
+manifest (`cua-install-latest`, `cua-spaces-latest`). Which release GitHub
+marks Latest is cosmetic, for people browsing the repository.
+`.github/scripts/tests/test_no_latest_consumers.py` fails on any new lookup.
+
Before making a release-status or installation-version claim:
- identify the component's tag prefix and canonical installer entry points;
diff --git a/docs/content/docs/spaces/guides/install.mdx b/docs/content/docs/spaces/guides/install.mdx
index 14ffded425..f943845325 100644
--- a/docs/content/docs/spaces/guides/install.mdx
+++ b/docs/content/docs/spaces/guides/install.mdx
@@ -9,7 +9,7 @@ import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
Cua Spaces runs on macOS, Windows (preview) and Linux. One command installs the
`cua` CLI and the app. The [download page](https://cua.ai/download) has the
app for each system, and every installer is attached to the
-[GitHub releases](https://github.com/trycua/cua/releases).
+[GitHub releases](https://github.com/trycua/cua/releases?q=cua-spaces-v).
| System | Needs |
|---|---|
@@ -91,7 +91,7 @@ turns off what the app set up (see
The download page offers the x64 package. On an arm64 computer, take
`cua-spaces_<version>_arm64.deb` from the
-[GitHub release](https://github.com/trycua/cua/releases) instead: `apt` refuses
+[GitHub release](https://github.com/trycua/cua/releases?q=cua-spaces-v) instead: `apt` refuses
the x64 package there with a list of packages it cannot install. The .deb
installs the app only. To get the `cua` command as well, run
`curl -fsSL https://cua.ai/install.sh | sh -s -- --cli-only`.
diff --git a/libs/lume/scripts/install.sh b/libs/lume/scripts/install.sh
index 4953cf36d5..368a6910bb 100755
--- a/libs/lume/scripts/install.sh
+++ b/libs/lume/scripts/install.sh
@@ -31,7 +31,6 @@ APP_INSTALL_DIR="$HOME/.local/share/lume"
# GitHub info
GITHUB_REPO="trycua/cua"
-LATEST_RELEASE_URL="https://api.github.com/repos/$GITHUB_REPO/releases/latest"
# Option to skip background service setup (default: install it)
INSTALL_BACKGROUND_SERVICE=true