docs: comprehensive README with build history and verification

README.md

@@ -1,3 +1,91 @@
-# alfred-linux
+# Alfred Linux
 
-Alfred Linux - AI-Native OS
+**The AI-Native Operating System**
+
+Alfred Linux is a complete operating system where AI IS the interface. Voice-first, post-quantum encrypted, token-incentivized, everything-connected. Not a distro with a chatbot — the AI IS the OS.
+
+## Build Status
+
+| Build | Version | Status | ISO Size |
+|-------|---------|--------|----------|
+| RC1   | 2.0     | ✅ Built | 2.4 GB  |
+| RC2   | 2.0     | ✅ Built | 2.4 GB  |
+| RC3   | 2.0     | ✅ Built & Bootable | 2.5 GB |
+| RC4   | 3.0     | ✅ Built | 2.4 GB  |
+| RC5   | 3.0     | ✅ Built | 2.4 GB  |
+| RC6   | 4.0     | ✅ Built | 2.4 GB  |
+| RC7   | 4.0     | ✅ Built | 2.3 GB  |
+| RC8   | 4.0     | ✅ Built & Current | 2.4 GB |
+
+**10 ISOs built. 8 release candidates shipped.**
+
+## What's Included
+
+- **Kernel 6.1.0 LTS** (Debian stable, hardened)
+- **Alfred IDE** — code-server 4.114.0 with Commander extension
+- **Alfred Voice** — Kokoro TTS engine (offline, no cloud)
+- **Alfred Search** — Meilisearch instant search (offline)
+- **Calamares Installer** — graphical install to disk
+- **Post-quantum cryptography** — Kyber-1024 (ML-KEM-1024) ready
+- **ClamAV** antivirus, UFW firewall, AppArmor MAC
+- **Full offline capability** — no cloud dependency
+
+## Building
+
+```bash
+# Requires: Debian 12+ host, live-build, root/sudo
+cd scripts/
+sudo ./build-unified.sh
+```
+
+The build script is self-contained — it generates the complete ISO from a Debian base using live-build with custom hooks.
+
+### Build Hooks (executed in order)
+
+1. **Branding** — Plymouth splash, wallpaper, GRUB theme, login screen
+2. **Browser** — Installs Alfred Browser (Chromium fork)
+3. **IDE** — Installs code-server + Alfred Commander extension
+4. **Voice** — Installs Kokoro TTS engine + voice models
+5. **Search** — Installs Meilisearch + prebuilt indexes
+6. **Installer** — Configures Calamares graphical installer
+
+### Critical Boot Fix (discovered RC2→RC3)
+
+Two kernel-naming hooks are required:
+- `9999-fix-kernel-names.hook.chroot` — creates generic kernel names in `/boot/`
+- `9999-fix-kernel-names.hook.binary` — creates generic names in `binary/live/` after lb copies versioned files
+
+Without both, the ISO boots to a kernel panic. See `scripts/build-unified.sh` for details.
+
+## Build Server
+
+ISOs are built on a dedicated EU build server:
+- 8 cores, 32 GB RAM
+- Debian Bookworm host
+- Isolated build environment (clean chroot each run)
+
+## Verification
+
+```bash
+# Download ISO
+wget https://alfredlinux.com/downloads/alfred-linux-4.0-rc8-amd64.iso
+
+# Verify SHA-256
+sha256sum alfred-linux-4.0-rc8-amd64.iso
+# Expected: 647e56fd433da2322f5d5ed3e0122d19fec85604f65dee9a129940f06f877c02
+
+# Boot in QEMU
+qemu-system-x86_64 -m 4096 -cdrom alfred-linux-4.0-rc8-amd64.iso -boot d
+```
+
+## License
+
+AGPL-3.0 — see [LICENSE](LICENSE)
+
+## Links
+
+- **Website:** https://alfredlinux.com
+- **Download:** https://alfredlinux.com/download
+- **Releases:** https://alfredlinux.com/releases
+- **Security:** https://alfredlinux.com/security
+- **Company:** https://gositeme.com (GoSiteMe Inc.)