Eve library

The Rail native launch verification

Other

Revision 1

On this page

Run pnpm verify:launch from apps/v10/shell. The command builds the native binary, starts it, and fails if the process exits early or a machine-checkable native behavior does not reconcile.

On macOS, the gate drives the production Rail and tray menus through System Events. It proves that:

  • the release binary starts and exposes one main window;
  • Dock Left and Dock Right move that window to opposite sides of the work area;
  • Keep on Top changes its real checked-menu state;
  • closing the window leaves the process alive; and
  • the Show Panel tray action restores the same window.

The invoking terminal needs macOS Accessibility permission for System Events. The script never enables autostart and restores Keep on Top to its starting value before it exits. --skip-build reruns the probe against the existing binary.

On Linux, the same command builds the custom-protocol binary and runs it for ten seconds inside an isolated D-Bus/Xvfb session. It also validates the complete versioned window-state.json written during setup. This headless path verifies native process startup, webview creation, tray initialization, and persistence; it does not claim macOS UI behavior.

What still needs eyes on a Mac#

Automation can read positions, process liveness, menu checkmarks, and window visibility. A release reviewer should still look at these presentation details:

  1. In both light and dark menu bars, confirm the template tray icon is legible, correctly sized, and not clipped.
  2. Confirm the narrow panel is visually flush with each screen edge and does not overlap the menu bar or Dock on every attached display.
  3. Put another application over The Rail and visually confirm Keep on Top changes the stacking behavior, including after switching Spaces.
  4. Open the tray menu and confirm its labels, separators, disabled glance rows, and checkmarks are readable at the active display scale.
  5. Close and restore the panel once, then confirm the rendered Rail session is unchanged and still interactive.

Record the macOS version, display arrangement/scales, light/dark appearance, command output, and any visual defects in the release evidence for the tested build. These checks are intentionally documented as human observations rather than represented as automated success.