Filesystem and Storage

Filesystem and Storage

Purpose

This page describes the minimal storage plan for OSAI.

Contents

• Storage Layout
• QEMU First
• System Image
• App Data and Worktrees
• Rollback

Storage Layout

The initial storage plan includes:

• boot partition;
• system image;
• app data;
• repository worktrees;
• build artifacts;
• logs and telemetry;
• rollback snapshots.

QEMU First

QEMU uses VirtIO block first. GPT parsing and a simple read-only filesystem are enough for early boot.

System Image

The system image should be reproducible and generated from scripts. Build artifacts belong in build/, out/, or another ignored output directory.

App Data and Worktrees

Each app agent should use explicit worktrees and build output directories. Build artifacts should not contaminate source trees.

Rollback

Snapshot and rollback are required before code-changing agents can safely modify running services.

Hardware Direction

NVMe is the first real storage target after VirtIO. Queue ownership and NUMA locality matter for Intel Xeon.