tawasuyu/brahman

1# =============================================================================
2#  renaser :: manifiesto raíz del espacio de trabajo
3# -----------------------------------------------------------------------------
4#  Un único espacio de direccionamiento, una única verdad de versiones.
5#  Las dependencias se declaran aqui una sola vez y persisten, coherentes,
6#  a traves de todos los miembros del sistema.
7# =============================================================================
8
9[workspace]
10resolver = "2"
11# Solo `boot` es miembro del espacio de trabajo: corre en el anfitrion. El
12# kernel queda EXCLUIDO a proposito —es bare-metal puro y jamas debe compilarse
13# para el anfitrion— y se construye unica y exclusivamente como dependencia de
14# artefacto de `boot`, que le fija el target `x86_64-unknown-none`.
15members = ["boot"]
16# El kernel (bare-metal) y las apps WASM (target wasm32) se compilan aparte,
17# cada cual con su propio target; quedan fuera del espacio de trabajo.
18exclude = ["kernel", "apps"]
19
20# -----------------------------------------------------------------------------
21#  Metadatos compartidos: cada miembro hereda esta identidad con `*.workspace`.
22# -----------------------------------------------------------------------------
23[workspace.package]
24version = "0.1.0"
25edition = "2021"
26license = "MPL-2.0"
27authors = ["JL Soltech <gerencia@jlsoltech.com>"]
28description = "renaser :: kernel asincrono SASOS basado en aislamiento por software"
29
30# -----------------------------------------------------------------------------
31#  Dependencias del ecosistema. Reutilizamos infraestructura madura en lugar
32#  de reinventar boilerplate. `default-features = false` se aplica con bisturi,
33#  unicamente alli donde las features por defecto arrastrarian `std`.
34# -----------------------------------------------------------------------------
35[workspace.dependencies]
36# Constructor de la imagen de disco UEFI/BIOS. Es una herramienta de ANFITRION
37# (usa std), la consume el miembro `boot` y NO debe enlazarse jamas en el kernel.
38bootloader = "0.11"
39
40# API `#![no_std]` que el kernel SI consume: expone `entry_point!`, `BootInfo`
41# y la descripcion del framebuffer GOP. Su version debe acompasar a `bootloader`.
42bootloader_api = "0.11"
43
44# Abstraccion de la CPU x86_64: registros de control, GDT, IDT e instrucciones
45# privilegiadas sin ensamblador inline. Es `#![no_std]` de nacimiento; su
46# feature `instructions` (activa por defecto) nos da `hlt` y el control de IRQ.
47x86_64 = "0.15"
48
49# Rasterizacion de primitivas vectoriales sobre el framebuffer. `#![no_std]`,
50# sin heap: en la Fase 1 solo aporta el rasgo `DrawTarget` del lienzo.
51embedded-graphics = "0.8"
52
53# Rasterizador de tipografias. REQUIERE `alloc`, de modo que solo se teje en el
54# kernel una vez exista el asignador (Fase 2). `default-features = false`
55# silencia su feature `std`. Se declara ya para congelar la version.
56# `hashbrown` es lo que ACTIVA el modo `no_std` de fontdue; sin el, la crate
57# recae en `std::collections` y no compila para bare-metal. `simd` queda fuera:
58# nuestro target no tiene SSE.
59fontdue = { version = "0.9", default-features = false, features = ["hashbrown"] }
60
61# --- Fase 3 :: heap dinamico y reactor asincrono ---
62# Asignador del heap del kernel — algoritmo probado, configurado `no_std`.
63linked_list_allocator = "0.10"
64# Exclusion mutua sin sistema operativo: `Mutex` e inicializacion unica `Once`.
65spin = "0.9"
66# Cola lock-free, segura frente a interrupciones, para el canal de scancodes.
67crossbeam-queue = { version = "0.3", default-features = false, features = ["alloc"] }
68# Combinadores `Future`/`Stream` y `AtomicWaker`. Sin ejecutor ni I/O: solo
69# las piezas que renaser teje en su propio reactor.
70futures-util = { version = "0.3", default-features = false, features = ["alloc"] }
71
72# --- Fase 4 :: interprete WebAssembly para el userspace aislado ---
73# `wasmi` en modo bare-metal: sin `std`, sin `wat`, sin `simd` (el target no
74# tiene SSE). `hash-collections` le da mapas basados en hashbrown, `no_std`.
75wasmi = { version = "1.0", default-features = false, features = ["hash-collections"] }
76
77# -----------------------------------------------------------------------------
78#  Perfiles de compilacion. Cargo exige que los perfiles vivan en la RAIZ del
79#  espacio de trabajo. `panic = "abort"` es obligatorio: sin sistema operativo
80#  subyacente no hay desenrollado de pila (`unwinding`) posible.
81# -----------------------------------------------------------------------------
82[profile.dev]
83panic = "abort"
84
85[profile.release]
86panic = "abort"
87opt-level = "s"   # codigo compacto: cada byte cuenta en bare-metal
88lto = true        # el optimizador cruza fronteras de crate
89codegen-units = 1 # una sola unidad => maxima oportunidad de optimizacion