high-cde/ZDOS
Repository principale dell'ecosistema ZDOS, con componenti Python, documentazione e moduli di automazione. - high-cde/ZDOS
0 stars · 0 forks
README
ZDOS · ecosistema operativo, runtime e strumenti
ZDOS è un ecosistema in costruzione: una distribuzione Linux minimale, un prototipo bare-metal x86_64, il runtime linguistico Zlang, strumenti di sviluppo, servizi di rete e un portale operativo. Ogni capacità viene dichiarata soltanto quando esistono codice, test e una prova osservabile.
🧭 Mappa dell’ecosistema
flowchart LR A[📝 Zlang source] --> B[⚙️ Zlang compiler] B --> C[🧩 ZLB2 v2.5 bytecode] C --> D[🧠 ZDOS bare metal] D --> E[💿 GRUB ISO] E --> F[🖥️ QEMU + CI] G[🐧 ZDOS Linux] --> H[📦 BusyBox + initramfs] H --> I[🌐 DHCP + persistence] J[🛰️ ZDOS-SEC-PORTAL] --> K[🔌 Socket.IO + APIs] D -. runtime .-> J G -. future services .-> J
Loading
✅ Cosa è verificato oggi
Percorso Stato Prova
🐧 ZDOS Linux ISO live x86_64 con kernel Linux bootstrap, BusyBox, initramfs, account base, DHCP opzionale e persistenza /dev/vda1 distro/build.sh + boot QEMU con ZDOS_READY
🧠 ZDOS bare-metal Kernel freestanding x86_64, GRUB Multiboot2 e runtime Zlang incorporato GitHub Actions + os/x86_64/tools/verify_qemu.sh
⚙️ Zlang Compilatore ZLB2 v2.5 e contratto bytecode verificato Repository Zlang
🛰️ SEC Portal HUD web, feed sociale, ledger locale e stream Socket.IO Repository ZDOS-SEC-PORTAL
🚀 Avvio rapido ZDOS Linux git clone https://github.com/high-cde/ZDOS.git cd ZDOS ./distro/build.sh ./distro/test-qemu.sh La build produce distro/build/zdos-linux-x86_64.iso. Per avviare manualmente la console: qemu-system-x86_64 \ -cdrom distro/build/zdos-linux-x86_64.iso \ -serial stdio -display none La milestone Linux include l’utente zdos, il tentativo DHCP su eth0 e il mount opzionale di /dev/vda1 su /mnt/data. La procedura completa è descritta in distro/README.md. Prototipo ZDOS x86_64 + Zlang Per la catena bare-metal, clonare Zlang accanto a ZDOS: git clone https://github.com/high-cde/Zlang.git ../Zlang cd os/x86_64 make clean make verify sh tools/verify_qemu.sh L’output seriale atteso è: ZDOS x86_64 bootstrap Zlang runtime ZLB2 v2.5 ready ZDOS: native Zlang program executed ZDOS: Zlang halted cleanly
📂 Struttura del repository
Area Responsabilità Documentazione
distro/ Build della distro Linux, root filesystem, initramfs e test QEMU distro/README.md
os/x86_64/ Kernel bare-metal sperimentale e runtime ZLB2 v2.5 os/x86_64/README.md
core/ Cortex, AAAK, memoria e componenti di ricerca docs/docs/overview.md
network/ Nodi e servizi distribuiti docs/docs/nodes.md
interface/ CLI, web dashboard e cloud interface interface/web/README.md
os/ghostnet/ Ricerca e componenti del sottosistema Ghostnet os/ghostnet/README.md
dev/zen/ Toolchain e automazione per lo sviluppo dev/zen/README.md
docs/ Architettura, operazioni, roadmap e contratti docs/README.md
🛡️ Confini e sicurezza ZDOS non deve essere presentato come una distro general-purpose completa finché non dispone di package manager, installer, aggiornamenti firmati, gestione utenti completa, filesystem persistente verificato, rete configurabile e test hardware. La base attuale è una milestone reale e avviabile, ma alcune componenti restano sperimentali. Il portale SEC contiene endpoint che avviano processi di build e, nel codice attuale, una password di sviluppo hard-coded. Non esporre il portale su Internet senza autenticazione reale, secret tramite environment, rate limiting, validazione degli URL, sandbox del compilatore e audit degli eventi. Vedere la documentazione del portale SEC prima di un deployment. 📚 Documentazione essenziale
Documento Scopo
docs/ECOSYSTEM.md Mappa dei repository e contratti tra i componenti
docs/OPERATIONS.md Build, boot, CI, troubleshooting e release
ARCHITECTURE.md Architettura generale del monorepo
CONTRIBUTING.md Workflow di contributo
SECURITY.md Segnalazioni e principi di sicurezza
Profilo ZLB2 v2.5 Contratto tra compilatore Zlang e runtime ZDOS
ZDOS-SEC-PORTAL Portale HUD e API operative
🤝 Contribuire Prima di proporre una nuova capacità, descrivere il contratto, il limite, l’errore atteso, il test positivo e almeno un test negativo. Le modifiche devono mantenere il linguaggio visuale dell’ecosistema: sezioni leggibili, badge coerenti, diagrammi quando chiariscono l’architettura e limiti dichiarati senza ambiguità. git checkout -b docs/nome-della-modifica
modifica, verifica link e test locali
git diff --check git commit -m "docs: descrivi la nuova capacità" git push origin docs/nome-della-modifica 📜 Licenza Questo progetto è distribuito secondo la licenza indicata in LICENSE.ZDOS · Zlang · ZDOS-SEC · Build what you can prove. ✨