Starfish manual

What it is / interactive architecture

Starfish: Lightweight GPU-first research operating system

Starfish is the inspectable operating-system layer beneath Yeho applications, YUI interfaces, and permissioned Yodi control. This diagram follows current research from UEFI firmware through the compact kernel, FIT64 filesystem, userland, and first pixels while keeping the connected software route visible.

CAST / 02

Starfish field guide

Astra MireThe Void Cartographer
Open complete manual
Lightweight GPU-first research operating systemREV 03
100%
SHAPE KEY
Lightweight GPU-first research operating systemStarfish is the inspectable operating-system layer beneath Yeho applications, YUI interfaces, and permissioned Yodi control. This diagram follows current research from UEFI firmware through the compact kernel, FIT64 filesystem, userland, and first pixels while keeping the connected software route visible. Every station and route can be selected for more information.UEFI LOADER transfers exit boot services into HANDOFF ABI through a named, inspectable route.R01 / exit boot servicesHANDOFF ABI transfers RDI into KERNEL CORE through a named, inspectable route.R02 / RDIKERNEL CORE transfers machine lifecycle into MEMORY + SCHEDULER through a named, inspectable route.R03 / machine lifecycleKERNEL CORE transfers enumerate into DEVICE LADDER through a named, inspectable route.R04 / enumerateMEMORY + SCHEDULER transfers interrupt + task into DEVICE LADDER through a named, inspectable route.R05 / interrupt + taskDEVICE LADDER transfers blocks into BLOCK + VFS through a named, inspectable route.R06 / blocksDEVICE LADDER transfers frames into NETWORK + IPC through a named, inspectable route.R07 / framesBLOCK + VFS transfers mount into FIT64 VOLUME through a named, inspectable route.R08 / mountKERNEL CORE transfers ring 3 into SYSCALL + USERLAND through a named, inspectable route.R09 / ring 3FIT64 VOLUME transfers files into SYSCALL + USERLAND through a named, inspectable route.R10 / filesSYSCALL + USERLAND transfers UIX into UIX + YUI COMPOSITOR ROUTE through a named, inspectable route.R11 / UIXNETWORK + IPC transfers messages into SYSCALL + USERLAND through a named, inspectable route.R12 / messagesUEFI LOADER transfers images into HOST TOOLS + EVIDENCE through a named, inspectable route.R13 / imagesHOST TOOLS + EVIDENCE transfers format + verify into FIT64 VOLUME through a named, inspectable route.R14 / format + verifyDEVICE LADDER transfers display into UIX + YUI COMPOSITOR ROUTE through a named, inspectable route.R15 / displayFIT64 VOLUME transfers root volume into BOOT IMAGE + RESEARCH OS through a named, inspectable route.R16 / root volumeUIX + YUI COMPOSITOR ROUTE transfers visible surface into BOOT IMAGE + RESEARCH OS through a named, inspectable route.R17 / visible surfaceHOST TOOLS + EVIDENCE transfers package + admit into BOOT IMAGE + RESEARCH OS through a named, inspectable route.R18 / package + admitThe loader reads the kernel and modules, captures firmware state, exits boot services, and transfers control.INN0101 / FIRMWAREUEFILOADERIN 00InputOUT 02One aligned structure gives the kernel its image, memory, display, firmware, timer, module, and command-line facts.APIN0202 / CONTRACTHANDOFFABILittle-endian and 16-byte alignedIN 01BoundaryOUT 01The compact kernel establishes descriptors, exceptions, paging, allocation, interrupts, diagnostics, and core machine ownership.FXN0303 / CONTROLKERNELCOREIN 01ProcessOUT 03Physical pages, mappings, heaps, SMP bring-up, timers, tasks, blocking, waking, and time slices form the execution lifecycle.DBN0404 / LIFECYCLEMEMORY +SCHEDULERDirect map and 4 KiB mappingsIN 01State storeOUT 01Timers, input, PCI, storage, network, and display work enter through deliberately staged drivers.FXN0505 / HARDWAREDEVICELADDERPIC, APIC, PIT, PS/2, USB HIDIN 02ProcessOUT 03Controllers feed block devices, cache and queues, then VFS lookup and common file operations.FXN0606 / STORAGEBLOCK +VFSIN 01ProcessOUT 01FIT64 combines fixed 4 KiB blocks, extents, deterministic directories, feature flags, and a metadata write-ahead journal.DBN0707 / FORMATFIT64VOLUMESuperblock maps journal, metada...IN 02State storeOUT 02A small ring-3 route, descriptors, pipes, libc-like helpers, init, and shell establish the user boundary.APIN0808 / PROCESSSYSCALL +USERLANDWrite, exit, sleep, open, read,...IN 03BoundaryOUT 01Early network demonstration, pipes, and UIX IPC expose message and byte-stream paths beyond direct kernel calls.FXN0909 / MESSAGESNETWORK +IPCIN 01ProcessOUT 01Current UIX helpers prove the early compositor seam; YUI is the owned semantic interface system intended to sit above Starfish window, input, text, accessibility, graphics, and presentation providers.OUTN1010 / PIXELSUIX + YUICOMPOSITOR ROUTEFramebuffer-first bring-upIN 02OutputOUT 01Host tools build, inspect, corrupt, recover, and package images so filesystem and boot claims can be repeated outside the kernel.QAN1111 / LABHOST TOOLS+ EVIDENCEIN 01EvidenceOUT 02Boot folders, VHDs, raw images, kernel modules, FIT64 volumes, and evidence combine into the current x86_64 research artifact.OUTN1212 / OUTPUTBOOT IMAGE+ RESEARCH OSUEFI bootable delivery formsIN 03OutputOUT 00DHL-VISUAL-PROGRAM / STARFISH / REV 04VARIABLE NODES / DISTRIBUTED PORTS / INSPECTABLE CONTRACTS