# Terminus

Terminus is an AI-native operating system project. It includes the Foundation language, a self-hosting compiler, a bare-metal kernel, a hot-swap Manager architecture, storage, networking, HTTP, display work, xHCI/NVMe drivers, and capability/namespace security scaffolding.

## Current Verified State

- Bootstrap compiler regression suite: 13/13 tests.
- Self-hosting compiler: proven across three generations.
- x86_64 kernel: boots in QEMU.
- Ramdisk/no-network boot: reaches serial shell and disables network services cleanly.
- VirtIO-net boot: starts TCP shell on port 7777 and HTTP server on port 8080.
- Kernel modules: 48 Foundation modules plus manual assembly.
- Security: capability and namespace scaffolds exist; enforcement is not complete yet.

## Important Local Docs

- Project entrypoint: `README.md`
- Status: `STATUS.md`
- Verification ledger: `VERIFICATION.md`
- Architecture: `library.md/concept.md`
- Foundation spec: `library.md/foundation.md`
- Security model: `library.md/security.md`
- Display notes: `library.md/display.md`
- Networking notes: `library.md/networking.md`

## Public Markdown

- `https://terminus.worldapi.org/md/preamble.md`
- `https://terminus.worldapi.org/md/concept.md`
- `https://terminus.worldapi.org/md/security.md`
- `https://terminus.worldapi.org/md/display.md`
- `https://terminus.worldapi.org/md/networking.md`
- `https://foundation.terminus.worldapi.org/md/foundation.md`

## Agent Rule

Do not trust homepage claims alone. Check `STATUS.md` and `VERIFICATION.md`, then run the listed proof commands before extending a proven claim.