A1: macOS readiness: setup guide, cargo xtask mac-report, unix/macOS fixes

- docs/macos.md: step-by-step setup for a fresh Apple Silicon Mac (Xcode
  CLT, Homebrew, git, PHP, Composer, Node 22, pnpm, rustup, clone from
  Forgejo), the machine report, Gatekeeper notes, macOS differences and
  what Windows cannot check.
- cargo xtask mac-report: versions, the gate steps, the bundled-UI desktop
  build and a self-check over the control channel (project, file,
  Phpactor, hover, git.status, terminal, screenshot, quit); every step
  times out and runs in a lutra_proc group; one report.md to send back.
- Fixes: macOS native menu (system menus only; Cmd+W stays buffer.close,
  Cmd+Q runs app.quit), xcap screenshot region in points on macOS
  (Retina), login shell (-l, /bin/zsh fallback) and LANG for the
  terminal on macOS, PHP lookup in Homebrew/MacPorts dirs for Finder
  starts, case-insensitive LSP path mapping on macOS, rendezvous file
  mode re-set to 0600, CLI-started desktop in its own process group.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
danny 2026-10-31 14:47:45 +01:00
parent da58c83158
commit 1bf69ded55
18 changed files with 1795 additions and 36 deletions

View file

@ -8,13 +8,15 @@ mod cleanroom;
mod layers;
mod licences;
mod lints;
mod macreport;
mod tasks;
mod util;
use std::process::ExitCode;
/// Usage text printed for `help` and unknown subcommands.
const USAGE: &str = "usage: cargo xtask <command>
const USAGE: &str = concat!(
"usage: cargo xtask <command>
commands:
ci [--skip-ui] the full quality gate (run before every commit)
@ -24,7 +26,12 @@ commands:
ui-licences check the licences of the frontend's production dependencies
lints-selftest prove that shipped unwrap() fails clippy and test unwrap() passes
dev [-- ARGS] run the desktop app in development mode, ARGS go to the app
fixtures create Symfony and Laravel reference projects in target/fixtures/";
fixtures create Symfony and Laravel reference projects in target/fixtures/
",
"mac-report [--skip-gate] [--port PORT] [--out DIR]
check this machine end to end and write one report file
(default target/mac-report/report.md, port 7971)"
);
/// Dispatches to the subcommand named by the first argument.
fn main() -> ExitCode {
@ -50,6 +57,7 @@ fn main() -> ExitCode {
tasks::dev(&app_args)
}
"fixtures" => tasks::fixtures(),
"mac-report" => macreport::parse(rest).and_then(|o| macreport::mac_report(&o)),
"help" | "--help" | "-h" => {
println!("{USAGE}");
Ok(())