# skyposer/poseros architecture

> Architecture diagram of the GitHub repository skyposer/poseros, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/skyposer/poseros
- Repository: https://github.com/skyposer/poseros

## Overview

PoserOS is a 32-bit BIOS-booted operating system. Its user-facing path centers on the shell: user commands use the kernel API, which enters through interrupt/syscall handling and reaches filesystem and process services. The tree also contains standalone assembly, DawnVM, and package utilities, plus memory, interrupt, and device layers. The README documents FatFs and the OS platform; source excerpts do not establish the full boot sequence or all utility-to-runtime relationships, so those links are omitted rather than inferred.

Main entry points: [`src/API-LIB/Pstd/pstd_init.h`](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_init.h) (Kernel Initialization), [`src/API-LIB/Pstd/pstd_kapi.h`](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_kapi.h) (Kernel API), [`src/API-LIB/Pstd/pstd_proc.h`](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_proc.h) (Process Management), [`src/API-LIB/Pstd/pstd_idt.h`](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_idt.h) (Interrupts and I/O)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_kernel["Kernel Core"]
  node_kernel_entry["Kernel Entry<br/>[kernel.c]"]
  node_kernel_init["Kernel Initialization<br/>[pstd_init.h]"]
  node_syscalls["Syscall Dispatch<br/>[pstd_syscall.h]"]
  node_kapi["Kernel API<br/>[pstd_kapi.h]"]
  node_processes["Process Management<br/>[pstd_proc.h]"]
  node_memory["Memory Management<br/>[pstd_pmm.h]"]
  node_paging["Virtual Memory<br/>[pstd_paging.h]"]
end

subgraph group_platform["Hardware Platform"]
  node_hardware["Interrupts and I/O<br/>[pstd_idt.h]"]
  node_console["Console and Keyboard<br/>[pstd_io.h]"]
  node_e820["Memory Map<br/>[pstd_e820.h]"]
end

subgraph group_storage["Storage"]
  node_filesystem_api["Filesystem API<br/>[pstd_fs.h]"]
  node_fatfs["FatFs<br/>[ff.c]"]
  node_disk_io["Disk I/O<br/>[diskio.c]"]
end

subgraph group_apps["User Programs"]
  node_shell["Poser Shell<br/>[shell.c]"]
  node_editor_style["Editor Styling<br/>[edstyle.c]"]
  node_pack["Package Handling<br/>[pack.c]"]
  node_package_runner["Package Runner<br/>[runpack.c]"]
  node_package_builder["Package Builder<br/>[mkpack.py]"]
end

subgraph group_dawn["Dawn Tools"]
  node_assembler["DASM Assembler<br/>[dasm.c]"]
  node_limasm["LIM Assembler<br/>[limasm.c]"]
  node_dawn_vm["DawnVM Runtime<br/>[dawnvm.c]"]
  node_dawn_format["Dawn Bytecode Format<br/>[dwn.h]"]
  node_dawn_compiler["Dawn Bytecode Tool<br/>[dawnbc.c]"]
  node_dawn_runner["Dawn Runner<br/>[rundwn.c]"]
end

node_user(("User"))

node_user -.->|"uses"| node_shell
node_shell -->|"calls"| node_kapi
node_kapi -->|"traps to"| node_syscalls
node_hardware -->|"dispatches"| node_syscalls
node_kernel_entry -->|"includes API"| node_kernel_init
node_kernel_init -->|"initializes"| node_hardware
node_kernel_init -->|"initializes"| node_filesystem_api
node_kernel_init -->|"initializes"| node_processes
node_kernel_init -->|"initializes"| node_memory
node_hardware -->|"feeds keys"| node_console
node_processes -->|"allocates mappings"| node_paging
node_processes -->|"checks access"| node_filesystem_api
node_paging -->|"uses frames"| node_memory
node_memory -->|"reads regions"| node_e820
node_filesystem_api -->|"calls"| node_fatfs
node_fatfs -->|"uses driver"| node_disk_io
node_shell -->|"uses"| node_editor_style
node_assembler -->|"uses format"| node_dawn_format
node_dawn_vm -->|"uses format"| node_dawn_format
node_dawn_compiler -->|"uses format"| node_dawn_format
node_dawn_runner -->|"calls"| node_kapi
node_package_runner -->|"uses package code"| node_pack
node_package_runner -->|"calls"| node_kapi

