hindermath · hindermath · Jul 12, 2026 · Jul 12, 2026 · Jul 12, 2026 · Jul 12, 2026
diff --git a/.github/agents/copilot-instructions.md b/.github/agents/copilot-instructions.md
@@ -101,6 +101,16 @@ GitHub Pages is published from `.github/workflows/pages.yml`: build root `docfx.
 - Mouse interaction, terminal/charset/font work, Wave 4, broad redesign, services, new dependencies, and runtime/product AI remain outside 019.
 - The next prioritized intake is `Lastenheft_04_MouseSupportAndInteraction.md`.
 
+### 020-mouse-support-interaction
+- Current implementation status: bounded mouse support and interaction hardening is implemented locally; final evidence is in `specs/020-mouse-support-interaction/pr-evidence.md`.
+- `ConsoleMouseIngress` accepts only complete bounded SGR 1006 left press, pressed move, and release reports and publishes zero or one existing `TEvent`; malformed syntax, range, button, capability, and phase input is rejected atomically.
+- `TGroup` routes mouse down to one topmost visible target, transfers focus only to selectable targets, and preserves existing exactly-once control commands. Nested mouse coordinates traverse the full owner chain.
+- The only mouse drag contract is moving a `TWindow` from its title row. Owner bounds, release, Escape, capability loss, disable, removal, shutdown, and the existing `Ctrl+F5` keyboard fallback are proven.
+- Interactive macOS/Linux terminals and WSL use the SGR capability contract; native Windows Console and redirected/headless I/O remain honest `Unsupported` boundaries. Wheel, hover, touch, extra buttons, full protocol parity, and additional drag targets remain out of scope.
+- Primary proof runs through `TProgram.GetEvent` and `app.Run()` and combines concrete focus/command/drag state, target identity, visible text, and rendered buffer/cell assertions. Historical sources remain read-only.
+- The next prioritized intake is `Lastenheft_05_TerminalCharsetAndEmulation.md`.
+
+
 ### Autonomous Red-Proof Completeness
 - Before the first red test batch, review imports, public XML docs, harness helpers, focus/ownership assertions, and linked-source assembly identity.
 - Group independent negative cases only as a bounded project-local red matrix with explicit failure boundaries and shared ownership.

diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
@@ -227,6 +227,16 @@ On numbered Spec-Kit branches, align those three version fields before pushing.
 - Mouse interaction, terminal/charset/font work, Wave 4, broad redesign, services, new dependencies, and runtime/product AI remain outside 019.
 - The next prioritized intake is `Lastenheft_04_MouseSupportAndInteraction.md`.
 
+### 020-mouse-support-interaction
+- Current implementation status: bounded mouse support and interaction hardening is implemented locally; final evidence is in `specs/020-mouse-support-interaction/pr-evidence.md`.
+- `ConsoleMouseIngress` accepts only complete bounded SGR 1006 left press, pressed move, and release reports and publishes zero or one existing `TEvent`; malformed syntax, range, button, capability, and phase input is rejected atomically.
+- `TGroup` routes mouse down to one topmost visible target, transfers focus only to selectable targets, and preserves existing exactly-once control commands. Nested mouse coordinates traverse the full owner chain.
+- The only mouse drag contract is moving a `TWindow` from its title row. Owner bounds, release, Escape, capability loss, disable, removal, shutdown, and the existing `Ctrl+F5` keyboard fallback are proven.
+- Interactive macOS/Linux terminals and WSL use the SGR capability contract; native Windows Console and redirected/headless I/O remain honest `Unsupported` boundaries. Wheel, hover, touch, extra buttons, full protocol parity, and additional drag targets remain out of scope.
+- Primary proof runs through `TProgram.GetEvent` and `app.Run()` and combines concrete focus/command/drag state, target identity, visible text, and rendered buffer/cell assertions. Historical sources remain read-only.
+- The next prioritized intake is `Lastenheft_05_TerminalCharsetAndEmulation.md`.
+
+
 ### Autonomous Red-Proof Completeness
 - Before the first red test batch, review imports, public XML docs, harness helpers, focus/ownership assertions, and linked-source assembly identity.
 - Group independent negative cases only as a bounded project-local red matrix with explicit failure boundaries and shared ownership.

diff --git a/.specify/feature.json b/.specify/feature.json
@@ -1,3 +1,3 @@
 {
-  "feature_directory": "specs/019-wave3-visual-component-porting"
+  "feature_directory": "specs/020-mouse-support-interaction"
 }
diff --git a/AGENTS.md b/AGENTS.md
@@ -273,6 +273,16 @@ npm run test:docfx
 - Mouse interaction, terminal/charset/font work, Wave 4, broad redesign, services, new dependencies, and runtime/product AI remain outside 019.
 - The next prioritized intake is `Lastenheft_04_MouseSupportAndInteraction.md`.
 
+### 020-mouse-support-interaction
+- Current implementation status: bounded mouse support and interaction hardening is implemented locally; final evidence is in `specs/020-mouse-support-interaction/pr-evidence.md`.
+- `ConsoleMouseIngress` accepts only complete bounded SGR 1006 left press, pressed move, and release reports and publishes zero or one existing `TEvent`; malformed syntax, range, button, capability, and phase input is rejected atomically.
+- `TGroup` routes mouse down to one topmost visible target, transfers focus only to selectable targets, and preserves existing exactly-once control commands. Nested mouse coordinates traverse the full owner chain.
+- The only mouse drag contract is moving a `TWindow` from its title row. Owner bounds, release, Escape, capability loss, disable, removal, shutdown, and the existing `Ctrl+F5` keyboard fallback are proven.
+- Interactive macOS/Linux terminals and WSL use the SGR capability contract; native Windows Console and redirected/headless I/O remain honest `Unsupported` boundaries. Wheel, hover, touch, extra buttons, full protocol parity, and additional drag targets remain out of scope.
+- Primary proof runs through `TProgram.GetEvent` and `app.Run()` and combines concrete focus/command/drag state, target identity, visible text, and rendered buffer/cell assertions. Historical sources remain read-only.
+- The next prioritized intake is `Lastenheft_05_TerminalCharsetAndEmulation.md`.
+
+
 ### Autonomous Red-Proof Completeness
 - Before the first red test batch, review imports, public XML docs, harness helpers, focus/ownership assertions, and linked-source assembly identity.
 - Group independent negative cases only as a bounded project-local red matrix with explicit failure boundaries and shared ownership.

diff --git a/CLAUDE.md b/CLAUDE.md
@@ -219,6 +219,16 @@ When a dedicated feature branch has implemented the requirements of a Lastenheft
 - Mouse interaction, terminal/charset/font work, Wave 4, broad redesign, services, new dependencies, and runtime/product AI remain outside 019.
 - The next prioritized intake is `Lastenheft_04_MouseSupportAndInteraction.md`.
 
+### 020-mouse-support-interaction
+- Current implementation status: bounded mouse support and interaction hardening is implemented locally; final evidence is in `specs/020-mouse-support-interaction/pr-evidence.md`.
+- `ConsoleMouseIngress` accepts only complete bounded SGR 1006 left press, pressed move, and release reports and publishes zero or one existing `TEvent`; malformed syntax, range, button, capability, and phase input is rejected atomically.
+- `TGroup` routes mouse down to one topmost visible target, transfers focus only to selectable targets, and preserves existing exactly-once control commands. Nested mouse coordinates traverse the full owner chain.
+- The only mouse drag contract is moving a `TWindow` from its title row. Owner bounds, release, Escape, capability loss, disable, removal, shutdown, and the existing `Ctrl+F5` keyboard fallback are proven.
+- Interactive macOS/Linux terminals and WSL use the SGR capability contract; native Windows Console and redirected/headless I/O remain honest `Unsupported` boundaries. Wheel, hover, touch, extra buttons, full protocol parity, and additional drag targets remain out of scope.
+- Primary proof runs through `TProgram.GetEvent` and `app.Run()` and combines concrete focus/command/drag state, target identity, visible text, and rendered buffer/cell assertions. Historical sources remain read-only.
+- The next prioritized intake is `Lastenheft_05_TerminalCharsetAndEmulation.md`.
+
+
 ### Autonomous Red-Proof Completeness
 - Before the first red test batch, review imports, public XML docs, harness helpers, focus/ownership assertions, and linked-source assembly identity.
 - Group independent negative cases only as a bounded project-local red matrix with explicit failure boundaries and shared ownership.

diff --git a/Directory.Build.props b/Directory.Build.props
@@ -5,9 +5,9 @@
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
-    <Version>1.19.5.124</Version>
-    <AssemblyVersion>1.19.5.124</AssemblyVersion>
-    <FileVersion>1.19.5.124</FileVersion>
+    <Version>1.20.6.143</Version>
+    <AssemblyVersion>1.20.6.143</AssemblyVersion>
+    <FileVersion>1.20.6.143</FileVersion>
     <!-- Fehlende XML-Docs sind in Release ein Build-Fehler (Constitution §III). -->
     <!-- Missing XML documentation is a build error in Release (Constitution §III). -->
     <WarningsAsErrors Condition="'$(Configuration)' == 'Release'">CS1591</WarningsAsErrors>

diff --git a/GEMINI.md b/GEMINI.md
@@ -246,6 +246,16 @@ Das Projekt folgt einer modularen Struktur gemäß .NET Best Practices:
 - Mouse interaction, terminal/charset/font work, Wave 4, broad redesign, services, new dependencies, and runtime/product AI remain outside 019.
 - The next prioritized intake is `Lastenheft_04_MouseSupportAndInteraction.md`.
 
+### 020-mouse-support-interaction
+- Current implementation status: bounded mouse support and interaction hardening is implemented locally; final evidence is in `specs/020-mouse-support-interaction/pr-evidence.md`.
+- `ConsoleMouseIngress` accepts only complete bounded SGR 1006 left press, pressed move, and release reports and publishes zero or one existing `TEvent`; malformed syntax, range, button, capability, and phase input is rejected atomically.
+- `TGroup` routes mouse down to one topmost visible target, transfers focus only to selectable targets, and preserves existing exactly-once control commands. Nested mouse coordinates traverse the full owner chain.
+- The only mouse drag contract is moving a `TWindow` from its title row. Owner bounds, release, Escape, capability loss, disable, removal, shutdown, and the existing `Ctrl+F5` keyboard fallback are proven.
+- Interactive macOS/Linux terminals and WSL use the SGR capability contract; native Windows Console and redirected/headless I/O remain honest `Unsupported` boundaries. Wheel, hover, touch, extra buttons, full protocol parity, and additional drag targets remain out of scope.
+- Primary proof runs through `TProgram.GetEvent` and `app.Run()` and combines concrete focus/command/drag state, target identity, visible text, and rendered buffer/cell assertions. Historical sources remain read-only.
+- The next prioritized intake is `Lastenheft_05_TerminalCharsetAndEmulation.md`.
+
+
 ### Autonomous Red-Proof Completeness
 - Before the first red test batch, review imports, public XML docs, harness helpers, focus/ownership assertions, and linked-source assembly identity.
 - Group independent negative cases only as a bounded project-local red matrix with explicit failure boundaries and shared ownership.

diff --git a/Lastenheft_04_MouseSupportAndInteraction.md → ...eraction.020-mouse-support-interaction.md b/Lastenheft_04_MouseSupportAndInteraction.md → ...eraction.020-mouse-support-interaction.md
diff --git a/Pflichtenheft.md b/Pflichtenheft.md
@@ -256,8 +256,10 @@ Statuscheckliste Beispielwellen:
   Reihenfolgehinweis: abgeschlossen (Branch `013-wave2-visual-component-remediation`); die elf Wave-2-Beispiele besitzen echte sichtbare Hauptkomponenten, echte `TStatusLine`-Rueckmeldung, `Help -> Description` und primaere App-Loop-Smokes mit View-Baum- plus Buffer-/Cell-Nachweis.
 - [x] **Welle 3 - Editor-/Hilfe-/Ressourcen-Vorhaertung**
   Reihenfolgehinweis: abgeschlossen (Branch `018-editor-help-resources-hardening`); Editor-/Datei- und Runtime-Help-Flows sind zusammenhaengend nachgewiesen, der Help-Source-Compiler und sprachabhaengige Resource-Lookup sind wiederverwendbar gehaertet.
-- [ ] **Welle 3 - Visual Component Porting**
-  Reihenfolgehinweis: nach der Wave-3-Vorhaertung ueber `Lastenheft_Wave3-Visual-Component-Porting.md`; `tvedit`, `bhelp`, `helpdemo`, `tvhc` und `i18n` muessen direkt als sichtbare Drei-Schichten-Demos portiert werden.
+- [x] **Welle 3 - Visual Component Porting**
+  Reihenfolgehinweis: abgeschlossen (Branch `019-wave3-visual-component-porting`); `tvedit`, `bhelp`, `helpdemo`, `tvhc` und `i18n` sind sichtbare Drei-Schichten-Demos mit App-Loop- und Buffer-/Cell-Proof.
+- [x] **Maussupport und Interaktions-Härtung**
+  Reihenfolgehinweis: abgeschlossen (Branch `020-mouse-support-interaction`); begrenzter SGR-1006-Ingress, Fokus/Aktivierung, Doppelklick, ein Titelzeilen-Drag und vollständige Tastaturfallbacks sind frameworkweit nachgewiesen.
 - [ ] **Welle 4 - Terminal-/Charset-/Plattform-Vorhaertung**
   Reihenfolgehinweis: nach Welle 3 ueber `Lastenheft_05_TerminalCharsetAndEmulation.md`; haertet Terminal-Session, Buffer-/Cell-Proof, Charset-/Font-Mapping, Resource-/Config-Fallbacks und Plattformgrenzen vor dem sichtbaren Wave-4-Port.
 - [ ] **Welle 4 - Visual Component Porting**
@@ -655,9 +657,10 @@ Dieser Marker ist bei jeder wesentlichen Fortschreibung des Pflichtenhefts auf d
    - `3.2b` = Welle 2: Sichtbarer Komponenten-Nachweis — ✓ ABGESCHLOSSEN (Branch `013-wave2-visual-component-remediation`)
    - `3.3a` = Welle 3: Editor-/Hilfe-/Ressourcen-Vorhaertung — ✓ ABGESCHLOSSEN (Branch `018-editor-help-resources-hardening`)
    - `3.3` = Welle 3: Editor, Dateien, Hilfe und Streams — ✓ ABGESCHLOSSEN (Branch `019-wave3-visual-component-porting`)
+   - `3.3b` = Maussupport und Interaktions-Härtung — ✓ ABGESCHLOSSEN (Branch `020-mouse-support-interaction`)
    - `3.4` = Welle 4: Terminal-Emulation und erweiterte Zeichensaetze
 
->>> NAECHSTER SCHRITT <<< Mouse Support and Interaction starten: `Lastenheft_04_MouseSupportAndInteraction.md` umsetzen. Danach folgt `Lastenheft_05_TerminalCharsetAndEmulation.md`.
+>>> NAECHSTER SCHRITT <<< Terminal-/Charset-Härtung starten: `Lastenheft_05_TerminalCharsetAndEmulation.md` umsetzen. Danach folgt `Lastenheft_Wave4-Visual-Component-Porting.md`.
 
 4. **MUSS-Testumfang und Beispiel-Smoke-Tests schliessen**
    - Fuer alle 25 portierten Originalbeispiele automatisierte Smoke-Tests in CI bereitstellen.

diff --git a/README.md b/README.md
@@ -16,6 +16,8 @@ Agentic-AI workflows. It is not an official Turbo Vision continuation.
 
 - Multi-Mac workflow (MacBook Air M2 + Mac mini M4 Pro) with `gh` and `codex`:
   [`docs/guides/multi-mac-workflow.md`](docs/guides/multi-mac-workflow.md)
+- Bounded SGR-1006 mouse support, host boundaries, keyboard fallback, and proof:
+  [`docs/guides/mouse-support.md`](docs/guides/mouse-support.md)
 
 ## Documentation Accessibility Checks
 

diff --git a/docs/architecture/runtime-view.md b/docs/architecture/runtime-view.md
@@ -103,3 +103,37 @@ smokes inject commands into `app.Run()` and verify concrete state values,
 view-tree types, and back-buffer regions. The new helper file under
 `examples/Shared/` remains example-internal and creates no new runtime
 dependency.
+
+## 020 Mouse Ingress Addendum
+
+```text
+Interactive SGR terminal or controlled observation
+  |
+  | complete bounded SGR 1006 report
+  v
+ConsoleMouseIngress in TuiVision.Drivers.Console
+  |
+  | syntax, range, capability, phase and monotonic click validation
+  | zero or one existing TEvent
+  v
+TProgram.GetEvent
+  |
+  | point-to-target-key delegate, no Driver-to-Controls reference
+  v
+TGroup topmost hit and focus -> existing control command or TWindow title drag
+  |
+  | visible status, view identity and buffer/cell proof
+  v
+Keyboard-complete application; shutdown disables SGR and clears transient state
+```
+
+Deutsch: Der Driver besitzt Protokoll und Hostzustand, Core bleibt der
+kanonische Eventvertrag, und Controls besitzen Fokus sowie den einzigen
+Titelzeilen-Drag. Ungültige Rohdaten erreichen den View-Baum nicht. Native
+Windows Console, Wheel, Hover, Touch und weitere Drag-Ziele bleiben außerhalb
+von 020.
+
+English: Driver owns protocol and host state, Core remains the canonical event
+contract, and Controls own focus plus the sole title-row drag. Invalid raw data
+never reaches the view tree. Native Windows Console, wheel, hover, touch, and
+additional drag targets remain outside 020.