Provides a reproducible Debian-based build environment with:
- Clang + LLD for cross-compilation to i386-elf targets
- GRUB 2 tools (grub-pc-bin, xorriso, mtools) for bootable
ISO and floppy image generation
- QEMU (i386) for integration test execution
- CMake + Ninja for the build system
The Dockerfile includes a self-test that verifies Clang + lld can
produce a valid ELF 32-bit i386 binary before the image is accepted.
Set up the project directory structure as specified in the README:
- apps/: for application source code (e.g. ls, sh)
- docs/: for subsystem documentation
- libs/: for shared libraries used by apps and/or the kernel
- src/: for kernel source code
- src/it/: for integration tests
- vendor/: for 3rd-party source code (AI will not modify this)
The build/ directory is excluded via .gitignore as it contains only
build artifacts. ISO and floppy image files are also gitignored.