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:
parent
da58c83158
commit
1bf69ded55
18 changed files with 1795 additions and 36 deletions
|
|
@ -1,6 +1,6 @@
|
|||
# Development
|
||||
|
||||
> **Status:** draft · **Last updated:** 2026-10-27
|
||||
> **Status:** draft · **Last updated:** 2026-10-31
|
||||
|
||||
## Prerequisites
|
||||
|
||||
|
|
@ -8,6 +8,7 @@
|
|||
- Node.js 22.12 or newer (Vite 8 needs it) and pnpm 10
|
||||
- Tauri 2 system prerequisites for your platform (WebView2 on Windows, WebKitGTK on Linux)
|
||||
- Optional: Phpactor on the PATH for language features, PHP 8.2+ and Composer for reference projects
|
||||
- macOS: a step-by-step setup for a fresh Apple Silicon Mac is in [`macos.md`](macos.md)
|
||||
|
||||
## Everyday commands
|
||||
|
||||
|
|
@ -16,8 +17,11 @@ cargo xtask dev # run the app in development mode
|
|||
cargo xtask dev -- --control 7979 . # with the JSON control channel
|
||||
cargo xtask ci # the full quality gate, run before every commit
|
||||
cargo xtask fixtures # create Symfony and Laravel reference projects in target/fixtures/
|
||||
cargo xtask mac-report # gate, build and an app self-check, written to target/mac-report/report.md
|
||||
```
|
||||
|
||||
`mac-report` is made for checking a machine the developers cannot reach (the Mac, see [`macos.md`](macos.md)) but runs everywhere. Every step has a timeout; `--skip-gate` leaves out the gate, `--port` picks the control port (default 7971).
|
||||
|
||||
## Data directories
|
||||
|
||||
A `--control PORT` instance keeps its settings, recovery journal and webview data in `<temp>/lutra-control/<port>/`, never in your own data directory, so a dev or agent instance cannot change your settings or restore your journal. `--data-dir DIR` or `LUTRA_DATA_DIR=DIR` pick another directory, for any instance:
|
||||
|
|
@ -56,6 +60,7 @@ No inline comments. Doc comment blocks above modules, functions, types and field
|
|||
|
||||
| Date | Change | Summary |
|
||||
|---|---|---|
|
||||
| 2026-10-31 | minor | A1: `cargo xtask mac-report`, link to the macOS setup |
|
||||
| 2026-10-27 | minor | F3: data directories, build directories inside the repository, parallel builds, deleting `ui/node_modules` |
|
||||
| 2026-10-27 | minor | Unfocused `--control` windows and the screenshot focus check (F2) |
|
||||
| 2026-10-25 | minor | Isolated data directory for `--control` instances (H6) |
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue