Hardware Readiness Gate

Hardware Readiness Gate

Purpose

This page defines the gate between the QEMU on macOS correctness track and the first Intel Desktop hardware bring-up.

OSAI must not treat QEMU results as hardware performance evidence. QEMU validates boot contracts, resource ownership, userspace control flow, telemetry shape, security policy behavior, persistence metadata, and preview packaging.

QEMU Gate

The milestone 33 local QEMU hardware-readiness gate is:

• make qemu-readiness-gate

That command runs the full local QEMU matrix and then validates the generated artifacts. It writes:

• build/qemu-benchmark-report.json
• build/qemu-preview-manifest.json
• build/qemu-readiness-report.json

The benchmark schema is osai.qemu.correctness_benchmark.v1. The preview schema is osai.qemu.preview.v1. The readiness schema is osai.qemu.hardware_readiness_gate.v1.

These reports are correctness artifacts only and explicitly do not authorize Linux, BSD, or hardware performance claims.

Frozen QEMU Contracts

The following contracts must remain green before Intel Desktop work starts:

• AArch64 UEFI loader boots the kernel.
• UEFI memory map is parsed into PMM/VMM state.
• Controlled page, read-only write, and NX execute faults are reported through the exception path.
• Real EL0 /init ELF loads from the VirtIO-backed read-only filesystem.
• Syscalls enforce capability checks and user pointer validation.
• Security policy rejects credential material and unsigned update payloads.
• Persistence metadata snapshots and rolls back boot, service, workspace, and sandbox records.
• VirtIO block and VirtIO net self-tests pass.
• AI Cell lifecycle, core leases, shared model arena, private KV/cache, source index, Git workspace, sandbox, CPU-AI runtime, and low-latency network smoke paths emit telemetry.
• Hot AI core telemetry reports zero migration and zero involuntary context switches under the QEMU gate.

Intel Desktop Entry Criteria

Intel Desktop bring-up can start when:

• make qemu-readiness-gate passes locally.
• The QEMU preview manifest exists.
• The QEMU benchmark report exists.
• The QEMU readiness report exists and has status pass.
• No QEMU benchmark result is described as a hardware speedup.
• The platform and benchmark documentation reflect the current gate.

First Intel Desktop Deliverables

• UEFI x86_64 boot path.
• Serial console and early exception reporting.
• PMM/VMM initialization from x86_64 firmware memory maps.
• APIC and timer discovery.
• PCI discovery for NVMe and NIC planning.
• P-core/E-core placement policy metadata.
• Initial tuned Linux/BSD baseline plan for later measured comparisons.

Related Pages

• QEMU on macOS
• Intel Desktop Port
• Testing and Benchmarking
• Performance Targets