Files

T

rajamesandClaude Opus 5.5 79db0e8d88 build: v4 is the default build -- every kernel boots v4; acceptance is v4 on three ISAs and the 32-bit build

Captain Bob, 2026-10-14: "v4 is the default build", "no, qemu to v4
too ... we are effectively trying to retire v3", "the 32 bit build needs
to go into the acceptance test too", "i don't care about v3".

- STARFORTH_V4 defaults on (Kconfig default y) and V4_DEFAULT=1
  everywhere: every kernel carries v4 and v3 and boots v4; system=v3 boots
  v3; STARFORTH_V4=0 builds v3 alone.  Board images write system=v4.
- Acceptance (CLAUDE.md): the three ISAs as built (v4, POST passed,
  V4_SYSTEM dict_hash equal) and make -C v4 test-32.  v3 is not part of
  it.

Acceptance run: amd64, aarch64, riscv64 -- PARITY:V4_POST 538/538,
dict_hash=0xe5a57f3eb72ff94a on all three, no unknown word; test-32: 30
suites, 0 failures.  The SER5 image under OVMF boots v4 as built, v3 after
the one-word edit.  README, BRINGUP, FABRIC-3 XLIII, the register updated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

2026-10-14 17:21:13 -04:00

arch

feat(usb): a USB keyboard -- a full one -- and no hang on a PC without PS/2

2026-10-14 14:04:33 -04:00

boot

feat(boards): both systems on every board image, chosen at boot -- system=v3 or system=v4

2026-10-14 15:11:47 -04:00

capsule

feat(log): LOG-FLUSH -- a VM's log records reach Artemis's log ring; and the ring keeps its order when it grows

2026-10-14 12:10:01 -04:00

crypto

Reorganize source tree: kernel/, v3/, v4/ split and board infrastructure

2026-10-01 15:40:09 -04:00

hal

fix(raspi): the Pi 5's native path turns the MMU and caches on before any C; bounded mailbox; framebuffer address from dma-ranges

2026-10-14 12:58:35 -04:00

hash

Reorganize source tree: kernel/, v3/, v4/ split and board infrastructure

2026-10-01 15:40:09 -04:00

math

Reorganize source tree: kernel/, v3/, v4/ split and board infrastructure

2026-10-01 15:40:09 -04:00

memory

Reorganize source tree: kernel/, v3/, v4/ split and board infrastructure

2026-10-01 15:40:09 -04:00

pci

fix(usb): the xHCI controller is found by class on any bus, sized, taken from the firmware, and 64-byte contexts laid out

2026-10-14 13:30:50 -04:00

rng

Reorganize source tree: kernel/, v3/, v4/ split and board infrastructure

2026-10-01 15:40:09 -04:00

usb

feat(usb): every xHCI controller is driven, not only the first

2026-10-14 14:27:38 -04:00

fix(v4.0.0): step 6e final review -- texts begun in order; a word no one will read lets its writer go; a cut wire wakes a wait for room; a full console wire is a refusal, not a fault

2026-10-13 20:02:33 -04:00

virtio

Reorganize source tree: kernel/, v3/, v4/ split and board infrastructure

2026-10-01 15:40:09 -04:00

feat(log): LOG-FLUSH -- a VM's log records reach Artemis's log ring; and the ring keeps its order when it grows

2026-10-14 12:10:01 -04:00

artemis_sig.c

Reorganize source tree: kernel/, v3/, v4/ split and board infrastructure

2026-10-01 15:40:09 -04:00

doe_log.c

Reorganize source tree: kernel/, v3/, v4/ split and board infrastructure

2026-10-01 15:40:09 -04:00

heartbeat.c

Reorganize source tree: kernel/, v3/, v4/ split and board infrastructure

2026-10-01 15:40:09 -04:00

homeblocks_sig.c

Reorganize source tree: kernel/, v3/, v4/ split and board infrastructure

2026-10-01 15:40:09 -04:00

kernel_main.c

build: v4 is the default build -- every kernel boots v4; acceptance is v4 on three ISAs and the 32-bit build

2026-10-14 17:21:13 -04:00

log_region.c

feat(log): LOG-FLUSH -- a VM's log records reach Artemis's log ring; and the ring keeps its order when it grows

2026-10-14 12:10:01 -04:00

README.md

Reorganize source tree: kernel/, v3/, v4/ split and board infrastructure

2026-10-01 15:40:09 -04:00

repl.c

feat(usb): every xHCI controller is driven, not only the first

2026-10-14 14:27:38 -04:00

README.md

src/starkernel/

LithosAnanke — the bare-metal UEFI kernel that boots StarForth directly on hardware (amd64/aarch64/riscv64). Built only via Makefile.starkernel; the only valid acceptance test is the three-arch QEMU boot (see .claude/CLAUDE.md), never make test.

kernel_main.c — kernel entry point, driving the boot milestones (console init, PMM, VMM, interrupts, timers, kmalloc heap, VM bootstrap).
repl.c — kernel REPL.
doe_log.c — kernel-side DoE (Design of Experiments) metrics logging.

Subdirectories:

arch/{amd64,aarch64,riscv64}/ — per-architecture support (APIC/GIC/ PLIC interrupt controller, timers, boot/ISR assembly).
boot/ — UEFI loader, ELF loading, kernel command-line parsing.
capsule/ — capsule birth/run/load/validate pipeline.
hal/ — hardware-abstraction-layer implementation (console, framebuffer, VT100, memory, host services).
hash/ — XXHash64 content-addressing implementation.
math/ — kernel-build Q48.16 fixed-point arithmetic.
memory/ — physical/virtual memory managers and the kernel heap.
pci/ — PCI bus enumeration.
virtio/ — VirtIO block device driver.
vm/ — kernel VM subsystem (bootstrap, core interpreter, parity logging, capsule arena).

See include/starkernel/README.md for the corresponding headers.