starkernel: item 3.1 -- the Stadium cell and header

Punch list §25 item 3.1 complete.

Defines StadiumPatronHeader and StadiumContinuationCell in new
include/starkernel/vm/stadium.h, unioned as StadiumCell per §3's
closed two-valued union. src/starkernel/vm/stadium.c added to
Makefile.starkernel's LOADER_EXTRA_SRCS/KERNEL_EXTRA_SRCS so the
header's compile-time size checks are actually compiled, not merely
included by something that never builds.

Discriminator ruled an external side bitmap (Captain Bob), not a
header field -- amended into §3 and §23.3 before this code was
written. Item 3.1 declares the bitmap's purpose/indexing in a comment
only; allocating it is item 3.2's scope.

Both cell shapes counted for real at exactly 64 bytes with zero
compiler-inserted padding (three C99-portable negative-array-size
assertions -- no _Static_assert, this project targets C99). Header
matches §23.3's original 32+32 split unchanged, since the
discriminator moving outside the cell left nothing to compete for that
space. Continuation cell matches item 1.12's 4+60 figure unchanged for
the same reason.

Verified the size assertion is actually live: broke it to 63,
confirmed the build failed with the expected negative-array-size
error, restored it, confirmed a clean compile.

Verified: three-architecture boot (amd64, aarch64, riscv64), all
reaching ok> with identical dict_hash=0x3d4e1daf289da94f matching the
item-2.2 baseline. Confirmed stadium.o present in both obj/loader/vm
and obj/kernel/vm post-build on amd64, closing the gap the item-2.2 WIP
exposed (an uncompiled header proves nothing).

Left open, not fabricated: §23.4 #2 ("does a typical message fit in
one cell") is unanswerable today -- no message patron struct exists
anywhere in this tree yet.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

This commit is contained in:

Robert Allan James

2026-08-04 14:55:30 -04:00

co-authored by

Claude Sonnet 5

parent 05c9eba360

commit d55ec3241b

11 changed files with 31498 additions and 10 deletions

									
										Makefile.starkernel
									
		+2
		-1
	
												View File
												
				@@ -449,7 +449,8 @@ LOADER_EXTRA_SRCS := \

				    $(KERNEL_SRC)/vm/vm_bootstrap.c \

				    $(KERNEL_SRC)/vm/vm_runtime.c \

				    $(KERNEL_SRC)/vm/alloc_kernel.c \

				    $(KERNEL_SRC)/vm/q48_stubs.c

				    $(KERNEL_SRC)/vm/q48_stubs.c \

				    $(KERNEL_SRC)/vm/stadium.c

				KERNEL_EXTRA_SRCS := $(LOADER_EXTRA_SRCS)