Build System

Build System

Purpose

This page describes the build-system direction for OSAI.

Contents

• Host
• Toolchain
• QEMU Commands
• Disk Images
• CI Strategy
• Directory Layout

Host

macOS is the first host for bring-up. QEMU on macOS is for correctness and boot architecture, not performance claims.

Toolchain

Early kernel code should be freestanding C99 plus minimal architecture assembly. C++ is allowed in userspace, runtime, and AI components, not early kernel core.

The build should use LLVM/Clang, LLD, QEMU, Git, Python for host tooling where useful, and deterministic image scripts.

QEMU Commands

The repository should eventually provide:

• make all;
• make image;
• make qemu;
• make test;
• scripts/run-qemu-x86_64.sh;
• scripts/run-qemu-aarch64.sh.

Disk Images

Disk image creation must be scripted. Build artifacts should live only under ignored output directories.

CI Strategy

CI should run formatting, host-side unit tests, image creation, and QEMU smoke boots when available.

Directory Layout

The target source layout is described in Implementation Plan. Keep the main repo clean until implementation files are introduced.