1 files changed, 21 insertions, 13 deletions

diff --git a/CONTEXT.md b/CONTEXT.md
index 39ce0bd..0d43b9f 100644
--- a/CONTEXT.md
+++ b/CONTEXT.md
@@ -168,19 +168,27 @@ Single Rust crate (`x86_64-unknown-uefi` target).  Module breakdown:
   geometry.  Verified in QEMU: edit/type/navigate/insert/save/exit, exact
   bytes via `cat`/`hexdump`, syntax colours via framebuffer dump.
 ✅ **AHCI + FAT32 (persistent disk)** — a SATA AHCI driver (polling DMA,
-  no interrupts) plus a FAT32 filesystem, mounted as `/disk`; every shell
-  command works on disk paths: `ls`/`cat`/`hexdump`/`echo >`/`>>`/
-  `mkdir`/`touch`/`rm`/`edit`.  The driver scans **all** implemented
-  ports (CAP.NP/PI) and starts every port with a device; `fat::init`
-  tries each disk in port order and mounts the first valid FAT32
-  volume — so the kernel finds the disk no matter which AHCI port the
-  firmware/QEMU put it on (real hardware included).  Whole-FAT cache with write-back to both
-  FAT copies, checksum-validated LFN read/write, multi-cluster files,
-  space-padded `.`/`..` dot entries (`..` → cluster 0 under the root),
-  FSInfo free-count maintenance (fsck-clean after a session, verified
-  with `fsck.fat -n`).  **Files survive reboot** — verified by
-  poweroff → `mdir`/`mtype` on the image and by a fresh boot seeing the
-  prior session's files.
+  no interrupts) plus a FAT32 filesystem, mounted under `/disk/<UID>/`;
+  every shell command works on disk paths: `ls`/`cat`/`hexdump`/
+  `echo >`/`>>`/`mkdir`/`touch`/`rm`/`edit`.  The driver scans **all**
+  implemented ports (CAP.NP/PI) and starts every port with a device;
+  `fat::init` mounts **every** valid FAT32 volume it finds, each under
+  `/disk/<UID>/` where UID = `<LABEL>-<8-hex-serial>` (e.g.
+  `RSDOS-5BD1E55F`) — sanitized uppercase label + volume serial, unique
+  per format, stable across reboots, human-recognizable and
+  machine-parseable (`^[A-Z0-9_]+-[0-9A-F]{8}$`); cloned volumes get a
+  `-N` suffix.  So the kernel finds the disks no matter which AHCI port
+  the firmware/QEMU put them on (real hardware included), and every
+  disk is visible at once (verified: `RSDOS-…` + `DATA2-…` mounted
+  side by side, writes to both, fsck-clean).  Whole-FAT cache per
+  volume with write-back to both FAT copies, checksum-validated LFN
+  read/write (multi-entry names >13 chars stored last-first on disk —
+  both the writer and reader were reversed and cancelled out; fixed),
+  multi-cluster files, space-padded `.`/`..` dot entries (`..` →
+  cluster 0 under the root), FSInfo free-count maintenance
+  (fsck-clean after a session, verified with `fsck.fat -n`).
+  **Files survive reboot** — verified by poweroff → `mdir`/`mtype` on
+  the image and by a fresh boot seeing the prior session's files.
 
   QEMU setup: `-drive id=disk,if=none,format=raw,file=disk.img` +
   `-device ide-hd,drive=disk,bus=ide.0` puts the data disk on AHCI port