slosh.git/contrib/macos-remote-build, branch master

build: a vendor bump rebuilds libghostty-vt, everywhere it is consumed

2026-09-10T09:19:54Z

Three stale-build landmines, all found by shipping v0.1.7 -- the first release where new code (GhosttySearch) actually needed the vendor bump of 2026-09-01: - $(VT_LIB) had no prerequisites, so an existing .a *was* the build: the macOS builder compiled pane.c against zig-out headers from before the bump. The vendor manifest is now the prerequisite; a re-vendor rewrites it, so a bump rebuilds the lib and its installed headers. - web/demo had the same guard and also never passed -Dversion-string: upstream's build.zig ran git describe in our repo, and on the tag checkout web/publish builds from, a slosh tag is a fatal version mismatch. Both fixed; both had hidden behind a stale build/vt. - The builder's zig-pkg (excluded from the sync, and left half-empty by a once-interrupted push) is an input, not a cache: it is now synced separately and additively, so a bump's new packages arrive and a partial local tree cannot maim the builder's copy.

macos-remote-build: a synced tree must not read as dirty

2026-08-27T14:40:08Z

web/ and tests/fuzz/ are excluded from the sync (hundreds of megabytes, none of it an input to 'make all') but both are tracked, and .git goes over whole -- so the moment a commit touched web/, the builder's stale copy read as a local edit and git describe stamped a clean release tree -dirty. slosh-0.1.1-dirty-macos-arm64.zip was signed, notarized and correctly labelled as a tree nobody had: the exclusion's debris, not the release. After the rsync, restore the excluded tracked paths from the .git that just went over: no network, no bandwidth lost to the exclusion, and a tree that is really dirty still says so.

macos-remote-build: tolerate notarization ticket propagation lag

2026-08-27T12:43:02Z

The post-notarization Gatekeeper check ran spctl exactly once, immediately. A bare CLI binary cannot be stapled (stapler only takes .pkg/.dmg/.app), so there is nothing on disk to carry the ticket and Gatekeeper must fetch it online from Apple's CloudKit -- which lags the notary's own 'Accepted' by seconds to a couple of minutes. The single check raced that propagation and failed the whole release with 'Unnotarized Developer ID' for a build Apple had already accepted (status: Accepted), taking the good linux tarballs and the SHA256SUMS down with it. Poll spctl instead: pass the instant the ticket appears, and if it still has not after ~2 min, report it as pending and let the release stand -- the notary verdict is authoritative and codesign already vouched for the signature. Any other rejection still fails hard, so a real signing problem is still caught. The accepted vs pending states are told apart by 'Notarized' vs 'Unnotarized' so there is no false positive.

macos-remote-build: stop rsyncing 850M of caches to the builder

2026-08-26T22:21:01Z

The working-tree sync excluded two of the three gitignored vendor/libghostty-vt zig caches but not zig-pkg/ (354M), so every run silently re-pushed it. With rsync -a and no progress output that looked like a hang on the rsync step. Add the missing zig-pkg/ exclude (keeping the list in step with .gitignore), plus web/ (~430M landing page/demo) and tests/fuzz/ (~120M corpus), neither of which is an input to `make all` -- all the builder runs. Cuts the sync from ~1.2G/48k files to 350M/9.6k. Only affects the default working-tree mode; REF= builds check out on the builder via git and were unaffected.

macos: the pipeline is the project's, the identity is yours

2026-08-26T22:08:52Z

Makefile.macos was kept out of git because it named a team, a person and a mac. But almost all of it is mechanism -- build, sign, zip, notarize, staple, unlock a headless keychain -- and that is the project's, not the releaser's. Keeping the whole file out to protect four values meant the one machine that had it was the only place a release could be cut from, and that nobody could read how signing worked without being handed it. So the split is inverted. Makefile.macos, the builder doc and the scripts are tracked; macos-release.mk holds TEAM_ID, SIGNER and BUILDER and is the only thing gitignored. macos-release.mk.example is the template. The identity strings are now assembled from SIGNER and TEAM_ID rather than written out, which means an unconfigured checkout composes "Developer ID Application: ()" -- plausible, wrong, and diagnosed only by codesign a minute into a build. require-identity and require-builder catch it before anything runs and name the file to create; `help` prints "(unset)" rather than the empty shape. macos-remote-build now pushes macos-release.mk instead of Makefile.macos. That is the better arrangement anyway: the builder gets its pipeline from git at the commit being released, so a release is signed by the flow belonging to it and not by whatever the laptop was carrying. MACOS-BUILDER.md was in the same position -- local, and referenced by a file that is now tracked -- so it becomes docs/macos-release.md with the certificate name and notary key id replaced by their shapes.

macos: sign and notarize on a mac that is not this one

2026-08-26T21:30:58Z

An unsigned mac binary is "damaged and can't be opened", so a release has to be signed with a Developer ID and notarized by Apple, and that needs a mac holding a private key. That mac is not the machine you develop on -- under `make all` it never is -- so `make macos-dist` builds nothing here: it syncs the tree to the builder over ssh, has it build, sign, notarize and staple, verifies the result there and fetches the zip back. The near end needs only ssh, rsync and a hasher, so it works from Linux. contrib/macos-builder-setup turns a bare mac into that builder and is re-runnable, with --check to say what is missing. The two things that make an unattended builder different from a laptop are handled rather than worked around: a keychain of its own, unlocked from a 0600 password file because a headless mac has no unlocked login keychain and codesign dies with "User interaction is not allowed"; and exactly one copy of the identity in the search list, because two make codesign ambiguous. No identity is in the repo. Who signs, which team, which mac -- that is Makefile.macos, which stays out of git along with dist/, and macos-dist tells you so when it is not there.