terminus.kernel

28 modules on bare metal — x86_64 and ARM64, TCP remote access

Architecture

┌─────────────────────────────────────────┐
│            Terminus Manager             │
│  - Hardware ownership                   │
│  - Kernel instance lifecycle            │
│  - Syscall routing per process          │
│  - Hot-swap: old drains, new activates  │
└──────┬──────────────────┬───────────────┘
       │                  │
  ┌────▼─────┐      ┌────▼─────┐
  │ Kernel v1 │      │ Kernel v2 │
  │ (draining) │      │ (active)  │
  └───────────┘      └──────────┘

Kernel Modules

Module	Purpose	Status
`serial.f`	UART COM1 driver	working
`gdt.f`	Global Descriptor Table	working
`pmm.f`	Physical memory manager (bitmap)	working
`heap.f`	Kernel heap (free-list)	working
`idt.f`	Interrupt Descriptor Table	working
`handlers.f`	ISR dispatch, PIC, timer/keyboard	working
`timer.f`	PIT at 100 Hz	working
`tss.f`	Task State Segment	working
`scheduler.f`	Round-robin cooperative scheduler	working
`tfs.f`	Filesystem (directories, variable-length names)	working
`virtio_blk.f`	Block device (VirtIO + ramdisk fallback)	working
`virtio_pci.f`	VirtIO block PCI driver	persistent
`manager.f`	Kernel instance registry, hot-swap	proven
`shell.f`	Interactive shell (22 commands)	working
`fcc.f`	In-kernel Foundation compiler	exec .f files
`capability.f`	Capability-based access control	working
`namespace.f`	Per-process filesystem namespaces	working
`preempt.f`	Preemptive scheduling (timer ISR)	working
`virtio_net.f`	VirtIO network card driver	working
`net_ip.f`	ARP + IPv4 + network polling	working
`net_tcp.f`	TCP state machine	working
`net_shell.f`	Remote shell over TCP :7777	proven

Boot Sequence

Power On → BIOS/UEFI → Limine bootloader → start.s → kmain()
  → serial → GDT → PMM → heap → IDT → interrupts → timer
  → TSS → scheduler → initrd → VirtIO disk → TFS mount
  → Manager → hot-swap demo → networking → preempt
  → spawn net shell (PID 1) → serial shell (PID 0)

Shell Commands

Two concurrent shells: serial (local) and TCP (port 7777, nc localhost 7777).

terminus> help
  ls, cat, write, append, replace, rm, mkdir
  exec, spawn, calc, run
  recv, send
  deploy, drain, ps, mem, status, uptime
  clear, halt

For AI Agents

Technical architecture: concept.md