Progetto
Supporto e versioni
Come si numerano le versioni di MentorAgent, quali ricevono ancora correzioni, come gestiamo una vulnerabilità e dove chiedere.
Versioni
MentorAgent segue Semantic Versioning 2.0.0 dalla 1.0.0. La versione corrente è la 1.2.0.
- Major
- Un cambio che rompe il contratto pubblico. Solo qui.
- Minor
- Funzioni nuove, compatibili con la stessa major.
- Patch
- Correzioni, nient'altro.
Cinque pacchetti, una versione
Escono insieme, e ognuno richiede gli altri esattamente alla stessa versione. Si aggiornano insieme.
Novior.MentorAgentNovior.MentorAgent.AbstractionsNovior.MentorAgent.BlazorNovior.MentorAgent.ServerNovior.MentorAgent.Declarative
Cosa copre il contratto
- l'API C# pubblica dei cinque pacchetti;
- i metodi e gli eventi dell'hub, i frame SSE e gli endpoint HTTP documentati;
- i nomi dei tool che la libreria dà al modello;
- le chiavi di configurazione documentate.
Cosa non copre
- quello che dice il modello, o quale tool sceglie in un turno;
- il testo dei prompt che la libreria costruisce;
- i messaggi di log: il prefisso della categoria
Novior.MentorAgentè stabile, il testo dopo no.
Dipendenze
Una minor può portare i pacchetti Microsoft a una linea compatibile più nuova. I pacchetti del provider AI li scegli tu.
Cosa è cambiato
Ogni pacchetto contiene tutto il CHANGELOG.md, e lo storico delle versioni della documentazione le ha tutte.
Finestra di supporto
MentorAgent gira su .NET 10. Quando esce una versione nuova, quella prima non si ferma subito: riceve ancora le correzioni di sicurezza per un periodo.
| Versione | Riceve | Per quanto |
|---|---|---|
| L'ultima minoroggi la 1.2.x | Tutte le correzioni | Fino alla minor successiva |
| La minor precedenteoggi la 1.1.x, fino al 27/01/2027; la 1.0.x fino al 21/01/2027 | Correzioni di sicurezza | 3 mesi dall'uscita della minor successiva |
| La major precedenteancora nessuna: la 1.x è la prima | Correzioni di sicurezza | 6 mesi dall'uscita della major successiva |
| Versioni più vecchie, anteprime e release candidate | Niente | Aggiorna a una versione supportata |
Sicurezza
Hai trovato una vulnerabilità? Scrivi in privato a security@mentoragent.net, mai in una segnalazione pubblica. La pagina Sicurezza dice cosa scrivere.
La prendiamo in carico
Entro 5 giorni lavorativi confermiamo di averla ricevuta e cominciamo a guardarla.
La correggiamo
Nelle versioni supportate, appena possibile. È best effort: nessun tempo garantito per la correzione.
Lo diciamo in pubblico
Quando esce la correzione, un GitHub Security Advisory (sito esterno) e lo storico delle versioni dicono cosa era colpito e quale versione installare.
La politica completa, con come si costruiscono e si verificano le versioni, è in SECURITY.md (sito esterno) su GitHub.
Dove chiedere
Cerca prima nelle segnalazioni e nelle discussioni: la risposta potrebbe esserci già.
-
Una domanda su come usarla
GitHub Discussions (sito esterno), nella categoria Q&A.
-
Un bug
Qualcosa non funziona come è documentato: una segnalazione (sito esterno) con il modulo Bug report.
-
Una funzione che ti serve
Una segnalazione (sito esterno) con il modulo Feature request.
-
Una vulnerabilità
In privato, mai in pubblico: security@mentoragent.net.
Rispondiamo come possiamo, senza tempi di risposta garantiti. La sezione di aiuto della documentazione copre i problemi più comuni.
