1 files changed, 16 insertions, 8 deletions

diff --git a/CONTEXT.md b/CONTEXT.md
index 32a6eca..8fa4025 100644
--- a/CONTEXT.md
+++ b/CONTEXT.md
@@ -163,14 +163,22 @@ Single Rust crate (`x86_64-unknown-uefi` target).  Module breakdown:
 ## Known issues / perf notes
 
 - **Scroll cost** — scrolling still shifts the whole framebuffer (a
-  ~3-8 MB pixel copy per row), but a RAM backbuffer (`gop::SHADOW`)
-  makes it fast on real hardware: every raster write goes to the shadow
-  too, and scrolling is a cached shadow memcpy + one write-only push to
-  the display.  The display is never *read* — that was the killer, since
-  real-hardware GOP framebuffers are uncacheable/write-combining and
-  uncached reads cost a bus round-trip per cache line.  Still on the
-  someday list: a pan-based ring so scrolling never touches the whole
-  framebuffer at all.
+  ~3-8 MB pixel copy per row), but two mechanisms make it fast on real
+  hardware:
+  1. a RAM backbuffer (`gop::SHADOW`): every raster write goes to the
+     shadow too; scrolling is a cached shadow memcpy + one write-only
+     push to the display — the display is never *read* (uncached reads
+     were the killer, since real-hardware GOP framebuffers are
+     uncacheable/write-combining).
+  2. deferred scroll batching (`vt::PENDING_SCROLLS`): the logical grid
+     scrolls instantly in RAM while the framebuffer shift+push is
+     deferred; N pending scrolls cost one push.  Bursts of streaming
+     output (hexdump/cat) push every ~16 rows (or after ~40 ms of
+     pause), and the shell syncs before each prompt.  Any CSI sequence
+     (full-screen apps like the editor) or interactive input pushes
+     immediately.
+  Still on the someday list: a pan-based ring so scrolling never touches
+  the whole framebuffer at all.
 - **Editor redraw** re-blits changed cells per keystroke (fine at 1280×800);
   the "optimize drawing someday" item.
 - **ramfs only**: edited files live in memory, lost on reboot until disk