Showcase study notes

Chapter notes.

Watch each clip for sequence, then replay it against the current command surface. The videos are evidence; the command tables, validation manual, and source paths below are the current field index.

Chapter 01

Boot identity

01 / clip

Open MP4 / poster /media/showcase/01-boot-identity.jpg

Demonstrates

Multiboot entry, early x86 setup, memory, interrupts, devices, filesystems, embedded programs, and arrival at the shell.

Subsystems involved

Boot pathCPU tablesinterruptsmemory managerconsoleshellELF registry

Likely commands and observations

make run or make run-nographic QEMU starts the Multiboot image; the Makefile also provides make iso for the GRUB ISO image path.
help The shell command table is live after console, scheduler, and program registration are online.
uname, status, neofetch, ps Identify the QEMU/i686 target, memory, uptime, tasks, devices, and user-program surface.
events 5 Recent boot and shell activity enters the causal event ring.

Source files to read

Chapter 02

SlFS persistence

02 / clip

Open MP4 / poster /media/showcase/02-slfs-persistence.jpg

Demonstrates

The persistent filesystem path from PCI and VirtIO block I/O through SlFS metadata and disk-prefixed shell commands.

Subsystems involved

PCI scanVirtIO transportVirtIO blockSlFSfile commandscausal logging

Likely commands and observations

diskmkdir, diskwrite, diskappend, diskcat Disk commands exercise the VirtIO-backed SlFS namespace.
diskstat, diskdf, fsck, diskcache Metadata, capacity, cache, and consistency checks expose the on-disk state.
halt; make run-nographic; diskcat <path> Files remain because disk.img backs the block device.
events fs_op or trace <event-id> Filesystem work leaves causal records for operator inspection.

Source files to read

Chapter 03

Productivity

03 / clip

Open MP4 / poster /media/showcase/03-productivity.jpg

Demonstrates

The operating surface around file navigation, editor use, text browser output, wget/http work, compilation, and user program launch.

Subsystems involved

Shell applicationskeyboardconsoleTCP/IPELF loadersyscalls

Likely commands and observations

browser or wget wget fetches HTTP through the kernel network stack; browser renders SlFS files and built-in about pages.
edit or typewriter Text entry passes through keyboard, console, and application code.
slc <source> The small compiler path produces an executable artifact for the loader.
ls, cat, exec <program>, strace File inspection, program launch, and syscall tracing share the shell surface.

Source files to read

Chapter 04

External ELF and HEW

04 / clip

Open MP4 / poster /media/showcase/04-external-elf-hew.jpg

Demonstrates

ELF inspection, SlFS installation, argv delivery, task lifecycle, and HEW SDK examples that call into SlOS services.

Subsystems involved

ELF loaderuser runtimesyscall ABItask lifecycleHEW SDK examples

Likely commands and observations

programs, elfinstall -l List embedded and installable user programs.
elfinfo hello; exec hello The loader checks an executable and starts it through the syscall ABI.
exec argdemo alpha beta Argument passing reaches the user program.
elfinstall hello /labs/hello.elf; exec /labs/hello.elf A persistent SlFS copy can be inspected and executed by path.

Source files to read

Chapter 05

Timeline notes

05 / clip

Open MP4 / poster /media/showcase/05-timeline-notes.jpg

Demonstrates

Notes as timeline-backed application state, with search, tags, export, cursor movement, replay, and causal parentage.

Subsystems involved

Causal graphtimeline frameworkreplay enginenotes applicationSlFS snapshots

Likely commands and observations

note add <text> A note append creates application state and a timeline event.
note tag last <tag> Metadata is attached to the current note record.
note search <term>; note show last Search and show read reconstructed note state.
tl show notes; tl tail notes -n 5; tl rewind notes <n> Timeline commands inspect or move the replay cursor.

Source files to read

Chapter 06

Actors and mesh

06 / clip

Open MP4 / poster /media/showcase/06-actors-mesh.jpg

Demonstrates

Named local actors, mailbox delivery, routes, mesh identity, Noise crypto, and federated graph or message state.

Subsystems involved

Actor mailboxesrouting tableNoise cryptomesh transportfederationcausal merge

Likely commands and observations

actors Registered actor names, message counters, and mailbox depth are visible.
send shell <message>; recv shell A message enqueue and receive create actor and causal records.
mesh, routes, federation Peer identity, route table, and graph/message federation status are exposed.
observe or meshview Dashboard commands watch distributed state when peer nodes are present.

Source files to read

Chapter 07

DOOM

07 / clip

Open MP4 / poster /media/showcase/07-doom.jpg

Demonstrates

Launching a larger graphical program through the SlOS program path, with display, input, runtime shims, and process return.

Subsystems involved

External program registrationELF loadingsyscallskeyboardVGA/framebufferDOOM platform layer

Likely commands and observations

doom The shell transfers control to the registered DOOM program.
keyboard input Input travels through the keyboard driver into the game adapter.
VGA mode or framebuffer output The display path presents game frames through the platform layer.
return to shell The process boundary keeps the operating surface available after the program exits.

Source files to read

Current additions

Capabilities added after the clips.

These items do not have showcase media yet. Treat them as terminal/source plates until the next capture pass.

New capability

Scrub inspector and counterfactuals

Commands

  • scrub <tick>
  • scrub event last
  • scrub whatif last
  • scrub diff 100 99999
  • scrub json 99999
  • whatif summary <event-id>

The terminal inspector reconstructs state at a tick, explains one event, compares ticks, exports JSON, and asks what would fall away if an event were dropped.

Source and validation paths