1# renaser
2
3**renaser** es un kernel asíncrono de *Espacio de Direccionamiento Único*
4(SASOS), escrito en Rust `#![no_std]` para x86_64 bare-metal.
5
6Es un sistema operativo disruptivo que rompe por completo con el paradigma
7POSIX de los años 70: no emula Linux, no usa archivos planos, no usa TTYs ni
8capas GNU. El aislamiento entre aplicaciones no descansa en la MMU ni en los
9anillos de privilegio de la CPU, sino en **límites matemáticos sobre el
10bytecode** — aislamiento por software (SFI). La interfaz es visual desde el
11primer microsegundo: el texto es, simplemente, un caso particular del dibujo.
12
13## Qué hace, hoy
14
15- Arranca por **UEFI** y adopta el framebuffer GOP con doble búfer sin parpadeo.
16- Se **autoempaqueta** en una imagen de disco UEFI y se lanza en QEMU.
17- Tiene **reflejos de fallo**: GDT/TSS, IDT y manejadores de excepción; si
18  colapsa, lo dibuja (franja roja de pánico, naranja de memoria agotada).
19- **Late con el hardware**: PIC remapeado, temporizador (PIT) y teclado.
20- Gestiona **memoria dinámica** (heap de 64 MiB, asignador global).
21- Ejecuta un **reactor asíncrono cooperativo** sobre los `Future` nativos de
22  Rust: las interrupciones no conmutan contexto, despiertan tareas.
23- Rasteriza **texto vectorial** al vuelo con `fontdue`.
24- Ejecuta un **userspace WebAssembly** aislado por capacidades (`wasmi`): las
25  aplicaciones solo tocan el mundo a través de funciones de host concedidas.
26
27## Construir y ejecutar
28
29Requisitos: `rustup` con toolchain nightly, QEMU y firmware OVMF.
30
31```sh
32cargo run
33```
34
35Compila el kernel para `x86_64-unknown-none`, forja la imagen de disco UEFI y
36abre QEMU. Ver `CLAUDE.md` para el resto de comandos y el flujo de la app WASM.
37
38## Documentación
39
40| Documento | Contenido |
41|---|---|
42| `ARCHITECTURE.md` | la arquitectura del sistema, subsistema a subsistema |
43| `ROADMAP.md` | fases completadas y plan de las siguientes |
44| `CLAUDE.md` | guía operativa: comandos, estructura y convenciones |
45
46## Licencia
47
48MPL-2.0