Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
4749903
ci: smoke the gateway /healthz probe on Intel Mac
cursoragent Oct 16, 2026
b011f79
ci: probe the Intel gateway binary the job just built
cursoragent Oct 16, 2026
18a2a66
ci: bind the Intel /healthz smoke to the process it starts
cursoragent Oct 16, 2026
f770a05
fix: make the Intel /healthz smoke match the owner check
cursoragent Oct 17, 2026
a366166
fix: prove contract readiness at localhost:8090 in the Intel smoke
claude Oct 17, 2026
028c613
Merge cursor/launcher-contract-1297 into cursor/intel-mac-gateway-smo…
claude Oct 17, 2026
3ab6cb8
Merge cursor/launcher-contract-1297 into cursor/intel-mac-gateway-smo…
claude Oct 17, 2026
0c8d6c7
test: run the gateway smoke stub on macOS
claude Oct 17, 2026
02dcf5b
ci: run the gateway smoke tests on the Intel Mac runner
claude Oct 17, 2026
c381255
test: give the gateway smoke cleanup tests time to fork
claude Oct 17, 2026
3cffaad
docs: state that the Intel smoke gateway listens on every localhost a…
claude Oct 17, 2026
ed21329
Merge cursor/launcher-contract-1297 into cursor/intel-mac-gateway-smo…
claude Oct 17, 2026
12fc78b
Merge cursor/launcher-contract-1297 into cursor/intel-mac-gateway-smo…
claude Oct 17, 2026
0bf525a
Merge cursor/launcher-contract-1297 into cursor/intel-mac-gateway-smo…
claude Oct 18, 2026
630efc6
test: keep the default-command smoke test off the real port 8090
claude Oct 18, 2026
ac97a4a
docs: say the smoke checks that the gateway pid holds the host lock
claude Oct 18, 2026
914acb9
test: end every gateway smoke test on an event, not a 3 s deadline
claude Oct 18, 2026
e50fe79
Merge cursor/launcher-contract-1297 into cursor/intel-mac-gateway-smo…
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
52 changes: 52 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -1557,6 +1557,58 @@ jobs:
retention-days: 7
if-no-files-found: ignore

# Native Intel Mac proof of gateway readiness as docs/LAUNCHER_CONTRACT.md
# defines it: `elastos gateway --addr localhost:8090`, then
# GET http://localhost:8090/healthz returns HTTP 200 and OK while that pid
# holds host-process.lock. The Home is empty. This is not a signed release.
gateway-smoke-macos-intel:
name: gateway-smoke-macos-intel
runs-on: macos-15-intel
timeout-minutes: 90
needs: source-gate
env:
CARGO_BUILD_JOBS: "2"
steps:
- uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09 # v5
with:
ref: ${{ github.event_name == 'workflow_dispatch' && inputs.ref || github.sha }}
- uses: dtolnay/rust-toolchain@72504271e02fb719eb4eb3eaece3a8e3d06f57c0 # 1.91.0
- name: require an Intel Mac with room to compile
run: |
set -euo pipefail
[[ "$RUNNER_OS/$RUNNER_ARCH" == macOS/X64 ]]
df -Pk .
df -Pk . | awk 'NR == 2 { if ($4 < 8 * 1024 * 1024) { print "Intel runner has under 8 GiB free"; exit 1 } }'
# source-gate runs these tests on Linux. Run them here on macOS too,
# where the lock path, lsof and localhost order differ.
- name: smoke script tests on macOS
timeout-minutes: 5
run: python3 scripts/gateway-healthz-smoke-test.py -v
- name: build the gateway binary
timeout-minutes: 70
run: |
set -euo pipefail
# GITHUB_ENV applies on the next step. Export it here so this build
# writes the binary the /healthz probe executes.
export CARGO_TARGET_DIR="$RUNNER_TEMP/gateway-intel-target"
echo "CARGO_TARGET_DIR=$CARGO_TARGET_DIR" >> "$GITHUB_ENV"
cargo build --locked --release --manifest-path elastos/Cargo.toml -p elastos-server --bin elastos
test -x "$CARGO_TARGET_DIR/release/elastos"
- name: gateway is ready at localhost:8090 with an empty Home
timeout-minutes: 10
run: |
set -euo pipefail
export ELASTOS_GATEWAY_LOG="$RUNNER_TEMP/gateway.log"
scripts/gateway-healthz-smoke.sh "$CARGO_TARGET_DIR/release/elastos"
- name: upload gateway log
if: failure()
uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
with:
name: gateway-smoke-macos-intel-log
path: ${{ runner.temp }}/gateway.log
retention-days: 7
if-no-files-found: ignore

