Il Sentiero Minerale
I rilasci di Zenzic seguono il Sentiero Minerale — una tradizione che sceglie materiali geologici che rappresentano precisione, trasparenza e durabilità strutturale. Il nome di ogni versione non è decorativo: porta con sé una metafora materiale per il lavoro ingegneristico compiuto in quel ciclo.
La Filosofia
I tool di documentazione sono infrastruttura. L'infrastruttura deve essere:
- Difficile da rompere — come i minerali sotto compressione
- Trasparente — perché gli utenti possano vedere esattamente cosa fa e perché
- Precisa — nessuna ambiguità in ciò che rileva, segnala o rifiuta
Il Sentiero Minerale comunica che Zenzic è costruito per durare. Scegliamo materiali che si sono dimostrati affidabili su scale temporali geologiche, non cicli di marketing. Quando una versione prende il nome da un minerale, le proprietà fisiche di quel minerale descrivono le priorità ingegneristiche del rilascio.
La Roadmap
| Versione | Minerale | Era | Focus Ingegneristico |
|---|---|---|---|
| v0.6.x | Ossidiana | L'Era del Fuoco e della Crisi | Tagliente, vulcanica, nata dal collasso dell'integrazione MkDocs. Lo Shield, il Blood Sentinel e il primo output SARIF — strumenti di precisione forgiati sotto pressione estrema. |
| v0.7.x | Quarzo | L'Era della Chiarezza | Precisione piezoelettrica: trasparente, auto-oscillante, il riferimento per la misurazione del tempo e delle frequenze. Un nucleo stabile e verificabile — codici di finding, contratto dei codici di uscita, Virtual Site Map. |
| v0.8.x | Basalto | L'Era delle Fondamenta | Denso, vulcanico, usato per il rinforzo ad alta resistenza nelle costruzioni. Focus: Plugin SDK e performance su larga scala. |
| v0.9.x | Grafite | L'Era della Connettività | Altamente conduttiva — il ponte tra i sistemi. Focus: integrazioni di terze parti, API pubblica ed espansione dell'ecosistema. |
| v1.0.0 | Diamante | L'Era dell'Indistruttibilità | Il materiale naturale più duro. Focus: Long-Term Support, garanzie di stabilità e piena maturità. |
L'Origine dell'Ossidiana
Il primo rilascio stabile di Zenzic è stato chiamato Ossidiana deliberatamente. L'ossidiana è vetro vulcanico — formatosi sotto calore e pressione estremi, al confine tra roccia fusa e atmosfera. Il ciclo v0.6.x è stato esattamente questo: il collasso dell'architettura del plugin MkDocs originale, una riscrittura forzata e l'emergenza del modello Safe Harbor dalle macerie.
L'ossidiana è anche il materiale naturale più tagliente. Era il materiale dei primi strumenti chirurgici — lame capaci di incisioni più sottili di un bisturi moderno. Zenzic v0.6.x ha introdotto lo Shield (rilevamento credenziali), il Blood Sentinel (applicazione dell'isolamento path traversal) e il primo output SARIF. Strumenti di precisione, forgiati nel fuoco.
Lo Standard del Quarzo
Il quarzo è scelto per v0.7.x perché è il materiale geologico della misura del tempo di precisione. Gli oscillatori al quarzo sono la base di ogni orologio, ogni ricevitore GPS, ogni circuito digitale che deve sapere esattamente quando qualcosa accade.
Zenzic v0.7.x porta quello stesso standard all'analisi della documentazione:
- Codici di finding (
Zxxx) — identificatori stabili, leggibili dalle macchine, invarianti per versione - Output SARIF — compatibile con ogni piattaforma di scansione di sicurezza
- Contratto dei codici di uscita — deterministico, non sopprimibile per gli incidenti di sicurezza
- Virtual Site Map — una proiezione in memoria del sito finale, validata prima di qualsiasi build
Il quarzo non si piega. Il quarzo non mente. Il quarzo ti dice esattamente che ora è.
Oltre il Quarzo
Il Sentiero Minerale continua. Basalto, Grafite e Diamante non sono promesse — sono coordinate. Indicano a contributori e utenti che tipo di lavoro ingegneristico ogni ciclo prioritizza. I nomi non cambieranno a meno che non cambi la direzione ingegneristica.
Il Sentiero Minerale è anche una dichiarazione su ciò che Zenzic non è: un prodotto le cui versioni prendono il nome da città, animali o parole chiave di brand arbitrarie. Ogni nome su questo percorso ha un referente fisico nella terra. Ogni referente fisico ha proprietà che si mappano nel codice.
Se vuoi contribuire a un milestone specifico, il Registro Ingegneristico contiene il contesto dello sprint attivo e le decisioni architetturali in corso.