Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
027aa6c
fix: store the CID of the verified release head
cursoragent Oct 16, 2026
58a76ac
fix: stop an Intel Mac before release lookup
cursoragent Oct 16, 2026
8e3c774
fix: leave an empty release-head stamp empty
cursoragent Oct 16, 2026
4958501
Merge cursor/intel-package-name-1297 into cursor/intel-install-gate-1297
claude Oct 17, 2026
343da76
test: check the Intel Mac installer stop text in the smoke contract test
claude Oct 17, 2026
75175f9
Merge cursor/intel-package-name-1297 into cursor/intel-install-gate-1297
claude Oct 17, 2026
20944a0
fix: tell an Intel Mac user plainly that it is not supported yet
claude Oct 17, 2026
b60b6f0
Merge cursor/intel-package-name-1297 into cursor/intel-install-gate-1297
claude Oct 17, 2026
b1ff58c
fix: stop an Intel Mac with only "Intel Mac is not supported yet."
claude Oct 17, 2026
88ec250
fix: install the Apple silicon build from a Rosetta Terminal
claude Oct 17, 2026
51404a7
fix: use only the release bytes the installer checked
claude Oct 17, 2026
29733e7
Merge cursor/intel-package-name-1297 into cursor/intel-install-gate-1297
claude Oct 17, 2026
f8defe8
Make the swapped-Runtime test swap the real download on macOS too
claude Oct 17, 2026
112e168
fix: run the staged Runtime from one held file, not by path
claude Oct 17, 2026
32f4abf
Merge cursor/intel-package-name-1297 into cursor/intel-install-gate-1297
claude Oct 17, 2026
9c7ebae
Merge cursor/intel-package-name-1297 into cursor/intel-install-gate-1297
claude Oct 18, 2026
da63c23
test: mock GNU mktemp in the Linux case of the swapped-Runtime test
claude Oct 18, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/LAUNCHER_CONTRACT.md
Original file line number Diff line number Diff line change
Expand Up @@ -140,7 +140,7 @@ the installed path. On Linux that running path then ends in ` (deleted)`.
| Code | Meaning |
| --- | --- |
| 0 | The command finished. |
| 1 | The command failed. A second host for the same data directory is one case. |
| 1 | The command failed. A second host for the same data directory is one case. An installer stamp that differs from the verified release head is another. |
| 2 | The `elastos` command line is invalid. |
| 75 | The running gateway's binary watch exited. |

Expand Down
23 changes: 16 additions & 7 deletions docs/MAC.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,13 +10,22 @@ This section is the one record of Intel Mac support. Other documents link
here instead of repeating it.

The public release id for an Intel Mac is `x86_64-darwin`. `scripts/install.sh`
stops on that host before a download lookup. The message is
`macOS release lookup requires Apple silicon`.

A person with an Intel Mac has no signed download. The next step is the signed
installer on an Apple silicon Mac. The source-home commands later in this
runbook are a developer build. They are not the installer, and this note does
not claim that build has passed on Intel.
stops on that host before it downloads anything, and exits with code 1. The
message is `INTEL_MAC_UNSUPPORTED` in that script:
`Intel Mac is not supported yet.`

There is no signed download and no other install path for an Intel Mac. The
source-home commands later in this runbook are a developer build for Apple
silicon. They are not an install path for an Intel Mac, and this note does not
claim that build works on Intel.

A Terminal that runs under Rosetta on an Apple silicon Mac also reports
`uname -m` as `x86_64`. The installer then asks the kernel:
`sysctl -in sysctl.proc_translated` or `sysctl -in hw.optional.arm64` must
print `1`. If one does, it installs the signed `aarch64-darwin` build. That
build has only arm64 code, so macOS runs it natively, also when a Rosetta shell
starts it. If neither prints `1`, or `sysctl` is missing or fails, the
installer cannot prove Apple silicon and stops with the Intel Mac message.

These files hold the rules:

Expand Down
20 changes: 18 additions & 2 deletions scripts/gateway-healthz-smoke-test.py
Original file line number Diff line number Diff line change
Expand Up @@ -477,8 +477,24 @@ def test_contract_names_the_command_and_url_this_smoke_uses(self):
self.assertIn("ELASTOS_GATEWAY_ADDR-localhost:8090", smoke)
mac = (ROOT / "docs/MAC.md").read_text()
install = (ROOT / "scripts/install.sh").read_text()
self.assertIn('die "macOS release lookup requires Apple silicon"', install)
self.assertIn("macOS release lookup requires Apple silicon", mac)
# This smoke is no Intel download. install.sh stops an Intel Mac in
# detect_platform before release lookup, and MAC.md quotes that stop.
message = "Intel Mac is not supported yet."
self.assertIn(f'INTEL_MAC_UNSUPPORTED="{message}"', install)
self.assertIn('[[ "$ARCH" == aarch64 ]] || die "$INTEL_MAC_UNSUPPORTED"', install)
self.assertEqual(install.count(message), 1)
main = install.split("# ── Main", 1)[1]
self.assertLess(main.index("detect_platform"), main.index("fetch_url"))
self.assertLess(main.index("detect_platform"), main.index("release-head.json"))
self.assertIn(f"`{message}`", mac)
# The stop names no developer build as a way to install.
self.assertNotIn("source-home", message)
for retired in ["macOS release lookup requires Apple silicon",
"This Mac has an Intel processor",
"ElastOS supports Macs with Apple silicon",
"Intel Mac has no signed release yet",
"Use the source-home path in docs/MAC.md"]:
self.assertNotIn(retired, install + mac)


if __name__ == "__main__":
Expand Down
Loading
Loading