# A pull request run stops at its first failed job, so the macOS and Linux
# journeys do not run on for 30+ minutes after a decisive failure. Pushes,
# merge queues and dispatches keep running every job to the end. This job
Expand Down
34 changes: 34 additions & 0 deletions docs/MAC.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,40 @@ The public installer looks up Apple silicon (`aarch64-darwin`) releases. This
runbook is the source-home staging path for local Mac verification, Browser VM
artifacts, and `.dmg` packaging work.

## Intel Mac

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.

CI job `gateway-smoke-macos-intel` builds the native `elastos` binary on
`macos-15-intel`. It runs `scripts/gateway-healthz-smoke.sh`, which starts the
command in [the launcher contract](LAUNCHER_CONTRACT.md) and requires the
readiness that contract defines. The probe uses `http://localhost:8090/healthz`
and passes only when all of these are true:

- the answer is HTTP 200 with the two bytes `OK`, without a proxy,
- the address that answered is a listen socket of the gateway process,
- `host-process.lock` names that process, a gateway role and `localhost:8090`.

The job uses an empty Home. A pass does not prove providers, capsules,
sign-in, or a signed install. `elastos serve` reports operator status at
`GET /api/health`.

For `--addr localhost:8090` the gateway listens on every loopback address that
[the launcher contract](LAUNCHER_CONTRACT.md) names for `localhost`. After the
readiness check, the job log prints facts, not pass or fail: the `localhost`
lookup order, the addresses the gateway listens on, and what `GET /healthz`
returns at `localhost:8090`, `127.0.0.1:8090` and `[::1]:8090`.

This runbook claims no local Intel Browser engine. See
[Browser support](BROWSER_SUPPORT.md). The job uploads no release tarball.

## From Fresh Mac To Home

Install the host tools first:
Expand Down
15 changes: 15 additions & 0 deletions scripts/ci-release-policy-test.py
Original file line number Diff line number Diff line change
Expand Up @@ -1643,6 +1643,18 @@ def test_restored_inputs_are_verified_before_use(self):
with self.subTest(mutation=name), self.assertRaises(AssertionError):
validate_restores_are_verified(changed)

def test_intel_gateway_smoke_probes_the_binary_it_built(self):
build, = [step for step in steps("gateway-smoke-macos-intel")
if step.startswith("name: build the gateway binary\n")]
probe, = [step for step in steps("gateway-smoke-macos-intel")
if "scripts/gateway-healthz-smoke.sh" in step]
self.assertLess(build.index('export CARGO_TARGET_DIR="$RUNNER_TEMP/gateway-intel-target"'),
build.index("cargo build --locked --release"))
self.assertIn('test -x "$CARGO_TARGET_DIR/release/elastos"', build)
self.assertIn('scripts/gateway-healthz-smoke.sh "$CARGO_TARGET_DIR/release/elastos"', probe)
# The probe keeps the contract address localhost:8090 (the script default).
self.assertNotIn("ELASTOS_GATEWAY_ADDR", probe)

def test_github_runners_and_check_names_stay_fixed(self):
expected = {
"source-gate": ("source-gate", "ubuntu-24.04"),
Expand All @@ -1658,6 +1670,9 @@ def test_github_runners_and_check_names_stay_fixed(self):
"source-home-linux": ("source-home-linux (${{ matrix.os }})", "${{ matrix.os }}"),
"source-home-linux-arm64": ("source-home-linux (${{ matrix.check_name || matrix.os }})", "${{ matrix.os }}"),
"source-home-macos": ("source-home-macos", "macos-14"),
# Intel gateway /healthz smoke. Signed x86_64-darwin admission is
# still the signer and installer gate in docs/MAC.md.
"gateway-smoke-macos-intel": ("gateway-smoke-macos-intel", "macos-15-intel"),
"cancel-on-failure": ("cancel-on-failure", "ubuntu-24.04"),
# Anders decides whether this becomes a required check (#320).
"update-hop-linux": ("update-hop-linux", "ubuntu-24.04"),
Expand Down
Loading
Loading