.vscode in JSON rigido: senza commenti, le spiegazioni nella guida

Il controllo «File JSON» della CI legge ogni *.json tracciato con JSON.parse:
con i commenti // dei quattro file di .vscode il lavoro «controlli» sarebbe
fallito a ogni push dopo l'unione con il ramo della CI, e con lui tutta la
verifica. VS Code legge anche il JSON rigido, quindi i commenti si tolgono e le
spiegazioni passano nella guida («Da VS Code»), nei campi detail delle attività
e in docs/decisioni.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Alby96andClaude Opus 5.5 committed 2026-10-20 11:45:12 +02:00
1 parent 1b5a8d4dcd
commit 7bcb9f5f5a
6 files changed
+9 -44

No files matched your search

-1
View File
@@ -1,4 +1,3 @@
// Estensioni consigliate per Febe: C# Dev Kit (soluzione, prove) e C# (linguaggio e debugger «coreclr» di launch.json).
{
"recommendations": ["ms-dotnettools.csdevkit", "ms-dotnettools.csharp"]
}
-22
View File
@@ -1,18 +1,7 @@
// Configurazioni di debug di Febe (guida: docs/guida/Sviluppo.md, «Da VS Code»). Tipo «coreclr» dell'estensione C#.
// - Prima di partire compilano tutta la soluzione con l'attività «compila» (.vscode/tasks.json).
// - Febe per Windows di sviluppo tiene dati e libreria in %USERPROFILE%\FebeSviluppo: mai in %LOCALAPPDATA%\Febe.
// - Nessuna configurazione contatta Instagram tranne l'ultima, «⚠ Febe per Windows · Instagram vero (dati veri)»:
// è per le prove dal vivo di Alberto (regola 1) e chiede conferma prima di partire.
// - VS Code non sa nascondere una configurazione per sistema operativo: quelle che non possono girare su un sistema
// lì si fermano subito con un messaggio (attività «solo su Windows» e «solo su Linux»).
// - Tutte usano la Console di debug («internalConsole»), mai il terminale integrato: il terminale carica il profilo di
// PowerShell, che può mettere davanti un altro .NET (per esempio quello di un ambiente conda, con il solo .NET 8, e
// il programma non parte). La Console di debug usa l'ambiente di VS Code.
{
"version": "0.2.0",
"configurations": [
{
// Il sito di prova parte come attività di sfondo (porte 8481 e 8482) e a fine debug si ferma.
"name": "Febe per Windows · sito di prova",
"type": "coreclr",
"request": "launch",
@@ -39,8 +28,6 @@
"presentation": { "group": "1-windows", "order": 1 }
},
{
// Il sito di prova nel debugger; quando scrive «Sito di prova: http://…» parte anche Febe per Windows
// (configurazione nascosta qui sotto), che si ferma insieme al sito.
"name": "Sito di prova + Febe per Windows",
"type": "coreclr",
"request": "launch",
@@ -84,9 +71,6 @@
"presentation": { "hidden": true }
},
{
// L'interfaccia viene da src/Febe.Web/wwwroot (FEBE_INTERFACCIA): modifichi un file e ricarichi la pagina.
// Fermata dal debugger, la dimostrazione non cancella la sua cartella temporanea: su Windows finisce in
// %USERPROFILE%\FebeSviluppo\temporanei, che si svuota quando vuoi.
"name": "Febe Server · dimostrazione (--demo)",
"type": "coreclr",
"request": "launch",
@@ -133,8 +117,6 @@
"presentation": { "group": "2-strumenti", "order": 3 }
},
{
// Il server vero contro il sito di prova, con Chromium su Xvfb (specifica §11): solo su Linux. Come root serve
// anche --senza-sandbox; se Chromium non è nel PATH, FEBE_CHROMIUM. Interfaccia su 127.0.0.1:8480, password «prova».
"name": "Febe Server · sito di prova (solo Linux)",
"type": "coreclr",
"request": "launch",
@@ -170,15 +152,11 @@
},
"checkForDevCert": false,
"logging": { "moduleLoad": false },
// Su Windows e macOS si ferma con un messaggio; anche con «Esegui comunque il debug» stampa solo l'aiuto.
"windows": { "preLaunchTask": "solo su Linux", "postDebugTask": "", "args": ["--aiuto"] },
"osx": { "preLaunchTask": "solo su Linux", "postDebugTask": "", "args": ["--aiuto"] },
"presentation": { "group": "3-linux", "order": 1 }
},
{
// Instagram vero, con l'account e i dati veri (%LOCALAPPDATA%\Febe, Immagini\Febe): solo per le prove dal vivo di
// Alberto. Chiede conferma (Esc annulla). Una versione di sviluppo può aggiornare il database vero. Se Febe
// installato è aperto, prima esci da lui (menu dell'icona ▸ Esci): un solo Febe per cartella dei dati.
"name": "⚠ Febe per Windows · Instagram vero (dati veri)",
"type": "coreclr",
"request": "launch",
-1
View File
@@ -1,4 +1,3 @@
// Impostazioni di VS Code condivise per Febe: solo ciò che vale per tutti (guida: docs/guida/Sviluppo.md).
{
"dotnet.defaultSolution": "Febe.slnx"
}
+3 -17
View File
@@ -1,14 +1,9 @@
// Attività di VS Code per Febe (guida: docs/guida/Sviluppo.md, «Da VS Code»).
// Sono i comandi della guida. Le due opzioni in più di compilazione e prove (-tl:off, -clp:ForceNoAlign) danno il
// registro classico, come nella CI: ogni errore su una riga sola, che $msCompile porta nel pannello Problemi.
// Tutte sono di tipo «process»: nessuna shell, quindi nessun profilo di PowerShell che metta davanti un altro .NET.
// Nessuna attività contatta Instagram: il sito di prova è locale (regola 1).
{
"version": "2.0.0",
"tasks": [
{
"label": "compila",
"detail": "dotnet build Febe.slnx -warnaserror: tutta la soluzione, gli avvisi sono errori",
"detail": "dotnet build Febe.slnx -warnaserror: tutta la soluzione, gli avvisi sono errori; con -tl:off -clp:ForceNoAlign ogni errore sta su una riga e finisce nel pannello Problemi",
"type": "process",
"command": "dotnet",
"args": [
@@ -58,10 +53,8 @@
"presentation": { "clear": true }
},
{
// In sfondo: VS Code lo considera pronto quando il sito scrive «Sito di prova: http://…». Il «CDN» ascolta su
// 127.0.0.2:8482, l'indirizzo che Febe si aspetta con --sito-di-prova http://127.0.0.1:8481.
"label": "sito di prova",
"detail": "dotnet run --project tools/Febe.SitoDiProva: http://127.0.0.1:8481, CDN su 127.0.0.2:8482, dati sintetici del seme 13",
"detail": "dotnet run --project tools/Febe.SitoDiProva: http://127.0.0.1:8481, CDN su 127.0.0.2:8482 (dove Febe lo cerca), dati sintetici del seme 13; in sfondo, pronto alla riga «Sito di prova: http://…»",
"type": "process",
"command": "dotnet",
"args": [
@@ -79,8 +72,6 @@
"base": "$msCompile",
"owner": "sito-di-prova",
"background": {
// Al lavoro dall'avvio (activeOnStart) fino alla riga di endsPattern, poi pronto per sempre: «(?!)» non trova
// mai nulla, quindi nessuna riga successiva lo rimette «al lavoro».
"activeOnStart": true,
"beginsPattern": "(?!)",
"endsPattern": "^Sito di prova: http://"
@@ -125,8 +116,6 @@
"problemMatcher": [],
"presentation": { "clear": true }
},
// Attività di servizio delle configurazioni di debug (.vscode/launch.json): non compaiono nell'elenco.
{
"label": "compila e avvia il sito di prova",
"detail": "Prima del debug contro il sito di prova: compila, poi avvia il sito (se è già aperto, lo usa così com'è)",
@@ -136,11 +125,8 @@
"problemMatcher": []
},
{
// VS Code non ha un'attività che ne chiuda un'altra: lo fa l'input «fermaIlSitoDiProva», che esegue il comando
// workbench.action.tasks.terminate mentre VS Code prepara questa attività. Il comando non restituisce un testo,
// quindi l'argomento resta com'è e «echo» lo stampa e basta. Un processo e non una shell: niente profilo da caricare.
"label": "ferma il sito di prova",
"detail": "A fine debug: chiude l'attività «sito di prova»",
"detail": "A fine debug: chiude l'attività «sito di prova» con l'input fermaIlSitoDiProva (comando workbench.action.tasks.terminate); echo stampa solo il suo argomento",
"type": "process",
"command": "echo",
"args": ["${input:fermaIlSitoDiProva}"],
+2 -1
View File
@@ -229,9 +229,10 @@ Ogni scelta tecnica presa strada facendo, con data e motivo (specifica §15).
| 2026-10-20 | VS Code: configurazione condivisa in `.vscode/` (`launch.json`, `tasks.json`, `extensions.json`, `settings.json` con la sola `dotnet.defaultSolution`); debug con il tipo `coreclr` dell'estensione C#, senza file `launchSettings.json` | Il tipo `dotnet` del C# Dev Kit accetta solo il progetto e un profilo di `launchSettings.json`: niente argomenti, variabili d'ambiente, attività prima e dopo, `serverReadyAction`. Con `coreclr` tutto sta in un file solo |
| 2026-10-20 | Febe per Windows di sviluppo da VS Code con `--dati %USERPROFILE%\FebeSviluppo\dati` e `--libreria %USERPROFILE%\FebeSviluppo\libreria`; il debug avvia `Febe.exe`, non `dotnet Febe.dll` | Mai la cartella vera `%LOCALAPPDATA%\Febe`; fuori dal repository perché profilo del browser e libreria crescono e non devono finire in un commit. Con `Febe.exe` il percorso del processo è quello di Febe e non di `dotnet.exe` (lo usa l'avvio con il computer) |
| 2026-10-20 | Attività di compilazione, prove e pubblicazione con `-tl:off -clp:ForceNoAlign` oltre al comando della guida | Registro classico, come nella CI: ogni errore su una riga sola, senza le righe che il terminal logger ridisegna nel terminale; `$msCompile` lo porta nel pannello Problemi (provato con un errore voluto) |
| 2026-10-20 | Il sito di prova è un'attività di sfondo, pronta alla riga «Sito di prova: http://»; a fine debug la ferma un input che esegue `workbench.action.tasks.terminate` | VS Code non ha un'attività che ne chiuda un'altra: un input di tipo `command` è l'unico modo per farlo da `postDebugTask` |
| 2026-10-20 | Il sito di prova è un'attività di sfondo, pronta alla riga «Sito di prova: http://» (`activeOnStart`, con `beginsPattern` «(?!)», che non trova mai nulla); a fine debug la ferma un input che esegue `workbench.action.tasks.terminate` | VS Code legge `activeOnStart`, non `activeBegins`: senza, il debug aspettava il sito per sempre. Con «(?!)» nessuna riga successiva rimette l'attività «al lavoro». VS Code non ha un'attività che ne chiuda un'altra: un input di tipo `command` è l'unico modo per farlo da `postDebugTask` |
| 2026-10-20 | «Sito di prova + Febe per Windows» non è un compound: la configurazione del sito avvia Febe con `serverReadyAction` (`startDebugging`, `killOnServerStop`) quando il sito scrive di essere pronto | Un compound avvia tutto insieme e senza ordine: Febe con `--accesso-di-prova` poteva cercare il sito prima che ascoltasse |
| 2026-10-20 | Le configurazioni legate a un sistema (Febe per Windows; Febe Server con il sito di prova, cioè Chromium su Xvfb) sugli altri sistemi si fermano con un messaggio (attività «solo su Windows» e «solo su Linux»; il server riceve anche solo `--aiuto`) | VS Code non sa nascondere una configurazione per sistema operativo: le proprietà `windows`, `linux` e `osx` contano solo all'avvio |
| 2026-10-20 | «⚠ Febe per Windows · Instagram vero (dati veri)» chiede conferma prima di compilare e partire (una scelta sola, Esc annulla) | Regola 1: le prove dal vivo le lancia Alberto; un F5 distratto non deve aprire Instagram con l'account e il database veri |
| 2026-10-20 | Tutte le configurazioni di debug scrivono nella Console di debug (`internalConsole`), mai nel terminale integrato; le attività sono di tipo `process`, senza shell | Il terminale integrato e le attività `shell` caricano il profilo di PowerShell: su questo PC il profilo attiva l'ambiente conda di Pinokio, che mette in testa al `PATH` e in `DOTNET_ROOT` un .NET senza SDK e con il solo runtime 8. Lì `dotnet build` non trova l'SDK e Febe (net10.0) non parte («You must install or update .NET»), né come `febe.dll` né come `febe.exe`. Console di debug e attività `process` usano l'ambiente di VS Code |
| 2026-10-20 | La dimostrazione da VS Code serve l'interfaccia dai sorgenti (`FEBE_INTERFACCIA`), apre da sola il browser (`serverReadyAction`) e su Windows tiene la cartella temporanea in `%USERPROFILE%\FebeSviluppo\temporanei` (`TEMP`, `TMP`) | Si modifica `wwwroot` e si ricarica senza ricompilare. Fermata dal debugger, la dimostrazione non può cancellare la sua cartella (una trentina di MB): così resta fra i dati di sviluppo invece di accumularsi in `%TEMP%` |
| 2026-10-20 | I file di `.vscode/` sono JSON rigido, senza commenti: le spiegazioni stanno nella guida (pagina «Sviluppo», «Da VS Code»), nei campi `detail` delle attività e in queste righe | Il controllo «File JSON» della CI legge ogni `*.json` tracciato con `JSON.parse`, e con i commenti `//` il lavoro «controlli» falliva a ogni push dopo l'unione. VS Code legge anche il JSON rigido, così il ramo non dipende da come la CI tratta i commenti |
+4 -2
View File
@@ -59,8 +59,8 @@ La cartella `.vscode/` prepara VS Code per Febe: estensioni consigliate (C# Dev
| Febe Server · dimostrazione (--demo) | La dimostrazione su `http://127.0.0.1:8480`, che si apre da sola nel browser; l'interfaccia viene da `src/Febe.Web/wwwroot` (`FEBE_INTERFACCIA`): modifichi un file e ricarichi la pagina |
| Sito di prova | Solo il sito di prova, nel debugger |
| Simulazione 30 giorni (prudente) | `--simula 30g --profilo prudente`, con il resoconto nella Console di debug |
| Febe Server · sito di prova (solo Linux) | Il server vero, con Chromium su Xvfb, contro il sito di prova: interfaccia su `127.0.0.1:8480`, password `prova` (come root serve anche `--senza-sandbox`). Su Windows e macOS si ferma con un messaggio |
| ⚠ Febe per Windows · Instagram vero (dati veri) | Febe senza opzioni: Instagram vero, `%LOCALAPPDATA%\Febe` e `Immagini\Febe`. Solo per le prove dal vivo di Alberto: chiede conferma, e una versione di sviluppo può aggiornare il database vero |
| Febe Server · sito di prova (solo Linux) | Il server vero, con Chromium su Xvfb, contro il sito di prova: interfaccia su `127.0.0.1:8480`, password `prova` (come root serve anche `--senza-sandbox`, e `FEBE_CHROMIUM` se Chromium non è nel `PATH`). Su Windows e macOS si ferma con un messaggio; anche con «Esegui comunque il debug» stampa solo l'aiuto |
| ⚠ Febe per Windows · Instagram vero (dati veri) | Febe senza opzioni: Instagram vero, `%LOCALAPPDATA%\Febe` e `Immagini\Febe`. Solo per le prove dal vivo di Alberto: chiede conferma, e una versione di sviluppo può aggiornare il database vero. Se Febe installato è aperto, prima esci da lui (menu dell'icona ▸ Esci): un solo Febe per cartella dei dati |
- **Dati di sviluppo.** Febe per Windows di sviluppo tiene dati e libreria in `%USERPROFILE%\FebeSviluppo\dati` e
`%USERPROFILE%\FebeSviluppo\libreria` (il server su Linux in `~/FebeSviluppo`): fuori dal repository e mai nella
@@ -80,6 +80,8 @@ La cartella `.vscode/` prepara VS Code per Febe: estensioni consigliate (C# Dev
- Attività (Terminale ▸ Esegui attività): `compila`, `prove` (`dotnet test tests/Febe.Tests`), `prove con filtro`
(chiede il filtro, per esempio `FullyQualifiedName~Febe.Tests.Docs`), `sito di prova`, `pubblica Febe.exe` (un file
solo in `out/pubblicazione/`, come `installer/costruisci.sh`) e `immagine Docker (serve Docker Desktop)`.
- I file di `.vscode/` sono JSON senza commenti, così li legge anche un lettore rigido come quello dei controlli della
CI: le spiegazioni stanno in questa sezione, nei campi `detail` delle attività e in `docs/decisioni.md`.
## Dimostrazione