# Rescue Ultra v0.1.0 — Reference Implementation

Built 2026-06-07. A complete, buildable Debian live ISO with 300+ technician tools.

## Project Location

`/home/rurouni/rescue-ultra/`

## Key Files

| File | Purpose |
|---|---|
| `docs/01-architecture.md` | Full architecture decision record |
| `docs/02-licensing.md` | License audit and redistribution report |
| `docs/03-security.md` | Supply chain and runtime security plan |
| `docs/04-testing.md` | QEMU boot tests + tool smoke tests |
| `docs/05-roadmap.md` | Phased roadmap (v0.1 → v1.x) |
| `docs/06-first-step.md` | Exact commands for first build |
| `manifests/package-lists/*.list.chroot` | 21 Debian package list files |
| `manifests/tool-manifest.md` | 300+ tools across 20 categories |
| `manifests/boot-image-manifest.md` | Separate ISOs for multi-boot USB |
| `overlay/usr/local/bin/rescue-*` | Dashboard, report, safe commands |
| `overlay/etc/ssh/sshd_config` | SSH config (key-only auth) |
| `build/output/rescue-ultra-0.1.0-20260607-amd64.iso` | Built ISO (1.5 GB) |

## Build Results

- **ISO size**: 1.5 GB  
- **Packages installed**: 1,048  
- **Kernel**: 6.12.90+deb13.1-amd64  
- **Key tools verified**: testdisk, smartctl, chntpw, ddrescue, nmap, nvme-cli, efibootmgr  
- **Overlay files in squashfs**: rescue-dashboard, rescue-report, rescue-safe, sshd_config, rescue-version  
- **Dark theme**: Greybird-dark for GTK3 + XFCE + LightDM  
- **Hermes Agent**: NOT installed (pip package not found; needs manual git clone in hook)  

## Next Build Commands

```bash
cd /home/rurouni/rescue-ultra
# Build from clean
cd build/live-build
sudo lb clean 2>/dev/null
lb config --distribution trixie --archive-areas "main contrib non-free non-free-firmware" \
  --debian-installer none --bootappend-live "boot=live components username=rescue ..." \
  --linux-packages "linux-image" --linux-flavours "amd64" --apt-recommends false \
  --debootstrap-options "--variant=minbase"
cp ../../manifests/package-lists/*.list.chroot config/package-lists/
cp -a ../../overlay/* config/includes.chroot_before_packages/
cp ../../build/hooks/*.chroot config/hooks/
chmod +x config/hooks/*.chroot
sudo lb build
```