davide/agent-wiki-ui
1
0 Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity
Files
007cc9bdfa5a43def103eabce55aaaddf9328a3a
agent-wiki-ui/docs/ROADMAP.md
T
davideandClaude Sonnet 5.5 84fefda219 Documentazione: strategia di test e regola "nuova funzione = nuovi test" 
Aggiunge ADR-0003 (xUnit, Avalonia.Headless, coverlet, FakeClaude come
doppio di claude, struttura src/tests) e docs/TESTING.md con la regola, le
soglie di copertura e la matrice requisito-test. Ogni criterio di
accettazione dell'MVP è collegato alle righe della matrice. La roadmap ha
la Fase 6 e CLAUDE.md rende obbligatori i test nello stesso commit.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-15 11:22:08 +02:00

4.6 KiB
Raw Blame History

Roadmap

Dettagli dell'MVP in MVP.md.

Fase 0 — Doc-first

  • Scrivere MVP.md e ROADMAP.md
  • Chiudere le domande aperte in MVP.md

Fase 1 — MVP

  • dotnet new console, Program.cs unico

  • Lancio di claude -p nella cartella dell'exe, streaming, exit code

  • Publish single-file win-x64 e verifica dei criteri di accettazione

  • GUI a chat: conversazione markdown in alto, input in basso, sessione con --session-id/--resume

Fase 2 — Robustezza

  • Input del prompt da stdin e da file
  • Timeout e cancellazione (Ctrl+C propagato al figlio)
  • GUI: scelta di modello (--model) ed effort (--effort)
  • CLI: stesse opzioni; inoltre --allowedTools, --output-format

Fase 3 — Oltre

  • GUI: cronologia chat (salvataggio JSON, barra laterale, riapertura con --resume, eliminazione)
  • GUI: streaming della risposta (--output-format stream-json), stop, rinomina/ricerca chat
  • Config file accanto all'exe
  • Test automatici e CI (vedi Fase 6)

Fase 4 — Più motori (Claude Code, Codex, Antigravity)

Decisione, tabella dei comandi e rischi: ADR-0002. Qui solo i passi. Va fatta dopo (o insieme a) la Fase 5, che estrae il punto unico di avvio processo.

  • Verificare con --help i flag reali di codex e agy su Windows e Linux (ADR-0002) e portare l'ADR a "Accettata"
  • Astrazione "motore" in C#: RunClaude diventa RunEngine(engine, ...)
  • Rilevamento dei motori nel PATH; motori assenti disabilitati, messaggio chiaro
  • Il JSON di ogni chat memorizza il motore; cambiare motore apre una nuova chat
  • GUI: schermata Impostazioni (motore, modello, effort) persistita su disco; modelli ed effort in base al motore; motore della chat indicato nell'interfaccia
  • Motore Codex: lettura dell'id di sessione dall'output per la ripresa
  • Motore Antigravity: gestione del blocco con output rediretto (timeout, errore chiaro)
  • Politica dei permessi: sola lettura di default, opzione esplicita per concedere di più
  • CLI: opzione --engine, coerente con la GUI

Fase 5 — Multipiattaforma (Windows + Linux), GUI in solo C#

Decisione e motivazioni: ADR-0001. Qui solo i passi.

  • Chiudere le verifiche dell'ADR-0001 con un prototipo e portarlo a "Accettata" (restano due verifiche indicate nell'ADR)
  • Nome dell'app in un solo punto: AssemblyName nel csproj, letto da Core/AppInfo.cs; la rinomina segue la checklist di docs/README.md
  • Rinomina in agent-wiki-ui (csproj, namespace) e migrazione automatica della cartella dati LlmRun → agent-wiki-ui
  • Target net10.0 (non più net10.0-windows); rimossi WinForms e WebView2
  • Estrarre in un solo punto la logica di avvio di claude (Core/Claude.cs) (cartella dell'exe, stdin chiuso), oggi duplicata tra Program.cs e Gui.cs
  • Cronologia in Environment.SpecialFolder.LocalApplicationData (stesso formato JSON, chat esistenti ancora leggibili)
  • GUI Avalonia: finestra, barra laterale delle chat, conversazione, composer con modello ed effort
  • Rendering markdown in Avalonia (titoli, liste, tabelle, citazioni, codice), pulsante Copia, link nel browser di sistema
  • Tema chiaro/scuro che segue il sistema, con i token di MVP.md → "Design (UI/UX)" (da provare su un desktop Linux reale)
  • Eliminare ui.html e il protocollo WebMessage
  • Publish single-file self-contained win-x64 e linux-x64: compilano e partono (Linux: CLI e GUI su WSLg; Windows: solo CLI, via WSL); da provare la GUI su Windows nativo e su una distribuzione Linux pulita
  • Aggiornare README.md e CLAUDE.md (comandi, architettura, vincoli) a migrazione conclusa

Fase 6 — Test e copertura completa

Decisione: ADR-0003. Piano, soglie e matrice: TESTING.md. Da questa fase in poi vale la regola: ogni nuova funzione arriva con i suoi test.

  • Verificare le compatibilità dell'ADR-0003 (xUnit, Avalonia.Headless, coverlet, dotnet test) e portarlo ad "Accettata"
  • Ristrutturare in src/ e tests/ con soluzione unica e InternalsVisibleTo
  • Predisposizioni di testabilità: ChatStore a istanza, IClaudeRunner
  • FakeClaude: eseguibile finto per i test di processo
  • Test Core/ (CL, ST) e MainViewModel (VM)
  • Test del renderer markdown (MD) e della GUI headless (UI)
  • Test end-to-end e smoke di publish per win-x64 e linux-x64 (PUB)
  • Soglie di copertura che fanno fallire la build
  • CI con matrice Windows + Linux (fornitore da scegliere)
  • Batteria di contratto per ogni motore (EN), insieme alla Fase 4
Reference in new issue View Git Blame Copy Permalink