# Terminus Kernel

The Terminus kernel is a bare-metal Foundation kernel targeting x86_64 and ARM64. It demonstrates boot, memory management, interrupts, scheduling, storage, networking, HTTP, display, USB/xHCI, NVMe, in-kernel compilation, and a hot-swap Manager model.

## Current Verified State

- x86_64 QEMU boot reaches serial shell.
- Ramdisk/no-network boot disables network services instead of page faulting.
- VirtIO-net boot starts TCP shell on port 7777 and HTTP server on port 8080.
- Initrd loads and reads files.
- TFS mounts on ramdisk and VirtIO disk.
- Limine memory map, PMM, heap, IDT, timer, TSS, scheduler, and preemption initialize.
- xHCI initializes far enough for NOOP command and port scan in QEMU.
- NVMe driver identifies a QEMU namespace, but deeper read/write verification remains debt.
- Capability and namespace modules exist, but enforcement is not complete yet.

## Important Commands

```bash
cd kernel && make all
cd kernel && timeout 12s make run-ramdisk
cd kernel && timeout 10s make run
```

Full expected output markers are in `VERIFICATION.md`.

## Public Markdown

- `https://kernel.terminus.worldapi.org/md/concept.md`
- `https://terminus.worldapi.org/md/security.md`
- `https://terminus.worldapi.org/md/networking.md`

## Agent Rule

Treat `STATUS.md` and `VERIFICATION.md` as the source of truth. If a subsystem is only scaffolded or compile-verified, do not call it enforced or proven.