-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Welcome to the technical documentation for Melina. This Wiki is dedicated to explaining the inner workings, engineering decisions, and architectural paths taken to build this automated kernel fallback shield.
If you are looking for basic installation and usage instructions, please refer to the main repository README.md.
Architecture & Design Decisions - Understand why and how Melina was built, including the "Fail Fast" principle and our technology stack.
Core Components - Deep dive into the CLI orchestrator, the bash engine, and ALPM hooks.
The Recovery Protocol - A technical breakdown of the restore command and the mechanism of temporarily disarming the shield.
Melina was born from a specific, critical problem: hardware or software crashes during active disk I/O operations by the package manager.
When a Linux system loses power or crashes while pacman is writing a new kernel (vmlinuz) or building an initramfs, the resulting files on the EFI System Partition (ESP) are often corrupted or left with zero bytes. Melina's philosophy is proactive isolation: backing up the known-working state milliseconds before the destructive transaction begins.