Merge lavoro/onboard-mac

Note di Giorgio, primo onboard su Mac: dopo Homebrew brew non e' nel PATH
di un terminale nuovo (aws non si trova), e brew install --cask
openvpn-connect chiede la password del Mac. comune.sh ora trova brew da
solo in /opt/homebrew o /usr/local.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

CLAUDE.md

@@ -99,7 +99,16 @@ spiegala in una riga la prima volta.
    - **Mac**: prima Homebrew. Il suo installatore chiede la password del Mac,
      quindi quel comando lo lancia la persona nel Terminale:
      `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`.
-     Poi tu: `brew install git awscli` e `brew install --cask docker`.
+     **Homebrew non si mette da solo nel `PATH`** (sui Mac Apple Silicon sta
+     in `/opt/homebrew`): senza, in un terminale nuovo `brew` e `aws` non si
+     trovano. Lo aggiungi tu, una volta:
+     `echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile`
+     (su un Mac Intel sta in `/usr/local` e il passo non serve). Poi tu:
+     `eval "$(/opt/homebrew/bin/brew shellenv)" && brew install git awscli`
+     e `brew install --cask docker`. Se un'installazione `--cask` chiede la
+     password del Mac, la lancia la persona nel Terminale. Gli script di
+     questo repository trovano `brew` anche senza il `PATH` sistemato, il
+     terminale della persona no.
    - Docker Desktop va **aperto una volta** a mano e le condizioni accettate:
      finché non lo si fa, `docker info` non risponde.
 2. **Questo repository sul PC**, se ci stai parlando da un link e non da
@@ -131,9 +140,11 @@ spiegala in una riga la prima volta.
    non va mai tenuta "intanto che funziona": tutto quello che la persona fa
    su AWS risulterebbe fatto dall'altro.
 5. **VPN**, solo se su LastPass ha la scheda `OTO > VPN HK nome.cognome` (chiediglielo). Prima
-   installi tu OpenVPN Connect: su Windows
-   `winget install -e --id OpenVPNTechnologies.OpenVPNConnect`, su Mac
-   `brew install --cask openvpn-connect`. Poi lei, un passo alla volta: apre la scheda VPN su LastPass e scarica il file
+   va installato OpenVPN Connect: su Windows lo installi tu,
+   `winget install -e --id OpenVPNTechnologies.OpenVPNConnect`; su Mac
+   `brew install --cask openvpn-connect` chiede la password del Mac (installa
+   un componente di sistema), quindi lo lancia la persona nel Terminale e tu
+   le dai il comando. Poi lei, un passo alla volta: apre la scheda VPN su LastPass e scarica il file
    `.ovpn` allegato; apre OpenVPN Connect → *Upload File* (o *Import
    Profile* → *File*) → *Browse* → il file in *Download*; scrive utente e
    password della VPN dalla stessa scheda, spunta *Save password*, *Connect*.

comune.sh

@@ -51,6 +51,14 @@ titolo ()  { echo ; echo "${GRASSETTO}$*${FINE}" ; }
 
 c_e () { command -v "$1" > /dev/null 2>&1 ; }
 
+# Su Mac Homebrew non si mette da solo nel PATH: senza, git e aws installati
+# con brew sembrano mancare anche se ci sono.
+if ! c_e brew ; then
+  for B in /opt/homebrew/bin/brew /usr/local/bin/brew ; do
+    [ -x "$B" ] && eval "$("$B" shellenv)" && break
+  done
+fi
+
 token_gitea () {
   [ -s "$TOKEN_GITEA_FILE" ] && tr -d '[:space:]' < "$TOKEN_GITEA_FILE"
 }