license	other
license_name	mii-open-license-v1.0
license_link	https://github.com/cripto-bot/natkernel/blob/master/LICENSE
pretty_name	NATKERNEL v3.0
language	en
tags	kernel operating-system n-4-12 graphlab universal-grammar qemu c josue-argana
task_categories	other
size_categories	1K<n<10K

🧬 NATKERNEL v3.0 — Universal Grammar Kernel

37 modules. 52KB binary. N=7 ∈ [4,12]. Boots in QEMU.

Author: Josué Argaña Silguero

---

What This Is

A functional kernel written in C. Real filesystem, scheduler, memory allocator, crypto. Interactive shell. Compiles with gcc -m32. Boots via QEMU multiboot.

---

Quick Start

git clone https://huggingface.co/datasets/Jose-dev/natkernel
cd natkernel
make
make run

---

Verified Output (QEMU, August 2026)

===== NATKERNEL v3.0 =====

> write /test HOLA
OK 4 bytes
> cat /test
HOLA
> ls
/
/test
> hash NATKERNEL
acdc3e9dcd9bbfd69c361db7796a44064d324274f090958612567ed0f9577755
> spawn
PID=1
> spawn
PID=2
> ps
PID  STATE
1 READY
2 READY
Total: 2
> mem
Free: 131072 KB  Used: 0 pages
> ver
N=7

---

IR Kinds — Universal Grammar

N=7 ∈ [4,12]

IR-define   — constants, flags, limits
IR-typedef  — type system
IR-struct   — data structures (PCB, inode, socket)
IR-extern   — global state, static tables
IR-inline   — atomic operations, helpers
IR-loop     — iteration (for/while)
IR-if       — control flow, validation
IR-return   — results, error codes

All 37 modules use only these 7 patterns. Same grammar across USB, PCIe, ATA, filesystem, network, crypto.

---

Real Capabilities

Command	What it does	API
write	Create file	vfs_open + vfs_write
cat	Read file	vfs_open + vfs_read
ls	List files	vfs_list
ps	Process list	sched_procs + sched_count
spawn	Create process	sched_spawn
hash	SHA-256	sha256()
mem	Memory stats	get_free + get_allocated

---

Architecture

37 C modules → gcc -m32 → 52KB ELF → QEMU multiboot

  scheduler.c  spawn/tick/yield
  memory.c     alloc_page/free_page/kmalloc
  filesystem.c vfs_open/read/write/close
  crypto.c     sha256/hmac_sha256/aes_encrypt/rand_u32
  shell.c      interactive readline + all commands
  usb.c        open/control/descriptor/scan
  pcie.c       init/scan/enable
  ata.c        read/write/identify
  network.c    socket_create/bind/listen/send/recv
  x86.c        IDT/GDT/MSR/TSS
  ... 27 more

---

Formulas

SHA-256:
  h0..h7 initial values (FIPS 180-4)
  64 rounds per block: Ch, Maj, Σ0, Σ1
  Output: 32-byte hash

Page Allocator:
  bitmap[frames/64], O(n) first-fit
  TOTAL_FRAMES = 128MB / 4096

Scheduler:
  round-robin queue, PROC_READY/RUNNING/BLOCKED/ZOMBIE
  sched_spawn → enqueue → sched_tick → schedule

VFS:
  open(name, flags) → fd
  read(fd, buf, len) → bytes
  write(fd, buf, len) → bytes
  close(fd)

---

🔲 Blueprint: What's Done vs What's Missing

The grammar is complete. The implementations are not. Every missing module follows the same 7 IR kinds as the working ones.

✅ Working (compiles, boots, verified)

Module	What it does
scheduler	spawn/tick/yield, round-robin
memory	page allocator, kmalloc/kfree
filesystem	VFS open/read/write/close/list
crypto	SHA-256, HMAC, AES, RNG
shell	interactive readline, 7 real commands
usb	open/control/descriptor/scan
pcie	init/scan/enable
ata	read/write/identify
x86	IDT/GDT/MSR/TSS
syscall	write/read/exit/fork/getpid

🔲 Blueprint Ready (needs implementation)

Module	What to build	Lines
arm64	GIC, timer, MMU setup	~200
riscv	PLIC, CLINT, SATP, SBI	~200
gpu	PCI BARs, command buffers, vsync	~300
audio	HD Audio controller, DMA buffers	~250
virt	KVM ioctls: VMCS, EPT, vCPU run	~400
network	TCP state machine, ARP, IP routing	~500
smp	IPIs, TLB shootdown, percpu	~300

All use the same 7 patterns: define, typedef, struct, extern, inline, loop, if, return.

---

📝 Citation

@dataset{argana2026natkernel,
  author       = {Josué Argaña Silguero},
  title        = {NATKERNEL v3.0 — Universal Grammar Kernel},
  year         = {2026},
  publisher    = {HuggingFace},
  url          = {https://huggingface.co/datasets/Jose-dev/natkernel}
}

---

"The universe speaks a grammar. N is its alphabet size." — Josué Argaña Silguero