test

# Test - Overlay Testing Management

## Overview

The overlay testing system enables live editing of justfiles by creating symlinks from the repository to `/usr/share/bazzite-ai/just/`. This allows testing changes without rebuilding the OS image.

**Key Concept:** On immutable OSTree systems (Bazzite-AI, Silverblue), `/usr` is read-only. Overlay mode temporarily unlocks it. On traditional systems (Fedora, CentOS), symlinks provide the same live-editing capability.

**Command Contexts:**
- `just overlay` - Development mode (from repository root)
- `ujust test` - Runtime verification (on installed bazzite-ai system)

**Important:** Overlay commands (`just overlay`) are development-only and run from the repository root. Runtime verification commands (`ujust test quick`, `ujust test gpu`, etc.) run on installed systems.

## Quick Reference

### Development Mode (from repo root)

| Action | Command | Description |
|--------|---------|-------------|
| Refresh overlay | `just overlay refresh` | Auto-enables if needed, then refreshes |
| Check status | `just overlay check` | Show current overlay/symlink status |
| Enable overlay | `just overlay enable` | Manually bootstrap overlay session |
| System info | `just overlay info` | Show detailed system info |
| Help | `just overlay help` | Show usage help |

**Note:** `just overlay refresh` automatically enables the overlay if not active - this is the recommended primary command.

### Runtime Verification (on installed system)

| Action | Command | Description |
|--------|---------|-------------|
| Quick test | `ujust test quick` | Fast GPU + services check (~30s) |
| Full test | `ujust test all` | Complete test suite (~2min) |
| GPU test | `ujust test gpu` | GPU detection and CDI check |
| Help | `ujust test help` | Show all runtime test options |

## Parameters

### Development Mode (just overlay)

```bash
just overlay ACTION
```

| Parameter | Values | Description |
|-----------|--------|-------------|
| `ACTION` | `refresh`