From d4aba6ef06dbab16cc679fae7005457e20977143 Mon Sep 17 00:00:00 2001
From: Hermes Agent <hermes@gharbeia.net>
Date: Tue, 12 May 2026 22:22:06 +0000
Subject: [PATCH] docs: add v1.1.0 SGR mouse parsing to ROADMAP.org

---
 docs/ROADMAP.org | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/docs/ROADMAP.org b/docs/ROADMAP.org
index ff48b91..365bb2b 100644
--- a/docs/ROADMAP.org
+++ b/docs/ROADMAP.org
@@ -201,6 +201,28 @@ Checklist:
 - [X] Suspend/resume-backend protocol methods (ARCHITECTURE.org spec)
 - [X] Slot modes (defslot :mode parameter)
 
+** v1.1.0: SGR Mouse Event Parsing
+
+DONE. ~read-event~ now decodes SGR extended mouse sequences
+(~ESC[<Cb;Cx;CyM/m~) into structured ~mouse-event~ structs, where previously
+they fell through as ~:unknown~ key events and printed as control characters.
+
+What was added:
+- ~%read-digits~ — reads multi-digit numeric parameters from raw terminal
+  bytes, handling arbitrary-length values (e.g. coordinates > 99)
+- ~%parse-sgr-mouse~ — full SGR mouse decoder: button code → keyword
+  (~:left~, ~:middle~, ~:right~, ~:scroll-up~, ~:scroll-down~, ~:drag~),
+  press/release detection, 1-based → 0-based coordinate conversion
+- ~parse-csi-sequence~ detects the ~~<~~ marker byte (0x3C) and delegates
+  to ~%parse-sgr-mouse~ instead of treating the sequence as keyboard input
+
+The mouse enable/disable sequences were already sent by
+~initialize-backend~/~shutdown-backend~ (lines 126-128, 139-141 of
+~modern.lisp~). The parsing gap was the only missing piece.
+
+Test coverage: 461 unit tests + 32 integration tests, all at 100%.
+Org source: ~org/text-input.org~ (tangled to ~src/components/input.lisp~).
+
 ** Feature Reference
 
 | Phase | Component                              | Lines  | Release | Status |