runtime-gate

Runtime gate

Every other gate in this plugin verifies that the process was followed. verify-done.sh checks the branch exists and the test command exited zero. board-doctor checks the board is coherent. ship-gate.sh checks nothing is in flight and no S1/S2 is open. code-reviewer checks the diff reads correctly. A sprint can run green through all four on an app that does not compile in Xcode, does not launch, or launches to a blank screen — because nothing ever ran it.

This is defect-hunting §2 — never certify by reading, execute it — pointed at the app itself.

Run it

sh "${CLAUDE_PLUGIN_ROOT}/scripts/runtime-gate.sh" [--platform ios|android|auto] [--project-root .]

Exit	Meaning	What to do
0	PASS — built and launched	Record the evidence path. Continue.
1	FAIL — does not build, or does not launch	Blocks the row. Re-spawn the developer with the compiler output the gate printed, verbatim.
2	CANNOT EVALUATE — the toolchain is not on this machine	Not a pass. Report it as CANNOT EVALUATE in the standup and in the verdict block.

Exit 2 is the point of the script. A machine without Xcode is a normal state — a CI runner, a Linux box, an Android-only project. It is not an error and it is not a pass. The gate prints what was missing and what would make it evaluable; surface those lines rather than paraphrasing them.

Two traps it already closes, so do not re-open them by hand: command -v xcodebuild succeeds on a Command-Line-Tools-only Mac where every invocation fails, and a build that compiles is not a pass — "BUILDS, but launch UNKNOWN" is exit 2. Timeouts are stated and enforced; a hung simulator produces CANNOT EVALUATE, never an infinite wait.

Escalate past the script when the toolchain allows

The script is the floor — it proves the app starts. On iOS the Axiom toolchain, when installed, gives far more, and you should route to it:

• axiom:simulator-tester — drives the running app, captures screenshots, reads the log for crashes and errors. This is what turns "it launched" into "the journey works".
• axiom:test-runner — runs XCUITests and parses the .xcresult for real failure detail.
• XcodeBuildMCP (the xcodebuildmcp skill) — build, install, launch and UI automation as tools.