davide/agent-wiki-ui
1
0 Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity
Files
c50bd637235dbc238c12e58ace5c46c8f463abcb
agent-wiki-ui/docs/ROADMAP.md
T
davideandClaude Sonnet 5.5 c50bd63723 Documentazione: compatibilità con Codex e interruttore CLI 
ADR-0002 passa ad Accettata per Claude Code e Codex con l'esito delle prove
reali: id di sessione da thread.started, output JSONL, risposta = ultimo
agent_message, ripresa senza -s e sola lettura via sandbox_mode, -- prima del
prompt. MVP, ROADMAP, INSTALL e README descrivono l'interruttore CLI, la
nuova opzione --engine e il problema del modello predefinito che richiede un
Codex più recente. TESTING.md aggiunge le righe CX, EN e ST-12.

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

4.8 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 i flag reali di codex (provati su Linux/WSL, ADR-0002 accettata per Claude Code e Codex); agy e Windows da verificare
  • Astrazione "motore" in C# (Core/Engine.cs, Core/EngineRunner.cs)
  • Rilevamento dei motori nel PATH; motori assenti disabilitati, messaggio chiaro
  • Il JSON di ogni chat memorizza il motore e l'id di sessione; cambiare motore apre una nuova chat
  • GUI: interruttore CLI nel riquadro Impostazioni; modelli ed effort in base al motore; motore della chat indicato nell'interfaccia
  • Impostazioni (motore, modello, effort) persistite su disco
  • Motore Codex: lettura dell'id di sessione dall'output (thread_id) per la ripresa
  • Motore Antigravity: gestione del blocco con output rediretto (timeout, errore chiaro)
  • Permessi di Codex in sola lettura (nessun flag che salta i controlli)
  • Opzione esplicita per concedere permessi di scrittura
  • 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 dei motori (Core/EngineRunner.cs: cartella dell'exe, stdin chiuso), prima 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