Documentazione: ADR su GUI Avalonia multipiattaforma e motori CLI

Introduce docs/adr con ADR-0001 (GUI in solo C# con Avalonia per Windows e
Linux) e ADR-0002 (Codex e Antigravity oltre a Claude Code), entrambi in
stato Proposta. Aggiunge docs/README.md come indice unico con regole SSOT e
checklist di rinomina, perché il nome del progetto non è ancora deciso.
La roadmap ha la nuova Fase 5 e la Fase 4 ora contiene solo i passi, con le
motivazioni spostate negli ADR.

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

docs/adr/0001-gui-multipiattaforma-avalonia.md

@@ -0,0 +1,60 @@
+# ADR-0001 — GUI multipiattaforma in solo C# con Avalonia
+
+- **Stato**: Proposta
+- **Data**: 2026-10-15
+- **Sostituisce**: la parte "GUI WinForms + WebView2 + `ui.html`" di [MVP.md](../MVP.md) (le sezioni interessate rimandano a questo ADR)
+
+## Contesto
+L'app nasce per Windows: GUI WinForms con un solo WebView2 che carica `ui.html` (HTML/CSS/JS), CLI in `Program.cs`. L'obiettivo ora è avere **un eseguibile standalone per Windows e Linux** nel modo più semplice, **scritto interamente in C#, senza HTML**.
+
+Oggi non è possibile: WinForms e WebView2 sono solo Windows, il csproj punta a `net10.0-windows`, la cronologia usa `%LOCALAPPDATA%`. La CLI invece è già portabile.
+
+## Criteri di decisione
+1. Un solo codice sorgente, compilabile per `win-x64` e `linux-x64`.
+2. Standalone: publish single-file self-contained, senza runtime né librerie da installare oltre a quanto offre un normale desktop.
+3. Solo C# (e XAML per il layout): niente HTML/CSS/JS.
+4. Mantenere la GUI a finestra (chat con barra laterale, markdown, selettori modello/effort).
+5. Riuso massimo della logica esistente (`claude -p`, sessioni, cronologia JSON, Markdig).
+
+## Opzioni considerate
+| Opzione | Esito | Motivo |
+|---|---|---|
+| Mantenere WinForms + WebView2 | Scartata | Solo Windows, e richiede HTML. |
+| Photino / WebView nativa | Scartata | Richiede HTML e, su Linux, webkit2gtk da installare: non standalone. |
+| Server HTTP locale (Kestrel) + browser | Scartata | Portabile e semplice, ma la UI resta HTML e non è una finestra propria. |
+| MAUI | Scartata | Nessun supporto desktop Linux ufficiale. |
+| Terminal.Gui (TUI) | Alternativa | Puro C#, binario leggero, ma è un'interfaccia da terminale, non una finestra. |
+| **Avalonia UI** | **Scelta** | GUI nativa, C# + XAML, render Skia, Windows e Linux, publish single-file self-contained. |
+
+## Decisione
+La GUI viene riscritta con **Avalonia UI**:
+- Layout in XAML, logica in C# con `ViewModel` e binding. `ui.html`, il protocollo `WebMessage` e le dipendenze WinForms/WebView2 spariscono.
+- Rendering markdown con una libreria Avalonia basata su Markdig, al posto della conversione in HTML. I link `http(s)` si aprono nel browser di sistema.
+- Un solo progetto con target `net10.0` (non più `net10.0-windows`). Due publish single-file self-contained: `win-x64` e `linux-x64`.
+- La CLI (`Program.cs` con argomenti) resta com'è e funziona su entrambi i sistemi.
+- La cronologia usa `Environment.SpecialFolder.LocalApplicationData` (`%LOCALAPPDATA%` su Windows, `~/.local/share` su Linux), sottocartella `<nome-app>/chats`. Il nome viene da un'unica costante (vedi [Nome del progetto](../README.md#nome-del-progetto)).
+- La logica di avvio del processo (cartella dell'exe, stdin chiuso, `ArgumentList`) viene estratta in **un solo punto** condiviso da CLI e GUI, eliminando la duplicazione oggi segnalata in `CLAUDE.md`. Si lega all'astrazione "motore" di [ADR-0002](0002-motori-cli-claude-codex-antigravity.md).
+- L'aspetto (token di colore, tipografia, accessibilità) resta definito in [MVP.md](../MVP.md) → "Design (UI/UX)", tradotto in risorse/stili Avalonia. Il tema segue il sistema (chiaro/scuro) tramite `ThemeVariant`.
+
+## Conseguenze
+**Positive**
+- Un solo eseguibile per sistema, senza dipendenze di runtime.
+- Nessun HTML/JS da mantenere; il vincolo STA di WinForms/WebView2 non c'è più.
+- Pulizia della duplicazione CLI/GUI.
+
+**Negative / costi**
+- Riscrittura della sola parte GUI (`Gui.cs` + `ui.html`), più ampia di una soluzione basata sul browser.
+- Eseguibile più pesante (include Avalonia/Skia).
+- Perdita di alcune comodità del web: la resa del markdown (tabelle, blocchi di codice, pulsante Copia) dipende dalla libreria scelta e va riprodotta o adattata.
+- Su Linux serve un desktop con X11 o XWayland e le librerie di base (fontconfig ecc.).
+
+## Da verificare (prima di passare a "Accettata")
+- [ ] La libreria markdown per Avalonia scelta è compatibile con la versione di Avalonia usata e con `net10.0`, e rende tabelle, citazioni e blocchi di codice in modo accettabile.
+- [ ] Il publish single-file `linux-x64` parte su una distribuzione pulita (nessuna libreria nativa mancante oltre a quelle di desktop).
+- [ ] `claude` viene trovato nel PATH su Linux e la CLI mantiene exit code e codice 127.
+- [ ] Il tema chiaro/scuro segue il sistema anche su Linux.
+- [ ] Le chat esistenti restano leggibili (stesso formato JSON). Se il nome cambia cambia anche la cartella dati: prevedere la migrazione della vecchia cartella.
+
+## Riferimenti
+- Piano di lavoro: [ROADMAP.md](../ROADMAP.md), Fase 5.
+- Specifica funzionale della chat: [MVP.md](../MVP.md).

docs/adr/0002-motori-cli-claude-codex-antigravity.md

@@ -0,0 +1,47 @@
+# ADR-0002 — Più motori CLI (Claude Code, Codex, Antigravity) su Windows e Linux
+
+- **Stato**: Proposta
+- **Data**: 2026-10-15
+- **Collegato a**: [ADR-0001](0001-gui-multipiattaforma-avalonia.md) (GUI e piattaforme)
+
+## Contesto
+L'app lancia solo `claude -p`. Si vuole usare dalla stessa chat anche **OpenAI Codex CLI** e **Antigravity CLI** (`agy`), così come `claude` già installati da terminale dall'utente, su Windows e Linux. L'app non li installa e non gestisce login: sono programmi esterni, autenticati a parte.
+
+## Criteri di decisione
+1. Aggiungere un motore costa una definizione dichiarativa, non nuova logica sparsa.
+2. Funziona uguale su Windows e Linux: i motori si trovano nel PATH come da terminale.
+3. Un solo punto di avvio processo (cartella dell'exe, stdin chiuso, `ArgumentList`), condiviso da CLI e GUI.
+4. Nessuna scorciatoia che disattivi i controlli di permesso senza una scelta esplicita dell'utente.
+
+## Decisione
+- **Astrazione "motore"** in C#. Ogni motore descrive: nome e eseguibile, argomenti per il primo messaggio e per la ripresa, elenco modelli, supporto effort, modo per ottenere l'id di sessione. `RunClaude` diventa `RunEngine(engine, …)`.
+- **Rilevamento** dei motori cercando l'eseguibile nel PATH (su Windows anche le estensioni di PATHEXT). I motori assenti sono disabilitati nelle Impostazioni, con messaggio chiaro; la CLI esce con 127 come oggi.
+- **Una chat = un motore**. Il file JSON della chat memorizza il motore; il contesto di sessione non passa da un motore all'altro, quindi cambiare motore apre una nuova chat.
+- **Impostazioni** nella GUI: motore attivo, modello, effort (solo se supportato), persistite su disco accanto alla cronologia. La CLI ottiene `--engine`.
+- **Permessi**: di default sola lettura / nessun bypass dei controlli; concedere di più è un'opzione esplicita.
+- **Output**: ogni motore ha un parser che lo normalizza in testo markdown prima del rendering.
+
+## Comandi dei motori
+Da verificare con `--help` delle versioni installate: derivano da documentazione e ricerche, non da prove su questo PC, dove `codex` e `agy` non sono installati.
+
+| | Claude Code | Codex CLI | Antigravity CLI |
+|---|---|---|---|
+| Comando | `claude -p <prompt>` | `codex exec <prompt>` | `agy -p <prompt>` |
+| Continuare | `--session-id <guid>` poi `--resume <guid>` | `codex exec resume <id> <prompt>` | da verificare |
+| Modello | `--model` | `-m` / `--model` | da verificare |
+| Effort | `--effort` | via `--config` (da verificare) | non noto |
+
+## Conseguenze
+**Positive**: un solo flusso di avvio; nuovi motori aggiungibili con una definizione; elimina la duplicazione CLI/GUI.
+**Negative**: i flag delle CLI cambiano nel tempo e vanno mantenuti; le sessioni non si trasferiscono tra motori; più superficie da testare su due sistemi operativi.
+
+## Rischi e da verificare
+- [ ] **Codex**: l'id di sessione lo genera Codex e non l'app; va letto dall'output (probabilmente con output JSON) per riprendere la chat.
+- [ ] **Antigravity**: segnalato un blocco di `agy -p` da sottoprocesso con output rediretto su Windows ([issue #318](https://github.com/google-antigravity/antigravity-cli/issues/318)). Provare con `--print-timeout` e prevedere un messaggio d'errore. I flag vanno messi prima di `-p`. Da provare anche su Linux.
+- [ ] **Forma dell'eseguibile**: `claude` è un .exe nativo avviabile direttamente; Codex e Antigravity, se installati con un gestore di pacchetti (es. npm), su Windows possono essere script `.cmd` che richiedono `cmd.exe /c`. Su Linux sono normali eseguibili o script con shebang. Verificare e gestire per motore.
+- [ ] Autenticazione: ogni CLI deve essere già autenticata; l'app mostra l'errore del motore senza gestire login.
+- [ ] Formato dell'output (testo o JSON) e normalizzazione per ciascun motore.
+- [ ] Mappatura effort e modelli per motore, con elenco modelli aggiornabile.
+
+## Riferimenti
+- Passi: [ROADMAP.md](../ROADMAP.md), Fase 4.