click node_kernel_entry "https://github.com/skyposer/poseros/blob/main/src/kernel.c"
click node_kernel_init "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_init.h"
click node_syscalls "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_syscall.h"
click node_kapi "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_kapi.h"
click node_processes "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_proc.h"
click node_memory "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_pmm.h"
click node_paging "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_paging.h"
click node_hardware "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_idt.h"
click node_console "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_io.h"
click node_e820 "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_e820.h"
click node_filesystem_api "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_fs.h"
click node_fatfs "https://github.com/skyposer/poseros/blob/main/src/API-LIB/FatFs/ff.c"
click node_disk_io "https://github.com/skyposer/poseros/blob/main/src/API-LIB/FatFs/diskio.c"
click node_shell "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/poser_shell/shell.c"
click node_editor_style "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/poser_shell/edstyle.c"
click node_assembler "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/dasm/dasm.c"
click node_limasm "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/limasm/limasm.c"
click node_dawn_vm "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/dawnvm/dawnvm.c"
click node_dawn_format "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/dawnvm/dwn.h"
click node_dawn_compiler "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/dawnvm/dawnbc.c"
click node_dawn_runner "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/rundwn/rundwn.c"
click node_pack "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/pack/pack.c"
click node_package_runner "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/runpack/runpack.c"
click node_package_builder "https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/pack/mkpack.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_kernel_entry,node_kernel_init,node_syscalls,node_kapi,node_processes,node_memory,node_paging,node_user toneBlue
class node_hardware,node_console,node_e820 toneAmber
class node_filesystem_api,node_fatfs,node_disk_io toneMint
class node_shell,node_editor_style,node_pack,node_package_runner,node_package_builder toneRose
class node_assembler,node_limasm,node_dawn_vm,node_dawn_format,node_dawn_compiler,node_dawn_runner toneIndigo
```

## Components

### Kernel Core

- [Kernel Entry](https://github.com/skyposer/poseros/blob/main/src/kernel.c): `src/kernel.c`
- [Kernel Initialization](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_init.h): `src/API-LIB/Pstd/pstd_init.h`
- [Syscall Dispatch](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_syscall.h): `src/API-LIB/Pstd/pstd_syscall.h`
- [Kernel API](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_kapi.h): `src/API-LIB/Pstd/pstd_kapi.h`
- [Process Management](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_proc.h): `src/API-LIB/Pstd/pstd_proc.h`
- [Memory Management](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_pmm.h): `src/API-LIB/Pstd/pstd_pmm.h`
- [Virtual Memory](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_paging.h): `src/API-LIB/Pstd/pstd_paging.h`

### Hardware Platform

- [Interrupts and I/O](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_idt.h): `src/API-LIB/Pstd/pstd_idt.h`
- [Console and Keyboard](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_io.h): `src/API-LIB/Pstd/pstd_io.h`
- [Memory Map](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_e820.h): `src/API-LIB/Pstd/pstd_e820.h`

### Storage

- [Filesystem API](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Pstd/pstd_fs.h): `src/API-LIB/Pstd/pstd_fs.h`
- [FatFs](https://github.com/skyposer/poseros/blob/main/src/API-LIB/FatFs/ff.c): `src/API-LIB/FatFs/ff.c`
- [Disk I/O](https://github.com/skyposer/poseros/blob/main/src/API-LIB/FatFs/diskio.c): `src/API-LIB/FatFs/diskio.c`

### User Programs

- [Poser Shell](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/poser_shell/shell.c): `src/API-LIB/Bin/poser_shell/shell.c`
- [Editor Styling](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/poser_shell/edstyle.c): `src/API-LIB/Bin/poser_shell/edstyle.c`
- [Package Handling](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/pack/pack.c): `src/API-LIB/Bin/pack/pack.c`
- [Package Runner](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/runpack/runpack.c): `src/API-LIB/Bin/runpack/runpack.c`
- [Package Builder](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/pack/mkpack.py): `src/API-LIB/Bin/pack/mkpack.py`

### Dawn Tools

- [DASM Assembler](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/dasm/dasm.c): `src/API-LIB/Bin/dasm/dasm.c`
- [LIM Assembler](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/limasm/limasm.c): `src/API-LIB/Bin/limasm/limasm.c`
- [DawnVM Runtime](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/dawnvm/dawnvm.c): `src/API-LIB/Bin/dawnvm/dawnvm.c`
- [Dawn Bytecode Format](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/dawnvm/dwn.h): `src/API-LIB/Bin/dawnvm/dwn.h`
- [Dawn Bytecode Tool](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/dawnvm/dawnbc.c): `src/API-LIB/Bin/dawnvm/dawnbc.c`
- [Dawn Runner](https://github.com/skyposer/poseros/blob/main/src/API-LIB/Bin/rundwn/rundwn.c): `src/API-LIB/Bin/rundwn/rundwn.c`

### Other components

- **User**

## Connections

- User → Poser Shell: uses
- Poser Shell → Kernel API: calls (evidence: `src/API-LIB/Bin/poser_shell/shell.c`)
- Kernel API → Syscall Dispatch: traps to (evidence: `src/API-LIB/Pstd/pstd_kapi.h`)
- Interrupts and I/O → Syscall Dispatch: dispatches (evidence: `src/API-LIB/Pstd/pstd_idt.h`)
- Kernel Entry → Kernel Initialization: includes API (evidence: `src/kernel.c`)
- Kernel Initialization → Interrupts and I/O: initializes (evidence: `src/API-LIB/Pstd/pstd_init.h`)
- Kernel Initialization → Filesystem API: initializes (evidence: `src/API-LIB/Pstd/pstd_init.h`)
- Kernel Initialization → Process Management: initializes (evidence: `src/API-LIB/Pstd/pstd_init.h`)
- Kernel Initialization → Memory Management: initializes (evidence: `src/API-LIB/Pstd/pstd_init.h`)
- Interrupts and I/O → Console and Keyboard: feeds keys (evidence: `src/API-LIB/Pstd/pstd_idt.h`)
- Process Management → Virtual Memory: allocates mappings (evidence: `src/API-LIB/Pstd/pstd_proc.h`)
- Process Management → Filesystem API: checks access (evidence: `src/API-LIB/Pstd/pstd_proc.h`)
- Virtual Memory → Memory Management: uses frames (evidence: `src/API-LIB/Pstd/pstd_paging.h`)
- Memory Management → Memory Map: reads regions (evidence: `src/API-LIB/Pstd/pstd_pmm.h`)
- Filesystem API → FatFs: calls (evidence: `src/API-LIB/Pstd/pstd_fs.h`)
- FatFs → Disk I/O: uses driver (evidence: `src/API-LIB/FatFs/ff.c`)
- Poser Shell → Editor Styling: uses (evidence: `src/API-LIB/Bin/poser_shell/shell.c`)
- DASM Assembler → Dawn Bytecode Format: uses format (evidence: `src/API-LIB/Bin/dasm/dasm.c`)
- DawnVM Runtime → Dawn Bytecode Format: uses format (evidence: `src/API-LIB/Bin/dawnvm/dawnvm.c`)
- Dawn Bytecode Tool → Dawn Bytecode Format: uses format (evidence: `src/API-LIB/Bin/dawnvm/dawnbc.c`)
- Dawn Runner → Kernel API: calls (evidence: `src/API-LIB/Bin/rundwn/rundwn.c`)
- Package Runner → Package Handling: uses package code (evidence: `src/API-LIB/Bin/runpack/runpack.c`)
- Package Runner → Kernel API: calls (evidence: `src/API-LIB/Bin/runpack/runpack.c`)
