Readme
# Symbiot OS 0.0.0
[](https://github.com/DavidWise01/symbiot-os/actions/workflows/build.yml)
**Catalytic Symbiosis — bare-metal x86_64 kernel**
**Author:** David Wise (ROOT0)
**License:** MIT
> CI builds the kernel and a bootable image on every push (nightly Rust, `build-std`,
> custom JSON target) and uploads `bootimage-symbiot-os.bin` as a downloadable artifact.
---
## What this is
A real bootable kernel. Not a web demo. Not a simulation.
It runs in VGA text mode on x86_64 hardware and cycles through the catalytic symbiosis loop:
```
. -> SEED -> PUSH -> TRACE -> PRUNE -> RETURN -> GROUND -> .
```
With keyboard interrupt handling — press a key to jump to any phase:
| Key | Command |
|-----|---------|
| `S` | SEED — origin state |
| `P` | PUSH — outward propagation |
| `T` | TRACE — observable residue |
| `R` | RETURN — restore continuity |
| `G` | GROUND — clamp wobble, reset to 98% coherence |
Every cycle computes an FNV-1a witness hash from the current state, cycle counter, and
phase — proving the cycle happened without an external verifier.
---
## What you'll see
The screen the kernel paints, reconstructed from the VGA draw code in `src/main.rs`
(`render_header` → `render_state` → `draw_field`). The header prints magenta, the state
block light-green, the field light-cyan, on a black 80×25 text console:
```
===============================================================================
CATALYTIC SYMBIOSIS 0.0.0
bare metal kernel | no_std | VGA text mode | x86_64 | keyboard live
===============================================================================
cycle : 42
phase : TRACE
human : 98%
ava : 2%
coherence : 98%
wobble : 3%
witness : 6f3a91c4
last cmd : [T]race
signature : . -> push -> trace -> prune -> return -> .
law : preserve coherence without violating other continuity
field : . )) trace
O_L O_R
\ /
\ (( . )) /
\ | /
\ witness /
\ | /
-------ROOT0--------
```
`cycle`, `witness`, and `phase` advance every tick; pressing `S/P/T/R/G` overrides the
phase live via the keyboard interrupt, and `field` redraws t